tripathysagar/man_text huggingface dataset:
# ibv_modify_wq

## NAME



           ibv_modify_wq - Modify a Work Queue (WQ).
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **struct int ibv_modify_wq(struct ibv_wq** _*wq,_
                                        **struct ibv_wq_attr** _*wq_attr_**);**
    


## DESCRIPTION



           **ibv_modify_wq()** modifys a WQ _wq_.  The argument _wq_attr_ is an
           ibv_wq_attr struct, as defined in <infiniband/verbs.h>.
    
           struct ibv_wq_attr {
                   uint32_t                attr_mask;     /* Use enum ibv_wq_attr_mask */
                   enum ibv_wq_state       wq_state;      /* Move to this state */
                   enum ibv_wq_state       curr_wq_state; /* Assume this is the current state */
                   uint32_t                flags;         /* Flags values to modify, use enum ibv_wq_flags */
                   uint32_t                flags_mask;    /* Which flags to modify, use enum ibv_wq_flags */
           };
    
           The function **ibv_modify_wq()** will modify the WQ based on the given
           _wq_attr_ ->attr_mask
    


## RETURN VALUE



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


* * *
# audit_request_features

## NAME



           audit_request_features - request audit feature bitmap
    


## SYNOPSIS



           **#include <libaudit.h>**
    
           **int audit_request_features(int** _fd_**);**
    


## DESCRIPTION



           **audit_request_features**() requests that the kernel send a structure
           describing supported audit features on _fd_ which must be an open
           audit netlink socket.
    


## 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(2) would encounter.
    


* * *
# capng_have_capability

## NAME



           capng_have_capability - check for specific capability
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_have_capability(capng_type_t which, unsigned int
           capability);
    


## DESCRIPTION



           capng_have_capability will check the specified internal
           capabilities set to see if the specified capability is set. The
           capabilities sets must be previously setup with calls to
           capng_get_caps_process, capng_get_caps_fd, or in some other way
           setup. The values for which should be one of: CAPNG_EFFECTIVE,
           CAPNG_PERMITTED, CAPNG_INHERITABLE, CAPNG_BOUNDING_SET, or
           CAPNG_AMBIENT.
    


## RETURN VALUE



           This function will return 1 if yes and 0 otherwise.
    


* * *
# curs_extend

## NAME



           **curses_version** , **use_extended_names** - miscellaneous curses
           extensions
    


## SYNOPSIS



           **#include <curses.h>**
    
           **const char * curses_version(void);**
           **int use_extended_names(bool** _enable_**);**
    


## DESCRIPTION



           These functions are extensions to the curses library which do not
           fit easily into other categories.
    
       **curses_version**
           Use **curses_version** to get the version number, including patch
           level of the library, prefixed by “ncurses”, e.g.,
    
                  **ncurses 5.0.19991023**
    
       **use_extended_names**
           The **use_extended_names** function controls whether the calling
           application is able to use user-defined or nonstandard names which
           may be compiled into the terminfo description, i.e., via the
           terminfo or termcap interfaces.  Normally these names are
           available for use, since the essential decision is made by using
           the **-x** option of **tic** to compile extended terminal definitions.
           However you can disable this feature to ensure compatibility with
           other implementations of curses.
    


## RETURN VALUE



           **curses_version** returns a pointer to static memory; you should not
           free this in your application.
    
           **use_extended_names** returns the previous state, allowing you to
           save this and restore it.
    


## PORTABILITY



           These routines are specific to ncurses.  They were not supported
           on Version 7, BSD or System V implementations.  It is recommended
           that any code depending on them be conditioned using
           NCURSES_VERSION.
    


* * *
# function::local_clock_us

## NAME



           function::local_clock_us - Number of microseconds on the local
           cpu's clock
    


## SYNOPSIS



               local_clock_us:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the number of microseconds on the local
           cpu's clock. This is always monotonic comparing on the same cpu,
           but may have some drift between cpus (within about a jiffy).
    


* * *
# vswprintf

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



           vswprintf — wide-character formatted output of a stdarg argument
           list
    


## SYNOPSIS



           #include <stdarg.h>
           #include <stdio.h>
           #include <wchar.h>
    
           int vswprintf(wchar_t *restrict _ws_ , size_t _n_ ,
               const wchar_t *restrict _format_ , va_list _arg_);
    


## DESCRIPTION



           Refer to vfwprintf(3p).
    


* * *
# gnutls_certificate_set_x509_trust

## NAME



           gnutls_certificate_set_x509_trust - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_certificate_set_x509_trust(gnutls_certificate_credentials_t**
           _res_**, gnutls_x509_crt_t ***_ca_list_**, int** _ca_list_size_**);**
    


## ARGUMENTS



           gnutls_certificate_credentials_t res
                       is a **gnutls_certificate_credentials_t** type.
    
           gnutls_x509_crt_t * ca_list
                       is a list of trusted CAs
    
           int ca_list_size
                       holds the size of the CA list
    


## DESCRIPTION



           This function adds the trusted CAs in order to verify client or
           server certificates. In case of a client this is not required to
           be called if the certificates are not verified using
           **gnutls_certificate_verify_peers2()**.  This function may be called
           multiple times.
    
           In case of a server the CAs set here will be sent to the client if
           a certificate request is sent. This can be disabled using
           **gnutls_certificate_send_x509_rdn_sequence()**.
    


## RETURNS



           the number of certificates processed or a negative error code on
           error.
    


## SINCE



           2.4.0
    


* * *
# libpfm_intel_bdx_unc_ubo

## NAME



           libpfm_intel_bdx_unc_ubo - support for Intel Broadwell Server U-
           Box uncore PMU
    


## SYNOPSIS



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


## DESCRIPTION



           The library supports the Intel Broadwell server system
           configuration unit (U-Box) uncore PMU.  This PMU model only exists
           on various Broadwell server models (79, 86).
    


## MODIFIERS



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


* * *
# futimes

## NAME



           futimes, lutimes - change file timestamps
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/time.h>**
    
           **int futimes(int** _fd_**, const struct timeval** _tv_**[2]);**
           **int lutimes(const char ***_path_**, const struct timeval** _tv_**[2]);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **futimes**(), **lutimes**():
               Since glibc 2.19:
                   _DEFAULT_SOURCE
               glibc 2.19 and earlier:
                   _BSD_SOURCE
    


## DESCRIPTION



           **futimes**() changes the access and modification times of a file in
           the same way as utimes(2), with the difference that the file whose
           timestamps are to be changed is specified via a file descriptor,
           _fd_ , rather than via a pathname.
    
           **lutimes**() changes the access and modification times of a file in
           the same way as utimes(2), with the difference that if _path_ refers
           to a symbolic link, then the link is not dereferenced: instead,
           the timestamps of the symbolic link are changed.
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned, and _errno_
           is set to indicate the error.
    


## ERRORS



           Errors are as for utimes(2), with the following additions for
           **futimes**():
    
           **EBADF** _fd_ is not a valid file descriptor.
    
           **ENOSYS** The _/proc_ filesystem could not be accessed.
    
           The following additional error may occur for **lutimes**():
    
           **ENOSYS** The kernel does not support this call; Linux 2.6.22 or
                  later is required.
    


## ATTRIBUTES



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


## STANDARDS



           Linux, BSD.
    


## NOTES



           **lutimes**() is implemented using the utimensat(2) system call.
    


* * *
# function::user_int_warn

## NAME



           function::user_int_warn - Retrieves an int value stored in user
           space
    


## SYNOPSIS



               user_int_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the int from
    


## DESCRIPTION



           Returns the int value from a given user space address. Returns
           zero when user space data is not accessible and warns about the
           failure (but does not error).
    


* * *
# function::proc_mem_txt

## NAME



           function::proc_mem_txt - Program text (code) size in pages
    


## SYNOPSIS



           1) proc_mem_txt:long()
    
           2) proc_mem_txt:long(pid:long)
    


## ARGUMENTS



           _pid_
               The pid of process to examine
    


## DESCRIPTION



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


* * *
# uuid_time

## NAME



           uuid_time - extract the time at which the UUID was created
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **time_t uuid_time(const uuid_t** _uu_**, struct timeval ***_ret_tv_**)**
    


## DESCRIPTION



           The **uuid_time**() function extracts the time at which the supplied
           time-based UUID _uu_ was created. Note that the UUID creation time
           is only encoded within certain types of UUIDs. This function can
           only reasonably expect to extract the creation time for UUIDs
           created with the uuid_generate_time(3) and
           uuid_generate_time_safe(3) functions. It may or may not work with
           UUIDs created by other mechanisms.
    


## RETURN VALUE



           The time at which the UUID was created, in seconds since January
           1, 1970 GMT (the epoch), is returned (see time(2)). The time at
           which the UUID was created, in seconds and microseconds since the
           epoch, is also stored in the location pointed to by _ret_tv_ (see
           gettimeofday(2)).
    


## AVAILABILITY



           The **libuuid** library is part of the util-linux package since
           version 2.15.1. It can be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-08-09                   _UUID_TIME_(3)
    


* * *
# umad_get_mad

## NAME



           umad_get_mad - get the MAD pointer of a umad buffer
    


## SYNOPSIS



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


## DESCRIPTION



           **umad_get_mad()** returns a pointer to the MAD contained within the
           _umad_ buffer.
    


## RETURN VALUE



           **umad_get_mad()** returns a pointer to the MAD contained within the
           supplied _umad_ buffer.
    


* * *
# function::set_ulonglong_arg

## NAME



           function::set_ulonglong_arg - Set function argument as 64-bit
           value
    


## SYNOPSIS



               set_ulonglong_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the value of argument n as a 64-bit value. (Same as
           longlong_arg.)
    


* * *
# probe::signal.send_sig_queue

## NAME



           probe::signal.send_sig_queue - Queuing a signal to a process
    


## SYNOPSIS



           signal.send_sig_queue
    


## VALUES



           _sig_pid_
               The PID of the process to which the signal is queued
    
           _sig_
               The queued signal
    
           _sig_name_
               A string representation of the signal
    
           _name_
               Name of the probe point
    
           _sigqueue_addr_
               The address of the signal queue
    
           _pid_name_
               Name of the process to which the signal is queued
    


* * *
# gnutls_x509_crt_set_pubkey

## NAME



           gnutls_x509_crt_set_pubkey - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_x509_crt_set_pubkey(gnutls_x509_crt_t** _crt_**,**
           **gnutls_pubkey_t** _key_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       should contain a **gnutls_x509_crt_t** type
    
           gnutls_pubkey_t key
                       holds a public key
    


## DESCRIPTION



           This function will set the public parameters from the given public
           key to the certificate. The  _key_ can be deallocated after that.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# gnutls_x509_crt_set_subject_key_id

## NAME



           gnutls_x509_crt_set_subject_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_subject_key_id(gnutls_x509_crt_t** _cert_**,**
           **const void ***_id_**, size_t** _id_size_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t cert
                       a certificate of type **gnutls_x509_crt_t**
    
           const void * id
                       The key ID
    
           size_t id_size
                       Holds the size of the subject key ID field.
    


## DESCRIPTION



           This function will set the X.509 certificate's subject key ID
           extension.
    


## RETURNS



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


* * *
# gnutls_x509_crt_set_crq

## NAME



           gnutls_x509_crt_set_crq - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_crq(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_crq_t** _crq_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           gnutls_x509_crq_t crq
                       holds a certificate request
    


## DESCRIPTION



           This function will set the name and public parameters as well as
           the extensions from the given certificate request to the
           certificate.  Only RSA keys are currently supported.
    
           Note that this function will only set the  _crq_ if it is self
           signed and the signature is correct. See **gnutls_x509_crq_sign2()**.
    


## RETURNS



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


* * *
# gnutls_hex2bin

## NAME



           gnutls_hex2bin - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_hex2bin(const char ***_hex_data_**, size_t** _hex_size_**, void ***
           _bin_data_**, size_t ***_bin_size_**);**
    


## ARGUMENTS



           const char * hex_data
                       string with data in hex format
    
           size_t hex_size
                       size of hex data
    
           void * bin_data
                       output array with binary data
    
           size_t * bin_size
                       when calling should hold maximum size of  _bin_data_ ,
                       on return will hold actual length of  _bin_data_ .
    


## DESCRIPTION



           Convert a buffer with hex data to binary data. This function
           unlike **gnutls_hex_decode()** can parse hex data with separators
           between numbers. That is, it ignores any non-hex characters.
    


## RETURNS



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


## SINCE



           2.4.0
    


* * *
# io_uring_check_version

## NAME



           io_uring_check_version - functions and macros to check the
           liburing version
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **bool io_uring_check_version(int** _major_**, int** _minor_**);**
           **IO_URING_CHECK_VERSION(**_major_**,**_minor_**);**
    
           **int io_uring_major_version(void);**
           **IO_URING_VERSION_MAJOR;**
    
           **int io_uring_minor_version(void);**
           **IO_URING_VERSION_MINOR;**
    


## DESCRIPTION



           The io_uring_check_version(3) function returns _false_ if the
           liburing library loaded by the dynamic linker is greater-than or
           equal-to the _major_ and _minor_ numbers provided.
    
           The IO_URING_CHECK_VERSION(3) macro returns _0_ if the liburing
           library being compiled against is greater-than or equal-to the
           _major_ and _minor_ numbers provided.
    
           The io_uring_major_version(3) function returns the _major_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MAJOR(3) macro returns the _major_ version
           number of the liburing library being compiled against.
    
           The io_uring_minor_version(3) function returns the _minor_ version
           number of the liburing library loaded by the dynamic linker.
    
           The IO_URING_VERSION_MINOR(3) macro returns the _minor_ version
           number of the liburing library being compiled against.
    


* * *
# ibv_query_srq

## NAME



           ibv_query_srq - get the attributes of a shared receive queue (SRQ)
    


## SYNOPSIS



           **#include <infiniband/verbs.h>**
    
           **int ibv_query_srq(struct ibv_srq** _*srq_**, struct ibv_srq_attr** _*srq_attr_**);**
    


## DESCRIPTION



           **ibv_query_srq()** gets the attributes of the SRQ _srq_ and returns
           them through the pointer _srq_attr_.  The argument _srq_attr_ is an
           ibv_srq_attr struct, as defined in <infiniband/verbs.h>.
    
           struct ibv_srq_attr {
                   uint32_t                max_wr;         /* maximum number of outstanding work requests (WRs) in the SRQ */
                   uint32_t                max_sge;        /* maximum number of scatter elements per WR */
                   uint32_t                srq_limit;      /* the limit value of the SRQ */
           };
    


## RETURN VALUE



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


## NOTES



           If the value returned for srq_limit is 0, then the SRQ limit
           reached ("low watermark") event is not (or no longer) armed, and
           no asynchronous events will be generated until the event is
           rearmed.
    


* * *
# ibv_import_mr

## NAME



           ibv_import_mr - import an MR from a given ibv_pd
    
           ibv_unimport_mr - unimport an MR
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  struct ibv_mr *ibv_import_mr(struct ibv_pd *pd, uint32_t mr_handle);
                  void ibv_unimport_mr(struct ibv_mr *mr)
    


## DESCRIPTION



           **ibv_import_mr()** returns a Memory region (MR) that is associated
           with the given _mr_handle_ in the RDMA context that assosicated with
           the given _pd_.
    
           The input _mr_handle_ value must be a valid kernel handle for an MR
           object in the assosicated RDMA context.  It can be achieved from
           the original MR by getting its ibv_mr->handle member value.
    
           **ibv_unimport_mr()** un import the MR.  Once the MR usage has been
           ended ibv_dereg_mr() or ibv_unimport_mr() should be called.  The
           first one will go to the kernel to destroy the object once the
           second one way cleanup what ever is needed/opposite of the import
           without calling the kernel.
    
           This is the responsibility of the application to coordinate
           between all ibv_context(s) that use this MR.  Once destroy is done
           no other process can touch the object except for unimport.  All
           users of the context must collaborate to ensure this.
    


## RETURN VALUE



           **ibv_import_mr()** returns a pointer to the allocated MR, or NULL if
           the request fails.
    


## NOTES



           The _addr_ field in the imported MR is not applicable, NULL value is
           expected.
    


* * *
# pmlookupindomtext

## NAME



           **pmLookupInDomText** - return text describing a performance metrics
           instance domain
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmLookupInDomText(pmInDom** _indom_**, int** _level_**, char ****_buffer_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Retrieve  descriptive  text about the performance metrics instance
           domain identified by _indom_.
    
           The value for the instance domain  _indom_  is  typically  extracted
           from a _pmDesc_ structure, following a call to pmLookupDesc(3) for a
           particular performance metric.
    
           The argument _level_ should be **PM_TEXT_ONELINE** for a one-line summa‐
           ry,  else **PM_TEXT_HELP** for a more verbose description, suited to a
           help dialog.
    
           The space pointed to by _buffer_ will have  been  allocated  in  **pm‐**
           **LookupInDomText** with  malloc(3),  and it is the responsibility of
           the caller to free(3) the space when it is no longer required.
    
           **pmLookupInDomText** returns zero on success.
    


## DIAGNOSTICS



           **PM_ERR_NOTHOST**
                  For archives created with versions of PCP prior to 4.0, if
                  the current PMAPI context is an archive (help and one-line
                  text was previously not maintained in the archives)
    


* * *
# gnutls_x509_dn_import

## NAME



           gnutls_x509_dn_import - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_dn_import(gnutls_x509_dn_t** _dn_**, const**
           **gnutls_datum_t ***_data_**);**
    


## ARGUMENTS



           gnutls_x509_dn_t dn
                       the structure that will hold the imported DN
    
           const gnutls_datum_t * data
                       should contain a DER encoded RDN sequence
    


## DESCRIPTION



           This function parses an RDN sequence and stores the result to a
           **gnutls_x509_dn_t** type. The data must have been initialized with
           **gnutls_x509_dn_init()**. You may use **gnutls_x509_dn_get_rdn_ava()** to
           decode the DN.
    


## RETURNS



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


## SINCE



           2.4.0
    


* * *
# gnutls_x509_crq_get_attribute_data

## NAME



           gnutls_x509_crq_get_attribute_data - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_get_attribute_data(gnutls_x509_crq_t** _crq_**,**
           **unsigned** _indx_**, void ***_data_**, size_t ***_sizeof_data_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           unsigned indx
                       Specifies which attribute number to get. Use (0) to
                       get the first one.
    
           void * data a pointer to a structure to hold the data (may be
                       null)
    
           size_t * sizeof_data
                       initially holds the size of  _oid_
    


## DESCRIPTION



           This function will return the requested attribute data in the
           certificate request.  The attribute data will be stored as a
           string in the provided buffer.
    
           Use **gnutls_x509_crq_get_attribute_info()** to extract the OID.  Use
           **gnutls_x509_crq_get_attribute_by_oid()** instead, if you want to get
           data indexed by the attribute OID rather than sequence.
    


## RETURNS



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


## SINCE



           2.8.0
    


* * *
# dane_query_deinit

## NAME



           dane_query_deinit - API function
    


## SYNOPSIS



           **#include <gnutls/dane.h>**
    
           **void dane_query_deinit(dane_query_t** _q_**);**
    


## ARGUMENTS



           dane_query_t q
                       The structure to be deinitialized
    


## DESCRIPTION



           This function will deinitialize a DANE query result structure.
    


* * *
# gnutls_pkcs11_privkey_status

## NAME



           gnutls_pkcs11_privkey_status - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **unsigned gnutls_pkcs11_privkey_status(gnutls_pkcs11_privkey_t**
           _key_**);**
    


## ARGUMENTS



           gnutls_pkcs11_privkey_t key
                       Holds the key
    


## DESCRIPTION



           Checks the status of the private key token.
    


## RETURNS



           this function will return non-zero if the token holding the
           private key is still available (inserted), and zero otherwise.
    


## SINCE



           3.1.9
    


* * *
# probe::nfsd.createv3

## NAME



           probe::nfsd.createv3 - NFS server creating a regular file or set
           file attributes for client
    


## SYNOPSIS



           nfsd.createv3
    


## VALUES



           _iap_valid_
               Attribute flags
    
           _client_ip_
               the ip address of client
    
           _filelen_
               the length of file name
    
           _iap_mode_
               file access mode
    
           _verifier_
               file attributes (atime,mtime,mode). It's used to reset file
               attributes for CREATE_EXCLUSIVE
    
           _filename_
               file name
    
           _createmode_
               create mode .The possible values could be:
               NFS3_CREATE_EXCLUSIVE, NFS3_CREATE_UNCHECKED, or
               NFS3_CREATE_GUARDED
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _truncp_
               trunp arguments, indicates if the file shouldbe truncate
    


## DESCRIPTION



           This probepoints is only called by nfsd3_proc_create and
           nfsd4_open when op_claim_type is NFS4_OPEN_CLAIM_NULL.
    


* * *
# gnutls_priority_kx_list

## NAME



           gnutls_priority_kx_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_kx_list(gnutls_priority_t** _pcache_**, const**
           **unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available key exchange methods in the priority
           structure.
    


## RETURNS



           the number of items, or an error code.
    


## SINCE



           3.2.3
    


* * *
# selabel_lookup_best_match

## NAME



           selabel_lookup_best_match - obtain a best match SELinux security
           context - Only supported on file backend.
    


## SYNOPSIS



           **#include <selinux/selinux.h>**
           **#include <selinux/label.h>**
    
           **int selabel_lookup_best_match(struct selabel_handle ***_hnd_**,**
                                         **char ****_context_**,**
                                         **const char ***_key_**,**
                                         **const char ****_links_**,**
                                         **int** _type_**);**
    
           **int selabel_lookup_best_match_raw(struct selabel_handle ***_hnd_**,**
                                             **char ****_context_**,**
                                             **const char ***_key_**,**
                                             **const char ****_links_**,**
                                             **int** _type_**);**
    


## DESCRIPTION



           **selabel_lookup_best_match**() performs a best match lookup operation
           on the handle _hnd_ , returning the result in the memory pointed to
           by _context_ , which must be freed by the caller using freecon(3).
           The _key_ parameter is a file path to check for best match using
           zero or more _link_ (aliases) parameters. The order of precedence
           for best match is:
    
                  1.  An exact match for the real path (_key_) or
    
                  2.  An exact match for any of the _link_ s (aliases), or
    
                  3.  The longest fixed prefix match.
    
           The _type_ parameter is an optional file _mode_ argument that should
           be set to the mode bits of the file, as determined by lstat(2).
           _mode_ may be zero, however full matching may not occur.
    
           **selabel_lookup_best_match_raw**() behaves identically to
           **selabel_lookup_best_match**() but does not perform context
           translation.
    


## RETURN VALUE



           On success, zero is returned.  On error, -1 is returned and _errno_
           is set appropriately.
    


## ERRORS



           **ENOENT** No context corresponding to the input _key_ and _type_ was
                  found.
    
           **EINVAL** The _key_ and/or _type_ inputs are invalid, or the context
                  being returned failed validation, or a regular expression
                  in the database failed to compile.
    
           **ENOMEM** An attempt to allocate memory failed.
    


## NOTES



           Example usage - When a service creates a device node, it may also
           create one or more symlinks to the device node.  These symlinks
           may be the only stable name for the device, e.g. if the partition
           is dynamically assigned.  The file label backend supports this by
           looking up the "best match" for a device node based on its real
           path (_key_) and any _link_ s to it (aliases). The order of precedence
           for best match is described above.
    


* * *
# gnutls_pubkey_import_ecc_x962

## NAME



           gnutls_pubkey_import_ecc_x962 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_ecc_x962(gnutls_pubkey_t** _key_**, const**
           **gnutls_datum_t ***_parameters_**, const gnutls_datum_t ***_ecpoint_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The structure to store the parsed key
    
           const gnutls_datum_t * parameters
                       DER encoding of an ANSI X9.62 parameters
    
           const gnutls_datum_t * ecpoint
                       DER encoding of ANSI X9.62 ECPoint
    


## DESCRIPTION



           This function will convert the given elliptic curve parameters to
           a **gnutls_pubkey_t**.  The output will be stored in  _key_ .
    


## RETURNS



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


## SINCE



           3.0
    


* * *
# gnutls_x509_ext_import_authority_key_id

## NAME



           gnutls_x509_ext_import_authority_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_import_authority_key_id(const gnutls_datum_t ***
           _ext_**, gnutls_x509_aki_t** _aki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const gnutls_datum_t * ext
                       a DER encoded extension
    
           gnutls_x509_aki_t aki
                       An initialized authority key identifier type
    
           unsigned int flags
                       should be zero
    


## DESCRIPTION



           This function will return the subject key ID stored in the
           provided AuthorityKeyIdentifier extension.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned,
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** if the extension is not
           present, otherwise a negative error value.
    


## SINCE



           3.3.0
    


* * *
# gnutls_priority_group_list

## NAME



           gnutls_priority_group_list - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_priority_group_list(gnutls_priority_t** _pcache_**, const**
           **unsigned int ****_list_**);**
    


## ARGUMENTS



           gnutls_priority_t pcache
                       is a **gnutls_priority_t** type.
    
           const unsigned int ** list
                       will point to an integer list
    


## DESCRIPTION



           Get a list of available groups in the priority structure.
    


## RETURNS



           the number of items, or an error code.
    


## SINCE



           3.6.0
    


* * *
# wcsncpy

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



           wcpncpy, wcsncpy — copy a fixed-size wide-character string,
           returning a pointer to its end
    


## SYNOPSIS



           #include <wchar.h>
    
           wchar_t *wcpncpy(wchar_t restrict *_ws1_ , const wchar_t *restrict _ws2_ ,
               size_t _n_);
           wchar_t *wcsncpy(wchar_t *restrict _ws1_ , const wchar_t *restrict _ws2_ ,
               size_t _n_);
    


## DESCRIPTION



           For _wcsncpy_(): 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 _wcpncpy_() and _wcsncpy_() functions shall copy not more than _n_
           wide-character codes (wide-character codes that follow a null
           wide-character code are not copied) from the array pointed to by
           _ws2_ to the array pointed to by _ws1_.  If copying takes place
           between objects that overlap, the behavior is undefined.
    
           If the array pointed to by _ws2_ is a wide-character string that is
           shorter than _n_ wide-character codes, null wide-character codes
           shall be appended to the copy in the array pointed to by _ws1_ ,
           until _n_ wide-character codes in all are written.
    


## RETURN VALUE



           If any null wide-character codes were written into the
           destination, the _wcpncpy_() function shall return the address of
           the first such null wide-character code. Otherwise, it shall
           return _& ws1_[_n_].
    
           The _wcsncpy_() function shall return _ws1_.
    
           No return values are reserved to indicate an error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           If there is no null wide-character code in the first _n_ wide-
           character codes of the array pointed to by _ws2_ , the result is not
           null-terminated.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# setlogmask

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



           setlogmask — set the log priority mask
    


## SYNOPSIS



           #include <syslog.h>
    
           int setlogmask(int _maskpri_);
    


## DESCRIPTION



           Refer to closelog(3p).
    


* * *
# creat

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



           creat — create a new file or rewrite an existing one
    


## SYNOPSIS



           #include <sys/stat.h>
           #include <fcntl.h>
    
           int creat(const char *_path_ , mode_t _mode_);
    


## DESCRIPTION



           The _creat_() function shall behave as if it is implemented as
           follows:
    
               int creat(const char *path, mode_t mode)
               {
                   return open(path, O_WRONLY|O_CREAT|O_TRUNC, mode);
               }
    


## RETURN VALUE



           Refer to open(3p).
    


## ERRORS



           Refer to open(3p).
    
           _The following sections are informative._
    


## EXAMPLES



       **Creating a File**
           The following example creates the file **/tmp/file** with read and
           write permissions for the file owner and read permission for group
           and others. The resulting file descriptor is assigned to the _fd_
           variable.
    
               #include <fcntl.h>
               ...
               int fd;
               mode_t mode = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH;
               char *pathname = "/tmp/file";
               ...
               fd = creat(pathname, mode);
               ...
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           The _creat_() function is redundant. Its services are also provided
           by the _open_() function. It has been included primarily for
           historical purposes since many existing applications depend on it.
           It is best considered a part of the C binding rather than a
           function that should be provided in other languages.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# strspn

## NAME



           strspn, strcspn - get length of a prefix substring
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <string.h>**
    
           **size_t strspn(const char ***_s_**, const char ***_accept_**);**
           **size_t strcspn(const char ***_s_**, const char ***_reject_**);**
    


## DESCRIPTION



           The **strspn**() function calculates the length (in bytes) of the
           initial segment of _s_ which consists entirely of bytes in _accept_.
    
           The **strcspn**() function calculates the length of the initial
           segment of _s_ which consists entirely of bytes not in _reject_.
    


## RETURN VALUE



           The **strspn**() function returns the number of bytes in the initial
           segment of _s_ which consist only of bytes from _accept_.
    
           The **strcspn**() function returns the number of bytes in the initial
           segment of _s_ which are not in the string _reject_.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# cimag

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



           cimag, cimagf, cimagl — complex imaginary functions
    


## SYNOPSIS



           #include <complex.h>
    
           double cimag(double complex _z_);
           float cimagf(float complex _z_);
           long double cimagl(long double complex _z_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           These functions shall compute the imaginary part of _z_.
    


## RETURN VALUE



           These functions shall return the imaginary part value (as a real).
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           For a variable _z_ of complex type:
    
               z == creal(z) + cimag(z)*I
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::tty.write

## NAME



           probe::tty.write - write to the tty line
    


## SYNOPSIS



           tty.write
    


## VALUES



           _driver_name_
               the driver name
    
           _file_name_
               the file name lreated to the tty
    
           _buffer_
               the buffer that will be written
    
           _nr_
               The amount of characters
    


* * *