tripathysagar/man_text huggingface dataset:
# logb

## NAME



           logb, logbf, logbl - get exponent of a floating-point value
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions extract the exponent from the internal floating-
           point representation of _x_ and return it as a floating-point value.
           The integer constant **FLT_RADIX** , defined in _< float.h>_, indicates
           the radix used for the system's floating-point representation.  If
           **FLT_RADIX** is 2, **logb(**_x_**)** is similar to **floor(log2(fabs(**_x_**)))** , except
           that the latter may give an incorrect integer due to intermediate
           rounding.
    
           If _x_ is subnormal, **logb**() returns the exponent _x_ would have if it
           were normalized.
    


## RETURN VALUE



           On success, these functions return the exponent of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is zero, then a pole error occurs, and the functions return
           -**HUGE_VAL** , -**HUGE_VALF** , or -**HUGE_VALL** , respectively.
    
           If _x_ is negative infinity or positive infinity, then positive
           infinity is returned.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Pole error: _x_ is 0
                  A divide-by-zero floating-point exception (**FE_DIVBYZERO**) is
                  raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# rdma_post_send

## NAME



           rdma_post_send - post a work request to send a message.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_send (struct rdma_cm_id ***_id_**, void ***_context_**, void**
           *****_addr_**, size_t** _length_**, struct ibv_mr ***_mr_**, int** _flags_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer will be posted.
    
           context     User-defined context associated with the request.
    
           addr        The address of the memory buffer to post.
    
           length      The length of the memory buffer.
    
           mr          Optional registered memory region associated with the
                       posted buffer.
    
           flags       Optional flags used to control the send operation.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the posted buffer
           will be sent to the remote peer of a connection.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           The user is responsible for ensuring that the remote peer has
           queued a receive request before issuing the send operations.  For
           a list of supported flags, see ibv_post_send.  Unless the send
           request is using inline data, the message buffer must have been
           registered before being posted, with the mr parameter referencing
           the registration.  The buffer must remain registered until the
           send completes.
    
           Send operations may not be posted to an rdma_cm_id or the
           corresponding queue pair until it has been connected.
    
           The user-defined context associated with the send request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# ldap_extended_operation

## NAME



           ldap_extended_operation, ldap_extended_operation_s - Extends the
           LDAP operations to the LDAP server.
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_extended_operation(**
                  **LDAP ***_ld_**,**
                  **const char ***_requestoid_**,**
                  **const struct berval ***_requestdata_**,**
                  **LDAPControl ****_sctrls_**,**
                  **LDAPControl ****_cctrls_**,**
                  **int ***_msgidp_ **);**
    
           **int ldap_extended_operation_s(**
                  **LDAP ***_ld_**,**
                  **const char ***_requestoid_**,**
                  **const struct berval ***_requestdata_**,**
                  **LDAPControl ****_sctrls_**,**
                  **LDAPControl ****_cctrls_**,**
                  **char ****_retoidp_**,**
                  **struct berval ****_retdatap_ **);**
    


## DESCRIPTION



           The **ldap_extended_operation_s()** routine is used to synchronously
           perform an LDAP extended operation.  It takes _requestoid_ , which
           points to a dotted-decimal OID string identifying the extended
           operation to perform. _requestdata_ is the data required for the
           request, _sctrls_ is an array of LDAPControl structures to use with
           this extended operation, _cctrls_ is an array of LDAPControl
           structures that list the client controls to use with this extended
           operation.
    
           The output parameter _retoidp_ points to a dotted-decimal OID string
           returned by the LDAP server.  The memory used by the string should
           be freed with the ldap_memfree(3) function.  The output parameter
           _retdatap_ points to a pointer to a berval structure that contains
           the returned data.  If no data is returned by the server, the
           pointer is set this to NULL.  The memory used by this structure
           should be freed with the ber_bvfree(3) function.
    
           The **ldap_extended_operation()** works just like
           **ldap_extended_operation_s()** , but the operation is asynchronous.
           It provides the message id of the request it initiated in the
           integer pointed to be _msgidp_.  The result of this operation can be
           obtained by calling ldap_result(3).
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# menu_post

## NAME



           **post_menu** , **unpost_menu** - write or erase menus from associated
           subwindows
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int post_menu(MENU ***_menu_**);**
           **int unpost_menu(MENU ***_menu_**);**
    


## DESCRIPTION



           The function **post_menu** displays a menu to its associated
           subwindow.  To trigger physical display of the subwindow, use
           **refresh**(3X) or some equivalent **curses** routine (the implicit
           **doupdate** triggered by an **curses** input request will do).  **post_menu**
           resets the selection status of all items.
    
           The function **unpost_menu** erases menu from its associated
           subwindow.
    


## RETURN VALUE



           These routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_POSTED**
                The menu has already been posted.
    
           **E_BAD_STATE**
                Routine was called from an initialization or termination
                function.
    
           **E_NO_ROOM**
                Menu is too large for its window.  You should consider using
                **set_menu_format** to solve the problem.
    
           **E_NOT_POSTED**
                The menu has not been posted.
    
           **E_NOT_CONNECTED**
                No items are connected to the menu.
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# geteuid

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



           geteuid — get the effective user ID
    


## SYNOPSIS



           #include <unistd.h>
    
           uid_t geteuid(void);
    


## DESCRIPTION



           The _geteuid_() function shall return the effective user ID of the
           calling process.  The _geteuid_() function shall not modify _errno_.
    


## RETURN VALUE



           The _geteuid_() function shall always be successful and no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           In a conforming environment, _geteuid_() will always succeed. It is
           possible for implementations to provide an extension where a
           process in a non-conforming environment will not be associated
           with a user or group ID. It is recommended that such
           implementations return (**uid_t**)-1 and set _errno_ to indicate such an
           environment; doing so does not violate this standard, since such
           an environment is already an extension.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# audit_set_rate_limit

## NAME



           audit_set_rate_limit - Set audit rate limit
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_rate_limit(int** _fd_**, uint32_t** _limit_**);"**
    


## DESCRIPTION



           audit_set_rate_limit will set the maximum number of messages that
           the kernel will send per second. This can be used to throttle the
           rate if systems become unresponsive. Of course the trade off is
           that events will be dropped. The _limit_ argument controls how many
           messages may be sent each second. The default value is 0, meaning
           no limit.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# gnutls_x509_crt_verify

## NAME



           gnutls_x509_crt_verify - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_verify(gnutls_x509_crt_t** _cert_**, const**
           **gnutls_x509_crt_t ***_CA_list_**, unsigned** _CA_list_length_**, unsigned int**
           _flags_**, unsigned int ***_verify_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       is the certificate to be verified
    
           const gnutls_x509_crt_t * CA_list
                       is one certificate that is considered to be trusted
                       one
    
           unsigned CA_list_length
                       holds the number of CA certificate in CA_list
    
           unsigned int flags
                       Flags that may be used to change the verification
                       algorithm. Use OR of the
                       gnutls_certificate_verify_flags enumerations.
    
           unsigned int * verify
                       will hold the certificate verification output.
    


## DESCRIPTION



           This function will try to verify the given certificate and return
           its status. Note that a verification error does not imply a
           negative return status. In that case the  _verify_ status is set.
    
           The details of the verification are the same as in
           **gnutls_x509_trust_list_verify_crt2()**.
    


## RETURNS



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


* * *
# function::task_utime

## NAME



           function::task_utime - User time of the task
    


## SYNOPSIS



           1) task_utime:long()
    
           2) task_utime:long(tid:long)
    


## ARGUMENTS



           _tid_
               Thread id of the given task
    


## DESCRIPTION



           1) Returns the user time of the current task in cputime. Does not
           include any time used by other tasks in this process, nor does it
           include any time of the children of this task.
    
           2) Returns the user time of the given task in cputime, or zero if
           the task doesn't exist. Does not include any time used by other
           tasks in this process, nor does it include any time of the
           children of this task.
    


* * *
# context_new

## NAME



           context_new, context_str, context_free, context_type_get,
           context_type_set, context_range_get,
           context_range_set,context_role_get, context_role_set,
           context_user_get, context_user_set - Routines to manipulate
           SELinux security contexts
    


## SYNOPSIS



           **#include <selinux/context.h>**
    
           **context_t context_new(const char ***_context_str_**);**
    
           **const char * context_str(context_t** _con_**);**
    
           **void context_free(context_t** _con_**);**
    
           **const char * context_type_get(context_t** _con_**);**
    
           **const char * context_range_get(context_t** _con_**);**
    
           **const char * context_role_get(context_t** _con_**);**
    
           **const char * context_user_get(context_t** _con_**);**
    
           **int context_type_set(context_t** _con_**, const char ***_type_**);**
    
           **int context_range_set(context_t** _con_**, const char ***_range_**);**
    
           **int context_role_set(context_t** _con_**, const char ***_role_**);**
    
           **int context_user_set(context_t** _con_**, const char ***_user_**);**
    


## DESCRIPTION



           These functions allow an application to manipulate the fields of a
           security context string without requiring it to know the format of
           the string.
    
           **context_new**() returns a new context initialized to a context
           string.
    
           **context_str**() returns a pointer to the string value of the
           **context_t** , valid until the next call to **context_str**() or
           **context_free**() for the same **context_t***.
    
           **context_free**() frees the storage used by a context.
    
           **context_type_get**(), **context_range_get**(), **context_role_get**(),
           **context_user_get**() get a pointer to the string value of a context
           component.
    
           **Note:** Values returned by the get functions are only valid until
           the next call to a set function or **context_free**() for the same
           **context_t** structure.
    
           **context_type_set**(), **context_range_set**(), **context_role_set**(),
           **context_user_set**() set a context component.
    


## RETURN VALUE



           On failure **context_*_set**() functions return non-zero and 0 on
           success.
    
           The other functions return NULL on failure and non-NULL on
           success.
    
           On failure _errno_ is set appropriately.
    


* * *
# probe::signal.check_ignored

## NAME



           probe::signal.check_ignored - Checking to see signal is ignored
    


## SYNOPSIS



           signal.check_ignored
    


## VALUES



           _pid_name_
               Name of the process receiving the signal
    
           _sig_
               The number of the signal
    
           _sig_name_
               A string representation of the signal
    
           _sig_pid_
               The PID of the process receiving the signal
    


* * *
# ungetwc

## NAME



           ungetwc - push back a wide character onto a FILE stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wint_t ungetwc(wint_t** _wc_**, FILE ***_stream_**);**
    


## DESCRIPTION



           The **ungetwc**() function is the wide-character equivalent of the
           ungetc(3) function.  It pushes back a wide character onto _stream_
           and returns it.
    
           If _wc_ is **WEOF** , it returns **WEOF**.  If _wc_ is an invalid wide
           character, it sets _errno_ to **EILSEQ** and returns **WEOF**.
    
           If _wc_ is a valid wide character, it is pushed back onto the stream
           and thus becomes available for future wide-character read
           operations.  The file-position indicator is decremented by one or
           more.  The end-of-file indicator is cleared.  The backing storage
           of the file is not affected.
    
           Note: _wc_ need not be the last wide-character read from the stream;
           it can be any other valid wide character.
    
           If the implementation supports multiple push-back operations in a
           row, the pushed-back wide characters will be read in reverse
           order; however, only one level of push-back is guaranteed.
    


## RETURN VALUE



           The **ungetwc**() function returns _wc_ when successful, or **WEOF** upon
           failure.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# function::task_stime

## NAME



           function::task_stime - System time of the task
    


## SYNOPSIS



           1) task_stime:long()
    
           2) task_stime:long(tid:long)
    


## ARGUMENTS



           _tid_
               Thread id of the given task
    


## DESCRIPTION



           1) Returns the system time of the current task in cputime. Does
           not include any time used by other tasks in this process, nor does
           it include any time of the children of this task.
    
           2) Returns the system time of the given task in cputime, or zero
           if the task doesn't exist. Does not include any time used by other
           tasks in this process, nor does it include any time of the
           children of this task.
    


* * *
# io_uring_sq_space_left

## NAME



           io_uring_sq_space_left - free space in the SQ ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **unsigned io_uring_sq_space_left(const struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The io_uring_sq_space_left(3) function returns how much space is
           left in the SQ ring belonging to the _ring_ param.
    


## RETURN VALUE



           Returns the number of availables entries in the SQ ring.
    


* * *
# function::u_register

## NAME



           function::u_register - Return the unsigned value of the named CPU
           register
    


## SYNOPSIS



               u_register:long(name:string)
    


## ARGUMENTS



           _name_
               Name of the register to return
    


## DESCRIPTION



           Same as register(name), except that if the register is 32 bits
           wide, it is zero-extended to 64 bits.
    


* * *
# log2

## NAME



           log2, log2f, log2l - base-2 logarithmic function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the base-2 logarithm of _x_.
    


## RETURN VALUE



           On success, these functions return the base-2 logarithm of _x_.
    
           For special cases, including where _x_ is 0, 1, negative, infinity,
           or NaN, see log(3).
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           For a discussion of the errors that can occur for these functions,
           see log(3).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# probe::nfs.proc.commit_done

## NAME



           probe::nfs.proc.commit_done - NFS client response to a commit RPC
           task
    


## SYNOPSIS



           nfs.proc.commit_done
    


## VALUES



           _status_
               result of last operation
    
           _server_ip_
               IP address of server
    
           _valid_
               fattr->valid, indicates which fields are valid
    
           _version_
               NFS version
    
           _prot_
               transfer protocol
    
           _count_
               number of bytes committed
    
           _timestamp_
               V4 timestamp, which is used for lease renewal
    


## DESCRIPTION



           Fires when a reply to a commit RPC task is received or some commit
           operation error occur (timeout or socket shutdown).
    


* * *
# pmigethandle

## NAME



           **pmiGetHandle** - define a handle for a metric-instance pair
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiGetHandle(const char ***_name_**, const char ***_instance_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **$**_handle_ **= pmiGetHandle($**_name_**, $**_instance_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiGetHandle** creates a handle for  a  given  metric
           and  instance.   The  handle  is  returned  as  the value from the
           **pmiGetHandle** call  and  can  be  used  in  subsequent  calls   to
           pmiPutValueHandle(3).
    
           The  metric's  _name_  should match one defined earlier in a call to
           pmiAddMetric(3).
    
           For singular metrics (those defined with  an  instance  domain  of
           **PM_INDOM_NULL**),  the  _instance_  should be NULL or an empty string,
           otherwise _instance_ should match the name of  an  instance  defined
           earlier  in  a call to pmiAddInstance(3) for the metric's instance
           domain.
    
           When combined with pmiPutValueHandle(3), the use of  handles  pro‐
           vide  a  performance improvement over the alternative lookup for a
           metric name and an instance name for each data value that  is  re‐
           quired for pmiPutValue(3).
    


## DIAGNOSTICS



           On  failure  **pmiGetHandle** returns  a  negative  value that can be
           turned into an error message by calling pmiErrStr(3).
    


* * *
# pthread_testcancel

## NAME



           pthread_testcancel - request delivery of any pending cancelation
           request
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **void pthread_testcancel(void);**
    


## DESCRIPTION



           Calling **pthread_testcancel**() creates a cancelation point within
           the calling thread, so that a thread that is otherwise executing
           code that contains no cancelation points will respond to a
           cancelation request.
    
           If cancelability is disabled (using pthread_setcancelstate(3)), or
           no cancelation request is pending, then a call to
           **pthread_testcancel**() has no effect.
    


## RETURN VALUE



           This function does not return a value.  If the calling thread is
           canceled as a consequence of a call to this function, then the
           function does not return.
    


## ERRORS



           This function always succeeds.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## EXAMPLES



           See pthread_cleanup_push(3).
    


* * *
# __ppc_yield

## NAME



           __ppc_yield, __ppc_mdoio, __ppc_mdoom - Hint the processor to
           release shared resources
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/platform/ppc.h>**
    
           **void __ppc_yield(void);**
           **void __ppc_mdoio(void);**
           **void __ppc_mdoom(void);**
    


## DESCRIPTION



           These functions provide hints about the usage of resources that
           are shared with other processors on the Power architecture.  They
           can be used, for example, if a program waiting on a lock intends
           to divert the shared resources to be used by other processors.
    
           **__ppc_yield**() provides a hint that performance will probably be
           improved if shared resources dedicated to the executing processor
           are released for use by other processors.
    
           **__ppc_mdoio**() provides a hint that performance will probably be
           improved if shared resources dedicated to the executing processor
           are released until all outstanding storage accesses to caching-
           inhibited storage have been completed.
    
           **__ppc_mdoom**() provides a hint that performance will probably be
           improved if shared resources dedicated to the executing processor
           are released until all outstanding storage accesses to cacheable
           storage for which the data is not in the cache have been
           completed.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


* * *
# libpfm_intel_icx_unc_iio

## NAME



           libpfm_intel_icx_unc_iio - support for Intel IcelakeX Server IIO
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_iio[0-5]**
           **PMU desc: Intel IcelakeX IIO uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX IIO (I/O controller)
           uncore PMU.  Each IIO PMU implements 4 generic counters and free
           running counters (not yet supported by libpfm4).  The current
           version of libpfm4 does not expose the **fc_mask** and **ch_mask** filter
           because these are hardcoded in the events provided by the library.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX IIO 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 IIO 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.
    


* * *
# uuid_clear

## NAME



           uuid_clear - reset value of UUID variable to the NULL value
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **void uuid_clear(uuid_t** _uu_**);**
    


## DESCRIPTION



           The **uuid_clear**() function sets the value of the supplied uuid
           variable _uu_ to the NULL value.
    


## AVAILABILITY



           The **libuuid** library is part of the util-linux package since
           version 2.15.1. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                  _UUID_CLEAR_(3)
    


* * *
# gnutls_x509_crt_set_policy

## NAME



           gnutls_x509_crt_set_policy - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t crt
                       should contain a **gnutls_x509_crt_t** type
    
           const struct gnutls_x509_policy_st * policy
                       A pointer to a policy
    
           unsigned int critical
                       use non-zero if the extension is marked as critical
    


## DESCRIPTION



           This function will set the certificate policy extension
           (2.5.29.32).  Multiple calls to this function append a new policy.
    
           Note the maximum text size for the qualifier
           **GNUTLS_X509_QUALIFIER_NOTICE** is 200 characters. This function will
           fail with **GNUTLS_E_INVALID_REQUEST** if this is exceeded.
    


## RETURNS



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


## SINCE



           3.1.5
    


* * *
# macro::json_output_numeric_value

## NAME



           macro::json_output_numeric_value - Output a numeric value.
    


## SYNOPSIS



               @json_output_numeric_value(name,value)
    


## ARGUMENTS



           _name_
               The name of the numeric metric.
    
           _value_
               The numeric value to output.
    


## DESCRIPTION



           The json_output_numeric_value macro is designed to be called from
           the 'json_data' probe in the user's script to output a metric's
           numeric value. This metric should have been added with
           **json_add_numeric_metric**.
    


* * *
# gnutls_pcert_list_import_x509_file

## NAME



           gnutls_pcert_list_import_x509_file - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pcert_list_import_x509_file(gnutls_pcert_st ***
           _pcert_list_**, unsigned ***_pcert_list_size_**, const char ***_file_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_pin_callback_t** _pin_fn_**, void ***
           _pin_fn_userdata_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert_list
                       The structures to store the certificates; must not
                       contain initialized **gnutls_pcert_st** structures.
    
           unsigned * pcert_list_size
                       Initially must hold the maximum number of certs. It
                       will be updated with the number of certs available.
    
           const char * file
                       A file or supported URI with the certificates to load
    
           gnutls_x509_crt_fmt_t format
                       **GNUTLS_X509_FMT_DER** or **GNUTLS_X509_FMT_PEM** if a file
                       is given
    
           gnutls_pin_callback_t pin_fn
                       a PIN callback if not globally set
    
           void * pin_fn_userdata
                       parameter for the PIN callback
    
           unsigned int flags
                       zero or flags from **gnutls_certificate_import_flags**
    


## DESCRIPTION



           This convenience function will import a certificate chain from the
           given file or supported URI to **gnutls_pcert_st** structures. The
           structures must be deinitialized afterwards using
           **gnutls_pcert_deinit()**.
    
           This function will always return a sorted certificate chain.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value; if the  _pcert_ list doesn't have enough space
           **GNUTLS_E_SHORT_MEMORY_BUFFER** will be returned.
    


## SINCE



           3.6.3
    


* * *
# gnutls_dh_params_deinit

## NAME



           gnutls_dh_params_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_dh_params_deinit(gnutls_dh_params_t** _dh_params_**);**
    


## ARGUMENTS



           gnutls_dh_params_t dh_params
                       The parameters
    


## DESCRIPTION



           This function will deinitialize the DH parameters type.
    


* * *
# gnutls_ocsp_resp_verify

## NAME



           gnutls_ocsp_resp_verify - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_verify(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_x509_trust_list_t** _trustlist_**, unsigned int ***_verify_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           gnutls_x509_trust_list_t trustlist
                       trust anchors as a **gnutls_x509_trust_list_t** type
    
           unsigned int * verify
                       output variable with verification status, an
                       **gnutls_ocsp_verify_reason_t**
    
           unsigned int flags
                       verification flags from
                       **gnutls_certificate_verify_flags**
    


## DESCRIPTION



           Verify signature of the Basic OCSP Response against the public key
           in the certificate of a trusted signer.  The  _trustlist_ should be
           populated with trust anchors.  The function will extract the
           signer certificate from the Basic OCSP Response and will verify it
           against the  _trustlist_ .  A trusted signer is a certificate that
           is either in  _trustlist_ , or it is signed directly by a
           certificate in
            _trustlist_ and has the id-ad-ocspSigning Extended Key Usage bit
           set.
    
           The output  _verify_ variable will hold verification status codes
           (e.g., **GNUTLS_OCSP_VERIFY_SIGNER_NOT_FOUND** ,
           **GNUTLS_OCSP_VERIFY_INSECURE_ALGORITHM**) which are only valid if the
           function returned **GNUTLS_E_SUCCESS**.
    
           Note that the function returns **GNUTLS_E_SUCCESS** even when
           verification failed.  The caller must always inspect the  _verify_
           variable to find out the verification status.
    
           The  _flags_ variable should be 0 for now.
    


## RETURNS



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


* * *
# wcsncmp

## NAME



           wcsncmp - compare two fixed-size wide-character strings
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **int wcsncmp(** size_t n;
                       **const wchar_t** _s1_**[**_n_**], const wchar_t** _s2_**[**_n_**], size_t** _n_**);**
    


## DESCRIPTION



           The **wcsncmp**() function is the wide-character equivalent of the
           strncmp(3) function.  It compares the wide-character string
           pointed to by _s1_ and the wide-character string pointed to by _s2_ ,
           but at most _n_ wide characters from each string.  In each string,
           the comparison extends only up to the first occurrence of a null
           wide character (L'\0'), if any.
    


## RETURN VALUE



           The **wcsncmp**() function returns zero if the wide-character strings
           at _s1_ and _s2_ , truncated to at most length _n_ , are equal.  It
           returns an integer greater than zero if at the first differing
           position _i_ (_i_ < _n_), 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_ (_i_ < _n_), 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** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **wcsncmp**()                            │ Thread safety │ MT-Safe │
           └──────────────────────────────────────┴───────────────┴─────────┘
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ibv_create_wq

## NAME



           ibv_create_wq, ibv_destroy_wq - create or destroy a Work Queue
           (WQ).
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_wq *ibv_create_wq(struct ibv_context** _*context,_
                                                **struct ibv_wq_init_attr** _*wq_init_attr_**);**
    
           **int ibv_destroy_wq(struct ibv_wq** _*wq_**);**
    


## DESCRIPTION



           **ibv_create_wq()** creates a WQ associated with the ibv_context
           _context_.  The argument _wq_init_attr_ is an ibv_wq_init_attr struct,
           as defined in <infiniband/verbs.h>.
    
           struct ibv_wq_init_attr {
                   void                      *wq_context;    /* Associated context of the WQ */
                   enum ibv_wq_type           wq_type;       /* WQ type */
                   uint32_t                   max_wr;        /* Requested max number of outstanding WRs in the WQ */
                   uint32_t                   max_sge;       /* Requested max number of scatter/gather (s/g) elements per WR in the WQ */
                   struct  ibv_pd            *pd;            /* PD to be associated with the WQ */
                   struct  ibv_cq            *cq;            /* CQ to be associated with the WQ */
                   uint32_t                   comp_mask;     /* Identifies valid fields. Use ibv_wq_init_attr_mask */
                   uint32_t                   create_flags    /* Creation flags for this WQ, use enum ibv_wq_flags */
           };
    
           enum ibv_wq_flags {
                   IBV_WQ_FLAGS_CVLAN_STRIPPING            = 1 << 0, /* CVLAN field will be stripped from incoming packets */
                   IBV_WQ_FLAGS_SCATTER_FCS                = 1 << 1, /* FCS field will be scattered to host memory */
                   IBV_WQ_FLAGS_DELAY_DROP                 = 1 << 2, /* Packets won't be dropped immediately if no receive WQEs */
                   IBV_WQ_FLAGS_PCI_WRITE_END_PADDING      = 1 << 3, /* Incoming packets will be padded to cacheline size */
                   IBV_WQ_FLAGS_RESERVED                   = 1 << 4,
           };
    
           The function **ibv_create_wq()** will update the _wq_init_attr_ ->max_wr
           and _wq_init_attr_ ->max_sge fields with the actual WQ values of the
           WQ that was created; the values will be greater than or equal to
           the values requested.
    
           **ibv_destroy_wq()** destroys the WQ _wq_.
    


## RETURN VALUE



           **ibv_create_wq()** returns a pointer to the created WQ, or NULL if
           the request fails.
    
           **ibv_destroy_wq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


* * *
# cexp2

## NAME



           cexp2, cexp2f, cexp2l - base-2 exponent of a complex number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cexp2(double complex** _z_**);**
           **float complex cexp2f(float complex** _z_**);**
           **long double complex cexp2l(long double complex** _z_**);**
    


## DESCRIPTION



           The function returns 2 raised to the power of _z_.
    


## STANDARDS



           These function names are reserved for future use in C99.
    
           As at glibc 2.31, these functions are not provided in glibc.
    


* * *
# gnutls_session_get_id2

## NAME



           gnutls_session_get_id2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_get_id2(gnutls_session_t** _session_**,**
           **gnutls_datum_t ***_session_id_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * session_id
                       will point to the session ID.
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.1.4
    


* * *
# gnutls_session_get_desc

## NAME



           gnutls_session_get_desc - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **char * gnutls_session_get_desc(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function returns a string describing the current session.
           The string is null terminated and allocated using **gnutls_malloc()**.
    
           If initial negotiation is not complete when this function is
           called, **NULL** will be returned.
    


## RETURNS



           a description of the protocols and algorithms in the current
           session.
    


## SINCE



           3.1.10
    


* * *