tripathysagar/man_text huggingface dataset:
# gnutls_x509_crt_get_subject_alt_name

## NAME



           gnutls_x509_crt_get_subject_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_subject_alt_name(gnutls_x509_crt_t** _cert_**,**
           **unsigned int** _seq_**, void ***_san_**, size_t ***_san_size_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * san  is the place where the alternative name will be copied
                       to
    
           size_t * san_size
                       holds the size of san.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function retrieves the Alternative Name (2.5.29.17),
           contained in the given certificate in the X509v3 Certificate
           Extensions.
    
           When the SAN type is otherName, it will extract the data in the
           otherName's value field, and **GNUTLS_SAN_OTHERNAME** is returned.
           You may use **gnutls_x509_crt_get_subject_alt_othername_oid()** to get
           the corresponding OID and the "virtual" SAN types (e.g.,
           **GNUTLS_SAN_OTHERNAME_XMPP**).
    
           If an otherName OID is known, the data will be decoded.  Otherwise
           the returned data will be DER encoded, and you will have to decode
           it yourself.  Currently, only the RFC 3920 id-on-xmppAddr SAN is
           recognized.
    


## RETURNS



           the alternative subject name type on success, one of the
           enumerated **gnutls_x509_subject_alt_name_t**.  It will return
           **GNUTLS_E_SHORT_MEMORY_BUFFER** if  _san_size_ is not large enough to
           hold the value.  In that case  _san_size_ will be updated with the
           required size.  If the certificate does not have an Alternative
           name with the specified sequence number then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


* * *
# probe::stap.cache_add_mod

## NAME



           probe::stap.cache_add_mod - Adding kernel instrumentation module
           to cache
    


## SYNOPSIS



           stap.cache_add_mod
    


## VALUES



           _source_path_
               the path the .ko file is coming from (incl filename)
    
           _dest_path_
               the path the .ko file is going to (incl filename)
    


## DESCRIPTION



           Fires just before the file is actually moved. Note: if moving
           fails, cache_add_src and cache_add_nss will not fire.
    


* * *
# lber-memory

## NAME



           ber_memalloc, ber_memcalloc, ber_memrealloc, ber_memfree,
           ber_memvfree - OpenLDAP LBER memory allocators
    


## LIBRARY



           OpenLDAP LBER (liblber, -llber)
    


## SYNOPSIS



           **#include <lber.h>**
    
           **void *ber_memalloc(ber_len_t** _bytes_**);**
    
           **void *ber_memcalloc(ber_len_t** _nelems_**, ber_len_t** _bytes_**);**
    
           **void *ber_memrealloc(void ***_ptr_**, ber_len_t** _bytes_**);**
    
           **void ber_memfree(void ***_ptr_**);**
    
           **void ber_memvfree(void ****_vec_**);**
    


## DESCRIPTION



           These routines are used to allocate/deallocate memory
           used/returned by the Lightweight BER library as required by
           lber-encode(3) and lber-decode(3).  **ber_memalloc**(),
           **ber_memcalloc**(), **ber_memrealloc**(), and **ber_memfree**() are used
           exactly like the standard malloc(3), calloc(3), realloc(3), and
           free(3) routines, respectively.  The **ber_memvfree**() routine is
           used to free a dynamically allocated array of pointers to
           arbitrary dynamically allocated objects.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# gnutls_x509_crt_set_serial

## NAME



           gnutls_x509_crt_set_serial - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_serial(gnutls_x509_crt_t** _cert_**, const void**
           *****_serial_**, size_t** _serial_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * serial
                       The serial number
    
           size_t serial_size
                       Holds the size of the serial field.
    


## DESCRIPTION



           This function will set the X.509 certificate's serial number.
           While the serial number is an integer, it is often handled as an
           opaque field by several CAs. For this reason this function accepts
           any kind of data as a serial number. To be consistent with the
           X.509/PKIX specifications the provided  _serial_ should be a
           big-endian positive number (i.e. its leftmost bit should be zero).
    
           The size of the serial is restricted to 20 bytes maximum by
           RFC5280.  This function allows writing more than 20 bytes but the
           generated certificates in that case may be rejected by other
           implementations.
    


## RETURNS



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


* * *
# tapset::udp

## NAME



           tapset::udp - systemtap udp tapset
    


## DESCRIPTION



            This family of probe points is used to probe events that occur in
           the UDP layer.
    
           **udp.sendmsg**
                  Fires whenever a process sends a UDP message
    
                   See probe::udp.sendmsg(3stap)
                   for details.
    
           **udp.sendmsg.return**
                  Fires whenever an attempt to send a UDP message is
                  completed
    
                   See probe::udp.sendmsg.return(3stap)
                   for details.
    
           **udp.recvmsg**
                  Fires whenever a UDP message is received
    
                   See probe::udp.recvmsg(3stap)
                   for details.
    
           **udp.recvmsg.return**
                  Fires whenever an attempt to receive a UDP message received
                  is completed
    
                   See probe::udp.recvmsg.return(3stap)
                   for details.
    
           **udp.disconnect**
                  Fires when a process requests for a UDP disconnection
    
                   See probe::udp.disconnect(3stap)
                   for details.
    
           **udp.disconnect.return**
                  UDP has been disconnected successfully
    
                   See probe::udp.disconnect.return(3stap)
                   for details.
    


* * *
# pcap_init

## NAME



           pcap_init - initialize the library
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **char errbuf[PCAP_ERRBUF_SIZE];**
    
           **int pcap_init(unsigned int opts, char *errbuf);**
    


## DESCRIPTION



           **pcap_init**() is used to initialize the Packet Capture library.
           _opts_ specifies options for the library; _errbuf_ is a buffer large
           enough to hold at least **PCAP_ERRBUF_SIZE** chars.
    
           Currently, the options that can be specified in _opts_ are:
    
           **PCAP_MMAP_32BIT**
                  Map packet buffers with 32-bit addresses.
    
           **PCAP_CHAR_ENC_LOCAL**
                  Treat all strings supplied as arguments, and return all
                  strings to the caller, as being in the local character
                  encoding.
    
           **PCAP_CHAR_ENC_UTF_8**
                  Treat all strings supplied as arguments, and return all
                  strings to the caller, as being in UTF-8.
    
           On UNIX-like systems, the local character encoding is assumed to
           be UTF-8, so no character encoding transformations are done.
    
           On Windows, the local character encoding is the local ANSI code
           page.
    
           If **pcap_init**() is not called, strings are treated as being in the
           local ANSI code page on Windows, **pcap_lookupdev**(3PCAP) will
           succeed if there is a device on which to capture, and
           **pcap_create**(3PCAP) makes an attempt to check whether the string
           passed as an argument is a UTF-16LE string - note that this
           attempt is unsafe, as it may run past the end of the string - to
           handle **pcap_lookupdev**() returning a UTF-16LE string.
    


## RETURN VALUE



           **pcap_init**() returns **0** on success and **PCAP_ERROR** on failure.  If
           **PCAP_ERROR** is returned, _errbuf_ is filled in with an appropriate
           error message.
    


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.9.0.  In
           previous releases, on Windows, all strings supplied as arguments,
           and all strings returned to the caller, are in the local character
           encoding.
    


* * *
# pmgetderivedcontrol

## NAME



           **pmGetDerivedControl** , **pmSetDerivedControl** - get and set controls
           for derived metrics
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetDerivedControl(int** _what_**, int ***_valuep_**);**
           **int pmSetDerivedControl(int** _what_**, int** _value_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           These  routines  may be used to influence the behaviour of the de‐
           rived metric services that are activated for global  derived  met‐
           rics  using  pmRegisterDerived(3),  pmRegisterDerivedMetric(3) and
           pmLoadDerivedConfig(3),  or  per-context  derived  metrics   using
           pmAddDerived(3) and pmAddDerivedMetric(3).
    
           The _what_ argument selects a control, the _value_ argument provides a
           value  for  **pmSetDerivedControl** and the _valuep_ argument is used to
           return the value for **pmGetDerivedControl**.
    
           The _what_ argument has one of the following values:
    
           **PCP_DERIVED_GLOBAL_LIMIT**
                  The maximum number of global derived metrics that may be
                  defined.  The value -1 indicates no limit.
    
           **PCP_DERIVED_CONTEXT_LIMIT**
                  The maximum number of per-context derived metrics that may
                  be defined.  The value -1 indicates no limit.
    
           **PCP_DERIVED_DEBUG_SYNTAX**
                  Debug diagnostics during parsing of derived metric expres‐
                  sion.  The value 1 enables the diagnostics, the value 0
                  disables them.
    
           **PCP_DERIVED_DEBUG_SEMANTICS**
                  Debug diagnostics for semantic checks during the binding of
                  metrics in the derived metric expression to the available
                  metrics in a new PMAPI context.  The value 1 enables the
                  diagnostics, the value 0 disables them.
    
           **PCP_DERIVED_DEBUG_EVAL**
                  Debug diagnostics when derived metrics are used in PMAPI
                  operations like pmFetch(3), pmGetChildren(3),
                  pmGetChildrenStatus(3), pmLookupDesc(3), pmLookupName(3),
                  pmNameAll(3), pmNameID(3) and pmTraversePMNS(3).
    


## RETURN VALUES



           Both routines return 0 on success, else a value less than 0 that
           can be decoded using pmErrStr(3).
    


* * *
# isupper

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



           isupper, isupper_l — test for an uppercase letter
    


## SYNOPSIS



           #include <ctype.h>
    
           int isupper(int _c_);
           int isupper_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isupper_(): 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 _isupper_() and _isupper_l_() functions shall test whether _c_ is a
           character of class **upper** in the current locale, or in the locale
           represented by _locale_ , respectively; see the Base Definitions
           volume of POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _c_ argument is an **int** , the value of which the application shall
           ensure is a character representable as an **unsigned char** or equal
           to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isupper_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isupper_() and _isupper_l_() functions shall return non-zero if _c_
           is an uppercase letter; otherwise, they shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# form_new_page

## NAME



           **set_new_page** , **new_page** - form pagination functions
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_new_page(FIELD ***_field_**, bool** _new_page_flag_**);**
           **bool new_page(const FIELD ***_field_**);**
    


## DESCRIPTION



           The function **set_new_page** sets or resets a flag marking the given
           field as the beginning of a new page on its form.
    
           The function **new_page** is a predicate which tests if a given field
           marks a page beginning on its form.
    


## RETURN VALUE



           The function **new_page** returns **TRUE** or **FALSE**.
    
           The function **set_new_page** returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_CONNECTED**
                The given field is already connected to a form.
    


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


* * *
# libpfm_intel_icx_unc_ubox

## NAME



           libpfm_intel_icx_unc_ubox - support for Intel IcelakeX Server UBOX
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_ubox**
           **PMU desc: Intel IcelakeX UBOX uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX UBOX (System configuration
           controller) uncore PMU. There is one UBOX per processor.  Each
           UBOX PMU implements 4 generic counters.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX UBOX
           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 UBOX clockticks 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 threshold (t) test from strictly greater than to
                  less or equal to. This is a boolean modifier.
    


* * *
# mbtowc

## NAME



           mbtowc - convert a multibyte sequence to a wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int mbtowc(** size_t n;
                      **wchar_t *restrict** _pwc_**, const char** _s_**[restrict** _n_**], size_t** _n_**);**
    


## DESCRIPTION



           The main case for this function is when _s_ is not NULL and _pwc_ is
           not NULL.  In this case, the **mbtowc**() function inspects at most _n_
           bytes of the multibyte string starting at _s_ , extracts the next
           complete multibyte character, converts it to a wide character and
           stores it at _*pwc_.  It updates an internal shift state known only
           to the **mbtowc**() function.  If _s_ does not point to a null byte
           ('\0'), it returns the number of bytes that were consumed from _s_ ,
           otherwise it returns 0.
    
           If the _n_ bytes starting at _s_ do not contain a complete multibyte
           character, or if they contain an invalid multibyte sequence,
           **mbtowc**() returns -1.  This can happen even if _n_ >= _MB_CUR_MAX_ , if
           the multibyte string contains redundant shift sequences.
    
           A different case is when _s_ is not NULL but _pwc_ is NULL.  In this
           case, the **mbtowc**() function behaves as above, except that it does
           not store the converted wide character in memory.
    
           A third case is when _s_ is NULL.  In this case, _pwc_ and _n_ are
           ignored.  The **mbtowc**() function resets the shift state, only known
           to this function, to the initial state, and returns nonzero if the
           encoding has nontrivial shift state, or zero if the encoding is
           stateless.
    


## RETURN VALUE



           If _s_ is not NULL, the **mbtowc**() function returns the number of
           consumed bytes starting at _s_ , or 0 if _s_ points to a null byte, or
           -1 upon failure.
    
           If _s_ is NULL, the **mbtowc**() function returns nonzero if the
           encoding has nontrivial shift state, or zero if the encoding is
           stateless.
    


## ATTRIBUTES



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


## VERSIONS



           This function is not multithread safe.  The function mbrtowc(3)
           provides a better interface to the same functionality.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_privkey_export_x509

## NAME



           gnutls_privkey_export_x509 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_x509(gnutls_privkey_t** _pkey_**,**
           **gnutls_x509_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_x509_privkey_t * key
                       Location for the key to be exported.
    


## DESCRIPTION



           Converts the given abstract private key to a **gnutls_x509_privkey_t**
           type. The abstract key must be of type **GNUTLS_PRIVKEY_X509**. The
           input
            _key_ must not be initialized. The key returned in  _key_ should be
           deinitialized using **gnutls_x509_privkey_deinit()**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# ibv_open_qp

## NAME



           ibv_open_qp - open a shareable queue pair (QP)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_qp *ibv_open_qp(struct ibv_context** _*context_**,**
                                      **struct ibv_qp_open_attr** _*qp_open_attr_**);**
    


## DESCRIPTION



           **ibv_open_qp()** opens an existing queue pair (QP) associated with
           the extended protection domain _xrcd_.  The argument _qp_open_attr_ is
           an ibv_qp_open_attr struct, as defined in <infiniband/verbs.h>.
    
           struct ibv_qp_open_attr {
                   uint32_t          comp_mask;  /* Identifies valid fields */
                   uint32_t          qp_num;     /* QP number */
                   struct            *ibv_xrcd;  /* XRC domain */
                   void             *qp_context; /* User defined opaque value */
                   enum ibv_qp_type  qp_type;    /* QP transport service type */
    
           **ibv_destroy_qp()** closes the opened QP and destroys the underlying
           QP if it has no other references.  _qp_.
    


## RETURN VALUE



           **ibv_open_qp()** returns a pointer to the opened QP, or NULL if the
           request fails.  Check the QP number (**qp_num**) in the returned QP.
    


## NOTES



           **ibv_open_qp()** will fail if a it is asked to open a QP that does
           not exist within the xrcd with the specified qp_num and qp_type.
    


* * *
# isgraph

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



           isgraph, isgraph_l — test for a visible character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isgraph(int _c_);
           int isgraph_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isgraph_(): 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 _isgraph_() and _isgraph_l_() functions shall test whether _c_ is a
           character of class **graph** in the current locale, or in the locale
           represented by _locale_ , respectively; see the Base Definitions
           volume of POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _c_ argument is an **int** , the value of which the application shall
           ensure is a character representable as an **unsigned char** or equal
           to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isgraph_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isgraph_() and _isgraph_l_() functions shall return non-zero if _c_
           is a character with a visible representation; otherwise, they
           shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_aki_get_id

## NAME



           gnutls_x509_aki_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aki_get_id(gnutls_x509_aki_t** _aki_**, gnutls_datum_t ***
           _id_**);**
    


## ARGUMENTS



           gnutls_x509_aki_t aki
                       The authority key ID
    
           gnutls_datum_t * id
                       Will hold the identifier
    


## DESCRIPTION



           This function will return the key identifier as stored in the  _aki_
           type. The identifier should be treated as constant.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the index is out of
           bounds, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# gnutls_pcert_import_x509_raw

## NAME



           gnutls_pcert_import_x509_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_x509_raw(gnutls_pcert_st ***_pcert_**, const**
           **gnutls_datum_t ***_cert_**, gnutls_x509_crt_fmt_t** _format_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure
    
           const gnutls_datum_t * cert
                       The raw certificate to be imported
    
           gnutls_x509_crt_fmt_t format
                       The format of the certificate
    
           unsigned int flags
                       zero for now
    


## DESCRIPTION



           This convenience function will import the given certificate to a
           **gnutls_pcert_st** structure. The structure must be deinitialized
           afterwards using **gnutls_pcert_deinit()** ;
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# wcsstr

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



           wcsstr — find a wide-character substring
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcsstr(const wchar_t *restrict _ws1_ ,
               const wchar_t *restrict _ws2_);
    


## 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 _wcsstr_() function shall locate the first occurrence in the
           wide-character string pointed to by _ws1_ of the sequence of wide
           characters (excluding the terminating null wide character) in the
           wide-character string pointed to by _ws2_.
    


## RETURN VALUE



           Upon successful completion, _wcsstr_() shall return a pointer to the
           located wide-character string, or a null pointer if the wide-
           character string is not found.
    
           If _ws2_ points to a wide-character string with zero length, the
           function shall return _ws1_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# wcsncpy

## NAME



           wcsncpy - copy a fixed-size string of wide characters
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcsncpy(** size_t n;
                            **wchar_t** _dest_**[restrict** _n_**],**
                            **const wchar_t *restrict** _src_**,**
                            **size_t** _n_**);**
    


## DESCRIPTION



           The **wcsncpy**() function is the wide-character equivalent of the
           strncpy(3) function.  It copies at most _n_ wide characters from the
           wide-character string pointed to by _src_ , including the terminating
           null wide character (L'\0'), to the array pointed to by _dest_.
           Exactly _n_ wide characters are written at _dest_.  If the length
           _wcslen(src)_ is smaller than _n_ , the remaining wide characters in
           the array pointed to by _dest_ are filled with null wide characters.
           If the length _wcslen(src)_ is greater than or equal to _n_ , the
           string pointed to by _dest_ will not be terminated by a null wide
           character.
    
           The strings may not overlap.
    
           The programmer must ensure that there is room for at least _n_ wide
           characters at _dest_.
    


## RETURN VALUE



           **wcsncpy**() returns _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmgetindomarchive

## NAME



           **pmGetInDomArchive** - get instance identifiers for a performance
           metrics instance domain
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetInDomArchive(pmInDom** _indom_**, int ****_instlist_**,**
                                 **char *****_namelist_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Provided  the  current Performance Metrics Application Programming
           Interface (PMAPI) context is associated with a  set  of  archives,
           **pmGetInDomArchive** will  scan the union of all the instance domain
           metadata for the instance domain _indom_ , and  return  via  _instlist_
           the  internal  instance  identifiers  for  all  instances, and via
           _namelist_ the full external identifiers for all instances.
    
           This routine is a specialized version of the  more  general  PMAPI
           routine **pmGetInDom**.
    
           The  number  of  instances found is returned as the function value
           (else less than zero to indicate an error).
    
           The value for the instance domain  _indom_  is  typically  extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           The   resulting   lists  of  instance  identifiers  (_instlist_  and
           _namelist_), and the names that the elements of _namelist_  point  to,
           will  have  been  allocated by **pmGetInDomArchive** with two calls to
           malloc(3), and it is the responsibility of the caller to  _free(in‐_
           _stlist)_  and  _free(namelist)_  to  release  the space when it is no
           longer required.
    
           When the result of **pmGetInDomArchive** is less than  one,  both  _in‐_
           _stlist_  and  _namelist_ are undefined (no space will have been allo‐
           cated, and so calling free(3) is a singularly bad idea).
    


## DIAGNOSTICS



           **PM_ERR_NOTARCHIVE**
                  the current PMAPI context is not associated with a set of
                  archives
    
           **PM_ERR_INDOM_LOG**
                  _indom_ is not a defined instance domain identifier for the
                  set of archives
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to parameter‐
           ize the file and directory names used by PCP.  On each installa‐
           tion, the file _/etc/pcp.conf_ contains the local values for these
           variables.  The **$PCP_CONF** variable may be used to specify an al‐
           ternative configuration file, as described in pcp.conf(5).  Values
           for these variables may be obtained programmatically using the
           pmGetConfig(3) function.
    


* * *
# gnutls_session_get_keylog_function

## NAME



           gnutls_session_get_keylog_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_keylog_func gnutls_session_get_keylog_function(const**
           **gnutls_session_t** _session_**);**
    


## ARGUMENTS



           const gnutls_session_t session
                       is **gnutls_session_t** type
    


## DESCRIPTION



           This function will return the callback function set using
           **gnutls_session_set_keylog_function()**.
    


## RETURNS



           The function set or **NULL** otherwise.
    


## SINCE



           3.6.13
    


* * *
# probe::scheduler.wait_task

## NAME



           probe::scheduler.wait_task - Waiting on a task to unschedule
           (become inactive)
    


## SYNOPSIS



           scheduler.wait_task
    


## VALUES



           _task_pid_
               PID of the task the scheduler is waiting on
    
           _name_
               name of the probe point
    
           _task_priority_
               priority of the task
    


* * *
# function::task_ns_euid

## NAME



           function::task_ns_euid - The effective user identifier of the task
    


## SYNOPSIS



               task_ns_euid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the effective user id of the given task.
    


* * *
# probe::nfs.fop.sendfile

## NAME



           probe::nfs.fop.sendfile - NFS client send file operation
    


## SYNOPSIS



           nfs.fop.sendfile
    


## VALUES



           _cache_valid_
               cache related bit mask flag
    
           _ppos_
               current position of file
    
           _attrtimeo_
               how long the cached information is assumed to be valid. We
               need to revalidate the cached attrs for this inode if jiffies
               - read_cache_jiffies > attrtimeo.
    
           _dev_
               device identifier
    
           _ino_
               inode number
    
           _count_
               read bytes
    
           _cache_time_
               when we started read-caching this inode
    


* * *
# umask

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



           umask — set and get the file mode creation mask
    


## SYNOPSIS



           #include <sys/stat.h>
    
           mode_t umask(mode_t _cmask_);
    


## DESCRIPTION



           The _umask_() function shall set the file mode creation mask of the
           process to _cmask_ and return the previous value of the mask. Only
           the file permission bits of _cmask_ (see _< sys/stat.h>_) are used; the
           meaning of the other bits is implementation-defined.
    
           The file mode creation mask of the process is used to turn off
           permission bits in the _mode_ argument supplied during calls to the
           following functions:
    
            *  _open_(), _openat_(), _creat_(), _mkdir_(), _mkdirat_(), _mkfifo_(), and
               _mkfifoat_()
    
            *  _mknod_(), _mknodat_()
    
            *  _mq_open_()
    
            *  _sem_open_()
    
           Bit positions that are set in _cmask_ are cleared in the mode of the
           created file.
    


## RETURN VALUE



           The file permission bits in the value returned by _umask_() shall be
           the previous value of the file mode creation mask. The state of
           any other bits in that value is unspecified, except that a
           subsequent call to _umask_() with the returned value as _cmask_ shall
           leave the state of the mask the same as its state before the first
           call, including any unspecified use of those bits.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Unsigned argument and return types for _umask_() were proposed. The
           return type and the argument were both changed to **mode_t**.
    
           Historical implementations have made use of additional bits in
           _cmask_ for their implementation-defined purposes. The addition of
           the text that the meaning of other bits of the field is
           implementation-defined permits these implementations to conform to
           this volume of POSIX.1‐2017.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::pid

## NAME



           function::pid - Returns the ID of a target process
    


## SYNOPSIS



               pid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the ID of a target process.
    


* * *
# libudev

## NAME



           libudev - API for enumerating and introspecting local devices
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **pkg-config --cflags --libs libudev**
    


## DESCRIPTION



           libudev.h provides an API to introspect and enumerate devices on
           the local system. This library is supported, but should not be
           used in new projects. Please see sd-device(3) for an equivalent
           replacement with a more modern API.
    
           All functions require a libudev context to operate. This context
           can be created via udev_new(3). It is used to track library state
           and link objects together. No global state is used by libudev,
           everything is always linked to a udev context.
    
           All functions listed here are thread-agnostic and only a single
           specific thread may operate on a given object during its entire
           lifetime. It is safe to allocate multiple independent objects and
           use each from a specific thread in parallel. However, it is not
           safe to allocate such an object in one thread, and operate or free
           it from any other, even if locking is used to ensure these threads
           do not operate on it at the very same time.
    
           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.
    
           To introspect a local device on a system, a udev device object can
           be created via udev_device_new_from_syspath(3) and friends. The
           device object allows one to query current state, read and write
           attributes and lookup properties of the device in question.
    
           To enumerate local devices on the system, an enumeration object
           can be created via udev_enumerate_new(3).
    
           To monitor the local system for hotplugged or unplugged devices, a
           monitor can be created via udev_monitor_new_from_netlink(3).
    
           Whenever libudev returns a list of objects, the udev_list_entry(3)
           API should be used to iterate, access and modify those lists.
    
           Furthermore, libudev also exports legacy APIs that should not be
           used by new software (and as such are not documented as part of
           this manual). This includes the hardware database known as
           **udev_hwdb**(please use the new sd-hwdb(3) API instead) and the
           **udev_queue** object to query the udev daemon (which should not be
           used by new software at all).
    


* * *
# atanh

## NAME



           atanh, atanhf, atanhl - inverse hyperbolic tangent function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions calculate the inverse hyperbolic tangent of _x_ ;
           that is the value whose hyperbolic tangent is _x_.
    


## RETURN VALUE



           On success, these functions return the inverse hyperbolic tangent
           of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 (-0), +0 (-0) is returned.
    
           If _x_ is +1 or -1, a pole error occurs, and the functions return
           **HUGE_VAL** , **HUGE_VALF** , or **HUGE_VALL** , respectively, with the
           mathematically correct sign.
    
           If the absolute value of _x_ is greater than 1, a domain error
           occurs, and a NaN is returned.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x_ less than -1 or greater than +1
                  _errno_ is set to **EDOM**.  An invalid floating-point exception
                  (**FE_INVALID**) is raised.
    
           Pole error: _x_ is +1 or -1
                  _errno_ is set to **ERANGE**(but see BUGS).  A divide-by-zero
                  floating-point exception (**FE_DIVBYZERO**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           In glibc 2.9 and earlier, when a pole error occurs, _errno_ is set
           to **EDOM** instead of the POSIX-mandated **ERANGE**.  Since glibc 2.10,
           glibc does the right thing.
    


* * *
# gnutls_x509_ext_deinit

## NAME



           gnutls_x509_ext_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_ext_deinit(gnutls_x509_ext_st ***_ext_**);**
    


## ARGUMENTS



           gnutls_x509_ext_st * ext
                       The extensions structure
    


## DESCRIPTION



           This function will deinitialize an extensions structure.
    


## SINCE



           3.3.8
    


* * *
# gnutls_x509_crt_set_private_key_usage_period

## NAME



           gnutls_x509_crt_set_private_key_usage_period - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_private_key_usage_period(gnutls_x509_crt_t**
           _crt_**, time_t** _activation_**, time_t** _expiration_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           time_t activation
                       The activation time
    
           time_t expiration
                       The expiration time
    


## DESCRIPTION



           This function will set the private key usage period extension
           (2.5.29.16).
    


## RETURNS



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


* * *
# gnutls_x509_crl_set_next_update

## NAME



           gnutls_x509_crl_set_next_update - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_next_update(gnutls_x509_crl_t** _crl_**, time_t**
           _exp_time_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           time_t exp_time
                       The actual time
    


## DESCRIPTION



           This function will set the time this CRL will be updated.  This is
           an optional value to be set on a CRL and this call can be omitted
           when generating a CRL.
    
           Prior to GnuTLS 3.5.7, setting a nextUpdate field was required in
           order to generate a CRL.
    


## RETURNS



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


* * *
# gnutls_pkcs11_token_get_random

## NAME



           gnutls_pkcs11_token_get_random - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_get_random(const char ***_token_url_**, void ***
           _rnddata_**, size_t** _len_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           void * rnddata
                       A pointer to the memory area to be filled with random
                       data
    
           size_t len  The number of bytes of randomness to request
    


## DESCRIPTION



           This function will get random data from the given token.  It will
           store rnddata and fill the memory pointed to by rnddata with len
           random bytes from the token.
    


## RETURNS



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


* * *