tripathysagar/man_text huggingface dataset:
# clock_getcpuclockid

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



           clock_getcpuclockid — access a process CPU-time clock (**ADVANCED**
           **REALTIME**)
    


## SYNOPSIS



           #include <time.h>
    
           int clock_getcpuclockid(pid_t _pid_ , clockid_t *_clock_id_);
    


## DESCRIPTION



           The _clock_getcpuclockid_() function shall return the clock ID of
           the CPU-time clock of the process specified by _pid_.  If the
           process described by _pid_ exists and the calling process has
           permission, the clock ID of this clock shall be returned in
           _clock_id_.
    
           If _pid_ is zero, the _clock_getcpuclockid_() function shall return
           the clock ID of the CPU-time clock of the process making the call,
           in _clock_id_.
    
           The conditions under which one process has permission to obtain
           the CPU-time clock ID of other processes are implementation-
           defined.
    


## RETURN VALUE



           Upon successful completion, _clock_getcpuclockid_() shall return
           zero; otherwise, an error number shall be returned to indicate the
           error.
    


## ERRORS



           The _clock_getcpuclockid_() function shall fail if:
    
           **EPERM** The requesting process does not have permission to access
                  the CPU-time clock for the process.
    
           The _clock_getcpuclockid_() function may fail if:
    
           **ESRCH** No process can be found corresponding to the process
                  specified by _pid_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _clock_getcpuclockid_() function is part of the Process CPU-Time
           Clocks option and need not be provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# wcschr

## NAME



           wcschr - search a wide character in a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcschr(const wchar_t ***_wcs_**, wchar_t** _wc_**);**
    


## DESCRIPTION



           The **wcschr**() function is the wide-character equivalent of the
           strchr(3) function.  It searches the first occurrence of _wc_ in the
           wide-character string pointed to by _wcs_.
    


## RETURN VALUE



           The **wcschr**() function returns a pointer to the first occurrence of
           _wc_ in the wide-character string pointed to by _wcs_ , or NULL if _wc_
           does not occur in the string.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# rdma_get_remote_ece

## NAME



           rdma_get_remote_ece - Get remote ECE paraemters as received from
           the peer.
    


## SYNOPSIS



                  #include <rdma/rdma_cma.h>
    
                  int rdma_get_remote_ece(struct rdma_cm_id *id, struct ibv_ece *ece);
    


## DESCRIPTION



           **rdma_get_remote_ece()** get ECE parameters as were received from the
           communication peer.
    
           This function is suppose to be used by the users of external QPs.
           The call needs to be performed before replying to the peer and
           needed to allow for the passive side to know ECE options of other
           side.
    
           Being used by external QP and RDMA_CM doesn’t manage that QP, the
           peer needs to call to libibverbs API by itself.
    
           Usual flow for the passive side will be:
    
           • ibv_create_qp() <- create data QP.
    
           • ece = rdma_get_remote_ece() <- get ECE options from remote peer
    
           • ibv_set_ece(ece) <- set local ECE options with data received
             from the peer.
    
           • ibv_modify_qp() <- enable data QP.
    
           • rdma_set_local_ece(ece) <- set desired ECE options after
             respective libibverbs provider masked unsupported options.
    
           • rdma_accept()/rdma_establish()/rdma_reject_ece()
    


## ARGUMENTS



           *id    RDMA communication identifier.
    
           *ece   ECE struct to be filled.
    


## RETURN VALUE



           **rdma_get_remote_ece()** returns 0 on success, or -1 on error.  If an
           error occurs, errno will be set to indicate the failure reason.
    


* * *
# gnutls_x509_crt_export2

## NAME



           gnutls_x509_crt_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_export2(gnutls_x509_crt_t** _cert_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       Holds the certificate
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a certificate PEM or DER encoded
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# gnutls_openpgp_privkey_sign_hash

## NAME



           gnutls_openpgp_privkey_sign_hash - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


* * *
# gnutls_verify_stored_pubkey

## NAME



           gnutls_verify_stored_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_verify_stored_pubkey(const char ***_db_name_**, gnutls_tdb_t**
           _tdb_**, const char ***_host_**, const char ***_service_**,**
           **gnutls_certificate_type_t** _cert_type_**, const gnutls_datum_t ***_cert_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * db_name
                       A file specifying the stored keys (use NULL for the
                       default)
    
           gnutls_tdb_t tdb
                       A storage structure or NULL to use the default
    
           const char * host
                       The peer's name
    
           const char * service
                       non-NULL if this key is specific to a service (e.g.
                       http)
    
           gnutls_certificate_type_t cert_type
                       The type of the certificate
    
           const gnutls_datum_t * cert
                       The raw (der) data of the certificate
    
           unsigned int flags
                       should be 0.
    


## DESCRIPTION



           This function will try to verify a raw public-key or a public-key
           provided via a raw (DER-encoded) certificate using a list of
           stored public keys.  The  _service_ field if non-NULL should be a
           port number.
    
           The  _db_name_ variable if non-null specifies a custom backend for
           the retrieval of entries. If it is NULL then the default file
           backend will be used. In POSIX-like systems the file backend uses
           the $HOME/.gnutls/known_hosts file.
    
           Note that if the custom storage backend is provided the retrieval
           function should return **GNUTLS_E_CERTIFICATE_KEY_MISMATCH** if the
           host/service pair is found but key doesn't match,
           **GNUTLS_E_NO_CERTIFICATE_FOUND** if no such host/service with the
           given key is found, and 0 if it was found. The storage function
           should return 0 on success.
    
           As of GnuTLS 3.6.6 this function also verifies raw public keys.
    


## RETURNS



           If no associated public key is found then
           **GNUTLS_E_NO_CERTIFICATE_FOUND** will be returned. If a key is found
           but does not match **GNUTLS_E_CERTIFICATE_KEY_MISMATCH** is returned.
           On success, **GNUTLS_E_SUCCESS**(0) is returned, or a negative error
           value on other errors.
    


## SINCE



           3.0.13
    


* * *
# audit_detect_machine

## NAME



           audit_detect_machine - Detects the current machine type
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_detect_machine(void);**
    


## DESCRIPTION



           audit_detect_machine queries uname and converts the kernel machine
           string to an enum value defined in machine_t. The machine type is
           needed for any use of the audit_name_to_syscall function.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, the return value is the
           machine's type.
    


* * *
# uuid_is_null

## NAME



           uuid_is_null - compare the value of the UUID to the NULL value
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **int uuid_is_null(const uuid_t** _uu_**);**
    


## DESCRIPTION



           The **uuid_is_null**() function compares the value of the supplied
           UUID variable _uu_ to the NULL value. If the value is equal to the
           NULL UUID, 1 is returned, otherwise 0 is returned.
    


## AVAILABILITY



           The **libuuid** library is part of the util-linux package since
           version 2.15.1. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                _UUID_IS_NULL_(3)
    


* * *
# gnutls_x509_ext_export_authority_key_id

## NAME



           gnutls_x509_ext_export_authority_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_authority_key_id(gnutls_x509_aki_t** _aki_**,**
           **gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           gnutls_x509_aki_t aki
                       An initialized authority key identifier
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the provided key identifier to a
           DER-encoded PKIX AuthorityKeyIdentifier extension.  The output
           data in  _ext_ will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# tcsendbreak

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



           tcsendbreak — send a break for a specific duration
    


## SYNOPSIS



           #include <termios.h>
    
           int tcsendbreak(int _fildes_ , int _duration_);
    


## DESCRIPTION



           If the terminal is using asynchronous serial data transmission,
           _tcsendbreak_() shall cause transmission of a continuous stream of
           zero-valued bits for a specific duration. If _duration_ is 0, it
           shall cause transmission of zero-valued bits for at least 0.25
           seconds, and not more than 0.5 seconds. If _duration_ is not 0, it
           shall send zero-valued bits for an implementation-defined period
           of time.
    
           The _fildes_ argument is an open file descriptor associated with a
           terminal.
    
           If the terminal is not using asynchronous serial data
           transmission, it is implementation-defined whether _tcsendbreak_()
           sends data to generate a break condition or returns without taking
           any action.
    
           Attempts to use _tcsendbreak_() from a process which is a member of
           a background process group on a _fildes_ associated with its
           controlling terminal shall cause the process group to be sent a
           SIGTTOU signal.  If the calling thread is blocking SIGTTOU signals
           or the process is ignoring SIGTTOU signals, the process shall be
           allowed to perform the operation, and no signal is sent.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned. Otherwise, -1
           shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _tcsendbreak_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **EIO** The process group of the writing process is orphaned, the
                  calling thread is not blocking SIGTTOU, and the process is
                  not ignoring SIGTTOU.
    
           **ENOTTY** The file associated with _fildes_ is not a terminal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# libpfm_intel_knc

## NAME



           libpfm_intel_knc - support for Intel Knights Corner
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: knc**
           **PMU desc: Intel Knights Corner**
    


## DESCRIPTION



           The library supports Intel Knights Corner processors.
    


## MODIFIERS



           The following modifiers are supported on Intel Knights Corner
           processors:
    
           **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.
    
           **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].
    
           **t** Measure on all threads at the same time assuming hyper-
                  threading is enabled. This is a boolean modifier.
    


* * *
# gnutls_privkey_sign_hash

## NAME



           gnutls_privkey_sign_hash - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_sign_hash(gnutls_privkey_t** _signer_**,**
           **gnutls_digest_algorithm_t** _hash_algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_hash_data_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_privkey_t signer
                       Holds the signer's key
    
           gnutls_digest_algorithm_t hash_algo
                       The hash algorithm used
    
           unsigned int flags
                       Zero or one of **gnutls_privkey_flags_t**
    
           const gnutls_datum_t * hash_data
                       holds the data to be signed
    
           gnutls_datum_t * signature
                       will contain newly allocated signature
    


## DESCRIPTION



           This function will sign the given hashed data using a signature
           algorithm supported by the private key. Signature algorithms are
           always used together with a hash functions.  Different hash
           functions may be used for the RSA algorithm, but only SHA-XXX for
           the DSA keys.
    
           You may use **gnutls_pubkey_get_preferred_hash_algorithm()** to
           determine the hash algorithm.
    
           The flags may be **GNUTLS_PRIVKEY_SIGN_FLAG_TLS1_RSA** or
           **GNUTLS_PRIVKEY_SIGN_FLAG_RSA_PSS**.  In the former case this
           function will ignore  _hash_algo_ and perform a raw PKCS1 signature,
           and in the latter an RSA-PSS signature will be generated.
    
           Note that, not all algorithm support signing already hashed data.
           When signing with Ed25519, **gnutls_privkey_sign_data()** should be
           used.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_x509_crt_get_issuer_dn3

## NAME



           gnutls_x509_crt_get_issuer_dn3 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_dn3(gnutls_x509_crt_t** _cert_**,**
           **gnutls_datum_t ***_dn_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    
           unsigned flags
                       zero or **GNUTLS_X509_DN_FLAG_COMPAT**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of issuer of
           the Certificate.  The name will be in the form
           "C=xxxx,O=yyyy,CN=zzzz" as described in RFC4514. The output string
           will be ASCII or UTF-8 encoded, depending on the certificate data.
    
           When the flag **GNUTLS_X509_DN_FLAG_COMPAT** is specified, the output
           format will match the format output by previous to 3.5.6 versions
           of GnuTLS which was not not fully RFC4514-compliant.
    


## RETURNS



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


## SINCE



           3.5.7
    


* * *
# atanf

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



           atanf — arc tangent function
    


## SYNOPSIS



           #include <math.h>
    
           float atanf(float _x_);
    


## DESCRIPTION



           Refer to atan(3p).
    


* * *
# function::user_buffer_quoted

## NAME



           function::user_buffer_quoted - Retrieves and quotes buffer from
           user space
    


## SYNOPSIS



               user_buffer_quoted:string(addr:long,inlen:long,outlen:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the buffer from
    
           _inlen_
               the exact length of the buffer to read
    
           _outlen_
               the maximum length of the output string
    


## DESCRIPTION



           Reads inlen characters of a buffer from the given user space
           memory address, and returns up to outlen characters, where any
           ASCII characters that are not printable are replaced by the
           corresponding escape sequence in the returned string. Note that
           the string will be surrounded by double quotes. On the rare cases
           when user space data is not accessible at the given address, the
           address itself is returned as a string, without double quotes.
    


* * *
# menu_hook

## NAME



           **menu_hook** - set hooks for automatic invocation by applications
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_item_init(MENU ***_menu_**, Menu_Hook** _func);_
           **Menu_Hook item_init(const MENU ***_menu);_
    
           **int set_item_term(MENU ***_menu_**, Menu_Hook** _func);_
           **Menu_Hook item_term(const MENU ***_menu);_
    
           **int set_menu_init(MENU ***_menu_**, Menu_Hook** _func);_
           **Menu_Hook menu_init(const MENU ***_menu);_
    
           **int set_menu_term(MENU ***_menu_**, Menu_Hook** _func);_
           **Menu_Hook menu_term(const MENU ***_menu);_
    


## DESCRIPTION



           These functions make it possible to set hook functions to be
           called at various points in the automatic processing of input
           event codes by **menu_driver**.
    
           The function **set_item_init** sets a hook to be called at menu-post
           time and each time the selected item changes (after the change).
           **item_init** returns the current item init hook, if any (**NULL** if
           there is no such hook).
    
           The function **set_item_term** sets a hook to be called at menu-unpost
           time and each time the selected item changes (before the change).
           **item_term** returns the current item term hook, if any (**NULL** if
           there is no such hook).
    
           The function **set_menu_init** sets a hook to be called at menu-post
           time and just after the top row on the menu changes once it is
           posted.  **menu_init** returns the current menu init hook, if any
           (**NULL** if there is no such hook).
    
           The function **set_menu_term** sets a hook to be called at menu-unpost
           time and just before the top row on the menu changes once it is
           posted.  **menu_term** returns the current menu term hook, if any
           (**NULL** if there is no such hook).
    


## RETURN VALUE



           Routines that return pointers return **NULL** on error.  Other
           routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



           The header file **< menu.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# gnutls_pkcs7_verify_direct

## NAME



           gnutls_pkcs7_verify_direct - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_verify_direct(gnutls_pkcs7_t** _pkcs7_**,**
           **gnutls_x509_crt_t** _signer_**, unsigned** _idx_**, const gnutls_datum_t ***
           _data_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a **gnutls_pkcs7_t** type
    
           gnutls_x509_crt_t signer
                       the certificate believed to have signed the structure
    
           unsigned idx
                       the index of the signature info to check
    
           const gnutls_datum_t * data
                       The data to be verified or **NULL**
    
           unsigned flags
                       Zero or an OR list of **gnutls_certificate_verify_flags**
    


## DESCRIPTION



           This function will verify the provided data against the signature
           present in the SignedData of the PKCS **7** structure. If the data
           provided are NULL then the data in the encapsulatedContent field
           will be used instead.
    
           Note that, unlike **gnutls_pkcs7_verify()** this function does not
           verify the key purpose of the signer. It is expected for the
           caller to verify the intended purpose of the **signer** -e.g., via
           **gnutls_x509_crt_get_key_purpose_oid()** , or
           **gnutls_x509_crt_check_key_purpose()**.
    
           Note also, that since GnuTLS 3.5.6 this function introduces checks
           in the end certificate ( _signer_ ), including time checks and key
           usage checks.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value. A verification error results to a
           **GNUTLS_E_PK_SIG_VERIFY_FAILED** and the lack of encapsulated data to
           verify to a **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.
    


## SINCE



           3.4.2
    


* * *
# mlx5dv_create_flow_action_packet_reformat

## NAME



           mlx5dv_create_flow_action_packet_reformat - Flow action reformat
           packet for mlx5 provider
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_flow_action *
                  mlx5dv_create_flow_action_packet_reformat(struct ibv_context *ctx,
                                        size_t data_sz,
                                        void *data,
                                        enum mlx5dv_flow_action_packet_reformat_type reformat_type,
                                        enum mlx5dv_flow_table_type ft_type)
    


## DESCRIPTION



           Create a packet reformat flow steering action.  It allows
           adding/removing packet headers.
    


## ARGUMENTS



           _ctx_
    
                  RDMA device context to create the action on.
    
           _data_sz_
    
                  The size of *data* buffer.
    
           _data_
    
                  A buffer which contains headers in case the actions requires them.
    
           _reformat_type_
    
                  The reformat type to be create. Use enum mlx5dv_flow_action_packet_reformat_type.
    
                  MLX5DV_FLOW_ACTION_PACKET_REFORMAT_TYPE_L2_TUNNEL_TO_L2:
                  Decap a generic L2 tunneled packet up to inner L2.
    
                  MLX5DV_FLOW_ACTION_PACKET_REFORMAT_TYPE_L2_TO_L2_TUNNEL:
                  Generic encap, _data_ should contain the encapsulating
                  headers.
    
                  MLX5DV_FLOW_ACTION_PACKET_REFORMAT_TYPE_L3_TUNNEL_TO_L2:
                  Will do decap where the inner packet starts from L3.  _data_
                  should be MAC or MAC + vlan (14 or 18 bytes) to be appended
                  to the packet after the decap action.
    
                  MLX5DV_FLOW_ACTION_PACKET_REFORMAT_TYPE_L2_TO_L3_TUNNEL:
                  Will do encap where is L2 of the original packet will not
                  be included.  _data_ should be the encapsulating header.
    
           _ft_type_
    
                  It defines the flow table type to which the packet reformat action
                  will be attached.
    


## RETURN VALUE



           Upon success _mlx5dv_create_flow_action_packet_reformat_ will return
           a new _struct ibv_flow_action_ object, on error NULL will be
           returned and errno will be set.
    


* * *
# islessequal

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



           islessequal — test if x is less than or equal to y
    


## SYNOPSIS



           #include <math.h>
    
           int islessequal(real-floating _x_ , real-floating _y_);
    


## 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 _islessequal_() macro shall determine whether its first argument
           is less than or equal to its second argument. The value of
           _islessequal_(_x_ , _y_) shall be equal to (_x_) <= (_y_); however, unlike
           (_x_) <= (_y_), _islessequal_(_x_ , _y_) shall not raise the invalid
           floating-point exception when _x_ and _y_ are unordered.
    


## RETURN VALUE



           Upon successful completion, the _islessequal_() macro shall return
           the value of (_x_) <= (_y_).
    
           If _x_ or _y_ is NaN, 0 shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The relational and equality operators support the usual
           mathematical relationships between numeric values. For any ordered
           pair of numeric values, exactly one of the relationships (less,
           greater, and equal) is true. Relational operators may raise the
           invalid floating-point exception when argument values are NaNs.
           For a NaN and a numeric value, or for two NaNs, just the unordered
           relationship is true. This macro is a quiet (non-floating-point
           exception raising) version of a relational operator. It
           facilitates writing efficient code that accounts for NaNs without
           suffering the invalid floating-point exception. In the SYNOPSIS
           section, **real-floating** indicates that the argument shall be an
           expression of **real-floating** type.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# libpfm_amd64_fam19h_zen3_l3

## NAME



           libpfm_amd64_fam19h_zen3_l3 - support for AMD64 Family 19h L3 PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam19h_zen3_l3**
           **PMU desc: AMD64 Fam19h Zen3 L3**
    


## DESCRIPTION



           The library supports AMD Family 19h processors Zen3 L3 PMU in both
           32 and 64-bit modes.
    
           At this point, there is no modifier supported.
    


* * *
# ibv_import_device

## NAME



           ibv_import_device - import a device from a given command FD
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_context *ibv_import_device(int cmd_fd);
    


## DESCRIPTION



           **ibv_import_device()** returns an _ibv_context_ pointer that is
           associated with the given _cmd_fd_.
    
           The _cmd_fd_ is obtained from the ibv_context cmd_fd member, which
           must be dup’d (eg by dup(), SCM_RIGHTS, etc) before being passed
           to ibv_import_device().
    
           Once the _ibv_context_ usage has been ended _ibv_close_device()_
           should be called.  This call may cleanup whatever is
           needed/opposite of the import including closing the command FD.
    


## RETURN VALUE



           **ibv_import_device()** returns a pointer to the allocated RDMA
           context, or NULL if the request fails.
    


* * *
# gnutls_dh_get_secret_bits

## NAME



           gnutls_dh_get_secret_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_get_secret_bits(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function will return the bits used in the last Diffie-Hellman
           key exchange with the peer.  Should be used for both anonymous and
           ephemeral Diffie-Hellman.
    


## RETURNS



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


* * *
# keyctl_get_security

## NAME



           keyctl_get_security - retrieve a key's security context
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_get_security(key_serial_t** _key_**, char ***_buffer_**,**
           **size_t** _buflen_**);**
    
           **long keyctl_get_security_alloc(key_serial_t** _key_**, char ****__buffer_**);**
    


## DESCRIPTION



           **keyctl_get_security**() retrieves the security context of a key as a
           NUL-terminated string.  This will be rendered in a form
           appropriate to the LSM in force - for instance, with SELinux, it
           may look like
    
                  **unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023**
    
           The caller must have **view** permission on a key to be able to get
           its security context.
    
           _buffer_ and _buflen_ specify the buffer into which the string will be
           placed.  If the buffer is too small, the full size of the string
           will be returned, and no copy will take place.
    
           **keyctl_get_security_alloc**() is similar to **keyctl_get_security**()
           except that it allocates a buffer big enough to hold the string
           and copies the string into it.  If successful, A pointer to the
           buffer is placed in _*_buffer_.  The caller must free the buffer.
    


## RETURN VALUE



           On success **keyctl_get_security**() returns the amount of data placed
           into the buffer.  If the buffer was too small, then the size of
           buffer required will be returned, but no data will be transferred.
           On error, the value **-1** will be returned and _errno_ will have been
           set to an appropriate error.
    
           On success **keyctl_get_security_alloc**() returns the amount of data
           in the buffer, less the NUL terminator.  On error, the value **-1**
           will be returned and _errno_ will have been set to an appropriate
           error.
    


## ERRORS



           **ENOKEY** The key specified is invalid.
    
           **EKEYEXPIRED**
                  The key specified has expired.
    
           **EKEYREVOKED**
                  The key specified had been revoked.
    
           **EACCES** The key exists, but is not **viewable** by the calling process.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# gnutls_pubkey_set_key_usage

## NAME



           gnutls_pubkey_set_key_usage - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_set_key_usage(gnutls_pubkey_t** _key_**, unsigned int**
           _usage_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       a certificate of type **gnutls_x509_crt_t**
    
           unsigned int usage
                       an ORed sequence of the GNUTLS_KEY_* elements.
    


## DESCRIPTION



           This function will set the key usage flags of the public key. This
           is only useful if the key is to be exported to a certificate or
           certificate request.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::signal.sys_tkill

## NAME



           probe::signal.sys_tkill - Sending a kill signal to a thread
    


## SYNOPSIS



           signal.sys_tkill
    


## VALUES



           _pid_name_
               The name of the signal recipient
    
           _task_
               A task handle to the signal recipient
    
           _sig_pid_
               The PID of the process receiving the kill signal
    
           _name_
               Name of the probe point
    
           _sig_name_
               A string representation of the signal
    
           _sig_
               The specific signal sent to the process
    


## DESCRIPTION



           The tkill call is analogous to kill(2), except that it also allows
           a process within a specific thread group to be targeted. Such
           processes are targeted through their unique thread IDs (TID).
    


* * *
# sched_getcpu

## NAME



           sched_getcpu - determine CPU on which the calling thread is
           running
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sched.h>**
    
           **int sched_getcpu(void);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **sched_getcpu**():
               Since glibc 2.14:
                   _GNU_SOURCE
               Before glibc 2.14:
                   _BSD_SOURCE || _SVID_SOURCE
                       /* _GNU_SOURCE also suffices */
    


## DESCRIPTION



           **sched_getcpu**() returns the number of the CPU on which the calling
           thread is currently executing.
    


## RETURN VALUE



           On success, **sched_getcpu**() returns a nonnegative CPU number.  On
           error, -1 is returned and _errno_ is set to indicate the error.
    


## ERRORS



           **ENOSYS** This kernel does not implement getcpu(2).
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## NOTES



           The call
    
               cpu = sched_getcpu();
    
           is equivalent to the following getcpu(2) call:
    
               int c, s;
               s = getcpu(&c, NULL);
               cpu = (s == -1) ? s : c;
    


* * *
# siglongjmp

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



           siglongjmp — non-local goto with signal handling
    


## SYNOPSIS



           #include <setjmp.h>
    
           void siglongjmp(sigjmp_buf _env_ , int _val_);
    


## DESCRIPTION



           The _siglongjmp_() function shall be equivalent to the _longjmp_()
           function, except as follows:
    
            *  References to _setjmp_() shall be equivalent to _sigsetjmp_().
    
            *  The _siglongjmp_() function shall restore the saved signal mask
               if and only if the _env_ argument was initialized by a call to
               _sigsetjmp_() with a non-zero _savemask_ argument.
    


## RETURN VALUE



           After _siglongjmp_() is completed, program execution shall continue
           as if the corresponding invocation of _sigsetjmp_() had just
           returned the value specified by _val_.  The _siglongjmp_() function
           shall not cause _sigsetjmp_() to return 0; if _val_ is 0, _sigsetjmp_()
           shall return the value 1.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The distinction between _setjmp_() or _longjmp_() and _sigsetjmp_() or
           _siglongjmp_() is only significant for programs which use
           _sigaction_(), _sigprocmask_(), or _sigsuspend_().
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# _toupper

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



           _toupper — transliterate lowercase characters to uppercase
    


## SYNOPSIS



           #include <ctype.h>
    
           int _toupper(int _c_);
    


## DESCRIPTION



           The __toupper_() macro shall be equivalent to _toupper_() except that
           the application shall ensure that the argument _c_ is a lowercase
           letter.
    


## RETURN VALUE



           Upon successful completion, __toupper_() shall return the uppercase
           letter corresponding to the argument passed.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications should use the _toupper_() function instead of the
           obsolescent __toupper_() function.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



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


* * *
# chdir

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



           chdir — change working directory
    


## SYNOPSIS



           #include <unistd.h>
    
           int chdir(const char *_path_);
    


## DESCRIPTION



           The _chdir_() function shall cause the directory named by the
           pathname pointed to by the _path_ argument to become the current
           working directory; that is, the starting point for path searches
           for pathnames not beginning with **'/'**.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned. Otherwise, -1
           shall be returned, the current working directory shall remain
           unchanged, and _errno_ shall be set to indicate the error.
    


## ERRORS



           The _chdir_() function shall fail if:
    
           **EACCES** Search permission is denied for any component of the
                  pathname.
    
           **ELOOP** A loop exists in symbolic links encountered during
                  resolution of the _path_ argument.
    
           **ENAMETOOLONG**
                  The length of a component of a pathname is longer than
                  {NAME_MAX}.
    
           **ENOENT** A component of _path_ does not name an existing directory or
                  _path_ is an empty string.
    
           **ENOTDIR**
                  A component of the pathname names an existing file that is
                  neither a directory nor a symbolic link to a directory.
    
           The _chdir_() function may fail if:
    
           **ELOOP** More than {SYMLOOP_MAX} symbolic links were encountered
                  during resolution of the _path_ argument.
    
           **ENAMETOOLONG**
                  The length of a pathname exceeds {PATH_MAX}, or pathname
                  resolution of a symbolic link produced an intermediate
                  result with a length that exceeds {PATH_MAX}.
    
           _The following sections are informative._
    


## EXAMPLES



       **Changing the Current Working Directory**
           The following example makes the value pointed to by **directory** ,
           **/tmp** , the current working directory.
    
               #include <unistd.h>
               ...
               char *directory = "/tmp";
               int ret;
    
               ret = chdir (directory);
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The _chdir_() function only affects the working directory of the
           current process.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_cipher_tag

## NAME



           gnutls_cipher_tag - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_tag(gnutls_cipher_hd_t** _handle_**, void ***_tag_**,**
           **size_t** _tag_size_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           void * tag  will hold the tag
    
           size_t tag_size
                       the length of the tag to return
    


## DESCRIPTION



           This function operates on authenticated encryption with associated
           data (AEAD) ciphers and will return the output tag.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.0
    


* * *
# io_uring_prep_shutdown

## NAME



           io_uring_prep_shutdown - prepare a shutdown request
    


## SYNOPSIS



           **#include <sys/socket.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_shutdown(struct io_uring_sqe ***_sqe_**,**
                                       **int** _sockfd_**,**
                                       **int** _how_**);**
    


## DESCRIPTION



           The io_uring_prep_shutdown(3) function prepares a shutdown
           request. The submission queue entry _sqe_ is setup to use the file
           descriptor _sockfd_ that should be shutdown with the _how_ argument.
    
           This function prepares an async shutdown(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.
    


* * *