tripathysagar/man_text huggingface dataset:
# audit_set_backlog_wait_time

## NAME



           audit_set_backlog_wait_time - Set the audit backlog wait time
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_backlog_wait_time(int** _fd_**, uint32_t** _bwt_**);"**
    


## DESCRIPTION



           audit_set_backlog_wait_time sets the time that the kernel will
           wait before attempting to send more audit events on the descriptor
           given in _fd_. The _bwt_ parameter specifies the delay in jiffies
           before attempting to transfer more events when the backlog_limit
           is reached. This gives the audit daemon a chance to drain the
           kernel queue. The default value is 60000 or 60 * HZ setting in the
           kernel.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# ibv_alloc_null_mr

## NAME



           ibv_alloc_null_mr - allocate a null memory region (MR)
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_mr *ibv_alloc_null_mr(struct ibv_pd *pd);
    


## DESCRIPTION



           **ibv_alloc_null_mr()** allocates a null memory region (MR) that is
           associated with the protection domain _pd_.
    
           A null MR discards all data written to it, and always returns 0 on
           read.  It has the maximum length and only the lkey is valid, the
           MR is not exposed as an rkey.
    
           A device should implement the null MR in a way that bypasses PCI
           transfers, internally discarding or sourcing 0 data.  This
           provides a way to avoid PCI bus transfers by using a
           scatter/gather list in commands if applications do not intend to
           access the data, or need data to be 0 filled.
    
           Specifically upon **ibv_post_send()** the device skips PCI read cycles
           and upon **ibv_post_recv()** the device skips PCI write cycles which
           finally improves performance.
    
           **ibv_dereg_mr()** deregisters the MR.  The use of ibv_rereg_mr() or
           ibv_bind_mw() with this MR is invalid.
    


## RETURN VALUE



           **ibv_alloc_null_mr()** returns a pointer to the allocated MR, or NULL
           if the request fails.
    


* * *
# gnutls_x509_crt_set_subject_alternative_name

## NAME



           gnutls_x509_crt_set_subject_alternative_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_subject_alternative_name(gnutls_x509_crt_t**
           _crt_**, gnutls_x509_subject_alt_name_t** _type_**, const char ***
           _data_string_**);**
    


## 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 char * data_string
                       The data to be set, a (0) terminated string
    


## DESCRIPTION



           This function will set the subject alternative name certificate
           extension. This function assumes that data can be expressed as a
           null terminated string.
    
           The name of the function is unfortunate since it is inconsistent
           with **gnutls_x509_crt_get_subject_alt_name()**.
    
           See **gnutls_x509_crt_set_subject_alt_name()** for more information.
    


## RETURNS



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


* * *
# ibv_attach_mcast

## NAME



           ibv_attach_mcast, ibv_detach_mcast - attach and detach a queue
           pair (QPs) to/from a multicast group
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_attach_mcast(struct ibv_qp *qp, const union ibv_gid *gid, uint16_t lid);
    
                  int ibv_detach_mcast(struct ibv_qp *qp, const union ibv_gid *gid, uint16_t lid);
    


## DESCRIPTION



           **ibv_attach_mcast()** attaches the QP _qp_ to the multicast group
           having MGID _gid_ and MLID _lid_.
    
           **ibv_detach_mcast()** detaches the QP _qp_ to the multicast group
           having MGID _gid_ and MLID _lid_.
    


## RETURN VALUE



           **ibv_attach_mcast()** and **ibv_detach_mcast()** returns 0 on success, or
           the value of errno on failure (which indicates the failure
           reason).
    


## NOTES



           Only QPs of Transport Service Type **IBV_QPT_UD** may be attached to
           multicast groups.
    
           If a QP is attached to the same multicast group multiple times,
           the QP will still receive a single copy of a multicast message.
    
           In order to receive multicast messages, a join request for the
           multicast group must be sent to the subnet administrator (SA), so
           that the fabric’s multicast routing is configured to deliver
           messages to the local port.
    


* * *
# probe::kprocess.exec

## NAME



           probe::kprocess.exec - Attempt to exec to a new program
    


## SYNOPSIS



           kprocess.exec
    


## VALUES



           _name_
               Name of the system call (“execve”) (SystemTap v2.5+)
    
           _argstr_
               A string containing the filename followed by the arguments to
               pass, excluding 0th arg (SystemTap v2.5+)
    
           _args_
               The arguments to pass to the new executable, including the 0th
               arg (SystemTap v2.5+)
    
           _filename_
               The path to the new executable
    


## CONTEXT



           The caller of exec.
    


## DESCRIPTION



           Fires whenever a process attempts to exec to a new program.
           Aliased to the syscall.execve probe in SystemTap v2.5+.
    


* * *
# rdma_resolve_addr

## NAME



           rdma_resolve_addr - Resolve destination and optional source
           addresses.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_resolve_addr (struct rdma_cm_id ***_id_**, struct sockaddr**
           *****_src_addr_**, struct sockaddr ***_dst_addr_**, int** _timeout_ms_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           src_addr    Source address information.  This parameter may be
                       NULL.
    
           dst_addr    Destination address information.
    
           timeout_ms  Time to wait for resolution to complete.
    


## DESCRIPTION



           Resolve destination and optional source addresses from IP
           addresses to an RDMA address.  If successful, the specified
           rdma_cm_id will be bound to a local device.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           This call is used to map a given destination IP address to a
           usable RDMA address.  The IP to RDMA address mapping is done using
           the local routing tables, or via ARP.  If a source address is
           given, the rdma_cm_id is bound to that address, the same as if
           rdma_bind_addr were called.  If no source address is given, and
           the rdma_cm_id has not yet been bound to a device, then the
           rdma_cm_id will be bound to a source address based on the local
           routing tables.  After this call, the rdma_cm_id will be bound to
           an RDMA device.  This call is typically made from the active side
           of a connection before calling rdma_resolve_route and
           rdma_connect.
    


## INFINIBAND SPECIFIC



           This call maps the destination and, if given, source IP addresses
           to GIDs.  In order to perform the mapping, IPoIB must be running
           on both the local and remote nodes.
    


* * *
# gnutls_mac_get_key_size

## NAME



           gnutls_mac_get_key_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **size_t gnutls_mac_get_key_size(gnutls_mac_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           Returns the size of the MAC key used in TLS.
    


## RETURNS



           length (in bytes) of the given MAC key size, or 0 if the given MAC
           algorithm is invalid.
    


* * *
# gnutls_x509_crl_set_this_update

## NAME



           gnutls_x509_crl_set_this_update - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_this_update(gnutls_x509_crl_t** _crl_**, time_t**
           _act_time_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           time_t act_time
                       The actual time
    


## DESCRIPTION



           This function will set the time this CRL was issued.
    


## RETURNS



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


* * *
# gnutls_sign_get_id

## NAME



           gnutls_sign_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_sign_algorithm_t gnutls_sign_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a sign algorithm name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           return a **gnutls_sign_algorithm_t** value corresponding to the
           specified algorithm, or **GNUTLS_SIGN_UNKNOWN** on error.
    


* * *
# probe::nfs.proc.handle_exception

## NAME



           probe::nfs.proc.handle_exception - NFS client handling an NFSv4
           exception
    


## SYNOPSIS



           nfs.proc.handle_exception
    


## VALUES



           _errorcode_
               indicates the type of error
    


## DESCRIPTION



           This is the error handling routine for processes for NFSv4.
    


* * *
# frexp

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



           frexp, frexpf, frexpl — extract mantissa and exponent from a
           double precision number
    


## SYNOPSIS



           #include <math.h>
    
           double frexp(double _num_ , int *_exp_);
           float frexpf(float _num_ , int *_exp_);
           long double frexpl(long double _num_ , int *_exp_);
    


## 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 break a floating-point number _num_ into a
           normalized fraction and an integral power of 2. The integer
           exponent shall be stored in the **int** object pointed to by _exp_.
    


## RETURN VALUE



           For finite arguments, these functions shall return the value _x_ ,
           such that _x_ has a magnitude in the interval [½,1) or 0, and _num_
           equals _x_ times 2 raised to the power *_exp_.
    
           If _num_ is NaN, a NaN shall be returned, and the value of *_exp_ is
           unspecified.
    
           If _num_ is ±0, ±0 shall be returned, and the value of *_exp_ shall be
           0.
    
           If _num_ is ±Inf, _num_ shall be returned, and the value of *_exp_ is
           unspecified.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::set_kernel_string

## NAME



           function::set_kernel_string - Writes a string to kernel memory
    


## SYNOPSIS



               set_kernel_string(addr:long,val:string)
    


## ARGUMENTS



           _addr_
               The kernel address to write the string to
    
           _val_
               The string which is to be written
    


## DESCRIPTION



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


* * *
# gnutls_psk_set_server_credentials_function

## NAME



           gnutls_psk_set_server_credentials_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_server_credentials_function(gnutls_psk_server_credentials_t**
           _cred_**, gnutls_psk_server_credentials_function ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_server_credentials_function * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the user's
           PSK credentials.  The callback's function form is: int
           (*callback)(gnutls_session_t, const char* username,
           gnutls_datum_t* key);
    
            _username_ contains the actual username.  The  _key_ must be filled
           in using the **gnutls_malloc()**.
    
           In case the callback returned a negative number then gnutls will
           assume that the username does not exist.
    
           The callback function will only be called once per handshake.  The
           callback function should return 0 on success, while -1 indicates
           an error.
    


* * *
# gnutls_x509_cidr_to_rfc5280

## NAME



           gnutls_x509_cidr_to_rfc5280 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_cidr_to_rfc5280(const char ***_cidr_**, gnutls_datum_t**
           *****_cidr_rfc5280_**);**
    


## ARGUMENTS



           const char * cidr
                       CIDR in RFC4632 format (IP/prefix), null-terminated
    
           gnutls_datum_t * cidr_rfc5280
                       CIDR range converted to RFC5280 format
    


## DESCRIPTION



           This function will convert text CIDR range with prefix (such as
           '10.0.0.0/8') to RFC5280 (IP address in network byte order
           followed by its network mask).  Works for both IPv4 and IPv6.
    
           The resulting object is directly usable for IP name constraints
           usage, for example in functions
           **gnutls_x509_name_constraints_add_permitted** or
           **gnutls_x509_name_constraints_add_excluded**.
    
           The data in datum needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.5.4
    


* * *
# dev_t

## NAME



           dev_t - device ID
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
    
           **typedef** /* ... */  **dev_t;**
    


## DESCRIPTION



           Used for device IDs.  It is an integer type.  For further details
           of this type, see makedev(3).
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following header also provides this type: _< sys/stat.h>_.
    


* * *
# probe::netfilter.ip.forward

## NAME



           probe::netfilter.ip.forward - Called on an incoming IP packet
           addressed to some other computer
    


## SYNOPSIS



           netfilter.ip.forward
    


## VALUES



           _dport_
               TCP or UDP destination port (ipv4 only)
    
           _pf_
               Protocol family -- either “ipv4” or “ipv6”
    
           _iphdr_
               Address of IP header
    
           _sport_
               TCP or UDP source port (ipv4 only)
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _ipproto_tcp_
               Constant used to signify that the packet protocol is TCP
    
           _urg_
               TCP URG flag (if protocol is TCP; ipv4 only)
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _rst_
               TCP RST flag (if protocol is TCP; ipv4 only)
    
           _syn_
               TCP SYN flag (if protocol is TCP; ipv4 only)
    
           _daddr_
               A string representing the destination IP address
    
           _fin_
               TCP FIN flag (if protocol is TCP; ipv4 only)
    
           _saddr_
               A string representing the source IP address
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _ack_
               TCP ACK flag (if protocol is TCP; ipv4 only)
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _data_str_
               A string representing the packet buffer contents
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _protocol_
               Packet protocol from driver (ipv4 only)
    
           _family_
               IP address family
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _ipproto_udp_
               Constant used to signify that the packet protocol is UDP
    
           _psh_
               TCP PSH flag (if protocol is TCP; ipv4 only)
    


* * *
# gnutls_pem_base64_encode

## NAME



           gnutls_pem_base64_encode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_pem_base64_encode(const char ***_msg_**, const**
           **gnutls_datum_t ***_data_**, char ***_result_**, size_t ***_result_size_**);**
    


## ARGUMENTS



           const char * msg
                       is a message to be put in the header (may be **NULL**)
    
           const gnutls_datum_t * data
                       contain the raw data
    
           char * result
                       the place where base64 data will be copied
    
           size_t * result_size
                       holds the size of the result
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the base64 encoding. This is the encoding used in PEM messages.
    
           The output string will be null terminated, although the output
           size will not include the terminating null.
    


## RETURNS



           On success **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_SHORT_MEMORY_BUFFER** is returned if the buffer given is
           not long enough, or 0 on success.
    


* * *
# io_uring_register_eventfd

## NAME



           io_uring_register_eventfd - register an eventfd with a ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_eventfd(struct io_uring ***_ring_**,**
                                         **int** _fd_**);**
    
           **int io_uring_register_eventfd_async(struct io_uring ***_ring_**,**
                                               **int** _fd_**);**
    
           **int io_uring_unregister_eventfd(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_register_eventfd(3) registers the eventfd file descriptor
           _fd_ with the ring identified by _ring_.
    
           Whenever completions are posted to the CQ ring, an eventfd
           notification is generated with the registered eventfd descriptor.
           If io_uring_register_eventfd_async(3) is used, only events that
           completed out-of-line will trigger a notification.
    
           It notifications are no longer desired,
           io_uring_unregister_eventfd(3) may be called to remove the eventfd
           registration. No eventfd argument is needed, as a ring can only
           have a single eventfd registered.
    


## NOTES



           While io_uring generally takes care to avoid spurious events, they
           can occur.  Similarly, batched completions of CQEs may only
           trigger a single eventfd notification even if multiple CQEs are
           posted. The application should make no assumptions on number of
           events being available having a direct correlation to eventfd
           notifications posted. An eventfd notification must thus only be
           treated as a hint to check the CQ ring for completions.
    


## RETURN VALUE



           Returns 0 on success, or **-errno** on error.
    


* * *
# tapset::indent

## NAME



           tapset::indent - systemtap indent tapset
    


## DESCRIPTION



           **thread_indent**
                  returns an amount of space with the current task
                  information
    
                  See function::thread_indent(3stap)
                   for details.
    
           **thread_indent_depth**
                  returns the nested-depth of the current task
    
                  See function::thread_indent_depth(3stap)
                   for details.
    
           **indent** returns an amount of space to indent
    
                  See function::indent(3stap)
                   for details.
    
           **indent_depth**
                  returns the global nested-depth
    
                  See function::indent_depth(3stap)
                   for details.
    


* * *
# io_uring_cqe_seen

## NAME



           io_uring_cqe_seen - mark io_uring completion event as consumed
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_cqe_seen(struct io_uring ***_ring_**,**
                                  **struct io_uring_cqe ***_cqe_**);**
    


## DESCRIPTION



           The io_uring_cqe_seen(3) function marks the IO completion _cqe_
           belonging to the _ring_ param as consumed.
    
           After the caller has submitted a request with io_uring_submit(3),
           the application can retrieve the completion with
           io_uring_wait_cqe(3), io_uring_peek_cqe(3), or any of the other
           CQE retrieval helpers, and mark it as consumed with
           io_uring_cqe_seen(3).
    
           Completions must be marked as completed so their slot can get
           reused.
    


## RETURN VALUE



           None
    


* * *
# feholdexcept

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



           feholdexcept — save current floating-point environment
    


## SYNOPSIS



           #include <fenv.h>
    
           int feholdexcept(fenv_t *_envp_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _feholdexcept_() function shall save the current floating-point
           environment in the object pointed to by _envp_ , clear the floating-
           point status flags, and then install a non-stop (continue on
           floating-point exceptions) mode, if available, for all floating-
           point exceptions.
    


## RETURN VALUE



           The _feholdexcept_() function shall return zero if and only if non-
           stop floating-point exception handling was successfully installed.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The _feholdexcept_() function should be effective on typical
           IEC 60559:1989 standard implementations which have the default
           non-stop mode and at least one other mode for trap handling or
           aborting. If the implementation provides only the non-stop mode,
           then installing the non-stop mode is trivial.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# getpw

## NAME



           getpw - reconstruct password line entry
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <sys/types.h>**
           **#include <pwd.h>**
    
           **[[deprecated]] int getpw(uid_t** _uid_**, char ***_buf_**);**
    


## DESCRIPTION



           The **getpw**() function reconstructs the password line entry for the
           given user ID _uid_ in the buffer _buf_.  The returned buffer contains
           a line of format
    
               **name:passwd:uid:gid:gecos:dir:shell**
    
           The _passwd_ structure is defined in _< pwd.h>_ as follows:
    
               struct passwd {
                   char   *pw_name;       /* username */
                   char   *pw_passwd;     /* user password */
                   uid_t   pw_uid;        /* user ID */
                   gid_t   pw_gid;        /* group ID */
                   char   *pw_gecos;      /* user information */
                   char   *pw_dir;        /* home directory */
                   char   *pw_shell;      /* shell program */
               };
    
           For more information about the fields of this structure, see
           passwd(5).
    


## RETURN VALUE



           The **getpw**() function returns 0 on success; on error, it returns
           -1, and _errno_ is set to indicate the error.
    
           If _uid_ is not found in the password database, **getpw**() returns -1,
           sets _errno_ to 0, and leaves _buf_ unchanged.
    


## ERRORS



           **0** or **ENOENT**
                  No user corresponding to _uid_.
    
           **EINVAL** _buf_ is NULL.
    
           **ENOMEM** Insufficient memory to allocate _passwd_ structure.
    


## FILES



           _/etc/passwd_
                  password database file
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## BUGS



           The **getpw**() function is dangerous as it may overflow the provided
           buffer _buf_.  It is obsoleted by getpwuid(3).
    


* * *
# pcre2_match_data_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_match_data *pcre2_match_data_create(uint32_t** _ovecsize_**,**
             **pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function creates a new match data block, which is used for
           holding the result of a match. The first argument specifies the
           number of pairs of offsets that are required. These form the
           "output vector" (ovector) within the match data block, and are
           used to identify the matched string and any captured substrings
           when matching with **pcre2_match()** , or a number of different matches
           at the same point when used with **pcre2_dfa_match()**. There is
           always one pair of offsets; if **ovecsize** is zero, it is treated as
           one.
    
           The second argument points to a general context, for custom memory
           management, or is NULL for system memory management. The result of
           the function is NULL if the memory for the block could not be
           obtained.
    
           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.
    


* * *
# pcre2_get_match_data_heapframes_size

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



    
           This function returns the size, in bytes, of the heapframes data
           block that is owned by 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.
    


* * *
# pmindomstr

## NAME



           **pmInDomStr** , **pmInDomStr_r** - convert a performance metric instance
           domain identifier into a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmInDomStr(pmInDom** _indom_**);**
           **char *pmInDomStr_r(pmInDom** _indom_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           For use in error and diagnostic messages, **pmInDomStr** return a 'hu‐
           man readable' version of the specified instance domain identifier.
           The  **pmInDomStr_r** function does the same, but stores the result in
           a user-supplied buffer _buf_ of length  _buflen_ ,  which  should  have
           room for at least 20 bytes.
    
           The  value  for  the  instance domain _indom_ is typically extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           Internally, an instance domain  identifier  is  encoded  with  two
           fields: domain and serial.
    
           **pmInDomStr** returns  a string with each of the fields appearing as
           decimal numbers, separated by periods.
    
           The string value returned by **pmInDomStr** is held in a single static
           buffer, so the returned value is only valid until the next call to
           **pmInDomStr**.
    


## NOTES



           **pmInDomStr** returns a pointer to a static buffer and hence  is  not
           thread-safe.   Multi-threaded applications should use **pmInDomStr_r**
           instead.
    


## PCP ENVIRONMENT



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


* * *
# erff

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



           erff, erfl — error functions
    


## SYNOPSIS



           #include <math.h>
    
           float erff(float _x_);
           long double erfl(long double _x_);
    


## DESCRIPTION



           Refer to erf(3p).
    


* * *
# gnutls_fips140_context_deinit

## NAME



           gnutls_fips140_context_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_fips140_context_deinit(gnutls_fips140_context_t**
           _context_**);**
    


## ARGUMENTS



           gnutls_fips140_context_t context
                       a **gnutls_fips140_context_t**
    


## DESCRIPTION



           Uninitialize and release the FIPS context  _context_ .
    


## SINCE



           3.7.3
    


* * *
# gnutls_tpm_key_list_deinit

## NAME



           gnutls_tpm_key_list_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/tpm.h>**
    
           **void gnutls_tpm_key_list_deinit(gnutls_tpm_key_list_t** _list_**);**
    


## ARGUMENTS



           gnutls_tpm_key_list_t list
                       a list of the keys
    


## DESCRIPTION



           This function will deinitialize the list of stored keys in the
           TPM.
    


## SINCE



           3.1.0
    


* * *
# io_uring_prep_tee

## NAME



           io_uring_prep_tee - prepare a tee request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_tee(struct io_uring_sqe ***_sqe_**,**
                                  **int** _fd_in_**,**
                                  **int** _fd_out_**,**
                                  **unsigned int** _nbytes_**,**
                                  **unsigned int** _splice_flags_**);**
    


## DESCRIPTION



           The io_uring_prep_tee(3) function prepares a tee request. The
           submission queue entry _sqe_ is setup to use as input the file
           descriptor _fd_in_ and as output the file descriptor _fd_out_
           duplicating _nbytes_ bytes worth of data.  _splice_flags_ are modifier
           flags for the operation. See tee(2) for the generic splice flags.
    
           If the _fd_out_ descriptor, **IOSQE_FIXED_FILE** can be set in the SQE
           to indicate that. For the input file, the io_uring specific
           **SPLICE_F_FD_IN_FIXED** can be set and _fd_in_ given as a registered
           file descriptor offset.
    
           This function prepares an async tee(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.
    


* * *
# function::user_uint16_error

## NAME



           function::user_uint16_error - Retrieves an unsigned 16-bit integer
           value stored in user space
    


## SYNOPSIS



               user_uint16_error:long(addr:long)
    


## ARGUMENTS



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


## DESCRIPTION



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


* * *
# isastream

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



           isastream — test a file descriptor (**STREAMS**)
    


## SYNOPSIS



           #include <stropts.h>
    
           int isastream(int _fildes_);
    


## DESCRIPTION



           The _isastream_() function shall test whether _fildes_ , an open file
           descriptor, is associated with a STREAMS-based file.
    


## RETURN VALUE



           Upon successful completion, _isastream_() shall return 1 if _fildes_
           refers to a STREAMS-based file and 0 if not. Otherwise,
           _isastream_() shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



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


* * *
# gnutls_digest_list

## NAME



           gnutls_digest_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_digest_algorithm_t * gnutls_digest_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of hash (digest) algorithms supported by GnuTLS.
    
           This function is not thread safe.
    


## RETURNS



           Return a (0)-terminated list of **gnutls_digest_algorithm_t** integers
           indicating the available digests.
    


* * *
# pthread_once

## NAME



           pthread_once - once-only initialization
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **pthread_once_t** _once_control_ **= PTHREAD_ONCE_INIT;**
    
           **int pthread_once(pthread_once_t ***_once_control_**, typeof(void (void))**
           *****_init_routine_**;**
    


## DESCRIPTION



           The purpose of **pthread_once**() is to ensure that a piece of
           initialization code is executed at most once.  The _once_control_
           argument points to a static or extern variable statically
           initialized to **PTHREAD_ONCE_INIT**.
    
           The first time **pthread_once**() is called with a given _once_control_
           argument, it calls _init_routine_ with no argument and changes the
           value of the _once_control_ variable to record that initialization
           has been performed.  Subsequent calls to **pthread_once**() with the
           same _once_control_ argument do nothing.
    


## RETURN VALUE



           **pthread_once**() always returns 0.
    


## ERRORS



           None.
    


* * *
# probe::nfsd.proc.remove

## NAME



           probe::nfsd.proc.remove - NFS server removing a file for client
    


## SYNOPSIS



           nfsd.proc.remove
    


## VALUES



           _gid_
               requester's group id
    
           _filelen_
               length of file name
    
           _uid_
               requester's user id
    
           _proto_
               transfer protocol
    
           _version_
               nfs version
    
           _client_ip_
               the ip address of client
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _filename_
               file name
    


* * *
# posix_spawnattr_getpgroup

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



           posix_spawnattr_getpgroup, posix_spawnattr_setpgroup — get and set
           the spawn-pgroup attribute of a spawn attributes object (**ADVANCED**
           **REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict _attr_ ,
               pid_t *restrict _pgroup_);
           int posix_spawnattr_setpgroup(posix_spawnattr_t *_attr_ , pid_t _pgroup_);
    


## DESCRIPTION



           The _posix_spawnattr_getpgroup_() function shall obtain the value of
           the _spawn-pgroup_ attribute from the attributes object referenced
           by _attr_.
    
           The _posix_spawnattr_setpgroup_() function shall set the _spawn-_
           _pgroup_ attribute in an initialized attributes object referenced by
           _attr_.
    
           The _spawn-pgroup_ attribute represents the process group to be
           joined by the new process image in a spawn operation (if
           POSIX_SPAWN_SETPGROUP is set in the _spawn-flags_ attribute). The
           default value of this attribute shall be zero.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getpgroup_() shall
           return zero and store the value of the _spawn-pgroup_ attribute of
           _attr_ into the object referenced by the _pgroup_ parameter;
           otherwise, an error number shall be returned to indicate the
           error.
    
           Upon successful completion, _posix_spawnattr_setpgroup_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setpgroup_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn option and need not be
           provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_get_tag_type

## NAME



           **acl_get_tag_type** — get the tag type of an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_get_tag_type**(_acl_entry_t_
           _entry_d_ , _acl_tag_t *tag_type_p_)
    


## DESCRIPTION



           The **acl_get_tag_type**() function assigns to the value pointed to by
           _tag_type_p_ the tag type for the ACL entry indicated by the
           argument _entry_d_.
    
           The argument _entry_d_ and any other ACL entry descriptors that
           refer to entries in the same ACL continue to refer to those
           entries. The order of all existing entries in the ACL remain
           unchanged.
    


## RETURN VALUE



           The **acl_get_tag_type**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_get_tag_type**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _entry_d_ is not a valid descriptor
                              for an ACL entry.
    


## STANDARDS



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


* * *
# probe::signal.checkperm

## NAME



           probe::signal.checkperm - Check being performed on a sent signal
    


## SYNOPSIS



           signal.checkperm
    


## VALUES



           _si_code_
               Indicates the signal type
    
           _sig_pid_
               The PID of the process receiving the signal
    
           _name_
               Name of the probe point
    
           _sig_
               The number of the signal
    
           _sig_name_
               A string representation of the signal
    
           _pid_name_
               Name of the process receiving the signal
    
           _sinfo_
               The address of the siginfo structure
    
           _task_
               A task handle to the signal recipient
    


* * *
# gnutls_x509_crt_get_issuer_alt_name

## NAME



           gnutls_x509_crt_get_issuer_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_alt_name(gnutls_x509_crt_t** _cert_**,**
           **unsigned int** _seq_**, void ***_ian_**, size_t ***_ian_size_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * ian  is the place where the alternative name will be copied
                       to
    
           size_t * ian_size
                       holds the size of ian.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function retrieves the Issuer Alternative Name (2.5.29.18),
           contained in the given certificate in the X509v3 Certificate
           Extensions.
    
           When the SAN type is otherName, it will extract the data in the
           otherName's value field, and **GNUTLS_SAN_OTHERNAME** is returned.
           You may use **gnutls_x509_crt_get_subject_alt_othername_oid()** to get
           the corresponding OID and the "virtual" SAN types (e.g.,
           **GNUTLS_SAN_OTHERNAME_XMPP**).
    
           If an otherName OID is known, the data will be decoded.  Otherwise
           the returned data will be DER encoded, and you will have to decode
           it yourself.  Currently, only the RFC 3920 id-on-xmppAddr Issuer
           AltName is recognized.
    


## RETURNS



           the alternative issuer name type on success, one of the enumerated
           **gnutls_x509_subject_alt_name_t**.  It will return
           **GNUTLS_E_SHORT_MEMORY_BUFFER** if  _ian_size_ is not large enough to
           hold the value.  In that case  _ian_size_ will be updated with the
           required size.  If the certificate does not have an Alternative
           name with the specified sequence number then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           2.10.0
    


* * *
# wscanf

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



           wscanf — convert formatted wide-character input
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to fwscanf(3p).
    


* * *