tripathysagar/man_text huggingface dataset:
# tep_parse_header_page

## NAME



           tep_parse_header_page - Parses the data stored in the header page.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           int **tep_parse_header_page**(struct tep_handle *_tep_ , char *_buf_ , unsigned long _size_ , int _long_size_);
    


## DESCRIPTION



           The **tep_parse_header_page()** function parses the header page data
           from _buf_ , and initializes the _tep_ , trace event parser context,
           with it. The buffer _buf_ is with _size_ , and is supposed to be copied
           from tracefs/events/header_page.
    
           Some old kernels do not have header page info, in this case the
           **tep_parse_header_page()** function can be called with _size_ equal to
           0. The _tep_ context is initialized with default values. The
           _long_size_ can be used in this use case, to set the size of a long
           integer to be used.
    


## RETURN VALUE



           The **tep_parse_header_page()** function returns 0 in case of success,
           or -1 in case of an error.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               char *buf;
               int size;
               buf = read_file("/sys/kernel/tracing/events/header_page", &size);
               if (tep_parse_header_page(tep, buf, size, sizeof(unsigned long)) != 0) {
                       /* Failed to parse the header page */
               }
               ...
    


## FILES



               **event-parse.h**
                       Header file to include in order to have access to the library APIs.
               **-ltraceevent**
                       Linker switch to add when building a program that uses the library.
    


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



           **https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ **
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    
            2. tz.stoyanov@gmail.com
               mailto:tz.stoyanov@gmail.com
    
            3. linux-trace-devel@vger.kernel.org
               mailto:linux-trace-devel@vger.kernel.org
    


* * *
# semanage_count

## NAME



           semanage_count - SELinux Management API
    


## SYNOPSIS



           The following count function is supported for any semanage record.
           Replace the function and object name as necessary.
    
           **extern int COUNT_FUNCTION (**
                **semanage_handle_t ***_handle_**,**
                **unsigned int***_response_**);**
    


## DESCRIPTION



           **Behavior:**
                  The count function will return the number of all objects in
                  the selected location.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The number of
                  objects will be stored at the location pointed by _response._
    
           **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.
    


* * *
# probe::linuxmib.TCPMemoryPressures

## NAME



           probe::linuxmib.TCPMemoryPressures - Count of times memory
           pressure was used
    


## SYNOPSIS



           linuxmib.TCPMemoryPressures
    


## VALUES



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


## DESCRIPTION



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


* * *
# gnutls_dh_get_peers_public_bits

## NAME



           gnutls_dh_get_peers_public_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_get_peers_public_bits(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           Get the Diffie-Hellman public key bit size.  Can be used for both
           anonymous and ephemeral Diffie-Hellman.
    


## RETURNS



           The public key bit size used in the last Diffie-Hellman key
           exchange with the peer, or a negative error code in case of error.
    


* * *
# fdim

## NAME



           fdim, fdimf, fdiml - positive difference
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double fdim(double** _x_**, double** _y_**);**
           **float fdimf(float** _x_**, float** _y_**);**
           **long double fdiml(long double** _x_**, long double** _y_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fdimf**(), **fdiml**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions return the positive difference, _max(x-y,0)_ ,
           between their arguments.
    


## RETURN VALUE



           On success, these functions return the positive difference.
    
           If _x_ or _y_ is a NaN, a NaN is returned.
    
           If the result overflows, a range error occurs, and the functions
           return **HUGE_VAL** , **HUGE_VALF** , or **HUGE_VALL** , respectively.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Range error: result overflow
                  _errno_ is set to **ERANGE**.  An overflow floating-point
                  exception (**FE_OVERFLOW**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           Before glibc 2.24 on certain architectures (e.g., x86, but not
           x86_64) these functions did not set _errno_.
    


* * *
# avc_context_to_sid

## NAME



           avc_context_to_sid, avc_sid_to_context, avc_get_initial_sid -
           obtain and manipulate SELinux security ID's
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/avc.h>**
    
           **int avc_context_to_sid(const char ***_ctx_**, security_id_t ***_sid_**);**
    
           **int avc_sid_to_context(security_id_t** _sid_**, char ****_ctx_**);**
    
           **int avc_get_initial_sid(const char ***_name_**, security_id_t ***_sid_**);**
    


## DESCRIPTION



           Security ID's (SID's) are opaque representations of security
           contexts, managed by the userspace AVC.
    
           **avc_context_to_sid**() returns a SID for the given _context_ in the
           memory referenced by _sid_.
    
           **avc_sid_to_context**() returns a copy of the context represented by
           _sid_ in the memory referenced by _ctx_.  The user must free the copy
           with freecon(3).
    
           **avc_get_initial_sid**() returns a SID for the kernel initial
           security identifier specified by _name_.
    


## RETURN VALUE



           **avc_context_to_sid**() and **avc_sid_to_context**() return zero on
           success.  On error, -1 is returned and _errno_ is set appropriately.
    


## ERRORS



           **ENOMEM** An attempt to allocate memory failed.
    


## NOTES



           As of libselinux version 2.0.86, SID's are no longer reference
           counted.  A SID will be valid from the time it is first obtained
           until the next call to avc_destroy(3).  The sidget(3) and
           sidput(3) functions, formerly used to adjust the reference count,
           are no-ops and are deprecated.
    


* * *
# pcre2_code_free

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **void pcre2_code_free(pcre2_code ***_code_**);**
    


## DESCRIPTION



    
           If _code_ is NULL, this function does nothing. Otherwise, _code_ must
           point to a compiled pattern. This function frees its memory,
           including any memory used by the JIT compiler. If the compiled
           pattern was created by a call to **pcre2_code_copy_with_tables()** ,
           the memory for the character tables is also freed.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# pmdaeventclient

## NAME



           **pmdaEventNewClient** , **pmdaEventEndClient** , **pmdaEventClients** - client
           context tracking interfaces for event queues
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaEventNewClient(int** _context_**);**
           **int pmdaEventEndClient(int** _context_**);**
           **int pmdaEventClients(pmAtomValue ***_avp_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           A  Performance  Metrics  Domain  Agent  (PMDA)  that exports event
           records needs to track which clients are connected to it, in order
           that it can track which events have been sent to which clients  so
           far.   Only  once  an  event has been sent to all monitoring tools
           that registered an interest can the event  be  discarded  and  any
           memory reclaimed.
    
           The PMDA(3) library provides callback routines for PMDA developers
           to  provide  custom  handling of client connections and disconnec‐
           tions.  If the PMDA is making use of the event  queuing  mechanism
           provided  by  pmdaEventNewQueue(3) and friends, client connections
           and disconnections must be tracked via calls to **pmdaEventNewClient**
           and **pmdaEventEndClient** respectively.  This allows the  library  to
           keep track of when events can be discarded from a queue, for exam‐
           ple, for the _context_ specified.  This parameter is passed into the
           e_endCallBack  function directly, and for other callback functions
           is available via the e_context field  of  the  pmdaExt  structure.
           Additionally,    it   can   be   queried   at   any   time   using
           pmdaGetContext(3).
    
           Sometimes it is useful for the PMDA to export a metric  indicating
           the  current  count  of attached clients - this is available using
           the **pmdaEventClients** routine, which will fill in the  _avp_  pmAtom‐
           Value structure on behalf of a PMDA fetch callback routine.
    


* * *
# pmsetprocessidentity

## NAME



           **pmSetProcessIdentity** - set process user and group id
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmSetProcessIdentity(const char ***_username_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmSetProcessIdentity** provides a platform-independent method to set
           the user id of a process to that matching _username_.
    
           If possible (when the caller is already running as root) **pmSetPro‐**
           **cessIdentity** will  set the group id of the process to that of the
           matching user, e.g. using _username_ and getpwnam(3).
    
           A return value of 0 indicates success, otherwise the return  value
           is an error code that may be decoded with pmErrStr(3).
    
           **pmSetProcessIdentity** is  most  often  used  in  conjunction  with
           pmGetUsername(3) at process start up.
    


* * *
# curs_inchstr

## NAME



           **inchstr** , **inchnstr** , **winchstr** , **winchnstr** , **mvinchstr** , **mvinchnstr** ,
           **mvwinchstr** , **mvwinchnstr** - get a string of characters (and
           attributes) from a **curses** window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int inchstr(chtype ***_chstr_**);**
           **int inchnstr(chtype ***_chstr_**, int** _n_**);**
           **int winchstr(WINDOW ***_win_**, chtype ***_chstr_**);**
           **int winchnstr(WINDOW ***_win_**, chtype ***_chstr_**, int** _n_**);**
    
           **int mvinchstr(int** _y_**, int** _x_**, chtype ***_chstr_**);**
           **int mvinchnstr(int** _y_**, int** _x_**, chtype ***_chstr_**, int** _n_**);**
           **int mvwinchstr(WINDOW ***_win_**, int** _y_**, int** _x_**, chtype ***_chstr_**);**
           **int mvwinchnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, chtype ***_chstr_**, int** _n_**);**
    


## DESCRIPTION



           These  routines  return  a NULL-terminated array of **chtype** quanti‐
           ties, starting at the current cursor position in the named  window
           and  ending at the right margin of the window.  The four functions
           with _n_ as the last argument, return a leading substring at most  _n_
           characters  long (exclusive of the trailing (chtype)0).  Constants
           defined in **< curses.h> **can be used with the **& **(logical AND)  opera‐
           tor to extract the character or the attribute alone from any posi‐
           tion in the _chstr_ [see **curs_inch**(3X)].
    


## RETURN VALUE



           All  routines  return  the integer **ERR** upon failure and an integer
           value other than **ERR** upon successful  completion  (the  number  of
           characters retrieved, exclusive of the trailing 0).
    
           X/Open  Curses  defines  no error conditions.  In this implementa‐
           tion:
    
           •   If the _win_ parameter is null, an error is returned,
    
           •   If the _chstr_ parameter is null, an error is returned,
    
           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



           Note that all routines except **winchnstr** may be macros.  SVr4 does
           not document whether the result string is zero-terminated; it does
           not document whether a length limit argument includes any trailing
           0; and it does not document the meaning of the return value.
    


## PORTABILITY



           These functions are described in the XSI Curses standard, Issue 4.
           It is no more specific than the SVr4 documentation on the trailing
           0.  It does specify that the successful return of the functions is
           **OK**.
    


* * *
# cacosh

## NAME



           cacosh, cacoshf, cacoshl - complex arc hyperbolic cosine
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex cacosh(double complex** _z_**);**
           **float complex cacoshf(float complex** _z_**);**
           **long double complex cacoshl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex arc hyperbolic cosine of _z_.
           If _y = cacosh(z)_ , then _z = ccosh(y)_.  The imaginary part of _y_ is
           chosen in the interval [-pi,pi].  The real part of _y_ is chosen
           nonnegative.
    
           One has:
    
               cacosh(z) = 2 * clog(csqrt((z + 1) / 2) + csqrt((z - 1) / 2))
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌──────────────────────────────────────┬───────────────┬─────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **cacosh**(), **cacoshf**(), **cacoshl**()       │ 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;
    
               if (argc != 3) {
                   fprintf(stderr, "Usage: %s <real> <imag>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }
    
               z = atof(argv[1]) + atof(argv[2]) * I;
    
               c = cacosh(z);
               printf("cacosh() = %6.3f %6.3f*i\n", creal(c), cimag(c));
    
               f = 2 * clog(csqrt((z + 1)/2) + csqrt((z - 1)/2));
               printf("formula  = %6.3f %6.3f*i\n", creal(f), cimag(f));
    
               exit(EXIT_SUCCESS);
           }
    


* * *
# iswpunct

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



           iswpunct, iswpunct_l — test for a punctuation wide-character code
    


## SYNOPSIS



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


## DESCRIPTION



           For _iswpunct_(): 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 _iswpunct_() and _iswpunct_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **punct** 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 _iswpunct_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswpunct_() and _iswpunct_l_() functions shall return non-zero if
           _wc_ is a punctuation 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.
    


* * *
# lround

## NAME



           lround, lroundf, lroundl, llround, llroundf, llroundl - round to
           nearest integer
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **long lround(double** _x_**);**
           **long lroundf(float** _x_**);**
           **long lroundl(long double** _x_**);**
    
           **long long llround(double** _x_**);**
           **long long llroundf(float** _x_**);**
           **long long llroundl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           All functions shown above:
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions round their argument to the nearest integer value,
           rounding halfway cases away from zero, regardless of the current
           rounding direction (see fenv(3)).
    
           Note that unlike the round(3) and ceil(3), functions, the return
           type of these functions differs from that of their arguments.
    


## RETURN VALUE



           These functions return the rounded integer value.
    
           If _x_ is a NaN or an infinity, or the rounded value is too large to
           be stored in a _long_ (_long long_ in the case of the **ll*** functions),
           then a domain error occurs, and the return value is unspecified.
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Domain error: _x_ is a NaN or infinite, or the rounded value is too
           large
                  An invalid floating-point exception (**FE_INVALID**) is raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmagetlog

## NAME



           **pmaGetLog** - direct read of the next record from an archive file
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **int pmaGetLog(__pmArchCtl ***_acp_**, int** _vol_**, __int32_t ****_rbuf_**);**
    
           **cc ... -lpcp_archive -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



           This is a cut-down version of  **__pmLogRead**(3)  from  libpcp,  that
           reads  the next physical record from the volume _vol_ of the archive
           identified by _acp_.
    
           If _vol_ is **PM_LOG_VOL_META** then the next metadata record  is  read,
           otherwise the next record from the data volume _vol_ is read.
    
           The  record  is  returned  in _rbuf_ which is allocated here; so the
           caller will have to call free(3) when it is no longer needed.
    
           The record header length and trailer length is checked, but other‐
           wise _rbuf_ is not processed, and in particular the  record  remains
           in network byte-order.
    


## DIAGNOSTICS AND RETURN VALUES



           The  return  value is 0 if all is well, else PM_ERR_EOL for end of
           file, else some other error code less than zero.
    


* * *
# gnutls_session_get_flags

## NAME



           gnutls_session_get_flags - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_session_get_flags(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will return a series (ORed) of flags, applicable for
           the current session.
    
           This replaces individual informational functions such as
           **gnutls_safe_renegotiation_status()** ,
           **gnutls_session_ext_master_secret_status()** , etc.
    


## RETURNS



           An ORed sequence of flags (see **gnutls_session_flags_t**)
    


## SINCE



           3.5.0
    


* * *
# acl_clear_perms

## NAME



           **acl_clear_perms** — clear all permissions from an ACL permission set
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_clear_perms**(_acl_permset_t_
           _permset_d_)
    


## DESCRIPTION



           The **acl_clear_perms**() function clears all permissions from the
           permission set referred to by the argument _permset_d_.
    
           Any existing descriptors that refer to _permset_d_ shall continue to
           refer to that permission set.
    


## RETURN VALUE



           The **acl_clear_perms**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_clear_perms**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _permset_d_ is not a valid
                              descriptor for a permission set within an ACL
                              entry.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# gnutls_certificate_get_x509_key

## NAME



           gnutls_certificate_get_x509_key - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_get_x509_key(gnutls_certificate_credentials_t**
           _res_**, unsigned** _index_**, gnutls_x509_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           unsigned index
                       The index of the key to obtain.
    
           gnutls_x509_privkey_t * key
                       Location to store the key.
    


## DESCRIPTION



           Obtains a X.509 private key that has been stored in  _res_ with one
           of **gnutls_certificate_set_x509_key()** ,
           **gnutls_certificate_set_key()** ,
           **gnutls_certificate_set_x509_key_file()** ,
           **gnutls_certificate_set_x509_key_file2()** ,
           **gnutls_certificate_set_x509_key_mem()** , or
           **gnutls_certificate_set_x509_key_mem2()**. The returned key must be
           deallocated with **gnutls_x509_privkey_deinit()** when no longer
           needed.
    
           The  _index_ matches the return value of
           **gnutls_certificate_set_x509_key()** and friends functions, when the
           **GNUTLS_CERTIFICATE_API_V2** flag is set.
    
           If there is no key with the given index,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned. If the key with
           the given index is not a X.509 key, **GNUTLS_E_INVALID_REQUEST** is
           returned.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success, or a negative error code.
    


## SINCE



           3.4.0
    


* * *
# gnutls_pkcs12_import

## NAME



           gnutls_pkcs12_import - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_import(gnutls_pkcs12_t** _pkcs12_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       The data to store the parsed PKCS12.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded PKCS12.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    
           unsigned int flags
                       an ORed sequence of gnutls_privkey_pkcs8_flags
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded PKCS12 to
           the native gnutls_pkcs12_t format. The output will be stored in
           'pkcs12'.
    
           If the PKCS12 is PEM encoded it should have a header of "PKCS12".
    


## RETURNS



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


* * *
# tapset::atomic

## NAME



           tapset::atomic - systemtap atomic tapset
    


## DESCRIPTION



           **atomic_read**
                  Retrieves an atomic variable from kernel memory
    
                  See function::atomic_read(3stap)
                   for details.
    
           **atomic_long_read**
                  Retrieves an atomic long variable from kernel memory
    
                  See function::atomic_long_read(3stap)
                   for details.
    


* * *
# ldap_delete

## NAME



           ldap_delete, ldap_delete_s, ldap_delete_ext, ldap_delete_ext_s -
           Perform an LDAP delete operation.
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_delete_s(ld, dn)**
           LDAP *ld;
           char *dn;
    
           **int ldap_delete(ld, dn)**
           LDAP *ld;
           char *dn;
    
           **int ldap_delete_ext(ld, dn, serverctrls, clientctrls, msgidp)**
           LDAP *ld;
           char *dn;
           LDAPControl **serverctrls, **clientctrls;
           int *msgidp;
    
           **int ldap_delete_ext_s(ld, dn, serverctrls, clientctrls)**
           LDAP *ld;
           char *dn;
           LDAPControl **serverctrls, **clientctrls;
    


## DESCRIPTION



           The **ldap_delete_s()** routine is used to perform an LDAP delete
           operation synchronously. It takes _dn_ , the DN of the entry to be
           deleted.  It returns an LDAP error code, indicating the success or
           failure of the operation.
    
           The **ldap_delete()** routine is used to perform an LDAP delete
           operation asynchronously. It takes the same parameters as
           **ldap_delete_s(),** but returns the message id of the request it
           initiated. The result of the delete can be obtained by a
           subsequent call to ldap_result(3).
    
           The **ldap_delete_ext()** routine  allows  server  and client controls
           to be specified to extend the delete request. This routine is
           asynchronous like ldap_delete(), but its return value is an LDAP
           error code. It stores the message id of the request in the integer
           pointed to by msgidp.
    
           The **ldap_delete_ext_s()** routine is the synchronous version of
           **ldap_delete_ext().** It also returns an LDAP error code indicating
           success or failure of the operation.
    


## ERRORS



           **ldap_delete_s()** returns an LDAP error code which can be
           interpreted by calling one of ldap_perror(3) and friends.
           **ldap_delete()** returns -1 if something went wrong initiating the
           request. It returns the non-negative message id of the request if
           things went ok.
    
           **ldap_delete_ext()** and **ldap_delete_ext_s()** return some Non-zero
           value if something  went wrong initiating the request, else return
           0.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# pmnewzone

## NAME



           **pmNewZone** - establish a reporting timezone
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmNewZone(const char ***_tz_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  current  reporting  timezone  affects  the  timezone  used by
           pmCtime(3) and pmLocaltime(3).
    
           The argument _tz_ defines a timezone string, in the format described
           for the **TZ** environment variable, see environ(7).
    
           **pmNewZone** sets the current reporting timezone, and returns a value
           that may be used in a subsequent call to pmUseZone(3)  to  restore
           this reporting timezone.
    


## DIAGNOSTICS



           A  return value less than zero indicates a fatal error from a sys‐
           tem call, most likely malloc(3).
    


* * *
# EOF

## NAME



           EOF - end of file or error indicator
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **#define EOF** /* ... */
    


## DESCRIPTION



           **EOF** represents the end of an input file, or an error indication.
           It is a negative value, of type _int_.
    
           **EOF** is not a character (it can't be represented by _unsigned char_).
           It is instead a sentinel value outside of the valid range for
           valid characters.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## CAVEATS



           Programs can't pass this value to an output function to "write"
           the end of a file.  That would likely result in undefined
           behavior.  Instead, closing the writing stream or file descriptor
           that refers to such file is the way to signal the end of that
           file.
    


* * *
# pmiunits

## NAME



           **pmiUnits** , **pmiID** , **pmiInDom** - construct core metric data structures
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **pmID pmiID(int** _domain_**, int** _cluster_**, int** _item_**);**
           **pmInDom pmiInDom(int** _domain_**, int** _serial_**);**
           **pmUnits pmiUnits(int** _dimSpace_**, int** _dimTime_**, int** _dimCount_**,**
                            **int** _scaleSpace_**, int** _scaleTime_**, int** _scaleCount_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **$pmid = pmiID($**_domain_**, $**_cluster_**, $**_item_**);**
           **$indom = pmiInDom($**_domain_**, $**_serial_**);**
           **$units = pmiUnits($**_dimSpace_**, $**_dimTime_**, $**_dimCount_**, $**_scaleSpace_**,**
                             **$**_scaleTime_**, $**_scaleCount_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), these routines provide convenience  methods  (espe‐
           cially  for script use) for constructing **pmID** , **pmInDom** and **pmUnits**
           structures  respectively,  to  be  used  in  subsequent  calls  to
           pmiAddMetric(3) and pmiAddInstance(3).
    
           Refer  to pmLookupDesc(3) for a complete description of the values
           and semantics of the components of a **pmUnits** structure, and  hence
           the valid argument values for **pmiUnits**.
    


* * *
# pmnotifyerr

## NAME



           **pmNotifyErr** , **pmSyslog** - standard handling of error messages
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmNotifyErr(int** _priority_**, const char ***_message_**, ...);**
           **void pmSyslog(int** _onoff_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           These  routines  provide standard handling for error messages from
           within the internals of Performance  Co-Pilot  (PCP)  daemons  and
           Performance Metric Domain Agents (PMDAs).
    
           **pmNotifyErr** is a printf(3) style function that will format _message_
           (and  any  subsequent  arguments)  with a prefix that includes the
           current date and time from ctime(3), the name of  the  application
           from  pmGetProgname(3),  the  process's  id from getpid(2) and the
           _priority_.
    
           _priority_ should be one  of  the  level  **LOG_** macros  defined  for
           syslog(3).   Most typically this would be **LOG_INFO** , **LOG_WARNING** or
           **LOG_ERR**.
    
           **pmNotifyErr** writes to standard error, which for daemons and  PMDAs
           has  most likely been redirected to a log file using pmOpenLog(3).
           Additionally _message_ (and any subsequent arguments)  may  be  sent
           forwarded to syslog(3) if **pmSyslog** has previously been called with
           _onoff_ having a non-zero value.
    
           Forwarding to syslog(3) can be disabled at any time by calling **pm‐**
           **Syslog** with  _onoff_  having a zero value, and this is the starting
           state for each PCP application.
    
           In the style of syslog(3) _message_ need not include  a  terminating
           newline character (one will be added if required).
    


* * *
# function::kernel_short

## NAME



           function::kernel_short - Retrieves a short value stored in kernel
           memory
    


## SYNOPSIS



               kernel_short:long(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the short from
    


## DESCRIPTION



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


* * *
# pam_authenticate

## NAME



           pam_authenticate - account authentication
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **int pam_authenticate(pam_handle_t ***_pamh_**, int** _flags_**);**
    


## DESCRIPTION



           The **pam_authenticate** function is used to authenticate the user.
           The user is required to provide an authentication token depending
           upon the authentication service, usually this is a password, but
           could also be a finger print.
    
           The PAM service module may request that the user enter their
           username via the conversation mechanism (see pam_start(3) and
           pam_conv(3)). The name of the authenticated user will be present
           in the PAM item PAM_USER. This item may be recovered with a call
           to pam_get_item(3).
    
           The _pamh_ argument is an authentication handle obtained by a prior
           call to pam_start(). The flags argument is the binary or of zero
           or more of the following values:
    
           PAM_SILENT
               Do not emit any messages.
    
           PAM_DISALLOW_NULL_AUTHTOK
               The PAM module service should return PAM_AUTH_ERR if the user
               does not have a registered authentication token.
    


## RETURN VALUES



           PAM_ABORT
               The application should exit immediately after calling
               pam_end(3) first.
    
           PAM_AUTH_ERR
               The user was not authenticated.
    
           PAM_CRED_INSUFFICIENT
               For some reason the application does not have sufficient
               credentials to authenticate the user.
    
           PAM_AUTHINFO_UNAVAIL
               The modules were not able to access the authentication
               information. This might be due to a network or hardware
               failure etc.
    
           PAM_MAXTRIES
               One or more of the authentication modules has reached its
               limit of tries authenticating the user. Do not try again.
    
           PAM_SUCCESS
               The user was successfully authenticated.
    
           PAM_USER_UNKNOWN
               User unknown to authentication service.
    


* * *
# avc_compute_create

## NAME



           avc_compute_create, avc_compute_member - obtain SELinux label for
           new object
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/avc.h>**
    
           **int avc_compute_create(security_id_t** _ssid_**, security_id_t** _tsid_**,**
                                  **security_class_t** _tclass_**, security_id_t**
                                  *****_newsid_**);**
    
           **int avc_compute_member(security_id_t** _ssid_**, security_id_t** _tsid_**,**
                                  **security_class_t** _tclass_**, security_id_t**
                                  *****_newsid_**);**
    


## DESCRIPTION



           **avc_compute_create**() is used to compute a SID to use for labeling
           a new object in a particular class based on a SID pair.  This call
           is identical to **security_compute_create**(), but does not require
           converting from userspace SID's to contexts and back again.
    
           **avc_compute_member**() is used to compute a SID to use for labeling
           a polyinstantiated object instance of a particular class based on
           a SID pair.  This call is identical to **security_compute_member**(),
           but does not require converting from userspace SID's to contexts
           and back again.
    
           These functions return a SID for the computed context in the
           memory referenced by _sid_.
    


## RETURN VALUE



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


## ERRORS



           **EINVAL** The _tclass_ and/or the security contexts referenced by _ssid_
                  and _tsid_ are not recognized by the currently loaded policy.
    
           **ENOMEM** An attempt to allocate memory failed.
    


* * *
# casin

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



           casin, casinf, casinl — complex arc sine functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex casin(double complex _z_);
           float complex casinf(float complex _z_);
           long double complex casinl(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 arc sine of _z_ , with
           branch cuts outside the interval [-1, +1] along the real axis.
    


## RETURN VALUE



           These functions shall return the complex arc sine value, in the
           range of a strip mathematically unbounded along the imaginary axis
           and in the interval [-π/2, +π/2] along the real axis.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tty.resize

## NAME



           probe::tty.resize - Called when a terminal resize happens
    


## SYNOPSIS



           tty.resize
    


## VALUES



           _new_row_
               the new row value
    
           _old_ypixel_
               the old ypixel
    
           _new_xpixel_
               the new xpixel value
    
           _new_col_
               the new col value
    
           _old_xpixel_
               the old xpixel
    
           _old_col_
               the old col value
    
           _name_
               the tty name
    
           _old_row_
               the old row value
    
           _new_ypixel_
               the new ypixel value
    


* * *
# audit_delete_rule_data

## NAME



           audit_delete_rule_data - Delete audit rule
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_delete_rule_data(int** _fd_**, struct audit_rule_data ***_rule_**, int** _flags_**, int** _action_**);"**
    


## DESCRIPTION



           audit_delete_rule_data is used to delete rules that are currently
           loaded in the kernel. The file descriptor is given in _fd_ and the
           rule description in _rule_. To delete a rule, you must set up the
           rules identical to the one being deleted. See audit_add_rule_data
           for _flags_ and _action_ definitions.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# gnutls_privkey_export_gost_raw2

## NAME



           gnutls_privkey_export_gost_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_gost_raw2(gnutls_privkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_digest_algorithm_t ***_digest_**,**
           **gnutls_gost_paramset_t ***_paramset_**, gnutls_datum_t ***_x_**,**
           **gnutls_datum_t ***_y_**, gnutls_datum_t ***_k_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_digest_algorithm_t * digest
                       will hold the digest
    
           gnutls_gost_paramset_t * paramset
                       will hold the GOST parameter set ID
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    
           gnutls_datum_t * k
                       will hold the private key
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the GOST private key's parameters found
           in the given structure. The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## NOTE



           parameters will be stored with least significant byte first. On
           version 3.6.3 this was incorrectly returned in big-endian format.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# gnutls_db_set_cache_expiration

## NAME



           gnutls_db_set_cache_expiration - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int seconds is the number of seconds.
    


## DESCRIPTION



           Set the expiration time for resumed sessions. The default is 21600
           (6 hours) at the time of writing.
    
           The maximum value that can be set using this function is 604800 (7
           days).
    


* * *