tripathysagar/man_text huggingface dataset:
# getprotobyname

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



           getprotobyname, getprotobynumber, getprotent — network protocol
           database functions
    


## SYNOPSIS



           #include <netdb.h>
    
           struct protoent *getprotobyname(const char *_name_);
           struct protoent *getprotobynumber(int _proto_);
           struct protoent *getprotoent(void);
    


## DESCRIPTION



           Refer to endprotoent(3p).
    


* * *
# probe::sunrpc.clnt.call_async

## NAME



           probe::sunrpc.clnt.call_async - Make an asynchronous RPC call
    


## SYNOPSIS



           sunrpc.clnt.call_async
    


## VALUES



           _prog_
               the RPC program number
    
           _prot_
               the IP protocol number
    
           _port_
               the port number
    
           _vers_
               the RPC program version number
    
           _proc_
               the procedure number in this RPC call
    
           _dead_
               whether this client is abandoned
    
           _xid_
               current transmission id
    
           _servername_
               the server machine name
    
           _procname_
               the procedure name in this RPC call
    
           _flags_
               flags
    
           _progname_
               the RPC program name
    


* * *
# getline

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



           getline — read a delimited record from _stream_
    


## SYNOPSIS



           #include <stdio.h>
    
           ssize_t getline(char **restrict _lineptr_ , size_t *restrict _n_ ,
               FILE *restrict _stream_);
    


## DESCRIPTION



           Refer to getdelim(3p).
    


* * *
# avc_cache_stats

## NAME



           avc_cache_stats, avc_av_stats, avc_sid_stats - obtain userspace
           SELinux AVC statistics
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/avc.h>**
    
           **void avc_av_stats(void);**
    
           **void avc_sid_stats(void);**
    
           **void avc_cache_stats(struct avc_cache_stats ***_stats_**);**
    


## DESCRIPTION



           The userspace AVC maintains two internal hash tables, one to store
           security ID's and one to cache access decisions.
    
           **avc_av_stats**() and **avc_sid_stats**() produce log messages indicating
           the status of the access decision and SID tables, respectively.
           The messages contain the number of entries in the table, number of
           hash buckets and number of buckets used, and maximum number of
           entries in a single bucket.
    
           **avc_cache_stats**() populates a structure whose fields reflect cache
           activity:
    
                  struct avc_cache_stats {
                      unsigned  entry_lookups;
                      unsigned  entry_hits;
                      unsigned  entry_misses;
                      unsigned  entry_discards;
                      unsigned  cav_lookups;
                      unsigned  cav_hits;
                      unsigned  cav_probes;
                      unsigned  cav_misses;
                  };
    
           _entry_lookups_
                  Number of queries made.
    
           _entry_hits_
                  Number of times a decision was found in the _aeref_ argument.
    
           _entry_misses_
                  Number of times a decision was not found in the _aeref_
                  argument.
    
           _entry_discards_
                  Number of times a decision was not found in the _aeref_
                  argument and the _aeref_ argument was non-NULL.
    
           _cav_lookups_
                  Number of cache lookups.
    
           _cav_hits_
                  Number of cache hits.
    
           _cav_misses_
                  Number of cache misses.
    
           _cav_probes_
                  Number of entries examined while searching the cache.
    


## NOTES



           When the cache is flushed as a result of a call to **avc_reset**() or
           a policy change notification, the statistics returned by
           **avc_cache_stats**() are reset to zero.  The SID table, however, is
           left unchanged.
    
           When a policy change notification is received, a call to
           **avc_av_stats**() is made before the cache is flushed.
    


* * *
# gnutls_certificate_set_x509_system_trust

## NAME



           gnutls_certificate_set_x509_system_trust - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_system_trust(gnutls_certificate_credentials_t**
           _cred_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t cred
                       is a **gnutls_certificate_credentials_t** type.
    


## DESCRIPTION



           This function adds the system's default trusted CAs in order to
           verify client or server certificates.
    
           In the case the system is currently unsupported
           **GNUTLS_E_UNIMPLEMENTED_FEATURE** is returned.
    


## RETURNS



           the number of certificates processed or a negative error code on
           error.
    


## SINCE



           3.0.20
    


* * *
# gnutls_x509_crq_deinit

## NAME



           gnutls_x509_crq_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_crq_deinit(gnutls_x509_crq_t** _crq_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       the type to be deinitialized
    


## DESCRIPTION



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


* * *
# pmaputlog

## NAME



           **pmaPutLog** - direct write of the next record from an archive file
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **void pmaPutLog(FILE ***_f_**, __int32_t ***_rbuf_**);**
    
           **cc ... -lpcp_archive -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 they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           This is a cut-down version of the archive record reading  routines
           from  libpcp,  that  writes the next physical record on the stream
           identified by _f_.
    
           The record is already formatted in _rbuf_ , including  the  setup  of
           the  record  header length and trailer length, and _rbuf_ must be in
           network byte-order.
    
           There is no checking, so the record format  must  be  correct  and
           match  the semantics of which ever physical file (metadata or data
           volume) that is associated with _f_.
    


## DIAGNOSTICS AND RETURN VALUES



           The return value is 0 if all is well, else some  error  code  less
           than zero.
    


* * *
# posix_spawnattr_getflags

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



           posix_spawnattr_getflags, posix_spawnattr_setflags — get and set
           the spawn-flags attribute of a spawn attributes object (**ADVANCED**
           **REALTIME**)
    


## SYNOPSIS



           #include <spawn.h>
    
           int posix_spawnattr_getflags(const posix_spawnattr_t *restrict _attr_ ,
               short *restrict _flags_);
           int posix_spawnattr_setflags(posix_spawnattr_t *_attr_ , short _flags_);
    


## DESCRIPTION



           The _posix_spawnattr_getflags_() function shall obtain the value of
           the _spawn-flags_ attribute from the attributes object referenced by
           _attr_.
    
           The _posix_spawnattr_setflags_() function shall set the _spawn-flags_
           attribute in an initialized attributes object referenced by _attr_.
    
           The _spawn-flags_ attribute is used to indicate which process
           attributes are to be changed in the new process image when
           invoking _posix_spawn_() or _posix_spawnp_().  It is the bitwise-
           inclusive OR of zero or more of the following flags:
    
           POSIX_SPAWN_RESETIDS
           POSIX_SPAWN_SETPGROUP
           POSIX_SPAWN_SETSIGDEF
           POSIX_SPAWN_SETSIGMASK
           POSIX_SPAWN_SETSCHEDPARAM
           POSIX_SPAWN_SETSCHEDULER
    
           These flags are defined in _< spawn.h>_.  The default value of this
           attribute shall be as if no flags were set.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getflags_() shall
           return zero and store the value of the _spawn-flags_ attribute of
           _attr_ into the object referenced by the _flags_ parameter; otherwise,
           an error number shall be returned to indicate the error.
    
           Upon successful completion, _posix_spawnattr_setflags_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setflags_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn option and need not be
           provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_set_version

## NAME



           gnutls_x509_crt_set_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_version(gnutls_x509_crt_t** _crt_**, unsigned**
           **int** _version_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           unsigned int version
                       holds the version number. For X.509v1 certificates
                       must be 1.
    


## DESCRIPTION



           This function will set the version of the certificate.  This must
           be one for X.509 version 1, and so on.  Plain certificates without
           extensions must have version set to one.
    
           To create well-formed certificates, you must specify version 3 if
           you use any certificate extensions.  Extensions are created by
           functions such as **gnutls_x509_crt_set_subject_alt_name()** or
           **gnutls_x509_crt_set_key_usage()**.
    


## RETURNS



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


* * *
# gnutls_hex_encode

## NAME



           gnutls_hex_encode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_hex_encode(const gnutls_datum_t ***_data_**, char ***_result_**,**
           **size_t ***_result_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * data
                       contain the raw data
    
           char * result
                       the place where hex data will be copied
    
           size_t * result_size
                       holds the size of the result
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the hex encoding, as used in the PSK password files.
    
           Note that the size of the result includes the null terminator.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the buffer given is not long
           enough, or 0 on success.
    


* * *
# wcwidth

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



           wcwidth — number of column positions of a wide-character code
    


## SYNOPSIS



           #include <wchar.h>
    
           int wcwidth(wchar_t _wc_);
    


## DESCRIPTION



           The _wcwidth_() function shall determine the number of column
           positions required for the wide character _wc_.  The application
           shall ensure that the value of _wc_ is a character representable as
           a **wchar_t** , and is a wide-character code corresponding to a valid
           character in the current locale.
    


## RETURN VALUE



           The _wcwidth_() function shall either return 0 (if _wc_ is a null
           wide-character code), or return the number of column positions to
           be occupied by the wide-character code _wc_ , or return -1 (if _wc_
           does not correspond to a printable wide-character code).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           This function was removed from the final
           ISO/IEC 9899:1990/Amendment 1:1995 (E), and the return value for a
           non-printable wide character is not specified.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_set_key_purpose_oid

## NAME



           gnutls_x509_crt_set_key_purpose_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_key_purpose_oid(gnutls_x509_crt_t** _cert_**,**
           **const void ***_oid_**, unsigned int** _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * oid
                       a pointer to a null terminated string that holds the
                       OID
    
           unsigned int critical
                       Whether this extension will be critical or not
    


## DESCRIPTION



           This function will set the key purpose OIDs of the Certificate.
           These are stored in the Extended Key Usage extension (2.5.29.37)
           See the GNUTLS_KP_* definitions for human readable names.
    
           Subsequent calls to this function will append OIDs to the OID
           list.
    


## RETURNS



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


* * *
# pcap_dump_ftell

## NAME



           pcap_dump_ftell, pcap_dump_ftell64 - get the current file offset
           for a savefile being written
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **long pcap_dump_ftell(pcap_dumper_t *p);**
           **int64_t pcap_dump_ftell64(pcap_dumper_t *p);**
    


## DESCRIPTION



           **pcap_dump_ftell**() returns the current file position for the
           ``savefile'', representing the number of bytes written by
           **pcap_dump_open**(3PCAP) and **pcap_dump**(3PCAP).  **PCAP_ERROR** is
           returned on error. If the current file position does not fit in a
           **long** , it will be truncated; this can happen on 32-bit UNIX-like
           systems with large file support and on Windows.
           **pcap_dump_ftell64**() returns the current file position in a
           **int64_t** , so if file offsets that don't fit in a **long** but that fit
           in a **int64_t** are supported, this will return the file offset
           without truncation.  **PCAP_ERROR** is returned on error.
    


## BACKWARD COMPATIBILITY



           The function **pcap_dump_ftell64**() became available in libpcap
           release 1.9.0.  In previous releases, there was no mechanism to
           obtain a file offset that is too large to fit in a **long**.
    


* * *
# pmunloadnamespace

## NAME



           **pmUnloadNameSpace** - unload a local performance metrics name space
           for an application
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **void pmUnloadNameSpace(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           If   one   has   previously   loaded  a  local  Name  Space  using
           pmLoadNameSpace(3)  or   pmLoadASCIINameSpace(3),   then   calling
           pmUnloadNameSpace(3)  will  free up the memory associated with the
           Name Space and force all subsequent PMNS routine calls to use  the
           distributed  PMNS.  If pmUnloadNameSpace(3) is called before call‐
           ing pmLoadNameSpace(3) or pmLoadASCIINameSpace(3),  then  it  will
           effectively do nothing.
    


* * *
# gnutls_x509_trust_list_deinit

## NAME



           gnutls_x509_trust_list_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_x509_trust_list_deinit(gnutls_x509_trust_list_t** _list_**,**
           **unsigned int** _all_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list to be deinitialized
    
           unsigned int all
                       if non-zero it will deinitialize all the certificates
                       and CRLs contained in the structure.
    


## DESCRIPTION



           This function will deinitialize a trust list. Note that the
            _all_ flag should be typically non-zero unless you have specified
           your certificates using **gnutls_x509_trust_list_add_cas()** and you
           want to prevent them from being deinitialized by this function.
    


## SINCE



           3.0.0
    


* * *
# getw

## NAME



           getw, putw - input and output of words (ints)
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdio.h>**
    
           **int getw(FILE ***_stream_**);**
           **int putw(int** _w_**, FILE ***_stream_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **getw**(), **putw**():
               Since glibc 2.3.3:
                   _XOPEN_SOURCE && ! (_POSIX_C_SOURCE >= 200112L)
                       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                       || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
               Before glibc 2.3.3:
                   _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE
    


## DESCRIPTION



           **getw**() reads a word (that is, an _int_) from _stream_.  It's provided
           for compatibility with SVr4.  We recommend you use fread(3)
           instead.
    
           **putw**() writes the word _w_ (that is, an _int_) to _stream_.  It is
           provided for compatibility with SVr4, but we recommend you use
           fwrite(3) instead.
    


## RETURN VALUE



           Normally, **getw**() returns the word read, and **putw**() returns 0.  On
           error, they return **EOF**.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


## BUGS



           The value returned on error is also a legitimate data value.
           ferror(3) can be used to distinguish between the two cases.
    


* * *
# gnutls_pkcs12_init

## NAME



           gnutls_pkcs12_init - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs12.h>**
    
           **int gnutls_pkcs12_init(gnutls_pkcs12_t ***_pkcs12_**);**
    


## ARGUMENTS



           gnutls_pkcs12_t * pkcs12
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a PKCS12 type. PKCS12 structures
           usually contain lists of X.509 Certificates and X.509 Certificate
           revocation lists.
    


## RETURNS



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


* * *
# pmnewcontextzone

## NAME



           **pmNewContextZone** - establish a reporting timezone based on a PMAPI
           context
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmNewContextZone(void);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  current  reporting  timezone  affects  the  timezone  used by
           pmCtime(3) and pmLocaltime(3).
    
           If the current PMAPI context is an archive, **pmNewContextZone** uses
           the  timezone from the archive label record to set the current re‐
           porting timezone.
    
           If the current PMAPI context corresponds to a host source of  met‐
           rics, **pmNewContextZone** executes a pmFetch(3) to retrieve the value
           for  the metric _pmcd.timezone_ and uses that to set the current re‐
           porting timezone.
    
           In both cases, **pmNewContextZone** returns a value  to  identify  the
           current  reporting  timezone that may be used in a subsequent call
           to pmUseZone(3) to restore this reporting timezone.
    


## DIAGNOSTICS



           **PM_ERR_NOCONTEXT**
                  the current PMAPI context is not valid
    
           other  a return value less than zero indicates a fatal error from
                  a system call, most likely malloc(3)
    


* * *
# probe::ioscheduler_trace.elv_abort_request

## NAME



           probe::ioscheduler_trace.elv_abort_request - Fires when a request
           is aborted.
    


## SYNOPSIS



           ioscheduler_trace.elv_abort_request
    


## VALUES



           _name_
               Name of the probe point
    
           _elevator_name_
               The type of I/O elevator currently enabled.
    
           _rq_
               Address of request.
    
           _rq_flags_
               Request flags.
    
           _disk_major_
               Disk major no of request.
    
           _disk_minor_
               Disk minor number of request.
    


* * *
# ldap_parse_sort_control

## NAME



           ldap_parse_sort_control - Decode the information returned from a
           search operation that used a server-side sort control
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_parse_sort_control(ld, ctrls, returnCode, attribute)**
           LDAP *ld;
           LDAPControl **ctrls;
           unsigned long *returnCode;
           char **attribute;
    


## DESCRIPTION



           This function is used to parse the results returned in a search
           operation that uses a server-side sort control.
    
           It takes a null terminated array of LDAPControl structures usually
           obtained by a call to the **ldap_parse_result** function. A returncode
           which points to the sort control result code,and an array of
           LDAPControl structures that list the client controls to use with
           the search.  The function also takes an out parameter _attribute_
           and if the sort operation fails, the server may return a string
           that indicates the first attribute in the sortKey list that caused
           the failure. If this parameter is NULL, no string is returned. If
           a string is returned, the memory should be freed by calling the
           ldap_memfree function.
    


## NOTES



    


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


* * *
# probe::irq_handler.exit

## NAME



           probe::irq_handler.exit - Execution of interrupt handler completed
    


## SYNOPSIS



           irq_handler.exit
    


## VALUES



           _dir_
               pointer to the proc/irq/NN/name entry
    
           _flags_str_
               symbolic string representation of IRQ flags
    
           _next_irqaction_
               pointer to next irqaction for shared interrupts
    
           _flags_
               flags for IRQ handler
    
           _thread_
               thread pointer for threaded interrupts
    
           _irq_
               interrupt number
    
           _dev_id_
               Cookie to identify device
    
           _thread_flags_
               Flags related to thread
    
           _thread_fn_
               interrupt handler function for threaded interrupts
    
           _handler_
               interrupt handler function that was executed
    
           _ret_
               return value of the handler
    
           _action_
               struct irqaction*
    
           _dev_name_
               name of device
    


* * *
# probe::sunrpc.svc.create

## NAME



           probe::sunrpc.svc.create - Create an RPC service
    


## SYNOPSIS



           sunrpc.svc.create
    


## VALUES



           _prog_
               the number of the program
    
           _progname_
               the name of the program
    
           _pg_nvers_
               the number of supported versions
    
           _bufsize_
               the buffer size
    


* * *
# ngettext

## NAME



           ngettext, dngettext, dcngettext - translate message and choose
           plural form
    


## SYNOPSIS



           **#include <libintl.h>**
    
           **char * ngettext (const char ***_msgid_**, const char ***_msgid_plural_**,**
                            **unsigned long int** _n_**);**
           **char * dngettext (const char ***_domainname_**,**
                             **const char ***_msgid_**, const char ***_msgid_plural_**,**
                             **unsigned long int** _n_**);**
           **char * dcngettext (const char ***_domainname_**,**
                              **const char ***_msgid_**, const char ***_msgid_plural_**,**
                              **unsigned long int** _n_**, int** _category_**);**
    


## DESCRIPTION



           The **ngettext** , **dngettext** and **dcngettext** functions attempt to
           translate a text string into the user's native language, by
           looking up the appropriate plural form of the translation in a
           message catalog.
    
           Plural forms are grammatical variants depending on the a number.
           Some languages have two forms, called singular and plural. Other
           languages have three forms, called singular, dual and plural.
           There are also languages with four forms.
    
           The **ngettext** , **dngettext** and **dcngettext** functions work like the
           **gettext** , **dgettext** and **dcgettext** functions, respectively.
           Additionally, they choose the appropriate plural form, which
           depends on the number _n_ and the language of the message catalog
           where the translation was found.
    
           In the "C" locale, or if none of the used catalogs contain a
           translation for _msgid_ , the **ngettext** , **dngettext** and **dcngettext**
           functions return _msgid_ if _n_ == 1, or _msgid_plural_ if _n_ != 1.
    


## RETURN VALUE



           If a translation was found in one of the specified catalogs, the
           appropriate plural form is converted to the locale's codeset and
           returned. The resulting string is statically allocated and must
           not be modified or freed. Otherwise _msgid_ or _msgid_plural_ is
           returned, as described above.
    


## ERRORS



           **errno** is not modified.
    


## BUGS



           The return type ought to be **const char *** , but is **char *** to avoid
           warnings in C code predating ANSI C.
    


* * *
# udev_enumerate_scan_devices

## NAME



           udev_enumerate_scan_devices, udev_enumerate_scan_subsystems,
           udev_enumerate_get_list_entry, udev_enumerate_add_syspath,
           udev_enumerate_get_udev - Query or modify a udev enumerate object
    


## SYNOPSIS



           **#include <libudev.h>**
    
           **int**
                                           **udev_enumerate_scan_devices(struct udev_enumerate ***_udev_enumerate_**);**
    
           **int**
                                              **udev_enumerate_scan_subsystems(struct udev_enumerate ***_udev_enumerate_**);**
    
           **struct udev_list_entry**
                                                                 ***udev_enumerate_get_list_entry(struct udev_enumerate ***_udev_enumerate_**);**
    
           **int**
                                          **udev_enumerate_add_syspath(struct udev_enumerate ***_udev_enumerate_**,**
                                          **const char ***_syspath_**);**
    
           **struct udev**
                                                ***udev_enumerate_get_udev(struct udev_enumerate ***_udev_enumerate_**);**
    


## RETURN VALUE



           On success, **udev_enumerate_scan_devices()** ,
           **udev_enumerate_scan_subsystems()** and **udev_enumerate_add_syspath()**
           return an integer greater than, or equal to, **0**.
    
           On success, **udev_enumerate_get_list_entry()** returns a pointer to
           the first entry in the list of found devices. If the list is
           empty, or on failure, **NULL** is returned.
    
           **udev_enumerate_get_udev()** always returns a pointer to the udev
           context that this enumerated object is associated with.
    


* * *
# pfm_initialize

## NAME



           pfm_initialize - initialize library
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **int pfm_initialize(void);**
    


## DESCRIPTION



           This is the first function that a program **must** call otherwise the
           library will not operate.  This function probes the underlying
           hardware looking for valid PMU event tables to activate.  Multiple
           distinct PMU tables may be activated at the same time.
    
           The function must be called only once. If the function is called
           more than once, it does not execute the initialization multiple
           times, it simply returns the same value as for the first call.
           This is **not a reentrant function**. Only one thread at a time can
           call the function
    


## RETURN



           The function returns whether or not it was successful, i.e., at
           least one PMU was activated. A return value of **PFMLIB_SUCCESS**
           indicates success, otherwise the value is an error code.
    


## ERRORS



           **PFMLIB_ERR_NOTSUPP**
                  No PMU was activated.
    


* * *
# gnutls_session_ticket_key_generate

## NAME



           gnutls_session_ticket_key_generate - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_session_ticket_key_generate(gnutls_datum_t ***_key_**);**
    


## ARGUMENTS



           gnutls_datum_t * key
                       is a pointer to a **gnutls_datum_t** which will contain a
                       newly created key.
    


## DESCRIPTION



           Generate a random key to encrypt security parameters within
           SessionTicket.
    


## RETURNS



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


## SINCE



           2.10.0
    


* * *
# probe::vm.kmalloc_node

## NAME



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


## SYNOPSIS



           vm.kmalloc_node
    


## VALUES



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


* * *
# mlx4dv_set_context_attr

## NAME



           mlx4dv_set_context_attr - Set context attributes
    


## SYNOPSIS



                  #include <infiniband/mlx4dv.h>
    
                  int mlx4dv_set_context_attr(struct ibv_context *context,
                                              enum mlx4dv_set_ctx_attr_type attr_type,
                                              void *attr);
    


## DESCRIPTION



           mlx4dv_set_context_attr gives the ability to set vendor specific
           attributes on the RDMA context.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _attr_type_
                  The type of the provided attribute.
    
           _attr_   Pointer to the attribute to be set.  ## attr_type
    
                  enum mlx4dv_set_ctx_attr_type {
                      /* Attribute type uint8_t */
                      MLX4DV_SET_CTX_ATTR_LOG_WQS_RANGE_SZ    = 0,
                      MLX4DV_SET_CTX_ATTR_BUF_ALLOCATORS  = 1,
                  };
    
           _MLX4DV_SET_CTX_ATTR_LOG_WQS_RANGE_SZ_
                  Change the LOG WQs Range size for RSS
    
           _MLX4DV_SET_CTX_ATTR_BUF_ALLOCATORS_
                  Provide an external buffer allocator
    
                  struct mlx4dv_ctx_allocators {
                      void *(*alloc)(size_t size, void *priv_data);
                      void (*free)(void *ptr, void *priv_data);
                      void *data;
                  };
    
           _alloc_  Function used for buffer allocation instead of libmlx4
                  internal method
    
           _free_   Function used to free buffers allocated by alloc function
    
           _data_   Metadata that can be used by alloc and free functions
    


## RETURN VALUE



           Returns 0 on success, or the value of errno on failure (which
           indicates the failure reason).
    
           #AUTHOR
    
           Majd Dibbiny ⟨majd@mellanox.com⟩
    


* * *
# gnutls_x509_crt_get_inhibit_anypolicy

## NAME



           gnutls_x509_crt_get_inhibit_anypolicy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_inhibit_anypolicy(gnutls_x509_crt_t** _cert_**,**
           **unsigned int ***_skipcerts_**, unsigned int ***_critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           unsigned int * skipcerts
                       will hold the number of certificates after which
                       anypolicy is no longer acceptable.
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    


## DESCRIPTION



           This function will return certificate's value of the SkipCerts,
           i.e., the Inhibit anyPolicy X.509 extension (2.5.29.54).
    
           The returned value is the number of additional certificates that
           may appear in the path before the anyPolicy is no longer
           acceptable.
    


## RETURNS



           zero on success, or a negative error code in case of parsing
           error.  If the certificate does not contain the Inhibit anyPolicy
           extension **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.6.0
    


* * *
# erf

## NAME



           erf, erff, erfl - error function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions return the error function of _x_ , defined as
    
               erf(x) = 2/sqrt(pi) * integral from 0 to x of exp(-t*t) dt
    


## RETURN VALUE



           On success, these functions return the value of the error function
           of _x_ , a value in the range [-1, 1].
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 (-0), +0 (-0) is returned.
    
           If _x_ is positive infinity (negative infinity), +1 (-1) is
           returned.
    
           If _x_ is subnormal, a range error occurs, and the return value is
           2*x/sqrt(pi).
    


## ERRORS



           See math_error(7) for information on how to determine whether an
           error has occurred when calling these functions.
    
           The following errors can occur:
    
           Range error: result underflow (_x_ is subnormal)
                  An underflow floating-point exception (**FE_UNDERFLOW**) is
                  raised.
    
           These functions do not set _errno_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# probe::nfs.proc.commit_setup

## NAME



           probe::nfs.proc.commit_setup - NFS client setting up a commit RPC
           task
    


## SYNOPSIS



           nfs.proc.commit_setup
    


## VALUES



           _server_ip_
               IP address of server
    
           _size_
               bytes in this commit
    
           _offset_
               the file offset
    
           _count_
               bytes in this commit
    
           _bitmask1_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _prot_
               transfer protocol
    
           _version_
               NFS version
    
           _bitmask0_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    


## DESCRIPTION



           The commit_setup function is used to setup a commit RPC task. Is
           is not doing the actual commit operation. It does not exist in
           NFSv2.
    


* * *
# gnutls_x509_crl_dist_points_get

## NAME



           gnutls_x509_crl_dist_points_get - API function
    


## SYNOPSIS



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


## ARGUMENTS



           gnutls_x509_crl_dist_points_t cdp
                       The CRL distribution points
    
           unsigned int seq
                       specifies the sequence number of the distribution
                       point (0 for the first one, 1 for the second etc.)
    
           unsigned int * type
                       The name type of the corresponding name
                       (gnutls_x509_subject_alt_name_t)
    
           gnutls_datum_t * san
                       The distribution point names (to be treated as
                       constant)
    
           unsigned int * reasons
                       Revocation reasons. An ORed sequence of flags from
                       **gnutls_x509_crl_reason_flags_t**.
    


## DESCRIPTION



           This function retrieves the individual CRL distribution points
           (2.5.29.31), contained in provided type.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the index is out of
           bounds, otherwise a negative error value.
    


* * *
# gnutls_x509_trust_list_verify_crt

## NAME



           gnutls_x509_trust_list_verify_crt - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_verify_crt(gnutls_x509_trust_list_t**
           _list_**, gnutls_x509_crt_t ***_cert_list_**, unsigned int** _cert_list_size_**,**
           **unsigned int** _flags_**, unsigned int ***_voutput_**,**
           **gnutls_verify_output_function** _func_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           gnutls_x509_crt_t * cert_list
                       is the certificate list to be verified
    
           unsigned int cert_list_size
                       is the certificate list size
    
           unsigned int flags
                       Flags that may be used to change the verification
                       algorithm. Use OR of the
                       gnutls_certificate_verify_flags enumerations.
    
           unsigned int * voutput
                       will hold the certificate verification output.
    
           gnutls_verify_output_function func
                       If non-null will be called on each chain element
                       verification with the output.
    


## DESCRIPTION



           This function will try to verify the given certificate and return
           its status. The  _voutput_ parameter will hold an OR'ed sequence of
           **gnutls_certificate_status_t** flags.
    
           The details of the verification are the same as in
           **gnutls_x509_trust_list_verify_crt2()**.
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# io_uring_prep_send_set_addr

## NAME



           io_uring_prep_send_set_addr - set address details for send
           requests
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_send_set_addr(struct io_uring_sqe ***_sqe_**,**
                                            **const struct sockaddr ***_dest_addr_**,**
                                            **__u16** _addr_len_**);**
    


## DESCRIPTION



           The io_uring_prep_send_set_addr(3) function sets a socket
           destination address specified by _dest_addr_ and its length using
           _addr_len_ parameters. It can be used once _sqe_ is prepared using any
           of the send(2) io_uring helpers. See man pages of
           io_uring_prep_send(3) or io_uring_prep_send_zc(3).
    


## RETURN VALUE



           None
    


* * *
# gnutls_x509_crt_get_issuer

## NAME



           gnutls_x509_crt_get_issuer - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_issuer(gnutls_x509_crt_t** _cert_**,**
           **gnutls_x509_dn_t ***_dn_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_x509_dn_t * dn
                       output variable with pointer to uint8_t DN
    


## DESCRIPTION



           Return the Certificate's Issuer DN as a **gnutls_x509_dn_t** data
           type, that can be decoded using **gnutls_x509_dn_get_rdn_ava()**.
    
           Note that  _dn_ should be treated as constant. Because it points
           into the  _cert_ object, you should not use  _dn_ after  _cert_ is
           deallocated.
    


## RETURNS



           Returns 0 on success, or an error code.
    


* * *
# pmasameindom

## NAME



           **pmaSameInDom** - check if two observations of an instance domain are
           the same`
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/libpcp.h>**
           **#include <pcp/archive.h>**
    
           **int pmaSameInDom(__pmLogInDom ***_old_**, __pmLogInDom ***_new_**);**
    
           **cc ... -lpcp_archive -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 they may not work, or may
           provide different semantics at some point in the future.
    


## DESCRIPTION



           Checks two observations of the same instance domain are identical.
           The code assumes (a) _old_ ->_indom_ == _new_ ->_indom_ and (b) both the in‐
           stance domains are sorted in ascending internal instance identifi‐
           er sequence; see pmaSortInDom(3) to see how  to  make  the  second
           condition true.
    
           **pmaSameInDom** returns 1 if they are the same, returns 0 otherwise.
    
           The  instance  domains are considered different if any of the fol‐
           lowing hold:
    
           1.  _old_ ->_numinst_ != _new_ ->_numinst_
    
           2.  For some i, _old_ ->_instlist_[_i_] _!=_ new _- >_instlist _[_ i _]_
    
           3.  For some i, the strings pointed to by _old_ ->_namelist_[_i_] and
               _new_ ->_instlist_[_i_] are not identical
    
           For Version 3 archives with "delta indom" support, it is more
           likely that pmaDeltaInDom(3) is more useful than **pmaSameInDom** , as
           the former combines the check for two observations of an instance
           domain being the same with the optional creation of the "delta in‐
           dom" format if that is the most efficient encoding.
    


* * *
# probe::nfsd.proc.lookup

## NAME



           probe::nfsd.proc.lookup - NFS server opening or searching for a
           file for client
    


## SYNOPSIS



           nfsd.proc.lookup
    


## VALUES



           _version_
               nfs version
    
           _client_ip_
               the ip address of client
    
           _proto_
               transfer protocol
    
           _filelen_
               the length of file name
    
           _uid_
               requester's user id
    
           _filename_
               file name
    
           _gid_
               requester's group id
    
           _fh_
               file handle of parent dir (the first part is the length of the
               file handle)
    


* * *