tripathysagar/man_text huggingface dataset:
# stapvars

## NAME



           stapvars - systemtap variables
    


## DESCRIPTION



           The following sections enumerate the public variables provided by
           standard tapsets installed, (the installation path is show in the
           stappaths (7) manual page).  Each variable is described with a
           type, and its behavior/restrictions.  The syntax is the same as
           printed with the _stap_ option _-p2_.  Examples:
    
           example1:long
                  Variable "example1" contains an integer.
    
           example2:string [long]
                  Variable "example2" is an array of strings, indexed by
                  integers.
    
       **ARGV**
           argc:long
                  Contains the value of the $# value: the number of command
                  line arguments passed to the systemtap script.  It is
                  initialized with an implicit begin(-1) probe.
    
           argv:string [long]
                  Contains each command line argument as a string.  argv[1]
                  will equal @1 if there was at least one command line
                  argument.  Arguments beyond #32 are not transcribed, and
                  produce a warning message within the begin(-1) probe that
                  initializes this array.
    
       **NULL**
           NULL:long
                  Simply defined as the number 0.
    


## FILES



           More files and their corresponding paths can be found in the
           stappaths (7) manual page.
    


* * *
# tapset::speculative

## NAME



           tapset::speculative - systemtap speculative tapset
    


## DESCRIPTION



           **speculation**
                  Allocate a new id for speculative output
    
                  See function::speculation(3stap)
                   for details.
    
           **speculate**
                  Store a string for possible output later
    
                  See function::speculate(3stap)
                   for details.
    
           **discard**
                  Discard all output related to a speculation buffer
    
                  See function::discard(3stap)
                   for details.
    
           **commit** Write out all output related to a speculation buffer
    
                  See function::commit(3stap)
                   for details.
    


* * *
# libpfm_arm_neoverse_n1

## NAME



           libpfm_arm_neoverse_n1 - support for ARM Neoverse N1 core PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_n1**
           **PMU desc: ARM Neoverse N1**
    


## DESCRIPTION



           The library supports the ARM Neoverse N1 core PMU.
    
           This PMU supports 6 counters and privilege levels filtering.  It
           can operate in both 32 and 64 bit modes.
    


## MODIFIERS



           The following modifiers are supported on ARM Neoverse N1:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *
# fchdir

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



           fchdir — change working directory
    


## SYNOPSIS



           #include <unistd.h>
    
           int fchdir(int _fildes_);
    


## DESCRIPTION



           The _fchdir_() function shall be equivalent to _chdir_() except that
           the directory that is to be the new current working directory is
           specified by the file descriptor _fildes_.
    
           A conforming application can obtain a file descriptor for a file
           of type directory using _open_(), provided that the file status
           flags and access modes do not contain O_WRONLY or O_RDWR.
    


## RETURN VALUE



           Upon successful completion, _fchdir_() shall return 0. Otherwise, it
           shall return -1 and set _errno_ to indicate the error. On failure
           the current working directory shall remain unchanged.
    


## ERRORS



           The _fchdir_() function shall fail if:
    
           **EACCES** Search permission is denied for the directory referenced by
                  _fildes_.
    
           **EBADF** The _fildes_ argument is not an open file descriptor.
    
           **ENOTDIR**
                  The open file descriptor _fildes_ does not refer to a
                  directory.
    
           The _fchdir_() may fail if:
    
           **EINTR** A signal was caught during the execution of _fchdir_().
    
           **EIO** An I/O error occurred while reading from or writing to the
                  file system.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::signal.pending

## NAME



           probe::signal.pending - Examining pending signal
    


## SYNOPSIS



           signal.pending
    


## VALUES



           _name_
               Name of the probe point
    
           _sigset_add_
               The address of the user-space signal set (sigset_t)
    
           _sigset_size_
               The size of the user-space signal set
    


## DESCRIPTION



           This probe is used to examine a set of signals pending for
           delivery to a specific thread. This normally occurs when the
           do_sigpending kernel function is executed.
    


* * *
# makedev

## NAME



           makedev, major, minor - manage a device number
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/sysmacros.h>**
    
           **dev_t makedev(unsigned int** _maj_**, unsigned int** _min_**);**
    
           **unsigned int major(dev_t** _dev_**);**
           **unsigned int minor(dev_t** _dev_**);**
    


## DESCRIPTION



           A device ID consists of two parts: a major ID, identifying the
           class of the device, and a minor ID, identifying a specific
           instance of a device in that class.  A device ID is represented
           using the type _dev_t_.
    
           Given major and minor device IDs, **makedev**() combines these to
           produce a device ID, returned as the function result.  This device
           ID can be given to mknod(2), for example.
    
           The **major**() and **minor**() functions perform the converse task: given
           a device ID, they return, respectively, the major and minor
           components.  These macros can be useful to, for example, decompose
           the device IDs in the structure returned by stat(2).
    


## ATTRIBUTES



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


## VERSIONS



           The BSDs expose the definitions for these macros via
           _< sys/types.h>_.
    


## STANDARDS



           None.
    


* * *
# wcsspn

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



           wcsspn — get the length of a wide substring
    


## SYNOPSIS



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


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _wcsspn_() function shall compute the length (in wide
           characters) of the maximum initial segment of the wide-character
           string pointed to by _ws1_ which consists entirely of wide-character
           codes from the wide-character string pointed to by _ws2_.
    


## RETURN VALUE



           The _wcsspn_() function shall return the length of the initial
           substring of _ws1_ ; 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



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_privkey_set_spki

## NAME



           gnutls_privkey_set_spki - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_set_spki(gnutls_privkey_t** _privkey_**, const**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t privkey
                       a public key of type **gnutls_privkey_t**
    
           const gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_privkey_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will set the public key information.  The provided
           _spki_ must be initialized.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# rdma_get_devices

## NAME



           rdma_get_devices - Get a list of RDMA devices currently available.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **struct ibv_context ** rdma_get_devices (int ***_num_devices_**);**
    


## ARGUMENTS



           num_devices If non-NULL, set to the number of devices returned.
    


## DESCRIPTION



           Return a NULL-terminated array of opened RDMA devices.  Callers
           can use this routine to allocate resources on specific RDMA
           devices that will be shared across multiple rdma_cm_id's.
    


## RETURN VALUE



           Returns an array of available RDMA devices, or NULL if the request
           fails.  On failure, errno will be set to indicate the failure
           reason.
    


## NOTES



           The returned array must be released by calling rdma_free_devices.
           Devices remain opened while the librdmacm is loaded.
    


* * *
# gnutls_alert_get

## NAME



           gnutls_alert_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_alert_description_t gnutls_alert_get(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will return the last alert number received.  This
           function should be called when **GNUTLS_E_WARNING_ALERT_RECEIVED** or
           **GNUTLS_E_FATAL_ALERT_RECEIVED** errors are returned by a gnutls
           function.  The peer may send alerts if he encounters an error.  If
           no alert has been received the returned value is undefined.
    


## RETURNS



           the last alert received, a **gnutls_alert_description_t** value.
    


* * *
# QmcSource

## NAME



           **QmcSource** - manages contexts created by all groups
    


## C++ SYNOPSIS



           **#include <QmcSource.h>**
    
           **c++ ... -lpcp_qmc -lpcp**
    


## DESCRIPTION



           The  **QmcSource** class maintains a unique list of all metric sources
           in  use  to  minimize  the   creation   of   new   contexts   (see
           pmNewContext(3))  when the context could have been duplicated (see
           pmDupContext(3)).  This also reduces the duplication  of  descrip‐
           tions of each source.
    
           In general, **QMC** users should only need to access **QmcSource** methods
           to  obtain  source  descriptions  for a QmcContext(3) object.  All
           context  creation  by  the  user   should   be   handled   through
           QmcGroup(3).
    


## DESTRUCTOR



           **~QmcSource();**
               Destructor.
    


## CONSTRUCTORS



           **static QmcSource* getSource(int type, const char* source,**
               **bool matchHosts)**
    
               This method will return a **QmcSource** object that represents a
               context of _type_ to _source_.  The **QmcSource** object may be a new
               object if the _source_ has not been previously requested. Memory
               management of the **QmcSource** objects is handled by **QmcSource**.
               If all QmcContext(3)s to the **QmcSource** have been deleted, the
               **QmcSource** object will also be deleted.
    
               The _matchHosts_ flag controls the algorithm that is used to
               match hosts to archives.  If _matchHosts_ is equal to **false** then
               no attempt will be made by this method to match a host context
               to an existing source context. A **QmcSource** object will always
               be returned in this case, although the **QmcSource::status**
               method may indicate that a context to _source_ failed.
    
               If _matchHosts_ is equal to **true** , host contexts will be matched
               to a predefined archive source collected from that _source_.  If
               no archive sources for the _source_ have been previous speci‐
               fied, **getSource** will return a NULL pointer.
    


## DIAGNOSTICS



           Error messages are generated using pmprintf(3) but are not
           flushed. It is the responsibility of the user to call pmflush(3)
           to output any messages.
    
           Additional diagnostics may be activated by adding the option **pmc**
           to the global debugging specification, as described in
           pmSetDebug(3).
    


* * *
# pam_set_data

## NAME



           pam_set_data - set module internal data
    


## SYNOPSIS



           **#include <security/pam_modules.h>**
    
           **int pam_set_data(pam_handle_t ***_pamh_**, const char ***_module_data_name_**,**
                            **void ***_data_**,**
                            **void** _(*cleanup)(pam_handle_t *pamh, void *data, int error_status)_**);**
    


## DESCRIPTION



           The **pam_set_data** function associates a pointer to an object with
           the (hopefully) unique string _module_data_name_ in the PAM context
           specified by the _pamh_ argument.
    
           PAM modules may be dynamically loadable objects. In general such
           files should not contain _static_ variables. This function and its
           counterpart pam_get_data(3), provide a mechanism for a module to
           associate some data with the handle _pamh_. Typically a module will
           call the **pam_set_data** function to register some data under a
           (hopefully) unique _module_data_name_. The data is available for use
           by other modules too but _not_ by an application. Since this
           functions stores only a pointer to the _data_ , the module should not
           modify or free the content of it.
    
           The function **cleanup()** is associated with the _data_ and, if
           non-NULL, it is called when this data is over-written or following
           a call to pam_end(3).
    
           The _error_status_ argument is used to indicate to the module the
           sort of action it is to take in cleaning this data item. As an
           example, Kerberos creates a ticket file during the authentication
           phase, this file might be associated with a data item. When
           pam_end(3) is called by the module, the _error_status_ carries the
           return value of the pam_authenticate(3) or other _libpam_ function
           as appropriate. Based on this value the Kerberos module may choose
           to delete the ticket file (_authentication failure_) or leave it in
           place.
    
           The _error_status_ may have been logically OR'd with either of the
           following two values:
    
           PAM_DATA_REPLACE
               When a data item is being replaced (through a second call to
               **pam_set_data**) this mask is used. Otherwise, the call is
               assumed to be from pam_end(3).
    
           PAM_DATA_SILENT
               Which indicates that the process would prefer to perform the
               **cleanup()** quietly. That is, discourages logging/messages to
               the user.
    


## RETURN VALUES



           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_SUCCESS
               Data was successful stored.
    
           PAM_SYSTEM_ERR
               A NULL pointer was submitted as PAM handle or the function was
               called by an application.
    


* * *
# gettimeofday

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



           gettimeofday — get the date and time
    


## SYNOPSIS



           #include <sys/time.h>
    
           int gettimeofday(struct timeval *restrict _tp_ , void *restrict _tzp_);
    


## DESCRIPTION



           The _gettimeofday_() function shall obtain the current time,
           expressed as seconds and microseconds since the Epoch, and store
           it in the **timeval** structure pointed to by _tp_.  The resolution of
           the system clock is unspecified.
    
           If _tzp_ is not a null pointer, the behavior is unspecified.
    


## RETURN VALUE



           The _gettimeofday_() function shall return 0 and no value shall be
           reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications should use the _clock_gettime_() function instead of
           the obsolescent _gettimeofday_() function.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           The _gettimeofday_() function may be removed in a future version.
    


* * *
# probe::tcp.sendmsg

## NAME



           probe::tcp.sendmsg - Sending a tcp message
    


## SYNOPSIS



           tcp.sendmsg
    


## VALUES



           _name_
               Name of this probe
    
           _sock_
               Network socket
    
           _size_
               Number of bytes to send
    
           _family_
               IP address family
    


## CONTEXT



           The process which sends a tcp message
    


* * *
# gnutls_certificate_free_keys

## NAME



           gnutls_certificate_free_keys - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_certificate_free_keys(gnutls_certificate_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    


## DESCRIPTION



           This function will delete all the keys and the certificates
           associated with the given credentials. This function must not be
           called when a TLS negotiation that uses the credentials is in
           progress.
    


* * *
# gnutls_privkey_export_dsa_raw

## NAME



           gnutls_privkey_export_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_dsa_raw(gnutls_privkey_t** _key_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**, gnutls_datum_t ***_x_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the public key
    
           gnutls_datum_t * p
                       will hold the p
    
           gnutls_datum_t * q
                       will hold the q
    
           gnutls_datum_t * g
                       will hold the g
    
           gnutls_datum_t * y
                       will hold the y
    
           gnutls_datum_t * x
                       will hold the x
    


## DESCRIPTION



           This function will export the DSA private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_pkcs7_add_attr

## NAME



           gnutls_pkcs7_add_attr - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_pkcs7_attrs_t * list
                       A list of existing attributes or pointer to **NULL** for
                       the first one
    
           const char * oid
                       the OID of the attribute to be set
    
           gnutls_datum_t * data
                       the raw (DER-encoded) data of the attribute to be set
    
           unsigned flags
                       zero or **GNUTLS_PKCS7_ATTR_ENCODE_OCTET_STRING**
    


## DESCRIPTION



           This function will set a PKCS **7** attribute in the provided list.
           If this function fails, the previous list would be deallocated.
    
           Note that any attributes set with this function must either be DER
           or BER encoded, unless a special flag is present.
    


## RETURNS



           On success, the new list head, otherwise **NULL**.
    


## SINCE



           3.4.2
    


* * *
# gnutls_get_library_config

## NAME



           gnutls_get_library_config - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_library_config_st * gnutls_get_library_config(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Returns the library configuration as key value pairs.  Currently
           defined keys are:
    
           - fips-module-name: the name of the FIPS140 module
    
           - fips-module-version: the version of the FIPS140 module
    
           - libgnutls-soname: the SONAME of the library itself
    
           - libnettle-soname: the library SONAME of linked libnettle
    
           - libhogweed-soname: the library SONAME of linked libhogweed
    
           - libgmp-soname: the library SONAME of linked libgmp
    
           - hardware-features: enabled hardware support features
    
           - tls-features: enabled TLS protocol features
    


## RETURNS



           a NUL-terminated **gnutls_library_config_st** array
    


## SINCE



           3.7.3
    


* * *
# tcgetsid

## NAME



           tcgetsid - get session ID
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _XOPEN_SOURCE 500** /* See feature_test_macros(7) */
           **#include <termios.h>**
    
           **pid_t tcgetsid(int** _fd_**);**
    


## DESCRIPTION



           The function **tcgetsid**() returns the session ID of the current
           session that has the terminal associated to _fd_ as controlling
           terminal.  This terminal must be the controlling terminal of the
           calling process.
    


## RETURN VALUE



           When _fd_ refers to the controlling terminal of our session, the
           function **tcgetsid**() will return the session ID of this session.
           Otherwise, -1 is returned, and _errno_ is set to indicate the error.
    


## ERRORS



           **EBADF** _fd_ is not a valid file descriptor.
    
           **ENOTTY** The calling process does not have a controlling terminal,
                  or it has one but it is not described by _fd_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# fabs

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



           fabs, fabsf, fabsl — absolute value function
    


## SYNOPSIS



           #include <math.h>
    
           double fabs(double _x_);
           float fabsf(float _x_);
           long double fabsl(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 absolute value of their argument
           _x_ ,|_x_ |.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           absolute value of _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, +0 shall be returned.
    
           If _x_ is ±Inf, +Inf shall be returned.
    


## ERRORS



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


## EXAMPLES



       **Computing the 1-Norm of a Floating-Point Vector**
           This example shows the use of _fabs_() to compute the 1-norm of a
           vector defined as follows:
    
               norm1(v) = |v[0]| + |v[1]| + ... + |v[n-1]|
    
           where |_x_ | denotes the absolute value of _x_ , _n_ denotes the vector's
           dimension _v_[_i_] denotes the _i_ -th component of _v_ (0≤ _i_ <_n_).
    
               #include <math.h>
    
               double
               norm1(const double v[], const int n)
               {
                   int     i;
                   double  n1_v;  /* 1-norm of v */
    
                   n1_v = 0;
                   for (i=0; i<n; i++) {
                       n1_v += fabs (v[i]);
                   }
    
                   return n1_v;
               }
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_privkey_status

## NAME



           gnutls_privkey_status - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_status(gnutls_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the key
    


## DESCRIPTION



           Checks the status of the private key token. This function is an
           actual wrapper over **gnutls_pkcs11_privkey_status()** , and if the
           private key is a PKCS **11** token it will check whether it is
           inserted or not.
    


## RETURNS



           this function will return non-zero if the token holding the
           private key is still available (inserted), and zero otherwise.
    


## SINCE



           3.1.10
    


* * *
# gnutls_pkcs11_add_provider

## NAME



           gnutls_pkcs11_add_provider - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_add_provider(const char ***_name_**, const char ***
           _params_**);**
    


## ARGUMENTS



           const char * name
                       The filename of the module
    
           const char * params
                       should be NULL or a known string (see description)
    


## DESCRIPTION



           This function will load and add a PKCS 11 module to the module
           list used in gnutls. After this function is called the module will
           be used for PKCS 11 operations.
    
           When loading a module to be used for certificate verification, use
           the string 'trusted' as  _params_ .
    
           Note that this function is not thread safe.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# hnsdv_query_device

## NAME



           hnsdv_query_device - Query hns device specific attributes
    


## SYNOPSIS



                  #include <infiniband/hnsdv.h>
                  int hnsdv_query_device(struct ibv_context *context,
                                         struct hnsdv_context *attrs_out);
    


## DESCRIPTION



           **hnsdv_query_device()** Queries hns device specific attributes.
    


## ARGUMENTS



           Please see _ibv_query_device(3)_ man page for _context_.
    
       **attrs_out**
                  struct hnsdv_context {
                          uint64_t comp_mask;
                          uint64_t flags;
                          uint8_t congest_type;
                          uint8_t reserved[7];
                  };
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid:
    
                  HNSDV_CONTEXT_MASK_CONGEST_TYPE: Congestion control
                  algorithm is supported.
    
           _congest_type_
                  Bitmask of supported congestion control algorithms.
    
                  HNSDV_QP_CREATE_ENABLE_DCQCN: Data Center Quantized
                  Congestion Notification HNSDV_QP_CREATE_ENABLE_LDCP: Low
                  Delay Control Protocol HNSDV_QP_CREATE_ENABLE_HC3: Huawei
                  Converged Congestion Control HNSDV_QP_CREATE_ENABLE_DIP:
                  Destination IP based Quantized Congestion Notification
    


## RETURN VALUE



           **hnsdv_query_device()** returns 0 on success, or the value of errno
           on failure (which indicates the failure reason).
    


## NOTES



           • _flags_ is an out field and currently has no values.
    


* * *
# function::current_exe_file

## NAME



           function::current_exe_file - get the file struct pointer for the
           current task's executable file
    


## SYNOPSIS



               current_exe_file:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the file struct pointer for the current
           task's executable file. Note that the file struct pointer isn't
           locked on return. The return value of this function can be passed
           to **fullpath_struct_file** to get the path from the file struct.
    


* * *
# auparse_interpret_field

## NAME



           auparse_interpret_field, auparse_interpret_realpath,auparse_interpret_sock_family,auparse_interpret_sock_port,auparse_interpret_sock_address - get current field's interpreted value
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **const char *auparse_interpret_field(const auparse_state_t ***_au_**);**
           **const char *auparse_interpret_realpath(const auparse_state_t ***_au_**);**
           **const char *auparse_interpret_sock_family(auparse_state_t ***_au_**);**
           **const char *auparse_interpret_sock_port(auparse_state_t ***_au_**);**
           **const char *auparse_interpret_sock_address(const auparse_state_t ***_au_**);**
    


## DESCRIPTION



           **auparse_interpret_field** allows access to the interpreted value in
           the current field of the current record in the current event. The
           returned string is escaped using the chosen method. The returned
           value will be destroyed if you call this function again. If you
           need to interpret another field and keep this value, you will have
           to copy it for later use.
    
           Examples of things that could be interpreted are: uid, gid,
           syscall numbers, exit codes, file paths, socket addresses,
           permissions, modes, and capabilities. There are likely to be more
           in the future. If a value cannot be interpreted, its original
           value is returned.
    
           **auparse_interpret_realpath** is like auparse_interpret_field except
           that it will call realpath on the results of gluing the cwd and
           file together. This also implies that it only valid to be called
           for the file name given in a PATH record.
    
           **auparse_interpret_sock_family** will only return the socket family
           portion of a socket address.
    
           **auparse_interpret_sock_port** will only return the port portion of a
           socket address. Not all socket families have a port. If that is
           the case, you will get a NULL value in which case your best option
           is to use the normal interpretation function.
    
           **auparse_interpret_sock_address** will only return the address
           portion of a socket address. Not all socket families have an ip
           address. If that is the case, you will get a NULL value in which
           case your best option is to use the normal interpretation
           function.
    


## RETURN VALUE



           Returns NULL if there is an error otherwise a pointer to the
           interpreted value.
    


* * *
# gnutls_pubkey_get_preferred_hash_algorithm

## NAME



           gnutls_pubkey_get_preferred_hash_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_get_preferred_hash_algorithm(gnutls_pubkey_t**
           _key_**, gnutls_digest_algorithm_t ***_hash_**, unsigned int ***_mand_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the certificate
    
           gnutls_digest_algorithm_t * hash
                       The result of the call with the hash algorithm used
                       for signature
    
           unsigned int * mand
                       If non zero it means that the algorithm MUST use this
                       hash. May be NULL.
    


## DESCRIPTION



           This function will read the certificate and return the appropriate
           digest algorithm to use for signing with this certificate. Some
           certificates (i.e.  DSA might not be able to sign without the
           preferred algorithm).
    
           To get the signature algorithm instead of just the hash use
           **gnutls_pk_to_sign()** with the algorithm of the certificate/key and
           the provided  _hash_ .
    


## RETURNS



           the 0 if the hash algorithm is found. A negative error code is
           returned on error.
    


## SINCE



           2.12.0
    


* * *
# tep_get_long_size

## NAME



           tep_get_long_size, tep_set_long_size - Get / set the size of a
           long integer on the machine, where the trace is generated, in
           bytes
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           int **tep_get_long_size**(strucqt tep_handle *_tep_);
           void **tep_set_long_size**(struct tep_handle *_tep_ , int _long_size_);
    


## DESCRIPTION



           The **tep_get_long_size()** function returns the size of a long
           integer on the machine, where the trace is generated. The _tep_
           argument is trace event parser context.
    
           The **tep_set_long_size()** function sets the size of a long integer
           on the machine, where the trace is generated. The _tep_ argument is
           trace event parser context. The _long_size_ is the size of a long
           integer, in bytes.
    


## RETURN VALUE



           The **tep_get_long_size()** function returns the size of a long
           integer on the machine, where the trace is generated, in bytes.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               tep_set_long_size(tep, 4);
               ...
               int long_size = tep_get_long_size(tep);
               ...
    


## FILES



               **event-parse.h**
                       Header file to include in order to have access to the library APIs.
               **-ltraceevent**
                       Linker switch to add when building a program that uses the library.
    


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



           **https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ **
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    
            2. tz.stoyanov@gmail.com
               mailto:tz.stoyanov@gmail.com
    
            3. linux-trace-devel@vger.kernel.org
               mailto:linux-trace-devel@vger.kernel.org
    


* * *
# gnutls_session_get_random

## NAME



           gnutls_session_get_random - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_get_random(gnutls_session_t** _session_**,**
           **gnutls_datum_t ***_client_**, gnutls_datum_t ***_server_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * client
                       the client part of the random
    
           gnutls_datum_t * server
                       the server part of the random
    


## DESCRIPTION



           This function returns pointers to the client and server random
           fields used in the TLS handshake. The pointers are not to be
           modified or deallocated.
    
           If a client random value has not yet been established, the output
           will be garbage.
    


## SINCE



           3.0
    


* * *
# mlx5dv_vfio_process_events

## NAME



           mlx5dv_vfio_process_events - process vfio driver events
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_vfio_process_events(struct ibv_context *ctx);
    


## DESCRIPTION



           This API should run from application thread and maintain device
           events.  The application is responsible to get the events FD by
           calling _mlx5dv_vfio_get_events_fd()_ and once the FD is pollable
           call the API to let driver process its internal events.
    


## ARGUMENTS



           _ctx_    device context that was opened for VFIO by calling
                  mlx5dv_get_vfio_device_list().
    


## RETURN VALUE



           Returns 0 upon success or errno value in case a failure has
           occurred.
    


## NOTES



           Application can use this API also to periodically check the device
           health state even if no events exist.
    


* * *
# ibv_create_srq_ex

## NAME



           ibv_create_srq_ex, ibv_destroy_srq - create or destroy a shared
           receive queue (SRQ)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_srq *ibv_create_srq_ex(struct ibv_context** _*context_**, struct**
                                          **ibv_srq_init_attr_ex** _*srq_init_attr_ex_**);**
    
           **int ibv_destroy_srq(struct ibv_srq** _*srq_**);**
    


## DESCRIPTION



           **ibv_create_srq_ex()** creates a shared receive queue (SRQ)
           supporting both basic and xrc modes.  The argument
           _srq_init_attr_ex_ is an ibv_srq_init_attr_ex struct, as defined in
           <infiniband/verbs.h>.
    
           struct ibv_srq_init_attr_ex {
                   void                   *srq_context;    /* Associated context of the SRQ */
                   struct ibv_srq_attr     attr;           /* SRQ attributes */
                   uint32_t                comp_mask;      /* Identifies valid fields */
                   enum ibv_srq_type       srq_type;       /* Basic / XRC / tag matching */
                   struct ibv_pd          *pd;             /* PD associated with the SRQ */
                   struct ibv_xrcd        *xrcd;           /* XRC domain to associate with the SRQ */
                   struct ibv_cq          *cq;             /* CQ to associate with the SRQ for XRC mode */
                   struct ibv_tm_cap       tm_cap;         /* Tag matching attributes */
           };
    
           struct ibv_srq_attr {
                   uint32_t                max_wr;         /* Requested max number of outstanding work requests (WRs) in the SRQ */
                   uint32_t                max_sge;        /* Requested max number of scatter elements per WR */
                   uint32_t                srq_limit;      /* The limit value of the SRQ */
           };
    
           struct ibv_tm_cap {
                   uint32_t                max_num_tags;   /* Tag matching list size */
                   uint32_t                max_ops;        /* Number of outstanding tag list operations */
           };
    
           The function **ibv_create_srq_ex()** will update the _srq_init_attr_ex_
           struct with the original values of the SRQ that was created; the
           values of max_wr and max_sge will be greater than or equal to the
           values requested.
    
           **ibv_destroy_srq()** destroys the SRQ _srq_.
    


## RETURN VALUE



           **ibv_create_srq_ex()** returns a pointer to the created SRQ, or NULL
           if the request fails.
    
           **ibv_destroy_srq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_destroy_srq()** fails if any queue pair is still associated with
           this SRQ.
    


* * *
# gnutls_ocsp_req_import

## NAME



           gnutls_ocsp_req_import - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_import(gnutls_ocsp_req_t** _req_**, const**
           **gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       The data to store the parsed request.
    
           const gnutls_datum_t * data
                       DER encoded OCSP request.
    


## DESCRIPTION



           This function will convert the given DER encoded OCSP request to
           the native **gnutls_ocsp_req_t** format. The output will be stored in
            _req_ .
    


## RETURNS



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


* * *
# probe::signal.sys_tgkill

## NAME



           probe::signal.sys_tgkill - Sending kill signal to a thread group
    


## SYNOPSIS



           signal.sys_tgkill
    


## VALUES



           _sig_pid_
               The PID of the thread receiving the kill signal
    
           _sig_name_
               A string representation of the signal
    
           _name_
               Name of the probe point
    
           _sig_
               The specific kill signal sent to the process
    
           _task_
               A task handle to the signal recipient
    
           _tgid_
               The thread group ID of the thread receiving the kill signal
    
           _pid_name_
               The name of the signal recipient
    


## DESCRIPTION



           The tgkill call is similar to tkill, except that it also allows
           the caller to specify the thread group ID of the thread to be
           signalled. This protects against TID reuse.
    


* * *
# pthread_kill_other_threads_np

## NAME



           pthread_kill_other_threads_np - terminate all other threads in
           process
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **void pthread_kill_other_threads_np(void);**
    


## DESCRIPTION



           **pthread_kill_other_threads_np**() has an effect only in the
           LinuxThreads threading implementation.  On that implementation,
           calling this function causes the immediate termination of all
           threads in the application, except the calling thread.  The
           cancelation state and cancelation type of the to-be-terminated
           threads are ignored, and the cleanup handlers are not called in
           those threads.
    


## ATTRIBUTES



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


## VERSIONS



           In the NPTL threading implementation,
           **pthread_kill_other_threads_np**() exists, but does nothing.
           (Nothing needs to be done, because the implementation does the
           right thing during an execve(2).)
    


## STANDARDS



           GNU; hence the suffix "_np" (nonportable) in the name.
    


## NOTES



           **pthread_kill_other_threads_np**() is intended to be called just
           before a thread calls execve(2) or a similar function.  This
           function is designed to address a limitation in the obsolete
           LinuxThreads implementation whereby the other threads of an
           application are not automatically terminated (as POSIX.1-2001
           requires) during execve(2).
    


* * *