tripathysagar/man_text huggingface dataset:
# assert

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



           assert — insert program diagnostics
    


## SYNOPSIS



           #include <assert.h>
    
           void assert(scalar _expression_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _assert_() macro shall insert diagnostics into programs; it
           shall expand to a **void** expression. When it is executed, if
           _expression_ (which shall have a **scalar** type) is false (that is,
           compares equal to 0), _assert_() shall write information about the
           particular call that failed on _stderr_ and shall call _abort_().
    
           The information written about the call that failed shall include
           the text of the argument, the name of the source file, the source
           file line number, and the name of the enclosing function; the
           latter are, respectively, the values of the preprocessing macros
           __FILE__ and __LINE__ and of the identifier __func__.
    
           Forcing a definition of the name NDEBUG, either from the compiler
           command line or with the preprocessor control statement **#define**
           NDEBUG ahead of the **#include** _< assert.h>_ statement, shall stop
           assertions from being compiled into the program.
    


## RETURN VALUE



           The _assert_() macro shall not return a value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pthread_rwlockattr_destroy

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



           pthread_rwlockattr_destroy, pthread_rwlockattr_init — destroy and
           initialize the read-write lock attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_rwlockattr_destroy(pthread_rwlockattr_t *_attr_);
           int pthread_rwlockattr_init(pthread_rwlockattr_t *_attr_);
    


## DESCRIPTION



           The _pthread_rwlockattr_destroy_() function shall destroy a read-
           write lock attributes object. A destroyed _attr_ attributes object
           can be reinitialized using _pthread_rwlockattr_init_(); the results
           of otherwise referencing the object after it has been destroyed
           are undefined. An implementation may cause
           _pthread_rwlockattr_destroy_() to set the object referenced by _attr_
           to an invalid value.
    
           The _pthread_rwlockattr_init_() function shall initialize a read-
           write lock attributes object _attr_ with the default value for all
           of the attributes defined by the implementation.
    
           Results are undefined if _pthread_rwlockattr_init_() is called
           specifying an already initialized _attr_ attributes object.
    
           After a read-write lock attributes object has been used to
           initialize one or more read-write locks, any function affecting
           the attributes object (including destruction) shall not affect any
           previously initialized read-write locks.
    
           The behavior is undefined if the value specified by the _attr_
           argument to _pthread_rwlockattr_destroy_() does not refer to an
           initialized read-write lock attributes object.
    


## RETURN VALUE



           If successful, the _pthread_rwlockattr_destroy_() and
           _pthread_rwlockattr_init_() functions shall return zero; otherwise,
           an error number shall be returned to indicate the error.
    


## ERRORS



           The _pthread_rwlockattr_init_() function shall fail if:
    
           **ENOMEM** Insufficient memory exists to initialize the read-write
                  lock attributes object.
    
           These functions shall not return an error code of **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           If an implementation detects that the value specified by the _attr_
           argument to _pthread_rwlockattr_destroy_() does not refer to an
           initialized read-write lock attributes object, it is recommended
           that the function should fail and report an **[EINVAL]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# keyctl_session_to_parent

## NAME



           keyctl_session_to_parent - set the parent process's session
           keyring
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_session_to_parent();**
    


## DESCRIPTION



           **keyctl_session_to_parent**() changes the session keyring to which
           the calling process's parent subscribes to be the that of the
           calling process.
    
           The keyring must have **link** permission available to the calling
           process, the parent process must have the same UIDs/GIDs as the
           calling process, and the LSM must not reject the replacement.
           Furthermore, this may not be used to affect init or a kernel
           thread.
    
           Note that the replacement will not take immediate effect upon the
           parent process, but will rather be deferred to the next time it
           returns to userspace from kernel space.
    


## RETURN VALUE



           On success **keyctl_session_to_parent**() returns 0.  On error, the
           value **-1** will be returned and _errno_ will have been set to an
           appropriate error.
    


## ERRORS



           **ENOMEM** Insufficient memory to create a key.
    
           **EPERM** The credentials of the parent don't match those of the
                  caller.
    
           **EACCES** The named keyring exists, but is not **linkable** by the
                  calling process.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# gnutls_session_get_verify_cert_status

## NAME



           gnutls_session_get_verify_cert_status - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned int**
           **gnutls_session_get_verify_cert_status(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function returns the status of the verification when
           initiated via auto-verification, i.e., by
           **gnutls_session_set_verify_cert2()** or
           **gnutls_session_set_verify_cert()**. If no certificate verification
           was occurred then the return value would be set to ((unsigned
           int)-1).
    
           The certificate verification status is the same as in
           **gnutls_certificate_verify_peers()**.
    


## RETURNS



           the certificate verification status.
    


## SINCE



           3.4.6
    


* * *
# gnutls_hkdf_extract

## NAME



           gnutls_hkdf_extract - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hkdf_extract(gnutls_mac_algorithm_t** _mac_**, const**
           **gnutls_datum_t ***_key_**, const gnutls_datum_t ***_salt_**, void ***_output_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t mac
                       the mac algorithm used internally
    
           const gnutls_datum_t * key
                       the initial keying material
    
           const gnutls_datum_t * salt
                       the optional salt
    
           void * output
                       the output value of the extract operation
    


## DESCRIPTION



           This function will derive a fixed-size key using the HKDF-Extract
           function as defined in RFC 5869.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.13
    


* * *
# probe::nfs.proc.remove

## NAME



           probe::nfs.proc.remove - NFS client removes a file on server
    


## SYNOPSIS



           nfs.proc.remove
    


## VALUES



           _prot_
               transfer protocol
    
           _version_
               NFS version (the function is used for all NFS version)
    
           _filelen_
               length of file name
    
           _fh_
               file handle of parent dir
    
           _server_ip_
               IP address of server
    
           _filename_
               file name
    


* * *
# rdma_create_srq

## NAME



           rdma_create_srq - Allocate a shared receive queue.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_create_srq (struct rdma_cm_id ***_id_**, struct ibv_pd ***_pd_**,**
           **struct ibv_srq_init_attr ***_attr_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           pd          Optional protection domain for the SRQ.
    
           attr        Initial SRQ attributes.
    


## DESCRIPTION



           Allocate a SRQ associated with the specified rdma_cm_id.
    


## RETURN VALUE



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


## NOTES



           The rdma_cm_id must be bound to a local RDMA device before calling
           this function, and the protection domain, if provided, must be for
           that same device.  After being allocated, the SRQ will be ready to
           handle posting of receives.
    
           If a protection domain is not given - pd parameter is NULL - then
           the rdma_cm_id will be created using a default protection domain.
           One default protection domain is allocated per RDMA device.
    
           The initial SRQ attributes are specified by the attr parameter.
           The ext.xrc.cq fields in the ibv_srq_init_attr is optional.  If a
           completion queue is not specified for an XRC SRQ, then a CQ will
           be allocated by the rdma_cm for the SRQ, along with corresponding
           completion channels.  Completion channels and CQ data created by
           the rdma_cm are exposed to the user through the rdma_cm_id
           structure.
    
           The actual capabilities and properties of the created SRQ will be
           returned to the user through the attr parameter.  An rdma_cm_id
           may only be associated with a single SRQ.
    


* * *
# pcre2_maketables

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **const uint8_t *pcre2_maketables(pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function builds a set of character tables for character code
           points that are less than 256. These can be passed to
           **pcre2_compile()** in a compile context in order to override the
           internal, built-in tables (which were either defaulted or made by
           **pcre2_maketables()** when PCRE2 was compiled). See the
           **pcre2_set_character_tables()** page. You might want to do this if
           you are using a non-standard locale.
    
           If the argument is NULL, **malloc()** is used to get memory for the
           tables.  Otherwise it must point to a general context, which can
           supply pointers to a custom memory manager. The function yields a
           pointer to the tables.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# j0

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



           j0, j1, jn — Bessel functions of the first kind
    


## SYNOPSIS



           #include <math.h>
    
           double j0(double _x_);
           double j1(double _x_);
           double jn(int _n_ , double _x_);
    


## DESCRIPTION



           The _j0_(), _j1_(), and _jn_() functions shall compute Bessel functions
           of _x_ of the first kind of orders 0, 1, and _n_ , respectively.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           relevant Bessel value of _x_ of the first kind.
    
           If the _x_ argument is too large in magnitude, or the correct result
           would cause underflow, 0 shall be returned and a range error may
           occur.
    
           If _x_ is NaN, a NaN shall be returned.
    


## ERRORS



           These functions may fail if:
    
           Range Error The value of _x_ was too large in magnitude, or an
                       underflow occurred.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[ERANGE]**.  If the integer expression (_math_errhandling_
                       & MATH_ERREXCEPT) is non-zero, then the underflow
                       floating-point exception shall be raised.
    
           No other errors shall occur.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::guru-signal

## NAME



           tapset::guru-signal - systemtap guru-signal tapset
    


## DESCRIPTION



            Functions in the guru-signal tapset allow a probe handler to
           queue
            a user-space signals.  Such operations may only be safe from some
            kinds of probe points, therefore are guru-mode only.
    
           **raise** raise a signal in the current thread
    
                  See function::raise(3stap)
                   for details.
    


* * *
# scandir

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



           scandir — scan a directory
    


## SYNOPSIS



           #include <dirent.h>
    
           int scandir(const char *_dir_ , struct dirent ***_namelist_ ,
               int (*_sel_)(const struct dirent *),
               int (*_compar_)(const struct dirent **, const struct dirent **));
    


## DESCRIPTION



           Refer to alphasort(3p).
    


* * *
# libpfm_amd64_fam19h_zen4

## NAME



           libpfm_amd64_fam19h_zen4 - support for AMD64 Family 19h processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam19h_zen4**
           **PMU desc: AMD64 Fam19h Zen4**
    


## DESCRIPTION



           The library supports AMD Family 19h processors Zen4 core PMU in
           both 32 and 64-bit modes.
    


## MODIFIERS



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


* * *
# probe::ioblock_trace.end

## NAME



           probe::ioblock_trace.end - Fires whenever a block I/O transfer is
           complete.
    


## SYNOPSIS



           ioblock_trace.end
    


## VALUES



           _p_start_sect_
               points to the start sector of the partition structure of the
               device
    
           _q_
               request queue on which this bio was queued.
    
           _size_
               total size in bytes
    
           _devname_
               block device name
    
           _bytes_done_
               number of bytes transferred
    
           _bdev_
               target block device
    
           _ino_
               i-node number of the mapped file
    
           _sector_
               beginning sector for the entire bio
    
           _bdev_contains_
               points to the device object which contains the partition (when
               bio structure represents a partition)
    
           _flags_
               see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK
               1 RW_AHEAD set, and read/write would block BIO_EOF 2
               out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid
               BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce
               bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not
               supported
    
           _name_
               name of the probe point
    
           _opf_
               operations and flags
    
           _vcnt_
               bio vector count which represents number of array element
               (page, offset, length) which makes up this I/O request
    
           _rw_
               binary trace for read/write request
    
           _idx_
               offset into the bio vector array _phys_segments_ - number of
               segments in this bio after physical address coalescing is
               performed.
    


## CONTEXT



           The process signals the transfer is done.
    


* * *
# auparse_new_buffer

## NAME



           auparse_new_buffer - replace the buffer in the parser
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_new_buffer(auparse_state_t ***_au,_**const** _char_***"**_data,_**size_t"**_data_len);"_
    
           _au_     The audit parse state
    
           _data_   A buffer of data to give to the parser, it is _data_len_
                  bytes long. The data is copied into the parser without
                  modifying the original. Upon return the caller may free or
                  reuse the data buffer.
    
           _data_len_
                  The number of bytes in _data_
    


## DESCRIPTION



           _auparse_new_buffer_ replaces the data that the parser works on.
           _auparse_init()_ must have been called with a source type of
           AUSOURCE_BUFFER.
    


## RETURN VALUE



           Returns 1 if an error occurs; otherwise, 0 for success.
    


* * *
# sctp_peeloff

## NAME



           sctp_peeloff - Branch off an association into a separate socket.
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <netinet/sctp.h>**
    
           **int sctp_peeloff(int** _sd_**, sctp_assoc_t** _assoc_id_**);**
           **int sctp_peeloff_flags(int** _sd_**, sctp_assoc_t** _assoc_id_**, unsigned** _flags_**);**
    


## DESCRIPTION



           **sctp_peeloff** branches off an existing association _assoc_id_ on a
           one-to-many style socket _sd_ into a separate socket. The new socket
           is a one-to-one style socket.
    
           This is particularly desirable when, for instance, the application
           wishes to have a number of sporadic message senders/receivers
           remain under the original one-to-many style socket, but branch off
           those assocations carrying high volume data traffic into their own
           separate socket descriptors.
    
           **sctp_peeloff_flags** is a variant of sctp_peeloff, in which flags
           describing the behavior of the newly peeled off socket can be
           specified.  Currently the supported flags are:
    
           **SOCK_NONBLOCK**
                  Specifies that the new socket should not block on io
                  operations.
    
           **SOCK_CLOEXEC**
                  Specifies that the new socket should be closed when the
                  owning process calls exec.
    


## RETURN VALUE



           On success, the new socket descriptor representing the branched-
           off asociation is returned.  On error, -1 is returned, and _errno_
           is set appropriately.
    


## ERRORS



           **EBADF** _sd_ is not a valid descriptor.
    
           **EINVAL** The assoc id passed is invalid or if the socket is a one-
                  to-one style socket.
    
           **ENOTSOCK**
                  Argument is a descriptor for a file, not a socket.
    


## NOTES



           sctp_peeloff_flags is a linux specific variant of sctp_peeloff.
           While it will compile on other systems, its use will result in an
           error return.  Portable code should use sctp_peeloff.
    


* * *
# gnutls_error_is_fatal

## NAME



           gnutls_error_is_fatal - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_error_is_fatal(int** _error_**);**
    


## ARGUMENTS



           int error   is a GnuTLS error code, a negative error code
    


## DESCRIPTION



           If a GnuTLS function returns a negative error code you may feed
           that value to this function to see if the error condition is fatal
           to a TLS session (i.e., must be terminated).
    
           Note that you may also want to check the error code manually,
           since some non-fatal errors to the protocol (such as a warning
           alert or a rehandshake request) may be fatal for your program.
    
           This function is only useful if you are dealing with errors from
           functions that relate to a TLS session (e.g., record layer or
           handshake layer handling functions).
    


## RETURNS



           Non-zero value on fatal errors or zero on non-fatal.
    


* * *
# gnutls_anti_replay_init

## NAME



           gnutls_anti_replay_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_anti_replay_init(gnutls_anti_replay_t ***_anti_replay_**);**
    


## ARGUMENTS



           gnutls_anti_replay_t * anti_replay
                       is a pointer to **gnutls_anti_replay_t** type
    


## DESCRIPTION



           This function will allocate and initialize the  _anti_replay_
           context to be usable for detect replay attacks. The context can
           then be attached to a  _gnutls_session_t_ with
           **gnutls_anti_replay_enable()**.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.5
    


* * *
# umad_set_pkey

## NAME



           umad_set_pkey - set pkey index within umad buffer
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_set_pkey(void** _*umad_**, int** _pkey_index_**);**
    


## DESCRIPTION



           **umad_set_pkey()** sets the pkey index within the specified _umad_
           buffer.
    


## RETURN VALUE



           **umad_set_pkey()** returns 0 on success, and a negative value on an
           error.
    


* * *
# gnutls_pubkey_import_tpm_raw

## NAME



           gnutls_pubkey_import_tpm_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_tpm_raw(gnutls_pubkey_t** _pkey_**, const**
           **gnutls_datum_t ***_fdata_**, gnutls_tpmkey_fmt_t** _format_**, const char ***
           _srk_password_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pkey
                       The public key
    
           const gnutls_datum_t * fdata
                       The TPM key to be imported
    
           gnutls_tpmkey_fmt_t format
                       The format of the private key
    
           const char * srk_password
                       The password for the SRK key (optional)
    
           unsigned int flags
                       One of the GNUTLS_PUBKEY_* flags
    


## DESCRIPTION



           This function will import the public key from the provided TPM key
           structure.
    
           With respect to passwords the same as in
           **gnutls_pubkey_import_tpm_url()** apply.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# probe::nfs.fop.release

## NAME



           probe::nfs.fop.release - NFS client release page operation
    


## SYNOPSIS



           nfs.fop.release
    


## VALUES



           _dev_
               device identifier
    
           _ino_
               inode number
    
           _mode_
               file mode
    


* * *
# pcre2_serialize_get_number_of_codes

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int32_t pcre2_serialize_get_number_of_codes(const uint8_t ***_bytes_**);**
    


## DESCRIPTION



    
           The _bytes_ argument must point to a serialized byte stream that was
           originally created by **pcre2_serialize_encode()**(though it may have
           been saved on disc or elsewhere in the meantime). The function
           returns the number of serialized patterns in the byte stream, or
           one of the following negative error codes:
    
             PCRE2_ERROR_BADMAGIC  mismatch of id bytes in _bytes_
             PCRE2_ERROR_BADMODE   mismatch of variable unit size or PCRE
           version
             PCRE2_ERROR_NULL      the argument is NULL
    
           PCRE2_ERROR_BADMAGIC may mean that the data is corrupt, or that it
           was compiled on a system with different endianness.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the serialization functions in
           the **pcre2serialize** page.
    


* * *
# libpfm_intel_hswep_unc_r3qpi

## NAME



           libpfm_intel_hswep_unc_r3qpi - support for Intel Haswell-EP R3QPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_r3qpi[0-2]**
           **PMU desc: Intel Haswell-EP R3QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell R3QPI uncore PMU.  This PMU
           model only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell R3PQI
           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 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].
    
           **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
    


* * *
# bindresvport

## NAME



           bindresvport - bind a socket to a privileged IP port
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <netinet/in.h>**
    
           **int bindresvport(int** _sockfd_**, struct sockaddr_in ***_sin_**);**
    


## DESCRIPTION



           **bindresvport**() is used to bind the socket referred to by the file
           descriptor _sockfd_ to a privileged anonymous IP port, that is, a
           port number arbitrarily selected from the range 512 to 1023.
    
           If the bind(2) performed by **bindresvport**() is successful, and _sin_
           is not NULL, then _sin- >sin_port_ returns the port number actually
           allocated.
    
           _sin_ can be NULL, in which case _sin- >sin_family_ is implicitly taken
           to be **AF_INET**.  However, in this case, **bindresvport**() has no way
           to return the port number actually allocated.  (This information
           can later be obtained using getsockname(2).)
    


## RETURN VALUE



           **bindresvport**() returns 0 on success; otherwise -1 is returned and
           _errno_ is set to indicate the error.
    


## ERRORS



           **bindresvport**() can fail for any of the same reasons as bind(2).
           In addition, the following errors may occur:
    
           **EACCES** The calling process was not privileged (on Linux: the
                  calling process did not have the **CAP_NET_BIND_SERVICE**
                  capability in the user namespace governing its network
                  namespace).
    
           **EADDRINUSE**
                  All privileged ports are in use.
    
           **EAFNOSUPPORT**(**EPFNOSUPPORT** in glibc 2.7 and earlier)
                  _sin_ is not NULL and _sin- >sin_family_ is not **AF_INET**.
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌────────────────┬───────────────┬───────────────────────────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├────────────────┼───────────────┼───────────────────────────────┤
           │ **bindresvport**() │ Thread safety │ glibc >= 2.17: MT-Safe;       │
           │                │               │ glibc < 2.17: MT-Unsafe       │
           └────────────────┴───────────────┴───────────────────────────────┘
    
           The **bindresvport**() function uses a static variable that was not
           protected by a lock before glibc 2.17, rendering the function MT-
           Unsafe.
    


## VERSIONS



           Present on the BSDs, Solaris, and many other systems.
    


## NOTES



           Unlike some **bindresvport**() implementations, the glibc
           implementation ignores any value that the caller supplies in
           _sin- >sin_port_.
    


## STANDARDS



           BSD.
    


* * *
# function::sid

## NAME



           function::sid - Returns the session ID of the current process
    


## SYNOPSIS



               sid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           The session ID of a process is the process group ID of the session
           leader. Session ID is stored in the signal_struct since Kernel
           2.6.0.
    


* * *
# gnutls_tpm_key_list_get_url

## NAME



           gnutls_tpm_key_list_get_url - API function
    


## SYNOPSIS



           **#include <gnutls/tpm.h>**
    
           **int gnutls_tpm_key_list_get_url(gnutls_tpm_key_list_t** _list_**,**
           **unsigned int** _idx_**, char ****_url_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_tpm_key_list_t list
                       a list of the keys
    
           unsigned int idx
                       The index of the key (starting from zero)
    
           char ** url The URL to be returned
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will return for each given index a URL of the
           corresponding key.  If the provided index is out of bounds then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# io_uring_sqring_wait

## NAME



           io_uring_sqring_wait - wait for free space in the SQ ring
    


## SYNOPSIS



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


## DESCRIPTION



           The function io_uring_sqring_wait(3) allows the caller to wait for
           space to free up in the SQ ring belonging to the _ring_ param, which
           happens when the kernel side thread has consumed one or more
           entries. If the SQ ring is currently non-full, no action is taken.
    
           This feature can only be used when the ring has been setup with
           **IORING_SETUP_SQPOLL** and hence is using an offloaded approach to
           request submissions.
    


## RETURN VALUE



           On success it returns the free space. If the kernel does not
           support the feature, -EINVAL is returned.
    


* * *
# probe::netdev.open

## NAME



           probe::netdev.open - Called when the device is opened
    


## SYNOPSIS



           netdev.open
    


## VALUES



           _dev_name_
               The device that is going to be opened
    


* * *
# function::speculation

## NAME



           function::speculation - Allocate a new id for speculative output
    


## SYNOPSIS



               speculation:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           The **speculation** function is called when a new speculation buffer
           is needed. It returns an id for the speculative output. There can
           be multiple threads being speculated on concurrently. This id is
           used by other speculation functions to keep the threads separate.
    


* * *
# ibv_query_gid_ex

## NAME



           ibv_query_gid_ex - Query an InfiniBand port’s GID table entry
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_query_gid_ex(struct ibv_context *context,
                                       uint32_t port_num,
                                       uint32_t gid_index,
                                       struct ibv_gid_entry *entry,
                                       uint32_t flags);
    


## DESCRIPTION



           **ibv_query_gid_ex()** returns the GID entry at _entry_ for _gid_index_ of
           port _port_num_ for device context _context_.
    


## ARGUMENTS



           _context_
                  The context of the device to query.
    
           _port_num_
                  The number of port to query its GID table.
    
           _gid_index_
                  The index of the GID table entry to query.
    
           ## _entry_ Argument
                  An ibv_gid_entry struct, as defined in
                  <infiniband/verbs.h>.
    
                         struct ibv_gid_entry {
                             union ibv_gid gid;
                             uint32_t gid_index;
                             uint32_t port_num;
                             uint32_t gid_type;
                             uint32_t ndev_ifindex;
                         };
    
                  _gid_
    
                      The GID entry.
    
                  _gid_index_
    
                      The GID table index of this entry.
    
                  _port_num_
    
                      The port number that this GID belongs to.
    
                  _gid_type_
    
                      enum ibv_gid_type, can be one of IBV_GID_TYPE_IB, IBV_GID_TYPE_ROCE_V1 or IBV_GID_TYPE_ROCE_V2.
    
                  _ndev_ifindex_
    
                      The interface index of the net device associated with this GID.
                      It is 0 if there is no net device associated with it.
    
           _flags_  Extra fields to query post _ndev_ifindex_ , for now must be 0.
    


## RETURN VALUE



           **ibv_query_gid_ex()** returns 0 on success or errno value on error.
    


## ERRORS



           ENODATA
                  _gid_index_ is within the GID table size of port _port_num_ but
                  there is no data in this index.
    


* * *
# function::cve_count_metric

## NAME



           function::cve_count_metric - Increment the count of key
    


## SYNOPSIS



               cve_count_metric(key:string)
    


## ARGUMENTS



           _key_
               The metric
    


## DESCRIPTION



           This function increments the count of the metric key by 1. The
           metrics can be accessed in
           /proc/systemtap/MODULE_NAME/__prometheus
    


* * *
# gnutls_ext_get_data

## NAME



           gnutls_ext_get_data - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ext_get_data(gnutls_session_t** _session_**, unsigned** _tls_id_**,**
           **gnutls_ext_priv_data_t ***_data_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       a **gnutls_session_t** opaque pointer
    
           unsigned tls_id
                       the numeric id of the extension
    
           gnutls_ext_priv_data_t * data
                       a pointer to the private data to retrieve
    


## DESCRIPTION



           This function retrieves any data previously stored with
           **gnutls_ext_set_data()**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# io_uring_prep_msg_ring_fd

## NAME



           io_uring_prep_msg_ring_fd - send a direct descriptor to another
           ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_msg_ring_fd(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **int** _source_fd_**,**
                                   **int** _target_fd_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**);**
    
           **void io_uring_prep_msg_ring_fd_alloc(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **int** _source_fd_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**);**
    


## DESCRIPTION



           io_uring_prep_msg_ring_fd(3) prepares an SQE to send a direct file
           descriptor to another ring. The submission queue entry _sqe_ is
           setup to use the file descriptor _fd_ , which must identify a target
           io_uring context, to send the locally registered file descriptor
           with value _source_fd_ to the destination ring into index _target_fd_
           and passing _data_ as the user data in the target CQE with the
           request modifier flags set by _flags_.  Currently there are no valid
           flag modifiers, this field must contain **0**.
    
           io_uring_prep_msg_ring_fd_alloc(3) is similar to
           io_uring_prep_msg_ring_fd(3), but doesn't specify a target index
           for the direct descriptor. Instead, this index is allocated in the
           target ring and returned in the CQE _res_ field.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the request.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-EINVAL**
                  Target ring is identical to the source ring.
    
           **-EBADFD**
                  The descriptor passed in _fd_ does not refer to an io_uring
                  file descriptor, or the ring is in a disabled state.
    
           **-EOVERFLOW**
                  The kernel was unable to fill a CQE on the target ring.
                  This can happen if the target CQ ring is in an overflow
                  state and the kernel wasn't able to allocate memory for a
                  new CQE entry.
    
           **-ENFILE**
                  The direct descriptor table in the target ring was full, no
                  new descriptors could be successfully allocated.
    


* * *
# gnutls_fips140_run_self_tests

## NAME



           gnutls_fips140_run_self_tests - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_fips140_run_self_tests(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Manually perform the second round of the FIPS140 self-tests,
           including:
    
           - Known answer tests (KAT) for the selected set of symmetric
           cipher, MAC, public key, KDF, and DRBG - Library integrity checks
    
           Upon failure with FIPS140 mode enabled, it makes the library
           unusable.  This function is not thread-safe.
    


## RETURNS



           0 upon success, a negative error code otherwise
    


## SINCE



           3.7.7
    


* * *
# pam_open_session

## NAME



           pam_open_session - start PAM session management
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **int pam_open_session(pam_handle_t ***_pamh_**, int** _flags_**);**
    


## DESCRIPTION



           The **pam_open_session** function sets up a user session for a
           previously successful authenticated user. The session should later
           be terminated with a call to pam_close_session(3).
    
           It should be noted that the effective uid, geteuid(2). of the
           application should be of sufficient privilege to perform such
           tasks as creating or mounting the user's home directory for
           example.
    
           The flags argument is the binary or of zero or more of the
           following values:
    
           PAM_SILENT
               Do not emit any messages.
    


## RETURN VALUES



           PAM_ABORT
               General failure.
    
           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_SESSION_ERR
               Session failure.
    
           PAM_SUCCESS
               Session was successful created.
    


* * *
# gnutls_privkey_export_rsa_raw

## NAME



           gnutls_privkey_export_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_rsa_raw(gnutls_privkey_t** _key_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**, gnutls_datum_t ***_d_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_u_**,**
           **gnutls_datum_t ***_e1_**, gnutls_datum_t ***_e2_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus
    
           gnutls_datum_t * e
                       will hold the public exponent
    
           gnutls_datum_t * d
                       will hold the private exponent
    
           gnutls_datum_t * p
                       will hold the first prime (p)
    
           gnutls_datum_t * q
                       will hold the second prime (q)
    
           gnutls_datum_t * u
                       will hold the coefficient
    
           gnutls_datum_t * e1
                       will hold e1 = d mod (p-1)
    
           gnutls_datum_t * e2
                       will hold e2 = d mod (q-1)
    


## DESCRIPTION



           This function will export the RSA private 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. For
           EdDSA keys, the  _y_ value should be **NULL**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# libpfm_intel_wsm_unc

## NAME



           libpfm_intel_wsm_unc - support for Intel Westmere uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: wsm_unc**
           **PMU desc: Intel Westmere uncore**
    


## DESCRIPTION



           The library supports the Intel Westmere uncore PMU as implemented
           by processors such as Intel Core i7, and Intel Core i5 (models 37,
           44).
    
           The PMU is located at the socket-level and is therefore shared
           between the various cores. By construction it can only measure at
           all privilege levels.
    


## MODIFIERS



           The following modifiers are supported on Intel Westmere
           processors:
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    
           **o** Causes the queue occupancy counter associated with the
                  event to be cleared (zeroed). This is a boolean modifier.
    


* * *