A Ruby library that presents a unified, cross-platform replacement for the Etc module
Pull request Compare This branch is 19 commits behind djberg96:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc
examples
ext
lib/sys
test
CHANGES
MANIFEST
README
Rakefile
sys-admin.gemspec

README

== Description
  The sys-admin library is a unified, cross platform replacement for the Etc module.
   
== Installation
  gem install sys-admin

== Synopsis
  require 'sys/admin'
  include Sys

  # Yields a User object for each user
  Admin.users{ |user|
    p user
  }

  # Returns an Array of User objects
  a = Admin.users

  # Yields a Group object for each group
  Admin.groups{ |group|
    p group
  }

  # Returns an Array of Group objects
  g = Admin.groups

  # Get information about a particular user
  p Admin.get_user("nobody")

  # Get information about a particular group
  p Admin.get_group("adm")

== Admin
Admin.get_login
  Returns the user name (only) of the current login.

Admin.get_user(name, options = {})
Admin.get_user(uid, options = {})
  Returns a User object based on +name+ or +uid+. The +options+ hash is
  for MS Windows only, and allows you to restrict the search based on the
  options you provide, e.g. 'domain' or 'localaccount'.
   
Admin.get_group(name, options = {})
Admin.get_group(gid, options = {})
  Returns a Group object based on +name+ or +uid+. The +options+ hash is
  for MS Windows only, and allows you to restrict the search based on the
  options you provide, e.g. 'domain' or 'localaccount'.

Admin.groups(options = {})
Admin.groups(options = {}){ |group| ... }
  In block form, yields a Group object for each user on the system.  In
  non-block form, returns an Array of Group objects.

  The +options+ hash is for MS Windows only, and allows you to restrict the
  search based on the options you provide, e.g. 'domain' or 'localaccount'.

Admin.users(options = {})
Admin.users(options = {}){ |user| ... }
  In block form, yields a User object for each user on the system.  In
  non-block form, returns an Array of User objects.
   
  The +options+ hash is for MS Windows only, and allows you to restrict the
  search based on the options you provide, e.g. 'domain' or 'localaccount'.
   
== User class
=== User (Windows)
  The User class has the following attributes on MS Windows systems:
	
  * account_type
  * caption
  * description
  * domain
  * password
  * full_name
  * install_date
  * name
  * sid
  * status
  * disabled?
  * local?
  * lockout?
  * password_changeable?
  * password_expires?
  * password_required?
     
=== User (Unix)
  The User class has the following attributes on Unix systems:
	
  * name
  * passwd
  * uid
  * gid
  * dir
  * shell
  * gecos
  * quota
  * age
  * class
  * comment
  * change
  * expire

== Group Classes
=== Group (Windows)
  The Group class has the following attributes on MS Windows systems:
	
  * caption
  * description
  * domain
  * install_date
  * name
  * sid
  * status
  * gid
  * local?
	
=== Group (Unix)
  The Group class has the following attributes on Unix systems:
	
  * name
  * gid
  * members
  * passwd

== Error Classes
Admin::Error < StandardError
  Raised if anything goes wrong with any of the above methods.

== Developer's Notes
=== MS Windows
  The Windows version now uses a win32ole + WMI approach to getting
  information.  This means that the WMI service must be running on the
  target machine in order to work (which it is, by default).
	
=== UNIX
  The underlying implementation is similar to core Ruby's Etc implementation.
  But, in addition to the different interface, I use the re-entrant version
  of the appropriate functions when available.

== Future Plans
  Make the User and Group objects comparable.
  Add ability to add, configure and delete users on Unix platforms.

== Known Bugs
  None that I'm aware of. If you find any, please log them on the project
  page at http://www.rubyforge.org/projects/sysutils.

== License
  Artistic 2.0

== Copyright
  (C) 2005-2010, Daniel J. Berger
  All Rights Reserved

== Author
  Daniel J. Berger