nufw_dbm - generate and maintain NuFW dbm users files

nufw_dbm [gdbm file]

nufw_dbm [-P] [-l username] [ gdbm file]

nufw_dbm [-d username] [ gdbm file]

nufw_dbm [-C SHA1/MD5] [-o] [-r] [-g gid[,gid...]] [-c username] [ gdbm file]

nufw_dbm [-u username] [ gdbm file]

nufw_dbm [-R] [ gdbm file]

This manual page documents the nufw_dbm command.

nufw_dbm is a command line tool to be used by administrators to create and modify Nufw users database in DBM format. This program allows for user creation, deletion, password update. It supports encrypted passwords, currently with MD5 as well as SHA1 algorithms.

Original packaging and informations and help can be found from http://www.nufw.org/

Running nufw_dbm with DBM file as single argument results in listing usernames, one per line.

For all operations of the program, a DBM file must be specified as argument.

-l username

Displays group IDs the specified username is member of.

-P

Displays the password of the specified username. This option is useful only in conjunction with -l. If password is encrypted it is prefixed with either {MD5} or {SHA1}.

-d username

Remove specified user entry from the DBM file. Consider running the program with -R option to reorganize the database after you have deleted many users.

-c username

Create an entry for specified username in database. This option must be used in conjunction with -g. You may also be interested in -r, -o and especially -C options when creating a new user.

-g gid,[gid...]

Specify groups the created member is member of. This option must be used with -c, and is ignored in other contexts.

-C SHA1/MD5

Specify which encryption to use to protect password. It is recommended that you always use this option when creating a new user. This option is only useful in conjunction with -c. It is ignored in other contexts. If you do not specify this option at user creation, password will be stored unencrypted.

-o

Override the DBM file. All existing data will be lost if you use this option. This option is only useful in conjunction with -c. It is ignored in other contexts.

-r

Override the specified username, if it exists. Just create one if it does not exist. This option is only useful in conjunction with -c. It is ignored in other contexts.

-u username

Update user's password. If old password was encrypted, new one will be too, with the same algorithm.

-R

If you have had a lot of deletions and would like to shrink the space used by the DBM file, this option will reorganize the database. This option should be used very infrequently.

nuauth(1), nufw(1)

Nufw was designed and coded by Eric Leblond, aka Regit (eric@inl.fr) , and Vincent Deffontaines, aka gryzor (vincent@inl.fr). Original idea in 2001, while working on NSM Ldap support.

This manual page was written by Vincent Deffontaines

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 2 as published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.