tripathysagar/man_text huggingface dataset:
# posix_trace_timedgetnext_event

## 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_timedgetnext_event — retrieve a trace event (**TRACING**)
    


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_timedgetnext_event(trace_id_t _trid_ ,
               struct posix_trace_event_info *restrict _event_ ,
               void *restrict _data_ , size_t _num_bytes_ ,
               size_t *restrict _data_len_ , int *restrict _unavailable_ ,
               const struct timespec *restrict _abstime_);
    


## DESCRIPTION



           Refer to posix_trace_getnext_event(3p).
    


* * *
# wcsncmp

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



           wcsncmp — compare part of two wide-character strings
    


## SYNOPSIS



           #include <wchar.h>
    
           int wcsncmp(const wchar_t *_ws1_ , const wchar_t *_ws2_ , size_t _n_);
    


## 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 _wcsncmp_() function shall compare not more than _n_ wide-
           character codes (wide-character codes that follow a null wide-
           character code are not compared) from the array pointed to by _ws1_
           to the array pointed to by _ws2_.
    
           The sign of a non-zero return value shall be determined by the
           sign of the difference between the values of the first pair of
           wide-character codes that differ in the objects being compared.
    


## RETURN VALUE



           Upon successful completion, _wcsncmp_() shall return an integer
           greater than, equal to, or less than 0, if the possibly null-
           terminated array pointed to by _ws1_ is greater than, equal to, or
           less than the possibly null-terminated array pointed to by _ws2_ ,
           respectively.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_heartbeat_ping

## NAME



           gnutls_heartbeat_ping - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_heartbeat_ping(gnutls_session_t** _session_**, size_t**
           _data_size_**, unsigned int** _max_tries_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t data_size
                       is the length of the ping payload.
    
           unsigned int max_tries
                       if flags is **GNUTLS_HEARTBEAT_WAIT** then this sets the
                       number of retransmissions. Use zero for indefinite
                       (until timeout).
    
           unsigned int flags
                       if **GNUTLS_HEARTBEAT_WAIT** then wait for pong or timeout
                       instead of returning immediately.
    


## DESCRIPTION



           This function sends a ping to the peer. If the  _flags_ is set to
           **GNUTLS_HEARTBEAT_WAIT** then it waits for a reply from the peer.
    
           Note that it is highly recommended to use this function with the
           flag **GNUTLS_HEARTBEAT_WAIT** , or you need to handle retransmissions
           and timeouts manually.
    
           The total TLS data transmitted as part of the ping message are
           given by the following formula: MAX(16,  _data_size_
           )+**gnutls_record_overhead_size()** +3.
    


## RETURNS



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


## SINCE



           3.1.2
    


* * *
# gnutls_x509_trust_list_init

## NAME



           gnutls_x509_trust_list_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_init(gnutls_x509_trust_list_t ***_list_**,**
           **unsigned int** _size_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t * list
                       A pointer to the type to be initialized
    
           unsigned int size
                       The size of the internal hash table. Use (0) for
                       default size.
    


## DESCRIPTION



           This function will initialize an X.509 trust list structure.
    


## RETURNS



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


## SINCE



           3.0.0
    


* * *
# wmemcmp

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



           wmemcmp — compare wide characters in memory
    


## SYNOPSIS



           #include <wchar.h>
    
           int wmemcmp(const wchar_t *_ws1_ , const wchar_t *_ws2_ , size_t _n_);
    


## 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 _wmemcmp_() function shall compare the first _n_ wide characters
           of the object pointed to by _ws1_ to the first _n_ wide characters of
           the object pointed to by _ws2_.  This function shall not be affected
           by locale and all **wchar_t** values shall be treated identically. The
           null wide character and **wchar_t** values not corresponding to valid
           characters shall not be treated specially.
    
           If _n_ is zero, the application shall ensure that _ws1_ and _ws2_ are
           valid pointers, and the function shall behave as if the two
           objects compare equal.
    


## RETURN VALUE



           The _wmemcmp_() function shall return an integer greater than, equal
           to, or less than zero, respectively, as the object pointed to by
           _ws1_ is greater than, equal to, or less than the object pointed to
           by _ws2_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# mlx5dv_devx_destroy_event_channel

## NAME



           mlx5dv_devx_create_event_channel - Create an event channel to be
           used for DEVX asynchronous events.
    
           mlx5dv_devx_destroy_event_channel - Destroy a DEVX event channel.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_event_channel {
                      int fd;
                  };
    
                  struct mlx5dv_devx_event_channel *
                  mlx5dv_devx_create_event_channel(struct ibv_context *context,
                                                   enum mlx5dv_devx_create_event_channel_flags flags)
    
                  void mlx5dv_devx_destroy_event_channel(struct mlx5dv_devx_event_channel *event_channel)
    


## DESCRIPTION



           Create or destroy a channel to be used for DEVX asynchronous
           events.
    
           The create verb exposes an mlx5dv_devx_event_channel object that
           can be used to read asynchronous DEVX events.  This lets an
           application to subscribe to get device events and once an event
           occurred read it from this object.
    


## ARGUMENTS



           _context_
    
                  RDMA device context to create the channel on.
    
           _flags_  MLX5DV_DEVX_CREATE_EVENT_CHANNEL_FLAGS_OMIT_EV_DATA: omit
                  the event data on this channel.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_event_channel_ will return a new
           _struct mlx5dv_devx_event_channel_ object, on error NULL will be
           returned and errno will be set.
    


* * *
# auparse_first_field

## NAME



           auparse_first_field - reposition field cursor
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_first_field repositions the library's internal cursor to
           point to the first field of the current record in the current
           event.
    


## RETURN VALUE



           Returns 0 if there is no event data; otherwise, 1 for success.
    


* * *
# aio_return

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



           aio_return — retrieve return status of an asynchronous I/O
           operation
    


## SYNOPSIS



           #include <aio.h>
    
           ssize_t aio_return(struct aiocb *_aiocbp_);
    


## DESCRIPTION



           The _aio_return_() function shall return the return status
           associated with the **aiocb** structure referenced by the _aiocbp_
           argument. The return status for an asynchronous I/O operation is
           the value that would be returned by the corresponding _read_(),
           _write_(), or _fsync_() function call. If the error status for the
           operation is equal to **[EINPROGRESS]** , then the return status for
           the operation is undefined. The _aio_return_() function may be
           called exactly once to retrieve the return status of a given
           asynchronous operation; thereafter, if the same **aiocb** structure is
           used in a call to _aio_return_() or _aio_error_(), an error may be
           returned. When the **aiocb** structure referred to by _aiocbp_ is used
           to submit another asynchronous operation, then _aio_return_() may be
           successfully used to retrieve the return status of that operation.
    


## RETURN VALUE



           If the asynchronous I/O operation has completed, then the return
           status, as described for _read_(), _write_(), and _fsync_(), shall be
           returned. If the asynchronous I/O operation has not yet completed,
           the results of _aio_return_() are undefined.
    
           If the _aio_return_() function fails, it shall return -1 and set
           _errno_ to indicate the error.
    


## ERRORS



           The _aio_return_() function may fail if:
    
           **EINVAL** The _aiocbp_ argument does not refer to an asynchronous
                  operation whose return status has not yet been retrieved.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::str_replace

## NAME



           function::str_replace - str_replace Replaces all instances of a
           substring with another
    


## SYNOPSIS



               str_replace:string(prnt_str:string,srch_str:string,rplc_str:string)
    


## ARGUMENTS



           _prnt_str_
               the string to search and replace in
    
           _srch_str_
               the substring which is used to search in _prnt_str_ string
    
           _rplc_str_
               the substring which is used to replace _srch_str_
    


## DESCRIPTION



           This function returns the given string with substrings replaced.
    


* * *
# gnutls_x509_crl_sign2

## NAME



           gnutls_x509_crl_sign2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_sign2(gnutls_x509_crl_t** _crl_**, gnutls_x509_crt_t**
           _issuer_**, gnutls_x509_privkey_t** _issuer_key_**,**
           **gnutls_digest_algorithm_t** _dig_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           gnutls_x509_crt_t issuer
                       is the certificate of the certificate issuer
    
           gnutls_x509_privkey_t issuer_key
                       holds the issuer's private key
    
           gnutls_digest_algorithm_t dig
                       The message digest to use. GNUTLS_DIG_SHA256 is the
                       safe choice unless you know what you're doing.
    
           unsigned int flags
                       must be 0
    


## DESCRIPTION



           This function will sign the CRL with the issuer's private key, and
           will copy the issuer's information into the CRL.
    
           This must be the last step in a certificate CRL since all the
           previously set parameters are now signed.
    
           A known limitation of this function is, that a newly-signed CRL
           will not be fully functional (e.g., for signature verification),
           until it is exported an re-imported.
    
           After GnuTLS 3.6.1 the value of  _dig_ may be **GNUTLS_DIG_UNKNOWN** ,
           and in that case, a suitable but reasonable for the key algorithm
           will be selected.
    


## RETURNS



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


* * *
# tsearch

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



           tsearch — search a binary search tree
    


## SYNOPSIS



           #include <search.h>
    
           void *tsearch(const void *_key_ , void **_rootp_ ,
               int (*_compar_)(const void *, const void *));
    


## DESCRIPTION



           Refer to tdelete(3p).
    


* * *
# gnutls_pkcs11_privkey_get_info

## NAME



           gnutls_pkcs11_privkey_get_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_get_info(gnutls_pkcs11_privkey_t** _pkey_**,**
           **gnutls_pkcs11_obj_info_t** _itype_**, void ***_output_**, size_t ***
           _output_size_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t pkey
                       should contain a **gnutls_pkcs11_privkey_t** type
    
           gnutls_pkcs11_obj_info_t itype
                       Denotes the type of information requested
    
           void * output
                       where output will be stored
    
           size_t * output_size
                       contains the maximum size of the output and will be
                       overwritten with actual
    


## DESCRIPTION



           This function will return information about the PKCS 11 private
           key such as the label, id as well as token information where the
           key is stored. When output is text it returns null terminated
           string although **output_size** contains the size of the actual data
           only.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error code on error.
    


* * *
# function::set_u32_arg

## NAME



           function::set_u32_arg - Set function argument as unsigned 32-bit
           value
    


## SYNOPSIS



               set_u32_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the unsigned 32-bit value of argument n, same as uint_arg.
    


* * *
# gnutls_privkey_set_flags

## NAME



           gnutls_privkey_set_flags - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **void gnutls_privkey_set_flags(gnutls_privkey_t** _key_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       A key of type **gnutls_privkey_t**
    
           unsigned int flags
                       flags from the **gnutls_privkey_flags**
    


## DESCRIPTION



           This function will set flags for the specified private key, after
           it is generated. Currently this is useful for the
           **GNUTLS_PRIVKEY_FLAG_EXPORT_COMPAT** to allow exporting a "provable"
           private key in backwards compatible way.
    


## SINCE



           3.5.0
    


* * *
# pcre2_match_context_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_match_context_free(pcre2_match_context ***_mcontext_**);**
    


## DESCRIPTION



    
           This function frees the memory occupied by a match context, using
           the memory freeing function from the general context with which it
           was created, or **free()** if that was not set. If the argument is
           NULL, the function returns immediately without doing anything.
    
           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.
    


* * *
# function::commit

## NAME



           function::commit - Write out all output related to a speculation
           buffer
    


## SYNOPSIS



               commit(id:long)
    


## ARGUMENTS



           _id_
               of the buffer to store the information in
    


## DESCRIPTION



           Output all the output for _id_ in the order that it was entered into
           the speculative buffer by **speculative**.
    


* * *
# gnutls_idna_map

## NAME



           gnutls_idna_map - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_idna_map(const char ***_input_**, unsigned** _ilen_**,**
           **gnutls_datum_t ***_out_**, unsigned** _flags_**);**
    


## ARGUMENTS



           const char * input
                       contain the UTF-8 formatted domain name
    
           unsigned ilen
                       the length of the provided string
    
           gnutls_datum_t * out
                       the result in an null-terminated allocated string
    
           unsigned flags
                       should be zero
    


## DESCRIPTION



           This function will convert the provided UTF-8 domain name, to its
           IDNA mapping in an allocated variable. Note that depending on the
           flags the used gnutls library was compiled with, the output of
           this function may vary (i.e., may be IDNA2008, or IDNA2003).
    
           To force IDNA2008 specify the flag **GNUTLS_IDNA_FORCE_2008**. In the
           case GnuTLS is not compiled with the necessary dependencies,
           **GNUTLS_E_UNIMPLEMENTED_FEATURE** will be returned to indicate that
           gnutls is unable to perform the requested conversion.
    
           Note also, that this function will return an empty string if an
           empty string is provided as input.
    


## RETURNS



           **GNUTLS_E_INVALID_UTF8_STRING** on invalid UTF-8 data, or 0 on
           success.
    


## SINCE



           3.5.8
    


* * *
# gnutls_x509_policy_release

## NAME



           gnutls_x509_policy_release - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_policy_release(struct gnutls_x509_policy_st ***
           _policy_**);**
    


## ARGUMENTS



           struct gnutls_x509_policy_st * policy
                       a certificate policy
    


## DESCRIPTION



           This function will deinitialize all memory associated with the
           provided
            _policy_ . The policy is allocated using
           **gnutls_x509_crt_get_policy()**.
    


## SINCE



           3.1.5
    


* * *
# gnutls_x509_name_constraints_deinit

## NAME



           gnutls_x509_name_constraints_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void**
           **gnutls_x509_name_constraints_deinit(gnutls_x509_name_constraints_t**
           _nc_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t nc
                       The nameconstraints
    


## DESCRIPTION



           This function will deinitialize a name constraints type.
    


## SINCE



           3.3.0
    


* * *
# sd_bus_set_method_call_timeout

## NAME



           sd_bus_set_method_call_timeout, sd_bus_get_method_call_timeout -
           Set or query the default D-Bus method call timeout of a bus object
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_set_method_call_timeout(sd_bus ***_bus_**, uint64_t** _usec_**);**
    
           **int sd_bus_get_method_call_timeout(sd_bus ***_bus_**, uint64_t ***_ret_**);**
    


## DESCRIPTION



           **sd_bus_set_method_call_timeout()** sets the default D-Bus method
           call timeout of _bus_ to _usec_ microseconds.
    
           **sd_bus_get_method_call_timeout()** queries the default D-Bus method
           call timeout of _bus_. If no method call timeout was set using
           **sd_bus_set_method_call_timeout()** , the timeout is read from the
           _$SYSTEMD_BUS_TIMEOUT_ environment variable. If this environment
           variable is unset or does not contain a valid timeout, the
           implementation falls back to a predefined method call timeout of
           25 seconds. Note that _$SYSTEMD_BUS_TIMEOUT_ is read once and cached
           so callers should not rely on being able to change the default
           method call timeout at runtime by changing the value of
           _$SYSTEMD_BUS_TIMEOUT_. Instead, call
           **sd_bus_set_method_call_timeout()** to change the default method call
           timeout.
    


## RETURN VALUE



           On success, these functions return a non-negative integer. On
           failure, they return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The parameters _bus_ or _ret_ are **NULL**.
    
               Added in version 246.
    
           **-ENOPKG**
               Bus object _bus_ could not be resolved.
    
               Added in version 246.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# io_uring_unregister_eventfd

## NAME



           io_uring_register_eventfd - register an eventfd with a ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_eventfd(struct io_uring ***_ring_**,**
                                         **int** _fd_**);**
    
           **int io_uring_register_eventfd_async(struct io_uring ***_ring_**,**
                                               **int** _fd_**);**
    
           **int io_uring_unregister_eventfd(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_register_eventfd(3) registers the eventfd file descriptor
           _fd_ with the ring identified by _ring_.
    
           Whenever completions are posted to the CQ ring, an eventfd
           notification is generated with the registered eventfd descriptor.
           If io_uring_register_eventfd_async(3) is used, only events that
           completed out-of-line will trigger a notification.
    
           It notifications are no longer desired,
           io_uring_unregister_eventfd(3) may be called to remove the eventfd
           registration. No eventfd argument is needed, as a ring can only
           have a single eventfd registered.
    


## NOTES



           While io_uring generally takes care to avoid spurious events, they
           can occur.  Similarly, batched completions of CQEs may only
           trigger a single eventfd notification even if multiple CQEs are
           posted. The application should make no assumptions on number of
           events being available having a direct correlation to eventfd
           notifications posted. An eventfd notification must thus only be
           treated as a hint to check the CQ ring for completions.
    


## RETURN VALUE



           Returns 0 on success, or **-errno** on error.
    


* * *
# gnutls_x509_crt_set_subject_alt_name

## NAME



           gnutls_x509_crt_set_subject_alt_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_subject_alt_name(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_subject_alt_name_t** _type_**, const void ***_data_**, unsigned**
           **int** _data_size_**, unsigned int** _flags_**);**
    


## ARGUMENTS



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


## DESCRIPTION



           This function will set the subject alternative name certificate
           extension. It can set the following types: **GNUTLS_SAN_DNSNAME** as a
           text string, **GNUTLS_SAN_RFC822NAME** as a text string,
           **GNUTLS_SAN_URI** as a text string, **GNUTLS_SAN_IPADDRESS** as a binary
           IP address (4 or 16 bytes), **GNUTLS_SAN_OTHERNAME_XMPP** as a UTF8
           string (since 3.5.0).
    
           Since version 3.5.7 the **GNUTLS_SAN_RFC822NAME** , **GNUTLS_SAN_DNSNAME** ,
           and **GNUTLS_SAN_OTHERNAME_XMPP** are converted to ACE format when
           necessary.
    


## RETURNS



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


## SINCE



           2.6.0
    


* * *
# function::inet_get_ip_dest

## NAME



           function::inet_get_ip_dest - Provide IP destination address string
           for a kernel socket
    


## SYNOPSIS



               inet_get_ip_dest:string(sock:long)
    


## ARGUMENTS



           _sock_
               pointer to the kernel socket
    


* * *
# pmdelprofile

## NAME



           **pmDelProfile** - delete instance(s) from the current PMAPI instance
           profile
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmDelProfile(pmInDom** _indom_**, int** _numinst_**, int ***_instlist_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  set  of  instances  for  performance  metrics returned from a
           pmFetch(3) call may be filtered or restricted  using  an  instance
           profile.   There  is one instance profile for each context the ap‐
           plication creates at the Performance Metrics Application  Program‐
           ming  Interface (PMAPI), and each instance profile may include in‐
           stances from one or more instance domains (see pmLookupDesc(3)).
    
           **pmDelProfile** may be used to delete  instance  specifications  from
           the instance profile of the current PMAPI context.
    
           In  the  simplest variant, the list of instances identified by the
           _instlist_ argument for the _indom_ instance domain are  removed  from
           the  instance  profile.  The list of instance identifiers contains
           _numinst_ values.
    
           The _indom_ value  would  normally  be  extracted  from  a  call  to
           pmLookupDesc(3)  for  a particular performance metric, and the in‐
           stances in _instlist_ would typically  be  determined  by  calls  to
           pmGetInDom(3) or pmLookupInDom(3).
    
           If  _indom_  equals  **PM_INDOM_NULL** and _numinst_ is zero, then all in‐
           stance domains are selected for deletion.  If  _instlist_  is  _NULL_ ,
           then  all instances in the selected domain(s) are removed from the
           profile.
    
           To disable all available instances in all domains,  use  _pmDelPro‐_
           _file(PM_INDOM_NULL, 0, NULL)_.  This is the only situation in which
           _indom_ may be **PM_INDOM_NULL**.
    


## CAVEAT



           It is possible to delete non-existent instance domains and non-ex‐
           istent  instances  from an instance profile.  None of the routines
           that use the instance profile will ever issue an error if  you  do
           this.   The cost of checking, when checking is possible, outweighs
           any benefits.
    


## DIAGNOSTICS



           **PM_ERR_PROFILESPEC**
                  _indom_ was **PM_INDOM_NULL** and _instlist_ was not empty
    


* * *
# gnutls_pkcs12_bag_set_friendly_name

## NAME



           gnutls_pkcs12_bag_set_friendly_name - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_set_friendly_name(gnutls_pkcs12_bag_t** _bag_**,**
           **unsigned** _indx_**, const char ***_name_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           unsigned indx
                       The bag's element to add the id
    
           const char * name
                       the name
    


## DESCRIPTION



           This function will add the given key friendly name, to the
           specified, by the index, bag element. The name will be encoded as
           a 'Friendly name' bag attribute, which is usually used to set a
           user name to the local private key and the certificate pair.
    


## RETURNS



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


* * *
# probe::tcp.receive

## NAME



           probe::tcp.receive - Called when a TCP packet is received
    


## SYNOPSIS



           tcp.receive
    


## VALUES



           _saddr_
               A string representing the source IP address
    
           _protocol_
               Packet protocol from driver
    
           _family_
               IP address family
    
           _iphdr_
               IP header address
    
           _psh_
               TCP PSH flag
    
           _ack_
               TCP ACK flag
    
           _dport_
               TCP destination port
    
           _fin_
               TCP FIN flag
    
           _name_
               Name of the probe point
    
           _urg_
               TCP URG flag
    
           _daddr_
               A string representing the destination IP address
    
           _rst_
               TCP RST flag
    
           _sport_
               TCP source port
    
           _syn_
               TCP SYN flag
    


* * *
# fetestexcept

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



           fetestexcept — test floating-point exception flags
    


## SYNOPSIS



           #include <fenv.h>
    
           int fetestexcept(int _excepts_);
    


## 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 _fetestexcept_() function shall determine which of a specified
           subset of the floating-point exception flags are currently set.
           The _excepts_ argument specifies the floating-point status flags to
           be queried.
    


## RETURN VALUE



           The _fetestexcept_() function shall return the value of the bitwise-
           inclusive OR of the floating-point exception macros corresponding
           to the currently set floating-point exceptions included in
           _excepts_.
    


## ERRORS



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


## EXAMPLES



           The following example calls function _f_() if an invalid exception
           is set, and then function _g_() if an overflow exception is set:
    
               #include <fenv.h>
               /* ... */
               {
                   #pragma STDC FENV_ACCESS ON
                   int set_excepts;
                   feclearexcept(FE_INVALID | FE_OVERFLOW);
                   // maybe raise exceptions
                   set_excepts = fetestexcept(FE_INVALID | FE_OVERFLOW);
                   if (set_excepts & FE_INVALID) f();
                   if (set_excepts & FE_OVERFLOW) g();
                   /* ... */
               }
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::stap.pass1a

## NAME



           probe::stap.pass1a - Starting stap pass1 (parsing user script)
    


## SYNOPSIS



           stap.pass1a
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass1a fires just after the call to **gettimeofday** , before the user
           script is parsed.
    


* * *
# function::user_char

## NAME



           function::user_char - Retrieves a char value stored in user space
    


## SYNOPSIS



               user_char:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the char from
    


## DESCRIPTION



           Returns the char value from a given user space address. Returns
           zero when user space data is not accessible.
    


* * *
# pmarewritedata

## NAME



           **pmaRewriteData** - try to change the version of an archive data
           record
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **int pmaRewriteData(int** _invers_**, int** _outvers_ **__int32_t ***_rbuf_**);**
    
           **cc ... -lpcp_archive -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



           A physical data record from a version _invers_ archive is passed  in
           via _rbuf_ and this is reformatted if required to produce the equiv‐
           alent data record for a version _outvers_ archive.
    
           Archive  data  records  provide  the encoding of a **pmResult** for an
           archive data volume.
    
           The only sane choice of _invers_ and _outvers_ today is  **PM_LOG_VERS02**
           and  **PM_LOG_VERS03** respectively,  which  would  be  requesting  a
           rewrite from archive version 2 format to archive version 3  format
           (as only versions 2 and 3 are currently supported).
    
           If  rewriting takes place the old _rbuf_ will have been free'd and a
           new _rbuf_ allocated with malloc(3).  It is the  caller's  responsi‐
           bility to make sure this potential free-and-allocate will be safe,
           e.g.  no dangling references into the contents of _rbuf_ , or pass in
           a copy of the record if it is precious.
    


## DIAGNOSTICS AND RETURN VALUES



           In several places, fatal errors will trigger an error message  and
           force the application to exit.
    
           If  there  is  no  defined translation from _invers_ to _outvers_ then
           **pmaRewriteData** returns **PM_ERR_APPVERSION**(a slight  perversion  of
           this error code).
    
           If no rewrite is performed, the return value is 0, otherwise a re‐
           turn  value  of 1 indicates a rewrite has taken place and _rbuf_ has
           been reallocated.
    


* * *
# rdma_create_event_channel

## NAME



           rdma_create_event_channel - Open a channel used to report
           communication events.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **struct rdma_event_channel * rdma_create_event_channel (**_void_**);**
    


## ARGUMENTS



           void        no arguments
    


## DESCRIPTION



           Asynchronous events are reported to users through event channels.
    


## RETURN VALUE



           Returns a pointer to the created event channel, or NULL if the
           request fails.  On failure, errno will be set to indicate the
           failure reason.
    


## NOTES



           Event channels are used to direct all events on an rdma_cm_id.
           For many clients, a single event channel may be sufficient,
           however, when managing a large number of connections or cm_id's,
           users may find it useful to direct events for different cm_id's to
           different channels for processing.
    
           All created event channels must be destroyed by calling
           rdma_destroy_event_channel.  Users should call rdma_get_cm_event
           to retrieve events on an event channel.
    
           Each event channel is mapped to a file descriptor.  The associated
           file descriptor can be used and manipulated like any other fd to
           change its behavior.  Users may make the fd non-blocking, poll or
           select the fd, etc.
    


* * *
# tapset::string

## NAME



           tapset::string - systemtap string tapset
    


## DESCRIPTION



           **strlen** Returns the length of a string
    
                  See function::strlen(3stap)
                   for details.
    
           **substr** Returns a substring
    
                  See function::substr(3stap)
                   for details.
    
           **stringat**
                  Returns the char at a given position in the string
    
                  See function::stringat(3stap)
                   for details.
    
           **isinstr**
                  Returns whether a string is a substring of another string
    
                  See function::isinstr(3stap)
                   for details.
    
           **strpos** Returns location of a substring within another string
    
                  See function::strpos(3stap)
                   for details.
    
           **text_str**
                  Escape any non-printable chars in a string
    
                  See function::text_str(3stap)
                   for details.
    
           **text_strn**
                  Escape any non-printable chars in a string
    
                  See function::text_strn(3stap)
                   for details.
    
           **- strtol**
                  Convert a string to a long
    
                  See _function::-_ strtol _(3stap)_
                   for details.
    
           **isdigit**
                  Checks for a digit
    
                  See function::isdigit(3stap)
                   for details.
    
           **string_quoted**
                  Quotes a given string
    
                  See function::string_quoted(3stap)
                   for details.
    


* * *
# gnutls_sign_algorithm_get_client

## NAME



           gnutls_sign_algorithm_get_client - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the signature algorithm that is (or will be) used in this
           session by the client to sign data. This function should be used
           only with TLS 1.2 or later.
    


## RETURNS



           The sign algorithm or **GNUTLS_SIGN_UNKNOWN**.
    


## SINCE



           3.1.11
    


* * *
# gnutls_pkcs11_token_init

## NAME



           gnutls_pkcs11_token_init - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_init(const char ***_token_url_**, const char ***
           _so_pin_**, const char ***_label_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           const char * so_pin
                       Security Officer's PIN
    
           const char * label
                       A name to be used for the token
    


## DESCRIPTION



           This function will initialize (format) a token. If the token is at
           a factory defaults state the security officer's PIN given will be
           set to be the default. Otherwise it should match the officer's
           PIN.
    


## RETURNS



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


* * *
# gnutls_mac_get_name

## NAME



           gnutls_mac_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_mac_get_name(gnutls_mac_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       is a MAC algorithm
    


## DESCRIPTION



           Convert a **gnutls_mac_algorithm_t** value to a string.
    


## RETURNS



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


* * *
# function::user_uint8

## NAME



           function::user_uint8 - Retrieves a unsigned 8-bit integer value
           stored in user space
    


## SYNOPSIS



               user_uint8:long(addr:long)
    


## ARGUMENTS



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


## DESCRIPTION



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


* * *
# function::print_ubacktrace_fileline

## NAME



           function::print_ubacktrace_fileline - Print stack back trace for
           current user-space task.
    


## SYNOPSIS



           1) print_ubacktrace_fileline()
    
           2) print_ubacktrace_fileline(pc:long,sp:long,fp:long)
    


## ARGUMENTS



           _pc_
               override PC
    
           _sp_
               override SP
    
           _fp_
               override FP
    


## DESCRIPTION



           1)
    
           2) Equivalent to**print_ubacktrace** , but output for each symbol is
           longer including file names and line numbers.
    
           Equivalent to **print_ubacktrace_fileline** , but it performs the
           backtrace using the pc, sp, and fp passed in.
    


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


* * *
# gnutls_x509_crq_set_pubkey

## NAME



           gnutls_x509_crq_set_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_x509_crq_set_pubkey(gnutls_x509_crq_t** _crq_**,**
           **gnutls_pubkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_pubkey_t key
                       holds a public key
    


## DESCRIPTION



           This function will set the public parameters from the given public
           key to the request. The  _key_ can be deallocated after that.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# io_uring_peek_batch_cqe

## NAME



           io_uring_peek_cqe - check if an io_uring completion event is
           available
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_peek_cqe(struct io_uring ***_ring_**,**
                                 **struct io_uring_cqe ****_cqe_ptr_**);**
    
           **unsigned io_uring_peek_batch_cqe(struct io_uring ***_ring_**,**
                                            **struct io_uring_cqe ****_cqe_ptrs_**,**
                                            **unsigned** _count_**);**
    


## DESCRIPTION



           The io_uring_peek_cqe(3) function returns an IO completion from
           the queue belonging to the _ring_ param, if one is readily
           available. On successful return, _cqe_ptr_ param is filled with a
           valid CQE entry.
    
           This function does not enter the kernel to wait for an event, an
           event is only returned if it's already available in the CQ ring.
    
           The io_uring_peek_batch_cqe(3) function returns up to _count_
           request completions in _cqe_ptrs_ belonging to the _ring_ param, if
           they are readily available. It will not enter the kernel, unless
           the CQ ring is in an overflow condition. Upon successful return,
           _cqe_ptrs_ are filled with the number of events indicated by the
           return value.
    


## RETURN VALUE



           On success io_uring_peek_cqe(3) returns **0** and the cqe_ptr
           parameter is filled in. On success io_uring_peek_batch_cqe(3)
           returns the number of completions filled in. On failure,
           io_uring_peek_cqe(3) may return **-EAGAIN**.
    


* * *
# pcap_dump_flush

## NAME



           pcap_dump_flush - flush to a savefile packets dumped
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_dump_flush(pcap_dumper_t *p);**
    


## DESCRIPTION



           **pcap_dump_flush**() flushes the output buffer to the ``savefile'',
           so that any packets written with **pcap_dump**(3PCAP) but not yet
           written to the ``savefile'' will be written.
    


## RETURN VALUE



           **pcap_dump_flush**() returns **0** on success and **PCAP_ERROR** on failure.
    


* * *