tripathysagar/man_text huggingface dataset:
# efadv_query_qp_wqs

## NAME



           efadv_query_qp_wqs - Query EFA specific Queue Pair work queue
           attributes
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  int efadv_query_qp_wqs(struct ibv_qp *ibvqp, struct efadv_wq_attr *sq_attr,
                                         struct efadv_wq_attr *rq_attr, uint32_t inlen);
    


## DESCRIPTION



           **efadv_query_qp_wqs()** queries device-specific Queue Pair work queue
           attributes.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_wq_attr {
                      uint64_t comp_mask;
                      uint8_t *buffer;
                      uint32_t entry_size;
                      uint32_t num_entries;
                      uint32_t *doorbell;
                      uint32_t max_batch;
                      uint8_t reserved[4];
                  };
    
           _inlen_  In: Size of struct efadv_wq_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _buffer_ Queue buffer.
    
           _entry_size_
                  Size of each entry in the queue.
    
           _num_entries_
                  Maximal number of entries in the queue.
    
           _doorbell_
                  Queue doorbell.
    
           _max_batch_
                  Maximum batch size for queue submissions.
    


## RETURN VALUE



           **efadv_query_qp_wqs()** returns 0 on success, or the value of errno
           on failure (which indicates the failure reason).
    


## NOTES



           • Compatibility mask (comp_mask) is an out field and currently has
             no values.
    


* * *
# pmnomem

## NAME



           **pmNoMem** - report out of memory conditions
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmNoMem(const char ***_where_**, size_t** _size_**, int** _fatal_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmNoMem** is a convenience method that may be used when malloc(3) or
           a related memory allocation service fails.
    
           A standard message is emitted using pmNotifyErr(3) with _where_ used
           as  a  message  prefix and the failing allocation _size_ is also re‐
           ported.
    
           If _fatal_ is zero (and **PM_RECOV_ERR** is zero), **pmNoMem** returns  (the
           allocation  failure  is  assumed to be recoverable by the caller),
           else (and **PM_FATAL_ERR** is a  good  value  to  use  in  this  case)
           exit(2) is called with an argument of 1.
    


* * *
# stat

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



           stat — get file status
    


## SYNOPSIS



           #include <sys/stat.h>
    
           int stat(const char *restrict _path_ , struct stat *restrict _buf_);
    


## DESCRIPTION



           Refer to fstatat(3p).
    


* * *
# gnutls_ext_get_name

## NAME



           gnutls_ext_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_ext_get_name(unsigned int** _ext_**);**
    


## ARGUMENTS



           unsigned int ext
                       is a TLS extension numeric ID
    


## DESCRIPTION



           Convert a TLS extension numeric ID to a printable string.
    


## RETURNS



           a pointer to a string that contains the name of the specified
           cipher, or **NULL**.
    


* * *
# function::symname

## NAME



           function::symname - Return the kernel symbol associated with the
           given address
    


## SYNOPSIS



               symname:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate
    


## DESCRIPTION



           Returns the (function) symbol name associated with the given
           address if known. If not known it will return the hex string
           representation of addr.
    


* * *
# gnutls_subject_alt_names_set

## NAME



           gnutls_subject_alt_names_set - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_subject_alt_names_set(gnutls_subject_alt_names_t** _sans_**,**
           **unsigned int** _san_type_**, const gnutls_datum_t ***_san_**, const char ***
           _othername_oid_**);**
    


## ARGUMENTS



           gnutls_subject_alt_names_t sans
                       The alternative names
    
           unsigned int san_type
                       The type of the name (of **gnutls_subject_alt_names_t**)
    
           const gnutls_datum_t * san
                       The alternative name data
    
           const char * othername_oid
                       The object identifier if  _san_type_ is
                       **GNUTLS_SAN_OTHERNAME**
    


## DESCRIPTION



           This function will store the specified alternative name in the
           _sans_ .
    
           Since version 3.5.7 the **GNUTLS_SAN_RFC822NAME** , **GNUTLS_SAN_DNSNAME** ,
           and **GNUTLS_SAN_OTHERNAME_XMPP** are converted to ACE format when
           necessary.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_ocsp_resp_get_responder_raw_id

## NAME



           gnutls_ocsp_resp_get_responder_raw_id - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_responder_raw_id(gnutls_ocsp_resp_const_t**
           _resp_**, unsigned** _type_**, gnutls_datum_t ***_raw_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           unsigned type
                       should be **GNUTLS_OCSP_RESP_ID_KEY** or
                       **GNUTLS_OCSP_RESP_ID_DN**
    
           gnutls_datum_t * raw
                       newly allocated buffer with the raw ID
    


## DESCRIPTION



           This function will extract the raw key (or DN) ID of the Basic
           OCSP Response in the provided buffer. If the responder ID is not a
           key ID then this function will return
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _dn_ ->data.
    


## RETURNS



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


* * *
# gnutls_ocsp_req_export

## NAME



           gnutls_ocsp_req_export - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_export(gnutls_ocsp_req_const_t** _req_**,**
           **gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_const_t req
                       Holds the OCSP request
    
           gnutls_datum_t * data
                       newly allocate buffer holding DER encoded OCSP request
    


## DESCRIPTION



           This function will export the OCSP request to DER format.
    


## RETURNS



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


* * *
# gnutls_privkey_import_ext3

## NAME



           gnutls_privkey_import_ext3 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_ext3(gnutls_privkey_t** _pkey_**, void ***
           _userdata_**, gnutls_privkey_sign_func** _sign_fn_**,**
           **gnutls_privkey_decrypt_func** _decrypt_fn_**, gnutls_privkey_deinit_func**
           _deinit_fn_**, gnutls_privkey_info_func** _info_fn_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           void * userdata
                       private data to be provided to the callbacks
    
           gnutls_privkey_sign_func sign_fn
                       callback for signature operations
    
           gnutls_privkey_decrypt_func decrypt_fn
                       callback for decryption operations
    
           gnutls_privkey_deinit_func deinit_fn
                       a deinitialization function
    
           gnutls_privkey_info_func info_fn
                       returns info about the public key algorithm (should
                       not be **NULL**)
    
           unsigned int flags
                       Flags for the import
    


## DESCRIPTION



           This function will associate the given callbacks with the
           **gnutls_privkey_t** type. At least one of the two callbacks must be
           non-null. If a deinitialization function is provided then flags is
           assumed to contain **GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE**.
    
           Note that the signing function is supposed to "raw" sign data,
           i.e., without any hashing or preprocessing. In case of RSA the
           DigestInfo will be provided, and the signing function is expected
           to do the PKCS **1** 1.5 padding and the exponentiation.
    
           The  _info_fn_ must provide information on the algorithms supported
           by this private key, and should support the flags
           **GNUTLS_PRIVKEY_INFO_PK_ALGO** and **GNUTLS_PRIVKEY_INFO_SIGN_ALGO**. It
           must return -1 on unknown flags.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_ecc_curve_get_name

## NAME



           gnutls_ecc_curve_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_ecc_curve_get_name(gnutls_ecc_curve_t** _curve_**);**
    


## ARGUMENTS



           gnutls_ecc_curve_t curve
                       is an ECC curve
    


## DESCRIPTION



           Convert a **gnutls_ecc_curve_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified curve or **NULL**.
    


## SINCE



           3.0
    


* * *
# gnutls_x509_crt_export

## NAME



           gnutls_x509_crt_export - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_export(gnutls_x509_crt_t** _cert_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## 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.
    
           void * output_data
                       will contain a certificate PEM or DER encoded
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will export the certificate to DER or PEM format.
    
           If the buffer provided is not long enough to hold the output, then
           *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will
           be returned.
    
           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.
    


* * *
# keyctl_set_timeout

## NAME



           keyctl_set_timeout - set the expiration timer on a key
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_set_timeout(key_serial_t** _key_**, unsigned** _timeout_**);**
    


## DESCRIPTION



           **keyctl_set_timeout**() sets the expiration timer on a key to _timeout_
           seconds into the future.  Setting _timeout_ to **zero** cancels the
           expiration, assuming the key hasn't already expired.
    
           When the key expires, further attempts to access it will be met
           with error **EKEYEXPIRED**.
    
           The caller must have **setattr** permission on a key to be able to
           change its permissions mask.
    


## RETURN VALUE



           On success **keyctl_set_timeout**() returns **0 .** On error, the value
           **-1** will be returned and _errno_ will have been set to an appropriate
           error.
    


## ERRORS



           **ENOKEY** The specified key does not exist.
    
           **EKEYEXPIRED**
                  The specified key has already expired.
    
           **EKEYREVOKED**
                  The specified key has been revoked.
    
           **EACCES** The named key exists, but does not grant **setattr** permission
                  to 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_x509_name_constraints_get_permitted

## NAME



           gnutls_x509_name_constraints_get_permitted - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_name_constraints_get_permitted(gnutls_x509_name_constraints_t**
           _nc_**, unsigned** _idx_**, unsigned ***_type_**, gnutls_datum_t ***_name_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t nc
                       the extracted name constraints
    
           unsigned idx
                       the index of the constraint
    
           unsigned * type
                       the type of the constraint (of type
                       gnutls_x509_subject_alt_name_t)
    
           gnutls_datum_t * name
                       the name in the constraint (of the specific type)
    


## DESCRIPTION



           This function will return an intermediate type containing the name
           constraints of the provided CA certificate. That structure can be
           used in combination with **gnutls_x509_name_constraints_check()** to
           verify whether a server's name is in accordance with the
           constraints.
    
           The name should be treated as constant and valid for the lifetime
           of  _nc_ .
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# pthread_detach

## NAME



           pthread_detach - detach a thread
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **int pthread_detach(pthread_t** _thread_**);**
    


## DESCRIPTION



           The **pthread_detach**() function marks the thread identified by
           _thread_ as detached.  When a detached thread terminates, its
           resources are automatically released back to the system without
           the need for another thread to join with the terminated thread.
    
           Attempting to detach an already detached thread results in
           unspecified behavior.
    


## RETURN VALUE



           On success, **pthread_detach**() returns 0; on error, it returns an
           error number.
    


## ERRORS



           **EINVAL** _thread_ is not a joinable thread.
    
           **ESRCH** No thread with the ID _thread_ could be found.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           Once a thread has been detached, it can't be joined with
           pthread_join(3) or be made joinable again.
    
           A new thread can be created in a detached state using
           pthread_attr_setdetachstate(3) to set the detached attribute of
           the _attr_ argument of pthread_create(3).
    
           The detached attribute merely determines the behavior of the
           system when the thread terminates; it does not prevent the thread
           from being terminated if the process terminates using exit(3) (or
           equivalently, if the main thread returns).
    
           Either pthread_join(3) or **pthread_detach**() should be called for
           each thread that an application creates, so that system resources
           for the thread can be released.  (But note that the resources of
           any threads for which one of these actions has not been done will
           be freed when the process terminates.)
    


## EXAMPLES



           The following statement detaches the calling thread:
    
               pthread_detach(pthread_self());
    


* * *
# gnutls_privkey_export_ecc_raw2

## NAME



           gnutls_privkey_export_ecc_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_ecc_raw2(gnutls_privkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_datum_t ***_x_**, gnutls_datum_t ***
           _y_**, gnutls_datum_t ***_k_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    
           gnutls_datum_t * k
                       will hold the private key
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the ECC private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be in the native format for the curve.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# selinux_lsetfilecon_default

## NAME



           selinux_lsetfilecon_default - set the file context to the system
           defaults
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int selinux_lsetfilecon_default(const char ***_path_**);**
    


## DESCRIPTION



           **selinux_lsetfilecon_default**() sets the file context to the system
           defaults.
    


## RETURN VALUE



           Returns zero on success or -1 otherwise.
    


* * *
# gnutls_x509_privkey_cpy

## NAME



           gnutls_x509_privkey_cpy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_cpy(gnutls_x509_privkey_t** _dst_**,**
           **gnutls_x509_privkey_t** _src_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t dst
                       The destination key, which should be initialized.
    
           gnutls_x509_privkey_t src
                       The source key
    


## DESCRIPTION



           This function will copy a private key from source to destination
           key. Destination has to be initialized.
    


## RETURNS



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


* * *
# libpfm_intel_coreduo

## NAME



           libpfm_intel_coreduo - support for Intel Core Duo/Solo processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: coreduo**
           **PMU desc: Intel Core Duo**
    


## DESCRIPTION



           The library supports all Intel Yonah-based processors such as
           Intel Core Duo and Intel Core Solo processors.
    


## MODIFIERS



           The following modifiers are supported on Intel Core Duo
           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].
    


## ENVIRONMENT VARIABLES



           It is possible to force activation of the Intel Core Duo support
           using the **LIBPFM_FORCE_PMU** variable.  The PMU name, coreduo, must
           be passed. No additional options are supported.
    


* * *
# lsearch

## NAME



           lfind, lsearch - linear search of an array
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <search.h>**
    
           **void *lfind(** size_t *n, size_t size;
                       **const void** _key_**[**_size_**], const void** _base_**[***_n_ *****_size_**],**
                       **size_t ***_n_**, size_t** _size_**,**
                       **typeof(int (const void [**_size_**], const void [**_size_**]))**
                           *****_compar_**);**
           **void *lsearch(** size_t *n, size_t size;
                       **const void** _key_**[**_size_**], void** _base_**[***_n_ *****_size_**],**
                       **size_t ***_n_**, size_t** _size_**,**
                       **typeof(int (const void [**_size_**], const void [**_size_**]))**
                           *****_compar_**);**
    


## DESCRIPTION



           **lfind**() and **lsearch**() perform a linear search for _key_ in the array
           _base_ which has _*n_ elements of _size_ bytes each.  The comparison
           function referenced by _compar_ is expected to have two arguments
           which point to the _key_ object and to an array member, in that
           order, and which returns zero if the _key_ object matches the array
           member, and nonzero otherwise.
    
           If **lsearch**() does not find a matching element, then the _key_ object
           is inserted at the end of the table, and _*n_ is incremented.  In
           particular, one should know that a matching element exists, or
           that more room is available.
    


## RETURN VALUE



           **lfind**() returns a pointer to a matching member of the array, or
           NULL if no match is found.  **lsearch**() returns a pointer to a
           matching member of the array, or to the newly added member if no
           match is found.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## BUGS



           The naming is unfortunate.
    


* * *
# getfilecon

## NAME



           getfilecon, fgetfilecon, lgetfilecon - get SELinux security
           context of a file
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int getfilecon(const char ***_path_**, char ****_con_**);**
    
           **int getfilecon_raw(const char ***_path_**, char ****_con_**);**
    
           **int lgetfilecon(const char ***_path_**, char ****_con_**);**
    
           **int lgetfilecon_raw(const char ***_path_**, char ****_con_**);**
    
           **int fgetfilecon(int** _fd_**, char ****_con_**);**
    
           **int fgetfilecon_raw(int** _fd_**, char ****_con_**);**
    


## DESCRIPTION



           **getfilecon**() retrieves the context associated with the given path
           in the file system, the length of the context is returned.
    
           **lgetfilecon**() is identical to **getfilecon**(), except in the case of
           a symbolic link, where the link itself is interrogated, not the
           file that it refers to.
    
           **fgetfilecon**() is identical to **getfilecon**(), only the open file
           pointed to by filedes (as returned by open(2)) is interrogated in
           place of path.  Since libselinux 3.4 a file opened via _O_PATH_ is
           supported.
    
           **getfilecon_raw**(), **lgetfilecon_raw**() and **fgetfilecon_raw**() behave
           identically to their non-raw counterparts but do not perform
           context translation.
    
           The returned context should be freed with freecon(3) if non-NULL.
    


## RETURN VALUE



           On success, a positive number is returned indicating the size of
           the extended attribute value. On failure, -1 is returned and _errno_
           is  set appropriately.
    
           If the context does not exist, or the process has no access to
           this attribute, _errno_ is set to **ENODATA**.
    
           If extended attributes are not supported by the filesystem, or are
           disabled, _errno_ is set to **ENOTSUP**.
    
           The errors documented for the stat(2) system call are also
           applicable here.
    


* * *
# gnutls_cipher_suite_info

## NAME



           gnutls_cipher_suite_info - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_cipher_suite_info(size_t** _idx_**, unsigned char ***
           _cs_id_**, gnutls_kx_algorithm_t ***_kx_**, gnutls_cipher_algorithm_t ***
           _cipher_**, gnutls_mac_algorithm_t ***_mac_**, gnutls_protocol_t ***
           _min_version_**);**
    


## ARGUMENTS



           size_t idx  index of cipher suite to get information about, starts
                       on 0.
    
           unsigned char * cs_id
                       output buffer with room for 2 bytes, indicating cipher
                       suite value
    
           gnutls_kx_algorithm_t * kx
                       output variable indicating key exchange algorithm, or
                       **NULL**.
    
           gnutls_cipher_algorithm_t * cipher
                       output variable indicating cipher, or **NULL**.
    
           gnutls_mac_algorithm_t * mac
                       output variable indicating MAC algorithm, or **NULL**.
    
           gnutls_protocol_t * min_version
                       output variable indicating TLS protocol version, or
                       **NULL**.
    


## DESCRIPTION



           Get information about supported cipher suites.  Use the function
           iteratively to get information about all supported cipher suites.
           Call with idx=0 to get information about first cipher suite, then
           idx=1 and so on until the function returns NULL.
    


## RETURNS



           the name of  _idx_ cipher suite, and set the information about the
           cipher suite in the output variables.  If  _idx_ is out of bounds,
           **NULL** is returned.
    


* * *
# gnutls_pcert_import_rawpk_raw

## NAME



           gnutls_pcert_import_rawpk_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_rawpk_raw(gnutls_pcert_st ***_pcert_**, const**
           **gnutls_datum_t ***_rawpubkey_**, gnutls_x509_crt_fmt_t** _format_**, unsigned**
           **int** _key_usage_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure to import the data into.
    
           const gnutls_datum_t * rawpubkey
                       The raw public-key in **gnutls_datum_t** format to be
                       imported.
    
           gnutls_x509_crt_fmt_t format
                       The format of the raw public-key. DER or PEM.
    
           unsigned int key_usage
                       An ORed sequence of **GNUTLS_KEY_** * flags.
    
           unsigned int flags
                       zero for now
    


## DESCRIPTION



           This convenience function will import (i.e. convert) the given raw
           public key  _rawpubkey_ into a **gnutls_pcert_st** structure. The
           structure must be deinitialized afterwards using
           **gnutls_pcert_deinit()**.  Note that the caller is responsible for
           freeing  _rawpubkey_ . All necessary values will be copied into
           _pcert_ .
    
           Key usage (as defined by X.509 extension (2.5.29.15)) can be
           explicitly set because there is no certificate structure around
           the key to define this value. See for more info
           **gnutls_x509_crt_get_key_usage()**.
    


## RETURNS



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


## SINCE



           3.6.6
    


* * *
# off_t

## NAME



           off_t, off64_t, loff_t - file sizes
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
    
           **typedef** /* ... */  **off_t;**
    
           **#define _LARGEFILE64_SOURCE**
           **#include <sys/types.h>**
    
           **typedef** /* ... */  **off64_t;**
    
           **#define _GNU_SOURCE**
           **#include <sys/types.h>**
    
           **typedef** /* ... */  **loff_t;**
    


## DESCRIPTION



           _off_t_ is used for describing file sizes.  It is a signed integer
           type.
    
           _off64_t_ is a 64-bit version of the type, used in glibc.
    
           _loff_t_ is a 64-bit version of the type, introduced by the Linux
           kernel.
    


## STANDARDS



           _off_t_  POSIX.1-2008.
    
           _off64_t_
                  GNU and some BSDs.
    
           _loff_t_ Linux.
    


## VERSIONS



           _off_t_  POSIX.1-2001.
    
           _< aio.h>_ and _< stdio.h>_ define _off_t_ since POSIX.1-2008.
    


## NOTES



           On some architectures, the width of _off_t_ can be controlled with
           the feature test macro **_FILE_OFFSET_BITS**.
    
           The following headers also provide _off_t_ : _< aio.h>_, _< fcntl.h>_,
           _< stdio.h>_, _< sys/mman.h>_, _< sys/stat.h>_, and _< unistd.h>_.
    


* * *
# gnutls_x509_crl_sign

## NAME



           gnutls_x509_crl_sign - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_sign(gnutls_x509_crl_t** _crl_**, gnutls_x509_crt_t**
           _issuer_**, gnutls_x509_privkey_t** _issuer_key_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           gnutls_x509_crt_t issuer
                       is the certificate of the certificate issuer
    
           gnutls_x509_privkey_t issuer_key
                       holds the issuer's private key
    


## DESCRIPTION



           This function is the same a **gnutls_x509_crl_sign2()** with no flags,
           and an appropriate hash algorithm. The hash algorithm used may
           vary between versions of GnuTLS, and it is tied to the security
           level of the issuer's public key.
    


## RETURNS



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


* * *
# pcre2_jit_free_unused_memory

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



    
           This function frees unused JIT executable memory. The argument is
           a general context, for custom memory management, or NULL for
           standard memory management.  JIT memory allocation retains some
           memory in order to improve future JIT compilation speed. In low
           memory conditions, **pcre2_jit_free_unused_memory()** can be used to
           cause this memory to be 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.
    


* * *
# gnutls_strerror_name

## NAME



           gnutls_strerror_name - API function
    


## SYNOPSIS



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


## ARGUMENTS



           int error   is an error returned by a gnutls function.
    


## DESCRIPTION



           Return the GnuTLS error code define as a string.  For example,
           gnutls_strerror_name (GNUTLS_E_DH_PRIME_UNACCEPTABLE) will return
           the string "GNUTLS_E_DH_PRIME_UNACCEPTABLE".
    


## RETURNS



           A string corresponding to the symbol name of the error code.
    


## SINCE



           2.6.0
    


* * *
# probe::netfilter.bridge.local_in

## NAME



           probe::netfilter.bridge.local_in - Called on a bridging packet
           destined for the local computer
    


## SYNOPSIS



           netfilter.bridge.local_in
    


## VALUES



           _br_prid_
               Protocol identifier
    
           _llcpdu_
               Address of LLC Protocol Data Unit
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _llcproto_stp_
               Constant used to signify Bridge Spanning Tree Protocol packet
    
           _br_cost_
               Total cost from transmitting bridge to root
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _br_msg_
               Message age in 1/256 secs
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _pf_
               Protocol family -- always “bridge”
    
           _br_type_
               BPDU type
    
           _br_poid_
               Port identifier
    
           _br_flags_
               BPDU flags
    
           _br_bid_
               Identity of bridge
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _brhdr_
               Address of bridge header
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _br_mac_
               Bridge MAC address
    
           _br_fd_
               Forward delay in 1/256 secs
    
           _br_rmac_
               Root bridge MAC address
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _br_rid_
               Identity of root bridge
    
           _protocol_
               Packet protocol
    
           _br_max_
               Max age in 1/256 secs
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _br_vid_
               Protocol version identifier
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _br_htime_
               Hello time in 1/256 secs
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    


* * *
# gnutls_aead_cipher_decrypt

## NAME



           gnutls_aead_cipher_decrypt - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_aead_cipher_decrypt(gnutls_aead_cipher_hd_t** _handle_**,**
           **const void ***_nonce_**, size_t** _nonce_len_**, const void ***_auth_**, size_t**
           _auth_len_**, size_t** _tag_size_**, const void ***_ctext_**, size_t** _ctext_len_**,**
           **void ***_ptext_**, size_t ***_ptext_len_**);**
    


## ARGUMENTS



           gnutls_aead_cipher_hd_t handle
                       is a **gnutls_aead_cipher_hd_t** type.
    
           const void * nonce
                       the nonce to set
    
           size_t nonce_len
                       The length of the nonce
    
           const void * auth
                       additional data to be authenticated
    
           size_t auth_len
                       The length of the data
    
           size_t tag_size
                       The size of the tag to use (use zero for the default)
    
           const void * ctext
                       the data to decrypt (including the authentication tag)
    
           size_t ctext_len
                       the length of data to decrypt (includes tag size)
    
           void * ptext
                       the decrypted data
    
           size_t * ptext_len
                       the length of decrypted data (initially must hold the
                       maximum available size)
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           specified by the context. This function must be provided the
           complete data to be decrypted, including the authentication tag.
           On several AEAD ciphers, the authentication tag is appended to the
           ciphertext, though this is not a general rule. This function will
           fail if the tag verification fails.
    


## RETURNS



           Zero or a negative error code on verification failure or other
           error.
    


## SINCE



           3.4.0
    


* * *
# io_uring_register_eventfd_async

## NAME



           io_uring_register_eventfd - register an eventfd with a ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_eventfd(struct io_uring ***_ring_**,**
                                         **int** _fd_**);**
    
           **int io_uring_register_eventfd_async(struct io_uring ***_ring_**,**
                                               **int** _fd_**);**
    
           **int io_uring_unregister_eventfd(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_register_eventfd(3) registers the eventfd file descriptor
           _fd_ with the ring identified by _ring_.
    
           Whenever completions are posted to the CQ ring, an eventfd
           notification is generated with the registered eventfd descriptor.
           If io_uring_register_eventfd_async(3) is used, only events that
           completed out-of-line will trigger a notification.
    
           It notifications are no longer desired,
           io_uring_unregister_eventfd(3) may be called to remove the eventfd
           registration. No eventfd argument is needed, as a ring can only
           have a single eventfd registered.
    


## NOTES



           While io_uring generally takes care to avoid spurious events, they
           can occur.  Similarly, batched completions of CQEs may only
           trigger a single eventfd notification even if multiple CQEs are
           posted. The application should make no assumptions on number of
           events being available having a direct correlation to eventfd
           notifications posted. An eventfd notification must thus only be
           treated as a hint to check the CQ ring for completions.
    


## RETURN VALUE



           Returns 0 on success, or **-errno** on error.
    


* * *
# dane_state_deinit

## NAME



           dane_state_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **void dane_state_deinit(dane_state_t** _s_**);**
    


## ARGUMENTS



           dane_state_t s
                       The structure to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a DANE query structure.
    


* * *
# csin

## NAME



           csin, csinf, csinl - complex sine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex csin(double complex** _z_**);**
           **float complex csinf(float complex** _z_**);**
           **long double complex csinl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex sine of _z_.
    
           The complex sine function is defined as:
    
               csin(z) = (exp(i * z) - exp(-i * z)) / (2 * i)
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_privkey_import_url

## NAME



           gnutls_privkey_import_url - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_privkey_t key
                       A key of type **gnutls_privkey_t**
    
           const char * url
                       A PKCS 11 url
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will import a PKCS11 or TPM URL as a private key.
           The supported URL types can be checked using
           **gnutls_url_is_supported()**.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# sd_bus_enqueue_for_read

## NAME



           sd_bus_enqueue_for_read - Re-enqueue a bus message on a bus
           connection, for reading
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_enqueue_for_read(sd_bus ***_bus_**, sd_bus_message ***_message_**);**
    


## DESCRIPTION



           **sd_bus_enqueue_for_read()** may be used to re-enqueue an incoming
           bus message on the local read queue, so that it is processed and
           dispatched locally again, similarly to how an incoming message
           from the peer is processed. Takes a bus connection object and the
           message to enqueue. A reference is taken of the message and the
           caller's reference thus remains in possession of the caller. The
           message is enqueued at the end of the queue, thus will be
           dispatched after all other already queued messages are dispatched.
    
           This call is primarily useful for dealing with incoming method
           calls that may be processed only after an additional asynchronous
           operation completes. One example are PolicyKit authorization
           requests that are determined to be necessary to authorize a newly
           incoming method call: when the PolicyKit response is received the
           original method call may be re-enqueued to process it again, this
           time with the authorization result known.
    


## RETURN VALUE



           On success, this function return 0 or a positive integer. On
           failure, it returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ECHILD**
               The bus connection has been created in a different process,
               library or module instance.
    


## NOTES



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


* * *