tripathysagar/man_text huggingface dataset:
# pcap_lib_version

## NAME



           pcap_lib_version - get the version information for libpcap
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **const char *pcap_lib_version(void);**
    


## DESCRIPTION



           **pcap_lib_version**() returns a pointer to a string giving
           information about the version of the libpcap library being used.
           The string begins with the words "libpcap version".  Then follows
           the version, which consists of three dot-separated numbers and the
           optional "-PRE-GIT" suffix to indicate a development snapshot,
           same as in the output of **pcap-config --version** in sufficiently
           recent libpcap releases.  After the version often follows
           additional text to indicate particular features.  For example:
    
           an old release, on any OS
                  **libpcap version 1.5.3**
    
           a newer release on a Linux host
                  **libpcap version 1.10.4 (with TPACKET_V3)**
    
           the same, built with DAG support only
                  **libpcap version 1.10.4 (DAG-only)**
    
           a development snapshot on a FreeBSD host
                  **libpcap version 1.11.0-PRE-GIT (with zerocopy support)**
    


* * *
# mlx5dv_create_steering_anchor

## NAME



           mlx5dv_create_steering_anchor - Creates a steering anchor
    
           mlx5dv_destroy_steering_anchor - Destroys a steering anchor
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_steering_anchor *
                  mlx5dv_create_steering_anchor(struct ibv_context *context,
                                                struct mlx5dv_steering_anchor_attr *attr);
    
                  int mlx5dv_destroy_steering_anchor(struct mlx5dv_steering_anchor *sa);
    


## DESCRIPTION



           A user can take packets into a user-configured sandbox and do
           packet processing at the end of which a steering pipeline decision
           is made on what to do with the packet.
    
           A steering anchor allows the user to reinject the packet back into
           the kernel for additional processing.
    
           **mlx5dv_create_steering_anchor()** Creates an anchor which will allow
           injecting the packet back into the kernel steering pipeline.
    
           **mlx5dv_destroy_steering_anchor()** Destroys a steering anchor.
    


## ARGUMENTS



       **context**
           The device context to associate the steering anchor with.
    
       **attr**
           Anchor attributes specify the priority and flow table type to
           which the anchor will point.
    
                  struct mlx5dv_steering_anchor_attr {
                          enum mlx5dv_flow_table_type ft_type;
                          uint16_t priority;
                          uint64_t comp_mask;
                  };
    
           _ft_type_
                  The flow table type to which the anchor will point.
    
           _priority_
                  The priority inside _ft_type_ to which the created anchor
                  will point.
    
           _comp_mask_
                  Reserved for future extension, must be 0 now.
    
       **mlx5dv_steering_anchor**
                  struct mlx5dv_steering_anchor {
                      uint32_t id;
                  };
    
           _id_     The flow table ID to use as the destination when creating
                  the flow table entry.
    


## RETURN VALUE



           **mlx5dv_create_steering_anchor()** returns a pointer to a new
           _mlx5dv_steering_anchor_ on success.  On error NULL is returned and
           errno is set.
    
           **mlx5dv_destroy_steering_anchor()** returns 0 on success and errno
           value on error.
    


* * *
# function::tcpmib_local_addr

## NAME



           function::tcpmib_local_addr - Get the source address
    


## SYNOPSIS



               tcpmib_local_addr:long(sk:long)
    


## ARGUMENTS



           _sk_
               pointer to a struct inet_sock
    


## DESCRIPTION



           Returns the saddr from a struct inet_sock in host order.
    


* * *
# gnutls_x509_crl_get_issuer_dn2

## NAME



           gnutls_x509_crl_get_issuer_dn2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_issuer_dn2(gnutls_x509_crl_t** _crl_**,**
           **gnutls_datum_t ***_dn_**);**
    


## ARGUMENTS



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


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.1.10
    


* * *
# mode_t

## NAME



           mode_t - file attributes
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



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


## DESCRIPTION



           Used for some file attributes (e.g., file mode).  It is an integer
           type.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< fcntl.h>_, _< ndbm.h>_,
           _< spawn.h>_, _< sys/ipc.h>_, _< sys/mman.h>_, and _< sys/stat.h>_.
    


* * *
# memcpy

## NAME



           memcpy - copy memory area
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **memcpy**() function copies _n_ bytes from memory area _src_ to
           memory area _dest_.  The memory areas must not overlap.  Use
           memmove(3) if the memory areas do overlap.
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## CAVEATS



           Failure to observe the requirement that the memory areas do not
           overlap has been the source of significant bugs.  (POSIX and the C
           standards are explicit that employing **memcpy**() with overlapping
           areas produces undefined behavior.)  Most notably, in glibc 2.13 a
           performance optimization of **memcpy**() on some platforms (including
           x86-64) included changing the order in which bytes were copied
           from _src_ to _dest_.
    
           This change revealed breakages in a number of applications that
           performed copying with overlapping areas.  Under the previous
           implementation, the order in which the bytes were copied had
           fortuitously hidden the bug, which was revealed when the copying
           order was reversed.  In glibc 2.14, a versioned symbol was added
           so that old binaries (i.e., those linked against glibc versions
           earlier than 2.14) employed a **memcpy**() implementation that safely
           handles the overlapping buffers case (by providing an "older"
           **memcpy**() implementation that was aliased to memmove(3)).
    


* * *
# libpfm_intel_ivbep_unc_r3qpi

## NAME



           libpfm_intel_ivbep_unc_r3qpi - support for Intel Ivy Bridge-EP
           R3QPI uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_r3qpi0, ivbep_unc_r3qpi1, ivbep_unc_r3qpi2**
           **PMU desc: Intel Ivy Bridge-EP R3QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge R3QPI uncore PMU.  This
           PMU model only exists on Ivy Bridge model 62.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge R3PQI
           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 R3QPI 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].
    


* * *
# ibv_rate_to_mbps

## NAME



           ibv_rate_to_mbps - convert IB rate enumeration to Mbit/sec
    
           mbps_to_ibv_rate - convert Mbit/sec to an IB rate enumeration
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_rate_to_mbps(enum ibv_rate rate);
    
                  enum ibv_rate mbps_to_ibv_rate(int mbps);
    


## DESCRIPTION



           **ibv_rate_to_mbps()** converts the IB transmission rate enumeration
           _rate_ to a number of Mbit/sec. For example, if _rate_ is
           **IBV_RATE_5_GBPS** , the value 5000 will be returned (5 Gbit/sec =
           5000 Mbit/sec).
    
           **mbps_to_ibv_rate()** converts the number of Mbit/sec _mult_ to an IB
           transmission rate enumeration.  For example, if _mult_ is 5000, the
           rate enumeration **IBV_RATE_5_GBPS** will be returned.
    


## RETURN VALUE



           **ibv_rate_to_mbps()** returns the number of Mbit/sec.
    
           **mbps_to_ibv_rate()** returns the enumeration representing the IB
           transmission rate.
    


* * *
# printf

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



           printf — print formatted output
    


## SYNOPSIS



           #include <stdio.h>
    
           int printf(const char *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fprintf(3p).
    


* * *
# function::user_string_n_quoted

## NAME



           function::user_string_n_quoted - Retrieves and quotes string from
           user space
    


## SYNOPSIS



           1) user_string_n_quoted:string(addr:long,n:long)
    
           2) user_string_n_quoted:string(addr:long,inlen:long,outlen:long)
    


## ARGUMENTS



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


## DESCRIPTION



           1) Returns up to n characters of a C string from the given user
           space memory address where any ASCII characters that are not
           printable are replaced by the corresponding escape sequence in the
           returned string. Note that the string will be surrounded by double
           quotes. On the rare cases when userspace data is not accessible at
           the given address, the address itself is returned as a string,
           without double quotes.
    
           2) Reads up to inlen characters of a C string from the given user
           space memory address, and returns up to outlen characters, where
           any ASCII characters that are not printable are replaced by the
           corresponding escape sequence in the returned string. Note that
           the string will be surrounded by double quotes. On the rare cases
           when userspace data is not accessible at the given address, the
           address itself is returned as a string, without double quotes.
    


* * *
# acl_check

## NAME



           **acl_check** — check an ACL for validity
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _int_ **acl_check**(_acl_t acl_ , _int *last_)
    


## DESCRIPTION



           The **acl_check**() function checks the ACL referred to by the
           argument _acl_ for validity.
    
           The three required entries ACL_USER_OBJ, ACL_GROUP_OBJ, and
           ACL_OTHER must exist exactly once in the ACL. If the ACL contains
           any ACL_USER or ACL_GROUP entries, then an ACL_MASK entry is also
           required. The ACL may contain at most one ACL_MASK entry.
    
           The user identifiers must be unique among all entries of type
           ACL_USER.  The group identifiers must be unique among all entries
           of type ACL_GROUP.
    
           If the ACL referred to by _acl_ is invalid, **acl_check**() returns a
           positive error code that indicates which type of error was
           detected.  The following symbolic error codes are defined:
    
           ACL_MULTI_ERROR       The ACL contains multiple entries that have
                                 a tag type that may occur at most once.
    
           ACL_DUPLICATE_ERROR   The ACL contains multiple ACL_USER entries
                                 with the same user ID, or multiple ACL_GROUP
                                 entries with the same group ID.
    
           ACL_MISS_ERROR        A required entry is missing.
    
           ACL_ENTRY_ERROR       The ACL contains an invalid entry tag type.
    
           The **acl_error**() function can be used to translate error codes to
           text messages.
    
           In addition, if the pointer _last_ is not **NULL** , **acl_check**() assigns
           the number of the ACL entry at which the error was detected to the
           value pointed to by _last_.  Entries are numbered starting with
           zero, in the order in which they would be returned by the
           **acl_get_entry**() function.
    


## RETURN VALUE



           If successful, the **acl_check**() function returns **0** if the ACL
           referred to by _acl_ is valid, and a positive error code if the ACL
           is invalid. Otherwise, a value of **-1** is returned and the global
           variable _errno_ is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_check**() function
           returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# rdma_get_request

## NAME



           rdma_get_request - Retrieves the next pending connection request
           event.
    


## SYNOPSIS



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


## ARGUMENTS



           listen      Listening rdma_cm_id.
    
           id          rdma_cm_id associated with the new connection.
    


## DESCRIPTION



           Retrieves a connection request event.  If no requests are pending,
           the call will block until an event is received.
    


## RETURN VALUE



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


## NOTES



           This call may only be used on listening rdma_cm_id's operating
           synchronously.  On success, a new rdma_cm_id representing the
           connection request will be returned to the user.  The new
           rdma_cm_id will reference event information associated with the
           request until the user calls rdma_reject, rdma_accept, or
           rdma_destroy_id on the newly created identifier.  For a
           description of the event data, see rdma_get_cm_event.
    
           If QP attributes are associated with the listening endpoint, the
           returned rdma_cm_id will also reference an allocated QP.
    


* * *
# gnutls_sign_get_pk_algorithm

## NAME



           gnutls_sign_get_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_pk_algorithm_t**
           **gnutls_sign_get_pk_algorithm(gnutls_sign_algorithm_t** _sign_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t sign
                       is a signature algorithm
    


## DESCRIPTION



           This function returns the public key algorithm corresponding to
           the given signature algorithms. Note that there may be multiple
           public key algorithms supporting a particular signature type; when
           dealing with such algorithms use instead
           **gnutls_sign_supports_pk_algorithm()**.
    


## SINCE



           3.1.1
    


## RETURNS



           return a **gnutls_pk_algorithm_t** value, or **GNUTLS_PK_UNKNOWN** on
           error.
    


* * *
# function::fp_le

## NAME



           function::fp_le - Check if first fp is less than or equal to
    


## SYNOPSIS



               fp_le:long(infp1:long,infp2:long)
    


## ARGUMENTS



           _infp1_
               the 64 bit floating point input
    
           _infp2_
               second 64 bit floating point input
    


## DESCRIPTION



           check if infp1 is less than or equal to infp2
    


* * *
# posix_spawnattr_getsigdefault

## PROLOG



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


## NAME



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


## SYNOPSIS



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


## DESCRIPTION



           The _posix_spawnattr_getsigdefault_() function shall obtain the
           value of the _spawn-sigdefault_ attribute from the attributes object
           referenced by _attr_.
    
           The _posix_spawnattr_setsigdefault_() function shall set the _spawn-_
           _sigdefault_ attribute in an initialized attributes object
           referenced by _attr_.
    
           The _spawn-sigdefault_ attribute represents the set of signals to be
           forced to default signal handling in the new process image (if
           POSIX_SPAWN_SETSIGDEF is set in the _spawn-flags_ attribute) by a
           spawn operation. The default value of this attribute shall be an
           empty signal set.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getsigdefault_() shall
           return zero and store the value of the _spawn-sigdefault_ attribute
           of _attr_ into the object referenced by the _sigdefault_ parameter;
           otherwise, an error number shall be returned to indicate the
           error.
    
           Upon successful completion, _posix_spawnattr_setsigdefault_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setsigdefault_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn option and need not be
           provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# rdma_disconnect

## NAME



           rdma_disconnect - This function disconnects a connection.
    


## SYNOPSIS



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


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Disconnects a connection and transitions any associated QP to the
           error state, which will flush any posted work requests to the
           completion queue.  This routine should be called by both the
           client and server side of a connection.  After successfully
           disconnecting, an RDMA_CM_EVENT_DISCONNECTED event will be
           generated on both sides of the connection.
    


## RETURN VALUE



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


* * *
# gnutls_privkey_export_ecc_raw

## NAME



           gnutls_privkey_export_ecc_raw - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    
           gnutls_datum_t * k
                       will hold the private key
    


## DESCRIPTION



           This function will export the ECC private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be in the native format for the curve.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# io_uring_prep_write_fixed

## NAME



           io_uring_prep_write_fixed - prepare I/O write request with
           registered buffer
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_prep_write_fixed(3) prepares an IO write request with
           a previously registered IO buffer. The submission queue entry _sqe_
           is setup to use the file descriptor _fd_ to start writing _nbytes_
           from the buffer _buf_ at the specified _offset_ and with the buffer
           matching the registered index of _buf_index_.
    
           This works just like io_uring_prep_write(3) except it requires the
           use of buffers that have been registered with
           io_uring_register_buffers(3).  The _buf_ and _nbytes_ arguments must
           fall within a region specified by _buf_index_ in the previously
           registered buffer. The buffer need not be aligned with the start
           of the registered buffer.
    
           After the write 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.
    


* * *
# putenv

## NAME



           putenv - change or add an environment variable
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int putenv(char ***_string_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **putenv**():
               _XOPEN_SOURCE
                   || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _SVID_SOURCE
    


## DESCRIPTION



           The **putenv**() function adds or changes the value of environment
           variables.  The argument _string_ is of the form _name_ =_value_.  If
           _name_ does not already exist in the environment, then _string_ is
           added to the environment.  If _name_ does exist, then the value of
           _name_ in the environment is changed to _value_.  The string pointed
           to by _string_ becomes part of the environment, so altering the
           string changes the environment.
    


## RETURN VALUE



           The **putenv**() function returns zero on success.  On failure, it
           returns a nonzero value, and _errno_ is set to indicate the error.
    


## ERRORS



           **ENOMEM** Insufficient space to allocate new environment.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_x509_crl_export2

## NAME



           gnutls_x509_crl_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_export2(gnutls_x509_crl_t** _crl_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       Holds the revocation list
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a private key PEM or DER encoded
    


## DESCRIPTION



           This function will export the revocation list to DER or PEM
           format.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           X509 CRL".
    


## RETURNS



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


* * *
# acl_get_fd

## NAME



           **acl_get_fd** — get an ACL by file descriptor
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _acl_t_ **acl_get_fd**(_int fd_)
    


## DESCRIPTION



           The **acl_get_fd**() function retrieves the access ACL associated with
           the file referred to by _fd_.  The ACL is placed into working
           storage and **acl_get_fd**() returns a pointer to that storage.
    
           In order to read an ACL from an object, a process must have read
           access to the object's attributes.
    
           This function may cause memory to be allocated.  The caller should
           free any releasable memory, when the new ACL is no longer
           required, by calling _acl_free_(3) with the _(void*)acl_t_ returned by
           **acl_get_fd**() as an argument.
    


## RETURN VALUE



           On success, this function shall return a pointer to the working
           storage.  On error, a value of **(acl_t)NULL** shall be returned, and
           _errno_ is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_get_fd**()
           function returns a value of **(acl_t)NULL** and sets _errno_ to the
           corresponding value:
    
           [EBADF]            The _fd_ argument is not a valid file descriptor.
    
           [ENOMEM]           The ACL working storage requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    
           [ENOTSUP]          The file system on which the file identified by
                              _fd_ is located does not support ACLs, or ACLs
                              are disabled.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# pcap_can_set_rfmon

## NAME



           pcap_can_set_rfmon - check whether monitor mode can be set for a
           not-yet-activated capture handle
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_can_set_rfmon**() checks whether monitor mode could be set on a
           capture handle when the handle is activated.
    


## RETURN VALUE



           **pcap_can_set_rfmon**() returns **0** if monitor mode could not be set, **1**
           if monitor mode could be set, and a negative value on error.  A
           negative return value indicates what error condition occurred.
           The possible error values are:
    
           **PCAP_ERROR_NO_SUCH_DEVICE**
                  The capture source specified when the handle was created
                  doesn't exist.
    
           **PCAP_ERROR_PERM_DENIED**
                  The process doesn't have permission to check whether
                  monitor mode could be supported.
    
           **PCAP_ERROR_ACTIVATED**
                  The capture handle has already been activated.
    
           **PCAP_ERROR**
                  Another error occurred.  **pcap_geterr**(3PCAP) or
                  **pcap_perror**(3PCAP) may be called with _p_ as an argument to
                  fetch or display a message describing the error.
    
           Additional error codes may be added in the future; a program
           should check for **0** , **1** , and negative, return codes, and treat all
           negative return codes as errors.  **pcap_statustostr**(3PCAP) can be
           called, with a warning or error code as an argument, to fetch a
           message describing the warning or error code.
    


* * *
# libpfm_intel_hswep_unc_ubo

## NAME



           libpfm_intel_hswep_unc_ubo - support for Intel Haswell-EP U-Box
           uncore PMU
    


## SYNOPSIS



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


## DESCRIPTION



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


## MODIFIERS



           The following modifiers are supported on Intel Haswell 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].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# function::pages_to_string

## NAME



           function::pages_to_string - Turns pages into a human readable
           string
    


## SYNOPSIS



               pages_to_string:string(pages:long)
    


## ARGUMENTS



           _pages_
               Number of pages to translate.
    


## DESCRIPTION



           Multiplies pages by **page_size** to get the number of bytes and
           returns the result of **bytes_to_string**.
    


* * *
# curs_print

## NAME



           **mcprint** - ship binary data to printer
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int mcprint(char ***_data_**, int** _len_**);**
    


## DESCRIPTION



           This function uses the **mc5p** or **mc4** and **mc5** capabilities, if they
           are present, to ship given data to a printer attached to the
           terminal.
    
           Note that the **mcprint** code has no way to do flow control with the
           printer or to know how much buffering it has.  Your application is
           responsible for keeping the rate of writes to the printer below
           its continuous throughput rate (typically about half of its
           nominal cps rating).  Dot-matrix printers and 6-page-per-minute
           lasers can typically handle 80cps, so a good conservative rule of
           thumb is to sleep for a second after shipping each 80-character
           line.
    


## RETURN VALUE



           The **mcprint** function returns **ERR** if the write operation aborted
           for some reason.  In this case, **errno** will contain either an error
           associated with write(2) or one of the following:
    
           ENODEV
                Capabilities for printer redirection do not exist.
    
           ENOMEM
                Couldn't allocate sufficient memory to buffer the printer
                write.
    
           When **mcprint** succeeds, it returns the number of characters
           actually sent to the printer.
    


## PORTABILITY



           The **mcprint** call was designed for **ncurses**(3X), and is not found in
           SVr4 curses, 4.4BSD curses, or any other previous version of
           curses.
    


## BUGS



           Padding in the **mc5p** , **mc4** and **mc5** capabilities will not be
           interpreted.
    


* * *
# rdma_post_sendv

## NAME



           rdma_post_sendv - post a work request to send a message.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_sendv (struct rdma_cm_id ***_id_**, void ***_context_**, struct**
           **ibv_sge ***_slg_**, int** _nsge_**, int** _flags_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer will be posted.
    
           context     User-defined context associated with the request.
    
           slg         A scatter-gather list of memory buffers posted as a
                       single request.
    
           nsge        The number of scatter-gather entries in the slg array.
    
           flags       Optional flags used to control the send operation.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the posted
           buffers will be sent to the remote peer of a connection.
    


## RETURN VALUE



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


## NOTES



           The user is responsible for ensuring that the remote peer has
           queued a receive request before issuing the send operations.  For
           a list of supported flags, see ibv_post_send.  Unless the send
           request is using inline data, the message buffers must have been
           registered before being posted, and the buffers must remain
           registered until the send completes.
    
           Send 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 send request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# gnutls_x509_crt_get_activation_time

## NAME



           gnutls_x509_crt_get_activation_time - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **time_t gnutls_x509_crt_get_activation_time(gnutls_x509_crt_t**
           _cert_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    


## DESCRIPTION



           This function will return the time this Certificate was or will be
           activated.
    


## RETURNS



           activation time, or (time_t)-1 on error.
    


* * *
# gnutls_heartbeat_allowed

## NAME



           gnutls_heartbeat_allowed - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_heartbeat_allowed(gnutls_session_t** _session_**,**
           **unsigned int** _type_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int type
                       one of **GNUTLS_HB_LOCAL_ALLOWED_TO_SEND** and
                       **GNUTLS_HB_PEER_ALLOWED_TO_SEND**
    


## DESCRIPTION



           This function will check whether heartbeats are allowed to be sent
           or received in this session.
    


## RETURNS



           Non zero if heartbeats are allowed.
    


## SINCE



           3.1.2
    


* * *
# rdma_get_send_comp

## NAME



           rdma_get_send_comp - retrieves a completed send, read, or write
           request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_get_send_comp (struct rdma_cm_id ***_id_**, struct ibv_wc ***_wc_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier to check for
                       completions.
    
           wc          A reference to a work completion structure to fill in.
    


## DESCRIPTION



           Retrieves a completed work request for a send, RDMA read, or RDMA
           write operation.  Information about the completed request is
           returned through the wc parameter, with the wr_id set to the
           context of the request.  For details on the work completion
           structure, see ibv_poll_cq.
    


## RETURN VALUE



           Returns the number of returned completions (0 or 1) on success, or
           -1 on error.  If an error occurs, errno will be set to indicate
           the failure reason.
    


## NOTES



           This calls polls the send completion queue associated with an
           rdma_cm_id.  If a completion is not found, the call blocks until a
           request completes.  This call should only be used on rdma_cm_id's
           that do not share CQs with other rdma_cm_id's, and maintain
           separate CQs for sends and receive completions.
    


* * *
# fwide

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



           fwide — set stream orientation
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           int fwide(FILE *_stream_ , int _mode_);
    


## 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 _fwide_() function shall determine the orientation of the stream
           pointed to by _stream_.  If _mode_ is greater than zero, the function
           first attempts to make the stream wide-oriented. If _mode_ is less
           than zero, the function first attempts to make the stream byte-
           oriented. Otherwise, _mode_ is zero and the function does not alter
           the orientation of the stream.
    
           If the orientation of the stream has already been determined,
           _fwide_() shall not change it.
    
           The _fwide_() function shall not change the setting of _errno_ if
           successful.
    
           Since no return value is reserved to indicate an error, an
           application wishing to check for error situations should set _errno_
           to 0, then call _fwide_(), then check _errno_ , and if it is non-zero,
           assume an error has occurred.
    


## RETURN VALUE



           The _fwide_() function shall return a value greater than zero if,
           after the call, the stream has wide-orientation, a value less than
           zero if the stream has byte-orientation, or zero if the stream has
           no orientation.
    


## ERRORS



           The _fwide_() function may fail if:
    
           **EBADF** The _stream_ argument is not a valid stream.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           A call to _fwide_() with _mode_ set to zero can be used to determine
           the current orientation of a stream.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# mblen

## NAME



           mblen - determine number of bytes in next multibyte character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int mblen(** size_t n;
                     **const char** _s_**[**_n_**], size_t** _n_**);**
    


## DESCRIPTION



           If _s_ is not NULL, the **mblen**() function inspects at most _n_ bytes of
           the multibyte string starting at _s_ and extracts the next complete
           multibyte character.  It uses a static anonymous shift state known
           only to the **mblen**() function.  If the multibyte character is not
           the null wide character, it returns the number of bytes that were
           consumed from _s_.  If the multibyte character is the null wide
           character, it returns 0.
    
           If the _n_ bytes starting at _s_ do not contain a complete multibyte
           character, **mblen**() returns -1.  This can happen even if _n_ is
           greater than or equal to _MB_CUR_MAX_ , if the multibyte string
           contains redundant shift sequences.
    
           If the multibyte string starting at _s_ contains an invalid
           multibyte sequence before the next complete character, **mblen**()
           also returns -1.
    
           If _s_ is NULL, the **mblen**() function resets the shift state, known
           to only this function, to the initial state, and returns nonzero
           if the encoding has nontrivial shift state, or zero if the
           encoding is stateless.
    


## RETURN VALUE



           The **mblen**() function returns the number of bytes parsed from the
           multibyte sequence starting at _s_ , if a non-null wide character was
           recognized.  It returns 0, if a null wide character was
           recognized.  It returns -1, if an invalid multibyte sequence was
           encountered or if it couldn't parse a complete multibyte
           character.
    


## ATTRIBUTES



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


## VERSIONS



           The function mbrlen(3) provides a better interface to the same
           functionality.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **mblen**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# probe::socket.readv

## NAME



           probe::socket.readv - Receiving a message via **sock_readv**
    


## SYNOPSIS



           socket.readv
    


## VALUES



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


## CONTEXT



           The message sender
    


## DESCRIPTION



           Fires at the beginning of receiving a message on a socket via the
           **sock_readv** function
    


* * *