UPSCLI_READLINE(3) Network UPS Tools (NUT) UPSCLI_READLINE(3)NAMEupscli_readline - read a single response from a UPS
SYNOPSIS
#include <upsclient.h>
int upscli_readline(UPSCONN *ups, char *buf, size_t buflen);
DESCRIPTION
The upscli_readline() function takes the pointer ups to a
UPSCONN 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.
SEE ALSOupscli_connect(3), upscli_getvar(3), upscli_getlist(3),
upscli_sendline(3), upscli_splitname(3), upscli_str-
error(3)
Sun Oct 6 2002 UPSCLI_READLINE(3)