tripathysagar/man_text huggingface dataset:
# io_uring_recvmsg_payload_length

## NAME



           io_uring_recvmsg_out - access data from multishot recvmsg
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **struct io_uring_recvmsg_out *io_uring_recvmsg_validate(void ***_buf_**,**
                                                                  **int** _buf_len_**,**
                                                                  **struct msghdr ***_msgh_**);**
    
           **void *io_uring_recvmsg_name(struct io_uring_recvmsg_out ***_o_**);**
    
           **struct cmsghdr *io_uring_recvmsg_cmsg_firsthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                          **struct msghdr ***_msgh_**);**
           **struct cmsghdr *io_uring_recvmsg_cmsg_nexthdr(struct io_uring_recvmsg_out ***_o_**,**
                                                         **struct msghdr ***_msgh_**,**
                                                         **struct cmsghdr ***_cmsg_**);**
    
           **void *io_uring_recvmsg_payload(struct io_uring_recvmsg_out ***_o_**,**
                                          **struct msghdr ***_msgh_**);**
           **unsigned int io_uring_recvmsg_payload_length(struct io_uring_recvmsg_out ***_o_**,**
                                                        **int** _buf_len_**,**
                                                        **struct msghdr ***_msgh_**);**
    


## DESCRIPTION



           These functions are used to access data in the payload delivered
           by io_uring_prep_recvmsg_multishot(3).
    
           _msgh_ should point to the _struct msghdr_ submitted with the request.
    
           io_uring_recvmsg_validate(3) will validate a buffer delivered by
           io_uring_prep_recvmsg_multishot(3) and extract the
           _io_uring_recvmsg_out_ if it is valid, returning a pointer to it or
           else NULL.
    
           The structure is defined as follows:
    
               struct io_uring_recvmsg_out {
                       __u32 namelen;    /* Name byte count as would have been populated
                                          * by recvmsg(2) */
                       __u32 controllen; /* Control byte count */
                       __u32 payloadlen; /* Payload byte count as would have been returned
                                          * by recvmsg(2) */
                       __u32 flags;      /* Flags result as would have been populated
                                          * by recvmsg(2) */
               };
    
           *  io_uring_recvmsg_name(3)
              returns a pointer to the name in the buffer.
    
           *  io_uring_recvmsg_cmsg_firsthdr(3)
              returns a pointer to the first cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_cmsg_nexthdr(3)
              returns a pointer to the next cmsg in the buffer, or NULL.
    
           *  io_uring_recvmsg_payload(3)
              returns a pointer to the payload in the buffer.
    
           *  io_uring_recvmsg_payload_length(3)
              Calculates the usable payload length in bytes.
    


* * *
# gnutls_ocsp_req_add_cert_id

## NAME



           gnutls_ocsp_req_add_cert_id - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_req_add_cert_id(gnutls_ocsp_req_t** _req_**,**
           **gnutls_digest_algorithm_t** _digest_**, const gnutls_datum_t ***
           _issuer_name_hash_**, const gnutls_datum_t ***_issuer_key_hash_**, const**
           **gnutls_datum_t ***_serial_number_**);**
    


## ARGUMENTS



           gnutls_ocsp_req_t req
                       should contain a **gnutls_ocsp_req_t** type
    
           gnutls_digest_algorithm_t digest
                       hash algorithm, a **gnutls_digest_algorithm_t** value
    
           const gnutls_datum_t * issuer_name_hash
                       hash of issuer's DN
    
           const gnutls_datum_t * issuer_key_hash
                       hash of issuer's public key
    
           const gnutls_datum_t * serial_number
                       serial number of certificate to check
    


## DESCRIPTION



           This function will add another request to the OCSP request for a
           particular certificate having the issuer name hash of
            _issuer_name_hash_ and issuer key hash of  _issuer_key_hash_ (both
           hashed using  _digest_ ) and serial number  _serial_number_ .
    
           The information needed corresponds to the CertID structure:
    
           <informalexample><programlisting> CertID      ::=     SEQUENCE {
           hashAlgorithm       AlgorithmIdentifier, issuerNameHash      OCTET
           STRING, -- Hash of Issuer's DN issuerKeyHash       OCTET STRING,
           -- Hash of Issuers public key
           serialNumber   CertificateSerialNumber }
           </programlisting></informalexample>
    


## RETURNS



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


* * *
# gnutls_oid_to_ecc_curve

## NAME



           gnutls_oid_to_ecc_curve - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **gnutls_ecc_curve_t gnutls_oid_to_ecc_curve(const char ***_oid_**);**
    


## ARGUMENTS



           const char * oid
                       is a curve's OID
    


## RETURNS



           return a **gnutls_ecc_curve_t** value corresponding to the specified
           OID, or **GNUTLS_ECC_CURVE_INVALID** on error.
    


## SINCE



           3.4.3
    


* * *
# mitem_visible

## NAME



           **mitem_visible** - check visibility of a menu item
    


## SYNOPSIS



           **#include <menu.h>**
    
           **bool item_visible(const ITEM ***_item_**);**
    


## DESCRIPTION



           A menu item is visible when it is in the portion of a posted menu
           that is mapped onto the screen (if the menu is scrollable, in
           particular, this portion will be smaller than the whole menu).
    


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


* * *
# posix_trace_attr_init

## PROLOG



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


## NAME



           posix_trace_attr_init — initialize the trace stream attributes
           object (**TRACING**)
    


## SYNOPSIS



           #include <trace.h>
    
           int posix_trace_attr_init(trace_attr_t *_attr_);
    


## DESCRIPTION



           Refer to posix_trace_attr_destroy(3p).
    


* * *
# ibv_req_notify_cq

## NAME



           ibv_req_notify_cq - request completion notification on a
           completion queue (CQ)
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_req_notify_cq(struct ibv_cq *cq, int solicited_only);
    


## DESCRIPTION



           **ibv_req_notify_cq()** requests a completion notification on the
           completion queue (CQ) _cq_.
    
           Upon the addition of a new CQ entry (CQE) to _cq_ , a completion
           event will be added to the completion channel associated with the
           CQ.  If the argument _solicited_only_ is zero, a completion event is
           generated for any new CQE.  If _solicited_only_ is non-zero, an
           event is only generated for a new CQE with that is considered
           “solicited.” A CQE is solicited if it is a receive completion for
           a message with the Solicited Event header bit set, or if the
           status is not successful.  All other successful receive
           completions, or any successful send completion is unsolicited.
    


## RETURN VALUE



           **ibv_req_notify_cq()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           The request for notification is “one shot.” Only one completion
           event will be generated for each call to **ibv_req_notify_cq()**.
    


* * *
# probe::nfs.proc.create

## NAME



           probe::nfs.proc.create - NFS client creating file on server
    


## SYNOPSIS



           nfs.proc.create
    


## VALUES



           _prot_
               transfer protocol
    
           _filelen_
               length of file name
    
           _version_
               NFS version (the function is used for all NFS version)
    
           _server_ip_
               IP address of server
    
           _filename_
               file name
    
           _flag_
               indicates create mode (only for NFSv3 and NFSv4)
    
           _fh_
               file handle of parent dir
    


* * *
# umad_get_pkey

## NAME



           umad_get_pkey - get pkey index from umad buffer
    


## SYNOPSIS



           **#include <infiniband/umad.h>**
    
           **int umad_get_pkey(void** _*umad_**);**
    


## DESCRIPTION



           **umad_get_pkey()** gets the pkey index from the specified _umad_
           buffer.
    


## RETURN VALUE



           **umad_get_pkey()** returns value of pkey index (or zero if pkey index
           is not supported by user_mad interface).
    


* * *
# function::task_egid

## NAME



           function::task_egid - The effective group identifier of the task
    


## SYNOPSIS



               task_egid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



           This function returns the effective group id of the given task.
    


* * *
# probe::ioblock_trace.bounce

## NAME



           probe::ioblock_trace.bounce - Fires whenever a buffer bounce is
           needed for at least one page of a block IO request.
    


## SYNOPSIS



           ioblock_trace.bounce
    


## VALUES



           _name_
               name of the probe point
    
           _rw_
               binary trace for read/write request
    
           _idx_
               offset into the bio vector array _phys_segments_ - number of
               segments in this bio after physical address coalescing is
               performed.
    
           _opf_
               operations and flags
    
           _vcnt_
               bio vector count which represents number of array element
               (page, offset, length) which makes up this I/O request
    
           _bdev_contains_
               points to the device object which contains the partition (when
               bio structure represents a partition)
    
           _sector_
               beginning sector for the entire bio
    
           _flags_
               see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK
               1 RW_AHEAD set, and read/write would block BIO_EOF 2
               out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid
               BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce
               bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not
               supported
    
           _bdev_
               target block device
    
           _ino_
               i-node number of the mapped file
    
           _p_start_sect_
               points to the start sector of the partition structure of the
               device
    
           _q_
               request queue on which this bio was queued.
    
           _bytes_done_
               number of bytes transferred
    
           _devname_
               device for which a buffer bounce was needed.
    
           _size_
               total size in bytes
    


## CONTEXT



           The process creating a block IO request.
    


* * *
# vscanf

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



           vscanf — format input of a stdarg argument list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
    
           int vscanf(const char *restrict _format_ , va_list _arg_);
    


## DESCRIPTION



           Refer to vfscanf(3p).
    


* * *
# mlx5dv_pp_alloc

## NAME



           mlx5dv_pp_alloc - Allocates a packet pacing entry
    
           mlx5dv_pp_free - Frees a packet pacing entry
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_pp *
                  mlx5dv_pp_alloc(struct ibv_context *context,
                          size_t pp_context_sz,
                          const void *pp_context,
                          uint32_t flags);
    
                  void mlx5dv_pp_free(struct mlx5dv_pp *dv_pp);
    


## DESCRIPTION



           Create / free a packet pacing entry which can be used for some
           device commands over the DEVX interface.
    
           The DEVX API enables direct access from the user space area to the
           mlx5 device driver, the packet pacing information is needed for
           few commands where a packet pacing index is needed.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on, need to be opened with DEVX
                  support by using mlx5dv_open_device().
    
           _pp_context_sz_
                  Length of _pp_context_ input buffer.
    
           _pp_context_
                  Packet pacing context according to the device
                  specification.
    
           _flags_  MLX5DV_PP_ALLOC_FLAGS_DEDICATED_INDEX: allocate a dedicated
                  index.
    
       **dv_pp**
                  struct mlx5dv_pp {
                      uint16_t index;
                  };
    
           _index_  The device index to be used.
    


## RETURN VALUE



           Upon success _mlx5dv_pp_alloc_ returns a pointer to the created
           packet pacing object, on error NULL will be returned and errno
           will be set.
    


* * *
# gnutls_x509_crt_get_pk_ecc_raw

## NAME



           gnutls_x509_crt_get_pk_ecc_raw - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_get_pk_ecc_raw(gnutls_x509_crt_t** _crt_**,**
           **gnutls_ecc_curve_t ***_curve_**, gnutls_datum_t ***_x_**, gnutls_datum_t ***
           _y_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       Holds the certificate
    
           gnutls_ecc_curve_t * curve
                       will hold the curve
    
           gnutls_datum_t * x
                       will hold the x-coordinate
    
           gnutls_datum_t * y
                       will hold the y-coordinate
    


## DESCRIPTION



           This function will export the ECC public key's parameters found in
           the given certificate.  The new parameters will be allocated using
           **gnutls_malloc()** and will be stored in the appropriate datum.
    
           In EdDSA curves the  _y_ parameter will be **NULL** and the other
           parameters will be in the native format for the curve.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, otherwise a negative error code.
    


## SINCE



           3.4.1
    


* * *
# tcsetpgrp

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



           tcsetpgrp — set the foreground process group ID
    


## SYNOPSIS



           #include <unistd.h>
    
           int tcsetpgrp(int _fildes_ , pid_t _pgid_id_);
    


## DESCRIPTION



           If the process has a controlling terminal, _tcsetpgrp_() shall set
           the foreground process group ID associated with the terminal to
           _pgid_id_.  The application shall ensure that the file associated
           with _fildes_ is the controlling terminal of the calling process and
           the controlling terminal is currently associated with the session
           of the calling process. The application shall ensure that the
           value of _pgid_id_ matches a process group ID of a process in the
           same session as the calling process.
    
           Attempts to use _tcsetpgrp_() from a process which is a member of a
           background process group on a _fildes_ associated with its
           controlling terminal shall cause the process group to be sent a
           SIGTTOU signal. If the calling thread is blocking SIGTTOU signals
           or the process is ignoring SIGTTOU signals, the process shall be
           allowed to perform the operation, and no signal is sent.
    


## RETURN VALUE



           Upon successful completion, 0 shall be returned. Otherwise, -1
           shall be returned and _errno_ set to indicate the error.
    


## ERRORS



           The _tcsetpgrp_() function shall fail if:
    
           **EBADF** The _fildes_ argument is not a valid file descriptor.
    
           **EINVAL** This implementation does not support the value in the
                  _pgid_id_ argument.
    
           **EIO** The process group of the writing process is orphaned, the
                  calling thread is not blocking SIGTTOU, and the process is
                  not ignoring SIGTTOU.
    
           **ENOTTY** The calling process does not have a controlling terminal,
                  or the file is not the controlling terminal, or the
                  controlling terminal is no longer associated with the
                  session of the calling process.
    
           **EPERM** The value of _pgid_id_ is a value supported by the
                  implementation, but does not match the process group ID of
                  a process in the same session as the calling process.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_x509_crq_get_extension_data2

## NAME



           gnutls_x509_crq_get_extension_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_extension_data2(gnutls_x509_crq_t** _crq_**,**
           **unsigned** _indx_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned indx
                       Specifies which extension OID to read. Use (0) to get
                       the first one.
    
           gnutls_datum_t * data
                       will contain the extension DER-encoded data
    


## DESCRIPTION



           This function will return the requested extension data in the
           certificate request.  The extension data will be allocated using
           **gnutls_malloc()**.
    
           Use **gnutls_x509_crq_get_extension_info()** to extract the OID.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error code is returned.  If you have reached the last extension
           available **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.3.0
    


* * *
# libpfm_intel_hswep_unc_imc

## NAME



           libpfm_intel_hswep_unc_imc - support for Intel Haswell-EP
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_imc[0-7]**
           **PMU desc: Intel Haswell-EP IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell Integrated Memory
           Controller (IMC) uncore PMU.  This PMU model only exists on
           Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Intel Haswell C-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 IMC 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].  **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
    


* * *
# function::inode_name

## NAME



           function::inode_name - get the inode name
    


## SYNOPSIS



               inode_name:string(inode:long)
    


## ARGUMENTS



           _inode_
               Pointer to inode.
    


## DESCRIPTION



           Returns the first path basename associated with the given inode.
    


* * *
# pcre2_get_ovector_count

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **uint32_t pcre2_get_ovector_count(pcre2_match_data ***_match_data_**);**
    


## DESCRIPTION



    
           This function returns the number of pairs of offsets in the
           ovector that forms part of the given match data block.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_x509_trust_list_add_cas

## NAME



           gnutls_x509_trust_list_add_cas - API function
    


## SYNOPSIS



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


## 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
    
           unsigned int flags
                       flags from **gnutls_trust_list_flags_t**
    


## DESCRIPTION



           This function will add the given certificate authorities to the
           trusted list. The CAs in  _clist_ must not be deinitialized during
           the lifetime of  _list_ .
    
           If the flag **GNUTLS_TL_NO_DUPLICATES** is specified, then this
           function will ensure that no duplicates will be present in the
           final trust list.
    
           If the flag **GNUTLS_TL_NO_DUPLICATE_KEY** is specified, then this
           function will ensure that no certificates with the same key are
           present in the final trust list.
    
           If either **GNUTLS_TL_NO_DUPLICATE_KEY** or **GNUTLS_TL_NO_DUPLICATES**
           are given, **gnutls_x509_trust_list_deinit()** must be called with
           parameter
            _all_ being 1.
    


## RETURNS



           The number of added elements is returned; that includes duplicate
           entries.
    


## SINCE



           3.0.0
    


* * *
# wcslen

## NAME



           wcslen - determine the length of a wide-character string
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wchar.h>**
    
           **size_t wcslen(const wchar_t ***_s_**);**
    


## DESCRIPTION



           The **wcslen**() function is the wide-character equivalent of the
           strlen(3) function.  It determines the length of the wide-
           character string pointed to by _s_ , excluding the terminating null
           wide character (L'\0').
    


## RETURN VALUE



           The **wcslen**() function returns the number of wide characters in _s_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           In cases where the input buffer may not contain a terminating null
           wide character, wcsnlen(3) should be used instead.
    


* * *
# setutxent

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



           setutxent — reset the user accounting database to the first entry
    


## SYNOPSIS



           #include <utmpx.h>
    
           void setutxent(void);
    


## DESCRIPTION



           Refer to endutxent(3p).
    


* * *
# atol

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



           atol, atoll — convert a string to a long integer
    


## SYNOPSIS



           #include <stdlib.h>
    
           long atol(const char *_nptr_);
           long long atoll(const char *_nptr_);
    


## 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.
    
           Except as noted below, the call _atol_(_nptr_) shall be equivalent to:
    
               strtol(nptr, (char **)NULL, 10)
    
           Except as noted below, the call to _atoll_(_nptr_) shall be equivalent
           to:
    
               strtoll(nptr, (char **)NULL, 10)
    
           The handling of errors may differ. If the value cannot be
           represented, the behavior is undefined.
    


## RETURN VALUE



           These functions shall return the converted value if the value can
           be represented.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           If the number is not known to be in range, _strtol_() or _strtoll_()
           should be used because _atol_() and _atoll_() are not required to
           perform any error checking.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_record_set_max_early_data_size

## NAME



           gnutls_record_set_max_early_data_size - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_record_set_max_early_data_size(gnutls_session_t**
           _session_**, size_t** _size_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           size_t size is the new size
    


## DESCRIPTION



           This function sets the maximum early data size in this connection.
           This property can only be set to servers.  The client may be
           provided with the maximum allowed size through the "early_data"
           extension of the NewSessionTicket handshake message.
    


## RETURNS



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


## SINCE



           3.6.4
    


* * *
# gnutls_x509_crq_set_extension_by_oid

## NAME



           gnutls_x509_crq_set_extension_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_extension_by_oid(gnutls_x509_crq_t** _crq_**,**
           **const char ***_oid_**, const void ***_buf_**, size_t** _sizeof_buf_**, unsigned**
           **int** _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate of type **gnutls_x509_crq_t**
    
           const char * oid
                       holds an Object Identifier in null terminated string
    
           const void * buf
                       a pointer to a DER encoded data
    
           size_t sizeof_buf
                       holds the size of  _buf_
    
           unsigned int critical
                       should be non-zero if the extension is to be marked as
                       critical
    


## DESCRIPTION



           This function will set an the extension, by the specified OID, in
           the certificate request.  The extension data should be binary data
           DER encoded.
    


## RETURNS



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


* * *
# gnutls_x509_crt_privkey_sign

## NAME



           gnutls_x509_crt_privkey_sign - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_x509_crt_privkey_sign(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_crt_t** _issuer_**, gnutls_privkey_t** _issuer_key_**,**
           **gnutls_digest_algorithm_t** _dig_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_crt_t issuer
                       is the certificate of the certificate issuer
    
           gnutls_privkey_t issuer_key
                       holds the issuer's private key
    
           gnutls_digest_algorithm_t dig
                       The message digest to use, **GNUTLS_DIG_SHA256** is a safe
                       choice
    
           unsigned int flags
                       must be 0
    


## DESCRIPTION



           This function will sign the certificate with the issuer's private
           key, and will copy the issuer's information into the certificate.
    
           This must be the last step in a certificate generation since all
           the previously set parameters are now signed.
    
           A known limitation of this function is, that a newly-signed
           certificate will not be fully functional (e.g., for signature
           verification), until it is exported an re-imported.
    
           After GnuTLS 3.6.1 the value of  _dig_ may be **GNUTLS_DIG_UNKNOWN** ,
           and in that case, a suitable but reasonable for the key algorithm
           will be selected.
    


## RETURNS



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


* * *
# gnutls_pkcs11_get_pin_function

## NAME



           gnutls_pkcs11_get_pin_function - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **gnutls_pin_callback_t gnutls_pkcs11_get_pin_function(void ****
           _userdata_**);**
    


## ARGUMENTS



           void ** userdata
                       data to be supplied to callback
    


## DESCRIPTION



           This function will return the callback function set using
           **gnutls_pkcs11_set_pin_function()**.
    


## RETURNS



           The function set or NULL otherwise.
    


## SINCE



           3.1.0
    


* * *
# epoll_event

## NAME



           epoll_event, epoll_data, epoll_data_t - epoll event
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/epoll.h>**
    
           **struct epoll_event {**
               **uint32_t      events;** /* Epoll events */
               **epoll_data_t  data;** /* User data variable */
           **};**
    
           **union epoll_data {**
               **void     *ptr;**
               **int       fd;**
               **uint32_t  u32;**
               **uint64_t  u64;**
           **};**
    
           **typedef union epoll_data  epoll_data_t;**
    


## DESCRIPTION



           The _epoll_event_ structure specifies data that the kernel should
           save and return when the corresponding file descriptor becomes
           ready.
    


## VERSIONS



       **C library/kernel differences**
           The Linux kernel headers also provide this type, with a slightly
           different definition:
    
               #include <linux/eventpoll.h>
    
               struct epoll_event {
                   __poll_t  events;
                   __u64     data;
               };
    


## STANDARDS



           Linux.
    


* * *
# pcre2_next_match

## NAME



           PCRE2 - Perl-compatible regular expressions (revised API)
    


## SYNOPSIS



    
           **#include <pcre2.h>**
    
           **int pcre2_next_match(pcre2_match_data ***_match_data_**,**
             **PCRE2_SIZE ***_pstart_offset_**, uint32_t ***_poptions_**);**
    


## DESCRIPTION



    
           This function can be called after one of the match functions
           (**pcre2_match()** , **pcre2_dfa_match()** , or **pcre2_jit_match()**), and must
           be provided with the same _match_data_ parameter. It outputs the
           appropriate parameters for searching for the next match in the
           same subject string, and is suitable for applications providing
           "global" matching behaviour (for example, replacing all matches in
           the subject, or splitting the subject on all matches, or simply
           counting the number of matches).
    
           It returns 0 ("false") if there is no need to make any further
           match attempts, or 1 ("true") if another match should be
           attempted.
    
           The *_pstart_offset_ and *_poptions_ are set if the function returns
           1.  The *_pstart_offset_ should be passed to the next match attempt
           directly, and the *_poptions_ should be passed to the next match
           attempt by combining with the application's match options using
           OR.
    
           There is a complete description of the PCRE2 native API in the
           **pcre2api** page and a description of the POSIX API in the **pcre2posix**
           page.
    


* * *
# gnutls_pkcs7_get_embedded_data

## NAME



           gnutls_pkcs7_get_embedded_data - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_embedded_data(gnutls_pkcs7_t** _pkcs7_**, unsigned**
           _flags_**, gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       should contain a gnutls_pkcs7_t type
    
           unsigned flags
                       must be zero or **GNUTLS_PKCS7_EDATA_GET_RAW**
    
           gnutls_datum_t * data
                       will hold the embedded data in the provided structure
    


## DESCRIPTION



           This function will return the data embedded in the signature of
           the PKCS7 structure. If no data are available then
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    
           The returned data must be de-allocated using **gnutls_free()**.
    
           Note, that this function returns the exact same data that are
           authenticated. If the **GNUTLS_PKCS7_EDATA_GET_RAW** flag is provided,
           the returned data will be including the wrapping tag/value as they
           are encoded in the structure.
    


## RETURNS



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


## SINCE



           3.4.8
    


* * *
# sigismember

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



           sigismember — test for a signal in a signal set
    


## SYNOPSIS



           #include <signal.h>
    
           int sigismember(const sigset_t *_set_ , int _signo_);
    


## DESCRIPTION



           The _sigismember_() function shall test whether the signal specified
           by _signo_ is a member of the set pointed to by _set_.
    
           Applications should call either _sigemptyset_() or _sigfillset_() at
           least once for each object of type **sigset_t** prior to any other use
           of that object. If such an object is not initialized in this way,
           but is nonetheless supplied as an argument to any of
           _pthread_sigmask_(), _sigaction_(), _sigaddset_(), _sigdelset_(),
           _sigismember_(), _sigpending_(), _sigprocmask_(), _sigsuspend_(),
           _sigtimedwait_(), _sigwait_(), or _sigwaitinfo_(), the results are
           undefined.
    


## RETURN VALUE



           Upon successful completion, _sigismember_() shall return 1 if the
           specified signal is a member of the specified set, or 0 if it is
           not. Otherwise, it shall return -1 and set _errno_ to indicate the
           error.
    


## ERRORS



           The _sigismember_() function may fail if:
    
           **EINVAL** The _signo_ argument is not a valid signal number, or is an
                  unsupported signal number.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# setgid

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



           setgid — set-group-ID
    


## SYNOPSIS



           #include <unistd.h>
    
           int setgid(gid_t _gid_);
    


## DESCRIPTION



           If the process has appropriate privileges, _setgid_() shall set the
           real group ID, effective group ID, and the saved set-group-ID of
           the calling process to _gid_.
    
           If the process does not have appropriate privileges, but _gid_ is
           equal to the real group ID or the saved set-group-ID, _setgid_()
           shall set the effective group ID to _gid_ ; the real group ID and
           saved set-group-ID shall remain unchanged.
    
           The _setgid_() function shall not affect the supplementary group
           list in any way.
    
           Any supplementary group IDs of the calling process shall remain
           unchanged.
    


## RETURN VALUE



           Upon successful completion, 0 is returned. Otherwise, -1 shall be
           returned and _errno_ set to indicate the error.
    


## ERRORS



           The _setgid_() function shall fail if:
    
           **EINVAL** The value of the _gid_ argument is invalid and is not
                  supported by the implementation.
    
           **EPERM** The process does not have appropriate privileges and _gid_
                  does not match the real group ID or the saved set-group-ID.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to the RATIONALE section in setuid(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *
# function::switch_file

## NAME



           function::switch_file - switch to the next output file
    


## SYNOPSIS



               switch_file()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function sends a signal to the stapio process, commanding it
           to rotate to the next output file when output is sent to file(s).
    
           The mechanism of switching files was changed by upstream commit
           5b39471380a238469c8fc18136f12600e5e9aec7 . With this commit, the
           rotation only works if there is some actual systemtap output.
    


* * *
# ulimit

## NAME



           ulimit - get and set user limits
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <ulimit.h>**
    
           **[[deprecated]] long ulimit(int** _cmd_**, long** _newlimit_**);**
    


## DESCRIPTION



           Warning: this routine is obsolete.  Use getrlimit(2),
           setrlimit(2), and sysconf(3) instead.  For the shell command
           **ulimit** , see bash(1).
    
           The **ulimit**() call will get or set some limit for the calling
           process.  The _cmd_ argument can have one of the following values.
    
           **UL_GETFSIZE**
                  Return the limit on the size of a file, in units of 512
                  bytes.
    
           **UL_SETFSIZE**
                  Set the limit on the size of a file.
    
           **3**(Not implemented for Linux.)  Return the maximum possible
                  address of the data segment.
    
           **4**(Implemented but no symbolic constant provided.)  Return
                  the maximum number of files that the calling process can
                  open.
    


## RETURN VALUE



           On success, **ulimit**() returns a nonnegative value.  On error, -1 is
           returned, and _errno_ is set to indicate the error.
    


## ERRORS



           **EPERM** An unprivileged process tried to increase a limit.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


* * *
# probe::ioscheduler.elv_add_request

## NAME



           probe::ioscheduler.elv_add_request - probe to indicate request is
           added to the request queue.
    


## SYNOPSIS



           ioscheduler.elv_add_request
    


## VALUES



           _disk_major_
               Disk major no of request.
    
           _rq_flags_
               Request flags.
    
           _disk_minor_
               Disk minor number of request.
    
           _q_
               Pointer to request queue.
    
           _elevator_name_
               The type of I/O elevator currently enabled.
    
           _rq_
               Address of request.
    


* * *
# gnutls_session_set_verify_output_function

## NAME



           gnutls_session_set_verify_output_function - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **void gnutls_session_set_verify_output_function(gnutls_session_t**
           _session_**, gnutls_verify_output_function ***_func_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_x509_trust_list_t** type.
    
           gnutls_verify_output_function * func
                       is the callback function
    


## DESCRIPTION



           This function sets a callback to be called when the peer's
           certificate chain has to be verified and full path to the trusted
           root has to be printed.
    
           The callback's function prototype is defined in `x509.h': int
           (*callback)( gnutls_x509_crt_t cert, gnutls_x509_crt_t issuer,
           gnutls_x509_crl_t crl, unsigned int verification_output);
    
           If the callback function is provided then gnutls will call it, in
           the certificate verification procedure.  To verify the certificate
           chain and print its path uptp the trusted root, functions such as
           **gnutls_certificate_verify_peers()** ,
           **gnutls_x509_trust_list_verify_crt()** , and
           **gnutls_x509_trust_list_verify_crt2()** can be used. The callback is
           set in **_gnutls_verify_crt_status()** and
           **_gnutls_pkcs11_verify_crt_status()**.
    


## SINCE



           3.7.0
    


* * *
# initgroups

## NAME



           initgroups - initialize the supplementary group access list
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
           **#include <grp.h>**
    
           **int initgroups(const char ***_user_**, gid_t** _group_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **initgroups**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE
    


## DESCRIPTION



           The **initgroups**() function initializes the group access list by
           reading the group database _/etc/group_ and using all groups of
           which _user_ is a member.  The additional group _group_ is also added
           to the list.
    
           The _user_ argument must be non-NULL.
    


## RETURN VALUE



           The **initgroups**() function returns 0 on success.  On error, -1 is
           returned, and _errno_ is set to indicate the error.
    


## ERRORS



           **ENOMEM** Insufficient memory to allocate group information
                  structure.
    
           **EPERM** The calling process has insufficient privilege.  See the
                  underlying system call setgroups(2).
    


## FILES



           _/etc/group_
                  group database file
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *