tripathysagar/man_text huggingface dataset:
# libpfm_amd64_fam16h

## NAME



           libpfm_amd64_fam16h - support for AMD64 Family 16h processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam16h**
           **PMU desc: AMD64 Fam16h Zen**
    


## DESCRIPTION



           The library supports AMD Family 16h processors core PMU in both 32
           and 64-bit modes.
    


## MODIFIERS



           The following modifiers are supported on AMD64 Family 16h core
           PMU:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **h** Measure at while executing in host mode (when using
                  virtualization). This corresponds to **PFM_PLMH**.  This
                  modifier is available starting with Fam10h. This is a
                  boolean modifier.
    
           **g** Measure at while executing in guest mode (when using
                  virtualization). This modifier is available starting with
                  Fam10h. This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of 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:255].
    


* * *
# probe::netdev.receive

## NAME



           probe::netdev.receive - Data received from network device.
    


## SYNOPSIS



           netdev.receive
    


## VALUES



           _protocol_
               Protocol of received packet.
    
           _length_
               The length of the receiving buffer.
    
           _dev_name_
               The name of the device. e.g: eth0, ath1.
    


* * *
# gnutls_pkcs7_print

## NAME



           gnutls_pkcs7_print - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_print(gnutls_pkcs7_t** _pkcs7_**,**
           **gnutls_certificate_print_formats_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The PKCS7 struct to be printed
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print a signed PKCS **7** structure,
           suitable for display to a human.
    
           Currently the supported formats are **GNUTLS_CRT_PRINT_FULL** and
           **GNUTLS_CRT_PRINT_COMPACT**.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


* * *
# gnutls_ocsp_resp_get_status

## NAME



           gnutls_ocsp_resp_get_status - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_status(gnutls_ocsp_resp_const_t** _resp_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    


## DESCRIPTION



           This function will return the status of a OCSP response, an
           **gnutls_ocsp_resp_status_t** enumeration.
    


## RETURNS



           status of OCSP request as a **gnutls_ocsp_resp_status_t** , or a
           negative error code on error.
    


* * *
# gethostent

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



           gethostent — network host database functions
    


## SYNOPSIS



           #include <netdb.h>
    
           struct hostent *gethostent(void);
    


## DESCRIPTION



           Refer to endhostent(3p).
    


* * *
# gnutls_ocsp_resp_get_version

## NAME



           gnutls_ocsp_resp_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_version(gnutls_ocsp_resp_const_t** _resp_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    


## DESCRIPTION



           This function will return the version of the Basic OCSP Response.
           Typically this is always 1 indicating version 1.
    


## RETURNS



           version of Basic OCSP response, or a negative error code on error.
    


* * *
# probe::udp.sendmsg

## NAME



           probe::udp.sendmsg - Fires whenever a process sends a UDP message
    


## SYNOPSIS



           udp.sendmsg
    


## VALUES



           _sock_
               Network socket used by the process
    
           _saddr_
               A string representing the source IP address
    
           _family_
               IP address family
    
           _name_
               The name of this probe
    
           _daddr_
               A string representing the destination IP address
    
           _size_
               Number of bytes sent by the process
    
           _dport_
               UDP destination port
    
           _sport_
               UDP source port
    


## CONTEXT



           The process which sent a UDP message
    


* * *
# probe::signal.force_segv.return

## NAME



           probe::signal.force_segv.return - Forcing send of SIGSEGV complete
    


## SYNOPSIS



           signal.force_segv.return
    


## VALUES



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


* * *
# probe::udp.sendmsg.return

## NAME



           probe::udp.sendmsg.return - Fires whenever an attempt to send a
           UDP message is completed
    


## SYNOPSIS



           udp.sendmsg.return
    


## VALUES



           _size_
               Number of bytes sent by the process
    
           _name_
               The name of this probe
    


## CONTEXT



           The process which sent a UDP message
    


* * *
# function::htons

## NAME



           function::htons - Convert 16-bit short from host to network order
    


## SYNOPSIS



               htons:long(x:long)
    


## ARGUMENTS



           _x_
               Value to convert
    


* * *
# gnutls_compress_certificate_get_selected_method

## NAME



           gnutls_compress_certificate_get_selected_method - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_compression_method_t**
           **gnutls_compress_certificate_get_selected_method(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function returns the certificate compression method that has
           been selected to compress the certificate before sending it to the
           peer.  The selection is done based on the local list of supported
           compression methods and the peer's requested compression methods.
    


## RETURNS



           selected certificate compression method.
    
           Since 3.7.4
    


* * *
# probe::ioscheduler_trace.unplug_timer

## NAME



           probe::ioscheduler_trace.unplug_timer - Fires when unplug timer
           associated
    


## SYNOPSIS



           ioscheduler_trace.unplug_timer
    


## VALUES



           _name_
               Name of the probe point
    
           _rq_queue_
               request queue
    


## DESCRIPTION



           with a request queue expires.
    


* * *
# function::user_short

## NAME



           function::user_short - Retrieves a short value stored in user
           space
    


## SYNOPSIS



               user_short:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the short from
    


## DESCRIPTION



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


* * *
# cproj

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



           cproj, cprojf, cprojl — complex projection functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex cproj(double complex _z_);
           float complex cprojf(float complex _z_);
           long double complex cprojl(long double complex _z_);
    


## 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.
    
           These functions shall compute a projection of _z_ onto the Riemann
           sphere: _z_ projects to _z_ , except that all complex infinities (even
           those with one infinite part and one NaN part) project to positive
           infinity on the real axis. If _z_ has an infinite part, then
           _cproj_(_z_) shall be equivalent to:
    
               INFINITY + I * copysign(0.0, cimag(z))
    


## RETURN VALUE



           These functions shall return the value of the projection onto the
           Riemann sphere.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Two topologies are commonly used in complex mathematics: the
           complex plane with its continuum of infinities, and the Riemann
           sphere with its single infinity. The complex plane is better
           suited for transcendental functions, the Riemann sphere for
           algebraic functions. The complex types with their multiplicity of
           infinities provide a useful (though imperfect) model for the
           complex plane. The _cproj_() function helps model the Riemann sphere
           by mapping all infinities to one, and should be used just before
           any operation, especially comparisons, that might give spurious
           results for any of the other infinities. Note that a complex value
           with one infinite part and one NaN part is regarded as an
           infinity, not a NaN, because if one part is infinite, the complex
           value is infinite independent of the value of the other part. For
           the same reason, _cabs_() returns an infinity if its argument has an
           infinite part and a NaN part.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pubkey_import_ecc_raw

## NAME



           gnutls_pubkey_import_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_ecc_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The structure to store the parsed key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    


## DESCRIPTION



           This function will convert the given elliptic curve parameters to
           a **gnutls_pubkey_t**.  The output will be stored in  _key_ .
    
           In EdDSA curves the  _y_ parameter should be **NULL** and the  _x_
           parameter must be the value in the native format for the curve.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# gnutls_utf8_password_normalize

## NAME



           gnutls_utf8_password_normalize - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_utf8_password_normalize(const unsigned char ***_password_**,**
           **unsigned** _plen_**, gnutls_datum_t ***_out_**, unsigned** _flags_**);**
    


## ARGUMENTS



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


## DESCRIPTION



           This function will convert the provided UTF-8 password according
           to the normalization rules in RFC7613.
    
           If the flag **GNUTLS_UTF8_IGNORE_ERRS** is specified, any UTF-8
           encoding errors will be ignored, and in that case the output will
           be a copy of the input.
    


## RETURNS



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


## SINCE



           3.5.7
    


* * *
# dane_state_init

## NAME



           dane_state_init - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_state_init(dane_state_t ***_s_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           dane_state_t * s
                       The structure to be initialized
    
           unsigned int flags
                       flags from the **dane_state_flags** enumeration
    


## DESCRIPTION



           This function will initialize the backend resolver. It is intended
           to be used in scenarios where multiple resolvings occur, to
           optimize against multiple re-initializations.
    


## RETURNS



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


* * *
# gnutls_x509_crt_get_authority_key_id

## NAME



           gnutls_x509_crt_get_authority_key_id - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           void * id   The place where the identifier will be copied
    
           size_t * id_size
                       Holds the size of the id field.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the X.509v3 certificate authority's key
           identifier.  This is obtained by the X.509 Authority Key
           identifier extension field (2.5.29.35). Note that this function
           only returns the keyIdentifier field of the extension and
           **GNUTLS_E_X509_UNSUPPORTED_EXTENSION** , if the extension contains the
           name and serial number of the certificate. In that case
           **gnutls_x509_crt_get_authority_key_gn_serial()** may be used.
    


## RETURNS



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


* * *
# gnutls_x509_ext_export_subject_key_id

## NAME



           gnutls_x509_ext_export_subject_key_id - API function
    


## SYNOPSIS



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


## ARGUMENTS



           const gnutls_datum_t * id
                       The key identifier
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the provided key identifier to a
           DER-encoded PKIX SubjectKeyIdentifier extension.  The output data
           in  _ext_ will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# function::fp32_to_fp64

## NAME



           function::fp32_to_fp64 - Convert fp32 to 64 bit floating point
    


## SYNOPSIS



               fp32_to_fp64:long(input:long)
    


## ARGUMENTS



           _input_
               a long integer
    


## DESCRIPTION



           Convert from 32 bit floating point to a 64 bit softfloat floating
           point.
    


* * *
# gnutls_pubkey_get_key_usage

## NAME



           gnutls_pubkey_get_key_usage - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_get_key_usage(gnutls_pubkey_t** _key_**, unsigned int**
           *****_usage_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       should contain a **gnutls_pubkey_t** type
    
           unsigned int * usage
                       If set will return the number of bits of the
                       parameters (may be NULL)
    


## DESCRIPTION



           This function will return the key usage of the public key.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_idna_reverse_map

## NAME



           gnutls_idna_reverse_map - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function will convert an ACE (ASCII-encoded) domain name to a
           UTF-8 domain name.
    
           If GnuTLS is compiled without IDNA support, then this function
           will return **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    
           Note also, that this function will return an empty string if an
           empty string is provided as input.
    


## RETURNS



           A negative error code on error, or 0 on success.
    


## SINCE



           3.5.8
    


* * *
# gnutls_record_send2

## NAME



           gnutls_record_send2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_send2(gnutls_session_t** _session_**, const void ***
           _data_**, size_t** _data_size_**, size_t** _pad_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const void * data
                       contains the data to send
    
           size_t data_size
                       is the length of the data
    
           size_t pad  padding to be added to the record
    
           unsigned flags
                       must be zero
    


## DESCRIPTION



           This function is identical to **gnutls_record_send()** except that it
           takes an extra argument to specify padding to be added the record.
           To determine the maximum size of padding, use
           **gnutls_record_get_max_size()** and **gnutls_record_overhead_size()**.
    
           Note that in order for GnuTLS to provide constant time processing
           of padding and data in TLS1.3, the flag **GNUTLS_SAFE_PADDING_CHECK**
           must be used in **gnutls_init()**.
    


## RETURNS



           The number of bytes sent, or a negative error code.  The number of
           bytes sent might be less than  _data_size_ .  The maximum number of
           bytes this function can send in a single call depends on the
           negotiated maximum record size.
    


## SINCE



           3.6.3
    


* * *
# gnutls_x509_policies_deinit

## NAME



           gnutls_x509_policies_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void gnutls_x509_policies_deinit(gnutls_x509_policies_t** _policies_**);**
    


## ARGUMENTS



           gnutls_x509_policies_t policies
                       The authority key identifier
    


## DESCRIPTION



           This function will deinitialize an authority key identifier type.
    


## SINCE



           3.3.0
    


* * *
# libpfm_intel_bdx_unc_qpi

## NAME



           libpfm_intel_bdx_unc_qpi - support for Intel Broadwell Server  QPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_qpi0, bdx_unc_qpi1**
           **PMU desc: Intel Broadwell Server QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell Server QPI uncore PMU.
           This PMU model only exists on various Broadwell server models (79,
           86).
    


## MODIFIERS



           The following modifiers are supported on Broadwell server QPI
           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 QPI 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:255].
    
           **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
    


* * *
# gnutls_x509_dn_get_str

## NAME



           gnutls_x509_dn_get_str - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_get_str(gnutls_x509_dn_t** _dn_**, gnutls_datum_t ***
           _str_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       a pointer to DN
    
           gnutls_datum_t * str
                       a datum that will hold the name
    


## DESCRIPTION



           This function will allocate buffer and copy the name in the
           provided DN.  The name will be in the form "C=xxxx,O=yyyy,CN=zzzz"
           as described in RFC4514. The output string will be ASCII or UTF-8
           encoded, depending on the certificate data.
    


## RETURNS



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


## SINCE



           3.4.2
    


* * *
# csinh

## NAME



           csinh, csinhf, csinhl - complex hyperbolic sine
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex csinh(double complex** _z_**);**
           **float complex csinhf(float complex** _z_**);**
           **long double complex csinhl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex hyperbolic sine of _z_.
    
           The complex hyperbolic sine function is defined as:
    
               csinh(z) = (exp(z)-exp(-z))/2
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# iswgraph

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



           iswgraph, iswgraph_l — test for a visible wide-character code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswgraph(wint_t _wc_);
           int iswgraph_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswgraph_(): 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 _iswgraph_() and _iswgraph_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **graph** in
           the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswgraph_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswgraph_() and _iswgraph_l_() functions shall return non-zero if
           _wc_ is a wide-character code with a visible representation;
           otherwise, they shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_global_deinit

## NAME



           gnutls_global_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_deinit(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           This function deinitializes the global data, that were initialized
           using **gnutls_global_init()**.
    
           Since GnuTLS 3.3.0 this function is no longer necessary to be
           explicitly called. GnuTLS will automatically deinitialize on
           library destructor. See **gnutls_global_init()** for disabling the
           implicit initialization/deinitialization.
    


* * *
# probe::vm.kmalloc

## NAME



           probe::vm.kmalloc - Fires when kmalloc is requested
    


## SYNOPSIS



           vm.kmalloc
    


## VALUES



           _bytes_req_
               requested Bytes
    
           _gfp_flags_
               type of kmemory to allocate
    
           _name_
               name of the probe point
    
           _ptr_
               pointer to the kmemory allocated
    
           _bytes_alloc_
               allocated Bytes
    
           _caller_function_
               name of the caller function
    
           _gfp_flag_name_
               type of kmemory to allocate (in String format)
    
           _call_site_
               address of the kmemory function
    


* * *
# umad_unregister

## NAME



           umad_unregister - unregister umad agent
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_unregister(int** _portid_**, int** _agentid_**);**
    


## DESCRIPTION



           **umad_unregister()** unregisters the specified _agentid_ previously
           registered using **umad_register()** or **umad_register_oui()**.
    


## RETURN VALUE



           **umad_unregister()** returns 0 on success and negative value on error
           as follows:
            -EINVAL invalid port handle or agentid
            *       (kernel error codes)
    


* * *
# function::gettimeofday_s

## NAME



           function::gettimeofday_s - Number of seconds since UNIX epoch
    


## SYNOPSIS



               gettimeofday_s:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of seconds since the UNIX epoch.
    


* * *
# libpfm_intel_hswep_unc_pcu

## NAME



           libpfm_intel_hswep_unc_pcu - support for Intel Haswell-EP Power
           Controller Unit (PCU) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_pcu**
           **PMU desc: Intel Haswell-EP PCU uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell Power Controller Unit
           uncore PMU.  This PMU model only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell PCU 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
    
           **ff** Enable frequency band filtering. This modifier applies only
                  to the UNC_P_FREQ_BANDx_CYCLES events, where x is [0-3].
                  The modifiers expects an integer in the range [0-255]. The
                  value is interpreted as a frequency value to be multiplied
                  by 100Mhz. Thus if the value is 32, then all cycles where
                  the processor is running at 3.2GHz and more are counted.
    


## Frequency band filtering



           There are 3 events which support frequency band filtering, namely,
           UNC_P_FREQ_BAND0_CYCLES, UNC_P_FREQ_BAND1_CYCLES,
           UNC_P_FREQ_BAND2_CYCLES, UNC_P_FREQ_BAND3_CYCLES. The frequency
           filter (available via the ff modifier) is stored into a PMU shared
           register which hold all 4 possible frequency bands, one per event.
           However, the library generate the encoding for each event
           individually because it processes events one at a time. The caller
           or the underlying kernel interface may have to merge the band
           filter settings to program the filter register properly.
    


* * *
# io_uring_prep_renameat

## NAME



           io_uring_prep_renameat - prepare a renameat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <stdio.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_renameat(struct io_uring_sqe ***_sqe_**,**
                                       **int** _olddirfd_**,**
                                       **const char ***_oldpath_**,**
                                       **int** _newdirfd_**,**
                                       **const char ***_newpath_**,**
                                       **unsigned int** _flags_**);**
    
           **void io_uring_prep_rename(struct io_uring_sqe ***_sqe_**,**
                                     **const char ***_oldpath_**,**
                                     **const char ***_newpath_**);**
    


## DESCRIPTION



           The io_uring_prep_renameat(3) function prepares a renameat
           request. The submission queue entry _sqe_ is setup to use the old
           directory file descriptor pointed to by _olddirfd_ and old path
           pointed to by _oldpath_ with the new directory file descriptor
           pointed to by _newdirfd_ and the new path pointed to by _newpath_ and
           using the specified flags in _flags_.
    
           The io_uring_prep_rename(3) function prepares a rename request.
           The submission queue entry _sqe_ is setup to use the old path
           pointed to by _oldpath_ with the new path pointed to by _newpath_ ,
           both relative to the current working directory and using the
           specified flags in _flags_.
    
           These functions prepare an async renameat2(2) or rename(2)
           request. If _flags_ is zero, then this call is similar to the
           renameat(2) system call. 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).
    


* * *
# pthread_barrierattr_destroy

## 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_barrierattr_destroy, pthread_barrierattr_init — destroy
           and initialize the barrier attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_barrierattr_destroy(pthread_barrierattr_t *_attr_);
           int pthread_barrierattr_init(pthread_barrierattr_t *_attr_);
    


## DESCRIPTION



           The _pthread_barrierattr_destroy_() function shall destroy a barrier
           attributes object. A destroyed _attr_ attributes object can be
           reinitialized using _pthread_barrierattr_init_(); the results of
           otherwise referencing the object after it has been destroyed are
           undefined. An implementation may cause
           _pthread_barrierattr_destroy_() to set the object referenced by _attr_
           to an invalid value.
    
           The _pthread_barrierattr_init_() function shall initialize a barrier
           attributes object _attr_ with the default value for all of the
           attributes defined by the implementation.
    
           If _pthread_barrierattr_init_() is called specifying an already
           initialized _attr_ attributes object, the results are undefined.
    
           After a barrier attributes object has been used to initialize one
           or more barriers, any function affecting the attributes object
           (including destruction) shall not affect any previously
           initialized barrier.
    
           The behavior is undefined if the value specified by the _attr_
           argument to _pthread_barrierattr_destroy_() does not refer to an
           initialized barrier attributes object.
    


## RETURN VALUE



           If successful, the _pthread_barrierattr_destroy_() and
           _pthread_barrierattr_init_() functions shall return zero; otherwise,
           an error number shall be returned to indicate the error.
    


## ERRORS



           The _pthread_barrierattr_init_() function shall fail if:
    
           **ENOMEM** Insufficient memory exists to initialize the barrier
                  attributes object.
    
           These functions shall not return an error code of **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           If an implementation detects that the value specified by the _attr_
           argument to _pthread_barrierattr_destroy_() does not refer to an
           initialized barrier attributes object, it is recommended that the
           function should fail and report an **[EINVAL]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# form_requestname

## NAME



           **form_request_by_name** , **form_request_name** - handle printable form
           request names
    


## SYNOPSIS



           **#include <form.h>**
    
           **const char *form_request_name(int** _request_**);**
           **int form_request_by_name(const char ***_name_**);**
    


## DESCRIPTION



       **form_request_name**
           The function **form_request_name** returns the printable name of a
           form request code.
    
       **form_request_name_by_name**
           The function **form_request_by_name** searches in the name-table for a
           request with the given name and returns its request code.
           Otherwise E_NO_MATCH is returned.
    


## RETURN VALUE



           **form_request_name** returns **NULL** on error and sets **errno** to
           **E_BAD_ARGUMENT**.
    
           **form_request_by_name** returns **E_NO_MATCH** on error.  It does not set
           **errno**.
    


## NOTES



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


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# gnutls_pkcs11_token_check_mechanism

## NAME



           gnutls_pkcs11_token_check_mechanism - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **unsigned gnutls_pkcs11_token_check_mechanism(const char ***_url_**,**
           **unsigned long** _mechanism_**, void ***_ptr_**, unsigned** _psize_**, unsigned**
           _flags_**);**
    


## ARGUMENTS



           const char * url
                       should contain a PKCS 11 URL
    
           unsigned long mechanism
                       The PKCS **11** mechanism ID
    
           void * ptr  if set it should point to a CK_MECHANISM_INFO struct
    
           unsigned psize
                       the size of CK_MECHANISM_INFO struct (for safety)
    
           unsigned flags
                       must be zero
    


## DESCRIPTION



           This function will return whether a mechanism is supported by the
           given token. If the mechanism is supported and
            _ptr_ is set, it will be updated with the token information.
    


## RETURNS



           Non-zero if the mechanism is supported or zero otherwise.
    


## SINCE



           3.6.0
    


* * *
# gnutls_session_get_id

## NAME



           gnutls_session_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_get_id(gnutls_session_t** _session_**, void ***
           _session_id_**, size_t ***_session_id_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * session_id
                       is a pointer to space to hold the session id.
    
           size_t * session_id_size
                       initially should contain the maximum  _session_id_ size
                       and will be updated.
    


## DESCRIPTION



           Returns the TLS session identifier. The session ID is selected by
           the server, and in older versions of TLS was a unique identifier
           shared between client and server which was persistent across
           resumption.  In the latest version of TLS (1.3) or TLS with
           session tickets, the notion of session identifiers is undefined
           and cannot be relied for uniquely identifying sessions across
           client and server.
    
           In client side this function returns the identifier returned by
           the server, and cannot be assumed to have any relation to session
           resumption.  In server side this function is guaranteed to return
           a persistent identifier of the session since GnuTLS 3.6.4, which
           may not necessarily map into the TLS session ID value. Prior to
           that version the value could only be considered a persistent
           identifier, under TLS1.2 or earlier and when no session tickets
           were in use.
    
           The session identifier value returned is always less than
           **GNUTLS_MAX_SESSION_ID_SIZE**.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise an error
           code is returned.
    


* * *
# gnutls_anon_set_server_dh_params

## NAME



           gnutls_anon_set_server_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_anon_set_server_dh_params(gnutls_anon_server_credentials_t**
           _res_**, gnutls_dh_params_t** _dh_params_**);**
    


## ARGUMENTS



           gnutls_anon_server_credentials_t res
                       is a gnutls_anon_server_credentials_t type
    
           gnutls_dh_params_t dh_params
                       The Diffie-Hellman parameters.
    


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


## DEPRECATED



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


* * *
# sigwaitinfo

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



           sigwaitinfo — wait for queued signals
    


## SYNOPSIS



           #include <signal.h>
    
           int sigwaitinfo(const sigset_t *restrict _set_ , siginfo_t *restrict _info_);
    


## DESCRIPTION



           Refer to sigtimedwait(3p).
    


* * *
# gnutls_dh_params_cpy

## NAME



           gnutls_dh_params_cpy - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_cpy(gnutls_dh_params_t** _dst_**,**
           **gnutls_dh_params_t** _src_**);**
    


## ARGUMENTS



           gnutls_dh_params_t dst
                       Is the destination parameters, which should be
                       initialized.
    
           gnutls_dh_params_t src
                       Is the source parameters
    


## DESCRIPTION



           This function will copy the DH parameters structure from source to
           destination. The destination should be already initialized.
    


## RETURNS



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


* * *
# gnutls_record_send_early_data

## NAME



           gnutls_record_send_early_data - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_send_early_data(gnutls_session_t** _session_**,**
           **const void ***_data_**, size_t** _data_size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const void * data
                       contains the data to send
    
           size_t data_size
                       is the length of the data
    


## DESCRIPTION



           This function can be used by a client to send data early in the
           handshake processes when resuming a session.  This is used to
           implement a zero-roundtrip (0-RTT) mode.  It has the same
           semantics as **gnutls_record_send()**.
    
           There may be a limit to the amount of data sent as early data.
           Use **gnutls_record_get_max_early_data_size()** to check the limit.
           If the limit exceeds, this function returns
           **GNUTLS_E_RECORD_LIMIT_REACHED**.
    


## RETURNS



           The number of bytes sent, or a negative error code.  The number of
           bytes sent might be less than  _data_size_ .  The maximum number of
           bytes this function can send in a single call depends on the
           negotiated maximum record size.
    


## SINCE



           3.6.5
    


* * *