mirror of
https://github.com/openssl/openssl.git
synced 2024-12-21 06:09:35 +08:00
e5a82bfd68
- One typo fixed in crypto/bio/b_addr.c - Add a comment in doc/crypto/BIO_parse_hostserv.pod to explain the blank lines with one lonely space each. Reviewed-by: Andy Polyakov <appro@openssl.org>
68 lines
2.0 KiB
Plaintext
68 lines
2.0 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
BIO_parse_hostserv - utility routines to parse a standard host and service
|
|
string
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/bio.h>
|
|
|
|
enum BIO_hostserv_priorities {
|
|
BIO_PARSE_PRIO_HOST, BIO_PARSE_PRIO_SERV
|
|
};
|
|
int BIO_parse_hostserv(const char *hostserv, char **host, char **service,
|
|
enum BIO_hostserv_priorities hostserv_prio);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
BIO_parse_hostserv() will parse the information given in B<hostserv>,
|
|
create strings with the host name and service name and give those
|
|
back via B<host> and B<service>. Those will need to be freed after
|
|
they are used. B<hostserv_prio> helps determine if B<hostserv> shall
|
|
be interpreted primarly as a host name or a service name in ambiguous
|
|
cases.
|
|
|
|
The syntax the BIO_parse_hostserv() recognises is:
|
|
|
|
host + ':' + service
|
|
host + ':' + '*'
|
|
host + ':'
|
|
':' + service
|
|
'*' + ':' + service
|
|
host
|
|
service
|
|
|
|
The host part can be a name or an IP address. If it's a IPv6
|
|
address, it MUST be enclosed in brackets, such as '[::1]'.
|
|
|
|
The service part can be a service name or its port number.
|
|
|
|
The returned values will depend on the given B<hostserv> string
|
|
and B<hostserv_prio>, as follows:
|
|
|
|
=for comment
|
|
The following is ONE verbatim block. To make sure it's rendered as
|
|
one block and not several, the blank lines in between have one space.
|
|
They should be left as is.
|
|
|
|
host + ':' + service => *host = "host", *service = "service"
|
|
host + ':' + '*' => *host = "host", *service = NULL
|
|
host + ':' => *host = "host", *service = NULL
|
|
':' + service => *host = NULL, *service = "service"
|
|
'*' + ':' + service => *host = NULL, *service = "service"
|
|
|
|
in case no ':' is present in the string, the result depends on
|
|
hostserv_prio, as follows:
|
|
|
|
when hostserv_prio == BIO_PARSE_PRIO_HOST
|
|
host => *host = "host", *service untouched
|
|
|
|
when hostserv_prio == BIO_PARSE_PRIO_SERV
|
|
service => *host untouched, *service = "service"
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<BIO_ADDRINFO(3)>
|