tripathysagar/man_text huggingface dataset:
# gnutls_pkcs11_obj_export3

## NAME



           gnutls_pkcs11_obj_export3 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_export3(gnutls_pkcs11_obj_t** _obj_**,**
           **gnutls_x509_crt_fmt_t** _fmt_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       Holds the object
    
           gnutls_x509_crt_fmt_t fmt
                       The format of the exported data
    
           gnutls_datum_t * out
                       will contain the object data
    


## DESCRIPTION



           This function will export the PKCS11 object data.  It is normal
           for data to be inaccessible and in that case
           **GNUTLS_E_INVALID_REQUEST** will be returned.
    
           The output buffer is allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.2.7
    


* * *
# remove

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



           remove — remove a file
    


## SYNOPSIS



           #include <stdio.h>
    
           int remove(const char *_path_);
    


## 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 _remove_() function shall cause the file named by the pathname
           pointed to by _path_ to be no longer accessible by that name. A
           subsequent attempt to open that file using that name shall fail,
           unless it is created anew.
    
           If _path_ does not name a directory, _remove_(_path_) shall be
           equivalent to _unlink_(_path_).
    
           If _path_ names a directory, _remove_(_path_) shall be equivalent to
           _rmdir_(_path_).
    


## RETURN VALUE



           Refer to rmdir(3p) or unlink(3p).
    


## ERRORS



           Refer to rmdir(3p) or unlink(3p).
    
           _The following sections are informative._
    


## EXAMPLES



       **Removing Access to a File**
           The following example shows how to remove access to a file named
           **/home/cnd/old_mods**.
    
               #include <stdio.h>
    
               int status;
               ...
               status = remove("/home/cnd/old_mods");
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ibv_rereg_mr

## NAME



           ibv_rereg_mr - re-register a memory region (MR)
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_rereg_mr(struct ibv_mr *mr,
                                   int flags,
                                   struct ibv_pd *pd,
                                   void *addr,
                                   size_t length,
                                   int access);
    


## DESCRIPTION



           **ibv_rereg_mr()** Modifies the attributes of an existing memory
           region (MR) _mr_.  Conceptually, this call performs the functions
           deregister memory region followed by register memory region.
           Where possible, resources are reused instead of deallocated and
           reallocated.
    
           _flags_ is a bit-mask used to indicate which of the following
           properties of the memory region are being modified.  Flags should
           be a combination (bit field) of:
    
           **IBV_REREG_MR_CHANGE_TRANSLATION**
                  Change translation (location and length)
    
           **IBV_REREG_MR_CHANGE_PD**
                  Change protection domain
    
           **IBV_REREG_MR_CHANGE_ACCESS**
                  Change access flags
    
           When **IBV_REREG_MR_CHANGE_PD** is used, _pd_ represents the new PD this
           MR should be registered to.
    
           When **IBV_REREG_MR_CHANGE_TRANSLATION** is used, _addr_.  represents
           the virtual address (user-space pointer) of the new MR, while
           _length_ represents its length.
    
           The access and other flags are represented in the field _access_.
           This field describes the desired memory protection attributes; it
           is either 0 or the bitwise OR of one or more of ibv_access_flags.
    


## RETURN VALUE



           **ibv_rereg_mr()** returns 0 on success, otherwise an error has
           occurred, _enum ibv_rereg_mr_err_code_ represents the error as of
           below.
    
           IBV_REREG_MR_ERR_INPUT - Old MR is valid, an input error was
           detected by libibverbs.
    
           IBV_REREG_MR_ERR_DONT_FORK_NEW - Old MR is valid, failed via don’t
           fork on new address range.
    
           IBV_REREG_MR_ERR_DO_FORK_OLD - New MR is valid, failed via do fork
           on old address range.
    
           IBV_REREG_MR_ERR_CMD - MR shouldn’t be used, command error.
    
           IBV_REREG_MR_ERR_CMD_AND_DO_FORK_NEW - MR shouldn’t be used,
           command error, invalid fork state on new address range.
    


## NOTES



           Even on a failure, the user still needs to call ibv_dereg_mr on
           this MR.
    


* * *
# setjmp

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



           setjmp — set jump point for a non-local goto
    


## SYNOPSIS



           #include <setjmp.h>
    
           int setjmp(jmp_buf _env_);
    


## 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.
    
           A call to _setjmp_() shall save the calling environment in its _env_
           argument for later use by _longjmp_().
    
           It is unspecified whether _setjmp_() is a macro or a function. If a
           macro definition is suppressed in order to access an actual
           function, or a program defines an external identifier with the
           name _setjmp_ , the behavior is undefined.
    
           An application shall ensure that an invocation of _setjmp_() appears
           in one of the following contexts only:
    
            *  The entire controlling expression of a selection or iteration
               statement
    
            *  One operand of a relational or equality operator with the
               other operand an integral constant expression, with the
               resulting expression being the entire controlling expression
               of a selection or iteration statement
    
            *  The operand of a unary **'!'** operator with the resulting
               expression being the entire controlling expression of a
               selection or iteration
    
            *  The entire expression of an expression statement (possibly
               cast to **void**)
    
           If the invocation appears in any other context, the behavior is
           undefined.
    


## RETURN VALUE



           If the return is from a direct invocation, _setjmp_() shall return
           0. If the return is from a call to _longjmp_(), _setjmp_() shall
           return a non-zero value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           In general, _sigsetjmp_() is more useful in dealing with errors and
           interrupts encountered in a low-level subroutine of a program.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::tty

## NAME



           tapset::tty - systemtap tty tapset
    


## DESCRIPTION



           **tty.open**
                  Called when a tty is opened
    
                   See probe::tty.open(3stap)
                   for details.
    
           **tty.release**
                  Called when the tty is closed
    
                   See probe::tty.release(3stap)
                   for details.
    
           **tty.resize**
                  Called when a terminal resize happens
    
                   See probe::tty.resize(3stap)
                   for details.
    
           **tty.ioctl**
                  called when a ioctl is request to the tty
    
                   See probe::tty.ioctl(3stap)
                   for details.
    
           **tty.init**
                  Called when a tty is being initalized
    
                   See probe::tty.init(3stap)
                   for details.
    
           **tty.register**
                  Called when a tty device is registred
    
                   See probe::tty.register(3stap)
                   for details.
    
           **tty.unregister**
                  Called when a tty device is being unregistered
    
                   See probe::tty.unregister(3stap)
                   for details.
    
           **tty.poll**
                  Called when a tty device is being polled
    
                   See probe::tty.poll(3stap)
                   for details.
    
           **tty.receive**
                  called when a tty receives a message
    
                   See probe::tty.receive(3stap)
                   for details.
    
           **tty.write**
                  write to the tty line
    
                   See probe::tty.write(3stap)
                   for details.
    
           **tty.read**
                  called when a tty line will be read
    
                   See probe::tty.read(3stap)
                   for details.
    


* * *
# function::sprint_ustack

## NAME



           function::sprint_ustack - Return stack for the current task from
           string.
    


## SYNOPSIS



               sprint_ustack:string(stk:string)
    


## ARGUMENTS



           _stk_
               String with list of hexadecimal addresses for the current
               task.
    


## DESCRIPTION



           Perform a symbolic lookup of the addresses in the given string,
           which is assumed to be the result of a prior call to **ubacktrace**
           for the current task.
    
           Returns a simple backtrace from the given hex string. One line per
           address. Includes the symbol name (or hex address if symbol
           couldn't be resolved) and module name (if found). Includes the
           offset from the start of the function if found, otherwise the
           offset will be added to the module (if found, between brackets).
           Returns the backtrace as string (each line terminated by a newline
           character). Note that the returned stack will be truncated to
           MAXSTRINGLEN, to print fuller and richer stacks use print_ustack.
    


## NOTE



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


* * *
# abort

## NAME



           abort - cause abnormal process termination
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **[[noreturn]] void abort(void);**
    


## DESCRIPTION



           The **abort**() function first unblocks the **SIGABRT** signal, and then
           raises that signal for the calling process (as though raise(3) was
           called).  This results in the abnormal termination of the process
           unless the **SIGABRT** signal is caught and the signal handler does
           not return (see longjmp(3)).
    
           If the **SIGABRT** signal is ignored, or caught by a handler that
           returns, the **abort**() function will still terminate the process.
           It does this by restoring the default disposition for **SIGABRT** and
           then raising the signal for a second time.
    
           As with other cases of abnormal termination the functions
           registered with atexit(3) and on_exit(3) are not called.
    


## RETURN VALUE



           The **abort**() function never returns.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# probe::netdev.change_mac

## NAME



           probe::netdev.change_mac - Called when the netdev_name has the MAC
           changed
    


## SYNOPSIS



           netdev.change_mac
    


## VALUES



           _dev_name_
               The device that will have the MAC changed
    
           _mac_len_
               The MAC length
    
           _old_mac_
               The current MAC address
    
           _new_mac_
               The new MAC address
    


* * *
# getchar

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



           getchar — get a byte from a _stdin_ stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int getchar(void);
    


## 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 _getchar_() function shall be equivalent to _getc_(_stdin_).
    


## RETURN VALUE



           Refer to fgetc(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           If the integer value returned by _getchar_() is stored into a
           variable of type **char** and then compared against the integer
           constant EOF, the comparison may never succeed, because sign-
           extension of a variable of type **char** on widening to integer is
           implementation-defined.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_ext_register

## NAME



           gnutls_ext_register - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ext_register(const char ***_name_**, int** _id_**,**
           **gnutls_ext_parse_type_t** _parse_point_**, gnutls_ext_recv_func**
           _recv_func_**, gnutls_ext_send_func** _send_func_**,**
           **gnutls_ext_deinit_data_func** _deinit_func_**, gnutls_ext_pack_func**
           _pack_func_**, gnutls_ext_unpack_func** _unpack_func_**);**
    


## ARGUMENTS



           const char * name
                       the name of the extension to register
    
           int id      the numeric TLS id of the extension
    
           gnutls_ext_parse_type_t parse_point
                       the parse type of the extension (see
                       gnutls_ext_parse_type_t)
    
           gnutls_ext_recv_func recv_func
                       a function to receive the data
    
           gnutls_ext_send_func send_func
                       a function to send the data
    
           gnutls_ext_deinit_data_func deinit_func
                       a function deinitialize any private data
    
           gnutls_ext_pack_func pack_func
                       a function which serializes the extension's private
                       data (used on session packing for resumption)
    
           gnutls_ext_unpack_func unpack_func
                       a function which will deserialize the extension's
                       private data
    


## DESCRIPTION



           This function will register a new extension type. The extension
           will remain registered until **gnutls_global_deinit()** is called. If
           the extension type is already registered then
           **GNUTLS_E_ALREADY_REGISTERED** will be returned.
    
           Each registered extension can store temporary data into the
           gnutls_session_t structure using **gnutls_ext_set_data()** , and they
           can be retrieved using **gnutls_ext_get_data()**.
    
           Any extensions registered with this function are valid for the
           client and TLS1.2 server hello (or encrypted extensions for
           TLS1.3).
    
           This function is not thread safe.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# tapset::memory

## NAME



           tapset::memory - systemtap memory tapset
    


## DESCRIPTION



            This family of probe points is used to probe memory-related
           events.
    
           **vm_fault_contains**
                  Test return value for page fault reason
    
                  See function::vm_fault_contains(3stap)
                   for details.
    
           **vm.pagefault**
                  Records that a page fault occurred
    
                   See probe::vm.pagefault(3stap)
                   for details.
    
           **vm.pagefault.return**
                  Indicates what type of fault occurred
    
                   See probe::vm.pagefault.return(3stap)
                   for details.
    
           **addr_to_node**
                  Returns which node a given address belongs to within a NUMA
                  system
    
                  See function::addr_to_node(3stap)
                   for details.
    
           **vm.write_shared**
                  Attempts at writing to a shared page
    
                   See probe::vm.write_shared(3stap)
                   for details.
    
           **vm.write_shared_copy**
                  Page copy for shared page write
    
                   See probe::vm.write_shared_copy(3stap)
                   for details.
    
           **vm.mmap**
                  Fires when an mmap is requested
    
                   See probe::vm.mmap(3stap)
                   for details.
    
           **vm.munmap**
                  Fires when an munmap is requested
    
                   See probe::vm.munmap(3stap)
                   for details.
    
           **vm.brk** Fires when a brk is requested (i.e. the heap will be
                  resized)
    
                   See probe::vm.brk(3stap)
                   for details.
    
           **vm.oom_kill**
                  Fires when a thread is selected for termination by the OOM
                  killer
    
                   See probe::vm.oom_kill(3stap)
                   for details.
    
           **vm.kmalloc**
                  Fires when kmalloc is requested
    
                   See probe::vm.kmalloc(3stap)
                   for details.
    
           **vm.kmem_cache_alloc**
                  Fires when kmem_cache_alloc is requested
    
                   See probe::vm.kmem_cache_alloc(3stap)
                   for details.
    
           **vm.kmalloc_node**
                  Fires when kmalloc_node is requested
    
                   See probe::vm.kmalloc_node(3stap)
                   for details.
    
           **vm.kmem_cache_alloc_node**
                  Fires when kmem_cache_alloc_node is requested
    
                   See probe::vm.kmem_cache_alloc_node(3stap)
                   for details.
    
           **vm.kfree**
                  Fires when kfree is requested
    
                   See probe::vm.kfree(3stap)
                   for details.
    
           **vm.kmem_cache_free**
                  Fires when kmem_cache_free is requested
    
                   See probe::vm.kmem_cache_free(3stap)
                   for details.
    


* * *
# probe::signal.procmask.return

## NAME



           probe::signal.procmask.return - Examining or changing blocked
           signals completed
    


## SYNOPSIS



           signal.procmask.return
    


## VALUES



           _retstr_
               Return value as a string
    
           _name_
               Name of the probe point
    


* * *
# bswap

## NAME



           bswap_16, bswap_32, bswap_64 - reverse order of bytes
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <byteswap.h>**
    
           **uint16_t bswap_16(uint16_t** _x_**);**
           **uint32_t bswap_32(uint32_t** _x_**);**
           **uint64_t bswap_64(uint64_t** _x_**);**
    


## DESCRIPTION



           These functions return a value in which the order of the bytes in
           their 2-, 4-, or 8-byte arguments is reversed.
    


## RETURN VALUE



           These functions return the value of their argument with the bytes
           reversed.
    


## ERRORS



           These functions always succeed.
    


## STANDARDS



           GNU.
    


## EXAMPLES



           The program below swaps the bytes of the 8-byte integer supplied
           as its command-line argument.  The following shell session
           demonstrates the use of the program:
    
               $ **./a.out 0x0123456789abcdef** ;
               0x123456789abcdef ==> 0xefcdab8967452301
    
       **Program source**
    
           #include <byteswap.h>
           #include <inttypes.h>
           #include <stdint.h>
           #include <stdio.h>
           #include <stdlib.h>
    
           int
           main(int argc, char *argv[])
           {
               uint64_t x;
    
               if (argc != 2) {
                   fprintf(stderr, "Usage: %s <num>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }
    
               x = strtoull(argv[1], NULL, 0);
               printf("%#" PRIx64 " ==> %#" PRIx64 "\n", x, bswap_64(x));
    
               exit(EXIT_SUCCESS);
           }
    


* * *
# isgreater

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



           isgreater — test if x greater than y
    


## SYNOPSIS



           #include <math.h>
    
           int isgreater(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 _isgreater_() macro shall determine whether its first argument
           is greater than its second argument. The value of _isgreater_(_x_ , _y_)
           shall be equal to (_x_) > (_y_); however, unlike (_x_) > (_y_),
           _isgreater_(_x_ , _y_) shall not raise the invalid floating-point
           exception when _x_ and _y_ are unordered.
    


## RETURN VALUE



           Upon successful completion, the _isgreater_() 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.
    


* * *
# iswalnum

## NAME



           iswalnum - test for alphanumeric wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswalnum(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswalnum**() function is the wide-character equivalent of the
           isalnum(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "alnum".
    
           The wide-character class "alnum" is a subclass of the wide-
           character class "graph", and therefore also a subclass of the
           wide-character class "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "alnum" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "alnum" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           The wide-character class "alnum" is disjoint from the wide-
           character class "punct".
    
           The wide-character class "alnum" is the union of the wide-
           character classes "alpha" and "digit".  As such, it also contains
           the wide-character class "xdigit".
    
           The wide-character class "alnum" always contains at least the
           letters 'A' to 'Z', 'a' to 'z', and the digits '0' to '9'.
    


## RETURN VALUE



           The **iswalnum**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "alnum".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswalnum**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# curs_ins_wstr

## NAME



           **ins_wstr** , **ins_nwstr** , **wins_wstr** , **wins_nwstr** , **mvins_wstr** ,
           **mvins_nwstr** , **mvwins_wstr** , **mvwins_nwstr** - insert a wide-character
           string into a curses window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int ins_wstr(const wchar_t ***_wstr);_
           **int ins_nwstr(const wchar_t ***_wstr_**, int** _n_**);**
           **int wins_wstr(WINDOW ***_win_**, const wchar_t ***_wstr_**);**
           **int wins_nwstr(WINDOW ***_win_**, const wchar_t ***_wstr_**, int** _n_**);**
    
           **int mvins_wstr(int** _y_**, int** _x_**, const wchar_t ***_wstr_**);**
           **int mvins_nwstr(int** _y_**, int** _x_**, const wchar_t ***_wstr_**, int** _n_**);**
           **int mvwins_wstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const wchar_t ***_wstr_**);**
           **int mvwins_nwstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const wchar_t ***_wstr_**, int** _n_**);**
    


## DESCRIPTION



           These  routines insert a **wchar_t** character string (as many charac‐
           ters as will fit on the line) before the character under the  cur‐
           sor.  All characters to the right of the cursor are shifted right,
           with the possibility of the rightmost characters on the line being
           lost.   No  wrapping  is  performed.  The cursor position does not
           change (after moving to _y_ , _x_ , if specified).   The  four  routines
           with  _n_ as the last argument insert a leading substring of at most
           _n_ **wchar_t** characters.  If _n_ is less than 1, the entire  string  is
           inserted.
    
           If a character in _wstr_ is a tab, newline, carriage return or back‐
           space,  the  cursor  is  moved appropriately within the window.  A
           newline also does a **clrtoeol** before moving.  Tabs  are  considered
           to  be  at every eighth column.  If a character in _wstr_ is another
           control character, it  is  drawn  in  the  **^**_X_  notation.   Calling
           **win_wch** after  adding  a  control character (and moving to it, if
           necessary) does not return the control character, but instead  re‐
           turns  a  character in the ^-representation of the control charac‐
           ter.
    


## NOTES



           Note that all but wins_nwstr may be macros.
    
           If the first character in the string is  a  nonspacing  character,
           these  functions  will fail.  XSI does not define what will happen
           if a nonspacing character follows a control character.
    


## RETURN VALUE



           Upon successful completion, these functions return **OK**.  Otherwise,
           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.
    


* * *
# gnutls_pkcs7_get_embedded_data_oid

## NAME



           gnutls_pkcs7_get_embedded_data_oid - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **const char * gnutls_pkcs7_get_embedded_data_oid(gnutls_pkcs7_t**
           _pkcs7_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a gnutls_pkcs7_t type
    


## DESCRIPTION



           This function will return the OID of the data embedded in the
           signature of the PKCS7 structure. If no data are available then
           **NULL** will be returned. The returned value will be valid during the
           lifetime of the  _pkcs7_ structure.
    


## RETURNS



           On success, a pointer to an OID string, **NULL** on error.
    


## SINCE



           3.5.5
    


* * *
# sd_journal_get_realtime_usec

## NAME



           sd_journal_get_realtime_usec, sd_journal_get_monotonic_usec - Read
           timestamps from the current journal entry
    


## SYNOPSIS



           **#include <systemd/sd-journal.h>**
    
           **int sd_journal_get_realtime_usec(sd_journal ***_j_**, uint64_t ***_usec_**);**
    
           **int sd_journal_get_monotonic_usec(sd_journal ***_j_**, uint64_t ***_usec_**,**
                                             **sd_id128_t ***_boot_id_**);**
    


## DESCRIPTION



           **sd_journal_get_realtime_usec()** gets the realtime (wallclock)
           timestamp of the current journal entry. It takes two arguments:
           the journal context object and a pointer to a 64-bit unsigned
           integer to store the timestamp in. The timestamp is in
           microseconds since the epoch, i.e.  **CLOCK_REALTIME**.
    
           **sd_journal_get_monotonic_usec()** gets the monotonic timestamp of
           the current journal entry. It takes three arguments: the journal
           context object, a pointer to a 64-bit unsigned integer to store
           the timestamp in, as well as a 128-bit ID buffer to store the boot
           ID of the monotonic timestamp. The timestamp is in microseconds
           since boot-up of the specific boot, i.e.  **CLOCK_MONOTONIC**. Since
           the monotonic clock begins new with every reboot, it only defines
           a well-defined point in time when used together with an identifier
           identifying the boot. See sd_id128_get_boot(3) for more
           information. If the boot ID parameter is passed **NULL** , the function
           will fail if the monotonic timestamp of the current entry is not
           of the current system boot.
    
           Note that these functions will not work before sd_journal_next(3)
           (or related call) has been called at least once, in order to
           position the read pointer at a valid entry.
    


## RETURN VALUE



           **sd_journal_get_realtime_usec()** and **sd_journal_get_monotonic_usec()**
           returns 0 on success or a negative errno-style error code. If the
           boot ID parameter was passed **NULL** and the monotonic timestamp of
           the current journal entry is not of the current system boot,
           **-ESTALE** is returned by **sd_journal_get_monotonic_usec()**.
    


## NOTES



           All functions listed here are thread-agnostic and only a single
           specific thread may operate on a given object during its entire
           lifetime. It is safe to allocate multiple independent objects and
           use each from a specific thread in parallel. However, it is not
           safe to allocate such an object in one thread, and operate or free
           it from any other, even if locking is used to ensure these threads
           do not operate on it at the very same time.
    
           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    


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



           shutdown — shut down socket send and receive operations
    


## SYNOPSIS



           #include <sys/socket.h>
    
           int shutdown(int _socket_ , int _how_);
    


## DESCRIPTION



           The _shutdown_() function shall cause all or part of a full-duplex
           connection on the socket associated with the file descriptor
           _socket_ to be shut down.
    
           The _shutdown_() function takes the following arguments:
    
           _socket_      Specifies the file descriptor of the socket.
    
           _how_         Specifies the type of shutdown. The values are as
                       follows:
    
                       SHUT_RD     Disables further receive operations.
    
                       SHUT_WR     Disables further send operations.
    
                       SHUT_RDWR   Disables further send and receive
                                   operations.
    
           The _shutdown_() function disables subsequent send and/or receive
           operations on a socket, depending on the value of the _how_
           argument.
    


## RETURN VALUE



           Upon successful completion, _shutdown_() shall return 0; otherwise,
           -1 shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _shutdown_() function shall fail if:
    
           **EBADF** The _socket_ argument is not a valid file descriptor.
    
           **EINVAL** The _how_ argument is invalid.
    
           **ENOTCONN**
                  The socket is not connected.
    
           **ENOTSOCK**
                  The _socket_ argument does not refer to a socket.
    
           The _shutdown_() function may fail if:
    
           **ENOBUFS**
                  Insufficient resources were available in the system to
                  perform the operation.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmisetversion

## NAME



           **pmiSetVersion** - set the archive version for a LOGIMPORT archive
    


## C SYNOPSIS



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


## PERL SYNOPSIS



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


## PYTHON SYNOPSIS



           **from pcp import pmi**
    
           **log = pmi.pmiLogImport(**_path_**).pmiSetVersion(**_value_**)**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiSetVersion** sets the output  archive  version  in
           the current context to be _value_.
    
           In  the  absence  of a call to **pmiSetVersion** the version currently
           defaults to the traditional v2 format.  In a future major  version
           of PCP it will default to v3 format.
    


## DIAGNOSTICS



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


* * *
# io_uring_wait_cqes

## NAME



           io_uring_wait_cqes - wait for one or more io_uring completion
           events
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_wait_cqes(struct io_uring ***_ring_**,**
                                  **struct io_uring_cqe ****_cqe_ptr_**,**
                                  **unsigned** _wait_nr_**,**
                                  **struct __kernel_timespec ***_ts_**,**
                                  **sigset_t ***_sigmask_**);**
    


## DESCRIPTION



           The io_uring_wait_cqes(3) function returns _wait_nr_ IO completions
           from the queue belonging to the _ring_ param, waiting for them if
           necessary or until the timeout _ts_ expires.
    
           The _sigmask_ specifies the set of signals to block. If set, it is
           equivalent to atomically executing the following calls:
    
               sigset_t origmask;
    
               pthread_sigmask(SIG_SETMASK, &sigmask, &origmask);
               ret = io_uring_wait_cqes(ring, cqe, wait_nr, ts, NULL);
               pthread_sigmask(SIG_SETMASK, &origmask, NULL);
    
           The _cqe_ptr_ param is filled in on success with the first CQE.
           Callers of this function should use io_uring_for_each_cqe(3) to
           iterate all available CQEs.
    
           If _ts_ is specified and an older kernel without **IORING_FEAT_EXT_ARG**
           is used, the application does not need to call io_uring_submit(3)
           before calling io_uring_wait_cqes(3).  For newer kernels with that
           feature flag set, there is no implied submit when waiting for a
           request.
    
           If _ts_ is **NULL ,** then this behaves like io_uring_wait_cqe(3) in
           that it will wait forever for an event.
    


## RETURN VALUE



           On success io_uring_wait_cqes(3) returns 0 and the cqe_ptr param
           is filled in. On failure it returns **-errno**.  If a timeout occurs,
           it will return **-ETIME**.
    


* * *
# tapset::ucontext-symbols

## NAME



           tapset::ucontext-symbols - systemtap ucontext-symbols tapset
    


## DESCRIPTION



            User context symbol functions provide additional information
           about
            addresses from an application. These functions can provide
            information about the user space map (library) that the event
           occurred or
            the function symbol of an address.
    
           **ustack** Return address at given depth of user stack backtrace
    
                  See function::ustack(3stap)
                   for details.
    
           **usymname**
                  Return the symbol of an address in the current task.
    
                  See function::usymname(3stap)
                   for details.
    
           **usymdata**
                  Return the symbol and module offset of an address.
    
                  See function::usymdata(3stap)
                   for details.
    
           **print_ustack**
                  Print out stack for the current task from string.
    
                  See function::print_ustack(3stap)
                   for details.
    
           **print_usyms**
                  Print out user stack from string
    
                  See function::print_usyms(3stap)
                   for details.
    
           **sprint_ustack**
                  Return stack for the current task from string.
    
                  See function::sprint_ustack(3stap)
                   for details.
    
           **sprint_usyms**
                  Return stack for user addresses from string
    
                  See function::sprint_usyms(3stap)
                   for details.
    
           **usymfileline**
                  Return the file name and line number of an address.
    
                  See function::usymfileline(3stap)
                   for details.
    
           **usymfile**
                  Return the file name of a given address.
    
                  See function::usymfile(3stap)
                   for details.
    
           **usymline**
                  Return the line number of an address.
    
                  See function::usymline(3stap)
                   for details.
    


* * *
# function::user_long

## NAME



           function::user_long - Retrieves a long value stored in user space
    


## SYNOPSIS



               user_long:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the long from
    


## DESCRIPTION



           Returns the long value from a given user space address. Returns
           zero when user space data is not accessible. Note that the size of
           the long depends on the architecture of the current user space
           task (for those architectures that support both 64/32 bit compat
           tasks).
    


* * *
# gnutls_x509_crt_set_subject_unique_id

## NAME



           gnutls_x509_crt_set_subject_unique_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_subject_unique_id(gnutls_x509_crt_t** _cert_**,**
           **const void ***_id_**, size_t** _id_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * id
                       The unique ID
    
           size_t id_size
                       Holds the size of the unique ID.
    


## DESCRIPTION



           This function will set the X.509 certificate's subject unique ID
           field.
    


## RETURNS



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


## SINCE



           3.4.7
    


* * *
# function::json_add_array

## NAME



           function::json_add_array - Add an array
    


## SYNOPSIS



               json_add_array:long(name:string,description:string)
    


## ARGUMENTS



           _name_
               The name of the array.
    
           _description_
               Array description. An empty string can be used.
    


## DESCRIPTION



           This function adds a array, setting up everything needed. Arrays
           contain other metrics, added with **json_add_array_numeric_metric** or
           **json_add_array_string_metric**.
    


* * *
# pthread_condattr_setpshared

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           pthread_condattr_setpshared — set the process-shared condition
           variable attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_condattr_setpshared(pthread_condattr_t *_attr_ ,
               int _pshared_);
    


## DESCRIPTION



           Refer to pthread_condattr_getpshared(3p).
    


* * *
# posix_trace_attr_getstreamsize

## 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_getstreamsize — retrieve and set trace stream
           size attributes (**TRACING**)
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to posix_trace_attr_getlogsize(3p).
    


* * *
# srand

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



           srand — pseudo-random number generator
    


## SYNOPSIS



           #include <stdlib.h>
    
           void srand(unsigned _seed_);
    


## DESCRIPTION



           Refer to rand(3p).
    


* * *