tripathysagar/man_text huggingface dataset:
# libpfm_intel_icx_unc_m3upi

## NAME



           libpfm_intel_icx_unc_m3upi - support for Intel IcelakeX Server
           M3UPI uncore PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the Intel IcelakeX M3UPI (Mesh to UPI) uncore
           PMU.  Each M3UPI PMU implements 4 generic counters.
    


## MODIFIERS



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


* * *
# gnutls_x509_crt_get_key_id

## NAME



           gnutls_x509_crt_get_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_key_id(gnutls_x509_crt_t** _crt_**, unsigned int**
           _flags_**, unsigned char ***_output_data_**, size_t ***_output_data_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           unsigned int flags
                       should be one of the flags from **gnutls_keyid_flags_t**
    
           unsigned char * output_data
                       will contain the key ID
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will return a unique ID that depends on the public
           key parameters. This ID can be used in checking whether a
           certificate corresponds to the given private key.
    
           If the buffer provided is not long enough to hold the output, then
           *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will
           be returned.  The output will normally be a SHA-1 hash output,
           which is 20 bytes.
    


## RETURNS



           In case of failure a negative error code will be returned, and 0
           on success.
    


* * *
# gnutls_x509_crt_equals2

## NAME



           gnutls_x509_crt_equals2 - This function compares a
           gnutls_x509_crt_t cert with DER data
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crt_equals2(gnutls_x509_crt_t** _cert1_**, const**
           **gnutls_datum_t ***_der_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert1
                       The first certificate
    
           const gnutls_datum_t * der
                       A DER encoded certificate
    


## DESCRIPTION



           This function will compare an X.509 certificate structures, with
           DER encoded certificate data.
    


## RETURNS



           On equality non-zero is returned, otherwise zero.
    


## SINCE



           3.5.0
    


* * *
# memmem

## NAME



           memmem - locate a substring
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <string.h>**
    
           **void *memmem(** size_t hsize, size_t nsize;
                        **const void** _haystack_**[**_hsize_**], size_t** _hsize_**,**
                        **const void** _needle_**[**_nsize_**], size_t** _nsize_**);**
    


## DESCRIPTION



           The **memmem**() function finds the start of the first occurrence of
           the substring _needle_ of size _nsize_ in the memory area _haystack_ of
           size _hsize_.
    


## RETURN VALUE



           The **memmem**() function returns a pointer to the beginning of the
           substring, or NULL if the substring is not found.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## BUGS



           In glibc 2.0, if _needle_ is empty, **memmem**() returns a pointer to
           the last byte of _haystack_.  This is fixed in glibc 2.1.
    


* * *
# gnutls_compress_certificate_set_methods

## NAME



           gnutls_compress_certificate_set_methods - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_compress_certificate_set_methods(gnutls_session_t**
           _session_**, const gnutls_compression_method_t ***_methods_**, size_t**
           _methods_len_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_compression_method_t * methods
                       is a list of supported compression methods.
    
           size_t methods_len
                       number of compression methods in  _methods_
    


## DESCRIPTION



           This function sets the supported compression methods for
           certificate compression for the given session. The list of
           supported compression methods will be used for a) requesting the
           compression of peer's certificate and b) selecting the method to
           compress the local certificate before sending it to the peer.  The
           order of compression methods inside the list does matter as the
           method that appears earlier in the list will be preferred before
           the later ones.  Note that even if you set the list of supported
           compression methods, the compression might not be used if the peer
           does not support any of your chosen compression methods.
    
           The list of supported compression methods must meet the following
           criteria: Argument  _methods_ must be an array of valid compression
           methods of type **gnutls_compression_method_t**. Argument  _methods_len_
           must contain the number of compression methods stored in the
           _methods_ array and must be within range <1, 127>.  The length
           constraints are defined by **MIN_COMPRESS_CERTIFICATE_METHODS** and
           **MAX_COMPRESS_CERTIFICATE_METHODS** macros located in the header file
           compress_certificate.h.
    
           If either  _methods_ or  _methods_len_ is equal to 0, current list of
           supported compression methods will be unset.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    
           Since 3.7.4
    


* * *
# pcre2_set_recursion_limit

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_recursion_limit(pcre2_match_context ***_mcontext_**,**
             **uint32_t** _value_**);**
    


## DESCRIPTION



    
           This function is obsolete and should not be used in new code. Use
           **pcre2_set_depth_limit()** instead.
    
           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.
    


* * *
# function::set_user_string

## NAME



           function::set_user_string - Writes a string to user memory
    


## SYNOPSIS



               set_user_string(addr:long,val:string)
    


## ARGUMENTS



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


## DESCRIPTION



           Writes the given string to a given user memory address. Reports an
           error when writing to the given address fails. Requires the use of
           guru mode (-g).
    


* * *
# probe::tty.register

## NAME



           probe::tty.register - Called when a tty device is registred
    


## SYNOPSIS



           tty.register
    


## VALUES



           _driver_name_
               the driver name
    
           _name_
               the driver .dev_name name
    
           _module_
               the module name
    
           _index_
               the tty index requested
    


* * *
# gnutls_certificate_set_x509_crl_file

## NAME



           gnutls_certificate_set_x509_crl_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_crl_file(gnutls_certificate_credentials_t**
           _res_**, const char ***_crlfile_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const char * crlfile
                       is a file containing the list of verified CRLs (DER or
                       PEM list)
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER
    


## DESCRIPTION



           This function adds the trusted CRLs in order to verify client or
           server certificates.  In case of a client this is not required to
           be called if the certificates are not verified using
           **gnutls_certificate_verify_peers2()**.  This function may be called
           multiple times.
    


## RETURNS



           number of CRLs processed or a negative error code on error.
    


* * *
# isprint

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



           isprint, isprint_l — test for a printable character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isprint(int _c_);
           int isprint_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isprint_(): 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 _isprint_() and _isprint_l_() functions shall test whether _c_ is a
           character of class **print** in the current locale, or in the locale
           represented by _locale_ , respectively; see the Base Definitions
           volume of POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _c_ argument is an **int** , the value of which the application shall
           ensure is a character representable as an **unsigned char** or equal
           to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isprint_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isprint_() and _isprint_l_() functions shall return non-zero if _c_
           is a printable character; otherwise, they shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::user_long_warn

## NAME



           function::user_long_warn - Retrieves a long value stored in user
           space
    


## SYNOPSIS



               user_long_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the long from
    


## DESCRIPTION



           Returns the long 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). Note that the size of the long
           depends on the architecture of the current user space task (for
           those architectures that support both 64/32 bit compat tasks).
    


* * *
# probe::netdev.set_promiscuity

## NAME



           probe::netdev.set_promiscuity - Called when the device
           enters/leaves promiscuity
    


## SYNOPSIS



           netdev.set_promiscuity
    


## VALUES



           _inc_
               Count the number of promiscuity openers
    
           _disable_
               If the device is leaving promiscuity mode
    
           _dev_name_
               The device that is entering/leaving promiscuity mode
    
           _enable_
               If the device is entering promiscuity mode
    


* * *
# io_uring_submit_and_get_events

## NAME



           io_uring_submit_and_get_events - submit requests to the submission
           queue and flush completions
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_submit_and_get_events(3) function submits the next
           events to the submission queue as with io_uring_submit(3).  After
           submission it will flush CQEs as with io_uring_get_events(3).
    
           The benefit of this function is that it does both with only one
           system call.
    


## RETURN VALUE



           On success io_uring_submit_and_get_events(3) returns the number of
           submitted submission queue entries. On failure it returns **-errno**.
    


* * *
# cfsetospeed

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



           cfsetospeed — set output baud rate
    


## SYNOPSIS



           #include <termios.h>
    
           int cfsetospeed(struct termios *_termios_p_ , speed_t _speed_);
    


## DESCRIPTION



           The _cfsetospeed_() function shall set the output baud rate stored
           in the structure pointed to by _termios_p_ to _speed_.
    
           There shall be no effect on the baud rates set in the hardware
           until a subsequent successful call to _tcsetattr_() with the same
           **termios** structure. Similarly, errors resulting from attempts to
           set baud rates not supported by the terminal device need not be
           detected until the _tcsetattr_() function is called.
    


## RETURN VALUE



           Upon successful completion, _cfsetospeed_() shall return 0;
           otherwise, it shall return -1 and _errno_ may be set to indicate the
           error.
    


## ERRORS



           The _cfsetospeed_() function may fail if:
    
           **EINVAL** The _speed_ value is not a valid baud rate.
    
           **EINVAL** The value of _speed_ is outside the range of possible speed
                  values as specified in _< termios.h>_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to cfgetispeed(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::stap.system.spawn

## NAME



           probe::stap.system.spawn - stap spawned new process
    


## SYNOPSIS



           stap.system.spawn
    


## VALUES



           _ret_
               the return value from posix_spawn
    
           _pid_
               the pid of the spawned process
    


## DESCRIPTION



           Fires just after the call to posix_spawn.
    


* * *
# sigrelse

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



           sigrelse, sigset — signal management
    


## SYNOPSIS



           #include <signal.h>
    
           int sigrelse(int _sig_);
           void (*sigset(int _sig_ , void (*_disp_)(int)))(int);
    


## DESCRIPTION



           Refer to sighold(3p).
    


* * *
# gnutls_record_recv_early_data

## NAME



           gnutls_record_recv_early_data - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_recv_early_data(gnutls_session_t** _session_**,**
           **void ***_data_**, size_t** _data_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * data the buffer that the data will be read into
    
           size_t data_size
                       the number of requested bytes
    


## DESCRIPTION



           This function can be used by a server to retrieve data sent early
           in the handshake processes when resuming a session.  This is used
           to implement a zero-roundtrip (0-RTT) mode.  It has the same
           semantics as **gnutls_record_recv()**.
    
           This function can be called either in a handshake hook, or after
           the handshake is complete.
    


## RETURNS



           The number of bytes received and zero when early data reading is
           complete.  A negative error code is returned in case of an error.
           If no early data is received during the handshake, this function
           returns **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.  The number of
           bytes received might be less than the requested
            _data_size_ .
    


## SINCE



           3.6.5
    


* * *
# gnutls_privkey_export_dsa_raw2

## NAME



           gnutls_privkey_export_dsa_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_dsa_raw2(gnutls_privkey_t** _key_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**, gnutls_datum_t ***_x_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the public key
    
           gnutls_datum_t * p
                       will hold the p
    
           gnutls_datum_t * q
                       will hold the q
    
           gnutls_datum_t * g
                       will hold the g
    
           gnutls_datum_t * y
                       will hold the y
    
           gnutls_datum_t * x
                       will hold the x
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the DSA private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.6.0
    


* * *
# pthread_attr_getscope

## 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_attr_getscope, pthread_attr_setscope — get and set the
           contentionscope attribute (**REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_getscope(const pthread_attr_t *restrict _attr_ ,
               int *restrict _contentionscope_);
           int pthread_attr_setscope(pthread_attr_t *_attr_ , int _contentionscope_);
    


## DESCRIPTION



           The _pthread_attr_getscope_() and _pthread_attr_setscope_() functions,
           respectively, shall get and set the _contentionscope_ attribute in
           the _attr_ object.
    
           The _contentionscope_ attribute may have the values
           PTHREAD_SCOPE_SYSTEM, signifying system scheduling contention
           scope, or PTHREAD_SCOPE_PROCESS, signifying process scheduling
           contention scope. The symbols PTHREAD_SCOPE_SYSTEM and
           PTHREAD_SCOPE_PROCESS are defined in the _< pthread.h>_ header.
    
           The behavior is undefined if the value specified by the _attr_
           argument to _pthread_attr_getscope_() or _pthread_attr_setscope_()
           does not refer to an initialized thread attributes object.
    


## RETURN VALUE



           If successful, the _pthread_attr_getscope_() and
           _pthread_attr_setscope_() functions shall return zero; otherwise, an
           error number shall be returned to indicate the error.
    


## ERRORS



           The _pthread_attr_setscope_() function shall fail if:
    
           **ENOTSUP**
                  An attempt was made to set the attribute to an unsupported
                  value.
    
           The _pthread_attr_setscope_() function may fail if:
    
           **EINVAL** The value of _contentionscope_ is not valid.
    
           These functions shall not return an error code of **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           After these attributes have been set, a thread can be created with
           the specified attributes using _pthread_create_().  Using these
           routines does not affect the current running thread.
    
           See _Section 2.9.4_ , _Thread Scheduling_ for further details on thread
           scheduling attributes and their default settings.
    


## RATIONALE



           If an implementation detects that the value specified by the _attr_
           argument to _pthread_attr_getscope_() or _pthread_attr_setscope_()
           does not refer to an initialized thread attributes object, it is
           recommended that the function should fail and report an **[EINVAL]**
           error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# catan

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



           catan, catanf, catanl — complex arc tangent functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex catan(double complex _z_);
           float complex catanf(float complex _z_);
           long double complex catanl(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 arc tangent of _z_ , with
           branch cuts outside the interval [-_i_ , +_i_] along the imaginary
           axis.
    


## RETURN VALUE



           These functions shall return the complex arc tangent value, in the
           range of a strip mathematically unbounded along the imaginary axis
           and in the interval [-π/2, +π/2] along the real axis.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# macro::json_output_array_string_value

## NAME



           macro::json_output_array_string_value - Output a string value for
           metric in an array.
    


## SYNOPSIS



               @json_output_array_string_value(array_name,array_index,metric_name,value)
    


## ARGUMENTS



           _array_name_
               The name of the array.
    
           _array_index_
               The array index (as a string) indicating where to store the
               string value.
    
           _metric_name_
               The name of the string metric.
    
           _value_
               The string value to output.
    


## DESCRIPTION



           The json_output_array_string_value macro is designed to be called
           from the 'json_data' probe in the user's script to output a
           metric's string value that is in an array. This metric should have
           been added with **json_add_array_string_metric**.
    


* * *
# gnutls_x509_crq_set_basic_constraints

## NAME



           gnutls_x509_crq_set_basic_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_basic_constraints(gnutls_x509_crq_t** _crq_**,**
           **unsigned int** _ca_**, int** _pathLenConstraint_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate request of type **gnutls_x509_crq_t**
    
           unsigned int ca
                       true(1) or false(0) depending on the Certificate
                       authority status.
    
           int pathLenConstraint
                       non-negative error codes indicate maximum length of
                       path, and negative error codes indicate that the
                       pathLenConstraints field should not be present.
    


## DESCRIPTION



           This function will set the basicConstraints certificate extension.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# gnutls_pubkey_import_x509

## NAME



           gnutls_pubkey_import_x509 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_x509(gnutls_pubkey_t** _key_**,**
           **gnutls_x509_crt_t** _crt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key
    
           gnutls_x509_crt_t crt
                       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



           2.12.0
    


* * *
# pthread_attr_setinheritsched

## 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_attr_setinheritsched — set the inheritsched attribute
           (**REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_setinheritsched(pthread_attr_t *_attr_ ,
               int _inheritsched_);
    


## DESCRIPTION



           Refer to pthread_attr_getinheritsched(3p).
    


* * *
# gnutls_record_get_state

## NAME



           gnutls_record_get_state - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_record_get_state(gnutls_session_t** _session_**, unsigned**
           _read_**, gnutls_datum_t ***_mac_key_**, gnutls_datum_t ***_IV_**,**
           **gnutls_datum_t ***_cipher_key_**, unsigned char [8]**_seq_number_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type
    
           unsigned read
                       if non-zero the read parameters are returned,
                       otherwise the write
    
           gnutls_datum_t * mac_key
                       the key used for MAC (if a MAC is used)
    
           gnutls_datum_t * IV
                       the initialization vector or nonce used
    
           gnutls_datum_t * cipher_key
                       the cipher key
    
           unsigned char [8] seq_number
                       A 64-bit sequence number
    


## DESCRIPTION



           This function will return the parameters of the current record
           state.  These are only useful to be provided to an external
           off-loading device or subsystem. The returned values should be
           considered constant and valid for the lifetime of the session.
    
           In that case, to sync the state back you must call
           **gnutls_record_set_state()**.
    


## RETURNS



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


* * *
# pread

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



           pread — read from a file
    


## SYNOPSIS



           #include <unistd.h>
    
           ssize_t pread(int _fildes_ , void *_buf_ , size_t _nbyte_ , off_t _offset_);
    


## DESCRIPTION



           Refer to read(3p).
    


* * *
# gnutls_pubkey_import_x509_raw

## NAME



           gnutls_pubkey_import_x509_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_x509_raw(gnutls_pubkey_t** _pkey_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pkey
                       The public key
    
           const gnutls_datum_t * data
                       The public key data to be imported
    
           gnutls_x509_crt_fmt_t format
                       The format of the public key
    
           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.3
    


* * *
# io_uring_wait_cqe

## NAME



           io_uring_wait_cqe - wait for one io_uring completion event
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_wait_cqe(struct io_uring ***_ring_**,**
                                 **struct io_uring_cqe ****_cqe_ptr_**);**
    


## DESCRIPTION



           The io_uring_wait_cqe(3) function waits for an IO completion from
           the queue belonging to the _ring_ param, waiting for it if
           necessary. If an event is already available in the ring when
           invoked, no waiting will occur. The _cqe_ptr_ param is filled in on
           success.
    
           After the caller has submitted a request with io_uring_submit(3),
           the application can retrieve the completion with
           io_uring_wait_cqe(3).
    


## RETURN VALUE



           On success io_uring_wait_cqe(3) returns 0 and the cqe_ptr param is
           filled in. On failure it returns **-errno**.  The return value
           indicates the result of waiting for a CQE, and it has no relation
           to the CQE result itself.
    


* * *
# tapset::floatingpoint

## NAME



           tapset::floatingpoint - systemtap floatingpoint tapset
    


## DESCRIPTION



           **fp_to_string**
                  Convert 64 bit floating point to string
    
                  See function::fp_to_string(3stap)
                   for details.
    
           **string_to_fp**
                  Convert the given string into floating point
    
                  See function::string_to_fp(3stap)
                   for details.
    
           **long_to_fp**
                  Convert long int to 64 bit floating point
    
                  See function::long_to_fp(3stap)
                   for details.
    
           **fp_to_long**
                  Convert fp to int64
    
                  See function::fp_to_long(3stap)
                   for details.
    
           **fp_add** Addition between floating points
    
                  See function::fp_add(3stap)
                   for details.
    
           **fp_sub** Subtraction between floating points
    
                  See function::fp_sub(3stap)
                   for details.
    
           **fp_mul** Multiplication between floating points
    
                  See function::fp_mul(3stap)
                   for details.
    
           **fp_div** fp divide
    
                  See function::fp_div(3stap)
                   for details.
    
           **fp_rem** Floating point division
    
                  See function::fp_rem(3stap)
                   for details.
    
           **fp_sqrt**
                  Floating point square root
    
                  See function::fp_sqrt(3stap)
                   for details.
    
           **fp_eq** fp comparison function equal
    
                  See function::fp_eq(3stap)
                   for details.
    
           **fp_le** Check if first fp is less than or equal to
    
                  See function::fp_le(3stap)
                   for details.
    
           **fp_lt** fp comparison function less than
    
                  See function::fp_lt(3stap)
                   for details.
    
           **fp32_to_fp64**
                  Convert fp32 to 64 bit floating point
    
                  See function::fp32_to_fp64(3stap)
                   for details.
    


* * *
# io_uring_prep_sendmsg_zc

## NAME



           io_uring_prep_sendmsg - prepare a sendmsg request
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_sendmsg(struct io_uring_sqe ***_sqe_**,**
                                      **int** _fd_**,**
                                      **const struct msghdr ***_msg_**,**
                                      **unsigned** _flags_**);**
    
           **void io_uring_prep_sendmsg_zc(struct io_uring_sqe ***_sqe_**,**
                                         **int** _fd_**,**
                                         **const struct msghdr ***_msg_**,**
                                         **unsigned** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_sendmsg(3) function prepares a sendmsg request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _fd_ to start sending the data indicated by _msg_ with the sendmsg(2)
           defined flags in the _flags_ argument.
    
           The io_uring_prep_sendmsg_zc(3) accepts the same parameters as
           io_uring_prep_sendmsg(3) but prepares a zerocopy sendmsg request.
    
           See io_uring_prep_send(3) for a description of flags that can be
           set in the SQE _ioprio_ field. In addition to those, the zero-copy
           send also supports setting **IORING_SEND_ZC_REPORT_USAGE .** If set,
           the notification CQE _res_ field will report the number of bytes
           that were copied rather than sent with zero copy. A value of **0**
           indicates success. If the value is **IORING_NOTIF_USAGE_ZC_COPIED ,**
           then data was copied.
    
           Note that using **IOSQE_IO_LINK** with this request type requires the
           setting of **MSG_WAITALL** in the _flags_ argument, as a short send
           isn't considered an error condition without that being set.
    
           This function prepares an async sendmsg(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



           As with 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).
    


* * *
# function::d_path

## NAME



           function::d_path - get the full nameidata path
    


## SYNOPSIS



               d_path:string(nd:long)
    


## ARGUMENTS



           _nd_
               Pointer to nameidata.
    


## DESCRIPTION



           Returns the full dirent name (full path to the root), like the
           kernel d_path function.
    


* * *
# gnutls_ocsp_req_get_cert_id

## NAME



           gnutls_ocsp_req_get_cert_id - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_get_cert_id(gnutls_ocsp_req_const_t** _req_**,**
           **unsigned** _indx_**, gnutls_digest_algorithm_t ***_digest_**, gnutls_datum_t**
           *****_issuer_name_hash_**, gnutls_datum_t ***_issuer_key_hash_**,**
           **gnutls_datum_t ***_serial_number_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_const_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           unsigned indx
                       Specifies which extension OID to get. Use (0) to get
                       the first one.
    
           gnutls_digest_algorithm_t * digest
                       output variable with **gnutls_digest_algorithm_t** hash
                       algorithm
    
           gnutls_datum_t * issuer_name_hash
                       output buffer with hash of issuer's DN
    
           gnutls_datum_t * issuer_key_hash
                       output buffer with hash of issuer's public key
    
           gnutls_datum_t * serial_number
                       output buffer with serial number of certificate to
                       check
    


## DESCRIPTION



           This function will return the certificate information of the
            _indx_ 'ed request in the OCSP request.  The information returned
           corresponds to the CertID structure:
    
           <informalexample><programlisting> CertID      ::=     SEQUENCE {
           hashAlgorithm       AlgorithmIdentifier, issuerNameHash      OCTET
           STRING, -- Hash of Issuer's DN issuerKeyHash       OCTET STRING,
           -- Hash of Issuers public key
           serialNumber   CertificateSerialNumber }
           </programlisting></informalexample>
    
           Each of the pointers to output variables may be NULL to indicate
           that the caller is not interested in that value.
    


## RETURNS



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


* * *
# gnutls_pcert_import_openpgp

## NAME



           gnutls_pcert_import_openpgp - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_openpgp(gnutls_pcert_st ***_pcert_**,**
           **gnutls_openpgp_crt_t** _crt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure
    
           gnutls_openpgp_crt_t crt
                       The raw certificate to be imported
    
           unsigned int flags
                       zero for now
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.0
    


* * *
# gnutls_x509_crl_import

## NAME



           gnutls_x509_crl_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_import(gnutls_x509_crl_t** _crl_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       The data to store the parsed CRL.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded CRL.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded CRL to the
           native **gnutls_x509_crl_t** format. The output will be stored in
           'crl'.
    
           If the CRL is PEM encoded it should have a header of "X509 CRL".
    


## RETURNS



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


* * *
# function::register

## NAME



           function::register - Return the signed value of the named CPU
           register
    


## SYNOPSIS



               register:long(name:string)
    


## ARGUMENTS



           _name_
               Name of the register to return
    


## DESCRIPTION



           Return the value of the named CPU register, as it was saved when
           the current probe point was hit. If the register is 32 bits, it is
           sign-extended to 64 bits.
    
           For the i386 architecture, the following names are recognized.
           (name1/name2 indicates that name1 and name2 are alternative names
           for the same register.) eax/ax, ebp/bp, ebx/bx, ecx/cx, edi/di,
           edx/dx, eflags/flags, eip/ip, esi/si, esp/sp, orig_eax/orig_ax,
           xcs/cs, xds/ds, xes/es, xfs/fs, xss/ss.
    
           For the x86_64 architecture, the following names are recognized:
           64-bit registers: r8, r9, r10, r11, r12, r13, r14, r15, rax/ax,
           rbp/bp, rbx/bx, rcx/cx, rdi/di, rdx/dx, rip/ip, rsi/si, rsp/sp;
           32-bit registers: eax, ebp, ebx, ecx, edx, edi, edx, eip, esi,
           esp, flags/eflags, orig_eax; segment registers: xcs/cs, xss/ss.
    
           For powerpc, the following names are recognized: r0, r1, ... r31,
           nip, msr, orig_gpr3, ctr, link, xer, ccr, softe, trap, dar, dsisr,
           result.
    
           For s390x, the following names are recognized: r0, r1, ... r15,
           args, psw.mask, psw.addr, orig_gpr2, ilc, trap.
    
           For AArch64, the following names are recognized: x0, x1, ... x30,
           fp, lr, sp, pc, and orig_x0.
    


* * *
# cfgetospeed

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



           cfgetospeed — get output baud rate
    


## SYNOPSIS



           #include <termios.h>
    
           speed_t cfgetospeed(const struct termios *_termios_p_);
    


## DESCRIPTION



           The _cfgetospeed_() function shall extract the output baud rate from
           the **termios** structure to which the _termios_p_ argument points.
    
           This function shall return exactly the value in the **termios** data
           structure, without interpretation.
    


## RETURN VALUE



           Upon successful completion, _cfgetospeed_() shall return a value of
           type **speed_t** representing the output baud rate.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to cfgetispeed(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# iswcntrl

## NAME



           iswcntrl - test for control wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswcntrl(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswcntrl**() function is the wide-character equivalent of the
           iscntrl(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "cntrl".
    
           The wide-character class "cntrl" is disjoint from the wide-
           character class "print" and therefore also disjoint from its
           subclasses "graph", "alpha", "upper", "lower", "digit", "xdigit",
           "punct".
    
           For an unsigned char _c_ , _iscntrl(c)_ implies _iswcntrl(btowc(c))_ , but
           not vice versa.
    


## RETURN VALUE



           The **iswcntrl**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "cntrl".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# function::tcpmib_get_state

## NAME



           function::tcpmib_get_state - Get a socket's state
    


## SYNOPSIS



               tcpmib_get_state:long(sk:long)
    


## ARGUMENTS



           _sk_
               pointer to a struct sock
    


## DESCRIPTION



           Returns the sk_state from a struct sock.
    


* * *
# strnlen

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



           strnlen — get length of fixed size string
    


## SYNOPSIS



           #include <string.h>
    
           size_t strnlen(const char *_s_ , size_t _maxlen_);
    


## DESCRIPTION



           Refer to strlen(3p).
    


* * *