tripathysagar/man_text huggingface dataset:
# gnutls_x509_crt_deinit

## NAME



           gnutls_x509_crt_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crt_deinit(gnutls_x509_crt_t** _cert_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       The data to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a certificate structure.
    


* * *
# gnutls_privkey_import_dh_raw

## NAME



           gnutls_privkey_import_dh_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_dh_raw(gnutls_privkey_t** _key_**, const**
           **gnutls_dh_params_t** _params_**, const gnutls_datum_t ***_y_**, const**
           **gnutls_datum_t ***_x_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       The structure to store the parsed key
    
           const gnutls_dh_params_t params
                       holds the **gnutls_dh_params_t**
    
           const gnutls_datum_t * y
                       holds the y (optional)
    
           const gnutls_datum_t * x
                       holds the x
    


## DESCRIPTION



           This function will convert the given Diffie-Hellman raw parameters
           to the native **gnutls_privkey_t** format.  The output will be stored
           in  _key_ .
    


## RETURNS



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


## SINCE



           3.8.2
    


* * *
# gnutls_x509_crt_get_proxy

## NAME



           gnutls_x509_crt_get_proxy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_proxy(gnutls_x509_crt_t** _cert_**, unsigned int**
           *****_critical_**, int ***_pathlen_**, char ****_policyLanguage_**, char ****_policy_**,**
           **size_t ***_sizeof_policy_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    
           int * pathlen
                       pointer to output integer indicating path length (may
                       be NULL), non-negative error codes indicate a present
                       pCPathLenConstraint field and the actual value, -1
                       indicate that the field is absent.
    
           char ** policyLanguage
                       output variable with OID of policy language
    
           char ** policy
                       output variable with policy data
    
           size_t * sizeof_policy
                       output variable size of policy data
    


## DESCRIPTION



           This function will get information from a proxy certificate.  It
           reads the ProxyCertInfo X.509 extension (1.3.6.1.5.5.7.1.14).
    


## RETURNS



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


* * *
# probe::scsi.iocompleted

## NAME



           probe::scsi.iocompleted - SCSI mid-layer running the completion
           processing for block device I/O requests
    


## SYNOPSIS



           scsi.iocompleted
    


## VALUES



           _goodbytes_
               The bytes completed
    
           _channel_
               The channel number
    
           _host_no_
               The host number
    
           _device_state_
               The current state of the device
    
           _lun_
               The lun number
    
           _data_direction_str_
               Data direction, as a string
    
           _data_direction_
               The data_direction specifies whether this command is from/to
               the device
    
           _device_state_str_
               The current state of the device, as a string
    
           _dev_id_
               The scsi device id
    
           _req_addr_
               The current struct request pointer, as a number
    


* * *
# gnutls_certificate_type_get_name

## NAME



           gnutls_certificate_type_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char ***
           **gnutls_certificate_type_get_name(gnutls_certificate_type_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_type_t type
                       is a certificate type
    


## DESCRIPTION



           Convert a **gnutls_certificate_type_t** type to a string.
    


## RETURNS



           a string that contains the name of the specified certificate type,
           or **NULL** in case of unknown types.
    


* * *
# usleep

## NAME



           usleep - suspend execution for microsecond intervals
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **int usleep(useconds_t** _usec_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **usleep**():
               Since glibc 2.12:
                   (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L)
                       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                       || /* glibc <= 2.19: */ _BSD_SOURCE
               Before glibc 2.12:
                   _BSD_SOURCE || _XOPEN_SOURCE >= 500
    


## DESCRIPTION



           The **usleep**() function suspends execution of the calling thread for
           (at least) _usec_ microseconds.  The sleep may be lengthened
           slightly by any system activity or by the time spent processing
           the call or by the granularity of system timers.
    


## RETURN VALUE



           The **usleep**() function returns 0 on success.  On error, -1 is
           returned, with _errno_ set to indicate the error.
    


## ERRORS



           **EINTR** Interrupted by a signal; see signal(7).
    
           **EINVAL** _usec_ is greater than or equal to **1000000**.  (On systems
                  where that is considered an error.)
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## CAVEATS



           The interaction of this function with the **SIGALRM** signal, and with
           other timer functions such as alarm(2), sleep(3), nanosleep(2),
           setitimer(2), timer_create(2), timer_delete(2),
           timer_getoverrun(2), timer_gettime(2), timer_settime(2), ualarm(3)
           is unspecified.
    


* * *
# ibv_free_device_list

## NAME



           ibv_get_device_list, ibv_free_device_list - get and release list
           of available RDMA devices
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_device **ibv_get_device_list(int *num_devices);
    
                  void ibv_free_device_list(struct ibv_device **list);
    


## DESCRIPTION



           **ibv_get_device_list()** returns a NULL-terminated array of RDMA
           devices currently available.  The argument _num_devices_ is
           optional; if not NULL, it is set to the number of devices returned
           in the array.
    
           **ibv_free_device_list()** frees the array of devices _list_ returned by
           **ibv_get_device_list()**.
    


## RETURN VALUE



           **ibv_get_device_list()** returns the array of available RDMA devices,
           or sets _errno_ and returns NULL if the request fails.  If no
           devices are found then _num_devices_ is set to 0, and non-NULL is
           returned.
    
           **ibv_free_device_list()** returns no value.
    


## ERRORS



           **EPERM** Permission denied.
    
           **ENOSYS** No kernel support for RDMA.
    
           **ENOMEM** Insufficient memory to complete the operation.
    


## NOTES



           Client code should open all the devices it intends to use with
           **ibv_open_device()** before calling **ibv_free_device_list()**.  Once it
           frees the array with **ibv_free_device_list()** , it will be able to
           use only the open devices; pointers to unopened devices will no
           longer be valid.
    
           Setting the environment variable **IBV_SHOW_WARNINGS** will cause
           warnings to be emitted to stderr if a kernel verbs device is
           discovered, but no corresponding userspace driver can be found for
           it.
    


## STATIC LINKING



           If **libibverbs** is statically linked to the application then all
           provider drivers must also be statically linked.  The library will
           not load dynamic providers when static linking is used.
    
           To link the providers set the **RDMA_STATIC_PROVIDERS** define to the
           comma separated list of desired providers when compiling the
           application.  The special keyword `all' will statically link all
           supported **libibverbs** providers.
    
           This is intended to be used along with **pkg-config(1)** to setup the
           proper flags for **libibverbs** linking.
    
           If this is not done then **ibv_get_device_list** will always return an
           empty list.
    
           Using only dynamic linking for **libibverbs** applications is strongly
           recommended.
    


* * *
# libpfm_intel_bdx_unc_imc

## NAME



           libpfm_intel_bdx_unc_imc - support for Intel Broadwell Server
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_imc[0-7]**
           **PMU desc: Intel Broadwell Server IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell Server Integrated Memory
           Controller (IMC) uncore PMU.  This PMU model only exists on
           various Broadwell server models (79, 86).
    


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server
           IMC uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IMC cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].  **i** Invert the meaning of the threshold or
                  edge filter. If set, the event counts when strictly less
                  than N occurrences occur per cycle if threshold is set to
                  N. When invert is set, then threshold must be set to non-
                  zero value. If set, the event counts when the event
                  transitions from occurring to not occurring (falling edge)
                  when edge detection is set. This is a boolean modifier
    


* * *
# difftime

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



           difftime — compute the difference between two calendar time values
    


## SYNOPSIS



           #include <time.h>
    
           double difftime(time_t _time1_ , time_t _time0_);
    


## 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 _difftime_() function shall compute the difference between two
           calendar times (as returned by _time_()): _time_ 1- _time_ 0.
    


## RETURN VALUE



           The _difftime_() function shall return the difference expressed in
           seconds as a type **double**.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pem_base64_decode2

## NAME



           gnutls_pem_base64_decode2 - API function
    


## SYNOPSIS



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


## ARGUMENTS



           const char * header
                       The PEM header (eg. CERTIFICATE)
    
           const gnutls_datum_t * b64_data
                       contains the encoded data
    
           gnutls_datum_t * result
                       the location of decoded data
    


## DESCRIPTION



           This function will decode the given encoded data. The decoded data
           will be allocated, and stored into result.  If the header given is
           non null this function will search for "-----BEGIN header" and
           decode only this part. Otherwise it will decode the first PEM
           packet found.
    
           You should use **gnutls_free()** to free the returned data.
    
           Note, that prior to GnuTLS 3.4.0 this function was available under
           the name **gnutls_pem_base64_decode_alloc()**. There is compatibility
           macro pointing to this function.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_certificate_set_x509_simple_pkcs12_mem

## NAME



           gnutls_certificate_set_x509_simple_pkcs12_mem - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_simple_pkcs12_mem(gnutls_certificate_credentials_t**
           _res_**, const gnutls_datum_t ***_p12blob_**, gnutls_x509_crt_fmt_t** _type_**,**
           **const char ***_password_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const gnutls_datum_t * p12blob
                       the PKCS**12** blob.
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER of the  _pkcs12file_ .
    
           const char * password
                       optional password used to decrypt PKCS**12** file, bags
                       and keys.
    


## DESCRIPTION



           This function sets a certificate/private key pair and/or a CRL in
           the gnutls_certificate_credentials_t type.  This function may be
           called more than once (in case multiple keys/certificates exist
           for the server).
    
           Encrypted PKCS**12** bags and PKCS**8** private keys are supported.
           However, only password based security, and the same password for
           all operations, are supported.
    
           PKCS**12** file may contain many keys and/or certificates, and this
           function will try to auto-detect based on the key ID the
           certificate and key pair to use. If the PKCS**12** file contain the
           issuer of the selected certificate, it will be appended to the
           certificate to form a chain.
    
           If more than one private keys are stored in the PKCS**12** file, then
           only one key will be read (and it is undefined which one).
    
           It is believed that the limitations of this function is acceptable
           for most usage, and that any more flexibility would introduce
           complexity that would make it harder to use this functionality at
           all.
    
           Note that, this function by default returns zero on success and a
           negative value on error.  Since 3.5.6, when the flag
           **GNUTLS_CERTIFICATE_API_V2** is set using
           **gnutls_certificate_set_flags()** it returns an index (greater or
           equal to zero). That index can be used to other functions to refer
           to the added key-pair.
    


## RETURNS



           On success this functions returns zero, and otherwise a negative
           value on error (see above for modifying that behavior).
    


## SINCE



           2.8.0
    


* * *
# pam_misc_paste_env

## NAME



           pam_misc_paste_env - transcribing an environment to that of PAM
    


## SYNOPSIS



           **#include <security/pam_misc.h>**
    
           **int pam_misc_paste_env(pam_handle_t ***_pamh_**,**
                                  **const char * const ***_user_**);**
    


## DESCRIPTION



           This function takes the supplied list of environment pointers and
           _uploads_ its contents to the PAM environment. Success is indicated
           by PAM_SUCCESS.
    


## STANDARDS



           The **pam_misc_paste_env** function is part of the **libpam_misc** Library
           and not defined in any standard.
    


* * *
# function::longlong_arg

## NAME



           function::longlong_arg - Return function argument as 64-bit value
    


## SYNOPSIS



               longlong_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the value of argument n as a 64-bit value.
    


* * *
# wcscasecmp

## NAME



           wcscasecmp, wcsncasecmp - compare two wide-character strings,
           ignoring case
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **int wcscasecmp(const wchar_t ***_s1_**, const wchar_t ***_s2_**);**
           **int wcsncasecmp(** size_t n;
                           **const wchar_t** _s1_**[**_n_**], const wchar_t** _s2_**[**_n_**], size_t** _n_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **wcscasecmp**(), **wcsncasecmp**():
               Since glibc 2.10:
                   _POSIX_C_SOURCE >= 200809L
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **wcscasecmp**() function is the wide-character equivalent of the
           strcasecmp(3) function.  It compares the wide-character string
           pointed to by _s1_ and the wide-character string pointed to by _s2_ ,
           ignoring case differences (towupper(3), towlower(3)).
    
           The **wcsncasecmp**() function is similar (the wide-character
           equivalent of strncasecmp(3)), except that it compares no more
           than _n_ wide characters of _s1_ and _s2_.
    


## RETURN VALUE



           The **wcscasecmp**() and **wcsncasecmp**() functions return an integer
           less than, equal to, or greater than zero if _s1_ is, after ignoring
           case, found to be less than, to match, or be greater than _s2_ ,
           respectively.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The behavior of **wcscasecmp**() depends on the **LC_CTYPE** category of
           the current locale.
    


* * *
# catanl

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



           catanl — complex arc tangent functions
    


## SYNOPSIS



           #include <complex.h>
    
           long double complex catanl(long double complex _z_);
    


## DESCRIPTION



           Refer to catan(3p).
    


* * *
# pcre2_set_compile_recursion_guard

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_compile_recursion_guard(pcre2_compile_context ***_ccontext_**,**
             **int (***_guard_function_**)(uint32_t, void *), void ***_user_data_**);**
    


## DESCRIPTION



    
           This function defines, within a compile context, a function that
           is called whenever **pcre2_compile()** starts to compile a
           parenthesized part of a pattern. The first argument to the
           function gives the current depth of parenthesis nesting, and the
           second is user data that is supplied when the function is set up.
           The callout function should return zero if all is well, or non-
           zero to force an error. This feature is provided so that
           applications can check the available system stack space, in order
           to avoid running out. The result of
           **pcre2_set_compile_recursion_guard()** 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::remote_id

## NAME



           function::remote_id - The index of this instance in a remote
           execution.
    


## SYNOPSIS



               remote_id:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns a number 0..N, which is the unique index of
           this particular script execution from a swarm of “stap --remote A
           --remote B ...”  runs, and is the same number “stap
           --remote-prefix” would print. The function returns -1 if the
           script was not launched with “stap --remote”, or if the remote
           staprun/stapsh are older than version 1.7.
    


* * *
# wcsnrtombs

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



           wcsnrtombs — convert wide-character string to multi-byte string
    


## SYNOPSIS



           #include <wchar.h>
    
           size_t wcsnrtombs(char *restrict _dst_ , const wchar_t **restrict _src_ ,
               size_t _nwc_ , size_t _len_ , mbstate_t *restrict _ps_);
    


## DESCRIPTION



           Refer to wcsrtombs(3p).
    


* * *
# tcgetpgrp

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



           tcgetpgrp — get the foreground process group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t tcgetpgrp(int _fildes_);
    


## DESCRIPTION



           The _tcgetpgrp_() function shall return the value of the process
           group ID of the foreground process group associated with the
           terminal.
    
           If there is no foreground process group, _tcgetpgrp_() shall return
           a value greater than 1 that does not match the process group ID of
           any existing process group.
    
           The _tcgetpgrp_() function is allowed from a process that is a
           member of a background process group; however, the information may
           be subsequently changed by a process that is a member of a
           foreground process group.
    


## RETURN VALUE



           Upon successful completion, _tcgetpgrp_() shall return the value of
           the process group ID of the foreground process associated with the
           terminal. Otherwise, -1 shall be returned and _errno_ set to
           indicate the error.
    


## ERRORS



           The _tcgetpgrp_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **ENOTTY** The calling process does not have a controlling terminal,
                  or the file is not the controlling terminal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs12_set_bag

## NAME



           gnutls_pkcs12_set_bag - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_set_bag(gnutls_pkcs12_t** _pkcs12_**,**
           **gnutls_pkcs12_bag_t** _bag_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       should contain a gnutls_pkcs12_t type
    
           gnutls_pkcs12_bag_t bag
                       An initialized bag
    


## DESCRIPTION



           This function will insert a Bag into the PKCS12 structure.
    


## RETURNS



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


* * *
# IO_URING_VERSION_MAJOR

## NAME



           io_uring_check_version - functions and macros to check the
           liburing version
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **bool io_uring_check_version(int** _major_**, int** _minor_**);**
           **IO_URING_CHECK_VERSION(**_major_**,**_minor_**);**
    
           **int io_uring_major_version(void);**
           **IO_URING_VERSION_MAJOR;**
    
           **int io_uring_minor_version(void);**
           **IO_URING_VERSION_MINOR;**
    


## DESCRIPTION



           The io_uring_check_version(3) function returns _false_ if the
           liburing library loaded by the dynamic linker is greater-than or
           equal-to the _major_ and _minor_ numbers provided.
    
           The IO_URING_CHECK_VERSION(3) macro returns _0_ if the liburing
           library being compiled against is greater-than or equal-to the
           _major_ and _minor_ numbers provided.
    
           The io_uring_major_version(3) function returns the _major_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MAJOR(3) macro returns the _major_ version
           number of the liburing library being compiled against.
    
           The io_uring_minor_version(3) function returns the _minor_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MINOR(3) macro returns the _minor_ version
           number of the liburing library being compiled against.
    


* * *
# gnutls_x509_crt_set_expiration_time

## NAME



           gnutls_x509_crt_set_expiration_time - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_expiration_time(gnutls_x509_crt_t** _cert_**,**
           **time_t** _exp_time_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           time_t exp_time
                       The actual time
    


## DESCRIPTION



           This function will set the time this Certificate will expire.
           Setting an expiration time to (time_t)-1 will set to the no
           well-defined expiration date value.
    


## RETURNS



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


* * *
# catclose

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



           catclose — close a message catalog descriptor
    


## SYNOPSIS



           #include <nl_types.h>
    
           int catclose(nl_catd _catd_);
    


## DESCRIPTION



           The _catclose_() function shall close the message catalog identified
           by _catd_.  If a file descriptor is used to implement the type
           **nl_catd** , that file descriptor shall be closed.
    


## RETURN VALUE



           Upon successful completion, _catclose_() shall return 0; otherwise,
           -1 shall be returned, and _errno_ set to indicate the error.
    


## ERRORS



           The _catclose_() function may fail if:
    
           **EBADF** The catalog descriptor is not valid.
    
           **EINTR** The _catclose_() function was interrupted by a signal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# setbuf

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



           setbuf — assign buffering to a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           void setbuf(FILE *restrict _stream_ , char *restrict _buf_);
    


## 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.
    
           Except that it returns no value, the function call:
    
               setbuf(stream, buf)
    
           shall be equivalent to:
    
               setvbuf(stream, buf, _IOFBF, BUFSIZ)
    
           if _buf_ is not a null pointer, or to:
    
               setvbuf(stream, buf, _IONBF, BUFSIZ)
    
           if _buf_ is a null pointer.
    


## RETURN VALUE



           The _setbuf_() function shall not return a value.
    


## ERRORS



           Although the _setvbuf_() interface may set _errno_ in defined ways,
           the value of _errno_ after a call to _setbuf_() is unspecified.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           A common source of error is allocating buffer space as an
           ``automatic'' variable in a code block, and then failing to close
           the stream in the same block.
    
           With _setbuf_(), allocating a buffer of BUFSIZ bytes does not
           necessarily imply that all of BUFSIZ bytes are used for the buffer
           area.
    
           Since _errno_ is not required to be unchanged on success, in order
           to correctly detect and possibly recover from errors, applications
           should use _setvbuf_() instead of _setbuf_().
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::ioscheduler_trace.plug

## NAME



           probe::ioscheduler_trace.plug - Fires when a request queue is
           plugged;
    


## SYNOPSIS



           ioscheduler_trace.plug
    


## VALUES



           _rq_queue_
               request queue
    
           _name_
               Name of the probe point
    


## DESCRIPTION



           ie, requests in the queue cannot be serviced by block driver.
    


* * *
# pcre2_jit_stack_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_jit_stack *pcre2_jit_stack_create(size_t** _startsize_**,**
             **size_t** _maxsize_**, pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function is used to create a stack for use by the code
           compiled by the JIT compiler. The first two arguments are a
           starting size for the stack, and a maximum size to which it is
           allowed to grow. The final argument is a general context, for
           memory allocation functions, or NULL for standard memory
           allocation. The result can be passed to the JIT run-time code by
           calling **pcre2_jit_stack_assign()** to associate the stack with a
           compiled pattern, which can then be processed by **pcre2_match()** or
           **pcre2_jit_match()**.  A maximum stack size of 512KiB to 1MiB should
           be more than enough for any pattern. If the stack couldn't be
           allocated or the values passed were not reasonable, NULL will be
           returned. For more details, see the **pcre2jit** page.
    
           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::text_strn

## NAME



           function::text_strn - Escape any non-printable chars in a string
    


## SYNOPSIS



               text_strn:string(input:string,len:long,quoted:long)
    


## ARGUMENTS



           _input_
               the string to escape
    
           _len_
               maximum length of string to return (0 implies MAXSTRINGLEN)
    
           _quoted_
               put double quotes around the string. If input string is
               truncated it will have “...”  after the second quote
    


## DESCRIPTION



           This function accepts a string of designated length, and any ASCII
           characters that are not printable are replaced by the
           corresponding escape sequence in the returned string.
    


* * *
# probe::nfsd.read

## NAME



           probe::nfsd.read - NFS server reading data from a file for client
    


## SYNOPSIS



           nfsd.read
    


## VALUES



           _fh_
               file handle (the first part is the length of the file handle)
    
           _offset_
               the offset of file
    
           _size_
               read bytes
    
           _file_
               argument file, indicates if the file has been opened.
    
           _vec_
               struct kvec, includes buf address in kernel address and length
               of each buffer
    
           _vlen_
               read blocks
    
           _count_
               read bytes
    
           _client_ip_
               the ip address of client
    


* * *
# pcre2_set_substitute_callout

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_substitute_callout(pcre2_match_context ***_mcontext_**,**
             **int (***_callout_function_**)(pcre2_substitute_callout_block *, void *),**
             **void ***_callout_data_**);**
    


## DESCRIPTION



    
           This function sets the substitute callout fields in a match
           context (the first argument). The second argument specifies a
           callout function, and the third argument is an opaque data item
           that is passed to it. The result of this function is always zero.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_x509_privkey_set_pin_function

## NAME



           gnutls_x509_privkey_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_privkey_set_pin_function(gnutls_x509_privkey_t**
           _privkey_**, gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t privkey
                       The certificate structure
    
           gnutls_pin_callback_t fn
                       the callback
    
           void * userdata
                       data associated with the callback
    


## DESCRIPTION



           This function will set a callback function to be used when it is
           required to access a protected object. This function overrides the
           global function set using **gnutls_pkcs11_set_pin_function()**.
    
           Note that this callback is used when decrypting a key.
    


## SINCE



           3.4.0
    


* * *
# pmiputlabel

## NAME



           **pmiPutLabel** - add labels to the output archive
    


## C SYNOPSIS



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


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiPutLabel($**_type_**, $**_id_**, $**_instance_**, $**_name_**, $**_value_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiPutLabel** adds a label for the global context  or
           for a given domain, cluster, item, instance domain or instance.
    
           The  _type_ must be one of **PM_LABEL_CONTEXT, PM_LABEL_DOMAIN, PM_LA‐**
           **BEL_CLUSTER, PM_LABEL_ITEM, PM_LABEL_INDOM,** or **PM_LABEL_INSTANCES**.
    
           If _type_ is **PM_LABEL_CONTEXT** , then _id_  and  _instance_  are  ignored.
           Otherwise,  _id_  should match a domain, cluster, metric or instance
           domain defined earlier in a call to pmiAddMetric(3).
    
           If _type_ is **PM_LABEL_INSTANCES** , then _instance_ should match  an  in‐
           stance  number  of  the selected domain. Otherwise _instance_ is ig‐
           nored.
    
           _name_ is a string containing the name of the label to be added.
    
           _value_ is a string containing the value of the label to be added.
    
           No data will be written until pmiWrite(3) is called,  so  multiple
           calls  to **pmiPutLabel** are typically used to accumulate several la‐
           bels before calling pmiWrite(3).
    


## DIAGNOSTICS



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


* * *
# io_uring_recvmsg_cmsg_nexthdr

## NAME



           io_uring_recvmsg_out - access data from multishot recvmsg
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **struct io_uring_recvmsg_out *io_uring_recvmsg_validate(void ***_buf_**,**
                                                                  **int** _buf_len_**,**
                                                                  **struct msghdr ***_msgh_**);**
    
           **void *io_uring_recvmsg_name(struct io_uring_recvmsg_out ***_o_**);**
    
           **struct cmsghdr *io_uring_recvmsg_cmsg_firsthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                          **struct msghdr ***_msgh_**);**
           **struct cmsghdr *io_uring_recvmsg_cmsg_nexthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                         **struct msghdr ***_msgh_**,**
                                                         **struct cmsghdr ***_cmsg_**);**
    
           **void *io_uring_recvmsg_payload(struct io_uring_recvmsg_out ***_o_**,**
                                          **struct msghdr ***_msgh_**);**
           **unsigned int io_uring_recvmsg_payload_length(struct io_uring_recvmsg_out ***_o_**,**
                                                        **int** _buf_len_**,**
                                                        **struct msghdr ***_msgh_**);**
    


## DESCRIPTION



           These functions are used to access data in the payload delivered
           by io_uring_prep_recvmsg_multishot(3).
    
           _msgh_ should point to the _struct msghdr_ submitted with the request.
    
           io_uring_recvmsg_validate(3) will validate a buffer delivered by
           io_uring_prep_recvmsg_multishot(3) and extract the
           _io_uring_recvmsg_out_ if it is valid, returning a pointer to it or
           else NULL.
    
           The structure is defined as follows:
    
               struct io_uring_recvmsg_out {
                       __u32 namelen;    /* Name byte count as would have been populated
                                          * by recvmsg(2) */
                       __u32 controllen; /* Control byte count */
                       __u32 payloadlen; /* Payload byte count as would have been returned
                                          * by recvmsg(2) */
                       __u32 flags;      /* Flags result as would have been populated
                                          * by recvmsg(2) */
               };
    
           *  io_uring_recvmsg_name(3)
              returns a pointer to the name in the buffer.
    
           *  io_uring_recvmsg_cmsg_firsthdr(3)
              returns a pointer to the first cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_cmsg_nexthdr(3)
              returns a pointer to the next cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_payload(3)
              returns a pointer to the payload in the buffer.
    
           *  io_uring_recvmsg_payload_length(3)
              Calculates the usable payload length in bytes.
    


* * *
# gnutls_pkcs11_obj_set_info

## NAME



           gnutls_pkcs11_obj_set_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_set_info(gnutls_pkcs11_obj_t** _obj_**,**
           **gnutls_pkcs11_obj_info_t** _itype_**, const void ***_data_**, size_t**
           _data_size_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       should contain a **gnutls_pkcs11_obj_t** type
    
           gnutls_pkcs11_obj_info_t itype
                       Denotes the type of information to be set
    
           const void * data
                       the data to set
    
           size_t data_size
                       the size of data
    
           unsigned flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will set attributes on the provided object.
           Available options for  _itype_ are **GNUTLS_PKCS11_OBJ_LABEL** ,
           **GNUTLS_PKCS11_OBJ_ID_HEX** , and **GNUTLS_PKCS11_OBJ_ID**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_pubkey_export_dsa_raw

## NAME



           gnutls_pubkey_export_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_dsa_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_datum_t * p
                       will hold the p (may be **NULL**)
    
           gnutls_datum_t * q
                       will hold the q (may be **NULL**)
    
           gnutls_datum_t * g
                       will hold the g (may be **NULL**)
    
           gnutls_datum_t * y
                       will hold the y (may be **NULL**)
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# capng_updatev

## NAME



           capng_updatev - update the stored capabilities settings
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_updatev(capng_act_t action, capng_type_t type,
                unsigned int capability, ...);
    


## DESCRIPTION



           capng_updatev will update the internal POSIX capabilities settings
           based on the options passed to it. The action should be either
           CAPNG_DROP to set the capability bit to 0, or CAPNG_ADD to set the
           capability bit to 1. The operation is performed on the capability
           set specified in the type parameter. The values are:
           CAPNG_EFFECTIVE, CAPNG_PERMITTED, CAPNG_INHERITABLE,
           CAPNG_BOUNDING_SET, or CAPNG_AMBIENT. The values may be or'ed
           together to perform the same operation on multiple sets. The last
           parameter, capability, is the capability define as given in
           linux/capability.h.
    
           This function differs from capng_update in that you may pass a
           list of capabilities. This list must be terminated with a -1
           value.
    


## RETURN VALUE



           This returns 0 on success and -1 on failure.
    


* * *
# gnutls_pbkdf2

## NAME



           gnutls_pbkdf2 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_pbkdf2(gnutls_mac_algorithm_t** _mac_**, const gnutls_datum_t**
           *****_key_**, const gnutls_datum_t ***_salt_**, unsigned** _iter_count_**, void ***
           _output_**, size_t** _length_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t mac
                       the mac algorithm used internally
    
           const gnutls_datum_t * key
                       the initial keying material
    
           const gnutls_datum_t * salt
                       the salt
    
           unsigned iter_count
                       the iteration count
    
           void * output
                       the output value
    
           size_t length
                       the desired length of the output key
    


## DESCRIPTION



           This function will derive a variable length keying material from a
           password according to PKCS **5** PBKDF2.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.13
    


* * *