tripathysagar/man_text huggingface dataset:
# sleep

## NAME



           sleep - sleep for a specified number of seconds
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **unsigned int sleep(unsigned int** _seconds_**);**
    


## DESCRIPTION



           **sleep**() causes the calling thread to sleep either until the number
           of real-time seconds specified in _seconds_ have elapsed or until a
           signal arrives which is not ignored.
    


## RETURN VALUE



           Zero if the requested time has elapsed, or the number of seconds
           left to sleep, if the call was interrupted by a signal handler.
    


## ATTRIBUTES



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


## VERSIONS



           On Linux, **sleep**() is implemented via nanosleep(2).  See the
           nanosleep(2) man page for a discussion of the clock used.
    
           On some systems, **sleep**() may be implemented using alarm(2) and
           **SIGALRM**(POSIX.1 permits this); mixing calls to alarm(2) and
           **sleep**() is a bad idea.
    


## STANDARDS



           POSIX.1-2008.
    


## CAVEATS



           Using longjmp(3) from a signal handler or modifying the handling
           of **SIGALRM** while sleeping will cause undefined results.
    


* * *
# pause

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



           pause — suspend the thread until a signal is received
    


## SYNOPSIS



           #include <unistd.h>
    
           int pause(void);
    


## DESCRIPTION



           The _pause_() function shall suspend the calling thread until
           delivery of a signal whose action is either to execute a signal-
           catching function or to terminate the process.
    
           If the action is to terminate the process, _pause_() shall not
           return.
    
           If the action is to execute a signal-catching function, _pause_()
           shall return after the signal-catching function returns.
    


## RETURN VALUE



           Since _pause_() suspends thread execution indefinitely unless
           interrupted by a signal, there is no successful completion return
           value. A value of -1 shall be returned and _errno_ set to indicate
           the error.
    


## ERRORS



           The _pause_() function shall fail if:
    
           **EINTR** A signal is caught by the calling process and control is
                  returned from the signal-catching function.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Many common uses of _pause_() have timing windows. The scenario
           involves checking a condition related to a signal and, if the
           signal has not occurred, calling _pause_().  When the signal occurs
           between the check and the call to _pause_(), the process often
           blocks indefinitely. The _sigprocmask_() and _sigsuspend_() functions
           can be used to avoid this type of problem.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# selinux_getpolicytype

## NAME



           selinux_getpolicytype - get the type of SELinux policy running on
           the system
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int selinux_getpolicytype(char ****_policytype_**);**
    


## DESCRIPTION



           **selinux_getpolicytype**() Reads the contents of the
           _/etc/selinux/config_ file to determine the SELinux policy used on
           the system, and sets _policytype_ accordingly. Free _policytype_ with
           free(3).
    


## RETURN VALUE



           On success, zero is returned.  On failure, -1 is returned.
    


* * *
# probe::netfilter.arp.in

## NAME



           probe::netfilter.arp.in - - Called for each incoming ARP packet
    


## SYNOPSIS



           netfilter.arp.in
    


## VALUES



           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _ar_sip_
               Ethernet+IP only (ar_pro==0x800): source IP address
    
           _ar_data_
               Address of ARP packet data region (after the header)
    
           _pf_
               Protocol family -- always “arp”
    
           _ar_sha_
               Ethernet+IP only (ar_pro==0x800): source hardware (MAC)
               address
    
           _ar_op_
               ARP opcode (command)
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _ar_pln_
               Length of protocol address
    
           _ar_tip_
               Ethernet+IP only (ar_pro==0x800): target IP address
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _ar_hln_
               Length of hardware address
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _arphdr_
               Address of ARP header
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _ar_tha_
               Ethernet+IP only (ar_pro==0x800): target hardware (MAC)
               address
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _ar_hrd_
               Format of hardware address
    
           _ar_pro_
               Format of protocol address
    


* * *
# probe::nfsd.open

## NAME



           probe::nfsd.open - NFS server opening a file for client
    


## SYNOPSIS



           nfsd.open
    


## VALUES



           _type_
               type of file (regular file or dir)
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _access_
               indicates the type of open (read/write/commit/readdir...)
    
           _client_ip_
               the ip address of client
    


* * *
# gnutls_dh_params_import_raw2

## NAME



           gnutls_dh_params_import_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_import_raw2(gnutls_dh_params_t** _dh_params_**,**
           **const gnutls_datum_t ***_prime_**, const gnutls_datum_t ***_generator_**,**
           **unsigned** _key_bits_**);**
    


## ARGUMENTS



           gnutls_dh_params_t dh_params
                       The parameters
    
           const gnutls_datum_t * prime
                       holds the new prime
    
           const gnutls_datum_t * generator
                       holds the new generator
    
           unsigned key_bits
                       the private key bits (set to zero when unknown)
    


## DESCRIPTION



           This function will replace the pair of prime and generator for use
           in the Diffie-Hellman key exchange.  The new parameters should be
           stored in the appropriate gnutls_datum.
    


## RETURNS



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


* * *
# acl_size

## NAME



           **acl_size** — get the size of the external representation of an ACL
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _ssize_t_ **acl_size**(_acl_t acl_)
    


## DESCRIPTION



           The **acl_size**() function return the size, in bytes, of the buffer
           required to hold the exportable, contiguous, persistent form of
           the ACL pointed to by the argument _acl_ , when converted by
           **acl_copy_ext**().
    
           Any existing ACL entry descriptors that refer to entries in _acl_
           continue to refer to the same entries. Any existing ACL pointers
           that refer to the ACL referred to by _acl_ continue to refer to the
           ACL. The order of ACL entries within _acl_ remains unchanged.
    


## RETURN VALUE



           On success, the **acl_size**() function returns the size in bytes of
           the contiguous, persistent form of the ACL. On error, a value of
           **(ssize_t)-1** is returned and _errno_ is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_size**() function
           returns a value of **(ssize_t)-1** and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    


## STANDARDS



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


* * *
# iovec

## NAME



           iovec - Vector I/O data structure
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/uio.h>**
    
           **struct iovec {**
               **void   *iov_base;** /* Starting address */
               **size_t  iov_len;** /* Size of the memory pointed to by _iov_base_. */
           **};**
    


## DESCRIPTION



           Describes a region of memory, beginning at _iov_base_ address and
           with the size of _iov_len_ bytes.  System calls use arrays of this
           structure, where each element of the array represents a memory
           region, and the whole array represents a vector of memory regions.
           The maximum number of _iovec_ structures in that array is limited by
           **IOV_MAX**(defined in _< limits.h>_, or accessible via the call
           _sysconf(_SC_IOV_MAX)_).
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



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


* * *
# pcap_free_datalinks

## NAME



           pcap_list_datalinks, pcap_free_datalinks - get a list of link-
           layer header types supported by a capture device, and free that
           list
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_list_datalinks(pcap_t *p, int **dlt_buf);**
           **void pcap_free_datalinks(int *dlt_list);**
    


## DESCRIPTION



           **pcap_list_datalinks**() is used to get a list of the supported link-
           layer header types of the interface associated with the pcap
           descriptor.  **pcap_list_datalinks**() allocates an array to hold the
           list and sets _*dlt_buf_ to point to that array.
    
           The caller is responsible for freeing the array with
           **pcap_free_datalinks**(), which frees the list of link-layer header
           types pointed to by _dlt_list_.
    
           It must not be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).
    


## RETURN VALUE



           **pcap_list_datalinks**() returns the number of link-layer header
           types in the array on success, **PCAP_ERROR_NOT_ACTIVATED** if called
           on a capture handle that has been created but not activated, and
           **PCAP_ERROR** on other errors.  If **PCAP_ERROR** is returned,
           **pcap_geterr**(3PCAP) or **pcap_perror**(3PCAP) may be called with _p_ as
           an argument to fetch or display the error text.
    


* * *
# function::pp

## NAME



           function::pp - Returns the active probe point
    


## SYNOPSIS



               pp:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the fully-resolved probe point associated
           with a currently running probe handler, including alias and
           wild-card expansion effects. Context: The current probe point.
    


* * *
# function::kernel_int

## NAME



           function::kernel_int - Retrieves an int value stored in kernel
           memory
    


## SYNOPSIS



               kernel_int:long(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the int from
    


## DESCRIPTION



           Returns the int value from a given kernel memory address. Reports
           an error when reading from the given address fails.
    


* * *
# gnutls_compression_get_id

## NAME



           gnutls_compression_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/compat.h>**
    
           **gnutls_compression_method_t gnutls_compression_get_id(const char ***
           _name_**);**
    


## ARGUMENTS



           const char * name
                       is a compression method name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           an id of the specified in a string compression method, or
           **GNUTLS_COMP_UNKNOWN** on error.
    


* * *
# efadv_query_device

## NAME



           efadv_query_device - Query device capabilities
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  int efadv_query_device(struct ibv_context *ibvctx,
                                 struct efadv_device_attr *attr,
                                 uint32_t inlen);
    


## DESCRIPTION



           **efadv_query_device()** Queries EFA device specific attributes.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_device_attr {
                      uint64_t comp_mask;
                      uint32_t max_sq_wr;
                      uint32_t max_rq_wr;
                      uint16_t max_sq_sge;
                      uint16_t max_rq_sge;
                      uint16_t inline_buf_size;
                      uint8_t reserved[2];
                      uint32_t device_caps;
                      uint32_t max_rdma_size;
                  };
    
           _inlen_  In: Size of struct efadv_device_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _max_sq_wr_
                  Maximum Send Queue (SQ) Work Requests (WRs).
    
           _max_rq_wr_
                  Maximum Receive Queue (RQ) Work Requests (WRs).
    
           _max_sq_sge_
                  Maximum Send Queue (SQ) Scatter Gather Elements (SGEs).
    
           _max_rq_sge_
                  Maximum Receive Queue (RQ) Scatter Gather Elements (SGEs).
    
           _inline_buf_size_
                  Maximum inline buffer size.
    
           _device_caps_
                  Bitmask of device capabilities:
    
                  EFADV_DEVICE_ATTR_CAPS_RDMA_READ: RDMA read is supported.
    
                  EFADV_DEVICE_ATTR_CAPS_RNR_RETRY: RNR retry is supported
                  for SRD QPs.
    
                  EFADV_DEVICE_ATTR_CAPS_CQ_WITH_SGID: Reading source address
                  (SGID) from receive completion descriptors is supported.
                  Valid only for unknown AH.
    
                  EFADV_DEVICE_ATTR_CAPS_RDMA_WRITE: RDMA write is supported
    
                  EFADV_DEVICE_ATTR_CAPS_UNSOLICITED_WRITE_RECV: Indicates
                  the device has support for creating QPs that can receive
                  unsolicited RDMA write with immediate.  RQ with this
                  feature enabled will not consume any work requests in order
                  to receive RDMA write with immediate and a WC generated for
                  such receive will be marked as unsolicited.
    
                  EFADV_DEVICE_ATTR_CAPS_CQ_WITH_EXT_MEM_DMABUF: Indicates
                  that creating CQs with external memory buffers by passing
                  dmabuf is supported.
    
           _max_rdma_size_
                  Maximum RDMA transfer size in bytes.
    


## RETURN VALUE



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


## NOTES



           • Compatibility mask (comp_mask) is an out field and currently has
             no values.
    


* * *
# function::indent_depth

## NAME



           function::indent_depth - returns the global nested-depth
    


## SYNOPSIS



               indent_depth:long(delta:long)
    


## ARGUMENTS



           _delta_
               the amount of depth added/removed for each call
    


## DESCRIPTION



           This function returns a number for appropriate indentation,
           similar to **indent**. Call it with a small positive or matching
           negative delta. Unlike the thread_indent_depth function, the
           indent does not track individual indent values on a per thread
           basis.
    


* * *
# setnetent

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



           setnetent — network database function
    


## SYNOPSIS



           #include <netdb.h>
    
           void setnetent(int _stayopen_);
    


## DESCRIPTION



           Refer to endnetent(3p).
    


* * *
# audit_encode_nv_string

## NAME



           audit_encode_nv_string - encode a name/value pair in a string
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **char *audit_encode_nv_string(const char ***_name_**, const char ***_value_**, unsigned int** _vlen_**)"**
    


## DESCRIPTION



           This function is used to encode a name/value pair. This should be
           used on any field being logged that potentially contains a space,
           a double-quote, or a control character. Any value containing those
           have to be specially encoded for the auparse library to correctly
           handle the value. The encoding method is designed to prevent log
           injection attacks where malicious values could cause parsing
           errors.
    
           To use this function, pass the _name_ string and _value_ strings on
           their respective arguments. If the value is likely to have a NUL
           byte embedded within it, you will need to pass a length in _vlen_
           bytes that tells how big the value is. Otherwise, you can pass a 0
           for _vlen_ and the function will simply use strlen against the _value_
           pointer. Also be aware that the _name_ of the field will cause
           auparse to do certain things when interpreting the value. If the
           _name_ is uid, a user id value in decimal is expected. Make sure
           that well known names are used for their intended purpose or that
           there is no chance of name collision with something new.
    


## RETURN VALUE



           Returns a freshly malloc'ed string that the caller must free or
           NULL on error.
    


* * *
# gnutls_x509_crq_get_extension_data

## NAME



           gnutls_x509_crq_get_extension_data - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_extension_data(gnutls_x509_crq_t** _crq_**,**
           **unsigned** _indx_**, void ***_data_**, size_t ***_sizeof_data_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned indx
                       Specifies which extension number to get. Use (0) to
                       get the first one.
    
           void * data a pointer to a structure to hold the data (may be
                       null)
    
           size_t * sizeof_data
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the requested extension data in the
           certificate.  The extension data will be stored as a string in the
           provided buffer.
    
           Use **gnutls_x509_crq_get_extension_info()** to extract the OID and
           critical flag.  Use **gnutls_x509_crq_get_extension_by_oid()**
           instead, if you want to get data indexed by the extension OID
           rather than sequence.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code in case of an error.  If your have reached the last
           extension available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be
           returned.
    


## SINCE



           2.8.0
    


* * *
# gnutls_error_to_alert

## NAME



           gnutls_error_to_alert - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_error_to_alert(int** _err_**, int ***_level_**);**
    


## ARGUMENTS



           int err     is a negative integer
    
           int * level the alert level will be stored there
    


## DESCRIPTION



           Get an alert depending on the error code returned by a gnutls
           function.  All alerts sent by this function should be considered
           fatal.  The only exception is when  _err_ is **GNUTLS_E_REHANDSHAKE** ,
           where a warning alert should be sent to the peer indicating that
           no renegotiation will be performed.
    
           If there is no mapping to a valid alert the alert to indicate
           internal error (**GNUTLS_A_INTERNAL_ERROR**) is returned.
    


## RETURNS



           the alert code to use for a particular error code.
    


* * *
# gnutls_pubkey_init

## NAME



           gnutls_pubkey_init - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_init(gnutls_pubkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_pubkey_t * key
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a public key.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# pcre2_get_ovector_pointer

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



    
           This function returns a pointer to the vector of offsets that
           forms part of the given match data block. The number of pairs can
           be found by calling **pcre2_get_ovector_count()**.
    
           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.
    


* * *
# wcsrchr

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



           wcsrchr — wide-character string scanning operation
    


## SYNOPSIS



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


## 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 _wcsrchr_() function shall locate the last occurrence of _wc_ in
           the wide-character string pointed to by _ws_.  The application shall
           ensure that the value of _wc_ is a character representable as a type
           **wchar_t** and a wide-character code corresponding to a valid
           character in the current locale. The terminating null wide-
           character code shall be considered to be part of the wide-
           character string.
    


## RETURN VALUE



           Upon successful completion, _wcsrchr_() shall return a pointer to
           the wide-character code or a null pointer if _wc_ does not occur in
           the wide-character string.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# daemon

## NAME



           daemon - run in the background
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **int daemon(int** _nochdir_**, int** _noclose_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **daemon**():
               Since glibc 2.21:
                   _DEFAULT_SOURCE
               In glibc 2.19 and 2.20:
                   _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
               Up to and including glibc 2.19:
                   _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    


## DESCRIPTION



           The **daemon**() function is for programs wishing to detach themselves
           from the controlling terminal and run in the background as system
           daemons.
    
           If _nochdir_ is zero, **daemon**() changes the process's current working
           directory to the root directory ("/"); otherwise, the current
           working directory is left unchanged.
    
           If _noclose_ is zero, **daemon**() redirects standard input, standard
           output, and standard error to _/dev/null_ ; otherwise, no changes are
           made to these file descriptors.
    


## RETURN VALUE



           (This function forks, and if the fork(2) succeeds, the parent
           calls _exit(2), so that further errors are seen by the child
           only.)  On success **daemon**() returns zero.  If an error occurs,
           **daemon**() returns -1 and sets _errno_ to any of the errors specified
           for the fork(2) and setsid(2).
    


## ATTRIBUTES



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


## VERSIONS



           A similar function appears on the BSDs.
    
           The glibc implementation can also return -1 when _/dev/null_ exists
           but is not a character device with the expected major and minor
           numbers.  In this case, _errno_ need not be set.
    


## STANDARDS



           None.
    


## BUGS



           The GNU C library implementation of this function was taken from
           BSD, and does not employ the double-fork technique (i.e., fork(2),
           setsid(2), fork(2)) that is necessary to ensure that the resulting
           daemon process is not a session leader.  Instead, the resulting
           daemon _is_ a session leader.  On systems that follow System V
           semantics (e.g., Linux), this means that if the daemon opens a
           terminal that is not already a controlling terminal for another
           session, then that terminal will inadvertently become the
           controlling terminal for the daemon.
    


* * *
# strtoumax

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



           strtoumax — convert a string to an integer type
    


## SYNOPSIS



           #include <inttypes.h>
    
           uintmax_t strtoumax(const char *restrict _nptr_ , char **restrict _endptr_ ,
               int _base_);
    


## DESCRIPTION



           Refer to strtoimax(3p).
    


* * *
# function::usymline

## NAME



           function::usymline - Return the line number of an address.
    


## SYNOPSIS



               usymline:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the (approximate) line number of the given address, if
           known. If the line number cannot be found, the hex string
           representation of the address will be returned.
    


* * *
# audit_flag_to_name

## NAME



           audit_flag_to_name - Convert the numeric rule-matching filter
           value to the rule-matching filter name
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **const char *audit_flag_to_name(int** _flag_**);**
    


## DESCRIPTION



           **audit_flag_to_name**() converts the numeric rule-matching filter
           value (AUDIT_FILTER_TASK, AUDIT_FILTER_EXIT, AUDIT_FILTER_USER,
           AUDIT_FILTER_EXCLUDE, AUDIT_FILTER_FS) to the rule-matching filter
           name ("task", "exit", "user", "exclude", "filesystem").  _flag_ is
           the numeric rule-matching filter value.
    


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, the return value is
           the rule-matching filter name.
    


* * *
# function::set_int_arg

## NAME



           function::set_int_arg - Set function argument as signed int
    


## SYNOPSIS



               set_int_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the value of argument n as a signed int (i.e., a 32-bit
           integer sign-extended to 64 bits).
    


* * *
# function::user_int16

## NAME



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


## SYNOPSIS



               user_int16:long(addr:long)
    


## ARGUMENTS



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


## DESCRIPTION



           Returns the 16-bit integer value from a given user space address.
           Returns zero when user space data is not accessible.
    


* * *
# gnutls_transport_set_ptr2

## NAME



           gnutls_transport_set_ptr2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_ptr2(gnutls_session_t** _session_**,**
           **gnutls_transport_ptr_t** _recv_ptr_**, gnutls_transport_ptr_t** _send_ptr_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_transport_ptr_t recv_ptr
                       is the value for the pull function
    
           gnutls_transport_ptr_t send_ptr
                       is the value for the push function
    


## DESCRIPTION



           Used to set the first argument of the transport function (for push
           and pull callbacks). In berkeley style sockets this function will
           set the connection descriptor.  With this function you can use two
           different pointers for receiving and sending.
    


* * *
# probe::irq_handler.entry

## NAME



           probe::irq_handler.entry - Execution of interrupt handler starting
    


## SYNOPSIS



           irq_handler.entry
    


## VALUES



           _handler_
               interrupt handler function
    
           _thread_fn_
               interrupt handler function for threaded interrupts
    
           _action_
               struct irqaction* for this interrupt num
    
           _dev_name_
               name of device
    
           _dir_
               pointer to the proc/irq/NN/name entry
    
           _next_irqaction_
               pointer to next irqaction for shared interrupts
    
           _flags_str_
               symbolic string representation of IRQ flags
    
           _thread_
               thread pointer for threaded interrupts
    
           _flags_
               Flags for IRQ handler
    
           _dev_id_
               Cookie to identify device
    
           _irq_
               irq number
    
           _thread_flags_
               Flags related to thread
    


* * *
# gnutls_ocsp_resp_get_single

## NAME



           gnutls_ocsp_resp_get_single - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_single(gnutls_ocsp_resp_const_t** _resp_**,**
           **unsigned** _indx_**, gnutls_digest_algorithm_t ***_digest_**, gnutls_datum_t**
           *****_issuer_name_hash_**, gnutls_datum_t ***_issuer_key_hash_**,**
           **gnutls_datum_t ***_serial_number_**, unsigned int ***_cert_status_**, time_t**
           *****_this_update_**, time_t ***_next_update_**, time_t ***_revocation_time_**,**
           **unsigned int ***_revocation_reason_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           unsigned indx
                       Specifies response number to get. Use (0) to get the
                       first one.
    
           gnutls_digest_algorithm_t * digest
                       output variable with **gnutls_digest_algorithm_t** hash
                       algorithm
    
           gnutls_datum_t * issuer_name_hash
                       output buffer with hash of issuer's DN
    
           gnutls_datum_t * issuer_key_hash
                       output buffer with hash of issuer's public key
    
           gnutls_datum_t * serial_number
                       output buffer with serial number of certificate to
                       check
    
           unsigned int * cert_status
                       a certificate status, a **gnutls_ocsp_cert_status_t**
                       enum.
    
           time_t * this_update
                       time at which the status is known to be correct.
    
           time_t * next_update
                       when newer information will be available, or
                       (time_t)-1 if unspecified
    
           time_t * revocation_time
                       when  _cert_status_ is **GNUTLS_OCSP_CERT_REVOKED** , holds
                       time of revocation.
    
           unsigned int * revocation_reason
                       revocation reason, a **gnutls_x509_crl_reason_t** enum.
    


## DESCRIPTION



           This function will return the certificate information of the
            _indx_ 'ed response in the Basic OCSP Response  _resp_ .  The
           information returned corresponds to the OCSP SingleResponse
           structure except the final singleExtensions.
    
           Each of the pointers to output variables may be NULL to indicate
           that the caller is not interested in that value.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last CertID
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# gnutls_x509_privkey_sign_hash

## NAME



           gnutls_x509_privkey_sign_hash - API function
    


## SYNOPSIS



           **#include <gnutls/compat.h>**
    
           **int gnutls_x509_privkey_sign_hash(gnutls_x509_privkey_t** _key_**, const**
           **gnutls_datum_t ***_hash_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           const gnutls_datum_t * hash
                       holds the data to be signed
    
           gnutls_datum_t * signature
                       will contain newly allocated signature
    


## DESCRIPTION



           This function will sign the given hash using the private key. Do
           not use this function directly unless you know what it is. Typical
           signing requires the data to be hashed and stored in special
           formats (e.g. BER Digest-Info for RSA).
    
           This API is provided only for backwards compatibility, and thus
           restricted to RSA, DSA and ECDSA key types. For other key types
           please use **gnutls_privkey_sign_hash()** and
           **gnutls_privkey_sign_data()**.
    


## RETURNS



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


* * *
# libpfm_intel_icx_unc_upi

## NAME



           libpfm_intel_icx_unc_upi - support for Intel IcelakeX Server UPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_upi[0-3]**
           **PMU desc: Intel IcelakeX UPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX UPI (Ultra Path
           Interconnect) uncore PMU.  Each UPI PMU implements 4 generic
           counters.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX UPI 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 IRP clockticks 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.
    


* * *
# getwc

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



           getwc — get a wide character from a stream
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           wint_t getwc(FILE *_stream_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _getwc_() function shall be equivalent to _fgetwc_(), except that
           if it is implemented as a macro it may evaluate _stream_ more than
           once, so the argument should never be an expression with side-
           effects.
    


## RETURN VALUE



           Refer to fgetwc(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_record_recv_packet

## NAME



           gnutls_record_recv_packet - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_recv_packet(gnutls_session_t** _session_**,**
           **gnutls_packet_t ***_packet_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_packet_t * packet
                       the structure that will hold the packet data
    


## DESCRIPTION



           This is a lower-level function than **gnutls_record_recv()** and
           allows to directly receive the whole decrypted packet. That avoids
           a memory copy, and is intended to be used by applications seeking
           high performance.
    
           The received packet is accessed using **gnutls_packet_get()** and must
           be deinitialized using **gnutls_packet_deinit()**. The returned packet
           will be **NULL** if the return value is zero (EOF).
    


## RETURNS



           The number of bytes received and zero on EOF (for stream
           connections).  A negative error code is returned in case of an
           error.
    


## SINCE



           3.3.5
    


* * *
# libpfm_intel_bdx_unc_r3qpi

## NAME



           libpfm_intel_bdx_unc_r3qpi - support for Intel Broadwell Server
           R3QPI uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_r3qpi[0-2]**
           **PMU desc: Intel Broadwell server R3QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell server R3QPI uncore PMU.
           This PMU model only exists on various Broadwell server models (79,
           86).
    


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server
           R3PQI  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 R3QPI 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].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# security_disable

## NAME



           security_disable - disable the SELinux kernel code at runtime
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int security_disable(void);**
    


## DESCRIPTION



           **security_disable**() disables the SELinux kernel code, unregisters
           selinuxfs from _/proc/filesystems_ , and then unmounts
           _/sys/fs/selinux_.
    
           This function is only supported on Linux 6.3 and earlier, and can
           only be called at runtime and prior to the initial policy load.
           After the initial policy load, the SELinux kernel code cannot be
           disabled, but only placed in "permissive" mode by using
           security_setenforce(3).
    


## RETURN VALUE



           **security_disable**() returns zero on success or -1 on error.
    


* * *
# dane_cert_type_name

## NAME



           dane_cert_type_name - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **const char * dane_cert_type_name(dane_cert_type_t** _type_**);**
    


## ARGUMENTS



           dane_cert_type_t type
                       is a DANE match type
    


## DESCRIPTION



           Convert a **dane_cert_type_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified type, or **NULL**.
    


* * *
# fesetexceptflag

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



           fesetexceptflag — set floating-point status flags
    


## SYNOPSIS



           #include <fenv.h>
    
           int fesetexceptflag(const fexcept_t *_flagp_ , int _excepts_);
    


## DESCRIPTION



           Refer to fegetexceptflag(3p).
    


* * *
# audit_name_to_action

## NAME



           audit_name_to_action, audit_action_to_name - Convert the action
           name to the numeric action value to each other
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_name_to_action(const char** _*action_**);**
    
           **const char *audit_action_to_name(int** _action_**);**
    


## DESCRIPTION



           **audit_name_to_action**() converts the action name ("never",
           "possible", "always") to the numeric action value (AUDIT_NEVER,
           AUDIT_POSSIBLE, AUDIT_ALWAYS).  _action_ is the action name.
    
           **audit_action_to_name**() converts the numeric action value
           (AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS) to the action name
           ("never", "possible", "always").  _action_ is the numeric action
           value
    


## RETURN VALUE



           **audit_name_to_action**() returns -1 if an error occurs; otherwise,
           the return value is the numeric action value.
    
           **audit_action_to_name**() returns NULL if an error occurs; otherwise,
           the return value is the action name.
    


* * *
# libpfm_arm_neoverse_v3

## NAME



           libpfm_arm_neoverse_v3 - support for Arm Neoverse V3 core PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_v3**
           **PMU desc: Arm Neoverse V3**
    


## DESCRIPTION



           The library supports the Arm Neoverse V3 core PMU.
    
           This PMU supports 6 counters and privilege levels filtering.  It
           can operate in both 32 and 64 bit modes.
    


## MODIFIERS



           The following modifiers are supported on Arm Neoverse V3:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *