tripathysagar/man_text huggingface dataset:
# pmwhichcontext

## NAME



           **pmWhichContext** - identify the current PMAPI context
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmWhichContext(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           An  application using the Performance Metrics Application Program‐
           ming Interface (PMAPI) may manipulate several concurrent contexts,
           each associated with a source of performance metrics, e.g. pmcd(1)
           on some host, or an archive of performance metrics as  created  by
           pmlogger(1).
    
           **pmWhichContext** returns  a  handle  for the current PMAPI context,
           that may be used in the associated PMAPI routines that  require  a
           handle to identify a PMAPI context.
    


## DIAGNOSTICS



           **PM_ERR_NOCONTEXT**
                  no current context
    


* * *
# io_uring_prep_sync_file_range

## NAME



           io_uring_prep_sync_file_range - prepare a sync_file_range request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_sync_file_range(struct io_uring_sqe ***_sqe_**,**
                                              **int** _fd_**,**
                                              **unsigned** _len_**,**
                                              **__u64** _offset_**,**
                                              **int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_sync_file_range(3) function prepares a
           sync_file_range request. The submission queue entry _sqe_ is setup
           to use the file descriptor _fd_ that should get _len_ bytes synced
           started at offset _offset_ and with modifier flags in the _flags_
           argument.
    
           This function prepares an async sync_file_range(2) request. See
           that man page for details on the arguments.
    


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


* * *
# mitem_name

## NAME



           **item_name** , **item_description** - get menu item name and description
           fields
    


## SYNOPSIS



           **#include <menu.h>**
    
           **const char *item_name(const ITEM ***_item_**);**
           **const char *item_description(const ITEM ***_item_**);**
    


## DESCRIPTION



           The function **item_name** returns the name part of the given item.
           The function **item_description** returns the description part of the
           given item.
    


## RETURN VALUE



           These routines return a pointer (which may be **NULL**).  They do not
           set **errno**.
    


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


* * *
# exp2

## NAME



           exp2, exp2f, exp2l - base-2 exponential function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double exp2(double** _x_**);**
           **float exp2f(float** _x_**);**
           **long double exp2l(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **exp2**(), **exp2f**(), **exp2l**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions return the value of 2 raised to the power of _x_.
    


## RETURN VALUE



           On success, these functions return the base-2 exponential value of
           _x_.
    
           For various special cases, including the handling of infinity and
           NaN, as well as overflows and underflows, see exp(3).
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           For a discussion of the errors that can occur for these functions,
           see exp(3).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# environ

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



           environ — array of character pointers to the environment strings
    


## SYNOPSIS



           extern char **environ;
    


## DESCRIPTION



           Refer to exec(1p) and the Base Definitions volume of POSIX.1‐2017,
           _Chapter 8_ , _Environment Variables_.
    


* * *
# gnutls_priority_certificate_type_list

## NAME



           gnutls_priority_certificate_type_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_certificate_type_list(gnutls_priority_t**
           _pcache_**, const unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available certificate types in the priority
           structure.
    
           As of version 3.6.4 this function is an alias for
           gnutls_priority_certificate_type_list2 with the target parameter
           set to: - GNUTLS_CTYPE_SERVER, if the **SERVER_PRECEDENCE** option is
           set - GNUTLS_CTYPE_CLIENT, otherwise.
    


## RETURNS



           the number of certificate types, or an error code.
    


## SINCE



           3.0
    


* * *
# function::tz_gmtoff

## NAME



           function::tz_gmtoff - Return local time zone offset
    


## SYNOPSIS



               tz_gmtoff()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the local time zone offset (seconds west of UTC), as
           passed by staprun at script startup only.
    


* * *
# gnutls_x509_crt_set_key

## NAME



           gnutls_x509_crt_set_key - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_key(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_privkey_t key
                       holds a private key
    


## DESCRIPTION



           This function will set the public parameters from the given
           private key to the certificate.
    
           To export the public key (i.e., the SubjectPublicKeyInfo part),
           check **gnutls_pubkey_import_x509()**.
    


## RETURNS



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


* * *
# gnutls_hash_init

## NAME



           gnutls_hash_init - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hash_init(gnutls_hash_hd_t ***_dig_**,**
           **gnutls_digest_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t * dig
                       is a **gnutls_hash_hd_t** type
    
           gnutls_digest_algorithm_t algorithm
                       the hash algorithm to use
    


## DESCRIPTION



           This function will initialize an context that can be used to
           produce a Message Digest of data.  This will effectively use the
           current crypto backend in use by gnutls or the cryptographic
           accelerator in use.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# sem_close

## NAME



           sem_close - close a named semaphore
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



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


## DESCRIPTION



           **sem_close**() closes the named semaphore referred to by _sem_ ,
           allowing any resources that the system has allocated to the
           calling process for this semaphore to be freed.
    


## RETURN VALUE



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


## ERRORS



           **EINVAL** _sem_ is not a valid semaphore.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           All open named semaphores are automatically closed on process
           termination, or upon execve(2).
    


* * *
# gnutls_dh_params_init

## NAME



           gnutls_dh_params_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_init(gnutls_dh_params_t ***_dh_params_**);**
    


## ARGUMENTS



           gnutls_dh_params_t * dh_params
                       The parameters
    


## DESCRIPTION



           This function will initialize the DH parameters type.
    


## RETURNS



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


* * *
# function::format_ipaddr

## NAME



           function::format_ipaddr - Returns a string representation for an
           IP address
    


## SYNOPSIS



               format_ipaddr:string(addr:long,family:long)
    


## ARGUMENTS



           _addr_
               the IP address
    
           _family_
               the IP address family (either AF_INET or AF_INET6)
    


* * *
# probe::ipmib.FragOKs

## NAME



           probe::ipmib.FragOKs - Count datagram fragmented successfully
    


## SYNOPSIS



           ipmib.FragOKs
    


## VALUES



           _skb_
               pointer to the struct sk_buff being acted on
    
           _op_
               value to be added to the counter (default value of 1)
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **ipmib_filter_key**. If the packet passes the filter is is counted in
           the global _FragOKs_ (equivalent to SNMP's MIB IPSTATS_MIB_FRAGOKS)
    


* * *
# modf

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



           modf, modff, modfl — decompose a floating-point number
    


## SYNOPSIS



           #include <math.h>
    
           double modf(double _x_ , double *_iptr_);
           float modff(float _value_ , float *_iptr_);
           long double modfl(long double _value_ , long double *_iptr_);
    


## 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 break the argument _x_ into integral and
           fractional parts, each of which has the same sign as the argument.
           It stores the integral part as a **double**(for the _modf_() function),
           a **float**(for the _modff_() function), or a **long double**(for the
           _modfl_() function), in the object pointed to by _iptr_.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           signed fractional part of _x_.
    
           If _x_ is NaN, a NaN shall be returned, and *_iptr_ shall be set to a
           NaN.
    
           If _x_ is ±Inf, ±0 shall be returned, and *_iptr_ shall be set to
           ±Inf.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _modf_() function computes the function result and *_iptr_ such
           that:
    
               a = modf(x, iptr) ;
               x == a+*iptr ;
    
           allowing for the usual floating-point inaccuracies.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# mbstate_t

## NAME



           mbstate_t - multi-byte-character conversion state
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **typedef** /* ... */  **mbstate_t;**
    


## DESCRIPTION



           Character conversion between the multibyte representation and the
           wide character representation uses conversion state, of type
           _mbstate_t_.  Conversion of a string uses a finite-state machine;
           when it is interrupted after the complete conversion of a number
           of characters, it may need to save a state for processing the
           remaining characters.  Such a conversion state is needed for the
           sake of encodings such as ISO/IEC 2022 and UTF-7.
    
           The initial state is the state at the beginning of conversion of a
           string.  There are two kinds of state: the one used by multibyte
           to wide character conversion functions, such as mbsrtowcs(3), and
           the one used by wide character to multibyte conversion functions,
           such as wcsrtombs(3), but they both fit in a _mbstate_t_ , and they
           both have the same representation for an initial state.
    
           For 8-bit encodings, all states are equivalent to the initial
           state.  For multibyte encodings like UTF-8, EUC-*, BIG5, or SJIS,
           the wide character to multibyte conversion functions never produce
           non-initial states, but the multibyte to wide-character conversion
           functions like mbrtowc(3) do produce non-initial states when
           interrupted in the middle of a character.
    
           One possible way to create an _mbstate_t_ in initial state is to set
           it to zero:
    
               mbstate_t state;
               memset(&state, 0, sizeof(state));
    
           On Linux, the following works as well, but might generate compiler
           warnings:
    
               mbstate_t state = { 0 };
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# audit_log_user_command

## NAME



           audit_log_user_command - log a user command
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int**
           **audit_log_user_command(int** _audit_fd,_**int"**_type,_**const** _char_***"**_command,_**const** _char_***"**_tty,_**int"**_result);"_
    


## DESCRIPTION



           This function will log a command to the audit system using a
           predefined message format. It encodes the command as the audit
           system expects for untrusted strings. This function should be used
           by all apps need to record commands. The function parameters are
           as follows:
    
           _audit_fd_ - The fd returned by audit_open
           _type_ - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
           _command_ - the command being logged
           _tty_ - The tty of the user, if NULL will attempt to figure out
           _result_ - 1 is "success" and 0 is "failed"
    


## RETURN VALUE



           It returns the sequence number which is > 0 on success or <= 0 on
           error.
    


## ERRORS



           This function returns -1 on failure. Examine errno for more info.
    


* * *
# get_phys_pages

## NAME



           get_phys_pages, get_avphys_pages - get total and available
           physical page counts
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/sysinfo.h>**
    
           **long get_phys_pages(void);**
           **long get_avphys_pages(void);**
    


## DESCRIPTION



           The function **get_phys_pages**() returns the total number of physical
           pages of memory available on the system.
    
           The function **get_avphys_pages**() returns the number of currently
           available physical pages of memory on the system.
    


## RETURN VALUE



           On success, these functions return a nonnegative value as given in
           DESCRIPTION.  On failure, they return -1 and set _errno_ to indicate
           the error.
    


## ERRORS



           **ENOSYS** The system could not provide the required information
                  (possibly because the _/proc_ filesystem was not mounted).
    


## STANDARDS



           GNU.
    


## NOTES



           The following sysconf(3) calls provide a portable means of
           obtaining the same information as the functions described on this
           page.
    
               total_pages = sysconf(_SC_PHYS_PAGES);    /* total pages */
               avl_pages = sysconf(_SC_AVPHYS_PAGES);    /* available pages */
    


## EXAMPLES



           The following example shows how **get_phys_pages**() and
           **get_avphys_pages**() can be used.
    
           #include <stdio.h>
           #include <stdlib.h>
           #include <sys/sysinfo.h>
    
           int
           main(void)
           {
               printf("This system has %ld pages of physical memory and "
                       "%ld pages of physical memory available.\n",
                       get_phys_pages(), get_avphys_pages());
               exit(EXIT_SUCCESS);
           }
    


* * *
# libpfm_intel_ivbep_unc_qpi

## NAME



           libpfm_intel_ivbep_unc_qpi - support for Intel Ivy Bridge-EP QPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_qpi0, ivbep_unc_qpi1**
           **PMU desc: Intel Ivy Bridge-EP QPI uncore PMU**
    


## DESCRIPTION



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


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge QPI
           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 QPI cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].
    


* * *
# cbrt

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



           cbrt, cbrtf, cbrtl — cube root functions
    


## SYNOPSIS



           #include <math.h>
    
           double cbrt(double _x_);
           float cbrtf(float _x_);
           long double cbrtl(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 real cube root of their argument
           _x_.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the cube
           root of _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0 or ±Inf, _x_ shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           For some applications, a true cube root function, which returns
           negative results for negative arguments, is more appropriate than
           _pow_(_x_ , 1.0/3.0), which returns a NaN for _x_ less than 0.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# auparse_get_type_name

## NAME



           auparse_get_type_name - get record's type translation
    


## SYNOPSIS



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


## DESCRIPTION



           The auparse_get_type_name function will return the text
           representation of the name of the current record type.
    


## RETURN VALUE



           The auparse_get_type_name function returns NULL on error;
           otherwise a pointer to a string.
    


* * *
# gnutls_x509_crt_get_extension_data2

## NAME



           gnutls_x509_crt_get_extension_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_extension_data2(gnutls_x509_crt_t** _cert_**,**
           **unsigned** _indx_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       Specifies which extension OID to read. Use (0) to get
                       the first one.
    
           gnutls_datum_t * data
                       will contain the extension DER-encoded data
    


## DESCRIPTION



           This function will return the requested by the index extension
           data in the certificate.  The extension data will be allocated
           using **gnutls_malloc()**.
    
           Use **gnutls_x509_crt_get_extension_info()** to extract the OID.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# gnutls_x509_crl_get_signature_algorithm

## NAME



           gnutls_x509_crl_get_signature_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_signature_algorithm(gnutls_x509_crl_t**
           _crl_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    


## DESCRIPTION



           This function will return a value of the **gnutls_sign_algorithm_t**
           enumeration that is the signature algorithm.
    
           Since 3.6.0 this function never returns a negative error code.
           Error cases and unknown/unsupported signature algorithms are
           mapped to **GNUTLS_SIGN_UNKNOWN**.
    


## RETURNS



           a **gnutls_sign_algorithm_t** value
    


* * *
# function::set_pointer_arg

## NAME



           function::set_pointer_arg - Set function argument as pointer value
    


## SYNOPSIS



               set_pointer_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the unsigned value of argument n, same as ulong_arg. Can be
           used with any type of pointer.
    


* * *
# probe::tty.unregister

## NAME



           probe::tty.unregister - Called when a tty device is being
           unregistered
    


## SYNOPSIS



           tty.unregister
    


## VALUES



           _module_
               the module name
    
           _name_
               the driver .dev_name name
    
           _index_
               the tty index requested
    
           _driver_name_
               the driver name
    


* * *
# __pmparsectime

## NAME



           **__pmParseCtime** - convert ctime(3) string to **tm** structure
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmParseCtime(const char ***_string_**, struct tm ***_rslt_**,**
                              **char ****_errmsg_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



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


## DESCRIPTION



           **__pmParseCtime** reverses the asctime(3)  function.   It  accepts  a
           **string** specifying a time, and fills in the given **tm** structure.
    
           _string_ is either a fully specified date and time in the format _Day_
           _MMM_  _DD_  _HH:MM:SS_  _YYYY_ (e.g "Mon Mar  4 13:07:47 1996") or a par‐
           tially specified date and time like "1996",  "Mar  1996",  "Mar  4
           1996",  "Mar",  "13:07:47",  "13:07", "Mar 4 13:07:47",....  For a
           partially specified date and time, the order of the fields must be
           preserved and missing fields are filled in from the  current  date
           and time.
    
           The seconds component (_SS_) may be a floating point number, for ex‐
           ample the time "13:07:47.5".  The 12 hour clock is also supported,
           so "13:07" and "1:07 pm" are equivalent.
    
           **__pmParseCtime** returns  0 if successful.  It returns -1 and a dy‐
           namically allocated error message string in **errmsg** , if  the  given
           **string** does  not  parse.   Be  sure  to free(3) the error message
           string.
    
           The **tm** structure returned in **rslt** should only be used as an  argu‐
           ment  to  either  the **__pmtimevalConvert** function or the **__pmtime‐**
           **specConvert** function, as it contains encoded information that will
           only be correctly interpreted by these routines.
    


* * *
# tapset::scsi

## NAME



           tapset::scsi - systemtap scsi tapset
    


## DESCRIPTION



            This family of probe points is used to probe SCSI activities.
    
           **scsi.ioentry**
                  Prepares a SCSI mid-layer request
    
                   See probe::scsi.ioentry(3stap)
                   for details.
    
           **scsi.iodispatching**
                  SCSI mid-layer dispatched low-level SCSI command
    
                   See probe::scsi.iodispatching(3stap)
                   for details.
    
           **scsi.iodone**
                  SCSI command completed by low level driver and enqueued
                  into the done queue.
    
                   See probe::scsi.iodone(3stap)
                   for details.
    
           **scsi.iocompleted**
                  SCSI mid-layer running the completion processing for block
                  device I/O requests
    
                   See probe::scsi.iocompleted(3stap)
                   for details.
    
           **scsi.ioexecute**
                  Create mid-layer SCSI request and wait for the result
    
                   See probe::scsi.ioexecute(3stap)
                   for details.
    
           **scsi.set_state**
                  Order SCSI device state change
    
                   See probe::scsi.set_state(3stap)
                   for details.
    


* * *
# ibv_create_comp_channel

## NAME



           ibv_create_comp_channel, ibv_destroy_comp_channel - create or
           destroy a completion event channel
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_comp_channel *ibv_create_comp_channel(struct ibv_context**
                                                            _*context_**);**
    
           **int ibv_destroy_comp_channel(struct ibv_comp_channel** _*channel_**);**
    


## DESCRIPTION



           **ibv_create_comp_channel()** creates a completion event channel for
           the RDMA device context _context_.
    
           **ibv_destroy_comp_channel()** destroys the completion event channel
           _channel_.
    


## RETURN VALUE



           **ibv_create_comp_channel()** returns a pointer to the created
           completion event channel, or NULL if the request fails.
    
           **ibv_destroy_comp_channel()** returns 0 on success, or the value of
           errno on failure (which indicates the failure reason).
    


## NOTES



           A "completion channel" is an abstraction introduced by libibverbs
           that does not exist in the InfiniBand Architecture verbs
           specification or RDMA Protocol Verbs Specification.  A completion
           channel is essentially file descriptor that is used to deliver
           completion notifications to a userspace process.  When a
           completion event is generated for a completion queue (CQ), the
           event is delivered via the completion channel attached to that CQ.
           This may be useful to steer completion events to different threads
           by using multiple completion channels.
    
           **ibv_destroy_comp_channel()** fails if any CQs are still associated
           with the completion event channel being destroyed.
    


* * *
# gnutls_x509_crt_list_import2

## NAME



           gnutls_x509_crt_list_import2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_list_import2(gnutls_x509_crt_t ****_certs_**,**
           **unsigned int ***_size_**, const gnutls_datum_t ***_data_**,**
           **gnutls_x509_crt_fmt_t** _format_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t ** certs
                       Will hold the parsed certificate list.
    
           unsigned int * size
                       It will contain the size of the list.
    
           const gnutls_datum_t * data
                       The PEM encoded certificate.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM.
    
           unsigned int flags
                       must be (0) or an OR'd sequence of
                       gnutls_certificate_import_flags.
    


## DESCRIPTION



           This function will convert the given PEM encoded certificate list
           to the native gnutls_x509_crt_t format. The output will be stored
           in  _certs_ which will be allocated and initialized.
    
           If the Certificate is PEM encoded it should have a header of "X509
           CERTIFICATE", or "CERTIFICATE".
    
           To deinitialize  _certs_ , you need to deinitialize each crt
           structure independently, and use **gnutls_free()** at  _certs_ .
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# vfwprintf

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



           vfwprintf, vswprintf, vwprintf — wide-character formatted output
           of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
           #include <wchar.h>
    
           int vfwprintf(FILE *restrict _stream_ , const wchar_t *restrict _format_ ,
               va_list _arg_);
           int vswprintf(wchar_t *restrict _ws_ , size_t _n_ ,
               const wchar_t *restrict _format_ , va_list _arg_);
           int vwprintf(const wchar_t *restrict _format_ , va_list _arg_);
    


## 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 _vfwprintf_(), _vswprintf_(), and _vwprintf_() functions shall be
           equivalent to _fwprintf_(), _swprintf_(), and _wprintf_() respectively,
           except that instead of being called with a variable number of
           arguments, they are called with an argument list as defined by
           _< stdarg.h>_.
    
           These functions shall not invoke the _va_end_ macro. However, as
           these functions do invoke the _va_arg_ macro, the value of _ap_ after
           the return is unspecified.
    


## RETURN VALUE



           Refer to fwprintf(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications using these functions should call _va_end_(_ap_)
           afterwards to clean up.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# dlerror

## NAME



           dlerror - obtain error diagnostic for functions in the dlopen API
    


## LIBRARY



           Dynamic linking library (_libdl_ , _-ldl_)
    


## SYNOPSIS



           **#include <dlfcn.h>**
    
           **char *dlerror(void);**
    


## DESCRIPTION



           The **dlerror**() function returns a human-readable, null-terminated
           string describing the most recent error that occurred from a call
           to one of the functions in the dlopen API since the last call to
           **dlerror**().  The returned string does _not_ include a trailing
           newline.
    
           **dlerror**() returns NULL if no errors have occurred since
           initialization or since it was last called.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The message returned by **dlerror**() may reside in a statically
           allocated buffer that is overwritten by subsequent **dlerror**()
           calls.
    


## EXAMPLES



           See dlopen(3).
    


* * *
# tcdrain

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



           tcdrain — wait for transmission of output
    


## SYNOPSIS



           #include <termios.h>
    
           int tcdrain(int _fildes_);
    


## DESCRIPTION



           The _tcdrain_() function shall block until all output written to the
           object referred to by _fildes_ is transmitted. The _fildes_ argument
           is an open file descriptor associated with a terminal.
    
           Any attempts to use _tcdrain_() from a process which is a member of
           a background process group on a _fildes_ associated with its
           controlling terminal, shall cause the process group to be sent a
           SIGTTOU signal.  If the calling thread is blocking SIGTTOU signals
           or the process is ignoring SIGTTOU signals, the process shall be
           allowed to perform the operation, and no signal is sent.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned. Otherwise, -1
           shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _tcdrain_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **EINTR** A signal interrupted _tcdrain_().
    
           **EIO** The process group of the writing process is orphaned, the
                  calling thread is not blocking SIGTTOU, and the process is
                  not ignoring SIGTTOU.
    
           **ENOTTY** The file associated with _fildes_ is not a terminal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_db_set_remove_function

## NAME



           gnutls_db_set_remove_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_db_set_remove_function(gnutls_session_t** _session_**,**
           **gnutls_db_remove_func** _rem_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_db_remove_func rem_func
                       is the function.
    


## DESCRIPTION



           Sets the function that will be used to remove data from the
           resumed sessions database. This function must return 0 on success.
    
           The first argument to  _rem_func_ will be null unless
           **gnutls_db_set_ptr()** has been called.
    


* * *
# gnutls_x509_crl_get_version

## NAME



           gnutls_x509_crl_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_version(gnutls_x509_crl_t** _crl_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    


## DESCRIPTION



           This function will return the version of the specified CRL.
    


## RETURNS



           The version number, or a negative error code on error.
    


* * *
# gnutls_pkcs12_generate_mac2

## NAME



           gnutls_pkcs12_generate_mac2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_generate_mac2(gnutls_pkcs12_t** _pkcs12_**,**
           **gnutls_mac_algorithm_t** _mac_**, const char ***_pass_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           gnutls_mac_algorithm_t mac
                       the MAC algorithm to use
    
           const char * pass
                       The password for the MAC
    


## DESCRIPTION



           This function will generate a MAC for the PKCS12 structure.
    


## RETURNS



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


* * *
# io_uring_sqe_set_buf_group

## NAME



           io_uring_sqe_set_buf_group - set buf group for submission queue
           event
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_sqe_set_buf_group(struct io_uring_sqe ***_sqe_**,**
                                           **int** _bgid_**);**
    


## DESCRIPTION



           The io_uring_sqe_set_buf_group(3) function sets the associated
           buf_group of the _sqe_ to _bgid_.
    
           After the caller has requested a submission queue entry (SQE) with
           io_uring_get_sqe(3), they can associate a buf_group with the SQE
           used for multishot operations.
    


## RETURN VALUE



           None
    


* * *
# gnutls_x509_aki_get_cert_issuer

## NAME



           gnutls_x509_aki_get_cert_issuer - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aki_get_cert_issuer(gnutls_x509_aki_t** _aki_**,**
           **unsigned int** _seq_**, unsigned int ***_san_type_**, gnutls_datum_t ***_san_**,**
           **gnutls_datum_t ***_othername_oid_**, gnutls_datum_t ***_serial_**);**
    


## ARGUMENTS



           gnutls_x509_aki_t aki
                       The authority key ID
    
           unsigned int seq
                       The index of the name to get
    
           unsigned int * san_type
                       Will hold the type of the name (of
                       **gnutls_subject_alt_names_t**)
    
           gnutls_datum_t * san
                       The alternative name data
    
           gnutls_datum_t * othername_oid
                       The object identifier if  _san_type_ is
                       **GNUTLS_SAN_OTHERNAME**
    
           gnutls_datum_t * serial
                       The authorityCertSerialNumber number
    


## DESCRIPTION



           This function will return a specific authorityCertIssuer name as
           stored in the  _aki_ type, as well as the authorityCertSerialNumber.
           All the returned values should be treated as constant, and may be
           set to **NULL** when are not required.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the index is out of
           bounds, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# wcpcpy

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



           wcpcpy — copy a wide-character string, returning a pointer to its
           end
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcpcpy(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_);
    


## DESCRIPTION



           Refer to wcscpy(3p).
    


* * *
# psignal

## NAME



           psignal, psiginfo - print signal description
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **void psignal(int** _sig_**, const char ***_s_**);**
           **void psiginfo(const siginfo_t ***_pinfo_**, const char ***_s_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **psignal**():
               Since glibc 2.19:
                       _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE || _SVID_SOURCE
    
           **psiginfo**():
               _POSIX_C_SOURCE >= 200809L
    


## DESCRIPTION



           The **psignal**() function displays a message on _stderr_ consisting of
           the string _s_ , a colon, a space, a string describing the signal
           number _sig_ , and a trailing newline.  If the string _s_ is NULL or
           empty, the colon and space are omitted.  If _sig_ is invalid, the
           message displayed will indicate an unknown signal.
    
           The **psiginfo**() function is like **psignal**(), except that it displays
           information about the signal described by _pinfo_ , which should
           point to a valid _siginfo_t_ structure.  As well as the signal
           description, **psiginfo**() displays information about the origin of
           the signal, and other information relevant to the signal (e.g.,
           the relevant memory address for hardware-generated signals, the
           child process ID for **SIGCHLD** , and the user ID and process ID of
           the sender, for signals set using kill(2) or sigqueue(3)).
    


## RETURN VALUE



           The **psignal**() and **psiginfo**() functions return no value.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## BUGS



           Up to glibc 2.12, **psiginfo**() had the following bugs:
    
           •  In some circumstances, a trailing newline is not printed.
    
           •  Additional details are not displayed for real-time signals.
    


* * *
# remque

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



           remque — remove an element from a queue
    


## SYNOPSIS



           #include <search.h>
    
           void remque(void *_element_);
    


## DESCRIPTION



           Refer to insque(3p).
    


* * *