tripathysagar/man_text huggingface dataset:
# auparse_find_field

## NAME



           auparse_find_field - search for field name
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **const char * auparse_find_field(auparse_state_t**
           *****_au,_**const** _char_***"**_name);"_
    


## DESCRIPTION



           auparse_find_field will scan all records in an event to find the
           first occurrence of the field name passed to it. Searching begins
           from the cursor's current position. The field name is stored for
           subsequent searching.
    
           NOTE: auparse creates 2 pseudo fields that do not exist in the
           natural record for SELinux AVC and USER_AVC decision and
           permissions. The field names are seresult and seperms
           respectively.
    


## RETURN VALUE



           Returns NULL field not found. If an error occurs errno will be
           set. Otherwise, it returns a pointer to the text value associated
           with the field.
    


* * *
# gnutls_tdb_init

## NAME



           gnutls_tdb_init - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_tdb_init(gnutls_tdb_t ***_tdb_**);**
    


## ARGUMENTS



           gnutls_tdb_t * tdb
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a public key trust storage
           structure.
    


## RETURNS



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


* * *
# netlink

## NAME



           netlink - Netlink macros
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <asm/types.h>**
           **#include <linux/netlink.h>**
    
           **int NLMSG_ALIGN(size_t** _size_**);**
           **int NLMSG_LENGTH(size_t** _size_**);**
           **int NLMSG_SPACE(size_t** _size_**);**
           **void *NLMSG_DATA(struct nlmsghdr ***_nlh_**);**
           **struct nlmsghdr *NLMSG_NEXT(struct nlmsghdr ***_nlh_**, int** _size_**);**
           **int NLMSG_OK(struct nlmsghdr ***_nlh_**, int** _size_**);**
           **int NLMSG_PAYLOAD(struct nlmsghdr ***_nlh_**, int** _size_**);**
    


## DESCRIPTION



           _< linux/netlink.h>_ defines several standard macros to access or
           create a netlink datagram.  They are similar in spirit to the
           macros defined in cmsg(3) for auxiliary data.  The buffer passed
           to and from a netlink socket should be accessed using only these
           macros.
    
           **NLMSG_ALIGN**()
                  Round the size of a netlink message up to align it
                  properly.
    
           **NLMSG_LENGTH**()
                  Given the payload size, _size_ , this macro returns the
                  aligned size to store in the _nlmsg_len_ field of the
                  _nlmsghdr_.
    
           **NLMSG_SPACE**()
                  Return the number of bytes that a netlink message with
                  payload of _size_ would occupy.
    
           **NLMSG_DATA**()
                  Return a pointer to the payload associated with the passed
                  _nlmsghdr_.
    
           **NLMSG_NEXT**()
                  Get the next _nlmsghdr_ in a multipart message.  The caller
                  must check if the current _nlmsghdr_ didn't have the
                  **NLMSG_DONE** set—this function doesn't return NULL on end.
                  The _size_ argument is an lvalue containing the remaining
                  size of the message buffer.  This macro decrements it by
                  the size of the message header.
    
           **NLMSG_OK**()
                  Return true if the netlink message is not truncated and is
                  in a form suitable for parsing.
    
           **NLMSG_PAYLOAD**()
                  Return the size of the payload associated with the
                  _nlmsghdr_.
    


## VERSIONS



           It is often better to use netlink via _libnetlink_ than via the low-
           level kernel interface.
    


## STANDARDS



           Linux.
    


* * *
# pcap_statustostr

## NAME



           pcap_statustostr - convert a PCAP_ERROR_ or PCAP_WARNING_ value to
           a string
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **const char *pcap_statustostr(int error);**
    


## DESCRIPTION



           **pcap_statustostr**() converts a **PCAP_ERROR_** or **PCAP_WARNING_** value
           returned by a libpcap routine to an error string.
    


* * *
# gnutls_anon_allocate_server_credentials

## NAME



           gnutls_anon_allocate_server_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_anon_allocate_server_credentials(gnutls_anon_server_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



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


## DESCRIPTION



           Allocate a gnutls_anon_server_credentials_t structure.
    


## RETURNS



           **GNUTLS_E_SUCCESS** on success, or an error code.
    


* * *
# bcopy

## NAME



           bcopy - copy byte sequence
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <strings.h>**
    
           **[[deprecated]] void bcopy(** size_t n;
                                     **const void** _src_**[**_n_**], void** _dest_**[**_n_**], size_t** _n_**);**
    


## DESCRIPTION



           The **bcopy**() function copies _n_ bytes from _src_ to _dest_.  The result
           is correct, even when both areas overlap.
    


## RETURN VALUE



           None.
    


## ATTRIBUTES



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


## STANDARDS



           None.
    


* * *
# pcap_set_tstamp_precision

## NAME



           pcap_set_tstamp_precision - set the time stamp precision returned
           in captures
    


## SYNOPSIS



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


## DESCRIPTION



           **pcap_set_tstamp_precision**() sets the precision of the time stamp
           desired for packets captured on the pcap descriptor to the type
           specified by _tstamp_precision_.  It must be called on a pcap
           descriptor created by **pcap_create**(3PCAP) that has not yet been
           activated by **pcap_activate**(3PCAP).  Two time stamp precisions are
           supported, microseconds and nanoseconds. One can use options
           **PCAP_TSTAMP_PRECISION_MICRO** and **PCAP_TSTAMP_PRECISION_NANO** to
           request desired precision. By default, time stamps are in
           microseconds.
    


## RETURN VALUE



           **pcap_set_tstamp_precision**() returns **0** on success if the specified
           time stamp precision is expected to be supported by the capture
           device, **PCAP_ERROR_TSTAMP_PRECISION_NOTSUP** if the capture device
           does not support the requested time stamp precision,
           **PCAP_ERROR_ACTIVATED** if called on a capture handle that has been
           activated.
    


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.5.1.  In
           previous releases, time stamps from a capture device or savefile
           are always given in seconds and microseconds.
    


* * *
# io_uring_prep_mkdir

## NAME



           io_uring_prep_mkdirat - prepare an mkdirat request
    


## SYNOPSIS



           **#include <fcntl.h>**
           **#include <sys/stat.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_mkdirat(struct io_uring_sqe ***_sqe_**,**
                                      **int** _dirfd_**,**
                                      **const char ***_path_**,**
                                      **mode_t** _mode_**);**
    
           **void io_uring_prep_mkdir(struct io_uring_sqe ***_sqe_**,**
                                    **const char ***_path_**,**
                                    **mode_t** _mode_**);**
    


## DESCRIPTION



           The io_uring_prep_mkdirat(3) function prepares a mkdirat request.
           The submission queue entry _sqe_ is setup to use the directory file
           descriptor pointed to by _dirfd_ to start a mkdirat operation on the
           path identified by _path_ with the mode given in _mode_.
    
           The io_uring_prep_mkdir(3) function prepares a mkdir request. The
           submission queue entry _sqe_ is setup to use the current working
           directory to start a mkdir operation on the path identified by
           _path_ with the mode given in _mode_.
    
           These functions prepare an async mkdir(2) or mkdirat(2) request.
           See those man pages for details.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


## NOTES



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


* * *
# function::set_uint_arg

## NAME



           function::set_uint_arg - Set argument as unsigned int
    


## SYNOPSIS



               set_uint_arg:long(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to set
    
           _v_
               value to set
    


## DESCRIPTION



           Set the value of argument n as an unsigned int (i.e., a 32-bit
           integer zero-extended to 64 bits).
    


* * *
# gnutls_srp_set_server_credentials_file

## NAME



           gnutls_srp_set_server_credentials_file - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_srp_set_server_credentials_file(gnutls_srp_server_credentials_t**
           _res_**, const char ***_password_file_**, const char ***_password_conf_file_**);**
    


## ARGUMENTS



           gnutls_srp_server_credentials_t res
                       is a **gnutls_srp_server_credentials_t** type.
    
           const char * password_file
                       is the SRP password file (tpasswd)
    
           const char * password_conf_file
                       is the SRP password conf file (tpasswd.conf)
    


## DESCRIPTION



           This function sets the password files, in a
           **gnutls_srp_server_credentials_t** type.  Those password files hold
           usernames and verifiers and will be used for SRP authentication.
    


## RETURNS



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


* * *
# iswgraph

## NAME



           iswgraph - test for graphic wide character
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <wctype.h>**
    
           **int iswgraph(wint_t** _wc_**);**
    


## DESCRIPTION



           The **iswgraph**() function is the wide-character equivalent of the
           isgraph(3) function.  It tests whether _wc_ is a wide character
           belonging to the wide-character class "graph".
    
           The wide-character class "graph" is a subclass of the wide-
           character class "print".
    
           Being a subclass of the wide-character class "print", the wide-
           character class "graph" is disjoint from the wide-character class
           "cntrl".
    
           The wide-character class "graph" is disjoint from the wide-
           character class "space" and therefore also disjoint from its
           subclass "blank".
    
           The wide-character class "graph" contains all the wide characters
           from the wide-character class "print" except the space character.
           It therefore contains the wide-character classes "alnum" and
           "punct".
    


## RETURN VALUE



           The **iswgraph**() function returns nonzero if _wc_ is a wide character
           belonging to the wide-character class "graph".  Otherwise, it
           returns zero.
    


## ATTRIBUTES



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


## STANDARDS



           C11, POSIX.1-2008.
    


## NOTES



           The behavior of **iswgraph**() depends on the **LC_CTYPE** category of the
           current locale.
    


* * *
# gnutls_psk_set_server_dh_params

## NAME



           gnutls_psk_set_server_dh_params - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void**
           **gnutls_psk_set_server_dh_params(gnutls_psk_server_credentials_t**
           _res_**, gnutls_dh_params_t** _dh_params_**);**
    


## ARGUMENTS



           gnutls_psk_server_credentials_t res
                       is a gnutls_psk_server_credentials_t type
    
           gnutls_dh_params_t dh_params
                       is a structure that holds Diffie-Hellman parameters.
    


## DESCRIPTION



           This function will set the Diffie-Hellman parameters for an
           anonymous server to use. These parameters will be used in
           Diffie-Hellman exchange with PSK cipher suites.
    


## DEPRECATED



           This function is unnecessary and discouraged on GnuTLS 3.6.0 or
           later. Since 3.6.0, DH parameters are negotiated following
           RFC7919.
    


* * *
# function::nsecs_to_string

## NAME



           function::nsecs_to_string - Human readable string for given
           nanoseconds
    


## SYNOPSIS



               nsecs_to_string:string(nsecs:long)
    


## ARGUMENTS



           _nsecs_
               Number of nanoseconds to translate.
    


## DESCRIPTION



           Returns a string representing the number of nanoseconds as a human
           readable string consisting of “XmY.ZZZZZZs”, where X is the number
           of minutes, Y is the number of seconds and ZZZZZZZZZ is the number
           of nanoseconds.
    


* * *
# mlx5dv_vfio_get_events_fd

## NAME



           mlx5dv_vfio_get_events_fd - Get the file descriptor to manage
           driver events.
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_vfio_get_events_fd(struct ibv_context *ctx);
    


## DESCRIPTION



           Returns the file descriptor to be used for managing driver events.
    


## ARGUMENTS



           _ctx_    device context that was opened for VFIO by calling
                  mlx5dv_get_vfio_device_list().
    


## RETURN VALUE



           Returns the internal matching file descriptor.
    


## NOTES



           Client code should poll the returned file descriptor and once
           there is some data to be managed immediately call
           _mlx5dv_vfio_process_events()_.
    


* * *
# gnutls_privkey_get_type

## NAME



           gnutls_privkey_get_type - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **gnutls_privkey_type_t gnutls_privkey_get_type(gnutls_privkey_t**
           _key_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       should contain a **gnutls_privkey_t** type
    


## DESCRIPTION



           This function will return the type of the private key. This is
           actually the type of the subsystem used to set this private key.
    


## RETURNS



           a member of the **gnutls_privkey_type_t** enumeration on success, or a
           negative error code on error.
    


## SINCE



           2.12.0
    


* * *
# gnutls_hmac

## NAME



           gnutls_hmac - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_hmac(gnutls_hmac_hd_t** _handle_**, const void ***_ptext_**,**
           **size_t** _ptext_len_**);**
    


## ARGUMENTS



           gnutls_hmac_hd_t handle
                       is a **gnutls_hmac_hd_t** type
    
           const void * ptext
                       the data to hash
    
           size_t ptext_len
                       the length of data to hash
    


## DESCRIPTION



           This function will hash the given data using the algorithm
           specified by the context.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           2.10.0
    


* * *
# gnutls_pkcs7_get_crl_raw

## NAME



           gnutls_pkcs7_get_crl_raw - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int gnutls_pkcs7_get_crl_raw(gnutls_pkcs7_t** _pkcs7_**, unsigned** _indx_**,**
           **void ***_crl_**, size_t ***_crl_size_**);**
    


## ARGUMENTS



           gnutls_pkcs7_t pkcs7
                       The pkcs7 type
    
           unsigned indx
                       contains the index of the crl to extract
    
           void * crl  the contents of the crl will be copied there (may be
                       null)
    
           size_t * crl_size
                       should hold the size of the crl
    


## DESCRIPTION



           This function will return a crl of the PKCS7 or RFC2630 crl set.
    


## RETURNS



           On success, **GNUTLS_E_SUCCESS**(0) is returned, otherwise a negative
           error value.  If the provided buffer is not long enough, then
           _crl_size_ is updated and **GNUTLS_E_SHORT_MEMORY_BUFFER** is returned.
           After the last crl has been read
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


* * *
# function::task_ns_egid

## NAME



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


## SYNOPSIS



               task_ns_egid:long(task:long)
    


## ARGUMENTS



           _task_
               task_struct pointer
    


## DESCRIPTION



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


* * *
# probe::staprun.remove_module

## NAME



           probe::staprun.remove_module - Removing SystemTap instrumentation
           module
    


## SYNOPSIS



           staprun.remove_module
    


## VALUES



           _name_
               the stap module name to be removed (without the .ko extension)
    


## DESCRIPTION



           Fires just before the call to remove the module.
    


* * *
# gnutls_privkey_init

## NAME



           gnutls_privkey_init - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_init(gnutls_privkey_t ***_key_**);**
    


## ARGUMENTS



           gnutls_privkey_t * key
                       A pointer to the type to be initialized
    


## DESCRIPTION



           This function will initialize a private key object. The object can
           be used to generate, import, and perform cryptographic operations
           on the associated private key.
    
           Note that when the underlying private key is a PKCS**11** key (i.e.,
           when imported with a PKCS**11** URI), the limitations of
           **gnutls_pkcs11_privkey_init()** apply to this object as well. In
           versions of GnuTLS later than 3.5.11 the object is protected using
           locks and a single **gnutls_privkey_t** can be re-used by many
           threads. However, for performance it is recommended to utilize one
           object per key per thread.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# function::get_sa_handler

## NAME



           function::get_sa_handler - Returns the numeric value of sa_handler
    


## SYNOPSIS



               get_sa_handler:long(act:long)
    


## ARGUMENTS



           _act_
               address of the sigaction to query.
    


* * *
# io_uring_prep_waitid

## NAME



           io_uring_prep_waitid - prepare a waitid request
    


## SYNOPSIS



           **#include <sys/wait.h>**
           **#include <liburing.h>**
    
           **void io_uring_prep_waitid(struct io_uring_sqe ***_sqe_**,**
                                     **idtype_t** _idtype_**,**
                                     **id_t** _id_**,**
                                     **siginfo_t ***_infop_**,**
                                     **int** _options_**,**
                                     **unsigned int** _flags_**);**
    


## DESCRIPTION



           The io_uring_prep_waitid(3) function prepares a waitid request.
           The submission queue entry _sqe_ is setup to use the _idtype_ and _id_
           arguments select the child(ren), and _options_ to specify the child
           state changes to wait for. Upon successful return, it fills _infop_
           with information of the child process, if any.  _flags_ is io_uring
           specific modifier flags. They are currently unused, and hence **0**
           should be passed.
    
           This function prepares an async waitid(2) request. See that man
           page for details.
    
           Available since kernel 6.7.
    


## RETURN VALUE



           None
    


## ERRORS



           The CQE _res_ field will contain the result of the operation. See
           the related man page for details on possible values. Note that
           where synchronous system calls will return **-1** on failure and set
           _errno_ to the actual error value, io_uring never uses _errno_.
           Instead it returns the negated _errno_ directly in the CQE _res_
           field.
    


* * *
# acl_get_entry

## NAME



           **acl_get_entry** — get an ACL entry
    


## LIBRARY



           Linux Access Control Lists library (libacl, -lacl).
    


## SYNOPSIS



           <_sys/types.h_ > <_sys/acl.h_ > _int_ **acl_get_entry**(_acl_t acl_ , _int_
           _entry_id_ , _acl_entry_t *entry_p_)
    


## DESCRIPTION



           The **acl_get_entry**() function obtains a descriptor for an ACL entry
           as specified by _entry_id_ within the ACL indicated by the argument
           _acl_.  If the value of _entry_id_ is ACL_FIRST_ENTRY, then the
           function returns in _entry_p_ a descriptor for the first ACL entry
           within _acl_.  If the value of _entry_id_ is ACL_NEXT_ENTRY, then the
           function returns in _entry_p_ a descriptor for the next ACL entry
           within _acl_.
    
           If a call is made to **acl_get_entry**() with _entry_id_ set to
           ACL_NEXT_ENTRY when there has not been either an initial
           successful call to **acl_get_entry**(), or a previous successful call
           to **acl_get_entry**() following a call to **acl_calc_mask**(),
           **acl_copy_int**(), **acl_create_entry**(), **acl_delete_entry**(), **acl_dup**(),
           **acl_from_text**(), **acl_get_fd**(), **acl_get_file**(), **acl_set_fd**(),
           **acl_set_file**(), or **acl_valid**(), then the effect is unspecified.
    
           Calls to **acl_get_entry**() do not modify any ACL entries. Subsequent
           operations using the returned ACL entry descriptor operate on the
           ACL entry within the ACL in working storage. The order of all
           existing entries in the ACL remains unchanged.  Any existing ACL
           entry descriptors that refer to entries within the ACL continue to
           refer to those entries. Any existing ACL pointers that refer to
           the ACL referred to by _acl_ continue to refer to the ACL.
    


## RETURN VALUE



           If the function successfully obtains an ACL entry, the function
           returns a value of **1**.  If the ACL has no ACL entries, the function
           returns the value **0**.  If the value of _entry_id_ is ACL_NEXT_ENTRY
           and the last ACL entry in the ACL has already been returned by a
           previous call to **acl_get_entry**(), the function returns the value **0**
           until a successful call with an _entry_id_ of ACL_FIRST_ENTRY is
           made. Otherwise, the value **-1** is returned and _errno_ is set to
           indicate the error.
    


## ERRORS



           If any of the following conditions occur, the **acl_get_entry**()
           function returns **-1** and sets _errno_ to the corresponding value:
    
           [EINVAL]           The argument _acl_p_ is not a valid pointer to an
                              ACL.
    
                              The argument _entry_id_ is neither ACL_NEXT_ENTRY
                              nor ACL_FIRST_ENTRY.
    


## STANDARDS



           IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)
    


* * *
# gnutls_pkcs7_print_signature_info

## NAME



           gnutls_pkcs7_print_signature_info - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs7.h>**
    
           **int**
           **gnutls_pkcs7_print_signature_info(gnutls_pkcs7_signature_info_st ***
           _info_**, gnutls_certificate_print_formats_t** _format_**, gnutls_datum_t ***
           _out_**);**
    


## ARGUMENTS



           gnutls_pkcs7_signature_info_st * info
                       The PKCS7 signature info struct to be printed
    
           gnutls_certificate_print_formats_t format
                       Indicate the format to use
    
           gnutls_datum_t * out
                       Newly allocated datum with null terminated string.
    


## DESCRIPTION



           This function will pretty print a PKCS **7** signature info structure,
           suitable for display to a human.
    
           Currently the supported formats are **GNUTLS_CRT_PRINT_FULL** and
           **GNUTLS_CRT_PRINT_COMPACT**.
    
           The output  _out_ needs to be deallocated using **gnutls_free()**.
    


## RETURNS



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


## SINCE



           3.6.14
    


* * *
# pthread_mutexattr_setprioceiling

## 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_mutexattr_setprioceiling — set the prioceiling attribute
           of the mutex attributes object (**REALTIME THREADS**)
    


## SYNOPSIS



           #include <pthread.h>
    
           int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *_attr_ ,
               int _prioceiling_);
    


## DESCRIPTION



           Refer to pthread_mutexattr_getprioceiling(3p).
    


* * *
# form_hook

## NAME



           **form_hook** - set hooks for automatic invocation by applications
    


## SYNOPSIS



           **#include <form.h>**
    
           **int set_field_init(FORM ***_form_**, Form_Hook** _func_**);**
           **Form_Hook field_init(const FORM ***_form_**);**
    
           **int set_field_term(FORM ***_form_**, Form_Hook** _func_**);**
           **Form_Hook field_term(const FORM ***_form_**);**
    
           **int set_form_init(FORM ***_form_**, Form_Hook** _func_**);**
           **Form_Hook form_init(const FORM ***_form_**);**
    
           **int set_form_term(FORM ***_form_**, Form_Hook** _func_**);**
           **Form_Hook form_term(const FORM ***_form_**);**
    


## DESCRIPTION



           These functions make it possible to set hook functions to be
           called at various points in the automatic processing of input
           event codes by **form_driver**.
    
           The function **set_field_init** sets a hook to be called at form-post
           time and each time the selected field changes (after the change).
           **field_init** returns the current field init hook, if any (**NULL** if
           there is no such hook).
    
           The function **set_field_term** sets a hook to be called at form-
           unpost time and each time the selected field changes (before the
           change).  **field_term** returns the current field term hook, if any
           (**NULL** if there is no such hook).
    
           The function **set_form_init** sets a hook to be called at form-post
           time and just after a page change once it is posted.  **form_init**
           returns the current form init hook, if any (**NULL** if there is no
           such hook).
    
           The function **set_form_term** sets a hook to be called at form-unpost
           time and just before a page change once it is posted.  **form_init**
           returns the current form term hook, if any (**NULL** if there is no
           such hook).
    


## RETURN VALUE



           Routines that return pointers return **NULL** on error.  Other
           routines return one of the following:
    
           **E_OK** The routine succeeded.
    
           **E_SYSTEM_ERROR**
                System error occurred (see errno(3)).
    


## NOTES



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


## PORTABILITY



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


* * *
# pcap_set_protocol_linux

## NAME



           pcap_set_protocol_linux - set capture protocol for a not-yet-
           activated capture handle
    


## SYNOPSIS



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


## DESCRIPTION



           On network interface devices on Linux, **pcap_set_protocol_linux**()
           sets the protocol to be used in the socket(2) call to create a
           capture socket when the handle is activated.  The argument is a
           link-layer protocol value, such as the values in the
           **< linux/if_ether.h> **header file, specified in host byte order.  If
           _protocol_ is non-zero, packets of that protocol will be captured
           when the handle is activated, otherwise, all packets will be
           captured.  This function is only provided on Linux, and, if it is
           used on any device other than a network interface, it will have no
           effect.
    
           It should not be used in portable code; instead, a filter should
           be specified with **pcap_setfilter**(3PCAP).
    
           If a given network interface provides a standard link-layer
           header, with a standard packet type, but provides some packet
           types with a different socket-layer protocol type from the one in
           the link-layer header, that packet type cannot be filtered with a
           filter specified with **pcap_setfilter**() but can be filtered by
           specifying the socket-layer protocol type using
           **pcap_set_protocol_linux**().
    


## RETURN VALUE



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


## BACKWARD COMPATIBILITY



           This function became available in libpcap release 1.9.0.
    


* * *
# function::set_kernel_char

## NAME



           function::set_kernel_char - Writes a char value to kernel memory
    


## SYNOPSIS



               set_kernel_char(addr:long,val:long)
    


## ARGUMENTS



           _addr_
               The kernel address to write the char to
    
           _val_
               The char which is to be written
    


## DESCRIPTION



           Writes the char value to a given kernel memory address. Reports an
           error when writing to the given address fails. Requires the use of
           guru mode (-g).
    


* * *
# uuid

## NAME



           uuid - DCE compatible Universally Unique Identifier library
    


## SYNOPSIS



           **#include <uuid.h>**
    


## DESCRIPTION



           The UUID library is used to generate unique identifiers for
           objects that may be accessible beyond the local system. This
           library generates UUIDs compatible with those created by the Open
           Software Foundation (OSF) Distributed Computing Environment (DCE)
           utility uuidgen(1).
    
           The UUIDs generated by this library can be reasonably expected to
           be unique within a system, and unique across all systems. They
           could be used, for instance, to generate unique HTTP cookies
           across multiple web servers without communication between the
           servers, and without fear of a name clash.
    


## CONFORMING TO



           This library generates UUIDs compatible with OSF DCE 1.1, and hash
           based UUIDs V3 and V5 compatible with RFC-4122
           <https://tools.ietf.org/html/rfc4122>.
    


## 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_(3)
    


* * *
# ftok

## NAME



           ftok - convert a pathname and a project identifier to a System V
           IPC key
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <sys/ipc.h>**
    
           **key_t ftok(const char ***_path_**, int** _proj_id_**);**
    


## DESCRIPTION



           The **ftok**() function uses the identity of the file named by the
           given _path_ (which must refer to an existing, accessible file) and
           the least significant 8 bits of _proj_id_ (which must be nonzero) to
           generate a _key_t_ type System V IPC key, suitable for use with
           msgget(2), semget(2), or shmget(2).
    
           The resulting value is the same for all pathnames that name the
           same file, when the same value of _proj_id_ is used.  The value
           returned should be different when the (simultaneously existing)
           files or the project IDs differ.
    


## RETURN VALUE



           On success, the generated _key_t_ value is returned.  On failure -1
           is returned, with _errno_ indicating the error as for the stat(2)
           system call.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           On some ancient systems, the prototype was:
    
               **key_t ftok(char ***_path_**, char** _proj_id_**);**
    
           Today, _proj_id_ is an _int_ , but still only 8 bits are used.  Typical
           usage has an ASCII character _proj_id_ , that is why the behavior is
           said to be undefined when _proj_id_ is zero.
    
           Of course, no guarantee can be given that the resulting _key_t_ is
           unique.  Typically, a best-effort attempt combines the given
           _proj_id_ byte, the lower 16 bits of the inode number, and the lower
           8 bits of the device number into a 32-bit result.  Collisions may
           easily happen, for example between files on _/dev/hda1_ and files on
           _/dev/sda1_.
    


## EXAMPLES



           See semget(2).
    


* * *
# capng_name_to_capability

## NAME



           capng_name_to_capability - convert capability text to integer
    


## SYNOPSIS



           **#include <cap-ng.h>**
    
           int capng_name_to_capability(const char *name);
    


## DESCRIPTION



           capng_name_to_capability will take the string being passed and
           look it up to see what its integer value would be. The string
           being input is the same name as the define in linux/capability.h
           with the CAP_ prefix removed. The string case does not matter. The
           integer that is output is the same as the define would be from
           linux/capability.h. This is useful for taking string input and
           converting to something that can be used with capng_update.
    


## RETURN VALUE



           This returns a negative number on failure and the correct define
           otherwise.
    


* * *
# pcap_free_tstamp_types

## NAME



           pcap_list_tstamp_types, pcap_free_tstamp_types - get a list of
           time stamp types supported by a capture device, and free that list
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_list_tstamp_types(pcap_t *p, int **tstamp_typesp);**
           **void pcap_free_tstamp_types(int *tstamp_types);**
    


## DESCRIPTION



           **pcap_list_tstamp_types**() is used to get a list of the supported
           time stamp types of the interface associated with the pcap
           descriptor.  **pcap_list_tstamp_types**() allocates an array to hold
           the list and sets _*tstamp_typesp_ to point to the array.  See
           pcap-tstamp(7) for a list of all the time stamp types.
    
           The caller is responsible for freeing the array with
           **pcap_free_tstamp_types**(), which frees the list pointed to by
           _tstamp_types_.
    


## RETURN VALUE



           **pcap_list_tstamp_types**() returns the number of time stamp types in
           the array on success and **PCAP_ERROR** on failure.  A return value of
           one means that the only time stamp type supported is the one in
           the list, which is the capture device's default time stamp type.
           A return value of zero means that the only time stamp type
           supported is **PCAP_TSTAMP_HOST** , which is the capture device's
           default time stamp type (only older versions of libpcap will
           return that; newer versions will always return one or more types).
           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.
    


## BACKWARD COMPATIBILITY



           These functions 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.
    


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


* * *
# gnutls_pubkey_get_openpgp_key_id

## NAME



           gnutls_pubkey_get_openpgp_key_id - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_get_openpgp_key_id(gnutls_pubkey_t** _key_**, unsigned**
           **int** _flags_**, unsigned char ***_output_data_**, size_t ***_output_data_size_**,**
           **unsigned int ***_subkey_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       Holds the public key
    
           unsigned int flags
                       should be one of the flags from **gnutls_keyid_flags_t**
    
           unsigned char * output_data
                       will contain the key ID
    
           size_t * output_data_size
                       holds the size of output_data (and will be replaced by
                       the actual size of parameters)
    
           unsigned int * subkey
                       ignored
    


## DESCRIPTION



           This function is no-op.
    


## RETURNS



           **GNUTLS_E_UNIMPLEMENTED_FEATURE**.
    


## SINCE



           2.12.0
    


* * *
# libpfm_arm_neoverse_n2

## NAME



           libpfm_arm_neoverse_n2 - support for ARM Neoverse N2 core PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: arm_n2**
           **PMU desc: ARM Neoverse N2**
    


## DESCRIPTION



           The library supports the ARM Neoverse N2 core PMU.
    
           This PMU supports 6 counters and privilege levels filtering.  It
           can operate in both 32 and 64 bit modes.
    


## MODIFIERS



           The following modifiers are supported on ARM Neoverse N2:
    
           **u** Measure at the user level. This corresponds to **PFM_PLM3**.
                  This is a boolean modifier.
    
           **k** Measure at the kernel level. This corresponds to **PFM_PLM0**.
                  This is a boolean modifier.
    
           **hv** Measure at the hypervisor level. This corresponds to
                  **PFM_PLMH**.  This is a boolean modifier.
    


* * *
# lfind

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



           lfind — find entry in a linear search table
    


## SYNOPSIS



           #include <search.h>
    
           void *lfind(const void *_key_ , const void *_base_ , size_t *_nelp_ ,
               size_t _width_ , int (*_compar_)(const void *, const void *));
    


## DESCRIPTION



           Refer to lsearch(3p).
    


* * *
# uuid_copy

## NAME



           uuid_copy - copy a UUID value
    


## SYNOPSIS



           **#include <uuid.h>**
    
           **void uuid_copy(uuid_t** _dst_**, const uuid_t** _src_**);**
    


## DESCRIPTION



           The **uuid_copy**() function copies the UUID variable _src_ to _dst_.
    


## RETURN VALUE



           The copied UUID is returned in the location pointed to by _dst_.
    


## 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_COPY_(3)
    


* * *