aboutsummaryrefslogtreecommitdiff
path: root/node_modules/killable/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/killable/README.md')
-rw-r--r--node_modules/killable/README.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/node_modules/killable/README.md b/node_modules/killable/README.md
new file mode 100644
index 00000000..9fe06dba
--- /dev/null
+++ b/node_modules/killable/README.md
@@ -0,0 +1,55 @@
+killable
+========
+
+Keeps track of a server's open sockets so they can be destroyed at a
+moment's notice. This way, the server connection can be killed very
+fast.
+
+Installation
+------------
+
+```
+npm install killable
+```
+
+Example usage
+-------------
+
+Using express:
+('server' in the example is just an ``http.server``, so other frameworks
+or pure Node should work just as well.)
+
+```javascript
+var killable = require('killable');
+
+var app = require('express')();
+var server;
+
+app.route('/', function (req, res, next) {
+ res.send('Server is going down NOW!');
+
+ server.kill(function () {
+ //the server is down when this is called. That won't take long.
+ });
+});
+
+var server = app.listen(8080);
+killable(server);
+```
+
+API
+---
+
+The ``killable`` module is callable. When you call it on a Node
+``http.Server`` object, it will add a ``server.kill()`` method on it. It
+returns the server object.
+
+``server.kill([callback])`` closes all open sockets and calls
+``server.close()``, to which the ``callback`` is passed on.
+
+Inspired by: http://stackoverflow.com/a/14636625
+
+License
+-------
+
+ISC