tripathysagar/man_text huggingface dataset:
# wcsncat

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           wcsncat — concatenate a wide-character string with part of another
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcsncat(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_ ,
               size_t _n_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _wcsncat_() function shall append not more than _n_ wide-character
           codes (a null wide-character code and wide-character codes that
           follow it are not appended) from the array pointed to by _ws2_ to
           the end of the wide-character string pointed to by _ws1_.  The
           initial wide-character code of _ws2_ shall overwrite the null wide-
           character code at the end of _ws1_.  A terminating null wide-
           character code shall always be appended to the result. If copying
           takes place between objects that overlap, the behavior is
           undefined.
    


## RETURN VALUE



           The _wcsncat_() function shall return _ws1_ ; no return value is
           reserved to indicate an error.
    


## ERRORS



           No errors are defined.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# rdma_reject

## NAME



           rdma_reject - Called to reject a connection request.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_reject (struct rdma_cm_id ***_id_**, const void ***_private_data_**,**
           **uint8_t** _private_data_len_**);**
    


## ARGUMENTS



           id          Connection identifier associated with the request.
    
           private_data
                       Optional private data to send with the reject message.
    
           private_data_len
                       Specifies the size of the user-controlled data buffer.
                       Note that the actual amount of data transferred to the
                       remote side is transport dependent and may be larger
                       than that requested.
    


## DESCRIPTION



           Called from the listening side to reject a connection or datagram
           service lookup request.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           After receiving a connection request event, a user may call
           rdma_reject to reject the request.  If the underlying RDMA
           transport supports private data in the reject message, the
           specified data will be passed to the remote side.
    


* * *
# audit_name_to_fstype

## NAME



           audit_name_to_fstype - Convert the fstype name to the numeric
           fstype value
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_name_to_fstype(const char** _*name_**);**
    


## DESCRIPTION



           **audit_name_to_fstype**() converts the fstype name ("debugfs" or
           "tracefs") to the numeric fstype value (0x64626720 or 0x74726163).
           _name_ is the fstype name.
    


## RETURN VALUE



           Returns -1 if an name occurs; otherwise, the return value is the
           numeric fstype value.
    


* * *
# gnutls_transport_set_pull_function

## NAME



           gnutls_transport_set_pull_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_pull_function(gnutls_session_t** _session_**,**
           **gnutls_pull_func** _pull_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_pull_func pull_func
                       a callback function similar to **read()**
    


## DESCRIPTION



           This is the function where you set a function for gnutls to
           receive data.  Normally, if you use berkeley style sockets, do not
           need to use this function since the default recv(2) will probably
           be ok.  The callback should return 0 on connection termination, a
           positive number indicating the number of bytes received, and -1 on
           error.
    
            _gnutls_pull_func_ is of the form, ssize_t
           (*gnutls_pull_func)(gnutls_transport_ptr_t, void*, size_t);
    


* * *
# probe::sunrpc.svc.drop

## NAME



           probe::sunrpc.svc.drop - Drop RPC request
    


## SYNOPSIS



           sunrpc.svc.drop
    


## VALUES



           _rq_vers_
               the program version in the request
    
           _rq_prog_
               the program number in the request
    
           _peer_ip_
               the peer address where the request is from
    
           _rq_xid_
               the transmission id in the request
    
           _rq_prot_
               the IP protocol of the reqeust
    
           _rq_proc_
               the procedure number in the request
    
           _sv_name_
               the service name
    


* * *
# gnutls_hash_squeeze

## NAME



           gnutls_hash_squeeze - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hash_squeeze(gnutls_hash_hd_t** _handle_**, void ***_output_**,**
           **size_t** _length_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t handle
                       a **gnutls_hash_hd_t**
    
           void * output
                       destination to store the output; must be equal to or
                       larger than  _length_
    
           size_t length
                       length of  _output_
    


## DESCRIPTION



           This function will extract digest output of  _length_ bytes. The
           _handle_ must be initialized with **gnutls_hash_init()** as an extended
           output function (XOF), such as **GNUTLS_DIG_SHAKE_128** or
           **GNUTLS_DIG_SHAKE_256**.
    
           This function can be called multiple times. To reset the state of
           _handle_ , call **gnutls_hash_deinit()** with **NULL** as the digest
           argument.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success; negative error code otherwise.
    


## SINCE



           3.8.6
    


* * *
# probe::nfsd.proc.commit

## NAME



           probe::nfsd.proc.commit - NFS server performing a commit operation
           for client
    


## SYNOPSIS



           nfsd.proc.commit
    


## VALUES



           _size_
               read bytes
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _offset_
               the offset of file
    
           _client_ip_
               the ip address of client
    
           _version_
               nfs version
    
           _proto_
               transfer protocol
    
           _uid_
               requester's user id
    
           _gid_
               requester's group id
    
           _count_
               read bytes
    


* * *
# towupper

## NAME



           towupper, towupper_l - convert a wide character to uppercase
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **wint_t towupper(wint_t** _wc_**);**
           **wint_t towupper_l(wint_t** _wc_**, locale_t** _locale_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **towupper_l**():
               Since glibc 2.10:
                   _XOPEN_SOURCE >= 700
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **towupper**() function is the wide-character equivalent of the
           toupper(3) function.  If _wc_ is a lowercase wide character, and
           there exists an uppercase equivalent in the current locale, it
           returns the uppercase equivalent of _wc_.  In all other cases, _wc_ is
           returned unchanged.
    
           The **towupper_l**() function performs the same task, but performs the
           conversion based on the character type information in the locale
           specified by _locale_.  The behavior of **towupper_l**() is undefined if
           _locale_ is the special locale object **LC_GLOBAL_LOCALE**(see
           duplocale(3)) or is not a valid locale object handle.
    
           The argument _wc_ must be representable as a _wchar_t_ and be a valid
           character in the locale or be the value **WEOF**.
    


## RETURN VALUE



           If _wc_ was convertible to uppercase, **towupper**() returns its
           uppercase equivalent; otherwise it returns _wc_.
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌───────────────────────────────┬───────────────┬────────────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├───────────────────────────────┼───────────────┼────────────────┤
           │ **towupper**()                    │ Thread safety │ MT-Safe locale │
           ├───────────────────────────────┼───────────────┼────────────────┤
           │ **towupper_l**()                  │ Thread safety │ MT-Safe        │
           └───────────────────────────────┴───────────────┴────────────────┘
    


## STANDARDS



           **towupper**()
                  C11, POSIX.1-2008 (XSI).
    
           **towupper_l**()
                  POSIX.1-2008.
    


## NOTES



           The behavior of these functions depends on the **LC_CTYPE** category
           of the locale.
    
           These functions are not very appropriate for dealing with Unicode
           characters, because Unicode knows about three cases: upper, lower,
           and title case.
    


* * *
# probe::sunrpc.svc.destroy

## NAME



           probe::sunrpc.svc.destroy - Destroy an RPC service
    


## SYNOPSIS



           sunrpc.svc.destroy
    


## VALUES



           _netcnt_
               the count of received RPC requests
    
           _sv_prog_
               the number of the program
    
           _nettcpconn_
               the count of accepted TCP connections
    
           _rpccnt_
               the count of valid RPC requests
    
           _sv_progname_
               the name of the program
    
           _sv_nrthreads_
               the number of concurrent threads
    
           _rpcbadauth_
               the count of requests drooped for authentication failure
    
           _sv_name_
               the service name
    
           _rpcbadfmt_
               the count of requests dropped for bad formats
    


* * *
# gnutls_pkcs11_crt_is_known

## NAME



           gnutls_pkcs11_crt_is_known - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **unsigned gnutls_pkcs11_crt_is_known(const char ***_url_**,**
           **gnutls_x509_crt_t** _cert_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * url
                       A PKCS 11 url identifying a token
    
           gnutls_x509_crt_t cert
                       is the certificate to find issuer for
    
           unsigned int flags
                       Use zero or flags from **GNUTLS_PKCS11_OBJ_FLAG**.
    


## DESCRIPTION



           This function will check whether the provided certificate is
           stored in the specified token. This is useful in combination with
           **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_TRUSTED** or
           **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_DISTRUSTED** , to check whether a CA
           is present or a certificate is distrusted in a trust PKCS **11**
           module.
    
           This function can be used with a  _url_ of "pkcs11:", and in that
           case all modules will be searched. To restrict the modules to the
           marked as trusted in p11-kit use the
           **GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE** flag.
    
           Note that the flag **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_DISTRUSTED** is
           specific to p11-kit trust modules.
    


## RETURNS



           If the certificate exists non-zero is returned, otherwise zero.
    


## SINCE



           3.3.0
    


* * *
# probe::nfs.proc.release

## NAME



           probe::nfs.proc.release - NFS client releases file read/write
           context information
    


## SYNOPSIS



           nfs.proc.release
    


## VALUES



           _filename_
               file name
    
           _flag_
               file flag
    
           _server_ip_
               IP address of server
    
           _mode_
               file mode
    
           _version_
               NFS version (the function is used for all NFS version)
    
           _prot_
               transfer protocol
    


## DESCRIPTION



           Release file read/write context information
    


* * *
# function::user_string_quoted

## NAME



           function::user_string_quoted - Retrieves and quotes string from
           user space
    


## SYNOPSIS



               user_string_quoted:string(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    


## DESCRIPTION



           Returns the null terminated C string from a given user space
           memory address where any ASCII characters that are not printable
           are replaced by the corresponding escape sequence in the returned
           string. Note that the string will be surrounded by double quotes.
           On the rare cases when userspace data is not accessible at the
           given address, the address itself is returned as a string, without
           double quotes.
    


* * *
# gnutls_x509_crt_get_fingerprint

## NAME



           gnutls_x509_crt_get_fingerprint - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_fingerprint(gnutls_x509_crt_t** _cert_**,**
           **gnutls_digest_algorithm_t** _algo_**, void ***_buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_digest_algorithm_t algo
                       is a digest algorithm
    
           void * buf  a pointer to a structure to hold the fingerprint (may
                       be null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will calculate and copy the certificate's
           fingerprint in the provided buffer. The fingerprint is a hash of
           the DER-encoded data of the certificate.
    
           If the buffer is null then only the size will be filled.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the *buf_size will be updated with the
           required size.  On success 0 is returned.
    


* * *
# function::usrdev2kerndev

## NAME



           function::usrdev2kerndev - Converts a user-space device number
           into the format used in the kernel
    


## SYNOPSIS



               usrdev2kerndev:long(dev:long)
    


## ARGUMENTS



           _dev_
               Device number in user-space format.
    


* * *
# pcre2_substring_get_byname

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_get_byname(pcre2_match_data ***_match_data_**,**
             **PCRE2_SPTR** _name_**, PCRE2_UCHAR ****_bufferptr_**, PCRE2_SIZE ***_bufflen_**);**
    


## DESCRIPTION



    
           This is a convenience function for extracting a captured substring
           by name into newly acquired memory. The arguments are:
    
             _match_data_    The match data for the match
             _name_          Name of the required substring
             _bufferptr_     Where to put the string pointer
             _bufflen_       Where to put the string length
    
           The memory in which the substring is placed is obtained by calling
           the same memory allocation function that was used for the match
           data block. The convenience function **pcre2_substring_free()** can be
           used to free it when it is no longer needed. The yield of the
           function is zero for success or one of the following error
           numbers:
    
             PCRE2_ERROR_NOSUBSTRING   there are no groups of that name
             PCRE2_ERROR_UNAVAILBLE    the ovector was too small for that
           group
             PCRE2_ERROR_UNSET         the group did not participate in the
           match
             PCRE2_ERROR_NOMEMORY      memory could not be obtained
    
           If there is more than one group with the given name, the first one
           that is set is returned. In this situation PCRE2_ERROR_UNSET means
           that no group with the given name was set.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_x509_crt_get_authority_key_gn_serial

## NAME



           gnutls_x509_crt_get_authority_key_gn_serial - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_authority_key_gn_serial(gnutls_x509_crt_t**
           _cert_**, unsigned int** _seq_**, void ***_alt_**, size_t ***_alt_size_**, unsigned**
           **int ***_alt_type_**, void ***_serial_**, size_t ***_serial_size_**, unsigned int**
           *****_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * alt  is the place where the alternative name will be copied
                       to
    
           size_t * alt_size
                       holds the size of alt.
    
           unsigned int * alt_type
                       holds the type of the alternative name (one of
                       gnutls_x509_subject_alt_name_t).
    
           void * serial
                       buffer to store the serial number (may be null)
    
           size_t * serial_size
                       Holds the size of the serial field (may be null)
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the X.509 authority key identifier when
           stored as a general name (authorityCertIssuer) and serial number.
    
           Because more than one general names might be stored
            _seq_ can be used as a counter to request them all until
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


## SINCE



           3.0
    


* * *
# tapset::ucontext

## NAME



           tapset::ucontext - systemtap ucontext tapset
    


## DESCRIPTION



           **umodname**
                  Returns the (short) name of the user module.
    
                  See function::umodname(3stap)
                   for details.
    
           **ucallers**
                  Return first n elements of user stack backtrace
    
                  See function::ucallers(3stap)
                   for details.
    


* * *
# ctan

## NAME



           ctan, ctanf, ctanl - complex tangent function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex ctan(double complex** _z_**);**
           **float complex ctanf(float complex** _z_**);**
           **long double complex ctanl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex tangent of _z_.
    
           The complex tangent function is defined as:
    
               ctan(z) = csin(z) / ccos(z)
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌──────────────────────────────────────┬───────────────┬─────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **ctan**(), **ctanf**(), **ctanl**()             │ Thread safety │ MT-Safe │
           └──────────────────────────────────────┴───────────────┴─────────┘
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_pkcs12_bag_deinit

## NAME



           gnutls_pkcs12_bag_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **void gnutls_pkcs12_bag_deinit(gnutls_pkcs12_bag_t** _bag_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will deinitialize a PKCS12 Bag structure.
    


* * *
# function::ulong_arg

## NAME



           function::ulong_arg - Return function argument as unsigned long
    


## SYNOPSIS



               ulong_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the value of argument n as an unsigned long. On
           architectures where a long is 32 bits, the value is zero-extended
           to 64 bits.
    


* * *
# function::matched_str

## NAME



           function::matched_str - Return the last matched string.
    


## SYNOPSIS



               matched_str:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           returns the string matched by the last successful use of the =~
           regexp matching operator. Returns an error if the last use of =~
           led to a failed match.
    


* * *
# probe::sunrpc.clnt.restart_call

## NAME



           probe::sunrpc.clnt.restart_call - Restart an asynchronous RPC call
    


## SYNOPSIS



           sunrpc.clnt.restart_call
    


## VALUES



           _xid_
               the transmission id
    
           _servername_
               the server machine name
    
           _tk_priority_
               the task priority
    
           _prog_
               the RPC program number
    
           _tk_flags_
               the task flags
    
           _tk_runstate_
               the task run status
    
           _tk_pid_
               the debugging aid of task
    


* * *
# pthread_equal

## NAME



           pthread_equal - compare thread IDs
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **int pthread_equal(pthread_t** _t1_**, pthread_t** _t2_**);**
    


## DESCRIPTION



           The **pthread_equal**() function compares two thread identifiers.
    


## RETURN VALUE



           If the two thread IDs are equal, **pthread_equal**() returns a nonzero
           value; otherwise, it returns 0.
    


## ERRORS



           This function always succeeds.
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌──────────────────────────────────────┬───────────────┬─────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **pthread_equal**()                      │ Thread safety │ MT-Safe │
           └──────────────────────────────────────┴───────────────┴─────────┘
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The **pthread_equal**() function is necessary because thread IDs
           should be considered opaque: there is no portable way for
           applications to directly compare two _pthread_t_ values.
    


* * *
# isspace

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           isspace, isspace_l — test for a white-space character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isspace(int _c_);
           int isspace_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isspace_(): The functionality described on this reference page
           is aligned with the ISO C standard. Any conflict between the
           requirements described here and the ISO C standard is
           unintentional. This volume of POSIX.1‐2017 defers to the ISO C
           standard.
    
           The _isspace_() and _isspace_l_() functions shall test whether _c_ is a
           character of class **space** in the current locale, or in the locale
           represented by _locale_ , respectively; see the Base Definitions
           volume of POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _c_ argument is an **int** , the value of which the application shall
           ensure is a character representable as an **unsigned char** or equal
           to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isspace_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isspace_() and _isspace_l_() functions shall return non-zero if _c_
           is a white-space character; otherwise, they shall return 0.
    


## ERRORS



           No errors are defined.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs11_token_get_flags

## NAME



           gnutls_pkcs11_token_get_flags - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_get_flags(const char ***_url_**, unsigned int ***
           _flags_**);**
    


## ARGUMENTS



           const char * url
                       should contain a PKCS 11 URL
    
           unsigned int * flags
                       The output flags (GNUTLS_PKCS11_TOKEN_*)
    


## DESCRIPTION



           This function will return information about the PKCS 11 token
           flags.
    
           The supported flags are: **GNUTLS_PKCS11_TOKEN_HW** and
           **GNUTLS_PKCS11_TOKEN_TRUSTED**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# sd_bus_message_skip

## NAME



           sd_bus_message_skip - Skip elements in a bus message
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_skip(sd_bus_message ***_m_**, const char***_types_**);**
    


## DESCRIPTION



           **sd_bus_message_skip()** is somewhat similar to
           sd_bus_message_read(3), but instead of reading the contents of the
           message, it only moves the "read pointer". Subsequent read
           operations will read the elements that are after the elements that
           were skipped.
    
           The _types_ argument has the same meaning as in
           **sd_bus_message_read()**. It may also be **NULL** , to skip a single
           element of any type.
    


## RETURN VALUE



           On success, **sd_bus_message_skip()** returns 0 or a positive integer.
           On failure, it returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _m_ parameter is **NULL**.
    
           **-EBADMSG**
               The message cannot be parsed.
    
           **-EPERM**
               The message is not sealed.
    
           **-ENXIO**
               The message end has been reached and the requested elements
               cannot be read.
    
           **-ENOMEM**
               Memory allocation failed.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# gnutls_certificate_verification_profile_get_name

## NAME



           gnutls_certificate_verification_profile_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **const char ***
           **gnutls_certificate_verification_profile_get_name(gnutls_certificate_verification_profiles_t**
           _id_**);**
    


## ARGUMENTS



           gnutls_certificate_verification_profiles_t id
                       is a profile ID
    


## DESCRIPTION



           Convert a **gnutls_certificate_verification_profiles_t** value to a
           string.
    


## RETURNS



           a string that contains the name of the specified profile or **NULL**.
    


* * *
# gnutls_supplemental_register

## NAME



           gnutls_supplemental_register - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_supplemental_register(const char ***_name_**,**
           **gnutls_supplemental_data_format_type_t** _type_**, gnutls_supp_recv_func**
           _recv_func_**, gnutls_supp_send_func** _send_func_**);**
    


## ARGUMENTS



           const char * name
                       the name of the supplemental data to register
    
           gnutls_supplemental_data_format_type_t type
                       the type of the supplemental data format
    
           gnutls_supp_recv_func recv_func
                       the function to receive the data
    
           gnutls_supp_send_func send_func
                       the function to send the data
    


## DESCRIPTION



           This function will register a new supplemental data type
           (rfc4680).  The registered data will remain until
           **gnutls_global_deinit()** is called. The provided  _type_ must be an
           unassigned type in **gnutls_supplemental_data_format_type_t**. If the
           type is already registered or handled by GnuTLS internally
           **GNUTLS_E_ALREADY_REGISTERED** will be returned.
    
           This function is not thread safe. As supplemental data are not
           defined under TLS 1.3, this function will disable TLS 1.3 support
           globally.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.4.0
    


* * *
# umad_close_port

## NAME



           umad_close_port - close InfiniBand device port for umad access
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_close_port(int** _portid_**);**
    


## DESCRIPTION



           **umad_close_port()** closes the port specified by the handle _portid_.
    


## RETURN VALUE



           **umad_close_port()** returns 0 on success, and a negative value on
           error.  -EINVAL is returned if the _portid_ is not a handle to a
           valid (open) port.
    


* * *
# fdatasync

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           fdatasync — synchronize the data of a file (**REALTIME**)
    


## SYNOPSIS



           #include <unistd.h>
    
           int fdatasync(int _fildes_);
    


## DESCRIPTION



           The _fdatasync_() function shall force all currently queued I/O
           operations associated with the file indicated by file descriptor
           _fildes_ to the synchronized I/O completion state.
    
           The functionality shall be equivalent to _fsync_() with the symbol
           _POSIX_SYNCHRONIZED_IO defined, with the exception that all I/O
           operations shall be completed as defined for synchronized I/O data
           integrity completion.
    


## RETURN VALUE



           If successful, the _fdatasync_() function shall return the value 0;
           otherwise, the function shall return the value -1 and set _errno_ to
           indicate the error. If the _fdatasync_() function fails, outstanding
           I/O operations are not guaranteed to have been completed.
    


## ERRORS



           The _fdatasync_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **EINVAL** This implementation does not support synchronized I/O for
                  this file.
    
           In the event that any of the queued I/O operations fail,
           _fdatasync_() shall return the error conditions defined for _read_()
           and _write_().
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Note that even if the file descriptor is not open for writing, if
           there are any pending write requests on the underlying file, then
           that I/O will be completed prior to the return of _fdatasync_().
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# if_indextoname

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           if_indextoname — map a network interface index to its
           corresponding name
    


## SYNOPSIS



           #include <net/if.h>
    
           char *if_indextoname(unsigned _ifindex_ , char *_ifname_);
    


## DESCRIPTION



           The _if_indextoname_() function shall map an interface index to its
           corresponding name.
    
           When this function is called, _ifname_ shall point to a buffer of at
           least {IF_NAMESIZE} bytes. The function shall place in this buffer
           the name of the interface with index _ifindex_.
    


## RETURN VALUE



           If _ifindex_ is an interface index, then the function shall return
           the value supplied in _ifname_ , which points to a buffer now
           containing the interface name. Otherwise, the function shall
           return a null pointer and set _errno_ to indicate the error.
    


## ERRORS



           The _if_indextoname_() function shall fail if:
    
           **ENXIO** The interface does not exist.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::atomic_long_read

## NAME



           function::atomic_long_read - Retrieves an atomic long variable
           from kernel memory
    


## SYNOPSIS



               atomic_long_read:long(addr:long)
    


## ARGUMENTS



           _addr_
               pointer to atomic long variable
    


## DESCRIPTION



           Safely perform the read of an atomic long variable. This will be a
           NOP on kernels that do not have ATOMIC_LONG_INIT set on the kernel
           config.
    


* * *
# probe::nfs.proc.write_setup

## NAME



           probe::nfs.proc.write_setup - NFS client setting up a write RPC
           task
    


## SYNOPSIS



           nfs.proc.write_setup
    


## VALUES



           _size_
               bytes written in this execution
    
           _offset_
               the file offset
    
           _bitmask1_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _prot_
               transfer protocol
    
           _count_
               bytes written in this execution
    
           _bitmask0_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _version_
               NFS version
    
           _server_ip_
               IP address of server
    
           _how_
               used to set args.stable. The stable value could be:
               NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC (in
               nfs.proc3.write_setup and nfs.proc4.write_setup)
    


## DESCRIPTION



           The write_setup function is used to setup a write RPC task. It is
           not doing the actual write operation.
    


* * *
# function::user_string

## NAME



           function::user_string - Retrieves string from user space
    


## SYNOPSIS



           1) user_string:string(addr:long)
    
           2) user_string:string(addr:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    
           _err_msg_
               the error message to return when data isn't available
    


## DESCRIPTION



           1) Returns the null terminated C string from a given user space
           memory address. Reports an error on the rare cases when userspace
           data is not accessible.
    
           2) Returns the null terminated C string from a given user space
           memory address. Reports the given error message on the rare cases
           when userspace data is not accessible.
    


* * *
# probe::scsi.iodone

## NAME



           probe::scsi.iodone - SCSI command completed by low level driver
           and enqueued into the done queue.
    


## SYNOPSIS



           scsi.iodone
    


## VALUES



           _channel_
               The channel number
    
           _host_no_
               The host number
    
           _device_state_
               The current state of the device
    
           _lun_
               The lun number
    
           _data_direction_
               The data_direction specifies whether this command is from/to
               the device.
    
           _data_direction_str_
               Data direction, as a string
    
           _device_state_str_
               The current state of the device, as a string
    
           _scsi_timer_pending_
               1 if a timer is pending on this request
    
           _dev_id_
               The scsi device id
    
           _req_addr_
               The current struct request pointer, as a number
    


* * *
# gnutls_pkcs7_get_signature_info

## NAME



           gnutls_pkcs7_get_signature_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_signature_info(gnutls_pkcs7_t** _pkcs7_**, unsigned**
           _idx_**, gnutls_pkcs7_signature_info_st ***_info_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a **gnutls_pkcs7_t** type
    
           unsigned idx
                       the index of the signature info to check
    
           gnutls_pkcs7_signature_info_st * info
                       will contain the output signature
    


## DESCRIPTION



           This function will return information about the signature
           identified by idx in the provided PKCS **7** structure. The
           information should be deinitialized using
           **gnutls_pkcs7_signature_info_deinit()**.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value.
    


## SINCE



           3.4.2
    


* * *
# function::user_string_nofault

## NAME



           function::user_string_nofault - Retrieves string from user space
    


## SYNOPSIS



               user_string_nofault:string(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    


## DESCRIPTION



           Returns the null terminated C string from a given user space
           memory address. Returns the empty string if userspace data is not
           accessible.
    


* * *
# function::user_uint64_error

## NAME



           function::user_uint64_error - Retrieves an unsigned 64-bit integer
           value stored in user space
    


## SYNOPSIS



               user_uint64_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned 64-bit integer
               from
    


## DESCRIPTION



           Returns the unsigned 64-bit integer value from a given user space
           address. If the user space data is not accessible, an error will
           occur.
    


* * *
# libpfm_amd64_fam10h

## NAME



           libpfm_amd64_fam10h - support for AMD64 Family 10h processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam10h_barcelona, amd64_fam10h_shanghai, amd64_fam10h_istanbul**
           **PMU desc: AMD64 Fam10h Barcelona, AMD64 Fam10h Shanghai, AMD64 Fam10h Istanbul**
    


## DESCRIPTION



           The library supports AMD Family 10h processors in both 32 and
           64-bit modes. They correspond to processor family 16.
    


## MODIFIERS



           The following modifiers are supported on AMD64 Family 10h (16)
           processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **h** Measure at while executing in host mode (when using
                  virtualization). This corresponds to **PFM_PLMH**.  This
                  modifier is available starting with Fam10h. This is a
                  boolean modifier.
    
           **g** Measure at while executing in guest mode (when using
                  virtualization). This modifier is available starting with
                  Fam10h. This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    


* * *
# gnutls_hash_fast

## NAME



           gnutls_hash_fast - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hash_fast(gnutls_digest_algorithm_t** _algorithm_**, const**
           **void ***_ptext_**, size_t** _ptext_len_**, void ***_digest_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t algorithm
                       the hash algorithm to use
    
           const void * ptext
                       the data to hash
    
           size_t ptext_len
                       the length of data to hash
    
           void * digest
                       is the output value of the hash
    


## DESCRIPTION



           This convenience function will hash the given data and return
           output on a single call.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# gnutls_pkcs12_export2

## NAME



           gnutls_pkcs12_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_export2(gnutls_pkcs12_t** _pkcs12_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a structure PEM or DER encoded
    


## DESCRIPTION



           This function will export the pkcs12 structure to DER or PEM
           format.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           PKCS12".
    


## RETURNS



           In case of failure a negative error code will be returned, and 0
           on success.
    


## SINCE



           3.1.3
    


* * *