tripathysagar/man_text huggingface dataset:
# gnutls_est_record_overhead_size

## NAME



           gnutls_est_record_overhead_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **size_t gnutls_est_record_overhead_size(gnutls_protocol_t** _version_**,**
           **gnutls_cipher_algorithm_t** _cipher_**, gnutls_mac_algorithm_t** _mac_**,**
           **gnutls_compression_method_t** _comp_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_protocol_t version
                       is a **gnutls_protocol_t** value
    
           gnutls_cipher_algorithm_t cipher
                       is a **gnutls_cipher_algorithm_t** value
    
           gnutls_mac_algorithm_t mac
                       is a **gnutls_mac_algorithm_t** value
    
           gnutls_compression_method_t comp
                       is a **gnutls_compression_method_t** value (ignored)
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will return the set size in bytes of the overhead
           due to TLS (or DTLS) per record.
    
           Note that this function may provide inaccurate values when TLS
           extensions that modify the record format are negotiated. In these
           cases a more accurate value can be obtained using
           **gnutls_record_overhead_size()** after a completed handshake.
    


## SINCE



           3.2.2
    


* * *
# function::user_ulong_error

## NAME



           function::user_ulong_error - Retrieves a unsigned long value
           stored in user space
    


## SYNOPSIS



               user_ulong_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned long from
    


## DESCRIPTION



           Returns the unsigned long value from a given user space address.
           If the user space data is not accessible, an error will occur.
           Note that the size of the unsigned long depends on the
           architecture of the current user space task (for those
           architectures that support both 64/32 bit compat tasks).
    


* * *
# gnutls_x509_dn_export

## NAME



           gnutls_x509_dn_export - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_export(gnutls_x509_dn_t** _dn_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       Holds the uint8_t DN object
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a DN PEM or DER encoded
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will export the DN to DER or PEM format.
    
           If the buffer provided is not long enough to hold the output, then
           * _output_data_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER**
           will be returned.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           NAME".
    


## RETURNS



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


* * *
# audit_fstype_to_name

## NAME



           audit_fstype_to_name - Convert the numeric fstype value to the
           fstype name
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **const char *audit_fstype_to_name(int** _fstype_**);**
    


## DESCRIPTION



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


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, the return value is
           the fstype name.
    


* * *
# wcscspn

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



           wcscspn — get the length of a complementary wide substring
    


## SYNOPSIS



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


## 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 _wcscspn_() function shall compute the length (in wide
           characters) of the maximum initial segment of the wide-character
           string pointed to by _ws1_ which consists entirely of wide-character
           codes _not_ from the wide-character string pointed to by _ws2_.
    


## RETURN VALUE



           The _wcscspn_() function shall return the length of the initial
           substring of _ws1_ ; no return value is reserved to indicate an
           error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_certificate_set_key

## NAME



           gnutls_certificate_set_key - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_certificate_set_key(gnutls_certificate_credentials_t**
           _res_**, const char ****_names_**, int** _names_size_**, gnutls_pcert_st ***
           _pcert_list_**, int** _pcert_list_size_**, gnutls_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const char ** names
                       is an array of DNS names belonging to the public-key
                       (NULL if none)
    
           int names_size
                       holds the size of the names list
    
           gnutls_pcert_st * pcert_list
                       contains a certificate list (chain) or raw public-key
    
           int pcert_list_size
                       holds the size of the certificate list
    
           gnutls_privkey_t key
                       is a **gnutls_privkey_t** key corresponding to the first
                       public-key in pcert_list
    


## DESCRIPTION



           This function sets a public/private key pair in the
           gnutls_certificate_credentials_t type. The given public key may be
           encapsulated in a certificate or can be given as a raw key. This
           function may be called more than once, in case multiple key pairs
           exist for the server. For clients that want to send more than
           their own end- entity certificate (e.g., also an intermediate CA
           cert), the full certificate chain must be provided in  _pcert_list_
           .
    
           Note that the  _key_ will become part of the credentials structure
           and must not be deallocated. It will be automatically deallocated
           when the  _res_ structure is deinitialized.
    
           If this function fails, the  _res_ structure is at an undefined
           state and it must not be reused to load other keys or
           certificates.
    
           Note that, this function by default returns zero on success and a
           negative value on error.  Since 3.5.6, when the flag
           **GNUTLS_CERTIFICATE_API_V2** is set using
           **gnutls_certificate_set_flags()** it returns an index (greater or
           equal to zero). That index can be used for other functions to
           refer to the added key-pair.
    
           Since GnuTLS 3.6.6 this function also handles raw public keys.
    


## RETURNS



           On success this functions returns zero, and otherwise a negative
           value on error (see above for modifying that behavior).
    


## SINCE



           3.0
    


* * *
# pmidstr

## NAME



           **pmIDStr** , **pmIDStr_r** - convert a performance metric identifier into
           a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmIDStr(pmID** _pmid_**);**
           **char *pmIDStr_r(pmID** _pmid_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           For use in error and diagnostic messages, **pmIDStr** returns a `human
           readable'  version  of the specified Performance Metric Identifier
           (PMID).  The **pmIDStr_r** function does the same, but stores the  re‐
           sult  in a user-supplied buffer _buf_ of length _buflen_ , which should
           have room for at least 20 bytes.
    
           Internally, a PMID is encoded with three fields:  domain,  cluster
           and  item.   **pmIDStr** returns a string with each of the fields ap‐
           pearing as decimal numbers, separated by periods.
    
           The string value result from **pmIDStr** is held in  a  single  static
           buffer, so the returned value is only valid until the next call to
           **pmIDStr**.
    


## NOTES



           **pmIDStr** returns  a  pointer  to  a static buffer and hence is not
           thread-safe.  Multi-threaded applications should use **pmIDStr_r** in‐
           stead.
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to  parameter‐
           ize  the  file and directory names used by PCP.  On each installa‐
           tion, the file _/etc/pcp.conf_ contains the local values  for  these
           variables.   The  **$PCP_CONF** variable may be used to specify an al‐
           ternative configuration file, as described in pcp.conf(5).  Values
           for these variables may be  obtained  programmatically  using  the
           pmGetConfig(3) function.
    


* * *
# pthread_spin_unlock

## 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_spin_unlock — unlock a spin lock object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_spin_unlock(pthread_spinlock_t *_lock_);
    


## DESCRIPTION



           The _pthread_spin_unlock_() function shall release the spin lock
           referenced by _lock_ which was locked via the _pthread_spin_lock_() or
           _pthread_spin_trylock_() functions.
    
           The results are undefined if the lock is not held by the calling
           thread.
    
           If there are threads spinning on the lock when
           _pthread_spin_unlock_() is called, the lock becomes available and an
           unspecified spinning thread shall acquire the lock.
    
           The results are undefined if this function is called with an
           uninitialized thread spin lock.
    


## RETURN VALUE



           Upon successful completion, the _pthread_spin_unlock_() function
           shall return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           This function 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 _lock_
           argument to _pthread_spin_unlock_() does not refer to an initialized
           spin lock object, it is recommended that the function should fail
           and report an **[EINVAL]** error.
    
           If an implementation detects that the value specified by the _lock_
           argument to _pthread_spin_unlock_() refers to a spin lock object for
           which the current thread does not hold the lock, it is recommended
           that the function should fail and report an **[EPERM]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::user_int16_error

## NAME



           function::user_int16_error - Retrieves a 16-bit integer value
           stored in user space
    


## SYNOPSIS



               user_int16_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the 16-bit integer from
    


## DESCRIPTION



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


* * *
# gnutls_kx_get_id

## NAME



           gnutls_kx_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_kx_algorithm_t gnutls_kx_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a KX name
    


## DESCRIPTION



           Convert a string to a **gnutls_kx_algorithm_t** value.  The names are
           compared in a case insensitive way.
    


## RETURNS



           an id of the specified KX algorithm, or **GNUTLS_KX_UNKNOWN** on
           error.
    


* * *
# ausearch_add_timestamp_item_ex

## NAME



           ausearch_add_timestamp_item_ex - build up search rule
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int ausearch_add_timestamp_item_ex(auparse_state_t**
           *****_au,_**const** _char_***"**_op,_**time_t"**_sec,_**unsigned"**_milli,_**unsigned"**_serial,_**ausearch_rule_t"**_how);"_
    


## DESCRIPTION



           ausearch_add_timestamp_item adds an event time condition to the
           current audit search expression. The search conditions can then be
           used to scan logs, files, or buffers for something of interest.
           The op parameter specifies the desired comparison. Legal op values
           are _<_ , _< =_, _> =_, _>_ and _=_.  The left operand of the comparison
           operator is the timestamp of the examined event, the right operand
           is specified by the sec, milli, and serial parameters.
    
           The how value determines how this search condition will affect the
           existing search expression if one is already defined. The possible
           values are:
    
                  _AUSEARCH_RULE_CLEAR_
                         Clear the current search expression, if any, and use
                         only this search condition.
    
                  _AUSEARCH_RULE_OR_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **||**_this_search_condition_**)**.
    
                  _AUSEARCH_RULE_AND_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **& & **_this_search_condition_**)**.
    


## RETURN VALUE



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


## APPLICATION USAGE



           Use ausearch_add_item(3) and ausearch_add_interpreted_item(3) to
           add conditions that check audit record fields.  Use
           ausearch_add_expression(3) to add complex search expressions using
           a single function call.
    


* * *
# capng_setpid

## NAME



           capng_setpid - set working pid
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           void capng_setpid(int pid);
    


## DESCRIPTION



           capng_pid sets the working pid for capabilities operations. This
           is useful if you want to get the capabilities of a different
           process.
    


## NOTES



           If your process calls **fork** , then the child process will still
           have the pid of the parent process stored in libcap-ng's internal
           data. It is disallowed to do any kind of setcap operations because
           you would be crossing process boundaries. To correct this, if your
           program links against pthreads, then libcap-ng will use the
           **pthread_atfork** function (as a weak symbol) to reset the pid
           information to the new process automatically. You are not required
           to link against pthreads. You can call **capng_setpid** and adjust the
           stored pid manually.
    


## RETURN VALUE



           None.
    


* * *
# gnutls_global_set_log_function

## NAME



           gnutls_global_set_log_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_set_log_function(gnutls_log_func** _log_func_**);**
    


## ARGUMENTS



           gnutls_log_func log_func
                       it's a log function
    


## DESCRIPTION



           This is the function where you set the logging function gnutls is
           going to use.  This function only accepts a character array.
           Normally you may not use this function since it is only used for
           debugging purposes.
    
            _gnutls_log_func_ is of the form, void (*gnutls_log_func)( int
           level, const char*);
    


* * *
# probe::nfs.aop.readpages

## NAME



           probe::nfs.aop.readpages - NFS client reading multiple pages
    


## SYNOPSIS



           nfs.aop.readpages
    


## VALUES



           _file_
               filp argument
    
           _rpages_
               read size (in pages)
    
           _ino_
               inode number
    
           _dev_
               device identifier
    
           _rsize_
               read size (in bytes)
    
           _size_
               number of pages attempted to read in this execution
    
           _nr_pages_
               number of pages attempted to read in this execution
    


## DESCRIPTION



           Fires when in readahead way, read several pages once
    


* * *
# gnutls_x509_crt_get_issuer_dn_oid

## NAME



           gnutls_x509_crt_get_issuer_dn_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t** _cert_**,**
           **unsigned** _indx_**, void ***_oid_**, size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       This specifies which OID to return. Use (0) to get the
                       first one.
    
           void * oid  a pointer to a buffer to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will extract the OIDs of the name of the Certificate
           issuer specified by the given index.
    
           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.
    


## 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 there are
           no data in the current index. On success 0 is returned.
    


* * *
# pcre2_maketables_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_maketables_free(pcre2_general_context ***_gcontext_**,**
             **const uint8_t ***_tables_**);**
    


## DESCRIPTION



    
           This function discards a set of character tables that were created
           by a call to **pcre2_maketables()**.
    
           The _gcontext_ parameter should match what was used in that call to
           account for any custom allocators that might be in use; if it is
           NULL the system **free()** is used.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page.
    


* * *
# pcap_open_dead_with_tstamp_precision

## NAME



           pcap_open_dead, pcap_open_dead_with_tstamp_precision - open a fake
           pcap_t for compiling filters or opening a capture for output
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **pcap_t *pcap_open_dead(int linktype, int snaplen);**
           **pcap_t *pcap_open_dead_with_tstamp_precision(int linktype, int snaplen,**
               **u_int precision);**
    


## DESCRIPTION



           **pcap_open_dead**() and **pcap_open_dead_with_tstamp_precision**() are
           used for creating a **pcap_t** structure to use when calling the other
           functions in libpcap.  It is typically used when just using
           libpcap for compiling BPF code; it can also be used if using
           **pcap_dump_open**(3PCAP), **pcap_dump**(3PCAP), and
           **pcap_dump_close**(3PCAP) to write a savefile if there is no **pcap_t**
           that supplies the packets to be written.
    
           _linktype_ specifies the link-layer type for the **pcap_t**.
    
           _snaplen_ specifies the snapshot length for the **pcap_t**.
    
           When **pcap_open_dead_with_tstamp_precision**(), is used to create a
           **pcap_t** for use with **pcap_dump_open**(), _precision_ specifies the time
           stamp precision for packets; **PCAP_TSTAMP_PRECISION_MICRO** should be
           specified if the packets to be written have time stamps in seconds
           and microseconds, and **PCAP_TSTAMP_PRECISION_NANO** should be
           specified if the packets to be written have time stamps in seconds
           and nanoseconds.  Its value does not affect **pcap_compile**(3PCAP).
    


## BACKWARD COMPATIBILITY



           The **pcap_open_dead_with_tstamp_precision**() function became
           available in libpcap release 1.5.1.  In previous releases, there
           was no mechanism to open a savefile for writing with time stamps
           given in seconds and nanoseconds.
    


* * *
# libpfm_intel_p6

## NAME



            libpfm_intel_p6 - support for Intel P5 based processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: pm, ppro, pii, piii, p6**
           **PMU desc: Intel Pentium M, Intel Pentium Pro, Intel Pentium II, Intel Pentium III, Intel P6**
    


## DESCRIPTION



           The library supports all Intel P6-based processors all the way
           back to the Pentium Pro. Although all those processors offers the
           same PMU architecture, they differ in the events they provide.
    


## MODIFIERS



           The following modifiers are supported on all Intel P6 processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    


* * *
# gnutls_pubkey_import_tpm_url

## NAME



           gnutls_pubkey_import_tpm_url - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_tpm_url(gnutls_pubkey_t** _pkey_**, const char**
           *****_url_**, const char ***_srk_password_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pkey
                       The public key
    
           const char * url
                       The URL of the TPM key to be imported
    
           const char * srk_password
                       The password for the SRK key (optional)
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will import the given private key to the abstract
           **gnutls_privkey_t** type.
    
           Note that unless **GNUTLS_PUBKEY_DISABLE_CALLBACKS** is specified, if
           incorrect (or NULL) passwords are given the PKCS11 callback
           functions will be used to obtain the correct passwords. Otherwise
           if the SRK password is wrong **GNUTLS_E_TPM_SRK_PASSWORD_ERROR** is
           returned.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# gnutls_group_list

## NAME



           gnutls_group_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_group_t * gnutls_group_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get the list of supported elliptic curves.
    
           This function is not thread safe.
    


## RETURNS



           Return a (0)-terminated list of **gnutls_group_t** integers indicating
           the available groups.
    


## SINCE



           3.6.0
    


* * *
# gnutls_session_get_data

## NAME



           gnutls_session_get_data - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_get_data(gnutls_session_t** _session_**, void ***
           _session_data_**, size_t ***_session_data_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * session_data
                       is a pointer to space to hold the session.
    
           size_t * session_data_size
                       is the session_data's size, or it will be set by the
                       function.
    


## DESCRIPTION



           Returns all session parameters needed to be stored to support
           resumption, in a pre-allocated buffer.
    
           See **gnutls_session_get_data2()** for more information.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise an error
           code is returned.
    


* * *
# auparse_get_type

## NAME



           auparse_get_type - get record's type
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_type will return the integer value for the current
           record of the current event.
    


## RETURN VALUE



           auparse_get_type returns 0 if an error occurs; otherwise, the
           record's type.
    


* * *
# pmlocaltime

## NAME



           **pmLocaltime** - convert the date and time for a reporting timezone
    


## C SYNOPSIS



           **#include <time.h>**
           **#include <pcp/pmapi.h>**
    
           **struct tm *pmLocaltime(const time_t ***_clock_**, struct tm ***_result_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmLocaltime** is  very similar to localtime(3), except the timezone
           used is the current ``reporting timezone'' (rather  than  the  de‐
           fault  **TZ** environment variable scheme), and the result is returned
           into a caller-declared buffer (rather than a private buffer).
    
           Like localtime(3) the time to be converted is  passed  via  _clock_ ,
           and  the _result_ contains the components broken out in the elements
           of the _tm_ struct.
    
           **pmLocaltime** returns _result_ as the value of the function.
    
           The default current reporting timezone is as defined by the **TZ** en‐
           vironment variable, so **pmLocaltime** and localtime(3) will initially
           produce a similar encoding of the date and time.
    
           Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish
           a new current reporting timezone that will affect **pmLocaltime** but
           not localtime(3).
    


* * *
# sched_yield

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



           sched_yield — yield the processor
    


## SYNOPSIS



           #include <sched.h>
    
           int sched_yield(void);
    


## DESCRIPTION



           The _sched_yield_() function shall force the running thread to
           relinquish the processor until it again becomes the head of its
           thread list. It takes no arguments.
    


## RETURN VALUE



           The _sched_yield_() function shall return 0 if it completes
           successfully; otherwise, it shall return a value of -1 and set
           _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The conceptual model for scheduling semantics in POSIX.1‐2008
           defines a set of thread lists. This set of thread lists is always
           present regardless of the scheduling options supported by the
           system. On a system where the Process Scheduling option is not
           supported, portable applications should not make any assumptions
           regarding whether threads from other processes will be on the same
           thread list.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_fsetxattr

## NAME



           io_uring_prep_setxattr, io_uring_prep_fsetxattr - prepare a
           request to set an extended attribute value
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_setxattr(struct io_uring_sqe ***_sqe_**,**
                                       **const char ***_name_**,**
                                       **const char ***_value_**,**
                                       **const char ***_path_**,**
                                       **int** _flags_**,**
                                       **unsigned int** _len_**);**
    
           **void io_uring_prep_fsetxattr(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **const char ***_name_**,**
                                        **const char ***_value_**,**
                                        **int** _flags_**,**
                                        **unsigned int** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_setxattr(3) function prepares a request to set
           an extended attribute value. The submission queue entry _sqe_ is
           setup to set the _value_ of the extended attribute identified by
           _name_ and associated with the given _path_ in the filesystem with
           modifier flags _flags_.  The _len_ argument specifies the size (in
           bytes) of _value_.
    
           io_uring_prep_fsetxattr(3) is identical to
           io_uring_prep_setxattr(3), only the extended attribute is set on
           the open file referred to by _fd_ in place of _path_.
    
           This function prepares an async setxattr(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


* * *
# strstr

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



           strstr — find a substring
    


## SYNOPSIS



           #include <string.h>
    
           char *strstr(const char *_s1_ , const char *_s2_);
    


## 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 _strstr_() function shall locate the first occurrence in the
           string pointed to by _s1_ of the sequence of bytes (excluding the
           terminating NUL character) in the string pointed to by _s2_.
    


## RETURN VALUE



           Upon successful completion, _strstr_() shall return a pointer to the
           located string or a null pointer if the string is not found.
    
           If _s2_ points to a string with zero length, the function shall
           return _s1_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tcp.recvmsg.return

## NAME



           probe::tcp.recvmsg.return - Receiving TCP message complete
    


## SYNOPSIS



           tcp.recvmsg.return
    


## VALUES



           _sport_
               TCP source port
    
           _dport_
               TCP destination port
    
           _size_
               Number of bytes received or error code if an error occurred.
    
           _family_
               IP address family
    
           _daddr_
               A string representing the destination IP address
    
           _name_
               Name of this probe
    
           _saddr_
               A string representing the source IP address
    


## CONTEXT



           The process which receives a tcp message
    


* * *
# rdma_reg_msgs

## NAME



           rdma_reg_msgs - register data buffer(s) for sending or receiving
           messages.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **struct ibv_mr * rdma_reg_msgs (struct rdma_cm_id ***_id_**, void ***_addr_**,**
           **size_t** _length_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer(s) will be used.
    
           addr        The address of the memory buffer(s) to register.
    
           length      The total length of the memory to register.
    


## DESCRIPTION



           Registers an array of memory buffers used for sending and
           receiving messages or for RDMA operations.  Memory buffers
           registered using rdma_reg_msgs may be posted to an rdma_cm_id
           using rdma_post_send or rdma_post_recv, or specified as the target
           of an RDMA read operation or the source of an RDMA write request.
    


## RETURN VALUE



           Returns a reference to the registered memory region on success, or
           NULL on error.  If an error occurs, errno will be set to indicate
           the failure reason.
    


## NOTES



           rdma_reg_msgs is used to register an array of data buffers that
           will be used send and/or receive messages on a queue pair
           associated with an rdma_cm_id.  The memory buffer is registered
           with the proteection domain associated with the idenfier.  The
           start of the data buffer array is specified through the addr
           parameter, and the total size of the array is given by length.
    
           All data buffers should be registered before being posted as a
           work request.  Users must deregister all registered memory by
           calling rdma_dereg_mr.
    


* * *
# signgam

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



           signgam — log gamma function
    


## SYNOPSIS



           #include <math.h>
    
           extern int signgam;
    


## DESCRIPTION



           Refer to lgamma(3p).
    


* * *
# wmemchr

## NAME



           wmemchr - search a wide character in a wide-character array
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wmemchr(** size_t n;
                            **const wchar_t** _s_**[**_n_**], wchar_t** _c_**, size_t** _n_**);**
    


## DESCRIPTION



           The **wmemchr**() function is the wide-character equivalent of the
           memchr(3) function.  It searches the _n_ wide characters starting at
           _s_ for the first occurrence of the wide character _c_.
    


## RETURN VALUE



           The **wmemchr**() function returns a pointer to the first occurrence
           of _c_ among the _n_ wide characters starting at _s_ , or NULL if _c_ does
           not occur among these.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# vsnprintf

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



           vsnprintf, vsprintf — format output of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
    
           int vsnprintf(char *restrict _s_ , size_t _n_ ,
               const char *restrict _format_ , va_list _ap_);
           int vsprintf(char *restrict _s_ , const char *restrict _format_ ,
               va_list _ap_);
    


## DESCRIPTION



           Refer to vfprintf(3p).
    


* * *
# gnutls_x509_crq_get_dn_oid

## NAME



           gnutls_x509_crq_get_dn_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_dn_oid(gnutls_x509_crq_t** _crq_**, unsigned**
           _indx_**, void ***_oid_**, size_t ***_sizeof_oid_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a gnutls_x509_crq_t type
    
           unsigned indx
                       Specifies which DN OID to get. Use (0) to get the
                       first one.
    
           void * oid  a pointer to a structure to hold the name (may be
                       **NULL**)
    
           size_t * sizeof_oid
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will extract the requested OID of the name of the
           certificate request subject, specified by the given index.
    


## RETURNS



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


* * *
# gnutls_x509_trust_list_get_issuer

## NAME



           gnutls_x509_trust_list_get_issuer - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_get_issuer(gnutls_x509_trust_list_t**
           _list_**, gnutls_x509_crt_t** _cert_**, gnutls_x509_crt_t ***_issuer_**, unsigned**
           **int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           gnutls_x509_crt_t cert
                       is the certificate to find issuer for
    
           gnutls_x509_crt_t * issuer
                       Will hold the issuer if any. Should be treated as
                       constant unless **GNUTLS_TL_GET_COPY** is set in  _flags_ .
    
           unsigned int flags
                       flags from **gnutls_trust_list_flags_t**
                       (**GNUTLS_TL_GET_COPY** is applicable)
    


## DESCRIPTION



           This function will find the issuer of the given certificate.  If
           the flag **GNUTLS_TL_GET_COPY** is specified a copy of the issuer will
           be returned which must be freed using **gnutls_x509_crt_deinit()**.
           In that case the provided  _issuer_ must not be initialized.
    
           Note that the flag **GNUTLS_TL_GET_COPY** is required for this
           function to work with PKCS**11** trust lists in a thread-safe way.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# sem_unlink

## 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_unlink — remove a named semaphore
    


## SYNOPSIS



           #include <semaphore.h>
    
           int sem_unlink(const char *_name_);
    


## DESCRIPTION



           The _sem_unlink_() function shall remove the semaphore named by the
           string _name_.  If the semaphore named by _name_ is currently
           referenced by other processes, then _sem_unlink_() shall have no
           effect on the state of the semaphore. If one or more processes
           have the semaphore open when _sem_unlink_() is called, destruction
           of the semaphore is postponed until all references to the
           semaphore have been destroyed by calls to _sem_close_(), __exit_(), or
           _exec_.  Calls to _sem_open_() to recreate or reconnect to the
           semaphore refer to a new semaphore after _sem_unlink_() is called.
           The _sem_unlink_() call shall not block until all references have
           been destroyed; it shall return immediately.
    


## RETURN VALUE



           Upon successful completion, the _sem_unlink_() function shall return
           a value of 0. Otherwise, the semaphore shall not be changed and
           the function shall return a value of -1 and set _errno_ to indicate
           the error.
    


## ERRORS



           The _sem_unlink_() function shall fail if:
    
           **EACCES** Permission is denied to unlink the named semaphore.
    
           **ENOENT** The named semaphore does not exist.
    
           The _sem_unlink_() function may fail if:
    
           **ENAMETOOLONG**
                  The length of the _name_ argument exceeds {_POSIX_PATH_MAX}
                  on systems that do not support the XSI option or exceeds
                  {_XOPEN_PATH_MAX} on XSI systems, or has a pathname
                  component that is longer than {_POSIX_NAME_MAX} on systems
                  that do not support the XSI option or longer than
                  {_XOPEN_NAME_MAX} on XSI systems.  A call to _sem_unlink_()
                  with a _name_ argument that contains the same semaphore name
                  as was previously used in a successful _sem_open_() call
                  shall not give an **[ENAMETOOLONG]** error.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           A future version might require the _sem_open_() and _sem_unlink_()
           functions to have semantics similar to normal file system
           operations.
    


* * *
# selinux_restorecon_get_skipped_errors

## NAME



           selinux_restorecon_get_skipped_errors - get the number of errors
           ignored by selinux_restorecon(3) or selinux_restorecon_parallel(3)
           during the file tree walk
    


## SYNOPSIS



           **#include <selinux/restorecon.h>**
    
           **long unsigned selinux_restorecon_get_skipped_errors(void);**
    


## DESCRIPTION



           If **SELINUX_RESTORECON_COUNT_ERRORS** was passed to
           selinux_restorecon(3) or selinux_restorecon_parallel(3) and that
           function returned successfully (i.e., with a zero return value),
           then **selinux_restorecon_get_skipped_errors**() returns the number of
           errors ignored during the file tree walk.
    


* * *
# gnutls_pkcs11_init

## NAME



           gnutls_pkcs11_init - API function
    


## SYNOPSIS



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


## ARGUMENTS



           unsigned int flags
                       An ORed sequence of **GNUTLS_PKCS11_FLAG_** *
    
           const char * deprecated_config_file
                       either NULL or the location of a deprecated
                       configuration file
    


## DESCRIPTION



           This function will initialize the PKCS 11 subsystem in gnutls. It
           will read configuration files if **GNUTLS_PKCS11_FLAG_AUTO** is used
           or allow you to independently load PKCS 11 modules using
           **gnutls_pkcs11_add_provider()** if **GNUTLS_PKCS11_FLAG_MANUAL** is
           specified.
    
           You don't need to call this function since GnuTLS 3.3.0 because it
           is being called during the first request PKCS 11 operation. That
           call will assume the **GNUTLS_PKCS11_FLAG_AUTO** flag. If another
           flags are required then it must be called independently prior to
           any PKCS 11 operation.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# function::target_set_report

## NAME



           function::target_set_report - Print a report about the target set
    


## SYNOPSIS



               target_set_report()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function prints a report about the processes in the target
           set, and their ancestry.
    


* * *