tripathysagar/man_text huggingface dataset:
# acos

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



           acos, acosf, acosl — arc cosine functions
    


## SYNOPSIS



           #include <math.h>
    
           double acos(double _x_);
           float acosf(float _x_);
           long double acosl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the principal value of the arc
           cosine of their argument _x_.  The value of _x_ should be in the range
           [-1,1].
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the arc
           cosine of _x_ , in the range [0,π] radians.
    
           For finite values of _x_ not in the range [-1,1], a domain error
           shall occur, and either a NaN (if supported), or an
           implementation-defined value shall be returned.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is +1, +0 shall be returned.
    
           If _x_ is ±Inf, a domain error shall occur, and a NaN shall be
           returned.
    


## ERRORS



           These functions shall fail if:
    
           Domain Error
                       The _x_ argument is finite and is not in the range
                       [-1,1], or is ±Inf.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[EDOM]**.  If the integer expression (_math_errhandling_ &
                       MATH_ERREXCEPT) is non-zero, then the invalid
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# pmierrstr

## NAME



           **pmiErrStr** , **pmiErrStr_r** - convert a LOGIMPORT error code into a
           string
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/import.h>**
    
           **const char *pmiErrStr(int** _code_**);**
           **char *pmiErrStr_r(int** _code_**, char** _buf_**, int** _buflen_**);**
    
           **cc ... -lpcp_import -lpcp**
    


## Perl SYNOPSIS



           **use PCP::LogImport;**
    
           **pmiErrStr($**_code_**);**
    


## DESCRIPTION



           As   part   of  the  Performance  Co-Pilot  Log  Import  API  (see
           LOGIMPORT(3)), **pmiErrStr** translates error codes returned from  the
           other routines in the Log Import library into printable error mes‐
           sages.
    
           _code_  would normally have a negative value.  As a special case, if
           _code_ is -1 then the error code  returned  from  the  last  routine
           called in the LOGIMPORT library for this context will be used.
    
           The **pmiErrStr_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 **PMI_MAXERRMSGLEN** bytes.
    
           The set of possible error codes and messages is all those  defined
           by  pmErrStr(3)  and PCPIntro(3), plus the additional ones defined
           in **< pcp/import.h> **with error code names of the form **PMI_ERR_....**
    


* * *
# gnutls_pubkey_import_openpgp_raw

## NAME



           gnutls_pubkey_import_openpgp_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_openpgp_raw(gnutls_pubkey_t** _pkey_**, const**
           **gnutls_datum_t ***_data_**, gnutls_openpgp_crt_fmt_t** _format_**, const**
           **gnutls_openpgp_keyid_t** _keyid_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pkey
                       The public key
    
           const gnutls_datum_t * data
                       The public key data to be imported
    
           gnutls_openpgp_crt_fmt_t format
                       The format of the public key
    
           const gnutls_openpgp_keyid_t keyid
                       The key id to use (optional)
    
           unsigned int flags
                       Should be zero
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           3.1.3
    


* * *
# gnutls_x509_crq_get_key_rsa_raw

## NAME



           gnutls_x509_crq_get_key_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_key_rsa_raw(gnutls_x509_crq_t** _crq_**,**
           **gnutls_datum_t ***_m_**, gnutls_datum_t ***_e_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       Holds the certificate
    
           gnutls_datum_t * m
                       will hold the modulus
    
           gnutls_datum_t * e
                       will hold the public exponent
    


## DESCRIPTION



           This function will export the RSA public key's parameters found in
           the given structure.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# rdma_get_local_addr

## NAME



           rdma_get_local_addr - Returns the local IP address of a bound
           rdma_cm_id.
    


## SYNOPSIS



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


## ARGUMENTS



           id          RDMA identifier.
    


## DESCRIPTION



           Returns the local IP address for an rdma_cm_id that has been bound
           to a local device.
    


## RETURN VALUE



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


* * *
# probe::scheduler.process_fork

## NAME



           probe::scheduler.process_fork - Process forked
    


## SYNOPSIS



           scheduler.process_fork
    


## VALUES



           _parent_pid_
               PID of the parent process
    
           _child_pid_
               PID of the child process
    
           _name_
               name of the probe point
    


* * *
# dane_cert_usage_name

## NAME



           dane_cert_usage_name - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **const char * dane_cert_usage_name(dane_cert_usage_t** _usage_**);**
    


## ARGUMENTS



           dane_cert_usage_t usage
                       is a DANE certificate usage
    


## DESCRIPTION



           Convert a **dane_cert_usage_t** value to a string.
    


## RETURNS



           a string that contains the name of the specified type, or **NULL**.
    


* * *
# gnutls_session_ext_master_secret_status

## NAME



           gnutls_session_ext_master_secret_status - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_session_ext_master_secret_status(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           Get the status of the extended master secret extension
           negotiation.  This is in accordance to RFC7627. That information
           is also available to the more generic **gnutls_session_get_flags()**.
    


## RETURNS



           Non-zero if the negotiation was successful or zero otherwise.
    


* * *
# catanh

## NAME



           catanh, catanhf, catanhl - complex arc tangents hyperbolic
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex catanh(double complex** _z_**);**
           **float complex catanhf(float complex** _z_**);**
           **long double complex catanhl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex arc hyperbolic tangent of _z_.
           If _y = catanh(z)_ , then _z = ctanh(y)_.  The imaginary part of _y_ is
           chosen in the interval [-pi/2,pi/2].
    
           One has:
    
               catanh(z) = 0.5 * (clog(1 + z) - clog(1 - z))
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## EXAMPLES



           /* Link with "-lm" */
    
           #include <complex.h>
           #include <stdio.h>
           #include <stdlib.h>
           #include <unistd.h>
    
           int
           main(int argc, char *argv[])
           {
               double complex z, c, f;
    
               if (argc != 3) {
                   fprintf(stderr, "Usage: %s <real> <imag>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }
    
               z = atof(argv[1]) + atof(argv[2]) * I;
    
               c = catanh(z);
               printf("catanh() = %6.3f %6.3f*i\n", creal(c), cimag(c));
    
               f = 0.5 * (clog(1 + z) - clog(1 - z));
               printf("formula  = %6.3f %6.3f*i\n", creal(f), cimag(f));
    
               exit(EXIT_SUCCESS);
           }
    


* * *
# libpfm_intel_skx_unc_ubo

## NAME



           libpfm_intel_skx_unc_ubo - support for Intel Skylake X Server U-
           Box uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_ubo**
           **PMU desc: Intel Skylake X Server U-Box uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X server system
           configuration unit (U-Box) uncore PMU.
    


## MODIFIERS



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


* * *
# io_uring_cq_advance

## NAME



           io_uring_cq_advance - mark one or more io_uring completion events
           as consumed
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_cq_advance(struct io_uring ***_ring_**,**
                                     **unsigned** _nr_**);**
    


## DESCRIPTION



           The io_uring_cq_advance(3) function marks _nr_ IO completions
           belonging to the _ring_ param as consumed.
    
           After the caller has submitted a request with io_uring_submit(3),
           the application can retrieve the completion with
           io_uring_wait_cqe(3), io_uring_peek_cqe(3), or any of the other
           CQE retrieval helpers, and mark it as consumed with
           io_uring_cqe_seen(3).
    
           The function io_uring_cqe_seen(3) calls the function
           io_uring_cq_advance(3).
    
           Completions must be marked as seen, so their slot can get reused.
           Failure to do so will result in the same completion being returned
           on the next invocation.
    


## RETURN VALUE



           None
    


* * *
# gnutls_packet_deinit

## NAME



           gnutls_packet_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_packet_deinit(gnutls_packet_t** _packet_**);**
    


## ARGUMENTS



           gnutls_packet_t packet
                       is a pointer to a **gnutls_packet_st** structure.
    


## DESCRIPTION



           This function will deinitialize all data associated with the
           received packet.
    


## SINCE



           3.3.5
    


* * *
# rdma_post_recvv

## NAME



           rdma_post_recvv - post a work request to receive incoming
           messages.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_recvv (struct rdma_cm_id ***_id_**, void ***_context_**, struct**
           **ibv_sge ***_sgl_**, int** _nsge_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer(s) will be posted.
    
           context     User-defined context associated with the request.
    
           sgl         A scatter-gather list of memory buffers posted as a
                       single request.
    
           nsge        The number of scatter-gather entries in the sgl array.
    


## DESCRIPTION



           Posts a single work request to the receive queue of the queue pair
           associated with the rdma_cm_id.  The posted buffers will be queued
           to receive an incoming message sent by the remote peer.
    


## 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 receive is posted,
           and the total buffer space is large enough to contain all sent
           data before the peer posts the corresponding send message.  The
           message buffers must have been registered before being posted, and
           the buffers must remain registered until the receive completes.
    
           Messages may be posted to an rdma_cm_id only after a queue pair
           has been associated with it.  A queue pair is bound to an
           rdma_cm_id after calling rdma_create_ep or rdma_create_qp, if the
           rdma_cm_id is allocated using rdma_create_id.
    
           The user-defined context associated with the receive request will
           be returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# sd_bus_message_read_strv

## NAME



           sd_bus_message_read_strv, sd_bus_message_read_strv_extend - Access
           an array of strings in a message
    


## SYNOPSIS



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


## DESCRIPTION



           **sd_bus_message_read_strv()** reads an array of string-like items
           from the message _m_. The "read pointer" in the message must be
           right before an array of strings (D-Bus type "as"), object paths
           (D-Bus type "ao"), or signatures (D-Bus type "ag"). On success, a
           pointer to a **NULL** -terminated array of strings (strv) is returned
           in the output parameter _l_. Note that ownership of this array is
           transferred to the caller. Hence, the caller is responsible for
           freeing this array and its contents. Also note that as a matter of
           optimization, if an empty array is encountered a **NULL** pointer
           might be returned here, and should be considered equivalent to an
           array with zero entries.
    
           **sd_bus_message_read_strv_extend()** is similar, but the second
           parameter is an input-output parameter. If _*l_ is **NULL** , if behaves
           identically to **sd_bus_message_read_strv()**. Otherwise, _*l_ must
           point to a strv, which will be reallocated and extended with
           additional strings. This function is particularly useful when
           combining multiple lists of strings in a message or messages into
           a single array of strings.
    


## RETURN VALUE



           On success, these functions return a non-negative integer. On
           failure, they return a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               _m_ or _l_ are **NULL**.
    
               Added in version 246.
    
           **-EPERM**
               The message is not sealed.
    
               Added in version 246.
    
           **-EBADMSG**
               The message cannot be parsed.
    
               Added in version 246.
    
           **-ENXIO**
               The message "read pointer" is not right before an array of the
               appropriate type.
    
               Added in version 248.
    


* * *
# getpid

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



           getpid — get the process ID
    


## SYNOPSIS



           #include <unistd.h>
    
           pid_t getpid(void);
    


## DESCRIPTION



           The _getpid_() function shall return the process ID of the calling
           process.
    


## RETURN VALUE



           The _getpid_() function shall always be successful and no return
           value is reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::linuxmib-filter-default

## NAME



           tapset::linuxmib-filter-default - systemtap linuxmib-filter-
           default tapset
    


## DESCRIPTION



           **linuxmib_filter_key**
                  Default filter function for linuxmib.* probes
    
                  See function::linuxmib_filter_key(3stap)
                   for details.
    


* * *
# gnutls_pkcs7_get_signature_count

## NAME



           gnutls_pkcs7_get_signature_count - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_signature_count(gnutls_pkcs7_t** _pkcs7_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a **gnutls_pkcs7_t** type
    


## DESCRIPTION



           This function will return the number of signatures in the PKCS7
           structure.
    


## RETURNS



           On success, a positive number is returned, otherwise a negative
           error value.
    


## SINCE



           3.4.3
    


* * *
# umad_register2

## NAME



           umad_register2 - register the specified management class and
           version for port
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_register2(int** _port_fd_**, struct umad_reg_attr ***_attr_**, uint32_t ***_agent_id_**);**
    


## DESCRIPTION



           **umad_register2()** registers for a MAD agent using the provided
           registration attributes
    
           _port_fd_ the port on which to register the agent
    
           _attr_ The registration attributes as defined by the structure
           passed.  See below for details of this structure.
    
           _agent_id_ returned on success.  agent_id identifies the kernel MAD
           agent a MAD is received by or to be sent by.  agent_id is returned
           in the umad header "struct ib_user_mad" on recv and specified in
           umad_send when sending.
    


## REGISTRATION ATTRIBUTE STRUCTURE



           struct umad_reg_attr {
                   uint8_t    mgmt_class;
                   uint8_t    mgmt_class_version;
                   uint32_t   flags;
                   uint64_t   method_mask[2];
                   uint32_t   oui;
                   uint8_t    rmpp_version;
           };
    
           _mgmt_class_
           Management class to register for.
    
           _mgmt_class_version_
           Management class version to register for.
    
           _flags_
           Registration flags.  If a flag specified is not supported by the kernel,
           an error is returned, and the supported flags are returned in this field.
    
           Current flags are:
                   UMAD_USER_RMPP -- flag to indicate the kernel should not process
                   RMPP packets.  All RMPP packets will be treated like individual
                   MADs.  The user is responsible for implementing the RMPP
                   protocol.
    
           _method_mask_
           A bit mask which indicates which unsolicited methods this agent should
           receive.  Setting this array to 0 will result in the agent only
           receiving response MADs for which a request was sent.
    
           _oui_
           The oui (in host order) to use for vendor classes 0x30 - 0x4f.
           Otherwise ignored.
    
           _rmpp_version_
           If the class supports RMPP and kernel RMPP is enabled (the default)
           indicate which rmpp_version to use.
    


## RETURN VALUE



           **umad_register2()** returns 0 on success and +ERRNO on failure.
    


* * *
# getwchar

## NAME



           getwchar - read a wide character from standard input
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **wint_t getwchar(void);**
    


## DESCRIPTION



           The **getwchar**() function is the wide-character equivalent of the
           getchar(3) function.  It reads a wide character from _stdin_ and
           returns it.  If the end of stream is reached, or if _ferror(stdin)_
           becomes true, it returns **WEOF**.  If a wide-character conversion
           error occurs, it sets _errno_ to **EILSEQ** and returns **WEOF**.
    
           For a nonlocking counterpart, see unlocked_stdio(3).
    


## RETURN VALUE



           The **getwchar**() function returns the next wide-character from
           standard input, or **WEOF**.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **getwchar**() depends on the **LC_CTYPE** category of the
           current locale.
    
           It is reasonable to expect that **getwchar**() will actually read a
           multibyte sequence from standard input and then convert it to a
           wide character.
    


* * *
# getrusage

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



           getrusage — get information about resource utilization
    


## SYNOPSIS



           #include <sys/resource.h>
    
           int getrusage(int _who_ , struct rusage *_r_usage_);
    


## DESCRIPTION



           The _getrusage_() function shall provide measures of the resources
           used by the current process or its terminated and waited-for child
           processes. If the value of the _who_ argument is RUSAGE_SELF,
           information shall be returned about resources used by the current
           process. If the value of the _who_ argument is RUSAGE_CHILDREN,
           information shall be returned about resources used by the
           terminated and waited-for children of the current process. If the
           child is never waited for (for example, if the parent has
           SA_NOCLDWAIT set or sets SIGCHLD to SIG_IGN), the resource
           information for the child process is discarded and not included in
           the resource information provided by _getrusage_().
    
           The _r_usage_ argument is a pointer to an object of type **struct**
           **rusage** in which the returned information is stored.
    


## RETURN VALUE



           Upon successful completion, _getrusage_() shall return 0; otherwise,
           -1 shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _getrusage_() function shall fail if:
    
           **EINVAL** The value of the _who_ argument is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



       **Using getrusage()**
           The following example returns information about the resources used
           by the current process.
    
               #include <sys/resource.h>
               ...
               int who = RUSAGE_SELF;
               struct rusage usage;
               int ret;
    
               ret = getrusage(who, &usage);
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::stap.pass1b

## NAME



           probe::stap.pass1b - Starting stap pass1 (parsing library scripts)
    


## SYNOPSIS



           stap.pass1b
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass1b fires just before the library scripts are parsed.
    


* * *
# gnutls_x509_rdn_get_by_oid

## NAME



           gnutls_x509_rdn_get_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t ***_idn_**, const**
           **char ***_oid_**, unsigned** _indx_**, unsigned int** _raw_flag_**, void ***_buf_**,**
           **size_t ***_buf_size_**);**
    


## ARGUMENTS



           const gnutls_datum_t * idn
                       should contain a DER encoded RDN sequence
    
           const char * oid
                       an Object Identifier
    
           unsigned indx
                       In case multiple same OIDs exist in the RDN indicates
                       which to send. Use 0 for the first one.
    
           unsigned int raw_flag
                       If non-zero then the raw DER data are returned.
    
           void * buf  a pointer to a structure to hold the peer's name
    
           size_t * buf_size
                       holds the size of  _buf_
    


## DESCRIPTION



           This function will return the name of the given Object identifier,
           of the RDN sequence.  The name will be encoded using the rules
           from RFC4514.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, or
           **GNUTLS_E_SHORT_MEMORY_BUFFER** is returned and * _buf_size_ is updated
           if the provided buffer is not long enough, otherwise a negative
           error value.
    


* * *
# function::cpu

## NAME



           function::cpu - Returns the current cpu number
    


## SYNOPSIS



               cpu:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the current cpu number.
    


* * *
# audit_set_enabled

## NAME



           audit_set_enabled - Enable or disable auditing
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_set_enabled(int** _fd,_**uint32_t"**_enabled);"_
    


## DESCRIPTION



           audit_set_enabled is used to control whether or not the audit
           system is active. When the audit system is enabled (enabled set to
           1), every syscall will pass through the audit system to collect
           information and potentially trigger an event.
    
           If the audit system is disabled (enabled set to 0), syscalls do
           not enter the audit system and no data is collected. There may be
           some events generated by MAC subsystems like SE Linux even though
           the audit system is disabled. It is possible to suppress those
           events, too, by adding an audit rule with flags set to
           AUDIT_FILTER_EXCLUDE
    


## RETURN VALUE



           The return value is <= 0 on error, otherwise it is the netlink
           sequence id number. This function can have any error that sendto
           would encounter.
    


* * *
# rdma_dereg_mr

## NAME



           rdma_dereg_mr - deregisters a registered memory region.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_dereg_mr (struct ibv_mr ***_mr_**);**
    


## ARGUMENTS



           mr          A reference to a registered memory buffer.
    


## DESCRIPTION



           Deregisters a memory buffer that had been registered for RDMA or
           message operations.  A user should call rdma_dereg_mr for all
           registered memory associated with an rdma_cm_id before destroying
           the rdma_cm_id.
    


## RETURN VALUE



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


## NOTES



           All memory registered with an rdma_cm_id is associated with the
           protection domain associated with the id.  Users must deregister
           all registered memory before the protection domain can be
           destroyed.
    


* * *
# curs_addwstr

## NAME



           **addwstr** , **addnwstr** , **waddwstr** , **waddnwstr** , **mvaddwstr** , **mvaddnwstr** ,
           **mvwaddwstr** , **mvwaddnwstr** - add a string of wide characters to a
           **curses** window and advance cursor
    


## SYNOPSIS



           **#include <curses.h>**
    
           **int addwstr(const wchar_t ***_wstr_**);**
           **int addnwstr(const wchar_t ***_wstr_**, int** _n_**);**
           **int waddwstr(WINDOW ***_win_**, const wchar_t ***_wstr_**);**
           **int waddnwstr(WINDOW ***_win_**, const wchar_t ***_wstr_**, int** _n_**);**
    
           **int mvaddwstr(int** _y_**, int** _x_**, const wchar_t ***_wstr_**);**
           **int mvaddnwstr(int** _y_**, int** _x_**, const wchar_t ***_wstr_**, int** _n_**);**
           **int mvwaddwstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const wchar_t ***_wstr_**);**
           **int mvwaddnwstr(WINDOW ***_win_**, int** _y_**, int** _x_**, const wchar_t ***_wstr_**, int** _n_**);**
    


## DESCRIPTION



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


## RETURN VALUE



           All functions return the integer **ERR** upon failure and **OK** on  suc‐
           cess.
    
           X/Open  does not define any error conditions.  This implementation
           returns an error
    
           •   if the window pointer is null or
    
           •   if the string pointer is null or
    
           •   if the corresponding calls to **wadd_wch** return an error.
    
           Functions with a “mv” prefix first perform a cursor movement using
           **wmove** , and return an error if the position is outside the window,
           or if the window pointer is null.
    


## NOTES



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


## PORTABILITY



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


* * *
# gnutls_srp_set_prime_bits

## NAME



           gnutls_srp_set_prime_bits - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_srp_set_prime_bits(gnutls_session_t** _session_**, unsigned**
           **int** _bits_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           unsigned int bits
                       is the number of bits
    


## DESCRIPTION



           This function sets the minimum accepted number of bits, for use in
           an SRP key exchange.  If zero, the default 2048 bits will be used.
    
           In the client side it sets the minimum accepted number of bits.
           If a server sends a prime with less bits than that
           **GNUTLS_E_RECEIVED_ILLEGAL_PARAMETER** will be returned by the
           handshake.
    
           This function has no effect in server side.
    


## SINCE



           2.6.0
    


* * *
# tanh

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



           tanh, tanhf, tanhl — hyperbolic tangent functions
    


## SYNOPSIS



           #include <math.h>
    
           double tanh(double _x_);
           float tanhf(float _x_);
           long double tanhl(long double _x_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the hyperbolic tangent of their
           argument _x_.
    
           An application wishing to check for error situations should set
           _errno_ to zero and call _feclearexcept_(FE_ALL_EXCEPT) before calling
           these functions. On return, if _errno_ is non-zero or
           _fetestexcept_(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW |
           FE_UNDERFLOW) is non-zero, an error has occurred.
    


## RETURN VALUE



           Upon successful completion, these functions shall return the
           hyperbolic tangent of _x_.
    
           If _x_ is NaN, a NaN shall be returned.
    
           If _x_ is ±0, _x_ shall be returned.
    
           If _x_ is ±Inf, ±1 shall be returned.
    
           If _x_ is subnormal, a range error may occur
           and _x_ should be returned.
    
           If _x_ is not returned, _tanh_(), _tanhf_(), and _tanhl_() shall return an
           implementation-defined value no greater in magnitude than DBL_MIN,
           FLT_MIN, and LDBL_MIN, respectively.
    


## ERRORS



           These functions may fail if:
    
           Range Error The value of _x_ is subnormal.
    
                       If the integer expression (_math_errhandling_ &
                       MATH_ERRNO) is non-zero, then _errno_ shall be set to
                       **[ERANGE]**.  If the integer expression (_math_errhandling_
                       & MATH_ERREXCEPT) is non-zero, then the underflow
                       floating-point exception shall be raised.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           On error, the expressions (_math_errhandling_ & MATH_ERRNO) and
           (_math_errhandling_ & MATH_ERREXCEPT) are independent of each other,
           but at least one of them must be non-zero.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# ldap_modrdn

## NAME



           ldap_modrdn, ldap_modrdn_s, ldap_modrdn2, ldap_modrdn2_s - Perform
           an LDAP modify RDN operation
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_modrdn(ld, dn, newrdn)**
           LDAP ∗ld;
           char ∗dn, ∗newrdn;
    
           **int ldap_modrdn_s(ld, dn, newrdn)**
           LDAP ∗ld;
           char ∗dn, ∗newrdn;
    
           **int ldap_modrdn2(ld, dn, newrdn, deleteoldrdn)**
           LDAP ∗ld;
           char ∗dn, ∗newrdn;
           int deleteoldrdn;
    
           **int ldap_modrdn2_s(ld, dn, newrdn, deleteoldrdn)**
           LDAP ∗ld;
           char ∗dn, ∗newrdn;
           int deleteoldrdn;
    


## DESCRIPTION



           The **ldap_modrdn()** and **ldap_modrdn_s()** routines perform an LDAP
           modify RDN operation.  They both take _dn_ , the DN of the entry
           whose RDN is to be changed, and _newrdn_ , the new RDN to give the
           entry.  The old RDN of the entry is never kept as an attribute of
           the entry.  **ldap_modrdn()** is asynchronous, returning the message
           id of the operation it initiates.  **ldap_modrdn_s()** is synchronous,
           returning the LDAP error code indicating the success or failure of
           the operation.  Use of these routines is deprecated.  Use the
           versions described below instead.
    
           The **ldap_modrdn2()** and **ldap_modrdn2_s()** routines also perform an
           LDAP modify RDN operation, taking the same parameters as above.
           In addition, they both take the _deleteoldrdn_ parameter which is
           used as a boolean value to indicate whether the old RDN values
           should be deleted from the entry or not.
    


## ERRORS



           The synchronous (_s) versions of these routines return an LDAP
           error code, either LDAP_SUCCESS or an error if there was trouble.
           The asynchronous versions return -1 in case of trouble, setting
           the **ld_errno** field of _ld_.  See ldap_error(3) for more details.
    


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


* * *
# form_opts

## NAME



           **set_form_opts** , **form_opts_on** , **form_opts_off** , **form_opts** - set and
           get form options
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_form_opts(FORM ***_form_**, Field_Options** _opts_**);**
           **Field_Options form_opts(const FORM ***_form_**);**
    
           **int form_opts_on(FORM ***_form_**, Field_Options** _opts_**);**
           **int form_opts_off(FORM ***_form_**, Field_Options** _opts_**);**
    


## DESCRIPTION



           The function **set_form_opts** sets all the given form's option bits
           (form option bits may be logically-OR'ed together).
    
           The function **form_opts_on** turns on the given option bits, and
           leaves others alone.
    
           The function **form_opts_off** turns off the given option bits, and
           leaves others alone.
    
           The function **form_opts** returns the form's current option bits.
    
           The following options are defined (all are on by default):
    
           O_NL_OVERLOAD
                Overload the **REQ_NEW_LINE** forms driver request so that
                calling it at the end of a field goes to the next field.
    
           O_BS_OVERLOAD
                Overload the **REQ_DEL_PREV** forms driver request so that
                calling it at the beginning of a field goes to the previous
                field.
    


## RETURN VALUE



           Except for **form_opts** , each routine returns one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



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


* * *
# gnutls_srp_base64_encode2

## NAME



           gnutls_srp_base64_encode2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_srp_base64_encode2(const gnutls_datum_t ***_data_**,**
           **gnutls_datum_t ***_result_**);**
    


## ARGUMENTS



           const gnutls_datum_t * data
                       contains the raw data
    
           gnutls_datum_t * result
                       will hold the newly allocated encoded data
    


## DESCRIPTION



           This function will convert the given data to printable data, using
           the base64 encoding.  This is the encoding used in SRP password
           files.  This function will allocate the required memory to hold
           the encoded data.
    
           You should use **gnutls_free()** to free the returned data.
    
           Warning!  This base64 encoding is not the "standard" encoding, so
           do not use it for non-SRP purposes.
    


## RETURNS



           0 on success, or an error code.
    


* * *
# pmopenlog

## NAME



           **pmOpenLog** - create a log file for diagnostics and debug output
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **FILE *pmOpenLog(const char ***_progname_**, const char ***_logname_**,**
                           **FILE ***_oldstream_**, int ***_status_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           **pmOpenLog** reassigns  the  standard I/O stream _oldstream_ (normally
           **stderr**) to be associated with the file _logname_.
    
           If _logname_ is not **"-"** and the file already exists, it will be  re‐
           named  to  _logname_**.prev** else removed.  Due to permissions restric‐
           tions, the rename or removal may not succeed, but  in  the  common
           use  cases  _logname_**.prev** remains with the contents of the previous
           version of _logname_.  Then _logname_ is recreated if possible (to en‐
           sure correct ownership and permissions from the caller to  **pmOpen‐**
           **Log**).
    
           As  a special case, if _logname_ is "**-** " then no renaming, removal or
           reopening is performed and the function simply sets  _status_  to  **1**
           and returns _oldstream_.  This is useful when the caller wants diag‐
           nostics  on _oldstream_ stream (normally **stderr**) rather than a file,
           e.g.  **pmlogger -l-** or **pmcd -f -l-**.  Logging to **stderr** is also use‐
           ful for PMDAs in a containerized environment where it  is  benefi‐
           cial  for all PMDA logs to be written to **pmcd** 's **stderr** stream (and
           thus to a single destination), whether that is a file such as  **pm‐**
           **cd.log** or the original stream inherited from the shell.
    
           On return, the function value is the standard I/O stream, possibly
           replacing  _oldstream_.   In the event of an error, the return value
           will be _oldstream_ unchanged and _status_ will be **0**.
    
           For success, _status_ is **1** , and a standard preamble  is  written  to
           _logname_
                **Log for** _progname_ **on** _hostname_ **started** _date and time_
           and an atexit(3) handler is installed to write the postscript mes‐
           sage to _logname_
                **Log finished** _date and time_
           when the processes exits.
    
           _progname_ is only used to annotate messages.
    


* * *