'use strict';

const events = require('events');

const stream = require('stream');

const timers = require('timers');

const util = require('util');

const internalUtil = require('internal/util');

const assert = require('assert');

const cares = process.binding('cares_wrap');

const uv = process.binding('uv');

const Buffer = require('buffer').Buffer;

const TTYWrap = process.binding('tty_wrap');

const TCP = process.binding('tcp_wrap').TCP;

const Pipe = process.binding('pipe_wrap').Pipe;

const TCPConnectWrap = process.binding('tcp_wrap').TCPConnectWrap;

const PipeConnectWrap = process.binding('pipe_wrap').PipeConnectWrap;

const ShutdownWrap = process.binding('stream_wrap').ShutdownWrap;

const WriteWrap = process.binding('stream_wrap').WriteWrap;

var cluster;

const errnoException = util._errnoException;

const exceptionWithHostPort = util._exceptionWithHostPort;

function noop() {}

function createHandle(fd) {

var type = TTYWrap.guessHandleType(fd);

if (type === 'PIPE') return new Pipe();

if (type === 'TCP') return new TCP();

throw new TypeError('Unsupported fd type: ' + type);

}

const debug = util.debuglog('net');

function isPipeName(s) {

return typeof s === 'string' && toNumber(s) === false;

}

exports.createServer = function(options, connectionListener) {

return new Server(options, connectionListener);

};

// Target API:

//

// var s = net.connect({port: 80, host: 'google.com'}, function() {

// ...

// });

//

// There are various forms:

//

// connect(options, [cb])

// connect(port, [host], [cb])

// connect(path, [cb]);

//

exports.connect = exports.createConnection = function() {

var args = normalizeConnectArgs(arguments);

debug('createConnection', args);

var s = new Socket(args[0]);

return Socket.prototype.connect.apply(s, args);

};

// Returns an array [options] or [options, cb]

// It is the same as the argument of Socket.prototype.connect().

function normalizeConnectArgs(args) {

var options = {};

if (args[0] !== null && typeof args[0] === 'object') {

// connect(options, [cb])

options = args[0];

} else if (isPipeName(args[0])) {

// connect(path, [cb]);

options.path = args[0];

} else {

// connect(port, [host], [cb])

options.port = args[0];

if (typeof args[1] === 'string') {

options.host = args[1];

}

}

var cb = args[args.length - 1];

return typeof cb === 'function' ? [options, cb] : [options];

}

exports._normalizeConnectArgs = normalizeConnectArgs;

// called when creating new Socket, or when re-using a closed Socket

function initSocketHandle(self) {

self.destroyed = false;

self.bytesRead = 0;

self._bytesDispatched = 0;

// Handle creation may be deferred to bind() or connect() time.

if (self._handle) {

self._handle.owner = self;

self._handle.onread = onread;

// If handle doesn't support writev - neither do we

if (!self._handle.writev)

self._writev = null;

}

}

function Socket(options) {

if (!(this instanceof Socket)) return new Socket(options);

this._connecting = false;

this._hadError = false;

this._handle = null;

this._parent = null;

this._host = null;

if (typeof options === 'number')

options = { fd: options }; // Legacy interface.

else if (options === undefined)

options = {};

stream.Duplex.call(this, options);

if (options.handle) {

this._handle = options.handle; // private

} else if (options.fd !== undefined) {

this._handle = createHandle(options.fd);

this._handle.open(options.fd);

if ((options.fd == 1 || options.fd == 2) &&

(this._handle instanceof Pipe) &&

process.platform === 'win32') {

// Make stdout and stderr blocking on Windows

var err = this._handle.setBlocking(true);

if (err)

throw errnoException(err, 'setBlocking');

}

this.readable = options.readable !== false;

this.writable = options.writable !== false;

} else {

// these will be set once there is a connection

this.readable = this.writable = false;

}

// shut down the socket when we're finished with it.

this.on('finish', onSocketFinish);

this.on('_socketEnd', onSocketEnd);

initSocketHandle(this);

this._pendingData = null;

this._pendingEncoding = '';

// handle strings directly

this._writableState.decodeStrings = false;

// default to *not* allowing half open sockets

this.allowHalfOpen = options && options.allowHalfOpen || false;

// if we have a handle, then start the flow of data into the

// buffer. if not, then this will happen when we connect

if (this._handle && options.readable !== false) {

if (options.pauseOnCreate) {

// stop the handle from reading and pause the stream

this._handle.reading = false;

this._handle.readStop();

this._readableState.flowing = false;

} else {

this.read(0);

}

}

}

util.inherits(Socket, stream.Duplex);

Socket.prototype._unrefTimer = function unrefTimer() {

for (var s = this; s !== null; s = s._parent)

timers._unrefActive(s);

};

// the user has called .end(), and all the bytes have been

// sent out to the other side.

// If allowHalfOpen is false, or if the readable side has

// ended already, then destroy.

// If allowHalfOpen is true, then we need to do a shutdown,

// so that only the writable side will be cleaned up.

function onSocketFinish() {

// If still connecting - defer handling 'finish' until 'connect' will happen

if (this._connecting) {

debug('osF: not yet connected');

return this.once('connect', onSocketFinish);

}

debug('onSocketFinish');

if (!this.readable || this._readableState.ended) {

debug('oSF: ended, destroy', this._readableState);

return this.destroy();

}

debug('oSF: not ended, call shutdown()');

// otherwise, just shutdown, or destroy() if not possible

if (!this._handle || !this._handle.shutdown)

return this.destroy();

var req = new ShutdownWrap();

req.oncomplete = afterShutdown;

req.handle = this._handle;

var err = this._handle.shutdown(req);

if (err)

return this._destroy(errnoException(err, 'shutdown'));

}

function afterShutdown(status, handle, req) {

var self = handle.owner;

debug('afterShutdown destroyed=%j', self.destroyed,

self._readableState);

// callback may come after call to destroy.

if (self.destroyed)

return;

if (self._readableState.ended) {

debug('readableState ended, destroying');

self.destroy();

} else {

self.once('_socketEnd', self.destroy);

}

}

// the EOF has been received, and no more bytes are coming.

// if the writable side has ended already, then clean everything

// up.

function onSocketEnd() {

// XXX Should not have to do as much crap in this function.

// ended should already be true, since this is called *after*

// the EOF errno and onread has eof'ed

debug('onSocketEnd', this._readableState);

this._readableState.ended = true;

if (this._readableState.endEmitted) {

this.readable = false;

maybeDestroy(this);

} else {

this.once('end', function() {

this.readable = false;

maybeDestroy(this);

});

this.read(0);

}

if (!this.allowHalfOpen) {

this.write = writeAfterFIN;

this.destroySoon();

}

}

// Provide a better error message when we call end() as a result

// of the other side sending a FIN. The standard 'write after end'

// is overly vague, and makes it seem like the user's code is to blame.

function writeAfterFIN(chunk, encoding, cb) {

if (typeof encoding === 'function') {

cb = encoding;

encoding = null;

}

var er = new Error('This socket has been ended by the other party');

er.code = 'EPIPE';

var self = this;

// TODO: defer error events consistently everywhere, not just the cb

self.emit('error', er);

if (typeof cb === 'function') {

process.nextTick(cb, er);

}

}

exports.Socket = Socket;

exports.Stream = Socket; // Legacy naming.

Socket.prototype.read = function(n) {

if (n === 0)

return stream.Readable.prototype.read.call(this, n);

this.read = stream.Readable.prototype.read;

this._consuming = true;

return this.read(n);

};

Socket.prototype.listen = function() {

debug('socket.listen');

var self = this;

self.on('connection', arguments[0]);

listen(self, null, null, null);

};

Socket.prototype.setTimeout = function(msecs, callback) {

if (msecs === 0) {

timers.unenroll(this);

if (callback) {

this.removeListener('timeout', callback);

}

} else {

timers.enroll(this, msecs);

timers._unrefActive(this);

if (callback) {

this.once('timeout', callback);

}

}

return this;

};

Socket.prototype._onTimeout = function() {

debug('_onTimeout');

this.emit('timeout');

};

Socket.prototype.setNoDelay = function(enable) {

if (!this._handle) {

this.once('connect',

enable ? this.setNoDelay : this.setNoDelay.bind(this, enable));

return this;

}

// backwards compatibility: assume true when `enable` is omitted

if (this._handle.setNoDelay)

this._handle.setNoDelay(enable === undefined ? true : !!enable);

return this;

};

Socket.prototype.setKeepAlive = function(setting, msecs) {

if (!this._handle) {

this.once('connect', this.setKeepAlive.bind(this, setting, msecs));

return this;

}

if (this._handle.setKeepAlive)

this._handle.setKeepAlive(setting, ~~(msecs / 1000));

return this;

};

Socket.prototype.address = function() {

return this._getsockname();

};

Object.defineProperty(Socket.prototype, 'readyState', {

get: function() {

if (this._connecting) {

return 'opening';

} else if (this.readable && this.writable) {

return 'open';

} else if (this.readable && !this.writable) {

return 'readOnly';

} else if (!this.readable && this.writable) {

return 'writeOnly';

} else {

return 'closed';

}

}

});

Object.defineProperty(Socket.prototype, 'bufferSize', {

get: function() {

if (this._handle) {

return this._handle.writeQueueSize + this._writableState.length;

}

}

});

// Just call handle.readStart until we have enough in the buffer

Socket.prototype._read = function(n) {

debug('_read');

if (this._connecting || !this._handle) {

debug('_read wait for connection');

this.once('connect', this._read.bind(this, n));

} else if (!this._handle.reading) {

// not already reading, start the flow

debug('Socket._read readStart');

this._handle.reading = true;

var err = this._handle.readStart();

if (err)

this._destroy(errnoException(err, 'read'));

}

};

Socket.prototype.end = function(data, encoding) {

stream.Duplex.prototype.end.call(this, data, encoding);

this.writable = false;

DTRACE_NET_STREAM_END(this);

LTTNG_NET_STREAM_END(this);

// just in case we're waiting for an EOF.

if (this.readable && !this._readableState.endEmitted)

this.read(0);

else

maybeDestroy(this);

};

// Call whenever we set writable=false or readable=false

function maybeDestroy(socket) {

if (!socket.readable &&

!socket.writable &&

!socket.destroyed &&

!socket._connecting &&

!socket._writableState.length) {

socket.destroy();

}

}

Socket.prototype.destroySoon = function() {

if (this.writable)

this.end();

if (this._writableState.finished)

this.destroy();

else

this.once('finish', this.destroy);

};

Socket.prototype._destroy = function(exception, cb) {

debug('destroy');

var self = this;

function fireErrorCallbacks() {

if (cb) cb(exception);

if (exception && !self._writableState.errorEmitted) {

process.nextTick(emitErrorNT, self, exception);

self._writableState.errorEmitted = true;

}

}

if (this.destroyed) {

debug('already destroyed, fire error callbacks');

fireErrorCallbacks();

return;

}

self._connecting = false;

this.readable = this.writable = false;

for (var s = this; s !== null; s = s._parent)

timers.unenroll(s);

debug('close');

if (this._handle) {

if (this !== process.stderr)

debug('close handle');

var isException = exception ? true : false;

this._handle.close(function() {

debug('emit close');

self.emit('close', isException);

});

this._handle.onread = noop;

this._handle = null;

}

// we set destroyed to true before firing error callbacks in order

// to make it re-entrance safe in case Socket.prototype.destroy()

// is called within callbacks

this.destroyed = true;

fireErrorCallbacks();

if (this.server) {

COUNTER_NET_SERVER_CONNECTION_CLOSE(this);

debug('has server');

this.server._connections--;

if (this.server._emitCloseIfDrained) {

this.server._emitCloseIfDrained();

}

}

};

Socket.prototype.destroy = function(exception) {

debug('destroy', exception);

this._destroy(exception);

};

// This function is called whenever the handle gets a

// buffer, or when there's an error reading.

function onread(nread, buffer) {

var handle = this;

var self = handle.owner;

assert(handle === self._handle, 'handle != self._handle');

self._unrefTimer();

debug('onread', nread);

if (nread > 0) {

debug('got data');

// read success.

// In theory (and in practice) calling readStop right now

// will prevent this from being called again until _read() gets

// called again.

// if it's not enough data, we'll just call handle.readStart()

// again right away.

self.bytesRead += nread;

// Optimization: emit the original buffer with end points

var ret = self.push(buffer);

if (handle.reading && !ret) {

handle.reading = false;

debug('readStop');

var err = handle.readStop();

if (err)

self._destroy(errnoException(err, 'read'));

}

return;

}

// if we didn't get any bytes, that doesn't necessarily mean EOF.

// wait for the next one.

if (nread === 0) {

debug('not any data, keep waiting');

return;

}

// Error, possibly EOF.

if (nread !== uv.UV_EOF) {

return self._destroy(errnoException(nread, 'read'));

}

debug('EOF');

if (self._readableState.length === 0) {

self.readable = false;

maybeDestroy(self);

}

// push a null to signal the end of data.

self.push(null);

// internal end event so that we know that the actual socket

// is no longer readable, and we can start the shutdown

// procedure. No need to wait for all the data to be consumed.

self.emit('_socketEnd');

}

Socket.prototype._getpeername = function() {

if (!this._peername) {

if (!this._handle || !this._handle.getpeername) {

return {};

}

var out = {};

var err = this._handle.getpeername(out);

if (err) return {}; // FIXME(bnoordhuis) Throw?

this._peername = out;

}

return this._peername;

};

Socket.prototype.__defineGetter__('remoteAddress', function() {

return this._getpeername().address;

});

Socket.prototype.__defineGetter__('remoteFamily', function() {

return this._getpeername().family;

});

Socket.prototype.__defineGetter__('remotePort', function() {

return this._getpeername().port;

});

Socket.prototype._getsockname = function() {

if (!this._handle || !this._handle.getsockname) {

return {};

}

if (!this._sockname) {

var out = {};

var err = this._handle.getsockname(out);

if (err) return {}; // FIXME(bnoordhuis) Throw?

this._sockname = out;

}

return this._sockname;

};

Socket.prototype.__defineGetter__('localAddress', function() {

return this._getsockname().address;

});

Socket.prototype.__defineGetter__('localPort', function() {

return this._getsockname().port;

});

Socket.prototype.write = function(chunk, encoding, cb) {

if (typeof chunk !== 'string' && !(chunk instanceof Buffer))

throw new TypeError('invalid data');

return stream.Duplex.prototype.write.apply(this, arguments);

};

Socket.prototype._writeGeneric = function(writev, data, encoding, cb) {

// If we are still connecting, then buffer this for later.

// The Writable logic will buffer up any more writes while

// waiting for this one to be done.

if (this._connecting) {

this._pendingData = data;

this._pendingEncoding = encoding;

this.once('connect', function() {

this._writeGeneric(writev, data, encoding, cb);

});

return;

}

this._pendingData = null;

this._pendingEncoding = '';

this._unrefTimer();

if (!this._handle) {

this._destroy(new Error('This socket is closed.'), cb);

return false;

}

var req = new WriteWrap();

req.handle = this._handle;

req.oncomplete = afterWrite;

req.async = false;

var err;

if (writev) {

var chunks = new Array(data.length << 1);

for (var i = 0; i < data.length; i++) {

var entry = data[i];

var chunk = entry.chunk;

var enc = entry.encoding;

chunks[i * 2] = chunk;

chunks[i * 2 + 1] = enc;

}

err = this._handle.writev(req, chunks);

// Retain chunks

if (err === 0) req._chunks = chunks;

} else {

var enc;

if (data instanceof Buffer) {

req.buffer = data; // Keep reference alive.

enc = 'buffer';

} else {

enc = encoding;

}

err = createWriteReq(req, this._handle, data, enc);

}

if (err)

return this._destroy(errnoException(err, 'write', req.error), cb);

this._bytesDispatched += req.bytes;

// If it was entirely flushed, we can write some more right now.

// However, if more is left in the queue, then wait until that clears.

if (req.async && this._handle.writeQueueSize != 0)

req.cb = cb;

else

cb();

};

Socket.prototype._writev = function(chunks, cb) {

this._writeGeneric(true, chunks, '', cb);

};

Socket.prototype._write = function(data, encoding, cb) {

this._writeGeneric(false, data, encoding, cb);

};

function createWriteReq(req, handle, data, encoding) {

switch (encoding) {

case 'binary':

return handle.writeBinaryString(req, data);

case 'buffer':

return handle.writeBuffer(req, data);

case 'utf8':

case 'utf-8':

return handle.writeUtf8String(req, data);

case 'ascii':

return handle.writeAsciiString(req, data);

case 'ucs2':

case 'ucs-2':

case 'utf16le':

case 'utf-16le':

return handle.writeUcs2String(req, data);

default:

return handle.writeBuffer(req, new Buffer(data, encoding));

}

}

Socket.prototype.__defineGetter__('bytesWritten', function() {

var bytes = this._bytesDispatched,

state = this._writableState,

data = this._pendingData,

encoding = this._pendingEncoding;

state.getBuffer().forEach(function(el) {

if (el.chunk instanceof Buffer)

bytes += el.chunk.length;

else

bytes += Buffer.byteLength(el.chunk, el.encoding);

});

if (data) {

if (data instanceof Buffer)

bytes += data.length;

else

bytes += Buffer.byteLength(data, encoding);

}

return bytes;

});

function afterWrite(status, handle, req, err) {

var self = handle.owner;

if (self !== process.stderr && self !== process.stdout)

debug('afterWrite', status);

// callback may come after call to destroy.

if (self.destroyed) {

debug('afterWrite destroyed');

return;

}

if (status < 0) {

var ex = exceptionWithHostPort(status, 'write', req.address, req.port);

debug('write failure', ex);

self._destroy(ex, req.cb);

return;

}

self._unrefTimer();

if (self !== process.stderr && self !== process.stdout)

debug('afterWrite call cb');

if (req.cb)

req.cb.call(self);

}

function connect(self, address, port, addressType, localAddress, localPort) {

// TODO return promise from Socket.prototype.connect which

// wraps _connectReq.

assert.ok(self._connecting);

var err;

if (localAddress || localPort) {

var bind;

if (addressType === 4) {

localAddress = localAddress || '0.0.0.0';

bind = self._handle.bind;

} else if (addressType === 6) {

localAddress = localAddress || '::';

bind = self._handle.bind6;

} else {

self._destroy(new TypeError('Invalid addressType: ' + addressType));

return;

}

debug('binding to localAddress: %s and localPort: %d',

localAddress,

localPort);

bind = bind.bind(self._handle);

err = bind(localAddress, localPort);

if (err) {

var ex = exceptionWithHostPort(err, 'bind', localAddress, localPort);

self._destroy(ex);

return;

}

}

if (addressType === 6 || addressType === 4) {

var req = new TCPConnectWrap();

req.oncomplete = afterConnect;

req.address = address;

req.port = port;

if (addressType === 4)

err = self._handle.connect(req, address, port);

else

err = self._handle.connect6(req, address, port);

} else {

var req = new PipeConnectWrap();

req.address = address;

req.oncomplete = afterConnect;

err = self._handle.connect(req, address, afterConnect);

}

if (err) {

var sockname = self._getsockname();

var details;

if (sockname) {

details = sockname.address + ':' + sockname.port;

}

var ex = exceptionWithHostPort(err, 'connect', address, port, details);

self._destroy(ex);

}

}

// Check that the port number is not NaN when coerced to a number,

// is an integer and that it falls within the legal range of port numbers.

function isLegalPort(port) {

if (typeof port === 'string' && port.trim() === '')

return false;

return +port === (port >>> 0) && port >= 0 && port <= 0xFFFF;

}

Socket.prototype.connect = function(options, cb) {

if (this.write !== Socket.prototype.write)

this.write = Socket.prototype.write;

if (options === null || typeof options !== 'object') {

// Old API:

// connect(port, [host], [cb])

// connect(path, [cb]);

var args = normalizeConnectArgs(arguments);

return Socket.prototype.connect.apply(this, args);

}

if (this.destroyed) {

this._readableState.reading = false;

this._readableState.ended = false;

this._readableState.endEmitted = false;

this._writableState.ended = false;

this._writableState.ending = false;

this._writableState.finished = false;

this._writableState.errorEmitted = false;

this.destroyed = false;

this._handle = null;

this._peername = null;

}

var self = this;

var pipe = !!options.path;

debug('pipe', pipe, options.path);

if (!this._handle) {

this._handle = pipe ? new Pipe() : new TCP();

initSocketHandle(this);

}

if (typeof cb === 'function') {

self.once('connect', cb);

}

this._unrefTimer();

self._connecting = true;

self.writable = true;

if (pipe) {

connect(self, options.path);

} else {

lookupAndConnect(self, options);

}

return self;

};

function lookupAndConnect(self, options) {

const dns = require('dns');

var host = options.host || 'localhost';

var port = options.port;

var localAddress = options.localAddress;

var localPort = options.localPort;

if (localAddress && !exports.isIP(localAddress))

throw new TypeError('localAddress must be a valid IP: ' + localAddress);

if (localPort && typeof localPort !== 'number')

throw new TypeError('localPort should be a number: ' + localPort);

if (typeof port !== 'undefined') {

if (typeof port !== 'number' && typeof port !== 'string')

throw new TypeError('port should be a number or string: ' + port);

if (!isLegalPort(port))

throw new RangeError('port should be >= 0 and < 65536: ' + port);

}

port |= 0;

// If host is an IP, skip performing a lookup

// TODO(evanlucas) should we hot path this for localhost?

var addressType = exports.isIP(host);

if (addressType) {

process.nextTick(function() {

if (self._connecting)

connect(self, host, port, addressType, localAddress, localPort);

});

return;

}

if (options.lookup && typeof options.lookup !== 'function')

throw new TypeError('options.lookup should be a function.');

var dnsopts = {

family: options.family,

hints: 0

};

if (dnsopts.family !== 4 && dnsopts.family !== 6)

dnsopts.hints = dns.ADDRCONFIG | dns.V4MAPPED;

debug('connect: find host ' + host);

debug('connect: dns options', dnsopts);

self._host = host;

var lookup = options.lookup || dns.lookup;

lookup(host, dnsopts, function(err, ip, addressType) {

self.emit('lookup', err, ip, addressType);

// It's possible we were destroyed while looking this up.

// XXX it would be great if we could cancel the promise returned by

// the look up.

if (!self._connecting) return;

if (err) {

// net.createConnection() creates a net.Socket object and

// immediately calls net.Socket.connect() on it (that's us).

// There are no event listeners registered yet so defer the

// error event to the next tick.

err.host = options.host;

err.port = options.port;

err.message = err.message + ' ' + options.host + ':' + options.port;

process.nextTick(connectErrorNT, self, err);

} else {

self._unrefTimer();

connect(self,

ip,

port,

addressType,

localAddress,

localPort);

}

});

}

function connectErrorNT(self, err) {

self.emit('error', err);

self._destroy();

}

Socket.prototype.ref = function() {

if (!this._handle) {

this.once('connect', this.ref);

return this;

}

this._handle.ref();

return this;

};

Socket.prototype.unref = function() {

if (!this._handle) {