tripathysagar/man_text huggingface dataset:
# gnutls_pkcs11_copy_pubkey

## NAME



           gnutls_pkcs11_copy_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_pubkey(const char ***_token_url_**,**
           **gnutls_pubkey_t** _pubkey_**, const char ***_label_**, const gnutls_datum_t ***
           _cid_**, unsigned int** _key_usage_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_pubkey_t pubkey
                       The public key to copy
    
           const char * label
                       The name to be used for the stored data
    
           const gnutls_datum_t * cid
                       The CKA_ID to set for the object -if NULL, the ID will
                       be derived from the public key
    
           unsigned int key_usage
                       One of GNUTLS_KEY_*
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_FLAG_*
    


## DESCRIPTION



           This function will copy a public key object into a PKCS **11** token
           specified by a URL. Valid flags to mark the key:
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_PRIVATE** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_CA** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_ALWAYS_AUTH**.
    


## RETURNS



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


## SINCE



           3.4.6
    


* * *
# pcre2_set_recursion_memory_management

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_recursion_memory_management(**
             **pcre2_match_context ***_mcontext_**,**
             **void *(***_private_malloc_**)(size_t, void *),**
             **void (***_private_free_**)(void *, void *), void ***_memory_data_**);**
    


## DESCRIPTION



    
           From release 10.30 onwards, this function is obsolete and does
           nothing. The result is always zero.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# probe::sunrpc.sched.execute

## NAME



           probe::sunrpc.sched.execute - Execute the RPC `scheduler'
    


## SYNOPSIS



           sunrpc.sched.execute
    


## VALUES



           _vers_
               the program version in the RPC call
    
           _prot_
               the IP protocol in the RPC call
    
           _tk_pid_
               the debugging id of the task
    
           _prog_
               the program number in the RPC call
    
           _tk_flags_
               the flags of the task
    
           _xid_
               the transmission id in the RPC call
    


* * *
# ldap_get_values

## NAME



           ldap_get_values, ldap_get_values_len, ldap_count_values - LDAP
           attribute value handling routines
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **char **ldap_get_values(ld, entry, attr)**
           LDAP *ld;
           LDAPMessage *entry;
           char *attr;
    
           **struct berval **ldap_get_values_len(ld, entry, attr)**
           LDAP *ld;
           LDAPMessage *entry;
           char *attr;
    
           **int ldap_count_values(vals)**
           char **vals;
    
           **int ldap_count_values_len(vals)**
           struct berval **vals;
    
           **void ldap_value_free(vals)**
           char **vals;
    
           **void ldap_value_free_len(vals)**
           struct berval **vals;
    


## DESCRIPTION



           These routines are used to retrieve and manipulate attribute
           values from an LDAP entry as returned by ldap_first_entry(3) or
           ldap_next_entry(3).  **ldap_get_values()** takes the _entry_ and the
           attribute _attr_ whose values are desired and returns a NULL-
           terminated array of the attribute's values.  _attr_ may be an
           attribute type as returned from ldap_first_attribute(3) or
           ldap_next_attribute(3), or if the attribute type is known it can
           simply be given.
    
           The number of values in the array can be counted by calling
           **ldap_count_values()**.  The array of values returned can be freed by
           calling **ldap_value_free()**.
    
           If the attribute values are binary in nature, and thus not
           suitable to be returned as an array of char *'s, the
           **ldap_get_values_len()** routine can be used instead.  It takes the
           same parameters as **ldap_get_values()** , but returns a NULL-
           terminated array of pointers to berval structures, each containing
           the length of and a pointer to a value.
    
           The number of values in the array can be counted by calling
           **ldap_count_values_len()**.  The array of values returned can be
           freed by calling **ldap_value_free_len()**.
    


## ERRORS



           If an error occurs in **ldap_get_values()** or **ldap_get_values_len()** ,
           NULL is returned and the **ld_errno** field in the _ld_ parameter is set
           to indicate the error.  See ldap_error(3) for a description of
           possible error codes.
    


## NOTES



           These routines dynamically allocate memory which the caller must
           free using the supplied routines.
    


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


* * *
# io_uring_get_probe

## NAME



           io_uring_get_probe - get probe instance
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **io_uring_probe *io_uring_get_probe(void);**
    


## DESCRIPTION



           The function io_uring_get_probe(3) returns an allocated
           io_uring_probe structure to the caller. The caller is responsible
           for freeing the structure with the function
           io_uring_free_probe(3).
    


## NOTES



           Earlier versions of the Linux kernel do not support probe. If the
           kernel doesn't support probe, this function will return NULL.
    


## RETURN VALUE



           On success it returns an allocated io_uring_probe structure,
           otherwise it returns NULL.
    


* * *
# gnutls_anti_replay_set_window

## NAME



           gnutls_anti_replay_set_window - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_anti_replay_set_window(gnutls_anti_replay_t**
           _anti_replay_**, unsigned int** _window_**);**
    


## ARGUMENTS



           gnutls_anti_replay_t anti_replay
                       is a **gnutls_anti_replay_t** type.
    
           unsigned int window
                       is the time window recording ClientHello, in
                       milliseconds
    


## DESCRIPTION



           Sets the time window used for ClientHello recording.  In order to
           protect against replay attacks, the server records ClientHello
           messages within this time period from the last update, and
           considers it a replay when a ClientHello outside of the period; if
           a ClientHello arrives within this period, the server checks the
           database and detects duplicates.
    
           For the details of the algorithm, see RFC 8446, section 8.2.
    


## SINCE



           3.6.5
    


* * *
# __pmparsetime

## NAME



           **__pmtimevalParse** , **__pmtimespecParse** - parse time point
           specification
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmtimevalParse(const char ***_string_**, struct timeval ***_logStart_**,**
                                **struct timeval ***_logEnd_**, struct timeval ***_rslt_**,**
                                **char ****_errMsg_**);**
           **int __pmtimespecParse(const char ***_string_**,**
                                 **struct timespec ***_logStart_**,**
                                 **struct timespec ***_logEnd_**,**
                                 **struct timespec ***_rslt_**, char ****_errMsg_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



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


## DESCRIPTION



           **__pmtimevalParse** and **__pmtimespecParse** are designed to encapsulate
           the interpretation of a time point specification in  command  line
           switches for use by the PCP client tools.
    
           These  functions expects to be called with the time point specifi‐
           cation as **string**.  If the tool is running against PCP  archive(s),
           you also need to supply the start time of the first (only) archive
           as  **logStart** ,  and  the  end of the last (only) archive as **logEnd**.
           See pmGetArchiveLabel(3) and pmGetArchiveEnd(3) for how to  obtain
           values  for  these  parameters.   If the tool is running against a
           live feed of performance data, **logStart** should be the current time
           (but could be aligned on the next second for example),  while  **lo‐**
           **gEnd** should have its tv_sec component set to PM_MAX_TIME_T.
    
           The  **rslt** structure must be allocated before either calling **__pm‐**
           **timevalParse** or **__pmtimespecParse**.
    
           You also need to set the current PCP reporting time zone  to  cor‐
           rectly  reflect the -z and -Z command line parameters before call‐
           ing **__pmtimevalParse** or **__pmtimespecParse**.  See  pmUseZone(3)  and
           friends for information on how this is done.
    
           If  the  conversion is successful, both **__pmtimevalParse** and **__pm‐**
           **timespecParse** return 0, and fill in **rslt** with the time  value  de‐
           fined  by the input parameters.  If the argument strings could not
           be parsed, it returns -1 and a dynamically allocated error message
           string in **errMsg**.  Be sure to free(3) this error message string.
    


* * *
# probe::tty.open

## NAME



           probe::tty.open - Called when a tty is opened
    


## SYNOPSIS



           tty.open
    


## VALUES



           _inode_state_
               the inode state
    
           _inode_flags_
               the inode flags
    
           _inode_number_
               the inode number
    
           _file_name_
               the file name
    
           _file_flags_
               the file flags
    
           _file_mode_
               the file mode
    


* * *
# function::backtrace

## NAME



           function::backtrace - Hex backtrace of current kernel stack
    


## SYNOPSIS



               backtrace:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns a string of hex addresses that are a
           backtrace of the kernel stack. Output may be truncated as per
           maximum string length (MAXSTRINGLEN). See **ubacktrace** for
           user-space backtrace.
    


* * *
# probe::nfs.fop.aio_read

## NAME



           probe::nfs.fop.aio_read - NFS client aio_read file operation
    


## SYNOPSIS



           nfs.fop.aio_read
    


## VALUES



           _cache_time_
               when we started read-caching this inode
    
           _pos_
               current position of file
    
           _file_name_
               file name
    
           _dev_
               device identifier
    
           _parent_name_
               parent dir name
    
           _count_
               read bytes
    
           _ino_
               inode number
    
           _attrtimeo_
               how long the cached information is assumed to be valid. We
               need to revalidate the cached attrs for this inode if jiffies
               - read_cache_jiffies > attrtimeo.
    
           _cache_valid_
               cache related bit mask flag
    
           _buf_
               the address of buf in user space
    


* * *
# div

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



           div — compute the quotient and remainder of an integer division
    


## SYNOPSIS



           #include <stdlib.h>
    
           div_t div(int _numer_ , int _denom_);
    


## 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 _div_() function shall compute the quotient and remainder of the
           division of the numerator _numer_ by the denominator _denom_.  If the
           division is inexact, the resulting quotient is the integer of
           lesser magnitude that is the nearest to the algebraic quotient. If
           the result cannot be represented, the behavior is undefined;
           otherwise, _quot_ *_denom_ +_rem_ shall equal _numer_.
    


## RETURN VALUE



           The _div_() function shall return a structure of type **div_t** ,
           comprising both the quotient and the remainder. The structure
           includes the following members, in any order:
    
               int  quot;  /* quotient */
               int  rem;   /* remainder */
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# if_nametoindex

## NAME



           if_nametoindex, if_indextoname - mappings between network
           interface names and indexes
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <net/if.h>**
    
           **unsigned int if_nametoindex(const char ***_ifname_**);**
           **char *if_indextoname(unsigned int ifindex, char ***_ifname_**);**
    


## DESCRIPTION



           The **if_nametoindex**() function returns the index of the network
           interface corresponding to the name _ifname_.
    
           The **if_indextoname**() function returns the name of the network
           interface corresponding to the interface index _ifindex_.  The name
           is placed in the buffer pointed to by _ifname_.  The buffer must
           allow for the storage of at least **IF_NAMESIZE** bytes.
    


## RETURN VALUE



           On success, **if_nametoindex**() returns the index number of the
           network interface; on error, 0 is returned and _errno_ is set to
           indicate the error.
    
           On success, **if_indextoname**() returns _ifname_ ; on error, NULL is
           returned and _errno_ is set to indicate the error.
    


## ERRORS



           **if_nametoindex**() may fail and set _errno_ if:
    
           **ENODEV** No interface found with given name.
    
           **if_indextoname**() may fail and set _errno_ if:
    
           **ENXIO** No interface found for the index.
    
           **if_nametoindex**() and **if_indextoname**() may also fail for any of the
           errors specified for socket(2) or ioctl(2).
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008, RFC 3493.
    


* * *
# function::task_start_time

## NAME



           function::task_start_time - Start time of the given task
    


## SYNOPSIS



               task_start_time:long(tid:long)
    


## ARGUMENTS



           _tid_
               Thread id of the given task
    


## DESCRIPTION



           Returns the start time of the given task in nanoseconds since boot
           time or 0 if the task does not exist.
    


* * *
# pcre2_substring_copy_byname

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_copy_byname(pcre2_match_data ***_match_data_**,**
             **PCRE2_SPTR** _name_**, PCRE2_UCHAR ***_buffer_**, PCRE2_SIZE ***_bufflen_**);**
    


## DESCRIPTION



    
           This is a convenience function for extracting a captured
           substring, identified by name, into a given buffer. The arguments
           are:
    
             _match_data_    The match data block for the match
             _name_          Name of the required substring
             _buffer_        Buffer to receive the string
             _bufflen_       Length of buffer (code units)
    
           The _bufflen_ variable is updated to contain the length of the
           extracted string, excluding the trailing zero. The yield of the
           function is zero for success or one of the following error
           numbers:
    
             PCRE2_ERROR_NOSUBSTRING   there are no groups of that name
             PCRE2_ERROR_UNAVAILBLE    the ovector was too small for that
           group
             PCRE2_ERROR_UNSET         the group did not participate in the
           match
             PCRE2_ERROR_NOMEMORY      the buffer is not big enough
    
           If there is more than one group with the given name, the first one
           that is set is returned. In this situation PCRE2_ERROR_UNSET means
           that no group with the given name was set.
    
           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::task_euid

## NAME



           function::task_euid - The effective user identifier of the task
    


## SYNOPSIS



               task_euid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the effective user id of the given task.
    


* * *
# gnutls_auth_server_get_type

## NAME



           gnutls_auth_server_get_type - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_credentials_type_t**
           **gnutls_auth_server_get_type(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the type of credentials that were used for server
           authentication.  The returned information is to be used to
           distinguish the function used to access authentication data.
    
           Note that on resumed sessions, this function returns the schema
           used in the original session authentication.
    


## RETURNS



           The type of credentials for the server authentication schema, a
           **gnutls_credentials_type_t** type.
    


* * *
# if_freenameindex

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



           if_freenameindex — free memory allocated by if_nameindex
    


## SYNOPSIS



           #include <net/if.h>
    
           void if_freenameindex(struct if_nameindex *_ptr_);
    


## DESCRIPTION



           The _if_freenameindex_() function shall free the memory allocated by
           _if_nameindex_().  The _ptr_ argument shall be a pointer that was
           returned by _if_nameindex_().  After _if_freenameindex_() has been
           called, the application shall not use the array of which _ptr_ is
           the address.
    


## RETURN VALUE



           None.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_unregister_buffers

## NAME



           io_uring_unregister_buffers - unregister buffers for fixed buffer
           operations
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_unregister_buffers(3) function unregisters the fixed
           buffers previously registered to the _ring_.
    


## RETURN VALUE



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


* * *
# gnutls_x509_ext_print

## NAME



           gnutls_x509_ext_print - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_ext_print(gnutls_x509_ext_st ***_exts_**, unsigned int**
           _exts_size_**, gnutls_certificate_print_formats_t** _format_**,**
           **gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_ext_st * exts
                       The data to be printed
    
           unsigned int exts_size
                       the number of available structures
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print X.509 certificate extensions,
           suitable for display to a human.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


* * *
# pfm_terminate

## NAME



           pfm_terminate - free resources used by library
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **int pfm_terminate(void);**
    


## DESCRIPTION



           This is the last function that a program **must** call to free all the
           resources allocated by the library, e.g., memory.  The function is
           not reentrant, caller must ensure only one thread at a time is
           executing it.
    


## RETURN



           There is no return value to this function
    


* * *
# pmdaattribute

## NAME



           **pmdaAttribute** - informs a PMDA about client connection attributes
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaAttribute(int** _context_**, int** _key_**, char ***_value_**, int** _length_**,**
                             **pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), **pmdaAttribute** is the generic callback for responding  to
           client  connection  attributes.   These  attributes include client
           credential information, such as user ID and group ID.
    
           A PMDA that supports connection attributes will provide a  private
           **pmdaAttribute** callback  by assignment to _version.six.attribute_ of
           the _pmdaInterface_ structure, and implement custom logic for any of
           the attribute _key_ -_value_ pairs of interest to it.
    
           All attributes are associated with a specific client context,  and
           these  can  be  uniquely  identified using the _ctx_ first argument.
           The PMDA should track client connections, and disconnections using
           the pmdaSetEndContextCallBack(3)  interface,  as  a  result.   The
           pmdaGetContext(3) interface may be particularly helpful also.
    
           All  attributes are passed as _key_ -_value_ pairs and the _value_ is al‐
           ways passed as a null-terminated string of given _length_.  This in‐
           cludes numeric attributes like the user ID.
    
           The most commonly used attributes  would  be  PCP_ATTR_USERID  and
           PCP_ATTR_GROUPID but others may also be optionally passed (such as
           PCP_ATTR_USERNAME) if they are available.  Some attributes will be
           consumed  by  **pmcd** and  never  through  passed  to PMDAs, such as
           PCP_ATTR_PASSWORD.  A complete list of all possible attributes can
           be found in the headers listed above, all are prefixed by  PCP_AT‐
           TR.
    


## CAVEAT



           The  PMDA must be using **PMDA_INTERFACE_6** or later, as specified in
           the call to pmdaDSO(3) or pmdaDaemon(3).
    


## DIAGNOSTICS



           **pmdaAttribute** should return either zero on success, or a  negative
           return  code to indicate an error in handling the attribute.  This
           return code cannot be used to indicate a client should  be  disal‐
           lowed  access  - such functionality must be performed by the agent
           in response  to  callbacks  for  the  client  in  question  (using
           PM_ERR_PERMISSION  for those specific callbacks, for that specific
           client.  In other words, errors will be  be  passed  to  PMCD  but
           there  is  no  guarantee made that the error will be return to the
           client and result in termination of the client, for example.
    


* * *
# gnutls_x509_crt_get_pk_dsa_raw

## NAME



           gnutls_x509_crt_get_pk_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_dsa_raw(gnutls_x509_crt_t** _crt_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           gnutls_datum_t * p
                       will hold the p
    
           gnutls_datum_t * q
                       will hold the q
    
           gnutls_datum_t * g
                       will hold the g
    
           gnutls_datum_t * y
                       will hold the y
    


## DESCRIPTION



           This function will export the DSA public key's parameters found in
           the given certificate.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


* * *
# function::pgrp

## NAME



           function::pgrp - Returns the process group ID of the current
           process
    


## SYNOPSIS



               pgrp:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the process group ID of the current process.
    


* * *
# gnutls_x509_crq_set_key

## NAME



           gnutls_x509_crq_set_key - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_key(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_x509_privkey_t key
                       holds a private key
    


## DESCRIPTION



           This function will set the public parameters from the given
           private key to the request.
    


## RETURNS



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


* * *
# swscanf

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



           swscanf — convert formatted wide-character input
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           int swscanf(const wchar_t *restrict _ws_ ,
               const wchar_t *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fwscanf(3p).
    


* * *
# sd-journal

## NAME



           sd-journal - APIs for submitting and querying log entries to and
           from the journal
    


## SYNOPSIS



           **#include <systemd/sd-journal.h>**
    
           **pkg-config --cflags --libs libsystemd**
    


## DESCRIPTION



           sd-journal.h is part of libsystemd(3) and provides APIs to submit
           and query log entries. The APIs exposed act both as client for the
           systemd-journald.service(8) journal service and as parser for the
           journal files on disk.
    
           See sd_journal_print(3), sd_journal_stream_fd(3),
           sd_journal_open(3), sd_journal_next(3),
           sd_journal_get_realtime_usec(3), sd_journal_add_match(3),
           sd_journal_seek_head(3), sd_journal_enumerate_fields(3),
           sd_journal_get_cursor(3), sd_journal_get_cutoff_realtime_usec(3),
           sd_journal_get_cutoff_monotonic_usec(3), sd_journal_get_usage(3),
           sd_journal_get_catalog(3), sd_journal_get_fd(3),
           sd_journal_has_runtime_files(3) and
           sd_journal_has_persistent_files(3) for more information about the
           functions implemented.
    
           Command line access for submitting entries to the journal is
           available with the systemd-cat(1) tool. Command line access for
           querying entries from the journal is available with the
           journalctl(1) tool.
    


## THREAD SAFETY



           Functions that operate on sd_journal objects are thread agnostic —
           given sd_journal pointer may only be used from one specific thread
           at all times (and it has to be the very same one during the entire
           lifetime of the object), but multiple, independent threads may use
           multiple, independent objects safely. Other functions — those that
           are used to send entries to the journal, like sd_journal_print(3)
           and similar, or those that are used to retrieve global information
           like sd_journal_stream_fd(3) and
           sd_journal_get_catalog_for_message_id(3) — are fully thread-safe
           and may be called from multiple threads in parallel.
    


## OPTIONAL DEPENDENCIES



           Depending on which build-time options are enabled, functions that
           operate on sd_journal objects might cause optional shared
           libraries to be dynamically loaded via dlopen(3), such as
           decompression libraries (xz, lz4, zstd) or cryptographic libraries
           (gcrypt).
    


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


* * *
# gnutls_certificate_get_peers

## NAME



           gnutls_certificate_get_peers - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_datum_t ***
           **gnutls_certificate_get_peers(gnutls_session_t** _session_**, unsigned**
           **int ***_list_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           unsigned int * list_size
                       is the length of the certificate list (may be **NULL**)
    


## DESCRIPTION



           Get the peer's raw certificate (chain) as sent by the peer.  These
           certificates are in raw format (DER encoded for X.509).  In case
           of a X.509 then a certificate list may be present.  The list is
           provided as sent by the server; the server must send as first
           certificate in the list its own certificate, following the
           issuer's certificate, then the issuer's issuer etc. However, there
           are servers which violate this principle and thus on certain
           occasions this may be an unsorted list.
    
           In resumed sessions, this function will return the peer's
           certificate list as used in the first/original session.
    


## RETURNS



           a pointer to a **gnutls_datum_t** containing the peer's certificates,
           or **NULL** in case of an error or if no certificate was used.
    


* * *
# pmsetprogname

## NAME



           **pmSetProgname** , **pmGetProgname** - application name services
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmSetProgname(const char ***_program_**);**
           **char *pmGetProgname(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Within  the Performance Co-Pilot (PCP) run-time libraries the name
           of a running application is maintained to be used in error and di‐
           agnostic messages.
    
           The default application name is **pcp**.
    
           **pmSetProgname** may be used to set the application name  to  _program_
           after  stripping  any  leading  components  that  begin  with  the
           filesystem path name separator (``/'' for Unix-like systems).
    
           It is the callers responsibility to ensure the memory  pointed  to
           by  _program_  remains  available  for  the life of the application.
           Typically, the value passed as _program_ for a C  program  would  be
           **argv[0]**.   If _program_ is **NULL** , the default application name is re‐
           stored.
    
           **pmGetProgname** may be used to return the current application name.
    


* * *
# function::MAJOR

## NAME



           function::MAJOR - Extract major device number from a kernel device
           number (kdev_t)
    


## SYNOPSIS



               MAJOR:long(dev:long)
    


## ARGUMENTS



           _dev_
               Kernel device number to query.
    


* * *
# gnutls_db_check_entry_time

## NAME



           gnutls_db_check_entry_time - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **time_t gnutls_db_check_entry_time(gnutls_datum_t ***_entry_**);**
    


## ARGUMENTS



           gnutls_datum_t * entry
                       is a pointer to a **gnutls_datum_t** type.
    


## DESCRIPTION



           This function returns the time that this entry was active.  It can
           be used for database entry expiration.
    


## RETURNS



           The time this entry was created, or zero on error.
    


* * *
# probe::signal.check_ignored.return

## NAME



           probe::signal.check_ignored.return - Check to see signal is
           ignored completed
    


## SYNOPSIS



           signal.check_ignored.return
    


## VALUES



           _name_
               Name of the probe point
    
           _retstr_
               Return value as a string
    


* * *
# gnutls_pcert_import_x509_list

## NAME



           gnutls_pcert_import_x509_list - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_import_x509_list(gnutls_pcert_st ***_pcert_list_**,**
           **gnutls_x509_crt_t ***_crt_**, unsigned ***_ncrt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert_list
                       The structures to store the certificates; must not
                       contain initialized **gnutls_pcert_st** structures.
    
           gnutls_x509_crt_t * crt
                       The certificates to be imported
    
           unsigned * ncrt
                       The number of certificates in  _crt_ ; will be updated
                       if necessary
    
           unsigned int flags
                       zero or **GNUTLS_X509_CRT_LIST_SORT**
    


## DESCRIPTION



           This convenience function will import the given certificates to an
           already allocated set of **gnutls_pcert_st** structures. The
           structures must be deinitialized afterwards using
           **gnutls_pcert_deinit()**.  _pcert_list_ should contain space for at
           least  _ncrt_ elements.
    
           In the case **GNUTLS_X509_CRT_LIST_SORT** is specified and that
           function cannot sort the list, **GNUTLS_E_CERTIFICATE_LIST_UNSORTED**
           will be returned. Currently sorting can fail if the list size
           exceeds an internal constraint (16).
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# libpfm_arm_a64fx

## NAME



           libpfm_arm_a64fx - support for Fujitsu A64FX PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_a64fx**
           **PMU desc: Fujitsu A64FX**
    


## DESCRIPTION



           The library supports the Fujitsu A64FX core PMU.
    
           This PMU supports 8 counters and privilege levels filtering.  It
           can operate in 64 bit mode only.
    


## MODIFIERS



           The following modifiers are supported on Fujitsu A64FX:
    
           **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_anon_set_params_function

## NAME



           gnutls_anon_set_params_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_anon_set_params_function(gnutls_anon_server_credentials_t**
           _res_**, gnutls_params_function ***_func_**);**
    


## ARGUMENTS



           gnutls_anon_server_credentials_t res
                       is a gnutls_anon_server_credentials_t type
    
           gnutls_params_function * func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback in order for the server to get
           the Diffie-Hellman or RSA parameters for anonymous authentication.
           The callback should return **GNUTLS_E_SUCCESS**(0) on success.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# pthread_rwlock_tryrdlock

## 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_rwlock_tryrdlock — lock a read-write lock object for
           reading
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_rwlock_tryrdlock(pthread_rwlock_t *_rwlock_);
    


## DESCRIPTION



           Refer to pthread_rwlock_rdlock(3p).
    


* * *
# function::fullpath_struct_nameidata

## NAME



           function::fullpath_struct_nameidata - get the full nameidata path
    


## SYNOPSIS



               fullpath_struct_nameidata(nd:)
    


## ARGUMENTS



           _nd_
               Pointer to “struct nameidata”.
    


## DESCRIPTION



           Returns the full dirent name (full path to the root), like the
           kernel (and systemtap-tapset) d_path function, with a “/”.
    


* * *
# lcong48

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



           lcong48 — seed a uniformly distributed pseudo-random signed long
           integer generator
    


## SYNOPSIS



           #include <stdlib.h>
    
           void lcong48(unsigned short _param_[7]);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# audit_reset_lost

## NAME



           audit_reset_lost - reset lost event counter
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_reset_lost(int** _fd_**);**
    


## DESCRIPTION



           **audit_reset_lost**() resets the kernel's lost event counter using
           the descriptor _fd_ which must be an open audit netlink socket.
           This call requires that the kernel support
           **AUDIT_FEATURE_BITMAP_LOST_RESET**.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number.
    


* * *
# gnutls_x509_crq_get_private_key_usage_period

## NAME



           gnutls_x509_crq_get_private_key_usage_period - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_private_key_usage_period(gnutls_x509_crq_t**
           _crq_**, time_t ***_activation_**, time_t ***_expiration_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           time_t * activation
                       The activation time
    
           time_t * expiration
                       The expiration time
    
           unsigned int * critical
                       the extension status
    


## DESCRIPTION



           This function will return the expiration and activation times of
           the private key of the certificate.
    


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


* * *
# gnutls_digest_get_id

## NAME



           gnutls_digest_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_digest_algorithm_t gnutls_digest_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a digest algorithm name
    


## DESCRIPTION



           Convert a string to a **gnutls_digest_algorithm_t** value.  The names
           are compared in a case insensitive way.
    


## RETURNS



           a **gnutls_digest_algorithm_t** id of the specified MAC algorithm
           string, or **GNUTLS_DIG_UNKNOWN** on failure.
    


* * *
# wmemmove

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



           wmemmove — copy wide characters in memory with overlapping areas
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wmemmove(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 _wmemmove_() function shall copy _n_ wide characters from the
           object pointed to by _ws2_ to the object pointed to by _ws1_.  Copying
           shall take place as if the _n_ wide characters from the object
           pointed to by _ws2_ are first copied into a temporary array of _n_
           wide characters that does not overlap the objects pointed to by
           _ws1_ or _ws2_ , and then the _n_ wide characters from the temporary
           array are copied into the object pointed to by _ws1_.
    
           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 copy zero wide characters.
    


## RETURN VALUE



           The _wmemmove_() function shall return the value of _ws1_.
    


## ERRORS



           No errors are defined
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::start_stopwatch

## NAME



           function::start_stopwatch - Start a stopwatch
    


## SYNOPSIS



               start_stopwatch(name:string)
    


## ARGUMENTS



           _name_
               the stopwatch name
    


## DESCRIPTION



           Start stopwatch _name_. Creates stopwatch _name_ if it does not
           currently exist.
    


* * *