tripathysagar/man_text huggingface dataset:
# gnutls_x509_crq_sign

## NAME



           gnutls_x509_crq_sign - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function is the same a **gnutls_x509_crq_sign2()** with no flags,
           and an appropriate hash algorithm. The hash algorithm used may
           vary between versions of GnuTLS, and it is tied to the security
           level of the issuer's public key.
    
           A known limitation of this function is, that a newly-signed
           request will not be fully functional (e.g., for signature
           verification), until it is exported an re-imported.
    


## RETURNS



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


* * *
# gai_strerror

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



           gai_strerror — address and name information error description
    


## SYNOPSIS



           #include <netdb.h>
    
           const char *gai_strerror(int _ecode_);
    


## DESCRIPTION



           The _gai_strerror_() function shall return a text string describing
           an error value for the _getaddrinfo_() and _getnameinfo_() functions
           listed in the _< netdb.h>_ header.
    
           When the _ecode_ argument is one of the following values listed in
           the _< netdb.h>_ header:
           **[EAI_AGAIN]      [EAI_NONAME]**
           **[EAI_BADFLAGS]   [EAI_OVERFLOW]**
           **[EAI_FAIL]       [EAI_SERVICE]**
           **[EAI_FAMILY]     [EAI_SOCKTYPE]**
           **[EAI_MEMORY]     [EAI_SYSTEM]**
    
           the function return value shall point to a string describing the
           error.  If the argument is not one of those values, the function
           shall return a pointer to a string whose contents indicate an
           unknown error.
    


## RETURN VALUE



           Upon successful completion, _gai_strerror_() shall return a pointer
           to an implementation-defined string.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# posix_spawnattr_setschedparam

## PROLOG



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


## NAME



           posix_spawnattr_setschedparam — set the spawn-schedparam attribute
           of a spawn attributes object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <sched.h>
           #include <spawn.h>
    
           int posix_spawnattr_setschedparam(posix_spawnattr_t *restrict _attr_ ,
               const struct sched_param *restrict _schedparam_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getschedparam(3p).
    


* * *
# sd_journal_get_catalog

## NAME



           sd_journal_get_catalog, sd_journal_get_catalog_for_message_id -
           Retrieve message catalog entry
    


## SYNOPSIS



           **#include <systemd/sd-journal.h>**
    
           **int sd_journal_get_catalog(sd_journal ***_j_**, char ****_ret_**);**
    
           **int sd_journal_get_catalog_for_message_id(sd_id128_t** _id_**,**
                                                     **char ****_ret_**);**
    


## DESCRIPTION



           **sd_journal_get_catalog()** retrieves a message catalog entry for the
           current journal entry. This will look up an entry in the message
           catalog by using the "MESSAGE_ID=" field of the current journal
           entry. Before returning the entry all journal field names in the
           catalog entry text enclosed in "@" will be replaced by the
           respective field values of the current entry. If a field name
           referenced in the message catalog entry does not exist, in the
           current journal entry, the "@" will be removed, but the field name
           otherwise left untouched.
    
           **sd_journal_get_catalog_for_message_id()** works similar to
           **sd_journal_get_catalog()** but the entry is looked up by the
           specified message ID (no open journal context is necessary for
           this), and no field substitution is performed.
    
           For more information about the journal message catalog please
           refer to the **Journal Message Catalogs******[1] documentation page.


## RETURN VALUE



           **sd_journal_get_catalog()** and
           **sd_journal_get_catalog_for_message_id()** return 0 on success or a
           negative errno-style error code. If no matching message catalog
           entry is found, -ENOENT is returned.
    
           On successful return, _ret_ points to a new string, which must be
           freed with free(3).
    


## NOTES



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


## NOTES



            1. Journal Message Catalogs
               https://systemd.io/CATALOG
    


* * *
# gnutls_pkcs_schema_get_oid

## NAME



           gnutls_pkcs_schema_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **const char * gnutls_pkcs_schema_get_oid(unsigned int** _schema_**);**
    


## ARGUMENTS



           unsigned int schema
                       Holds the PKCS **12** or PBES2 schema
                       (**gnutls_pkcs_encrypt_flags_t**)
    


## DESCRIPTION



           This function will return the object identifier of the PKCS12 or
           PBES2 schema.
    


## RETURNS



           a constraint string or **NULL** on error.
    


## SINCE



           3.4.0
    


* * *
# libpfm_arm_monaka

## NAME



           libpfm_arm_monaka - support for Fujitsu FUJITSU-MONAKA PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_monaka**
           **PMU desc: Fujitsu FUJITSU-MONAKA**
    


## DESCRIPTION



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


## MODIFIERS



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


* * *
# assert_perror

## NAME



           assert_perror - test errnum and abort
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <assert.h>**
    
           **void assert_perror(int** _errnum_**);**
    


## DESCRIPTION



           If the macro **NDEBUG** was defined at the moment _< assert.h>_ was last
           included, the macro **assert_perror**() generates no code, and hence
           does nothing at all.  Otherwise, the macro **assert_perror**() prints
           an error message to standard error and terminates the program by
           calling abort(3) if _errnum_ is nonzero.  The message contains the
           filename, function name and line number of the macro call, and the
           output of _strerror(errnum)_.
    


## RETURN VALUE



           No value is returned.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## BUGS



           The purpose of the assert macros is to help programmers find bugs
           in their programs, things that cannot happen unless there was a
           coding mistake.  However, with system or library calls the
           situation is rather different, and error returns can happen, and
           will happen, and should be tested for.  Not by an assert, where
           the test goes away when **NDEBUG** is defined, but by proper error
           handling code.  Never use this macro.
    


* * *
# gnutls_memset

## NAME



           gnutls_memset - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_memset(void ***_data_**, int** _c_**, size_t** _size_**);**
    


## ARGUMENTS



           void * data the memory to set
    
           int c       the constant byte to fill the memory with
    
           size_t size the size of memory
    


## DESCRIPTION



           This function will operate similarly to **memset()** , but will not be
           optimized out by the compiler.
    


## SINCE



           3.4.0
    


* * *
# gnutls_x509_name_constraints_check_crt

## NAME



           gnutls_x509_name_constraints_check_crt - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned**
           **gnutls_x509_name_constraints_check_crt(gnutls_x509_name_constraints_t**
           _nc_**, gnutls_x509_subject_alt_name_t** _type_**, gnutls_x509_crt_t** _cert_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t nc
                       the extracted name constraints
    
           gnutls_x509_subject_alt_name_t type
                       the type of the constraint to check (of type
                       gnutls_x509_subject_alt_name_t)
    
           gnutls_x509_crt_t cert
                       the certificate to be checked
    


## DESCRIPTION



           This function will check the provided certificate names against
           the constraints in
            _nc_ using the RFC5280 rules. It will traverse all the
           certificate's names and alternative names.
    
           Currently this function is limited to DNS names and emails (of
           type **GNUTLS_SAN_DNSNAME** and **GNUTLS_SAN_RFC822NAME**).
    


## RETURNS



           zero if the provided name is not acceptable, and non-zero
           otherwise.
    


## SINCE



           3.3.0
    


* * *
# posix_trace_flush

## PROLOG



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


## NAME



           posix_trace_flush — trace stream flush from a process (**TRACING**)
    


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_flush(trace_id_t _trid_);
    


## DESCRIPTION



           Refer to posix_trace_create(3p).
    


* * *
# pcap_datalink_val_to_name

## NAME



           pcap_datalink_val_to_name, pcap_datalink_val_to_description,
           pcap_datalink_val_to_description_or_dlt - get a name or
           description for a link-layer header type value
    


## SYNOPSIS



           **#include <pcap.h>**
    
           **const char *pcap_datalink_val_to_name(int dlt);**
           **const char *pcap_datalink_val_to_description(int dlt);**
           **const char *pcap_datalink_val_to_description_or_dlt(int dlt);**
    


## DESCRIPTION



           **pcap_datalink_val_to_name**() translates a link-layer header type
           value to the corresponding link-layer header type name, which is
           the **DLT_** name for the link-layer header type value with the **DLT_**
           removed.  **NULL** is returned if the type value does not correspond
           to a known **DLT_** value.
    
           **pcap_datalink_val_to_description**() translates a link-layer header
           type value to a short description of that link-layer header type.
           **NULL** is returned if the type value does not correspond to a known
           **DLT_** value.
    
           **pcap_datalink_val_to_description_or_dlt**() translates a link-layer
           header type value to a short description of that link-layer header
           type just like **pcap_datalink_val_to_description**().  If the type
           value does not correspond to a known **DLT_** value, the string "DLT
           n" is returned, where n is the value of the dlt argument.
    


## BACKWARD COMPATIBILITY



           The **pcap_datalink_val_to_description_or_dlt**() function first
           became available in libpcap release 1.9.1.  In previous releases,
           **pcap_datalink_val_to_description**() would have to be called and, if
           it returned **NULL** , a default string would have to be constructed.
    


* * *
# gnutls_encode_ber_digest_info

## NAME



           gnutls_encode_ber_digest_info - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_encode_ber_digest_info(gnutls_digest_algorithm_t** _hash_**,**
           **const gnutls_datum_t ***_digest_**, gnutls_datum_t ***_output_**);**
    


## ARGUMENTS



           gnutls_digest_algorithm_t hash
                       the hash algorithm that was used to get the digest
    
           const gnutls_datum_t * digest
                       must contain the digest data
    
           gnutls_datum_t * output
                       will contain the allocated DigestInfo BER encoded data
    


## DESCRIPTION



           This function will encode the provided digest data, and its
           algorithm into an RSA PKCS**1** 1.5 DigestInfo structure.
    


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# gnutls_x509_ext_ct_export_scts

## NAME



           gnutls_x509_ext_ct_export_scts - API function
    


## SYNOPSIS



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


## ARGUMENTS



           const gnutls_x509_ct_scts_t scts
                       An initialized SCT list
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed with
                       **gnutls_free()**
    


## DESCRIPTION



           This function will convert the provided list of SCTs to a
           DER-encoded SignedCertificateTimestampList extension
           (1.3.6.1.4.1.11129.2.4.2).  The output data in  _ext_ will be
           allocated using **gnutls_malloc()**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error value.
    


* * *
# gnutls_pubkey_import_pkcs11

## NAME



           gnutls_pubkey_import_pkcs11 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_pkcs11(gnutls_pubkey_t** _key_**,**
           **gnutls_pkcs11_obj_t** _obj_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key
    
           gnutls_pkcs11_obj_t obj
                       The parameters to be imported
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           Imports a public key from a pkcs11 key. This function will import
           the given public key to the abstract **gnutls_pubkey_t** type.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_x509_crq_get_dn3

## NAME



           gnutls_x509_crq_get_dn3 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_dn3(gnutls_x509_crq_t** _crq_**, gnutls_datum_t**
           *****_dn_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    
           unsigned flags
                       zero or **GNUTLS_X509_DN_FLAG_COMPAT**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of the
           Certificate request. 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.
    
           When the flag **GNUTLS_X509_DN_FLAG_COMPAT** is specified, the output
           format will match the format output by previous to 3.5.6 versions
           of GnuTLS which was not not fully RFC4514-compliant.
    


## RETURNS



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


## SINCE



           3.5.7
    


* * *
# gnutls_oid_to_gost_paramset

## NAME



           gnutls_oid_to_gost_paramset - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_gost_paramset_t gnutls_oid_to_gost_paramset(const char ***
           _oid_**);**
    


## ARGUMENTS



           const char * oid
                       is an object identifier
    


## DESCRIPTION



           Converts a textual object identifier to a **gnutls_gost_paramset_t**
           value.
    


## RETURNS



           a **gnutls_gost_paramset_get_oid** of the specified GOST 28147 param
           st, or **GNUTLS_GOST_PARAMSET_UNKNOWN** on failure.
    


## SINCE



           3.6.3
    


* * *
# io_uring_prep_linkat

## NAME



           io_uring_prep_linkat - prepare a linkat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_linkat(struct io_uring_sqe ***_sqe_**,**
                                     **int** _olddirfd_**,**
                                     **const char ***_oldpath_**,**
                                     **int** _newdirfd_**,**
                                     **const char ***_newpath_**,**
                                     **int** _flags_**);**
    
           **void io_uring_prep_link(struct io_uring_sqe ***_sqe_**,**
                                   **const char ***_oldpath_**,**
                                   **const char ***_newpath_**,**
                                   **int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_linkat(3) function prepares a linkat 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_link(3) function prepares a link request. The
           submission queue entry _sqe_ is setup to use the old path pointed to
           by _oldpath_ and 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 linkat(2) or link(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).
    


* * *
# gnutls_pkcs7_set_crl_raw

## NAME



           gnutls_pkcs7_set_crl_raw - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_set_crl_raw(gnutls_pkcs7_t** _pkcs7_**, const**
           **gnutls_datum_t ***_crl_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           const gnutls_datum_t * crl
                       the DER encoded crl to be added
    


## DESCRIPTION



           This function will add a crl to the PKCS7 or RFC2630 crl set.
    


## RETURNS



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


* * *
# gnutls_x509_othername_to_virtual

## NAME



           gnutls_x509_othername_to_virtual - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_othername_to_virtual(const char ***_oid_**, const**
           **gnutls_datum_t ***_othername_**, unsigned int ***_virt_type_**,**
           **gnutls_datum_t ***_virt_**);**
    


## ARGUMENTS



           const char * oid
                       The othername object identifier
    
           const gnutls_datum_t * othername
                       The othername data
    
           unsigned int * virt_type
                       GNUTLS_SAN_OTHERNAME_XXX
    
           gnutls_datum_t * virt
                       allocated printable data
    


## DESCRIPTION



           This function will parse and convert the othername data to a
           virtual type supported by gnutls.
    


## RETURNS



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


## SINCE



           3.3.8
    


* * *
# function::inet_get_dest_port

## NAME



           function::inet_get_dest_port - Provide remote port number for a
           kernel socket
    


## SYNOPSIS



               inet_get_dest_port:long(sock:long)
    


## ARGUMENTS



           _sock_
               pointer to the kernel socket
    


* * *
# gnutls_pkcs12_get_bag

## NAME



           gnutls_pkcs12_get_bag - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_get_bag(gnutls_pkcs12_t** _pkcs12_**, int** _indx_**,**
           **gnutls_pkcs12_bag_t** _bag_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           int indx    contains the index of the bag to extract
    
           gnutls_pkcs12_bag_t bag
                       An initialized bag, where the contents of the bag will
                       be copied
    


## DESCRIPTION



           This function will return a Bag from the PKCS12 structure.
    
           After the last Bag has been read
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## RETURNS



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


* * *
# probe::scheduler.process_wait

## NAME



           probe::scheduler.process_wait - Scheduler starting to wait on a
           process
    


## SYNOPSIS



           scheduler.process_wait
    


## VALUES



           _name_
               name of the probe point
    
           _pid_
               PID of the process scheduler is waiting on
    


* * *
# probe::stap.pass2

## NAME



           probe::stap.pass2 - Starting stap pass2 (elaboration)
    


## SYNOPSIS



           stap.pass2
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass2 fires just after the call to **gettimeofday** , just before the
           call to semantic_pass.
    


* * *
# gnutls_x509_rdn_get

## NAME



           gnutls_x509_rdn_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_rdn_get(const gnutls_datum_t ***_idn_**, char ***_buf_**,**
           **size_t ***_buf_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * idn
                       should contain a DER encoded RDN sequence
    
           char * buf  a pointer to a structure to hold the peer's name
    
           size_t * buf_size
                       holds the size of  _buf_
    


## DESCRIPTION



           This function will return the name of the given RDN sequence.  The
           name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in
           RFC4514.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_x509_rdn_get2()**.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, or
           **GNUTLS_E_SHORT_MEMORY_BUFFER** is returned and * _buf_size_ is updated
           if the provided buffer is not long enough, otherwise a negative
           error value.
    


* * *
# gnutls_x509_privkey_export_ecc_raw

## NAME



           gnutls_x509_privkey_export_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export_ecc_raw(gnutls_x509_privkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_datum_t ***_x_**, gnutls_datum_t ***
           _y_**, gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    
           gnutls_datum_t * k
                       will hold the private key
    


## DESCRIPTION



           This function will export the ECC private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be 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_pkcs12_verify_mac

## NAME



           gnutls_pkcs12_verify_mac - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_verify_mac(gnutls_pkcs12_t** _pkcs12_**, const char ***
           _pass_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       should contain a gnutls_pkcs12_t type
    
           const char * pass
                       The password for the MAC
    


## DESCRIPTION



           This function will verify the MAC for the PKCS12 structure.
    


## RETURNS



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


* * *
# dane_match_type_name

## NAME



           dane_match_type_name - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **const char * dane_match_type_name(dane_match_type_t** _type_**);**
    


## ARGUMENTS



           dane_match_type_t type
                       is a DANE match type
    


## DESCRIPTION



           Convert a **dane_match_type_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified type, or **NULL**.
    


* * *
# fma

## NAME



           fma, fmaf, fmal - floating-point multiply and add
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double fma(double** _x_**, double** _y_**, double** _z_**);**
           **float fmaf(float** _x_**, float** _y_**, float** _z_**);**
           **long double fmal(long double** _x_**, long double** _y_**, long double** _z_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fma**(), **fmaf**(), **fmal**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions compute _x_ * _y_ + _z_.  The result is rounded as one
           ternary operation according to the current rounding mode (see
           fenv(3)).
    


## RETURN VALUE



           These functions return the value of _x_ * _y_ + _z_ , rounded as one
           ternary operation.
    
           If _x_ or _y_ is a NaN, a NaN is returned.
    
           If _x_ times _y_ is an exact infinity, and _z_ is an infinity with the
           opposite sign, a domain error occurs, and a NaN is returned.
    
           If one of _x_ or _y_ is an infinity, the other is 0, and _z_ is not a
           NaN, a domain error occurs, and a NaN is returned.
    
           If one of _x_ or _y_ is an infinity, and the other is 0, and _z_ is a
           NaN, a domain error occurs, and a NaN is returned.
    
           If _x_ times _y_ is not an infinity times zero (or vice versa), and _z_
           is a NaN, a NaN is returned.
    
           If the result overflows, a range error occurs, and an infinity
           with the correct sign is returned.
    
           If the result underflows, a range error occurs, and a signed 0 is
           returned.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x * y + z_ , or _x * y_ is invalid and _z_ is not a NaN
                  An invalid floating-point exception (**FE_INVALID**) is raised.
    
           Range error: result overflow
                  An overflow floating-point exception (**FE_OVERFLOW**) is
                  raised.
    
           Range error: result underflow
                  An underflow floating-point exception (**FE_UNDERFLOW**) is
                  raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_pkcs11_privkey_deinit

## NAME



           gnutls_pkcs11_privkey_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void gnutls_pkcs11_privkey_deinit(gnutls_pkcs11_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t key
                       the key to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a private key structure.
    


* * *
# tep_strerror

## NAME



           tep_strerror - Returns a string describing regular errno and tep
           error number.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           int **tep_strerror**(struct tep_handle *_tep_ , enum tep_errno _errnum_ , char *_buf_ , size_t _buflen_);
    


## DESCRIPTION



           The **tep_strerror()** function converts tep error number into a human
           readable string. The _tep_ argument is trace event parser context.
           The _errnum_ is a regular errno, defined in errno.h, or a tep error
           number. The string, describing this error number is copied in the
           _buf_ argument. The _buflen_ argument is the size of the _buf_.
    
           It as a thread safe wrapper around strerror_r(). The library
           function has two different behaviors - POSIX and GNU specific. The
           **tep_strerror()** API always behaves as the POSIX version - the error
           string is copied in the user supplied buffer.
    


## RETURN VALUE



           The **tep_strerror()** function returns 0, if a valid _errnum_ is passed
           and the string is copied into _buf_. If _errnum_ is not a valid error
           number, -1 is returned and _buf_ is not modified.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               char buf[32];
               char *pool = calloc(1, 128);
               if (tep == NULL) {
                       tep_strerror(tep, TEP_ERRNO__MEM_ALLOC_FAILED, buf, 32);
                       printf ("The pool is not initialized, %s", buf);
               }
               ...
    


## FILES



               **event-parse.h**
                       Header file to include in order to have access to the library APIs.
               **-ltraceevent**
                       Linker switch to add when building a program that uses the library.
    


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



           **https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ **
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    
            2. tz.stoyanov@gmail.com
               mailto:tz.stoyanov@gmail.com
    
            3. linux-trace-devel@vger.kernel.org
               mailto:linux-trace-devel@vger.kernel.org
    


* * *
# sd_bus_set_sender

## NAME



           sd_bus_set_sender, sd_bus_get_sender - Configure default sender
           for outgoing messages
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_set_sender(sd_bus ***_bus_**, const char***_name_**);**
    
           **int sd_bus_get_sender(sd_bus ***_bus_**, const char****_name_**);**
    


## DESCRIPTION



           **sd_bus_set_sender()** configures the default sender service name to
           use for outgoing messages. The service name specified in the _name_
           parameter is set on all outgoing messages that are sent on the
           connection and have no sender set yet, for example through
           sd_bus_message_set_sender(3). Note that this function is only
           supported on direct connections, i.e. not on connections to a bus
           broker as the broker will fill in the sender service name
           automatically anyway. By default, no sender name is configured,
           and hence messages are sent without sender field set. If the _name_
           parameter is specified as **NULL** the default sender service name is
           cleared, returning to the default state if a default sender
           service name was set before. If passed as non-**NULL** the specified
           name must be a valid unique or well-known service name.
    
           **sd_bus_get_sender()** may be used to query the current default
           service name for outgoing messages.
    


## RETURN VALUE



           On success, these functions return 0 or a positive integer. On
           failure, they return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ECHILD**
               The bus connection has been created in a different process,
               library or module instance.
    
           **-EPERM**
               The specified bus connection object is a not a direct but a
               brokered connection.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# io_uring_wait_cqe_nr

## NAME



           io_uring_wait_cqe_nr - wait for one or more io_uring completion
           events
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_wait_cqe_nr(struct io_uring ***_ring_**,**
                                    **struct io_uring_cqe ****_cqe_ptr_**,**
                                    **unsigned** _wait_nr_**);**
    


## DESCRIPTION



           The io_uring_wait_cqe_nr(3) function returns _wait_nr_ IO completion
           events from the queue belonging to the _ring_ param, waiting for it
           if necessary. If the requested number of events are already
           available in the ring when invoked, no waiting will occur. The
           _cqe_ptr_ param is filled in on success.
    
           After the caller has submitted a request with io_uring_submit(3),
           the application can retrieve the completion with
           io_uring_wait_cqe(3).
    
           Ideally used with a ring setup with
           **IORING_SETUP_SINGLE_ISSUER** |**IORING_SETUP_DEFER_TASKRUN** as that will
           greatly reduce the number of context switches that an application
           will see waiting on multiple requests.
    


## RETURN VALUE



           On success io_uring_wait_cqe_nr(3) returns 0 and the cqe_ptr param
           is filled in. On failure it returns **-errno**.  The return value
           indicates the result of waiting for a CQE, and it has no relation
           to the CQE result itself.
    


* * *
# mktemp

## NAME



           mktemp - make a unique temporary filename
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **char *mktemp(char ***_template_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **mktemp**():
               Since glibc 2.12:
                   (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200112L)
                       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                       || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
               Before glibc 2.12:
                   _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500
    


## DESCRIPTION



           _Never use this function_ ; see BUGS.
    
           The **mktemp**() function generates a unique temporary filename from
           _template_.  The last six characters of _template_ must be XXXXXX and
           these are replaced with a string that makes the filename unique.
           Since it will be modified, _template_ must not be a string constant,
           but should be declared as a character array.
    


## RETURN VALUE



           The **mktemp**() function always returns _template_.  If a unique name
           was created, the last six bytes of _template_ will have been
           modified in such a way that the resulting name is unique (i.e.,
           does not exist already) If a unique name could not be created,
           _template_ is made an empty string, and _errno_ is set to indicate the
           error.
    


## ERRORS



           **EINVAL** The last six characters of _template_ were not XXXXXX.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## BUGS



           Never use **mktemp**().  Some implementations follow 4.3BSD and
           replace XXXXXX by the current process ID and a single letter, so
           that at most 26 different names can be returned.  Since on the one
           hand the names are easy to guess, and on the other hand there is a
           race between testing whether the name exists and opening the file,
           every use of **mktemp**() is a security risk.  The race is avoided by
           mkstemp(3) and mkdtemp(3).
    


* * *
# capng_apply_caps_fd

## NAME



           capng_apply_caps_fd - write file-based capabilities to extended
           attributes
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_apply_caps_fd(int fd);
    


## DESCRIPTION



           This function will write the file based capabilities to the
           extended attributes of the file that the descriptor was opened
           against. The bounding set is not included in file based
           capabilities operations. Note that this function will only work if
           compiled on a kernel that supports file based capabilities such as
           2.6.2 6 and later.
    


## RETURN VALUE



           This returns 0 on success, -1 if something besides a regular file
           is passed, and -2 if a non-root namespace id is being used for
           rootid.
    


* * *
# libpfm_intel_bdx_unc_ha

## NAME



           libpfm_intel_bdx_unc_ha - support for Intel Broadwell Server Home
           Agent (HA) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_ha0, bdx_unc_ha1**
           **PMU desc: Intel Broadwell Server HA uncore PMU**
    


## DESCRIPTION



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


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server HA
           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: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
    


* * *
# probe::stap.pass4

## NAME



           probe::stap.pass4 - Starting stap pass4 (compile C code into
           kernel module)
    


## SYNOPSIS



           stap.pass4
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass4 fires just after the call to **gettimeofday** , just before the
           call to compile_pass.
    


* * *
# function::get_sa_flags

## NAME



           function::get_sa_flags - Returns the numeric value of sa_flags
    


## SYNOPSIS



               get_sa_flags:long(act:long)
    


## ARGUMENTS



           _act_
               address of the sigaction to query.
    


* * *
# function::print_usyms

## NAME



           function::print_usyms - Print out user stack from string
    


## SYNOPSIS



               print_usyms(callers:string)
    


## ARGUMENTS



           _callers_
               String with list of hexadecimal (user) addresses
    


## DESCRIPTION



           This function performs a symbolic lookup of the addresses in the
           given string, which are assumed to be the result of prior calls to
           **ustack** , **ucallers** , and similar functions.
    
           Prints one line per address, including the address, the name of
           the function containing the address, and an estimate of its
           position within that function, as obtained by **usymdata**. Returns
           nothing.
    


* * *