tripathysagar/man_text huggingface dataset:
# catgets

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



           catgets — read a program message
    


## SYNOPSIS



           #include <nl_types.h>
    
           char *catgets(nl_catd _catd_ , int _set_id_ , int _msg_id_ , const char *_s_);
    


## DESCRIPTION



           The _catgets_() function shall attempt to read message _msg_id_ , in
           set _set_id_ , from the message catalog identified by _catd_.  The _catd_
           argument is a message catalog descriptor returned from an earlier
           call to _catopen_().  The results are undefined if _catd_ is not a
           value returned by _catopen_() for a message catalog still open in
           the process. The _s_ argument points to a default message string
           which shall be returned by _catgets_() if it cannot retrieve the
           identified message.
    
           The _catgets_() function need not be thread-safe.
    


## RETURN VALUE



           If the identified message is retrieved successfully, _catgets_()
           shall return a pointer to an internal buffer area containing the
           null-terminated message string. If the call is unsuccessful for
           any reason, _s_ shall be returned and _errno_ shall be set to indicate
           the error.
    


## ERRORS



           The _catgets_() function shall fail if:
    
           **EINTR** The read operation was terminated due to the receipt of a
                  signal, and no data was transferred.
    
           **ENOMSG** The message identified by _set_id_ and _msg_id_ is not in the
                  message catalog.
    
           The _catgets_() function may fail if:
    
           **EBADF** The _catd_ argument is not a valid message catalog descriptor
                  open for reading.
    
           **EBADMSG**
                  The message identified by _set_id_ and _msg_id_ in the
                  specified message catalog did not satisfy implementation-
                  defined security criteria.
    
           **EINVAL** The message catalog identified by _catd_ is corrupted.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# getttyent

## NAME



           getttyent, getttynam, setttyent, endttyent - get ttys file entry
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <ttyent.h>**
    
           **struct ttyent *getttyent(void);**
           **struct ttyent *getttynam(const char ***_name_**);**
    
           **int setttyent(void);**
           **int endttyent(void);**
    


## DESCRIPTION



           These functions provide an interface to the file **_PATH_TTYS**(e.g.,
           _/etc/ttys_).
    
           The function **setttyent**() opens the file or rewinds it if already
           open.
    
           The function **endttyent**() closes the file.
    
           The function **getttynam**() searches for a given terminal name in the
           file.  It returns a pointer to a _ttyent_ structure (description
           below).
    
           The function **getttyent**() opens the file **_PATH_TTYS**(if necessary)
           and returns the first entry.  If the file is already open, the
           next entry.  The _ttyent_ structure has the form:
    
               struct ttyent {
                   char *ty_name;     /* terminal device name */
                   char *ty_getty;    /* command to execute, usually getty */
                   char *ty_type;     /* terminal type for termcap */
                   int   ty_status;   /* status flags */
                   char *ty_window;   /* command to start up window manager */
                   char *ty_comment;  /* comment field */
               };
    
           _ty_status_ can be:
    
               #define TTY_ON     0x01  /* enable logins (start ty_getty program) */
               #define TTY_SECURE 0x02  /* allow UID 0 to login */
    


## ATTRIBUTES



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


## STANDARDS



           BSD.
    


## NOTES



           Under Linux, the file _/etc/ttys_ , and the functions described
           above, are not used.
    


* * *
# probe::netdev.register

## NAME



           probe::netdev.register - Called when the device is registered
    


## SYNOPSIS



           netdev.register
    


## VALUES



           _dev_name_
               The device that is going to be registered
    


* * *
# gnutls_x509_crl_init

## NAME



           gnutls_x509_crl_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_init(gnutls_x509_crl_t ***_crl_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t * crl
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a CRL structure. CRL stands for
           Certificate Revocation List. A revocation list usually contains
           lists of certificate serial numbers that have been revoked by an
           Authority. The revocation lists are always signed with the
           authority's private key.
    


## RETURNS



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


* * *
# pcap_lookupdev

## NAME



           pcap_lookupdev - find the default device on which to capture
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **char errbuf[PCAP_ERRBUF_SIZE];**
    
           **[DEPRECATED] char *pcap_lookupdev(char *errbuf);**
    


## DESCRIPTION



           **This interface is obsoleted by pcap_findalldevs**(3PCAP).  To find a
           default device on which to capture, call **pcap_findalldevs**() and,
           if the list it returns is not empty, use the first device in the
           list.  (If the list is empty, there are no devices on which
           capture is possible.)  _errbuf_ is a buffer large enough to hold at
           least **PCAP_ERRBUF_SIZE** chars.
    
           **If pcap_init**(3PCAP) **has been called, this interface always returns**
           **NULL**.
    
           **pcap_lookupdev**() returns a pointer to a string giving the name of
           a network device suitable for use with **pcap_create**(3PCAP) and
           **pcap_activate**(3PCAP), or with **pcap_open_live**(3PCAP), and with
           **pcap_lookupnet**(3PCAP).  If there is an error, or if
           **pcap_init**(3PCAP) has been called, **NULL** is returned and _errbuf_ is
           filled in with an appropriate error message.
    


## BUGS



           The pointer returned by **pcap_lookupdev**() points to a static
           buffer; subsequent calls to **pcap_lookupdev**() in the same thread,
           or calls to **pcap_lookupdev**() in another thread, may overwrite that
           buffer.
    
           In WinPcap and Npcap, this function may return a UTF-16 string
           rather than an ASCII or UTF-8 string.
    


* * *
# ldap_first_entry

## NAME



           ldap_first_entry, ldap_next_entry, ldap_count_entries - LDAP
           result entry parsing and counting routines
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_count_entries( LDAP *ld, LDAPMessage *result )**
    
           **LDAPMessage *ldap_first_entry( LDAP *ld, LDAPMessage *result )**
    
           **LDAPMessage *ldap_next_entry( LDAP *ld, LDAPMessage *entry )**
    


## DESCRIPTION



           These routines are used to parse results received from
           ldap_result(3) or the synchronous LDAP search operation routines
           ldap_search_s(3) and ldap_search_st(3).
    
           The **ldap_first_entry()** routine is used to retrieve the first entry
           in a chain of search results.  It takes the _result_ as returned by
           a call to ldap_result(3) or ldap_search_s(3) or ldap_search_st(3)
           and returns a pointer to the first entry in the result.
    
           This pointer should be supplied on a subsequent call to
           **ldap_next_entry()** to get the next entry, the result of which
           should be supplied to the next call to **ldap_next_entry()** , etc.
           **ldap_next_entry()** will return NULL when there are no more entries.
           The entries returned from these calls are used in calls to the
           routines described in ldap_get_dn(3), ldap_first_attribute(3),
           ldap_get_values(3), etc.
    
           A count of the number of entries in the search result can be
           obtained by calling **ldap_count_entries()**.
    


## ERRORS



           If an error occurs in **ldap_first_entry()** or **ldap_next_entry()** ,
           NULL is returned and the ld_errno field in the _ld_ parameter is set
           to indicate the error.  If an error occurs in
           **ldap_count_entries()** , -1 is returned, and **ld_errno** is set
           appropriately.  See ldap_error(3) for a description of possible
           error codes.
    


## ACKNOWLEDGEMENTS



           **OpenLDAP Software** is developed and maintained by The OpenLDAP
           Project <http://www.openldap.org/>.  **OpenLDAP Software** is derived
           from the University of Michigan LDAP 3.3 Release.
    


* * *
# libpfm_intel_skx_unc_iio

## NAME



           libpfm_intel_skx_unc_ubo - support for Intel Skylake X Server IIO
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_iio[0-5]**
           **PMU desc: Intel Skylake X Server IIO uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X server IIO uncore PMU.
           The IIO PMU is used to analyze I/O traffic from the PCIe
           controllers.
    


## MODIFIERS



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


## Filters



           Events UNC_IO_COMP_BUF_INSERTS, UNC_IO_DATA_REQ_BY_CPU,
           UNC_IO_DATA_REQ_OF_CPU, support additional filtering via a set of
           umasks tracking requests completions. They umasks start with a FC_
           prefix.  The other filter is the port filter and it is hardcoded
           as umasks for the same events.
    


* * *
# _longjmp

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



           _longjmp, _setjmp — non-local goto
    


## SYNOPSIS



           #include <setjmp.h>
    
           void _longjmp(jmp_buf _env_ , int _val_);
           int _setjmp(jmp_buf _env_);
    


## DESCRIPTION



           The __longjmp_() and __setjmp_() functions shall be equivalent to
           _longjmp_() and _setjmp_(), respectively, with the additional
           restriction that __longjmp_() and __setjmp_() shall not manipulate the
           signal mask.
    
           If __longjmp_() is called even though _env_ was never initialized by a
           call to __setjmp_(), or when the last such call was in a function
           that has since returned, the results are undefined.
    


## RETURN VALUE



           Refer to longjmp(3p) and setjmp(3p).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           If __longjmp_() is executed and the environment in which __setjmp_()
           was executed no longer exists, errors can occur. The conditions
           under which the environment of the __setjmp_() no longer exists
           include exiting the function that contains the __setjmp_() call, and
           exiting an inner block with temporary storage. This condition
           might not be detectable, in which case the __longjmp_() occurs and,
           if the environment no longer exists, the contents of the temporary
           storage of an inner block are unpredictable. This condition might
           also cause unexpected process termination. If the function has
           returned, the results are undefined.
    
           Passing _longjmp_() a pointer to a buffer not created by _setjmp_(),
           passing __longjmp_() a pointer to a buffer not created by __setjmp_(),
           passing _siglongjmp_() a pointer to a buffer not created by
           _sigsetjmp_(), or passing any of these three functions a buffer that
           has been modified by the user can cause all the problems listed
           above, and more.
    
           The __longjmp_() and __setjmp_() functions are included to support
           programs written to historical system interfaces. New applications
           should use _siglongjmp_() and _sigsetjmp_() respectively.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           The __longjmp_() and __setjmp_() functions may be removed in a future
           version.
    


* * *
# sd_bus_slot_get_bus

## NAME



           sd_bus_slot_get_bus, sd_bus_slot_get_current_handler,
           sd_bus_slot_get_current_message, sd_bus_slot_get_current_userdata
           - Query information attached to a bus slot object
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **typedef int (*sd_bus_message_handler_t)(sd_bus_message ***_m_**,**
                                                   **void ***_userdata_**,**
                                                   **sd_bus_error ***_ret_error_**);**
    
           **sd_bus *sd_bus_slot_get_bus(sd_bus_slot ***_slot_**);**
    
           **sd_bus_message_handler_t**
                                                                    **sd_bus_slot_get_current_handler(sd_bus_slot ***_slot_**);**
    
           **sd_bus_message**
                                                           ***sd_bus_slot_get_current_message(sd_bus_slot ***_slot_**);**
    
           **void *sd_bus_slot_get_current_userdata(sd_bus_slot ***_slot_**);**
    


## DESCRIPTION



           **sd_bus_slot_get_bus()** returns the bus object that message _slot_ is
           attached to.
    
           **sd_bus_slot_get_current_handler()** ,
           **sd_bus_slot_get_current_message()** and
           **sd_bus_slot_get_current_userdata()** return the current handler,
           message and userdata respectively of the bus _slot_ is attached to
           if we're currently executing the callback associated with _slot_.
    


## RETURN VALUE



           **sd_bus_slot_get_bus()** always returns the bus object.
    
           On success, **sd_bus_slot_get_current_handler()** ,
           **sd_bus_slot_get_current_message()** and
           **sd_bus_slot_get_current_userdata()** return the requested object. On
           failure, they return **NULL**.
    


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


* * *
# libpfm_intel_ivbep_unc_ha

## NAME



           libpfm_intel_ivbep_unc_ha - support for Intel Ivy Bridge-EP Home
           Agent (HA) uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: ivbep_unc_ha0, ivbep_unc_ha1**
           **PMU desc: Intel Ivy Bridge-EP HA uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Ivy Bridge Home Agent (HA) uncore
           PMU.  This PMU model only exists on Ivy Bridge model 62.
    


## MODIFIERS



           The following modifiers are supported on Intel Ivy Bridge HA
           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 HA 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].
    


* * *
# function::s32_arg

## NAME



           function::s32_arg - Return function argument as signed 32-bit
           value
    


## SYNOPSIS



               s32_arg:long(n:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    


## DESCRIPTION



           Return the signed 32-bit value of argument n, same as int_arg.
    


* * *
# pow10

## NAME



           pow10, pow10f, pow10l - base-10 power functions
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#define _GNU_SOURCE** /* See feature_test_macros(7) */
           **#include <math.h>**
    
           **double pow10(double** _x_**);**
           **float pow10f(float** _x_**);**
           **long double pow10l(long double** _x_**);**
    


## DESCRIPTION



           These functions return the value of 10 raised to the power _x_.
    
           **Note well** : These functions perform exactly the same task as the
           functions described in exp10(3), with the difference that the
           latter functions are now standardized in TS 18661-4:2015.  Those
           latter functions should be used in preference to the functions
           described in this page.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## VERSIONS



           glibc 2.1.  Removed in glibc 2.27.
    


* * *
# curs_addstr

## NAME



           **addstr** , **addnstr** , **waddstr** , **waddnstr** , **mvaddstr** , **mvaddnstr** ,
           **mvwaddstr** , **mvwaddnstr** - add a string of characters to a **curses**
           window and advance cursor
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int addstr(const char ***_str_**);**
           **int addnstr(const char ***_str_**, int** _n_**);**
           **int waddstr(WINDOW ***_win_**, const char ***_str_**);**
           **int waddnstr(WINDOW ***_win_**, const char ***_str_**, int** _n_**);**
    
           **int mvaddstr(int** _y_**, int** _x_**, const char ***_str_**);**
           **int mvaddnstr(int** _y_**, int** _x_**, const char ***_str_**, int** _n_**);**
           **int mvwaddstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const char ***_str_**);**
           **int mvwaddnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const char ***_str, int n_**);**
    


## DESCRIPTION



           These  functions  write the (null-terminated) character string _str_
           on the given window.  It is similar to  calling  **waddch** once  for
           each byte in the string.
    
           The  _mv_ functions perform cursor movement once, before writing any
           characters.  Thereafter, the cursor is advanced as  a  side-effect
           of writing to the window.
    
           The  four  functions  with  _n_ as the last argument write at most _n_
           bytes, or until a terminating null is reached.  If _n_ is  -1,  then
           the entire string will be added.
    


## RETURN VALUE



           All  functions  return the integer **ERR** upon failure and **OK** on suc‐
           cess.
    
           X/Open does not define any error conditions.  This  implementation
           returns an error
    
           •   if the window pointer is null or
    
           •   if the string pointer is null or
    
           •   if the corresponding calls to **waddch** return an error.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.  If an error is returned by the
           **wmove** , no characters are added to the window.
    
           If an error is returned by **waddch**(e.g., because the window is not
           large enough, or an illegal byte sequence was detected) only part
           of the string may be added.  Aside from that, there is a special
           case in **waddch** where an error may be returned after successfully
           writing a character to the lower-right corner of a window when
           **scrollok**(3X) is disabled.
    


## NOTES



           All of these functions except **waddnstr** may be macros.
    


## PORTABILITY



           These functions are described in the XSI Curses standard, Issue 4.
    


* * *
# curs_inwstr

## NAME



           **inwstr** , **innwstr** , **winwstr** , **winnwstr** , **mvinwstr** , **mvinnwstr** ,
           **mvwinwstr** , **mvwinnwstr** - get a string of **wchar_t** characters from a
           curses window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int inwstr(wchar_t ***_wstr_**);**
           **int innwstr(wchar_t ***_wstr_**, int** _n_**);**
           **int winwstr(WINDOW ***_win_**, wchar_t ***_wstr_**);**
           **int winnwstr(WINDOW ***_win_**, wchar_t ***_wstr_**, int** _n_**);**
    
           **int mvinwstr(int** _y_**, int** _x_**, wchar_t ***_wstr_**);**
           **int mvinnwstr(int** _y_**, int** _x_**, wchar_t ***_wstr_**, int** _n_**);**
           **int mvwinwstr(WINDOW ***_win_**, int** _y_**, int** _x_**, wchar_t ***_wstr_**);**
           **int mvwinnwstr(WINDOW ***_win_**, int** _y_**, int** _x_**, wchar_t ***_wstr_**, int** _n_**);**
    


## DESCRIPTION



           These routines return a string of **wchar_t** wide characters in _wstr_ ,
           extracted starting at the current cursor position in the named
           window.
    
           The four functions with _n_ as the last argument return a leading
           substring at most _n_ characters long (exclusive of the trailing
           NUL).  Transfer stops at the end of the current line, or when _n_
           characters have been stored at the location referenced by _wstr_.
    
           If the size _n_ is not large enough to store a complete complex
           character, an error is generated.
    


## NOTES



           All routines except **winnwstr** may be macros.
    
           Each cell in the window holds a complex character (i.e., base- and
           combining-characters) together with attributes and color.  These
           functions store only the wide characters, ignoring attributes and
           color.  Use **in_wchstr** to return the complex characters from a
           window.
    


## RETURN VALUE



           All routines return **ERR** upon failure.  Upon successful completion,
           the * **inwstr** routines return **OK** , and the * **innwstr** routines return
           the number of characters read into the string.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


* * *
# gnutls_ecc_curve_get

## NAME



           gnutls_ecc_curve_get - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_ecc_curve_t gnutls_ecc_curve_get(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



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


## RETURNS



           the currently used curve, a **gnutls_ecc_curve_t** type.
    


## SINCE



           3.0
    


* * *
# pcap_datalink_val_to_description

## NAME



           pcap_datalink_val_to_name, pcap_datalink_val_to_description,
           pcap_datalink_val_to_description_or_dlt - get a name or
           description for a link-layer header type value
    


## SYNOPSIS



           **#include <pcap.h>**
    
           **const char *pcap_datalink_val_to_name(int dlt);**
           **const char *pcap_datalink_val_to_description(int dlt);**
           **const char *pcap_datalink_val_to_description_or_dlt(int dlt);**
    


## DESCRIPTION



           **pcap_datalink_val_to_name**() translates a link-layer header type
           value to the corresponding link-layer header type name, which is
           the **DLT_** name for the link-layer header type value with the **DLT_**
           removed.  **NULL** is returned if the type value does not correspond
           to a known **DLT_** value.
    
           **pcap_datalink_val_to_description**() translates a link-layer header
           type value to a short description of that link-layer header type.
           **NULL** is returned if the type value does not correspond to a known
           **DLT_** value.
    
           **pcap_datalink_val_to_description_or_dlt**() translates a link-layer
           header type value to a short description of that link-layer header
           type just like **pcap_datalink_val_to_description**().  If the type
           value does not correspond to a known **DLT_** value, the string "DLT
           n" is returned, where n is the value of the dlt argument.
    


## BACKWARD COMPATIBILITY



           The **pcap_datalink_val_to_description_or_dlt**() function first
           became available in libpcap release 1.9.1.  In previous releases,
           **pcap_datalink_val_to_description**() would have to be called and, if
           it returned **NULL** , a default string would have to be constructed.
    


* * *
# pcre2_substring_length_bynumber

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_length_bynumber(pcre2_match_data ***_match_data_**,**
             **uint32_t** _number_**, PCRE2_SIZE ***_length_**);**
    


## DESCRIPTION



    
           This function returns the length of a matched substring,
           identified by number.  The arguments are:
    
             _match_data_   The match data block for the match
             _number_       The substring number
             _length_       Where to return the length, or NULL
    
           The third argument may be NULL if all you want to know is whether
           or not a substring is set. The yield is zero on success, or a
           negative error code otherwise. After a partial match, only
           substring 0 is available.
    
           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.
    


* * *
# fenv_t

## NAME



           fenv_t, fexcept_t - floating-point environment
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <fenv.h>**
    
           **typedef** /* ... */ **fenv_t;**
           **typedef** /* ... */ **fexcept_t;**
    


## DESCRIPTION



           _fenv_t_ represents the entire floating-point environment, including
           control modes and status flags.
    
           _fexcept_t_ represents the floating-point status flags collectively.
    
           For further details see fenv(3).
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# libpfm_intel_rapl

## NAME



           libpfm_intel_rapl - support for Intel RAPL PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: rapl**
           **PMU desc: Intel RAPL (Intel SandyBridge, IvyBridge, Haswell)**
    


## DESCRIPTION



           The library supports the Intel Running Average Power Limit (RAPL)
           energy consumption counters. This is a socket-level set of
           counters which reports energy consumption in Joules. There are up
           to 3 counters each measuring only one event. The following events
           are defined:
    
           **RAPL_ENERGY_CORES**
                  On all processors, the event reports the number of Joules
                  consumed by all cores.
                   On all processors,
    
           **RAPL_ENERGYC_PKG**
                  On all processors, th event reports the number of Joules
                  consumed by all the cores and Last Level cache (L3).
    
           **RAPL_ENERGY_DRAM**
                  On server processors, the event reports the number of
                  Joules consumed n by the DRAM controller.
    
                  By construction, the events are socket-level and can only
                  be measured in system-wide mode. It is necessary and
                  sufficient to measure only one CPU per socket to get
                  meaningful results.
    


## MODIFIERS



           The PMU does not support any modifiers.
    


* * *
# __pmequivindom

## NAME



           **__pmEquivInDom** - check if two instance domains are equivalent
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
    
           **int __pmEquivInDom(pmInDom** _a_**, pmInDom** _b_**)**
    
           **cc ... -lpcp**
    


## CAVEAT



           This  documentation  is intended for internal Performance Co-Pilot
           (PCP) developer use.
    
           These interfaces are not part of the PCP APIs that are  guaranteed
           to  remain  fixed across releases, and at some point in the future
           they may not work or may provide different semantics.
    


## DESCRIPTION



           Within the Performance Co-Pilot (PCP) each instance domain is  as‐
           signed  a unique Instance Domain Identifier (pmInDom).  Internally
           a pmInDom is constructed from 2 fields: the domain number (of  the
           associated Performance Metrics Domain Agent, or PMDA) and the ser‐
           ial number (assigned by the PMDA).
    
           In some unusual circumstances different PMDAs may support indepen‐
           dent  Instance  Domains that are semantically equivalent, e.g. per
           CPU or per process identifier.  **__pmEquivInDom** provides  a  mecha‐
           nism  to  determine if Instance Domain _a_ is equivalent to Instance
           Domain _b_.
    
           The ``equivalence'' of Instance Domains is defined by an  external
           configuration   file,   identified  by  the  environment  variable
           **$PCP_INDOM_CONFIG** or  **$PCP_ETC_DIR/pcp/indom.config** by  default.
           The format for the configuration file is defined in the CONFIGURA‐
           TION FILE section below.
    
           If **$PCP_INDOM_CONFIG** is an empty string, no equivalence mapping is
           loaded.
    


## CONFIGURATION FILE



           An  Instance  Domain equivalence mapping file conforms to the fol‐
           lowing syntax:
           1.  Lines beginning with optional white space, followed by ``#''
               are considered comments.
           2.  Blank lines are ignored.
           3.  Each remaining line defines one `equivalence map'' with a list
               of white-space separated instance domains, each consisting of
               a number (the domain number), a period ``.'' and a number (the
               serial number).  As a special case to ``match all serial num‐
               bers'', the serial number part can be ``*''.
    
           The format of a _pmInDom_ demands that a domain number is in the
           range 0 to 511, and a numeric serial number is in the range 0 to
           4194303.
    


## DIAGNOSTICS AND RETURN VALUES



           The return value is 1 if the Instance Domains are equivalent, else
           0 if they are not.  In rare cases a return value of -1 is used to
           indicate some problem (reported on standard error) in opening or
           parsing the configuration file.
    


* * *
# va_arg

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



           va_arg, va_copy, va_end, va_start — handle variable argument list
    


## SYNOPSIS



           #include <stdarg.h>
    
           _type_ va_arg(va_list _ap_ , _type_);
           void va_copy(va_list _dest_ , va_list _src_);
           void va_end(va_list _ap_);
           void va_start(va_list _ap_ , _argN_);
    


## DESCRIPTION



           Refer to the Base Definitions volume of POSIX.1‐2017, stdarg.h(0p)
    


* * *
# swab

## NAME



           swab - swap adjacent bytes
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#define _XOPEN_SOURCE** /* See feature_test_macros(7) */
           **#include <unistd.h>**
    
           **void swab(** ssize_t n;
                     **const void** _from_**[restrict** _n_**], void** _to_**[restrict** _n_**],**
                     **ssize_t** _n_**);**
    


## DESCRIPTION



           The **swab**() function copies _n_ bytes from the array pointed to by
           _from_ to the array pointed to by _to_ , exchanging adjacent even and
           odd bytes.  This function is used to exchange data between
           machines that have different low/high byte ordering.
    
           This function does nothing when _n_ is negative.  When _n_ is positive
           and odd, it handles _n-1_ bytes as above, and does something
           unspecified with the last byte.  (In other words, _n_ should be
           even.)
    


## RETURN VALUE



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


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# sd_bus_message_append_strv

## NAME



           sd_bus_message_append_strv - Attach an array of strings to a
           message
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_append_strv(sd_bus_message ***_m_**, char ****_l_**);**
    


## DESCRIPTION



           The **sd_bus_message_append()** function can be used to append an
           array of strings to message _m_. The parameter _l_ shall point to a
           **NULL** -terminated array of pointers to **NUL** -terminated strings. Each
           string must satisfy the same constraints as described for the "s"
           type in sd_bus_message_append_basic(3).
    
           The memory pointed at by _p_ and the contents of the strings
           themselves are copied into the memory area containing the message
           and may be changed after this call. Note that the signature of _l_
           parameter is to be treated as **const char *const *** , and the
           contents will not be modified.
    


## RETURN VALUE



           On success, this call returns 0 or a positive integer. On failure,
           a negative errno-style error code is returned.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               Specified parameter is invalid.
    
           **-EPERM**
               Message has been sealed.
    
           **-ESTALE**
               Message is in invalid state.
    
           **-ENXIO**
               Message cannot be appended to.
    
           **-ENOMEM**
               Memory allocation failed.
    


## 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. The D-Bus specification
               https://dbus.freedesktop.org/doc/dbus-specification.html
    


* * *
# gnutls_x509_crl_dist_points_deinit

## NAME



           gnutls_x509_crl_dist_points_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **void**
           **gnutls_x509_crl_dist_points_deinit(gnutls_x509_crl_dist_points_t**
           _cdp_**);**
    


## ARGUMENTS



           gnutls_x509_crl_dist_points_t cdp
                       The CRL distribution points
    


## DESCRIPTION



           This function will deinitialize a CRL distribution points type.
    


## SINCE



           3.3.0
    


* * *
# gnutls_ocsp_resp_get_nonce

## NAME



           gnutls_ocsp_resp_get_nonce - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_get_nonce(gnutls_ocsp_resp_const_t** _resp_**,**
           **unsigned int ***_critical_**, gnutls_datum_t ***_nonce_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       should contain a **gnutls_ocsp_resp_t** type
    
           unsigned int * critical
                       whether nonce extension is marked critical
    
           gnutls_datum_t * nonce
                       will hold newly allocated buffer with nonce data
    


## DESCRIPTION



           This function will return the Basic OCSP Response nonce extension
           data.
    
           The caller needs to deallocate memory by calling **gnutls_free()** on
            _nonce_ ->data.
    


## RETURNS



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


* * *
# curs_instr

## NAME



           **instr** , **innstr** , **winstr** , **winnstr** , **mvinstr** , **mvinnstr** , **mvwinstr** ,
           **mvwinnstr** - get a string of characters from a **curses** window
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int instr(char ***_str_**);**
           **int innstr(char ***_str_**, int** _n_**);**
           **int winstr(WINDOW ***_win_**, char ***_str_**);**
           **int winnstr(WINDOW ***_win_**, char ***_str_**, int** _n_**);**
    
           **int mvinstr(int** _y_**, int** _x_**, char ***_str_**);**
           **int mvinnstr(int** _y_**, int** _x_**, char ***_str_**, int** _n_**);**
           **int mvwinstr(WINDOW ***_win_**, int** _y_**, int** _x_**, char ***_str_**);**
           **int mvwinnstr(WINDOW ***_win_**, int** _y_**, int** _x_**, char ***_str_**, int** _n_**);**
    


## DESCRIPTION



           These routines return a string of characters in _str_ , extracted
           starting at the current cursor position in the named window.
           Attributes are stripped from the characters.  The four functions
           with _n_ as the last argument return a leading substring at most _n_
           characters long (exclusive of the trailing NUL).
    


## RETURN VALUE



           All of the functions return **ERR** upon failure, or the number of
           characters actually read into the string.
    
           X/Open Curses defines no error conditions.  In this
           implementation:
    
           •   If the _win_ parameter is null, an error is returned,
    
           •   If the _chstr_ parameter is null, an error is returned,
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


## NOTES



           Note that all routines except **winnstr** may be macros.
    


## PORTABILITY



           SVr4 does not document whether a length limit includes or excludes
           the trailing NUL.
    
           The ncurses library extends the XSI description by allowing a
           negative value for _n_.  In this case, the functions return the
           string ending at the right margin.
    


* * *
# audit_open

## NAME



           audit_open - Open a audit netlink socket connection
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_open(void);**
    


## DESCRIPTION



           audit_open creates a NETLINK_AUDIT socket for communication with
           the kernel part of the Linux Audit Subsystem. The audit system
           uses the ACK feature of netlink. This means that every message to
           the kernel will return a netlink status packet even if the
           operation succeeds.
    


## RETURN VALUE



           Returns -1 if an error occurs; otherwise, the return value is a
           descriptor referencing the socket.
    


## ERRORS



           The **audit_open**() function may fail and set _errno_ for any of the
           errors specified for the socket(2) and fcntl(2) routines.
    


* * *
# isalpha

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



           isalpha, isalpha_l — test for an alphabetic character
    


## SYNOPSIS



           #include <ctype.h>
    
           int isalpha(int _c_);
           int isalpha_l(int _c_ , locale_t _locale_);
    


## DESCRIPTION



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


## RETURN VALUE



           The _isalpha_() and _isalpha_l_() functions shall return non-zero if _c_
           is an alphabetic character; 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.
    


* * *