mirror of https://github.com/openssl/openssl
DOC: Slightly improve the documentation of BIO_lookup() and related functions
Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/15417)
This commit is contained in:
parent
d357dd51cb
commit
d318fc9545
|
@ -42,7 +42,7 @@ The TNS/E platform is build using the same set of builds specifying `nse`
|
|||
instead of `nsx` in the set above.
|
||||
|
||||
You cannot build for TNS/E for FIPS, so you must specify the `no-fips`
|
||||
option to `./Configure`
|
||||
option to `./Configure`.
|
||||
|
||||
About Prefix and OpenSSLDir
|
||||
---------------------------
|
||||
|
|
|
@ -628,8 +628,8 @@ int BIO_lookup(const char *host, const char *service,
|
|||
}
|
||||
|
||||
/*-
|
||||
* BIO_lookup_ex - look up the node and service you want to connect to.
|
||||
* @node: the node you want to connect to.
|
||||
* BIO_lookup_ex - look up the host and service you want to connect to.
|
||||
* @host: the host (or node, in case family == AF_UNIX) you want to connect to.
|
||||
* @service: the service you want to connect to.
|
||||
* @lookup_type: declare intent with the result, client or server.
|
||||
* @family: the address family you want to use. Use AF_UNSPEC for any, or
|
||||
|
@ -642,7 +642,7 @@ int BIO_lookup(const char *host, const char *service,
|
|||
* with 0 for the protocol)
|
||||
* @res: Storage place for the resulting list of returned addresses
|
||||
*
|
||||
* This will do a lookup of the node and service that you want to connect to.
|
||||
* This will do a lookup of the host and service that you want to connect to.
|
||||
* It returns a linked list of different addresses you can try to connect to.
|
||||
*
|
||||
* When no longer needed you should call BIO_ADDRINFO_free() to free the result.
|
||||
|
|
|
@ -23,7 +23,7 @@ BIO_lookup
|
|||
|
||||
int BIO_lookup_ex(const char *host, const char *service, int lookup_type,
|
||||
int family, int socktype, int protocol, BIO_ADDRINFO **res);
|
||||
int BIO_lookup(const char *node, const char *service,
|
||||
int BIO_lookup(const char *host, const char *service,
|
||||
enum BIO_lookup_type lookup_type,
|
||||
int family, int socktype, BIO_ADDRINFO **res);
|
||||
|
||||
|
@ -54,8 +54,7 @@ used. B<res> points at a pointer to hold the start of a B<BIO_ADDRINFO>
|
|||
chain.
|
||||
|
||||
For the family B<AF_UNIX>, BIO_lookup_ex() will ignore the B<service>
|
||||
parameter and expects the B<node> parameter to hold the path to the
|
||||
socket file.
|
||||
parameter and expects the B<host> parameter to hold the path to the socket file.
|
||||
|
||||
BIO_lookup() does the same as BIO_lookup_ex() but does not provide the ability
|
||||
to select based on the protocol (any protocol may be returned).
|
||||
|
|
|
@ -73,7 +73,7 @@ connect BIOs, that is it can be a numerical port string or a
|
|||
string to lookup using getservbyname() and a string table.
|
||||
|
||||
BIO_set_accept_port() uses the string B<port> to set the accept
|
||||
port. "port" has the same syntax as the port specified in
|
||||
port of BIO I<b>. "port" has the same syntax as the port specified in
|
||||
BIO_set_conn_port() for connect BIOs, that is it can be a numerical
|
||||
port string or a string to lookup using getservbyname() and a string
|
||||
table.
|
||||
|
|
Loading…
Reference in New Issue