tripathysagar/man_text huggingface dataset:
# gnutls_set_default_priority

## NAME



           gnutls_set_default_priority - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_set_default_priority(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Sets the default priority on the ciphers, key exchange methods,
           and macs. This is the recommended method of setting the defaults,
           in order to promote consistency between applications using GnuTLS,
           and to allow GnuTLS using applications to update settings in par
           with the library. For client applications which require maximum
           compatibility consider calling
           **gnutls_session_enable_compatibility_mode()** after this function.
    
           For an application to specify additional options to priority
           string consider using **gnutls_set_default_priority_append()**.
    
           To allow a user to override the defaults (e.g., when a user
           interface or configuration file is available), the functions
           **gnutls_priority_set_direct()** or **gnutls_priority_set()** can be used.
    


## RETURNS



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


## SINCE



           2.1.4
    


* * *
# probe::ioscheduler.elv_add_request.tp

## NAME



           probe::ioscheduler.elv_add_request.tp - tracepoint based probe to
           indicate a request is added to the request queue.
    


## SYNOPSIS



           ioscheduler.elv_add_request.tp
    


## VALUES



           _q_
               Pointer to request queue.
    
           _name_
               Name of the probe point
    
           _elevator_name_
               The type of I/O elevator currently enabled.
    
           _rq_
               Address of request.
    
           _disk_major_
               Disk major no of request.
    
           _rq_flags_
               Request flags.
    
           _disk_minor_
               Disk minor number of request.
    


* * *
# acl_calc_mask

## NAME



           **acl_calc_mask** — calculate the file group class mask
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_calc_mask**(_acl_t *acl_p_)
    


## DESCRIPTION



           The **acl_calc_mask**() function calculates and sets the permissions
           associated with the ACL_MASK ACL entry of the ACL referred to by
           _acl_p_.  The value of the new permissions is the union of the
           permissions granted by all entries of tag type ACL_GROUP,
           ACL_GROUP_OBJ, or ACL_USER.  If the ACL referred to by _acl_p_
           already contains an ACL_MASK entry, its permissions are
           overwritten; if it does not contain an ACL_MASK entry, one is
           added.
    
           If the ACL referred to by _acl_p_ does not contain enough space for
           the new ACL entry, then additional working storage may be
           allocated. If the working storage cannot be increased in the
           current location, then it may be relocated and the previous
           working storage is released and a pointer to the new working
           storage is returned via _acl_p_.
    
           The order of existing entries in the ACL is undefined after this
           function.
    
           Any existing ACL entry descriptors that refer to entries in the
           ACL continue to refer to those entries. Any existing ACL pointers
           that refer to the ACL referred to by _acl_p_ continue to refer to
           the ACL.
    


## RETURN VALUE



           The **acl_calc_mask**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_calc_mask**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    
           [ENOMEM]           The **acl_calc_mask**() function is unable to
                              allocate the memory required for an ACL_MASK
                              ACL entry.
    


## STANDARDS



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


* * *
# libpfm_arm_ac72

## NAME



           libpfm_arm_ac72 - support for Arm Cortex A72 PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the ARM Cortex A72 core PMU.
    
           This PMU supports 6 counters and privilege levels filtering.  It
           can operate in both 32 and 64 bit modes.
    


## MODIFIERS



           The following modifiers are supported on ARM Cortex A72:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *
# gnutls_system_recv_timeout

## NAME



           gnutls_system_recv_timeout - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_system_recv_timeout(gnutls_transport_ptr_t** _ptr_**,**
           **unsigned int** _ms_**);**
    


## ARGUMENTS



           gnutls_transport_ptr_t ptr
                       A file descriptor (wrapped in a gnutls_transport_ptr_t
                       pointer)
    
           unsigned int ms
                       The number of milliseconds to wait.
    


## DESCRIPTION



           Wait for data to be received from the provided socket ( _ptr_ )
           within a timeout period in milliseconds, using **select()** on the
           provided  _ptr_ .
    
           This function is provided as a helper for constructing custom
           callbacks for **gnutls_transport_set_pull_timeout_function()** , which
           can be used if you rely on socket file descriptors.
    
           Returns -1 on error, 0 on timeout, positive value if data are
           available for reading.
    


## SINCE



           3.4.0
    


* * *
# form_variables

## NAME



           **TYPE_ALNUM** , **TYPE_ALPHA** , **TYPE_ENUM** , **TYPE_INTEGER** , **TYPE_IPV4** ,
           **TYPE_NUMERIC** , **TYPE_REGEXP** - form system global variables
    


## SYNOPSIS



           **#include <form.h>**
    
           **FIELDTYPE * TYPE_ALNUM;**
           **FIELDTYPE * TYPE_ALPHA;**
           **FIELDTYPE * TYPE_ENUM;**
           **FIELDTYPE * TYPE_INTEGER;**
           **FIELDTYPE * TYPE_IPV4;**
           **FIELDTYPE * TYPE_NUMERIC;**
           **FIELDTYPE * TYPE_REGEXP;**
    


## DESCRIPTION



           These  are  building  blocks for the form library, defining fields
           that can be created using the **form_fieldtype**(3X) functions.   Each
           provides  functions for field- and character-validation, according
           to the given datatype.
    
       **TYPE_ALNUM**
           This holds alphanumeric data.
    
       **TYPE_ALPHA**
           This holds alphabetic data.
    
       **TYPE_ENUM**
           This holds an enumerated type.
    
       **TYPE_INTEGER**
           This holds a decimal integer.
    
       **TYPE_IPV4**
           This holds an IPv4 internet address, e.g., "127.0.0.1".
    
       **TYPE_NUMERIC**
           This holds a decimal number, with optional sign and decimal point.
    
       **TYPE_REGEXP**
           This holds a regular expression.
    


## PORTABILITY



           The **TYPE_IPV4** variable is an extension not provided by  older  im‐
           plementations of the form library.
    


* * *
# utimensat

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



           utimensat, utimes — set file access and modification times
    


## SYNOPSIS



           #include <sys/stat.h>
    
           int utimensat(int _fd_ , const char *_path_ , const struct timespec _times_[2],
               int _flag_);
    
           #include <sys/time.h>
    
           int utimes(const char *_path_ , const struct timeval _times_[2]);
    


## DESCRIPTION



           Refer to futimens(3p).
    


* * *
# rdma_join_multicast

## NAME



           rdma_join_multicast - Joins a multicast group.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_join_multicast (struct rdma_cm_id ***_id_**, struct sockaddr**
           *****_addr_**, void ***_context_**);**
    


## ARGUMENTS



           id          Communication identifier associated with the request.
    
           addr        Multicast address identifying the group to join.
    
           context     User-defined context associated with the join request.
    


## DESCRIPTION



           Joins a multicast group and attaches an associated QP to the
           group.
    


## RETURN VALUE



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


## NOTES



           Before joining a multicast group, the rdma_cm_id must be bound to
           an RDMA device by calling rdma_bind_addr or rdma_resolve_addr.
           Use of rdma_resolve_addr requires the local routing tables to
           resolve the multicast address to an RDMA device, unless a specific
           source address is provided.  The user must call
           rdma_leave_multicast to leave the multicast group and release any
           multicast resources.  After the join operation completes, if a QP
           is associated with the rdma_cm_id, it is automatically attached to
           the multicast group when the multicast event is retrieved by the
           user.  Otherwise, the user is responsible for calling
           ibv_attach_mcast to bind the QP to the multicast group.  The join
           context is returned to the user through the private_data field in
           the rdma_cm_event.
    


* * *
# gnutls_anon_free_client_credentials

## NAME



           gnutls_anon_free_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_anon_free_client_credentials(gnutls_anon_client_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_anon_client_credentials_t sc
                       is a **gnutls_anon_client_credentials_t** type.
    


## DESCRIPTION



           Free a gnutls_anon_client_credentials_t structure.
    


* * *
# function::user_uint64

## NAME



           function::user_uint64 - Retrieves an unsigned 64-bit integer value
           stored in user space
    


## SYNOPSIS



               user_uint64:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned 64-bit integer
               from
    


## DESCRIPTION



           Returns the unsigned 64-bit integer value from a given user space
           address. Returns zero when user space data is not accessible.
    


* * *
# gnutls_x509_trust_list_add_trust_mem

## NAME



           gnutls_x509_trust_list_add_trust_mem - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_add_trust_mem(gnutls_x509_trust_list_t**
           _list_**, const gnutls_datum_t ***_cas_**, const gnutls_datum_t ***_crls_**,**
           **gnutls_x509_crt_fmt_t** _type_**, unsigned int** _tl_flags_**, unsigned int**
           _tl_vflags_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const gnutls_datum_t * cas
                       A buffer containing a list of CAs (optional)
    
           const gnutls_datum_t * crls
                       A buffer containing a list of CRLs (optional)
    
           gnutls_x509_crt_fmt_t type
                       The format of the certificates
    
           unsigned int tl_flags
                       flags from **gnutls_trust_list_flags_t**
    
           unsigned int tl_vflags
                       gnutls_certificate_verify_flags if flags specifies
                       GNUTLS_TL_VERIFY_CRL
    


## DESCRIPTION



           This function will add the given certificate authorities to the
           trusted list.
    
           If this function is used **gnutls_x509_trust_list_deinit()** must be
           called with parameter  _all_ being 1.
    


## RETURNS



           The number of added elements is returned.
    


## SINCE



           3.1
    


* * *
# ibv_modify_qp_rate_limit

## NAME



           ibv_modify_qp_rate_limit - modify the send rate limits attributes
           of a queue pair (QP)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **int ibv_modify_qp_rate_limit(struct ibv_qp** _*qp_**, struct ibv_qp_rate_limit_attr** _*attr_**);**
    


## DESCRIPTION



           **ibv_modify_qp_rate_limit()** modifies the send rate limiting packet
           pacing attributes of QP _qp_ with the attributes in _attr_.  The
           argument _attr_ is an ibv_qp_rate_limit_attr struct, as defined in
           <infiniband/verbs.h>.
    
           The _rate_limit_ defines the MAX send rate this QP will send as long
           as the link in not blocked and there are work requests in send
           queue.
    
           Finer control for shaping the rate limit of a QP is achieved by
           defining the _max_burst_sz_ , single burst max bytes size and the
           _typical_pkt_sz_ , typical packet bytes size. These allow the device
           to adjust the inter-burst gap delay required to correctly shape
           the scheduling of sends to the wire in order to reach for
           requested application requirements.
    
           Setting a value of 0 for _max_burst_sz_ or _typical_pkt_sz_ will use
           the devices defaults.  _typical_pkt_sz_ will default to the port's
           MTU value.
    
           struct ibv_qp_rate_limit_attr {
                   uint32_t        rate_limit;     /* kbps */
                   uint32_t        max_burst_sz;   /* bytes */
                   uint16_t        typical_pkt_sz; /* bytes */
           };
    


## RETURN VALUE



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


## ERRORS



       **EINVAL**
           Invalid arguments.
    
       **EOPNOTSUPP**
           Function is not implemented for this device.  (ENOSYS may
           sometimes be returned by old versions of libibverbs).
    


* * *
# cap_init

## NAME



           cap_init, cap_free, cap_dup - capability data object storage
           management
    


## SYNOPSIS



           #include <sys/capability.h>
    
           cap_t cap_init(void);
           int cap_free(void *obj_d);
           cap_t cap_dup(cap_t cap_p);
    
           Link with _-lcap_.
    


## DESCRIPTION



           The capabilities associated with a file or process are never
           edited directly.  Instead, working storage is allocated to contain
           a representation of the capability state.  Capabilities are edited
           and manipulated only within this working storage area.  Once
           editing of the capability state is complete, the updated
           capability state is used to replace the capability state
           associated with the file or process.
    
           **cap_init**() creates a capability state in working storage and
           returns a pointer to the capability state.  The initial value of
           all flags are cleared.  The caller should free any releasable
           memory, when the capability state in working storage is no longer
           required, by calling **cap_free**() with the _cap_t_ as an argument.
    
           **cap_free**() liberates any releasable memory that has been allocated
           to the capability state identified by _obj_d_.  The _obj_d_ argument
           may identify either a _cap_t_ entity, or a _char *_ entity allocated
           by the **cap_to_text**() function.
    
           **cap_dup**() returns a duplicate capability state in working storage
           given by the source object _cap_p_ , allocating any memory necessary,
           and returning a pointer to the newly created capability state.
           Once duplicated, no operation on either capability state affects
           the other in any way.  When the duplicated capability state in
           working storage is no longer required, the caller should free any
           releasable memory by calling **cap_free**() with the _cap_t_ as an
           argument.
    


## RETURN VALUE



           **cap_init**() and **cap_dup**() return a non-NULL value on success, and
           NULL on failure.
    
           **cap_free**() returns zero on success, and -1 on failure.
    
           On failure, _errno_ is set to **EINVAL** or **ENOMEM**.
    


## CONFORMING TO



           These functions are specified in the withdrawn POSIX.1e draft
           specification.
    


* * *
# gnutls_decode_gost_rs_value

## NAME



           gnutls_decode_gost_rs_value - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_decode_gost_rs_value(const gnutls_datum_t ***_sig_value_**,**
           **gnutls_datum_t ***_r_**, gnutls_datum_t ***_s_**);**
    


## ARGUMENTS



           const gnutls_datum_t * sig_value
                       will holds a GOST signature according to RFC 4491
                       section 2.2.2
    
           gnutls_datum_t * r
                       will contain the r value
    
           gnutls_datum_t * s
                       will contain the s value
    


## DESCRIPTION



           This function will decode the provided  _sig_value_ , into  _r_ and  _s_
           elements.  See RFC 4491 section 2.2.2 for the format of signature
           value.
    
           The output values may be padded with a zero byte to prevent them
           from being interpreted as negative values. The value should be
           deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# pcre2_serialize_decode

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int32_t pcre2_serialize_decode(pcre2_code ****_codes_**,**
             **int32_t** _number_of_codes_**, const uint8_t ***_bytes_**,**
             **pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function decodes a serialized set of compiled patterns back
           into a list of individual patterns. This is possible only on a
           host that is running the same version of PCRE2, with the same code
           unit width, and the host must also have the same endianness,
           pointer width and PCRE2_SIZE type. The arguments for
           **pcre2_serialize_decode()** are:
    
             _codes_            pointer to a vector in which to build the list
             _number_of_codes_  number of slots in the vector
             _bytes_            the serialized byte stream
             _gcontext_         pointer to a general context or NULL
    
           The _bytes_ argument must point to a block of data that was
           originally created by **pcre2_serialize_encode()** , though it may have
           been saved on disc or elsewhere in the meantime. If there are more
           codes in the serialized data than slots in the list, only those
           compiled patterns that will fit are decoded. The yield of the
           function is the number of decoded patterns, or one of the
           following negative error codes:
    
             PCRE2_ERROR_BADDATA   _number_of_codes_ is zero or less
             PCRE2_ERROR_BADMAGIC  mismatch of id bytes in _bytes_
             PCRE2_ERROR_BADMODE   mismatch of variable unit size or PCRE
           version
             PCRE2_ERROR_NOMEMORY  memory allocation failed
             PCRE2_ERROR_NULL      _codes_ or _bytes_ is NULL
    
           PCRE2_ERROR_BADMAGIC may mean that the data is corrupt, or that it
           was compiled on a system with different endianness.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the serialization functions in
           the **pcre2serialize** page.
    


* * *
# gnutls_transport_is_ktls_enabled

## NAME



           gnutls_transport_is_ktls_enabled - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_transport_ktls_enable_flags_t**
           **gnutls_transport_is_ktls_enabled(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Checks if KTLS is now enabled and was properly inicialized.
    


## RETURNS



           **GNUTLS_KTLS_RECV** , **GNUTLS_KTLS_SEND** , **GNUTLS_KTLS_DUPLEX** , otherwise
           0
    


## SINCE



           3.7.3
    


* * *
# tapset::tcpmib

## NAME



           tapset::tcpmib - systemtap tcpmib tapset
    


## DESCRIPTION



           **tcpmib_get_state**
                  Get a socket's state
    
                  See function::tcpmib_get_state(3stap)
                   for details.
    
           **tcpmib_local_addr**
                  Get the source address
    
                  See function::tcpmib_local_addr(3stap)
                   for details.
    
           **tcpmib_remote_addr**
                  Get the remote address
    
                  See function::tcpmib_remote_addr(3stap)
                   for details.
    
           **tcpmib_local_port**
                  Get the local port
    
                  See function::tcpmib_local_port(3stap)
                   for details.
    
           **tcpmib_remote_port**
                  Get the remote port
    
                  See function::tcpmib_remote_port(3stap)
                   for details.
    
           **tcpmib.ActiveOpens**
                  Count an active opening of a socket
    
                   See probe::tcpmib.ActiveOpens(3stap)
                   for details.
    
           **tcpmib.AttemptFails**
                  Count a failed attempt to open a socket
    
                   See probe::tcpmib.AttemptFails(3stap)
                   for details.
    
           **tcpmib.CurrEstab**
                  Update the count of open sockets
    
                   See probe::tcpmib.CurrEstab(3stap)
                   for details.
    
           **tcpmib.EstabResets**
                  Count the reset of a socket
    
                   See probe::tcpmib.EstabResets(3stap)
                   for details.
    
           **tcpmib.InSegs**
                  Count an incoming tcp segment
    
                   See probe::tcpmib.InSegs(3stap)
                   for details.
    
           **tcpmib.OutRsts**
                  Count the sending of a reset packet
    
                   See probe::tcpmib.OutRsts(3stap)
                   for details.
    
           **tcpmib.OutSegs**
                  Count the sending of a TCP segment
    
                   See probe::tcpmib.OutSegs(3stap)
                   for details.
    
           **tcpmib.PassiveOpens**
                  Count the passive creation of a socket
    
                   See probe::tcpmib.PassiveOpens(3stap)
                   for details.
    
           **tcpmib.RetransSegs**
                  Count the retransmission of a TCP segment
    
                   See probe::tcpmib.RetransSegs(3stap)
                   for details.
    


* * *
# putpwent

## NAME



           putpwent - write a password file entry
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
           **#include <sys/types.h>**
           **#include <pwd.h>**
    
           **int putpwent(const struct passwd *restrict** _p_**, FILE *restrict** _stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **putpwent**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _SVID_SOURCE
    


## DESCRIPTION



           The **putpwent**() function writes a password entry from the structure
           _p_ in the file associated with _stream_.
    
           The _passwd_ structure is defined in _< pwd.h>_ as follows:
    
               struct passwd {
                   char    *pw_name;        /* username */
                   char    *pw_passwd;      /* user password */
                   uid_t    pw_uid;         /* user ID */
                   gid_t    pw_gid;         /* group ID */
                   char    *pw_gecos;       /* real name */
                   char    *pw_dir;         /* home directory */
                   char    *pw_shell;       /* shell program */
               };
    


## RETURN VALUE



           The **putpwent**() function returns 0 on success.  On failure, it
           returns -1, and _errno_ is set to indicate the error.
    


## ERRORS



           **EINVAL** Invalid (NULL) argument given.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# curs_in_wchstr

## NAME



           **in_wchstr** , **in_wchnstr** , **win_wchstr** , **win_wchnstr** , **mvin_wchstr** ,
           **mvin_wchnstr** , **mvwin_wchstr** , **mvwin_wchnstr** - get an array of
           complex characters and renditions from a curses window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int in_wchstr(cchar_t ***_wchstr_**);**
           **int in_wchnstr(cchar_t ***_wchstr_**, int** _n_**);**
           **int win_wchstr(WINDOW ***_win_**, cchar_t ***_wchstr_**);**
           **int win_wchnstr(WINDOW ***_win_**, cchar_t ***_wchstr_**, int** _n_**);**
    
           **int mvin_wchstr(int** _y_**, int** _x_**, cchar_t ***_wchstr_**);**
           **int mvin_wchnstr(int** _y_**, int** _x_**, cchar_t ***_wchstr_**, int** _n_**);**
           **int mvwin_wchstr(WINDOW ***_win_**, int** _y_**, int** _x_**, cchar_t ***_wchstr_**);**
           **int mvwin_wchnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, cchar_t ***_wchstr_ , int _n_**);**
    


## DESCRIPTION



           These  functions  return an array of complex characters in _wchstr_ ,
           starting at the current cursor position in the named window.   At‐
           tributes (rendition) are stored with the characters.
    
           The  **in_wchnstr** ,  **mvin_wchnstr** , **mvwin_wchnstr** and **win_wchnstr** fill
           the array with at most _n_ **cchar_t** elements.
    


## NOTES



           Note that all routines except **win_wchnstr** may be macros.
    
           Reading a line that overflows the array pointed to by _wchstr_  with
           **in_wchstr** ,  **mvin_wchstr** ,  **mvwin_wchstr** or **win_wchstr** causes unde‐
           fined results.  Therefore, the use  of  **in_wchnstr** ,  **mvin_wchnstr** ,
           **mvwin_wchnstr** , or **win_wchnstr** is recommended.
    


## RETURN VALUE



           Upon successful completion, these functions return **OK**.  Otherwise,
           they return **ERR**.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** ,  and return an error if the position is outside the window,
           or if the window pointer is null.
    


## PORTABILITY



           The XSI Curses defines no error conditions.   This  implementation
           checks for null pointers, returning **ERR** in that case.
    


* * *
# iswspace

## NAME



           iswspace - test for whitespace wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswspace(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswspace**() function is the wide-character equivalent of the
           isspace(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "space".
    
           The wide-character class "space" is disjoint from the wide-
           character class "graph" and therefore also disjoint from its
           subclasses "alnum", "alpha", "upper", "lower", "digit", "xdigit",
           "punct".
    
           The wide-character class "space" contains the wide-character class
           "blank".
    
           The wide-character class "space" always contains at least the
           space character and the control characters '\f', '\n', '\r', '\t',
           and '\v'.
    


## RETURN VALUE



           The **iswspace**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "space".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# rint

## NAME



           nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - round to
           nearest integer
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double nearbyint(double** _x_**);**
           **float nearbyintf(float** _x_**);**
           **long double nearbyintl(long double** _x_**);**
    
           **double rint(double** _x_**);**
           **float rintf(float** _x_**);**
           **long double rintl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **nearbyint**(), **nearbyintf**(), **nearbyintl**():
               _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE
    
           **rint**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || _XOPEN_SOURCE >= 500
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    
           **rintf**(), **rintl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The **nearbyint**(), **nearbyintf**(), and **nearbyintl**() functions round
           their argument to an integer value in floating-point format, using
           the current rounding direction (see fesetround(3)) and without
           raising the _inexact_ exception.  When the current rounding
           direction is to nearest, these functions round halfway cases to
           the even integer in accordance with IEEE-754.
    
           The **rint**(), **rintf**(), and **rintl**() functions do the same, but will
           raise the _inexact_ exception (**FE_INEXACT** , checkable via
           fetestexcept(3)) when the result differs in value from the
           argument.
    


## RETURN VALUE



           These functions return the rounded integer value.
    
           If _x_ is integral, +0, -0, NaN, or infinite, _x_ itself is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_pcert_import_rawpk

## NAME



           gnutls_pcert_import_rawpk - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_rawpk(gnutls_pcert_st ***_pcert_**,**
           **gnutls_pubkey_t** _pubkey_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The pcert structure to import the data into.
    
           gnutls_pubkey_t pubkey
                       The raw public-key in **gnutls_pubkey_t** format to be
                       imported
    
           unsigned int flags
                       zero for now
    


## DESCRIPTION



           This convenience function will import (i.e. convert) the given raw
           public key  _pubkey_ into a **gnutls_pcert_st** structure. The structure
           must be deinitialized afterwards using **gnutls_pcert_deinit()**. The
           given  _pubkey_ must not be deinitialized because it will be
           associated with the given  _pcert_ structure and will be
           deinitialized with it.
    


## RETURNS



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


## SINCE



           3.6.6
    


* * *
# io_uring_prep_listen

## NAME



           io_uring_prep_listen - prepare a listen request
    


## SYNOPSIS



           **#include <sys/socket.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_listen(struct io_uring_sqe ***_sqe_**,**
                                     **int** _sockfd_**,**
                                     **int** _backlog_**);**
    


## DESCRIPTION



           The io_uring_prep_listen(3) function prepares a listen request.
           The submission queue entry _sqe_ is setup to place the socket file
           descriptor pointed by _sockfd_ into a state to accept incoming
           connections.  The parameter _backlog_ , defines the maximum length of
           the queue of pending connections.
    
           This function prepares an async listen(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.
    


* * *
# libpfm_intel_bdx_unc_irp

## NAME



           libpfm_intel_bdx_unc_irp - support for Intel Broadwell Server IRP
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_irp**
           **PMU desc: Intel Broadwell Server IRP uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell Server IRP (IIO
           coherency) uncore PMU .  This PMU model only exists various
           Broadwell server models (79, 86).
    


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server
           IRP 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 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:255].
    
           **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
    


* * *
# pcre2_code_copy_with_tables

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_code *pcre2_code_copy_with_tables(const pcre2_code ***_code_**);**
    


## DESCRIPTION



    
           This function makes a copy of the memory used for a compiled
           pattern, excluding any memory used by the JIT compiler. Without a
           subsequent call to **pcre2_jit_compile()** , the copy can be used only
           for non-JIT matching.  Unlike **pcre2_code_copy()** , a separate copy
           of the character tables is also made, with the new code pointing
           to it. This memory will be automatically freed when
           **pcre2_code_free()** is called. The yield of the function is NULL if
           _code_ is NULL or if sufficient memory cannot 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.
    


* * *
# significand

## NAME



           significand, significandf, significandl - get mantissa of
           floating-point number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double significand(double** _x_**);**
           **float significandf(float** _x_**);**
           **long double significandl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **significand**(), **significandf**(), **significandl**():
               /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return the mantissa of _x_ scaled to the range
           [**1** , **FLT_RADIX**).  They are equivalent to
    
               scalb(x, (double) -ilogb(x))
    
           This function exists mainly for use in certain standardized tests
           for IEEE 754 conformance.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    
           **significand**()
                  BSD.
    


* * *
# mlx5dv_devx_get_async_cmd_comp

## NAME



           mlx5dv_devx_create_cmd_comp - Create a command completion to be
           used for DEVX asynchronous commands.
    
           mlx5dv_devx_destroy_cmd_comp - Destroy a devx command completion.
    
           mlx5dv_devx_get_async_cmd_comp - Get an asynchronous command
           completion.  # SYNOPSIS
    
                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_cmd_comp {
                      int fd;
                  };
    
                  struct mlx5dv_devx_cmd_comp *
                  mlx5dv_devx_create_cmd_comp(struct ibv_context *context)
    
                  void mlx5dv_devx_destroy_cmd_comp(struct mlx5dv_devx_cmd_comp *cmd_comp)
    
                  struct mlx5dv_devx_async_cmd_hdr {
                      uint64_t    wr_id;
                      uint8_t     out_data[];
                  };
    
                  int mlx5dv_devx_get_async_cmd_comp(struct mlx5dv_devx_cmd_comp *cmd_comp,
                                     struct mlx5dv_devx_async_cmd_hdr *cmd_resp,
                                     size_t cmd_resp_len)
    


## DESCRIPTION



           Create or destroy a command completion to be used for DEVX
           asynchronous commands.
    
           The create verb exposes an mlx5dv_devx_cmd_comp object that can be
           used as part of asynchronous DEVX commands.  This lets an
           application run asynchronously without blocking and once the
           response is ready read it from this object.
    
           The response can be read by the mlx5dv_devx_get_async_cmd_comp()
           API, upon response the _wr_id_ that was supplied upon the
           asynchronous command is returned and the _out_data_ includes the
           data itself.  The application must supply a large enough buffer to
           match any command that was issued on the _cmd_comp_ , its size is
           given by the input _cmd_resp_len_ parameter.
    


## ARGUMENTS



           _context_
    
                  RDMA device context to create the action on.
    
           _cmd_comp_
                  The command completion object.
    
           _cmd_resp_
                  The output data from the asynchronous command.
    
           _cmd_resp_len_
                  The output buffer size to hold the response.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_cmd_comp_ will return a new _struct_
           _mlx5dv_devx_cmd_comp_ object, on error NULL will be returned and
           errno will be set.
    
           Upon success _mlx5dv_devx_get_async_cmd_comp_ will return 0,
           otherwise errno will be returned.
    


* * *
# gnutls_x509_crq_set_key_purpose_oid

## NAME



           gnutls_x509_crq_set_key_purpose_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_key_purpose_oid(gnutls_x509_crq_t** _crq_**,**
           **const void ***_oid_**, unsigned int** _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate of type **gnutls_x509_crq_t**
    
           const void * oid
                       a pointer to a null-terminated string that holds the
                       OID
    
           unsigned int critical
                       Whether this extension will be critical or not
    


## DESCRIPTION



           This function will set the key purpose OIDs of the Certificate.
           These are stored in the Extended Key Usage extension (2.5.29.37)
           See the GNUTLS_KP_* definitions for human readable names.
    
           Subsequent calls to this function will append OIDs to the OID
           list.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# gnutls_pkcs11_privkey_generate2

## NAME



           gnutls_pkcs11_privkey_generate2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_generate2(const char ***_url_**,**
           **gnutls_pk_algorithm_t** _pk_**, unsigned int** _bits_**, const char ***_label_**,**
           **gnutls_x509_crt_fmt_t** _fmt_**, gnutls_datum_t ***_pubkey_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           const char * url
                       a token URL
    
           gnutls_pk_algorithm_t pk
                       the public key algorithm
    
           unsigned int bits
                       the security bits
    
           const char * label
                       a label
    
           gnutls_x509_crt_fmt_t fmt
                       the format of output params. PEM or DER
    
           gnutls_datum_t * pubkey
                       will hold the public key (may be **NULL**)
    
           unsigned int flags
                       zero or an OR'ed sequence of **GNUTLS_PKCS11_OBJ_FLAGs**
    


## DESCRIPTION



           This function will generate a private key in the specified by the
           _url_ token. The private key will be generate within the token and
           will not be exportable. This function will store the DER-encoded
           public key in the SubjectPublicKeyInfo format in  _pubkey_ . The
           _pubkey_ should be deinitialized using **gnutls_free()**.
    
           Note that when generating an elliptic curve key, the curve can be
           substituted in the place of the bits parameter using the
           **GNUTLS_CURVE_TO_BITS()** macro.
    


## RETURNS



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


## SINCE



           3.1.5
    


* * *