tripathysagar/man_text huggingface dataset:
# selinux_file_context_cmp

## NAME



           selinux_file_context_cmp - Compare two SELinux security contexts
           excluding the 'user' component
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int selinux_file_context_cmp(const char ***_a_**,**
                  **const char ***_b_**);**
    


## DESCRIPTION



           **selinux_file_context_cmp**() compares two context strings excluding
           the user component with strcmp(3) as shown in the **EXAMPLE** section.
    
           This is useful as for most object contexts, the user component is
           not relevant.
    


## RETURN VALUE



           The return values follow the strcmp(3) function, where:
                  0  if they are equal.
                  1  if _a_ is greater than _b_
                  -1 if _a_ is less than _b_
    


## ERRORS



           None.
    


## NOTES



           The contexts being compared do not specifically need to be file
           contexts.
    


## EXAMPLE



           If context _a_ is:
                  user_u:user_r:user_t:s0
    
           and context _b_ is:
                  root:user_r:user_t:s0
    
           then the actual strings compared are:
                  :user_r:user_t:s0 and :user_r:user_t:s0
    
           Therefore they will match and **selinux_file_context_cmp**() will
           return zero.
    


* * *
# isfdtype

## NAME



           isfdtype - test file type of a file descriptor
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/stat.h>**
           **#include <sys/socket.h>**
    
           **int isfdtype(int** _fd_**, int** _fdtype_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **isfdtype**():
               Since glibc 2.20:
                   _DEFAULT_SOURCE
               Before glibc 2.20:
                   _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The **isfdtype**() function tests whether the file descriptor _fd_
           refers to a file of type _fdtype_.  The _fdtype_ argument specifies
           one of the **S_IF*** constants defined in _< sys/stat.h>_ and documented
           in stat(2) (e.g., **S_IFREG**).
    


## RETURN VALUE



           The **isfdtype**() function returns 1 if the file descriptor _fd_ is of
           type _fdtype_ and 0 if it is not.  On failure, -1 is returned and
           _errno_ is set to indicate the error.
    


## ERRORS



           The **isfdtype**() function can fail with any of the same errors as
           fstat(2).
    


## VERSIONS



           Portable applications should use fstat(2) instead.
    


## STANDARDS



           None.
    


* * *
# dane_query_status

## NAME



           dane_query_status - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **dane_query_status_t dane_query_status(dane_query_t** _q_**);**
    


## ARGUMENTS



           dane_query_t q
                       The query result structure
    


## DESCRIPTION



           This function will return the status of the query response.  See
           **dane_query_status_t** for the possible types.
    


## RETURNS



           The status type.
    


* * *
# getdirentries

## NAME



           getdirentries - get directory entries in a filesystem-independent
           format
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <dirent.h>**
    
           **ssize_t getdirentries(** size_t nbytes;
                                 **int** _fd_**, char** _buf_**[restrict** _nbytes_**], size_t** _nbytes_**,**
                                 **off_t *restrict** _basep_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **getdirentries**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           Read directory entries from the directory specified by _fd_ into
           _buf_.  At most _nbytes_ are read.  Reading starts at offset _*basep_ ,
           and _*basep_ is updated with the new position after reading.
    


## RETURN VALUE



           **getdirentries**() returns the number of bytes read or zero when at
           the end of the directory.  If an error occurs, -1 is returned, and
           _errno_ is set to indicate the error.
    


## ERRORS



           See the Linux library source code for details.
    


## ATTRIBUTES



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


## STANDARDS



           BSD.
    


## NOTES



           Use opendir(3) and readdir(3) instead.
    


* * *
# tapset::inet

## NAME



           tapset::inet - systemtap inet tapset
    


## DESCRIPTION



           **htonll** Convert 64-bit long long from host to network order
    
                  See function::htonll(3stap)
                   for details.
    
           **htonl** Convert 32-bit long from host to network order
    
                  See function::htonl(3stap)
                   for details.
    
           **htons** Convert 16-bit short from host to network order
    
                  See function::htons(3stap)
                   for details.
    
           **ntohll** Convert 64-bit long long from network to host order
    
                  See function::ntohll(3stap)
                   for details.
    
           **ntohl** Convert 32-bit long from network to host order
    
                  See function::ntohl(3stap)
                   for details.
    
           **ntohs** Convert 16-bit short from network to host order
    
                  See function::ntohs(3stap)
                   for details.
    


* * *
# gnutls_x509_crq_privkey_sign

## NAME



           gnutls_x509_crq_privkey_sign - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_x509_crq_privkey_sign(gnutls_x509_crq_t** _crq_**,**
           **gnutls_privkey_t** _key_**, gnutls_digest_algorithm_t** _dig_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_privkey_t key
                       holds a private key
    
           gnutls_digest_algorithm_t dig
                       The message digest to use, i.e., **GNUTLS_DIG_SHA1**
    
           unsigned int flags
                       must be 0
    


## DESCRIPTION



           This function will sign the certificate request with a private
           key.  This must be the same key as the one used in
           **gnutls_x509_crt_set_key()** since a certificate request is self
           signed.
    
           This must be the last step in a certificate request generation
           since all the previously set parameters are now signed.
    
           A known limitation of this function is, that a newly-signed
           request will not be fully functional (e.g., for signature
           verification), until it is exported an re-imported.
    
           After GnuTLS 3.6.1 the value of  _dig_ may be **GNUTLS_DIG_UNKNOWN** ,
           and in that case, a suitable but reasonable for the key algorithm
           will be selected.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
           **GNUTLS_E_ASN1_VALUE_NOT_FOUND** is returned if you didn't set all
           information in the certificate request (e.g., the version using
           **gnutls_x509_crq_set_version()**).
    


## SINCE



           2.12.0
    


* * *
# gnutls_x509_privkey_export2

## NAME



           gnutls_x509_privkey_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export2(gnutls_x509_privkey_t** _key_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       Holds the key
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a private key PEM or DER encoded
    


## DESCRIPTION



           This function will export the private key to a PKCS**1** structure for
           RSA or RSA-PSS keys, and integer sequence for DSA keys. Other keys
           types will be exported in PKCS**8** form.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           It is recommended to use **gnutls_x509_privkey_export2_pkcs8()**
           instead of this function, when a consistent output format is
           required.
    


## RETURNS



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


* * *
# atof

## NAME



           atof - convert a string to a double
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **double atof(const char ***_nptr_**);**
    


## DESCRIPTION



           The **atof**() function converts the initial portion of the string
           pointed to by _nptr_ to _double_.  The behavior is the same as
    
               strtod(nptr, NULL);
    
           except that **atof**() does not detect errors.
    


## RETURN VALUE



           The converted value.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ispunct

## 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



           ispunct, ispunct_l — test for a punctuation character
    


## SYNOPSIS



           #include <ctype.h>
    
           int ispunct(int _c_);
           int ispunct_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _ispunct_(): 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 _ispunct_() and _ispunct_l_() functions shall test whether _c_ is a
           character of class **punct** 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 _ispunct_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _ispunct_() and _ispunct_l_() functions shall return non-zero if _c_
           is a punctuation 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.
    


* * *
# probe::nfs.proc.lookup

## NAME



           probe::nfs.proc.lookup - NFS client opens/searches a file on
           server
    


## SYNOPSIS



           nfs.proc.lookup
    


## VALUES



           _server_ip_
               IP address of server
    
           _filename_
               the name of file which client opens/searches on server
    
           _bitmask1_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _prot_
               transfer protocol
    
           _bitmask0_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _name_len_
               the length of file name
    
           _version_
               NFS version
    


* * *
# gnutls_x509_crt_check_revocation

## NAME



           gnutls_x509_crt_check_revocation - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_check_revocation(gnutls_x509_crt_t** _cert_**, const**
           **gnutls_x509_crl_t ***_crl_list_**, unsigned** _crl_list_length_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const gnutls_x509_crl_t * crl_list
                       should contain a list of gnutls_x509_crl_t types
    
           unsigned crl_list_length
                       the length of the crl_list
    


## DESCRIPTION



           This function will check if the given certificate is revoked.  It
           is assumed that the CRLs have been verified before.
    


## RETURNS



           0 if the certificate is NOT revoked, and 1 if it is.  A negative
           error code is returned on error.
    


* * *
# gnutls_x509_trust_list_add_system_trust

## NAME



           gnutls_x509_trust_list_add_system_trust - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_trust_list_add_system_trust(gnutls_x509_trust_list_t**
           _list_**, unsigned int** _tl_flags_**, unsigned int** _tl_vflags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The structure of the list
    
           unsigned int tl_flags
                       GNUTLS_TL_*
    
           unsigned int tl_vflags
                       gnutls_certificate_verify_flags if flags specifies
                       GNUTLS_TL_VERIFY_CRL
    


## DESCRIPTION



           This function adds the system's default trusted certificate
           authorities to the trusted list. Note that on unsupported systems
           this function returns **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    
           This function implies the flag **GNUTLS_TL_NO_DUPLICATES**.
    


## RETURNS



           The number of added elements or a negative error code on error.
    


## SINCE



           3.1
    


* * *
# rdma_post_readv

## NAME



           rdma_post_readv - post an RDMA read work request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_readv (struct rdma_cm_id ***_id_**, void ***_context_**, struct**
           **ibv_sge ***_sgl_**, int** _nsge_**, int** _flags_**, uint64_t** _remote_addr_**, uint32_t**
           _rkey_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       request will be posted.
    
           context     User-defined context associated with the request.
    
           sgl         A scatter-gather list of the destination buffers of
                       the read.
    
           nsge        The number of scatter-gather array entries.
    
           flags       Optional flags used to control the read operation.
    
           remote_addr The address of the remote registered memory to read
                       from.
    
           rkey        The registered memory key associated with the remote
                       address.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the remote memory
           region will be read into the local data buffers.
    


## RETURN VALUE



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


## NOTES



           For a list of supported flags, see ibv_post_send.  Both the remote
           and local data buffers must have been registered before the read
           is issued, and the buffers must remain registered until the read
           completes.
    
           Read operations may not be posted to an rdma_cm_id or the
           corresponding queue pair until it has been connected.
    
           The user-defined context associated with the read request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# function::registers_valid

## NAME



           function::registers_valid - Determines validity of **register** and
           **u_register** in current context
    


## SYNOPSIS



               registers_valid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns 1 if **register** and **u_register** can be used in
           the current context, or 0 otherwise. For example, **registers_valid**
           returns 0 when called from a begin or end probe.
    


* * *
# iscntrl

## 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



           iscntrl, iscntrl_l — test for a control character
    


## SYNOPSIS



           #include <ctype.h>
    
           int iscntrl(int _c_);
           int iscntrl_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _iscntrl_(): 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 _iscntrl_() and _iscntrl_l_() functions shall test whether _c_ is a
           character of class **cntrl** 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 a type **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 _iscntrl_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iscntrl_() and _iscntrl_l_() functions shall return non-zero if _c_
           is a control 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.
    


* * *
# probe::sunrpc.clnt.create_client

## NAME



           probe::sunrpc.clnt.create_client - Create an RPC client
    


## SYNOPSIS



           sunrpc.clnt.create_client
    


## VALUES



           _authflavor_
               the authentication flavor
    
           _servername_
               the server machine name
    
           _prog_
               the RPC program number
    
           _progname_
               the RPC program name
    
           _prot_
               the IP protocol number
    
           _vers_
               the RPC program version number
    
           _port_
               the port number
    


* * *
# gnutls_x509_dn_deinit

## NAME



           gnutls_x509_dn_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_dn_deinit(gnutls_x509_dn_t** _dn_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       a DN uint8_t object pointer.
    


## DESCRIPTION



           This function deallocates the DN object as returned by
           **gnutls_x509_dn_import()**.
    


## SINCE



           2.4.0
    


* * *
# function::cputime_to_string

## NAME



           function::cputime_to_string - Human readable string for given
           cputime
    


## SYNOPSIS



               cputime_to_string:string(cputime:long)
    


## ARGUMENTS



           _cputime_
               Time to translate.
    


## DESCRIPTION



           Equivalent to calling: msec_to_string (cputime_to_msecs (cputime).
    


* * *
# probe::vm.brk

## NAME



           probe::vm.brk - Fires when a brk is requested (i.e. the heap will
           be resized)
    


## SYNOPSIS



           vm.brk
    


## VALUES



           _name_
               name of the probe point
    
           _address_
               the requested address
    
           _length_
               the length of the memory segment
    


## CONTEXT



           The process calling brk.
    


* * *
# fgetws

## NAME



           fgetws - read a wide-character string from a FILE stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *fgetws(** int n;
                    **wchar_t** _ws_**[restrict** _n_**], int** _n_**, FILE *restrict** _stream_**);**
    


## DESCRIPTION



           The **fgetws**() function is the wide-character equivalent of the
           fgets(3) function.  It reads a string of at most _n-1_ wide
           characters into the wide-character array pointed to by _ws_ , and
           adds a terminating null wide character (L'\0').  It stops reading
           wide characters after it has encountered and stored a newline wide
           character.  It also stops when end of stream is reached.
    
           The programmer must ensure that there is room for at least _n_ wide
           characters at _ws_.
    
           For a nonlocking counterpart, see unlocked_stdio(3).
    


## RETURN VALUE



           The **fgetws**() function, if successful, returns _ws_.  If end of
           stream was already reached or if an error occurred, it returns
           NULL.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **fgetws**() depends on the **LC_CTYPE** category of the
           current locale.
    
           In the absence of additional information passed to the fopen(3)
           call, it is reasonable to expect that **fgetws**() will actually read
           a multibyte string from the stream and then convert it to a wide-
           character string.
    
           This function is unreliable, because it does not permit to deal
           properly with null wide characters that may be present in the
           input.
    


* * *
# strndup

## 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



           strndup — duplicate a specific number of bytes from a string
    


## SYNOPSIS



           #include <string.h>
    
           char *strndup(const char *_s_ , size_t _size_);
    


## DESCRIPTION



           Refer to strdup(3p).
    


* * *
# io_uring_get_events

## NAME



           io_uring_get_events - Flush outstanding requests to CQE ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_get_events(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The io_uring_get_events(3) function runs outstanding work and
           flushes completion events to the CQE ring.
    
           There can be events needing to be flushed if the ring was full and
           had overflowed.  Alternatively if the ring was setup with the
           **IORING_SETUP_DEFER_TASKRUN** flag then this will process outstanding
           tasks, possibly resulting in more CQEs.
    


## RETURN VALUE



           On success io_uring_get_events(3) returns 0. On failure it returns
           **-errno**.
    


* * *
# pcap_dump_fopen

## NAME



           pcap_dump_open, pcap_dump_open_append, pcap_dump_fopen - open a
           file to which to write packets
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **pcap_dumper_t *pcap_dump_open(pcap_t *p, const char *fname);**
           **pcap_dumper_t *pcap_dump_open_append(pcap_t *p, const char *fname);**
           **pcap_dumper_t *pcap_dump_fopen(pcap_t *p, FILE *fp);**
    


## DESCRIPTION



           **pcap_dump_open**() is called to open a ``savefile'' for writing.
           _fname_ specifies the name of the file to open. The file will have
           the same format as those used by tcpdump(1) and **tcpslice**(1).  If
           the file does not exist, it will be created; if the file exists,
           it will be truncated and overwritten.  The name "-" is a synonym
           for **stdout**.
    
           **pcap_dump_fopen**() is called to write data to an existing open
           stream _fp_ ; this stream will be closed by a subsequent call to
           **pcap_dump_close**(3PCAP).  The stream is assumed to be at the
           beginning of a file that has been newly created or truncated, so
           that writes will start at the beginning of the file.  Note that on
           Windows, that stream should be opened in binary mode.
    
           _p_ is a capture or ``savefile'' handle returned by an earlier call
           to **pcap_create**(3PCAP) and activated by an earlier call to
           **pcap_activate**(3PCAP), or returned by an earlier call to
           **pcap_open_offline**(3PCAP), **pcap_open_live**(3PCAP), or
           **pcap_open_dead**(3PCAP).  The time stamp precision, link-layer type,
           and snapshot length from _p_ are used as the link-layer type and
           snapshot length of the output file.
    
           **pcap_dump_open_append**() is like **pcap_dump_open**() but, if the file
           already exists, and is a pcap file with the same byte order as the
           host opening the file, and has the same time stamp precision,
           link-layer header type, and snapshot length as _p_ , it will write
           new packets at the end of the file.
    


## RETURN VALUE



           A pointer to a **pcap_dumper_t** structure to use in subsequent
           **pcap_dump**(3PCAP) and **pcap_dump_close**(3PCAP) calls is returned on
           success.  **NULL** is returned on failure.  If **NULL** is returned,
           **pcap_geterr**(3PCAP) can be used to get the error text.
    


## BACKWARD COMPATIBILITY



           The **pcap_dump_open_append**() function became available in libpcap
           release 1.7.2.  In previous releases, there is no support for
           appending packets to an existing savefile.
    


* * *
# gnutls_pubkey_export_dh_raw

## NAME



           gnutls_pubkey_export_dh_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_dh_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_dh_params_t** _params_**, gnutls_datum_t ***_y_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_dh_params_t params
                       will hold the Diffie-Hellman parameter (optional),
                       must be initialized
    
           gnutls_datum_t * y
                       will hold the y
    
           unsigned flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the Diffie-Hellman public key parameter
           found in the given public key.  The new parameter will be
           allocated using **gnutls_malloc()** and will be stored in the
           appropriate datum.
    
           To retrieve other parameters common in both public key and private
           key, use **gnutls_dh_params_export_raw()**.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



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


## SINCE



           3.8.2
    


* * *
# probe::sunrpc.sched.delay

## NAME



           probe::sunrpc.sched.delay - Delay an RPC task
    


## SYNOPSIS



           sunrpc.sched.delay
    


## VALUES



           _xid_
               the transmission id in the RPC call
    
           _prot_
               the IP protocol in the RPC call
    
           _vers_
               the program version in the RPC call
    
           _tk_pid_
               the debugging id of the task
    
           _delay_
               the time delayed
    
           _tk_flags_
               the flags of the task
    
           _prog_
               the program number in the RPC call
    


* * *
# gnutls_x509_crl_set_number

## NAME



           gnutls_x509_crl_set_number - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_number(gnutls_x509_crl_t** _crl_**, const void ***
           _nr_**, size_t** _nr_size_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       a CRL of type **gnutls_x509_crl_t**
    
           const void * nr
                       The CRL number
    
           size_t nr_size
                       Holds the size of the nr field.
    


## DESCRIPTION



           This function will set the CRL's number extension. This is to be
           used as a unique and monotonic number assigned to the CRL by the
           authority.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# gnutls_pubkey_verify_hash2

## NAME



           gnutls_pubkey_verify_hash2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_verify_hash2(gnutls_pubkey_t** _key_**,**
           **gnutls_sign_algorithm_t** _algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_hash_**, const gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_sign_algorithm_t algo
                       The signature algorithm used
    
           unsigned int flags
                       Zero or an OR list of **gnutls_certificate_verify_flags**
    
           const gnutls_datum_t * hash
                       holds the hash digest to be verified
    
           const gnutls_datum_t * signature
                       contains the signature
    


## DESCRIPTION



           This function will verify the given signed digest, using the
           parameters from the public key. Note that unlike
           **gnutls_privkey_sign_hash()** , this function accepts a signature
           algorithm instead of a digest algorithm.  You can use
           **gnutls_pk_to_sign()** to get the appropriate value.
    


## RETURNS



           In case of a verification failure **GNUTLS_E_PK_SIG_VERIFY_FAILED** is
           returned, and zero or positive code on success. For known to be
           insecure signatures this function will return
           **GNUTLS_E_INSUFFICIENT_SECURITY** unless the flag
           **GNUTLS_VERIFY_ALLOW_BROKEN** is specified.
    


## SINCE



           3.0
    


* * *
# pcap_tstamp_type_val_to_name

## NAME



           pcap_tstamp_type_val_to_name, pcap_tstamp_type_val_to_description
           - get a name or description for a time stamp type value
    


## SYNOPSIS



           **#include <pcap.h>**
    
           **const char *pcap_tstamp_type_val_to_name(int tstamp_type);**
           **const char *pcap_tstamp_type_val_to_description(int tstamp_type);**
    


## DESCRIPTION



           **pcap_tstamp_type_val_to_name**() translates a time stamp type value
           to the corresponding time stamp type name.  **NULL** is returned on
           failure.
    
           **pcap_tstamp_type_val_to_description**() translates a time stamp type
           value to a short description of that time stamp type.  **NULL** is
           returned on failure.
    


## BACKWARD COMPATIBILITY



           These functions became available in libpcap release 1.2.1.
    


* * *
# wcscspn

## NAME



           wcscspn - search a wide-character string for any of a set of wide
           characters
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **size_t wcscspn(const wchar_t ***_wcs_**, const wchar_t ***_reject_**);**
    


## DESCRIPTION



           The **wcscspn**() function is the wide-character equivalent of the
           strcspn(3) function.  It determines the length of the longest
           initial segment of _wcs_ which consists entirely of wide-characters
           not listed in _reject_.  In other words, it searches for the first
           occurrence in the wide-character string _wcs_ of any of the
           characters in the wide-character string _reject_.
    


## RETURN VALUE



           The **wcscspn**() function returns the number of wide characters in
           the longest initial segment of _wcs_ which consists entirely of
           wide-characters not listed in _reject_.  In other words, it returns
           the position of the first occurrence in the wide-character string
           _wcs_ of any of the characters in the wide-character string _reject_ ,
           or _wcslen(wcs)_ if there is none.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_session_set_keylog_function

## NAME



           gnutls_session_set_keylog_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_set_keylog_function(gnutls_session_t** _session_**,**
           **gnutls_keylog_func** _func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is **gnutls_session_t** type
    
           gnutls_keylog_func func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback to be called when a new secret
           is derived and installed during handshake.
    


## SINCE



           3.6.13
    


* * *
# gnutls_x509_trust_list_iter_get_ca

## NAME



           gnutls_x509_trust_list_iter_get_ca - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_iter_get_ca(gnutls_x509_trust_list_t**
           _list_**, gnutls_x509_trust_list_iter_t ***_iter_**, gnutls_x509_crt_t ***
           _crt_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           gnutls_x509_trust_list_iter_t * iter
                       A pointer to an iterator (initially the iterator
                       should be **NULL**)
    
           gnutls_x509_crt_t * crt
                       where the certificate will be copied
    


## DESCRIPTION



           This function obtains a certificate in the trust list and advances
           the iterator to the next certificate. The certificate returned in
           _crt_ must be deallocated with **gnutls_x509_crt_deinit()**.
    
           When past the last element is accessed
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned and the iterator
           is reset.
    
           The iterator is deinitialized and reset to **NULL** automatically by
           this function after iterating through all elements until
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned. If the
           iteration is aborted early, it must be manually deinitialized
           using **gnutls_x509_trust_list_iter_deinit()**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# function::user_ushort

## NAME



           function::user_ushort - Retrieves an unsigned short value stored
           in user space
    


## SYNOPSIS



               user_ushort:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned short from
    


## DESCRIPTION



           Returns the unsigned short value from a given user space address.
           Returns zero when user space data is not accessible.
    


* * *
# gnutls_db_get_default_cache_expiration

## NAME



           gnutls_db_get_default_cache_expiration - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_db_get_default_cache_expiration(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Returns the expiration time (in seconds) of stored sessions for
           resumption.
    


* * *
# gnutls_x509_dn_get_rdn_ava

## NAME



           gnutls_x509_dn_get_rdn_ava - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_get_rdn_ava(gnutls_x509_dn_t** _dn_**, int** _irdn_**, int**
           _iava_**, gnutls_x509_ava_st ***_ava_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       a pointer to DN
    
           int irdn    index of RDN
    
           int iava    index of AVA.
    
           gnutls_x509_ava_st * ava
                       Pointer to structure which will hold output
                       information.
    


## DESCRIPTION



           Get pointers to data within the DN. The format of the  _ava_
           structure is shown below.
    
           struct gnutls_x509_ava_st { gnutls_datum_t oid; gnutls_datum_t
           value; unsigned long value_tag; };
    
           The X.509 distinguished name is a sequence of sequences of strings
           and this is what the  _irdn_ and  _iava_ indexes model.
    
           Note that  _ava_ will contain pointers into the  _dn_ structure which
           in turns points to the original certificate. Thus you should not
           modify any data or deallocate any of those.
    
           This is a low-level function that requires the caller to do the
           value conversions when necessary (e.g. from UCS-2).
    


## RETURNS



           Returns 0 on success, or an error code.
    


* * *
# setlogmask

## NAME



           setlogmask - set log priority mask
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <syslog.h>**
    
           **int setlogmask(int** _mask_**);**
    


## DESCRIPTION



           A process has a log priority mask that determines which calls to
           syslog(3) may be logged.  All other calls will be ignored.
           Logging is enabled for the priorities that have the corresponding
           bit set in _mask_.  The initial mask is such that logging is enabled
           for all priorities.
    
           The **setlogmask**() function sets this logmask for the calling
           process, and returns the previous mask.  If the _mask_ argument is
           **0** , the current logmask is not modified.
    
           The eight priorities are **LOG_EMERG** , **LOG_ALERT** , **LOG_CRIT** , **LOG_ERR** ,
           **LOG_WARNING** , **LOG_NOTICE** , **LOG_INFO** , and **LOG_DEBUG**.  The bit
           corresponding to a priority _p_ is _LOG_MASK(p)_.  Some systems also
           provide a macro _LOG_UPTO(p)_ for the mask of all priorities in the
           above list up to and including _p_.
    


## RETURN VALUE



           This function returns the previous log priority mask.
    


## ERRORS



           None.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# sd_event_now

## NAME



           sd_event_now - Retrieve current event loop iteration timestamp
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **int sd_event_now(sd_event ***_event_**, clockid_t** _clock_**, uint64_t ***_ret_**);**
    


## DESCRIPTION



           **sd_event_now()** returns the time when the most recent event loop
           iteration began. A timestamp is taken right after returning from
           the event sleep, and before dispatching any event sources. The
           _event_ parameter specifies the event loop object to retrieve the
           timestamp from. The _clock_ parameter specifies the clock to
           retrieve the timestamp for, and is one of **CLOCK_REALTIME**(or
           equivalently **CLOCK_REALTIME_ALARM**), **CLOCK_MONOTONIC** , or
           **CLOCK_BOOTTIME**(or equivalently **CLOCK_BOOTTIME_ALARM**), see
           clock_gettime(2) for more information on the various clocks. The
           retrieved timestamp is stored in the _ret_ parameter, in μs since
           the clock's epoch. If this function is invoked before the first
           event loop iteration, the current time is returned, as reported by
           **clock_gettime()**. To distinguish this case from a regular
           invocation the return value will be positive, and zero when the
           returned timestamp refers to an actual event loop iteration.
    


## RETURN VALUE



           If the first event loop iteration has not run yet **sd_event_now()**
           writes current time to _ret_ and returns a positive return value.
           Otherwise, it will write the requested timestamp to _ret_ and return
           0. On failure, the call returns a negative errno-style error code.
    
       **Errors**
           Returned values may indicate the following problems:
    
           **-EINVAL**
               An invalid parameter was passed.
    
           **-EOPNOTSUPP**
               Unsupported clock type.
    
           **-ECHILD**
               The event loop object was created in a different process,
               library or module instance.
    


## 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.
    


* * *
# umad_dump

## NAME



           umad_dump - dump umad buffer to stderr
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **void umad_dump(void** _*umad_**);**
    


## DESCRIPTION



           **umad_dump()** dumps the given _umad_ buffer to stderr.
    


## RETURN VALUE



           **umad_dump()** returns no value.
    


* * *
# libpfm_intel_snbep_unc_r3qpi

## NAME



           libpfm_intel_snbep_unc_r3qpi - support for Intel Sandy Bridge-EP
           R3QPI uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snbep_unc_r3qpi0, snbep_unc_r3qpi0**
           **PMU desc: Intel Sandy Bridge-EP R3QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge R3QPI uncore PMU.
           This PMU model only exists on Sandy Bridge model 45. There are two
           R3QPI PMUs per processor socket.
    


## MODIFIERS



           The following modifiers are supported on Intel Sandy Bridge R3PQI
           uncore PMU:
    
           **i** Invert the meaning of the event. The counter will now count
                  R3QPI 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 from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of R3QPI 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:15].
    


* * *