tripathysagar/man_text huggingface dataset:
# gnutls_x509_privkey_import_gost_raw

## NAME



           gnutls_x509_privkey_import_gost_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_gost_raw(gnutls_x509_privkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, gnutls_digest_algorithm_t** _digest_**,**
           **gnutls_gost_paramset_t** _paramset_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**, const gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           gnutls_digest_algorithm_t digest
                       will hold the digest
    
           gnutls_gost_paramset_t paramset
                       will hold the GOST parameter set ID
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    
           const gnutls_datum_t * k
                       holds the k (private key)
    


## DESCRIPTION



           This function will convert the given GOST private key's parameters
           to the native **gnutls_x509_privkey_t** format.  The output will be
           stored in  _key_ .   _digest_ should be one of GNUTLS_DIG_GOSR_94,
           GNUTLS_DIG_STREEBOG_256 or GNUTLS_DIG_STREEBOG_512.  If  _paramset_
           is set to GNUTLS_GOST_PARAMSET_UNKNOWN default one will be
           selected depending on
            _digest_ .
    


## NOTE



           parameters should be stored with least significant byte first. On
           version 3.6.3 big-endian format was used incorrectly.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# bsd_signal

## NAME



           bsd_signal - signal handling with BSD semantics
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **typedef typeof(void (int))  *sighandler_t;**
    
           **sighandler_t bsd_signal(int** _signum_**, sighandler_t** _handler_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **bsd_signal**():
               Since glibc 2.26:
                   _XOPEN_SOURCE >= 500
                       && ! (_POSIX_C_SOURCE >= 200809L)
               glibc 2.25 and earlier:
                   _XOPEN_SOURCE
    


## DESCRIPTION



           The **bsd_signal**() function takes the same arguments, and performs
           the same task, as signal(2).
    
           The difference between the two is that **bsd_signal**() is guaranteed
           to provide reliable signal semantics, that is: a) the disposition
           of the signal is not reset to the default when the handler is
           invoked; b) delivery of further instances of the signal is blocked
           while the signal handler is executing; and c) if the handler
           interrupts a blocking system call, then the system call is
           automatically restarted.  A portable application cannot rely on
           signal(2) to provide these guarantees.
    


## RETURN VALUE



           The **bsd_signal**() function returns the previous value of the signal
           handler, or **SIG_ERR** on error.
    


## ERRORS



           As for signal(2).
    


## ATTRIBUTES



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


## VERSIONS



           Use of **bsd_signal**() should be avoided; use sigaction(2) instead.
    
           On modern Linux systems, **bsd_signal**() and signal(2) are
           equivalent.  But on older systems, signal(2) provided unreliable
           signal semantics; see signal(2) for details.
    
           The use of _sighandler_t_ is a GNU extension; this type is defined
           only if the **_GNU_SOURCE** feature test macro is defined.
    


## STANDARDS



           None.
    


* * *
# function::get_loadavg_index

## NAME



           function::get_loadavg_index - Get the load average for a specified
           interval
    


## SYNOPSIS



               get_loadavg_index:long(indx:long)
    


## ARGUMENTS



           _indx_
               The load average interval to capture.
    


## DESCRIPTION



           This function returns the load average at a specified interval.
           The three load average values 1, 5 and 15 minute average
           corresponds to indexes 0, 1 and 2 of the avenrun array - see
           linux/sched.h. Please note that the truncated-integer portion of
           the load average is returned. If the specified index is
           out-of-bounds, then an error message and exception is thrown.
    


* * *
# function::htonll

## NAME



           function::htonll - Convert 64-bit long long from host to network
           order
    


## SYNOPSIS



               htonll:long(x:long)
    


## ARGUMENTS



           _x_
               Value to convert
    


* * *
# intro

## NAME



           intro - C/C++ attributes
    


## SYNOPSIS



           **[[**_attr_**]]**
           **[[**_vendor_**::**_attr_**]]**
    


## DESCRIPTION



           Attributes modify the properties of a source construct, such as a
           type, a variable, or a function.
    
           The standard syntax allows specifying a _vendor_ for non-standard
           attributes.
    


## VERSIONS



           C and C++ dialects have provided various forms of attributes
           before standardization.
    
           **__attribute__((**_attr_**))**
                  This is the GNU syntax for attributes.  It is supported by
                  both GCC and Clang.
    
           **__declspec(**_attr_**)**
                  This is the MSVC syntax for attributes.  It is supported by
                  Clang.
    


## STANDARDS



           C23, C++23.
    


* * *
# gnutls_certificate_set_ocsp_status_request_file

## NAME



           gnutls_certificate_set_ocsp_status_request_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_ocsp_status_request_file(gnutls_certificate_credentials_t**
           _sc_**, const char ***_response_file_**, unsigned** _idx_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a credentials structure.
    
           const char * response_file
                       a filename of the OCSP response
    
           unsigned idx
                       is a certificate index as returned by
                       **gnutls_certificate_set_key()** and friends
    


## DESCRIPTION



           This function loads the provided OCSP response. It will be sent to
           the client if requests an OCSP certificate status for the
           certificate chain specified by  _idx_ .
    


## NOTE



           the ability to set multiple OCSP responses per credential
           structure via the index  _idx_ was added in version 3.5.6. To keep
           backwards compatibility, it requires using
           **gnutls_certificate_set_flags()** with the **GNUTLS_CERTIFICATE_API_V2**
           flag to make the set certificate functions return an index usable
           by this function.
    
           This function can be called multiple times since GnuTLS 3.6.3 when
           multiple responses which apply to the chain are available.  If the
           response provided does not match any certificates present in the
           chain, the code **GNUTLS_E_OCSP_MISMATCH_WITH_CERTS** is returned.  To
           revert to the previous behavior set the flag
           **GNUTLS_CERTIFICATE_SKIP_OCSP_RESPONSE_CHECK** in the certificate
           credentials structure. In that case, only the end-certificate's
           OCSP response can be set.  If the response is already expired at
           the time of loading the code **GNUTLS_E_EXPIRED** is returned.
    
           To revert to the previous behavior of this function which does not
           return any errors, set the flag
           **GNUTLS_CERTIFICATE_SKIP_OCSP_RESPONSE_CHECK**
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# pcre2_set_offset_limit

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



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


* * *
# function::proc_mem_string

## NAME



           function::proc_mem_string - Human readable string of process
           memory usage
    


## SYNOPSIS



           1) proc_mem_string:string()
    
           2) proc_mem_string:string(pid:long)
    


## ARGUMENTS



           _pid_
               The pid of process to examine
    


## DESCRIPTION



           1) Returns a human readable string showing the size, rss, shr, txt
           and data of the memory used by the current process. For
           example“size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k”.
    
           2) Returns a human readable string showing the size, rss, shr, txt
           and data of the memory used by the given process. For
           example“size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k”.
    


* * *
# tapset::context-envvar

## NAME



           tapset::context-envvar - systemtap context-envvar tapset
    


## DESCRIPTION



            Context functions provide additional information about where an
           event occurred. These functions can provide information such as a
           backtrace to where the event occurred and the current register
           values for the processor.
    
           **env_var**
                  Fetch environment variable from current process
    
                  See function::env_var(3stap)
                   for details.
    


* * *
# posix_openpt

## NAME



           posix_openpt - open a pseudoterminal device
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
           **#include <fcntl.h>**
    
           **int posix_openpt(int** _flags_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **posix_openpt**():
               _XOPEN_SOURCE >= 600
    


## DESCRIPTION



           The **posix_openpt**() function opens an unused pseudoterminal master
           device, returning a file descriptor that can be used to refer to
           that device.
    
           The _flags_ argument is a bit mask that ORs together zero or more of
           the following flags:
    
           **O_RDWR** Open the device for both reading and writing.  It is usual
                  to specify this flag.
    
           **O_NOCTTY**
                  Do not make this device the controlling terminal for the
                  process.
    


## RETURN VALUE



           On success, **posix_openpt**() returns a file descriptor (a
           nonnegative integer) which is the lowest numbered unused file
           descriptor.  On failure, -1 is returned, and _errno_ is set to
           indicate the error.
    


## ERRORS



           See open(2).
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           Some older UNIX implementations that support System V (aka UNIX
           98) pseudoterminals don't have this function, but it can be easily
           implemented by opening the pseudoterminal multiplexor device:
    
               int
               posix_openpt(int flags)
               {
                   return open("/dev/ptmx", flags);
               }
    
           Calling **posix_openpt**() creates a pathname for the corresponding
           pseudoterminal slave device.  The pathname of the slave device can
           be obtained using ptsname(3).  The slave device pathname exists
           only as long as the master device is open.
    


* * *
# gnutls_certificate_set_retrieve_function

## NAME



           gnutls_certificate_set_retrieve_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_retrieve_function(gnutls_certificate_credentials_t**
           _cred_**, gnutls_certificate_retrieve_function ***_func_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t cred
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_certificate_retrieve_function * func
                       is the callback function
    


## DESCRIPTION



           This function sets a callback to be called in order to retrieve
           the certificate to be used in the handshake. The callback will
           take control only if a certificate is requested by the peer. You
           are advised to use **gnutls_certificate_set_retrieve_function2()**
           because it is much more efficient in the processing it requires
           from gnutls.
    
           The callback's function prototype is: int
           (*callback)(gnutls_session_t, const gnutls_datum_t* req_ca_dn, int
           nreqs, const gnutls_pk_algorithm_t* pk_algos, int pk_algos_length,
           gnutls_retr2_st* st);
    
            _req_ca_dn_ is only used in X.509 certificates.  Contains a list
           with the CA names that the server considers trusted.  This is a
           hint and typically the client should send a certificate that is
           signed by one of these CAs. These names, when available, are DER
           encoded. To get a more meaningful value use the function
           **gnutls_x509_rdn_get()**.
    
            _pk_algos_ contains a list with server's acceptable public key
           algorithms.  The certificate returned should support the server's
           given algorithms.
    
            _st_ should contain the certificates and private keys.
    
           If the callback function is provided then gnutls will call it, in
           the handshake, after the certificate request message has been
           received.
    
           In server side pk_algos and req_ca_dn are NULL.
    
           The callback function should set the certificate list to be sent,
           and return 0 on success. If no certificate was selected then the
           number of certificates should be set to zero. The value (-1)
           indicates error and the handshake will be terminated. If both
           certificates are set in the credentials and a callback is
           available, the callback takes predence.
    


## SINCE



           3.0
    


* * *
# probe::vm.pagefault

## NAME



           probe::vm.pagefault - Records that a page fault occurred
    


## SYNOPSIS



           vm.pagefault
    


## VALUES



           _write_access_
               indicates whether this was a write or read access; 1 indicates
               a write, while 0 indicates a read
    
           _name_
               name of the probe point
    
           _address_
               the address of the faulting memory access; i.e. the address
               that caused the page fault
    


## CONTEXT



           The process which triggered the fault
    


* * *
# gnutls_sign_get_hash_algorithm

## NAME



           gnutls_sign_get_hash_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_digest_algorithm_t**
           **gnutls_sign_get_hash_algorithm(gnutls_sign_algorithm_t** _sign_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t sign
                       is a signature algorithm
    


## DESCRIPTION



           This function returns the digest algorithm corresponding to the
           given signature algorithms.
    


## SINCE



           3.1.1
    


## RETURNS



           return a **gnutls_digest_algorithm_t** value, or **GNUTLS_DIG_UNKNOWN** on
           error.
    


* * *
# isatty

## NAME



           isatty - test whether a file descriptor refers to a terminal
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **int isatty(int** _fd_**);**
    


## DESCRIPTION



           The **isatty**() function tests whether _fd_ is an open file descriptor
           referring to a terminal.
    


## RETURN VALUE



           **isatty**() returns 1 if _fd_ is an open file descriptor referring to a
           terminal; otherwise 0 is returned, and _errno_ is set to indicate
           the error.
    


## ERRORS



           **EBADF** _fd_ is not a valid file descriptor.
    
           **ENOTTY** _fd_ refers to a file other than a terminal.  On some older
                  kernels, some types of files resulted in the error **EINVAL**
                  in this case (which is a violation of POSIX, which
                  specifies the error **ENOTTY**).
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# strcat

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



           strcat — concatenate two strings
    


## SYNOPSIS



           #include <string.h>
    
           char *strcat(char *restrict _s1_ , const char *restrict _s2_);
    


## 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 _strcat_() function shall append a copy of the string pointed to
           by _s2_ (including the terminating NUL character) to the end of the
           string pointed to by _s1_.  The initial byte of _s2_ overwrites the
           NUL character at the end of _s1_.  If copying takes place between
           objects that overlap, the behavior is undefined.
    


## RETURN VALUE



           The _strcat_() function shall return _s1_ ; no return value is reserved
           to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           This version is aligned with the ISO C standard; this does not
           affect compatibility with XPG3 applications. Reliable error
           detection by this function was never guaranteed.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# bind_textdomain_codeset

## NAME



           bind_textdomain_codeset - set encoding of message translations
    


## SYNOPSIS



           **#include <libintl.h>**
    
           **char * bind_textdomain_codeset (const char ***_domainname_**,**
                                           **const char ***_codeset_**);**
    


## DESCRIPTION



           The **bind_textdomain_codeset** function sets the output codeset for
           message catalogs for domain _domainname_.
    
           A message domain is a set of translatable _msgid_ messages. Usually,
           every software package has its own message domain.
    
           By default, the **gettext** family of functions returns translated
           messages in the locale's character encoding, which can be
           retrieved as **nl_langinfo (CODESET)**. The need for calling
           **bind_textdomain_codeset** arises for programs which store strings in
           a locale independent way (e.g. UTF-8) and want to avoid an extra
           character set conversion on the returned translated messages.
    
           _domainname_ must be a non-empty string.
    
           If _codeset_ is not NULL, it must be a valid encoding name which can
           be used for the **iconv_open** function. The **bind_textdomain_codeset**
           function sets the output codeset for message catalogs belonging to
           domain _domainname_ to _codeset_. The function makes copies of the
           argument strings as needed.
    
           If _codeset_ is NULL, the function returns the previously set
           codeset for domain _domainname_. The default is NULL, denoting the
           locale's character encoding.
    


## RETURN VALUE



           If successful, the **bind_textdomain_codeset** function returns the
           current codeset for domain _domainname_ , after possibly changing it.
           The resulting string is valid until the next
           **bind_textdomain_codeset** call for the same _domainname_ and must not
           be modified or freed. If a memory allocation failure occurs, it
           sets **errno** to **ENOMEM** and returns NULL. If no codeset has been set
           for domain _domainname_ , it returns NULL.
    


## ERRORS



           The following error can occur, among others:
    
           **ENOMEM** Not enough memory available.
    


## BUGS



           The return type ought to be **const char *** , but is **char *** to avoid
           warnings in C code predating ANSI C.
    


* * *
# lstat

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



           lstat — get file status
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to fstatat(3p).
    


* * *
# umad_register

## NAME



           umad_register - register the specified management class and
           version for port
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_register(int** _portid_**, int** _mgmt_class_**, int** _mgmt_version_ **, uint8_t** _rmpp_version_**, long** _method_mask[16/sizeof(long)]_**);**
    


## DESCRIPTION



           **umad_register()** registers the specified management class,
           management version, and whether RMPP is being used for the port
           specified by the _portid_ parameter. If _method_mask_ array is
           provided, the caller is registered as a replier (server) for the
           methods having their corresponding bit on in the _method_mask_.  If
           _method_mask_ is NULL, the caller is registered as a MAD client,
           meaning that it can only receive replies on MADs that it sent
           (solicited MADs).
    


## RETURN VALUE



           **umad_register()** returns non-negative agent id number on success,
           and a negative value on error as follows:
            -EINVAL invalid port handle
            -EPERM  registration failed
    


* * *
# probe::signal.sys_tgkill.return

## NAME



           probe::signal.sys_tgkill.return - Sending kill signal to a thread
           group completed
    


## SYNOPSIS



           signal.sys_tgkill.return
    


## VALUES



           _retstr_
               The return value to either __group_send_sig_info,
    
           _name_
               Name of the probe point
    


* * *
# probe::nfs.proc.read_done

## NAME



           probe::nfs.proc.read_done - NFS client response to a read RPC task
    


## SYNOPSIS



           nfs.proc.read_done
    


## VALUES



           _prot_
               transfer protocol
    
           _count_
               number of bytes read
    
           _version_
               NFS version
    
           _timestamp_
               V4 timestamp, which is used for lease renewal
    
           _status_
               result of last operation
    
           _server_ip_
               IP address of server
    


## DESCRIPTION



           Fires when a reply to a read RPC task is received or some read
           error occurs (timeout or socket shutdown).
    


* * *
# acl_add_perm

## NAME



           **acl_add_perm** — add a permission to an ACL permission set
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_add_perm**(_acl_permset_t_
           _permset_d_ , _acl_perm_t perm_)
    


## DESCRIPTION



           The **acl_add_perm**() function adds the permission contained in the
           argument _perm_ (one of ACL_READ, ACL_WRITE, ACL_EXECUTE) to the
           permission set referred to by the argument _permset_d_.  An attempt
           to add a permission that is already contained in the permission
           set is not considered an error.
    
           Any existing descriptors that refer to _permset_d_ continue to refer
           to that permission set.
    


## RETURN VALUE



           The **acl_add_perm**() function returns the value 0 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_add_perm**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _permset_d_ is not a valid
                              descriptor for a permission set within an ACL
                              entry.
    
                              The argument _perm_ does not contain a valid
                              _acl_perm_t_ value.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# pcre2_jit_compile

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_jit_compile(pcre2_code ***_code_**, uint32_t** _options_**);**
    


## DESCRIPTION



    
           This function requests JIT compilation, which, if the just-in-time
           compiler is available, further processes a compiled pattern into
           machine code that executes much faster than the **pcre2_match()**
           interpretive matching function. Full details are given in the
           **pcre2jit** documentation.
    
           The availability of JIT support can be tested by calling
           **pcre2_compile_jit()** with a single option PCRE2_JIT_TEST_ALLOC (the
           code argument is ignored, so a NULL value is accepted). Such a
           call returns zero if JIT is available and has a working allocator.
           Otherwise it returns PCRE2_ERROR_NOMEMORY if JIT is available but
           cannot allocate executable memory, or PCRE2_ERROR_JIT_UNSUPPORTED
           if JIT support is not compiled.
    
           Otherwise, the first argument must be a pointer that was returned
           by a successful call to **pcre2_compile()** , and the second must
           contain one or more of the following bits:
    
             PCRE2_JIT_COMPLETE      compile code for full matching
             PCRE2_JIT_PARTIAL_SOFT  compile code for soft partial matching
             PCRE2_JIT_PARTIAL_HARD  compile code for hard partial matching
    
           There is also an obsolete option called PCRE2_JIT_INVALID_UTF,
           which has been superseded by the **pcre2_compile()** option
           PCRE2_MATCH_INVALID_UTF. The old option is deprecated and may be
           removed in the future.
    
           The yield of the function when called with any of the three
           options above is 0 for success, or a negative error code
           otherwise. In particular, PCRE2_ERROR_JIT_BADOPTION is returned if
           JIT is not supported or if an unknown bit is set in _options_. The
           function can also return PCRE2_ERROR_NOMEMORY if JIT is unable to
           allocate executable memory for the compiler, even if it was
           because of a system security restriction. In a few cases, the
           function may return with PCRE2_ERROR_JIT_UNSUPPORTED for
           unsupported features.
    
           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_x509_key_purpose_deinit

## NAME



           gnutls_x509_key_purpose_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void gnutls_x509_key_purpose_deinit(gnutls_x509_key_purposes_t** _p_**);**
    


## ARGUMENTS



           gnutls_x509_key_purposes_t p
                       The key purposes
    


## DESCRIPTION



           This function will deinitialize a key purposes type.
    


## SINCE



           3.3.0
    


* * *
# gnutls_x509_privkey_import_dsa_raw

## NAME



           gnutls_x509_privkey_import_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_dsa_raw(gnutls_x509_privkey_t** _key_**,**
           **const gnutls_datum_t ***_p_**, const gnutls_datum_t ***_q_**, const**
           **gnutls_datum_t ***_g_**, const gnutls_datum_t ***_y_**, const gnutls_datum_t**
           *****_x_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_datum_t * p
                       holds the p
    
           const gnutls_datum_t * q
                       holds the q
    
           const gnutls_datum_t * g
                       holds the g
    
           const gnutls_datum_t * y
                       holds the y (optional)
    
           const gnutls_datum_t * x
                       holds the x
    


## DESCRIPTION



           This function will convert the given DSA raw parameters to the
           native **gnutls_x509_privkey_t** format.  The output will be stored in
           _key_ .
    


## RETURNS



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


* * *
# function::set_kernel_pointer

## NAME



           function::set_kernel_pointer - Writes a pointer value to kernel
           memory.
    


## SYNOPSIS



               set_kernel_pointer(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The kernel address to write the pointer to
    
           _val_
               The pointer which is to be written
    


## DESCRIPTION



           Writes the pointer value to a given kernel memory address. Reports
           an error when writing to the given address fails. Requires the use
           of guru mode (-g).
    


* * *
# pam_setcred

## NAME



           pam_setcred - establish / delete user credentials
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **int pam_setcred(pam_handle_t ***_pamh_**, int** _flags_**);**
    


## DESCRIPTION



           The **pam_setcred** function is used to establish, maintain and delete
           the credentials of a user. It should be called to set the
           credentials after a user has been authenticated and before a
           session is opened for the user (with pam_open_session(3)). The
           credentials should be deleted after the session has been closed
           (with pam_close_session(3)).
    
           A credential is something that the user possesses. It is some
           property, such as a _Kerberos_ ticket, or a supplementary group
           membership that make up the uniqueness of a given user. On a Linux
           system the user's _UID_ and _GID_ 's are credentials too. However, it
           has been decided that these properties (along with the default
           supplementary groups of which the user is a member) are
           credentials that should be set directly by the application and not
           by PAM. Such credentials should be established, by the
           application, prior to a call to this function. For example,
           **initgroups**(2) (or equivalent) should have been performed.
    
           Valid _flags_ , any one of which, may be logically OR'd with
           **PAM_SILENT** , are:
    
           PAM_ESTABLISH_CRED
               Initialize the credentials for the user.
    
           PAM_DELETE_CRED
               Delete the user's credentials.
    
           PAM_REINITIALIZE_CRED
               Fully reinitialize the user's credentials.
    
           PAM_REFRESH_CRED
               Extend the lifetime of the existing credentials.
    


## RETURN VALUES



           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_CRED_ERR
               Failed to set user credentials.
    
           PAM_CRED_EXPIRED
               User credentials are expired.
    
           PAM_CRED_UNAVAIL
               Failed to retrieve user credentials.
    
           PAM_SUCCESS
               Data was successful stored.
    
           PAM_SYSTEM_ERR
               A NULL pointer was submitted as PAM handle, the function was
               called by a module or another system error occurred.
    
           PAM_USER_UNKNOWN
               User is not known to an authentication module.
    


* * *
# rdma_destroy_event_channel

## NAME



           rdma_destroy_event_channel - Close an event communication channel.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **void rdma_destroy_event_channel (struct rdma_event_channel**
           *****_channel_**);**
    


## ARGUMENTS



           channel     The communication channel to destroy.
    


## DESCRIPTION



           Release all resources associated with an event channel and closes
           the associated file descriptor.
    


## RETURN VALUE



           None
    


## NOTES



           All rdma_cm_id's associated with the event channel must be
           destroyed, and all returned events must be acked before calling
           this function.
    


* * *
# rdma_create_ep

## NAME



           rdma_create_ep - Allocate a communication identifier and optional
           QP.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_create_ep (struct rdma_cm_id ****_id_**, struct rdma_addrinfo**
           *****_res_**, struct ibv_pd  ***_pd_**, struct ibv_qp_init_attr ***_qp_init_attr_**);**
    


## ARGUMENTS



           id          A reference where the allocated communication
                       identifier will be returned.
    
           res         Address information associated with the rdma_cm_id
                       returned from rdma_getaddrinfo.
    
           pd          Optional protection domain if a QP is associated with
                       the rdma_cm_id.
    
           qp_init_attr
                       Optional initial QP attributes.
    


## DESCRIPTION



           Creates an identifier that is used to track communication
           information.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           After resolving address information using rdma_getaddrinfo, a user
           may use this call to allocate an rdma_cm_id based on the results.
    
           If the rdma_cm_id will be used on the active side of a connection,
           meaning that res->ai_flag does not have RAI_PASSIVE set,
           rdma_create_ep will automatically create a QP on the rdma_cm_id if
           qp_init_attr is not NULL.  The QP will be associated with the
           specified protection domain, if provided, or a default protection
           domain if not.  Users should see rdma_create_qp for details on the
           use of the pd and qp_init_attr parameters.  After calling
           rdma_create_ep, the returned rdma_cm_id may be connected by
           calling rdma_connect.  The active side calls rdma_resolve_addr and
           rdma_resolve_route are not necessary.
    
           If the rdma_cm_id will be used on the passive side of a
           connection, indicated by having res->ai_flag RAI_PASSIVE set, this
           call will save the provided pd and qp_init_attr parameters.  When
           a new connection request is retrieved by calling rdma_get_request,
           the rdma_cm_id associated with the new connection will
           automatically be associated with a QP using the pd and
           qp_init_attr parameters.  After calling rdma_create_ep, the
           returned rdma_cm_id may be placed into a listening state by
           immediately calling rdma_listen.  The passive side call
           rdma_bind_addr is not necessary.  Connection requests may then be
           retrieved by calling rdma_get_request.
    
           The newly created rdma_cm_id will be set to use synchronous
           operation.  Users that wish asynchronous operation must migrate
           the rdma_cm_id to a user created event channel using
           rdma_migrate_id.
    
           Users must release the created rdma_cm_id by calling
           rdma_destroy_ep.
    


* * *
# gnutls_x509_crt_cpy_crl_dist_points

## NAME



           gnutls_x509_crt_cpy_crl_dist_points - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t dst
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_crt_t src
                       the certificate where the dist points will be copied
                       from
    


## DESCRIPTION



           This function will copy the CRL distribution points certificate
           extension, from the source to the destination certificate.  This
           may be useful to copy from a CA certificate to issued ones.
    


## RETURNS



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


* * *
# mbps_to_ibv_rate

## NAME



           ibv_rate_to_mbps - convert IB rate enumeration to Mbit/sec
    
           mbps_to_ibv_rate - convert Mbit/sec to an IB rate enumeration
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_rate_to_mbps(enum ibv_rate rate);
    
                  enum ibv_rate mbps_to_ibv_rate(int mbps);
    


## DESCRIPTION



           **ibv_rate_to_mbps()** converts the IB transmission rate enumeration
           _rate_ to a number of Mbit/sec. For example, if _rate_ is
           **IBV_RATE_5_GBPS** , the value 5000 will be returned (5 Gbit/sec =
           5000 Mbit/sec).
    
           **mbps_to_ibv_rate()** converts the number of Mbit/sec _mult_ to an IB
           transmission rate enumeration.  For example, if _mult_ is 5000, the
           rate enumeration **IBV_RATE_5_GBPS** will be returned.
    


## RETURN VALUE



           **ibv_rate_to_mbps()** returns the number of Mbit/sec.
    
           **mbps_to_ibv_rate()** returns the enumeration representing the IB
           transmission rate.
    


* * *
# gnutls_x509_trust_list_get_issuer_by_dn

## NAME



           gnutls_x509_trust_list_get_issuer_by_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_trust_list_get_issuer_by_dn(gnutls_x509_trust_list_t**
           _list_**, const gnutls_datum_t ***_dn_**, gnutls_x509_crt_t ***_issuer_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const gnutls_datum_t * dn
                       is the issuer's DN
    
           gnutls_x509_crt_t * issuer
                       Will hold the issuer if any. Should be deallocated
                       after use.
    
           unsigned int flags
                       Use zero
    


## DESCRIPTION



           This function will find the issuer with the given name, and return
           a copy of the issuer, which must be freed using
           **gnutls_x509_crt_deinit()**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# function::task_max_file_handles

## NAME



           function::task_max_file_handles - The max number of open files for
           the task
    


## SYNOPSIS



               task_max_file_handles:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the maximum number of file handlers for the
           given task.
    


* * *
# asinl

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



           asinl — arc sine function
    


## SYNOPSIS



           #include <math.h>
    
           long double asinl(long double _x_);
    


## DESCRIPTION



           Refer to asin(3p).
    


* * *
# tapset::pn

## NAME



           tapset::pn - systemtap pn tapset
    


## DESCRIPTION



           **pn** Returns the active probe name
    
                  See function::pn(3stap)
                   for details.
    
           **pnlabel**
                  Returns the label name parsed from the probe name
    
                  See function::pnlabel(3stap)
                   for details.
    


* * *
# rdma_post_recv

## NAME



           rdma_post_recv - post a work request to receive an incoming
           message.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_recv (struct rdma_cm_id ***_id_**, void ***_context_**, void**
           *****_addr_**, size_t** _length_**, struct ibv_mr ***_mr_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer will be posted.
    
           context     User-defined context associated with the request.
    
           addr        The address of the memory buffer to post.
    
           length      The length of the memory buffer.
    
           mr          A registered memory region associated with the posted
                       buffer.
    


## DESCRIPTION



           Posts a work request to the receive queue of the queue pair
           associated with the rdma_cm_id.  The posted buffer will be queued
           to receive an incoming message sent by the remote peer.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           The user is responsible for ensuring that a receive buffer is
           posted and large enough to contain all sent data before the peer
           posts the corresponding send message.  The message buffer must
           have been registered before being posted, with the mr parameter
           referencing the registration.  The buffer must remain registered
           until the receive completes.
    
           Messages may be posted to an rdma_cm_id only after a queue pair
           has been associated with it.  A queue pair is bound to an
           rdma_cm_id after calling rdma_create_ep or rdma_create_qp, if the
           rdma_cm_id is allocated using rdma_create_id.
    
           The user-defined context associated with the receive request will
           be returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# gnutls_x509_privkey_export_rsa_raw2

## NAME



           gnutls_x509_privkey_export_rsa_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export_rsa_raw2(gnutls_x509_privkey_t** _key_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**, gnutls_datum_t ***_d_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_u_**,**
           **gnutls_datum_t ***_e1_**, gnutls_datum_t ***_e2_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_datum_t * m
                       will hold the modulus
    
           gnutls_datum_t * e
                       will hold the public exponent
    
           gnutls_datum_t * d
                       will hold the private exponent
    
           gnutls_datum_t * p
                       will hold the first prime (p)
    
           gnutls_datum_t * q
                       will hold the second prime (q)
    
           gnutls_datum_t * u
                       will hold the coefficient
    
           gnutls_datum_t * e1
                       will hold e1 = d mod (p-1)
    
           gnutls_datum_t * e2
                       will hold e2 = d mod (q-1)
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# libpfm_arm_qcom_krait

## NAME



           libpfm_arm_ac15 - support for Qualcomm Krait PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: qcom_krait**
           **PMU desc: Qualcomm Krait**
    


## DESCRIPTION



           The library supports the Qualcomm Krait core PMU.
    
           This PMU supports 5 counters and privilege levels filtering.
    


## MODIFIERS



           The following modifiers are supported on this PMU:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *