Browse Source

doc: improve server.listen() documentation prose

PR-URL: https://github.com/nodejs/node/pull/7000
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Yuval Brik <yuval@brik.org.il>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Santiago Gimeno <santiago.gimeno@gmail.com>
v7.x
Rich Trott 9 years ago
committed by James M Snell
parent
commit
6306b10c48
  1. 8
      doc/api/net.md

8
doc/api/net.md

@ -182,8 +182,8 @@ Begin accepting connections on the specified `port` and `hostname`. If the
port value of zero will assign a random port. port value of zero will assign a random port.
Backlog is the maximum length of the queue of pending connections. 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 The actual length will be determined by the OS through sysctl settings such as
`tcp_max_syn_backlog` and `somaxconn` on linux. The default value of this `tcp_max_syn_backlog` and `somaxconn` on Linux. The default value of this
parameter is 511 (not 512). parameter is 511 (not 512).
This function is asynchronous. When the server has been bound, This function is asynchronous. When the server has been bound,
@ -192,7 +192,7 @@ will be added as a listener for the [`'listening'`][] event.
One issue some users run into is getting `EADDRINUSE` errors. This means that One issue some users run into is getting `EADDRINUSE` errors. This means that
another server is already running on the requested port. One way of handling this another server is already running on the requested port. One way of handling this
would be to wait a second and then try again. This can be done with would be to wait a second and then try again:
```js ```js
server.on('error', (e) => { server.on('error', (e) => {
@ -206,7 +206,7 @@ server.on('error', (e) => {
}); });
``` ```
(Note: All sockets in Node.js set `SO_REUSEADDR` already) (Note: All sockets in Node.js are set `SO_REUSEADDR`.)
### server.listening ### server.listening

Loading…
Cancel
Save