tripathysagar/man_text huggingface dataset:
# pmaundeltaindom

## NAME



           **pmaUndeltaInDom** - find ``full'' instance domain matching a
           ``delta'' instance domain
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **__pmLogInDom *pmaUndeltaInDom(__pmLogCtl ***_lcp_**, __int32_t ***_buf_**);**
    
           **cc ... -lpcp_archive -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



           Find the loaded ``full'' instance domain that matches a  ``delta''
           instance domain.
    
           The  caller ensures the physical metadata record for the ``delta''
           instance domain has been read into _buf_.   The  associated  archive
           control  structure  is  identified by _lcp_ , which implies the input
           archive has also been opened with pmNewContext(3).
    
           **pmaUndeltaInDom** starts by extracting the  timestamp  and  the  in‐
           stance  domain  number for the ``delta'' instance domain from _buf_.
           With this information, **__pmLogSearchInDom**(3) is called to find the
           matching loaded instance domain, which will  have  been  converted
           from  a ``delta'' instance domain to a ``full'' instance domain in
           the process.
    
           **pmaUndeltaInDom** is most useful for applications that read physical
           metadata records and need to operate on ``full'' instance domains,
           rather than the ``delta'' instance domains that occur in Version 3
           archives.
    


## DIAGNOSTICS AND RETURN VALUES



           Lots of warning babble if the matching loaded instance domain can‐
           not be found, and the return value is NULL in this case.
    


* * *
# pcre2_get_match_data_size

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **PCRE2_SIZE pcre2_get_match_data_size(pcre2_match_data ***_match_data_**);**
    


## DESCRIPTION



    
           This function returns the size, in bytes, of the match data block
           that is its argument.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# wcstoumax

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



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


## SYNOPSIS



           #include <stddef.h>
           #include <inttypes.h>
    
           uintmax_t wcstoumax(const wchar_t *restrict _nptr_ ,
               wchar_t **restrict _endptr_ , int _base_);
    


## DESCRIPTION



           Refer to wcstoimax(3p).
    


* * *
# curs_delch

## NAME



           **delch** , **wdelch** , **mvdelch** , **mvwdelch** - delete character under the
           cursor in a **curses** window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int delch(void);**
           **int wdelch(WINDOW ***_win_**);**
           **int mvdelch(int** _y_**, int** _x_**);**
           **int mvwdelch(WINDOW ***_win_**, int** _y_**, int** _x_**);**
    


## DESCRIPTION



           These routines delete the character under the cursor; all
           characters to the right of the cursor on the same line are moved
           to the left one position and the last character on the line is
           filled with a blank.  The cursor position does not change (after
           moving to _y_ , _x_ , if specified).  (This does not imply use of the
           hardware delete character feature.)
    


## RETURN VALUE



           All routines return the integer **ERR** upon failure and an **OK**(SVr4
           specifies only "an integer value other than **ERR** ") upon successful
           completion.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


## NOTES



           Note that **delch** , **mvdelch** , and **mvwdelch** may be macros.
    


## PORTABILITY



           These functions are described in the XSI Curses standard, Issue 4.
           The standard specifies that they return **ERR** on failure, but
           specifies no error conditions.
    


* * *
# gnutls_alert_send

## NAME



           gnutls_alert_send - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_alert_send(gnutls_session_t** _session_**,**
           **gnutls_alert_level_t** _level_**, gnutls_alert_description_t** _desc_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_alert_level_t level
                       is the level of the alert
    
           gnutls_alert_description_t desc
                       is the alert description
    


## DESCRIPTION



           This function will send an alert to the peer in order to inform
           him of something important (eg. his Certificate could not be
           verified).  If the alert level is Fatal then the peer is expected
           to close the connection, otherwise he may ignore the alert and
           continue.
    
           The error code of the underlying record send function will be
           returned, so you may also receive **GNUTLS_E_INTERRUPTED** or
           **GNUTLS_E_AGAIN** as well.
    


## RETURNS



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


* * *
# isblank

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



           isblank, isblank_l — test for a blank character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isblank(int _c_);
           int isblank_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isblank_(): 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 _isblank_() and _isblank_l_() functions shall test whether _c_ is a
           character of class **blank** 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 _c_ argument is a type **int** , the value of which the application
           shall ensure is a character representable as an **unsigned char** or
           equal to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isblank_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isblank_() and _isblank_l_() functions shall return non-zero if _c_
           is a <blank>; 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.
    


* * *
# capng_get_caps_fd

## NAME



           capng_get_caps_fd - read file-based capabilities from extended
           attributes
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_get_caps_fd(int fd);
    


## DESCRIPTION



           This function will read the file based capabilities stored in
           extended attributes of the file that the descriptor was opened
           against. The bounding set is not included in file based
           capabilities operations. Note that this function will only work if
           compiled on a kernel that supports file based capabilities such as
           2.6.26 and later. If the "magic" bit is set, then all effect
           capability bits are set. Otherwise the bits are cleared.
    


## RETURN VALUE



           This returns 0 on success and -1 on failure.
    


* * *
# gnutls_x509_policies_get

## NAME



           gnutls_x509_policies_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_policies_get(gnutls_x509_policies_t** _policies_**,**
           **unsigned int** _seq_**, struct gnutls_x509_policy_st ***_policy_**);**
    


## ARGUMENTS



           gnutls_x509_policies_t policies
                       The policies
    
           unsigned int seq
                       The index of the name to get
    
           struct gnutls_x509_policy_st * policy
                       Will hold the policy
    


## DESCRIPTION



           This function will return a specific policy as stored in the
           _policies_ type. The returned values should be treated as constant
           and valid for the lifetime of  _policies_ .
    
           The any policy OID is available as the **GNUTLS_X509_OID_POLICY_ANY**
           macro.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the index is out of
           bounds, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# function::strpos

## NAME



           function::strpos - Returns location of a substring within another
           string
    


## SYNOPSIS



               strpos:long(s1:string,s2:string)
    


## ARGUMENTS



           _s1_
               string to search in
    
           _s2_
               substring to find
    


## DESCRIPTION



           This function returns location of the first occurence of string _s2_
           within _s1_ , namely the return value is 0 in case _s2_ is a prefix of
           _s1_. If _s2_ is not a substring of _s1_ , then the return value is -1.
    


* * *
# pmwebtimerregister

## NAME



           **pmWebTimerRegister** , **pmWebTimerRelease** , **pmWebTimerSetMetricRegistry**
           - thread-safe timer list management
    


## C SYNOPSIS



           **#include <pcp/pmwebapi.h>**
    
           **typedef void (*pmWebTimerCallBack)(void ***_data_**);**
           **int pmWebTimerRegister(pmWebTimerCallBack** _callback_**, void ***_data_**);**
    
           **int pmWebTimerRelease(int** _seq_**);**
           **int pmWebTimerSetMetricRegistry(struct mmv_registry ***_registry_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           The  **pmWebTimerRegister** and related API functions provide a conve‐
           nient thread-safe API for applications to manage a list  of  timer
           driven  callbacks.   On  the  first  call to **pmWebTimerRegister** or
           **pmWebTimerSetMetricRegistry** , an internal timer is set up and  ini‐
           tialized  to  fire  every 1.0 seconds.  Each time the timer fires,
           all currently registered _callback_ functions will be called serial‐
           ly with the opaque _data_ pointer that was supplied when each  func‐
           tion  was  registered.   The _pmWebTimerCallBack_ typedef provides a
           suitable callback function prototype.
    
           All registered _callback_ functions should be non-blocking and  exe‐
           cute  quickly  and  synchronously.  Typical _callback_ functions in‐
           clude refreshing instrumentation, calculating and updating perfor‐
           mance metric values, periodic garbage collection and any other lo‐
           cal function that requires regular execution.
    
           The **pmWebTimerSetMetricRegistry** function provides a convenient way
           for an application to pass in a pointer to an  **libpcp_mmv**(3)  _reg‐_
           _istry_  that  has been suitably initialized by the calling applica‐
           tion.  This _registry_ will be used to dynamically create six server
           resource   metrics   named    _NAME_**.mem.datasz** ,    _NAME_**.mem.maxrss** ,
           _NAME_**.cpu.total** ,  _NAME_**.cpu.sys** ,  _NAME_**.cpu.user** and _NAME_**.pid** , where
           _NAME_ is the root PCP **PMNS(5)** name set up by the  calling  applica‐
           tion.   These  metrics should be reasonably self explanatory; they
           provide resource usage metrics  from  the  calling  application  /
           server and use getrusage(2), times(2) and getpid(2).
    


## RETURN VALUE



           The  **pmWebTimerRegister** function returns a positive integer handle
           that may be subsequently used in a call  to  **pmWebTimerRelease** to
           remove  a timer from the internal timer list.  When a timer is re‐
           moved with a call to **pmWebTimerRelease** , the internal  data  struc‐
           tures  are  freed.  The caller however, is responsible for freeing
           the associated **data**(since it may or may not be dynamically  allo‐
           cated).
    


## DIAGNOSTICS



           On failure a negative PMAPI error code is returned in all cases.
    


* * *
# gnutls_privkey_deinit

## NAME



           gnutls_privkey_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **void gnutls_privkey_deinit(gnutls_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       The key to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a private key structure.
    


## SINCE



           2.12.0
    


* * *
# selinux_restorecon_set_exclude_list

## NAME



           selinux_restorecon_set_exclude_list - set list of directories to
           be excluded from relabeling.
    


## SYNOPSIS



           **#include <selinux/restorecon.h>**
    
           **void selinux_restorecon_set_exclude_list(const char**
           ******_exclude_list_**);**
    


## DESCRIPTION



           **selinux_restorecon_set_exclude_list**() passes to
           selinux_restorecon(3) a pointer containing a **NULL** terminated list
           of one or more directories that are not to be relabeled in
           _exclude_list_.
    
           **selinux_restorecon_set_exclude_list**() must be called prior to
           selinux_restorecon(3).
    


* * *
# re_comp

## NAME



           re_comp, re_exec - BSD regex functions
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _REGEX_RE_COMP**
           **#include <sys/types.h>**
           **#include <regex.h>**
    
           **[[deprecated]] char *re_comp(const char ***_regex_**);**
           **[[deprecated]] int re_exec(const char ***_string_**);**
    


## DESCRIPTION



           **re_comp**() is used to compile the null-terminated regular
           expression pointed to by _regex_.  The compiled pattern occupies a
           static area, the pattern buffer, which is overwritten by
           subsequent use of **re_comp**().  If _regex_ is NULL, no operation is
           performed and the pattern buffer's contents are not altered.
    
           **re_exec**() is used to assess whether the null-terminated string
           pointed to by _string_ matches the previously compiled _regex_.
    


## RETURN VALUE



           **re_comp**() returns NULL on successful compilation of _regex_
           otherwise it returns a pointer to an appropriate error message.
    
           **re_exec**() returns 1 for a successful match, zero for failure.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# conj

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



           conj, conjf, conjl — complex conjugate functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex conj(double complex _z_);
           float complex conjf(float complex _z_);
           long double complex conjl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex conjugate of _z_ , by
           reversing the sign of its imaginary part.
    


## RETURN VALUE



           These functions return the complex conjugate value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pfm_get_event_next

## NAME



           pfm_get_event_next - iterate over events
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **int pfm_get_event_next(int** _idx_**);**
    


## DESCRIPTION



           Events are uniquely identified with opaque integer identifiers.
           There is no guaranteed order within identifiers. Thus, to list all
           the events, it is necessary to use iterators.
    
           Events are grouped in tables within the library. A table usually
           corresponds to a PMU model or family. The library contains support
           for multiple PMU models, thus it has multiple tables. Based on the
           host hardware and software environments, tables get activated when
           the library is initialized via **pfm_initialize()**. Events from
           activated tables are called active events. Events from non-
           activated tables are called supported events.
    
           Event identifiers are usually retrieved via **pfm_find_event()** or
           when encoding events.
    
           To iterate over a list of events for a given PMU model, all that
           is needed is an initial identifier for the PMU. The first event
           identifier is usually obtained via **pfm_get_pmu_info()**.
    
           The **pfm_get_event_next()** function returns the identifier of next
           supported event after the one passed in **idx**. This iterator stops
           when the last event for the PMU is passed as argument, in which
           case the function returns -1.
    
           void list_pmu_events(pfm_pmu_t pmu)
           {
              struct pfm_event_info info;
              struct pfm_pmu_info pinfo;
              int i, ret;
    
              memset(&info, 0, sizeof(info));
              memset(&pinfo, 0, sizeof(pinfo));
    
              info.size = sizeof(info);
              pinfo.size = sizeof(pinfo);
    
              ret = pfm_get_pmu_info(pmu, &pinfo);
              if (ret != PFM_SUCCESS)
                 errx(1, "cannot get pmu info");
    
              for (i = pinfo.first_event; i != -1; i = pfm_get_event_next(i)) {
                 ret = pfm_get_event_info(i, &info);
                 if (ret != PFM_SUCCESS)
                   errx(1, "cannot get event info");
    
                   printf("%s Event: %s::%s\n",
                          pinfo.present ? "Active" : "Supported",
                          pinfo.name, info.name);
             }
           }
    


## RETURN



           The function returns the identifier of the next supported event.
           It returns -1 when the argument is already the last event for the
           PMU.
    


## ERRORS



           No error code, besides -1, is returned by this function.
    


* * *
# function::user_int_error

## NAME



           function::user_int_error - Retrieves an int value stored in user
           space
    


## SYNOPSIS



               user_int_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the int from
    


## DESCRIPTION



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


* * *
# io_uring_prep_write

## NAME



           io_uring_prep_write - prepare I/O write request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_write(struct io_uring_sqe ***_sqe_**,**
                                    **int** _fd_**,**
                                    **const void ***_buf_**,**
                                    **unsigned** _nbytes_**,**
                                    **__u64** _offset_**);**
    


## DESCRIPTION



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


## RETURN VALUE



           None
    


## ERRORS



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


* * *
# updwtmp

## NAME



           updwtmp, logwtmp - append an entry to the wtmp file
    


## LIBRARY



           System utilities library (_libutil_ , _-lutil_)
    


## SYNOPSIS



           **#include <utmp.h>**
    
           **void updwtmp(const char ***_wtmp_path_**, const struct utmp ***_ut_**);**
           **void logwtmp(const char ***_line_**, const char ***_name_**, const char ***_host_**);**
    


## DESCRIPTION



           **updwtmp**() appends the utmp structure _ut_ to the wtmp file.
    
           **logwtmp**() constructs a utmp structure using _line_ , _name_ , _host_ ,
           current time, and current process ID.  Then it calls **updwtmp**() to
           append the structure to the wtmp file.
    


## FILES



           _/var/log/wtmp_
                  database of past user logins
    


## ATTRIBUTES



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


## VERSIONS



           For consistency with the other "utmpx" functions (see
           getutxent(3)), glibc provides (since glibc 2.1):
    
               **#define _GNU_SOURCE** /* See feature_test_macros(7) */
               **#include <utmpx.h>**
               **void updwtmpx (const char ***_wtmpx_path_**, const struct utmpx ***_utx_**);**
    
           This function performs the same task as **updwtmp**(), but differs in
           that it takes a _utmpx_ structure as its last argument.
    


## STANDARDS



           None.
    


* * *
# function::strtol

## NAME



           function::strtol - strtol - Convert a string to a long
    


## SYNOPSIS



               strtol:long(str:string,base:long)
    


## ARGUMENTS



           _str_
               string to convert
    
           _base_
               the base to use
    


## DESCRIPTION



           This function converts the string representation of a number to an
           integer. The _base_ parameter indicates the number base to assume
           for the string (eg. 16 for hex, 8 for octal, 2 for binary).
    


* * *
# acl_init

## NAME



           **acl_init** — initialize ACL working storage
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _acl_t_ **acl_init**(_int count_)
    


## DESCRIPTION



           The **acl_init**() function allocates and initializes the working
           storage for an ACL of at least _count_ ACL entries.  The ACL created
           initially contains no ACL entries.  A pointer to the working
           storage is returned.
    
           This function may cause memory to be allocated.  The caller should
           free any releasable memory, when the new ACL is no longer
           required, by calling _acl_free_(3) with the _(void*)acl_t_ returned by
           **acl_init**() as an argument.
    


## RETURN VALUE



           On success, this function returns a pointer to the working
           storage.  On error, a value of **(acl_t)NULL** is returned, and _errno_
           is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_init**() function
           returns a value of **(acl_t)NULL** and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The value of count is less than zero.
    
           [ENOMEM]           The _acl_t_ to be returned requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    


## STANDARDS



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


* * *
# pmid_helper

## NAME



           **pmID_build** , **pmID_domain** , **pmID_cluster** , **pmID_item** - helper methods
           for manipulating PMIDs
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **pmID pmID_build(unsigned int** _domain_**, unsigned int** _cluster_**,**
                           **unsigned int** _item_**);**
           **unsigned int pmID_domain(pmID** _pmid_**);**
           **unsigned int pmID_cluster(pmID** _pmid_**);**
           **unsigned int pmID_item(pmID** _pmid_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Within  the  Performance  Co-Pilot (PCP) each metric is assigned a
           unique Performance Metric Identifier (pmID).  Internally a pmID is
           constructed from 3 fields: the domain number  (of  the  associated
           Performance Metrics Domain Agent, or PMDA), the cluster number and
           the item number (the last two are assigned by the PMDA).
    
           **pmID_build** constructs a pmID from _domain_ , _cluster_ and _item_.
    
           **pmID_domain** ,  **pmID_cluster** and  **pmID_item** return  the respective
           fields from _pmid_.
    


* * *
# carg

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



           carg, cargf, cargl — complex argument functions
    


## SYNOPSIS



           #include <complex.h>
    
           double carg(double complex _z_);
           float cargf(float complex _z_);
           long double cargl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the argument (also called phase
           angle) of _z_ , with a branch cut along the negative real axis.
    


## RETURN VALUE



           These functions shall return the value of the argument in the
           interval [-π, +π].
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# btowc

## NAME



           btowc - convert single byte to wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wint_t btowc(int** _c_**);**
    


## DESCRIPTION



           The **btowc**() function converts _c_ , interpreted as a multibyte
           sequence of length 1, starting in the initial shift state, to a
           wide character and returns it.  If _c_ is **EOF** or not a valid
           multibyte sequence of length 1, the **btowc**() function returns **WEOF**.
    


## RETURN VALUE



           The **btowc**() function returns the wide character converted from the
           single byte _c_.  If _c_ is **EOF** or not a valid multibyte sequence of
           length 1, it returns **WEOF**.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **btowc**() depends on the **LC_CTYPE** category of the
           current locale.
    
           This function should never be used.  It does not work for
           encodings which have state, and unnecessarily treats single bytes
           differently from multibyte sequences.  Use either mbtowc(3) or the
           thread-safe mbrtowc(3) instead.
    


* * *
# ccos

## NAME



           ccos, ccosf, ccosl - complex cosine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex ccos(double complex** _z_**);**
           **float complex ccosf(float complex** _z_**);**
           **long double complex ccosl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex cosine of _z_.
    
           The complex cosine function is defined as:
    
               ccos(z) = (exp(i * z) + exp(-i * z)) / 2
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_x509_crt_set_issuer_alt_name

## NAME



           gnutls_x509_crt_set_issuer_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_issuer_alt_name(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_subject_alt_name_t** _type_**, const void ***_data_**, unsigned**
           **int** _data_size_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_subject_alt_name_t type
                       is one of the gnutls_x509_subject_alt_name_t
                       enumerations
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The size of data to be set
    
           unsigned int flags
                       GNUTLS_FSAN_SET to clear previous data or
                       GNUTLS_FSAN_APPEND to append.
    


## DESCRIPTION



           This function will set the issuer alternative name certificate
           extension. It can set the same types as
           **gnutls_x509_crt_set_subject_alt_name()**.
    
           Since version 3.5.7 the **GNUTLS_SAN_RFC822NAME** , **GNUTLS_SAN_DNSNAME** ,
           and **GNUTLS_SAN_OTHERNAME_XMPP** are converted to ACE format when
           necessary.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_global_set_audit_log_function

## NAME



           gnutls_global_set_audit_log_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_set_audit_log_function(gnutls_audit_log_func**
           _log_func_**);**
    


## ARGUMENTS



           gnutls_audit_log_func log_func
                       it is the audit log function
    


## DESCRIPTION



           This is the function to set the audit logging function. This is a
           function to report important issues, such as possible attacks in
           the protocol. This is different from
           **gnutls_global_set_log_function()** because it will report also
           session-specific events. The session parameter will be null if
           there is no corresponding TLS session.
    
            _gnutls_audit_log_func_ is of the form, void
           (*gnutls_audit_log_func)( gnutls_session_t, const char*);
    


## SINCE



           3.0
    


* * *
# gnutls_system_key_add_x509

## NAME



           gnutls_system_key_add_x509 - API function
    


## SYNOPSIS



           **#include <gnutls/system-keys.h>**
    
           **int gnutls_system_key_add_x509(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_privkey_t** _privkey_**, const char ***_label_**, char ****
           _cert_url_**, char ****_key_url_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       the certificate to be added
    
           gnutls_x509_privkey_t privkey
                       the key to be added
    
           const char * label
                       the friendly name to describe the key
    
           char ** cert_url
                       if non-NULL it will contain an allocated value with
                       the certificate URL
    
           char ** key_url
                       if non-NULL it will contain an allocated value with
                       the key URL
    


## DESCRIPTION



           This function will added the given key and certificate pair, to
           the system list.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# creal

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



           creal, crealf, creall — complex real functions
    


## SYNOPSIS



           #include <complex.h>
    
           double creal(double complex _z_);
           float crealf(float complex _z_);
           long double creall(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the real part of _z_.
    


## RETURN VALUE



           These functions shall return the real part value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           For a variable _z_ of type **complex** :
    
               z == creal(z) + cimag(z)*I
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# putc

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



           putc — put a byte on a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int putc(int _c_ , FILE *_stream_);
    


## 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 _putc_() function shall be equivalent to _fputc_(), except that if
           it is implemented as a macro it may evaluate _stream_ more than
           once, so the argument should never be an expression with side-
           effects.
    


## RETURN VALUE



           Refer to fputc(3p).
    


## ERRORS



           Refer to fputc(3p).
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Since it may be implemented as a macro, _putc_() may treat a _stream_
           argument with side-effects incorrectly. In particular,
           _putc_(_c_ ,*_f_ ++) does not necessarily work correctly.  Therefore, use
           of this function is not recommended in such situations; _fputc_()
           should be used instead.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_deinit

## NAME



           gnutls_deinit - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function clears all buffers associated with the  _session_ .
           This function will also remove session data from the session
           database if the session was terminated abnormally.
    


* * *
# gnutls_handshake_set_timeout

## NAME



           gnutls_handshake_set_timeout - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_handshake_set_timeout(gnutls_session_t** _session_**,**
           **unsigned int** _ms_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int ms
                       is a timeout value in milliseconds
    


## DESCRIPTION



           This function sets the timeout for the TLS handshake process to
           the provided value. Use an  _ms_ value of zero to disable timeout,
           or **GNUTLS_DEFAULT_HANDSHAKE_TIMEOUT** for a reasonable default
           value. For the DTLS protocol, the more detailed
           **gnutls_dtls_set_timeouts()** is provided.
    
           This function requires to set a pull timeout callback. See
           **gnutls_transport_set_pull_timeout_function()**.
    


## SINCE



           3.1.0
    


* * *
# intptr_t

## NAME



           intptr_t, uintptr_t - integer types wide enough to hold pointers
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdint.h>**
    
           **typedef** /* ... */ **intptr_t;**
           **typedef** /* ... */ **uintptr_t;**
    
           **#define INTPTR_WIDTH** /* ... */
           **#define UINTPTR_WIDTH INTPTR_WIDTH**
    
           **#define INTPTR_MAX** /*  2**(INTPTR_WIDTH - 1) - 1  */
           **#define INTPTR_MIN** /*  - 2**(INTPTR_WIDTH - 1)    */
           **#define UINTPTR_MAX** /*  2**UINTPTR_WIDTH - 1       */
    


## DESCRIPTION



           _intptr_t_ is a signed integer type such that any valid (_void *_)
           value can be converted to this type and then converted back.  It
           is capable of storing values in the range [**INTPTR_MIN** ,
           **INTPTR_MAX**].
    
           _uintptr_t_ is an unsigned integer type such that any valid (_void *_)
           value can be converted to this type and then converted back.  It
           is capable of storing values in the range [**0** , **UINTPTR_MAX**].
    
           The macros [**U**]**INTPTR_WIDTH** expand to the width in bits of these
           types.
    
           The macros [**U**]**INTPTR_MAX** expand to the maximum value that these
           types can hold.
    
           The macro **INTPTR_MIN** expands to the minimum value that _intptr_t_
           can hold.
    
           The length modifiers for the [_u_]_intptr_t_ types for the printf(3)
           family of functions are expanded by the macros **PRIdPTR** , **PRIiPTR** ,
           and **PRIuPTR**(defined in _< inttypes.h>_); resulting commonly in
           **%"PRIdPTR"** or **%"PRIiPTR"** for printing _intptr_t_ values.  The length
           modifiers for the _[_ u _]_ intptr_t types for the scanf(3) family of
           functions are expanded by the macros **SCNdPTR** , **SCNiPTR** , and **SCNuPTR**
           (defined in _< inttypes.h>_); resulting commonly in **%"SCNuPTR"** for
           scanning _uintptr_t_ values.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following header also provides these types: _< inttypes.h>_.
    


* * *
# io_uring_unregister_napi

## NAME



           io_uring_unregister_napi - unregister NAPI busy poll settings
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_unregister_napi(struct io_uring ***_ring_**,**
                                        **struct io_uring_napi ***_napi)_
    


## DESCRIPTION



           The io_uring_unregister_napi(3) function unregisters the NAPI busy
           poll settings for subsequent operations.
    


## RETURN VALUE



           On success io_uring_unregister_napi(3) return 0. On failure they
           return **-errno**.  It also updates the napi structure with the
           current values.
    


* * *
# grantpt

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



           grantpt — grant access to the slave pseudo-terminal device
    


## SYNOPSIS



           #include <stdlib.h>
    
           int grantpt(int _fildes_);
    


## DESCRIPTION



           The _grantpt_() function shall change the mode and ownership of the
           slave pseudo-terminal device associated with its master pseudo-
           terminal counterpart. The _fildes_ argument is a file descriptor
           that refers to a master pseudo-terminal device. The user ID of the
           slave shall be set to the real UID of the calling process and the
           group ID shall be set to an unspecified group ID. The permission
           mode of the slave pseudo-terminal shall be set to readable and
           writable by the owner, and writable by the group.
    
           The behavior of the _grantpt_() function is unspecified if the
           application has installed a signal handler to catch SIGCHLD
           signals.
    


## RETURN VALUE



           Upon successful completion, _grantpt_() shall return 0; otherwise,
           it shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _grantpt_() function may fail if:
    
           **EACCES** The corresponding slave pseudo-terminal device could not be
                  accessed.
    
           **EBADF** The _fildes_ argument is not a valid open file descriptor.
    
           **EINVAL** The _fildes_ argument is not associated with a master pseudo-
                  terminal device.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           See the RATIONALE section for posix_openpt(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *