5abf040b42 | ||
---|---|---|
.. | ||
LICENSE | ||
README.md | ||
android.js | ||
darwin.js | ||
freebsd.js | ||
ibmi.js | ||
index.js | ||
linux.js | ||
openbsd.js | ||
package.json | ||
sunos.js | ||
win32.js |
README.md
default-gateway
Get the default network gateway, cross-platform.
Obtains the machine's default gateway through exec
calls to OS routing interfaces. On Linux and Android, the ip
command must be available (usually provided by the iproute2
package). On IBM i, the db2util
command must be available (provided by the db2util
package).
Installation
$ npm install default-gateway
Example
const defaultGateway = require('default-gateway');
defaultGateway.v4().then(result => {
// result = {gateway: '1.2.3.4', interface: 'en1'}
});
defaultGateway.v6().then(result => {
// result = {gateway: '2001:db8::1', interface: 'en2'}
});
const result = defaultGateway.v4.sync();
// result = {gateway: '1.2.3.4', interface: 'en1'}
const result = defaultGateway.v6.sync();
// result = {gateway: '2001:db8::1', interface: 'en2'}
API
defaultGateway.v4()
defaultGateway.v6()
defaultGateway.v4.sync()
defaultGateway.v6.sync()
Returns: result
Object
gateway
: The IP address of the default gateway.interface
: The name of the interface. On Windows, this is the network adapter name.
The .v{4,6}()
methods return a Promise while the .v{4,6}.sync()
variants will return the result synchronously.
The gateway
property will always be defined on success, while interface
can be null
if it cannot be determined. All methods reject/throw on unexpected conditions.
License
© silverwind, distributed under BSD licence