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 defini-
       tion buf and  returns  pointers  to  dynamically  allocated  memory  in
       upsname and hostname.  It also copies the port number into port.

FORMATTING

       A listening address definition is specified according to this format:

            <hostname>[:<port>]

       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_upser-
       ror(3)



                                Mon Jan 22 2007            UPSCLI_SPLITADDR(3)