tripathysagar/man_text huggingface dataset:
# gnutls_x509_crt_get_extension_data

## NAME



           gnutls_x509_crt_get_extension_data - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_extension_data(gnutls_x509_crt_t** _cert_**,**
           **unsigned** _indx_**, void ***_data_**, size_t ***_sizeof_data_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       Specifies which extension OID to send. Use (0) to get
                       the first one.
    
           void * data a pointer to a structure to hold the data (may be
                       null)
    
           size_t * sizeof_data
                       initially holds the size of  _data_
    


## DESCRIPTION



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


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# acl_set_permset

## NAME



           **acl_set_permset** — set the permission set in an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_set_permset**(_acl_entry_t entry_d_ ,
           _acl_permset_t permset_d_)
    


## DESCRIPTION



           The **acl_set_permset**() function sets the permission set of the ACL
           entry indicated by the argument _entry_d_ to the permissions
           contained in the argument _permset_d_.
    
           Any ACL entry descriptors that refer to the entry containing the
           permission set referred to by _permset_d_ shall continue to refer to
           those entries. Any ACL entry descriptors that refer to the entry
           referred to by _entry_d_ shall continue to refer to that entry.
    


## RETURN VALUE



           The **acl_set_permset**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_set_permset**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _entry_d_ is not a valid descriptor
                              for an ACL entry.
    
                              The argument _permset_d_ is not a valid
                              descriptor for a permission set within an ACL
                              entry.
    
                              The argument _permset_d_ contains values which
                              are not valid _acl_permset_t_ values.
    


## STANDARDS



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


* * *
# wcswidth

## NAME



           wcswidth - determine columns needed for a fixed-size wide-
           character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _XOPEN_SOURCE** /* See feature_test_macros(7) */
           **#include <wchar.h>**
    
           **int wcswidth(const wchar_t ***_s_**, size_t** _n_**);**
    


## DESCRIPTION



           The **wcswidth**() function returns the number of columns needed to
           represent the wide-character string pointed to by _s_ , but at most _n_
           wide characters.  If a nonprintable wide character occurs among
           these characters, -1 is returned.
    


## RETURN VALUE



           The **wcswidth**() function returns the number of column positions for
           the wide-character string _s_ , truncated to at most length _n_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_session_set_ptr

## NAME



           gnutls_session_set_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_set_ptr(gnutls_session_t** _session_**, void ***_ptr_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * ptr  is the user pointer
    


## DESCRIPTION



           This function will set (associate) the user given pointer  _ptr_ to
           the session structure.  This pointer can be accessed with
           **gnutls_session_get_ptr()**.
    


* * *
# pcre2_jit_match

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_jit_match(const pcre2_code ***_code_**, PCRE2_SPTR** _subject_**,**
             **PCRE2_SIZE** _length_**, PCRE2_SIZE** _startoffset_**,**
             **uint32_t** _options_**, pcre2_match_data ***_match_data_**,**
             **pcre2_match_context ***_mcontext_**);**
    


## DESCRIPTION



    
           This function matches a compiled regular expression that has been
           successfully processed by the JIT compiler against a given subject
           string, using a matching algorithm that is similar to Perl's. It
           is a "fast path" interface to JIT, and it bypasses some of the
           sanity checks that **pcre2_match()** applies.
    
           In UTF mode, the subject string is not checked for UTF validity.
           Unless PCRE2_MATCH_INVALID_UTF was set when the pattern was
           compiled, passing an invalid UTF string results in undefined
           behaviour. Your program may crash or loop or give wrong results.
           In the absence of PCRE2_MATCH_INVALID_UTF you should only call
           **pcre2_jit_match()** in UTF mode if you are sure the subject is
           valid.
    
           The arguments for **pcre2_jit_match()** are exactly the same as for
           **pcre2_match()** , except that the subject string must be specified
           with a length; PCRE2_ZERO_TERMINATED is not supported.
    
           The supported options are PCRE2_NOTBOL, PCRE2_NOTEOL,
           PCRE2_NOTEMPTY, PCRE2_NOTEMPTY_ATSTART, PCRE2_PARTIAL_HARD, and
           PCRE2_PARTIAL_SOFT. Unsupported options are ignored.
    
           The return values are the same as for **pcre2_match()** plus
           PCRE2_ERROR_JIT_BADOPTION if a matching mode (partial or complete)
           is requested that was not compiled. For details of partial
           matching, see the **pcre2partial** page.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the JIT API in the **pcre2jit**
           page.
    


* * *
# gnutls_x509_crt_set_spki

## NAME



           gnutls_x509_crt_set_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_spki(gnutls_x509_crt_t** _crt_**, const**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_x509_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will set the certificate's subject public key
           information explicitly. This is intended to be used in the cases
           where a single public key (e.g., RSA) can be used for multiple
           signature algorithms (RSA PKCS1-1.5, and RSA-PSS).
    
           To export the public key (i.e., the SubjectPublicKeyInfo part),
           check **gnutls_pubkey_import_x509()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# sctp_getpaddrs

## NAME



           sctp_getpaddrs - Returns all peer addresses in an association.
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <netinet/sctp.h>**
    
           **int sctp_getpaddrs(int** _sd_**, sctp_assoc_t** _assoc_id_**,**
                              **struct sockaddr ****_addrs_**);**
    
           **void sctp_freepaddrs(struct sockaddr ***_addrs_**);**
    


## DESCRIPTION



           **sctp_getpaddrs** returns all peer addresses in an association. On
           return, _addrs_ will point to a dynamically allocated packed array
           of **sockaddr** structures of the appropriate type for each address.
           The caller should use **sctp_freepaddrs** to free the memory. Note
           that the in/out parameter _addrs_ must not be NULL.
    
           If _sd_ is an IPv4 socket, the addresses returned will be all IPv4
           addresses. If _sd_ is an IPv6 socket, the addresses returned can be
           a mix of IPv4 or IPv6 addresses.
    
           For one-to-many style sockets, _id_ specifies the association to
           query. For one-to-one style sockets, _id_ is ignored.
    
           **sctp_freepaddrs** frees all the resources allocated by
           **sctp_getpaddrs.**
    


## RETURN VALUE



           On success, **sctp_getpaddrs** returns the number of peer addresses in
           the association. If there is no association on this socket, 0 is
           returned and the value of _*addrs_ is undefined. On error,
           **sctp_getpaddrs** returns -1 and the value of _*addrs_ is undefined.
    


* * *
# gnutls_psk_set_params_function

## NAME



           gnutls_psk_set_params_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_params_function(gnutls_psk_server_credentials_t**
           _res_**, gnutls_params_function ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t res
                       is a gnutls_psk_server_credentials_t type
    
           gnutls_params_function * func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback in order for the server to get
           the Diffie-Hellman or RSA parameters for PSK authentication.  The
           callback should return **GNUTLS_E_SUCCESS**(0) on success.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# gnutls_x509_trust_list_add_crls

## NAME



           gnutls_x509_trust_list_add_crls - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_add_crls(gnutls_x509_trust_list_t** _list_**,**
           **const gnutls_x509_crl_t ***_crl_list_**, unsigned** _crl_size_**, unsigned**
           **int** _flags_**, unsigned int** _verification_flags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const gnutls_x509_crl_t * crl_list
                       A list of CRLs
    
           unsigned crl_size
                       The length of the CRL list
    
           unsigned int flags
                       flags from **gnutls_trust_list_flags_t**
    
           unsigned int verification_flags
                       gnutls_certificate_verify_flags if flags specifies
                       GNUTLS_TL_VERIFY_CRL
    


## DESCRIPTION



           This function will add the given certificate revocation lists to
           the trusted list. The CRLs in  _crl_list_ must not be deinitialized
           during the lifetime of  _list_ .
    
           This function must be called after
           **gnutls_x509_trust_list_add_cas()** to allow verifying the CRLs for
           validity. If the flag **GNUTLS_TL_NO_DUPLICATES** is given, then the
           final CRL list will not contain duplicate entries.
    
           If the flag **GNUTLS_TL_NO_DUPLICATES** is given,
           **gnutls_x509_trust_list_deinit()** must be called with parameter  _all_
           being 1.
    
           If flag **GNUTLS_TL_VERIFY_CRL** is given the CRLs will be verified
           before being added, and if verification fails, they will be
           skipped.
    


## RETURNS



           The number of added elements is returned; that includes duplicate
           entries.
    


## SINCE



           3.0
    


* * *
# feraiseexcept

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



           feraiseexcept — raise floating-point exception
    


## SYNOPSIS



           #include <fenv.h>
    
           int feraiseexcept(int _excepts_);
    


## 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 _feraiseexcept_() function shall attempt to raise the supported
           floating-point exceptions represented by the _excepts_ argument. The
           order in which these floating-point exceptions are raised is
           unspecified, except that if the _excepts_ argument represents IEC
           60559 valid coincident floating-point exceptions for atomic
           operations (namely overflow and inexact, or underflow and
           inexact), then overflow or underflow shall be raised before
           inexact.  Whether the _feraiseexcept_() function additionally raises
           the inexact floating-point exception whenever it raises the
           overflow or underflow floating-point exception is implementation-
           defined.
    


## RETURN VALUE



           If the argument is zero or if all the specified exceptions were
           successfully raised, _feraiseexcept_() shall return zero. Otherwise,
           it shall return a non-zero value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The effect is intended to be similar to that of floating-point
           exceptions raised by arithmetic operations. Hence, enabled traps
           for floating-point exceptions raised by this function are taken.
    


## RATIONALE



           Raising overflow or underflow is allowed to also raise inexact
           because on some architectures the only practical way to raise an
           exception is to execute an instruction that has the exception as a
           side-effect. The function is not restricted to accept only valid
           coincident expressions for atomic operations, so the function can
           be used to raise exceptions accrued over several operations.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pubkey_set_pin_function

## NAME



           gnutls_pubkey_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **void gnutls_pubkey_set_pin_function(gnutls_pubkey_t** _key_**,**
           **gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       A key of type **gnutls_pubkey_t**
    
           gnutls_pin_callback_t fn
                       the callback
    
           void * userdata
                       data associated with the callback
    


## DESCRIPTION



           This function will set a callback function to be used when
           required to access the object. This function overrides any other
           global PIN functions.
    
           Note that this function must be called right after initialization
           to have effect.
    


## SINCE



           3.1.0
    


* * *
# gnutls_psk_set_server_params_function

## NAME



           gnutls_psk_set_server_params_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_server_params_function(gnutls_psk_server_credentials_t**
           _res_**, gnutls_params_function ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t res
                       is a **gnutls_certificate_credentials_t** type
    
           gnutls_params_function * func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback in order for the server to get
           the Diffie-Hellman parameters for PSK authentication.  The
           callback should return **GNUTLS_E_SUCCESS**(0) on success.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# libpfm_intel_ivbep_unc_irp

## NAME



           libpfm_intel_ivbep_unc_irp - support for Intel Ivy Bridge-EP IRP
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_irp**
           **PMU desc: Intel Ivy Bridge-EP IRP uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge uncore PMU.  This PMU
           model only exists on Ivy Bridge model 62.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge IRP
           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 cycles in which the number of
                  occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].
    


* * *
# selinux_policy_root

## NAME



           selinux_policy_root - return the path of the SELinux policy files
           for this machine selinux_set_policy_root - Set an alternate
           SELinux root path for the SELinux policy files for this machine.
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **const char *selinux_policy_root(void);**
    
           **int selinux_set_policy_root(const char *policypath);**
    


## DESCRIPTION



           **selinux_policy_root**() reads the contents of the
           _/etc/selinux/config_ file to determine which policy files should be
           used for this machine.  **selinux_set_policy_root**() sets up all
           policy paths based on the alternate root
    
           _/etc/selinux/config_ file to determine which policy files should be
           used for this machine.
    


## RETURN VALUE



           On success, selinux_policy_root returns a directory path
           containing the SELinux policy files.  On failure,
           selinux_policy_root returns NULL.
    
           On success, selinux_set_policy_root returns 0 on success -1 on
           failure.
    


* * *
# iswpunct

## NAME



           iswpunct - test for punctuation or symbolic wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **iswpunct**() function is the wide-character equivalent of the
           ispunct(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "punct".
    
           The wide-character class "punct" is a subclass of the wide-
           character class "graph", and therefore also a subclass of the
           wide-character class "print".
    
           The wide-character class "punct" is disjoint from the wide-
           character class "alnum" and therefore also disjoint from its
           subclasses "alpha", "upper", "lower", "digit", "xdigit".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "punct" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "punct" is disjoint from the wide-character class
           "space" and its subclass "blank".
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswpunct**() depends on the **LC_CTYPE** category of the
           current locale.
    
           This function's name is a misnomer when dealing with Unicode
           characters, because the wide-character class "punct" contains both
           punctuation characters and symbol (math, currency, etc.)
           characters.
    


* * *
# tanl

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



           tanl — tangent function
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to tan(3p).
    


* * *
# function::indent

## NAME



           function::indent - returns an amount of space to indent
    


## SYNOPSIS



               indent:string(delta:long)
    


## ARGUMENTS



           _delta_
               the amount of space added/removed for each call
    


## DESCRIPTION



           This function returns a string with appropriate indentation. Call
           it with a small positive or matching negative delta. Unlike the
           thread_indent function, the indent does not track individual
           indent values on a per thread basis.
    


* * *
# io_uring_prep_nop

## NAME



           io_uring_prep_nop - prepare a nop request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_nop(struct io_uring_sqe ***_sqe_**);**
    


## DESCRIPTION



           The io_uring_prep_nop(3) function prepares nop (no operation)
           request. The submission queue entry _sqe_ does not require any
           additional setup.
    


## RETURN VALUE



           None
    


## ERRORS



           None
    


* * *
# probe::nfs.aop.set_page_dirty

## NAME



           probe::nfs.aop.set_page_dirty - NFS client marking page as dirty
    


## SYNOPSIS



           nfs.aop.set_page_dirty
    


## VALUES



           ___page_
               the address of page
    
           _page_flag_
               page flags
    


## DESCRIPTION



           This probe attaches to the generic __set_page_dirty_nobuffers
           function. Thus, this probe is going to fire on many other file
           systems in addition to the NFS client.
    


* * *
# strxfrm

## NAME



           strxfrm - string transformation
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **size_t strxfrm(** size_t n;
                          **char** _dest_**[restrict** _n_**], const char** _src_**[restrict** _n_**],**
                          **size_t** _n_**);**
    


## DESCRIPTION



           The **strxfrm**() function transforms the _src_ string into a form such
           that the result of strcmp(3) on two strings that have been
           transformed with **strxfrm**() is the same as the result of strcoll(3)
           on the two strings before their transformation.  The first _n_ bytes
           of the transformed string are placed in _dest_.  The transformation
           is based on the program's current locale for category **LC_COLLATE**.
           (See setlocale(3)).
    


## RETURN VALUE



           The **strxfrm**() function returns the number of bytes required to
           store the transformed string in _dest_ excluding the terminating
           null byte ('\0').  If the value returned is _n_ or more, the
           contents of _dest_ are indeterminate.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_session_key_update

## NAME



           gnutls_session_key_update - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_key_update(gnutls_session_t** _session_**, unsigned**
           _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned flags
                       zero of **GNUTLS_KU_PEER**
    


## DESCRIPTION



           This function will update/refresh the session keys when the TLS
           protocol is 1.3 or better. The peer is notified of the update by
           sending a message, so this function should be treated similarly to
           **gnutls_record_send()** --i.e., it may return **GNUTLS_E_AGAIN** or
           **GNUTLS_E_INTERRUPTED**.
    
           When this flag **GNUTLS_KU_PEER** is specified, this function in
           addition to updating the local keys, will ask the peer to refresh
           its keys too.
    
           If the negotiated version is not TLS 1.3 or better this function
           will return **GNUTLS_E_INVALID_REQUEST**.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# probe::netfilter.bridge.local_out

## NAME



           probe::netfilter.bridge.local_out - Called on a bridging packet
           coming from a local process
    


## SYNOPSIS



           netfilter.bridge.local_out
    


## VALUES



           _br_prid_
               Protocol identifier
    
           _llcpdu_
               Address of LLC Protocol Data Unit
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _llcproto_stp_
               Constant used to signify Bridge Spanning Tree Protocol packet
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _br_cost_
               Total cost from transmitting bridge to root
    
           _br_msg_
               Message age in 1/256 secs
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _pf_
               Protocol family -- always “bridge”
    
           _br_flags_
               BPDU flags
    
           _br_bid_
               Identity of bridge
    
           _br_poid_
               Port identifier
    
           _br_type_
               BPDU type
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _brhdr_
               Address of bridge header
    
           _br_mac_
               Bridge MAC address
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _br_rmac_
               Root bridge MAC address
    
           _br_fd_
               Forward delay in 1/256 secs
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _br_rid_
               Identity of root bridge
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _protocol_
               Packet protocol
    
           _br_max_
               Max age in 1/256 secs
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _br_vid_
               Protocol version identifier
    
           _br_htime_
               Hello time in 1/256 secs
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    


* * *
# function::ansi_reset_color

## NAME



           function::ansi_reset_color - Resets Select Graphic Rendition mode.
    


## SYNOPSIS



               ansi_reset_color()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code to reset foreground, background and color
           attribute to default values.
    


* * *
# sd_bus_message_get_signature

## NAME



           sd_bus_message_get_signature, sd_bus_message_is_empty,
           sd_bus_message_has_signature - Query bus message signature
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **const char* sd_bus_message_get_signature(sd_bus_message ***_message_**,**
                                                    **int** _complete_**);**
    
           **int sd_bus_message_is_empty(sd_bus_message ***_message_**);**
    
           **int sd_bus_message_has_signature(sd_bus_message ***_message_**,**
                                            **const char ***_signature_**);**
    


## DESCRIPTION



           **sd_bus_message_get_signature()** returns the signature of message
           _message_. If _complete_ is true, the signature of the whole message
           is returned, and just the signature of the currently open
           container otherwise.
    
           **sd_bus_message_is_empty()** returns true if the message is empty,
           i.e. when its signature is empty.
    
           **sd_bus_message_has_signature()** returns true if the signature of
           the message _message_ matches given _signature_. Parameter _signature_
           may be **NULL** , this is treated the same as an empty string, which is
           equivalent to calling **sd_bus_message_is_empty()**.
    


## RETURN VALUE



           On success, **sd_bus_message_get_signature()** returns the signature,
           and **NULL** on error.
    
           The other functions return 0 or a positive integer on success. On
           failure, they return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _message_ parameter is **NULL**.
    
           **NULL**
               The _message_ parameter is **NULL**.
    


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


* * *
# umad_init

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


* * *
# tapset::ipmib-filter-default

## NAME



           tapset::ipmib-filter-default - systemtap ipmib-filter-default
           tapset
    


## DESCRIPTION



           **ipmib_filter_key**
                  Default filter function for ipmib.* probes
    
                  See function::ipmib_filter_key(3stap)
                   for details.
    


* * *
# pcap_datalink

## NAME



           pcap_datalink - get the link-layer header type
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_datalink(pcap_t *p);**
    


## DESCRIPTION



           **pcap_datalink**() returns the link-layer header type for the live
           capture or ``savefile'' specified by _p_.
    
           It must not be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).
    
           _https://www.tcpdump.org/linktypes.html _ lists the values
           **pcap_datalink**() can return and describes the packet formats that
           correspond to those values.
    
           Do **NOT** assume that the packets for a given capture or ``savefile``
           will have any given link-layer header type, such as **DLT_EN10MB** for
           Ethernet.  For example, the "any" device on Linux will have a
           link-layer header type of **DLT_LINUX_SLL** or **DLT_LINUX_SLL2** even if
           all devices on the system at the time the "any" device is opened
           have some other data link type, such as **DLT_EN10MB** for Ethernet.
    


## RETURN VALUE



           **pcap_datalink**() returns the link-layer header type on success and
           **PCAP_ERROR_NOT_ACTIVATED** if called on a capture handle that has
           been created but not activated.
    


* * *
# gnutls_perror

## NAME



           gnutls_perror - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_perror(int** _error_**);**
    


## ARGUMENTS



           int error   is a GnuTLS error code, a negative error code
    


## DESCRIPTION



           This function is like **perror()**. The only difference is that it
           accepts an error number returned by a gnutls function.
    


* * *
# iconv_open

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



           iconv_open — codeset conversion allocation function
    


## SYNOPSIS



           #include <iconv.h>
    
           iconv_t iconv_open(const char *_tocode_ , const char *_fromcode_);
    


## DESCRIPTION



           The _iconv_open_() function shall return a conversion descriptor
           that describes a conversion from the codeset specified by the
           string pointed to by the _fromcode_ argument to the codeset
           specified by the string pointed to by the _tocode_ argument. For
           state-dependent encodings, the conversion descriptor shall be in a
           codeset-dependent initial shift state, ready for immediate use
           with _iconv_().
    
           Settings of _fromcode_ and _tocode_ and their permitted combinations
           are implementation-defined.
    
           A conversion descriptor shall remain valid until it is closed by
           _iconv_close_() or an implicit close.
    
           If a file descriptor is used to implement conversion descriptors,
           the FD_CLOEXEC flag shall be set; see _< fcntl.h>_.
    


## RETURN VALUE



           Upon successful completion, _iconv_open_() shall return a conversion
           descriptor for use on subsequent calls to _iconv_().  Otherwise,
           _iconv_open_() shall return (**iconv_t**)-1 and set _errno_ to indicate
           the error.
    


## ERRORS



           The _iconv_open_() function may fail if:
    
           **EMFILE** All file descriptors available to the process are currently
                  open.
    
           **ENFILE** Too many files are currently open in the system.
    
           **ENOMEM** Insufficient storage space is available.
    
           **EINVAL** The conversion specified by _fromcode_ and _tocode_ is not
                  supported by the implementation.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Some implementations of _iconv_open_() use _malloc_() to allocate
           space for internal buffer areas. The _iconv_open_() function may
           fail if there is insufficient storage space to accommodate these
           buffers.
    
           Conforming applications must assume that conversion descriptors
           are not valid after a call to one of the _exec_ functions.
    
           Application developers should consult the system documentation to
           determine the supported codesets and their naming schemes.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::vm.write_shared

## NAME



           probe::vm.write_shared - Attempts at writing to a shared page
    


## SYNOPSIS



           vm.write_shared
    


## VALUES



           _address_
               the address of the shared write
    
           _name_
               name of the probe point
    


## CONTEXT



           The context is the process attempting the write.
    


## DESCRIPTION



           Fires when a process attempts to write to a shared page. If a copy
           is necessary, this will be followed by a vm.write_shared_copy.
    


* * *
# statvfs

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



           statvfs — get file system information
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to fstatvfs(3p).
    


* * *
# gnutls_pkcs12_deinit

## NAME



           gnutls_pkcs12_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **void gnutls_pkcs12_deinit(gnutls_pkcs12_t** _pkcs12_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       The type to be initialized
    


## DESCRIPTION



           This function will deinitialize a PKCS12 type.
    


* * *
# macro::json_output_data_end

## NAME



           macro::json_output_data_end - End the json output.
    


## SYNOPSIS



               @json_output_data_end()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           The json_output_data_end macro is designed to be called from the
           'json_data' probe from the user's script. It marks the end of the
           JSON output.
    


* * *
# gnutls_url_is_supported

## NAME



           gnutls_url_is_supported - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_url_is_supported(const char ***_url_**);**
    


## ARGUMENTS



           const char * url
                       A URI to be tested
    


## DESCRIPTION



           Check whether the provided  _url_ is supported.  Depending on the
           system libraries GnuTLS may support pkcs11, tpmkey or other URLs.
    


## RETURNS



           return non-zero if the given URL is supported, and zero if it is
           not known.
    


## SINCE



           3.1.0
    


* * *
# function::ansi_cursor_save

## NAME



           function::ansi_cursor_save - Saves the cursor position.
    


## SYNOPSIS



               ansi_cursor_save()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code for saving the current cursor position.
    


* * *
# gnutls_pkcs11_obj_get_flags

## NAME



           gnutls_pkcs11_obj_get_flags - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_get_flags(gnutls_pkcs11_obj_t** _obj_**, unsigned**
           **int ***_oflags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       The pkcs11 object
    
           unsigned int * oflags
                       Will hold the output flags
    


## DESCRIPTION



           This function will return the flags of the object.  The  _oflags_
           will be flags from **gnutls_pkcs11_obj_flags**. That is, the
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_** * flags.
    


## RETURNS



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


## SINCE



           3.3.7
    


* * *
# pcre2_match_data_create_from_pattern

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_match_data *pcre2_match_data_create_from_pattern(**
             **const pcre2_code ***_code_**, pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function creates a new match data block for holding the
           result of a match.  The first argument points to a compiled
           pattern. The number of capturing parentheses within the pattern is
           used to compute the number of pairs of offsets that are required
           in the match data block. These form the "output vector" (ovector)
           within the match data block, and are used to identify the matched
           string and any captured substrings when matching with
           **pcre2_match()**. If you are using **pcre2_dfa_match()** , which uses the
           output vector in a different way, you should use
           **pcre2_match_data_create()** instead of this function.
    
           The second argument points to a general context, for custom memory
           management, or is NULL to use the same memory allocator as was
           used for the compiled pattern. The result of the function is NULL
           if the memory for the block could not be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# probe::nfs.fop.llseek

## NAME



           probe::nfs.fop.llseek - NFS client llseek operation
    


## SYNOPSIS



           nfs.fop.llseek
    


## VALUES



           _whence_
               the position to seek from
    
           _offset_
               the offset of the file will be repositioned
    
           _whence_str_
               symbolic string representation of the position to seek from
    
           _ino_
               inode number
    
           _dev_
               device identifier
    


* * *
# wcsnlen

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



           wcsnlen — get length of a fixed-sized wide-character string
    


## SYNOPSIS



           #include <wchar.h>
    
           size_t wcsnlen(const wchar_t *_ws_ , size_t _maxlen_);
    


## DESCRIPTION



           Refer to wcslen(3p).
    


* * *
# jrand48

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



           jrand48 — generate a uniformly distributed pseudo-random long
           signed integer
    


## SYNOPSIS



           #include <stdlib.h>
    
           long jrand48(unsigned short _xsubi_[3]);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# gnutls_pkcs11_set_token_function

## NAME



           gnutls_pkcs11_set_token_function - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void**
           **gnutls_pkcs11_set_token_function(gnutls_pkcs11_token_callback_t**
           _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_pkcs11_token_callback_t fn
                       The token callback
    
           void * userdata
                       data to be supplied to callback
    


## DESCRIPTION



           This function will set a callback function to be used when a token
           needs to be inserted to continue PKCS 11 operations.
    


## SINCE



           2.12.0
    


* * *