tripathysagar/man_text huggingface dataset:
# ptsname

## NAME



           ptsname, ptsname_r - get the name of the slave pseudoterminal
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **char *ptsname(int** _fd_**);**
           **int ptsname_r(** size_t size;
                         **int** _fd_**, char** _buf_**[**_size_**], size_t** _size_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **ptsname**():
               Since glibc 2.24:
                   _XOPEN_SOURCE >= 500
               glibc 2.23 and earlier:
                   _XOPEN_SOURCE
    
           **ptsname_r**():
               _GNU_SOURCE
    


## DESCRIPTION



           The **ptsname**() function returns the name of the slave
           pseudoterminal device corresponding to the master referred to by
           the file descriptor _fd_.
    
           The **ptsname_r**() function is the reentrant equivalent of **ptsname**().
           It returns the name of the slave pseudoterminal device as a null-
           terminated string in the buffer pointed to by _buf_.  The _size_
           argument specifies the number of bytes available in _buf_.
    


## RETURN VALUE



           On success, **ptsname**() returns a pointer to a string in static
           storage which will be overwritten by subsequent calls.  This
           pointer must not be freed.  On failure, NULL is returned.
    
           On success, **ptsname_r**() returns 0.  On failure, an error number is
           returned to indicate the error.
    


## ERRORS



           **EINVAL**(**ptsname_r**() only) _buf_ is NULL.  (This error is returned
                  only for glibc 2.25 and earlier.)
    
           **ENOTTY** _fd_ does not refer to a pseudoterminal master device.
    
           **ERANGE**(**ptsname_r**() only) _buf_ is too small.
    


## ATTRIBUTES



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


## VERSIONS



           A version of **ptsname_r**() is documented on Tru64 and HP-UX, but on
           those implementations, -1 is returned on error, with _errno_ set to
           indicate the error.  Avoid using this function in portable
           programs.
    


## STANDARDS



           **ptsname**():
                  POSIX.1-2008.
    
           **ptsname_r**() is a Linux extension, that is proposed for inclusion
           in the next major revision of POSIX.1 (Issue 8).
    


* * *
# probe::nfs.fop.write

## NAME



           probe::nfs.fop.write - NFS client write operation
    


## SYNOPSIS



           nfs.fop.write
    


## VALUES



           _devname_
               block device name
    


## DESCRIPTION



           SystemTap uses the vfs.do_sync_write probe to implement this probe
           and as a result will get operations other than the NFS client
           write operations.
    


* * *
# gnutls_hex_decode

## NAME



           gnutls_hex_decode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_hex_decode(const gnutls_datum_t ***_hex_data_**, void ***
           _result_**, size_t ***_result_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * hex_data
                       contain the encoded data
    
           void * result
                       the place where decoded data will be copied
    
           size_t * result_size
                       holds the size of the result
    


## DESCRIPTION



           This function will decode the given encoded data, using the hex
           encoding used by PSK password files.
    
           Initially  _result_size_ must hold the maximum size available in
            _result_ , and on return it will contain the number of bytes
           written.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the buffer given is not long
           enough, **GNUTLS_E_PARSING_ERROR** on invalid hex data, or 0 on
           success.
    


* * *
# function::cpu_clock_ns

## NAME



           function::cpu_clock_ns - Number of nanoseconds on the given cpu's
           clock
    


## SYNOPSIS



               cpu_clock_ns:long(cpu:long)
    


## ARGUMENTS



           _cpu_
               Which processor's clock to read
    


## DESCRIPTION



           This function returns the number of nanoseconds on the given cpu's
           clock. This is always monotonic comparing on the same cpu, but may
           have some drift between cpus (within about a jiffy).
    


* * *
# function::qsq_utilization

## NAME



           function::qsq_utilization - Fraction of time that any request was
           being serviced
    


## SYNOPSIS



               qsq_utilization:long(qname:string,scale:long)
    


## ARGUMENTS



           _qname_
               queue name
    
           _scale_
               scale variable to take account for interval fraction
    


## DESCRIPTION



           This function returns the average time in microseconds that at
           least one request was being serviced.
    


* * *
# wcpncpy

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



           wcpncpy — copy a fixed-size wide-character string, returning a
           pointer to its end
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to wcsncpy(3p).
    


* * *
# rdma_set_option

## NAME



           rdma_set_option - Set communication options for an rdma_cm_id.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_set_option (struct rdma_cm_id ***_id_**, int** _level_**, int**
           _optname_**, void ***_optval_**, size_t** _optlen_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           level       Protocol level of the option to set.
    
           optname     Name of the option, relative to the level, to set.
    
           optval      Reference to the option data.  The data is dependent
                       on the level and optname.
    
           optlen      The size of the %optval buffer.
    


## DESCRIPTION



           Sets communication options for an rdma_cm_id.  This call is used
           to override the default system settings.
    
           optname can be one of
    
           RDMA_OPTION_ID_TOS
                       Specify the quality of service provided by a
                       connection.  The expected optlen is size of uint8_t.
    
           RDMA_OPTION_ID_REUSEADDR
                       Bound the rdma_cm_id to a reuseable address. This will
                       allow other users to bind to that same address.  The
                       expected optlen is size of int.
    
           RDMA_OPTION_ID_AFONLY
                       Set IPV6_V6ONLY socket.  The expected optlen is size
                       of int.
    
           RDMA_OPTION_IB_PATH
                       Set IB path record data.  The expected optlen is size
                       of struct ibv_path_data[].
    
           RDMA_OPTION_ID_ACK_TIMEOUT
                       Set QP ACK timeout.  The value calculated according to
                       the formula 4.096 * 2^(ack_timeout) usec.
    


## RETURN VALUE



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


## NOTES



           Option details may be found in the relevant header files.
    


* * *
# gnutls_x509_crt_set_crq_extension_by_oid

## NAME



           gnutls_x509_crt_set_crq_extension_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_crq_extension_by_oid(gnutls_x509_crt_t**
           _crt_**, gnutls_x509_crq_t** _crq_**, const char ***_oid_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_crq_t crq
                       holds a certificate request
    
           const char * oid
                       the object identifier of the OID to copy
    
           unsigned flags
                       should be zero
    


## DESCRIPTION



           This function will set the extension specify by  _oid_ from the
           given request to the certificate.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# ctanh

## NAME



           ctanh, ctanhf, ctanhl - complex hyperbolic tangent
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex ctanh(double complex** _z_**);**
           **float complex ctanhf(float complex** _z_**);**
           **long double complex ctanhl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex hyperbolic tangent of _z_.
    
           The complex hyperbolic tangent function is defined mathematically
           as:
    
               ctanh(z) = csinh(z) / ccosh(z)
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_pkcs7_get_crt_raw

## NAME



           gnutls_pkcs7_get_crt_raw - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_crt_raw(gnutls_pkcs7_t** _pkcs7_**, unsigned** _indx_**,**
           **void ***_certificate_**, size_t ***_certificate_size_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a gnutls_pkcs7_t type
    
           unsigned indx
                       contains the index of the certificate to extract
    
           void * certificate
                       the contents of the certificate will be copied there
                       (may be null)
    
           size_t * certificate_size
                       should hold the size of the certificate
    


## DESCRIPTION



           This function will return a certificate of the PKCS7 or RFC2630
           certificate set.
    
           After the last certificate has been read
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value.  If the provided buffer is not long enough, then
           _certificate_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** is
           returned.
    


* * *
# libpfm_intel_bdx_unc_r2pcie

## NAME



           libpfm_intel_bdx_unc_r2pcie - support for Intel Broadwell Server
           R2 PCIe  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_r2pcie**
           **PMU desc: Intel Broadwell Server R2 PCIe uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell server R2 PCIe uncore
           PMU.  This PMU model only exists on Broadwell server models (79,
           86).
    


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server
           R2PCIe uncore PMU:
    
           **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 R2PCIe 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].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# probe::socket.aio_read

## NAME



           probe::socket.aio_read - Receiving message via **sock_aio_read**
    


## SYNOPSIS



           socket.aio_read
    


## VALUES



           _family_
               Protocol family value
    
           _size_
               Message size in bytes
    
           _protocol_
               Protocol value
    
           _name_
               Name of this probe
    
           _type_
               Socket type value
    
           _state_
               Socket state value
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender
    


## DESCRIPTION



           Fires at the beginning of receiving a message on a socket via the
           **sock_aio_read** function
    


* * *
# gnutls_certificate_set_ocsp_status_request_mem

## NAME



           gnutls_certificate_set_ocsp_status_request_mem - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_ocsp_status_request_mem(gnutls_certificate_credentials_t**
           _sc_**, const gnutls_datum_t ***_resp_data_**, unsigned** _idx_**,**
           **gnutls_x509_crt_fmt_t** _fmt_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a credentials structure.
    
           const gnutls_datum_t * resp_data
                       a memory buffer holding an OCSP response
    
           unsigned idx
                       is a certificate index as returned by
                       **gnutls_certificate_set_key()** and friends
    
           gnutls_x509_crt_fmt_t fmt
                       is PEM or DER
    


## DESCRIPTION



           This function sets the OCSP responses to be sent to the peer for
           the certificate chain specified by  _idx_ . When  _fmt_ is set to PEM,
           multiple responses can be loaded.
    


## NOTE



           the ability to set multiple OCSP responses per credential
           structure via the index  _idx_ was added in version 3.5.6. To keep
           backwards compatibility, it requires using
           **gnutls_certificate_set_flags()** with the **GNUTLS_CERTIFICATE_API_V2**
           flag to make the set certificate functions return an index usable
           by this function.
    
           This function must be called after setting any certificates, and
           cannot be used for certificates that are provided via a callback
           -- that is when **gnutls_certificate_set_retrieve_function()** is
           used.
    
           This function can be called multiple times when multiple responses
           which apply to the certificate chain are available.  If the
           response provided does not match any certificates present in the
           chain, the code **GNUTLS_E_OCSP_MISMATCH_WITH_CERTS** is returned.  If
           the response is already expired at the time of loading the code
           **GNUTLS_E_EXPIRED** is returned.
    


## RETURNS



           On success, the number of loaded responses is returned, otherwise
           a negative error code.
    


## SINCE



           3.6.3
    


* * *
# gnutls_ocsp_req_get_extension

## NAME



           gnutls_ocsp_req_get_extension - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_get_extension(gnutls_ocsp_req_const_t** _req_**,**
           **unsigned** _indx_**, gnutls_datum_t ***_oid_**, unsigned int ***_critical_**,**
           **gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_const_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           unsigned indx
                       Specifies which extension OID to get. Use (0) to get
                       the first one.
    
           gnutls_datum_t * oid
                       will hold newly allocated buffer with OID of
                       extension, may be NULL
    
           unsigned int * critical
                       output variable with critical flag, may be NULL.
    
           gnutls_datum_t * data
                       will hold newly allocated buffer with extension data,
                       may be NULL
    


## DESCRIPTION



           This function will return all information about the requested
           extension in the OCSP request.  The information returned is the
           OID, the critical flag, and the data itself.  The extension OID
           will be stored as a string.  Any of  _oid_ ,  _critical_ , and  _data_
           may be NULL which means that the caller is not interested in
           getting that information back.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _oid_ ->data and  _data_ ->data.
    
           Since 3.7.0  _oid_ ->size does not account for the terminating null
           byte.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# gnutls_x509_crq_export2

## NAME



           gnutls_x509_crq_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_export2(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a certificate request PEM or DER encoded
    


## DESCRIPTION



           This function will export the certificate request to a PEM or DER
           encoded PKCS10 structure.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           NEW CERTIFICATE REQUEST".
    


## RETURNS



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


* * *
# pcre2_set_optimize

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_optimize(pcre2_compile_context ***_ccontext_**,**
             **uint32_t** _directive_**);**
    


## DESCRIPTION



    
           This function controls which performance optimizations will be
           applied by **pcre2_compile()**. It can be called multiple times with
           the same compile context; the effects are cumulative, with the
           effects of later calls taking precedence over earlier ones.
    
           The result is zero for success, PCRE2_ERROR_NULL if _ccontext_ is
           NULL, or PCRE2_ERROR_BADOPTION if _directive_ is unknown. The latter
           could be useful to detect if a certain optimization is available.
    
           The list of possible values for the _directive_ parameter are:
    
             PCRE2_OPTIMIZATION_FULL   Enable all optimizations (default)
             PCRE2_OPTIMIZATION_NONE   Disable all optimizations
             PCRE2_AUTO_POSSESS        Enable auto-possessification
             PCRE2_AUTO_POSSESS_OFF    Disable auto-possessification
             PCRE2_DOTSTAR_ANCHOR      Enable implicit dotstar anchoring
             PCRE2_DOTSTAR_ANCHOR_OFF  Disable implicit dotstar anchoring
             PCRE2_START_OPTIMIZE      Enable start-up optimizations at match
           time
             PCRE2_START_OPTIMIZE_OFF  Disable start-up optimizations at
           match time
    
           There is a complete description of the PCRE2 native API, including
           detailed descriptions _directive_ parameter values in the **pcre2api**
           page.
    


* * *
# tapset::tcpmib-filter-default

## NAME



           tapset::tcpmib-filter-default - systemtap tcpmib-filter-default
           tapset
    


## DESCRIPTION



           **tcpmib_filter_key**
                  Default filter function for tcpmib.* probes
    
                  See function::tcpmib_filter_key(3stap)
                   for details.
    


* * *
# fmax

## NAME



           fmax, fmaxf, fmaxl - determine maximum of two floating-point
           numbers
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double fmax(double** _x_**, double** _y_**);**
           **float fmaxf(float** _x_**, float** _y_**);**
           **long double fmaxl(long double** _x_**, long double** _y_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fmax**(), **fmaxf**(), **fmaxl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions return the larger value of _x_ and _y_.
    


## RETURN VALUE



           These functions return the maximum of _x_ and _y_.
    
           If one argument is a NaN, the other argument is returned.
    
           If both arguments are NaN, a NaN is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_certificate_get_verify_flags

## NAME



           gnutls_certificate_get_verify_flags - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned int**
           **gnutls_certificate_get_verify_flags(gnutls_certificate_credentials_t**
           _res_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    


## DESCRIPTION



           Returns the verification flags set with
           **gnutls_certificate_set_verify_flags()**.
    


## RETURNS



           The certificate verification flags used by  _res_ .
    


## SINCE



           3.4.0
    


* * *
# cacos

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



           cacos, cacosf, cacosl — complex arc cosine functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex cacos(double complex _z_);
           float complex cacosf(float complex _z_);
           long double complex cacosl(long double complex _z_);
    


## 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.
    
           These functions shall compute the complex arc cosine of _z_ , with
           branch cuts outside the interval [-1, +1] along the real axis.
    


## RETURN VALUE



           These functions shall return the complex arc cosine value, in the
           range of a strip mathematically unbounded along the imaginary axis
           and in the interval [0, π] along the real axis.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_get_subject_alt_name

## NAME



           gnutls_x509_crq_get_subject_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_subject_alt_name(gnutls_x509_crq_t** _crq_**,**
           **unsigned int** _seq_**, void ***_ret_**, size_t ***_ret_size_**, unsigned int ***
           _ret_type_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name, 0 for
                       the first one, 1 for the second etc.
    
           void * ret  is the place where the alternative name will be copied
                       to
    
           size_t * ret_size
                       holds the size of ret.
    
           unsigned int * ret_type
                       holds the **gnutls_x509_subject_alt_name_t** name type
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the alternative names, contained in the
           given certificate.  It is the same as
           **gnutls_x509_crq_get_subject_alt_name()** except for the fact that it
           will return the type of the alternative name in  _ret_type_ even if
           the function fails for some reason (i.e.  the buffer provided is
           not enough).
    


## RETURNS



           the alternative subject name type on success, one of the
           enumerated **gnutls_x509_subject_alt_name_t**.  It will return
           **GNUTLS_E_SHORT_MEMORY_BUFFER** if  _ret_size_ is not large enough to
           hold the value.  In that case  _ret_size_ will be updated with the
           required size.  If the certificate request does not have an
           Alternative name with the specified sequence number then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           2.8.0
    


* * *
# ibv_create_srq

## NAME



           ibv_create_srq, ibv_destroy_srq - create or destroy a shared
           receive queue (SRQ)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_srq *ibv_create_srq(struct ibv_pd** _*pd_**, struct**
                                          **ibv_srq_init_attr** _*srq_init_attr_**);**
    
           **int ibv_destroy_srq(struct ibv_srq** _*srq_**);**
    


## DESCRIPTION



           **ibv_create_srq()** creates a shared receive queue (SRQ) associated
           with the protection domain _pd_.  The argument _srq_init_attr_ is an
           ibv_srq_init_attr struct, as defined in <infiniband/verbs.h>.
    
           struct ibv_srq_init_attr {
                   void                   *srq_context;    /* Associated context of the SRQ */
                   struct ibv_srq_attr     attr;           /* SRQ attributes */
           };
    
           struct ibv_srq_attr {
                   uint32_t                max_wr;         /* Requested max number of outstanding work requests (WRs) in the SRQ */
                   uint32_t                max_sge;        /* Requested max number of scatter elements per WR */
                   uint32_t                srq_limit;      /* The limit value of the SRQ (irrelevant for ibv_create_srq) */
           };
    
           The function **ibv_create_srq()** will update the _srq_init_attr_ struct
           with the original values of the SRQ that was created; the values
           of max_wr and max_sge will be greater than or equal to the values
           requested.
    
           **ibv_destroy_srq()** destroys the SRQ _srq_.
    


## RETURN VALUE



           **ibv_create_srq()** returns a pointer to the created SRQ, or NULL if
           the request fails.
    
           **ibv_destroy_srq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_destroy_srq()** fails if any queue pair is still associated with
           this SRQ.
    


* * *
# mq_close

## NAME



           mq_close - close a message queue descriptor
    


## LIBRARY



           Real-time library (_librt_ , _-lrt_)
    


## SYNOPSIS



           **#include <mqueue.h>**
    
           **int mq_close(mqd_t** _mqdes_**);**
    


## DESCRIPTION



           **mq_close**() closes the message queue descriptor _mqdes_.
    
           If the calling process has attached a notification request (see
           mq_notify(3)) to this message queue via _mqdes_ , then this request
           is removed, and another process can now attach a notification
           request.
    


## RETURN VALUE



           On success **mq_close**() returns 0; on error, -1 is returned, with
           _errno_ set to indicate the error.
    


## ERRORS



           **EBADF** The message queue descriptor specified in _mqdes_ is invalid.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           All open message queues are automatically closed on process
           termination, or upon execve(2).
    


* * *
# auparse_next_field

## NAME



           auparse_next_field - move field cursor
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_next_field(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_next_field moves the library's internal cursor to point to
           the next field in the current record of the current event.
    


## RETURN VALUE



           Returns 0 if no more fields exist and 1 for success.
    


* * *
# pcap_fileno

## NAME



           pcap_fileno - get the file descriptor for a live capture
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_fileno(pcap_t *p);**
    


## DESCRIPTION



           If _p_ refers to a network device that was opened for a live capture
           using a combination of **pcap_create**(3PCAP) and
           **pcap_activate**(3PCAP), or using **pcap_open_live**(3PCAP),
           **pcap_fileno**() returns the file descriptor from which captured
           packets are read.
    
           If _p_ refers to a ``savefile'' that was opened using functions such
           as **pcap_open_offline**(3PCAP) or **pcap_fopen_offline**(3PCAP), a
           ``dead'' **pcap_t** opened using **pcap_open_dead**(3PCAP), or a **pcap_t**
           that was created with **pcap_create**() but that has not yet been
           activated with **pcap_activate**(), it returns **PCAP_ERROR**.
    


* * *
# acl_extended_fd

## NAME



           **acl_extended_fd** — test for information in the ACL by file
           descriptor
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _int_ **acl_extended_fd**(_int fd_)
    


## DESCRIPTION



           The **acl_extended_fd**() function returns **1** if the file identified by
           the argument _fd_ is associated with an extended access ACL. The
           function returns **0** if the file does not have an extended access
           ACL.
    
           An extended ACL is an ACL that contains entries other than the
           three required entries of tag types ACL_USER_OBJ, ACL_GROUP_OBJ
           and ACL_OTHER.  If the result of the **acl_extended_fd**() function
           for a file object is **0** , then the ACL defines no discretionary
           access rights other than those already defined by the traditional
           file permission bits.
    
           Access to the file object may be further restricted by other
           mechanisms, such as Mandatory Access Control schemes. The
           _access_(2) system call can be used to check whether a given type of
           access to a file object would be granted.
    


## RETURN VALUE



           If successful, the **acl_extended_fd**() function returns **1** if the
           file object identified by _fd_ has an extended access ACL, and **0** if
           the file object identified by _fd_ does not have an extended access
           ACL. Otherwise, the value **-1** is returned and the global variable
           _errno_ is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_extended_fd**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EBADF]            The _fd_ argument is not a valid file descriptor.
    
           [ENOTSUP]          The file system on which the file identified by
                              _fd_ is located does not support ACLs, or ACLs
                              are disabled.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# gnutls_ecc_curve_get_oid

## NAME



           gnutls_ecc_curve_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_ecc_curve_get_oid(gnutls_ecc_curve_t** _curve_**);**
    


## ARGUMENTS



           gnutls_ecc_curve_t curve
                       is an ECC curve
    


## DESCRIPTION



           Convert a **gnutls_ecc_curve_t** value to its object identifier.
    


## RETURNS



           a string that contains the OID of the specified curve or **NULL**.
    


## SINCE



           3.4.3
    


* * *
# function::task_tid

## NAME



           function::task_tid - The thread identifier of the task
    


## SYNOPSIS



               task_tid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the thread id of the given task.
    


* * *
# function::matched

## NAME



           function::matched - Return a given matched subexpression.
    


## SYNOPSIS



               matched:string(n:long)
    


## ARGUMENTS



           _n_
               index to the subexpression to return. 0 corresponds to the
               entire regular expression.
    


## DESCRIPTION



           returns the content of the n'th subexpression of the last
           successful use of the =~ regex matching operator. Returns an empty
           string if the n'th subexpression was not matched (e.g. due to
           alternation). Throws an error if the last use of =~ was a failed
           match, or if fewer than n subexpressions are present in the
           original regexp.
    


* * *
# function::kernel_buffer_quoted

## NAME



           function::kernel_buffer_quoted - Retrieves and quotes buffer from
           kernel space
    


## SYNOPSIS



           1) kernel_buffer_quoted:string(addr:long,inlen:long)
    
           2) kernel_buffer_quoted:string(addr:long,inlen:long,outlen:long)
    


## ARGUMENTS



           _addr_
               the kernel space address to retrieve the buffer from
    
           _inlen_
               the exact length of the buffer to read
    
           _outlen_
               the maximum length of the output string
    


## DESCRIPTION



           1) Reads inlen characters of a buffer from the given kernel space
           memory address, and returns up to MAXSTRINGLEN characters, 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 kernel space data is not accessible at the given address, the
           address itself is returned as a string, without double quotes.
    
           2) Reads inlen characters of a buffer from the given kernel space
           memory address, and returns up to outlen characters, 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 kernel space data is not accessible at the given address, the
           address itself is returned as a string, without double quotes.
    


* * *
# probe::tcpmib.AttemptFails

## NAME



           probe::tcpmib.AttemptFails - Count a failed attempt to open a
           socket
    


## SYNOPSIS



           tcpmib.AttemptFails
    


## VALUES



           _op_
               value to be added to the counter (default value of 1)
    
           _sk_
               pointer to the struct sock being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **tcpmib_filter_key**. If the packet passes the filter is is counted
           in the global _AttemptFails_ (equivalent to SNMP's MIB
           TCP_MIB_ATTEMPTFAILS)
    


* * *
# gnutls_pkcs11_type_get_name

## NAME



           gnutls_pkcs11_type_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **const char * gnutls_pkcs11_type_get_name(gnutls_pkcs11_obj_type_t**
           _type_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_type_t type
                       Holds the PKCS 11 object type, a
                       **gnutls_pkcs11_obj_type_t**.
    


## DESCRIPTION



           This function will return a human readable description of the
           PKCS11 object type  _obj_ .  It will return "Unknown" for unknown
           types.
    


## RETURNS



           human readable string labeling the PKCS11 object type
            _type_ .
    


## SINCE



           2.12.0
    


* * *
# probe::scheduler.wakeup_new

## NAME



           probe::scheduler.wakeup_new - Newly created task is woken up for
           the first time
    


## SYNOPSIS



           scheduler.wakeup_new
    


## VALUES



           _task_cpu_
               cpu of the task woken up
    
           _task_tid_
               TID of the new task woken up
    
           _task_state_
               state of the task woken up
    
           _task_priority_
               priority of the new task
    
           _name_
               name of the probe point
    
           _task_pid_
               PID of the new task woken up
    


* * *
# ibv_create_ah

## NAME



           ibv_create_ah, ibv_destroy_ah - create or destroy an address
           handle (AH)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_ah *ibv_create_ah(struct ibv_pd** _*pd_**,**
                                        **struct ibv_ah_attr** _*attr_**);**
    
           **int ibv_destroy_ah(struct ibv_ah** _*ah_**);**
    


## DESCRIPTION



           **ibv_create_ah()** creates an address handle (AH) associated with the
           protection domain _pd_.  The argument _attr_ is an ibv_ah_attr struct,
           as defined in <infiniband/verbs.h>.
    
           struct ibv_ah_attr {
                   struct ibv_global_route grh;            /* Global Routing Header (GRH) attributes */
                   uint16_t                dlid;           /* Destination LID */
                   uint8_t                 sl;             /* Service Level */
                   uint8_t                 src_path_bits;  /* Source path bits */
                   uint8_t                 static_rate;    /* Maximum static rate */
                   uint8_t                 is_global;      /* GRH attributes are valid */
                   uint8_t                 port_num;       /* Physical port number */
           };
    
           struct ibv_global_route {
                   union ibv_gid           dgid;           /* Destination GID or MGID */
                   uint32_t                flow_label;     /* Flow label */
                   uint8_t                 sgid_index;     /* Source GID index */
                   uint8_t                 hop_limit;      /* Hop limit */
                   uint8_t                 traffic_class;  /* Traffic class */
           };
    
           **ibv_destroy_ah()** destroys the AH _ah_.
    


## RETURN VALUE



           **ibv_create_ah()** returns a pointer to the created AH, or NULL if
           the request fails.
    


## NOTES



           If port flag IBV_QPF_GRH_REQUIRED is set then **ibv_create_ah()** must
           be created with definition of 'struct ibv_ah_attr { .is_global =
           1; .grh = {...}; }'.
    
           **ibv_destroy_ah()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


* * *
# openat

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



           openat — open file relative to directory file descriptor
    


## SYNOPSIS



           #include <fcntl.h>
    
           int openat(int _fd_ , const char *_path_ , int _oflag_ , ...);
    


## DESCRIPTION



           Refer to open(3p).
    


* * *
# gnutls_x509_crt_get_pk_rsa_raw

## NAME



           gnutls_x509_crt_get_pk_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_rsa_raw(gnutls_x509_crt_t** _crt_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus
    
           gnutls_datum_t * e
                       will hold the public exponent
    


## DESCRIPTION



           This function will export the RSA public key's parameters found in
           the given structure.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


* * *
# gnutls_packet_get

## NAME



           gnutls_packet_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_packet_get(gnutls_packet_t** _packet_**, gnutls_datum_t ***
           _data_**, unsigned char ***_sequence_**);**
    


## ARGUMENTS



           gnutls_packet_t packet
                       is a **gnutls_packet_t** type.
    
           gnutls_datum_t * data
                       will contain the data present in the  _packet_ structure
                       (may be **NULL**)
    
           unsigned char * sequence
                       the 8-bytes of the packet sequence number (may be
                       **NULL**)
    


## DESCRIPTION



           This function returns the data and sequence number associated with
           the received packet.
    


## SINCE



           3.3.5
    


* * *
# function::ucallers

## NAME



           function::ucallers - Return first n elements of user stack
           backtrace
    


## SYNOPSIS



               ucallers:string(n:long)
    


## ARGUMENTS



           _n_
               number of levels to descend in the stack (not counting the top
               level). If n is -1, print the entire stack.
    


## DESCRIPTION



           This function returns a string of the first n hex addresses from
           the backtrace of the user stack. Output may be truncated as per
           maximum string length (MAXSTRINGLEN).
    


## NOTE



           To get (full) backtraces for user space applications and shared
           shared libraries not mentioned in the current script run stap with
           -d /path/to/exe-or-so and/or add --ldd to load all needed unwind
           data.
    


* * *
# gnutls_ocsp_resp_get_certs

## NAME



           gnutls_ocsp_resp_get_certs - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_certs(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_x509_crt_t ****_certs_**, size_t ***_ncerts_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           gnutls_x509_crt_t ** certs
                       newly allocated array with **gnutls_x509_crt_t**
                       certificates
    
           size_t * ncerts
                       output variable with number of allocated certs.
    


## DESCRIPTION



           This function will extract the X.509 certificates found in the
           Basic OCSP Response.  The  _certs_ output variable will hold a newly
           allocated zero-terminated array with X.509 certificates.
    
           Every certificate in the array needs to be de-allocated with
           **gnutls_x509_crt_deinit()** and the array itself must be freed using
           **gnutls_free()**.
    
           Both the  _certs_ and  _ncerts_ variables may be NULL.  Then the
           function will work as normal but will not return the NULL:d
           information.  This can be used to get the number of certificates
           only, or to just get the certificate array without its size.
    


## RETURNS



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


* * *