tripathysagar/man_text huggingface dataset:
# gnutls_x509_crt_get_key_purpose_oid

## NAME



           gnutls_x509_crt_get_key_purpose_oid - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function will extract the key purpose OIDs of the Certificate
           specified by the given index.  These are stored in the Extended
           Key Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions
           for human readable names.
    
           If  _oid_ is null then only the size will be filled. The  _oid_
           returned will be null terminated, although  _oid_size_ will not
           account for the trailing null.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the *oid_size will be updated with the
           required size.  On success 0 is returned.
    


* * *
# gnutls_x509_crt_get_issuer_dn

## NAME



           gnutls_x509_crt_get_issuer_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_dn(gnutls_x509_crt_t** _cert_**, char ***
           _buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           char * buf  a pointer to a structure to hold the name (may be
                       null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will copy the name of the Certificate issuer in the
           provided buffer. 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.
    
           If  _buf_ is null then only the size will be filled.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_x509_crt_get_issuer_dn3()**.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the  _buf_size_ will be updated with the
           required size. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the DN
           does not exist, or another error value on error. On success 0 is
           returned.
    


* * *
# function::ipmib_local_addr

## NAME



           function::ipmib_local_addr - Get the local ip address
    


## SYNOPSIS



               ipmib_local_addr:long(skb:long,SourceIsLocal:long)
    


## ARGUMENTS



           _skb_
               pointer to a struct sk_buff
    
           _SourceIsLocal_
               flag to indicate whether local operation
    


## DESCRIPTION



           Returns the local ip address _skb_.
    


* * *
# clock_t

## NAME



           clock_t - system time
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **typedef** /* ... */ **clock_t;**
    


## DESCRIPTION



           Used for system time in clock ticks or **CLOCKS_PER_SEC**(defined in
           _< time.h>_).  According to POSIX, it is an integer type or a real-
           floating type.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< sys/types.h>_ and
           _< sys/times.h>_.
    


* * *
# pcre2_jit_stack_assign

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_jit_stack_assign(pcre2_match_context ***_mcontext_**,**
             **pcre2_jit_callback** _callback_function_**, void ***_callback_data_**);**
    


## DESCRIPTION



    
           This function provides control over the memory used by JIT as a
           run-time stack when **pcre2_match()** or **pcre2_jit_match()** is called
           with a pattern that has been successfully processed by the JIT
           compiler. The information that determines which stack is used is
           put into a match context that is subsequently passed to a matching
           function. The arguments of this function are:
    
             mcontext       a pointer to a match context
             callback       a callback function
             callback_data  a JIT stack or a value to be passed to the
           callback
    
           If _mcontext_ is NULL, the function returns immediately, without
           doing anything.
    
           If _callback_ is NULL and _callback_data_ is NULL, an internal 32KiB
           block on the machine stack is used.
    
           If _callback_ is NULL and _callback_data_ is not NULL, _callback_data_
           must be a valid JIT stack, the result of calling
           **pcre2_jit_stack_create()**.
    
           If _callback_ not NULL, it is called with _callback_data_ as an
           argument at the start of matching, in order to set up a JIT stack.
           If the result is NULL, the internal 32KiB stack is used; otherwise
           the return value must be a valid JIT stack, the result of calling
           **pcre2_jit_stack_create()**.
    
           You may safely use the same JIT stack for multiple patterns, as
           long as they are all matched in the same thread. In a multithread
           application, each thread must use its own JIT stack. For more
           details, see the **pcre2jit** page.
    
           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.
    


* * *
# gnutls_load_file

## NAME



           gnutls_load_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_load_file(const char ***_filename_**, gnutls_datum_t ***
           _data_**);**
    


## ARGUMENTS



           const char * filename
                       the name of the file to load
    
           gnutls_datum_t * data
                       Where the file will be stored
    


## DESCRIPTION



           This function will load a file into a datum. The data are zero
           terminated but the terminating null is not included in length.
           The returned data are allocated using **gnutls_malloc()**.
    
           Note that this function is not designed for reading sensitive
           materials, such as private keys, on practical applications. When
           the reading fails in the middle, the partially loaded content
           might remain on memory.
    


## RETURNS



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


* * *
# pcre2_converted_pattern_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_converted_pattern_free(PCRE2_UCHAR ***_converted_pattern_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It frees the memory occupied by a converted pattern
           that was obtained by calling **pcre2_pattern_convert()** with
           arguments that caused it to place the converted pattern into newly
           obtained heap memory. If the argument is NULL, the function
           returns immediately without doing anything.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# pmunitsstr

## NAME



           **pmUnitsStr** , **pmUnitsStr_r - convert a performance metric's units**
           **into a string**
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmUnitsStr(const pmUnits ***_pu_**);**
           **char *pmUnitsStr_r(const pmUnits ***_pu_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  encoding  of  a performance metric's dimensionality and scale
           uses a _pmUnits_ structure; see pmLookupDesc(3).
    
           As an aid to labeling graphs and tables, or  for  error  messages,
           **pmUnitsStr** will  take  a dimension and scale specification as per
           _pu_ , and return the corresponding text  string.   The  **pmUnitsStr_r**
           function  does  the same, but stores the result in a user-supplied
           buffer _buf_ of length _buflen_ , which should have room for  at  least
           60  bytes.   If  _buflen_  is less than 60 then **pmUnitsStr_r** returns
           **NULL** and _buf_ is not changed.
    
           For example _{1, -2, 0, PM_SPACE_MBYTE,_  _PM_TIME_SEC,_  _0}_ ,  as  the
           value of _*pu_ gives the result string _Mbyte / sec^2_.
    
           The string value result from **pmUnitsStr** is held in a single static
           buffer, so the returned value is only valid until the next call to
           **pmUnitsStr**.
    
           If the ``count'' dimension is non-zero, and the ``count'' scale is
           not zero, then the text string will include a decimal scaling fac‐
           tor, e.g.  _count x 10^6_.
    
           As  a  special  case, if all components of the dimension are zero,
           then the ``count'' scale is used to produce  the  text.   If  this
           scale  is zero the result is an empty string, otherwise the result
           is of the form _x1 0^2_.
    


## NOTES



           **pmUnitsStr** returns a pointer to a static buffer and hence  is  not
           thread-safe.   Multi-threaded applications should use **pmUnitsStr_r**
           instead.
    


* * *
# io_uring_prep_unlinkat

## NAME



           io_uring_prep_unlinkat - prepare an unlinkat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_unlinkat(struct io_uring_sqe ***_sqe_**,**
                                       **int** _dirfd_**,**
                                       **const char ***_path_**,**
                                       **int** _flags_**);**
    
           **void io_uring_prep_unlink(struct io_uring_sqe ***_sqe_**,**
                                     **const char ***_path_**,**
                                     **int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_unlinkat(3) function prepares an unlinkat
           request. The submission queue entry _sqe_ is setup to use the
           directory file descriptor pointed to by _dirfd_ to start an unlinkat
           operation on the path identified by _path_ and using the flags given
           in _flags_.
    
           The io_uring_prep_unlink(3) function prepares an unlink request.
           The submission queue entry _sqe_ is setup to start an unlinkat
           operation on the path identified by _path_ relative to the current
           working directory and using the flags given in _flags_.
    
           These functions prepare an async unlinkat(2) or unlink(2) request.
           See those man pages for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



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


* * *
# mbsinit

## NAME



           mbsinit - test for initial shift state
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **int mbsinit(const mbstate_t ***_ps_**);**
    


## DESCRIPTION



           The function **mbsinit**() tests whether _*ps_ corresponds to an initial
           state.
    


## RETURN VALUE



           **mbsinit**() returns nonzero if _*ps_ is an initial state, or if _ps_ is
           NULL.  Otherwise, it returns 0.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# function::user_int32

## NAME



           function::user_int32 - Retrieves a 32-bit integer value stored in
           user space
    


## SYNOPSIS



               user_int32:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the 32-bit integer from
    


## DESCRIPTION



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


* * *
# euidaccess

## NAME



           euidaccess, eaccess - check effective user's permissions for a
           file
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <unistd.h>**
    
           **int euidaccess(const char ***_path_**, int** _mode_**);**
           **int eaccess(const char ***_path_**, int** _mode_**);**
    


## DESCRIPTION



           Like access(2), **euidaccess**() checks permissions and existence of
           the file identified by its argument _path_.  However, whereas
           access(2) performs checks using the real user and group
           identifiers of the process, **euidaccess**() uses the effective
           identifiers.
    
           _mode_ is a mask consisting of one or more of **R_OK** , **W_OK** , **X_OK** , and
           **F_OK** , with the same meanings as for access(2).
    
           **eaccess**() is a synonym for **euidaccess**(), provided for
           compatibility with some other systems.
    


## RETURN VALUE



           On success (all requested permissions granted), zero is returned.
           On error (at least one bit in _mode_ asked for a permission that is
           denied, or some other error occurred), -1 is returned, and _errno_
           is set to indicate the error.
    


## ERRORS



           As for access(2).
    


## ATTRIBUTES



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


## VERSIONS



           Some other systems have an **eaccess**() function.
    


## STANDARDS



           None.
    


## NOTES



           _Warning_ : Using this function to check a process's permissions on a
           file before performing some operation based on that information
           leads to race conditions: the file permissions may change between
           the two steps.  Generally, it is safer just to attempt the desired
           operation and handle any permission error that occurs.
    
           This function always dereferences symbolic links.  If you need to
           check the permissions on a symbolic link, use faccessat(2) with
           the flags **AT_EACCESS** and **AT_SYMLINK_NOFOLLOW**.
    


* * *
# rdma_leave_multicast

## NAME



           rdma_leave_multicast - Leaves a multicast group.
    


## SYNOPSIS



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


## ARGUMENTS



           id          Communication identifier associated with the request.
    
           addr        Multicast address identifying the group to leave.
    


## DESCRIPTION



           Leaves a multicast group and detaches an associated QP from 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



           Calling this function before a group has been fully joined results
           in canceling the join operation.  Users should be aware that
           messages received from the multicast group may stilled be queued
           for completion processing immediately after leaving a multicast
           group.  Destroying an rdma_cm_id will automatically leave all
           multicast groups.
    


* * *
# libpfm_intel_skx_unc_pcu

## NAME



           libpfm_intel_skx_unc_pcu - support for Intel Skylake X Power
           Controller Unit (PCU) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_pcu**
           **PMU desc: Intel Skylake X Server PCU uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X Server Power Controller
           Unit uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Skylake X server
           PCU 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
    


## Frequency band filtering



           There are 3 events which support frequency band filtering, namely,
           UNC_P_FREQ_BAND0_CYCLES, UNC_P_FREQ_BAND1_CYCLES,
           UNC_P_FREQ_BAND2_CYCLES, UNC_P_FREQ_BAND3_CYCLES. The frequency
           filter (available via the ff modifier) is stored into a PMU shared
           register which hold all 4 possible frequency bands, one per event.
           However, the library generate the encoding for each event
           individually because it processes events one at a time. The caller
           or the underlying kernel interface may have to merge the band
           filter settings to program the filter register properly.
    


* * *
# audit_set_backlog_limit

## NAME



           audit_set_backlog_limit - Set the audit backlog limit
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_backlog_limit(int** _fd_**, uint32_t** _limit_**);"**
    


## DESCRIPTION



           audit_set_backlog_limit sets the queue length for audit events
           awaiting transfer on the descriptor given in _fd_. The _limit_
           argument specifies how many events may be queued. The default
           value is 64 which can potentially be overrun by bursts of
           activity. When the backlog limit is reached, the kernel consults
           the failure_flag to see what action to take.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# probe::workqueue.create

## NAME



           probe::workqueue.create - Creating a new workqueue
    


## SYNOPSIS



           workqueue.create
    


## VALUES



           _cpu_
               cpu for which the worker thread is created
    
           _wq_thread_
               task_struct of the workqueue thread
    


* * *
# catanh

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



           catanh, catanhf, catanhl — complex arc hyperbolic tangent
           functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex catanh(double complex _z_);
           float complex catanhf(float complex _z_);
           long double complex catanhl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex arc hyperbolic tangent
           of _z_ , with branch cuts outside the interval [-1, +1] along the
           real axis.
    


## RETURN VALUE



           These functions shall return the complex arc hyperbolic tangent
           value, in the range of a strip mathematically unbounded along the
           real axis and in the interval [-_i_ π/2, +_i_ π/2] along the imaginary
           axis.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::ioscheduler_trace.elv_issue_request

## NAME



           probe::ioscheduler_trace.elv_issue_request - Fires when a request
           is
    


## SYNOPSIS



           ioscheduler_trace.elv_issue_request
    


## VALUES



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


## DESCRIPTION



           scheduled.
    


* * *
# mitem_value

## NAME



           **set_item_value** , **item_value** - set and get menu item values
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_item_value(ITEM ***_item_**, bool** _value_**);**
           **bool item_value(const ITEM ***_item_**);**
    


## DESCRIPTION



           If you turn off the menu option **O_ONEVALUE**(e.g., with
           **set_menu_opts** or **menu_opts_off** ; see **menu_opts**(3X)), the menu
           becomes multi-valued; that is, more than one item may
           simultaneously be selected.
    
           In a multi_valued menu, you can used **set_item_value** to select the
           given menu item (second argument **TRUE**) or deselect it (second
           argument **FALSE**).
    


## RETURN VALUE



           The function **set_item_value** returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_REQUEST_DENIED**
                The menu driver could not process the request.
    


## NOTES



           The header file **< menu.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# pcap_is_swapped

## NAME



           pcap_is_swapped - find out whether a savefile has the native byte
           order
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_is_swapped**() returns true (**1**) if _p_ refers to a ``savefile''
           that uses a different byte order than the current system.  For a
           live capture, it always returns false (**0**).
    
           It must not be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).
    


## RETURN VALUE



           **pcap_is_swapped**() returns true (**1**) or false (**0**) on success and
           **PCAP_ERROR_NOT_ACTIVATED** if called on a capture handle that has
           been created but not activated.
    


* * *
# gnutls_certificate_allocate_credentials

## NAME



           gnutls_certificate_allocate_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_allocate_credentials(gnutls_certificate_credentials_t**
           *****_res_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t * res
                       is a pointer to a **gnutls_certificate_credentials_t**
                       type.
    


## DESCRIPTION



           Allocate a gnutls_certificate_credentials_t structure.
    


## RETURNS



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


* * *
# probe::socket.readv.return

## NAME



           probe::socket.readv.return - Conclusion of receiving a message via
           **sock_readv**
    


## SYNOPSIS



           socket.readv.return
    


## VALUES



           _family_
               Protocol family value
    
           _success_
               Was receive successful? (1 = yes, 0 = no)
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    
           _size_
               Size of message received (in bytes) or error code if success =
               0
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message receiver.
    


## DESCRIPTION



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


* * *
# pthread_barrierattr_setpshared

## PROLOG



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


## NAME



           pthread_barrierattr_setpshared — set the process-shared attribute
           of the barrier attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_barrierattr_setpshared(pthread_barrierattr_t *_attr_ ,
               int _pshared_);
    


## DESCRIPTION



           Refer to pthread_barrierattr_getpshared(3p).
    


* * *
# pam_acct_mgmt

## NAME



           pam_acct_mgmt - PAM account validation management
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **int pam_acct_mgmt(pam_handle_t ***_pamh_**, int** _flags_**);**
    


## DESCRIPTION



           The **pam_acct_mgmt** function is used to determine if the user's
           account is valid. It checks for authentication token and account
           expiration and verifies access restrictions. It is typically
           called after the user has been authenticated.
    
           The _pamh_ argument is an authentication handle obtained by a prior
           call to pam_start(). The flags argument is the binary or of zero
           or more of the following values:
    
           PAM_SILENT
               Do not emit any messages.
    
           PAM_DISALLOW_NULL_AUTHTOK
               The PAM module service should return PAM_NEW_AUTHTOK_REQD if
               the user has a null authentication token.
    


## RETURN VALUES



           PAM_ACCT_EXPIRED
               User account has expired.
    
           PAM_AUTH_ERR
               Authentication failure.
    
           PAM_NEW_AUTHTOK_REQD
               The user account is valid but their authentication token is
               _expired_. The correct response to this return-value is to
               require that the user satisfies the **pam_chauthtok()** function
               before obtaining service. It may not be possible for some
               applications to do this. In such cases, the user should be
               denied access until such time as they can update their
               password.
    
           PAM_PERM_DENIED
               Permission denied.
    
           PAM_SUCCESS
               The authentication token was successfully updated.
    
           PAM_USER_UNKNOWN
               User unknown to password service.
    


* * *
# function::proc_mem_data

## NAME



           function::proc_mem_data - Program data size (data + stack) in
           pages
    


## SYNOPSIS



           1) proc_mem_data:long()
    
           2) proc_mem_data:long(pid:long)
    


## ARGUMENTS



           _pid_
               The pid of process to examine
    


## DESCRIPTION



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


* * *
# gnutls_srp_base64_decode

## NAME



           gnutls_srp_base64_decode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_srp_base64_decode(const gnutls_datum_t ***_b64_data_**, char**
           *****_result_**, size_t ***_result_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * b64_data
                       contain the encoded data
    
           char * result
                       the place where decoded data will be copied
    
           size_t * result_size
                       holds the size of the result
    


## DESCRIPTION



           This function will decode the given encoded data, using the base64
           encoding found in libsrp.
    
           Note that  _b64_data_ should be null terminated.
    
           Warning!  This base64 encoding is not the "standard" encoding, so
           do not use it for non-SRP purposes.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the buffer given is not long
           enough, or 0 on success.
    


* * *
# function::usymfileline

## NAME



           function::usymfileline - Return the file name and line number of
           an address.
    


## SYNOPSIS



               usymfileline:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the file name and the (approximate) line number of the
           given address, if known. If the file name or the line number
           cannot be found, the hex string representation of the address will
           be returned.
    


* * *
# function::task_ns_gid

## NAME



           function::task_ns_gid - The group identifier of the task as seen
           in a namespace
    


## SYNOPSIS



               task_ns_gid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the group id of the given task as seen in in
           the given user namespace.
    


* * *
# function::vm_fault_contains

## NAME



           function::vm_fault_contains - Test return value for page fault
           reason
    


## SYNOPSIS



               vm_fault_contains:long(value:long,test:long)
    


## ARGUMENTS



           _value_
               the fault_type returned by vm.page_fault.return
    
           _test_
               the type of fault to test for (VM_FAULT_OOM or similar)
    


* * *
# auparse_find_field_next

## NAME



           auparse_find_field_next - find next occurrence of field name
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **const char * auparse_find_field_next(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_find_field_next finds the next occurrence of the
           previously stored field name. It will scan until it reaches the
           last record of the current event.
    


## RETURN VALUE



           Returns NULL field not found. If an error occurs errno will be
           set. Otherwise, it returns a pointer to the text value associated
           with the field.
    


* * *
# gnutls_pkcs11_token_set_pin

## NAME



           gnutls_pkcs11_token_set_pin - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_set_pin(const char ***_token_url_**, const char**
           *****_oldpin_**, const char ***_newpin_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           const char * oldpin
                       old user's PIN
    
           const char * newpin
                       new user's PIN
    
           unsigned int flags
                       one of **gnutls_pin_flag_t**.
    


## DESCRIPTION



           This function will modify or set a user or administrator's PIN for
           the given token.  If it is called to set a PIN for first time the
           oldpin must be **NULL**. When setting the admin's PIN with the
           **GNUTLS_PIN_SO** flag, the  _oldpin_ value must be provided (this
           requirement is relaxed after GnuTLS 3.6.5 since which the PIN will
           be requested if missing).
    


## RETURNS



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


* * *
# efadv_query_cq

## NAME



           efadv_query_cq - Query EFA specific Completion Queue attributes
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  int efadv_query_cq(struct ibv_cq *ibvcq, struct efadv_cq_attr *attr,
                                     uint32_t inlen);
    


## DESCRIPTION



           **efadv_query_cq()** queries device-specific Completion Queue
           attributes.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_cq_attr {
                      uint64_t comp_mask;
                      uint8_t *buffer;
                      uint32_t entry_size;
                      uint32_t num_entries;
                  };
    
           _inlen_  In: Size of struct efadv_cq_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _buffer_ Completion queue buffer.
    
           _entry_size_
                  Size of each completion queue entry.
    
           _num_entries_
                  Maximal number of entries in the completion queue.
    


## RETURN VALUE



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


## NOTES



           • Compatibility mask (comp_mask) is an out field and currently has
             no values.
    


* * *
# io_uring_unregister_ring_fd

## NAME



           io_uring_unregister_ring_fd - unregister a ring file descriptor
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_unregister_ring_fd(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_unregister_ring_fd(3) unregisters the file descriptor of
           the ring.
    
           Unregisters a ring descriptor previously registered with the task.
           This is done automatically when io_uring_queue_exit(3) is called,
           but can also be done to free up space for new ring registrations.
           For more information on ring descriptor registration, see
           io_uring_register_ring_fd(3)
    


## RETURN VALUE



           Returns 1 on success, indicating that one file descriptor was
           unregistered, or **-errno** on error.
    


* * *
# gnutls_digest_get_name

## NAME



           gnutls_digest_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_digest_get_name(gnutls_digest_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t algorithm
                       is a digest algorithm
    


## DESCRIPTION



           Convert a **gnutls_digest_algorithm_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified digest algorithm,
           or **NULL**.
    


* * *
# atan

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



           atan, atanf, atanl — arc tangent function
    


## SYNOPSIS



           #include <math.h>
    
           double atan(double _x_);
           float atanf(float _x_);
           long double atanl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the principal value of the arc
           tangent of their argument _x_.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the arc
           tangent of _x_ in the range [-π/2,π/2] radians.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, _x_ shall be returned.
    
           If _x_ is ±Inf, ±π/2 shall be returned.
    
           If _x_ is subnormal, a range error may occur
           and _x_ should be returned.
    
           If _x_ is not returned, _atan_(), _atanf_(), and _atanl_() shall return an
           implementation-defined value no greater in magnitude than DBL_MIN,
           FLT_MIN, and LDBL_MIN, respectively.
    


## ERRORS



           These functions may fail if:
    
           Range Error The value of _x_ is subnormal.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[ERANGE]**.  If the integer expression (_math_errhandling_
                       & MATH_ERREXCEPT) is non-zero, then the underflow
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::inet_get_ip_source

## NAME



           function::inet_get_ip_source - Provide IP source address string
           for a kernel socket
    


## SYNOPSIS



               inet_get_ip_source:string(sock:long)
    


## ARGUMENTS



           _sock_
               pointer to the kernel socket
    


* * *
# casin

## NAME



           casin, casinf, casinl - complex arc sine
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex casin(double complex** _z_**);**
           **float complex casinf(float complex** _z_**);**
           **long double complex casinl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex arc sine of _z_.  If
           _y = casin(z)_ , then _z = csin(y)_.  The real part of _y_ is chosen in
           the interval [-pi/2,pi/2].
    
           One has:
    
               casin(z) = -i clog(iz + csqrt(1 - z * z))
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# mlx5dv_devx_alloc_msi_vector

## NAME



           mlx5dv_devx_alloc_msi_vector - Allocate an msi vector to be used
           for creating an EQ.
    
           mlx5dv_devx_free_msi_vector - Release an msi vector.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_msi_vector *
                  mlx5dv_devx_alloc_msi_vector(struct ibv_context *ibctx);
    
                  int mlx5dv_devx_free_msi_vector(struct mlx5dv_devx_msi_vector *msi);
    


## DESCRIPTION



           Allocate or free an msi vector to be used for creating an EQ.
    
           The allocate API exposes a mlx5dv_devx_msi_vector object, which
           includes an msi vector and a fd.  The vector can be used as the
           “eqc.intr” field when creating an EQ, while the fd (created as
           non-blocking) can be polled to see once there is some data on that
           EQ.
    


## ARGUMENTS



           _ibctx_  RDMA device context to create the action on.
    
           _msi_    The msi vector object to work on.
    
       **msi_vector**
                  struct mlx5dv_devx_msi_vector {
                      int vector;
                      int fd;
                  };
    
           _vector_ The vector to be used when creating the EQ over the device
                  specification.
    
           _fd_     The FD that will be used for polling.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_alloc_msi_vector_ will return a new _struct_
           _mlx5dv_devx_msi_vector_ ; On error NULL will be returned and errno
           will be set.
    
           Upon success _mlx5dv_devx_free_msi_vector_ will return 0, on error
           errno will be returned.
    


* * *
# rdma_establish

## NAME



           rdma_establish - Complete an active connection request.
    


## SYNOPSIS



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


## DESCRIPTION



           **rdma_establish()** Acknowledge an incoming connection response event
           and complete the connection establishment.
    
           Notes:
    
           If a QP has not been created on the rdma_cm_id, this function
           should be called by the active side to complete the connection,
    
           after getting connect response event.
    
           This will trigger a connection established event on the passive
           side.
    
           This function should not be used on an rdma_cm_id on which a QP
           has been created.
    


## ARGUMENTS



           _id_     RDMA identifier.
    


## RETURN VALUE



           **rdma_establish()** returns 0 on success, or -1 on error.  If an
           error occurs, errno will be set to indicate the failure reason.
    


* * *
# probe::nfs.aop.release_page

## NAME



           probe::nfs.aop.release_page - NFS client releasing page
    


## SYNOPSIS



           nfs.aop.release_page
    


## VALUES



           _page_index_
               offset within mapping, can used a page identifier and position
               identifier in the page frame
    
           _size_
               release pages
    
           ___page_
               the address of page
    
           _ino_
               inode number
    
           _dev_
               device identifier
    


## DESCRIPTION



           Fires when do a release operation on NFS.
    


* * *
# function::ip_ntop

## NAME



           function::ip_ntop - Returns a string representation for an IPv4
           address
    


## SYNOPSIS



               ip_ntop:string(addr:long)
    


## ARGUMENTS



           _addr_
               the IPv4 address represented as an integer
    


* * *