drivelist

List all connected drives in your computer, in all major operating systems.


Notice that this module does not require admin privileges to get the drives in any supported operating system.

Supports:

• Windows.
• GNU/Linux distributions that include util-linux and udev.
• Mac OS X.

Examples (the output will vary depending on your machine):

var drivelist = require('drivelist');

drivelist.list(function(error, disks) {
    if (error) throw error;
    console.log(disks);
});

---

Mac OS X:

[
  {
    device: '/dev/disk0',
    description: 'GUID_partition_scheme',
    size: 68719476736,
    mountpoint: '/',
    name: /dev/disk0,
    raw: /dev/rdisk0,
    protected: false,
    system: true
  },
  {
    device: '/dev/disk1',
    description: 'Apple_HFS Macintosh HD',
    size: 68719476736,
    name: /dev/disk1,
    raw: /dev/rdisk0,
    protected: false,
    system: true
  }
]

---

GNU/Linux

[
  {
    device: '/dev/sda',
    description: 'WDC WD10JPVX-75J',
    size: 68719476736,
    mountpoint: '/',
    name: '/dev/sda',
    raw: '/dev/sda',
    protected: false,
    system: true
  },
  {
    device: '/dev/sdb',
    description: 'DataTraveler 2.0',
    size: 7823458304,
    mountpoint: '/media/UNTITLED',
    name: '/dev/sdb',
    raw: '/dev/sdb',
    protected: true,
    system: false
  }
]

---

Windows

[
  {
    device: '\\\\.\\PHYSICALDRIVE0',
    description: 'WDC WD10JPVX-75JC3T0',
    size: 68719476736,
    mountpoint: 'C:',
    name: 'C:',
    raw: '\\\\.\\PHYSICALDRIVE0',
    protected: false,
    system: true
  },
  {
    device: '\\\\.\\PHYSICALDRIVE1',
    description: 'Generic STORAGE DEVICE USB Device',
    size: 7823458304,
    mountpoint: 'D:',
    name: 'D:',
    raw: '\\\\.\\PHYSICALDRIVE1',
    protected: true,
    system: false
  }
]

Installation

Install drivelist by running:

$ npm install --save drivelist

Documentation

drivelist.list(callback)

List available drives.

The function will throw an error if you attempt to call it from an unsupported operating system.

callback(error, drives)

• error is a possible error.
• drives is an array of objects describing the drives found.

Tests

Run the test suite by doing:

$ gulp test

Contribute

We're looking forward to support more operating systems. Please raise an issue or even better, send a PR to increase support!

• Issue Tracker: github.com/resin-io-modules/drivelist/issues
• Source Code: github.com/resin-io-modules/drivelist

Before submitting a PR, please make sure that you include tests, and that coffeelint runs without any warning:

$ gulp lint

Support

If you're having any problem, please raise an issue on GitHub.

License

The project is licensed under the MIT license.