Skip to content

Commit

Permalink
doc: document backlog for server.listen() variants
Browse files Browse the repository at this point in the history
The backlog parameter is supported by all variations of
net.Server.listen(), but wasn't consistently documented. This
commit brings the documentation into a more consistent state.

Refs: #4056
PR-URL: #4025
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Fedor Indutny <[email protected]>
  • Loading branch information
jscissr authored and cjihrig committed Dec 16, 2015
1 parent d63ccee commit 9e1b7aa
Showing 1 changed file with 13 additions and 5 deletions.
18 changes: 13 additions & 5 deletions doc/api/net.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -83,9 +83,10 @@ when sockets were sent to forks.

Callback should take two arguments `err` and `count`.

### server.listen(handle[, callback])
### server.listen(handle[, backlog][, callback])

* `handle` {Object}
* `backlog` {Number}
* `callback` {Function}

The `handle` object can be set to either a server or socket (anything
Expand All @@ -102,6 +103,9 @@ This function is asynchronous. When the server has been bound,
The last parameter `callback` will be added as a listener for the
[`'listening'`][] event.

The parameter `backlog` behaves the same as in
[`server.listen(port, \[host\], \[backlog\], \[callback\])`][].

### server.listen(options[, callback])

* `options` {Object} - Required. Supports the following properties:
Expand All @@ -114,9 +118,8 @@ The last parameter `callback` will be added as a listener for the

The `port`, `host`, and `backlog` properties of `options`, as well as the
optional callback function, behave as they do on a call to
[server.listen(port, \[host\], \[backlog\], \[callback\])
](#net_server_listen_port_hostname_backlog_callback). Alternatively, the `path`
option can be used to specify a UNIX socket.
[`server.listen(port, \[host\], \[backlog\], \[callback\])`][]. Alternatively,
the `path` option can be used to specify a UNIX socket.

If `exclusive` is `false` (default), then cluster workers will use the same
underlying handle, allowing connection handling duties to be shared. When
Expand All @@ -130,9 +133,10 @@ shown below.
exclusive: true
});

### server.listen(path[, callback])
### server.listen(path[, backlog][, callback])

* `path` {String}
* `backlog` {Number}
* `callback` {Function}

Start a local socket server listening for connections on the given `path`.
Expand All @@ -157,6 +161,9 @@ double-backslashes, such as:
net.createServer().listen(
path.join('\\\\?\\pipe', process.cwd(), 'myctl'))

The parameter `backlog` behaves the same as in
[`server.listen(port, \[host\], \[backlog\], \[callback\])`][].

### server.listen(port[, hostname][, backlog][, callback])

Begin accepting connections on the specified `port` and `hostname`. If the
Expand Down Expand Up @@ -677,6 +684,7 @@ Returns true if input is a version 6 IP address, otherwise returns false.
[`pause()`]: #net_socket_pause
[`resume()`]: #net_socket_resume
[`server.getConnections`]: #net_server_getconnections_callback
[`server.listen(port, \[host\], \[backlog\], \[callback\])`]: #net_server_listen_port_hostname_backlog_callback
[`socket.connect(options\[, connectListener\])`]: #net_socket_connect_options_connectlistener
[`socket.connect`]: #net_socket_connect_options_connectlistener
[`socket.setTimeout()`]: #net_socket_settimeout_timeout_callback
Expand Down

0 comments on commit 9e1b7aa

Please sign in to comment.