UPSCLI_GETLIST(3) Network UPS Tools (NUT) UPSCLI_GETLIST(3)NAMEupscli_getlist - retrieve a variable list from a UPS
SYNOPSIS
#include <upsclient.h>
int upscli_getlist(UPSCONN *ups, const char *upsname,
int listtype, char *buf, size_t buflen);
DESCRIPTION
The upscli_getlist() function takes the pointer ups to a
UPSCONN state structure and generates a request for a list
of type listtype on the UPS called upsname.
The listtype may be one of the following values:
UPSCLI_LIST_VARS - all variables ("LISTVARS")
UPSCLI_LIST_RW - only read/write variables ("LISTRW")
UPSCLI_LIST_CMDS - instant commands ("LISTINSTCMDS")
Upon success, up to buflen bytes of the response will be
copied into the character array buf.
RETURN VALUE
The upscli_getlist() function returns 0 on success, or -1
if an error occurs.
SEE ALSOupscli_connect(3), upscli_getvar(3), upscli_readline(3),
upscli_sendline(3), upscli_splitname(3), upscli_str-
error(3)
Sun Oct 6 2002 UPSCLI_GETLIST(3)