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

ham__verbose()

Modifies the verbosity of a HAM

Synopsis:

#include <ha/ham.h>

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

Library:

libham

Description:

The ham_verbose function can be used to modify the verbosity of a HAM. This is used to programmatically modify the verbosity. (The ham_stop() utility can also be used to do this.)

These are the variables:

op

Specifies the operation on the verbosity. It can be any one of:

• VERBOSE_SET_INCR=1 -- increment verbosity
• VERBOSE_SET_DECR -- decrement verbosity
• VERBOSE_SET -- set verbosity (specific value)
• VERBOSE_GET -- get verbosity

value

Specifies the increment or decrement for the verbosity. value must be a non-negative integer. A value of zero will set the appropriate increment or decrement to 1.

nodename

Specifies the target node on which the change will be made.

Returns:

For set functions:

0

Success.

-1

An error occurred (errno is set).

For get function:

verbosity

Success.

-1

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(),