UPSCLI_SPLITNAME(3) Network UPS Tools (NUT) UPSCLI_SPLITNAME(3)NAMEupscli_splitname - split a UPS definition into its compo-
nents
SYNOPSIS
#include <upsclient.h>
int upscli_splitname(const char *buf, char **upsname,
char **hostname, int *port)
DESCRIPTION
The upscli_splitname() function takes a pointer to the raw
UPS definition buf and returns pointers to dynamically
allocated memory in upsname and hostname. It also copies
the port number into port.
FORMATTING
A UPS definition is specified according to this format:
[<upsname>@]<hostname>[:<port>]
When the UPS name is not given, the pointer returned is
NULL. Definitions without an explicit port value receive
the default value of 3493.
MEMORY USAGE
You must free(3) the pointers to upsname and hostname when
you are done with them to avoid memory leaks.
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_readline(3), upscli_sendline(3), upscli_strerror(3)
Fri Sep 6 2002 UPSCLI_SPLITNAME(3)