tripathysagar/man_text huggingface dataset:
# function::print_ubacktrace

## NAME



           function::print_ubacktrace - Print stack back trace for current
           user-space task.
    


## SYNOPSIS



           1) print_ubacktrace()
    
           2) print_ubacktrace(pc:long,sp:long,fp:long)
    


## ARGUMENTS



           _pc_
               override PC
    
           _sp_
               override SP
    
           _fp_
               override FP
    


## DESCRIPTION



           1)
    
           2) Equivalent to print_ustack(**ubacktrace**), except that deeper
           stack nesting may be supported. Returns nothing. See
           **print_backtrace** for kernel backtrace.
    
           Equivalent to **print_ubacktrace** , but it performs the backtrace
           using the pc, sp, and fp provided. Useful
    


## NOTE



           To get (full) backtraces for user space applications and shared
           shared libraries not mentioned in the current script run stap with
           -d /path/to/exe-or-so and/or add --ldd to load all needed unwind
           data.
    


* * *
# io_uring_prep_symlink

## NAME



           io_uring_prep_symlinkat - prepare a symlinkat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <unistd.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_symlinkat(struct io_uring_sqe ***_sqe_**,**
                                        **const char ***_target_**,**
                                        **int** _newdirfd_**,**
                                        **const char ***_linkpath_**);**
    
           **void io_uring_prep_symlink(struct io_uring_sqe ***_sqe_**,**
                                      **const char ***_target_**,**
                                      **const char ***_linkpath_**);**
    


## DESCRIPTION



           The io_uring_prep_symlinkat(3) function prepares a symlinkat
           request. The submission queue entry _sqe_ is setup to symlink the
           target path pointed to by _target_ to the new destination indicated
           by _newdirfd_ and _linkpath_.
    
           The io_uring_prep_symlink(3) function prepares a symlink request.
           The submission queue entry _sqe_ is setup to symlink the target path
           pointed to by _target_ to the new destination indicated by _linkpath_
           relative to the current working directory. This function prepares
           an async symlink(2) request. See that man page for details.
    
           These functions prepare an async symlinkat(2) or symlink(2)
           request. See those man pages for details.
    


## RETURN VALUE



           None
    


## ERRORS



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


## NOTES



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


* * *
# posix_spawnattr_setsigmask

## 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_spawnattr_setsigmask — set the spawn-sigmask attribute of a
           spawn attributes object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <signal.h>
           #include <spawn.h>
    
           int posix_spawnattr_setsigmask(posix_spawnattr_t *restrict _attr_ ,
               const sigset_t *restrict _sigmask_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getsigmask(3p).
    


* * *
# function::ipmib_tcp_local_port

## NAME



           function::ipmib_tcp_local_port - Get the local tcp port
    


## SYNOPSIS



               ipmib_tcp_local_port:long(skb:long,SourceIsLocal:long)
    


## ARGUMENTS



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


## DESCRIPTION



           Returns the local tcp port from _skb_.
    


* * *
# function::ansi_cursor_restore

## NAME



           function::ansi_cursor_restore - Restores a previously saved cursor
           position.
    


## SYNOPSIS



               ansi_cursor_restore()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code for restoring the current cursor position
           previously saved with **ansi_cursor_save**.
    


* * *
# probe::signal.send

## NAME



           probe::signal.send - Signal being sent to a process
    


## SYNOPSIS



           signal.send
    


## VALUES



           _task_
               A task handle to the signal recipient
    
           _shared_
               Indicates whether the signal is shared by the thread group
    
           _pid_name_
               The name of the signal recipient
    
           _sinfo_
               The address of siginfo struct
    
           _sig_pid_
               The PID of the process receiving the signal
    
           _name_
               The name of the function used to send out the signal
    
           _sig_
               The number of the signal
    
           _send2queue_
               Indicates whether the signal is sent to an existing sigqueue
               (deprecated in SystemTap 2.1)
    
           _sig_name_
               A string representation of the signal
    
           _si_code_
               Indicates the signal type
    


## CONTEXT



           The signal's sender.
    


* * *
# raise

## NAME



           raise - send a signal to the caller
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **int raise(int** _sig_**);**
    


## DESCRIPTION



           The **raise**() function sends a signal to the calling process or
           thread.  In a single-threaded program it is equivalent to
    
               kill(getpid(), sig);
    
           In a multithreaded program it is equivalent to
    
               pthread_kill(pthread_self(), sig);
    
           If the signal causes a handler to be called, **raise**() will return
           only after the signal handler has returned.
    


## RETURN VALUE



           **raise**() returns 0 on success, and nonzero for failure.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::tcpmib_filter_key

## NAME



           function::tcpmib_filter_key - Default filter function for tcpmib.*
           probes
    


## SYNOPSIS



               tcpmib_filter_key:long(sk:long,op:long)
    


## ARGUMENTS



           _sk_
               pointer to the struct sock being acted on
    
           _op_
               value to be counted if _sk_ passes the filter
    


## DESCRIPTION



           This function is a default filter function. The user can replace
           this function with their own. The user-supplied filter function
           returns an index key based on the values in _sk_. A return value of
           0 means this particular _sk_ should be not be counted.
    


* * *
# function::task_state

## NAME



           function::task_state - The state of the task
    


## SYNOPSIS



               task_state:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           Return the state of the given task, one of: TASK_RUNNING (0),
           TASK_INTERRUPTIBLE (1), TASK_UNINTERRUPTIBLE (2), TASK_STOPPED
           (4), TASK_TRACED (8), EXIT_ZOMBIE (16), or EXIT_DEAD (32).
    


* * *
# gnutls_handshake_get_last_in

## NAME



           gnutls_handshake_get_last_in - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_handshake_description_t**
           **gnutls_handshake_get_last_in(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function is only useful to check where the last performed
           handshake failed.  If the previous handshake succeed or was not
           performed at all then no meaningful value will be returned.
    
           Check **gnutls_handshake_description_t** in gnutls.h for the available
           handshake descriptions.
    


## RETURNS



           the last handshake message type received, a
           **gnutls_handshake_description_t**.
    


* * *
# gnutls_x509_crq_set_dn_by_oid

## NAME



           gnutls_x509_crq_set_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_dn_by_oid(gnutls_x509_crq_t** _crq_**, const**
           **char ***_oid_**, unsigned int** _raw_flag_**, const void ***_data_**, unsigned int**
           _sizeof_data_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * oid
                       holds an Object Identifier in a (0)-terminated string
    
           unsigned int raw_flag
                       must be 0, or 1 if the data are DER encoded
    
           const void * data
                       a pointer to the input data
    
           unsigned int sizeof_data
                       holds the size of  _data_
    


## DESCRIPTION



           This function will set the part of the name of the Certificate
           request subject, specified by the given OID.  The input string
           should be ASCII or UTF-8 encoded.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           With this function you can only set the known OIDs.  You can test
           for known OIDs using **gnutls_x509_dn_oid_known()**.  For OIDs that
           are not known (by gnutls) you should properly DER encode your
           data, and call this function with raw_flag set.
    


## RETURNS



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


* * *
# pututxline

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



           pututxline — put an entry into the user accounting database
    


## SYNOPSIS



           #include <utmpx.h>
    
           struct utmpx *pututxline(const struct utmpx *_utmpx_);
    


## DESCRIPTION



           Refer to endutxent(3p).
    


* * *
# gnutls_certificate_type_get2

## NAME



           gnutls_certificate_type_get2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_certificate_type_t**
           **gnutls_certificate_type_get2(gnutls_session_t** _session_**,**
           **gnutls_ctype_target_t** _target_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_ctype_target_t target
                       is a **gnutls_ctype_target_t** type.
    


## DESCRIPTION



           This function returns the type of the certificate that a side is
           negotiated to use.  The certificate type is by default X.509,
           unless an alternative certificate type is enabled by **gnutls_init()**
           and negotiated during the session.
    
           The  _target_ parameter specifies whether to request the negotiated
           certificate type for the client (**GNUTLS_CTYPE_CLIENT**), or for the
           server (**GNUTLS_CTYPE_SERVER**). Additionally, in P2P mode connection
           set up where you don't know in advance who will be client and who
           will be server you can use the flag (**GNUTLS_CTYPE_OURS**) and
           (**GNUTLS_CTYPE_PEERS**) to retrieve the corresponding certificate
           types.
    
           Resumed sessions will return the certificate type that was
           negotiated and used in the original session. That is, this
           function can be used to reliably determine the type of the
           certificate returned by **gnutls_certificate_get_peers()**.
    


## RETURNS



           the currently used **gnutls_certificate_type_t** certificate type for
           the client or the server.
    


## SINCE



           3.6.4
    


* * *
# function::ns_egid

## NAME



           function::ns_egid - Returns the effective gid of a target process
           as seen in a user namespace
    


## SYNOPSIS



               ns_egid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the effective gid of a target process as
           seen in the target user namespace if provided, or the stap process
           namespace
    


* * *
# gnutls_gost_paramset_get_name

## NAME



           gnutls_gost_paramset_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_gost_paramset_get_name(gnutls_gost_paramset_t**
           _param_**);**
    


## ARGUMENTS



           gnutls_gost_paramset_t param
                       is a GOST 28147 param set
    


## DESCRIPTION



           Convert a **gnutls_gost_paramset_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified GOST param set,
           or **NULL**.
    


## SINCE



           3.6.3
    


* * *
# function::user_string_quoted_utf32

## NAME



           function::user_string_quoted_utf32 - Quote given user UTF-32
           string.
    


## SYNOPSIS



               user_string_quoted_utf32:string(addr:long)
    


## ARGUMENTS



           _addr_
               The user address to retrieve the string from
    


## DESCRIPTION



           This function combines quoting as per _string_quoted_ and UTF-32
           decoding as per _user_string_utf32_.
    


* * *
# gnutls_encode_rs_value

## NAME



           gnutls_encode_rs_value - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_encode_rs_value(gnutls_datum_t ***_sig_value_**, const**
           **gnutls_datum_t ***_r_**, const gnutls_datum_t ***_s_**);**
    


## ARGUMENTS



           gnutls_datum_t * sig_value
                       will hold a Dss-Sig-Value DER encoded structure
    
           const gnutls_datum_t * r
                       must contain the r value
    
           const gnutls_datum_t * s
                       must contain the s value
    


## DESCRIPTION



           This function will encode the provided r and s values, into a
           Dss-Sig-Value structure, used for DSA and ECDSA signatures.
    
           The output value should be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# function::sa_flags_str

## NAME



           function::sa_flags_str - Returns the string representation of
           sa_flags
    


## SYNOPSIS



               sa_flags_str:string(sa_flags:long)
    


## ARGUMENTS



           _sa_flags_
               the set of flags to convert to string.
    


* * *
# gnutls_transport_set_errno_function

## NAME



           gnutls_transport_set_errno_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_errno_function(gnutls_session_t** _session_**,**
           **gnutls_errno_func** _errno_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_errno_func errno_func
                       a callback function similar to **write()**
    


## DESCRIPTION



           This is the function where you set a function to retrieve errno
           after a failed push or pull operation.
    
            _errno_func_ is of the form, int
           (*gnutls_errno_func)(gnutls_transport_ptr_t); and should return
           the errno.
    


## SINCE



           2.12.0
    


* * *
# function::user_int64

## NAME



           function::user_int64 - Retrieves a 64-bit integer value stored in
           user space
    


## SYNOPSIS



               user_int64:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the 64-bit integer from
    


## DESCRIPTION



           Returns the 64-bit integer value from a given user space address.
           Returns zero when user space data is not accessible.
    


* * *
# gnutls_hmac_get_len

## NAME



           gnutls_hmac_get_len - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **unsigned gnutls_hmac_get_len(gnutls_mac_algorithm_t** _algorithm_**);**
    


## ARGUMENTS



           gnutls_mac_algorithm_t algorithm
                       the hmac algorithm to use
    


## DESCRIPTION



           This function will return the length of the output data of the
           given hmac algorithm.
    


## RETURNS



           The length or zero on error.
    


## SINCE



           2.10.0
    


* * *
# pthread_condattr_setclock

## 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_condattr_setclock — set the clock selection condition
           variable attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_condattr_setclock(pthread_condattr_t *_attr_ ,
               clockid_t _clock_id_);
    


## DESCRIPTION



           Refer to pthread_condattr_getclock(3p).
    


* * *
# va_list

## NAME



           va_list - variable argument list
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stdarg.h>**
    
           **typedef** /* ... */  **va_list;**
    


## DESCRIPTION



           Used by functions with a varying number of arguments of varying
           types.  The function must declare an object of type _va_list_ which
           is used by the macros va_start(3), va_arg(3), va_copy(3), and
           va_end(3) to traverse the list of arguments.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following headers also provide _va_list_ : _< stdio.h>_ and
           _< wchar.h>_.
    


* * *
# pcre2_code_copy

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_code *pcre2_code_copy(const pcre2_code ***_code_**);**
    


## DESCRIPTION



    
           This function makes a copy of the memory used for a compiled
           pattern, excluding any memory used by the JIT compiler. Without a
           subsequent call to **pcre2_jit_compile()** , the copy can be used only
           for non-JIT matching. The pointer to the character tables is
           copied, not the tables themselves (see
           **pcre2_code_copy_with_tables()**). The yield of the function is NULL
           if _code_ is NULL or if sufficient 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.
    


* * *
# sem_unlink

## NAME



           sem_unlink - remove a named semaphore
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <semaphore.h>**
    
           **int sem_unlink(const char ***_name_**);**
    


## DESCRIPTION



           **sem_unlink**() removes the named semaphore referred to by _name_.  The
           semaphore name is removed immediately.  The semaphore is destroyed
           once all other processes that have the semaphore open close it.
    


## RETURN VALUE



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


## ERRORS



           **EACCES** The caller does not have permission to unlink this
                  semaphore.
    
           **ENAMETOOLONG**
                  _name_ was too long.
    
           **ENOENT** There is no semaphore with the given _name_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# function::u32_arg

## NAME



           function::u32_arg - Return function argument as unsigned 32-bit
           value
    


## SYNOPSIS



               u32_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the unsigned 32-bit value of argument n, same as uint_arg.
    


* * *
# libpfm_intel_icx_unc_imc

## NAME



           libpfm_intel_icx_unc_imc - support for Intel Icelake X Server
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_imc[0-11]**
           **PMU desc: Intel Icelake X Server IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Icelake X Server Integrated Memory
           Controller (IMC) uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Icelake X server
           IMC uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IMC 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].  **i** Invert the threshold (t) test from
                  strictly greater than to less or equal to. This is a
                  boolean modifier.
    


* * *
# audit_log_user_message

## NAME



           audit_log_user_message - log a general user message
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_log_user_message(int** _audit_fd_**, int** _type_**, const char ***_message_**, const char ***_hostname_**, const char ***_addr_**, const char ***_tty_**, int** _result_**)"**
    


## DESCRIPTION



           This function will log a message to the audit system using a
           predefined message format. This function should be used by all ELF
           console apps that do not manipulate accounts or groups. If the
           application is written in Python or another interpreter, then use
           the _audit_log_user_comm_message_ function instead. The function
           parameters are as follows:
    
           _audit_fd_ - The fd returned by audit_open
           _type_ - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
           _message_ - the message text being sent
           _hostname_ - the hostname if known, NULL if unknown
           _addr_ - The network address of the user, NULL if unknown
           _tty_ - The tty of the user, if NULL will attempt to figure out
           _result_ - 1 is "success" and 0 is "failed"
    


## RETURN VALUE



           It returns the sequence number which is > 0 on success or <= 0 on
           error.
    


## ERRORS



           This function returns -1 on failure. Examine errno for more info.
    


* * *
# probe::stap.pass3

## NAME



           probe::stap.pass3 - Starting stap pass3 (translation to C)
    


## SYNOPSIS



           stap.pass3
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass3 fires just after the call to **gettimeofday** , just before the
           call to translate_pass.
    


* * *
# gnutls_early_cipher_get

## NAME



           gnutls_early_cipher_get - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the cipher algorithm used for encrypting early data.
    


## RETURNS



           the cipher used for early data, a **gnutls_cipher_algorithm_t** type.
    


## SINCE



           3.7.2
    


* * *
# vwscanf

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



           vwscanf — wide-character formatted input of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
           #include <wchar.h>
    
           int vwscanf(const wchar_t *restrict _format_ , va_list _arg_);
    


## DESCRIPTION



           Refer to vfwscanf(3p).
    


* * *
# io_uring_cq_has_overflow

## NAME



           io_uring_cq_has_overflow - returns if there are overflow entries
           waiting to move to the CQ ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **bool io_uring_cq_has_overflow(const struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The io_uring_cq_has_overflow(3) function informs the application
           if CQ entries have overflowed and are waiting to be flushed to the
           CQ ring. For example using io_uring_get_events(3)
    


## NOTES



           Using this function is only valid if the ring has
           **IORING_FEAT_NODROP** set, as it's checking for a flag set by kernels
           supporting that feature. For really old kernels that don't support
           this feature, if CQE overflow is experienced the CQEs are lost. If
           that happens, the CQ ring overflow offset will get incremented.
    


## RETURN VALUE



           True if there are CQ entries waiting to be flushed to the CQ ring.
    


* * *
# nice

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



           nice — change the nice value of a process
    


## SYNOPSIS



           #include <unistd.h>
    
           int nice(int _incr_);
    


## DESCRIPTION



           The _nice_() function shall add the value of _incr_ to the nice value
           of the calling process. A nice value of a process is a non-
           negative number for which a more positive value shall result in
           less favorable scheduling.
    
           A maximum nice value of 2*{NZERO}-1 and a minimum nice value of 0
           shall be imposed by the system. Requests for values above or below
           these limits shall result in the nice value being set to the
           corresponding limit. Only a process with appropriate privileges
           can lower the nice value.
    
           Calling the _nice_() function has no effect on the priority of
           processes or threads with policy SCHED_FIFO or SCHED_RR.  The
           effect on processes or threads with other scheduling policies is
           implementation-defined.
    
           The nice value set with _nice_() shall be applied to the process. If
           the process is multi-threaded, the nice value shall affect all
           system scope threads in the process.
    
           As -1 is a permissible return value in a successful situation, an
           application wishing to check for error situations should set _errno_
           to 0, then call _nice_(), and if it returns -1, check to see whether
           _errno_ is non-zero.
    


## RETURN VALUE



           Upon successful completion, _nice_() shall return the new nice value
           -{NZERO}.  Otherwise, -1 shall be returned, the nice value of the
           process shall not be changed, and _errno_ shall be set to indicate
           the error.
    


## ERRORS



           The _nice_() function shall fail if:
    
           **EPERM** The _incr_ argument is negative and the calling process does
                  not have appropriate privileges.
    
           _The following sections are informative._
    


## EXAMPLES



       **Changing the Nice Value**
           The following example adds the value of the _incr_ argument, -20, to
           the nice value of the calling process.
    
               #include <unistd.h>
               ...
               int incr = -20;
               int ret;
    
               ret = nice(incr);
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs12_export

## NAME



           gnutls_pkcs12_export - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_export(gnutls_pkcs12_t** _pkcs12_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a structure PEM or DER encoded
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will export the pkcs12 structure to DER or PEM
           format.
    
           If the buffer provided is not long enough to hold the output, then
           *output_data_size will be updated and GNUTLS_E_SHORT_MEMORY_BUFFER
           will be returned.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           PKCS12".
    


## RETURNS



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


* * *
# closedir

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



           closedir — close a directory stream
    


## SYNOPSIS



           #include <dirent.h>
    
           int closedir(DIR *_dirp_);
    


## DESCRIPTION



           The _closedir_() function shall close the directory stream referred
           to by the argument _dirp_.  Upon return, the value of _dirp_ may no
           longer point to an accessible object of the type **DIR**.  If a file
           descriptor is used to implement type **DIR** , that file descriptor
           shall be closed.
    


## RETURN VALUE



           Upon successful completion, _closedir_() shall return 0; otherwise,
           -1 shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _closedir_() function may fail if:
    
           **EBADF** The _dirp_ argument does not refer to an open directory
                  stream.
    
           **EINTR** The _closedir_() function was interrupted by a signal.
    
           _The following sections are informative._
    


## EXAMPLES



       **Closing a Directory Stream**
           The following program fragment demonstrates how the _closedir_()
           function is used.
    
               ...
                   DIR *dir;
                   struct dirent *dp;
               ...
                   if ((dir = opendir (".")) == NULL) {
               ...
                   }
    
                   while ((dp = readdir (dir)) != NULL) {
               ...
                   }
    
                   closedir(dir);
               ...
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::tid

## NAME



           function::tid - Returns the thread ID of a target process
    


## SYNOPSIS



               tid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the thread ID of the target process.
    


* * *
# gnutls_supplemental_get_name

## NAME



           gnutls_supplemental_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char ***
           **gnutls_supplemental_get_name(gnutls_supplemental_data_format_type_t**
           _type_**);**
    


## ARGUMENTS



           gnutls_supplemental_data_format_type_t type
                       is a supplemental data format type
    


## DESCRIPTION



           Convert a **gnutls_supplemental_data_format_type_t** value to a
           string.
    


## RETURNS



           a string that contains the name of the specified supplemental data
           format type, or **NULL** for unknown types.
    


* * *
# gnutls_early_prf_hash_get

## NAME



           gnutls_early_prf_hash_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_digest_algorithm_t gnutls_early_prf_hash_get(const**
           **gnutls_session_t** _session_**);**
    


## ARGUMENTS



           const gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the hash algorithm used as a PRF to derive keys for encrypting
           early data in TLS 1.3.
    


## RETURNS



           the hash algorithm used for early data, a
           **gnutls_digest_algorithm_t** value.
    


## SINCE



           3.7.2
    


* * *
# pcap_dump_file

## NAME



           pcap_dump_file - get the standard I/O stream for a savefile being
           written
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **FILE *pcap_dump_file(pcap_dumper_t *p);**
    


## DESCRIPTION



           **pcap_dump_file**() returns the standard I/O stream of the
           ``savefile'' opened by **pcap_dump_open**(3PCAP).
    


* * *
# wmemset

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



           wmemset — set wide characters in memory
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wmemset(wchar_t *_ws_ , wchar_t _wc_ , 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 _wmemset_() function shall copy the value of _wc_ into each of the
           first _n_ wide characters of the object pointed to by _ws_.  This
           function shall not be affected by locale and all **wchar_t** values
           shall be treated identically. The null wide character and **wchar_t**
           values not corresponding to valid characters shall not be treated
           specially.
    
           If _n_ is zero, the application shall ensure that _ws_ is a valid
           pointer, and the function shall copy zero wide characters.
    


## RETURN VALUE



           The _wmemset_() functions shall return the value of _ws_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_get_spki

## NAME



           gnutls_x509_crq_get_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_spki(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_x509_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will return the public key information of a PKCS**10**
           certificate request. The provided  _spki_ must be initialized.
    


## RETURNS



           Zero on success, or a negative error code on error.
    


* * *
# unlockpt

## NAME



           unlockpt - unlock a pseudoterminal master/slave pair
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _XOPEN_SOURCE**
           **#include <stdlib.h>**
    
           **int unlockpt(int** _fd_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **unlockpt**():
               Since glibc 2.24:
                   _XOPEN_SOURCE >= 500
               glibc 2.23 and earlier:
                   _XOPEN_SOURCE
    


## DESCRIPTION



           The **unlockpt**() function unlocks the slave pseudoterminal device
           corresponding to the master pseudoterminal referred to by the file
           descriptor _fd_.
    
           **unlockpt**() should be called before opening the slave side of a
           pseudoterminal.
    


## RETURN VALUE



           When successful, **unlockpt**() returns 0.  Otherwise, it returns -1
           and sets _errno_ to indicate the error.
    


## ERRORS



           **EBADF** The _fd_ argument is not a file descriptor open for writing.
    
           **EINVAL** The _fd_ argument is not associated with a master
                  pseudoterminal.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# mlx5dv_devx_create_eq

## NAME



           mlx5dv_devx_create_eq - Create an EQ object
    
           mlx5dv_devx_destroy_eq - Destroy an EQ object
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_eq *
                  mlx5dv_devx_create_eq(struct ibv_context *ibctx, const void *in, size_t inlen,
                                void *out, size_t outlen);
    
                  int mlx5dv_devx_destroy_eq(struct mlx5dv_devx_eq *eq);
    


## DESCRIPTION



           Create / Destroy an EQ object.  Upon creation, the caller prepares
           the in/out mail boxes based on the device specification format;
           For the input mailbox, caller needs to prepare all fields except
           “eqc.log_page_size” and the pas list, which will be set by the
           driver.  The “eqc.intr” field should be used from the output of
           mlx5dv_devx_alloc_msi_vector().
    


## ARGUMENTS



           _ibctx_  RDMA device context to create the action on.
    
           _in_     A buffer which contains the command’s input data provided
                  in a device specification format.
    
           _inlen_  The size of _in_ buffer in bytes.
    
           _out_    A buffer which contains the command’s output data according
                  to the device specification format.
    
           _outlen_ The size of _out_ buffer in bytes.
    
           _eq_     The EQ object to work on.
    
                  struct mlx5dv_devx_eq {
                      void *vaddr;
                  };
    
           _vaddr_  EQ VA that was allocated in the driver for.
    


## NOTES



           mlx5dv_devx_query_eqn() will not support vectors which are used by
           mlx5dv_devx_create_eq().
    


## RETURN VALUE



           Upon success _mlx5dv_devx_create_eq_ will return a new _struct_
           _mlx5dv_devx_eq_ ; On error NULL will be returned and errno will be
           set.
    
           Upon success _mlx5dv_devx_destroy_eq_ will return 0, on error errno
           will be returned.
    
           If the error value is EREMOTEIO, outbox.status and outbox.syndrome
           will contain the command failure details.
    


* * *
# labs

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



           labs, llabs — return a long integer absolute value
    


## SYNOPSIS



           #include <stdlib.h>
    
           long labs(long _i_);
           long long llabs(long long _i_);
    


## 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 _labs_() function shall compute the absolute value of the **long**
           integer operand _i_.  The _llabs_() function shall compute the
           absolute value of the **long long** integer operand _i_.  If the result
           cannot be represented, the behavior is undefined.
    


## RETURN VALUE



           The _labs_() function shall return the absolute value of the **long**
           integer operand.
    
           The _llabs_() function shall return the absolute value of the **long**
           **long** integer operand.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_get_tlsfeatures

## NAME



           gnutls_x509_crq_get_tlsfeatures - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_tlsfeatures(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_tlsfeatures_t** _features_**, unsigned int** _flags_**, unsigned**
           **int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       An X.509 certificate request
    
           gnutls_x509_tlsfeatures_t features
                       If the function succeeds, the features will be stored
                       in this variable.
    
           unsigned int flags
                       zero or **GNUTLS_EXT_FLAG_APPEND**
    
           unsigned int * critical
                       the extension status
    


## DESCRIPTION



           This function will get the X.509 TLS features extension structure
           from the certificate request.  The returned structure needs to be
           freed using **gnutls_x509_tlsfeatures_deinit()**.
    
           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.
    
           Note that  _features_ must be initialized prior to calling this
           function.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# gnutls_privkey_import_dsa_raw

## NAME



           gnutls_privkey_import_dsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_dsa_raw(gnutls_privkey_t** _key_**, const**
           **gnutls_datum_t ***_p_**, const gnutls_datum_t ***_q_**, const gnutls_datum_t**
           *****_g_**, const gnutls_datum_t ***_y_**, const gnutls_datum_t ***_x_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       The structure to store the parsed key
    
           const gnutls_datum_t * p
                       holds the p
    
           const gnutls_datum_t * q
                       holds the q
    
           const gnutls_datum_t * g
                       holds the g
    
           const gnutls_datum_t * y
                       holds the y (optional)
    
           const gnutls_datum_t * x
                       holds the x
    


## DESCRIPTION



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


## RETURNS



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


* * *