tripathysagar/man_text huggingface dataset:
# gnutls_x509_crq_get_pk_oid

## NAME



           gnutls_x509_crq_get_pk_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_pk_oid(gnutls_x509_crq_t** _crq_**, char ***_oid_**,**
           **size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           char * oid  a pointer to a buffer to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the OID of the public key algorithm on
           that certificate request. This function is useful in the case
           **gnutls_x509_crq_get_pk_algorithm()** returned **GNUTLS_PK_UNKNOWN**.
    


## RETURNS



           zero or a negative error code on error.
    


## SINCE



           3.5.0
    


* * *
# function::print_syms

## NAME



           function::print_syms - Print out kernel stack from string
    


## SYNOPSIS



               print_syms(callers:string)
    


## ARGUMENTS



           _callers_
               String with list of hexadecimal (kernel) addresses
    


## DESCRIPTION



           This function performs a symbolic lookup of the addresses in the
           given string, which are assumed to be the result of prior calls to
           **stack** , **callers** , and similar functions.
    
           Prints one line per address, including the address, the name of
           the function containing the address, and an estimate of its
           position within that function, as obtained by **symdata**. Returns
           nothing.
    


* * *
# abs

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



           abs — return an integer absolute value
    


## SYNOPSIS



           #include <stdlib.h>
    
           int abs(int _i_);
    


## 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 _abs_() function shall compute the absolute value of its integer
           operand, _i_.  If the result cannot be represented, the behavior is
           undefined.
    


## RETURN VALUE



           The _abs_() function shall return the absolute value of its integer
           operand.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           In two's-complement representation, the absolute value of the
           negative integer with largest magnitude {INT_MIN} might not be
           representable.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::abort

## NAME



           function::abort - Immediately shutting down probing script.
    


## SYNOPSIS



               abort()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This is similar to **exit** but immediately aborts the current probe
           handler instead of waiting for its completion. Probe handlers
           already running on *other* CPU cores, however, will still continue
           to their completion. Unlike **error** , this function call cannot be
           caught by 'try ... catch'.
    


* * *
# probe::nfs.proc.read

## NAME



           probe::nfs.proc.read - NFS client synchronously reads file from
           server
    


## SYNOPSIS



           nfs.proc.read
    


## VALUES



           _offset_
               the file offset
    
           _prot_
               transfer protocol
    
           _count_
               read bytes in this execution
    
           _version_
               NFS version
    
           _server_ip_
               IP address of server
    
           _flags_
               used to set task->tk_flags in rpc_init_task function
    


## DESCRIPTION



           All the nfs.proc.read kernel functions were removed in kernel
           commit 8e0969 in December 2006, so these probes do not exist on
           Linux 2.6.21 and newer kernels.
    


* * *
# dane_state_set_dlv_file

## NAME



           dane_state_set_dlv_file - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_state_set_dlv_file(dane_state_t** _s_**, const char ***_file_**);**
    


## ARGUMENTS



           dane_state_t s
                       The structure to be deinitialized
    
           const char * file
                       The file holding the DLV keys.
    


## DESCRIPTION



           This function will set a file with trusted keys for DLV (DNSSEC
           Lookaside Validation).
    


* * *
# ptsname

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



           ptsname — get name of the slave pseudo-terminal device
    


## SYNOPSIS



           #include <stdlib.h>
    
           char *ptsname(int _fildes_);
    


## DESCRIPTION



           The _ptsname_() function shall return the name of the slave pseudo-
           terminal device associated with a master pseudo-terminal device.
           The _fildes_ argument is a file descriptor that refers to the master
           device. The _ptsname_() function shall return a pointer to a string
           containing the pathname of the corresponding slave device.
    
           The _ptsname_() function need not be thread-safe.
    


## RETURN VALUE



           Upon successful completion, _ptsname_() shall return a pointer to a
           string which is the name of the pseudo-terminal slave device. Upon
           failure, _ptsname_() shall return a null pointer and may set _errno_.
           This could occur if _fildes_ is an invalid file descriptor or if the
           slave device name does not exist in the file system.
    
           The application shall not modify the string returned. The returned
           pointer might be invalidated or the string content might be
           overwritten by a subsequent call to _ptsname_().  The returned
           pointer and the string content might also be invalidated if the
           calling thread is terminated.
    


## ERRORS



           The _ptsname_() function may fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **ENOTTY** The file associated with the _fildes_ argument is not a
                  master pseudo-terminal device.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           See the RATIONALE section for posix_openpt(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_entries

## NAME



           **acl_entries** — return the number of entries in an ACL
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _int_ **acl_entries**(_acl_t acl_)
    


## DESCRIPTION



           The **acl_entries**() function returns the number of ACL entries that
           are contained in the ACL referred to by the argument _acl_.
    


## RETURN VALUE



           The **acl_entries**() function returns the number of entries in _acl_ if
           successful; otherwise the value **-1** is returned and the global
           variable _errno_ is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_entries**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    


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


* * *
# getdtablesize

## NAME



           getdtablesize - get file descriptor table size
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **int getdtablesize(void);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **getdtablesize**():
               Since glibc 2.20:
                   _DEFAULT_SOURCE || ! (_POSIX_C_SOURCE >= 200112L)
               glibc 2.12 to glibc 2.19:
                   _BSD_SOURCE || ! (_POSIX_C_SOURCE >= 200112L)
               Before glibc 2.12:
                   _BSD_SOURCE || _XOPEN_SOURCE >= 500
    


## DESCRIPTION



           **getdtablesize**() returns the maximum number of files a process can
           have open, one more than the largest possible value for a file
           descriptor.
    


## RETURN VALUE



           The current limit on the number of open files per process.
    


## ERRORS



           On Linux, **getdtablesize**() can return any of the errors described
           for getrlimit(2); see VERSIONS below.
    


## ATTRIBUTES



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


## VERSIONS



           The glibc version of **getdtablesize**() calls getrlimit(2) and
           returns the current **RLIMIT_NOFILE** limit, or **OPEN_MAX** when that
           fails.
    
           Portable applications should employ _sysconf(_SC_OPEN_MAX)_ instead
           of this call.
    


## STANDARDS



           None.
    


* * *
# gnutls_pkcs12_bag_get_type

## NAME



           gnutls_pkcs12_bag_get_type - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           unsigned indx
                       The element of the bag to get the type
    


## DESCRIPTION



           This function will return the bag's type.
    


## RETURNS



           On error a negative error value or one of the
           **gnutls_pkcs12_bag_type_t** enumerations.
    


* * *
# function::int_arg

## NAME



           function::int_arg - Return function argument as signed int
    


## SYNOPSIS



               int_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the value of argument n as a signed int (i.e., a 32-bit
           integer sign-extended to 64 bits).
    


* * *
# gnutls_x509_crt_get_pk_gost_raw

## NAME



           gnutls_x509_crt_get_pk_gost_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_gost_raw(gnutls_x509_crt_t** _crt_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_digest_algorithm_t ***_digest_**,**
           **gnutls_gost_paramset_t ***_paramset_**, gnutls_datum_t ***_x_**,**
           **gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_digest_algorithm_t * digest
                       will hold the digest
    
           gnutls_gost_paramset_t * paramset
                       will hold the GOST parameter set ID
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    


## DESCRIPTION



           This function will export the GOST public key's parameters found
           in the given certificate.  The new parameters will be allocated
           using **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# pcre2_substring_number_from_name

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_number_from_name(const pcre2_code ***_code_**,**
             **PCRE2_SPTR** _name_**);**
    


## DESCRIPTION



    
           This convenience function finds the number of a named substring
           capturing parenthesis in a compiled pattern, provided that it is a
           unique name. The function arguments are:
    
             _code_    Compiled regular expression
             _name_    Name whose number is required
    
           The yield of the function is the number of the parenthesis if the
           name is found, or PCRE2_ERROR_NOSUBSTRING if it is not found. When
           duplicate names are allowed (PCRE2_DUPNAMES is set), if the name
           is not unique, PCRE2_ERROR_NOUNIQUESUBSTRING is returned. You can
           obtain the list of numbers with the same name by calling
           **pcre2_substring_nametable_scan()**.
    
           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.
    


* * *
# memcmp

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



           memcmp — compare bytes in memory
    


## SYNOPSIS



           #include <string.h>
    
           int memcmp(const void *_s1_ , const void *_s2_ , size_t _n_);
    


## 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 _memcmp_() function shall compare the first _n_ bytes (each
           interpreted as **unsigned char**) of the object pointed to by _s1_ to
           the first _n_ bytes of the object pointed to by _s2_.
    
           The sign of a non-zero return value shall be determined by the
           sign of the difference between the values of the first pair of
           bytes (both interpreted as type **unsigned char**) that differ in the
           objects being compared.
    


## RETURN VALUE



           The _memcmp_() function shall return an integer greater than, equal
           to, or less than 0, if the object pointed to by _s1_ is greater
           than, equal to, or less than the object pointed to by _s2_ ,
           respectively.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::udp.disconnect

## NAME



           probe::udp.disconnect - Fires when a process requests for a UDP
           disconnection
    


## SYNOPSIS



           udp.disconnect
    


## VALUES



           _sport_
               UDP source port
    
           _dport_
               UDP destination port
    
           _flags_
               Flags (e.g. FIN, etc)
    
           _daddr_
               A string representing the destination IP address
    
           _family_
               IP address family
    
           _saddr_
               A string representing the source IP address
    
           _name_
               The name of this probe
    
           _sock_
               Network socket used by the process
    


## CONTEXT



           The process which requests a UDP disconnection
    


* * *
# gnutls_db_get_ptr

## NAME



           gnutls_db_get_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void * gnutls_db_get_ptr(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get db function pointer.
    


## RETURNS



           the pointer that will be sent to db store, retrieve and delete
           functions, as the first argument.
    


* * *
# iconv_close

## NAME



           iconv_close - deallocate descriptor for character set conversion
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <iconv.h>**
    
           **int iconv_close(iconv_t** _cd_**);**
    


## DESCRIPTION



           The **iconv_close**() function deallocates a conversion descriptor _cd_
           previously allocated using iconv_open(3).
    


## RETURN VALUE



           On success, **iconv_close**() returns 0; otherwise, it returns -1 and
           sets _errno_ to indicate the error.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_sec_param_to_symmetric_bits

## NAME



           gnutls_sec_param_to_symmetric_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned int gnutls_sec_param_to_symmetric_bits(gnutls_sec_param_t**
           _param_**);**
    


## ARGUMENTS



           gnutls_sec_param_t param
                       is a security parameter
    


## DESCRIPTION



           This function will return the number of bits that correspond to
           symmetric cipher strength for the given security parameter.
    


## RETURNS



           The number of bits, or (0).
    


## SINCE



           3.3.0
    


* * *
# toascii

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



           toascii — translate an integer to a 7-bit ASCII character
    


## SYNOPSIS



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


## DESCRIPTION



           The _toascii_() function shall convert its argument into a 7-bit
           ASCII character.
    


## RETURN VALUE



           The _toascii_() function shall return the value (_c_ &0x7f).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _toascii_() function cannot be used portably in a localized
           application.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



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


* * *
# gnutls_x509_crt_set_basic_constraints

## NAME



           gnutls_x509_crt_set_basic_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_basic_constraints(gnutls_x509_crt_t** _crt_**,**
           **unsigned int** _ca_**, int** _pathLenConstraint_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           unsigned int ca
                       true(1) or false(0). Depending on the Certificate
                       authority status.
    
           int pathLenConstraint
                       non-negative error codes indicate maximum length of
                       path, and negative error codes indicate that the
                       pathLenConstraints field should not be present.
    


## DESCRIPTION



           This function will set the basicConstraints certificate extension.
    


## RETURNS



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


* * *
# auparse_feed_has_data

## NAME



           auparse_feed_has_data - check if there is any data accumulating
           that might need flushing.
    


## SYNOPSIS



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


## DESCRIPTION



           _auparse_feed_has_data_ may be called to determine if there is any
           records that are accumulating but not yet ready to emit.
    


## RETURN VALUE



           Returns 1 if any records are accumulating otherwise 0 if empty.
    


* * *
# setkey

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



           setkey — set encoding key (**CRYPT**)
    


## SYNOPSIS



           #include <stdlib.h>
    
           void setkey(const char *_key_);
    


## DESCRIPTION



           The _setkey_() function provides access to an implementation-defined
           encoding algorithm. The argument of _setkey_() is an array of length
           64 bytes containing only the bytes with numerical value of 0 and
           1. If this string is divided into groups of 8, the low-order bit
           in each group is ignored; this gives a 56-bit key which is used by
           the algorithm. This is the key that shall be used with the
           algorithm to encode a string _block_ passed to _encrypt_().
    
           The _setkey_() function shall not change the setting of _errno_ if
           successful. An application wishing to check for error situations
           should set _errno_ to 0 before calling _setkey_().  If _errno_ is non-
           zero on return, an error has occurred.
    
           The _setkey_() function need not be thread-safe.
    


## RETURN VALUE



           No values are returned.
    


## ERRORS



           The _setkey_() function shall fail if:
    
           **ENOSYS** The functionality is not supported on this implementation.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Decoding need not be implemented in all environments. This is
           related to government restrictions in some countries on encryption
           and decryption routines. Historical practice has been to ship a
           different version of the encryption library without the decryption
           feature in the routines supplied. Thus the exported version of
           _encrypt_() does encoding but not decoding.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           A future version of the standard may mark this interface as
           obsolete or remove it altogether.
    


* * *
# gnutls_alpn_set_protocols

## NAME



           gnutls_alpn_set_protocols - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_alpn_set_protocols(gnutls_session_t** _session_**, const**
           **gnutls_datum_t ***_protocols_**, unsigned** _protocols_size_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_datum_t * protocols
                       is the protocol names to add.
    
           unsigned protocols_size
                       the number of protocols to add.
    
           unsigned int flags
                       zero or a sequence of **gnutls_alpn_flags_t**
    


## DESCRIPTION



           This function is to be used by both clients and servers, to
           declare the supported ALPN protocols, which are used during
           negotiation with peer.
    
           See **gnutls_alpn_flags_t** description for the documentation of
           available flags.
    


## RETURNS



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


* * *
# gnutls_anon_set_server_params_function

## NAME



           gnutls_anon_set_server_params_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_anon_set_server_params_function(gnutls_anon_server_credentials_t**
           _res_**, gnutls_params_function ***_func_**);**
    


## ARGUMENTS



           gnutls_anon_server_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           gnutls_params_function * func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback in order for the server to get
           the Diffie-Hellman parameters for anonymous authentication.  The
           callback should return **GNUTLS_E_SUCCESS**(0) on success.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# probe::nfs.aop.readahead

## NAME



           probe::nfs.aop.readahead - NFS client reading multiple pages
    


## SYNOPSIS



           nfs.aop.readahead
    


## VALUES



           _size_
               number of pages attempted to read in this execution
    
           _nr_pages_
               number of pages attempted to read in this execution
    
           _rsize_
               read size (in bytes)
    
           _dev_
               device identifier
    
           _ino_
               inode number
    
           _rpages_
               read size (in pages)
    
           _file_
               filp argument
    


## DESCRIPTION



           Fires when in readahead way, read several pages once
    


* * *
# probe::ioscheduler_trace.elv_completed_request

## NAME



           probe::ioscheduler_trace.elv_completed_request - Fires when a
           request is
    


## SYNOPSIS



           ioscheduler_trace.elv_completed_request
    


## VALUES



           _rq_flags_
               Request flags.
    
           _disk_major_
               Disk major no of request.
    
           _disk_minor_
               Disk minor number of request.
    
           _name_
               Name of the probe point
    
           _elevator_name_
               The type of I/O elevator currently enabled.
    
           _rq_
               Address of request.
    


## DESCRIPTION



           completed.
    


* * *
# posix_trace_eventid_open

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



           posix_trace_eventid_open — trace functions for instrumenting
           application code (**TRACING**)
    


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_eventid_open(const char *restrict _event_name_ ,
               trace_event_id_t *restrict _event_id_);
    


## DESCRIPTION



           Refer to posix_trace_event(3p).
    


* * *
# gnutls_transport_get_int

## NAME



           gnutls_transport_get_int - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Used to get the first argument of the transport function (like
           PUSH and PULL).  This must have been set using
           **gnutls_transport_set_int()**.
    


## RETURNS



           The first argument of the transport function.
    


## SINCE



           3.1.9
    


* * *
# auparse_next_record

## NAME



           auparse_next_record - move record cursor
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_next_record will move the internal library cursors to
           point to the next record of the current event. You should not call
           this function from a feed interface callback function. Doing so
           will deadlock the code. In that scenario, you should check the
           number of records in the current event with
           auparse_get_num_records and only call this if there are more
           records.
    


## RETURN VALUE



           Returns -1 if an error occurs, 0 if no more records in current
           event, or 1 for success.
    


* * *
# gnutls_crypto_register_cipher

## NAME



           gnutls_crypto_register_cipher - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_crypto_register_cipher(gnutls_cipher_algorithm_t**
           _algorithm_**, int** _priority_**, gnutls_cipher_init_func** _init_**,**
           **gnutls_cipher_setkey_func** _setkey_**, gnutls_cipher_setiv_func** _setiv_**,**
           **gnutls_cipher_encrypt_func** _encrypt_**, gnutls_cipher_decrypt_func**
           _decrypt_**, gnutls_cipher_deinit_func** _deinit_**);**
    


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is the gnutls algorithm identifier
    
           int priority
                       is the priority of the algorithm
    
           gnutls_cipher_init_func init
                       A function which initializes the cipher
    
           gnutls_cipher_setkey_func setkey
                       A function which sets the key of the cipher
    
           gnutls_cipher_setiv_func setiv
                       A function which sets the nonce/IV of the cipher
                       (non-AEAD)
    
           gnutls_cipher_encrypt_func encrypt
                       A function which performs encryption (non-AEAD)
    
           gnutls_cipher_decrypt_func decrypt
                       A function which performs decryption (non-AEAD)
    
           gnutls_cipher_deinit_func deinit
                       A function which deinitializes the cipher
    


## DESCRIPTION



           This function will register a cipher algorithm to be used by
           gnutls.  Any algorithm registered will override the included
           algorithms and by convention kernel implemented algorithms have
           priority of 90 and CPU-assisted of 80.  The algorithm with the
           lowest priority will be used by gnutls.
    
           In the case the registered init or setkey functions return
           **GNUTLS_E_NEED_FALLBACK** , GnuTLS will attempt to use the next in
           priority registered cipher.
    
           The functions which are marked as non-AEAD they are not required
           when registering a cipher to be used with the new AEAD API
           introduced in GnuTLS 3.4.0. Internally GnuTLS uses the new AEAD
           API.
    


## DEPRECATED



           since 3.7.0 it is no longer possible to override cipher
           implementation
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# probe::sunrpc.sched.release_task

## NAME



           probe::sunrpc.sched.release_task - Release all resources
           associated with a task
    


## SYNOPSIS



           sunrpc.sched.release_task
    


## VALUES



           _vers_
               the program version in the RPC call
    
           _prot_
               the IP protocol in the RPC call
    
           _prog_
               the program number in the RPC call
    
           _tk_flags_
               the flags of the task
    
           _xid_
               the transmission id in the RPC call
    


## DESCRIPTION



           **rpc_release_task** function might not be found for a particular
           kernel. So, if we can't find it, just return '-1' for everything.
    


* * *
# gnutls_db_check_entry

## NAME



           gnutls_db_check_entry - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t session_entry
                       is the session data (not key)
    


## DESCRIPTION



           This function has no effect.
    


## RETURNS



           Returns **GNUTLS_E_EXPIRED** , if the database entry has expired or 0
           otherwise.
    


## DEPRECATED



           This function is deprecated.
    


* * *
# gnutls_x509_privkey_set_spki

## NAME



           gnutls_x509_privkey_set_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_set_spki(gnutls_x509_privkey_t** _key_**, const**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    
           const gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_x509_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will return the public key information of a private
           key. The provided  _spki_ must be initialized.
    


## RETURNS



           Zero on success, or a negative error code on error.
    


* * *
# pcre2_substring_list_get

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_list_get(pcre2_match_data ***_match_data_**,**
             **PCRE2_UCHAR *****_listptr_**, PCRE2_SIZE ****_lengthsptr_**);**
    


## DESCRIPTION



    
           This is a convenience function for extracting all the captured
           substrings after a pattern match. It builds a list of pointers to
           the strings, and (optionally) a second list that contains their
           lengths (in code units), excluding a terminating zero that is
           added to each of them. All this is done in a single block of
           memory that is obtained using the same memory allocation function
           that was used to get the match data block. The convenience
           function **pcre2_substring_list_free()** can be used to free it when
           it is no longer needed. The arguments are:
    
             _match_data_    The match data block
             _listptr_       Where to put a pointer to the list
             _lengthsptr_    Where to put a pointer to the lengths, or NULL
    
           A pointer to a list of pointers is put in the variable whose
           address is in _listptr_. The list is terminated by a NULL pointer.
           If _lengthsptr_ is not NULL, a matching list of lengths is created,
           and its address is placed in _lengthsptr_. The yield of the function
           is zero on success or PCRE2_ERROR_NOMEMORY if sufficient memory
           could not be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# assert

## NAME



           assert - abort the program if assertion is false
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <assert.h>**
    
           **void assert(bool** _expression_**);**
    


## DESCRIPTION



           This macro can help programmers find bugs in their programs, or
           handle exceptional cases via a crash that will produce limited
           debugging output.
    
           If _expression_ is false (i.e., compares equal to zero), **assert**()
           prints an error message to standard error and terminates the
           program by calling abort(3).  The error message includes the name
           of the file and function containing the **assert**() call, the source
           code line number of the call, and the text of the argument;
           something like:
    
               prog: some_file.c:16: some_func: Assertion `val == 0' failed.
    
           If the macro **NDEBUG** is defined at the moment _< assert.h>_ was last
           included, the macro **assert**() generates no code, and hence does
           nothing at all.  It is not recommended to define **NDEBUG** if using
           **assert**() to detect error conditions since the software may behave
           non-deterministically.
    


## RETURN VALUE



           No value is returned.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           **assert**() is implemented as a macro; if the expression tested has
           side-effects, program behavior will be different depending on
           whether **NDEBUG** is defined.  This may create Heisenbugs which go
           away when debugging is turned on.
    


* * *
# pcre2_set_max_varlookbehind

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



    
           This sets a maximum length for the number of characters matched by
           a variable-length lookbehind assertion. The default is set when
           PCRE2 is built, with the ultimate default being 255, the same as
           Perl. Lookbehind assertions without a bounding length are not
           supported. 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.
    


* * *
# gnutls_rehandshake

## NAME



           gnutls_rehandshake - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function can only be called in server side, and instructs a
           TLS 1.2 or earlier client to renegotiate parameters (perform a
           handshake), by sending a hello request message.
    
           If this function succeeds, the calling application should call
           **gnutls_record_recv()** until **GNUTLS_E_REHANDSHAKE** is returned to
           clear any pending data. If the **GNUTLS_E_REHANDSHAKE** error code is
           not seen, then the handshake request was not followed by the peer
           (the TLS protocol does not require the client to do, and such
           compliance should be handled by the application protocol).
    
           Once the **GNUTLS_E_REHANDSHAKE** error code is seen, the calling
           application should proceed to calling **gnutls_handshake()** to
           negotiate the new parameters.
    
           If the client does not wish to renegotiate parameters he may reply
           with an alert message, and in that case the return code seen by
           subsequent **gnutls_record_recv()** will be
           **GNUTLS_E_WARNING_ALERT_RECEIVED** with the specific alert being
           **GNUTLS_A_NO_RENEGOTIATION**.  A client may also choose to ignore
           this request.
    
           Under TLS 1.3 this function is equivalent to
           **gnutls_session_key_update()** with the **GNUTLS_KU_PEER** flag. In that
           case subsequent calls to **gnutls_record_recv()** will not return
           **GNUTLS_E_REHANDSHAKE** , and calls to **gnutls_handshake()** in server
           side are a no-op.
    
           This function always fails with **GNUTLS_E_INVALID_REQUEST** when
           called in client side.
    


## RETURNS



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


* * *
# function::euid

## NAME



           function::euid - Return the effective uid of a target process
    


## SYNOPSIS



               euid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the effective user ID of the target process.
    


* * *
# mlx4dv

## NAME



           mlx4dv - Direct verbs for mlx4 devices
           This is low level access to mlx4 devices to perform data path
           operations, without general branching performed by
           ibv_post_send(3).
    


## DESCRIPTION



           The libibverbs API is an abstract one. It is agnostic to any
           underlying provider specific implementation. While this
           abstraction has the advantage of user applications portability it
           has a performance penalty. For some applications optimizing
           performance is more important than portability.
    
           The mlx4 direct verbs API is intended for such applications.  It
           exposes mlx4 specific low level data path
           (send/receive/completion) operations, allowing the application to
           bypass the libibverbs data path API.
    
           This interface consists from one hardware specific header file
           with relevant inline functions and conversion logic from ibverbs
           structures to mlx4 specific structures.
    
           The direct include of mlx4dv.h together with linkage to mlx4
           library will allow usage of this new interface.
    
           Once an application uses the direct flow the locking scheme is
           fully managed by itself. There is an expectation that no mixed
           flows in the data path for both direct/non-direct access will be
           by same application.
    


## NOTES



    


* * *
# error::pass3

## NAME



           error::pass3 - systemtap pass-3 errors
    


## DESCRIPTION



           Errors during pass 3 (translation) occur only rarely.
    
           unsupported code generation
                  Some script language constructs are not available in every
                  probe point.  For example, the _@perf()_ counter-reading
                  function may only be used in _process.*_  probes.
    


## GATHERING MORE INFORMATION



           Increasing the verbosity of pass-3 with an option such as _--vp 002_
           may help pinpoint the problem.
    


* * *
# ippevepcl

## NAME



           ippevepcl/ps - pcl and postscript print commands for ippeveprinter
    


## SYNOPSIS



           **ippevepcl**[ _filename_ ]
           **ippeveps**[ _filename_ ]
    


## DESCRIPTION



           **ippevepcl** and **ippeveps** are print commands for ippeveprinter(1).
           As with all print commands, these commands read either the
           filename specified on the command-line or from the standard input.
           Output is sent to the standard output.  Status and progress
           messages are sent to the standard error.
    
           **ippevepcl** prints to B&W HP PCL laser printers and supports
           printing of HP PCL (application/vnd.hp-pcl), PWG Raster
           (image/pwg-raster), and Apple Raster (image/urf) print files.
    
           **ippeveps** print to Adobe PostScript printers and supports printing
           of PDF (application/pdf), PostScript (application/postscript),
           JPEG (image/jpeg), PWG Raster (image/pwg-raster), and Apple Raster
           (image/urf) print files.  Printer-specific commands are read from
           a supplied PPD file.  If no PPD file is specified, generic
           commands suitable for any Level 2 or Level 3 PostScript printer
           are used instead to specify duplex printing and media size.
    


## EXIT STATUS



           These programs return 1 on error and 0 on success.
    


## ENVIRONMENT



           These program inherit the environment provided by the
           **ippeveprinter** program.
    


* * *
# libdpkg

## NAME



           libdpkg - Debian package manager C library
    


## DESCRIPTION



           The **libdpkg** C library provides functions and infrastructure for
           the dpkg tool set, and external projects that need to integrate
           tightly with it.
    
           The library provides a **pkgconf**(1) entry named _libdpkg_.
    
           **Warning** : The API provided by this library is highly volatile,
           still in the process of being cleaned up. It is only supposed to
           be used internally by dpkg for now. Header files, functions,
           variables and types might get renamed, removed or change
           semantics. If you still have a need to use it, which you would be
           doing anyway, say by locally building dpkg to get the library,
           then define the C preprocessor macro LIBDPKG_VOLATILE_API in your
           build to acknowledge that fact.
    
           Due to the currently API volatility, only a static library is
           provided.
    


* * *