tripathysagar/man_text huggingface dataset:
# io_uring_prep_link_timeout

## NAME



           io_uring_prep_link_timeout - a timeout request for linked sqes
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_link_timeout(struct io_uring_sqe ***_sqe_**,**
                                           **struct __kernel_timespec ***_ts_**,**
                                           **unsigned** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_link_timeout(3) function prepares a timeout
           request for linked sqes. The submission queue entry _sqe_ is
           setup for with timeout specified by _ts_.  The flags argument holds
           modifier _flags_ for the timeout behaviour of the request.
    
           The _ts_ argument must be filled in with the appropriate information
           for the timeout. It looks as follows:
    
               struct __kernel_timespec {
                   __kernel_time64_t tv_sec;
                   long long tv_nsec;
               };
    
           The _flags_ argument may contain:
    
           **IORING_TIMEOUT_ABS**
                  The value specified in _ts_ is an absolute value rather than
                  a relative one.
    
           **IORING_TIMEOUT_BOOTTIME**
                  The boottime clock source should be used.
    
           **IORING_TIMEOUT_REALTIME**
                  The realtime clock source should be used.
    
           **IORING_TIMEOUT_ETIME_SUCCESS**
                  Consider an expired timeout a success in terms of the
                  posted completion.
    
           It is invalid to create a chain (linked sqes) consisting only of a
           link timeout request. If all the requests in the chain are
           completed before timeout, then the link timeout request gets
           canceled. Upon timeout, all the uncompleted requests in the chain
           get canceled.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field. On
           success, **0** is returned.
    
           **-ETIME** The specified timeout occurred and triggered the completion
                  event.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid. For example,
                  two clock sources where given, or the specified timeout
                  seconds or nanoseconds where < 0.
    
           **-EFAULT**
                  io_uring was unable to access the data specified by ts.
    
           **-ECANCELED**
                  The timeout was canceled because all submitted requests
                  were completed successfully or one of the requests resulted
                  in failure.
    
           **-ENOENT**
                  The request to which the linked timeout was linked already
                  completed and could not be found when the timer expired.
    


* * *
# gnutls_x509_trust_list_remove_trust_file

## NAME



           gnutls_x509_trust_list_remove_trust_file - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_trust_list_remove_trust_file(gnutls_x509_trust_list_t**
           _list_**, const char ***_ca_file_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const char * ca_file
                       A file containing a list of CAs
    
           gnutls_x509_crt_fmt_t type
                       The format of the certificates
    


## DESCRIPTION



           This function will remove the given certificate authorities from
           the trusted list, and add them into a block list when needed.
           PKCS 11 URLs are also accepted, instead of files, by this
           function.
    
           See also **gnutls_x509_trust_list_remove_cas()**.
    


## RETURNS



           The number of added elements is returned.
    


## SINCE



           3.1.10
    


* * *
# gnutls_x509_crt_get_extension_oid

## NAME



           gnutls_x509_crt_get_extension_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_extension_oid(gnutls_x509_crt_t** _cert_**,**
           **unsigned** _indx_**, void ***_oid_**, size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned indx
                       Specifies which extension OID to send. Use (0) to get
                       the first one.
    
           void * oid  a pointer to a structure to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the requested extension OID in the
           certificate.  The extension OID will be stored as a string in the
           provided buffer.
    
           The  _oid_ returned will be null terminated, although  _oid_size_ will
           not account for the trailing null.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# gnutls_ocsp_resp_get_responder

## NAME



           gnutls_ocsp_resp_get_responder - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_responder(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_datum_t ***_dn_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           gnutls_datum_t * dn
                       newly allocated buffer with name
    


## DESCRIPTION



           This function will extract the name of the Basic OCSP Response in
           the provided buffer. The name will be in the form
           "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string
           will be ASCII or UTF-8 encoded, depending on the certificate data.
    
           If the responder ID is not a name but a hash, this function will
           return zero and the  _dn_ elements will be set to **NULL**.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _dn_ ->data.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_ocsp_resp_get_responder2()**.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned. When no data exist it will return success
           and set  _dn_ elements to zero.
    


* * *
# capng_capability_to_name

## NAME



           capng_capability_to_name - convert capability integer to text
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           const char *capng_capability_to_name(unsigned int capability);
    


## DESCRIPTION



           capng_capability_to_name will take the integer being passed and
           look it up to see what its text string representation would be.
           The integer being input must be in the valid range defined in
           linux/capability.h. The string that is output is the same as the
           define text from linux/capability.h with the CAP_ prefix removed
           and lower case. This is useful for taking integer representation
           and converting it to something more user friendly for display.
    


## RETURN VALUE



           This returns a NULL pointer on failure and the correct string
           otherwise.
    


* * *
# gnutls_x509_crl_check_issuer

## NAME



           gnutls_x509_crl_check_issuer - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crl_check_issuer(gnutls_x509_crl_t** _crl_**,**
           **gnutls_x509_crt_t** _issuer_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       is the CRL to be checked
    
           gnutls_x509_crt_t issuer
                       is the certificate of a possible issuer
    


## DESCRIPTION



           This function will check if the given CRL was issued by the given
           issuer certificate.
    


## RETURNS



           true(1) if the given CRL was issued by the given issuer, and false
           (0) if not.
    


* * *
# io_uring_prep_fsync

## NAME



           io_uring_prep_fsync - prepare an fsync request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_fsync(struct io_uring_sqe ***_sqe_**,**
                                    **int** _fd_**,**
                                    **unsigned** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_fsync(3) function prepares an fsync request. The
           submission queue entry _sqe_ is setup to use the file descriptor _fd_
           that should get synced, with the modifier flags indicated by the
           _flags_ argument.
    
           This function prepares an fsync request. It can act either like an
           fsync(2) operation, which is the default behavior. If
           **IORING_FSYNC_DATASYNC** is set in the _flags_ argument, then it
           behaves like fdatasync(2).  If no range is specified, the _fd_ will
           be synced from 0 to end-of-file.
    
           It's possible to specify a range to sync, if one is desired. If
           the _off_ field of the SQE is set to non-zero, then that indicates
           the offset to start syncing at. If _len_ is set in the SQE, then
           that indicates the size in bytes to sync from the offset. Note
           that these fields are not accepted by this helper, so they have to
           be set manually in the SQE after calling this prep helper.
    


## RETURN VALUE



           None
    


## ERRORS



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


* * *
# gnutls_pubkey_import_dh_raw

## NAME



           gnutls_pubkey_import_dh_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_dh_raw(gnutls_pubkey_t** _key_**, const**
           **gnutls_dh_params_t** _params_**, const gnutls_datum_t ***_y_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The structure to store the parsed key
    
           const gnutls_dh_params_t params
                       holds the **gnutls_dh_params_t**
    
           const gnutls_datum_t * y
                       holds the y
    


## DESCRIPTION



           This function will convert the given Diffie-Hellman raw parameters
           to the native **gnutls_pubkey_t** format.  The output will be stored
           in  _key_ .
    


## RETURNS



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


## SINCE



           3.8.2
    


* * *
# gnutls_x509_crq_get_key_purpose_oid

## NAME



           gnutls_x509_crq_get_key_purpose_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_key_purpose_oid(gnutls_x509_crq_t** _crq_**,**
           **unsigned** _indx_**, void ***_oid_**, size_t ***_sizeof_oid_**, unsigned int ***
           _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned indx
                       This specifies which OID to return, use (0) to get the
                       first one
    
           void * oid  a pointer to store the OID (may be **NULL**)
    
           size_t * sizeof_oid
                       initially holds the size of  _oid_
    
           unsigned int * critical
                       output variable with critical flag, may be **NULL**.
    


## DESCRIPTION



           This function will extract the key purpose OIDs of the Certificate
           specified by the given index.  These are stored in the Extended
           Key Usage extension (2.5.29.37).  See the GNUTLS_KP_* definitions
           for human readable names.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the * _sizeof_oid_ will be updated with the
           required size.  On success 0 is returned.
    


## SINCE



           2.8.0
    


* * *
# libpfm_intel_bdx_unc_sbo

## NAME



           libpfm_intel_bdx_unc_sbo - support for Intel Broadwell Server S-
           Box uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: bdx_unc_sbo**
           **PMU desc: Intel Broadwell Server S-Box uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Broadwell server Ring Transfer unit
           (S-Box) uncore PMU.  This PMU model only exists on various
           Broadwell server models (79, 86).
    


## MODIFIERS



           The following modifiers are supported on Intel Broadwell server S-
           Box uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of HA cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:15].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# mq_unlink

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



           mq_unlink — remove a message queue (**REALTIME**)
    


## SYNOPSIS



           #include <mqueue.h>
    
           int mq_unlink(const char *_name_);
    


## DESCRIPTION



           The _mq_unlink_() function shall remove the message queue named by
           the string name.  If one or more processes have the message queue
           open when _mq_unlink_() is called, destruction of the message queue
           shall be postponed until all references to the message queue have
           been closed. However, the _mq_unlink_() call need not block until
           all references have been closed; it may return immediately.
    
           After a successful call to _mq_unlink_(), reuse of the name shall
           subsequently cause _mq_open_() to behave as if no message queue of
           this name exists (that is, _mq_open_() will fail if O_CREAT is not
           set, or will create a new message queue if O_CREAT is set).
    


## RETURN VALUE



           Upon successful completion, the function shall return a value of
           zero.  Otherwise, the named message queue shall be unchanged by
           this function call, and the function shall return a value of -1
           and set _errno_ to indicate the error.
    


## ERRORS



           The _mq_unlink_() function shall fail if:
    
           **EACCES** Permission is denied to unlink the named message queue.
    
           **EINTR** The call to _mq_unlink_() blocked waiting for all references
                  to the named message queue to be closed and a signal
                  interrupted the call.
    
           **ENOENT** The named message queue does not exist.
    
           The _mq_unlink_() function may fail if:
    
           **ENAMETOOLONG**
                  The length of the _name_ argument exceeds {_POSIX_PATH_MAX}
                  on systems that do not support the XSI option or exceeds
                  {_XOPEN_PATH_MAX} on XSI systems, or has a pathname
                  component that is longer than {_POSIX_NAME_MAX} on systems
                  that do not support the XSI option or longer than
                  {_XOPEN_NAME_MAX} on XSI systems.  A call to _mq_unlink_()
                  with a _name_ argument that contains the same message queue
                  name as was previously used in a successful _mq_open_() call
                  shall not give an **[ENAMETOOLONG]** error.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           A future version might require the _mq_open_() and _mq_unlink_()
           functions to have semantics similar to normal file system
           operations.
    


* * *
# calloc

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



           calloc — a memory allocator
    


## SYNOPSIS



           #include <stdlib.h>
    
           void *calloc(size_t _nelem_ , size_t _elsize_);
    


## 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 _calloc_() function shall allocate unused space for an array of
           _nelem_ elements each of whose size in bytes is _elsize_.  The space
           shall be initialized to all bits 0.
    
           The order and contiguity of storage allocated by successive calls
           to _calloc_() is unspecified. The pointer returned if the allocation
           succeeds shall be suitably aligned so that it may be assigned to a
           pointer to any type of object and then used to access such an
           object or an array of such objects in the space allocated (until
           the space is explicitly freed or reallocated). Each such
           allocation shall yield a pointer to an object disjoint from any
           other object. The pointer returned shall point to the start
           (lowest byte address) of the allocated space. If the space cannot
           be allocated, a null pointer shall be returned. If the size of the
           space requested is 0, the behavior is implementation-defined:
           either a null pointer shall be returned, or the behavior shall be
           as if the size were some non-zero value, except that the behavior
           is undefined if the returned pointer is used to access an object.
    


## RETURN VALUE



           Upon successful completion with both _nelem_ and _elsize_ non-zero,
           _calloc_() shall return a pointer to the allocated space. If either
           _nelem_ or _elsize_ is 0, then either:
    
            *  A null pointer shall be returned and _errno_ may be set to an
               implementation-defined value, or
    
            *  A pointer to the allocated space shall be returned. The
               application shall ensure that the pointer is not used to
               access an object.
    
           Otherwise, it shall return a null pointer and set _errno_ to
           indicate the error.
    


## ERRORS



           The _calloc_() function shall fail if:
    
           **ENOMEM** Insufficient memory is available.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           There is now no requirement for the implementation to support the
           inclusion of _< malloc.h>_.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_create_entry

## NAME



           **acl_create_entry** — create a new ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_create_entry**(_acl_t *acl_p_ ,
           _acl_entry_t *entry_p_)
    


## DESCRIPTION



           The **acl_create_entry**() function creates a new ACL entry in the ACL
           pointed to by the contents of the pointer argument _acl_p_.  On
           success, the function returns a descriptor for the new ACL entry
           via _entry_p_.
    
           This function may cause memory to be allocated.  The caller should
           free any releasable memory, when the new ACL is no longer
           required, by calling _acl_free_(3) with _(void*)*acl_p_ as an
           argument.  If the ACL working storage cannot be increased in the
           current location, then the working storage for the ACL pointed to
           by _acl_p_ may be relocated and the previous working storage is
           released. A pointer to the new working storage is returned via
           _acl_p_.
    
           The components of the new ACL entry are initialized in the
           following ways: the ACL tag type component contains
           ACL_UNDEFINED_TAG, the qualifier component contains
           ACL_UNDEFINED_ID, and the set of permissions has no permissions
           enabled. Any existing ACL entry descriptors that refer to entries
           in the ACL continue to refer to those entries.
    


## RETURN VALUE



           The **acl_create_entry**() 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_create_entry**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_p_ is not a valid pointer to an
                              ACL.
    
           [ENOMEM]           The ACL working storage requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    


## STANDARDS



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


* * *
# pmwhichzone

## NAME



           **pmWhichZone** - return current reporting timezone
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmWhichZone(char ****_tz_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  current  reporting  timezone  effects  the  timezone  used by
           pmCtime(3) and pmLocaltime(3).
    
           **pmWhichZone** returns the handle of the current timezone, as  previ‐
           ously    established    by    a    call    to    pmNewZone(3)   or
           pmNewContextZone(3).  If the call is successful (i.e. there exists
           a current reporting timezone) then a non-negative integer  is  re‐
           turned  and  _tz_  is set to point to a static buffer containing the
           timezone string itself.
    


## DIAGNOSTICS



           A return value less than zero indicates there is  no  current  re‐
           porting timezone.
    


* * *
# tapset::ip

## NAME



           tapset::ip - systemtap ip tapset
    


## DESCRIPTION



           **format_ipaddr**
                  Returns a string representation for an IP address
    
                  See function::format_ipaddr(3stap)
                   for details.
    
           **ip_ntop**
                  Returns a string representation for an IPv4 address
    
                  See function::ip_ntop(3stap)
                   for details.
    


* * *
# pmdastore

## NAME



           **pmdaStore** - store a value into a metric for a PMDA
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaStore(pmResult ***_result_**, pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), **pmdaStore** is the generic callback for  storing  a  value
           into  a  metric.   **pmdaStore** is usually a no-op as, by default, no
           metrics can be altered.  Also, the implementation of a store call‐
           back which does permit metrics to be altered by pmstore(1) is very
           application dependent.
    


## CAVEAT



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


## DIAGNOSTICS



           **pmdaStore** returns  **PM_ERR_PERMISSION** to indicate that no metrics
           may be modified.
    


* * *
# libpfm_intel_tmt

## NAME



           libpfm_intel_tmt - support for Intel Tremont core PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: tmt**
           **PMU desc: Intel Tremont**
    


## DESCRIPTION



           The library supports the Intel Tremont core PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Tremont processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  counter mask modifier (m) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    


## OFFCORE_RESPONSE events



           Intel Tremont provides two offcore_response events:
           **OFFCORE_RESPONSE_0** and **OFFCORE_RESPONSE_1**. The  **OCR** event is
           aliased to **OFFCORE_RESPONSE_0**.
    
           Those events need special treatment in the performance monitoring
           infrastructure because each event uses an extra register to store
           some settings. Thus, in case multiple offcore_response events are
           monitored simultaneously, the kernel needs to manage the sharing
           of that extra register.
    
           The offcore_response event is exposed as a normal event by the
           library. The extra settings are exposed as regular umasks. The
           library takes care of encoding the events according for the
           underlying kernel interface.
    
           On Intel Tremont, it is not possible to combine the request,
           supplier, snoop, fields anymore to avoid invalid combinations. As
           such, the umasks provided by the library are the only ones
           supported and validated.
    


* * *
# function::fastcall

## NAME



           function::fastcall - Mark function as declared fastcall
    


## SYNOPSIS



               fastcall()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Call this function before accessing arguments using the *_arg
           functions if the probed kernel function was declared fastcall in
           the source.
    


* * *
# pmarewritemeta

## NAME



           **pmaRewriteMeta** - try to change the version of an archive metadata
           record
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **int pmaRewriteMeta(__pmLogCtl ***_inlcp_**, __pmLogCtl ***_outlcp_**,**
                              **__int32_t ***_rbuf_**);**
    
           **cc ... -lpcp_archive -lpcp**
    


## CAVEAT



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


## DESCRIPTION



           A physical metadata record from the input  archive  identified  by
           _inlcp_ is passed in via _rbuf_ and this is reformatted if required to
           produce  the  equivalent  metadata  record  for the output archive
           identified by _outlcp_.
    
           Combined with the input and output archive versions, the  type  of
           the metadata record (as extracted from _rbuf_) is used to decide if;
           for  some  record  types  and  version changes no rewriting is re‐
           quired.
    
           **pmaRewriteMeta** is intended to be used in cases where  the  archive
           version  of  _inlcp_ and _outlcp_ are different.  The only sane choice
           of  archive  versions  today  is  **PM_LOG_VERS02** for   _inlcp_   and
           **PM_LOG_VERS03** for _outlcp_ , which would be requesting a rewrite from
           archive version 2 format to archive version 3 format (as only ver‐
           sions 2 and 3 are currently supported).
    
           If  rewriting takes place the old _rbuf_ will have been free'd and a
           new _rbuf_ allocated with malloc(3).  It is the  caller's  responsi‐
           bility to make sure this potential free-and-allocate will be safe,
           e.g.  no dangling references into the contents of _rbuf_ , or pass in
           a copy of the record if it is precious.
    


## DIAGNOSTICS AND RETURN VALUES



           In several places, fatal errors will trigger an error message  and
           force the application to exit.
    
           If  there  is no defined translation for the versions of _inlcp_ and
           _outlcp_ then **pmaRewriteMeta** returns  **PM_ERR_APPVERSION**(a  slight
           perversion of this error code).
    
           If no rewrite is performed, the return value is 0, otherwise a re‐
           turn  value  of 1 indicates a rewrite has taken place and _rbuf_ has
           been reallocated.
    


* * *
# function::return_str

## NAME



           function::return_str - Formats the return value as a string
    


## SYNOPSIS



               return_str:string(format:long,ret:long)
    


## ARGUMENTS



           _format_
               Variable to determine return type base value
    
           _ret_
               Return value (typically **$return**)
    


## DESCRIPTION



           This function is used by the syscall tapset, and returns a string.
           Set format equal to 1 for a decimal, 2 for hex, 3 for octal.
    
           Note that this function is preferred over **returnstr**.
    


* * *
# wcscpy

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



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


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcpcpy(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_);
           wchar_t *wcscpy(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_);
    


## DESCRIPTION



           For _wcscpy_(): 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 _wcpcpy_() and _wcscpy_() functions shall copy the wide-character
           string pointed to by _ws2_ (including the terminating null wide-
           character code) into the array pointed to by _ws1_.
    
           The application shall ensure that there is room for at least
           _wcslen_(_ws2_)+1 wide characters in the _ws1_ array, and that the _ws2_
           and _ws1_ arrays do not overlap.
    
           If copying takes place between objects that overlap, the behavior
           is undefined.
    


## RETURN VALUE



           The _wcpcpy_() function shall return a pointer to the terminating
           null wide-character code copied into the _ws1_ buffer.
    
           The _wcscpy_() function shall return _ws1_.
    
           No return values are reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::sa_handler_str

## NAME



           function::sa_handler_str - Returns the string representation of an
           sa_handler
    


## SYNOPSIS



               sa_handler_str(handler:)
    


## ARGUMENTS



           _handler_
               the sa_handler to convert to string.
    


## DESCRIPTION



           Returns the string representation of an sa_handler. If it is not
           SIG_DFL, SIG_IGN or SIG_ERR, it will return the address of the
           handler.
    


* * *
# gnutls_x509_name_constraints_add_excluded

## NAME



           gnutls_x509_name_constraints_add_excluded - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_name_constraints_add_excluded(gnutls_x509_name_constraints_t**
           _nc_**, gnutls_x509_subject_alt_name_t** _type_**, const gnutls_datum_t ***
           _name_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t nc
                       The nameconstraints
    
           gnutls_x509_subject_alt_name_t type
                       The type of the constraints
    
           const gnutls_datum_t * name
                       The data of the constraints
    


## DESCRIPTION



           This function will add a name constraint to the list of excluded
           constraints. The constraints  _type_ can be any of the following
           types: **GNUTLS_SAN_DNSNAME** , **GNUTLS_SAN_RFC822NAME** , **GNUTLS_SAN_DN** ,
           **GNUTLS_SAN_URI** , **GNUTLS_SAN_IPADDRESS**. For the latter, an IP
           address in network byte order is expected, followed by its network
           mask (which is 4 bytes in IPv4 or 16-bytes in IPv6).
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_certificate_free_cas

## NAME



           gnutls_certificate_free_cas - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_certificate_free_cas(gnutls_certificate_credentials_t**
           _sc_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    


## DESCRIPTION



           This function was operational on very early versions of gnutls.
           Due to internal refactorings and the fact that this was hardly
           ever used, it is currently a no-op.
    


* * *
# capng_get_rootid

## NAME



           capng_get_rootid - get namespace root id
    


## SYNOPSIS



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


## DESCRIPTION



           capng_get_rootid gets the rootid for capabilities operations. This
           is only applicable for file system operations.
    


## RETURN VALUE



           If the file is in the init namespace or the kernel does not
           support V3 file system capabilities, it returns
           CAPNG_UNSET_ROOTID. Otherwise it return an integer for the
           namespace root id.
    


* * *
# gnutls_cipher_get_block_size

## NAME



           gnutls_cipher_get_block_size - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_cipher_algorithm_t algorithm
                       is an encryption algorithm
    


## RETURNS



           the block size of the encryption algorithm.
    


## SINCE



           2.10.0
    


* * *
# probe::nfs.aop.writepages

## NAME



           probe::nfs.aop.writepages - NFS client writing several dirty pages
           to the NFS server
    


## SYNOPSIS



           nfs.aop.writepages
    


## VALUES



           _dev_
               device identifier
    
           _ino_
               inode number
    
           _for_kupdate_
               a flag of writeback_control, indicates if it's a kupdate
               writeback
    
           _nr_to_write_
               number of pages attempted to be written in this execution
    
           _wpages_
               write size (in pages)
    
           _size_
               number of pages attempted to be written in this execution
    
           _wsize_
               write size
    
           _for_reclaim_
               a flag of writeback_control, indicates if it's invoked from
               the page allocator
    


## DESCRIPTION



           The priority of wb is decided by the flags _for_reclaim_ and
           _for_kupdate_.
    


* * *
# matchpathcon_checkmatches

## NAME



           matchpathcon_checkmatches, matchpathcon_filespec_add,
           matchpathcon_filespec_destroy, matchpathcon_filespec_eval - check
           and report whether any specification index has no matches with any
           inode. Maintenance and statistics on inode associations
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **void matchpathcon_checkmatches(char ***_str_**);**
    
           **int matchpathcon_filespec_add(ino_t** _ino_**, int** _specind_**, const char**
           *****_file_**);**
    
           **void matchpathcon_filespec_destroy(void);**
    
           **void matchpathcon_filespec_eval(void);**
    


## DESCRIPTION



           **matchpathcon_checkmatches**() checks whether any specification has
           no matches and reports them.  The _str_ argument is used as a prefix
           for any warning messages.
    
           **matchpathcon_filespec_add**() maintains an association between an
           inode _ino_ and a specification index _specind_ , and checks whether a
           conflicting specification is already associated with the same
           inode (e.g. due to multiple hard links). If so, then it uses the
           latter of the two specifications based on their order in the _file_
           context configuration. Returns the specification index used or -1
           on error.
    
           **matchpathcon_filespec_destroy**() destroys any inode associations
           that have been added, e.g. to restart for a new filesystem.
    
           **matchpathcon_filespec_eval**() displays statistics on the hash table
           usage for the inode associations.
    


## RETURN VALUE



           Returns zero on success or -1 otherwise.
    


* * *
# function::errno_str

## NAME



           function::errno_str - Symbolic string associated with error code
    


## SYNOPSIS



               errno_str:string(err:long)
    


## ARGUMENTS



           _err_
               The error number received
    


## DESCRIPTION



           This function returns the symbolic string associated with the
           giver error code, such as ENOENT for the number 2, or E#3333 for
           an out-of-range value such as 3333.
    


* * *
# gnutls_server_name_get

## NAME



           gnutls_server_name_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_server_name_get(gnutls_session_t** _session_**, void ***_data_**,**
           **size_t ***_data_length_**, unsigned int ***_type_**, unsigned int** _indx_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * data will hold the data
    
           size_t * data_length
                       will hold the data length. Must hold the maximum size
                       of data.
    
           unsigned int * type
                       will hold the server name indicator type
    
           unsigned int indx
                       is the index of the server_name
    


## DESCRIPTION



           This function will allow you to get the name indication (if any),
           a client has sent.  The name indication may be any of the
           enumeration gnutls_server_name_type_t.
    
           If  _type_ is GNUTLS_NAME_DNS, then this function is to be used by
           servers that support virtual hosting, and the data will be a null
           terminated IDNA ACE string (prior to GnuTLS 3.4.0 it was a UTF-8
           string).
    
           If  _data_ has not enough size to hold the server name
           GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and  _data_length_ will
           hold the required size.
    
            _indx_ is used to retrieve more than one server names (if sent by
           the client).  The first server name has an index of 0, the second
           1 and so on.  If no name with the given index exists
           GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, on UTF-8 decoding
           error **GNUTLS_E_IDNA_ERROR** is returned, otherwise a negative error
           code is returned.
    


* * *
# gnutls_certificate_set_x509_key_mem

## NAME



           gnutls_certificate_set_x509_key_mem - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_key_mem(gnutls_certificate_credentials_t**
           _res_**, const gnutls_datum_t ***_cert_**, const gnutls_datum_t ***_key_**,**
           **gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const gnutls_datum_t * cert
                       contains a certificate list (path) for the specified
                       private key
    
           const gnutls_datum_t * key
                       is the private key, or **NULL**
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER
    


## DESCRIPTION



           This function sets a certificate/private key pair in the
           gnutls_certificate_credentials_t type. This function may be called
           more than once, in case multiple keys/certificates exist for the
           server.
    
           Note that the keyUsage (2.5.29.15) PKIX extension in X.509
           certificates is supported. This means that certificates intended
           for signing cannot be used for ciphersuites that require
           encryption.
    
           If the certificate and the private key are given in PEM encoding
           then the strings that hold their values must be null terminated.
    
           The  _key_ may be **NULL** if you are using a sign callback, see
           **gnutls_sign_callback_set()**.
    
           Note that, this function by default returns zero on success and a
           negative value on error.  Since 3.5.6, when the flag
           **GNUTLS_CERTIFICATE_API_V2** is set using
           **gnutls_certificate_set_flags()** it returns an index (greater or
           equal to zero). That index can be used to other functions to refer
           to the added key-pair.
    


## RETURNS



           On success this functions returns zero, and otherwise a negative
           value on error (see above for modifying that behavior).
    


* * *
# function::user_string_quoted_utf16

## NAME



           function::user_string_quoted_utf16 - Quote given user UTF-16
           string.
    


## SYNOPSIS



               user_string_quoted_utf16:string(addr:long)
    


## ARGUMENTS



           _addr_
               The user address to retrieve the string from
    


## DESCRIPTION



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


* * *
# isnormal

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



           isnormal — test for a normal value
    


## SYNOPSIS



           #include <math.h>
    
           int isnormal(real-floating _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.
    
           The _isnormal_() macro shall determine whether its argument value is
           normal (neither zero, subnormal, infinite, nor NaN). First, an
           argument represented in a format wider than its semantic type is
           converted to its semantic type. Then determination is based on the
           type of the argument.
    


## RETURN VALUE



           The _isnormal_() macro shall return a non-zero value if and only if
           its argument has a normal value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *