tripathysagar/man_text huggingface dataset:
# tan

## NAME



           tan, tanf, tanl - tangent function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the tangent of _x_ , where _x_ is given in
           radians.
    


## RETURN VALUE



           On success, these functions return the tangent of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is positive infinity or negative infinity, a domain error
           occurs, and a NaN is returned.
    
           If the correct result would overflow, a range error occurs, and
           the functions return **HUGE_VAL** , **HUGE_VALF** , or **HUGE_VALL** ,
           respectively, with the mathematically correct sign.
    


## 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
                  _errno_ is set to **EDOM**(but see BUGS).  An invalid floating-
                  point exception (**FE_INVALID**) is raised.
    
           Range error: result overflow
                  An overflow floating-point exception (**FE_OVERFLOW**) is
                  raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           Before glibc 2.10, the glibc implementation did not set _errno_ to
           **EDOM** when a domain error occurred.
    


* * *
# gnutls_record_send

## NAME



           gnutls_record_send - API function
    


## SYNOPSIS



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


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


## DESCRIPTION



           This function has the similar semantics with **send()**.  The only
           difference is that it accepts a GnuTLS session, and uses different
           error codes.  Note that if the send buffer is full, **send()** will
           block this function.  See the **send()** documentation for more
           information.
    
           You can replace the default push function which is **send()** , by
           using **gnutls_transport_set_push_function()**.
    
           If the EINTR is returned by the internal push function then
           **GNUTLS_E_INTERRUPTED** will be returned. If **GNUTLS_E_INTERRUPTED** or
           **GNUTLS_E_AGAIN** is returned, you must call this function again with
           the exact same parameters, or provide a **NULL** pointer for  _data_ and
           0 for  _data_size_ , in order to write the same data as before. If
           you wish to discard the previous data instead of retrying, you
           must call **gnutls_record_discard_queued()** before calling this
           function with different parameters. Note that the latter works
           only on special transports (e.g., UDP).  cf.
           **gnutls_record_get_direction()**.
    
           Note that in DTLS this function will return the
           **GNUTLS_E_LARGE_PACKET** error code if the send data exceed the data
           MTU value - as returned by **gnutls_dtls_get_data_mtu()**. The errno
           value EMSGSIZE also maps to **GNUTLS_E_LARGE_PACKET**.  Note that
           since 3.2.13 this function can be called under cork in DTLS mode,
           and will refuse to send data over the MTU size by returning
           **GNUTLS_E_LARGE_PACKET**.
    


## RETURNS



           The number of bytes sent, or a negative error code.  The number of
           bytes sent might be less than  _data_size_ .  The maximum number of
           bytes this function can send in a single call depends on the
           negotiated maximum record size.
    


* * *
# gnutls_certificate_free_crls

## NAME



           gnutls_certificate_free_crls - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_certificate_free_crls(gnutls_certificate_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    


## DESCRIPTION



           This function will delete all the CRLs associated with the given
           credentials.
    


* * *
# gnutls_get_system_config_file

## NAME



           gnutls_get_system_config_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_get_system_config_file(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Returns the filename of the system wide configuration file to be
           loaded by the library.
    


## RETURNS



           a constant pointer to the config file path
    


## SINCE



           3.6.9
    


* * *
# gnutls_x509_crt_set_crl_dist_points

## NAME



           gnutls_x509_crt_set_crl_dist_points - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_crl_dist_points(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_subject_alt_name_t** _type_**, const void ***_data_string_**,**
           **unsigned int** _reason_flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_subject_alt_name_t type
                       is one of the gnutls_x509_subject_alt_name_t
                       enumerations
    
           const void * data_string
                       The data to be set
    
           unsigned int reason_flags
                       revocation reasons
    


## DESCRIPTION



           This function will set the CRL distribution points certificate
           extension.
    


## RETURNS



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


* * *
# probe::netdev.change_rx_flag

## NAME



           probe::netdev.change_rx_flag - Called when the device RX flag will
           be changed
    


## SYNOPSIS



           netdev.change_rx_flag
    


## VALUES



           _flags_
               The new flags
    
           _dev_name_
               The device that will be changed
    


* * *
# mlx5dv_devx_destroy_eq

## NAME



           mlx5dv_devx_create_eq - Create an EQ object
    
           mlx5dv_devx_destroy_eq - Destroy an EQ object
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_eq *
                  mlx5dv_devx_create_eq(struct ibv_context *ibctx, const void *in, size_t inlen,
                                void *out, size_t outlen);
    
                  int mlx5dv_devx_destroy_eq(struct mlx5dv_devx_eq *eq);
    


## DESCRIPTION



           Create / Destroy an EQ object.  Upon creation, the caller prepares
           the in/out mail boxes based on the device specification format;
           For the input mailbox, caller needs to prepare all fields except
           “eqc.log_page_size” and the pas list, which will be set by the
           driver.  The “eqc.intr” field should be used from the output of
           mlx5dv_devx_alloc_msi_vector().
    


## ARGUMENTS



           _ibctx_  RDMA device context to create the action on.
    
           _in_     A buffer which contains the command’s input data provided
                  in a device specification format.
    
           _inlen_  The size of _in_ buffer in bytes.
    
           _out_    A buffer which contains the command’s output data according
                  to the device specification format.
    
           _outlen_ The size of _out_ buffer in bytes.
    
           _eq_     The EQ object to work on.
    
                  struct mlx5dv_devx_eq {
                      void *vaddr;
                  };
    
           _vaddr_  EQ VA that was allocated in the driver for.
    


## NOTES



           mlx5dv_devx_query_eqn() will not support vectors which are used by
           mlx5dv_devx_create_eq().
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_eq_ will return a new _struct_
           _mlx5dv_devx_eq_ ; On error NULL will be returned and errno will be
           set.
    
           Upon success _mlx5dv_devx_destroy_eq_ will return 0, on error errno
           will be returned.
    
           If the error value is EREMOTEIO, outbox.status and outbox.syndrome
           will contain the command failure details.
    


* * *
# function::local_clock_ns

## NAME



           function::local_clock_ns - Number of nanoseconds on the local
           cpu's clock
    


## SYNOPSIS



               local_clock_ns:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of nanoseconds on the local cpu's
           clock. This is always monotonic comparing on the same cpu, but may
           have some drift between cpus (within about a jiffy).
    


* * *
# cproj

## NAME



           cproj, cprojf, cprojl - project into Riemann Sphere
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cproj(double complex** _z_**);**
           **float complex cprojf(float complex** _z_**);**
           **long double complex cprojl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions project a point in the plane onto the surface of a
           Riemann Sphere, the one-point compactification of the complex
           plane.  Each finite point _z_ projects to _z_ itself.  Every complex
           infinite value is projected to a single infinite value, namely to
           positive infinity on the real axis.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# auparse_get_field_name

## NAME



           auparse_get_field_name - get current field's name
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **const char * auparse_get_field_name(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_get_field_name allows access to the current field name of
           the current record in the current event.
    


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, a pointer to the
           field's name.
    


* * *
# signbit

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



           signbit — test sign
    


## SYNOPSIS



           #include <math.h>
    
           int signbit(real-floating _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _signbit_() macro shall determine whether the sign of its
           argument value is negative. NaNs, zeros, and infinities have a
           sign bit.
    


## RETURN VALUE



           The _signbit_() macro shall return a non-zero value if and only if
           the sign of its argument value is negative.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ll2_read_all

## NAME



           ll2_read_all - Reads all entries from database and calls the
           callback function for each entry.
    


## SYNOPSIS



           **#include <lastlog2.h> int ll2_read_all (struct ll2_context**
           *****_context_**, int (***_callback_**)(const char ***_user_**, int64_t** _ll_time_**, const**
           **char ***_tty_**, const char ***_rhost_**, const char ***_pam_service_**, const char**
           *****_cb_error_**), char ****_error_**);**
    


## DESCRIPTION



           Reads all entries from database, defined in _context_ , and calls
           callback function _callback_ for each entry. If _context_ is NULL, the
           default database, defined in _LL2_DEFAULT_DATABASE_ , will be taken.
    
               char  *error = NULL;
               const char *user = "root";
    
               static int
               callback (const char *res_user, int64_t ll_time, const char *res_tty,
                         const char *res_rhost, const char *res_service, const char *cb_error)
               {
                  /* returning != 0 if no further entry has to be handled by the callback */
                  return 0;
               }
    
               int ret = ll2_read_all (NULL, callback, &error);
    


## RETURN VALUE



           Returns 0 on success, -ENOMEM or -1 on other failure. _error_
           contains an error string if the return value is -1. _error_ is not
           guaranteed to contain an error string, could also be NULL. _error_
           should be freed by the caller. If lastlog2 database does not exist
           at all, the errno ENOENT is set and can be checked.
    


## AVAILABILITY



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


* * *
# ibv_unimport_pd

## NAME



           ibv_import_pd - import a PD from a given ibv_context
    
           ibv_unimport_pd - unimport a PD
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_pd *ibv_import_pd(struct ibv_context *context, uint32_t pd_handle);
                  void ibv_unimport_pd(struct ibv_pd *pd)
    


## DESCRIPTION



           **ibv_import_pd()** returns a protection domain (PD) that is
           associated with the given _pd_handle_ in the given _context_.
    
           The input _pd_handle_ value must be a valid kernel handle for a PD
           object in the given _context_.  It can be achieved from the original
           PD by getting its ibv_pd->handle member value.
    
           The returned _ibv_pd_ can be used in all verbs that get a protection
           domain.
    
           **ibv_unimport_pd()** unimport the PD.  Once the PD usage has been
           ended ibv_dealloc_pd() or ibv_unimport_pd() should be called.  The
           first one will go to the kernel to destroy the object once the
           second one way cleanup what ever is needed/opposite of the import
           without calling the kernel.
    
           This is the responsibility of the application to coordinate
           between all ibv_context(s) that use this PD.  Once destroy is done
           no other process can touch the object except for unimport.  All
           users of the context must collaborate to ensure this.
    


## RETURN VALUE



           **ibv_import_pd()** returns a pointer to the allocated PD, or NULL if
           the request fails.
    


* * *
# gnutls_certificate_set_x509_key

## NAME



           gnutls_certificate_set_x509_key - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_key(gnutls_certificate_credentials_t**
           _res_**, gnutls_x509_crt_t ***_cert_list_**, int** _cert_list_size_**,**
           **gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_x509_crt_t * cert_list
                       contains a certificate list (path) for the specified
                       private key
    
           int cert_list_size
                       holds the size of the certificate list
    
           gnutls_x509_privkey_t key
                       is a **gnutls_x509_privkey_t** key
    


## DESCRIPTION



           This function sets a certificate/private key pair in the
           gnutls_certificate_credentials_t type.  This function may be
           called more than once, in case multiple keys/certificates exist
           for the server.  For clients that wants to send more than their
           own end entity certificate (e.g., also an intermediate CA cert)
           then put the certificate chain in  _cert_list_ .
    
           Note that the certificates and keys provided, can be safely
           deinitialized after this function is called.
    
           If that function fails to load the  _res_ type is at an undefined
           state, it must not be reused to load other keys or certificates.
    
           Note that, this function by default returns zero on success and a
           negative value on error.  Since 3.5.6, when the flag
           **GNUTLS_CERTIFICATE_API_V2** is set using
           **gnutls_certificate_set_flags()** it returns an index (greater or
           equal to zero). That index can be used to other functions to refer
           to the added key-pair.
    


## RETURNS



           On success this functions returns zero, and otherwise a negative
           value on error (see above for modifying that behavior).
    


## SINCE



           2.4.0
    


* * *
# menu_requestname

## NAME



           **menu_request_by_name** , **menu_request_name** - handle printable menu
           request names
    


## SYNOPSIS



           **#include <menu.h>**
    
           **const char *menu_request_name(int** _request_**);**
           **int menu_request_by_name(const char ***_name_**);**
    


## DESCRIPTION



           The function **menu_request_name** returns the printable name of a
           menu request code.
           The function **menu_request_by_name** searches in the name-table for a
           request with the given name and returns its request code.
           Otherwise E_NO_MATCH is returned.
    


## RETURN VALUE



           **menu_request_name** returns **NULL** on error and sets **errno** to
           **E_BAD_ARGUMENT**.
           **menu_request_by_name** returns **E_NO_MATCH** on error.  It does not set
           **errno**.
    


## NOTES



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


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


* * *
# probe::syscall_any

## NAME



           probe::syscall_any - Record entry into a syscall
    


## SYNOPSIS



           syscall_any
    


## VALUES



           _syscall_nr_
               number of the syscall
    
           _name_
               name of the syscall
    


## CONTEXT



           The process performing the syscall
    


## DESCRIPTION



           The syscall_any probe point is designed to be a low overhead that
           monitors all the syscalls entered via a kernel tracepoint. Because
           of the breadth of syscalls it monitors it provides no information
           about the syscall arguments or argstr string representation of
           those arguments.
    
           This requires kernel 3.5+ and newer which have the
           kernel.trace(“sys_enter”) probe point.
    


* * *
# pam_info

## NAME



           pam_info, pam_vinfo - display messages to the user
    


## SYNOPSIS



           **#include <security/pam_ext.h>**
    
           **int pam_info(pam_handle_t ***_pamh_**, const char ***_fmt_**,**_..._**);**
    
           **int pam_vinfo(pam_handle_t ***_pamh_**, const char ***_fmt_**, va_list** _args_**);**
    


## DESCRIPTION



           The **pam_info** function prints messages through the conversation
           function to the user.
    
           The **pam_vinfo** function performs the same task as **pam_info()** with
           the difference that it takes a set of arguments which have been
           obtained using the stdarg(3) variable argument list macros.
    


## RETURN VALUES



           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_CONV_ERR
               Conversation failure.
    
           PAM_SUCCESS
               Transaction was successful created.
    
           PAM_SYSTEM_ERR
               System error.
    


## STANDARDS



           The **pam_info** and **pam_vinfo** functions are Linux-PAM extensions.
    


* * *
# gnutls_transport_set_errno

## NAME



           gnutls_transport_set_errno - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_errno(gnutls_session_t** _session_**, int**
           _err_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int err     error value to store in session-specific errno
                       variable.
    


## DESCRIPTION



           Store  _err_ in the session-specific errno variable.  Useful values
           for  _err_ are EINTR, EAGAIN and EMSGSIZE, other values are treated
           will be treated as real errors in the push/pull function.
    
           This function is useful in replacement push and pull functions set
           by **gnutls_transport_set_push_function()** and
           **gnutls_transport_set_pull_function()** under Windows, where the
           replacements may not have access to the same  _errno_ variable that
           is used by GnuTLS (e.g., the application is linked to msvcr71.dll
           and gnutls is linked to msvcrt.dll).
    
           This function is unreliable if you are using the same
            _session_ in different threads for sending and receiving.
    


* * *
# libpfm_amd64_k7

## NAME



           libpfm_amd64_k7 - support for AMD64 K7 processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: amd64_k7**
           **PMU desc: AMD64 K7**
    


## DESCRIPTION



           The library supports AMD K7 processors in both 32 and 64-bit
           modes. They correspond to processor family 6.
    


## MODIFIERS



           The following modifiers are supported on AMD64 K7 processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. 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].
    


* * *
# audit_log_user_avc_message

## NAME



           audit_log_user_avc_message - log a user avc message
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int**
           **audit_log_user_avc_message(int** _audit_fd,_**int"**_type,_**const** _char_***"**_message,_**const** _char_***"**_hostname,_**const** _char_***"**_addr,_**const** _char_***"**_tty,_**uid_t"**_auid);"_
    


## DESCRIPTION



           This function will log a message to the audit system using a
           predefined message format. This function should be used by all
           apps that are SE Linux object managers. The function parameters
           are as follows:
    
           _audit_fd_ - The fd returned by audit_open
           _type_ - type of message, ex: AUDIT_USER_AVC
           _message_ - the message being sent
           _hostname_ - the hostname if known
           _addr_ - The network address of the user
           _tty_ - The tty of the user, if NULL will attempt to figure out
           _auid_ - The auid of the person related to the avc message
    
           These values should correspond to who the message is about.
    


## RETURN VALUE



           It returns the sequence number which is > 0 on success or <= 0 on
           error.
    


## ERRORS



           This function returns -1 on failure. Examine errno for more info.
    


* * *
# probe::tcpmib.RetransSegs

## NAME



           probe::tcpmib.RetransSegs - Count the retransmission of a TCP
           segment
    


## SYNOPSIS



           tcpmib.RetransSegs
    


## VALUES



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


## DESCRIPTION



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


* * *
# blkcnt_t

## NAME



           blkcnt_t - file block counts
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
    
           **typedef** /* ... */ **blkcnt_t;**
    


## DESCRIPTION



           Used for file block counts.  It is a signed integer type.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following header also provides this type: _< sys/stat.h>_.
    


* * *
# gnutls_heartbeat_set_timeouts

## NAME



           gnutls_heartbeat_set_timeouts - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_heartbeat_set_timeouts(gnutls_session_t** _session_**,**
           **unsigned int** _retrans_timeout_**, unsigned int** _total_timeout_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int retrans_timeout
                       The time at which a retransmission will occur in
                       milliseconds
    
           unsigned int total_timeout
                       The time at which the connection will be aborted, in
                       milliseconds.
    


## DESCRIPTION



           This function will override the timeouts for the DTLS heartbeat
           protocol. The retransmission timeout is the time after which a
           message from the peer is not received, the previous request will
           be retransmitted. The total timeout is the time after which the
           handshake will be aborted with **GNUTLS_E_TIMEDOUT**.
    


## SINCE



           3.1.2
    


* * *
# function::fp_sqrt

## NAME



           function::fp_sqrt - Floating point square root
    


## SYNOPSIS



               fp_sqrt:long(infp:long)
    


## ARGUMENTS



           _infp_
               the 64 bit floating point input
    


## DESCRIPTION



           apply sqrt to input floating point
    


* * *
# function::kernel_long

## NAME



           function::kernel_long - Retrieves a long value stored in kernel
           memory
    


## SYNOPSIS



               kernel_long:long(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the long from
    


## DESCRIPTION



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


* * *
# gnutls_srtp_get_profile_name

## NAME



           gnutls_srtp_get_profile_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_srtp_get_profile_name(gnutls_srtp_profile_t**
           _profile_**);**
    


## ARGUMENTS



           gnutls_srtp_profile_t profile
                       The profile to look up a string for
    


## DESCRIPTION



           This function allows you to get the corresponding name for a SRTP
           protection profile.
    


## RETURNS



           On success, the name of a SRTP profile as a string, otherwise
           NULL.
    
           Since 3.1.4
    


* * *
# tapset::tokenize

## NAME



           tapset::tokenize - systemtap tokenize tapset
    


## DESCRIPTION



           **tokenize**
                  Return the next non-empty token in a string
    
                  See function::tokenize(3stap)
                   for details.
    
           **tokenize**
                  Return the next non-empty token in a string
    
                  See function::tokenize(3stap)
                   for details.
    


* * *
# gnutls_ocsp_status_request_get

## NAME



           gnutls_ocsp_status_request_get - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * response
                       a **gnutls_datum_t** with DER encoded OCSP response
    


## DESCRIPTION



           This function returns the OCSP status response received from the
           TLS server. The  _response_ should be treated as constant. If no
           OCSP response is available then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# keyctl_set_reqkey_keyring

## NAME



           keyctl_set_reqkey_keyring - set the implicit destination keyring
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_set_reqkey_keyring(int** _reqkey_defl_**);**
    


## DESCRIPTION



           **keyctl_set_reqkey_keyring**() sets the default destination for
           implicit key requests for the current thread and returns the old
           setting.
    
           After this operation has been issued, keys acquired by implicit
           key requests, such as might be performed by **open**() on an AFS or
           NFS filesystem, will be linked by default to the specified keyring
           by this function.
    
           The valid values of _reqkey_defl_ are:
    
           **KEY_REQKEY_DEFL_NO_CHANGE**
                  This makes no change to the current setting.
    
           **KEY_REQKEY_DEFL_THREAD_KEYRING**
                  This makes the thread-specific keyring the default
                  destination.
    
           **KEY_REQKEY_DEFL_PROCESS_KEYRING**
                  This makes the process-specific keyring the default
                  destination.
    
           **KEY_REQKEY_DEFL_SESSION_KEYRING**
                  This makes the session keyring the default destination.
    
           **KEY_REQKEY_DEFL_USER_KEYRING**
                  This makes the UID-specific keyring the default
                  destination.
    
           **KEY_REQKEY_DEFL_USER_SESSION_KEYRING**
                  This makes the UID-specific session keyring the default
                  destination.
    
           **KEY_REQKEY_DEFL_DEFAULT**
                  This selects the default behaviour which is to use the
                  thread-specific keyring if there is one, otherwise the
                  process-specific keyring if there is one, otherwise the
                  session keyring if there is one, otherwise the UID-specific
                  session keyring.
    
           This setting is inherited across **fork**() and **exec**().
    


## RETURN VALUE



           On success **keyctl_set_reqkey_keyring**() returns the serial number
           of the keyring which was the previous default for the current
           thread.  On error, the value **-1** will be returned and _errno_ will
           have been set to an appropriate error.
    


## ERRORS



           **EINVAL** The value of _reqkey_defl_ is invalid.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# gnutls_certificate_expiration_time_peers

## NAME



           gnutls_certificate_expiration_time_peers - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **time_t gnutls_certificate_expiration_time_peers(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function will return the peer's certificate expiration time.
    


## RETURNS



           (time_t)-1 on error.
    


## DEPRECATED



           **gnutls_certificate_verify_peers2()** now verifies expiration times.
    


* * *
# cpow

## NAME



           cpow, cpowf, cpowl - complex power function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cpow(double complex** _x_**, double complex** _z_**);**
           **float complex cpowf(float complex** _x_**, float complex** _z_**);**
           **long double complex cpowl(long double complex** _x_**,**
                                     **long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate _x_ raised to the power _z_ (with a branch
           cut for _x_ along the negative real axis).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# mlx5dv_dump_dr_matcher

## NAME



           mlx5dv_dump_dr_domain - Dump DR Domain
    
           mlx5dv_dump_dr_table - Dump DR Table
    
           mlx5dv_dump_dr_matcher - Dump DR Matcher
    
           mlx5dv_dump_dr_rule - Dump DR Rule
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_dump_dr_domain(FILE *fout, struct mlx5dv_dr_domain *domain);
                  int mlx5dv_dump_dr_table(FILE *fout, struct mlx5dv_dr_table *table);
                  int mlx5dv_dump_dr_matcher(FILE *fout, struct mlx5dv_dr_matcher *matcher);
                  int mlx5dv_dump_dr_rule(FILE *fout, struct mlx5dv_dr_rule *rule);
    


## DESCRIPTION



           The Dump API (mlx5dv_dump_*) allows the dumping of the existing
           rdma-core resources to the provided file.  The output file format
           is vendor specific.
    
           _mlx5dv_dump_dr_domain()_ dumps a DR Domain object properties to a
           specified file.
    
           _mlx5dv_dump_dr_table()_ dumps a DR Table object properties to a
           specified file.
    
           _mlx5dv_dump_dr_matcher()_ dumps a DR Matcher object properties to a
           specified file.
    
           _mlx5dv_dump_dr_rule()_ dumps a DR Rule object properties to a
           specified file.
    


## RETURN VALUE



           The API calls returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).  The calls are
           blocking - function returns only when all related resources info
           is written to the file.
    


* * *
# mq_close

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



           mq_close — close a message queue (**REALTIME**)
    


## SYNOPSIS



           #include <mqueue.h>
    
           int mq_close(mqd_t _mqdes_);
    


## DESCRIPTION



           The _mq_close_() function shall remove the association between the
           message queue descriptor, _mqdes_ , and its message queue. The
           results of using this message queue descriptor after successful
           return from this _mq_close_(), and until the return of this message
           queue descriptor from a subsequent _mq_open_(), are undefined.
    
           If the process has successfully attached a notification request to
           the message queue via this _mqdes_ , this attachment shall be
           removed, and the message queue is available for another process to
           attach for notification.
    


## RETURN VALUE



           Upon successful completion, the _mq_close_() function shall return a
           value of zero; otherwise, the function shall return a value of -1
           and set _errno_ to indicate the error.
    


## ERRORS



           The _mq_close_() function shall fail if:
    
           **EBADF** The _mqdes_ argument is not a valid message queue descriptor.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# telldir

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



           telldir — current location of a named directory stream
    


## SYNOPSIS



           #include <dirent.h>
    
           long telldir(DIR *_dirp_);
    


## DESCRIPTION



           The _telldir_() function shall obtain the current location
           associated with the directory stream specified by _dirp_.
    
           If the most recent operation on the directory stream was a
           _seekdir_(), the directory position returned from the _telldir_()
           shall be the same as that supplied as a _loc_ argument for
           _seekdir_().
    


## RETURN VALUE



           Upon successful completion, _telldir_() shall return the current
           location of the specified directory stream.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# mlx5dv_modify_qp_udp_sport

## NAME



           mlx5dv_modify_qp_udp_sport - Modify the UDP source port of a given
           QP
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_modify_qp_udp_sport(struct ibv_qp *qp, uint16_t udp_sport)
    


## DESCRIPTION



           The UDP source port is used to create entropy for network routers
           (ECMP), load balancers and 802.3ad link aggregation switching that
           are not aware of RoCE IB headers.
    
           This API enables modifying the configured UDP source port of a
           given RC/UC QP when QP is in RTS state.
    


## ARGUMENTS



           _qp_     The ibv_qp object to issue the action on.
    
           _udp_sport_
                  The UDP source port to set for the QP.
    


## RETURN VALUE



           Returns 0 on success, or the value of errno on failure (which
           indicates the failure reason).
    


* * *
# pthread_spin_lock

## NAME



           pthread_spin_lock, pthread_spin_trylock, pthread_spin_unlock -
           lock and unlock a spin lock
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <pthread.h>**
    
           **int pthread_spin_lock(pthread_spinlock_t ***_lock_**);**
           **int pthread_spin_trylock(pthread_spinlock_t ***_lock_**);**
           **int pthread_spin_unlock(pthread_spinlock_t ***_lock_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **pthread_spin_lock**(), **pthread_spin_trylock**():
               _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           The **pthread_spin_lock**() function locks the spin lock referred to
           by _lock_.  If the spin lock is currently unlocked, the calling
           thread acquires the lock immediately.  If the spin lock is
           currently locked by another thread, the calling thread spins,
           testing the lock until it becomes available, at which point the
           calling thread acquires the lock.
    
           Calling **pthread_spin_lock**() on a lock that is already held by the
           caller or a lock that has not been initialized with
           pthread_spin_init(3) results in undefined behavior.
    
           The **pthread_spin_trylock**() function is like **pthread_spin_lock**(),
           except that if the spin lock referred to by _lock_ is currently
           locked, then, instead of spinning, the call returns immediately
           with the error **EBUSY**.
    
           The **pthread_spin_unlock**() function unlocks the spin lock referred
           to _lock_.  If any threads are spinning on the lock, one of those
           threads will then acquire the lock.
    
           Calling **pthread_spin_unlock**() on a lock that is not held by the
           caller results in undefined behavior.
    


## RETURN VALUE



           On success, these functions return zero.  On failure, they return
           an error number.
    


## ERRORS



           **pthread_spin_lock**() may fail with the following errors:
    
           **EDEADLOCK**
                  The system detected a deadlock condition.
    
           **pthread_spin_trylock**() fails with the following errors:
    
           **EBUSY** The spin lock is currently locked by another thread.
    


## STANDARDS



           POSIX.1-2008.
    


## CAVEATS



           Applying any of the functions described on this page to an
           uninitialized spin lock results in undefined behavior.
    
           Carefully read NOTES in pthread_spin_init(3).
    


* * *
# gnutls_hex_encode2

## NAME



           gnutls_hex_encode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_hex_encode2(const gnutls_datum_t ***_data_**, gnutls_datum_t**
           *****_result_**);**
    


## ARGUMENTS



           const gnutls_datum_t * data
                       contain the raw data
    
           gnutls_datum_t * result
                       the result in an allocated string
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the hex encoding, as used in the PSK password files.
    
           Note that the size of the result does NOT include the null
           terminator.
    


## RETURNS



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


* * *
# gnutls_x509_crt_get_dn3

## NAME



           gnutls_x509_crt_get_dn3 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_dn3(gnutls_x509_crt_t** _cert_**, gnutls_datum_t**
           *****_dn_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    
           unsigned flags
                       zero or **GNUTLS_X509_DN_FLAG_COMPAT**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of the
           Certificate.  The name will be in the form "C=xxxx,O=yyyy,CN=zzzz"
           as described in RFC4514. The output string will be ASCII or UTF-8
           encoded, depending on the certificate data.
    
           When the flag **GNUTLS_X509_DN_FLAG_COMPAT** is specified, the output
           format will match the format output by previous to 3.5.6 versions
           of GnuTLS which was not not fully RFC4514-compliant.
    


## RETURNS



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


## SINCE



           3.5.7
    


* * *