Man page - libnutclient_commands(3)

Packages contas this manual

Package: libnutclient-dev
apt-get install libnutclient-dev

Manuals in package:

Documentations in package:

libnutclient-dev

Manual

LIBNUTCLIENT_COMMAND(3)

NUT Manual

LIBNUTCLIENT_COMMAND(3)

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;

typedef char** strarr;

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,


        const char* param="");

DESCRIPTION

These functions allow to manage instant commands of devices.

•The nutclient_get_device_commands() function retrieves the list of command names for a device.

The returned strarr must be freed by strarr_free.

•The nutclient_has_device_command function tests if the specified command is supported by the device.

Return 1 is supported and 0 if not.

•The nutclient_get_device_command_description function retrieves the command description, if any.

The returned string must be freed.

•The nutclient_execute_device_command intends to execute the instant command, with an optional parameter.

Common arguments:

•dev is the device name.