ham_verbose()

Updated: May 06, 2022

Modify the verbosity of a HAM

Synopsis:

#include <ha/ham.h>

int ham_verbose( const char *nodename,
                 int op,
                 int value);

Arguments:

nodename
The name of the node on which to make the change, or NULL if you want to change the verbosity on the current node.
op
The operation to perform on the verbosity; one of the following:
  • VERBOSE_SET_INCR — increment the verbosity.
  • VERBOSE_SET_DECR — decrement the verbosity.
  • VERBOSE_SET — set the verbosity to a specific value.
  • VERBOSE_GET — get the verbosity.
value
The increment, decrement, or specific value for the verbosity, depending on the value of op. The value must be a non-negative integer. If value is zero, the function uses 1 for the increment or decrement.

Library:

libham

Description:

The ham_verbose() function can be used to get or modify the verbosity of a HAM. You can also use the hamctrl utility to do this.

Returns:

When setting the verbosity:

0
Success.
-1
An error occurred (errno is set).

If op is VERBOSE_GET, the function returns the current verbosity, or -1 if an error occurred (errno is set).

Errors:

EBADF
Couldn't connect to the HAM.
EINVAL
The value or op variable is invalid.

In addition to the above errors, the HAM returns any error it encounters while servicing this request.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes