nutclient_device_master(3)

nutclient_device_master3

Miscellaneous functions in network ups tools high-level client access library

Part of libnutclient_misc(3).

Usage

#include <nutclient.h>
typedef void* NUTCLIENT_t;
void nutclient_authenticate(
        NUTCLIENT_t client,
        const char* login, const char* passwd);
void nutclient_logout(NUTCLIENT_t client);
void nutclient_device_login(NUTCLIENT_t client, const char* dev);
int nutclient_get_device_num_logins(NUTCLIENT_t client, const char* dev);
void nutclient_device_primary(NUTCLIENT_t client, const char* dev);
/* OBSOLETED name: */
void nutclient_device_master(NUTCLIENT_t client, const char* dev);
void nutclient_device_forced_shutdown(NUTCLIENT_t client, const char* dev);

Overview

The nutclient_authenticate() function authenticates the user.

• login is the user name.

• passwd is the user password.

The nutclient_logout() function disconnects gracefully from the server.

The nutclient_device_login() function logs the fact that a system is drawing power from this UPS.

The nutclient_get_device_num_logins() function retrieves the number of clients which have been logged for this device.

The nutclient_device_master() and nutclient_device_primary() (note: the former is obsoleted since NUT v2.8.0 in favor of the latter) functions make sure that primary-mode functions like FSD are available if necessary.

The nutclient_device_forced_shutdown() function sets the "forced shutdown" flag on the device.

dev is the device name.

Releases

5 releases since Debian 9 (Stretch); the text changed 2 times.

  1. 9–11
  2. 12
  3. 13

From libnutclient-dev 2.8.1-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.