node-abstractsocket
Because I like my sockets like my Picasso paintings: abstract.
Abstract what?
Go read this: http://man7.org/linux/man-pages/man7/unix.7.html, I'll wait.
Examples
Server:
// abstract echo serverconst abs = ; const server = abs;server;
Client:
const abs = ; var client = abs; client; processstdin;processstdin;
API
abs.createServer(connectionListener)
Returns a new AbstractSocketServer
object. listen
can be called on
it passing the name of the abstract socket to bind to and listen, it follows
the API used for normal Unix domain sockets. NOTE: you must prepend the path with
the NULL byte ('\0') to indicate it's an abstract socket.
Emits an error if the socket(2)
system call fails.
AbstractSocketServer.listen(name, [callback]
Binds the server to the specified abstract socket name.
Emits an error if the bind(2)
system call fails, or the given name
is invalid.
This function is asynchronous. When the server has been bound, 'listening' event will be emitted. the last parameter callback will be added as an listener for the 'listening' event.
abs.connect(name, connectListener)
Creates a connection to the given path
in the abstract domain. NOTE: you must
prepend the path with the NULL byte ('\0') to indicate it's an abstract
socket.
Returns a new net.Socket object.
Emits an error if the socket(2)
or connect(2)
system calls fail,
or the given name
is invalid.
Tests
Run tests with npm test
.
Thanks
I borrowed massive amounts of inspiration/code from node-unix-dgram by @bnoordhuis :-)
@mmalecki taught me how to inherit like a pro. @randunel refactored it heavily in v2.