tripathysagar/man_text huggingface dataset:
# iswxdigit

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



           iswxdigit, iswxdigit_l — test for a hexadecimal digit wide-
           character code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswxdigit(wint_t _wc_);
           int iswxdigit_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswxdigit_(): The functionality described on this reference
           page is aligned with the ISO C standard. Any conflict between the
           requirements described here and the ISO C standard is
           unintentional. This volume of POSIX.1‐2017 defers to the ISO C
           standard.
    
           The _iswxdigit_() and _iswxdigit_l_() functions shall test whether _wc_
           is a wide-character code representing a character of class **xdigit**
           in the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswxdigit_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswxdigit_() and _iswxdigit_l_() functions shall return non-zero
           if _wc_ is a hexadecimal digit wide-character code; otherwise, they
           shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ibv_get_srq_num

## NAME



           ibv_get_srq_num - return srq number associated with the given
           shared receive queue (SRQ)
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_get_srq_num(struct ibv_srq *srq, uint32_t *srq_num);
    


## DESCRIPTION



           **ibv_get_srq_num()** return srq number associated with the given XRC
           shared receive queue The argument _srq_ is an ibv_srq struct, as
           defined in <infiniband/verbs.h>.  _srq_num_ is an output parameter
           that holds the returned srq number.
    


## RETURN VALUE



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


* * *
# gnutls_x509_crq_set_subject_alt_name

## NAME



           gnutls_x509_crq_set_subject_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_subject_alt_name(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_subject_alt_name_t** _nt_**, const void ***_data_**, unsigned int**
           _data_size_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate request of type **gnutls_x509_crq_t**
    
           gnutls_x509_subject_alt_name_t nt
                       is one of the **gnutls_x509_subject_alt_name_t**
                       enumerations
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The size of data to be set
    
           unsigned int flags
                       **GNUTLS_FSAN_SET** to clear previous data or
                       **GNUTLS_FSAN_APPEND** to append.
    


## DESCRIPTION



           This function will set the subject alternative name certificate
           extension.  It can set the following types:
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# stdin

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



           stderr, stdin, stdout — standard I/O streams
    


## SYNOPSIS



           #include <stdio.h>
    
           extern FILE *stderr, *stdin, *stdout;
    


## 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.
    
           A file with associated buffering is called a _stream_ and is
           declared to be a pointer to a defined type **FILE**.  The _fopen_()
           function shall create certain descriptive data for a stream and
           return a pointer to designate the stream in all further
           transactions. Normally, there are three open streams with constant
           pointers declared in the _< stdio.h>_ header and associated with the
           standard open files.
    
           At program start-up, three streams shall be predefined and need
           not be opened explicitly: _standard input_ (for reading conventional
           input), _standard output_ (for writing conventional output), and
           _standard error_ (for writing diagnostic output). When opened, the
           standard error stream is not fully buffered; the standard input
           and standard output streams are fully buffered if and only if the
           stream can be determined not to refer to an interactive device.
    
           The following symbolic values in _< unistd.h>_ define the file
           descriptors that shall be associated with the C-language _stdin_ ,
           _stdout_ , and _stderr_ when the application is started:
    
           STDIN_FILENO  Standard input value, _stdin_.  Its value is 0.
    
           STDOUT_FILENO Standard output value, _stdout_.  Its value is 1.
    
           STDERR_FILENO Standard error value, _stderr_.  Its value is 2.
    
           The _stderr_ stream is expected to be open for reading and writing.
    


## RETURN VALUE



           None.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::signal.flush

## NAME



           probe::signal.flush - Flushing all pending signals for a task
    


## SYNOPSIS



           signal.flush
    


## VALUES



           _name_
               Name of the probe point
    
           _sig_pid_
               The PID of the process associated with the task performing the
               flush
    
           _pid_name_
               The name of the process associated with the task performing
               the flush
    
           _task_
               The task handler of the process performing the flush
    


* * *
# ibv_alloc_mw

## NAME



           ibv_alloc_mw, ibv_dealloc_mw - allocate or deallocate a memory
           window (MW)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_mw *ibv_alloc_mw(struct ibv_pd** _*pd_**,**
                                       **enum ibv_mw_type** _type_**);**
    
           **int ibv_dealloc_mw(struct ibv_mw** _*mw_**);**
    


## DESCRIPTION



           **ibv_alloc_mw()** allocates a memory window (MW) associated with the
           protection domain _pd_.  The MW's type (1 or 2A/2B) is _type_.
    
           The MW is created not bound. For it to be useful, the MW must be
           bound, through either ibv_bind_mw (type 1) or a special WR (type
           2).  Once bound, the memory window allows RDMA (remote) access to
           a subset of the MR to which it was bound, until invalidated by:
           ibv_bind_mw verb with zero length for type 1,
           IBV_WR_LOCAL_INV/IBV_WR_SEND_WITH_INV WR opcode for type 2,
           deallocation.
    
           **ibv_dealloc_mw()** Unbinds in case was previously bound and
           deallocates the MW _mw_.
    


## RETURN VALUE



           **ibv_alloc_mw()** returns a pointer to the allocated MW, or NULL if
           the request fails.  The remote key (**R_Key**) field **rkey** is used by
           remote processes to perform Atomic and RDMA operations. This key
           will be changed during bind operations. The remote process places
           this **rkey** as the rkey field of struct ibv_send_wr passed to the
           ibv_post_send function.
    
           **ibv_dealloc_mw()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_dereg_mr()** fails if any memory window is still bound to this
           MR.
    


* * *
# locale_t

## NAME



           locale_t - locale object
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <locale.h>**
    
           **typedef** /* ... */  **locale_t;**
    


## DESCRIPTION



           _locale_t_ is a type used for storing a locale object.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< ctype.h>_,
           _< langinfo.h>_, _< monetary.h>_, _< string.h>_, _< strings.h>_, _< time.h>_,
           _< wchar.h>_, _< wctype.h>_.
    


* * *
# ibv_alloc_pd

## NAME



           ibv_alloc_pd, ibv_dealloc_pd - allocate or deallocate a protection
           domain (PDs)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_pd *ibv_alloc_pd(struct ibv_context** _*context_**);**
    
           **int ibv_dealloc_pd(struct ibv_pd** _*pd_**);**
    


## DESCRIPTION



           **ibv_alloc_pd()** allocates a PD for the RDMA device context _context_.
    
           **ibv_dealloc_pd()** deallocates the PD _pd_.
    


## RETURN VALUE



           **ibv_alloc_pd()** returns a pointer to the allocated PD, or NULL if
           the request fails.
    
           **ibv_dealloc_pd()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_dealloc_pd()** may fail if any other resource is still
           associated with the PD being freed.
    


* * *
# gnutls_kx_list

## NAME



           gnutls_kx_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_kx_algorithm_t * gnutls_kx_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of supported key exchange algorithms.
    
           This function is not thread safe.
    


## RETURNS



           a (0)-terminated list of **gnutls_kx_algorithm_t** integers indicating
           the available key exchange algorithms.
    


* * *
# gnutls_fips140_get_operation_state

## NAME



           gnutls_fips140_get_operation_state - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_fips140_operation_state_t**
           **gnutls_fips140_get_operation_state(gnutls_fips140_context_t**
           _context_**);**
    


## ARGUMENTS



           gnutls_fips140_context_t context
                       a **gnutls_fips140_context_t**
    


## DESCRIPTION



           Get the previous operation state of  _context_ in terms of FIPS.
    


## RETURNS



           a **gnutls_fips140_operation_state_t**
    


## SINCE



           3.7.3
    


* * *
# function::tcpmib_remote_addr

## NAME



           function::tcpmib_remote_addr - Get the remote address
    


## SYNOPSIS



               tcpmib_remote_addr:long(sk:long)
    


## ARGUMENTS



           _sk_
               pointer to a struct inet_sock
    


## DESCRIPTION



           Returns the daddr from a struct inet_sock in host order.
    


* * *
# gnutls_rnd_refresh

## NAME



           gnutls_rnd_refresh - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_rnd_refresh(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           This function refreshes the random generator state.  That is the
           current precise time, CPU usage, and other values are input into
           its state.
    
           On a slower rate input from /dev/urandom is mixed too.
    


## SINCE



           3.1.7
    


* * *
# wcsdup

## NAME



           wcsdup - duplicate a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcsdup(const wchar_t ***_s_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **wcsdup**():
               Since glibc 2.10:
                   _POSIX_C_SOURCE >= 200809L
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **wcsdup**() function is the wide-character equivalent of the
           strdup(3) function.  It allocates and returns a new wide-character
           string whose initial contents is a duplicate of the wide-character
           string pointed to by _s_.
    
           Memory for the new wide-character string is obtained with
           malloc(3), and should be freed with free(3).
    


## RETURN VALUE



           On success, **wcsdup**() returns a pointer to the new wide-character
           string.  On error, it returns NULL, with _errno_ set to indicate the
           error.
    


## ERRORS



           **ENOMEM** Insufficient memory available to allocate duplicate string.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# audit_get_session

## NAME



           audit_get_session - Get a program's login session id value
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **uint32_t audit_get_session(void);**
    


## DESCRIPTION



           This function returns the task's session id attribute.
    


## RETURN VALUE



           This function returns the session id value if it was set. It will
           return a -1 if the session id is unset. However, since uint32_t is
           an unsigned type, you will see the converted value instead of -1.
    


## ERRORS



           This function returns -2 on failure. Additionally, in the event of
           a real error, errno would be set. The function can set errno based
           on failures of open, read, or strtoul.
    


* * *
# function::is_sig_blocked

## NAME



           function::is_sig_blocked - Returns 1 if the signal is currently
           blocked, or 0 if it is not
    


## SYNOPSIS



               is_sig_blocked:long(task:long,sig:long)
    


## ARGUMENTS



           _task_
               address of the task_struct to query.
    
           _sig_
               the signal number to test.
    


* * *
# gnutls_x509_crq_get_subject_alt_othername_oid

## NAME



           gnutls_x509_crq_get_subject_alt_othername_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_crq_get_subject_alt_othername_oid(gnutls_x509_crq_t**
           _crq_**, unsigned int** _seq_**, void ***_ret_**, size_t ***_ret_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * ret  is the place where the otherName OID will be copied to
    
           size_t * ret_size
                       holds the size of ret.
    


## DESCRIPTION



           This function will extract the type OID of an otherName Subject
           Alternative Name, contained in the given certificate, and return
           the type as an enumerated element.
    
           This function is only useful if
           **gnutls_x509_crq_get_subject_alt_name()** returned
           **GNUTLS_SAN_OTHERNAME**.
    


## RETURNS



           the alternative subject name type on success, one of the
           enumerated gnutls_x509_subject_alt_name_t.  For supported OIDs, it
           will return one of the virtual (GNUTLS_SAN_OTHERNAME_*) types,
           e.g. **GNUTLS_SAN_OTHERNAME_XMPP** , and **GNUTLS_SAN_OTHERNAME** for
           unknown OIDs.  It will return **GNUTLS_E_SHORT_MEMORY_BUFFER** if
            _ret_size_ is not large enough to hold the value.  In that case
            _ret_size_ will be updated with the required size.  If the
           certificate does not have an Alternative name with the specified
           sequence number and with the otherName type then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           2.8.0
    


* * *
# probe::stap.pass2.end

## NAME



           probe::stap.pass2.end - Finished stap pass2 (elaboration)
    


## SYNOPSIS



           stap.pass2.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass2.end fires just before the jump to cleanup if s.last_pass = 2
    


* * *
# fgetpos

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



           fgetpos — get current file position information
    


## SYNOPSIS



           #include <stdio.h>
    
           int fgetpos(FILE *restrict _stream_ , fpos_t *restrict _pos_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _fgetpos_() function shall store the current values of the parse
           state (if any) and file position indicator for the stream pointed
           to by _stream_ in the object pointed to by _pos_.  The value stored
           contains unspecified information usable by _fsetpos_() for
           repositioning the stream to its position at the time of the call
           to _fgetpos_().
    
           The _fgetpos_() function shall not change the setting of _errno_ if
           successful.
    


## RETURN VALUE



           Upon successful completion, _fgetpos_() shall return 0; otherwise,
           it shall return a non-zero value and set _errno_ to indicate the
           error.
    


## ERRORS



           The _fgetpos_() function shall fail if:
    
           **EBADF** The file descriptor underlying _stream_ is not valid.
    
           **EOVERFLOW**
                  The current value of the file position cannot be
                  represented correctly in an object of type **fpos_t**.
    
           **ESPIPE** The file descriptor underlying _stream_ is associated with a
                  pipe, FIFO, or socket.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::scheduler.balance

## NAME



           probe::scheduler.balance - A cpu attempting to find more work.
    


## SYNOPSIS



           scheduler.balance
    


## VALUES



           _name_
               name of the probe point
    


## CONTEXT



           The cpu looking for more work.
    


* * *
# nan

## NAME



           nan, nanf, nanl - return 'Not a Number'
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double nan(const char ***_tagp_**);**
           **float nanf(const char ***_tagp_**);**
           **long double nanl(const char ***_tagp_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **nan**(), **nanf**(), **nanl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions return a representation (determined by _tagp_) of a
           quiet NaN.  If the implementation does not support quiet NaNs,
           these functions return zero.
    
           The call _nan("char-sequence")_ is equivalent to:
    
               strtod("NAN(char-sequence)", NULL);
    
           Similarly, calls to **nanf**() and **nanl**() are equivalent to analogous
           calls to strtof(3) and strtold(3).
    
           The argument _tagp_ is used in an unspecified manner.  On IEEE 754
           systems, there are many representations of NaN, and _tagp_ selects
           one.  On other systems it may do nothing.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    
           See also IEC 559 and the appendix with recommended functions in
           IEEE 754/IEEE 854.
    


* * *
# gnutls_cipher_list

## NAME



           gnutls_cipher_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_cipher_algorithm_t * gnutls_cipher_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of supported cipher algorithms.  Note that not
           necessarily all ciphers are supported as TLS cipher suites.  For
           example, DES is not supported as a cipher suite, but is supported
           for other purposes (e.g., PKCS**8** or similar).
    
           This function is not thread safe.
    


## RETURNS



           a (0)-terminated list of **gnutls_cipher_algorithm_t** integers
           indicating the available ciphers.
    


* * *
# selabel_digest

## NAME



           selabel_digest - Return digest of specfiles and list of files used
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **int selabel_digest(struct selabel_handle ***_hnd_**,**
                              **unsigned char ****_digest_**, size_t ***_digest_len_**,**
                              **char *****_specfiles,_ **size_t ***_num_specfiles_**);**
    


## DESCRIPTION



           **selabel_digest**() performs an operation on the handle _hnd_ ,
           returning the results of the SHA1 digest pointed to by _digest_ ,
           whose length will be _digest_len_.  The list of specfiles used in
           the SHA1 digest calculation is returned in _specfiles_ with the
           number of entries in _num_specfiles_.
    
           To enable **selabel_digest**() to return this information the
           **SELABEL_OPT_DIGEST** option must be enable in selabel_open(3).
    
           The result of **selabel_digest**() must not be used after
           selabel_close(3).
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned and _errno_
           is set appropriately.
    


## ERRORS



           **EINVAL** No digest available (returned if **SELABEL_OPT_DIGEST** option
                  not enabled).
    
           **ENOMEM** An attempt to allocate memory failed.
    


* * *
# gnutls_session_ticket_enable_server

## NAME



           gnutls_session_ticket_enable_server - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_ticket_enable_server(gnutls_session_t** _session_**,**
           **const gnutls_datum_t ***_key_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_datum_t * key
                       key to encrypt session parameters.
    


## DESCRIPTION



           Request that the server should attempt session resumption using
           session tickets, i.e., by delegating storage to the client.
            _key_ must be initialized using
           **gnutls_session_ticket_key_generate()**.  To avoid leaking that key,
           use **gnutls_memset()** prior to releasing it.
    
           The default ticket expiration time can be overridden using
           **gnutls_db_set_cache_expiration()**.
    


## RETURNS



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


## SINCE



           2.10.0
    


* * *
# gnutls_x509_crt_get_crl_dist_points

## NAME



           gnutls_x509_crt_get_crl_dist_points - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_crl_dist_points(gnutls_x509_crt_t** _cert_**,**
           **unsigned int** _seq_**, void ***_san_**, size_t ***_san_size_**, unsigned int ***
           _reason_flags_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the distribution
                       point (0 for the first one, 1 for the second etc.)
    
           void * san  is the place where the distribution point will be
                       copied to
    
           size_t * san_size
                       holds the size of ret.
    
           unsigned int * reason_flags
                       Revocation reasons. An ORed sequence of flags from
                       **gnutls_x509_crl_reason_flags_t**.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function retrieves the CRL distribution points (2.5.29.31),
           contained in the given certificate in the X509v3 Certificate
           Extensions.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** and updates  _ret_size_ if
            _ret_size_ is not enough to hold the distribution point, or the
           type of the distribution point if everything was ok. The type is
           one of the enumerated **gnutls_x509_subject_alt_name_t**.  If the
           certificate does not have an Alternative name with the specified
           sequence number then **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is
           returned.
    


* * *
# function::MINOR

## NAME



           function::MINOR - Extract minor device number from a kernel device
           number (kdev_t)
    


## SYNOPSIS



               MINOR:long(dev:long)
    


## ARGUMENTS



           _dev_
               Kernel device number to query.
    


* * *
# sem_close

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



           sem_close — close a named semaphore
    


## SYNOPSIS



           #include <semaphore.h>
    
           int sem_close(sem_t *_sem_);
    


## DESCRIPTION



           The _sem_close_() function shall indicate that the calling process
           is finished using the named semaphore indicated by _sem_.  The
           effects of calling _sem_close_() for an unnamed semaphore (one
           created by _sem_init_()) are undefined. The _sem_close_() function
           shall deallocate (that is, make available for reuse by a
           subsequent _sem_open_() by this process) any system resources
           allocated by the system for use by this process for this
           semaphore. The effect of subsequent use of the semaphore indicated
           by _sem_ by this process is undefined. If any threads in the calling
           process are currently blocked on the semaphore, the behavior is
           undefined.  If the semaphore has not been removed with a
           successful call to _sem_unlink_(), then _sem_close_() has no effect on
           the state of the semaphore. If the _sem_unlink_() function has been
           successfully invoked for _name_ after the most recent call to
           _sem_open_() with O_CREAT for this semaphore, then when all
           processes that have opened the semaphore close it, the semaphore
           is no longer accessible.
    


## RETURN VALUE



           Upon successful completion, a value of zero shall be returned.
           Otherwise, a value of -1 shall be returned and _errno_ set to
           indicate the error.
    


## ERRORS



           The _sem_close_() function may fail if:
    
           **EINVAL** The _sem_ argument is not a valid semaphore descriptor.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_handshake_set_private_extensions

## NAME



           gnutls_handshake_set_private_extensions - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_handshake_set_private_extensions(gnutls_session_t**
           _session_**, int** _allow_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int allow   is an integer (0 or 1)
    


## DESCRIPTION



           This function will enable or disable the use of private cipher
           suites (the ones that start with 0xFF).  By default or if  _allow_
           is 0 then these cipher suites will not be advertised nor used.
    
           Currently GnuTLS does not include such cipher-suites or
           compression algorithms.
    
           Enabling the private ciphersuites when talking to other than
           gnutls servers and clients may cause interoperability problems.
    


* * *
# puts

## NAME



           fputc, fputs, putc, putchar, puts - output of characters and
           strings
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **int fputc(int** _c_**, FILE ***_stream_**);**
           **int putc(int** _c_**, FILE ***_stream_**);**
           **int putchar(int** _c_**);**
    
           **int fputs(const char *restrict** _s_**, FILE *restrict** _stream_**);**
           **int puts(const char ***_s_**);**
    


## DESCRIPTION



           **fputc**() writes the character _c_ , cast to an _unsigned char_ , to
           _stream_.
    
           **putc**() is equivalent to **fputc**() except that it may be implemented
           as a macro which evaluates _stream_ more than once.
    
           _putchar(c)_ is equivalent to _putc(c, stdout)_.
    
           **fputs**() writes the string _s_ to _stream_ , without its terminating
           null byte ('\0').
    
           **puts**() writes the string _s_ and a trailing newline to _stdout_.
    
           Calls to the functions described here can be mixed with each other
           and with calls to other output functions from the _stdio_ library
           for the same output stream.
    
           For nonlocking counterparts, see unlocked_stdio(3).
    


## RETURN VALUE



           **fputc**(), **putc**(), and **putchar**() return the character written as an
           _unsigned char_ cast to an _int_ or **EOF** on error.
    
           **puts**() and **fputs**() return a nonnegative number on success, or **EOF**
           on error.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           It is not advisable to mix calls to output functions from the
           _stdio_ library with low-level calls to write(2) for the file
           descriptor associated with the same output stream; the results
           will be undefined and very probably not what you want.
    


* * *
# gnutls_x509_tlsfeatures_deinit

## NAME



           gnutls_x509_tlsfeatures_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_tlsfeatures_deinit(gnutls_x509_tlsfeatures_t** _f_**);**
    


## ARGUMENTS



           gnutls_x509_tlsfeatures_t f
                       The TLS features
    


## DESCRIPTION



           This function will deinitialize a X.509 TLS features extension
           structure
    


## SINCE



           3.5.1
    


* * *
# probe::tty.read

## NAME



           probe::tty.read - called when a tty line will be read
    


## SYNOPSIS



           tty.read
    


## VALUES



           _nr_
               The amount of characters to be read
    
           _buffer_
               the buffer that will receive the characters
    
           _file_name_
               the file name lreated to the tty
    
           _driver_name_
               the driver name
    


* * *
# casinh

## NAME



           casinh, casinhf, casinhl - complex arc sine hyperbolic
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex casinh(double complex** _z_**);**
           **float complex casinhf(float complex** _z_**);**
           **long double complex casinhl(long double complex** _z_**);**
    


## DESCRIPTION



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmlookuptext

## NAME



           **pmLookupText** - return text describing a performance metric
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmLookupText(pmID** _pmid_**, int** _level_**, char ****_buffer_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Retrieve  descriptive text about the performance metric identified
           by _pmid_.
    
           The argument _level_ should be  either **PM_TEXT_ONELINE** for  a  one-
           line  summary,  else  **PM_TEXT_HELP** for a more verbose description,
           suited to a help dialog.
    
           The space pointed to by _buffer_ will have  been  allocated  in  **pm‐**
           **LookupText** with  malloc(3),  and  it is the responsibility of the
           caller to free(3) the space when it is no longer required.
    
           **pmLookupText** returns zero on success.
    


## DIAGNOSTICS



           **PM_ERR_NOTHOST**
                  For archives created with versions of PCP prior to 4.0, if
                  the current PMAPI context is an archive (help and one-line
                  text was previously not maintained in the archives)
    


* * *
# gnutls_pkcs7_get_crt_raw2

## NAME



           gnutls_pkcs7_get_crt_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_crt_raw2(gnutls_pkcs7_t** _pkcs7_**, unsigned** _indx_**,**
           **gnutls_datum_t ***_cert_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a gnutls_pkcs7_t type
    
           unsigned indx
                       contains the index of the certificate to extract
    
           gnutls_datum_t * cert
                       will hold the contents of the certificate; must be
                       deallocated with **gnutls_free()**
    


## DESCRIPTION



           This function will return a certificate of the PKCS7 or RFC2630
           certificate set.
    
           After the last certificate has been read
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value.  If the provided buffer is not long enough, then
           _certificate_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** is
           returned.
    


## SINCE



           3.4.2
    


* * *
# io_uring_prep_futex_waitv

## NAME



           io_uring_prep_futex_waitv - prepare a futex waitv request
    


## SYNOPSIS



           **#include <linux/futex.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_futex_waitv(struct io_uring_sqe ***_sqe_**,**
                                          **struct futex_waitv ***_futexv_**,**
                                          **uint32_t** _nr_futex_**,**
                                          **unsigned int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_futex_waitv(3) function prepares a futex wait
           request for multiple futexes at the same time.  The submission
           queue entry _sqe_ is setup for waiting on all futexes given by
           _futexv_ and _nr_futex_ is the number of futexes in that array.  _flags_
           must be set to the io_uring specific futex flags.
    
           Unlike io_uring_prep_futex_wait(3), the desired bitset mask and
           values are passed in _futexv_.
    
           _flags_ are currently unused and hence **0** must be passed.
    
           This function prepares an async futex(2) waitv request. See that
           man page for details.
    
           Available since kernel 6.7.
    


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



           Unlike the sync futex syscalls that wait on a futex, io_uring does
           not support passing in a timeout for the request. Instead,
           applications are encouraged to use a linked timeout to abort the
           futex request at a given time, if desired.
    


* * *
# pam_close_session

## NAME



           pam_close_session - terminate PAM session management
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_close_session** function is used to indicate that an
           authenticated session has ended. The session should have been
           created with a call to pam_open_session(3).
    
           It should be noted that the effective uid, geteuid(2). of the
           application should be of sufficient privilege to perform such
           tasks as unmounting the user's home directory for example.
    
           The flags argument is the binary or of zero or more of the
           following values:
    
           PAM_SILENT
               Do not emit any messages.
    


## RETURN VALUES



           PAM_ABORT
               General failure.
    
           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_SESSION_ERR
               Session failure.
    
           PAM_SUCCESS
               Session was successful terminated.
    


* * *
# cpow

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



           cpow, cpowf, cpowl — complex power functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex cpow(double complex _x_ , double complex _y_);
           float complex cpowf(float complex _x_ , float complex _y_);
           long double complex cpowl(long double complex _x_ ,
               long double complex _y_);
    


## 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 power function _xy_ , with
           a branch cut for the first parameter along the negative real axis.
    


## RETURN VALUE



           These functions shall return the complex power function value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_delete_entry

## NAME



           **acl_delete_entry** — delete an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_delete_entry**(_acl_t acl_ ,
           _acl_entry_t entry_d_)
    


## DESCRIPTION



           The **acl_delete_entry**() function removes the ACL entry indicated by
           the _entry_d_ descriptor from the ACL pointed to by _acl_.  Any
           existing ACL entry descriptors that refer to entries in _acl_ other
           than that referred to by _entry_d_ continue to refer to the same
           entries. The argument _entry_d_ and any other ACL entry descriptors
           that refer to the same ACL entry are undefined after this function
           completes. Any existing ACL pointers that refer to the ACL
           referred to by _acl_ continue to refer to the ACL.
    


## RETURN VALUE



           The **acl_delete_entry**() 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_delete_entry**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_p_ is not a valid pointer to an
                              ACL.
    
                              The argument _entry_d_ is not a valid pointer to
                              an ACL entry.
    


## STANDARDS



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


* * *
# mlx5dv_get_vfio_device_list

## NAME



           mlx5dv_get_vfio_device_list - Get list of available devices to be
           used over VFIO
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_device **
                  mlx5dv_get_vfio_device_list(struct mlx5dv_vfio_context_attr *attr);
    


## DESCRIPTION



           Returns a NULL-terminated array of devices based on input _attr_.
    


## ARGUMENTS



           _attr_   Describe the VFIO devices to return in list.
    
       _**attr** _argument
                  struct mlx5dv_vfio_context_attr {
                      const char *pci_name;
                      uint32_t flags;
                      uint64_t comp_mask;
                  };
    
           _pci_name_
                  The PCI name of the required device.
    
           _flags_
    
                  A bitwise OR of the various values described below.
    
                  *MLX5DV_VFIO_CTX_FLAGS_INIT_LINK_DOWN*:
                  Upon device initialization link should stay down.
    
           _comp_mask_
    
                  Bitmask specifying what fields in the structure are valid.
    


## RETURN VALUE



           Returns the array of the matching devices, or sets errno and
           returns NULL if the request fails.
    


## NOTES



           Client code should open all the devices it intends to use with
           ibv_open_device() before calling ibv_free_device_list().  Once it
           frees the array with ibv_free_device_list(), it will be able to
           use only the open devices; pointers to unopened devices will no
           longer be valid.
    


* * *