tripathysagar/man_text huggingface dataset:
# wcsdup

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



           wcsdup — duplicate a wide-character string
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcsdup(const wchar_t *_string_);
    


## DESCRIPTION



           The _wcsdup_() function is the wide-character equivalent of the
           _strdup_() function.
    
           The _wcsdup_() function shall return a pointer to a new wide-
           character string, allocated as if by a call to _malloc_(), which is
           the duplicate of the wide-character string _string_.  The returned
           pointer can be passed to _free_().  A null pointer is returned if
           the new wide-character string cannot be created.
    


## RETURN VALUE



           Upon successful completion, the _wcsdup_() function shall return a
           pointer to the newly allocated wide-character string. Otherwise,
           it shall return a null pointer and set _errno_ to indicate the
           error.
    


## ERRORS



           The _wcsdup_() function shall fail if:
    
           **ENOMEM** Memory large enough for the duplicate string could not be
                  allocated.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           For functions that allocate memory as if by _malloc_(), the
           application should release such memory when it is no longer
           required by a call to _free_().  For _wcsdup_(), this is the return
           value.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_privkey_import

## NAME



           gnutls_x509_privkey_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import(gnutls_x509_privkey_t** _key_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed 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 convert the given DER or PEM encoded key to the
           native **gnutls_x509_privkey_t** format. The output will be stored in
            _key_ .
    
           If the key is PEM encoded it should have a header that contains
           "PRIVATE KEY". Note that this function falls back to PKCS **8**
           decoding without password, if the default format fails to import.
    


## RETURNS



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


* * *
# get_nprocs

## NAME



           get_nprocs, get_nprocs_conf - get number of processors
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/sysinfo.h>**
    
           **int get_nprocs(void);**
           **int get_nprocs_conf(void);**
    


## DESCRIPTION



           The function **get_nprocs_conf**() returns the number of processors
           configured by the operating system.
    
           The function **get_nprocs**() returns the number of processors
           currently available in the system.  This may be less than the
           number returned by **get_nprocs_conf**() because processors may be
           offline (e.g., on hotpluggable systems).
    


## RETURN VALUE



           As given in DESCRIPTION.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## NOTES



           The current implementation of these functions is rather expensive,
           since they open and parse files in the _/sys_ filesystem each time
           they are called.
    
           The following sysconf(3) calls make use of the functions
           documented on this page to return the same information.
    
               np = sysconf(_SC_NPROCESSORS_CONF);     /* processors configured */
               np = sysconf(_SC_NPROCESSORS_ONLN);     /* processors available */
    


## EXAMPLES



           The following example shows how **get_nprocs**() and **get_nprocs_conf**()
           can be used.
    
           #include <stdio.h>
           #include <stdlib.h>
           #include <sys/sysinfo.h>
    
           int
           main(void)
           {
               printf("This system has %d processors configured and "
                       "%d processors available.\n",
                       get_nprocs_conf(), get_nprocs());
               exit(EXIT_SUCCESS);
           }
    


* * *
# MB_CUR_MAX

## NAME



           MB_CUR_MAX - maximum length of a multibyte character in the
           current locale
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    


## DESCRIPTION



           The **MB_CUR_MAX** macro defines an integer expression giving the
           maximum number of bytes needed to represent a single wide
           character in the current locale.  This value is locale dependent
           and therefore not a compile-time constant.
    


## RETURN VALUE



           An integer in the range [1, **MB_LEN_MAX**].  The value 1 denotes
           traditional 8-bit encoded characters.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# umad_get_fd

## NAME



           umad_get_fd - get the umad fd for the requested port
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_get_fd(int** _portid_**);**
    


## DESCRIPTION



           **umad_get_fd()** returns the umad fd for the port specified by
           _portid_.
    


## RETURN VALUE



           **umad_get_fd()** returns the fd for the _portid_ requested or -EINVAL
           if _portid_ is invalid.
    


* * *
# form_field_just

## NAME



           **set_field_just** , **field_just** - retrieve field characteristics
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_field_just(FIELD ***_field_**, int** _justification_**);**
           **int field_just(const FIELD ***_field_**);**
    


## DESCRIPTION



           The function **set_field_just** sets the justification attribute of a
           field; **field_just** returns a field's justification attribute.  The
           attribute may be one of NO_JUSTIFICATION, JUSTIFY_RIGHT,
           JUSTIFY_LEFT, or JUSTIFY_CENTER.
    


## RETURN VALUE



           The function **field_just** returns one of: NO_JUSTIFICATION,
           JUSTIFY_RIGHT, JUSTIFY_LEFT, or JUSTIFY_CENTER.
    
           The function **set_field_just** returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    


## NOTES



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


## PORTABILITY



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


* * *
# if_nameindex

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



           if_nameindex — return all network interface names and indexes
    


## SYNOPSIS



           #include <net/if.h>
    
           struct if_nameindex *_if_nameindex_(void);
    


## DESCRIPTION



           The _if_nameindex_() function shall return an array of _if_nameindex_
           structures, one structure per interface. The end of the array is
           indicated by a structure with an _if_index_ field of zero and an
           _if_name_ field of NULL.
    
           Applications should call _if_freenameindex_() to release the memory
           that may be dynamically allocated by this function, after they
           have finished using it.
    


## RETURN VALUE



           An array of structures identifying local interfaces. A null
           pointer is returned upon an error, with _errno_ set to indicate the
           error.
    


## ERRORS



           The _if_nameindex_() function may fail if:
    
           **ENOBUFS**
                  Insufficient resources are available to complete the
                  function.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# __io_uring_buf_ring_cq_advance

## NAME



           io_uring_buf_ring_cq_advance - advance index of provided buffer
           and CQ ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_buf_ring_cq_advance(struct io_uring ***_ring_**,**
                                             **struct io_uring_buf_ring ***_br_**,**
                                             **int** _count_**);**
    
           **void __io_uring_buf_ring_cq_advance(struct io_uring ***_ring_**,**
                                               **struct io_uring_buf_ring ***_br_**,**
                                               **int** _cq_count_**,**
                                               **int** _buf_count_**);**
    


## DESCRIPTION



           The io_uring_buf_ring_cq_advance(3) commits _count_ previously added
           buffers to the shared buffer ring _br_ , making them visible to the
           kernel and hence consumable. This passes ownership of the buffer
           to the ring. At the same time, it advances the CQ ring of _ring_ by
           _count_ amount. This effectively bundles both a
           io_uring_buf_ring_advance(3) call and a io_uring_cq_advance(3)
           into one operation. Since updating either ring index entails a
           store memory barrier, doing both at once is more efficient.
    
           The __io_uring_buf_ring_cq_advance(3) function performs the same
           operation, except it splits the counts into two separate values.
           It advances the CQ ring by _cq_count_ entries, and the buffer ring
           by _buf_count_ entries rather than increment both by the same value.
    


## RETURN VALUE



           None
    


* * *
# gnutls_x509_ext_import_tlsfeatures

## NAME



           gnutls_x509_ext_import_tlsfeatures - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_tlsfeatures(const gnutls_datum_t ***_ext_**,**
           **gnutls_x509_tlsfeatures_t** _f_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       The DER-encoded extension data
    
           gnutls_x509_tlsfeatures_t f
                       The features structure
    
           unsigned int flags
                       zero or **GNUTLS_EXT_FLAG_APPEND**
    


## DESCRIPTION



           This function will export the features in the provided DER-encoded
           TLS Features PKIX extension, to a **gnutls_x509_tlsfeatures_t** type.
           _f_ must be initialized.
    
           When the  _flags_ is set to **GNUTLS_EXT_FLAG_APPEND** , then if the
           _features_ structure is empty this function will behave identically
           as if the flag was not set. Otherwise if there are elements in the
           _features_ structure then they will be merged with.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# libpfm_intel_snb_unc

## NAME



           libpfm_intel_snb_unc - support for Intel Sandy Bridge uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snb_unc_cbo0, snb_unc_cbo1, snb_unc_cbo2, snb_unc_cbo3**
           **PMU desc: Intel Sandy Bridge C-box uncore**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge client part (model 42)
           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 Sandy 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.
    


* * *
# function::json_add_array_numeric_metric

## NAME



           function::json_add_array_numeric_metric - Add a numeric metric to
           an array
    


## SYNOPSIS



               json_add_array_numeric_metric:long(array_name:string,metric_name:string,metric_description:string,metric_units:string)
    


## ARGUMENTS



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


## DESCRIPTION



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


* * *
# sd_event_set_signal_exit

## NAME



           sd_event_set_signal_exit - Automatically leave event loop on
           **SIGINT** and **SIGTERM**
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **int sd_event_set_signal_exit(sd_event ***_event_**, int b);**
    


## DESCRIPTION



           **sd_event_set_signal_exit()** may be used to ensure the event loop
           terminates once a **SIGINT** or **SIGTERM** signal is received. It is a
           convenience wrapper around invocations of sd_event_add_signal(3)
           for both signals. The two signals are automatically added to the
           calling thread's signal mask (if a program is multi-threaded care
           should be taken to either invoke this function before the first
           thread is started or to manually block the two signals
           process-wide first).
    
           If the parameter _b_ is specified as true, the event loop will
           terminate on **SIGINT** and **SIGTERM**. If specified as false, it will no
           longer. When this functionality is turned off the calling thread's
           signal mask is restored to match the state before it was turned
           on, for the two signals. By default, the two signals are not
           handled by the event loop, and Linux' default signal handling for
           them is in effect.
    
           It is customary for UNIX programs to exit on either of these two
           signals, hence it is typically a good idea to enable this
           functionality for the main event loop of a program.
    


## RETURN VALUE



           **sd_event_set_signal_exit()** returns a positive non-zero value when
           the setting was successfully changed. It returns a zero when the
           specified setting was already in effect. On failure, it returns a
           negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ECHILD**
               The event loop has been created in a different process,
               library or module instance.
    
               Added in version 252.
    
           **-EINVAL**
               The passed event loop object was invalid.
    
               Added in version 252.
    


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


* * *
# sd_event_source_set_userdata

## NAME



           sd_event_source_set_userdata, sd_event_source_get_userdata - Set
           or retrieve user data pointer of event sources
    


## SYNOPSIS



           **#include <systemd/sd-event.h>**
    
           **void* sd_event_source_set_userdata(sd_event_source ***_source_**,**
                                              **void ***_userdata_**);**
    
           **void* sd_event_source_get_userdata(sd_event_source ***_source_**);**
    


## DESCRIPTION



           **sd_event_source_set_userdata()** may be used to set an arbitrary
           user data pointer for the event source object specified as _source_.
           The user data pointer is usually specified when creating an event
           source object with calls such as sd_event_add_io(3) or
           sd_event_add_time(3), and may be updated with this call. The user
           data pointer is also passed to all handler callback functions
           associated with the event source. The _userdata_ parameter specifies
           the new user data pointer to set, the function returns the
           previous user data pointer. Note that **NULL** is a valid user data
           pointer.
    
           **sd_event_source_get_userdata()** may be used to query the current
           user data pointer assigned to the event source object _source_.
    


## RETURN VALUE



           On success, **sd_event_source_set_userdata()** and
           **sd_event_source_get_userdata()** return the previously set user data
           pointer. On failure, they return **NULL**.
    


## NOTES



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


* * *
# tep_get_event

## NAME



           tep_get_event, tep_get_first_event, tep_get_events_count - Access
           events.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           struct tep_event * **tep_get_event**(struct tep_handle *_tep_ , int _index_);
           struct tep_event * **tep_get_first_event**(struct tep_handle *_tep_);
           int **tep_get_events_count**(struct tep_handle *_tep_);
    


## DESCRIPTION



           The **tep_get_event()** function returns a pointer to event at the
           given _index_. The _tep_ argument is trace event parser context, the
           _index_ is the index of the requested event.
    
           The **tep_get_first_event()** function returns a pointer to the first
           event. As events are stored in an array, this function returns the
           pointer to the beginning of the array. The _tep_ argument is trace
           event parser context.
    
           The **tep_get_events_count()** function returns the number of the
           events in the array. The _tep_ argument is trace event parser
           context.
    


## RETURN VALUE



           The **tep_get_event()** returns a pointer to the event located at
           _index_. NULL is returned in case of error, in case there are no
           events or _index_ is out of range.
    
           The **tep_get_first_event()** returns a pointer to the first event.
           NULL is returned in case of error, or in case there are no events.
    
           The **tep_get_events_count()** returns the number of the events. 0 is
           returned in case of error, or in case there are no events.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               int i,count = tep_get_events_count(tep);
               struct tep_event *event, *events = tep_get_first_event(tep);
    
               if (events == NULL) {
                       /* There are no events */
               } else {
                       for (i = 0; i < count; i++) {
                               event = (events+i);
                               /* process events[i] */
                       }
    
                       /* Get the last event */
                       event = tep_get_event(tep, count-1);
               }
    


## FILES



               **event-parse.h**
                       Header file to include in order to have access to the library APIs.
               **-ltraceevent**
                       Linker switch to add when building a program that uses the library.
    


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



           **https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/ **
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    
            2. tz.stoyanov@gmail.com
               mailto:tz.stoyanov@gmail.com
    
            3. linux-trace-devel@vger.kernel.org
               mailto:linux-trace-devel@vger.kernel.org
    


* * *
# rdma_destroy_srq

## NAME



           rdma_destroy_srq - Deallocate a SRQ.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **void rdma_destroy_srq (struct rdma_cm_id ***_id_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Destroy an SRQ allocated on the rdma_cm_id.
    


## RETURN VALUE



           None
    


## NOTES



           Users should destroy any SRQ associated with an rdma_cm_id before
           destroying the ID.
    


* * *
# pthread_kill

## 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_kill — send a signal to a thread
    


## SYNOPSIS



           #include <signal.h>
    
           int pthread_kill(pthread_t _thread_ , int _sig_);
    


## DESCRIPTION



           The _pthread_kill_() function shall request that a signal be
           delivered to the specified thread.
    
           As in _kill_(), if _sig_ is zero, error checking shall be performed
           but no signal shall actually be sent.
    


## RETURN VALUE



           Upon successful completion, the function shall return a value of
           zero.  Otherwise, the function shall return an error number. If
           the _pthread_kill_() function fails, no signal shall be sent.
    


## ERRORS



           The _pthread_kill_() function shall fail if:
    
           **EINVAL** The value of the _sig_ argument is an invalid or unsupported
                  signal number.
    
           The _pthread_kill_() function shall not return an error code of
           **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _pthread_kill_() function provides a mechanism for
           asynchronously directing a signal at a thread in the calling
           process. This could be used, for example, by one thread to affect
           broadcast delivery of a signal to a set of threads.
    
           Note that _pthread_kill_() only causes the signal to be handled in
           the context of the given thread; the signal action (termination or
           stopping) affects the process as a whole.
    


## RATIONALE



           If an implementation detects use of a thread ID after the end of
           its lifetime, it is recommended that the function should fail and
           report an **[ESRCH]** error.
    
           Existing implementations vary on the result of a _pthread_kill_()
           with a thread ID indicating an inactive thread (a terminated
           thread that has not been detached or joined). Some indicate
           success on such a call, while others give an error of **[ESRCH]**.
           Since the definition of thread lifetime in this volume of
           POSIX.1‐2017 covers inactive threads, the **[ESRCH]** error as
           described is inappropriate in this case. In particular, this means
           that an application cannot have one thread check for termination
           of another with _pthread_kill_().
    


## FUTURE DIRECTIONS



           A future version of this standard may require that _pthread_kill_()
           not fail with **[ESRCH]** in the case of sending signals to an
           inactive thread (a terminated thread not yet detached or joined),
           even though no signal will be delivered because the thread is no
           longer running.
    


* * *
# probe::ipmib.ReasmTimeout

## NAME



           probe::ipmib.ReasmTimeout - Count Reassembly Timeouts
    


## SYNOPSIS



           ipmib.ReasmTimeout
    


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


* * *
# stpcpy

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



           stpcpy — copy a string and return a pointer to the end of the
           result
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to strcpy(3p).
    


* * *
# io_uring_peek_cqe

## NAME



           io_uring_peek_cqe - check if an io_uring completion event is
           available
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_peek_cqe(struct io_uring ***_ring_**,**
                                 **struct io_uring_cqe ****_cqe_ptr_**);**
    
           **unsigned io_uring_peek_batch_cqe(struct io_uring ***_ring_**,**
                                            **struct io_uring_cqe ****_cqe_ptrs_**,**
                                            **unsigned** _count_**);**
    


## DESCRIPTION



           The io_uring_peek_cqe(3) function returns an IO completion from
           the queue belonging to the _ring_ param, if one is readily
           available. On successful return, _cqe_ptr_ param is filled with a
           valid CQE entry.
    
           This function does not enter the kernel to wait for an event, an
           event is only returned if it's already available in the CQ ring.
    
           The io_uring_peek_batch_cqe(3) function returns up to _count_
           request completions in _cqe_ptrs_ belonging to the _ring_ param, if
           they are readily available. It will not enter the kernel, unless
           the CQ ring is in an overflow condition. Upon successful return,
           _cqe_ptrs_ are filled with the number of events indicated by the
           return value.
    


## RETURN VALUE



           On success io_uring_peek_cqe(3) returns **0** and the cqe_ptr
           parameter is filled in. On success io_uring_peek_batch_cqe(3)
           returns the number of completions filled in. On failure,
           io_uring_peek_cqe(3) may return **-EAGAIN**.
    


* * *
# pthread_attr_setguardsize

## 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_setguardsize — set the thread guardsize attribute
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to pthread_attr_getguardsize(3p).
    


* * *
# function::cmdline_arg

## NAME



           function::cmdline_arg - Fetch a command line argument
    


## SYNOPSIS



               cmdline_arg:string(n:long)
    


## ARGUMENTS



           _n_
               Argument to get (zero is the program itself)
    


## DESCRIPTION



           Returns argument the requested argument from the current process
           or the empty string when there are not that many arguments or
           there is a problem retrieving the argument. Argument zero is
           traditionally the command itself.
    


* * *
# tolower

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



           tolower, tolower_l — transliterate uppercase characters to
           lowercase
    


## SYNOPSIS



           #include <ctype.h>
    
           int tolower(int _c_);
           int tolower_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _tolower_(): 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 _tolower_() and _tolower_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 _tolower_() or _tolower_l_()
           represents an uppercase letter, and there exists a corresponding
           lowercase 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 lowercase letter. All other arguments in the domain
           are returned unchanged.
    
           The behavior is undefined if the _locale_ argument to _tolower_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           Upon successful completion, the _tolower_() and _tolower_l_()
           functions shall return the lowercase 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.
    


* * *
# pcap_set_rfmon

## NAME



           pcap_set_rfmon - set monitor mode for a not-yet-activated capture
           handle
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_set_rfmon(pcap_t *p, int rfmon);**
    


## DESCRIPTION



           **pcap_set_rfmon**() sets whether monitor mode should be set on a
           capture handle when the handle is activated.  If _rfmon_ is non-
           zero, monitor mode will be set, otherwise it will not be set.
    


## RETURN VALUE



           **pcap_set_rfmon**() returns **0** on success or **PCAP_ERROR_ACTIVATED** if
           called on a capture handle that has been activated.
    


* * *
# gnutls_certificate_get_trust_list

## NAME



           gnutls_certificate_get_trust_list - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void**
           **gnutls_certificate_get_trust_list(gnutls_certificate_credentials_t**
           _res_**, gnutls_x509_trust_list_t ***_tlist_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_x509_trust_list_t * tlist
                       Location where to store the trust list.
    


## DESCRIPTION



           Obtains the list of trusted certificates stored in  _res_ and writes
           a pointer to it to the location  _tlist_ . The pointer will point to
           memory internal to  _res_ , and must not be deinitialized. It will
           be automatically deallocated when the  _res_ structure is
           deinitialized.
    


## SINCE



           3.4.0
    


* * *
# function::usymname

## NAME



           function::usymname - Return the symbol of an address in the
           current task.
    


## SYNOPSIS



               usymname:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the (function) symbol name associated with the given
           address if known. If not known it will return the hex string
           representation of addr.
    


* * *
# sd_bus_set_connected_signal

## NAME



           sd_bus_set_connected_signal, sd_bus_get_connected_signal - Control
           emission of local connection establishment signal on bus
           connections
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_set_connected_signal(sd_bus ***_bus_**, int** _b_**);**
    
           **int sd_bus_get_connected_signal(sd_bus ***_bus_**);**
    


## DESCRIPTION



           **sd_bus_set_connected_signal()** may be used to control whether a
           local, synthetic **Connected()** signal message shall be generated and
           enqueued for dispatching when the connection is fully established.
           If the _b_ parameter is zero the message is not generated (the
           default), otherwise it is generated.
    
           **sd_bus_get_connected_signal()** may be used to query whether this
           feature is enabled. It returns zero if not, positive otherwise.
    
           The **Connected()** signal message is generated from the
           "org.freedesktop.DBus.Local" service and interface, and
           "/org/freedesktop/DBus/Local" object path. Use
           sd_bus_match_signal_async(3) to match on this signal.
    
           This message is particularly useful on slow transports where
           connections take a long time to be established. This is especially
           the case when sd_bus_set_watch_bind(3) is used. The signal is
           generated when the sd_bus_is_ready(3) returns positive for the
           first time.
    
           The **Connected()** signal corresponds with the **Disconnected()** signal
           that is synthesized locally when the connection is terminated. The
           latter is generated unconditionally however, unlike the former
           which needs to be enabled explicitly before it is generated, with
           **sd_bus_set_connected_signal()**.
    


## RETURN VALUE



           On success, these functions return 0 or a positive integer. On
           failure, they return a negative errno-style error code.
    
       **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.
    


* * *
# function::fp_eq

## NAME



           function::fp_eq - fp comparison function equal
    


## SYNOPSIS



               fp_eq:long(infp1:long,infp2:long)
    


## ARGUMENTS



           _infp1_
               the 64 bit floating point input
    
           _infp2_
               second 64 bit floating point input
    


## DESCRIPTION



           check if infp1 is equal to infp2
    


* * *
# timeval

## NAME



           timeval - time in seconds and microseconds
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/time.h>**
    
           **struct timeval {**
               **time_t       tv_sec;** /* Seconds */
               **suseconds_t  tv_usec;** /* Microseconds */
           **};**
    


## DESCRIPTION



           Describes times in seconds and microseconds.
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< sys/resource.h>_,
           _< sys/select.h>_, and _< utmpx.h>_.
    


* * *
# timezone

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



           timezone — difference from UTC and local standard time
    


## SYNOPSIS



           #include <time.h>
    
           extern long timezone;
    


## DESCRIPTION



           Refer to tzset(3p).
    


* * *
# probe::scheduler.cpu_off

## NAME



           probe::scheduler.cpu_off - Process is about to stop running on a
           cpu
    


## SYNOPSIS



           scheduler.cpu_off
    


## VALUES



           _task_next_
               the process replacing current
    
           _name_
               name of the probe point
    
           _task_prev_
               the process leaving the cpu (same as current)
    
           _idle_
               boolean indicating whether current is the idle process
    


## CONTEXT



           The process leaving the cpu.
    


* * *
# rdma_event_str

## NAME



           rdma_event_str - Returns a string representation of an rdma cm
           event.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **char * rdma_event_str (**_enum_**rdma_cm_event_type** _event_ **);"**
    


## ARGUMENTS



           event       Asynchronous event.
    


## DESCRIPTION



           Returns a string representation of an asynchronous event.
    


## RETURN VALUE



           Returns a pointer to a static character string corresponding to
           the event.
    


* * *
# probe::stap.cache_add_src

## NAME



           probe::stap.cache_add_src - Adding C code translation to cache
    


## SYNOPSIS



           stap.cache_add_src
    


## VALUES



           _dest_path_
               the path the .c file is going to (incl filename)
    
           _source_path_
               the path the .c file is coming from (incl filename)
    


## DESCRIPTION



           Fires just before the file is actually moved. Note: if moving the
           kernel module fails, this probe will not fire.
    


* * *
# gnutls_x509_privkey_import_rsa_raw

## NAME



           gnutls_x509_privkey_import_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_rsa_raw(gnutls_x509_privkey_t** _key_**,**
           **const gnutls_datum_t ***_m_**, const gnutls_datum_t ***_e_**, const**
           **gnutls_datum_t ***_d_**, const gnutls_datum_t ***_p_**, const gnutls_datum_t**
           *****_q_**, const gnutls_datum_t ***_u_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_datum_t * m
                       holds the modulus
    
           const gnutls_datum_t * e
                       holds the public exponent
    
           const gnutls_datum_t * d
                       holds the private exponent
    
           const gnutls_datum_t * p
                       holds the first prime (p)
    
           const gnutls_datum_t * q
                       holds the second prime (q)
    
           const gnutls_datum_t * u
                       holds the coefficient
    


## DESCRIPTION



           This function will convert the given RSA raw parameters to the
           native **gnutls_x509_privkey_t** format.  The output will be stored in
            _key_ .
    


## RETURNS



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


* * *
# function::ansi_cursor_hide

## NAME



           function::ansi_cursor_hide - Hides the cursor.
    


## SYNOPSIS



               ansi_cursor_hide()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code for hiding the cursor.
    


* * *
# curs_move

## NAME



           **move** , **wmove** - move **curses** window cursor
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int move(int** _y_**, int** _x_**);**
           **int wmove(WINDOW ***_win_**, int** _y_**, int** _x_**);**
    


## DESCRIPTION



           These  routines move the cursor associated with the window to line
           _y_ and column _x_.  This routine does not move the physical cursor of
           the terminal until **refresh**(3X) is called.  The position  specified
           is  relative to the upper left-hand corner of the window, which is
           (0,0).
    


## RETURN VALUE



           These routines return **ERR** upon failure and **OK**(SVr4 specifies only
           "an integer value other than **ERR** ") upon successful completion.
    
           Specifically, they return an error if the window pointer is  null,
           or if the position is outside the window.
    


## NOTES



           Note that **move** may be a macro.
    


## PORTABILITY



           These functions are described in the XSI Curses standard, Issue 4.
    


* * *
# io_uring_submit_and_wait_timeout

## NAME



           io_uring_submit_and_wait_timeout - submit requests to the
           submission queue and wait for the completion with timeout
    


## SYNOPSIS



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


## DESCRIPTION



           The io_uring_submit_and_wait_timeout(3) function submits the next
           requests 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.
    
           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_submit_and_wait_timeout(ring, cqe, wait_nr, ts, NULL);
               pthread_sigmask(SIG_SETMASK, &origmask, NULL);
    
           After the caller retrieves a submission queue entry (SQE) with
           io_uring_get_sqe(3) and prepares the SQE, it can be submitted with
           io_uring_submit_and_wait_timeout(3).
    
           Ideally used with a ring setup with
           **IORING_SETUP_SINGLE_ISSUER** |**IORING_SETUP_DEFER_TASKRUN** as that will
           greatly reduce the number of context switches that an application
           will see waiting on multiple requests.
    


## RETURN VALUE



           On success io_uring_submit_and_wait_timeout(3) returns the number
           of submitted submission queue entries. On failure it returns
           **-errno**.  Note that in earlier versions of the liburing library,
           the return value was 0 on success.  The most common failure case
           is not receiving a completion within the specified timeout, **-ETIME**
           is returned in this case.
    


* * *