NAME¶
upscli_splitaddr - split a listening address into its components
SYNOPSIS¶
#include <upsclient.h>
int upscli_splitaddr(const char *buf, char **hostname,
int *port)
DESCRIPTION¶
The
upscli_splitaddr() 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.
A listening address definition is specified according to this format:
Definitions without an explicit port value receive the default value of 3493.
MEMORY USAGE¶
You must
free(3) the pointer
hostname when you are done with it to
avoid memory leaks.
RETURN VALUE¶
The
upscli_splitaddr() 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_splitname(3),
upscli_ssl(3),
upscli_strerror(3),
upscli_upserror(3)