tripathysagar/man_text huggingface dataset:
# mlx5dv_devx_create_event_channel

## NAME



           mlx5dv_devx_create_event_channel - Create an event channel to be
           used for DEVX asynchronous events.
    
           mlx5dv_devx_destroy_event_channel - Destroy a DEVX event channel.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_event_channel {
                      int fd;
                  };
    
                  struct mlx5dv_devx_event_channel *
                  mlx5dv_devx_create_event_channel(struct ibv_context *context,
                                                   enum mlx5dv_devx_create_event_channel_flags flags)
    
                  void mlx5dv_devx_destroy_event_channel(struct mlx5dv_devx_event_channel *event_channel)
    


## DESCRIPTION



           Create or destroy a channel to be used for DEVX asynchronous
           events.
    
           The create verb exposes an mlx5dv_devx_event_channel object that
           can be used to read asynchronous DEVX events.  This lets an
           application to subscribe to get device events and once an event
           occurred read it from this object.
    


## ARGUMENTS



           _context_
    
                  RDMA device context to create the channel on.
    
           _flags_  MLX5DV_DEVX_CREATE_EVENT_CHANNEL_FLAGS_OMIT_EV_DATA: omit
                  the event data on this channel.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_event_channel_ will return a new
           _struct mlx5dv_devx_event_channel_ object, on error NULL will be
           returned and errno will be set.
    


* * *
# mlx5dv_devx_destroy_cmd_comp

## NAME



           mlx5dv_devx_create_cmd_comp - Create a command completion to be
           used for DEVX asynchronous commands.
    
           mlx5dv_devx_destroy_cmd_comp - Destroy a devx command completion.
    
           mlx5dv_devx_get_async_cmd_comp - Get an asynchronous command
           completion.  # SYNOPSIS
    
                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_cmd_comp {
                      int fd;
                  };
    
                  struct mlx5dv_devx_cmd_comp *
                  mlx5dv_devx_create_cmd_comp(struct ibv_context *context)
    
                  void mlx5dv_devx_destroy_cmd_comp(struct mlx5dv_devx_cmd_comp *cmd_comp)
    
                  struct mlx5dv_devx_async_cmd_hdr {
                      uint64_t    wr_id;
                      uint8_t     out_data[];
                  };
    
                  int mlx5dv_devx_get_async_cmd_comp(struct mlx5dv_devx_cmd_comp *cmd_comp,
                                     struct mlx5dv_devx_async_cmd_hdr *cmd_resp,
                                     size_t cmd_resp_len)
    


## DESCRIPTION



           Create or destroy a command completion to be used for DEVX
           asynchronous commands.
    
           The create verb exposes an mlx5dv_devx_cmd_comp object that can be
           used as part of asynchronous DEVX commands.  This lets an
           application run asynchronously without blocking and once the
           response is ready read it from this object.
    
           The response can be read by the mlx5dv_devx_get_async_cmd_comp()
           API, upon response the _wr_id_ that was supplied upon the
           asynchronous command is returned and the _out_data_ includes the
           data itself.  The application must supply a large enough buffer to
           match any command that was issued on the _cmd_comp_ , its size is
           given by the input _cmd_resp_len_ parameter.
    


## ARGUMENTS



           _context_
    
                  RDMA device context to create the action on.
    
           _cmd_comp_
                  The command completion object.
    
           _cmd_resp_
                  The output data from the asynchronous command.
    
           _cmd_resp_len_
                  The output buffer size to hold the response.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_cmd_comp_ will return a new _struct_
           _mlx5dv_devx_cmd_comp_ object, on error NULL will be returned and
           errno will be set.
    
           Upon success _mlx5dv_devx_get_async_cmd_comp_ will return 0,
           otherwise errno will be returned.
    


* * *
# TIMEVAL_TO_TIMESPEC

## NAME



           TIMEVAL_TO_TIMESPEC, TIMESPEC_TO_TIMEVAL - convert between time
           structures
    


## SYNOPSIS



           **#define _GNU_SOURCE**
           **#include <sys/time.h>**
    
           **void TIMEVAL_TO_TIMESPEC(const struct timeval ***_tv_**, struct timespec ***_ts_**);**
           **void TIMESPEC_TO_TIMEVAL(struct timeval ***_tv_**, const struct timespec ***_ts_**);**
    


## DESCRIPTION



           These macros convert from a timeval(3type) to a timespec(3type)
           structure, and vice versa, respectively.
    
           This is especially useful for writing interfaces that receive a
           type, but are implemented with calls to functions that receive the
           other one.
    


## STANDARDS



           GNU, BSD.
    


* * *
# pmpathseparator

## NAME



           **pmPathSeparator** - return the filesystem path separator character
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmPathSeparator(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmPathSeparator** is a convenience method that returns ``/'' in  the
           civilized world.  For Windows platforms you may get ``/'' or ``\''
           depending on the run-time environment.
    
           The  most  common  use  scenario is to use **pmPathSeparator** to con‐
           struct the full pathname for a file from a  known  directory  name
           and a relative file name.
    


* * *
# clog10

## NAME



           clog10, clog10f, clog10l - base-10 logarithm of a complex number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <complex.h>**
    
           **double complex clog10(double complex** _z_**);**
           **float complex clog10f(float complex** _z_**);**
           **long double complex clog10l(long double complex** _z_**);**
    


## DESCRIPTION



           The call _clog10(z)_ is equivalent to:
    
               clog(z)/log(10)
    
           or equally:
    
               log10(cabs(c)) + I * carg(c) / log(10)
    
           The other functions perform the same task for _float_ and _long_
           _double_.
    
           Note that _z_ close to zero will cause an overflow.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


* * *
# gnutls_pubkey_export2

## NAME



           gnutls_pubkey_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export2(gnutls_pubkey_t** _key_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the certificate
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a certificate PEM or DER encoded
    


## DESCRIPTION



           This function will export the public key to DER or PEM format.
           The contents of the exported data is the SubjectPublicKeyInfo
           X.509 structure.
    
           The output buffer will be allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           CERTIFICATE".
    


## RETURNS



           In case of failure a negative error code will be returned, and 0
           on success.
    


## SINCE



           3.1.3
    


* * *
# menu_format

## NAME



           **set_menu_format** , **menu_format** - set and get menu sizes
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_format(MENU ***_menu_**, int** _rows_**, int** _cols_**);**
           **void menu_format(const MENU ***_menu_**, int ***_rows_**, int ***_cols_**);**
    


## DESCRIPTION



           The function **set_menu_format** sets the maximum display size of the
           given menu.  If this size is too small to display all menu items,
           the menu will be made scrollable.  If this size is larger than the
           menus subwindow and the subwindow is too small to display all menu
           items, **post_menu** will fail.
    
           The default format is 16 rows, 1 column.  Calling **set_menu_format**
           with a null menu pointer will change this default.  A zero row or
           column argument to **set_menu_format** is interpreted as a request not
           to change the current value.
    
           The function **menu_format** returns the maximum-size constraints for
           the given menu into the storage addressed by **rows** and **cols**.
    


## RETURN VALUE



           These routines returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_POSTED**
                The menu is already posted.
    
           **E_NOT_CONNECTED**
                No items are connected to the menu.
    


## NOTES



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


## PORTABILITY



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


* * *
# probe::stap.pass5

## NAME



           probe::stap.pass5 - Starting stap pass5 (running the
           instrumentation)
    


## SYNOPSIS



           stap.pass5
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass5 fires just after the call to **gettimeofday** , just before the
           call to run_pass.
    


* * *
# copysign

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



           copysign, copysignf, copysignl — number manipulation function
    


## SYNOPSIS



           #include <math.h>
    
           double copysign(double _x_ , double _y_);
           float copysignf(float _x_ , float _y_);
           long double copysignl(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 produce a value with the magnitude of _x_ and
           the sign of _y_.  On implementations that represent a signed zero
           but do not treat negative zero consistently in arithmetic
           operations, these functions regard the sign of zero as positive.
    


## RETURN VALUE



           Upon successful completion, these functions shall return a value
           with the magnitude of _x_ and the sign of _y_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# rdma_free_devices

## NAME



           rdma_free_devices - Frees the list of devices returned by
           rdma_get_devices.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **void rdma_free_devices (struct ibv_context ****_list_**);**
    


## ARGUMENTS



           list        List of devices returned from rdma_get_devices.
    


## DESCRIPTION



           Frees the device array returned by rdma_get_devices.
    


## RETURN VALUE



           None
    


* * *
# io_uring_free_reg_wait

## NAME



           io_uring_free_reg_wait - Frees a previously registered wait region
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_free_reg_wait(struct io_uring ***_ring_**,**
                                       **unsigned** _nentries_**);**
    


## DESCRIPTION



           The io_uring_free_reg_wait(3) function frees a wait region for the
           ring _ring_ of _nentries_ previously setup with
           io_uring_setup_reg_wait(3).  As registered wait regions persist
           for the life time of the ring, on the kernel side the wait regions
           still remain active, and may in fact still be used by the
           application for wait operations. They may just no longer be
           modified by the application.
    
           Available since kernel 6.13.
    


* * *
# sd_bus_slot_set_description

## NAME



           sd_bus_slot_set_description, sd_bus_slot_get_description - Set or
           query the description of bus slot objects
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_slot_set_description(sd_bus_slot***_slot_**,**
                                           **const char ***_description_**);**
    
           **int sd_bus_slot_get_description(sd_bus_slot***_bus_**,**
                                           **const char ****_description_**);**
    


## DESCRIPTION



           **sd_bus_slot_set_description()** sets the description string that is
           used in logging to the specified string. The string is copied
           internally and freed when the bus slot object is deallocated. The
           _description_ argument may be **NULL** , in which case the description is
           unset.
    
           **sd_bus_slot_get_description()** returns a description string in
           _description_. If the string is not set, e.g. with
           **sd_bus_slot_set_description()** , and the slot is a bus match
           callback slot, the match string will be returned. Otherwise,
           **-ENXIO** is returned.
    


## RETURN VALUE



           On success, these functions return 0 or a positive integer. On
           failure, they return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               An required argument is **NULL**.
    
           **-ENXIO**
               The bus slot object has no description.
    
           **-ENOMEM**
               Memory allocation failed.
    


## NOTES



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


* * *
# strsignal

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



           strsignal — get name of signal
    


## SYNOPSIS



           #include <string.h>
    
           char *strsignal(int _signum_);
    


## DESCRIPTION



           The _strsignal_() function shall map the signal number in _signum_ to
           an implementation-defined string and shall return a pointer to it.
           It shall use the same set of messages as the _psignal_() function.
    
           The application shall not modify the string returned. The returned
           pointer might be invalidated or the string content might be
           overwritten by a subsequent call to _strsignal_() or _setlocale_().
           The returned pointer might also be invalidated if the calling
           thread is terminated.
    
           The contents of the message strings returned by _strsignal_() should
           be determined by the setting of the _LC_MESSAGES_ category in the
           current locale.
    
           The implementation shall behave as if no function defined in this
           standard calls _strsignal_().
    
           Since no return value is reserved to indicate an error, an
           application wishing to check for error situations should set _errno_
           to 0, then call _strsignal_(), then check _errno_.
    
           The _strsignal_() function need not be thread-safe.
    


## RETURN VALUE



           Upon successful completion, _strsignal_() shall return a pointer to
           a string. Otherwise, if _signum_ is not a valid signal number, the
           return value is unspecified.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           If _signum_ is not a valid signal number, some implementations
           return NULL, while for others the _strsignal_() function returns a
           pointer to a string containing an unspecified message denoting an
           unknown signal. POSIX.1‐2008 leaves this return value unspecified.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# atan2

## NAME



           atan2, atan2f, atan2l - arc tangent function of two variables
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions calculate the principal value of the arc tangent
           of _y/x_ , using the signs of the two arguments to determine the
           quadrant of the result.
    


## RETURN VALUE



           On success, these functions return the principal value of the arc
           tangent of _y/x_ in radians; the return value is in the range
           [-pi, pi].
    
           If _y_ is +0 (-0) and _x_ is less than 0, +pi (-pi) is returned.
    
           If _y_ is +0 (-0) and _x_ is greater than 0, +0 (-0) is returned.
    
           If _y_ is less than 0 and _x_ is +0 or -0, -pi/2 is returned.
    
           If _y_ is greater than 0 and _x_ is +0 or -0, pi/2 is returned.
    
           If either _x_ or _y_ is NaN, a NaN is returned.
    
           If _y_ is +0 (-0) and _x_ is -0, +pi (-pi) is returned.
    
           If _y_ is +0 (-0) and _x_ is +0, +0 (-0) is returned.
    
           If _y_ is a finite value greater (less) than 0, and _x_ is negative
           infinity, +pi (-pi) is returned.
    
           If _y_ is a finite value greater (less) than 0, and _x_ is positive
           infinity, +0 (-0) is returned.
    
           If _y_ is positive infinity (negative infinity), and _x_ is finite,
           pi/2 (-pi/2) is returned.
    
           If _y_ is positive infinity (negative infinity) and _x_ is negative
           infinity, +3*pi/4 (-3*pi/4) is returned.
    
           If _y_ is positive infinity (negative infinity) and _x_ is positive
           infinity, +pi/4 (-pi/4) is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# probe::ipmib.InAddrErrors

## NAME



           probe::ipmib.InAddrErrors - Count arriving packets with an
           incorrect address
    


## SYNOPSIS



           ipmib.InAddrErrors
    


## VALUES



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


## DESCRIPTION



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


* * *
# function::print_stack

## NAME



           function::print_stack - Print out kernel stack from string
    


## SYNOPSIS



               print_stack(stk:string)
    


## ARGUMENTS



           _stk_
               String with list of hexadecimal addresses
    


## DESCRIPTION



           This function performs a symbolic lookup of the addresses in the
           given string, which is assumed to be the result of a prior call to
           **backtrace**.
    
           Print one line per address, including the address, the name of the
           function containing the address, and an estimate of its position
           within that function. Return nothing.
    


## NOTE



           it is recommended to use **print_syms** instead of this function.
    


* * *
# menu_userptr

## NAME



           **set_menu_userptr** , **menu_userptr** - associate application data with a
           menu item
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_userptr(MENU ***_menu_**, void ***_userptr_**);**
           **void *menu_userptr(const MENU ***_menu_**);**
    


## DESCRIPTION



           Every menu and every menu item has a field that can be used to
           hold application-specific data (that is, the menu-driver code
           leaves it alone).  These functions get and set the menu user
           pointer field.
    


## RETURN VALUE



           **menu_userptr** returns a pointer (which may be **NULL**).  It does not
           set **errno**.
    
           **set_menu_userptr** returns **E_OK**(success).
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    
           The user pointer is a void pointer.  We chose not to leave it as a
           char pointer for SVr4 compatibility.
    


* * *
# curs_legacy

## NAME



           curs_legacy - get **curses** cursor and window coordinates, attributes
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int getattrs(const WINDOW ***_win_**);**
    
           **int getbegx(const WINDOW ***_win_**);**
           **int getbegy(const WINDOW ***_win_**);**
    
           **int getcurx(const WINDOW ***_win_**);**
           **int getcury(const WINDOW ***_win_**);**
    
           **int getmaxx(const WINDOW ***_win_**);**
           **int getmaxy(const WINDOW ***_win_**);**
    
           **int getparx(const WINDOW ***_win_**);**
           **int getpary(const WINDOW ***_win_**);**
    


## DESCRIPTION



           These legacy functions are simpler to use than the X/Open Curses
           functions:
    
           •   The **getattrs** function returns the same attribute data as
               **wattr_get**.
    
               However, **getattrs** returns an integer (actually a **chtype**),
               while **wattr_get** returns the current color pair in a separate
               parameter.  In the wide-character library configuration, color
               pairs may not fit into a **chtype** , so **wattr_get** is the only way
               to obtain the color information.
    
               Because **getattrs** returns the attributes in a single parameter,
               it would not be possible for an application to distinguish
               that from **ERR**(a _-1_).  If the window parameter is null,
               **getattrs** returns **A_NORMAL**(zero).
    
           •   The **getbegy** and **getbegx** functions return the same data as
               **getbegyx**.
    
           •   The **getcury** and **getcurx** functions return the same data as
               **getyx**.
    
           •   The **getmaxy** and **getmaxx** functions return the same data as
               **getmaxyx**.
    
           •   The **getpary** and **getparx** functions return the same data as
               **getparyx**.
    


## RETURN VALUE



           Except as noted, these functions return an integer, or **ERR** if the
           window parameter is null.
    


## NOTES



           All of these interfaces are provided as macros and functions.  The
           macros are suppressed (and only the functions provided) when
           **NCURSES_OPAQUE** is defined.  The standard forms such as **getyx** must
           be implemented as macros, and (in this implementation) are defined
           in terms of the functions described here, to avoid reliance on
           internal details of the WINDOW structure.
    


## PORTABILITY



           These functions were supported on Version 7, BSD or System V
           implementations.  None of those implementations checked the window
           parameter.
    
           The **getattrs** function and macro are defined to return a (signed)
           integer for compatibility with those implementations although an
           unsigned type would have been more appropriate.
    


* * *
# gnutls_handshake_set_secret_function

## NAME



           gnutls_handshake_set_secret_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_handshake_set_secret_function(gnutls_session_t**
           _session_**, gnutls_handshake_secret_func** _func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_handshake_secret_func func
                       the secret func
    


## DESCRIPTION



           This function will set a callback to be called when a new traffic
           secret is installed.
    


## SINCE



           3.7.0
    


* * *
# gnutls_pkcs11_obj_set_pin_function

## NAME



           gnutls_pkcs11_obj_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void gnutls_pkcs11_obj_set_pin_function(gnutls_pkcs11_obj_t** _obj_**,**
           **gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       The object structure
    
           gnutls_pin_callback_t fn
                       the callback
    
           void * userdata
                       data associated with the callback
    


## DESCRIPTION



           This function will set a callback function to be used when
           required to access the object. This function overrides the global
           set using **gnutls_pkcs11_set_pin_function()**.
    


## SINCE



           3.1.0
    


* * *
# gnutls_record_send_range

## NAME



           gnutls_record_send_range - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_send_range(gnutls_session_t** _session_**, const**
           **void ***_data_**, size_t** _data_size_**, const gnutls_range_st ***_range_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           const void * data
                       contains the data to send.
    
           size_t data_size
                       is the length of the data.
    
           const gnutls_range_st * range
                       is the range of lengths in which the real data length
                       must be hidden.
    


## DESCRIPTION



           This function operates like **gnutls_record_send()** but, while
           **gnutls_record_send()** adds minimal padding to each TLS record, this
           function uses the TLS extra-padding feature to conceal the real
           data size within the range of lengths provided.  Some TLS sessions
           do not support extra padding (e.g. stream ciphers in standard TLS
           or SSL3 sessions). To know whether the current session supports
           extra padding, and hence length hiding, use the
           **gnutls_record_can_use_length_hiding()** function.
    


## NOTE



           This function currently is limited to blocking sockets.
    


## RETURNS



           The number of bytes sent (that is data_size in a successful
           invocation), or a negative error code.
    


* * *
# gnutls_ocsp_req_add_cert

## NAME



           gnutls_ocsp_req_add_cert - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_add_cert(gnutls_ocsp_req_t** _req_**,**
           **gnutls_digest_algorithm_t** _digest_**, gnutls_x509_crt_t** _issuer_**,**
           **gnutls_x509_crt_t** _cert_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           gnutls_digest_algorithm_t digest
                       hash algorithm, a **gnutls_digest_algorithm_t** value
    
           gnutls_x509_crt_t issuer
                       issuer of  _subject_ certificate
    
           gnutls_x509_crt_t cert
                       certificate to request status for
    


## DESCRIPTION



           This function will add another request to the OCSP request for a
           particular certificate.  The issuer name hash, issuer key hash,
           and serial number fields is populated as follows.  The issuer name
           and the serial number is taken from  _cert_ .  The issuer key is
           taken from  _issuer_ .  The hashed values will be hashed using the
           _digest_ algorithm, normally **GNUTLS_DIG_SHA1**.
    


## RETURNS



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


* * *
# gnutls_x509_crq_print

## NAME



           gnutls_x509_crq_print - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_print(gnutls_x509_crq_t** _crq_**,**
           **gnutls_certificate_print_formats_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       The data to be printed
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print a certificate request, suitable
           for display to a human.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# gnutls_pubkey_export_ecc_x962

## NAME



           gnutls_pubkey_export_ecc_x962 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_ecc_x962(gnutls_pubkey_t** _key_**,**
           **gnutls_datum_t ***_parameters_**, gnutls_datum_t ***_ecpoint_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_datum_t * parameters
                       DER encoding of an ANSI X9.62 parameters
    
           gnutls_datum_t * ecpoint
                       DER encoding of ANSI X9.62 ECPoint
    


## DESCRIPTION



           This function will export the ECC public key's parameters found in
           the given certificate.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_credentials_set

## NAME



           gnutls_credentials_set - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_credentials_set(gnutls_session_t** _session_**,**
           **gnutls_credentials_type_t** _type_**, void ***_cred_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_credentials_type_t type
                       is the type of the credentials
    
           void * cred the credentials to set
    


## DESCRIPTION



           Sets the needed credentials for the specified type.  E.g.
           username, password - or public and private keys etc.  The  _cred_
           parameter is a structure that depends on the specified type and on
           the current session (client or server).
    
           In order to minimize memory usage, and share credentials between
           several threads gnutls keeps a pointer to cred, and not the whole
           cred structure.  Thus you will have to keep the structure
           allocated until you call **gnutls_deinit()**.
    
           For **GNUTLS_CRD_ANON** ,  _cred_ should be
           **gnutls_anon_client_credentials_t** in case of a client.  In case of
           a server it should be **gnutls_anon_server_credentials_t**.
    
           For **GNUTLS_CRD_SRP** ,  _cred_ should be
           **gnutls_srp_client_credentials_t** in case of a client, and
           **gnutls_srp_server_credentials_t** , in case of a server.
    
           For **GNUTLS_CRD_CERTIFICATE** ,  _cred_ should be
           **gnutls_certificate_credentials_t**.
    


## RETURNS



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


* * *
# gnutls_protocol_get_name

## NAME



           gnutls_protocol_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_protocol_get_name(gnutls_protocol_t** _version_**);**
    


## ARGUMENTS



           gnutls_protocol_t version
                       is a (gnutls) version number
    


## DESCRIPTION



           Convert a **gnutls_protocol_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified TLS version
           (e.g., "TLS1.0"), or **NULL**.
    


* * *
# ibv_node_type_str

## NAME



           ibv_event_type_str - Return string describing event_type enum
           value
    
           ibv_node_type_str - Return string describing node_type enum value
    
           ibv_port_state_str - Return string describing port_state enum
           value
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  const char *ibv_event_type_str(enum ibv_event_type event_type);
    
                  const char *ibv_node_type_str(enum ibv_node_type node_type);
    
                  const char *ibv_port_state_str(enum ibv_port_state port_state);
    


## DESCRIPTION



           **ibv_node_type_str()** returns a string describing the node type enum
           value _node_type_.
    
           **ibv_port_state_str()** returns a string describing the port state
           enum value _port_state_.
    
           **ibv_event_type_str()** returns a string describing the event type
           enum value _event_type_.
    


## RETURN VALUE



           These functions return a constant string that describes the enum
           value passed as their argument.
    


* * *
# gnutls_pubkey_get_spki

## NAME



           gnutls_pubkey_get_spki - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function will return the public key information if available.
           The provided  _spki_ must be initialized.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# gnutls_anti_replay_set_ptr

## NAME



           gnutls_anti_replay_set_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_anti_replay_set_ptr(gnutls_anti_replay_t** _anti_replay_**,**
           **void ***_ptr_**);**
    


## ARGUMENTS



           gnutls_anti_replay_t anti_replay
                       is a **gnutls_anti_replay_t** type.
    
           void * ptr  is the pointer
    


## DESCRIPTION



           Sets the pointer that will be provided to db add function as the
           first argument.
    


* * *
# gnutls_hash

## NAME



           gnutls_hash - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hash(gnutls_hash_hd_t** _handle_**, const void ***_ptext_**,**
           **size_t** _ptext_len_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t handle
                       is a **gnutls_hash_hd_t** type
    
           const void * ptext
                       the data to hash
    
           size_t ptext_len
                       the length of data to hash
    


## DESCRIPTION



           This function will hash the given data using the algorithm
           specified by the context.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# gnutls_x509_crl_print

## NAME



           gnutls_x509_crl_print - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_print(gnutls_x509_crl_t** _crl_**,**
           **gnutls_certificate_print_formats_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       The data to be printed
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print a X.509 certificate revocation
           list, suitable for display to a human.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


* * *
# probe::socket.recvmsg

## NAME



           probe::socket.recvmsg - Message being received on socket
    


## SYNOPSIS



           socket.recvmsg
    


## VALUES



           _flags_
               Socket flags value
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    
           _size_
               Message size in bytes
    
           _family_
               Protocol family value
    


## CONTEXT



           The message receiver.
    


## DESCRIPTION



           Fires at the beginning of receiving a message on a socket via the
           **sock_recvmsg** function
    


* * *
# libpfm_arm_xgene

## NAME



           libpfm_arm_ac57 - support for Applied Micro X-Gene PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_xgene**
           **PMU desc: Applied Micro X-Gene**
    


## DESCRIPTION



           The library supports the Applied Micro X-Gene PMU.
    
           This PMU supports 6 counters and privilege levels filtering.  It
           can operate in both 32 and 64 bit modes.
    


## MODIFIERS



           The following modifiers are supported on Applied Micro X-Gene:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *
# gnutls_pkcs7_signature_info_deinit

## NAME



           gnutls_pkcs7_signature_info_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **void**
           **gnutls_pkcs7_signature_info_deinit(gnutls_pkcs7_signature_info_st**
           *****_info_**);**
    


## ARGUMENTS



           gnutls_pkcs7_signature_info_st * info
                       should point to a **gnutls_pkcs7_signature_info_st**
                       structure
    


## DESCRIPTION



           This function will deinitialize any allocated value in the
           provided **gnutls_pkcs7_signature_info_st**.
    


## SINCE



           3.4.2
    


* * *
# rdma_get_src_port

## NAME



           rdma_get_src_port - Returns the local port number of a bound
           rdma_cm_id.
    


## SYNOPSIS



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


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Returns the local port number for an rdma_cm_id that has been
           bound to a local address.
    


## RETURN VALUE



           Returns the 16-bit port identifier associated with the local
           endpoint.  If the rdma_cm_id is not bound to a port, the returned
           value is 0.
    


* * *
# probe::nfs.fop.read

## NAME



           probe::nfs.fop.read - NFS client read operation
    


## SYNOPSIS



           nfs.fop.read
    


## VALUES



           _devname_
               block device name
    


## DESCRIPTION



           SystemTap uses the vfs.do_sync_read probe to implement this probe
           and as a result will get operations other than the NFS client read
           operations.
    


* * *
# floor

## NAME



           floor, floorf, floorl - largest integral value not greater than
           argument
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the largest integral value that is not
           greater than _x_.
    
           For example, _floor(0.5)_ is 0.0, and _floor(-0.5)_ is -1.0.
    


## RETURN VALUE



           These functions return the floor of _x_.
    
           If _x_ is integral, +0, -0, NaN, or an infinity, _x_ itself is
           returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmusecontext

## NAME



           **pmUseContext** - change current PMAPI context
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmUseContext(int** _handle_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           An  application using the Performance Metrics Application Program‐
           ming Interface (PMAPI) may manipulate several concurrent contexts,
           each associated with a source of performance metrics, e.g. pmcd(1)
           on some host, or an archive of performance metrics as  created  by
           pmlogger(1).
    
           Calling **pmUseContext** causes the current PMAPI context to be set to
           the context identified by _handle_.  The value of _handle_ must be one
           returned    from   an   earlier   call   to   pmNewContext(3)   or
           pmDupContext(3).
    
           Below the PMAPI, all contexts used by an application are saved  in
           their  most  recently modified state, so **pmUseContext** restores the
           context to the state it was in the last time the context was used,
           not the state of the context when it was established.
    


## DIAGNOSTICS



           **PM_ERR_NOCONTEXT**
    
                  _handle_ does not identify a valid PMAPI context
    


* * *