1. NAME

update-passwd - safely update /etc/passwd, /etc/shadow and /etc/group

2. SYNOPSIS

update-passwd [ options ]

3. DESCRIPTION

update-passwd handles updates of /etc/passwd, /etc/shadow and /etc/group on running Debian systems. It compares the current files to master copies, distributed in the base-passwd package, and updates all entries in the global system range (that is, 0(en99).

4. OPTIONS

update-passwd follows the usual GNU command line syntax, with long options starting with two dashes ((oq-(cq).

R -p ,  --passwd-master=FILE

    Use FILE as the master copy of the passwd database. The default value is /usr/share/base-passwd/passwd.master .

R -g ,  --group-master=FILE

    Use FILE as the master copy of the group database. The default value is /usr/share/base-passwd/group.master .

R -P ,  --passwd=FILE

    Use FILE as the system passwd database. The default value is /etc/passwd .

R -S ,  --shadow=FILE

    Use FILE as the system shadow database. The default value is /etc/shadow .

R -G ,  --group=FILE

    Use FILE as the system group database. The default value is /etc/group .

R -s ,  --sanity-check

    Only perform sanity-checks but don't do anything.

R -v ,  --verbose

    Give detailed information about we are doing. A second -v gives additional detail.

R -n ,  --dry-run

    Don't do anything but only show what we would do.

R -L ,  --no-locking

    Don't attempt to lock the account database. This should only be used for debugging purposes.

I repeat: do not do this unless you are really sure you need this!

R -h ,  --help

    Show a summary of how to use

R update-passwd .

R -V ,  --version

    Show the version number

5. BUGS

At this moment

update-passwd does not verify the shadow-file. It should check if the entries in the passwd are also in shadow and vice versa, and that passwords are not present in both files.

6. AUTHOR

Wichert Akkerman <>

This program was written for the Debian project, and is copyright 1999(en2002 Wichert Akkerman and copyright 2002, 2003 Colin Watson. It is distributed under version 2 of the GNU General Public License.