# LIBNUTCLIENT_DEVICES(3)

## NAME

libnutclient_devices, nutclient_get_devices, nutclient_has_device, nutclient_get_device_description - Device 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_devices(NUTCLIENT_t client);

            int nutclient_has_device(NUTCLIENT_t client, const char* dev);

            char* nutclient_get_device_description(NUTCLIENT_t client, const char* dev);

## DESCRIPTION

These functions allow to manage devices.

- The nutclient_get_devices() function retrieves the list of devices monitored by a client.

  The returned strarr must be freed by strarr_free (see libnutclient_general(3)).

- The nutclient_has_device() function tests if a device is monitored by a client.

- The nutclient_get_device_description() function retrieves the device description.

  The returned description string must be freed by free(3).

Common arguments:

- dev is the device name.

## SEE ALSO

libnutclient(3) libnutclient_commands(3) libnutclient_devices(3) libnutclient_general(3) libnutclient_variables(3)