tripathysagar/man_text huggingface dataset:
# mmv_set_value

## NAME



           **mmv_set** , **mmv_set_value** , **mmv_set_atomvalue** - set a value in a
           Memory Mapped Value file
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/mmv_stats.h>**
    
           **void mmv_set(void ***_addr_**, pmAtomValue ***_av_**, void ***_val_**);**
           **void mmv_set_value(void ***_addr_**, pmAtomValue ***_av_**, double** _val_**);**
           **void mmv_set_atomvalue(void ***_addr_**, pmAtomValue ***_av_**,**
                                  **pmAtomValue ***_val_**);**
    
           **cc ... -lpcp_mmv -lpcp**
    


## DESCRIPTION



           **mmv_set** ,  **mmv_set_value** and  **mmv_set_atomvalue** provide convenient
           ways of directly setting a value for a metric  _av_  previously  re‐
           turned by the mmv_lookup_value_desc(3) interface.  _addr_ is the ad‐
           dress returned from mmv_stats_init(3).
    
           These  interfaces  are  typically used with instantaneous and dis‐
           crete metrics.  Refer to mmv_inc_value(3) for a  mechanism  suited
           to monotonic increasing counter metrics.
    
           With  **mmv_set** and **mmv_set_atomvalue** the value provided via the _val_
           pointer must match the type of the metric and will be used as  the
           new value of the metric.
    
           In the case of **mmv_set** and **mmv_set_value** , the pointer value _val_ is
           internally  cast  to match the type of the metric and then used as
           the value for the metric.
    


* * *
# sigpause

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



           sigpause — remove a signal from the signal mask and suspend the
           thread
    


## SYNOPSIS



           #include <signal.h>
    
           int sigpause(int _sig_);
    


## DESCRIPTION



           Refer to sighold(3p).
    


* * *
# function::ns_tid

## NAME



           function::ns_tid - Returns the thread ID of a target process as
           seen in a pid namespace
    


## SYNOPSIS



               ns_tid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



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


* * *
# cosh

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



           cosh, coshf, coshl — hyperbolic cosine functions
    


## SYNOPSIS



           #include <math.h>
    
           double cosh(double _x_);
           float coshf(float _x_);
           long double coshl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the hyperbolic cosine of their
           argument _x_.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           hyperbolic cosine of _x_.
    
           If the correct value would cause overflow, a range error shall
           occur and _cosh_(), _coshf_(), and _coshl_() shall return the value of
           the macro HUGE_VAL, HUGE_VALF, and HUGE_VALL, respectively.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, the value 1.0 shall be returned.
    
           If _x_ is ±Inf, +Inf shall be returned.
    


## ERRORS



           These functions shall fail if:
    
           Range Error The result would cause an overflow.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[ERANGE]**.  If the integer expression (_math_errhandling_
                       & MATH_ERREXCEPT) is non-zero, then the overflow
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_trust_list_iter_deinit

## NAME



           gnutls_x509_trust_list_iter_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void**
           **gnutls_x509_trust_list_iter_deinit(gnutls_x509_trust_list_iter_t**
           _iter_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_iter_t iter
                       The iterator structure to be deinitialized
    


## DESCRIPTION



           This function will deinitialize an iterator structure.
    


## SINCE



           3.4.0
    


* * *
# capng_print_caps_numeric

## NAME



           capng_print_caps_numeric - print numeric values for capabilities
           set
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           char *capng_print_caps_numeric(capng_print_t where, capng_select_t
           set);
    


## DESCRIPTION



           capng_print_caps_numeric will create a numeric representation of
           the internal capabilities. The representation can be sent to
           either stdout or a buffer by passing CAPNG_PRINT_STDOUT or
           CAPNG_PRINT_BUFFER respectively for the where parameter. If the
           option was for a buffer, this function will malloc a buffer that
           the caller must free.
    
           The set parameter controls what is included in the representation.
           The legal options are CAPNG_SELECT_CAPS for the traditional
           capabilities, CAPNG_SELECT_BOUNDS for the bounding set,
           CAPNG_SELECT_BOTH if printing both is desired,
           CAPNG_SELECT_AMBIENT if only printing the ambient capabilities, or
           CAPNG_SELECT_ALL if printing all is desired.
    


## RETURN VALUE



           If CAPNG_PRINT_BUFFER was selected for where, this will be the
           text buffer and NULL on failure. If CAPNG_PRINT_STDOUT was
           selected then this value will be NULL no matter what.
    


* * *
# iswctype

## NAME



           iswctype - wide-character classification
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswctype(wint_t** _wc_**, wctype_t** _desc_**);**
    


## DESCRIPTION



           If _wc_ is a wide character having the character property designated
           by _desc_ (or in other words: belongs to the character class
           designated by _desc_), then the **iswctype**() function returns nonzero.
           Otherwise, it returns zero.  If _wc_ is **WEOF** , zero is returned.
    
           _desc_ must be a character property descriptor returned by the
           wctype(3) function.
    


## RETURN VALUE



           The **iswctype**() function returns nonzero if the _wc_ has the
           designated property.  Otherwise, it returns 0.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_sign_is_secure

## NAME



           gnutls_sign_is_secure - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_sign_is_secure(gnutls_sign_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t algorithm
                       is a sign algorithm
    


## RETURNS



           Non-zero if the provided signature algorithm is considered to be
           secure.
    


* * *
# function::user_string_n_warn

## NAME



           function::user_string_n_warn - Retrieves string from user space
    


## SYNOPSIS



           1) user_string_n_warn:string(addr:long,n:long)
    
           2) user_string_n_warn:string(addr:long,n:long,warn_msg:string)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    
           _n_
               the maximum length of the string (if not null terminated)
    
           _warn_msg_
               the warning message to return when data isn't available
    


## DESCRIPTION



           1) Returns up to n characters of a C string from a given user
           space memory address. Reports“<unknown>” on the rare cases when
           userspace data is not accessible and warns (but does not abort)
           about the failure.
    
           2) Returns up to n characters of a C string from a given user
           space memory address. Reports the given warning message on the
           rare cases when userspace data is not accessible and warns (but
           does not abort) about the failure.
    


* * *
# pcap_set_timeout

## NAME



           pcap_set_timeout - set the packet buffer timeout for a not-yet-
           activated capture handle
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_set_timeout(pcap_t *p, int to_ms);**
    


## DESCRIPTION



           **pcap_set_timeout**() sets the packet buffer timeout that will be
           used on a capture handle when the handle is activated to _to_ms_ ,
           which is in units of milliseconds.  (See **pcap**(3PCAP) for an
           explanation of the packet buffer timeout.)
    
           The behavior, if the timeout isn't specified, is undefined, as is
           the behavior if the timeout is set to zero or to a negative value.
           We recommend always setting the timeout to a non-zero value unless
           immediate mode is set, in which case the timeout has no effect.
    


## RETURN VALUE



           **pcap_set_timeout**() returns **0** on success or **PCAP_ERROR_ACTIVATED** if
           called on a capture handle that has been activated.
    


* * *
# ffs

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



           ffs — find first set bit
    


## SYNOPSIS



           #include <strings.h>
    
           int ffs(int _i_);
    


## DESCRIPTION



           The _ffs_() function shall find the first bit set (beginning with
           the least significant bit) in _i_ , and return the index of that bit.
           Bits are numbered starting at one (the least significant bit).
    


## RETURN VALUE



           The _ffs_() function shall return the index of the first bit set. If
           _i_ is 0, then _ffs_() shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_verify_data2

## NAME



           gnutls_x509_crt_verify_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_verify_data2(gnutls_x509_crt_t** _crt_**,**
           **gnutls_sign_algorithm_t** _algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_data_**, const gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate to verify with
    
           gnutls_sign_algorithm_t algo
                       The signature algorithm used
    
           unsigned int flags
                       Zero or an OR list of **gnutls_certificate_verify_flags**
    
           const gnutls_datum_t * data
                       holds the signed data
    
           const gnutls_datum_t * signature
                       contains the signature
    


## DESCRIPTION



           This function will verify the given signed data, using the
           parameters from the certificate.
    


## RETURNS



           In case of a verification failure **GNUTLS_E_PK_SIG_VERIFY_FAILED** is
           returned, **GNUTLS_E_EXPIRED** or **GNUTLS_E_NOT_YET_ACTIVATED** on
           expired or not yet activated certificate and zero or positive code
           on success.
    
           Note that since GnuTLS 3.5.6 this function introduces checks in
           the end certificate ( _crt_ ), including time checks and key usage
           checks.
    


## SINCE



           3.4.0
    


* * *
# pthread_self

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



           pthread_self — get the calling thread ID
    


## SYNOPSIS



           #include <pthread.h>
    
           pthread_t pthread_self(void);
    


## DESCRIPTION



           The _pthread_self_() function shall return the thread ID of the
           calling thread.
    


## RETURN VALUE



           The _pthread_self_() function shall always be successful and no
           return value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The _pthread_self_() function provides a capability similar to the
           _getpid_() function for processes and the rationale is the same: the
           creation call does not provide the thread ID to the created
           thread.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# getaddrinfo

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



           getaddrinfo — get address information
    


## SYNOPSIS



           #include <sys/socket.h>
           #include <netdb.h>
    
           int getaddrinfo(const char *restrict _nodename_ ,
               const char *restrict _servname_ ,
               const struct addrinfo *restrict _hints_ ,
               struct addrinfo **restrict _res_);
    


## DESCRIPTION



           Refer to freeaddrinfo(3p).
    


* * *
# gnutls_cipher_get_iv_size

## NAME



           gnutls_cipher_get_iv_size - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **unsigned gnutls_cipher_get_iv_size(gnutls_cipher_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           This function returns the size of the initialization vector (IV)
           for the provided algorithm. For algorithms with variable size IV
           (e.g., AES-CCM), the returned size will be the one used by TLS.
    


## RETURNS



           block size for encryption algorithm.
    


## SINCE



           3.2.0
    


* * *
# gnutls_hmac_get_key_size

## NAME



           gnutls_hmac_get_key_size - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **unsigned gnutls_hmac_get_key_size(gnutls_mac_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       the mac algorithm to use
    


## DESCRIPTION



           This function will return the size of the key to be used with this
           algorithm. On the algorithms which may accept arbitrary key sizes,
           the returned size is the MAC key size used in the TLS protocol.
    


## RETURNS



           The key size or zero on error.
    


## SINCE



           3.6.12
    


* * *
# pmsearchtextindom

## NAME



           **pmSearchTextInDom** - search for all entities related to given
           instance domain
    


## C SYNOPSIS



           **#include <pcp/pmwebapi.h>**
    
           **int pmSearchTextInDom(pmSearchSettings ***_settings_**,**
                                 **pmSearchTextRequest ***_request_**, void ***_arg_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           Executes  search  for all metrics, instances and instance domains,
           that are related to given instance domain as specified by _request_ :
    
           _query_
                Target instance domain.
    
           _count_
                Limits number of results. Defaults to 10.
    
           _offset_
                Search offset. Defaults to 0.
    
           Results are ordered by type in an ascending order.
    
           Each entity matched by the **request** above will be passed to
           **on_text_result** callback provided by **settings.**
    


## DIAGNOSTICS



           This function always returns zero on success.  On failure a nega‐
           tive PMAPI error code is returned.
    


* * *
# gnutls_priority_ecc_curve_list

## NAME



           gnutls_priority_ecc_curve_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_ecc_curve_list(gnutls_priority_t** _pcache_**, const**
           **unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available elliptic curves in the priority structure.
    


## DEPRECATED



           This function has been replaced by **gnutls_priority_group_list()**
           since 3.6.0.
    


## RETURNS



           the number of items, or an error code.
    


## SINCE



           3.0
    


* * *
# getservbyname

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



           getservbyname, getservbyport, getservent — network services
           database functions
    


## SYNOPSIS



           #include <netdb.h>
    
           struct servent *getservbyname(const char *_name_ , const char *_proto_);
           struct servent *getservbyport(int _port_ , const char *_proto_);
           struct servent *getservent(void);
    


## DESCRIPTION



           Refer to endservent(3p).
    


* * *
# auparse_get_time

## NAME



           auparse_get_time - get event's time
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **time_t auparse_get_time(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_get_time will access just the time portion of the
           timestamp data structure for the current event.
    


## RETURN VALUE



           Returns 0 if an error occurs; otherwise, the valid time value in
           time_t format.
    


* * *
# function::ntohll

## NAME



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


## SYNOPSIS



               ntohll:long(x:long)
    


## ARGUMENTS



           _x_
               Value to convert
    


* * *
# wcslen

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



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


## SYNOPSIS



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


## DESCRIPTION



           For _wcslen_(): 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 _wcslen_() function shall compute the number of wide-character
           codes in the wide-character string to which _ws_ points, not
           including the terminating null wide-character code.
    
           The _wcsnlen_() function shall compute the smaller of the number of
           wide characters in the array to which _ws_ points, not including any
           terminating null wide-character code, and the value of _maxlen_.
           The _wcsnlen_() function shall never examine more than the first
           _maxlen_ characters of the wide-character array pointed to by _ws_.
    


## RETURN VALUE



           The _wcslen_() function shall return the length of _ws_.
    
           The _wcsnlen_() function shall return the number of wide characters
           preceding the first null wide-character code in the array to which
           _ws_ points, if _ws_ contains a null wide-character code within the
           first _maxlen_ wide characters; otherwise, it shall return _maxlen_.
    
           No return values are reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pam_putenv

## NAME



           pam_putenv - set or change PAM environment variable
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **int pam_putenv(pam_handle_t ***_pamh_**, const char ***_name_value_**);**
    


## DESCRIPTION



           The **pam_putenv** function is used to add or change the value of PAM
           environment variables as associated with the _pamh_ handle.
    
           The _pamh_ argument is an authentication handle obtained by a prior
           call to pam_start(). The _name_value_ argument is a single NUL
           terminated string of one of the following forms:
    
           NAME=value of variable
               In this case the environment variable of the given NAME is set
               to the indicated value: _value of variable_. If this variable is
               already known, it is overwritten. Otherwise it is added to the
               PAM environment.
    
           NAME=
               This function sets the variable to an empty value. It is
               listed separately to indicate that this is the correct way to
               achieve such a setting.
    
           NAME
               Without an '=' the **pam_putenv**() function will delete the
               corresponding variable from the PAM environment.
    
           **pam_putenv**() operates on a copy of _name_value_ , which means in
           contrast to putenv(3), the application is responsible for freeing
           the data.
    


## RETURN VALUES



           PAM_PERM_DENIED
               Argument _name_value_ given is a NULL pointer.
    
           PAM_BAD_ITEM
               Variable requested (for deletion) is not currently set.
    
           PAM_ABORT
               The _pamh_ handle is corrupt.
    
           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_SUCCESS
               The environment variable was successfully updated.
    


* * *
# fgetwc

## NAME



           fgetwc, getwc - read a wide character from a FILE stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
           **#include <wchar.h>**
    
           **wint_t fgetwc(FILE ***_stream_**);**
           **wint_t getwc(FILE ***_stream_**);**
    


## DESCRIPTION



           The **fgetwc**() function is the wide-character equivalent of the
           fgetc(3) function.  It reads a wide character from _stream_ and
           returns it.  If the end of stream is reached, or if _ferror(stream)_
           becomes true, it returns **WEOF**.  If a wide-character conversion
           error occurs, it sets _errno_ to **EILSEQ** and returns **WEOF**.
    
           The **getwc**() function or macro functions identically to **fgetwc**().
           It may be implemented as a macro, and may evaluate its argument
           more than once.  There is no reason ever to use it.
    
           For nonlocking counterparts, see unlocked_stdio(3).
    


## RETURN VALUE



           On success, **fgetwc**() returns the next wide-character from the
           stream.  Otherwise, **WEOF** is returned, and _errno_ is set to indicate
           the error.
    


## ERRORS



           Apart from the usual ones, there is
    
           **EILSEQ** The data obtained from the input stream does not form a
                  valid character.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **fgetwc**() depends on the **LC_CTYPE** category of the
           current locale.
    
           In the absence of additional information passed to the fopen(3)
           call, it is reasonable to expect that **fgetwc**() will actually read
           a multibyte sequence from the stream and then convert it to a wide
           character.
    


* * *
# mlx5dv_modify_qp_lag_port

## NAME



           mlx5dv_modify_qp_lag_port - Modify the lag port information of a
           given QP
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_modify_qp_lag_port(struct ibv_qp *qp, uint8_t port_num);
    


## DESCRIPTION



           This API enables modifying the configured port num of a given QP.
    
           If the QP state is modified later, the port num may be implicitly
           re-configured.
    
           Use query mlx5dv_query_qp_lag_port to check the configured and
           active port num values.
    


## ARGUMENTS



           _qp_     The ibv_qp object to issue the action on.
    
           _port_num_
                  The port_num to set for the QP.
    


## RETURN VALUE



           0 on success; EOPNOTSUPP if not in LAG mode, or other errno value
           on other failures.
    


* * *
# function::thread_indent

## NAME



           function::thread_indent - returns an amount of space with the
           current task information
    


## SYNOPSIS



               thread_indent:string(delta:long)
    


## ARGUMENTS



           _delta_
               the amount of space added/removed for each call
    


## DESCRIPTION



           This function returns a string with appropriate indentation for a
           thread. Call it with a small positive or matching negative delta.
           If this is the real outermost, initial level of indentation, then
           the function resets the relative timestamp base to zero. The
           timestamp is as per provided by the __indent_timestamp function,
           which by default measures microseconds.
    


* * *
# gnutls_anon_free_server_credentials

## NAME



           gnutls_anon_free_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_anon_free_server_credentials(gnutls_anon_server_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_anon_server_credentials_t sc
                       is a **gnutls_anon_server_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_anon_server_credentials_t structure.
    


* * *
# gnutls_pkcs11_delete_url

## NAME



           gnutls_pkcs11_delete_url - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_delete_url(const char ***_object_url_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           const char * object_url
                       The URL of the object to delete.
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will delete objects matching the given URL.  Note
           that not all tokens support the delete operation.
    


## RETURNS



           On success, the number of objects deleted is returned, otherwise a
           negative error value.
    


## SINCE



           2.12.0
    


* * *
# probe::softirq.exit

## NAME



           probe::softirq.exit - Execution of handler for a pending softirq
           completed
    


## SYNOPSIS



           softirq.exit
    


## VALUES



           _vec_
               softirq_action vector
    
           _action_
               pointer to softirq handler that just finished execution
    
           _vec_nr_
               softirq vector number
    
           _h_
               struct softirq_action* for just executed softirq
    


* * *
# function::mem_page_size

## NAME



           function::mem_page_size - Number of bytes in a page for this
           architecture
    


## SYNOPSIS



               mem_page_size:long()
    


## ARGUMENTS



           None
    


* * *
# pcre2_set_glob_separator

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_glob_separator(pcre2_convert_context ***_cvcontext_**,**
             **uint32_t** _separator_char_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It sets the component separator character that is used
           when converting globs.  The second argument must be one of the
           characters forward slash, backslash, or dot. The default is
           backslash when running under Windows, otherwise forward slash. The
           result of the function is zero for success or PCRE2_ERROR_BADDATA
           if the second argument is invalid.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# pmfstring

## NAME



           **pmfstring** - safe string scanning
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **ssize_t pmfstring(FILE ***_f_**, char ****_str_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmfstring** is a safe string scanning routine with semantics similar
           to  fscanf(3)  with  the  **%s** format specifier.  It scans the input
           stream from _f_ skipping initial whitespace characters, then accumu‐
           lating all the subsequent non-whitespace characters.
    
           The main difference is that **pmfstring** allocates the result  buffer
           _str_  using  the malloc(3) family and ensures that _str_ is (a) large
           enough and (b) null-byte terminated.
    
           Additionally **pmfstring** does not consider \n  to  be  a  whitespace
           character in the initial scan (before filling _str_) and so will not
           scan  past  the  end  of  the  current line, which is different to
           fscanf(3) and better aligned with the PCP use cases.
    
           The caller is responsible for maintaining a reference  to  _str_  or
           calling free(3) to release the associated storage.
    
           On  success,  **pmfstring** returns the length of _str_ (the same length
           as strlen(3) would return) that is guaranteed to be not less  than
           1.
    
           Failure  is  indicated by one of the following, and _str_ is not as‐
           signed a value:
            • 0 to indicate no non-whitespace characters were found before
              the end of the current line from the stream _f_
            • -1 ( aka **EOF**) to indicate end of file on the stream _f_
            • -2 to indicate some more serious failure, probably in the
              malloc(3) routines; refer to _errno_ for more information
    


## COMPATIBILITY



           **pmfstring** has similar semantics to the **%ms** format specifier in
           some versions of fscanf(3) and the C99 **fscanf_s**(3) routine - un‐
           fortunately neither of these is portable.
    


* * *
# pcre2_set_depth_limit

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



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


## DESCRIPTION



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


* * *
# function::warn

## NAME



           function::warn - Send a line to the warning stream
    


## SYNOPSIS



               warn(msg:string)
    


## ARGUMENTS



           _msg_
               The formatted message string
    


## DESCRIPTION



           This function sends a warning message immediately to staprun. It
           is also sent over the bulk transport (relayfs) if it is being
           used. If the last characater is not a newline, the one is added.
    


* * *
# probe::netfilter.arp.forward

## NAME



           probe::netfilter.arp.forward - - Called for each ARP packet to be
           forwarded
    


## SYNOPSIS



           netfilter.arp.forward
    


## VALUES



           _ar_tha_
               Ethernet+IP only (ar_pro==0x800): target hardware (MAC)
               address
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _data_str_
               A string representing the packet buffer contents
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _ar_hrd_
               Format of hardware address
    
           _arphdr_
               Address of ARP header
    
           _ar_pro_
               Format of protocol address
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _ar_hln_
               Length of hardware address
    
           _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
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _ar_pln_
               Length of protocol address
    
           _ar_tip_
               Ethernet+IP only (ar_pro==0x800): target IP address
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _ar_sha_
               Ethernet+IP only (ar_pro==0x800): source hardware (MAC)
               address
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _ar_op_
               ARP opcode (command)
    
           _pf_
               Protocol family -- always “arp”
    
           _ar_data_
               Address of ARP packet data region (after the header)
    
           _ar_sip_
               Ethernet+IP only (ar_pro==0x800): source IP address
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    


* * *
# libpfm_intel_ivbep_unc_imc

## NAME



           libpfm_intel_ivbep_unc_imc - support for Intel Ivy Bridge-EP
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_imc[0-7]**
           **PMU desc: Intel Ivy Bridge-EP IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge Integrated Memory
           Controller (IMC) uncore PMU.  This PMU model only exists on Ivy
           Bridge model 62.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge C-Box
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IMC cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].
    


* * *
# gnutls_psk_set_client_credentials_function2

## NAME



           gnutls_psk_set_client_credentials_function2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_client_credentials_function2(gnutls_psk_client_credentials_t**
           _cred_**, gnutls_psk_client_credentials_function2 ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_client_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_client_credentials_function2 * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the
           username and password for client PSK authentication.  The
           callback's function form is: int (*callback)(gnutls_session_t,
           gnutls_datum_t* username, gnutls_datum_t* key);
    
           This callback function has the same semantics as that of
           **gnutls_psk_set_client_credentials_function()** , but it allows
           non-string usernames to be used.
    
           The  _username_ and  _key_ ->data must be allocated using
           **gnutls_malloc()**.  The  _username_ should be an ASCII string or UTF-8
           string. In case of a UTF-8 string it is recommended to be
           following the PRECIS framework for usernames (rfc8265).
    
           The callback function will be called once per handshake.
    
           The callback function should return 0 on success.  -1 indicates an
           error.
    


* * *
# function::ustack

## NAME



           function::ustack - Return address at given depth of user stack
           backtrace
    


## SYNOPSIS



               ustack:long(n:long)
    


## ARGUMENTS



           _n_
               number of levels to descend in the stack.
    


## DESCRIPTION



           Performs a simple (user space) backtrace, and returns the element
           at the specified position. The results of the backtrace itself are
           cached, so that the backtrace computation is performed at most
           once no matter how many times **ustack** is called, or in what order.
    


* * *
# gnutls_psk_format_imported_identity

## NAME



           gnutls_psk_format_imported_identity - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_psk_format_imported_identity(const gnutls_datum_t ***
           _identity_**, const gnutls_datum_t ***_context_**, gnutls_protocol_t**
           _version_**, gnutls_digest_algorithm_t** _hash_**, gnutls_datum_t ***
           _imported_identity_**);**
    


## ARGUMENTS



           const gnutls_datum_t * identity
                       external identity
    
           const gnutls_datum_t * context
                       optional contextual information
    
           gnutls_protocol_t version
                       protocol version to which the PSK is imported
    
           gnutls_digest_algorithm_t hash
                       hash algorithm used for KDF
    
           gnutls_datum_t * imported_identity
                       where the imported identity is stored
    


## DESCRIPTION



           This formats an external PSK identity  _identity_ into an imported
           form, described in RFC 9258 as ImportedIdentity.
    
           Upon success, the data field of  _imported_identity_ is allocated
           using **gnutls_malloc()** and the caller must free the memory after
           use.
    


## RETURNS



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


## SINCE



           3.8.1
    


* * *
# gnutls_x509_crt_get_subject_alt_name2

## NAME



           gnutls_x509_crt_get_subject_alt_name2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_subject_alt_name2(gnutls_x509_crt_t** _cert_**,**
           **unsigned int** _seq_**, void ***_san_**, size_t ***_san_size_**, unsigned int ***
           _san_type_**, 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 ret.
    
           unsigned int * san_type
                       holds the type of the alternative name (one of
                       gnutls_x509_subject_alt_name_t).
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the alternative names, contained in the
           given certificate. It is the same as
           **gnutls_x509_crt_get_subject_alt_name()** except for the fact that it
           will return the type of the alternative name in  _san_type_ even if
           the function fails for some reason (i.e.  the buffer provided is
           not enough).
    


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


* * *
# gnutls_pkcs7_get_attr

## NAME



           gnutls_pkcs7_get_attr - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_attr(gnutls_pkcs7_attrs_t** _list_**, unsigned** _idx_**,**
           **char ****_oid_**, gnutls_datum_t ***_data_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs7_attrs_t list
                       A list of existing attributes or **NULL** for the first
                       one
    
           unsigned idx
                       the index of the attribute to get
    
           char ** oid the OID of the attribute (read-only)
    
           gnutls_datum_t * data
                       the raw data of the attribute
    
           unsigned flags
                       zero or **GNUTLS_PKCS7_ATTR_ENCODE_OCTET_STRING**
    


## DESCRIPTION



           This function will get a PKCS **7** attribute from the provided list.
           The OID is a constant string, but data will be allocated and must
           be deinitialized by the caller.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned if
           there are no data in the current index.
    


## SINCE



           3.4.2
    


* * *
# probe::netdev.rx

## NAME



           probe::netdev.rx - Called when the device is going to receive a
           packet
    


## SYNOPSIS



           netdev.rx
    


## VALUES



           _protocol_
               The packet protocol
    
           _dev_name_
               The device received the packet
    


* * *