tripathysagar/man_text huggingface dataset:
# ll2_import_lastlog

## NAME



           ll2_import_lastlog - Imports old lastlog file.
    


## SYNOPSIS



           **#include <lastlog2.h>**
    
           **int ll2_import_lastlog (struct ll2_context ***_context_**, const char**
           *****_lastlog_file_**, char ****_error_**);**
    


## DESCRIPTION



           Imports all entries from _lastlog_file_ file (lastlog(8)) into
           lastlog2 database defined with _context_. If _context_ is NULL, the
           default database, defined in _LL2_DEFAULT_DATABASE_ , will be taken.
    
               char    *error = NULL;
               const   char *lastlog_path = "/var/log/lastlog";
    
               int ret = ll2_import_lastlog (NULL, lastlog_path, &error);
    


## RETURN VALUE



           Returns 0 on success, -ENOMEM or -1 on other failure. _error_
           contains an error string if the return value is -1. _error_ is not
           guaranteed to contain an error string, could also be NULL. _error_
           should be freed by the caller.
    


## AVAILABILITY



           The **liblastlog2** library is part of the util-linux package since
           version 2.40. 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-01-16          _LL2_IMPORT_LASTLOG_(3)
    


* * *
# mlx5dv_dump

## NAME



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


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



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


* * *
# gnutls_prf_rfc5705

## NAME



           gnutls_prf_rfc5705 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_prf_rfc5705(gnutls_session_t** _session_**, size_t**
           _label_size_**, const char ***_label_**, size_t** _context_size_**, const char ***
           _context_**, size_t** _outsize_**, char ***_out_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t label_size
                       length of the  _label_ variable.
    
           const char * label
                       label used in PRF computation, typically a short
                       string.
    
           size_t context_size
                       length of the  _extra_ variable.
    
           const char * context
                       optional extra data to seed the PRF with.
    
           size_t outsize
                       size of pre-allocated output buffer to hold the
                       output.
    
           char * out  pre-allocated buffer to hold the generated data.
    


## DESCRIPTION



           Exports keying material from TLS/DTLS session to an application,
           as specified in RFC5705.
    
           In the TLS versions prior to 1.3, it applies the TLS
           Pseudo-Random-Function (PRF) on the master secret and the provided
           data, seeded with the client and server random fields.
    
           In TLS 1.3, it applies HKDF on the exporter master secret derived
           from the master secret.
    
           The  _label_ variable usually contains a string denoting the purpose
           for the generated data.
    
           The  _context_ variable can be used to add more data to the seed,
           after the random variables.  It can be used to make sure the
           generated output is strongly connected to some additional data
           (e.g., a string used in user authentication).
    
           The output is placed in  _out_ , which must be pre-allocated.
    
           Note that, to provide the RFC5705 context, the  _context_ variable
           must be non-null.
    


## RETURNS



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


## SINCE



           3.4.4
    


* * *
# gnutls_system_key_iter_get_info

## NAME



           gnutls_system_key_iter_get_info - API function
    


## SYNOPSIS



           **#include <gnutls/system-keys.h>**
    
           **int gnutls_system_key_iter_get_info(gnutls_system_key_iter_t ***
           _iter_**, unsigned** _cert_type_**, char ****_cert_url_**, char ****_key_url_**, char**
           ******_label_**, gnutls_datum_t ***_der_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_system_key_iter_t * iter
                       an iterator of the system keys (must be set to **NULL**
                       initially)
    
           unsigned cert_type
                       A value of gnutls_certificate_type_t which indicates
                       the type of certificate to look for
    
           char ** cert_url
                       The certificate URL of the pair (may be **NULL**)
    
           char ** key_url
                       The key URL of the pair (may be **NULL**)
    
           char ** label
                       The friendly name (if any) of the pair (may be **NULL**)
    
           gnutls_datum_t * der
                       if non-NULL the DER data of the certificate
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will return on each call a certificate and key pair
           URLs, as well as a label associated with them, and the DER-encoded
           certificate. When the iteration is complete it will return
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.
    
           Typically  _cert_type_ should be **GNUTLS_CRT_X509**.
    
           All values set are allocated and must be cleared using
           **gnutls_free()** ,
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# function::execname

## NAME



           function::execname - Returns the execname of a target process (or
           group of processes)
    


## SYNOPSIS



               execname:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the execname of a target process (or group of processes).
    


* * *
# pthread_rwlockattr_setpshared

## 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_rwlockattr_setpshared — set the process-shared attribute
           of the read-write lock attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_rwlockattr_setpshared(pthread_rwlockattr_t *_attr_ ,
               int _pshared_);
    


## DESCRIPTION



           Refer to pthread_rwlockattr_getpshared(3p).
    


* * *
# fwrite

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



           fwrite — binary output
    


## SYNOPSIS



           #include <stdio.h>
    
           size_t fwrite(const void *restrict _ptr_ , size_t _size_ , size_t _nitems_ ,
               FILE *restrict _stream_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _fwrite_() function shall write, from the array pointed to by
           _ptr_ , up to _nitems_ elements whose size is specified by _size_ , to the
           stream pointed to by _stream_.  For each object, _size_ calls shall be
           made to the _fputc_() function, taking the values (in order) from an
           array of **unsigned char** exactly overlaying the object. The file-
           position indicator for the stream (if defined) shall be advanced
           by the number of bytes successfully written. If an error occurs,
           the resulting value of the file-position indicator for the stream
           is unspecified.
    
           The last data modification and last file status change timestamps
           of the file shall be marked for update between the successful
           execution of _fwrite_() and the next successful completion of a call
           to _fflush_() or _fclose_() on the same stream, or a call to _exit_() or
           _abort_().
    


## RETURN VALUE



           The _fwrite_() function shall return the number of elements
           successfully written, which may be less than _nitems_ if a write
           error is encountered. If _size_ or _nitems_ is 0, _fwrite_() shall
           return 0 and the state of the stream remains unchanged. Otherwise,
           if a write error occurs, the error indicator for the stream shall
           be set, and _errno_ shall be set to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Because of possible differences in element length and byte
           ordering, files written using _fwrite_() are application-dependent,
           and possibly cannot be read using _fread_() by a different
           application or by the same application on a different processor.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_privkey_import_pkcs8

## NAME



           gnutls_x509_privkey_import_pkcs8 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_pkcs8(gnutls_x509_privkey_t** _key_**,**
           **const gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**, const**
           **char ***_password_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_datum_t * data
                       The DER or PEM encoded key.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    
           const char * password
                       the password to decrypt the key (if it is encrypted).
    
           unsigned int flags
                       0 if encrypted or GNUTLS_PKCS_PLAIN if not encrypted.
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded PKCS8 2.0
           encrypted key to the native gnutls_x509_privkey_t format. The
           output will be stored in  _key_ .  Both RSA and DSA keys can be
           imported, and flags can only be used to indicate an unencrypted
           key.
    
           The  _password_ can be either ASCII or UTF-8 in the default PBES2
           encryption schemas, or ASCII for the PKCS12 schemas.
    
           If the Certificate is PEM encoded it should have a header of
           "ENCRYPTED PRIVATE KEY", or "PRIVATE KEY". You only need to
           specify the flags if the key is DER encoded, since in that case
           the encryption status cannot be auto-detected.
    
           If the **GNUTLS_PKCS_PLAIN** flag is specified and the supplied data
           are encrypted then **GNUTLS_E_DECRYPTION_FAILED** is returned.
    


## RETURNS



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


* * *
# gnutls_pkcs12_bag_get_data

## NAME



           gnutls_pkcs12_bag_get_data - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_get_data(gnutls_pkcs12_bag_t** _bag_**, unsigned**
           _indx_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           unsigned indx
                       The element of the bag to get the data from
    
           gnutls_datum_t * data
                       where the bag's data will be. Should be treated as
                       constant.
    


## DESCRIPTION



           This function will return the bag's data. The data is a constant
           that is stored into the bag.  Should not be accessed after the bag
           is deleted.
    


## RETURNS



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


* * *
# gnutls_x509_aki_set_id

## NAME



           gnutls_x509_aki_set_id - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_aki_t aki
                       The authority key ID
    
           const gnutls_datum_t * id
                       the key identifier
    


## DESCRIPTION



           This function will set the keyIdentifier to be stored in the  _aki_
           type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# probe::nfs.fop.write_iter

## NAME



           probe::nfs.fop.write_iter - NFS client write_iter file operation
    


## SYNOPSIS



           nfs.fop.write_iter
    


## VALUES



           _pos_
               offset of the file
    
           _file_name_
               file name
    
           _parent_name_
               parent dir name
    
           _ino_
               inode number
    
           _count_
               read bytes
    
           _dev_
               device identifier
    


* * *
# gnutls_certificate_set_x509_crl_mem

## NAME



           gnutls_certificate_set_x509_crl_mem - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_crl_mem(gnutls_certificate_credentials_t**
           _res_**, const gnutls_datum_t ***_CRL_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const gnutls_datum_t * CRL
                       is a list of trusted CRLs. They should have been
                       verified before.
    
           gnutls_x509_crt_fmt_t type
                       is DER or PEM
    


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


* * *
# tfind

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



           tfind — search binary search tree
    


## SYNOPSIS



           #include <search.h>
    
           void *tfind(const void *_key_ , void *const *_rootp_ ,
               int (*_compar_)(const void *, const void *));
    


## DESCRIPTION



           Refer to tdelete(3p).
    


* * *
# acl_set_tag_type

## NAME



           **acl_set_tag_type** — set the tag type of an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_set_tag_type**(_acl_entry_t_
           _entry_d_ , _acl_tag_t tag_type_)
    


## DESCRIPTION



           The **acl_set_tag_type**() function sets the tag type of the ACL entry
           indicated by the argument _entry_d_ to the value of the argument
           _tag_type_.
    
           Any ACL entry descriptors that refer to the entry referred to by
           _entry_d_ continue to refer to that entry.
    


## RETURN VALUE



           The **acl_set_tag_type**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_set_tag_type**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _entry_d_ is not a valid descriptor
                              for an ACL entry.
    
                              The argument _tag_type_ is not a valid tag type.
    


## STANDARDS



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


* * *
# probe::tty.init

## NAME



           probe::tty.init - Called when a tty is being initalized
    


## SYNOPSIS



           tty.init
    


## VALUES



           _name_
               the driver .dev_name name
    
           _module_
               the module name
    
           _driver_name_
               the driver name
    


* * *
# probe::linuxmib.DelayedACKs

## NAME



           probe::linuxmib.DelayedACKs - Count of delayed acks
    


## SYNOPSIS



           linuxmib.DelayedACKs
    


## VALUES



           _op_
               Value to be added to the counter (default value of 1)
    
           _sk_
               Pointer to the struct sock being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **linuxmib_filter_key**. If the packet passes the filter is is counted
           in the global _DelayedACKs_ (equivalent to SNMP's MIB
           LINUX_MIB_DELAYEDACKS)
    


* * *
# umad_get_mad_addr

## NAME



           umad_get_mad_addr - get the address of the ib_mad_addr from a umad
           buffer
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **ib_mad_addr_t * umad_get_mad_addr(void** _*umad_**);**
    


## DESCRIPTION



           **umad_get_mad_addr()** returns a pointer to the ib_mad_addr struct
           within the specified _umad_ buffer.
    


## RETURN VALUE



           The return value is a pointer to an _ib_mad_addr_t_ struct, as
           specified in <infiniband/umad.h>.
    
           typedef struct ib_mad_addr {
                   uint32_t qpn;
                   uint32_t qkey;
                   uint16_t lid;
                   uint8_t  sl;
                   uint8_t  path_bits;
                   uint8_t  grh_present;
                   uint8_t  gid_index;
                   uint8_t  hop_limit;
                   uint8_t  traffic_class;
                   uint8_t  gid[16];
                   uint32_t flow_label;
           } ib_mad_addr_t;
    


* * *
# pcre2_match_data_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_match_data_free(pcre2_match_data ***_match_data_**);**
    


## DESCRIPTION



    
           If _match_data_ is NULL, this function does nothing. Otherwise,
           _match_data_ must point to a match data block, which this function
           frees, using the memory freeing function from the general context
           or compiled pattern with which it was created, or **free()** if that
           was not set. If the match data block was previously passed to
           **pcre2_match()** , it will have an attached heapframe vector; this is
           also freed.
    
           If the PCRE2_COPY_MATCHED_SUBJECT was used for a successful match
           using this match data block, the copy of the subject that was
           referenced within the block is also freed.
    
           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.
    


* * *
# pcre2_compile_context_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_compile_context *pcre2_compile_context_create(**
             **pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function creates and initializes a new compile context. If
           its argument is NULL, **malloc()** is used to get the necessary
           memory; otherwise the memory allocation function within the
           general context is used. The result is NULL if the memory could
           not be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_ecc_curve_set_enabled

## NAME



           gnutls_ecc_curve_set_enabled - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ecc_curve_set_enabled(gnutls_ecc_curve_t** _curve_**,**
           **unsigned int** _enabled_**);**
    


## ARGUMENTS



           gnutls_ecc_curve_t curve
                       is an ECC curve
    
           unsigned int enabled
                       whether to enable the curve
    


## DESCRIPTION



           Modify the previous system wide setting that marked  _curve_ as
           enabled or disabled.  Calling this function is allowed only if
           allowlisting mode is set in the configuration file, and only if
           the system-wide TLS priority string has not been initialized yet.
           The intended usage is to provide applications with a way to
           expressly deviate from the distribution or site defaults inherited
           from the configuration file.  The modification is composable with
           further modifications performed through the priority string
           mechanism.
    
           This function is not thread-safe and is intended to be called in
           the main thread at the beginning of the process execution.
    


## RETURNS



           0 on success or negative error code otherwise.
    


## SINCE



           3.7.3
    


* * *
# gnutls_psk_server_get_username2

## NAME



           gnutls_psk_server_get_username2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_psk_server_get_username2(gnutls_session_t** _session_**,**
           **gnutls_datum_t ***_username_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           gnutls_datum_t * username
                       a datum that will be filled in by this function
    


## DESCRIPTION



           Return a pointer to the username of the peer in the supplied
           datum. Does not need to be null-terminated.
    
           This should only be called in case of PSK authentication and in
           case of a server.
    
           The returned pointer should be considered constant (do not free)
           and valid for the lifetime of the session.
    


## RETURNS



           **GNUTLS_E_SUCCESS** , or a negative value in case of an error.
    


* * *
# function::set_long_arg

## NAME



           function::set_long_arg - Set argument as signed long
    


## SYNOPSIS



               set_long_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to set
    
           _v_
               value to set
    


## DESCRIPTION



           Set the value of argument n as a signed long. On architectures
           where a long is 32 bits, the value is sign-extended to 64 bits.
    


* * *
# gnutls_priority_get_cipher_suite_index

## NAME



           gnutls_priority_get_cipher_suite_index - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_get_cipher_suite_index(gnutls_priority_t**
           _pcache_**, unsigned int** _idx_**, unsigned int ***_sidx_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           unsigned int idx
                       is an index number.
    
           unsigned int * sidx
                       internal index of cipher suite to get information
                       about.
    


## DESCRIPTION



           Provides the internal ciphersuite index to be used with
           **gnutls_cipher_suite_info()**. The index  _idx_ provided is an index
           kept at the priorities structure. It might be that a valid
           priorities index does not correspond to a ciphersuite and in that
           case **GNUTLS_E_UNKNOWN_CIPHER_SUITE** will be returned.  Once the
           last available index is crossed then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## RETURNS



           On success it returns **GNUTLS_E_SUCCESS**(0), or a negative error
           value otherwise.
    


## SINCE



           3.0.9
    


* * *
# libpfm_amd64_fam1ah_zen5_l3

## NAME



           libpfm_amd64_fam1ah_zen5_l3 - support for AMD64 Family 1Ah L3 PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam1ah_zen5_l3**
           **PMU desc: AMD64 Fam1Ah Zen5 L3**
    


## DESCRIPTION



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


* * *
# feclearexcept

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



           feclearexcept — clear floating-point exception
    


## SYNOPSIS



           #include <fenv.h>
    
           int feclearexcept(int _excepts_);
    


## 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 _feclearexcept_() function shall attempt to clear the supported
           floating-point exceptions represented by _excepts_.
    


## RETURN VALUE



           If the argument is zero or if all the specified exceptions were
           successfully cleared, _feclearexcept_() shall return zero.
           Otherwise, it shall return a non-zero value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_poll_multishot

## NAME



           io_uring_prep_poll_add - prepare a poll request
    


## SYNOPSIS



           **#include <poll.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_poll_add(struct io_uring_sqe ***_sqe_**,**
                                       **int** _fd_**,**
                                       **unsigned** _poll_mask_**);**
    
           **void io_uring_prep_poll_multishot(struct io_uring_sqe ***_sqe_**,**
                                             **int** _fd_**,**
                                             **unsigned** _poll_mask_**);**
    


## DESCRIPTION



           The io_uring_prep_poll_add(3) function prepares a poll request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _fd_ that should get polled, with the events desired specified in
           the _poll_mask_ argument.
    
           The default behavior is a single-shot poll request. When the
           specified event has triggered, a completion CQE is posted and no
           more events will be generated by the poll request.
           io_uring_prep_poll_multishot(3) behaves identically in terms of
           events, but it persists across notifications and will repeatedly
           post notifications for the same registration. A CQE posted from a
           multishot poll request will have **IORING_CQE_F_MORE** set in the CQE
           _flags_ member, indicating that the application should expect more
           completions from this request. If the multishot poll request gets
           terminated or experiences an error, this flag will not be set in
           the CQE. If this happens, the application should not expect
           further CQEs from the original request and must reissue a new one
           if it still wishes to get notifications on this file descriptor.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation, which
           is a bitmask of the events notified. See the poll(2) man page for
           details. 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.
    


* * *
# gnutls_system_key_iter_deinit

## NAME



           gnutls_system_key_iter_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/system-keys.h>**
    
           **void gnutls_system_key_iter_deinit(gnutls_system_key_iter_t** _iter_**);**
    


## ARGUMENTS



           gnutls_system_key_iter_t iter
                       an iterator of system keys
    


## DESCRIPTION



           This function will deinitialize the iterator.
    


## SINCE



           3.4.0
    


* * *
# gnutls_fips140_push_context

## NAME



           gnutls_fips140_push_context - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_fips140_push_context(gnutls_fips140_context_t** _context_**);**
    


## ARGUMENTS



           gnutls_fips140_context_t context
                       a **gnutls_fips140_context_t**
    


## DESCRIPTION



           Associate the FIPS  _context_ to the current thread, diverting the
           currently active context. If a cryptographic operation is ongoing
           in the current thread, e.g., **gnutls_aead_cipher_init()** is called
           but **gnutls_aead_cipher_deinit()** is not yet called, it returns an
           error **GNUTLS_E_INVALID_REQUEST**.
    
           The operation state of  _context_ will be reset to
           **GNUTLS_FIPS140_OP_INITIAL**.
    
           This function is no-op if FIPS140 is not compiled in nor enabled
           at run-time.
    


## RETURNS



           0 upon success, a negative error code otherwise
    


## SINCE



           3.7.3
    


* * *
# getppid

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



           getppid — get the parent process ID
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t getppid(void);
    


## DESCRIPTION



           The _getppid_() function shall return the parent process ID of the
           calling process.
    


## RETURN VALUE



           The _getppid_() function shall always be successful and no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pcert_export_openpgp

## NAME



           gnutls_pcert_export_openpgp - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure.
    
           gnutls_openpgp_crt_t * crt
                       An initialized **gnutls_openpgp_crt_t**.
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.4.0
    


* * *
# function::qs_wait

## NAME



           function::qs_wait - Function to record enqueue requests
    


## SYNOPSIS



               qs_wait(qname:string)
    


## ARGUMENTS



           _qname_
               the name of the queue requesting enqueue
    


## DESCRIPTION



           This function records that a new request was enqueued for the
           given queue name.
    


* * *
# keyctl_describe

## NAME



           keyctl_describe - describe a key
    


## SYNOPSIS



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


## DESCRIPTION



           **keyctl_describe**() describes the attributes of a key as a NUL-
           terminated string.
    
           The caller must have **view** permission on a key to be able to get a
           description of it.
    
           _buffer_ and _buflen_ specify the buffer into which the key
           description will be placed.  If the buffer is too small, the full
           size of the description will be returned, and no copy will take
           place.
    
           **keyctl_describe_alloc**() is similar to **keyctl_describe**() except
           that it allocates a buffer big enough to hold the description and
           places the description in it.  If successful, A pointer to the
           buffer is placed in _*_buffer_.  The caller must free the buffer.
    
           The description will be a string of format:
    
                  **“%s;%d;%d;%08x;%s”**
    
           where the arguments are: key type name, key UID, key GID, key
           permissions mask and key description.
    
           **NOTE!** The key description will not contain any semicolons, so
           that should be separated out by working backwards from the end of
           the string.  This permits extra information to be inserted before
           it by later versions of the kernel simply by inserting more
           semicolon-terminated substrings.
    


## RETURN VALUE



           On success **keyctl_describe**() 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_describe_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.
    


* * *
# form_data

## NAME



           **data_ahead** , **data_behind** - test for off-screen data in given forms
    


## SYNOPSIS



           **#include <form.h>**
    
           **bool data_ahead(const FORM ***_form_**);**
           **bool data_behind(const FORM ***_form_**);**
    


## DESCRIPTION



           The function **data_ahead** tests whether there is off-screen data
           ahead in the given form.  It returns TRUE (1) or FALSE (0).
    
           The function **data_behind** tests whether there is off-screen data
           behind in the given form.  It returns TRUE (1) or FALSE (0).
    


## NOTES



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


## PORTABILITY



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


* * *
# getsockname

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



           getsockname — get the socket name
    


## SYNOPSIS



           #include <sys/socket.h>
    
           int getsockname(int _socket_ , struct sockaddr *restrict _address_ ,
               socklen_t *restrict _address_len_);
    


## DESCRIPTION



           The _getsockname_() function shall retrieve the locally-bound name
           of the specified socket, store this address in the **sockaddr**
           structure pointed to by the _address_ argument, and store the length
           of this address in the object pointed to by the _address_len_
           argument.
    
           The _address_len_ argument points to a **socklen_t** object which on
           input specifies the length of the supplied **sockaddr** structure, and
           on output specifies the length of the stored address.  If the
           actual length of the address is greater than the length of the
           supplied **sockaddr** structure, the stored address shall be
           truncated.
    
           If the socket has not been bound to a local name, the value stored
           in the object pointed to by _address_ is unspecified.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned, the _address_
           argument shall point to the address of the socket, and the
           _address_len_ argument shall point to the length of the address.
           Otherwise, -1 shall be returned and _errno_ set to indicate the
           error.
    


## ERRORS



           The _getsockname_() function shall fail if:
    
           **EBADF** The _socket_ argument is not a valid file descriptor.
    
           **ENOTSOCK**
                  The _socket_ argument does not refer to a socket.
    
           **EOPNOTSUPP**
                  The operation is not supported for this socket's protocol.
    
           The _getsockname_() function may fail if:
    
           **EINVAL** The socket has been shut down.
    
           **ENOBUFS**
                  Insufficient resources were available in the system to
                  complete the function.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ntohl

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



           ntohl, ntohs — convert values between host and network byte order
    


## SYNOPSIS



           #include <arpa/inet.h>
    
           uint32_t ntohl(uint32_t _netlong_);
           uint16_t ntohs(uint16_t _netshort_);
    


## DESCRIPTION



           Refer to htonl(3p).
    


* * *
# umad_recv

## NAME



           umad_recv - receive umad
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_recv(int** _portid_**, void** _*umad_**, int** _*length_**, int** _timeout_ms_**);**
    


## DESCRIPTION



           **umad_recv()** waits up to _timeout_ms_ milliseconds for an incoming
           MAD message to be received from the port specified by _portid_.
    
           A MAD "message" consists of a single MAD packet _or_ a coalesced
           multipacket RMPP transmission.  In the RMPP case the header of the
           first RMPP packet is returned as the header of the buffer and the
           buffer data contains the coalesced data section of each subsequent
           RMPP MAD packet within the transmission.  Thus all the RMPP
           headers except the first are not copied to user space from the
           kernel.
    
           The message is copied to the _umad_ buffer if there is sufficient
           room and the received _length_ is indicated.  If the buffer is not
           large enough, the size of the umad buffer needed is returned in
           _length_.  A negative _timeout_ms_ makes the function block until a
           packet is received. A _timeout_ms_ parameter of zero indicates a non
           blocking read.
    
           **Note** _length_ is a pointer to the length of the **data** portion of the
           umad buffer.  This means that _umad_ must point to a buffer at least
           umad_size() + _*length_ bytes long.
    
           **Note also** that _*length_ must be >= 256 bytes.  This length allows
           for at least a single MAD packet to be returned.
    


## RETURN VALUE



           **umad_recv()** on success return the agentid; on error, errno is set
           and a negative value is returned as follows:
            -EINVAL      invalid port handle or agentid or *length is less
           than the minimum supported
            -EIO         receive operation failed
            -EWOULDBLOCK non blocking read can't be fulfilled
            -ENOSPC      The provided buffer is not long enough for the
           complete message.
    


* * *
# gnutls_ext_set_data

## NAME



           gnutls_ext_set_data - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_ext_set_data(gnutls_session_t** _session_**, unsigned**
           _tls_id_**, gnutls_ext_priv_data_t** _data_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       a **gnutls_session_t** opaque pointer
    
           unsigned tls_id
                       the numeric id of the extension
    
           gnutls_ext_priv_data_t data
                       the private data to set
    


## DESCRIPTION



           This function allows an extension handler to store data in the
           current session and retrieve them later on. The set data will be
           deallocated using the gnutls_ext_deinit_data_func.
    


## SINCE



           3.4.0
    


* * *
# ibv_create_counters

## NAME



           **ibv_create_counters** , **ibv_destroy_counters** - Create or destroy a
           counters handle
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_counters *
                  ibv_create_counters(struct ibv_context *context,
                                      struct ibv_counters_init_attr *init_attr);
    
                  int ibv_destroy_counters(struct ibv_counters *counters);
    


## DESCRIPTION



           **ibv_create_counters**() creates a new counters handle for the RDMA
           device context.
    
           An ibv_counters handle can be attached to a verbs resource (e.g.:
           QP, WQ, Flow) statically when these are created.
    
           For example attach an ibv_counters statically to a Flow (struct
           ibv_flow) during creation of a new Flow by calling
           **ibv_create_flow()**.
    
           Counters are cleared upon creation and values will be
           monotonically increasing.
    
           **ibv_destroy_counters**() releases the counters handle, user should
           detach the counters object before destroying it.
    


## ARGUMENTS



           _context_
                  RDMA device context to create the counters on.
    
           _init_attr_
                  Is an ibv_counters_init_attr struct, as defined in verbs.h.
    
       _**init_attr** _Argument
                  struct ibv_counters_init_attr {
                      int comp_mask;
                  };
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid.
    


## RETURN VALUE



           **ibv_create_counters**() returns a pointer to the allocated
           ibv_counters object, or NULL if the request fails (and sets errno
           to indicate the failure reason)
    
           **ibv_destroy_counters**() returns 0 on success, or the value of errno
           on failure (which indicates the failure reason)
    


## ERRORS



           EOPNOTSUPP
                  **ibv_create_counters**() is not currently supported on this
                  device (ENOSYS may sometimes be returned by old versions of
                  libibverbs).
    
           ENOMEM **ibv_create_counters**() could not create ibv_counters object,
                  not enough memory
    
           EINVAL invalid parameter supplied **ibv_destroy_counters**()
    


## EXAMPLE



           An example of use of ibv_counters is shown in **ibv_read_counters**
    


* * *