logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

upscli_splitname - Split a UPS definition into its components

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

       An 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.

Name

       upscli_splitname - Split a UPS definition into its components

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 2.8.3                            07/08/2025                                UPSCLI_SPLITNAME(3)

Synopsis

               #include <upsclient.h>

               int upscli_splitname(const char *buf, char **upsname,
                       char **hostname, int *port)

See Also