tripathysagar/man_text huggingface dataset:
# tep_get_cpus

## NAME



           tep_get_cpus, tep_set_cpus - Get / set the number of CPUs, which
           have a tracing buffer representing it. Note, the buffer may be
           empty.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           int **tep_get_cpus**(struct tep_handle *_tep_);
           void **tep_set_cpus**(struct tep_handle *_tep_ , int _cpus_);
    


## DESCRIPTION



           The **tep_get_cpus()** function gets the number of CPUs, which have a
           tracing buffer representing it. The _tep_ argument is trace event
           parser context.
    
           The **tep_set_cpus()** function sets the number of CPUs, which have a
           tracing buffer representing it. The _tep_ argument is trace event
           parser context. The _cpu_ argument is the number of CPUs with
           tracing data.
    


## RETURN VALUE



           The **tep_get_cpus()** functions returns the number of CPUs, which
           have tracing data recorded.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
                       tep_set_cpus(tep, 5);
               ...
                       printf("We have tracing data for %d CPUs", tep_get_cpus(tep));
    


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


* * *
# time_t

## NAME



           time_t, suseconds_t, useconds_t - integer time
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **typedef** /* ... */  **time_t;**
    
           **#include <sys/types.h>**
    
           **typedef** /* ... */  **suseconds_t;**
           **typedef** /* ... */  **useconds_t;**
    


## DESCRIPTION



           _time_t_ Used for time in seconds.  According to POSIX, it is an
                  integer type.
    
           _suseconds_t_
                  Used for time in microseconds.  It is a signed integer type
                  capable of storing values at least in the range [**-1** ,
                  **1000000**].
    
           _useconds_t_
                  Used for time in microseconds.  It is an unsigned integer
                  type capable of storing values at least in the range [**0** ,
                  **1000000**].
    


## STANDARDS



           _time_t_ C11, POSIX.1-2008.
    
           _suseconds_t_
           _useconds_t_
                  POSIX.1-2008.
    


## NOTES



           On some architectures, the width of _time_t_ can be controlled with
           the feature test macro **_TIME_BITS**.  See feature_test_macros(7).
    
           The following headers also provide _time_t_ : _< sched.h>_, _< sys/msg.h>_,
           _< sys/select.h>_, _< sys/sem.h>_, _< sys/shm.h>_, _< sys/stat.h>_,
           _< sys/time.h>_, _< sys/types.h>_, and _< utime.h>_.
    
           The following headers also provide _suseconds_t_ : _< sys/select.h>_ and
           _< sys/time.h>_.
    


* * *
# gnutls_x509_ext_import_subject_key_id

## NAME



           gnutls_x509_ext_import_subject_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_subject_key_id(const gnutls_datum_t ***
           _ext_**, gnutls_datum_t ***_id_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       a DER encoded extension
    
           gnutls_datum_t * id
                       will contain the subject key ID
    


## DESCRIPTION



           This function will return the subject key ID stored in the
           provided SubjectKeyIdentifier extension. The ID will be allocated
           using **gnutls_malloc()**.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# probe::ipmib.InNoRoutes

## NAME



           probe::ipmib.InNoRoutes - Count an arriving packet with no
           matching socket
    


## SYNOPSIS



           ipmib.InNoRoutes
    


## 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 _InNoRoutes_ (equivalent to SNMP's MIB
           IPSTATS_MIB_INNOROUTES)
    


* * *
# ldap_abandon

## NAME



           ldap_abandon_ext - Abandon an LDAP operation in progress
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_abandon_ext(**
                  **LDAP ***_ld_**,**
                  **Bint** _msgid_**,**
                  **LDAPControl ****_sctrls_**,**
                  **LDAPControl ****_cctrls_ **);**
    


## DESCRIPTION



           The **ldap_abandon_ext()** routine is used to send a LDAP Abandon
           request for an operation in progress.  The _msgid_ passed should be
           the message id of an outstanding LDAP operation, such as returned
           by ldap_search_ext(3).
    
           **ldap_abandon_ext**() checks to see if the result of the operation
           has already come in.  If it has, it deletes it from the queue of
           pending messages.  If not, it sends an LDAP abandon request to the
           LDAP server.
    
           The caller can expect that the result of an abandoned operation
           will not be returned from a future call to ldap_result(3).
    
           **ldap_abandon_ext()** allows server and client controls to be passed
           in via the _sctrls_ and _cctrls_ parameters, respectively.
    
           **ldap_abandon_ext()** returns a code indicating success or, in the
           case of failure, the nature of the failure.  See ldap_error(3) for
           details.
    


## DEPRECATED INTERFACES



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


## ACKNOWLEDGEMENTS



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


* * *
# form_win

## NAME



           **form_win** - make and break form window and subwindow associations
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_form_win(FORM ***_form_**, WINDOW ***_win_**);**
           **WINDOW *form_win(const FORM ***_form_**);**
    
           **int set_form_sub(FORM ***_form_**, WINDOW ***_sub_**);**
           **WINDOW *form_sub(const FORM ***_form_**);**
    
           **int scale_form(const FORM ***_form_**, int ***_rows_**, int ***_columns_**);**
    


## DESCRIPTION



           Every form has an associated pair of **curses** windows.  The form
           window displays any title and border associated with the window;
           the form subwindow displays the items of the form that are
           currently available for selection.
    
           The first four functions get and set those windows.  It is not
           necessary to set either window; by default, the driver code uses
           **stdscr** for both.
    
           In the **set_** functions, window argument of **NULL** is treated as
           though it were **stsdcr**.  A form argument of **NULL** is treated as a
           request to change the system default form window or subwindow.
    
           The function **scale_form** returns the minimum size required for the
           subwindow of _form_.
    


## RETURN VALUE



           Routines that return pointers return **NULL** on error.  Routines that
           return an integer return one of the following error codes:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_POSTED**
                The form has already been posted.
    
           **E_NOT_CONNECTED**
                No items are connected to the form.
    


## NOTES



           The header file **< form.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V forms library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# gnutls_x509_crl_get_authority_key_id

## NAME



           gnutls_x509_crl_get_authority_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_authority_key_id(gnutls_x509_crl_t** _crl_**,**
           **void ***_id_**, size_t ***_id_size_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           void * id   The place where the identifier will be copied
    
           size_t * id_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 authority's key identifier.
           This is obtained by the X.509 Authority Key identifier extension
           field (2.5.29.35).  Note that this function only returns the
           keyIdentifier field of the extension and
           **GNUTLS_E_X509_UNSUPPORTED_EXTENSION** , if the extension contains the
           name and serial number of the certificate. In that case
           **gnutls_x509_crl_get_authority_key_gn_serial()** may be used.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# probe::syscall_any.return

## NAME



           probe::syscall_any.return - Record exit from a syscall
    


## SYNOPSIS



           syscall_any.return
    


## VALUES



           _syscall_nr_
               number of the syscall
    
           _name_
               name of the syscall
    
           _retval_
               return value of the syscall
    


## CONTEXT



           The process performing the syscall
    


## DESCRIPTION



           The syscall_any.return probe point is designed to be a low
           overhead that monitors all the syscalls returns via a kernel
           tracepoint. Because of the breadth of syscalls it monitors it
           provides no information about the syscall arguments, argstr string
           representation of those arguments, or a string interpretation of
           the return value (retval).
    
           This requires kernel 3.5+ and newer which have the
           kernel.trace(“sys_exit”) probe point.
    


* * *
# daylight

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



           daylight — daylight savings time flag
    


## SYNOPSIS



           #include <time.h>
    
           extern int daylight;
    


## DESCRIPTION



           Refer to tzset(3p).
    


* * *
# pmsearchtextquery

## NAME



           **pmSearchTextQuery** - full-text search for metrics, instances and
           instance domains provided by PCP search services
    


## C SYNOPSIS



           **#include <pcp/pmwebapi.h>**
    
           **int pmSearchTextQuery(pmSearchSettings ***_settings_**,**
                                 **pmSearchTextRequest ***_request_**, void ***_arg_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           Executes  full-text  search  in name, oneline help, helptext (when
           available) as specified by _request_ :
    
           _query_
                Query string that will be used to search.
    
           _count_
                Limits number of results. Defaults to 10.
    
           _offset_
                Search offset. Defaults to 0.
    
           _type_metric_ , _type_indom_ , _type_inst_
                Bit flags that limit query to only take into the account spe‐
                cific type of entities. Defaults to all.
    
           _highlight_name_ , _highlight_oneline_ , _highlight_helptext_
                Bit flags that specify whether or not to highlight matched
                terms in results. Defaults to none. Highlighted terms are
                wrapped with `<b>' and `</b>'.
    
           _infields_name_ , _infields_oneline_ , _infields_helptext_
                Bit flags that allow limiting full-text search query matching
                only to specified fields. Defaults to all.
    
           _return_name_ , _return_indom_ , _return_oneline_ , _return_helptext_ , _re‐_
           _turn_type_
                Bit flags for omitting specific fields from result. Defaults
                to all. Fields may be omitted either way if value of a field
                doesn't exist for a given record.
    
           Each entity matched by the **request** above will be passed to
           **on_text_result** callback provided by **settings.**
    


## DIAGNOSTICS



           This function always returns zero on success.  On failure a nega‐
           tive PMAPI error code is returned.
    


* * *
# gnutls_dh_params_generate2

## NAME



           gnutls_dh_params_generate2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_generate2(gnutls_dh_params_t** _dparams_**,**
           **unsigned int** _bits_**);**
    


## ARGUMENTS



           gnutls_dh_params_t dparams
                       The parameters
    
           unsigned int bits
                       is the prime's number of bits
    


## DESCRIPTION



           This function will generate a new pair of prime and generator for
           use in the Diffie-Hellman key exchange. This may take long time.
    
           It is recommended not to set the number of bits directly, but use
           **gnutls_sec_param_to_pk_bits()** instead.  Also note that the DH
           parameters are only useful to servers.  Since clients use the
           parameters sent by the server, it's of no use to call this in
           client side.
    
           The parameters generated are of the DSA form. It also is possible
           to generate provable parameters (following the Shawe-Taylor
           algorithm), using **gnutls_x509_privkey_generate2()** with DSA option
           and the **GNUTLS_PRIVKEY_FLAG_PROVABLE** flag set. These can the be
           imported with **gnutls_dh_params_import_dsa()**.
    
           It is no longer recommended for applications to generate
           parameters.  See the "Parameter generation" section in the manual.
    


## RETURNS



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


* * *
# probe::netfilter.bridge.forward

## NAME



           probe::netfilter.bridge.forward - Called on an incoming bridging
           packet destined for some other computer
    


## SYNOPSIS



           netfilter.bridge.forward
    


## VALUES



           _br_max_
               Max age in 1/256 secs
    
           _br_rid_
               Identity of root bridge
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _protocol_
               Packet protocol
    
           _br_htime_
               Hello time in 1/256 secs
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _br_vid_
               Protocol version identifier
    
           _brhdr_
               Address of bridge header
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _br_rmac_
               Root bridge MAC address
    
           _br_fd_
               Forward delay in 1/256 secs
    
           _br_mac_
               Bridge MAC address
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _br_msg_
               Message age in 1/256 secs
    
           _pf_
               Protocol family -- always “bridge”
    
           _br_flags_
               BPDU flags
    
           _br_bid_
               Identity of bridge
    
           _br_poid_
               Port identifier
    
           _br_type_
               BPDU type
    
           _llcpdu_
               Address of LLC Protocol Data Unit
    
           _br_prid_
               Protocol identifier
    
           _llcproto_stp_
               Constant used to signify Bridge Spanning Tree Protocol packet
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _br_cost_
               Total cost from transmitting bridge to root
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    


* * *
# ldap_memory

## NAME



           ldap_memfree, ldap_memvfree, ldap_memalloc, ldap_memcalloc,
           ldap_memrealloc, ldap_strdup - LDAP memory allocation routines
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **void ldap_memfree(void ***_p_**);**
    
           **void ldap_memvfree(void ****_v_**);**
    
           **void *ldap_memalloc(ber_len_t** _s_**);**
    
           **void *ldap_memcalloc(ber_len_t** _n_**, ber_len_t** _s_**);**
    
           **void *ldap_memrealloc(void ***_p_**, ber_len_t** _s_**);**
    
           **char *ldap_strdup(LDAP_CONST char ***_p_**);**
    


## DESCRIPTION



           These routines are used to allocate/deallocate memory
           used/returned by the LDAP library.  **ldap_memalloc**(),
           **ldap_memcalloc**(), **ldap_memrealloc**(), and **ldap_memfree**() are used
           exactly like the standard malloc(3), calloc(3), realloc(3), and
           free(3) routines, respectively.  The **ldap_memvfree**() routine is
           used to free a dynamically allocated array of pointers to
           arbitrary dynamically allocated objects.  The **ldap_strdup**()
           routine is used exactly like the standard strdup(3) routine.
    


## ACKNOWLEDGEMENTS



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


* * *
# QmcDesc

## NAME



           **QmcDesc** - container for a metric description
    


## C++ SYNOPSIS



           **#include <QmcDesc.h>**
    
           **c++ ... -lpcp_qmc -lpcp**
    


## DESCRIPTION



           A  **QmcDesc** object is a container for a metric descriptor (**pmDesc** ,
           see PMAPI(3)) and units.
    


## CONSTRUCTORS & DESTRUCTOR



           **~QmcDesc();**
               Destructor.
    
           **QmcDesc(pmID pmid);**
               Construct a container for the descriptor for _pmid_.  The de‐
               scriptor is obtained from the current PMAPI(3) context using
               pmLookupDesc(3).
    


## DESCRIPTION



           **int status() const;**
               A status less than zero indicates that the descriptor could
               not be obtained, the PMAPI(3) error is encoded in the result.
    
           **pmID id() const;**
               Return the **pmID** for this descriptor.
    
           **pmDesc desc() const;**
               Return a copy of the actual metric descriptor.
    
           **const pmDesc *descPtr() const;**
               Return a pointer to the actual descriptor to avoid using a
               pointer to a temporary.
    


## UNITS



           **const QString &units() const;**
               The complete unit string for this descriptor.
    
           **const QString &shortUnits() const;**
               The unit string using abbreviations.
    
           **bool useScaleUnits() const;**
               Returns **true** if the units have been set by a call to **QmcDe‐**
               **sc::setScaleUnits**.
    
           **const pmUnits &scaleUnits() const;**
               Return the scaling units for this descriptor.
    
           **void setScaleUnits(const pmUnits &units);**
               Set the scaling units for this descriptor.
    


## DIAGNOSTICS



           Error messages are generated using pmprintf(3) but are not
           flushed. It is the responsibility of the user to call pmflush(3)
           to output any messages.
    
           Additional diagnostics may be activated by adding the option **pmc**
           to the global debugging specification, as described in
           pmSetDebug(3).
    


* * *
# auparse_goto_field_num

## NAME



           auparse_goto_field_num - move field cursor to specific field
    


## SYNOPSIS



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


## DESCRIPTION



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


## RETURN VALUE



           Returns 0 on error or 1 for success.
    


* * *
# memccpy

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



           memccpy — copy bytes in memory
    


## SYNOPSIS



           #include <string.h>
    
           void *memccpy(void *restrict _s1_ , const void *restrict _s2_ ,
               int _c_ , size_t _n_);
    


## DESCRIPTION



           The _memccpy_() function shall copy bytes from memory area _s2_ into
           _s1_ , stopping after the first occurrence of byte _c_ (converted to an
           **unsigned char**) is copied, or after _n_ bytes are copied, whichever
           comes first. If copying takes place between objects that overlap,
           the behavior is undefined.
    


## RETURN VALUE



           The _memccpy_() function shall return a pointer to the byte after
           the copy of _c_ in _s1_ , or a null pointer if _c_ was not found in the
           first _n_ bytes of _s2_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _memccpy_() function does not check for the overflow of the
           receiving memory area.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::sunrpc.svc.recv

## NAME



           probe::sunrpc.svc.recv - Listen for the next RPC request on any
           socket
    


## SYNOPSIS



           sunrpc.svc.recv
    


## VALUES



           _sv_nrthreads_
               the number of concurrent threads
    
           _sv_name_
               the service name
    
           _timeout_
               the timeout of waiting for data
    
           _sv_prog_
               the number of the program
    


* * *
# tracelog

## NAME



           tracelog - LTTng-UST printf(3)-like interface with a log level
    


## SYNOPSIS



           **#include <lttng/tracelog.h>**
    
           #define **tracelog**(_level_ , _fmt_ , ...)
    
           Link with **-llttng-ust -llttng-ust-common**.
    


## DESCRIPTION



           The **tracelog()** macro is part of version 0 of the LTTng-UST API
           (see the “Compatibility with previous APIs” section of
           lttng-ust(3)).
    
           Prefer using lttng_ust_tracelog(3) which is part of version 1 of
           the API and has the **lttng_ust_** namespace.
    


## BUGS



           If you encounter any issue or usability problem, please report it
           on the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-
           ust>.
    


## RESOURCES



           •   LTTng project website <http://lttng.org>
    
           •   LTTng documentation <http://lttng.org/docs>
    
           •   Git repositories <http://git.lttng.org>
    
           •   GitHub organization <http://github.com/lttng>
    
           •   Continuous integration <http://ci.lttng.org/>
    
           •   Mailing list <http://lists.lttng.org> for support and
               development: **lttng-dev@lists.lttng.org**
    
           •   IRC channel <irc://irc.oftc.net/lttng>: **#lttng** on **irc.oftc.net**
    


## THANKS



           Thanks to Ericsson for funding this work, providing real-life use
           cases, and testing.
    
           Special thanks to Michel Dagenais and the DORSAL laboratory
           <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal
           for the LTTng journey.
    


* * *
# gnutls_global_set_log_level

## NAME



           gnutls_global_set_log_level - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_set_log_level(int** _level_**);**
    


## ARGUMENTS



           int level   it's an integer from 0 to 99.
    


## DESCRIPTION



           This is the function that allows you to set the log level.  The
           level is an integer between 0 and 9.  Higher values mean more
           verbosity. The default value is 0.  Larger values should only be
           used with care, since they may reveal sensitive information.
    
           Use a log level over 10 to enable all debugging options.
    


* * *
# probe::vm.pagefault.return

## NAME



           probe::vm.pagefault.return - Indicates what type of fault occurred
    


## SYNOPSIS



           vm.pagefault.return
    


## VALUES



           _name_
               name of the probe point
    
           _fault_type_
               returns either 0 (VM_FAULT_OOM) for out of memory faults, 2
               (VM_FAULT_MINOR) for minor faults, 3 (VM_FAULT_MAJOR) for
               major faults, or 1 (VM_FAULT_SIGBUS) if the fault was neither
               OOM, minor fault, nor major fault.
    


* * *
# fmin

## NAME



           fmin, fminf, fminl - determine minimum of two floating-point
           numbers
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the lesser value of _x_ and _y_.
    


## RETURN VALUE



           These functions return the minimum of _x_ and _y_.
    
           If one argument is a NaN, the other argument is returned.
    
           If both arguments are NaN, a NaN is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ftrylockfile

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



           ftrylockfile — stdio locking functions
    


## SYNOPSIS



           #include <stdio.h>
    
           int ftrylockfile(FILE *_file_);
    


## DESCRIPTION



           Refer to flockfile(3p).
    


* * *
# function::json_add_array_string_metric

## NAME



           function::json_add_array_string_metric - Add a string metric to an
           array
    


## SYNOPSIS



               json_add_array_string_metric:long(array_name:string,metric_name:string,metric_description:string)
    


## ARGUMENTS



           _array_name_
               The name of the array the string metric should be added to.
    
           _metric_name_
               The name of the string metric.
    
           _metric_description_
               Metric description. An empty string can be used.
    


## DESCRIPTION



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


* * *
# function::task_cpu

## NAME



           function::task_cpu - The scheduled cpu of the task
    


## SYNOPSIS



               task_cpu:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the scheduled cpu for the given task.
    


* * *
# gnutls_x509_crt_get_signature_oid

## NAME



           gnutls_x509_crt_get_signature_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_signature_oid(gnutls_x509_crt_t** _cert_**, char**
           *****_oid_**, size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           char * oid  a pointer to a buffer to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the OID of the signature algorithm that
           has been used to sign this certificate. This is function is useful
           in the case **gnutls_x509_crt_get_signature_algorithm()** returned
           **GNUTLS_SIGN_UNKNOWN**.
    


## RETURNS



           zero or a negative error code on error.
    


## SINCE



           3.5.0
    


* * *
# acl_free

## NAME



           **acl_free** — release memory allocated to an ACL data object
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_free**(_void *obj_p_)
    


## DESCRIPTION



           The **acl_free**() function frees any releasable memory currently
           allocated by to the ACL data object identified by _obj_p_.  The
           argument _obj_p_ may identify an ACL, an ACL entry qualifier, or a
           pointer to a string allocated by the **acl_to_text**() function.
    


## RETURN VALUE



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


## ERRORS



           If any of the following conditions occur, the **acl_free**() function
           returns the value **-1** and and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The value of the argument _obj_p_ is invalid.
    


## STANDARDS



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


* * *
# gnutls_x509_crq_get_signature_algorithm

## NAME



           gnutls_x509_crq_get_signature_algorithm - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_signature_algorithm(gnutls_x509_crq_t**
           _crq_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_cr_t** type
    


## DESCRIPTION



           This function will return a value of the **gnutls_sign_algorithm_t**
           enumeration that is the signature algorithm that has been used to
           sign this certificate request.
    
           Since 3.6.0 this function never returns a negative error code.
           Error cases and unknown/unsupported signature algorithms are
           mapped to **GNUTLS_SIGN_UNKNOWN**.
    


## RETURNS



           a **gnutls_sign_algorithm_t** value
    


## SINCE



           3.4.0
    


* * *
# sd_device_ref

## NAME



           sd_device_ref, sd_device_unref, sd_device_unrefp - Create or
           destroy references to a device object
    


## SYNOPSIS



           **#include <systemd/sd-device.h>**
    
           **sd_device* sd_device_ref(sd_device ***_device_**);**
    
           **sd_device* sd_device_unref(sd_device ***_device_**);**
    
           **void sd_device_unrefp(sd_device ****_device_**);**
    
           **sd_device_ref()** increases the internal reference counter of _device_
           by one.
    
           **sd_device_unref()** decreases the internal reference counter of
           _device_ by one. Once the reference count has dropped to zero,
           _device_ is destroyed and cannot be used anymore, so further calls
           to **sd_device_ref()** or **sd_device_unref()** are illegal.
    
           **sd_device_unrefp()** is similar to **sd_device_unref()** but takes a
           pointer to a pointer to an **sd_device** object. This call is useful
           in conjunction with GCC's and LLVM's **Clean-up Variable**
           **Attribute******[1]. Note that this function is defined as an inline
           function. Use a declaration like the following, in order to
           allocate a device object that is freed automatically as the code
           block is left:
    
           {
             __attribute__((cleanup(sd_device_unrefp))) sd_device *device = NULL;
             int r;
             ...
             r = sd_device_new_from_syspath( &device, "...");
             if (r < 0) {
               errno = -r;
               fprintf(stderr, "Failed to allocate device: %m\n");
             }
             ...
           }
    
           **sd_device_ref()** and **sd_device_unref()** execute no operation if the
           argument is **NULL**.  **sd_device_unrefp()** will first dereference its
           argument, which must not be **NULL** , and will execute no operation if
           _that_ is **NULL**.
    


## RETURN VALUE



           **sd_device_ref()** always returns the argument, and **sd_device_unref()**
           always returns **NULL**.
    


## NOTES



            1. Clean-up Variable Attribute
               https://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.html
    


* * *
# probe::vm.oom_kill

## NAME



           probe::vm.oom_kill - Fires when a thread is selected for
           termination by the OOM killer
    


## SYNOPSIS



           vm.oom_kill
    


## VALUES



           _task_
               the task being killed
    
           _name_
               name of the probe point
    


## CONTEXT



           The process that tried to consume excessive memory, and thus
           triggered the OOM.
    


* * *
# form_cursor

## NAME



           **pos_form_cursor** - position a form window cursor
    


## SYNOPSIS



           **#include <form.h>**
    
           **int pos_form_cursor(FORM ***_form_**);**
    


## DESCRIPTION



           The function **pos_form_cursor** restores the cursor to the position
           required for the forms driver to continue processing requests.
           This is useful after **curses** routines have been called to do
           screen-painting in response to a form operation.
    


## RETURN VALUE



           This routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_NOT_POSTED**
                The form has not been posted.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



           The header file **< form.h> **automatically includes the header file
           **< curses.h>**.
    


## PORTABILITY



           These routines emulate the System V forms library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# gnutls_pubkey_import_privkey

## NAME



           gnutls_pubkey_import_privkey - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_privkey(gnutls_pubkey_t** _key_**,**
           **gnutls_privkey_t** _pkey_**, unsigned int** _usage_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key
    
           gnutls_privkey_t pkey
                       The private key
    
           unsigned int usage
                       GNUTLS_KEY_* key usage flags.
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           Imports the public key from a private.  This function will import
           the given public key to the abstract **gnutls_pubkey_t** type.
    
           Note that in certain keys this operation may not be possible,
           e.g., in other than RSA PKCS**11** keys.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# ceil

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



           ceil, ceilf, ceill — ceiling value function
    


## SYNOPSIS



           #include <math.h>
    
           double ceil(double _x_);
           float ceilf(float _x_);
           long double ceill(long double _x_);
    


## 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 smallest integral value not less
           than _x_.
    


## RETURN VALUE



           The result shall have the same sign as _x_.
    
           Upon successful completion, _ceil_(), _ceilf_(), and _ceill_() shall
           return the smallest integral value not less than _x_ , expressed as a
           type **double** , **float** , or **long double** , respectively.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0 or ±Inf, _x_ shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The integral value returned by these functions need not be
           expressible as an **intmax_t**.  The return value should be tested
           before assigning it to an integer type to avoid the undefined
           results of an integer overflow.
    
           These functions may raise the inexact floating-point exception if
           the result differs in value from the argument.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_get_ca_status

## NAME



           gnutls_x509_crt_get_ca_status - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_ca_status(gnutls_x509_crt_t** _cert_**, unsigned**
           **int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return certificates CA status, by reading the
           basicConstraints X.509 extension (2.5.29.19). If the certificate
           is a CA a positive value will be returned, or (0) if the
           certificate does not have CA flag set.
    
           Use **gnutls_x509_crt_get_basic_constraints()** if you want to read
           the pathLenConstraint field too.
    


## RETURNS



           If the certificate is a CA a positive value will be returned, or
           (0) if the certificate does not have CA flag set.  A negative
           error code may be returned in case of errors.  If the certificate
           does not contain the basicConstraints extension
           GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.
    


* * *
# function::module_name

## NAME



           function::module_name - The module name of the current script
    


## SYNOPSIS



               module_name:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the name of the stap module. Either
           generated randomly (stap_[0-9a-f]+_[0-9a-f]+) or set by stap -m
           <module_name>.
    


* * *
# function::gettimeofday_ms

## NAME



           function::gettimeofday_ms - Number of milliseconds since UNIX
           epoch
    


## SYNOPSIS



               gettimeofday_ms:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of milliseconds since the UNIX
           epoch.
    


* * *
# gnutls_mac_get_nonce_size

## NAME



           gnutls_mac_get_nonce_size - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **size_t gnutls_mac_get_nonce_size(gnutls_mac_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           Returns the size of the nonce used by the MAC in TLS.
    


## RETURNS



           length (in bytes) of the given MAC nonce size, or 0.
    


## SINCE



           3.2.0
    


* * *
# libsystemd

## NAME



           libsystemd - Functions for implementing services and interacting
           with systemd
    


## SYNOPSIS



           #include <systemd/sd-bus.h>
           #include <systemd/sd-daemon.h>
           #include <systemd/sd-device.h>
           #include <systemd/sd-event.h>
           #include <systemd/sd-gpt.h>
           #include <systemd/sd-hwdb.h>
           #include <systemd/sd-id128.h>
           #include <systemd/sd-journal.h>
           #include <systemd/sd-json.h>
           #include <systemd/sd-login.h>
           #include <systemd/sd-messages.h>
           #include <systemd/sd-path.h>
           #include <systemd/sd-varlink.h>
    
           **pkg-config --cflags --libs libsystemd**
    


## DESCRIPTION



           The libsystemd library provides functions that allow interacting
           with various interfaces provided by the systemd(1) service
           manager, as well as various other functions and constants useful
           for implementing services in general.
    
           See sd-bus(3), sd-bus-errors(3), sd-daemon(3), sd-device(3),
           sd-event(3), sd-hwdb(3), sd-id128(3), sd-journal(3), sd-json(3),
           sd-login(3) and sd-varlink(3) for information about different
           parts of the library interface.
    


## INTERFACE STABILITY



           Strict backwards-compatibility is maintained for the API
           (application programming interface) and ABI (application binary
           interface). Symbol versioning is used, with symbols only added and
           never removed.
    


## NOTES



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


## NOTES



            1. Interface Portability and Stability Promise
               https://systemd.io/PORTABILITY_AND_STABILITY/
    


* * *
# conj

## NAME



           conj, conjf, conjl - calculate the complex conjugate
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex conj(double complex** _z_**);**
           **float complex conjf(float complex** _z_**);**
           **long double complex conjl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions return the complex conjugate value of _z_.  That is
           the value obtained by changing the sign of the imaginary part.
    
           One has:
    
               cabs(z) = csqrt(z * conj(z))
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *