tripathysagar/man_text huggingface dataset:
# gnutls_x509_ext_export_private_key_usage_period

## NAME



           gnutls_x509_ext_export_private_key_usage_period - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_private_key_usage_period(time_t**
           _activation_**, time_t** _expiration_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           time_t activation
                       The activation time
    
           time_t expiration
                       The expiration time
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the periods provided to a private key
           usage DER encoded extension (2.5.29.16).  The  _ext_ data will be
           allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# strncasecmp

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



           strncasecmp, strncasecmp_l — case-insensitive string comparisons
    


## SYNOPSIS



           #include <strings.h>
    
           int strncasecmp(const char *_s1_ , const char *_s2_ , size_t _n_);
           int strncasecmp_l(const char *_s1_ , const char *_s2_ ,
               size_t _n_ , locale_t _locale_);
    


## DESCRIPTION



           Refer to strcasecmp(3p).
    


* * *
# key_defined

## NAME



           **key_defined** - check if a keycode is defined
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int key_defined(const char ***_definition_**);**
    


## DESCRIPTION



           This is an extension to the curses library.  It permits an
           application to determine if a string is currently bound to any
           keycode.
    


## RETURN VALUE



           If the string is bound to a keycode, its value (greater than zero)
           is returned.  If no keycode is bound, zero is returned.  If the
           string conflicts with longer strings which are bound to keys, -1
           is returned.
    


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# tapset::nfsderrno

## NAME



           tapset::nfsderrno - systemtap nfsderrno tapset
    


## DESCRIPTION



           **nfsderror**
                  Convert nfsd error number into string
    
                  See function::nfsderror(3stap)
                   for details.
    


* * *
# gnutls_dh_get_prime_bits

## NAME



           gnutls_dh_get_prime_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_dh_get_prime_bits(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This function will return the bits of the prime used in the last
           Diffie-Hellman key exchange with the peer.  Should be used for
           both anonymous and ephemeral Diffie-Hellman.  Note that some
           ciphers, like RSA and DSA without DHE, do not use a Diffie-Hellman
           key exchange, and then this function will return 0.
    


## RETURNS



           The Diffie-Hellman bit strength is returned, or 0 if no
           Diffie-Hellman key exchange was done, or a negative error code on
           failure.
    


* * *
# sigdelset

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



           sigdelset — delete a signal from a signal set
    


## SYNOPSIS



           #include <signal.h>
    
           int sigdelset(sigset_t *_set_ , int _signo_);
    


## DESCRIPTION



           The _sigdelset_() function deletes the individual signal specified
           by _signo_ from the signal set pointed to by _set_.
    
           Applications should call either _sigemptyset_() or _sigfillset_() at
           least once for each object of type **sigset_t** prior to any other use
           of that object. If such an object is not initialized in this way,
           but is nonetheless supplied as an argument to any of
           _pthread_sigmask_(), _sigaction_(), _sigaddset_(), _sigdelset_(),
           _sigismember_(), _sigpending_(), _sigprocmask_(), _sigsuspend_(),
           _sigtimedwait_(), _sigwait_(), or _sigwaitinfo_(), the results are
           undefined.
    


## RETURN VALUE



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


## ERRORS



           The _sigdelset_() function may fail if:
    
           **EINVAL** The _signo_ argument is not a valid signal number, or is an
                  unsupported signal number.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# sigprocmask

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



           sigprocmask — examine and change blocked signals
    


## SYNOPSIS



           #include <signal.h>
    
           int sigprocmask(int _how_ , const sigset_t *restrict _set_ ,
               sigset_t *restrict _oset_);
    


## DESCRIPTION



           Refer to pthread_sigmask(3p).
    


* * *
# function::task_fd_lookup

## NAME



           function::task_fd_lookup - get the file struct for a task's fd
    


## SYNOPSIS



               task_fd_lookup:long(task:long,fd:long)
    


## ARGUMENTS



           _task_
               task_struct pointer.
    
           _fd_
               file descriptor number.
    


## DESCRIPTION



           Returns the file struct pointer for a task's file descriptor.
    


* * *
# function::set_user_string_n

## NAME



           function::set_user_string_n - Writes a string of given length to
           user memory
    


## SYNOPSIS



               set_user_string_n(addr:long,n:long,val:string)
    


## ARGUMENTS



           _addr_
               The user address to write the string to
    
           _n_
               The maximum length of the string
    
           _val_
               The string which is to be written
    


## DESCRIPTION



           Writes the given string up to a maximum given length to a given
           user memory address. Reports an error on string copy fault.
           Requires the use of guru mode (-g).
    


* * *
# probe::linuxmib.ListenOverflows

## NAME



           probe::linuxmib.ListenOverflows - Count of times a listen queue
           overflowed
    


## SYNOPSIS



           linuxmib.ListenOverflows
    


## VALUES



           _op_
               Value to be added to the counter (default value of 1)
    
           _sk_
               Pointer to the struct sock being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **linuxmib_filter_key**. If the packet passes the filter is is counted
           in the global _ListenOverflows_ (equivalent to SNMP's MIB
           LINUX_MIB_LISTENOVERFLOWS)
    


* * *
# posix_spawnattr_setschedpolicy

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


## SYNOPSIS



           #include <sched.h>
           #include <spawn.h>
    
           int posix_spawnattr_setschedpolicy(posix_spawnattr_t *_attr_ ,
               int _schedpolicy_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getschedpolicy(3p).
    


* * *
# function::thread_indent_depth

## NAME



           function::thread_indent_depth - returns the nested-depth of the
           current task
    


## SYNOPSIS



               thread_indent_depth:long(delta:long)
    


## ARGUMENTS



           _delta_
               the amount of depth added/removed for each call
    


## DESCRIPTION



           This function returns an integer equal to the nested function-call
           depth starting from the outermost initial level. This function is
           useful for saving space (consumed by whitespace) in traces with
           long nested function calls. Use this function in a similar fashion
           to **thread_indent** , i.e., in call-probe, use thread_indent_depth(1)
           and in return-probe, use thread_indent_depth(-1)
    


* * *
# gnutls_x509_crq_set_tlsfeatures

## NAME



           gnutls_x509_crq_set_tlsfeatures - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_tlsfeatures(gnutls_x509_crq_t** _crq_**,**
           **gnutls_x509_tlsfeatures_t** _features_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       An X.509 certificate request
    
           gnutls_x509_tlsfeatures_t features
                       If the function succeeds, the features will be added
                       to the certificate request.
    


## DESCRIPTION



           This function will set the certificate request's X.509 TLS
           extension from the given structure.
    


## RETURNS



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


## SINCE



           3.5.1
    


* * *
# probe::scheduler.kthread_stop

## NAME



           probe::scheduler.kthread_stop - A thread created by kthread_create
           is being stopped
    


## SYNOPSIS



           scheduler.kthread_stop
    


## VALUES



           _thread_priority_
               priority of the thread
    
           _thread_pid_
               PID of the thread being stopped
    


* * *
# pmstrncpy

## NAME



           **pmstrncpy** - safe string copy
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmstrncpy(char ***_dest_**, size_t** _destlen_**, char ***_src_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmstrncpy** is safe string copying routine with semantics similar to
           strncpy(3).
    
           The main differences between **pmstrncpy** and strncpy(3) are:
           • _src_ must be null-byte terminated for **pmstrncpy**
           • **pmstrncpy** ensures that _dest_ is null-byte terminated, even when
             _src_ is larger than _destlen_ ; this may result in truncated copying
             of _src_
           • when _src_ is shorter than _destlen_ **pmstrncpy** does not null-byte
             fill the remainder of _dest_ after _src_ has been copied and null-
             byte terminated
           • the length argument has the same semantics for **pmstrncpy** and
             pmstrncat(3), unlike strncpy(3) and strncat(3).
           • the return value from **pmstrncpy** is useful
           • the order of the arguments for **pmstrncpy** has been _deliberately_
             changed from the order of the arguments for strncpy(3) to avoid
             accidental misuse that a compiler can easily detect
    
           On success, **pmstrncpy** returns 0, else -1 indicates that _src_ is too
           big and the result been truncated to ensure _dest_ has no been over‐
           run.
    


* * *
# gnutls_x509_ext_import_subject_alt_names

## NAME



           gnutls_x509_ext_import_subject_alt_names - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_subject_alt_names(const gnutls_datum_t**
           *****_ext_**, gnutls_subject_alt_names_t** _sans_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       The DER-encoded extension data
    
           gnutls_subject_alt_names_t sans
                       The alternative names
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will export the alternative names in the provided
           DER-encoded SubjectAltName PKIX extension, to a
           **gnutls_subject_alt_names_t** type.  _sans_ must be initialized.
    
           This function will succeed even if there no subject alternative
           names in the structure.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_x509_crt_set_authority_info_access

## NAME



           gnutls_x509_crt_set_authority_info_access - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_authority_info_access(gnutls_x509_crt_t**
           _crt_**, int** _what_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           int what    what data to get, a **gnutls_info_access_what_t** type.
    
           gnutls_datum_t * data
                       output data to be freed with **gnutls_free()**.
    


## DESCRIPTION



           This function sets the Authority Information Access (AIA)
           extension, see RFC 5280 section 4.2.2.1 for more information.
    
           The type of data stored in  _data_ is specified via  _what_ which
           should be **gnutls_info_access_what_t** values.
    
           If  _what_ is **GNUTLS_IA_OCSP_URI** ,  _data_ will hold the OCSP URI.  If
           _what_ is **GNUTLS_IA_CAISSUERS_URI** ,  _data_ will hold the caIssuers
           URI.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# wchar_t

## NAME



           wchar_t - wide-character type
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <stddef.h>**
    
           **typedef** /* ... */  **wchar_t;**
    
           **#include <stdint.h>**
    
           **#define WCHAR_WIDTH** /* ... */
           **#define WCHAR_MAX** /* ... */
           **#define WCHAR_MIN** /* ... */
    


## DESCRIPTION



           _wchar_t_ is a type used for storing a wide character.  It is an
           integer type.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The following headers also provide this type: _< inttypes.h>_,
           _< stdlib.h>_, _< wchar.h>_, _< wctype.h>_.
    
           The following header also provides these macros: _< wchar.h>_.
    


* * *
# wcsstr

## NAME



           wcsstr - locate a substring in a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wchar_t *wcsstr(const wchar_t ***_haystack_**, const wchar_t ***_needle_**);**
    


## DESCRIPTION



           The **wcsstr**() function is the wide-character equivalent of the
           strstr(3) function.  It searches for the first occurrence of the
           wide-character string _needle_ (without its terminating null wide
           character (L'\0')) as a substring in the wide-character string
           _haystack_.
    


## RETURN VALUE



           The **wcsstr**() function returns a pointer to the first occurrence of
           _needle_ in _haystack_.  It returns NULL if _needle_ does not occur as a
           substring in _haystack_.
    
           Note the special case: If _needle_ is the empty wide-character
           string, the return value is always _haystack_ itself.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_x509_crq_get_attribute_by_oid

## NAME



           gnutls_x509_crq_get_attribute_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_attribute_by_oid(gnutls_x509_crq_t** _crq_**,**
           **const char ***_oid_**, unsigned** _indx_**, void ***_buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * oid
                       holds an Object Identifier in null-terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the attribute
                       list, this specifies which to get, use (0) to get the
                       first one
    
           void * buf  a pointer to a structure to hold the attribute data
                       (may be **NULL**)
    
           size_t * buf_size
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will return the attribute in the certificate request
           specified by the given Object ID.  The attribute will be DER
           encoded.
    
           Attributes in a certificate request is an optional set of data
           appended to the request. Their interpretation depends on the CA
           policy.
    


## RETURNS



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


* * *
# function::isinstr

## NAME



           function::isinstr - Returns whether a string is a substring of
           another string
    


## SYNOPSIS



               isinstr:long(s1:string,s2:string)
    


## ARGUMENTS



           _s1_
               string to search in
    
           _s2_
               substring to find
    


## DESCRIPTION



           This function returns 1 if string _s1_ contains _s2_ , otherwise zero.
    


* * *
# gnutls_psk_allocate_client_credentials

## NAME



           gnutls_psk_allocate_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_allocate_client_credentials(gnutls_psk_client_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



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


## DESCRIPTION



           Allocate a gnutls_psk_client_credentials_t structure.
    


## RETURNS



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


* * *
# sd-json

## NAME



           sd-json - APIs for Dealing with JSON Objects
    


## SYNOPSIS



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


## DESCRIPTION



           sd-json.h is part of libsystemd(3) and provides APIs to parse,
           generate, format and otherwise operate with JSON objects.
    
           The API's central data structure is **JsonVariant** which encapsulates
           a JSON object, array, string, boolean, number or null value. These
           data structures are mostly considered immutable after construction
           (i.e. their contents will not change, but some meta-data might,
           such as reference counters).
    
           The APIs broadly fall into five categories:
    
           •   APIs to directly operate with **JsonVariant** objects, in the
               **sd_json_variant*** namespace.
    
           •   APIs to construct complex JSON objects, in the **sd_json_build***
               namespace.
    
           •   APIs to map **JsonVariant** objects and their fields to matching
               fields in C structures, in the **sd_json_dispatch*** namespace.
    
           •   APIs to convert a string representation of a JSON object into
               a **JsonVariant** object, in the **sd_json_parse*** namespace.
    
           •   APIs to convert an **JsonVariant** object into its string
               representation, in the **sd_json_format*** namespace.
    
           This JSON library will internally encode JSON integer numbers in
           the range **INT64_MIN**...**UINT64_MAX** into native 64bit signed or
           unsigned integers, and will reproduce them without loss of
           precision. Non-integer numbers are stored in 64bit IEEE floating
           point numbers.
    
           If the functions return string arrays, these are generally **NULL**
           terminated and need to be freed by the caller with the libc
           free(3) call after use, including the strings referenced therein.
           Similarly, individual strings returned need to be freed, as well.
    
           As a special exception, instead of an empty string array **NULL** may
           be returned, which should be treated equivalent to an empty string
           array.
    


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


* * *
# getpwent

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



           getpwent — get user database entry
    


## SYNOPSIS



           #include <pwd.h>
    
           struct passwd *getpwent(void);
    


## DESCRIPTION



           Refer to endpwent(3p).
    


* * *
# gnutls_prf_raw

## NAME



           gnutls_prf_raw - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_prf_raw(gnutls_session_t** _session_**, size_t** _label_size_**,**
           **const char ***_label_**, size_t** _seed_size_**, const char ***_seed_**, size_t**
           _outsize_**, char ***_out_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t label_size
                       length of the  _label_ variable.
    
           const char * label
                       label used in PRF computation, typically a short
                       string.
    
           size_t seed_size
                       length of the  _seed_ variable.
    
           const char * seed
                       optional extra data to seed the PRF with.
    
           size_t outsize
                       size of pre-allocated output buffer to hold the
                       output.
    
           char * out  pre-allocated buffer to hold the generated data.
    


## DESCRIPTION



           Apply the TLS Pseudo-Random-Function (PRF) on the master secret
           and the provided data.
    
           The  _label_ variable usually contains a string denoting the purpose
           for the generated data.  The  _seed_ usually contains data such as
           the client and server random, perhaps together with some
           additional data that is added to guarantee uniqueness of the
           output for a particular purpose.
    
           Because the output is not guaranteed to be unique for a particular
           session unless  _seed_ includes the client random and server random
           fields (the PRF would output the same data on another connection
           resumed from the first one), it is not recommended to use this
           function directly.  The **gnutls_prf()** function seeds the PRF with
           the client and server random fields directly, and is recommended
           if you want to generate pseudo random data unique for each
           session.
    


## NOTE



           This function will only operate under TLS versions prior to 1.3.
           In TLS1.3 the use of PRF is replaced with HKDF and the generic
           exporters like **gnutls_prf_rfc5705()** should be used instead. Under
           TLS1.3 this function returns **GNUTLS_E_INVALID_REQUEST**.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code.
    


* * *
# gnutls_x509_policies_set

## NAME



           gnutls_x509_policies_set - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_policies_set(gnutls_x509_policies_t** _policies_**,**
           **const struct gnutls_x509_policy_st ***_policy_**);**
    


## ARGUMENTS



           gnutls_x509_policies_t policies
                       An initialized policies
    
           const struct gnutls_x509_policy_st * policy
                       Contains the policy to set
    


## DESCRIPTION



           This function will store the specified policy in the provided
           _policies_ .
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# seed48

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



           seed48 — seed a uniformly distributed pseudo-random non-negative
           long integer generator
    


## SYNOPSIS



           #include <stdlib.h>
    
           unsigned short *seed48(unsigned short _seed16v_[3]);
    


## DESCRIPTION



           Refer to drand48(3p).
    


* * *
# function::panic

## NAME



           function::panic - trigger a panic
    


## SYNOPSIS



               panic(msg:string)
    


## ARGUMENTS



           _msg_
               message to pass to kernel's **panic** function
    


## DESCRIPTION



           This function triggers an immediate panic of the running kernel
           with a user-specified panic message. It requires guru mode.
    


* * *
# probe::sunrpc.clnt.clone_client

## NAME



           probe::sunrpc.clnt.clone_client - Clone an RPC client structure
    


## SYNOPSIS



           sunrpc.clnt.clone_client
    


## VALUES



           _prog_
               the RPC program number
    
           _servername_
               the server machine name
    
           _authflavor_
               the authentication flavor
    
           _progname_
               the RPC program name
    
           _prot_
               the IP protocol number
    
           _port_
               the port number
    
           _vers_
               the RPC program version number
    


* * *
# probe::nfs.fop.lock

## NAME



           probe::nfs.fop.lock - NFS client file lock operation
    


## SYNOPSIS



           nfs.fop.lock
    


## VALUES



           _fl_flag_
               lock flags
    
           _fl_start_
               starting offset of locked region
    
           _fl_type_
               lock type
    
           _dev_
               device identifier
    
           _fl_end_
               ending offset of locked region
    
           _ino_
               inode number
    
           _cmd_
               cmd arguments
    
           _i_mode_
               file type and access rights
    


* * *
# probe::nfs.fop.check_flags

## NAME



           probe::nfs.fop.check_flags - NFS client checking flag operation
    


## SYNOPSIS



           nfs.fop.check_flags
    


## VALUES



           _flag_
               file flag
    


* * *
# pam_sm_acct_mgmt

## NAME



           pam_sm_acct_mgmt - PAM service function for account management
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_sm_acct_mgmt** function is the service module's
           implementation of the pam_acct_mgmt(3) interface.
    
           This function performs the task of establishing whether the user
           is permitted to gain access at this time. It should be understood
           that the user has previously been validated by an authentication
           module. This function checks for other things. Such things might
           be: the time of day or the date, the terminal line, remote
           hostname, etc. This function may also determine things like the
           expiration on passwords, and respond that the user change it
           before continuing.
    
           Valid flags, which may be logically OR'd with _PAM_SILENT_ , are:
    
           PAM_SILENT
               Do not emit any messages.
    
           PAM_DISALLOW_NULL_AUTHTOK
               Return **PAM_AUTH_ERR** if the database of authentication tokens
               for this authentication mechanism has a _NULL_ entry for the
               user.
    


## RETURN VALUES



           PAM_ACCT_EXPIRED
               User account has expired.
    
           PAM_AUTH_ERR
               Authentication failure.
    
           PAM_NEW_AUTHTOK_REQD
               The user's authentication token has expired. Before calling
               this function again the application will arrange for a new one
               to be given. This will likely result in a call to
               **pam_sm_chauthtok()**.
    
           PAM_PERM_DENIED
               Permission denied.
    
           PAM_SUCCESS
               The authentication token was successfully updated.
    
           PAM_USER_UNKNOWN
               User unknown to password service.
    


* * *
# sd_bus_message_at_end

## NAME



           sd_bus_message_at_end - Check if a message has been fully read
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_at_end(sd_bus_message ***_m_**, int** _complete_**);**
    


## DESCRIPTION



           **sd_bus_message_at_end()** returns whether all data from the
           currently opened container in _m_ or all data from all containers in
           _m_ has been read. If _complete_ is zero, this function returns
           whether all data from the currently opened container has been
           read. If _complete_ is non-zero, this function returns whether all
           data from all containers in _m_ has been read.
    


## RETURN VALUE



           If all data from all containers or the current container
           (depending on the value of _complete_) has been read,
           **sd_bus_message_at_end()** returns a positive integer. If there is
           still data left to be read, it returns zero. On failure, it
           returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _m_ parameter is **NULL**.
    
               Added in version 246.
    
           **-EPERM**
               The message is not sealed.
    
               Added in version 246.
    


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


* * *
# ftime

## NAME



           ftime - return date and time
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/timeb.h>**
    
           **int ftime(struct timeb ***_tp_**);**
    


## DESCRIPTION



           **NOTE** : This function is no longer provided by the GNU C library.
           Use clock_gettime(2) instead.
    
           This function returns the current time as seconds and milliseconds
           since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).  The time is
           returned in _tp_ , which is declared as follows:
    
               struct timeb {
                   time_t         time;
                   unsigned short millitm;
                   short          timezone;
                   short          dstflag;
               };
    
           Here _time_ is the number of seconds since the Epoch, and _millitm_ is
           the number of milliseconds since _time_ seconds since the Epoch.
           The _timezone_ field is the local timezone measured in minutes of
           time west of Greenwich (with a negative value indicating minutes
           east of Greenwich).  The _dstflag_ field is a flag that, if nonzero,
           indicates that Daylight Saving time applies locally during the
           appropriate part of the year.
    
           POSIX.1-2001 says that the contents of the _timezone_ and _dstflag_
           fields are unspecified; avoid relying on them.
    


## RETURN VALUE



           This function always returns 0.  (POSIX.1-2001 specifies, and some
           systems document, a -1 error return.)
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## BUGS



           Early glibc2 is buggy and returns 0 in the _millitm_ field; glibc
           2.1.1 is correct again.
    


* * *
# gnutls_dtls_set_data_mtu

## NAME



           gnutls_dtls_set_data_mtu - API function
    


## SYNOPSIS



           **#include <gnutls/dtls.h>**
    
           **int gnutls_dtls_set_data_mtu(gnutls_session_t** _session_**, unsigned**
           **int** _mtu_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int mtu
                       The maximum unencrypted transfer unit of the session
    


## DESCRIPTION



           This function will set the maximum size of the *unencrypted*
           records which will be sent over a DTLS session. It is equivalent
           to calculating the DTLS packet overhead with the current
           encryption parameters, and calling **gnutls_dtls_set_mtu()** with that
           value. In particular, this means that you may need to call this
           function again after any negotiation or renegotiation, in order to
           ensure that the MTU is still sufficient to account for the new
           protocol overhead.
    
           In most cases you only need to call **gnutls_dtls_set_mtu()** with the
           maximum MTU of your transport layer.
    


## RETURNS



           **GNUTLS_E_SUCCESS**(0) on success, or a negative error code.
    


## SINCE



           3.1
    


* * *
# io_uring_sqe_set_data

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


* * *
# gnutls_privkey_export_rsa_raw2

## NAME



           gnutls_privkey_export_rsa_raw2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_rsa_raw2(gnutls_privkey_t** _key_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**, gnutls_datum_t ***_d_**,**
           **gnutls_datum_t ***_p_**, gnutls_datum_t ***_q_**, gnutls_datum_t ***_u_**,**
           **gnutls_datum_t ***_e1_**, gnutls_datum_t ***_e2_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus
    
           gnutls_datum_t * e
                       will hold the public exponent
    
           gnutls_datum_t * d
                       will hold the private exponent
    
           gnutls_datum_t * p
                       will hold the first prime (p)
    
           gnutls_datum_t * q
                       will hold the second prime (q)
    
           gnutls_datum_t * u
                       will hold the coefficient
    
           gnutls_datum_t * e1
                       will hold e1 = d mod (p-1)
    
           gnutls_datum_t * e2
                       will hold e2 = d mod (q-1)
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# memccpy

## NAME



           memccpy - copy memory area
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **void *memccpy(** size_t n;
                         **void** _dest_**[restrict** _n_**], const void** _src_**[restrict** _n_**],**
                         **int** _c_**, size_t** _n_**);**
    


## DESCRIPTION



           The **memccpy**() function copies no more than _n_ bytes from memory
           area _src_ to memory area _dest_ , stopping when the character _c_ is
           found (_c_ is copied).
    
           If the memory areas overlap, the results are undefined.
    


## RETURN VALUE



           The **memccpy**() function returns a pointer to the next character in
           _dest_ after _c_ , or NULL if _c_ was not found in the first _n_ characters
           of _src_.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_pkcs_schema_get_name

## NAME



           gnutls_pkcs_schema_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **const char * gnutls_pkcs_schema_get_name(unsigned int** _schema_**);**
    


## ARGUMENTS



           unsigned int schema
                       Holds the PKCS **12** or PBES2 schema
                       (**gnutls_pkcs_encrypt_flags_t**)
    


## DESCRIPTION



           This function will return a human readable description of the
           PKCS12 or PBES2 schema.
    


## RETURNS



           a constraint string or **NULL** on error.
    


## SINCE



           3.4.0
    


* * *
# auparse_get_num_records

## NAME



           auparse_get_num_records - get the number of records
    


## SYNOPSIS



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


## DESCRIPTION



           auparse_get_num_records gets the number of records in the current
           event.
    


## RETURN VALUE



           Returns 0 if an error occurs; otherwise, the number of records.
    


* * *
# audit_is_enabled

## NAME



           audit_is_enabled - judge whether auditing is enabled or not
    


## SYNOPSIS



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


## DESCRIPTION



           **audit_is_enabled**() judges whether auditing is enabled or not.  _fd_
           must have been returned by audit_open(3).
    


## RETURN VALUE



           This function will return 0 if auditing is NOT enabled and 1 if
           enabled, and -1 on error.
    


* * *
# probe::nfsd.unlink

## NAME



           probe::nfsd.unlink - NFS server removing a file or a directory for
           client
    


## SYNOPSIS



           nfsd.unlink
    


## VALUES



           _client_ip_
               the ip address of client
    
           _filelen_
               the length of file name
    
           _type_
               file type (file or dir)
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _filename_
               file name
    


* * *
# canonicalize_file_name

## NAME



           canonicalize_file_name - return the canonicalized absolute
           pathname
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <stdlib.h>**
    
           **char *canonicalize_file_name(const char ***_path_**);**
    


## DESCRIPTION



           The **canonicalize_file_name**() function returns a null-terminated
           string containing the canonicalized absolute pathname
           corresponding to _path_.  In the returned string, symbolic links are
           resolved, as are _._  and _.._  pathname components.  Consecutive
           slash (_/_) characters are replaced by a single slash.
    
           The returned string is dynamically allocated by
           **canonicalize_file_name**() and the caller should deallocate it with
           free(3) when it is no longer required.
    
           The call _canonicalize_file_name(path)_ is equivalent to the call:
    
               realpath(path, NULL);
    


## RETURN VALUE



           On success, **canonicalize_file_name**() returns a null-terminated
           string.  On error (e.g., a pathname component is unreadable or
           does not exist), **canonicalize_file_name**() returns NULL and sets
           _errno_ to indicate the error.
    


## ERRORS



           See realpath(3).
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


* * *
# posix_spawnattr_setpgroup

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


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawnattr_setpgroup(posix_spawnattr_t *_attr_ , pid_t _pgroup_);
    


## DESCRIPTION



           Refer to posix_spawnattr_getpgroup(3p).
    


* * *
# pcre2_general_context_create

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **pcre2_general_context *pcre2_general_context_create(**
             **void *(***_private_malloc_**)(size_t, void *),**
             **void (***_private_free_**)(void *, void *), void ***_memory_data_**);**
    


## DESCRIPTION



    
           This function creates and initializes a general context. The
           arguments define custom memory management functions and a data
           value that is passed to them when they are called. The
           **private_malloc()** function is used to get memory for the context.
           If either of the first two arguments is NULL, the system memory
           management function is used. The result is NULL if no memory could
           be obtained.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *