From 22587d3d41222ba3e4ca3cd755a8662ca7ff7479 Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Fri, 8 Nov 2013 13:53:00 +0100 Subject: sock: update introductory comment for listen_sock() Signed-off-by: Michael Adam --- src/sock.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'src') diff --git a/src/sock.c b/src/sock.c index 8d7e90a..17f15fe 100644 --- a/src/sock.c +++ b/src/sock.c @@ -237,7 +237,13 @@ static int listen_on_one_socket(struct addrinfo *ad) /* * Start listening on a socket. Create a socket with the selected port. - * The socket fd is returned upon success, -1 upon error. + * If the provided address is NULL, we may listen on multiple sockets, + * e.g. the wildcard addresse for IPv4 and IPv6, depending on what is + * supported. If the address is not NULL, we only listen on the first + * address reported by getaddrinfo that works. + * + * Upon success, the listen-fds are added to the listen_fds list + * and 0 is returned. Upon error, -1 is returned. */ int listen_sock (const char *addr, uint16_t port, vector_t listen_fds) { -- cgit v1.2.3