tripathysagar/man_text huggingface dataset:
# io_uring_recvmsg_payload

## NAME



           io_uring_recvmsg_out - access data from multishot recvmsg
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **struct io_uring_recvmsg_out *io_uring_recvmsg_validate(void ***_buf_**,**
                                                                  **int** _buf_len_**,**
                                                                  **struct msghdr ***_msgh_**);**
    
           **void *io_uring_recvmsg_name(struct io_uring_recvmsg_out ***_o_**);**
    
           **struct cmsghdr *io_uring_recvmsg_cmsg_firsthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                          **struct msghdr ***_msgh_**);**
           **struct cmsghdr *io_uring_recvmsg_cmsg_nexthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                         **struct msghdr ***_msgh_**,**
                                                         **struct cmsghdr ***_cmsg_**);**
    
           **void *io_uring_recvmsg_payload(struct io_uring_recvmsg_out ***_o_**,**
                                          **struct msghdr ***_msgh_**);**
           **unsigned int io_uring_recvmsg_payload_length(struct io_uring_recvmsg_out ***_o_**,**
                                                        **int** _buf_len_**,**
                                                        **struct msghdr ***_msgh_**);**
    


## DESCRIPTION



           These functions are used to access data in the payload delivered
           by io_uring_prep_recvmsg_multishot(3).
    
           _msgh_ should point to the _struct msghdr_ submitted with the request.
    
           io_uring_recvmsg_validate(3) will validate a buffer delivered by
           io_uring_prep_recvmsg_multishot(3) and extract the
           _io_uring_recvmsg_out_ if it is valid, returning a pointer to it or
           else NULL.
    
           The structure is defined as follows:
    
               struct io_uring_recvmsg_out {
                       __u32 namelen;    /* Name byte count as would have been populated
                                          * by recvmsg(2) */
                       __u32 controllen; /* Control byte count */
                       __u32 payloadlen; /* Payload byte count as would have been returned
                                          * by recvmsg(2) */
                       __u32 flags;      /* Flags result as would have been populated
                                          * by recvmsg(2) */
               };
    
           *  io_uring_recvmsg_name(3)
              returns a pointer to the name in the buffer.
    
           *  io_uring_recvmsg_cmsg_firsthdr(3)
              returns a pointer to the first cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_cmsg_nexthdr(3)
              returns a pointer to the next cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_payload(3)
              returns a pointer to the payload in the buffer.
    
           *  io_uring_recvmsg_payload_length(3)
              Calculates the usable payload length in bytes.
    


* * *
# gnutls_certificate_free_credentials

## NAME



           gnutls_certificate_free_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_free_credentials(gnutls_certificate_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_certificate_credentials_t structure.
    
           This function does not free any temporary parameters associated
           with this structure (ie RSA and DH parameters are not freed by
           this function).
    


* * *
# libpfm_amd64

## NAME



           libpfm_amd64 - support for AMD64 processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    


## DESCRIPTION



           The library supports all AMD64 processors in both 32 and 64-bit
           modes.
    
           The support is broken down in three groups:
    
           **AMD K7 processors (family 6)**
    
           **AMD K8 processors (family 15)**
    
           **AMD Family 10h processors (family 16)**
    
           Each group has a distinct man page. See links below.
    


* * *
# function::inet_get_local_port

## NAME



           function::inet_get_local_port - Provide local port number for a
           kernel socket
    


## SYNOPSIS



               inet_get_local_port:long(sock:long)
    


## ARGUMENTS



           _sock_
               pointer to the kernel socket
    


* * *
# libpfm_intel_ivbep_unc_pcu

## NAME



           libpfm_intel_ivbep_unc_pcu - support for Intel Ivy Bridge-EP Power
           Controller Unit (PCU) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_pcu**
           **PMU desc: Intel Ivy Bridge-EP PCU uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge Power Controller Unit
           uncore PMU.  This PMU model only exists on Ivy Bridge model 62.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge PCU
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of HA cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:15].
    
           **ff** Enable frequency band filtering. This modifier applies only
                  to the UNC_P_FREQ_BANDx_CYCLES events, where x is [0-3].
                  The modifiers expects an integer in the range [0-255]. The
                  value is interpreted as a frequency value to be multiplied
                  by 100Mhz. Thus if the value is 32, then all cycles where
                  the processor is running at 3.2GHz and more are counted.
    


## Frequency band filtering



           There are 3 events which support frequency band filtering, namely,
           UNC_P_FREQ_BAND0_CYCLES, UNC_P_FREQ_BAND1_CYCLES,
           UNC_P_FREQ_BAND2_CYCLES, UNC_P_FREQ_BAND3_CYCLES. The frequency
           filter (available via the ff modifier) is stored into a PMU shared
           register which hold all 4 possible frequency bands, one per event.
           However, the library generate the encoding for each event
           individually because it processes events one at a time. The caller
           or the underlying kernel interface may have to merge the band
           filter settings to program the filter register properly.
    


* * *
# isunordered

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



           isunordered — test if arguments are unordered
    


## SYNOPSIS



           #include <math.h>
    
           int isunordered(real-floating _x_ , real-floating _y_);
    


## 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 _isunordered_() macro shall determine whether its arguments are
           unordered.
    


## RETURN VALUE



           Upon successful completion, the _isunordered_() macro shall return 1
           if its arguments are unordered, and 0 otherwise.
    
           If _x_ or _y_ is NaN, 1 shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The relational and equality operators support the usual
           mathematical relationships between numeric values. For any ordered
           pair of numeric values, exactly one of the relationships (less,
           greater, and equal) is true. Relational operators may raise the
           invalid floating-point exception when argument values are NaNs.
           For a NaN and a numeric value, or for two NaNs, just the unordered
           relationship is true. This macro is a quiet (non-floating-point
           exception raising) version of a relational operator. It
           facilitates writing efficient code that accounts for NaNs without
           suffering the invalid floating-point exception. In the SYNOPSIS
           section, **real-floating** indicates that the argument shall be an
           expression of **real-floating** type.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs12_generate_mac3

## NAME



           gnutls_pkcs12_generate_mac3 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_generate_mac3(gnutls_pkcs12_t** _pkcs12_**,**
           **gnutls_mac_algorithm_t** _mac_**, const char ***_pass_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           gnutls_mac_algorithm_t mac
                       the MAC algorithm to use
    
           const char * pass
                       The password for the MAC
    
           unsigned int flags
                       an ORed sequence of gnutls_pkcs12_flags_t
    


## DESCRIPTION



           This function will generate a MAC for the PKCS12 structure.
    
           If  _flags_ contains **GNUTLS_PKCS12_USE_PBMAC1** , it uses PBMAC1 key
           derivation function instead of the PKCS**12** one.
    


## RETURNS



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


* * *
# keybound

## NAME



           **keybound** - return definition of keycode
    


## SYNOPSIS



           **#include <curses.h>**
    
           **char * keybound(int** _keycode_**, int** _count);_
    


## DESCRIPTION



           This is an extension to the curses library.  It permits an
           application to determine the string which is defined in the
           terminfo for specific keycodes.
    


## RETURN VALUE



           The _keycode_ parameter must be greater than zero, else NULL is
           returned.  If it does not correspond to a defined key, then NULL
           is returned.  The _count_ parameter is used to allow the application
           to iterate through multiple definitions, counting from zero.  When
           successful, the function returns a string which must be freed by
           the caller.
    


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# wctype

## NAME



           wctype - wide-character classification
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **wctype_t wctype(const char ***_name_**);**
    


## DESCRIPTION



           The _wctype_t_ type represents a property which a wide character may
           or may not have.  In other words, it represents a class of wide
           characters.  This type's nature is implementation-dependent, but
           the special value _(wctype_t) 0_ denotes an invalid property.
           Nonzero _wctype_t_ values can be passed to the iswctype(3) function
           to actually test whether a given wide character has the property.
    
           The **wctype**() function returns a property, given by its name.  The
           set of valid names depends on the **LC_CTYPE** category of the current
           locale, but the following names are valid in all locales.
    
                  "alnum" -  realizes the isalnum(3) classification function
                  "alpha" -  realizes the isalpha(3) classification function
                  "blank" -  realizes the isblank(3) classification function
                  "cntrl" -  realizes the iscntrl(3) classification function
                  "digit" -  realizes the isdigit(3) classification function
                  "graph" -  realizes the isgraph(3) classification function
                  "lower" -  realizes the islower(3) classification function
                  "print" -  realizes the isprint(3) classification function
                  "punct" -  realizes the ispunct(3) classification function
                  "space" -  realizes the isspace(3) classification function
                  "upper" -  realizes the isupper(3) classification function
                  "xdigit" - realizes the isxdigit(3) classification function
    


## RETURN VALUE



           The **wctype**() function returns a property descriptor if the _name_ is
           valid.  Otherwise, it returns _(wctype_t) 0_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **wctype**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# gnutls_privkey_import_openpgp

## NAME



           gnutls_privkey_import_openpgp - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_openpgp(gnutls_privkey_t** _pkey_**,**
           **gnutls_openpgp_privkey_t** _key_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_openpgp_privkey_t key
                       The private key to be imported
    
           unsigned int flags
                       Flags for the import
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           2.12.0
    


* * *
# tapset::livepatch

## NAME



           tapset::livepatch - systemtap livepatch tapset
    


## DESCRIPTION



           **cve_count_metric**
                  Increment the count of key
    
                  See function::cve_count_metric(3stap)
                   for details.
    
           **cve_record_metric**
                  Set the value of key
    
                  See function::cve_record_metric(3stap)
                   for details.
    
           **cve_tmpdisable**
                  Disable the cve livepatch
    
                  See function::cve_tmpdisable(3stap)
                   for details.
    


* * *
# gnutls_ecc_curve_get_size

## NAME



           gnutls_ecc_curve_get_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ecc_curve_get_size(gnutls_ecc_curve_t** _curve_**);**
    


## ARGUMENTS



           gnutls_ecc_curve_t curve
                       is an ECC curve
    


## RETURNS



           the size in bytes of the curve or 0 on failure.
    


## SINCE



           3.0
    


* * *
# pmdadaemon

## NAME



           **pmdaDaemon** - initialize the PMDA to run as a daemon
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **void pmdaDaemon(pmdaInterface ***_dispatch_**, int** _interface_**,**
                           **const char ***_name_**, int** _domain_**, const char ***_logfile_**,**
                           **const char ***_helptext_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           **pmdaDaemon** initializes the **pmdaInterface** structure to use the _in‐_
           _terface_ extensions assuming the PMDA(3) is to be run as a  daemon.
           The **pmdaInterface** structure is initialized with:
    
           _name_   The name of the agent.
    
           _domain_ The default domain number of the agent which uniquely iden‐
                  tifies this PMDA from other running PMDAs.  This may be
                  subsequently changed by a command line option **-d**(see
                  pmdaGetOpt(3)).
    
           _logfile_
                  The default path to the log file.  This may be replaced by
                  the **-l** command line option if using **pmdaGetOpt**.  _logfile_
                  will be copied with strdup(3), so the storage associated
                  with _logfile_ may be released after the call to **pmdaDaemon**.
    
           _helptext_
                  The default path to the help text (see pmdaText(3).  This
                  may be replaced by the **-h** command line option if using
                  pmdaGetOpt(3).  If no help text is installed, or you are
                  not using pmdaText(3), then this should be set to NULL,
                  otherwise _helptext_ will be copied with strdup(3), so the
                  storage associated with _helptext_ may be released after the
                  call to **pmdaDaemon**.
    
           The callbacks are initialized to pmdaProfile(3), pmdaFetch(3),
           pmdaDesc(3), pmdaText(3), pmdaInstance(3) and pmdaStore(3).
    


## CAVEAT



           The PMDA must be using **PMDA_INTERFACE_2** or later.
    
           Once **pmdaDaemon** has been called, it is expected that the **pmdaIn‐**
           **terface** structure pointed to by _dispatch_ will remain accessible to
           the routines in _libpcp_pmda_ (not reclaimed off the stack, not
           freed or otherwise released, etc.).  If the caller needs to move
           or relocate the **pmdaInterface** structure for any reason, then after
           the move pmdaInterfaceMoved(3) must be called to re-establish the
           internal integrity of the _pmdaInterface_ structure at the new loca‐
           tion before any other routine in _libpcp_pmda_ is called.
    


## DIAGNOSTICS



           **Unable to allocate memory for pmdaExt structure**
                  In addition, the _dispatch- >status_ field is set to a value
                  less than zero.
    
           **PMDA interface version** _interface_ **not supported**
                  The _interface_ version is not supported by **pmdaDaemon**.
    


* * *
# function::modname

## NAME



           function::modname - Return the kernel module name loaded at the
           address
    


## SYNOPSIS



               modname:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to map to a kernel module name
    


## DESCRIPTION



           Returns the module name associated with the given address if
           known. If not known it will raise an error. If the address was not
           in a kernel module, but in the kernel itself, then the string
           “kernel” will be returned.
    


* * *
# strcspn

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



           strcspn — get the length of a complementary substring
    


## SYNOPSIS



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


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _strcspn_() function shall compute the length (in bytes) of the
           maximum initial segment of the string pointed to by _s1_ which
           consists entirely of bytes _not_ from the string pointed to by _s2_.
    


## RETURN VALUE



           The _strcspn_() function shall return the length of the computed
           segment of the string pointed to by _s1_ ; no return value is
           reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tcp.setsockopt

## NAME



           probe::tcp.setsockopt - Call to **setsockopt**
    


## SYNOPSIS



           tcp.setsockopt
    


## VALUES



           _level_
               The level at which the socket options will be manipulated
    
           _sock_
               Network socket
    
           _family_
               IP address family
    
           _optstr_
               Resolves optname to a human-readable format
    
           _optlen_
               Used to access values for **setsockopt**
    
           _optname_
               TCP socket options (e.g. TCP_NODELAY, TCP_MAXSEG, etc)
    
           _name_
               Name of this probe
    


## CONTEXT



           The process which calls setsockopt
    


* * *
# pmsearchtextsuggest

## NAME



           **pmSearchTextSuggest** - search for suggestions of metric or instance
           names using PCP search services
    


## C SYNOPSIS



           **#include <pcp/pmwebapi.h>**
    
           **int pmSearchTextSuggest(pmSearchSettings ***_settings_**,**
                                   **pmSearchTextRequest ***_request_**, void ***_arg_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           Executes  full-text search for names of metrics or instances suit‐
           able for auto-completion, specified by _request_ :
    
           _query_
                Query string that will be used to search.
    
           _count_
                Limits number of results. Defaults to 10.
    
           Words with length less than 2 are omitted.
    
           This search matches terms inside entity name that either have
           **query** prefix or are within Levenshtein distance of 1, with former
           having slightly higher priority than the latter.
    
           Each entity matched by the **request** above will be passed to
           **on_text_result** callback provided by **settings.**
    


## DIAGNOSTICS



           This function always returns zero on success.  On failure a nega‐
           tive PMAPI error code is returned.
    


* * *
# gnutls_subject_alt_names_get

## NAME



           gnutls_subject_alt_names_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_subject_alt_names_get(gnutls_subject_alt_names_t** _sans_**,**
           **unsigned int** _seq_**, unsigned int ***_san_type_**, gnutls_datum_t ***_san_**,**
           **gnutls_datum_t ***_othername_oid_**);**
    


## ARGUMENTS



           gnutls_subject_alt_names_t sans
                       The alternative names
    
           unsigned int seq
                       The index of the name to get
    
           unsigned int * san_type
                       Will hold the type of the name (of
                       **gnutls_subject_alt_names_t**)
    
           gnutls_datum_t * san
                       The alternative name data (should be treated as
                       constant)
    
           gnutls_datum_t * othername_oid
                       The object identifier if  _san_type_ is
                       **GNUTLS_SAN_OTHERNAME**(should be treated as constant)
    


## DESCRIPTION



           This function will return a specific alternative name as stored in
           the  _sans_ type. The returned values should be treated as constant
           and valid for the lifetime of  _sans_ .
    


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


* * *
# probe::stap.pass3.end

## NAME



           probe::stap.pass3.end - Finished stap pass3 (translation to C)
    


## SYNOPSIS



           stap.pass3.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass3.end fires just before the jump to cleanup if s.last_pass = 3
    


* * *
# libpfm_intel_spr_unc_imc

## NAME



           libpfm_intel_spr_unc_imc - support for Intel SapphireRapids Server
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: spr_unc_imc[0-11]**
           **PMU desc: Intel SapphireRapids Server IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel SapphireRapids Server Integrated
           Memory Controller (IMC) uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel SapphireRapids
           server IMC uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IMC cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].  **i** Invert the threshold (t) test from
                  strictly greater than to less or equal to. This is a
                  boolean modifier.
    


* * *
# gnutls_anon_allocate_client_credentials

## NAME



           gnutls_anon_allocate_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_anon_allocate_client_credentials(gnutls_anon_client_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



           gnutls_anon_client_credentials_t * sc
                       is a pointer to a **gnutls_anon_client_credentials_t**
                       type.
    


## DESCRIPTION



           Allocate a gnutls_anon_client_credentials_t structure.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code.
    


* * *
# probe::json_data

## NAME



           probe::json_data - Fires whenever JSON data is wanted by a reader.
    


## SYNOPSIS



           json_data
    


## VALUES



           None
    


## CONTEXT



           This probe fires when the JSON data is about to be read. This
           probe must gather up data and then call the following macros to
           output the data in JSON format. First, @**json_output_data_start**
           must be called. That call is followed by one or more of the
           following (one call for each data item):
           @**json_output_string_value** , @**json_output_numeric_value** ,
           @**json_output_array_string_value** , and
           @**json_output_array_numeric_value**. Finally @**json_output_data_end**
           must be called.
    


* * *
# putc_unlocked

## 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_unlocked — stdio with explicit client locking
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to getc_unlocked(3p).
    


* * *
# aio_cancel

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



           aio_cancel — cancel an asynchronous I/O request
    


## SYNOPSIS



           #include <aio.h>
    
           int aio_cancel(int _fildes_ , struct aiocb *_aiocbp_);
    


## DESCRIPTION



           The _aio_cancel_() function shall attempt to cancel one or more
           asynchronous I/O requests currently outstanding against file
           descriptor _fildes_.  The _aiocbp_ argument points to the asynchronous
           I/O control block for a particular request to be canceled. If
           _aiocbp_ is NULL, then all outstanding cancelable asynchronous I/O
           requests against _fildes_ shall be canceled.
    
           Normal asynchronous notification shall occur for asynchronous I/O
           operations that are successfully canceled. If there are requests
           that cannot be canceled, then the normal asynchronous completion
           process shall take place for those requests when they are
           completed.
    
           For requested operations that are successfully canceled, the
           associated error status shall be set to **[ECANCELED]** and the return
           status shall be -1. For requested operations that are not
           successfully canceled, the _aiocbp_ shall not be modified by
           _aio_cancel_().
    
           If _aiocbp_ is not NULL, then if _fildes_ does not have the same value
           as the file descriptor with which the asynchronous operation was
           initiated, unspecified results occur.
    
           Which operations are cancelable is implementation-defined.
    


## RETURN VALUE



           The _aio_cancel_() function shall return the value AIO_CANCELED if
           the requested operation(s) were canceled.  The value
           AIO_NOTCANCELED shall be returned if at least one of the requested
           operation(s) cannot be canceled because it is in progress. In this
           case, the state of the other operations, if any, referenced in the
           call to _aio_cancel_() is not indicated by the return value of
           _aio_cancel_().  The application may determine the state of affairs
           for these operations by using _aio_error_().  The value AIO_ALLDONE
           is returned if all of the operations have already completed.
           Otherwise, the function shall return -1 and set _errno_ to indicate
           the error.
    


## ERRORS



           The _aio_cancel_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_fallocate

## NAME



           io_uring_prep_fallocate - prepare a fallocate request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_fallocate(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **int** _mode_**,**
                                        **__u64** _offset_**,**
                                        **__u64** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_fallocate(3) function prepares a fallocate
           request. The submission queue entry _sqe_ is setup to use the file
           descriptor pointed to by _fd_ to start a fallocate operation
           described by _mode_ at offset _offset_ and _len_ length in bytes.
    
           This function prepares an async fallocate(2) request. See that man
           page for details.
    


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


* * *
# getpmsg

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



           getpmsg — receive next message from a STREAMS file
    


## SYNOPSIS



           #include <stropts.h>
    
           int getpmsg(int _fildes_ , struct strbuf *restrict _ctlptr_ ,
               struct strbuf *restrict _dataptr_ , int *restrict _bandp_ ,
               int *restrict _flagsp_);
    


## DESCRIPTION



           Refer to getmsg(3p).
    


* * *
# fegetround

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



           fegetround, fesetround — get and set current rounding direction
    


## SYNOPSIS



           #include <fenv.h>
    
           int fegetround(void);
           int fesetround(int _round_);
    


## 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 _fegetround_() function shall get the current rounding
           direction.
    
           The _fesetround_() function shall establish the rounding direction
           represented by its argument _round_.  If the argument is not equal
           to the value of a rounding direction macro, the rounding direction
           is not changed.
    


## RETURN VALUE



           The _fegetround_() function shall return the value of the rounding
           direction macro representing the current rounding direction or a
           negative value if there is no such rounding direction macro or the
           current rounding direction is not determinable.
    
           The _fesetround_() function shall return a zero value if and only if
           the requested rounding direction was established.
    


## ERRORS



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


## EXAMPLES



           The following example saves, sets, and restores the rounding
           direction, reporting an error and aborting if setting the rounding
           direction fails:
    
               #include <fenv.h>
               #include <assert.h>
               void f(int round_dir)
               {
                   #pragma STDC FENV_ACCESS ON
                   int save_round;
                   int setround_ok;
                   save_round = fegetround();
                   setround_ok = fesetround(round_dir);
                   assert(setround_ok == 0);
                   /* ... */
                   fesetround(save_round);
                   /* ... */
               }
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_trust_list_set_getissuer_function

## NAME



           gnutls_x509_trust_list_set_getissuer_function - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void**
           **gnutls_x509_trust_list_set_getissuer_function(gnutls_x509_trust_list_t**
           _tlist_**, gnutls_x509_trust_list_getissuer_function ***_func_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t tlist
                       is a **gnutls_x509_trust_list_t** type.
    
           gnutls_x509_trust_list_getissuer_function * func
                       is the callback function
    


## DESCRIPTION



           This function sets a callback to be called when the peer's
           certificate chain is incomplete due a missing intermediate
           certificate. The callback may provide the missing certificate for
           use during verification.
    
           The callback's function prototype is defined in gnutls/x509.h as:
    
           int (*callback)(gnutls_x509_trust_list_t list, const
           gnutls_x509_crt_t cert, gnutls_x509_crt_t **issuers, unsigned int
           *issuers_size);
    
           If the callback function is provided then gnutls will call it
           during the certificate verification procedure. The callback may
           wish to use **gnutls_x509_crt_get_authority_info_access()** to get a
           URI from which to attempt to download the missing issuer
           certificate, if available.
    
           On a successful call, the callback shall set '*issuers' and
           '*issuers_size' even if the result is empty; in that case
           '*issuers' will point to **NULL** and allocated using
           **gnutls_x509_crt_list_import2()**. The ownership of both the array
           and the elements is transferred to the caller and thus the
           application does not need to maintain the memory after the call.
    
           The callback function should return 0 if the attempt to retrieve
           the issuer certificates for 'crt' succeeded, or non-zero to
           indicate any error occurred during the attempt. In the latter
           case, '*issuers' and '*issuers_size' are not set.
    


## SINCE



           3.7.0
    


* * *
# wprintf

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



           wprintf — print formatted wide-character output
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           int wprintf(const wchar_t *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fwprintf(3p).
    


* * *
# gnutls_credentials_clear

## NAME



           gnutls_credentials_clear - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Clears all the credentials previously set in this session.
    


* * *
# io_uring_unregister_iowq_aff

## NAME



           io_uring_register_iowq_aff - register async worker CPU affinities
    


## SYNOPSIS



           **#include <sched.h>**
           **#include <liburing.h>**
    
           **int io_uring_register_iowq_aff(struct io_uring ***_ring_**,**
                                          **size_t** _cpusz_**,**
                                          **const cpu_set_t ***_mask_**);**
    
           **void io_uring_unregister_iowq_aff(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The **io_uring_prep_register_iowq_aff**(3) function registers a set of
           CPU affinities to be used by the io_uring async workers. By
           default, io_uring async workers are allowed to run on any CPU in
           the system. If this function is called with _ring_ set to the ring
           in question and _mask_ set to a pointer to a **cpu_set_t** value and
           _cpusz_ set to the size of the CPU set, then async workers will only
           be allowed to run on the CPUs specified in the mask. Existing
           workers may need to hit a schedule point before they are migrated.
    
           For unregistration, io_uring_unregister_iowq_aff(3) may be called
           to restore CPU affinities to the default.
    
           Applications must define **_GNU_SOURCE** to obtain the definition of
           this helper, as _cpu_set_t_ will not be defined without it.
    


## RETURN VALUE



           Returns **0** on success, or any of the following values in case of
           error.
    
           **-EFAULT**
                  The kernel was unable to copy the memory pointer to by _mask_
                  as it was invalid.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the new CPU
                  mask.
    
           **-EINVAL**
                  _cpusz_ or _mask_ was NULL/0, or any other value specified was
                  invalid.
    


* * *
# function::assert

## NAME



           function::assert - evaluate assertion
    


## SYNOPSIS



           1) assert(expression:long)
    
           2) assert(expression:long,msg:string)
    


## ARGUMENTS



           _expression_
               The expression to evaluate
    
           _msg_
               The formatted message string
    


## DESCRIPTION



           1) This function checks the expression and aborts the current
           running probe if expression evaluates to zero. Uses**error** and may
           be caught by try{} catch{}. A default message will be displayed.
    
           2) This function checks the expression and aborts the current
           running probe if expression evaluates to zero. Uses**error** and may
           be caught by try{} catch{}. The specified message will be
           displayed.
    


* * *
# iswcntrl

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



           iswcntrl, iswcntrl_l — test for a control wide-character code
    


## SYNOPSIS



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


## DESCRIPTION



           For _iswcntrl_(): 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 _iswcntrl_() and _iswcntrl_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **cntrl** 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 _iswcntrl_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswcntrl_() and _iswcntrl_l_() functions shall return non-zero if
           _wc_ is a control 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.
    


* * *
# sd_bus_wait

## NAME



           sd_bus_wait - Wait for I/O on a bus connection
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_wait(sd_bus ***_bus_**, uint64_t** _timeout_usec_**);**
    


## DESCRIPTION



           **sd_bus_wait()** synchronously waits for I/O on the specified bus
           connection object. This function is supposed to be called whenever
           sd_bus_process(3) returns zero, indicating that no work is pending
           on the connection. Internally, this call invokes ppoll(2), to wait
           for I/O on the bus connection. If the _timeout_usec_ parameter is
           specified, the call will block at most for the specified amount of
           time in μs. Pass **UINT64_MAX** to permit it to sleep indefinitely.
    
           After each invocation of **sd_bus_wait()** the **sd_bus_process()** call
           should be invoked in order to process any now pending I/O work.
    
           Note that **sd_bus_wait()** is suitable only for simple programs as it
           does not permit waiting for other I/O events. For more complex
           programs either connect the bus connection object to an external
           event loop using sd_bus_get_fd(3) or to an sd-event(3) event loop
           using sd_bus_attach_event(3).
    


## RETURN VALUE



           If any I/O was seen, a positive value is returned, zero otherwise.
           If an error occurs, a negative _errno_ -style error code is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               An invalid bus object was passed.
    
           **-ECHILD**
               The bus connection was allocated in a parent process and is
               being reused in a child process after **fork()**.
    
           **-ENOTCONN**
               The bus connection has been terminated already.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *