tripathysagar/man_text huggingface dataset:
# mlx5dv_create_flow

## NAME



           mlx5dv_create_flow - creates a steering flow rule
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_flow *
                  mlx5dv_create_flow(struct mlx5dv_flow_matcher *flow_matcher,
                             struct mlx5dv_flow_match_parameters *match_value,
                             size_t num_actions,
                             struct mlx5dv_flow_action_attr actions_attr[])
    


## DESCRIPTION



           **mlx5dv_create_flow()** creates a steering flow rule with the ability
           to specify specific driver properties.
    


## ARGUMENTS



           Please see _mlx5dv_create_flow_matcher(3)_ for _flow_matcher_ and
           _match_value_.
    
           _num_actions_
                  Specifies how many actions are passed in _actions_attr_
    
       **actions_attr**
                  struct mlx5dv_flow_action_attr {
                      enum mlx5dv_flow_action_type type;
                      union {
                          struct ibv_qp *qp;
                          struct ibv_counters *counter;
                          struct ibv_flow_action *action;
                          uint32_t tag_value;
                          struct mlx5dv_devx_obj *obj;
                      };
                  };
    
           _type_   MLX5DV_FLOW_ACTION_DEST_IBV_QP The QP passed will receive
                  the matched packets.  MLX5DV_FLOW_ACTION_IBV_FLOW_ACTION
                  The flow action to be applied.  MLX5DV_FLOW_ACTION_TAG Flow
                  tag to be provided in work completion.
                  MLX5DV_FLOW_ACTION_DEST_DEVX The DEVX destination object
                  for the matched packets.  MLX5DV_FLOW_ACTION_COUNTERS_DEVX
                  The DEVX counter object for the matched packets.
                  MLX5DV_FLOW_ACTION_DEFAULT_MISS Steer the packet to the
                  default miss destination.  MLX5DV_FLOW_ACTION_DROP Action
                  is dropping the matched packet.
    
           _qp_     QP passed, to be used with _type_
                  _MLX5DV_FLOW_ACTION_DEST_IBV_QP_.
    
           _action_ Flow action, to be used with _type_
                  _MLX5DV_FLOW_ACTION_IBV_FLOW_ACTION_ see
                  _mlx5dv_create_flow_action_modify_header(3)_ and
                  _mlx5dv_create_flow_action_packet_reformat(3)_.
    
           _tag_value_
                  tag value to be passed in the work completion, to be used
                  with _type MLX5DV_FLOW_ACTION_TAG_ see _ibv_create_cq_ex(3)_.
    
           _obj_    DEVX object, to be used with _type_
                  _MLX5DV_FLOW_ACTION_DEST_DEVX_ or by
                  _MLX5DV_FLOW_ACTION_COUNTERS_DEVX_.
    


## RETURN VALUE



           **mlx5dv_create_flow** returns a pointer to the created flow rule, on
           error NULL will be returned and errno will be set.
    


* * *
# mbsinit

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



           mbsinit — determine conversion object status
    


## SYNOPSIS



           #include <wchar.h>
    
           int mbsinit(const mbstate_t *_ps_);
    


## 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.
    
           If _ps_ is not a null pointer, the _mbsinit_() function shall
           determine whether the object pointed to by _ps_ describes an initial
           conversion state.
    


## RETURN VALUE



           The _mbsinit_() function shall return non-zero if _ps_ is a null
           pointer, or if the pointed-to object describes an initial
           conversion state; otherwise, it shall return zero.
    
           If an **mbstate_t** object is altered by any of the functions
           described as ``restartable'', and is then used with a different
           character sequence, or in the other conversion direction, or with
           a different _LC_CTYPE_ category setting than on earlier function
           calls, the behavior is undefined.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The **mbstate_t** object is used to describe the current conversion
           state from a particular character sequence to a wide-character
           sequence (or _vice versa_) under the rules of a particular setting
           of the _LC_CTYPE_ category of the current locale.
    
           The initial conversion state corresponds, for a conversion in
           either direction, to the beginning of a new character sequence in
           the initial shift state. A zero valued **mbstate_t** object is at
           least one way to describe an initial conversion state. A zero
           valued **mbstate_t** object can be used to initiate conversion
           involving any character sequence, in any _LC_CTYPE_ category
           setting.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# isgreaterequal

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



           isgreaterequal — test if x is greater than or equal to y
    


## SYNOPSIS



           #include <math.h>
    
           int isgreaterequal(real-floating _x_ , real-floating _y_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _isgreaterequal_() macro shall determine whether its first
           argument is greater than or equal to its second argument. The
           value of _isgreaterequal_(_x_ , _y_) shall be equal to (_x_) ≥ (_y_);
           however, unlike (_x_) ≥ (_y_), _isgreaterequal_(_x_ , _y_) shall not raise
           the invalid floating-point exception when _x_ and _y_ are unordered.
    


## RETURN VALUE



           Upon successful completion, the _isgreaterequal_() macro shall
           return the value of (_x_) ≥ (_y_).
    
           If _x_ or _y_ is NaN, 0 shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The relational and equality operators support the usual
           mathematical relationships between numeric values. For any ordered
           pair of numeric values, exactly one of the relationships (less,
           greater, and equal) is true. Relational operators may raise the
           invalid floating-point exception when argument values are NaNs.
           For a NaN and a numeric value, or for two NaNs, just the unordered
           relationship is true. This macro is a quiet (non-floating-point
           exception raising) version of a relational operator. It
           facilitates writing efficient code that accounts for NaNs without
           suffering the invalid floating-point exception. In the SYNOPSIS
           section, **real-floating** indicates that the argument shall be an
           expression of **real-floating** type.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crl_get_crt_serial

## NAME



           gnutls_x509_crl_get_crt_serial - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_crt_serial(gnutls_x509_crl_t** _crl_**, unsigned**
           _indx_**, unsigned char ***_serial_**, size_t ***_serial_size_**, time_t ***_t_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           unsigned indx
                       the index of the certificate to extract (starting from
                       0)
    
           unsigned char * serial
                       where the serial number will be copied
    
           size_t * serial_size
                       initially holds the size of serial
    
           time_t * t  if non null, will hold the time this certificate was
                       revoked
    


## DESCRIPTION



           This function will retrieve the serial number of the specified, by
           the index, revoked certificate.
    
           Note that this function will have performance issues in large
           sequences of revoked certificates. In that case use
           **gnutls_x509_crl_iter_crt_serial()**.
    


## RETURNS



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


* * *
# sctp_opt_info

## NAME



           sctp_optinfo - Get options on a SCTP socket.
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/socket.h>**
           **#include <netinet/sctp.h>**
    
           **int sctp_opt_info(int** _sd_**, sctp_assoc_t** _id_**, int** _opt_**,**
                             **void ***_arg_**, socklen_t ***_size);_
    


## DESCRIPTION



           **sctp_opt_info** is a wrapper library function that can be used to
           get SCTP level options on a socket.  _sd_ is the socket descriptor
           for which the option is requested. For one-to-many style sockets,
           _id_ specifies the association to query. For one-to-one style
           sockets, _id_ is ignored.  _opt_ specifes the SCTP socket option to
           get.  _arg_ is an option-specific structure buffer provided by the
           caller.  _size_ is a value-result parameter, initially containing
           the size of the buffer pointed to by _arg_ and modifed on return to
           indicate the actual size of the value returned.
    


## RETURN VALUE



           On success, **sctp_opt_info** returns 0 and on failure -1 is returned
           with errno set to the appropriate error code.
    


* * *
# curs_printw

## NAME



           **printw** , **wprintw** , **mvprintw** , **mvwprintw** , **vwprintw** , **vw_printw** - print
           formatted output in **curses** windows
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int printw(const char ***_fmt_**, ...);**
           **int wprintw(WINDOW ***_win_**, const char ***_fmt_**, ...);**
           **int mvprintw(int** _y_**, int** _x_**, const char ***_fmt_**, ...);**
           **int mvwprintw(WINDOW ***_win_**, int** _y_**, int** _x_**, const char ***_fmt_**, ...);**
           **int vw_printw(WINDOW ***_win_**, const char ***_fmt_**, va_list** _varglist_**);**
    
           /* obsolete */
           **int vwprintw(WINDOW ***_win_**, const char ***_fmt_**, va_list** _varglist_**);**
    


## DESCRIPTION



           The **printw** , **wprintw** , **mvprintw** and **mvwprintw** routines are analogous
           to  **printf**[see  printf(3)].  In effect, the string that would be
           output by **printf** is output instead as though **waddstr** were used  on
           the given window.
    
           The  **vwprintw** and **vw_printw** routines are analogous to **vprintf**[see
           printf(3)] and perform a **wprintw** using a variable  argument  list.
           The third argument is a **va_list** , a pointer to a list of arguments,
           as defined in **< stdarg.h>**.
    


## RETURN VALUE



           Routines  that  return  an  integer return **ERR** upon failure and **OK**
           (SVr4 only specifies "an integer value other than **ERR** ") upon  suc‐
           cessful completion.
    
           X/Open  defines  no  error conditions.  In this implementation, an
           error may be returned if it cannot allocate enough memory for  the
           buffer used to format the results.  It will return an error if the
           window pointer is null.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** ,  and return an error if the position is outside the window,
           or if the window pointer is null.
    


## PORTABILITY



           In this implementation, **vw_printw** and **vwprintw** are equivalent,  to
           support  legacy  applications.   However, the latter (**vwprintw**) is
           obsolete:
    
           •   The XSI Curses standard, Issue 4 described these functions.
               The function **vwprintw** is marked TO BE WITHDRAWN, and is to be
               replaced by a function **vw_printw** using the **< stdarg.h> **inter‐
               face.
    
           •   The Single Unix Specification, Version 2 states that **vw_printw**
               is preferred to **vwprintw** since the latter requires including
               **< varargs.h>**, which cannot be used in the same file as
               **< stdarg.h>**.  This implementation uses **< stdarg.h> **for both, be‐
               cause that header is included in **< curses.h**>.
    
           •   X/Open Curses, Issue 5 (December 2007) marked **vwprintw**(along
               with **vwscanw** and the termcap interface) as withdrawn.
    


* * *
# seccomp_version

## NAME



           seccomp_version - Query the libseccomp version information
    


## SYNOPSIS



           **#include <seccomp.h>**
    
           **struct scmp_version {**
                **unsigned int major;**
                **unsigned int minor;**
                **unsigned int micro;**
           **}**
    
           **const struct scmp_version *seccomp_version(**_void_**);**
    
           Link with _-lseccomp_.
    


## DESCRIPTION



           The **seccomp_version**() and **seccomp_reset**() functions return a
           pointer to a **scmp_version** struct which contains the version
           information of the currently loaded libseccomp library.  This
           function can be used by applications that need to verify that they
           are linked to a specific libseccomp version at runtime.
    
           The caller should not attempt to free the returned **scmp_version**
           struct when finished.
    


## RETURN VALUE



           The **seccomp_version**() function returns a pointer to a **scmp_version**
           structure on success, NULL on failure.  The caller should not
           attempt to free the returned structure.
    


## EXAMPLES



           #include <seccomp.h>
    
           int main(int argc, char *argv[])
           {
                const struct scmp_version *ver;
    
                ver = seccomp_version();
                if (ver == NULL)
                     goto err;
    
                /* ... */
    
                return 0;
    
           err:
                return 1;
           }
    


## NOTES



           While the seccomp filter can be generated independent of the
           kernel, kernel support is required to load and enforce the seccomp
           filter generated by libseccomp.
    
           The libseccomp project site, with more information and the source
           code repository, can be found at
           https://github.com/seccomp/libseccomp.  This tool, as well as the
           libseccomp library, is currently under development, please report
           any bugs at the project site or directly to the author.
    


* * *
# umad_get_ca

## NAME



           umad_get_ca, umad_release_ca - get and release InfiniBand device
           port attributes
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_get_ca(char** _*ca_name_**, umad_ca_t** _*ca_**);**
    
           **int umad_release_ca(umad_ca_t** _*ca_**);**
    


## DESCRIPTION



           **umad_get_ca()** gets the attributes of the InfiniBand device
           _ca_name_.  It fills the _ca_ structure with the device attributes
           specified by the _ca_name_ or with the default device attributes if
           _ca_name_ is NULL.  **umad_release_ca()** should be called before the _ca_
           structure is deallocated.  The argument _ca_ is an _umad_ca_t_ struct,
           as specified in <infiniband/umad.h>.
    
           typedef struct umad_ca {
                   char ca_name[UMAD_CA_NAME_LEN];                 /* Name of the device */
                   uint node_type;                                 /* Type of the device */
                   int numports;                                   /* Number of physical ports */
                   char fw_ver[20];                                /* FW version */
                   char ca_type[40];                               /* CA type (e.g. MT23108, etc.) */
                   char hw_ver[20];                                /* Hardware version */
                   uint64_t node_guid;                             /* Node GUID */
                   uint64_t system_guid;                           /* System image GUID */
                   umad_port_t *ports[UMAD_CA_MAX_PORTS];          /* Array of device port properties */
           } umad_ca_t;
    
           **umad_release_ca()** releases the resources that were allocated in
           the function **umad_get_ca()**.
    


## RETURN VALUE



           **umad_get_ca()** and **umad_release_ca()** return 0 on success, and a
           negative value on error.
    


* * *
# gnutls_x509_crt_list_import_url

## NAME



           gnutls_x509_crt_list_import_url - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_list_import_url(gnutls_x509_crt_t ****_certs_**,**
           **unsigned int ***_size_**, const char ***_url_**, gnutls_pin_callback_t**
           _pin_fn_**, void ***_pin_fn_userdata_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t ** certs
                       Will hold the allocated certificate list.
    
           unsigned int * size
                       It will contain the size of the list.
    
           const char * url
                       A PKCS 11 url
    
           gnutls_pin_callback_t pin_fn
                       a PIN callback if not globally set
    
           void * pin_fn_userdata
                       parameter for the PIN callback
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags for PKCS**11** URLs or
                       zero otherwise
    


## DESCRIPTION



           This function will import a certificate chain present in a PKCS**11**
           token or any type of back-end that supports URLs. The certificates
           must be deinitialized afterwards using **gnutls_x509_crt_deinit()**
           and the returned pointer must be freed using **gnutls_free()**.
    
           The URI provided must be the first certificate in the chain;
           subsequent certificates will be retrieved using
           **gnutls_pkcs11_get_raw_issuer()** or equivalent functionality for the
           supported URI.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# function::discard

## NAME



           function::discard - Discard all output related to a speculation
           buffer
    


## SYNOPSIS



               discard(id:long)
    


## ARGUMENTS



           _id_
               of the buffer to store the information in
    


* * *
# exit

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



           exit — terminate a process
    


## SYNOPSIS



           #include <stdlib.h>
    
           void exit(int _status_);
    


## 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 value of _status_ may be 0, EXIT_SUCCESS, EXIT_FAILURE, or any
           other value, though only the least significant 8 bits (that is,
           _status_ & 0377) shall be available from _wait_() and _waitpid_(); the
           full value shall be available from _waitid_() and in the **siginfo_t**
           passed to a signal handler for SIGCHLD.
    
           The _exit_() function shall first call all functions registered by
           _atexit_(), in the reverse order of their registration, except that
           a function is called after any previously registered functions
           that had already been called at the time it was registered. Each
           function is called as many times as it was registered. If, during
           the call to any such function, a call to the _longjmp_() function is
           made that would terminate the call to the registered function, the
           behavior is undefined.
    
           If a function registered by a call to _atexit_() fails to return,
           the remaining registered functions shall not be called and the
           rest of the _exit_() processing shall not be completed. If _exit_() is
           called more than once, the behavior is undefined.
    
           The _exit_() function shall then flush all open streams with
           unwritten buffered data and close all open streams. Finally, the
           process shall be terminated with the same consequences as
           described in _Consequences of Process Termination_.
    


## RETURN VALUE



           The _exit_() function does not return.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           See __Exit_().
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ttyname

## NAME



           ttyname, ttyname_r - return name of a terminal
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **char *ttyname(int** _fd_**);**
           **int ttyname_r(** size_t size;
                         **int** _fd_**, char** _buf_**[**_size_**], size_t** _size_**);**
    


## DESCRIPTION



           The function **ttyname**() returns a pointer to the null-terminated
           pathname of the terminal device that is open on the file
           descriptor _fd_ , or NULL on error (for example, if _fd_ is not
           connected to a terminal).  The return value may point to static
           data, possibly overwritten by the next call.  The function
           **ttyname_r**() stores this pathname in the buffer _buf_ of size _size_.
    


## RETURN VALUE



           The function **ttyname**() returns a pointer to a pathname on success.
           On error, NULL is returned, and _errno_ is set to indicate the
           error.  The function **ttyname_r**() returns 0 on success, and an
           error number upon error.
    


## ERRORS



           **EBADF** Bad file descriptor.
    
           **ENODEV** _fd_ refers to a slave pseudoterminal device but the
                  corresponding pathname could not be found (see NOTES).
    
           **ENOTTY** _fd_ does not refer to a terminal device.
    
           **ERANGE**(**ttyname_r**()) _size_ was too small to allow storing the
                  pathname.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           A process that keeps a file descriptor that refers to a pts(4)
           device open when switching to another mount namespace that uses a
           different _/dev/ptmx_ instance may still accidentally find that a
           device path of the same name for that file descriptor exists.
           However, this device path refers to a different device and thus
           can't be used to access the device that the file descriptor refers
           to.  Calling **ttyname**() or **ttyname_r**() on the file descriptor in
           the new mount namespace will cause these functions to return NULL
           and set _errno_ to **ENODEV**.
    


* * *
# pcre2_compile_context_copy

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_compile_context *pcre2_compile_context_copy(**
             **pcre2_compile_context ***_ccontext_**);**
    


## DESCRIPTION



    
           This function makes a new copy of a compile context, using the
           memory allocation function that was used for the original context.
           The result is NULL if the memory cannot be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# curs_ins_wch

## NAME



           **ins_wch** , **mvins_wch** , **mvwins_wch** , **wins_wch** - insert a complex
           character and rendition into a window
    


## SYNOPSIS



           #include <curses.h>
    
           **int ins_wch(const cchar_t ***_wch_**);**
           **int wins_wch(WINDOW ***_win_**, const cchar_t ***_wch_**);**
    
           **int mvins_wch(int** _y_**, int** _x_**, const cchar_t ***_wch_**);**
           **int mvwins_wch(WINDOW ***_win_**, int** _y_**, int** _x_**, const cchar_t ***_wch_**);**
    


## DESCRIPTION



           These routines, insert the complex character _wch_ with rendition
           before the character under the cursor.  All characters to the
           right of the cursor are moved one space to the right, with the
           possibility of the rightmost character on the line being lost.
           The insertion operation does not change the cursor position.
    


## RETURN VALUE



           If successful, these functions return **OK**.  If not, they return
           **ERR**.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


## ERRORS



           No errors are defined.
    


* * *
# capng_fill

## NAME



           capng_fill - fill chosen capabilities set
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           void capng_fill(capng_select_t set);
    


## DESCRIPTION



           capng_fill sets all bits to a 1 in the selected POSIX capabilities
           set. The options are CAPNG_SELECT_CAPS for the traditional
           capabilities, CAPNG_SELECT_BOUNDS for the bounding set,
           CAPNG_SELECT_BOTH if filling both is desired, CAPNG_SELECT_AMBIENT
           if only operating on the ambient capabilities, or CAPNG_SELECT_ALL
           if clearing all is desired..
    


## RETURN VALUE



           None.
    


## NOTES



           During capng_apply, bits in the bounding set can only be dropped.
           You cannot set them.
    


* * *
# atoi

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



           atoi — convert a string to an integer
    


## SYNOPSIS



           #include <stdlib.h>
    
           int atoi(const char *_str_);
    


## 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 call _atoi_(_str_) shall be equivalent to:
    
               (int) strtol(str, (char **)NULL, 10)
    
           except that the handling of errors may differ. If the value cannot
           be represented, the behavior is undefined.
    


## RETURN VALUE



           The _atoi_() function shall return the converted value if the value
           can be represented.
    


## ERRORS



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


## EXAMPLES



       **Converting an Argument**
           The following example checks for proper usage of the program. If
           there is an argument and the decimal conversion of this argument
           (obtained using _atoi_()) is greater than 0, then the program has a
           valid number of minutes to wait for an event.
    
               #include <stdlib.h>
               #include <stdio.h>
               ...
               int minutes_to_event;
               ...
               if (argc < 2 || ((minutes_to_event = atoi (argv[1]))) <= 0) {
                  fprintf(stderr, "Usage: %s minutes\n", argv[0]); exit(1);
               }
               ...
    


## APPLICATION USAGE



           The _atoi_() function is subsumed by _strtol_() but is retained
           because it is used extensively in existing code. If the number is
           not known to be in range, _strtol_() should be used because _atoi_()
           is not required to perform any error checking.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::ipmib.InReceives

## NAME



           probe::ipmib.InReceives - Count an arriving packet
    


## SYNOPSIS



           ipmib.InReceives
    


## VALUES



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


## DESCRIPTION



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


* * *
# setvbuf

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



           setvbuf — assign buffering to a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int setvbuf(FILE *restrict _stream_ , char *restrict _buf_ , int _type_ ,
               size_t _size_);
    


## 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 _setvbuf_() function may be used after the stream pointed to by
           _stream_ is associated with an open file but before any other
           operation (other than an unsuccessful call to _setvbuf_()) is
           performed on the stream. The argument _type_ determines how _stream_
           shall be buffered, as follows:
    
            *  {_IOFBF} shall cause input/output to be fully buffered.
    
            *  {_IOLBF} shall cause input/output to be line buffered.
    
            *  {_IONBF} shall cause input/output to be unbuffered.
    
           If _buf_ is not a null pointer, the array it points to may be used
           instead of a buffer allocated by _setvbuf_() and the argument _size_
           specifies the size of the array; otherwise, _size_ may determine the
           size of a buffer allocated by the _setvbuf_() function. The contents
           of the array at any time are unspecified.
    
           For information about streams, see _Section 2.5_ , _Standard I/O_
           _Streams_.
    


## RETURN VALUE



           Upon successful completion, _setvbuf_() shall return 0. Otherwise,
           it shall return a non-zero value if an invalid value is given for
           _type_ or if the request cannot be honored, and may set _errno_ to
           indicate the error.
    


## ERRORS



           The _setvbuf_() function may fail if:
    
           **EBADF** The file descriptor underlying _stream_ is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           A common source of error is allocating buffer space as an
           ``automatic'' variable in a code block, and then failing to close
           the stream in the same block.
    
           With _setvbuf_(), allocating a buffer of _size_ bytes does not
           necessarily imply that all of _size_ bytes are used for the buffer
           area.
    
           Applications should note that many implementations only provide
           line buffering on input from terminal devices.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# isalnum

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



           isalnum, isalnum_l — test for an alphanumeric character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isalnum(int _c_);
           int isalnum_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isalnum_(): 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 _isalnum_() and _isalnum_l_() functions shall test whether _c_ is 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 _c_ argument is an **int** , the value of which the application shall
           ensure is representable as an **unsigned char** or equal to the value
           of the macro EOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isalnum_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isalnum_() and _isalnum_l_() functions shall return non-zero if _c_
           is an alphanumeric character; 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.
    


* * *
# ibv_detach_mcast

## NAME



           ibv_attach_mcast, ibv_detach_mcast - attach and detach a queue
           pair (QPs) to/from a multicast group
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_attach_mcast(struct ibv_qp *qp, const union ibv_gid *gid, uint16_t lid);
    
                  int ibv_detach_mcast(struct ibv_qp *qp, const union ibv_gid *gid, uint16_t lid);
    


## DESCRIPTION



           **ibv_attach_mcast()** attaches the QP _qp_ to the multicast group
           having MGID _gid_ and MLID _lid_.
    
           **ibv_detach_mcast()** detaches the QP _qp_ to the multicast group
           having MGID _gid_ and MLID _lid_.
    


## RETURN VALUE



           **ibv_attach_mcast()** and **ibv_detach_mcast()** returns 0 on success, or
           the value of errno on failure (which indicates the failure
           reason).
    


## NOTES



           Only QPs of Transport Service Type **IBV_QPT_UD** may be attached to
           multicast groups.
    
           If a QP is attached to the same multicast group multiple times,
           the QP will still receive a single copy of a multicast message.
    
           In order to receive multicast messages, a join request for the
           multicast group must be sent to the subnet administrator (SA), so
           that the fabric’s multicast routing is configured to deliver
           messages to the local port.
    


* * *
# gnutls_session_set_premaster

## NAME



           gnutls_session_set_premaster - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_set_premaster(gnutls_session_t** _session_**,**
           **unsigned int** _entity_**, gnutls_protocol_t** _version_**,**
           **gnutls_kx_algorithm_t** _kx_**, gnutls_cipher_algorithm_t** _cipher_**,**
           **gnutls_mac_algorithm_t** _mac_**, gnutls_compression_method_t** _comp_**,**
           **const gnutls_datum_t ***_master_**, const gnutls_datum_t ***_session_id_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int entity
                       GNUTLS_SERVER or GNUTLS_CLIENT
    
           gnutls_protocol_t version
                       the TLS protocol version
    
           gnutls_kx_algorithm_t kx
                       the key exchange method
    
           gnutls_cipher_algorithm_t cipher
                       the cipher
    
           gnutls_mac_algorithm_t mac
                       the MAC algorithm
    
           gnutls_compression_method_t comp
                       the compression method (ignored)
    
           const gnutls_datum_t * master
                       the master key to use
    
           const gnutls_datum_t * session_id
                       the session identifier
    


## DESCRIPTION



           This function sets the premaster secret in a session. This is a
           function intended for exceptional uses. Do not use this function
           unless you are implementing a legacy protocol.  Use
           **gnutls_session_set_data()** instead.
    


## RETURNS



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


* * *
# pmeventflagsstr

## NAME



           **pmEventFlagsStr** , **pmEventFlagsStr_r** - convert an event record flags
           value into a string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmEventFlagsStr(int** _flags_**);**
           **char *pmEventFlagsStr_r(int** _flags_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           For  use in error and diagnostic messages, **pmEventFlagsStr** returns
           a `human readable' version of the value _flags_ , assuming this to be
           the **er_flags** field of  a  **pmEventRecord** or  **pmHighResEventRecord**.
           The  **pmEventFlagsStr_r** function does the same, but stores the re‐
           sult in a user-supplied buffer _buf_ of length _buflen_ , which  should
           have room for at least 64 bytes.
    
           The  string  value result from **pmEventFlagsStr** is held in a single
           static buffer, so the returned value is only valid until the  next
           call to **pmEventFlagsStr**.
    


## NOTES



           **pmEventFlagsStr** returns a pointer to a static buffer and hence is
           not thread-safe.  Multi-threaded applications should use  **pmEvent‐**
           **FlagsStr_r** instead.
    


* * *
# menu_opts

## NAME



           **set_menu_opts** , **menu_opts_on** , **menu_opts_off** , **menu_opts** - set and
           get menu options
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_opts(MENU ***_menu_**, Menu_Options** _opts_**);**
           **Menu_Options menu_opts(const MENU ***_menu_**);**
    
           **int menu_opts_on(MENU ***_menu_**, Menu_Options** _opts_**);**
           **int menu_opts_off(MENU ***_menu_**, Menu_Options** _opts_**);**
    


## DESCRIPTION



           The function **set_menu_opts** sets all the given menu's option bits
           (menu option bits may be logically-OR'ed together).
    
           The function **menu_opts_on** turns on the given option bits, and
           leaves others alone.
    
           The function **menu_opts_off** turns off the given option bits, and
           leaves others alone.
    
           The function **menu_opts** returns the menu's current option bits.
    
           The following options are defined (all are on by default):
    
           O_ONEVALUE
                Only one item can be selected for this menu.
    
           O_SHOWDESC
                Display the item descriptions when the menu is posted.
    
           O_ROWMAJOR
                Display the menu in row-major order.
    
           O_IGNORECASE
                Ignore the case when pattern-matching.
    
           O_SHOWMATCH
                Move the cursor to within the item name while pattern-
                matching.
    
           O_NONCYCLIC
                Don't wrap around next-item and previous-item, requests to
                the other end of the menu.
    
           O_MOUSE_MENU
                If user clicks with the mouse and it does not fall on the
                currently active menu, push **KEY_MOUSE** and the **MEVENT** data
                back on the queue to allow processing in another part of the
                calling program.
    


## RETURN VALUE



           Except for **menu_opts** , each routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_POSTED**
                The menu is already posted.
    


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


* * *
# toascii

## NAME



           toascii - convert character to ASCII
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <ctype.h>**
    
           **[[deprecated]] int toascii(int** _c_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **toascii**():
               _XOPEN_SOURCE
                   || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
    


## DESCRIPTION



           **toascii**() converts _c_ to a 7-bit _unsigned char_ value that fits into
           the ASCII character set, by clearing the high-order bits.
    


## RETURN VALUE



           The value returned is that of the converted character.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## BUGS



           Many people will be unhappy if you use this function.  This
           function will convert accented letters into random characters.
    


* * *
# form_field_userptr

## NAME



           **set_field_userptr** , **field_userptr** - associate application data with
           a form field
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_field_userptr(FIELD ***_field_**, void ***_userptr_**);**
           **void *field_userptr(const FIELD ***_field_**);**
    


## DESCRIPTION



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


## RETURN VALUE



           The function **field_userptr** returns a pointer (which may be **NULL**).
           It does not set **errno**.
    
           The function **set_field_userptr** returns **E_OK**(success).
    


## NOTES



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


## PORTABILITY



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


* * *
# capng_have_capabilities

## NAME



           capng_have_capabilities, capng_have_permitted_capabilities - check for capabilities
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           capng_results_t capng_have_capabilities(capng_select_t set);
           capng_results_t capng_have_permitted_capabilities(void);
    


## DESCRIPTION



           capng_have_capabilities will check the selected internal
           capabilities sets to see what the status is. The capabilities sets
           must be previously setup with calls to capng_get_caps_process,
           capng_get_caps_fd, or in some other way setup. The options are
           CAPNG_SELECT_CAPS for the traditional capabilities,
           CAPNG_SELECT_BOUNDS for the bounding set, CAPNG_SELECT_BOTH if
           checking both are desired, CAPNG_SELECT_AMBIENT if only checking
           the ambient capabilities, or CAPNG_SELECT_ALL if testing all sets
           is desired. When capabilities are checked, it will only look at
           the effective capabilities.
    
           If, however, the source of capabilities comes from a file, then
           you may need to additionally check the permitted capabilities.
           It's for this reason that **capng_have_permitted_capabilities** was
           created. It takes no arguments because it simply checks the
           permitted set.
    


## RETURN VALUE



           This function will return one of the following four self
           explanatory values: CAPNG_FAIL, CAPNG_NONE, CAPNG_PARTIAL,
           CAPNG_FULL.
    


* * *