tripathysagar/man_text huggingface dataset:
# mlx5dv_dm_map_op_addr

## NAME



           mlx5dv_dm_map_op_addr - Get operation address of a device memory
           (DM)
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  void *mlx5dv_dm_map_op_addr(struct ibv_dm *dm, uint8_t op);
    


## DESCRIPTION



           **mlx5dv_dm_map_op_addr()** returns a mmaped address to the device
           memory for the requested **op**.
    


## ARGUMENTS



           _dm_
    
                  The associated ibv_dm for this operation.
    
           _op_
    
                  Indicates the DM operation type, based on device specification.
    


## RETURN VALUE



           Returns a pointer to the mmaped address, on error NULL will be
           returned and errno will be set.
    


* * *
# function::task_ns_uid

## NAME



           function::task_ns_uid - The user identifier of the task
    


## SYNOPSIS



               task_ns_uid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the user id of the given task.
    


* * *
# gnutls_record_recv_seq

## NAME



           gnutls_record_recv_seq - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_recv_seq(gnutls_session_t** _session_**, void ***
           _data_**, size_t** _data_size_**, unsigned char ***_seq_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * data the buffer that the data will be read into
    
           size_t data_size
                       the number of requested bytes
    
           unsigned char * seq
                       is the packet's 64-bit sequence number. Should have
                       space for 8 bytes.
    


## DESCRIPTION



           This function is the same as **gnutls_record_recv()** , except that it
           returns in addition to data, the sequence number of the data.
           This is useful in DTLS where record packets might be received
           out-of-order. The returned 8-byte sequence number is an integer in
           big-endian format and should be treated as a unique message
           identification.
    


## RETURNS



           The number of bytes received and zero on EOF.  A negative error
           code is returned in case of an error.  The number of bytes
           received might be less than  _data_size_ .
    


## SINCE



           3.0
    


* * *
# gnutls_range_split

## NAME



           gnutls_range_split - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_range_split(gnutls_session_t** _session_**, const**
           **gnutls_range_st ***_orig_**, gnutls_range_st ***_next_**, gnutls_range_st ***
           _remainder_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type
    
           const gnutls_range_st * orig
                       is the original range provided by the user
    
           gnutls_range_st * next
                       is the returned range that can be conveyed in a TLS
                       record
    
           gnutls_range_st * remainder
                       is the returned remaining range
    


## DESCRIPTION



           This function should be used when it is required to hide the
           length of very long data that cannot be directly provided to
           **gnutls_record_send_range()**.  In that case this function should be
           called with the desired length hiding range in  _orig_ . The
           returned  _next_ value should then be used in the next call to
           **gnutls_record_send_range()** with the partial data.  That process
           should be repeated until  _remainder_ is (0,0).
    


## RETURNS



           0 in case splitting succeeds, non zero in case of error.  Note
           that  _orig_ is not changed, while the values of  _next_ and
           _remainder_ are modified to store the resulting values.
    


* * *
# iswalpha

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



           iswalpha, iswalpha_l — test for an alphabetic wide-character code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswalpha(wint_t _wc_);
           int iswalpha_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswalpha_(): 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 _iswalpha_() and _iswalpha_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **alpha** in
           the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswalpha_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswalpha_() and _iswalpha_l_() functions shall return non-zero if
           _wc_ is an alphabetic wide-character code; otherwise, they shall
           return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::kernel_string_utf16

## NAME



           function::kernel_string_utf16 - Retrieves UTF-16 string from
           kernel memory
    


## SYNOPSIS



           1) kernel_string_utf16:string(addr:long)
    
           2) kernel_string_utf16:string(addr:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    
           _err_msg_
               The error message to return when data isn't available
    


## DESCRIPTION



           1) This function returns a null terminated UTF-8 string converted
           from the UTF-16 string at a given kernel memory address. Reports
           an error on string copy fault or conversion error.
    
           2) This function returns a null terminated UTF-8 string converted
           from the UTF-16 string at a given kernel memory address. Reports
           the given error message on string copy fault or conversion error.
    


* * *
# gnutls_x509_ext_export_subject_alt_names

## NAME



           gnutls_x509_ext_export_subject_alt_names - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int**
           **gnutls_x509_ext_export_subject_alt_names(gnutls_subject_alt_names_t**
           _sans_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           gnutls_subject_alt_names_t sans
                       The alternative names
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the provided alternative names
           structure to a DER-encoded SubjectAltName PKIX extension. The
           output data in  _ext_ will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# ferror

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



           ferror — test error indicator on a stream
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           The _ferror_() function shall return non-zero if and only if the
           error indicator is set for _stream_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# sd_bus_get_n_queued_read

## NAME



           sd_bus_get_n_queued_read, sd_bus_get_n_queued_write - Get the
           number of pending bus messages in the read and write queues of a
           bus connection object
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_get_n_queued_read(sd_bus ***_bus_**, uint64_t ***_ret_**);**
    
           **int sd_bus_get_n_queued_write(sd_bus ***_bus_**, uint64_t ***_ret_**);**
    


## DESCRIPTION



           **sd_bus_get_n_queued_read()** may be used to query the number of bus
           messages in the read queue of a bus connection object. The read
           queue contains all messages read from the transport medium (e.g.
           network socket) but not yet processed locally. The function
           expects two arguments: the bus object to query, and a pointer to a
           64-bit counter variable to write the current queue size to. Use
           **sd_bus_process()** in order to process queued messages, i.e. to
           reduce the size of the read queue (as well as, in fact, the write
           queue, see below).
    
           Similarly, **sd_bus_get_n_queued_write()** may be used to query the
           number of currently pending bus messages in the write queue of a
           bus connection object. The write queue contains all messages
           enqueued into the connection with a call such as **sd_bus_send()** but
           not yet written to the transport medium. The expected arguments
           are similar to **sd_bus_get_n_queued_read()**. Here too, use
           **sd_bus_process()** to reduce the size of the write queue.
           Alternatively, use **sd_bus_flush()** to synchronously write out any
           pending bus messages until the write queue is empty.
    


## 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:
    
           **-ECHILD**
               The bus connection was created in a different process, library
               or module instance.
    


* * *
# pmisettimezone

## NAME



           **pmiSetTimezone** - set the source timezone for a LOGIMPORT archive
    


## C SYNOPSIS



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


## Perl SYNOPSIS



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


## DESCRIPTION



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


## DIAGNOSTICS



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


* * *
# sqrt

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



           sqrt, sqrtf, sqrtl — square root function
    


## SYNOPSIS



           #include <math.h>
    
           double sqrt(double _x_);
           float sqrtf(float _x_);
           long double sqrtl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the square root of their argument _x_ ,
           _√‾x_.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           square root of _x_.
    
           For finite values of _x_ < -0, a domain error shall occur, and
           either a NaN (if supported), or an implementation-defined value
           shall be returned.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0 or +Inf, _x_ shall be returned.
    
           If _x_ is -Inf, a domain error shall occur, and a NaN shall be
           returned.
    


## ERRORS



           These functions shall fail if:
    
           Domain Error
                       The finite value of _x_ is < -0, or _x_ is -Inf.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[EDOM]**.  If the integer expression (_math_errhandling_ &
                       MATH_ERREXCEPT) is non-zero, then the invalid
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



       **Taking the Square Root of 9.0**
               #include <math.h>
               ...
               double x = 9.0;
               double result;
               ...
               result = sqrt(x);
    


## APPLICATION USAGE



           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# menu_pattern

## NAME



           **set_menu_pattern** , **menu_pattern** - set and get a menu's pattern
           buffer
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_pattern(MENU ***_menu_**, const char ***_pattern_**);**
           **char *menu_pattern(const MENU ***_menu_**);**
    


## DESCRIPTION



           Every menu has an associated pattern match buffer.  As input
           events that are printable characters come in, they are appended to
           this match buffer and tested for a match, as described in
           **menu_driver**(3X).
    
           The function **set_menu_pattern** sets the pattern buffer for the
           given menu and tries to find the first matching item.  If it
           succeeds, that item becomes current; if not, the current item does
           not change.
    
           The function **menu_pattern** returns the pattern buffer of the given
           _menu_.
    


## RETURN VALUE



           The function **menu_pattern** returns a pointer, which is **NULL** if the
           _menu_ parameter is **NULL**.  Otherwise, it is a pointer to a string
           which is empty if no pattern has been set.  It does not set **errno**.
    
           The function **set_menu_pattern** may return the following error
           codes:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_BAD_STATE**
                Routine was called from an initialization or termination
                function.
    
           **E_NOT_CONNECTED**
                No items are connected to menu.
    
           **E_NO_MATCH**
                Character failed to match.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


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


* * *
# posix_trace_shutdown

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



           posix_trace_shutdown — trace stream shutdown from a process
           (**TRACING**)
    


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_shutdown(trace_id_t _trid_);
    


## DESCRIPTION



           Refer to posix_trace_create(3p).
    


* * *
# wcstok

## NAME



           wcstok - split wide-character string into tokens
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcstok(wchar_t *restrict** _wcs_**, const wchar_t *restrict** _delim_**,**
                           **wchar_t **restrict** _ptr_**);**
    


## DESCRIPTION



           The **wcstok**() function is the wide-character equivalent of the
           strtok(3) function, with an added argument to make it multithread-
           safe.  It can be used to split a wide-character string _wcs_ into
           tokens, where a token is defined as a substring not containing any
           wide-characters from _delim_.
    
           The search starts at _wcs_ , if _wcs_ is not NULL, or at _*ptr_ , if _wcs_
           is NULL.  First, any delimiter wide-characters are skipped, that
           is, the pointer is advanced beyond any wide-characters which occur
           in _delim_.  If the end of the wide-character string is now reached,
           **wcstok**() returns NULL, to indicate that no tokens were found, and
           stores an appropriate value in _*ptr_ , so that subsequent calls to
           **wcstok**() will continue to return NULL.  Otherwise, the **wcstok**()
           function recognizes the beginning of a token and returns a pointer
           to it, but before doing that, it zero-terminates the token by
           replacing the next wide-character which occurs in _delim_ with a
           null wide character (L'\0'), and it updates _*ptr_ so that
           subsequent calls will continue searching after the end of
           recognized token.
    


## RETURN VALUE



           The **wcstok**() function returns a pointer to the next token, or NULL
           if no further token was found.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The original _wcs_ wide-character string is destructively modified
           during the operation.
    


## EXAMPLES



           The following code loops over the tokens contained in a wide-
           character string.
    
           wchar_t *wcs = ...;
           wchar_t *token;
           wchar_t *state;
           for (token = wcstok(wcs, L" \t\n", &state);
               token != NULL;
               token = wcstok(NULL, L" \t\n", &state)) {
               ...
           }
    


* * *
# iswalnum

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



           iswalnum, iswalnum_l — test for an alphanumeric wide-character
           code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswalnum(wint_t _wc_);
           int iswalnum_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswalnum_(): 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 _iswalnum_() and _iswalnum_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **alpha** or
           **digit** in the current locale, or in the locale represented by
           _locale_ , respectively; see the Base Definitions volume of
           POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswalnum_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswalnum_() and _iswalnum_l_() functions shall return non-zero if
           _wc_ is an alphanumeric wide-character code; otherwise, they shall
           return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_handshake_set_read_function

## NAME



           gnutls_handshake_set_read_function - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is **gnutls_session_t** type
    
           gnutls_handshake_read_func func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback to be called when a handshake
           message is being sent.
    


## SINCE



           3.7.0
    


* * *
# gnutls_sign_get_oid

## NAME



           gnutls_sign_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_sign_get_oid(gnutls_sign_algorithm_t** _sign_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t sign
                       is a sign algorithm
    


## DESCRIPTION



           Convert a **gnutls_sign_algorithm_t** value to its object identifier.
    


## RETURNS



           a string that contains the object identifier of the specified sign
           algorithm, or **NULL**.
    


## SINCE



           3.4.3
    


* * *
# mmv_lookup_value_desc

## NAME



           **mmv_lookup_value_desc** - find a value in the Memory Mapped Value
           file
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/mmv_stats.h>**
    
           **pmAtomValue *mmv_lookup_value_desc(void ***_addr_**, const char ***_metric_**,**
                                              **const char ***_inst_**);**
    
           **cc ... -lpcp_mmv -lpcp**
    


## DESCRIPTION



           **mmv_lookup_value_desc** searches for the value of the instance iden‐
           tified  by the external instance name _inst_ of the metric _metric_ in
           the  MMV(5)   file.    _addr_   is   the   address   returned   from
           **mmv_stats_init**().
    
           The  pointer  returned points to a pmAtomValue union, which is de‐
           fined as follows:
    
               typedef union {
                   __int32_t   l;      /* 32-bit signed */
                   __uint32_t  ul;     /* 32-bit unsigned */
                   __int64_t   ll;     /* 64-bit signed */
                   __uint64_t  ull;    /* 64-bit unsigned */
                   float       f;      /* 32-bit floating point */
                   double      d;      /* 64-bit floating point */
                   char         *cp;   /* char ptr */
                pmValueBlock *vbp;  /* pmValueBlock ptr */
               } pmAtomValue;
    
           MMV string values should be set using either of the **mmv_set_string**
           or **mmv_set_strlen** routines.
    


## RETURNS



           The function returns the address inside of the memory  mapped  re‐
           gion on success or NULL on failure.
    


* * *
# io_uring_buf_ring_advance

## NAME



           io_uring_buf_ring_advance - advance index of provided buffer in
           buffer ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_buf_ring_advance(struct io_uring_buf_ring ***_br_**,**
                                          **int** _count_**);**
    


## DESCRIPTION



           The io_uring_buf_ring_advance(3) commits _count_ previously added
           buffers to the shared buffer ring _br_ , making them visible to the
           kernel and hence consumable. This passes ownership of the buffer
           to the ring.
    


## RETURN VALUE



           None
    


* * *
# gnutls_srp_set_server_credentials_function

## NAME



           gnutls_srp_set_server_credentials_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_srp_set_server_credentials_function(gnutls_srp_server_credentials_t**
           _cred_**, gnutls_srp_server_credentials_function ***_func_**);**
    


## ARGUMENTS



           gnutls_srp_server_credentials_t cred
                       is a **gnutls_srp_server_credentials_t** type.
    
           gnutls_srp_server_credentials_function * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the user's
           SRP credentials.  The callback's function form is:
    
           int (*callback)(gnutls_session_t, const char* username,
           gnutls_datum_t *salt, gnutls_datum_t *verifier, gnutls_datum_t
           *generator, gnutls_datum_t *prime);
    
            _username_ contains the actual username.  The  _salt_ ,  _verifier_ ,
           _generator_ and  _prime_ must be filled in using the **gnutls_malloc()**.
           For convenience  _prime_ and  _generator_ may also be one of the
           static parameters defined in gnutls.h.
    
           Initially, the data field is NULL in every **gnutls_datum_t**
           structure that the callback has to fill in. When the callback is
           done GnuTLS deallocates all of those buffers which are non-NULL,
           regardless of the return value.
    
           In order to prevent attackers from guessing valid usernames, if a
           user does not exist, g and n values should be filled in using a
           random user's parameters. In that case the callback must return
           the special value (1).  See **gnutls_srp_set_server_fake_salt_seed**
           too.  If this is not required for your application, return a
           negative number from the callback to abort the handshake.
    
           The callback function will only be called once per handshake.  The
           callback function should return 0 on success, while -1 indicates
           an error.
    


* * *
# function::user_int64_error

## NAME



           function::user_int64_error - Retrieves a 64-bit integer value
           stored in user space
    


## SYNOPSIS



               user_int64_error:long(addr:long)
    


## ARGUMENTS



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


## DESCRIPTION



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


* * *
# aio_error

## NAME



           aio_error - get error status of asynchronous I/O operation
    


## LIBRARY



           Real-time library (_librt_ , _-lrt_)
    


## SYNOPSIS



           **#include <aio.h>**
    
           **int aio_error(const struct aiocb ***_aiocbp_**);**
    


## DESCRIPTION



           The **aio_error**() function returns the error status for the
           asynchronous I/O request with control block pointed to by _aiocbp_.
           (See aio(7) for a description of the _aiocb_ structure.)
    


## RETURN VALUE



           This function returns one of the following:
    
           **EINPROGRESS**
                  if the request has not been completed yet.
    
           **ECANCELED**
                  if the request was canceled.
    
           **0** if the request completed successfully.
    
           > **0** A positive error number, if the asynchronous I/O operation
                  failed.  This is the same value that would have been stored
                  in the _errno_ variable in the case of a synchronous read(2),
                  write(2), fsync(2), or fdatasync(2) call.
    


## ERRORS



           **EINVAL** _aiocbp_ does not point at a control block for an
                  asynchronous I/O request of which the return status (see
                  aio_return(3)) has not been retrieved yet.
    
           **ENOSYS aio_error**() is not implemented.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## EXAMPLES



           See aio(7).
    


* * *
# posix_trace_attr_setstreamsize

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



           posix_trace_attr_setstreamsize — retrieve and set trace stream
           size attributes (**TRACING**)
    


## SYNOPSIS



           #include <sys/types.h>
           #include <trace.h>
    
           int posix_trace_attr_setstreamsize(trace_attr_t *_attr_ ,
               size_t _streamsize_);
    


## DESCRIPTION



           Refer to posix_trace_attr_getlogsize(3p).
    


* * *
# function::usymdata

## NAME



           function::usymdata - Return the symbol and module offset of an
           address.
    


## SYNOPSIS



               usymdata:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the (function) symbol name associated with the given
           address in the current task if known, the offset from the start
           and the size of the symbol, plus the module name (between
           brackets). If symbol is unknown, but module is known, the offset
           inside the module, plus the size of the module is added. If any
           element is not known it will be omitted and if the symbol name is
           unknown it will return the hex string for the given address.
    


* * *
# pmiusecontext

## NAME



           **pmiUseContext** - change LOGIMPORT context
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiUseContext(int** _context_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiUseContext($**_context_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiUseContext** may be used by  applications  wishing
           to generate more than one PCP archive concurrently.
    
           The  _context_  argument is a value returned from a previous call to
           pmiStart(3) and on successful return from **pmiUseContext** , the  cur‐
           rent  context will have been changed to the one identified by _con‐_
           _text_.
    


## DIAGNOSTICS



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


* * *
# probe::socket.close.return

## NAME



           probe::socket.close.return - Return from closing a socket
    


## SYNOPSIS



           socket.close.return
    


## VALUES



           _name_
               Name of this probe
    


## CONTEXT



           The requester (user process or kernel)
    


## DESCRIPTION



           Fires at the conclusion of closing a socket.
    


* * *
# iswblank

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



           iswblank, iswblank_l — test for a blank wide-character code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswblank(wint_t _wc_);
           int iswblank_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswblank_(): 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 _iswblank_() and _iswblank_() functions shall test whether _wc_ is a
           wide-character code representing a character of class **blank** in the
           current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswblank_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswblank_() and _iswblank_l_() functions shall return non-zero if
           _wc_ is a blank wide-character code; otherwise, they shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmdasenderror

## NAME



           **pmdaSendError** - send an error PDU to PMCD
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **void pmdaSendError(pmdaInterface ***_dispatch_**, int** _err_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## PYTHON SYNOPSIS



           **from pcp.pmda import PMDA**
           **PMDA.pmda_notready()**
           **PMDA.pmda_ready()**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), this routine allows a PMDA to send an error PDU to PMCD.
           There is presently only one use for this - so the PMDA can  inform
           PMCD that it is ready (or not ready) to process requests.
    
           The protocol details are described in pmcd(1) and PMDA(3), but ba‐
           sically  if  a PMDA starts in the _notready_ state (as may be speci‐
           fied in **pmcd.conf** , see pmcd(1)) then PMCD will not send it any re‐
           quests until the PMDA sends an **PM_ERR_PMDAREADY** error  PDU  using
           this function.  This is used by a PMDA that may have a long start‐
           up time, e.g. to process a large configuration file or similar.
    


* * *
# libpfm_intel_hswep_unc_irp

## NAME



           libpfm_intel_hswep_unc_irp - support for Intel Haswell-EP IRP
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_irp**
           **PMU desc: Intel Haswell-EP IRP uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell uncore PMU.  This PMU model
           only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell IRP uncore
           PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of cycles in which the number of
                  occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# rdma_post_read

## NAME



           rdma_post_read - post an RDMA read work request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_read (struct rdma_cm_id ***_id_**, void ***_context_**, void**
           *****_addr_**, size_t** _length_**, struct ibv_mr ***_mr_**, int** _flags_**, uint64_t**
           _remote_addr_**, uint32_t** _rkey_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       request will be posted.
    
           context     User-defined context associated with the request.
    
           addr        The address of the local destination of the read
                       request.
    
           length      The length of the read operation.
    
           mr          Registered memory region associated with the local
                       buffer.
    
           flags       Optional flags used to control the read operation.
    
           remote_addr The address of the remote registered memory to read
                       from.
    
           rkey        The registered memory key associated with the remote
                       address.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the remote memory
           region will be read into the local data buffer.
    


## RETURN VALUE



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


## NOTES



           For a list of supported flags, see ibv_post_send.  Both the remote
           and local data buffers must have been registered before the read
           is issued, and the buffers must remain registered until the read
           completes.
    
           Read operations may not be posted to an rdma_cm_id or the
           corresponding queue pair until it has been connected.
    
           The user-defined context associated with the read request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# gnutls_certificate_free_ca_names

## NAME



           gnutls_certificate_free_ca_names - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_free_ca_names(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 CA name in the given
           credentials. Clients may call this to save some memory since in
           client side the CA names are not used. Servers might want to use
           this function if a large list of trusted CAs is present and
           sending the names of it would just consume bandwidth without
           providing information to client.
    
           CA names are used by servers to advertise the CAs they support to
           clients.
    


* * *
# htonl

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



           htonl, htons, ntohl, ntohs — convert values between host and
           network byte order
    


## SYNOPSIS



           #include <arpa/inet.h>
    
           uint32_t htonl(uint32_t _hostlong_);
           uint16_t htons(uint16_t _hostshort_);
           uint32_t ntohl(uint32_t _netlong_);
           uint16_t ntohs(uint16_t _netshort_);
    


## DESCRIPTION



           These functions shall convert 16-bit and 32-bit quantities between
           network byte order and host byte order.
    
           On some implementations, these functions are defined as macros.
    
           The **uint32_t** and **uint16_t** types are defined in _< inttypes.h>_.
    


## RETURN VALUE



           The _htonl_() and _htons_() functions shall return the argument value
           converted from host to network byte order.
    
           The _ntohl_() and _ntohs_() functions shall return the argument value
           converted from network to host byte order.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are most often used in conjunction with IPv4
           addresses and ports as returned by _gethostent_() and _getservent_().
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# strtold

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



           strtold — convert a string to a double-precision number
    


## SYNOPSIS



           #include <stdlib.h>
    
           long double strtold(const char *restrict _nptr_ , char **restrict _endptr_);
    


## DESCRIPTION



           Refer to strtod(3p).
    


* * *
# gnutls_x509_crl_dist_points_init

## NAME



           gnutls_x509_crl_dist_points_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_crl_dist_points_init(gnutls_x509_crl_dist_points_t**
           *****_cdp_**);**
    


## ARGUMENTS



           gnutls_x509_crl_dist_points_t * cdp
                       The CRL distribution points
    


## DESCRIPTION



           This function will initialize a CRL distribution points type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *