tripathysagar/man_text huggingface dataset:
# ll2_rename_user

## NAME



           ll2_rename_user - Renames a user entry.
    


## SYNOPSIS



           **#include <lastlog2.h>**
    
           **int ll2_rename_user (struct ll2_context ***_context_**, const char**
           *****_user_**, const char ***_newname_**, char ****_error_**);**
    


## DESCRIPTION



           Changes user name from _user_ to _newname_ of one entry in database,
           which is defined by _context_. All other entries with the user _user_
           will be deleted. If _context_ is NULL, the default database, defined
           in _LL2_DEFAULT_DATABASE_ , will be taken.
    
               char    *error = NULL;
               const   char *user = "root";
               const   char *new_user = "notroot";
    
               int ret = ll2_rename_user (NULL, user, new_user, &error);
    


## RETURN VALUE



           Returns 0 on success, -ENOMEM or -1 on other failure. _error_
           contains an error string if the return value is -1. _error_ is not
           guaranteed to contain an error string, could also be NULL. _error_
           should be freed by the caller.
    


## AVAILABILITY



           The **liblastlog2** library is part of the util-linux package since
           version 2.40. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-01-16             _LL2_RENAME_USER_(3)
    


* * *
# function::set_user_int

## NAME



           function::set_user_int - Writes an int value to user memory
    


## SYNOPSIS



               set_user_int(addr:long,val:long)
    


## ARGUMENTS



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


## DESCRIPTION



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


* * *
# gnutls_ocsp_resp_get_produced

## NAME



           gnutls_ocsp_resp_get_produced - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **time_t gnutls_ocsp_resp_get_produced(gnutls_ocsp_resp_const_t**
           _resp_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    


## DESCRIPTION



           This function will return the time when the OCSP response was
           signed.
    


## RETURNS



           signing time, or (time_t)-1 on error.
    


* * *
# pcap_dump

## NAME



           pcap_dump - write a packet to a capture file
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **void pcap_dump(u_char *user, struct pcap_pkthdr *h,**
               **u_char *sp);**
    


## DESCRIPTION



           **pcap_dump**() outputs a packet to the ``savefile'' opened with
           **pcap_dump_open**(3PCAP).  Note that its calling arguments are
           suitable for use with **pcap_dispatch**(3PCAP) or **pcap_loop**(3PCAP).
           If called directly, the _user_ parameter is of type **pcap_dumper_t** as
           returned by **pcap_dump_open**().
    


* * *
# gnutls_ocsp_resp_get_extension

## NAME



           gnutls_ocsp_resp_get_extension - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_extension(gnutls_ocsp_resp_const_t** _resp_**,**
           **unsigned** _indx_**, gnutls_datum_t ***_oid_**, unsigned int ***_critical_**,**
           **gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           unsigned indx
                       Specifies which extension OID to get. Use (0) to get
                       the first one.
    
           gnutls_datum_t * oid
                       will hold newly allocated buffer with OID of
                       extension, may be NULL
    
           unsigned int * critical
                       output variable with critical flag, may be NULL.
    
           gnutls_datum_t * data
                       will hold newly allocated buffer with extension data,
                       may be NULL
    


## DESCRIPTION



           This function will return all information about the requested
           extension in the OCSP response.  The information returned is the
           OID, the critical flag, and the data itself.  The extension OID
           will be stored as a string.  Any of  _oid_ ,  _critical_ , and  _data_
           may be NULL which means that the caller is not interested in
           getting that information back.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _oid_ ->data and  _data_ ->data.
    
           Since 3.7.0  _oid_ ->size does not account for the terminating null
           byte.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# probe::nfsd.proc.rename

## NAME



           probe::nfsd.proc.rename - NFS Server renaming a file for client
    


## SYNOPSIS



           nfsd.proc.rename
    


## VALUES



           _filename_
               old file name
    
           _fh_
               file handler of old path
    
           _tlen_
               length of new file name
    
           _tfh_
               file handler of new path
    
           _uid_
               requester's user id
    
           _tname_
               new file name
    
           _flen_
               length of old file name
    
           _gid_
               requester's group id
    
           _client_ip_
               the ip address of client
    


* * *
# cfsetispeed

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



           cfsetispeed — set input baud rate
    


## SYNOPSIS



           #include <termios.h>
    
           int cfsetispeed(struct termios *_termios_p_ , speed_t _speed_);
    


## DESCRIPTION



           The _cfsetispeed_() function shall set the input baud rate stored in
           the structure pointed to by _termios_p_ to _speed._
    
           There shall be no effect on the baud rates set in the hardware
           until a subsequent successful call to _tcsetattr_() with the same
           **termios** structure. Similarly, errors resulting from attempts to
           set baud rates not supported by the terminal device need not be
           detected until the _tcsetattr_() function is called.
    


## RETURN VALUE



           Upon successful completion, _cfsetispeed_() shall return 0;
           otherwise, -1 shall be returned, and _errno_ may be set to indicate
           the error.
    


## ERRORS



           The _cfsetispeed_() function may fail if:
    
           **EINVAL** The _speed_ value is not a valid baud rate.
    
           **EINVAL** The value of _speed_ is outside the range of possible speed
                  values as specified in _< termios.h>_.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to cfgetispeed(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crl_dist_points_set

## NAME



           gnutls_x509_crl_dist_points_set - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_crl_dist_points_set(gnutls_x509_crl_dist_points_t**
           _cdp_**, gnutls_x509_subject_alt_name_t** _type_**, const gnutls_datum_t ***
           _san_**, unsigned int** _reasons_**);**
    


## ARGUMENTS



           gnutls_x509_crl_dist_points_t cdp
                       The CRL distribution points
    
           gnutls_x509_subject_alt_name_t type
                       The type of the name (of **gnutls_subject_alt_names_t**)
    
           const gnutls_datum_t * san
                       The point name data
    
           unsigned int reasons
                       Revocation reasons. An ORed sequence of flags from
                       **gnutls_x509_crl_reason_flags_t**.
    


## DESCRIPTION



           This function will store the specified CRL distribution point
           value the  _cdp_ type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# pthread_attr_setschedparam

## 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_attr_setschedparam — set the schedparam attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_setschedparam(pthread_attr_t *restrict _attr_ ,
               const struct sched_param *restrict _param_);
    


## DESCRIPTION



           Refer to pthread_attr_getschedparam(3p).
    


* * *
# gnutls_pk_algorithm_get_name

## NAME



           gnutls_pk_algorithm_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_pk_algorithm_get_name(gnutls_pk_algorithm_t**
           _algorithm_**);**
    


## ARGUMENTS



           gnutls_pk_algorithm_t algorithm
                       is a pk algorithm
    


## DESCRIPTION



           Convert a **gnutls_pk_algorithm_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified public key
           algorithm, or **NULL**.
    


* * *
# gnutls_x509_crl_get_issuer_dn3

## NAME



           gnutls_x509_crl_get_issuer_dn3 - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a **gnutls_x509_crl_t** type
    
           gnutls_datum_t * dn
                       a pointer to a structure to hold the name; must be
                       freed using **gnutls_free()**
    
           unsigned flags
                       zero or **GNUTLS_X509_DN_FLAG_COMPAT**
    


## DESCRIPTION



           This function will allocate buffer and copy the name of the CRL
           issuer.  The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as
           described in RFC4514. The output string will be ASCII or UTF-8
           encoded, depending on the certificate data.
    
           When the flag **GNUTLS_X509_DN_FLAG_COMPAT** is specified, the output
           format will match the format output by previous to 3.5.6 versions
           of GnuTLS which was not not fully RFC4514-compliant.
    


## RETURNS



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


## SINCE



           3.5.7
    


* * *
# gnutls_cipher_suite_get_name

## NAME



           gnutls_cipher_suite_get_name - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_cipher_suite_get_name(gnutls_kx_algorithm_t**
           _kx_algorithm_**, gnutls_cipher_algorithm_t** _cipher_algorithm_**,**
           **gnutls_mac_algorithm_t** _mac_algorithm_**);**
    


## ARGUMENTS



           gnutls_kx_algorithm_t kx_algorithm
                       is a Key exchange algorithm
    
           gnutls_cipher_algorithm_t cipher_algorithm
                       is a cipher algorithm
    
           gnutls_mac_algorithm_t mac_algorithm
                       is a MAC algorithm
    


## DESCRIPTION



           This function returns the ciphersuite name under TLS1.2 or earlier
           versions when provided with individual algorithms. The full cipher
           suite name must be prepended by TLS or SSL depending of the
           protocol in use.
    
           To get a description of the current ciphersuite across versions,
           it is recommended to use **gnutls_session_get_desc()**.
    


## RETURNS



           a string that contains the name of a TLS cipher suite, specified
           by the given algorithms, or **NULL**.
    


* * *
# memcpy

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



           memcpy — copy bytes in memory
    


## SYNOPSIS



           #include <string.h>
    
           void *memcpy(void *restrict _s1_ , const void *restrict _s2_ , size_t _n_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _memcpy_() function shall copy _n_ bytes from the object pointed
           to by _s2_ into the object pointed to by _s1_.  If copying takes place
           between objects that overlap, the behavior is undefined.
    


## RETURN VALUE



           The _memcpy_() function shall return _s1_ ; no return value is reserved
           to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The _memcpy_() function does not check for the overflow of the
           receiving memory area.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# dane_verify_session_crt

## NAME



           dane_verify_session_crt - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **int dane_verify_session_crt(dane_state_t** _s_**, gnutls_session_t**
           _session_**, const char ***_hostname_**, const char ***_proto_**, unsigned int**
           _port_**, unsigned int** _sflags_**, unsigned int** _vflags_**, unsigned int ***
           _verify_**);**
    


## ARGUMENTS



           dane_state_t s
                       A DANE state structure (may be NULL)
    
           gnutls_session_t session
                       A gnutls session
    
           const char * hostname
                       The hostname associated with the chain
    
           const char * proto
                       The protocol of the service connecting (e.g. tcp)
    
           unsigned int port
                       The port of the service connecting (e.g. 443)
    
           unsigned int sflags
                       Flags for the initialization of  _s_ (if NULL)
    
           unsigned int vflags
                       Verification flags; an OR'ed list of
                       **dane_verify_flags_t**.
    
           unsigned int * verify
                       An OR'ed list of **dane_verify_status_t**.
    


## DESCRIPTION



           This function will verify session's certificate chain against the
           CA constrains and/or the certificate available via DANE.  See
           **dane_verify_crt()** for more information.
    
           This will not verify the chain for validity; unless the DANE
           verification is restricted to end certificates, this must be be
           performed separately using **gnutls_certificate_verify_peers3()**.
    


## RETURNS



           a negative error code on error and **DANE_E_SUCCESS**(0) when the
           DANE entries were successfully parsed, irrespective of whether
           they were verified (see  _verify_ for that information). If no
           usable entries were encountered
           **DANE_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# sd_bus_message_verify_type

## NAME



           sd_bus_message_verify_type - Check if the message has specified
           type at the current location
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_verify_type(sd_bus_message ***_m_**, char** _type_**,**
                                          **const char***_contents_**);**
    


## DESCRIPTION



           **sd_bus_message_verify_type()** checks if the complete type at the
           current location in the message _m_ matches the specified _type_ and
           _contents_. If non-zero, parameter _type_ must be one of the types
           specified in sd_bus_message_append(3). If non-null, parameter
           _contents_ must be a valid sequence of complete types. If both _type_
           and _contents_ are specified _type_ must be a container type.
    
           If _type_ is specified, the type in the message must match. If
           _contents_ is specified, the type in the message must be a container
           type with this signature.
    


## RETURN VALUE



           On success, this call returns true if the type matches and zero if
           not (the message _m_ contains different data or the end of the
           message has been reached). On failure, it returns a negative
           errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               _m_ or both _type_ and _contents_ are **NULL**.
    
               Arguments do not satisfy other constraints listed above.
    
           **-EPERM**
               Message _m_ is not sealed.
    


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


* * *
# isdigit

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



           isdigit, isdigit_l — test for a decimal digit
    


## SYNOPSIS



           #include <ctype.h>
    
           int isdigit(int _c_);
           int isdigit_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



           For _isdigit_(): 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 _isdigit_() and _isdigit_l_() functions shall test whether _c_ is a
           character of class **digit** 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 _isdigit_l_() is
           the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           The _isdigit_() and _isdigit_l_() functions shall return non-zero if _c_
           is a decimal 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.
    


* * *
# ibv_get_pkey_index

## NAME



           ibv_get_pkey_index - obtain the index in the P_Key table of a
           P_Key
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_get_pkey_index(struct ibv_context *context,
                                         uint8_t port_num,
                                         __be16 pkey);
    


## DESCRIPTION



           Every InfiniBand HCA maintains a P_Key table for each of its ports
           that is indexed by an integer and with a P_Key in each element.
           Certain InfiniBand data structures that work with P_Keys expect a
           P_Key index, e.g. **struct ibv_qp_attr** and **struct ib_mad_addr**.
           Hence the function **ibv_get_pkey_index()** that accepts a P_Key in
           network byte order and that returns an index in the P_Key table as
           result.
    


## RETURN VALUE



           **ibv_get_pkey_index()** returns the P_Key index on success, and -1 on
           error.
    


* * *
# gnutls_pkcs7_set_crl

## NAME



           gnutls_pkcs7_set_crl - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_set_crl(gnutls_pkcs7_t** _pkcs7_**, gnutls_x509_crl_t**
           _crl_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           gnutls_x509_crl_t crl
                       the DER encoded crl to be added
    


## DESCRIPTION



           This function will add a parsed CRL to the PKCS7 or RFC2630 crl
           set.
    


## RETURNS



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


* * *
# llabs

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



           llabs — return a long integer absolute value
    


## SYNOPSIS



           #include <stdlib.h>
    
           long long llabs(long long _i_);
    


## DESCRIPTION



           Refer to labs(3p).
    


* * *
# localeconv

## NAME



           localeconv - get numeric formatting information
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <locale.h>**
    
           **struct lconv *localeconv(void);**
    


## DESCRIPTION



           The **localeconv**() function returns a pointer to a _struct lconv_ for
           the current locale.  This structure is shown in locale(7), and
           contains all values associated with the locale categories
           **LC_NUMERIC** and **LC_MONETARY**.  Programs may also use the functions
           printf(3) and strfmon(3), which behave according to the actual
           locale in use.
    


## RETURN VALUE



           The **localeconv**() function returns a pointer to a filled in _struct_
           _lconv_.  This structure may be (in glibc, _is_) statically allocated,
           and may be overwritten by subsequent calls.  According to POSIX,
           the caller should not modify the contents of this structure.  The
           **localeconv**() function always succeeds.
    


## ATTRIBUTES



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


## STANDARDS



           C11.
    


## BUGS



           The printf(3) family of functions may or may not honor the current
           locale.
    


* * *
# pcap_dump_open

## NAME



           pcap_dump_open, pcap_dump_open_append, pcap_dump_fopen - open a
           file to which to write packets
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **pcap_dumper_t *pcap_dump_open(pcap_t *p, const char *fname);**
           **pcap_dumper_t *pcap_dump_open_append(pcap_t *p, const char *fname);**
           **pcap_dumper_t *pcap_dump_fopen(pcap_t *p, FILE *fp);**
    


## DESCRIPTION



           **pcap_dump_open**() is called to open a ``savefile'' for writing.
           _fname_ specifies the name of the file to open. The file will have
           the same format as those used by tcpdump(1) and **tcpslice**(1).  If
           the file does not exist, it will be created; if the file exists,
           it will be truncated and overwritten.  The name "-" is a synonym
           for **stdout**.
    
           **pcap_dump_fopen**() is called to write data to an existing open
           stream _fp_ ; this stream will be closed by a subsequent call to
           **pcap_dump_close**(3PCAP).  The stream is assumed to be at the
           beginning of a file that has been newly created or truncated, so
           that writes will start at the beginning of the file.  Note that on
           Windows, that stream should be opened in binary mode.
    
           _p_ is a capture or ``savefile'' handle returned by an earlier call
           to **pcap_create**(3PCAP) and activated by an earlier call to
           **pcap_activate**(3PCAP), or returned by an earlier call to
           **pcap_open_offline**(3PCAP), **pcap_open_live**(3PCAP), or
           **pcap_open_dead**(3PCAP).  The time stamp precision, link-layer type,
           and snapshot length from _p_ are used as the link-layer type and
           snapshot length of the output file.
    
           **pcap_dump_open_append**() is like **pcap_dump_open**() but, if the file
           already exists, and is a pcap file with the same byte order as the
           host opening the file, and has the same time stamp precision,
           link-layer header type, and snapshot length as _p_ , it will write
           new packets at the end of the file.
    


## RETURN VALUE



           A pointer to a **pcap_dumper_t** structure to use in subsequent
           **pcap_dump**(3PCAP) and **pcap_dump_close**(3PCAP) calls is returned on
           success.  **NULL** is returned on failure.  If **NULL** is returned,
           **pcap_geterr**(3PCAP) can be used to get the error text.
    


## BACKWARD COMPATIBILITY



           The **pcap_dump_open_append**() function became available in libpcap
           release 1.7.2.  In previous releases, there is no support for
           appending packets to an existing savefile.
    


* * *
# io_uring_unregister_files

## NAME



           io_uring_unregister_files - unregister file descriptors
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_unregister_files(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           The io_uring_unregister_files(3) function unregisters the file
           descriptors previously registered to the _ring_.
    


## RETURN VALUE



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


* * *
# io_uring_recvmsg_out

## NAME



           io_uring_recvmsg_out - access data from multishot recvmsg
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **struct io_uring_recvmsg_out *io_uring_recvmsg_validate(void ***_buf_**,**
                                                                  **int** _buf_len_**,**
                                                                  **struct msghdr ***_msgh_**);**
    
           **void *io_uring_recvmsg_name(struct io_uring_recvmsg_out ***_o_**);**
    
           **struct cmsghdr *io_uring_recvmsg_cmsg_firsthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                          **struct msghdr ***_msgh_**);**
           **struct cmsghdr *io_uring_recvmsg_cmsg_nexthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                         **struct msghdr ***_msgh_**,**
                                                         **struct cmsghdr ***_cmsg_**);**
    
           **void *io_uring_recvmsg_payload(struct io_uring_recvmsg_out ***_o_**,**
                                          **struct msghdr ***_msgh_**);**
           **unsigned int io_uring_recvmsg_payload_length(struct io_uring_recvmsg_out ***_o_**,**
                                                        **int** _buf_len_**,**
                                                        **struct msghdr ***_msgh_**);**
    


## DESCRIPTION



           These functions are used to access data in the payload delivered
           by io_uring_prep_recvmsg_multishot(3).
    
           _msgh_ should point to the _struct msghdr_ submitted with the request.
    
           io_uring_recvmsg_validate(3) will validate a buffer delivered by
           io_uring_prep_recvmsg_multishot(3) and extract the
           _io_uring_recvmsg_out_ if it is valid, returning a pointer to it or
           else NULL.
    
           The structure is defined as follows:
    
               struct io_uring_recvmsg_out {
                       __u32 namelen;    /* Name byte count as would have been populated
                                          * by recvmsg(2) */
                       __u32 controllen; /* Control byte count */
                       __u32 payloadlen; /* Payload byte count as would have been returned
                                          * by recvmsg(2) */
                       __u32 flags;      /* Flags result as would have been populated
                                          * by recvmsg(2) */
               };
    
           *  io_uring_recvmsg_name(3)
              returns a pointer to the name in the buffer.
    
           *  io_uring_recvmsg_cmsg_firsthdr(3)
              returns a pointer to the first cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_cmsg_nexthdr(3)
              returns a pointer to the next cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_payload(3)
              returns a pointer to the payload in the buffer.
    
           *  io_uring_recvmsg_payload_length(3)
              Calculates the usable payload length in bytes.
    


* * *
# gnutls_x509_crq_get_signature_oid

## NAME



           gnutls_x509_crq_get_signature_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_signature_oid(gnutls_x509_crq_t** _crq_**, char**
           *****_oid_**, size_t ***_oid_size_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           char * oid  a pointer to a buffer to hold the OID (may be null)
    
           size_t * oid_size
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the OID of the signature algorithm that
           has been used to sign this certificate request. This function is
           useful in the case **gnutls_x509_crq_get_signature_algorithm()**
           returned **GNUTLS_SIGN_UNKNOWN**.
    


## RETURNS



           zero or a negative error code on error.
    


## SINCE



           3.5.0
    


* * *
# gnutls_privkey_derive_secret

## NAME



           gnutls_privkey_derive_secret - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_derive_secret(gnutls_privkey_t** _privkey_**,**
           **gnutls_pubkey_t** _pubkey_**, const gnutls_datum_t ***_nonce_**,**
           **gnutls_datum_t ***_secret_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t privkey
                       a private key of type **gnutls_privkey_t**
    
           gnutls_pubkey_t pubkey
                       a public key of type **gnutls_pubkey_t**
    
           const gnutls_datum_t * nonce
                       an optional nonce value
    
           gnutls_datum_t * secret
                       where shared secret will be stored
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will calculate a shared secret from our  _privkey_ and
           peer's  _pubkey_ . The result will be stored in  _secret_ , whose data
           member should be freed after use using **gnutls_free()**.  _privkey_ and
            _pubkey_ must be backed by the X.509 keys.
    


## RETURNS



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


## SINCE



           3.8.2
    


* * *
# gnutls_pkcs11_privkey_generate

## NAME



           gnutls_pkcs11_privkey_generate - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_generate(const char ***_url_**,**
           **gnutls_pk_algorithm_t** _pk_**, unsigned int** _bits_**, const char ***_label_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * url
                       a token URL
    
           gnutls_pk_algorithm_t pk
                       the public key algorithm
    
           unsigned int bits
                       the security bits
    
           const char * label
                       a label
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will generate a private key in the specified by the
           _url_ token. The private key will be generate within the token and
           will not be exportable.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# gnutls_x509_crt_init

## NAME



           gnutls_x509_crt_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_init(gnutls_x509_crt_t ***_cert_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t * cert
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize an X.509 certificate structure.
    


## RETURNS



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


* * *
# gnutls_safe_renegotiation_status

## NAME



           gnutls_safe_renegotiation_status - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_safe_renegotiation_status(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Can be used to check whether safe renegotiation is being used in
           the current session.
    


## RETURNS



           0 when safe renegotiation is not used and non (0) when safe
           renegotiation is used.
    


## SINCE



           2.10.0
    


* * *
# wcscat

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



           wcscat — concatenate two wide-character strings
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcscat(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _wcscat_() function shall append a copy of the wide-character
           string pointed to by _ws2_ (including the terminating null wide-
           character code) to the end of the wide-character string pointed to
           by _ws1_.  The initial wide-character code of _ws2_ shall overwrite
           the null wide-character code at the end of _ws1_.  If copying takes
           place between objects that overlap, the behavior is undefined.
    


## RETURN VALUE



           The _wcscat_() function shall return _ws1_ ; no return value is
           reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::kernel_or_user_string_quoted_utf16

## NAME



           function::kernel_or_user_string_quoted_utf16 - Retrieves and
           quotes UTF-16 string from kernel or user memory
    


## SYNOPSIS



               kernel_or_user_string_quoted_utf16:string(addr:long)
    


## ARGUMENTS



           _addr_
               the kernel or user memory address to retrieve the string from
    


## DESCRIPTION



           Similar to kernel_string_quoted_utf16 except uses user memory as a
           fallback method
    


* * *
# pcap_perror

## NAME



           pcap_geterr, pcap_perror - get or print libpcap error message text
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **char *pcap_geterr(pcap_t *p);**
           **void pcap_perror(pcap_t *p, const char *prefix);**
    


## DESCRIPTION



           **pcap_geterr**() returns the error text pertaining to the last pcap
           library error.  **NOTE** : the pointer it returns will no longer point
           to a valid error message string after the **pcap_t** passed to it is
           closed; you must use or copy the string before closing the **pcap_t**.
    
           **pcap_perror**() prints the text of the last pcap library error on
           **stderr** , prefixed by _prefix_.
    


* * *
# pthread_cond_signal

## 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_cond_signal — signal a condition
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_cond_signal(pthread_cond_t *_cond_);
    


## DESCRIPTION



           Refer to pthread_cond_broadcast(3p).
    


* * *
# is_context_customizable

## NAME



           is_context_customizable - check whether SELinux context type is
           customizable by the administrator
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int is_context_customizable(const char ***_scon_**);**
    


## DESCRIPTION



           This function checks whether the type of scon is in the
           _/etc/selinux/{SELINUXTYPE}/context/customizable_types_ file.  A
           customizable type is a file context type that administrators set
           on files, usually to allow certain domains to share the file
           content. restorecon and setfiles, by default, leave these context
           in place.
    


## RETURN VALUE



           Returns 1 if security context is customizable or 0 if it is not.
           Returns -1 on error.
    


## FILE



           _/etc/selinux/{SELINUXTYPE}/context/customizable_types_
    


* * *
# gnutls_tdb_deinit

## NAME



           gnutls_tdb_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_tdb_deinit(gnutls_tdb_t** _tdb_**);**
    


## ARGUMENTS



           gnutls_tdb_t tdb
                       The structure to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a public key trust storage
           structure.
    


* * *
# probe::netfilter.ip.pre_routing

## NAME



           probe::netfilter.ip.pre_routing - Called before an IP packet is
           routed
    


## SYNOPSIS



           netfilter.ip.pre_routing
    


## VALUES



           _indev_name_
               Name of network device packet was received on (if known)
    
           _sport_
               TCP or UDP source port (ipv4 only)
    
           _iphdr_
               Address of IP header
    
           _pf_
               Protocol family - either 'ipv4' or 'ipv6'
    
           _dport_
               TCP or UDP destination port (ipv4 only)
    
           _saddr_
               A string representing the source IP address
    
           _fin_
               TCP FIN flag (if protocol is TCP; ipv4 only)
    
           _daddr_
               A string representing the destination IP address
    
           _syn_
               TCP SYN flag (if protocol is TCP; ipv4 only)
    
           _urg_
               TCP URG flag (if protocol is TCP; ipv4 only)
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _rst_
               TCP RST flag (if protocol is TCP; ipv4 only)
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _ipproto_tcp_
               Constant used to signify that the packet protocol is TCP
    
           _data_str_
               A string representing the packet buffer contents
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _protocol_
               Packet protocol from driver (ipv4 only)
    
           _ack_
               TCP ACK flag (if protocol is TCP; ipv4 only)
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _psh_
               TCP PSH flag (if protocol is TCP; ipv4 only)
    
           _ipproto_udp_
               Constant used to signify that the packet protocol is UDP
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _family_
               IP address family
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    


* * *
# pfm_strerror

## NAME



           pfm_strerror - return constant string describing error code
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **const char *pfm_strerror(int** _code);_
    


## DESCRIPTION



           This function returns a string which describes the libpfm error
           value in **code**. The string returned by the call is **read-only**.
    
           The function must **only** be used with libpfm calls documented to
           return specific error codes. The value -1 is not considered a
           specific error code.  Strings and **pfm_pmu_t** return values cannot
           be used with this function.  Typically **NULL** is returned in case of
           error for string values, and **PFM_PMU_NONE** is returned for
           **pfm_pmu_t** values.
    
           The function is also not designed to handle OS system call errors,
           i.e., errno values.
    


## RETURN



           The function returns a pointer to the constant string describing
           the error code. The string is in English. If code is invalid then
           a default error message is returned.
    


## ERRORS



           If the error code is invalid, then the function returns a pointer
           to a string which says "unknown error code".
    


* * *
# pcap_setfilter

## NAME



           pcap_setfilter - set the filter
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_setfilter(pcap_t *p, struct bpf_program *fp);**
    


## DESCRIPTION



           **pcap_setfilter**() is used to specify a filter program.  _fp_ is a
           pointer to a _bpf_program_ struct, usually the result of a call to
           **pcap_compile**(3PCAP).
    
           If the calls to **pcap_compile**() and **pcap_setfilter**() use the same
           **pcap_t** handle, packet filtering should either work correctly or
           fail correctly without additional efforts.  Otherwise the filter
           program must have been compiled for the same link-layer header
           type as the one used by the **pcap_t** handle, also on Linux any usage
           of BPF extensions must match the use case.  Specifically, if the
           **pcap_t** stands for an input savefile, the filter program must not
           use the extensions, but if it stands for a live packet capture,
           the filter program may use the extensions if necessary.  See
           **pcap_compile**() for more information.
    


## RETURN VALUE



           **pcap_setfilter**() returns **0** on success, **PCAP_ERROR_NOT_ACTIVATED** if
           called on a capture handle that has been created but not
           activated, or **PCAP_ERROR** on other errors.  If **PCAP_ERROR** is
           returned, **pcap_geterr**(3PCAP) or **pcap_perror**(3PCAP) may be called
           with _p_ as an argument to fetch or display the error text.
    


* * *