{"maintainers":[{"name":"scravy","email":"julian@scravy.de"}],"keywords":["mac","mac-address","hardware-address","network","system"],"dist-tags":{"latest":"0.2.8"},"author":{"name":"Julian Fleischer"},"description":"Get the MAC addresses (hardware addresses) of the hosts network interfaces.","readme":"node-macaddress\n===============\n\n[![Build Status](https://travis-ci.org/scravy/node-macaddress.svg?branch=master)](https://travis-ci.org/scravy/node-macaddress)\n\nRetrieve MAC addresses in Linux, OS X, and Windows.\n\nA common misconception about MAC addresses is that every *host* had *one* MAC address,\nwhile a host may have *multiple* MAC addresses – since *every network interface* may\nhave its own MAC address.\n\nThis library allows to discover the MAC address per network interface and chooses\nan appropriate interface if all you're interested in is *one* MAC address identifying\nthe host system (see `API + Examples` below).\n\n**Features:**\n\n+ works on `Linux`, `Mac OS X`, `Windows`, and on most `UNIX` systems.\n+ `node ≥ 0.12` and `io.js` report MAC addresses in `os.networkInterfaces()`\n  this library utilizes this information when available.\n+ also features a sane replacement for `os.networkInterfaces()`\n  (see `API + Examples` below).\n+ works with stoneage node versions ≥ v0.8 (...)\n\nUsage\n-----\n\n```\nnpm install --save macaddress\n```\n\n```JavaScript\nvar macaddress = require('macaddress');\n```\n\nAPI + Examples\n--------------\n\n    (async)  .one(iface, callback) → string\n    (async)  .one(callback)        → string\n    (async)  .all(callback)        → { iface: { type: address } }\n    (sync)   .networkInterfaces()  → { iface: { type: address } }\n\n---\n\n### `.one([iface], callback)`\n\nRetrieves the MAC address of the given `iface`.\n\nIf `iface` is omitted, this function automatically chooses an\nappropriate device (e.g. `eth0` in Linux, `en0` in OS X, etc.).\n\n**Without `iface` parameter:**\n\n```JavaScript\nmacaddress.one(function (err, mac) {\n  console.log(\"Mac address for this host: %s\", mac);  \n});\n```\n\n```\n→ Mac address for this host: ab:42:de:13:ef:37\n```\n\n**With `iface` parameter:**\n\n```JavaScript\nmacaddress.one('awdl0', function (err, mac) {\n  console.log(\"Mac address for awdl0: %s\", mac);  \n});\n```\n\n```\n→ Mac address for awdl0: ab:cd:ef:34:12:56\n```\n\n---\n\n### `.all(callback)`\n\nRetrieves the MAC addresses for all non-internal interfaces.\n\n```JavaScript\nmacaddress.all(function (err, all) {\n  console.log(JSON.stringify(all, null, 2));\n});\n```\n\n```JavaScript\n{\n  \"en0\": {\n    \"ipv6\": \"fe80::cae0:ebff:fe14:1da9\",\n    \"ipv4\": \"192.168.178.20\",\n    \"mac\": \"ab:42:de:13:ef:37\"\n  },\n  \"awdl0\": {\n    \"ipv6\": \"fe80::58b9:daff:fea9:23a9\",\n    \"mac\": \"ab:cd:ef:34:12:56\"\n  }\n}\n```\n\n---\n\n### `.networkInterfaces()`\n\nA useful replacement of `os.networkInterfaces()`. Reports only non-internal interfaces.\n\n```JavaScript\nconsole.log(JSON.stringify(macaddress.networkInterfaces(), null, 2));\n```\n\n```JavaScript\n{\n  \"en0\": {\n    \"ipv6\": \"fe80::cae0:ebff:fe14:1dab\",\n    \"ipv4\": \"192.168.178.22\"\n  },\n  \"awdl0\": {\n    \"ipv6\": \"fe80::58b9:daff:fea9:23a9\"\n  }\n}\n```\n\n","repository":{"type":"git","url":"https://github.com/scravy/node-macaddress.git"},"users":{"wenhsiaoyi":true,"bitreign":true},"bugs":{"url":"https://github.com/scravy/node-macaddress/issues"},"license":"MIT","versions":{"0.2.6":{"name":"macaddress","version":"0.2.6","description":"Get the MAC addresses (hardware addresses) of the hosts network interfaces.","main":"index.js","scripts":{"test":"node test.js"},"repository":{"type":"git","url":"https://github.com/scravy/node-macaddress.git"},"keywords":["mac","mac-address","hardware-address","network","system"],"author":{"name":"Julian Fleischer"},"license":"MIT","bugs":{"url":"https://github.com/scravy/node-macaddress/issues"},"homepage":"https://github.com/scravy/node-macaddress","gitHead":"4229bb4a1c8f74117bf322ddee45709e4283f980","_id":"macaddress@0.2.6","_shasum":"df6c7ade4c49c605c9237a360d8da5f67260f878","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"scravy","email":"julian@scravy.de"},"maintainers":[{"name":"scravy","email":"julian@scravy.de"}],"dist":{"shasum":"df6c7ade4c49c605c9237a360d8da5f67260f878","tarball":"http://nexus.dui88.com:8081/nexus/content/groups/npm-all/macaddress/-/macaddress-0.2.6.tgz"},"directories":{}},"0.2.7":{"name":"macaddress","version":"0.2.7","description":"Get the MAC addresses (hardware addresses) of the hosts network interfaces.","main":"index.js","scripts":{"test":"node test.js"},"repository":{"type":"git","url":"https://github.com/scravy/node-macaddress.git"},"keywords":["mac","mac-address","hardware-address","network","system"],"author":{"name":"Julian Fleischer"},"license":"MIT","bugs":{"url":"https://github.com/scravy/node-macaddress/issues"},"homepage":"https://github.com/scravy/node-macaddress","gitHead":"c22135728ddbaa05f70528df4d1bf77a4a4efd94","_id":"macaddress@0.2.7","_shasum":"145b1dc1dcf68dd8686f5ce4eeb0034e13578dd4","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"scravy","email":"julian@scravy.de"},"maintainers":[{"name":"scravy","email":"julian@scravy.de"}],"dist":{"shasum":"145b1dc1dcf68dd8686f5ce4eeb0034e13578dd4","tarball":"http://nexus.dui88.com:8081/nexus/content/groups/npm-all/macaddress/-/macaddress-0.2.7.tgz"},"directories":{}},"0.2.8":{"name":"macaddress","version":"0.2.8","description":"Get the MAC addresses (hardware addresses) of the hosts network interfaces.","main":"index.js","scripts":{"test":"node test.js"},"repository":{"type":"git","url":"https://github.com/scravy/node-macaddress.git"},"keywords":["mac","mac-address","hardware-address","network","system"],"author":{"name":"Julian Fleischer"},"license":"MIT","bugs":{"url":"https://github.com/scravy/node-macaddress/issues"},"homepage":"https://github.com/scravy/node-macaddress","gitHead":"fac7dd3da9b3229b86655fd3e183e40dac48f01b","_id":"macaddress@0.2.8","_shasum":"5904dc537c39ec6dbefeae902327135fa8511f12","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"scravy","email":"julian@scravy.de"},"maintainers":[{"name":"scravy","email":"julian@scravy.de"}],"dist":{"shasum":"5904dc537c39ec6dbefeae902327135fa8511f12","tarball":"http://nexus.dui88.com:8081/nexus/content/groups/npm-all/macaddress/-/macaddress-0.2.8.tgz"},"directories":{}}},"name":"macaddress","time":{"modified":"2017-02-01T02:02:24.675Z","created":"2015-04-26T11:03:16.243Z","0.2.6":"2015-04-26T11:03:16.243Z","0.2.7":"2015-04-26T11:54:53.233Z","0.2.8":"2015-04-26T12:44:59.877Z"},"readmeFilename":"README.md","homepage":"https://github.com/scravy/node-macaddress"}