Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

upscli_splitname(3) [posix man page]

UPSCLI_SPLITNAME(3)						    NUT Manual						       UPSCLI_SPLITNAME(3)

NAME

       upscli_splitname - split a UPS definition into its components

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, this function will print an error to stderr and return -1 without changing anything.

       Definitions without an explicit port value receive the default value of 3493. The default hostname is "localhost".

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_splitname() 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_splitaddr(3), upscli_ssl(3), upscli_strerror(3),
       upscli_upserror(3)

Network UPS Tools						    05/22/2012						       UPSCLI_SPLITNAME(3)

Check Out this Related Man Page

UPSCLI_SPLITADDR(3)						    NUT Manual						       UPSCLI_SPLITADDR(3)

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)

Network UPS Tools						    05/22/2012						       UPSCLI_SPLITADDR(3)
Man Page