---
name: "nufw_dbm"
section: "1"
platform: "linux"
package: "nufw"
version: "1.0.23-1.3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/nufw_dbm"
---

# nufw\_dbm(1)

generate and maintain NuFW dbm users files

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

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

## SEE ALSO

[nuauth(1)](/nuauth/1.md), [nufw(1)](/nufw/1.md)

## AUTHOR

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.