tripathysagar/man_text huggingface dataset:
# setprotoent

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



           setprotoent — network protocol database functions
    


## SYNOPSIS



           #include <netdb.h>
    
           void setprotoent(int _stayopen_);
    


## DESCRIPTION



           Refer to endprotoent(3p).
    


* * *
# gets

## NAME



           gets - get a string from standard input (DEPRECATED)
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **[[deprecated]] char *gets(char ***_s_**);**
    


## DESCRIPTION



           _Never use this function_.
    
           **gets**() reads a line from _stdin_ into the buffer pointed to by _s_
           until either a terminating newline or **EOF** , which it replaces with
           a null byte ('\0').  No check for buffer overrun is performed (see
           BUGS below).
    


## RETURN VALUE



           **gets**() returns _s_ on success, and NULL on error or when end of file
           occurs while no characters have been read.  However, given the
           lack of buffer overrun checking, there can be no guarantees that
           the function will even return.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## BUGS



           Never use **gets**().  Because it is impossible to tell without
           knowing the data in advance how many characters **gets**() will read,
           and because **gets**() will continue to store characters past the end
           of the buffer, it is extremely dangerous to use.  It has been used
           to break computer security.  Use **fgets**() instead.
    
           For more information, see CWE-242 (aka "Use of Inherently
           Dangerous Function") at
           http://cwe.mitre.org/data/definitions/242.html
    


* * *
# gnutls_init

## NAME



           gnutls_init - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t * session
                       is a pointer to a **gnutls_session_t** type.
    
           unsigned int flags
                       indicate if this session is to be used for server or
                       client.
    


## DESCRIPTION



           This function initializes the provided session. Every session must
           be initialized before use, and after successful initialization and
           use must be deinitialized by calling **gnutls_deinit()**.
    
            _flags_ can be any combination of flags from **gnutls_init_flags_t**.
    
           Note that since version 3.1.2 this function enables some common
           TLS extensions such as session tickets and OCSP certificate status
           request in client side by default. To prevent that use the
           **GNUTLS_NO_DEFAULT_EXTENSIONS** flag.
    
           Note that it is never mandatory to use **gnutls_deinit()** after this
           function fails.  Since gnutls 3.8.0, it is safe to unconditionally
           use **gnutls_deinit()** even after failure regardless of whether the
           memory was initialized prior to **gnutls_init()** ; however, clients
           wanting to be portable to older versions of the library should
           either skip deinitialization on failure, or pre-initialize the
           memory passed in to **gnutls_init()** to all zeroes via **memset()** or
           similar.
    


## RETURNS



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


* * *
# gnutls_privkey_generate

## NAME



           gnutls_privkey_generate - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_generate(gnutls_privkey_t** _pkey_**,**
           **gnutls_pk_algorithm_t** _algo_**, unsigned int** _bits_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       An initialized private key
    
           gnutls_pk_algorithm_t algo
                       is one of the algorithms in **gnutls_pk_algorithm_t**.
    
           unsigned int bits
                       the size of the parameters to generate
    
           unsigned int flags
                       Must be zero or flags from **gnutls_privkey_flags_t**.
    


## DESCRIPTION



           This function will generate a random private key. Note that this
           function must be called on an initialized private key.
    
           The flag **GNUTLS_PRIVKEY_FLAG_PROVABLE** instructs the key generation
           process to use algorithms like Shawe-Taylor (from FIPS PUB186-4)
           which generate provable parameters out of a seed for RSA and DSA
           keys. See **gnutls_privkey_generate2()** for more information.
    
           Note that when generating an elliptic curve key, the curve can be
           substituted in the place of the bits parameter using the
           **GNUTLS_CURVE_TO_BITS()** macro. The input to the macro is any curve
           from **gnutls_ecc_curve_t**.
    
           For DSA keys, if the subgroup size needs to be specified check the
           **GNUTLS_SUBGROUP_TO_BITS()** macro.
    
           It is recommended to do not set the number of  _bits_ directly, use
           **gnutls_sec_param_to_pk_bits()** instead .
    
           See also **gnutls_privkey_generate2()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_x509_crq_set_private_key_usage_period

## NAME



           gnutls_x509_crq_set_private_key_usage_period - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_private_key_usage_period(gnutls_x509_crq_t**
           _crq_**, time_t** _activation_**, time_t** _expiration_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate of type **gnutls_x509_crq_t**
    
           time_t activation
                       The activation time
    
           time_t expiration
                       The expiration time
    


## DESCRIPTION



           This function will set the private key usage period extension
           (2.5.29.16).
    


## RETURNS



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


* * *
# selabel_partial_match

## NAME



           selabel_partial_match - determine whether a direct or partial
           match is possible on a file path - Only supported on file backend.
    


## SYNOPSIS



           **#include <stdbool.h>**
           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **bool selabel_partial_match(struct selabel_handle ***_hnd_**,**
                                     **const char ***_key_**);**
    


## DESCRIPTION



           **selabel_partial_match**() performs a partial match operation on the
           handle _hnd_ , returning TRUE or FALSE.  The _key_ parameter is a file
           path to check for a direct or partial match.
    


## RETURN VALUE



           TRUE is returned if a direct or partial match is found, FALSE if
           not.
    


* * *
# function::kernel_string_quoted_utf16

## NAME



           function::kernel_string_quoted_utf16 - Quote given kernel UTF-16
           string.
    


## SYNOPSIS



               kernel_string_quoted_utf16:string(addr:long)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    


## DESCRIPTION



           This function combines quoting as per _string_quoted_ and UTF-16
           decoding as per _kernel_string_utf16_.
    


* * *
# capng_lock

## NAME



           capng_lock - lock the current process capabilities settings
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_lock(void);
    


## DESCRIPTION



           capng_lock will take steps to prevent children of the current
           process to regain full privileges if the uid is 0. This should be
           called while possessing the CAP_SETPCAP capability in the kernel.
           This function will do the following if permitted by the kernel:
           Set the NOROOT option on for PR_SET_SECUREBITS, set the
           NOROOT_LOCKED option to on for PR_SET_SECUREBITS, set the
           PR_NO_SETUID_FIXUP option on for PR_SET_SECUREBITS, and set the
           PR_NO_SETUID_FIXUP_LOCKED option on for PR_SET_SECUREBITS.
    


## RETURN VALUE



           This returns 0 on success and a negative number on failure. -1
           means a failure setting any of the PR_SET_SECUREBITS options.
    


* * *
# gnutls_transport_set_push_function

## NAME



           gnutls_transport_set_push_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_push_function(gnutls_session_t** _session_**,**
           **gnutls_push_func** _push_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_push_func push_func
                       a callback function similar to **write()**
    


## DESCRIPTION



           This is the function where you set a push function for gnutls to
           use in order to send data.  If you are going to use berkeley style
           sockets, you do not need to use this function since the default
           send(2) will probably be ok.  Otherwise you should specify this
           function for gnutls to be able to send data.  The callback should
           return a positive number indicating the bytes sent, and -1 on
           error.
    
            _push_func_ is of the form, ssize_t
           (*gnutls_push_func)(gnutls_transport_ptr_t, const void*, size_t);
    


* * *
# selabel_get_digests_all_partial_matches

## NAME



           selabel_get_digests_all_partial_matches - retrieve the partial
           matches digest and the xattr digest that applies to the supplied
           path - Only supported on file backend.
    


## SYNOPSIS



           **#include <stdbool.h>**
           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **bool selabel_get_digests_all_partial_matches(**
                                                   **struct selabel_handle**
                                                   *****_hnd_**,**
                                                   **const char ***_key_**,**
                                                   **uint8_t**
                                                   ******_calculated_digest_**,**
                                                   **uint8_t ****_xattr_digest_**,**
                                                   **size_t ***_digest_len_**);**
    


## DESCRIPTION



           **selabel_get_digests_all_partial_matches**() retrieves the
           file_contexts partial matches digest and the xattr digest that
           applies to the supplied path on the handle _hnd_.
           The _key_ parameter is the path to retrieve the digests.
           The _calculated_digest_ is a pointer to the _key_ calculated
           file_contexts digest of all applicable partial matches, or NULL if
           none exist. The caller must free(3) the buffer.
           The _xattr_digest_ is a pointer to the _key_ xattr(7) stored digest,
           or NULL if it does not exist.  The caller must free(3) the buffer.
           The _digest_len_ is the length of the digests that will always be
           returned (even if both are NULL). Note that if both digests are
           returned, they will always be the same length.
    


## RETURN VALUE



           TRUE if the digests match or FALSE if they do not or either or
           both are missing.
    


* * *
# probe::signal.systkill.return

## NAME



           probe::signal.systkill.return - Sending kill signal to a thread
           completed
    


## SYNOPSIS



           signal.systkill.return
    


## VALUES



           _name_
               Name of the probe point
    
           _retstr_
               The return value to either __group_send_sig_info,
    


* * *
# io_uring_wait_cqe_timeout

## NAME



           io_uring_wait_cqe_timeout - wait for one io_uring completion event
           with timeout
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_wait_cqe_timeout(struct io_uring ***_ring_**,**
                                         **struct io_uring_cqe ****_cqe_ptr_**,**
                                         **struct __kernel_timespec ***_ts_**);**
    


## DESCRIPTION



           The io_uring_wait_cqe_timeout(3) function waits for one IO
           completion to be available from the queue belonging to the _ring_
           param, waiting for it if necessary or until the timeout _ts_
           expires. If an event is already available in the ring when
           invoked, no waiting will occur.
    
           The _cqe_ptr_ param is filled in on success.
    
           If _ts_ is specified and an older kernel without **IORING_FEAT_EXT_ARG**
           is used, the application does not need to call io_uring_submit(3)
           before calling io_uring_wait_cqes(3).  For newer kernels with that
           feature flag set, there is no implied submit when waiting for a
           request.
    
           If _ts_ is **NULL ,** then this behaves like io_uring_wait_cqe(3) in
           that it will wait forever for an event.
    


## RETURN VALUE



           On success io_uring_wait_cqe_timeout(3) returns 0 and the cqe_ptr
           param is filled in. On failure it returns **-errno**.  The return
           value indicates the result of waiting for a CQE, and it has no
           relation to the CQE result itself. If a timeout occurs, it will
           return **-ETIME**.
    


* * *
# function::read_stopwatch_ms

## NAME



           function::read_stopwatch_ms - Reads the time in milliseconds for a
           stopwatch
    


## SYNOPSIS



               read_stopwatch_ms:long(name:string)
    


## ARGUMENTS



           _name_
               stopwatch name
    


## DESCRIPTION



           Returns time in milliseconds for stopwatch _name_. Creates stopwatch
           _name_ if it does not currently exist.
    


* * *
# posix_trace_get_status

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



           posix_trace_get_status — retrieve the trace status (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_get_status(trace_id_t _trid_ ,
               struct posix_trace_status_info *_statusinfo_);
    


## DESCRIPTION



           Refer to posix_trace_get_attr(3p).
    


* * *
# gnutls_x509_crl_deinit

## NAME



           gnutls_x509_crl_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crl_deinit(gnutls_x509_crl_t** _crl_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       The data to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a CRL structure.
    


* * *
# probe::socket.sendmsg.return

## NAME



           probe::socket.sendmsg.return - Return from socket.sendmsg.
    


## SYNOPSIS



           socket.sendmsg.return
    


## VALUES



           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    
           _size_
               Size of message sent (in bytes) or error code if success = 0
    
           _family_
               Protocol family value
    
           _success_
               Was send successful? (1 = yes, 0 = no)
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender.
    


## DESCRIPTION



           Fires at the conclusion of sending a message on a socket via the
           **sock_sendmsg** function
    


* * *
# mlx5dv_query_qp_lag_port

## NAME



           mlx5dv_query_qp_lag_port - Query the lag port information of a
           given QP
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_query_qp_lag_port(struct ibv_qp *qp, uint8_t *port_num,
                                   uint8_t *active_port_num);
    


## DESCRIPTION



           This API returns the configured and active port num of a given QP
           in mlx5 devices.
    
           The active port num indicates which port that the QP sends traffic
           out in a LAG configuration.
    
           The num_lag_ports field of struct mlx5dv_context greater than 1
           means LAG is supported on this device.
    


## ARGUMENTS



           _qp_     The ibv_qp object to issue the action on.
    
           _port_num_
                  The configured port num of the QP.
    
           _active_port_num_
                  The current port num of the QP, which may different from
                  the configured value because of the bonding status.
    


## RETURN VALUE



           0 on success; EOPNOTSUPP if not in LAG mode, or other errno value
           on other failures.
    


* * *
# pcap_lookupnet

## NAME



           pcap_lookupnet - find the IPv4 network number and netmask for a
           device
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **char errbuf[PCAP_ERRBUF_SIZE];**
    
           **int pcap_lookupnet(const char *device, bpf_u_int32 *netp,**
               **bpf_u_int32 *maskp, char *errbuf);**
    


## DESCRIPTION



           **pcap_lookupnet**() is used to determine the IPv4 network number and
           mask associated with the network device _device_.  Both _netp_ and
           _maskp_ are **bpf_u_int32** pointers, on success both values will be set
           in network byte order.  _errbuf_ is a buffer large enough to hold at
           least **PCAP_ERRBUF_SIZE** chars.
    
           This function is not available on Windows.  It supports neither
           IPv6 nor multiple IPv4 addresses per interface, which obviously is
           not practical in modern networks.  See **pcap_findalldevs**(3PCAP) for
           a more elaborate solution to the problem.
    


## RETURN VALUE



           **pcap_lookupnet**() returns **0** on success and **PCAP_ERROR** on failure.
           If **PCAP_ERROR** is returned, _errbuf_ is filled in with an appropriate
           error message.
    


* * *
# gnutls_x509_ext_export_key_purposes

## NAME



           gnutls_x509_ext_export_key_purposes - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_key_purposes(gnutls_x509_key_purposes_t**
           _p_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           gnutls_x509_key_purposes_t p
                       The key purposes
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the key purposes type to a DER-encoded
           PKIX ExtKeyUsageSyntax (2.5.29.37) extension. The output data in
            _ext_ will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# bstring

## NAME



           bcmp, bcopy, bzero, memccpy, memchr, memcmp, memcpy, memfrob,
           memmem, memmove, memset - byte string operations
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **int bcmp(** size_t n;
                    **const void** _s1_**[**_n_**], const void** _s2_**[**_n_**], size_t** _n_**);**
    
           **void bcopy(** size_t n;
                    **const void** _src_**[**_n_**], void** _dest_**[**_n_**], size_t** _n_**);**
    
           **void bzero(** size_t n;
                    **void** _s_**[**_n_**], size_t** _n_**);**
    
           **void *memccpy(** size_t n;
                    **void** _dest_**[**_n_**], const void** _src_**[**_n_**], int** _c_**, size_t** _n_**);**
    
           **void *memchr(** size_t n;
                    **const void** _s_**[**_n_**], int** _c_**, size_t** _n_**);**
    
           **int memcmp(** size_t n;
                    **const void** _s1_**[**_n_**], const void** _s2_**[**_n_**], size_t** _n_**);**
    
           **void *memcpy(** size_t n;
                    **void** _dest_**[**_n_**], const void** _src_**[**_n_**], size_t** _n_**);**
    
           **void *memfrob(** size_t n;
                    **void** _s_**[**_n_**], size_t** _n_**);**
    
           **void *memmem(** size_t hsize, size_t nsize;
                        **const void** _haystack_**[**_hsize_**], size_t** _hsize_**,**
                        **const void** _needle_**[**_nsize_**], size_t** _nsize_**);**
    
           **void *memmove(** size_t n;
                    **void** _dest_**[**_n_**], const void** _src_**[**_n_**], size_t** _n_**);**
    
           **void *memset(** size_t n;
                    **void** _s_**[**_n_**], int** _c_**, size_t** _n_**);**
    


## DESCRIPTION



           The byte string functions perform operations on strings (byte
           arrays) that are not necessarily null-terminated.  See the
           individual man pages for descriptions of each function.
    


## NOTES



           The functions **bcmp**() and **bcopy**() are obsolete.  Use **memcmp**() and
           **memmove**() instead.
    


* * *
# dysize

## NAME



           dysize - get number of days for a given year
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **int dysize(int** _year_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **dysize**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The function returns 365 for a normal year and 366 for a leap
           year.  The calculation for leap year is based on:
    
               (year) %4 == 0 && ((year) %100 != 0 || (year) %400 == 0)
    
           The formula is defined in the macro ___isleap(year)_ also found in
           _< time.h>_.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# tep_parse_event

## NAME



           tep_parse_event, tep_parse_format - Parse the event format
           information
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           enum tep_errno **tep_parse_event**(struct tep_handle *_tep_ , const char *_buf_ , unsigned long _size_ , const char *_sys_);
           enum tep_errno **tep_parse_format**(struct tep_handle *_tep_ , struct tep_event **_eventp_ , const char *_buf_ , unsigned long _size_ , const char *_sys_);
    


## DESCRIPTION



           The **tep_parse_event()** function parses the event format and creates
           an event structure to quickly parse raw data for a given event.
           The _tep_ argument is the trace event parser context. The created
           event structure is stored in the _tep_ context. The _buf_ argument is
           a buffer with _size_ , where the event format data is. The event
           format data can be taken from tracefs/events/.../.../format files.
           The _sys_ argument is the system of the event.
    
           The **tep_parse_format()** function does the same as
           **tep_parse_event()**. The only difference is in the extra _eventp_
           argument, where the newly created event structure is returned.
    


## RETURN VALUE



           Both **tep_parse_event()** and **tep_parse_format()** functions return 0
           on success, or TEP_ERRNO__... in case of an error.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               char *buf;
               int size;
               struct tep_event *event = NULL;
               buf = read_file("/sys/kernel/tracing/events/ftrace/print/format", &size);
               if (tep_parse_event(tep, buf, size, "ftrace") != 0) {
                       /* Failed to parse the ftrace print format */
               }
    
               if (tep_parse_format(tep, &event, buf, size, "ftrace") != 0) {
                       /* Failed to parse the ftrace print format */
               }
               ...
    


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


* * *
# pmfreeeventresult

## NAME



           **pmFreeHighResEventResult** , **pmFreeEventResult** - release storage
           allocated for unpacked event records
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmFreeHighResEventResult(pmResult ****_hrset_**);**
           **void pmFreeEventResult(pmResult_v2 ****_rset_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           When  processing  event records, if pmUnpackHighResEventRecords(3)
           is used to unpack event records from a metric  within  a  _pmResult_
           structure  with  a  value  of  type **PM_TYPE_HIGHRES_EVENT** then the
           structure returned from pmUnpackHighResEventRecords(3) is  a  NULL
           pointer  terminated  array of pointers to _pmResult_ structures, one
           for each event record.
    
           **pmFreeHighResEventResult** is a convenience method that frees all of
           the _pmResult_ structures and the array of pointers (_hrset_).
    
           Similarly, **pmFreeEventResult** may be used to free  the  _pmResult_v2_
           structures  and  array returned from the **pmUnpackEventRecords** rou‐
           tine when using **PM_TYPE_EVENT** metrics.
    


* * *
# gnutls_x509_aia_get

## NAME



           gnutls_x509_aia_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aia_get(gnutls_x509_aia_t** _aia_**, unsigned int** _seq_**,**
           **gnutls_datum_t ***_oid_**, unsigned ***_san_type_**, gnutls_datum_t ***_san_**);**
    


## ARGUMENTS



           gnutls_x509_aia_t aia
                       The authority info access
    
           unsigned int seq
                       specifies the sequence number of the access descriptor
                       (0 for the first one, 1 for the second etc.)
    
           gnutls_datum_t * oid
                       the type of available data; to be treated as constant.
    
           unsigned * san_type
                       Will hold the type of the name of
                       **gnutls_subject_alt_names_t**(may be null).
    
           gnutls_datum_t * san
                       the access location name; to be treated as constant
                       (may be null).
    


## DESCRIPTION



           This function reads from the Authority Information Access type.
    
           The  _seq_ input parameter is used to indicate which member of the
           sequence the caller is interested in.  The first member is 0, the
           second member 1 and so on.  When the  _seq_ value is out of bounds,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    
           Typically  _oid_ is **GNUTLS_OID_AD_CAISSUERS** or **GNUTLS_OID_AD_OCSP**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# function::user_buffer_quoted_error

## NAME



           function::user_buffer_quoted_error - Retrieves and quotes buffer
           from user space
    


## SYNOPSIS



               user_buffer_quoted_error:string(addr:long,inlen:long,outlen:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the buffer from
    
           _inlen_
               the exact length of the buffer to read
    
           _outlen_
               the maximum length of the output string
    


## DESCRIPTION



           Reads inlen characters of a buffer from the given user space
           memory address, and returns up to outlen characters, where any
           ASCII characters that are not printable are replaced by the
           corresponding escape sequence in the returned string. Note that
           the string will be surrounded by double quotes. On the rare cases
           when user space data is not accessible at the given address, an
           error is thrown.
    


* * *
# probe::netfilter.ip.post_routing

## NAME



           probe::netfilter.ip.post_routing - Called immediately before an
           outgoing IP packet leaves the computer
    


## SYNOPSIS



           netfilter.ip.post_routing
    


## VALUES



           _saddr_
               A string representing the source IP address
    
           _fin_
               TCP FIN flag (if protocol is TCP; ipv4 only)
    
           _syn_
               TCP SYN flag (if protocol is TCP; ipv4 only)
    
           _daddr_
               A string representing the destination IP address
    
           _urg_
               TCP URG flag (if protocol is TCP; ipv4 only)
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _rst_
               TCP RST flag (if protocol is TCP; ipv4 only)
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _ipproto_tcp_
               Constant used to signify that the packet protocol is TCP
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _sport_
               TCP or UDP source port (ipv4 only)
    
           _pf_
               Protocol family -- either “ipv4” or “ipv6”
    
           _iphdr_
               Address of IP header
    
           _dport_
               TCP or UDP destination port (ipv4 only)
    
           _psh_
               TCP PSH flag (if protocol is TCP; ipv4 only)
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _ipproto_udp_
               Constant used to signify that the packet protocol is UDP
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _family_
               IP address family
    
           _data_str_
               A string representing the packet buffer contents
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _protocol_
               Packet protocol from driver (ipv4 only)
    
           _ack_
               TCP ACK flag (if protocol is TCP; ipv4 only)
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    


* * *
# gnutls_certificate_set_ocsp_status_request_function2

## NAME



           gnutls_certificate_set_ocsp_status_request_function2 - API
           function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_ocsp_status_request_function2(gnutls_certificate_credentials_t**
           _sc_**, unsigned** _idx_**, gnutls_status_request_ocsp_func** _ocsp_func_**, void**
           *****_ptr_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    
           unsigned idx
                       is a certificate index as returned by
                       **gnutls_certificate_set_key()** and friends
    
           gnutls_status_request_ocsp_func ocsp_func
                       function pointer to OCSP status request callback.
    
           void * ptr  opaque pointer passed to callback function
    


## DESCRIPTION



           This function is to be used by server to register a callback to
           provide OCSP status requests that correspond to the indexed
           certificate chain from the client.  The callback will be invoked
           if the client supplied a status-request OCSP extension.
    
           The callback function prototype is:
    
           typedef int (*gnutls_status_request_ocsp_func) (gnutls_session_t
           session, void *ptr, gnutls_datum_t *ocsp_response);
    
           The callback will be invoked if the client requests an OCSP
           certificate status.  The callback may return
           **GNUTLS_E_NO_CERTIFICATE_STATUS** , if there is no recent OCSP
           response. If the callback returns **GNUTLS_E_SUCCESS** , it is expected
           to have the  _ocsp_response_ field set with a valid (DER-encoded)
           OCSP response. The response must be a value allocated using
           **gnutls_malloc()** , and will be deinitialized by the caller.
    


## NOTE



           the ability to set multiple OCSP responses per credential
           structure via the index  _idx_ was added in version 3.5.6. To keep
           backwards compatibility, it requires using
           **gnutls_certificate_set_flags()** with the **GNUTLS_CERTIFICATE_API_V2**
           flag to make the set certificate functions return an index usable
           by this function.
    


## RETURNS



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


## SINCE



           3.5.5
    


* * *
# function::fp_lt

## NAME



           function::fp_lt - fp comparison function less than
    


## SYNOPSIS



               fp_lt:long(infp1:long,infp2:long)
    


## ARGUMENTS



           _infp1_
               the 64 bit floating point input
    
           _infp2_
               second 64 bit floating point input
    


## DESCRIPTION



           check if infp1 is strictly less than infp2
    


* * *
# wcsncasecmp

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



           wcsncasecmp, wcsncasecmp_l — case-insensitive wide-character
           string comparison
    


## SYNOPSIS



           #include <wchar.h>
    
           int wcsncasecmp(const wchar_t *_ws1_ , const wchar_t *_ws2_ , size_t _n_);
           int wcsncasecmp_l(const wchar_t *_ws1_ , const wchar_t *_ws2_ ,
               size_t _n_ , locale_t _locale_);
    


## DESCRIPTION



           Refer to wcscasecmp(3p).
    


* * *
# function::task_current

## NAME



           function::task_current - The current task_struct of the current
           task
    


## SYNOPSIS



               task_current:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the task_struct representing the current
           process. This address can be passed to the various task_*()
           functions to extract more task-specific data.
    


* * *
# fflush

## NAME



           fflush - flush a stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           For output streams, **fflush**() forces a write of all user-space
           buffered data for the given output or update _stream_ via the
           stream's underlying write function.
    
           For input streams associated with seekable files (e.g., disk
           files, but not pipes or terminals), **fflush**() discards any buffered
           data that has been fetched from the underlying file, but has not
           been consumed by the application.
    
           The open status of the stream is unaffected.
    
           If the _stream_ argument is NULL, **fflush**() flushes _all_ open output
           streams.
    
           For a nonlocking counterpart, see unlocked_stdio(3).
    


## RETURN VALUE



           Upon successful completion 0 is returned.  Otherwise, **EOF** is
           returned and _errno_ is set to indicate the error.
    


## ERRORS



           **EBADF** _stream_ is not an open stream, or is not open for writing.
    
           The function **fflush**() may also fail and set _errno_ for any of the
           errors specified for write(2).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           Note that **fflush**() flushes only the user-space buffers provided by
           the C library.  To ensure that the data is physically stored on
           disk the kernel buffers must be flushed too, for example, with
           sync(2) or fsync(2).
    


* * *
# gnutls_aead_cipher_init

## NAME



           gnutls_aead_cipher_init - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_aead_cipher_init(gnutls_aead_cipher_hd_t ***_handle_**,**
           **gnutls_cipher_algorithm_t** _cipher_**, const gnutls_datum_t ***_key_**);**
    


## ARGUMENTS



           gnutls_aead_cipher_hd_t * handle
                       is a **gnutls_aead_cipher_hd_t** type.
    
           gnutls_cipher_algorithm_t cipher
                       the authenticated-encryption algorithm to use
    
           const gnutls_datum_t * key
                       The key to be used for encryption
    


## DESCRIPTION



           This function will initialize an context that can be used for
           encryption/decryption of data. This will effectively use the
           current crypto backend in use by gnutls or the cryptographic
           accelerator in use.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.4.0
    


* * *
# selinux_restorecon_default_handle

## NAME



           selinux_restorecon_default_handle - sets default parameters for
           selinux_restorecon(3)
    


## SYNOPSIS



           **#include <selinux/restorecon.h>**
           **#include <selinux/label.h>**
    
           **struct selabel_handle *selinux_restorecon_default_handle(void);**
    


## DESCRIPTION



           **selinux_restorecon_default_handle**() sets default parameters for
           selinux_restorecon(3) by calling selabel_open(3) with the
           **SELABEL_OPT_DIGEST** option only. This will enable a digest to be
           calculated on the currently loaded policy file_contexts(5) set of
           files as described in the **NOTES** section of selinux_restorecon(3).
    
           Calling **selinux_restorecon_default_handle**() is optional, however
           if used then selinux_restorecon_set_sehandle(3) should be called
           with the returned handle to set this for use by
           selinux_restorecon(3).
    
           **selinux_restorecon_default_handle**() is optional as
           selinux_restorecon(3) will automatically call this and
           selinux_restorecon_set_sehandle(3) provided a handle has not
           already been set, for example by
           selinux_restorecon_set_sehandle(3) to set customised
           selabel_open(3) parameters.
    


## RETURN VALUE



           A non-NULL handle value is returned on success. On error, NULL is
           returned and _errno_ is set appropriately.
    


* * *
# gnutls_pubkey_get_key_id

## NAME



           gnutls_pubkey_get_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_get_key_id(gnutls_pubkey_t** _key_**, unsigned int**
           _flags_**, unsigned char ***_output_data_**, size_t ***_output_data_size_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public 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 public 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



           In case of failure a negative error code will be returned, and 0
           on success.
    


## SINCE



           2.12.0
    


* * *
# pmiputresult

## NAME



           **pmiPutResult** - add a data record to a LOGIMPORT archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **int pmiPutResult(const pmResult ***_result_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiPutResult** provides an interface  for  developers
           familiar  with  the  internal PCP data structures to create output
           archives directly.
    
           By building the **pmResult** data  structure  directly,  then  calling
           **pmiPutResult** the  developer avoids calls to pmiPutValue(3) and/or
           pmiPutValueHandle(3) followed by a call to  pmiWrite(3)  for  each
           record written to the archive.
    
           Any  metrics  and instances appearing in the _result_ must have been
           defined by prior calls to pmiAddMetric(3) and pmiAddInstance(3).
    
           **pmiPutResult** will arrange for any new metadata (metrics and/or in‐
           stance domain changes) covered by _result_ to be also written to the
           PCP archive.
    
           Because of the complexity of the  **pmResult** data  structure,  this
           routine  is  not  available in the Perl interface to the LOGIMPORT
           services.
    


## DIAGNOSTICS



           **pmiPutResult** returns zero on success else a  negative  value  that
           can be turned into an error message by calling pmiErrStr(3).
    


* * *
# function::substr

## NAME



           function::substr - Returns a substring
    


## SYNOPSIS



               substr:string(str:string,start:long,length:long)
    


## ARGUMENTS



           _str_
               the string to take a substring from
    
           _start_
               starting position of the extracted string (first character is
               0)
    
           _length_
               length of string to return
    


## DESCRIPTION



           Returns the substring of the given string at the given start
           position with the given length (or smaller if the length of the
           original string is less than start + length, or length is bigger
           than MAXSTRINGLEN).
    


* * *
# closedir

## NAME



           closedir - close a directory
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <dirent.h>**
    
           **int closedir(DIR ***_dirp_**);**
    


## DESCRIPTION



           The **closedir**() function closes the directory stream associated
           with _dirp_.  A successful call to **closedir**() also closes the
           underlying file descriptor associated with _dirp_.  The directory
           stream descriptor _dirp_ is not available after this call.
    


## RETURN VALUE



           The **closedir**() function returns 0 on success.  On error, -1 is
           returned, and _errno_ is set to indicate the error.
    


## ERRORS



           **EBADF** Invalid directory stream descriptor _dirp_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *