tripathysagar/man_text huggingface dataset:
# pcap_get_tstamp_precision

## NAME



           pcap_get_tstamp_precision - get the time stamp precision returned
           in captures
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_get_tstamp_precision**() returns the precision of the time
           stamp returned in packet captures on the pcap descriptor.
    


## RETURN VALUE



           **pcap_get_tstamp_precision**() returns **PCAP_TSTAMP_PRECISION_MICRO** or
           **PCAP_TSTAMP_PRECISION_NANO** , which indicates that pcap captures
           contains time stamps in microseconds or nanoseconds respectively.
    


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.5.1.  In
           previous releases, time stamps from a capture device or savefile
           are always given in seconds and microseconds.
    


* * *
# gnutls_x509_crt_get_dn

## NAME



           gnutls_x509_crt_get_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_dn(gnutls_x509_crt_t** _cert_**, char ***_buf_**,**
           **size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           char * buf  a pointer to a structure to hold the name (may be
                       null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will copy the name of the Certificate in the
           provided buffer. The name will be in the form
           "C=xxxx,O=yyyy,CN=zzzz" as described in RFC4514. The output string
           will be ASCII or UTF-8 encoded, depending on the certificate data.
    
           The  _buf_ returned will be null terminated and the  _buf_size_ will
           account for the trailing null. If  _buf_ is null then only the size
           will be filled.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_x509_crt_get_dn3()**.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the  _buf_size_ will be updated with the
           required size. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the DN
           does not exist, or another error value on error. On success 0 is
           returned.
    


* * *
# vswscanf

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



           vswscanf — wide-character formatted input of a stdarg argument
           list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
           #include <wchar.h>
    
           int vswscanf(const wchar_t *restrict _ws_ , const wchar_t *restrict _format_ ,
               va_list _arg_);
    


## DESCRIPTION



           Refer to vfwscanf(3p).
    


* * *
# fegetenv

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



           fegetenv, fesetenv — get and set current floating-point
           environment
    


## SYNOPSIS



           #include <fenv.h>
    
           int fegetenv(fenv_t *_envp_);
           int fesetenv(const fenv_t *_envp_);
    


## 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 _fegetenv_() function shall attempt to store the current
           floating-point environment in the object pointed to by _envp_.
    
           The _fesetenv_() function shall attempt to establish the floating-
           point environment represented by the object pointed to by _envp_.
           The argument _envp_ shall point to an object set by a call to
           _fegetenv_() or _feholdexcept_(), or equal a floating-point
           environment macro. The _fesetenv_() function does not raise
           floating-point exceptions, but only installs the state of the
           floating-point status flags represented through its argument.
    


## RETURN VALUE



           If the representation was successfully stored, _fegetenv_() shall
           return zero. Otherwise, it shall return a non-zero value.  If the
           environment was successfully established, _fesetenv_() shall return
           zero. Otherwise, it shall return a non-zero value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmerrstr

## NAME



           **pmErrStr** , **pmErrStr_r** - convert a PMAPI error code into a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmErrStr(int** _code_**);**
           **char *pmErrStr_r(int** _code_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Translate  an error code into a text string, suitable for generat‐
           ing a diagnostic message.  The **pmErrStr_r** function does the  same,
           but  stores the result in a user-supplied buffer _buf_ of length _bu‐_
           _flen_ , which should have room for at least **PM_MAXERRMSGLEN** bytes.
    
           By convention, all error codes are negative.  The small values are
           assumed to be negated versions of the Unix error codes as  defined
           in **< errno.h> **and the strings returned are as per strerror(3).  The
           larger,  negative  error codes are Performance Metrics Application
           Programming Interface (PMAPI) error conditions and pmErrStr(3) re‐
           turns an appropriate PMAPI error string, as determined by _code_.
    


## NOTES



           **pmErrStr** returns a pointer to a static  buffer,  so  the  returned
           value  is  only valid until the next call to **pmErrStr** and hence is
           not   thread-safe.    Multi-threaded   applications   should   use
           **pmErrStr_r** instead.
    


* * *
# tapset::context-symbols

## NAME



           tapset::context-symbols - systemtap context-symbols tapset
    


## DESCRIPTION



            Context functions provide additional information about where an
           event occurred. These functions can provide information such as a
           backtrace to where the event occurred and the current register
           values for the processor.
    
           **stack** Return address at given depth of kernel stack backtrace
    
                  See function::stack(3stap)
                   for details.
    
           **print_stack**
                  Print out kernel stack from string
    
                  See function::print_stack(3stap)
                   for details.
    
           **sprint_stack**
                  Return stack for kernel addresses from string
    
                  See function::sprint_stack(3stap)
                   for details.
    
           **probefunc**
                  Return the probe point's function name, if known
    
                  See function::probefunc(3stap)
                   for details.
    
           **probemod**
                  Return the probe point's kernel module name
    
                  See function::probemod(3stap)
                   for details.
    
           **modname**
                  Return the kernel module name loaded at the address
    
                  See function::modname(3stap)
                   for details.
    
           **symname**
                  Return the kernel symbol associated with the given address
    
                  See function::symname(3stap)
                   for details.
    
           **symdata**
                  Return the kernel symbol and module offset for the address
    
                  See function::symdata(3stap)
                   for details.
    
           **print_syms**
                  Print out kernel stack from string
    
                  See function::print_syms(3stap)
                   for details.
    
           **sprint_syms**
                  Return stack for kernel addresses from string
    
                  See function::sprint_syms(3stap)
                   for details.
    
           **symfileline**
                  Return the file name and line number of an address.
    
                  See function::symfileline(3stap)
                   for details.
    
           **usymfile**
                  Return the file name of a given address.
    
                  See function::usymfile(3stap)
                   for details.
    
           **usymline**
                  Return the line number of an address.
    
                  See function::usymline(3stap)
                   for details.
    


* * *
# gnutls_pkcs8_info

## NAME



           gnutls_pkcs8_info - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_pkcs8_info(const gnutls_datum_t ***_data_**,**
           **gnutls_x509_crt_fmt_t** _format_**, unsigned int ***_schema_**, unsigned int**
           *****_cipher_**, void ***_salt_**, unsigned int ***_salt_size_**, unsigned int ***
           _iter_count_**, char ****_oid_**);**
    


## ARGUMENTS



           const gnutls_datum_t * data
                       Holds the PKCS **8** data
    
           gnutls_x509_crt_fmt_t format
                       the format of the PKCS **8** data
    
           unsigned int * schema
                       indicate the schema as one of
                       **gnutls_pkcs_encrypt_flags_t**
    
           unsigned int * cipher
                       the cipher used as **gnutls_cipher_algorithm_t**
    
           void * salt PBKDF2 salt (if non-NULL then  _salt_size_ initially
                       holds its size)
    
           unsigned int * salt_size
                       PBKDF2 salt size
    
           unsigned int * iter_count
                       PBKDF2 iteration count
    
           char ** oid if non-NULL it will contain an allocated
                       null-terminated variable with the OID
    


## DESCRIPTION



           This function will provide information on the algorithms used in a
           particular PKCS **8** structure. If the structure algorithms are
           unknown the code **GNUTLS_E_UNKNOWN_CIPHER_TYPE** will be returned,
           and only  _oid_ , will be set. That is,  _oid_ will be set on
           encrypted PKCS **8** structures whether supported or not. It must be
           deinitialized using **gnutls_free()**.  The other variables are only
           set on supported structures.
    


## RETURNS



           **GNUTLS_E_INVALID_REQUEST** if the provided structure isn't an
           encrypted key, **GNUTLS_E_UNKNOWN_CIPHER_TYPE** if the structure's
           encryption isn't supported, or another negative error code in case
           of a failure. Zero on success.
    


## SINCE



           3.4.0
    


* * *
# function::ansi_new_line

## NAME



           function::ansi_new_line - Move cursor to new line.
    


## SYNOPSIS



               ansi_new_line()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code new line.
    


* * *
# endhostent

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



           endhostent, gethostent, sethostent — network host database
           functions
    


## SYNOPSIS



           #include <netdb.h>
    
           void endhostent(void);
           struct hostent *gethostent(void);
           void sethostent(int _stayopen_);
    


## DESCRIPTION



           These functions shall retrieve information about hosts. This
           information is considered to be stored in a database that can be
           accessed sequentially or randomly. The implementation of this
           database is unspecified.
    
           **Note:** In many cases this database is implemented by the Domain
                  Name System, as documented in RFC 1034, RFC 1035, and
                  RFC 1886.
    
           The _sethostent_() function shall open a connection to the database
           and set the next entry for retrieval to the first entry in the
           database. If the _stayopen_ argument is non-zero, the connection
           shall not be closed by a call to _gethostent_(), and the
           implementation may maintain an open file descriptor.
    
           The _gethostent_() function shall read the next entry in the
           database, opening and closing a connection to the database as
           necessary.
    
           Entries shall be returned in **hostent** structures.
    
           The _endhostent_() function shall close the connection to the
           database, releasing any open file descriptor.
    
           These functions need not be thread-safe.
    


## RETURN VALUE



           Upon successful completion, the _gethostent_() function shall return
           a pointer to a **hostent** structure if the requested entry was found,
           and a null pointer if the end of the database was reached or the
           requested entry was not found.
    
           The application shall not modify the structure to which the return
           value points, nor any storage areas pointed to by pointers within
           the structure. The returned pointer, and pointers within the
           structure, might be invalidated or the structure or the storage
           areas might be overwritten by a subsequent call to _gethostent_().
           The returned pointer, and pointers within the structure, might
           also be invalidated if the calling thread is terminated.
    


## ERRORS



           No errors are defined for _endhostent_(), _gethostent_(), and
           _sethostent_().
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# seekdir

## NAME



           seekdir - set the position of the next readdir() call in the
           directory stream.
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <dirent.h>**
    
           **void seekdir(DIR ***_dirp_**, long** _loc_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **seekdir**():
               _XOPEN_SOURCE
                   || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The **seekdir**() function sets the location in the directory stream
           from which the next readdir(2) call will start.  The _loc_ argument
           should be a value returned by a previous call to telldir(3).
    


## RETURN VALUE



           The **seekdir**() function returns no value.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## CAVEATS



           Up to glibc 2.1.1, the type of the _loc_ argument was _off_t_.
           POSIX.1-2001 specifies _long_ , and this is the type used since glibc
           2.1.2.  See telldir(3) for information on why you should be
           careful in making any assumptions about the value in this
           argument.
    


* * *
# gnutls_store_pubkey

## NAME



           gnutls_store_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_store_pubkey(const char ***_db_name_**, gnutls_tdb_t** _tdb_**,**
           **const char ***_host_**, const char ***_service_**, gnutls_certificate_type_t**
           _cert_type_**, const gnutls_datum_t ***_cert_**, time_t** _expiration_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * db_name
                       A file specifying the stored keys (use NULL for the
                       default)
    
           gnutls_tdb_t tdb
                       A storage structure or NULL to use the default
    
           const char * host
                       The peer's name
    
           const char * service
                       non-NULL if this key is specific to a service (e.g.
                       http)
    
           gnutls_certificate_type_t cert_type
                       The type of the certificate
    
           const gnutls_datum_t * cert
                       The data of the certificate
    
           time_t expiration
                       The expiration time (use 0 to disable expiration)
    
           unsigned int flags
                       should be 0.
    


## DESCRIPTION



           This function will store a raw public-key or a public-key provided
           via a raw (DER-encoded) certificate to the list of stored public
           keys. The key will be considered valid until the provided
           expiration time.
    
           The  _tdb_ variable if non-null specifies a custom backend for the
           storage of entries. If it is NULL then the default file backend
           will be used.
    
           Unless an alternative  _tdb_ is provided, the storage format is a
           textual format consisting of a line for each host with fields
           separated by '|'. The contents of the fields are a
           format-identifier which is set to 'g0', the hostname that the rest
           of the data applies to, the numeric port or host name, the
           expiration time in seconds since the epoch (0 for no expiration),
           and a base64 encoding of the raw (DER) public key information
           (SPKI) of the peer.
    
           As of GnuTLS 3.6.6 this function also accepts raw public keys.
    


## RETURNS



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


## SINCE



           3.0.13
    


* * *
# io_uring_prep_writev

## NAME



           io_uring_prep_writev - prepare vector I/O write request
    


## SYNOPSIS



           **#include <sys/uio.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_writev(struct io_uring_sqe ***_sqe_**,**
                                     **int** _fd_**,**
                                     **const struct iovec ***_iovecs_**,**
                                     **unsigned** _nr_vecs_**,**
                                     **__u64** _offset_**);**
    


## DESCRIPTION



           The io_uring_prep_writev(3) prepares a vectored IO write request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _fd_ to start writing _nr_vecs_ from the _iovecs_ array at the specified
           _offset_.
    
           On files that support seeking, if the offset is set to **-1** , the
           write operation commences at the file offset, and the file offset
           is incremented by the number of bytes written. See write(2) for
           more details. Note that for an async API, reading and updating the
           current file offset may result in unpredictable behavior, unless
           access to the file is serialized. It is not encouraged to use this
           feature if it's possible to provide the desired IO offset from the
           application or library.
    
           On files that are not capable of seeking, the offset must be 0 or
           -1.
    
           After the write has been prepared it can be submitted with one of
           the submit functions.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



           Unless an application explicitly needs to pass in more than one
           iovec, it is more efficient to use io_uring_prep_write(3) rather
           than this function, as no state has to be maintained for a non-
           vectored IO request.  As with any request that passes in data in a
           struct, that data must remain valid until the request has been
           successfully submitted. It need not remain valid until completion.
           Once a request has been submitted, the in-kernel state is stable.
           Very early kernels (5.4 and earlier) required state to be stable
           until the completion occurred. Applications can test for this
           behavior by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed
           back from io_uring_queue_init_params(3).
    


* * *
# gnutls_x509_tlsfeatures_init

## NAME



           gnutls_x509_tlsfeatures_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_tlsfeatures_init(gnutls_x509_tlsfeatures_t ***_f_**);**
    


## ARGUMENTS



           gnutls_x509_tlsfeatures_t * f
                       The TLS features
    


## DESCRIPTION



           This function will initialize a X.509 TLS features extension
           structure
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# gnutls_pkcs12_bag_enc_info

## NAME



           gnutls_pkcs12_bag_enc_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_enc_info(gnutls_pkcs12_bag_t** _bag_**, unsigned**
           **int ***_schema_**, unsigned int ***_cipher_**, void ***_salt_**, unsigned int ***
           _salt_size_**, unsigned int ***_iter_count_**, char ****_oid_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           unsigned int * schema
                       indicate the schema as one of
                       **gnutls_pkcs_encrypt_flags_t**
    
           unsigned int * cipher
                       the cipher used as **gnutls_cipher_algorithm_t**
    
           void * salt PBKDF2 salt (if non-NULL then  _salt_size_ initially
                       holds its size)
    
           unsigned int * salt_size
                       PBKDF2 salt size
    
           unsigned int * iter_count
                       PBKDF2 iteration count
    
           char ** oid if non-NULL it will contain an allocated
                       null-terminated variable with the OID
    


## DESCRIPTION



           This function will provide information on the encryption
           algorithms used in an encrypted bag. If the structure algorithms
           are unknown the code **GNUTLS_E_UNKNOWN_CIPHER_TYPE** will be
           returned, and only  _oid_ , will be set. That is,  _oid_ will be set
           on encrypted bags whether supported or not. It must be
           deinitialized using **gnutls_free()**.  The other variables are only
           set on supported structures.
    


## RETURNS



           **GNUTLS_E_INVALID_REQUEST** if the provided bag isn't encrypted,
           **GNUTLS_E_UNKNOWN_CIPHER_TYPE** if the structure's encryption isn't
           supported, or another negative error code in case of a failure.
           Zero on success.
    


* * *
# acl_delete_perm

## NAME



           **acl_delete_perm** — delete a permission from an ACL permission set
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_delete_perm**(_acl_permset_t_
           _permset_d_ , _acl_perm_t perm_)
    


## DESCRIPTION



           The **acl_delete_perm**() function deletes the permission contained in
           the argument _perm_ (one of ACL_READ, ACL_WRITE, ACL_EXECUTE) from
           the permission set referred to by the argument _permset_d_.  An
           attempt to delete a permission that is not contained in the
           permission set is not considered an error.
    
           Any existing descriptors that refer to _permset_d_ continue to refer
           to that permission set.
    


## RETURN VALUE



           The **acl_delete_perm**() function returns the value 0 if successful;
           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_delete_perm**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _permset_d_ is not a valid
                              descriptor for a permission set within an ACL
                              entry.
    
                              The argument _perm_ does not contain a valid
                              _acl_perm_t_ value.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# libpfm_intel_snbep_unc_r2pcie

## NAME



           libpfm_intel_snbep_unc_r2pcie - support for Intel Sandy Bridge-EP
           R2 PCIe  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snbep_unc_r2pcie**
           **PMU desc: Intel Sandy Bridge-EP R2 PCIe uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge R2 PCIe uncore PMU.
           This PMU model only exists on Sandy Bridge model 45. There is only
           one R2PCIe PMU per processor socket.
    


## MODIFIERS



           The following modifiers are supported on Intel Sandy Bridge R2PCIe
           uncore PMU:
    
           **i** Invert the meaning of the event. The counter will now count
                  R2 PCIe cycles in which the event is **not** occurring. This is
                  a boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of 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].
    


* * *
# gnutls_x509_aia_deinit

## NAME



           gnutls_x509_aia_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void gnutls_x509_aia_deinit(gnutls_x509_aia_t** _aia_**);**
    


## ARGUMENTS



           gnutls_x509_aia_t aia
                       The authority info access
    


## DESCRIPTION



           This function will deinitialize an authority info access type.
    


## SINCE



           3.3.0
    


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



           sem_destroy — destroy an unnamed semaphore
    


## SYNOPSIS



           #include <semaphore.h>
    
           int sem_destroy(sem_t *_sem_);
    


## DESCRIPTION



           The _sem_destroy_() function shall destroy the unnamed semaphore
           indicated by _sem_.  Only a semaphore that was created using
           _sem_init_() may be destroyed using _sem_destroy_(); the effect of
           calling _sem_destroy_() with a named semaphore is undefined. The
           effect of subsequent use of the semaphore _sem_ is undefined until
           _sem_ is reinitialized by another call to _sem_init_().
    
           It is safe to destroy an initialized semaphore upon which no
           threads are currently blocked. The effect of destroying a
           semaphore upon which other threads are currently blocked is
           undefined.
    


## RETURN VALUE



           Upon successful completion, a value of zero shall be returned.
           Otherwise, a value of -1 shall be returned and _errno_ set to
           indicate the error.
    


## ERRORS



           The _sem_destroy_() function may fail if:
    
           **EINVAL** The _sem_ argument is not a valid semaphore.
    
           **EBUSY** There are currently processes blocked on the semaphore.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_anti_replay_enable

## NAME



           gnutls_anti_replay_enable - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_anti_replay_enable(gnutls_session_t** _session_**,**
           **gnutls_anti_replay_t** _anti_replay_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_anti_replay_t anti_replay
                       is a **gnutls_anti_replay_t** type.
    


## DESCRIPTION



           Request that the server should use anti-replay mechanism.
    


## SINCE



           3.6.5
    


* * *
# gnutls_sec_param_get_name

## NAME



           gnutls_sec_param_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_sec_param_get_name(gnutls_sec_param_t** _param_**);**
    


## ARGUMENTS



           gnutls_sec_param_t param
                       is a security parameter
    


## DESCRIPTION



           Convert a **gnutls_sec_param_t** value to a string.
    


## RETURNS



           a pointer to a string that contains the name of the specified
           security level, or **NULL**.
    


## SINCE



           2.12.0
    


* * *
# gnutls_pkcs12_bag_set_crl

## NAME



           gnutls_pkcs12_bag_set_crl - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_set_crl(gnutls_pkcs12_bag_t** _bag_**,**
           **gnutls_x509_crl_t** _crl_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           gnutls_x509_crl_t crl
                       the CRL to be copied.
    


## DESCRIPTION



           This function will insert the given CRL into the bag. This is just
           a wrapper over **gnutls_pkcs12_bag_set_data()**.
    


## RETURNS



           the index of the added bag on success, or a negative error code on
           failure.
    


* * *
# function::stack

## NAME



           function::stack - Return address at given depth of kernel stack
           backtrace
    


## SYNOPSIS



               stack:long(n:long)
    


## ARGUMENTS



           _n_
               number of levels to descend in the stack.
    


## DESCRIPTION



           Performs a simple (kernel) backtrace, and returns the element at
           the specified position. The results of the backtrace itself are
           cached, so that the backtrace computation is performed at most
           once no matter how many times **stack** is called, or in what order.
    


* * *
# gnutls_x509_spki_deinit

## NAME



           gnutls_x509_spki_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_spki_deinit(gnutls_x509_spki_t** _spki_**);**
    


## ARGUMENTS



           gnutls_x509_spki_t spki
                       the SubjectPublicKeyInfo structure
    


## DESCRIPTION



           This function will deinitialize a SubjectPublicKeyInfo structure.
    


## SINCE



           3.6.0
    


* * *
# tcgetsid

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



           tcgetsid — get the process group ID for the session leader for the
           controlling terminal
    


## SYNOPSIS



           #include <termios.h>
    
           pid_t tcgetsid(int _fildes_);
    


## DESCRIPTION



           The _tcgetsid_() function shall obtain the process group ID of the
           session for which the terminal specified by _fildes_ is the
           controlling terminal.
    


## RETURN VALUE



           Upon successful completion, _tcgetsid_() shall return the process
           group ID of the session associated with the terminal. Otherwise, a
           value of -1 shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _tcgetsid_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **ENOTTY** The calling process does not have a controlling terminal,
                  or the file is not the controlling terminal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ibnd_iter_nodes

## NAME



           ibnd_iter_nodes, ibnd_iter_nodes_type - given a fabric object and
           a function itterate over the nodes in the fabric.
    


## SYNOPSIS



           **#include <infiniband/ibnetdisc.h>**
    
           **void ibnd_iter_nodes(ibnd_fabric_t *fabric, ibnd_iter_func_t func, void *user_data)**
           **void ibnd_iter_nodes_type(ibnd_fabric_t *fabric, ibnd_iter_func_t func, ibnd_node_type_t type, void *user_data)**
    


## DESCRIPTION



           **ibnd_iter_nodes()** Itterate through all the nodes in the fabric and
           call "func" on them.  **ibnd_iter_nodes_type()** The same as
           ibnd_iter_nodes except to limit the iteration to the nodes with
           the specified type.
    


## RETURN VALUE



           **ibnd_iter_nodes(), ibnd_iter_nodes_type()** NONE
    


* * *
# function::cpu_clock_ms

## NAME



           function::cpu_clock_ms - Number of milliseconds on the given cpu's
           clock
    


## SYNOPSIS



               cpu_clock_ms:long(cpu:long)
    


## ARGUMENTS



           _cpu_
               Which processor's clock to read
    


## DESCRIPTION



           This function returns the number of milliseconds 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).
    


* * *
# mlx5dv_map_ah_to_qp

## NAME



           mlx5dv_map_ah_to_qp - Map the destination path information in
           address handle (AH) to the information extracted from the qp.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_map_ah_to_qp(struct ibv_ah *ah, uint32_t qp_num);
    


## DESCRIPTION



           This API maps the destination path information in address handle
           (_ah_) to the information extracted from the qp (e.g. congestion
           control from ECE).
    
           This API serves as an enhancement to DC and UD QPs to achieve
           better performance by using per-address congestion control (CC)
           algorithms, enabling DC/UD QPs to use multiple CC algorithms in
           the same datacenter.
    
           The mapping created by this API is implicitly destroyed when the
           address handle is destroyed.  It is not affected by the
           destruction of QP _qp_num_.
    
           A duplicate mapping to the same address handle is ignored.  As
           this API is just a hint for the hardware in this case it would do
           nothing and return success regardless of the new qp_num ECE.
    
           The function must be called after ECE negotiation/preconfiguration
           was done by some external means.
    


## ARGUMENTS



           _ah_     The target’s address handle.
    
           _qp_num_ The initiator QP from which congestion control information
                  is extracted from its ECE.
    


## RETURN VALUE



           Upon success, returns 0; Upon failure, the value of errno is
           returned.
    


* * *
# function::user_short_error

## NAME



           function::user_short_error - Retrieves a short value stored in
           user space
    


## SYNOPSIS



               user_short_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the short from
    


## DESCRIPTION



           Returns the short value from a given user space address. If the
           user space data is not accessible, an error will occur.
    


* * *
# gnutls_pkcs11_obj_import_url

## NAME



           gnutls_pkcs11_obj_import_url - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       The structure to store the object
    
           const char * url
                       a PKCS 11 url identifying the key
    
           unsigned int flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will "import" a PKCS 11 URL identifying an object
           (e.g. certificate) to the **gnutls_pkcs11_obj_t** type. This does not
           involve any parsing (such as X.509 or OpenPGP) since the
           **gnutls_pkcs11_obj_t** is format agnostic. Only data are transferred.
    
           If the flag **GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT** is
           specified any certificate read, will have its extensions
           overwritten by any stapled extensions in the trust module.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_pcert_import_x509

## NAME



           gnutls_pcert_import_x509 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_x509(gnutls_pcert_st ***_pcert_**,**
           **gnutls_x509_crt_t** _crt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure
    
           gnutls_x509_crt_t crt
                       The certificate to be imported
    
           unsigned int flags
                       zero for now
    


## DESCRIPTION



           This convenience function will import the given certificate to a
           **gnutls_pcert_st** structure. The structure must be deinitialized
           afterwards using **gnutls_pcert_deinit()** ;
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# strtoimax

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



           strtoimax, strtoumax — convert string to integer type
    


## SYNOPSIS



           #include <inttypes.h>
    
           intmax_t strtoimax(const char *restrict _nptr_ , char **restrict _endptr_ ,
               int _base_);
           uintmax_t strtoumax(const char *restrict _nptr_ , char **restrict _endptr_ ,
               int _base_);
    


## 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 be equivalent to the _strtol_(), _strtoll_(),
           _strtoul_(), and _strtoull_() functions, except that the initial
           portion of the string shall be converted to **intmax_t** and **uintmax_t**
           representation, respectively.
    


## RETURN VALUE



           These functions shall return the converted value, if any.
    
           If no conversion could be performed, zero shall be returned and
           _errno_ may be set to **[EINVAL]**.
    
           If the value of _base_ is not supported, 0 shall be returned and
           _errno_ shall be set to **[EINVAL]**.
    
           If the correct value is outside the range of representable values,
           {INTMAX_MAX}, {INTMAX_MIN}, or {UINTMAX_MAX} shall be returned
           (according to the return type and sign of the value, if any), and
           _errno_ shall be set to **[ERANGE]**.
    


## ERRORS



           These functions shall fail if:
    
           **EINVAL** The value of _base_ is not supported.
    
           **ERANGE** The value to be returned is not representable.
    
           These functions may fail if:
    
           **EINVAL** No conversion could be performed.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Since the value of _*endptr_ is unspecified if the value of _base_ is
           not supported, applications should either ensure that _base_ has a
           supported value (0 or between 2 and 36) before the call, or check
           for an **[EINVAL]** error before examining _*endptr_.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# mlx5dv_dci_stream_id_reset

## NAME



           mlx5dv_dci_stream_id_reset - Reset stream_id of a given DCI QP
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_dci_stream_id_reset(struct ibv_qp *qp, uint16_t stream_id);
    


## DESCRIPTION



           Used by SW to reset an errored _stream_id_ in the HW DCI context.
    
           On work completion with error, the application should call
           ibv_query_qp() to check if the QP was moved to an error state, or
           it’s still operational (in RTS state), which means that the
           specific _stream_id_ that caused the completion with error is in
           error state.
    
           Errors which are stream related will cause only that _stream_id’s_
           work request to be flushed as they are handled in order in the
           send queue.  Once all _stream_id_ WR’s are flushed, application
           should reset the errored _stream_id_ by calling
           mlx5dv_dci_stream_id_reset().  Work requested for other
           _stream_id’s_ will continue to be processed by the QP.  The DCI QP
           will move to an error state and stop operating once the number of
           unique _stream_id_ in error reaches the DCI QP’s `log_num_errored'
           streams defined by SW.
    
           Application should use the `wr_id' in the ibv_wc to find the
           _stream_id_ from it’s private context.
    


## ARGUMENTS



           _qp_     The ibv_qp object to issue the action on.
    
           _stream_id_
                  The DCI stream channel id that need to be reset.
    


## RETURN VALUE



           Returns 0 on success, or the value of errno on failure (which
           indicates the failure reason).
    


* * *
# gnutls_x509_crt_get_issuer_alt_othername_oid

## NAME



           gnutls_x509_crt_get_issuer_alt_othername_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_alt_othername_oid(gnutls_x509_crt_t**
           _cert_**, unsigned int** _seq_**, void ***_ret_**, size_t ***_ret_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * ret  is the place where the otherName OID will be copied to
    
           size_t * ret_size
                       holds the size of ret.
    


## DESCRIPTION



           This function will extract the type OID of an otherName Subject
           Alternative Name, contained in the given certificate, and return
           the type as an enumerated element.
    
           If  _oid_ is null then only the size will be filled. The  _oid_
           returned will be null terminated, although  _oid_size_ will not
           account for the trailing null.
    
           This function is only useful if
           **gnutls_x509_crt_get_issuer_alt_name()** returned
           **GNUTLS_SAN_OTHERNAME**.
    


## RETURNS



           the alternative issuer name type on success, one of the enumerated
           gnutls_x509_subject_alt_name_t.  For supported OIDs, it will
           return one of the virtual (GNUTLS_SAN_OTHERNAME_*) types, e.g.
           **GNUTLS_SAN_OTHERNAME_XMPP** , and **GNUTLS_SAN_OTHERNAME** for unknown
           OIDs.  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 does not have an Alternative name with the specified
           sequence number and with the otherName type then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           2.10.0
    


* * *