tripathysagar/man_text huggingface dataset:
# __pmlogmetatypestr

## NAME



           **__pmLogMetaTypeStr** , **__pmLogMetaTypeStr_r** - convert an archive
           metadata record type into a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
    
           **const char *__pmLogMetaTypeStr(int** _type_**);**
           **char *__pmLogMetaTypeStr_r(int** _type_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           Given a numeric archive  metadata  record  type  (_type_),  **__pmLog‐**
           **MetaTypeStr** produces the ASCII name of that record type, else **UN‐**
           **KNOWN** if _type_ is not a valid  record  type.   **__pmLogMetaTypeStr_r**
           function  does  the same, but stores the result in a user-supplied
           buffer _buf_ of length _buflen_ , which should have room for  at  least
           17 bytes.
    
           Examples  are  **DESC**(for _type_ equals **1**), **INDOM_V2**(for _type_ equals
           **2**), etc.
    


## NOTES



           Both of these functions are safe to call from threaded contexts.
    


* * *
# gnutls_fips140_pop_context

## NAME



           gnutls_fips140_pop_context - API function
    


## SYNOPSIS



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


## ARGUMENTS



            void
    


## DESCRIPTION



           Dissociate the FIPS context currently active on the current
           thread, reverting to the previously active context. If a
           cryptographic operation is ongoing in the current thread, e.g.,
           **gnutls_aead_cipher_init()** is called but
           **gnutls_aead_cipher_deinit()** is not yet called, it returns an error
           **GNUTLS_E_INVALID_REQUEST**.
    
           This function is no-op if FIPS140 is not compiled in nor enabled
           at run-time.
    


## RETURNS



           0 upon success, a negative error code otherwise
    


## SINCE



           3.7.3
    


* * *
# pmdainterfacemoved

## NAME



           **pmdaInterfaceMoved** - reset internal state of a _pmdaInterface_
           structure
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **void pmdaInterfaceMoved(pmdaInterface ***_dispatch_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           After  a  call to either pmdaDaemon(3) or pmdaDSO(3) to initialize
           the **pmdaInterface** structure, if the caller needs  to  relocate  or
           move the structure for any reason then **pmdaInterfaceMoved** needs to
           be  called  with the new base address of the _pmdaInterface_ routine
           as specified by _dispatch_.
    
           **pmdaInterfaceMoved** will re-establish the internal integrity of the
           _pmdaInterface_ structure at the new location before any other  rou‐
           tine in _libpcp_pmda_ called.
    


## CAVEAT



           The PMDA must be using **PMDA_INTERFACE_2** or later.
    


* * *
# gnutls_x509_crt_get_signature

## NAME



           gnutls_x509_crt_get_signature - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_signature(gnutls_x509_crt_t** _cert_**, char ***
           _sig_**, size_t ***_sig_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           char * sig  a pointer where the signature part will be copied (may
                       be null).
    
           size_t * sig_size
                       initially holds the size of  _sig_
    


## DESCRIPTION



           This function will extract the signature field of a certificate.
    


## RETURNS



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


* * *
# function::symdata

## NAME



           function::symdata - Return the kernel symbol and module offset for
           the address
    


## SYNOPSIS



               symdata:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate
    


## DESCRIPTION



           Returns the (function) symbol name associated with the given
           address if known, the offset from the start and size of the
           symbol, plus module name (between brackets). If symbol is unknown,
           but module is known, the offset inside the module, plus the size
           of the module is added. If any element is not known it will be
           omitted and if the symbol name is unknown it will return the hex
           string for the given address.
    


* * *
# gnutls_cipher_decrypt3

## NAME



           gnutls_cipher_decrypt3 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_decrypt3(gnutls_cipher_hd_t** _handle_**, const void ***
           _ctext_**, size_t** _ctext_len_**, void ***_ptext_**, size_t ***_ptext_len_**,**
           **unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           const void * ctext
                       the data to decrypt
    
           size_t ctext_len
                       the length of data to decrypt
    
           void * ptext
                       the decrypted data
    
           size_t * ptext_len
                       the available length for decrypted data
    
           unsigned flags
                       flags for padding
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           specified by the context. If  _flags_ is specified, padding for the
           decrypted data will be removed accordingly and  _ptext_len_ will be
           updated.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.7.7
    


* * *
# gnutls_pkcs11_token_get_url

## NAME



           gnutls_pkcs11_token_get_url - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_get_url(unsigned int** _seq_**,**
           **gnutls_pkcs11_url_type_t** _detailed_**, char ****_url_**);**
    


## ARGUMENTS



           unsigned int seq
                       sequence number starting from 0
    
           gnutls_pkcs11_url_type_t detailed
                       non zero if a detailed URL is required
    
           char ** url will contain an allocated url
    


## DESCRIPTION



           This function will return the URL for each token available in
           system. The url has to be released using **gnutls_free()**
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the sequence number
           exceeds the available tokens, otherwise a negative error value.
    


## SINCE



           2.12.0
    


* * *
# wmemset

## NAME



           wmemset - fill an array of wide-characters with a constant wide
           character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wmemset(** size_t n;
                            **wchar_t** _wcs_**[**_n_**], wchar_t** _wc_**, size_t** _n_**);**
    


## DESCRIPTION



           The **wmemset**() function is the wide-character equivalent of the
           memset(3) function.  It fills the array of _n_ wide-characters
           starting at _wcs_ with _n_ copies of the wide character _wc_.
    


## RETURN VALUE



           **wmemset**() returns _wcs_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# sqrt

## NAME



           sqrt, sqrtf, sqrtl - square root function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double sqrt(double** _x_**);**
           **float sqrtf(float** _x_**);**
           **long double sqrtl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **sqrtf**(), **sqrtl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return the nonnegative square root of _x_.
    


## RETURN VALUE



           On success, these functions return the square root of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 (-0), +0 (-0) is returned.
    
           If _x_ is positive infinity, positive infinity is returned.
    
           If _x_ is less than -0, a domain error occurs, and a NaN is
           returned.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x_ less than -0
                  _errno_ is set to **EDOM**.  An invalid floating-point exception
                  (**FE_INVALID**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pcap_dump_close

## NAME



           pcap_dump_close - close a savefile being written to
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **void pcap_dump_close(pcap_dumper_t *p);**
    


## DESCRIPTION



           **pcap_dump_close**() closes the ``savefile'' associated with _p_ and
           deallocates resources. This means that, for example, if _p_ refers
           to a savefile that was opened with **pcap_dump_fopen**(), the stream
           provided to that routine will be closed unless it is **stdout**.
    


* * *
# isascii

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



           isascii — test for a 7-bit US-ASCII character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isascii(int _c_);
    


## DESCRIPTION



           The _isascii_() function shall test whether _c_ is a 7-bit US-ASCII
           character code.
    
           The _isascii_() function is defined on all integer values.
    


## RETURN VALUE



           The _isascii_() function shall return non-zero if _c_ is a 7-bit US-
           ASCII character code between 0 and octal 0177 inclusive;
           otherwise, it shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _isascii_() function cannot be used portably in a localized
           application.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           The _isascii_() function may be removed in a future version.
    


* * *
# gnutls_cipher_deinit

## NAME



           gnutls_cipher_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_cipher_deinit(gnutls_cipher_hd_t** _handle_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    


## DESCRIPTION



           This function will deinitialize all resources occupied by the
           given encryption context.
    


## SINCE



           2.10.0
    


* * *
# seccomp_precompute

## NAME



           seccomp_precompute - Precompute the current seccomp filter
    


## SYNOPSIS



           **#include <seccomp.h>**
    
           **typedef void * scmp_filter_ctx;**
    
           **int seccomp_precompute(scmp_filter_ctx** _ctx_**);**
    
           Link with _-lseccomp_.
    


## DESCRIPTION



           Precomputes the seccomp filter for later use by **seccomp_load**() and
           similar functions.  Not only does this improve performance of
           **seccomp_load**() it also ensures that the seccomp filter can be
           loaded in an async-signal-safe manner if no changes have been made
           to the filter since it was precomputed.
    


## RETURN VALUE



           Returns zero on success or one of the following error codes on
           failure:
    
           **-ECANCELED**
                  There was a system failure beyond the control of the
                  library.
    
           **-EFAULT**
                  Internal libseccomp failure.
    
           **-EINVAL**
                  Invalid input, either the context or architecture token is
                  invalid.
    
           **-ENOMEM**
                  The library was unable to allocate enough memory.
    
           If the _SCMP_FLTATR_API_SYSRAWRC_ filter attribute is non-zero then
           additional error codes may be returned to the caller; these
           additional error codes are the negative _errno_ values returned by
           the system.  Unfortunately libseccomp can make no guarantees about
           these return values.
    


## EXAMPLES



           #include <seccomp.h>
    
           int main(int argc, char *argv[])
           {
                int rc = -1;
                scmp_filter_ctx ctx;
    
                ctx = seccomp_init(SCMP_ACT_KILL);
                if (ctx == NULL)
                     goto out;
    
                /* ... */
    
                rc = seccomp_precompute(ctx);
                if (rc < 0)
                     goto out;
    
                /* ... */
    
                rc = seccomp_load(ctx);
                if (rc < 0)
                     goto out;
    
                /* ... */
    
           out:
                seccomp_release(ctx);
                return -rc;
           }
    


## NOTES



           While the seccomp filter can be generated independent of the
           kernel, kernel support is required to load and enforce the seccomp
           filter generated by libseccomp.
    
           The libseccomp project site, with more information and the source
           code repository, can be found at
           https://github.com/seccomp/libseccomp.  This tool, as well as the
           libseccomp library, is currently under development, please report
           any bugs at the project site or directly to the author.
    


* * *
# pthread_condattr_init

## NAME



           pthread_condattr_init, pthread_condattr_destroy - condition
           creation attributes
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **int pthread_condattr_init(pthread_condattr_t ***_attr_**); int**
           **pthread_condattr_destroy(pthread_condattr_t ***_attr_**);**
    


## DESCRIPTION



           Condition attributes can be specified at condition creation time,
           by passing a condition attribute object as second argument to
           pthread_cond_init(3).  Passing NULL is equivalent to passing a
           condition attribute object with all attributes set to their
           default values.
    
           The LinuxThreads implementation supports no attributes for
           conditions.  The functions on condition attributes are included
           only for compliance with the POSIX standard.
    
           **pthread_condattr_init**() initializes the condition attribute object
           _attr_ and fills it with default values for the attributes.
           **pthread_condattr_destroy**() destroys a condition attribute object,
           which must not be reused until it is reinitialized.  Both
           functions do nothing in the LinuxThreads implementation.
    


## RETURN VALUE



           **pthread_condattr_init**() and **pthread_condattr_destroy**() always
           return 0.
    


* * *
# gnutls_session_enable_compatibility_mode

## NAME



           gnutls_session_enable_compatibility_mode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_enable_compatibility_mode(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function can be used to disable certain (security) features
           in TLS in order to maintain maximum compatibility with buggy
           clients. Because several trade-offs with security are enabled, if
           required they will be reported through the audit subsystem.
    
           Normally only servers that require maximum compatibility with
           everything out there, need to call this function.
    
           Note that this function must be called after any call to
           gnutls_priority functions.
    


## SINCE



           2.1.4
    


* * *
# atof

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



           atof — convert a string to a double-precision number
    


## SYNOPSIS



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


## 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 call _atof_(_str_) shall be equivalent to:
    
               strtod(_str_ ,(char **)NULL),
    
           except that the handling of errors may differ. If the value cannot
           be represented, the behavior is undefined.
    


## RETURN VALUE



           The _atof_() function shall return the converted value if the value
           can be represented.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _atof_() function is subsumed by _strtod_() but is retained
           because it is used extensively in existing code. If the number is
           not known to be in range, _strtod_() should be used because _atof_()
           is not required to perform any error checking.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::nfs.proc.rename_setup

## NAME



           probe::nfs.proc.rename_setup - NFS client setting up a rename RPC
           task
    


## SYNOPSIS



           nfs.proc.rename_setup
    


## VALUES



           _server_ip_
               IP address of server
    
           _fh_
               file handle of parent dir
    
           _prot_
               transfer protocol
    
           _version_
               NFS version
    


## DESCRIPTION



           The rename_setup function is used to setup a rename RPC task. Is
           is not doing the actual rename operation.
    


* * *
# wcstoimax

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



           wcstoimax, wcstoumax — convert a wide-character string to an
           integer type
    


## SYNOPSIS



           #include <stddef.h>
           #include <inttypes.h>
    
           intmax_t wcstoimax(const wchar_t *restrict _nptr_ ,
               wchar_t **restrict _endptr_ , int _base_);
           uintmax_t wcstoumax(const wchar_t *restrict _nptr_ ,
               wchar_t **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 _wcstol_(), _wcstoll_(),
           _wcstoul_(), and _wcstoull_() functions, respectively, except that the
           initial portion of the wide 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. 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



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs11_privkey_export_pubkey

## NAME



           gnutls_pkcs11_privkey_export_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_export_pubkey(gnutls_pkcs11_privkey_t**
           _pkey_**, gnutls_x509_crt_fmt_t** _fmt_**, gnutls_datum_t ***_data_**, unsigned**
           **int** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t pkey
                       The private key
    
           gnutls_x509_crt_fmt_t fmt
                       the format of output params. PEM or DER.
    
           gnutls_datum_t * data
                       will hold the public key
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will extract the public key (modulus and public
           exponent) from the private key specified by the  _url_ private key.
           This public key will be stored in  _pubkey_ in the format specified
           by  _fmt_ .  _pubkey_ should be deinitialized using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.3.7
    


* * *
# function::read_stopwatch_us

## NAME



           function::read_stopwatch_us - Reads the time in microseconds for a
           stopwatch
    


## SYNOPSIS



               read_stopwatch_us:long(name:string)
    


## ARGUMENTS



           _name_
               stopwatch name
    


## DESCRIPTION



           Returns time in microseconds for stopwatch _name_. Creates stopwatch
           _name_ if it does not currently exist.
    


* * *
# probe::ioscheduler_trace.elv_requeue_request

## NAME



           probe::ioscheduler_trace.elv_requeue_request - Fires when a
           request is
    


## SYNOPSIS



           ioscheduler_trace.elv_requeue_request
    


## VALUES



           _disk_major_
               Disk major no of request.
    
           _rq_flags_
               Request flags.
    
           _disk_minor_
               Disk minor number of request.
    
           _elevator_name_
               The type of I/O elevator currently enabled.
    
           _name_
               Name of the probe point
    
           _rq_
               Address of request.
    


## DESCRIPTION



           put back on the queue, when the hadware cannot accept more
           requests.
    


* * *
# gnutls_psk_free_server_credentials

## NAME



           gnutls_psk_free_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_free_server_credentials(gnutls_psk_server_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t sc
                       is a **gnutls_psk_server_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_psk_server_credentials_t structure.
    


* * *
# gnutls_memcmp

## NAME



           gnutls_memcmp - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_memcmp(const void ***_s1_**, const void ***_s2_**, size_t** _n_**);**
    


## ARGUMENTS



           const void * s1
                       the first address to compare
    
           const void * s2
                       the second address to compare
    
           size_t n    the size of memory to compare
    


## DESCRIPTION



           This function will operate similarly to **memcmp()** , but will operate
           on time that depends only on the size of the string. That is will
           not return early if the strings don't match on the first byte.
    


## RETURNS



           non zero on difference and zero if the buffers are identical.
    


## SINCE



           3.4.0
    


* * *
# wmemchr

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



           wmemchr — find a wide character in memory
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wmemchr(const wchar_t *_ws_ , wchar_t _wc_ , size_t _n_);
    


## 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 _wmemchr_() function shall locate the first occurrence of _wc_ in
           the initial _n_ wide characters of the object pointed to by _ws_.
           This function shall not be affected by locale and all **wchar_t**
           values shall be treated identically. The null wide character and
           **wchar_t** values not corresponding to valid characters shall not be
           treated specially.
    
           If _n_ is zero, the application shall ensure that _ws_ is a valid
           pointer and the function behaves as if no valid occurrence of _wc_
           is found.
    


## RETURN VALUE



           The _wmemchr_() function shall return a pointer to the located wide
           character, or a null pointer if the wide character does not occur
           in the object.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# aio_init

## NAME



           aio_init - asynchronous I/O initialization
    


## LIBRARY



           Real-time library (_librt_ , _-lrt_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <aio.h>**
    
           **void aio_init(const struct aioinit ***_init_**);**
    


## DESCRIPTION



           The GNU-specific **aio_init**() function allows the caller to provide
           tuning hints to the glibc POSIX AIO implementation.  Use of this
           function is optional, but to be effective, it must be called
           before employing any other functions in the POSIX AIO API.
    
           The tuning information is provided in the buffer pointed to by the
           argument _init_.  This buffer is a structure of the following form:
    
               struct aioinit {
                   int aio_threads;    /* Maximum number of threads */
                   int aio_num;        /* Number of expected simultaneous
                                          requests */
                   int aio_locks;      /* Not used */
                   int aio_usedba;     /* Not used */
                   int aio_debug;      /* Not used */
                   int aio_numusers;   /* Not used */
                   int aio_idle_time;  /* Number of seconds before idle thread
                                          terminates (since glibc 2.2) */
                   int aio_reserved;
               };
    
           The following fields are used in the _aioinit_ structure:
    
           _aio_threads_
                  This field specifies the maximum number of worker threads
                  that may be used by the implementation.  If the number of
                  outstanding I/O operations exceeds this limit, then excess
                  operations will be queued until a worker thread becomes
                  free.  If this field is specified with a value less than 1,
                  the value 1 is used.  The default value is 20.
    
           _aio_num_
                  This field should specify the maximum number of
                  simultaneous I/O requests that the caller expects to
                  enqueue.  If a value less than 32 is specified for this
                  field, it is rounded up to 32.  The default value is 64.
    
           _aio_idle_time_
                  This field specifies the amount of time in seconds that a
                  worker thread should wait for further requests before
                  terminating, after having completed a previous request.
                  The default value is 1.
    


## STANDARDS



           GNU.
    


* * *
# function::pstrace

## NAME



           function::pstrace - Chain of processes and pids back to init(1)
    


## SYNOPSIS



               pstrace:string(task:long)
    


## ARGUMENTS



           _task_
               Pointer to task struct of process
    


## DESCRIPTION



           This function returns a string listing execname and pid for each
           process starting from _task_ back to the process ancestor that
           init(1) spawned.
    


* * *
# shmdt

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



           shmdt — XSI shared memory detach operation
    


## SYNOPSIS



           #include <sys/shm.h>
    
           int shmdt(const void *_shmaddr_);
    


## DESCRIPTION



           The _shmdt_() function operates on XSI shared memory (see the Base
           Definitions volume of POSIX.1‐2017, _Section 3.346_ , _Shared Memory_
           _Object_).  It is unspecified whether this function interoperates
           with the realtime interprocess communication facilities defined in
           _Section 2.8_ , _Realtime_.
    
           The _shmdt_() function detaches the shared memory segment located at
           the address specified by _shmaddr_ from the address space of the
           calling process.
    


## RETURN VALUE



           Upon successful completion, _shmdt_() shall decrement the value of
           _shm_nattch_ in the data structure associated with the shared memory
           ID of the attached shared memory segment and return 0. Also, the
           _shm_dtime_ timestamp shall be set to the current time, as described
           in _Section 2.7.1_ , _IPC General Description_.
    
           Otherwise, the shared memory segment shall not be detached,
           _shmdt_() shall return -1, and _errno_ shall be set to indicate the
           error.
    


## ERRORS



           The _shmdt_() function shall fail if:
    
           **EINVAL** The value of _shmaddr_ is not the data segment start address
                  of a shared memory segment.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The POSIX Realtime Extension defines alternative interfaces for
           interprocess communication. Application developers who need to use
           IPC should design their applications so that modules using the IPC
           routines described in _Section 2.7_ , _XSI Interprocess Communication_
           can be easily modified to use the alternative interfaces.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::netdev.ioctl

## NAME



           probe::netdev.ioctl - Called when the device suffers an IOCTL
    


## SYNOPSIS



           netdev.ioctl
    


## VALUES



           _cmd_
               The IOCTL request
    
           _arg_
               The IOCTL argument (usually the netdev interface)
    


* * *
# gnutls_x509_crl_iter_deinit

## NAME



           gnutls_x509_crl_iter_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crl_iter_deinit(gnutls_x509_crl_iter_t** _iter_**);**
    


## ARGUMENTS



           gnutls_x509_crl_iter_t iter
                       The iterator to be deinitialized
    


## DESCRIPTION



           This function will deinitialize an iterator type.
    


* * *
# textdomain

## NAME



           textdomain - set domain for future gettext() calls
    


## SYNOPSIS



           **#include <libintl.h>**
    
           **char * textdomain (const char ***_domainname_**);**
    


## DESCRIPTION



           The **textdomain** function sets or retrieves the current message
           domain.
    
           A message domain is a set of translatable _msgid_ messages. Usually,
           every software package has its own message domain. The domain name
           is used to determine the message catalog where a translation is
           looked up; it must be a non-empty string.
    
           The current message domain is used by the **gettext** , **ngettext**
           functions, and by the **dgettext** , **dcgettext** , **dngettext** and
           **dcngettext** functions when called with a NULL domainname argument.
    
           If _domainname_ is not NULL, the current message domain is set to
           _domainname_. The string the function stores internally is a copy of
           the _domainname_ argument.
    
           If _domainname_ is NULL, the function returns the current message
           domain.
    


## RETURN VALUE



           If successful, the **textdomain** function returns the current message
           domain, after possibly changing it. The resulting string is valid
           until the next **textdomain** call and must not be modified or freed.
           If a memory allocation failure occurs, it sets **errno** to **ENOMEM** and
           returns NULL.
    


## ERRORS



           The following error can occur, among others:
    
           **ENOMEM** Not enough memory available.
    


## BUGS



           The return type ought to be **const char *** , but is **char *** to avoid
           warnings in C code predating ANSI C.
    


* * *
# fseeko

## NAME



           fseeko, ftello - seek to or report file position
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **int fseeko(FILE ***_stream_**, off_t** _offset_**, int** _whence_**);**
           **off_t ftello(FILE ***_stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fseeko**(), **ftello**():
               _FILE_OFFSET_BITS == 64 || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           The **fseeko**() and **ftello**() functions are identical to fseek(3) and
           ftell(3) (see fseek(3)), respectively, except that the _offset_
           argument of **fseeko**() and the return value of **ftello**() is of type
           _off_t_ instead of _long_.
    
           On some architectures, both _off_t_ and _long_ are 32-bit types, but
           defining **_FILE_OFFSET_BITS** with the value 64 (before including _any_
           header files) will turn _off_t_ into a 64-bit type.
    


## RETURN VALUE



           On successful completion, **fseeko**() returns 0, while **ftello**()
           returns the current offset.  Otherwise, -1 is returned and _errno_
           is set to indicate the error.
    


## ERRORS



           See the ERRORS in fseek(3).
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The declarations of these functions can also be obtained by
           defining the obsolete **_LARGEFILE_SOURCE** feature test macro.
    


* * *
# setenv

## NAME



           setenv - change or add an environment variable
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int setenv(const char ***_name_**, const char ***_value_**, int** _overwrite_**);**
           **int unsetenv(const char ***_name_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **setenv**(), **unsetenv**():
               _POSIX_C_SOURCE >= 200112L
                   || /* glibc <= 2.19: */ _BSD_SOURCE
    


## DESCRIPTION



           The **setenv**() function adds the variable _name_ to the environment
           with the value _value_ , if _name_ does not already exist.  If _name_
           does exist in the environment, then its value is changed to _value_
           if _overwrite_ is nonzero; if _overwrite_ is zero, then the value of
           _name_ is not changed (and **setenv**() returns a success status).  This
           function makes copies of the strings pointed to by _name_ and _value_
           (by contrast with putenv(3)).
    
           The **unsetenv**() function deletes the variable _name_ from the
           environment.  If _name_ does not exist in the environment, then the
           function succeeds, and the environment is unchanged.
    


## RETURN VALUE



           **setenv**() and **unsetenv**() functions return zero on success, or -1 on
           error, with _errno_ set to indicate the error.
    


## ERRORS



           **EINVAL** _name_ is NULL, points to a string of length 0, or contains
                  an '=' character.
    
           **ENOMEM** Insufficient memory to add a new variable to the
                  environment.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## CAVEATS



           POSIX.1 does not require **setenv**() or **unsetenv**() to be reentrant.
    


## BUGS



           POSIX.1 specifies that if _name_ contains an '=' character, then
           **setenv**() should fail with the error **EINVAL** ; however, versions of
           glibc before glibc 2.3.4 allowed an '=' sign in _name_.
    


* * *
# io_uring_submit_and_wait

## NAME



           io_uring_submit_and_wait - submit requests to the submission queue
           and wait for completion
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_submit_and_wait(struct io_uring ***_ring_**,**
                                        **unsigned** _wait_nr_**);**
    


## DESCRIPTION



           The io_uring_submit_and_wait(3) function submits the next requests
           from the submission queue belonging to the _ring_ and waits for
           _wait_nr_ completion events.
    
           After the caller retrieves a submission queue entry (SQE) with
           io_uring_get_sqe(3) and prepares the SQE, it can be submitted with
           io_uring_submit_and_wait(3).
    
           Ideally used with a ring setup with
           **IORING_SETUP_SINGLE_ISSUER** |**IORING_SETUP_DEFER_TASKRUN** as that will
           greatly reduce the number of context switches that an application
           will see waiting on multiple requests.
    


## RETURN VALUE



           On success io_uring_submit_and_wait(3) returns the number of
           submitted submission queue entries. On failure it returns **-errno**.
    


* * *
# iswupper

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



           iswupper, iswupper_l — test for an uppercase letter wide-character
           code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswupper(wint_t _wc_);
           int iswupper_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswupper_(): 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 _iswupper_() and _iswupper_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **upper** in
           the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswupper_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswupper_() and _iswupper_l_() functions shall return non-zero if
           _wc_ is an uppercase letter wide-character code; otherwise, they
           shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# wcspbrk

## NAME



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


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcspbrk(const wchar_t ***_wcs_**, const wchar_t ***_accept_**);**
    


## DESCRIPTION



           The **wcspbrk**() function is the wide-character equivalent of the
           strpbrk(3) function.  It searches for the first occurrence in the
           wide-character string pointed to by _wcs_ of any of the characters
           in the wide-character string pointed to by _accept_.
    


## RETURN VALUE



           The **wcspbrk**() function returns a pointer to the first occurrence
           in _wcs_ of any of the characters listed in _accept_.  If _wcs_ contains
           none of these characters, NULL is returned.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::set_kernel_string_n

## NAME



           function::set_kernel_string_n - Writes a string of given length to
           kernel memory
    


## SYNOPSIS



               set_kernel_string_n(addr:long,n:long,val:string)
    


## ARGUMENTS



           _addr_
               The kernel address to write the string to
    
           _n_
               The maximum length of the string
    
           _val_
               The string which is to be written
    


## DESCRIPTION



           Writes the given string up to a maximum given length to a given
           kernel memory address. Reports an error on string copy fault.
           Requires the use of guru mode (-g).
    


* * *
# pmfreeprofile

## NAME



           **__pmFreeProfile** - free a PMAPI instance profile
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **void __pmFreeProfile(pmProfile ***_prof_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           **__pmFreeProfile** frees the storage for the PMAPI  instance  profile
           _prof_ , assuming the storage was allocated using malloc(3) according
           to the scheme used in **__pmDecodeProfile**(3).
    


* * *