tripathysagar/man_text huggingface dataset:
# probe::netdev.transmit

## NAME



           probe::netdev.transmit - Network device transmitting buffer
    


## SYNOPSIS



           netdev.transmit
    


## VALUES



           _dev_name_
               The name of the device. e.g: eth0, ath1.
    
           _length_
               The length of the transmit buffer.
    
           _protocol_
               The protocol of this packet(defined in
               include/linux/if_ether.h).
    
           _truesize_
               The size of the data to be transmitted.
    


* * *
# umad_addr_dump

## NAME



           umad_addr_dump - dump addr structure to stderr
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **void umad_addr_dump(ib_mad_addr_t** _*addr_**);**
    


## DESCRIPTION



           **umad_addr_dump()** dumps the given _addr_ to stderr.  The argument
           _addr_ is an _ib_mad_addr_t_ struct, as specified in
           <infiniband/umad.h>.
    
           typedef struct ib_mad_addr {
                   uint32_t qpn;
                   uint32_t qkey;
                   uint16_t lid;
                   uint8_t  sl;
                   uint8_t  path_bits;
                   uint8_t  grh_present;
                   uint8_t  gid_index;
                   uint8_t  hop_limit;
                   uint8_t  traffic_class;
                   uint8_t  gid[16];
                   uint32_t flow_label;
           } ib_mad_addr_t;
    


## RETURN VALUE



           **umad_addr_dump()** returns no value.
    


* * *
# gnutls_certificate_set_verify_limits

## NAME



           gnutls_certificate_set_verify_limits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_verify_limits(gnutls_certificate_credentials_t**
           _res_**, unsigned int** _max_bits_**, unsigned int** _max_depth_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials type
    
           unsigned int max_bits
                       is the number of bits of an acceptable certificate
                       (default 8200)
    
           unsigned int max_depth
                       is maximum depth of the verification of a certificate
                       chain (default 5)
    


## DESCRIPTION



           This function will set some upper limits for the default
           verification function, **gnutls_certificate_verify_peers2()** , to
           avoid denial of service attacks.  You can set them to zero to
           disable limits.
    


* * *
# gnutls_ocsp_req_deinit

## NAME



           gnutls_ocsp_req_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **void gnutls_ocsp_req_deinit(gnutls_ocsp_req_t** _req_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       The data to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a OCSP request structure.
    


* * *
# gnutls_tdb_set_verify_func

## NAME



           gnutls_tdb_set_verify_func - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_tdb_set_verify_func(gnutls_tdb_t** _tdb_**,**
           **gnutls_tdb_verify_func** _verify_**);**
    


## ARGUMENTS



           gnutls_tdb_t tdb
                       The trust storage
    
           gnutls_tdb_verify_func verify
                       The verification function
    


## DESCRIPTION



           This function will associate a retrieval function with the trust
           storage structure. The function is of the following form.
    
           int gnutls_tdb_verify_func(const char* db_name, const char* host,
           const char* service, const gnutls_datum_t* pubkey);
    
           The verify function should return zero on a match,
           **GNUTLS_E_CERTIFICATE_KEY_MISMATCH** if there is a mismatch and any
           other negative error code otherwise.
    
           The  _db_name_ should be used to pass any private data to this
           function.
    


* * *
# ibv_get_device_guid

## NAME



           ibv_get_device_guid - get an RDMA device’s GUID
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  uint64_t ibv_get_device_guid(struct ibv_device *device);
    


## DESCRIPTION



           **ibv_get_device_guid()** returns the Global Unique IDentifier (GUID)
           of the RDMA device _device_.
    


## RETURN VALUE



           **ibv_get_device_guid()** returns the GUID of the device in network
           byte order.
    


* * *
# gnutls_psk_client_get_hint

## NAME



           gnutls_psk_client_get_hint - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_psk_client_get_hint(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           The PSK identity hint may give the client help in deciding which
           username to use.  This should only be called in case of PSK
           authentication and in case of a client.
    


## NOTE



           there is no hint in TLS 1.3, so this function will return **NULL** if
           TLS 1.3 has been negotiated.
    


## RETURNS



           the identity hint of the peer, or **NULL** in case of an error or if
           TLS 1.3 is being used.
    


## SINCE



           2.4.0
    


* * *
# iswlower

## NAME



           iswlower - test for lowercase wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **iswlower**() function is the wide-character equivalent of the
           islower(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "lower".
    
           The wide-character class "lower" is a subclass of the wide-
           character class "alpha", and therefore also a subclass of the
           wide-character class "alnum", of the wide-character class "graph"
           and of the wide-character class "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "lower" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "lower" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           Being a subclass of the wide-character class "alnum", the wide-
           character class "lower" is disjoint from the wide-character class
           "punct".
    
           Being a subclass of the wide-character class "alpha", the wide-
           character class "lower" is disjoint from the wide-character class
           "digit".
    
           The wide-character class "lower" contains at least those
           characters _wc_ which are equal to _towlower(wc)_ and different from
           _towupper(wc)_.
    
           The wide-character class "lower" always contains at least the
           letters 'a' to 'z'.
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswlower**() depends on the **LC_CTYPE** category of the
           current locale.
    
           This function is not very appropriate for dealing with Unicode
           characters, because Unicode knows about three cases: upper, lower,
           and title case.
    


* * *
# wcsnlen

## NAME



           wcsnlen - determine the length of a fixed-size wide-character
           string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **size_t wcsnlen(** size_t maxlen;
                          **const wchar_t** _s_**[**_maxlen_**], size_t** _maxlen_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **wcsnlen**():
               Since glibc 2.10:
                   _POSIX_C_SOURCE >= 200809L
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **wcsnlen**() function is the wide-character equivalent of the
           strnlen(3) function.  It returns the number of wide-characters in
           the string pointed to by _s_ , not including the terminating null
           wide character (L'\0'), but at most _maxlen_ wide characters (note:
           this parameter is not a byte count).  In doing this, **wcsnlen**()
           looks at only the first _maxlen_ wide characters at _s_ and never
           beyond _s[maxlen-1]_.
    


## RETURN VALUE



           The **wcsnlen**() function returns _wcslen(s)_ , if that is less than
           _maxlen_ , or _maxlen_ if there is no null wide character among the
           first _maxlen_ wide characters pointed to by _s_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# pwrite

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



           pwrite — write on a file
    


## SYNOPSIS



           #include <unistd.h>
    
           ssize_t pwrite(int _fildes_ , const void *_buf_ , size_t _nbyte_ ,
               off_t _offset_);
    


## DESCRIPTION



           Refer to write(3p).
    


* * *
# probe::nfs.fop.open

## NAME



           probe::nfs.fop.open - NFS client file open operation
    


## SYNOPSIS



           nfs.fop.open
    


## VALUES



           _dev_
               device identifier
    
           _ino_
               inode number
    
           _file_name_
               file name
    
           _flag_
               file flag
    
           _i_size_
               file length in bytes
    


* * *
# gnutls_random_art

## NAME



           gnutls_random_art - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_random_art(gnutls_random_art_t** _type_**, const char ***
           _key_type_**, unsigned int** _key_size_**, void ***_fpr_**, size_t** _fpr_size_**,**
           **gnutls_datum_t ***_art_**);**
    


## ARGUMENTS



           gnutls_random_art_t type
                       The type of the random art (for now only
                       **GNUTLS_RANDOM_ART_OPENSSH** is supported)
    
           const char * key_type
                       The type of the key (RSA, DSA etc.)
    
           unsigned int key_size
                       The size of the key in bits
    
           void * fpr  The fingerprint of the key
    
           size_t fpr_size
                       The size of the fingerprint
    
           gnutls_datum_t * art
                       The returned random art
    


## DESCRIPTION



           This function will convert a given fingerprint to an "artistic"
           image. The returned image is allocated using **gnutls_malloc()** , is
           null-terminated but art->size will not account the terminating
           null.
    


## RETURNS



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


* * *
# function::task_exe_file

## NAME



           function::task_exe_file - get the file struct pointer for a task's
           executable file
    


## SYNOPSIS



               task_exe_file:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer.
    


* * *
# setstate

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



           setstate — switch pseudo-random number generator state arrays
    


## SYNOPSIS



           #include <stdlib.h>
    
           char *setstate(char *_state_);
    


## DESCRIPTION



           Refer to initstate(3p).
    


* * *
# iswupper

## NAME



           iswupper - test for uppercase wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **iswupper**() function is the wide-character equivalent of the
           isupper(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "upper".
    
           The wide-character class "upper" is a subclass of the wide-
           character class "alpha", and therefore also a subclass of the
           wide-character class "alnum", of the wide-character class "graph"
           and of the wide-character class "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "upper" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "upper" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           Being a subclass of the wide-character class "alnum", the wide-
           character class "upper" is disjoint from the wide-character class
           "punct".
    
           Being a subclass of the wide-character class "alpha", the wide-
           character class "upper" is disjoint from the wide-character class
           "digit".
    
           The wide-character class "upper" contains at least those
           characters _wc_ which are equal to _towupper(wc)_ and different from
           _towlower(wc)_.
    
           The wide-character class "upper" always contains at least the
           letters 'A' to 'Z'.
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswupper**() depends on the **LC_CTYPE** category of the
           current locale.
    
           This function is not very appropriate for dealing with Unicode
           characters, because Unicode knows about three cases: upper, lower,
           and title case.
    


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



           posix_trace_trid_eventid_open — open a trace event type identifier
           (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_trid_eventid_open(trace_id_t _trid_ ,
               const char *restrict _event_name_ ,
               trace_event_id_t *restrict _event_);
    


## DESCRIPTION



           Refer to posix_trace_eventid_equal(3p).
    


* * *
# umad_get_ca_portguids

## NAME



           umad_get_ca_portguids - get the InfiniBand device ports GUIDs
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_get_ca_portguids(char** _*ca_name_**, __be64** _*portguids_**, int** _max_**);**
    


## DESCRIPTION



           **umad_get_ca_portguids()** fills the _portguids_ array with up to _max_
           port GUIDs belonging the specified IB device _ca_name_ , or to the
           default IB device if _ca_name_ is NULL.  The argument _portguids_ is
           an array of _max_ uint64_t entries.
    


## RETURN VALUE



           On success, **umad_get_ca_portguids()** returns a non-negative value
           equal to the number of port GUIDs actually filled.  Not all filled
           entries may be valid. Invalid entries will be 0.  For example, on
           a CA node with only one port, this function returns a value of 2.
           In this case, the value at index 0 will be invalid as it is
           reserved for switches.  On failure, a negative value is returned.
    


* * *
# function::fp_rem

## NAME



           function::fp_rem - Floating point division
    


## SYNOPSIS



               fp_rem:long(div1:long,div2:long)
    


## ARGUMENTS



           _div1_
               the 64 bit floating point dividend
    
           _div2_
               64 bit floating point divisor
    


## DESCRIPTION



           result would be the remainder after divisor divides dividend
    


* * *
# gnutls_session_set_verify_function

## NAME



           gnutls_session_set_verify_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_set_verify_function(gnutls_session_t** _session_**,**
           **gnutls_certificate_verify_function ***_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_certificate_verify_function * func
                       is the callback function
    


## DESCRIPTION



           This function sets a callback to be called when peer's certificate
           has been received in order to verify it on receipt rather than
           doing after the handshake is completed. This overrides any
           callback set using **gnutls_certificate_set_verify_function()**.
    
           The callback's function prototype is: int
           (*callback)(gnutls_session_t);
    
           If the callback function is provided then gnutls will call it, in
           the handshake, just after the certificate message has been
           received.  To verify or obtain the certificate the
           **gnutls_certificate_verify_peers2()** , **gnutls_certificate_type_get()** ,
           **gnutls_certificate_get_peers()** functions can be used.
    
           The callback function should return 0 for the handshake to
           continue or non-zero to terminate.
    


## SINCE



           3.4.6
    


* * *
# function::task_backtrace

## NAME



           function::task_backtrace - Hex backtrace of an arbitrary task
    


## SYNOPSIS



               task_backtrace:string(task:long)
    


## ARGUMENTS



           _task_
               pointer to task_struct
    


## DESCRIPTION



           This function returns a string of hex addresses that are a
           backtrace of the stack of a particular task Output may be
           truncated as per maximum string length. Deprecated in SystemTap
           1.6.
    


* * *
# libpfm_intel_bdx_unc_pcu

## NAME



           libpfm_intel_bdx_unc_pcu - support for Intel Broadwell Server
           Power Controller Unit (PCU) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_pcu**
           **PMU desc: Intel Broadwell Server PCU uncore PMU**
    


## DESCRIPTION



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


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server
           PCU 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 HA 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:15].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    
           **ff** Enable frequency band filtering. This modifier applies only
                  to the UNC_P_FREQ_BANDx_CYCLES events, where x is [0-3].
                  The modifiers expects an integer in the range [0-255]. The
                  value is interpreted as a frequency value to be multiplied
                  by 100Mhz. Thus if the value is 32, then all cycles where
                  the processor is running at 3.2GHz and more are counted.
    


## Frequency band filtering



           There are 3 events which support frequency band filtering, namely,
           UNC_P_FREQ_BAND0_CYCLES, UNC_P_FREQ_BAND1_CYCLES,
           UNC_P_FREQ_BAND2_CYCLES, UNC_P_FREQ_BAND3_CYCLES. The frequency
           filter (available via the ff modifier) is stored into a PMU shared
           register which hold all 4 possible frequency bands, one per event.
           However, the library generate the encoding for each event
           individually because it processes events one at a time. The caller
           or the underlying kernel interface may have to merge the band
           filter settings to program the filter register properly.
    


* * *
# function::task_parent

## NAME



           function::task_parent - The task_struct of the parent task
    


## SYNOPSIS



               task_parent:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the parent task_struct of the given task.
           This address can be passed to the various task_*() functions to
           extract more task-specific data.
    


* * *
# gnutls_pkcs7_verify

## NAME



           gnutls_pkcs7_verify - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_verify(gnutls_pkcs7_t** _pkcs7_**,**
           **gnutls_x509_trust_list_t** _tl_**, gnutls_typed_vdata_st ***_vdata_**,**
           **unsigned int** _vdata_size_**, unsigned** _idx_**, const gnutls_datum_t ***
           _data_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a **gnutls_pkcs7_t** type
    
           gnutls_x509_trust_list_t tl
                       A list of trusted certificates
    
           gnutls_typed_vdata_st * vdata
                       an array of typed data
    
           unsigned int vdata_size
                       the number of data elements
    
           unsigned idx
                       the index of the signature info to check
    
           const gnutls_datum_t * data
                       The data to be verified or **NULL**
    
           unsigned flags
                       Zero or an OR list of **gnutls_certificate_verify_flags**
    


## DESCRIPTION



           This function will verify the provided data against the signature
           present in the SignedData of the PKCS **7** structure. If the data
           provided are NULL then the data in the encapsulatedContent field
           will be used instead.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value. A verification error results to a
           **GNUTLS_E_PK_SIG_VERIFY_FAILED** and the lack of encapsulated data to
           verify to a **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.
    


## SINCE



           3.4.2
    


* * *
# gnutls_set_default_priority_append

## NAME



           gnutls_set_default_priority_append - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_set_default_priority_append(gnutls_session_t** _session_**,**
           **const char ***_add_prio_**, const char ****_err_pos_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const char * add_prio
                       is a string describing priorities to be appended to
                       default
    
           const char ** err_pos
                       In case of an error this will have the position in the
                       string the error occurred
    
           unsigned flags
                       must be zero
    


## DESCRIPTION



           Sets the default priority on the ciphers, key exchange methods,
           and macs with the additional options in  _add_prio_ . This is the
           recommended method of setting the defaults when only few
           additional options are to be added. This promotes consistency
           between applications using GnuTLS, and allows GnuTLS using
           applications to update settings in par with the library.
    
           The  _add_prio_ string should start as a normal priority string,
           e.g., with ':'.
    
           To allow a user to override the defaults (e.g., when a user
           interface or configuration file is available), the functions
           **gnutls_priority_set_direct()** or **gnutls_priority_set()** can be used.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# function::user_ulong

## NAME



           function::user_ulong - Retrieves an unsigned long value stored in
           user space
    


## SYNOPSIS



               user_ulong:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned long from
    


## DESCRIPTION



           Returns the unsigned long value from a given user space address.
           Returns zero when user space data is not accessible. Note that the
           size of the unsigned long depends on the architecture of the
           current user space task (for those architectures that support both
           64/32 bit compat tasks).
    


* * *
# gnutls_certificate_set_pin_function

## NAME



           gnutls_certificate_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_pin_function(gnutls_certificate_credentials_t**
           _cred_**, gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t cred
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_pin_callback_t fn
                       A PIN callback
    
           void * userdata
                       Data to be passed in the callback
    


## DESCRIPTION



           This function will set a callback function to be used when
           required to access a protected 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
    


* * *
# probe::softirq.entry

## NAME



           probe::softirq.entry - Execution of handler for a pending softirq
           starting
    


## SYNOPSIS



           softirq.entry
    


## VALUES



           _action_
               pointer to softirq handler just about to execute
    
           _vec_
               softirq_action vector
    
           _h_
               struct softirq_action* for current pending softirq
    
           _vec_nr_
               softirq vector number
    


* * *
# function::task_time_string

## NAME



           function::task_time_string - Human readable string of task time
           usage
    


## SYNOPSIS



               task_time_string:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns a human readable string showing the user and system time
           the current task has used up to now. For example “usr: 0m12.908s,
           sys: 1m6.851s”.
    


* * *
# log10

## NAME



           log10, log10f, log10l -  base-10 logarithmic function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the base-10 logarithm of _x_.
    


## RETURN VALUE



           On success, these functions return the base-10 logarithm of _x_.
    
           For special cases, including where _x_ is 0, 1, negative, infinity,
           or NaN, see log(3).
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           For a discussion of the errors that can occur for these functions,
           see log(3).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pthread_mutexattr_setrobust

## 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_mutexattr_setrobust — get and set the mutex robust
           attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutexattr_setrobust(pthread_mutexattr_t *_attr_ ,
               int _robust_);
    


## DESCRIPTION



           Refer to pthread_mutexattr_getrobust(3p).
    


* * *
# function::user_uint32

## NAME



           function::user_uint32 - Retrieves an unsigned 32-bit integer value
           stored in user space
    


## SYNOPSIS



               user_uint32:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned 32-bit integer
               from
    


## DESCRIPTION



           Returns the unsigned 32-bit integer value from a given user space
           address. Returns zero when user space data is not accessible.
    


* * *
# selabel_lookup

## NAME



           selabel_lookup - obtain SELinux security context from a string
           label
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **int selabel_lookup(struct selabel_handle ***_hnd_**,**
                              **char ****_context_**,**
                              **const char ***_key_**, int** _type_**);**
    
           **int selabel_lookup_raw(struct selabel_handle ***_hnd_**,**
                                  **char ****_context_**,**
                                  **const char ***_key_**, int** _type_**);**
    


## DESCRIPTION



           **selabel_lookup**() performs a lookup operation on the handle _hnd_ ,
           returning the result in the memory pointed to by _context_ , which
           must be freed by the caller using freecon(3).  The _key_ and _type_
           parameters are the inputs to the lookup operation and are
           interpreted according to the specific backend that _handle_ is open
           on.
    
           **selabel_lookup_raw**() behaves identically to **selabel_lookup**() but
           does not perform context translation.
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned and _errno_
           is set appropriately.
    


## ERRORS



           **ENOENT** No context corresponding to the input _key_ and _type_ was
                  found.
    
           **EINVAL** The _key_ and/or _type_ inputs are invalid, or the context
                  being returned failed validation, or a regular expression
                  in the database failed to compile.
    
           **ENOMEM** An attempt to allocate memory failed.
    


* * *
# acl_delete_def_file

## NAME



           **acl_delete_def_file** — delete a default ACL by filename
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_delete_def_file**(_const char_
           _*path_p_)
    


## DESCRIPTION



           The **acl_delete_def_file**() function deletes a default ACL from the
           directory whose pathname is pointed to by the argument _path_p_.
    
           The effective user ID of the process must match the owner of the
           file or directory or the process must have the CAP_FOWNER
           capability for the request to succeed.
    
           If the argument _path_p_ is not a directory, then the function
           fails. It is no error if the directory whose pathname is pointed
           to by the argument _path_p_ does not have a default ACL.
    


## RETURN VALUE



           The **acl_delete_def_file**() 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_delete_def_file**() function returns the value **-1** and and sets
           _errno_ to the corresponding value:
    
           [EINVAL]           The file referred to by _path_p_ is not a
                              directory.
    
           [ENOTSUP]          The file system on which the file identified by
                              _path_p_ is located does not support ACLs, or
                              ACLs are disabled.
    
           [EPERM]            The process does not have appropriate privilege
                              to perform the operation to delete the default
                              ACL.
    
           [EROFS]            This function requires modification of a file
                              system which is currently read-only.
    


## STANDARDS



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


* * *
# pathconf

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



           pathconf — get configurable pathname variables
    


## SYNOPSIS



           #include <unistd.h>
    
           long pathconf(const char *_path_ , int _name_);
    


## DESCRIPTION



           Refer to fpathconf(3p).
    


* * *
# gnutls_x509_crl_set_version

## NAME



           gnutls_x509_crl_set_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_version(gnutls_x509_crl_t** _crl_**, unsigned**
           **int** _version_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           unsigned int version
                       holds the version number. For CRLv1 crls must be 1.
    


## DESCRIPTION



           This function will set the version of the CRL. This must be one
           for CRL version 1, and so on. The CRLs generated by gnutls should
           have a version number of 2.
    


## RETURNS



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


* * *
# acl_dup

## NAME



           **acl_dup** — duplicate an ACL
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _acl_t_ **acl_dup**(_acl_t acl_)
    


## DESCRIPTION



           The **acl_dup**() function returns a pointer to a copy of the ACL
           pointed to by _acl_.
    
           This function may cause memory to be allocated.  The caller should
           free any releasable memory, when the new ACL is no longer
           required, by calling _acl_free_(3) with the _(void*)acl_t_ returned by
           **acl_dup**() as an argument.
    


## RETURN VALUE



           On success, this function returns a pointer to the working
           storage.  On error, a value of **(acl_t)NULL** is returned, and _errno_
           is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_dup**() function
           returns a value of **(acl_t)NULL** and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    
           [ENOMEM]           The _acl_t_ to be returned requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    


## STANDARDS



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


* * *
# cabs

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



           cabs, cabsf, cabsl — return a complex absolute value
    


## SYNOPSIS



           #include <complex.h>
    
           double cabs(double complex _z_);
           float cabsf(float complex _z_);
           long double cabsl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex absolute value (also
           called norm, modulus, or magnitude) of _z_.
    


## RETURN VALUE



           These functions shall return the complex absolute value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::task_time_string_tid

## NAME



           function::task_time_string_tid - Human readable string of task
           time usage
    


## SYNOPSIS



               task_time_string_tid:string(tid:long)
    


## ARGUMENTS



           _tid_
               Thread id of the given task
    


## DESCRIPTION



           Returns a human readable string showing the user and system time
           the given task has used up to now. For example “usr: 0m12.908s,
           sys: 1m6.851s”.
    


* * *
# probe::vm.write_shared_copy

## NAME



           probe::vm.write_shared_copy - Page copy for shared page write
    


## SYNOPSIS



           vm.write_shared_copy
    


## VALUES



           _name_
               Name of the probe point
    
           _address_
               The address of the shared write
    
           _zero_
               boolean indicating whether it is a zero page (can do a clear
               instead of a copy)
    


## CONTEXT



           The process attempting the write.
    


## DESCRIPTION



           Fires when a write to a shared page requires a page copy. This is
           always preceded by a vm.write_shared.
    


* * *
# ibv_inc_rkey

## NAME



           ibv_inc_rkey - creates a new rkey from the given one
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  uint32_t ibv_inc_rkey(uint32_t rkey);
    


## DESCRIPTION



           **ibv_inc_rkey()** Increases the 8 LSB of _rkey_ and returns the new
           value.
    


## RETURN VALUE



           **ibv_inc_rkey()** returns the new rkey.
    


## NOTES



           The verb generates a new rkey that is different from the previous
           one on its tag part but has the same index (bits 0xffffff00).  A
           use case for this verb can be to create a new rkey from a Memory
           window’s rkey when binding it to a Memory region.
    


* * *
# tapset::ioblock

## NAME



           tapset::ioblock - systemtap ioblock tapset
    


## DESCRIPTION



           **ioblock.request**
                  Fires whenever making a generic block I/O request.
    
                   See probe::ioblock.request(3stap)
                   for details.
    
           **ioblock.end**
                  Fires whenever a block I/O transfer is complete.
    
                   See probe::ioblock.end(3stap)
                   for details.
    
           **ioblock_trace.bounce**
                  Fires whenever a buffer bounce is needed for at least one
                  page of a block IO request.
    
                   See probe::ioblock_trace.bounce(3stap)
                   for details.
    
           **ioblock_trace.request**
                  Fires just as a generic block I/O request is created for a
                  bio.
    
                   See probe::ioblock_trace.request(3stap)
                   for details.
    
           **ioblock_trace.end**
                  Fires whenever a block I/O transfer is complete.
    
                   See probe::ioblock_trace.end(3stap)
                   for details.
    


* * *
# gnutls_sign_list

## NAME



           gnutls_sign_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_sign_algorithm_t * gnutls_sign_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of supported public key signature algorithms.  This
           function is not thread safe.
    


## RETURNS



           a (0)-terminated list of **gnutls_sign_algorithm_t** integers
           indicating the available ciphers.
    


* * *
# audit_request_status

## NAME



           audit_request_status - Request status of the audit system
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_request_status(int** _fd_**);"**
    


## DESCRIPTION



           audit_request_status requests that the kernel send status
           structure describing various settings on the descriptor given in
           _fd_. The audit_status structure is as follows:
    
                  struct audit_status {
                     __u32   mask;           /* Bit mask for valid entries */
                     __u32   enabled;        /* 1 = enabled, 0 = disabled */
                     __u32   failure;        /* Failure-to-log action */
                     __u32   pid;            /* pid of auditd process */
                     __u32   rate_limit;     /* messages rate limit (per second) */
                     __u32   backlog_limit;  /* waiting messages limit */
                     __u32   lost;           /* messages lost */
                     __u32   backlog;        /* messages waiting in queue */
                  };
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *