tripathysagar/man_text huggingface dataset:
# io_uring_prep_futex_wake

## NAME



           io_uring_prep_futex_wake - prepare a futex wake request
    


## SYNOPSIS



           **#include <linux/futex.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_futex_wake(struct io_uring_sqe ***_sqe_**,**
                                         **uint32_t ***_futex_**,**
                                         **uint64_t** _val_**,**
                                         **uint64_t** _mask_**,**
                                         **uint32_t** _futex_flags_**,**
                                         **unsigned int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_futex_wake(3) function prepares a futex wake
           request. The submission queue entry _sqe_ is setup for waking any
           waiters on the futex indicated by _futex_ and at most _val_ futexes.
           _futex_flags_ indicates the **futex2**(2) modifier flags, and io_uring
           futex flags of _flags ._
    
           If a given bitset for who to wake is desired, then that must be
           set in _mask ._  Use **FUTEX_BITSET_MATCH_ANY** to match any waiter on
           the given futex.
    
           _flags_ are currently unused and hence **0** must be passed.
    
           This function prepares an async futex(2) wake request. See that
           man page for details. Note that the io_uring futex wake request is
           similar to the **FUTEX_WAKE_BITSET** operation, as **FUTEX_WAKE** is a
           strict subset of that.
    
           Available since kernel 6.7.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. On
           success, the value will be the index into _futexv_ which received a
           wakeup. See the related man page for details on possible values
           for errors. 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.
    


* * *
# pmiend

## NAME



           **pmiEnd** - finish up a LOGIMPORT archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiEnd(void);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiEnd();**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiEnd** closes  the  current  context,  forcing  the
           trailer  records  to be written to the PCP archive files, and then
           these files are closed.
    
           In normal operations, an  application  would  include  a  call  to
           **pmiEnd** at  the  end of processing for each context created with a
           call to pmiStart(3).
    


## DIAGNOSTICS



           **pmiEnd** returns zero on success else a negative value that  can  be
           turned into an error message by calling pmiErrStr(3).
    


* * *
# gnutls_pem_base64_encode2

## NAME



           gnutls_pem_base64_encode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_pem_base64_encode2(const char ***_header_**, const**
           **gnutls_datum_t ***_data_**, gnutls_datum_t ***_result_**);**
    


## ARGUMENTS



           const char * header
                       is a message to be put in the encoded header (may be
                       **NULL**)
    
           const gnutls_datum_t * data
                       contains the raw data
    
           gnutls_datum_t * result
                       will hold the newly allocated encoded data
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the base64 encoding.  This is the encoding used in PEM messages.
           This function will allocate the required memory to hold the
           encoded data.
    
           You should use **gnutls_free()** to free the returned data.
    
           Note, that prior to GnuTLS 3.4.0 this function was available under
           the name **gnutls_pem_base64_encode_alloc()**. There is compatibility
           macro pointing to this function.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# hnsdv_create_qp

## NAME



           hnsdv_create_qp - creates a HNS specific queue pair (QP)
    


## SYNOPSIS



                  #include <infiniband/hnsdv.h>
    
                  struct ibv_qp *hnsdv_create_qp(struct ibv_context *context,
                                                 struct ibv_qp_init_attr_ex *qp_attr,
                                                 struct hnsdv_qp_init_attr *hns_attr);
    


## DESCRIPTION



           **hnsdv_create_qp()** creates a HNS specific queue pair (QP) with
           specific driver properties.
    


## ARGUMENTS



           Please see _ibv_create_qp_ex(3)_ man page for _context_ and _qp_attr_.
    
       **hns_attr**
                  struct hnsdv_qp_init_attr {
                          uint64_t comp_mask;
                          uint32_t create_flags;
                          uint8_t congest_type;
                          uint8_t reserved[3];
                  };
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid:
    
                  HNSDV_QP_INIT_ATTR_MASK_QP_CONGEST_TYPE:
                      Valid values in congest_type. Allow setting a congestion control algorithm for QP.
    
           _create_flags_
                  Enable the QP of a feature.
    
           _congest_type_
                  Type of congestion control algorithm:
    
                  HNSDV_QP_CREATE_ENABLE_DCQCN: Data Center Quantized
                  Congestion Notification HNSDV_QP_CREATE_ENABLE_LDCP: Low
                  Delay Control Protocol HNSDV_QP_CREATE_ENABLE_HC3: Huawei
                  Converged Congestion Control HNSDV_QP_CREATE_ENABLE_DIP:
                  Destination IP based Quantized Congestion Notification
    


## RETURN VALUE



           **hnsdv_create_qp()** returns a pointer to the created QP, on error
           NULL will be returned and errno will be set.
    


* * *
# mlx5dv_reg_dmabuf_mr

## NAME



           mlx5dv_reg_dmabuf_mr - Register a dma-buf based memory region (MR)
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_mr *mlx5dv_reg_dmabuf_mr(struct ibv_pd *pd, uint64_t offset,
                                                      size_t length, uint64_t iova, int fd,
                                                      int access, int mlx5_access)
    


## DESCRIPTION



           Register a dma-buf based memory region (MR), it follows the
           functionality of _ibv_reg_dmabuf_mr()_ with the ability to supply
           specific mlx5 access flags.
    


## ARGUMENTS



           _pd_     The associated protection domain.
    
           _offset_ The offset of the dma-buf where the MR starts.
    
           _length_
    
                  The length of the MR.
    
           _iova_   Specifies the virtual base address of the MR when accessed
                  through a lkey or rkey.  It must have the same page offset
                  as _offset_ and be aligned with the system page size.
    
           _fd_     The file descriptor that the dma-buf is identified by.
    
           _access_ The desired memory protection attributes; it is either 0 or
                  the bitwise OR of one or more of _enum ibv_access_flags_.
    
           _mlx5_access_
                  A specific device access flags, it is either 0 or the
                  below.
    
                  _MLX5DV_REG_DMABUF_ACCESS_DATA_DIRECT_ if set, this MR will
                  be accessed through the Data Direct engine bonded with that
                  RDMA device.
    


## RETURN VALUE



           Upon success returns a pointer to the registered MR, or NULL if
           the request fails, in that case the value of errno indicates the
           failure reason.
    


* * *
# pmgetindom

## NAME



           **pmGetInDom** - get instance identifiers for a performance metrics
           instance domain
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetInDom(pmInDom** _indom_**, int ****_instlist_**, char *****_namelist_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           In  the current Performance Metrics Application Programming Inter‐
           face (PMAPI) context, locate the description of the  instance  do‐
           main  _indom_ , and return via _instlist_ the internal instance identi‐
           fiers for all instances, and via _namelist_ the full external  iden‐
           tifiers  for  all instances.  The number of instances found is re‐
           turned as the function value (else less than zero to  indicate  an
           error).
    
           The  value  for  the  instance domain _indom_ is typically extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           The  resulting  lists  of  instance  identifiers   (_instlist_   and
           _namelist_),  and  the names that the elements of _namelist_ point to,
           will  have  been  allocated  by  **pmGetInDom** with  two  calls   to
           malloc(3),  and it is the responsibility of the caller to _free(in‐_
           _stlist)_ and _free(namelist)_ to release the  space  when  it  is  no
           longer required.
    
           When  the result of **pmGetInDom** is less than one, both _instlist_ and
           _namelist_ are undefined (no space will have been allocated, and  so
           calling free(3) is a singularly bad idea).
    


## DIAGNOSTICS



           **PM_ERR_INDOM**
                  _indom_ is not a valid instance domain identifier
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to parameter‐
           ize the file and directory names used by PCP.  On each installa‐
           tion, the file _/etc/pcp.conf_ contains the local values for these
           variables.  The **$PCP_CONF** variable may be used to specify an al‐
           ternative configuration file, as described in pcp.conf(5).  Values
           for these variables may be obtained programmatically using the
           pmGetConfig(3) function.
    


* * *
# gnutls_x509_ext_ct_scts_deinit

## NAME



           gnutls_x509_ext_ct_scts_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void gnutls_x509_ext_ct_scts_deinit(gnutls_x509_ct_scts_t** _scts_**);**
    


## ARGUMENTS



           gnutls_x509_ct_scts_t scts
                       The SCT list
    


## DESCRIPTION



           This function will deinitialize a Certificate Transparency SCT
           list.
    


* * *
# gnutls_x509_privkey_fix

## NAME



           gnutls_x509_privkey_fix - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_fix(gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    


## DESCRIPTION



           This function will recalculate the secondary parameters in a key.
           In RSA keys, this can be the coefficient and exponent1,2.
    


## RETURNS



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


* * *
# strrchr

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



           strrchr — string scanning operation
    


## SYNOPSIS



           #include <string.h>
    
           char *strrchr(const char *_s_ , int _c_);
    


## 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 _strrchr_() function shall locate the last occurrence of _c_
           (converted to a **char**) in the string pointed to by _s_.  The
           terminating NUL character is considered to be part of the string.
    


## RETURN VALUE



           Upon successful completion, _strrchr_() shall return a pointer to
           the byte or a null pointer if _c_ does not occur in the string.
    


## ERRORS



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


## EXAMPLES



       **Finding the Base Name of a File**
           The following example uses _strrchr_() to get a pointer to the base
           name of a file. The _strrchr_() function searches backwards through
           the name of the file to find the last **'/'** character in _name_.  This
           pointer (plus one) will point to the base name of the file.
    
               #include <string.h>
               ...
               const char *name;
               char *basename;
               ...
               basename = strrchr(name, '/') + 1;
               ...
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_alert_send_appropriate

## NAME



           gnutls_alert_send_appropriate - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_alert_send_appropriate(gnutls_session_t** _session_**, int**
           _err_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int err     is an error code returned by another GnuTLS function
    


## DESCRIPTION



           Sends an alert to the peer depending on the error code returned by
           a gnutls function. This function will call **gnutls_error_to_alert()**
           to determine the appropriate alert to send.
    
           This function may also return **GNUTLS_E_AGAIN** , or
           **GNUTLS_E_INTERRUPTED**.
    
           This function historically was always sending an alert to the
           peer, even if  _err_ was inappropriate to respond with an alert
           (e.g., **GNUTLS_E_SUCCESS**). Since 3.6.6 this function returns
           success without transmitting any data on error codes that should
           not result to an alert.
    


## RETURNS



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


* * *
# selinux_getenforcemode

## NAME



           selinux_getenforcemode - get the enforcing state of SELinux
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int selinux_getenforcemode(int ***_enforce_**);**
    


## DESCRIPTION



           **selinux_getenforcemode**() Reads the contents of the
           _/etc/selinux/config_ file to determine how the system was setup to
           run SELinux.
    
           Sets the value of _enforce_ to 1 if SELinux should be run in
           enforcing mode.  Sets the value of _enforce_ to 0 if SELinux should
           be run in permissive mode.  Sets the value of _enforce_ to -1 if
           SELinux should be disabled.
    


## RETURN VALUE



           On success, zero is returned.  On failure, -1 is returned.
    


* * *
# dane_verify_crt_raw

## NAME



           dane_verify_crt_raw - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_verify_crt_raw(dane_state_t** _s_**, const gnutls_datum_t ***
           _chain_**, unsigned** _chain_size_**, gnutls_certificate_type_t** _chain_type_**,**
           **dane_query_t** _r_**, unsigned int** _sflags_**, unsigned int** _vflags_**, unsigned**
           **int ***_verify_**);**
    


## ARGUMENTS



           dane_state_t s
                       A DANE state structure (may be NULL)
    
           const gnutls_datum_t * chain
                       A certificate chain
    
           unsigned chain_size
                       The size of the chain
    
           gnutls_certificate_type_t chain_type
                       The type of the certificate chain
    
           dane_query_t r
                       DANE data to check against
    
           unsigned int sflags
                       Flags for the initialization of  _s_ (if NULL)
    
           unsigned int vflags
                       Verification flags; an OR'ed list of
                       **dane_verify_flags_t**.
    
           unsigned int * verify
                       An OR'ed list of **dane_verify_status_t**.
    


## DESCRIPTION



           This is the low-level function of **dane_verify_crt()**. See the high
           level function for documentation.
    
           This function does not perform any resolving, it utilizes cached
           entries from  _r_ .
    


## RETURNS



           a negative error code on error and **DANE_E_SUCCESS**(0) when the
           DANE entries were successfully parsed, irrespective of whether
           they were verified (see  _verify_ for that information). If no
           usable entries were encountered
           **DANE_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# pmlookupindomarchive

## NAME



           **pmLookupInDomArchive** - translate an instance name into an instance
           identifier
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmLookupInDomArchive(pmInDom** _indom_**, const char ***_name_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Provided  the  current Performance Metrics Application Programming
           Interface (PMAPI) context is associated with a  set  of  archives,
           **pmLookupInDomArchive** will  scan the union of all the instance do‐
           main metadata for the instance domain _indom_ , locate the first  in‐
           stance  with the external identification given by _name_ , and return
           the internal instance identifier.
    
           This routine is a specialized version of the  more  general  PMAPI
           routine **pmLookupInDom**.
    
           Only  the  leading  non-space  characters  of _name_ will be used to
           identify the instance.
    
           The value for the instance domain  _indom_  is  typically  extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           **pmLookupInDomArchive** will return a positive instance identifier on
           success.
    


## DIAGNOSTICS



           **PM_ERR_NOTARCHIVE**
                  the current PMAPI context is not associated with a set of
                  archives
    
           **PM_ERR_INDOM_LOG**
                  _indom_ is not a defined instance domain identifier for the
                  set of archives
    
           **PM_ERR_INST_LOG**
                  the external instance _name_ is not known for the instance
                  domain _indom_ in the set of archives
    


* * *
# probe::socket.aio_write.return

## NAME



           probe::socket.aio_write.return - Conclusion of message send via
           **sock_aio_write**
    


## SYNOPSIS



           socket.aio_write.return
    


## VALUES



           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    
           _size_
               Size of message received (in bytes) or error code if success =
               0
    
           _success_
               Was receive successful? (1 = yes, 0 = no)
    
           _family_
               Protocol family value
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message receiver.
    


## DESCRIPTION



           Fires at the conclusion of sending a message on a socket via the
           **sock_aio_write** function
    


* * *
# function::set_s32_arg

## NAME



           function::set_s32_arg - Set function argument as signed 32-bit
           value
    


## SYNOPSIS



               set_s32_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the signed 32-bit value of argument n, same as int_arg.
    


* * *
# gnutls_x509_crt_print

## NAME



           gnutls_x509_crt_print - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t cert
                       The data to be printed
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print a X.509 certificate, suitable for
           display to a human.
    
           If the format is **GNUTLS_CRT_PRINT_FULL** then all fields of the
           certificate will be output, on multiple lines.  The
           **GNUTLS_CRT_PRINT_ONELINE** format will generate one line with some
           selected fields, which is useful for logging purposes.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


* * *
# libpfm_intel_skx_unc_irp

## NAME



           libpfm_intel_skx_unc_irp - support for Intel Broadwell Server IRP
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_irp**
           **PMU desc: Intel Skylake X Server IRP uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X Server IRP (IIO
           coherency) uncore PMU .
    


## MODIFIERS



           The following modifiers are supported on Intel Skylake X server
           IRP uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of 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].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# ldap_tls

## NAME



           ldap_start_tls, ldap_start_tls_s, ldap_tls_inplace,
           ldap_install_tls - LDAP TLS initialization routines
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_start_tls(LDAP ***_ld_**);**
    
           **int ldap_start_tls_s(LDAP ***_ld_**, LDAPControl ****_serverctrls_**,**
           **LDAPControl ****_clientctrls_**);**
    
           **int ldap_tls_inplace(LDAP ***_ld_**);**
    
           **int ldap_install_tls(LDAP ***_ld_**);**
    


## DESCRIPTION



           These routines are used to initiate TLS processing on an LDAP
           session.  **ldap_start_tls_s**() sends a StartTLS request to a server,
           waits for the reply, and then installs TLS handlers on the session
           if the request succeeded. The routine returns **LDAP_SUCCESS** if
           everything succeeded, otherwise it returns an LDAP error code.
           **ldap_start_tls**() sends a StartTLS request to a server and does
           nothing else. It returns **LDAP_SUCCESS** if the request was sent
           successfully.  **ldap_tls_inplace**() returns 1 if TLS handlers have
           been installed on the specified session, 0 otherwise.
           **ldap_install_tls**() installs the TLS handlers on the given session.
           It returns **LDAP_LOCAL_ERROR** if TLS is already installed.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# function::user_ushort_warn

## NAME



           function::user_ushort_warn - Retrieves an unsigned short value
           stored in user space
    


## SYNOPSIS



               user_ushort_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned short from
    


## DESCRIPTION



           Returns the unsigned short value from a given user space address.
           Returns zero when user space data is not accessible and warns
           about the failure (but does not error).
    


* * *
# getsockcreatecon

## NAME



           getsockcreatecon, setsockcreatecon - get or set the SELinux
           security context used for creating a new labeled sockets
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int getsockcreatecon(char ****_con_**);**
    
           **int getsockcreatecon_raw(char ****_con_**);**
    
           **int setsockcreatecon(const char ***_context_**);**
    
           **int setsockcreatecon_raw(const char ***_context_**);**
    


## DESCRIPTION



           **getsockcreatecon**() retrieves the context used for creating a new
           labeled network socket.  This returned context should be freed
           with freecon(3) if non-NULL.  **getsockcreatecon**() sets *con to NULL
           if no sockcreate context has been explicitly set by the program
           (i.e. using the default policy behavior).
    
           **setsockcreatecon**() sets the context used for creating a new
           labeled network sockets NULL can be passed to **setsockcreatecon**()
           to reset to the default policy behavior.  The sockcreate context
           is automatically reset after the next execve(2), so a program
           doesn't need to explicitly sanitize it upon startup.
    
           **setsockcreatecon**() can be applied prior to library functions that
           internally perform an file creation, in order to set an file
           context on the objects.
    
           **getsockcreatecon_raw**() and **setsockcreatecon_raw**() behave
           identically to their non-raw counterparts but do not perform
           context translation.
    
           **Note:** Signal handlers that perform a **setsockcreatecon**() must take
           care to save, reset, and restore the sockcreate context to avoid
           unexpected behavior.
    
           **Note:** Contexts are thread specific.
    


## RETURN VALUE



           On error -1 is returned.  On success 0 is returned.
    


* * *
# rdma_destroy_ep

## NAME



           rdma_destroy_ep - Release a communication identifier.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **void rdma_destroy_ep (struct rdma_cm_id ***_id_**);**
    


## ARGUMENTS



           id          The communication identifier to destroy.
    


## DESCRIPTION



           Destroys the specified rdma_cm_id and all associated resources
    


## NOTES



           rdma_destroy_ep will automatically destroy any QP and SRQ
           associated with the rdma_cm_id.
    


* * *
# gnutls_pkcs7_export

## NAME



           gnutls_pkcs7_export - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_export(gnutls_pkcs7_t** _pkcs7_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a structure 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 pkcs7 structure 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
           PKCS7".
    


## RETURNS



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


* * *
# gnutls_key_generate

## NAME



           gnutls_key_generate - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_key_generate(gnutls_datum_t ***_key_**, unsigned int**
           _key_size_**);**
    


## ARGUMENTS



           gnutls_datum_t * key
                       is a pointer to a **gnutls_datum_t** which will contain a
                       newly created key
    
           unsigned int key_size
                       the number of bytes of the key
    


## DESCRIPTION



           Generates a random key of  _key_size_ bytes.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# ctan

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



           ctan, ctanf, ctanl — complex tangent functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex ctan(double complex _z_);
           float complex ctanf(float complex _z_);
           long double complex ctanl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex tangent of _z_.
    


## RETURN VALUE



           These functions shall return the complex tangent value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# form_field_info

## NAME



           **dynamic_field_info** , **field_info** - retrieve field characteristics
    


## SYNOPSIS



           **#include <form.h>**
    
           **int field_info(const FIELD ***_field_**,**
                          **int ***_rows_**, int ***_cols_**,**
                          **int ***_frow_**, int ***_fcol_**,**
                          **int ***_nrow_**, int ***_nbuf_**);**
    
           **int dynamic_field_info(const FIELD ***_field_**,**
                                  **int ***_rows_**, int ***_cols_**, int ***_max_**);**
    


## DESCRIPTION



           The function **field_info** returns the sizes and other attributes
           passed in to the field at its creation time.  The attributes are:
           height, width, row of upper-left corner, column of upper-left
           corner, number off-screen rows, and number of working buffers.
    
           The function **dynamic_field_info** returns the actual size of the
           field, and its maximum possible size.  If the field has no size
           limit, the location addressed by the third argument will be set to
           0.  A field can be made dynamic by turning off the **O_STATIC** option
           with **field_opts_off**.
    


## RETURN VALUE



           These routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    


## 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.
    
           A null (zero pointer) is accepted for any of the return values, to
           ignore that value.  Not all implementations allow this, e.g.,
           Solaris 2.7 does not.
    


* * *
# io_uring_prep_close

## NAME



           io_uring_prep_close - prepare a file descriptor close request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_close(struct io_uring_sqe ***_sqe_**,**
                                     **int** _fd_**);**
    
           **void io_uring_prep_close_direct(struct io_uring_sqe ***_sqe_**,**
                                           **unsigned** _file_index_**);**
    


## DESCRIPTION



           The io_uring_prep_close(3) function prepares a close request. The
           submission queue entry _sqe_ is setup to close the file descriptor
           indicated by _fd_.
    
           For a direct descriptor close request, the offset is specified by
           the _file_index_ argument instead of the _fd_.  This is identical to
           unregistering the direct descriptor, and is provided as a
           convenience. Note that even though it's closing a direct
           descriptor, the application must not set **IOSQE_FIXED_FILE** on the
           SQE. Otherwise the request will complete with **-EBADF** as the
           result.
    
           These functions prepare an async close(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. For closing
           of a direct descriptor, the only failure cases are the kernel
           running completely out of memory, or if the application has
           specified an invalid direct descriptor. 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.
    


* * *
# function::ngroups

## NAME



           function::ngroups - Number of subexpressions in the last match.
    


## SYNOPSIS



               ngroups:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           returns the number of subexpressions from the last successful use
           of the =~ regex matching operator.
    
           Note that this number includes subexpressions which are present in
           the regex but did not match any string; for example, given the
           regex “a|(b)”, the subexpressions will count the group for (b)
           regardless of whether it matched a string or not. Throws an error
           if the last use of =~ was a failed match.
    


* * *
# efadv_create_driver_qp

## NAME



           efadv_create_driver_qp - Create EFA specific Queue Pair # SYNOPSIS
    
                  #include <infiniband/efadv.h>
    
                  struct ibv_qp *efadv_create_driver_qp(struct ibv_pd *ibvpd,
                                                        struct ibv_qp_init_attr *attr,
                                                        uint32_t driver_qp_type);
    


## DESCRIPTION



           **efadv_create_driver_qp()** Create device-specific Queue Pairs.
    
           Scalable Reliable Datagram (SRD) transport provides reliable
           out-of-order delivery, transparently utilizing multiple network
           paths to reduce network tail latency.  Its interface is similar to
           UD, in particular it supports message size up to MTU, with error
           handling extended to support reliable communication.
    
           _driver_qp_type_
                  The type of QP to be created:
    
                  EFADV_QP_DRIVER_TYPE_SRD: Create an SRD QP.
    


## RETURN VALUE



           efadv_create_driver_qp() returns a pointer to the created QP, or
           NULL if the request fails.
    


* * *
# lldiv

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



           lldiv — compute quotient and remainder of a long division
    


## SYNOPSIS



           #include <stdlib.h>
    
           lldiv_t lldiv(long long _numer_ , long long _denom_);
    


## DESCRIPTION



           Refer to ldiv(3p).
    


* * *
# set_matchpathcon_flags

## NAME



           set_matchpathcon_flags, set_matchpathcon_invalidcon,
           set_matchpathcon_printf - set flags controlling the operation of
           matchpathcon or matchpathcon_index and configure the behaviour of
           validity checking and error displaying
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **void set_matchpathcon_flags(unsigned int** _flags_**);**
    
           **void set_matchpathcon_invalidcon(int (***_f_**)(const char ***_path_**,**
           **unsigned** _lineno_**, char ***_context_**));**
    
           **void set_matchpathcon_printf(void (***_f_**)(const char ***_fmt_**, ...));**
    


## DESCRIPTION



           **set_matchpathcon_flags**() sets the flags controlling the operation
           of matchpathcon_init(3) and subsequently matchpathcon_index(3) or
           matchpathcon(3).  If the **MATCHPATHCON_BASEONLY** flag is set, then
           only the base file contexts configuration file will be processed,
           not any dynamically generated entries or local customizations.
    
           **set_matchpathcon_invalidcon**() sets the function used by
           matchpathcon_init(3) when checking the validity of a context in
           the file contexts configuration.  If not set, then this defaults
           to a test based on security_check_context(3), which checks
           validity against the active policy on a SELinux system.  This can
           be set to instead perform checking based on a binary policy file,
           e.g. using sepol_check_context(3), as is done by **setfiles -c.** The
           function is also responsible for reporting any such error, and may
           include the _path_ and _lineno_ in such error messages.
    
           **set_matchpathcon_printf**() sets the function used by
           matchpathcon_init(3) when displaying errors about the file
           contexts configuration.  If not set, then this defaults to
           fprintf(stderr, fmt, ...).  This can be set to redirect error
           reporting to a different destination.
    


## RETURN VALUE



           Returns zero on success or -1 otherwise.
    


* * *
# probe::socket.send

## NAME



           probe::socket.send - Message sent on a socket.
    


## SYNOPSIS



           socket.send
    


## VALUES



           _size_
               Size of message sent (in bytes) or error code if success = 0
    
           _protocol_
               Protocol value
    
           _name_
               Name of this probe
    
           _type_
               Socket type value
    
           _state_
               Socket state value
    
           _family_
               Protocol family value
    
           _success_
               Was send successful? (1 = yes, 0 = no)
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender
    


* * *
# gnutls_tpm_get_registered

## NAME



           gnutls_tpm_get_registered - API function
    


## SYNOPSIS



           **#include <gnutls/tpm.h>**
    
           **int gnutls_tpm_get_registered(gnutls_tpm_key_list_t ***_list_**);**
    


## ARGUMENTS



           gnutls_tpm_key_list_t * list
                       a list to store the keys
    


## DESCRIPTION



           This function will get a list of stored keys in the TPM. The uuid
           of those keys
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# ausearch_set_stop

## NAME



            ausearch_set_stop - set the cursor position
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int ausearch_set_stop(auparse_state_t ***_au,_**austop_t"**_where);"_
    


## DESCRIPTION



           ausearch_set_stop determines where the internal cursor will stop
           when a search condition is met. The possible values are:
    
                  _AUSEARCH_STOP_EVENT_
                         This one repositions the cursors to the first field
                         of the first record of the event containing the
                         items searched for.
    
                  _AUSEARCH_STOP_RECORD_
                         This one repositions the cursors to the first field
                         of the record containing the items searched for.
    
                  _AUSEARCH_STOP_FIELD_
                         This one simply stops on the current field when the
                         evaluation of the rules becomes true.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, 0 for success.
    


* * *
# auparse_get_record_num

## NAME



           auparse_get_record_num - get current record cursor location
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_record_num will retrieve the internal library cursors
           current record location in the current event. Records within the
           same event are numbered starting from 0. This is generally not
           needed but there are some cases where one may want to know the
           exact record being looked at.
    


## RETURN VALUE



           Returns the current record cursor location.
    


* * *
# gnutls_priority_init

## NAME



           gnutls_priority_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_init(gnutls_priority_t ***_priority_cache_**, const**
           **char ***_priorities_**, const char ****_err_pos_**);**
    


## ARGUMENTS



           gnutls_priority_t * priority_cache
                       is a **gnutls_priority_t** type.
    
           const char * priorities
                       is a string describing priorities (may be **NULL**)
    
           const char ** err_pos
                       In case of an error this will have the position in the
                       string the error occurred
    


## DESCRIPTION



           For applications that do not modify their crypto settings per
           release, consider using **gnutls_priority_init2()** with
           **GNUTLS_PRIORITY_INIT_DEF_APPEND** flag instead. We suggest to use
           centralized crypto settings handled by the GnuTLS library, and
           applications modifying the default settings to their needs.
    
           This function is identical to **gnutls_priority_init2()** with zero
           flags.
    
           A **NULL** _priorities_ string indicates the default priorities to be
           used (this is available since GnuTLS 3.3.0).
    


## RETURNS



           On syntax error **GNUTLS_E_INVALID_REQUEST** is returned,
           **GNUTLS_E_SUCCESS** on success, or an error code.
    


* * *
# gnutls_fingerprint

## NAME



           gnutls_fingerprint - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_fingerprint(gnutls_digest_algorithm_t** _algo_**, const**
           **gnutls_datum_t ***_data_**, void ***_result_**, size_t ***_result_size_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t algo
                       is a digest algorithm
    
           const gnutls_datum_t * data
                       is the data
    
           void * result
                       is the place where the result will be copied (may be
                       null).
    
           size_t * result_size
                       should hold the size of the result. The actual size of
                       the returned result will also be copied there.
    


## DESCRIPTION



           This function will calculate a fingerprint (actually a hash), of
           the given data.  The result is not printable data.  You should
           convert it to hex, or to something else printable.
    
           This is the usual way to calculate a fingerprint of an X.509 DER
           encoded certificate.  Note however that the fingerprint of an
           OpenPGP certificate is not just a hash and cannot be calculated
           with this function.
    


## RETURNS



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


* * *
# function::is_return

## NAME



           function::is_return - Whether the current probe context is a
           return probe
    


## SYNOPSIS



               is_return:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns 1 if the current probe context is a return probe, returns
           0 otherwise.
    


* * *