tripathysagar/man_text huggingface dataset:
# towlower

## NAME



           towlower, towlower_l - convert a wide character to lowercase
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **wint_t towlower(wint_t** _wc_**);**
           **wint_t towlower_l(wint_t** _wc_**, locale_t** _locale_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **towlower_l**():
               Since glibc 2.10:
                   _XOPEN_SOURCE >= 700
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **towlower**() function is the wide-character equivalent of the
           tolower(3) function.  If _wc_ is an uppercase wide character, and
           there exists a lowercase equivalent in the current locale, it
           returns the lowercase equivalent of _wc_.  In all other cases, _wc_ is
           returned unchanged.
    
           The **towlower_l**() function performs the same task, but performs the
           conversion based on the character type information in the locale
           specified by _locale_.  The behavior of **towlower_l**() is undefined if
           _locale_ is the special locale object **LC_GLOBAL_LOCALE**(see
           duplocale(3)) or is not a valid locale object handle.
    
           The argument _wc_ must be representable as a _wchar_t_ and be a valid
           character in the locale or be the value **WEOF**.
    


## RETURN VALUE



           If _wc_ was convertible to lowercase, **towlower**() returns its
           lowercase equivalent; otherwise it returns _wc_.
    


## ATTRIBUTES



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


## STANDARDS



           **towlower**()
                  C11, POSIX.1-2008 (XSI).
    
           **towlower_l**()
                  POSIX.1-2008.
    


## STANDARDS



           **towlower**()
                  C99, POSIX.1-2001 (XSI).  Obsolete in POSIX.1-2008 (XSI).
    
           **towlower_l**()
                  glibc 2.3.  POSIX.1-2008.
    


## NOTES



           The behavior of these functions depends on the **LC_CTYPE** category
           of the locale.
    
           These functions are not very appropriate for dealing with Unicode
           characters, because Unicode knows about three cases: upper, lower,
           and title case.
    


* * *
# probe::ioblock.request

## NAME



           probe::ioblock.request - Fires whenever making a generic block I/O
           request.
    


## SYNOPSIS



           ioblock.request
    


## VALUES



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


## CONTEXT



           The process makes block I/O request
    


* * *
# gnutls_x509_privkey_import2

## NAME



           gnutls_x509_privkey_import2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import2(gnutls_x509_privkey_t** _key_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**, const char ***
           _password_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_datum_t * data
                       The DER or PEM encoded key.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    
           const char * password
                       A password (optional)
    
           unsigned int flags
                       an ORed sequence of gnutls_pkcs_encrypt_flags_t
    


## DESCRIPTION



           This function will import the given DER or PEM encoded key, to the
           native **gnutls_x509_privkey_t** format, irrespective of the input
           format. The input format is auto-detected.
    
           The supported formats are basic unencrypted key, PKCS8, PKCS12,
           and the openssl format.
    
           If the provided key is encrypted but no password was given, then
           **GNUTLS_E_DECRYPTION_FAILED** is returned. Since GnuTLS 3.4.0 this
           function will utilize the PIN callbacks if any.
    


## RETURNS



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


* * *
# probe::nfs.aop.writepage

## NAME



           probe::nfs.aop.writepage - NFS client writing a mapped page to the
           NFS server
    


## SYNOPSIS



           nfs.aop.writepage
    


## VALUES



           _for_reclaim_
               a flag of writeback_control, indicates if it's invoked from
               the page allocator
    
           _page_index_
               offset within mapping, can used a page identifier and position
               identifier in the page frame
    
           _wsize_
               write size
    
           _sb_flag_
               super block flags
    
           _size_
               number of pages to be written in this execution
    
           _for_kupdate_
               a flag of writeback_control, indicates if it's a kupdate
               writeback
    
           _i_size_
               file length in bytes
    
           _i_flag_
               file flags
    
           ___page_
               the address of page
    
           _i_state_
               inode state flags
    
           _dev_
               device identifier
    
           _ino_
               inode number
    


## DESCRIPTION



           The priority of wb is decided by the flags _for_reclaim_ and
           _for_kupdate_.
    


* * *
# funlockfile

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



           funlockfile — stdio locking functions
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to flockfile(3p).
    


* * *
# gnutls_pk_to_sign

## NAME



           gnutls_pk_to_sign - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_sign_algorithm_t gnutls_pk_to_sign(gnutls_pk_algorithm_t**
           _pk_**, gnutls_digest_algorithm_t** _hash_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t pk
                       is a public key algorithm
    
           gnutls_digest_algorithm_t hash
                       a hash algorithm
    


## DESCRIPTION



           This function maps public key and hash algorithms combinations to
           signature algorithms.
    


## RETURNS



           return a **gnutls_sign_algorithm_t** value, or **GNUTLS_SIGN_UNKNOWN** on
           error.
    


* * *
# probe::stap.pass0

## NAME



           probe::stap.pass0 - Starting stap pass0 (parsing command line
           arguments)
    


## SYNOPSIS



           stap.pass0
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass0 fires after command line arguments have been parsed.
    


* * *
# function::kernel_or_user_string_quoted

## NAME



           function::kernel_or_user_string_quoted - Retrieves and quotes
           string from kernel or user memory
    


## SYNOPSIS



               kernel_or_user_string_quoted:string(addr:long)
    


## ARGUMENTS



           _addr_
               the kernel or user memory address to retrieve the string from
    


## DESCRIPTION



           Similar to kernel_string_quoted except user memory is a fallback
           method
    


* * *
# gnutls_x509_privkey_deinit

## NAME



           gnutls_x509_privkey_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_privkey_deinit(gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The key to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a private key structure.
    


* * *
# gnutls_pkcs7_set_crt

## NAME



           gnutls_pkcs7_set_crt - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_set_crt(gnutls_pkcs7_t** _pkcs7_**, gnutls_x509_crt_t**
           _crt_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           gnutls_x509_crt_t crt
                       the certificate to be copied.
    


## DESCRIPTION



           This function will add a parsed certificate to the PKCS7 or
           RFC2630 certificate set.  This is a wrapper function over
           **gnutls_pkcs7_set_crt_raw()**.
    


## RETURNS



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


* * *
# gnutls_srtp_set_mki

## NAME



           gnutls_srtp_set_mki - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_datum_t * mki
                       holds the MKI
    


## DESCRIPTION



           This function sets the Master Key Identifier, to be used by this
           session (if any).
    


## RETURNS



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


* * *
# gnutls_pkcs11_get_raw_issuer

## NAME



           gnutls_pkcs11_get_raw_issuer - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function will return the issuer of a given certificate, if it
           is stored in the token. By default only marked as trusted issuers
           are returned. If any issuer should be returned specify
           **GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_ANY** in  _flags_ .
    


## RETURNS



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


## SINCE



           3.2.7
    


* * *
# probe::nfsd.lookup

## NAME



           probe::nfsd.lookup - NFS server opening or searching file for a
           file for client
    


## SYNOPSIS



           nfsd.lookup
    


## VALUES



           _filename_
               file name
    
           _fh_
               file handle of parent dir(the first part is the length of the
               file handle)
    
           _filelen_
               the length of file name
    
           _client_ip_
               the ip address of client
    


* * *
# gnutls_x509_key_purpose_get

## NAME



           gnutls_x509_key_purpose_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_key_purpose_get(gnutls_x509_key_purposes_t** _p_**,**
           **unsigned** _idx_**, gnutls_datum_t ***_oid_**);**
    


## ARGUMENTS



           gnutls_x509_key_purposes_t p
                       The key purposes
    
           unsigned idx
                       The index of the key purpose to retrieve
    
           gnutls_datum_t * oid
                       Will hold the object identifier of the key purpose (to
                       be treated as constant)
    


## DESCRIPTION



           This function will retrieve the specified by the index key purpose
           in the purposes type. The object identifier will be a null
           terminated string.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the index is out of
           bounds, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# io_uring_prep_symlinkat

## NAME



           io_uring_prep_symlinkat - prepare a symlinkat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_symlinkat(struct io_uring_sqe ***_sqe_**,**
                                        **const char ***_target_**,**
                                        **int** _newdirfd_**,**
                                        **const char ***_linkpath_**);**
    
           **void io_uring_prep_symlink(struct io_uring_sqe ***_sqe_**,**
                                      **const char ***_target_**,**
                                      **const char ***_linkpath_**);**
    


## DESCRIPTION



           The io_uring_prep_symlinkat(3) function prepares a symlinkat
           request. The submission queue entry _sqe_ is setup to symlink the
           target path pointed to by _target_ to the new destination indicated
           by _newdirfd_ and _linkpath_.
    
           The io_uring_prep_symlink(3) function prepares a symlink request.
           The submission queue entry _sqe_ is setup to symlink the target path
           pointed to by _target_ to the new destination indicated by _linkpath_
           relative to the current working directory. This function prepares
           an async symlink(2) request. See that man page for details.
    
           These functions prepare an async symlinkat(2) or symlink(2)
           request. See those man pages for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



           As with any request that passes in data in a struct, that data
           must remain valid until the request has been successfully
           submitted. It need not remain valid until completion. Once a
           request has been submitted, the in-kernel state is stable. Very
           early kernels (5.4 and earlier) required state to be stable until
           the completion occurred. Applications can test for this behavior
           by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).
    


* * *
# pam_misc_setenv

## NAME



           pam_misc_setenv - BSD like PAM environment variable setting
    


## SYNOPSIS



           **#include <security/pam_misc.h>**
    
           **int pam_misc_setenv(pam_handle_t ***_pamh_**, const char ***_name_**,**
                               **const char ***_value_**, int** _readonly_**);**
    


## DESCRIPTION



           This function performs a task equivalent to pam_putenv(3), its
           syntax is, however, more like the BSD style function; **setenv()**.
           The _name_ and _value_ are concatenated with an '=' to form a
           name=value and passed to **pam_putenv()**. If, however, the PAM
           variable is already set, the replacement will only be applied if
           the last argument, _readonly_ , is zero.
    


## STANDARDS



           The **pam_misc_setenv** function is part of the **libpam_misc** Library
           and not defined in any standard.
    


* * *
# mlx5dv_create_flow_action_modify_header

## NAME



           mlx5dv_create_flow_action_modify_header - Flow action modify
           header for mlx5 provider
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_flow_action *
                  mlx5dv_create_flow_action_modify_header(struct ibv_context *ctx,
                                      size_t actions_sz,
                                      uint64_t actions[],
                                      enum mlx5dv_flow_table_type ft_type)
    


## DESCRIPTION



           Create a modify header flow steering action, it allows mutating a
           packet header.
    


## ARGUMENTS



           _ctx_    RDMA device context to create the action on.
    
           _actions_sz_
                  The size of _actions_ buffer in bytes.
    
           _actions_
                  A buffer which contains modify actions provided in device
                  spec format (i.e. be64).
    
           _ft_type_
                  Defines the flow table type to which the modify header
                  action will be attached.
    
                  MLX5DV_FLOW_TABLE_TYPE_NIC_RX: RX FLOW TABLE
    
                  MLX5DV_FLOW_TABLE_TYPE_NIC_TX: TX FLOW TABLE
    


## RETURN VALUE



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


* * *
# gnutls_tpm_privkey_delete

## NAME



           gnutls_tpm_privkey_delete - API function
    


## SYNOPSIS



           **#include <gnutls/tpm.h>**
    
           **int gnutls_tpm_privkey_delete(const char ***_url_**, const char ***
           _srk_password_**);**
    


## ARGUMENTS



           const char * url
                       the URL describing the key
    
           const char * srk_password
                       a password for the SRK key
    


## DESCRIPTION



           This function will unregister the private key from the TPM chip.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# io_uring_queue_exit

## NAME



           io_uring_queue_exit - tear down io_uring submission and completion
           queues
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_queue_exit(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_queue_exit(3) will release all resources acquired and
           initialized by io_uring_queue_init(3).  It first unmaps the memory
           shared between the application and the kernel and then closes the
           io_uring file descriptor.
    


## RETURN VALUE



           None
    


* * *
# probe::nfsd.write

## NAME



           probe::nfsd.write - NFS server writing data to a file for client
    


## SYNOPSIS



           nfsd.write
    


## VALUES



           _size_
               read bytes
    
           _file_
               argument file, indicates if the file has been opened.
    
           _vec_
               struct kvec, includes buf address in kernel address and length
               of each buffer
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _offset_
               the offset of file
    
           _client_ip_
               the ip address of client
    
           _vlen_
               read blocks
    
           _count_
               read bytes
    


* * *
# pmdaprofile

## NAME



           **pmdaProfile** - update instance profile for PMDA in preparation for
           the next fetch from PMCD
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaProfile(pmProfile ***_prof_**, pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), **pmdaProfile** is the default callback  which  handles  the
           receipt  of a **pmProfile** from pmcd(1).  A profile describes the in‐
           stances that **pmcd** requires in the **pmResult** structure  returned  by
           the next fetch.  **pmdaProfile** simply stores the new profile.
    


## CAVEAT



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


* * *
# gnutls_hex_decode2

## NAME



           gnutls_hex_decode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_hex_decode2(const gnutls_datum_t ***_hex_data_**,**
           **gnutls_datum_t ***_result_**);**
    


## ARGUMENTS



           const gnutls_datum_t * hex_data
                       contain the encoded data
    
           gnutls_datum_t * result
                       the result in an allocated string
    


## DESCRIPTION



           This function will decode the given encoded data, using the hex
           encoding used by PSK password files.
    


## RETURNS



           **GNUTLS_E_PARSING_ERROR** on invalid hex data, or 0 on success.
    


* * *
# tapset::timestamp_monotonic

## NAME



           tapset::timestamp_monotonic - systemtap timestamp_monotonic tapset
    


## DESCRIPTION



           **cpu_clock_ns**
                  Number of nanoseconds on the given cpu's clock
    
                  See function::cpu_clock_ns(3stap)
                   for details.
    
           **cpu_clock_us**
                  Number of microseconds on the given cpu's clock
    
                  See function::cpu_clock_us(3stap)
                   for details.
    
           **cpu_clock_ms**
                  Number of milliseconds on the given cpu's clock
    
                  See function::cpu_clock_ms(3stap)
                   for details.
    
           **cpu_clock_s**
                  Number of seconds on the given cpu's clock
    
                  See function::cpu_clock_s(3stap)
                   for details.
    
           **local_clock_ns**
                  Number of nanoseconds on the local cpu's clock
    
                  See function::local_clock_ns(3stap)
                   for details.
    
           **local_clock_us**
                  Number of microseconds on the local cpu's clock
    
                  See function::local_clock_us(3stap)
                   for details.
    
           **local_clock_ms**
                  Number of milliseconds on the local cpu's clock
    
                  See function::local_clock_ms(3stap)
                   for details.
    
           **local_clock_s**
                  Number of seconds on the local cpu's clock
    
                  See function::local_clock_s(3stap)
                   for details.
    
           **ktime_get_ns**
                  Number of nanoseconds since boot
    
                  See function::ktime_get_ns(3stap)
                   for details.
    


* * *
# getc

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



           getc — get a byte from a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int getc(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 _getc_() function shall be equivalent to fgetc(3p), except that
           if it is implemented as a macro it may evaluate _stream_ more than
           once, so the argument should never be an expression with side-
           effects.
    


## RETURN VALUE



           Refer to fgetc(3p).
    


## ERRORS



           Refer to fgetc(3p).
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           If the integer value returned by _getc_() is stored into a variable
           of type **char** and then compared against the integer constant EOF,
           the comparison may never succeed, because sign-extension of a
           variable of type **char** on widening to integer is implementation-
           defined.
    
           Since it may be implemented as a macro, _getc_() may treat
           incorrectly a _stream_ argument with side-effects. In particular,
           _getc_(*_f_ ++) does not necessarily work as expected. Therefore, use
           of this function should be preceded by **"#undef** getc" in such
           situations; _fgetc_() could also be used.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# libpfm_intel_hswep_unc_sbo

## NAME



           libpfm_intel_hswep_unc_sbo - support for Intel Haswell-EP S-Box
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_sbo**
           **PMU desc: Intel Haswell-EP S-Box uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell Rrint Transfer unit (S-Box)
           uncore PMU.  This PMU model only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell S-Box
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of HA cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:15].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# function::reverse_path_walk

## NAME



           function::reverse_path_walk - get the full dirent path
    


## SYNOPSIS



               reverse_path_walk:string(dentry:long)
    


## ARGUMENTS



           _dentry_
               Pointer to dentry.
    


## DESCRIPTION



           Returns the path name (partial path to mount point).
    


* * *
# gnutls_x509_spki_get_rsa_pss_params

## NAME



           gnutls_x509_spki_get_rsa_pss_params - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_spki_get_rsa_pss_params(gnutls_x509_spki_t** _spki_**,**
           **gnutls_digest_algorithm_t ***_dig_**, unsigned int ***_salt_size_**);**
    


## ARGUMENTS



           gnutls_x509_spki_t spki
                       the SubjectPublicKeyInfo structure
    
           gnutls_digest_algorithm_t * dig
                       if non-NULL, it will hold the digest algorithm
    
           unsigned int * salt_size
                       if non-NULL, it will hold the salt size
    


## DESCRIPTION



           This function will get the public key algorithm parameters of
           RSA-PSS type.
    


## RETURNS



           zero if the parameters are present or a negative value on error.
    


## SINCE



           3.6.0
    


* * *
# qecvt

## NAME



           qecvt, qfcvt, qgcvt - convert a floating-point number to a string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **[[deprecated]] char *qecvt(long double** _number_**, int** _ndigits_**,**
                                      **int *restrict** _decpt_**, int *restrict** _sign_**);**
           **[[deprecated]] char *qfcvt(long double** _number_**, int** _ndigits_**,**
                                      **int *restrict** _decpt_**, int *restrict** _sign_**);**
           **[[deprecated]] char *qgcvt(long double** _number_**, int** _ndigit_**, char ***_buf_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **qecvt**(), **qfcvt**(), **qgcvt**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               In glibc up to and including 2.19:
                   _SVID_SOURCE
    


## DESCRIPTION



           The functions **qecvt**(), **qfcvt**(), and **qgcvt**() are identical to
           ecvt(3), fcvt(3), and gcvt(3) respectively, except that they use a
           _long double_ argument _number_.  See ecvt(3) and gcvt(3).
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# fesetround

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



           fesetround — set current rounding direction
    


## SYNOPSIS



           #include <fenv.h>
    
           int fesetround(int _round_);
    


## DESCRIPTION



           Refer to fegetround(3p).
    


* * *
# function::speculate

## NAME



           function::speculate - Store a string for possible output later
    


## SYNOPSIS



               speculate(id:long,output:string)
    


## ARGUMENTS



           _id_
               buffer id to store the information in
    
           _output_
               string to write out when commit occurs
    


## DESCRIPTION



           Add a string to the speculaive buffer for id.
    


* * *
# function::real_mount

## NAME



           function::real_mount - get the 'struct mount' pointer
    


## SYNOPSIS



               real_mount:long(vfsmnt:long)
    


## ARGUMENTS



           _vfsmnt_
               Pointer to 'struct vfsmount'
    


## DESCRIPTION



           Returns the 'struct mount' pointer value for a 'struct vfsmount'
           pointer.
    


* * *
# gnutls_certificate_set_flags

## NAME



           gnutls_certificate_set_flags - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_certificate_set_flags(gnutls_certificate_credentials_t**
           _res_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           unsigned int flags
                       are the flags of **gnutls_certificate_flags** type
    


## DESCRIPTION



           This function will set flags to tweak the operation of the
           credentials structure. See the **gnutls_certificate_flags**
           enumerations for more information on the available flags.
    


## SINCE



           3.4.7
    


* * *
# semanage_bool_set_active

## NAME



           semanage_bool_set_active - update an existing SELinux boolean in
           the currently active policy
    


## SYNOPSIS



           **#include <semanage/booleans_active.h>**
    
           **extern int semanage_bool_set_active (**
                **semanage_handle_t ***_handle_**,**
                **const semanage_bool_key_t ***_key_**,**
                **const semanage_bool_t ***_data_**);**
    


## DESCRIPTION



           **Behavior:**
                  The set function will fail if no matching key is found in
                  the local store. Otherwise, the provided object will
                  replace the current one. When **semanage_commit**(3) is
                  invoked, changes will be written permanently into the local
                  store, and will be loaded into policy. Validity of the
                  object being added is checked at commit time.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The _key_ identifies
                  the _data_ object, which will be written into the store. The
                  key are data are properties of the caller, and are not
                  stored or modified internally.
    
           **Requirements:**
                  This function requires an semanage connection to be
                  established (see **semanage_connect**(3) ), and must be
                  executed in a transaction (see
                  **semanage_begin_transaction**(3) ).
    


## RETURN VALUE



           In case of failure, -1 is returned, and the semanage error
           callback is invoked, describing the error.  Otherwise 0 is
           returned.
    


* * *
# gnutls_dtls_get_data_mtu

## NAME



           gnutls_dtls_get_data_mtu - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **unsigned int gnutls_dtls_get_data_mtu(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will return the actual maximum transfer unit for
           application data. I.e. DTLS headers are subtracted from the actual
           MTU which is set using **gnutls_dtls_set_mtu()**.
    


## RETURNS



           the maximum allowed transfer unit.
    


## SINCE



           3.0
    


* * *
# function::print_ubacktrace_brief

## NAME



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


## SYNOPSIS



               print_ubacktrace_brief()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Equivalent to **print_ubacktrace** , but output for each symbol is
           shorter (just name and offset, or just the hex address of no
           symbol could be found).
    


## NOTE



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


* * *
# selinux_file_context_verify

## NAME



           selinux_file_context_verify - Compare the SELinux security context
           on disk to the default security context required by the policy
           file contexts file
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int selinux_file_context_verify(const char ***_path_**, mode_t** _mode_**);**
    


## DESCRIPTION



           **selinux_file_context_verify**() compares the context of the
           specified _path_ that is held on disk (in the extended attribute),
           to the system default entry held in the file contexts series of
           files.
    
           The _mode_ may be zero.
    
           Note that the two contexts are compared for "significant"
           differences (i.e. the user component of the contexts are ignored)
           as shown in the **EXAMPLE** section.
    


## RETURN VALUE



           If the contexts significantly match, 1 (one) is returned.
    
           If the contexts do not match 0 (zero) is returned and _errno_ is set
           to either **ENOENT** or **EINVAL** for the reasons listed in the **ERRORS**
           section, or if _errno_ = 0 then the contexts did not match.
    
           On failure -1 is returned and _errno_ set appropriately.
    


## ERRORS



           **ENOTSUP**
                  if extended attributes are not supported by the file
                  system.
    
           **ENOENT** if there is no entry in the file contexts series of files
                  or _path_ does not exist.
    
           **EINVAL** if the entry in the file contexts series of files or _path_
                  are invalid, or the returned context fails validation.
    
           **ENOMEM** if attempt to allocate memory failed.
    


## FILES



           The following configuration files (the file contexts series of
           files) supporting the active policy will be used (should they
           exist) to determine the _path_ default context:
    
                  _contexts/files/file_contexts_ - This file must exist.
    
                  _contexts/files/file_contexts.local_ - If exists has local
                  customizations.
    
                  _contexts/files/file_contexts.homedirs_ - If exists has users
                  home directory customizations.
    
                  _contexts/files/file_contexts.subs_ - If exists has
                  substitutions that are then applied to the 'in memory'
                  version of the file contexts files.
    


## EXAMPLE



           If the files context is:
                  unconfined_u:object_r:admin_home_t:s0
    
           and the default context defined in the file contexts file is:
                  system_u:object_r:admin_home_t:s0
    
           then the actual strings compared are:
                  :object_r:admin_home_t:s0 and :object_r:admin_home_t:s0
    
           Therefore they will match and **selinux_file_context_verify**() will
           return 1.
    


* * *
# avc_netlink_loop

## NAME



           avc_netlink_open, avc_netlink_close, avc_netlink_acquire_fd,
           avc_netlink_release_fd, avc_netlink_check_nb, avc_netlink_loop -
           SELinux netlink processing
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/avc.h>**
    
           **int avc_netlink_open(int** _blocking_**);**
    
           **void avc_netlink_close(void);**
    
           **int avc_netlink_acquire_fd(void);**
    
           **void avc_netlink_release_fd(void);**
    
           **void avc_netlink_loop(void);**
    
           **int avc_netlink_check_nb(void);**
    


## DESCRIPTION



           These functions enable applications to handle notification of
           SELinux events via netlink.  The userspace AVC normally checks for
           netlink messages on each call to avc_has_perm(3).  Applications
           may wish to override this behavior and check for notification
           separately, for example in a select(2) loop.  These functions also
           permit netlink monitoring without requiring a call to avc_open(3).
    
           **avc_netlink_open**() opens a netlink socket to receive SELinux
           notifications.  The socket descriptor is stored internally; use
           avc_netlink_acquire_fd(3) to take ownership of it in application
           code.  The _blocking_ argument controls whether the O_NONBLOCK flag
           is set on the socket descriptor.  avc_open(3) calls this function
           internally, specifying non-blocking behavior.
    
           **avc_netlink_close**() closes the netlink socket.  This function is
           called automatically by avc_destroy(3).
    
           **avc_netlink_acquire_fd**() returns the netlink socket descriptor
           number and informs the userspace AVC not to check the socket
           descriptor automatically on calls to avc_has_perm(3).  If no such
           socket descriptor exists, avc_netlink_acquire_fd(3) will first
           call avc_netlink_open(3) and then return the resulting fd.
    
           **avc_netlink_release_fd**() returns control of the netlink socket to
           the userspace AVC, re-enabling automatic processing of
           notifications.
    
           **avc_netlink_check_nb**() checks the netlink socket for pending
           messages and processes them.  Callbacks for policyload and
           enforcing changes will be called; see selinux_set_callback(3).
           This function does not block.
    
           **avc_netlink_loop**() enters a loop blocking on the netlink socket
           and processing messages as they are received.  This function will
           not return unless an error occurs on the socket, in which case the
           socket is closed.
    


## RETURN VALUE



           **avc_netlink_acquire_fd**() returns a non-negative file descriptor
           number on success.  Other functions with a return value return
           zero on success.  On error, -1 is returned and _errno_ is set
           appropriately.
    


* * *
# function::probe_type

## NAME



           function::probe_type - The low level probe handler type of the
           current probe.
    


## SYNOPSIS



               probe_type:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns a short string describing the low level probe handler type
           for the current probe point. This is for informational purposes
           only. Depending on the low level probe handler different context
           functions can or cannot provide information about the current
           event (for example some probe handlers only trigger in user space
           and have no associated kernel context). High-level probes might
           map to the same or different low-level probes (depending on
           systemtap version and/or kernel used).
    


* * *
# sigwait

## NAME



           sigwait - wait for a signal
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **int sigwait(const sigset_t *restrict** _set_**, int *restrict** _sig_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **sigwait**():
               Since glibc 2.26:
                   _POSIX_C_SOURCE >= 199506L
               glibc 2.25 and earlier:
                   _POSIX_C_SOURCE
    


## DESCRIPTION



           The **sigwait**() function suspends execution of the calling thread
           until one of the signals specified in the signal set _set_ becomes
           pending.  For a signal to become pending, it must first be blocked
           with sigprocmask(2).  The function accepts the signal (removes it
           from the pending list of signals), and returns the signal number
           in _sig_.
    
           The operation of **sigwait**() is the same as sigwaitinfo(2), except
           that:
    
           •  **sigwait**() returns only the signal number, rather than a
              _siginfo_t_ structure describing the signal.
    
           •  The return values of the two functions are different.
    


## RETURN VALUE



           On success, **sigwait**() returns 0.  On error, it returns a positive
           error number (listed in ERRORS).
    


## ERRORS



           **EINVAL** _set_ contains an invalid signal number.
    


## ATTRIBUTES



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


## VERSIONS



           **sigwait**() is implemented using sigtimedwait(2); consult its **NOTES**.
    
           The glibc implementation of **sigwait**() silently ignores attempts to
           wait for the two real-time signals that are used internally by the
           NPTL threading implementation.  See nptl(7) for details.
    


## STANDARDS



           POSIX.1-2008.
    


## EXAMPLES



           See pthread_sigmask(3).
    


* * *