tripathysagar/man_text huggingface dataset:
# gnutls_pkcs12_mac_info

## NAME



           gnutls_pkcs12_mac_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_mac_info(gnutls_pkcs12_t** _pkcs12_**, unsigned int ***
           _mac_**, void ***_salt_**, unsigned int ***_salt_size_**, unsigned int ***
           _iter_count_**, char ****_oid_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t pkcs12
                       A pkcs12 type
    
           unsigned int * mac
                       the MAC algorithm used as **gnutls_mac_algorithm_t**
    
           void * salt the salt used for string to key (if non-NULL then
                       _salt_size_ initially holds its size)
    
           unsigned int * salt_size
                       string to key salt size
    
           unsigned int * iter_count
                       string to key iteration count
    
           char ** oid if non-NULL it will contain an allocated
                       null-terminated variable with the OID
    


## DESCRIPTION



           This function will provide information on the MAC algorithm used
           in a PKCS **12** structure. If the structure algorithms are unknown
           the code **GNUTLS_E_UNKNOWN_HASH_ALGORITHM** will be returned, and
           only  _oid_ , will be set. That is,  _oid_ will be set on structures
           with a MAC whether supported or not. It must be deinitialized
           using **gnutls_free()**.  The other variables are only set on
           supported structures.
    


## RETURNS



           **GNUTLS_E_INVALID_REQUEST** if the provided structure doesn't contain
           a MAC, **GNUTLS_E_UNKNOWN_HASH_ALGORITHM** if the structure's MAC
           isn't supported, or another negative error code in case of a
           failure. Zero on success.
    


* * *
# sd_bus_is_open

## NAME



           sd_bus_is_open, sd_bus_is_ready - Check whether the bus connection
           is open or ready
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_is_open(sd_bus ***_bus_**);**
    
           **int sd_bus_is_ready(sd_bus ***_bus_**);**
    


## DESCRIPTION



           **sd_bus_is_open()** checks whether the specified bus connection is
           open, i.e. in the process of being established, already
           established or in the process of being torn down. It returns zero
           when the connection has not been started yet (i.e.
           sd_bus_start(3) or some equivalent call has not been invoked yet),
           or is fully terminated again (for example after sd_bus_close(3)),
           it returns positive otherwise.
    
           **sd_bus_is_ready()** checks whether the specified connection is fully
           established, i.e. completed the connection and authentication
           phases of the protocol and received the **Hello()** method call
           response, and is not in the process of being torn down again. It
           returns zero outside of this state, and positive otherwise.
           Effectively, this function returns positive while regular messages
           can be sent or received on the connection.
    
           The _bus_ argument may be **NULL** , zero is also returned in that case.
    
           To be notified when the connection is fully established, use
           sd_bus_set_connected_signal(3) and install a match for the
           **Connected()** signal on the "org.freedesktop.DBus.Local" interface.
           To be notified when the connection is torn down again, install a
           match for the **Disconnected()** signal on the
           "org.freedesktop.DBus.Local" interface.
    


## RETURN VALUE



           Those functions return 0 if the bus is _not_ in the given state, and
           a positive integer when it is. On failure, a negative errno-style
           error code is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ECHILD**
               The bus connection has been created in a different process,
               library or module instance.
    


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


* * *
# function::pnlabel

## NAME



           function::pnlabel - Returns the label name parsed from the probe
           name
    


## SYNOPSIS



               pnlabel:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This returns the label name as parsed from the script-level probe
           point. This function will only work if called directly from the
           body of a '.label' probe point (i.e. no aliases).
    


## CONTEXT



           The current probe point.
    


* * *
# iswprint

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



           iswprint, iswprint_l — test for a printable wide-character code
    


## SYNOPSIS



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


## DESCRIPTION



           For _iswprint_(): The functionality described on this reference page
           is aligned with the ISO C standard. Any conflict between the
           requirements described here and the ISO C standard is
           unintentional. This volume of POSIX.1‐2017 defers to the ISO C
           standard.
    
           The _iswprint_() and _iswprint_l_() functions shall test whether _wc_ is
           a wide-character code representing a character of class **print** in
           the current locale, or in the locale represented by _locale_ ,
           respectively; see the Base Definitions volume of POSIX.1‐2017,
           _Chapter 7_ , _Locale_.
    
           The _wc_ argument is a **wint_t** , the value of which the application
           shall ensure is a wide-character code corresponding to a valid
           character in the locale used by the function, or equal to the
           value of the macro WEOF. If the argument has any other value, the
           behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _iswprint_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _iswprint_() and _iswprint_l_() functions shall return non-zero if
           _wc_ is a printable wide-character code; otherwise, they shall
           return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# MAX

## NAME



           MAX, MIN - maximum or minimum of two values
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/param.h>**
    
           **MAX(**_a_**,**_b_**);**
           **MIN(**_a_**,**_b_**);**
    


## DESCRIPTION



           These macros return the maximum or minimum of _a_ and _b_.
    


## RETURN VALUE



           These macros return the value of one of their arguments, possibly
           converted to a different type (see BUGS).
    


## ERRORS



           These macros may raise the "invalid" floating-point exception when
           any of the arguments is NaN.
    


## STANDARDS



           GNU, BSD.
    


## NOTES



           If either of the arguments is of a floating-point type, you might
           prefer to use fmax(3) or fmin(3), which can handle NaN.
    
           The arguments may be evaluated more than once, or not at all.
    
           Some UNIX systems might provide these macros in a different
           header, or not at all.
    


## BUGS



           Due to the usual arithmetic conversions, the result of these
           macros may be very different from either of the arguments.  To
           avoid this, ensure that both arguments have the same type.
    


## EXAMPLES



           #include <stdio.h>
           #include <stdlib.h>
           #include <sys/param.h>
    
           int
           main(int argc, char *argv[])
           {
               int a, b, x;
    
               if (argc != 3) {
                   fprintf(stderr, "Usage: %s <num> <num>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }
    
               a = atoi(argv[1]);
               b = atoi(argv[2]);
               x = MAX(a, b);
               printf("MAX(%d, %d) is %d\n", a, b, x);
    
               exit(EXIT_SUCCESS);
           }
    


* * *
# gnutls_privkey_import_pkcs11_url

## NAME



           gnutls_privkey_import_pkcs11_url - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_pkcs11_url(gnutls_privkey_t** _key_**, const**
           **char ***_url_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       A key of type **gnutls_pubkey_t**
    
           const char * url
                       A PKCS 11 url
    


## DESCRIPTION



           This function will import a PKCS 11 private key to a
           **gnutls_privkey_t** type.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# gnutls_cipher_decrypt

## NAME



           gnutls_cipher_decrypt - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_cipher_hd_t handle
                       is a **gnutls_cipher_hd_t** type
    
           void * ctext
                       the data to decrypt
    
           size_t ctext_len
                       the length of data to decrypt
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           specified by the context.
    
           Note that in AEAD ciphers, this will not check the tag. You will
           need to compare the tag sent with the value returned from
           **gnutls_cipher_tag()**.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# isxdigit

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



           isxdigit, isxdigit_l — test for a hexadecimal digit
    


## SYNOPSIS



           #include <ctype.h>
    
           int isxdigit(int _c_);
           int isxdigit_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isxdigit_(): The functionality described on this reference page
           is aligned with the ISO C standard. Any conflict between the
           requirements described here and the ISO C standard is
           unintentional. This volume of POSIX.1‐2017 defers to the ISO C
           standard.
    
           The _isxdigit_() and _isxdigit_l_() functions shall test whether _c_ is
           a character of class **xdigit** in the current locale, or in the
           locale represented by _locale_ , respectively; see the Base
           Definitions volume of POSIX.1‐2017, _Chapter 7_ , _Locale_.
    
           The _c_ argument is an **int** , the value of which the application shall
           ensure is a character representable as an **unsigned char** or equal
           to the value of the macro EOF. If the argument has any other
           value, the behavior is undefined.
    
           The behavior is undefined if the _locale_ argument to _isxdigit_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isxdigit_() and _isxdigit_l_() functions shall return non-zero if
           _c_ is a hexadecimal digit; otherwise, they shall return 0.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



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


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_certificate_set_known_dh_params

## NAME



           gnutls_certificate_set_known_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_known_dh_params(gnutls_certificate_credentials_t**
           _res_**, gnutls_sec_param_t** _sec_param_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a gnutls_certificate_credentials_t type
    
           gnutls_sec_param_t sec_param
                       is an option of the **gnutls_sec_param_t** enumeration
    


## DESCRIPTION



           This function will set the Diffie-Hellman parameters for a
           certificate server to use. These parameters will be used in
           Ephemeral Diffie-Hellman cipher suites and will be selected from
           the FFDHE set of RFC7919 according to the security level provided.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


## RETURNS



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


## SINCE



           3.5.6
    


* * *
# capng_apply

## NAME



           capng_apply - apply the stored capabilities settings
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_apply(capng_select_t set);
    


## DESCRIPTION



           capng_apply will transfer the specified internal POSIX
           capabilities settings to the kernel. The options are
           CAPNG_SELECT_CAPS for the traditional capabilities,
           CAPNG_SELECT_BOUNDS for the bounding set, CAPNG_SELECT_BOTH if
           transferring both is desired, CAPNG_SELECT_AMBIENT if only
           operating on the ambient capabilities, or CAPNG_SELECT_ALL if
           applying all is desired.
    


## RETURN VALUE



           This returns 0 on success and a negative value on failure. The
           values are:
    
                  -1 not initialized
    
                  -2 CAPNG_SELECT_BOUNDS and failure to drop a bounding set
                  capability
    
                  -3 CAPNG_SELECT_BOUNDS and failure to re-read bounding set
    
                  -4 CAPNG_SELECT_BOUNDS and process does not have
                  CAP_SETPCAP
    
                  -5 CAPNG_SELECT_CAPS and failure in capset syscall
    
                  -6 CAPNG_SELECT_AMBIENT and process has no capabilities and
                  failed clearing ambient capabilities
    
                  -7 CAPNG_SELECT_AMBIENT and process has capabilities and
                  failed clearing ambient capabilities
    
                  -8 CAPNG_SELECT_AMBIENT and process has capabilities and
                  failed setting an ambient capability
    
                  -9 Unable to acquire process capabilities to check if
                  CAP_SETPCAP is set.
    


## NOTES



           If you are doing multi-threaded programming, calling this function
           will only set capabilities on the calling thread. All other
           threads are unaffected. If you want to set overall capabilities
           for a multi-threaded process, you will need to do that before
           creating any threads. See the capset syscall for more information
           on this topic.
    
           Also, bits in the bounding set can only be dropped. You cannot set
           them. After dropping bounding set capabilities, the bounding set
           is synchronized with the kernel to reflect the true state in the
           kernel.
    


* * *
# mlx5dv_dump_dr_domain

## NAME



           mlx5dv_dump_dr_domain - Dump DR Domain
    
           mlx5dv_dump_dr_table - Dump DR Table
    
           mlx5dv_dump_dr_matcher - Dump DR Matcher
    
           mlx5dv_dump_dr_rule - Dump DR Rule
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_dump_dr_domain(FILE *fout, struct mlx5dv_dr_domain *domain);
                  int mlx5dv_dump_dr_table(FILE *fout, struct mlx5dv_dr_table *table);
                  int mlx5dv_dump_dr_matcher(FILE *fout, struct mlx5dv_dr_matcher *matcher);
                  int mlx5dv_dump_dr_rule(FILE *fout, struct mlx5dv_dr_rule *rule);
    


## DESCRIPTION



           The Dump API (mlx5dv_dump_*) allows the dumping of the existing
           rdma-core resources to the provided file.  The output file format
           is vendor specific.
    
           _mlx5dv_dump_dr_domain()_ dumps a DR Domain object properties to a
           specified file.
    
           _mlx5dv_dump_dr_table()_ dumps a DR Table object properties to a
           specified file.
    
           _mlx5dv_dump_dr_matcher()_ dumps a DR Matcher object properties to a
           specified file.
    
           _mlx5dv_dump_dr_rule()_ dumps a DR Rule object properties to a
           specified file.
    


## RETURN VALUE



           The API calls returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).  The calls are
           blocking - function returns only when all related resources info
           is written to the file.
    


* * *
# probe::socket.read_iter

## NAME



           probe::socket.read_iter - Receiving message via **sock_read_iter**
    


## SYNOPSIS



           socket.read_iter
    


## VALUES



           _state_
               Socket state value
    
           _type_
               Socket type value
    
           _protocol_
               Protocol value
    
           _size_
               Message size in bytes
    
           _name_
               Name of this probe
    
           _family_
               Protocol family value
    
           _flags_
               Socket flags value
    


## CONTEXT



           The message sender
    


## DESCRIPTION



           Fires at the beginning of receiving a message on a socket via the
           **sock_read_iter** function
    


* * *
# gnutls_x509_privkey_set_flags

## NAME



           gnutls_x509_privkey_set_flags - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_privkey_set_flags(gnutls_x509_privkey_t** _key_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       A key of type **gnutls_x509_privkey_t**
    
           unsigned int flags
                       flags from the **gnutls_privkey_flags**
    


## DESCRIPTION



           This function will set flags for the specified private key, after
           it is generated. Currently this is useful for the
           **GNUTLS_PRIVKEY_FLAG_EXPORT_COMPAT** to allow exporting a "provable"
           private key in backwards compatible way.
    


## SINCE



           3.5.0
    


* * *
# rewinddir

## NAME



           rewinddir - reset directory stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <dirent.h>**
    
           **void rewinddir(DIR ***_dirp_**);**
    


## DESCRIPTION



           The **rewinddir**() function resets the position of the directory
           stream _dirp_ to the beginning of the directory.
    


## RETURN VALUE



           The **rewinddir**() function returns no value.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# gnutls_x509_privkey_generate2

## NAME



           gnutls_x509_privkey_generate2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_generate2(gnutls_x509_privkey_t** _key_**,**
           **gnutls_pk_algorithm_t** _algo_**, unsigned int** _bits_**, unsigned int** _flags_**,**
           **const gnutls_keygen_data_st ***_data_**, unsigned** _data_size_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       a key
    
           gnutls_pk_algorithm_t algo
                       is one of the algorithms in **gnutls_pk_algorithm_t**.
    
           unsigned int bits
                       the size of the modulus
    
           unsigned int flags
                       Must be zero or flags from **gnutls_privkey_flags_t**.
    
           const gnutls_keygen_data_st * data
                       Allow specifying **gnutls_keygen_data_st** types such as
                       the seed to be used.
    
           unsigned data_size
                       The number of  _data_ available.
    


## 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. On DSA keys the PQG parameters are generated using the seed,
           while on RSA the two primes. To specify an explicit seed (by
           default a random seed is used), use the  _data_ with a
           **GNUTLS_KEYGEN_SEED** type.
    
           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.
    
           To export the generated keys in memory or in files it is
           recommended to use the PKCS**8** form as it can handle all key types,
           and can store additional parameters such as the seed, in case of
           provable RSA or DSA keys.  Generated keys can be exported in
           memory using **gnutls_privkey_export_x509()** , and then with
           **gnutls_x509_privkey_export2_pkcs8()**.
    
           If key generation is part of your application, avoid setting the
           number of bits directly, and instead use
           **gnutls_sec_param_to_pk_bits()**.  That way the generated keys will
           adapt to the security levels of the underlying GnuTLS library.
    
           See also **gnutls_privkey_generate2()**.
    


## RETURNS



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


* * *
# function::task_gid

## NAME



           function::task_gid - The group identifier of the task
    


## SYNOPSIS



               task_gid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the group id of the given task.
    


* * *
# faccessat

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



           faccessat — determine accessibility of a file relative to
           directory file descriptor
    


## SYNOPSIS



           #include <unistd.h>
    
           int faccessat(int _fd_ , const char *_path_ , int _amode_ , int _flag_);
    


## DESCRIPTION



           Refer to access(3p).
    


* * *
# acl_get_permset

## NAME



           **acl_get_permset** — retrieve the permission set from an ACL entry
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_get_permset**(_acl_entry_t entry_d_ ,
           _acl_permset_t *permset_p_)
    


## DESCRIPTION



           The **acl_get_permset**() function returns in _permset_p_ a descriptor
           to the permission set in the ACL entry indicated by _entry_d_.
           Subsequent operations using the returned permission set descriptor
           operate on the permission set within the ACL entry.
    
           Any ACL entry descriptors that refer to the entry referred to by
           _entry_d_ shall continue to refer to those entries.
    


## RETURN VALUE



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


## ERRORS



           If any of the following conditions occur, the **acl_get_permset**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _entry_d_ is not a valid descriptor
                              for an ACL entry.
    


## STANDARDS



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


* * *
# gnutls_group_get

## NAME



           gnutls_group_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_group_t gnutls_group_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Returns the currently used group for key exchange. Only valid when
           using an elliptic curve or DH ciphersuite.
    


## RETURNS



           the currently used group, a **gnutls_group_t** type.
    


## SINCE



           3.6.0
    


* * *
# munlockall

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



           munlockall — unlock the address space of a process
    


## SYNOPSIS



           #include <sys/mman.h>
    
           int munlockall(void);
    


## DESCRIPTION



           Refer to mlockall(3p).
    


* * *
# fgetpwent

## NAME



           fgetpwent - get password file entry
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
           **#include <sys/types.h>**
           **#include <pwd.h>**
    
           **struct passwd *fgetpwent(FILE ***_stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **fgetpwent**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _SVID_SOURCE
    


## DESCRIPTION



           The **fgetpwent**() function returns a pointer to a structure
           containing the broken out fields of a line in the file _stream_.
           The first time it is called it returns the first entry;
           thereafter, it returns successive entries.  The file referred to
           by _stream_ must have the same format as _/etc/passwd_ (see
           passwd(5)).
    
           The _passwd_ structure is defined in _< pwd.h>_ as follows:
    
               struct passwd {
                   char   *pw_name;       /* username */
                   char   *pw_passwd;     /* user password */
                   uid_t   pw_uid;        /* user ID */
                   gid_t   pw_gid;        /* group ID */
                   char   *pw_gecos;      /* real name */
                   char   *pw_dir;        /* home directory */
                   char   *pw_shell;      /* shell program */
               };
    


## RETURN VALUE



           The **fgetpwent**() function returns a pointer to a _passwd_ structure,
           or NULL if there are no more entries or an error occurs.  In the
           event of an error, _errno_ is set to indicate the error.
    


## ERRORS



           **ENOMEM** Insufficient memory to allocate _passwd_ structure.
    


## FILES



           _/etc/passwd_
                  password database file
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# gnutls_ocsp_resp_init

## NAME



           gnutls_ocsp_resp_init - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_init(gnutls_ocsp_resp_t ***_resp_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_t * resp
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize an OCSP response structure.
    


## RETURNS



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


* * *
# pthread_rwlock_wrlock

## 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_rwlock_wrlock — lock a read-write lock object for writing
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_rwlock_wrlock(pthread_rwlock_t *_rwlock_);
    


## DESCRIPTION



           Refer to pthread_rwlock_trywrlock(3p).
    


* * *
# double_t

## NAME



           float_t, double_t - most efficient floating types
    


## LIBRARY



           Math library (_libm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **typedef** /* ... */ **float_t;**
           **typedef** /* ... */ **double_t;**
    


## DESCRIPTION



           The implementation's most efficient floating types at least as
           wide as _float_ and _double_ respectively.  Their type depends on the
           value of the macro **FLT_EVAL_METHOD**(defined in _< float.h>_):
    
           **FLT_EVAL_METHOD** _float_t_      _double_t_
           ────────────────────────────────────────────
                  0                _float_        _double_
                  1               _double_        _double_
                  2          _long double_   _long double_
    
           For other values of **FLT_EVAL_METHOD** , the types of _float_t_ and
           _double_t_ are implementation-defined.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_x509_crl_get_raw_issuer_dn

## NAME



           gnutls_x509_crl_get_raw_issuer_dn - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_raw_issuer_dn(gnutls_x509_crl_t** _crl_**,**
           **gnutls_datum_t ***_dn_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           gnutls_datum_t * dn
                       will hold the starting point of the DN
    


## DESCRIPTION



           This function will return a pointer to the DER encoded DN
           structure and the length.
    


## RETURNS



           a negative error code on error, and (0) on success.
    


## SINCE



           2.12.0
    


* * *
# io_uring_unregister_buf_ring

## NAME



           io_uring_unregister_buf_ring - unregister a previously registered
           buffer ring
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_unregister_buf_ring(struct io_uring ***_ring_**,**
                                            **int** _bgid_**);**
    


## DESCRIPTION



           The io_uring_unregister_buf_ring(3) function unregisters a
           previously registered shared buffer ring indicated by _bgid_.
    


## RETURN VALUE



           On success io_uring_unregister_buf_ring(3) returns 0. On failure
           it returns **-errno**.
    


* * *
# round

## NAME



           round, roundf, roundl - round to nearest integer, away from zero
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double round(double** _x_**);**
           **float roundf(float** _x_**);**
           **long double roundl(long double** _x_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **round**(), **roundf**(), **roundl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    


## DESCRIPTION



           These functions round _x_ to the nearest integer, but round halfway
           cases away from zero (regardless of the current rounding
           direction, see fenv(3)), instead of to the nearest even integer
           like rint(3).
    
           For example, _round(0.5)_ is 1.0, and _round(-0.5)_ is -1.0.
    


## RETURN VALUE



           These functions return the rounded integer value.
    
           If _x_ is integral, +0, -0, NaN, or infinite, _x_ itself is returned.
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# gnutls_session_ext_register

## NAME



           gnutls_session_ext_register - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_ext_register(gnutls_session_t** _session_**, const**
           **char ***_name_**, int** _id_**, gnutls_ext_parse_type_t** _parse_point_**,**
           **gnutls_ext_recv_func** _recv_func_**, gnutls_ext_send_func** _send_func_**,**
           **gnutls_ext_deinit_data_func** _deinit_func_**, gnutls_ext_pack_func**
           _pack_func_**, gnutls_ext_unpack_func** _unpack_func_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       the session for which this extension will be set
    
           const char * name
                       the name of the extension to register
    
           int id      the numeric id of the extension
    
           gnutls_ext_parse_type_t parse_point
                       the parse type of the extension (see
                       gnutls_ext_parse_type_t)
    
           gnutls_ext_recv_func recv_func
                       a function to receive the data
    
           gnutls_ext_send_func send_func
                       a function to send the data
    
           gnutls_ext_deinit_data_func deinit_func
                       a function deinitialize any private data
    
           gnutls_ext_pack_func pack_func
                       a function which serializes the extension's private
                       data (used on session packing for resumption)
    
           gnutls_ext_unpack_func unpack_func
                       a function which will deserialize the extension's
                       private data
    
           unsigned flags
                       must be zero or flags from **gnutls_ext_flags_t**
    


## DESCRIPTION



           This function will register a new extension type. The extension
           will be only usable within the registered session. If the
           extension type is already registered then
           **GNUTLS_E_ALREADY_REGISTERED** will be returned, unless the flag
           **GNUTLS_EXT_FLAG_OVERRIDE_INTERNAL** is specified. The latter flag
           when specified can be used to override certain extensions
           introduced after 3.6.0. It is expected to be used by applications
           which handle custom extensions that are not currently supported in
           GnuTLS, but direct support for them may be added in the future.
    
           Each registered extension can store temporary data into the
           gnutls_session_t structure using **gnutls_ext_set_data()** , and they
           can be retrieved using **gnutls_ext_get_data()**.
    
           The validity of the extension registered can be given by the
           appropriate flags of **gnutls_ext_flags_t**. If no validity is given,
           then the registered extension will be valid for client and TLS1.2
           server hello (or encrypted extensions for TLS1.3).
    


## RETURNS



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


## SINCE



           3.5.5
    


* * *
# pmnameid

## NAME



           **pmNameID** - translate a PMID to a performance metric name
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmNameID(pmID** _pmid_**, char ****_name_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Given  a  Performance  Metric Identifier (PMID) via _pmid_ , **pmNameID**
           will determine the corresponding metric name, if any, in the  Per‐
           formance Metrics Name Space (PMNS), and return this via _name_.
    
           If  the PMNS contains multiple names associated with the requested
           PMID, one of these will be returned via _name_ , but there is no  way
           to  determine  which  of  the  duplicate  names this will be.  See
           pmNameAll(3) if all of the corresponding names are required.
    
           As of Version 3.10.3 of PCP, duplicate names for the same PMID **are**
           allowed in the PMNS, so using pmNameAll(3) is recommended over **pm‐**
           **NameID**.
    
           _name_ is a null-byte terminated string, allocated by **pmNameID** using
           malloc(3) and it is the caller's responsibility to call free(3) to
           release the storage when the value is no longer required.
    
           In the absence of errors, **pmNameID** returns zero.
    


## DIAGNOSTICS



           **PM_ERR_NOPMNS**
                  Failed to access a PMNS for operation.  Note that if the
                  application hasn't a priori called pmLoadNameSpace(3) and
                  wants to use the distributed PMNS, then a call to **pmNameID**
                  must be made after the creation of a context (see
                  pmNewContext(3)).
    
           **PM_ERR_PMID**
                  _pmid_ does not correspond to a defined PMID in the PMNS.
    
           **PM_ERR_***
                  Other diagnostics are for protocol failures when accessing
                  the distributed PMNS.
    


* * *
# strlen

## NAME



           strlen - calculate the length of a string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **size_t strlen(const char ***_s_**);**
    


## DESCRIPTION



           The **strlen**() function calculates the length of the string pointed
           to by _s_ , excluding the terminating null byte ('\0').
    


## RETURN VALUE



           The **strlen**() function returns the number of bytes in the string
           pointed to by _s_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           In cases where the input buffer may not contain a terminating null
           byte, strnlen(3) should be used instead.
    


* * *
# gnutls_priority_deinit

## NAME



           gnutls_priority_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_priority_deinit(gnutls_priority_t** _priority_cache_**);**
    


## ARGUMENTS



           gnutls_priority_t priority_cache
                       is a **gnutls_priority_t** type.
    


## DESCRIPTION



           Deinitializes the priority cache.
    


* * *
# function::task_dentry_path

## NAME



           function::task_dentry_path - get the full dentry path
    


## SYNOPSIS



               task_dentry_path:string(task:long,dentry:long,vfsmnt:long)
    


## ARGUMENTS



           _task_
               task_struct pointer.
    
           _dentry_
               direntry pointer.
    
           _vfsmnt_
               vfsmnt pointer.
    


## DESCRIPTION



           Returns the full dirent name (full path to the root), like the
           kernel d_path function.
    


* * *
# gnutls_sign_algorithm_get_requested

## NAME



           gnutls_sign_algorithm_get_requested - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_sign_algorithm_get_requested(gnutls_session_t** _session_**,**
           **size_t** _indx_**, gnutls_sign_algorithm_t ***_algo_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t indx is an index of the signature algorithm to return
    
           gnutls_sign_algorithm_t * algo
                       the returned certificate type will be stored there
    


## DESCRIPTION



           Returns the signature algorithm specified by index that was
           requested by the peer. If the specified index has no data
           available this function returns
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE**.  If the negotiated TLS
           version does not support signature algorithms then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned even for
           the first index.  The first index is 0.
    
           This function is useful in the certificate callback functions to
           assist in selecting the correct certificate.
    


## RETURNS



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


## SINCE



           2.10.0
    


* * *
# wcsncat

## NAME



           wcsncat - concatenate two wide-character strings
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **wcsncat**() function is the wide-character equivalent of the
           strncat(3) function.  It copies at most _n_ wide characters from the
           wide-character string pointed to by _src_ to the end of the wide-
           character string pointed to by _dest_ , and adds a terminating null
           wide character (L'\0').
    
           The strings may not overlap.
    
           The programmer must ensure that there is room for at least
           _wcslen(dest)_ +_n_ +1 wide characters at _dest_.
    


## RETURN VALUE



           **wcsncat**() returns _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pmprintlabelsets

## NAME



           **pmPrintLabelSets** - print an array of label sets
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmPrintLabelSets(FILE ***_f_**, int** _ident_**, int** _type_**,**
                                 **pmLabelSet ***_sets_**, int** _nsets_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Display  all elements of the Performance Metrics LabelSet _sets_ as‐
           sociated with identifier _ident_ of hierarchy level  _type_.   on  the
           output stream _f_.
    


* * *
# gnutls_session_get_master_secret

## NAME



           gnutls_session_get_master_secret - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_session_get_master_secret(gnutls_session_t** _session_**,**
           **gnutls_datum_t ***_secret_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_datum_t * secret
                       the session's master secret
    


## DESCRIPTION



           This function returns pointers to the master secret used in the
           TLS session. The pointers are not to be modified or deallocated.
    
           This function is only applicable under TLS 1.2 or earlier
           versions.
    


## SINCE



           3.5.0
    


* * *