{ "content": [ { "type": "text", "text": "# UPDATE-PASSWD (man)\n\n## NAME\n\nupdate-passwd - safely update /etc/passwd, /etc/shadow and /etc/group\n\n## SYNOPSIS\n\nupdate-passwd [options]\n\n## DESCRIPTION\n\nupdate-passwd handles updates of /etc/passwd, /etc/shadow and /etc/group on running Debian\nsystems. It compares the current files to master copies, distributed in the base-passwd\npackage, and updates all entries in the global system range (that is, 0–99). It leaves\nbackup copies of the previous versions of modified files with the extension ‘.org’ (for\n“original”).\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (11 subsections)\n- **ENVIRONMENT**\n- **BUGS**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "UPDATE-PASSWD", "section": "", "mode": "man", "summary": "update-passwd - safely update /etc/passwd, /etc/shadow and /etc/group", "synopsis": "update-passwd [options]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-p", "long": "--passwd-master", "arg": "FILE", "description": "Use FILE as the master copy of the passwd database. The default value is /usr/share/base-passwd/passwd.master." }, { "flag": "-g", "long": "--group-master", "arg": "FILE", "description": "Use FILE as the master copy of the group database. The default value is /usr/share/base-passwd/group.master." }, { "flag": "-P", "long": "--passwd", "arg": "FILE", "description": "Use FILE as the system passwd database. The default value is /etc/passwd." }, { "flag": "-S", "long": "--shadow", "arg": "FILE", "description": "Use FILE as the system shadow database. The default value is /etc/shadow." }, { "flag": "-G", "long": "--group", "arg": "FILE", "description": "Use FILE as the system group database. The default value is /etc/group." }, { "flag": "-s", "long": "--sanity-check", "arg": null, "description": "Only perform sanity-checks but don't do anything." }, { "flag": "-v", "long": "--verbose", "arg": null, "description": "Give detailed information about what we are doing. A second -v gives additional de‐ tail." }, { "flag": "-n", "long": "--dry-run", "arg": null, "description": "Don't do anything but only show what we would do." }, { "flag": "-L", "long": "--no-locking", "arg": null, "description": "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!" }, { "flag": "-h", "long": "--help", "arg": null, "description": "Show a summary of how to use update-passwd." }, { "flag": "-V", "long": "--version", "arg": null, "description": "Show the version number" } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 6, "subsections": [] }, { "name": "OPTIONS", "lines": 3, "subsections": [ { "name": "-p --passwd-master=FILE", "lines": 3, "flag": "-p", "long": "--passwd-master", "arg": "FILE" }, { "name": "-g --group-master=FILE", "lines": 3, "flag": "-g", "long": "--group-master", "arg": "FILE" }, { "name": "-P --passwd=FILE", "lines": 2, "flag": "-P", "long": "--passwd", "arg": "FILE" }, { "name": "-S --shadow=FILE", "lines": 2, "flag": "-S", "long": "--shadow", "arg": "FILE" }, { "name": "-G --group=FILE", "lines": 2, "flag": "-G", "long": "--group", "arg": "FILE" }, { "name": "-s --sanity-check", "lines": 2, "flag": "-s", "long": "--sanity-check" }, { "name": "-v --verbose", "lines": 3, "flag": "-v", "long": "--verbose" }, { "name": "-n --dry-run", "lines": 2, "flag": "-n", "long": "--dry-run" }, { "name": "-L --no-locking", "lines": 3, "flag": "-L", "long": "--no-locking" }, { "name": "-h --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-V --version", "lines": 2, "flag": "-V", "long": "--version" } ] }, { "name": "ENVIRONMENT", "lines": 9, "subsections": [] }, { "name": "BUGS", "lines": 4, "subsections": [] }, { "name": "AUTHOR", "lines": 9, "subsections": [] } ], "sections": { "NAME": { "content": "update-passwd - safely update /etc/passwd, /etc/shadow and /etc/group\n", "subsections": [] }, "SYNOPSIS": { "content": "update-passwd [options]\n", "subsections": [] }, "DESCRIPTION": { "content": "update-passwd handles updates of /etc/passwd, /etc/shadow and /etc/group on running Debian\nsystems. It compares the current files to master copies, distributed in the base-passwd\npackage, and updates all entries in the global system range (that is, 0–99). It leaves\nbackup copies of the previous versions of modified files with the extension ‘.org’ (for\n“original”).\n", "subsections": [] }, "OPTIONS": { "content": "update-passwd follows the usual GNU command line syntax, with long options starting with two\ndashes (‘-’).\n", "subsections": [ { "name": "-p --passwd-master=FILE", "content": "Use FILE as the master copy of the passwd database. The default value is\n/usr/share/base-passwd/passwd.master.\n", "flag": "-p", "long": "--passwd-master", "arg": "FILE" }, { "name": "-g --group-master=FILE", "content": "Use FILE as the master copy of the group database. The default value is\n/usr/share/base-passwd/group.master.\n", "flag": "-g", "long": "--group-master", "arg": "FILE" }, { "name": "-P --passwd=FILE", "content": "Use FILE as the system passwd database. The default value is /etc/passwd.\n", "flag": "-P", "long": "--passwd", "arg": "FILE" }, { "name": "-S --shadow=FILE", "content": "Use FILE as the system shadow database. The default value is /etc/shadow.\n", "flag": "-S", "long": "--shadow", "arg": "FILE" }, { "name": "-G --group=FILE", "content": "Use FILE as the system group database. The default value is /etc/group.\n", "flag": "-G", "long": "--group", "arg": "FILE" }, { "name": "-s --sanity-check", "content": "Only perform sanity-checks but don't do anything.\n", "flag": "-s", "long": "--sanity-check" }, { "name": "-v --verbose", "content": "Give detailed information about what we are doing. A second -v gives additional de‐\ntail.\n", "flag": "-v", "long": "--verbose" }, { "name": "-n --dry-run", "content": "Don't do anything but only show what we would do.\n", "flag": "-n", "long": "--dry-run" }, { "name": "-L --no-locking", "content": "Don't attempt to lock the account database. This should only be used for debugging\npurposes. I repeat: do not do this unless you are really sure you need this!\n", "flag": "-L", "long": "--no-locking" }, { "name": "-h --help", "content": "Show a summary of how to use update-passwd.\n", "flag": "-h", "long": "--help" }, { "name": "-V --version", "content": "Show the version number\n", "flag": "-V", "long": "--version" } ] }, "ENVIRONMENT": { "content": "DEBIANHASFRONTEND\nIf this environment variable is set and the --dry-run flag was not given, up‐‐\ndate-passwd uses debconf to prompt for whether to make changes. Each proposed change\nwill produce a separate prompt. User or group removals, UID or GID changes, and home\ndirectory changes will be asked with high priority. User or group additions and shell\nchanges will be asked with medium priority. Questions about whether to move entries\nabove the NIS compat inclusion entry or whether to change the GECOS of a user are\nasked at low priority.\n", "subsections": [] }, "BUGS": { "content": "At this moment update-passwd does not verify the shadow-file. It should check if the entries\nin the passwd are also in shadow and vice versa, and that passwords are not present in both\nfiles.\n", "subsections": [] }, "AUTHOR": { "content": "Wichert Akkerman \n\nThis program was written for the Debian project, and is copyright 1999–2002 Wichert Akkerman\nand copyright 2002, 2003 Colin Watson. It is distributed under version 2 of the GNU General\nPublic License.\n\n\n\nDEBIAN Debian tools UPDATE-PASSWD(8)", "subsections": [] } } } }