tripathysagar/man_text huggingface dataset:
# udev_list_entry

## NAME



           udev_list_entry, udev_list_entry_get_next,
           udev_list_entry_get_by_name, udev_list_entry_get_name,
           udev_list_entry_get_value - Iterate and access udev lists
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **struct udev_list_entry**
                                                            ***udev_list_entry_get_next(struct udev_list_entry ***_list_entry_**);**
    
           **struct udev_list_entry**
                                                               ***udev_list_entry_get_by_name(struct udev_list_entry ***_list_entry_**,**
                                                               **const char ***_name_**);**
    
           **const char**
                                                ***udev_list_entry_get_name(struct udev_list_entry ***_list_entry_**);**
    
           **const char**
                                                 ***udev_list_entry_get_value(struct udev_list_entry ***_list_entry_**);**
    


## RETURN VALUE



           On success, **udev_list_entry_get_next()** and
           **udev_list_entry_get_by_name()** return a pointer to the requested
           list entry. If no such entry can be found, or on failure, **NULL** is
           returned.
    
           On success, **udev_list_entry_get_name()** and
           **udev_list_entry_get_value()** return a pointer to a constant string
           representing the requested value. The string is bound to the
           lifetime of the list entry itself. On failure, **NULL** is returned.
    


* * *
# io_uring_major_version

## NAME



           io_uring_check_version - functions and macros to check the
           liburing version
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **bool io_uring_check_version(int** _major_**, int** _minor_**);**
           **IO_URING_CHECK_VERSION(**_major_**,**_minor_**);**
    
           **int io_uring_major_version(void);**
           **IO_URING_VERSION_MAJOR;**
    
           **int io_uring_minor_version(void);**
           **IO_URING_VERSION_MINOR;**
    


## DESCRIPTION



           The io_uring_check_version(3) function returns _false_ if the
           liburing library loaded by the dynamic linker is greater-than or
           equal-to the _major_ and _minor_ numbers provided.
    
           The IO_URING_CHECK_VERSION(3) macro returns _0_ if the liburing
           library being compiled against is greater-than or equal-to the
           _major_ and _minor_ numbers provided.
    
           The io_uring_major_version(3) function returns the _major_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MAJOR(3) macro returns the _major_ version
           number of the liburing library being compiled against.
    
           The io_uring_minor_version(3) function returns the _minor_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MINOR(3) macro returns the _minor_ version
           number of the liburing library being compiled against.
    


* * *
# pam_misc_drop_env

## NAME



           pam_misc_drop_env - liberating a locally saved environment
    


## SYNOPSIS



           **#include <security/pam_misc.h>**
    
           **int pam_misc_drop_env(char ****_env_**);**
    


## DESCRIPTION



           This function is defined to complement the pam_getenvlist(3)
           function. It liberates the memory associated with _env_ , _overwriting_
           with _0_ all memory before **free()** ing it.
    


## STANDARDS



           The **pam_misc_drop_env** function is part of the **libpam_misc** Library
           and not defined in any standard.
    


* * *
# function::task_pid

## NAME



           function::task_pid - The process identifier of the task
    


## SYNOPSIS



               task_pid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This fucntion returns the process id of the given task.
    


* * *
# gnutls_priority_cipher_list

## NAME



           gnutls_priority_cipher_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_cipher_list(gnutls_priority_t** _pcache_**, const**
           **unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available ciphers in the priority structure.
    


## RETURNS



           the number of items, or an error code.
    


## SINCE



           3.2.3
    


* * *
# feof

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



           feof — test end-of-file indicator on a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int feof(FILE *_stream_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _feof_() function shall test the end-of-file indicator for the
           stream pointed to by _stream_.
    
           The _feof_() function shall not change the setting of _errno_ if
           _stream_ is valid.
    


## RETURN VALUE



           The _feof_() function shall return non-zero if and only if the end-
           of-file indicator is set for _stream_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# strncmp

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



           strncmp — compare part of two strings
    


## SYNOPSIS



           #include <string.h>
    
           int strncmp(const char *_s1_ , const char *_s2_ , size_t _n_);
    


## 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 _strncmp_() function shall compare not more than _n_ bytes (bytes
           that follow a NUL character are not compared) from the array
           pointed to by _s1_ to the array pointed to by _s2_.
    
           The sign of a non-zero return value is determined by the sign of
           the difference between the values of the first pair of bytes (both
           interpreted as type **unsigned char**) that differ in the strings
           being compared.
    


## RETURN VALUE



           Upon successful completion, _strncmp_() shall return an integer
           greater than, equal to, or less than 0, if the possibly null-
           terminated array pointed to by _s1_ is greater than, equal to, or
           less than the possibly null-terminated array pointed to by _s2_
           respectively.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::qs_run

## NAME



           function::qs_run - Function to record being moved from wait queue
           to being serviced
    


## SYNOPSIS



               qs_run(qname:string)
    


## ARGUMENTS



           _qname_
               the name of the service being moved and started
    


## DESCRIPTION



           This function records that the previous enqueued request was
           removed from the given wait queue and is now being serviced.
    


* * *
# fesetenv

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



           fesetenv — set current floating-point environment
    


## SYNOPSIS



           #include <fenv.h>
    
           int fesetenv(const fenv_t *_envp_);
    


## DESCRIPTION



           Refer to fegetenv(3p).
    


* * *
# pam_getenv

## NAME



           pam_getenv - get a PAM environment variable
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **const char *pam_getenv(pam_handle_t ***_pamh_**, const char ***_name_**);**
    


## DESCRIPTION



           The **pam_getenv** function searches the PAM environment list as
           associated with the handle _pamh_ for an item that matches the
           string pointed to by _name_ and returns a pointer to the value of
           the environment variable. The application is not allowed to free
           the data.
    


## RETURN VALUES



           The **pam_getenv** function returns NULL on failure.
    


* * *
# tapset::pstrace

## NAME



           tapset::pstrace - systemtap pstrace tapset
    


## DESCRIPTION



           **pstrace**
                  Chain of processes and pids back to init(1)
    
                  See function::pstrace(3stap)
                   for details.
    


* * *
# strstr

## NAME



           strstr, strcasestr - locate a substring
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **char *strstr(const char ***_haystack_**, const char ***_needle_**);**
    
           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <string.h>**
    
           **char *strcasestr(const char ***_haystack_**, const char ***_needle_**);**
    


## DESCRIPTION



           The **strstr**() function finds the first occurrence of the substring
           _needle_ in the string _haystack_.  The terminating null bytes ('\0')
           are not compared.
    
           The **strcasestr**() function is like **strstr**(), but ignores the case
           of both arguments.
    


## RETURN VALUE



           These functions return a pointer to the beginning of the located
           substring, or NULL if the substring is not found.
    
           If _needle_ is the empty string, the return value is always _haystack_
           itself.
    


## ATTRIBUTES



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


## STANDARDS



           **strstr**()
                  C11, POSIX.1-2008.
    
           **strcasestr**()
                  GNU.
    


* * *
# probe::ipmib.ForwDatagrams

## NAME



           probe::ipmib.ForwDatagrams - Count forwarded packet
    


## SYNOPSIS



           ipmib.ForwDatagrams
    


## VALUES



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


## DESCRIPTION



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


* * *
# probe::stap.pass1.end

## NAME



           probe::stap.pass1.end - Finished stap pass1 (parsing scripts)
    


## SYNOPSIS



           stap.pass1.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass1.end fires just before the jump to cleanup if s.last_pass =
           1.
    


* * *
# tapset::dev

## NAME



           tapset::dev - systemtap dev tapset
    


## DESCRIPTION



           **MAJOR** Extract major device number from a kernel device number
                  (kdev_t)
    
                  See function::MAJOR(3stap)
                   for details.
    
           **MINOR** Extract minor device number from a kernel device number
                  (kdev_t)
    
                  See function::MINOR(3stap)
                   for details.
    
           **MKDEF** Creates a value that can be compared to a kernel device
                  number (kdev_t)
    
                  See function::MKDEF(3stap)
                   for details.
    
           **usrdev2kerndev**
                  Converts a user-space device number into the format used in
                  the kernel
    
                  See function::usrdev2kerndev(3stap)
                   for details.
    


* * *
# gnutls_session_get_ptr

## NAME



           gnutls_session_get_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void * gnutls_session_get_ptr(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get user pointer for session.  Useful in callbacks.  This is the
           pointer set with **gnutls_session_set_ptr()**.
    


## RETURNS



           the user given pointer from the session structure, or **NULL** if it
           was never set.
    


* * *
# gnutls_crypto_register_mac

## NAME



           gnutls_crypto_register_mac - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_crypto_register_mac(gnutls_mac_algorithm_t** _algorithm_**,**
           **int** _priority_**, gnutls_mac_init_func** _init_**, gnutls_mac_setkey_func**
           _setkey_**, gnutls_mac_setnonce_func** _setnonce_**, gnutls_mac_hash_func**
           _hash_**, gnutls_mac_output_func** _output_**, gnutls_mac_deinit_func**
           _deinit_**, gnutls_mac_fast_func** _hash_fast_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       is the gnutls MAC identifier
    
           int priority
                       is the priority of the algorithm
    
           gnutls_mac_init_func init
                       A function which initializes the MAC
    
           gnutls_mac_setkey_func setkey
                       A function which sets the key of the MAC
    
           gnutls_mac_setnonce_func setnonce
                       A function which sets the nonce for the mac (may be
                       **NULL** for common MAC algorithms)
    
           gnutls_mac_hash_func hash
                       Perform the hash operation
    
           gnutls_mac_output_func output
                       Provide the output of the MAC
    
           gnutls_mac_deinit_func deinit
                       A function which deinitializes the MAC
    
           gnutls_mac_fast_func hash_fast
                       Perform the MAC operation in one go
    


## DESCRIPTION



           This function will register a MAC algorithm to be used by gnutls.
           Any algorithm registered will override the included algorithms and
           by convention kernel implemented algorithms have priority of 90
           and CPU-assisted of 80.  The algorithm with the lowest priority
           will be used by gnutls.
    


## DEPRECATED



           since 3.7.0 it is no longer possible to override cipher
           implementation
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.4.0
    


* * *
# probe::nfs.proc.open

## NAME



           probe::nfs.proc.open - NFS client allocates file read/write
           context information
    


## SYNOPSIS



           nfs.proc.open
    


## VALUES



           _server_ip_
               IP address of server
    
           _filename_
               file name
    
           _flag_
               file flag
    
           _prot_
               transfer protocol
    
           _mode_
               file mode
    
           _version_
               NFS version (the function is used for all NFS version)
    


## DESCRIPTION



           Allocate file read/write context information
    


* * *
# probe::nfsd.proc.read

## NAME



           probe::nfsd.proc.read - NFS server reading file for client
    


## SYNOPSIS



           nfsd.proc.read
    


## VALUES



           _vec_
               struct kvec, includes buf address in kernel address and length
               of each buffer
    
           _size_
               read bytes
    
           _offset_
               the offset of file
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _proto_
               transfer protocol
    
           _version_
               nfs version
    
           _client_ip_
               the ip address of client
    
           _count_
               read bytes
    
           _gid_
               requester's group id
    
           _vlen_
               read blocks
    
           _uid_
               requester's user id
    


* * *
# wmemcmp

## NAME



           wmemcmp - compare two arrays of wide-characters
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **wmemcmp**() function is the wide-character equivalent of the
           memcmp(3) function.  It compares the _n_ wide-characters starting at
           _s1_ and the _n_ wide-characters starting at _s2_.
    


## RETURN VALUE



           The **wmemcmp**() function returns zero if the wide-character arrays
           of size _n_ at _s1_ and _s2_ 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** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **wmemcmp**()                            │ Thread safety │ MT-Safe │
           └──────────────────────────────────────┴───────────────┴─────────┘
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# rdma_create_id

## NAME



           rdma_create_id - Allocate a communication identifier.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_create_id (struct rdma_event_channel ***_channel_**, struct**
           **rdma_cm_id ****_id_**, void ***_context_**, enum rdma_port_space** _ps_**);**
    


## ARGUMENTS



           channel     The communication channel that events associated with
                       the allocated rdma_cm_id will be reported on.  This
                       may be NULL.
    
           id          A reference where the allocated communication
                       identifier will be returned.
    
           context     User specified context associated with the rdma_cm_id.
    
           ps          RDMA port space.
    


## DESCRIPTION



           Creates an identifier that is used to track communication
           information.
    


## RETURN VALUE



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


## NOTES



           Rdma_cm_id's are conceptually equivalent to a socket for RDMA
           communication.  The difference is that RDMA communication requires
           explicitly binding to a specified RDMA device before communication
           can occur, and most operations are asynchronous in nature.
           Asynchronous communication events on an rdma_cm_id are reported
           through the associated event channel.  If the channel parameter is
           NULL, the rdma_cm_id will be placed into synchronous operation.
           While operating synchronously, calls that result in an event will
           block until the operation completes.  The event will be returned
           to the user through the rdma_cm_id structure, and be available for
           access until another rdma_cm call is made.
    
           Users must release the rdma_cm_id by calling rdma_destroy_id.
    


## PORT SPACE



           Details of the services provided by the different port spaces are
           outlined below.
    
           RDMA_PS_TCP
                  Provides reliable, connection-oriented QP communication.
                  Unlike TCP, the RDMA port space provides message, not
                  stream, based communication.
    
           RDMA_PS_UDP
                  Provides unreliable, connectionless QP communication.
                  Supports both datagram and multicast communication.
    
           RDMA_PS_IB
                  Provides for any IB services (UD, UC, RC, XRC, etc.).
    


* * *
# function::print_backtrace

## NAME



           function::print_backtrace - Print kernel stack back trace
    


## SYNOPSIS



               print_backtrace()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function is equivalent to print_stack(**backtrace**), except that
           deeper stack nesting may be supported. See print_ubacktrace for
           user-space backtrace. The function does not return a value.
    


* * *
# gnutls_session_set_id

## NAME



           gnutls_session_set_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_set_id(gnutls_session_t** _session_**, const**
           **gnutls_datum_t ***_sid_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const gnutls_datum_t * sid
                       the session identifier
    


## DESCRIPTION



           This function sets the session ID to be used in a client hello.
           This is a function intended for exceptional uses. Do not use this
           function unless you are implementing a custom protocol.
    
           To set session resumption parameters use **gnutls_session_set_data()**
           instead.
    


## RETURNS



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


## SINCE



           3.2.1
    


* * *
# gnutls_ocsp_req_get_version

## NAME



           gnutls_ocsp_req_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_get_version(gnutls_ocsp_req_const_t** _req_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_const_t req
                       should contain a **gnutls_ocsp_req_t** type
    


## DESCRIPTION



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


## RETURNS



           version of OCSP request, or a negative error code on error.
    


* * *
# sinl

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



           sinl — sine function
    


## SYNOPSIS



           #include <math.h>
    
           long double sinl(long double _x_);
    


## DESCRIPTION



           Refer to sin(3p).
    


* * *
# pmsemstr

## NAME



           **pmSemStr** , **pmSemStr_r** - convert a performance metric semantic into
           a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmSemStr(int** _sem_**);**
           **char *pmSemStr_r(int** _sem_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Given  a  performance  metric  _semantic_ , **pmSemStr** produces a terse
           ASCII equivalent, appropriate for use in error and diagnostic mes‐
           sages.  The **pmSemStr_r** function does the same, but stores the  re‐
           sult  in a user-supplied buffer _buf_ of length _buflen_ , which should
           have room for at least 20 bytes.
    
           The value for _sem_ is typically extracted from a _pmDesc_  structure,
           following  a  call to pmLookupDesc(3) for a particular performance
           metric.
    
           Examples are **counter**(for  _sem_  equals  **PM_SEM_COUNTER**),  **discrete**
           (for   _sem_   equals  **PM_SEM_DISCRETE**),  **instant**(for  _sem_  equals
           **PM_SEM_INSTANT**), etc.
    


## NOTES



           Both of these routines are safe to  call  from  threaded  applica‐
           tions.
    


* * *
# wint_t

## NAME



           wint_t, WEOF - integer type capable of storing any wchar_t of WEOF
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **typedef** /* ... */  **wint_t;**
    
           **#define WEOF** /* ... */
    
           **#include <stdint.h>**
    
           **#define WINT_WIDTH** /* ... */
           **#define WINT_MAX** /* ... */
           **#define WINT_MIN** /* ... */
    


## DESCRIPTION



           _wint_t_ is a type used in functions that work with wide characters.
           It is capable of storing any valid wchar_t or WEOF.  It is an
           integer type.
    
           **WEOF** is used by wide-character functions to indicate the end of an
           input file or an error.  It is of type _wint_t_.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following header also provides _wint_t_ and **WEOF** : _< wctype.h>_.
    


* * *
# pthread_mutex_setprioceiling

## PROLOG



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


## NAME



           pthread_mutex_setprioceiling — change the priority ceiling of a
           mutex (**REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutex_setprioceiling(pthread_mutex_t *restrict _mutex_ ,
               int _prioceiling_ , int *restrict _old_ceiling_);
    


## DESCRIPTION



           Refer to pthread_mutex_getprioceiling(3p).
    


* * *
# function::stack_unused

## NAME



           function::stack_unused - Returns the amount of kernel stack
           currently available
    


## SYNOPSIS



               stack_unused:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function determines how many bytes are currently available in
           the kernel stack.
    


* * *
# gnutls_x509_crq_set_attribute_by_oid

## NAME



           gnutls_x509_crq_set_attribute_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_attribute_by_oid(gnutls_x509_crq_t** _crq_**,**
           **const char ***_oid_**, void ***_buf_**, size_t** _buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * oid
                       holds an Object Identifier in a null-terminated string
    
           void * buf  a pointer to a structure that holds the attribute data
    
           size_t buf_size
                       holds the size of  _buf_
    


## DESCRIPTION



           This function will set the attribute in the certificate request
           specified by the given Object ID. The provided attribute must be
           be DER encoded.
    
           Attributes in a certificate request is an optional set of data
           appended to the request. Their interpretation depends on the CA
           policy.
    


## RETURNS



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


* * *
# pthread_mutexattr_init

## NAME



           pthread_mutexattr_init, pthread_mutexattr_destroy - initialize and
           destroy a mutex attributes object
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **int pthread_mutexattr_init(pthread_mutexattr_t ***_attr_**);**
           **int pthread_mutexattr_destroy(pthread_mutexattr_t ***_attr_**);**
    


## DESCRIPTION



           The **pthread_mutexattr_init**() function initializes the mutex
           attributes object pointed to by _attr_ with default values for all
           attributes defined by the implementation.
    
           The results of initializing an already initialized mutex
           attributes object are undefined.
    
           The **pthread_mutexattr_destroy**() function destroys a mutex
           attribute object (making it uninitialized).  Once a mutex
           attributes object has been destroyed, it can be reinitialized with
           **pthread_mutexattr_init**().
    
           The results of destroying an uninitialized mutex attributes object
           are undefined.
    


## RETURN VALUE



           On success, these functions return 0.  On error, they return a
           positive error number.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           Subsequent changes to a mutex attributes object do not affect
           mutex that have already been initialized using that object.
    


* * *
# round

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



           round, roundf, roundl — round to the nearest integer value in a
           floating-point format
    


## SYNOPSIS



           #include <math.h>
    
           double round(double _x_);
           float roundf(float _x_);
           long double roundl(long double _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.
    
           These functions shall round their argument to the nearest integer
           value in floating-point format, rounding halfway cases away from
           zero, regardless of the current rounding direction.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           rounded integer value.  The result shall have the same sign as _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0 or ±Inf, _x_ shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The integral value returned by these functions need not be
           expressible as an **intmax_t**.  The return value should be tested
           before assigning it to an integer type to avoid the undefined
           results of an integer overflow.
    
           These functions may raise the inexact floating-point exception if
           the result differs in value from the argument.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_rnd

## NAME



           gnutls_rnd - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_rnd(gnutls_rnd_level_t** _level_**, void ***_data_**, size_t** _len_**);**
    


## ARGUMENTS



           gnutls_rnd_level_t level
                       a security level
    
           void * data place to store random bytes
    
           size_t len  The requested size
    


## DESCRIPTION



           This function will generate random data and store it to output
           buffer. The value of  _level_ should be one of **GNUTLS_RND_NONCE** ,
           **GNUTLS_RND_RANDOM** and **GNUTLS_RND_KEY**. See the manual and
           **gnutls_rnd_level_t** for detailed information.
    
           This function is thread-safe and also fork-safe.
    


## RETURNS



           Zero on success, or a negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# tapset::context-caller

## NAME



           tapset::context-caller - systemtap context-caller tapset
    


## DESCRIPTION



            Provides caller and caller_addr function for context for kernel
           and user
            space.
    
           **callers**
                  Return first n elements of kernel stack backtrace
    
                  See function::callers(3stap)
                   for details.
    
           **caller** Return name and address of calling function
    
                  See function::caller(3stap)
                   for details.
    
           **caller_addr**
                  Return caller address
    
                  See function::caller_addr(3stap)
                   for details.
    


* * *
# intmax_t

## NAME



           intmax_t, uintmax_t - greatest-width basic integer types
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdint.h>**
    
           **typedef** /* ... */ **intmax_t;**
           **typedef** /* ... */ **uintmax_t;**
    
           **#define INTMAX_WIDTH** /* ... */
           **#define UINTMAX_WIDTH INTMAX_WIDTH**
    
           **#define INTMAX_MAX** /*  2**(INTMAX_WIDTH - 1) - 1  */
           **#define INTMAX_MIN** /*  - 2**(INTMAX_WIDTH - 1)    */
           **#define UINTMAX_MAX** /*  2**UINTMAX_WIDTH - 1       */
    
           **#define INTMAX_C(**_c_**)**_c_ **##** /* ... */
           **#define UINTMAX_C(**_c_**)**_c_ **##** /* ... */
    


## DESCRIPTION



           _intmax_t_ is a signed integer type capable of representing any
           value of any basic signed integer type supported by the
           implementation.  It is capable of storing values in the range
           [**INTMAX_MIN** , **INTMAX_MAX**].
    
           _uintmax_t_ is an unsigned integer type capable of representing any
           value of any basic unsigned integer type supported by the
           implementation.  It is capable of storing values in the range [**0** ,
           **UINTMAX_MAX**].
    
           The macros [**U**]**INTMAX_WIDTH** expand to the width in bits of these
           types.
    
           The macros [**U**]**INTMAX_MAX** expand to the maximum value that these
           types can hold.
    
           The macro **INTMAX_MIN** expands to the minimum value that _intmax_t_
           can hold.
    
           The macros [**U**]**INTMAX_C**() expand their argument to an integer
           constant of type [_u_]_intmax_t_.
    
           The length modifier for [_u_]_intmax_t_ for the printf(3) and the
           scanf(3) families of functions is **j** ; resulting commonly in **%jd** ,
           **%ji** , **%ju** , or **%jx** for printing [_u_]_intmax_t_ values.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following header also provides these types: _< inttypes.h>_.
    


## BUGS



           These types may not be as large as extended integer types, such as
           ___int128_
    


* * *
# tapset::kprocess

## NAME



           tapset::kprocess - systemtap kprocess tapset
    


## DESCRIPTION



             This family of probe points is used to probe process-related
           activities.
    
           **kprocess.create**
                  Fires whenever a new process or thread is successfully
                  created
    
                   See probe::kprocess.create(3stap)
                   for details.
    
           **kprocess.start**
                  Starting new process
    
                   See probe::kprocess.start(3stap)
                   for details.
    
           **kprocess.exec**
                  Attempt to exec to a new program
    
                   See probe::kprocess.exec(3stap)
                   for details.
    
           **kprocess.exec_complete**
                  Return from exec to a new program
    
                   See probe::kprocess.exec_complete(3stap)
                   for details.
    
           **kprocess.exit**
                  Exit from process
    
                   See probe::kprocess.exit(3stap)
                   for details.
    
           **kprocess.release**
                  Process released
    
                   See probe::kprocess.release(3stap)
                   for details.
    


* * *
# macro::json_output_data_start

## NAME



           macro::json_output_data_start - Start the json output.
    


## SYNOPSIS



               @json_output_data_start()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           The json_output_data_start macro is designed to be called from the
           'json_data' probe from the user's script. It marks the start of
           the JSON output.
    


* * *
# probe::ipmib.InDiscards

## NAME



           probe::ipmib.InDiscards - Count discarded inbound packets
    


## SYNOPSIS



           ipmib.InDiscards
    


## VALUES



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


## DESCRIPTION



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


* * *
# log

## NAME



           log, logf, logl - natural logarithmic function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the natural logarithm of _x_.
    


## RETURN VALUE



           On success, these functions return the natural logarithm of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is 1, the result is +0.
    
           If _x_ is positive infinity, positive infinity 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 (including negative infinity), then a domain
           error occurs, and a NaN (not a number) is returned.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x_ is negative
                  _errno_ is set to **EDOM**.  An invalid floating-point exception
                  (**FE_INVALID**) is raised.
    
           Pole error: _x_ is zero
                  _errno_ is set to **ERANGE**.  A divide-by-zero floating-point
                  exception (**FE_DIVBYZERO**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           In glibc 2.5 and earlier, taking the **log**() of a NaN produces a
           bogus invalid floating-point (**FE_INVALID**) exception.
    


* * *
# getsid

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



           getsid — get the process group ID of a session leader
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t getsid(pid_t _pid_);
    


## DESCRIPTION



           The _getsid_() function shall obtain the process group ID of the
           process that is the session leader of the process specified by
           _pid_.  If _pid_ is (**pid_t**)0, it specifies the calling process.
    


## RETURN VALUE



           Upon successful completion, _getsid_() shall return the process
           group ID of the session leader of the specified process.
           Otherwise, it shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _getsid_() function shall fail if:
    
           **EPERM** The process specified by _pid_ is not in the same session as
                  the calling process, and the implementation does not allow
                  access to the process group ID of the session leader of
                  that process from the calling process.
    
           **ESRCH** There is no process with a process ID equal to _pid_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_fgetxattr

## NAME



           io_uring_prep_getxattr, io_uring_prep_fgetxattr - prepare a
           request to get an extended attribute value
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_getxattr(struct io_uring_sqe ***_sqe_**,**
                                       **const char ***_name_**,**
                                       **char ***_value_**,**
                                       **const char ***_path_**,**
                                       **unsigned int** _len_**);**
    
           **void io_uring_prep_fgetxattr(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **const char ***_name_**,**
                                        **char ***_value_**,**
                                        **unsigned int** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_getxattr(3) function prepares a request to get
           an extended attribute value. The submission queue entry _sqe_ is
           setup to get the _value_ of the extended attribute identified by
           _name_ and associated with the given _path_ in the filesystem.  The
           _len_ argument specifies the size (in bytes) of _value_.
    
           io_uring_prep_fgetxattr(3) is identical to
           io_uring_prep_getxattr(3), only the open file referred to by _fd_ is
           interrogated in place of _path_.
    
           This function prepares an async getxattr(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


* * *
# tep_read_number

## NAME



           tep_read_number - Reads a number from raw data.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           unsigned long long **tep_read_number**(struct tep_handle *_tep_ , const void *_ptr_ , int _size_);
    


## DESCRIPTION



           The **tep_read_number()** function reads an integer from raw data,
           taking into account the endianness of the raw data and the current
           host. The _tep_ argument is the trace event parser context. The _ptr_
           is a pointer to the raw data, where the integer is, and the _size_
           is the size of the integer.
    


## RETURN VALUE



           The **tep_read_number()** function returns the integer in the byte
           order of the current host. In case of an error, 0 is returned.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               void process_record(struct tep_record *record)
               {
                       int offset = 24;
                       int data = tep_read_number(tep, record->data + offset, 4);
    
                       /* Read the 4 bytes at the offset 24 of data as an integer */
               }
               ...
    


## FILES



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


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



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


## NOTES



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


* * *
# function::user_char_error

## NAME



           function::user_char_error - Retrieves a char value stored in user
           space
    


## SYNOPSIS



               user_char_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the char from
    


## DESCRIPTION



           Returns the char value from a given user space address. If the
           user space data is not accessible, an error will occur.
    


* * *