tripathysagar/man_text huggingface dataset:
# gnutls_x509_crl_get_dn_oid

## NAME



           gnutls_x509_crl_get_dn_oid - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function will extract the requested OID of the name of the
           CRL issuer, specified by the given index.
    
           If oid is null then only the size will be filled.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the sizeof_oid will be updated with the
           required size.  On success 0 is returned.
    


* * *
# gnutls_x509_crt_get_pk_oid

## NAME



           gnutls_x509_crt_get_pk_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_oid(gnutls_x509_crt_t** _cert_**, char ***_oid_**,**
           **size_t ***_oid_size_**);**
    


## ARGUMENTS



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


## DESCRIPTION



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


## RETURNS



           zero or a negative error code on error.
    


## SINCE



           3.5.0
    


* * *
# gnutls_x509_crl_privkey_sign

## NAME



           gnutls_x509_crl_privkey_sign - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_x509_crl_privkey_sign(gnutls_x509_crl_t** _crl_**,**
           **gnutls_x509_crt_t** _issuer_**, gnutls_privkey_t** _issuer_key_**,**
           **gnutls_digest_algorithm_t** _dig_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           gnutls_x509_crt_t issuer
                       is the certificate of the certificate issuer
    
           gnutls_privkey_t issuer_key
                       holds the issuer's private key
    
           gnutls_digest_algorithm_t dig
                       The message digest to use. GNUTLS_DIG_SHA256 is the
                       safe choice unless you know what you're doing.
    
           unsigned int flags
                       must be 0
    


## DESCRIPTION



           This function will sign the CRL with the issuer's private key, and
           will copy the issuer's information into the CRL.
    
           This must be the last step in a certificate CRL since all the
           previously set parameters are now signed.
    
           A known limitation of this function is, that a newly-signed CRL
           will not be fully functional (e.g., for signature verification),
           until it is exported an re-imported.
    
           After GnuTLS 3.6.1 the value of  _dig_ may be **GNUTLS_DIG_UNKNOWN** ,
           and in that case, a suitable but reasonable for the key algorithm
           will be selected.
    


## RETURNS



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


* * *
# gnutls_transport_set_vec_push_function

## NAME



           gnutls_transport_set_vec_push_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_vec_push_function(gnutls_session_t**
           _session_**, gnutls_vec_push_func** _vec_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_vec_push_func vec_func
                       a callback function similar to **writev()**
    


## DESCRIPTION



           Using this function you can override the default writev(2)
           function for gnutls to send data. Setting this callback instead of
           **gnutls_transport_set_push_function()** is recommended since it
           introduces less overhead in the TLS handshake process.
    
            _vec_func_ is of the form, ssize_t (*gnutls_vec_push_func)
           (gnutls_transport_ptr_t, const giovec_t * iov, int iovcnt);
    


## SINCE



           2.12.0
    


* * *
# menu_mark

## NAME



           **set_menu_mark** , **menu_mark** - get and set the menu mark string
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_mark(MENU ***_menu_**, const char ***_mark_**);**
           **const char *menu_mark(const MENU ***_menu_**);**
    


## DESCRIPTION



           In order to make menu selections visible on older terminals
           without highlighting or color capability, the menu library marks
           selected items in a menu with a prefix string.
    
           The function **set_menu_mark** sets the mark string for the given
           menu.  Calling **set_menu_mark** with a null menu item will abolish
           the mark string.  Note that changing the length of the mark string
           for a menu while the menu is posted is likely to produce unhelpful
           behavior.
    
           The default string is "-" (a dash).  Calling **set_menu_mark** with a
           non-**NULL** menu argument will change this default.
    
           The function **menu_mark** returns the menu's mark string (or **NULL** if
           there is none).
    


## RETURN VALUE



           The function **menu_mark** returns a pointer (which may be **NULL**).  It
           does not set **errno**.
    
           The function **set_menu_mark** may return the following error codes:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



           The header file **< menu.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# cexp

## NAME



           cexp, cexpf, cexpl - complex exponential function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cexp(double complex** _z_**);**
           **float complex cexpf(float complex** _z_**);**
           **long double complex cexpl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate e (2.71828..., the base of natural
           logarithms) raised to the power of _z_.
    
           One has:
    
               cexp(I * z) = ccos(z) + I * csin(z)
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_priority_set

## NAME



           gnutls_priority_set - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_set(gnutls_session_t** _session_**,**
           **gnutls_priority_t** _priority_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_priority_t priority
                       is a **gnutls_priority_t** type.
    


## DESCRIPTION



           Sets the priorities to use on the ciphers, key exchange methods,
           and macs. Note that this function is expected to be called once
           per session; when called multiple times (e.g., before a
           re-handshake, the caller should make sure that any new settings
           are not incompatible with the original session).
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code on error.
    


* * *
# csinh

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



           csinh, csinhf, csinhl — complex hyperbolic sine functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex csinh(double complex _z_);
           float complex csinhf(float complex _z_);
           long double complex csinhl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex hyperbolic sine of _z_.
    


## RETURN VALUE



           These functions shall return the complex hyperbolic sine value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::ns_gid

## NAME



           function::ns_gid - Returns the group ID of a target process as
           seen in a user namespace
    


## SYNOPSIS



               ns_gid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the group ID of a target process as seen in
           the target user namespace if provided, or the stap process
           namespace.
    


* * *
# sd_bus_message_rewind

## NAME



           sd_bus_message_rewind - Return to beginning of message or current
           container
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_rewind(sd_bus_message ***_m_**, int** _complete_**);**
    


## DESCRIPTION



           **sd_bus_message_rewind()** moves the "read pointer" in the message _m_
           to either the beginning of the message (if _complete_ is true) or to
           the beginning of the currently open container. If no container is
           open, _complete_ has no effect.
    


## RETURN VALUE



           On success, this function returns 0 or a positive integer. The
           value is zero if the current container or whole message in case no
           container is open is empty, and positive otherwise. On failure, it
           returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _m_ parameter is **NULL**.
    
           **-EPERM**
               The message _m_ has not been sealed.
    


## NOTES



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


* * *
# recursive_key_scan

## NAME



           recursive_key_scan, recursive_session_key_scan - apply a function
           to all keys in a keyring tree
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **typedef int (***_recursive_key_scanner_t_**)(key_serial_t** _parent_**,**
               **key_serial_t** _key_**, char ***_desc_**, int** _desc_len_**, void ***_data_**);**
    
           **long recursive_key_scan(key_serial_t** _keyring_**,**
               **recursive_key_scanner_t** _func_**, void ***_data_**);**
           **long recursive_session_key_scan(recursive_key_scanner_t** _func_**,**
               **void ***_data_**);**
    


## DESCRIPTION



           **recursive_key_scan**() performs a depth-first recursive scan of the
           specified _keyring_ tree and applies _func_ to every link found in the
           accessible keyrings in that tree.  _data_ is passed to each
           invocation of func.
    
           The return values of _func_ are summed and returned as the overall
           return value.  Errors are ignored.  Inaccessible keyrings are not
           scanned, but links to them are still passed to func.
    
           **recursive_session_key_scan**() works exactly like
           **recursive_key_scan**() with the caller's session keyring specified
           as the starting keyring.
    
           The callback function is called for each link found in all the
           keyrings in the nominated tree and so may be called multiple times
           for a particular key if that key has multiple links to it.
    
           The callback function is passed the following parameters:
    
           **parent** The keyring containing the link or 0 for the initial key.
    
           **key** The key to which the link points.
    
           **desc** and **desc_len**
                  A pointer to the raw description and its length as
                  retrieved with **keyctl_describe_alloc**().  These will be NULL
                  and -1 respectively if the description couldn't be
                  retrieved and _errno_ will retain the error from
                  **keyctl_describe_alloc**().
    
           **data** The data passed to the scanner function.
    


## RETURN VALUE



           These functions return the sum of the results of the callback
           functions they invoke.
    


## ERRORS



           Ignored.
    


## LINKING



           When linking, **-lkeyutils** should be specified to the linker.
    


* * *
# form_userptr

## NAME



           **set_form_userptr** , **form_userptr** - associate application data with a
           form item
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_form_userptr(FORM ***_form_**, void ***_userptr_**);**
           **void* form_userptr(const FORM ***_form_**);**
    


## DESCRIPTION



           Every form and every form item has a field that can be used to
           hold application-specific data (that is, the form-driver code
           leaves it alone).  These functions get and set the form user
           pointer field.
    


## RETURN VALUE



           The function **form_userptr** returns a pointer (which may be **NULL**).
           It does not set **errno**.
    
           The function **set_form_userptr** returns **E_OK**(success).
    


## NOTES



           The header file **< form.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V forms library.  They were not
           supported on Version 7 or BSD versions.
    
           The user pointer is a void pointer.  We chose not to leave it as a
           char pointer for SVr4 compatibility.
    


* * *
# sd_bus_message_get_cookie

## NAME



           sd_bus_message_get_cookie, sd_bus_message_get_reply_cookie -
           Returns the transaction cookie of a message
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_get_cookie(sd_bus_message ***_message_**,**
                                         **uint64_t ***_cookie_**);**
    
           **int sd_bus_message_get_reply_cookie(sd_bus_message ***_message_**,**
                                               **uint64_t ***_cookie_**);**
    


## DESCRIPTION



           **sd_bus_message_get_cookie()** returns the transaction cookie of a
           message. The cookie uniquely identifies a message within each bus
           peer, but is not globally unique. It is assigned when a message is
           sent.
    
           **sd_bus_message_get_reply_cookie()** returns the transaction cookie
           of the message the specified message is a response to. When a
           reply message is generated for a method call message, its cookie
           is copied over into this field. Note that while every message that
           is transferred is identified by a cookie, only response messages
           carry a reply cookie field.
    
           Both functions take a message object as first parameter and a
           place to store the 64-bit cookie in.
    


## RETURN VALUE



           On success, these calls return 0 or a positive integer. On
           failure, they return a negative errno-style error code.
    
           On success, the cookie/reply cookie is returned in the specified
           64-bit unsigned integer variable.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               A specified parameter is invalid.
    
           **-ENODATA**
               No cookie has been assigned to this message. This either
               indicates that the message has not been sent yet and hence has
               no cookie assigned, or that the message is not a method
               response message and hence carries a reply cookie field.
    


## NOTES



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


* * *
# pmdestroycontext

## NAME



           **pmDestroyContext** - destroy a PMAPI context
    


## C SYNOPSIS



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


## DESCRIPTION



           An  application using the Performance Metrics Application Program‐
           ming Interface (PMAPI) may manipulate several concurrent contexts,
           each associated with a source of performance metrics, e.g. pmcd(1)
           on some host, or an archive of performance metrics as  created  by
           pmlogger(1).
    
           **pmDestroyContext** destroys the PMAPI context identified by _handle_.
           Typically this would imply some termination of a connection  to  a
           PMCD or closing an archive file, and orderly clean-up.
    
           The    context   must   have   been   previously   created   using
           pmNewContext(3) or pmDupContext(3).
    
           On success, **pmDestroyContext** returns zero.  If _handle_ was the cur‐
           rent PMAPI context, then the current  context  becomes  undefined.
           This  means  the  application must explicitly re-establish a valid
           PMAPI context with pmUseContext(3), or create a new  context  with
           pmNewContext(3)  or  pmDupContext(3), before the next PMAPI opera‐
           tion that requires a PMAPI context.
    


## DIAGNOSTICS



           **PM_ERR_NOCONTEXT**
    
                  _handle_ does not identify a valid PMAPI context
    


* * *
# malloc_stats

## NAME



           malloc_stats - print memory allocation statistics
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <malloc.h>**
    
           **void malloc_stats(void);**
    


## DESCRIPTION



           The **malloc_stats**() function prints (on standard error) statistics
           about memory allocated by malloc(3) and related functions.  For
           each arena (allocation area), this function prints the total
           amount of memory allocated and the total number of bytes consumed
           by in-use allocations.  (These two values correspond to the _arena_
           and _uordblks_ fields retrieved by mallinfo(3).)  In addition, the
           function prints the sum of these two statistics for all arenas,
           and the maximum number of blocks and bytes that were ever
           simultaneously allocated using mmap(2).
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## NOTES



           More detailed information about memory allocations in the main
           arena can be obtained using mallinfo(3).
    


* * *
# umad_debug

## NAME



           umad_debug - set debug level
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_debug(int** _level_**);**
    


## DESCRIPTION



           **umad_debug()** sets the umad library internal debug level to _level_.
           The following debug levels are supported: 0 - no debug (the
           default), 1 - basic debug information, 2 - verbose debug
           information. Negative values are ignored in terms of set. Note
           that the current debug level can be queried by passing a negative
           value as _level_.
    


## RETURN VALUE



           **umad_debug()** returns the actual debug level.
    


* * *
# gnu::aligned

## NAME



           gnu::aligned - set alignment of an object
    


## SYNOPSIS



           **[[gnu::aligned(**_alignment_**)]]**
           **[[gnu::aligned]]**
    


## DESCRIPTION



           This attribute can be applied to a type or a variable, and sets
           its _alignment_ in bytes.
    
           If the _alignment_ is not specified, the maximum alignment is used.
           This is equivalent to
    
               [[gnu::aligned(alignof(max_align_t))]]
    


## VERSIONS



           **__attribute__((aligned(**_alignment_**)))**
    
           **__declspec(align(**_alignment_**))**
    
           C11 provides the **_Alignas**() type specifier, which has similar
           semantics.
    


## STANDARDS



           GNU.
    


## CAVEATS



           This attribute can increase the natural alignment of a type, but
           it can't decrease it.
    
           The linker may limit the maximum alignment that can be applied.
    


* * *
# io_uring_register_reg_wait

## NAME



           io_uring_register_reg_wait - Registers fixed wait regions
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_reg_wait(struct io_uring ***_ring_**,**
                                          **struct io_uring_reg_wait ***_reg_**,**
                                          **int** _nr_**);**
    


## DESCRIPTION



           The io_uring_register_reg_wait(3) registers a fixed wait region
           starting at _reg_ and of _nentries_ entries with the ring indicated by
           _ring_.
    
           This function works like io_uring_setup_reg_wait(3), except it
           doesn't allocate any memory on behalf of the application. The
           application must pass in previously allocated memory in _reg_ , which
           must be of the right size to hold _nr_ entries and suitably aligned
           on a page boundary.
    
           The memory registered should not be freed until the ring for which
           it is registered is closed.
    
           Once a wait region has been setup, it persists for the life time
           of the ring.  It's currently not possible to unregister or resize
           a wait region.  Additionally, a wait region may currently only use
           a single page of memory.  On a 4k page size system, this means an
           application is limited to **64** wait regions. That should be enough,
           as each wait index may be modified as needed. With at least 64
           indices available, hopefully applications can just use the
           appropriately setup wait region for each specific type of wait,
           with different indices having different wait settings.
    
           Available since kernel 6.13.
    


## RETURN VALUE



           On success io_uring_register_reg_wait(3) returns **0 .** On failure,
           it returns a **-errno** value.
    


* * *
# audit_encode_value

## NAME



           audit_encode_value - encode input string to ASCII code string
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **char *audit_encode_value(char ***_final_**, const char ***_buf_**, unsigned int** _size_**);**
    


## DESCRIPTION



           **audit_encode_value**() encodes a string given by _buf_ to a ASCII code
           string.  _final_ is the hexadecimal string encoded to ASCII code.
           _size_ is the length of the string given by _buf_.
    
           e.g.: "foo bar" is encoded as "666F6F20626172". "\1\2\3\4" is
           encoded as "01020304".
    


## RETURN VALUE



           Returns a encoded string same as _final_ or, NULL on error.
    


* * *
# __pmmktime

## NAME



           **__pmMktime** - convert a **tm** structure to a calendar time
    


## C SYNOPSIS



           **#include <time.h>**
           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **time_t __pmMktime(struct tm ***_timeptr_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           **__pmMktime** is very similar to mktime(3), except the timezone  used
           is  the current ``reporting timezone'' (rather than the default **TZ**
           environment variable scheme).
    
           Like mktime(3) the time to be converted is passed via _timeptr_ , and
           the function result contains the calendar time (the number of sec‐
           onds since 00:00:00 UTC, January 1, 1970).
    
           The default current reporting timezone is as defined by the **TZ** en‐
           vironment variable, so **__pmMktime** and  mktime(3)  will  initially
           produce similar conversions.
    
           Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish
           a  new  current reporting timezone that will effect **__pmMktime** but
           not mktime(3).
    


* * *
# iswprint

## NAME



           iswprint - test for printing wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswprint(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswprint**() function is the wide-character equivalent of the
           isprint(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "print".
    
           The wide-character class "print" is disjoint from the wide-
           character class "cntrl".
    
           The wide-character class "print" contains the wide-character class
           "graph".
    


## RETURN VALUE



           The **iswprint**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "print".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_ocsp_status_request_enable_client

## NAME



           gnutls_ocsp_status_request_enable_client - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ocsp_status_request_enable_client(gnutls_session_t**
           _session_**, gnutls_datum_t ***_responder_id_**, size_t** _responder_id_size_**,**
           **gnutls_datum_t ***_extensions_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * responder_id
                       ignored, must be **NULL**
    
           size_t responder_id_size
                       ignored, must be zero
    
           gnutls_datum_t * extensions
                       ignored, must be **NULL**
    


## DESCRIPTION



           This function is to be used by clients to request OCSP response
           from the server, using the "status_request" TLS extension.  Only
           OCSP status type is supported.
    
           Previous versions of GnuTLS supported setting  _responder_id_ and
            _extensions_ fields, but due to the difficult semantics of the
           parameter usage, and other issues, this support was removed since
           3.6.0 and these parameters must be set to **NULL**.
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# gnutls_record_set_timeout

## NAME



           gnutls_record_set_timeout - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_record_set_timeout(gnutls_session_t** _session_**, unsigned**
           **int** _ms_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int ms
                       is a timeout value in milliseconds
    


## DESCRIPTION



           This function sets the receive timeout for the record layer to the
           provided value. Use an  _ms_ value of zero to disable timeout (the
           default), or **GNUTLS_INDEFINITE_TIMEOUT** , to set an indefinite
           timeout.
    
           This function requires to set a pull timeout callback. See
           **gnutls_transport_set_pull_timeout_function()**.
    


## SINCE



           3.1.7
    


* * *
# function::regparm

## NAME



           function::regparm - Specify regparm value used to compile function
    


## SYNOPSIS



               regparm(n:long)
    


## ARGUMENTS



           _n_
               original regparm value
    


## DESCRIPTION



           Call this function with argument n before accessing function
           arguments using the *_arg function is the function was build with
           the gcc -mregparm=n option.
    
           (The i386 kernel is built with \-mregparm=3, so systemtap
           considers regparm(3) the default for kernel functions on that
           architecture.) Only valid on i386 and x86_64 (when probing 32bit
           applications). Produces an error on other architectures.
    


* * *
# dirfd

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



           dirfd — extract the file descriptor used by a DIR stream
    


## SYNOPSIS



           #include <dirent.h>
    
           int dirfd(DIR *_dirp_);
    


## DESCRIPTION



           The _dirfd_() function shall return a file descriptor referring to
           the same directory as the _dirp_ argument. This file descriptor
           shall be closed by a call to _closedir_().  If any attempt is made
           to close the file descriptor, or to modify the state of the
           associated description, other than by means of _closedir_(),
           _readdir_(), _readdir_r_(), _rewinddir_(), or _seekdir_(), the behavior is
           undefined.
    


## RETURN VALUE



           Upon successful completion, the _dirfd_() function shall return an
           integer which contains a file descriptor for the stream pointed to
           by _dirp_.  Otherwise, it shall return -1 and shall set _errno_ to
           indicate the error.
    


## ERRORS



           The _dirfd_() function may fail if:
    
           **EINVAL** The _dirp_ argument does not refer to a valid directory
                  stream.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _dirfd_() function is intended to be a mechanism by which an
           application may obtain a file descriptor to use for the _fchdir_()
           function.
    


## RATIONALE



           This interface was introduced because the Base Definitions volume
           of POSIX.1‐2017 does not make public the **DIR** data structure.
           Applications tend to use the _fchdir_() function on the file
           descriptor returned by this interface, and this has proven useful
           for security reasons; in particular, it is a better technique than
           others where directory names might change.
    
           The description uses the term ``a file descriptor'' rather than
           ``the file descriptor''. The implication intended is that an
           implementation that does not use an _fd_ for _opendir_() could still
           _open_() the directory to implement the _dirfd_() function. Such a
           descriptor must be closed later during a call to _closedir_().
    
           If it is necessary to allocate an _fd_ to be returned by _dirfd_(), it
           should be done at the time of a call to _opendir_().
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pcre2_serialize_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_serialize_free(uint8_t ***_bytes_**);**
    


## DESCRIPTION



    
           This function frees the memory that was obtained by
           **pcre2_serialize_encode()** to hold a serialized byte stream. The
           argument must point to such a byte stream or be NULL, in which
           case the function returns without doing anything.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the serialization functions in
           the **pcre2serialize** page.
    


* * *
# probe::ioscheduler.elv_next_request.return

## NAME



           probe::ioscheduler.elv_next_request.return - Fires when a request
           retrieval issues a return signal
    


## SYNOPSIS



           ioscheduler.elv_next_request.return
    


## VALUES



           _disk_major_
               Disk major number of the request
    
           _rq_flags_
               Request flags
    
           _disk_minor_
               Disk minor number of the request
    
           _name_
               Name of the probe point
    
           _rq_
               Address of the request
    


* * *
# IO_URING_VERSION_MINOR

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

## NAME



           gnutls_transport_get_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_transport_ptr_t gnutls_transport_get_ptr(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



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


## RETURNS



           The first argument of the transport function.
    


* * *
# gnutls_pubkey_verify_params

## NAME



           gnutls_pubkey_verify_params - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_verify_params(gnutls_pubkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       should contain a **gnutls_pubkey_t** type
    


## DESCRIPTION



           This function will verify the public key parameters.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# auparse_reset

## NAME



           auparse_reset - reset audit parser instance
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_reset resets all internal cursors to the beginning. It
           closes files, descriptors, and frees memory buffers.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, 0 for success.
    


* * *
# probe::signal.checkperm.return

## NAME



           probe::signal.checkperm.return - Check performed on a sent signal
           completed
    


## SYNOPSIS



           signal.checkperm.return
    


## VALUES



           _name_
               Name of the probe point
    
           _retstr_
               Return value as a string
    


* * *
# gnutls_record_cork

## NAME



           gnutls_record_cork - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           If called, **gnutls_record_send()** will no longer send any records.
           Any sent records will be cached until **gnutls_record_uncork()** is
           called.
    
           This function is safe to use with DTLS after GnuTLS 3.3.0.
    


## SINCE



           3.1.9
    


* * *
# pmindom_helper

## NAME



           **pmInDom_build** , **pmInDom_domain** , **pmInDom_serial** - helper methods for
           manipulating instance domain identifiers
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **pmInDom pmInDom_build(unsigned int** _domain_**, unsigned int** _serial_**);**
           **unsigned int pmInDom_domain(pmInDom** _indom_**);**
           **unsigned int pmInDom_serial(pmInDom** _indom_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Within  the Performance Co-Pilot (PCP) each instance domain is as‐
           signed a unique Instance Domain Identifier (pmInDom).   Internally
           a  pmInDom is constructed from 2 fields: the domain number (of the
           associated Performance Metrics Domain Agent, or PMDA) and the ser‐
           ial number (assigned by the PMDA).
    
           **pmInDom_build** constructs a pmInDom from _domain_ and _serial_.
    
           **pmInDom_domain** and **pmInDom_serial** return  the  respective  fields
           from _indom_.
    


* * *
# pmsortinstances

## NAME



           **pmSortInstances** - sort performance metric values on instance
           identifier
    


## C SYNOPSIS



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


## DESCRIPTION



           The routine **pmSortInstances** may be used to guarantee that for each
           performance metric in the _result_ from pmFetch(3) the instances are
           in ascending instance identifier sequence.
    
           This is useful when computing rates from two consecutive samples.
    


## COMPATIBILITY



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


* * *
# umad_done

## NAME



           umad_init, umad_done - perform library initialization and
           finalization
    


## SYNOPSIS



                  #include <infiniband/umad.h>
    
                  int umad_init(void);
    
                  int umad_done(void);
    


## DESCRIPTION



           **umad_init()** and **umad_done()** do nothing.
    


## RETURN VALUE



           Always 0.
    


## COMPATIBILITY



           Versions prior to release 18 of the library require **umad_init()** to
           be called prior to using any other library functions.  Old
           versions could return a failure code of -1 from **umad_init()**.
    
           For compatibility, applications should continue to call
           **umad_init()** , and check the return code, prior to calling other
           **umad_** functions.  If **umad_init()** returns an error, then no further
           use of the umad library should be attempted.
    


* * *
# umad_poll

## NAME



           umad_poll - poll umad
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_poll(int** _portid_**, int** _timeout_ms_**);**
    


## DESCRIPTION



           **umad_poll()** waits up to _timeout_ms_ milliseconds for a packet to be
           received from the port specified by _portid_.  Once a packet is
           ready to be read, the function returns 0. After that the packet
           can be read using **umad_recv().** Otherwise, -ETIMEDOUT is returned.
           Note that successfully polling a port does not guarantee that the
           subsequent **umad_recv()** will be non blocking when several threads
           are using the same port. Instead, use a _timeout_ms_ parameter of
           zero to **umad_recv()** to ensure a non-blocking read.
    


## RETURN VALUE



           **umad_poll()** returns 0 on success, and a negative value on error as
           follows:
            -EINVAL    invalid port handle or agentid
            -ETIMEDOUT poll operation timed out
            -EIO       poll operation failed
    


* * *
# gnutls_x509_crt_get_private_key_usage_period

## NAME



           gnutls_x509_crt_get_private_key_usage_period - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_private_key_usage_period(gnutls_x509_crt_t**
           _cert_**, time_t ***_activation_**, time_t ***_expiration_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           time_t * activation
                       The activation time
    
           time_t * expiration
                       The expiration time
    
           unsigned int * critical
                       the extension status
    


## DESCRIPTION



           This function will return the expiration and activation times of
           the private key of the certificate. It relies on the PKIX
           extension 2.5.29.16 being present.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


* * *