Poster of Linux kernelThe best gift for a Linux geek
UPSCLI_SPLITADDR

UPSCLI_SPLITADDR

Section: NUT Manual (3) Updated: 12/24/2010
Local index Up
 

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.  

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_upserror(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
FORMATTING
MEMORY USAGE
RETURN VALUE
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:57:58 GMT, April 16, 2011