tripathysagar/man_text huggingface dataset:
# io_uring_prep_read

## NAME



           io_uring_prep_read - prepare I/O read request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_read(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **void ***_buf_**,**
                                   **unsigned** _nbytes_**,**
                                   **__u64** _offset_**);**
    


## DESCRIPTION



           The io_uring_prep_read(3) prepares an IO read request. The
           submission queue entry _sqe_ is setup to use the file descriptor _fd_
           to start reading _nbytes_ into the buffer _buf_ at the specified
           _offset_.
    
           On files that support seeking, if the offset is set to **-1** , the
           read operation commences at the file offset, and the file offset
           is incremented by the number of bytes read. See read(2) for more
           details. Note that for an async API, reading and updating the
           current file offset may result in unpredictable behavior, unless
           access to the file is serialized. It is not encouraged to use this
           feature, if it's possible to provide the desired IO offset from
           the application or library.
    
           On files that are not capable of seeking, the offset must be 0 or
           -1.
    
           After the read has been prepared it can be submitted with one of
           the submit functions.
    


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


* * *
# rdma_post_writev

## NAME



           rdma_post_writev - post an RDMA write work request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_writev (struct rdma_cm_id ***_id_**, void ***_context_**, struct**
           **ibv_sge ***_sgl_**, int** _nsge_**, int** _flags_**, uint64_t** _remote_addr_**, uint32_t**
           _rkey_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       request will be posted.
    
           context     User-defined context associated with the request.
    
           sgl         A scatter-gather list of the source buffers of the
                       write.
    
           nsge        The number of scatter-gather array entries.
    
           flags       Optional flags used to control the write operation.
    
           remote_addr The address of the remote registered memory to write
                       into.
    
           rkey        The registered memory key associated with the remote
                       address.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the local data
           buffers will be written into the remote memory region.
    


## RETURN VALUE



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


## NOTES



           For a list of supported flags, see ibv_post_send.  Unless inline
           data is specified, the local data buffers must have been
           registered before the write is issued, and the buffers must remain
           registered until the write completes.  The remote buffers must
           always be registered.
    
           Write operations may not be posted to an rdma_cm_id or the
           corresponding queue pair until it has been connected.
    
           The user-defined context associated with the write request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# pcap_set_promisc

## NAME



           pcap_set_promisc - set promiscuous mode for a not-yet-activated
           capture handle
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_set_promisc(pcap_t *p, int promisc);**
    


## DESCRIPTION



           **pcap_set_promisc**() sets whether promiscuous mode should be set on
           a capture handle when the handle is activated.  If _promisc_ is non-
           zero, promiscuous mode will be set, otherwise it will not be set.
    


## RETURN VALUE



           **pcap_set_promisc**() returns **0** on success or **PCAP_ERROR_ACTIVATED** if
           called on a capture handle that has been activated.
    


* * *
# asinh

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



           asinh, asinhf, asinhl — inverse hyperbolic sine functions
    


## SYNOPSIS



           #include <math.h>
    
           double asinh(double _x_);
           float asinhf(float _x_);
           long double asinhl(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 sine 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 sine of their argument.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, or ±Inf, _x_ shall be returned.
    
           If _x_ is subnormal, a range error may occur
           and _x_ should be returned.
    
           If _x_ is not returned, _asinh_(), _asinhf_(), and _asinhl_() shall return
           an implementation-defined value no greater in magnitude than
           DBL_MIN, FLT_MIN, and LDBL_MIN, respectively.
    


## ERRORS



           These functions may fail if:
    
           Range Error The value of _x_ is subnormal.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[ERANGE]**.  If the integer expression (_math_errhandling_
                       & MATH_ERREXCEPT) is non-zero, then the underflow
                       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_privkey_get_pk_algorithm

## NAME



           gnutls_privkey_get_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_get_pk_algorithm(gnutls_privkey_t** _key_**, unsigned**
           **int ***_bits_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       should contain a **gnutls_privkey_t** type
    
           unsigned int * bits
                       If set will return the number of bits of the
                       parameters (may be NULL)
    


## DESCRIPTION



           This function will return the public key algorithm of a private
           key and if possible will return a number of bits that indicates
           the security parameter of the key.
    


## RETURNS



           a member of the **gnutls_pk_algorithm_t** enumeration on success, or a
           negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# function::gettimeofday_ns

## NAME



           function::gettimeofday_ns - Number of nanoseconds since UNIX epoch
    


## SYNOPSIS



               gettimeofday_ns:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of nanoseconds since the UNIX
           epoch.
    


* * *
# gnutls_privkey_export_openpgp

## NAME



           gnutls_privkey_export_openpgp - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_openpgp(gnutls_privkey_t** _pkey_**,**
           **gnutls_openpgp_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_openpgp_privkey_t * key
                       Location for the key to be exported.
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.4.0
    


* * *
# gnutls_session_supplemental_register

## NAME



           gnutls_session_supplemental_register - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_supplemental_register(gnutls_session_t** _session_**,**
           **const char ***_name_**, gnutls_supplemental_data_format_type_t** _type_**,**
           **gnutls_supp_recv_func** _recv_func_**, gnutls_supp_send_func** _send_func_**,**
           **unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       the session for which this will be registered
    
           const char * name
                       the name of the supplemental data to register
    
           gnutls_supplemental_data_format_type_t type
                       the type of the supplemental data format
    
           gnutls_supp_recv_func recv_func
                       the function to receive the data
    
           gnutls_supp_send_func send_func
                       the function to send the data
    
           unsigned flags
                       must be zero
    


## DESCRIPTION



           This function will register a new supplemental data type
           (rfc4680).  The registered supplemental functions will be used for
           that specific session. The provided  _type_ must be an unassigned
           type in **gnutls_supplemental_data_format_type_t**.
    
           If the type is already registered or handled by GnuTLS internally
           **GNUTLS_E_ALREADY_REGISTERED** will be returned.
    
           As supplemental data are not defined under TLS 1.3, this function
           will disable TLS 1.3 support for the given session.
    


## RETURNS



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


## SINCE



           3.5.5
    


* * *
# fabs

## NAME



           fabs, fabsf, fabsl - absolute value of floating-point number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the absolute value of the floating-point
           number _x_.
    


## RETURN VALUE



           These functions return the absolute value of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is -0, +0 is returned.
    
           If _x_ is negative infinity or positive infinity, positive infinity
           is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# encrypt

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



           encrypt — encoding function (**CRYPT**)
    


## SYNOPSIS



           #include <unistd.h>
    
           void encrypt(char _block_[64], int _edflag_);
    


## DESCRIPTION



           The _encrypt_() function shall provide access to an implementation-
           defined encoding algorithm. The key generated by _setkey_() is used
           to encrypt the string _block_ with _encrypt_().
    
           The _block_ argument to _encrypt_() shall be an array of length 64
           bytes containing only the bytes with values of 0 and 1. The array
           is modified in place to a similar array using the key set by
           _setkey_().  If _edflag_ is 0, the argument is encoded. If _edflag_ is
           1, the argument may be decoded (see the APPLICATION USAGE
           section); if the argument is not decoded, _errno_ shall be set to
           **[ENOSYS]**.
    
           The _encrypt_() function shall not change the setting of _errno_ if
           successful. An application wishing to check for error situations
           should set _errno_ to 0 before calling _encrypt_().  If _errno_ is non-
           zero on return, an error has occurred.
    
           The _encrypt_() function need not be thread-safe.
    


## RETURN VALUE



           The _encrypt_() function shall not return a value.
    


## ERRORS



           The _encrypt_() function shall fail if:
    
           **ENOSYS** The functionality is not supported on this implementation.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Historical implementations of the _encrypt_() function used a rather
           primitive encoding algorithm.
    
           In some environments, decoding might not be implemented. This is
           related to some Government restrictions on encryption and
           decryption routines. Historical practice has been to ship a
           different version of the encryption library without the decryption
           feature in the routines supplied. Thus the exported version of
           _encrypt_() does encoding but not decoding.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           A future version of the standard may mark this interface as
           obsolete or remove it altogether.
    


* * *
# udev_new

## NAME



           udev_new, udev_ref, udev_unref - Create, acquire and release a
           udev context object
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **struct udev *udev_new(**_void_**);**
    
           **struct udev *udev_ref(struct udev ***_udev_**);**
    
           **struct udev *udev_unref(struct udev ***_udev_**);**
    


## DESCRIPTION



           **udev_new()** allocates a new udev context object and returns a
           pointer to it. This object is opaque and must not be accessed by
           the caller via different means than functions provided by libudev.
           Initially, the reference count of the context is 1. You can
           acquire further references, and drop gained references via
           **udev_ref()** and **udev_unref()**. Once the reference count hits 0, the
           context object is destroyed and freed.
    


## RETURN VALUE



           On success, **udev_new()** returns a pointer to the allocated udev
           context. On failure, **NULL** is returned.  **udev_ref()** returns the
           argument that it was passed, unmodified.  **udev_unref()** always
           returns **NULL**.
    


* * *
# gnutls_pk_get_oid

## NAME



           gnutls_pk_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_pk_get_oid(gnutls_pk_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t algorithm
                       is a public key algorithm
    


## DESCRIPTION



           Convert a **gnutls_pk_algorithm_t** value to its object identifier
           string.
    


## RETURNS



           a pointer to a string that contains the object identifier of the
           specified public key algorithm, or **NULL**.
    


## SINCE



           3.4.3
    


* * *
# io_uring_prep_connect

## NAME



           io_uring_prep_connect - prepare a connect request
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_connect(struct io_uring_sqe ***_sqe_**,**
                                      **int** _sockfd_**,**
                                      **const struct sockaddr ***_addr_**,**
                                      **socklen_t** _addrlen_**);**
    


## DESCRIPTION



           The io_uring_prep_connect(3) function prepares a connect request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _sockfd_ to start connecting to the destination described by the
           socket address at _addr_ and of structure length _addrlen_.
    
           This function prepares an async connect(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



           As with any request that passes in data in a struct, that data
           must remain valid until the request has been successfully
           submitted. It need not remain valid until completion. Once a
           request has been submitted, the in-kernel state is stable. Very
           early kernels (5.4 and earlier) required state to be stable until
           the completion occurred. Applications can test for this behavior
           by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).
    


* * *
# gnutls_pkcs7_get_crl_count

## NAME



           gnutls_pkcs7_get_crl_count - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_crl_count(gnutls_pkcs7_t** _pkcs7_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    


## DESCRIPTION



           This function will return the number of certificates in the PKCS7
           or RFC2630 crl set.
    


## RETURNS



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


* * *
# probe::nfs.fop.mmap

## NAME



           probe::nfs.fop.mmap - NFS client mmap operation
    


## SYNOPSIS



           nfs.fop.mmap
    


## VALUES



           _buf_
               the address of buf in user space
    
           _cache_valid_
               cache related bit mask flag
    
           _attrtimeo_
               how long the cached information is assumed to be valid. We
               need to revalidate the cached attrs for this inode if jiffies
               - read_cache_jiffies > attrtimeo.
    
           _vm_end_
               the first byte after end address within vm_mm
    
           _parent_name_
               parent dir name
    
           _ino_
               inode number
    
           _vm_start_
               start address within vm_mm
    
           _dev_
               device identifier
    
           _vm_flag_
               vm flags
    
           _file_name_
               file name
    
           _cache_time_
               when we started read-caching this inode
    


* * *
# clockid_t

## NAME



           clockid_t - clock ID for the clock and timer functions
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
    
           **typedef** /* ... */ **clockid_t;**
    


## DESCRIPTION



           Used for clock ID type in the clock and timer functions.  It is
           defined as an arithmetic type.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following header also provides this type: _< time.h>_.
    


* * *
# gnutls_handshake_get_last_out

## NAME



           gnutls_handshake_get_last_out - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_handshake_description_t**
           **gnutls_handshake_get_last_out(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function is only useful to check where the last performed
           handshake failed.  If the previous handshake succeed or was not
           performed at all then no meaningful value will be returned.
    
           Check **gnutls_handshake_description_t** in gnutls.h for the available
           handshake descriptions.
    


## RETURNS



           the last handshake message type sent, a
           **gnutls_handshake_description_t**.
    


* * *
# truncf

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



           truncf, truncl — round to truncated integer value
    


## SYNOPSIS



           #include <math.h>
    
           float truncf(float _x_);
           long double truncl(long double _x_);
    


## DESCRIPTION



           Refer to trunc(3p).
    


* * *
# sd_id128_randomize

## NAME



           sd_id128_randomize - Generate 128-bit IDs
    


## SYNOPSIS



           **#include <systemd/sd-id128.h>**
    
           **int sd_id128_randomize(sd_id128_t ***_ret_**);**
    


## DESCRIPTION



           **sd_id128_randomize()** generates a new randomized 128-bit ID and
           returns it in _ret_. Every invocation returns a new randomly
           generated ID. This uses the getrandom(2) kernel random number
           generator.
    
           Note that **sd_id128_randomize()** always returns a UUID Variant 1
           Version 4 compatible ID. It is hence guaranteed that this function
           will never return the ID consisting of all zero or all one bits
           (**SD_ID128_NULL** , **SD_ID128_ALLF**).
    
           For more information about the "sd_id128_t" type, see sd-id128(3).
    
           systemd-id128(1)'s **new** command may be used as a command line
           front-end for **sd_id128_randomize()**.
    


## RETURN VALUE



           The call returns 0 on success (in which case _ret_ is filled in), or
           a negative errno-style error code.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# pfm_get_version

## NAME



           pfm_get_version - get library version
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **int pfm_get_version(void)**_;_
    


## DESCRIPTION



           This function can be called at any time to get the revision level
           of the library. It is not necessary to have invoked
           **pfm_initialize()** prior to calling this function.
    
           The revision number is composed of two fields: a major number and
           a minor number. Both can be extracted using macros provided in the
           header file:
    
           **PFMLIB_MAJ_VERSION(v)**
                  returns the major number encoded in v.
    
           **PFMLIB_MIN_VERSION(v)**
                  returns the minor number encoded in v.
    


## RETURN



           The function is always successful, i.e., it always returns the
           32-bit version number.
    


## ERRORS



    


* * *
# random

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



           random — generate pseudo-random number
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to initstate(3p).
    


* * *
# function::user_string_n_nofault

## NAME



           function::user_string_n_nofault - Retrieves string of given length
           from user space
    


## SYNOPSIS



               user_string_n_nofault(addr:long,n:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    
           _n_
               the maximum length of the string (if not null terminated)
    


## DESCRIPTION



           Returns the C string of a maximum given length from a given user
           space address. Returns the empty string when userspace data is not
           accessible at the given address.
    


* * *
# pcre2_set_callout

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_callout(pcre2_match_context ***_mcontext_**,**
             **int (***_callout_function_**)(pcre2_callout_block *),**
             **void ***_callout_data_**);**
    


## DESCRIPTION



    
           This function sets the callout fields in a match context (the
           first argument).  The second argument specifies a callout
           function, and the third argument is an opaque data item that is
           passed to it. The result of this function is always zero.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# probe::ioblock.end

## NAME



           probe::ioblock.end - Fires whenever a block I/O transfer is
           complete.
    


## SYNOPSIS



           ioblock.end
    


## VALUES



           _ino_
               i-node number of the mapped file
    
           _error_
               0 on success
    
           _devname_
               block device name
    
           _size_
               total size in bytes
    
           _bytes_done_
               number of bytes transferred
    
           _hw_segments_
               number of segments after physical and DMA remapping hardware
               coalescing is performed
    
           _phys_segments_
               number of segments in this bio after physical address
               coalescing is performed.
    
           _name_
               name of the probe point
    
           _vcnt_
               bio vector count which represents number of array element
               (page, offset, length) which makes up this I/O request
    
           _opf_
               operations and flags
    
           _idx_
               offset into the bio vector array
    
           _rw_
               binary trace for read/write request
    
           _sector_
               beginning sector for the entire bio
    
           _flags_
               see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK
               1 RW_AHEAD set, and read/write would block BIO_EOF 2
               out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid
               BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce
               bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not
               supported
    


## CONTEXT



           The process signals the transfer is done.
    


* * *
# __pmconnectlogger

## NAME



           **__pmConnectLogger** - connect to a performance metrics logger
           control port
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmConnectLogger(const char ***_hostname_**, int** _pid_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           Each instance of the Performance Co-Pilot (PCP)  archive  creation
           program  pmlogger(1) supports a control port on which **__pmControl‐**
           Log(3) requests are received, and responses sent.  Optionally, the
           pmlogger(1) instance may be designated the ``primary'' logger.
    
           **__pmConnectLogger** may be used to establish a control port  connec‐
           tion  to  the pmlogger(1) instance identified by process id _pid_ on
           the host _hostname_.
    
           One special case is supported;  for  the  reserved  _pid_  value  of
           **PM_LOG_PRIMARY_PORT** the  requested  connection  is to the control
           port for the ``primary'' logger, whatever its process id might be.
    
           On success, **__pmConnectLogger** returns a non-negative integer, that
           is a file descriptor that may be used in subsequent  communication
           with the pmlogger(1) instance, e.g. for __pmControlLog(3).
    
           As  the  control  port to pmlogger(1) is not multiplexed, applica‐
           tions using **__pmConnectLogger** should use close(2) to terminate the
           connection to pmlogger(1) as soon as they have  finished  communi‐
           cating.
    
           If  the  application connects, and the pmlogger(1) instance subse‐
           quently terminates, e.g. because the associated  pmcd(1)  instance
           is  terminated,  the application will have to explicitly re-estab‐
           lish connection to a re-started pmlogger(1)  instance  by  calling
           **__pmConnectLogger** again.
    


## DIAGNOSTICS



           **PM_ERR_PERMISSION**
                  no permission to connect to the specified pmlogger(1) in‐
                  stance
    
           **-ECONNREFUSED**
                  the designated pmlogger(1) instance does not exist
    
           **-EADDRINUSE**
                  the requested control port is already in use
    


* * *
# wcsspn

## NAME



           wcsspn - get length of a prefix wide-character substring
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **wcsspn**() function is the wide-character equivalent of the
           strspn(3) function.  It determines the length of the longest
           initial segment of _wcs_ which consists entirely of wide-characters
           listed in _accept_.  In other words, it searches for the first
           occurrence in the wide-character string _wcs_ of a wide-character
           not contained in the wide-character string _accept_.
    


## RETURN VALUE



           The **wcsspn**() function returns the number of wide characters in the
           longest initial segment of _wcs_ which consists entirely of wide-
           characters listed in _accept_.  In other words, it returns the
           position of the first occurrence in the wide-character string _wcs_
           of a wide-character not contained in the wide-character string
           _accept_ , or _wcslen(wcs)_ if there is none.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# sctp_recvmsg

## NAME



           sctp_recvmsg - Receive a message from a SCTP socket.
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <netinet/sctp.h>**
    
           **int sctp_recvmsg(int** _sd_**, void ***_msg_**, size_t** _len_**,**
                            **struct sockaddr ***_from_**, socklen_t ***_fromlen_**,**
                            **struct sctp_sndrcvinfo ***_sinfo_**, int ***_msg_flags);_
    


## DESCRIPTION



           **sctp_recvmsg** is a wrapper library function that can be used to
           receive a message from a socket while using the advanced features
           of SCTP.  _sd_ is the socket descriptor on which the message pointed
           to by _msg_ of length _len_ is received.
    
           If _from_ is not NULL, the source address of the message is filled
           in. The argument _fromlen_ is a value-result parameter. initialized
           to the size of the buffer associated with _from ,_ and modified on
           return to indicate the actual size of the address stored.
    
           _sinfo_ is a pointer to a sctp_sndrcvinfo structure to be filled
           upon receipt of the message.  _msg_flags_ is a pointer to a integer
           that is filled with any message flags like **MSG_NOTIFICATION or**
           **MSG_EOR.** The value of _msg_flags_ pointer should be initialized to
           0 to avoid unexpected behavior; _msg_flags_ is also used as an input
           _flags_ argument to _recvmsg_ function.
    


## RETURN VALUE



           On success, **sctp_recvmsg** returns the number of bytes received or
           -1 if an error occurred.
    


* * *
# probe::stap.cache_add_nss

## NAME



           probe::stap.cache_add_nss - Add NSS (Network Security Services)
           information to cache
    


## SYNOPSIS



           stap.cache_add_nss
    


## VALUES



           _source_path_
               the path the .sgn file is coming from (incl filename)
    
           _dest_path_
               the path the .sgn file is coming from (incl filename)
    


## DESCRIPTION



           Fires just before the file is actually moved. Note: stap must
           compiled with NSS support; if moving the kernel module fails, this
           probe will not fire.
    


* * *
# gnutls_x509_crt_get_extension_by_oid2

## NAME



           gnutls_x509_crt_get_extension_by_oid2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_extension_by_oid2(gnutls_x509_crt_t** _cert_**,**
           **const char ***_oid_**, unsigned** _indx_**, gnutls_datum_t ***_output_**, unsigned**
           **int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const char * oid
                       holds an Object Identified in null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the extensions,
                       this specifies which to send. Use (0) to get the first
                       one.
    
           gnutls_datum_t * output
                       will hold the allocated extension data
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return the extension specified by the OID in
           the certificate.  The extensions will be returned as binary data
           DER encoded, in the provided buffer.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned. If the certificate does not contain the
           specified extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be
           returned.
    


## SINCE



           3.3.8
    


* * *
# function::cve_tmpdisable

## NAME



           function::cve_tmpdisable - Disable the cve livepatch
    


## SYNOPSIS



               cve_tmpdisable(duration:long)
    


## ARGUMENTS



           _duration_
               The number of seconds to disable
    


## DESCRIPTION



           This function temporarily disables the conditionals which use
           cve_enabled_p for duration seconds. If duration is -1, disable the
           livepatch until reenabled.
    


* * *
# probe::signal.send.return

## NAME



           probe::signal.send.return - Signal being sent to a process
           completed (deprecated in SystemTap 2.1)
    


## SYNOPSIS



           signal.send.return
    


## VALUES



           _retstr_
               The return value to either __group_send_sig_info,
               specific_send_sig_info, or send_sigqueue
    
           _name_
               The name of the function used to send out the signal
    
           _send2queue_
               Indicates whether the sent signal was sent to an existing
               sigqueue
    
           _shared_
               Indicates whether the sent signal is shared by the thread
               group.
    


## CONTEXT



           The signal's sender. (correct?)
    


## DESCRIPTION



           Possible __group_send_sig_info and specific_send_sig_info return
           values are as follows;
    
           0 -- The signal is successfully sent to a process, which means
           that, (1) the signal was ignored by the receiving process, (2)
           this is a non-RT signal and the system already has one queued, and
           (3) the signal was successfully added to the sigqueue of the
           receiving process.
    
           -EAGAIN -- The sigqueue of the receiving process is overflowing,
           the signal was RT, and the signal was sent by a user using
           something other than **kill**.
    
           Possible send_group_sigqueue and send_sigqueue return values are
           as follows;
    
           0 -- The signal was either successfully added into the sigqueue of
           the receiving process, or a SI_TIMER entry is already queued (in
           which case, the overrun count will be simply incremented).
    
           1 -- The signal was ignored by the receiving process.
    
           -1 -- (send_sigqueue only) The task was marked exiting, allowing *
           posix_timer_event to redirect it to the group leader.
    


* * *
# putwchar

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



           putwchar — put a wide character on a stdout stream
    


## SYNOPSIS



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


## 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 function call _putwchar_(_wc_) shall be equivalent to
           _putwc_(_wc_ ,_stdout_).
    


## RETURN VALUE



           Refer to fputwc(3p).
    


## ERRORS



           Refer to fputwc(3p).
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tcp.disconnect.return

## NAME



           probe::tcp.disconnect.return - TCP socket disconnection complete
    


## SYNOPSIS



           tcp.disconnect.return
    


## VALUES



           _name_
               Name of this probe
    
           _ret_
               Error code (0: no error)
    


## CONTEXT



           The process which disconnects tcp
    


* * *
# sem_getvalue

## NAME



           sem_getvalue - get the value of a semaphore
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <semaphore.h>**
    
           **int sem_getvalue(sem_t *restrict** _sem_**, int *restrict** _sval_**);**
    


## DESCRIPTION



           **sem_getvalue**() places the current value of the semaphore pointed
           to _sem_ into the integer pointed to by _sval_.
    
           If one or more processes or threads are blocked waiting to lock
           the semaphore with sem_wait(3), POSIX.1 permits two possibilities
           for the value returned in _sval_ : either 0 is returned; or a
           negative number whose absolute value is the count of the number of
           processes and threads currently blocked in sem_wait(3).  Linux
           adopts the former behavior.
    


## RETURN VALUE



           **sem_getvalue**() returns 0 on success; on error, -1 is returned and
           _errno_ is set to indicate the error.
    


## ERRORS



           **EINVAL** _sem_ is not a valid semaphore.  (The glibc implementation
                  currently does not check whether _sem_ is valid.)
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The value of the semaphore may already have changed by the time
           **sem_getvalue**() returns.
    


* * *
# function::print_ustack

## NAME



           function::print_ustack - Print out stack for the current task from
           string.
    


## SYNOPSIS



               print_ustack(stk:string)
    


## ARGUMENTS



           _stk_
               String with list of hexadecimal addresses for the current
               task.
    


## DESCRIPTION



           Perform a symbolic lookup of the addresses in the given string,
           which is assumed to be the result of a prior call to **ubacktrace**
           for the current task.
    
           Print one line per address, including the address, the name of the
           function containing the address, and an estimate of its position
           within that function. Return nothing.
    


## NOTE



           it is recommended to use **print_usyms** instead of this function.
    


* * *
# pcre2_substring_get_bynumber

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_get_bynumber(pcre2_match_data ***_match_data_**,**
             **uint32_t** _number_**, PCRE2_UCHAR ****_bufferptr_**, PCRE2_SIZE ***_bufflen_**);**
    


## DESCRIPTION



    
           This is a convenience function for extracting a captured substring
           by number into newly acquired memory. The arguments are:
    
             _match_data_    The match data for the match
             _number_        Number of the required substring
             _bufferptr_     Where to put the string pointer
             _bufflen_       Where to put the string length
    
           The memory in which the substring is placed is obtained by calling
           the same memory allocation function that was used for the match
           data block. The convenience function **pcre2_substring_free()** can be
           used to free it when it is no longer needed. The yield of the
           function is zero for success or one of the following error
           numbers:
    
             PCRE2_ERROR_NOSUBSTRING   there are no groups of that number
             PCRE2_ERROR_UNAVAILBLE    the ovector was too small for that
           group
             PCRE2_ERROR_UNSET         the group did not participate in the
           match
             PCRE2_ERROR_NOMEMORY      memory could not be obtained
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *