tripathysagar/man_text huggingface dataset:
# xcrypt

## NAME



           xencrypt, xdecrypt, passwd2des - RFS password encryption
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <rpc/des_crypt.h>**
    
           **void passwd2des(char** _*passwd_**, char ***_key_**);**
    
           **int xencrypt(char ***_secret_**, char ***_passwd_**);**
           **int xdecrypt(char ***_secret_**, char ***_passwd_**);**
    


## DESCRIPTION



           **WARNING** : Do not use these functions in new code.  They do not
           achieve any type of acceptable cryptographic security guarantees.
    
           The function **passwd2des**() takes a character string _passwd_ of
           arbitrary length and fills a character array _key_ of length 8.  The
           array _key_ is suitable for use as DES key.  It has odd parity set
           in bit 0 of each byte.  Both other functions described here use
           this function to turn their argument _passwd_ into a DES key.
    
           The **xencrypt**() function takes the ASCII character string _secret_
           given in hex, which must have a length that is a multiple of 16,
           encrypts it using the DES key derived from _passwd_ by **passwd2des**(),
           and outputs the result again in _secret_ as a hex string of the same
           length.
    
           The **xdecrypt**() function performs the converse operation.
    


## RETURN VALUE



           The functions **xencrypt**() and **xdecrypt**() return 1 on success and 0
           on error.
    


## ATTRIBUTES



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


## VERSIONS



           These functions are available since glibc 2.1.
    


## BUGS



           The prototypes are missing from the abovementioned include file.
    


* * *
# ibv_is_fork_initialized

## NAME



           ibv_is_fork_initialized - check if fork support (ibv_fork_init) is
           enabled
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  enum ibv_fork_status {
                      IBV_FORK_DISABLED,
                      IBV_FORK_ENABLED,
                      IBV_FORK_UNNEEDED,
                  };
    
                  enum ibv_fork_status ibv_is_fork_initialized(void);
    


## DESCRIPTION



           **ibv_is_fork_initialized()** checks whether libibverbs **fork()** support
           was enabled through the **ibv_fork_init()** verb.
    


## RETURN VALUE



           **ibv_is_fork_initialized()** returns IBV_FORK_DISABLED if fork
           support is disabled, or IBV_FORK_ENABLED if enabled.
           IBV_FORK_UNNEEDED return value indicates that the kernel copies
           DMA pages on fork, hence a call to **ibv_fork_init()** is unneeded.
    


## NOTES



           The IBV_FORK_UNNEEDED return value takes precedence over
           IBV_FORK_DISABLED and IBV_FORK_ENABLED.  If the kernel supports
           copy-on-fork for DMA pages then IBV_FORK_UNNEEDED will be returned
           regardless of whether **ibv_fork_init()** was called or not.
    


* * *
# pcap_close

## NAME



           pcap_close - close a capture device or savefile
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **void pcap_close(pcap_t *p);**
    


## DESCRIPTION



           **pcap_close**() closes the files associated with _p_ and deallocates
           resources. This means that, for example, if _p_ refers to a savefile
           that was opened with **pcap_fopen_offline**() or
           **pcap_fopen_offline_with_tstamp_precision**(), the stream provided to
           the routine will be closed unless it is **stdin**.
    


* * *
# pmgetversion

## NAME



           **pmGetVersion** - fetch installed PCP version number
    


## C SYNOPSIS



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


## DESCRIPTION



           **pmGetVersion** returns  a  binary encoding of the locally installed
           PCP version number.
    
           This  may  be  used  in  conjunction  with  the   related   macros
           **PM_VERSION**(a,b,c) and **PM_VERSION_CURRENT** that generate PCP version
           numbers in the same format.  Refer to the example below.
    
           The  encoding  uses  one byte for each of the parts of the version
           number of the installed PCP package, namely the major number,  the
           minor  number  and  the revision number.  So PCP version 3.10.5 is
           encoded as 0x30a05.
    
           The string format of the installed PCP package version  number  as
           also available from **pmGetConfig** with the argument **PCP_VERSION**.
    
           **pmGetVersion** was introduced in PCP 3.10.5.
    


## EXAMPLE



           The following C fragment demonstrates the use of both the compile-
           time   macros  and  the  run-time  **pmGetVersion** function  for  an
           application that should not be built for PCP versions  older  than
           3.10.5,  but  after that there are two alternative implementations
           with a newer (faster, sweeter, smaller) variant of the XYZ service
           that only becoming available in PCP 4.0.0.
    
           #include <pcp/pmapi.h>
    
           #ifdef PM_VERSION_CURRENT
           #if PM_VERSION_CURRENT < PM_VERSION(3,10,5)
               /* no pmGetVersion() before PCP 3.10.5 */
               printf("PCP version 0x%x too old\n", PM_VERSION_CURRENT);
           #endif
               version = pmGetVersion();
               if (version >= PM_VERSION(4,0,0) {
                /* V2 of the XYZ service introduced in PCP 4.0.0 */
                printf("Using V2 of service XYZ\n")
                ...
               }
               else {
                printf("Using V1 of service XYZ\n")
                ...
               }
           #else
               {
                char *ver = pmGetConfig("PCP_VERSION");
                /* only option is to extract version number from returned string */
                ...
               }
           #endif
    


* * *
# keyctl_revoke

## NAME



           keyctl_revoke - revoke a key
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_revoke(key_serial_t** _key_**);**
    


## DESCRIPTION



           **keyctl_revoke**() marks a key as being revoked.
    
           After this operation has been performed on a key, attempts to
           access it will meet with error **EKEYREVOKED**.
    
           The caller must have **write** permission on a key to be able to
           revoke it.
    


## RETURN VALUE



           On success **keyctl_revoke**() 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.
    
           **EKEYREVOKED**
                  The key has already been revoked.
    
           **EACCES** The named key exists, but is not **writable** by the calling
                  process.
    


## LINKING



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


* * *
# gnutls_cipher_encrypt3

## NAME



           gnutls_cipher_encrypt3 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_encrypt3(gnutls_cipher_hd_t** _handle_**, const void ***
           _ptext_**, size_t** _ptext_len_**, void ***_ctext_**, size_t ***_ctext_len_**,**
           **unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           const void * ptext
                       the data to encrypt
    
           size_t ptext_len
                       the length of data to encrypt
    
           void * ctext
                       the encrypted data
    
           size_t * ctext_len
                       the length of encrypted data (initially must hold the
                       maximum available size)
    
           unsigned flags
                       flags for padding
    


## DESCRIPTION



           This function will encrypt the given data using the algorithm
           specified by the context. For block ciphers,  _ptext_len_ is
           typically a multiple of the block size. If not, the caller can
           instruct the function to pad the last block according to  _flags_ .
           Currently, the only available padding scheme is
           **GNUTLS_CIPHER_PADDING_PKCS7**.
    
           If  _ctext_ is not **NULL** , it must hold enough space to store
           resulting cipher text. To check the required size, this function
           can be called with  _ctext_ set to **NULL**. Then  _ctext_len_ will be
           updated without performing actual encryption.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.7.7
    


* * *
# gnutls_global_init

## NAME



           gnutls_global_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_global_init(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Since GnuTLS 3.3.0 this function is no longer necessary to be
           explicitly called. To disable the implicit call (in a library
           constructor) of this function set the environment variable
           **GNUTLS_NO_IMPLICIT_INIT** to 1.
    
           This function performs any required precalculations, detects the
           supported CPU capabilities and initializes the underlying
           cryptographic backend. In order to free any resources taken by
           this call you should **gnutls_global_deinit()** when gnutls usage is
           no longer needed.
    
           This function increments a global counter, so that
           **gnutls_global_deinit()** only releases resources when it has been
           called as many times as **gnutls_global_init()**.  This is useful when
           GnuTLS is used by more than one library in an application.  This
           function can be called many times, but will only do something the
           first time. It is thread safe since GnuTLS 3.3.0.
    
           A subsequent call of this function if the initial has failed will
           return the same error code.
    


## RETURNS



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


* * *
# selabel_stats

## NAME



           selabel_stats - obtain SELinux labeling statistics
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **void selabel_stats(struct selabel_handle ***_hnd_**);**
    


## DESCRIPTION



           **selabel_stats**() causes zero or more messages to be printed
           containing backend-specific information about number of queries
           performed, number of unused entries, or other operational
           information.
    
           The messages are printed to standard error by default; a custom
           logging function can be provided via selinux_set_callback(3).
    


## RETURN VALUE



           None.
    


## ERRORS



           None.
    


* * *
# gnutls_ocsp_resp_get_response

## NAME



           gnutls_ocsp_resp_get_response - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_response(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_datum_t ***_response_type_oid_**, gnutls_datum_t ***_response_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           gnutls_datum_t * response_type_oid
                       newly allocated output buffer with response type OID
    
           gnutls_datum_t * response
                       newly allocated output buffer with DER encoded
                       response
    


## DESCRIPTION



           This function will extract the response type OID in and the
           response data from an OCSP response.  Normally the
            _response_type_oid_ is always "1.3.6.1.5.5.7.48.1.1" which means
           the
            _response_ should be decoded as a Basic OCSP Response, but
           technically other response types could be used.
    
           This function is typically only useful when you want to extract
           the response type OID of an response for diagnostic purposes.
           Otherwise **gnutls_ocsp_resp_import()** will decode the basic OCSP
           response part and the caller need not worry about that aspect.
    
           Since 3.7.0  _response_type_oid_ ->size does not account for the
           terminating null byte.
    


## RETURNS



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


* * *
# gnutls_check_version

## NAME



           gnutls_check_version - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_check_version(const char ***_req_version_**);**
    


## ARGUMENTS



           const char * req_version
                       version string to compare with, or **NULL**.
    


## DESCRIPTION



           Check the GnuTLS Library version against the provided string.  See
           **GNUTLS_VERSION** for a suitable  _req_version_ string.
    
           See also **gnutls_check_version_numeric()** , which provides this
           functionality as a macro.
    


## RETURNS



           Check that the version of the library is at minimum the one given
           as a string in  _req_version_ and return the actual version string
           of the library; return **NULL** if the condition is not met.  If **NULL**
           is passed to this function no check is done and only the version
           string is returned.
    


* * *
# gnutls_x509_crt_import_pkcs11

## NAME



           gnutls_x509_crt_import_pkcs11 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_x509_crt_import_pkcs11(gnutls_x509_crt_t** _crt_**,**
           **gnutls_pkcs11_obj_t** _pkcs11_crt_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       A certificate of type **gnutls_x509_crt_t**
    
           gnutls_pkcs11_obj_t pkcs11_crt
                       A PKCS 11 object that contains a certificate
    


## DESCRIPTION



           This function will import a PKCS 11 certificate to a
           **gnutls_x509_crt_t** structure.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::stap.pass6

## NAME



           probe::stap.pass6 - Starting stap pass6 (cleanup)
    


## SYNOPSIS



           stap.pass6
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass6 fires just after the cleanup label, essentially the same
           spot as pass5.end
    


* * *
# pmiputvalue

## NAME



           **pmiPutValue** - add a value for a metric-instance pair
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiPutValue(const char ***_name_**, const char ***_instance_**,**
                           **const char ***_value_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiPutValue($**_name_**, $**_instance_**, $**_value_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiPutValue** adds a single value to the current out‐
           put record for a given metric and instance.
    
           The metric's _name_ should match one defined earlier in  a  call  to
           pmiAddMetric(3).
    
           For  singular  metrics  (those  defined with an instance domain of
           **PM_INDOM_NULL**), the _instance_ should be NULL or  an  empty  string,
           otherwise  _instance_  should  match the name of an instance defined
           earlier in a call to pmiAddInstance(3) for the  metric's  instance
           domain.
    
           The  _value_ should be in a format consistent with the metric's type
           as defined in the call to pmiAddMetric(3).
    
           No data will be written until pmiWrite(3) is called,  so  multiple
           calls to **pmiPutValue** or pmiPutValueHandle(3) are typically used to
           accumulate  data  values  for several metric-instance pairs before
           calling pmiWrite(3).
    


## DIAGNOSTICS



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


* * *
# gnutls_pkcs11_token_get_ptr

## NAME



           gnutls_pkcs11_token_get_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_get_ptr(const char ***_url_**, void ****_ptr_**,**
           **unsigned long ***_slot_id_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * url
                       should contain a PKCS**11** URL identifying a token
    
           void ** ptr will contain the CK_FUNCTION_LIST_PTR pointer
    
           unsigned long * slot_id
                       will contain the slot_id (may be **NULL**)
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will return the function pointer of the specified
           token by the URL. The returned pointers are valid until gnutls is
           deinitialized, c.f. **_global_deinit()**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error code on error.
    


## SINCE



           3.6.3
    


* * *
# dane_verify_crt

## NAME



           dane_verify_crt - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_verify_crt(dane_state_t** _s_**, const gnutls_datum_t ***_chain_**,**
           **unsigned** _chain_size_**, gnutls_certificate_type_t** _chain_type_**, const**
           **char ***_hostname_**, const char ***_proto_**, unsigned int** _port_**, 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
    
           const char * hostname
                       The hostname associated with the chain
    
           const char * proto
                       The protocol of the service connecting (e.g. tcp)
    
           unsigned int port
                       The port of the service connecting (e.g. 443)
    
           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 function will verify the given certificate chain against the
           CA constrains and/or the certificate available via DANE.  If no
           information via DANE can be obtained the flag
           **DANE_VERIFY_NO_DANE_INFO** is set. If a DNSSEC signature is not
           available for the DANE record then the verify flag
           **DANE_VERIFY_NO_DNSSEC_DATA** is set.
    
           Due to the many possible options of DANE, there is no single
           threat model countered. When notifying the user about DANE
           verification results it may be better to mention: DANE
           verification did not reject the certificate, rather than
           mentioning a successful DANE verification.
    
           Note that this function is designed to be run in addition to PKIX
           - certificate chain - verification. To be run independently the
           **DANE_VFLAG_ONLY_CHECK_EE_USAGE** flag should be specified; then the
           function will check whether the key of the peer matches the key
           advertised in the DANE entry.
    


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


* * *
# mlx5dv_free_var

## NAME



           mlx5dv_alloc_var - Allocates a VAR
    
           mlx5dv_free_var - Frees a VAR
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_var *
                  mlx5dv_alloc_var(struct ibv_context *context, uint32_t flags);
    
                  void mlx5dv_free_var(struct mlx5dv_var *dv_var);
    


## DESCRIPTION



           Create / free a VAR which can be used for some device commands
           over the DEVX interface.
    
           The DEVX API enables direct access from the user space area to the
           mlx5 device driver, the VAR information is needed for few commands
           related to Virtio.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _flags_  Allocation flags for the UAR.
    
       **dv_var**
                  struct mlx5dv_var {
                      uint32_t page_id;
                      uint32_t length;
                      off_t mmap_off;
                      uint64_t comp_mask;
                  };
    
           _page_id_
                  The device page id to be used.
    
           _length_ The mmap length parameter to be used for mapping a VA to
                  the allocated VAR entry.
    
           _mmap_off_
                  The mmap offset parameter to be used for mapping a VA to
                  the allocated VAR entry.
    


## RETURN VALUE



           Upon success _mlx5dv_alloc_var_ returns a pointer to the created VAR
           ,on error NULL will be returned and errno will be set.
    


* * *
# form_new

## NAME



           **new_form** , **free_form** - create and destroy forms
    


## SYNOPSIS



           **#include <form.h>**
    
           **FORM *new_form(FIELD ****_fields_**);**
           **int free_form(FORM ***_form_**);**
    


## DESCRIPTION



           The function **new_form** creates a new form connected to a specified
           field pointer array (which must be **NULL** -terminated).
    
           The function **free_form** disconnects _form_ from its field array and
           frees the storage allocated for the form.
    


## RETURN VALUE



           The function **new_form** returns **NULL** on error.  It sets **errno**
           according to the function's success:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_CONNECTED**
                The field is already connected to a form.
    
           **E_SYSTEM_ERROR**
                System error occurred, e.g., malloc failure.
    
           The function **free_form** returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_POSTED**
                The form has already been posted.
    


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


* * *
# gnutls_x509_privkey_get_pk_algorithm2

## NAME



           gnutls_x509_privkey_get_pk_algorithm2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_get_pk_algorithm2(gnutls_x509_privkey_t**
           _key_**, unsigned int ***_bits_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    
           unsigned int * bits
                       The number of bits in the public key algorithm
    


## DESCRIPTION



           This function will return the public key algorithm of a private
           key.
    


## RETURNS



           a member of the **gnutls_pk_algorithm_t** enumeration on success, or a
           negative error code on error.
    


* * *
# cos

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



           cos, cosf, cosl — cosine function
    


## SYNOPSIS



           #include <math.h>
    
           double cos(double _x_);
           float cosf(float _x_);
           long double cosl(long double _x_);
    


## 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 cosine of their argument _x_ ,
           measured in radians.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           cosine of _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, the value 1.0 shall be returned.
    
           If _x_ is ±Inf, a domain error shall occur, and a NaN shall be
           returned.
    


## ERRORS



           These functions shall fail if:
    
           Domain Error
                       The _x_ argument is ±Inf.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[EDOM]**.  If the integer expression (_math_errhandling_ &
                       MATH_ERREXCEPT) is non-zero, then the invalid
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



       **Taking the Cosine of a 45-Degree Angle**
               #include <math.h>
               ...
               double radians = 45 * M_PI / 180;
               double result;
               ...
               result = cos(radians);
    


## APPLICATION USAGE



           These functions may lose accuracy when their argument is near an
           odd multiple of π/2 or is far from 0.
    
           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crl_get_extension_oid

## NAME



           gnutls_x509_crl_get_extension_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_extension_oid(gnutls_x509_crl_t** _crl_**,**
           **unsigned** _indx_**, void ***_oid_**, size_t ***_sizeof_oid_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           unsigned indx
                       Specifies which extension OID to send, use (0) to get
                       the first one.
    
           void * oid  a pointer to store the OID (may be null)
    
           size_t * sizeof_oid
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the requested extension OID in the CRL.
           The extension OID will be stored as a string in the provided
           buffer.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code in case of an error.  If your have reached the last
           extension available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be
           returned.
    


## SINCE



           2.8.0
    


* * *
# tapset::uconversions-guru

## NAME



           tapset::uconversions-guru - systemtap uconversions-guru tapset
    


## DESCRIPTION



           **set_user_string**
                  Writes a string to user memory
    
                  See function::set_user_string(3stap)
                   for details.
    
           **set_user_string_n**
                  Writes a string of given length to user memory
    
                  See function::set_user_string_n(3stap)
                   for details.
    
           **set_user_string_arg**
                  Writes a string to user memory.
    
                  See function::set_user_string_arg(3stap)
                   for details.
    
           **set_user_long**
                  Writes a long value to user memory
    
                  See function::set_user_long(3stap)
                   for details.
    
           **set_user_int**
                  Writes an int value to user memory
    
                  See function::set_user_int(3stap)
                   for details.
    
           **set_user_short**
                  Writes a short value to user memory
    
                  See function::set_user_short(3stap)
                   for details.
    
           **set_user_char**
                  Writes a char value to user memory
    
                  See function::set_user_char(3stap)
                   for details.
    
           **set_user_pointer**
                  Writes a pointer value to user memory.
    
                  See function::set_user_pointer(3stap)
                   for details.
    


* * *
# probe::tcp.setsockopt.return

## NAME



           probe::tcp.setsockopt.return - Return from **setsockopt**
    


## SYNOPSIS



           tcp.setsockopt.return
    


## VALUES



           _ret_
               Error code (0: no error)
    
           _name_
               Name of this probe
    


## CONTEXT



           The process which calls setsockopt
    


* * *
# ibv_post_recv

## NAME



           ibv_post_recv - post a list of work requests (WRs) to a receive
           queue
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **int ibv_post_recv(struct ibv_qp** _*qp_**, struct ibv_recv_wr** _*wr_**,**
                             **struct ibv_recv_wr** _**bad_wr_**);**
    


## DESCRIPTION



           **ibv_post_recv()** posts the linked list of work requests (WRs)
           starting with _wr_ to the receive queue of the queue pair _qp_.  It
           stops processing WRs from this list at the first failure (that can
           be detected immediately while requests are being posted), and
           returns this failing WR through _bad_wr_.
    
           The argument _wr_ is an ibv_recv_wr struct, as defined in
           <infiniband/verbs.h>.
    
           struct ibv_recv_wr {
                   uint64_t                wr_id;     /* User defined WR ID */
                   struct ibv_recv_wr     *next;      /* Pointer to next WR in list, NULL if last WR */
                   struct ibv_sge         *sg_list;   /* Pointer to the s/g array */
                   int                     num_sge;   /* Size of the s/g array */
           };
    
           struct ibv_sge {
                   uint64_t                addr;      /* Start address of the local memory buffer */
                   uint32_t                length;    /* Length of the buffer */
                   uint32_t                lkey;      /* Key of the local Memory Region */
           };
    


## RETURN VALUE



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


## NOTES



           The buffers used by a WR can only be safely reused after WR the
           request is fully executed and a work completion has been retrieved
           from the corresponding completion queue (CQ).
    
           If the QP _qp_ is associated with a shared receive queue, you must
           use the function **ibv_post_srq_recv()** , and not **ibv_post_recv()** ,
           since the QP's own receive queue will not be used.
    
           If a WR is being posted to a UD QP, the Global Routing Header
           (GRH) of the incoming message will be placed in the first 40 bytes
           of the buffer(s) in the scatter list.  If no GRH is present in the
           incoming message, then the first bytes will be undefined.  This
           means that in all cases, the actual data of the incoming message
           will start at an offset of 40 bytes into the buffer(s) in the
           scatter list.
    


* * *
# gnutls_srp_free_server_credentials

## NAME



           gnutls_srp_free_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_srp_free_server_credentials(gnutls_srp_server_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_srp_server_credentials_t sc
                       is a **gnutls_srp_server_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_srp_server_credentials_t structure.
    


* * *
# ibv_set_ece

## NAME



           ibv_set_ece - set ECE options and use them for QP configuration
           stage.
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_set_ece(struct ibv_qp *qp, struct ibv_ece *ece);
    


## DESCRIPTION



           **ibv_set_ece()** set ECE options and use them for QP configuration
           stage.
    
           The desired ECE options will be used during various modify QP
           stages based on supported options in relevant QP state.
    


## ARGUMENTS



           _qp_     The queue pair (QP) associated with the ECE options.
    
           ## _ece_ Argument
                  The requested ECE values.  This is IN/OUT field, the
                  accepted options will be returned in this field.
    
                  struct ibv_ece {
                      uint32_t vendor_id;
                      uint32_t options;
                      uint32_t comp_mask;
                  };
    
           _vendor_id_
                  Unique identifier of the provider vendor on the network.
                  The providers will set IEEE OUI here to distinguish itself
                  in non-homogenius network.
    
           _options_
                  Provider specific attributes which are supported or needed
                  to be enabled by ECE users.
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid.
    


## RETURN VALUE



           **ibv_set_ece()** returns 0 when the call was successful, or the errno
           value which indicates the failure reason.
    
           _EOPNOTSUPP_
                  libibverbs or provider driver doesn’t support the
                  ibv_set_ece() verb.
    
           _EINVAL_ In one of the following: o The QP is invalid.  o The ECE
                  options are invalid.
    


* * *
# gnutls_protocol_list

## NAME



           gnutls_protocol_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_protocol_t * gnutls_protocol_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of supported protocols, e.g. SSL 3.0, TLS 1.0 etc.
    
           This function is not thread safe.
    


## RETURNS



           a (0)-terminated list of **gnutls_protocol_t** integers indicating the
           available protocols.
    


* * *
# acl_get_perm

## NAME



           **acl_get_perm** — test for a permission in an ACL permission set
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _int_ **acl_get_perm**(_acl_permset_t_
           _permset_d_ , _acl_perm_t perm_)
    


## DESCRIPTION



           The **acl_get_perm**() function tests if the permission specified by
           the argument _perm_ (one of ACL_READ, ACL_WRITE, ACL_EXECUTE) is
           contained in the ACL permission set pointed to by the argument
           _permset_d_.
    
           Any existing descriptors that refer to _permset_d_ continue to refer
           to that permission set.
    


## RETURN VALUE



           If successful, the **acl_get_perm**() function returns **1** if the
           permission specified by _perm_ is contained in the ACL permission
           set _permset_d_ , and **0** if the permission is not contained in the
           permission set. Otherwise, the value **-1** is returned and the global
           variable _errno_ is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_get_perm**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _permset_d_ is not a valid
                              descriptor for a permission set within an ACL
                              entry.
    
                              The argument _perm_ is not a valid _acl_perm_t_
                              value.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# probe::linuxmib.ListenDrops

## NAME



           probe::linuxmib.ListenDrops - Count of times conn request that
           were dropped
    


## SYNOPSIS



           linuxmib.ListenDrops
    


## VALUES



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


## DESCRIPTION



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


* * *
# auparse_get_line_number

## NAME



           auparse_get_line_number - get line number where record was found
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_line_number will return the source input line number
           for the current record of the current event. Line numbers start at
           1.  If the source input type is AUSOURCE_FILE_ARRAY the line
           numbering will reset back to 1 each time a new line in the file
           array is opened.
    


## RETURN VALUE



           Returns the line number. Line numbers are 1 based, a zero value
           indicates the line number information is unavailable.
    


* * *
# pcre2_set_heap_limit

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



    
           This function sets the backtracking heap limit field in a match
           context. The result is always zero.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# function::symfile

## NAME



           function::symfile - Return the file name of a given address.
    


## SYNOPSIS



               symfile:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the file name of the given address, if known. If the file
           name cannot be found, the hex string representation of the address
           will be returned.
    


* * *
# gnutls_cipher_init

## NAME



           gnutls_cipher_init - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_init(gnutls_cipher_hd_t ***_handle_**,**
           **gnutls_cipher_algorithm_t** _cipher_**, const gnutls_datum_t ***_key_**,**
           **const gnutls_datum_t ***_iv_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t * handle
                       is a **gnutls_cipher_hd_t** type
    
           gnutls_cipher_algorithm_t cipher
                       the encryption algorithm to use
    
           const gnutls_datum_t * key
                       the key to be used for encryption/decryption
    
           const gnutls_datum_t * iv
                       the IV to use (if not applicable set NULL)
    


## DESCRIPTION



           This function will initialize the  _handle_ context to be usable for
           encryption/decryption of data. This will effectively use the
           current crypto backend in use by gnutls or the cryptographic
           accelerator in use.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# strdup

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



           strdup, strndup — duplicate a specific number of bytes from a
           string
    


## SYNOPSIS



           #include <string.h>
    
           char *strdup(const char *_s_);
           char *strndup(const char *_s_ , size_t _size_);
    


## DESCRIPTION



           The _strdup_() function shall return a pointer to a new string,
           which is a duplicate of the string pointed to by _s_.  The returned
           pointer can be passed to _free_().  A null pointer is returned if
           the new string cannot be created.
    
           The _strndup_() function shall be equivalent to the _strdup_()
           function, duplicating the provided _s_ in a new block of memory
           allocated as if by using _malloc_(), with the exception being that
           _strndup_() copies at most _size_ plus one bytes into the newly
           allocated memory, terminating the new string with a NUL character.
           If the length of _s_ is larger than _size_ , only _size_ bytes shall be
           duplicated. If _size_ is larger than the length of _s_ , all bytes in _s_
           shall be copied into the new memory buffer, including the
           terminating NUL character. The newly created string shall always
           be properly terminated.
    


## RETURN VALUE



           The _strdup_() function shall return a pointer to a new string on
           success. Otherwise, it shall return a null pointer and set _errno_
           to indicate the error.
    
           Upon successful completion, the _strndup_() function shall return a
           pointer to the newly allocated memory containing the duplicated
           string. Otherwise, it shall return a null pointer and set _errno_ to
           indicate the error.
    


## ERRORS



           These functions shall fail if:
    
           **ENOMEM** Storage space available is insufficient.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           For functions that allocate memory as if by _malloc_(), the
           application should release such memory when it is no longer
           required by a call to _free_().  For _strdup_() and _strndup_(), this is
           the return value.
    
           Implementations are free to _malloc_() a buffer containing either
           (_size_ + 1) bytes or (_strnlen_( _s_ , _size_) + 1) bytes. Applications
           should not assume that _strndup_() will allocate (_size_ + 1) bytes
           when _strlen_( _s_) is smaller than _size_.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# lrand48

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



           lrand48 — generate uniformly distributed pseudo-random non-
           negative long integers
    


## SYNOPSIS



           #include <stdlib.h>
    
           long lrand48(void);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# pcre2_set_newline

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_newline(pcre2_compile_context ***_ccontext_**,**
             **uint32_t** _value_**);**
    


## DESCRIPTION



    
           This function sets the newline convention within a compile
           context. This specifies which character(s) are recognized as
           newlines when compiling and matching patterns. The second argument
           must be one of:
    
             PCRE2_NEWLINE_CR        Carriage return only
             PCRE2_NEWLINE_LF        Linefeed only
             PCRE2_NEWLINE_CRLF      CR followed by LF only
             PCRE2_NEWLINE_ANYCRLF   Any of the above
             PCRE2_NEWLINE_ANY       Any Unicode newline sequence
             PCRE2_NEWLINE_NUL       The NUL character (binary zero)
    
           The result is zero for success or PCRE2_ERROR_BADDATA if the
           second argument is invalid.
    
           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.
    


* * *