Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
unix-dgram
Advanced tools
Readme
Communicate over UNIX datagram sockets.
Server:
// One-shot server. Note that the server cannot send a reply;
// UNIX datagram sockets are unconnected and the client is not addressable.
var unix = require('unix-dgram');
var server = unix.createSocket('unix_dgram', function(buf) {
console.log('received ' + buf);
server.close();
});
server.bind('/path/to/socket');
Client:
// Send a single message to the server.
var message = Buffer('ping');
var client = unix.createSocket('unix_dgram');
client.on('error', console.error);
client.send(message, 0, message.length, '/path/to/socket');
client.close();
Caveat emptor: events and callbacks are synchronous for efficiency reasons.
Returns a new unix.Socket object. type
should be 'unix_dgram'
.
Throws an exception if the socket(2)
system call fails.
The optional listener
argument is added as a listener for the 'message'
event. The event listener receives the message as a Buffer
object as its
first argument.
Create a server at path
. Emits a 'listening'
event on success or
an 'error'
event if the bind(2)
system call fails.
Associate a socket with a remote path so you can send a message without setting
the remote path. Once the socket is connected it emits a 'connect'
event.
It also allows to perform some kind of congestion control as it emits a
'congestion'
event when the receiving buffer is full, and a 'writable'
event
when it stops being full.
Only to be used with connected sockets. It sends a message to the remote path associated with the socket
Example:
var unix = require('unix-dgram');
var client = unix.createSocket('unix_dgram');
client.on('error', function(err) {
console.error(err);
});
client.on('connect', function() {
console.log('connected');
client.on('congestion', function() {
console.log('congestion');
/* The server is not accepting data */
});
client.on('writable', function() {
console.log('writable');
/* The server can accept data */
});
var message = new Buffer('PING');
client.send(message);
});
client.connect('/tmp/server');
Send a message to the server listening at path
.
buf
is a Buffer
object containing the message to send, offset
is
the offset into the buffer and length
is the length of the message.
For backwards compatibility, you can still use the socket.send
function with
this same signature.
Example:
var buf = new Buffer('foobarbaz');
socket.send(buf, 3, 4, '/path/to/socket'); // Sends 'barb'.
Close the socket. If the socket was bound to a path with socket.bind()
,
then you will no longer receive new messages. The file system entity
(the socket file) is not automatically unlinked.
FAQs
Unix datagram socket
The npm package unix-dgram receives a total of 1,199,005 weekly downloads. As such, unix-dgram popularity was classified as popular.
We found that unix-dgram demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
Research
Security News
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
Security News
OpenJS is warning of social engineering takeovers targeting open source projects after receiving a credible attempt on the foundation.