tripathysagar/man_text huggingface dataset:
# probe::signal.procmask

## NAME



           probe::signal.procmask - Examining or changing blocked signals
    


## SYNOPSIS



           signal.procmask
    


## VALUES



           _name_
               Name of the probe point
    
           _sigset_
               The actual value to be set for sigset_t (correct?)
    
           _sigset_addr_
               The address of the signal set (sigset_t) to be implemented
    
           _how_
               Indicates how to change the blocked signals; possible values
               are SIG_BLOCK=0 (for blocking signals), SIG_UNBLOCK=1 (for
               unblocking signals), and SIG_SETMASK=2 for setting the signal
               mask.
    
           _oldsigset_addr_
               The old address of the signal set (sigset_t)
    


* * *
# libpfm_intel_atom

## NAME



           libpfm_intel_atom - support for Intel Atom processors
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: atom**
           **PMU desc: Intel Atom**
    


## DESCRIPTION



           The library supports all Intel Atom-based processors that includes
           family 6 model 28.
    


## MODIFIERS



           The following modifiers are supported on Intel Atom processors:
    
           **u** Measure at user level which includes privilege levels 1, 2,
                  3. This corresponds to **PFM_PLM3**.  This is a boolean
                  modifier.
    
           **k** Measure at kernel level which includes privilege level 0.
                  This corresponds to **PFM_PLM0**.  This is a boolean modifier.
    
           **i** Invert the meaning of the event. The counter will now count
                  cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition. This is a boolean modifier.
    
           **c** Set the counter mask value. The mask acts as a threshold.
                  The counter will count the number of cycles in which the
                  number of occurrences of the event is greater or equal to
                  the threshold. This is an integer modifier with values in
                  the range [0:255].
    
           **t** Measure on both threads at the same time assuming hyper-
                  threading is enabled. This is a boolean modifier.
    


* * *
# ldap_first_reference

## NAME



           ldap_first_reference, ldap_next_reference, ldap_count_references -
           Stepping through continuation references in a result chain
    


## LIBRARY



           OpenLDAP LDAP (libldap, -lldap)
    


## SYNOPSIS



           **#include <ldap.h>**
    
           **int ldap_count_references( LDAP *ld, LDAPMessage *result )**
    
           **LDAPMessage *ldap_first_reference( LDAP *ld, LDAPMessage *result )**
    
           **LDAPMessage *ldap_next_reference( LDAP *ld, LDAPMessage *reference )**
    


## DESCRIPTION



           These routines are used to step through the continuation
           references in a result chain received from ldap_result(3) or the
           synchronous LDAP search operation routines.
    
           The **ldap_first_reference()** routine is used to retrieve the first
           reference message in a result chain.  It takes the _result_ as
           returned by a call to ldap_result(3), ldap_search_s(3) or
           ldap_search_st(3) and returns a pointer to the first reference
           message in the result chain.
    
           This pointer should be supplied on a subsequent call to
           **ldap_next_reference()** to get the next reference message, the
           result of which should be supplied to the next call to
           **ldap_next_reference()** , etc.  **ldap_next_reference()** will return
           NULL when there are no more reference messages.  The reference
           messages returned from these calls are used by
           ldap_parse_reference(3) to extract referrals and controls.
    
           A count of the number of reference messages in the search result
           can be obtained by calling **ldap_count_references()**.  It can also
           be used to count the number of reference messages remaining in a
           result chain.
    


## ERRORS



           If an error occurs in **ldap_first_reference()** or
           **ldap_next_reference()** , NULL is returned.  If an error occurs in
           **ldap_count_references()** , -1 is returned.
    


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


* * *
# gnutls_x509_dn_oid_name

## NAME



           gnutls_x509_dn_oid_name - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **const char * gnutls_x509_dn_oid_name(const char ***_oid_**, unsigned**
           **int** _flags_**);**
    


## ARGUMENTS



           const char * oid
                       holds an Object Identifier in a null terminated string
    
           unsigned int flags
                       0 or GNUTLS_X509_DN_OID_*
    


## DESCRIPTION



           This function will return the name of a known DN OID. If
           **GNUTLS_X509_DN_OID_RETURN_OID** is specified this function will
           return the given OID if no descriptive name has been found.
    


## RETURNS



           A null terminated string or NULL otherwise.
    


## SINCE



           3.0
    


* * *
# io_uring_prep_files_update

## NAME



           io_uring_prep_files_update - prepare a registered file update
           request
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_files_update(struct io_uring_sqe ***_sqe_**,**
                                           **int ***_fds_**,**
                                           **unsigned** _nr_fds_**,**
                                           **int** _offset_**);**
    


## DESCRIPTION



           The io_uring_prep_files_update(3) function prepares a request for
           updating a number of previously registered file descriptors. The
           submission queue entry _sqe_ is setup to use the file descriptor
           array pointed to by _fds_ and of _nr_fds_ in length to update that
           amount of previously registered files starting at offset _offset_.
    
           Once a previously registered file is updated with a new one, the
           existing entry is updated and then removed from the table. This
           operation is equivalent to first unregistering that entry and then
           inserting a new one, just bundled into one combined operation.
    
           If _offset_ is specified as IORING_FILE_INDEX_ALLOC, io_uring will
           allocate free direct descriptors instead of having the application
           to pass, and store allocated direct descriptors into _fds_ array,
           _cqe- >res_ will return the number of direct descriptors allocated.
    


## RETURN VALUE



           None
    


## ERRORS



           These are the errors that are reported in the CQE _res_ field. On
           success, _res_ will contain the number of successfully updated file
           descriptors. On error, the following errors can occur.
    
           **-ENOMEM**
                  The kernel was unable to allocate memory for the request.
    
           **-EINVAL**
                  One of the fields set in the SQE was invalid.
    
           **-EFAULT**
                  The kernel was unable to copy in the memory pointed to by
                  _fds_.
    
           **-EBADF** On of the descriptors located in _fds_ didn't refer to a
                  valid file descriptor, or one of the file descriptors in
                  the array referred to an io_uring instance.
    
           **-EOVERFLOW**
                  The product of _offset_ and _nr_fds_ exceed the valid amount or
                  overflowed.
    


## NOTES



           As with any request that passes in data in a struct, that data
           must remain valid until the request has been successfully
           submitted. It need not remain valid until completion. Once a
           request has been submitted, the in-kernel state is stable. Very
           early kernels (5.4 and earlier) required state to be stable until
           the completion occurred. Applications can test for this behavior
           by inspecting the **IORING_FEAT_SUBMIT_STABLE** flag passed back from
           io_uring_queue_init_params(3).
    


* * *
# getrpcport

## NAME



           getrpcport - get RPC port number
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <rpc/rpc.h>**
    
           **int getrpcport(const char ***_host_**, unsigned long** _prognum_**,**
                          **unsigned long** _versnum_**, unsigned int** _proto_**);**
    


## DESCRIPTION



           **getrpcport**() returns the port number for version _versnum_ of the
           RPC program _prognum_ running on _host_ and using protocol _proto_.  It
           returns 0 if it cannot contact the portmapper, or if _prognum_ is
           not registered.  If _prognum_ is registered but not with version
           _versnum_ , it will still return a port number (for some version of
           the program) indicating that the program is indeed registered.
           The version mismatch will be detected upon the first call to the
           service.
    


## ATTRIBUTES



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


## STANDARDS



           BSD.
    


* * *
# rdma_post_write

## NAME



           rdma_post_write - post an RDMA write work request.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **int rdma_post_write (struct rdma_cm_id ***_id_**, void ***_context_**, void**
           *****_addr_**, size_t** _length_**, struct ibv_mr ***_mr_**, int** _flags_**, uint64_t**
           _remote_addr_**, uint32_t** _rkey_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       request will be posted.
    
           context     User-defined context associated with the request.
    
           addr        The local address of the source of the write request.
    
           length      The length of the write operation.
    
           mr          Optional memory region associated with the local
                       buffer.
    
           flags       Optional flags used to control the write operation.
    
           remote_addr The address of the remote registered memory to write
                       into.
    
           rkey        The registered memory key associated with the remote
                       address.
    


## DESCRIPTION



           Posts a work request to the send queue of the queue pair
           associated with the rdma_cm_id.  The contents of the local data
           buffer will be written into the remote memory region.
    


## RETURN VALUE



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


## NOTES



           For a list of supported flags, see ibv_post_send.  Unless inline
           data is specified, the local data buffer must have been registered
           before the write is issued, and the buffer must remain registered
           until the write completes.  The remote buffer must always be
           registered.
    
           Write operations may not be posted to an rdma_cm_id or the
           corresponding queue pair until it has been connected.
    
           The user-defined context associated with the write request will be
           returned to the user through the work completion wr_id, work
           request identifier, field.
    


* * *
# umad_get_issm_path

## NAME



           umad_get_issm_path - get path of issm device
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_get_issm_path(char** _*ca_name_**, int** _portnum_**,**_char_***path,**_int_**max);**
    


## DESCRIPTION



           **umad_get_issm_path()** resolves path to issm device (which used for
           setting/clearing PortInfo:CapMask IsSM bit) for _portnum_ of the IB
           device _ca_name_ , it stores resolved path in _path_ array which
           cannot exceed _max_ bytes in length (including NULL terminator).
           Opening issm device sets PortInfo:CapMask IsSM bit and closing
           clears it.
    


## RETURN VALUE



           **umad_open_port()** returns 0 on success and a negative value on
           error as follows:
            -ENODEV IB device can't be resolved
            -EINVAL port is not valid (bad _portnum_ or no umad device)
    


* * *
# gnutls_global_set_mutex

## NAME



           gnutls_global_set_mutex - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_global_set_mutex(mutex_init_func** _init_**,**
           **mutex_deinit_func** _deinit_**, mutex_lock_func** _lock_**, mutex_unlock_func**
           _unlock_**);**
    


## ARGUMENTS



           mutex_init_func init
                       mutex initialization function
    
           mutex_deinit_func deinit
                       mutex deinitialization function
    
           mutex_lock_func lock
                       mutex locking function
    
           mutex_unlock_func unlock
                       mutex unlocking function
    


## DESCRIPTION



           With this function you are allowed to override the default mutex
           locks used in some parts of gnutls and dependent libraries. This
           function should be used if you have complete control of your
           program and libraries.  Do not call this function from a library,
           or preferably from any application unless really needed to. GnuTLS
           will use the appropriate locks for the running system.
    
           This function must be called prior to any other GnuTLS function;
           otherwise the behavior is undefined.
    


## DEPRECATED



           This function is discouraged on GnuTLS 3.7.3 or later.
    


## SINCE



           2.12.0
    


* * *
# function::read_stopwatch_ns

## NAME



           function::read_stopwatch_ns - Reads the time in nanoseconds for a
           stopwatch
    


## SYNOPSIS



               read_stopwatch_ns:long(name:string)
    


## ARGUMENTS



           _name_
               stopwatch name
    


## DESCRIPTION



           Returns time in nanoseconds for stopwatch _name_. Creates stopwatch
           _name_ if it does not currently exist.
    


* * *
# gnutls_ocsp_status_request_is_checked

## NAME



           gnutls_ocsp_status_request_is_checked - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **unsigned gnutls_ocsp_status_request_is_checked(gnutls_session_t**
           _session_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    
           unsigned int flags
                       should be zero or **GNUTLS_OCSP_SR_IS_AVAIL**
    


## DESCRIPTION



           When flags are zero this function returns non-zero if a valid OCSP
           status response was included in the TLS handshake. That is, an
           OCSP status response which is not too old, superseded or marks the
           certificate as revoked.  It returns zero otherwise.
    
           When the flag **GNUTLS_OCSP_SR_IS_AVAIL** is specified, the function
           returns non-zero if an OCSP status response was included in the
           handshake even if it was invalid. Otherwise, if no OCSP status
           response was included, it returns zero. The
           **GNUTLS_OCSP_SR_IS_AVAIL** flag was introduced in GnuTLS 3.4.0.
    
           This is a helper function when needing to decide whether to
           perform an explicit OCSP validity check on the peer's certificate.
           Should be called after any of gnutls_certificate_verify_peers*()
           are called.
    
           This function is always usable on client side, but on server side
           only under TLS 1.3, which is the first version of TLS that allows
           clients to send OCSP responses.
    


## RETURNS



           Non-zero if the response was valid, or a zero if it wasn't sent,
           or sent and was invalid.
    


## SINCE



           3.1.4
    


* * *
# gnutls_db_remove_session

## NAME



           gnutls_db_remove_session - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_db_remove_session(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function will remove the current session data from the
           session database.  This will prevent future handshakes reusing
           these session data.  This function should be called if a session
           was terminated abnormally, and before **gnutls_deinit()** is called.
    
           Normally **gnutls_deinit()** will remove abnormally terminated
           sessions.
    


* * *
# function::bytes_to_string

## NAME



           function::bytes_to_string - Human readable string for given bytes
    


## SYNOPSIS



               bytes_to_string:string(bytes:long)
    


## ARGUMENTS



           _bytes_
               Number of bytes to translate.
    


## DESCRIPTION



           Returns a string representing the number of bytes (up to 1024
           bytes), the number of kilobytes (when less than 1024K) postfixed
           by 'K', the number of megabytes (when less than 1024M) postfixed
           by 'M' or the number of gigabytes postfixed by 'G'. If
           representing K, M or G, and the number is amount is less than 100,
           it includes a '.' plus the remainer. The returned string will be 5
           characters wide (padding with whitespace at the front) unless
           negative or representing more than 9999G bytes.
    


* * *
# gnutls_subject_alt_names_init

## NAME



           gnutls_subject_alt_names_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_subject_alt_names_init(gnutls_subject_alt_names_t ***
           _sans_**);**
    


## ARGUMENTS



           gnutls_subject_alt_names_t * sans
                       The alternative names
    


## DESCRIPTION



           This function will initialize an alternative names structure.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_x509_dn_oid_known

## NAME



           gnutls_x509_dn_oid_known - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_oid_known(const char ***_oid_**);**
    


## ARGUMENTS



           const char * oid
                       holds an Object Identifier in a null terminated string
    


## DESCRIPTION



           This function will inform about known DN OIDs. This is useful
           since functions like **gnutls_x509_crt_set_dn_by_oid()** use the
           information on known OIDs to properly encode their input. Object
           Identifiers that are not known are not encoded by these functions,
           and their input is stored directly into the ASN.1 structure. In
           that case of unknown OIDs, you have the responsibility of DER
           encoding your data.
    


## RETURNS



           1 on known OIDs and 0 otherwise.
    


* * *
# mitem_userptr

## NAME



           **set_item_userptr** , **item_userptr** - associate application data with a
           menu item
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_item_userptr(ITEM ***_item_**, void ***_userptr_**);**
           **void *item_userptr(const ITEM ***_item_**);**
    


## DESCRIPTION



           Every menu item has a field that can be used to hold application-
           specific data (that is, the menu-driver code leaves it alone).
           These functions get and set that field.
    


## RETURN VALUE



           The function **item_userptr** returns a pointer (possibly **NULL**).  It
           does not set **errno**.
    
           The **set_item_userptr** always returns **E_OK**(success).
    


## NOTES



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


## PORTABILITY



           These routines emulate the System V menu library.  They were not
           supported on Version 7 or BSD versions.
    
           The user pointer is a void pointer.  We chose not to leave it as a
           char pointer for SVr4 compatibility.
    


* * *
# gnutls_pkcs11_privkey_import_url

## NAME



           gnutls_pkcs11_privkey_import_url - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_privkey_import_url(gnutls_pkcs11_privkey_t** _pkey_**,**
           **const char ***_url_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t pkey
                       The private key
    
           const char * url
                       a PKCS 11 url identifying the key
    
           unsigned int flags
                       Or sequence of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will "import" a PKCS 11 URL identifying a private
           key to the **gnutls_pkcs11_privkey_t** type. In reality since in most
           cases keys cannot be exported, the private key structure is being
           associated with the available operations on the token.
    


## RETURNS



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


* * *
# strpbrk

## NAME



           strpbrk - search a string for any of a set of bytes
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **char *strpbrk(const char ***_s_**, const char ***_accept_**);**
    


## DESCRIPTION



           The **strpbrk**() function locates the first occurrence in the string
           _s_ of any of the bytes in the string _accept_.
    


## RETURN VALUE



           The **strpbrk**() function returns a pointer to the byte in _s_ that
           matches one of the bytes in _accept_ , or NULL if no such byte is
           found.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::fullpath_struct_file

## NAME



           function::fullpath_struct_file - get the full path
    


## SYNOPSIS



               fullpath_struct_file:string(task:long,file:long)
    


## ARGUMENTS



           _task_
               task_struct pointer.
    
           _file_
               Pointer to “struct file”.
    


## DESCRIPTION



           Returns the full dirent name (full path to the root), like the
           kernel d_path function.
    


* * *
# probe::signal.syskill

## NAME



           probe::signal.syskill - Sending kill signal to a process
    


## SYNOPSIS



           signal.syskill
    


## VALUES



           _sig_pid_
               The PID of the process receiving the signal
    
           _sig_name_
               A string representation of the signal
    
           _name_
               Name of the probe point
    
           _sig_
               The specific signal sent to the process
    
           _task_
               A task handle to the signal recipient
    
           _pid_name_
               The name of the signal recipient
    


* * *
# feupdateenv

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



           feupdateenv — update floating-point environment
    


## SYNOPSIS



           #include <fenv.h>
    
           int feupdateenv(const fenv_t *_envp_);
    


## 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 _feupdateenv_() function shall attempt to save the currently
           raised floating-point exceptions in its automatic storage, attempt
           to install the floating-point environment represented by the
           object pointed to by _envp_ , and then attempt to raise the saved
           floating-point exceptions. The argument _envp_ shall point to an
           object set by a call to _feholdexcept_() or _fegetenv_(), or equal a
           floating-point environment macro.
    


## RETURN VALUE



           The _feupdateenv_() function shall return a zero value if and only
           if all the required actions were successfully carried out.
    


## ERRORS



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


## EXAMPLES



           The following example shows sample code to hide spurious underflow
           floating-point exceptions:
    
               #include <fenv.h>
               double f(double x)
               {
                   #pragma STDC FENV_ACCESS ON
                   double result;
                   fenv_t save_env;
                   feholdexcept(&save_env);
                   // compute result
                   if (/* test spurious underflow */)
                   feclearexcept(FE_UNDERFLOW);
                   feupdateenv(&save_env);
                   return result;
               }
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::networking

## NAME



           tapset::networking - systemtap networking tapset
    


## DESCRIPTION



            This family of probe points is used to probe the activities of
           the network device.
    
           **netdev.receive**
                  Data received from network device.
    
                   See probe::netdev.receive(3stap)
                   for details.
    
           **netdev.transmit**
                  Network device transmitting buffer
    
                   See probe::netdev.transmit(3stap)
                   for details.
    
           **netdev.change_mtu**
                  Called when the netdev MTU is changed
    
                   See probe::netdev.change_mtu(3stap)
                   for details.
    
           **netdev.open**
                  Called when the device is opened
    
                   See probe::netdev.open(3stap)
                   for details.
    
           **netdev.close**
                  Called when the device is closed
    
                   See probe::netdev.close(3stap)
                   for details.
    
           **netdev.hard_transmit**
                  Called when the devices is going to TX (hard)
    
                   See probe::netdev.hard_transmit(3stap)
                   for details.
    
           **netdev.rx**
                  Called when the device is going to receive a packet
    
                   See probe::netdev.rx(3stap)
                   for details.
    
           **netdev.change_rx_flag**
                  Called when the device RX flag will be changed
    
                   See probe::netdev.change_rx_flag(3stap)
                   for details.
    
           **netdev.set_promiscuity**
                  Called when the device enters/leaves promiscuity
    
                   See probe::netdev.set_promiscuity(3stap)
                   for details.
    
           **netdev.ioctl**
                  Called when the device suffers an IOCTL
    
                   See probe::netdev.ioctl(3stap)
                   for details.
    
           **netdev.register**
                  Called when the device is registered
    
                   See probe::netdev.register(3stap)
                   for details.
    
           **netdev.unregister**
                  Called when the device is being unregistered
    
                   See probe::netdev.unregister(3stap)
                   for details.
    
           **netdev.get_stats**
                  Called when someone asks the device statistics
    
                   See probe::netdev.get_stats(3stap)
                   for details.
    
           **netdev.change_mac**
                  Called when the netdev_name has the MAC changed
    
                   See probe::netdev.change_mac(3stap)
                   for details.
    


* * *
# clearenv

## NAME



           clearenv - clear the environment
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **int clearenv(void);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **clearenv**():
               /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
    


## DESCRIPTION



           The **clearenv**() function clears the environment of all name-value
           pairs and sets the value of the external variable _environ_ to NULL.
           After this call, new variables can be added to the environment
           using putenv(3) and setenv(3).
    


## RETURN VALUE



           The **clearenv**() function returns zero on success, and a nonzero
           value on failure.
    


## ATTRIBUTES



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


## STANDARDS



           **putenv**()
                  POSIX.1-2008.
    
           **clearenv**()
                  None.
    


## NOTES



           On systems where **clearenv**() is unavailable, the assignment
    
               environ = NULL;
    
           will probably do.
    
           The **clearenv**() function may be useful in security-conscious
           applications that want to precisely control the environment that
           is passed to programs executed using exec(3).  The application
           would do this by first clearing the environment and then adding
           select environment variables.
    
           Note that the main effect of **clearenv**() is to adjust the value of
           the pointer environ(7); this function does not erase the contents
           of the buffers containing the environment definitions.
    
           The DG/UX and Tru64 man pages write: If _environ_ has been modified
           by anything other than the putenv(3), getenv(3), or **clearenv**()
           functions, then **clearenv**() will return an error and the process
           environment will remain unchanged.
    


* * *
# function::nfsderror

## NAME



           function::nfsderror - Convert nfsd error number into string
    


## SYNOPSIS



               nfsderror:string(err:long)
    


## ARGUMENTS



           _err_
               errnum
    


## DESCRIPTION



           This function returns a string for the error number passed into
           the function.
    


* * *
# form_field

## NAME



           **form_field** - make and break connections between fields and forms
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_form_fields(FORM ***_form_**, FIELD ****_fields_**);**
           **FIELD **form_fields(const FORM ***_form_**);**
           **int field_count(const FORM ***_form_**);**
           **int move_field(FIELD ***_field_**, int** _frow_**, int** _fcol_**);**
    


## DESCRIPTION



           The function **set_form_fields** changes the field pointer array of
           the given _form_.  The array must be terminated by a **NULL**.
    
           The function **form_fields** returns the field array of the given
           form.
    
           The function **field_count** returns the count of fields in _form_.
    
           The function **move_field** moves the given field (which must be
           disconnected) to a specified location on the screen.
    


## RETURN VALUE



           The function **form_fields** returns a pointer (which may be **NULL**).
           It does not set **errno**.
    
           The function **field_count** returns **ERR** if the _form_ parameter is
           **NULL**.
    
           The functions **set_form_fields** and **move_field** return one of the
           following codes on error:
    
           **E_OK** The routine succeeded.
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_CONNECTED**
                The field is already connected to a form.
    
           **E_POSTED**
                The form is already posted.
    
           **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.
    
           The SVr4 forms library documentation specifies the **field_count**
           error value as -1 (which is the value of **ERR**).
    


* * *
# gnutls_psk_allocate_server_credentials

## NAME



           gnutls_psk_allocate_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_allocate_server_credentials(gnutls_psk_server_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t * sc
                       is a pointer to a **gnutls_psk_server_credentials_t**
                       type.
    


## DESCRIPTION



           Allocate a gnutls_psk_server_credentials_t structure.
    


## RETURNS



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


* * *
# io_uring_register_ring_fd

## NAME



           io_uring_register_ring_fd - register a ring file descriptor
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **int io_uring_register_ring_fd(struct io_uring ***_ring_**);**
    


## DESCRIPTION



           io_uring_register_ring_fd(3) registers the file descriptor of the
           ring.
    
           Whenever io_uring_enter(2) is called to submit request or wait for
           completions, the kernel must grab a reference to the file
           descriptor. If the application using io_uring is threaded, the
           file table is marked as shared, and the reference grab and put of
           the file descriptor count is more expensive than it is for a non-
           threaded application.
    
           Similarly to how io_uring allows registration of files, this allow
           registration of the ring file descriptor itself. This reduces the
           overhead of the io_uring_enter(2) system call.
    
           If an application using liburing is threaded, then an application
           should call this function to register the ring descriptor when a
           ring is set up. See NOTES for restrictions when a ring is shared.
    
           Available since kernel 5.18.
    


## NOTES



           When the ring descriptor is registered, it is stored internally in
           the _struct io_uring_ structure. For applications that share a ring
           between threads, for example having one thread do submits and
           another reap events, then this optimization cannot be used as each
           thread may have a different index for the registered ring fd.
    


## RETURN VALUE



           Returns 1 on success, indicating that one file descriptor was
           registered, or **-errno** on error.
    


* * *
# pmdapmid

## NAME



           **pmdaPMID** - translate a dynamic performance metric name into a PMID
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
           **#include <pcp/pmda.h>**
    
           **int pmdaPMID(char ***_name_**, pmID ***_pmid_**, pmdaExt ***_pmda_**);**
    
           **cc ... -lpcp_pmda -lpcp**
    


## DESCRIPTION



           As  part  of  the Performance Metrics Domain Agent (PMDA) API (see
           PMDA(3)), **pmdaPMID** is the generic callback for translating  a  dy‐
           namic metric _name_ into a PMID (_pmid_).
    
           Because implementing dynamic performance metrics requires specific
           PMDA  support, and the facility is an optional component of a PMDA
           (most PMDAs do **not** support dynamic performance metrics),  **pmdaPMID**
           is a skeleton implementation that returns **PM_ERR_NAME**.
    
           A  PMDA  that  supports dynamic performance metrics will provide a
           private callback that replaces **pmdaPMID**(by  assignment  to  _ver‐_
           _sion.four.pmid_  of the _pmdaInterface_ structure) and implements the
           translation from a dynamic performance metric _name_ into the  asso‐
           ciated _pmid_.
    


## CAVEAT



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


## DIAGNOSTICS



           **pmdaPMID** returns **PM_ERR_NAME** if the name is not recognized or can‐
           not be translated, else returns 0.
    


* * *
# gnutls_x509_crq_get_basic_constraints

## NAME



           gnutls_x509_crq_get_basic_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_basic_constraints(gnutls_x509_crq_t** _crq_**,**
           **unsigned int ***_critical_**, unsigned int ***_ca_**, int ***_pathlen_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned int * critical
                       will be non-zero if the extension is marked as
                       critical
    
           unsigned int * ca
                       pointer to output integer indicating CA status, may be
                       NULL, value is 1 if the certificate CA flag is set, 0
                       otherwise.
    
           int * pathlen
                       pointer to output integer indicating path length (may
                       be NULL), non-negative error codes indicate a present
                       pathLenConstraint field and the actual value, -1
                       indicate that the field is absent.
    


## DESCRIPTION



           This function will read the certificate's basic constraints, and
           return the certificates CA status.  It reads the basicConstraints
           X.509 extension (2.5.29.19).
    


## RETURNS



           If the certificate is a CA a positive value will be returned, or
           (0) if the certificate does not have CA flag set.  A negative
           error code may be returned in case of errors.  If the certificate
           does not contain the basicConstraints extension
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           2.8.0
    


* * *
# gnutls_x509_trust_list_remove_cas

## NAME



           gnutls_x509_trust_list_remove_cas - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_trust_list_remove_cas(gnutls_x509_trust_list_t**
           _list_**, const gnutls_x509_crt_t ***_clist_**, unsigned** _clist_size_**);**
    


## ARGUMENTS



           gnutls_x509_trust_list_t list
                       The list
    
           const gnutls_x509_crt_t * clist
                       A list of CAs
    
           unsigned clist_size
                       The length of the CA list
    


## DESCRIPTION



           This function will remove the given certificate authorities from
           the trusted list.
    
           Note that this function can accept certificates and authorities
           not yet known. In that case they will be kept in a separate block
           list that will be used during certificate verification.  Unlike
           **gnutls_x509_trust_list_add_cas()** there is no deinitialization
           restriction for  certificate list provided in this function.
    


## RETURNS



           The number of removed elements is returned.
    


## SINCE



           3.1.10
    


* * *
# gnutls_handshake_set_max_packet_length

## NAME



           gnutls_handshake_set_max_packet_length - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_handshake_set_max_packet_length(gnutls_session_t**
           _session_**, size_t** _max_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t max  is the maximum number.
    


## DESCRIPTION



           This function will set the maximum size of all handshake messages.
           Handshakes over this size are rejected with
           **GNUTLS_E_HANDSHAKE_TOO_LARGE** error code.  The default value is
           128kb which is typically large enough.  Set this to 0 if you do
           not want to set an upper limit.
    
           The reason for restricting the handshake message sizes are to
           limit Denial of Service attacks.
    
           Note that the maximum handshake size was increased to 128kb from
           48kb in GnuTLS 3.5.5.
    


* * *
# rdma_reg_write

## NAME



           rdma_reg_write - register data buffer(s) for remote RDMA write
           access.
    


## SYNOPSIS



           **#include <rdma/rdma_verbs.h>**
    
           **struct ibv_mr * rdma_reg_write (struct rdma_cm_id ***_id_**, void ***_addr_**,**
           **size_t** _length_**);**
    


## ARGUMENTS



           id          A reference to a communication identifier where the
                       message buffer(s) will be used.
    
           addr        The address of the memory buffer(s) to register.
    
           length      The total length of the memory to register.
    


## DESCRIPTION



           Registers a memory buffer that will be accessed by a remote RDMA
           write operation.  Memory buffers registered using rdma_reg_write
           may be targeted in an RDMA write request, allowing the buffer to
           be specified on the remote side of an RDMA connection as the
           remote_addr of rdma_post_write, or similar call.
    


## RETURN VALUE



           Returns a reference to the registered memory region on success, or
           NULL on error.  If an error occurs, errno will be set to indicate
           the failure reason.
    


## NOTES



           rdma_reg_write is used to register a data buffer that will be the
           target of an RDMA write operation on a queue pair associated with
           an rdma_cm_id.  The memory buffer is registered with the
           proteection domain associated with the idenfier.  The start of the
           data buffer is specified through the addr parameter, and the total
           size of the buffer is given by length.
    
           All data buffers should be registered before being posted as a
           work request.  Users must deregister all registered memory by
           calling rdma_dereg_mr.
    


* * *
# pcap_set_buffer_size

## NAME



           pcap_set_buffer_size - set the buffer size for a not-yet-activated
           capture handle
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_set_buffer_size(pcap_t *p, int buffer_size);**
    


## DESCRIPTION



           **pcap_set_buffer_size**() sets the buffer size that will be used on a
           capture handle when the handle is activated to _buffer_size_ , which
           is in units of bytes.
    


## RETURN VALUE



           **pcap_set_buffer_size**() returns **0** on success or
           **PCAP_ERROR_ACTIVATED** if called on a capture handle that has been
           activated.
    


* * *
# gnutls_privkey_import_tpm_raw

## NAME



           gnutls_privkey_import_tpm_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_import_tpm_raw(gnutls_privkey_t** _pkey_**, const**
           **gnutls_datum_t ***_fdata_**, gnutls_tpmkey_fmt_t** _format_**, const char ***
           _srk_password_**, const char ***_key_password_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t pkey
                       The private key
    
           const gnutls_datum_t * fdata
                       The TPM key to be imported
    
           gnutls_tpmkey_fmt_t format
                       The format of the private key
    
           const char * srk_password
                       The password for the SRK key (optional)
    
           const char * key_password
                       A password for the key (optional)
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will import the given private key to the abstract
           **gnutls_privkey_t** type.
    
           With respect to passwords the same as in
           **gnutls_privkey_import_tpm_url()** apply.
    


## RETURNS



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


## SINCE



           3.1.0
    


* * *
# gnutls_pcert_deinit

## NAME



           gnutls_pcert_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **void gnutls_pcert_deinit(gnutls_pcert_st ***_pcert_**);**
    


## ARGUMENTS



           gnutls_pcert_st * pcert
                       The structure to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a pcert structure.
    


## SINCE



           3.0
    


* * *