tripathysagar/man_text huggingface dataset:
# posix_spawnattr_getschedpolicy

## 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_getschedpolicy, posix_spawnattr_setschedpolicy —
           get and set the spawn-schedpolicy attribute of a spawn attributes
           object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
           #include <sched.h>
    
           int posix_spawnattr_getschedpolicy(const posix_spawnattr_t
               *restrict _attr_ , int *restrict _schedpolicy_);
           int posix_spawnattr_setschedpolicy(posix_spawnattr_t *_attr_ ,
               int _schedpolicy_);
    


## DESCRIPTION



           The _posix_spawnattr_getschedpolicy_() function shall obtain the
           value of the _spawn-schedpolicy_ attribute from the attributes
           object referenced by _attr_.
    
           The _posix_spawnattr_setschedpolicy_() function shall set the _spawn-_
           _schedpolicy_ attribute in an initialized attributes object
           referenced by _attr_.
    
           The _spawn-schedpolicy_ attribute represents the scheduling policy
           to be assigned to the new process image in a spawn operation (if
           POSIX_SPAWN_SETSCHEDULER is set in the _spawn-flags_ attribute). The
           default value of this attribute is unspecified.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getschedpolicy_() shall
           return zero and store the value of the _spawn-schedpolicy_ attribute
           of _attr_ into the object referenced by the _schedpolicy_ parameter;
           otherwise, an error number shall be returned to indicate the
           error.
    
           Upon successful completion, _posix_spawnattr_setschedpolicy_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setschedpolicy_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn and Process Scheduling
           options and need not be provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_ocsp_req_set_nonce

## NAME



           gnutls_ocsp_req_set_nonce - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_set_nonce(gnutls_ocsp_req_t** _req_**, unsigned int**
           _critical_**, const gnutls_datum_t ***_nonce_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           unsigned int critical
                       critical flag, normally false.
    
           const gnutls_datum_t * nonce
                       the nonce data
    


## DESCRIPTION



           This function will add an nonce extension to the OCSP request.
           Calling this function multiple times will overwrite values from
           earlier calls.
    


## RETURNS



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


* * *
# gnutls_session_is_resumed

## NAME



           gnutls_session_is_resumed - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_is_resumed(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Checks whether session is resumed or not. This is functional for
           both server and client side.
    


## RETURNS



           non zero if this session is resumed, or a zero if this is a new
           session.
    


* * *
# fputws

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



           fputws — put a wide-character string on a stream
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           int fputws(const wchar_t *restrict _ws_ , FILE *restrict _stream_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _fputws_() function shall write a character string corresponding
           to the (null-terminated) wide-character string pointed to by _ws_ to
           the stream pointed to by _stream_.  No character corresponding to
           the terminating null wide-character code shall be written.
    
           The last data modification and last file status change timestamps
           of the file shall be marked for update between the successful
           execution of _fputws_() and the next successful completion of a call
           to _fflush_() or _fclose_() on the same stream or a call to _exit_() or
           _abort_().
    


## RETURN VALUE



           Upon successful completion, _fputws_() shall return a non-negative
           number. Otherwise, it shall return -1, set an error indicator for
           the stream, and set _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _fputws_() function does not append a <newline>.
    
           This volume of POSIX.1‐2017 requires that successful completion
           simply return a non-negative integer. There are at least three
           known different implementation conventions for this requirement:
    
            *  Return a constant value.
    
            *  Return the last character written.
    
            *  Return the number of bytes written. Note that this
               implementation convention cannot be adhered to for strings
               longer than {INT_MAX} bytes as the value would not be
               representable in the return type of the function. For
               backwards-compatibility, implementations can return the number
               of bytes for strings of up to {INT_MAX} bytes, and return
               {INT_MAX} for all longer strings.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::ubacktrace

## NAME



           function::ubacktrace - Hex backtrace of current user-space task
           stack.
    


## SYNOPSIS



               ubacktrace:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Return a string of hex addresses that are a backtrace of the stack
           of the current task. Output may be truncated as per maximum string
           length. Returns empty string when current probe point cannot
           determine user backtrace. See **backtrace** for kernel traceback.
    


## NOTE



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


* * *
# udev_monitor_new_from_netlink

## NAME



           udev_monitor_new_from_netlink, udev_monitor_ref,
           udev_monitor_unref - Create, acquire and release a udev monitor
           object
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **struct udev_monitor**
                                                              ***udev_monitor_new_from_netlink(struct udev ***_udev_**,**
                                                              **const char ***_name_**);**
    
           **struct udev_monitor**
                                                 ***udev_monitor_ref(struct udev_monitor ***_udev_monitor_**);**
    
           **struct udev_monitor**
                                                   ***udev_monitor_unref(struct udev_monitor ***_udev_monitor_**);**
    


## RETURN VALUE



           On success, **udev_monitor_new_from_netlink()** returns a pointer to
           the allocated udev monitor. On failure, **NULL** is returned.
           **udev_monitor_ref()** returns the argument that it was passed,
           unmodified.  **udev_monitor_unref()** always returns **NULL**.
    


* * *
# keyctl_restrict_keyring

## NAME



           keyctl_restrict_keyring - restrict keys that may be linked to a
           keyring
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_restrict_keyring(key_serial_t** _keyring_**,**
           **const char ***_type_**, const char ***_restriction_**);**
    


## DESCRIPTION



           **keyctl_restrict_keyring**() limits the linkage of keys to the given
           _keyring_ using a provided key _type_ and _restriction_ scheme. The
           available options vary depending on the key type, and typically
           contain a restriction name possibly followed by key ids or other
           data relevant to the restriction. If the type and restriction are
           both **NULL,** the keyring will reject all links.
    


## RETURN VALUE



           On success **keyctl_restrict_keyring**() returns **0**.  On error, the
           value **-1** will be returned and _errno_ will have been set to an
           appropriate error.
    


## ERRORS



           **EDEADLK**
                  A restriction cycle was avoided. Two keyrings cannot
                  restrict each other.
    
           **EEXIST** The keyring is already restricted.
    
           **EINVAL** The restriction string is invalid or too large.
    
           **ENOKEY** The key type in the restriction is invalid or not
                  available.
    
           **ENOTDIR**
                  The provided key id references an item that is not a
                  keyring.
    
           **ENOENT** The key type exists but does not support restrictions.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# rdma_get_recv_comp

## NAME



           rdma_get_recv_comp - retrieves a completed receive request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_get_recv_comp (struct rdma_cm_id ***_id_**, struct ibv_wc ***_wc_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier to check for
                       completions.
    
           wc          A reference to a work completion structure to fill in.
    


## DESCRIPTION



           Retrieves a completed work request for a receive operation.
           Information about the completed request is returned through the wc
           parameter, with the wr_id set to the context of the request.  For
           details on the work completion structure, see ibv_poll_cq.
    


## RETURN VALUE



           Returns the number of returned completions (0 or 1) on success, or
           -1 on error.  If an error occurs, errno will be set to indicate
           the failure reason.
    


## NOTES



           This calls polls the receive completion queue associated with an
           rdma_cm_id.  If a completion is not found, the call blocks until a
           request completes.  This call should only be used on rdma_cm_id's
           that do not share CQs with other rdma_cm_id's, and maintain
           separate CQs for sends and receive completions.
    


* * *
# gnutls_tpm_privkey_generate

## NAME



           gnutls_tpm_privkey_generate - API function
    


## SYNOPSIS



           **#include <gnutls/tpm.h>**
    
           **int gnutls_tpm_privkey_generate(gnutls_pk_algorithm_t** _pk_**, unsigned**
           **int** _bits_**, const char ***_srk_password_**, const char ***_key_password_**,**
           **gnutls_tpmkey_fmt_t** _format_**, gnutls_x509_crt_fmt_t** _pub_format_**,**
           **gnutls_datum_t ***_privkey_**, gnutls_datum_t ***_pubkey_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t pk
                       the public key algorithm
    
           unsigned int bits
                       the security bits
    
           const char * srk_password
                       a password to protect the exported key (optional)
    
           const char * key_password
                       the password for the TPM (optional)
    
           gnutls_tpmkey_fmt_t format
                       the format of the private key
    
           gnutls_x509_crt_fmt_t pub_format
                       the format of the public key
    
           gnutls_datum_t * privkey
                       the generated key
    
           gnutls_datum_t * pubkey
                       the corresponding public key (may be null)
    
           unsigned int flags
                       should be a list of GNUTLS_TPM_* flags
    


## DESCRIPTION



           This function will generate a private key in the TPM chip. The
           private key will be generated within the chip and will be exported
           in a wrapped with TPM's master key form. Furthermore the wrapped
           key can be protected with the provided  _password_ .
    
           Note that bits in TPM is quantized value. If the input value is
           not one of the allowed values, then it will be quantized to one of
           512, 1024, 2048, 4096, 8192 and 16384.
    
           Allowed flags are:
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# procio

## NAME



           fprocopen - stream open functions on files below /proc/##
    


## SYNOPSIS



           **#define _GNU_SOURCE**
           **#include <stdio.h>**
           **#include <proc/procio.h>**
    
           **FILE *fprocopen(const char ***_path_**, const char ***_mode_**);**
    


## DESCRIPTION



           The **fprocopen** function opens files below _/proc/##_ whose name is
           the string to by path and associates a stream with it.  The
           argument _mode_ points to a string containing one of the following
           sequences
    
           **r** Open a file below _/proc/##_ for reading even large buffers.
                  The stream is positioned at the beginning of the file.
    
           **w**[**< del>**]
                  Open a file below _/proc/##_ for writing even large buffers.
                  The optional delimiter character can be one of the
                  follwoing **' '** , **','** , **'.'** , and **':'** where the default is the
                  comma **','**.  This allows to split very large input lines
                  into pieces at this delimiter and write each of them to the
                  opened file below _/proc/##_.
    
           **e** The underlying file descriptor will be closed if you use
                  any of the ‘exec...’ functions within your code.
    
           The internal API allows the use of stdio functions to read and
           write large buffers below _/proc/##_.
    


* * *
# probe::socket.receive

## NAME



           probe::socket.receive - Message received on a socket.
    


## SYNOPSIS



           socket.receive
    


## VALUES



           _flags_
               Socket flags value
    
           _protocol_
               Protocol value
    
           _name_
               Name of this probe
    
           _size_
               Size of message received (in bytes) or error code if success =
               0
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _family_
               Protocol family value
    
           _success_
               Was send successful? (1 = yes, 0 = no)
    


## CONTEXT



           The message receiver
    


* * *
# pcre2_set_match_limit

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_match_limit(pcre2_match_context ***_mcontext_**,**
             **uint32_t** _value_**);**
    


## DESCRIPTION



    
           This function sets the match limit field in a match context. The
           result is always zero.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_gost_paramset_get_oid

## NAME



           gnutls_gost_paramset_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_gost_paramset_get_oid(gnutls_gost_paramset_t**
           _param_**);**
    


## ARGUMENTS



           gnutls_gost_paramset_t param
                       is a GOST 28147 param set
    


## DESCRIPTION



           Convert a **gnutls_gost_paramset_t** value to its object identifier.
    


## RETURNS



           a string that contains the object identifier of the specified GOST
           param set, or **NULL**.
    


## SINCE



           3.6.3
    


* * *
# gnutls_pkcs11_privkey_init

## NAME



           gnutls_pkcs11_privkey_init - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_init(gnutls_pkcs11_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t * key
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize an private key structure. This
           structure can be used for accessing an underlying PKCS**11** object.
    
           In versions of GnuTLS later than 3.5.11 the object is protected
           using locks and a single **gnutls_pkcs11_privkey_t** can be re-used by
           many threads. However, for performance it is recommended to
           utilize one object per key per thread.
    


## RETURNS



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


* * *
# exp

## NAME



           exp, expf, expl - base-e exponential function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double exp(double** _x_**);**
           **float expf(float** _x_**);**
           **long double expl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **expf**(), **expl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return the value of e (the base of natural
           logarithms) raised to the power of _x_.
    


## RETURN VALUE



           On success, these functions return the exponential value of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is positive infinity, positive infinity is returned.
    
           If _x_ is negative infinity, +0 is returned.
    
           If the result underflows, a range error occurs, and zero is
           returned.
    
           If the result overflows, a range error occurs, and the functions
           return +**HUGE_VAL** , +**HUGE_VALF** , or +**HUGE_VALL** , respectively.
    


## 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:
    
           Range error, overflow
                  _errno_ is set to **ERANGE**.  An overflow floating-point
                  exception (**FE_OVERFLOW**) is raised.
    
           Range error, underflow
                  _errno_ is set to **ERANGE**.  An underflow floating-point
                  exception (**FE_UNDERFLOW**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# audit_getloginuid

## NAME



           audit_getloginuid - Get a program's loginuid value
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **uid_t audit_getloginuid(void);**
    


## DESCRIPTION



           This function returns the task attribute loginuid.
    


## RETURN VALUE



           This function returns the loginuid value if it was set. It will
           return a -1 if loginuid was unset. However, since uid_t is an
           unsigned type, you will see the converted value instead of -1.
    


## ERRORS



           This function returns -1 on failure. However, in the event of a
           real error, errno would be set. The function can set errno based
           on failures of open, read, or strtoul.
    


* * *
# uselocale

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



           uselocale — use locale in current thread
    


## SYNOPSIS



           #include <locale.h>
    
           locale_t uselocale(locale_t _newloc_);
    


## DESCRIPTION



           The _uselocale_() function shall set or query the current locale for
           the calling thread.
    
           The value for the _newloc_ argument shall be one of the following:
    
            1. A value returned by the _newlocale_() or _duplocale_() functions
    
            2. The special locale object descriptor LC_GLOBAL_LOCALE
    
            3. (**locale_t**)0
    
           If the _newloc_ argument is (**locale_t**)0, the current locale shall
           not be changed; this value can be used to query the current locale
           setting. If the _newloc_ argument is LC_GLOBAL_LOCALE, any thread-
           local locale for the calling thread shall be uninstalled; the
           thread shall again use the global locale as the current locale,
           and changes to the global locale shall affect the thread.
           Otherwise, the locale represented by _newloc_ shall be installed as
           a thread-local locale to be used as the current locale for the
           calling thread.
    
           Once the _uselocale_() function has been called to install a thread-
           local locale, the behavior of every interface using data from the
           current locale shall be affected for the calling thread. The
           current locale for other threads shall remain unchanged.
    


## RETURN VALUE



           Upon successful completion, the _uselocale_() function shall return
           a handle for the thread-local locale that was in use as the
           current locale for the calling thread on entry to the function, or
           LC_GLOBAL_LOCALE if no thread-local locale was in use. Otherwise,
           _uselocale_() shall return (**locale_t**)0 and set _errno_ to indicate the
           error.
    


## ERRORS



           The _uselocale_() function may fail if:
    
           **EINVAL** _newloc_ is not a valid locale object and is not (**locale_t**)0.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Unlike the _setlocale_() function, the _uselocale_() function does not
           allow replacing some locale categories only. Applications that
           need to install a locale which differs only in a few categories
           must use _newlocale_() to change a locale object equivalent to the
           currently used locale and install it.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crl_list_import2

## NAME



           gnutls_x509_crl_list_import2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_list_import2(gnutls_x509_crl_t ****_crls_**,**
           **unsigned int ***_size_**, const gnutls_datum_t ***_data_**,**
           **gnutls_x509_crt_fmt_t** _format_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t ** crls
                       Will contain the parsed crl list.
    
           unsigned int * size
                       It will contain the size of the list.
    
           const gnutls_datum_t * data
                       The CRL data.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM.
    
           unsigned int flags
                       must be (0) or an OR'd sequence of
                       gnutls_certificate_import_flags.
    


## DESCRIPTION



           This function will convert the given CRL list to the native
           gnutls_x509_crl_t format. The output will be stored in  _crls_ .
           They will be automatically initialized.
    
           If the Certificate is PEM encoded it should have a header of "X509
           CRL".
    


## RETURNS



           the number of certificates read or a negative error value.
    


## SINCE



           3.0
    


* * *
# probe::tcpmib.EstabResets

## NAME



           probe::tcpmib.EstabResets - Count the reset of a socket
    


## SYNOPSIS



           tcpmib.EstabResets
    


## VALUES



           _op_
               value to be added to the counter (default value of 1)
    
           _sk_
               pointer to the struct sock being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **tcpmib_filter_key**. If the packet passes the filter is is counted
           in the global _EstabResets_ (equivalent to SNMP's MIB
           TCP_MIB_ESTABRESETS)
    


* * *
# sysv_signal

## NAME



           sysv_signal - signal handling with System V semantics
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <signal.h>**
    
           **typedef typeof(void (int))  *sighandler_t;**
    
           **sighandler_t sysv_signal(int** _signum_**, sighandler_t** _handler_**);**
    


## DESCRIPTION



           The **sysv_signal**() function takes the same arguments, and performs
           the same task, as signal(2).
    
           However **sysv_signal**() provides the System V unreliable signal
           semantics, that is: a) the disposition of the signal is reset to
           the default when the handler is invoked; b) delivery of further
           instances of the signal is not blocked while the signal handler is
           executing; and c) if the handler interrupts (certain) blocking
           system calls, then the system call is not automatically restarted.
    


## RETURN VALUE



           The **sysv_signal**() function returns the previous value of the
           signal handler, or **SIG_ERR** on error.
    


## ERRORS



           As for signal(2).
    


## ATTRIBUTES



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


## VERSIONS



           Use of **sysv_signal**() should be avoided; use sigaction(2) instead.
    
           On older Linux systems, **sysv_signal**() and signal(2) were
           equivalent.  But on newer systems, signal(2) provides reliable
           signal semantics; see signal(2) for details.
    
           The use of _sighandler_t_ is a GNU extension; this type is defined
           only if the **_GNU_SOURCE** feature test macro is defined.
    


## STANDARDS



           None.
    


* * *
# wcscmp

## NAME



           wcscmp - compare two wide-character strings
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **int wcscmp(const wchar_t ***_s1_**, const wchar_t ***_s2_**);**
    


## DESCRIPTION



           The **wcscmp**() function is the wide-character equivalent of the
           strcmp(3) function.  It compares the wide-character string pointed
           to by _s1_ and the wide-character string pointed to by _s2_.
    


## RETURN VALUE



           The **wcscmp**() function returns zero if the wide-character strings
           at _s1_ and _s2_ are equal.  It returns an integer greater than zero
           if at the first differing position _i_ , the corresponding wide-
           character _s1[i]_ is greater than _s2[i]_.  It returns an integer less
           than zero if at the first differing position _i_ , the corresponding
           wide-character _s1[i]_ is less than _s2[i]_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pcre2_substring_length_byname

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_length_byname(pcre2_match_data ***_match_data_**,**
             **PCRE2_SPTR** _name_**, PCRE2_SIZE ***_length_**);**
    


## DESCRIPTION



    
           This function returns the length of a matched substring,
           identified by name.  The arguments are:
    
             _match_data_   The match data block for the match
             _name_         The substring name
             _length_       Where to return the length
    
           The yield is zero on success, or an error code if the substring is
           not found.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_x509_ct_sct_get

## NAME



           gnutls_x509_ct_sct_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ct_sct_get(const gnutls_x509_ct_scts_t** _scts_**,**
           **unsigned** _idx_**, time_t ***_timestamp_**, gnutls_datum_t ***_logid_**,**
           **gnutls_sign_algorithm_t ***_sigalg_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           const gnutls_x509_ct_scts_t scts
                       A list of SCTs
    
           unsigned idx
                       The index of the target SCT in the list
    
           time_t * timestamp
                       The timestamp of the SCT
    
           gnutls_datum_t * logid
                       The LogID field of the SCT; must be freed with
                       **gnutls_free()**
    
           gnutls_sign_algorithm_t * sigalg
                       The signature algorithm
    
           gnutls_datum_t * signature
                       The signature of the SCT; must be freed with
                       **gnutls_free()**
    


## DESCRIPTION



           This function will return a specific SCT (Signed Certificate
           Timestamp) stored in the SCT list  _scts_ .
    
           The datums holding the SCT's LogId and signature will be allocated
           using **gnutls_malloc()**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) will be returned on success,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if  _idx_ exceeds the number
           of SCTs in the list or a negative error value.
    


* * *
# gnutls_x509_crt_set_flags

## NAME



           gnutls_x509_crt_set_flags - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crt_set_flags(gnutls_x509_crt_t** _cert_**, unsigned**
           **int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       A type **gnutls_x509_crt_t**
    
           unsigned int flags
                       flags from the **gnutls_x509_crt_flags**
    


## DESCRIPTION



           This function will set flags for the specified certificate.
           Currently this is useful for the
           **GNUTLS_X509_CRT_FLAG_IGNORE_SANITY** which allows importing
           certificates even if they have known issues.
    


## SINCE



           3.6.0
    


* * *
# gnutls_certificate_set_ocsp_status_request_file2

## NAME



           gnutls_certificate_set_ocsp_status_request_file2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_ocsp_status_request_file2(gnutls_certificate_credentials_t**
           _sc_**, const char ***_response_file_**, unsigned** _idx_**,**
           **gnutls_x509_crt_fmt_t** _fmt_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a credentials structure.
    
           const char * response_file
                       a filename of the OCSP response
    
           unsigned idx
                       is a certificate index as returned by
                       **gnutls_certificate_set_key()** and friends
    
           gnutls_x509_crt_fmt_t fmt
                       is PEM or DER
    


## DESCRIPTION



           This function loads the OCSP responses to be sent to the peer for
           the certificate chain specified by  _idx_ . When  _fmt_ is set to PEM,
           multiple responses can be loaded.
    
           This function must be called after setting any certificates, and
           cannot be used for certificates that are provided via a callback
           -- that is when **gnutls_certificate_set_retrieve_function()** is
           used. In that case consider using
           **gnutls_certificate_set_retrieve_function3()**.
    
           This function can be called multiple times when multiple responses
           applicable to the certificate chain are available.  If the
           response provided does not match any certificates present in the
           chain, the code **GNUTLS_E_OCSP_MISMATCH_WITH_CERTS** is returned.  If
           the response is already expired at the time of loading the code
           **GNUTLS_E_EXPIRED** is returned.
    


## RETURNS



           On success, the number of loaded responses is returned, otherwise
           a negative error code.
    


## SINCE



           3.1.3
    


* * *
# gnutls_base64_encode2

## NAME



           gnutls_base64_encode2 - API function
    


## SYNOPSIS



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


## ARGUMENTS



           const gnutls_datum_t * data
                       contains the raw data
    
           gnutls_datum_t * result
                       will hold the newly allocated encoded data
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the base64 encoding. This function will allocate the required
           memory to hold the encoded data.
    
           You should use **gnutls_free()** to free the returned data.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# csqrt

## NAME



           csqrt, csqrtf, csqrtl - complex square root
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex csqrt(double complex** _z_**);**
           **float complex csqrtf(float complex** _z_**);**
           **long double complex csqrtl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex square root of _z_ , with a
           branch cut along the negative real axis.  (That means that
           _csqrt(-1+eps*I)_ will be close to I while _csqrt(-1-eps*I)_ will be
           close to -I, _if eps_ is a small positive real number.)
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ibnd_discover_fabric

## NAME



           ibnd_discover_fabric, ibnd_destroy_fabric, ibnd_debug
           ibnd_show_progress - initialize ibnetdiscover library.
    


## SYNOPSIS



           **#include <infiniband/ibnetdisc.h>**
    
           **ibnd_fabric_t *ibnd_discover_fabric(struct ibmad_port *ibmad_port, int timeout_ms, ib_portid_t *from, int hops)**
           **void ibnd_destroy_fabric(ibnd_fabric_t *fabric)**
           **void ibnd_debug(int i)**
           **void ibnd_show_progress(int i)**
           **int ibnd_set_max_smps_on_wire(int i)**
    


## DESCRIPTION



           **ibnd_discover_fabric()** Discover the fabric connected to the port
           specified by ibmad_port, using a timeout specified.  The "from"
           and "hops" parameters are optional and allow one to scan part of a
           fabric by specifying a node "from" and a number of hops away from
           that node to scan, "hops".  This gives the user a "sub-fabric"
           which is "centered" anywhere they chose.
    
           ibmad_port must be opened with at least IB_SMI_CLASS and
           IB_SMI_DIRECT_CLASS classes for ibnd_discover_fabric to work.
    
           **ibnd_destroy_fabric()** free all memory and resources associated
           with the fabric.
    
           **ibnd_debug()** Set the debug level to be printed as library
           operations take place.
    
           **ibnd_show_progress()** Indicate that the library should print debug
           output which shows it's progress through the fabric.
    
           **ibnd_set_max_smps_on_wire()** Set the number of SMP's which will be
           issued on the wire simultaneously.
    


## RETURN VALUE



           **ibnd_discover_fabric()** return NULL on failure, otherwise a valid
           ibnd_fabric_t object.
    
           **ibnd_destory_fabric(), ibnd_debug()** NONE
    
           **ibnd_set_max_smps_on_wire()** The previous value is returned
    


## EXAMPLES



           **Discover the entire fabric connected to device mthca0 , port 1.**
    
                int mgmt_classes[2] = {IB_SMI_CLASS, IB_SMI_DIRECT_CLASS};
                struct ibmad_port *ibmad_port = mad_rpc_open_port(ca,
           ca_port, mgmt_classes, 2);      ibnd_fabric_t *fabric =
           ibnd_discover_fabric(ibmad_port, 100, NULL, 0);      ...
                ibnd_destroy_fabric(fabric);
                mad_rpc_close_port(ibmad_port);
    
           **Discover only a single node and those nodes connected to it.**
    
                ...       str2drpath(&(port_id.drpath), from, 0, 0);      ...
                ibnd_discover_fabric(ibmad_port, 100, &port_id, 1);      ...
    


* * *
# gnutls_x509_dn_init

## NAME



           gnutls_x509_dn_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_init(gnutls_x509_dn_t ***_dn_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t * dn
                       the object to be initialized
    


## DESCRIPTION



           This function initializes a **gnutls_x509_dn_t** type.
    
           The object returned must be deallocated using
           **gnutls_x509_dn_deinit()**.
    


## RETURNS



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


## SINCE



           2.4.0
    


* * *
# tep_print_printk

## NAME



           tep_print_printk, tep_print_funcs, tep_set_test_filters,
           tep_plugin_print_options - Print libtraceevent internal
           information.
    


## SYNOPSIS



           **#include <event-parse.h>**
           **#include <trace-seq.h>**
    
           void **tep_print_printk**(struct tep_handle *tep);
           void **tep_print_funcs**(struct tep_handle *tep);
           void **tep_set_test_filters**(struct tep_handle *tep, int test_filters);
           void **tep_plugin_print_options**(struct trace_seq *s);
    


## DESCRIPTION



           The **tep_print_printk()** function prints the printk string formats
           that were stored for this tracing session. The _tep_ argument is
           trace event parser context.
    
           The **tep_print_funcs()** function prints the stored function name to
           address mapping for this tracing session. The _tep_ argument is
           trace event parser context.
    
           The **tep_set_test_filters()** function sets a flag to test a filter
           string. If this flag is set, when **tep_filter_add_filter_str()** API
           as called, it will print the filter string instead of adding it.
           The _tep_ argument is trace event parser context. The _test_filters_
           argument is the test flag that will be set.
    
           The **tep_plugin_print_options()** function writes a list of the
           registered plugin options into _s_.
    


## EXAMPLE



               #include <event-parse.h>
               #include <trace-seq.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
                       tep_print_printk(tep);
               ...
                       tep_print_funcs(tep);
               ...
               struct tep_event_filter *filter = tep_filter_alloc(tep);
                       tep_set_test_filters(tep, 1);
                       tep_filter_add_filter_str(filter, "sched/sched_wakeup:target_cpu==1");
                       tep_set_test_filters(tep, 0);
                       tep_filter_free(filter);
               ...
               struct trace_seq seq;
               trace_seq_init(&seq);
    
                       tep_plugin_print_options(&s);
               ...
    


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


* * *
# strtoll

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



           strtoll — convert a string to a long integer
    


## SYNOPSIS



           #include <stdlib.h>
    
           long long strtoll(const char *restrict _str_ , char **restrict _endptr_ ,
               int _base_);
    


## DESCRIPTION



           Refer to strtol(3p).
    


* * *
# FILE

## NAME



           FILE - input/output stream
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **typedef** /* ... */  **FILE;**
    


## DESCRIPTION



           An object type used for streams.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following header also provides this type: _< wchar.h>_.
    


* * *
# gnutls_x509_crt_set_authority_key_id

## NAME



           gnutls_x509_crt_set_authority_key_id - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * id
                       The key ID
    
           size_t id_size
                       Holds the size of the key ID field.
    


## DESCRIPTION



           This function will set the X.509 certificate's authority key ID
           extension.  Only the keyIdentifier field can be set with this
           function.
    


## RETURNS



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


* * *