tripathysagar/man_text huggingface dataset:
# pmdaopenlog

## NAME



           **pmdaOpenLog** - redirect stderr to a logfile
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **void pmdaOpenLog(pmdaInterface ***_dispatch_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           **pmdaOpenLog** redirects _stderr_ to the logfile specified in the _dis‐_
           _patch_ structure, set by the  previous  call  to  pmdaDaemon(3)  or
           pmdaGetOpt(3).   The  first  line  of the log file will detail the
           name of the calling process, the host the process is  running  on,
           and  the  current time.  In addition, the log is appended with the
           exit time of the process by a routine registered with atexit(3).
    


## CAVEAT



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


## PCP ENVIRONMENT



           Environment  variables with the prefix **PCP_** are used to parameter‐
           ize the file and directory names used by PCP.  On  each  installa‐
           tion,  the  file _/etc/pcp.conf_ contains the local values for these
           variables.  The **$PCP_CONF** variable may be used to specify  an  al‐
           ternative configuration file, as described in pcp.conf(5).  Values
           for  these  variables  may  be obtained programmatically using the
           pmGetConfig(3) function.
    


* * *
# timegm

## NAME



           timegm, timelocal - inverses of gmtime and localtime
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **[[deprecated]] time_t timelocal(struct tm ***_tm_**);**
           **time_t timegm(struct tm ***_tm_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **timelocal**(), **timegm**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE || _SVID_SOURCE
    


## DESCRIPTION



           The functions **timelocal**() and **timegm**() are the inverses of
           localtime(3) and gmtime(3).  Both functions take a broken-down
           time and convert it to calendar time (seconds since the Epoch,
           1970-01-01 00:00:00 +0000, UTC).  The difference between the two
           functions is that **timelocal**() takes the local timezone into
           account when doing the conversion, while **timegm**() takes the input
           value to be Coordinated Universal Time (UTC).
    


## RETURN VALUE



           On success, these functions return the calendar time (seconds
           since the Epoch), expressed as a value of type _time_t_.  On error,
           they return the value _(time_t) -1_ and set _errno_ to indicate the
           error.
    


## ERRORS



           **EOVERFLOW**
                  The result cannot be represented.
    


## ATTRIBUTES



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


## STANDARDS



           BSD.
    


* * *
# keyok

## NAME



           **keyok** - enable or disable a keycode
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int keyok(int** _keycode_**, bool** _enable_**);**
    


## DESCRIPTION



           This is an extension to the curses library.  It permits an
           application to disable specific keycodes, rather than use the
           **keypad** function to disable all keycodes.  Keys that have been
           disabled can be re-enabled.
    


## RETURN VALUE



           The keycode must be greater than zero, else **ERR** is returned.  If
           it does not correspond to a defined key, then **ERR** is returned.  If
           the _enable_ parameter is true, then the key must have been
           disabled, and vice versa.  Otherwise, the function returns **OK**.
    


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# gnutls_aead_cipher_encryptv2

## NAME



           gnutls_aead_cipher_encryptv2 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_aead_cipher_encryptv2(gnutls_aead_cipher_hd_t** _handle_**,**
           **const void ***_nonce_**, size_t** _nonce_len_**, const giovec_t ***_auth_iov_**,**
           **int** _auth_iovcnt_**, const giovec_t ***_iov_**, int** _iovcnt_**, void ***_tag_**,**
           **size_t ***_tag_size_**);**
    


## ARGUMENTS



           gnutls_aead_cipher_hd_t handle
                       is a **gnutls_aead_cipher_hd_t** type.
    
           const void * nonce
                       the nonce to set
    
           size_t nonce_len
                       The length of the nonce
    
           const giovec_t * auth_iov
                       additional data to be authenticated
    
           int auth_iovcnt
                       The number of buffers in  _auth_iov_
    
           const giovec_t * iov
                       the data to be encrypted
    
           int iovcnt  The number of buffers in  _iov_
    
           void * tag  The authentication tag
    
           size_t * tag_size
                       The size of the tag to use (use zero for the default)
    


## DESCRIPTION



           This is similar to **gnutls_aead_cipher_encrypt()** , but it performs
           in-place encryption on the provided data buffers.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.10
    


* * *
# ibv_import_dm

## NAME



           ibv_import_dm - import an DM from a given ibv_context
    
           ibv_unimport_dm - unimport an DM
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_dm *ibv_import_dm(struct ibv_context *context, uint32_t dm_handle);
                  void ibv_unimport_dm(struct ibv_dm *dm)
    


## DESCRIPTION



           **ibv_import_dm()** returns a Device memory (DM) that is associated
           with the given _dm_handle_ in the RDMA context.
    
           The input _dm_handle_ value must be a valid kernel handle for an DM
           object in the assosicated RDMA context.  It can be achieved from
           the original DM by getting its ibv_dm->handle member value.
    
           **ibv_unimport_dm()** un import the DM.  Once the DM usage has been
           ended ibv_free_dm() or ibv_unimport_dm() should be called.  The
           first one will go to the kernel to destroy the object once the
           second one way cleanup what ever is needed/opposite of the import
           without calling the kernel.
    
           This is the responsibility of the application to coordinate
           between all ibv_context(s) that use this DM.  Once destroy is done
           no other process can touch the object except for unimport.  All
           users of the context must collaborate to ensure this.
    


## RETURN VALUE



           **ibv_import_dm()** returns a pointer to the allocated DM, or NULL if
           the request fails and errno is set.
    


## NOTES



    


* * *
# function::sock_prot_num2str

## NAME



           function::sock_prot_num2str - Given a protocol number, return a
           string representation
    


## SYNOPSIS



               sock_prot_num2str:string(proto:long)
    


## ARGUMENTS



           _proto_
               The protocol number
    


* * *
# gnutls_x509_crt_import

## NAME



           gnutls_x509_crt_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_import(gnutls_x509_crt_t** _cert_**, const**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _format_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       The data to store the parsed certificate.
    
           const gnutls_datum_t * data
                       The DER or PEM encoded certificate.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM
    


## DESCRIPTION



           This function will convert the given DER or PEM encoded
           Certificate to the native gnutls_x509_crt_t format. The output
           will be stored in  _cert_ .
    
           If the Certificate is PEM encoded it should have a header of "X509
           CERTIFICATE", or "CERTIFICATE".
    


## RETURNS



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


* * *
# rdma_freeaddrinfo

## NAME



           RDMA_FREEADDRINFO - Frees the list of rdma_addrinfo structures
           returned by rdma_getaddrinfo
    


## SYNOPSIS



           #include <rdma/rdma_cma.h>
    
           void rdma_freeaddrinfo (struct rdma_addrinfo *res);
    


## ARGUMENTS



           res     List of rdma_addrinfo structures returned by
           rdma_getaddrinfo.
    


## DESCRIPTION



           Frees the list of rdma_addrinfo structures returned by
           rdma_getaddrinfo.
    


## RETURN VALUE



           None
    


* * *
# function::HZ

## NAME



           function::HZ - Kernel HZ
    


## SYNOPSIS



               HZ:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the value of the kernel HZ macro, which
           corresponds to the rate of increase of the jiffies value.
    


* * *
# _Generic

## NAME



           _Generic - type-generic selection
    


## SYNOPSIS



           **_Generic(**_expression_**, type1:**_e1_**,**... /* **, default:**_e_ */**);**
    


## DESCRIPTION



           **_Generic**() evaluates the path of code under the type selector that
           is compatible with the type of the controlling _expression_ , or
           **default:** if no type is compatible.
    
           _expression_ is not evaluated.
    
           This is especially useful for writing type-generic macros, that
           will behave differently depending on the type of the argument.
    


## STANDARDS



           C11.
    


## EXAMPLES



           The following program demonstrates how to write a replacement for
           the standard imaxabs(3) function, which being a function can't
           really provide what it promises: seamlessly upgrading to the
           widest available type.
    
                  #include <stdint.h>
                  #include <stdio.h>
                  #include <stdlib.h>
    
                  #define my_imaxabs  _Generic(INTMAX_C(0),  \
                      long:           labs,                  \
                      long long:      llabs                  \
                  /*  long long long: lllabs */              \
                  )
    
                  int
                  main(void)
                  {
                      off_t  a;
    
                      a = -42;
                      printf("imaxabs(%jd) == %jd\n", (intmax_t) a, my_imaxabs(a));
                      printf("&imaxabs == %p\n", &my_imaxabs);
                      printf("&labs    == %p\n", &labs);
                      printf("&llabs   == %p\n", &llabs);
    
                      exit(EXIT_SUCCESS);
                  }
    


* * *
# gnutls_pkcs11_obj_list_import_url3

## NAME



           gnutls_pkcs11_obj_list_import_url3 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_obj_list_import_url3(gnutls_pkcs11_obj_t ***
           _p_list_**, unsigned int ***_n_list_**, const char ***_url_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_obj_t * p_list
                       An uninitialized object list (may be **NULL**)
    
           unsigned int * n_list
                       Initially should hold the maximum size of the list.
                       Will contain the actual size.
    
           const char * url
                       A PKCS 11 url identifying a set of objects
    
           unsigned int flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will initialize and set values to an object list by
           using all objects identified by a PKCS 11 URL.
    
           This function will enumerate all the objects specified by the
           PKCS**11** URL provided. It expects an already allocated  _p_list_ which
           has * _n_list_ elements, and that value will be updated to the
           actual number of present objects. The
            _p_list_ objects will be initialized and set by this function.  To
           obtain a list of all available objects use a  _url_ of 'pkcs11:'.
    
           All returned objects must be deinitialized using
           **gnutls_pkcs11_obj_deinit()**.
    
           The supported in this function  _flags_ are
           **GNUTLS_PKCS11_OBJ_FLAG_LOGIN** , **GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO** ,
           **GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE** ,
           **GNUTLS_PKCS11_OBJ_FLAG_CRT** , **GNUTLS_PKCS11_OBJ_FLAG_PUBKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_CA** ,
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED** , and since 3.5.1 the
           **GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT**.
    
           On versions of GnuTLS prior to 3.4.0 the equivalent function was
           **gnutls_pkcs11_obj_list_import_url()**. That is also available on
           this version as a macro which maps to this function.
    


## RETURNS



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


## SINCE



           3.4.0
    


* * *
# fchmod

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



           fchmod — change mode of a file
    


## SYNOPSIS



           #include <sys/stat.h>
    
           int fchmod(int _fildes_ , mode_t _mode_);
    


## DESCRIPTION



           The _fchmod_() function shall be equivalent to _chmod_() except that
           the file whose permissions are changed is specified by the file
           descriptor _fildes_.
    
           If _fildes_ references a shared memory object, the _fchmod_() function
           need only affect the S_IRUSR, S_IWUSR, S_IRGRP, S_IWGRP, S_IROTH,
           and S_IWOTH file permission bits.
    
           If _fildes_ references a typed memory object, the behavior of
           _fchmod_() is unspecified.
    
           If _fildes_ refers to a socket, the behavior of _fchmod_() is
           unspecified.
    
           If _fildes_ refers to a STREAM (which is _fattach_()-ed into the file
           system name space) the call returns successfully, doing nothing.
    


## RETURN VALUE



           Upon successful completion, _fchmod_() shall return 0. Otherwise, it
           shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _fchmod_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not an open file descriptor.
    
           **EPERM** The effective user ID does not match the owner of the file
                  and the process does not have appropriate privileges.
    
           **EROFS** The file referred to by _fildes_ resides on a read-only file
                  system.
    
           The _fchmod_() function may fail if:
    
           **EINTR** The _fchmod_() function was interrupted by a signal.
    
           **EINVAL** The value of the _mode_ argument is invalid.
    
           **EINVAL** The _fildes_ argument refers to a pipe and the implementation
                  disallows execution of _fchmod_() on a pipe.
    
           _The following sections are informative._
    


## EXAMPLES



       **Changing the Current Permissions for a File**
           The following example shows how to change the permissions for a
           file named **/home/cnd/mod1** so that the owner and group have
           read/write/execute permissions, but the world only has read/write
           permissions.
    
               #include <sys/stat.h>
               #include <fcntl.h>
    
               mode_t mode;
               int    fildes;
               ...
               fildes = open("/home/cnd/mod1", O_RDWR);
               fchmod(fildes, S_IRWXU | S_IRWXG | S_IROTH | S_IWOTH);
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmatomstr

## NAME



           **pmAtomStr** , **pmAtomStr_r** - convert a performance metric value into a
           string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **const char *pmAtomStr(const pmAtomValue ***_avp_**, int** _type_**);**
           **char *pmAtomStr_r(const pmAtomValue ***_avp_**, int** _type_**, char ***_buf_**,**
                             **int** _buflen_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           All  performance  metric  values  may  be encoded in a _pmAtomValue_
           union, defined as follows;
    
                typedef union {
                    __int32_t    l;     /* 32-bit signed */
                    __uint32_t   ul;    /* 32-bit unsigned */
                    __int64_t    ll;    /* 64-bit signed */
                    __uint64_t   ull;   /* 64-bit unsigned */
                    float        f;     /* 32-bit floating point */
                    double       d;     /* 64-bit floating point */
                    char         *cp;   /* char ptr */
                    pmValueBlock *vbp;  /* pmValueBlock ptr */
                } pmAtomValue;
    
           Given the performance metric value pointed to by _avp_ , and  a  per‐
           formance  metric type defined by _type_ , **pmAtomStr** will generate the
           corresponding metric value as a string, suitable for diagnostic or
           report output.  The **pmAtomStr_r** function does the same, but stores
           the result in a user-supplied buffer _buf_ of length  _buflen_ ,  which
           should have room for at least 80 bytes.
    
           The value for _type_ is typically extracted from a _pmDesc_ structure,
           following  a  call to pmLookupDesc(3) for a particular performance
           metric.
    
           If the _type_ is **PM_TYPE_STRING** values  longer  than  38  characters
           will  be  truncated after 34 characters, and truncation shown with
           ellipsis ``...'' at the end of the value.
    
           If the _type_ is **PM_TYPE_AGGREGATE** then up to the first three 32-bit
           words are displayed as hexadecimal values.
    
           If the _type_ is **PM_TYPE_EVENT** then a summary of the number of event
           records found in the value is generated.
    
           The return value from **pmAtomStr** is held in a single static buffer,
           so the returned value is only valid until the next call to **pmAtom‐**
           **Str**.
    


## NOTES



           **pmAtomStr** returns a pointer to a static buffer and  hence  is  not
           thread-safe.   Multi-threaded  applications should use **pmAtomStr_r**
           instead.
    


* * *
# umad_size

## NAME



           umad_size - get the size of umad buffer
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **size_t umad_size(void);**
    


## DESCRIPTION



           **umad_size()** returns the size of umad buffer (in bytes).
    


## RETURN VALUE



           **umad_size()** returns the size of umad buffer (in bytes).
    


* * *
# pthread_mutexattr_setpshared

## PROLOG



           This manual page is part of the POSIX Programmer's Manual.  The
           Linux implementation of this interface may differ (consult the
           corresponding Linux manual page for details of Linux behavior), or
           the interface may not be implemented on Linux.
    


## NAME



           pthread_mutexattr_setpshared — set the process-shared attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutexattr_setpshared(pthread_mutexattr_t *_attr_ ,
               int _pshared_);
    


## DESCRIPTION



           Refer to pthread_mutexattr_getpshared(3p).
    


* * *
# function::probefunc

## NAME



           function::probefunc - Return the probe point's function name, if
           known
    


## SYNOPSIS



               probefunc:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the name of the function being probed based
           on the current address, as computed by symname(**addr**) or
           usymname(**uaddr**) depending on probe context (whether the probe is a
           user probe or a kernel probe).
    


## PLEASE NOTE



           this function's behaviour differs between SystemTap 2.0 and
           earlier versions. Prior to 2.0, **probefunc** obtained the function
           name from the probe point string as returned by **pp** , and used the
           current address as a fallback.
    
           Consider using **ppfunc** instead.
    


* * *
# wmemmove

## NAME



           wmemmove - copy an array of wide-characters
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



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


## DESCRIPTION



           The **wmemmove**() function is the wide-character equivalent of the
           memmove(3) function.  It copies _n_ wide characters from the array
           starting at _src_ to the array starting at _dest_.  The arrays may
           overlap.
    
           The programmer must ensure that there is room for at least _n_ wide
           characters at _dest_.
    


## RETURN VALUE



           **wmemmove**() returns _dest_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::qsq_print

## NAME



           function::qsq_print - Prints a line of statistics for the given
           queue
    


## SYNOPSIS



               qsq_print(qname:string)
    


## ARGUMENTS



           _qname_
               queue name
    


## DESCRIPTION



           This function prints a line containing the following
    


## STATISTICS FOR THE GIVEN QUEUE



           the queue name, the average rate of requests per second, the
           average wait queue length, the average time on the wait queue, the
           average time to service a request, the percentage of time the wait
           queue was used, and the percentage of time request was being
           serviced.
    


* * *
# getseuserbyname

## NAME



           getseuserbyname - get SELinux username and level for a given Linux
           username
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
    
           **int getseuserbyname(const char ***_linuxuser_**, char ****_selinuxuser_**,**
           **char ****_level_**);**
    


## DESCRIPTION



           **getseuserbyname**() retrieves the SELinux username and security
           level associated with a given Linux username.  The SELinux
           username and security level can then be passed to other libselinux
           functions such as get_ordered_context_list_with_level(3) and
           get_default_context_with_level(3).
    
           The returned SELinux username and level should be freed by the
           caller using free.
    


## RETURN VALUE



           On success, 0 is returned.  On failure, -1 is returned and _errno_
           is set appropriately.
    
           The errors documented for the stat(2) system call are also
           applicable here.
    


* * *
# syslog

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



           syslog — log a message
    


## SYNOPSIS



           #include <syslog.h>
    
           void syslog(int _priority_ , const char *_message_ , ... /* _argument_ */);
    


## DESCRIPTION



           Refer to closelog(3p).
    


* * *
# pcap_offline_filter

## NAME



           pcap_offline_filter - check whether a filter matches a packet
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_offline_filter(const struct bpf_program *fp,**
               **const struct pcap_pkthdr *h, const u_char *pkt);**
    


## DESCRIPTION



           **pcap_offline_filter**() checks whether a filter matches a packet.
           _fp_ is a pointer to a _bpf_program_ struct, usually the result of a
           call to **pcap_compile**(3PCAP).  _h_ points to the _pcap_pkthdr_
           structure for the packet, and _pkt_ points to the data in the
           packet.
    
           The filter program must have been compiled for a link-layer header
           type that matches the packet data; also on Linux the filter must
           not use BPF extensions, see **pcap_compile**() for more information.
    


## RETURN VALUE



           **pcap_offline_filter**() returns the return value of the filter
           program.  This will be zero if the packet doesn't match the filter
           and non-zero if the packet matches the filter.
    


* * *
# umad_open_smi_port

## NAME



           umad_open_smi_port - open InfiniBand device SMI port for umad
           access
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_open_smi_port(char** _*ca_name_**, int** _portnum_**);**
    


## DESCRIPTION



           **umad_open_smi_port()** opens the SMI port _portnum_ of the IB device
           _ca_name_ for umad access. The port is selected by the library if
           not all parameters are provided (see **umad_get_port()** for details).
           Only SMI ports will be selected.
    


## RETURN VALUE



           **umad_open_smi_port()** returns 0 or an unique positive value of umad
           device descriptor on success, and a negative value on error as
           follows:
            -EOPNOTSUPP ABI version doesn't match
            -ENODEV     IB device with SMI port can't be resolved
            -EINVAL     port is not valid (bad _portnum_ or no umad device)
            -EIO        umad device for this port can't be opened
    


* * *
# logf

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



           logf, logl — natural logarithm function
    


## SYNOPSIS



           #include <math.h>
    
           float logf(float _x_);
           long double logl(long double _x_);
    


## DESCRIPTION



           Refer to log(3p).
    


* * *
# gnu_get_libc_version

## NAME



           gnu_get_libc_version, gnu_get_libc_release - get glibc version and
           release
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <gnu/libc-version.h>**
    
           **const char *gnu_get_libc_version(void);**
           **const char *gnu_get_libc_release(void);**
    


## DESCRIPTION



           The function **gnu_get_libc_version**() returns a string that
           identifies the glibc version available on the system.
    
           The function **gnu_get_libc_release**() returns a string indicates the
           release status of the glibc version available on the system.  This
           will be a string such as _stable_.
    


## ATTRIBUTES



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


## STANDARDS



           GNU.
    


## EXAMPLES



           When run, the program below will produce output such as the
           following:
    
               $ **./a.out**
               GNU libc version: 2.8
               GNU libc release: stable
    
       **Program source**
    
           #include <stdio.h>
           #include <stdlib.h>
    
           #include <gnu/libc-version.h>
    
           int
           main(void)
           {
               printf("GNU libc version: %s\n", gnu_get_libc_version());
               printf("GNU libc release: %s\n", gnu_get_libc_release());
               exit(EXIT_SUCCESS);
           }
    


* * *
# wmemcpy

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



           wmemcpy — copy wide characters in memory
    


## SYNOPSIS



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


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _wmemcpy_() function shall copy _n_ wide characters from the
           object pointed to by _ws2_ to the object pointed to by _ws1_.  This
           function shall not be affected by locale and all **wchar_t** values
           shall be treated identically. The null wide character and **wchar_t**
           values not corresponding to valid characters shall not be treated
           specially.
    
           If _n_ is zero, the application shall ensure that _ws1_ and _ws2_ are
           valid pointers, and the function shall copy zero wide characters.
    


## RETURN VALUE



           The _wmemcpy_() function shall return the value of _ws1_.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# killpg

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



           killpg — send a signal to a process group
    


## SYNOPSIS



           #include <signal.h>
    
           int killpg(pid_t _pgrp_ , int _sig_);
    


## DESCRIPTION



           The _killpg_() function shall send the signal specified by _sig_ to
           the process group specified by _pgrp_.
    
           If _pgrp_ is greater than 1, _killpg_(_pgrp_ , _sig_) shall be equivalent
           to _kill_(-_pgrp_ , _sig_). If _pgrp_ is less than or equal to 1, the
           behavior of _killpg_() is undefined.
    


## RETURN VALUE



           Refer to kill(3p).
    


## ERRORS



           Refer to kill(3p).
    
           _The following sections are informative._
    


## EXAMPLES



       **Sending a Signal to All Other Members of a Process Group**
           The following example shows how the calling process could send a
           signal to all other members of its process group. To prevent
           itself from receiving the signal it first makes itself immune to
           the signal by ignoring it.
    
               #include <signal.h>
               #include <unistd.h>
               ...
                   if (signal(SIGUSR1, SIG_IGN) == SIG_ERR)
                       /* Handle error */;
    
                   if (killpg(getpgrp(), SIGUSR1) == -1)
                       /* Handle error */;"
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_anti_replay_set_add_function

## NAME



           gnutls_anti_replay_set_add_function - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_anti_replay_set_add_function(gnutls_anti_replay_t**
           _anti_replay_**, gnutls_db_add_func** _add_func_**);**
    


## ARGUMENTS



           gnutls_anti_replay_t anti_replay
                       is a **gnutls_anti_replay_t** type.
    
           gnutls_db_add_func add_func
                       is the function.
    


## DESCRIPTION



           Sets the function that will be used to store an entry if it is not
           already present in the resumed sessions database.  This function
           returns 0 if the entry is successfully stored, and a negative
           error code otherwise.  In particular, if the entry is found in the
           database, it returns **GNUTLS_E_DB_ENTRY_EXISTS**.
    
           The arguments to the  _add_func_ are: - **ptr** : the pointer set with
           **gnutls_anti_replay_set_ptr()** - **exp_time** : the expiration time of
           the entry - **key** : a pointer to the key - **data** : a pointer to data to
           store
    
           The data set by this function can be examined using
           **gnutls_db_check_entry_expire_time()** and
           **gnutls_db_check_entry_time()**.
    


## SINCE



           3.6.5
    


* * *
# gnutls_mac_list

## NAME



           gnutls_mac_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const gnutls_mac_algorithm_t * gnutls_mac_list(**_void_**);**
    


## ARGUMENTS



            void
    


## DESCRIPTION



           Get a list of hash algorithms for use as MACs.  Note that not
           necessarily all MACs are supported in TLS cipher suites.  This
           function is not thread safe.
    


## RETURNS



           Return a (0)-terminated list of **gnutls_mac_algorithm_t** integers
           indicating the available MACs.
    


* * *
# fmin

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



           fmin, fminf, fminl — determine minimum numeric value of two
           floating-point numbers
    


## SYNOPSIS



           #include <math.h>
    
           double fmin(double _x_ , double _y_);
           float fminf(float _x_ , float _y_);
           long double fminl(long double _x_ , long double _y_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall determine the minimum numeric value of their
           arguments.  NaN arguments shall be treated as missing data: if one
           argument is a NaN and the other numeric, then these functions
           shall choose the numeric value.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           minimum numeric value of their arguments.
    
           If just one argument is a NaN, the other argument shall be
           returned.
    
           If _x_ and _y_ are NaN, a NaN shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::sprint_syms

## NAME



           function::sprint_syms - Return stack for kernel addresses from
           string
    


## SYNOPSIS



               sprint_syms(callers:string)
    


## ARGUMENTS



           _callers_
               String with list of hexadecimal (kernel) addresses
    


## DESCRIPTION



           Perform a symbolic lookup of the addresses in the given string,
           which are assumed to be the result of a prior calls to **stack** ,
           **callers** , and similar functions.
    
           Returns a simple backtrace from the given hex string. One line per
           address. Includes the symbol name (or hex address if symbol
           couldn't be resolved) and module name (if found), as obtained from
           **symdata**. Includes the offset from the start of the function if
           found, otherwise the offset will be added to the module (if found,
           between brackets). Returns the backtrace as string (each line
           terminated by a newline character). Note that the returned stack
           will be truncated to MAXSTRINGLEN, to print fuller and richer
           stacks use **print_syms**.
    


* * *
# function::qsq_blocked

## NAME



           function::qsq_blocked - Returns the time reqest was on the wait
           queue
    


## SYNOPSIS



               qsq_blocked:long(qname:string,scale:long)
    


## ARGUMENTS



           _qname_
               queue name
    
           _scale_
               scale variable to take account for interval fraction
    


## DESCRIPTION



           This function returns the fraction of elapsed time during which
           one or more requests were on the wait queue.
    


* * *
# gnutls_x509_dn_get_str2

## NAME



           gnutls_x509_dn_get_str2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_get_str2(gnutls_x509_dn_t** _dn_**, gnutls_datum_t ***
           _str_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       a pointer to DN
    
           gnutls_datum_t * str
                       a datum that will hold the name
    
           unsigned flags
                       zero or **GNUTLS_X509_DN_FLAG_COMPAT**
    


## DESCRIPTION



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


## RETURNS



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


## SINCE



           3.5.7
    


* * *
# function::qs_done

## NAME



           function::qs_done - Function to record finishing request
    


## SYNOPSIS



               qs_done(qname:string)
    


## ARGUMENTS



           _qname_
               the name of the service that finished
    


## DESCRIPTION



           This function records that a request originally from the given
           queue has completed being serviced.
    


* * *
# gnutls_x509_crt_check_key_purpose

## NAME



           gnutls_x509_crt_check_key_purpose - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crt_check_key_purpose(gnutls_x509_crt_t** _cert_**,**
           **const char ***_purpose_**, unsigned** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain a **gnutls_x509_crt_t** type
    
           const char * purpose
                       a key purpose OID (e.g., **GNUTLS_KP_CODE_SIGNING**)
    
           unsigned flags
                       zero or **GNUTLS_KP_FLAG_DISALLOW_ANY**
    


## DESCRIPTION



           This function will check whether the given certificate matches the
           provided key purpose. If  _flags_ contains **GNUTLS_KP_FLAG_ALLOW_ANY**
           then it a certificate marked for any purpose will not match.
    


## RETURNS



           zero if the key purpose doesn't match, and non-zero otherwise.
    


## SINCE



           3.5.6
    


* * *
# gnutls_privkey_import_ext2

## NAME



           gnutls_privkey_import_ext2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_ext2(gnutls_privkey_t** _pkey_**,**
           **gnutls_pk_algorithm_t** _pk_**, void ***_userdata_**,**
           **gnutls_privkey_sign_func** _sign_fn_**, gnutls_privkey_decrypt_func**
           _decrypt_fn_**, gnutls_privkey_deinit_func** _deinit_fn_**, unsigned int**
           _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           gnutls_pk_algorithm_t pk
                       The public key algorithm
    
           void * userdata
                       private data to be provided to the callbacks
    
           gnutls_privkey_sign_func sign_fn
                       callback for signature operations
    
           gnutls_privkey_decrypt_func decrypt_fn
                       callback for decryption operations
    
           gnutls_privkey_deinit_func deinit_fn
                       a deinitialization function
    
           unsigned int flags
                       Flags for the import
    


## DESCRIPTION



           This function will associate the given callbacks with the
           **gnutls_privkey_t** type. At least one of the two callbacks must be
           non-null. If a deinitialization function is provided then flags is
           assumed to contain **GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE**.
    
           Note that the signing function is supposed to "raw" sign data,
           i.e., without any hashing or preprocessing. In case of RSA the
           DigestInfo will be provided, and the signing function is expected
           to do the PKCS **1** 1.5 padding and the exponentiation.
    
           See also **gnutls_privkey_import_ext3()**.
    


## RETURNS



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


## SINCE



           3.1
    


* * *
# clock_settime

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



           clock_settime — clock and timer functions
    


## SYNOPSIS



           #include <time.h>
    
           int clock_settime(clockid_t _clock_id_ , const struct timespec *_tp_);
    


## DESCRIPTION



           Refer to clock_getres(3p).
    


* * *
# pam_get_user

## NAME



           pam_get_user - get user name
    


## SYNOPSIS



           **#include <security/pam_modules.h>**
    
           **int pam_get_user(const pam_handle_t ***_pamh_**, const char ****_user_**,**
                            **const char ***_prompt_**);**
    


## DESCRIPTION



           The **pam_get_user** function returns the name of the user specified
           by pam_start(3). If no user was specified it returns what
           **pam_get_item (pamh, PAM_USER, ... );** would have returned. If this
           is NULL it obtains the username via the pam_conv(3) mechanism, it
           prompts the user with the first non-NULL string in the following
           list:
    
           •   The _prompt_ argument passed to the function.
    
           •   What is returned by pam_get_item (pamh, PAM_USER_PROMPT, ...
               );
    
           •   The default prompt: "login: "
    
           By whatever means the username is obtained, a pointer to it is
           returned as the contents of _*user_. Note, this memory should **not** be
           _free()_ 'd or _modified_ by the module.
    
           This function sets the _PAM_USER_ item associated with the
           pam_set_item(3) and pam_get_item(3) functions.
    


## RETURN VALUES



           PAM_SUCCESS
               User name was successful retrieved.
    
           PAM_SYSTEM_ERR
               A NULL pointer was submitted.
    
           PAM_CONV_ERR
               The conversation method supplied by the application failed to
               obtain the username.
    
           PAM_BUF_ERR
               Memory buffer error.
    
           PAM_ABORT
               Error resuming an old conversation.
    
           PAM_CONV_AGAIN
               The conversation method supplied by the application is waiting
               for an event.
    


* * *
# gnutls_privkey_verify_params

## NAME



           gnutls_privkey_verify_params - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_verify_params(gnutls_privkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       should contain a **gnutls_privkey_t** type
    


## DESCRIPTION



           This function will verify the private key parameters.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# probe::signal.send_sig_queue.return

## NAME



           probe::signal.send_sig_queue.return - Queuing a signal to a
           process completed
    


## SYNOPSIS



           signal.send_sig_queue.return
    


## VALUES



           _name_
               Name of the probe point
    
           _retstr_
               Return value as a string
    


* * *
# rdma_get_peer_addr

## NAME



           rdma_get_peer_addr - Returns the remote IP address of a bound
           rdma_cm_id.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **struct sockaddr * rdma_get_peer_addr (struct rdma_cm_id ***_id_**);**
    


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Returns the remote IP address associated with an rdma_cm_id.
    


## RETURN VALUE



           Returns a pointer to the sockaddr address of the connected peer.
           If the rdma_cm_id is not connected, the contents of the sockaddr
           structure will be set to all zeroes.
    


* * *