tripathysagar/man_text huggingface dataset:
# wctomb

## NAME



           wctomb - convert a wide character to a multibyte sequence
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int wctomb(char ***_s_**, wchar_t** _wc_**);**
    


## DESCRIPTION



           If _s_ is not NULL, the **wctomb**() function converts the wide
           character _wc_ to its multibyte representation and stores it at the
           beginning of the character array pointed to by _s_.  It updates the
           shift state, which is stored in a static anonymous variable known
           only to the **wctomb**() function, and returns the length of said
           multibyte representation, that is, the number of bytes written at
           _s_.
    
           At most **MB_CUR_MAX** bytes will be written at _s_.  The programmer
           must ensure that there is enough room to store the multibyte
           sequence at _s_.
    
           If _s_ is NULL, the **wctomb**() function resets the shift state, known
           only to this function, to the initial state, and returns nonzero
           if the encoding has nontrivial shift state, or zero if the
           encoding is stateless.
    


## RETURN VALUE



           If _s_ is not NULL, the **wctomb**() function returns the number of
           bytes that have been written to the byte array at _s_.  If _wc_ can
           not be represented as a multibyte sequence (according to the
           current locale), -1 is returned.
    
           If _s_ is NULL, the **wctomb**() function returns nonzero if the
           encoding has nontrivial shift state, or zero if the encoding is
           stateless.
    


## ATTRIBUTES



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


## VERSIONS



           The function wcrtomb(3) provides a better interface to the same
           functionality.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



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


* * *
# ccos

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



           ccos, ccosf, ccosl — complex cosine functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex ccos(double complex _z_);
           float complex ccosf(float complex _z_);
           long double complex ccosl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the complex cosine of _z_.
    


## RETURN VALUE



           These functions shall return the complex cosine value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# clock

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



           clock — report CPU time used
    


## SYNOPSIS



           #include <time.h>
    
           clock_t clock(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 _clock_() function shall return the implementation's best
           approximation to the processor time used by the process since the
           beginning of an implementation-defined era related only to the
           process invocation.
    


## RETURN VALUE



           To determine the time in seconds, the value returned by _clock_()
           should be divided by the value of the macro CLOCKS_PER_SEC.
           CLOCKS_PER_SEC is defined to be one million in _< time.h>_.  If the
           processor time used is not available or its value cannot be
           represented, the function shall return the value (**clock_t**)-1.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           In programming environments where **clock_t** is a 32-bit integer type
           and CLOCKS_PER_SEC is one million, _clock_() will start failing in
           less than 36 minutes of processor time for signed **clock_t** , or 72
           minutes for unsigned **clock_t**.  Applications intended to be
           portable to such environments should use _times_() instead (or
           _clock_gettime_() with CLOCK_PROCESS_CPUTIME_ID, if supported).
    
           In order to measure the time spent in a program, _clock_() should be
           called at the start of the program and its return value subtracted
           from the value returned by subsequent calls. The value returned by
           _clock_() is defined for compatibility across systems that have
           clocks with different resolutions. The resolution on any
           particular system need not be to microsecond accuracy.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# __pmconverttime

## NAME



           **__pmtimevalConvert** , **__pmtimespecConvert** - convert **tm** structure
           into seconds
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmtimevalConvert(struct tm ***_tmin_**, struct timeval ***_origin_**,**
                                  **struct timeval ***_rslt_**);**
           **int __pmtimespecConvert(struct tm ***_tmin_**, struct timespec ***_origin_**,**
                                   **struct timespec ***_rslt_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           **__pmtimevalConvert** and **__pmtimespecConvert** accept a  **tm** structure
           that  has been filled in by __pmParseCtime(3) and a reference time
           point **origin** , and fills in the given **rslt** structure with the  time
           the user meant when specifying a partial **ctime** or positive or neg‐
           ative time **interval**.
    
           Typically,  the argument **origin** is the start time for a set of PCP
           archives, unless the user specified a negative **interval** offset, in
           which case it is the end time of the archive.
    
           **__pmtimevalConvert** and **__pmtimespecConvert** return 0 if successful.
           They return -1 and write an error message to **stderr** , if  an  error
           is detected.
    
           Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish
           a new current timezone that will effect **__pmtimevalConvert**.
    


* * *
# legacy_coding

## NAME



           **use_legacy_coding** - override locale-encoding checks
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int use_legacy_coding(int** _level_**);**
    


## DESCRIPTION



           The **use_legacy_coding** function is an extension to the curses
           library.  It allows the caller to change the result of **unctrl** , and
           suppress related checks within the library that would normally
           cause nonprinting characters to be rendered in visible form.  This
           affects only 8-bit characters.
    
           The _level_ parameter controls the result:
    
                  0    the library functions normally, rendering nonprinting
                       characters as described in **unctrl**.
    
                  1    the library ignores **isprintf** for codes in the range
                       160-255.
    
                  2    the library ignores **isprintf** for codes in the range
                       128-255.  It also modifies the output of **unctrl** ,
                       showing codes in the range 128-159 as is.
    


## RETURN VALUE



           If the screen has not been initialized, or the _level_ parameter is
           out of range, the function returns **ERR**.  Otherwise, it returns the
           previous level: **0** , **1** or **2**.
    


## PORTABILITY



           This routine is specific to ncurses.  It was not supported on
           Version 7, BSD or System V implementations.  It is recommended
           that any code depending on ncurses extensions be conditioned using
           NCURSES_VERSION.
    


* * *
# io_uring_prep_readv

## NAME



           io_uring_prep_readv - prepare vector I/O read request
    


## SYNOPSIS



           **#include <sys/uio.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_readv(struct io_uring_sqe ***_sqe_**,**
                                    **int** _fd_**,**
                                    **const struct iovec ***_iovecs_**,**
                                    **unsigned** _nr_vecs_**,**
                                    **__u64** _offset_**);**
    


## DESCRIPTION



           The io_uring_prep_readv(3) prepares a vectored IO read request.
           The submission queue entry _sqe_ is setup to use the file descriptor
           _fd_ to start reading _nr_vecs_ into the _iovecs_ array at the specified
           _offset_.
    
           On files that support seeking, if the offset is set to **-1** , the
           read operation commences at the file offset, and the file offset
           is incremented by the number of bytes read. See read(2) for more
           details. Note that for an async API, reading and updating the
           current file offset may result in unpredictable behavior, unless
           access to the file is serialized. It is not encouraged to use this
           feature, if it's possible to provide the desired IO offset from
           the application or library.
    
           On files that are not capable of seeking, the offset must be 0 or
           -1.
    
           After the read has been prepared it can be submitted with one of
           the submit functions.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



           Unless an application explicitly needs to pass in more than one
           iovec, it is more efficient to use io_uring_prep_read(3) rather
           than this function, as no state has to be maintained for a non-
           vectored IO request.  As with any request that passes in data in a
           struct, that data must remain valid until the request has been
           successfully submitted. It need not remain valid until completion.
           Once a request has been submitted, the in-kernel state is stable.
           Very early kernels (5.4 and earlier) required state to be stable
           until the completion occurred. Applications can test for this
           behavior by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed
           back from io_uring_queue_init_params(3).
    


* * *
# cacos

## NAME



           cacos, cacosf, cacosl - complex arc cosine
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cacos(double complex** _z_**);**
           **float complex cacosf(float complex** _z_**);**
           **long double complex cacosl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex arc cosine of _z_.  If
           _y = cacos(z)_ , then _z = ccos(y)_.  The real part of _y_ is chosen in
           the interval [0,pi].
    
           One has:
    
               cacos(z) = -i * clog(z + i * csqrt(1 - z * z))
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## EXAMPLES



           /* Link with "-lm" */
    
           #include <complex.h>
           #include <stdio.h>
           #include <stdlib.h>
           #include <unistd.h>
    
           int
           main(int argc, char *argv[])
           {
               double complex z, c, f;
               double complex i = I;
    
               if (argc != 3) {
                   fprintf(stderr, "Usage: %s <real> <imag>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }
    
               z = atof(argv[1]) + atof(argv[2]) * I;
    
               c = cacos(z);
    
               printf("cacos() = %6.3f %6.3f*i\n", creal(c), cimag(c));
    
               f = -i * clog(z + i * csqrt(1 - z * z));
    
               printf("formula = %6.3f %6.3f*i\n", creal(f), cimag(f));
    
               exit(EXIT_SUCCESS);
           }
    


* * *
# semanage_del

## NAME



           semanage_del - SELinux Management API
    


## SYNOPSIS



           The following delete function is supported for any semanage
           record.
           Replace the function and object name as necessary.
    
           **extern int DELETE_FUNCTION (**
                **semanage_handle_t ***_handle_**,**
                **const semanage_OBJECT_key_t ***_key_**);**
    


## DESCRIPTION



           **Behavior:**
                  The delete function will remove the object corresponding to
                  the provided key from the local store. If no match is
                  found, no action is taken. Changes will become permanent
                  when **semanage_commit**(3) is invoked. Additional checks may
                  be performed at that time to ensure the system is left in a
                  valid state.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The _key_ identifies
                  the _data_ object, which will be deleted from the local
                  store. The key is a property of the caller, and will not be
                  stored or modified internally.
    
           **Requirements:**
                  This function requires an semanage connection to be
                  established (see **semanage_connect**(3) ), and must be
                  executed in a transaction (see
                  **semanage_begin_transaction**(3) ).
    


## RETURN VALUE



           In case of failure, -1 is returned, and the semanage error
           callback is invoked, describing the error.  Otherwise 0 is
           returned.
    


* * *
# pmhttpnewclient

## NAME



           **pmhttpNewClient** , **pmhttpFreeClient** , **pmhttpClientFetch** - simple HTTP
           client interfaces
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmhttp.h>**
    
           **struct http_client *pmhttpNewClient(void);**
           **void pmhttpFreeClient(struct http_client ***_client_**);**
           **int pmhttpClientFetch(struct http_client ***_client_**, const char ***_url_**,**
                                 **char ***_bodybuf_**, size_t** _bodylen_**,**
                                 **char ***_typebuf_**, size_t** _typelen_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           **pmhttpNewClient** allocates  and  initializes an opaque HTTP client
           that is ready to make requests from a server.
    
           The URL request interface **pmhttpClientFetch** issues an HTTP GET re‐
           quest to the server specified in the supplied _url_.   The  body  of
           the response is returned in the caller supplied _bodybuf_ buffer, of
           _bodylen_  bytes  length.   An  optional  _typebuf_ buffer, of _typelen_
           bytes length, can also be supplied and (if non-NULL) will  contain
           the value of the content-type header returned from the server.
    
           The  _url_  parameter is an _RFC1630_ format URL.  This will typically
           be prefixed with "http://", however these interfaces also  support
           Unix  domain  sockets.   Those  are instead prefixed by "unix://",
           followed by the full filesystem path to the  desired  Unix  domain
           socket.
    
           To  free  up  resources  associated with an HTTP client, including
           closing any persistent server connection that has been established
           earlier, is accomplished using the **pmhttpFreeClient** routine.
    


## DIAGNOSTICS



           **pmhttpNewClient** will return NULL on failure, which can only  occur
           when allocation of memory is not possible.
    
           **pmhttpClientFetch** will return the number of bytes places into the
           _bodybuf_ buffer, else a negated error code indicating the nature of
           the failure.
    


* * *
# iswdigit

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



           iswdigit, iswdigit_l — test for a decimal digit wide-character
           code
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           The _iswdigit_() and _iswdigit_l_() functions shall return non-zero if
           _wc_ is a decimal digit wide-character code; otherwise, they shall
           return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# sd_bus_interface_name_is_valid

## NAME



           sd_bus_interface_name_is_valid, sd_bus_service_name_is_valid,
           sd_bus_member_name_is_valid, sd_bus_object_path_is_valid - Check
           if a string is a valid bus name or object path
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_interface_name_is_valid(const char***_p_**);**
    
           **int sd_bus_service_name_is_valid(const char***_p_**);**
    
           **int sd_bus_member_name_is_valid(const char***_p_**);**
    
           **int sd_bus_object_path_is_valid(const char***_p_**);**
    


## DESCRIPTION



           **sd_bus_interface_name_is_valid()** checks if a given string _p_ is a
           syntactically valid bus interface name. Similarly,
           **sd_bus_service_name_is_valid()** checks if the argument is a valid
           bus service name, **sd_bus_member_name_is_valid()** checks if the
           argument is a valid bus interface member name, and
           **sd_bus_object_path_is_valid()** checks if the argument is a valid
           bus object path. Those functions generally check that only allowed
           characters are used and that the length of the string is within
           limits.
    


## RETURN VALUE



           Those functions return 1 if the argument is a valid interface /
           service / member name or object path, and 0 if it is not. If the
           argument is **NULL** , an error is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _p_ parameter is **NULL**.
    


## NOTES



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


* * *
# curs_addchstr

## NAME



           **addchstr** , **addchnstr** , **waddchstr** , **waddchnstr** , **mvaddchstr** ,
           **mvaddchnstr** , **mvwaddchstr** , **mvwaddchnstr** - add a string of
           characters (and attributes) to a **curses** window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int addchstr(const chtype ***_chstr_**);**
           **int addchnstr(const chtype ***_chstr_**, int** _n_**);**
           **int waddchstr(WINDOW ***_win_**, const chtype ***_chstr_**);**
           **int waddchnstr(WINDOW ***_win_**, const chtype ***_chstr_**, int** _n_**);**
    
           **int mvaddchstr(int** _y_**, int** _x_**, const chtype ***_chstr_**);**
           **int mvaddchnstr(int** _y_**, int** _x_**, const chtype ***_chstr_**, int** _n_**);**
           **int mvwaddchstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const chtype ***_chstr_**);**
           **int mvwaddchnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const chtype ***_chstr_**, int** _n_**);**
    


## DESCRIPTION



           These  functions  copy  the (null-terminated) _chstr_ array into the
           window image structure starting at the  current  cursor  position.
           The four functions with _n_ as the last argument copy at most _n_ ele‐
           ments,  but  no  more than will fit on the line.  If **n** =**-1** then the
           whole array is copied, to the maximum number  of  characters  that
           will fit on the line.
    
           The  window  cursor  is _not_ advanced.  These functions work faster
           than **waddnstr**.  On the other hand:
    
           •   they do not perform checking (such as for the newline, back‐
               space, or carriage return characters),
    
           •   they do not advance the current cursor position,
    
           •   they do not expand other control characters to ^-escapes, and
    
           •   they truncate the string if it crosses the right margin,
               rather than wrapping it around to the new line.
    


## RETURN VALUE



           All functions return the integer **ERR** upon failure and **OK** on suc‐
           cess.
    
           X/Open does not define any error conditions.  This implementation
           returns 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.
    


## NOTES



           All functions except **waddchnstr** may be macros.
    


## PORTABILITY



           These entry points are described in the XSI Curses standard, Issue
           4.
    


* * *
# getusershell

## NAME



           getusershell, setusershell, endusershell - get permitted user
           shells
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <unistd.h>**
    
           **char *getusershell(void);**
           **void setusershell(void);**
           **void endusershell(void);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **getusershell**(), **setusershell**(), **endusershell**():
               Since glibc 2.21:
                   _DEFAULT_SOURCE
               In glibc 2.19 and 2.20:
                   _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
               Up to and including glibc 2.19:
                   _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    


## DESCRIPTION



           The **getusershell**() function returns the next line from the file
           _/etc/shells_ , opening the file if necessary.  The line should
           contain the pathname of a valid user shell.  If _/etc/shells_ does
           not exist or is unreadable, **getusershell**() behaves as if _/bin/sh_
           and _/bin/csh_ were listed in the file.
    
           The **setusershell**() function rewinds _/etc/shells_.
    
           The **endusershell**() function closes _/etc/shells_.
    


## RETURN VALUE



           The **getusershell**() function returns NULL on end-of-file.
    


## FILES



           _/etc/shells_
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# gnutls_x509_crl_get_extension_data2

## NAME



           gnutls_x509_crl_get_extension_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_extension_data2(gnutls_x509_crl_t** _crl_**,**
           **unsigned** _indx_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           unsigned indx
                       Specifies which extension OID to read. Use (0) to get
                       the first one.
    
           gnutls_datum_t * data
                       will contain the extension DER-encoded data
    


## DESCRIPTION



           This function will return the requested by the index extension
           data in the certificate revocation list.  The extension data will
           be allocated using **gnutls_malloc()**.
    
           Use **gnutls_x509_crt_get_extension_info()** to extract the OID.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# curs_scr_dump

## NAME



           **scr_dump** , **scr_restore** , **scr_init** , **scr_set** - read (write) a **curses**
           screen from (to) a file
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int scr_dump(const char ***_filename_**);**
           **int scr_restore(const char ***_filename_**);**
           **int scr_init(const char ***_filename_**);**
           **int scr_set(const char ***_filename_**);**
    


## DESCRIPTION



       **scr_dump**
           The  **scr_dump** routine  dumps  the current contents of the _virtual_
           _screen_ to the file _filename_.
    
       **scr_restore**
           The **scr_restore** routine sets the _virtual screen_ to the contents of
           _filename_ , which must have been written using **scr_dump**.   The  next
           call to **doupdate** restores the _physical screen_ to the way it looked
           in the dump file.
    
       **scr_init**
           The  **scr_init** routine  reads in the contents of _filename_ and uses
           them to initialize the **curses** data structures about what the  ter‐
           minal  currently  has on its screen.  If the data is determined to
           be valid, **curses** bases its next update of the screen on  this  in‐
           formation  rather  than  clearing  the  screen  and  starting from
           scratch.  **scr_init** is used after **initscr**(3X) or a  system(3)  call
           to share the screen with another process which has done a **scr_dump**
           after its **endwin**(3X) call.  The data is declared invalid
    
           •   if the terminfo capabilities **rmcup** and **nrrmc** exist, also
    
           •   if the terminal has been written to since the preceding
               **scr_dump** call.
    
       **scr_set**
           The **scr_set** routine is a combination of **scr_restore** and **scr_init**.
           It tells the program that the information in _filename_ is what is
           currently on the screen, and also what the program wants on the
           screen.  This can be thought of as a screen inheritance function.
    
           To read (write) a window from (to) a file, use the **getwin** and
           **putwin** routines [see **curs_util**(3X)].
    


## RETURN VALUE



           All routines return the integer **ERR** upon failure and **OK** upon suc‐
           cess.
    
           X/Open defines no error conditions.  In this implementation, each
           will return an error if the file cannot be opened.
    


## NOTES



           Note that **scr_init** , **scr_set** , and **scr_restore** may be macros.
    


## PORTABILITY



           The XSI Curses standard, Issue 4, describes these functions
           (adding the const qualifiers).
    
           The SVr4 docs merely say under **scr_init** that the dump data is also
           considered invalid "if the time-stamp of the tty is old" but do
           not define “old”.
    


* * *
# function::user_int

## NAME



           function::user_int - Retrieves an int value stored in user space
    


## SYNOPSIS



               user_int:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the int from
    


## DESCRIPTION



           Returns the int value from a given user space address. Returns
           zero when user space data is not accessible.
    


* * *
# menu_attributes

## NAME



           **menu_back** , **menu_fore** , **menu_grey** , **menu_pad** , **set_menu_back** ,
           **set_menu_fore** , **set_menu_grey** , **set_menu_pad** - color and attribute
           control for menus
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_fore(MENU ***_menu_**, chtype** _attr_**);**
           **chtype menu_fore(const MENU ***_menu_**);**
    
           **int set_menu_back(MENU ***_menu_**, chtype** _attr_**);**
           **chtype menu_back(const MENU ***_menu_**);**
    
           **int set_menu_grey(MENU ***_menu_**, chtype** _attr_**);**
           **chtype menu_grey(const MENU ***_menu_**);**
    
           **int set_menu_pad(MENU ***_menu_**, int** _pad_**);**
           **int menu_pad(const MENU ***_menu_**);**
    


## DESCRIPTION



           The function **set_menu_fore** sets the foreground attribute of _menu_.
           This is the highlight used for selected menu items.  **menu_fore**
           returns the foreground attribute.  The default is **A_REVERSE**.
    
           The function **set_menu_back** sets the background attribute of _menu_.
           This is the highlight used for selectable (but not currently
           selected) menu items.  The function **menu_back** returns the
           background attribute.  The default is **A_NORMAL**.
    
           The function **set_menu_grey** sets the grey attribute of _menu_. This
           is the highlight used for un-selectable menu items in menus that
           permit more than one selection.  The function **menu_grey** returns
           the grey attribute.  The default is **A_UNDERLINE**.
    
           The function **set_menu_pad** sets the character used to fill the
           space between the name and description parts of a menu item.
           **menu_pad** returns the given menu's pad character.  The default is a
           blank.
    


## RETURN VALUE



           These routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    


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


* * *
# gnutls_cipher_decrypt2

## NAME



           gnutls_cipher_decrypt2 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_decrypt2(gnutls_cipher_hd_t** _handle_**, const void ***
           _ctext_**, size_t** _ctext_len_**, void ***_ptext_**, size_t** _ptext_len_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           const void * ctext
                       the data to decrypt
    
           size_t ctext_len
                       the length of data to decrypt
    
           void * ptext
                       the decrypted data
    
           size_t ptext_len
                       the available length for decrypted data
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           specified by the context. For block ciphers the  _ctext_len_ must be
           a multiple of the block size. For the supported ciphers the
           plaintext data length will equal the ciphertext size.
    
           Note that in AEAD ciphers, this will not check the tag. You will
           need to compare the tag sent with the value returned from
           **gnutls_cipher_tag()**.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# gnutls_pkcs11_obj_list_import_url4

## NAME



           gnutls_pkcs11_obj_list_import_url4 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_list_import_url4(gnutls_pkcs11_obj_t ****
           _p_list_**, unsigned int ***_n_list_**, const char ***_url_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t ** p_list
                       An uninitialized object list (may be NULL)
    
           unsigned int * n_list
                       It will contain the size of the list.
    
           const char * url
                       A PKCS 11 url identifying a set of objects
    
           unsigned int flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will enumerate all the objects specified by the
           PKCS**11** URL provided. It will initialize and set values to the
           object pointer list ( _p_list_ ) provided. To obtain a list of all
           available objects use a  _url_ of 'pkcs11:'.
    
           All returned objects must be deinitialized using
           **gnutls_pkcs11_obj_deinit()** , and  _p_list_ must be deinitialized
           using **gnutls_free()**.
    
           The supported in this function  _flags_ are
           **GNUTLS_PKCS11_OBJ_FLAG_LOGIN** , **GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO** ,
           **GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE** ,
           **GNUTLS_PKCS11_OBJ_FLAG_CRT** , **GNUTLS_PKCS11_OBJ_FLAG_PUBKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_CA** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED** , and since 3.5.1 the
           **GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT**.
    
           On versions of GnuTLS prior to 3.4.0 the equivalent function was
           **gnutls_pkcs11_obj_list_import_url2()**. That is also available on
           this version as a macro which maps to this function.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# setfilecon

## NAME



           setfilecon, fsetfilecon, lsetfilecon - set SELinux security
           context of a file
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int setfilecon(const char ***_path_**, const char ***_con_**);**
    
           **int setfilecon_raw(const char ***_path_**, const char ***_con_**);**
    
           **int lsetfilecon(const char ***_path_**, const char ***_con_**);**
    
           **int lsetfilecon_raw(const char ***_path_**, const char ***_con_**);**
    
           **int fsetfilecon(int** _fd_**, const char ***_con_**);**
    
           **int fsetfilecon_raw(int** _fd_**, const char ***_con_**);**
    


## DESCRIPTION



           **setfilecon**() sets the security context of the file system object.
    
           **lsetfilecon**() is identical to setfilecon, except in the case of a
           symbolic link, where the link itself has it's context set, not the
           file that it refers to.
    
           **fsetfilecon**() is identical to setfilecon, only the open file
           pointed to by filedes (as returned by open(2)) has it's context
           set in place of path.  Since libselinux 3.4 a file opened via
           _O_PATH_ is supported.
    
           **setfilecon_raw**(), **lsetfilecon_raw**(), and **fsetfilecon_raw**() behave
           identically to their non-raw counterparts but do not perform
           context translation.
    


## RETURN VALUE



           On success, zero is returned. On failure, -1 is returned and _errno_
           is set appropriately.
    


## ERRORS



           If there is insufficient space remaining to store the extended
           attribute, _errno_ is set to either **ENOSPC** , or **EDQUOT** if quota
           enforcement was the cause.
    
           If extended attributes are not supported by the filesystem, or are
           disabled, _errno_ is set to **ENOTSUP**.
    
           The errors documented for the stat(2) system call are also
           applicable here.
    


* * *
# tapset::task_ancestry

## NAME



           tapset::task_ancestry - systemtap task_ancestry tapset
    


## DESCRIPTION



           **task_ancestry**
                  The ancestry of the given task
    
                  See function::task_ancestry(3stap)
                   for details.
    


* * *
# semanage_query

## NAME



           semanage_query - SELinux Management API
    


## SYNOPSIS



           The following query function is supported for any semanage record.
           Replace the function and object name as necessary.
    
           **extern int QUERY_FUNCTION (**
                **semanage_handle_t ***_handle_**,**
                **const semanage_OBJECT_key_t ***_key_**,**
                **semanage_OBJECT_t ****_response_**);**
    


## DESCRIPTION



           **Behavior:**
                  The query function will fail if a matching key is not
                  found. Otherwise, the corresponding object is returned.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The _key_ identifies
                  the object being queried, which will be stored in the
                  address pointed by _response_ The key is a property of the
                  caller, and will not be stored or modified internally. The
                  object returned becomes a property of the caller, and must
                  be freed with **semanage_OBJECT_free.**
    
           **Requirements:**
                  This function requires an semanage connection to be
                  established (see **semanage_connect**(3) )
    


## RETURN VALUE



           In case of failure, -1 is returned, and the semanage error
           callback is invoked, describing the error.  Otherwise a non-
           negative integer is returned (a commit number). The same number
           will be returned by all other semanage object read calls until the
           next commit.
    


* * *
# io_uring_submit_and_wait_reg

## NAME



           io_uring_submit_and_wait_reg - Sets up and registers fixed wait
           regions
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_submit_and_wait_reg(struct io_uring ***_ring_**,**
                                            **struct io_uring_cqe ****_cqe_ptr_**,**
                                            **unsigned** _wait_nr_**,**
                                            **int** _reg_index_**);**
    


## DESCRIPTION



           The io_uring_submit_and_wait_reg(3) submits previously prepared
           requests in the ring _ring_ and waits for _wait_nr_ completions using
           the registered wait index of _reg_index_.  Upon successful return,
           the completion events are stored in the _cqe_ptr_ array.
    
           This function works like io_uring_submit_and_wait_min_timeout(3)
           in that it supports all the features of that helper, but rather
           than pass in all the information in a struct that needs copying,
           it references a registered wait index for which previously
           registered wait region holds information about how the wait should
           be performed. That includes information such as the overall
           timeout, the minimum timeout to be used, and so forth. See
           io_uring_setup_reg_wait(3) for the details on registered wait
           regions.
    
           Using registered wait regions has less overhead then other wait
           methods, as no copying of data is needed.
    
           It's valid to use this function purely for waiting on events, even
           if no new requests should be submitted.
    


## RETURN VALUE



           On success io_uring_submit_and_wait_reg(3) returns the number of
           new requests submitted. On failure it returns **-errno**.  If the
           kernel doesn't support this functionality, **-EINVAL** will be
           returned. If no events are submitted and the wait operation times
           out, then **-ETIME** will be returned.
    


* * *
# libpfm_intel_skx_unc_m3upi

## NAME



           libpfm_intel_skx_unc_m3upi - support for Intel Skylake X Server
           M3UPI uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_m3upi[0-2]**
           **PMU desc: Intel Skylake X server M3UPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X server M3UPI uncore PMU.
    


## MODIFIERS



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


* * *
# gnutls_pkcs11_obj_init

## NAME



           gnutls_pkcs11_obj_init - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_init(gnutls_pkcs11_obj_t ***_obj_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t * obj
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a pkcs11 certificate structure.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *