tripathysagar/man_text huggingface dataset:
# posix_trace_eventtypelist_getnext_id

## 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_eventtypelist_getnext_id,
           posix_trace_eventtypelist_rewind — iterate over a mapping of trace
           event types (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_eventtypelist_getnext_id(trace_id_t _trid_ ,
               trace_event_id_t *restrict _event_ , int *restrict _unavailable_);
           int posix_trace_eventtypelist_rewind(trace_id_t _trid_);
    


## DESCRIPTION



           The first time _posix_trace_eventtypelist_getnext_id_() is called,
           the function shall return in the variable pointed to by _event_ the
           first trace event type identifier of the list of trace events of
           the trace stream identified by the _trid_ argument. Successive calls
           to _posix_trace_eventtypelist_getnext_id_() return in the variable
           pointed to by _event_ the next trace event type identifier in that
           same list. Each time a trace event type identifier is successfully
           written into the variable pointed to by the _event_ argument, the
           variable pointed to by the _unavailable_ argument shall be set to
           zero. When no more trace event type identifiers are available, and
           so none is returned, the variable pointed to by the _unavailable_
           argument shall be set to a value different from zero.
    
           The _posix_trace_eventtypelist_rewind_() function shall reset the
           next trace event type identifier to be read to the first trace
           event type identifier from the list of trace events used in the
           trace stream identified by _trid_.
    


## RETURN VALUE



           Upon successful completion, these functions shall return a value
           of zero. Otherwise, they shall return the corresponding error
           number.
    
           The _posix_trace_eventtypelist_getnext_id_() function stores the
           trace event type identifier value in the object pointed to by
           _event_ , if successful.
    


## ERRORS



           These functions shall fail if:
    
           **EINVAL** The _trid_ argument was not a valid trace stream identifier.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           The _posix_trace_eventtypelist_getnext_id_() and
           _posix_trace_eventtypelist_rewind_() functions may be removed in a
           future version.
    


* * *
# init_selinuxmnt

## NAME



           init_selinuxmnt - initialize the global variable selinux_mnt
    


## SYNOPSIS



           **static void init_selinuxmnt(void);**
    
           **static void fini_selinuxmnt(void);**
    
           **void set_selinuxmnt(const char ***_mnt_**);**
    


## DESCRIPTION



           **init_selinuxmnt**() initializes the global variable _selinux_mnt_ to
           the selinuxfs mountpoint.
    
           **fini_selinuxmnt**() deinitializes the global variable _selinux_mnt_
           that stores the selinuxfs mountpoint.
    
           **set_selinuxmnt**() changes the selinuxfs mountpoint to _mnt_.
    


* * *
# gnutls_certificate_verify_peers3

## NAME



           gnutls_certificate_verify_peers3 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_certificate_verify_peers3(gnutls_session_t** _session_**,**
           **const char ***_hostname_**, unsigned int ***_status_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           const char * hostname
                       is the expected name of the peer; may be **NULL**
    
           unsigned int * status
                       is the output of the verification
    


## DESCRIPTION



           This function will verify the peer's certificate and store the the
           status in the  _status_ variable as a bitwise OR of
           gnutls_certificate_status_t values or zero if the certificate is
           trusted. Note that value in  _status_ is set only when the return
           value of this function is success (i.e, failure to trust a
           certificate does not imply a negative return value).  The default
           verification flags used by this function can be overridden using
           **gnutls_certificate_set_verify_flags()**. See the documentation of
           **gnutls_certificate_verify_peers2()** for details in the verification
           process.
    
           This function will take into account the stapled OCSP responses
           sent by the server, as well as the following X.509 certificate
           extensions: Name Constraints, Key Usage, and Basic Constraints
           (pathlen).
    
           If the  _hostname_ provided is non-NULL then this function will
           compare the hostname in the certificate against it. The comparison
           will follow the RFC6125 recommendations. If names do not match the
           **GNUTLS_CERT_UNEXPECTED_OWNER** status flag will be set.
    
           In order to verify the purpose of the end-certificate (by checking
           the extended key usage), use **gnutls_certificate_verify_peers()**.
    
           To avoid denial of service attacks some default upper limits
           regarding the certificate key size and chain size are set. To
           override them use **gnutls_certificate_set_verify_limits()**.
    
           Note that when using raw public-keys verification will not work
           because there is no corresponding certificate body belonging to
           the raw key that can be verified. In that case this function will
           return **GNUTLS_E_INVALID_REQUEST**.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) when the validation is performed, or a
           negative error code otherwise.  A successful error code means that
           the  _status_ parameter must be checked to obtain the validation
           status.
    


## SINCE



           3.1.4
    


* * *
# function::user_string_utf32

## NAME



           function::user_string_utf32 - Retrieves UTF-32 string from user
           memory
    


## SYNOPSIS



           1) user_string_utf32:string(addr:long)
    
           2) user_string_utf32:string(addr:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               The user address to retrieve the string from
    
           _err_msg_
               The error message to return when data isn't available
    


## DESCRIPTION



           1) This function returns a null terminated UTF-8 string converted
           from the UTF-32 string at a given user memory address. Reports an
           error on string copy fault or conversion error.
    
           2) This function returns a null terminated UTF-8 string converted
           from the UTF-32 string at a given user memory address. Reports the
           given error message on string copy fault or conversion error.
    


* * *
# sd_journal_has_runtime_files

## NAME



           sd_journal_has_runtime_files, sd_journal_has_persistent_files -
           Query availability of runtime or persistent journal files
    


## SYNOPSIS



           **#include <systemd/sd-journal.h>**
    
           **int sd_journal_has_runtime_files(sd_journal ***_j_**);**
    
           **int sd_journal_has_persistent_files(sd_journal ***_j_**);**
    


## DESCRIPTION



           **sd_journal_has_runtime_files()** returns a positive value if runtime
           journal files (present in /run/systemd/journal/) have been found.
           Otherwise, returns 0.
    
           **sd_journal_has_persistent_files()** returns a positive value if
           persistent journal files (present in /var/log/journal/) have been
           found. Otherwise, returns 0.
    


## RETURN VALUE



           Both **sd_journal_has_runtime_files()** and
           **sd_journal_has_persistent_files()** return -EINVAL if their argument
           is **NULL**.
    


## NOTES



           All functions listed here are thread-agnostic and only a single
           specific thread may operate on a given object during its entire
           lifetime. It is safe to allocate multiple independent objects and
           use each from a specific thread in parallel. However, it is not
           safe to allocate such an object in one thread, and operate or free
           it from any other, even if locking is used to ensure these threads
           do not operate on it at the very same time.
    
           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    


* * *
# libpfm_intel_ivb_unc

## NAME



           libpfm_intel_ivb_unc - support for Intel Ivy Bridge uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivb_unc_cbo0, ivb_unc_cbo1, ivb_unc_cbo2, ivb_unc_cbo3**
           **PMU desc: Intel Ivy Bridge C-box uncore**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge client part (model 58)
           uncore PMU.  The support is currently limited to the Coherency
           Box, so called C-Box for up to 4 physical cores.
    
           Each physical core has an associated C-Box which it uses to
           communicate with the L3 cache. The C-boxes all support the same
           set of events. However, Core 0 C-box (snb_unc_cbo0) supports an
           additional uncore clock ticks event: **UNC_CLOCKTICKS**.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge C-Box
           uncore PMU:
    
           **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].
    
           Both the **UNC_CBO_CACHE_LOOKUP** and **UNC_CBO_XSNP_RESPONSE** requires
           two umasks to be valid.  For **UNC_CBO_CACHE_LOOKUP** the first umask
           must be one of the MESI state umasks, the second has to be one of
           the filters.  For **UNC_CBO_XSNP_RESPONSE** the first umask must be
           one of the snoop types, the second has to be one of the filters.
    


* * *
# io_uring_prep_mkdirat

## NAME



           io_uring_prep_mkdirat - prepare an mkdirat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <sys/stat.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_mkdirat(struct io_uring_sqe ***_sqe_**,**
                                      **int** _dirfd_**,**
                                      **const char ***_path_**,**
                                      **mode_t** _mode_**);**
    
           **void io_uring_prep_mkdir(struct io_uring_sqe ***_sqe_**,**
                                    **const char ***_path_**,**
                                    **mode_t** _mode_**);**
    


## DESCRIPTION



           The io_uring_prep_mkdirat(3) function prepares a mkdirat request.
           The submission queue entry _sqe_ is setup to use the directory file
           descriptor pointed to by _dirfd_ to start a mkdirat operation on the
           path identified by _path_ with the mode given in _mode_.
    
           The io_uring_prep_mkdir(3) function prepares a mkdir request. The
           submission queue entry _sqe_ is setup to use the current working
           directory to start a mkdir operation on the path identified by
           _path_ with the mode given in _mode_.
    
           These functions prepare an async mkdir(2) or mkdirat(2) request.
           See those man pages for details.
    


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


## NOTES



           As with any request that passes in data in a struct, that data
           must remain valid until the request has been successfully
           submitted. It need not remain valid until completion. Once a
           request has been submitted, the in-kernel state is stable. Very
           early kernels (5.4 and earlier) required state to be stable until
           the completion occurred. Applications can test for this behavior
           by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).
    


* * *
# toupper

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



           toupper, toupper_l — transliterate lowercase characters to
           uppercase
    


## SYNOPSIS



           #include <ctype.h>
    
           int toupper(int _c_);
           int toupper_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _toupper_(): 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 _toupper_() and _toupper_l_() functions have as a domain a type
           **int** , the value of which is representable as an **unsigned char** or
           the value of EOF. If the argument has any other value, the
           behavior is undefined.
    
           If the argument of _toupper_() or _toupper_l_() represents a lowercase
           letter, and there exists a corresponding uppercase letter as
           defined by character type information in the current locale or in
           the locale represented by _locale_ , respectively (category
           _LC_CTYPE_), the result shall be the corresponding uppercase letter.
    
           All other arguments in the domain are returned unchanged.
    
           The behavior is undefined if the _locale_ argument to _toupper_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           Upon successful completion, _toupper_() and _toupper_l_() shall return
           the uppercase letter corresponding to the argument passed;
           otherwise, they shall return the argument unchanged.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_aki_init

## NAME



           gnutls_x509_aki_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aki_init(gnutls_x509_aki_t ***_aki_**);**
    


## ARGUMENTS



           gnutls_x509_aki_t * aki
                       The authority key ID type
    


## DESCRIPTION



           This function will initialize an authority key ID.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# probe::sunrpc.clnt.shutdown_client

## NAME



           probe::sunrpc.clnt.shutdown_client - Shutdown an RPC client
    


## SYNOPSIS



           sunrpc.clnt.shutdown_client
    


## VALUES



           _progname_
               the RPC program name
    
           _om_ops_
               the count of operations
    
           _clones_
               the number of clones
    
           _om_bytes_recv_
               the count of bytes in
    
           _om_rtt_
               the RPC RTT jiffies
    
           _servername_
               the server machine name
    
           _tasks_
               the number of references
    
           _authflavor_
               the authentication flavor
    
           _port_
               the port number
    
           _prot_
               the IP protocol number
    
           _vers_
               the RPC program version number
    
           _rpccnt_
               the count of RPC calls
    
           _om_bytes_sent_
               the count of bytes out
    
           _om_queue_
               the jiffies queued for xmit
    
           _netreconn_
               the count of reconnections
    
           _om_execute_
               the RPC execution jiffies
    
           _prog_
               the RPC program number
    
           _om_ntrans_
               the count of RPC transmissions
    


* * *
# logimport

## NAME



           **LOGIMPORT** - introduction to the library for importing data and
           creating a PCP archive
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    


## Python SYNOPSIS



           **from pcp import pmi**
    


## DESCRIPTION



           The  Performance  Co-Pilot Log Import (LOGIMPORT) API is a library
           (with Perl and Python wrappers) that supports the creation of  PCP
           archives  from external sources of performance data, either in the
           form of historical logs and spreadsheets or from real-time sources
           that are **not** integrated as a Performance Metrics Domain Agent (PM‐
           DA) under the control of pmcd(1).
    
           The typical usage for LOGIMPORT would involve:
    
           •  An initial call to pmiStart(3).
    
           •  Optional calls to pmiSetHostname(3) and/or pmiSetTimezone(3) to
              set the hostname and timezone for the source of the performance
              data.
    
           •  One or more calls to pmiAddMetric(3) to define performance met‐
              rics.
    
           •  One or more calls to pmiAddInstance(3) to define instances as‐
              sociated with the metrics.
    
           •  Optional calls to pmiGetHandle(3) to defined convenience han‐
              dles for metric-instance pairs.
    
           •  A main loop in which performance data is ingested and for each
              sample time interval, the PCP archive record is constructed by
              calls to pmiPutValue(3), pmiPutValueHandle(3), pmiPutText(3),
              and/or pmiPutLabel(3), followed by a call to pmiWrite(3) to
              flush all data and any associated new metadata to the PCP
              archive.  Alternatively, pmiPutResult(3) could be used to pack‐
              age and process all the data for one sample time interval.
    
           •  Once the input source of data has been consumed, calling
              pmiEnd(3) to complete the PCP archive creation and close all
              open files.
    
           If new metrics and/or instances are discovered during the data in‐
           gestion, these can be added by subsequent calls to pmiAddMetric(3)
           and/or pmiAddInstance(3), provided all the metrics and instances
           have been defined before a call to pmiGetHandle(3),
           pmiPutValue(3)**or pmiPutResult**(3) that references those metrics and
           instances.
    


* * *
# gnutls_x509_crq_get_challenge_password

## NAME



           gnutls_x509_crq_get_challenge_password - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_challenge_password(gnutls_x509_crq_t** _crq_**,**
           **char ***_pass_**, size_t ***_pass_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           char * pass will hold a (0)-terminated password string
    
           size_t * pass_size
                       Initially holds the size of  _pass_ .
    


## DESCRIPTION



           This function will return the challenge password in the request.
           The challenge password is intended to be used for requesting a
           revocation of the certificate.
    


## RETURNS



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


* * *
# io_uring_prep_ftruncate

## NAME



           io_uring_prep_ftruncate - prepare an ftruncate request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_ftruncate(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **loff_t** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_ftruncate(3) function prepares an ftruncate
           request. The submission queue entry _sqe_ is setup to use the file
           descriptor _fd_ that should get truncated to the length indicated by
           the _len_ argument.
    
           Applications must define **_GNU_SOURCE** to obtain the definition of
           this helper, as _loff_t_ will not be defined without it.
    


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


* * *
# probe::signal.do_action

## NAME



           probe::signal.do_action - Examining or changing a signal action
    


## SYNOPSIS



           signal.do_action
    


## VALUES



           _oldsigact_addr_
               The address of the old sigaction struct associated with the
               signal
    
           _sig_name_
               A string representation of the signal
    
           _name_
               Name of the probe point
    
           _sig_
               The signal to be examined/changed
    
           _sa_mask_
               The new mask of the signal
    
           _sigact_addr_
               The address of the new sigaction struct associated with the
               signal
    
           _sa_handler_
               The new handler of the signal
    


* * *
# gnutls_pkcs11_copy_x509_privkey2

## NAME



           gnutls_pkcs11_copy_x509_privkey2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_x509_privkey2(const char ***_token_url_**,**
           **gnutls_x509_privkey_t** _key_**, const char ***_label_**, const**
           **gnutls_datum_t ***_cid_**, unsigned int** _key_usage_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_x509_privkey_t key
                       A private key
    
           const char * label
                       A name to be used for the stored data
    
           const gnutls_datum_t * cid
                       The CKA_ID to set for the object -if NULL, the ID will
                       be derived from the public key
    
           unsigned int key_usage
                       One of GNUTLS_KEY_*
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will copy a private key into a PKCS **11** token
           specified by a URL.
    
           Since 3.6.3 the objects are marked as sensitive by default unless
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_NOT_SENSITIVE** is specified.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# pthread_attr_setdetachstate

## 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_setdetachstate — set the detachstate attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_setdetachstate(pthread_attr_t *_attr_ , int _detachstate_);
    


## DESCRIPTION



           Refer to pthread_attr_getdetachstate(3p).
    


* * *
# libpfm_intel_snbep_unc_qpi

## NAME



           libpfm_intel_snbep_unc_qpi - support for Intel Sandy Bridge-EP QPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snbep_unc_qpi0, snbep_unc_qpi1**
           **PMU desc: Intel Sandy Bridge-EP QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge Power QPI uncore PMU.
           This PMU model only exists on Sandy Bridge model 45. There are two
           QPI PMUs per processor socket.
    


## MODIFIERS



           The following modifiers are supported on Intel Sandy Bridge QPI
           uncore PMU:
    
           **i** Invert the meaning of the event. The counter will now count
                  QPI 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
                  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 QPI 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].
    


* * *
# pmnameall

## NAME



           **pmNameAll** - translate a PMID to a set of performance metric names
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmNameAll(pmID** _pmid_**, char *****_nameset_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Given  a  Performance Metric Identifier (PMID) via _pmid_ , **pmNameAll**
           will determine all the corresponding metric names, if any, in  the
           Performance  Metrics Name Space (PMNS), and return these via _name‐_
           _set_.
    
           The resulting list of pointers _nameset_ **and** the values  (the  rela‐
           tive  names)  that the pointers reference will have been allocated
           by **pmNameAll** with a single call to malloc(3), and it  is  the  re‐
           sponsibility  of  the **pmNameAll** caller to use _free(nameset)_ to re‐
           lease the space when it is no longer required.
    
           In the absence of errors, **pmNameAll** returns the number of names in
           _nameset_.
    
           For many examples of a PMNS, there will be a 1:1 mapping between a
           name and a PMID, and under these circumstances,  pmNameID(3)  pro‐
           vides  a  slightly  simpler  interface in the absence of duplicate
           names for a particular PMID.
    


## DIAGNOSTICS



           **PM_ERR_NOPMNS**
                  Failed to access a PMNS for operation.  Note that if the
                  application hasn't a priori called pmLoadNameSpace(3) and
                  wants to use the distributed PMNS, then a call to **pmNameAll**
                  must be made after the creation of a context (see
                  pmNewContext(3)).
    
           **PM_ERR_PMID**
                  _pmid_ does not correspond to a defined PMID in the PMNS.
    
           **PM_ERR_***
                  Other diagnostics are for protocol failures when accessing
                  the distributed PMNS.
    


* * *
# gnutls_pkcs11_token_get_info

## NAME



           gnutls_pkcs11_token_get_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_token_get_info(const char ***_url_**,**
           **gnutls_pkcs11_token_info_t** _ttype_**, void ***_output_**, size_t ***
           _output_size_**);**
    


## ARGUMENTS



           const char * url
                       should contain a PKCS 11 URL
    
           gnutls_pkcs11_token_info_t ttype
                       Denotes the type of information requested
    
           void * output
                       where output will be stored
    
           size_t * output_size
                       contains the maximum size of the output buffer and
                       will be overwritten with the actual size.
    


## DESCRIPTION



           This function will return information about the PKCS 11 token such
           as the label, id, etc.
    
           When output is text, a null terminated string is written to
           _output_ and its string length is written to  _output_size_ (without
           null terminator). If the buffer is too small,  _output_size_ will
           contain the expected buffer size (with null terminator for text)
           and return **GNUTLS_E_SHORT_MEMORY_BUFFER**.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::ipmib.OutRequests

## NAME



           probe::ipmib.OutRequests - Count a request to send a packet
    


## SYNOPSIS



           ipmib.OutRequests
    


## VALUES



           _op_
               value to be added to the counter (default value of 1)
    
           _skb_
               pointer to the struct sk_buff being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **ipmib_filter_key**. If the packet passes the filter is is counted in
           the global _OutRequests_ (equivalent to SNMP's MIB
           IPSTATS_MIB_OUTREQUESTS)
    


* * *
# probe::socket.sendmsg

## NAME



           probe::socket.sendmsg - Message is currently being sent on a
           socket.
    


## SYNOPSIS



           socket.sendmsg
    


## VALUES



           _family_
               Protocol family value
    
           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _name_
               Name of this probe
    
           _protocol_
               Protocol value
    
           _size_
               Message size in bytes
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender
    


## DESCRIPTION



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


* * *
# io_uring_prep_link

## NAME



           io_uring_prep_linkat - prepare a linkat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_linkat(struct io_uring_sqe ***_sqe_**,**
                                     **int** _olddirfd_**,**
                                     **const char ***_oldpath_**,**
                                     **int** _newdirfd_**,**
                                     **const char ***_newpath_**,**
                                     **int** _flags_**);**
    
           **void io_uring_prep_link(struct io_uring_sqe ***_sqe_**,**
                                   **const char ***_oldpath_**,**
                                   **const char ***_newpath_**,**
                                   **int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_linkat(3) function prepares a linkat request.
           The submission queue entry _sqe_ is setup to use the old directory
           file descriptor pointed to by _olddirfd_ and old path pointed to by
           _oldpath_ with the new directory file descriptor pointed to by
           _newdirfd_ and the new path pointed to by _newpath_ and using the
           specified flags in _flags_.
    
           The io_uring_prep_link(3) function prepares a link request. The
           submission queue entry _sqe_ is setup to use the old path pointed to
           by _oldpath_ and the new path pointed to by _newpath_ , both relative
           to the current working directory and using the specified flags in
           _flags_.
    
           These functions prepare an async linkat(2) or link(2) request. See
           those man pages for details.
    


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


## NOTES



           As with any request that passes in data in a struct, that data
           must remain valid until the request has been successfully
           submitted. It need not remain valid until completion. Once a
           request has been submitted, the in-kernel state is stable. Very
           early kernels (5.4 and earlier) required state to be stable until
           the completion occurred. Applications can test for this behavior
           by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).
    


* * *
# gnutls_x509_privkey_export2_pkcs8

## NAME



           gnutls_x509_privkey_export2_pkcs8 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export2_pkcs8(gnutls_x509_privkey_t** _key_**,**
           **gnutls_x509_crt_fmt_t** _format_**, const char ***_password_**, unsigned int**
           _flags_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       Holds the key
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           const char * password
                       the password that will be used to encrypt the key.
    
           unsigned int flags
                       an ORed sequence of gnutls_pkcs_encrypt_flags_t
    
           gnutls_datum_t * out
                       will contain a private key PEM or DER encoded
    


## DESCRIPTION



           This function will export the private key to a PKCS8 structure.
           Both RSA and DSA keys can be exported. For DSA keys we use PKCS **11**
           definitions. If the flags do not specify the encryption cipher,
           then the default 3DES (PBES2) will be used.
    
           The  _password_ can be either ASCII or UTF-8 in the default PBES2
           encryption schemas, or ASCII for the PKCS12 schemas.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           ENCRYPTED PRIVATE KEY" or "BEGIN PRIVATE KEY" if encryption is not
           used.
    


## RETURNS



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


* * *
# dane_query_to_raw_tlsa

## NAME



           dane_query_to_raw_tlsa - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_query_to_raw_tlsa(dane_query_t** _q_**, unsigned int ***
           _data_entries_**, char *****_dane_data_**, int ****_dane_data_len_**, int ***
           _secure_**, int ***_bogus_**);**
    


## ARGUMENTS



           dane_query_t q
                       The query result structure
    
           unsigned int * data_entries
                       Pointer set to the number of entries in the query
    
           char *** dane_data
                       Pointer to contain an array of DNS rdata items,
                       terminated with a NULL pointer; caller must guarantee
                       that the referenced data remains valid until
                       **dane_query_deinit()** is called.
    
           int ** dane_data_len
                       Pointer to contain the length n bytes of the dane_data
                       items
    
           int * secure
                       Pointer set true if the result is validated securely,
                       false if validation failed or the domain queried has
                       no security info
    
           int * bogus Pointer set true if the result was not secure due to a
                       security failure
    


## DESCRIPTION



           This function will provide the DANE data from the query response.
    
           The pointers dane_data and dane_data_len are allocated with
           **gnutls_malloc()** to contain the data from the query result
           structure (individual
            _dane_data_ items simply point to the original data and are not
           allocated separately).  The returned  _dane_data_ are only valid
           during the lifetime of  _q_ .
    


## RETURNS



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


* * *
# gnutls_cipher_get

## NAME



           gnutls_cipher_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_cipher_algorithm_t gnutls_cipher_get(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the currently used cipher.
    


## RETURNS



           the currently used cipher, a **gnutls_cipher_algorithm_t** type.
    


* * *
# mlx4dv_query_device

## NAME



           mlx4dv_query_device - Query device capabilities specific to mlx4
    


## SYNOPSIS



           **#include <infiniband/mlx4dv.h>**
    
           **int mlx4dv_query_device(struct ibv_context *ctx_in,**
                                   **struct mlx4dv_context *attrs_out);**
    


## DESCRIPTION



           **mlx4dv_query_device()** Query mlx4 specific device information that
           is usable via the direct verbs interface.
    
           This function returns a version and compatibility mask. The
           version represents the format of the internal hardware structures
           that mlx4dv.h exposes.  Future additions of new fields to the
           existing structures are handled by the comp_mask field.
    
           struct mlx4dv_context {
                   uint8_t         version;
                   uint32_t        max_inl_recv_sz; /* Maximum supported size of inline receive  */
                   uint64_t        comp_mask;
           };
    


## RETURN VALUE



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


## NOTES



            * Compatibility mask (comp_mask) is an in/out field.
    


* * *
# gnutls_certificate_set_params_function

## NAME



           gnutls_certificate_set_params_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_certificate_set_params_function(gnutls_certificate_credentials_t**
           _res_**, gnutls_params_function ***_func_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           gnutls_params_function * func
                       is the function to be called
    


## DESCRIPTION



           This function will set a callback in order for the server to get
           the Diffie-Hellman or RSA parameters for certificate
           authentication.  The callback should return **GNUTLS_E_SUCCESS**(0)
           on success.
    


## DEPRECATED



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


* * *
# wcscpy

## NAME



           wcscpy - copy a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcscpy(wchar_t *restrict** _dest_**, const wchar_t *restrict** _src_**);**
    


## DESCRIPTION



           The **wcscpy**() function is the wide-character equivalent of the
           strcpy(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



           **wcscpy**() returns _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# ffs

## NAME



           ffs, ffsl, ffsll - find first bit set in a word
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <strings.h>**
    
           **int ffs(int** _i_**);**
           **int ffsl(long** _i_**);**
           **int ffsll(long long** _i_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **ffs**():
               Since glibc 2.12:
                   _XOPEN_SOURCE >= 700
                       || ! (_POSIX_C_SOURCE >= 200809L)
                       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                       || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
               Before glibc 2.12:
                   none
    
           **ffsl**(), **ffsll**():
               Since glibc 2.27:
                   _DEFAULT_SOURCE
               Before glibc 2.27:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **ffs**() function returns the position of the first (least
           significant) bit set in the word _i_.  The least significant bit is
           position 1 and the most significant position is, for example, 32
           or 64.  The functions **ffsll**() and **ffsl**() do the same but take
           arguments of possibly different size.
    


## RETURN VALUE



           These functions return the position of the first bit set, or 0 if
           no bits are set in _i_.
    


## ATTRIBUTES



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


## STANDARDS



           **ffs**()  POSIX.1-2001, POSIX.1-2008, 4.3BSD.
    
           **ffsl**()
           **ffsll**()
                  GNU.
    


* * *
# wcwidth

## NAME



           wcwidth - determine columns needed for a wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _XOPEN_SOURCE** /* See feature_test_macros(7) */
           **#include <wchar.h>**
    
           **int wcwidth(wchar_t** _wc_**);**
    


## DESCRIPTION



           The **wcwidth**() function returns the number of columns needed to
           represent the wide character _wc_.  If _wc_ is a printable wide
           character, the value is at least 0.  If _wc_ is null wide character
           (L'\0'), the value is 0.  Otherwise, -1 is returned.
    


## RETURN VALUE



           The **wcwidth**() function returns the number of column positions for
           _wc_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The behavior of **wcwidth**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# gnutls_x509_privkey_export_dsa_raw

## NAME



           gnutls_x509_privkey_export_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_export_dsa_raw(gnutls_x509_privkey_t** _key_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_g_**,**
           **gnutls_datum_t ***_y_**, gnutls_datum_t ***_x_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_datum_t * p
                       will hold the p
    
           gnutls_datum_t * q
                       will hold the q
    
           gnutls_datum_t * g
                       will hold the g
    
           gnutls_datum_t * y
                       will hold the y
    
           gnutls_datum_t * x
                       will hold the x
    


## DESCRIPTION



           This function will export the DSA private key's parameters found
           in the given structure. 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 value.
    


* * *