tripathysagar/man_text huggingface dataset:
# mbrlen

## NAME



           mbrlen - determine number of bytes in next multibyte character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **size_t mbrlen(** size_t n;
                         **const char** _s_**[restrict** _n_**], size_t** _n_**,**
                         **mbstate_t *restrict** _ps_**);**
    


## DESCRIPTION



           The **mbrlen**() function inspects at most _n_ bytes of the multibyte
           string starting at _s_ and extracts the next complete multibyte
           character.  It updates the shift state _*ps_.  If the multibyte
           character is not the null wide character, it returns the number of
           bytes that were consumed from _s_.  If the multibyte character is
           the null wide character, it resets the shift state _*ps_ to the
           initial state and returns 0.
    
           If the _n_ bytes starting at _s_ do not contain a complete multibyte
           character, **mbrlen**() returns _(size_t) -2_.  This can happen even if
           _n_ >= _MB_CUR_MAX_ , if the multibyte string contains redundant shift
           sequences.
    
           If the multibyte string starting at _s_ contains an invalid
           multibyte sequence before the next complete character, **mbrlen**()
           returns _(size_t) -1_ and sets _errno_ to **EILSEQ**.  In this case, the
           effects on _*ps_ are undefined.
    
           If _ps_ is NULL, a static anonymous state known only to the **mbrlen**()
           function is used instead.
    


## RETURN VALUE



           The **mbrlen**() function returns the number of bytes parsed from the
           multibyte sequence starting at _s_ , if a non-null wide character was
           recognized.  It returns 0, if a null wide character was
           recognized.  It returns _(size_t) -1_ and sets _errno_ to **EILSEQ** , if
           an invalid multibyte sequence was encountered.  It returns
           _(size_t) -2_ if it couldn't parse a complete multibyte character,
           meaning that _n_ should be increased.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# libpfm_amd64_fam15h

## NAME



           libpfm_amd64_fam15h - support for AMD64 Family 15h processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam15h_interlagos**
           **PMU desc: AMD64 Fam15h Interlagos**
           **PMU name: amd64_fam15h_nb**
           **PMU desc: AMD64 Fam15h Northbridge**
    


## DESCRIPTION



           The library supports AMD Family 15h processors core PMU in both 32
           and 64-bit modes. The uncore (NorthBridge) PMU is also supported
           as a separate PMU model.
    


## MODIFIERS



           The following modifiers are supported on AMD64 Family 15h core
           PMU:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **h** Measure at while executing in host mode (when using
                  virtualization). This corresponds to **PFM_PLMH**.  This
                  modifier is available starting with Fam10h. This is a
                  boolean modifier.
    
           **g** Measure at while executing in guest mode (when using
                  virtualization). This modifier is available starting with
                  Fam10h. This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    
           The uncore (NorthBridge) PMU **does not support** any modifiers.
    


* * *
# function::read_stopwatch_s

## NAME



           function::read_stopwatch_s - Reads the time in seconds for a
           stopwatch
    


## SYNOPSIS



               read_stopwatch_s:long(name:string)
    


## ARGUMENTS



           _name_
               stopwatch name
    


## DESCRIPTION



           Returns time in seconds for stopwatch _name_. Creates stopwatch _name_
           if it does not currently exist.
    


* * *
# probe::stap.pass4.end

## NAME



           probe::stap.pass4.end - Finished stap pass4 (compile C code into
           kernel module)
    


## SYNOPSIS



           stap.pass4.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass4.end fires just before the jump to cleanup if s.last_pass = 4
    


* * *
# pcre2_get_error_message

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_get_error_message(int** _errorcode_**, PCRE2_UCHAR ***_buffer_**,**
             **PCRE2_SIZE** _bufflen_**);**
    


## DESCRIPTION



    
           This function provides a textual error message for each PCRE2
           error code.  Compilation errors are positive numbers; UTF
           formatting errors and matching errors are negative numbers. The
           arguments are:
    
             _errorcode_   an error code (positive or negative)
             _buffer_      where to put the message
             _bufflen_     the length of the buffer (code units)
    
           The function returns the length of the message in code units,
           excluding the trailing zero, or the negative error code
           PCRE2_ERROR_NOMEMORY if the buffer is too small. In this case, the
           returned message is truncated (but still with a trailing zero). If
           _errorcode_ does not contain a recognized error code number, the
           negative value PCRE2_ERROR_BADDATA is returned.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# probe::ioblock_trace.request

## NAME



           probe::ioblock_trace.request - Fires just as a generic block I/O
           request is created for a bio.
    


## SYNOPSIS



           ioblock_trace.request
    


## VALUES



           _bdev_
               target block device
    
           _ino_
               i-node number of the mapped file
    
           _p_start_sect_
               points to the start sector of the partition structure of the
               device
    
           _q_
               request queue on which this bio was queued.
    
           _bytes_done_
               number of bytes transferred
    
           _devname_
               block device name
    
           _size_
               total size in bytes
    
           _name_
               name of the probe point
    
           _rw_
               binary trace for read/write request
    
           _idx_
               offset into the bio vector array _phys_segments_ - number of
               segments in this bio after physical address coalescing is
               performed.
    
           _opf_
               operations and flags
    
           _vcnt_
               bio vector count which represents number of array element
               (page, offset, length) which make up this I/O request
    
           _bdev_contains_
               points to the device object which contains the partition (when
               bio structure represents a partition)
    
           _sector_
               beginning sector for the entire bio
    
           _flags_
               see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK
               1 RW_AHEAD set, and read/write would block BIO_EOF 2
               out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid
               BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce
               bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not
               supported
    


## CONTEXT



           The process makes block I/O request
    


* * *
# gnutls_pkcs11_copy_attached_extension

## NAME



           gnutls_pkcs11_copy_attached_extension - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_attached_extension(const char ***_token_url_**,**
           **gnutls_x509_crt_t** _crt_**, gnutls_datum_t ***_data_**, const char ***_label_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_x509_crt_t crt
                       An X.509 certificate object
    
           gnutls_datum_t * data
                       the attached extension
    
           const char * label
                       A name to be used for the attached extension (may be
                       **NULL**)
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_FLAG_*
    


## DESCRIPTION



           This function will copy an the attached extension in  _data_ for the
           certificate provided in  _crt_ in the PKCS **11** token specified by the
           URL (typically a trust module). The extension must be in RFC5280
           Extension format.
    


## RETURNS



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


## SINCE



           3.3.8
    


* * *
# libpfm_arm_ac8

## NAME



           libpfm_arm_ac8 - support for ARM Cortex A8 PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the ARM Cortex A8 core PMU.
    
           This PMU supports 2 counters and has no privilege levels
           filtering.  No event modifiers are available.
    


* * *
# gnutls_ocsp_resp_list_import2

## NAME



           gnutls_ocsp_resp_list_import2 - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_list_import2(gnutls_ocsp_resp_t ****_ocsps_**,**
           **unsigned int ***_size_**, const gnutls_datum_t ***_resp_data_**,**
           **gnutls_x509_crt_fmt_t** _format_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_t ** ocsps
                       Will hold the parsed OCSP response list.
    
           unsigned int * size
                       It will contain the size of the list.
    
           const gnutls_datum_t * resp_data
                       The PEM encoded OCSP list.
    
           gnutls_x509_crt_fmt_t format
                       One of **GNUTLS_X509_FMT_PEM** or **GNUTLS_X509_FMT_DER**
    
           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 OCSP response
           list to the native gnutls_ocsp_resp_t format. The output will be
           stored in  _ocsps_ which will be allocated and initialized.
    
           The OCSP responses should have a header of "OCSP RESPONSE".
    
           To deinitialize responses, you need to deinitialize each
           **gnutls_ocsp_resp_t** structure independently, and use **gnutls_free()**
           at  _ocsps_ .
    
           In PEM files, when no OCSP responses are detected
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## RETURNS



           the number of responses read or a negative error value.
    


## SINCE



           3.6.3
    


* * *
# auparse_normalize

## NAME



           auparse_normalize - normalize the current event
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_normalize(auparse_state_t**
           *****_au,_**normalize_option_t"**_opt);"_
    


## DESCRIPTION



           **auparse_normalize** analyzes the current event so that the important
           information about the event can be accessed through a normalized
           API which positions to internal field cursor to the exact record
           and field when asked about specific information.
    
           The auparse_normalize function takes an opt argument to tell it
           how much information to gather. Legal values are:
    
                NORM_OPT_ALL - gather maximum information
                NORM_OPT_NO_ATTRS - do not gather subject/object attribute information
    


## RETURN VALUE



           Returns 0 on success and 1 on error.
    


* * *
# sched_rr_get_interval

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



           sched_rr_get_interval — get execution time limits (**REALTIME**)
    


## SYNOPSIS



           #include <sched.h>
    
           int sched_rr_get_interval(pid_t _pid_ , struct timespec *_interval_);
    


## DESCRIPTION



           The _sched_rr_get_interval_() function shall update the **timespec**
           structure referenced by the _interval_ argument to contain the
           current execution time limit (that is, time quantum) for the
           process specified by _pid_.  If _pid_ is zero, the current execution
           time limit for the calling process shall be returned.
    


## RETURN VALUE



           If successful, the _sched_rr_get_interval_() function shall return
           zero. Otherwise, it shall return a value of -1 and set _errno_ to
           indicate the error.
    


## ERRORS



           The _sched_rr_get_interval_() function shall fail if:
    
           **ESRCH** No process can be found corresponding to that specified by
                  _pid_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::sprint_ubacktrace

## NAME



           function::sprint_ubacktrace - Return stack back trace for current
           user-space task as string.
    


## SYNOPSIS



               sprint_ubacktrace:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns a simple backtrace for the current task. One line per
           address. Includes the symbol name (or hex address if symbol
           couldn't be resolved) and module name (if found). Includes the
           offset from the start of the function if found, otherwise the
           offset will be added to the module (if found, between brackets).
           Returns the backtrace as string (each line terminated by a newline
           character). Note that the returned stack will be truncated to
           MAXSTRINGLEN, to print fuller and richer stacks use
           **print_ubacktrace**. Equivalent to sprint_ustack(**ubacktrace**), but
           more efficient (no need to translate between hex strings and final
           backtrace string).
    


## NOTE



           To get (full) backtraces for user space applications and shared
           shared libraries not mentioned in the current script run stap with
           -d /path/to/exe-or-so and/or add --ldd to load all needed unwind
           data.
    


* * *
# ibv_query_qp_data_in_order

## NAME



           ibv_query_qp_data_in_order - check if qp data is guaranteed to be
           in order.
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_query_qp_data_in_order(struct ibv_qp *qp, enum ibv_wr_opcode op, uint32_t flags);
    


## DESCRIPTION



           **ibv_query_qp_data_in_order()** Checks whether WQE data is guaranteed
           to be written in-order, and thus reader may poll for data instead
           of poll for completion.  This function indicates data is written
           in-order within each WQE, but cannot be used to determine ordering
           between separate WQEs.  This function describes ordering at the
           receiving side of the QP, not the sending side.
    


## ARGUMENTS



           _qp_
    
                  The local queue pair (QP) to query.
    
           _op_
    
                  The operation type to query about. Different operation types may write data in a different order.
                  For RDMA read operations: describes ordering of RDMA reads
                  posted on this local QP.  For RDMA write operations:
                  describes ordering of remote RDMA writes being done into
                  this local QP.  For RDMA send operations: describes
                  ordering of remote RDMA sends being done into this local
                  QP.  This function should not be used to determine ordering
                  of other operation types.
    
           _flags_  Flags are used to select a query type.  Supported values:
    
           IBV_QUERY_QP_DATA_IN_ORDER_RETURN_CAPS - Query for supported
           capabilities and return a capabilities vector.
    
           Passing 0 is equivalent to using
           IBV_QUERY_QP_DATA_IN_ORDER_RETURN_CAPS and checking for
           IBV_QUERY_QP_DATA_IN_ORDER_WHOLE_MSG support.
    


## RETURN VALUE



           **ibv_query_qp_data_in_order()** Return value is determined by flags.
           For each capability bit, 1 is returned if the data is guaranteed
           to be written in-order for selected operation and type, 0
           otherwise.  If IBV_QUERY_QP_DATA_IN_ORDER_RETURN_CAPS flag is
           used, return value can consist of following capabilities:
    
           IBV_QUERY_QP_DATA_IN_ORDER_WHOLE_MSG - All data is being written
           in order.
    
           IBV_QUERY_QP_DATA_IN_ORDER_ALIGNED_128_BYTES - Each 128 bytes
           aligned block is being written in order.
    
           If flags is 0, the function will return 1 if
           IBV_QUERY_QP_DATA_IN_ORDER_WHOLE_MSG is supported and 0 otherwise.
    


## NOTES



           Return value is valid only when the data is read by the CPU and
           relaxed ordering MR is not the target of the transfer.
    


* * *
# probe::ioscheduler.elv_next_request

## NAME



           probe::ioscheduler.elv_next_request - Fires when a request is
           retrieved from the request queue
    


## SYNOPSIS



           ioscheduler.elv_next_request
    


## VALUES



           _name_
               Name of the probe point
    
           _elevator_name_
               The type of I/O elevator currently enabled
    


* * *
# gnutls_ocsp_resp_check_crt

## NAME



           gnutls_ocsp_resp_check_crt - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_check_crt(gnutls_ocsp_resp_const_t** _resp_**,**
           **unsigned int** _indx_**, gnutls_x509_crt_t** _crt_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           unsigned int indx
                       Specifies response number to get. Use (0) to get the
                       first one.
    
           gnutls_x509_crt_t crt
                       The certificate to check
    


## DESCRIPTION



           This function will check whether the OCSP response is about the
           provided certificate.
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# gnutls_system_key_delete

## NAME



           gnutls_system_key_delete - API function
    


## SYNOPSIS



           **#include <gnutls/system-keys.h>**
    
           **int gnutls_system_key_delete(const char ***_cert_url_**, const char ***
           _key_url_**);**
    


## ARGUMENTS



           const char * cert_url
                       the URL of the certificate
    
           const char * key_url
                       the URL of the key
    


## DESCRIPTION



           This function will delete the key and certificate pair.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_hmac_init

## NAME



           gnutls_hmac_init - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hmac_init(gnutls_hmac_hd_t ***_dig_**,**
           **gnutls_mac_algorithm_t** _algorithm_**, const void ***_key_**, size_t**
           _keylen_**);**
    


## ARGUMENTS



           gnutls_hmac_hd_t * dig
                       is a **gnutls_hmac_hd_t** type
    
           gnutls_mac_algorithm_t algorithm
                       the HMAC algorithm to use
    
           const void * key
                       the key to be used for encryption
    
           size_t keylen
                       the length of the key
    


## DESCRIPTION



           This function will initialize an context that can be used to
           produce a Message Authentication Code (MAC) of data.  This will
           effectively use the current crypto backend in use by gnutls or the
           cryptographic accelerator in use.
    
           Note that despite the name of this function, it can be used for
           other MAC algorithms than HMAC.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# gnutls_crypto_register_digest

## NAME



           gnutls_crypto_register_digest - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_crypto_register_digest(gnutls_digest_algorithm_t**
           _algorithm_**, int** _priority_**, gnutls_digest_init_func** _init_**,**
           **gnutls_digest_hash_func** _hash_**, gnutls_digest_output_func** _output_**,**
           **gnutls_digest_deinit_func** _deinit_**, gnutls_digest_fast_func**
           _hash_fast_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t algorithm
                       is the gnutls digest identifier
    
           int priority
                       is the priority of the algorithm
    
           gnutls_digest_init_func init
                       A function which initializes the digest
    
           gnutls_digest_hash_func hash
                       Perform the hash operation
    
           gnutls_digest_output_func output
                       Provide the output of the digest
    
           gnutls_digest_deinit_func deinit
                       A function which deinitializes the digest
    
           gnutls_digest_fast_func hash_fast
                       Perform the digest operation in one go
    


## DESCRIPTION



           This function will register a digest algorithm to be used by
           gnutls.  Any algorithm registered will override the included
           algorithms and by convention kernel implemented algorithms have
           priority of 90 and CPU-assisted of 80.  The algorithm with the
           lowest priority will be used by gnutls.
    


## DEPRECATED



           since 3.7.0 it is no longer possible to override cipher
           implementation
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_hmac_deinit

## NAME



           gnutls_hmac_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_hmac_deinit(gnutls_hmac_hd_t** _handle_**, void ***_digest_**);**
    


## ARGUMENTS



           gnutls_hmac_hd_t handle
                       is a **gnutls_hmac_hd_t** type
    
           void * digest
                       is the output value of the MAC
    


## DESCRIPTION



           This function will deinitialize all resources occupied by the
           given hmac context.
    


## SINCE



           2.10.0
    


* * *
# io_uring_enable_rings

## NAME



           io_uring_enable_rings - enable a disabled ring
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_enable_rings(3) function enables a ring after having
           created it with the **IORING_SETUP_R_DISABLED** flag to
           io_uring_queue_init(3)
    
           It is not possible to submit work to such a ring until this
           function has been successfully called.
    


## RETURN VALUE



           io_uring_enable_rings(3) returns 0 on success. It otherwise
           returns a negative error code.  It does not write to **errno**.
    


## ERRORS



           **EBADFD** The ring was not disabled.
    


* * *
# gnutls_transport_set_ptr

## NAME



           gnutls_transport_set_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_ptr(gnutls_session_t** _session_**,**
           **gnutls_transport_ptr_t** _ptr_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_transport_ptr_t ptr
                       is the value.
    


## DESCRIPTION



           Used to set the first argument of the transport function (for push
           and pull callbacks). In berkeley style sockets this function will
           set the connection descriptor.
    


* * *
# optarg

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



           optarg, opterr, optind, optopt — options parsing variables
    


## SYNOPSIS



           #include <unistd.h>
    
           extern char *optarg;
           extern int opterr, optind, optopt;
    


## DESCRIPTION



           Refer to getopt(3p).
    


* * *
# tapset::timestamp_gtod

## NAME



           tapset::timestamp_gtod - systemtap timestamp_gtod tapset
    


## DESCRIPTION



           **gettimeofday_ns**
                  Number of nanoseconds since UNIX epoch
    
                  See function::gettimeofday_ns(3stap)
                   for details.
    
           **gettimeofday_us**
                  Number of microseconds since UNIX epoch
    
                  See function::gettimeofday_us(3stap)
                   for details.
    
           **gettimeofday_ms**
                  Number of milliseconds since UNIX epoch
    
                  See function::gettimeofday_ms(3stap)
                   for details.
    
           **gettimeofday_s**
                  Number of seconds since UNIX epoch
    
                  See function::gettimeofday_s(3stap)
                   for details.
    


* * *
# gnutls_pkcs7_delete_crt

## NAME



           gnutls_pkcs7_delete_crt - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_delete_crt(gnutls_pkcs7_t** _pkcs7_**, int** _indx_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           int indx    the index of the certificate to delete
    


## DESCRIPTION



           This function will delete a certificate from a PKCS7 or RFC2630
           certificate set.  Index starts from 0. Returns 0 on success.
    


## RETURNS



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


* * *
# gnutls_pkcs11_get_raw_issuer_by_subject_key_id

## NAME



           gnutls_pkcs11_get_raw_issuer_by_subject_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_get_raw_issuer_by_subject_key_id(const char ***
           _url_**, const gnutls_datum_t ***_dn_**, const gnutls_datum_t ***_spki_**,**
           **gnutls_datum_t ***_issuer_**, gnutls_x509_crt_fmt_t** _fmt_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           const char * url
                       A PKCS 11 url identifying a token
    
           const gnutls_datum_t * dn
                       is the DN to search for (may be **NULL**)
    
           const gnutls_datum_t * spki
                       is the subject key ID to search for
    
           gnutls_datum_t * issuer
                       Will hold the issuer if any in an allocated buffer.
    
           gnutls_x509_crt_fmt_t fmt
                       The format of the exported issuer.
    
           unsigned int flags
                       Use zero or flags from **GNUTLS_PKCS11_OBJ_FLAG**.
    


## DESCRIPTION



           This function will return the certificate with the given DN and
           _spki_ , if it is stored in the token. By default only marked as
           trusted issuers are returned. If any issuer should be returned
           specify **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_ANY** in  _flags_ .
    
           The name of the function includes issuer because it can be used to
           discover issuers of certificates.
    


## RETURNS



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


## SINCE



           3.4.2
    


* * *
# gnutls_pkcs11_get_raw_issuer_by_dn

## NAME



           gnutls_pkcs11_get_raw_issuer_by_dn - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_get_raw_issuer_by_dn(const char ***_url_**, const**
           **gnutls_datum_t ***_dn_**, gnutls_datum_t ***_issuer_**,**
           **gnutls_x509_crt_fmt_t** _fmt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * url
                       A PKCS 11 url identifying a token
    
           const gnutls_datum_t * dn
                       is the DN to search for
    
           gnutls_datum_t * issuer
                       Will hold the issuer if any in an allocated buffer.
    
           gnutls_x509_crt_fmt_t fmt
                       The format of the exported issuer.
    
           unsigned int flags
                       Use zero or flags from **GNUTLS_PKCS11_OBJ_FLAG**.
    


## DESCRIPTION



           This function will return the certificate with the given DN, if it
           is stored in the token. By default only marked as trusted issuers
           are returned. If any issuer should be returned specify
           **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_ANY** in  _flags_ .
    
           The name of the function includes issuer because it can be used to
           discover issuers of certificates.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# getpgrp

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



           getpgrp — get the process group ID of the calling process
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t getpgrp(void);
    


## DESCRIPTION



           The _getpgrp_() function shall return the process group ID of the
           calling process.
    


## RETURN VALUE



           The _getpgrp_() function shall always be successful and no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           4.3 BSD provides a _getpgrp_() function that returns the process
           group ID for a specified process. Although this function supports
           job control, all known job control shells always specify the
           calling process with this function. Thus, the simpler System V
           _getpgrp_() suffices, and the added complexity of the 4.3 BSD
           _getpgrp_() is provided by the XSI extension _getpgid_().
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::set_u64_arg

## NAME



           function::set_u64_arg - Set function argument as unsigned 64-bit
           value
    


## SYNOPSIS



               set_u64_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the unsigned 64-bit value of argument n, same as
           ulonglong_arg.
    


* * *
# io_uring_prep_remove_buffers

## NAME



           io_uring_prep_remove_buffers - prepare a remove buffers request
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_prep_remove_buffers(3) function prepares a request
           for removing previously supplied buffers. The submission queue
           entry _sqe_ is setup to remove _nr_ number of buffers from the buffer
           group ID indicated by _bgid_.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field. On
           success, _res_ will contain the number of successfully removed
           buffers. On error, the following errors can occur.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the request.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-ENOENT**
                  No buffers exist at the specified _bgid_ buffer group ID.
    


* * *
# pam_end

## NAME



           pam_end - termination of PAM transaction
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_end** function terminates the PAM transaction and is the
           last function an application should call in the PAM context. Upon
           return the handle _pamh_ is no longer valid and all memory
           associated with it will be invalid.
    
           The _pam_status_ argument should be set to the value returned to the
           application by the last PAM library call.
    
           The value taken by _pam_status_ is used as an argument to the module
           specific callback function, **cleanup()**(See pam_set_data(3) and
           pam_get_data(3)). In this way the module can be given notification
           of the pass/fail nature of the tear-down process, and perform any
           last minute tasks that are appropriate to the module before it is
           unlinked. This argument can be logically OR'd with _PAM_DATA_SILENT_
           to indicate that the module should not treat the call too
           seriously. It is generally used to indicate that the current
           closing of the library is in a fork(2)ed process, and that the
           parent will take care of cleaning up things that exist outside of
           the current process space (files etc.).
    
           This function _free_ 's all memory for items associated with the
           pam_set_item(3) and pam_get_item(3) functions. Pointers associated
           with such objects are not valid anymore after **pam_end** was called.
    


## RETURN VALUES



           PAM_SUCCESS
               Transaction was successful terminated.
    
           PAM_SYSTEM_ERR
               System error, for example a NULL pointer was submitted as PAM
               handle or the function was called by a module.
    


* * *
# posix_trace_attr_setinherited

## PROLOG



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


## NAME



           posix_trace_attr_setinherited, posix_trace_attr_setlogfullpolicy —
           retrieve and set the behavior of a trace stream (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_attr_setinherited(trace_attr_t *_attr_ ,
               int _inheritancepolicy_);
           int posix_trace_attr_setlogfullpolicy(trace_attr_t *_attr_ ,
               int _logpolicy_);
    


## DESCRIPTION



           Refer to posix_trace_attr_getinherited(3p).
    


* * *
# gnutls_strerror

## NAME



           gnutls_strerror - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_strerror(int** _error_**);**
    


## ARGUMENTS



           int error   is a GnuTLS error code, a negative error code
    


## DESCRIPTION



           This function is similar to strerror.  The difference is that it
           accepts an error number returned by a gnutls function; In case of
           an unknown error a descriptive string is sent instead of **NULL**.
    
           Error codes are always a negative error code.
    


## RETURNS



           A string explaining the GnuTLS error message.
    


* * *
# gnutls_x509_crt_get_extension_info

## NAME



           gnutls_x509_crt_get_extension_info - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       Specifies which extension OID to send. Use (0) to get
                       the first one.
    
           void * oid  a pointer to a structure to hold the OID
    
           size_t * oid_size
                       initially holds the maximum size of  _oid_ , on return
                       holds actual size of  _oid_ .
    
           unsigned int * critical
                       output variable with critical flag, may be NULL.
    


## DESCRIPTION



           This function will return the requested extension OID in the
           certificate, and the critical flag for it.  The extension OID will
           be stored as a string in the provided buffer.  Use
           **gnutls_x509_crt_get_extension()** to extract the data.
    
           If the buffer provided is not long enough to hold the output, then
            _oid_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** will be
           returned. The  _oid_ returned will be null terminated, although
            _oid_size_ will not account for the trailing null (the latter is
           not true for GnuTLS prior to 3.6.0).
    


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


* * *
# audit_name_to_flag

## NAME



           audit_name_to_flag - Convert the rule-matching filter name to the
           numeric rule-matching filter value
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_name_to_flag(const char** _*flag_**);**
    


## DESCRIPTION



           **audit_name_to_flag**() converts the rule-matching filter name
           ("task", "exit", "user", "exclude", "filesystem") to the numeric
           rule-matching filter value (AUDIT_FILTER_TASK, AUDIT_FILTER_EXIT,
           AUDIT_FILTER_USER, AUDIT_FILTER_EXCLUDE, AUDIT_FILTER_FS).  _flag_
           is the rule-matching filter name.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, the return value is the
           numeric rule-matching filter value.
    


* * *
# uuid_unparse

## NAME



           uuid_unparse - convert a UUID from binary representation to a
           string
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **void uuid_unparse(const uuid_t** _uu_**, char ***_out_**);**
           **void uuid_unparse_upper(const uuid_t** _uu_**, char ***_out_**);**
           **void uuid_unparse_lower(const uuid_t** _uu_**, char ***_out_**);**
    


## DESCRIPTION



           The **uuid_unparse**() function converts the supplied UUID _uu_ from the
           binary representation into a 36-byte string (plus trailing '\0')
           of the form 1b4e28ba-2fa1-11d2-883f-0016d3cca427 and stores this
           value in the character string pointed to by _out_. The case of the
           hex digits returned by **uuid_unparse**() may be upper or lower case,
           and is dependent on the system-dependent local default.
    
           If the case of the hex digits is important then the functions
           **uuid_unparse_upper**() and **uuid_unparse_lower**() may be used.
    


## CONFORMING TO



           This library unparses UUIDs compatible with OSF DCE 1.1.
    


## AVAILABILITY



           The **libuuid** library is part of the util-linux package since
           version 2.15.1. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                _UUID_UNPARSE_(3)
    


* * *
# gnutls_record_check_corked

## NAME



           gnutls_record_check_corked - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **size_t gnutls_record_check_corked(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function checks if there pending corked data in the gnutls
           buffers --see **gnutls_record_cork()**.
    


## RETURNS



           Returns the size of the corked data or zero.
    


## SINCE



           3.2.8
    


* * *
# pthread_exit

## NAME



           pthread_exit - terminate calling thread
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **[[noreturn]] void pthread_exit(void ***_retval_**);**
    


## DESCRIPTION



           The **pthread_exit**() function terminates the calling thread and
           returns a value via _retval_ that (if the thread is joinable) is
           available to another thread in the same process that calls
           pthread_join(3).
    
           Any clean-up handlers established by pthread_cleanup_push(3) that
           have not yet been popped, are popped (in the reverse of the order
           in which they were pushed) and executed.  If the thread has any
           thread-specific data, then, after the clean-up handlers have been
           executed, the corresponding destructor functions are called, in an
           unspecified order.
    
           When a thread terminates, process-shared resources (e.g., mutexes,
           condition variables, semaphores, and file descriptors) are not
           released, and functions registered using atexit(3) are not called.
    
           After the last thread in a process terminates, the process
           terminates as by calling exit(3) with an exit status of zero;
           thus, process-shared resources are released and functions
           registered using atexit(3) are called.
    


## RETURN VALUE



           This function does not return to the caller.
    


## ERRORS



           This function always succeeds.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           Performing a return from the start function of any thread other
           than the main thread results in an implicit call to
           **pthread_exit**(), using the function's return value as the thread's
           exit status.
    
           To allow other threads to continue execution, the main thread
           should terminate by calling **pthread_exit**() rather than exit(3).
    
           The value pointed to by _retval_ should not be located on the
           calling thread's stack, since the contents of that stack are
           undefined after the thread terminates.
    


## BUGS



           Currently, there are limitations in the kernel implementation
           logic for wait(2)ing on a stopped thread group with a dead thread
           group leader.  This can manifest in problems such as a locked
           terminal if a stop signal is sent to a foreground process whose
           thread group leader has already called **pthread_exit**().
    


* * *