tripathysagar/man_text huggingface dataset:
# wcswidth

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



           wcswidth — number of column positions of a wide-character string
    


## SYNOPSIS



           #include <wchar.h>
    
           int wcswidth(const wchar_t *_pwcs_ , size_t _n_);
    


## DESCRIPTION



           The _wcswidth_() function shall determine the number of column
           positions required for _n_ wide-character codes (or fewer than _n_
           wide-character codes if a null wide-character code is encountered
           before _n_ wide-character codes are exhausted) in the string pointed
           to by _pwcs_.
    


## RETURN VALUE



           The _wcswidth_() function either shall return 0 (if _pwcs_ points to a
           null wide-character code), or return the number of column
           positions to be occupied by the wide-character string pointed to
           by _pwcs_ , or return -1 (if any of the first _n_ wide-character codes
           in the wide-character string pointed to by _pwcs_ is not a printable
           wide-character code).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           This function was removed from the final
           ISO/IEC 9899:1990/Amendment 1:1995 (E), and the return value for a
           non-printable wide character is not specified.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# iswspace

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



           iswspace, iswspace_l — test for a white-space wide-character code
    


## SYNOPSIS



           #include <wctype.h>
    
           int iswspace(wint_t _wc_);
           int iswspace_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _iswspace_(): 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 _iswspace_() and _iswspace_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **space** in
           the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswspace_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswspace_() and _iswspace_l_() functions shall return non-zero if
           _wc_ is a white-space wide-character code; otherwise, they shall
           return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           To ensure applications portability, especially across natural
           languages, only these functions and the functions in the reference
           pages listed in the SEE ALSO section should be used for character
           classification.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::scheduler.signal_send

## NAME



           probe::scheduler.signal_send - Sending a signal
    


## SYNOPSIS



           scheduler.signal_send
    


## VALUES



           _pid_
               pid of the process sending signal
    
           _name_
               name of the probe point
    
           _signal_number_
               signal number
    


* * *
# tapset::tcp

## NAME



           tapset::tcp - systemtap tcp tapset
    


## DESCRIPTION



            This family of probe points is used to probe events that occur in
           the TCP layer,
    
           **tcp.sendmsg**
                  Sending a tcp message
    
                   See probe::tcp.sendmsg(3stap)
                   for details.
    
           **tcp.sendmsg.return**
                   Sending TCP message is done
    
                   See probe::tcp.sendmsg.return(3stap)
                   for details.
    
           **tcp.recvmsg**
                  Receiving TCP message
    
                   See probe::tcp.recvmsg(3stap)
                   for details.
    
           **tcp.recvmsg.return**
                  Receiving TCP message complete
    
                   See probe::tcp.recvmsg.return(3stap)
                   for details.
    
           **tcp.disconnect**
                  TCP socket disconnection
    
                   See probe::tcp.disconnect(3stap)
                   for details.
    
           **tcp.disconnect.return**
                  TCP socket disconnection complete
    
                   See probe::tcp.disconnect.return(3stap)
                   for details.
    
           **tcp.setsockopt**
                  Call to setsockopt()
    
                   See probe::tcp.setsockopt(3stap)
                   for details.
    
           **tcp.setsockopt.return**
                   Return from setsockopt()
    
                   See probe::tcp.setsockopt.return(3stap)
                   for details.
    
           **tcp.receive**
                  Called when a TCP packet is received
    
                   See probe::tcp.receive(3stap)
                   for details.
    


* * *
# ll2_write_entry

## NAME



           ll2_write_entry - Writes a new entry into the database.
    


## SYNOPSIS



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


## DESCRIPTION



           Writes a new entry into database, which is defined in _context_. If
           _context_ is NULL, the default database, defined in
           _LL2_DEFAULT_DATABASE_ , will be taken.
    
               time_t login_time = time(0); // Get the system time
               char   *error = NULL;
               const  char *user = "root";
    
               int ret = ll2_write_entry (NULL, user, login_time, "pts/0",
                                           "192.168.122.1", NULL, &error);
    
           _pam_service_ is the service or instance name which has generated
           the entry (optional).
    


## 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_WRITE_ENTRY_(3)
    


* * *
# ll2_read_entry

## NAME



           ll2_read_entry - Reads one entry from database and returns that.
    


## SYNOPSIS



           **#include <lastlog2.h>**
    
           **int ll2_read_entry (struct ll2_context ***_context_**, const char ***_user_**,**
           **int64_t ***_ll_time_**, char** _tty_**, char** _rhost, char pam_service_**, char**
           _error);_
    


## DESCRIPTION



           Reads the first entry from database, defined in _context_ , for user
           _user_. If _context_ is NULL, the default database, defined in
           _LL2_DEFAULT_DATABASE_ , will be taken.
    
               char    *error = NULL;
               const   char *user = "root";
               int64_t res_time;
               char    *res_tty = NULL;
               char    *res_rhost = NULL;
               char    *res_service = NULL;
    
               int ret = ll2_read_entry (NULL, user, &res_time, &res_tty, &res_rhost, &res_service, &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. If lastlog2 database does not exist
           at all, the errno ENOENT is set and can be checked.
    
           The evaluated values are returned by _ll_time_ , _tty_ , _rhost_ and
           _pam_service_.
    


## 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_READ_ENTRY_(3)
    


* * *
# gnutls_x509_crq_get_version

## NAME



           gnutls_x509_crq_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_version(gnutls_x509_crq_t** _crq_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    


## DESCRIPTION



           This function will return the version of the specified Certificate
           request.
    


## RETURNS



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


* * *
# tapset::system

## NAME



           tapset::system - systemtap system tapset
    


## DESCRIPTION



           **system** Issue a command to the system
    
                  See function::system(3stap)
                   for details.
    


* * *
# sem_trywait

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



           sem_trywait, sem_wait — lock a semaphore
    


## SYNOPSIS



           #include <semaphore.h>
    
           int sem_trywait(sem_t *_sem_);
           int sem_wait(sem_t *_sem_);
    


## DESCRIPTION



           The _sem_trywait_() function shall lock the semaphore referenced by
           _sem_ only if the semaphore is currently not locked; that is, if the
           semaphore value is currently positive. Otherwise, it shall not
           lock the semaphore.
    
           The _sem_wait_() function shall lock the semaphore referenced by _sem_
           by performing a semaphore lock operation on that semaphore. If the
           semaphore value is currently zero, then the calling thread shall
           not return from the call to _sem_wait_() until it either locks the
           semaphore or the call is interrupted by a signal.
    
           Upon successful return, the state of the semaphore shall be locked
           and shall remain locked until the _sem_post_() function is executed
           and returns successfully.
    
           The _sem_wait_() function is interruptible by the delivery of a
           signal.
    


## RETURN VALUE



           The _sem_trywait_() and _sem_wait_() functions shall return zero if
           the calling process successfully performed the semaphore lock
           operation on the semaphore designated by _sem_.  If the call was
           unsuccessful, the state of the semaphore shall be unchanged, and
           the function shall return a value of -1 and set _errno_ to indicate
           the error.
    


## ERRORS



           The _sem_trywait_() function shall fail if:
    
           **EAGAIN** The semaphore was already locked, so it cannot be
                  immediately locked by the _sem_trywait_() operation.
    
           The _sem_trywait_() and _sem_wait_() functions may fail if:
    
           **EDEADLK**
                  A deadlock condition was detected.
    
           **EINTR** A signal interrupted this function.
    
           **EINVAL** The _sem_ argument does not refer to a valid semaphore.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           Applications using these functions may be subject to priority
           inversion, as discussed in the Base Definitions volume of
           POSIX.1‐2017, _Section 3.291_ , _Priority Inversion_.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::guru-delay

## NAME



           tapset::guru-delay - systemtap guru-delay tapset
    


## DESCRIPTION



            Functions in the guru-delay tapset allow a probe handler to
           insert
            deliberate delays.  This is sometimes useful as a fault-injection
            aid.  Due to its likelihood of interference with the kernel, guru
            mode is required, and overload-prevention is suppressed.
    
           **mdelay** millisecond delay
    
                  See function::mdelay(3stap)
                   for details.
    
           **udelay** microsecond delay
    
                  See function::udelay(3stap)
                   for details.
    


* * *
# matchmediacon

## NAME



           matchmediacon - get the default SELinux security context for the
           specified mediatype from the policy
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int matchmediacon(const char ***_media_**, char ****_con_**);**
    


## DESCRIPTION



           **matchmediacon**() matches the specified media type with the media
           contexts configuration and sets the security context _con_ to refer
           to the resulting context.
    
           **Note:** Caller must free returned security context _con_ using
           freecon(3).
    


## RETURN VALUE



           Returns 0 on success or -1 otherwise.
    


## Files



           _/etc/selinux/{POLICYTYPE}/contexts/files/media_
    


* * *
# io_uring_prep_bind

## NAME



           io_uring_prep_bind - prepare a bind request
    


## SYNOPSIS



           **#include <sys/socket.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_bind(struct io_uring_sqe ***_sqe_**,**
                                     **int** _sockfd_**,**
                                     **struct sockaddr ***_addr_**,**
                                     **socklen_t** _addrlen_**);**
    


## DESCRIPTION



           The io_uring_prep_bind(3) function prepares a bind request. The
           submission queue entry _sqe_ is setup to assign the network address
           at _addr_ , of length _addrlen_ , to the socket descriptor _sockfd._
    
           This function prepares an async bind(2) request. See that man page
           for details.
    


## RETURN VALUE



           None
    


## ERRORS



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


* * *
# probe::nfsd.proc.create

## NAME



           probe::nfsd.proc.create - NFS server creating a file for client
    


## SYNOPSIS



           nfsd.proc.create
    


## VALUES



           _proto_
               transfer protocol
    
           _client_ip_
               the ip address of client
    
           _version_
               nfs version
    
           _gid_
               requester's group id
    
           _uid_
               requester's user id
    
           _filelen_
               length of file name
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _filename_
               file name
    


* * *
# io_uring_buf_ring_available

## NAME



           io_uring_buf_ring_available - return number of unconsumed provided
           ring buffer entries
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_buf_ring_available(struct io_uring ***_ring_**,**
                                           **struct io_uring_buf_ring ***_br_**,**
                                           **unsigned short** _bgid_**);**
    


## DESCRIPTION



           The io_uring_buf_ring_available(3) helper returns the number of
           unconsumed (by the kernel) entries in the _br_ provided buffer group
           belonging to the io_uring _ring_ and identified by the buffer group
           ID _bgid._
    
           Since the head of the provided buffer ring is only visible to the
           kernel, it's impossible to otherwise know how many unconsumed
           entries exist in the given provided buffer ring. This function
           query the kernel to return that number.  Available since kernel
           6.8.
    


## NOTES



           The returned number of entries reflect the amount of unconsumed
           entries at the time that it was queried. If inflight IO exists
           that may consume provided buffers from this buffer group, then the
           returned value is inherently racy.
    


## RETURN VALUE



           Returns the number of unconsumed entries on success, which may be
           0. In case of error, may return **-ENOENT** if the specified buffer
           group doesn't exist, or **-EINVAL** if the buffer group isn't of the
           correct type, or if the kernel doesn't support this feature.
    


* * *
# gnutls_privkey_import_tpm_url

## NAME



           gnutls_privkey_import_tpm_url - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_tpm_url(gnutls_privkey_t** _pkey_**, const**
           **char ***_url_**, const char ***_srk_password_**, const char ***_key_password_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           const char * url
                       The URL of the TPM key to be imported
    
           const char * srk_password
                       The password for the SRK key (optional)
    
           const char * key_password
                       A password for the key (optional)
    
           unsigned int flags
                       One of the GNUTLS_PRIVKEY_* flags
    


## DESCRIPTION



           This function will import the given private key to the abstract
           **gnutls_privkey_t** type.
    
           Note that unless **GNUTLS_PRIVKEY_DISABLE_CALLBACKS** is specified, if
           incorrect (or NULL) passwords are given the PKCS11 callback
           functions will be used to obtain the correct passwords. Otherwise
           if the SRK password is wrong **GNUTLS_E_TPM_SRK_PASSWORD_ERROR** is
           returned and if the key password is wrong or not provided then
           **GNUTLS_E_TPM_KEY_PASSWORD_ERROR** is returned.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# gnutls_pkcs7_deinit

## NAME



           gnutls_pkcs7_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **void gnutls_pkcs7_deinit(gnutls_pkcs7_t** _pkcs7_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       the type to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a PKCS7 type.
    


* * *
# io_uring_register_sync_msg

## NAME



           io_uring_register_sync_msg - send a synchronous message to another
           ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_sync_msg(struct io_uring_sqe ***_sqe_**);**
    


## DESCRIPTION



           io_uring_register_sync_msg(3) issues a synchronous MSG_RING
           request. The _sqe_ parameter must have been cleared and initialized
           with io_uring_prep_msg_ring(3).
    
           Normally message requests are sent from one ring to another ring.
           But there are also cases where a source ring is not available, yet
           it would be convenient to send a message to a destination ring.
           io_uring_register_sync_msg(3) exists for that purpose. A source
           ring is not required to send a message to another ring, instead
           the _sqe_ parameter can be placed on the stack and filled in using
           the normal message helpers, and then io_uring_register_sync_msg(3)
           can be called. Since a source ring does not exist, the results of
           the operation is returned directly rather than via a CQE. On the
           destination/receiving end, a CQE is posted, as it would have been
           with a non-sync request.
    
           Only data request are supported, sending files such as setup by
           io_uring_prep_msg_ring_fd(3) is not supported. The given SQE
           should be initialized by io_uring_prep_msg_ring(3) or
           io_uring_prep_msg_ring_cqe_flags(3), or any other helper that sets
           up a non-fd message request.
    
           The targeted ring may be any ring that the user has access to,
           even the ring itself. This request can be used for simple message
           passing to another ring, allowing 32+64 bits of data to be
           transferred through the _len_ and _data_ fields. The use case may be
           anything from simply waking up someone waiting on the targeted
           ring, or it can be used to pass messages between the two rings.
    
           io_uring_prep_msg_ring_cqe_flags(3) is similar to
           io_uring_prep_msg_ring(3).  But has an addition _cqe_flags_
           parameter, which is used to set _flags_ field on CQE side. That way,
           you can set the CQE flags field _cqe- >flags_ when sending a message.
           Be aware that io_uring could potentially set additional bits into
           this field.
    
           Available since kernel 6.13.
    


## RETURN VALUE



           Returns 0 on success, or **-errno** on error.
    


* * *
# ibv_post_srq_recv

## NAME



           ibv_post_srq_recv - post a list of work requests (WRs) to a shared
           receive queue (SRQ)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **int ibv_post_srq_recv(struct ibv_srq** _*srq_**, struct ibv_recv_wr** _*wr_**,**
                                 **struct ibv_recv_wr** _**bad_wr_**);**
    


## DESCRIPTION



           **ibv_post_srq_recv()** posts the linked list of work requests (WRs)
           starting with _wr_ to the shared receive queue (SRQ) _srq_.  It stops
           processing WRs from this list at the first failure (that can be
           detected immediately while requests are being posted), and returns
           this failing WR through _bad_wr_.
    
           The argument _wr_ is an ibv_recv_wr struct, as defined in
           <infiniband/verbs.h>.
    
           struct ibv_recv_wr {
                   uint64_t                wr_id;     /* User defined WR ID */
                   struct ibv_recv_wr     *next;      /* Pointer to next WR in list, NULL if last WR */
                   struct ibv_sge         *sg_list;   /* Pointer to the s/g array */
                   int                     num_sge;   /* Size of the s/g array */
           };
    
           struct ibv_sge {
                   uint64_t                addr;      /* Start address of the local memory buffer */
                   uint32_t                length;    /* Length of the buffer */
                   uint32_t                lkey;      /* Key of the local Memory Region */
           };
    


## RETURN VALUE



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


## NOTES



           The buffers used by a WR can only be safely reused after WR the
           request is fully executed and a work completion has been retrieved
           from the corresponding completion queue (CQ).
    
           If a WR is being posted to a UD QP, the Global Routing Header
           (GRH) of the incoming message will be placed in the first 40 bytes
           of the buffer(s) in the scatter list.  If no GRH is present in the
           incoming message, then the first bytes will be undefined.  This
           means that in all cases, the actual data of the incoming message
           will start at an offset of 40 bytes into the buffer(s) in the
           scatter list.
    


* * *
# gnutls_pkcs12_generate_mac

## NAME



           gnutls_pkcs12_generate_mac - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_generate_mac(gnutls_pkcs12_t** _pkcs12_**, const char**
           *****_pass_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           const char * pass
                       The password for the MAC
    


## DESCRIPTION



           This function will generate a MAC for the PKCS12 structure.
    


## RETURNS



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


* * *
# gnutls_sign_is_secure2

## NAME



           gnutls_sign_is_secure2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_sign_is_secure2(gnutls_sign_algorithm_t** _algorithm_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t algorithm
                       is a sign algorithm
    
           unsigned int flags
                       zero or **GNUTLS_SIGN_FLAG_SECURE_FOR_CERTS**
    


## RETURNS



           Non-zero if the provided signature algorithm is considered to be
           secure.
    


* * *
# audit_set_failure

## NAME



           audit_set_failure - Set audit failure flag
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_failure(int** _fd,_**uint32_t"**_failure);"_
    


## DESCRIPTION



           audit_set_failure sets the action that the kernel will perform
           when the backlog limit is reached or when it encounters an error
           and cannot proceed. Possible values are:
    
           0 - AUDIT_FAIL_SILENT
                  Do nothing, report nothing, skip logging the record and
                  continue.
    
           1 - AUDIT_FAIL_PRINTK [default]
                  Log the audit record using printk which will cause
                  subsequent events to get written to syslog.
    
           2 - AUDIT_FAIL_PANIC
                  Call the panic function. This would be used to prevent use
                  of the machine upon loss of audit events.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# acosl

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



           acosl — arc cosine functions
    


## SYNOPSIS



           #include <math.h>
    
           long double acosl(long double _x_);
    


## DESCRIPTION



           Refer to acos(3p).
    


* * *
# probe::nfsd.close

## NAME



           probe::nfsd.close - NFS server closing a file for client
    


## SYNOPSIS



           nfsd.close
    


## VALUES



           _filename_
               file name
    


## DESCRIPTION



           This probe point does not exist in kernels starting with 4.2.
    


* * *
# gnutls_certificate_type_list

## NAME



           gnutls_certificate_type_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_certificate_type_t * gnutls_certificate_type_list(**
           _void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of certificate types.
    


## RETURNS



           a (0)-terminated list of **gnutls_certificate_type_t** integers
           indicating the available certificate types.
    


* * *
# gnutls_priority_mac_list

## NAME



           gnutls_priority_mac_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_mac_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 MAC algorithms in the priority structure.
    


## RETURNS



           the number of items, or an error code.
    


## SINCE



           3.2.3
    


* * *
# gnutls_x509_privkey_import_dh_raw

## NAME



           gnutls_x509_privkey_import_dh_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_import_dh_raw(gnutls_x509_privkey_t** _key_**,**
           **const gnutls_dh_params_t** _params_**, const gnutls_datum_t ***_y_**, const**
           **gnutls_datum_t ***_x_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       The data to store the parsed key
    
           const gnutls_dh_params_t params
                       holds the **gnutls_dh_params_t**
    
           const gnutls_datum_t * y
                       holds the y (optional)
    
           const gnutls_datum_t * x
                       holds the x
    


## DESCRIPTION



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


## RETURNS



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


* * *
# gnutls_cipher_encrypt2

## NAME



           gnutls_cipher_encrypt2 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_cipher_encrypt2(gnutls_cipher_hd_t** _handle_**, const void ***
           _ptext_**, size_t** _ptext_len_**, void ***_ctext_**, size_t** _ctext_len_**);**
    


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           const void * ptext
                       the data to encrypt
    
           size_t ptext_len
                       the length of data to encrypt
    
           void * ctext
                       the encrypted data
    
           size_t ctext_len
                       the available length for encrypted data
    


## DESCRIPTION



           This function will encrypt the given data using the algorithm
           specified by the context. For block ciphers the  _ptext_len_ must be
           a multiple of the block size. For the supported ciphers the
           encrypted data length will equal the plaintext size.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# sd-hwdb

## NAME



           sd-hwdb - Read-only access to the hardware description database
    


## SYNOPSIS



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


## DESCRIPTION



           sd-hwdb.h is part of libsystemd(3) and allows read-only access the
           systemd database of hardware properties. See hwdb(7) and
           systemd-hwdb(8) for more information about the database.
    
           See sd_hwdb_new(3) and sd_hwdb_get(3) for information about the
           functions available.
    


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


* * *
# io_uring_sqe_set_data64

## NAME



           io_uring_sqe_set_data - set user data for submission queue event
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_sqe_set_data(struct io_uring_sqe ***_sqe_**,**
                                      **void ***_user_data_**);**
    
           **void io_uring_sqe_set_data64(struct io_uring_sqe ***_sqe_**,**
                                        **__u64** _data_**);**
    


## DESCRIPTION



           The io_uring_sqe_set_data(3) function stores a _user_data_ pointer
           with the submission queue entry _sqe_.
    
           The io_uring_sqe_set_data64(3) function stores a 64-bit _data_ value
           with the submission queue entry _sqe_.
    
           After the caller has requested a submission queue entry (SQE) with
           io_uring_get_sqe(3), they can associate a data pointer or value
           with the SQE. Once the completion arrives, the function
           io_uring_cqe_get_data(3) or io_uring_cqe_get_data64(3) can be
           called to retrieve the data pointer or value associated with the
           submitted request.
    
           Note that if neither of these functions are called, or the
           _user_data_ field in the _sqe_ isn't set manually either, then the
           field may contain a value from a previous use of this sqe. If an
           application relies on always having a valid _user_data_ value
           present, it must always assign one to each sqe.
    


## RETURN VALUE



           None
    


* * *
# acl_set_fd

## NAME



           **acl_set_fd** — set an ACL by file descriptor
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_set_fd**(_int fd_ , _acl_t acl_)
    


## DESCRIPTION



           The **acl_set_fd**() function associates an access ACL with the file
           referred to by _fd_.
    
           The effective user ID of the process must match the owner of the
           file or the process must have the CAP_FOWNER capability for the
           request to succeed.
    


## RETURN VALUE



           The **acl_set_fd**() function returns the value 0 if successful;
           otherwise the value -1 is returned and the global variable _errno_
           is set to indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_set_fd**()
           function returns the value **-1** and and sets _errno_ to the
           corresponding value:
    
           [EBADF]            The _fd_ argument is not a valid file descriptor.
    
           [EINVAL]           The argument _acl_ does not point to a valid ACL.
    
                              The ACL has more entries than the file referred
                              to by _fd_ can obtain.
    
           [ENOSPC]           The directory or file system that would contain
                              the new ACL cannot be extended or the file
                              system is out of file allocation resources.
    
           [ENOTSUP]          The file identified by _fd_ cannot be associated
                              with the ACL because the file system on which
                              the file is located does not support this.
    
           [EPERM]            The process does not have appropriate privilege
                              to perform the operation to set the ACL.
    
           [EROFS]            This function requires modification of a file
                              system which is currently read-only.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# wcsrchr

## NAME



           wcsrchr - search a wide character in a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcsrchr(const wchar_t ***_wcs_**, wchar_t** _wc_**);**
    


## DESCRIPTION



           The **wcsrchr**() function is the wide-character equivalent of the
           strrchr(3) function.  It searches the last occurrence of _wc_ in the
           wide-character string pointed to by _wcs_.
    


## RETURN VALUE



           The **wcsrchr**() function returns a pointer to the last occurrence of
           _wc_ in the wide-character string pointed to by _wcs_ , or NULL if _wc_
           does not occur in the string.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# libpfm_intel_icx_unc_irp

## NAME



           libpfm_intel_icx_unc_irp - support for Intel IcelakeX Server IRP
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_irp[0-5]**
           **PMU desc: Intel IcelakeX IRP uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX IRP (IIO Ring Port) uncore
           PMU. There is one IRP per IIO.  Each IRP PMU implements 4 generic
           counters.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX IRP uncore
           PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IRP clockticks in which the
                  number of occurrences of the event is greater or equal to
                  the threshold.  This is an integer modifier with values in
                  the range [0:255].
    
           **i** Invert the threshold (t) test from strictly greater than to
                  less or equal to. This is a boolean modifier.
    


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


* * *
# posix_spawnattr_getschedparam

## PROLOG



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


## NAME



           posix_spawnattr_getschedparam, posix_spawnattr_setschedparam — get
           and set the spawn-schedparam attribute of a spawn attributes
           object (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
           #include <sched.h>
    
           int posix_spawnattr_getschedparam(const posix_spawnattr_t
               *restrict _attr_ , struct sched_param *restrict _schedparam_);
           int posix_spawnattr_setschedparam(posix_spawnattr_t *restrict _attr_ ,
               const struct sched_param *restrict _schedparam_);
    


## DESCRIPTION



           The _posix_spawnattr_getschedparam_() function shall obtain the
           value of the _spawn-schedparam_ attribute from the attributes object
           referenced by _attr_.
    
           The _posix_spawnattr_setschedparam_() function shall set the _spawn-_
           _schedparam_ attribute in an initialized attributes object
           referenced by _attr_.
    
           The _spawn-schedparam_ attribute represents the scheduling
           parameters to be assigned to the new process image in a spawn
           operation (if POSIX_SPAWN_SETSCHEDULER or
           POSIX_SPAWN_SETSCHEDPARAM is set in the _spawn-flags_ attribute).
           The default value of this attribute is unspecified.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getschedparam_() shall
           return zero and store the value of the _spawn-schedparam_ attribute
           of _attr_ into the object referenced by the _schedparam_ parameter;
           otherwise, an error number shall be returned to indicate the
           error.
    
           Upon successful completion, _posix_spawnattr_setschedparam_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setschedparam_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn and Process Scheduling
           options and need not be provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_tlsfeatures_get

## NAME



           gnutls_x509_tlsfeatures_get - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_tlsfeatures_get(gnutls_x509_tlsfeatures_t** _f_**,**
           **unsigned** _idx_**, unsigned int ***_feature_**);**
    


## ARGUMENTS



           gnutls_x509_tlsfeatures_t f
                       The TLS features
    
           unsigned idx
                       The index of the feature to get
    
           unsigned int * feature
                       If the function succeeds, the feature will be stored
                       in this variable
    


## DESCRIPTION



           This function will get a feature from the X.509 TLS features
           extension structure.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *