Imported Upstream version 2.6.0

docs/man/upscli_splitaddr.txt

@@ -0,0 +1,54 @@
+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
+--------
+
+linkman:upscli_fd[3], linkman:upscli_get[3],
+linkman:upscli_readline[3], linkman:upscli_sendline[3],
+linkman:upscli_splitname[3], linkman:upscli_ssl[3],
+linkman:upscli_strerror[3], linkman:upscli_upserror[3]