diff --git a/doc/api/http.markdown b/doc/api/http.markdown index df76a25d66ad23..ec1fdfe4960035 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -162,9 +162,10 @@ If a client connection emits an 'error' event, it will be forwarded here. ### server.listen(port[, hostname][, backlog][, callback]) -Begin accepting connections on the specified port and hostname. If the -hostname is omitted, the server will accept connections directed to any -IPv4 address (`INADDR_ANY`). +Begin accepting connections on the specified `port` and `hostname`. If the +`hostname` is omitted, the server will accept connections on any IPv6 address +(`::`) when IPv6 is available, or any IPv4 address (`0.0.0.0`) otherwise. A +port value of zero will assign a random port. To listen to a unix socket, supply a filename instead of port and hostname. diff --git a/doc/api/net.markdown b/doc/api/net.markdown index f1fdf99d0e7b46..ff204a2ad6fad6 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -137,11 +137,12 @@ A factory method which returns a new ['net.Socket'](#net_class_net_socket). This class is used to create a TCP or local server. -### server.listen(port[, host][, backlog][, callback]) +### server.listen(port[, hostname][, backlog][, callback]) -Begin accepting connections on the specified `port` and `host`. If the -`host` is omitted, the server will accept connections directed to any -IPv4 address (`INADDR_ANY`). A port value of zero will assign a random port. +Begin accepting connections on the specified `port` and `hostname`. If the +`hostname` is omitted, the server will accept connections on any IPv6 address +(`::`) when IPv6 is available, or any IPv4 address (`0.0.0.0`) otherwise. A +port value of zero will assign a random port. Backlog is the maximum length of the queue of pending connections. The actual length will be determined by your OS through sysctl settings such as diff --git a/doc/api/tls.markdown b/doc/api/tls.markdown index 11cea446666671..1587622a3dfbd6 100644 --- a/doc/api/tls.markdown +++ b/doc/api/tls.markdown @@ -586,11 +586,12 @@ NOTE: you may want to use some npm module like [asn1.js] to parse the certificates. -### server.listen(port[, host][, callback]) +### server.listen(port[, hostname][, callback]) -Begin accepting connections on the specified `port` and `host`. If the -`host` is omitted, the server will accept connections directed to any -IPv4 address (`INADDR_ANY`). +Begin accepting connections on the specified `port` and `hostname`. If the +`hostname` is omitted, the server will accept connections on any IPv6 address +(`::`) when IPv6 is available, or any IPv4 address (`0.0.0.0`) otherwise. A +port value of zero will assign a random port. This function is asynchronous. The last parameter `callback` will be called when the server has been bound.