tripathysagar/man_text huggingface dataset:
# keyctl_invalidate

## NAME



           keyctl_invalidate - invalidate a key
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_invalidate(key_serial_t** _key_**);**
    


## DESCRIPTION



           **keyctl_invalidate**() invalidates a _key_.  The key is scheduled for
           immediate removal from all the keyrings that point to it, after
           which it will be deleted.  The key will be ignored by all searches
           once this function is called even if it is not yet fully dealt
           with.
    
           The caller must have **search** permission on a key to be able to
           invalidate it.
    


## RETURN VALUE



           On success **keyctl_invalidate**() returns **0**.  On error, the value **-1**
           will be returned and _errno_ will have been set to an appropriate
           error.
    


## ERRORS



           **ENOKEY** The key specified is invalid.
    
           **EKEYEXPIRED**
                  The key specified has expired.
    
           **EKEYREVOKED**
                  The key specified had been revoked.
    
           **EACCES** The key exists, but is not **searchable** by the calling
                  process.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# audit_close

## NAME



           audit_close - Close the audit netlink socket connection
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **void audit_close(int** _fd_**);**
    


## DESCRIPTION



           **audit_close**() closes the NETLINK_AUDIT socket that communicates
           with the kernel part of the Linux Audit Subsystem.  _fd_ must have
           been returned by audit_open(3).
    


## RETURN VALUE



           None.
    


* * *
# wcstombs

## NAME



           wcstombs - convert a wide-character string to a multibyte string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **size_t wcstombs(** size_t n;
                           **char** _dest_**[restrict** _n_**], const wchar_t *restrict** _src_**,**
                           **size_t** _n_**);**
    


## DESCRIPTION



           If _dest_ is not NULL, the **wcstombs**() function converts the wide-
           character string _src_ to a multibyte string starting at _dest_.  At
           most _n_ bytes are written to _dest_.  The sequence of characters
           placed in _dest_ begins in the initial shift state.  The conversion
           can stop for three reasons:
    
           •  A wide character has been encountered that can not be
              represented as a multibyte sequence (according to the current
              locale).  In this case, _(size_t) -1_ is returned.
    
           •  The length limit forces a stop.  In this case, the number of
              bytes written to _dest_ is returned, but the shift state at this
              point is lost.
    
           •  The wide-character string has been completely converted,
              including the terminating null wide character (L'\0').  In this
              case, the conversion ends in the initial shift state.  The
              number of bytes written to _dest_ , excluding the terminating null
              byte ('\0'), is returned.
    
           The programmer must ensure that there is room for at least _n_ bytes
           at _dest_.
    
           If _dest_ is NULL, _n_ is ignored, and the conversion proceeds as
           above, except that the converted bytes are not written out to
           memory, and no length limit exists.
    
           In order to avoid the case 2 above, the programmer should make
           sure _n_ is greater than or equal to _wcstombs(NULL,src,0)+1_.
    


## RETURN VALUE



           The **wcstombs**() function returns the number of bytes that make up
           the converted part of a multibyte sequence, not including the
           terminating null byte.  If a wide character was encountered which
           could not be converted, _(size_t) -1_ is returned.
    


## ATTRIBUTES



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


## VERSIONS



           The function wcsrtombs(3) provides a better interface to the same
           functionality.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **wcstombs**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# wcpncpy

## NAME



           wcpncpy - copy a fixed-size string of wide characters, returning a
           pointer to its end
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcpncpy(** size_t n;
                            **wchar_t** _dest_**[restrict** _n_**],**
                            **const wchar_t *restrict** _src_**,**
                            **size_t** _n_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **wcpncpy**():
               Since glibc 2.10:
                   _POSIX_C_SOURCE >= 200809L
               Before glibc 2.10:
                   _GNU_SOURCE
    


## DESCRIPTION



           The **wcpncpy**() function is the wide-character equivalent of the
           stpncpy(3) function.  It copies at most _n_ wide characters from the
           wide-character string pointed to by _src_ , including the terminating
           null wide (L'\0'), to the array pointed to by _dest_.  Exactly _n_
           wide characters are written at _dest_.  If the length _wcslen(src)_ is
           smaller than _n_ , the remaining wide characters in the array pointed
           to by _dest_ are filled with L'\0' characters.  If the length
           _wcslen(src)_ is greater than or equal to _n_ , the string pointed to
           by _dest_ will not be L'\0' terminated.
    
           The strings may not overlap.
    
           The programmer must ensure that there is room for at least _n_ wide
           characters at _dest_.
    


## RETURN VALUE



           **wcpncpy**() returns a pointer to one past the last non-null wide
           character written, that is, _dest + wcsnlen(src, n)_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# posix_trace_attr_getname

## PROLOG



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


## NAME



           posix_trace_attr_getname — retrieve and set information about a
           trace stream (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_attr_getname(const trace_attr_t *_attr_ ,
               char *_tracename_);
    


## DESCRIPTION



           Refer to posix_trace_attr_getclockres(3p).
    


* * *
# gnutls_pkcs7_get_crl_raw2

## NAME



           gnutls_pkcs7_get_crl_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_crl_raw2(gnutls_pkcs7_t** _pkcs7_**, unsigned** _indx_**,**
           **gnutls_datum_t ***_crl_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           unsigned indx
                       contains the index of the crl to extract
    
           gnutls_datum_t * crl
                       will contain the contents of the CRL in an allocated
                       buffer
    


## DESCRIPTION



           This function will return a DER encoded CRL of the PKCS7 or
           RFC2630 crl set.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value.  After the last crl has been read
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.4.2
    


* * *
# gnutls_x509_crt_get_extension_by_oid

## NAME



           gnutls_x509_crt_get_extension_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_extension_by_oid(gnutls_x509_crt_t** _cert_**,**
           **const char ***_oid_**, unsigned** _indx_**, void ***_buf_**, size_t ***_buf_size_**,**
           **unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const char * oid
                       holds an Object Identified in null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the extensions,
                       this specifies which to send. Use (0) to get the first
                       one.
    
           void * buf  a pointer to a structure to hold the name (may be
                       null)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return the extension specified by the OID in
           the certificate.  The extensions will be returned as binary data
           DER encoded, in the provided buffer.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned. If the certificate does not contain the
           specified extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be
           returned.
    


* * *
# gnutls_x509_crt_set_proxy_dn

## NAME



           gnutls_x509_crt_set_proxy_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_proxy_dn(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_crt_t** _eecrt_**, unsigned int** _raw_flag_**, const void ***_name_**,**
           **unsigned int** _sizeof_name_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a gnutls_x509_crt_t type with the new proxy cert
    
           gnutls_x509_crt_t eecrt
                       the end entity certificate that will be issuing the
                       proxy
    
           unsigned int raw_flag
                       must be 0, or 1 if the CN is DER encoded
    
           const void * name
                       a pointer to the CN name, may be NULL (but MUST then
                       be added later)
    
           unsigned int sizeof_name
                       holds the size of  _name_
    


## DESCRIPTION



           This function will set the subject in  _crt_ to the end entity's
            _eecrt_ subject name, and add a single Common Name component  _name_
           of size  _sizeof_name_ .  This corresponds to the required proxy
           certificate naming style.  Note that if  _name_ is **NULL** , you MUST
           set it later by using **gnutls_x509_crt_set_dn_by_oid()** or similar.
    


## RETURNS



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


* * *
# gnutls_privkey_get_seed

## NAME



           gnutls_privkey_get_seed - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_get_seed(gnutls_privkey_t** _key_**,**
           **gnutls_digest_algorithm_t ***_digest_**, void ***_seed_**, size_t ***
           _seed_size_**);**
    


## ARGUMENTS



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


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# form_page

## NAME



           **form_page** - set and get form page number
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_current_field(FORM ***_form_**, FIELD ***_field_**);**
           **FIELD *current_field(const FORM ***_form_**);**
    
           **int unfocus_current_field(FORM ***_form_**);**
    
           **int set_form_page(FORM ***_form_**, int** _n_**);**
           **int form_page(const FORM ***_form_**);**
    
           **int field_index(const FIELD ***_field_**);**
    


## DESCRIPTION



           The function **set_current_field** sets the current field of the given
           form; **current_field** returns the current field of the given form.
    
           The function **unfocus_current_field** removes the focus from the
           current field of the form.  In such state, inquiries via
           **current_field** shall return a NULL pointer.
    
           The function **set_form_page** sets the form's page number (goes to
           page _n_ of the form).
    
           The function **form_page** returns the form's current page number.
    
           The function **field_index** returns the index of the field in the
           field array of the form it is connected to.  It returns **ERR** if the
           argument is the null pointer or the field is not connected.
    


## RETURN VALUE



           Except for **form_page** , each routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_BAD_STATE**
                Routine was called from an initialization or termination
                function.
    
           **E_INVALID_FIELD**
                Contents of a field are not valid.
    
           **E_REQUEST_DENIED**
                The form driver could not process the request.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V forms library.  They were not
           supported on Version 7 or BSD versions.
    
           The **unfocus_current_field** function is an ncurses extension.
    


* * *
# gnutls_privkey_import_gost_raw

## NAME



           gnutls_privkey_import_gost_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_gost_raw(gnutls_privkey_t** _key_**,**
           **gnutls_ecc_curve_t** _curve_**, gnutls_digest_algorithm_t** _digest_**,**
           **gnutls_gost_paramset_t** _paramset_**, const gnutls_datum_t ***_x_**, const**
           **gnutls_datum_t ***_y_**, const gnutls_datum_t ***_k_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       The key
    
           gnutls_ecc_curve_t curve
                       holds the curve
    
           gnutls_digest_algorithm_t digest
                       holds the digest
    
           gnutls_gost_paramset_t paramset
                       holds the GOST parameter set ID
    
           const gnutls_datum_t * x
                       holds the x-coordinate
    
           const gnutls_datum_t * y
                       holds the y-coordinate
    
           const gnutls_datum_t * k
                       holds the k (private key)
    


## DESCRIPTION



           This function will convert the given GOST private key's parameters
           to the native **gnutls_privkey_t** format.  The output will be stored
           in  _key_ .   _digest_ should be one of GNUTLS_DIG_GOSR_94,
           GNUTLS_DIG_STREEBOG_256 or GNUTLS_DIG_STREEBOG_512.  If  _paramset_
           is set to GNUTLS_GOST_PARAMSET_UNKNOWN default one will be
           selected depending on
            _digest_ .
    


## NOTE



           parameters should be stored with least significant byte first. On
           version 3.6.3 big-endian format was used incorrectly.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# posix_spawnattr_setflags

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


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawnattr_setflags(posix_spawnattr_t *_attr_ , short _flags_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getflags(3p).
    


* * *
# umad_set_addr_net

## NAME



           umad_set_addr_net - set MAD address fields within umad buffer
           using network ordering
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_set_addr_net(void** _*umad_**, __be16** _dlid_**, __be32** _dqp_**, int** _sl_**, __be32** _qkey_**);**
    


## DESCRIPTION



           **umad_set_addr_net()** sets the MAD address fields within the
           specified _umad_ buffer using the provided network ordered fields.
           _dlid_ is the destination LID.  _dqp_ is the destination QP (queue
           pair).  _sl_ is the SL (service level).  _qkey_ is the Q_Key (queue
           key).
    


## RETURN VALUE



           **umad_set_addr_net()** returns 0 on success, and a negative value on
           errors. Currently, there are no errors indicated.
    


* * *
# gnutls_x509_trust_list_set_ptr

## NAME



           gnutls_x509_trust_list_set_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_trust_list_set_ptr(gnutls_x509_trust_list_t**
           _tlist_**, void ***_ptr_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t tlist
                       is a **gnutls_x509_trust_list_t** type.
    
           void * ptr  is the user pointer
    


## DESCRIPTION



           This function will set (associate) the user given pointer  _ptr_ to
           the tlist structure. This pointer can be accessed with
           **gnutls_x509_trust_list_get_ptr()**. Useful in the callback function
           gnutls_x509_trust_list_set_getissuer_function.
    


## SINCE



           3.7.0
    


* * *
# function::kernel_string

## NAME



           function::kernel_string - Retrieves string from kernel memory
    


## SYNOPSIS



           1) kernel_string:string(addr:long)
    
           2) kernel_string:string(addr:long,err_msg:string)
    


## ARGUMENTS



           _addr_
               The kernel address to retrieve the string from
    
           _err_msg_
               The error message to return when data isn't available
    


## DESCRIPTION



           1) This function returns the null terminated C string from a given
           kernel memory address. Reports an error on string copy fault.
    
           2) This function returns the null terminated C string from a given
           kernel memory address. Reports the given error message on string
           copy fault.
    


* * *
# sepol_check_context

## NAME



           sepol_check_context - Check the validity of a security context
           against a binary policy.
    


## SYNOPSIS



           **#include <sepol/sepol.h>**
    
           **int sepol_check_context(const char ***_context_**);**
    
           **int sepol_set_policydb_from_file(FILE ***_fp_**);**
    


## DESCRIPTION



           **sepol_check_context** checks the validity of a security context
           against a binary policy previously loaded from a file via
           **sepol_set_policydb_from_file.** It is used by **setfiles -c** to
           validate a file contexts configuration against the binary policy
           upon policy builds.  For validating a context against the active
           policy on a SELinux system, use **security_check_context** from
           libselinux instead.
    


## RETURN VALUE



           Returns 0 on success or -1 with errno set otherwise.
    


* * *
# function::addr_to_node

## NAME



           function::addr_to_node - Returns which node a given address
           belongs to within a NUMA system
    


## SYNOPSIS



               addr_to_node:long(addr:long)
    


## ARGUMENTS



           _addr_
               the address of the faulting memory access
    


## DESCRIPTION



           This function accepts an address, and returns the node that the
           given address belongs to in a NUMA system.
    


* * *
# function::stp_pid

## NAME



           function::stp_pid - The process id of the stapio process
    


## SYNOPSIS



               stp_pid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the process id of the stapio process that
           launched this script. There could be other SystemTap scripts and
           stapio processes running on the system.
    


* * *
# gnutls_pubkey_export_ecc_raw

## NAME



           gnutls_pubkey_export_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_ecc_raw(gnutls_pubkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_datum_t ***_x_**, gnutls_datum_t ***
           _y_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve (may be **NULL**)
    
           gnutls_datum_t * x
                       will hold x-coordinate (may be **NULL**)
    
           gnutls_datum_t * y
                       will hold y-coordinate (may be **NULL**)
    


## DESCRIPTION



           This function will export the ECC public key's parameters found in
           the given key.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be in the native format for the curve.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# __setfpucw

## NAME



           __setfpucw - set FPU control word on i386 architecture (obsolete)
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <i386/fpu_control.h>**
    
           **[[deprecated]] void __setfpucw(unsigned short** _control_word_**);**
    


## DESCRIPTION



           **__setfpucw**() transfers _control_word_ to the registers of the FPU
           (floating-point unit) on the i386 architecture.  This was used to
           control floating-point precision, rounding and floating-point
           exceptions.
    


## STANDARDS



           GNU.
    


## NOTES



           There are new functions from C99, with prototypes in _< fenv.h>_, to
           control FPU rounding modes, like fegetround(3), fesetround(3), and
           the floating-point environment, like fegetenv(3), feholdexcept(3),
           fesetenv(3), feupdateenv(3), and FPU exception handling, like
           feclearexcept(3), fegetexceptflag(3), feraiseexcept(3),
           fesetexceptflag(3), and fetestexcept(3).
    
           If direct access to the FPU control word is still needed, the
           **_FPU_GETCW** and **_FPU_SETCW** macros from _< fpu_control.h>_ can be used.
    


## EXAMPLES



           **__setfpucw(0x1372)**
    
           Set FPU control word on the i386 architecture to
                  •  extended precision
                  •  rounding to nearest
                  •  exceptions on overflow, zero divide and NaN
    


* * *
# probe::vm.kmem_cache_alloc_node

## NAME



           probe::vm.kmem_cache_alloc_node - Fires when kmem_cache_alloc_node
           is requested
    


## SYNOPSIS



           vm.kmem_cache_alloc_node
    


## VALUES



           _ptr_
               pointer to the kmemory allocated
    
           _gfp_flags_
               type of kmemory to allocate
    
           _bytes_req_
               requested Bytes
    
           _name_
               name of the probe point
    
           _bytes_alloc_
               allocated Bytes
    
           _caller_function_
               name of the caller function
    
           _call_site_
               address of the function calling this kmemory function
    
           _gfp_flag_name_
               type of kmemory to allocate(in string format)
    


* * *
# btowc

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



           btowc — single byte to wide character conversion
    


## SYNOPSIS



           #include <stdio.h>
           #include <wchar.h>
    
           wint_t btowc(int _c_);
    


## 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 _btowc_() function shall determine whether _c_ constitutes a valid
           (one-byte) character in the initial shift state.
    
           The behavior of this function shall be affected by the _LC_CTYPE_
           category of the current locale.
    


## RETURN VALUE



           The _btowc_() function shall return WEOF if _c_ has the value EOF or
           if **(unsigned char)**_c_ does not constitute a valid (one-byte)
           character in the initial shift state. Otherwise, it shall return
           the wide-character representation of that character.
    
           In the POSIX locale, _btowc_() shall not return WEOF if _c_ has a
           value in the range 0 to 255 inclusive.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::scheduler.kthread_stop.return

## NAME



           probe::scheduler.kthread_stop.return - A kthread is stopped and
           gets the return value
    


## SYNOPSIS



           scheduler.kthread_stop.return
    


## VALUES



           _name_
               name of the probe point
    
           _return_value_
               return value after stopping the thread
    


* * *
# audit_reset_backlog_wait_time_actual

## NAME



           audit_reset_backlog_wait_time_actual - reset backlog wait time
           actual counter
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_reset_backlog_wait_time_actual(int** _fd_**);**
    


## DESCRIPTION



           **audit_reset_backlog_wait_time_actual**() resets the kernel's running
           total of how long system calls have waited for space in the audit
           event queue.  The _fd_ must be an open audit netlink socket.  This
           call is useful when administrators enable backlog waiting via the
           audit_set_backlog_wait_time(3) option to preserve events in tight
           memory situations.  Periodically clearing the counter allows
           detection of renewed backlog waiting after changing the queue size
           or wait time.  The kernel must support the
           **AUDIT_STATUS_BACKLOG_WAIT_TIME_ACTUAL** field for this call to
           succeed.
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number.
    


* * *
# libpfm_intel_spr_unc_upi

## NAME



           libpfm_intel_spr_unc_upi - support for Intel SapphireRapids Server
           UPI uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: spr_unc_upi[0-3]**
           **PMU desc: Intel SapphireRapids UPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel SapphireRapids UPI (Ultra Path
           Interconnect) uncore PMU.  Each UPI PMU implements 4 generic
           counters.
    


## MODIFIERS



           The following modifiers are supported on Intel SapphireRapids UPI
           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.
    


* * *
# gnutls_srp_verifier

## NAME



           gnutls_srp_verifier - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_srp_verifier(const char ***_username_**, const char ***
           _password_**, const gnutls_datum_t ***_salt_**, const gnutls_datum_t ***
           _generator_**, const gnutls_datum_t ***_prime_**, gnutls_datum_t ***_res_**);**
    


## ARGUMENTS



           const char * username
                       is the user's name
    
           const char * password
                       is the user's password
    
           const gnutls_datum_t * salt
                       should be some randomly generated bytes
    
           const gnutls_datum_t * generator
                       is the generator of the group
    
           const gnutls_datum_t * prime
                       is the group's prime
    
           gnutls_datum_t * res
                       where the verifier will be stored.
    


## DESCRIPTION



           This function will create an SRP verifier, as specified in
           RFC2945.  The  _prime_ and  _generator_ should be one of the static
           parameters defined in gnutls/gnutls.h or may be generated.
    
           The verifier will be allocated with @**gnutls_malloc()** and will be
           stored in
            _res_ using binary format.
    


## RETURNS



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


* * *
# srandom

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



           srandom — seed pseudo-random number generator
    


## SYNOPSIS



           #include <stdlib.h>
    
           void srandom(unsigned _seed_);
    


## DESCRIPTION



           Refer to initstate(3p).
    


* * *
# probe::kprocess.exec_complete

## NAME



           probe::kprocess.exec_complete - Return from exec to a new program
    


## SYNOPSIS



           kprocess.exec_complete
    


## VALUES



           _name_
               Name of the system call (“execve”) (SystemTap v2.5+)
    
           _success_
               A boolean indicating whether the exec was successful
    
           _errno_
               The error number resulting from the exec
    
           _retstr_
               A string representation of errno (SystemTap v2.5+)
    


## CONTEXT



           On success, the context of the new executable. On failure, remains
           in the context of the caller.
    


## DESCRIPTION



           Fires at the completion of an exec call. Aliased to the
           syscall.execve.return probe in SystemTap v2.5+.
    


* * *
# getpgid

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



           getpgid — get the process group ID for a process
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t getpgid(pid_t _pid_);
    


## DESCRIPTION



           The _getpgid_() function shall return the process group ID of the
           process whose process ID is equal to _pid_.  If _pid_ is equal to 0,
           _getpgid_() shall return the process group ID of the calling
           process.
    


## RETURN VALUE



           Upon successful completion, _getpgid_() shall return a process group
           ID. Otherwise, it shall return (**pid_t**)-1 and set _errno_ to indicate
           the error.
    


## ERRORS



           The _getpgid_() function shall fail if:
    
           **EPERM** The process whose process ID is equal to _pid_ is not in the
                  same session as the calling process, and the implementation
                  does not allow access to the process group ID of that
                  process from the calling process.
    
           **ESRCH** There is no process with a process ID equal to _pid_.
    
           The _getpgid_() function may fail if:
    
           **EINVAL** The value of the _pid_ argument is invalid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_pkcs11_obj_flags_get_str

## NAME



           gnutls_pkcs11_obj_flags_get_str - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **char * gnutls_pkcs11_obj_flags_get_str(unsigned int** _flags_**);**
    


## ARGUMENTS



           unsigned int flags
                       holds the flags
    


## DESCRIPTION



           This function given an or-sequence of **GNUTLS_PKCS11_OBJ_FLAG_MARK** ,
           will return an allocated string with its description. The string
           needs to be deallocated using **gnutls_free()**.
    


## RETURNS



           If flags is zero **NULL** is returned, otherwise an allocated string.
    


## SINCE



           3.3.7
    


* * *
# io_uring_opcode_supported

## NAME



           io_uring_opcode_supported - is op code supported?
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_opcode_supported(struct io_uring_probe ***_probe_**,**
                                         **int** _opcode_**);**
    


## DESCRIPTION



           The function io_uring_opcode_supported(3) allows the caller to
           determine if the passed in _opcode_ belonging to the _probe_ param is
           supported. An instance of the io_uring_probe instance can be
           obtained by calling the function io_uring_get_probe(3).
    


## RETURN VALUE



           On success it returns 1, otherwise it returns 0.
    


* * *
# gnutls_pubkey_export_ecc_raw2

## NAME



           gnutls_pubkey_export_ecc_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export_ecc_raw2(gnutls_pubkey_t** _key_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_datum_t ***_x_**, gnutls_datum_t ***
           _y_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           gnutls_ecc_curve_t * curve
                       will hold the curve (may be **NULL**)
    
           gnutls_datum_t * x
                       will hold x-coordinate (may be **NULL**)
    
           gnutls_datum_t * y
                       will hold y-coordinate (may be **NULL**)
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the ECC public key's parameters found in
           the given key.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be in the native format for the curve.
    
           This function allows for **NULL** parameters since 3.4.1.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# ldiv

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



           ldiv, lldiv — compute quotient and remainder of a long division
    


## SYNOPSIS



           #include <stdlib.h>
    
           ldiv_t ldiv(long _numer_ , long _denom_);
           lldiv_t lldiv(long long _numer_ , long long _denom_);
    


## 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.
    
           These functions shall compute the quotient and remainder of the
           division of the numerator _numer_ by the denominator _denom_.  If the
           division is inexact, the resulting quotient is the **long** integer
           (for the _ldiv_() function) or **long long** integer (for the _lldiv_()
           function) of lesser magnitude that is the nearest to the algebraic
           quotient. If the result cannot be represented, the behavior is
           undefined; otherwise, _quot_ * _denom_ +_rem_ shall equal _numer_.
    


## RETURN VALUE



           The _ldiv_() function shall return a structure of type **ldiv_t** ,
           comprising both the quotient and the remainder. The structure
           shall include the following members, in any order:
    
               long   quot;    /* Quotient */
               long   rem;     /* Remainder */
    
           The _lldiv_() function shall return a structure of type **lldiv_t** ,
           comprising both the quotient and the remainder. The structure
           shall include the following members, in any order:
    
               long long   quot;    /* Quotient */
               long long   rem;     /* Remainder */
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_import_url

## NAME



           gnutls_x509_crt_import_url - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_import_url(gnutls_x509_crt_t** _crt_**, const char ***
           _url_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       A certificate of type **gnutls_x509_crt_t**
    
           const char * url
                       A PKCS 11 url
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags for PKCS**11** URLs or
                       zero otherwise
    


## DESCRIPTION



           This function will import a certificate present in a PKCS**11** token
           or any type of back-end that supports URLs.
    
           In previous versions of gnutls this function was named
           gnutls_x509_crt_import_pkcs11_url, and the old name is an alias to
           this one.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# gnutls_x509_privkey_verify_params

## NAME



           gnutls_x509_privkey_verify_params - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_verify_params(gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    


## DESCRIPTION



           This function will verify the private key parameters.
    


## RETURNS



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


* * *
# io_uring_prep_msg_ring

## NAME



           io_uring_prep_msg_ring - send a message to another ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_msg_ring(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **unsigned int** _len_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**);**
    
           **void io_uring_prep_msg_ring_cqe_flags(struct io_uring_sqe ***_sqe_**,**
                                   **int** _fd_**,**
                                   **unsigned int** _len_**,**
                                   **__u64** _data_**,**
                                   **unsigned int** _flags_**,**
                                   **unsigned int** _cqe_flags_**);**
    


## DESCRIPTION



           io_uring_prep_msg_ring(3) prepares to send a CQE to an io_uring
           file descriptor. The submission queue entry _sqe_ is setup to use
           the file descriptor _fd_ , which must identify a io_uring context, to
           post a CQE on that ring where the target CQE **res** field will
           contain the content of _len_ and the **user_data** of _data_ with the
           request modifier flags set by _flags_.  Currently there are no valid
           flag modifiers, this field must contain **0**.
    
           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.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the request.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-EBADFD**
                  The descriptor passed in _fd_ does not refer to an io_uring
                  file descriptor, or the ring is in a disabled state.
    
           **-EOVERFLOW**
                  The kernel was unable to fill a CQE on the target ring.
                  This can happen if the target CQ ring is in an overflow
                  state and the kernel wasn't able to allocate memory for a
                  new CQE entry.
    


* * *
# auparse_timestamp_compare

## NAME



           auparse_timestamp_compare - compares timestamp values
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_timestamp_compare(const au_event_t**
           *****_e1,_**const** _au_event_t_***"**_e2);"_
    


## DESCRIPTION



           auparse_timestamp_compare compares the values of 2 timestamps.
    


## RETURN VALUE



           Returns -1, 0, or 1 respectively depending on whether e2 is less
           than, equal to, or greater than e1.
    


* * *
# gnutls_x509_crt_check_ip

## NAME



           gnutls_x509_crt_check_ip - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crt_check_ip(gnutls_x509_crt_t** _cert_**, const**
           **unsigned char ***_ip_**, unsigned int** _ip_size_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain an gnutls_x509_crt_t type
    
           const unsigned char * ip
                       A pointer to the raw IP address
    
           unsigned int ip_size
                       the number of bytes in ip (4 or 16)
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will check if the IP allowed IP addresses in the
           certificate's subject alternative name match the provided IP
           address.
    


## RETURNS



           non-zero for a successful match, and zero on failure.
    


* * *