libnutclient_variables - Man Page

Variable 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_variables(NUTCLIENT_t client,
        const char* dev);
strarr nutclient_get_device_rw_variables(NUTCLIENT_t client,
        const char* dev);
int nutclient_has_device_variable(NUTCLIENT_t client,
        const char* dev, const char* var);
char* nutclient_get_device_variable_description(NUTCLIENT_t client,
        const char* dev, const char* var);
strarr nutclient_get_device_variable_values(NUTCLIENT_t client,
        const char* dev, const char* var);
void nutclient_set_device_variable_value(NUTCLIENT_t client,
        const char* dev, const char* var, const char* value);
void nutclient_set_device_variable_values(NUTCLIENT_t client,
        const char* dev, const char* var, const strarr values);

Description

These functions allow to manage variables of devices.

The nutclient_get_device_variables() function retrieves the list of variables names for a device. The returned strarr must be freed by strarr_free.

The nutclient_get_device_rw_variables function retrieves the list of read-write variables names for a device. The returned strarr must be freed by strarr_free.

The nutclient_has_device_variable function tests if the specified variable is supported by the device. Return 1 is supported and 0 if not.

The nutclient_get_device_variable_description function retrieves the variable description, if any. The returned string must be freed.

The nutclient_get_device_variable_values returns variable values (generally only one). The returned strarr must be freed by strarr_free.

The nutclient_set_device_variable_value intends to set the value of the specified variable.

The nutclient_set_device_variable_values intends to set multiple values of the specified variable.

Common arguments:

See Also

libnutclient(3) libnutclient_devices(3) libnutclient_general(3)

Referenced By

libnutclient(3), libnutclient_devices(3).

The man pages nutclient_get_device_rw_variables(3), nutclient_get_device_variable_description(3), nutclient_get_device_variables(3), nutclient_get_device_variable_values(3), nutclient_has_device_variable(3), nutclient_set_device_variable_value(3) and nutclient_set_device_variable_values(3) are aliases of libnutclient_variables(3).

04/26/2022 Network UPS Tools 2.8.0 NUT Manual