From cfa700b903d57bea5c9fd42be88ad47d5bd40c0b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 20:03:34 +0200 Subject: Adding upstream version 3.118. Signed-off-by: Daniel Baumann --- doc/adduser.8 | 333 ++++++ doc/adduser.conf.5 | 154 +++ doc/deluser.8 | 206 ++++ doc/deluser.conf.5 | 89 ++ doc/po4a/addendum.template | 22 + doc/po4a/po/adduser.pot | 1550 +++++++++++++++++++++++++++ doc/po4a/po/da.po | 1854 ++++++++++++++++++++++++++++++++ doc/po4a/po/de.po | 1926 +++++++++++++++++++++++++++++++++ doc/po4a/po/es.po | 2189 ++++++++++++++++++++++++++++++++++++++ doc/po4a/po/fr.po | 2218 ++++++++++++++++++++++++++++++++++++++ doc/po4a/po/it.po | 2166 +++++++++++++++++++++++++++++++++++++ doc/po4a/po/pl.po | 1899 +++++++++++++++++++++++++++++++++ doc/po4a/po/pt.po | 2114 ++++++++++++++++++++++++++++++++++++ doc/po4a/po/pt_BR.po | 2244 +++++++++++++++++++++++++++++++++++++++ doc/po4a/po/ru.po | 2183 +++++++++++++++++++++++++++++++++++++ doc/po4a/po/sv.po | 2133 +++++++++++++++++++++++++++++++++++++ doc/po4a/po4a.conf | 36 + doc/po4a/translator_french.add | 16 + doc/po4a/translator_french2.add | 18 + doc/po4a/translator_italian.add | 9 + doc/po4a/translator_polish.add | 3 + doc/po4a/translator_pt_BR.add | 4 + doc/po4a/translator_russian.add | 7 + doc/po4a/translator_spanish.add | 4 + doc/po4a/translator_swedish.add | 11 + 25 files changed, 23388 insertions(+) create mode 100644 doc/adduser.8 create mode 100644 doc/adduser.conf.5 create mode 100644 doc/deluser.8 create mode 100644 doc/deluser.conf.5 create mode 100644 doc/po4a/addendum.template create mode 100644 doc/po4a/po/adduser.pot create mode 100644 doc/po4a/po/da.po create mode 100644 doc/po4a/po/de.po create mode 100644 doc/po4a/po/es.po create mode 100644 doc/po4a/po/fr.po create mode 100644 doc/po4a/po/it.po create mode 100644 doc/po4a/po/pl.po create mode 100644 doc/po4a/po/pt.po create mode 100644 doc/po4a/po/pt_BR.po create mode 100644 doc/po4a/po/ru.po create mode 100644 doc/po4a/po/sv.po create mode 100644 doc/po4a/po4a.conf create mode 100644 doc/po4a/translator_french.add create mode 100644 doc/po4a/translator_french2.add create mode 100644 doc/po4a/translator_italian.add create mode 100644 doc/po4a/translator_polish.add create mode 100644 doc/po4a/translator_pt_BR.add create mode 100644 doc/po4a/translator_russian.add create mode 100644 doc/po4a/translator_spanish.add create mode 100644 doc/po4a/translator_swedish.add (limited to 'doc') diff --git a/doc/adduser.8 b/doc/adduser.8 new file mode 100644 index 0000000..722ad4f --- /dev/null +++ b/doc/adduser.8 @@ -0,0 +1,333 @@ +.\" Someone tell emacs that this is an -*- nroff -*- source file. +.\" Copyright 1997, 1998, 1999 Guy Maor. +.\" Adduser and this manpage are copyright 1995 by Ted Hajek, +.\" With much borrowing from the original adduser copyright 1994 by +.\" Ian Murdock. +.\" +.\" This is free software; see the GNU General Public License version +.\" 2 or later for copying conditions. There is NO warranty. +.TH ADDUSER 8 "Version VERSION" "Debian GNU/Linux" +.SH NAME +adduser, addgroup \- add a user or group to the system +.SH SYNOPSIS +.BR adduser " [options] [\-\-home DIR] [\-\-shell SHELL] [\-\-no-create-home] [\-\-uid ID] [\-\-firstuid ID] [\-\-lastuid ID] [\-\-ingroup GROUP | \-\-gid ID] [\-\-disabled-password] [\-\-disabled-login] [\-\-gecos GECOS] [\-\-add_extra_groups] user" +.PP +.BR adduser " \-\-system [options] [\-\-home DIR] [\-\-shell SHELL] [\-\-no-create-home] [\-\-uid ID] [\-\-group | \-\-ingroup GROUP | \-\-gid ID] [\-\-disabled-password] [\-\-disabled-login] [\-\-gecos GECOS] user" +.PP +.BR addgroup " [options] [\-\-gid ID] group" +.PP +.BR addgroup " \-\-system [options] [\-\-gid ID] group" +.PP +.BR adduser " [options] user group" +.SS COMMON OPTIONS +.br +[\-\-quiet] [\-\-debug] [\-\-force-badname] [\-\-help|\-h] [\-\-version] [\-\-conf FILE] +.SH DESCRIPTION +.PP +.BR adduser " and " addgroup +add users and groups to the system according to command line options +and configuration information in +.IR /etc/adduser.conf . +They are friendlier front ends to the low level tools like +.BR useradd, +.BR groupadd " and " usermod +programs, by default choosing Debian policy conformant UID and GID values, +creating a home directory with skeletal configuration, running a custom +script, and other features. +.BR adduser " and " addgroup +can be run in one of five modes: +.SS "Add a normal user" +If called with one non-option argument and without the +.BR \-\-system " or " \-\-group " options, " adduser +will add a normal user. + +.B adduser +will choose the first available UID from the range specified for +normal users in the configuration file. The UID can be overridden +with the +.B \-\-uid +option. + +The range specified in the configuration file may be overridden with the +.B \-\-firstuid +and +.B \-\-lastuid +options. + +By default, each user in Debian GNU/Linux is given a corresponding +group with the same name. Usergroups allow group writable +directories to be easily maintained by placing the appropriate users +in the new group, setting the set-group-ID bit in the directory, and ensuring +that all users use a umask of 002. If this option is turned off by setting +.B USERGROUPS +to +.IR no , +all users' GIDs are set to +.BR USERS_GID . +Users' primary groups can also be overridden from the command line with the +.BR \-\-gid " or " \-\-ingroup +options to set the group by id or name, respectively. Also, users can be +added to one or more groups defined in adduser.conf either by setting +ADD_EXTRA_GROUPS to 1 in adduser.conf, or by passing +.B \-\-add_extra_groups +on the commandline. + +.B adduser +will create a home directory subject to +.BR DHOME ", " GROUPHOMES ", and " LETTERHOMES . +The home directory can be overridden from the command line with the +.B \-\-home +option, and the shell with the +.B \-\-shell +option. The home directory's set-group-ID bit is set if +.B USERGROUPS +is +.I yes +so that any files created in the user's home directory will +have the correct group. + +.B adduser +will copy files from +.B SKEL +into the home directory and prompt for finger (gecos) information and +a password. The gecos may also be set with the +.B \-\-gecos +option. With the +.B \-\-disabled-login +option, the account will be created but will be disabled until a +password is set. The +.B \-\-disabled-password +option will not set a password, but login is still possible (for example +with SSH RSA keys). + +If the file +.B /usr/local/sbin/adduser.local +exists, it will be executed after the user account has been set +up in order to do any local setup. The arguments passed to +.B adduser.local +are: +.br +username uid gid home-directory +.br +The environment variable VERBOSE is set according to the following rule: +.TP +0 if +.B \-\-quiet +is specified +.TP +1 if neither +.B \-\-quiet +nor +.B \-\-debug +is specified +.TP +2 if +.B \-\-debug +is specified + +(The same applies to the variable DEBUG, but DEBUG is deprecated and will be removed in a later version of +.BR adduser .) + +.SS "Add a system user" +If called with one non-option argument and the +.BR \-\-system " option, " adduser +will add a system user. If a user with the same name already exists in +the system uid range (or, if the uid is specified, if a user with that +uid already exists), adduser will exit with a warning. This warning can be suppressed by adding +.BR \-\-quiet . + +.B adduser +will choose the first available UID from the range specified for +system users in the configuration file (FIRST_SYSTEM_UID and LAST_SYSTEM_UID). If you want to have a specific UID, you can specify it using the +.B \-\-uid +option. + +By default, system users are placed in the +.B nogroup +group. To place the new system user in an already existing group, use +the +.BR \-\-gid " or " \-\-ingroup +options. To place the new system user in a new group with the same ID, use +the +.B \-\-group +option. + +A home directory is created by the same rules as for normal users. +The new system user will have the shell +.I /usr/sbin/nologin +(unless overridden with the +.B \-\-shell +option), and have logins disabled. Skeletal configuration files +are not copied. +.SS "Add a user group" +If +.BR adduser " is called with the " \-\-group " option and without the +.BR \-\-system " option, or " addgroup " is called respectively, a user +group will be added. + + +A GID will be chosen from the range specified for system GIDS in the +configuration file (FIRST_GID, LAST_GID). To override that mechanism you can give the GID using the +.B \-\-gid +option. + +The group is created with no users. +.SS "Add a system group" +If +.BR addgroup " is called with the +.BR \-\-system " option, a system group will be added. + +A GID will be chosen from the range specified for system GIDS in the +configuration file (FIRST_SYSTEM_GID, LAST_SYSTEM_GID). To override that mechanism you can give the GID using the +.B \-\-gid +option. + +The group is created with no users. +.SS "Add an existing user to an existing group" +If called with two non-option arguments, +.B adduser +will add an existing user to an existing group. +.SH OPTIONS +.TP +.B \-\-conf FILE +Use FILE instead of +.IR /etc/adduser.conf . +.TP +.B \-\-disabled-login +Do not run passwd to set the password. The user won't be able to use +her account until the password is set. +.TP +.B \-\-disabled-password +Like \-\-disabled-login, but logins are still possible (for example using +SSH RSA keys) but not using password authentication. +.TP +.B \-\-force\-badname +By default, user and group names are checked against the configurable +regular expression +.B NAME_REGEX +specified in the configuration file. This option forces +.B adduser +and +.B addgroup +to apply only a weak check for validity of the name. +.B NAME_REGEX +is described in +.BR adduser.conf (5). +.TP +.B \-\-gecos GECOS +Set the gecos field for the new entry generated. +.B adduser +will not ask for finger information if this option is given. +.TP +.B \-\-gid ID +When creating a group, this option forces the new groupid to be the +given number. When creating a user, this option will put the user in +that group. +.TP +.B \-\-group +When combined with +.BR \-\-system , +a group with the same name and ID as the system user is created. +If not combined with +.BR \-\-system , +a group with the given name is created. This is the default action if +the program is invoked as +.BR addgroup . +.TP +.B \-\-help +Display brief instructions. +.TP +.B \-\-home DIR +Use DIR as the user's home directory, rather than the default specified by the +configuration file. If the directory does not exist, it is created +and skeleton files are copied. +.TP +.B \-\-shell SHELL +Use SHELL as the user's login shell, rather than the default specified by the +configuration file. +.TP +.B \-\-ingroup GROUP +Add the new user to GROUP instead of a usergroup or the default group +defined by +.B USERS_GID +in the configuration file. This affects the users primary group. To add additional +groups, see the +.B add_extra_groups +option. +.TP +.B \-\-no-create-home +Do not create the home directory, even if it doesn't exist. +.TP +.B \-\-quiet +Suppress informational messages, only show warnings and errors. +.TP +.B \-\-debug +Be verbose, most useful if you want to nail down a problem with adduser. +.TP +.B \-\-system +Create a system user or group. +.TP +.B \-\-uid ID +Force the new userid to be the given number. +.B adduser +will fail if the userid is already taken. +.TP +.B \-\-firstuid ID +Override the first uid in the range that the uid is chosen from (overrides +.B FIRST_UID +specified in the configuration file). +.TP +.B \-\-lastuid ID +Override the last uid in the range that the uid is chosen from ( +.B LAST_UID +) +.TP +.B \-\-add_extra_groups +Add new user to extra groups defined in the configuration file. +.TP +.B \-\-version +Display version and copyright information. + +.SH EXIT VALUES + +.TP +.B 0 +The user exists as specified. This can have 2 causes: The user was created by adduser or the user was already present on the system before adduser was invoked. If adduser was returning 0 , invoking adduser a second time with the same parameters as before also returns 0. +.TP +.B 1 +Creating the user or group failed because it was already present with other UID/GID than specified. The username or groupname was rejected because of a mismatch with the configured regular expressions, see adduser.conf(5). Adduser has been aborted by a signal. +.br +Or for many other yet undocumented reasons which are printed to console then. You may then consider to remove +.B \-\-quiet +to make adduser more verbose. + +.SH FILES +.TP +/etc/adduser.conf +Default configuration file for adduser and addgroup +.TP +/usr/local/sbin/adduser.local +Optional custom add-ons. + +.SH "SEE ALSO" +.BR adduser.conf (5), +.BR deluser (8), +.BR groupadd (8), +.BR useradd (8), +.BR usermod (8), +Debian Policy 9.2.2. + +.SH COPYRIGHT +Copyright (C) 1997, 1998, 1999 Guy Maor. Modifications by Roland +Bauerschmidt and Marc Haber. Additional patches by Joerg Hoh and Stephen Gran. +.br +Copyright (C) 1995 Ted Hajek, with a great deal borrowed from the original +Debian +.B adduser +.br +Copyright (C) 1994 Ian Murdock. +.B adduser +is free software; see the GNU General Public Licence version 2 or +later for copying conditions. There is +.I no +warranty. diff --git a/doc/adduser.conf.5 b/doc/adduser.conf.5 new file mode 100644 index 0000000..d9bdc5f --- /dev/null +++ b/doc/adduser.conf.5 @@ -0,0 +1,154 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.\" Adduser and this manpage are copyright 1995 by Ted Hajek +.\" +.\" This is free software; see the GNU General Public Lisence version 2 +.\" or later for copying conditions. There is NO warranty. +.TH "adduser.conf" 5 "Version VERSION" "Debian GNU/Linux" +.SH NAME +/etc/adduser.conf \- configuration file for +.B adduser(8) +and +.BR addgroup(8) . +.SH DESCRIPTION +The file +.I /etc/adduser.conf +contains defaults for the programs +.B adduser(8) +, +.B addgroup(8) +, +.B deluser(8) +and +.BR delgroup(8) . +Each line holds a single value pair in the form +.IR option " = " value . +Double or single quotes are allowed around the value, as is whitespace +around the equals sign. Comment lines must have a hash sign (#) in the +first column. + +The valid configuration options are: +.TP +\fBDSHELL\fP +The login shell to be used for all new users. Defaults to +.IR /bin/bash . +.TP +\fBDHOME\fP +The directory in which new home directories should be created. +Defaults to +.IR /home . +.TP +\fBGROUPHOMES\fP +If this is set to +.IR yes , +the home directories will be created as +.IR /home/[groupname]/user . +Defaults to +.IR no . +.TP +\fBLETTERHOMES\fP +If this is set to +.IR yes , +then the home directories created will have an +extra directory inserted which is the first letter of the loginname. +For example: +.IR /home/u/user . +Defaults to +.IR no . +.TP +\fBSKEL\fP +The directory from which skeletal user configuration files should be +copied. Defaults to +.IR /etc/skel . +.TP +.BR FIRST_SYSTEM_UID " and " LAST_SYSTEM_UID +specify an inclusive range of UIDs from which system UIDs can be +dynamically allocated. Default to +.IR 100 " - " 999 . +Please note that system software, such as the users allocated by the base-passwd +package, may assume that UIDs less than 100 are unallocated. +.TP +.BR FIRST_UID " and " LAST_UID +specify an inclusive range of UIDs from which normal user's UIDs can +be dynamically allocated. Default to +.IR 1000 " - " 59999 . +.TP +.BR FIRST_SYSTEM_GID " and " LAST_SYSTEM_GID +specify an inclusive range of GIDs from which system GIDs can be dynamically allocated. +Default to +.IR 100 " - " 999. +.TP +.BR FIRST_GID " and " LAST_GID +specify an inclusive range of GIDs from which normal group's GIDs can +be dynamically allocated. Default to +.IR 1000 " - " 59999 . +.TP +\fBUSERGROUPS\fP +If this is set to +.IR yes , +then each created user will be given their own group to use. If this +is +.IR no , +then each created user will be placed in the group whose GID is +\fBUSERS_GID\fP (see below). The default is +.IR yes . +.TP +\fBUSERS_GID\fP +If \fBUSERGROUPS\fP is +.IR no , +then \fBUSERS_GID\fP is the GID given to all newly-created users. The +default value is +.IR 100 . +.TP +\fBDIR_MODE\fP +If set to a valid value (e.g. 0755 or 755), directories created will have +the specified permissions as umask. Otherwise 0755 is used as default. +.TP +\fBSETGID_HOME\fP +If this is set to +.IR yes , +then home directories for users with their own group ( +.IR USERGROUPS=yes +) will have the setgid bit set. This was the default setting for adduser +versions << 3.13. Unfortunately it has some bad side effects, so we no +longer do this per default. If you want it nevertheless you can still +activate it here. +.TP +\fBQUOTAUSER\fP +If set to a nonempty value, new users will have quotas copied from +that user. The default is empty. +.TP +\fBNAME_REGEX\fB +User and group names are checked against this regular expression. If the name +doesn't match this regexp, user and group creation in adduser is refused unless +--force-badname is set. With --force-badname set, only weak checks are +performed. The default is the most conservative ^[a-z][-a-z0-9]*$. +.TP +\fBSKEL_IGNORE_REGEX\fB +Files in /etc/skel/ are checked against this regex, and not copied to +the newly created home directory if they match. This is by default set +to the regular expression matching files left over from unmerged config +files (dpkg-(old|new|dist)). +.TP +\fBADD_EXTRA_GROUPS\fB +Setting this to something other than 0 (the default) will cause adduser +to add newly created non-system users to the list of groups defined by +EXTRA_GROUPS (below). +.TP +\fBEXTRA_GROUPS\fB +This is the list of groups that new non-system users will be added to. +By default, this list is 'dialout cdrom floppy audio video plugdev users games'. +.SH NOTES +.TP +\fBVALID NAMES\fB +adduser and addgroup enforce conformity to IEEE Std 1003.1-2001, which allows only the following characters to appear in group and user names: letters, digits, underscores, periods, at signs (@) and dashes. The name may no start with a dash. The "$" sign is allowed at the end of usernames (to conform to samba). + +An additional check can be adjusted via the configuration parameter NAME_REGEX to enforce a local policy. + +.SH FILES +.I /etc/adduser.conf +.SH SEE ALSO +.BR addgroup (8), +.BR adduser (8), +.BR delgroup (8), +.BR deluser (8), +.BR deluser.conf (5) diff --git a/doc/deluser.8 b/doc/deluser.8 new file mode 100644 index 0000000..04251fb --- /dev/null +++ b/doc/deluser.8 @@ -0,0 +1,206 @@ +.\" Someone tell emacs that this is an -*- nroff -*- source file. +.\" Copyright 1997, 1998, 1999 Guy Maor. +.\" Adduser and this manpage are copyright 1995 by Ted Hajek, +.\" With much borrowing from the original adduser copyright 1994 by +.\" Ian Murdock. +.\" +.\" This is free software; see the GNU General Public License version +.\" 2 or later for copying conditions. There is NO warranty. +.TH DELUSER 8 "Version VERSION" "Debian GNU/Linux" +.SH NAME +deluser, delgroup \- remove a user or group from the system +.SH SYNOPSIS +.BR deluser " [options] [\-\-force] [\-\-remove-home] [\-\-remove-all-files] [\-\-backup] [\-\-backup-to DIR] user" +.PP +.BR deluser " \-\-group [options] group" +.br +.BR delgroup " [options] [\-\-only-if-empty] group" +.PP +.BR deluser " [options] user group" +.SS COMMON OPTIONS +.br +[\-\-quiet] [\-\-system] [\-\-help] [\-\-version] [\-\-conf FILE] +.SH DESCRIPTION +.PP +.BR deluser " and " delgroup +remove users and groups from the system according to command line options +and configuration information in +.IR /etc/deluser.conf +and +.IR /etc/adduser.conf . +They are friendlier front ends to the +.BR userdel " and " groupdel +programs, removing the home directory as option or even all files on the system +owned by the user to be removed, running a custom script, and other features. +.BR deluser " and " delgroup +can be run in one of three modes: +.SS "Remove a normal user" +If called with one non-option argument and without the +.BR \-\-group " option, " deluser +will remove a normal user. + +By default, +.B deluser +will remove the user without removing the home directory, the mail spool or +any other files on the system owned by the user. Removing the home directory +and mail spool can be achieved using the +.B \-\-remove-home +option. + +The +.B \-\-remove-all-files +option removes all files on the system owned by the user. Note that if +you activate both options +.B \-\-remove-home +will have no effect because all files including the home directory and mail +spool are already covered by the +.B \-\-remove-all-files +option. + +If you want to backup all files before deleting them you can activate the +.B \-\-backup +option which will create a file username.tar(.gz|.bz2) in the +directory specified by the +.B \-\-backup-to +option (defaulting to the current working directory). Both the remove +and backup options can also be activated for default in the configuration +file /etc/deluser.conf. See +.B deluser.conf(5) +for details. + +If you want to remove the root account (uid 0), then use the +.B \-\-force +parameter; this may prevent to remove the root user by accident. + +If the file +.B /usr/local/sbin/deluser.local +exists, it will be executed after the user account has been removed +in order to do any local cleanup. The arguments passed to +.B deluser.local +are: +.br +username uid gid home-directory + +.SS "Remove a group" +If +.BR deluser " is called with the " \-\-group " option, or " delgroup +is called, a group will be removed. + +Warning: The primary group of an existing user cannot be removed. + +If the option +.B \-\-only-if-empty +is given, the group won't be removed if it has any members left. + +.SS "Remove a user from a specific group" +If called with two non-option arguments, +.B deluser +will remove a user from a specific group. +.SH OPTIONS +.TP +.B \-\-conf FILE +Use FILE instead of the default files +.IR /etc/deluser.conf +and +.IR /etc/adduser.conf +.TP +.B \-\-group +Remove a group. This is the default action if the program is invoked +as +.IR delgroup . +.TP +.B \-\-help +Display brief instructions. +.TP +.B \-\-quiet +Suppress progress messages. +.TP +.B \-\-system +Only delete if user/group is a system user/group. This avoids +accidentally deleting non-system users/groups. Additionally, if the +user does not exist, no error value is returned. This option is mainly +for use in Debian package maintainer scripts. +.TP +.B \-\-only-if-empty +Only remove if no members are left. +.TP +.B \-\-backup +Backup all files contained in the userhome and the mailspool-file to a file named +/$user.tar.bz2 or /$user.tar.gz. +.TP +.B \-\-backup-to +Place the backup files not in / but in the directory specified by this parameter. This implicitly sets --backup also. +.TP +.B \-\-remove-home +Remove the home directory of the user and its mailspool. If \-\-backup is specified, +the files are deleted after having performed the backup. +.TP +.B \-\-remove-all-files +Remove all files from the system owned by this user. Note: \-\-remove-home does +not have an effect any more. If \-\-backup is specified, the files are deleted after +having performed the backup. +.TP +.B \-\-version +Display version and copyright information. +.SH "RETURN VALUE" +.TP +.B 0 +The action was successfully executed. +.TP +.B 1 +The user to delete was not a system account. No action was performed. +.TP +.B 2 +There is no such user. No action was performed. +.TP +.B 3 +There is no such group. No action was performed. +.TP +.B 4 +Internal error. No action was performed. +.TP +.B 5 +The group to delete is not empty. No action was performed. +.TP +.B 6 +The user does not belong to the specified group. No action was performed. +.TP +.B 7 +You cannot remove a user from its primary group. No action was performed. +.TP +.B 8 +The required perl-package 'perl modules' is not installed. This package is required to perform the requested actions. No action was performed. +.TP +.B 9 +For removing the root account the parameter "--force" is required. No action was performed. + +.SH FILES +.IR /etc/deluser.conf +Default configuration file for deluser and delgroup +.TP +.IR /usr/local/sbin/deluser.local +Optional custom add-ons. + +.SH "SEE ALSO" +.BR adduser (8), +.BR deluser.conf (5), +.BR groupdel (8), +.BR userdel (8) + +.SH COPYRIGHT +Copyright (C) 2000 Roland Bauerschmidt. Modifications (C) 2004 +Marc Haber and Joerg Hoh. +This manpage and the deluser program are based on adduser which is: +.br +Copyright (C) 1997, 1998, 1999 Guy Maor. +.br +Copyright (C) 1995 Ted Hajek, with a great deal borrowed from the original +Debian +.B adduser +.br +Copyright (C) 1994 Ian Murdock. +.B deluser +is free software; see the GNU General Public Licence version 2 or +later for copying conditions. There is +.I no +warranty. diff --git a/doc/deluser.conf.5 b/doc/deluser.conf.5 new file mode 100644 index 0000000..2b8dbeb --- /dev/null +++ b/doc/deluser.conf.5 @@ -0,0 +1,89 @@ +.\" Hey, Emacs! This is an -*- nroff -*- source file. +.\" Adduser and this manpage are copyright 1995 by Ted Hajek +.\" +.\" This is free software; see the GNU General Public Lisence version 2 +.\" or later for copying conditions. There is NO warranty. +.TH "deluser.conf" 5 "Version VERSION" "Debian GNU/Linux" +.SH NAME +/etc/deluser.conf \- configuration file for +.B deluser(8) +and +.BR delgroup(8) . +.SH DESCRIPTION +The file +.I /etc/deluser.conf +contains defaults for the programs +.B deluser(8) +and +.BR delgroup(8) . +Each option takes the form +.IR option " = " value . +Double or single quotes are allowed around the value. Comment lines +must have a hash sign (#) at the beginning of the line. + +.B deluser(8) +and +.B delgroup(8) +also read +.I /etc/adduser.conf, +see +.B adduser.conf(5); +settings in +.I deluser.conf +may overwrite settings made in +.I adduser.conf. + +The valid configuration options are: +.TP +\fBREMOVE_HOME\fP +Removes the home directory and mail spool of the user to be removed. +Value may be 0 (don't delete) or 1 (do delete). +.TP +\fBREMOVE_ALL_FILES\fP +Removes all files on the system owned by the user to be removed. +If this option is activated +.B REMOVE_HOME +has no effect. Values may be 0 or 1. +.TP +\fBBACKUP\fP +If +.B REMOVE_HOME +or +.B REMOVE_ALL_FILES +is activated all files are backuped before they are removed. The backup +file that is created defaults to username.tar(.gz|.bz2) in the +directory specified by the +.B BACKUP_TO +option. The compression method is chosen to the best that is available. +Values may be 0 or 1. +.TP +\fBBACKUP_TO\fP +If +.B BACKUP +is activated, +.B BACKUP_TO +specifies the directory the backup is written to. Default is the +current directory. +.TP +\fBNO_DEL_PATHS\fP +A list of regular expressions, space separated. All files to be +deleted in course of deleting home directories or deleting files owned +by the user to be deleted are checked against each of these regular +expressions. If a match is detected, the file is not deleted. Defaults +to a list of system directories, leaving only /home. + +In other words: By default only files below /home belonging to that specific user are going to be deleted. + +.TP +\fBONLY_IF_EMPTY\fP +Only delete a group if there are no users belonging to this group. Defaults to 0. +.TP +\fBEXCLUDE_FSTYPES\fP +A regular expression which describes all file systems which should be excluded when looking for files of a user to be deleted. Defaults to "(proc|sysfs|usbfs|devpts|tmpfs|afs)". + +.SH FILES +.I /etc/deluser.conf +.SH SEE ALSO +.BR adduser.conf (5), +.BR delgroup (8), +.BR deluser(8) diff --git a/doc/po4a/addendum.template b/doc/po4a/addendum.template new file mode 100644 index 0000000..a6570d5 --- /dev/null +++ b/doc/po4a/addendum.template @@ -0,0 +1,22 @@ +PO4A-HEADER:mode=after;position=^\.SH "SEE ALSO";beginboundary=^\.SH +.SH TRANSLATOR(S) +This manpage has been translated by TRANSLATOR NAME on TRANSLATION +DATE. + +If you find any mistake in this translation, please send an e-mail to the +translator or to the +.nh +<\fIdebian\-l10n\-LANGUAGE@lists.debian.org\fR>, +.hy +mailing-list. + +# Note to translators: +# Please translate this text in a file called translator_language.add +# The addendum MUST use the same encoding as your po file +# Feel free to adapt the text at your convenience. +# Do not forget to translate "SEE ALSO" and "TRANSLATOR(S)" +# The "SEE ALSO" part in the header must be *exactly* the same translation +# as the one in your xx.po file. +# Do not include this comment in your addendum (i.e. all lines starting +# with a #). +# See po4a(7) for further information. diff --git a/doc/po4a/po/adduser.pot b/doc/po4a/po/adduser.pot new file mode 100644 index 0000000..cfc1a77 --- /dev/null +++ b/doc/po4a/po/adduser.pot @@ -0,0 +1,1550 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2016-06-17 18:51+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=CHARSET\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: ../adduser.8:9 +#, no-wrap +msgid "ADDUSER" +msgstr "" + +#. type: TH +#: ../adduser.8:9 ../adduser.conf.5:6 ../deluser.8:9 ../deluser.conf.5:6 +#, no-wrap +msgid "Version VERSION" +msgstr "" + +#. type: TH +#: ../adduser.8:9 ../adduser.conf.5:6 ../deluser.8:9 ../deluser.conf.5:6 +#, no-wrap +msgid "Debian GNU/Linux" +msgstr "" + +#. type: SH +#: ../adduser.8:10 ../adduser.conf.5:7 ../deluser.8:10 ../deluser.conf.5:7 +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: ../adduser.8:12 +msgid "adduser, addgroup - add a user or group to the system" +msgstr "" + +#. type: SH +#: ../adduser.8:12 ../deluser.8:12 +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: ../adduser.8:14 +msgid "" +"B [options] [--home DIR] [--shell SHELL] [--no-create-home] [--uid " +"ID] [--firstuid ID] [--lastuid ID] [--ingroup GROUP | --gid ID] " +"[--disabled-password] [--disabled-login] [--gecos GECOS] " +"[--add_extra_groups] user" +msgstr "" + +#. type: Plain text +#: ../adduser.8:16 +msgid "" +"B --system [options] [--home DIR] [--shell SHELL] " +"[--no-create-home] [--uid ID] [--group | --ingroup GROUP | --gid ID] " +"[--disabled-password] [--disabled-login] [--gecos GECOS] user" +msgstr "" + +#. type: Plain text +#: ../adduser.8:18 +msgid "B [options] [--gid ID] group" +msgstr "" + +#. type: Plain text +#: ../adduser.8:20 +msgid "B --system [options] [--gid ID] group" +msgstr "" + +#. type: Plain text +#: ../adduser.8:22 +msgid "B [options] user group" +msgstr "" + +#. type: SS +#: ../adduser.8:22 ../deluser.8:20 +#, no-wrap +msgid "COMMON OPTIONS" +msgstr "" + +#. type: Plain text +#: ../adduser.8:25 +msgid "[--quiet] [--debug] [--force-badname] [--help|-h] [--version] [--conf FILE]" +msgstr "" + +#. type: SH +#: ../adduser.8:25 ../adduser.conf.5:12 ../deluser.8:23 ../deluser.conf.5:12 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: ../adduser.8:39 +msgid "" +"B and B add users and groups to the system according to " +"command line options and configuration information in I. " +"They are friendlier front ends to the low level tools like B " +"B and B programs, by default choosing Debian policy " +"conformant UID and GID values, creating a home directory with skeletal " +"configuration, running a custom script, and other features. B and " +"B can be run in one of five modes:" +msgstr "" + +#. type: SS +#: ../adduser.8:39 +#, no-wrap +msgid "Add a normal user" +msgstr "" + +#. type: Plain text +#: ../adduser.8:43 +msgid "" +"If called with one non-option argument and without the B<--system> or " +"B<--group> options, B will add a normal user." +msgstr "" + +#. type: Plain text +#: ../adduser.8:50 +msgid "" +"B will choose the first available UID from the range specified for " +"normal users in the configuration file. The UID can be overridden with the " +"B<--uid> option." +msgstr "" + +#. type: Plain text +#: ../adduser.8:56 +msgid "" +"The range specified in the configuration file may be overridden with the " +"B<--firstuid> and B<--lastuid> options." +msgstr "" + +#. type: Plain text +#: ../adduser.8:74 +msgid "" +"By default, each user in Debian GNU/Linux is given a corresponding group " +"with the same name. Usergroups allow group writable directories to be " +"easily maintained by placing the appropriate users in the new group, setting " +"the set-group-ID bit in the directory, and ensuring that all users use a " +"umask of 002. If this option is turned off by setting B to " +"I, all users' GIDs are set to B. Users' primary groups can " +"also be overridden from the command line with the B<--gid> or B<--ingroup> " +"options to set the group by id or name, respectively. Also, users can be " +"added to one or more groups defined in adduser.conf either by setting " +"ADD_EXTRA_GROUPS to 1 in adduser.conf, or by passing B<--add_extra_groups> " +"on the commandline." +msgstr "" + +#. type: Plain text +#: ../adduser.8:88 +msgid "" +"B will create a home directory subject to B, B, " +"and B. The home directory can be overridden from the command " +"line with the B<--home> option, and the shell with the B<--shell> " +"option. The home directory's set-group-ID bit is set if B is " +"I so that any files created in the user's home directory will have the " +"correct group." +msgstr "" + +#. type: Plain text +#: ../adduser.8:102 +msgid "" +"B will copy files from B into the home directory and prompt " +"for finger (gecos) information and a password. The gecos may also be set " +"with the B<--gecos> option. With the B<--disabled-login> option, the " +"account will be created but will be disabled until a password is set. The " +"B<--disabled-password> option will not set a password, but login is still " +"possible (for example with SSH RSA keys)." +msgstr "" + +#. type: Plain text +#: ../adduser.8:109 +msgid "" +"If the file B exists, it will be executed " +"after the user account has been set up in order to do any local setup. The " +"arguments passed to B are:" +msgstr "" + +#. type: Plain text +#: ../adduser.8:111 ../deluser.8:83 +msgid "username uid gid home-directory" +msgstr "" + +#. type: Plain text +#: ../adduser.8:113 +msgid "The environment variable VERBOSE is set according to the following rule:" +msgstr "" + +#. type: TP +#: ../adduser.8:113 +#, no-wrap +msgid "0 if " +msgstr "" + +#. type: Plain text +#: ../adduser.8:117 +msgid "B<--quiet> is specified" +msgstr "" + +#. type: TP +#: ../adduser.8:117 +#, no-wrap +msgid "1 if neither " +msgstr "" + +#. type: Plain text +#: ../adduser.8:123 +msgid "B<--quiet> nor B<--debug> is specified" +msgstr "" + +#. type: TP +#: ../adduser.8:123 +#, no-wrap +msgid "2 if " +msgstr "" + +#. type: Plain text +#: ../adduser.8:127 +msgid "B<--debug> is specified" +msgstr "" + +#. type: Plain text +#: ../adduser.8:130 +msgid "" +"(The same applies to the variable DEBUG, but DEBUG is deprecated and will be " +"removed in a later version of B.)" +msgstr "" + +#. type: SS +#: ../adduser.8:131 +#, no-wrap +msgid "Add a system user" +msgstr "" + +#. type: Plain text +#: ../adduser.8:138 +msgid "" +"If called with one non-option argument and the B<--system> option, " +"B will add a system user. If a user with the same name already " +"exists in the system uid range (or, if the uid is specified, if a user with " +"that uid already exists), adduser will exit with a warning. This warning can " +"be suppressed by adding B<--quiet>." +msgstr "" + +#. type: Plain text +#: ../adduser.8:144 +msgid "" +"B will choose the first available UID from the range specified for " +"system users in the configuration file (FIRST_SYSTEM_UID and " +"LAST_SYSTEM_UID). If you want to have a specific UID, you can specify it " +"using the B<--uid> option." +msgstr "" + +#. type: Plain text +#: ../adduser.8:154 +msgid "" +"By default, system users are placed in the B group. To place the " +"new system user in an already existing group, use the B<--gid> or " +"B<--ingroup> options. To place the new system user in a new group with the " +"same ID, use the B<--group> option." +msgstr "" + +#. type: Plain text +#: ../adduser.8:162 +msgid "" +"A home directory is created by the same rules as for normal users. The new " +"system user will have the shell I (unless overridden with the " +"B<--shell> option), and have logins disabled. Skeletal configuration files " +"are not copied." +msgstr "" + +#. type: SS +#: ../adduser.8:162 +#, no-wrap +msgid "Add a user group" +msgstr "" + +#. type: Plain text +#: ../adduser.8:167 +msgid "" +"If B is called with the B<--group> option and without the " +"B<--system> option, or B is called respectively, a user group will " +"be added." +msgstr "" + +#. type: Plain text +#: ../adduser.8:173 +msgid "" +"A GID will be chosen from the range specified for system GIDS in the " +"configuration file (FIRST_GID, LAST_GID). To override that mechanism you can " +"give the GID using the B<--gid> option." +msgstr "" + +#. type: Plain text +#: ../adduser.8:175 ../adduser.8:186 +msgid "The group is created with no users." +msgstr "" + +#. type: SS +#: ../adduser.8:175 +#, no-wrap +msgid "Add a system group" +msgstr "" + +#. type: Plain text +#: ../adduser.8:179 +msgid "" +"If B is called with the B<--system> option, a system group will be " +"added." +msgstr "" + +#. type: Plain text +#: ../adduser.8:184 +msgid "" +"A GID will be chosen from the range specified for system GIDS in the " +"configuration file (FIRST_SYSTEM_GID, LAST_SYSTEM_GID). To override that " +"mechanism you can give the GID using the B<--gid> option." +msgstr "" + +#. type: SS +#: ../adduser.8:186 +#, no-wrap +msgid "Add an existing user to an existing group" +msgstr "" + +#. type: Plain text +#: ../adduser.8:190 +msgid "" +"If called with two non-option arguments, B will add an existing " +"user to an existing group." +msgstr "" + +#. type: SH +#: ../adduser.8:190 ../deluser.8:99 +#, no-wrap +msgid "OPTIONS" +msgstr "" + +#. type: TP +#: ../adduser.8:191 ../deluser.8:100 +#, no-wrap +msgid "B<--conf FILE>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:195 +msgid "Use FILE instead of I." +msgstr "" + +#. type: TP +#: ../adduser.8:195 +#, no-wrap +msgid "B<--disabled-login>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:199 +msgid "" +"Do not run passwd to set the password. The user won't be able to use her " +"account until the password is set." +msgstr "" + +#. type: TP +#: ../adduser.8:199 +#, no-wrap +msgid "B<--disabled-password>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:203 +msgid "" +"Like --disabled-login, but logins are still possible (for example using SSH " +"RSA keys) but not using password authentication." +msgstr "" + +#. type: TP +#: ../adduser.8:203 +#, no-wrap +msgid "B<--force-badname>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:216 +msgid "" +"By default, user and group names are checked against the configurable " +"regular expression B specified in the configuration file. This " +"option forces B and B to apply only a weak check for " +"validity of the name. B is described in B(5)." +msgstr "" + +#. type: TP +#: ../adduser.8:216 +#, no-wrap +msgid "B<--gecos GECOS>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:221 +msgid "" +"Set the gecos field for the new entry generated. B will not ask " +"for finger information if this option is given." +msgstr "" + +#. type: TP +#: ../adduser.8:221 +#, no-wrap +msgid "B<--gid ID>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:226 +msgid "" +"When creating a group, this option forces the new groupid to be the given " +"number. When creating a user, this option will put the user in that group." +msgstr "" + +#. type: TP +#: ../adduser.8:226 ../deluser.8:106 +#, no-wrap +msgid "B<--group>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:236 +msgid "" +"When combined with B<--system>, a group with the same name and ID as the " +"system user is created. If not combined with B<--system>, a group with the " +"given name is created. This is the default action if the program is invoked " +"as B." +msgstr "" + +#. type: TP +#: ../adduser.8:236 ../deluser.8:111 +#, no-wrap +msgid "B<--help>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:239 ../deluser.8:114 +msgid "Display brief instructions." +msgstr "" + +#. type: TP +#: ../adduser.8:239 +#, no-wrap +msgid "B<--home DIR>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:244 +msgid "" +"Use DIR as the user's home directory, rather than the default specified by " +"the configuration file. If the directory does not exist, it is created and " +"skeleton files are copied." +msgstr "" + +#. type: TP +#: ../adduser.8:244 +#, no-wrap +msgid "B<--shell SHELL>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:248 +msgid "" +"Use SHELL as the user's login shell, rather than the default specified by " +"the configuration file." +msgstr "" + +#. type: TP +#: ../adduser.8:248 +#, no-wrap +msgid "B<--ingroup GROUP>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:257 +msgid "" +"Add the new user to GROUP instead of a usergroup or the default group " +"defined by B in the configuration file. This affects the users " +"primary group. To add additional groups, see the B " +"option." +msgstr "" + +#. type: TP +#: ../adduser.8:257 +#, no-wrap +msgid "B<--no-create-home>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:260 +msgid "Do not create the home directory, even if it doesn't exist." +msgstr "" + +#. type: TP +#: ../adduser.8:260 ../deluser.8:114 +#, no-wrap +msgid "B<--quiet>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:263 +msgid "Suppress informational messages, only show warnings and errors." +msgstr "" + +#. type: TP +#: ../adduser.8:263 +#, no-wrap +msgid "B<--debug>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:266 +msgid "Be verbose, most useful if you want to nail down a problem with adduser." +msgstr "" + +#. type: TP +#: ../adduser.8:266 ../deluser.8:117 +#, no-wrap +msgid "B<--system>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:269 +msgid "Create a system user or group." +msgstr "" + +#. type: TP +#: ../adduser.8:269 +#, no-wrap +msgid "B<--uid ID>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:274 +msgid "" +"Force the new userid to be the given number. B will fail if the " +"userid is already taken." +msgstr "" + +#. type: TP +#: ../adduser.8:274 +#, no-wrap +msgid "B<--firstuid ID>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:279 +msgid "" +"Override the first uid in the range that the uid is chosen from (overrides " +"B specified in the configuration file)." +msgstr "" + +#. type: TP +#: ../adduser.8:279 +#, no-wrap +msgid "B<--lastuid ID>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:284 +msgid "" +"Override the last uid in the range that the uid is chosen from ( B " +")" +msgstr "" + +#. type: TP +#: ../adduser.8:284 +#, no-wrap +msgid "B<--add_extra_groups>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:287 +msgid "Add new user to extra groups defined in the configuration file." +msgstr "" + +#. type: TP +#: ../adduser.8:287 ../deluser.8:142 +#, no-wrap +msgid "B<--version>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:290 ../deluser.8:145 +msgid "Display version and copyright information." +msgstr "" + +#. type: SH +#: ../adduser.8:291 +#, no-wrap +msgid "EXIT VALUES" +msgstr "" + +#. type: TP +#: ../adduser.8:293 ../deluser.8:146 +#, no-wrap +msgid "B<0>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:296 +msgid "" +"The user exists as specified. This can have 2 causes: The user was created " +"by adduser or the user was already present on the system before adduser was " +"invoked. If adduser was returning 0 , invoking adduser a second time with " +"the same parameters as before also returns 0." +msgstr "" + +#. type: TP +#: ../adduser.8:296 ../deluser.8:149 +#, no-wrap +msgid "B<1>" +msgstr "" + +#. type: Plain text +#: ../adduser.8:299 +msgid "" +"Creating the user or group failed because it was already present with other " +"UID/GID than specified. The username or groupname was rejected because of a " +"mismatch with the configured regular expressions, see " +"adduser.conf(5). Adduser has been aborted by a signal." +msgstr "" + +#. type: Plain text +#: ../adduser.8:303 +msgid "" +"Or for many other yet undocumented reasons which are printed to console " +"then. You may then consider to remove B<--quiet> to make adduser more " +"verbose." +msgstr "" + +#. type: SH +#: ../adduser.8:304 ../adduser.conf.5:147 ../deluser.8:177 ../deluser.conf.5:84 +#, no-wrap +msgid "FILES" +msgstr "" + +#. type: TP +#: ../adduser.8:305 +#, no-wrap +msgid "/etc/adduser.conf" +msgstr "" + +#. type: Plain text +#: ../adduser.8:308 +msgid "Default configuration file for adduser and addgroup" +msgstr "" + +#. type: TP +#: ../adduser.8:308 +#, no-wrap +msgid "/usr/local/sbin/adduser.local" +msgstr "" + +#. type: Plain text +#: ../adduser.8:311 ../deluser.8:183 +msgid "Optional custom add-ons." +msgstr "" + +#. type: SH +#: ../adduser.8:312 ../adduser.conf.5:149 ../deluser.8:184 ../deluser.conf.5:86 +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: ../adduser.8:319 +msgid "" +"B(5), B(8), B(8), B(8), " +"B(8), Debian Policy 9.2.2." +msgstr "" + +#. type: SH +#: ../adduser.8:320 ../deluser.8:190 +#, no-wrap +msgid "COPYRIGHT" +msgstr "" + +#. type: Plain text +#: ../adduser.8:323 +msgid "" +"Copyright (C) 1997, 1998, 1999 Guy Maor. Modifications by Roland " +"Bauerschmidt and Marc Haber. Additional patches by Joerg Hoh and Stephen " +"Gran." +msgstr "" + +#. type: Plain text +#: ../adduser.8:327 ../deluser.8:200 +msgid "" +"Copyright (C) 1995 Ted Hajek, with a great deal borrowed from the original " +"Debian B" +msgstr "" + +#. type: Plain text +#: ../adduser.8:333 +msgid "" +"Copyright (C) 1994 Ian Murdock. B is free software; see the GNU " +"General Public Licence version 2 or later for copying conditions. There is " +"I warranty." +msgstr "" + +#. type: TH +#: ../adduser.conf.5:6 +#, no-wrap +msgid "adduser.conf" +msgstr "" + +#. type: Plain text +#: ../adduser.conf.5:12 +msgid "/etc/adduser.conf - configuration file for B and B." +msgstr "" + +#. type: Plain text +#: ../adduser.conf.5:28 +msgid "" +"The file I contains defaults for the programs " +"B , B , B and B. Each " +"line holds a single value pair in the form I