33 lines
1.1 KiB
Groff
33 lines
1.1 KiB
Groff
.TH UPSCLI_SPLITADDR 3 "Mon Jan 22 2007" "" "Network UPS Tools (NUT)"
|
|
.SH NAME
|
|
upscli_splitaddr \- split a listening address into its components
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #include <upsclient.h>
|
|
.sp
|
|
.BI "int upscli_splitaddr(const char *buf, char **hostname, "
|
|
.BI " int *port)"
|
|
.fi
|
|
.SH DESCRIPTION
|
|
The \fBupscli_splitaddr()\fP function takes a pointer to the raw UPS
|
|
definition \fIbuf\fP and returns pointers to dynamically allocated
|
|
memory in \fIupsname\fP and \fIhostname\fP. It also copies the port
|
|
number into \fIport\fP.
|
|
.SH FORMATTING
|
|
A listening address definition is specified according to this format:
|
|
.PP
|
|
<hostname>[:<port>]
|
|
.PP
|
|
Definitions without an explicit port value receive the default value of
|
|
3493.
|
|
.SH "MEMORY USAGE"
|
|
You must \fBfree\fP(3) the pointer \fIhostname\fP when you are done
|
|
with it to avoid memory leaks.
|
|
.SH "RETURN VALUE"
|
|
The \fBupscli_splitaddr()\fP function returns 0 on success, or \-1 if an
|
|
error occurs.
|
|
.SH "SEE ALSO"
|
|
.BR upscli_fd "(3), "upscli_get "(3), "
|
|
.BR upscli_readline "(3), "upscli_sendline "(3), "
|
|
.BR upscli_splitname "(3), "upscli_ssl "(3), "
|
|
.BR upscli_strerror "(3), "upscli_upserror "(3) "
|