tripathysagar/man_text huggingface dataset:
# gnutls_record_recv

## NAME



           gnutls_record_recv - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_recv(gnutls_session_t** _session_**, void ***_data_**,**
           **size_t** _data_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * data the buffer that the data will be read into
    
           size_t data_size
                       the number of requested bytes
    


## DESCRIPTION



           This function has the similar semantics with **recv()**.  The only
           difference is that it accepts a GnuTLS session, and uses different
           error codes.  In the special case that the peer requests a
           renegotiation, the caller will receive an error code of
           **GNUTLS_E_REHANDSHAKE**.  In case of a client, this message may be
           simply ignored, replied with an alert **GNUTLS_A_NO_RENEGOTIATION** ,
           or replied with a new handshake, depending on the client's will. A
           server receiving this error code can only initiate a new handshake
           or terminate the session.
    
           If **EINTR** is returned by the internal pull function (the default is
           **recv()**) then **GNUTLS_E_INTERRUPTED** will be returned.  If
           **GNUTLS_E_INTERRUPTED** or **GNUTLS_E_AGAIN** is returned, you must call
           this function again to get the data.  See also
           **gnutls_record_get_direction()**.
    


## RETURNS



           The number of bytes received and zero on EOF (for stream
           connections).  A negative error code is returned in case of an
           error.  The number of bytes received might be less than the
           requested  _data_size_ .
    


* * *
# gnutls_cipher_get_id

## NAME



           gnutls_cipher_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_cipher_algorithm_t gnutls_cipher_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a cipher algorithm name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           return a **gnutls_cipher_algorithm_t** value corresponding to the
           specified cipher, or **GNUTLS_CIPHER_UNKNOWN** on error.
    


* * *
# function::ns_ppid

## NAME



           function::ns_ppid - Returns the process ID of a target process's
           parent process as seen in a pid namespace
    


## SYNOPSIS



               ns_ppid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function return the process ID of the target proccess's
           parent process as seen in the target pid namespace if provided, or
           the stap process namespace.
    


* * *
# gnutls_sign_supports_pk_algorithm

## NAME



           gnutls_sign_supports_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_sign_supports_pk_algorithm(gnutls_sign_algorithm_t**
           _sign_**, gnutls_pk_algorithm_t** _pk_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t sign
                       is a signature algorithm
    
           gnutls_pk_algorithm_t pk
                       is a public key algorithm
    


## DESCRIPTION



           This function returns non-zero if the public key algorithm
           corresponds to the given signature algorithm. That is, if that
           signature can be generated from the given private key algorithm.
    


## SINCE



           3.6.0
    


## RETURNS



           return non-zero when the provided algorithms are compatible.
    


* * *
# io_uring_prep_setxattr

## NAME



           io_uring_prep_setxattr, io_uring_prep_fsetxattr - prepare a
           request to set an extended attribute value
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_setxattr(struct io_uring_sqe ***_sqe_**,**
                                       **const char ***_name_**,**
                                       **const char ***_value_**,**
                                       **const char ***_path_**,**
                                       **int** _flags_**,**
                                       **unsigned int** _len_**);**
    
           **void io_uring_prep_fsetxattr(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **const char ***_name_**,**
                                        **const char ***_value_**,**
                                        **int** _flags_**,**
                                        **unsigned int** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_setxattr(3) function prepares a request to set
           an extended attribute value. The submission queue entry _sqe_ is
           setup to set the _value_ of the extended attribute identified by
           _name_ and associated with the given _path_ in the filesystem with
           modifier flags _flags_.  The _len_ argument specifies the size (in
           bytes) of _value_.
    
           io_uring_prep_fsetxattr(3) is identical to
           io_uring_prep_setxattr(3), only the extended attribute is set on
           the open file referred to by _fd_ in place of _path_.
    
           This function prepares an async setxattr(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


* * *
# seekdir

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



           seekdir — set the position of a directory stream
    


## SYNOPSIS



           #include <dirent.h>
    
           void seekdir(DIR *_dirp_ , long _loc_);
    


## DESCRIPTION



           The _seekdir_() function shall set the position of the next
           _readdir_() operation on the directory stream specified by _dirp_ to
           the position specified by _loc_.  The value of _loc_ should have been
           returned from an earlier call to _telldir_() using the same
           directory stream. The new position reverts to the one associated
           with the directory stream when _telldir_() was performed.
    
           If the value of _loc_ was not obtained from an earlier call to
           _telldir_(), or if a call to _rewinddir_() occurred between the call
           to _telldir_() and the call to _seekdir_(), the results of subsequent
           calls to _readdir_() are unspecified.
    


## RETURN VALUE



           The _seekdir_() function shall not return a value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The original standard developers perceived that there were
           restrictions on the use of the _seekdir_() and _telldir_() functions
           related to implementation details, and for that reason these
           functions need not be supported on all POSIX-conforming systems.
           They are required on implementations supporting the XSI option.
    
           One of the perceived problems of implementation is that returning
           to a given point in a directory is quite difficult to describe
           formally, in spite of its intuitive appeal, when systems that use
           B-trees, hashing functions, or other similar mechanisms to order
           their directories are considered. The definition of _seekdir_() and
           _telldir_() does not specify whether, when using these interfaces, a
           given directory entry will be seen at all, or more than once.
    
           On systems not supporting these functions, their capability can
           sometimes be accomplished by saving a filename found by _readdir_()
           and later using _rewinddir_() and a loop on _readdir_() to relocate
           the position from which the filename was saved.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_register_iowq_aff

## NAME



           io_uring_register_iowq_aff - register async worker CPU affinities
    


## SYNOPSIS



           **#include <sched.h>**
           **#include <liburing.h>**
    
           **int io_uring_register_iowq_aff(struct io_uring ***_ring_**,**
                                          **size_t** _cpusz_**,**
                                          **const cpu_set_t ***_mask_**);**
    
           **void io_uring_unregister_iowq_aff(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The **io_uring_prep_register_iowq_aff**(3) function registers a set of
           CPU affinities to be used by the io_uring async workers. By
           default, io_uring async workers are allowed to run on any CPU in
           the system. If this function is called with _ring_ set to the ring
           in question and _mask_ set to a pointer to a **cpu_set_t** value and
           _cpusz_ set to the size of the CPU set, then async workers will only
           be allowed to run on the CPUs specified in the mask. Existing
           workers may need to hit a schedule point before they are migrated.
    
           For unregistration, io_uring_unregister_iowq_aff(3) may be called
           to restore CPU affinities to the default.
    
           Applications must define **_GNU_SOURCE** to obtain the definition of
           this helper, as _cpu_set_t_ will not be defined without it.
    


## RETURN VALUE



           Returns **0** on success, or any of the following values in case of
           error.
    
           **-EFAULT**
                  The kernel was unable to copy the memory pointer to by _mask_
                  as it was invalid.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the new CPU
                  mask.
    
           **-EINVAL**
                  _cpusz_ or _mask_ was NULL/0, or any other value specified was
                  invalid.
    


* * *
# mrand48

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



           mrand48 — generate uniformly distributed pseudo-random signed long
           integers
    


## SYNOPSIS



           #include <stdlib.h>
    
           long mrand48(void);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# probe::nfsd.create

## NAME



           probe::nfsd.create - NFS server creating a
           file(regular,dir,device,fifo) for client
    


## SYNOPSIS



           nfsd.create
    


## VALUES



           _type_
               file type(regular,dir,device,fifo ...)
    
           _iap_mode_
               file access mode
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _filename_
               file name
    
           _iap_valid_
               Attribute flags
    
           _client_ip_
               the ip address of client
    
           _filelen_
               the length of file name
    


## DESCRIPTION



           Sometimes nfsd will call nfsd_create_v3 instead of this this probe
           point.
    


* * *
# gnutls_certificate_server_set_request

## NAME



           gnutls_certificate_server_set_request - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_certificate_server_set_request(gnutls_session_t**
           _session_**, gnutls_certificate_request_t** _req_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_certificate_request_t req
                       is one of GNUTLS_CERT_REQUEST, GNUTLS_CERT_REQUIRE,
                       GNUTLS_CERT_IGNORE
    


## DESCRIPTION



           This function specifies if we (in case of a server) are going to
           send a certificate request message to the client. If  _req_ is
           GNUTLS_CERT_REQUIRE then the server will return the
           **GNUTLS_E_NO_CERTIFICATE_FOUND** error if the peer does not provide a
           certificate. If you do not call this function then the client will
           not be asked to send a certificate. Invoking the function with
           _req_ GNUTLS_CERT_IGNORE has the same effect.
    


* * *
# umad_class_str

## NAME



           umad_*_str - class of functions to return string representations
           of enums
    


## SYNOPSIS



           **#include <infiniband/umad_str.h>**
    
           **const char * umad_class_str(uint8_t mgmt_class)**
           **const char * umad_method_str(uint8_t mgmt_class, uint8_t method)**
           **const char * umad_attribute_str(uint8_t mgmt_class, be16_t attr_id)**
    
           **const char * umad_common_mad_status_str(be16_t status)**
           **const char * umad_sa_mad_status_str(be16_t status)**
    


## DESCRIPTION



           **const char * umad_class_str(uint8_t mgmt_class)** Return string
           value of management class enum
    
           **const char * umad_method_str(uint8_t mgmt_class, uint8_t method)**
           Return string value of the method for the mgmt_class specified
    
           **const char * umad_attribute_str(uint8_t mgmt_class, be16_t**
           **attr_id)** Return string value of attribute specified in attr_id
           based on mgmt_class specified.
    
           **const char * umad_common_mad_status_str(be16_t status)** Return
           string value for common MAD status values
    
           **const char * umad_sa_mad_status_str(be16_t status)** Return string
           value for SA MAD status values
    
           **NOTE:** Not all classes are supported.
    


## RETURN VALUE



           Returns a string representations of the fields specified.
    


* * *
# tapset::syscall_any

## NAME



           tapset::syscall_any - systemtap syscall_any tapset
    


## DESCRIPTION



           **syscall_any**
                  Record entry into a syscall
    
                   See probe::syscall_any(3stap)
                   for details.
    
           **syscall_any.return**
                  Record exit from a syscall
    
                   See probe::syscall_any.return(3stap)
                   for details.
    


* * *
# putwchar

## NAME



           putwchar - write a wide character to standard output
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wint_t putwchar(wchar_t** _wc_**);**
    


## DESCRIPTION



           The **putwchar**() function is the wide-character equivalent of the
           putchar(3) function.  It writes the wide character _wc_ to _stdout_.
           If _ferror(stdout)_ becomes true, it returns **WEOF**.  If a wide
           character conversion error occurs, it sets _errno_ to **EILSEQ** and
           returns **WEOF**.  Otherwise, it returns _wc_.
    
           For a nonlocking counterpart, see unlocked_stdio(3).
    


## RETURN VALUE



           The **putwchar**() function returns _wc_ if no error occurred, or **WEOF**
           to indicate an error.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **putwchar**() depends on the **LC_CTYPE** category of the
           current locale.
    
           It is reasonable to expect that **putwchar**() will actually write the
           multibyte sequence corresponding to the wide character _wc_.
    


* * *
# gnutls_x509_crt_get_dn2

## NAME



           gnutls_x509_crt_get_dn2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_dn2(gnutls_x509_crt_t** _cert_**, gnutls_datum_t**
           *****_dn_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of the
           Certificate.  The name will be in the form "C=xxxx,O=yyyy,CN=zzzz"
           as described in RFC4514. The output string will be ASCII or UTF-8
           encoded, depending on the certificate data.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_x509_crt_get_dn3()**.
    


## RETURNS



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


## SINCE



           3.1.10
    


* * *
# io_uring_free_buf_ring

## NAME



           io_uring_free_buf_ring - register and free a buffer ring for
           provided buffers
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_free_buf_ring(struct io_uring ***_ring_**,**
                                      **struct io_uring_buf_ring ***_br_**,**
                                      **unsigned int** _nentries_**,**
                                      **int** _bgid_**);**
    


## DESCRIPTION



           The io_uring_free_buf_ring(3) function unregisters a previously
           registered shared buffer ring. The ring must have heen previously
           returned from io_uring_setup_buf_ring(3).
    
           The _ring_ argument must pointer to the ring for which the provided
           buffer ring is being registered, _br_ must point to a buffer ring
           previously returned by io_uring_setup_buf_ring(3), _nentries_ is the
           number of entries requested in the buffer ring, and _bgid_ is the
           buffer group ID that _br_ was setup with.
    
           Under the covers, this function uses
           io_uring_unregister_buf_ring(3) to unregister the ring, and
           handles the freeing of the ring rather than letting the
           application open code it.
    
           Available since 5.19.
    


## RETURN VALUE



           On success io_uring_free_buf_ring(3) returns zero. On failure it
           returns **-errno**.
    


* * *
# gnutls_dh_params_import_dsa

## NAME



           gnutls_dh_params_import_dsa - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_import_dsa(gnutls_dh_params_t** _dh_params_**,**
           **gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_dh_params_t dh_params
                       The parameters
    
           gnutls_x509_privkey_t key
                       holds a DSA private key
    


## DESCRIPTION



           This function will import the prime and generator of the DSA key
           for use in the Diffie-Hellman key exchange.
    


## RETURNS



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


* * *
# gnutls_x509_privkey_sign_data

## NAME



           gnutls_x509_privkey_sign_data - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_sign_data(gnutls_x509_privkey_t** _key_**,**
           **gnutls_digest_algorithm_t** _digest_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_data_**, void ***_signature_**, size_t ***_signature_size_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_digest_algorithm_t digest
                       should be a digest algorithm
    
           unsigned int flags
                       should be 0 for now
    
           const gnutls_datum_t * data
                       holds the data to be signed
    
           void * signature
                       will contain the signature
    
           size_t * signature_size
                       holds the size of signature (and will be replaced by
                       the new size)
    


## DESCRIPTION



           This function will sign the given data using a signature algorithm
           supported by the private key. Signature algorithms are always used
           together with a hash functions.  Different hash functions may be
           used for the RSA algorithm, but only SHA-1 for the DSA keys.
    
           If the buffer provided is not long enough to hold the output, then
           * _signature_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** will
           be returned.
    
           Use **gnutls_x509_crt_get_preferred_hash_algorithm()** to determine
           the hash algorithm.
    


## RETURNS



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


* * *
# pam_strerror

## NAME



           pam_strerror - return string describing PAM error code
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_strerror** function returns a pointer to a string describing
           the error code passed in the argument _errnum_ , possibly using the
           LC_MESSAGES part of the current locale to select the appropriate
           language. This string must not be modified by the application. No
           library function will modify this string.
    


## RETURN VALUES



           This function returns always a pointer to a string.
    


* * *
# gnutls_certificate_get_peers_subkey_id

## NAME



           gnutls_certificate_get_peers_subkey_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_certificate_get_peers_subkey_id(gnutls_session_t**
           _session_**, gnutls_datum_t ***_id_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           gnutls_datum_t * id
                       will contain the ID
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.1.3
    


* * *
# gnutls_x509_dn_set_str

## NAME



           gnutls_x509_dn_set_str - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_set_str(gnutls_x509_dn_t** _dn_**, const char ***_str_**,**
           **const char ****_err_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       a pointer to DN
    
           const char * str
                       a comma separated DN string (RFC4514)
    
           const char ** err
                       indicates the error position (if any)
    


## DESCRIPTION



           This function will set the DN on the provided DN structure.  The
           input string should be plain ASCII or UTF-8 encoded. On DN parsing
           error **GNUTLS_E_PARSING_ERROR** is returned.
    


## RETURNS



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


## SINCE



           3.5.3
    


* * *
# gnutls_global_set_mem_functions

## NAME



           gnutls_global_set_mem_functions - API function
    


## SYNOPSIS



           **#include <gnutls/compat.h>**
    
           **void gnutls_global_set_mem_functions(gnutls_alloc_function**
           _alloc_func_**, gnutls_alloc_function** _secure_alloc_func_**,**
           **gnutls_is_secure_function** _is_secure_func_**, gnutls_realloc_function**
           _realloc_func_**, gnutls_free_function** _free_func_**);**
    


## ARGUMENTS



           gnutls_alloc_function alloc_func
                       it's the default memory allocation function. Like
                       **malloc()**.
    
           gnutls_alloc_function secure_alloc_func
                       This is the memory allocation function that will be
                       used for sensitive data.
    
           gnutls_is_secure_function is_secure_func
                       a function that returns 0 if the memory given is not
                       secure. May be NULL.
    
           gnutls_realloc_function realloc_func
                       A realloc function
    
           gnutls_free_function free_func
                       The function that frees allocated data. Must accept a
                       NULL pointer.
    


## DEPRECATED



           since 3.3.0 it is no longer possible to replace the internally
           used memory allocation functions
    
           This is the function where you set the memory allocation functions
           gnutls is going to use. By default the libc's allocation functions
           (**malloc()** , **free()**), are used by gnutls, to allocate both sensitive
           and not sensitive data.  This function is provided to set the
           memory allocation functions to something other than the defaults
    
           This function must be called before **gnutls_global_init()** is
           called.  This function is not thread safe.
    


* * *
# libpfm_arm_ac9

## NAME



           libpfm_arm_ac9 - support for ARM Cortex A9 PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_ac9**
           **PMU desc: ARM Cortex A9**
    


## DESCRIPTION



           The library supports the ARM Cortex A9 core PMU.
    
           This PMU supports 2 counters and has no privilege levels
           filtering.  No event modifiers are available.
    


* * *
# gnutls_pubkey_export_dsa_raw2

## NAME



           gnutls_pubkey_export_dsa_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_dsa_raw2(gnutls_pubkey_t** _key_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_datum_t * p
                       will hold the p (may be **NULL**)
    
           gnutls_datum_t * q
                       will hold the q (may be **NULL**)
    
           gnutls_datum_t * g
                       will hold the g (may be **NULL**)
    
           gnutls_datum_t * y
                       will hold the y (may be **NULL**)
    
           unsigned flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the DSA public key's parameters found in
           the given certificate.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# efadv_query_mr

## NAME



           efadv_query_mr - Query EFA specific Memory Region attributes
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  int efadv_query_mr(struct ibv_mr *ibvmr, struct efadv_mr_attr *attr, uint32_t inlen);
    


## DESCRIPTION



           **efadv_query_mr()** queries device-specific Memory Region attributes.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_mr_attr {
                      uint64_t comp_mask;
                      uint16_t ic_id_validity;
                      uint16_t recv_ic_id;
                      uint16_t rdma_read_ic_id;
                      uint16_t rdma_recv_ic_id;
                  };
    
           _inlen_  In: Size of struct efadv_mr_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _ic_id_validity_
                  Validity mask of interconnect id fields:
    
                  EFADV_MR_ATTR_VALIDITY_RECV_IC_ID: recv_ic_id has a valid
                  value.
    
                  EFADV_MR_ATTR_VALIDITY_RDMA_READ_IC_ID: rdma_read_ic_id has
                  a valid value.
    
                  EFADV_MR_ATTR_VALIDITY_RDMA_RECV_IC_ID: rdma_recv_ic_id has
                  a valid value.
    
           _recv_ic_id_
                  Physical interconnect used by the device to reach the MR
                  for receive operation.
    
           _rdma_read_ic_id_
                  Physical interconnect used by the device to reach the MR
                  for RDMA read operation.
    
           _rdma_recv_ic_id_
                  Physical interconnect used by the device to reach the MR
                  for RDMA write receive.
    


## RETURN VALUE



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


## NOTES



           • Compatibility mask (comp_mask) is an out field and currently has
             no values.
    


* * *
# sem_wait

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



           sem_wait — lock a semaphore
    


## SYNOPSIS



           #include <semaphore.h>
    
           int sem_wait(sem_t *_sem_);
    


## DESCRIPTION



           Refer to sem_trywait(3p).
    


* * *
# gnutls_ecc_curve_get_id

## NAME



           gnutls_ecc_curve_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_ecc_curve_t gnutls_ecc_curve_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a curve name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           return a **gnutls_ecc_curve_t** value corresponding to the specified
           curve, or **GNUTLS_ECC_CURVE_INVALID** on error.
    


## SINCE



           3.4.3
    


* * *
# gnutls_x509_ext_export_key_usage

## NAME



           gnutls_x509_ext_export_key_usage - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_key_usage(unsigned int** _usage_**,**
           **gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           unsigned int usage
                       an ORed sequence of the GNUTLS_KEY_* elements.
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the keyUsage bit string to a DER
           encoded PKIX extension. The  _ext_ data will be allocated using
           **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# if_nametoindex

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



           if_nametoindex — map a network interface name to its corresponding
           index
    


## SYNOPSIS



           #include <net/if.h>
    
           unsigned if_nametoindex(const char *_ifname_);
    


## DESCRIPTION



           The _if_nametoindex_() function shall return the interface index
           corresponding to name _ifname_.
    


## RETURN VALUE



           The corresponding index if _ifname_ is the name of an interface;
           otherwise, zero.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pcre2_get_startchar

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **PCRE2_SIZE pcre2_get_startchar(pcre2_match_data ***_match_data_**);**
    


## DESCRIPTION



    
           After a successful call of **pcre2_match()** that was passed the match
           block that is this function's argument, this function returns the
           code unit offset of the character at which the successful match
           started. For a non-partial match, this can be different to the
           value of _ovector[0]_ if the pattern contains the \K escape
           sequence. After a partial match, however, this value is always the
           same as _ovector[0]_ because \K does not affect the result of a
           partial match.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# function::pn

## NAME



           function::pn - Returns the active probe name
    


## SYNOPSIS



               pn:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the script-level probe point associated with
           a currently running probe handler, including wild-card expansion
           effects. Context: The current probe point.
    


* * *
# probe::kprocess.start

## NAME



           probe::kprocess.start - Starting new process
    


## SYNOPSIS



           kprocess.start
    


## VALUES



           None
    


## CONTEXT



           Newly created process.
    


## DESCRIPTION



           Fires immediately before a new process begins execution.
    


* * *
# mlx5dv_dump_dr_table

## NAME



           mlx5dv_dump_dr_domain - Dump DR Domain
    
           mlx5dv_dump_dr_table - Dump DR Table
    
           mlx5dv_dump_dr_matcher - Dump DR Matcher
    
           mlx5dv_dump_dr_rule - Dump DR Rule
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_dump_dr_domain(FILE *fout, struct mlx5dv_dr_domain *domain);
                  int mlx5dv_dump_dr_table(FILE *fout, struct mlx5dv_dr_table *table);
                  int mlx5dv_dump_dr_matcher(FILE *fout, struct mlx5dv_dr_matcher *matcher);
                  int mlx5dv_dump_dr_rule(FILE *fout, struct mlx5dv_dr_rule *rule);
    


## DESCRIPTION



           The Dump API (mlx5dv_dump_*) allows the dumping of the existing
           rdma-core resources to the provided file.  The output file format
           is vendor specific.
    
           _mlx5dv_dump_dr_domain()_ dumps a DR Domain object properties to a
           specified file.
    
           _mlx5dv_dump_dr_table()_ dumps a DR Table object properties to a
           specified file.
    
           _mlx5dv_dump_dr_matcher()_ dumps a DR Matcher object properties to a
           specified file.
    
           _mlx5dv_dump_dr_rule()_ dumps a DR Rule object properties to a
           specified file.
    


## RETURN VALUE



           The API calls returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).  The calls are
           blocking - function returns only when all related resources info
           is written to the file.
    


* * *
# capng_save_state

## NAME



           capng_save_state - get the internal library state
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           void *capng_save_state(void);
    


## DESCRIPTION



           capng_save_state is a function that returns a pointer to the
           internal state of the libcap-ng library. It should be considered
           opaque and not for alteration directly. This function should be
           used when you suspect a third party library may use libcap-ng also
           and want to make sure it doesn't alter something important. This
           function is not available in the python bindings.
    


## RETURN VALUE



           This returns NULL on failure and a non-NULL pointer otherwise.
    


## NOTES



           The structure returned by capng_save_state is malloc'd;  it should
           be free'd if not used.
    


* * *
# gnutls_alert_get_name

## NAME



           gnutls_alert_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_alert_get_name(gnutls_alert_description_t**
           _alert_**);**
    


## ARGUMENTS



           gnutls_alert_description_t alert
                       is an alert number.
    


## DESCRIPTION



           This function will return a string that describes the given alert
           number, or **NULL**.  See **gnutls_alert_get()**.
    


## RETURNS



           string corresponding to **gnutls_alert_description_t** value.
    


* * *
# gnutls_certificate_set_ocsp_status_request_function

## NAME



           gnutls_certificate_set_ocsp_status_request_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_ocsp_status_request_function(gnutls_certificate_credentials_t**
           _sc_**, gnutls_status_request_ocsp_func** _ocsp_func_**, void ***_ptr_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_status_request_ocsp_func ocsp_func
                       function pointer to OCSP status request callback.
    
           void * ptr  opaque pointer passed to callback function
    


## DESCRIPTION



           This function is to be used by server to register a callback to
           handle OCSP status requests from the client.  The callback will be
           invoked if the client supplied a status-request OCSP extension.
           The callback function prototype is:
    
           typedef int (*gnutls_status_request_ocsp_func) (gnutls_session_t
           session, void *ptr, gnutls_datum_t *ocsp_response);
    
           The callback will be invoked if the client requests an OCSP
           certificate status.  The callback may return
           **GNUTLS_E_NO_CERTIFICATE_STATUS** , if there is no recent OCSP
           response. If the callback returns **GNUTLS_E_SUCCESS** , it is expected
           to have the  _ocsp_response_ field set with a valid (DER-encoded)
           OCSP response. The response must be a value allocated using
           **gnutls_malloc()** , and will be deinitialized by the caller.
    
           It is possible to set a specific callback for each provided
           certificate using
           **gnutls_certificate_set_ocsp_status_request_function2()**.
    


## SINCE



           3.1.3
    


* * *
# gnutls_x509_crq_get_dn_by_oid

## NAME



           gnutls_x509_crq_get_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_dn_by_oid(gnutls_x509_crq_t** _crq_**, const**
           **char ***_oid_**, unsigned** _indx_**, unsigned int** _raw_flag_**, void ***_buf_**,**
           **size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a gnutls_x509_crq_t type
    
           const char * oid
                       holds an Object Identifier in a null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the RDN, this
                       specifies which to get. Use (0) to get the first one.
    
           unsigned int raw_flag
                       If non-zero returns the raw DER data of the DN part.
    
           void * buf  a pointer to a structure to hold the name (may be
                       **NULL**)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will extract the part of the name of the Certificate
           request subject, specified by the given OID. The output will be
           encoded as described in RFC2253. The output string will be ASCII
           or UTF-8 encoded, depending on the certificate data.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           If raw flag is (0), this function will only return known OIDs as
           text. Other OIDs will be DER encoded, as described in RFC2253 --
           in hex format with a 'using **gnutls_x509_dn_oid_known()**.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the * _buf_size_ will be updated with the
           required size.  On success 0 is returned.
    


* * *
# pthread_setschedparam

## 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_setschedparam — dynamic thread scheduling parameters
           access (**REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_setschedparam(pthread_t _thread_ , int _policy_ ,
               const struct sched_param *_param_);
    


## DESCRIPTION



           Refer to pthread_getschedparam(3p).
    


* * *
# gnutls_ocsp_resp_get_signature

## NAME



           gnutls_ocsp_resp_get_signature - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_signature(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_datum_t ***_sig_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           gnutls_datum_t * sig
                       newly allocated output buffer with signature data
    


## DESCRIPTION



           This function will extract the signature field of a OCSP response.
    


## RETURNS



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


* * *
# gnutls_certificate_set_x509_trust_mem

## NAME



           gnutls_certificate_set_x509_trust_mem - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_trust_mem(gnutls_certificate_credentials_t**
           _res_**, const gnutls_datum_t ***_ca_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const gnutls_datum_t * ca
                       is a list of trusted CAs or a DER certificate
    
           gnutls_x509_crt_fmt_t type
                       is DER or PEM
    


## DESCRIPTION



           This function adds the trusted CAs in order to verify client or
           server certificates. In case of a client this is not required to
           be called if the certificates are not verified using
           **gnutls_certificate_verify_peers2()**.  This function may be called
           multiple times.
    
           In case of a server the CAs set here will be sent to the client if
           a certificate request is sent. This can be disabled using
           **gnutls_certificate_send_x509_rdn_sequence()**.
    


## RETURNS



           the number of certificates processed or a negative error code on
           error.
    


* * *
# function::tz_ctime

## NAME



           function::tz_ctime - Convert seconds since epoch into human
           readable date/time string, with local time zone
    


## SYNOPSIS



               tz_ctime(epochsecs:)
    


## ARGUMENTS



           _epochsecs_
               number of seconds since epoch (as returned by **gettimeofday_s**)
    


## DESCRIPTION



           Takes an argument of seconds since the epoch as returned by
           **gettimeofday_s**. Returns a string of the same form as **ctime** , but
           offsets the epoch time for the local time zone, and appends the
           name of the local time zone. The string length may vary. The time
           zone information is passed by staprun at script startup only.
    


* * *
# gnutls_privkey_sign_data

## NAME



           gnutls_privkey_sign_data - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_sign_data(gnutls_privkey_t** _signer_**,**
           **gnutls_digest_algorithm_t** _hash_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_data_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_privkey_t signer
                       Holds the key
    
           gnutls_digest_algorithm_t hash
                       should be a digest algorithm
    
           unsigned int flags
                       Zero or one of **gnutls_privkey_flags_t**
    
           const gnutls_datum_t * data
                       holds the data to be signed
    
           gnutls_datum_t * signature
                       will contain the signature allocated with
                       **gnutls_malloc()**
    


## DESCRIPTION



           This function will sign the given data using a signature algorithm
           supported by the private key. Signature algorithms are always used
           together with a hash functions.  Different hash functions may be
           used for the RSA algorithm, but only the SHA family for the DSA
           keys.
    
           You may use **gnutls_pubkey_get_preferred_hash_algorithm()** to
           determine the hash algorithm.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::sunrpc.clnt.call_sync

## NAME



           probe::sunrpc.clnt.call_sync - Make a synchronous RPC call
    


## SYNOPSIS



           sunrpc.clnt.call_sync
    


## VALUES



           _flags_
               flags
    
           _procname_
               the procedure name in this RPC call
    
           _servername_
               the server machine name
    
           _xid_
               current transmission id
    
           _dead_
               whether this client is abandoned
    
           _progname_
               the RPC program name
    
           _prog_
               the RPC program number
    
           _proc_
               the procedure number in this RPC call
    
           _prot_
               the IP protocol number
    
           _port_
               the port number
    
           _vers_
               the RPC program version number
    


* * *