NAME
upscli_readline - read a single response from a UPS
SYNOPSIS
|
Note
|
Two NUT websites
This version of the page reflects NUT release v2.7.4 with codebase commited 0b4bfddbc at 2016-03-09T14:24:11+01:00 Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here. |
#include <upsclient.h>int upscli_readline(UPSCONN_t *ups, char *buf, size_t buflen);DESCRIPTION
The upscli_readline() function takes the pointer ups to a
UPSCONN_t state structure, receives a single line from the server, and
copies up to buflen bytes of the response into the buffer
buf.
Some parsing of the string occurs during reception. In particular, ERR messages from upsd(8) are detected and will cause this function to return -1.
RETURN VALUE
The upscli_readline() function returns 0 on success, or -1 if an error occurs.