/linux-user

Node module for Linux user and group control.

Primary LanguageJavaScriptMIT LicenseMIT

linux-user

NPM

Node module for Linux user and group control.

Use Node to manage Linux user easily. All APIs do what you think.

The module must be running on Linux and as root user !

Installation

$ npm install linux-user --save

Usage

Examples

  • add Linux user
var linuxUser = require('linux-user');

linuxUser.addUser('gkuchan', function (err, user) {
  if(err) {
    return console.error(err);
  }
  console.log(user);
  // ------------------------------------------
  // { username: 'gkuchan',
  //   password: 'x',
  //   uid: 1001,
  //   gid: 1001,
  //   fullname: '',
  //   homedir: '/home/gkuchan',
  //   shell: '/usr/sbin/nologin' }
  // ------------------------------------------
});
  • get users
var linuxUser = require('linux-user');

linuxUser.getUsers(function (err, users) {
  if(err) {
    return console.error(err);
  }
  console.log(users);
  // ------------------------------------------
  // [ { username: 'root',
  //   password: 'x',
  //   uid: 0,
  //   gid: 0,
  //   fullname: 'root',
  //   homedir: '/root',
  //   shell: '/bin/bash' },
  // { username: 'daemon',
  //   password: 'x',
  //   uid: 1,
  //   gid: 1,
  //   fullname: 'daemon',
  //   homedir: '/usr/sbin',
  //   shell: '/usr/sbin/nologin' },
  // { username: 'bin',
  //   password: 'x',
  //   uid: 2,
  //   gid: 2,
  //   fullname: 'bin',
  //   homedir: '/bin',
  //   shell: '/usr/sbin/nologin' } ]
  //   ------------------------------------------
  });

Core APIs

  • linuxUser.addUser(username, callback)
    • username String
    • callback function(err, userInfo)
  • linuxUser.removeUser(username, callback)
    • username String
    • callback function(err)
  • linuxUser.getUsers(callback)
    • callback function(err, usersInfo)
  • linuxUser.getUserInfo(username, callback)
    • username String
    • callback function(err, userInfo)
  • linuxUser.setPassword(username, password, callback)
    • username String
    • password String
    • callback function(err)
  • linuxUser.addGroup(groupname, callback)
    • groupname String
    • callback function(err, groupInfo)
  • linuxUser.removeGroup(groupname, callback)
    • groupname String
    • callback function(err)
  • linuxUser.getGroups(callback)
    • callback function(err, groupsInfo)
  • linuxUser.getGroupInfo(groupname, callback)
    • groupname String
    • callback function(err, groupInfo)
  • linuxUser.addUserToGroup(username, groupname, callback)
    • username String
    • groupname String
    • callback function(err)

Other APIs

  • linuxUser.validateUsername(username)

    • return boolen

    check a string is a valid linux username or not

License

MIT