tripathysagar/man_text huggingface dataset:
# io_uring_prep_madvise

## NAME



           io_uring_prep_madvise - prepare a madvise request
    


## SYNOPSIS



           **#include <sys/mman.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_madvise(struct io_uring_sqe ***_sqe_**,**
                                      **void ***_addr_**,**
                                      **__u32** _len_**,**
                                      **int** _advice_**);**
    
           **void io_uring_prep_madvise64(struct io_uring_sqe ***_sqe_**,**
                                        **void ***_addr_**,**
                                        **off_t** _len_**,**
                                        **int** _advice_**);**
    


## DESCRIPTION



           The io_uring_prep_madvise(3) function prepares an madvise request.
           The submission queue entry _sqe_ is setup to start an madvise
           operation at the virtual address of _addr_ and of _len_ length in
           bytes, giving it the advise located in _advice_.
    
           The io_uring_prep_madvise64(3) function works like
           io_uring_prep_madvise(3) except that it takes a 64-bit length
           rather than just a 32-bit one. Older kernels may not support the
           64-bit length variant. If this variant is attempted used on a
           kernel that doesn't support 64-bit lengths, then the request will
           get errored with **-EINVAL** in the results field of the CQE.
    
           This function prepares an async madvise(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


## ERRORS



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


* * *
# probe::stap.system.return

## NAME



           probe::stap.system.return - Finished a command from stap
    


## SYNOPSIS



           stap.system.return
    


## VALUES



           _ret_
               a return code associated with running waitpid on the spawned
               process; a non-zero value indicates error
    


## DESCRIPTION



           Fires just before the return of the stap_system function, after
           waitpid.
    


* * *
# fchownat

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



           fchownat — change owner and group of a file relative to directory
           file descriptor
    


## SYNOPSIS



           #include <unistd.h>
    
           int fchownat(int _fd_ , const char *_path_ , uid_t _owner_ , gid_t _group_ ,
               int _flag_);
    


## DESCRIPTION



           Refer to chown(3p).
    


* * *
# div_t

## NAME



           div_t, ldiv_t, lldiv_t, imaxdiv_t - quotient and remainder of an
           integer division
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **typedef struct {**
               **int quot;** /* Quotient */
               **int rem;** /* Remainder */
           **} div_t;**
    
           **typedef struct {**
               **long quot;** /* Quotient */
               **long rem;** /* Remainder */
           **} ldiv_t;**
    
           **typedef struct {**
               **long long quot;** /* Quotient */
               **long long rem;** /* Remainder */
           **} lldiv_t;**
    
           **#include <inttypes.h>**
    
           **typedef struct {**
               **intmax_t quot;** /* Quotient */
               **intmax_t rem;** /* Remainder */
           **} imaxdiv_t;**
    


## DESCRIPTION



           [[_l_]_l_]_div_t_ is the type of the value returned by the [[**l**]**l**]div(3)
           function.
    
           _imaxdiv_t_ is the type of the value returned by the imaxdiv(3)
           function.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmspeclocalpmda

## NAME



           **pmSpecLocalPMDA** - process command-line argument for the table of
           DSO PMDAs
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **char *pmSpecLocalPMDA(const char ***_spec_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           For  Performance  Co-Pilot  (PCP)  applications,  contexts of type
           **PM_CONTEXT_LOCAL** are used by clients that wish  to  fetch  metrics
           directly  from one or more PMDAs on the local host without involv‐
           ing pmcd(1).
    
           **pmSpecLocalPMDA** provides a convenience wrapper to be used  by  ap‐
           plications  that wish to use a command line argument (usually with
           **-K**) to control the DSO PMDAs that  are  available  for  a  **PM_CON‐**
           **TEXT_LOCAL** context.
    
           The  _spec_ argument specifies actions for one or more DSO PMDAs us‐
           ing up to four fields separated by commas (``,''), namely:
           -      an opcode with one of the values **add**(add a new entry), **del**
                  (delete an existing entry) or **clear**(clear all entries from
                  the table).
           -      the PMDA's domain number
           -      the path to the PMDA DSO (may be absolute or relative to
                  the $PCP_VAR_DIR/pmdas directory and the DSO suffix is op‐
                  tional), and
           -      the name of the PMDA's initialization routine.
    
           All fields are required to add a new entry.  To delete an entry
           the opcode is required plus either or both of the domain number
           and path fields.  To clear all entries, only the opcode is re‐
           quired.
    
           If _spec_ is parsed successfully, then the DSO table is updated with
           the extracted fields.
    


## RETURN VALUE



           On success, **pmSpecLocalPMDA** will return NULL.
    
           On error or failure, **pmSpecLocalPMDA** will return a pointer to a
           static error message.
    


## EXAMPLES



           Some examples of valid _spec_ strings:
    
           clear  Delete all entries from the DSO table.
    
           add,123,foo/foo_pmda,foo_init
                  Add the ``foo'' PMDA using domain 123.  The PMDA's DSO is
                  most likely in below the directory **$PCP_PMDAS_DIR** and named
                  _foo/foo_pmda.so_ (for ELF-style platforms) or _foo/foo_pm‐_
                  _da.dylib_ (for BSD-style platforms) or _foo\foo_pmda.dll_ (for
                  Windows-style platforms).  The initialization routine for
                  the ``foo'' PMDA is _foo_init_().
    
           del,123
                  Delete the entry for the DSO with domain 123.
    
           del,,foo/foo_pmda
                  Delete the entry with a pathname to the DSO that matches
                  _foo/foo_pmda_.
    
           del,123,foo/foo_pmda
                  Delete the entry for the DSO with either domain 123 and/or
                  a pathname to the DSO that matches _foo/foo_pmda_.
    


* * *
# gnutls_pubkey_export_rsa_raw2

## NAME



           gnutls_pubkey_export_rsa_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_rsa_raw2(gnutls_pubkey_t** _key_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus (may be **NULL**)
    
           gnutls_datum_t * e
                       will hold the public exponent (may be **NULL**)
    
           unsigned flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the RSA public 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.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# putwc

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



           putwc — put a wide character on a stream
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           wint_t putwc(wchar_t _wc_ , 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 _putwc_() function shall be equivalent to _fputwc_(), except that
           if it is implemented as a macro it may evaluate _stream_ more than
           once, so the argument should never be an expression with side-
           effects.
    


## RETURN VALUE



           Refer to fputwc(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Since it may be implemented as a macro, _putwc_() may treat a _stream_
           argument with side-effects incorrectly. In particular,
           _putwc_(_wc_ ,*_f_ ++) need not work correctly. Therefore, use of this
           function is not recommended; _fputwc_() should be used instead.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# io_uring_prep_poll_remove

## NAME



           io_uring_prep_poll_remove - prepare a poll deletion request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_poll_remove(struct io_uring_sqe ***_sqe_**,**
                                          **__u64** _user_data_**);**
    


## DESCRIPTION



           The io_uring_prep_poll_remove(3) function prepares a poll removal
           request. The submission queue entry _sqe_ is setup to remove a poll
           request identified by _user_data_
    
           Works like io_uring_prep_cancel(3) except only looks for poll
           requests. Apart from that, behavior is identical.  See that man
           page for specific details.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field. On
           success, **0** is returned.
    
           **-ENOENT**
                  The request identified by _user_data_ could not be located.
                  This could be because it completed before the cancelation
                  request was issued, or if an invalid identifier is used.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-EALREADY**
                  The execution state of the request has progressed far
                  enough that cancelation is no longer possible. This should
                  normally mean that it will complete shortly, either
                  successfully, or interrupted due to the cancelation.
    


* * *
# function::user_long_error

## NAME



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


## SYNOPSIS



               user_long_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the long from
    


## DESCRIPTION



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


* * *
# function::json_add_string_metric

## NAME



           function::json_add_string_metric - Add a string metric
    


## SYNOPSIS



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


## ARGUMENTS



           _name_
               The name of the string metric.
    
           _description_
               Metric description. An empty string can be used.
    


## DESCRIPTION



           This function adds a string metric, setting up everything needed.
    


* * *
# function::task_ancestry

## NAME



           function::task_ancestry - The ancestry of the given task
    


## SYNOPSIS



               task_ancestry:string(task:long,with_time:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    
           _with_time_
               set to 1 to also print the start time of processes (given as a
               delta from boot time)
    


## DESCRIPTION



           Return the ancestry of the given task in the form of
           “grandparent_process=>parent_process=>process”.
    


* * *
# gnutls_x509_privkey_verify_seed

## NAME



           gnutls_x509_privkey_verify_seed - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_verify_seed(gnutls_x509_privkey_t** _key_**,**
           **gnutls_digest_algorithm_t** _digest_**, const void ***_seed_**, size_t**
           _seed_size_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    
           gnutls_digest_algorithm_t digest
                       it contains the digest algorithm used for key
                       generation (if applicable)
    
           const void * seed
                       the seed of the key to be checked with
    
           size_t seed_size
                       holds the size of  _seed_
    


## DESCRIPTION



           This function will verify that the given private key was generated
           from the provided seed. If  _seed_ is **NULL** then the seed stored in
           the  _key_ 's structure will be used for verification.
    


## RETURNS



           In case of a verification failure
           **GNUTLS_E_PRIVKEY_VERIFICATION_ERROR** is returned, and zero or
           positive code on success.
    


## SINCE



           3.5.0
    


* * *
# nextup

## NAME



           nextup, nextupf, nextupl, nextdown, nextdownf, nextdownl - return
           next floating-point number toward positive/negative infinity
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <math.h>**
    
           **double nextup(double** _x_**);**
           **float nextupf(float** _x_**);**
           **long double nextupl(long double** _x_**);**
    
           **double nextdown(double** _x_**);**
           **float nextdownf(float** _x_**);**
           **long double nextdownl(long double** _x_**);**
    


## DESCRIPTION



           The **nextup**(), **nextupf**(), and **nextupl**() functions return the next
           representable floating-point number greater than _x_.
    
           If _x_ is the smallest representable negative number in the
           corresponding type, these functions return -0.  If _x_ is +0 or -0,
           the returned value is the smallest representable positive number
           of the corresponding type.
    
           If _x_ is positive infinity, the returned value is positive
           infinity.  If _x_ is negative infinity, the returned value is the
           largest representable finite negative number of the corresponding
           type.
    
           If _x_ is NaN, the returned value is NaN.
    
           The value returned by _nextdown(x)_ is _-nextup(-x)_ , and similarly
           for the other types.
    


## RETURN VALUE



           See DESCRIPTION.
    


## ATTRIBUTES



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


## STANDARDS



           These functions are described in _IEEE Std 754-2008 - Standard for_
           _Floating-Point Arithmetic_ and _ISO/IEC TS 18661_.
    


* * *
# gnutls_certificate_set_verify_flags

## NAME



           gnutls_certificate_set_verify_flags - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_verify_flags(gnutls_certificate_credentials_t**
           _res_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           unsigned int flags
                       are the flags
    


## DESCRIPTION



           This function will set the flags to be used for verification of
           certificates and override any defaults.  The provided flags must
           be an OR of the **gnutls_certificate_verify_flags** enumerations.
    


* * *
# probe::vm.kfree

## NAME



           probe::vm.kfree - Fires when kfree is requested
    


## SYNOPSIS



           vm.kfree
    


## VALUES



           _name_
               name of the probe point
    
           _ptr_
               pointer to the kmemory allocated which is returned by kmalloc
    
           _caller_function_
               name of the caller function.
    
           _call_site_
               address of the function calling this kmemory function
    


* * *
# gnutls_heartbeat_get_timeout

## NAME



           gnutls_heartbeat_get_timeout - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will return the milliseconds remaining for a
           retransmission of the previously sent ping message. This function
           is useful when ping is used in non-blocking mode, to estimate when
           to call **gnutls_heartbeat_ping()** if no packets have been received.
    


## RETURNS



           the remaining time in milliseconds.
    


## SINCE



           3.1.2
    


* * *
# pmdahelp

## NAME



           **pmdaOpenHelp** , **pmdaGetHelp** , **pmdaGetInDomHelp** , **pmdaCloseHelp** - help
           text support for a PMDA
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaOpenHelp(const char ***_fname_**);**
           **char *pmdaGetHelp(int** _handle_**, pmID** _pmid_**, int** _type_**);**
           **char *pmdaGetInDomHelp(int** _handle_**, pmInDom** _indom_**, int** _type_**);**
           **void pmdaCloseHelp(int** _handle_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), this group of routines is used to implement the process‐
           ing of a PMDA's metric help information.
    
           These routines are really intended for internal  use,  and  should
           not need to be called directly from any PMDA code.
    
           Briefly,  the  base  name  of  the  help  text file (as created by
           newhelp(1)) is passed in via a **-h** command line option for a daemon
           PMDA or as an argument to pmdaDaemon(3) or pmdaDSO(3).   Then  **pm‐**
           **daOpenHelp** is called from pmdaInit(3) and returns a _handle_ that is
           used  in  subsequent calls to identify a particular help text col‐
           lection (each PMDA typically has only one such collection).
    
           Requests for help text  are  passed  to  pmdaText(3)  which  calls
           **pmdaGetHelp** or **pmdaGetInDomHelp** as required.
    
           Other  than  error  cases  in  **pmdaOpenHelp** ,  **pmdaCloseHelp** is not
           called.
    


## CAVEAT



           The PMDA must be using **PMDA_INTERFACE_2** or later, as specified  in
           the call to pmdaDSO(3) or pmdaDaemon(3).
    


## DIAGNOSTICS



           **pmdaOpenHelp** returns  a  negative value for failure, suitable for
           decoding with pmErrStr(3).  **pmdaGetHelp** and  **pmdaGetInDomHelp** re‐
           turn NULL if the corresponding help text does not exist.
    


* * *
# gnutls_protocol_set_enabled

## NAME



           gnutls_protocol_set_enabled - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_protocol_set_enabled(gnutls_protocol_t** _version_**,**
           **unsigned int** _enabled_**);**
    


## ARGUMENTS



           gnutls_protocol_t version
                       is a (gnutls) version number
    
           unsigned int enabled
                       whether to enable the protocol
    


## DESCRIPTION



           Control the previous system-wide setting that marked  _version_ as
           enabled or disabled.  Calling this function is allowed only if
           allowlisting mode is set in the configuration file, and only if
           the system-wide TLS priority string has not been initialized yet.
           The intended usage is to provide applications with a way to
           expressly deviate from the distribution or site defaults inherited
           from the configuration file.  The modification is composable with
           further modifications performed through the priority string
           mechanism.
    
           This function is not thread-safe and is intended to be called in
           the main thread at the beginning of the process execution.
    


## RETURNS



           0 on success or negative error code otherwise.
    


## SINCE



           3.7.3
    


* * *
# cosh

## NAME



           cosh, coshf, coshl - hyperbolic cosine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the hyperbolic cosine of _x_ , which is
           defined mathematically as:
    
               cosh(x) = (exp(x) + exp(-x)) / 2
    


## RETURN VALUE



           On success, these functions return the hyperbolic cosine of _x_.
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 or -0, 1 is returned.
    
           If _x_ is positive infinity or negative infinity, positive infinity
           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** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **cosh**(), **coshf**(), **coshl**()             │ Thread safety │ MT-Safe │
           └──────────────────────────────────────┴───────────────┴─────────┘
    


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           In glibc 2.3.4 and earlier, an overflow floating-point
           (**FE_OVERFLOW**) exception is not raised when an overflow occurs.
    


* * *
# byteorder

## NAME



           htonl, htons, ntohl, ntohs - convert values between host and
           network byte order
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <arpa/inet.h>**
    
           **uint32_t htonl(uint32_t** _hostlong_**);**
           **uint16_t htons(uint16_t** _hostshort_**);**
    
           **uint32_t ntohl(uint32_t** _netlong_**);**
           **uint16_t ntohs(uint16_t** _netshort_**);**
    


## DESCRIPTION



           The **htonl**() function converts the unsigned integer _hostlong_ from
           host byte order to network byte order.
    
           The **htons**() function converts the unsigned short integer _hostshort_
           from host byte order to network byte order.
    
           The **ntohl**() function converts the unsigned integer _netlong_ from
           network byte order to host byte order.
    
           The **ntohs**() function converts the unsigned short integer _netshort_
           from network byte order to host byte order.
    
           On the i386 the host byte order is Least Significant Byte first,
           whereas the network byte order, as used on the Internet, is Most
           Significant Byte first.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_x509_crt_get_issuer_alt_name2

## NAME



           gnutls_x509_crt_get_issuer_alt_name2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer_alt_name2(gnutls_x509_crt_t** _cert_**,**
           **unsigned int** _seq_**, void ***_ian_**, size_t ***_ian_size_**, unsigned int ***
           _ian_type_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * ian  is the place where the alternative name will be copied
                       to
    
           size_t * ian_size
                       holds the size of ret.
    
           unsigned int * ian_type
                       holds the type of the alternative name (one of
                       gnutls_x509_subject_alt_name_t).
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the alternative names, contained in the
           given certificate. It is the same as
           **gnutls_x509_crt_get_issuer_alt_name()** except for the fact that it
           will return the type of the alternative name in  _ian_type_ even if
           the function fails for some reason (i.e.  the buffer provided is
           not enough).
    


## RETURNS



           the alternative issuer name type on success, one of the enumerated
           **gnutls_x509_subject_alt_name_t**.  It will return
           **GNUTLS_E_SHORT_MEMORY_BUFFER** if  _ian_size_ is not large enough to
           hold the value.  In that case  _ian_size_ will be updated with the
           required size.  If the certificate does not have an Alternative
           name with the specified sequence number then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           2.10.0
    


* * *
# fileno

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



           fileno — map a stream pointer to a file descriptor
    


## SYNOPSIS



           #include <stdio.h>
    
           int fileno(FILE *_stream_);
    


## DESCRIPTION



           The _fileno_() function shall return the integer file descriptor
           associated with the stream pointed to by _stream_.
    


## RETURN VALUE



           Upon successful completion, _fileno_() shall return the integer
           value of the file descriptor associated with _stream_.  Otherwise,
           the value -1 shall be returned and _errno_ set to indicate the
           error.
    


## ERRORS



           The _fileno_() function shall fail if:
    
           **EBADF** The stream is not associated with a file.
    
           The _fileno_() function may fail if:
    
           **EBADF** The file descriptor underlying _stream_ is not a valid file
                  descriptor.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Without some specification of which file descriptors are
           associated with these streams, it is impossible for an application
           to set up the streams for another application it starts with
           _fork_() and _exec_.  In particular, it would not be possible to write
           a portable version of the _sh_ command interpreter (although there
           may be other constraints that would prevent that portability).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# sd_event_source_set_exit_on_failure

## NAME



           sd_event_source_set_exit_on_failure,
           sd_event_source_get_exit_on_failure - Set or retrieve the
           exit-on-failure feature of event sources
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **int sd_event_source_set_exit_on_failure(sd_event_source ***_source_**,**
                                                   **int** _b_**);**
    
           **int sd_event_source_get_exit_on_failure(sd_event_source ***_source_**);**
    


## DESCRIPTION



           **sd_event_source_set_exit_on_failure()** may be used to set/unset the
           exit-on-failure flag of the event source object specified as
           _source_. The flag defaults to off. If on and the callback function
           set for the event source returns a failure code (i.e. a negative
           value) the event loop is exited too, using the callback return
           code as the exit code for sd_event_exit(3). If off, the event
           source is disabled but the event loop continues to run. Setting
           this flag is useful for "dominant" event sources that define the
           purpose and reason for the event loop, and whose failure hence
           should propagate to the event loop itself — as opposed to
           "auxiliary" event sources whose failures should remain local and
           affect the event source, but not propagate further.
    
           **sd_event_source_get_exit_on_failure()** may be used to query the
           flag currently set for the event source object _source_.
    


## RETURN VALUE



           On success, **sd_event_source_set_exit_on_failure()** returns a
           non-negative integer.  **sd_event_source_get_exit_on_failure()**
           returns 0 if the flag is off, > 0 if the flag is on. On failure,
           both return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               _source_ is not a valid pointer to an sd_event_source object.
    
               Added in version 247.
    
           **-EDOM**
               The event source refers to an exit event source (as created
               with sd_event_add_exit(3)), for which this functionality is
               not supported.
    
               Added in version 247.
    


## NOTES



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


* * *
# gnutls_x509_rdn_get_oid

## NAME



           gnutls_x509_rdn_get_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_rdn_get_oid(const gnutls_datum_t ***_idn_**, unsigned**
           _indx_**, void ***_buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * idn
                       should contain a DER encoded RDN sequence
    
           unsigned indx
                       Indicates which OID to return. Use 0 for the first
                       one.
    
           void * buf  a pointer to a structure to hold the peer's name OID
    
           size_t * buf_size
                       holds the size of  _buf_
    


## DESCRIPTION



           This function will return the specified Object identifier, of the
           RDN sequence.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, or
           **GNUTLS_E_SHORT_MEMORY_BUFFER** is returned and * _buf_size_ is updated
           if the provided buffer is not long enough, otherwise a negative
           error value.
    


## SINCE



           2.4.0
    


* * *
# key_setsecret

## NAME



           key_decryptsession, key_encryptsession, key_setsecret, key_gendes,
           key_secretkey_is_set - interfaces to rpc keyserver daemon
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <rpc/rpc.h>**
    
           **int key_decryptsession(char ***_remotename_**, des_block ***_deskey_**);**
           **int key_encryptsession(char ***_remotename_**, des_block ***_deskey_**);**
    
           **int key_gendes(des_block ***_deskey_**);**
    
           **int key_setsecret(char ***_key_**);**
           **int key_secretkey_is_set(void);**
    


## DESCRIPTION



           The functions here are used within the RPC's secure authentication
           mechanism (AUTH_DES).  There should be no need for user programs
           to use this functions.
    
           The function **key_decryptsession**() uses the (remote) server netname
           and takes the DES key for decrypting.  It uses the public key of
           the server and the secret key associated with the effective UID of
           the calling process.
    
           The function **key_encryptsession**() is the inverse of
           **key_decryptsession**().  It encrypts the DES keys with the public
           key of the server and the secret key associated with the effective
           UID of the calling process.
    
           The function **key_gendes**() is used to ask the keyserver for a
           secure conversation key.
    
           The function **key_setsecret**() is used to set the key for the
           effective UID of the calling process.
    
           The function **key_secretkey_is_set**() can be used to determine
           whether a key has been set for the effective UID of the calling
           process.
    


## RETURN VALUE



           These functions return 1 on success and 0 on failure.
    


## ATTRIBUTES



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


## NOTES



           Note that we talk about two types of encryption here.  One is
           asymmetric using a public and secret key.  The other is symmetric,
           the 64-bit DES.
    
           These routines were part of the Linux/Doors-project, abandoned by
           now.
    


* * *
# INFINITY

## NAME



           INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL - floating-point
           constants
    


## LIBRARY



           Math library (_libm_)
    


## SYNOPSIS



           **#define _ISOC99_SOURCE** /* See feature_test_macros(7) */
           **#include <math.h>**
    
           **INFINITY**
    
           **NAN**
    
           **HUGE_VAL**
           **HUGE_VALF**
           **HUGE_VALL**
    


## DESCRIPTION



           The macro **INFINITY** expands to a _float_ constant representing
           positive infinity.
    
           The macro **NAN** expands to a _float_ constant representing a quiet NaN
           (when supported).  A _quiet_ NaN is a NaN ("not-a-number") that does
           not raise exceptions when it is used in arithmetic.  The opposite
           is a _signaling_ NaN.  See IEC 60559:1989.
    
           The macros **HUGE_VAL** , **HUGE_VALF** , **HUGE_VALL** expand to constants of
           types _double_ , _float_ , and _long double_ , respectively, that represent
           a large positive value, possibly positive infinity.
    


## STANDARDS



           C11.
    


* * *
# ibv_query_rt_values_ex

## NAME



           ibv_query_rt_values_ex - query an RDMA device for some real time
           values
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **int ibv_query_rt_values_ex(struct ibv_context** _*context_**,**
                                      **struct ibv_values_ex** _*values_**);**
    


## DESCRIPTION



           **ibv_query_rt_values_ex()** returns certain real time values of a
           device _context_.  The argument _attr_ is a pointer to an
           ibv_device_attr_ex struct, as defined in <infiniband/verbs.h>.
    
           struct ibv_values_ex {
                   uint32_t             comp_mask;    /* Compatibility mask that defines the query/queried fields [in/out] */
                   struct timespec      raw_clock;    /* HW raw clock */
           };
    
           enum ibv_values_mask {
                   IBV_VALUES_MASK_RAW_CLOCK = 1 << 0, /* HW raw clock */
           };
    


## RETURN VALUE



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


## NOTES



           This extension verb only calls the provider, the provider has to
           query this value somehow and mark the queried values in the
           comp_mask field.
    


* * *
# atoi

## NAME



           atoi, atol, atoll - convert a string to an integer
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int atoi(const char ***_nptr_**);**
           **long atol(const char ***_nptr_**);**
           **long long atoll(const char ***_nptr_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **atoll**():
               _ISOC99_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The **atoi**() function converts the initial portion of the string
           pointed to by _nptr_ to _int_.  The behavior is the same as
    
               strtol(nptr, NULL, 10);
    
           except that **atoi**() does not detect errors.
    
           The **atol**() and **atoll**() functions behave the same as **atoi**(), except
           that they convert the initial portion of the string to their
           return type of _long_ or _long long_.
    


## RETURN VALUE



           The converted value or 0 on error.
    


## ATTRIBUTES



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


## VERSIONS



           POSIX.1 leaves the return value of **atoi**() on error unspecified.
           On glibc, musl libc, and uClibc, 0 is returned on error.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           _errno_ is not set on error so there is no way to distinguish
           between 0 as an error and as the converted value.  No checks for
           overflow or underflow are done.  Only base-10 input can be
           converted.  It is recommended to instead use the **strtol**() and
           **strtoul**() family of functions in new programs.
    


* * *
# function::qsq_service_time

## NAME



           function::qsq_service_time - Amount of time per request service
    


## SYNOPSIS



               qsq_service_time:long(qname:string,scale:long)
    


## ARGUMENTS



           _qname_
               queue name
    
           _scale_
               scale variable to take account for interval fraction
    


## DESCRIPTION



           This function returns the average time in microseconds required to
           service a request once it is removed from the wait queue.
    


* * *
# semanage_list

## NAME



           semanage_list - SELinux Lists Management API
    


## SYNOPSIS



           The following list function is supported for any SELinux managent
           record.
           Replace the function and object name as necessary.
    
           **extern int LIST_FUNCTION (**
                **semanage_handle_t ***_handle_**,**
                **semanage_OBJECT_t *****_objects_**,**
                **unsigned int***_count_**);**
    


## DESCRIPTION



           **Behavior:**
                  The list function will return an array of all the objects
                  in the selected location.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The function will
                  allocate and populate the array of objects, and store it at
                  the location pointed by _objects._  It will write the number
                  of objects at the location pointed by _count._  The array,
                  and all its objects become property of the caller. Each
                  object must be freed with **semanage_OBJECT_free.**
    
           **Requirements:**
                  This function requires an semanage connection to be
                  established (see **semanage_connect**(3) )
    


## RETURN VALUE



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


* * *
# sd_bus_start

## NAME



           sd_bus_start - Initiate a bus connection to the D-bus broker
           daemon
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_start(sd_bus ***_bus_**);**
    


## DESCRIPTION



           **sd_bus_start()** connects an existing bus connection object to the
           D-Bus broker daemon, usually **dbus-daemon**(1) or **dbus-broker**(1). The
           mechanism to use for the connection must be configured before the
           call to **sd_bus_start()** , using one of sd_bus_set_address(3),
           sd_bus_set_fd(3), or sd_bus_set_exec(3).  **sd_bus_start()** will open
           the connection socket or spawn the executable as needed, and
           asynchronously start a **org.freedesktop.DBus.Hello()** call. The
           answer to the Hello call will be processed later from
           sd_bus_process(3). If opening of the connection or queuing of the
           asynchronous call fail, the connection will be closed with
           sd_bus_close(3).
    
           In most cases, it is better to use sd_bus_default_user(3),
           sd_bus_default_system(3) or related calls instead of the more
           low-level **sd_bus_new()** and **sd_bus_start()**. The higher-level
           functions not only allocate a bus object but also start the
           connection to a well-known bus in a single function call.
    


## RETURN VALUE



           On success, this function returns a non-negative integer. On
           failure, it returns a negative errno-style error code.
    
       **Errors**
           **-EINVAL**
               The input parameter _bus_ is **NULL**.
    
               Added in version 246.
    
           **-ENOPKG**
               Bus object _bus_ could not be resolved.
    
               Added in version 246.
    
           **-EPERM**
               The input parameter _bus_ is in a wrong state (**sd_bus_start()**
               may only be called once on a newly-created bus object).
    
               Added in version 246.
    
           **-ECHILD**
               The bus object _bus_ was created in a different process.
    
               Added in version 246.
    
           In addition, other connection-related errors may be returned. See
           sd_bus_send(3).
    


## NOTES



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


* * *