tripathysagar/man_text huggingface dataset:
# sd_bus_set_exit_on_disconnect

## NAME



           sd_bus_set_exit_on_disconnect, sd_bus_get_exit_on_disconnect -
           Control the exit behavior when the bus object disconnects
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **int sd_bus_set_exit_on_disconnect(sd_bus ***_bus_**, int** _b_**);**
    
           **int sd_bus_get_exit_on_disconnect(sd_bus ***_bus_**);**
    


## DESCRIPTION



           **sd_bus_set_exit_on_disconnect()** may be used to configure the exit
           behavior when the given bus object disconnects. If _b_ is zero, no
           special logic is executed when the bus object disconnects. If _b_ is
           non-zero, the behavior on disconnect depends on whether the bus
           object is attached to an event loop or not. If the bus object is
           attached to an event loop (see sd_bus_attach_event(3)), the event
           loop is closed when the bus object disconnects (as if calling
           sd_event_exit(3)). Otherwise, exit(3) is called. The exit code
           passed to **sd_event_exit()** and **exit()** is **EXIT_FAILURE**. If the bus
           object has already disconnected when enabling the exit behavior,
           the exit behavior is executed immediately. By default, the exit
           behavior is disabled.
    
           **sd_bus_get_exit_on_disconnect()** returns whether the exit on
           disconnect behavior is enabled for the given bus object.
    


## RETURN VALUE



           On success, **sd_bus_set_exit_on_disconnect()** returns a non-negative
           integer. On failure, it returns a negative errno-style error code.
    
           **sd_bus_get_exit_on_disconnect()** returns a positive integer if the
           exit on disconnect behavior is enabled. Otherwise, it returns
           zero.
    
       **Errors**
           Returned errors may indicate the following problems:
    
           **-EINVAL**
               A required parameter was **NULL**.
    
               Added in version 246.
    
           **-ENOPKG**
               The bus object could not be resolved.
    
               Added in version 246.
    
           **-ECHILD**
               The bus connection was created in a different process, library
               or module instance.
    
               Added in version 246.
    


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


* * *
# probe::nfsd.commit

## NAME



           probe::nfsd.commit - NFS server committing all pending writes to
           stable storage
    


## SYNOPSIS



           nfsd.commit
    


## VALUES



           _client_ip_
               the ip address of client
    
           _count_
               read bytes
    
           _size_
               read bytes
    
           _flag_
               indicates whether this execution is a sync operation
    
           _fh_
               file handle (the first part is the length of the file handle)
    
           _offset_
               the offset of file
    


* * *
# gnutls_x509_ext_import_inhibit_anypolicy

## NAME



           gnutls_x509_ext_import_inhibit_anypolicy - API function
    


## SYNOPSIS



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


## ARGUMENTS



           const gnutls_datum_t * ext
                       the DER encoded extension data
    
           unsigned int * skipcerts
                       will hold the number of certificates after which
                       anypolicy is no longer acceptable.
    


## DESCRIPTION



           This function will return certificate's value of SkipCerts, by
           reading the DER data of the Inhibit anyPolicy X.509 extension
           (2.5.29.54).
    
           The  _skipcerts_ value is the number of additional certificates that
           may appear in the path before the anyPolicy
           (**GNUTLS_X509_OID_POLICY_ANY**) is no longer acceptable.
    


## RETURNS



           zero, or a negative error code in case of parsing error.  If the
           certificate does not contain the Inhibit anyPolicy extension
           **GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE** will be returned.
    


## SINCE



           3.6.0
    


* * *
# pmgetusername

## NAME



           **pmGetUsername** - fetch special PCP username
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmGetUsername(char ****_username_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           Within the Performance Co-Pilot (PCP) some applications use a spe‐
           cial  (non-root) username to allow access, e.g. to write log files
           into protected directories.
    
           **pmGetUsername** returns the name via _username_.
    
           The    variable     name     **PCP_USER** is     fetched     using
           pmGetOptionalConfig(3).   If  this succeeds, **pmGetUsername** returns
           1.  Otherwise.  _username_ is set to the default value  of  **pcp** and
           **pmGetUsername** returns 0.
    
           **pmGetUsername** is   most   often   used   in   conjunction   with
           pmSetProcessIdentity(3) at process start up.
    


* * *
# efadv_create_qp_ex

## NAME



           efadv_create_qp_ex - Create EFA specific extended Queue Pair
    


## SYNOPSIS



                  #include <infiniband/efadv.h>
    
                  struct ibv_qp *efadv_create_qp_ex(struct ibv_context *ibvctx,
                                    struct ibv_qp_init_attr_ex *attr_ex,
                                    struct efadv_qp_init_attr *efa_attr,
                                    uint32_t inlen);
    


## DESCRIPTION



           **efadv_create_qp_ex()** creates device-specific extended Queue Pair.
    
           The argument attr_ex is an ibv_qp_init_attr_ex struct, as defined
           in <infiniband/verbs.h>.
    
           Use ibv_qp_to_qp_ex() to get the ibv_qp_ex for accessing the send
           ops iterator interface, when QP create attr
           IBV_QP_INIT_ATTR_SEND_OPS_FLAGS is used.
    
           Scalable Reliable Datagram (SRD) transport provides reliable
           out-of-order delivery, transparently utilizing multiple network
           paths to reduce network tail latency.  Its interface is similar to
           UD, in particular it supports message size up to MTU, with error
           handling extended to support reliable communication.
    
           Compatibility is handled using the comp_mask and inlen fields.
    
                  struct efadv_qp_init_attr {
                      uint64_t comp_mask;
                      uint32_t driver_qp_type;
                      uint16_t flags;
                      uint8_t sl;
                      uint8_t reserved[1];
                  };
    
           _inlen_  In: Size of struct efadv_qp_init_attr.
    
           _comp_mask_
                  Compatibility mask.
    
           _driver_qp_type_
                  The type of QP to be created:
    
                  EFADV_QP_DRIVER_TYPE_SRD: Create an SRD QP.
    
           _flags_
    
                  A bitwise OR of the values described below.
    
                  EFADV_QP_FLAGS_UNSOLICITED_WRITE_RECV: Receive WRs will not
                  be consumed for RDMA write with imm.
    
           _sl_     Service Level - 0 value implies default level.
    


## RETURN VALUE



           efadv_create_qp_ex() returns a pointer to the created QP, or NULL
           if the request fails.
    


* * *
# getpeername

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



           getpeername — get the name of the peer socket
    


## SYNOPSIS



           #include <sys/socket.h>
    
           int getpeername(int _socket_ , struct sockaddr *restrict _address_ ,
               socklen_t *restrict _address_len_);
    


## DESCRIPTION



           The _getpeername_() function shall retrieve the peer address of the
           specified socket, store this address in the **sockaddr** structure
           pointed to by the _address_ argument, and store the length of this
           address in the object pointed to by the _address_len_ argument.
    
           The _address_len_ argument points to a **socklen_t** object which on
           input specifies the length of the supplied **sockaddr** structure, and
           on output specifies the length of the stored address.  If the
           actual length of the address is greater than the length of the
           supplied **sockaddr** structure, the stored address shall be
           truncated.
    
           If the protocol permits connections by unbound clients, and the
           peer is not bound, then the value stored in the object pointed to
           by _address_ is unspecified.
    


## RETURN VALUE



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


## ERRORS



           The _getpeername_() function shall fail if:
    
           **EBADF** The _socket_ argument is not a valid file descriptor.
    
           **EINVAL** The socket has been shut down.
    
           **ENOTCONN**
                  The socket is not connected or otherwise has not had the
                  peer pre-specified.
    
           **ENOTSOCK**
                  The _socket_ argument does not refer to a socket.
    
           **EOPNOTSUPP**
                  The operation is not supported for the socket protocol.
    
           The _getpeername_() function may fail if:
    
           **ENOBUFS**
                  Insufficient resources were available in the system to
                  complete the call.
    
           _The following sections are informative._
    


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# tapset::errno

## NAME



           tapset::errno - systemtap errno tapset
    


## DESCRIPTION



           **errno_str**
                  Symbolic string associated with error code
    
                  See function::errno_str(3stap)
                   for details.
    
           **returnval**
                  Possible return value of probed function
    
                  See function::returnval(3stap)
                   for details.
    
           **returnstr**
                  Formats the return value as a string
    
                  See function::returnstr(3stap)
                   for details.
    
           **return_str**
                  Formats the return value as a string
    
                  See function::return_str(3stap)
                   for details.
    


* * *
# function::print_backtrace_fileline

## NAME



           function::print_backtrace_fileline - Print kernel stack back trace
    


## SYNOPSIS



               print_backtrace_fileline()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function is equivalent to **print_backtrace** , but output for
           each symbol is longer including file names and line numbers. The
           function does not return a value.
    


* * *
# select

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



           select — synchronous I/O multiplexing
    


## SYNOPSIS



           #include <sys/select.h>
    
           int select(int _nfds_ , fd_set *restrict _readfds_ ,
               fd_set *restrict _writefds_ , fd_set *restrict _errorfds_ ,
               struct timeval *restrict _timeout_);
    


## DESCRIPTION



           Refer to pselect(3p).
    


* * *
# probe::stap.pass5.end

## NAME



           probe::stap.pass5.end - Finished stap pass5 (running the
           instrumentation)
    


## SYNOPSIS



           stap.pass5.end
    


## VALUES



           _session_
               the systemtap_session variable s
    


## DESCRIPTION



           pass5.end fires just before the cleanup label
    


* * *
# function::set_longlong_arg

## NAME



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


## SYNOPSIS



               set_longlong_arg:long(n:long,v:long)
    


## ARGUMENTS



           _n_
               index of argument to return
    
           _v_
               value to set
    


## DESCRIPTION



           Set the value of argument n as a 64-bit value.
    


* * *
# sd_bus_slot_ref

## NAME



           sd_bus_slot_ref, sd_bus_slot_unref, sd_bus_slot_unrefp - Create
           and destroy references to a bus slot object
    


## SYNOPSIS



           **#include <systemd/sd-bus.h>**
    
           **sd_bus_slot *sd_bus_slot_ref(sd_bus_slot ***_slot_**);**
    
           **sd_bus_slot *sd_bus_slot_unref(sd_bus_slot ***_slot_**);**
    
           **void sd_bus_slot_unrefp(sd_bus_slot ****_slotp_**);**
    


## DESCRIPTION



           **sd_bus_slot_ref()** increases the internal reference counter of _slot_
           by one.
    
           **sd_bus_slot_unref()** decreases the internal reference counter of
           _slot_ by one. Once the reference count has dropped to zero, slot
           object is destroyed and cannot be used anymore, so further calls
           to **sd_bus_slot_ref()** or **sd_bus_slot_unref()** are illegal.
    
           **sd_bus_slot_unrefp()** is similar to **sd_bus_slot_unref()** but takes a
           pointer to a pointer to an **sd_bus_slot** object. This call is useful
           in conjunction with GCC's and LLVM's **Clean-up Variable**
           **Attribute******[1]. Seesd_bus_new(3) for an example how to use the
           cleanup attribute.
    
           **sd_bus_slot_ref()** and **sd_bus_slot_unref()** execute no operation if
           the passed in bus object address is **NULL**.  **sd_bus_slot_unrefp()**
           will first dereference its argument, which must not be **NULL** , and
           will execute no operation if _that_ is **NULL**.
    


## RETURN VALUE



           **sd_bus_slot_ref()** always returns the argument.
    
           **sd_bus_slot_unref()** always returns **NULL**.
    


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


## NOTES



            1. Clean-up Variable Attribute
               https://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.html
    


* * *
# probe::workqueue.execute

## NAME



           probe::workqueue.execute - Executing deferred work
    


## SYNOPSIS



           workqueue.execute
    


## VALUES



           _wq_thread_
               task_struct of the workqueue thread
    
           _work_
               work_struct* being executed
    
           _work_func_
               pointer to handler function
    


* * *
# probe::signal.wakeup

## NAME



           probe::signal.wakeup - Sleeping process being wakened for signal
    


## SYNOPSIS



           signal.wakeup
    


## VALUES



           _sig_pid_
               The PID of the process to wake
    
           _state_mask_
               A string representation indicating the mask of task states to
               wake. Possible values are TASK_INTERRUPTIBLE, TASK_STOPPED,
               TASK_TRACED, TASK_WAKEKILL, and TASK_INTERRUPTIBLE.
    
           _pid_name_
               Name of the process to wake
    
           _resume_
               Indicates whether to wake up a task in a STOPPED or TRACED
               state
    


* * *
# gnutls_srp_allocate_client_credentials

## NAME



           gnutls_srp_allocate_client_credentials - API function
    


## SYNOPSIS



           **#include <gnutls/gnutls.h>**
    
           **int**
           **gnutls_srp_allocate_client_credentials(gnutls_srp_client_credentials_t**
           *****_sc_**);**
    


## ARGUMENTS



           gnutls_srp_client_credentials_t * sc
                       is a pointer to a **gnutls_srp_server_credentials_t**
                       type.
    


## DESCRIPTION



           Allocate a gnutls_srp_client_credentials_t structure.
    


## RETURNS



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


* * *
# gnutls_x509_aia_set

## NAME



           gnutls_x509_aia_set - API function
    


## SYNOPSIS



           **#include <gnutls/x509-ext.h>**
    
           **int gnutls_x509_aia_set(gnutls_x509_aia_t** _aia_**, const char ***_oid_**,**
           **unsigned** _san_type_**, const gnutls_datum_t ***_san_**);**
    


## ARGUMENTS



           gnutls_x509_aia_t aia
                       The authority info access
    
           const char * oid
                       the type of data.
    
           unsigned san_type
                       The type of the name (of **gnutls_subject_alt_names_t**)
    
           const gnutls_datum_t * san
                       The alternative name data
    


## DESCRIPTION



           This function will store the specified alternative name in the
           _aia_ type.
    
           Typically the value for  _oid_ should be **GNUTLS_OID_AD_OCSP** , or
           **GNUTLS_OID_AD_CAISSUERS**.
    
           Since version 3.5.7 the **GNUTLS_SAN_RFC822NAME** , and
           **GNUTLS_SAN_DNSNAME** , are converted to ACE format when necessary.
    


## RETURNS



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


## SINCE



           3.3.0
    


* * *
# sem_post

## NAME



           sem_post - unlock a semaphore
    


## LIBRARY



           POSIX threads library (_libpthread_ , _-lpthread_)
    


## SYNOPSIS



           **#include <semaphore.h>**
    
           **int sem_post(sem_t ***_sem_**);**
    


## DESCRIPTION



           **sem_post**() increments (unlocks) the semaphore pointed to by _sem_.
           If the semaphore's value consequently becomes greater than zero,
           then another process or thread blocked in a sem_wait(3) call will
           be woken up and proceed to lock the semaphore.
    


## RETURN VALUE



           **sem_post**() returns 0 on success; on error, the value of the
           semaphore is left unchanged, -1 is returned, and _errno_ is set to
           indicate the error.
    


## ERRORS



           **EINVAL** _sem_ is not a valid semaphore.
    
           **EOVERFLOW**
                  The maximum allowable value for a semaphore would be
                  exceeded.
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           **sem_post**() is async-signal-safe: it may be safely called within a
           signal handler.
    


## EXAMPLES



           See sem_wait(3) and shm_open(3).
    


* * *
# a64l

## NAME



           a64l, l64a - convert between long and base-64
    


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <stdlib.h>**
    
           **long a64l(const char ***_str64_**);**
           **char *l64a(long** _value_**);**
    
       Feature Test Macro Requirements for glibc (see
       feature_test_macros(7)):
    
           **a64l**(), **l64a**():
               _XOPEN_SOURCE >= 500
                   || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _SVID_SOURCE
    


## DESCRIPTION



           These functions provide a conversion between 32-bit long integers
           and little-endian base-64 ASCII strings (of length zero to six).
           If the string used as argument for **a64l**() has length greater than
           six, only the first six bytes are used.  If the type _long_ has more
           than 32 bits, then **l64a**() uses only the low order 32 bits of
           _value_ , and **a64l**() sign-extends its 32-bit result.
    
           The 64 digits in the base-64 system are:
    
                  '.'  represents a 0
                  '/'  represents a 1
                  0-9  represent  2-11
                  A-Z  represent 12-37
                  a-z  represent 38-63
    
           So 123 = 59*64^0 + 1*64^1 = "v/".
    


## ATTRIBUTES



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


## STANDARDS



           POSIX.1-2008.
    


## NOTES



           The value returned by **l64a**() may be a pointer to a static buffer,
           possibly overwritten by later calls.
    
           The behavior of **l64a**() is undefined when _value_ is negative.  If
           _value_ is zero, it returns an empty string.
    
           These functions are broken before glibc 2.2.5 (puts most
           significant digit first).
    
           This is not the encoding used by **uuencode**(1).
    


* * *
# function::sprint_backtrace

## NAME



           function::sprint_backtrace - Return stack back trace as string
    


## SYNOPSIS



               sprint_backtrace:string()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Returns a simple (kernel) backtrace. One line per address.
           Includes the symbol name (or hex address if symbol couldn't be
           resolved) and module name (if found). Includes the offset from the
           start of the function if found, otherwise the offset will be added
           to the module (if found, between brackets). Returns the backtrace
           as string (each line terminated by a newline character). Note that
           the returned stack will be truncated to MAXSTRINGLEN, to print
           fuller and richer stacks use **print_backtrace**. Equivalent to
           sprint_stack(**backtrace**), but more efficient (no need to translate
           between hex strings and final backtrace string).
    


* * *
# probe::nfs.proc.commit

## NAME



           probe::nfs.proc.commit - NFS client committing data on server
    


## SYNOPSIS



           nfs.proc.commit
    


## VALUES



           _bitmask0_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _version_
               NFS version
    
           _bitmask1_
               V4 bitmask representing the set of attributes supported on
               this filesystem
    
           _prot_
               transfer protocol
    
           _offset_
               the file offset
    
           _size_
               read bytes in this execution
    
           _server_ip_
               IP address of server
    


## DESCRIPTION



           All the nfs.proc.commit kernel functions were removed in kernel
           commit 200baa in December 2006, so these probes do not exist on
           Linux 2.6.21 and newer kernels.
    
           Fires when client writes the buffered data to disk. The buffered
           data is asynchronously written by client earlier. The commit
           function works in sync way. This probe point does not exist in
           NFSv2.
    


* * *
# pmusezone

## NAME



           **pmUseZone** - re-establish a reporting timezone
    


## C SYNOPSIS



           **#include <pcp/pmapi.h>**
    
           **int pmUseZone(const int** _tz_handle_**);**
    
           **cc ... -lpcp**
    


## DESCRIPTION



           The  current  reporting  timezone  effects  the  timezone  used by
           pmCtime(3) and pmLocaltime(3).
    
           The argument _tz_handle_ identifies a reporting timezone  as  previ‐
           ously    established    by    a    call    to    pmNewZone(3)   or
           pmNewContextZone(3), and this becomes the current reporting  time‐
           zone.
    


## DIAGNOSTICS



           A  return value less than zero indicates the value of _tz_handle_ is
           not legal.
    


* * *
# gnutls_privkey_export_dh_raw

## NAME



           gnutls_privkey_export_dh_raw - API function
    


## SYNOPSIS



           **#include <gnutls/abstract.h>**
    
           **int gnutls_privkey_export_dh_raw(gnutls_privkey_t** _key_**,**
           **gnutls_dh_params_t** _params_**, gnutls_datum_t ***_y_**, gnutls_datum_t ***_x_**,**
           **unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_privkey_t key
                       Holds the private key
    
           gnutls_dh_params_t params
                       will hold the Diffie-Hellman parameters (optional),
                       must be initialized
    
           gnutls_datum_t * y
                       will hold the y (optional)
    
           gnutls_datum_t * x
                       will hold the x
    
           unsigned int flags
                       flags from **gnutls_abstract_export_flags_t**
    


## DESCRIPTION



           This function will export the Diffie-Hellman private key parameter
           found in the given **gnutls_privkey_t** structure. The new parameter
           will be allocated using **gnutls_malloc()** and will be stored in the
           appropriate datum.
    
           To retrieve other parameters common in both public key and private
           key, use **gnutls_dh_params_export_raw()**.
    


## RETURNS



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


## SINCE



           3.8.2
    


* * *
# sigpending

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



           sigpending — examine pending signals
    


## SYNOPSIS



           #include <signal.h>
    
           int sigpending(sigset_t *_set_);
    


## DESCRIPTION



           The _sigpending_() function shall store, in the location referenced
           by the _set_ argument, the set of signals that are blocked from
           delivery to the calling thread and that are pending on the process
           or the calling thread.
    


## RETURN VALUE



           Upon successful completion, _sigpending_() shall return 0;
           otherwise, -1 shall be returned and _errno_ set to indicate the
           error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           None.
    


## FUTURE DIRECTIONS



           None.
    


* * *
# probe::stap.system

## NAME



           probe::stap.system - Starting a command from stap
    


## SYNOPSIS



           stap.system
    


## VALUES



           _command_
               the command string to be run by posix_spawn (as sh -c <str>)
    


## DESCRIPTION



           Fires at the entry of the stap_system command.
    


* * *
# probe::signal.pending.return

## NAME



           probe::signal.pending.return - Examination of pending signal
           completed
    


## SYNOPSIS



           signal.pending.return
    


## VALUES



           _retstr_
               Return value as a string
    
           _name_
               Name of the probe point
    


* * *
# ibv_query_gid

## NAME



           ibv_query_gid - query an InfiniBand port’s GID table
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_query_gid(struct ibv_context *context,
                                    uint8_t port_num,
                                    int index,
                                    union ibv_gid *gid);
    


## DESCRIPTION



           **ibv_query_gid()** returns the GID value in entry _index_ of port
           _port_num_ for device context _context_ through the pointer _gid_.
    


## RETURN VALUE



           **ibv_query_gid()** returns 0 on success, and -1 on error.
    


* * *
# gnutls_hash_copy

## NAME



           gnutls_hash_copy - API function
    


## SYNOPSIS



           **#include <gnutls/crypto.h>**
    
           **gnutls_hash_hd_t gnutls_hash_copy(gnutls_hash_hd_t** _handle_**);**
    


## ARGUMENTS



           gnutls_hash_hd_t handle
                       is a **gnutls_hash_hd_t** type
    


## DESCRIPTION



           This function will create a copy of Message Digest context,
           containing all its current state. Copying contexts for Message
           Digests registered using **gnutls_crypto_register_digest()** is not
           supported and will always result in an error. In addition to that,
           some of the Message Digest implementations do not support this
           operation. Applications should check the return value and provide
           a proper fallback.
    


## RETURNS



           new Message Digest context or NULL in case of an error.
    


## SINCE



           3.6.9
    


* * *
# gnutls_pkcs11_copy_x509_privkey

## NAME



           gnutls_pkcs11_copy_x509_privkey - API function
    


## SYNOPSIS



           **#include <gnutls/pkcs11.h>**
    
           **int gnutls_pkcs11_copy_x509_privkey(const char ***_token_url_**,**
           **gnutls_x509_privkey_t** _key_**, const char ***_label_**, unsigned int**
           _key_usage_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           const char * token_url
                       A PKCS **11** URL specifying a token
    
           gnutls_x509_privkey_t key
                       A private key
    
           const char * label
                       A name to be used for the stored data
    
           unsigned int key_usage
                       One of GNUTLS_KEY_*
    
           unsigned int flags
                       One of GNUTLS_PKCS11_OBJ_* flags
    


## DESCRIPTION



           This function will copy a private key into a PKCS **11** token
           specified by a URL.
    
           Since 3.6.3 the objects are marked as sensitive by default unless
           **GNUTLS_PKCS11_OBJ_FLAG_MARK_NOT_SENSITIVE** is specified.
    


## RETURNS



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


## SINCE



           2.12.0
    


* * *
# probe::

## NAME



           probe:: -
    


## SYNOPSIS



    


## VALUES



           None
    


* * *
# ibv_query_ece

## NAME



           ibv_query_ece - query ECE options.
    


## SYNOPSIS



                  #include <infiniband/verbs.h>
    
                  int ibv_query_ece(struct ibv_qp *qp, struct ibv_ece *ece);
    


## DESCRIPTION



           **ibv_query_ece()** query ECE options.
    
           Return to the user current ECE state for the QP.
    


## ARGUMENTS



           _qp_     The queue pair (QP) associated with the ECE options.
    
           ## _ece_ Argument
                  The ECE values.
    
                  struct ibv_ece {
                      uint32_t vendor_id;
                      uint32_t options;
                      uint32_t comp_mask;
                  };
    
           _vendor_id_
                  Unique identifier of the provider vendor on the network.
                  The providers will set IEEE OUI here to distinguish itself
                  in non-homogenius network.
    
           _options_
                  Provider specific attributes which are supported.
    
           _comp_mask_
                  Bitmask specifying what fields in the structure are valid.
    


## RETURN VALUE



           **ibv_query_ece()** returns 0 when the call was successful, or the
           errno value which indicates the failure reason.
    
           _EOPNOTSUPP_
                  libibverbs or provider driver doesn’t support the
                  ibv_set_ece() verb.
    
           _EINVAL_ In one of the following: o The QP is invalid.  o The ECE
                  options are invalid.
    


* * *
# gnutls_x509_crq_set_challenge_password

## NAME



           gnutls_x509_crq_set_challenge_password - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_challenge_password(gnutls_x509_crq_t** _crq_**,**
           **const char ***_pass_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       should contain a **gnutls_x509_crq_t** type
    
           const char * pass
                       holds a (0)-terminated password
    


## DESCRIPTION



           This function will set a challenge password to be used when
           revoking the request.
    


## RETURNS



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


* * *
# QmcMetric

## NAME



           **QmcMetric** - container for a metric and all its values
    


## C++ SYNOPSIS



           **#include <pcp/pmc/Metric.h>**
    
           **c++ ... -lpcp_qmc -lpcp**
    


## DESCRIPTION



           A  **QmcMetric** object is a container for a single metric and all its
           values.
    
           The **QmcMetricValue** structure is used to hold the  instance  index,
           values  and  errors  of  each instance.  In the case of a singular
           metric, a single **QmcMetricValue** object is used.
    
           A **QmcMetric** object consists of a list of  **QmcMetricValue** objects,
           indexes to the descriptors in the metric's **QmcGroup** and **QmcContext**
           and  flags  to indicate if the instances are explicit or implicit,
           and if only active metrics are required after **QmcMetric::updateIn‐**
           **dom** is called.
    


## CONSTRUCTORS



           Metrics should  be  constructed  through  the  **QmcGroup::addMetric**
           methods  as  this  will ensure that the references to the metric's
           context, descriptor and instance domain are correctly initialized.
    


## INSTANCES



           For metrics with an instance domain it is possible to add and  re‐
           move  any  instance,  and also update the instance list to reflect
           changes in a dynamic instance domain.
    
           **bool updateIndom();**
               Update the metric to include new instances.  This method will
               first call **QmcContext::update** to update the instance domain.
               If the _active_ flag is set in the **QmcGroup::addMetric** call, on‐
               ly instances will exported by the metric, otherwise the metric
               will export all instances listed in the domain.
    
               The ordering of instances may change as a result of this call.
               Instances that already existed will keep their current and
               previous values and errors, even if they are in a different
               order.
    
           **int addInst(QString const & name);**
               Add the instance **name** to the metric.  If the instance does not
               exist in the instance domain, a PMAPI(3) error will be re‐
               turned.  This method ignores the value of the _active_ flag set
               in the **QmcMetric** constructor.
    
           **void removeInst(uint_t index);**
               Remove the instance at position _index_ from the metric.
    


## DIAGNOSTICS



           Error messages are generated using pmprintf(3) but are not
           flushed. It is the responsibility of the user to call pmflush(3)
           to output any messages.
    
           Additional diagnostics may be activated by adding the option **pmc**
           to the global debugging specification, as described in
           pmSetDebug(3).
    


* * *
# creal

## NAME



           creal, crealf, creall - get real part of a complex number
    


## LIBRARY



           Math library (_libm_ , _-lm_)
    


## SYNOPSIS



           **#include <complex.h>**
    
           **double creal(double complex** _z_**);**
           **float crealf(float complex** _z_**);**
           **long double creall(long double complex** _z_**);**
    


## DESCRIPTION



           These functions return the real part of the complex number _z_.
    
           One has:
    
               z = creal(z) + I * cimag(z)
    


## ATTRIBUTES



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


## VERSIONS



           GCC supports also __real__.  That is a GNU extension.
    


## STANDARDS



           C11, POSIX.1-2008.
    


* * *
# function::gid

## NAME



           function::gid - Returns the group ID of a target process
    


## SYNOPSIS



               gid:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           This function returns the group ID of a target process.
    


* * *
# function::asmlinkage

## NAME



           function::asmlinkage - Mark function as declared asmlinkage
    


## SYNOPSIS



               asmlinkage()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Call this function before accessing arguments using the *_arg
           functions if the probed kernel function was declared asmlinkage in
           the source.
    


* * *
# probe::scheduler.migrate

## NAME



           probe::scheduler.migrate - Task migrating across cpus
    


## SYNOPSIS



           scheduler.migrate
    


## VALUES



           _pid_
               PID of the task being migrated
    
           _cpu_to_
               the destination cpu
    
           _priority_
               priority of the task being migrated
    
           _cpu_from_
               the original cpu
    
           _task_
               the process that is being migrated
    
           _name_
               name of the probe point
    


* * *
# pcap_datalink_name_to_val

## NAME



           pcap_datalink_name_to_val - get the link-layer header type value
           corresponding to a header type name
    


## SYNOPSIS



           **#include <pcap/pcap.h>**
    
           **int pcap_datalink_name_to_val(const char *name);**
    


## DESCRIPTION



           **pcap_datalink_name_to_val**() translates a link-layer header type
           name, which is a **DLT_** name with the **DLT_** removed, to the
           corresponding link-layer header type value.  The translation is
           case-insensitive.
    


## RETURN VALUE



           **pcap_datalink_name_to_val**() returns the type value on success and
           **PCAP_ERROR** if the name is not a known type name.
    


* * *
# probe::scheduler.process_exit

## NAME



           probe::scheduler.process_exit - Process exiting
    


## SYNOPSIS



           scheduler.process_exit
    


## VALUES



           _pid_
               PID of the process exiting
    
           _priority_
               priority of the process exiting
    
           _name_
               name of the probe point
    


* * *
# probe::ipmib.FragFails

## NAME



           probe::ipmib.FragFails - Count datagram fragmented unsuccessfully
    


## SYNOPSIS



           ipmib.FragFails
    


## VALUES



           _op_
               Value to be added to the counter (default value of 1)
    
           _skb_
               pointer to the struct sk_buff being acted on
    


## DESCRIPTION



           The packet pointed to by _skb_ is filtered by the function
           **ipmib_filter_key**. If the packet passes the filter is is counted in
           the global _FragFails_ (equivalent to SNMP's MIB
           IPSTATS_MIB_FRAGFAILS)
    


* * *
# gnutls_x509_crq_set_spki

## NAME



           gnutls_x509_crq_set_spki - API function
    


## SYNOPSIS



           **#include <gnutls/x509.h>**
    
           **int gnutls_x509_crq_set_spki(gnutls_x509_crq_t** _crq_**, const**
           **gnutls_x509_spki_t** _spki_**, unsigned int** _flags_**);**
    


## ARGUMENTS



           gnutls_x509_crq_t crq
                       a certificate request of type **gnutls_x509_crq_t**
    
           const gnutls_x509_spki_t spki
                       a SubjectPublicKeyInfo structure of type
                       **gnutls_x509_spki_t**
    
           unsigned int flags
                       must be zero
    


## DESCRIPTION



           This function will set the certificate request's subject public
           key information explicitly. This is intended to be used in the
           cases where a single public key (e.g., RSA) can be used for
           multiple signature algorithms (RSA PKCS1-1.5, and RSA-PSS).
    
           To export the public key (i.e., the SubjectPublicKeyInfo part),
           check **gnutls_pubkey_import_x509()**.
    


## RETURNS



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


## SINCE



           3.6.0
    


* * *
# function::user_mode

## NAME



           function::user_mode - Determines if probe point occurs in
           user-mode
    


## SYNOPSIS



               user_mode:long()
    


## ARGUMENTS



           None
    


## DESCRIPTION



           Return 1 if the probe point occurred in user-mode.
    


* * *
# auparse_node_compare

## NAME



           auparse_node_compare - compares node name values
    


## SYNOPSIS



           **#include <auparse.h>**
    
           **int auparse_node_compare(const au_event_t**
           *****_e1,_**const** _au_event_t_***"**_e2);"_
    


## DESCRIPTION



           auparse_node_compare compares the node name values of 2 events.
    


## RETURN VALUE



           Returns -1, 0, or 1 respectively depending on whether e2 is less
           than, equal to, or greater than e1. Since this is a string
           compare, it probably only matter that they are equal or not equal.
    


* * *
# libpfm_intel_snbep_unc_imc

## NAME



           libpfm_intel_snbep_unc_imc - support for Intel Sandy Bridge-EP
           Integrated Memory Controller (IMC)  uncore PMU
    


## SYNOPSIS



           **#include <perfmon/pfmlib.h>**
    
           **PMU name: snbep_unc_imc[0-3]**
           **PMU desc: Intel Sandy Bridge-EP IMC uncore PMU**
    


## DESCRIPTION



           The library supports the Intel Sandy Bridge Integrated Memory
           Controller (IMC) uncore PMU.  This PMU model only exists on Sandy
           Bridge model 45. There are four IMC PMUs per socket.
    


## MODIFIERS



           The following modifiers are supported on Intel Sandy Bridge C-Box
           uncore PMU:
    
           **i** Invert the meaning of the event. The counter will now count
                  IMC cycles in which the event is **not** occurring. This is a
                  boolean modifier
    
           **e** Enable edge detection, i.e., count only when there is a
                  state transition from no occurrence of the event to at
                  least one occurrence. This modifier must be combined with a
                  threshold modifier (t) with a value greater or equal to
                  one.  This is a boolean modifier.
    
           **t** Set the threshold value. When set to a non-zero value, the
                  counter counts the number of IMC cycles in which the number
                  of occurrences of the event is greater or equal to the
                  threshold.  This is an integer modifier with values in the
                  range [0:255].
    


* * *
# sigfillset

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



           sigfillset — initialize and fill a signal set
    


## SYNOPSIS



           #include <signal.h>
    
           int sigfillset(sigset_t *_set_);
    


## DESCRIPTION



           The _sigfillset_() function shall initialize the signal set pointed
           to by _set_ , such that all signals defined in this volume of
           POSIX.1‐2017 are included.
    


## RETURN VALUE



           Upon successful completion, _sigfillset_() shall return 0;
           otherwise, it shall return -1 and set _errno_ to indicate the error.
    


## ERRORS



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


## EXAMPLES



           None.
    


## APPLICATION USAGE



           None.
    


## RATIONALE



           Refer to sigemptyset(3p).
    


## FUTURE DIRECTIONS



           None.
    


* * *