tripathysagar/man_text huggingface dataset:
# gnutls_x509_crl_get_issuer_dn_by_oid

## NAME



           gnutls_x509_crl_get_issuer_dn_by_oid - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crl_get_issuer_dn_by_oid(gnutls_x509_crl_t** _crl_**,**
           **const char ***_oid_**, unsigned** _indx_**, unsigned int** _raw_flag_**, void ***
           _buf_**, size_t ***_sizeof_buf_**);**
    


## ARGUMENTS



           gnutls_x509_crl_t crl
                       should contain a gnutls_x509_crl_t type
    
           const char * oid
                       holds an Object Identified in null terminated string
    
           unsigned indx
                       In case multiple same OIDs exist in the RDN, this
                       specifies which to send. Use (0) to get the first one.
    
           unsigned int raw_flag
                       If non-zero returns the raw DER data of the DN part.
    
           void * buf  a pointer to a structure to hold the peer's name (may
                       be null)
    
           size_t * sizeof_buf
                       initially holds the size of  _buf_
    


## DESCRIPTION



           This function will extract the part of the name of the CRL issuer
           specified by the given OID. The output will be encoded as
           described in RFC4514. The output string will be ASCII or UTF-8
           encoded, depending on the certificate data.
    
           Some helper macros with popular OIDs can be found in gnutls/x509.h
           If raw flag is (0), this function will only return known OIDs as
           text. Other OIDs will be DER encoded, as described in RFC4514 --
           in hex format with a '#' prefix.  You can check about known OIDs
           using **gnutls_x509_dn_oid_known()**.
    
           If buf is null then only the size will be filled.
    


## RETURNS



           **GNUTLS_E_SHORT_MEMORY_BUFFER** if the provided buffer is not long
           enough, and in that case the sizeof_buf will be updated with the
           required size, and 0 on success.
    


* * *
# capng_update

## NAME



           capng_update - update the stored capabilities settings
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_update(capng_act_t action, capng_type_t type,unsigned
           int capability);
    


## DESCRIPTION



           capng_update will update the internal POSIX capabilities settings
           based on the options passed to it. The action should be either
           CAPNG_DROP to set the capability bit to 0, or CAPNG_ADD to set the
           capability bit to 1. The operation is performed on the capability
           set specified in the type parameter. The values are:
           CAPNG_EFFECTIVE, CAPNG_PERMITTED, CAPNG_INHERITABLE,
           CAPNG_BOUNDING_SET, or CAPNG_AMBIENT. The values may be or'ed
           together to perform the same operation on multiple sets. The last
           parameter, capability, is the capability define as given in
           linux/capability.h.
    


## RETURN VALUE



           This returns 0 on success and -1 on failure.
    


* * *
# libpfm_intel_hswep_unc_qpi

## NAME



           libpfm_intel_hswep_unc_qpi - support for Intel Haswell-EP QPI
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: hswep_unc_qpi0, hswep_unc_qpi1**
           **PMU desc: Intel Haswell-EP QPI uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Haswell Power QPI uncore PMU.  This
           PMU model only exists on Haswell model 63.
    


## MODIFIERS



           The following modifiers are supported on Haswell Bridge QPI 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 QPI 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
    


* * *
# gnutls_x509_ext_export_inhibit_anypolicy

## NAME



           gnutls_x509_ext_export_inhibit_anypolicy - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_inhibit_anypolicy(unsigned int**
           _skipcerts_**, gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           unsigned int skipcerts
                       number of certificates after which anypolicy is no
                       longer acceptable.
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the  _skipcerts_ value to a DER encoded
           Inhibit AnyPolicy PKIX extension. The  _ext_ data will be allocated
           using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# pcap_set_datalink

## NAME



           pcap_set_datalink - set the link-layer header type to be used by a
           capture device
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_set_datalink**() is used to set the current link-layer header
           type of the pcap descriptor to the type specified by _dlt_.
    


## RETURN VALUE



           **pcap_set_datalink**() returns **0** on success, **PCAP_ERROR_NOT_ACTIVATED**
           if called on a capture handle that has been created but not
           activated, or **PCAP_ERROR** on other errors. If **PCAP_ERROR** is
           returned, **pcap_geterr**(3PCAP) or **pcap_perror**(3PCAP) may be called
           with _p_ as an argument to fetch or display the error text.
    


* * *
# gnutls_pkcs7_export2

## NAME



           gnutls_pkcs7_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_export2(gnutls_pkcs7_t** _pkcs7_**,**
           **gnutls_x509_crt_fmt_t** _format_**, gnutls_datum_t ***_out_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           gnutls_x509_crt_fmt_t format
                       the format of output params. One of PEM or DER.
    
           gnutls_datum_t * out
                       will contain a structure PEM or DER encoded
    


## DESCRIPTION



           This function will export the pkcs7 structure to DER or PEM
           format.
    
           The output buffer is allocated using **gnutls_malloc()**.
    
           If the structure is PEM encoded, it will have a header of "BEGIN
           PKCS7".
    


## RETURNS



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


## SINCE



           3.1.3
    


* * *
# ccosh

## NAME



           ccosh, ccoshf, ccoshl - complex hyperbolic cosine
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double complex ccosh(double complex** _z_**);**
           **float complex ccoshf(float complex** _z_**);**
           **long double complex ccoshl(long double complex** _z_**);**
    


## DESCRIPTION



           These functions calculate the complex hyperbolic cosine of _z_.
    
           The complex hyperbolic cosine function is defined as:
    
               ccosh(z) = (exp(z)+exp(-z))/2
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# probe::netfilter.bridge.pre_routing

## NAME



           probe::netfilter.bridge.pre_routing - - Called before a bridging
           packet is routed
    


## SYNOPSIS



           netfilter.bridge.pre_routing
    


## VALUES



           _br_msg_
               Message age in 1/256 secs
    
           _indev_name_
               Name of network device packet was received on (if known)
    
           _br_type_
               BPDU type
    
           _br_poid_
               Port identifier
    
           _br_flags_
               BPDU flags
    
           _br_bid_
               Identity of bridge
    
           _pf_
               Protocol family -- always “bridge”
    
           _br_prid_
               Protocol identifier
    
           _llcpdu_
               Address of LLC Protocol Data Unit
    
           _nf_queue_
               Constant used to signify a 'queue' verdict
    
           _br_cost_
               Total cost from transmitting bridge to root
    
           _nf_stolen_
               Constant used to signify a 'stolen' verdict
    
           _outdev_name_
               Name of network device packet will be routed to (if known)
    
           _llcproto_stp_
               Constant used to signify Bridge Spanning Tree Protocol packet
    
           _protocol_
               Packet protocol
    
           _indev_
               Address of net_device representing input device, 0 if unknown
    
           _br_rid_
               Identity of root bridge
    
           _nf_repeat_
               Constant used to signify a 'repeat' verdict
    
           _data_str_
               A string representing the packet buffer contents
    
           _br_max_
               Max age in 1/256 secs
    
           _br_vid_
               Protocol version identifier
    
           _outdev_
               Address of net_device representing output device, 0 if unknown
    
           _nf_accept_
               Constant used to signify an 'accept' verdict
    
           _nf_stop_
               Constant used to signify a 'stop' verdict
    
           _data_hex_
               A hexadecimal string representing the packet buffer contents
    
           _br_htime_
               Hello time in 1/256 secs
    
           _brhdr_
               Address of bridge header
    
           _length_
               The length of the packet buffer contents, in bytes
    
           _nf_drop_
               Constant used to signify a 'drop' verdict
    
           _br_mac_
               Bridge MAC address
    
           _br_fd_
               Forward delay in 1/256 secs
    
           _br_rmac_
               Root bridge MAC address
    


* * *
# probe::scheduler.cpu_on

## NAME



           probe::scheduler.cpu_on - Process is beginning execution on a cpu
    


## SYNOPSIS



           scheduler.cpu_on
    


## VALUES



           _idle_
               - boolean indicating whether current is the idle process
    
           _name_
               name of the probe point
    
           _task_prev_
               the process that was previously running on this cpu
    


## CONTEXT



           The resuming process.
    


* * *
# pthread_attr_getstacksize

## PROLOG



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


## NAME



           pthread_attr_getstacksize, pthread_attr_setstacksize — get and set
           the stacksize attribute
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_attr_getstacksize(const pthread_attr_t *restrict _attr_ ,
               size_t *restrict _stacksize_);
           int pthread_attr_setstacksize(pthread_attr_t *_attr_ , size_t _stacksize_);
    


## DESCRIPTION



           The  _pthread_attr_getstacksize_()  and  _pthread_attr_setstacksize_()
           functions, respectively, shall get and  set  the  thread  creation
           _stacksize_ attribute in the _attr_ object.
    
           The  _stacksize_  attribute  shall define the minimum stack size (in
           bytes) allocated for the created threads stack.
    
           The behavior is undefined if  the  value  specified  by  the  _attr_
           argument         to         _pthread_attr_getstacksize_()         or
           _pthread_attr_setstacksize_()  does  not  refer  to  an  initialized
           thread attributes object.
    


## RETURN VALUE



           Upon   successful   completion,   _pthread_attr_getstacksize_()  and
           _pthread_attr_setstacksize_() shall return a value of 0;  otherwise,
           an error number shall be returned to indicate the error.
    
           The  _pthread_attr_getstacksize_()  function  stores  the  _stacksize_
           attribute value in _stacksize_ if successful.
    


## ERRORS



           The _pthread_attr_setstacksize_() function shall fail if:
    
           **EINVAL** The value of _stacksize_ is less than {PTHREAD_STACK_MIN} or
                  exceeds a system-imposed limit.
    
           These functions shall not return an error code of **[EINTR]**.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           If an implementation detects that the value specified by the _attr_
           argument to _pthread_attr_getstacksize_() or
           _pthread_attr_setstacksize_() does not refer to an initialized
           thread attributes object, it is recommended that the function
           should fail and report an **[EINVAL]** error.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# audit_add_rule_data

## NAME



           audit_add_rule_data - Add new audit rule
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_add_rule_data(int** _fd_**, struct audit_rule_data ***_rule_**, int** _flags_**, int** _action_**);"**
    


## DESCRIPTION



           audit_add_rule_data adds an audit rule previously constructed with
           audit_rule_fieldpair_data(3) to one of several kernel event
           filters. The filter is specified by the _fd_ file descriptor and the
           _flags_ argument. Possible values for _flags_ are:
    
           •  AUDIT_FILTER_USER - Apply rule to userspace generated messages.
              This is the user filter. Normally all user space originating
              events are accepted. Rules on this filter are typically written
              to block specific events.
    
           •  AUDIT_FILTER_TASK - Apply rule at task creation (not syscall).
              This is the task filter. It's normally used to exclude an
              application from being audited.
    
           •  AUDIT_FILTER_EXIT - Apply rule at syscall exit. This is the
              main filter that is used for syscalls and filesystem watches.
              Normally all syscall do not trigger events, so this is normally
              used to specify events that are of interest.
    
           •  AUDIT_FILTER_EXCLUDE - Apply rule at audit_log_start. This is
              the exclude filter which discards any records that match.  The
              action type is ignored for this filter, defaulting to "never".
    
           •      AUDIT_FILTER_FS - Apply rule when adding PATH auxiliary
                  records to SYSCALL events. This is the filesystem filter.
                  This is used to ignore PATH records that are not of
                  interest.
    
           The rule's action has two possible values:
    
           •  AUDIT_NEVER - Do not build context if rule matches.
    
           •  AUDIT_ALWAYS - Generate audit record if rule matches.
    


## RETURN VALUE



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


* * *
# pcap_set_tstamp_type

## NAME



           pcap_set_tstamp_type - set the time stamp type to be used by a
           capture device
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_set_tstamp_type**() sets the type of time stamp desired for
           packets captured on the pcap descriptor to the type specified by
           _tstamp_type_.  It must be called on a pcap descriptor created by
           **pcap_create**(3PCAP) that has not yet been activated by
           **pcap_activate**(3PCAP).  **pcap_list_tstamp_types**(3PCAP) will give a
           list of the time stamp types supported by a given capture device.
           See pcap-tstamp(7) for a list of all the time stamp types.
    


## RETURN VALUE



           **pcap_set_tstamp_type**() returns **0** on success if the specified time
           stamp type is expected to be supported by the capture device,
           **PCAP_WARNING_TSTAMP_TYPE_NOTSUP** if the specified time stamp type
           is not supported by the capture device, **PCAP_ERROR_ACTIVATED** if
           called on a capture handle that has been activated, and
           **PCAP_ERROR_CANTSET_TSTAMP_TYPE** if the capture device doesn't
           support setting the time stamp type (only older versions of
           libpcap will return that; newer versions will always allow the
           time stamp type to be set to the default type).
    


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.2.1.  In
           previous releases, the time stamp type cannot be set; only the
           default time stamp type offered by a capture source is available.
    


* * *
# sscanf

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



           sscanf — convert formatted input
    


## SYNOPSIS



           #include <stdio.h>
    
           int sscanf(const char *restrict _s_ , const char *restrict _format_ , ...);
    


## DESCRIPTION



           Refer to fscanf(3p).
    


* * *
# ibv_alloc_dmah

## NAME



           ibv_alloc_dmah - allocate a dma handle
    
           int ibv_dealloc_dmah - deallocate a dma handle
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_dmah *ibv_alloc_dmah(struct ibv_context *context, struct ibv_dmah_init_attr *attr);
    
                  int ibv_dealloc_dmah(struct ibv_dmah *dmah);
    


## DESCRIPTION



           **ibv_alloc_dmah()** allocates an _ibv_dmah_ object that is associated
           with the given _context_ and the input _attr_ parameter.
    
           The allocated handle can be later used for optimizing DMA and RDMA
           operations associated with a registered memory region.
    
           Once the _ibv_dmah_ usage has been ended _ibv_dealloc_dmah()_ should
           be called.
    
           This call will release resources that were earlier allocated using
           the **ibv_alloc_dmah()** API.
    


## ARGUMENTS



       **attr**
                  enum ibv_tph_mem_type {
                      IBV_TPH_MEM_TYPE_VM, /* volatile memory */
                      IBV_TPH_MEM_TYPE_PM, /* persistent memory */
                  };
    
                  enum ibv_dmah_init_attr_mask {
                      IBV_DMAH_INIT_ATTR_MASK_CPU_ID = 1 << 0,
                      IBV_DMAH_INIT_ATTR_MASK_PH = 1 << 1,
                      IBV_DMAH_INIT_ATTR_MASK_TPH_MEM_TYPE = 1 << 2,
                  };
    
                  struct ibv_dmah_init_attr {
                      uint32_t comp_mask; /* From ibv_dmah_init_attr_mask */
                      uint32_t cpu_id;
                      uint8_t ph;
                      uint8_t tph_mem_type; /* From enum ibv_tph_mem_type */
                  };
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid.
    
           _cpu_id_ The cpu id that the dma handle refers to.
    
           _ph_     Processing hints, used to aid in optimizing the handling of
                  transactions over PCIe.
    
           _tph_mem_type_
                  The target memory type, one among _enum ibv_tph_mem_type_.
    


## RETURN VALUE



           **ibv_alloc_dmah()** returns a pointer to the allocated dma handle
           object, or NULL if the request fails.
    
           **ibv_dealloc_dmah()** returns 0 upon success, otherwise the errno
           value.
    


* * *
# probe::nfs.proc.read_setup

## NAME



           probe::nfs.proc.read_setup - NFS client setting up a read RPC task
    


## SYNOPSIS



           nfs.proc.read_setup
    


## VALUES



           _server_ip_
               IP address of server
    
           _size_
               read bytes in this execution
    
           _offset_
               the file offset
    
           _count_
               read bytes in this execution
    
           _prot_
               transfer protocol
    
           _version_
               NFS version
    


## DESCRIPTION



           The read_setup function is used to setup a read RPC task. It is
           not doing the actual read operation.
    


* * *
# menu_win

## NAME



           **menu_win** - make and break menu window and subwindow associations
    


## SYNOPSIS



           **#include <menu.h>**
    
           **int set_menu_win(MENU ***_menu_**, WINDOW ***_win_**);**
           **WINDOW *menu_win(const MENU ***_menu_**);**
    
           **int set_menu_sub(MENU ***_menu_**, WINDOW ***_sub_**);**
           **WINDOW *menu_sub(const MENU ***_menu_**);**
    
           **int scale_menu(const MENU ***_menu, int *rows_**, int ***_columns);_
    


## DESCRIPTION



           Every menu has an associated pair of **curses** windows.  The menu
           window displays any title and border associated with the window;
           the menu subwindow displays the items of the menu that are
           currently available for selection.
    
           The first four functions get and set those windows.  It is not
           necessary to set either window; by default, the driver code uses
           **stdscr** for both.
    
           In the **set_** functions, window argument of **NULL** is treated as
           though it were **stsdcr**.  A menu argument of **NULL** is treated as a
           request to change the system default menu window or subwindow.
    
           The function **scale_menu** returns the minimum size required for the
           subwindow of _menu_.
    


## RETURN VALUE



           Routines that return pointers return **NULL** on error.  Routines that
           return an integer return one of the following error codes:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    
           **E_BAD_ARGUMENT**
                Routine detected an incorrect or out-of-range argument.
    
           **E_POSTED**
                The menu has already been posted.
    
           **E_NOT_CONNECTED**
                No items are connected to the 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.
    


* * *
# gnutls_x509_crq_set_subject_alt_othername

## NAME



           gnutls_x509_crq_set_subject_alt_othername - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_subject_alt_othername(gnutls_x509_crq_t**
           _crq_**, const char ***_oid_**, const void ***_data_**, unsigned int** _data_size_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate request of type **gnutls_x509_crq_t**
    
           const char * oid
                       is the othername OID
    
           const void * data
                       The data to be set
    
           unsigned int data_size
                       The size of data to be set
    
           unsigned int flags
                       **GNUTLS_FSAN_SET** to clear previous data or
                       **GNUTLS_FSAN_APPEND** to append.
    


## DESCRIPTION



           This function will set the subject alternative name certificate
           extension.  It can set the following types:
    
           The values set must be binary values and must be properly DER
           encoded.
    


## RETURNS



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


## SINCE



           3.5.0
    


* * *
# probe::scheduler.tick

## NAME



           probe::scheduler.tick - Schedulers internal tick, a processes
           timeslice accounting is updated
    


## SYNOPSIS



           scheduler.tick
    


## VALUES



           _idle_
               boolean indicating whether current is the idle process
    
           _name_
               name of the probe point
    


## CONTEXT



           The process whose accounting will be updated.
    


* * *
# gnutls_x509_privkey_get_spki

## NAME



           gnutls_x509_privkey_get_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_privkey_get_spki(gnutls_x509_privkey_t** _key_**,**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_privkey_t key
                       should contain a **gnutls_x509_privkey_t** type
    
           gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_x509_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will return the public key information of a private
           key. The provided  _spki_ must be initialized.
    


## RETURNS



           Zero on success, or a negative error code on error.
    


* * *
# ibv_open_xrcd

## NAME



           ibv_open_xrcd, ibv_close_xrcd - open or close an XRC protection
           domain (XRCDs)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct ibv_xrcd *ibv_open_xrcd(struct ibv_context** _*context_**,**
                                          **struct ibv_xrcd_init_attr** _*xrcd_init_attr_**);**
    
           **int ibv_close_xrcd(struct ibv_xrcd** _*xrcd_**);**
    


## DESCRIPTION



           **ibv_open_xrcd()** open an XRC domain for the RDMA device context
           _context xrcd_init_attr_ is an ibv_xrcd_init_attr struct, as defined
           in <infiniband/verbs.h>.
    
           struct ibv_xrcd_init_attr {
                   uint32_t         comp_mask;  /* Identifies valid fields */
                   int              fd;
                   int              oflag;
    
           _fd_ is the file descriptor to associate with the XRCD.  _oflag_
           describes the desired creation attributes.  It is a bitwise OR of
           zero or more of the following flags:
    
           **O_CREAT**
                  Indicates that an XRCD should be created and associated
                  with the inode referenced by the given fd.  If the XRCD
                  exists, this flag has no effect except as noted under
                  **O_EXCL** below.
    
           **O_EXCL** If **O_EXCL** and **O_CREAT** are set, open will fail if an XRCD
                  associated with the inode exists.
    
           If _fd_ equals -1, no inode is associated with the XRCD. To indicate
           that XRCD should be created, use _oflag_ = **O_CREAT**.
    
           **ibv_close_xrcd()** closes the XRCD _xrcd_.  If this is the last
           reference, the XRCD will be destroyed.
    


## RETURN VALUE



           **ibv_open_xrcd()** returns a pointer to the opened XRCD, or NULL if
           the request fails.
    
           **ibv_close_xrcd()** returns 0 on success, or the value of errno on
           failure (which indicates the failure reason).
    


## NOTES



           **ibv_close_xrcd()** may fail if any other resource is still
           associated with the XRCD being closed.
    


* * *
# sched_get_priority_max

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



           sched_get_priority_max, sched_get_priority_min — get priority
           limits (**REALTIME**)
    


## SYNOPSIS



           #include <sched.h>
    
           int sched_get_priority_max(int _policy_);
           int sched_get_priority_min(int _policy_);
    


## DESCRIPTION



           The _sched_get_priority_max_() and _sched_get_priority_min_()
           functions shall return the appropriate maximum or minimum,
           respectively, for the scheduling policy specified by _policy_.
    
           The value of _policy_ shall be one of the scheduling policy values
           defined in _< sched.h>_.
    


## RETURN VALUE



           If successful, the _sched_get_priority_max_() and
           _sched_get_priority_min_() functions shall return the appropriate
           maximum or minimum values, respectively. If unsuccessful, they
           shall return a value of -1 and set _errno_ to indicate the error.
    


## ERRORS



           The _sched_get_priority_max_() and _sched_get_priority_min_()
           functions shall fail if:
    
           **EINVAL** The value of the _policy_ parameter does not represent a
                  defined scheduling policy.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# auparse_set_escape_mode

## NAME



           auparse_set_escape_mode - choose escape method
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **void auparse_set_escape_mode(auparse_state_t**
           *****_au,_**auparse_esc_t"**_mode);"_
    


## DESCRIPTION



           auparse_set_escape_mode is used to set the escaping method that
           will be used to output interpreted text. The choices for the mode
           variable are:
    
                  **AUPARSE_ESC_RAW**
                         No escaping of any kind is done.
    
                  **AUPARSE_ESC_TTY**
                         Escape TTY control characters so that they are
                         harmless to display on a terminal. When any control
                         character is found, they are displayed as octal
                         numbers. This is the default mode that the auparse
                         library is initialized with.
    
                  **AUPARSE_ESC_SHELL**
                         Besides escaping control characters, this will
                         escape some characters that can cause problems when
                         used with shell scripting. Any escaped control
                         characters are displayed as octal numbers. Other
                         escaped characters are proceeded with a backslash.
                         The additional characters it escapes are: " ' ` $ \
    
                  **AUPARSE_ESC_SHELL_QUOTE**
                         Similar to _AUPARSE_ESC_SHELL_ but expands the
                         character set to include shell operators. Any
                         escaped control characters are displayed as octal
                         numbers. Other escaped characters are proceeded with
                         a backslash. The additional characters it escapes
                         include: ; '  " ` # $ & * ? [ ] < > { } \
    


## RETURN VALUE



           None
    


* * *
# memset

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



           memset — set bytes in memory
    


## SYNOPSIS



           #include <string.h>
    
           void *memset(void *_s_ , int _c_ , size_t _n_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _memset_() function shall copy _c_ (converted to an **unsigned char**)
           into each of the first _n_ bytes of the object pointed to by _s_.
    


## RETURN VALUE



           The _memset_() function shall return _s_ ; no return value is reserved
           to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# posix_spawnattr_getsigmask

## 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_spawnattr_getsigmask, posix_spawnattr_setsigmask — get and
           set the spawn-sigmask attribute of a spawn attributes object
           (**ADVANCED REALTIME**)
    


## SYNOPSIS



           #include <signal.h>
           #include <spawn.h>
    
           int posix_spawnattr_getsigmask(const posix_spawnattr_t *restrict _attr_ ,
               sigset_t *restrict _sigmask_);
           int posix_spawnattr_setsigmask(posix_spawnattr_t *restrict _attr_ ,
               const sigset_t *restrict _sigmask_);
    


## DESCRIPTION



           The _posix_spawnattr_getsigmask_() function shall obtain the value
           of the _spawn-sigmask_ attribute from the attributes object
           referenced by _attr_.
    
           The _posix_spawnattr_setsigmask_() function shall set the _spawn-_
           _sigmask_ attribute in an initialized attributes object referenced
           by _attr_.
    
           The _spawn-sigmask_ attribute represents the signal mask in effect
           in the new process image of a spawn operation (if
           POSIX_SPAWN_SETSIGMASK is set in the _spawn-flags_ attribute). The
           default value of this attribute is unspecified.
    


## RETURN VALUE



           Upon successful completion, _posix_spawnattr_getsigmask_() shall
           return zero and store the value of the _spawn-sigmask_ attribute of
           _attr_ into the object referenced by the _sigmask_ parameter;
           otherwise, an error number shall be returned to indicate the
           error.
    
           Upon successful completion, _posix_spawnattr_setsigmask_() shall
           return zero; otherwise, an error number shall be returned to
           indicate the error.
    


## ERRORS



           These functions may fail if:
    
           **EINVAL** The value specified by _attr_ is invalid.
    
           The _posix_spawnattr_setsigmask_() function may fail if:
    
           **EINVAL** The value of the attribute being set is not valid.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           These functions are part of the Spawn option and need not be
           provided on all implementations.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# gnutls_transport_get_ptr2

## NAME



           gnutls_transport_get_ptr2 - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_transport_get_ptr2(gnutls_session_t** _session_**,**
           **gnutls_transport_ptr_t ***_recv_ptr_**, gnutls_transport_ptr_t ***
           _send_ptr_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           gnutls_transport_ptr_t * recv_ptr
                       will hold the value for the pull function
    
           gnutls_transport_ptr_t * send_ptr
                       will hold the value for the push function
    


## DESCRIPTION



           Used to get the arguments of the transport functions (like PUSH
           and PULL).  These should have been set using
           **gnutls_transport_set_ptr2()**.
    


* * *
# keyctl_link

## NAME



           keyctl_link, keyctl_unlink - link/unlink a key to/from a keyring
    


## SYNOPSIS



           **#include <keyutils.h>**
    
           **long keyctl_link(key_serial_t** _key_**, key_serial_t** _keyring_**);**
    
           **long keyctl_unlink(key_serial_t** _key_**, key_serial_t** _keyring_**);**
    


## DESCRIPTION



           **keyctl_link**() creates a link from _keyring_ to _key_ , displacing any
           link to another key of the same type and description in that
           keyring if one exists.
    
           **keyctl_unlink**() removes the link from _keyring_ to _key_ if it exists.
    
           The caller must have **write** permission on a keyring to be able to
           create or remove links in it.
    
           The caller must have **link** permission on a key to be able to create
           a link to it.
    


## RETURN VALUE



           On success **keyctl_link**() and **keyctl_unlink**() return **0**.  On error,
           the value **-1** will be returned and _errno_ will have been set to an
           appropriate error.
    


## ERRORS



           **ENOKEY** The key or the keyring specified are invalid.
    
           **EKEYEXPIRED**
                  The key or the keyring specified have expired.
    
           **EKEYREVOKED**
                  The key or the keyring specified have been revoked.
    
           **EACCES** The keyring exists, but is not **writable** by the calling
                  process.
    
           For **keyctl_link**() only:
    
           **ENOMEM** Insufficient memory to expand the keyring
    
           **EDQUOT** Expanding the keyring would exceed the keyring owner's
                  quota.
    
           **EACCES** The key exists, but is not **linkable** by the calling process.
    


## LINKING



           This is a library function that can be found in _libkeyutils_.  When
           linking, **-lkeyutils** should be specified to the linker.
    


* * *
# gnutls_ocsp_resp_deinit

## NAME



           gnutls_ocsp_resp_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **void gnutls_ocsp_resp_deinit(gnutls_ocsp_resp_t** _resp_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_t resp
                       The data to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a OCSP response structure.
    


* * *
# macro::json_output_array_numeric_value

## NAME



           macro::json_output_array_numeric_value - Output a numeric value
           for metric in an array.
    


## SYNOPSIS



               @json_output_array_numeric_value(array_name,array_index,metric_name,value)
    


## ARGUMENTS



           _array_name_
               The name of the array.
    
           _array_index_
               The array index (as a string) indicating where to store the
               numeric value.
    
           _metric_name_
               The name of the numeric metric.
    
           _value_
               The numeric value to output.
    


## DESCRIPTION



           The json_output_array_numeric_value macro is designed to be called
           from the 'json_data' probe in the user's script to output a
           metric's numeric value that is in an array. This metric should
           have been added with **json_add_array_numeric_metric**.
    


* * *
# rdma_set_local_ece

## NAME



           rdma_set_local_ece - Set local ECE paraemters to be used for
           REQ/REP communication.
    


## SYNOPSIS



                  #include <rdma/rdma_cma.h>
    
                  int rdma_set_local_ece(struct rdma_cm_id *id, struct ibv_ece *ece);
    


## DESCRIPTION



           **rdma_set_local_ece()** set local ECE parameters.
    
           This function is suppose to be used by the users of external QPs.
           The call needs to be performed before replying to the peer and
           needed to configure RDMA_CM with desired ECE options.
    
           Being used by external QP and RDMA_CM doesn’t manage that QP, the
           peer needs to call to libibverbs API by itself.
    
           Usual flow for the passive side will be:
    
           • ibv_create_qp() <- create data QP.
    
           • ece = ibv_query_ece() <- get ECE from libibvers provider.
    
           • rdma_set_local_ece(ece) <- set desired ECE options.
    
           • rdma_connect() <- send connection request
    
           • ece = rdma_get_remote_ece() <- get ECE options from remote peer
    
           • ibv_set_ece(ece) <- set local ECE options with data received
             from the peer.
    
           • ibv_modify_qp() <- enable data QP.
    
           • rdma_accept()/rdma_establish()/rdma_reject_ece()
    


## ARGUMENTS



           _id_     RDMA communication identifier.
    
           *ece   ECE parameters.
    


## RETURN VALUE



           **rdma_set_local_ece()** returns 0 on success, or -1 on error.  If an
           error occurs, errno will be set to indicate the failure reason.
    


* * *
# mlx5dv_devx_alloc_uar

## NAME



           mlx5dv_devx_alloc_uar - Allocates a DEVX UAR
    
           mlx5dv_devx_free_uar - Frees a DEVX UAR
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  struct mlx5dv_devx_uar *mlx5dv_devx_alloc_uar(struct ibv_context *context,
                                                                uint32_t flags);
    
                  void mlx5dv_devx_free_uar(struct mlx5dv_devx_uar *devx_uar);
    


## DESCRIPTION



           Create / free a DEVX UAR which is needed for other device commands
           over the DEVX interface.
    
           The DEVX API enables direct access from the user space area to the
           mlx5 device driver, the UAR information is needed for few commands
           as of QP creation.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _flags_  Allocation flags for the UAR.  MLX5DV_UAR_ALLOC_TYPE_BF:
                  Allocate UAR with Blueflame properties.
                  MLX5DV_UAR_ALLOC_TYPE_NC: Allocate UAR with non-cache
                  properties.  MLX5DV_UAR_ALLOC_TYPE_NC_DEDICATED: Allocate a
                  dedicated UAR with non-cache properties.
    
       **devx_uar**
                  struct mlx5dv_devx_uar {
                      void *reg_addr;
                      void *base_addr;
                      uint32_t page_id;
                      off_t mmap_off;
                      uint64_t comp_mask;
                  };
    
           _reg_addr_
                  The write address of DB/BF.
    
           _base_addr_
                  The base address of the UAR.
    
           _page_id_
                  The device page id to be used.
    
           _mmap_off_
                  The mmap offset parameter to be used for re-mapping, to be
                  used by a secondary process.
    


## RETURN VALUE



           Upon success _mlx5dv_devx_alloc_uar_ will return a new _struct_
           _mlx5dv_devx_uar_ , on error NULL will be returned and errno will be
           set.
    


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



           pthread_condattr_init — initialize the condition variable
           attributes object
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_condattr_init(pthread_condattr_t *_attr_);
    


## DESCRIPTION



           Refer to pthread_condattr_destroy(3p).
    


* * *
# gnutls_psk_server_get_username

## NAME



           gnutls_psk_server_get_username - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **const char * gnutls_psk_server_get_username(gnutls_session_t**
           _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a gnutls session
    


## DESCRIPTION



           This should only be called in case of PSK authentication and in
           case of a server.
    
           The returned pointer should be considered constant (do not free)
           and valid for the lifetime of the session.
    
           This function will return **NULL** if the username has embedded NULL
           bytes.  In that case, **gnutls_psk_server_get_username2()** should be
           used to retrieve the username.
    


## RETURNS



           the username of the peer, or **NULL** in case of an error, or if the
           username has embedded NULLs.
    


* * *
# probe::nfs.proc.write

## NAME



           probe::nfs.proc.write - NFS client synchronously writes file to
           server
    


## SYNOPSIS



           nfs.proc.write
    


## VALUES



           _size_
               read bytes in this execution
    
           _offset_
               the file offset
    
           _bitmask1_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _prot_
               transfer protocol
    
           _bitmask0_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _version_
               NFS version
    
           _server_ip_
               IP address of server
    
           _flags_
               used to set task->tk_flags in rpc_init_task function
    


## DESCRIPTION



           All the nfs.proc.write kernel functions were removed in kernel
           commit 200baa in December 2006, so these probes do not exist on
           Linux 2.6.21 and newer kernels.
    


* * *