ham_verbose()

QNX SDP8.0High Availability Framework Developer's GuideDeveloper

Modify the verbosity of a HAM

Synopsis:

#include <ha/ham.h>

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

Arguments:

reserved
Set this argument to NULL.
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 OS

Safety:
Cancellation pointNo
Signal handlerNo
ThreadYes
Page updated: