man-pages/man8/update-passwd.8.html
2021-03-31 01:06:50 +01:00

165 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of UPDATE-PASSWD</TITLE>
</HEAD><BODY>
<H1>UPDATE-PASSWD</H1>
Section: Maintenance Commands (8)<BR>Updated: Debian tools<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
update-passwd - safely update /etc/passwd, /etc/shadow and /etc/group
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>update-passwd</B>
[<I>options</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>update-passwd</B>
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-99).
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<B>update-passwd</B>
follows the usual GNU command line syntax, with long
options starting with two dashes ('-').
<DL COMPACT>
<DT id="1"><B>-p</B>,&nbsp;<B>--passwd-master=FILE</B>
<DD>
Use FILE as the master copy of the passwd database.
The default value is
<I>/usr/share/base-passwd/passwd.master</I>.
<DT id="2"><B>-g</B>,&nbsp;<B>--group-master=FILE</B>
<DD>
Use FILE as the master copy of the group database.
The default value is
<I>/usr/share/base-passwd/group.master</I>.
<DT id="3"><B>-P</B>,&nbsp;<B>--passwd=FILE</B>
<DD>
Use FILE as the system passwd database.
The default value is
<I>/etc/passwd</I>.
<DT id="4"><B>-S</B>,&nbsp;<B>--shadow=FILE</B>
<DD>
Use FILE as the system shadow database.
The default value is
<I>/etc/shadow</I>.
<DT id="5"><B>-G</B>,&nbsp;<B>--group=FILE</B>
<DD>
Use FILE as the system group database.
The default value is
<I>/etc/group</I>.
<DT id="6"><B>-s</B>,&nbsp;<B>--sanity-check</B>
<DD>
Only perform sanity-checks but don't do anything.
<DT id="7"><B>-v</B>,&nbsp;<B>--verbose</B>
<DD>
Give detailed information about what we are doing.
A second -v gives additional detail.
<DT id="8"><B>-n</B>,&nbsp;<B>--dry-run</B>
<DD>
Don't do anything but only show what we would do.
<DT id="9"><B>-L</B>,&nbsp;<B>--no-locking</B>
<DD>
Don't attempt to lock the account database.
This should only be used for debugging purposes.
<B>I repeat: do not do this unless you are really sure you need this!</B>
<DT id="10"><B>-h</B>,&nbsp;<B>--help</B>
<DD>
Show a summary of how to use
<B>update-passwd</B>.
<DT id="11"><B>-V</B>,&nbsp;<B>--version</B>
<DD>
Show the version number
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT id="12">DEBIAN_HAS_FRONTEND<DD>
If this environment variable is sent and the
<B>--dry-run</B>
flag was not given,
<B>update-passwd</B>
uses debconf to prompt for whether to make changes.
Each proposed change will produce a separate prompt.
User or group removals, UID or GID changes, and home directory changes
will be asked with high priority.
User or group additions and shell changes will be asked with medium
priority.
Questions about whether to move entries above the NIS compat inclusion
entry or whether to change the GECOS of a user are asked at low priority.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>BUGS</H2>
At this moment
<B>update-passwd</B>
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.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
Wichert Akkerman &lt;<A HREF="mailto:wakkerma@debian.org">wakkerma@debian.org</A>&gt;
<P>
This program was written for the Debian project, and is
copyright 1999-2002 Wichert Akkerman and
copyright 2002, 2003 Colin Watson.
It is distributed under version 2 of the GNU General Public License.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="13"><A HREF="#lbAB">NAME</A><DD>
<DT id="14"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="15"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="16"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="17"><A HREF="#lbAF">ENVIRONMENT</A><DD>
<DT id="18"><A HREF="#lbAG">BUGS</A><DD>
<DT id="19"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:18 GMT, March 31, 2021
</BODY>
</HTML>