---
name: "nutclient_get_device_description"
section: "3"
platform: "linux"
package: "libnutclient-dev"
version: "2.8.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/libnutclient_devices"
---

# nutclient\_get\_device\_description(3)

Device related functions in Network UPS Tools high-level client access library

Part of [libnutclient\_devices(3)](/libnutclient_devices/3.md).

## 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*.

• 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.

Common arguments:

• *dev* is the device name.

## SEE ALSO

[**libnutclient**(3)](/libnutclient/3.md) [**libnutclient\_commands**(3)](/libnutclient_commands/3.md) [**libnutclient\_devices**(3)](/libnutclient_devices/3.md) [**libnutclient\_general**(3)](/libnutclient_general/3.md) [**libnutclient\_variables**(3)](/libnutclient_variables/3.md)