This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ham__verbose()

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

See also:

ham_stop()