tripathysagar/man_text huggingface dataset:
# umad_set_addr

## NAME



           umad_set_addr - set MAD address fields within umad buffer using
           host ordering
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_set_addr(void** _*umad_**, int** _dlid_**, int** _dqp_**, int** _sl_**, int** _qkey_**);**
    


## DESCRIPTION



           **umad_set_addr()** sets the MAD address fields within the specified
           _umad_ buffer using the provided host ordered fields.  _dlid_ is the
           destination LID.  _dqp_ is the destination QP (queue pair).  _sl_ is
           the SL (service level).  _qkey_ is the Q_Key (queue key).
    


## RETURN VALUE



           **umad_set_addr()** returns 0 on success, and a negative value on
           errors. Currently, there are no errors indicated.
    


* * *
# gcvt

## NAME



           gcvt - convert a floating-point number to a string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **char *gcvt(double** _number_**, int** _ndigit_**, char ***_buf_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **gcvt**():
               Since glibc 2.17
                   (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200809L))
                       || /* glibc >= 2.20 */ _DEFAULT_SOURCE
                       || /* glibc <= 2.19 */ _SVID_SOURCE
               glibc 2.12 to glibc 2.16:
                   (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200112L))
                       || _SVID_SOURCE
               Before glibc 2.12:
                   _SVID_SOURCE || _XOPEN_SOURCE >= 500
    


## DESCRIPTION



           The **gcvt**() function converts _number_ to a minimal length null-
           terminated ASCII string and stores the result in _buf_.  It produces
           _ndigit_ significant digits in either printf(3) F format or E
           format.
    


## RETURN VALUE



           The **gcvt**() function returns _buf_.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# gnutls_certificate_set_x509_trust_dir

## NAME



           gnutls_certificate_set_x509_trust_dir - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_trust_dir(gnutls_certificate_credentials_t**
           _cred_**, const char ***_ca_dir_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t cred
                       is a **gnutls_certificate_credentials_t** type.
    
           const char * ca_dir
                       is a directory containing the list of trusted CAs (DER
                       or PEM list)
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER
    


## DESCRIPTION



           This function adds the trusted CAs present in the directory in
           order to verify client or server certificates. This function is
           identical to **gnutls_certificate_set_x509_trust_file()** but loads
           all certificates in a directory.
    


## RETURNS



           the number of certificates processed
    


## SINCE



           3.3.6
    


* * *
# function::local_clock_ms

## NAME



           function::local_clock_ms - Number of milliseconds on the local
           cpu's clock
    


## SYNOPSIS



               local_clock_ms:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of milliseconds on the local
           cpu's clock. This is always monotonic comparing on the same cpu,
           but may have some drift between cpus (within about a jiffy).
    


* * *
# gnutls_x509_crt_set_issuer_alt_othername

## NAME



           gnutls_x509_crt_set_issuer_alt_othername - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_issuer_alt_othername(gnutls_x509_crt_t**
           _crt_**, const char ***_oid_**, const void ***_data_**, unsigned int** _data_size_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const char * oid
                       The other name OID
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The size of data to be set
    
           unsigned int flags
                       GNUTLS_FSAN_SET to clear previous data or
                       GNUTLS_FSAN_APPEND to append.
    


## DESCRIPTION



           This function will set an "othername" to the issuer alternative
           name certificate extension.
    
           The values set are set as binary values and are expected to have
           the proper DER encoding.  For convenience the flags
           **GNUTLS_FSAN_ENCODE_OCTET_STRING** and **GNUTLS_FSAN_ENCODE_UTF8_STRING**
           can be used to encode the provided data.
    


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# function::ctime

## NAME



           function::ctime - Convert seconds since epoch into human readable
           date/time string
    


## SYNOPSIS



           1) ctime:string(epochsecs:long)
    
           2) ctime:string()
    


## ARGUMENTS



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


## DESCRIPTION



           1) Takes an argument of seconds since the epoch as returned
           by**gettimeofday_s**. Returns a string of the form
    
           2) “Wed Jun 30 21:49:08 1993”
    
           The string will always be exactly 24 characters. If the time would
           be unreasonable far in the past (before what can be represented
           with a 32 bit offset in seconds from the epoch) an error will
           occur (which can be avoided with try/catch). If the time would be
           unreasonable far in the future, an error will also occur.
    
           Note that the epoch (zero) corresponds to
    
           “Thu Jan 1 00:00:00 1970”
    
           The earliest full date given by ctime, corresponding to epochsecs
           -2147483648 is “Fri Dec 13 20:45:52 1901”. The latest full date
           given by ctime, corresponding to epochsecs 2147483647 is “Tue Jan
           19 03:14:07 2038”.
    
           The abbreviations for the days of the week are ‘Sun’, ‘Mon’,
           ‘Tue’, ‘Wed’, ‘Thu’, ‘Fri’, and ‘Sat’. The abbreviations for the
           months are ‘Jan’, ‘Feb’, ‘Mar’, ‘Apr’, ‘May’, ‘Jun’, ‘Jul’, ‘Aug’,
           ‘Sep’, ‘Oct’, ‘Nov’, and ‘Dec’.
    
           Note that the real C library **ctime** function puts a newline ('\n')
           character at the end of the string that this function does not.
           Also note that since the kernel has no concept of timezones, the
           returned time is always in GMT.
    


* * *
# pcap_major_version

## NAME



           pcap_major_version, pcap_minor_version - get the version number of
           a savefile
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_major_version(pcap_t *p);**
           **int pcap_minor_version(pcap_t *p);**
    


## DESCRIPTION



           If _p_ refers to a ``savefile'', **pcap_major_version**() returns the
           major number of the file format of the ``savefile'' and
           **pcap_minor_version**() returns the minor number of the file format
           of the ``savefile''.  The version number is stored in the
           ``savefile''; note that the meaning of its values depends on the
           type of ``savefile'' (for example, pcap or pcapng).
    
           If _p_ refers to a live capture, the values returned by
           **pcap_major_version**() and **pcap_minor_version**() are not meaningful.
    


* * *
# gnutls_x509_crt_get_dn_oid

## NAME



           gnutls_x509_crt_get_dn_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_dn_oid(gnutls_x509_crt_t** _cert_**, unsigned**
           _indx_**, void ***_oid_**, size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       This specifies which OID to return. Use (0) to get the
                       first one.
    
           void * oid  a pointer to a buffer to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will extract the OIDs of the name of the Certificate
           subject specified by the given index.
    
           If  _oid_ is null then only the size will be filled. The  _oid_
           returned will be null terminated, although  _oid_size_ will not
           account for the trailing null.
    


## 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. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if there are
           no data in the current index. On success 0 is returned.
    


* * *
# wcscmp

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



           wcscmp — compare two wide-character strings
    


## SYNOPSIS



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


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _wcscmp_() function shall compare the wide-character string
           pointed to by _ws1_ to the wide-character string pointed to by _ws2_.
    
           The sign of a non-zero return value shall be determined by the
           sign of the difference between the values of the first pair of
           wide-character codes that differ in the objects being compared.
    


## RETURN VALUE



           Upon completion, _wcscmp_() shall return an integer greater than,
           equal to, or less than 0, if the wide-character string pointed to
           by _ws1_ is greater than, equal to, or less than the wide-character
           string pointed to by _ws2_ , respectively.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# roundup

## NAME



           roundup - round up in steps
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/param.h>**
    
           **roundup(**_x_**,**_step_**);**
    


## DESCRIPTION



           This macro rounds _x_ to the nearest multiple of _step_ that is not
           less than _x_.
    
           It is typically used for rounding up a pointer to align it or
           increasing a buffer to be allocated.
    
           This API is not designed to be generic, and doesn't work in some
           cases that are not important for the typical use cases described
           above.  See CAVEATS.
    


## RETURN VALUE



           This macro returns the rounded value.
    


## STANDARDS



           None.
    


## CAVEATS



           The arguments may be evaluated more than once.
    
           _x_ should be nonnegative, and _step_ should be positive.
    
           If _x + step_ would overflow or wrap around, the behavior is
           undefined.
    


* * *
# function::kernel_or_user_string_quoted_utf32

## NAME



           function::kernel_or_user_string_quoted_utf32 - Retrieves and
           quotes UTF-32 string from kernel or user memory
    


## SYNOPSIS



               kernel_or_user_string_quoted_utf32:string(addr:long)
    


## ARGUMENTS



           _addr_
               the kernel or user memory address to retrieve the string from
    


## DESCRIPTION



           Similar to kernel_string_quoted_utf32 except user memory is a
           fallback method
    


* * *
# pthread_testcancel

## 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_testcancel — set cancelability state
    


## SYNOPSIS



           #include <pthread.h>
    
           void pthread_testcancel(void);
    


## DESCRIPTION



           Refer to pthread_setcancelstate(3p).
    


* * *
# fileno

## NAME



           fileno - obtain file descriptor of a stdio stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **int fileno(FILE ***_stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fileno**():
               _POSIX_C_SOURCE
    


## DESCRIPTION



           The function **fileno**() examines the argument _stream_ and returns the
           integer file descriptor used to implement this stream.  The file
           descriptor is still owned by _stream_ and will be closed when
           fclose(3) is called.  Duplicate the file descriptor with dup(2)
           before passing it to code that might close it.
    
           For the nonlocking counterpart, see unlocked_stdio(3).
    


## RETURN VALUE



           On success, **fileno**() returns the file descriptor associated with
           _stream_.  On failure, -1 is returned and _errno_ is set to indicate
           the error.
    


## ERRORS



           **EBADF** _stream_ is not associated with a file.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_x509_crt_get_signature_algorithm

## NAME



           gnutls_x509_crt_get_signature_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_signature_algorithm(gnutls_x509_crt_t**
           _cert_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    


## DESCRIPTION



           This function will return a value of the **gnutls_sign_algorithm_t**
           enumeration that is the signature algorithm that has been used to
           sign this certificate.
    
           Since 3.6.0 this function never returns a negative error code.
           Error cases and unknown/unsupported signature algorithms are
           mapped to **GNUTLS_SIGN_UNKNOWN**.
    


## RETURNS



           a **gnutls_sign_algorithm_t** value
    


* * *
# gnutls_record_get_discarded

## NAME



           gnutls_record_get_discarded - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **unsigned int gnutls_record_get_discarded(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the number of discarded packets in a DTLS connection.
    


## RETURNS



           The number of discarded packets.
    


## SINCE



           3.0
    


* * *
# killpg

## NAME



           killpg - send signal to a process group
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **int killpg(int** _pgrp_**, int** _sig_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **killpg**():
               _XOPEN_SOURCE >= 500
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE
    


## DESCRIPTION



           **killpg**() sends the signal _sig_ to the process group _pgrp_.  See
           signal(7) for a list of signals.
    
           If _pgrp_ is 0, **killpg**() sends the signal to the calling process's
           process group.  (POSIX says: if _pgrp_ is less than or equal to 1,
           the behavior is undefined.)
    
           For the permissions required to send a signal to another process,
           see kill(2).
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned, and _errno_
           is set to indicate the error.
    


## ERRORS



           **EINVAL** _sig_ is not a valid signal number.
    
           **EPERM** The process does not have permission to send the signal to
                  any of the target processes.  For the required permissions,
                  see kill(2).
    
           **ESRCH** No process can be found in the process group specified by
                  _pgrp_.
    
           **ESRCH** The process group was given as 0 but the sending process
                  does not have a process group.
    


## VERSIONS



           There are various differences between the permission checking in
           BSD-type systems and System V-type systems.  See the POSIX
           rationale for kill(3p).  A difference not mentioned by POSIX
           concerns the return value **EPERM** : BSD documents that no signal is
           sent and **EPERM** returned when the permission check failed for at
           least one target process, while POSIX documents **EPERM** only when
           the permission check failed for all target processes.
    
       **C library/kernel differences**
           On Linux, **killpg**() is implemented as a library function that makes
           the call _kill(-pgrp, sig)_.
    


## STANDARDS



           POSIX.1-2008.
    


* * *
# probe::socket.close

## NAME



           probe::socket.close - Close a socket
    


## SYNOPSIS



           socket.close
    


## VALUES



           _flags_
               Socket flags value
    
           _family_
               Protocol family value
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    


## CONTEXT



           The requester (user process or kernel)
    


## DESCRIPTION



           Fires at the beginning of closing a socket.
    


* * *
# function::task_ns_tid

## NAME



           function::task_ns_tid - The thread identifier of the task as seen
           in a namespace
    


## SYNOPSIS



               task_ns_tid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the thread id of the given task as seen in
           the pid namespace.
    


* * *
# io_uring_prep_fadvise64

## NAME



           io_uring_prep_fadvise - prepare a fadvise request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_fadvise(struct io_uring_sqe ***_sqe_**,**
                                      **int** _fd_**,**
                                      **__u64** _offset_**,**
                                      **__u32** _len_**,**
                                      **int** _advice_**);**
    
           **void io_uring_prep_fadvise64(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **__u64** _offset_**,**
                                        **off_t** _len_**,**
                                        **int** _advice_**);**
    


## DESCRIPTION



           The io_uring_prep_fadvise(3) function prepares an fadvise request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           pointed to by _fd_ to start an fadvise operation at _offset_ and of
           _len_ length in bytes, giving it the advise located in _advice_.
    
           The io_uring_prep_fadvise64(3) function works like
           io_uring_prep_fadvise(3) except that it takes a 64-bit length
           rather than just a 32-bit one. Older kernels may not support the
           64-bit length variant. If this variant is attempted used on a
           kernel that doesn't support 64-bit lengths, then the request will
           get errored with **-EINVAL** in the results field of the CQE.
    
           This function prepares an async posix_fadvise(2) request. See that
           man page for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. 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.
    


* * *
# gnutls_x509_trust_list_get_issuer_by_subject_key_id

## NAME



           gnutls_x509_trust_list_get_issuer_by_subject_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_trust_list_get_issuer_by_subject_key_id(gnutls_x509_trust_list_t**
           _list_**, const gnutls_datum_t ***_dn_**, const gnutls_datum_t ***_spki_**,**
           **gnutls_x509_crt_t ***_issuer_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const gnutls_datum_t * dn
                       is the issuer's DN (may be **NULL**)
    
           const gnutls_datum_t * spki
                       is the subject key ID
    
           gnutls_x509_crt_t * issuer
                       Will hold the issuer if any. Should be deallocated
                       after use.
    
           unsigned int flags
                       Use zero
    


## DESCRIPTION



           This function will find the issuer with the given name and subject
           key ID, and return a copy of the issuer, which must be freed using
           **gnutls_x509_crt_deinit()**.
    


## RETURNS



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


## SINCE



           3.4.2
    


* * *
# gnutls_ocsp_req_get_nonce

## NAME



           gnutls_ocsp_req_get_nonce - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_get_nonce(gnutls_ocsp_req_const_t** _req_**,**
           **unsigned int ***_critical_**, gnutls_datum_t ***_nonce_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_const_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           unsigned int * critical
                       whether nonce extension is marked critical, or NULL
    
           gnutls_datum_t * nonce
                       will hold newly allocated buffer with nonce data
    


## DESCRIPTION



           This function will return the OCSP request nonce extension data.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _nonce_ ->data.
    


## RETURNS



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


* * *
# gnutls_db_check_entry_expire_time

## NAME



           gnutls_db_check_entry_expire_time - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **time_t gnutls_db_check_entry_expire_time(gnutls_datum_t ***_entry_**);**
    


## ARGUMENTS



           gnutls_datum_t * entry
                       is a pointer to a **gnutls_datum_t** type.
    


## DESCRIPTION



           This function returns the time that this entry will expire.  It
           can be used for database entry expiration.
    


## RETURNS



           The time this entry will expire, or zero on error.
    


## SINCE



           3.6.5
    


* * *
# probe::sunrpc.svc.send

## NAME



           probe::sunrpc.svc.send - Return reply to RPC client
    


## SYNOPSIS



           sunrpc.svc.send
    


## VALUES



           _rq_prog_
               the program number in the request
    
           _rq_vers_
               the program version in the request
    
           _rq_xid_
               the transmission id in the request
    
           _rq_prot_
               the IP protocol of the reqeust
    
           _peer_ip_
               the peer address where the request is from
    
           _rq_proc_
               the procedure number in the request
    
           _sv_name_
               the service name
    


* * *
# rdma_listen

## NAME



           rdma_listen - Listen for incoming connection requests.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_listen (struct rdma_cm_id ***_id_**, int** _backlog_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    
           backlog     backlog of incoming connection requests.
    


## DESCRIPTION



           Initiates a listen for incoming connection requests or datagram
           service lookup.  The listen will be restricted to the locally
           bound source address.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           Users must have bound the rdma_cm_id to a local address by calling
           rdma_bind_addr before calling this routine.  If the rdma_cm_id is
           bound to a specific IP address, the listen will be restricted to
           that address and the associated RDMA device.  If the rdma_cm_id is
           bound to an RDMA port number only, the listen will occur across
           all RDMA devices.
    


* * *
# probe::stap.pass0.end

## NAME



           probe::stap.pass0.end - Finished stap pass0 (parsing command line
           arguments)
    


## SYNOPSIS



           stap.pass0.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass0.end fires just before the **gettimeofday** call for pass1.
    


* * *
# gnutls_dh_get_pubkey

## NAME



           gnutls_dh_get_pubkey - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           gnutls_datum_t * raw_key
                       will hold the public key.
    


## DESCRIPTION



           This function will return the peer's public key used in the last
           Diffie-Hellman key exchange.  This function should be used for
           both anonymous and ephemeral Diffie-Hellman.  The output
           parameters must be freed with **gnutls_free()**.
    
           Note, that public key is exported as non-negative integer and may
           include a leading zero byte.
    


## RETURNS



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


* * *
# gnutls_x509_crt_get_raw_issuer_dn

## NAME



           gnutls_x509_crt_get_raw_issuer_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_raw_issuer_dn(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
                       will hold the starting point of the DN
    


## DESCRIPTION



           This function will return a pointer to the DER encoded DN
           structure and the length. This points to allocated data that must
           be free'd using **gnutls_free()**.
    


## RETURNS



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


* * *
# ptrdiff_t

## NAME



           ptrdiff_t - count of elements or array index
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stddef.h>**
    
           **typedef** /* ... */  **ptrdiff_t;**
    


## DESCRIPTION



           Used for a count of elements, or an array index.  It is the result
           of subtracting two pointers.  It is a signed integer type capable
           of storing values in the range [**PTRDIFF_MIN** , **PTRDIFF_MAX**].
    
           The length modifier for _ptrdiff_t_ for the printf(3) and the
           scanf(3) families of functions is **t** , resulting commonly in **%td** or
           **%ti** for printing _ptrdiff_t_ values.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# io_uring_prep_splice

## NAME



           io_uring_prep_splice - prepare an splice request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_splice(struct io_uring_sqe ***_sqe_**,**
                                     **int** _fd_in_**,**
                                     **int64_t** _off_in_**,**
                                     **int** _fd_out_**,**
                                     **int64_t** _off_out_**,**
                                     **unsigned int** _nbytes_**,**
                                     **unsigned int** _splice_flags_**);**
    


## DESCRIPTION



           The io_uring_prep_splice(3) function prepares a splice request.
           The submission queue entry _sqe_ is setup to use as input the file
           descriptor _fd_in_ at offset _off_in_ , splicing data to the file
           descriptor at _fd_out_ and at offset _off_out_.  _nbytes_ bytes of data
           should be spliced between the two descriptors.  _splice_flags_ are
           modifier flags for the operation. See splice(2) for the generic
           splice flags.
    
           If the _fd_out_ descriptor, **IOSQE_FIXED_FILE** can be set in the SQE
           to indicate that. For the input file, the io_uring specific
           **SPLICE_F_FD_IN_FIXED** can be set in _splice_flags_ and _fd_in_ given as
           a registered file descriptor offset.
    
           If _fd_in_ refers to a pipe, _off_in_ is ignored and must be set to
           -1.
    
           If _fd_in_ does not refer to a pipe and _off_in_ is -1, then _nbytes_
           are read from _fd_in_ starting from the file offset, which is
           incremented by the number of bytes read.
    
           If _fd_in_ does not refer to a pipe and _off_in_ is not -1, then the
           starting offset of _fd_in_ will be _off_in_.
    
           The same rules apply to _fd_out_ and _off_out_.
    
           This function prepares an async splice(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. 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.
    


## NOTES



           Note that even if _fd_in_ or _fd_out_ refers to a pipe, the splice
           operation can still fail with **EINVAL** if one of the fd doesn't
           explicitly support splice operation, e.g. reading from terminal is
           unsupported from kernel 5.7 to 5.11.
    


* * *
# gnutls_certificate_type_get_id

## NAME



           gnutls_certificate_type_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_certificate_type_t gnutls_certificate_type_get_id(const**
           **char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a certificate type name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           a **gnutls_certificate_type_t** for the specified in a string
           certificate type, or **GNUTLS_CRT_UNKNOWN** on error.
    


* * *
# mq_getattr

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



           mq_getattr — get message queue attributes (**REALTIME**)
    


## SYNOPSIS



           #include <mqueue.h>
    
           int mq_getattr(mqd_t _mqdes_ , struct mq_attr *_mqstat_);
    


## DESCRIPTION



           The _mq_getattr_() function shall obtain status information and
           attributes of the message queue and the open message queue
           description associated with the message queue descriptor.
    
           The _mqdes_ argument specifies a message queue descriptor.
    
           The results shall be returned in the **mq_attr** structure referenced
           by the _mqstat_ argument.
    
           Upon return, the following members shall have the values
           associated with the open message queue description as set when the
           message queue was opened and as modified by subsequent
           _mq_setattr_() calls: _mq_flags_.
    
           The following attributes of the message queue shall be returned as
           set at message queue creation: _mq_maxmsg_ , _mq_msgsize_.
    
           Upon return, the following members within the **mq_attr** structure
           referenced by the _mqstat_ argument shall be set to the current
           state of the message queue:
    
           _mq_curmsgs_
                     The number of messages currently on the queue.
    


## RETURN VALUE



           Upon successful completion, the _mq_getattr_() function shall return
           zero. Otherwise, the function shall return -1 and set _errno_ to
           indicate the error.
    


## ERRORS



           The _mq_getattr_() function may fail if:
    
           **EBADF** The _mqdes_ argument is not a valid message queue descriptor.
    
           _The following sections are informative._
    


## EXAMPLES



           See mq_notify(3p).
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# memmove

## NAME



           memmove - copy memory area
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **void *memmove(** size_t n;
                         **void** _dest_**[**_n_**], const void** _src_**[**_n_**], size_t** _n_**);**
    


## DESCRIPTION



           The **memmove**() function copies _n_ bytes from memory area _src_ to
           memory area _dest_.  The memory areas may overlap: copying takes
           place as though the bytes in _src_ are first copied into a temporary
           array that does not overlap _src_ or _dest_ , and the bytes are then
           copied from the temporary array to _dest_.
    


## RETURN VALUE



           The **memmove**() function returns a pointer to _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# libpfm_intel_ivbep_unc_ubo

## NAME



           libpfm_intel_ivbep_unc_ubo - support for Intel Ivy Bridge-EP U-Box
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_ubo**
           **PMU desc: Intel Ivy Bridge-EP U-Box uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge system configuration
           unit (U-Box) uncore PMU.  This PMU model only exists on Ivy Bridge
           model 62.
    


## MODIFIERS



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


* * *
# function::user_ulong_warn

## NAME



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


## SYNOPSIS



               user_ulong_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned long from
    


## DESCRIPTION



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


* * *
# probe::netdev.close

## NAME



           probe::netdev.close - Called when the device is closed
    


## SYNOPSIS



           netdev.close
    


## VALUES



           _dev_name_
               The device that is going to be closed
    


* * *
# probe::socket.aio_write

## NAME



           probe::socket.aio_write - Message send via **sock_aio_write**
    


## SYNOPSIS



           socket.aio_write
    


## VALUES



           _family_
               Protocol family value
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _protocol_
               Protocol value
    
           _size_
               Message size in bytes
    
           _name_
               Name of this probe
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender
    


## DESCRIPTION



           Fires at the beginning of sending a message on a socket via the
           **sock_aio_write** function
    


* * *
# setegid

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



           setegid — set the effective group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           int setegid(gid_t _gid_);
    


## DESCRIPTION



           If _gid_ is equal to the real group ID or the saved set-group-ID, or
           if the process has appropriate privileges, _setegid_() shall set the
           effective group ID of the calling process to _gid_ ; the real group
           ID, saved set-group-ID, and any supplementary group IDs shall
           remain unchanged.
    
           The _setegid_() function shall not affect the supplementary group
           list in any way.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned; otherwise, -1
           shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _setegid_() function shall fail if:
    
           **EINVAL** The value of the _gid_ argument is invalid and is not
                  supported by the implementation.
    
           **EPERM** The process does not have appropriate privileges and _gid_
                  does not match the real group ID or the saved set-group-ID.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to the RATIONALE section in setuid(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_import

## NAME



           gnutls_x509_crq_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_import(gnutls_x509_crq_t** _crq_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       The data to store the parsed certificate request.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded certificate.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded
           certificate request to a **gnutls_x509_crq_t** type.  The output will
           be stored in  _crq_ .
    
           If the Certificate is PEM encoded it should have a header of "NEW
           CERTIFICATE REQUEST".
    


## RETURNS



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


* * *
# gnutls_privkey_sign_data2

## NAME



           gnutls_privkey_sign_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_sign_data2(gnutls_privkey_t** _signer_**,**
           **gnutls_sign_algorithm_t** _algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_data_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_privkey_t signer
                       Holds the key
    
           gnutls_sign_algorithm_t algo
                       The signature algorithm used
    
           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 the specified
           signature algorithm. This function is an enhancement of
           **gnutls_privkey_sign_data()** , as it allows utilizing a alternative
           signature algorithm where possible (e.g, use an RSA key with
           RSA-PSS).
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# ausearch_next_event

## NAME



           ausearch_next_event - find the next event that meets search
           criteria
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int ausearch_next_event(auparse_state_t ***_au);"_
    


## DESCRIPTION



           ausearch_next_event will scan the input source and evaluate
           whether any record in an event contains the data being searched
           for. Evaluation is done at the record level.
    


## RETURN VALUE



           Returns -1 if an error occurs, 0 if no matches, and 1 for success.
    


* * *
# gnutls_compression_get

## NAME



           gnutls_compression_get - API function
    


## SYNOPSIS



           **#include <gnutls/compat.h>**
    
           **gnutls_compression_method_t**
           **gnutls_compression_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the currently used compression algorithm.
    


## RETURNS



           the currently used compression method, a
           **gnutls_compression_method_t** value.
    


* * *
# pthread_getcpuclockid

## 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_getcpuclockid — access a thread CPU-time clock (**ADVANCED**
           **REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
           #include <time.h>
    
           int pthread_getcpuclockid(pthread_t _thread_id_ , clockid_t *_clock_id_);
    


## DESCRIPTION



           The _pthread_getcpuclockid_() function shall return in _clock_id_ the
           clock ID of the CPU-time clock of the thread specified by
           _thread_id_ , if the thread specified by _thread_id_ exists.
    


## RETURN VALUE



           Upon successful completion, _pthread_getcpuclockid_() shall return
           zero; otherwise, an error number shall be returned to indicate the
           error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _pthread_getcpuclockid_() function is part of the Thread CPU-
           Time Clocks option and need not be provided on all
           implementations.
    


## RATIONALE



           If an implementation detects use of a thread ID after the end of
           its lifetime, it is recommended that the function should fail and
           report an **[ESRCH]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *