tripathysagar/man_text huggingface dataset:
# fchmodat

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



           fchmodat — change mode of a file relative to directory file
           descriptor
    


## SYNOPSIS



           #include <sys/stat.h>
    
           int fchmodat(int _fd_ , const char *_path_ , mode_t _mode_ , int _flag_);
    


## DESCRIPTION



           Refer to chmod(3p).
    


* * *
# function::kernel_string_n

## NAME



           function::kernel_string_n - Retrieves string of given length from
           kernel memory
    


## SYNOPSIS



               kernel_string_n:string(addr:long,n:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    
           _n_
               The maximum length of the string (if not null terminated)
    


## DESCRIPTION



           Returns the C string of a maximum given length from a given kernel
           memory address. Reports an error on string copy fault.
    


* * *
# function::set_user_string_arg

## NAME



           function::set_user_string_arg - Writes a string to user memory.
    


## SYNOPSIS



               set_user_string_arg(addr:long,val:string)
    


## ARGUMENTS



           _addr_
               The user address to write the string to
    
           _val_
               The string which is to be written
    


## DESCRIPTION



           Writes the given string to a given user memory address. Reports a
           warning on string copy fault. Requires the use of guru mode (-g).
    


* * *
# probe::udp.recvmsg

## NAME



           probe::udp.recvmsg - Fires whenever a UDP message is received
    


## SYNOPSIS



           udp.recvmsg
    


## VALUES



           _sport_
               UDP source port
    
           _dport_
               UDP destination port
    
           _daddr_
               A string representing the destination IP address
    
           _size_
               Number of bytes received by the process
    
           _name_
               The name of this probe
    
           _saddr_
               A string representing the source IP address
    
           _family_
               IP address family
    
           _sock_
               Network socket used by the process
    


## CONTEXT



           The process which received a UDP message
    


* * *
# ftell

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



           ftell, ftello — return a file offset in a stream
    


## SYNOPSIS



           #include <stdio.h>
    
           long ftell(FILE *_stream_);
           off_t ftello(FILE *_stream_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _ftell_() function shall obtain the current value of the file-
           position indicator for the stream pointed to by _stream_.
    
           The _ftell_() function shall not change the setting of _errno_ if
           successful.
    
           The _ftello_() function shall be equivalent to _ftell_(), except that
           the return value is of type **off_t** and the _ftello_() function may
           change the setting of _errno_ if successful.
    


## RETURN VALUE



           Upon successful completion, _ftell_() and _ftello_() shall return the
           current value of the file-position indicator for the stream
           measured in bytes from the beginning of the file.
    
           Otherwise, _ftell_() and _ftello_() shall return -1, and set _errno_ to
           indicate the error.
    


## ERRORS



           The _ftell_() and _ftello_() functions shall fail if:
    
           **EBADF** The file descriptor underlying _stream_ is not an open file
                  descriptor.
    
           **EOVERFLOW**
                  For _ftell_(), the current file offset cannot be represented
                  correctly in an object of type **long**.
    
           **EOVERFLOW**
                  For _ftello_(), the current file offset cannot be represented
                  correctly in an object of type **off_t**.
    
           **ESPIPE** The file descriptor underlying _stream_ is associated with a
                  pipe, FIFO, or socket.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pthread_spin_lock

## PROLOG



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


## NAME



           pthread_spin_lock, pthread_spin_trylock — lock a spin lock object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_spin_lock(pthread_spinlock_t *_lock_);
           int pthread_spin_trylock(pthread_spinlock_t *_lock_);
    


## DESCRIPTION



           The _pthread_spin_lock_() function shall lock the spin lock
           referenced by _lock_.  The calling thread shall acquire the lock if
           it is not held by another thread. Otherwise, the thread shall spin
           (that is, shall not return from the _pthread_spin_lock_() call)
           until the lock becomes available. The results are undefined if the
           calling thread holds the lock at the time the call is made. The
           _pthread_spin_trylock_() function shall lock the spin lock
           referenced by _lock_ if it is not held by any thread. Otherwise, the
           function shall fail.
    
           The results are undefined if any of these functions is called with
           an uninitialized spin lock.
    


## RETURN VALUE



           Upon successful completion, these functions shall return zero;
           otherwise, an error number shall be returned to indicate the
           error.
    


## ERRORS



           The _pthread_spin_lock_() function may fail if:
    
           **EDEADLK**
                  A deadlock condition was detected.
    
           The _pthread_spin_trylock_() function shall fail if:
    
           **EBUSY** A thread currently holds the lock.
    
           These functions shall not return an error code of **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications using this function may be subject to priority
           inversion, as discussed in the Base Definitions volume of
           POSIX.1‐2017, _Section 3.291_ , _Priority Inversion_.
    


## RATIONALE



           If an implementation detects that the value specified by the _lock_
           argument to _pthread_spin_lock_() or _pthread_spin_trylock_() does not
           refer to an initialized spin lock object, it is recommended that
           the function should fail and report an **[EINVAL]** error.
    
           If an implementation detects that the value specified by the _lock_
           argument to _pthread_spin_lock_() refers to a spin lock object for
           which the calling thread already holds the lock, it is recommended
           that the function should fail and report an **[EDEADLK]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# curs_in_wch

## NAME



           **in_wch** , **mvin_wch** , **mvwin_wch** , **win_wch** - extract a complex character
           and rendition from a window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int in_wch(cchar_t ***_wcval_**);**
           **int win_wch(WINDOW ***_win_**, cchar_t ***_wcval_**);**
    
           **int mvin_wch(int** _y_**, int** _x_**, cchar_t ***_wcval_**);**
           **int mvwin_wch(WINDOW ***_win_**, int** _y_**, int** _x_**, cchar_t ***_wcval_**);**
    


## DESCRIPTION



           These functions extract the complex character and rendition from
           the current position in the named window into the **cchar_t** object
           referenced by wcval.
    


## RETURN VALUE



           No errors are defined in the XSI Curses standard.  This
           implementation checks for null pointers, returns **ERR** in that case.
           Also, the _mv_ routines check for error moving the cursor, returning
           **ERR** in that case.  Otherwise they return **OK**.
    
           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 of these routines may be macros.
    


## PORTABILITY



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


* * *
# __pmlogwritemark

## NAME



           **__pmLogWriteMark** - append a <mark> record to a PCP archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
    
           **int __pmLogWriteMark(__pmArchCtl ***_acp_**,**
                                **const __pmTimestamp ***_last_stamp_**,**
                                **const __pmTimestamp ***_inc_**);**
    
           **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 at some point in the future
           they may not work or may provide different semantics.
    


## DESCRIPTION



           **__pmLogWriteMark** appends a <mark> record to the current data  file
           of  a  PCP  archive.  A <mark> record indicates a discontinuity in
           the time series of logged data in the archive, see PCPIntro(1) for
           more information.
    
           The timestamp of the <mark> record is given by _last_stamp_  option‐
           ally  incremented  by _inc_ unless _inc_ is NULL (in which case no in‐
           crement is done).
    
           The current data volume's I/O stream and the archive version  (de‐
           termines the format of the <mark> record) are determined from **acp**.
    


## DIAGNOSTICS AND RETURN VALUES



           The  return  value  is 0 if all is well, else some error code less
           than zero that can be turned into  an  error  message  by  calling
           pmErrStr(3).
    


* * *
# gnutls_openpgp_send_cert

## NAME



           gnutls_openpgp_send_cert - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_openpgp_send_cert(gnutls_session_t** _session_**,**
           **gnutls_openpgp_crt_status_t** _status_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           gnutls_openpgp_crt_status_t status
                       is ignored
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


* * *
# tapset::loadavg

## NAME



           tapset::loadavg - systemtap loadavg tapset
    


## DESCRIPTION



            Functions in the loadavg tapset allow a probe handler to capture
            the load average.
    
           **get_loadavg_index**
                  Get the load average for a specified interval
    
                  See function::get_loadavg_index(3stap)
                   for details.
    
           **sprint_loadavg**
                  Report a pretty-printed load average
    
                  See function::sprint_loadavg(3stap)
                   for details.
    


* * *
# ceil

## NAME



           ceil, ceilf, ceill - ceiling function: smallest integral value not
           less than argument
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double ceil(double** _x_**);**
           **float ceilf(float** _x_**);**
           **long double ceill(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **ceilf**(), **ceill**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return the smallest integral value that is not
           less than _x_.
    
           For example, _ceil(0.5)_ is 1.0, and _ceil(-0.5)_ is 0.0.
    


## RETURN VALUE



           These functions return the ceiling of _x_.
    
           If _x_ is integral, +0, -0, NaN, or infinite, _x_ itself is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ibv_rate_to_mult

## NAME



           ibv_rate_to_mult - convert IB rate enumeration to multiplier of
           2.5 Gbit/sec
    
           mult_to_ibv_rate - convert multiplier of 2.5 Gbit/sec to an IB
           rate enumeration
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_rate_to_mult(enum ibv_rate rate);
    
                  enum ibv_rate mult_to_ibv_rate(int mult);
    


## DESCRIPTION



           **ibv_rate_to_mult()** converts the IB transmission rate enumeration
           _rate_ to a multiple of 2.5 Gbit/sec (the base rate).  For example,
           if _rate_ is **IBV_RATE_5_GBPS** , the value 2 will be returned (5
           Gbit/sec = 2 * 2.5 Gbit/sec).
    
           **mult_to_ibv_rate()** converts the multiplier value (of 2.5 Gbit/sec)
           _mult_ to an IB transmission rate enumeration.  For example, if _mult_
           is 2, the rate enumeration **IBV_RATE_5_GBPS** will be returned.
    


## RETURN VALUE



           **ibv_rate_to_mult()** returns the multiplier of the base rate 2.5
           Gbit/sec.
    
           **mult_to_ibv_rate()** returns the enumeration representing the IB
           transmission rate.
    


* * *
# auparse_goto_record_num

## NAME



           auparse_goto_record_num - move record cursor to specific record
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_goto_record_num(const auparse_state_t**
           *****_au,_**unsigned** _int"_**num);"**
    


## DESCRIPTION



           auparse_goto_record_num will move the internal library cursors to
           point to a specific physical record number. Records within the
           same event are numbered starting from 0. This is generally not
           needed but there are some cases where one may want precise control
           over the exact record being looked at.
    


## RETURN VALUE



           Returns 0 on error or 1 for success.
    


* * *
# rewinddir

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



           rewinddir — reset the position of a directory stream to the
           beginning of a directory
    


## SYNOPSIS



           #include <dirent.h>
    
           void rewinddir(DIR *_dirp_);
    


## DESCRIPTION



           The _rewinddir_() function shall reset the position of the directory
           stream to which _dirp_ refers to the beginning of the directory. It
           shall also cause the directory stream to refer to the current
           state of the corresponding directory, as a call to _opendir_() would
           have done. If _dirp_ does not refer to a directory stream, the
           effect is undefined.
    
           After a call to the _fork_() function, either the parent or child
           (but not both) may continue processing the directory stream using
           _readdir_(), _rewinddir_(), or _seekdir_().  If both the parent and
           child processes use these functions, the result is undefined.
    


## RETURN VALUE



           The _rewinddir_() function shall not return a value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _rewinddir_() function should be used in conjunction with
           _opendir_(), _readdir_(), and _closedir_() to examine the contents of
           the directory. This method is recommended for portability.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# cos

## NAME



           cos, cosf, cosl - cosine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double cos(double** _x_**);**
           **float cosf(float** _x_**);**
           **long double cosl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **cosf**(), **cosl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions return the cosine of _x_ , where _x_ is given in
           radians.
    


## RETURN VALUE



           On success, these functions return the cosine of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is positive infinity or negative infinity, a domain error
           occurs, and a NaN is returned.
    


## 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 an infinity
                  _errno_ is set to **EDOM**(but see BUGS).  An invalid floating-
                  point exception (**FE_INVALID**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           Before glibc 2.10, the glibc implementation did not set _errno_ to
           **EDOM** when a domain error occurred.
    


* * *
# unlockpt

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



           unlockpt — unlock a pseudo-terminal master/slave pair
    


## SYNOPSIS



           #include <stdlib.h>
    
           int unlockpt(int _fildes_);
    


## DESCRIPTION



           The _unlockpt_() function shall unlock the slave pseudo-terminal
           device associated with the master to which _fildes_ refers.
    
           Conforming applications shall ensure that they call _unlockpt_()
           before opening the slave side of a pseudo-terminal device.
    


## RETURN VALUE



           Upon successful completion, _unlockpt_() shall return 0. Otherwise,
           it shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _unlockpt_() function may fail if:
    
           **EBADF** The _fildes_ argument is not a file descriptor open for
                  writing.
    
           **EINVAL** The _fildes_ argument is not associated with a master pseudo-
                  terminal device.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           See the RATIONALE section for posix_openpt(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# csinl

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



           csinl — complex sine functions
    


## SYNOPSIS



           #include <complex.h>
    
           long double complex csinl(long double complex _z_);
    


## DESCRIPTION



           Refer to csin(3p).
    


* * *
# gnutls_cipher_add_auth

## NAME



           gnutls_cipher_add_auth - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_add_auth(gnutls_cipher_hd_t** _handle_**, const void ***
           _ptext_**, size_t** _ptext_size_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           const void * ptext
                       the data to be authenticated
    
           size_t ptext_size
                       the length of the data
    


## DESCRIPTION



           This function operates on authenticated encryption with associated
           data (AEAD) ciphers and authenticate the input data. This function
           can only be called once and before any encryption operations.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.0
    


* * *
# signbit

## NAME



           signbit - test sign of a real floating-point number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **int signbit(**_x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **signbit**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           **signbit**() is a generic macro which can work on all real floating-
           point types.  It returns a nonzero value if the value of _x_ has its
           sign bit set.
    
           This is not the same as _x < 0.0_, because IEEE 754 floating point
           allows zero to be signed.  The comparison _-0.0 < 0.0_ is false, but
           _signbit(-0.0)_ will return a nonzero value.
    
           NaNs and infinities have a sign bit.
    


## RETURN VALUE



           The **signbit**() macro returns nonzero if the sign of _x_ is negative;
           otherwise it returns zero.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::task_nice

## NAME



           function::task_nice - The nice value of the task
    


## SYNOPSIS



               task_nice:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the nice value of the given task.
    


* * *
# ldap_compare

## NAME



           ldap_compare, ldap_compare_s, ldap_compare_ext, ldap_compare_ext_s
           - Perform an LDAP compare operation.
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_compare_ext(**
                  **LDAP ***_ld_**,**
                  **char ***_dn_**,**
                  **char ***_attr_**,**
                  **const struct berval ***_bvalue_**,**
                  **LDAPControl ****_serverctrls_**,**
                  **LDAPControl ****_clientctrls_**,**
                  **int ***_msgidp_ **);**
    
           **int ldap_compare_ext_s(**
                  **LDAP ***_ld_**,**
                  **char ***_dn_**,**
                  **char ***_attr_**,**
                  **const struct berval ***_bvalue_**,**
                  **LDAPControl ****_serverctrls_**,**
                  **LDAPControl ****_clientctrls_ **);**
    


## DESCRIPTION



           The **ldap_compare_ext_s()** routine is used to perform an LDAP
           compare operation synchronously.  It takes _dn_ , the DN of the entry
           upon which to perform the compare, and _attr_ and _value_ , the
           attribute description and value to compare to those found in the
           entry.  It returns a code, which will be LDAP_COMPARE_TRUE if the
           entry contains the attribute value and LDAP_COMPARE_FALSE if it
           does not.  Otherwise, an error code is returned that indicates the
           nature of the problem.  See ldap(3) for details.
    
           The **ldap_compare_ext()** routine is used to perform an LDAP compare
           operation asynchronously.  It takes the same parameters as
           **ldap_compare_ext_s()** , but provides the message id of the request
           it initiated in the integer pointed to _msgidp_.  The result of the
           compare can be obtained by a subsequent call to ldap_result(3).
    
           Both routines allow server and client controls to be specified to
           extend the compare request.
    


## DEPRECATED INTERFACES



           The routines **ldap_compare**() and **ldap_compare_s**() are deprecated in
           favor of **ldap_compare_ext**() and **ldap_compare_ext_s**(),
           respectively.
    
           Deprecated interfaces generally remain in the library.  The macro
           LDAP_DEPRECATED can be defined to a non-zero value (e.g.,
           -DLDAP_DEPRECATED=1) when compiling program designed to use
           deprecated interfaces.  It is recommended that developers writing
           new programs, or updating old programs, avoid use of deprecated
           interfaces.  Over time, it is expected that documentation (and,
           eventually, support) for deprecated interfaces to be eliminated.
    


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


* * *
# gnutls_x509_crl_get_signature

## NAME



           gnutls_x509_crl_get_signature - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_signature(gnutls_x509_crl_t** _crl_**, char ***
           _sig_**, size_t ***_sizeof_sig_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           char * sig  a pointer where the signature part will be copied (may
                       be null).
    
           size_t * sizeof_sig
                       initially holds the size of  _sig_
    


## DESCRIPTION



           This function will extract the signature field of a CRL.
    


## RETURNS



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


* * *
# tapset::netfilter

## NAME



           tapset::netfilter - systemtap netfilter tapset
    


## DESCRIPTION



           **netfilter.ip.pre_routing**
                  Called before an IP packet is routed
    
                   See probe::netfilter.ip.pre_routing(3stap)
                   for details.
    
           **netfilter.ip.local_in**
                  Called on an incoming IP packet addressed to the local
                  computer
    
                   See probe::netfilter.ip.local_in(3stap)
                   for details.
    
           **netfilter.ip.forward**
                  Called on an incoming IP packet addressed to some other
                  computer
    
                   See probe::netfilter.ip.forward(3stap)
                   for details.
    
           **netfilter.ip.local_out**
                  Called on an outgoing IP packet
    
                   See probe::netfilter.ip.local_out(3stap)
                   for details.
    
           **netfilter.ip.post_routing**
                  Called immediately before an outgoing IP packet leaves the
                  computer
    
                   See probe::netfilter.ip.post_routing(3stap)
                   for details.
    
           **netfilter.bridge.local_in**
                  Called on a bridging packet destined for the local computer
    
                   See probe::netfilter.bridge.local_in(3stap)
                   for details.
    
           **netfilter.bridge.forward**
                  Called on an incoming bridging packet destined for some
                  other computer
    
                   See probe::netfilter.bridge.forward(3stap)
                   for details.
    
           **netfilter.bridge.local_out**
                  Called on a bridging packet coming from a local process
    
                   See probe::netfilter.bridge.local_out(3stap)
                   for details.
    


* * *
# pcre2_set_max_pattern_length

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_max_pattern_length(pcre2_compile_context ***_ccontext_**,**
             **PCRE2_SIZE** _value_**);**
    


## DESCRIPTION



    
           This function sets, in a compile context, the maximum text length
           (in code units) of the pattern that can be compiled. The result is
           always zero. If a longer pattern is passed to **pcre2_compile()**
           there is an immediate error return. The default is effectively
           unlimited, being the largest value a PCRE2_SIZE variable can hold.
    
           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.
    


* * *
# probe::scheduler.wakeup

## NAME



           probe::scheduler.wakeup - Task is woken up
    


## SYNOPSIS



           scheduler.wakeup
    


## VALUES



           _task_pid_
               PID of the task being woken up
    
           _name_
               name of the probe point
    
           _task_tid_
               tid of the task being woken up
    
           _task_state_
               state of the task being woken up
    
           _task_priority_
               priority of the task being woken up
    
           _task_cpu_
               cpu of the task being woken up
    


* * *
# tapset::rlimit

## NAME



           tapset::rlimit - systemtap rlimit tapset
    


## DESCRIPTION



           **rlimit_from_str**
                  Symbolic string associated with resource limit code
    
                  See function::rlimit_from_str(3stap)
                   for details.
    


* * *
# probe::tcpmib.OutSegs

## NAME



           probe::tcpmib.OutSegs - Count the sending of a TCP segment
    


## SYNOPSIS



           tcpmib.OutSegs
    


## VALUES



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


## DESCRIPTION



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


* * *
# gnutls_alert_set_read_function

## NAME



           gnutls_alert_set_read_function - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



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


## SINCE



           3.7.0
    


* * *
# gnutls_pubkey_export_gost_raw2

## NAME



           gnutls_pubkey_export_gost_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_gost_raw2(gnutls_pubkey_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_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve (may be **NULL**)
    
           gnutls_digest_algorithm_t * digest
                       will hold the curve (may be **NULL**)
    
           gnutls_gost_paramset_t * paramset
                       will hold the parameters id (may be **NULL**)
    
           gnutls_datum_t * x
                       will hold the x-coordinate (may be **NULL**)
    
           gnutls_datum_t * y
                       will hold the y-coordinate (may be **NULL**)
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the GOST public key's parameters found
           in the given key.  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_supplemental_send

## NAME



           gnutls_supplemental_send - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_supplemental_send(gnutls_session_t** _session_**, unsigned**
           _do_send_supplemental_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned do_send_supplemental
                       non-zero in order to send supplemental data
    


## DESCRIPTION



           This function is to be called by an extension handler to instruct
           gnutls to send supplemental data during the handshake process.
    


## SINCE



           3.4.0
    


* * *
# gnutls_x509_crt_get_issuer_dn_by_oid

## NAME



           gnutls_x509_crt_get_issuer_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t** _cert_**,**
           **const char ***_oid_**, unsigned** _indx_**, unsigned int** _raw_flag_**, void ***
           _buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const char * oid
                       holds an Object Identified in null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the RDN, this
                       specifies which to send. Use (0) to get the first one.
    
           unsigned int raw_flag
                       If non-zero returns the raw DER data of the DN part.
    
           void * buf  a pointer to a structure to hold the name (may be
                       null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will extract the part of the name of the Certificate
           issuer specified by the given OID. The output, if the raw flag is
           not used, will be encoded as described in RFC4514. Thus a string
           that is ASCII or UTF-8 encoded, depending on the certificate data.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           If raw flag is (0), this function will only return known OIDs as
           text. Other OIDs will be DER encoded, as described in RFC4514 --
           in hex format with a '#' prefix.  You can check about known OIDs
           using **gnutls_x509_dn_oid_known()**.
    
           If  _buf_ is null then only the size will be filled. If the
           _raw_flag_ is not specified the output is always null terminated,
           although the
            _buf_size_ will not include the null character.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the  _buf_size_ will be updated with the
           required size. **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if there are
           no data in the current index. On success 0 is returned.
    


* * *
# towlower

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



           towlower, towlower_l — transliterate uppercase wide-character code
           to lowercase
    


## SYNOPSIS



           #include <wctype.h>
    
           wint_t towlower(wint_t _wc_);
           wint_t towlower_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _towlower_(): 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 _towlower_() and _towlower_l_() functions have as a domain a type
           **wint_t** , the value of which the application shall ensure is a
           character representable as a **wchar_t** , and a wide-character code
           corresponding to a valid character in the locale used by the
           function or the value of WEOF.  If the argument has any other
           value, the behavior is undefined.  If the argument of _towlower_()
           or _towlower_l_() represents an uppercase wide-character code, and
           there exists a corresponding lowercase wide-character code as
           defined by character type information in the current locale or in
           the locale represented by _locale_ , respectively (category
           _LC_CTYPE_), the result shall be the corresponding lowercase wide-
           character code.  All other arguments in the domain are returned
           unchanged.
    
           The behavior is undefined if the _locale_ argument to _towlower_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           Upon successful completion, the _towlower_() and _towlower_l_()
           functions shall return the lowercase letter corresponding to the
           argument passed; otherwise, they shall return the argument
           unchanged.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# curs_insch

## NAME



           **insch** , **winsch** , **mvinsch** , **mvwinsch** - insert a character before
           cursor in a **curses** window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int insch(chtype** _ch_**);**
           **int winsch(WINDOW ***_win_**, chtype** _ch_**);**
    
           **int mvinsch(int** _y_**, int** _x_**, chtype** _ch_**);**
           **int mvwinsch(WINDOW ***_win_**, int** _y_**, int** _x_**, chtype** _ch_**);**
    


## DESCRIPTION



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


## RETURN VALUE



           All routines that return an integer return **ERR** upon failure and **OK**
           (SVr4 specifies only "an integer value other than **ERR** ") upon
           successful completion, unless otherwise noted in the preceding
           routine descriptions.
    
           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



           These routines do not necessarily imply use of a hardware insert
           character feature.
    
           Note that **insch** , **mvinsch** , and **mvwinsch** may be macros.
    


## PORTABILITY



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


* * *
# iswlower

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



           iswlower, iswlower_l — test for a lowercase letter wide-character
           code
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           The _iswlower_() and _iswlower_l_() functions shall return non-zero if
           _wc_ is a lowercase letter 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.
    


* * *
# asinh

## NAME



           asinh, asinhf, asinhl - inverse hyperbolic sine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double asinh(double** _x_**);**
           **float asinhf(float** _x_**);**
           **long double asinhl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **asinh**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || _XOPEN_SOURCE >= 500
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    
           **asinhf**(), **asinhl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions calculate the inverse hyperbolic sine of _x_ ; that
           is the value whose hyperbolic sine is _x_.
    


## RETURN VALUE



           On success, these functions return the inverse hyperbolic sine of
           _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 (-0), +0 (-0) is returned.
    
           If _x_ is positive infinity (negative infinity), positive infinity
           (negative infinity) is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *