tizen 2.0
[external/shadow.git] / man / de / su.1
1 '\" t
2 .\"     Title: su
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
5 .\"      Date: 24.07.2009
6 .\"    Manual: Dienstprogramme f\(:ur Benutzer
7 .\"    Source: Dienstprogramme f\(:ur Benutzer
8 .\"  Language: German
9 .\"
10 .TH "SU" "1" "24.07.2009" "Dienstprogramme f\(:ur Benutzer" "Dienstprogramme f\(:ur Benutzer"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
15 .nh
16 .\" disable justification (adjust text to left margin only)
17 .ad l
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
21 .SH "NAME"
22 su \- \(:andert die Benutzer\-ID oder wechselt zu Root
23 .SH "SYNOPSIS"
24 .HP \w'\fBsu\fR\ 'u
25 \fBsu\fR [\fIOptionen\fR] [\fIBenutzername\fR]
26 .SH "BESCHREIBUNG"
27 .PP
28 Der Befehl
29 \fBsu\fR
30 dient dazu, w\(:ahrend einer Sitzung ein anderer Benutzer zu werden\&. Wenn
31 \fBsu\fR
32 ohne
33 \fBusername\fR
34 aufgerufen wird, wechselt es standardm\(:a\(ssig zu Root\&. Zus\(:atzlich kann das Argument
35 \fB\-\fR
36 angegeben werden\&. Damit wird eine Umgebung zur Verf\(:ugung gestellt, die der entspricht, die der Benutzer nach einer direkten Anmeldung erwartet\&.
37 .PP
38 Zus\(:atzliche Argumente k\(:onnen nach dem Benutzername angegeben werden\&. In diesem Fall werden sie an die Login\-Shell des Benutzers weitergereicht\&. Insbesondere f\(:uhrt das Argument
39 \fB\-c\fR
40 dazu, dass das n\(:achste Argument von den meisten Interpretatoren als Befehl behandelt wird\&. Dieser Befehl wird von der Shell ausgef\(:uhrt, die in
41 /etc/passwd
42 f\(:ur den Zielbenutzer angegeben ist\&.
43 .PP
44 Sie k\(:onnen das Argument
45 \fB\-\-\fR
46 verwenden, um Optionen f\(:ur
47 \fBsu\fR
48 von Argumenten f\(:ur die Shell zu trennen\&.
49 .PP
50 Der Benutzer wird gegebenenfalls nach einem Passwort gefragt\&. Unrichtige Passworteingaben werden eine Fehlermeldung erzeugen\&. Sowohl erfolgreiche als auch misslungene Versuche werden protokolliert, um Missbrauch des Systems zu entdecken\&.
51 .PP
52 The current environment is passed to the new shell\&. The value of
53 \fB$PATH\fR
54 is reset to
55 /bin:/usr/bin
56 for normal users, or
57 /sbin:/bin:/usr/sbin:/usr/bin
58 for the superuser\&. This may be changed with the
59 \fBENV_PATH\fR
60 and
61 \fBENV_SUPATH\fR
62 definitions in
63 /etc/login\&.defs\&.
64 .PP
65 Eine Subsystem\-Anmeldung wird durch einen "*" als erstes Zeichen der Login\-Shell gekennzeichnet\&. Das angegebene Home\-Verzeichnis wird als Wurzel f\(:ur das Dateisystem verwendet, auf welchem der Benutzer tats\(:achlich angemeldet ist\&.
66 .SH "OPTIONEN"
67 .PP
68 Die Optionen, die vom Befehl
69 \fBsu\fR
70 unterst\(:utzt werden, sind:
71 .PP
72 \fB\-c\fR, \fB\-\-command\fR\fIBEFEHL\fR
73 .RS 4
74 Gibt einen Befehl an, der von der Shell mittels ihrer Option
75 \fB\-c\fR
76 ausgef\(:uhrt wird\&.
77 .RE
78 .PP
79 \fB\-\fR, \fB\-l\fR, \fB\-\-login\fR
80 .RS 4
81 Eine Umgebung wird zur Verf\(:ugung gestellt, die der entspricht, die der Benutzer nach einer direkten Anmeldung erwartet\&.
82 .sp
83 Wenn
84 \fB\-\fR
85 verwendet wird, muss es als die letzte Option von
86 \fBsu\fR
87 angegeben werden\&. Die \(:ubrigen Formen ((\fB\-l\fR
88 und
89 \fB\-\-login\fR) unterliegen nicht dieser Beschr\(:ankung\&.
90 .RE
91 .PP
92 \fB\-s\fR, \fB\-\-shell\fR\fISHELL\fR
93 .RS 4
94 Die Shell, die gestartet wird\&.
95 .sp
96 Die aufgerufene Shell wird bestimmt durch (h\(:ochste Priorit\(:at zuerst):
97 .PP
98 .RS 4
99 Die Shell, die mit \-\-shell angegeben wurde\&.
100 .RE
101 .PP
102 .RS 4
103 Falls
104 \fB\-\-preserve\-environment\fR
105 verwendet wird, die Shell, die durch die Umgebungsvariable
106 \fB$SHELL\fR
107 festgelegt wird\&.
108 .RE
109 .PP
110 .RS 4
111 Die Shell, die in
112 /etc/passwd
113 f\(:ur den Zielbenutzer angegeben ist\&.
114 .RE
115 .PP
116 .RS 4
117 /bin/sh, falls durch die obigen Methoden keine Shell gefunden werden kann\&.
118 .RE
119 .sp
120 Falls der Zielbenutzer eine beschr\(:ankte Shell hat (d\&.h\&. das Feld f\(:ur die Shell im Eintrag des Benutzers in
121 /etc/passwd
122 ist nicht in
123 /etc/shell) aufgef\(:uhrt), wird die Option
124 \fB\-\-shell\fR
125 und die Umgebungsvariable
126 \fB$SHELL\fR
127 nicht beachtet, sofern
128 \fBsu\fR
129 nicht von Root aufgerufen wird\&.
130 .RE
131 .PP
132 \fB\-m\fR, \fB\-p\fR, \fB\-\-preserve\-environment\fR
133 .RS 4
134 Preserve the current environment, except for:
135 .PP
136 \fB$PATH\fR
137 .RS 4
138 reset according to the
139 /etc/login\&.defs
140 options
141 \fBENV_PATH\fR
142 or
143 \fBENV_SUPATH\fR
144 (see below);
145 .RE
146 .PP
147 \fB$IFS\fR
148 .RS 4
149 reset to
150 \(Bq<space><tab><newline>\(lq, if it was set\&.
151 .RE
152 .sp
153 Falls der Zielbenutzer eine beschr\(:ankte Shell besitzt, hat diese Option keinen Effekt (sofern
154 \fBsu\fR
155 nicht von Root aufgerufen wird)\&.
156 .sp
157 Note that the default behavior for the environment is the following:
158 .PP
159 .RS 4
160 The
161 \fB$HOME\fR,
162 \fB$SHELL\fR,
163 \fB$USER\fR,
164 \fB$LOGNAME\fR,
165 \fB$PATH\fR, and
166 \fB$IFS\fR
167 environment variables are reset\&.
168 .RE
169 .PP
170 .RS 4
171 If
172 \fB\-\-login\fR
173 is not used, the environment is copied, except for the variables above\&.
174 .RE
175 .PP
176 .RS 4
177 If
178 \fB\-\-login\fR
179 is used, the
180 \fB$TERM\fR,
181 \fB$COLORTERM\fR,
182 \fB$DISPLAY\fR, and
183 \fB$XAUTHORITY\fR
184 environment variables are copied if they were set\&.
185 .RE
186 .PP
187 .RS 4
188 If
189 \fB\-\-login\fR
190 is used, the
191 \fB$TZ\fR,
192 \fB$HZ\fR, and
193 \fB$MAIL\fR
194 environment variables are set according to the
195 /etc/login\&.defs
196 options
197 \fBENV_TZ\fR,
198 \fBENV_HZ\fR,
199 \fBMAIL_DIR\fR, and
200 \fBMAIL_FILE\fR
201 (see below)\&.
202 .RE
203 .PP
204 .RS 4
205 If
206 \fB\-\-login\fR
207 is used, other environment variables might be set by the
208 \fBENVIRON_FILE\fR
209 file (see below)\&.
210 .RE
211 .sp
212 .RE
213 .SH "WARNUNGEN"
214 .PP
215 Diese Version von
216 \fBsu\fR
217 hat viele Kompilierungsoptionen\&. Deren N\(:utzlichkeit h\(:angt von den Anforderungen der jeweiligen Umgebung ab\&.
218 .SH "CONFIGURATION"
219 .PP
220 The following configuration variables in
221 /etc/login\&.defs
222 change the behavior of this tool:
223 .PP
224 \fBCONSOLE\fR (string)
225 .RS 4
226 If defined, either full pathname of a file containing device names (one per line) or a ":" delimited list of device names\&. Root logins will be allowed only upon these devices\&.
227 .sp
228 If not defined, root will be allowed on any device\&.
229 .sp
230 The device should be specified without the /dev/ prefix\&.
231 .RE
232 .PP
233 \fBCONSOLE_GROUPS\fR (string)
234 .RS 4
235 List of groups to add to the user\'s supplementary groups set when logging in on the console (as determined by the CONSOLE setting)\&. Default is none\&.
236
237 Use with caution \- it is possible for users to gain permanent access to these groups, even when not logged in on the console\&.
238 .RE
239 .PP
240 \fBDEFAULT_HOME\fR (boolean)
241 .RS 4
242 Indicate if login is allowed if we can\'t cd to the home directory\&. Default in no\&.
243 .sp
244 If set to
245 \fIyes\fR, the user will login in the root (/) directory if it is not possible to cd to her home directory\&.
246 .RE
247 .PP
248 \fBENV_HZ\fR (string)
249 .RS 4
250 If set, it will be used to define the HZ environment variable when a user login\&. The value must be preceded by
251 \fIHZ=\fR\&. A common value on Linux is
252 \fIHZ=100\fR\&.
253 .RE
254 .PP
255 \fBENVIRON_FILE\fR (string)
256 .RS 4
257 If this file exists and is readable, login environment will be read from it\&. Every line should be in the form name=value\&.
258 .sp
259 Lines starting with a # are treated as comment lines and ignored\&.
260 .RE
261 .PP
262 \fBENV_PATH\fR (string)
263 .RS 4
264 If set, it will be used to define the PATH environment variable when a regular user login\&. The value can be preceded by
265 \fIPATH=\fR, or a colon separated list of paths (for example
266 \fI/bin:/usr/bin\fR)\&. The default value is
267 \fIPATH=/bin:/usr/bin\fR\&.
268 .RE
269 .PP
270 \fBENV_SUPATH\fR (string)
271 .RS 4
272 If set, it will be used to define the PATH environment variable when the superuser login\&. The value can be preceded by
273 \fIPATH=\fR, or a colon separated list of paths (for example
274 \fI/sbin:/bin:/usr/sbin:/usr/bin\fR)\&. The default value is
275 \fIPATH=/bin:/usr/bin\fR\&.
276 .RE
277 .PP
278 \fBENV_TZ\fR (string)
279 .RS 4
280 If set, it will be used to define the TZ environment variable when a user login\&. The value can be the name of a timezone preceded by
281 \fITZ=\fR
282 (for example
283 \fITZ=CST6CDT\fR), or the full path to the file containing the timezone specification (for example
284 /etc/tzname)\&.
285 .sp
286 If a full path is specified but the file does not exist or cannot be read, the default is to use
287 \fITZ=CST6CDT\fR\&.
288 .RE
289 .PP
290 \fBLOGIN_STRING\fR (string)
291 .RS 4
292 The string used for prompting a password\&. The default is to use "Password: ", or a translation of that string\&. If you set this variable, the prompt will no be translated\&.
293 .sp
294 If the string contains
295 \fI%s\fR, this will be replaced by the user\'s name\&.
296 .RE
297 .PP
298 \fBMAIL_CHECK_ENAB\fR (boolean)
299 .RS 4
300 Enable checking and display of mailbox status upon login\&.
301 .sp
302 You should disable it if the shell startup files already check for mail ("mailx \-e" or equivalent)\&.
303 .RE
304 .PP
305 \fBMAIL_DIR\fR (string)
306 .RS 4
307 Das Verzeichnis des Mail\-Spools\&. Diese Angabe wird ben\(:otigt, um die Mailbox zu bearbeiten, nachdem das entsprechende Benutzerkonto ver\(:andert oder gel\(:oscht wurde\&. Falls nicht angegeben, wird ein Standard verwendet, der beim Kompilieren festgelegt wurde\&.
308 .RE
309 .PP
310 \fBMAIL_FILE\fR (string)
311 .RS 4
312 Defines the location of the users mail spool files relatively to their home directory\&.
313 .RE
314 .PP
315 The
316 \fBMAIL_DIR\fR
317 and
318 \fBMAIL_FILE\fR
319 variables are used by
320 \fBuseradd\fR,
321 \fBusermod\fR, and
322 \fBuserdel\fR
323 to create, move, or delete the user\'s mail spool\&.
324 .PP
325 If
326 \fBMAIL_CHECK_ENAB\fR
327 is set to
328 \fIyes\fR, they are also used to define the
329 \fBMAIL\fR
330 environment variable\&.
331 .PP
332 \fBQUOTAS_ENAB\fR (boolean)
333 .RS 4
334 Enable setting of ulimit, umask, and niceness from passwd gecos field\&.
335 .RE
336 .PP
337 \fBSULOG_FILE\fR (string)
338 .RS 4
339 If defined, all su activity is logged to this file\&.
340 .RE
341 .PP
342 \fBSU_NAME\fR (string)
343 .RS 4
344 If defined, the command name to display when running "su \-"\&. For example, if this is defined as "su" then a "ps" will display the command is "\-su"\&. If not defined, then "ps" would display the name of the shell actually being run, e\&.g\&. something like "\-sh"\&.
345 .RE
346 .PP
347 \fBSU_WHEEL_ONLY\fR (boolean)
348 .RS 4
349 If
350 \fIyes\fR, the user must be listed as a member of the first gid 0 group in
351 /etc/group
352 (called
353 \fIroot\fR
354 on most Linux systems) to be able to
355 \fBsu\fR
356 to uid 0 accounts\&. If the group doesn\'t exist or is empty, no one will be able to
357 \fBsu\fR
358 to uid 0\&.
359 .RE
360 .PP
361 \fBSYSLOG_SU_ENAB\fR (boolean)
362 .RS 4
363 Enable "syslog" logging of
364 \fBsu\fR
365 activity \- in addition to sulog file logging\&.
366 .RE
367 .PP
368 \fBUSERGROUPS_ENAB\fR (boolean)
369 .RS 4
370 Enable setting of the umask group bits to be the same as owner bits (examples: 022 \-> 002, 077 \-> 007) for non\-root users, if the uid is the same as gid, and username is the same as the primary group name\&.
371 .sp
372 If set to
373 \fIyes\fR,
374 \fBuserdel\fR
375 will remove the user\'s group if it contains no more members, and
376 \fBuseradd\fR
377 will create by default a group with the name of the user\&.
378 .RE
379 .SH "DATEIEN"
380 .PP
381 /etc/passwd
382 .RS 4
383 Informationen zu den Benutzerkonten\&.
384 .RE
385 .PP
386 /etc/shadow
387 .RS 4
388 Verschl\(:usselte Informationen zu den Benutzerkonten\&.
389 .RE
390 .PP
391 /etc/login\&.defs
392 .RS 4
393 Konfiguration des Shadow\-Passwort\-Systems
394 .RE
395 .SH "SIEHE AUCH"
396 .PP
397 \fBlogin\fR(1),
398 \fBlogin.defs\fR(5),
399 \fBsg\fR(1),
400 \fBsh\fR(1)\&.