tripathysagar/man_text huggingface dataset:
# nan

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



           nan, nanf, nanl — return quiet NaN
    


## SYNOPSIS



           #include <math.h>
    
           double nan(const char *_tagp_);
           float nanf(const char *_tagp_);
           long double nanl(const char *_tagp_);
    


## 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 function call _nan_("_n-char-sequence_ ") shall be equivalent to:
    
               strtod("NAN(_n-char-sequence_)", (char **) NULL);
    
           The function call _nan_("") shall be equivalent to:
    
               strtod("NAN()", (char **) NULL)
    
           If _tagp_ does not point to an _n_ -**char** sequence or an empty string,
           the function call shall be equivalent to:
    
               strtod("NAN", (char **) NULL)
    
           Function calls to _nanf_() and _nanl_() are equivalent to the
           corresponding function calls to _strtof_() and _strtold_().
    


## RETURN VALUE



           These functions shall return a quiet NaN, if available, with
           content indicated through _tagp_.
    
           If the implementation does not support quiet NaNs, these functions
           shall return zero.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# iswxdigit

## NAME



           iswxdigit - test for hexadecimal digit wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **iswxdigit**() function is the wide-character equivalent of the
           isxdigit(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "xdigit".
    
           The wide-character class "xdigit" is a subclass of the wide-
           character class "alnum", and therefore also a subclass of the
           wide-character class "graph" and of the wide-character class
           "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "xdigit" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "xdigit" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           Being a subclass of the wide-character class "alnum", the wide-
           character class "xdigit" is disjoint from the wide-character class
           "punct".
    
           The wide-character class "xdigit" always contains at least the
           letters 'A' to 'F', 'a' to 'f' and the digits '0' to '9'.
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# pcre2_set_glob_escape

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_glob_escape(pcre2_convert_context ***_cvcontext_**,**
             **uint32_t** _escape_char_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It sets the escape character that is used when
           converting globs. The second argument must either be zero (meaning
           there is no escape character) or a punctuation character whose
           code point is less than 256. The default is grave accent if
           running under Windows, otherwise backslash. The result of the
           function is zero for success or PCRE2_ERROR_BADDATA if the second
           argument is invalid.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# libpfm_intel_icx_unc_cha

## NAME



           libpfm_intel_icx_unc_cha - support for Intel IcelakeX Server CHA
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_cha[0-39]**
           **PMU desc: Intel IcelakeX CHA uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX CHA (coherency and home
           agent) uncore PMU.  There is one CHA-box PMU per physical core.
           Therefore there are up forty identical CHA PMU instances numbered
           from 0 up to possibly 39. On dual-socket systems, the number
           refers to the CHA PMUs on the socket where the program runs.
    
           Each CHA PMU implements 4 generic counters.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX CHA 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 CHA clockticks 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 threshold (t) test from strictly greater than to
                  less or equal to. This is a boolean modifier.
    


* * *
# gnutls_dtls_prestate_set

## NAME



           gnutls_dtls_prestate_set - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **void gnutls_dtls_prestate_set(gnutls_session_t** _session_**,**
           **gnutls_dtls_prestate_st ***_prestate_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       a new session
    
           gnutls_dtls_prestate_st * prestate
                       contains the client's prestate
    


## DESCRIPTION



           This function will associate the prestate acquired by the cookie
           authentication with the client, with the newly established
           session.
    
           This functions must be called after a successful
           **gnutls_dtls_cookie_verify()** and should be succeeded by the actual
           DTLS handshake using **gnutls_handshake()**.
    


## SINCE



           3.0
    


* * *
# isinf

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



           isinf — test for infinity
    


## SYNOPSIS



           #include <math.h>
    
           int isinf(real-floating _x_);
    


## 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 _isinf_() macro shall determine whether its argument value is an
           infinity (positive or negative). First, an argument represented in
           a format wider than its semantic type is converted to its semantic
           type. Then determination is based on the type of the argument.
    


## RETURN VALUE



           The _isinf_() macro shall return a non-zero value if and only if its
           argument has an infinite value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# wcstoll

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



           wcstoll — convert a wide-character string to a long integer
    


## SYNOPSIS



           #include <wchar.h>
    
           long long wcstoll(const wchar_t *restrict _nptr_ ,
               wchar_t **restrict _endptr_ , int _base_);
    


## DESCRIPTION



           Refer to wcstol(3p).
    


* * *
# io_uring_prep_epoll_wait

## NAME



           io_uring_prep_epoll_wait - prepare an epoll wait request
    


## SYNOPSIS



           **#include <sys/epoll.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_epoll_wait(struct io_uring_sqe ***_sqe_**,**
                                         **int** _fd_**,**
                                         **struct epoll_event ***_events_**,**
                                         **int** _maxevents_**,**
                                         **unsigned flags** _);"_
    


## DESCRIPTION



           The io_uring_prep_epoll_wait(3) function prepares an epoll_wait
           request. The submission queue entry _sqe_ is setup to wait on a
           maximum of _maxevents_ events on the epoll file descriptor indicated
           by _fd_ , and filling the received events into the memory pointed to
           by _events_.
    
           This function prepares an async epoll_wait(2) request. See that
           man page for details. The use case is mostly for legacy event
           loops, where certain file descriptors may still be using epoll for
           readiness notifications. Normally this would necessitate using
           epoll_wait with the io_uring fd added to that set as well, which
           is suboptimal as epoll doesn't provide the same kind of fine
           grained batch control and wakeup reductions that io_uring does. By
           using io_uring to read epoll events, the event loop can be
           entirely switched to io_uring, and reap the benefits of batch
           waiting and context switch reductions.
    


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


* * *
# sd_device_enumerator_get_device_first

## NAME



           sd_device_enumerator_get_device_first,
           sd_device_enumerator_get_device_next,
           sd_device_enumerator_get_subsystem_first,
           sd_device_enumerator_get_subsystem_next - Enumerates devices and
           get the first or next device.
    


## SYNOPSIS



           **#include <systemd/sd-device.h>**
    
           **sd_device**
                                                            ***sd_device_enumerator_get_device_first(sd_device_enumerator ***_enumerator_**);**
    
           **sd_device**
                                                           ***sd_device_enumerator_get_device_next(sd_device_enumerator ***_enumerator_**);**
    
           **sd_device**
                                                               ***sd_device_enumerator_get_subsystem_first(sd_device_enumerator ***_enumerator_**);**
    
           **sd_device**
                                                              ***sd_device_enumerator_get_subsystem_next(sd_device_enumerator ***_enumerator_**);**
    


## DESCRIPTION



           The **sd_device_enumerator_get_device_first()** function enumerates
           all matching devices under /sys/bus/_SUBSYSTEM_ /devices/ and
           /sys/class/_SUBSYSTEM_ /devices/, and returns a pointer to the first
           **sd_device** object. If no devices are found, **NULL** is returned.
    
           The **sd_device_enumerator_get_device_next()** function returns the
           pointer to the next **sd_device** from the _enumerator_. It should be
           called after **sd_device_enumerator_get_device_first()** or after a
           previous call to this function. If no more devices are available,
           **NULL** is returned.
    
           The **sd_device_enumerator_get_subsystem_first()** function enumerates
           all matching subsystem devices in /sys/module/, /sys/bus/, and
           /sys/bus/_SUBSYSTEM_ /drivers/ (such as /sys/bus/pci/drivers/). It
           returns a pointer to the first **sd_device** object. If no devices are
           found **NULL** is returned. Note that this does _not_ enumerate devices
           provided by **sd_device_enumerator_get_device_first/next()**. Hence,
           e.g.  /sys/bus/pci/, /sys/bus/pci/drivers/ahci/ and so on are
           enumerated, but /sys/bus/pci/devices/0000:00:00.0/ and so on are
           not.
    
           The **sd_device_enumerator_get_subsystem_next()** function returns the
           next subsystem device from the enumerator. It should be called
           after **sd_device_enumerator_get_subsystem_first()** or after a
           previous call to this function. If no more subsystem devices are
           available, **NULL** is returned.
    


## RETURN VALUE



           On success, these functions return a pointer to an **sd_device**
           object. On failure or when no more devices are available, **NULL** is
           returned. The returned pointers are owned by the enumerator and
           should not be freed by the caller.
    


* * *
# umad_set_grh_net

## NAME



           umad_set_grh_net - set GRH fields within umad buffer using network
           ordering
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_set_grh_net(void** _*umad_**, void** _*mad_addr_**);**
    


## DESCRIPTION



           **umad_set_grh_net()** sets the GRH fields (grh_present, gid,
           hop_limit, traffic_class, flow_label) within the specified _umad_
           buffer based on the _mad_addr_ supplied. The provided _mad_addr_
           fields are expected to be in network order.  If the _mad_addr_
           pointer supplied is NULL, no GRH is set.  The argument _mad_addr_ is
           a pointer to an _ib_mad_addr_t_ struct, as specified in
           <infiniband/umad.h>.  The argument _umad_ is a pointer to an
           _ib_user_mad_t_ struct, as specified in _< infiniband/umad.h>._
    
           typedef struct ib_mad_addr {
                   uint32_t qpn;
                   uint32_t qkey;
                   uint16_t lid;
                   uint8_t  sl;
                   uint8_t  path_bits;
                   uint8_t  grh_present;
                   uint8_t  gid_index;
                   uint8_t  hop_limit;
                   uint8_t  traffic_class;
                   uint8_t  gid[16];
                   uint32_t flow_label;
           } ib_mad_addr_t;
    
           typedef struct ib_user_mad {
                   uint32_t agent_id;
                   uint32_t status;
                   uint32_t timeout_ms;
                   uint32_t retries;
                   uint32_t length;
                   ib_mad_addr_t addr;
                   uint8_t  data[0];
           } ib_user_mad_t;
    


## RETURN VALUE



           **umad_set_grh_net()** returns 0 on success, and a negative value on
           errors. Currently, there are no errors indicated.
    


## KNOWN BUGS



           Not implemented.
    


* * *
# function::user_string_warn

## NAME



           function::user_string_warn - Retrieves string from user space
    


## SYNOPSIS



           1) user_string_warn:string(addr:long)
    
           2) user_string_warn:string(addr:long,warn_msg:string)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the string from
    
           _warn_msg_
               the warning message to return when data isn't available
    


## DESCRIPTION



           1) Returns the null terminated C string from a given user space
           memory address. Reports "" on the rare cases when userspace data
           is not accessible and warns (but does not abort) about the
           failure.
    
           2) Returns the null terminated C string from a given user space
           memory address. Reports the given warning message on the rare
           cases when userspace data is not accessible and warns (but does
           not abort) about the failure.
    


* * *
# tapset::tzinfo

## NAME



           tapset::tzinfo - systemtap tzinfo tapset
    


## DESCRIPTION



           **tz_gmtoff**
                  Return local time zone offset
    
                  See function::tz_gmtoff(3stap)
                   for details.
    
           **tz_name**
                  Return local time zone name
    
                  See function::tz_name(3stap)
                   for details.
    
           **tz_ctime**
                  Convert seconds since epoch into human readable date/time
                  string, with local time zone
    
                  See function::tz_ctime(3stap)
                   for details.
    


* * *
# function::ktime_get_ns

## NAME



           function::ktime_get_ns - Number of nanoseconds since boot
    


## SYNOPSIS



               ktime_get_ns:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the system ktime.
    


* * *
# getkeycreatecon

## NAME



           getkeycreatecon, setkeycreatecon - get or set the SELinux security
           context used for creating a new kernel keyrings
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int getkeycreatecon(char ****_con_**);**
    
           **int getkeycreatecon_raw(char ****_con_**);**
    
           **int setkeycreatecon(const char ***_context_**);**
    
           **int setkeycreatecon_raw(const char ***_context_**);**
    


## DESCRIPTION



           **getkeycreatecon**() retrieves the context used for creating a new
           kernel keyring.  This returned context should be freed with
           freecon(3) if non-NULL.  **getkeycreatecon**() sets *con to NULL if no
           keycreate context has been explicitly set by the program (i.e.
           using the default policy behavior).
    
           **setkeycreatecon**() sets the context used for creating a new kernel
           keyring.  NULL can be passed to **setkeycreatecon**() to reset to the
           default policy behavior.  The keycreate context is automatically
           reset after the next execve(2), so a program doesn't need to
           explicitly sanitize it upon startup.
    
           **setkeycreatecon**() can be applied prior to library functions that
           internally perform an file creation, in order to set an file
           context on the objects.
    
           **getkeycreatecon_raw**() and **setkeycreatecon_raw**() behave identically
           to their non-raw counterparts but do not perform context
           translation.
    
           **Note:** Signal handlers that perform a **setkeycreatecon**() must take
           care to save, reset, and restore the keycreate context to avoid
           unexpected behavior.
    
           **Note:** Contexts are thread specific.
    


## RETURN VALUE



           On error -1 is returned.  On success 0 is returned.
    


* * *
# siginterrupt

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



           siginterrupt — allow signals to interrupt functions
    


## SYNOPSIS



           #include <signal.h>
    
           int siginterrupt(int _sig_ , int _flag_);
    


## DESCRIPTION



           The _siginterrupt_() function shall change the restart behavior when
           a function is interrupted by the specified signal. The function
           _siginterrupt_(_sig_ , _flag_) has an effect as if implemented as:
    
               int siginterrupt(int sig, int flag) {
                   int ret;
                   struct sigaction act;
    
                   (void) sigaction(sig, NULL, &act);
                   if (flag)
                       act.sa_flags &= ~SA_RESTART;
                   else
                       act.sa_flags |= SA_RESTART;
                   ret = sigaction(sig, &act, NULL);
                   return ret;
               }
    


## RETURN VALUE



           Upon successful completion, _siginterrupt_() shall return 0;
           otherwise, -1 shall be returned and _errno_ set to indicate the
           error.
    


## ERRORS



           The _siginterrupt_() function shall fail if:
    
           **EINVAL** The _sig_ argument is not a valid signal number.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _siginterrupt_() function supports programs written to
           historical system interfaces.  Applications should use the
           _sigaction_() with the SA_RESTART flag instead of the obsolescent
           _siginterrupt_() function.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# timeradd

## NAME



           timeradd, timersub, timercmp, timerclear, timerisset - timeval
           operations
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/time.h>**
    
           **void timeradd(struct timeval ***_a_**, struct timeval ***_b_**,**
                         **struct timeval ***_res_**);**
           **void timersub(struct timeval ***_a_**, struct timeval ***_b_**,**
                         **struct timeval ***_res_**);**
    
           **void timerclear(struct timeval ***_tvp_**);**
           **int timerisset(struct timeval ***_tvp_**);**
    
           **int timercmp(struct timeval ***_a_**, struct timeval ***_b_**,**_CMP_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           All functions shown above:
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE
    


## DESCRIPTION



           The macros are provided to operate on _timeval_ structures, defined
           in _< sys/time.h>_ as:
    
               struct timeval {
                   time_t      tv_sec;     /* seconds */
                   suseconds_t tv_usec;    /* microseconds */
               };
    
           **timeradd**() adds the time values in _a_ and _b_ , and places the sum in
           the _timeval_ pointed to by _res_.  The result is normalized such that
           _res- >tv_usec_ has a value in the range 0 to 999,999.
    
           **timersub**() subtracts the time value in _b_ from the time value in _a_ ,
           and places the result in the _timeval_ pointed to by _res_.  The
           result is normalized such that _res- >tv_usec_ has a value in the
           range 0 to 999,999.
    
           **timerclear**() zeros out the _timeval_ structure pointed to by _tvp_ , so
           that it represents the Epoch: 1970-01-01 00:00:00 +0000 (UTC).
    
           **timerisset**() returns true (nonzero) if either field of the _timeval_
           structure pointed to by _tvp_ contains a nonzero value.
    
           **timercmp**() compares the timer values in _a_ and _b_ using the
           comparison operator _CMP_ , and returns true (nonzero) or false (0)
           depending on the result of the comparison.  Some systems (but not
           Linux/glibc), have a broken **timercmp**() implementation, in which
           _CMP_ of _> =_, _< =_, and _==_ do not work; portable applications can
           instead use
    
               !timercmp(..., <)
               !timercmp(..., >)
               !timercmp(..., !=)
    


## RETURN VALUE



           **timerisset**() and **timercmp**() return true (nonzero) or false (0).
    


## ERRORS



           No errors are defined.
    


## STANDARDS



           None.
    


* * *
# function::sock_state_str2num

## NAME



           function::sock_state_str2num - Given a socket state string, return
           the corresponding state number
    


## SYNOPSIS



               sock_state_str2num:long(state:string)
    


## ARGUMENTS



           _state_
               The state name
    


* * *
# gnutls_x509_crt_get_policy

## NAME



           gnutls_x509_crt_get_policy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_policy(gnutls_x509_crt_t** _crt_**, unsigned**
           _indx_**, struct gnutls_x509_policy_st ***_policy_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       This specifies which policy to return. Use (0) to get
                       the first one.
    
           struct gnutls_x509_policy_st * policy
                       A pointer to a policy structure.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will extract the certificate policy (extension
           2.5.29.32) specified by the given index.
    
           The policy returned by this function must be deinitialized by
           using **gnutls_x509_policy_release()**.
    


## RETURNS



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


## SINCE



           3.1.5
    


* * *
# posix_trace_open

## 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_open, posix_trace_rewind — trace log management
           (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_open(int _file_desc_ , trace_id_t *_trid_);
           int posix_trace_rewind(trace_id_t _trid_);
    


## DESCRIPTION



           Refer to posix_trace_close(3p).
    


* * *
# gnutls_mac_get

## NAME



           gnutls_mac_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_mac_algorithm_t gnutls_mac_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the currently used MAC algorithm.
    


## RETURNS



           the currently used mac algorithm, a **gnutls_mac_algorithm_t** value.
    


* * *
# libpfm_intel_snbep_unc_ha

## NAME



           libpfm_intel_snbep_unc_ha - support for Intel Sandy Bridge-EP Home
           Agent (HA) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snbep_unc_ha**
           **PMU desc: Intel Sandy Bridge-EP HA uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge Home Agent (HA) uncore
           PMU.  This PMU model only exists on Sandy Bridge model 45. There
           is only one Home Agent per processor socket.
    


## MODIFIERS



           The following modifiers are supported on Intel Sandy Bridge C-Box
           uncore PMU:
    
           **i** Invert the meaning of the event. The counter will now count
                  HA cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition 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].
    


* * *
# probe::socket.write_iter.return

## NAME



           probe::socket.write_iter.return - Conclusion of message send via
           **sock_write_iter**
    


## SYNOPSIS



           socket.write_iter.return
    


## VALUES



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


## CONTEXT



           The message receiver.
    


## DESCRIPTION



           Fires at the conclusion of sending a message on a socket via the
           **sock_write_iter** function
    


* * *
# pmnameindom

## NAME



           **pmNameInDom** - translate an instance identifier into an instance
           name
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmNameInDom(pmInDom** _indom_**, int** _inst_**, char ****_name_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           For  the instance domain _indom_ , in the current Performance Metrics
           Application Programming Interface (PMAPI) context, locate the  in‐
           stance  with  the  internal instance identifier given by _inst_ , and
           return the full external instance identification via _name_.
    
           The value for the instance domain  _indom_  is  typically  extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           The  space  for  the value of _name_ will have been allocated in **pm‐**
           **NameInDom** with malloc(3), and it  is  the  responsibility  of  the
           caller to free(3) the space when it is no longer required.
    
           **pmNameInDom** returns zero on success.
    


## DIAGNOSTICS



           **PM_ERR_INDOM**
                  _indom_ is not a valid instance domain identifier
    
           **PM_ERR_INST**
                  The instance identifier _inst_ is not known for the instance
                  domain _indom_ in the current PMAPI context
    


* * *
# gnutls_privkey_sign_hash2

## NAME



           gnutls_privkey_sign_hash2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_sign_hash2(gnutls_privkey_t** _signer_**,**
           **gnutls_sign_algorithm_t** _algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_hash_data_**, gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_privkey_t signer
                       Holds the signer's key
    
           gnutls_sign_algorithm_t algo
                       The signature algorithm used
    
           unsigned int flags
                       Zero or one of **gnutls_privkey_flags_t**
    
           const gnutls_datum_t * hash_data
                       holds the data to be signed
    
           gnutls_datum_t * signature
                       will contain newly allocated signature
    


## DESCRIPTION



           This function will sign the given hashed data using the specified
           signature algorithm. This function is an enhancement of
           **gnutls_privkey_sign_hash()** , as it allows utilizing a alternative
           signature algorithm where possible (e.g, use an RSA key with
           RSA-PSS).
    
           The flags may be **GNUTLS_PRIVKEY_SIGN_FLAG_TLS1_RSA**.  In that case
           this function will ignore  _hash_algo_ and perform a raw PKCS1
           signature.  Note that this flag is supported since 3.6.9.
    
           Note also that, not all algorithm support signing already hashed
           data. When signing with Ed25519, **gnutls_privkey_sign_data2()**
           should be used instead.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# gnutls_pubkey_import_gost_raw

## NAME



           gnutls_pubkey_import_gost_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_gost_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, gnutls_digest_algorithm_t** _digest_**,**
           **gnutls_gost_paramset_t** _paramset_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The structure to store the parsed key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           gnutls_digest_algorithm_t digest
                       holds the digest
    
           gnutls_gost_paramset_t paramset
                       holds the parameters id
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    


## DESCRIPTION



           This function will convert the given GOST public key's parameters
           to a **gnutls_pubkey_t**.  The output will be stored in  _key_ .
           _digest_ should be one of GNUTLS_DIG_GOSR_94,
           GNUTLS_DIG_STREEBOG_256 or GNUTLS_DIG_STREEBOG_512.  If  _paramset_
           is set to GNUTLS_GOST_PARAMSET_UNKNOWN default one will be
           selected depending on  _digest_ .
    


## NOTE



           parameters should be stored with least significant byte first. On
           version 3.6.3 big-endian format was used incorrectly.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# gnutls_x509_crt_set_dn_by_oid

## NAME



           gnutls_x509_crt_set_dn_by_oid - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



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


## RETURNS



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


* * *
# sd_get_seats

## NAME



           sd_get_seats, sd_get_sessions, sd_get_uids, sd_get_machine_names -
           Determine available seats, sessions, logged in users and virtual
           machines/containers
    


## SYNOPSIS



           **#include <systemd/sd-login.h>**
    
           **int sd_get_seats(char *****_seats_**);**
    
           **int sd_get_sessions(char *****_sessions_**);**
    
           **int sd_get_uids(uid_t ****_users_**);**
    
           **int sd_get_machine_names(char *****_machines_**);**
    


## DESCRIPTION



           **sd_get_seats()** may be used to determine all currently available
           local seats. Returns the number of seat identifiers and if the
           input pointer is non-**NULL** , a **NULL** -terminated array of seat
           identifiers is stored at the address. The returned array and all
           strings it references need to be freed with the libc free(3) call
           after use. Note that instead of an empty array **NULL** may be
           returned and should be considered equivalent to an empty array.
    
           Similarly, **sd_get_sessions()** may be used to determine all current
           login sessions.
    
           Similarly, **sd_get_uids()** may be used to determine all Unix users
           who currently have login sessions.
    
           Similarly, **sd_get_machine_names()** may be used to determine all
           current virtual machines and containers on the system.
    
           Note that the returned lists are not sorted and in an undefined
           order.
    


## RETURN VALUE



           On success, **sd_get_seats()** , **sd_get_sessions()** , **sd_get_uids()** and
           **sd_get_machine_names()** return the number of entries in the arrays.
           On failure, these calls return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ENOMEM**
               Memory allocation failed.
    


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


* * *
# audit_name_to_errno

## NAME



           audit_name_to_errno, audit_errno_to_name - Convert the errno name
           and the numeric errno value to each other
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_name_to_errno(const char** _*error_**);**
    
           **const char *audit_errno_to_name(int** _error_**);**
    


## DESCRIPTION



           **audit_name_to_errno**() converts the errno name ("EPERM", "ENOENT",
           "ESRCH", etc.) to the numeric errno value (EPERM, ENOENT, ESRCH,
           etc.).  _error_ is the errno name.
    
           **audit_errno_to_name**() converts the numeric errno value (EPERM,
           ENOENT, ESRCH, etc.) to the errno name ("EPERM", "ENOENT",
           "ESRCH", etc.).  _error_ is the numeric errno value.
    


## RETURN VALUE



           **audit_name_to_errno**() returns 0 if an error occurs; otherwise, the
           return value is the numeric errno value.
    
           **audit_errno_to_name**() returns NULL if an error occurs; otherwise,
           the return value is the errno name.
    


* * *
# pmfreelabelsets

## NAME



           **pmFreeLabelSets** - release storage allocated for performance metric
           labels
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmFreeLabelSets(pmLabelSet ***_sets_**, int** _nsets_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  array of label _sets_ returned by pmLookupLabels(3) and related
           APIs are allocated below the Performance Metrics Application  Pro‐
           gramming  Interface  (PMAPI)  using a variety of calls to the sys‐
           tem's dynamic memory allocation (i.e. malloc(3)) interfaces.
    
           Applications should call **pmFreeLabelSets** to  release  the  storage
           previously  allocated  for the label _sets_ array when access to the
           structure is no longer needed.  The return value from  **pmLookupLa‐**
           **bels** indicates the number of elements in the label _sets_ array, and
           this should be passed in using the _nsets_ parameter.
    
           Under **no** circumstances should an application use _free(labelset)_ to
           release   storage   previously   allocated  for  a  _pmLabelSet_  by
           pmLookupLabels(3) or related APIs.
    
           To simplify error handling, if _sets_ is **NULL** then  _pmFreeLabelSets_
           simply returns without freeing any storage.
    


* * *
# function::tokenize

## NAME



           function::tokenize - Return the next non-empty token in a string
    


## SYNOPSIS



           1) tokenize:string(delim:string)
    
           2) tokenize:string(input:string,delim:string)
    


## ARGUMENTS



           _delim_
               set of characters that delimit the tokens
    
           _input_
               string to tokenize. If empty, returns the next non-empty token
               in the string passed in the previous call to **tokenize**.
    


## DESCRIPTION



           1) This function returns the next token in the string passed in
           the previous call to tokenize. If no delimiter is found, the
           entire remaining input string is * returned. It returns empty when
           no more tokens are available.
    
           2) This function returns the next non-empty token in the given
           input string, where the tokens are delimited by characters in the
           delim string. If the input string is non-empty, it returns the
           first token. If the input string is empty, it returns the next
           token in the string passed in the previous call to tokenize. If no
           delimiter is found, the entire remaining input string is returned.
           It returns empty when no more tokens are available.
    


* * *
# fpclassify

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



           fpclassify — classify real floating type
    


## SYNOPSIS



           #include <math.h>
    
           int fpclassify(real-floating _x_);
    


## 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 _fpclassify_() macro shall classify its argument value as NaN,
           infinite, normal, subnormal, zero, or into another implementation-
           defined category.  First, an argument represented in a format
           wider than its semantic type is converted to its semantic type.
           Then classification is based on the type of the argument.
    


## RETURN VALUE



           The _fpclassify_() macro shall return the value of the number
           classification macro appropriate to the value of its argument.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# carg

## NAME



           carg, cargf, cargl - calculate the complex argument
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double carg(double complex** _z_**);**
           **float cargf(float complex** _z_**);**
           **long double cargl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex argument (also called phase
           angle) of _z_ , with a branch cut along the negative real axis.
    
           A complex number can be described by two real coordinates.  One
           may use rectangular coordinates and gets
    
               z = x + I * y
    
           where _x = creal(z)_ and _y = cimag(z)_.
    
           Or one may use polar coordinates and gets
    
               z = r * cexp(I * a)
    
           where _r = cabs(z)_ is the "radius", the "modulus", the absolute
           value of _z_ , and _a = carg(z)_ is the "phase angle", the argument of
           _z_.
    
           One has:
    
               tan(carg(z)) = cimag(z) / creal(z)
    


## RETURN VALUE



           The return value is in the range of [-pi,pi].
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *