NodeJS provides an interface to using the
sendfile(2) system call.
Briefly, this system call allows the kernel to efficiently transport
data from a file on-disk to a socket without round-tripping the data
through user-space. This is one of the more important techniques that
HTTP servers use to get good performance when serving static files.
Using this is slightly tricky in NodeJS, as the
sendfile(2) call is
not guaranteed to write all of a file’s data to the given socket. Just
write(2) system call, it can declare success after only
writing a portion of the file contents to the given socket. This is
commonly the case with nonblocking sockets, as files larger than the TCP
send window cannot be buffered entirely in the TCP stack. At this point,
one must wait until some of this outstanding data has been flushed to
the other end of the TCP connection.
Without further ado, the following code implements a TCP server that
sendfile(2) to transfer the contents of a file to every client
This is doing a couple of intesting things
- We use the synchronous version of the
sendfileAPI. We do this because we don’t want to round-trip through the libeio thread pool.
- We need to handle the
EAGAINerror status from the
sendfile(2)system call. NodeJS exposes this via a thrown exception. Rather than issuing another
sendfilecall right away, we wait until the socket is drained to try again (otherwise we’re just busy-waiting). It’s possible that the performance cost of generating and handling this exception is high enough that we’d be better off using the asynchronous version of the
- We have to kick the write
net.Streaminstance ourselves to get the drain event to fire. This class only knows how to start the watcher itself when it notices a
write(2)system call fail. Since we’re using
sendfile(2)behind its back, we have to tell it to do this explicitly.
- We notice that we’ve hit the end of our source file when
sendfile(2)returns 0 bytes written.