tripathysagar/man_text huggingface dataset:
# io_uring_prep_msg_ring_cqe_flags

## NAME



           io_uring_prep_msg_ring - send a message to another ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_msg_ring(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **unsigned int** _len_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**);**
    
           **void io_uring_prep_msg_ring_cqe_flags(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **unsigned int** _len_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**,**
                                   **unsigned int** _cqe_flags_**);**
    


## DESCRIPTION



           io_uring_prep_msg_ring(3) prepares to send a CQE to an io_uring
           file descriptor. The submission queue entry _sqe_ is setup to use
           the file descriptor _fd_ , which must identify a io_uring context, to
           post a CQE on that ring where the target CQE **res** field will
           contain the content of _len_ and the **user_data** of _data_ with the
           request modifier flags set by _flags_.  Currently there are no valid
           flag modifiers, this field must contain **0**.
    
           The targeted ring may be any ring that the user has access to,
           even the ring itself. This request can be used for simple message
           passing to another ring, allowing 32+64 bits of data to be
           transferred through the _len_ and _data_ fields. The use case may be
           anything from simply waking up someone waiting on the targeted
           ring, or it can be used to pass messages between the two rings.
    
           io_uring_prep_msg_ring_cqe_flags(3) is similar to
           io_uring_prep_msg_ring(3).  But has an addition _cqe_flags_
           parameter, which is used to set _flags_ field on CQE side. That way,
           you can set the CQE flags field _cqe- >flags_ when sending a message.
           Be aware that io_uring could potentially set additional bits into
           this field.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the request.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-EBADFD**
                  The descriptor passed in _fd_ does not refer to an io_uring
                  file descriptor, or the ring is in a disabled state.
    
           **-EOVERFLOW**
                  The kernel was unable to fill a CQE on the target ring.
                  This can happen if the target CQ ring is in an overflow
                  state and the kernel wasn't able to allocate memory for a
                  new CQE entry.
    


* * *
# io_uring_register_napi

## NAME



           io_uring_register_napi - register NAPI busy poll settings
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_register_napi(3) function registers the NAPI settings
           for subsequent operations. The NAPI settings are specified in the
           structure that is passed in the _napi_ parameter. The structure
           consists of the napi timeout _busy_poll_to_ (napi busy poll timeout
           in us) and _prefer_busy_poll_.
    
           Registering a NAPI settings sets the mode when calling the
           function napi_busy_loop and corresponds to the SO_PREFER_BUSY_POLL
           socket option.
    
           NAPI busy poll can reduce the network roundtrip time.
    


## RETURN VALUE



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


* * *
# nrand48

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



           nrand48 — generate uniformly distributed pseudo-random non-
           negative long integers
    


## SYNOPSIS



           #include <stdlib.h>
    
           long nrand48(unsigned short _xsubi_[3]);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# gnutls_aead_cipher_deinit

## NAME



           gnutls_aead_cipher_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_aead_cipher_deinit(gnutls_aead_cipher_hd_t** _handle_**);**
    


## ARGUMENTS



           gnutls_aead_cipher_hd_t handle
                       is a **gnutls_aead_cipher_hd_t** type.
    


## DESCRIPTION



           This function will deinitialize all resources occupied by the
           given authenticated-encryption context.
    


## SINCE



           3.4.0
    


* * *
# gnutls_pubkey_import_x509_crq

## NAME



           gnutls_pubkey_import_x509_crq - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_x509_crq(gnutls_pubkey_t** _key_**,**
           **gnutls_x509_crq_t** _crq_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key
    
           gnutls_x509_crq_t crq
                       The certificate to be imported
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will import the given public key to the abstract
           **gnutls_pubkey_t** type.
    


## RETURNS



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


## SINCE



           3.1.5
    


* * *
# sd_bus_can_send

## NAME



           sd_bus_can_send - Check which types can be sent over a bus object
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **void sd_bus_can_send(sd_bus ***_bus_**, char** _type_**);**
    


## DESCRIPTION



           **sd_bus_can_send()** is mostly used for checking if file descriptor
           passing is available on the given bus.  _type_ can be any of the
           **SD_BUS_TYPE** constants.
    


## RETURN VALUE



           On failure, **sd_bus_can_send()** returns a negative errno-style error
           code. If values of the given type can be sent over the given bus,
           it returns a positive integer. Otherwise, it returns zero.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ENOPKG**
               The bus object _bus_ could not be resolved.
    
           **-ENOTCONN**
               The input parameter _bus_ is **NULL** or the bus is not connected.
    
           **-ECHILD**
               The bus object _bus_ was created in a different process.
    


## NOTES



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


* * *
# auparse_get_milli

## NAME



           auparse_get_milli - get the millisecond value of the event
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **unsigned int auparse_get_milli(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_get_milli gets the millisecond value of the current event.
    


## RETURN VALUE



           Returns 0 if an error occurs; otherwise, the value of the
           millisecond portion of the timestamp.
    


* * *
# pcre2_convert_context_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_convert_context_free(pcre2_convert_context ***_cvcontext_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It frees the memory occupied by a convert context,
           using the memory freeing function from the general context with
           which it was created, or **free()** if that was not set. If the
           argument is NULL, the function returns immediately without doing
           anything.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# gnutls_hkdf_expand

## NAME



           gnutls_hkdf_expand - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hkdf_expand(gnutls_mac_algorithm_t** _mac_**, const**
           **gnutls_datum_t ***_key_**, const gnutls_datum_t ***_info_**, void ***_output_**,**
           **size_t** _length_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t mac
                       the mac algorithm used internally
    
           const gnutls_datum_t * key
                       the pseudorandom key created with HKDF-Extract
    
           const gnutls_datum_t * info
                       the optional informational data
    
           void * output
                       the output value of the expand operation
    
           size_t length
                       the desired length of the output key
    


## DESCRIPTION



           This function will derive a variable length keying material from
           the pseudorandom key using the HKDF-Expand function as defined in
           RFC 5869.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.13
    


* * *
# gnutls_psk_set_client_credentials_function3

## NAME



           gnutls_psk_set_client_credentials_function3 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_client_credentials_function3(gnutls_psk_client_credentials_t**
           _cred_**, gnutls_psk_client_credentials_function3 ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_client_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_client_credentials_function3 * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the
           username and password for client PSK authentication.  The
           callback's function form is: int (*callback)(gnutls_session_t,
           gnutls_datum_t* username, gnutls_datum_t* key, gnutls_datum_t*
           context, gnutls_psk_key_flags *flags);
    
           This callback function has the same semantics as that of
           **gnutls_psk_set_client_credentials_function2()** , but it returns
           flags associated with the key.  The callback may import external
           PSK using the method described in RFC 9258 by using
           **gnutls_psk_format_imported_identity()**.
    
           The data field of  _username_ ,  _key_ , and  _context_ must be
           allocated using **gnutls_malloc()**.  The  _username_ should be an ASCII
           string or UTF-8 string. In case of a UTF-8 string it is
           recommended to be following the PRECIS framework for usernames
           (rfc8265).
    
           The callback function will be called once per handshake.
    
           The callback function should return 0 on success.  -1 indicates an
           error.
    


* * *
# gnutls_ext_raw_parse

## NAME



           gnutls_ext_raw_parse - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ext_raw_parse(void ***_ctx_**, gnutls_ext_raw_process_func**
           _cb_**, const gnutls_datum_t ***_data_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           void * ctx  a pointer to pass to callback function
    
           gnutls_ext_raw_process_func cb
                       callback function to process each extension found
    
           const gnutls_datum_t * data
                       TLS extension data
    
           unsigned int flags
                       should be zero or **GNUTLS_EXT_RAW_FLAG_TLS_CLIENT_HELLO**
                       or **GNUTLS_EXT_RAW_FLAG_DTLS_CLIENT_HELLO**
    


## DESCRIPTION



           This function iterates through the TLS extensions as passed in
            _data_ , passing the individual extension data to callback. The
            _data_ must conform to Extension extensions<0..2^16-1> format.
    
           If flags is **GNUTLS_EXT_RAW_TLS_FLAG_CLIENT_HELLO** then this
           function will parse the extension data from the position, as if
           the packet in
            _data_ is a client hello (without record or handshake headers) - as
           provided by **gnutls_handshake_set_hook_function()**.
    
           The return value of the callback will be propagated.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code. On unknown flags it
           returns **GNUTLS_E_INVALID_REQUEST**.
    


## SINCE



           3.6.3
    


* * *
# gnutls_x509_crq_get_extension_by_oid2

## NAME



           gnutls_x509_crq_get_extension_by_oid2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_extension_by_oid2(gnutls_x509_crq_t** _crq_**,**
           **const char ***_oid_**, unsigned** _indx_**, gnutls_datum_t ***_output_**, unsigned**
           **int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * oid
                       holds an Object Identifier in a null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the extensions,
                       this specifies which to get. Use (0) to get the first
                       one.
    
           gnutls_datum_t * output
                       will hold the allocated extension data
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return the extension specified by the OID in
           the certificate.  The extensions will be returned as binary data
           DER encoded, in the provided buffer.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code in case of an error.  If the certificate does not
           contain the specified extension
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.3.8
    


* * *
# swab

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



           swab — swap bytes
    


## SYNOPSIS



           #include <unistd.h>
    
           void swab(const void *restrict _src_ , void *restrict _dest_ ,
               ssize_t _nbytes_);
    


## DESCRIPTION



           The _swab_() function shall copy _nbytes_ bytes, which are pointed to
           by _src_ , to the object pointed to by _dest_ , exchanging adjacent
           bytes. The _nbytes_ argument should be even. If _nbytes_ is odd,
           _swab_() copies and exchanges _nbytes_ -1 bytes and the disposition of
           the last byte is unspecified. If copying takes place between
           objects that overlap, the behavior is undefined.  If _nbytes_ is
           negative, _swab_() does nothing.
    


## RETURN VALUE



           None.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# udev_monitor_receive_device

## NAME



           udev_monitor_receive_device, udev_monitor_enable_receiving,
           udev_monitor_set_receive_buffer_size, udev_monitor_get_fd,
           udev_monitor_get_udev - Query and modify device monitor
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **struct udev_device**
                                                           ***udev_monitor_receive_device(struct udev_monitor ***_udev_monitor_**);**
    
           **int**
                                             **udev_monitor_enable_receiving(struct udev_monitor ***_udev_monitor_**);**
    
           **int**
                                                    **udev_monitor_set_receive_buffer_size(struct udev_monitor ***_udev_monitor_**,**
                                                    **int** _size_**);**
    
           **int udev_monitor_get_fd(struct udev_monitor ***_udev_monitor_**);**
    
           **struct udev**
                                              ***udev_monitor_get_udev(struct udev_monitor ***_udev_monitor_**);**
    


## RETURN VALUE



           On success, **udev_monitor_receive_device()** returns a pointer to a
           newly referenced device that was received via the monitor. The
           caller is responsible to drop this reference when done. On
           failure, **NULL** is returned.
    
           On success, **udev_monitor_enable_receiving()** and
           **udev_monitor_set_receive_buffer_size()** return an integer greater
           than, or equal to, **0**. On failure, a negative error code is
           returned.
    
           On success, **udev_monitor_get_fd()** returns the file descriptor used
           by this monitor. On failure, a negative error code is returned.
    
           **udev_monitor_get_udev()** always returns a pointer to the udev
           context that this monitor is associated with.
    


* * *
# security_check_context

## NAME



           security_check_context - check the validity of a SELinux context
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int security_check_context(const char ***_con_**);**
    
           **int security_check_context_raw(const char ***_con_**);**
    


## DESCRIPTION



           **security_check_context**() returns 0 if SELinux is running and the
           context is valid, otherwise it returns -1.
    
           **security_check_context_raw**() behaves identically to
           **security_check_context**() but does not perform context translation.
    


* * *
# powerof2

## NAME



           powerof2 - test if a value is a power of 2
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/param.h>**
    
           **int powerof2(**_x_**);**
    


## DESCRIPTION



           This macro returns true if _x_ is a power of 2, and false otherwise.
    
           **0** is considered a power of 2.  This can make sense considering
           wrapping of unsigned integers, and has interesting properties.
    


## RETURN VALUE



           True or false, if _x_ is a power of 2 or not, respectively.
    


## STANDARDS



           BSD.
    


## CAVEATS



           The arguments may be evaluated more than once.
    
           Because this macro is implemented using bitwise operations, some
           negative values can invoke undefined behavior.  For example, the
           following invokes undefined behavior: _powerof2(INT_MIN);_.  Call it
           only with unsigned types to be safe.
    


* * *
# wcscat

## NAME



           wcscat - concatenate two wide-character strings
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcscat(wchar_t *restrict** _dest_**, const wchar_t *restrict** _src_**);**
    


## DESCRIPTION



           The **wcscat**() function is the wide-character equivalent of the
           strcat(3) function.  It copies the wide-character string pointed
           to by _src_ , including the terminating null wide character (L'\0'),
           to the end of the wide-character string pointed to by _dest_.
    
           The strings may not overlap.
    
           The programmer must ensure that there is room for at least
           _wcslen(dest)_ +_wcslen(src)_ +1 wide characters at _dest_.
    


## RETURN VALUE



           **wcscat**() returns _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# tapset::linuxmib

## NAME



           tapset::linuxmib - systemtap linuxmib tapset
    


## DESCRIPTION



           **linuxmib.DelayedACKs**
                  Count of delayed acks
    
                   See probe::linuxmib.DelayedACKs(3stap)
                   for details.
    
           **linuxmib.ListenOverflows**
                  Count of times a listen queue overflowed
    
                   See probe::linuxmib.ListenOverflows(3stap)
                   for details.
    
           **linuxmib.ListenDrops**
                  Count of times conn request that were dropped
    
                   See probe::linuxmib.ListenDrops(3stap)
                   for details.
    
           **linuxmib.TCPMemoryPressures**
                  Count of times memory pressure was used
    
                   See probe::linuxmib.TCPMemoryPressures(3stap)
                   for details.
    


* * *
# function::mdelay

## NAME



           function::mdelay - millisecond delay
    


## SYNOPSIS



               mdelay(ms:long)
    


## ARGUMENTS



           _ms_
               Number of milliseconds to delay.
    


## DESCRIPTION



           This function inserts a multi-millisecond busy-delay into a probe
           handler. It requires guru mode.
    


* * *
# floor

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



           floor, floorf, floorl — floor function
    


## SYNOPSIS



           #include <math.h>
    
           double floor(double _x_);
           float floorf(float _x_);
           long double floorl(long double _x_);
    


## 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 largest integral value not
           greater than _x_.
    


## RETURN VALUE



           The result shall have the same sign as _x_.
    
           Upon successful completion, these functions shall return the
           largest integral value not greater than _x_ , expressed as a **double** ,
           **float** , or **long double** , as appropriate for the return type of the
           function.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0 or ±Inf, _x_ shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The integral value returned by these functions might not be
           expressible as an **intmax_t**.  The return value should be tested
           before assigning it to an integer type to avoid the undefined
           results of an integer overflow.
    
           These functions may raise the inexact floating-point exception if
           the result differs in value from the argument.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crl_list_import

## NAME



           gnutls_x509_crl_list_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_list_import(gnutls_x509_crl_t ***_crls_**, unsigned**
           **int ***_crl_max_**, const gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t**
           _format_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t * crls
                       Indicates where the parsed CRLs will be copied to.
                       Must not be initialized.
    
           unsigned int * crl_max
                       Initially must hold the maximum number of crls. It
                       will be updated with the number of crls available.
    
           const gnutls_datum_t * data
                       The CRL data
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM.
    
           unsigned int flags
                       must be (0) or an OR'd sequence of
                       gnutls_certificate_import_flags.
    


## DESCRIPTION



           This function will convert the given CRL list to the native
           gnutls_x509_crl_t format. The output will be stored in  _crls_ .
           They will be automatically initialized.
    
           If the Certificate is PEM encoded it should have a header of "X509
           CRL".
    


## RETURNS



           the number of certificates read or a negative error value.
    


## SINCE



           3.0
    


* * *
# ctanh

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



           ctanh, ctanhf, ctanhl — complex hyperbolic tangent functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex ctanh(double complex _z_);
           float complex ctanhf(float complex _z_);
           long double complex ctanhl(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 hyperbolic tangent of _z_.
    


## RETURN VALUE



           These functions shall return the complex hyperbolic tangent value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_srp_free_client_credentials

## NAME



           gnutls_srp_free_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_srp_free_client_credentials(gnutls_srp_client_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_srp_client_credentials_t sc
                       is a **gnutls_srp_client_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_srp_client_credentials_t structure.
    


* * *
# gnutls_hash_get_len

## NAME



           gnutls_hash_get_len - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **unsigned gnutls_hash_get_len(gnutls_digest_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t algorithm
                       the hash algorithm to use
    


## DESCRIPTION



           This function will return the length of the output data of the
           given hash algorithm.
    


## RETURNS



           The length or zero on error.
    


## SINCE



           2.10.0
    


* * *
# audit_set_loginuid_immutable

## NAME



           audit_set_loginuid_immutable - make loginuid value immutable
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_loginuid_immutable(int** _fd_**);"**
    


## DESCRIPTION



           **audit_set_loginuid_immutable**() locks the loginuid so that it can
           no longer be changed.  The descriptor _fd_ must be an open audit
           netlink socket.  This call is equivalent to using
           **audit_set_feature**() to enable and lock the
           **AUDIT_FEATURE_LOGINUID_IMMUTABLE** bit.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number.
    


* * *
# function::task_open_file_handles

## NAME



           function::task_open_file_handles - The number of open files of the
           task
    


## SYNOPSIS



               task_open_file_handles:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the number of open file handlers for the
           given task.
    


* * *
# manadv_init_obj

## NAME



           manadv_init_obj - Initialize mana direct verbs object from ibv_xxx
           structures
    


## SYNOPSIS”



                  #include <infiniband/manadv.h>
    
                  int manadv_init_obj(struct manadv_obj *obj, uint64_t obj_type);
    


## DESCRIPTION



           manadv_init_obj() This function will initialize manadv_xxx structs
           based on supplied type.  The information for initialization is
           taken from ibv_xx structs supplied as part of input.
    


## ARGUMENTS



           _obj_    The manadv_xxx structs be to returned.
    
                  struct manadv_qp {
                      void        *sq_buf;
                      uint32_t    sq_count;
                      uint32_t    sq_size;
                      uint32_t    sq_id;
                      uint32_t    tx_vp_offset;
                      void        *db_page;
                  };
    
                  struct manadv_cq {
                      void        *buf;
                      uint32_t    count;
                      uint32_t    cq_id;
                  };
    
                  struct manadv_rwq {
                      void        *buf;
                      uint32_t    count;
                      uint32_t    size;
                      uint32_t    wq_id;
                      void        *db_page;
                  };
    
                  struct manadv_obj {
                      struct {
                          struct ibv_qp       *in;
                          struct manadv_qp    *out;
                      } qp;
    
                      struct {
                          struct ibv_cq       *in;
                          struct manadv_cq    *out;
                      } cq;
    
                      struct {
                          struct ibv_wq       *in;
                          struct manadv_rwq   *out;
                      } rwq;
                  };
    
           _obj_type_
                  The types of the manadv_xxx structs to be returned.
    
                  enum manadv_obj_type {
                      MANADV_OBJ_QP   = 1 << 0,
                      MANADV_OBJ_CQ   = 1 << 1,
                      MANADV_OBJ_RWQ  = 1 << 2,
                  };
    


## RETURN VALUE



           0 on success or the value of errno on failure (which indicates the
           failure reason).
    


* * *
# pcap_set_immediate_mode

## NAME



           pcap_set_immediate_mode - set immediate mode for a not-yet-
           activated capture handle
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_set_immediate_mode(pcap_t *p, int immediate_mode);**
    


## DESCRIPTION



           **pcap_set_immediate_mode**() sets whether immediate mode should be
           set on a capture handle when the handle is activated.  In
           immediate mode, packets are always delivered as soon as they
           arrive, with no buffering.  If _immediate_mode_ is non-zero,
           immediate mode will be set, otherwise it will not be set.
    


## RETURN VALUE



           **pcap_set_immediate_mode**() returns **0** on success or
           **PCAP_ERROR_ACTIVATED** if called on a capture handle that has been
           activated.
    


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.5.0.  In
           previous releases, if immediate delivery of packets is required:
    
                  on FreeBSD, NetBSD, OpenBSD, DragonFly BSD, macOS, and
                  Solaris 11, immediate mode must be turned on with a
                  **BIOCIMMEDIATE ioctl**(2), as documented in **bpf**(4), on the
                  descriptor returned by **pcap_fileno**(3PCAP), after
                  **pcap_activate**(3PCAP) is called;
    
                  on Solaris 10 and earlier versions of Solaris, immediate
                  mode must be turned on by using a read timeout of 0 when
                  opening the device (this will not provide immediate
                  delivery of packets on other platforms, so don't assume
                  it's sufficient);
    
                  on Windows, immediate mode must be turned on by calling
                  **pcap_setmintocopy**() with a size of 0.
    
           On Linux, with previous releases of libpcap, capture devices are
           always in immediate mode; however, in 1.5.0 and later, they are,
           by default, **not** in immediate mode, so if **pcap_set_immediate_mode**()
           is available, it should be used.
    
           On other platforms, capture devices are always in immediate mode.
    


* * *
# libpfm_arm_ac15

## NAME



           libpfm_arm_ac15 - support for Arm Cortex A15 PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_ac15**
           **PMU desc: ARM Cortex A15**
    


## DESCRIPTION



           The library supports the ARM Cortex A15 core PMU.
    
           This PMU supports 6 counters and privilege levels filtering.
    


## MODIFIERS



           The following modifiers are supported on ARM Cortex A15:
    
           **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.
    


* * *
# rdma_resolve_route

## NAME



           rdma_resolve_route - Resolve the route information needed to
           establish a connection.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_resolve_route (struct rdma_cm_id ***_id_**, int** _timeout_ms_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           timeout_ms  Time to wait for resolution to complete.
    


## DESCRIPTION



           Resolves an RDMA route to the destination address in order to
           establish a connection.  The destination address must have already
           been resolved by calling rdma_resolve_addr.
    


## RETURN VALUE



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


## NOTES



           This is called on the client side of a connection after calling
           rdma_resolve_addr, but before calling rdma_connect.
    


## INFINIBAND SPECIFIC



           This call obtains a path record that is used by the connection.
    


* * *
# pthread_mutexattr_init

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



           pthread_mutexattr_init — initialize the mutex attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutexattr_init(pthread_mutexattr_t *_attr_);
    


## DESCRIPTION



           Refer to pthread_mutexattr_destroy(3p).
    


* * *
# strspn

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



           strspn — get length of a substring
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           The _strspn_() function shall return the computed length; no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# libpfm_amd64_fam17h_zen2

## NAME



           libpfm_amd64_fam17h_zen2 - support for AMD64 Family 17h model 31h
           processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam17h_zen2**
           **PMU desc: AMD64 Fam17h Zen2**
    


## DESCRIPTION



           The library supports AMD Family 17h processors Zen2 core PMU in
           both 32 and 64-bit modes.
    


## MODIFIERS



           The following modifiers are supported on AMD64 Family 17h Zen2
           core PMU:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **h** Measure at while executing in host mode (when using
                  virtualization). This corresponds to **PFM_PLMH**.  This
                  modifier is available starting with Fam10h. This is a
                  boolean modifier.
    
           **g** Measure at while executing in guest mode (when using
                  virtualization). This modifier is available starting with
                  Fam10h. This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    


* * *
# mlx5dv_dump_dr_rule

## NAME



           mlx5dv_dump_dr_domain - Dump DR Domain
    
           mlx5dv_dump_dr_table - Dump DR Table
    
           mlx5dv_dump_dr_matcher - Dump DR Matcher
    
           mlx5dv_dump_dr_rule - Dump DR Rule
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_dump_dr_domain(FILE *fout, struct mlx5dv_dr_domain *domain);
                  int mlx5dv_dump_dr_table(FILE *fout, struct mlx5dv_dr_table *table);
                  int mlx5dv_dump_dr_matcher(FILE *fout, struct mlx5dv_dr_matcher *matcher);
                  int mlx5dv_dump_dr_rule(FILE *fout, struct mlx5dv_dr_rule *rule);
    


## DESCRIPTION



           The Dump API (mlx5dv_dump_*) allows the dumping of the existing
           rdma-core resources to the provided file.  The output file format
           is vendor specific.
    
           _mlx5dv_dump_dr_domain()_ dumps a DR Domain object properties to a
           specified file.
    
           _mlx5dv_dump_dr_table()_ dumps a DR Table object properties to a
           specified file.
    
           _mlx5dv_dump_dr_matcher()_ dumps a DR Matcher object properties to a
           specified file.
    
           _mlx5dv_dump_dr_rule()_ dumps a DR Rule object properties to a
           specified file.
    


## RETURN VALUE



           The API calls returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).  The calls are
           blocking - function returns only when all related resources info
           is written to the file.
    


* * *
# function::ansi_cursor_move

## NAME



           function::ansi_cursor_move - Move cursor to new coordinates.
    


## SYNOPSIS



               ansi_cursor_move(x:long,y:long)
    


## ARGUMENTS



           _x_
               Row to move the cursor to.
    
           _y_
               Colomn to move the cursor to.
    


## DESCRIPTION



           Sends ansi code for positioning the cursor at row x and column y.
           Coordinates start at one, (1,1) is the top-left corner.
    


* * *
# pcre2_general_context_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_general_context_free(pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function frees the memory occupied by a general context,
           using the memory freeing function within the context, if set.  If
           the argument is NULL, the function returns immediately without
           doing anything.
    
           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_pkcs11_copy_secret_key

## NAME



           gnutls_pkcs11_copy_secret_key - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_secret_key(const char ***_token_url_**,**
           **gnutls_datum_t ***_key_**, const char ***_label_**, unsigned int** _key_usage_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_datum_t * key
                       The raw key
    
           const char * label
                       A name to be used for the stored data
    
           unsigned int key_usage
                       One of GNUTLS_KEY_*
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_FLAG_*
    


## DESCRIPTION



           This function will copy a raw secret (symmetric) key into a PKCS
           **11** token specified by a URL. The key can be marked as sensitive or
           not.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_pkcs11_privkey_set_pin_function

## NAME



           gnutls_pkcs11_privkey_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void**
           **gnutls_pkcs11_privkey_set_pin_function(gnutls_pkcs11_privkey_t**
           _key_**, gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t key
                       The private key
    
           gnutls_pin_callback_t fn
                       the callback
    
           void * userdata
                       data associated with the callback
    


## DESCRIPTION



           This function will set a callback function to be used when
           required to access the object. This function overrides the global
           set using **gnutls_pkcs11_set_pin_function()**.
    


## SINCE



           3.1.0
    


* * *
# gnutls_dh_params_export2_pkcs3

## NAME



           gnutls_dh_params_export2_pkcs3 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_export2_pkcs3(gnutls_dh_params_t** _params_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_dh_params_t params
                       Holds the DH parameters
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a PKCS3 DHParams structure PEM or DER
                       encoded
    


## DESCRIPTION



           This function will export the given dh parameters to a PKCS3
           DHParams structure. This is the format generated by "openssl
           dhparam" tool.  The data in  _out_ will be allocated using
           **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           DH PARAMETERS".
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# probe::sunrpc.sched.new_task

## NAME



           probe::sunrpc.sched.new_task - Create new task for the specified
           client
    


## SYNOPSIS



           sunrpc.sched.new_task
    


## VALUES



           _xid_
               the transmission id in the RPC call
    
           _vers_
               the program version in the RPC call
    
           _prot_
               the IP protocol in the RPC call
    
           _prog_
               the program number in the RPC call
    
           _tk_flags_
               the flags of the task
    


* * *