tripathysagar/man_text huggingface dataset:
# gnutls_x509_crl_get_extension_data

## NAME



           gnutls_x509_crl_get_extension_data - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_extension_data(gnutls_x509_crl_t** _crl_**,**
           **unsigned** _indx_**, void ***_data_**, size_t ***_sizeof_data_**);**
    


## 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 * data a pointer to a structure to hold the data (may be
                       null)
    
           size_t * sizeof_data
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the requested extension data in the CRL.
           The extension data will be stored as a string in the provided
           buffer.
    
           Use **gnutls_x509_crl_get_extension_info()** to extract the OID and
           critical flag.  Use **gnutls_x509_crl_get_extension_info()** instead,
           if you want to get data indexed by the extension OID rather than
           sequence.
    


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


* * *
# gnutls_auth_get_type

## NAME



           gnutls_auth_get_type - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_credentials_type_t gnutls_auth_get_type(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns type of credentials for the current authentication schema.
           The returned information is to be used to distinguish the function
           used to access authentication data.
    
           Eg. for CERTIFICATE ciphersuites (key exchange algorithms:
           **GNUTLS_KX_RSA** , **GNUTLS_KX_DHE_RSA**), the same function are to be
           used to access the authentication data.
    
           Note that on resumed sessions, this function returns the schema
           used in the original session authentication.
    


## RETURNS



           The type of credentials for the current authentication schema, a
           **gnutls_credentials_type_t** type.
    


* * *
# ibv_get_device_index

## NAME



           ibv_get_device_index - get an RDMA device index
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_get_device_index(struct ibv_device *device);
    


## DESCRIPTION



           **ibv_get_device_index()** returns stable IB device index as it is
           assigned by the kernel.
    


## RETURN VALUE



           **ibv_get_device_index()** returns an index, or -1 if the kernel
           doesn’t support device indexes.
    


* * *
# gsignal

## NAME



           gsignal, ssignal - software signal facility
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **typedef typeof(void (int))  *sighandler_t;**
    
           **[[deprecated]] int gsignal(int** _signum_**);**
    
           **[[deprecated]] sighandler_t ssignal(int** _signum_**, sighandler_t** _action_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **gsignal**(), **ssignal**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _SVID_SOURCE
    


## DESCRIPTION



           Don't use these functions under Linux.  Due to a historical
           mistake, under Linux these functions are aliases for raise(3) and
           signal(2), respectively.
    
           Elsewhere, on System V-like systems, these functions implement
           software signaling, entirely independent of the classical
           signal(2) and kill(2) functions.  The function **ssignal**() defines
           the action to take when the software signal with number _signum_ is
           raised using the function **gsignal**(), and returns the previous such
           action or **SIG_DFL**.  The function **gsignal**() does the following: if
           no action (or the action **SIG_DFL**) was specified for _signum_ , then
           it does nothing and returns 0.  If the action **SIG_IGN** was
           specified for _signum_ , then it does nothing and returns 1.
           Otherwise, it resets the action to **SIG_DFL** and calls the action
           function with argument _signum_ , and returns the value returned by
           that function.  The range of possible values _signum_ varies (often
           1–15 or 1–17).
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# curs_add_wchstr

## NAME



           **add_wchstr** , **add_wchnstr** , **wadd_wchstr** , **wadd_wchnstr** , **mvadd_wchstr** ,
           **mvadd_wchnstr** , **mvwadd_wchstr** , **mvwadd_wchnstr** - add an array of
           complex characters (and attributes) to a curses window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int add_wchstr(const cchar_t ***_wchstr_**);**
           **int add_wchnstr(const cchar_t ***_wchstr_**, int** _n_**);**
           **int wadd_wchstr(WINDOW ***_win_**, const cchar_t ***_wchstr_**);**
           **int wadd_wchnstr(WINDOW ***_win_**, const cchar_t ***_wchstr_**, int** _n_**);**
    
           **int mvadd_wchstr(int** _y_**, int** _x_**, const cchar_t ***_wchstr_**);**
           **int mvadd_wchnstr(int** _y_**, int** _x_**, const cchar_t ***_wchstr_**, int** _n_**);**
           **int mvwadd_wchstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const cchar_t ***_wchstr_**);**
           **int mvwadd_wchnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const cchar_t ***_wchstr_**, int** _n_**);**
    


## DESCRIPTION



           These  functions copy the (null-terminated) array of complex char‐
           acters _wchstr_ into the window image structure starting at the cur‐
           rent cursor position.  The four functions with _n_ as the last argu‐
           ment copy at most _n_ elements, but no more than  will  fit  on  the
           line.  If **n** =**-1** then the whole array is copied, to the maximum num‐
           ber of characters that will fit on the line.
    
           The  window  cursor  is _not_ advanced.  These functions work faster
           than **waddnstr**.  On the other hand:
    
           •   they do not perform checking (such as for the newline, back‐
               space, or carriage return characters),
    
           •   they do not advance the current cursor position,
    
           •   they do not expand other control characters to ^-escapes, and
    
           •   they truncate the string if it crosses the right margin,
               rather than wrapping it around to the new line.
    
           These functions end successfully on encountering a null **cchar_t** ,
           or when they have filled the current line.  If a complex character
           cannot completely fit at the end of the current line, the remain‐
           ing columns are filled with the background character and rendi‐
           tion.
    


## RETURN VALUE



           All functions return the integer **ERR** upon failure and **OK** on suc‐
           cess.
    
           X/Open does not define any error conditions.  This implementation
           returns an error if the window pointer is null.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


## NOTES



           All functions except **wadd_wchnstr** may be macros.
    


## PORTABILITY



           These entry points are described in the XSI Curses standard, Issue
           4.
    


* * *
# gnutls_encode_gost_rs_value

## NAME



           gnutls_encode_gost_rs_value - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_encode_gost_rs_value(gnutls_datum_t ***_sig_value_**, const**
           **gnutls_datum_t ***_r_**, const gnutls_datum_t ***_s_**);**
    


## ARGUMENTS



           gnutls_datum_t * sig_value
                       will hold a GOST signature according to RFC 4491
                       section 2.2.2
    
           const gnutls_datum_t * r
                       must contain the r value
    
           const gnutls_datum_t * s
                       must contain the s value
    


## DESCRIPTION



           This function will encode the provided r and s values, into binary
           representation according to RFC 4491 section 2.2.2, used for GOST
           R 34.10-2001 (and thus also for GOST R 34.10-2012) signatures.
    
           The output value should be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# pcre2_serialize_encode

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int32_t pcre2_serialize_encode(const pcre2_code ****_codes_**,**
             **int32_t** _number_of_codes_**, uint8_t ****_serialized_bytes_**,**
             **PCRE2_SIZE ***_serialized_size_**, pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function encodes a list of compiled patterns into a byte
           stream that can be saved on disc or elsewhere. Note that this is
           not an abstract format like Java or .NET. Conversion of the byte
           stream back into usable compiled patterns can only happen on a
           host that is running the same version of PCRE2, with the same code
           unit width, and the host must also have the same endianness,
           pointer width and PCRE2_SIZE type. The arguments for
           **pcre2_serialize_encode()** are:
    
             _codes_             pointer to a vector containing the list
             _number_of_codes_   number of slots in the vector
             _serialized_bytes_  set to point to the serialized byte stream
             _serialized_size_   set to the number of bytes in the byte stream
             _gcontext_          pointer to a general context or NULL
    
           The context argument is used to obtain memory for the byte stream.
           When the serialized data is no longer needed, it must be freed by
           calling **pcre2_serialize_free()**. The yield of the function is the
           number of serialized patterns, or one of the following negative
           error codes:
    
             PCRE2_ERROR_BADDATA      _number_of_codes_ is zero or less
             PCRE2_ERROR_BADMAGIC     mismatch of id bytes in one of the
           patterns
             PCRE2_ERROR_MEMORY       memory allocation failed
             PCRE2_ERROR_MIXEDTABLES  the patterns do not all use the same
           tables
             PCRE2_ERROR_NULL         an argument other than _gcontext_ is NULL
    
           PCRE2_ERROR_BADMAGIC means either that a pattern's code has been
           corrupted, or that a slot in the vector does not point to a
           compiled pattern.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the serialization functions in
           the **pcre2serialize** page.
    


* * *
# keyctl_join_session_keyring

## NAME



           keyctl_join_session_keyring - join a different session keyring
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **key_serial_t keyctl_join_session_keyring(const char ***_name_**);**
    


## DESCRIPTION



           **keyctl_join_session_keyring**() changes the session keyring to which
           a process is subscribed.
    
           If _name_ is **NULL** then a new anonymous keyring will be created, and
           the process will be subscribed to that.
    
           If _name_ points to a string, then if a keyring of that name is
           available, the process will attempt to subscribe to that keyring,
           giving an error if that is not permitted; otherwise a new keyring
           of that name is created and attached as the session keyring.
    
           To attach to an extant named keyring, the keyring must have **search**
           permission available to the calling process.
    


## RETURN VALUE



           On success **keyctl_join_session_keyring**() returns the serial number
           of the key it found or created.  On error, the value **-1** will be
           returned and _errno_ will have been set to an appropriate error.
    


## ERRORS



           **ENOMEM** Insufficient memory to create a key.
    
           **EDQUOT** The key quota for this user would be exceeded by creating
                  this key or linking it to the keyring.
    
           **EACCES** The named keyring exists, but is not **searchable** 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.
    


* * *
# strchr

## NAME



           strchr, strrchr, strchrnul - locate character in string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **char *strchr(const char ***_s_**, int** _c_**);**
           **char *strrchr(const char ***_s_**, int** _c_**);**
    
           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <string.h>**
    
           **char *strchrnul(const char ***_s_**, int** _c_**);**
    


## DESCRIPTION



           The **strchr**() function returns a pointer to the first occurrence of
           the character _c_ in the string _s_.
    
           The **strrchr**() function returns a pointer to the last occurrence of
           the character _c_ in the string _s_.
    
           The **strchrnul**() function is like **strchr**() except that if _c_ is not
           found in _s_ , then it returns a pointer to the null byte at the end
           of _s_ , rather than NULL.
    
           Here "character" means "byte"; these functions do not work with
           wide or multibyte characters.
    


## RETURN VALUE



           The **strchr**() and **strrchr**() functions return a pointer to the
           matched character or NULL if the character is not found.  The
           terminating null byte is considered part of the string, so that if
           _c_ is specified as '\0', these functions return a pointer to the
           terminator.
    
           The **strchrnul**() function returns a pointer to the matched
           character, or a pointer to the null byte at the end of _s_ (i.e.,
           _s+strlen(s)_) if the character is not found.
    


## ATTRIBUTES



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


## STANDARDS



           **strchr**()
           **strrchr**()
                  C11, POSIX.1-2008.
    
           **strchrnul**()
                  GNU.
    


* * *
# auparse_get_field_str

## NAME



           auparse_get_field_str - get current field's value
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_field_str allows access to the value in the current
           field of the current record in the current event.
    


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, a pointer to the
           field's value.
    


* * *
# gnutls_x509_crq_get_attribute_info

## NAME



           gnutls_x509_crq_get_attribute_info - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_attribute_info(gnutls_x509_crq_t** _crq_**,**
           **unsigned** _indx_**, void ***_oid_**, size_t ***_sizeof_oid_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned indx
                       Specifies which attribute number to get. Use (0) to
                       get the first one.
    
           void * oid  a pointer to a structure to hold the OID
    
           size_t * sizeof_oid
                       initially holds the maximum size of  _oid_ , on return
                       holds actual size of  _oid_ .
    


## DESCRIPTION



           This function will return the requested attribute OID in the
           certificate, and the critical flag for it.  The attribute OID will
           be stored as a string in the provided buffer.  Use
           **gnutls_x509_crq_get_attribute_data()** to extract the data.
    
           If the buffer provided is not long enough to hold the output, then
           * _sizeof_oid_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** will be
           returned.
    


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


* * *
# dane_verification_status_print

## NAME



           dane_verification_status_print - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_verification_status_print(unsigned int** _status_**,**
           **gnutls_datum_t ***_out_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           unsigned int status
                       The status flags to be printed
    
           gnutls_datum_t * out
                       Newly allocated datum with (0) terminated string.
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will pretty print the status of a verification
           process -- eg. the one obtained by **dane_verify_crt()**.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


* * *
# mmv_inc_value

## NAME



           **mmv_inc** , **mmv_inc_value** , **mmv_inc_atomvalue** - update a value in a
           Memory Mapped Value file
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/mmv_stats.h>**
    
           **void mmv_inc_value(void ***_addr_**, pmAtomValue ***_av_**, double** _inc_**);**
           **void mmv_inc_atomvalue(void ***_addr_**, pmAtomValue ***_av_**,**
                                  **pmAtomValue ***_inc_**);**
    
           **cc ... -lpcp_mmv -lpcp**
    


## DESCRIPTION



           **mmv_inc_value** and **mmv_inc_atomvalue** provide convenient ways of up‐
           dating    a    metric    _av_    previously    returned    by    the
           mmv_lookup_value_desc(3) interface.  _addr_ is the address  returned
           from mmv_stats_init(3).
    
           These interfaces are most commonly used with counter type metrics.
           Refer  to mmv_set_value(3) for a mechanism suited to instantaneous
           and discrete metrics.
    
           With **mmv_inc_atomvalue** the value provided via the _inc_ pointer must
           match the type of the metric, and will be added  to  the  previous
           value of the metric.
    
           In  the  case of **mmv_inc_value** the value of _inc_ is internally cast
           to match the type of the metric and then  added  to  the  previous
           value of the metric.
    


* * *
# tapset::logging

## NAME



           tapset::logging - systemtap logging tapset
    


## DESCRIPTION



           **log** Send a line to the common trace buffer
    
                  See function::log(3stap)
                   for details.
    
           **warn** Send a line to the warning stream
    
                  See function::warn(3stap)
                   for details.
    
           **exit** Start shutting down probing script.
    
                  See function::exit(3stap)
                   for details.
    
           **abort** Immediately shutting down probing script.
    
                  See function::abort(3stap)
                   for details.
    
           **error** Send an error message
    
                  See function::error(3stap)
                   for details.
    
           **assert** evaluate assertion
    
                  See function::assert(3stap)
                   for details.
    
           **assert** evaluate assertion
    
                  See function::assert(3stap)
                   for details.
    
           **ftrace** Send a message to the ftrace ring-buffer
    
                  See function::ftrace(3stap)
                   for details.
    
           **printk** Send a message to the kernel trace buffer
    
                  See function::printk(3stap)
                   for details.
    
           **dump_stack**
                  Send the kernel backtrace to the kernel trace buffer
    
                  See function::dump_stack(3stap)
                   for details.
    


* * *
# putgrent

## NAME



           putgrent - write a group database entry to a file
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <grp.h>**
    
           **int putgrent(const struct group *restrict** _grp_**, FILE *restrict** _stream_**);**
    


## DESCRIPTION



           The **putgrent**() function is the counterpart for fgetgrent(3).  The
           function writes the content of the provided _struct group_ into the
           _stream_.  The list of group members must be NULL-terminated or
           NULL-initialized.
    
           The _struct group_ is defined as follows:
    
               struct group {
                   char   *gr_name;      /* group name */
                   char   *gr_passwd;    /* group password */
                   gid_t   gr_gid;       /* group ID */
                   char  **gr_mem;       /* group members */
               };
    


## RETURN VALUE



           The function returns zero on success, and a nonzero value on
           error.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


* * *
# ausearch_clear

## NAME



           ausearch_clear - clear search parameters
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **void ausearch_clear(auparse_state_t ***_au);"_
    


## DESCRIPTION



           ausearch_clear clears any search parameters stored in the parser
           instance and frees memory associated with it.
    


## RETURN VALUE



           None.
    


* * *
# pmlookupindom

## NAME



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


## C SYNOPSIS



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


## DESCRIPTION



           For  the instance domain _indom_ , in the current Performance Metrics
           Application Programming Interface (PMAPI) context, locate the  in‐
           stance  with the external identification given by _name_ , and return
           the internal instance identifier.
    
           Only the leading non-space characters of  _name_  will  be  used  to
           identify the instance.
    
           The  value  for  the  instance domain _indom_ is typically extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           **pmLookupInDom** will return a positive instance identifier  on  suc‐
           cess.
    


## DIAGNOSTICS



           **PM_ERR_INDOM**
                  _indom_ is not a valid instance domain identifier
    
           **PM_ERR_INST**
                  The external instance _name_ is not known for the instance
                  domain _indom_ in the current PMAPI context
    


* * *
# probe::socket.writev

## NAME



           probe::socket.writev - Message sent via **socket_writev**
    


## SYNOPSIS



           socket.writev
    


## VALUES



           _flags_
               Socket flags value
    
           _protocol_
               Protocol value
    
           _name_
               Name of this probe
    
           _size_
               Message size in bytes
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _family_
               Protocol family value
    


## CONTEXT



           The message sender
    


## DESCRIPTION



           Fires at the beginning of sending a message on a socket via the
           **sock_writev** function
    


* * *
# sd_varlink_set_description

## NAME



           sd_varlink_set_description, sd_varlink_get_description - Set or
           query description of a Varlink connection object
    


## SYNOPSIS



           **#include <systemd/sd-varlink.h>**
    
           **int sd_varlink_set_description(sd_varlink ***_link_**,**
                                          **const char ***_description_**);**
    
           **const char* sd_varlink_get_description(sd_varlink ***_link_**);**
    


## DESCRIPTION



           **sd_varlink_set_description()** sets the description string that is
           used in logging to the specified string. The string is copied
           internally and freed when the Varlink connection object is
           deallocated. The _description_ argument may be **NULL** , in which case
           the description is unset.
    
           **sd_varlink_get_description()** returns a description string for the
           specified Varlink connection. This string may have been previously
           set with **sd_varlink_set_description()**. If not set this way, a
           default string or **NULL** may be returned, depending how the
           connection was allocated and set up.
    


## RETURN VALUE



           On success, **sd_varlink_set_description()** returns a non-negative
           integer. On failure, it returns a negative errno-style error code.
           **sd_varlink_get_description()** returns either **NULL** or a pointer to
           the description string.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               An argument is invalid.
    
           **-ENOMEM**
               Memory allocation failed.
    


## NOTES



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


* * *
# pmfetcharchive

## NAME



           **pmFetchArchive** , - get performance metric values directly from
           archives
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmFetchArchive(pmResult ****_result_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  **pmFetchArchive** API  is a variant of the pmFetch(3) interface
           that may only be used when the current Performance Metrics  Appli‐
           cation  Programming Interface (PMAPI) context is associated with a
           set of archives.
    
           The _result_ is instantiated with all of the metrics (and instances)
           from the next archive record, consequently there is no notion of a
           list of desired metrics, and the instance  profile  of  the  PMAPI
           context is ignored.
    
           **pmFetchArchive** may return a _result_ in which _numpmid_ is zero.  This
           is  a _< mark>_ record that indicates a temporal discontinuity in the
           time series of performance metrics.  This can happen at the bound‐
           ary between archives in a set or if the  archive  associated  with
           the  current  PMAPI  context  was created using pmlogextract(1) to
           concatenate two or more PCP archives, and the _< mark>_ record  marks
           a point in time between the end of one input archive and the start
           of the next input archive.
    
           It  is  expected that **pmFetchArchive** will be used to create utili‐
           ties that scan sets of archives, while the more common  access  to
           the archives would be via the **pmFetch** interface.
    
           To  skip  records  within the set of archives, use pmSetMode(3) to
           change the collection time within the current PMAPI context,  then
           call either **pmFetchArchive**
    
           Note that the _result_ returned by **pmFetchArchive** is dynamically al‐
           located,  and  must  be  released  using  pmFreeResult(3), but not
           free(3).  See pmFetch(3), and pmFreeResult(3) for further details.
    
           **pmFetchArchive** returns zero on success.
    


## DIAGNOSTICS



           **PM_ERR_NOTARCHIVE**
                  the current PMAPI context is not associated with a set of
                  archives
    


## COMPATIBILITY



           Prior to PCP 7.0 the _timestamp_ field in the pmResult struct was a
           struct timeval.  To support PMAPI transition, the old interface
           and semantics can be used if applications are recompiled with
           **-DPMAPI_VERSION=2**.
    
           For a time in PCP 6.x there was a routine with the same semantics
           as the current **pmFetchArchive** called **pmFetchHighResArchive** , and a
           struct with the same definition as the current pmResult struct
           called pmResultHighRes, although both are now deprecated and com‐
           pile-time support for **pmFetchHighResArchive** and pmResultHighRes
           will be removed in a future release.
    


* * *
# div

## NAME



           div, ldiv, lldiv, imaxdiv - compute quotient and remainder of an
           integer division
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **div_t div(int** _numerator_**, int** _denominator_**);**
           **ldiv_t ldiv(long** _numerator_**, long** _denominator_**);**
           **lldiv_t lldiv(long long** _numerator_**, long long** _denominator_**);**
    
           **#include <inttypes.h>**
    
           **imaxdiv_t imaxdiv(intmax_t** _numerator_**, intmax_t** _denominator_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **lldiv**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           The **div**() function computes the value _numerator/denominator and_
           returns the quotient and remainder in a structure named _div_t_ that
           contains two integer members (in unspecified order) named _quot_ and
           _rem_.  The quotient is rounded toward zero.  The result satisfies
           _quot*denominator+rem = numerator_.
    
           The **ldiv**(), **lldiv**(), and **imaxdiv**() functions do the same, dividing
           numbers of the indicated type and returning the result in a
           structure of the indicated name, in all cases with fields _quot_ and
           _rem_ of the same type as the function arguments.
    


## RETURN VALUE



           The _div_t_ (etc.) structure.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## EXAMPLES



           After
    
               div_t q = div(-5, 3);
    
           the values _q.quot_ and _q.rem_ are -1 and -2, respectively.
    


* * *
# gnutls_certificate_verification_profile_get_id

## NAME



           gnutls_certificate_verification_profile_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **gnutls_certificate_verification_profiles_t**
           **gnutls_certificate_verification_profile_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a profile name
    


## DESCRIPTION



           Convert a string to a **gnutls_certificate_verification_profiles_t**
           value.  The names are compared in a case insensitive way.
    


## RETURNS



           a **gnutls_certificate_verification_profiles_t** id of the specified
           profile, or **GNUTLS_PROFILE_UNKNOWN** on failure.
    


* * *
# gnutls_x509_ext_export_tlsfeatures

## NAME



           gnutls_x509_ext_export_tlsfeatures - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_tlsfeatures(gnutls_x509_tlsfeatures_t**
           _f_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           gnutls_x509_tlsfeatures_t f
                       The features structure
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the provided TLS features structure
           structure to a DER-encoded TLS features PKIX extension. The output
           data in  _ext_ will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# copysign

## NAME



           copysign, copysignf, copysignl - copy sign of a number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double copysign(double** _x_**, double** _y_**);**
           **float copysignf(float** _x_**, float** _y_**);**
           **long double copysignl(long double** _x_**, long double** _y_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **copysign**(), **copysignf**(), **copysignl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return a value whose absolute value matches that
           of _x_ , but whose sign bit matches that of _y_.
    
           For example, _copysign(42.0, -1.0)_ and _copysign(-42.0, -1.0)_ both
           return -42.0.
    


## RETURN VALUE



           On success, these functions return a value whose magnitude is
           taken from _x_ and whose sign is taken from _y_.
    
           If _x_ is a NaN, a NaN with the sign bit of _y_ is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## VERSIONS



           On architectures where the floating-point formats are not IEEE 754
           compliant, these functions may treat a negative zero as positive.
    


## STANDARDS



           C11, POSIX.1-2008.
    
           This function is defined in IEC 559 (and the appendix with
           recommended functions in IEEE 754/IEEE 854).
    


* * *
# probe::vm.munmap

## NAME



           probe::vm.munmap - Fires when an munmap is requested
    


## SYNOPSIS



           vm.munmap
    


## VALUES



           _length_
               the length of the memory segment
    
           _address_
               the requested address
    
           _name_
               name of the probe point
    


## CONTEXT



           The process calling munmap.
    


* * *
# gnutls_pkcs7_delete_crl

## NAME



           gnutls_pkcs7_delete_crl - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_delete_crl(gnutls_pkcs7_t** _pkcs7_**, int** _indx_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           int indx    the index of the crl to delete
    


## DESCRIPTION



           This function will delete a crl from a PKCS7 or RFC2630 crl set.
           Index starts from 0. Returns 0 on success.
    


## RETURNS



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


* * *
# gnutls_x509_crt_set_extension_by_oid

## NAME



           gnutls_x509_crt_set_extension_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_extension_by_oid(gnutls_x509_crt_t** _crt_**,**
           **const char ***_oid_**, const void ***_buf_**, size_t** _sizeof_buf_**, unsigned**
           **int** _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const char * oid
                       holds an Object Identifier in null terminated string
    
           const void * buf
                       a pointer to a DER encoded data
    
           size_t sizeof_buf
                       holds the size of  _buf_
    
           unsigned int critical
                       should be non-zero if the extension is to be marked as
                       critical
    


## DESCRIPTION



           This function will set an the extension, by the specified OID, in
           the certificate.  The extension data should be binary data DER
           encoded.
    


## RETURNS



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


* * *
# gnutls_x509_trust_list_add_trust_file

## NAME



           gnutls_x509_trust_list_add_trust_file - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_add_trust_file(gnutls_x509_trust_list_t**
           _list_**, const char ***_ca_file_**, const char ***_crl_file_**,**
           **gnutls_x509_crt_fmt_t** _type_**, unsigned int** _tl_flags_**, unsigned int**
           _tl_vflags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const char * ca_file
                       A file containing a list of CAs (optional)
    
           const char * crl_file
                       A file containing a list of CRLs (optional)
    
           gnutls_x509_crt_fmt_t type
                       The format of the certificates
    
           unsigned int tl_flags
                       flags from **gnutls_trust_list_flags_t**
    
           unsigned int tl_vflags
                       gnutls_certificate_verify_flags if flags specifies
                       GNUTLS_TL_VERIFY_CRL
    


## DESCRIPTION



           This function will add the given certificate authorities to the
           trusted list. PKCS **11** URLs are also accepted, instead of files, by
           this function. A PKCS **11** URL implies a trust database (a specially
           marked module in p11-kit); the URL "pkcs11:" implies all trust
           databases in the system. Only a single URL specifying trust
           databases can be set; they cannot be stacked with multiple calls.
    


## RETURNS



           The number of added elements is returned.
    


## SINCE



           3.1
    


* * *
# function::user_int8

## NAME



           function::user_int8 - Retrieves a 8-bit integer value stored in
           user space
    


## SYNOPSIS



               user_int8:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the 8-bit integer from
    


## DESCRIPTION



           Returns the 8-bit integer value from a given user space address.
           Returns zero when user space data is not accessible.
    


* * *
# pmtimeval

## NAME



           **pmtimevalNow** , **pmtimevalInc** , **pmtimevalDec** , **pmtimevalAdd** ,
           **pmtimevalSub** , **pmtimevalToReal** , **pmtimevalFromReal** ,
           **pmtimevalTotimespec** , **pmtimevalPrint** - helper routines for time
           stored as a struct timeval
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmtimevalNow(struct timeval ***_tv_**);**
           **void pmtimevalInc(struct timeval ***_ap_**, const struct timeval ***_bp_**);**
           **void pmtimevalDec(struct timeval ***_ap_**, const struct timeval ***_bp_**);**
           **double pmtimevalAdd(const struct timeval ***_ap_**,**
                               **const struct timeval ***_bp_**);**
           **double pmtimevalSub(const struct timeval ***_ap_**,**
                               **const struct timeval ***_bp_**);**
           **double pmtimevalToReal(const struct timeval ***_val_**);**
           **void pmtimevalFromReal(double** _secs_**, struct timeval ***_val_**);**
           **void pmtimevalTotimespec(struct timeval ***_tvp_**, struct timespec**
           *****_tsp_**);**
           **void pmtimevalPrint(FILE ***_f_**, const struct timeval ***_tp_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmtimevalNow** is  a  platform-independent  method that returns the
           current system time since the Epoch in _tv_.
    
           **pmtimevalInc** adds the time in _ap_ to the time in _bp_ and stores  the
           result  in  _ap_.   Similarly  **pmtimevalDec** subtracts the time in _bp_
           from the time in _ap_ and stores the result in _ap_.
    
           **pmtimevalAdd**(and **pmtimevalSub**) add (and subtract) times  and  re‐
           turn the result as a double value.  The time in the _ap_ argument is
           not changed.
    
           **pmtimevalToReal** converts  the  time in _tp_ to an equivalent double
           value.  **pmtimevalFromReal** provides the reverse conversion,  taking
           the time in _secs_ and returning the equivalent time in _val_.
    
           **pmtimevalTotimespec** converts the struct timeval _tvp_ into an equiv‐
           alent  struct  timespec  _tsp_  (modulo  rounding microseconds up to
           nanoseconds).
    
           **pmtimevalPrint** prints the timestamp from _tp_ on the stream _f_ in the
           local  time  (as  returned  by  pmLocaltime(3))  in   the   format
           HH:MM:SS.XXX.
    


## NOTES



           For  variants  of  these interfaces using nanosecond precision and
           the timespec structure, refer to pmtimespecNow(3).
    


## COMPATIBILITY



           Prior to  PCP  7.0  the  routine  **pmtimevalPrint** was  called  **pm‐**
           **PrintStamp**.   To  support  PMAPI  transition,  the old routine can
           still be used if applications  are  recompiled  with  **-DPMAPI_VER‐**
           **SION=2**.
    
           **pmPrintStamp** is  now deprecated and compile-time support for this
           routine name will be removed in a future release.
    


* * *
# gnutls_x509_crt_set_crl_dist_points2

## NAME



           gnutls_x509_crt_set_crl_dist_points2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_crl_dist_points2(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_subject_alt_name_t** _type_**, const void ***_data_**, unsigned**
           **int** _data_size_**, unsigned int** _reason_flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_subject_alt_name_t type
                       is one of the gnutls_x509_subject_alt_name_t
                       enumerations
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The data size
    
           unsigned int reason_flags
                       revocation reasons
    


## DESCRIPTION



           This function will set the CRL distribution points certificate
           extension.
    


## RETURNS



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


## SINCE



           2.6.0
    


* * *