idtools

This package is no longer maintained, but the setstate command is now included in fdtools.

idtools is a set of tools for working with user and group IDs. These tools can be used to construct login services or other services (typically in the form of a simple shell script) that must prompt for a username and password. They can also be used in other situations that require similar process-state changes.

Releases

idtools is devoid of warranty and is distributed under the GNU General Public License, version 2. But that doesn't mean it's necessarily a good idea for you to distribute modified versions. (That includes repackaging.) I'd like to know if you plan to do that.

This link always points to the latest version (currently 2006.09.30).

Older versions are published for historical interest.

Dependencies

To build idtools, you need Laurent Bercot's skalibs package and Bruce Guenter's bglibs and cvm packages. Edit conf-compile/depend_* as necessary during installation.

Installation

slashpackage is a good thing. You can read more about it here. If you don't already have /package, create it (on any filesystem you like, as long as it's accessible by the name “/package”):

# mkdir -p /usr/local/package
# ln -s /usr/local/package /
# chmod +t /package/.

Then run sp-install:

# sp-install idtools-VERSION.tar.bz2

Or, if you like to do things manually, unpack the tarball and run package/install:

# cd /package
# bunzip2 < /path/to/idtools-VERSION.tar.bz2 |
> tar -xpf -
# cd admin/idtools-VERSION
# package/install

Read package/README and package/INSTALL for more detailed instructions.

Documentation

The cvmlogin program is a login program that authenticates via a CVM module.
The loginshell program runs $SHELL with "-" in argv[0][0].
The setstate program modifies its process state and executes a given command.

Current known bugs

cvmlogin doesn't build on Solaris with the default conf-compile/ configuration. Workaround: add "-lsocket -lnsl" to the end of the gcc command line in conf-compile/host_link.sh.
cvmlogin doesn't build with the latest bglibs. Workaround: add "compile/host/bglibs/lib/libbg-crypto.a" to the end of the gcc command line in conf-compile/host_link.sh.
If setstate -L fails due to the process already being a session leader, it leaves a stray process sleeping forever.

To do

Maybe a cvmsu command. Would cvmsudo be a better idea?
Make cvmlogin (or, better, a separate program) do utmp accounting.
Write a replacement library for getpwnam, etc., that reads a directory structure instead of /etc/passwd. Hmm, somebody beat me to it. (See also...)