tripathysagar/man_text huggingface dataset:
# probe::netfilter.ip.local_in

## NAME



           probe::netfilter.ip.local_in - Called on an incoming IP packet
           addressed to the local computer
    


## SYNOPSIS



           netfilter.ip.local_in
    


## VALUES



           _indev_name_
               Name of network device packet was received on (if known)
    
           _sport_
               TCP or UDP source port (ipv4 only)
    
           _pf_
               Protocol family -- either “ipv4” or “ipv6”
    
           _iphdr_
               Address of IP header
    
           _dport_
               TCP or UDP destination port (ipv4 only)
    
           _saddr_
               A string representing the source IP address
    
           _fin_
               TCP FIN flag (if protocol is TCP; ipv4 only)
    
           _syn_
               TCP SYN flag (if protocol is TCP; ipv4 only)
    
           _daddr_
               A string representing the destination IP address
    
           _rst_
               TCP RST flag (if protocol is TCP; ipv4 only)
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _urg_
               TCP URG flag (if protocol is TCP; ipv4 only)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _ipproto_tcp_
               Constant used to signify that the packet protocol is TCP
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _protocol_
               Packet protocol from driver (ipv4 only)
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _ack_
               TCP ACK flag (if protocol is TCP; ipv4 only)
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _psh_
               TCP PSH flag (if protocol is TCP; ipv4 only)
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _ipproto_udp_
               Constant used to signify that the packet protocol is UDP
    
           _family_
               IP address family
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    


* * *
# gnutls_pkcs7_import

## NAME



           gnutls_pkcs7_import - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_import(gnutls_pkcs7_t** _pkcs7_**, const gnutls_datum_t**
           *****_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The data to store the parsed PKCS7.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded PKCS7.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded PKCS7 to
           the native **gnutls_pkcs7_t** format.  The output will be stored in
            _pkcs7_ . Any signed data that may be present inside the  _pkcs7_
           structure, like certificates set by **gnutls_pkcs7_set_crt()** , will
           be freed and overwritten by this function.
    
           If the PKCS7 is PEM encoded it should have a header of "PKCS7".
    


## RETURNS



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


* * *
# aio_error

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



           aio_error — retrieve errors status for an asynchronous I/O
           operation
    


## SYNOPSIS



           #include <aio.h>
    
           int aio_error(const struct aiocb *_aiocbp_);
    


## DESCRIPTION



           The _aio_error_() function shall return the error status associated
           with the **aiocb** structure referenced by the _aiocbp_ argument. The
           error status for an asynchronous I/O operation is the _errno_ value
           that would be set by the corresponding _read_(), _write_(),
           _fdatasync_(), or _fsync_() operation. If the operation has not yet
           completed, then the error status shall be equal to **[EINPROGRESS]**.
    
           If the **aiocb** structure pointed to by _aiocbp_ is not associated with
           an operation that has been scheduled, the results are undefined.
    


## RETURN VALUE



           If the asynchronous I/O operation has completed successfully, then
           0 shall be returned. If the asynchronous operation has completed
           unsuccessfully, then the error status, as described for _read_(),
           _write_(), _fdatasync_(), and _fsync_(), shall be returned. If the
           asynchronous I/O operation has not yet completed, then
           **[EINPROGRESS]** shall be returned.
    
           If the _aio_error_() function fails, it shall return -1 and set
           _errno_ to indicate the error.
    


## ERRORS



           The _aio_error_() function may fail if:
    
           **EINVAL** The _aiocbp_ argument does not refer to an asynchronous
                  operation whose return status has not yet been retrieved.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::set_user_char

## NAME



           function::set_user_char - Writes a char value to user memory
    


## SYNOPSIS



               set_user_char(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The user address to write the char to
    
           _val_
               The char which is to be written
    


## DESCRIPTION



           Writes the char value to a given user memory address. Reports an
           error when writing to the given address fails. Requires the use of
           guru mode (-g).
    


* * *
# io_uring_prep_poll_add

## NAME



           io_uring_prep_poll_add - prepare a poll request
    


## SYNOPSIS



           **#include <poll.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_poll_add(struct io_uring_sqe ***_sqe_**,**
                                       **int** _fd_**,**
                                       **unsigned** _poll_mask_**);**
    
           **void io_uring_prep_poll_multishot(struct io_uring_sqe ***_sqe_**,**
                                             **int** _fd_**,**
                                             **unsigned** _poll_mask_**);**
    


## DESCRIPTION



           The io_uring_prep_poll_add(3) function prepares a poll request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _fd_ that should get polled, with the events desired specified in
           the _poll_mask_ argument.
    
           The default behavior is a single-shot poll request. When the
           specified event has triggered, a completion CQE is posted and no
           more events will be generated by the poll request.
           io_uring_prep_poll_multishot(3) behaves identically in terms of
           events, but it persists across notifications and will repeatedly
           post notifications for the same registration. A CQE posted from a
           multishot poll request will have **IORING_CQE_F_MORE** set in the CQE
           _flags_ member, indicating that the application should expect more
           completions from this request. If the multishot poll request gets
           terminated or experiences an error, this flag will not be set in
           the CQE. If this happens, the application should not expect
           further CQEs from the original request and must reissue a new one
           if it still wishes to get notifications on this file descriptor.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation, which
           is a bitmask of the events notified. See the poll(2) man page for
           details. Note that where synchronous system calls will return **-1**
           on failure and set _errno_ to the actual error value, io_uring never
           uses _errno_.  Instead it returns the negated _errno_ directly in the
           CQE _res_ field.
    


* * *
# function::MKDEV

## NAME



           function::MKDEV - Creates a value that can be compared to a kernel
           device number (kdev_t)
    


## SYNOPSIS



               MKDEV:long(major:long,minor:long)
    


## ARGUMENTS



           _major_
               Intended major device number.
    
           _minor_
               Intended minor device number.
    


* * *
# posix_spawnattr_setsigdefault

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           posix_spawnattr_setsigdefault — set the spawn-sigdefault attribute
           of a spawn attributes object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <signal.h>
           #include <spawn.h>
    
           int posix_spawnattr_setsigdefault(posix_spawnattr_t *restrict _attr_ ,
               const sigset_t *restrict _sigdefault_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getsigdefault(3p).
    


* * *
# strlen

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



           strlen, strnlen — get length of fixed size string
    


## SYNOPSIS



           #include <string.h>
    
           size_t strlen(const char *_s_);
           size_t strnlen(const char *_s_ , size_t _maxlen_);
    


## DESCRIPTION



           For _strlen_(): 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 _strlen_() function shall compute the number of bytes in the
           string to which _s_ points, not including the terminating NUL
           character.
    
           The _strnlen_() function shall compute the smaller of the number of
           bytes in the array to which _s_ points, not including any
           terminating NUL character, or the value of the _maxlen_ argument.
           The _strnlen_() function shall never examine more than _maxlen_ bytes
           of the array pointed to by _s_.
    


## RETURN VALUE



           The _strlen_() function shall return the length of _s_ ; no return
           value shall be reserved to indicate an error.
    
           The _strnlen_() function shall return the number of bytes preceding
           the first null byte in the array to which _s_ points, if _s_ contains
           a null byte within the first _maxlen_ bytes; otherwise, it shall
           return _maxlen_.
    


## ERRORS



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


## EXAMPLES



       **Getting String Lengths**
           The following example sets the maximum length of _key_ and _data_ by
           using _strlen_() to get the lengths of those strings.
    
               #include <string.h>
               ...
               struct element {
                   char *key;
                   char *data;
               };
               ...
               char *key, *data;
               int len;
    
               *keylength = *datalength = 0;
               ...
               if ((len = strlen(key)) > *keylength)
                   *keylength = len;
               if ((len = strlen(data)) > *datalength)
                   *datalength = len;
               ...
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::proc_mem_rss

## NAME



           function::proc_mem_rss - Program resident set size in pages
    


## SYNOPSIS



           1) proc_mem_rss:long()
    
           2) proc_mem_rss:long(pid:long)
    


## ARGUMENTS



           _pid_
               The pid of process to examine
    


## DESCRIPTION



           1) Returns the resident set size in pages of the current process,
           or zero when there is no current process or the number of pages
           couldn't be retrieved.
    
           2) Returns the resident set size in pages of the given process, or
           zero when the process doesn't exist or the number of pages
           couldn't be retrieved.
    


* * *
# gnutls_srp_base64_decode2

## NAME



           gnutls_srp_base64_decode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_srp_base64_decode2(const gnutls_datum_t ***_b64_data_**,**
           **gnutls_datum_t ***_result_**);**
    


## ARGUMENTS



           const gnutls_datum_t * b64_data
                       contains the encoded data
    
           gnutls_datum_t * result
                       the place where decoded data lie
    


## DESCRIPTION



           This function will decode the given encoded data. The decoded data
           will be allocated, and stored into result.  It will decode using
           the base64 algorithm as used in libsrp.
    
           You should use **gnutls_free()** to free the returned data.
    
           Warning!  This base64 encoding is not the "standard" encoding, so
           do not use it for non-SRP purposes.
    


## RETURNS



           0 on success, or an error code.
    


* * *
# gnutls_srtp_get_mki

## NAME



           gnutls_srtp_get_mki - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * mki
                       will hold the MKI
    


## DESCRIPTION



           This function exports the negotiated Master Key Identifier,
           received by the peer if any. The returned value in  _mki_ should be
           treated as constant and valid only during the session's lifetime.
    


## RETURNS



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


* * *
# function::env_var

## NAME



           function::env_var - Fetch environment variable from current
           process
    


## SYNOPSIS



               env_var:string(name:string)
    


## ARGUMENTS



           _name_
               Name of the environment variable to fetch
    


## DESCRIPTION



           Returns the contents of the specified environment value for the
           current process. If the variable isn't set an empty string is
           returned.
    


* * *
# gnutls_x509_privkey_export_gost_raw

## NAME



           gnutls_x509_privkey_export_gost_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export_gost_raw(gnutls_x509_privkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_digest_algorithm_t ***_digest_**,**
           **gnutls_gost_paramset_t ***_paramset_**, gnutls_datum_t ***_x_**,**
           **gnutls_datum_t ***_y_**, gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_digest_algorithm_t * digest
                       will hold the digest
    
           gnutls_gost_paramset_t * paramset
                       will hold the GOST parameter set ID
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    
           gnutls_datum_t * k
                       will hold the private key
    


## DESCRIPTION



           This function will export the GOST 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.
    


## NOTE



           parameters will be stored with least significant byte first. On
           version 3.6.3 this was incorrectly returned in big-endian format.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# gnutls_bye

## NAME



           gnutls_bye - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_bye(gnutls_session_t** _session_**, gnutls_close_request_t**
           _how_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_close_request_t how
                       is an integer
    


## DESCRIPTION



           Terminates the current TLS/SSL connection. The connection should
           have been initiated using **gnutls_handshake()**.   _how_ should be one
           of **GNUTLS_SHUT_RDWR** , **GNUTLS_SHUT_WR**.
    
           In case of **GNUTLS_SHUT_RDWR** the TLS session gets terminated and
           further receives and sends will be disallowed.  If the return
           value is zero you may continue using the underlying transport
           layer. **GNUTLS_SHUT_RDWR** sends an alert containing a close request
           and waits for the peer to reply with the same message.
    
           In case of **GNUTLS_SHUT_WR** the TLS session gets terminated and
           further sends will be disallowed. In order to reuse the connection
           you should wait for an EOF from the peer.  **GNUTLS_SHUT_WR** sends an
           alert containing a close request.
    
           Note that not all implementations will properly terminate a TLS
           connection.  Some of them, usually for performance reasons, will
           terminate only the underlying transport layer, and thus not
           distinguishing between a malicious party prematurely terminating
           the connection and normal termination.
    
           This function may also return **GNUTLS_E_AGAIN** or
           **GNUTLS_E_INTERRUPTED** ; cf.  **gnutls_record_get_direction()**.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code, see function
           documentation for entire semantics.
    


* * *
# gnutls_certificate_get_ocsp_expiration

## NAME



           gnutls_certificate_get_ocsp_expiration - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **time_t**
           **gnutls_certificate_get_ocsp_expiration(gnutls_certificate_credentials_t**
           _sc_**, unsigned** _idx_**, int** _oidx_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a credentials structure.
    
           unsigned idx
                       is a certificate chain index as returned by
                       **gnutls_certificate_set_key()** and friends
    
           int oidx    is an OCSP response index
    
           unsigned flags
                       should be zero
    


## DESCRIPTION



           This function returns the validity of the loaded OCSP responses,
           to provide information on when to reload/refresh them.
    
           Note that the credentials structure should be read-only when in
           use, thus when reloading, either the credentials structure must
           not be in use by any sessions, or a new credentials structure
           should be allocated for new sessions.
    
           When  _oidx_ is (-1) then the minimum refresh time for all responses
           is returned. Otherwise the index specifies the response
           corresponding to the  _odix_ certificate in the certificate chain.
    


## RETURNS



           On success, the expiration time of the OCSP response. Otherwise
           (time_t)(-1) on error, or (time_t)-2 on out of bounds.
    


## SINCE



           3.6.3
    


* * *
# probe::stap.pass6.end

## NAME



           probe::stap.pass6.end - Finished stap pass6 (cleanup)
    


## SYNOPSIS



           stap.pass6.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass6.end fires just before main's return.
    


* * *
# gnutls_hash_output

## NAME



           gnutls_hash_output - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_hash_output(gnutls_hash_hd_t** _handle_**, void ***_digest_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t handle
                       is a **gnutls_hash_hd_t** type
    
           void * digest
                       is the output value of the hash
    


## DESCRIPTION



           This function will output the current hash value and reset the
           state of the hash. If  _digest_ is **NULL** , it only resets the state of
           the hash.
    


## SINCE



           2.10.0
    


* * *
# gnutls_transport_set_pull_timeout_function

## NAME



           gnutls_transport_set_pull_timeout_function - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_pull_timeout_func func
                       a callback function
    


## DESCRIPTION



           This is the function where you set a function for gnutls to know
           whether data are ready to be received. It should wait for data a
           given time frame in milliseconds. The callback should return 0 on
           timeout, a positive number if data can be received, and -1 on
           error.  You'll need to override this function if **select()** is not
           suitable for the provided transport calls.
    
           As with **select()** , if the timeout value is zero the callback should
           return zero if no data are immediately available. The special
           value **GNUTLS_INDEFINITE_TIMEOUT** indicates that the callback should
           wait indefinitely for data.
    
            _gnutls_pull_timeout_func_ is of the form, int
           (*gnutls_pull_timeout_func)(gnutls_transport_ptr_t, unsigned int
           ms);
    
           This callback is necessary when **gnutls_handshake_set_timeout()** or
           **gnutls_record_set_timeout()** are set, under TLS1.3 and for
           enforcing the DTLS mode timeouts when in blocking mode.
    
           For compatibility with future GnuTLS versions this callback must
           be set when a custom pull function is registered. The callback
           will not be used when the session is in TLS mode with non-blocking
           sockets. That is, when **GNUTLS_NONBLOCK** is specified for a TLS
           session in **gnutls_init()**.
    
           The helper function **gnutls_system_recv_timeout()** is provided to
           simplify writing callbacks.
    


## SINCE



           3.0
    


* * *
# manadv_set_context_attr

## NAME



           manadv_set_context_attr - Set context attributes
    


## SYNOPSIS



                  #include <infiniband/manadv.h>
    
                  int manadv_set_context_attr(struct ibv_context *context,
                                              enum manadv_set_ctx_attr_type attr_type,
                                              void *attr);
    


## DESCRIPTION



           manadv_set_context_attr gives the ability to set vendor specific
           attributes on the RDMA context.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _attr_type_
                  The type of the provided attribute.
    
           _attr_   Pointer to the attribute to be set.
    
       **attr_type**
                  enum manadv_set_ctx_attr_type {
                      /* Attribute type uint8_t */
                      MANADV_SET_CTX_ATTR_BUF_ALLOCATORS = 0,
                  };
    
           _MANADV_SET_CTX_ATTR_BUF_ALLOCATORS_
                  Provide an external buffer allocator
    
                  struct manadv_ctx_allocators {
                      void *(*alloc)(size_t size, void *priv_data);
                      void (*free)(void *ptr, void *priv_data);
                      void *data;
                  };
    
           _alloc_  Function used for buffer allocation instead of libmana
                  internal method
    
           _free_   Function used to free buffers allocated by alloc function
    
           _data_   Metadata that can be used by alloc and free functions
    


## RETURN VALUE



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


* * *
# gnutls_prf_early

## NAME



           gnutls_prf_early - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_prf_early(gnutls_session_t** _session_**, size_t** _label_size_**,**
           **const char ***_label_**, size_t** _context_size_**, const char ***_context_**,**
           **size_t** _outsize_**, char ***_out_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t label_size
                       length of the  _label_ variable.
    
           const char * label
                       label used in PRF computation, typically a short
                       string.
    
           size_t context_size
                       length of the  _extra_ variable.
    
           const char * context
                       optional extra data to seed the PRF with.
    
           size_t outsize
                       size of pre-allocated output buffer to hold the
                       output.
    
           char * out  pre-allocated buffer to hold the generated data.
    


## DESCRIPTION



           This function is similar to **gnutls_prf_rfc5705()** , but only works
           in TLS 1.3 or later to export early keying material.
    
           Note that the keying material is only available after the
           ClientHello message is processed and before the application
           traffic keys are established.  Therefore this function shall be
           called in a handshake hook function for
           **GNUTLS_HANDSHAKE_CLIENT_HELLO**.
    
           The  _label_ variable usually contains a string denoting the purpose
           for the generated data.
    
           The  _context_ variable can be used to add more data to the seed,
           after the random variables.  It can be used to make sure the
           generated output is strongly connected to some additional data
           (e.g., a string used in user authentication).
    
           The output is placed in  _out_ , which must be pre-allocated.
    
           Note that, to provide the RFC5705 context, the  _context_ variable
           must be non-null.
    


## RETURNS



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


## SINCE



           3.6.8
    


* * *
# rdma_notify

## NAME



           rdma_notify - Notifies the librdmacm of an asynchronous event.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_notify (struct rdma_cm_id ***_id_**, enum ibv_event_type**
           _event_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           event       Asynchronous event.
    


## DESCRIPTION



           Used to notify the librdmacm of asynchronous events that have
           occurred on a QP associated with the rdma_cm_id.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.  If errno is set to
           EISCONN (transport endpoint is already connected), this indicates
           that the the underlying communication manager established the
           connection before the call to rdma_notify could be processed.  In
           this case, the error may safely be ignored.
    


## NOTES



           Asynchronous events that occur on a QP are reported through the
           user's device event handler.  This routine is used to notify the
           librdmacm of communication events.  In most cases, use of this
           routine is not necessary, however if connection establishment is
           done out of band (such as done through Infiniband), it's possible
           to receive data on a QP that is not yet considered connected.
           This routine forces the connection into an established state in
           this case in order to handle the rare situation where the
           connection never forms on its own.  Calling this routine ensures
           the delivery of the RDMA_CM_EVENT_ESTABLISHED event to the
           application.  Events that should be reported to the CM are:
           IB_EVENT_COMM_EST.
    


* * *
# keyctl_move

## NAME



           keyctl_move - Move a key between keyrings
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_move(key_serial_t** _key_**, key_serial_t** _from_keyring_**,**
                            **key_serial_t** _to_keyring_**, unsigned int** _flags_**);**
    


## DESCRIPTION



           **keyctl_move**() atomically unlinks _key_ from _from_keyring_ and links
           it into _to_keyring_ in a single operation.  Depending on the flags
           set, a link to any matching key in to_keyring may get displaced.
    
           _flags_ is a bitwise-OR of zero or more of the following flags:
    
           **KEYCTL_MOVE_EXCL**
                  If there's a matching key in to_keyring, don't displace it
                  but rather return an error.
    
           The caller must have **write** permission on both keyring to be able
           to create or remove links in them.
    
           The caller must have **link** permission on a key to be able to create
           a new link to it.
    


## RETURN VALUE



           On success **keyctl_move**() return **0**.  On error, the value **-1** will be
           returned and _errno_ will have been set to an appropriate error.
    


## ERRORS



           **ENOKEY** The key or one of the keyrings specified are invalid.
    
           **ENOKEY** A key with the same type and description is present in
                  to_keyring and KEYCTL_MOVE_EXCL is set.
    
           **EKEYEXPIRED**
                  The key or one of the keyrings specified have expired.
    
           **EKEYREVOKED**
                  The key or one of the keyrings specified have been revoked.
    
           **EACCES** The key exists, but is not **linkable** by the calling process.
    
           **EACCES** The keyrings exist, but are not **writable** by the calling
                  process.
    
           **ENOMEM** Insufficient memory to effect the changes.
    
           **EDQUOT** Expanding to_keyring would exceed the keyring owner's
                  quota.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# gnutls_privkey_import_ecc_raw

## NAME



           gnutls_privkey_import_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_ecc_raw(gnutls_privkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**, const gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       The key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    
           const gnutls_datum_t * k
                       holds the k (private key)
    


## DESCRIPTION



           This function will convert the given elliptic curve parameters to
           the native **gnutls_privkey_t** format.  The output will be stored in
           _key_ .
    
           In EdDSA curves the  _y_ parameter should be **NULL** and the  _x_ and  _k_
           parameters must be in the native format for the curve.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# tracef

## NAME



           tracef - LTTng-UST printf(3)-like interface
    


## SYNOPSIS



           **#include <lttng/tracef.h>**
    
           #define **tracef**(_fmt_ , ...)
    
           Link with **-llttng-ust -llttng-ust-common**.
    


## DESCRIPTION



           The **tracef()** macro is part of version 0 of the LTTng-UST API (see
           the “Compatibility with previous APIs” section of lttng-ust(3)).
    
           Prefer using lttng_ust_tracef(3) which is part of version 1 of the
           API and has the **lttng_ust_** namespace.
    


## BUGS



           If you encounter any issue or usability problem, please report it
           on the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-
           ust>.
    


## RESOURCES



           •   LTTng project website <http://lttng.org>
    
           •   LTTng documentation <http://lttng.org/docs>
    
           •   Git repositories <http://git.lttng.org>
    
           •   GitHub organization <http://github.com/lttng>
    
           •   Continuous integration <http://ci.lttng.org/>
    
           •   Mailing list <http://lists.lttng.org> for support and
               development: **lttng-dev@lists.lttng.org**
    
           •   IRC channel <irc://irc.oftc.net/lttng>: **#lttng** on **irc.oftc.net**
    


## THANKS



           Thanks to Ericsson for funding this work, providing real-life use
           cases, and testing.
    
           Special thanks to Michel Dagenais and the DORSAL laboratory
           <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal
           for the LTTng journey.
    


* * *
# getgid

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



           getgid — get the real group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           gid_t getgid(void);
    


## DESCRIPTION



           The _getgid_() function shall return the real group ID of the
           calling process.  The _getgid_() function shall not modify _errno_.
    


## RETURN VALUE



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


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           In a conforming environment, _getgid_() will always succeed. It is
           possible for implementations to provide an extension where a
           process in a non-conforming environment will not be associated
           with a user or group ID.  It is recommended that such
           implementations return (**gid_t**)-1 and set _errno_ to indicate such an
           environment; doing so does not violate this standard, since such
           an environment is already an extension.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acosh

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



           acosh, acoshf, acoshl — inverse hyperbolic cosine functions
    


## SYNOPSIS



           #include <math.h>
    
           double acosh(double _x_);
           float acoshf(float _x_);
           long double acoshl(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 inverse hyperbolic cosine of
           their argument _x_.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           inverse hyperbolic cosine of their argument.
    
           For finite values of _x_ < 1, a domain error shall occur, and either
           a NaN (if supported), or an implementation-defined value shall be
           returned.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is +1, +0 shall be returned.
    
           If _x_ is +Inf, +Inf shall be returned.
    
           If _x_ is -Inf, a domain error shall occur, and a NaN shall be
           returned.
    


## ERRORS



           These functions shall fail if:
    
           Domain Error
                       The _x_ argument is finite and less than +1.0, or is
                       -Inf.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[EDOM]**.  If the integer expression (_math_errhandling_ &
                       MATH_ERREXCEPT) is non-zero, then the invalid
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_ext_import_proxy

## NAME



           gnutls_x509_ext_import_proxy - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_proxy(const gnutls_datum_t ***_ext_**, int ***
           _pathlen_**, char ****_policyLanguage_**, char ****_policy_**, size_t ***
           _sizeof_policy_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       the DER encoded extension data
    
           int * pathlen
                       pointer to output integer indicating path length (may
                       be NULL), non-negative error codes indicate a present
                       pCPathLenConstraint field and the actual value, -1
                       indicate that the field is absent.
    
           char ** policyLanguage
                       output variable with OID of policy language
    
           char ** policy
                       output variable with policy data
    
           size_t * sizeof_policy
                       output variable with size of policy data
    


## DESCRIPTION



           This function will return the information from a proxy certificate
           extension. It reads the ProxyCertInfo X.509 extension
           (1.3.6.1.5.5.7.1.14).  The  _policyLanguage_ and  _policy_ values must
           be deinitialized using **gnutls_free()** after use.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# function::egid

## NAME



           function::egid - Returns the effective gid of a target process
    


## SYNOPSIS



               egid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the effective gid of a target process
    


* * *
# vsscanf

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



           vsscanf — format input of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
    
           int vsscanf(const char *restrict _s_ , const char *restrict _format_ ,
               va_list _arg_);
    


## DESCRIPTION



           Refer to vfscanf(3p).
    


* * *
# waitpid

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



           waitpid — wait for a child process to stop or terminate
    


## SYNOPSIS



           #include <sys/wait.h>
    
           pid_t waitpid(pid_t _pid_ , int *_stat_loc_ , int _options_);
    


## DESCRIPTION



           Refer to wait(3p).
    


* * *
# gnutls_x509_crt_get_preferred_hash_algorithm

## NAME



           gnutls_x509_crt_get_preferred_hash_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/compat.h>**
    
           **int gnutls_x509_crt_get_preferred_hash_algorithm(gnutls_x509_crt_t**
           _crt_**, gnutls_digest_algorithm_t ***_hash_**, unsigned int ***_mand_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       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).
    


## DEPRECATED



           Please use **gnutls_pubkey_get_preferred_hash_algorithm()**.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# io_uring_recvmsg_name

## NAME



           io_uring_recvmsg_out - access data from multishot recvmsg
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **struct io_uring_recvmsg_out *io_uring_recvmsg_validate(void ***_buf_**,**
                                                                  **int** _buf_len_**,**
                                                                  **struct msghdr ***_msgh_**);**
    
           **void *io_uring_recvmsg_name(struct io_uring_recvmsg_out ***_o_**);**
    
           **struct cmsghdr *io_uring_recvmsg_cmsg_firsthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                          **struct msghdr ***_msgh_**);**
           **struct cmsghdr *io_uring_recvmsg_cmsg_nexthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                         **struct msghdr ***_msgh_**,**
                                                         **struct cmsghdr ***_cmsg_**);**
    
           **void *io_uring_recvmsg_payload(struct io_uring_recvmsg_out ***_o_**,**
                                          **struct msghdr ***_msgh_**);**
           **unsigned int io_uring_recvmsg_payload_length(struct io_uring_recvmsg_out ***_o_**,**
                                                        **int** _buf_len_**,**
                                                        **struct msghdr ***_msgh_**);**
    


## DESCRIPTION



           These functions are used to access data in the payload delivered
           by io_uring_prep_recvmsg_multishot(3).
    
           _msgh_ should point to the _struct msghdr_ submitted with the request.
    
           io_uring_recvmsg_validate(3) will validate a buffer delivered by
           io_uring_prep_recvmsg_multishot(3) and extract the
           _io_uring_recvmsg_out_ if it is valid, returning a pointer to it or
           else NULL.
    
           The structure is defined as follows:
    
               struct io_uring_recvmsg_out {
                       __u32 namelen;    /* Name byte count as would have been populated
                                          * by recvmsg(2) */
                       __u32 controllen; /* Control byte count */
                       __u32 payloadlen; /* Payload byte count as would have been returned
                                          * by recvmsg(2) */
                       __u32 flags;      /* Flags result as would have been populated
                                          * by recvmsg(2) */
               };
    
           *  io_uring_recvmsg_name(3)
              returns a pointer to the name in the buffer.
    
           *  io_uring_recvmsg_cmsg_firsthdr(3)
              returns a pointer to the first cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_cmsg_nexthdr(3)
              returns a pointer to the next cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_payload(3)
              returns a pointer to the payload in the buffer.
    
           *  io_uring_recvmsg_payload_length(3)
              Calculates the usable payload length in bytes.
    


* * *