tripathysagar/man_text huggingface dataset:
# gnutls_psk_set_client_credentials

## NAME



           gnutls_psk_set_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_psk_set_client_credentials(gnutls_psk_client_credentials_t**
           _res_**, const char ***_username_**, const gnutls_datum_t ***_key_**,**
           **gnutls_psk_key_flags** _flags_**);**
    


## ARGUMENTS



           gnutls_psk_client_credentials_t res
                       is a **gnutls_psk_client_credentials_t** type.
    
           const char * username
                       is the user's zero-terminated userid
    
           const gnutls_datum_t * key
                       is the user's key
    
           gnutls_psk_key_flags flags
                       indicate the format of the key, either
                       **GNUTLS_PSK_KEY_RAW** or **GNUTLS_PSK_KEY_HEX**.
    


## DESCRIPTION



           This function sets the username and password, in a
           gnutls_psk_client_credentials_t type.  Those will be used in PSK
           authentication.   _username_ should be an ASCII string or UTF-8
           string. In case of a UTF-8 string it is recommended to be
           following the PRECIS framework for usernames (rfc8265). The key
           can be either in raw byte format or in Hex format (without the 0x
           prefix).
    


## RETURNS



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


* * *
# snprintf

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



           snprintf — print formatted output
    


## SYNOPSIS



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


## DESCRIPTION



           Refer to fprintf(3p).
    


* * *
# acl_error

## NAME



           **acl_error** — convert an ACL error code to a text message
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _const char *_ **acl_error**(_int code_)
    


## DESCRIPTION



           The **acl_error**() function converts an ACL error code such as
           returned by the **acl_check**() function to a text message describing
           the error condition. In the “POSIX” locale, **acl_check**() returns
           the following descriptions for the error codes.
    
           ACL_MULTI_ERROR       “Multiple entries”
    
           ACL_DUPLICATE_ERROR   “Duplicate entries”
    
           ACL_MISS_ERROR        “Missing or wrong entry”
    
           ACL_ENTRY_ERROR       “Invalid entry type”
    


## RETURN VALUE



           The **acl_error**() function returns a text message if the error code
           is recognized, and a value of **(const char *)NULL** otherwise.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# gnutls_record_get_direction

## NAME



           gnutls_record_get_direction - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_record_get_direction(gnutls_session_t** _session_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    


## DESCRIPTION



           This function is useful to determine whether a GnuTLS function was
           interrupted while sending or receiving, so that **select()** or **poll()**
           may be called appropriately.
    
           It provides information about the internals of the record protocol
           and is only useful if a prior gnutls function call, e.g.
           **gnutls_handshake()** , was interrupted and returned
           **GNUTLS_E_INTERRUPTED** or **GNUTLS_E_AGAIN**. After such an interrupt
           applications may call **select()** or **poll()** before restoring the
           interrupted GnuTLS function.
    
           This function's output is unreliable if you are using the same
            _session_ in different threads for sending and receiving.
    


## RETURNS



           0 if interrupted while trying to read data, or 1 while trying to
           write data.
    


* * *
# function::sock_prot_str2num

## NAME



           function::sock_prot_str2num - Given a protocol name (string),
           return the corresponding protocol number
    


## SYNOPSIS



               sock_prot_str2num:long(proto:string)
    


## ARGUMENTS



           _proto_
               The protocol name
    


* * *
# function::set_s64_arg

## NAME



           function::set_s64_arg - Set function argument as signed 64-bit
           value
    


## SYNOPSIS



               set_s64_arg(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the signed 64-bit value of argument n, same as longlong_arg.
    


* * *
# mlx5dv_get_data_direct_sysfs_path

## NAME



           mlx5dv_get_data_direct_sysfs_path - Get the sysfs path of a data
           direct device
    


## SYNOPSIS



                  #include <infiniband/mlx5dv.h>
    
                  int mlx5dv_get_data_direct_sysfs_path(struct ibv_context *context, char *buf,
                                                        size_t buf_len)
    


## DESCRIPTION



           Get the sysfs path of the data direct device that is associated
           with the given _context_.
    
           This lets an application to discover whether/which data direct
           device is associated with the given _context_.
    


## ARGUMENTS



           _context_
                  RDMA device context to work on.
    
           _buf_    The buffer where to place the sysfs path of the associated
                  data direct device.
    
           _buf_len_
    
                  The length of the buffer.
    


## RETURN VALUE



           Upon success 0 is returned or the value of errno on a failure.
    


## ERRORS



           The below specific error values should be considered.
    
           ENODEV
    
                  There is no associated data direct device for the given *context*.
    
           ENOSPC
    
                  The input buffer size is too small to hold the full sysfs path.
    


## NOTES



           Upon succees, the caller should add the /sys/ prefix to get the
           full sysfs path.
    


* * *
# isless

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



           isless — test if x is less than y
    


## SYNOPSIS



           #include <math.h>
    
           int isless(real-floating _x_ , real-floating _y_);
    


## DESCRIPTION



           The functionality described on this reference page is aligned with
           the ISO C standard. Any conflict between the requirements
           described here and the ISO C standard is unintentional. This
           volume of POSIX.1‐2017 defers to the ISO C standard.
    
           The _isless_() macro shall determine whether its first argument is
           less than its second argument. The value of _isless_(_x_ , _y_) shall be
           equal to (_x_) < (_y_); however, unlike (_x_) < (_y_), _isless_(_x_ , _y_) shall
           not raise the invalid floating-point exception when _x_ and _y_ are
           unordered.
    


## RETURN VALUE



           Upon successful completion, the _isless_() macro shall return the
           value of (_x_) < (_y_).
    
           If _x_ or _y_ is NaN, 0 shall be returned.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           The relational and equality operators support the usual
           mathematical relationships between numeric values. For any ordered
           pair of numeric values, exactly one of the relationships (less,
           greater, and equal) is true. Relational operators may raise the
           invalid floating-point exception when argument values are NaNs.
           For a NaN and a numeric value, or for two NaNs, just the unordered
           relationship is true. This macro is a quiet (non-floating-point
           exception raising) version of a relational operator. It
           facilitates writing efficient code that accounts for NaNs without
           suffering the invalid floating-point exception. In the SYNOPSIS
           section, **real-floating** indicates that the argument shall be an
           expression of **real-floating** type.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# acl_equiv_mode

## NAME



           **acl_equiv_mode** — check for an equivalent ACL
    


## LIBRARY



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


## SYNOPSIS



           <_sys/types.h_ > <_acl/libacl.h_ > _int_ **acl_equiv_mode**(_acl_t acl_ , _mode_t_
           _*mode_p_)
    


## DESCRIPTION



           The **acl_equiv_mode**() function checks if the ACL pointed to by the
           argument _acl_ contains only the required ACL entries of tag types
           ACL_USER_OBJ, ACL_GROUP_OBJ, and ACL_OTHER, and contains no
           permissions other that ACL_READ, ACL_WRITE or ACL_EXECUTE.  If the
           ACL has this form, it can can be fully represented with the
           traditional file permission bits, and is considered equivalent
           with the traditional file permission bits.
    
           If _acl_ is an equivalent ACL and the pointer _mode_p_ is not **NULL** ,
           the value pointed to by _mode_p_ is set to the value that defines
           the same owner, group and other permissions as contained in the
           ACL.
    


## RETURN VALUE



           On success, this function returns the value **0** if _acl_ is an
           equivalent ACL, and the value **1** if _acl_ is not an equivalent ACL.
           On error, the value **-1** is returned, and _errno_ is set
           appropriately.
    


## ERRORS



           If any of the following conditions occur, the **acl_equiv_mode**()
           function returns the value **-1** and sets _errno_ to the corresponding
           value:
    
           [EINVAL]           The argument _acl_ is not a valid pointer to an
                              ACL.
    


## STANDARDS



           This is a non-portable, Linux specific extension to the ACL
           manipulation functions defined in IEEE Std 1003.1e draft 17
           (“POSIX.1e”, abandoned).
    


* * *
# gnutls_x509_ext_export_proxy

## NAME



           gnutls_x509_ext_export_proxy - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_ext_export_proxy(int** _pathLenConstraint_**, const char**
           *****_policyLanguage_**, const char ***_policy_**, size_t** _sizeof_policy_**,**
           **gnutls_datum_t ***_ext_**);**
    


## ARGUMENTS



           int pathLenConstraint
                       A negative value will remove the path length
                       constraint, while non-negative values will be set as
                       the length of the pathLenConstraints field.
    
           const char * policyLanguage
                       OID describing the language of  _policy_ .
    
           const char * policy
                       uint8_t byte array with policy language, can be **NULL**
    
           size_t sizeof_policy
                       size of  _policy_ .
    
           gnutls_datum_t * ext
                       The DER-encoded extension data; must be freed using
                       **gnutls_free()**.
    


## DESCRIPTION



           This function will convert the parameters provided to a
           proxyCertInfo extension.
    
           The  _ext_ data will be allocated using **gnutls_malloc()**.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# sd_bus_message_sensitive

## NAME



           sd_bus_message_sensitive - Mark a message object as containing
           sensitive data
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_message_sensitive(sd_bus_message ***_message_**);**
    


## DESCRIPTION



           **sd_bus_message_sensitive()** marks an allocated bus message as
           containing sensitive data. This ensures that the message data is
           carefully removed from memory (specifically, overwritten with zero
           bytes) when released. It is recommended to mark all incoming and
           outgoing messages like this that contain security credentials and
           similar data that should be dealt with carefully. Note that it is
           not possible to unmark messages like this, it is a one way
           operation. If a message is already marked sensitive and then
           marked sensitive a second time the message remains marked so and
           no further operation is executed.
    
           As a safety precaution all messages that are created as reply to
           messages that are marked sensitive are also implicitly marked so.
    


## RETURN VALUE



           On success, this functions return 0 or a positive integer. On
           failure, it returns a negative errno-style error code.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               The _message_ parameter is **NULL**.
    
               Added in version 245.
    


## NOTES



           Functions described here are available as a shared library, which
           can be compiled against and linked to with the
           **libsystemd pkg-config**(1) file.
    
           The code described here uses getenv(3), which is declared to be
           not multi-thread-safe. This means that the code calling the
           functions described here must not call setenv(3) from a parallel
           thread. It is recommended to only do calls to **setenv()** from an
           early phase of the program when no other threads have been
           started.
    


* * *
# gnutls_fips140_set_mode

## NAME



           gnutls_fips140_set_mode - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_fips140_set_mode(gnutls_fips_mode_t** _mode_**, unsigned**
           _flags_**);**
    


## ARGUMENTS



           gnutls_fips_mode_t mode
                       the FIPS140-2 mode to switch to
    
           unsigned flags
                       should be zero or **GNUTLS_FIPS140_SET_MODE_THREAD**
    


## DESCRIPTION



           That function is not thread-safe when changing the mode with no
           flags (globally), and should be called prior to creating any
           threads. Its behavior with no flags after threads are created is
           undefined.
    
           When the flag **GNUTLS_FIPS140_SET_MODE_THREAD** is specified then
           this call will change the FIPS140-2 mode for this particular
           thread and not for the whole process. That way an application can
           utilize this function to set and reset mode for specific
           operations.
    
           This function never fails but will be a no-op if used when the
           library is not in FIPS140-2 mode. When asked to switch to unknown
           values for  _mode_ or to **GNUTLS_FIPS140_SELFTESTS** mode, the library
           switches to **GNUTLS_FIPS140_STRICT** mode.
    


## SINCE



           3.6.2
    


* * *
# gnutls_x509_crt_set_ca_status

## NAME



           gnutls_x509_crt_set_ca_status - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_ca_status(gnutls_x509_crt_t** _crt_**, unsigned**
           **int** _ca_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           unsigned int ca
                       true(1) or false(0). Depending on the Certificate
                       authority status.
    


## DESCRIPTION



           This function will set the basicConstraints certificate extension.
           Use **gnutls_x509_crt_set_basic_constraints()** if you want to control
           the pathLenConstraint field too.
    


## RETURNS



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


* * *
# ibv_event_type_str

## NAME



           ibv_event_type_str - Return string describing event_type enum
           value
    
           ibv_node_type_str - Return string describing node_type enum value
    
           ibv_port_state_str - Return string describing port_state enum
           value
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  const char *ibv_event_type_str(enum ibv_event_type event_type);
    
                  const char *ibv_node_type_str(enum ibv_node_type node_type);
    
                  const char *ibv_port_state_str(enum ibv_port_state port_state);
    


## DESCRIPTION



           **ibv_node_type_str()** returns a string describing the node type enum
           value _node_type_.
    
           **ibv_port_state_str()** returns a string describing the port state
           enum value _port_state_.
    
           **ibv_event_type_str()** returns a string describing the event type
           enum value _event_type_.
    


## RETURN VALUE



           These functions return a constant string that describes the enum
           value passed as their argument.
    


* * *
# gnutls_x509_name_constraints_init

## NAME



           gnutls_x509_name_constraints_init - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int**
           **gnutls_x509_name_constraints_init(gnutls_x509_name_constraints_t ***
           _nc_**);**
    


## ARGUMENTS



           gnutls_x509_name_constraints_t * nc
                       The nameconstraints
    


## DESCRIPTION



           This function will initialize a name constraints type.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# tracefs_set_loglevel

## NAME



           tracefs_set_loglevel - Set log level of the library
    


## SYNOPSIS



           **#include <tracefs.h>**
    
           int **tracefs_set_loglevel**(enum tep_loglevel _level_);
    


## DESCRIPTION



           The **tracefs_set_loglevel()** function sets the level of the library
           logs that will be printed on the console. See libtraceevent(3) for
           detailed description of the log levels. Setting the log level to
           specific value means that logs from the previous levels will be
           printed too. For example _TEP_LOG_WARNING_ will print any logs with
           severity _TEP_LOG_WARNING_ , _TEP_LOG_ERROR_ and _TEP_LOG_CRITICAL_. The
           default log level is _TEP_LOG_CRITICAL_. When a new level is set, it
           is also propagated to the libtraceevent.
    


## EXAMPLE



               #include <tracefs.h>
    
               tracefs_set_loglevel(TEP_LOG_ALL);
               ...
               /* call libtracefs or libtraceevent APIs and observe any logs they produce */
               ...
               tracefs_set_loglevel(TEP_LOG_CRITICAL);
    


## FILES



               **tracefs.h**
                       Header file to include in order to have access to the library APIs.
               **-ltracefs**
                       Linker switch to add when building a program that uses the library.
    


## LICENSE



           libtracefs is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



           **https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/ **
    


## COPYING



           Copyright (C) 2021 VMware, Inc. Free use of this software is
           granted under the terms of the GNU Public License (GPL).
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    
            2. tz.stoyanov@gmail.com
               mailto:tz.stoyanov@gmail.com
    
            3. linux-trace-devel@vger.kernel.org
               mailto:linux-trace-devel@vger.kernel.org
    


* * *
# tapset::ipmib

## NAME



           tapset::ipmib - systemtap ipmib tapset
    


## DESCRIPTION



           **ipmib_remote_addr**
                  Get the remote ip address
    
                  See function::ipmib_remote_addr(3stap)
                   for details.
    
           **ipmib_local_addr**
                  Get the local ip address
    
                  See function::ipmib_local_addr(3stap)
                   for details.
    
           **ipmib_tcp_remote_port**
                  Get the remote tcp port
    
                  See function::ipmib_tcp_remote_port(3stap)
                   for details.
    
           **ipmib_tcp_local_port**
                  Get the local tcp port
    
                  See function::ipmib_tcp_local_port(3stap)
                   for details.
    
           **ipmib_get_proto**
                  Get the protocol value
    
                  See function::ipmib_get_proto(3stap)
                   for details.
    
           **ipmib.InReceives**
                  Count an arriving packet
    
                   See probe::ipmib.InReceives(3stap)
                   for details.
    
           **ipmib.InNoRoutes**
                  Count an arriving packet with no matching socket
    
                   See probe::ipmib.InNoRoutes(3stap)
                   for details.
    
           **ipmib.InAddrErrors**
                  Count arriving packets with an incorrect address
    
                   See probe::ipmib.InAddrErrors(3stap)
                   for details.
    
           **ipmib.InUnknownProtos**
                  Count arriving packets with an unbound proto
    
                   See probe::ipmib.InUnknownProtos(3stap)
                   for details.
    
           **ipmib.InDiscards**
                  Count discarded inbound packets
    
                   See probe::ipmib.InDiscards(3stap)
                   for details.
    
           **ipmib.ForwDatagrams**
                  Count forwarded packet
    
                   See probe::ipmib.ForwDatagrams(3stap)
                   for details.
    
           **ipmib.OutRequests**
                  Count a request to send a packet
    
                   See probe::ipmib.OutRequests(3stap)
                   for details.
    
           **ipmib.ReasmTimeout**
                  Count Reassembly Timeouts
    
                   See probe::ipmib.ReasmTimeout(3stap)
                   for details.
    
           **ipmib.ReasmReqds**
                  Count number of packet fragments reassembly requests
    
                   See probe::ipmib.ReasmReqds(3stap)
                   for details.
    
           **ipmib.FragOKs**
                  Count datagram fragmented successfully
    
                   See probe::ipmib.FragOKs(3stap)
                   for details.
    
           **ipmib.FragFails**
                  Count datagram fragmented unsuccessfully
    
                   See probe::ipmib.FragFails(3stap)
                   for details.
    


* * *
# function::json_set_prefix

## NAME



           function::json_set_prefix - Set the metric prefix.
    


## SYNOPSIS



               json_set_prefix:long(prefix:string)
    


## ARGUMENTS



           _prefix_
               The prefix name to be used.
    


## DESCRIPTION



           This function sets the “prefix”, which is the name of the base of
           the metric hierarchy. Calling this function is optional, by
           default the name of the systemtap module is used.
    


* * *
# gnutls_db_set_ptr

## NAME



           gnutls_db_set_ptr - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **void gnutls_db_set_ptr(gnutls_session_t** _session_**, void ***_ptr_**);**
    


## ARGUMENTS



           gnutls_session_t session
                       is a **gnutls_session_t** type.
    
           void * ptr  is the pointer
    


## DESCRIPTION



           Sets the pointer that will be provided to db store, retrieve and
           delete functions, as the first argument.
    


* * *
# gnutls_x509_crt_set_name_constraints

## NAME



           gnutls_x509_crt_set_name_constraints - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_name_constraints(gnutls_x509_crt_t** _crt_**,**
           **gnutls_x509_name_constraints_t** _nc_**, unsigned int** _critical_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       The certificate
    
           gnutls_x509_name_constraints_t nc
                       The nameconstraints structure
    
           unsigned int critical
                       whether this extension will be critical
    


## DESCRIPTION



           This function will set the provided name constraints to the
           certificate extension list. This extension is always marked as
           critical.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# gnutls_x509_crt_set_inhibit_anypolicy

## NAME



           gnutls_x509_crt_set_inhibit_anypolicy - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crt_set_inhibit_anypolicy(gnutls_x509_crt_t** _crt_**,**
           **unsigned int** _skipcerts_**);**
    


## ARGUMENTS



           gnutls_x509_crt_t crt
                       a certificate of type **gnutls_x509_crt_t**
    
           unsigned int skipcerts
                       number of certificates after which anypolicy is no
                       longer acceptable.
    


## DESCRIPTION



           This function will set the Inhibit anyPolicy certificate
           extension.
    


## RETURNS



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


* * *
# efadv_query_ah

## NAME



           efadv_query_ah - Query EFA specific Address Handle attributes
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  int efadv_query_ah(struct ibv_ah *ibvah, struct efadv_ah_attr *attr,
                             uint32_t inlen);
    


## DESCRIPTION



           **efadv_query_ah()** queries device-specific Address Handle
           attributes.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_ah_attr {
                      uint64_t comp_mask;
                      uint16_t ahn;
                      uint8_t reserved[6];
                  };
    
           _inlen_  In: Size of struct efadv_ah_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _ahn_    Device’s Address Handle number.
    


## RETURN VALUE



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


## NOTES



           • Compatibility mask (comp_mask) is an out field and currently has
             no values.
    


* * *
# timer_t

## NAME



           timer_t - timer ID
    


## LIBRARY



           Standard C library (_libc_)
    


## SYNOPSIS



           **#include <sys/types.h>**
    
           **typedef** /* ... */  **timer_t;**
    


## DESCRIPTION



           Used for timer ID returned by timer_create(2).
    


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The following header also provides _timer_t_ : _< time.h>_.
    


* * *
# openlog

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



           openlog — open a connection to the logging facility
    


## SYNOPSIS



           #include <syslog.h>
    
           void openlog(const char *_ident_ , int _logopt_ , int _facility_);
    


## DESCRIPTION



           Refer to closelog(3p).
    


* * *
# ibv_modify_srq

## NAME



           ibv_modify_srq - modify attributes of a shared receive queue (SRQ)
    


## SYNOPSIS



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


## DESCRIPTION



           **ibv_modify_srq()** modifies the attributes of SRQ _srq_ with the
           attributes in _srq_attr_ according to the mask _srq_attr_mask_.  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;     /* number of scatter elements per WR (irrelevant for ibv_modify_srq) */
                   uint32_t                srq_limit;   /* the limit value of the SRQ */
           };
    
           The argument _srq_attr_mask_ specifies the SRQ attributes to be
           modified.  The argument is either 0 or the bitwise OR of one or
           more of the following flags:
    
           **IBV_SRQ_MAX_WR** Resize the SRQ
    
           **IBV_SRQ_LIMIT** Set the SRQ limit
    


## RETURN VALUE



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


## NOTES



           If any of the modify attributes is invalid, none of the attributes
           will be modified.
    
           Not all devices support resizing SRQs.  To check if a device
           supports it, check if the **IBV_DEVICE_SRQ_RESIZE** bit is set in the
           device capabilities flags.
    
           Modifying the srq_limit arms the SRQ to produce an
           **IBV_EVENT_SRQ_LIMIT_REACHED** "low watermark" asynchronous event
           once the number of WRs in the SRQ drops below srq_limit.
    


* * *
# rdma_migrate_id

## NAME



           rdma_migrate_id - Move a communication identifier to a different
           event channel.
    


## SYNOPSIS



           **#include <rdma/rdma_cma.h>**
    
           **int rdma_migrate_id (struct rdma_cm_id ***_id_**, struct**
           **rdma_event_channel ***_channel_**);**
    


## ARGUMENTS



           id          An existing communication identifier to migrate.
    
           channel     The communication channel that events associated with
                       the allocated rdma_cm_id will be reported on.  May be
                       NULL.
    


## DESCRIPTION



           Migrates a communication identifier to a different event channel.
    


## RETURN VALUE



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


## NOTES



           This routine migrates a communication identifier to the specified
           event channel and moves any pending events associated with the
           rdma_cm_id to the new channel.  Users should not poll for events
           on the rdma_cm_id's current event channel or invoke other routines
           on the rdma_cm_id while migrating between channels.  This call
           will block while there are any unacknowledged events on the
           current event channel.
    
           If the channel parameter is NULL, the specified rdma_cm_id will be
           placed into synchronous operation mode.  All calls on the id will
           block until the operation completes.
    


* * *
# io_uring_prep_getxattr

## NAME



           io_uring_prep_getxattr, io_uring_prep_fgetxattr - prepare a
           request to get an extended attribute value
    


## SYNOPSIS



           **#include <liburing.h>**
    
           **void io_uring_prep_getxattr(struct io_uring_sqe ***_sqe_**,**
                                       **const char ***_name_**,**
                                       **char ***_value_**,**
                                       **const char ***_path_**,**
                                       **unsigned int** _len_**);**
    
           **void io_uring_prep_fgetxattr(struct io_uring_sqe ***_sqe_**,**
                                        **int** _fd_**,**
                                        **const char ***_name_**,**
                                        **char ***_value_**,**
                                        **unsigned int** _len_**);**
    


## DESCRIPTION



           The io_uring_prep_getxattr(3) function prepares a request to get
           an extended attribute value. The submission queue entry _sqe_ is
           setup to get the _value_ of the extended attribute identified by
           _name_ and associated with the given _path_ in the filesystem.  The
           _len_ argument specifies the size (in bytes) of _value_.
    
           io_uring_prep_fgetxattr(3) is identical to
           io_uring_prep_getxattr(3), only the open file referred to by _fd_ is
           interrogated in place of _path_.
    
           This function prepares an async getxattr(2) request. See that man
           page for details.
    


## RETURN VALUE



           None
    


* * *
# probe::nfsd.dispatch

## NAME



           probe::nfsd.dispatch - NFS server receives an operation from
           client
    


## SYNOPSIS



           nfsd.dispatch
    


## VALUES



           _version_
               nfs version
    
           _client_ip_
               the ip address of client
    
           _prog_
               program number
    
           _proto_
               transfer protocol
    
           _xid_
               transmission id
    
           _proc_
               procedure number
    


* * *
# function::fp_mul

## NAME



           function::fp_mul - Multiplication between floating points
    


## SYNOPSIS



               fp_mul:long(mul1:long,mul2:long)
    


## ARGUMENTS



           _mul1_
               the 64 bit floating point multiplicand
    
           _mul2_
               64 bit floating point multiplier
    


## DESCRIPTION



           result is multiplicand times multiplier
    


* * *
# gnutls_x509_aki_set_cert_issuer

## NAME



           gnutls_x509_aki_set_cert_issuer - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aki_set_cert_issuer(gnutls_x509_aki_t** _aki_**,**
           **unsigned int** _san_type_**, const gnutls_datum_t ***_san_**, const char ***
           _othername_oid_**, const gnutls_datum_t ***_serial_**);**
    


## ARGUMENTS



           gnutls_x509_aki_t aki
                       The authority key ID
    
           unsigned int san_type
                       the type of the name (of **gnutls_subject_alt_names_t**),
                       may be null
    
           const gnutls_datum_t * san
                       The alternative name data
    
           const char * othername_oid
                       The object identifier if  _san_type_ is
                       **GNUTLS_SAN_OTHERNAME**
    
           const gnutls_datum_t * serial
                       The authorityCertSerialNumber number (may be null)
    


## DESCRIPTION



           This function will set the authorityCertIssuer name and the
           authorityCertSerialNumber to be stored in the  _aki_ type. When
           storing multiple names, the serial should be set on the first
           call, and subsequent calls should use a **NULL** serial.
    
           Since version 3.5.7 the **GNUTLS_SAN_RFC822NAME** , **GNUTLS_SAN_DNSNAME** ,
           and **GNUTLS_SAN_OTHERNAME_XMPP** are converted to ACE format when
           necessary.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# probe::netdev.get_stats

## NAME



           probe::netdev.get_stats - Called when someone asks the device
           statistics
    


## SYNOPSIS



           netdev.get_stats
    


## VALUES



           _dev_name_
               The device that is going to provide the statistics
    


* * *
# gnutls_pubkey_verify_data2

## NAME



           gnutls_pubkey_verify_data2 - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_verify_data2(gnutls_pubkey_t** _pubkey_**,**
           **gnutls_sign_algorithm_t** _algo_**, unsigned int** _flags_**, const**
           **gnutls_datum_t ***_data_**, const gnutls_datum_t ***_signature_**);**
    


## ARGUMENTS



           gnutls_pubkey_t pubkey
                       Holds the public key
    
           gnutls_sign_algorithm_t algo
                       The signature algorithm used
    
           unsigned int flags
                       Zero or an OR list of **gnutls_certificate_verify_flags**
    
           const gnutls_datum_t * data
                       holds the signed data
    
           const gnutls_datum_t * signature
                       contains the signature
    


## DESCRIPTION



           This function will verify the given signed data, using the
           parameters from the certificate.
    


## RETURNS



           In case of a verification failure **GNUTLS_E_PK_SIG_VERIFY_FAILED** is
           returned, and zero or positive code on success. For known to be
           insecure signatures this function will return
           **GNUTLS_E_INSUFFICIENT_SECURITY** unless the flag
           **GNUTLS_VERIFY_ALLOW_BROKEN** is specified.
    


## SINCE



           3.0
    


* * *
# pam_sm_close_session

## NAME



           pam_sm_close_session - PAM service function to terminate session
           management
    


## SYNOPSIS



           **#include <security/pam_modules.h>**
    
           **int pam_sm_close_session(pam_handle_t ***_pamh_**, int** _flags_**, int** _argc_**,**
                                    **const char ****_argv_**);**
    


## DESCRIPTION



           The **pam_sm_close_session** function is the service module's
           implementation of the pam_close_session(3) interface.
    
           This function is called to terminate a session. The only valid
           value for _flags_ is zero or:
    
           PAM_SILENT
               Do not emit any messages.
    


## RETURN VALUES



           PAM_SESSION_ERR
               Cannot make/remove an entry for the specified session.
    
           PAM_SUCCESS
               The session was successfully terminated.
    


* * *
# function::user_char_warn

## NAME



           function::user_char_warn - Retrieves a char value stored in user
           space
    


## SYNOPSIS



               user_char_warn:long(addr:long)
    


## ARGUMENTS



           _addr_
               the user space address to retrieve the char from
    


## DESCRIPTION



           Returns the char 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).
    


* * *
# gnutls_sign_set_secure_for_certs

## NAME



           gnutls_sign_set_secure_for_certs - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int gnutls_sign_set_secure_for_certs(gnutls_sign_algorithm_t** _sign_**,**
           **unsigned int** _secure_**);**
    


## ARGUMENTS



           gnutls_sign_algorithm_t sign
                       the sign algorithm
    
           unsigned int secure
                       whether to mark the sign algorithm secure for
                       certificates
    


## DESCRIPTION



           Modify the previous system wide setting that marked  _sign_ as
           secure or insecure for the use in certificates.  Calling this
           function is allowed only if allowlisting mode is set in the
           configuration file, and only if the system-wide TLS priority
           string has not been initialized yet.  The intended usage is to
           provide applications with a way to expressly deviate from the
           distribution or site defaults inherited from the configuration
           file.  The modification is composable with further modifications
           performed through the priority string mechanism.
    
           This function is not thread-safe and is intended to be called in
           the main thread at the beginning of the process execution.  When
           _secure_ is true,  _sign_ is marked as secure for any use unlike
           **gnutls_sign_set_secure()**.  Otherwise, it is marked as insecure
           only for the use in certificates.  Use **gnutls_sign_set_secure()** to
           mark it insecure for any uses.
    


## RETURNS



           0 on success or negative error code otherwise.
    


## SINCE



           3.7.3
    


* * *
# gnutls_ocsp_resp_export2

## NAME



           gnutls_ocsp_resp_export2 - API function
    


## SYNOPSIS



           **#include <gnutls/ocsp.h>**
    
           **int gnutls_ocsp_resp_export2(gnutls_ocsp_resp_const_t** _resp_**,**
           **gnutls_datum_t ***_data_**, gnutls_x509_crt_fmt_t** _fmt_**);**
    


## ARGUMENTS



           gnutls_ocsp_resp_const_t resp
                       Holds the OCSP response
    
           gnutls_datum_t * data
                       newly allocate buffer holding DER or PEM encoded OCSP
                       response
    
           gnutls_x509_crt_fmt_t fmt
                       DER or PEM
    


## DESCRIPTION



           This function will export the OCSP response to DER or PEM format.
    


## RETURNS



           In case of failure a negative error code will be returned, and 0
           on success.
    


## SINCE



           3.6.3
    


* * *
# gnutls_aead_cipher_decryptv2

## NAME



           gnutls_aead_cipher_decryptv2 - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **int gnutls_aead_cipher_decryptv2(gnutls_aead_cipher_hd_t** _handle_**,**
           **const void ***_nonce_**, size_t** _nonce_len_**, const giovec_t ***_auth_iov_**,**
           **int** _auth_iovcnt_**, const giovec_t ***_iov_**, int** _iovcnt_**, void ***_tag_**,**
           **size_t** _tag_size_**);**
    


## ARGUMENTS



           gnutls_aead_cipher_hd_t handle
                       is a **gnutls_aead_cipher_hd_t** type.
    
           const void * nonce
                       the nonce to set
    
           size_t nonce_len
                       The length of the nonce
    
           const giovec_t * auth_iov
                       additional data to be authenticated
    
           int auth_iovcnt
                       The number of buffers in  _auth_iov_
    
           const giovec_t * iov
                       the data to decrypt
    
           int iovcnt  The number of buffers in  _iov_
    
           void * tag  The authentication tag
    
           size_t tag_size
                       The size of the tag to use (use zero for the default)
    


## DESCRIPTION



           This is similar to **gnutls_aead_cipher_decrypt()** , but it performs
           in-place encryption on the provided data buffers.
    


## RETURNS



           Zero or a negative error code on error.
    


## SINCE



           3.6.10
    


* * *
# gnutls_pubkey_import_rsa_raw

## NAME



           gnutls_pubkey_import_rsa_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_pubkey_import_rsa_raw(gnutls_pubkey_t** _key_**, const**
           **gnutls_datum_t ***_m_**, const gnutls_datum_t ***_e_**);**
    


## ARGUMENTS



           gnutls_pubkey_t key
                       The key
    
           const gnutls_datum_t * m
                       holds the modulus
    
           const gnutls_datum_t * e
                       holds the public exponent
    


## DESCRIPTION



           This function will replace the parameters in the given structure.
           The new parameters should be stored in the appropriate
           gnutls_datum.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# cosl

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



           cosl — cosine function
    


## SYNOPSIS



           #include <math.h>
    
           long double cosl(long double _x_);
    


## DESCRIPTION



           Refer to cos(3p).
    


* * *
# libpfm_intel_skx_unc_m2m

## NAME



           libpfm_intel_skx_unc_m2m - support for Intel Skylake X Server M2M
           uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: skx_unc_m2m[0-1]**
           **PMU desc: Intel Skylake X Server Mesh-2-Memory uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Skylake X server system
           configuration unit M2M uncore PMU.
    


## MODIFIERS



           The following modifiers are supported on Intel Skylake X server
           M2M 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
    


* * *