aboutsummaryrefslogtreecommitdiff
path: root/node_modules/killable/README.md
diff options
context:
space:
mode:
authorruki <waruqi@gmail.com>2018-11-08 00:38:48 +0800
committerruki <waruqi@gmail.com>2018-11-07 21:53:09 +0800
commit26105034da4fcce7ac883c899d781f016559310d (patch)
treec459a5dc4e3aa0972d9919033ece511ce76dd129 /node_modules/killable/README.md
parent2c77f00f1a7ecb6c8192f9c16d3b2001b254a107 (diff)
downloadxmake-docs-26105034da4fcce7ac883c899d781f016559310d.tar.gz
xmake-docs-26105034da4fcce7ac883c899d781f016559310d.zip
switch to vuepress
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