libnutclient_commands (3) - Linux Manuals

libnutclient_commands: Instant command related functions in Network UPS Tools high-level client access library

NAME

libnutclient_commands, nutclient_get_device_commands, nutclient_has_device_command, nutclient_get_device_command_description, nutclient_execute_device_command - Instant command related functions in Network UPS Tools high-level client access library

SYNOPSIS

#include <nutclient.h>

typedef void* NUTCLIENT_t;

strarr nutclient_get_device_commands(NUTCLIENT_t client, const char* dev);
int nutclient_has_device_command(NUTCLIENT_t client, const char* dev, const char* cmd);
char* nutclient_get_device_command_description(NUTCLIENT_t client, const char* dev, const char* cmd);
void nutclient_execute_device_command(NUTCLIENT_t client, const char* dev, const char* cmd);

DESCRIPTION

These functions allow to manage instant commands of devices.

The nutclient_get_device_commands() function retrieve the list of command names for a device. The returned strarr must be freed by strarr_free.

The nutclient_has_device_command function test if the specified command is supported by the device. Return 1 is supported and 0 if not.

The nutclient_get_device_command_description function retrieve the command description, if any. The resturned string must be freed.

The nutclient_execute_device_command intend to execute the instant command.

dev is the device name.

cmd is the instant command name.