Skip to content
Parse a passwd file into a list of users.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
test tests Oct 19, 2016
.editorconfig first commit Oct 19, 2016
.gitattributes first commit Oct 19, 2016
.gitignore first commit Oct 19, 2016
.travis.yml test on all platforms and all versions of node.js Oct 19, 2016 init Oct 19, 2016
LICENSE first commit Oct 19, 2016 generate readme documentation with verb Oct 19, 2016
appveyor.yml add appveyor config Oct 19, 2016 first commit Oct 19, 2016
package.json 1.0.0 Oct 19, 2016

parse-passwd NPM version NPM downloads Linux Build Status Windows Build Status

Parse a passwd file into a list of users.


Install with npm:

$ npm install --save parse-passwd


var parse = require('parse-passwd');



// assuming '/etc/passwd' contains:
// doowb:*:123:123:Brian Woodward:/Users/doowb:/bin/bash
console.log(parse(fs.readFileSync('/etc/passwd', 'utf8')));

//=> [
//=>   {
//=>     username: 'doowb',
//=>     password: '*',
//=>     uid: '123',
//=>     gid: '123',
//=>     gecos: 'Brian Woodward',
//=>     homedir: '/Users/doowb',
//=>     shell: '/bin/bash'
//=>   }
//=> ]


  • content {String}: Content of a passwd file to parse.
  • returns {Array}: Array of user objects parsed from the content.



Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Please read the contributing guide for avice on opening issues, pull requests, and coding standards.

Building docs

(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in

To generate the readme and API documentation with verb:

$ npm install -g verb verb-generate-readme && verb

Running tests

Install dev dependencies:

$ npm install -d && npm test


Brian Woodward


Copyright © 2016, Brian Woodward. Released under the MIT license.

This file was generated by verb-generate-readme, v0.2.0, on October 19, 2016.

You can’t perform that action at this time.