tripathysagar/man_text huggingface dataset:
# gnutls_record_send_file

## NAME



           gnutls_record_send_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **ssize_t gnutls_record_send_file(gnutls_session_t** _session_**, int** _fd_**,**
           **off_t ***_offset_**, size_t** _count_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int fd      file descriptor from which to read data.
    
           off_t * offset
                       Is relative to file offset, denotes the starting
                       location for reading.  after function returns, it
                       point to position following last read byte.
    
           size_t count
                       is the length of the data in bytes to be read from
                       file and send.
    


## DESCRIPTION



           This function sends data from  _fd_ . If KTLS (kernel TLS) is
           enabled, it will use the **sendfile()** system call to avoid overhead
           of copying data between user space and the kernel. Otherwise, this
           functionality is merely emulated by calling **read()** and
           **gnutls_record_send()**. If this implementation is suboptimal, check
           whether KTLS is enabled using **gnutls_transport_is_ktls_enabled()**.
    
           If  _offset_ is NULL then file offset is incremented by number of
           bytes send, otherwise file offset remains unchanged.
    


## RETURNS



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


* * *
# gnutls_base64_decode2

## NAME



           gnutls_base64_decode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_base64_decode2(const gnutls_datum_t ***_base64_**,**
           **gnutls_datum_t ***_result_**);**
    


## ARGUMENTS



           const gnutls_datum_t * base64
                       contains the encoded data
    
           gnutls_datum_t * result
                       the location of decoded data
    


## DESCRIPTION



           This function will decode the given base64 encoded data. The
           decoded data will be allocated, and stored into result.
    
           You should use **gnutls_free()** to free the returned data.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# function::rlimit_from_str

## NAME



           function::rlimit_from_str - Symbolic string associated with
           resource limit code
    


## SYNOPSIS



               rlimit_from_str:long(lim_str:string)
    


## ARGUMENTS



           _lim_str_
               The string representation of limit
    


## DESCRIPTION



           This function returns the number associated with the given string,
           such as 0 for the string RLIMIT_CPU, or -1 for an out-of-range
           value.
    


* * *
# gnutls_fips140_context_init

## NAME



           gnutls_fips140_context_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_fips140_context_init(gnutls_fips140_context_t ***
           _context_**);**
    


## ARGUMENTS



           gnutls_fips140_context_t * context
                       location to store  _gnutls_fips140_context_t_
    


## DESCRIPTION



           Create and initialize the FIPS context object.
    


## RETURNS



           0 upon success, a negative error code otherwise
    


## SINCE



           3.7.3
    


* * *
# gnutls_x509_crl_export

## NAME



           gnutls_x509_crl_export - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_export(gnutls_x509_crl_t** _crl_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       Holds the revocation list
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a private key 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 revocation list to DER or PEM
           format.
    
           If the buffer provided is not long enough to hold the output, then
           **GNUTLS_E_SHORT_MEMORY_BUFFER** will be returned.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           X509 CRL".
    


## RETURNS



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


* * *
# pmasortindom

## NAME



           **pmaSortInDom** - sort an instance domain
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **void pmaSortInDom(__pmLogInDom ***_lidp_**);**
    
           **cc ... -lpcp_archive -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           The instance domain identified by _lidp_ is sorted in ascending  in‐
           ternal instance identifier value.  Both the _lidp_ ->_instlist_[] array
           and the corresponding _lidp_ ->_namelist_[] array are sorted.
    
           Since  instance  domains  are usually sorted (at their source by a
           PMDA), a bubble sort is used.  This means that if  the  caller  is
           unsure  if  the  instance domain is sorted (but it actually is al‐
           ready sorted), then calling **pmaSortInDom** is as fast as checking if
           the instance domain is sorted, so when in doubt, simply call  **pma‐**
           **SortInDom**.
    


## DIAGNOSTICS AND RETURN VALUES



           None.
    


* * *
# tm

## NAME



           tm - broken-down time
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **struct tm {**
               **int         tm_sec;** /* Seconds          [**0** , **60**] */
               **int         tm_min;** /* Minutes          [**0** , **59**] */
               **int         tm_hour;** /* Hour             [**0** , **23**] */
               **int         tm_mday;** /* Day of the month [**1** , **31**] */
               **int         tm_mon;** /* Month            [**0** , **11**]  (January = **0**) */
               **int         tm_year;** /* Year minus **1900** */
               **int         tm_wday;** /* Day of the week  [**0** , **6**]   (Sunday = **0**) */
               **int         tm_yday;** /* Day of the year  [**0** , **365**] (Jan/01 = **0**) */
               **int         tm_isdst;** /* Daylight savings flag */
    
               **long        tm_gmtoff;** /* Seconds East of UTC */
               **const char *tm_zone;** /* Timezone abbreviation */
           **};**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           _tm_gmtoff_ , _tm_zone_ :
               Since glibc 2.20:
                   _DEFAULT_SOURCE
               glibc 2.20 and earlier:
                   _BSD_SOURCE
    


## DESCRIPTION



           Describes time, broken down into distinct components.
    
           _tm_isdst_ describes whether daylight saving time is in effect at
           the time described.  The value is positive if daylight saving time
           is in effect, zero if it is not, and negative if the information
           is not available.
    
           _tm_gmtoff_ is the difference, in seconds, of the timezone
           represented by this broken-down time and UTC (this is the additive
           inverse of timezone(3)).
    
           _tm_zone_ is the equivalent of tzname(3) for the timezone
           represented by this broken-down time.
    


## VERSIONS



           In C90, _tm_sec_ could represent values in the range [**0** , **61**], which
           could represent a double leap second.  UTC doesn't permit double
           leap seconds, so it was limited to **60** in C99.
    
           timezone(3), as a variable, is an XSI extension: some systems
           provide the V7-compatible timezone(3) function.  The _tm_gmtoff_
           field provides an alternative (with the opposite sign) for those
           systems.
    
           _tm_zone_ points to static storage and may be overridden on
           subsequent calls to localtime(3) and similar functions (however,
           this never happens under glibc).
    


## STANDARDS



           C23, POSIX.1-2024.
    


## NOTES



           _tm_sec_ can represent a leap second with the value **60**.
    


* * *
# probe::kprocess.create

## NAME



           probe::kprocess.create - Fires whenever a new process or thread is
           successfully created
    


## SYNOPSIS



           kprocess.create
    


## VALUES



           _new_pid_
               The PID of the newly created process
    
           _new_tid_
               The TID of the newly created task
    


## CONTEXT



           Parent of the created process.
    


## DESCRIPTION



           Fires whenever a new process is successfully created, either as a
           result of fork (or one of its syscall variants), or a new kernel
           thread.
    


* * *
# function::cve_record_metric

## NAME



           function::cve_record_metric - Set the value of key
    


## SYNOPSIS



               cve_record_metric(key:string,value:long)
    


## ARGUMENTS



           _key_
               The metric
    
           _value_
               The new value
    


## DESCRIPTION



           This function sets the value of the metric key. The metrics can be
           accessed in /proc/systemtap/MODULE_NAME/__prometheus
    


* * *
# pcre2_convert_context_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_convert_context *pcre2_convert_context_create(**
             **pcre2_general_context ***_gcontext_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It creates and initializes a new convert context. If
           its argument is NULL, **malloc()** is used to get the necessary
           memory; otherwise the memory allocation function within the
           general context is used. The result is NULL if the memory could
           not be obtained.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# gnutls_pkcs11_copy_x509_crt

## NAME



           gnutls_pkcs11_copy_x509_crt - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_x509_crt(const char ***_token_url_**,**
           **gnutls_x509_crt_t** _crt_**, const char ***_label_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_x509_crt_t crt
                       A certificate
    
           const char * label
                       A name to be used for the stored data
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_FLAG_*
    


## DESCRIPTION



           This function will copy a certificate into a PKCS **11** token
           specified by a URL. The certificate can be marked as trusted or
           not.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# mlx5dv_alloc_var

## NAME



           mlx5dv_alloc_var - Allocates a VAR
    
           mlx5dv_free_var - Frees a VAR
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_var *
                  mlx5dv_alloc_var(struct ibv_context *context, uint32_t flags);
    
                  void mlx5dv_free_var(struct mlx5dv_var *dv_var);
    


## DESCRIPTION



           Create / free a VAR which can be used for some device commands
           over the DEVX interface.
    
           The DEVX API enables direct access from the user space area to the
           mlx5 device driver, the VAR information is needed for few commands
           related to Virtio.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _flags_  Allocation flags for the UAR.
    
       **dv_var**
                  struct mlx5dv_var {
                      uint32_t page_id;
                      uint32_t length;
                      off_t mmap_off;
                      uint64_t comp_mask;
                  };
    
           _page_id_
                  The device page id to be used.
    
           _length_ The mmap length parameter to be used for mapping a VA to
                  the allocated VAR entry.
    
           _mmap_off_
                  The mmap offset parameter to be used for mapping a VA to
                  the allocated VAR entry.
    


## RETURN VALUE



           Upon success _mlx5dv_alloc_var_ returns a pointer to the created VAR
           ,on error NULL will be returned and errno will be set.
    


* * *
# gnutls_certificate_get_crt_raw

## NAME



           gnutls_certificate_get_crt_raw - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_get_crt_raw(gnutls_certificate_credentials_t**
           _sc_**, unsigned** _idx1_**, unsigned** _idx2_**, gnutls_datum_t ***_cert_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t sc
                       is a **gnutls_certificate_credentials_t** type.
    
           unsigned idx1
                       the index of the certificate chain if multiple are
                       present
    
           unsigned idx2
                       the index of the certificate in the chain. Zero gives
                       the server's certificate.
    
           gnutls_datum_t * cert
                       Will hold the DER encoded certificate.
    


## DESCRIPTION



           This function will return the DER encoded certificate of the
           server or any other certificate on its certificate chain (based on
           _idx2_ ).  The returned data should be treated as constant and only
           accessible during the lifetime of  _sc_ . The  _idx1_ matches the
           value **gnutls_certificate_set_x509_key()** and friends functions.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value. In case the indexes are out of bounds
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## SINCE



           3.2.5
    


* * *
# __pmcheckattribute

## NAME



           **__pmCheckAttribute** - check value for a client connection attribute
    


## C SYNOPSIS



           **#include "pmapi.h"**
           **#include "libpcp.h"**
    
           **int __pmCheckAttribute(__pmAttrKey** _attr_**, const char ***_value_**);**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed  across  releases, and they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           Connection attributes are exchanged between pmcd(1) and PCP client
           tools at the start of the protocol exchange.  They provide option‐
           al information relating to an individual connection, such  as  the
           name of a specific container that is under analysis by the client.
    
           **__pmCheckAttribute** verifies that the given attribute _attr_ follows
           the expected syntax for that type of attribute.  This assists with
           the prevention of malicious content  being  accepted  by  **pmcd** as
           these  attributes  may  subsequently be used in parsers or carried
           into structured output such as JSON format.
    


## RETURN VALUES



           When presented with an unrecognised attribute or an invalid  _value_
           for the specified attribute, **__pmCheckAttribute** returns a negative
           value  suitable for reporting with pmErrStr(3).  Otherwise the re‐
           turn value is zero indicating success.
    


* * *
# gnutls_x509_crt_get_version

## NAME



           gnutls_x509_crt_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_version(gnutls_x509_crt_t** _cert_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    


## DESCRIPTION



           This function will return the version of the specified
           Certificate.
    


## RETURNS



           version of certificate, or a negative error code on error.
    


* * *
# gnutls_pubkey_export_rsa_raw

## NAME



           gnutls_pubkey_export_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_rsa_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus (may be **NULL**)
    
           gnutls_datum_t * e
                       will hold the public exponent (may be **NULL**)
    


## DESCRIPTION



           This function will export the RSA public key's parameters found in
           the given structure.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.3.0
    


* * *
# gnutls_pkcs7_attrs_deinit

## NAME



           gnutls_pkcs7_attrs_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **void gnutls_pkcs7_attrs_deinit(gnutls_pkcs7_attrs_t** _list_**);**
    


## ARGUMENTS



           gnutls_pkcs7_attrs_t list
                       A list of existing attributes
    


## DESCRIPTION



           This function will clear a PKCS **7** attribute list.
    


## SINCE



           3.4.2
    


* * *
# gnutls_psk_set_server_credentials_function2

## NAME



           gnutls_psk_set_server_credentials_function2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_server_credentials_function2(gnutls_psk_server_credentials_t**
           _cred_**, gnutls_psk_server_credentials_function2** _func_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_server_credentials_function2 func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the user's
           PSK credentials.  The callback's function form is: int
           (*callback)(gnutls_session_t, const gnutls_datum_t* username,
           gnutls_datum_t* key);
    
           This callback function has the same semantics as that of
           **gnutls_psk_set_server_credentials_function()** , but it allows
           non-string usernames to be used.
    
            _username_ contains the actual username.  The  _key_ must be filled
           in using the **gnutls_malloc()**.
    
           In case the callback returned a negative number then gnutls will
           assume that the username does not exist.
    
           The callback function will only be called once per handshake.  The
           callback function should return 0 on success, while -1 indicates
           an error.
    


* * *
# pam_sm_setcred

## NAME



           pam_sm_setcred - PAM service function to alter credentials
    


## SYNOPSIS



           **#include <security/pam_modules.h>**
    
           **int pam_sm_setcred(pam_handle_t ***_pamh_**, int** _flags_**, int** _argc_**,**
                              **const char ****_argv_**);**
    


## DESCRIPTION



           The **pam_sm_setcred** function is the service module's implementation
           of the pam_setcred(3) interface.
    
           This function performs the task of altering the credentials of the
           user with respect to the corresponding authorization scheme.
           Generally, an authentication module may have access to more
           information about a user than their authentication token. This
           function is used to make such information available to the
           application. It should only be called _after_ the user has been
           authenticated but before a session has been established.
    
           Valid flags, which may be logically OR'd with _PAM_SILENT_ , are:
    
           PAM_SILENT
               Do not emit any messages.
    
           PAM_ESTABLISH_CRED
               Initialize the credentials for the user.
    
           PAM_DELETE_CRED
               Delete the credentials associated with the authentication
               service.
    
           PAM_REINITIALIZE_CRED
               Reinitialize the user credentials.
    
           PAM_REFRESH_CRED
               Extend the lifetime of the user credentials.
    
           The way the **auth** stack is navigated in order to evaluate the
           **pam_setcred**() function call, independent of the **pam_sm_setcred**()
           return codes, is exactly the same way that it was navigated when
           evaluating the **pam_authenticate**() library call. Typically, if a
           stack entry was ignored in evaluating **pam_authenticate**(), it will
           be ignored when libpam evaluates the **pam_setcred**() function call.
           Otherwise, the return codes from each module specific
           **pam_sm_setcred**() call are treated as **required**.
    


## RETURN VALUES



           PAM_CRED_UNAVAIL
               This module cannot retrieve the user's credentials.
    
           PAM_CRED_EXPIRED
               The user's credentials have expired.
    
           PAM_CRED_ERR
               This module was unable to set the credentials of the user.
    
           PAM_SUCCESS
               The user credential was successfully set.
    
           PAM_USER_UNKNOWN
               The user is not known to this authentication module.
    
           These, non-_PAM_SUCCESS_ , return values will typically lead to the
           credential stack _failing_. The first such error will dominate in
           the return value of **pam_setcred**().
    


* * *
# auparse_get_record_text

## NAME



           auparse_get_record_text - access unparsed record data
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_record_text returns a pointer to the full unparsed
           record.
    


## RETURN VALUE



           Returns NULL if an error occurs; otherwise, a pointer to the
           record.
    


* * *
# setsid

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



           setsid — create session and set process group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t setsid(void);
    


## DESCRIPTION



           The _setsid_() function shall create a new session, if the calling
           process is not a process group leader. Upon return the calling
           process shall be the session leader of this new session, shall be
           the process group leader of a new process group, and shall have no
           controlling terminal. The process group ID of the calling process
           shall be set equal to the process ID of the calling process. The
           calling process shall be the only process in the new process group
           and the only process in the new session.
    


## RETURN VALUE



           Upon successful completion, _setsid_() shall return the value of the
           new process group ID of the calling process. Otherwise, it shall
           return -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _setsid_() function shall fail if:
    
           **EPERM** The calling process is already a process group leader, or
                  the process group ID of a process other than the calling
                  process matches the process ID of the calling process.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The _setsid_() function is similar to the _setpgrp_() function of
           System V.  System V, without job control, groups processes into
           process groups and creates new process groups via _setpgrp_(); only
           one process group may be part of a login session.
    
           Job control allows multiple process groups within a login session.
           In order to limit job control actions so that they can only affect
           processes in the same login session, this volume of POSIX.1‐2017
           adds the concept of a session that is created via _setsid_().  The
           _setsid_() function also creates the initial process group contained
           in the session. Additional process groups can be created via the
           _setpgid_() function. A System V process group would correspond to a
           POSIX System Interfaces session containing a single POSIX process
           group. Note that this function requires that the calling process
           not be a process group leader. The usual way to ensure this is
           true is to create a new process with _fork_() and have it call
           _setsid_().  The _fork_() function guarantees that the process ID of
           the new process does not match any existing process group ID.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_ext_import_key_purposes

## NAME



           gnutls_x509_ext_import_key_purposes - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_key_purposes(const gnutls_datum_t ***
           _ext_**, gnutls_x509_key_purposes_t** _p_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       The DER-encoded extension data
    
           gnutls_x509_key_purposes_t p
                       The key purposes
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will extract the key purposes in the provided
           DER-encoded ExtKeyUsageSyntax PKIX extension, to a
           **gnutls_x509_key_purposes_t** type.  The data must be initialized.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_heartbeat_pong

## NAME



           gnutls_heartbeat_pong - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_heartbeat_pong(gnutls_session_t** _session_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function replies to a ping by sending a pong to the peer.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.1.2
    


* * *
# function::ansi_cursor_show

## NAME



           function::ansi_cursor_show - Shows the cursor.
    


## SYNOPSIS



               ansi_cursor_show()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Sends ansi code for showing the cursor.
    


* * *
# auparse_destroy

## NAME



           auparse_destroy - release instance of parser
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **void auparse_destroy(auparse_state_t ***_au);"_
    
           **void auparse_destroy_ext(auparse_state_t *au,**
           **auparse_destroy_what_t what);**
    


## DESCRIPTION



           **auparse_destroy** frees all data structures and closes file
           descriptors.
    
           **auparse_destroy_ext** frees data structures based on what. What can
           be AUPARSE_DESTROY_ALL to release everything or
           AUPARSE_DESTROY_COMMON to release everything but the uid and gid
           lookup cache.
    


## RETURN VALUE



           None.
    


* * *
# ll2_update_login_time

## NAME



           ll2_update_login_time - Writes a *new* entry with updated login
           time.
    


## SYNOPSIS



           **#include <lastlog2.h>**
    
           **int ll2_update_login_time (struct ll2_context ***_context_**, const char**
           *****_user_**, int64_t** _ll_time_**, char ****_error_**);**
    


## DESCRIPTION



           Writes a **new** entry to database, defined in _context_ , for user _user_.
           Time is set by _ll_time_ whereas the other values are taken from an
           already existing entry. If _context_ is NULL, the default database,
           defined in _LL2_DEFAULT_DATABASE_ , will be taken.
    
               char    *error = NULL;
               const   char *user = "root";
               int64_t login_time = time(0); // Get the system time;
    
               int ret = ll2_update_login_time (NULL, user, login_time, &error);
    


## RETURN VALUE



           Returns 0 on success, -ENOMEM or -1 on other failure. _error_
           contains an error string if the return value is -1. _error_ is not
           guaranteed to contain an error string, could also be NULL. _error_
           should be freed by the caller.
    


## AVAILABILITY



           The **liblastlog2** library is part of the util-linux package since
           version 2.40. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-01-16       _LL2_UPDATE_LOGIN_TIME_(3)
    


* * *
# function::raise

## NAME



           function::raise - raise a signal in the current thread
    


## SYNOPSIS



               raise(signo:long)
    


## ARGUMENTS



           _signo_
               signal number
    


## DESCRIPTION



           This function calls the kernel send_sig routine on the current
           thread, with the given raw unchecked signal number. It may raise
           an error if **send_sig** failed. It requires guru mode.
    


* * *
# pam_xauth_data

## NAME



           pam_xauth_data - structure containing X authentication data
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           struct pam_xauth_data {
               int namelen;
               char *name;
               int datalen;
               char *data;
           };
    


## DESCRIPTION



           The **pam_xauth_data** structure contains X authentication data used
           to make a connection to an X display. Using this mechanism, an
           application can communicate X authentication data to PAM service
           modules. This allows modules to make a connection to the user's X
           display in order to label the user's session on login, display
           visual feedback or for other purposes.
    
           The _name_ field contains the name of the authentication method,
           such as "MIT-MAGIC-COOKIE-1". The _namelen_ field contains the
           length of this string, not including the trailing NUL character.
    
           The _data_ field contains the authentication method-specific data
           corresponding to the specified name. The _datalen_ field contains
           its length in bytes.
    
           The X authentication data can be changed with the _PAM_XAUTH_DATA_
           item. It can be queried and set with pam_get_item(3) and
           **pam_set_item**(3) respectively. The value used to set it should be
           a pointer to a pam_xauth_data structure. An internal copy of both
           the structure itself and its fields is made by PAM when setting
           the item.
    


## STANDARDS



           The **pam_xauth_data** structure and _PAM_XAUTH_DATA_ item are Linux-PAM
           extensions.
    


* * *
# gnutls_subject_alt_names_deinit

## NAME



           gnutls_subject_alt_names_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void gnutls_subject_alt_names_deinit(gnutls_subject_alt_names_t**
           _sans_**);**
    


## ARGUMENTS



           gnutls_subject_alt_names_t sans
                       The alternative names
    


## DESCRIPTION



           This function will deinitialize an alternative names structure.
    


## SINCE



           3.3.0
    


* * *
# gnutls_pkcs11_privkey_export_url

## NAME



           gnutls_pkcs11_privkey_export_url - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_export_url(gnutls_pkcs11_privkey_t** _key_**,**
           **gnutls_pkcs11_url_type_t** _detailed_**, char ****_url_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t key
                       Holds the PKCS 11 key
    
           gnutls_pkcs11_url_type_t detailed
                       non zero if a detailed URL is required
    
           char ** url will contain an allocated url
    


## DESCRIPTION



           This function will export a URL identifying the given key.
    


## RETURNS



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


* * *
# pmgetpmnslocation

## NAME



           **pmGetPMNSLocation** - determine the location of the currently used
           PMNS
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetPMNSLocation(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           If an application needs to know where the Performance Metrics Name
           Space  (PMNS)  is  coming  from then **pmGetPMNSLocation** will return
           whether it is from an archive, **PMNS_ARCHIVE** , or from a local  PMNS
           file, **PMNS_LOCAL** , or from a remote pmcd, **PMNS_REMOTE**.
    
           This information may be useful in determining an appropriate error
           message depending on the PMNS' location.
    


## DIAGNOSTICS



           **PM_ERR_NOPMNS**
                  If is not possible to determine where the location of the
                  PMNS is.  This could be due to problems with the current
                  context or being unable to load a local PMNS.
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to parameter‐
           ize the file and directory names used by PCP.  On each installa‐
           tion, the file _/etc/pcp.conf_ contains the local values for these
           variables.  The **$PCP_CONF** variable may be used to specify an al‐
           ternative configuration file, as described in pcp.conf(5).  Values
           for these variables may be obtained programmatically using the
           pmGetConfig(3) function.
    


* * *
# io_uring_minor_version

## NAME



           io_uring_check_version - functions and macros to check the
           liburing version
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **bool io_uring_check_version(int** _major_**, int** _minor_**);**
           **IO_URING_CHECK_VERSION(**_major_**,**_minor_**);**
    
           **int io_uring_major_version(void);**
           **IO_URING_VERSION_MAJOR;**
    
           **int io_uring_minor_version(void);**
           **IO_URING_VERSION_MINOR;**
    


## DESCRIPTION



           The io_uring_check_version(3) function returns _false_ if the
           liburing library loaded by the dynamic linker is greater-than or
           equal-to the _major_ and _minor_ numbers provided.
    
           The IO_URING_CHECK_VERSION(3) macro returns _0_ if the liburing
           library being compiled against is greater-than or equal-to the
           _major_ and _minor_ numbers provided.
    
           The io_uring_major_version(3) function returns the _major_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MAJOR(3) macro returns the _major_ version
           number of the liburing library being compiled against.
    
           The io_uring_minor_version(3) function returns the _minor_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MINOR(3) macro returns the _minor_ version
           number of the liburing library being compiled against.
    


* * *
# gnutls_x509_crt_get_spki

## NAME



           gnutls_x509_crt_get_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_spki(gnutls_x509_crt_t** _cert_**,**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           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 an X.509
           certificate. The provided  _spki_ must be initialized.
    


## SINCE



           3.6.0
    


* * *
# fgetws

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



           fgetws — get a wide-character string from a stream
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           wchar_t *fgetws(wchar_t *restrict _ws_ , int _n_ ,
               FILE *restrict _stream_);
    


## 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 _fgetws_() function shall read characters from the _stream_ ,
           convert these to the corresponding wide-character codes, place
           them in the **wchar_t** array pointed to by _ws_ , until _n_ -1 characters
           are read, or a <newline> is read, converted, and transferred to
           _ws_ , or an end-of-file condition is encountered. The wide-character
           string, _ws_ , shall then be terminated with a null wide-character
           code.
    
           If an error occurs, the resulting value of the file position
           indicator for the stream is unspecified.
    
           The _fgetws_() function may mark the last data access timestamp of
           the file associated with _stream_ for update. The last data access
           timestamp shall be marked for update by the first successful
           execution of _fgetwc_(), _fgetws_(), _fwscanf_(), _getwc_(), _getwchar_(),
           _vfwscanf_(), _vwscanf_(), or _wscanf_() using _stream_ that returns data
           not supplied by a prior call to _ungetwc_().
    


## RETURN VALUE



           Upon successful completion, _fgetws_() shall return _ws_.  If the end-
           of-file indicator for the stream is set, or if the stream is at
           end-of-file, the end-of-file indicator for the stream shall be set
           and _fgetws_() shall return a null pointer. If a read error occurs,
           the error indicator for the stream shall be set, _fgetws_() shall
           return a null pointer, and shall set _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_get_dn2

## NAME



           gnutls_x509_crq_get_dn2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_dn2(gnutls_x509_crq_t** _crq_**, gnutls_datum_t**
           *****_dn_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of the
           Certificate request. The name will be in the form
           "C=xxxx,O=yyyy,CN=zzzz" as described in RFC4514. The output string
           will be ASCII or UTF-8 encoded, depending on the certificate data.
    
           This function does not output a fully RFC4514 compliant string, if
           that is required see **gnutls_x509_crq_get_dn3()**.
    


## RETURNS



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


## SINCE



           3.1.10
    


* * *
# mlx5dv_devx_subscribe_devx_event_fd

## NAME



           mlx5dv_devx_subscribe_devx_event - Subscribe over an event channel
           for device events.
    
           mlx5dv_devx_subscribe_devx_event_fd - Subscribe over an event
           channel for device events to signal eventfd.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_devx_subscribe_devx_event(struct mlx5dv_devx_event_channel *dv_event_channel,
                                       struct mlx5dv_devx_obj *obj,
                                       uint16_t events_sz,
                                       uint16_t events_num[],
                                       uint64_t cookie)
    
                  int mlx5dv_devx_subscribe_devx_event_fd(struct mlx5dv_devx_event_channel *dv_event_channel,
                                      int fd,
                                      struct mlx5dv_devx_obj *obj,
                                      uint16_t event_num)
    


## DESCRIPTION



           Subscribe over a DEVX event channel for device events.
    


## ARGUMENTS



           _dv_event_channel_
                  Event channel to subscribe over.
    
           _fd_     A file descriptor that previously was opened by the
                  eventfd() system call.
    
           _obj_    DEVX object that _events_num_ relates to, can be NULL for
                  unaffiliated events.
    
           _events_sz_
                  Size of the _events_num_ buffer that holds the events to
                  subscribe for.
    
           _events_num_
                  Holds the required event numbers to subscribe for, numbers
                  are according to the device specification.
    
           _cookie_ The value to be returned back when reading the event, can
                  be used as an ID for application use.
    


## NOTES



           When mlx5dv_devx_subscribe_devx_event_fd will be used the _fd_ will
           be signaled once an event has occurred.
    


* * *
# gnutls_srp_allocate_server_credentials

## NAME



           gnutls_srp_allocate_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_srp_allocate_server_credentials(gnutls_srp_server_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



           gnutls_srp_server_credentials_t * sc
                       is a pointer to a **gnutls_srp_server_credentials_t**
                       type.
    


## DESCRIPTION



           Allocate a gnutls_srp_server_credentials_t structure.
    


## RETURNS



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


* * *