tripathysagar/man_text huggingface dataset:
# modf

## NAME



           modf, modff, modfl - extract signed integral and fractional values
           from floating-point number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <math.h>**
    
           **double modf(double** _x_**, double ***_iptr_**);**
           **float modff(float** _x_**, float ***_iptr_**);**
           **long double modfl(long double** _x_**, long double ***_iptr_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **modff**(), **modfl**():
               _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
                   || /* Since glibc 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           These functions break the argument _x_ into an integral part and a
           fractional part, each of which has the same sign as _x_.  The
           integral part is stored in the location pointed to by _iptr_.
    


## RETURN VALUE



           These functions return the fractional part of _x_.
    
           If _x_ is a NaN, a NaN is returned, and _*iptr_ is set to a NaN.
    
           If _x_ is positive infinity (negative infinity), +0 (-0) is
           returned, and _*iptr_ is set to positive infinity (negative
           infinity).
    


## ERRORS



           No errors occur.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# semanage_exists

## NAME



           semanage_exists - SELinux Management API
    


## SYNOPSIS



           The following exists function is supported for any semanage
           record.
           Replace the function and object name as necessary.
    
           **extern int EXISTS_FUNCTION (**
                **semanage_handle_t ***_handle_**,**
                **const semanage_OBJECT_key_t ***_key_**,**
                **semanage_OBJECT_t ****_response_**);**
    


## DESCRIPTION



           **Behavior:**
                  The exists function will return 0 if a matching key is not
                  found, and 1 otherwise.
    
           **Parameters:**
                  The _handle_ is used to track persistent state across
                  semanage calls, and for error reporting. The _key_ identifies
                  the object being checked. The result of the test will be
                  stored in the address pointed by _response_ The key is a
                  property of the caller, and will not be stored or modified
                  internally.
    
           **Requirements:**
                  This function requires an semanage connection to be
                  established (see **semanage_connect**(3) )
    


## RETURN VALUE



           In case of failure, -1 is returned, and the semanage error
           callback is invoked, describing the error.  Otherwise a non-
           negative integer is returned (a commit number). The same number
           will be returned by all other read calls to the semanage database
           until the next commit.
    


* * *
# gnutls_x509_crq_init

## NAME



           gnutls_x509_crq_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_init(gnutls_x509_crq_t ***_crq_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t * crq
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a PKCS**10** certificate request
           structure.
    


## RETURNS



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


* * *
# gnutls_psk_set_client_credentials2

## NAME



           gnutls_psk_set_client_credentials2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_set_client_credentials2(gnutls_psk_client_credentials_t**
           _res_**, const gnutls_datum_t ***_username_**, const gnutls_datum_t ***_key_**,**
           **gnutls_psk_key_flags** _flags_**);**
    


## ARGUMENTS



           gnutls_psk_client_credentials_t res
                       is a **gnutls_psk_client_credentials_t** type.
    
           const gnutls_datum_t * username
                       is the userid
    
           const gnutls_datum_t * key
                       is the user's key
    
           gnutls_psk_key_flags flags
                       indicate the format of the key, either
                       **GNUTLS_PSK_KEY_RAW** or **GNUTLS_PSK_KEY_HEX**.
    


## DESCRIPTION



           This function is identical to **gnutls_psk_set_client_credentials()** ,
           except that it allows a non-null-terminated username to be
           introduced.
    


## RETURNS



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


* * *
# pmdadesc

## NAME



           **pmdaDesc** - get the description of a metric from a PMDA
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaDesc(pmID** _pmid_**, pmDesc ***_desc_**, pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           **pmdaDesc** uses  the standard PMDA(3) data structures to return the
           **pmDesc** description in _desc_ for the metric identified by _pmid_.
    


## CAVEAT



           The PMDA must be using **PMDA_INTERFACE_2** or later, as specified  in
           the call to pmdaDSO(3) or pmdaDaemon(3).
    


## DIAGNOSTICS



           If  the  _pmid_  does not correspond to any metric supported by this
           PMDA, **pmdaDesc** returns **PM_ERR_PMID**.
    


* * *
# pcap_geterr

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


* * *
# fpurge

## NAME



           fpurge, __fpurge - purge a stream
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           /* unsupported */
           **#include <stdio.h>**
    
           **int fpurge(FILE ***_stream_**);**
    
           /* supported */
           **#include <stdio.h>**
           **#include <stdio_ext.h>**
    
           **void  __fpurge(FILE ***_stream_**);**
    


## DESCRIPTION



           The function **fpurge**() clears the buffers of the given stream.  For
           output streams this discards any unwritten output.  For input
           streams this discards any input read from the underlying object
           but not yet obtained via getc(3); this includes any text pushed
           back via ungetc(3).  See also fflush(3).
    
           The function **__fpurge**() does precisely the same, but without
           returning a value.
    


## RETURN VALUE



           Upon successful completion **fpurge**() returns 0.  On error, it
           returns -1 and sets _errno_ to indicate the error.
    


## ERRORS



           **EBADF** _stream_ is not an open stream.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## NOTES



           Usually it is a mistake to want to discard input buffers.
    


* * *
# nearbyint

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



           nearbyint, nearbyintf, nearbyintl — floating-point rounding
           functions
    


## SYNOPSIS



           #include <math.h>
    
           double nearbyint(double _x_);
           float nearbyintf(float _x_);
           long double nearbyintl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall round their argument to an integer value in
           floating-point format, using the current rounding direction and
           without raising the inexact floating-point exception.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           rounded integer value.  The result shall have the same sign as _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, ±0 shall be returned.
    
           If _x_ is ±Inf, _x_ shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The integral value returned by these functions need not be
           expressible as an **intmax_t**.  The return value should be tested
           before assigning it to an integer type to avoid the undefined
           results of an integer overflow.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmparseinterval

## NAME



           **pmParseInterval** - convert interval string to binary time structure
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmParseInterval(const char ***_string_**, struct timespec ***_rslt_**,**
                               **char ****_errmsg_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmParseInterval** parses the argument _string_ specifying an interval
           of time and fills in the **tv_sec** and **tv_nsec** components of the _rslt_
           structure to represent that interval (nanosecond precision).
    
           The input _string_ is most commonly the argument following a **-t** com‐
           mand line option to a PCP application, and the syntax is fully de‐
           scribed in PCPIntro(1).
    


## DIAGNOSTICS



           **pmParseInterval** returns 0 and _errmsg_ is undefined if  the  parsing
           is successful.
    
           If the given _string_ does not conform to the required syntax **pmPar‐**
           **seInterval** returns  -1  and a dynamically allocated error message
           string in _errmsg_.  The error message is terminated with a  newline
           and  includes the text of the input _string_ along with an indicator
           of the position at which the error was detected, e.g.
                     _4minutes 30mumble_
                                _^ -- unexpected value_
    
           In the case of an error, the caller  is  responsible  for  calling
           free(3) to release the space allocated for _errmsg_.
    


## COMPATIBILITY



           Prior  to PCP 7.0 the _rslt_ argument was a struct timeval.  To sup‐
           port PMAPI transition, the old interface and semantics can be used
           if applications are recompiled with **-DPMAPI_VERSION=2**.
    
           For a time in PCP 6.x there was a routine with the same  semantics
           as  the  current **pmParseInterval** called **pmParseHighResInterval** al‐
           though this is now deprecated and  compile-time  support  for  **pm‐**
           **ParseHighResInterval** will be removed in a future release.
    


* * *
# audit_can_read

## NAME



           audit_can_control, audit_can_write, audit_can_read - test audit
           related capabilities
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_can_control(void);**
           **int audit_can_write(void);**
           **int audit_can_read(void);**
    


## DESCRIPTION



           **audit_can_control**() returns 1 if the calling process possesses the
           **CAP_AUDIT_CONTROL** capability, otherwise 0.  **audit_can_write**()
           returns 1 if **CAP_AUDIT_WRITE** is available.  **audit_can_read**()
           returns 1 if **CAP_AUDIT_READ** is present.  When libcap-ng support is
           not available these functions return 1 only when the effective UID
           is 0.
    


## RETURN VALUE



           These functions return 1 when the capability is present and 0
           otherwise.
    


* * *
# pcre2_pattern_convert

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_pattern_convert(PCRE2_SPTR** _pattern_**, PCRE2_SIZE** _length_**,**
             **uint32_t** _options_**, PCRE2_UCHAR ****_buffer_**,**
             **PCRE2_SIZE ***_blength_**, pcre2_convert_context ***_cvcontext_**);**
    


## DESCRIPTION



    
           This function is part of an experimental set of pattern conversion
           functions.  It converts a foreign pattern (for example, a glob)
           into a PCRE2 regular expression pattern. Its arguments are:
    
             _pattern_     The foreign pattern
             _length_      The length of the input pattern or
           PCRE2_ZERO_TERMINATED
             _options_     Option bits
             _buffer_      Pointer to pointer to output buffer, or NULL
             _blength_     Pointer to output length field
             _cvcontext_   Pointer to a convert context or NULL
    
           The length of the converted pattern (excluding the terminating
           zero) is returned via _blength_. If _buffer_ is NULL, the function
           just returns the output length. If _buffer_ points to a NULL
           pointer, heap memory is obtained for the converted pattern, using
           the allocator in the context if present (or else **malloc()**), and
           the field pointed to by _buffer_ is updated. If _buffer_ points to a
           non-NULL field, that must point to a buffer whose size is in the
           variable pointed to by _blength_. This value is updated.
    
           The option bits are:
    
             PCRE2_CONVERT_UTF                     Input is UTF
             PCRE2_CONVERT_NO_UTF_CHECK            Do not check UTF validity
             PCRE2_CONVERT_POSIX_BASIC             Convert POSIX basic
           pattern
             PCRE2_CONVERT_POSIX_EXTENDED          Convert POSIX extended
           pattern
             PCRE2_CONVERT_GLOB                    ) Convert
             PCRE2_CONVERT_GLOB_NO_WILD_SEPARATOR  )   various types
             PCRE2_CONVERT_GLOB_NO_STARSTAR        )     of glob
    
           The return value from **pcre2_pattern_convert()** is zero on success
           or a non-zero PCRE2 error code.
    
           The pattern conversion functions are described in the **pcre2convert**
           documentation.
    


* * *
# strpbrk

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



           strpbrk — scan a string for a byte
    


## SYNOPSIS



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


## 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 _strpbrk_() function shall locate the first occurrence in the
           string pointed to by _s1_ of any byte from the string pointed to by
           _s2_.
    


## RETURN VALUE



           Upon successful completion, _strpbrk_() shall return a pointer to
           the byte or a null pointer if no byte from _s2_ occurs in _s1_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::target_set

## NAME



           tapset::target_set - systemtap target_set tapset
    


## DESCRIPTION



           **target_set_pid**
                  Does pid descend from target process?
    
                  See function::target_set_pid(3stap)
                   for details.
    
           **target_set_report**
                  Print a report about the target set
    
                  See function::target_set_report(3stap)
                   for details.
    


* * *
# gnutls_pkcs11_obj_export_url

## NAME



           gnutls_pkcs11_obj_export_url - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_export_url(gnutls_pkcs11_obj_t** _obj_**,**
           **gnutls_pkcs11_url_type_t** _detailed_**, char ****_url_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t obj
                       Holds the PKCS 11 certificate
    
           gnutls_pkcs11_url_type_t detailed
                       non zero if a detailed URL is required
    
           char ** url will contain an allocated url
    


## DESCRIPTION



           This function will export a URL identifying the given object.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# stapfuncs

## NAME



           stapfuncs - systemtap functions
    


## DESCRIPTION



           Functions in the standard systemtap tapset are individually
           documented in the _3stap_ manual section, with the _function::_
           prefix.  Some built-in functions such as _printf_ are documented on
           the stap(1) man page.
    


* * *
# udev_monitor_filter_update

## NAME



           udev_monitor_filter_update, udev_monitor_filter_remove,
           udev_monitor_filter_add_match_subsystem_devtype,
           udev_monitor_filter_add_match_tag - Modify filters
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **int udev_monitor_filter_update(struct udev_monitor ***_udev_monitor_**);**
    
           **int udev_monitor_filter_remove(struct udev_monitor ***_udev_monitor_**);**
    
           **int**
                                                               **udev_monitor_filter_add_match_subsystem_devtype(struct udev_monitor ***_udev_monitor_**,**
                                                               **const char ***_subsystem_**,**
                                                               **const char ***_devtype_**);**
    
           **int**
                                                 **udev_monitor_filter_add_match_tag(struct udev_monitor ***_udev_monitor_**,**
                                                 **const char ***_tag_**);**
    


## RETURN VALUE



           On success, **udev_monitor_filter_update()** ,
           **udev_monitor_filter_remove()** ,
           **udev_monitor_filter_add_match_subsystem_devtype()** and
           **udev_monitor_filter_add_match_tag()** return an integer greater
           than, or equal to, **0**. On failure, a negative error code is
           returned.
    


* * *
# gnutls_ext_get_name2

## NAME



           gnutls_ext_get_name2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_ext_get_name2(gnutls_session_t** _session_**,**
           **unsigned int** _tls_id_**, gnutls_ext_parse_type_t** _parse_point_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       a **gnutls_session_t** opaque pointer
    
           unsigned int tls_id
                       is a TLS extension numeric ID
    
           gnutls_ext_parse_type_t parse_point
                       the parse type of the extension
    


## DESCRIPTION



           Convert a TLS extension numeric ID to a printable string.
    


## RETURNS



           a pointer to a string that contains the name of the specified
           cipher, or **NULL**.
    


* * *
# gnutls_x509_aia_init

## NAME



           gnutls_x509_aia_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aia_init(gnutls_x509_aia_t ***_aia_**);**
    


## ARGUMENTS



           gnutls_x509_aia_t * aia
                       The authority info access
    


## DESCRIPTION



           This function will initialize an authority info access type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# function::log

## NAME



           function::log - Send a line to the common trace buffer
    


## SYNOPSIS



               log(msg:string)
    


## ARGUMENTS



           _msg_
               The formatted message string
    


## DESCRIPTION



           This function logs data. log sends the message immediately to
           staprun and to the bulk transport (relayfs) if it is being used.
           If the last character given is not a newline, then one is added.
           This function is not as efficient as printf and should be used
           only for urgent messages.
    


* * *
# gnutls_srp_set_client_credentials_function

## NAME



           gnutls_srp_set_client_credentials_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_srp_set_client_credentials_function(gnutls_srp_client_credentials_t**
           _cred_**, gnutls_srp_client_credentials_function ***_func_**);**
    


## ARGUMENTS



           gnutls_srp_client_credentials_t cred
                       is a **gnutls_srp_server_credentials_t** type.
    
           gnutls_srp_client_credentials_function * func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the
           username and password for client SRP authentication.  The
           callback's function form is:
    
           int (*callback)(gnutls_session_t, char** username,
           char**password);
    
           The  _username_ and  _password_ must be allocated using
           **gnutls_malloc()**.
    
           The  _username_ should be an ASCII string or UTF-8 string. In case
           of a UTF-8 string it is recommended to be following the PRECIS
           framework for usernames (rfc8265). The password can be in ASCII
           format, or normalized using **gnutls_utf8_password_normalize()**.
    
           The callback function will be called once per handshake before the
           initial hello message is sent.
    
           The callback should not return a negative error code the second
           time called, since the handshake procedure will be aborted.
    
           The callback function should return 0 on success.  -1 indicates an
           error.
    


* * *
# pcre2_set_max_pattern_compiled_length

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_set_max_pattern_compiled_length(**
             **pcre2_compile_context ***_ccontext_**, PCRE2_SIZE** _value_**);**
    


## DESCRIPTION



    
           This function sets, in a compile context, the maximum size (in
           bytes) for the memory needed to hold the compiled version of a
           pattern that is using this context. The result is always zero. If
           a pattern that is passed to **pcre2_compile()** referencing this
           context needs more memory, an error is generated. The default is
           the largest number that a PCRE2_SIZE variable can hold, which is
           effectively unlimited.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# form_field_attributes

## NAME



           **form_field_attributes** - color and attribute control for form
           fields
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_field_fore(FIELD ***_field_**, chtype** _attr_**);**
           **chtype field_fore(const FIELD ***_field_**);**
    
           **int set_field_back(FIELD ***_field_**, chtype** _attr_**);**
           **chtype field_back(const FIELD ***_field_**);**
    
           **int set_field_pad(FIELD ***_field_**, int** _pad_**);**
           **int field_pad(const FIELD ***_field_**);**
    


## DESCRIPTION



           The function **set_field_fore** sets the foreground attribute of
           _field_. This is the highlight used to display the field contents.
           The function **field_fore** returns the foreground attribute.  The
           default is **A_STANDOUT**.
    
           The function **set_field_back** sets the background attribute of _form_.
           This is the highlight used to display the extent fields in the
           form.  The function **field_back** returns the background attribute.
           The default is **A_NORMAL**.
    
           The function **set_field_pad** sets the character used to fill the
           field.  The function **field_pad** returns the given form's pad
           character.  The default is a blank.
    


## RETURN VALUE



           These routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



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


* * *
# sd_bus_list_names

## NAME



           sd_bus_list_names - Retrieve information about registered names on
           a bus
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_list_names(sd_bus ***_bus_**, char *****_acquired_**,**
                                 **char *****_activatable_**);**
    


## DESCRIPTION



           **sd_bus_list_names()** retrieves information about the registered
           names on a bus. If _acquired_ is not **NULL** , this function calls
           **org.freedesktop.DBus.ListNames******[1] to retrieve the list of
           currently-owned names on the bus. If _acquired_ is not **NULL** , the
           function calls **org.freedesktop.DBus.ListActivableNames******[2] to
           retrieve the list of all names on the bus that can be activated.
           Note that ownership of the arrays returned by**sd_bus_list_names()**
           in _acquired_ and _activatable_ is transferred to the caller and
           hence, the caller is responsible for freeing these arrays and
           their contents.
    


## RETURN VALUE



           On success, **sd_bus_list_names()** returns a non-negative integer. On
           failure, it returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               _bus_ or both _acquired_ and _activatable_ were **NULL**.
    
           **-ENOPKG**
               The bus cannot be resolved.
    
           **-ECHILD**
               The bus was created in a different process, library or module
               instance.
    
           **-ENOMEM**
               Memory allocation failed.
    
           **-ENOTCONN**
               The bus is not connected.
    


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


## NOTES



            1. org.freedesktop.DBus.ListNames
               https://dbus.freedesktop.org/doc/dbus-specification.html#bus-messages-list-names
    
            2. org.freedesktop.DBus.ListActivableNames
               https://dbus.freedesktop.org/doc/dbus-specification.html#bus-messages-list-activatable-names
    


* * *
# acl_from_mode

## NAME



           **acl_from_mode** — create an ACL from file permission bits
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _acl_t_ **acl_from_mode**(_mode_t mode_)
    


## DESCRIPTION



           The **acl_from_mode**() function creates a minimal ACL that contains
           the three entries with tag types ACL_USER_OBJ, ACL_GROUP_OBJ, and
           ACL_OTHER, with permissions corresponding to the owner, group, and
           other permission bits of its argument _mode_.
    


## RETURN VALUE



           On success, this function returns a pointer to the working
           storage. On error, a value of **(acl_t)NULL** is returned, and _errno_
           is set appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_from_mode**()
           function returns a value of **(acl_t)NULL** and sets _errno_ to the
           corresponding value:
    
           [ENOMEM]           The ACL working storage requires more memory
                              than is allowed by the hardware or system-
                              imposed memory management constraints.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# gnutls_ocsp_status_request_get2

## NAME



           gnutls_ocsp_status_request_get2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_ocsp_status_request_get2(gnutls_session_t** _session_**,**
           **unsigned** _idx_**, gnutls_datum_t ***_response_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned idx
                       the index of peer's certificate
    
           gnutls_datum_t * response
                       a **gnutls_datum_t** with DER encoded OCSP response
    


## DESCRIPTION



           This function returns the OCSP status response received from the
           TLS server for the certificate index provided.  The index
           corresponds to certificates as returned by
           gnutls_certificate_get_peers. When index is zero this function
           operates identically to **gnutls_ocsp_status_request_get()**.
    
           The returned  _response_ should be treated as constant. If no OCSP
           response is available for the given index then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** is returned.
    


## RETURNS



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


## SINCE



           3.6.3
    


* * *
# sd_hwdb_new

## NAME



           sd_hwdb_new, sd_hwdb_new_from_path, sd_hwdb_ref, sd_hwdb_unref -
           Create a new hwdb object and create or destroy references to it
    


## SYNOPSIS



           **#include <systemd/sd-hwdb.h>**
    
           **int sd_hwdb_new(sd_hwdb ****_hwdb_**);**
    
           **int sd_hwdb_new_from_path(const char ***_path_**, sd_hwdb ****_hwdb_**);**
    
           **sd_hwdb* sd_hwdb_ref(sd_hwdb ***_hwdb_**);**
    
           **sd_hwdb* sd_hwdb_unref(sd_hwdb ***_hwdb_**);**
    


## DESCRIPTION



           **sd_hwdb_new()** creates a new hwdb object to access the binary hwdb
           database. Upon initialization, the file containing the binary
           representation of the hardware database is located and opened. The
           new object is returned in _hwdb_.
    
           **sd_hwdb_new_from_path()** may be used to specify the path from which
           the binary hardware database should be opened.
    
           The _hwdb_ object is reference counted.  **sd_hwdb_ref()** and
           **sd_hwdb_unref()** may be used to get a new reference or destroy an
           existing reference to an object. The caller must dispose of the
           reference acquired with **sd_hwdb_new()** by calling **sd_hwdb_unref()**
           when done with the object.
    
           Use sd_hwdb_seek(3), sd_hwdb_get(3), and sd_hwdb_enumerate(3) to
           access entries.
    


## RETURN VALUE



           On success, **sd_hwdb_new()** and **sd_hwdb_new_from_path()** return a
           non-negative integer. On failure, a negative errno-style error
           code is returned.
    
           **sd_hwdb_ref()** always returns the argument.
    
           **sd_hwdb_unref()** always returns **NULL**.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-ENOENT**
               The binary hardware database file could not be located. See
               systemd-hwdb(8) for more information.
    
               Added in version 246.
    
           **-EINVAL**
               The located binary hardware database file is in an
               incompatible format.
    
               Added in version 246.
    
           **-ENOMEM**
               Memory allocation failed.
    
               Added in version 246.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# auparse_init

## NAME



           auparse_init - initialize an instance of the audit parsing library
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **auparse_state_t * auparse_init(ausource_t** _source,_**const** _void_***"**_b);"_
    


## DESCRIPTION



           auparse_init initializes an instance of the audit parsing library.
           The function returns an opaque pointer to the parser's internal
           state. It is used in subsequent calls to the library so. The
           source variable determines where the library looks for data. Legal
           values can be:
    
                AUSOURCE_LOGS - use audit logs
                AUSOURCE_FILE - use a file
                AUSOURCE_FILE_ARRAY - use several files
                AUSOURCE_BUFFER - use a buffer
                AUSOURCE_BUFFER_ARRAY - use an array of buffers
                AUSOURCE_DESCRIPTOR - use a particular descriptor
                AUSOURCE_FILE_POINTER - use a stdio FILE pointer
                AUSOURCE_FEED - feed data to parser with auparse_feed()
    
           The pointer 'b' is used to set the file name, array of filenames,
           the buffer address, or an array of pointers to buffers, or the
           descriptor number based on what source is given. When the data
           source is an array of files or buffers, you would create an array
           of pointers with the last one being a NULL pointer. Buffers should
           be NUL terminated.
    
           The data structure returned by auparse_init is not thread-safe. If
           you need to use it in a multithreaded program, you will need to
           add locking around any use of the data structure.
    


## RETURN VALUE



           Returns a NULL pointer if an error occurs; otherwise, the return
           value is an opaque pointer to the parser's internal state.
    


* * *
# gnutls_session_resumption_requested

## NAME



           gnutls_session_resumption_requested - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Check whether the client has asked for session resumption.  This
           function is valid only on server side.
    


## RETURNS



           non zero if session resumption was asked, or a zero if not.
    


* * *
# ibv_get_device_name

## NAME



           ibv_get_device_name - get an RDMA device’s name
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  const char *ibv_get_device_name(struct ibv_device *device);
    


## DESCRIPTION



           **ibv_get_device_name()** returns a human-readable name associated
           with the RDMA device _device_.
    


## RETURN VALUE



           **ibv_get_device_name()** returns a pointer to the device name, or
           NULL if the request fails.
    


* * *
# gnutls_x509_crt_set_pin_function

## NAME



           gnutls_x509_crt_set_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crt_set_pin_function(gnutls_x509_crt_t** _crt_**,**
           **gnutls_pin_callback_t** _fn_**, void ***_userdata_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       The certificate structure
    
           gnutls_pin_callback_t fn
                       the callback
    
           void * userdata
                       data associated with the callback
    


## DESCRIPTION



           This function will set a callback function to be used when it is
           required to access a protected object. This function overrides the
           global function set using **gnutls_pkcs11_set_pin_function()**.
    
           Note that this callback is currently used only during the import
           of a PKCS **11** certificate with **gnutls_x509_crt_import_url()**.
    


## SINCE



           3.1.0
    


* * *
# libpfm_intel_icx_unc_m2pcie

## NAME



           libpfm_intel_icx_unc_m2pcie - support for Intel IcelakeX Server
           M2PCIE uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_m2pcie[0-2]**
           **PMU desc: Intel IcelakeX M2PCIE uncore PMU**
    


## DESCRIPTION



           The library supports the Intel IcelakeX M2PCIE (Mesh to IIO)
           uncore PMU.  Each M2PCIE PMU implements 4 generic counters.
    


## MODIFIERS



           The following modifiers are supported on Intel IcelakeX M2PCIE
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of M2PCIE clockticks in which the
                  number of occurrences of the event is greater or equal to
                  the threshold.  This is an integer modifier with values in
                  the range [0:255].
    
           **i** Invert the threshold (t) test from strictly greater than to
                  less or equal to. This is a boolean modifier.
    


* * *
# gnutls_x509_crt_set_proxy

## NAME



           gnutls_x509_crt_set_proxy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_proxy(gnutls_x509_crt_t** _crt_**, int**
           _pathLenConstraint_**, const char ***_policyLanguage_**, const char ***
           _policy_**, size_t** _sizeof_policy_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           int pathLenConstraint
                       non-negative error codes indicate maximum length of
                       path, and negative error codes indicate that the
                       pathLenConstraints field should not be present.
    
           const char * policyLanguage
                       OID describing the language of  _policy_ .
    
           const char * policy
                       uint8_t byte array with policy language, can be **NULL**
    
           size_t sizeof_policy
                       size of  _policy_ .
    


## DESCRIPTION



           This function will set the proxyCertInfo extension.
    


## RETURNS



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


* * *
# libpfm_intel_icx_unc_m2m

## NAME



           libpfm_intel_icx_unc_m2m - support for Intel Icelake X Server Mesh
           to Memory (M2M)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: icx_unc_m2m[0-1]**
           **PMU desc: Intel Icelake X Server M2M uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Icelake X Server Mesh to Memory
           (M2M) uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Icelake X server
           M2M uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of M2M cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].  **i** Invert the threshold (t) test from
                  strictly greater than to less or equal to. This is a
                  boolean modifier.
    


* * *
# gnutls_transport_get_int2

## NAME



           gnutls_transport_get_int2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_get_int2(gnutls_session_t** _session_**, int ***
           _recv_int_**, int ***_send_int_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           int * recv_int
                       will hold the value for the pull function
    
           int * send_int
                       will hold the value for the push function
    


## DESCRIPTION



           Used to get the arguments of the transport functions (like PUSH
           and PULL).  These should have been set using
           **gnutls_transport_set_int2()**.
    


## SINCE



           3.1.9
    


* * *
# form_post

## NAME



           **post_form** , **unpost_form** - write or erase forms from associated
           subwindows
    


## SYNOPSIS



           **#include <form.h>**
    
           **int post_form(FORM ***_form_**);**
           **int unpost_form(FORM ***_form_**);**
    


## DESCRIPTION



           The function **post_form** displays a form to its associated
           subwindow.  To trigger physical display of the subwindow, use
           **refresh**(3X) or some equivalent **curses** routine (the implicit
           **doupdate** triggered by an **curses** input request will do).
    
           The function **unpost_form** erases form from its associated
           subwindow.
    


## RETURN VALUE



           These routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_BAD_STATE**
                Routine was called from an initialization or termination
                function.
    
           **E_NOT_POSTED**
                The form has not been posted.
    
           **E_NOT_CONNECTED**
                No items are connected to the form.
    
           **E_NO_ROOM**
                Form is too large for its window.
    
           **E_POSTED**
                The form has already been posted.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



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


* * *