tripathysagar/man_text huggingface dataset:
# pmdachildren

## NAME



           **pmdaChildren** - translate a PMID to a set of dynamic performance
           metric names
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaChildren(char ***_name_**, int** _traverse_**, char *****_offspring_**,**
                            **int ****_status_**, pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), **pmdaChildren** is the generic callback for  returning  dy‐
           namic  metric  names  (and  their  status) that are descendants of
           _name_.
    
           Because implementing dynamic performance metrics requires specific
           PMDA support, and the facility is an optional component of a  PMDA
           (most PMDAs do **not** support dynamic performance metrics), **pmdaChil‐**
           **dren** is a skeleton implementation that returns **PM_ERR_NAME**.
    
           A  PMDA  that  supports dynamic performance metrics will provide a
           private callback that replaces **pmdaChildren**(by assignment to _ver‐_
           _sion.four.children_ of the _pmdaInterface_ structure) and  takes  the
           initial metric _name_ and returns names via _offspring_[] and the leaf
           or non-leaf status of each via _status_[].
    
           If  _traverse_  is 0, then the behaviour is akin to pmGetChildren(3)
           and _offspring_[] contains the relative name component for the imme‐
           diate descendants of _name._
    
           If _traverse_ is 1, then the behaviour is akin to  pmTraversePMNS(3)
           and _offspring_[] contains the absolute names of all dynamic metrics
           that are decedents of _name_.
    
           The  resulting  list  of  pointers _offspring_ **and** the string values
           (the names) that the pointers reference will have  been  allocated
           by **pmdaChildren** with a single call to malloc(3), and the caller of
           **pmdaChildren** will  call **free**(_offspring_) to release the space when
           it is no longer required.  The same holds true for the _status_  ar‐
           ray,  namely  the caller of **pmdaChildren** will call **free**(_status_) to
           release the space when it is no longer required.
    


## CAVEAT



           The PMDA must be using **PMDA_INTERFACE_4** or later, as specified  in
           the call to pmdaDSO(3) or pmdaDaemon(3).
    


## DIAGNOSTICS



           **pmdaChildren** returns **PM_ERR_NAME** if the name is not recognized or
           cannot be translated, otherwise the number  of  descendent  metric
           names found.
    


* * *
# blksize_t

## NAME



           blksize_t - file block sizes
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



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


## DESCRIPTION



           Used for file block sizes.  It is a signed integer type.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_x509_privkey_import_ecc_raw

## NAME



           gnutls_x509_privkey_import_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_ecc_raw(gnutls_x509_privkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**, const gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    
           const gnutls_datum_t * k
                       holds the k
    


## DESCRIPTION



           This function will convert the given elliptic curve parameters to
           the native **gnutls_x509_privkey_t** format.  The output will be
           stored in  _key_ . For EdDSA keys, the  _x_ and  _k_ values must be in
           the native to curve format.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# clog

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



           clog, clogf, clogl — complex natural logarithm functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex clog(double complex _z_);
           float complex clogf(float complex _z_);
           long double complex clogl(long double complex _z_);
    


## DESCRIPTION



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


## RETURN VALUE



           These functions shall return the complex natural logarithm value,
           in the range of a strip mathematically unbounded along the real
           axis and in the interval [-_i_ π, +_i_ π] along the imaginary axis.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pubkey_import_url

## NAME



           gnutls_pubkey_import_url - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_url(gnutls_pubkey_t** _key_**, const char ***
           _url_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       A key of type **gnutls_pubkey_t**
    
           const char * url
                       A PKCS 11 url
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will import a public key from the provided URL.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# gnutls_global_set_time_function

## NAME



           gnutls_global_set_time_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_set_time_function(gnutls_time_func** _time_func_**);**
    


## ARGUMENTS



           gnutls_time_func time_func
                       it's the system time function, a **gnutls_time_func()**
                       callback.
    


## DESCRIPTION



           This is the function where you can override the default system
           time function.  The application provided function should behave
           the same as the standard function.
    


## SINCE



           2.12.0
    


* * *
# pcre2_jit_stack_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_jit_stack_free(pcre2_jit_stack ***_jit_stack_**);**
    


## DESCRIPTION



    
           This function is used to free a JIT stack that was created by
           **pcre2_jit_stack_create()** when it is no longer needed. If the
           argument is NULL, the function returns immediately without doing
           anything. For more details, see the **pcre2jit** page.
    
           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.
    


* * *
# gnutls_x509_crt_get_pk_algorithm

## NAME



           gnutls_x509_crt_get_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_algorithm(gnutls_x509_crt_t** _cert_**,**
           **unsigned int ***_bits_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int * bits
                       if bits is non null it will hold the size of the
                       parameters' in bits
    


## DESCRIPTION



           This function will return the public key algorithm of an X.509
           certificate.
    
           If bits is non null, it should have enough size to hold the
           parameters size in bits. For RSA the bits returned is the modulus.
           For DSA the bits returned are of the public exponent.
    
           Unknown/unsupported algorithms are mapped to **GNUTLS_PK_UNKNOWN**.
    


## RETURNS



           a member of the **gnutls_pk_algorithm_t** enumeration on success, or a
           negative error code on error.
    


* * *
# gnutls_pkcs12_bag_decrypt

## NAME



           gnutls_pkcs12_bag_decrypt - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_decrypt(gnutls_pkcs12_bag_t** _bag_**, const char**
           *****_pass_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           const char * pass
                       The password used for encryption, must be ASCII.
    


## DESCRIPTION



           This function will decrypt the given encrypted bag and return 0 on
           success.
    


## RETURNS



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


* * *
# function::fp_add

## NAME



           function::fp_add - Addition between floating points
    


## SYNOPSIS



               fp_add:long(add1:long,add2:long)
    


## ARGUMENTS



           _add1_
               the 64 bit floating point addend
    
           _add2_
               second 64 bit floating point addend
    


## DESCRIPTION



           Given addend 1 and addend 2, apply floating point adding
    


* * *
# sched_getparam

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



           sched_getparam — get scheduling parameters (**REALTIME**)
    


## SYNOPSIS



           #include <sched.h>
    
           int sched_getparam(pid_t _pid_ , struct sched_param *_param_);
    


## DESCRIPTION



           The _sched_getparam_() function shall return the scheduling
           parameters of a process specified by _pid_ in the **sched_param**
           structure pointed to by _param_.
    
           If a process specified by _pid_ exists, and if the calling process
           has permission, the scheduling parameters for the process whose
           process ID is equal to _pid_ shall be returned.
    
           If _pid_ is zero, the scheduling parameters for the calling process
           shall be returned. The behavior of the _sched_getparam_() function
           is unspecified if the value of _pid_ is negative.
    


## RETURN VALUE



           Upon successful completion, the _sched_getparam_() function shall
           return zero. If the call to _sched_getparam_() is unsuccessful, the
           function shall return a value of -1 and set _errno_ to indicate the
           error.
    


## ERRORS



           The _sched_getparam_() function shall fail if:
    
           **EPERM** The requesting process does not have permission to obtain
                  the scheduling parameters of the specified process.
    
           **ESRCH** No process can be found corresponding to that specified by
                  _pid_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_certificate_set_dh_params

## NAME



           gnutls_certificate_set_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_dh_params(gnutls_certificate_credentials_t**
           _res_**, gnutls_dh_params_t** _dh_params_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           gnutls_dh_params_t dh_params
                       the Diffie-Hellman parameters.
    


## DESCRIPTION



           This function will set the Diffie-Hellman parameters for a
           certificate server to use. These parameters will be used in
           Ephemeral Diffie-Hellman cipher suites.  Note that only a pointer
           to the parameters are stored in the certificate handle, so you
           must not deallocate the parameters before the certificate is
           deallocated.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# gnutls_session_etm_status

## NAME



           gnutls_session_etm_status - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_session_etm_status(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the status of the encrypt-then-mac extension negotiation.
           This is in accordance to rfc7366
    


## RETURNS



           Non-zero if the negotiation was successful or zero otherwise.
    


* * *
# aiocb

## NAME



           aiocb - asynchronous I/O control block
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <aio.h>**
    
           **struct aiocb {**
               **int             aio_fildes;** /* File descriptor */
               **off_t           aio_offset;** /* File offset */
               **volatile void  *aio_buf;** /* Location of buffer */
               **size_t          aio_nbytes;** /* Length of transfer */
               **int             aio_reqprio;** /* Request priority offset */
               **struct sigevent aio_sigevent;** /* Signal number and value */
               **int             aio_lio_opcode;** /* Operation to be performed */
           **};**
    


## DESCRIPTION



           For further information about this structure, see aio(7).
    


## STANDARDS



           POSIX.1-2008.
    


* * *
# libpfm_arm_neoverse_v1

## NAME



           libpfm_arm_neoverse_v1 - support for Arm Neoverse V1 core PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the Arm Neoverse V1 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 V1:
    
           **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.
    


* * *
# probe::netdev.change_mtu

## NAME



           probe::netdev.change_mtu - Called when the netdev MTU is changed
    


## SYNOPSIS



           netdev.change_mtu
    


## VALUES



           _new_mtu_
               The new MTU
    
           _old_mtu_
               The current MTU
    
           _dev_name_
               The device that will have the MTU changed
    


* * *
# dane_strerror

## NAME



           dane_strerror - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **const char * dane_strerror(int** _error_**);**
    


## ARGUMENTS



           int error   is a DANE error code, a negative error code
    


## DESCRIPTION



           This function is similar to strerror.  The difference is that it
           accepts an error number returned by a gnutls function; In case of
           an unknown error a descriptive string is sent instead of **NULL**.
    
           Error codes are always a negative error code.
    


## RETURNS



           A string explaining the DANE error message.
    


* * *
# gnutls_cipher_set_iv

## NAME



           gnutls_cipher_set_iv - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_cipher_set_iv(gnutls_cipher_hd_t** _handle_**, void ***_iv_**,**
           **size_t** _ivlen_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           void * iv   the IV to set
    
           size_t ivlen
                       the length of the IV
    


## DESCRIPTION



           This function will set the IV to be used for the next encryption
           block.
    


## SINCE



           3.0
    


* * *
# trunc

## NAME



           trunc, truncf, truncl - round to integer, toward zero
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double trunc(double** _x_**);**
           **float truncf(float** _x_**);**
           **long double truncl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **trunc**(), **truncf**(), **truncl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions round _x_ to the nearest integer value that is not
           larger in magnitude than _x_.
    


## RETURN VALUE



           These functions return the rounded integer value, in floating
           format.
    
           If _x_ is integral, infinite, or NaN, _x_ itself is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The integral value returned by these functions may be too large to
           store in an integer type (_int_ , _long_ , etc.).  To avoid an overflow,
           which will produce undefined results, an application should
           perform a range check on the returned value before assigning it to
           an integer type.
    


* * *
# gnutls_certificate_verify_peers2

## NAME



           gnutls_certificate_verify_peers2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_certificate_verify_peers2(gnutls_session_t** _session_**,**
           **unsigned int ***_status_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           unsigned int * status
                       is the output of the verification
    


## DESCRIPTION



           This function will verify the peer's certificate and store the
           status in the  _status_ variable as a bitwise OR of
           gnutls_certificate_status_t values or zero if the certificate is
           trusted. Note that value in  _status_ is set only when the return
           value of this function is success (i.e, failure to trust a
           certificate does not imply a negative return value).  The default
           verification flags used by this function can be overridden using
           **gnutls_certificate_set_verify_flags()**.
    
           This function will take into account the stapled OCSP responses
           sent by the server, as well as the following X.509 certificate
           extensions: Name Constraints, Key Usage, and Basic Constraints
           (pathlen).
    
           Note that you must also check the peer's name in order to check if
           the verified certificate belongs to the actual peer, see
           **gnutls_x509_crt_check_hostname()** , or use
           **gnutls_certificate_verify_peers3()**.
    
           To avoid denial of service attacks some default upper limits
           regarding the certificate key size and chain size are set. To
           override them use **gnutls_certificate_set_verify_limits()**.
    
           Note that when using raw public-keys verification will not work
           because there is no corresponding certificate body belonging to
           the raw key that can be verified. In that case this function will
           return **GNUTLS_E_INVALID_REQUEST**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) when the validation is performed, or a
           negative error code otherwise.  A successful error code means that
           the  _status_ parameter must be checked to obtain the validation
           status.
    


* * *
# pcap_stats

## NAME



           pcap_stats - get capture statistics
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_stats(pcap_t *p, struct pcap_stat *ps);**
    


## DESCRIPTION



           **pcap_stats**() fills in the **struct pcap_stat** pointed to by its
           second argument.  The values represent packet statistics from the
           start of the run to the time of the call.
    
           **pcap_stats**() is supported only on live captures, not on
           ``savefiles''; no statistics are stored in ``savefiles'', so no
           statistics are available when reading from a ``savefile''.
    
           A **struct pcap_stat** has the following members:
    
                  **ps_recv**
                         number of packets received;
    
                  **ps_drop**
                         number of packets dropped because there was no room
                         in the operating system's buffer when they arrived,
                         because packets weren't being read fast enough;
    
                  **ps_ifdrop**
                         number of packets dropped by the network interface
                         or its driver.
    
           The statistics do not behave the same way on all platforms.
           **ps_recv** might count packets whether they passed any filter set
           with **pcap_setfilter**(3PCAP) or not, or it might count only packets
           that pass the filter.  It also might, or might not, count packets
           dropped because there was no room in the operating system's buffer
           when they arrived.  **ps_drop** is not available on all platforms; it
           is zero on platforms where it's not available.  If packet
           filtering is done in libpcap, rather than in the operating system,
           it would count packets that don't pass the filter.  Both **ps_recv**
           and **ps_drop** might, or might not, count packets not yet read from
           the operating system and thus not yet seen by the application.
           **ps_ifdrop** might, or might not, be implemented; if it's zero, that
           might mean that no packets were dropped by the interface, or it
           might mean that the statistic is unavailable, so it should not be
           treated as an indication that the interface did not drop any
           packets.
    


## RETURN VALUE



           **pcap_stats**() returns **0** on success, **PCAP_ERROR_NOT_ACTIVATED** if
           called on a capture handle that has been created but not
           activated, or **PCAP_ERROR** if there is another error or if _p_ doesn't
           support packet statistics. 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.
    


* * *
# selinux_colors_path

## NAME



           selinux_colors_path - Return a path to the active SELinux policy
           color configuration file
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **const char *selinux_colors_path(void);**
    


## DESCRIPTION



           **selinux_colors_path**() returns the path to the active policy color
           configuration file.
    
           The path is built from the path returned by selinux_policy_root(3)
           with _/secolor.conf_ appended.
    
           This optional configuration file whose format is shown in
           secolor.conf(5), controls the colors to be associated with the _raw_
           context components of the selinux_raw_context_to_color(3) function
           when information is to be displayed by an SELinux color-aware
           application.
    


## RETURN VALUE



           On success, the path to the active policy color configuration file
           is returned. If a path is not available NULL is returned.
    


## ERRORS



           None.
    


* * *
# io_uring_free_probe

## NAME



           io_uring_free_probe - free probe instance
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_free_probe(struct io_uring_probe ***_probe_**);**
    


## DESCRIPTION



           The function io_uring_free_probe(3) frees the _probe_ instance
           allocated with the io_uring_get_probe(3) function.
    


## RETURN VALUE



           None
    


* * *
# posix_trace_attr_getstreamfullpolicy

## 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_trace_attr_getstreamfullpolicy — retrieve and set the
           behavior of a trace stream (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_attr_getstreamfullpolicy(const trace_attr_t *restrict
               _attr_ , int *restrict _streampolicy_);
    


## DESCRIPTION



           Refer to posix_trace_attr_getinherited(3p).
    


* * *
# probe::scsi.ioexecute

## NAME



           probe::scsi.ioexecute - Create mid-layer SCSI request and wait for
           the result
    


## SYNOPSIS



           scsi.ioexecute
    


## VALUES



           _host_no_
               The host number
    
           _channel_
               The channel number
    
           _request_bufflen_
               The data buffer buffer length
    
           _timeout_
               Request timeout in seconds
    
           _lun_
               The lun number
    
           _request_buffer_
               The data buffer address
    
           _device_state_
               The current state of the device
    
           _retries_
               Number of times to retry request
    
           _dev_id_
               The scsi device id
    
           _device_state_str_
               The current state of the device, as a string
    
           _data_direction_
               The data_direction specifies whether this command is from/to
               the device.
    
           _data_direction_str_
               Data direction, as a string
    


* * *
# io_uring_register_file_alloc_range

## NAME



           io_uring_register_file_alloc_range - set range for fixed file
           allocations
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_file_alloc_range(struct io_uring ***_ring_**,**
                                                  **unsigned** _off_**,**
                                                  **unsigned** _len_**);**
    


## DESCRIPTION



           The io_uring_register_file_alloc_range(3) function sets the
           allowable range for fixed file index allocations within the
           kernel. When requests that can instantiate a new fixed file are
           used with **IORING_FILE_INDEX_ALLOC ,** the application is asking the
           kernel to allocate a new fixed file descriptor rather than pass in
           a specific value for one. By default, the kernel will pick any
           available fixed file descriptor within the range available.
           Calling this function with _off_ set to the starting offset and _len_
           set to the number of descriptors, the application can limit the
           allocated descriptors to that particular range. This effectively
           allows the application to set aside a range just for dynamic
           allocations, with the remainder being used for specific values.
    
           The application must have registered a fixed file table upfront,
           eg through io_uring_register_files(3) or
           io_uring_register_files_sparse(3).
    
           Available since 6.0.
    


## RETURN VALUE



           On success io_uring_register_file_alloc_range(3) returns 0. On
           failure it returns **-errno**.
    


* * *
# function::ntohs

## NAME



           function::ntohs - Convert 16-bit short from network to host order
    


## SYNOPSIS



               ntohs:long(x:long)
    


## ARGUMENTS



           _x_
               Value to convert
    


* * *
# swprintf

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



           swprintf — print formatted wide-character output
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           int swprintf(wchar_t *restrict _ws_ , size_t _n_ ,
               const wchar_t *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fwprintf(3p).
    


* * *
# function::error

## NAME



           function::error - Send an error message
    


## SYNOPSIS



               error(msg:string)
    


## ARGUMENTS



           _msg_
               The formatted message string
    


## DESCRIPTION



           An implicit end-of-line is added. staprun prepends the string
           “ERROR:”. Sending an error message aborts the currently running
           probe. Depending on the MAXERRORS parameter, it may trigger an
           **exit**.
    


* * *
# dprintf

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



           dprintf — print formatted output
    


## SYNOPSIS



           #include <stdio.h>
    
           int dprintf(int _fildes_ , const char *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fprintf(3p).
    


* * *
# lrint

## NAME



           lrint, lrintf, lrintl, llrint, llrintf, llrintl - round to nearest
           integer
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **long lrint(double** _x_**);**
           **long lrintf(float** _x_**);**
           **long lrintl(long double** _x_**);**
    
           **long long llrint(double** _x_**);**
           **long long llrintf(float** _x_**);**
           **long long llrintl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           All functions shown above:
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions round their argument to the nearest integer value,
           using the current rounding direction (see fesetround(3)).
    
           Note that unlike the rint(3) family of functions, the return type
           of these functions differs from that of their arguments.
    


## RETURN VALUE



           These functions return the rounded integer value.
    
           If _x_ is a NaN or an infinity, or the rounded value is too large to
           be stored in a _long_ (_long long_ in the case of the **ll*** functions),
           then a domain error occurs, and the return value is unspecified.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x_ is a NaN or infinite, or the rounded value is too
           large
                  An invalid floating-point exception (**FE_INVALID**) is raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::user_short_warn

## NAME



           function::user_short_warn - Retrieves a short value stored in user
           space
    


## SYNOPSIS



               user_short_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the short from
    


## DESCRIPTION



           Returns the short value from a given user space address. Returns
           zero when user space data is not accessible and warns about the
           failure (but does not error).
    


* * *
# gnutls_pkcs11_obj_get_info

## NAME



           gnutls_pkcs11_obj_get_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_get_info(gnutls_pkcs11_obj_t** _obj_**,**
           **gnutls_pkcs11_obj_info_t** _itype_**, void ***_output_**, size_t ***
           _output_size_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       should contain a **gnutls_pkcs11_obj_t** type
    
           gnutls_pkcs11_obj_info_t itype
                       Denotes the type of information requested
    
           void * output
                       where output will be stored
    
           size_t * output_size
                       contains the maximum size of the output buffer and
                       will be overwritten with the actual size.
    


## DESCRIPTION



           This function will return information about the PKCS11 certificate
           such as the label, id as well as token information where the key
           is stored.
    
           When output is text, a null terminated string is written to
           _output_ and its string length is written to  _output_size_ (without
           null terminator). If the buffer is too small,  _output_size_ will
           contain the expected buffer size (with null terminator for text)
           and return **GNUTLS_E_SHORT_MEMORY_BUFFER**.
    
           In versions previously to 3.6.0 this function included the null
           terminator to  _output_size_ . After 3.6.0 the output size doesn't
           include the terminator character.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# auparse_feed_age_events

## NAME



           auparse_feed_age_events - check events for complete based on time.
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **void auparse_feed_age_events(auparse_state_t ***_au);"_
    


## DESCRIPTION



           _auparse_feed_age_events_ should be called to see if any events are
           complete based on the current clock time. Any newly complete
           events will be passed to the callback function.
    


## RETURN VALUE



           None.
    


* * *
# munlock

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



           munlock — unlock a range of process address space
    


## SYNOPSIS



           #include <sys/mman.h>
    
           int munlock(const void *_addr_ , size_t _len_);
    


## DESCRIPTION



           Refer to mlock(3p).
    


* * *
# probe::scsi.ioentry

## NAME



           probe::scsi.ioentry - Prepares a SCSI mid-layer request
    


## SYNOPSIS



           scsi.ioentry
    


## VALUES



           _req_addr_
               The current struct request pointer, as a number
    
           _disk_minor_
               The minor number of the disk (-1 if no information)
    
           _device_state_str_
               The current state of the device, as a string
    
           _disk_major_
               The major number of the disk (-1 if no information)
    
           _device_state_
               The current state of the device
    


* * *
# gnutls_x509_crt_get_serial

## NAME



           gnutls_x509_crt_get_serial - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_serial(gnutls_x509_crt_t** _cert_**, void ***
           _result_**, size_t ***_result_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           void * result
                       The place where the serial number will be copied
    
           size_t * result_size
                       Holds the size of the result field.
    


## DESCRIPTION



           This function will return the X.509 certificate's serial number.
           This is obtained by the X509 Certificate serialNumber field.
           Serial is not always a 32 or 64bit number. Some CAs use large
           serial numbers, thus it may be wise to handle it as something
           uint8_t.
    


## RETURNS



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


* * *
# pmaddderivedtext

## NAME



           **pmAddDerivedText** - add help text for a derived metric
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmAddDerivedText(const char ***_name_**, int** _type_**,**
                                **const char ***_text_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Derived metrics provide a way of extending the Performance Metrics
           Name  Space (PMNS) with new metrics defined at the PCP client-side
           using expressions over the existing performance  metrics.   Global
           derived   metrics   are   defined  using  pmRegisterDerived(3)  or
           pmRegisterDerivedMetric(3) or pmLoadDerivedConfig(3), and per-con‐
           text  derived  metrics  are  defined  using   pmAddDerived(3)   or
           pmAddDerivedMetric(3).
    
           Once  a  derived  metric has been defined, **pmAddDerivedText** may be
           used to associate the help _text_ with the derived metric identified
           by _name_.
    
           Help text may be a ``one line'' summary or a more verbose ``multi-
           line'' block of  text,  and  _type_  should  be  **PM_TEXT_ONELINE** or
           **PM_TEXT_HELP** respectively.  To associate both styles of help text
           with a derived metric, **pmAddDerivedText** would need  to  be  called
           twice with different values for _type_.
    
           Once a particular _type_ of help text has been associated with a de‐
           rived metric it cannot be deleted or redefined.
    
           Applications using the Performance Metrics Application Programming
           Interface (PMAPI) are able to retrieve help text for specific met‐
           rics using pmLookupText(3).
    


## DIAGNOSTICS



           **pmAddDerivedText** returns zero on success, else an error code.
    
           The return value **PM_ERR_NAME** indicates _name_ does not correspond to
           a previously defined derived metric.
    
           Repeated  calls  for  the  same _name_ and _type_ will result a return
           value of **PM_ERR_TEXT**.
    
           A return value of **PM_ERR_ARG** indicates that _type_ is not one of the
           expected values.
    


* * *
# function::cmdline_args

## NAME



           function::cmdline_args - Fetch command line arguments from current
           process
    


## SYNOPSIS



               cmdline_args:string(n:long,m:long,delim:string)
    


## ARGUMENTS



           _n_
               First argument to get (zero is normally the program itself)
    
           _m_
               Last argument to get (or minus one for all arguments after n)
    
           _delim_
               String to use to separate arguments when more than one.
    


## DESCRIPTION



           Returns arguments from the current process starting with argument
           number n, up to argument m. If there are less than n arguments, or
           the arguments cannot be retrieved from the current process, the
           empty string is returned. If m is smaller than n then all
           arguments starting from argument n are returned. Argument zero is
           traditionally the command itself.
    


* * *
# gnutls_x509_dn_export2

## NAME



           gnutls_x509_dn_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_export2(gnutls_x509_dn_t** _dn_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       Holds the uint8_t DN object
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a DN PEM or DER encoded
    


## DESCRIPTION



           This function will export the DN to DER or PEM format.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           NAME".
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# io_uring_submit

## NAME



           io_uring_submit - submit requests to the submission queue
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_submit(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The io_uring_submit(3) function submits the next events to the
           submission queue belonging to the _ring_.
    
           After the caller retrieves a submission queue entry (SQE) with
           io_uring_get_sqe(3) and prepares the SQE using one of the provided
           helpers, it can be submitted with io_uring_submit(3).
    


## RETURN VALUE



           On success io_uring_submit(3) returns the number of submitted
           submission queue entries, if SQPOLL is not used.  If SQPOLL is
           used, the return value may report a higher number of submitted
           entries than actually submitted. If the user requires accurate
           information about how many submission queue entries have been
           successfully submitted, while using SQPOLL, the user must fall
           back to repeatedly submitting a single submission queue entry. On
           failure it returns **-errno**.
    


## NOTES



           For any request that passes in data in a struct, that data must
           remain valid until the request has been successfully submitted. It
           need not remain valid until completion. Once a request has been
           submitted, the in-kernel state is stable. Very early kernels (5.4
           and earlier) required state to be stable until the completion
           occurred. Applications can test for this behavior by inspecting
           the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).  In general, the man pages for the
           individual prep helpers will have a note mentioning this fact as
           well, if required for the given command.
    


* * *
# timer_delete

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



           timer_delete — delete a per-process timer
    


## SYNOPSIS



           #include <time.h>
    
           int timer_delete(timer_t _timerid_);
    


## DESCRIPTION



           The _timer_delete_() function deletes the specified timer, _timerid_ ,
           previously created by the _timer_create_() function. If the timer is
           armed when _timer_delete_() is called, the behavior shall be as if
           the timer is automatically disarmed before removal. The
           disposition of pending signals for the deleted timer is
           unspecified.
    
           The behavior is undefined if the value specified by the _timerid_
           argument to _timer_delete_() does not correspond to a timer ID
           returned by _timer_create_() but not yet deleted by _timer_delete_().
    


## RETURN VALUE



           If successful, the _timer_delete_() function shall return a value of
           zero. Otherwise, the function shall return a value of -1 and set
           _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           If an implementation detects that the value specified by the
           _timerid_ argument to _timer_delete_() does not correspond to a timer
           ID returned by _timer_create_() but not yet deleted by
           _timer_delete_(), it is recommended that the function should fail
           and report an **[EINVAL]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *