tripathysagar/man_text huggingface dataset:
# posix_trace_attr_setstreamfullpolicy

## 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_attr_setstreamfullpolicy — retrieve and set the
           behavior of a trace stream (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_attr_setstreamfullpolicy(trace_attr_t *_attr_ ,
               int _streampolicy_);
    


## DESCRIPTION



           Refer to posix_trace_attr_getinherited(3p).
    


* * *
# mlx5dv_get_clock_info

## NAME



           mlx5dv_get_clock_info - Get device clock information
    


## SYNOPSIS



           **#include <infiniband/mlx5dv.h>**
    
           **int mlx5dv_get_clock_info(struct ibv_context *ctx_in,**
                                     **struct mlx5dv_clock_info *clock_info);**
    


## DESCRIPTION



           Get the updated core _clock_info_ from the device driver. This
           information will be used later to translate the completion
           timestamp from HCA core clock to nanoseconds. The values of the
           clock are updated from the driver's PTP clock, therefore, without
           a running PTP client on the machine, the wall clock conversion
           will not be accurate.
    
           Pass the latest **struct mlx5dv_clock_info** to mlx5dv_ts_to_ns(3) in
           order to translate the completion timestamp from HCA core clock to
           nanoseconds.
    
           If the clock_info becomes too old then time conversion will return
           wrong conversion results.  The user must ensure that
           mlx5dv_get_clock_info(3) is called at least once every
           **max_clock_info_update_nsec** as returned by the
           mlx5dv_query_device(3) function.
    


## RETURN VALUE



           0 on success or the value of errno on failure (which indicates the
           failure reason).
    


* * *
# vprintf

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



           vprintf — format the output of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
    
           int vprintf(const char *restrict _format_ , va_list _ap_);
    


## DESCRIPTION



           Refer to vfprintf(3p).
    


* * *
# function::ipmib_remote_addr

## NAME



           function::ipmib_remote_addr - Get the remote ip address
    


## SYNOPSIS



               ipmib_remote_addr:long(skb:long,SourceIsLocal:long)
    


## ARGUMENTS



           _skb_
               pointer to a struct sk_buff
    
           _SourceIsLocal_
               flag to indicate whether local operation
    


## DESCRIPTION



           Returns the remote ip address from _skb_.
    


* * *
# gnutls_x509_spki_get_rsa_oaep_params

## NAME



           gnutls_x509_spki_get_rsa_oaep_params - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_spki_get_rsa_oaep_params(gnutls_x509_spki_t** _spki_**,**
           **gnutls_digest_algorithm_t ***_dig_**, gnutls_datum_t ***_label_**);**
    


## ARGUMENTS



           gnutls_x509_spki_t spki
                       the SubjectPublicKeyInfo structure
    
           gnutls_digest_algorithm_t * dig
                       if non-NULL, it will hold the digest algorithm
    
           gnutls_datum_t * label
                       if non-NULL, it will hold the pointer to label
    


## DESCRIPTION



           This function will get the public key algorithm parameters of
           RSA-OAEP type.
    


## RETURNS



           zero if the parameters are present or a negative value on error.
    


## SINCE



           3.8.4
    


* * *
# gnutls_record_set_max_recv_size

## NAME



           gnutls_record_set_max_recv_size - API function
    


## SYNOPSIS



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


## ARGUMENTS



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


## DESCRIPTION



           This function sets the maximum amount of plaintext received in a
           record in this connection.
    
           The limit is also negotiated through a TLS extension called
           'record size limit'.  Note that while the 'record size limit'
           extension is preferred, not all TLS implementations use or even
           understand the extension.
    


## RETURNS



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


## SINCE



           3.6.8
    


* * *
# function::udelay

## NAME



           function::udelay - microsecond delay
    


## SYNOPSIS



               udelay(us:long)
    


## ARGUMENTS



           _us_
               Number of microseconds to delay.
    


## DESCRIPTION



           This function inserts a multi-microsecond busy-delay into a probe
           handler. It requires guru mode.
    


* * *
# NULL

## NAME



           NULL - null pointer constant
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stddef.h>**
    
           **#define NULL  ((void *) 0)**
    


## DESCRIPTION



           **NULL** represents a null pointer constant, that is, a pointer that
           does not point to anything.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following headers also provide **NULL** : _< locale.h>_, _< stdio.h>_,
           _< stdlib.h>_, _< string.h>_, _< time.h>_, _< unistd.h>_, and _< wchar.h>_.
    


## CAVEATS



           It is undefined behavior to dereference a null pointer, and that
           usually causes a segmentation fault in practice.
    
           It is also undefined behavior to perform pointer arithmetic on it.
    
           _NULL - NULL_ is undefined behavior, according to ISO C, but is
           defined to be 0 in C++.
    
           To avoid confusing human readers of the code, do not compare
           pointer variables to **0** , and do not assign **0** to them.  Instead,
           always use **NULL**.
    
           **NULL** shouldn't be confused with **NUL** , which is an ascii(7)
           character, represented in C as **'\0'**.
    


## BUGS



           When it is necessary to set a pointer variable to a null pointer,
           it is not enough to use memset(3) to zero the pointer (this is
           usually done when zeroing a struct that contains pointers), since
           ISO C and POSIX don't guarantee that a bit pattern of all 0s
           represent a null pointer.  See the EXAMPLES section in
           getaddrinfo(3) for an example program that does this correctly.
    


* * *
# strchr

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



           strchr — string scanning operation
    


## SYNOPSIS



           #include <string.h>
    
           char *strchr(const char *_s_ , int _c_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _strchr_() function shall locate the first occurrence of _c_
           (converted to a **char**) in the string pointed to by _s_.  The
           terminating NUL character is considered to be part of the string.
    


## RETURN VALUE



           Upon completion, _strchr_() shall return a pointer to the byte, or a
           null pointer if the byte was not found.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pcap_tstamp_type_val_to_description

## NAME



           pcap_tstamp_type_val_to_name, pcap_tstamp_type_val_to_description
           - get a name or description for a time stamp type value
    


## SYNOPSIS



           **#include <pcap.h>**
    
           **const char *pcap_tstamp_type_val_to_name(int tstamp_type);**
           **const char *pcap_tstamp_type_val_to_description(int tstamp_type);**
    


## DESCRIPTION



           **pcap_tstamp_type_val_to_name**() translates a time stamp type value
           to the corresponding time stamp type name.  **NULL** is returned on
           failure.
    
           **pcap_tstamp_type_val_to_description**() translates a time stamp type
           value to a short description of that time stamp type.  **NULL** is
           returned on failure.
    


## BACKWARD COMPATIBILITY



           These functions became available in libpcap release 1.2.1.
    


* * *
# gnutls_cipher_get_name

## NAME



           gnutls_cipher_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_cipher_get_name(gnutls_cipher_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           Convert a **gnutls_cipher_algorithm_t** type to a string.
    


## RETURNS



           a pointer to a string that contains the name of the specified
           cipher, or **NULL**.
    


* * *
# sem_destroy

## NAME



           sem_destroy - destroy an unnamed semaphore
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <semaphore.h>**
    
           **int sem_destroy(sem_t ***_sem_**);**
    


## DESCRIPTION



           **sem_destroy**() destroys the unnamed semaphore at the address
           pointed to by _sem_.
    
           Only a semaphore that has been initialized by sem_init(3) should
           be destroyed using **sem_destroy**().
    
           Destroying a semaphore that other processes or threads are
           currently blocked on (in sem_wait(3)) produces undefined behavior.
    
           Using a semaphore that has been destroyed produces undefined
           results, until the semaphore has been reinitialized using
           sem_init(3).
    


## RETURN VALUE



           **sem_destroy**() returns 0 on success; on error, -1 is returned, and
           _errno_ is set to indicate the error.
    


## ERRORS



           **EINVAL** _sem_ is not a valid semaphore.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           An unnamed semaphore should be destroyed with **sem_destroy**() before
           the memory in which it is located is deallocated.  Failure to do
           this can result in resource leaks on some implementations.
    


* * *
# gnutls_x509_crq_export

## NAME



           gnutls_x509_crq_export - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_export(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a certificate request PEM or DER encoded
    
           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 export the certificate request to a PEM or DER
           encoded PKCS10 structure.
    
           If the buffer provided is not long enough to hold the output, then
           **GNUTLS_E_SHORT_MEMORY_BUFFER** will be returned and *
           _output_data_size_ will be updated.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           NEW CERTIFICATE REQUEST".
    


## RETURNS



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


* * *
# stpncpy

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



           stpncpy — copy fixed length string, returning a pointer to the
           array end
    


## SYNOPSIS



           #include <string.h>
    
           char *stpncpy(char *restrict _s1_ , const char *restrict _s2_ , size_t _size_);
    


## DESCRIPTION



           Refer to strncpy(3p).
    


* * *
# gnutls_dtls_set_mtu

## NAME



           gnutls_dtls_set_mtu - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **void gnutls_dtls_set_mtu(gnutls_session_t** _session_**, unsigned int**
           _mtu_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int mtu
                       The maximum transfer unit of the transport
    


## DESCRIPTION



           This function will set the maximum transfer unit of the transport
           that DTLS packets are sent over. Note that this should exclude the
           IP (or IPv6) and UDP headers. So for DTLS over IPv6 on an Ethernet
           device with MTU 1500, the DTLS MTU set with this function would be
           1500 - 40 (IPV6 header) - 8 (UDP header) = 1452.
    


## SINCE



           3.0
    


* * *
# lconv

## NAME



           lconv - numeric formatting information
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <locale.h>**
    
           **struct lconv {** /* Values in the "C" locale: */
               **char *decimal_point;** /* "." */
               **char *thousands_sep;** /* "" */
               **char *grouping;** /* "" */
               **char *mon_decimal_point;** /* "" */
               **char *mon_thousands_sep;** /* "" */
               **char *mon_grouping;** /* "" */
               **char *positive_sign;** /* "" */
               **char *negative_sign;** /* "" */
               **char *currency_symbol;** /* "" */
               **char  frac_digits;** /* CHAR_MAX */
               **char  p_cs_precedes;** /* CHAR_MAX */
               **char  n_cs_precedes;** /* CHAR_MAX */
               **char  p_sep_by_space;** /* CHAR_MAX */
               **char  n_sep_by_space;** /* CHAR_MAX */
               **char  p_sign_posn;** /* CHAR_MAX */
               **char  n_sign_posn;** /* CHAR_MAX */
               **char *int_curr_symbol;** /* "" */
               **char  int_frac_digits;** /* CHAR_MAX */
               **char  int_p_cs_precedes;** /* CHAR_MAX */
               **char  int_n_cs_precedes;** /* CHAR_MAX */
               **char  int_p_sep_by_space;** /* CHAR_MAX */
               **char  int_n_sep_by_space;** /* CHAR_MAX */
               **char  int_p_sign_posn;** /* CHAR_MAX */
               **char  int_n_sign_posn;** /* CHAR_MAX */
           **};**
    


## DESCRIPTION



           Contains members related to the formatting of numeric values.  In
           the "C" locale, its members have the values shown in the comments
           above.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::fp_to_string

## NAME



           function::fp_to_string - Convert 64 bit floating point to string
    


## SYNOPSIS



               fp_to_string:string(infp:long,precision:long)
    


## ARGUMENTS



           _infp_
               the 64 bit floating point stored in long
    
           _precision_
               number of digits after decimal point
    


## DESCRIPTION



           Given a 64 bit floating point, which is stored in long, use the
           long value to initiate self-defined float64_t type, then apply the
           f64_to_i64 function to get the string representation.
    


* * *
# sd_event_source_get_event

## NAME



           sd_event_source_get_event - Retrieve the event loop of an event
           source
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **sd_event* sd_event_source_get_event(sd_event_source ***_source_**);**
    


## DESCRIPTION



           **sd_event_source_get_event()** may be used to retrieve the event loop
           object the event source object specified as _source_ is associated
           with. The event loop object is specified when creating an event
           source object with calls such as sd_event_add_io(3) or
           sd_event_add_time(3).
    


## RETURN VALUE



           On success, **sd_event_source_get_event()** returns the associated
           event loop object. On failure, it returns **NULL**.
    


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


* * *
# ccosl

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



           ccosl — complex cosine functions
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to ccos(3p).
    


* * *
# gnutls_certificate_activation_time_peers

## NAME



           gnutls_certificate_activation_time_peers - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **time_t gnutls_certificate_activation_time_peers(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function will return the peer's certificate activation time.
    


## RETURNS



           (time_t)-1 on error.
    


## DEPRECATED



           **gnutls_certificate_verify_peers2()** now verifies activation times.
    


* * *
# pmtypestr

## NAME



           **pmTypeStr** , **pmTypeStr_r** - convert a performance metric type into a
           string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmTypeStr(int** _type_**);**
           **char *pmTypeStr_r(int** _type_**, char ***_buf_**, int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Given  a performance metric _type_ , **pmTypeStr** produces a terse ASCII
           equivalent, appropriate for use in error and diagnostic  messages.
           The **pmTypeStr_r** function does the same, but stores the result in a
           user-supplied  buffer _buf_ of length _buflen_ , which should have room
           for at least 20 bytes.
    
           The value for _type_ is typically extracted from a _pmDesc_ structure,
           following a call to pmLookupDesc(3) for a  particular  performance
           metric.
    
           Examples are **32**(for _type_ equals **PM_TYPE_32**), **U64**(for _type_ equals
           **PM_TYPE_U64**), **STRING**(for _type_ equals **PM_TYPE_STRING**), etc.
    


## NOTES



           Both of these functions are safe to call from threaded contexts.
    


* * *
# gnutls_pkcs12_bag_set_data

## NAME



           gnutls_pkcs12_bag_set_data - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_set_data(gnutls_pkcs12_bag_t** _bag_**,**
           **gnutls_pkcs12_bag_type_t** _type_**, const gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           gnutls_pkcs12_bag_type_t type
                       The data's type
    
           const gnutls_datum_t * data
                       the data to be copied.
    


## DESCRIPTION



           This function will insert the given data of the given type into
           the bag.
    


## RETURNS



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


* * *
# gnutls_cipher_get_key_size

## NAME



           gnutls_cipher_get_key_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **size_t gnutls_cipher_get_key_size(gnutls_cipher_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           This function returns the key size of the provided algorithm.
    


## RETURNS



           length (in bytes) of the given cipher's key size, or 0 if the
           given cipher is invalid.
    


* * *
# function::u64_arg

## NAME



           function::u64_arg - Return function argument as unsigned 64-bit
           value
    


## SYNOPSIS



               u64_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the unsigned 64-bit value of argument n, same as
           ulonglong_arg.
    


* * *
# gnutls_pkcs11_obj_deinit

## NAME



           gnutls_pkcs11_obj_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void gnutls_pkcs11_obj_deinit(gnutls_pkcs11_obj_t** _obj_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       The type to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a certificate structure.
    


## SINCE



           2.12.0
    


* * *
# pthread_attr_setstacksize

## PROLOG



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


## NAME



           pthread_attr_setstacksize — set the stacksize attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_setstacksize(pthread_attr_t *_attr_ , size_t _stacksize_);
    


## DESCRIPTION



           Refer to pthread_attr_getstacksize(3p).
    


* * *
# probe::tcp.disconnect

## NAME



           probe::tcp.disconnect - TCP socket disconnection
    


## SYNOPSIS



           tcp.disconnect
    


## VALUES



           _daddr_
               A string representing the destination IP address
    
           _sock_
               Network socket
    
           _family_
               IP address family
    
           _saddr_
               A string representing the source IP address
    
           _name_
               Name of this probe
    
           _sport_
               TCP source port
    
           _flags_
               TCP flags (e.g. FIN, etc)
    
           _dport_
               TCP destination port
    


## CONTEXT



           The process which disconnects tcp
    


* * *
# gnutls_psk_set_server_known_dh_params

## NAME



           gnutls_psk_set_server_known_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_set_server_known_dh_params(gnutls_psk_server_credentials_t**
           _res_**, gnutls_sec_param_t** _sec_param_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t res
                       is a gnutls_psk_server_credentials_t type
    
           gnutls_sec_param_t sec_param
                       is an option of the **gnutls_sec_param_t** enumeration
    


## DESCRIPTION



           This function will set the Diffie-Hellman parameters for a PSK
           server to use. These parameters will be used in Ephemeral
           Diffie-Hellman cipher suites and will be selected from the FFDHE
           set of RFC7919 according to the security level provided.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


## RETURNS



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


## SINCE



           3.5.6
    


* * *
# gnutls_oid_to_mac

## NAME



           gnutls_oid_to_mac - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_mac_algorithm_t gnutls_oid_to_mac(const char ***_oid_**);**
    


## ARGUMENTS



           const char * oid
                       is an object identifier
    


## DESCRIPTION



           Converts a textual object identifier typically from PKCS**5** values
           to a **gnutls_mac_algorithm_t** value.
    


## RETURNS



           a **gnutls_mac_algorithm_t** id of the specified digest algorithm, or
           **GNUTLS_MAC_UNKNOWN** on failure.
    


## SINCE



           3.5.4
    


* * *
# wcpcpy

## NAME



           wcpcpy - copy a wide-character string, returning a pointer to its
           end
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcpcpy(wchar_t *restrict** _dest_**, const wchar_t *restrict** _src_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **wcpcpy**():
               Since glibc 2.10:
                   _POSIX_C_SOURCE >= 200809L
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **wcpcpy**() function is the wide-character equivalent of the
           stpcpy(3) function.  It copies the wide-character string pointed
           to by _src_ , including the terminating null wide character (L'\0'),
           to the array pointed to by _dest_.
    
           The strings may not overlap.
    
           The programmer must ensure that there is room for at least
           _wcslen(src)+1_ wide characters at _dest_.
    


## RETURN VALUE



           **wcpcpy**() returns a pointer to the end of the wide-character string
           _dest_ , that is, a pointer to the terminating null wide character.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# function::fp_to_long

## NAME



           function::fp_to_long - Convert fp to int64
    


## SYNOPSIS



               fp_to_long:long(infp:long,roundingMode:long,exact:long)
    


## ARGUMENTS



           _infp_
               the 64 bit floating point stored in long
    
           _roundingMode_
               through 0-6, which are round to nearest even, minMag, min,
               max, near maxMag and round to odd
    
           _exact_
               the boolean value, if exact is 1 than raising inexact
               exception, otherwise ignore the exception.
    


## DESCRIPTION



           Given a 64 bit floating point, which is stored in long, use the
           long value to initiate self-defined float64_t type, then apply the
           f64_to_i64 function to get the string representation.
    


* * *
# gnutls_pkcs11_obj_get_ptr

## NAME



           gnutls_pkcs11_obj_get_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_get_ptr(gnutls_pkcs11_obj_t** _obj_**, void ****
           _ptr_**, void ****_session_**, void ****_ohandle_**, unsigned long ***_slot_id_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       should contain a **gnutls_pkcs11_obj_t** type
    
           void ** ptr will contain the CK_FUNCTION_LIST_PTR pointer (may be
                       **NULL**)
    
           void ** session
                       will contain the CK_SESSION_HANDLE of the object
    
           void ** ohandle
                       will contain the CK_OBJECT_HANDLE of the object
    
           unsigned long * slot_id
                       the identifier of the slot (may be **NULL**)
    
           unsigned int flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           Obtains the PKCS**11** session handles of an object.  _session_ and
           _ohandle_ must be deinitialized by the caller. The returned pointers
           are independent of the  _obj_ lifetime.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success or a negative error code on error.
    


## SINCE



           3.6.3
    


* * *
# gnutls_sign_get_name

## NAME



           gnutls_sign_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_sign_get_name(gnutls_sign_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t algorithm
                       is a sign algorithm
    


## DESCRIPTION



           Convert a **gnutls_sign_algorithm_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified sign algorithm,
           or **NULL**.
    


* * *
# function::callers

## NAME



           function::callers - Return first n elements of kernel stack
           backtrace
    


## SYNOPSIS



               callers:string(n:long)
    


## ARGUMENTS



           _n_
               number of levels to descend in the stack (not counting the top
               level). If n is -1, print the entire stack.
    


## DESCRIPTION



           This function returns a string of the first n hex addresses from
           the backtrace of the kernel stack. Output may be truncated as per
           maximum string length (MAXSTRINGLEN).
    


* * *
# function::d_name

## NAME



           function::d_name - get the dirent name
    


## SYNOPSIS



               d_name:string(dentry:long)
    


## ARGUMENTS



           _dentry_
               Pointer to dentry.
    


## DESCRIPTION



           Returns the dirent name (path basename).
    


* * *
# gnutls_register_custom_url

## NAME



           gnutls_register_custom_url - API function
    


## SYNOPSIS



           **#include <gnutls/urls.h>**
    
           **int gnutls_register_custom_url(const gnutls_custom_url_st ***_st_**);**
    


## ARGUMENTS



           const gnutls_custom_url_st * st
                       A **gnutls_custom_url_st** structure
    


## DESCRIPTION



           Register a custom URL. This will affect the following functions:
           **gnutls_url_is_supported()** , **gnutls_privkey_import_url()** ,
           gnutls_pubkey_import_url, **gnutls_x509_crt_import_url()** and all
           functions that depend on them, e.g.,
           **gnutls_certificate_set_x509_key_file2()**.
    
           The provided structure and callback functions must be valid
           throughout the lifetime of the process. The registration of an
           existing URL type will fail with **GNUTLS_E_INVALID_REQUEST**. Since
           GnuTLS 3.5.0 this function can be used to override the builtin
           URLs.
    
           This function is not thread safe.
    


## RETURNS



           returns zero if the given structure was imported or a negative
           value otherwise.
    


## SINCE



           3.4.0
    


* * *
# gnutls_dh_params_export_raw

## NAME



           gnutls_dh_params_export_raw - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_params_export_raw(gnutls_dh_params_t** _params_**,**
           **gnutls_datum_t ***_prime_**, gnutls_datum_t ***_generator_**, unsigned int ***
           _bits_**);**
    


## ARGUMENTS



           gnutls_dh_params_t params
                       Holds the DH parameters
    
           gnutls_datum_t * prime
                       will hold the new prime
    
           gnutls_datum_t * generator
                       will hold the new generator
    
           unsigned int * bits
                       if non null will hold the secret key's number of bits
    


## DESCRIPTION



           This function will export the pair of prime and generator for use
           in the Diffie-Hellman key exchange.  The new parameters will be
           allocated using **gnutls_malloc()** and will be stored in the
           appropriate datum.
    


## RETURNS



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


* * *
# ausearch_add_expression

## NAME



           ausearch_add_expression - build up search expression
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int ausearch_add_expression(auparse_state_t ***_au_**, const char ***_expression_**, char ****_error_**, ausearch_rule_t** _how_**);"**
    


## DESCRIPTION



           **ausearch_add_item** adds an expression to the current audit search
           expression. The search conditions can then be used to scan logs,
           files, or buffers for something of interest. The _expression_
           parameter contains an expression, as specified in
           ausearch-expression(5).  The _how_ parameter determines how this
           search expression will affect the existing search expression, if
           one is already defined. The possible values are:
    
                  _AUSEARCH_RULE_CLEAR_
                         Clear the current search expression, if any, and use
                         only this search expression.
    
                  _AUSEARCH_RULE_OR_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **|| this_search_expression)**.
    
                  _AUSEARCH_RULE_AND_
                         If a search expression _E_ is already configured,
                         replace it by **(**_E_ **& & this_search_expression)**.
           The caller must free the error message using free(3).  If an error
           message is not available or can not be allocated, *****_error_ is set to
           **NULL**.
    


* * *
# keyctl_update

## NAME



           keyctl_update - update a key
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_update(key_serial_t** _key_**, const void ***_payload_**,**
           **size_t** _plen_**);**
    


## DESCRIPTION



           **keyctl_update**() updates the payload of a key if the key type
           permits it.
    
           The caller must have **write** permission on a key to be able to
           update it.
    
           _payload_ and _plen_ specify the data for the new payload.  _payload_
           may be NULL and _plen_ may be zero if the key type permits that.
           The key type may reject the data if it's in the wrong format or in
           some other way invalid.
    


## RETURN VALUE



           On success **keyctl_update**() returns **0**.  On error, the value **-1** will
           be returned and _errno_ will have been set to an appropriate error.
    


## ERRORS



           **ENOKEY** The key specified is invalid.
    
           **EKEYEXPIRED**
                  The key specified has expired.
    
           **EKEYREVOKED**
                  The key specified had been revoked.
    
           **EINVAL** The payload data was invalid.
    
           **ENOMEM** Insufficient memory to store the new payload.
    
           **EDQUOT** The key quota for this user would be exceeded by increasing
                  the size of the key to accommodate the new payload.
    
           **EACCES** The key exists, but is not **writable** by the calling process.
    
           **EOPNOTSUPP**
                  The key type does not support the update operation on its
                  keys.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# auparse_get_timestamp

## NAME



           auparse_get_timestamp - access timestamp of the event
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_timestamp provides an accessor function for the
           event's timestamp data structure. The data structure is as
           follows:
    
           typedef struct
           {
                   time_t sec;             // Event seconds
                   unsigned int milli;     // millisecond of the timestamp
                   unsigned long serial;   // Serial number of the event
                   const char *host;       // Machine's node name
           } au_event_t;
    


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, a valid pointer to the
           data.
    


* * *
# gnutls_cipher_get_tag_size

## NAME



           gnutls_cipher_get_tag_size - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **unsigned gnutls_cipher_get_tag_size(gnutls_cipher_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is an encryption algorithm
    


## DESCRIPTION



           This function returns the tag size of an authenticated encryption
           algorithm. For non-AEAD algorithms, it returns zero.
    


## RETURNS



           the tag size of the authenticated encryption algorithm.
    


## SINCE



           3.2.2
    


* * *
# posix_spawn_file_actions_addopen

## 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_spawn_file_actions_addopen — add open action to spawn file
           actions object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawn_file_actions_addopen(posix_spawn_file_actions_t
               *restrict _file_actions_ , int _fildes_ ,
               const char *restrict _path_ , int _oflag_ , mode_t _mode_);
    


## DESCRIPTION



           Refer to posix_spawn_file_actions_addclose(3p).
    


* * *
# getegid

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



           getegid — get the effective group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           gid_t getegid(void);
    


## DESCRIPTION



           The _getegid_() function shall return the effective group ID of the
           calling process.  The _getegid_() function shall not modify _errno_.
    


## RETURN VALUE



           The _getegid_() function shall always be successful and no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           In a conforming environment, _getegid_() will always succeed. It is
           possible for implementations to provide an extension where a
           process in a non-conforming environment will not be associated
           with a user or group ID. It is recommended that such
           implementations return (**gid_t**)-1 and set _errno_ to indicate such an
           environment; doing so does not violate this standard, since such
           an environment is already an extension.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::user_uint8_error

## NAME



           function::user_uint8_error - Retrieves a unsigned 8-bit integer
           value stored in user space
    


## SYNOPSIS



               user_uint8_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned 8-bit integer
               from
    


## DESCRIPTION



           Returns the unsigned 8-bit integer value from a given user space
           address. If the user space data is not accessible, an error will
           occur.
    


* * *
# tep_set_loglevel

## NAME



           tep_set_loglevel - Set log level of the library
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           enum **tep_loglevel**{
                   TEP_LOG_NONE = 0,
                   TEP_LOG_CRITICAL,
                   TEP_LOG_ERROR,
                   TEP_LOG_WARNING,
                   TEP_LOG_INFO,
                   TEP_LOG_DEBUG,
                   TEP_LOG_ALL
           };
    
           int **tep_set_loglevel**(enum tep_loglevel _level_);
    


## DESCRIPTION



           The **tep_set_loglevel()** function sets the level of the library logs
           that will be printed on the console. Library log levels are:
    
                       _TEP_LOG_NONE_ - Do not print any logs.
                       _TEP_LOG_CRITICAL_ - Print critical logs, problem that may cause a crash.
                       _TEP_LOG_ERROR_ - Print error logs, problem that could break the main logic of an API.
                       _TEP_LOG_WARNING_ - Print warnings, problem that could limit the result of an API.
                       _TEP_LOG_INFO_ - Print information about normal execution of an API.
                       _TEP_LOG_DEBUG_ - Print debug information.
                       _TEP_LOG_ALL_ - Print logs from all levels.
    
           Setting the log level to specific value means that logs from the
           previous levels will be printed too. For example _TEP_LOG_WARNING_
           will print any logs with severity _TEP_LOG_WARNING_ , _TEP_LOG_ERROR_
           and _TEP_LOG_CRITICAL_. The default log level is _TEP_LOG_CRITICAL_.
    


## EXAMPLE



               #include <event-parse.h>
    
               tep_set_loglevel(TEP_LOG_ALL);
               ...
               /* call libtraceevent APIs and observe any logs they produce */
               ...
               tep_set_loglevel(TEP_LOG_CRITICAL);
    


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


* * *