Skip to content

getpwuid() Node.js binding - returns username, name, home directory, shell, gid from uid

License

Notifications You must be signed in to change notification settings

RodrigoFraga/pwuid

 
 

Repository files navigation

pwuid Build Status

getpwuid() for Node.js - returns username, name, home directory, shell, gid from uid

If you're creating a reusable module you should probably use passwd-user instead, as it shells out rather than using a native binding.

Install

$ npm install --save pwuid

This is a native binding and expects you to have the required toolchain. (ignore the node-gyp install)

Windows

getpwuid() is a POSIX function and won't work on Windows.

Use optionalDependencies if you need to include it in a cross-platform environment.

Usage

const pwuid = require('pwuid');

console.log(pwuid());
/*
{
	name: 'sindresorhus',
	uid: 501,
	gid: 20,
	gecos: 'Sindre Sorhus',
	dir: '/Users/sindresorhus',
	shell: '/bin/zsh'
}
*/

API

Accepts a uid number and returns an object with:

  • name: username
  • uid: user ID, same as supplied
  • gid: group ID
  • gecos: user information, usually the users full name
  • dir: home directory
  • shell: default shell

Will use current user process.getuid() if no uid is supplied.

License

MIT © Sindre Sorhus

About

getpwuid() Node.js binding - returns username, name, home directory, shell, gid from uid

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 63.4%
  • JavaScript 27.9%
  • Python 8.7%