tripathysagar/man_text huggingface dataset:
# tep_is_file_bigendian

## NAME



           tep_is_file_bigendian, tep_set_file_bigendian - Get / set the
           endianness of the raw data being accessed by the tep handler.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           enum **tep_endian**{
                   TEP_LITTLE_ENDIAN = 0,
                   TEP_BIG_ENDIAN
           };
    
           bool **tep_is_file_bigendian**(struct tep_handle *_tep_);
           void **tep_set_file_bigendian**(struct tep_handle *_tep_ , enum tep_endian _endian_);
    


## DESCRIPTION



           The **tep_is_file_bigendian()** function gets the endianness of the
           raw data, being accessed by the tep handler. The _tep_ argument is
           trace event parser context.
    
           The **tep_set_file_bigendian()** function sets the endianness of raw
           data being accessed by the tep handler. The _tep_ argument is trace
           event parser context.
    
               The _endian_ argument is the endianness:
                       _TEP_LITTLE_ENDIAN_ - the raw data is in little endian format,
                       _TEP_BIG_ENDIAN_ - the raw data is in big endian format.
    


## RETURN VALUE



           The **tep_is_file_bigendian()** function returns true if the data is
           in bigendian format, false otherwise.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
                       tep_set_file_bigendian(tep, TEP_LITTLE_ENDIAN);
               ...
                       if (tep_is_file_bigendian(tep)) {
                               /* The raw data is in big endian */
                       } else {
                               /* The raw data is in little endian */
                       }
    


## FILES



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


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



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


## NOTES



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


* * *
# auparse_get_field_type

## NAME



           auparse_get_field_type - get current field's data type
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_get_field_type(const auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_get_field_type returns a value from the auparse_type_t
           enum that describes the kind of data in the current field of the
           current record in the current event.
    


## RETURN VALUE



           Returns AUPARSE_TYPE_UNCLASSIFIED if the field's data type has no
           known description or is an integer. Otherwise it returns another
           enum. Fields with the type AUPARSE_TYPE_ESCAPED must be
           interpreted to access their value since those field's raw value is
           encoded.
    


* * *
# pmdupcontext

## NAME



           **pmDupContext** - duplicate a PMAPI context
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmDupContext(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           An  application using the Performance Metrics Application Program‐
           ming Interface (PMAPI) may manipulate several concurrent contexts,
           each associated with a source of performance metrics, e.g. pmcd(1)
           on some host, or a set of archives of performance metrics as  cre‐
           ated by pmlogger(1).
    
           Calling **pmDupContext** will replicate the current PMAPI context, re‐
           turning  a handle for the new context that may be used with subse‐
           quent calls to pmUseContext(3).
    
           Once created, the duplicated context and the original context have
           independent existence, and so their instance profiles and  collec‐
           tion time (relevant only for archive contexts) may be independent‐
           ly varied.
    
           The newly replicated context becomes the current context.
    


* * *
# tapset::context-unwind

## NAME



           tapset::context-unwind - systemtap context-unwind tapset
    


## DESCRIPTION



            Context functions provide additional information about where an
           event occurred. These functions can provide information such as a
           backtrace to where the event occurred and the current register
           values for the processor.
    
           **print_backtrace**
                  Print kernel stack back trace
    
                  See function::print_backtrace(3stap)
                   for details.
    
           **print_backtrace_fileline**
                  Print kernel stack back trace
    
                  See function::print_backtrace_fileline(3stap)
                   for details.
    
           **sprint_backtrace**
                  Return stack back trace as string
    
                  See function::sprint_backtrace(3stap)
                   for details.
    
           **backtrace**
                  Hex backtrace of current kernel stack
    
                  See function::backtrace(3stap)
                   for details.
    
           **task_backtrace**
                  Hex backtrace of an arbitrary task
    
                  See function::task_backtrace(3stap)
                   for details.
    


* * *
# atanl

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



           atanl — arc tangent function
    


## SYNOPSIS



           #include <math.h>
    
           long double atanl(long double _x_);
    


## DESCRIPTION



           Refer to atan(3p).
    


* * *
# gnutls_x509_ext_export_basic_constraints

## NAME



           gnutls_x509_ext_export_basic_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_basic_constraints(unsigned int** _ca_**, int**
           _pathlen_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           unsigned int ca
                       non-zero for a CA
    
           int pathlen The path length constraint (set to -1 for no
                       constraint)
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the parameters provided to a basic
           constraints DER encoded extension (2.5.29.19).  The  _ext_ data will
           be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# mult_to_ibv_rate

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


* * *
# sin

## NAME



           sin, sinf, sinl - sine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           On success, these functions return the sine 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** │
           ├──────────────────────────────────────┼───────────────┼─────────┤
           │ **sin**(), **sinf**(), **sinl**()                │ 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.
    


* * *
# probe::scheduler.process_free

## NAME



           probe::scheduler.process_free - Scheduler freeing a data structure
           for a process
    


## SYNOPSIS



           scheduler.process_free
    


## VALUES



           _name_
               name of the probe point
    
           _priority_
               priority of the process getting freed
    
           _pid_
               PID of the process getting freed
    


* * *
# gnutls_pubkey_get_pk_algorithm

## NAME



           gnutls_pubkey_get_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_get_pk_algorithm(gnutls_pubkey_t** _key_**, unsigned**
           **int ***_bits_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       should contain a **gnutls_pubkey_t** type
    
           unsigned int * bits
                       If set will return the number of bits of the
                       parameters (may be NULL)
    


## DESCRIPTION



           This function will return the public key algorithm of a public key
           and if possible will return a number of bits that indicates the
           security parameter of the key.
    


## RETURNS



           a member of the **gnutls_pk_algorithm_t** enumeration on success, or a
           negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# pcap_strerror

## NAME



           pcap_strerror - convert an errno value to a string
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **const char *pcap_strerror(int error);**
    


## DESCRIPTION



           This function returns an error message string corresponding to
           _error_.  It uses either strerror(3) or its thread-safe variant if
           one is available, which currently is the case in every supported
           OS.
    


## BACKWARD COMPATIBILITY



           This function was not thread-safe in libpcap before 1.8.1 on
           Windows and in libpcap before 1.10.5 on all other OSes.
    


* * *
# gnutls_x509_crt_list_verify

## NAME



           gnutls_x509_crt_list_verify - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_list_verify(const gnutls_x509_crt_t ***
           _cert_list_**, unsigned** _cert_list_length_**, const gnutls_x509_crt_t ***
           _CA_list_**, unsigned** _CA_list_length_**, const gnutls_x509_crl_t ***
           _CRL_list_**, unsigned** _CRL_list_length_**, unsigned int** _flags_**, unsigned**
           **int ***_verify_**);**
    


## ARGUMENTS



           const gnutls_x509_crt_t * cert_list
                       is the certificate list to be verified
    
           unsigned cert_list_length
                       holds the number of certificate in cert_list
    
           const gnutls_x509_crt_t * CA_list
                       is the CA list which will be used in verification
    
           unsigned CA_list_length
                       holds the number of CA certificate in CA_list
    
           const gnutls_x509_crl_t * CRL_list
                       holds a list of CRLs.
    
           unsigned CRL_list_length
                       the length of CRL list.
    
           unsigned int flags
                       Flags that may be used to change the verification
                       algorithm. Use OR of the
                       gnutls_certificate_verify_flags enumerations.
    
           unsigned int * verify
                       will hold the certificate verification output.
    


## DESCRIPTION



           This function will try to verify the given certificate list and
           return its status. The details of the verification are the same as
           in **gnutls_x509_trust_list_verify_crt2()**.
    
           You must check the peer's name in order to check if the verified
           certificate belongs to the actual peer.
    
           The certificate verification output will be put in  _verify_ and
           will be one or more of the gnutls_certificate_status_t enumerated
           elements bitwise or'd.  For a more detailed verification status
           use **gnutls_x509_crt_verify()** per list element.
    


## RETURNS



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


* * *
# gnutls_store_commitment

## NAME



           gnutls_store_commitment - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_store_commitment(const char ***_db_name_**, gnutls_tdb_t**
           _tdb_**, const char ***_host_**, const char ***_service_**,**
           **gnutls_digest_algorithm_t** _hash_algo_**, const gnutls_datum_t ***_hash_**,**
           **time_t** _expiration_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * db_name
                       A file specifying the stored keys (use NULL for the
                       default)
    
           gnutls_tdb_t tdb
                       A storage structure or NULL to use the default
    
           const char * host
                       The peer's name
    
           const char * service
                       non-NULL if this key is specific to a service (e.g.
                       http)
    
           gnutls_digest_algorithm_t hash_algo
                       The hash algorithm type
    
           const gnutls_datum_t * hash
                       The raw hash
    
           time_t expiration
                       The expiration time (use 0 to disable expiration)
    
           unsigned int flags
                       should be 0 or **GNUTLS_SCOMMIT_FLAG_ALLOW_BROKEN**.
    


## DESCRIPTION



           This function will store the provided hash commitment to the list
           of stored public keys. The key with the given hash will be
           considered valid until the provided expiration time.
    
           The  _tdb_ variable if non-null specifies a custom backend for the
           storage of entries. If it is NULL then the default file backend
           will be used.
    
           Note that this function is not thread safe with the default
           backend.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# macro::json_output_string_value

## NAME



           macro::json_output_string_value - Output a string value.
    


## SYNOPSIS



               @json_output_string_value(name,value)
    


## ARGUMENTS



           _name_
               The name of the string metric.
    
           _value_
               The string value to output.
    


## DESCRIPTION



           The json_output_string_value macro is designed to be called from
           the 'json_data' probe in the user's script to output a metric's
           string value. This metric should have been added with
           **json_add_string_metric**.
    


* * *
# probe::kprocess.exit

## NAME



           probe::kprocess.exit - Exit from process
    


## SYNOPSIS



           kprocess.exit
    


## VALUES



           _code_
               The exit code of the process
    


## CONTEXT



           The process which is terminating.
    


## DESCRIPTION



           Fires when a process terminates. This will always be followed by a
           kprocess.release, though the latter may be delayed if the process
           waits in a zombie state.
    


* * *
# ctermid

## NAME



           ctermid - get controlling terminal name
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **char *ctermid(char ***_s_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **ctermid**():
               _POSIX_C_SOURCE
    


## DESCRIPTION



           **ctermid**() returns a string which is the pathname for the current
           controlling terminal for this process.  If _s_ is NULL, a static
           buffer is used, otherwise _s_ points to a buffer used to hold the
           terminal pathname.  The symbolic constant **L_ctermid** is the maximum
           number of characters in the returned pathname.
    


## RETURN VALUE



           The pointer to the pathname.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## BUGS



           The returned pathname may not uniquely identify the controlling
           terminal; it may, for example, be _/dev/tty_.
    
           It is not assured that the program can open the terminal.
    


* * *
# memset

## NAME



           memset - fill memory with a constant byte
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **void *memset(** size_t n;
                        **void** _s_**[**_n_**], int** _c_**, size_t** _n_**);**
    


## DESCRIPTION



           The **memset**() function fills the first _n_ bytes of the memory area
           pointed to by _s_ with the constant byte _c_.
    


## RETURN VALUE



           The **memset**() function returns a pointer to the memory area _s_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_alpn_get_selected_protocol

## NAME



           gnutls_alpn_get_selected_protocol - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_alpn_get_selected_protocol(gnutls_session_t** _session_**,**
           **gnutls_datum_t ***_protocol_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * protocol
                       will hold the protocol name
    


## DESCRIPTION



           This function allows you to get the negotiated protocol name. The
           returned protocol should be treated as opaque, constant value and
           only valid during the session life.
    
           The selected protocol is the first supported by the list sent by
           the client.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.
    
           Since 3.2.0
    


* * *
# probe::ipmib.InUnknownProtos

## NAME



           probe::ipmib.InUnknownProtos - Count arriving packets with an
           unbound proto
    


## SYNOPSIS



           ipmib.InUnknownProtos
    


## VALUES



           _skb_
               pointer to the struct sk_buff 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
           **ipmib_filter_key**. If the packet passes the filter is is counted in
           the global _InUnknownProtos_ (equivalent to SNMP's MIB
           IPSTATS_MIB_INUNKNOWNPROTOS)
    


* * *
# gnutls_x509_crq_get_extension_by_oid

## NAME



           gnutls_x509_crq_get_extension_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_extension_by_oid(gnutls_x509_crq_t** _crq_**,**
           **const char ***_oid_**, unsigned** _indx_**, void ***_buf_**, size_t ***_buf_size_**,**
           **unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * oid
                       holds an Object Identifier in a null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the extensions,
                       this specifies which to get. Use (0) to get the first
                       one.
    
           void * buf  a pointer to a structure to hold the name (may be
                       null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return the extension specified by the OID in
           the certificate.  The extensions will be returned as binary data
           DER encoded, in the provided buffer.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code in case of an error.  If the certificate does not
           contain the specified extension
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           2.8.0
    


* * *
# gnutls_record_uncork

## NAME



           gnutls_record_uncork - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int flags
                       Could be zero or **GNUTLS_RECORD_WAIT**
    


## DESCRIPTION



           This resets the effect of **gnutls_record_cork()** , and flushes any
           pending data. If the **GNUTLS_RECORD_WAIT** flag is specified then
           this function will block until the data is sent or a fatal error
           occurs (i.e., the function will retry on **GNUTLS_E_AGAIN** and
           **GNUTLS_E_INTERRUPTED**).
    
           If the flag **GNUTLS_RECORD_WAIT** is not specified and the function
           is interrupted then the **GNUTLS_E_AGAIN** or **GNUTLS_E_INTERRUPTED**
           errors will be returned. To obtain the data left in the corked
           buffer use **gnutls_record_check_corked()**.
    


## RETURNS



           On success the number of transmitted data is returned, or
           otherwise a negative error code.
    


## SINCE



           3.1.9
    


* * *
# gnutls_x509_privkey_get_key_id

## NAME



           gnutls_x509_privkey_get_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_get_key_id(gnutls_x509_privkey_t** _key_**,**
           **unsigned int** _flags_**, unsigned char ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           unsigned int flags
                       should be one of the flags from **gnutls_keyid_flags_t**
    
           unsigned char * output_data
                       will contain the key ID
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will return a unique ID that depends on the public
           key parameters. This ID can be used in checking whether a
           certificate corresponds to the given key.
    
           If the buffer provided is not long enough to hold the output, then
           * _output_data_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER**
           will be returned.  The output will normally be a SHA-1 hash
           output, which is 20 bytes.
    


## RETURNS



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


* * *
# readv

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



           readv — read a vector
    


## SYNOPSIS



           #include <sys/uio.h>
    
           ssize_t readv(int _fildes_ , const struct iovec *_iov_ , int _iovcnt_);
    


## DESCRIPTION



           The _readv_() function shall be equivalent to _read_(), except as
           described below. The _readv_() function shall place the input data
           into the _iovcnt_ buffers specified by the members of the _iov_ array:
           _iov_[0], _iov_[1], ..., _iov_[_iovcnt_ -1].  The _iovcnt_ argument is valid
           if greater than 0 and less than or equal to {IOV_MAX}.
    
           Each _iovec_ entry specifies the base address and length of an area
           in memory where data should be placed. The _readv_() function shall
           always fill an area completely before proceeding to the next.
    
           Upon successful completion, _readv_() shall mark for update the last
           data access timestamp of the file.
    


## RETURN VALUE



           Refer to read(3p).
    


## ERRORS



           Refer to read(3p).
    
           In addition, the _readv_() function shall fail if:
    
           **EINVAL** The sum of the _iov_len_ values in the _iov_ array overflowed
                  an **ssize_t**.
    
           The _readv_() function may fail if:
    
           **EINVAL** The _iovcnt_ argument was less than or equal to 0, or greater
                  than {IOV_MAX}.
    
           _The following sections are informative._
    


## EXAMPLES



       **Reading Data into an Array**
           The following example reads data from the file associated with the
           file descriptor _fd_ into the buffers specified by members of the
           _iov_ array.
    
               #include <sys/types.h>
               #include <sys/uio.h>
               #include <unistd.h>
               ...
               ssize_t bytes_read;
               int fd;
               char buf0[20];
               char buf1[30];
               char buf2[40];
               int iovcnt;
               struct iovec iov[3];
    
               iov[0].iov_base = buf0;
               iov[0].iov_len = sizeof(buf0);
               iov[1].iov_base = buf1;
               iov[1].iov_len = sizeof(buf1);
               iov[2].iov_base = buf2;
               iov[2].iov_len = sizeof(buf2);
               ...
               iovcnt = sizeof(iov) / sizeof(struct iovec);
    
               bytes_read = readv(fd, iov, iovcnt);
               ...
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to read(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# sprintf

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



           sprintf — print formatted output
    


## SYNOPSIS



           #include <stdio.h>
    
           int sprintf(char *restrict _s_ , const char *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fprintf(3p).
    


* * *
# __pmcleanmapdir

## NAME



           **__pmCleanMapDir** - remove old files from a map directory
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmCleanMapDir(const char ***_dirname_**, const char ***_special_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



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


## DESCRIPTION



           pmlogger(1) and pmie(1) maintain directories  of  map  files  that
           provide  a  mapping from a pmlogger(1) or pmie(1) process id (PID)
           to important parameters of those processes.
    
           **__pmCleanMapDir** removes  ``dead''  files  in  these  directories,
           specifically  the directory entries in _dirname_ should follow these
           rules, else **__pmCleanMapDir** will remove them:
    
           + the name should be numeric, else it should be equal _special_ (if
             _special_ is not NULL)
    
           + for a numeric directory entry it should be a regular file and
             the name should be the PID of a running process
    
           + for a match on _special_ the directory entry should be a symbolic
             link and the last component of the link should be the ASCII en‐
             coding of the PID of a running process
    
           Before any of these checks are done, **__pmCleanMapDir** checks that
           _dirname_ is indeed a directory, and the user id and group id of the
           caller match the user id and group id of _dirname_.
    


## RETURN VALUES



           If a serious error occurs, **__pmCleanMapDir** returns a negative val‐
           ue suitable for reporting with pmErrStr(3).  Otherwise the return
           value is the number of entries that have been removed.
    


## DIAGNOSTICS



           Verbose diagnostics describing the actions of **__pmCleanMapDir** will
           be reported on standard error of the debug option **misc** is set,
           e.g. via **-D misc** from the command line.
    


* * *
# gnutls_record_set_state

## NAME



           gnutls_record_set_state - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_record_set_state(gnutls_session_t** _session_**, unsigned**
           _read_**, const unsigned char [8]**_seq_number_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type
    
           unsigned read
                       if non-zero the read parameters are returned,
                       otherwise the write
    
           const unsigned char [8] seq_number
                       A 64-bit sequence number
    


## DESCRIPTION



           This function will set the sequence number in the current record
           state.  This function is useful if sending and receiving are
           offloaded from gnutls. That is, if **gnutls_record_get_state()** was
           used.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code.
    
           Since 3.4.0
    


* * *
# gnutls_pkcs12_bag_get_count

## NAME



           gnutls_pkcs12_bag_get_count - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_get_count(gnutls_pkcs12_bag_t** _bag_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    


## DESCRIPTION



           This function will return the number of the elements within the
           bag.
    


## RETURNS



           Number of elements in bag, or an negative error code on error.
    


* * *
# pcap_list_datalinks

## NAME



           pcap_list_datalinks, pcap_free_datalinks - get a list of link-
           layer header types supported by a capture device, and free that
           list
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_list_datalinks(pcap_t *p, int **dlt_buf);**
           **void pcap_free_datalinks(int *dlt_list);**
    


## DESCRIPTION



           **pcap_list_datalinks**() is used to get a list of the supported link-
           layer header types of the interface associated with the pcap
           descriptor.  **pcap_list_datalinks**() allocates an array to hold the
           list and sets _*dlt_buf_ to point to that array.
    
           The caller is responsible for freeing the array with
           **pcap_free_datalinks**(), which frees the list of link-layer header
           types pointed to by _dlt_list_.
    
           It must not be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).
    


## RETURN VALUE



           **pcap_list_datalinks**() returns the number of link-layer header
           types in the array on success, **PCAP_ERROR_NOT_ACTIVATED** if called
           on a capture handle that has been created but not activated, and
           **PCAP_ERROR** on other errors.  If **PCAP_ERROR** is returned,
           **pcap_geterr**(3PCAP) or **pcap_perror**(3PCAP) may be called with _p_ as
           an argument to fetch or display the error text.
    


* * *
# fexecve

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



           fexecve — execute a file
    


## SYNOPSIS



           #include <unistd.h>
    
           int fexecve(int _fd_ , char *const _argv[]_ , char *const _envp[]_);
    


## DESCRIPTION



           Refer to exec(1p).
    


* * *
# ccosh

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



           ccosh, ccoshf, ccoshl — complex hyperbolic cosine functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex ccosh(double complex _z_);
           float complex ccoshf(float complex _z_);
           long double complex ccoshl(long double complex _z_);
    


## DESCRIPTION



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


## RETURN VALUE



           These functions shall return the complex hyperbolic cosine value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_record_set_max_size

## NAME



           gnutls_record_set_max_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_set_max_size(gnutls_session_t** _session_**,**
           **size_t** _size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t size is the new size
    


## DESCRIPTION



           This function sets the maximum amount of plaintext sent and
           received in a record in this connection.
    
           Prior to 3.6.4, this function was implemented using a TLS
           extension called 'max fragment length', which limits the
           acceptable values to 512(=2^9), 1024(=2^10), 2048(=2^11) and
           4096(=2^12).
    
           Since 3.6.4, the limit is also negotiated through a new TLS
           extension called 'record size limit', which doesn't have the
           limitation, as long as the value ranges between 512 and 16384.
           Note that while the 'record size limit' extension is preferred,
           not all TLS implementations use or even understand the extension.
    


## DEPRECATED



           if the client can assume that the 'record size limit' extension is
           supported by the server, we recommend using
           **gnutls_record_set_max_recv_size()** instead.
    


## RETURNS



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


* * *
# ibnd_find_node_guid

## NAME



           ibnd_find_node_guid, ibnd_find_node_dr - given a fabric object
           find the node object within it which matches the guid or directed
           route specified.
    


## SYNOPSIS



           **#include <infiniband/ibnetdisc.h>**
    
           **ibnd_node_t *ibnd_find_node_guid(ibnd_fabric_t *fabric, uint64_t guid)**
           **ibnd_node_t *ibnd_find_node_dr(ibnd_fabric_t *fabric, char *dr_str)**
    


## DESCRIPTION



           **ibnd_find_node_guid()** Given a fabric object and a guid, return the
           ibnd_node_t object with that node guid.  **ibnd_find_node_dr()** Given
           a fabric object and a directed route, return the ibnd_node_t
           object with that directed route.
    


## RETURN VALUE



           **ibnd_find_node_guid(), ibnd_find_node_dr()** return NULL on failure,
           otherwise a valid ibnd_node_t object.
    


* * *
# gnutls_x509_crl_get_number

## NAME



           gnutls_x509_crl_get_number - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_number(gnutls_x509_crl_t** _crl_**, void ***_ret_**,**
           **size_t ***_ret_size_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           void * ret  The place where the number will be copied
    
           size_t * ret_size
                       Holds the size of the result field.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical (may be null)
    


## DESCRIPTION



           This function will return the CRL number extension.  This is
           obtained by the CRL Number extension field (2.5.29.20).
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code in case of an error.
    


## SINCE



           2.8.0
    


* * *
# rdma_ack_cm_event

## NAME



           rdma_ack_cm_event - Free a communication event.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_ack_cm_event (struct rdma_cm_event ***_event_**);**
    


## ARGUMENTS



           event       Event to be released.
    


## DESCRIPTION



           All events which are allocated by rdma_get_cm_event must be
           released, there should be a one-to-one correspondence between
           successful gets and acks.  This call frees the event structure and
           any memory that it references.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


* * *
# strfry

## NAME



           strfry - randomize a string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <string.h>**
    
           **char *strfry(char ***_string_**);**
    


## DESCRIPTION



           The **strfry**() function randomizes the contents of _string_ by
           randomly swapping characters in the string.  The result is an
           anagram of _string_.
    


## RETURN VALUE



           The **strfry**() functions returns a pointer to the randomized string.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


* * *
# gnutls_hmac_set_nonce

## NAME



           gnutls_hmac_set_nonce - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **void gnutls_hmac_set_nonce(gnutls_hmac_hd_t** _handle_**, const void ***
           _nonce_**, size_t** _nonce_len_**);**
    


## ARGUMENTS



           gnutls_hmac_hd_t handle
                       is a **gnutls_hmac_hd_t** type
    
           const void * nonce
                       the data to set as nonce
    
           size_t nonce_len
                       the length of data
    


## DESCRIPTION



           This function will set the nonce in the MAC algorithm.
    


## SINCE



           3.2.0
    


* * *
# gnutls_x509_privkey_import_openssl

## NAME



           gnutls_x509_privkey_import_openssl - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_openssl(gnutls_x509_privkey_t** _key_**,**
           **const gnutls_datum_t ***_data_**, const char ***_password_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_datum_t * data
                       The DER or PEM encoded key.
    
           const char * password
                       the password to decrypt the key (if it is encrypted).
    


## DESCRIPTION



           This function will convert the given PEM encrypted to the native
           gnutls_x509_privkey_t format. The output will be stored in  _key_ .
    
           The  _password_ should be in ASCII. If the password is not provided
           or wrong then **GNUTLS_E_DECRYPTION_FAILED** will be returned.
    
           If the Certificate is PEM encoded it should have a header of
           "PRIVATE KEY" and the "DEK-Info" header.
    


## RETURNS



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


* * *
# gnutls_x509_privkey_get_pk_algorithm

## NAME



           gnutls_x509_privkey_get_pk_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_get_pk_algorithm(gnutls_x509_privkey_t**
           _key_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    


## DESCRIPTION



           This function will return the public key algorithm of a private
           key.
    


## RETURNS



           a member of the **gnutls_pk_algorithm_t** enumeration on success, or a
           negative error code on error.
    


* * *
# gnutls_record_get_max_size

## NAME



           gnutls_record_get_max_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **size_t gnutls_record_get_max_size(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the record size.  The maximum record size is negotiated by the
           client after the first handshake message.
    


## RETURNS



           The maximum record packet size in this connection.
    


* * *
# gnutls_pkcs12_bag_set_privkey

## NAME



           gnutls_pkcs12_bag_set_privkey - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_set_privkey(gnutls_pkcs12_bag_t** _bag_**,**
           **gnutls_x509_privkey_t** _privkey_**, const char ***_password_**, unsigned**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           gnutls_x509_privkey_t privkey
                       the private key to be copied.
    
           const char * password
                       the password to protect the key with (may be **NULL**)
    
           unsigned flags
                       should be one of **gnutls_pkcs_encrypt_flags_t** elements
                       bitwise or'd
    


## DESCRIPTION



           This function will insert the given private key into the bag. This
           is just a wrapper over **gnutls_pkcs12_bag_set_data()**.
    


## RETURNS



           the index of the added bag on success, or a negative value on
           failure.
    


* * *