tripathysagar/man_text huggingface dataset:
# gnutls_x509_ct_sct_get_version

## NAME



           gnutls_x509_ct_sct_get_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ct_sct_get_version(gnutls_x509_ct_scts_t** _scts_**,**
           **unsigned** _idx_**, unsigned int ***_version_out_**);**
    


## ARGUMENTS



           gnutls_x509_ct_scts_t scts
                       A list of SCTs
    
           unsigned idx
                       The index of the target SCT in the list
    
           unsigned int * version_out
                       The version of the target SCT.
    


## DESCRIPTION



           This function obtains the version of the SCT at the given position
           in the SCT list.
    
           The version of that SCT will be placed on  _version_out_ .
    
           Return : **GNUTLS_E_SUCCESS**(0) is returned on success,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if  _idx_ exceeds the number
           of SCTs in the list and **GNUTLS_E_INVALID_REQUEST** if the SCT's
           version is different than 1, as that's currently the only defined
           version.
    


* * *
# pmgetchildren

## NAME



           **pmGetChildren** - return the descendent nodes of a PMNS node
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetChildren(const char ***_name_**, char *****_offspring_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Given  a fully qualified pathname to a node in the current Perfor‐
           mance Metrics Name Space (PMNS), as identified by _name_ , **pmGetChil‐**
           **dren** returns via _offspring_ a list of the relative names of all  of
           the immediate descendent nodes of _name_ in the current PMNS.
    
           As  a special case, if _name_ is an empty string (i.e.**""**), the imme‐
           diate descendants of the root node in the PMNS will be returned.
    
           Normally, **pmGetChildren** will return the number of descendent names
           discovered, else a value less than zero for an error.   The  value
           zero indicates that _name_ is a valid metric name, i.e. is associat‐
           ed with a leaf node in the PMNS.
    
           The resulting list of pointers _offspring_ **and** the values (the rela‐
           tive  names)  that the pointers reference will have been allocated
           by **pmGetChildren** with a single call to malloc(3), and  it  is  the
           responsibility  of  the **pmGetChildren** caller to **free**(_offspring_) to
           release the space when it is no longer required.
    
           When an error occurs, or _name_ is a leaf node (i.e. the  result  of
           **pmGetChildren** is less than one), _offspring_ is undefined (no space
           will have been allocated, and so calling free(3) is  a  singularly
           bad idea).
    


## DIAGNOSTICS



           **PM_ERR_NOPMNS**
                  Failed to access a PMNS for operation.  Note that if the
                  application hasn't a priori called pmLoadNameSpace(3) and
                  wants to use the distributed PMNS, then a call to
                  **pmGetChildren** must be made inside a current context.
    
           **PM_ERR_NAME**
                  The pathname _name_ is not valid in the current PMNS
    
           **PM_ERR_***
                  Other diagnostics are for protocol failures when accessing
                  the distributed PMNS.
    


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


* * *
# probe::sunrpc.svc.register

## NAME



           probe::sunrpc.svc.register - Register an RPC service with the
           local portmapper
    


## SYNOPSIS



           sunrpc.svc.register
    


## VALUES



           _progname_
               the name of the program
    
           _sv_name_
               the service name
    
           _prog_
               the number of the program
    
           _prot_
               the IP protocol number
    
           _port_
               the port number
    


## DESCRIPTION



           If _proto_ and _port_ are both 0, then unregister a service.
    


* * *
# gnutls_privkey_decrypt_data

## NAME



           gnutls_privkey_decrypt_data - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_decrypt_data(gnutls_privkey_t** _key_**, unsigned int**
           _flags_**, const gnutls_datum_t ***_ciphertext_**, gnutls_datum_t ***
           _plaintext_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the key
    
           unsigned int flags
                       zero for now
    
           const gnutls_datum_t * ciphertext
                       holds the data to be decrypted
    
           gnutls_datum_t * plaintext
                       will contain the decrypted data, allocated with
                       **gnutls_malloc()**
    


## DESCRIPTION



           This function will decrypt the given data using the algorithm
           supported by the private key.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# pthread_sigqueue

## NAME



           pthread_sigqueue - queue a signal and data to a thread
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <signal.h>**
           **#include <pthread.h>**
    
           **int pthread_sigqueue(pthread_t** _thread_**, int** _sig_**,**
                                **const union sigval** _value_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **pthread_sigqueue**():
               _GNU_SOURCE
    


## DESCRIPTION



           The **pthread_sigqueue**() function performs a similar task to
           sigqueue(3), but, rather than sending a signal to a process, it
           sends a signal to a thread in the same process as the calling
           thread.
    
           The _thread_ argument is the ID of a thread in the same process as
           the caller.  The _sig_ argument specifies the signal to be sent.
           The _value_ argument specifies data to accompany the signal; see
           sigqueue(3) for details.
    


## RETURN VALUE



           On success, **pthread_sigqueue**() returns 0; on error, it returns an
           error number.
    


## ERRORS



           **EAGAIN** The limit of signals which may be queued has been reached.
                  (See signal(7) for further information.)
    
           **EINVAL** _sig_ was invalid.
    
           **ENOSYS pthread_sigqueue**() is not supported on this system.
    
           **ESRCH** _thread_ is not valid.
    


## ATTRIBUTES



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


## VERSIONS



           The glibc implementation of **pthread_sigqueue**() gives an error
           (**EINVAL**) on attempts to send either of the real-time signals used
           internally by the NPTL threading implementation.  See nptl(7) for
           details.
    


## STANDARDS



           GNU.
    


* * *
# gnutls_x509_crt_check_hostname

## NAME



           gnutls_x509_crt_check_hostname - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **unsigned gnutls_x509_crt_check_hostname(gnutls_x509_crt_t** _cert_**,**
           **const char ***_hostname_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       should contain an gnutls_x509_crt_t type
    
           const char * hostname
                       A null terminated string that contains a DNS name
    


## DESCRIPTION



           This function will check if the given certificate's subject
           matches the given hostname.  This is a basic implementation of the
           matching described in RFC6125, and takes into account wildcards,
           and the DNSName/IPAddress subject alternative name PKIX extension.
    
           For details see also **gnutls_x509_crt_check_hostname2()**.
    


## RETURNS



           non-zero for a successful match, and zero on failure.
    


* * *
# bcmp

## NAME



           bcmp - compare byte sequences
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <strings.h>**
    
           **[[deprecated]] int bcmp(** size_t n;
                                   **const void** _s1_**[**_n_**], const void** _s2_**[**_n_**], size_t** _n_**);**
    


## DESCRIPTION



           **bcmp**() is identical to memcmp(3); use the latter instead.
    


## STANDARDS



           None.
    


* * *
# function::symfileline

## NAME



           function::symfileline - Return the file name and line number of an
           address.
    


## SYNOPSIS



               symfileline:string(addr:long)
    


## ARGUMENTS



           _addr_
               The address to translate.
    


## DESCRIPTION



           Returns the file name and the (approximate) line number of the
           given address, if known. If the file name or the line number
           cannot be found, the hex string representation of the address will
           be returned.
    


* * *
# setrlimit

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



           setrlimit — control maximum resource consumption
    


## SYNOPSIS



           #include <sys/resource.h>
    
           int setrlimit(int _resource_ , const struct rlimit *_rlp_);
    


## DESCRIPTION



           Refer to getrlimit(3p).
    


* * *
# pcre2_substring_copy_bynumber

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_substring_copy_bynumber(pcre2_match_data ***_match_data_**,**
             **uint32_t** _number_**, PCRE2_UCHAR ***_buffer_**,**
             **PCRE2_SIZE ***_bufflen_**);**
    


## DESCRIPTION



    
           This is a convenience function for extracting a captured substring
           into a given buffer. The arguments are:
    
             _match_data_    The match data block for the match
             _number_        Number of the required substring
             _buffer_        Buffer to receive the string
             _bufflen_       Length of buffer
    
           The _bufflen_ variable is updated with the length of the extracted
           string, excluding the terminating zero. The yield of the function
           is zero for success or one of the following error numbers:
    
             PCRE2_ERROR_NOSUBSTRING   there are no groups of that number
             PCRE2_ERROR_UNAVAILBLE    the ovector was too small for that
           group
             PCRE2_ERROR_UNSET         the group did not participate in the
           match
             PCRE2_ERROR_NOMEMORY      the buffer is too small
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# libpfm_intel_hswep_unc_r2pcie

## NAME



           libpfm_intel_hswep_unc_r2pcie - support for Intel Haswell-EP R2
           PCIe  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_r2pcie**
           **PMU desc: Intel Haswell-EP R2 PCIe uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell R2 PCIe uncore PMU.  This
           PMU model only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell R2PCIe
           uncore PMU:
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of R2PCIe cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold.  This is an integer modifier with values in
                  the range [0:15].
    
           **i** Invert the meaning of the threshold or edge filter. If set,
                  the event counts when strictly less than N occurrences
                  occur per cycle if threshold is set to N. When invert is
                  set, then threshold must be set to non-zero value. If set,
                  the event counts when the event transitions from occurring
                  to not occurring (falling edge) when edge detection is set.
                  This is a boolean modifier
    


* * *
# gnutls_x509_ext_export_aia

## NAME



           gnutls_x509_ext_export_aia - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_aia(gnutls_x509_aia_t** _aia_**,**
           **gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           gnutls_x509_aia_t aia
                       The authority info access
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will DER encode the Authority Information Access
           (AIA) extension; see RFC 5280 section 4.2.2.1 for more information
           on the extension.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# clock

## NAME



           clock - determine processor time
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <time.h>**
    
           **clock_t clock(void);**
    


## DESCRIPTION



           The **clock**() function returns an approximation of processor time
           used by the program.
    


## RETURN VALUE



           The value returned is the CPU time used so far as a _clock_t_ ; to
           get the number of seconds used, divide by **CLOCKS_PER_SEC**.  If the
           processor time used is not available or its value cannot be
           represented, the function returns the value _(clock_t) -1_.
    


## ATTRIBUTES



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


## VERSIONS



           XSI requires that **CLOCKS_PER_SEC** equals 1000000 independent of the
           actual resolution.
    
           On several other implementations, the value returned by **clock**()
           also includes the times of any children whose status has been
           collected via wait(2) (or another wait-type call).  Linux does not
           include the times of waited-for children in the value returned by
           **clock**().  The times(2) function, which explicitly returns
           (separate) information about the caller and its children, may be
           preferable.
    


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The C standard allows for arbitrary values at the start of the
           program; subtract the value returned from a call to **clock**() at the
           start of the program to get maximum portability.
    
           Note that the time can wrap around.  On a 32-bit system where
           **CLOCKS_PER_SEC** equals 1000000 this function will return the same
           value approximately every 72 minutes.
    


* * *
# function::returnval

## NAME



           function::returnval - Possible return value of probed function
    


## SYNOPSIS



               returnval:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Return the value of the register in which function values are
           typically returned. Can be used in probes where **$return** isn't
           available. This is only a guess of the actual return value and can
           be totally wrong. Normally only used in dwarfless probes.
    


* * *
# ldap_parse_vlv_control

## NAME



           ldap_parse_vlv_control - Decode the information returned from a
           search operation that used a VLV (virtual list view) control
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_parse_vlv_control( ld, ctrlp, target_posp, list_countp, contextp, errcodep )**
           LDAP *ld;
           LDAPControl **ctrlp;
           unsigned long *target_posp, *list_countp;
           struct berval **contextp;
           int *errcodep;
    


## DESCRIPTION



           The **ldap_parse_vlv_control** is used to decode the information
           returned from a search operation that used a VLV (virtual list
           view)control. It takes a null terminated array of LDAPControl
           structures, usually obtained by a call to the
           **ldap_parse_result** function, a _target_pos_ which points to the list
           index of the target entry. If this parameter is NULL, the target
           position is not returned. The index returned is an approximation
           of the position of the target entry. It is not guaranteed to be
           exact. The parameter _list_countp_ points to the server's estimate
           of the size of the list. If this parameter is NULL, the size is
           not returned. _contextp_ is a pointer to the address of a berval
           structure that contains a server-generated context identifier if
           server returns one. If server does not return a context
           identifier, the server returns a NULL in this parameter. If this
           parameter is set to NULL, the context identifier is not returned.
           You should use this returned context in the next call to create a
           VLV control. When the berval structure is no longer needed, you
           should free the memory by calling the _ber_bvfree function.e_
           _errcodep_ is an output parameter, which points to the result code
           returned by the server. If this parameter is NULL, the result code
           is not returned.
    
           See ldap.h for a list of possible return codes.
    


## ACKNOWLEDGEMENTS



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


* * *
# asin

## NAME



           asin, asinf, asinl - arc sine function
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



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


## DESCRIPTION



           These functions calculate the principal value of the arc sine of
           _x_ ; that is the value whose sine is _x_.
    


## RETURN VALUE



           On success, these functions return the principal value of the arc
           sine of _x_ in radians; the return value is in the range
           [-pi/2, pi/2].
    
           If _x_ is a NaN, a NaN is returned.
    
           If _x_ is +0 (-0), +0 (-0) is returned.
    
           If _x_ is outside the range [-1, 1], a domain error occurs, and a
           NaN is returned.
    


## 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:
    
           Domain error: _x_ is outside the range [-1, 1]
                  _errno_ is set to **EDOM**.  An invalid floating-point exception
                  (**FE_INVALID**) is raised.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# pcap_snapshot

## NAME



           pcap_snapshot - get the snapshot length
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_snapshot(pcap_t *p);**
    


## DESCRIPTION



           **pcap_snapshot**() returns the snapshot length specified when
           **pcap_set_snaplen**(3PCAP) or **pcap_open_live**(3PCAP) was called, for a
           live capture, or the snapshot length from the capture file, for a
           ``savefile''.
    
           It must not be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).
    


## RETURN VALUE



           **pcap_snapshot**() returns the snapshot length on success and
           **PCAP_ERROR_NOT_ACTIVATED** if called on a capture handle that has
           been created but not activated.
    


* * *
# function::set_kernel_long

## NAME



           function::set_kernel_long - Writes a long value to kernel memory
    


## SYNOPSIS



               set_kernel_long(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The kernel address to write the long to
    
           _val_
               The long which is to be written
    


## DESCRIPTION



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


* * *
# gnutls_psk_set_server_credentials_function3

## NAME



           gnutls_psk_set_server_credentials_function3 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_server_credentials_function3(gnutls_psk_server_credentials_t**
           _cred_**, gnutls_psk_server_credentials_function3** _func_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t cred
                       is a **gnutls_psk_server_credentials_t** type.
    
           gnutls_psk_server_credentials_function3 func
                       is the callback function
    


## DESCRIPTION



           This function can be used to set a callback to retrieve the user's
           PSK credentials.  The callback's function form is: int
           (*callback)(gnutls_session_t, const gnutls_datum_t* username,
           gnutls_datum_t* key, gnutls_psk_key_flags *flags);
    
           This callback function has the same semantics as that of
           **gnutls_psk_set_server_credentials_function2()** , but it returns
           flags associated with the key.  The callback may import external
           PSK using the method described in RFC 9258 by using
           **gnutls_psk_format_imported_identity()**.
    
            _username_ contains the actual username.  The  _key_ must be filled
           in using the **gnutls_malloc()**.
    
           In case the callback returned a negative number then gnutls will
           assume that the username does not exist.
    
           The callback function will only be called once per handshake.  The
           callback function should return 0 on success, while -1 indicates
           an error.
    


* * *
# pam_getenvlist

## NAME



           pam_getenvlist - getting the PAM environment
    


## SYNOPSIS



           **#include <security/pam_appl.h>**
    
           **char **pam_getenvlist(pam_handle_t ***_pamh_**);**
    


## DESCRIPTION



           The **pam_getenvlist** function returns a complete copy of the PAM
           environment as associated with the handle _pamh_. The PAM
           environment variables represent the contents of the regular
           environment variables of the authenticated user when service is
           granted.
    
           The format of the memory is a malloc()'d array of char pointers,
           the last element of which is set to NULL. Each of the non-NULL
           entries in this array point to a NUL terminated and malloc()'d
           char string of the form: "_name=value_ ".
    
           It should be noted that this memory will never be free()'d by
           libpam. Once obtained by a call to **pam_getenvlist** , it is the
           responsibility of the calling application to free() this memory.
    
           It is by design, and not a coincidence, that the format and
           contents of the returned array matches that required for the third
           argument of the execle(3) function call.
    


## RETURN VALUES



           The **pam_getenvlist** function returns NULL on failure.
    


* * *
# rdma_post_ud_send

## NAME



           rdma_post_ud_send - post a work request to send a datagram.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_ud_send (struct rdma_cm_id ***_id_**, void ***_context_**, void**
           *****_addr_**, size_t** _length_**, struct ibv_mr ***_mr_**, int** _flags_**, struct ibv_ah**
           *****_ah_**, uint32_t** _remote_qpn_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer will be posted.
    
           context     User-defined context associated with the request.
    
           addr        The address of the memory buffer to post.
    
           length      The length of the memory buffer.
    
           mr          Optional registered memory region associated with the
                       posted buffer.
    
           flags       Optional flags used to control the send operation.
    
           ah          An address handle describing the address of the remote
                       node.
    
           remote_qpn  The number of the destination queue pair.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the posted buffer
           will be sent to the specified destination queue pair.
    


## RETURN VALUE



           Returns 0 on success, or -1 on error.  If an error occurs, errno
           will be set to indicate the failure reason.
    


## NOTES



           The user is responsible for ensuring that the destination queue
           pair has queued a receive request before issuing the send
           operations.  For a list of supported flags, see ibv_post_send.
           Unless the send request is using inline data, the message buffer
           must have been registered before being posted, with the mr
           parameter referencing the registration.  The buffer must remain
           registered until the send completes.
    
           The user-defined context associated with the send request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# sigpause

## NAME



           sigpause - atomically release blocked signals and wait for
           interrupt
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <signal.h>**
    
           **[[deprecated]] int sigpause(int** _sigmask_**);  /* BSD (but see VERSIONS) */**
    
           **[[deprecated]] int sigpause(int** _sig_**);      /* POSIX.1 / SysV / UNIX 95 */**
    


## DESCRIPTION



           Don't use this function.  Use sigsuspend(2) instead.
    
           The function **sigpause**() is designed to wait for some signal.  It
           changes the process's signal mask (set of blocked signals), and
           then waits for a signal to arrive.  Upon arrival of a signal, the
           original signal mask is restored.
    


## RETURN VALUE



           If **sigpause**() returns, it was interrupted by a signal and the
           return value is -1 with _errno_ set to **EINTR**.
    


## ATTRIBUTES



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


## VERSIONS



           On Linux, this routine is a system call only on the Sparc
           (sparc64) architecture.
    
           glibc uses the BSD version if the **_BSD_SOURCE** feature test macro
           is defined and none of **_POSIX_SOURCE** , **_POSIX_C_SOURCE** ,
           **_XOPEN_SOURCE** , **_GNU_SOURCE** , or **_SVID_SOURCE** is defined.
           Otherwise, the System V version is used, and feature test macros
           must be defined as follows to obtain the declaration:
    
           •  Since glibc 2.26: _XOPEN_SOURCE >= 500
    
           •  glibc 2.25 and earlier: _XOPEN_SOURCE
    
           Since glibc 2.19, only the System V version is exposed by
           _< signal.h>_; applications that formerly used the BSD **sigpause**()
           should be amended to use sigsuspend(2).
    


## STANDARDS



           POSIX.1-2008.
    


* * *
# mlx5dv_modify_qp_sched_elem

## NAME



           mlx5dv_modify_qp_sched_elem - Connect a QP with a requestor and/or
           a responder scheduling element
    


## SYNOPSIS



                  int mlx5dv_modify_qp_sched_elem(struct ibv_qp *qp,
                                  struct mlx5dv_sched_leaf *requestor,
                                  struct mlx5dv_sched_leaf *responder);
    


## DESCRIPTION



           The QP scheduling element (SE) allows the association of a QP to a
           SE tree.  The SE is described in _mlx5dv_sched_node_create(3)_ man
           page.
    
           By default, all QPs are not associated to SE.  The default setting
           is ensuring fair bandwidth allocation with no maximum bandwidth
           limiting.
    
           A QP can be associate to a requestor and/or a responder SE
           following the IB spec definition.
    


## RETURN VALUE



           upon success 0 is returned or the value of errno on a failure.
    


* * *
# gnutls_x509_crt_get_subject

## NAME



           gnutls_x509_crt_get_subject - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_subject(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 Subject 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.
    


* * *
# gnutls_x509_crq_set_version

## NAME



           gnutls_x509_crq_set_version - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_version(gnutls_x509_crq_t** _crq_**, unsigned**
           **int** _version_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned int version
                       holds the version number, for v1 Requests must be 1
    


## DESCRIPTION



           This function will set the version of the certificate request.
           For version 1 requests this must be one.
    


## RETURNS



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


* * *
# iswdigit

## NAME



           iswdigit - test for decimal digit wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswdigit(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswdigit**() function is the wide-character equivalent of the
           isdigit(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "digit".
    
           The wide-character class "digit" is a subclass of the wide-
           character class "xdigit", and therefore also a subclass of the
           wide-character class "alnum", of the wide-character class "graph"
           and of the wide-character class "print".
    
           Being a subclass of the wide character class "print", the wide-
           character class "digit" is disjoint from the wide-character class
           "cntrl".
    
           Being a subclass of the wide-character class "graph", the wide-
           character class "digit" is disjoint from the wide-character class
           "space" and its subclass "blank".
    
           Being a subclass of the wide-character class "alnum", the wide-
           character class "digit" is disjoint from the wide-character class
           "punct".
    
           The wide-character class "digit" is disjoint from the wide-
           character class "alpha" and therefore also disjoint from its
           subclasses "lower", "upper".
    
           The wide-character class "digit" always contains exactly the
           digits '0' to '9'.
    


## RETURN VALUE



           The **iswdigit**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "digit".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswdigit**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# gnutls_protocol_get_id

## NAME



           gnutls_protocol_get_id - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_protocol_t gnutls_protocol_get_id(const char ***_name_**);**
    


## ARGUMENTS



           const char * name
                       is a protocol name
    


## DESCRIPTION



           The names are compared in a case insensitive way.
    


## RETURNS



           an id of the specified protocol, or **GNUTLS_VERSION_UNKNOWN** on
           error.
    


* * *
# function::proc_mem_size

## NAME



           function::proc_mem_size - Total program virtual memory size in
           pages
    


## SYNOPSIS



           1) proc_mem_size:long()
    
           2) proc_mem_size:long(pid:long)
    


## ARGUMENTS



           _pid_
               The pid of process to examine
    


## DESCRIPTION



           1) Returns the total virtual memory size in pages of the current
           process, or zero when there is no current process or the number of
           pages couldn't be retrieved.
    
           2) Returns the total virtual memory size in pages of the given
           process, or zero when that process doesn't exist or the number of
           pages couldn't be retrieved.
    


* * *
# towupper

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



           towupper, towupper_l — transliterate lowercase wide-character code
           to uppercase
    


## SYNOPSIS



           #include <wctype.h>
    
           wint_t towupper(wint_t _wc_);
           wint_t towupper_l(wint_t _wc_ , locale_t _locale_);
    


## DESCRIPTION



           For _towupper_(): 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 _towupper_() and _towupper_l_() functions have as a domain a type
           **wint_t** , the value of which the application shall ensure is a
           character representable as a **wchar_t** , and a wide-character code
           corresponding to a valid character in the locale used by the
           function or the value of WEOF.  If the argument has any other
           value, the behavior is undefined.  If the argument of _towupper_()
           or _towupper_l_() represents a lowercase wide-character code, and
           there exists a corresponding uppercase wide-character code as
           defined by character type information in the current locale or in
           the locale represented by _locale_ , respectively (category
           _LC_CTYPE_), the result shall be the corresponding uppercase wide-
           character code.  All other arguments in the domain are returned
           unchanged.
    
           The behavior is undefined if the _locale_ argument to _towupper_l_()
           is the special locale object LC_GLOBAL_LOCALE or is not a valid
           locale object handle.
    


## RETURN VALUE



           Upon successful completion, the _towupper_() and _towupper_l_()
           functions shall return the uppercase letter corresponding to the
           argument passed. Otherwise, they shall return the argument
           unchanged.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crt_list_import

## NAME



           gnutls_x509_crt_list_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_list_import(gnutls_x509_crt_t ***_certs_**,**
           **unsigned int ***_cert_max_**, const gnutls_datum_t ***_data_**,**
           **gnutls_x509_crt_fmt_t** _format_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t * certs
                       Indicates where the parsed list will be copied to.
                       Must not be initialized.
    
           unsigned int * cert_max
                       Initially must hold the maximum number of certs. It
                       will be updated with the number of certs available.
    
           const gnutls_datum_t * data
                       The PEM encoded certificate.
    
           gnutls_x509_crt_fmt_t format
                       One of DER or PEM.
    
           unsigned int flags
                       must be (0) or an OR'd sequence of
                       gnutls_certificate_import_flags.
    


## DESCRIPTION



           This function will convert the given PEM encoded certificate list
           to the native gnutls_x509_crt_t format. The output will be stored
           in  _certs_ .  They will be automatically initialized.
    
           The flag **GNUTLS_X509_CRT_LIST_IMPORT_FAIL_IF_EXCEED** will cause
           import to fail if the certificates in the provided buffer are more
           than the available structures. The
           **GNUTLS_X509_CRT_LIST_FAIL_IF_UNSORTED** flag will cause the function
           to fail if the provided list is not sorted from subject to issuer.
    
           If the Certificate is PEM encoded it should have a header of "X509
           CERTIFICATE", or "CERTIFICATE".
    


## RETURNS



           the number of certificates read or a negative error value.
    


* * *
# imaxdiv

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



           imaxdiv — return quotient and remainder
    


## SYNOPSIS



           #include <inttypes.h>
    
           imaxdiv_t imaxdiv(intmax_t _numer_ , intmax_t _denom_);
    


## 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 _imaxdiv_() function shall compute _numer_ / _denom_ and
           _numer_ % _denom_ in a single operation.
    


## RETURN VALUE



           The _imaxdiv_() function shall return a structure of type **imaxdiv_t** ,
           comprising both the quotient and the remainder. The structure
           shall contain (in either order) the members _quot_ (the quotient)
           and _rem_ (the remainder), each of which has type **intmax_t**.
    
           If either part of the result cannot be represented, the behavior
           is undefined.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# raise

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



           raise — send a signal to the executing process
    


## SYNOPSIS



           #include <signal.h>
    
           int raise(int _sig_);
    


## 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 _raise_() function shall send the signal _sig_ to the executing
           thread or process.  If a signal handler is called, the _raise_()
           function shall not return until after the signal handler does.
    
           The effect of the _raise_() function shall be equivalent to calling:
    
               pthread_kill(pthread_self(), sig);
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned. Otherwise, a non-
           zero value shall be returned and _errno_ shall be set to indicate
           the error.
    


## ERRORS



           The _raise_() function shall fail if:
    
           **EINVAL** The value of the _sig_ argument is an invalid signal number.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The term ``thread'' is an extension to the ISO C standard.
    


## FUTURE DIRECTIONS



           None.
    


* * *