tripathysagar/man_text huggingface dataset:
# function::probemod

## NAME



           function::probemod - Return the probe point's kernel module name
    


## SYNOPSIS



               probemod:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the name of the kernel module containing the
           probe point, if known.
    


* * *
# pam_chauthtok

## NAME



           pam_chauthtok - updating authentication tokens
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_chauthtok** function is used to change the authentication
           token for a given user (as indicated by the state associated with
           the handle _pamh_).
    
           The _pamh_ argument is an authentication handle obtained by a prior
           call to pam_start(). The flags argument is the binary or of zero
           or more of the following values:
    
           PAM_SILENT
               Do not emit any messages.
    
           PAM_CHANGE_EXPIRED_AUTHTOK
               This argument indicates to the modules that the user's
               authentication token (password) should only be changed if it
               has expired. If this argument is not passed, the application
               requires that all authentication tokens are to be changed.
    


## RETURN VALUES



           PAM_AUTHTOK_ERR
               A module was unable to obtain the new authentication token.
    
           PAM_AUTHTOK_RECOVERY_ERR
               A module was unable to obtain the old authentication token.
    
           PAM_AUTHTOK_LOCK_BUSY
               One or more of the modules was unable to change the
               authentication token since it is currently locked.
    
           PAM_AUTHTOK_DISABLE_AGING
               Authentication token aging has been disabled for at least one
               of the modules.
    
           PAM_PERM_DENIED
               Permission denied.
    
           PAM_SUCCESS
               The authentication token was successfully updated.
    
           PAM_TRY_AGAIN
               Not all of the modules were in a position to update the
               authentication token(s). In such a case none of the user's
               authentication tokens are updated.
    
           PAM_USER_UNKNOWN
               User unknown to password service.
    


* * *
# function::kernel_string_quoted_utf32

## NAME



           function::kernel_string_quoted_utf32 - Quote given UTF-32 kernel
           string.
    


## SYNOPSIS



               kernel_string_quoted_utf32:string(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    


## DESCRIPTION



           This function combines quoting as per _string_quoted_ and UTF-32
           decoding as per _kernel_string_utf32_.
    


* * *
# function::strlen

## NAME



           function::strlen - Returns the length of a string
    


## SYNOPSIS



               strlen:long(s:string)
    


## ARGUMENTS



           _s_
               the string
    


## DESCRIPTION



           This function returns the length of the string, which can be zero
           up to MAXSTRINGLEN.
    


* * *
# probe::udp.disconnect.return

## NAME



           probe::udp.disconnect.return - UDP has been disconnected
           successfully
    


## SYNOPSIS



           udp.disconnect.return
    


## VALUES



           _dport_
               UDP destination port
    
           _sport_
               UDP source port
    
           _ret_
               Error code (0: no error)
    
           _name_
               The name of this probe
    
           _family_
               IP address family
    
           _saddr_
               A string representing the source IP address
    
           _daddr_
               A string representing the destination IP address
    


## CONTEXT



           The process which requested a UDP disconnection
    


* * *
# gnutls_pkcs12_bag_set_crt

## NAME



           gnutls_pkcs12_bag_set_crt - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_set_crt(gnutls_pkcs12_bag_t** _bag_**,**
           **gnutls_x509_crt_t** _crt_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           gnutls_x509_crt_t crt
                       the certificate to be copied.
    


## DESCRIPTION



           This function will insert the given certificate into the bag. This
           is just a wrapper over **gnutls_pkcs12_bag_set_data()**.
    


## RETURNS



           the index of the added bag on success, or a negative value on
           failure.
    


* * *
# gnutls_psk_set_client_credentials_function

## NAME



           gnutls_psk_set_client_credentials_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_client_credentials_function(gnutls_psk_client_credentials_t**
           _cred_**, gnutls_psk_client_credentials_function ***_func_**);**
    


## ARGUMENTS



           gnutls_psk_client_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_client_credentials_function * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the
           username and password for client PSK authentication.  The
           callback's function form is: int (*callback)(gnutls_session_t,
           char** username, gnutls_datum_t* key);
    
           The  _username_ and  _key_ ->data must be allocated using
           **gnutls_malloc()**.  The  _username_ should be an ASCII string or UTF-8
           string. In case of a UTF-8 string it is recommended to be
           following the PRECIS framework for usernames (rfc8265).
    
           The callback function will be called once per handshake.
    
           The callback function should return 0 on success.  -1 indicates an
           error.
    


* * *
# probe::nfs.proc.rename_done

## NAME



           probe::nfs.proc.rename_done - NFS client response to a rename RPC
           task
    


## SYNOPSIS



           nfs.proc.rename_done
    


## VALUES



           _status_
               result of last operation
    
           _server_ip_
               IP address of server
    
           _version_
               NFS version
    
           _old_fh_
               file handle of old parent dir
    
           _prot_
               transfer protocol
    
           _timestamp_
               V4 timestamp, which is used for lease renewal
    
           _new_fh_
               file handle of new parent dir
    


## DESCRIPTION



           Fires when a reply to a rename RPC task is received or some rename
           error occurs (timeout or socket shutdown).
    


* * *
# gnutls_anon_set_server_known_dh_params

## NAME



           gnutls_anon_set_server_known_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_anon_set_server_known_dh_params(gnutls_anon_server_credentials_t**
           _res_**, gnutls_sec_param_t** _sec_param_**);**
    


## ARGUMENTS



           gnutls_anon_server_credentials_t res
                       is a gnutls_anon_server_credentials_t type
    
           gnutls_sec_param_t sec_param
                       is an option of the **gnutls_sec_param_t** enumeration
    


## DESCRIPTION



           This function will set the Diffie-Hellman parameters for an
           anonymous server to use.  These parameters will be used in
           Anonymous Diffie-Hellman cipher suites and will be selected from
           the FFDHE set of RFC7919 according to the security level provided.
    


## DEPRECATED



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


## RETURNS



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


## SINCE



           3.5.6
    


* * *
# iswalpha

## NAME



           iswalpha - test for alphabetic wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswalpha(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswalpha**() function is the wide-character equivalent of the
           isalpha(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "alpha".
    
           The wide-character class "alpha" is a subclass of the wide-
           character class "alnum", and therefore also a subclass of the
           wide-character class "graph" and of the wide-character class
           "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "alpha" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "alpha" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           Being a subclass of the wide-character class "alnum", the wide-
           character class "alpha" is disjoint from the wide-character class
           "punct".
    
           The wide-character class "alpha" is disjoint from the wide-
           character class "digit".
    
           The wide-character class "alpha" contains the wide-character
           classes "upper" and "lower".
    
           The wide-character class "alpha" always contains at least the
           letters 'A' to 'Z' and 'a' to 'z'.
    


## RETURN VALUE



           The **iswalpha**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "alpha".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# gnutls_pkcs7_init

## NAME



           gnutls_pkcs7_init - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_pkcs7_t * pkcs7
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a PKCS7 structure. PKCS7 structures
           usually contain lists of X.509 Certificates and X.509 Certificate
           revocation lists.
    


## RETURNS



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


* * *
# setgrent

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



           setgrent — reset the group database to the first entry
    


## SYNOPSIS



           #include <grp.h>
    
           void setgrent(void);
    


## DESCRIPTION



           Refer to endgrent(3p).
    


* * *
# probe::kprocess.release

## NAME



           probe::kprocess.release - Process released
    


## SYNOPSIS



           kprocess.release
    


## VALUES



           _released_tid_
               TID of the task being released
    
           _task_
               A task handle to the process being released
    
           _released_pid_
               PID of the process being released
    
           _pid_
               Same as _released_pid_ for compatibility (deprecated)
    


## CONTEXT



           The context of the parent, if it wanted notification of this
           process' termination, else the context of the process itself.
    


## DESCRIPTION



           Fires when a process is released from the kernel. This always
           follows a kprocess.exit, though it may be delayed somewhat if the
           process waits in a zombie state.
    


* * *
# gnutls_x509_crt_set_subject_alt_othername

## NAME



           gnutls_x509_crt_set_subject_alt_othername - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_subject_alt_othername(gnutls_x509_crt_t**
           _crt_**, const char ***_oid_**, const void ***_data_**, unsigned int** _data_size_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const char * oid
                       The other name OID
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The size of data to be set
    
           unsigned int flags
                       GNUTLS_FSAN_SET to clear previous data or
                       GNUTLS_FSAN_APPEND to append.
    


## DESCRIPTION



           This function will set an "othername" to the subject alternative
           name certificate extension.
    
           The values set are set as binary values and are expected to have
           the proper DER encoding.  For convenience the flags
           **GNUTLS_FSAN_ENCODE_OCTET_STRING** and **GNUTLS_FSAN_ENCODE_UTF8_STRING**
           can be used to encode the provided data.
    


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# pthread_attr_setstack

## 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_attr_setstack — set the stack attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_setstack(pthread_attr_t *_attr_ , void *_stackaddr_ ,
               size_t _stacksize_);
    


## DESCRIPTION



           Refer to pthread_attr_getstack(3p).
    


* * *
# sd_journal_get_usage

## NAME



           sd_journal_get_usage - Journal disk usage
    


## SYNOPSIS



           **#include <systemd/sd-journal.h>**
    
           **int sd_journal_get_usage(sd_journal ***_j_**, uint64_t ***_bytes_**);**
    


## DESCRIPTION



           **sd_journal_get_usage()** determines the total disk space currently
           used by journal files (in bytes). If **SD_JOURNAL_LOCAL_ONLY** was
           passed when opening the journal, this value will only reflect the
           size of journal files of the local host, otherwise of all hosts.
    


## RETURN VALUE



           **sd_journal_get_usage()** returns 0 on success or a negative
           errno-style error code.
    


## NOTES



           All functions listed here are thread-agnostic and only a single
           specific thread may operate on a given object during its entire
           lifetime. It is safe to allocate multiple independent objects and
           use each from a specific thread in parallel. However, it is not
           safe to allocate such an object in one thread, and operate or free
           it from any other, even if locking is used to ensure these threads
           do not operate on it at the very same time.
    
           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    


* * *
# probe::tty.ioctl

## NAME



           probe::tty.ioctl - called when a ioctl is request to the tty
    


## SYNOPSIS



           tty.ioctl
    


## VALUES



           _name_
               the file name
    
           _cmd_
               the ioctl command
    
           _arg_
               the ioctl argument
    


* * *
# gnutls_x509_crt_set_issuer_dn_by_oid

## NAME



           gnutls_x509_crt_set_issuer_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_issuer_dn_by_oid(gnutls_x509_crt_t** _crt_**,**
           **const char ***_oid_**, unsigned int** _raw_flag_**, const void ***_name_**,**
           **unsigned int** _sizeof_name_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const char * oid
                       holds an Object Identifier in a null terminated string
    
           unsigned int raw_flag
                       must be 0, or 1 if the data are DER encoded
    
           const void * name
                       a pointer to the name
    
           unsigned int sizeof_name
                       holds the size of  _name_
    


## DESCRIPTION



           This function will set the part of the name of the Certificate
           issuer, specified by the given OID.  The input string should be
           ASCII or UTF-8 encoded.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           With this function you can only set the known OIDs. You can test
           for known OIDs using **gnutls_x509_dn_oid_known()**. For OIDs that are
           not known (by gnutls) you should properly DER encode your data,
           and call this function with  _raw_flag_ set.
    
           Normally you do not need to call this function, since the signing
           operation will copy the signer's name as the issuer of the
           certificate.
    


## RETURNS



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


* * *
# posix_spawnp

## 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_spawnp — spawn a process (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawnp(pid_t *restrict _pid_ , const char *restrict _file_ ,
               const posix_spawn_file_actions_t *_file_actions_ ,
               const posix_spawnattr_t *restrict _attrp_ ,
               char *const _argv_[restrict], char *const _envp_[restrict]);
    


## DESCRIPTION



           Refer to posix_spawn(3p).
    


* * *
# rquota

## NAME



           rquota - implement quotas on remote machines
    


## PROTOCOL



           **/usr/include/rpcsvc/rquota.x**
    


## DESCRIPTION



           The **rquota()** protocol inquires about quotas on remote machines.
           It is used in conjunction with NFS, since NFS itself does not
           implement quotas.
    


## PROGRAMMING



           **#include <rpcsvc/rquota.h>**
    
           The following XDR routines are available in **librpcsvc** :
           **xdr_getquota_arg**
           **xdr_getquota_rslt**
           **xdr_rquota**
    


* * *
# function::kernel_string_utf32

## NAME



           function::kernel_string_utf32 - Retrieves UTF-32 string from
           kernel memory
    


## SYNOPSIS



           1) kernel_string_utf32:string(addr:long)
    
           2) kernel_string_utf32:string(addr:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    
           _err_msg_
               The error message to return when data isn't available
    


## DESCRIPTION



           1) This function returns a null terminated UTF-8 string converted
           from the UTF-32 string at a given kernel memory address. Reports
           an error on string copy fault or conversion error.
    
           2) This function returns a null terminated UTF-8 string converted
           from the UTF-32 string at a given kernel memory address. Reports
           the given error message on string copy fault or conversion error.
    


* * *
# dane_query_data

## NAME



           dane_query_data - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_query_data(dane_query_t** _q_**, unsigned int** _idx_**, unsigned int**
           *****_usage_**, unsigned int ***_type_**, unsigned int ***_match_**, gnutls_datum_t**
           *****_data_**);**
    


## ARGUMENTS



           dane_query_t q
                       The query result structure
    
           unsigned int idx
                       The index of the query response.
    
           unsigned int * usage
                       The certificate usage (see **dane_cert_usage_t**)
    
           unsigned int * type
                       The certificate type (see **dane_cert_type_t**)
    
           unsigned int * match
                       The DANE matching type (see **dane_match_type_t**)
    
           gnutls_datum_t * data
                       The DANE data.
    


## DESCRIPTION



           This function will provide the DANE data from the query response.
    


## RETURNS



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


* * *
# io_uring_prep_fixed_fd_install

## NAME



           io_uring_prep_fixed_fd_install - prepare fixed file fd
           installation request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_fixed_fd_install(struct io_uring_sqe ***_sqe_**,**
                                               **int** _fd_**,**
                                               **unsigned int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_fixed_fd_install(3) helper prepares a fixed file
           descriptor installation. The submission queue entry _sqe_ is setup
           to install the direct/fixed file descriptor _fd_ with the specified
           _flags_ file installation flags.
    
           One use case of direct/fixed file descriptors is to turn a regular
           file descriptor into a direct one, reducing the overhead of any
           request that needs to access this file. This helper provides a way
           to go the other way, turning a direct descriptor into a regular
           file descriptor that can then subsequently be used by regular
           system calls that take a normal file descriptor.  This can be
           handy if no regular file descriptor exists for this direct
           descriptor. Either because it was instantiated directly as a fixed
           descriptor, or because the regular file was closed with close(2)
           after being turned into a direct descriptor.
    
           Upon successful return of this request, both a normal and fixed
           file descriptor exists for the same file. Either one of them may
           be used to access the file.  Either one of them may be closed
           without affecting the other one.
    
           _flags_ may be either zero, or set to **IORING_FIXED_FD_NO_CLOEXEC** to
           indicate that the new regular file descriptor should not be closed
           during exec. By default, **O_CLOEXEC** will be set on the new
           descriptor otherwise. Setting this field to anything but those two
           values will result in the request being failed with **-EINVAL** in the
           CQE _res_ field.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation, which
           in this case will be the value of the new regular file descriptor.
           In case of failure, a negative value is returned.
    


* * *
# rewind

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



           rewind — reset the file position indicator in a stream
    


## SYNOPSIS



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


## 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 call:
    
               rewind(stream)
    
           shall be equivalent to:
    
               (void) fseek(stream, 0L, SEEK_SET)
    
           except that _rewind_() shall also clear the error indicator.
    
           Since _rewind_() does not return a value, an application wishing to
           detect errors should clear _errno_ , then call _rewind_(), and if _errno_
           is non-zero, assume an error has occurred.
    


## RETURN VALUE



           The _rewind_() function shall not return a value.
    


## ERRORS



           Refer to fseek(3p) with the exception of **[EINVAL]** which does not
           apply.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::user_string_n

## NAME



           function::user_string_n - Retrieves string of given length from
           user space
    


## SYNOPSIS



           1) user_string_n:string(addr:long,n:long)
    
           2) user_string_n:string(addr:long,n:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    
           _n_
               the maximum length of the string (if not null terminated)
    
           _err_msg_
               the error message to return when data isn't available
    


## DESCRIPTION



           1) Returns the C string of a maximum given length from a given
           user space address. Reports an error on the rare cases when
           userspace data is not accessible at the given address.
    
           2) Returns the C string of a maximum given length from a given
           user space address. Returns the given error message string on the
           rare cases when userspace data is not accessible at the given
           address.
    


* * *
# gnutls_certificate_client_get_request_status

## NAME



           gnutls_certificate_client_get_request_status - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned**
           **gnutls_certificate_client_get_request_status(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           Get whether client certificate was requested on the last handshake
           or not.
    


## RETURNS



           0 if the peer (server) did not request client authentication or 1
           otherwise.
    


* * *
# pcre2_substring_nametable_scan

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_nametable_scan(const pcre2_code ***_code_**,**
             **PCRE2_SPTR** _name_**, PCRE2_SPTR ***_first_**, PCRE2_SPTR ***_last_**);**
    


## DESCRIPTION



    
           This convenience function finds, for a compiled pattern, the first
           and last entries for a given name in the table that translates
           capture group names into numbers.
    
             _code_    Compiled regular expression
             _name_    Name whose entries required
             _first_   Where to return a pointer to the first entry
             _last_    Where to return a pointer to the last entry
    
           When the name is found in the table, if _first_ is NULL, the
           function returns a group number, but if there is more than one
           matching entry, it is not defined which one. Otherwise, when both
           pointers have been set, the yield of the function is the length of
           each entry in code units. If the name is not found,
           PCRE2_ERROR_NOSUBSTRING is returned.
    
           There is a complete description of the PCRE2 native API, including
           the format of the table entries, in the **pcre2api** page, and a
           description of the POSIX API in the **pcre2posix** page.
    


* * *
# function::msecs_to_string

## NAME



           function::msecs_to_string - Human readable string for given
           milliseconds
    


## SYNOPSIS



               msecs_to_string:string(msecs:long)
    


## ARGUMENTS



           _msecs_
               Number of milliseconds to translate.
    


## DESCRIPTION



           Returns a string representing the number of milliseconds as a
           human readable string consisting of “XmY.ZZZs”, where X is the
           number of minutes, Y is the number of seconds and ZZZ is the
           number of milliseconds.
    


* * *
# function::uaddr

## NAME



           function::uaddr - User space address of current running task
    


## SYNOPSIS



               uaddr:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns the address in userspace that the current task was at when
           the probe occurred. When the current running task isn't a user
           space thread, or the address cannot be found, zero is returned.
           Can be used to see where the current task is combined with
           **usymname** or **usymdata**. Often the task will be in the VDSO where it
           entered the kernel.
    


* * *
# gnutls_handshake_set_random

## NAME



           gnutls_handshake_set_random - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_handshake_set_random(gnutls_session_t** _session_**, const**
           **gnutls_datum_t ***_random_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_datum_t * random
                       a random value of 32-bytes
    


## DESCRIPTION



           This function will explicitly set the server or client hello
           random value in the subsequent TLS handshake. The random value
           should be a 32-byte value.
    
           Note that this function should not normally be used as gnutls will
           select automatically a random value for the handshake.
    
           This function should not be used when resuming a session.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code.
    
           Since 3.1.9
    


* * *
# probe::sunrpc.clnt.bind_new_program

## NAME



           probe::sunrpc.clnt.bind_new_program - Bind a new RPC program to an
           existing client
    


## SYNOPSIS



           sunrpc.clnt.bind_new_program
    


## VALUES



           _progname_
               the name of new RPC program
    
           _servername_
               the server machine name
    
           _old_prog_
               the number of old RPC program
    
           _vers_
               the version of new RPC program
    
           _prog_
               the number of new RPC program
    
           _old_progname_
               the name of old RPC program
    
           _old_vers_
               the version of old RPC program
    


* * *
# auparse_get_num_fields

## NAME



           auparse_get_num_fields - get the number of fields
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_num_fields gets the number of fields in the current
           record of the current event.
    


## RETURN VALUE



           Returns 0 if an error occurs; otherwise, the number of fields.
    


* * *
# audit_value_needs_encoding

## NAME



           audit_value_needs_encoding - check a string to see if it needs
           encoding
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_value_needs_encoding(const char ***_str_**, unsigned int** _size_**);**
    


## DESCRIPTION



           **audit_value_needs_encoding**() checks a string to see if it needs
           encoding. Specifically, this function checks if the string
           contains a space, a double-quote, or a control character.  _str_ is
           the string to check if encoding is needed.  _size_ is the length of
           str.
    


## RETURN VALUE



           The return value if encoding is needed is 1. If not needed is 0.
    


* * *
# ibv_create_cq

## NAME



           ibv_create_cq, ibv_destroy_cq - create or destroy a completion
           queue (CQ)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_cq *ibv_create_cq(struct ibv_context** _*context_**, int** _cqe_**,**
                                        **void** _*cq_context_**,**
                                        **struct ibv_comp_channel** _*channel_**,**
                                        **int** _comp_vector_**);**
    
           **int ibv_destroy_cq(struct ibv_cq** _*cq_**);**
    


## DESCRIPTION



           **ibv_create_cq()** creates a completion queue (CQ) with at least _cqe_
           entries for the RDMA device context _context_.  The pointer
           _cq_context_ will be used to set user context pointer of the CQ
           structure. The argument _channel_ is optional; if not NULL, the
           completion channel _channel_ will be used to return completion
           events.  The CQ will use the completion vector _comp_vector_ for
           signaling completion events; it must be at least zero and less
           than _context_ ->num_comp_vectors.
    
           **ibv_destroy_cq()** destroys the CQ _cq_.
    


## RETURN VALUE



           **ibv_create_cq()** returns a pointer to the CQ, or NULL if the
           request fails.
    
           **ibv_destroy_cq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_create_cq()** may create a CQ with size greater than or equal to
           the requested size. Check the cqe attribute in the returned CQ for
           the actual size.
    
           **ibv_destroy_cq()** fails if any queue pair is still associated with
           this CQ.
    


* * *
# function::local_clock_s

## NAME



           function::local_clock_s - Number of seconds on the local cpu's
           clock
    


## SYNOPSIS



               local_clock_s:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of seconds on the local cpu's
           clock. This is always monotonic comparing on the same cpu, but may
           have some drift between cpus (within about a jiffy).
    


* * *
# function::system

## NAME



           function::system - Issue a command to the system
    


## SYNOPSIS



               system(cmd:string)
    


## ARGUMENTS



           _cmd_
               the command to issue to the system
    


## DESCRIPTION



           This function runs a command on the system. The command is started
           in the background some time after the current probe completes. The
           command is run with the same UID as the user running the stap or
           staprun command. The runtime may impose a relatively short length
           limit on the command string. Exceeding it may print a warning.
    


* * *
# l64a

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



           l64a — convert a 32-bit integer to a radix-64 ASCII string
    


## SYNOPSIS



           #include <stdlib.h>
    
           char *l64a(long _value_);
    


## DESCRIPTION



           Refer to a64l(3p).
    


* * *
# tapset::stopwatch

## NAME



           tapset::stopwatch - systemtap stopwatch tapset
    


## DESCRIPTION



           **delete_stopwatch**
                  Remove an existing stopwatch
    
                  See function::delete_stopwatch(3stap)
                   for details.
    
           **start_stopwatch**
                  Start a stopwatch
    
                  See function::start_stopwatch(3stap)
                   for details.
    
           **stop_stopwatch**
                  Stop a stopwatch
    
                  See function::stop_stopwatch(3stap)
                   for details.
    
           **read_stopwatch_ns**
                  Reads the time in nanoseconds for a stopwatch
    
                  See function::read_stopwatch_ns(3stap)
                   for details.
    
           **read_stopwatch_us**
                  Reads the time in microseconds for a stopwatch
    
                  See function::read_stopwatch_us(3stap)
                   for details.
    
           **read_stopwatch_ms**
                  Reads the time in milliseconds for a stopwatch
    
                  See function::read_stopwatch_ms(3stap)
                   for details.
    
           **read_stopwatch_s**
                  Reads the time in seconds for a stopwatch
    
                  See function::read_stopwatch_s(3stap)
                   for details.
    


* * *
# gnutls_x509_ext_import_key_usage

## NAME



           gnutls_x509_ext_import_key_usage - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_key_usage(const gnutls_datum_t ***_ext_**,**
           **unsigned int ***_key_usage_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       the DER encoded extension data
    
           unsigned int * key_usage
                       where the key usage bits will be stored
    


## DESCRIPTION



           This function will return certificate's key usage, by reading the
           DER data of the keyUsage X.509 extension (2.5.29.15). The key
           usage value will ORed values of the: **GNUTLS_KEY_DIGITAL_SIGNATURE** ,
           **GNUTLS_KEY_NON_REPUDIATION** , **GNUTLS_KEY_KEY_ENCIPHERMENT** ,
           **GNUTLS_KEY_DATA_ENCIPHERMENT** , **GNUTLS_KEY_KEY_AGREEMENT** ,
           **GNUTLS_KEY_KEY_CERT_SIGN** , **GNUTLS_KEY_CRL_SIGN** ,
           **GNUTLS_KEY_ENCIPHER_ONLY** , **GNUTLS_KEY_DECIPHER_ONLY**.
    


## RETURNS



           the certificate key usage, or a negative error code in case of
           parsing error.  If the certificate does not contain the keyUsage
           extension **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.3.0
    


* * *
# gnutls_x509_crl_set_crt

## NAME



           gnutls_x509_crl_set_crt - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_crt(gnutls_x509_crl_t** _crl_**,**
           **gnutls_x509_crt_t** _crt_**, time_t** _revocation_time_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t** with the
                       revoked certificate
    
           time_t revocation_time
                       The time this certificate was revoked
    


## DESCRIPTION



           This function will set a revoked certificate's serial number to
           the CRL.
    


## RETURNS



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


* * *
# io_uring_cqe_get_data64

## NAME



           io_uring_cqe_get_data - get user data for completion event
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void *io_uring_cqe_get_data(struct io_uring_cqe ***_cqe_**);**
    
           **__u64 io_uring_cqe_get_data64(struct io_uring_cqe ***_cqe_**);**
    


## DESCRIPTION



           The io_uring_cqe_get_data(3) function returns the user_data with
           the completion queue entry _cqe_ as a data pointer.
    
           The io_uring_cqe_get_data64(3) function returns the user_data with
           the completion queue entry _cqe_ as a 64-bit data value.
    
           After the caller has received a completion queue entry (CQE) with
           io_uring_wait_cqe(3), the application can call
           io_uring_cqe_get_data(3) or io_uring_cqe_get_data64(3) function to
           retrieve the _user_data_ value. This requires that _user_data_ has
           been set earlier with the function io_uring_sqe_set_data(3) or
           io_uring_sqe_set_data64(3).
    


## RETURN VALUE



           If the _user_data_ value has been set before submitting the request,
           it will be returned.  Otherwise, the return value is undefined.
    


* * *
# wctrans

## NAME



           wctrans - wide-character translation mapping
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **wctrans_t wctrans(const char ***_name_**);**
    


## DESCRIPTION



           The _wctrans_t_ type represents a mapping which can map a wide
           character to another wide character.  Its nature is
           implementation-dependent, but the special value _(wctrans_t) 0_
           denotes an invalid mapping.  Nonzero _wctrans_t_ values can be
           passed to the towctrans(3) function to actually perform the wide-
           character mapping.
    
           The **wctrans**() function returns a mapping, given by its name.  The
           set of valid names depends on the **LC_CTYPE** category of the current
           locale, but the following names are valid in all locales.
    
                  "tolower" - realizes the tolower(3) mapping
                  "toupper" - realizes the toupper(3) mapping
    


## RETURN VALUE



           The **wctrans**() function returns a mapping descriptor if the _name_ is
           valid.  Otherwise, it returns _(wctrans_t) 0_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# wcstoimax

## NAME



           wcstoimax, wcstoumax - convert wide-character string to integer
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stddef.h>**
           **#include <inttypes.h>**
    
           **intmax_t wcstoimax(const wchar_t *restrict** _nptr_**,**
                              **wchar_t **restrict** _endptr_**, int** _base_**);**
           **uintmax_t wcstoumax(const wchar_t *restrict** _nptr_**,**
                              **wchar_t **restrict** _endptr_**, int** _base_**);**
    


## DESCRIPTION



           These functions are just like **wcstol**(3) and **wcstoul**(3), except
           that they return a value of type _intmax_t_ and _uintmax_t_ ,
           respectively.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# tapset::ucontext-unwind

## NAME



           tapset::ucontext-unwind - systemtap ucontext-unwind tapset
    


## DESCRIPTION



           **print_ubacktrace**
                  Print stack back trace for current user-space task.
    
                  See function::print_ubacktrace(3stap)
                   for details.
    
           **print_ubacktrace**
                  Print stack back trace for current user-space task.
    
                  See function::print_ubacktrace(3stap)
                   for details.
    
           **sprint_ubacktrace**
                  Return stack back trace for current user-space task as
                  string.
    
                  See function::sprint_ubacktrace(3stap)
                   for details.
    
           **print_ubacktrace_fileline**
                  Print stack back trace for current user-space task.
    
                  See function::print_ubacktrace_fileline(3stap)
                   for details.
    
           **print_ubacktrace**
                  Print stack back trace for current user-space task.
    
                  See function::print_ubacktrace(3stap)
                   for details.
    
           **ubacktrace**
                  Hex backtrace of current user-space task stack.
    
                  See function::ubacktrace(3stap)
                   for details.
    


* * *