nufw(1)

NAME

nufw_dbm -- generate and maintain NuFW dbm users files

SYNOPSIS

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]

DESCRIPTION

This manual page documents the nufw_dbm command.

nufw_dbm is a command line tool to be used by administra

tors 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.

OPTIONS

-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 con

texts.

-C SHA1/MD5

Specify which encryption to use to protect pass

word. It is recommended that you always use this option when cre

ating 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 con

junction 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 en

crypted, 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 infre

quently.

SEE ALSO

nuauth(1), nufw(1)

AUTHOR

Nufw was designed and coded by Eric Leblond, aka Regit

(eric@inl.fr) , and Vincent Deffontaines, aka gryzor (vin

cent@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 Li

cense, Version 2 as published by the Free Software Foundation;

with no Invariant Sections, no Front-Cover Texts and no Back-Cov

er Texts.

NUFW(1)