summaryrefslogtreecommitdiffstats
path: root/templates/man8/pam_systemd_home.8.pot
blob: 682ac4d32cdf09f0a4595cfa326388583e892106 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-03-01 17:03+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "PAM_SYSTEMD_HOME"
msgstr ""

#. type: TH
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "systemd 255"
msgstr ""

#. type: TH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "pam_systemd_home"
msgstr ""

#.  -----------------------------------------------------------------
#.  * MAIN CONTENT STARTS HERE *
#.  -----------------------------------------------------------------
#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"pam_systemd_home - Authenticate users and mount home directories via systemd-"
"homed\\&.service"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "pam_systemd_home\\&.so"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<pam_systemd_home> ensures that home directories managed by B<systemd-homed."
"service>(8)  are automatically activated (mounted) on user login, and are "
"deactivated (unmounted) when the last session of the user ends\\&. For such "
"users, it also provides authentication (when per-user disk encryption is "
"used, the disk encryption key is derived from the authentication credential "
"supplied at login time), account management (the \\m[blue]B<JSON user "
"record>\\m[]\\&\\s-2\\u[1]\\d\\s+2 embedded in the home store contains "
"account details), and implements the updating of the encryption password "
"(which is also used for user authentication)\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "OPTIONS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "The following options are understood:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<suspend=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Takes a boolean argument\\&. If true, the home directory of the user will be "
"suspended automatically during system suspend; if false it will remain "
"active\\&. Automatic suspending of the home directory improves security "
"substantially as secret key material is automatically removed from memory "
"before the system is put to sleep and must be re-acquired (through user re-"
"authentication) when coming back from suspend\\&. It is recommended to set "
"this parameter for all PAM applications that have support for automatically "
"re-authenticating via PAM on system resume\\&. If multiple sessions of the "
"same user are open in parallel the user\\*(Aqs home directory will be left "
"unsuspended on system suspend as long as at least one of the sessions does "
"not set this parameter to on\\&. Defaults to off\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Note that TTY logins generally do not support re-authentication on system "
"resume\\&. Re-authentication on system resume is primarily a concept "
"implementable in graphical environments, in the form of lock screens brought "
"up automatically when the system goes to sleep\\&. This means that if a user "
"concurrently uses graphical login sessions that implement the required re-"
"authentication mechanism and console logins that do not, the home directory "
"is not locked during suspend, due to the logic explained above\\&. That "
"said, it is possible to set this field for TTY logins too, ignoring the fact "
"that TTY logins actually don\\*(Aqt support the re-authentication "
"mechanism\\&. In that case the TTY sessions will appear hung until the user "
"logs in on another virtual terminal (regardless if via another TTY session "
"or graphically) which will resume the home directory and unblock the "
"original TTY session\\&. (Do note that lack of screen locking on TTY "
"sessions means even though the TTY session appears hung, keypresses can "
"still be queued into it, and the existing screen contents be read without re-"
"authentication; this limitation is unrelated to the home directory "
"management B<pam_systemd_home> and systemd-homed\\&.service implement\\&.)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Turning this option on by default is highly recommended for all sessions, "
"but only if the service managing these sessions correctly implements the "
"aforementioned re-authentication\\&. Note that the re-authentication must "
"take place from a component running outside of the user\\*(Aqs context, so "
"that it does not require access to the user\\*(Aqs home directory for "
"operation\\&. Traditionally, most desktop environments do not implement "
"screen locking this way, and need to be updated accordingly\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This setting may also be controlled via the I<$SYSTEMD_HOME_SUSPEND> "
"environment variable (see below), which B<pam_systemd_home> reads during "
"initialization and sets for sessions\\&. If both the environment variable is "
"set and the module parameter specified the latter takes precedence\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 245\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<debug>[=]"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Takes an optional boolean argument\\&. If yes or without the argument, the "
"module will log debugging information as it operates\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "MODULE TYPES PROVIDED"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The module implements all four PAM operations: B<auth> (to allow "
"authentication using the encrypted data), B<account> (because users with "
"systemd-homed\\&.service user accounts are described in a \\m[blue]B<JSON "
"user record>\\m[]\\&\\s-2\\u[1]\\d\\s+2 and may be configured in more detail "
"than in the traditional Linux user database), B<session> (because user "
"sessions must be tracked in order to implement automatic release when the "
"last session of the user is gone), B<password> (to change the encryption "
"password \\(em also used for user authentication \\(em through PAM)\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "ENVIRONMENT"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The following environment variables are initialized by the module and "
"available to the processes of the user\\*(Aqs session:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<$SYSTEMD_HOME=1>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Indicates that the user\\*(Aqs home directory is managed by systemd-homed\\&."
"service\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<$SYSTEMD_HOME_SUSPEND=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Indicates whether the session has been registered with the suspend mechanism "
"enabled or disabled (see above)\\&. The variable\\*(Aqs value is either "
"\"0\" or \"1\"\\&. Note that the module both reads the variable when "
"initializing, and sets it for sessions\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 246\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "EXAMPLE"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Here\\*(Aqs an example PAM configuration fragment that permits users managed "
"by systemd-homed\\&.service to log in:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"#%PAM-1\\&.0\n"
"auth      sufficient pam_unix\\&.so\n"
"B<-auth     sufficient pam_systemd_home\\&.so>\n"
"auth      required   pam_deny\\&.so\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"account   required   pam_nologin\\&.so\n"
"B<-account  sufficient pam_systemd_home\\&.so>\n"
"account   sufficient pam_unix\\&.so\n"
"account   required   pam_permit\\&.so\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"B<-password sufficient pam_systemd_home\\&.so>\n"
"password  sufficient pam_unix\\&.so sha512 shadow try_first_pass\n"
"password  required   pam_deny\\&.so\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"-session  optional   pam_keyinit\\&.so revoke\n"
"-session  optional   pam_loginuid\\&.so\n"
"B<-session  optional   pam_systemd_home\\&.so>\n"
"-session  optional   pam_systemd\\&.so\n"
"session   required   pam_unix\\&.so\n"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<systemd>(1), B<systemd-homed.service>(8), B<homed.conf>(5), B<homectl>(1), "
"B<pam_systemd>(8), B<pam.conf>(5), B<pam.d>(5), B<pam>(8)"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid " 1."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "JSON user record"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "\\%https://systemd.io/USER_RECORD/"
msgstr ""

#. type: TH
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid "systemd 254"
msgstr ""

#. type: Plain text
#: debian-bookworm
#, no-wrap
msgid ""
"B<-password sufficient pam_systemd_home\\&.so>\n"
"password  sufficient pam_unix\\&.so sha512 shadow try_first_pass use_authtok\n"
"password  required   pam_deny\\&.so\n"
msgstr ""