tripathysagar/man_text huggingface dataset:
# tep_read_number_field

## NAME



           tep_read_number_field - Reads a number from raw data.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           int **tep_read_number_field**(struct tep_format_field *_field_ , const void *_data_ , unsigned long long *_value_);
    


## DESCRIPTION



           The **tep_read_number_field()** function reads the value of the _field_
           from the raw _data_ and stores it in the _value_. The function sets
           the _value_ according to the endianness of the raw data and the
           current machine and stores it in _value_.
    


## RETURN VALUE



           The **tep_read_number_field()** function retunrs 0 in case of success,
           or -1 in case of an error.
    


## EXAMPLE



               #include <event-parse.h>
               ...
               struct tep_handle *tep = tep_alloc();
               ...
               struct tep_event *event = tep_find_event_by_name(tep, "timer", "hrtimer_start");
               ...
               void process_record(struct tep_record *record)
               {
                       unsigned long long pid;
                       struct tep_format_field *field_pid = tep_find_common_field(event, "common_pid");
    
                       if (tep_read_number_field(field_pid, record->data, &pid) != 0) {
                               /* Failed to get "common_pid" value */
                       }
               }
               ...
    


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


* * *
# gnutls_certificate_set_x509_key_mem2

## NAME



           gnutls_certificate_set_x509_key_mem2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_key_mem2(gnutls_certificate_credentials_t**
           _res_**, const gnutls_datum_t ***_cert_**, const gnutls_datum_t ***_key_**,**
           **gnutls_x509_crt_fmt_t** _type_**, const char ***_pass_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           const gnutls_datum_t * cert
                       contains a certificate list (path) for the specified
                       private key
    
           const gnutls_datum_t * key
                       is the private key, or **NULL**
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER
    
           const char * pass
                       is the key's password
    
           unsigned int flags
                       an ORed sequence of gnutls_pkcs_encrypt_flags_t
    


## DESCRIPTION



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


## RETURNS



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


* * *
# gnutls_x509_privkey_get_seed

## NAME



           gnutls_x509_privkey_get_seed - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_get_seed(gnutls_x509_privkey_t** _key_**,**
           **gnutls_digest_algorithm_t ***_digest_**, void ***_seed_**, size_t ***
           _seed_size_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    
           gnutls_digest_algorithm_t * digest
                       if non-NULL it will contain the digest algorithm used
                       for key generation (if applicable)
    
           void * seed where seed will be copied to
    
           size_t * seed_size
                       originally holds the size of  _seed_ , will be updated
                       with actual size
    


## DESCRIPTION



           This function will return the seed that was used to generate the
           given private key. That function will succeed only if the key was
           generated as a provable key.
    


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# sd_pidfd_get_inode_id

## NAME



           sd_pidfd_get_inode_id - Acquire the 64-bit inode ID of a PID file
           descriptor (PIDFD)
    


## SYNOPSIS



           **#include <systemd/sd-daemon.h>**
    
           **int sd_pidfd_get_inode_id(int** _pidfd_**, uint64_t ***_ret_**);**
    


## DESCRIPTION



           **sd_pidfd_get_inode_id()** may be invoked to acquire the 64-bit inode
           ID of a PID file descriptor (PIDFD), which can be used to reliably
           identify a process for the current boot.
    
           As a typical example, the service manager sets _$MAINPIDFDID_ and
           _$MANAGERPIDFDID_ environment variables to the inode IDs of the
           service main process and the service manager itself, respectively,
           if such functionality is supported by the kernel.
    
           On 64-bit architectures, the inode ID can be directly obtained via
           a call to fstat(2) on a given pidfd. However, on 32-bit
           architectures struct stat's .st_ino field is also 32-bit, which
           similar to PIDs is subject to reuse. Therefore, a second mechanism
           leveraging name_to_handle_at(2) has been added to kernel in v6.14.
           This helper is added to simplify downstream handling of
           pidfd/pidfs internals.
    


## RETURN VALUE



           On success, the function returns 0 or a positive integer. On
           failure, a negative errno-style error code is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EOPNOTSUPP**
               The stable PIDFD inode ID is not supported by the running
               kernel, or the system is 32-bit and **name_to_handle_at()** is
               unavailable.
    
           **-EBADF**
               The specified file descriptor is invalid, or is not a PIDFD.
    


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


* * *
# remove

## NAME



           remove - remove a file or directory
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **int remove(const char ***_path_**);**
    


## DESCRIPTION



           **remove**() deletes a name from the filesystem.  It calls unlink(2)
           for files, and rmdir(2) for directories.
    
           If the removed name was the last link to a file and no processes
           have the file open, the file is deleted and the space it was using
           is made available for reuse.
    
           If the name was the last link to a file, but any processes still
           have the file open, the file will remain in existence until the
           last file descriptor referring to it is closed.
    
           If the name referred to a symbolic link, the link is removed.
    
           If the name referred to a socket, FIFO, or device, the name is
           removed, but processes which have the object open may continue to
           use it.
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned, and _errno_
           is set to indicate the error.
    


## ERRORS



           The errors that occur are those for unlink(2) and rmdir(2).
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## BUGS



           Infelicities in the protocol underlying NFS can cause the
           unexpected disappearance of files which are still being used.
    


* * *
# gnutls_x509_crt_get_subject_alt_othername_oid

## NAME



           gnutls_x509_crt_get_subject_alt_othername_oid - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int seq
                       specifies the sequence number of the alt name (0 for
                       the first one, 1 for the second etc.)
    
           void * oid  is the place where the otherName OID will be copied to
    
           size_t * oid_size
                       holds the size of ret.
    


## DESCRIPTION



           This function will extract the type OID of an otherName Subject
           Alternative Name, contained in the given certificate, and return
           the type as an enumerated element.
    
           This function is only useful if
           **gnutls_x509_crt_get_subject_alt_name()** returned
           **GNUTLS_SAN_OTHERNAME**.
    
           If  _oid_ is null then only the size will be filled. The  _oid_
           returned will be null terminated, although  _oid_size_ will not
           account for the trailing null.
    


## RETURNS



           the alternative subject name type on success, one of the
           enumerated gnutls_x509_subject_alt_name_t.  For supported OIDs, it
           will return one of the virtual (GNUTLS_SAN_OTHERNAME_*) types,
           e.g. **GNUTLS_SAN_OTHERNAME_XMPP** , and **GNUTLS_SAN_OTHERNAME** for
           unknown OIDs.  It will return **GNUTLS_E_SHORT_MEMORY_BUFFER** if
            _ian_size_ is not large enough to hold the value.  In that case
            _ian_size_ will be updated with the required size.  If the
           certificate does not have an Alternative name with the specified
           sequence number and with the otherName type then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


* * *
# gnutls_priority_protocol_list

## NAME



           gnutls_priority_protocol_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_protocol_list(gnutls_priority_t** _pcache_**, const**
           **unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available TLS version numbers in the priority
           structure.
    


## RETURNS



           the number of protocols, or an error code.
    


## SINCE



           3.0
    


* * *
# posix_trace_start

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           posix_trace_start, posix_trace_stop — trace start and stop
           (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_start(trace_id_t _trid_);
           int posix_trace_stop (trace_id_t _trid_);
    


## DESCRIPTION



           The _posix_trace_start_() and _posix_trace_stop_() functions,
           respectively, shall start and stop the trace stream identified by
           the argument _trid_.
    
           The effect of calling the _posix_trace_start_() function shall be
           recorded in the trace stream as the POSIX_TRACE_START system trace
           event and the status of the trace stream shall become
           POSIX_TRACE_RUNNING.  If the trace stream is in progress when this
           function is called, the POSIX_TRACE_START system trace event shall
           not be recorded and the trace stream shall continue to run. If the
           trace stream is full, the POSIX_TRACE_START system trace event
           shall not be recorded and the status of the trace stream shall not
           be changed.
    
           The effect of calling the _posix_trace_stop_() function shall be
           recorded in the trace stream as the POSIX_TRACE_STOP system trace
           event and the status of the trace stream shall become
           POSIX_TRACE_SUSPENDED.  If the trace stream is suspended when this
           function is called, the POSIX_TRACE_STOP system trace event shall
           not be recorded and the trace stream shall remain suspended. If
           the trace stream is full, the POSIX_TRACE_STOP system trace event
           shall not be recorded and the status of the trace stream shall not
           be changed.
    


## RETURN VALUE



           Upon successful completion, these functions shall return a value
           of zero. Otherwise, they shall return the corresponding error
           number.
    


## ERRORS



           These functions shall fail if:
    
           **EINVAL** The value of the argument _trid_ does not correspond to an
                  active trace stream and thus no trace stream was started or
                  stopped.
    
           **EINTR** The operation was interrupted by a signal and thus the
                  trace stream was not necessarily started or stopped.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           The _posix_trace_start_() and _posix_trace_stop_() functions may be
           removed in a future version.
    


* * *
# clog2

## NAME



           clog2, clog2f, clog2l - base-2 logarithm of a complex number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex clog2(double complex** _z_**);**
           **float complex clog2f(float complex** _z_**);**
           **long double complex clog2l(long double complex** _z_**);**
    


## DESCRIPTION



           The call _clog2(z)_ is equivalent to **clog(z)/log(2)**.
    
           The other functions perform the same task for _float_ and _long_
           _double_.
    
           Note that _z_ close to zero will cause an overflow.
    


## STANDARDS



           None.
    


* * *
# function::ansi_clear_screen

## NAME



           function::ansi_clear_screen - Move cursor to top left and clear
           screen.
    


## SYNOPSIS



               ansi_clear_screen()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code for moving cursor to top left and then the ansi
           code for clearing the screen from the cursor position to the end.
    


* * *
# probe::socket.recvmsg.return

## NAME



           probe::socket.recvmsg.return - Return from Message being received
           on socket
    


## SYNOPSIS



           socket.recvmsg.return
    


## VALUES



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


## CONTEXT



           The message receiver.
    


## DESCRIPTION



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


* * *
# sd_bus_set_fd

## NAME



           sd_bus_set_fd - Set the file descriptors to use for bus
           communication
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_set_fd(sd_bus ***_bus_**, int** _input_fd_**, int** _output_fd_**);**
    


## DESCRIPTION



           **sd_bus_set_fd()** sets the file descriptors used to communicate by a
           bus connection object. Both _input_fd_ and _output_fd_ must be valid
           file descriptors, referring to stream-based file objects (e.g. a
           stream socket, a pair of pipes or FIFOs, or even a TTY device).
           _input_fd_ must be readable, and _output_fd_ must be writable. The
           same file descriptor may be used (and typically is used) as both
           the input and the output file descriptor. This function must be
           called before the bus connection is started via sd_bus_start(3).
    
           The bus connection object will take possession of the passed file
           descriptors and will close them automatically when it is freed.
           Use sd_bus_set_close_on_exit(3) to turn off this behaviour.
    


## RETURN VALUE



           On success, **sd_bus_set_fd()** returns a non-negative integer. On
           failure, it returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               An invalid bus object was passed.
    
               Added in version 248.
    
           **-ECHILD**
               The bus connection was allocated in a parent process and is
               being reused in a child process after **fork()**.
    
               Added in version 248.
    
           **-EBADF**
               An invalid file descriptor was passed to **sd_bus_set_fd()**.
    
               Added in version 248.
    
           **-ENOPKG**
               The bus cannot be resolved.
    
               Added in version 248.
    
           **-EPERM**
               The bus connection has already been started.
    
               Added in version 248.
    


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


* * *
# isatty

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



           isatty — test for a terminal device
    


## SYNOPSIS



           #include <unistd.h>
    
           int isatty(int _fildes_);
    


## DESCRIPTION



           The _isatty_() function shall test whether _fildes_ , an open file
           descriptor, is associated with a terminal device.
    


## RETURN VALUE



           The _isatty_() function shall return 1 if _fildes_ is associated with
           a terminal; otherwise, it shall return 0 and may set _errno_ to
           indicate the error.
    


## ERRORS



           The _isatty_() function may fail if:
    
           **EBADF** The _fildes_ argument is not a valid open file descriptor.
    
           **ENOTTY** The file associated with the _fildes_ argument is not a
                  terminal.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _isatty_() function does not necessarily indicate that a human
           being is available for interaction via _fildes_.  It is quite
           possible that non-terminal devices are connected to the
           communications line.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs11_deinit

## NAME



           gnutls_pkcs11_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **void gnutls_pkcs11_deinit(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           This function will deinitialize the PKCS 11 subsystem in gnutls.
           This function is only needed if you need to deinitialize the
           subsystem without calling **gnutls_global_deinit()**.
    


## SINCE



           2.12.0
    


* * *
# auparse_get_field_int

## NAME



           auparse_get_field_int - get current field's value as an int
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_get_field_int(auparse_state_t ***_au);"_
    


## DESCRIPTION



           auparse_get_field_int allows access to the value as an int of the
           current field of the current record in the current event.
    


## RETURN VALUE



           Returns -1 if there is an error with errno set appropriately or
           the value if errno is zero.
    


* * *
# gnutls_pubkey_encrypt_data

## NAME



           gnutls_pubkey_encrypt_data - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_encrypt_data(gnutls_pubkey_t** _key_**, unsigned int**
           _flags_**, const gnutls_datum_t ***_plaintext_**, gnutls_datum_t ***
           _ciphertext_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           unsigned int flags
                       should be 0 for now
    
           const gnutls_datum_t * plaintext
                       The data to be encrypted
    
           gnutls_datum_t * ciphertext
                       contains the encrypted data
    


## DESCRIPTION



           This function will encrypt the given data, using the public key.
           On success the  _ciphertext_ will be allocated using
           **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# tapset::dentry

## NAME



           tapset::dentry - systemtap dentry tapset
    


## DESCRIPTION



    


* * *
# fgetgrent

## NAME



           fgetgrent - get group file entry
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
           **#include <sys/types.h>**
           **#include <grp.h>**
    
           **struct group *fgetgrent(FILE ***_stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fgetgrent**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _SVID_SOURCE
    


## DESCRIPTION



           The **fgetgrent**() function returns a pointer to a structure
           containing the group information from the file referred to by
           _stream_.  The first time it is called it returns the first entry;
           thereafter, it returns successive entries.  The file referred to
           by _stream_ must have the same format as _/etc/group_ (see group(5)).
    
           The _group_ structure is defined in _< grp.h>_ as follows:
    
               struct group {
                   char   *gr_name;        /* group name */
                   char   *gr_passwd;      /* group password */
                   gid_t   gr_gid;         /* group ID */
                   char  **gr_mem;         /* NULL-terminated array of pointers
                                              to names of group members */
               };
    


## RETURN VALUE



           The **fgetgrent**() function returns a pointer to a _group_ structure,
           or NULL if there are no more entries or an error occurs.  In the
           event of an error, _errno_ is set to indicate the error.
    


## ERRORS



           **ENOMEM** Insufficient memory to allocate _group_ structure.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# cacosl

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



           cacosl — complex arc cosine functions
    


## SYNOPSIS



           #include <complex.h>
    
           long double complex cacosl(long double complex _z_);
    


## DESCRIPTION



           Refer to cacos(3p).
    


* * *
# security_policyvers

## NAME



           security_policyvers - get the version of the SELinux policy
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int security_policyvers(void);**
    


## DESCRIPTION



           **security_policyvers**() returns the version of the policy (a
           positive integer) on success, or -1 on error.
    


* * *
# gnutls_privkey_get_spki

## NAME



           gnutls_privkey_get_spki - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_get_spki(gnutls_privkey_t** _privkey_**,**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t privkey
                       a public key of type **gnutls_privkey_t**
    
           gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_privkey_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will return the public key information if available.
           The provided  _spki_ must be initialized.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# gnutls_oid_to_pk

## NAME



           gnutls_oid_to_pk - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_pk_algorithm_t gnutls_oid_to_pk(const char ***_oid_**);**
    


## ARGUMENTS



           const char * oid
                       is an object identifier
    


## DESCRIPTION



           Converts a textual object identifier to a **gnutls_pk_algorithm_t**
           value.
    


## RETURNS



           a **gnutls_pk_algorithm_t** id of the specified digest algorithm, or
           **GNUTLS_PK_UNKNOWN** on failure.
    


## SINCE



           3.4.3
    


* * *
# gnutls_kx_get

## NAME



           gnutls_kx_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_kx_algorithm_t gnutls_kx_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the currently used key exchange algorithm.
    
           This function will return **GNUTLS_KX_ECDHE_RSA** , or
           **GNUTLS_KX_DHE_RSA** under TLS 1.3, to indicate an elliptic curve DH
           key exchange or a finite field one. The precise group used is
           available by calling **gnutls_group_get()** instead.
    


## RETURNS



           the key exchange algorithm used in the last handshake, a
           **gnutls_kx_algorithm_t** value.
    


* * *
# sd-varlink

## NAME



           sd-varlink - APIs for Varlink IPC
    


## SYNOPSIS



           **#include <systemd/sd-varlink.h>**
    
           **pkg-config --cflags --libs libsystemd**
    


## DESCRIPTION



           sd-varlink.h is part of libsystemd(3) and provides APIs for
           implementing Varlink IPC clients and services. See
           **https://varlink.org/******for more information about Varlink IPC.
    
           Varlink IPC uses**JSON******[1] as marshalling format. The sd-varlink API
           relies on thesd-json(3) API for JSON serialization,
           deserialization and manipulation.
    
           The varlinkctl(1) tool makes the functionality implemented by
           sd-varlink available from the command line.
    


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


## NOTES



            1. JSON
               https://json.org/
    


* * *
# pthread_yield

## NAME



           pthread_yield - yield the processor
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <pthread.h>**
    
           **[[deprecated]] int pthread_yield(void);**
    


## DESCRIPTION



           **Note** : This function is deprecated; see below.
    
           **pthread_yield**() causes the calling thread to relinquish the CPU.
           The thread is placed at the end of the run queue for its static
           priority and another thread is scheduled to run.  For further
           details, see sched_yield(2)
    


## RETURN VALUE



           On success, **pthread_yield**() returns 0; on error, it returns an
           error number.
    


## ERRORS



           On Linux, this call always succeeds (but portable and future-proof
           applications should nevertheless handle a possible error return).
    


## ATTRIBUTES



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


## VERSIONS



           On Linux, this function is implemented as a call to
           sched_yield(2).
    


## STANDARDS



           None.
    


## NOTES



           **pthread_yield**() is intended for use with real-time scheduling
           policies (i.e., **SCHED_FIFO** or **SCHED_RR**).  Use of **pthread_yield**()
           with nondeterministic scheduling policies such as **SCHED_OTHER** is
           unspecified and very likely means your application design is
           broken.
    


* * *
# gnutls_auth_client_get_type

## NAME



           gnutls_auth_client_get_type - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_credentials_type_t**
           **gnutls_auth_client_get_type(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the type of credentials that were used for client
           authentication.  The returned information is to be used to
           distinguish the function used to access authentication data.
    
           Note that on resumed sessions, this function returns the schema
           used in the original session authentication.
    


## RETURNS



           The type of credentials for the client authentication schema, a
           **gnutls_credentials_type_t** type.
    


* * *
# gnutls_x509_ext_import_basic_constraints

## NAME



           gnutls_x509_ext_import_basic_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_basic_constraints(const gnutls_datum_t**
           *****_ext_**, unsigned int ***_ca_**, int ***_pathlen_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       the DER encoded extension data
    
           unsigned int * ca
                       will be non zero if the CA status is true
    
           int * pathlen
                       the path length constraint; will be set to -1 for no
                       limit
    


## DESCRIPTION



           This function will return the CA status and path length constraint
           as written in the PKIX extension 2.5.29.19.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# function::set_kernel_short

## NAME



           function::set_kernel_short - Writes a short value to kernel memory
    


## SYNOPSIS



               set_kernel_short(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The kernel address to write the short to
    
           _val_
               The short which is to be written
    


## DESCRIPTION



           Writes the short value to a given kernel memory address. Reports
           an error when writing to the given address fails. Requires the use
           of guru mode (-g).
    


* * *
# probe::nfs.aop.write_end

## NAME



           probe::nfs.aop.write_end - NFS client complete writing data
    


## SYNOPSIS



           nfs.aop.write_end
    


## VALUES



           _dev_
               device identifier
    
           _ino_
               inode number
    
           _i_size_
               file length in bytes
    
           _i_flag_
               file flags
    
           ___page_
               the address of page
    
           _size_
               write bytes
    
           _offset_
               start address of this write operation
    
           _to_
               end address of this write operation
    
           _page_index_
               offset within mapping, can used a page identifier and position
               identifier in the page frame
    
           _sb_flag_
               super block flags
    


## DESCRIPTION



           Fires when do a write operation on nfs, often after prepare_write
    
           Update and possibly write a cached page of an NFS file.
    


* * *
# gnutls_certificate_set_x509_trust_file

## NAME



           gnutls_certificate_set_x509_trust_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_trust_file(gnutls_certificate_credentials_t**
           _cred_**, const char ***_cafile_**, gnutls_x509_crt_fmt_t** _type_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t cred
                       is a **gnutls_certificate_credentials_t** type.
    
           const char * cafile
                       is a file containing the list of trusted CAs (DER or
                       PEM list)
    
           gnutls_x509_crt_fmt_t type
                       is PEM or DER
    


## DESCRIPTION



           This function adds the trusted CAs in order to verify client or
           server certificates. In case of a client this is not required to
           be called if the certificates are not verified using
           **gnutls_certificate_verify_peers2()**.  This function may be called
           multiple times.
    
           In case of a server the names of the CAs set here will be sent to
           the client if a certificate request is sent. This can be disabled
           using **gnutls_certificate_send_x509_rdn_sequence()**.
    
           This function can also accept URLs. In that case it will import
           all certificates that are marked as trusted. Note that the
           supported URLs are the ones indicated by
           **gnutls_url_is_supported()**.
    


## RETURNS



           the number of certificates processed
    


* * *
# ldap_rename

## NAME



           ldap_rename, ldap_rename_s - Renames the specified entry.
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_rename( ld, dn, newrdn, newparent, deleteoldrdn, sctrls[], cctrls[], msgidp );**
           LDAP *ld;
           const char *dn, *newrdn, *newparent;
           int deleteoldrdn;
           LDAPControl *sctrls[], *cctrls[];
           int *msgidp);
    
           **int ldap_rename_s( ld, dn, newrdn, newparent, deleteoldrdn, sctrls[], cctrls[] );**
           LDAP *ld;
           const char *dn, *newrdn, *newparent;
           int deleteoldrdn;
           LDAPControl *sctrls[], *cctrls[];
    


## DESCRIPTION



           These routines are used to perform a LDAP rename operation.  The
           function changes the leaf component of an entry's distinguished
           name and  optionally moves the entry to a new parent container.
           The **ldap_rename_s** performs a rename operation synchronously.  The
           method takes _dn_ , which points to the distinguished name of the
           entry whose attribute is being compared, _newparent_ ,the
           distinguished name of the entry's new parent. If this parameter is
           NULL, only the RDN is changed.  The root DN is specified by
           passing a zero length string, "".  _deleteoldrdn_ specifies whether
           the old RDN should be retained or deleted.  Zero indicates that
           the old RDN should be retained. If you choose this option, the
           attribute will contain both names (the old and the new).  Non-zero
           indicates that the old RDN should be deleted.  _serverctrls_ points
           to an array of LDAPControl structures that list the client
           controls to use with this extended operation. Use NULL to specify
           no client controls. _clientctrls_ points to an array of LDAPControl
           structures that list the client controls to use with the search.
    
           **ldap_rename** works just like **ldap_rename_s,** but the operation is
           asynchronous. It returns the message id of the request it
           initiated. The result of this operation can be obtained by calling
           ldap_result(3).
    


## ERRORS



           **ldap_rename()** returns -1 in case of error initiating the request,
           and will set the _ld_errno_ field in the _ld_ parameter to indicate
           the error.  **ldap_rename_s()** returns the LDAP error code resulting
           from the rename operation.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


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


* * *
# timespec

## NAME



           timespec - time in seconds and nanoseconds
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **struct timespec {**
               **time_t     tv_sec;** /* Seconds */
               /* ... */  **tv_nsec;** /* Nanoseconds [**0** , **999'999'999**] */
           **};**
    


## DESCRIPTION



           Describes times in seconds and nanoseconds.
    
           _tv_nsec_ is of an implementation-defined signed type capable of
           holding the specified range.  Under glibc, this is usually _long_ ,
           and _long long_ on X32.  It can be safely down-cast to any concrete
           32-bit integer type for processing.
    


## VERSIONS



           Prior to C23, _tv_nsec_ was _long_.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< aio.h>_, _< mqueue.h>_,
           _< sched.h>_, _< signal.h>_, _< sys/select.h>_, and _< sys/stat.h>_.
    


* * *
# io_uring_prep_rename

## NAME



           io_uring_prep_renameat - prepare a renameat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <stdio.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_renameat(struct io_uring_sqe ***_sqe_**,**
                                       **int** _olddirfd_**,**
                                       **const char ***_oldpath_**,**
                                       **int** _newdirfd_**,**
                                       **const char ***_newpath_**,**
                                       **unsigned int** _flags_**);**
    
           **void io_uring_prep_rename(struct io_uring_sqe ***_sqe_**,**
                                     **const char ***_oldpath_**,**
                                     **const char ***_newpath_**);**
    


## DESCRIPTION



           The io_uring_prep_renameat(3) function prepares a renameat
           request. The submission queue entry _sqe_ is setup to use the old
           directory file descriptor pointed to by _olddirfd_ and old path
           pointed to by _oldpath_ with the new directory file descriptor
           pointed to by _newdirfd_ and the new path pointed to by _newpath_ and
           using the specified flags in _flags_.
    
           The io_uring_prep_rename(3) function prepares a rename request.
           The submission queue entry _sqe_ is setup to use the old path
           pointed to by _oldpath_ with the new path pointed to by _newpath_ ,
           both relative to the current working directory and using the
           specified flags in _flags_.
    
           These functions prepare an async renameat2(2) or rename(2)
           request. If _flags_ is zero, then this call is similar to the
           renameat(2) system call. 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).
    


* * *