tripathysagar/man_text huggingface dataset:
# tapset::scheduler

## NAME



           tapset::scheduler - systemtap scheduler tapset
    


## DESCRIPTION



           **scheduler.cpu_off**
                  Process is about to stop running on a cpu
    
                   See probe::scheduler.cpu_off(3stap)
                   for details.
    
           **scheduler.cpu_on**
                  Process is beginning execution on a cpu
    
                   See probe::scheduler.cpu_on(3stap)
                   for details.
    
           **scheduler.tick**
                  Schedulers internal tick, a processes timeslice accounting
                  is updated
    
                   See probe::scheduler.tick(3stap)
                   for details.
    
           **scheduler.balance**
                  A cpu attempting to find more work.
    
                   See probe::scheduler.balance(3stap)
                   for details.
    
           **scheduler.ctxswitch**
                  A context switch is occuring.
    
                   See probe::scheduler.ctxswitch(3stap)
                   for details.
    
           **scheduler.kthread_stop**
                  A thread created by kthread_create is being stopped
    
                   See probe::scheduler.kthread_stop(3stap)
                   for details.
    
           **scheduler.kthread_stop.return**
                  A kthread is stopped and gets the return value
    
                   See probe::scheduler.kthread_stop.return(3stap)
                   for details.
    
           **scheduler.wait_task**
                  Waiting on a task to unschedule (become inactive)
    
                   See probe::scheduler.wait_task(3stap)
                   for details.
    
           **scheduler.wakeup**
                  Task is woken up
    
                   See probe::scheduler.wakeup(3stap)
                   for details.
    
           **scheduler.wakeup_new**
                  Newly created task is woken up for the first time
    
                   See probe::scheduler.wakeup_new(3stap)
                   for details.
    
           **scheduler.migrate**
                  Task migrating across cpus
    
                   See probe::scheduler.migrate(3stap)
                   for details.
    
           **scheduler.process_free**
                  Scheduler freeing a data structure for a process
    
                   See probe::scheduler.process_free(3stap)
                   for details.
    
           **scheduler.process_exit**
                  Process exiting
    
                   See probe::scheduler.process_exit(3stap)
                   for details.
    
           **scheduler.process_wait**
                  Scheduler starting to wait on a process
    
                   See probe::scheduler.process_wait(3stap)
                   for details.
    
           **scheduler.process_fork**
                  Process forked
    
                   See probe::scheduler.process_fork(3stap)
                   for details.
    
           **scheduler.signal_send**
                  Sending a signal
    
                   See probe::scheduler.signal_send(3stap)
                   for details.
    


* * *
# pmprintvalue

## NAME



           **pmPrintValue** - print a performance metric value
    


## C SYNOPSIS



           **#include <stdio.h>**
           **#include <pcp/pmapi.h>**
    
           **void pmPrintValue(FILE ***_f_**, int** _valfmt_**, int** _type_**,**
                             **const pmValue ***_val_**, int** _minwidth_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The value of a single performance metric (as identified by _val_) is
           printed on the standard I/O stream identified by _f_.
    
           The  value  of  the performance metric is interpreted according to
           the format of _val_ as defined by _valfmt_ (from a _pmValueSet_ within a
           _pmResult_ structure; see pmFetch(3)) and the generic description of
           the metrics type passed in via _type_.
    
           The value for _type_ is typically extracted from a _pmDesc_ structure,
           following a call to pmLookupDesc(3) for a  particular  performance
           metric.
    
           The output will be optionally padded to be at least _minwidth_ char‐
           acters wide.
    
           **pmPrintValue** is  most useful for displaying values of performance
           metrics from pmFetch(3) (which returns a set  of  _valfmt_  and  _val_
           pairs  for  each requested metric), based upon the metrics type as
           returned from pmLookupDesc(3).
    


## ENVIRONMENT



           Output of string metric values can  be  further  controlled  using
           **PCP_SQUASH_NEWLINES**.   When  set in the environment of the calling
           process, and the _type_ is set to PM_TYPE_STRING  or  PM_TYPE_AGGRE‐
           GATE,  then  the output value is guaranteed to be free of embedded
           newline characters.  If the given value contained such characters,
           they will have been replaced by a space before being printed.
    


* * *
# probe::netdev.unregister

## NAME



           probe::netdev.unregister - Called when the device is being
           unregistered
    


## SYNOPSIS



           netdev.unregister
    


## VALUES



           _dev_name_
               The device that is going to be unregistered
    


* * *
# io_uring_wait_cqes_min_timeout

## NAME



           io_uring_wait_cqes_min_timeout - wait for completions with both
           batch and normal timeout
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_wait_cqes_min_timeout(struct io_uring ***_ring_**,**
                                              **struct io_uring_cqe ****_cqe_ptr_**,**
                                              **unsigned** _wait_nr_**,**
                                              **struct __kernel_timespec ***_ts_**,**
                                              **unsigned int** _min_wait_usec_**,**
                                              **sigset_t ***_sigmask_**);**
    


## DESCRIPTION



           The io_uring_wait_cqes_min_timeout(3) waits for completions from
           the submission queue belonging to the _ring_ and waits for _wait_nr_
           completion events, or until the timeout _ts_ expires. The completion
           events are stored in the _cqe_ptr_ array. If non-zero, _min_wait_usec_
           denotes a timeout for the _wait_nr_ batch.
    
           The _sigmask_ specifies the set of signals to block. If set, it is
           equivalent to atomically executing the following calls:
    
               sigset_t origmask;
    
               pthread_sigmask(SIG_SETMASK, &sigmask, &origmask);
               ret = io_uring_wait_cqes_min_timeout(ring, cqe, wait_nr, ts, min_wait, NULL);
               pthread_sigmask(SIG_SETMASK, &origmask, NULL);
    
           This works like io_uring_submit_and_wait_min_timeout(3) except
           that it doesn't submit requests. See that man page for a
           description for how the min timeout waiting works.
    
           Available since 6.12.
    


## RETURN VALUE



           On success io_uring_wait_cqes_min_timeout(3) returns the 0.On
           failure it returns **-errno**.  If the kernel doesn't support this
           functionality, **-EINVAL** will be returned. See note on the feature
           flag.  The most common failure case is not receiving a completion
           within the specified timeout, **-ETIME** is returned in this case.
    


* * *
# sd_bus_pending_method_calls

## NAME



           sd_bus_pending_method_calls - Return the number of currently
           pending, outgoing method calls
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_pending_method_calls(sd_bus ***_bus_**);**
    


## DESCRIPTION



           **sd_bus_pending_method_calls()** returns the number of currently
           pending outgoing method calls, i.e. method calls enqueued with
           sd_bus_call_async(3) for which no reply has been received yet, and
           which have not reached a timeout yet.
    
           The _bus_ argument may be **NULL** , in which case zero is returned.
    


## RETURN VALUE



           This function returns 0 if there are no pending method calls, or a
           **NULL** bus object was specified. On failure, a negative errno-style
           error code is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ECHILD**
               The bus connection has been created in a different process,
               library or module instance.
    


## NOTES



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


* * *
# probe::ipmib.ReasmReqds

## NAME



           probe::ipmib.ReasmReqds - Count number of packet fragments
           reassembly requests
    


## SYNOPSIS



           ipmib.ReasmReqds
    


## VALUES



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


## DESCRIPTION



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


* * *
# gnutls_pk_list

## NAME



           gnutls_pk_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_pk_algorithm_t * gnutls_pk_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of supported public key algorithms.
    
           This function is not thread safe.
    


## RETURNS



           a (0)-terminated list of **gnutls_pk_algorithm_t** integers indicating
           the available ciphers.
    


## SINCE



           2.6.0
    


* * *
# io_uring_prep_futex_wait

## NAME



           io_uring_prep_futex_wait - prepare a futex wait request
    


## SYNOPSIS



           **#include <linux/futex.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_futex_wait(struct io_uring_sqe ***_sqe_**,**
                                         **uint32_t ***_futex_**,**
                                         **uint64_t** _val_**,**
                                         **uint64_t** _mask_**,**
                                         **uint32_t** _futex_flags_**,**
                                         **unsigned int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_futex_wait(3) function prepares a futex wait
           request. The submission queue entry _sqe_ is setup for waiting on a
           futex at address _futex_ and which still has the value _val_ and with
           **futex2**(2) flags of _futex_flags_ and io_uring futex flags of _flags ._
    
           _mask_ can be set to a specific bitset mask, which will be matched
           by the waking side to decide who to wake up. To always get woken,
           an application may use **FUTEX_BITSET_MATCH_ANY .**
    
           _futex_flags_ follows the **futex2**(2) flags, not the futex(2) v1
           interface flags.
    
           _flags_ are currently unused and hence **0** must be passed.
    
           This function prepares an async futex(2) wait request. See that
           man page for details. Note that the io_uring futex wait request is
           similar to the **FUTEX_WAIT_BITSET** operation, as **FUTEX_WAIT** is a
           strict subset of that.
    
           Available since kernel 6.7.
    


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



           Unlike the sync futex syscalls that wait on a futex, io_uring does
           not support passing in a timeout for the request. Instead,
           applications are encouraged to use a linked timeout to abort the
           futex request at a given time, if desired.
    


* * *
# probe::socket.read_iter.return

## NAME



           probe::socket.read_iter.return - Conclusion of message received
           via **sock_read_iter**
    


## SYNOPSIS



           socket.read_iter.return
    


## VALUES



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


## CONTEXT



           The message receiver.
    


## DESCRIPTION



           Fires at the conclusion of receiving a message on a socket via the
           **sock_read_iter** function
    


* * *
# acl_get_qualifier

## NAME



           **acl_get_qualifier** — retrieve the qualifier from an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _void *_ **acl_get_qualifier**(_acl_entry_t_
           _entry_d_)
    


## DESCRIPTION



           The **acl_get_qualifier**() function retrieves the qualifier from the
           ACL entry indicated by the argument _entry_d_ into working storage
           and returns a pointer to that storage.
    
           If the value of the tag type in the ACL entry referred to by
           _entry_d_ is ACL_USER, then the value returned by
           **acl_get_qualifier**() is a pointer to type _uid_t_.  If the value of
           the tag type in the ACL entry referred to by _entry_d_ is ACL_GROUP,
           then the value returned by **acl_get_qualifier**() is a pointer to
           type _gid_t_.  If the tag type in the ACL entry referred to by
           _entry_d_ is a tag type for which a qualifier is not supported,
           **acl_get_qualifier**() returns a value of **(void *)NULL** and the
           function fails. Subsequent operations using the returned pointer
           operate on an independent copy of the qualifier in working
           storage, and will not change the qualifier of the ACL entry.
    
           This function may cause memory to be allocated. The caller should
           free any releasable memory, when the new qualifier is no longer
           required, by calling **acl_free**() with the _void *_ value returned by
           **acl_get_qualifier**() as an argument.
    
           The argument _entry_d_ and any other ACL entry descriptors that
           refer to entries within the ACL containing the entry referred to
           by _entry_d_ continue to refer to those entries. The order of all
           existing entries in the ACL containing the entry referred to by
           _entry_d_ remains unchanged.
    


## RETURN VALUE



           On success, the function returns a pointer to the tag qualifier
           that was retrieved into ACL working storage. On error, a value of
           **(void *)NULL** is returned and _errno_ is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_get_qualifier**()
           function returns **(void *)NULL** and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The argument _entry_d_ is not a valid descriptor
                              for an ACL entry.
    
                              The value of the tag type in the ACL entry
                              referenced by the argument _entry_d_ is neither
                              ACL_USER nor ACL_GROUP.
    
           [ENOMEM]           The value to be returned 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)
    


* * *
# probe::staprun.insert_module

## NAME



           probe::staprun.insert_module - Inserting SystemTap instrumentation
           module
    


## SYNOPSIS



           staprun.insert_module
    


## VALUES



           _path_
               the full path to the .ko kernel module about to be inserted
    


## DESCRIPTION



           Fires just before the call to insert the module.
    


* * *
# ibv_fork_init

## NAME



           ibv_fork_init - initialize libibverbs to support fork()
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_fork_init(void);
    


## DESCRIPTION



           **ibv_fork_init()** initializes libibverbs’s data structures to handle
           **fork()** function calls correctly and avoid data corruption, whether
           **fork()** is called explicitly or implicitly (such as in **system()**).
    
           It is not necessary to use this function if all parent process
           threads are always blocked until all child processes end or change
           address spaces via an **exec()** operation.
    


## RETURN VALUE



           **ibv_fork_init()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).  An error value of
           EINVAL indicates that there had been RDMA memory registration
           already and it is therefore not safe anymore to fork.
    


## NOTES



           **ibv_fork_init()** works on Linux kernels supporting the
           **MADV_DONTFORK** flag for **madvise()**(2.6.17 and higher).
    
           Setting the environment variable **RDMAV_FORK_SAFE** or **IBV_FORK_SAFE**
           has the same effect as calling **ibv_fork_init()**.
    
           Setting the environment variable **RDMAV_HUGEPAGES_SAFE** tells the
           library to check the underlying page size used by the kernel for
           memory regions.  This is required if an application uses huge
           pages either directly or indirectly via a library such as
           libhugetlbfs.
    
           Calling **ibv_fork_init()** will reduce performance due to an extra
           system call for every memory registration, and the additional
           memory allocated to track memory regions.  The precise performance
           impact depends on the workload and usually will not be
           significant.
    
           Setting **RDMAV_HUGEPAGES_SAFE** adds further overhead to all memory
           registrations.
    


* * *
# gnutls_dtls_get_mtu

## NAME



           gnutls_dtls_get_mtu - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **unsigned int gnutls_dtls_get_mtu(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will return the MTU size as set with
           **gnutls_dtls_set_mtu()**. This is not the actual MTU of data you can
           transmit. Use **gnutls_dtls_get_data_mtu()** for that reason.
    


## RETURNS



           the set maximum transfer unit.
    


## SINCE



           3.0
    


* * *
# pmsearchinfo

## NAME



           **pmSearchInfo** - diagnostic metrics of PCP search services
    


## C SYNOPSIS



           **#include <pcp/pmwebapi.h>**
    
           **int pmSearchInfo(pmSearchSettings ***_settings_**, sds** _key_**, void ***_arg_**);**
    
           **cc ... -lpcp_web**
    


## DESCRIPTION



           Diagnostic metrics related to the Performance Co-Pilot (PCP) fast,
           scalable and full-text capable search services.
    
           Currently,  as  all  full-text  related  services are using single
           ValkeySearch index, diagnostic metrics are requestable by  passing
           in _key_ with a value of **`text'**.  The results will passed to **on_met‐**
           **rics** callback provided by **settings.**
    


## DIAGNOSTICS



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


* * *
# gnutls_certificate_get_ours

## NAME



           gnutls_certificate_get_ours - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_datum_t ***
           **gnutls_certificate_get_ours(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           Gets the certificate as sent to the peer in the last handshake.
           The certificate is in raw (DER) format.  No certificate list is
           being returned. Only the first certificate.
    
           This function returns the certificate that was sent in the current
           handshake. In subsequent resumed sessions this function will
           return **NULL**. That differs from **gnutls_certificate_get_peers()**
           which always returns the peer's certificate used in the original
           session.
    


## RETURNS



           a pointer to a **gnutls_datum_t** containing our certificate, or **NULL**
           in case of an error or if no certificate was used.
    


* * *
# gnutls_certificate_type_get

## NAME



           gnutls_certificate_type_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_certificate_type_t**
           **gnutls_certificate_type_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function returns the type of the certificate that is
           negotiated for this side to send to the peer. The certificate type
           is by default X.509, unless an alternative certificate type is
           enabled by **gnutls_init()** and negotiated during the session.
    
           Resumed sessions will return the certificate type that was
           negotiated and used in the original session.
    
           As of version 3.6.4 it is recommended to use
           **gnutls_certificate_type_get2()** which is more fine-grained.
    


## RETURNS



           the currently used **gnutls_certificate_type_t** certificate type as
           negotiated for 'our' side of the connection.
    


* * *
# imaxabs

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



           imaxabs — return absolute value
    


## SYNOPSIS



           #include <inttypes.h>
    
           intmax_t imaxabs(intmax_t _j_);
    


## 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 _imaxabs_() function shall compute the absolute value of an
           integer _j_.  If the result cannot be represented, the behavior is
           undefined.
    


## RETURN VALUE



           The _imaxabs_() function shall return the absolute value.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The absolute value of the most negative number cannot be
           represented in two's complement.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# putchar

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



           putchar — put a byte on a stdout stream
    


## SYNOPSIS



           #include <stdio.h>
    
           int putchar(int _c_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The function call _putchar_(_c_) shall be equivalent to
           _putc_(_c_ ,_stdout_).
    


## RETURN VALUE



           Refer to fputc(3p).
    


## ERRORS



           Refer to fputc(3p).
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tcpmib.OutRsts

## NAME



           probe::tcpmib.OutRsts - Count the sending of a reset packet
    


## SYNOPSIS



           tcpmib.OutRsts
    


## VALUES



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


## DESCRIPTION



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


* * *
# gnutls_x509_ext_ct_import_scts

## NAME



           gnutls_x509_ext_ct_import_scts - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_ct_import_scts(const gnutls_datum_t ***_ext_**,**
           **gnutls_x509_ct_scts_t** _scts_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       a DER-encoded extension
    
           gnutls_x509_ct_scts_t scts
                       The SCT list
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will read a SignedCertificateTimestampList structure
           from the DER data of the X.509 Certificate Transparency SCT
           extension (OID 1.3.6.1.4.1.11129.2.4.2).
    
           The list of SCTs (Signed Certificate Timestamps) is placed on
           _scts_ , which must be previously initialized with
           **gnutls_x509_ext_ct_scts_init()**.
    


## RETURNS



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


* * *
# iconv_open

## NAME



           iconv_open - allocate descriptor for character set conversion
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <iconv.h>**
    
           **iconv_t iconv_open(const char ***_tocode_**, const char ***_fromcode_**);**
    


## DESCRIPTION



           The **iconv_open**() function allocates a conversion descriptor
           suitable for converting byte sequences from character encoding
           _fromcode_ to character encoding _tocode_.
    
           The values permitted for _fromcode_ and _tocode_ and the supported
           combinations are system-dependent.  For the GNU C library, the
           permitted values are listed by the _iconv --list_ command, and all
           combinations of the listed values are supported.  Furthermore the
           GNU C library and the GNU libiconv library support the following
           two suffixes:
    
           //TRANSLIT
                  When the string "//TRANSLIT" is appended to _tocode_ ,
                  transliteration is activated.  This means that when a
                  character cannot be represented in the target character
                  set, it can be approximated through one or several
                  similarly looking characters.
    
           //IGNORE
                  When the string "//IGNORE" is appended to _tocode_ ,
                  characters that cannot be represented in the target
                  character set will be silently discarded.
    
           The resulting conversion descriptor can be used with iconv(3) any
           number of times.  It remains valid until deallocated using
           iconv_close(3).
    
           A conversion descriptor contains a conversion state.  After
           creation using **iconv_open**(), the state is in the initial state.
           Using iconv(3) modifies the descriptor's conversion state.  To
           bring the state back to the initial state, use iconv(3) with NULL
           as _inbuf_ argument.
    


## RETURN VALUE



           On success, **iconv_open**() returns a freshly allocated conversion
           descriptor.  On failure, it returns _(iconv_t) -1_ and sets _errno_ to
           indicate the error.
    


## ERRORS



           The following error can occur, among others:
    
           **EINVAL** The conversion from _fromcode_ to _tocode_ is not supported by
                  the implementation.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_dtls_cookie_send

## NAME



           gnutls_dtls_cookie_send - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **int gnutls_dtls_cookie_send(gnutls_datum_t ***_key_**, void ***
           _client_data_**, size_t** _client_data_size_**, gnutls_dtls_prestate_st ***
           _prestate_**, gnutls_transport_ptr_t** _ptr_**, gnutls_push_func** _push_func_**);**
    


## ARGUMENTS



           gnutls_datum_t * key
                       is a random key to be used at cookie generation
    
           void * client_data
                       contains data identifying the client (i.e. address)
    
           size_t client_data_size
                       The size of client's data
    
           gnutls_dtls_prestate_st * prestate
                       The previous cookie returned by
                       **gnutls_dtls_cookie_verify()**
    
           gnutls_transport_ptr_t ptr
                       A transport pointer to be used by  _push_func_
    
           gnutls_push_func push_func
                       A function that will be used to reply
    


## DESCRIPTION



           This function can be used to prevent denial of service attacks to
           a DTLS server by requiring the client to reply using a cookie sent
           by this function. That way it can be ensured that a client we
           allocated resources for (i.e. **gnutls_session_t**) is the one that
           the original incoming packet was originated from.
    
           This function must be called at the first incoming packet, prior
           to allocating any resources and must be succeeded by
           **gnutls_dtls_cookie_verify()**.
    


## RETURNS



           the number of bytes sent, or a negative error code.
    


## SINCE



           3.0
    


* * *
# mbstowcs

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



           mbstowcs — convert a character string to a wide-character string
    


## SYNOPSIS



           #include <stdlib.h>
    
           size_t mbstowcs(wchar_t *restrict _pwcs_ , const char *restrict _s_ ,
               size_t _n_);
    


## 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 _mbstowcs_() function shall convert a sequence of characters
           that begins in the initial shift state from the array pointed to
           by _s_ into a sequence of corresponding wide-character codes and
           shall store not more than _n_ wide-character codes into the array
           pointed to by _pwcs_.  No characters that follow a null byte (which
           is converted into a wide-character code with value 0) shall be
           examined or converted. Each character shall be converted as if by
           a call to _mbtowc_(), except that the shift state of _mbtowc_() is not
           affected.
    
           No more than _n_ elements shall be modified in the array pointed to
           by _pwcs_.  If copying takes place between objects that overlap, the
           behavior is undefined.
    
           The behavior of this function shall be affected by the _LC_CTYPE_
           category of the current locale.  If _pwcs_ is a null pointer,
           _mbstowcs_() shall return the length required to convert the entire
           array regardless of the value of _n_ , but no values are stored.
    


## RETURN VALUE



           If an invalid character is encountered, _mbstowcs_() shall return
           (**size_t**)-1 and shall set _errno_ to indicate the error.
    
           Otherwise, _mbstowcs_() shall return the number of the array
           elements modified (or required if _pwcs_ is null), not including a
           terminating 0 code, if any. The array shall not be zero-terminated
           if the value returned is _n_.
    


## ERRORS



           The _mbstowcs_() function shall fail if:
    
           **EILSEQ** An invalid character sequence is detected. In the POSIX
                  locale an **[EILSEQ]** error cannot occur since all byte values
                  are valid characters.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_copy_int

## NAME



           **acl_copy_int** — copy an ACL from external to internal
           representation
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _acl_t_ **acl_copy_int**(_const void *buf_p_)
    


## DESCRIPTION



           The **acl_copy_int**() function copies an exportable, contiguous,
           persistent form of an ACL, pointed to by _buf_p_ , to the internal
           representation.
    
           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 the _(void*)acl_t_ returned by
           **acl_copy_int**() as an argument.
    


## RETURN VALUE



           Upon success, the **acl_copy_int**() function returns a pointer that
           references the ACL in working storage.  On error, a value of
           **(acl_t)NULL** is returned, and _errno_ is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_copy_int**()
           function returns a value of **(acl_t)NULL** and sets _errno_ to the
           corresponding value:
    
           [EINVAL]           The buffer pointed to by the argument _buf_p_
                              does not contain a valid external form 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)
    


* * *
# tapset::ansi

## NAME



           tapset::ansi - systemtap ansi tapset
    


## DESCRIPTION



           **ansi_clear_screen**
                  Move cursor to top left and clear screen.
    
                  See function::ansi_clear_screen(3stap)
                   for details.
    
           **ansi_set_color**
                  Set the ansi Select Graphic Rendition mode.
    
                  See function::ansi_set_color(3stap)
                   for details.
    
           **ansi_set_color**
                  Set the ansi Select Graphic Rendition mode.
    
                  See function::ansi_set_color(3stap)
                   for details.
    
           **ansi_set_color**
                  Set the ansi Select Graphic Rendition mode.
    
                  See function::ansi_set_color(3stap)
                   for details.
    
           **ansi_reset_color**
                  Resets Select Graphic Rendition mode.
    
                  See function::ansi_reset_color(3stap)
                   for details.
    
           **ansi_new_line**
                  Move cursor to new line.
    
                  See function::ansi_new_line(3stap)
                   for details.
    
           **ansi_cursor_move**
                  Move cursor to new coordinates.
    
                  See function::ansi_cursor_move(3stap)
                   for details.
    
           **ansi_cursor_hide**
                  Hides the cursor.
    
                  See function::ansi_cursor_hide(3stap)
                   for details.
    
           **ansi_cursor_save**
                  Saves the cursor position.
    
                  See function::ansi_cursor_save(3stap)
                   for details.
    
           **ansi_cursor_restore**
                  Restores a previously saved cursor position.
    
                  See function::ansi_cursor_restore(3stap)
                   for details.
    
           **ansi_cursor_show**
                  Shows the cursor.
    
                  See function::ansi_cursor_show(3stap)
                   for details.
    


* * *
# auparse_get_filename

## NAME



           auparse_get_filename - get the filename where record was found
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_filename will return the name of the source file where
           the record was found if the source type is AUSOURCE_FILE or
           AUSOURCE_FILE_ARRAY. For other source types the return value will
           be NULL.
    


## RETURN VALUE



           Returns pointer to a filename or NULL if unavailable.
    


* * *
# ibv_resize_cq

## NAME



           ibv_resize_cq - resize a completion queue (CQ)
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_resize_cq(struct ibv_cq *cq, int cqe);
    


## DESCRIPTION



           **ibv_resize_cq()** resizes the completion queue (CQ) _cq_ to have at
           least _cqe_ entries.  _cqe_ must be at least the number of unpolled
           entries in the CQ _cq_.  If _cqe_ is a valid value less than the
           current CQ size, **ibv_resize_cq()** may not do anything, since this
           function is only guaranteed to resize the CQ to a size at least as
           big as the requested size.
    


## RETURN VALUE



           **ibv_resize_cq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_resize_cq()** may assign a CQ size greater than or equal to the
           requested size.  The cqe member of _cq_ will be updated to the
           actual size.
    


* * *
# gnutls_x509_crl_get_next_update

## NAME



           gnutls_x509_crl_get_next_update - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **time_t gnutls_x509_crl_get_next_update(gnutls_x509_crl_t** _crl_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    


## DESCRIPTION



           This function will return the time the next CRL will be issued.
           This field is optional in a CRL so it might be normal to get an
           error instead.
    


## RETURNS



           when the next CRL will be issued, or (time_t)-1 on error.
    


* * *
# gnutls_pubkey_import

## NAME



           gnutls_pubkey_import - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import(gnutls_pubkey_t** _key_**, const gnutls_datum_t**
           *****_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded certificate.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    


## DESCRIPTION



           This function will import the provided public key in a
           SubjectPublicKeyInfo X.509 structure to a native **gnutls_pubkey_t**
           type. The output will be stored in  _key_ . If the public key is PEM
           encoded it should have a header of "PUBLIC KEY".
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# posix_trace_set_filter

## 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_set_filter — set filter of an initialized trace stream
           (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_set_filter(trace_id_t _trid_ ,
               const trace_event_set_t *_set_ , int _how_);
    


## DESCRIPTION



           Refer to posix_trace_get_filter(3p).
    


* * *
# io_uring_prep_statx

## NAME



           io_uring_prep_statx - prepare a statx request
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <sys/stat.h>**
           **#include <unistd.h>**
           **#include <fcntl.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_statx(struct io_uring_sqe ***_sqe_**,**
                                    **int** _dirfd_**,**
                                    **const char ***_path_**,**
                                    **int** _flags_**,**
                                    **unsigned** _mask_**,**
                                    **struct statx ***_statxbuf_**);**
    


## DESCRIPTION



           The io_uring_prep_statx(3) function prepares a statx request. The
           submission queue entry _sqe_ is setup to use the directory file
           descriptor pointed to by _dirfd_ to start a statx operation on the
           path identified by _path_ and using the flags given in _flags_ for the
           fields specified by _mask_ and into the buffer located at _statxbuf_.
    
           This function prepares an async statx(2) request. See that man
           page 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_privkey_import_pkcs11

## NAME



           gnutls_privkey_import_pkcs11 - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_pkcs11_privkey_t key
                       The private key to be imported
    
           unsigned int flags
                       Flags for the import
    


## DESCRIPTION



           This function will import the given private key to the abstract
           **gnutls_privkey_t** type.
    
           The **gnutls_pkcs11_privkey_t** object must not be deallocated during
           the lifetime of this structure.
    
            _flags_ might be zero or one of **GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE**
           and **GNUTLS_PRIVKEY_IMPORT_COPY**.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::tcp.recvmsg

## NAME



           probe::tcp.recvmsg - Receiving TCP message
    


## SYNOPSIS



           tcp.recvmsg
    


## VALUES



           _daddr_
               A string representing the destination IP address
    
           _sock_
               Network socket
    
           _family_
               IP address family
    
           _size_
               Number of bytes to be received
    
           _saddr_
               A string representing the source IP address
    
           _name_
               Name of this probe
    
           _sport_
               TCP source port
    
           _dport_
               TCP destination port
    


## CONTEXT



           The process which receives a tcp message
    


* * *
# pcre2_match_context_copy

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_match_context *pcre2_match_context_copy(**
             **pcre2_match_context ***_mcontext_**);**
    


## DESCRIPTION



    
           This function makes a new copy of a match context, using the
           memory allocation function that was used for the original context.
           The result is NULL if the memory cannot be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *