tripathysagar/man_text huggingface dataset:
# index

## NAME



           index, rindex - locate character in string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <strings.h>**
    
           **[[deprecated]] char *index(const char ***_s_**, int** _c_**);**
           **[[deprecated]] char *rindex(const char ***_s_**, int** _c_**);**
    


## DESCRIPTION



           **index**() is identical to strchr(3).
    
           **rindex**() is identical to strrchr(3).
    
           Use strchr(3) and strrchr(3) instead of these functions.
    


## STANDARDS



           None.
    


* * *
# cexp

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



           cexp, cexpf, cexpl — complex exponential functions
    


## SYNOPSIS



           #include <complex.h>
    
           double complex cexp(double complex _z_);
           float complex cexpf(float complex _z_);
           long double complex cexpl(long double complex _z_);
    


## 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 complex exponent of _z_ , defined
           as _ez_.
    


## RETURN VALUE



           These functions shall return the complex exponential value of _z_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_session_ticket_enable_client

## NAME



           gnutls_session_ticket_enable_client - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Request that the client should attempt session resumption using
           SessionTicket. This call is typically unnecessary as session
           tickets are enabled by default.
    


## RETURNS



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


## SINCE



           2.10.0
    


* * *
# function::stack_used

## NAME



           function::stack_used - Returns the amount of kernel stack used
    


## SYNOPSIS



               stack_used:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function determines how many bytes are currently used in the
           kernel stack.
    


* * *
# menu_cursor

## NAME



           **pos_menu_cursor** - position a menu's cursor
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int pos_menu_cursor(const MENU ***_menu_**);**
    


## DESCRIPTION



           The function **pos_menu_cursor** restores the cursor to the current
           position associated with the menu's selected item.  This is useful
           after **curses** routines have been called to do screen-painting in
           response to a menu select.
    


## RETURN VALUE



           This routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_NOT_POSTED**
                The menu has not been posted.
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# function::sock_fam_str2num

## NAME



           function::sock_fam_str2num - Given a protocol family name
           (string), return the corresponding protocol family number
    


## SYNOPSIS



               sock_fam_str2num:long(family:string)
    


## ARGUMENTS



           _family_
               The family name
    


* * *
# capng_get_caps_process

## NAME



           capng_get_caps_process - get the capabilities from a process
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_get_caps_process(void);
    


## DESCRIPTION



           capng_get_caps_process will get the capabilities and bounding set
           of the pid stored inside libcap-ng's state table. The default is
           the pid of the running process. This can be changed by using the
           capng_setpid function.
    


## RETURN VALUE



           This returns 0 on success and -1 on failure.
    


## NOTES



           If you are doing multi-threaded programming, calling this function
           will only get capabilities on the calling thread. If you want to
           get overall capabilities for a multi-threaded process, you can
           only do that before creating any threads. Afterwards, threads may
           be able to independently set capabilities.
    
           capng_get_caps_process needs a mounted /proc to read the current
           bounding set, otherwise it will fail.
    


* * *
# function::pexecname

## NAME



           function::pexecname - Returns the execname of a target process's
           parent process
    


## SYNOPSIS



               pexecname:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the execname of a target process's parent
           procces.
    


* * *
# cc_t

## NAME



           cc_t, speed_t, tcflag_t - terminal special characters, baud rates,
           modes
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <termios.h>**
    
           **typedef** /* ... */ **cc_t;**
           **typedef** /* ... */ **speed_t;**
           **typedef** /* ... */ **tcflag_t;**
    


## DESCRIPTION



           _cc_t_ is used for terminal special characters, _speed_t_ for baud
           rates, and _tcflag_t_ for modes.
    
           All are unsigned integer types.
    


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_certificate_set_x509_crl

## NAME



           gnutls_certificate_set_x509_crl - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_crl(gnutls_certificate_credentials_t**
           _res_**, gnutls_x509_crl_t ***_crl_list_**, int** _crl_list_size_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_x509_crl_t * crl_list
                       is a list of trusted CRLs. They should have been
                       verified before.
    
           int crl_list_size
                       holds the size of the crl_list
    


## DESCRIPTION



           This function adds the trusted CRLs in order to verify client or
           server certificates.  In case of a client this is not required to
           be called if the certificates are not verified using
           **gnutls_certificate_verify_peers2()**.  This function may be called
           multiple times.
    


## RETURNS



           number of CRLs processed, or a negative error code on error.
    


## SINCE



           2.4.0
    


* * *
# gnutls_x509_privkey_sec_param

## NAME



           gnutls_x509_privkey_sec_param - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **gnutls_sec_param_t**
           **gnutls_x509_privkey_sec_param(gnutls_x509_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    


## DESCRIPTION



           This function will return the security parameter appropriate with
           this private key.
    


## RETURNS



           On success, a valid security parameter is returned otherwise
           **GNUTLS_SEC_PARAM_UNKNOWN** is returned.
    


## SINCE



           2.12.0
    


* * *
# gnutls_x509_privkey_generate

## NAME



           gnutls_x509_privkey_generate - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_generate(gnutls_x509_privkey_t** _key_**,**
           **gnutls_pk_algorithm_t** _algo_**, unsigned int** _bits_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       an initialized key
    
           gnutls_pk_algorithm_t algo
                       is one of the algorithms in **gnutls_pk_algorithm_t**.
    
           unsigned int bits
                       the size of the parameters to generate
    
           unsigned int flags
                       Must be zero or flags from **gnutls_privkey_flags_t**.
    


## DESCRIPTION



           This function will generate a random private key. Note that this
           function must be called on an initialized private key.
    
           The flag **GNUTLS_PRIVKEY_FLAG_PROVABLE** instructs the key generation
           process to use algorithms like Shawe-Taylor (from FIPS PUB186-4)
           which generate provable parameters out of a seed for RSA and DSA
           keys. See **gnutls_x509_privkey_generate2()** for more information.
    
           Note that when generating an elliptic curve key, the curve can be
           substituted in the place of the bits parameter using the
           **GNUTLS_CURVE_TO_BITS()** macro. The input to the macro is any curve
           from **gnutls_ecc_curve_t**.
    
           For DSA keys, if the subgroup size needs to be specified check the
           **GNUTLS_SUBGROUP_TO_BITS()** macro.
    
           It is recommended to do not set the number of  _bits_ directly, use
           **gnutls_sec_param_to_pk_bits()** instead .
    
           See also **gnutls_privkey_generate()** ,
           **gnutls_x509_privkey_generate2()**.
    


## RETURNS



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


* * *
# gnutls_pubkey_import_openpgp

## NAME



           gnutls_pubkey_import_openpgp - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_openpgp(gnutls_pubkey_t** _key_**,**
           **gnutls_openpgp_crt_t** _crt_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The public key
    
           gnutls_openpgp_crt_t crt
                       The certificate to be imported
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           2.12.0
    


* * *
# gnutls_pubkey_export

## NAME



           gnutls_pubkey_export - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_export(gnutls_pubkey_t** _key_**,**
           **gnutls_x509_crt_fmt_t** _format_**, void ***_output_data_**, size_t ***
           _output_data_size_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the certificate
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           void * output_data
                       will contain a certificate PEM or DER encoded
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    


## DESCRIPTION



           This function will export the public key to DER or PEM format.
           The contents of the exported data is the SubjectPublicKeyInfo
           X.509 structure.
    
           If the buffer provided is not long enough to hold the output, then
           *output_data_size is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** will
           be returned.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           CERTIFICATE".
    


## RETURNS



           In case of failure a negative error code will be returned, and 0
           on success.
    


## SINCE



           2.12.0
    


* * *
# gnutls_pkcs12_bag_get_key_id

## NAME



           gnutls_pkcs12_bag_get_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_bag_get_key_id(gnutls_pkcs12_bag_t** _bag_**, unsigned**
           _indx_**, gnutls_datum_t ***_id_**);**
    


## ARGUMENTS



           gnutls_pkcs12_bag_t bag
                       The bag
    
           unsigned indx
                       The bag's element to add the id
    
           gnutls_datum_t * id
                       where the ID will be copied (to be treated as const)
    


## DESCRIPTION



           This function will return the key ID, of the specified bag
           element.  The key ID is usually used to distinguish the local
           private key and the certificate pair.
    


## RETURNS



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


* * *
# gnutls_transport_set_int

## NAME



           gnutls_transport_set_int - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_set_int(gnutls_session_t** _session_**, int** _fd_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int fd      is the socket descriptor for the connection.
    


## DESCRIPTION



           This function sets the first argument of the transport function,
           such as **send()** and **recv()** for the default callbacks using the
           system's socket API.
    
           This function is equivalent to calling **gnutls_transport_set_ptr()**
           with the descriptor, but requires no casts.
    


## SINCE



           3.1.9
    


* * *
# probe::tcpmib.ActiveOpens

## NAME



           probe::tcpmib.ActiveOpens - Count an active opening of a socket
    


## SYNOPSIS



           tcpmib.ActiveOpens
    


## VALUES



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


## DESCRIPTION



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


* * *
# gnutls_x509_crt_get_subject_unique_id

## NAME



           gnutls_x509_crt_get_subject_unique_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_subject_unique_id(gnutls_x509_crt_t** _crt_**,**
           **char ***_buf_**, size_t ***_buf_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           char * buf  user allocated memory buffer, will hold the unique id
    
           size_t * buf_size
                       size of user allocated memory buffer (on input), will
                       hold actual size of the unique ID on return.
    


## DESCRIPTION



           This function will extract the subjectUniqueID value (if present)
           for the given certificate.
    
           If the user allocated memory buffer is not large enough to hold
           the full subjectUniqueID, then a GNUTLS_E_SHORT_MEMORY_BUFFER
           error will be returned, and buf_size will be set to the actual
           length.
    
           This function had a bug prior to 3.4.8 that prevented the setting
           of **NULL** _buf_ to discover the  _buf_size_ . To use this function
           safely with the older versions the  _buf_ must be a valid buffer
           that can hold at least a single byte if  _buf_size_ is zero.
    


## RETURNS



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


* * *
# tapset::inet_sock

## NAME



           tapset::inet_sock - systemtap inet_sock tapset
    


## DESCRIPTION



           **inet_get_local_port**
                  Provide local port number for a kernel socket
    
                  See function::inet_get_local_port(3stap)
                   for details.
    
           **inet_get_dest_port**
                  Provide remote port number for a kernel socket
    
                  See function::inet_get_dest_port(3stap)
                   for details.
    
           **inet_get_ip_source**
                  Provide IP source address string for a kernel socket
    
                  See function::inet_get_ip_source(3stap)
                   for details.
    
           **inet_get_ip_dest**
                  Provide IP destination address string for a kernel socket
    
                  See function::inet_get_ip_dest(3stap)
                   for details.
    


* * *
# gnutls_privkey_verify_seed

## NAME



           gnutls_privkey_verify_seed - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_privkey_t key
                       should contain a **gnutls_privkey_t** type
    
           gnutls_digest_algorithm_t digest
                       it contains the digest algorithm used for key
                       generation (if applicable)
    
           const void * seed
                       the seed of the key to be checked with
    
           size_t seed_size
                       holds the size of  _seed_
    


## DESCRIPTION



           This function will verify that the given private key was generated
           from the provided seed.
    


## RETURNS



           In case of a verification failure
           **GNUTLS_E_PRIVKEY_VERIFICATION_ERROR** is returned, and zero or
           positive code on success.
    


## SINCE



           3.5.0
    


* * *
# function::set_user_pointer

## NAME



           function::set_user_pointer - Writes a pointer value to user
           memory.
    


## SYNOPSIS



               set_user_pointer(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The user address to write the pointer to
    
           _val_
               The pointer which is to be written
    


## DESCRIPTION



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


* * *
# mlx5dv_create_cq

## NAME



           mlx5dv_create_cq - creates a completion queue (CQ)
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct ibv_cq_ex *mlx5dv_create_cq(struct ibv_context *context,
                                     struct ibv_cq_init_attr_ex *cq_attr,
                                     struct mlx5dv_cq_init_attr *mlx5_cq_attr);
    


## DESCRIPTION



           **mlx5dv_create_cq()** creates a completion queue (CQ) with specific
           driver properties.
    


## ARGUMENTS



           Please see **ibv_create_cq_ex(3)** man page for **context** and **cq_attr**
    
       **mlx5_cq_attr**
                  struct mlx5dv_cq_init_attr {
                      uint64_t comp_mask;
                      uint8_t  cqe_comp_res_format;
                      uint32_t flags;
                      uint16_t cqe_size;
                  };
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid:
    
                  MLX5DV_CQ_INIT_ATTR_MASK_COMPRESSED_CQE enables creating a
                  CQ in a mode that few CQEs may be compressed into a single
                  CQE, valid values in _cqe_comp_res_format_
    
                  MLX5DV_CQ_INIT_ATTR_MASK_FLAGS valid values in _flags_
    
                  MLX5DV_CQ_INIT_ATTR_MASK_CQE_SIZE valid values in _cqe_size_
    
           _cqe_comp_res_format_
                  A bitwise OR of the various CQE response formats of the
                  responder side:
    
                  MLX5DV_CQE_RES_FORMAT_HASH CQE compression with hash
    
                  MLX5DV_CQE_RES_FORMAT_CSUM CQE compression with RX checksum
    
                  MLX5DV_CQE_RES_FORMAT_CSUM_STRIDX CQE compression with
                  stride index
    
           _flags_  A bitwise OR of the various values described below:
    
                  MLX5DV_CQ_INIT_ATTR_FLAGS_CQE_PAD create a padded 128B CQE
    
           _cqe_size_
                  configure the CQE size to be 64 or 128 bytes other values
                  will fail mlx5dv_create_cq.
    


## RETURN VALUE



           **mlx5dv_create_cq()** returns a pointer to the created CQ, or NULL if
           the request fails and errno will be set.
    


* * *
# timespec_get

## NAME



           timespec_get, timespec_getres - ISO C interface to clock and time
           functions
    


## LIBRARY



           Standard C library (_libc_ , _-lc_),
    


## SYNOPSIS



           **#include <time.h>**
    
           **int timespec_get(struct timespec ***_res_**, int** _base_**);**
           **int timespec_getres(struct timespec ***_tp_**, int** _base_**);**
    


## DESCRIPTION



           The **timespec_get**() function stores the current time, based on the
           specified time base, in the timespec(3type) structure pointed to
           by _res_.
    
           The **timespec_getres**() function stores the resolution of times
           retrieved by **timespec_get**() with the specified time base in the
           timespec(3type) structure pointed to by _tp_ , if _tp_ is non-NULL.
           For a particular time base, the resolution is constant for the
           lifetime of the calling process.
    
           **TIME_UTC** is always a supported time base, and is the only time
           base supported on Linux.  The time and resolution in this time
           base are the same as those retrieved by
           _clock_gettime(CLOCK_REALTIME, res)_ and
           _clock_getres(CLOCK_REALTIME, tp)_ , respectively.  Other systems may
           support additional time bases.
    


## RETURN VALUE



           **timespec_get**() returns the nonzero _base_ if it is a supported time
           base and the current time was successfully retrieved, or 0
           otherwise.
    
           **timespec_getres**() returns the nonzero _base_ if it is a supported
           time base, or 0 otherwise.
    


## ATTRIBUTES



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


## STANDARDS



           **timespec_get**()
           **TIME_UTC**
                  C23 (though ISO C doesn't specify the time epoch),
                  POSIX.1-2024.
    
           **timespec_getres**()
                  C23.
    


* * *
# gnutls_priority_certificate_type_list2

## NAME



           gnutls_priority_certificate_type_list2 - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list.
    
           gnutls_ctype_target_t target
                       is a **gnutls_ctype_target_t** type. Valid arguments are
                       GNUTLS_CTYPE_CLIENT and GNUTLS_CTYPE_SERVER
    


## DESCRIPTION



           Get a list of available certificate types for the given target in
           the priority structure.
    


## RETURNS



           the number of certificate types, or an error code.
    


## SINCE



           3.6.4
    


* * *
# security_getenforce

## NAME



           security_getenforce, security_setenforce, security_deny_unknown,
           security_reject_unknown, security_get_checkreqprot - get or set
           the enforcing state of SELinux
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int security_getenforce(void);**
    
           **int security_setenforce(int** _value_**);**
    
           **int security_deny_unknown(void);**
    
           **int security_reject_unknown(void);**
    
           **int security_get_checkreqprot(void);**
    


## DESCRIPTION



           **security_getenforce**() returns 0 if SELinux is running in
           permissive mode, 1 if it is running in enforcing mode, and -1 on
           error.
    
           **security_setenforce**() sets SELinux to enforcing mode if the value
           1 is passed in, and sets it to permissive mode if 0 is passed in.
           On success 0 is returned, on error -1 is returned.
    
           **security_deny_unknown**() returns 0 if SELinux treats policy queries
           on undefined object classes or permissions as being allowed, 1 if
           such queries are denied, and -1 on error.
    
           **security_reject_unknown**() returns 1 if the current policy was
           built with handle-unknown=reject and SELinux would reject loading
           it, if it did not define all kernel object classes and
           permissions. In this state, when **selinux_set_mapping()** and
           **selinux_check_access()** are used with an undefined userspace class
           or permission, an error is returned and errno is set to EINVAL.
    
           It returns 0 if the current policy was built with handle-
           unknown=allow or handle-unknown=deny. In this state, policy
           queries are treated according to **security_deny_unknown().** -1 is
           returned on error.
    
           **security_get_checkreqprot**() can be used to determine whether
           SELinux is configured to check the protection requested by the
           application or the actual protection that will be applied by the
           kernel (including the effects of READ_IMPLIES_EXEC) on mmap and
           mprotect calls.  It returns 0 if SELinux checks the actual
           protection, 1 if it checks the requested protection, and -1 on
           error.
    


* * *
# function::sigset_mask_str

## NAME



           function::sigset_mask_str - Returns the string representation of a
           sigset
    


## SYNOPSIS



               sigset_mask_str:string(mask:long)
    


## ARGUMENTS



           _mask_
               the sigset to convert to string.
    


* * *
# probe::nfs.proc.rename

## NAME



           probe::nfs.proc.rename - NFS client renames a file on server
    


## SYNOPSIS



           nfs.proc.rename
    


## VALUES



           _new_fh_
               file handle of new parent dir
    
           _old_name_
               old file name
    
           _prot_
               transfer protocol
    
           _new_name_
               new file name
    
           _old_fh_
               file handle of old parent dir
    
           _version_
               NFS version (the function is used for all NFS version)
    
           _old_filelen_
               length of old file name
    
           _server_ip_
               IP address of server
    
           _new_filelen_
               length of new file name
    


* * *
# probe::vm.kmem_cache_alloc

## NAME



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


## SYNOPSIS



           vm.kmem_cache_alloc
    


## VALUES



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


* * *
# pam_sm_authenticate

## NAME



           pam_sm_authenticate - PAM service function for user authentication
    


## SYNOPSIS



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


## DESCRIPTION



           The **pam_sm_authenticate** function is the service module's
           implementation of the pam_authenticate(3) interface.
    
           This function performs the task of authenticating the user.
    
           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. Without this flag, such a _NULL_ token will lead to a
               success without the user being prompted.
    


## RETURN VALUES



           PAM_AUTH_ERR
               Authentication failure.
    
           PAM_CRED_INSUFFICIENT
               For some reason the application does not have sufficient
               credentials to authenticate the user.
    
           PAM_AUTHINFO_UNAVAIL
               The modules were not able to access the authentication
               information. This might be due to a network or hardware
               failure etc.
    
           PAM_SUCCESS
               The authentication token was successfully updated.
    
           PAM_USER_UNKNOWN
               The supplied username is not known to the authentication
               service.
    
           PAM_MAXTRIES
               One or more of the authentication modules has reached its
               limit of tries authenticating the user. Do not try again.
    


* * *
# mitem_opts

## NAME



           **set_item_opts** , **item_opts_on** , **item_opts_off** , **item_opts** - set and
           get menu item options
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_item_opts(ITEM ***_item_**, Item_Options** _opts_**);**
           **Item_Options item_opts(const ITEM ***_item_**);**
    
           **int item_opts_on(ITEM ***_item_**, Item_Options** _opts_**);**
           **int item_opts_off(ITEM ***_item_**, Item_Options** _opts_**);**
    


## DESCRIPTION



           The function **set_item_opts** sets all the given item's option bits
           (menu option bits may be logically-OR'ed together).
    
           The function **item_opts_on** turns on the given option bits, and
           leaves others alone.
    
           The function **item_opts_off** turns off the given option bits, and
           leaves others alone.
    
           The function **item_opts** returns the item's current option bits.
    
           There is only one defined option bit mask, **O_SELECTABLE**.  When
           this is on, the item may be selected during menu processing.  This
           option defaults to on.
    


## RETURN VALUE



           Except for **item_opts** , each routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    


* * *
# rdma_get_dst_port

## NAME



           rdma_get_dst_port - Returns the remote port number of a bound
           rdma_cm_id.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **uint16_t rdma_get_dst_port (struct rdma_cm_id ***_id_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Returns the remote port number for an rdma_cm_id that has been
           bound to a remote address.
    


## RETURN VALUE



           Returns the 16-bit port identifier associated with the peer
           endpoint.  If the rdma_cm_id is not connected, the returned value
           is 0.
    


* * *
# audit_request_rules_list_data

## NAME



           audit_request_rules_list_data - Request list of current audit
           rules
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_request_rules_list_data(int** _fd);"_
    


## DESCRIPTION



           audit_request_rules_list_data sends a request to the kernel to
           list the current audit rules. The rules are sent back one after
           another after this request is issued.
    


## RETURN VALUE



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


* * *
# function::user_ushort_error

## NAME



           function::user_ushort_error - Retrieves an unsigned short value
           stored in user space
    


## SYNOPSIS



               user_ushort_error:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the unsigned short from
    


## DESCRIPTION



           Returns the unsigned short value from a given user space address.
           If the user space data is not accessible, an error will occur.
    


* * *
# audit_set_pid

## NAME



           audit_set_pid - Set audit daemon process ID
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_pid(int** _fd_**, uint32_t** _pid_**, rep_wait_t** _wmode_**);"**
    


## DESCRIPTION



           audit_set_pid tells the kernel what the pid is of the audit
           daemon. The _fd_ argument is an open descriptor to the audit netlink
           socket. When _pid_ is set to 0, the kernel will log all events to
           syslog. Otherwise it will try to send events to the netlink
           connection that has the same _pid_ given by this function. If for
           some reason the process goes away, the kernel will automatically
           set the value to 0 itself. Usually this function is called by the
           audit daemon and not an external program. If _wmode_ is WAIT_YES,
           the function will wait for an ACK from the kernel.
    


## RETURN VALUE



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


* * *
# io_uring_register_iowq_max_workers

## NAME



           io_uring_register_iowq_max_workers - modify the maximum allowed
           async workers
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_iowq_max_workers(struct io_uring ***_ring_**,**
                                                  **unsigned int ***_values_**);**
    


## DESCRIPTION



           io_uring async workers are split into two types:
    
           **Bounded**
                  These workers have a bounded execution time. Examples of
                  that are filesystem reads, which normally complete in a
                  relatively short amount of time. In case of disk failures,
                  they are still bounded by a timeout operation that will
                  abort them if exceeded.
    
           **Unbounded**
                  Work items here may take an indefinite amount of time to
                  complete. Examples include doing IO to sockets, pipes, or
                  any other non-regular type of file.
    
           By default, the amount of bounded IO workers is limited to how
           many SQ entries the ring was setup with, or 4 times the number of
           online CPUs in the system, whichever is smaller. Unbounded workers
           are only limited by the process task limit, as indicated by the
           rlimit **RLIMIT_NPROC** limit.
    
           This can be modified by calling **io_uring_register_iowq_max_workers**
           with _ring_ set to the ring in question, and _values_ pointing to an
           array of two values. The first element should contain the number
           of desired bounded workers, and the second element should contain
           the number of desired unbounded workers. These are both maximum
           values, io_uring will not maintain a high count of idle workers,
           they are reaped when they are not necessary anymore.
    
           If called with both values set to 0, the existing values are
           returned.
    


## RETURN VALUE



           Returns **0** on success, with _values_ containing the previous values
           for the settings. On error, any of the following may be returned.
    
           **-EFAULT**
                  The kernel was unable to copy the memory pointer to by
                  _values_ as it was invalid.
    
           **-EINVAL**
                  _values_ was **NULL** or the new values exceeded the maximum
                  allowed value.
    


* * *
# strcoll

## NAME



           strcoll - compare two strings using the current locale
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **int strcoll(const char ***_s1_**, const char ***_s2_**);**
    


## DESCRIPTION



           The **strcoll**() function compares the two strings _s1_ and _s2_.  It
           returns an integer less than, equal to, or greater than zero if _s1_
           is found, respectively, to be less than, to match, or be greater
           than _s2_.  The comparison is based on strings interpreted as
           appropriate for the program's current locale for category
           **LC_COLLATE**.  (See setlocale(3).)
    


## RETURN VALUE



           The **strcoll**() function returns an integer less than, equal to, or
           greater than zero if _s1_ is found, respectively, to be less than,
           to match, or be greater than _s2_ , when both are interpreted as
           appropriate for the current locale.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           In the _POSIX_ or _C_ locales **strcoll**() is equivalent to strcmp(3).
    


* * *
# gnutls_db_set_retrieve_function

## NAME



           gnutls_db_set_retrieve_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_db_set_retrieve_function(gnutls_session_t** _session_**,**
           **gnutls_db_retr_func** _retr_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_db_retr_func retr_func
                       is the function.
    


## DESCRIPTION



           Sets the function that will be used to retrieve data from the
           resumed sessions database.  This function must return a
           gnutls_datum_t containing the data on success, or a gnutls_datum_t
           containing null and 0 on failure.
    
           The datum's data must be allocated using the function
           **gnutls_malloc()**.
    
           The first argument to  _retr_func_ will be null unless
           **gnutls_db_set_ptr()** has been called.
    


* * *
# gnutls_dh_set_prime_bits

## NAME



           gnutls_dh_set_prime_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_dh_set_prime_bits(gnutls_session_t** _session_**, unsigned**
           **int** _bits_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int bits
                       is the number of bits
    


## DESCRIPTION



           This function sets the number of bits, for use in a Diffie-Hellman
           key exchange.  This is used both in DH ephemeral and DH anonymous
           cipher suites.  This will set the minimum size of the prime that
           will be used for the handshake.
    
           In the client side it sets the minimum accepted number of bits.
           If a server sends a prime with less bits than that
           **GNUTLS_E_DH_PRIME_UNACCEPTABLE** will be returned by the handshake.
    
           Note that this function will warn via the audit log for value that
           are believed to be weak.
    
           The function has no effect in server side.
    
           Note that since 3.1.7 this function is deprecated. The minimum
           number of bits is set by the priority string level.  Also this
           function must be called after **gnutls_priority_set_direct()** or the
           set value may be overridden by the selected priority options.
    


* * *
# pthread_mutex_init

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



           pthread_mutex_init — destroy and initialize a mutex
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutex_init(pthread_mutex_t *restrict _mutex_ ,
               const pthread_mutexattr_t *restrict _attr_);
           pthread_mutex_t _mutex_ = PTHREAD_MUTEX_INITIALIZER;
    


## DESCRIPTION



           Refer to pthread_mutex_destroy(3p).
    


* * *
# libpfm_intel_skx_unc_upi

## NAME



           libpfm_intel_skx_unc_upi - support for Intel Skylake X Server UPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_upi[0-2]**
           **PMU desc: Intel Skylake X Server UPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X Server UPI uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Skylake X server
           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 QPI cycles 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 meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


## BASIC_HDR_MATCH events



           The library also supports the special **RXL_BASIC_HDR_MATCH** and
           **TXL_BASIC_HDR_MATCH** opcode matcher events. These events have a lot
           more filters available in the form of either a modifier (listed
           below) or specific umasks.  The following modifiers are available
           in additional to the standard listed above:
    
           **rcsnid** Specify a RCS Node identifier as an integer in the range
                  [0-15]. Default: 0
    
           **dnid** Specify a destination Node identifier as an integer in the
                  range [0-15]. Default: 0
    


* * *
# gnutls_certificate_verification_status_print

## NAME



           gnutls_certificate_verification_status_print - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_certificate_verification_status_print(unsigned int**
           _status_**, gnutls_certificate_type_t** _type_**, gnutls_datum_t ***_out_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           unsigned int status
                       The status flags to be printed
    
           gnutls_certificate_type_t type
                       The certificate type
    
           gnutls_datum_t * out
                       Newly allocated datum with (0) terminated string.
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will pretty print the status of a verification
           process -- eg. the one obtained by
           **gnutls_certificate_verify_peers3()**.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.1.4
    


* * *
# pthread_setconcurrency

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



           pthread_setconcurrency — set the level of concurrency
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_setconcurrency(int _new_level_);
    


## DESCRIPTION



           Refer to pthread_getconcurrency(3p).
    


* * *