tripathysagar/man_text huggingface dataset:
# gnutls_x509_key_purpose_init

## NAME



           gnutls_x509_key_purpose_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_key_purpose_init(gnutls_x509_key_purposes_t ***_p_**);**
    


## ARGUMENTS



           gnutls_x509_key_purposes_t * p
                       The key purposes
    


## DESCRIPTION



           This function will initialize an alternative names type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_x509_crt_set_crq_extensions

## NAME



           gnutls_x509_crt_set_crq_extensions - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_crq_extensions(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_crq_t** _crq_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_crq_t crq
                       holds a certificate request
    


## DESCRIPTION



           This function will set the extensions from the given request to
           the certificate.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# tapset::conversions-guru

## NAME



           tapset::conversions-guru - systemtap conversions-guru tapset
    


## DESCRIPTION



           **set_kernel_string**
                  Writes a string to kernel memory
    
                  See function::set_kernel_string(3stap)
                   for details.
    
           **set_kernel_string_n**
                  Writes a string of given length to kernel memory
    
                  See function::set_kernel_string_n(3stap)
                   for details.
    
           **set_kernel_long**
                  Writes a long value to kernel memory
    
                  See function::set_kernel_long(3stap)
                   for details.
    
           **set_kernel_int**
                  Writes an int value to kernel memory
    
                  See function::set_kernel_int(3stap)
                   for details.
    
           **set_kernel_short**
                  Writes a short value to kernel memory
    
                  See function::set_kernel_short(3stap)
                   for details.
    
           **set_kernel_char**
                  Writes a char value to kernel memory
    
                  See function::set_kernel_char(3stap)
                   for details.
    
           **set_kernel_pointer**
                  Writes a pointer value to kernel memory.
    
                  See function::set_kernel_pointer(3stap)
                   for details.
    


* * *
# on_exit

## NAME



           on_exit - register a function to be called at normal process
           termination
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int on_exit(typeof(void (int, void *)) ***_function_**, void ***_arg_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **on_exit**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The **on_exit**() function registers the given _function_ to be called
           at normal process termination, whether via exit(3) or via return
           from the program's _main_().  The _function_ is passed the status
           argument given to the last call to exit(3) and the _arg_ argument
           from **on_exit**().
    
           The same function may be registered multiple times: it is called
           once for each registration.
    
           When a child process is created via fork(2), it inherits copies of
           its parent's registrations.  Upon a successful call to one of the
           exec(3) functions, all registrations are removed.
    


## RETURN VALUE



           The **on_exit**() function returns the value 0 if successful;
           otherwise it returns a nonzero value.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## CAVEATS



           By the time _function_ is executed, stack (_auto_) variables may
           already have gone out of scope.  Therefore, _arg_ should not be a
           pointer to a stack variable; it may however be a pointer to a heap
           variable or a global variable.
    


* * *
# acl_from_text

## NAME



           **acl_from_text** — create an ACL from text
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _acl_t_ **acl_from_text**(_const char *buf_p_)
    


## DESCRIPTION



           The **acl_from_text**() function converts the text form of the ACL
           referred to by _buf_p_ into the internal form of an ACL and returns
           a pointer to the working storage that contains the ACL. The
           **acl_from_text**() function accepts as input the long text form and
           short text form of an ACL as described in _acl_(5).
    
           This function may cause memory to be allocated.  The caller should
           free any releasable memory, when the new ACL is no longer
           required, by calling _acl_free_(3) with the _(void*)acl_t_ returned by
           **acl_from_text**() as an argument.
    


## RETURN VALUE



           On success, this function returns a pointer to the working
           storage.  On error, a value of **(acl_t)NULL** is returned, and _errno_
           is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_from_text**()
           function returns a value of **(acl_t)NULL** and sets _errno_ to the
           corresponding value:
    
           [EINVAL]           The argument _buf_p_ cannot be translated into an
                              ACL.
    
           [ENOMEM]           The _acl_t_ to be returned requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# srand48

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



           srand48 — seed the uniformly distributed double-precision pseudo-
           random number generator
    


## SYNOPSIS



           #include <stdlib.h>
    
           void srand48(long _seedval_);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# libpfm_intel_skx_unc_imc

## NAME



           libpfm_intel_skx_unc_imc - support for Intel Skylake X Server
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_imc[0-7]**
           **PMU desc: Intel Skylake X Server IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X Server Integrated Memory
           Controller (IMC) uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Skylake X server
           IMC 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 IMC cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].  **i** Invert the meaning of the threshold or
                  edge filter. If set, the event counts when strictly less
                  than N occurrences occur per cycle if threshold is set to
                  N. When invert is set, then threshold must be set to non-
                  zero value. If set, the event counts when the event
                  transitions from occurring to not occurring (falling edge)
                  when edge detection is set. This is a boolean modifier
    


* * *
# pmstrncat

## NAME



           **pmstrncat** - safe string concatenation
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmstrncat(char ***_dest_**, size_t** _destlen_**, char ***_src_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmstrncat** is safe string concatenation routine with semantics sim‐
           ilar to strncat(3).
    
           The main differences between **pmstrncat** and strncat(3) are:
           • _src_ must be null-byte terminated for **pmstrncat**
           • _destlen_ is the length of the destination buffer (_dest_) for **pm‐**
             **strncat,** not the maximum number of non-null bytes to copy from
             _src_ as it is for **strncat**
           • the length argument has the same semantics for **pmstrncat** and
             pmstrncpy(3), unlike strncat(3) and strncpy(3).
           • the return value from **pmstrncat** is useful
           • the order of the arguments for **pmstrncat** has been _deliberately_
             changed from the order of the arguments for strncat(3) to avoid
             accidental misuse that a compiler can easily detect
    
           On success, **pmstrncat** returns 0, else -1 indicates that _src_ is too
           big and the result been truncated to ensure _dest_ has no been over‐
           run.
    


* * *
# probe::signal.handle

## NAME



           probe::signal.handle - Signal handler being invoked
    


## SYNOPSIS



           signal.handle
    


## VALUES



           _sig_mode_
               Indicates whether the signal was a user-mode or kernel-mode
               signal
    
           _sinfo_
               The address of the siginfo table
    
           _regs_
               The address of the kernel-mode stack area (deprecated in
               SystemTap 2.1)
    
           _oldset_addr_
               The address of the bitmask array of blocked signals
               (deprecated in SystemTap 2.1)
    
           _ka_addr_
               The address of the k_sigaction table associated with the
               signal
    
           _sig_name_
               A string representation of the signal
    
           _sig_
               The signal number that invoked the signal handler
    
           _name_
               Name of the probe point
    
           _sig_code_
               The si_code value of the siginfo signal
    


* * *
# asprintf

## NAME



           asprintf, vasprintf - print to allocated string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <stdio.h>**
    
           **int asprintf(char **restrict** _strp_**, const char *restrict** _fmt_**, ...);**
           **int vasprintf(char **restrict** _strp_**, const char *restrict** _fmt_**,**
                         **va_list** _ap_**);**
    


## DESCRIPTION



           The functions **asprintf**() and **vasprintf**() are analogs of sprintf(3)
           and vsprintf(3), except that they allocate a string large enough
           to hold the output including the terminating null byte ('\0'), and
           return a pointer to it via the first argument.  This pointer
           should be passed to free(3) to release the allocated storage when
           it is no longer needed.
    


## RETURN VALUE



           When successful, these functions return the number of bytes
           printed, just like sprintf(3).  On error, -1 is returned, _errno_ is
           set to indicate the error, and the contents of _strp_ are undefined.
    


## ERRORS



           See sprintf(3) and malloc(3).
    


## ATTRIBUTES



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


## VERSIONS



           The FreeBSD implementation sets _strp_ to NULL on error.
    


## STANDARDS



           GNU, BSD.
    


* * *
# umad_open_port

## NAME



           umad_open_port - open InfiniBand device port for umad access
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_open_port(char** _*ca_name_**, int** _portnum_**);**
    


## DESCRIPTION



           **umad_open_port()** opens the port _portnum_ of the IB device _ca_name_
           for umad access. The port is selected by the library if not all
           parameters are provided (see **umad_get_port()** for details).
    


## RETURN VALUE



           **umad_open_port()** returns 0 or an unique positive value of umad
           device descriptor on success, and a negative value on error as
           follows:
            -EOPNOTSUPP ABI version doesn't match
            -ENODEV     IB device can't be resolved
            -EINVAL     port is not valid (bad _portnum_ or no umad device)
            -EIO        umad device for this port can't be opened
    


* * *
# pcap_minor_version

## NAME



           pcap_major_version, pcap_minor_version - get the version number of
           a savefile
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_major_version(pcap_t *p);**
           **int pcap_minor_version(pcap_t *p);**
    


## DESCRIPTION



           If _p_ refers to a ``savefile'', **pcap_major_version**() returns the
           major number of the file format of the ``savefile'' and
           **pcap_minor_version**() returns the minor number of the file format
           of the ``savefile''.  The version number is stored in the
           ``savefile''; note that the meaning of its values depends on the
           type of ``savefile'' (for example, pcap or pcapng).
    
           If _p_ refers to a live capture, the values returned by
           **pcap_major_version**() and **pcap_minor_version**() are not meaningful.
    


* * *
# function::task_uid

## NAME



           function::task_uid - The user identifier of the task
    


## SYNOPSIS



               task_uid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the user id of the given task.
    


* * *
# gnutls_priority_string_list

## NAME



           gnutls_priority_string_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_priority_string_list(unsigned** _iter_**, unsigned**
           **int** _flags_**);**
    


## ARGUMENTS



           unsigned iter
                       an integer counter starting from zero
    
           unsigned int flags
                       one of **GNUTLS_PRIORITY_LIST_INIT_KEYWORDS** ,
                       **GNUTLS_PRIORITY_LIST_SPECIAL**
    


## DESCRIPTION



           Can be used to iterate all available priority strings.  Due to
           internal implementation details, there are cases where this
           function can return the empty string. In that case that string
           should be ignored.  When no strings are available it returns **NULL**.
    


## RETURNS



           a priority string
    


## SINCE



           3.4.0
    


* * *
# function::exit

## NAME



           function::exit - Start shutting down probing script.
    


## SYNOPSIS



               exit()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This only enqueues a request to start shutting down the script.
           New probes will not fire (except “end” probes), but all currently
           running ones may complete their work.
    


* * *
# probe::socket.create

## NAME



           probe::socket.create - Creation of a socket
    


## SYNOPSIS



           socket.create
    


## VALUES



           _name_
               Name of this probe
    
           _requester_
               Requested by user process or the kernel (1 = kernel, 0 = user)
    
           _protocol_
               Protocol value
    
           _type_
               Socket type value
    
           _family_
               Protocol family value
    


## CONTEXT



           The requester (see requester variable)
    


## DESCRIPTION



           Fires at the beginning of creating a socket.
    


* * *
# function::printk

## NAME



           function::printk - Send a message to the kernel trace buffer
    


## SYNOPSIS



               printk(level:long,msg:string)
    


## ARGUMENTS



           _level_
               an integer for the severity level (0=KERN_EMERG ...
               7=KERN_DEBUG)
    
           _msg_
               The formatted message string
    


## DESCRIPTION



           Print a line of text to the kernel dmesg/console with the given
           severity. An implicit end-of-line is added. This function may not
           be safely called from all kernel probe contexts, so is restricted
           to guru mode only.
    


* * *
# function::ppid

## NAME



           function::ppid - Returns the process ID of a target process's
           parent process
    


## SYNOPSIS



               ppid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function return the process ID of the target proccess's
           parent process.
    


* * *
# gnutls_x509_crt_set_issuer_dn

## NAME



           gnutls_x509_crt_set_issuer_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_issuer_dn(gnutls_x509_crt_t** _crt_**, const**
           **char ***_dn_**, const char ****_err_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           const char * dn
                       a comma separated DN string (RFC4514)
    
           const char ** err
                       indicates the error position (if any)
    


## DESCRIPTION



           This function will set the DN on the provided certificate.  The
           input string should be plain ASCII or UTF-8 encoded. On DN parsing
           error **GNUTLS_E_PARSING_ERROR** is returned.
    


## RETURNS



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


* * *
# function::pid2execname

## NAME



           function::pid2execname - The name of the given process identifier
    


## SYNOPSIS



               pid2execname:string(pid:long)
    


## ARGUMENTS



           _pid_
               process identifier
    


## DESCRIPTION



           Return the name of the given process id.
    


* * *
# probe::netfilter.bridge.post_routing

## NAME



           probe::netfilter.bridge.post_routing - - Called before a bridging
           packet hits the wire
    


## SYNOPSIS



           netfilter.bridge.post_routing
    


## VALUES



           _length_
               The length of the packet buffer contents, in bytes
    
           _brhdr_
               Address of bridge header
    
           _br_mac_
               Bridge MAC address
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _br_rmac_
               Root bridge MAC address
    
           _br_fd_
               Forward delay in 1/256 secs
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _br_rid_
               Identity of root bridge
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _protocol_
               Packet protocol
    
           _br_max_
               Max age in 1/256 secs
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _br_vid_
               Protocol version identifier
    
           _br_htime_
               Hello time in 1/256 secs
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _br_prid_
               Protocol identifier
    
           _llcpdu_
               Address of LLC Protocol Data Unit
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _llcproto_stp_
               Constant used to signify Bridge Spanning Tree Protocol packet
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _br_cost_
               Total cost from transmitting bridge to root
    
           _br_msg_
               Message age in 1/256 secs
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _pf_
               Protocol family -- always “bridge”
    
           _br_bid_
               Identity of bridge
    
           _br_flags_
               BPDU flags
    
           _br_type_
               BPDU type
    
           _br_poid_
               Port identifier
    


* * *
# function::get_cycles

## NAME



           function::get_cycles - Processor cycle count
    


## SYNOPSIS



               get_cycles:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the processor cycle counter value if
           available, else it returns zero. The cycle counter is free running
           and unsynchronized on each processor. Thus, the order of events
           cannot determined by comparing the results of the get_cycles
           function on different processors.
    


* * *
# gnutls_hash_deinit

## NAME



           gnutls_hash_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_hash_deinit(gnutls_hash_hd_t** _handle_**, void ***_digest_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t handle
                       is a **gnutls_hash_hd_t** type
    
           void * digest
                       is the output value of the hash
    


## DESCRIPTION



           This function will deinitialize all resources occupied by the
           given hash context.
    


## SINCE



           2.10.0
    


* * *
# io_uring_prep_close_direct

## NAME



           io_uring_prep_close - prepare a file descriptor close request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_close(struct io_uring_sqe ***_sqe_**,**
                                     **int** _fd_**);**
    
           **void io_uring_prep_close_direct(struct io_uring_sqe ***_sqe_**,**
                                           **unsigned** _file_index_**);**
    


## DESCRIPTION



           The io_uring_prep_close(3) function prepares a close request. The
           submission queue entry _sqe_ is setup to close the file descriptor
           indicated by _fd_.
    
           For a direct descriptor close request, the offset is specified by
           the _file_index_ argument instead of the _fd_.  This is identical to
           unregistering the direct descriptor, and is provided as a
           convenience. Note that even though it's closing a direct
           descriptor, the application must not set **IOSQE_FIXED_FILE** on the
           SQE. Otherwise the request will complete with **-EBADF** as the
           result.
    
           These functions prepare an async close(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. For closing
           of a direct descriptor, the only failure cases are the kernel
           running completely out of memory, or if the application has
           specified an invalid direct descriptor. Note that where
           synchronous system calls will return **-1** on failure and set _errno_
           to the actual error value, io_uring never uses _errno_.  Instead it
           returns the negated _errno_ directly in the CQE _res_ field.
    


* * *
# keyctl

## NAME



           keyctl_*() - key management function wrappers
    


## DESCRIPTION



           The **keyctl**() system call is a multiplexor for a number of key
           management functions.  These should be called via the wrappers in
           the libkeyutils library.
    
           The functions can be compiled in by including the **keyutils** header
           file:
    
                  **#include <keyutils.h>**
    
           and then telling the linker it should link in the library:
    
                  **-lkeyutils**
    


## KEYCTL FUNCTIONS



           keyctl_assume_authority(3)
           keyctl_chown(3)
           keyctl_capabilities(3)
           keyctl_clear(3)
           keyctl_describe(3)
           **keyctl_describe_alloc**(3)
           keyctl_dh_compute(3)
           **keyctl_dh_compute_alloc**(3)
           keyctl_get_keyring_ID(3)
           keyctl_get_persistent(3)
           keyctl_get_security(3)
           **keyctl_get_security_alloc**(3)
           keyctl_instantiate(3)
           keyctl_instantiate_iov(3)
           keyctl_invalidate(3)
           keyctl_join_session_keyring(3)
           keyctl_link(3)
           keyctl_move(3)
           keyctl_negate(3)
           keyctl_pkey_decrypt(3)
           keyctl_pkey_encrypt(3)
           keyctl_pkey_query(3)
           keyctl_pkey_sign(3)
           keyctl_pkey_verify(3)
           keyctl_read(3)
           **keyctl_read_alloc**(3)
           keyctl_reject(3)
           keyctl_restrict_keyring(3)
           keyctl_revoke(3)
           keyctl_search(3)
           keyctl_session_to_parent(3)
           keyctl_set_reqkey_keyring(3)
           keyctl_set_timeout(3)
           keyctl_setperm(3)
           keyctl_unlink(3)
           keyctl_update(3)
           keyctl_watch_key(3)
    


## UTILITY FUNCTIONS



           find_key_by_type_and_name(3)
           recursive_key_scan(3)
           recursive_session_key_scan(3)
    


* * *
# gnutls_pk_bits_to_sec_param

## NAME



           gnutls_pk_bits_to_sec_param - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_sec_param_t**
           **gnutls_pk_bits_to_sec_param(gnutls_pk_algorithm_t** _algo_**, unsigned**
           **int** _bits_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t algo
                       is a public key algorithm
    
           unsigned int bits
                       is the number of bits
    


## DESCRIPTION



           This is the inverse of **gnutls_sec_param_to_pk_bits()**. Given an
           algorithm and the number of bits, it will return the security
           parameter. This is a rough indication.
    


## RETURNS



           The security parameter.
    


## SINCE



           2.12.0
    


* * *
# function::user_int8_error

## NAME



           function::user_int8_error - Retrieves a 8-bit integer value stored
           in user space
    


## SYNOPSIS



               user_int8_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the 8-bit integer from
    


## DESCRIPTION



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


* * *
# gnutls_session_ticket_send

## NAME



           gnutls_session_ticket_send - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_ticket_send(gnutls_session_t** _session_**, unsigned**
           _nr_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned nr the number of tickets to send
    
           unsigned flags
                       must be zero
    


## DESCRIPTION



           Sends a fresh session ticket to the peer. This is relevant only in
           server side under TLS1.3. This function may also return
           **GNUTLS_E_AGAIN** or **GNUTLS_E_INTERRUPTED** and in that case it must be
           called again.
    


## RETURNS



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


* * *
# gnutls_pkcs7_sign

## NAME



           gnutls_pkcs7_sign - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_sign(gnutls_pkcs7_t** _pkcs7_**, gnutls_x509_crt_t**
           _signer_**, gnutls_privkey_t** _signer_key_**, const gnutls_datum_t ***_data_**,**
           **gnutls_pkcs7_attrs_t** _signed_attrs_**, gnutls_pkcs7_attrs_t**
           _unsigned_attrs_**, gnutls_digest_algorithm_t** _dig_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a **gnutls_pkcs7_t** type
    
           gnutls_x509_crt_t signer
                       the certificate to sign the structure
    
           gnutls_privkey_t signer_key
                       the key to sign the structure
    
           const gnutls_datum_t * data
                       The data to be signed or **NULL** if the data are already
                       embedded
    
           gnutls_pkcs7_attrs_t signed_attrs
                       Any additional attributes to be included in the signed
                       ones (or **NULL**)
    
           gnutls_pkcs7_attrs_t unsigned_attrs
                       Any additional attributes to be included in the
                       unsigned ones (or **NULL**)
    
           gnutls_digest_algorithm_t dig
                       The digest algorithm to use for signing
    
           unsigned flags
                       Should be zero or one of **GNUTLS_PKCS7** flags
    


## DESCRIPTION



           This function will add a signature in the provided PKCS **7**
           structure for the provided data. Multiple signatures can be made
           with different signers.
    
           The available flags are: **GNUTLS_PKCS7_EMBED_DATA** ,
           **GNUTLS_PKCS7_INCLUDE_TIME** , **GNUTLS_PKCS7_INCLUDE_CERT** , and
           **GNUTLS_PKCS7_WRITE_SPKI**. They are explained in the
           **gnutls_pkcs7_sign_flags** definition.
    


## RETURNS



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


## SINCE



           3.4.2
    


* * *
# function::kernel_string_quoted

## NAME



           function::kernel_string_quoted - Retrieves and quotes string from
           kernel memory
    


## SYNOPSIS



               kernel_string_quoted:string(addr:long)
    


## ARGUMENTS



           _addr_
               the kernel memory address to retrieve the string from
    


## DESCRIPTION



           Returns the null terminated C string from a given kernel memory
           address where any ASCII characters that are not printable are
           replaced by the corresponding escape sequence in the returned
           string. Note that the string will be surrounded by double quotes.
           If the kernel memory data is not accessible at the given address,
           the address itself is returned as a string, without double quotes.
    


* * *
# fclose

## NAME



           fclose - close a stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **fclose**() function flushes the stream pointed to by _stream_
           (writing any buffered output data using fflush(3)) and closes the
           underlying file descriptor.
    


## RETURN VALUE



           Upon successful completion, 0 is returned.  Otherwise, **EOF** is
           returned and _errno_ is set to indicate the error.  In either case,
           any further access (including another call to **fclose**()) to the
           stream results in undefined behavior.
    


## ERRORS



           **EBADF** The file descriptor underlying _stream_ is not valid.
    
           The **fclose**() function may also fail and set _errno_ for any of the
           errors specified for the routines close(2), write(2), or
           fflush(3).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           Note that **fclose**() flushes only the user-space buffers provided by
           the C library.  To ensure that the data is physically stored on
           disk the kernel buffers must be flushed too, for example, with
           sync(2) or fsync(2).
    


* * *
# gnutls_privkey_export_pkcs11

## NAME



           gnutls_privkey_export_pkcs11 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_pkcs11(gnutls_privkey_t** _pkey_**,**
           **gnutls_pkcs11_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_pkcs11_privkey_t * key
                       Location for the key to be exported.
    


## DESCRIPTION



           Converts the given abstract private key to a
           **gnutls_pkcs11_privkey_t** type. The key must be of type
           **GNUTLS_PRIVKEY_PKCS11**. The key returned in  _key_ must be
           deinitialized with **gnutls_pkcs11_privkey_deinit()**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# ibv_get_device_list

## NAME



           ibv_get_device_list, ibv_free_device_list - get and release list
           of available RDMA devices
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_device **ibv_get_device_list(int *num_devices);
    
                  void ibv_free_device_list(struct ibv_device **list);
    


## DESCRIPTION



           **ibv_get_device_list()** returns a NULL-terminated array of RDMA
           devices currently available.  The argument _num_devices_ is
           optional; if not NULL, it is set to the number of devices returned
           in the array.
    
           **ibv_free_device_list()** frees the array of devices _list_ returned by
           **ibv_get_device_list()**.
    


## RETURN VALUE



           **ibv_get_device_list()** returns the array of available RDMA devices,
           or sets _errno_ and returns NULL if the request fails.  If no
           devices are found then _num_devices_ is set to 0, and non-NULL is
           returned.
    
           **ibv_free_device_list()** returns no value.
    


## ERRORS



           **EPERM** Permission denied.
    
           **ENOSYS** No kernel support for RDMA.
    
           **ENOMEM** Insufficient memory to complete the operation.
    


## NOTES



           Client code should open all the devices it intends to use with
           **ibv_open_device()** before calling **ibv_free_device_list()**.  Once it
           frees the array with **ibv_free_device_list()** , it will be able to
           use only the open devices; pointers to unopened devices will no
           longer be valid.
    
           Setting the environment variable **IBV_SHOW_WARNINGS** will cause
           warnings to be emitted to stderr if a kernel verbs device is
           discovered, but no corresponding userspace driver can be found for
           it.
    


## STATIC LINKING



           If **libibverbs** is statically linked to the application then all
           provider drivers must also be statically linked.  The library will
           not load dynamic providers when static linking is used.
    
           To link the providers set the **RDMA_STATIC_PROVIDERS** define to the
           comma separated list of desired providers when compiling the
           application.  The special keyword `all' will statically link all
           supported **libibverbs** providers.
    
           This is intended to be used along with **pkg-config(1)** to setup the
           proper flags for **libibverbs** linking.
    
           If this is not done then **ibv_get_device_list** will always return an
           empty list.
    
           Using only dynamic linking for **libibverbs** applications is strongly
           recommended.
    


* * *
# function::stringat

## NAME



           function::stringat - Returns the char at a given position in the
           string
    


## SYNOPSIS



               stringat:long(str:string,pos:long)
    


## ARGUMENTS



           _str_
               the string to fetch the character from
    
           _pos_
               the position to get the character from (first character is 0)
    


## DESCRIPTION



           This function returns the character at a given position in the
           string or zero if the string doesn't have as many characters.
           Reports an error if pos is out of bounds.
    


* * *
# probe::nfs.fop.aio_write

## NAME



           probe::nfs.fop.aio_write - NFS client aio_write file operation
    


## SYNOPSIS



           nfs.fop.aio_write
    


## VALUES



           _file_name_
               file name
    
           _parent_name_
               parent dir name
    
           _count_
               read bytes
    
           _ino_
               inode number
    
           _dev_
               device identifier
    
           _pos_
               offset of the file
    
           _buf_
               the address of buf in user space
    


* * *
# tapset::switchfile

## NAME



           tapset::switchfile - systemtap switchfile tapset
    


## DESCRIPTION



           **switch_file**
                  switch to the next output file
    
                  See function::switch_file(3stap)
                   for details.
    


* * *
# libpfm_intel_core

## NAME



           libpfm_intel_core - support for Intel Core-based processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: core**
           **PMU desc: Intel Core**
    


## DESCRIPTION



           The library supports all Intel Core-based processors that includes
           models 15, 23, 29.
    


## MODIFIERS



           The following modifiers are supported on Intel Core processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  counter mask modifier (m) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    


* * *
# gnutls_dh_get_group

## NAME



           gnutls_dh_get_group - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_get_group(gnutls_session_t** _session_**, gnutls_datum_t ***
           _raw_gen_**, gnutls_datum_t ***_raw_prime_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           gnutls_datum_t * raw_gen
                       will hold the generator.
    
           gnutls_datum_t * raw_prime
                       will hold the prime.
    


## DESCRIPTION



           This function will return the group parameters used in the last
           Diffie-Hellman key exchange with the peer.  These are the prime
           and the generator used.  This function should be used for both
           anonymous and ephemeral Diffie-Hellman.  The output parameters
           must be freed with **gnutls_free()**.
    
           Note, that the prime and generator are exported as non-negative
           integers and may include a leading zero byte.
    


## RETURNS



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


* * *
# gnutls_x509_crt_set_tlsfeatures

## NAME



           gnutls_x509_crt_set_tlsfeatures - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_tlsfeatures(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_tlsfeatures_t** _features_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       A X.509 certificate
    
           gnutls_x509_tlsfeatures_t features
                       If the function succeeds, the features will be added
                       to the certificate.
    


## DESCRIPTION



           This function will set the certificates X.509 TLS extension from
           the given structure.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# gnutls_psk_set_server_credentials_hint

## NAME



           gnutls_psk_set_server_credentials_hint - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_set_server_credentials_hint(gnutls_psk_server_credentials_t**
           _res_**, const char ***_hint_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t res
                       is a **gnutls_psk_server_credentials_t** type.
    
           const char * hint
                       is the PSK identity hint string
    


## DESCRIPTION



           This function sets the identity hint, in a
           **gnutls_psk_server_credentials_t** type.  This hint is sent to the
           client to help it chose a good PSK credential (i.e., username and
           password).
    


## RETURNS



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


## SINCE



           2.4.0
    


* * *
# function::kernel_char

## NAME



           function::kernel_char - Retrieves a char value stored in kernel
           memory
    


## SYNOPSIS



               kernel_char:long(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the char from
    


## DESCRIPTION



           Returns the char value from a given kernel memory address. Reports
           an error when reading from the given address fails.
    


* * *
# gnutls_ocsp_req_set_extension

## NAME



           gnutls_ocsp_req_set_extension - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_set_extension(gnutls_ocsp_req_t** _req_**, const**
           **char ***_oid_**, unsigned int** _critical_**, const gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           const char * oid
                       buffer with OID of extension as a string.
    
           unsigned int critical
                       critical flag, normally false.
    
           const gnutls_datum_t * data
                       the extension data
    


## DESCRIPTION



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


## RETURNS



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


* * *
# uuid_compare

## NAME



           uuid_compare - compare whether two UUIDs are the same
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **int uuid_compare(const uuid_t** _uu1_**, const uuid_t** _uu2_**)**
    


## DESCRIPTION



           The **uuid_compare**() function compares the two supplied uuid
           variables _uu1_ and _uu2_ to each other.
    


## RETURN VALUE



           Returns an integer less than, equal to, or greater than zero if
           _uu1_ is found, respectively, to be lexicographically less than,
           equal, or greater than _uu2_.
    


## 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_COMPARE_(3)
    


* * *