upscli_readline man page

upscli_readline — read a single response from a UPS


#include <upsclient.h>
int upscli_readline(UPSCONN_t *ups, char *buf, size_t buflen);


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.

See Also

upscli_fd(3), upscli_get(3), upscli_readline(3), upscli_sendline(3), upscli_ssl(3), upscli_strerror(3), upscli_upserror(3)

Referenced By

upsclient(3), upscli_list_start(3), upscli_sendline(3), upscli_splitaddr(3), upscli_splitname(3), upscli_ssl(3), upscli_strerror(3), upscli_upserror(3).

03/02/2016 Network UPS Tools 2.7.3. NUT Manual