Skip to content

🆔 Reads the machine's serial number (a.k.a. service/asset tag) or Amazon EC2 instance-id

License

Notifications You must be signed in to change notification settings

Lightspeed-Systems/serial-number

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Serial Number

A simple Node.js module for accessing the serial number (a.k.a. Dell Service Tag, asset tag) of the local machine. Supports Linux, Mac (OS X), Windows, and FreeBSD. On Amazon EC2 instances, it will return the instance-id.

Installation

npm install serial-number

And/or install globally for a serial-number shell command: [sudo] npm install -g serial-number

Usage

The serial number value is retrieved from the system asynchronously and passed to a callback.

var serialNumber = require('serial-number');

serialNumber(function (err, value) {
	console.log(value);
});

If the serial number turns out to be invalid (common on VMs), the system's UUID value will be provided as a fallback. To instead try to get the UUID on the first attempt, set the preferUUID flag:

serialNumber.preferUUID = true;

To prefix the system command with sudo use the useSudo method:

serialNumber.useSudo(function (err, value) {
	console.log(value);
});

For the CLI command it's just

$ serial-number
A12B3C4DE5FG

The CLI provides a couple options:

  • --uuid: Equivalent to the preferUUID setting as above.
  • --cmdprefix <prefix>: Sets a string to be prefixed ahead of the shell command to be run. Can be used to specify a path to the dmidecode binary on *nix systems if it won't be found in the environment $PATH
$ serial-number --uuid --cmdprefix "/usr/sbin/"
1234AABB-C5DE-678F-G9HI-J01K2LM34N5A

License

ISC

About

🆔 Reads the machine's serial number (a.k.a. service/asset tag) or Amazon EC2 instance-id

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%