1UPSCLI_SPLITADDR(3) NUT Manual UPSCLI_SPLITADDR(3)
2
3
4
6 upscli_splitaddr - split a listening address into its components
7
9 #include <upsclient.h>
10
11 int upscli_splitaddr(const char *buf, char **hostname,
12 int *port)
13
15 The upscli_splitaddr() function takes a pointer to the raw UPS
16 definition buf and returns pointers to dynamically allocated memory in
17 upsname and hostname. It also copies the port number into port.
18
20 A listening address definition is specified according to this format:
21
22 <hostname>[:<port>]
23
24 Definitions without an explicit port value receive the default value of
25 3493.
26
28 You must free(3) the pointer hostname when you are done with it to
29 avoid memory leaks.
30
32 The upscli_splitaddr() function returns 0 on success, or -1 if an error
33 occurs.
34
36 upscli_fd(3), upscli_get(3), upscli_readline(3), upscli_sendline(3),
37 upscli_splitname(3), upscli_ssl(3), upscli_strerror(3),
38 upscli_upserror(3)
39
40
41
42Network UPS Tools 2.7.3. 03/02/2016 UPSCLI_SPLITADDR(3)