tripathysagar/man_text huggingface dataset:
# function::string_quoted

## NAME



           function::string_quoted - Quotes a given string
    


## SYNOPSIS



               string_quoted:string(str:string)
    


## ARGUMENTS



           _str_
               The kernel address to retrieve the string from
    


## DESCRIPTION



           Returns the quoted string version of the given string, with
           characters 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.
    


* * *
# difftime

## NAME



           difftime - calculate time difference
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **double difftime(time_t** _time1_**, time_t** _time0_**);**
    


## DESCRIPTION



           The **difftime**() function returns the number of seconds elapsed
           between time _time1_ and time _time0_ , represented as a _double_.  Each
           time is a count of seconds.
    
           _difftime(b, a)_ acts like _(b-a)_ except that the result does not
           overflow and is rounded to _double_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# audit_update_watch_perms

## NAME



           audit_update_watch_perms - update permissions field of watch
           command
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_update_watch_perms(struct audit_rule_data**
           *****_rule,_**int"**_perms);"_
    


## DESCRIPTION



           audit_update_watch_perms adds the permission checks to a watch
           command that is being built. The perms are a bitwise or'ing of:
           AUDIT_PERM_EXEC, AUDIT_PERM_WRITE, AUDIT_PERM_READ,
           AUDIT_PERM_ATTR.
    


## RETURN VALUE



           Returns a number < 0 if an error occurs; otherwise, 0 for success.
    


* * *
# libpfm_amd64_fam17h

## NAME



           libpfm_amd64_fam17h - support for AMD64 Family 17h processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_fam17h (deprecated), amd_fam17h_zen1**
           **PMU desc: AMD64 Fam17h Zen1**
    


## DESCRIPTION



           The library supports AMD Family 17h processors Zen1 core PMU in
           both 32 and 64-bit modes.  The amd64_fam17h PMU model name has
           been deprecated in favor of amd_fam17h_zen1. The old name is
           maintained for backward compatibility reasons, but should not be
           used anymore.
    


## MODIFIERS



           The following modifiers are supported on AMD64 Family 17h Zen1
           core PMU:
    
           **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.
    
           **h** Measure at while executing in host mode (when using
                  virtualization). This corresponds to **PFM_PLMH**.  This
                  modifier is available starting with Fam10h. This is a
                  boolean modifier.
    
           **g** Measure at while executing in guest mode (when using
                  virtualization). This modifier is available starting with
                  Fam10h. 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. 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].
    


* * *
# probe::socket.writev.return

## NAME



           probe::socket.writev.return - Conclusion of message sent via
           **socket_writev**
    


## SYNOPSIS



           socket.writev.return
    


## VALUES



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


## CONTEXT



           The message receiver.
    


## DESCRIPTION



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


* * *
# function::ns_sid

## NAME



           function::ns_sid - Returns the session ID of the current process
           as seen in a pid namespace
    


## SYNOPSIS



               ns_sid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           The namespace-aware session ID of a process is the process group
           ID of the session leader as seen in the target pid namespace if
           provided, or the stap process namespace. Session ID is stored in
           the signal_struct since Kernel 2.6.0.
    


* * *
# rdma_destroy_id

## NAME



           rdma_destroy_id - Release a communication identifier.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_destroy_id (struct rdma_cm_id ***_id_**);**
    


## ARGUMENTS



           id          The communication identifier to destroy.
    


## DESCRIPTION



           Destroys the specified rdma_cm_id and cancels any outstanding
           asynchronous operation.
    


## RETURN VALUE



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


## NOTES



           Users must free any associated QP with the rdma_cm_id before
           calling this routine and ack all related events.
    


* * *
# function::kernel_buffer_quoted_error

## NAME



           function::kernel_buffer_quoted_error - Retrieves and quotes buffer
           from kernel space
    


## SYNOPSIS



               kernel_buffer_quoted_error:string(addr:long,inlen:long,outlen:long)
    


## ARGUMENTS



           _addr_
               the kernel space address to retrieve the buffer from
    
           _inlen_
               the exact length of the buffer to read
    
           _outlen_
               the maximum length of the output string
    


## DESCRIPTION



           Reads inlen characters of a buffer from the given kernel space
           memory address, and returns up to outlen characters, 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. On the rare cases
           when kernel space data is not accessible at the given address, an
           error is thrown.
    


* * *
# define_key

## NAME



           **define_key** - define a keycode
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int define_key(const char ***_definition_**, int** _keycode_**);**
    


## DESCRIPTION



           This is an extension to the curses library.  It permits an
           application to define keycodes with their corresponding control
           strings, so that the ncurses library will interpret them just as
           it would the predefined codes in the terminfo database.
    
           If the given string is null, any existing definition for the
           keycode is removed.  Similarly, if the given keycode is negative
           or zero, any existing string for the given definition is removed.
    


## RETURN VALUE



           The keycode must be greater than zero, and the string non-null,
           otherwise **ERR** is returned.  **ERR** may also be returned if there is
           insufficient memory to allocate the data to store the definition.
           If no error is detected, **OK** is returned.
    


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# gnutls_privkey_decrypt_data2

## NAME



           gnutls_privkey_decrypt_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_decrypt_data2(gnutls_privkey_t** _key_**, unsigned**
           **int** _flags_**, const gnutls_datum_t ***_ciphertext_**, unsigned char ***
           _plaintext_**, size_t** _plaintext_size_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the key
    
           unsigned int flags
                       zero for now
    
           const gnutls_datum_t * ciphertext
                       holds the data to be decrypted
    
           unsigned char * plaintext
                       a preallocated buffer that will be filled with the
                       plaintext
    
           size_t plaintext_size
                       in/out size of the plaintext
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           supported by the private key. Unlike with
           **gnutls_privkey_decrypt_data()** this function operates in constant
           time and constant memory access.
    


## RETURNS



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


## SINCE



           3.6.5
    


* * *
# gnutls_pubkey_set_spki

## NAME



           gnutls_pubkey_set_spki - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_set_spki(gnutls_pubkey_t** _pubkey_**, const**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pubkey
                       a public key of type **gnutls_pubkey_t**
    
           const gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_pubkey_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will set the public key information.  The provided
           _spki_ must be initialized.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# vfprintf

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



           vdprintf, vfprintf, vprintf, vsnprintf, vsprintf — format output
           of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
    
           int vdprintf(int _fildes_ , const char *restrict _format_ , va_list _ap_);
           int vfprintf(FILE *restrict _stream_ , const char *restrict _format_ ,
               va_list _ap_);
           int vprintf(const char *restrict _format_ , va_list _ap_);
           int vsnprintf(char *restrict _s_ , size_t _n_ , const char *restrict _format_ ,
               va_list _ap_);
           int vsprintf(char *restrict _s_ , const char *restrict _format_ , va_list _ap_);
    


## 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 _vdprintf_(), _vfprintf_(), _vprintf_(), _vsnprintf_(), and _vsprintf_()
           functions shall be equivalent to the  _dprintf_(), _fprintf_(),
           _printf_(), _snprintf_(), and _sprintf_() functions respectively, except
           that instead of being called with a variable number of arguments,
           they are called with an argument list as defined by _< stdarg.h>_.
    
           These functions shall not invoke the _va_end_ macro. As these
           functions invoke the _va_arg_ macro, the value of _ap_ after the
           return is unspecified.
    


## RETURN VALUE



           Refer to fprintf(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications using these functions should call _va_end_(_ap_)
           afterwards to clean up.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# umad_send

## NAME



           umad_send - send umad
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_send(int** _portid_**, int** _agentid_**, void** _*umad_**, int** _length_**, int** _timeout_ms_**, int** _retries_**);**
    


## DESCRIPTION



           **umad_send()** sends _length_ bytes from the specified _umad_ buffer from
           the port specified by _portid_ , and using the agent specified by
           _agentid_.
    
           The buffer can contain a RMPP transmission which is larger than a
           single MAD packet when the agentid specifies a class which
           utilizes RMPP and the header flags indicate RMPP is active.  NOTE
           currently only RMPPFlags.Active is meaningful in the header in
           user space.  All other RMPP fields are ignored.  The data section
           of the buffer will be sent in multiple RMPP MAD packets with
           headers built for the user.
    
           _timeout_ms_ controls the solicited MADs behavior as follows: zero
           value means not solicited. Positive value makes kernel indicate
           timeout in milliseconds. If reply is not received within the
           specified value, the original buffer is returned in the read
           channel with the status field set (to non zero). Negative
           _timeout_ms_ makes kernel wait forever for the reply.  _retries_
           indicates the number of times the MAD will be retried before
           giving up.
    


## RETURN VALUE



           **umad_send()** returns 0 on success; on error, errno is set and a
           negative value is returned as follows:
            -EINVAL invalid port handle or agentid
            -EIO    send operation failed
    


* * *
# remquo

## NAME



           remquo, remquof, remquol - remainder and part of quotient
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double remquo(double** _x_**, double** _y_**, int ***_quo_**);**
           **float remquof(float** _x_**, float** _y_**, int ***_quo_**);**
           **long double remquol(long double** _x_**, long double** _y_**, int ***_quo_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **remquo**(), **remquof**(), **remquol**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions compute the remainder and part of the quotient
           upon division of _x_ by _y_.  A few bits of the quotient are stored
           via the _quo_ pointer.  The remainder is returned as the function
           result.
    
           The value of the remainder is the same as that computed by the
           remainder(3) function.
    
           The value stored via the _quo_ pointer has the sign of _x / y_ and
           agrees with the quotient in at least the low order 3 bits.
    
           For example, _remquo(29.0, 3.0)_ returns -1.0 and might store 2.
           Note that the actual quotient might not fit in an integer.
    


## RETURN VALUE



           On success, these functions return the same value as the analogous
           functions described in remainder(3).
    
           If _x_ or _y_ is a NaN, a NaN is returned.
    
           If _x_ is an infinity, and _y_ is not a NaN, a domain error occurs,
           and a NaN is returned.
    
           If _y_ is zero, and _x_ is not a NaN, a domain error occurs, and a NaN
           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 an infinity or _y_ is 0, and the other argument
           is not a NaN.
                  An invalid floating-point exception (**FE_INVALID**) is raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pthread_attr_init

## 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_attr_init — initialize the thread attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_init(pthread_attr_t *_attr_);
    


## DESCRIPTION



           Refer to pthread_attr_destroy(3p).
    


* * *
# wcstold

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



           wcstold — convert a wide-character string to a double-precision
           number
    


## SYNOPSIS



           #include <wchar.h>
    
           long double wcstold(const wchar_t *restrict _nptr_ ,
               wchar_t **restrict _endptr_);
    


## DESCRIPTION



           Refer to wcstod(3p).
    


* * *
# io_uring_prep_pipe

## NAME



           io_uring_prep_pipe - prepare a pipe creation request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_pipe(struct io_uring_sqe ***_sqe_**,**
                                   **int ***_fds_**,**
                                   **int** _pipe_flags_**);**
    
           **void io_uring_prep_pipe_direct(struct io_uring_sqe ***_sqe_**,**
                                          **int ***_fds_**,**
                                          **int** _pipe_flags_**,**
                                          **unsigned int** _file_index_**);**
    


## DESCRIPTION



           The io_uring_prep_pipe(3) function prepares a pipe creation
           request. The submission queue entry _sqe_ is setup to create a pipe
           with the created descriptors being copied to the array indicated
           by _fds_ and using _pipe_flags_ as the pipe creation flags. See
           pipe2(2) for details on the flags accepted.
    
           The **io_uring_prep_pipe_direct**(3) function works in the same way,
           however it uses fixed/registered file descriptors rather than
           normal file descriptors. This helper takes an additional
           _file_index_ argument, which can set to either an explicit direct
           descriptor offset to create the two pipe file descriptors at, or
           it can be set to **IORING_FILE_INDEX_ALLOC** to let io_uring pick any
           available descriptors for the read and write side of the pipe. If
           a specific index is given, the read side of the pipe will be
           created at that offset, if free, and the write side will be
           created at the next (+1) index. Both of these must be currently
           unused, or the operation will fail. Also see
           io_uring_prep_accept_direct(3) or io_uring_prep_socket_direct(3)
           for details on the _file_index_ parameter.
    
           For both the direct and normal file descriptor pipe request, the
           resulting input/read side of the pipe will be stored in _fds[0]_ and
           the output/write side of the pipe will be stored in _fds[1]_ upon
           successful completion of this request.
    
           This function prepares an async pipe2(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. 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.
    


* * *
# function::cmdline_str

## NAME



           function::cmdline_str - Fetch all command line arguments from
           current process
    


## SYNOPSIS



               cmdline_str:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns all arguments from the current process delimited by
           spaces. Returns the empty string when the arguments cannot be
           retrieved.
    


* * *
# mkdtemp

## NAME



           mkdtemp - create a unique temporary directory
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **char *mkdtemp(char ***_template_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **mkdtemp**():
               /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc 2.19 and earlier: */ _BSD_SOURCE
                   || /* Since glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
    


## DESCRIPTION



           The **mkdtemp**() function generates a uniquely named temporary
           directory from _template_.  The last six characters of _template_ must
           be XXXXXX and these are replaced with a string that makes the
           directory name unique.  The directory is then created with
           permissions 0700.  Since it will be modified, _template_ must not be
           a string constant, but should be declared as a character array.
    


## RETURN VALUE



           The **mkdtemp**() function returns a pointer to the modified template
           string on success, and NULL on failure, in which case _errno_ is set
           to indicate the error.
    


## ERRORS



           **EINVAL** The last six characters of _template_ were not XXXXXX.  Now
                  _template_ is unchanged.
    
           Also see mkdir(2) for other possible values for _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# io_uring_prep_read_fixed

## NAME



           io_uring_prep_read_fixed - prepare I/O read request with
           registered buffer
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_read_fixed(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **void ***_buf_**,**
                                   **unsigned** _nbytes_**,**
                                   **__u64** _offset_**,**
                                   **int** _buf_index_**);**
    


## DESCRIPTION



           The io_uring_prep_read_fixed(3) prepares an IO read request with a
           previously registered IO buffer. The submission queue entry _sqe_ is
           setup to use the file descriptor _fd_ to start reading _nbytes_ into
           the buffer _buf_ at the specified _offset_ , and with the buffer
           matching the registered index of _buf_index_.
    
           This works just like io_uring_prep_read(3) except it requires the
           use of buffers that have been registered with
           io_uring_register_buffers(3).  The _buf_ and _nbytes_ arguments must
           fall within a region specified by _buf_index_ in the previously
           registered buffer. The buffer need not be aligned with the start
           of the registered buffer.
    
           After the read has been prepared it can be submitted with one of
           the submit functions.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


* * *
# gnutls_ext_get_current_msg

## NAME



           gnutls_ext_get_current_msg - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_ext_get_current_msg(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       a **gnutls_session_t** opaque pointer
    


## DESCRIPTION



           This function allows an extension handler to obtain the message
           this extension is being called from. The returned value is a
           single entry of the **gnutls_ext_flags_t** enumeration. That is, if an
           extension was registered with the **GNUTLS_EXT_FLAG_HRR** and
           **GNUTLS_EXT_FLAG_EE** flags, the value when called during parsing of
           the encrypted extensions message will be **GNUTLS_EXT_FLAG_EE**.
    
           If not called under an extension handler, its value is undefined.
    


## SINCE



           3.6.3
    


* * *
# sd_bus_slot_set_userdata

## NAME



           sd_bus_slot_set_userdata, sd_bus_slot_get_userdata - Set and query
           the value in the "userdata" field
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **void* sd_bus_slot_set_userdata(sd_bus_slot***_slot_**, void***_userdata_**);**
    
           **void* sd_bus_slot_get_userdata(sd_bus_slot***_slot_**);**
    


## DESCRIPTION



           The userdata pointer allows data to be passed between the point
           where a callback is registered, for example when a filter is added
           using sd_bus_add_filter(3) or an asynchronous function call is
           made using sd_bus_call_async(3), and the point where the callback
           is called, without having any global state. The pointer has type
           **void*** and is not used by the sd-bus functions in any way, except
           to pass to the callback function.
    
           Usually, the userdata field is set when the slot object is
           initially registered.  **sd_bus_slot_set_userdata()** may be used to
           change it later for the bus slot object _slot_. Previous value of
           the field is returned. The argument and returned value may be
           **NULL**. It will be passed as the _userdata_ argument to the callback
           function attached to the slot.
    
           **sd_bus_slot_set_userdata()** gets the value of the userdata field in
           the bus slot object _slot_.
    


## RETURN VALUE



           On success, these functions return the value of the userdata field
           before the function call. If the _slot_ object is **NULL** , **NULL** will be
           returned to signify an error, but this is not distinguishable from
           the userdata field value being **NULL**.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# gnutls_privkey_import_openpgp_raw

## NAME



           gnutls_privkey_import_openpgp_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_openpgp_raw(gnutls_privkey_t** _pkey_**, const**
           **gnutls_datum_t ***_data_**, gnutls_openpgp_crt_fmt_t** _format_**, const**
           **gnutls_openpgp_keyid_t** _keyid_**, const char ***_password_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           const gnutls_datum_t * data
                       The private key data to be imported
    
           gnutls_openpgp_crt_fmt_t format
                       The format of the private key
    
           const gnutls_openpgp_keyid_t keyid
                       The key id to use (optional)
    
           const char * password
                       A password (optional)
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.1.0
    


* * *
# gnutls_sign_algorithm_get

## NAME



           gnutls_sign_algorithm_get - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the signature algorithm that is (or will be) used in this
           session by the server to sign data. This function should be used
           only with TLS 1.2 or later.
    


## RETURNS



           The sign algorithm or **GNUTLS_SIGN_UNKNOWN**.
    


## SINCE



           3.1.1
    


* * *
# gnutls_pkcs11_copy_x509_crt2

## NAME



           gnutls_pkcs11_copy_x509_crt2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_x509_crt2(const char ***_token_url_**,**
           **gnutls_x509_crt_t** _crt_**, const char ***_label_**, const gnutls_datum_t ***
           _cid_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_x509_crt_t crt
                       The certificate to copy
    
           const char * label
                       The name to be used for the stored data
    
           const gnutls_datum_t * cid
                       The CKA_ID to set for the object -if NULL, the ID will
                       be derived from the public key
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_FLAG_*
    


## DESCRIPTION



           This function will copy a certificate into a PKCS **11** token
           specified by a URL. Valid flags to mark the certificate:
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_PRIVATE** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_CA** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_ALWAYS_AUTH**.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# pcap_list_tstamp_types

## NAME



           pcap_list_tstamp_types, pcap_free_tstamp_types - get a list of
           time stamp types supported by a capture device, and free that list
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_list_tstamp_types(pcap_t *p, int **tstamp_typesp);**
           **void pcap_free_tstamp_types(int *tstamp_types);**
    


## DESCRIPTION



           **pcap_list_tstamp_types**() is used to get a list of the supported
           time stamp types of the interface associated with the pcap
           descriptor.  **pcap_list_tstamp_types**() allocates an array to hold
           the list and sets _*tstamp_typesp_ to point to the array.  See
           pcap-tstamp(7) for a list of all the time stamp types.
    
           The caller is responsible for freeing the array with
           **pcap_free_tstamp_types**(), which frees the list pointed to by
           _tstamp_types_.
    


## RETURN VALUE



           **pcap_list_tstamp_types**() returns the number of time stamp types in
           the array on success and **PCAP_ERROR** on failure.  A return value of
           one means that the only time stamp type supported is the one in
           the list, which is the capture device's default time stamp type.
           A return value of zero means that the only time stamp type
           supported is **PCAP_TSTAMP_HOST** , which is the capture device's
           default time stamp type (only older versions of libpcap will
           return that; newer versions will always return one or more types).
           If **PCAP_ERROR** is returned, **pcap_geterr**(3PCAP) or
           **pcap_perror**(3PCAP) may be called with _p_ as an argument to fetch or
           display the error text.
    


## BACKWARD COMPATIBILITY



           These functions became available in libpcap release 1.2.1.  In
           previous releases, the time stamp type cannot be set; only the
           default time stamp type offered by a capture source is available.
    


* * *
# mlx5dv_devx_subscribe_devx_event

## NAME



           mlx5dv_devx_subscribe_devx_event - Subscribe over an event channel
           for device events.
    
           mlx5dv_devx_subscribe_devx_event_fd - Subscribe over an event
           channel for device events to signal eventfd.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_devx_subscribe_devx_event(struct mlx5dv_devx_event_channel *dv_event_channel,
                                       struct mlx5dv_devx_obj *obj,
                                       uint16_t events_sz,
                                       uint16_t events_num[],
                                       uint64_t cookie)
    
                  int mlx5dv_devx_subscribe_devx_event_fd(struct mlx5dv_devx_event_channel *dv_event_channel,
                                      int fd,
                                      struct mlx5dv_devx_obj *obj,
                                      uint16_t event_num)
    


## DESCRIPTION



           Subscribe over a DEVX event channel for device events.
    


## ARGUMENTS



           _dv_event_channel_
                  Event channel to subscribe over.
    
           _fd_     A file descriptor that previously was opened by the
                  eventfd() system call.
    
           _obj_    DEVX object that _events_num_ relates to, can be NULL for
                  unaffiliated events.
    
           _events_sz_
                  Size of the _events_num_ buffer that holds the events to
                  subscribe for.
    
           _events_num_
                  Holds the required event numbers to subscribe for, numbers
                  are according to the device specification.
    
           _cookie_ The value to be returned back when reading the event, can
                  be used as an ID for application use.
    


## NOTES



           When mlx5dv_devx_subscribe_devx_event_fd will be used the _fd_ will
           be signaled once an event has occurred.
    


* * *
# pcre2_set_compile_extra_options

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_compile_extra_options(pcre2_compile_context ***_ccontext_**,**
             **uint32_t** _extra_options_**);**
    


## DESCRIPTION



    
           This function sets additional option bits for **pcre2_compile()** that
           are housed in a compile context. It completely replaces all the
           bits. The extra options are:
    
             PCRE2_EXTRA_ALLOW_LOOKAROUND_BSK     Allow \K in lookarounds
             PCRE2_EXTRA_ALLOW_SURROGATE_ESCAPES  Allow \x{d800} to \x{dfff}
                                                    in UTF-8 and UTF-32 modes
             PCRE2_EXTRA_ALT_BSUX                 Extended alternate \u, \U,
           and
                                                    \x handling
             PCRE2_EXTRA_ASCII_BSD                \d remains ASCII in UCP
           mode
             PCRE2_EXTRA_ASCII_BSS                \s remains ASCII in UCP
           mode
             PCRE2_EXTRA_ASCII_BSW                \w remains ASCII in UCP
           mode
             PCRE2_EXTRA_ASCII_DIGIT              [:digit:] and [:xdigit:]
           POSIX classes
                                                    remain ASCII in UCP mode
             PCRE2_EXTRA_ASCII_POSIX              POSIX classes remain ASCII
           in
                                                    UCP mode
             PCRE2_EXTRA_BAD_ESCAPE_IS_LITERAL    Treat all invalid escapes
           as
                                                    a literal following
           character
             PCRE2_EXTRA_CASELESS_RESTRICT        Disable mixed ASCII/non-
           ASCII
                                                    case folding
             PCRE2_EXTRA_ESCAPED_CR_IS_LF         Interpret \r as \n
             PCRE2_EXTRA_MATCH_LINE               Pattern matches whole lines
             PCRE2_EXTRA_MATCH_WORD               Pattern matches "words"
             PCRE2_EXTRA_NEVER_CALLOUT            Disallow callouts in
           pattern
             PCRE2_EXTRA_NO_BS0                   Disallow \0 (but not \00 or
           \000)
             PCRE2_EXTRA_PYTHON_OCTAL             Use Python rules for octal
             PCRE2_EXTRA_TURKISH_CASING           Use Turkish I case folding
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_x509_crl_set_authority_key_id

## NAME



           gnutls_x509_crl_set_authority_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_set_authority_key_id(gnutls_x509_crl_t** _crl_**,**
           **const void ***_id_**, size_t** _id_size_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       a CRL of type **gnutls_x509_crl_t**
    
           const void * id
                       The key ID
    
           size_t id_size
                       Holds the size of the serial field.
    


## DESCRIPTION



           This function will set the CRL's authority key ID extension.  Only
           the keyIdentifier field can be set with this function. This may be
           used by an authority that holds multiple private keys, to
           distinguish the used key.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# function::cpuid

## NAME



           function::cpuid - Returns the current cpu number
    


## SYNOPSIS



               cpuid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the current cpu number. Deprecated in
           SystemTap 1.4 and removed in SystemTap 1.5.
    


* * *
# pmisethostname

## NAME



           **pmiSetHostname** - set the source host name for a LOGIMPORT archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiSetHostname(const char ***_value_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiSetHostname($**_value_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiSetHostname** sets the source hostname in the cur‐
           rent context to be _value_.
    
           In the absence of a call to **pmiSetHostname** the source hostname de‐
           faults to the hostname of the localhost.
    


## DIAGNOSTICS



           **pmiSetHostname** returns zero on success else a negative value  that
           can be turned into an error message by calling pmiErrStr(3).
    


* * *
# fmax

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



           fmax, fmaxf, fmaxl — determine maximum numeric value of two
           floating-point numbers
    


## SYNOPSIS



           #include <math.h>
    
           double fmax(double _x_ , double _y_);
           float fmaxf(float _x_ , float _y_);
           long double fmaxl(long double _x_ , long double _y_);
    


## 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 determine the maximum numeric value of their
           arguments.  NaN arguments shall be treated as missing data: if one
           argument is a NaN and the other numeric, then these functions
           shall choose the numeric value.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           maximum numeric value of their arguments.
    
           If just one argument is a NaN, the other argument shall be
           returned.
    
           If _x_ and _y_ are NaN, a NaN shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_madvise64

## NAME



           io_uring_prep_madvise - prepare a madvise request
    


## SYNOPSIS



           **#include <sys/mman.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_madvise(struct io_uring_sqe ***_sqe_**,**
                                      **void ***_addr_**,**
                                      **__u32** _len_**,**
                                      **int** _advice_**);**
    
           **void io_uring_prep_madvise64(struct io_uring_sqe ***_sqe_**,**
                                        **void ***_addr_**,**
                                        **off_t** _len_**,**
                                        **int** _advice_**);**
    


## DESCRIPTION



           The io_uring_prep_madvise(3) function prepares an madvise request.
           The submission queue entry _sqe_ is setup to start an madvise
           operation at the virtual address of _addr_ and of _len_ length in
           bytes, giving it the advise located in _advice_.
    
           The io_uring_prep_madvise64(3) function works like
           io_uring_prep_madvise(3) except that it takes a 64-bit length
           rather than just a 32-bit one. Older kernels may not support the
           64-bit length variant. If this variant is attempted used on a
           kernel that doesn't support 64-bit lengths, then the request will
           get errored with **-EINVAL** in the results field of the CQE.
    
           This function prepares an async madvise(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. 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.
    


* * *