tripathysagar/man_text huggingface dataset:
# gnutls_pkcs11_obj_export

## NAME



           gnutls_pkcs11_obj_export - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_export(gnutls_pkcs11_obj_t** _obj_**, void ***
           _output_data_**, size_t ***_output_data_size_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       Holds the object
    
           void * output_data
                       will contain the object data
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will export the PKCS11 object data.  It is normal
           for data to be inaccessible and in that case
           **GNUTLS_E_INVALID_REQUEST** will be returned.
    
           If the buffer provided is not long enough to hold the output, then
           *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will
           be returned.
    


## RETURNS



           In case of failure a negative error code will be returned, and
           **GNUTLS_E_SUCCESS**(0) on success.
    


## SINCE



           2.12.0
    


* * *
# libpfm_arm_ac7

## NAME



           libpfm_arm_ac7 - support for Arm Cortex A7 PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the ARM Cortex A7 core PMU.
    
           This PMU supports 4 counters and privilege levels filtering.
    


## MODIFIERS



           The following modifiers are supported on ARM Cortex A7:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *
# gnutls_x509_crt_get_dn_by_oid

## NAME



           gnutls_x509_crt_get_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_dn_by_oid(gnutls_x509_crt_t** _cert_**, const**
           **char ***_oid_**, unsigned** _indx_**, unsigned int** _raw_flag_**, void ***_buf_**,**
           **size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const char * oid
                       holds an Object Identified in null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the RDN, this
                       specifies which to send. Use (0) to get the first one.
    
           unsigned int raw_flag
                       If non-zero returns the raw DER data of the DN part.
    
           void * buf  a pointer where the DN part will be copied (may be
                       null).
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will extract the part of the name of the Certificate
           subject specified by the given OID. The output, if the raw flag is
           not used, will be encoded as described in RFC4514. Thus a string
           that is ASCII or UTF-8 encoded, depending on the certificate data.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           If raw flag is (0), this function will only return known OIDs as
           text. Other OIDs will be DER encoded, as described in RFC4514 --
           in hex format with a '#' prefix.  You can check about known OIDs
           using **gnutls_x509_dn_oid_known()**.
    
           If  _buf_ is null then only the size will be filled. If the
           _raw_flag_ is not specified the output is always null terminated,
           although the
            _buf_size_ will not include the null character.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the  _buf_size_ will be updated with the
           required size. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if there are
           no data in the current index. On success 0 is returned.
    


* * *
# libpfm_intel_ivbep_unc_r2pcie

## NAME



           libpfm_intel_ivbep_unc_r2pcie - support for Intel Ivy Bridge-EP R2
           PCIe  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_r2pcie**
           **PMU desc: Intel Ivy Bridge-EP R2 PCIe uncore PMU**
    


## DESCRIPTION



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


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge R2PCIe
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of R2PCIe cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold.  This is an integer modifier with values in
                  the range [0:15].
    


* * *
# rdma_reg_read

## NAME



           rdma_reg_read - register data buffer(s) for remote RDMA read
           access.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **struct ibv_mr * rdma_reg_read (struct rdma_cm_id ***_id_**, void ***_addr_**,**
           **size_t** _length_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer(s) will be used.
    
           addr        The address of the memory buffer(s) to register.
    
           length      The total length of the memory to register.
    


## DESCRIPTION



           Registers a memory buffer that will be accessed by a remote RDMA
           read operation.  Memory buffers registered using rdma_reg_read may
           be targeted in an RDMA read request, allowing the buffer to be
           specified on the remote side of an RDMA connection as the
           remote_addr of rdma_post_read, or similar call.
    


## RETURN VALUE



           Returns a reference to the registered memory region on success, or
           NULL on error.  If an error occurs, errno will be set to indicate
           the failure reason.
    


## NOTES



           rdma_reg_read is used to register a data buffer that will be the
           target of an RDMA read operation on a queue pair associated with
           an rdma_cm_id.  The memory buffer is registered with the
           proteection domain associated with the idenfier.  The start of the
           data buffer is specified through the addr parameter, and the total
           size of the buffer is given by length.
    
           All data buffers should be registered before being posted as a
           work request.  Users must deregister all registered memory by
           calling rdma_dereg_mr.
    


* * *
# function::tz_name

## NAME



           function::tz_name - Return local time zone name
    


## SYNOPSIS



               tz_name()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the local time zone name, as passed by staprun at script
           startup only.
    


* * *
# gnutls_x509_crt_set_issuer_unique_id

## NAME



           gnutls_x509_crt_set_issuer_unique_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_issuer_unique_id(gnutls_x509_crt_t** _cert_**,**
           **const void ***_id_**, size_t** _id_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * id
                       The unique ID
    
           size_t id_size
                       Holds the size of the unique ID.
    


## DESCRIPTION



           This function will set the X.509 certificate's issuer unique ID
           field.
    


## RETURNS



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


## SINCE



           3.4.7
    


* * *
# menu_items

## NAME



           **set_menu_items** , **menu_items** , **item_count** - make and break
           connections between items and menus
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_items(MENU ***_menu_**, ITEM ****_items_**);**
           **ITEM **menu_items(const MENU ***_menu_**);**
           **int item_count(const MENU ***_menu_**);**
    


## DESCRIPTION



           The function **set_menu_items** changes the item pointer array of the
           given _menu_.  The array must be terminated by a **NULL**.
    
           The function **menu_items** returns the item array of the given menu.
    
           The function **item_count** returns the count of items in _menu_.
    


## RETURN VALUE



           The function **menu_items** returns a pointer (which may be **NULL**).  It
           does not set **errno**.
    
           The function **item_count** returns **ERR**(the general **curses** error
           return value) if its _menu_ parameter is **NULL**.
    
           The function **set_menu_items** returns one of the following codes on
           error:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_NOT_CONNECTED**
                No items are connected to the menu.
    
           **E_POSTED**
                The menu is already posted.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    
           The SVr4 menu library documentation specifies the **item_count** error
           value as -1 (which is the value of **ERR**).
    


* * *
# gnutls_tdb_set_store_func

## NAME



           gnutls_tdb_set_store_func - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_tdb_set_store_func(gnutls_tdb_t** _tdb_**,**
           **gnutls_tdb_store_func** _store_**);**
    


## ARGUMENTS



           gnutls_tdb_t tdb
                       The trust storage
    
           gnutls_tdb_store_func store
                       The storage function
    


## DESCRIPTION



           This function will associate a storage function with the trust
           storage structure. The function is of the following form.
    
           int gnutls_tdb_store_func(const char* db_name, const char* host,
           const char* service, time_t expiration, const gnutls_datum_t*
           pubkey);
    
           The  _db_name_ should be used to pass any private data to this
           function.
    


* * *
# pmfreeresult

## NAME



           **pmFreeResult** - release storage allocated for performance metrics
           values
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmFreeResult(pmResult ***_result_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  variable  sized  results returned by pmFetch(3) are allocated
           below the Performance Metrics  Application  Programming  Interface
           (PMAPI)  using  a combination of dynamic (i.e. malloc(3)) and spe‐
           cialized allocation strategies.
    
           Applications should call **pmFreeResult** to release the storage  pre‐
           viously  allocated  for _result_ by pmFetch(3), when the application
           no longer requires access to the _pmResult_ structure.
    
           Under **no** circumstances should an application use  _free(result)_  to
           release storage previously allocated for a _pmResult_ by pmFetch(3).
    


## COMPATIBILITY



           Prior  to PCP 7.0 the _timestamp_ field in the pmResult struct was a
           struct timeval.  To support PMAPI transition,  the  old  interface
           and  semantics  can  be  used  if applications are recompiled with
           **-DPMAPI_VERSION=2**.
    
           For a time in PCP 6.x there was a routine with the same  semantics
           as  the  current  **pmFreeResult** called **pmFreeHighResResult** although
           this is now deprecated and compile-time support for **pmFreeHighRes‐**
           **Result** will be removed in a future release.
    


* * *
# sd_event_source_get_pending

## NAME



           sd_event_source_get_pending - Determine pending state of event
           sources
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **int sd_event_source_get_pending(sd_event_source ***_source_**);**
    


## DESCRIPTION



           **sd_event_source_get_pending()** may be used to determine whether the
           event source object specified as _source_ has seen events but has
           not been dispatched yet (and thus is marked "pending").
    
           Event source objects initially are not marked pending, when they
           are created with calls such as sd_event_add_io(3),
           sd_event_add_time(3), with the exception of those created with
           sd_event_add_defer(3) which are immediately marked pending, and
           sd_event_add_exit(3) for which the "pending" concept is not
           defined. For details see the respective manual pages.
    
           In each event loop iteration one event source of those marked
           pending is dispatched, in the order defined by the event source
           priority, as set with sd_event_source_set_priority(3).
    
           For I/O event sources, as created with sd_event_add_io(3), the
           call sd_event_source_get_io_revents(3) may be used to query the
           type of event pending in more detail.
    


## RETURN VALUE



           On success, **sd_event_source_get_pending()** returns an integer
           greater than zero when the event source is marked pending, and
           zero when the event source is not marked pending. On failure, it
           returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               _source_ is not a valid pointer to an sd_event_source object.
    
           **-EDOM**
               _source_ refers to an event source object created with
               sd_event_add_exit(3).
    
           **-ENOMEM**
               Not enough memory.
    
           **-ESTALE**
               The event loop is already terminated.
    
           **-ECHILD**
               The event loop has been created in a different process,
               library or module instance.
    


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


* * *
# ausearch_add_item

## NAME



           ausearch_add_item - build up search rule
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int ausearch_add_item(auparse_state_t ***_au_**, const char ***_field_**, const char ***_op_**, const char ***_value_**, ausearch_rule_t** _how_**);"**
    


## DESCRIPTION



           ausearch_add_item adds one search condition to the current audit
           search expression. The search conditions can then be used to scan
           logs, files, or buffers for something of interest. The _field_ value
           is the field name that the _value_ will be checked for. The _op_
           variable describes what kind of check is to be done. Legal _op_
           values are:
    
                  _exists_
                          just check that a field name exists
    
                  _=_
                          locate the field name and check that the value
                         associated with it is equal to the value given in
                         this rule.
    
                  _!=_
                          locate the field name and check that the value
                         associated with it is NOT equal to the value given
                         in this rule.
    
           The value parameter is compared to the uninterpreted field value.
           If you are trying to match against a field who's type is
           AUPARSE_TYPE_ESCAPED, you will want to use the
           ausearch_add_interpreted_item() function instead.
    
           The _how_ value determines how this search condition will affect the
           existing search expression if one is already defined. The possible
           values are:
    
                  _AUSEARCH_RULE_CLEAR_
                         Clear the current search expression, if any, and use
                         only this search condition.
    
                  _AUSEARCH_RULE_OR_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **||**_this_search_condition_**)**.
    
                  _AUSEARCH_RULE_AND_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **& & **_this_search_condition_**)**.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, 0 for success.
    


* * *
# pmiwrite

## NAME



           **pmiWrite** - flush data to a LOGIMPORT archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiWrite(int** _sec_**, int** _usec_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiWrite($**_sec_**, $**_usec_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiWrite** forces accumulated data values out to  the
           PCP archive.
    
           The data values and associated metadata have previously been built
           up    using    calls    to   pmiAddMetric(3),   pmiAddInstance(3),
           pmiPutValue(3) and pmiPutValueHandle(3).
    
           The current set of data values and any new metadata is written  to
           the  archive  with a timestamp of _sec_ and _usec_ in the source time‐
           zone of the archive, see pmiSetTimezone(3).
    


## DIAGNOSTICS



           **pmiWrite** returns zero on success else a negative value that can be
           turned into an error message by calling pmiErrStr(3).
    


* * *
# isfinite

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



           isfinite — test for finite value
    


## SYNOPSIS



           #include <math.h>
    
           int isfinite(real-floating _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _isfinite_() macro shall determine whether its argument has a
           finite value (zero, subnormal, or normal, and not infinite or
           NaN). First, an argument represented in a format wider than its
           semantic type is converted to its semantic type. Then
           determination is based on the type of the argument.
    


## RETURN VALUE



           The _isfinite_() macro shall return a non-zero value if and only if
           its argument has a finite value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ausearch_cur_event

## NAME



           ausearch_cur_event - check if the current event meets search
           criteria
    


## SYNOPSIS



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


## DESCRIPTION



           ausearch_cur_event will scan the input source and evaluate whether
           any record in the current event contains the data being searched
           for. Evaluation is done at the record level. If a match is found,
           the cursor is repositioned; otherwise, it remains on the last
           successfully parsed record within the current event.
    


## RETURN VALUE



           Returns -1 if an error occurs, 0 if no matches, and 1 for success.
    


* * *
# function::set_user_short

## NAME



           function::set_user_short - Writes a short value to user memory
    


## SYNOPSIS



               set_user_short(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The user address to write the short to
    
           _val_
               The short which is to be written
    


## DESCRIPTION



           Writes the short value to a given user memory address. Reports an
           error when writing to the given address fails. Requires the use of
           guru mode (-g).
    


* * *
# probe::ioscheduler.elv_add_request.kp

## NAME



           probe::ioscheduler.elv_add_request.kp - kprobe based probe to
           indicate that a request was added to the request queue
    


## SYNOPSIS



           ioscheduler.elv_add_request.kp
    


## VALUES



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


* * *
# io_uring_register_clock

## NAME



           io_uring_register_clock - set clock source for event waiting
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_clock(struct io_uring ***_ring_**,**
                                       **struct io_uring_clock_register ***_arg_**);**
    


## DESCRIPTION



           The io_uring_register_clock(3) function registers which clock
           source should be used by io_uring, when an application waits for
           event completions. The _ring_ argument should point to the ring in
           question, and the _arg_ argument should be a pointer to a **struct**
           **io_uring_clock_register .**
    
           The _arg_ argument must be filled in with the appropriate
           information. It looks as follows:
    
               struct io_uring_clock_register {
                   __u32 clockid;
                   __u32 __resv[3];
               };
    
           The _clockid_ field must contain the clock source, with valid
           sources being:
    
           **CLOCK_MONOTONIC**
                  a nonsettable system-wide clock that represents monotonic
                  time.
    
           **CLOCK_BOOTTIME**
                  A nonsettable system-wide clock that is identical to
                  **CLOCK_MONOTONIC ,** except that is also icnludes any time
                  that the system is suspended.
    
           See **clock_gettime**(3) for more details.
    
           The ___resv_ fields must be filled with zeroes.
    
           Available since 6.12.
    


## RETURN VALUE



           On success io_uring_register_clock(3) returns 0. On failure it
           returns **-errno**.
    


* * *
# function::user_uint32_error

## NAME



           function::user_uint32_error - Retrieves an unsigned 32-bit integer
           value stored in user space
    


## SYNOPSIS



               user_uint32_error:long(addr:long)
    


## ARGUMENTS



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


## DESCRIPTION



           Returns the unsigned 32-bit integer value from a given user space
           address. If the user space data is not accessible, an error will
           occur.
    


* * *
# ldap_parse_reference

## NAME



           ldap_parse_reference - Extract referrals and controls from a
           reference message
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_parse_reference( LDAP *ld, LDAPMessage *reference,**
                **char ***referralsp, LDAPControl ***serverctrlsp,**
                **int freeit )**
    


## DESCRIPTION



           The **ldap_parse_reference()** routine is used to extract referrals
           and controls from a reference message.  The _reference_ parameter is
           a reference message as returned by a call to
           ldap_first_reference(3), ldap_next_reference(3),
           ldap_first_message(3), ldap_next_message(3), or ldap_result(3).
    
           The _referralsp_ parameter will be filled in with an allocated array
           of character strings. The strings are copies of the referrals
           contained in the parsed message. The array should be freed by
           calling ldap_value_free(3).  If _referralsp_ is NULL, no referrals
           are returned.  If no referrals were returned, _*referralsp_ is set
           to NULL.
    
           The _serverctrlsp_ parameter will be filled in with an allocated
           array of controls copied from the parsed message. The array should
           be freed by calling ldap_controls_free(3).  If _serverctrlsp_ is
           NULL, no controls are returned.  If no controls were returned,
           _*serverctrlsp_ is set to NULL.
    
           The _freeit_ parameter determines whether the parsed message is
           freed or not after the extraction. Any non-zero value will make it
           free the message. The ldap_msgfree(3) routine can also be used to
           free the message later.
    


## ERRORS



           Upon success LDAP_SUCCESS is returned. Otherwise the values of the
           _referralsp_ and _serverctrlsp_ parameters are undefined.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# gnutls_protocol_get_version

## NAME



           gnutls_protocol_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_protocol_t gnutls_protocol_get_version(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get TLS version, a **gnutls_protocol_t** value.
    


## RETURNS



           The version of the currently used protocol.
    


* * *
# wcsftime

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



           wcsftime — convert date and time to a wide-character string
    


## SYNOPSIS



           #include <wchar.h>
    
           size_t wcsftime(wchar_t *restrict _wcs_ , size_t _maxsize_ ,
               const wchar_t *restrict _format_ , const struct tm *restrict _timeptr_);
    


## 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 _wcsftime_() function shall be equivalent to the _strftime_()
           function, except that:
    
            *  The argument _wcs_ points to the initial element of an array of
               wide characters into which the generated output is to be
               placed.
    
            *  The argument _maxsize_ indicates the maximum number of wide
               characters to be placed in the output array.
    
            *  The argument _format_ is a wide-character string and the
               conversion specifications are replaced by corresponding
               sequences of wide characters.  It is unspecified whether an
               encoding error occurs if the format string contains **wchar_t**
               values that do not correspond to members of the character set
               of the current locale.
    
            *  Field widths specify the number of wide characters instead of
               the number of bytes.
    
            *  The return value indicates the number of wide characters
               placed in the output array.
    
           If copying takes place between objects that overlap, the behavior
           is undefined.
    


## RETURN VALUE



           If the total number of resulting wide-character codes including
           the terminating null wide-character code is no more than _maxsize_ ,
           _wcsftime_() shall return the number of wide-character codes placed
           into the array pointed to by _wcs_ , not including the terminating
           null wide-character code. Otherwise, zero is returned and the
           contents of the array are unspecified.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::htonl

## NAME



           function::htonl - Convert 32-bit long from host to network order
    


## SYNOPSIS



               htonl:long(x:long)
    


## ARGUMENTS



           _x_
               Value to convert
    


* * *
# gnutls_handshake_description_get_name

## NAME



           gnutls_handshake_description_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char ***
           **gnutls_handshake_description_get_name(gnutls_handshake_description_t**
           _type_**);**
    


## ARGUMENTS



           gnutls_handshake_description_t type
                       is a handshake message description
    


## DESCRIPTION



           Convert a **gnutls_handshake_description_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified handshake message
           or **NULL**.
    


* * *
# tmpfile

## NAME



           tmpfile - create a temporary file
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **FILE *tmpfile(void);**
    


## DESCRIPTION



           The **tmpfile**() function opens a unique temporary file in binary
           read/write (w+b) mode.  The file will be automatically deleted
           when it is closed or the program terminates.
    


## RETURN VALUE



           The **tmpfile**() function returns a stream descriptor, or NULL if a
           unique filename cannot be generated or the unique file cannot be
           opened.  In the latter case, _errno_ is set to indicate the error.
    


## ERRORS



           **EACCES** Search permission denied for directory in file's path
                  prefix.
    
           **EEXIST** Unable to generate a unique filename.
    
           **EINTR** The call was interrupted by a signal; see signal(7).
    
           **EMFILE** The per-process limit on the number of open file
                  descriptors has been reached.
    
           **ENFILE** The system-wide limit on the total number of open files has
                  been reached.
    
           **ENOSPC** There was no room in the directory to add the new filename.
    
           **EROFS** Read-only filesystem.
    


## ATTRIBUTES



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


## VERSIONS



           The standard does not specify the directory that **tmpfile**() will
           use.  glibc will try the path prefix _P_tmpdir_ defined in
           _< stdio.h>_, and if that fails, then the directory _/tmp_.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           POSIX.1-2001 specifies: an error message may be written to _stdout_
           if the stream cannot be opened.
    


* * *
# gnutls_x509_crt_check_email

## NAME



           gnutls_x509_crt_check_email - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crt_check_email(gnutls_x509_crt_t** _cert_**, const**
           **char ***_email_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain an gnutls_x509_crt_t type
    
           const char * email
                       A null terminated string that contains an email
                       address (RFC822)
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will check if the given certificate's subject
           matches the given email address.
    


## RETURNS



           non-zero for a successful match, and zero on failure.
    


* * *
# dane_query_entries

## NAME



           dane_query_entries - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **unsigned int dane_query_entries(dane_query_t** _q_**);**
    


## ARGUMENTS



           dane_query_t q
                       The query result structure
    


## DESCRIPTION



           This function will return the number of entries in a query.
    


## RETURNS



           The number of entries.
    


* * *
# function::uint_arg

## NAME



           function::uint_arg - Return function argument as unsigned int
    


## SYNOPSIS



               uint_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the value of argument n as an unsigned int (i.e., a 32-bit
           integer zero-extended to 64 bits).
    


* * *
# pthread_mutex_trylock

## PROLOG



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


## NAME



           pthread_mutex_trylock, pthread_mutex_unlock — lock and unlock a
           mutex
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutex_trylock(pthread_mutex_t *_mutex_);
           int pthread_mutex_unlock(pthread_mutex_t *_mutex_);
    


## DESCRIPTION



           Refer to pthread_mutex_lock(3p).
    


* * *
# probe::netdev.hard_transmit

## NAME



           probe::netdev.hard_transmit - Called when the devices is going to
           TX (hard)
    


## SYNOPSIS



           netdev.hard_transmit
    


## VALUES



           _dev_name_
               The device scheduled to transmit
    
           _protocol_
               The protocol used in the transmission
    
           _length_
               The length of the transmit buffer.
    
           _truesize_
               The size of the data to be transmitted.
    


* * *
# gnutls_srtp_set_profile_direct

## NAME



           gnutls_srtp_set_profile_direct - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_srtp_set_profile_direct(gnutls_session_t** _session_**, const**
           **char ***_profiles_**, const char ****_err_pos_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const char * profiles
                       is a string that contains the supported SRTP profiles,
                       separated by colons.
    
           const char ** err_pos
                       In case of an error this will have the position in the
                       string the error occurred, may be NULL.
    


## DESCRIPTION



           This function is to be used by both clients and servers, to
           declare what SRTP profiles they support, to negotiate with the
           peer.
    


## RETURNS



           On syntax error **GNUTLS_E_INVALID_REQUEST** is returned,
           **GNUTLS_E_SUCCESS** on success, or an error code.
    
           Since 3.1.4
    


* * *
# tapset::regex

## NAME



           tapset::regex - systemtap regex tapset
    


## DESCRIPTION



           **matched_str**
                  Return the last matched string.
    
                  See function::matched_str(3stap)
                   for details.
    
           **matched**
                  Return a given matched subexpression.
    
                  See function::matched(3stap)
                   for details.
    
           **ngroups**
                  Number of subexpressions in the last match.
    
                  See function::ngroups(3stap)
                   for details.
    


* * *
# function::signal_str

## NAME



           function::signal_str - Returns the string representation of a
           signal number
    


## SYNOPSIS



               signal_str(num:)
    


## ARGUMENTS



           _num_
               the signal number to convert to string.
    


* * *
# gnutls_x509_crq_set_key_rsa_raw

## NAME



           gnutls_x509_crq_set_key_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_key_rsa_raw(gnutls_x509_crq_t** _crq_**, const**
           **gnutls_datum_t ***_m_**, const gnutls_datum_t ***_e_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const gnutls_datum_t * m
                       holds the modulus
    
           const gnutls_datum_t * e
                       holds the public exponent
    


## DESCRIPTION



           This function will set the public parameters from the given
           private key to the request. Only RSA keys are currently supported.
    


## RETURNS



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


## SINCE



           2.6.0
    


* * *
# pcre2_match_context_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_match_context *pcre2_match_context_create(**
             **pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function creates and initializes a new match context. If its
           argument is NULL, **malloc()** is used to get the necessary memory;
           otherwise the memory allocation function within the general
           context is used. The result is NULL if the memory could not be
           obtained.
    
           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.
    


* * *
# dirfd

## NAME



           dirfd - get directory stream file descriptor
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <dirent.h>**
    
           **int dirfd(DIR ***_dirp_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **dirfd**():
               /* Since glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The function **dirfd**() returns the file descriptor associated with
           the directory stream _dirp_.
    
           This file descriptor is the one used internally by the directory
           stream.  As a result, it is useful only for functions which do not
           depend on or alter the file position, such as fstat(2) and
           fchdir(2).  It will be automatically closed when closedir(3) is
           called.
    


## RETURN VALUE



           On success, **dirfd**() returns a file descriptor (a nonnegative
           integer).  On error, -1 is returned, and _errno_ is set to indicate
           the error.
    


## ERRORS



           POSIX.1-2008 specifies two errors, neither of which is returned by
           the current implementation.
    
           **EINVAL** _dirp_ does not refer to a valid directory stream.
    
           **ENOTSUP**
                  The implementation does not support the association of a
                  file descriptor with a directory.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# auparse_get_field_num

## NAME



           auparse_get_field_num - get current field cursor location
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_field_num will retrieve the internal library cursors
           current field location in the current record. Fields within the
           same record are numbered starting from 0. This is generally not
           needed but there are some cases where one may want to know the
           exact field being looked at.
    


## RETURN VALUE



           Returns the current field cursor location.
    


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


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_trygetnext_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_);
    


## DESCRIPTION



           Refer to posix_trace_getnext_event(3p).
    


* * *
# gnutls_pk_get_name

## NAME



           gnutls_pk_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_pk_get_name(gnutls_pk_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t algorithm
                       is a public key algorithm
    


## DESCRIPTION



           Convert a **gnutls_pk_algorithm_t** value to a string.
    


## RETURNS



           a pointer to a string that contains the name of the specified
           public key algorithm, or **NULL**.
    


## SINCE



           2.6.0
    


* * *
# gnutls_x509_name_constraints_get_excluded

## NAME



           gnutls_x509_name_constraints_get_excluded - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_name_constraints_get_excluded(gnutls_x509_name_constraints_t**
           _nc_**, unsigned** _idx_**, unsigned ***_type_**, gnutls_datum_t ***_name_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t nc
                       the extracted name constraints
    
           unsigned idx
                       the index of the constraint
    
           unsigned * type
                       the type of the constraint (of type
                       gnutls_x509_subject_alt_name_t)
    
           gnutls_datum_t * name
                       the name in the constraint (of the specific type)
    


## DESCRIPTION



           This function will return an intermediate type containing the name
           constraints of the provided CA certificate. That structure can be
           used in combination with **gnutls_x509_name_constraints_check()** to
           verify whether a server's name is in accordance with the
           constraints.
    
           The name should be treated as constant and valid for the lifetime
           of  _nc_ .
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# function::addr

## NAME



           function::addr - Address of the current probe point.
    


## SYNOPSIS



               addr:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the instruction pointer from the current probe's register
           state. Not all probe types have registers though, in which case
           zero is returned. The returned address is suitable for use with
           functions like **symname** and **symdata**.
    


* * *
# auparse_first_record

## NAME



           auparse_first_record - reposition record cursor
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_first_record repositions the internal cursors of the
           parsing library to point to the first field of the first record in
           the current event.
    


## RETURN VALUE



           Returns -1 if an error occurs, 0 if there is no event data, or 1
           for success.
    


* * *