1 # Czech translation for util-linux-man
2 # This file is distributed under the same license as the util-linux package.
3 # Copyright © of this file:
4 # Luděk Brukner <Ludek.Brukner@barco.com>, 2001.
5 # Ondřej Pavlíček <mox@post.cz>, 2001.
6 # Petr Kolář <Petr.Kolar@vslib.cz>, 2001.
7 # Pavel Heimlich <tropikhajma@gmail.com>, 2009.
8 # Petr Písař <petr.pisar@atlas.cz>, 2022.
11 "Project-Id-Version: util-linux-man 2.38-rc4\n"
12 "Report-Msgid-Bugs-To: util-linux@vger.kernel.org\n"
13 "POT-Creation-Date: 2023-11-23 11:31+0100\n"
14 "PO-Revision-Date: 2022-03-19 16:33+01:00\n"
15 "Last-Translator: Petr Písař <petr.pisar@atlas.cz>\n"
16 "Language-Team: Czech <translation-team-cs@lists.sourceforge.net>\n"
19 "Content-Type: text/plain; charset=UTF-8\n"
20 "Content-Transfer-Encoding: 8bit\n"
21 "X-Bugs: Report translation errors to the Language-Team address.\n"
22 "Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"
25 #: ../man-common/bugreports.adoc:1
27 msgid "REPORTING BUGS"
31 #: ../man-common/bugreports.adoc:3
33 "For bug reports, use the issue tracker at https://github.com/util-linux/util-"
36 "Pro hlášení chyb (anglicky) použijte systém pro sledování problémů na "
37 "https://github.com/util-linux/util-linux/issues."
40 #: ../man-common/colors.adoc:1
46 #: ../man-common/colors.adoc:5
48 "The output colorization is implemented by *terminal-colors.d*(5) "
49 "functionality. Implicit coloring can be disabled by an empty file"
51 "Obarvení výstupu je zařízeno pomocí funkcionality v *terminal-colors.d*(5). "
52 "Výchozí obarvení lze vypnout pomocí prázdného souboru"
54 #. type: delimited block _
55 #: ../man-common/colors.adoc:7
56 msgid "_/etc/terminal-colors.d/{command}.disable_"
57 msgstr "_/etc/terminal-colors.d/{command}.disable_"
60 #: ../man-common/colors.adoc:9
61 msgid "for the *{command}* command or for all tools by"
62 msgstr "pro příkaz *{command}* nebo pro všechny nástroje z"
64 #. type: delimited block _
65 #: ../man-common/colors.adoc:11
66 msgid "_/etc/terminal-colors.d/disable_"
67 msgstr "_/etc/terminal-colors.d/disable_"
70 #: ../man-common/colors.adoc:14 ../lib/terminal-colors.d.5.adoc:47
72 "The user-specific _$XDG_CONFIG_HOME/terminal-colors.d_ or _$HOME/.config/"
73 "terminal-colors.d_ overrides the global setting."
75 "Globální nastavení lze přebít uživatelským nastavením v _$XDG_CONFIG_HOME/"
76 "terminal-colors.d_ a _$HOME/.config/terminal-colors.d_."
79 #: ../man-common/colors.adoc:17
81 "Note that the output colorization may be enabled by default, and in this "
82 "case _terminal-colors.d_ directories do not have to exist yet."
84 "Pamatujte, že obarvení výstupu může být standardně zapnuto a v takovém "
85 "případě adresáře _terminal-colors.d_ nemusí ještě existovat."
88 #: ../man-common/footer-config.adoc:1 ../man-common/footer-lib.adoc:1
89 #: ../man-common/footer.adoc:1 ../login-utils/vipw.8.adoc:79
94 #. TRANSLATORS: Keep *{configfile}* untranslated, it will be replaced with the name of the configuration file.
96 #: ../man-common/footer-config.adoc:4
98 msgid "*{configfile}* is part of the util-linux package which can be downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel Archive].\n"
99 msgstr "*{configfile}* je součástí balíku util-linux, který lze stáhnout z https://www.kernel.org/pub/linux/utils/util-linux/[archivu jádra Linuxu].\n"
101 #. TRANSLATORS: Keep *{lib}* and {firstversion} untranslated, will be replaced with the library name and the version of util-linux where the library appeared for the first time.
103 #: ../man-common/footer-lib.adoc:4
105 "The *{lib}* library is part of the util-linux package since version "
106 "{firstversion}. It can be downloaded from https://www.kernel.org/pub/linux/"
107 "utils/util-linux/[Linux Kernel Archive]."
109 "Knihovna *{lib}* je součástí balíku util-linux od verze {firstversion}. "
110 "Stáhnout jej lze z https://www.kernel.org/pub/linux/utils/util-linux/"
111 "[archivu jádra Linuxu]."
113 #. TRANSLATORS: Keep *{command}* untranslated, it will be replaced with the command name.
115 #: ../man-common/footer.adoc:4
117 "The *{command}* command is part of the util-linux package which can be "
118 "downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
121 "Příkaz *{command}* je součástí balíku util-linux, který lze stáhnout "
122 "z https://www.kernel.org/pub/linux/utils/util-linux/[archivu jádra Linuxu]."
124 #. type: Labeled list
125 #: ../man-common/help-version.adoc:1 ../disk-utils/sfdisk.8.adoc:222
126 #: ../login-utils/chsh.1.adoc:39 ../sys-utils/blkpr.8.adoc:45
127 #: ../sys-utils/setsid.1.adoc:37
129 msgid "*-h*, *--help*"
130 msgstr "*-h*, *--help*"
133 #: ../man-common/help-version.adoc:3 ../disk-utils/fsck.8.adoc:114
134 #: ../disk-utils/sfdisk.8.adoc:224 ../login-utils/chfn.1.adoc:51
135 #: ../sys-utils/blkpr.8.adoc:47 ../sys-utils/rfkill.8.adoc:48
136 #: ../sys-utils/setsid.1.adoc:39 ../text-utils/col.1.adoc:82
137 msgid "Display help text and exit."
138 msgstr "Zobrazí text nápovědy a skončí."
140 #. type: Labeled list
141 #: ../man-common/help-version.adoc:4 ../disk-utils/fdisk.8.adoc:100
142 #: ../login-utils/chfn.1.adoc:52 ../login-utils/chsh.1.adoc:43
143 #: ../sys-utils/blkpr.8.adoc:42 ../sys-utils/setsid.1.adoc:34
144 #: ../text-utils/col.1.adoc:83
146 msgid "*-V*, *--version*"
147 msgstr "*-V*, *--version*"
150 #: ../man-common/help-version.adoc:5 ../text-utils/col.1.adoc:85
151 msgid "Print version and exit."
152 msgstr "Zobrazí verzi a skončí."
155 #: ../man-common/in-bytes.adoc:2
156 msgid "Print the sizes in bytes rather than in a human-readable format."
157 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
160 #: ../man-common/in-bytes.adoc:7
162 "By default, the unit, sizes are expressed in, is byte, and unit prefixes are "
163 "in power of 2^10 (1024). Abbreviations of symbols are exhibited truncated in "
164 "order to reach a better readability, by exhibiting alone the first letter of "
165 "them; examples: \"1 KiB\" and \"1 MiB\" are respectively exhibited as \"1 "
166 "K\" and \"1 M\", then omitting on purpose the mention \"iB\", which is part "
167 "of these abbreviations."
169 "Standardně jednotka, v nichž jsou velikosti vyjádřeny, je bajt, a předpony "
170 "jednotek jsou v mocninách 2^10 (1024). Zkratky symbolů jsou kvůli lepší "
171 "srozumitelnosti zkráceny na první písmeno. Například: „1 KiB“ a „1 MiB“ jsou "
172 "zobrazeny jako „1 K“ a „1 M“, přičemž koncovka „iB“, která je součástí "
173 "těchto zkratek, je záměrně vynechána."
176 #: ../man-common/translation.adoc:1
182 #: ../man-common/translation.adoc:6
185 #| "For the authors of this translation, see the header of the corresponding "
186 #| "*.po file at GNU TP: http://translationproject.org/domain/util-linux-man."
189 "For the authors of this translation, see the header of the corresponding *."
190 "po file at GNU TP: https://translationproject.org/domain/util-linux-man.html"
192 "Autory tohoto překladu lze zjistit nahlédnutím do hlavičky odpovídajícího "
193 "souboru *.po na GNU TP: http://translationproject.org/domain/util-linux-man."
196 #. TRANSLATORS: Please replace %1 with the address of the mailing list of your
199 #: ../man-common/translation.adoc:12
200 msgid "Report man page translation bugs to: <%1>"
202 "Chyby v překladu manuálové stránky hlaste (česky) na: <translation-team-"
203 "cs@lists.sourceforge.net>"
205 #. addpart.8 -- man page for addpart
206 #. Copyright 2007 Karel Zak <kzak@redhat.com>
207 #. Copyright 2007 Red Hat, Inc.
208 #. May be distributed under the GNU General Public License
210 #: ../disk-utils/addpart.8.adoc:8
215 #. type: Attribute :man manual:
216 #: ../disk-utils/addpart.8.adoc:10 ../disk-utils/blockdev.8.adoc:10
217 #: ../disk-utils/cfdisk.8.adoc:18 ../disk-utils/delpart.8.adoc:10
218 #: ../disk-utils/fdformat.8.adoc:8 ../disk-utils/fdisk.8.adoc:11
219 #: ../disk-utils/fsck.8.adoc:8 ../disk-utils/fsck.cramfs.8.adoc:4
220 #: ../disk-utils/fsck.minix.8.adoc:8 ../disk-utils/isosize.8.adoc:4
221 #: ../disk-utils/mkfs.8.adoc:4 ../disk-utils/mkfs.bfs.8.adoc:8
222 #: ../disk-utils/mkfs.cramfs.8.adoc:4 ../disk-utils/mkfs.minix.8.adoc:11
223 #: ../disk-utils/mkswap.8.adoc:8 ../disk-utils/partx.8.adoc:11
224 #: ../disk-utils/raw.8.adoc:4 ../disk-utils/resizepart.8.adoc:10
225 #: ../disk-utils/sfdisk.8.adoc:17 ../disk-utils/swaplabel.8.adoc:8
226 #: ../login-utils/nologin.8.adoc:4 ../login-utils/sulogin.8.adoc:22
227 #: ../login-utils/vipw.8.adoc:38 ../misc-utils/blkid.8.adoc:6
228 #: ../misc-utils/findfs.8.adoc:6 ../misc-utils/findmnt.8.adoc:4
229 #: ../misc-utils/lsblk.8.adoc:4 ../misc-utils/lslocks.8.adoc:14
230 #: ../misc-utils/uuidd.8.adoc:8 ../misc-utils/wipefs.8.adoc:6
231 #: ../sys-utils/blkdiscard.8.adoc:4 ../sys-utils/blkzone.8.adoc:4
232 #: ../sys-utils/blkpr.8.adoc:4 ../sys-utils/chcpu.8.adoc:4
233 #: ../sys-utils/chmem.8.adoc:4 ../sys-utils/ctrlaltdel.8.adoc:8
234 #: ../sys-utils/fsfreeze.8.adoc:4 ../sys-utils/fstrim.8.adoc:4
235 #: ../sys-utils/hwclock.8.adoc:11 ../sys-utils/ldattach.8.adoc:8
236 #: ../sys-utils/losetup.8.adoc:4 ../sys-utils/lsns.8.adoc:9
237 #: ../sys-utils/mount.8.adoc:34 ../sys-utils/pivot_root.8.adoc:4
238 #: ../sys-utils/readprofile.8.adoc:4 ../sys-utils/rfkill.8.adoc:4
239 #: ../sys-utils/rtcwake.8.adoc:4 ../sys-utils/setarch.8.adoc:4
240 #: ../sys-utils/swapon.8.adoc:4 ../sys-utils/switch_root.8.adoc:4
241 #: ../sys-utils/tunelp.8.adoc:4 ../sys-utils/umount.8.adoc:29
242 #: ../sys-utils/wdctl.8.adoc:4 ../sys-utils/zramctl.8.adoc:4
243 #: ../term-utils/agetty.8.adoc:4
245 msgid "System Administration"
249 #: ../disk-utils/addpart.8.adoc:15 ../disk-utils/blockdev.8.adoc:15
250 #: ../disk-utils/cfdisk.8.adoc:23 ../disk-utils/delpart.8.adoc:15
251 #: ../disk-utils/fdformat.8.adoc:13 ../disk-utils/fdisk.8.adoc:17
252 #: ../disk-utils/fsck.8.adoc:13 ../disk-utils/fsck.cramfs.8.adoc:9
253 #: ../disk-utils/fsck.minix.8.adoc:13 ../disk-utils/isosize.8.adoc:9
254 #: ../disk-utils/mkfs.8.adoc:9 ../disk-utils/mkfs.bfs.8.adoc:13
255 #: ../disk-utils/mkfs.cramfs.8.adoc:9 ../disk-utils/mkfs.minix.8.adoc:16
256 #: ../disk-utils/mkswap.8.adoc:13 ../disk-utils/partx.8.adoc:16
257 #: ../disk-utils/raw.8.adoc:9 ../disk-utils/resizepart.8.adoc:15
258 #: ../disk-utils/sfdisk.8.adoc:24 ../disk-utils/swaplabel.8.adoc:13
259 #: ../lib/terminal-colors.d.5.adoc:17 ../libblkid/libblkid.3.adoc:16
260 #: ../libuuid/man/uuid.3.adoc:41 ../libuuid/man/uuid_clear.3.adoc:41
261 #: ../libuuid/man/uuid_compare.3.adoc:41 ../libuuid/man/uuid_copy.3.adoc:41
262 #: ../libuuid/man/uuid_generate.3.adoc:43 ../libuuid/man/uuid_is_null.3.adoc:41
263 #: ../libuuid/man/uuid_parse.3.adoc:41 ../libuuid/man/uuid_time.3.adoc:41
264 #: ../libuuid/man/uuid_unparse.3.adoc:41 ../login-utils/chfn.1.adoc:17
265 #: ../login-utils/chsh.1.adoc:17 ../login-utils/last.1.adoc:26
266 #: ../login-utils/login.1.adoc:13 ../login-utils/lslogins.1.adoc:11
267 #: ../login-utils/newgrp.1.adoc:11 ../login-utils/nologin.8.adoc:9
268 #: ../login-utils/runuser.1.adoc:9 ../login-utils/su.1.adoc:10
269 #: ../login-utils/sulogin.8.adoc:28 ../login-utils/utmpdump.1.adoc:26
270 #: ../login-utils/vipw.8.adoc:43 ../misc-utils/blkid.8.adoc:12
271 #: ../misc-utils/cal.1.adoc:47 ../misc-utils/fadvise.1.adoc:9
272 #: ../misc-utils/fincore.1.adoc:15 ../misc-utils/findfs.8.adoc:11
273 #: ../misc-utils/findmnt.8.adoc:10 ../misc-utils/getopt.1.adoc:10
274 #: ../misc-utils/hardlink.1.adoc:15 ../misc-utils/kill.1.adoc:14
275 #: ../misc-utils/logger.1.adoc:43 ../misc-utils/look.1.adoc:43
276 #: ../misc-utils/lsblk.8.adoc:9 ../misc-utils/lsfd.1.adoc:15
277 #: ../misc-utils/lslocks.8.adoc:20 ../misc-utils/mcookie.1.adoc:11
278 #: ../misc-utils/namei.1.adoc:9 ../misc-utils/pipesz.1.adoc:9
279 #: ../misc-utils/rename.1.adoc:11 ../misc-utils/uuidd.8.adoc:13
280 #: ../misc-utils/uuidgen.1.adoc:13 ../misc-utils/uuidparse.1.adoc:11
281 #: ../misc-utils/waitpid.1.adoc:9 ../misc-utils/whereis.1.adoc:43
282 #: ../misc-utils/wipefs.8.adoc:11 ../schedutils/chrt.1.adoc:34
283 #: ../schedutils/ionice.1.adoc:10 ../schedutils/taskset.1.adoc:33
284 #: ../schedutils/uclampset.1.adoc:34 ../sys-utils/adjtime_config.5.adoc:9
285 #: ../sys-utils/blkdiscard.8.adoc:9 ../sys-utils/blkzone.8.adoc:9
286 #: ../sys-utils/blkpr.8.adoc:9 ../sys-utils/chcpu.8.adoc:9
287 #: ../sys-utils/chmem.8.adoc:9 ../sys-utils/choom.1.adoc:9
288 #: ../sys-utils/ctrlaltdel.8.adoc:13 ../sys-utils/dmesg.1.adoc:13
289 #: ../sys-utils/eject.1.adoc:17 ../sys-utils/fallocate.1.adoc:9
290 #: ../sys-utils/flock.1.adoc:34 ../sys-utils/fsfreeze.8.adoc:9
291 #: ../sys-utils/fstab.5.adoc:43 ../sys-utils/fstrim.8.adoc:9
292 #: ../sys-utils/hwclock.8.adoc:17 ../sys-utils/ipcmk.1.adoc:13
293 #: ../sys-utils/ipcrm.1.adoc:14 ../sys-utils/ipcs.1.adoc:13
294 #: ../sys-utils/irqtop.1.adoc:9 ../sys-utils/ldattach.8.adoc:13
295 #: ../sys-utils/losetup.8.adoc:9 ../sys-utils/lscpu.1.adoc:9
296 #: ../sys-utils/lsipc.1.adoc:9 ../sys-utils/lsirq.1.adoc:9
297 #: ../sys-utils/lsmem.1.adoc:9 ../sys-utils/lsns.8.adoc:14
298 #: ../sys-utils/mount.8.adoc:40 ../sys-utils/mountpoint.1.adoc:9
299 #: ../sys-utils/nsenter.1.adoc:9 ../sys-utils/pivot_root.8.adoc:9
300 #: ../sys-utils/prlimit.1.adoc:15 ../sys-utils/readprofile.8.adoc:9
301 #: ../sys-utils/renice.1.adoc:43 ../sys-utils/rfkill.8.adoc:9
302 #: ../sys-utils/rtcwake.8.adoc:9 ../sys-utils/setarch.8.adoc:9
303 #: ../sys-utils/setpriv.1.adoc:9 ../sys-utils/setsid.1.adoc:11
304 #: ../sys-utils/swapon.8.adoc:9 ../sys-utils/switch_root.8.adoc:9
305 #: ../sys-utils/tunelp.8.adoc:9 ../sys-utils/umount.8.adoc:34
306 #: ../sys-utils/unshare.1.adoc:9 ../sys-utils/wdctl.8.adoc:9
307 #: ../sys-utils/zramctl.8.adoc:9 ../term-utils/agetty.8.adoc:9
308 #: ../term-utils/mesg.1.adoc:43 ../term-utils/script.1.adoc:44
309 #: ../term-utils/scriptlive.1.adoc:10 ../term-utils/scriptreplay.1.adoc:10
310 #: ../term-utils/setterm.1.adoc:16 ../term-utils/wall.1.adoc:44
311 #: ../term-utils/write.1.adoc:46 ../text-utils/col.1.adoc:46
312 #: ../text-utils/colcrt.1.adoc:44 ../text-utils/colrm.1.adoc:43
313 #: ../text-utils/column.1.adoc:43 ../text-utils/hexdump.1.adoc:45
314 #: ../text-utils/line.1.adoc:10 ../text-utils/more.1.adoc:46
315 #: ../text-utils/pg.1.adoc:10 ../text-utils/rev.1.adoc:43
316 #: ../text-utils/ul.1.adoc:43
322 #: ../disk-utils/addpart.8.adoc:18
323 msgid "addpart - tell the kernel about the existence of a partition"
327 #: ../disk-utils/addpart.8.adoc:19 ../disk-utils/blockdev.8.adoc:19
328 #: ../disk-utils/cfdisk.8.adoc:27 ../disk-utils/delpart.8.adoc:19
329 #: ../disk-utils/fdformat.8.adoc:17 ../disk-utils/fdisk.8.adoc:21
330 #: ../disk-utils/fsck.8.adoc:17 ../disk-utils/fsck.cramfs.8.adoc:13
331 #: ../disk-utils/fsck.minix.8.adoc:17 ../disk-utils/isosize.8.adoc:13
332 #: ../disk-utils/mkfs.8.adoc:13 ../disk-utils/mkfs.bfs.8.adoc:17
333 #: ../disk-utils/mkfs.cramfs.8.adoc:13 ../disk-utils/mkfs.minix.8.adoc:20
334 #: ../disk-utils/mkswap.8.adoc:17 ../disk-utils/partx.8.adoc:20
335 #: ../disk-utils/raw.8.adoc:13 ../disk-utils/resizepart.8.adoc:19
336 #: ../disk-utils/sfdisk.8.adoc:28 ../disk-utils/swaplabel.8.adoc:17
337 #: ../lib/terminal-colors.d.5.adoc:21 ../libblkid/libblkid.3.adoc:20
338 #: ../libuuid/man/uuid.3.adoc:45 ../libuuid/man/uuid_clear.3.adoc:45
339 #: ../libuuid/man/uuid_compare.3.adoc:45 ../libuuid/man/uuid_copy.3.adoc:45
340 #: ../libuuid/man/uuid_generate.3.adoc:47 ../libuuid/man/uuid_is_null.3.adoc:45
341 #: ../libuuid/man/uuid_parse.3.adoc:45 ../libuuid/man/uuid_time.3.adoc:45
342 #: ../libuuid/man/uuid_unparse.3.adoc:45 ../login-utils/chfn.1.adoc:21
343 #: ../login-utils/chsh.1.adoc:21 ../login-utils/last.1.adoc:30
344 #: ../login-utils/login.1.adoc:17 ../login-utils/lslogins.1.adoc:15
345 #: ../login-utils/newgrp.1.adoc:15 ../login-utils/nologin.8.adoc:13
346 #: ../login-utils/runuser.1.adoc:13 ../login-utils/su.1.adoc:14
347 #: ../login-utils/sulogin.8.adoc:32 ../login-utils/utmpdump.1.adoc:30
348 #: ../login-utils/vipw.8.adoc:47 ../misc-utils/blkid.8.adoc:16
349 #: ../misc-utils/cal.1.adoc:51 ../misc-utils/fadvise.1.adoc:13
350 #: ../misc-utils/fincore.1.adoc:19 ../misc-utils/findfs.8.adoc:15
351 #: ../misc-utils/findmnt.8.adoc:14 ../misc-utils/getopt.1.adoc:14
352 #: ../misc-utils/hardlink.1.adoc:19 ../misc-utils/kill.1.adoc:18
353 #: ../misc-utils/logger.1.adoc:47 ../misc-utils/look.1.adoc:47
354 #: ../misc-utils/lsblk.8.adoc:13 ../misc-utils/lsfd.1.adoc:19
355 #: ../misc-utils/lslocks.8.adoc:24 ../misc-utils/mcookie.1.adoc:15
356 #: ../misc-utils/namei.1.adoc:13 ../misc-utils/pipesz.1.adoc:13
357 #: ../misc-utils/rename.1.adoc:15 ../misc-utils/uuidd.8.adoc:17
358 #: ../misc-utils/uuidgen.1.adoc:17 ../misc-utils/uuidparse.1.adoc:15
359 #: ../misc-utils/waitpid.1.adoc:13 ../misc-utils/whereis.1.adoc:47
360 #: ../misc-utils/wipefs.8.adoc:15 ../schedutils/chrt.1.adoc:38
361 #: ../schedutils/ionice.1.adoc:14 ../schedutils/taskset.1.adoc:37
362 #: ../schedutils/uclampset.1.adoc:39 ../sys-utils/adjtime_config.5.adoc:13
363 #: ../sys-utils/blkdiscard.8.adoc:13 ../sys-utils/blkzone.8.adoc:13
364 #: ../sys-utils/blkpr.8.adoc:13 ../sys-utils/chcpu.8.adoc:13
365 #: ../sys-utils/chmem.8.adoc:13 ../sys-utils/ctrlaltdel.8.adoc:17
366 #: ../sys-utils/dmesg.1.adoc:17 ../sys-utils/fallocate.1.adoc:13
367 #: ../sys-utils/flock.1.adoc:38 ../sys-utils/fsfreeze.8.adoc:13
368 #: ../sys-utils/fstab.5.adoc:47 ../sys-utils/fstrim.8.adoc:13
369 #: ../sys-utils/hwclock.8.adoc:21 ../sys-utils/ipcmk.1.adoc:17
370 #: ../sys-utils/ipcrm.1.adoc:18 ../sys-utils/ipcs.1.adoc:17
371 #: ../sys-utils/irqtop.1.adoc:13 ../sys-utils/ldattach.8.adoc:17
372 #: ../sys-utils/losetup.8.adoc:13 ../sys-utils/lscpu.1.adoc:13
373 #: ../sys-utils/lsipc.1.adoc:13 ../sys-utils/lsirq.1.adoc:13
374 #: ../sys-utils/lsmem.1.adoc:13 ../sys-utils/lsns.8.adoc:18
375 #: ../sys-utils/mount.8.adoc:44 ../sys-utils/mountpoint.1.adoc:13
376 #: ../sys-utils/nsenter.1.adoc:13 ../sys-utils/pivot_root.8.adoc:13
377 #: ../sys-utils/prlimit.1.adoc:19 ../sys-utils/readprofile.8.adoc:13
378 #: ../sys-utils/renice.1.adoc:47 ../sys-utils/rfkill.8.adoc:13
379 #: ../sys-utils/rtcwake.8.adoc:13 ../sys-utils/setarch.8.adoc:13
380 #: ../sys-utils/setpriv.1.adoc:13 ../sys-utils/setsid.1.adoc:15
381 #: ../sys-utils/swapon.8.adoc:13 ../sys-utils/switch_root.8.adoc:13
382 #: ../sys-utils/tunelp.8.adoc:13 ../sys-utils/umount.8.adoc:38
383 #: ../sys-utils/unshare.1.adoc:13 ../sys-utils/wdctl.8.adoc:13
384 #: ../sys-utils/zramctl.8.adoc:13 ../term-utils/agetty.8.adoc:13
385 #: ../term-utils/mesg.1.adoc:47 ../term-utils/script.1.adoc:48
386 #: ../term-utils/scriptlive.1.adoc:14 ../term-utils/scriptreplay.1.adoc:14
387 #: ../term-utils/setterm.1.adoc:20 ../term-utils/wall.1.adoc:48
388 #: ../text-utils/col.1.adoc:50 ../text-utils/colcrt.1.adoc:48
389 #: ../text-utils/colrm.1.adoc:47 ../text-utils/column.1.adoc:47
390 #: ../text-utils/line.1.adoc:14 ../text-utils/more.1.adoc:50
391 #: ../text-utils/pg.1.adoc:14 ../text-utils/rev.1.adoc:47
392 #: ../text-utils/ul.1.adoc:47
398 #: ../disk-utils/addpart.8.adoc:22
400 msgid "*addpart* _device partition start length_\n"
404 #: ../disk-utils/addpart.8.adoc:23 ../disk-utils/blockdev.8.adoc:27
405 #: ../disk-utils/cfdisk.8.adoc:31 ../disk-utils/delpart.8.adoc:23
406 #: ../disk-utils/fdformat.8.adoc:21 ../disk-utils/fdisk.8.adoc:27
407 #: ../disk-utils/fsck.8.adoc:21 ../disk-utils/fsck.cramfs.8.adoc:17
408 #: ../disk-utils/fsck.minix.8.adoc:21 ../disk-utils/isosize.8.adoc:17
409 #: ../disk-utils/mkfs.8.adoc:17 ../disk-utils/mkfs.bfs.8.adoc:21
410 #: ../disk-utils/mkfs.cramfs.8.adoc:17 ../disk-utils/mkfs.minix.8.adoc:24
411 #: ../disk-utils/mkswap.8.adoc:21 ../disk-utils/partx.8.adoc:26
412 #: ../disk-utils/raw.8.adoc:23 ../disk-utils/resizepart.8.adoc:23
413 #: ../disk-utils/sfdisk.8.adoc:34 ../disk-utils/swaplabel.8.adoc:21
414 #: ../lib/terminal-colors.d.5.adoc:25 ../libblkid/libblkid.3.adoc:26
415 #: ../libuuid/man/uuid.3.adoc:49 ../libuuid/man/uuid_clear.3.adoc:51
416 #: ../libuuid/man/uuid_compare.3.adoc:51 ../libuuid/man/uuid_copy.3.adoc:51
417 #: ../libuuid/man/uuid_generate.3.adoc:58 ../libuuid/man/uuid_is_null.3.adoc:51
418 #: ../libuuid/man/uuid_parse.3.adoc:52 ../libuuid/man/uuid_time.3.adoc:51
419 #: ../libuuid/man/uuid_unparse.3.adoc:53 ../login-utils/chfn.1.adoc:25
420 #: ../login-utils/chsh.1.adoc:25 ../login-utils/last.1.adoc:36
421 #: ../login-utils/login.1.adoc:21 ../login-utils/lslogins.1.adoc:19
422 #: ../login-utils/newgrp.1.adoc:19 ../login-utils/nologin.8.adoc:17
423 #: ../login-utils/runuser.1.adoc:19 ../login-utils/su.1.adoc:18
424 #: ../login-utils/sulogin.8.adoc:36 ../login-utils/utmpdump.1.adoc:34
425 #: ../login-utils/vipw.8.adoc:53 ../misc-utils/blkid.8.adoc:26
426 #: ../misc-utils/cal.1.adoc:57 ../misc-utils/fadvise.1.adoc:19
427 #: ../misc-utils/fincore.1.adoc:23 ../misc-utils/findfs.8.adoc:19
428 #: ../misc-utils/findmnt.8.adoc:22 ../misc-utils/getopt.1.adoc:22
429 #: ../misc-utils/hardlink.1.adoc:23 ../misc-utils/kill.1.adoc:25
430 #: ../misc-utils/logger.1.adoc:51 ../misc-utils/look.1.adoc:51
431 #: ../misc-utils/lsblk.8.adoc:17 ../misc-utils/lsfd.1.adoc:23
432 #: ../misc-utils/lslocks.8.adoc:28 ../misc-utils/mcookie.1.adoc:19
433 #: ../misc-utils/namei.1.adoc:17 ../misc-utils/pipesz.1.adoc:19
434 #: ../misc-utils/rename.1.adoc:19 ../misc-utils/uuidd.8.adoc:21
435 #: ../misc-utils/uuidgen.1.adoc:21 ../misc-utils/uuidparse.1.adoc:19
436 #: ../misc-utils/waitpid.1.adoc:17 ../misc-utils/whereis.1.adoc:51
437 #: ../misc-utils/wipefs.8.adoc:24 ../schedutils/chrt.1.adoc:44
438 #: ../schedutils/ionice.1.adoc:24 ../schedutils/taskset.1.adoc:43
439 #: ../schedutils/uclampset.1.adoc:45 ../sys-utils/adjtime_config.5.adoc:17
440 #: ../sys-utils/blkdiscard.8.adoc:17 ../sys-utils/blkzone.8.adoc:17
441 #: ../sys-utils/blkpr.8.adoc:17 ../sys-utils/chcpu.8.adoc:21
442 #: ../sys-utils/chmem.8.adoc:17 ../sys-utils/choom.1.adoc:19
443 #: ../sys-utils/ctrlaltdel.8.adoc:21 ../sys-utils/dmesg.1.adoc:31
444 #: ../sys-utils/eject.1.adoc:23 ../sys-utils/fallocate.1.adoc:21
445 #: ../sys-utils/flock.1.adoc:46 ../sys-utils/fsfreeze.8.adoc:17
446 #: ../sys-utils/fstab.5.adoc:51 ../sys-utils/fstrim.8.adoc:17
447 #: ../sys-utils/hwclock.8.adoc:25 ../sys-utils/ipcmk.1.adoc:21
448 #: ../sys-utils/ipcrm.1.adoc:24 ../sys-utils/ipcs.1.adoc:21
449 #: ../sys-utils/irqtop.1.adoc:17 ../sys-utils/ldattach.8.adoc:21
450 #: ../sys-utils/losetup.8.adoc:39 ../sys-utils/lscpu.1.adoc:17
451 #: ../sys-utils/lsipc.1.adoc:17 ../sys-utils/lsirq.1.adoc:17
452 #: ../sys-utils/lsmem.1.adoc:17 ../sys-utils/lsns.8.adoc:22
453 #: ../sys-utils/mount.8.adoc:60 ../sys-utils/mountpoint.1.adoc:19
454 #: ../sys-utils/nsenter.1.adoc:17 ../sys-utils/pivot_root.8.adoc:17
455 #: ../sys-utils/prlimit.1.adoc:25 ../sys-utils/readprofile.8.adoc:21
456 #: ../sys-utils/renice.1.adoc:51 ../sys-utils/rfkill.8.adoc:17
457 #: ../sys-utils/rtcwake.8.adoc:17 ../sys-utils/setarch.8.adoc:21
458 #: ../sys-utils/setpriv.1.adoc:17 ../sys-utils/setsid.1.adoc:19
459 #: ../sys-utils/swapon.8.adoc:19 ../sys-utils/switch_root.8.adoc:19
460 #: ../sys-utils/tunelp.8.adoc:17 ../sys-utils/umount.8.adoc:46
461 #: ../sys-utils/unshare.1.adoc:17 ../sys-utils/wdctl.8.adoc:17
462 #: ../sys-utils/zramctl.8.adoc:31 ../term-utils/agetty.8.adoc:17
463 #: ../term-utils/mesg.1.adoc:51 ../term-utils/script.1.adoc:52
464 #: ../term-utils/scriptlive.1.adoc:18 ../term-utils/scriptreplay.1.adoc:18
465 #: ../term-utils/setterm.1.adoc:24 ../term-utils/wall.1.adoc:52
466 #: ../term-utils/write.1.adoc:52 ../text-utils/col.1.adoc:54
467 #: ../text-utils/colcrt.1.adoc:52 ../text-utils/colrm.1.adoc:51
468 #: ../text-utils/column.1.adoc:51 ../text-utils/hexdump.1.adoc:53
469 #: ../text-utils/line.1.adoc:18 ../text-utils/more.1.adoc:54
470 #: ../text-utils/pg.1.adoc:18 ../text-utils/rev.1.adoc:51
471 #: ../text-utils/ul.1.adoc:51
477 #: ../disk-utils/addpart.8.adoc:26
479 msgid "*addpart* tells the Linux kernel about the existence of the specified partition. The command is a simple wrapper around the \"add partition\" ioctl.\n"
483 #: ../disk-utils/addpart.8.adoc:28 ../disk-utils/delpart.8.adoc:28
484 #: ../disk-utils/resizepart.8.adoc:28
485 msgid "This command doesn't manipulate partitions on a block device."
489 #: ../disk-utils/addpart.8.adoc:29 ../disk-utils/resizepart.8.adoc:29
490 #: ../misc-utils/cal.1.adoc:125
495 #. type: Labeled list
496 #: ../disk-utils/addpart.8.adoc:31 ../disk-utils/resizepart.8.adoc:31
502 #: ../disk-utils/addpart.8.adoc:33 ../disk-utils/resizepart.8.adoc:33
503 msgid "The disk device."
506 #. type: Labeled list
507 #: ../disk-utils/addpart.8.adoc:34 ../disk-utils/resizepart.8.adoc:34
513 #: ../disk-utils/addpart.8.adoc:36 ../disk-utils/resizepart.8.adoc:36
514 msgid "The partition number."
517 #. type: Labeled list
518 #: ../disk-utils/addpart.8.adoc:37
524 #: ../disk-utils/addpart.8.adoc:39
525 msgid "The beginning of the partition (in 512-byte sectors)."
528 #. type: Labeled list
529 #: ../disk-utils/addpart.8.adoc:40 ../disk-utils/resizepart.8.adoc:37
535 #: ../disk-utils/addpart.8.adoc:42
536 msgid "The length of the partition (in 512-byte sectors)."
540 #: ../disk-utils/addpart.8.adoc:45 ../disk-utils/cfdisk.8.adoc:145
541 #: ../disk-utils/delpart.8.adoc:33 ../disk-utils/fdformat.8.adoc:74
542 #: ../disk-utils/fdisk.8.adoc:220 ../disk-utils/fsck.8.adoc:159
543 #: ../disk-utils/fsck.cramfs.8.adoc:51 ../disk-utils/fsck.minix.8.adoc:98
544 #: ../disk-utils/mkfs.8.adoc:53 ../disk-utils/mkfs.bfs.8.adoc:57
545 #: ../disk-utils/mkfs.cramfs.8.adoc:82 ../disk-utils/mkfs.minix.8.adoc:86
546 #: ../disk-utils/mkswap.8.adoc:117 ../disk-utils/partx.8.adoc:135
547 #: ../disk-utils/resizepart.8.adoc:42 ../disk-utils/sfdisk.8.adoc:455
548 #: ../disk-utils/swaplabel.8.adoc:48 ../libblkid/libblkid.3.adoc:133
549 #: ../libuuid/man/uuid.3.adoc:63 ../libuuid/man/uuid_clear.3.adoc:59
550 #: ../libuuid/man/uuid_compare.3.adoc:63 ../libuuid/man/uuid_copy.3.adoc:63
551 #: ../libuuid/man/uuid_generate.3.adoc:84 ../libuuid/man/uuid_is_null.3.adoc:59
552 #: ../libuuid/man/uuid_parse.3.adoc:70 ../libuuid/man/uuid_time.3.adoc:63
553 #: ../libuuid/man/uuid_unparse.3.adoc:67 ../login-utils/chfn.1.adoc:80
554 #: ../login-utils/chsh.1.adoc:63 ../login-utils/last.1.adoc:129
555 #: ../login-utils/login.1.adoc:169 ../login-utils/lslogins.1.adoc:144
556 #: ../login-utils/newgrp.1.adoc:38 ../login-utils/nologin.8.adoc:67
557 #: ../login-utils/runuser.1.adoc:129 ../login-utils/su.1.adoc:145
558 #: ../login-utils/utmpdump.1.adoc:75 ../login-utils/vipw.8.adoc:72
559 #: ../misc-utils/blkid.8.adoc:179 ../misc-utils/cal.1.adoc:183
560 #: ../misc-utils/fadvise.1.adoc:57 ../misc-utils/fincore.1.adoc:56
561 #: ../misc-utils/findfs.8.adoc:67 ../misc-utils/findmnt.8.adoc:239
562 #: ../misc-utils/getopt.1.adoc:151 ../misc-utils/kill.1.adoc:109
563 #: ../misc-utils/logger.1.adoc:246 ../misc-utils/look.1.adoc:101
564 #: ../misc-utils/lsblk.8.adoc:178 ../misc-utils/lsfd.1.adoc:810
565 #: ../misc-utils/lslocks.8.adoc:119 ../misc-utils/mcookie.1.adoc:54
566 #: ../misc-utils/namei.1.adoc:75 ../misc-utils/pipesz.1.adoc:99
567 #: ../misc-utils/rename.1.adoc:106 ../misc-utils/uuidd.8.adoc:88
568 #: ../misc-utils/uuidgen.1.adoc:69 ../misc-utils/uuidparse.1.adoc:68
569 #: ../misc-utils/waitpid.1.adoc:57 ../misc-utils/wipefs.8.adoc:103
570 #: ../schedutils/chrt.1.adoc:148 ../schedutils/ionice.1.adoc:91
571 #: ../schedutils/taskset.1.adoc:145 ../schedutils/uclampset.1.adoc:130
572 #: ../sys-utils/adjtime_config.5.adoc:54 ../sys-utils/blkdiscard.8.adoc:75
573 #: ../sys-utils/blkzone.8.adoc:108 ../sys-utils/blkpr.8.adoc:52
574 #: ../sys-utils/chcpu.8.adoc:76 ../sys-utils/chmem.8.adoc:81
575 #: ../sys-utils/choom.1.adoc:51 ../sys-utils/ctrlaltdel.8.adoc:47
576 #: ../sys-utils/dmesg.1.adoc:191 ../sys-utils/eject.1.adoc:117
577 #: ../sys-utils/fallocate.1.adoc:86 ../sys-utils/flock.1.adoc:131
578 #: ../sys-utils/fsfreeze.8.adoc:53 ../sys-utils/fstab.5.adoc:139
579 #: ../sys-utils/fstrim.8.adoc:91 ../sys-utils/hwclock.8.adoc:378
580 #: ../sys-utils/ipcmk.1.adoc:49 ../sys-utils/ipcrm.1.adoc:68
581 #: ../sys-utils/ipcs.1.adoc:88 ../sys-utils/ldattach.8.adoc:118
582 #: ../sys-utils/lscpu.1.adoc:109 ../sys-utils/lsipc.1.adoc:106
583 #: ../sys-utils/lsmem.1.adoc:72 ../sys-utils/lsns.8.adoc:90
584 #: ../sys-utils/mount.8.adoc:1688 ../sys-utils/mountpoint.1.adoc:65
585 #: ../sys-utils/nsenter.1.adoc:158 ../sys-utils/pivot_root.8.adoc:63
586 #: ../sys-utils/prlimit.1.adoc:135 ../sys-utils/renice.1.adoc:102
587 #: ../sys-utils/rfkill.8.adoc:78 ../sys-utils/rtcwake.8.adoc:130
588 #: ../sys-utils/setarch.8.adoc:95 ../sys-utils/setpriv.1.adoc:114
589 #: ../sys-utils/setsid.1.adoc:44 ../sys-utils/swapon.8.adoc:167
590 #: ../sys-utils/switch_root.8.adoc:47 ../sys-utils/umount.8.adoc:173
591 #: ../sys-utils/unshare.1.adoc:261 ../sys-utils/zramctl.8.adoc:102
592 #: ../term-utils/mesg.1.adoc:96 ../term-utils/script.1.adoc:161
593 #: ../term-utils/scriptlive.1.adoc:75 ../term-utils/scriptreplay.1.adoc:95
594 #: ../term-utils/setterm.1.adoc:167 ../term-utils/wall.1.adoc:81
595 #: ../term-utils/write.1.adoc:80 ../text-utils/col.1.adoc:127
596 #: ../text-utils/colcrt.1.adoc:92 ../text-utils/colrm.1.adoc:67
597 #: ../text-utils/column.1.adoc:234 ../text-utils/line.1.adoc:22
598 #: ../text-utils/more.1.adoc:198 ../text-utils/pg.1.adoc:142
599 #: ../text-utils/rev.1.adoc:64 ../text-utils/ul.1.adoc:80
602 msgstr "DALŠÍ INFORMACE"
605 #: ../disk-utils/addpart.8.adoc:52
608 #| "*getmntent*(3),\n"
627 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
628 #. Copyright 2007 Karel Zak <kzak@redhat.com>
629 #. May be distributed under the GNU General Public License
631 #: ../disk-utils/blockdev.8.adoc:8
637 #: ../disk-utils/blockdev.8.adoc:18
638 msgid "blockdev - call block device ioctls from the command line"
642 #: ../disk-utils/blockdev.8.adoc:22
644 msgid "*blockdev* [*-q*] [*-v*] _command_ [_command_...] _device_ [_device_...]\n"
648 #: ../disk-utils/blockdev.8.adoc:24
650 msgid "*blockdev* *--report* [_device_...]\n"
654 #: ../disk-utils/blockdev.8.adoc:26
656 msgid "*blockdev* *-h*|*-V*\n"
660 #: ../disk-utils/blockdev.8.adoc:30
662 "The utility *blockdev* allows one to call block device ioctls from the "
667 #: ../disk-utils/blockdev.8.adoc:31 ../disk-utils/cfdisk.8.adoc:45
668 #: ../disk-utils/delpart.8.adoc:29 ../disk-utils/fdformat.8.adoc:50
669 #: ../disk-utils/fdisk.8.adoc:40 ../disk-utils/fsck.8.adoc:52
670 #: ../disk-utils/fsck.cramfs.8.adoc:21 ../disk-utils/fsck.minix.8.adoc:45
671 #: ../disk-utils/isosize.8.adoc:21 ../disk-utils/mkfs.8.adoc:27
672 #: ../disk-utils/mkfs.bfs.8.adoc:27 ../disk-utils/mkfs.cramfs.8.adoc:33
673 #: ../disk-utils/mkfs.minix.8.adoc:41 ../disk-utils/mkswap.8.adoc:39
674 #: ../disk-utils/partx.8.adoc:40 ../disk-utils/raw.8.adoc:37
675 #: ../disk-utils/sfdisk.8.adoc:139 ../disk-utils/swaplabel.8.adoc:29
676 #: ../login-utils/chfn.1.adoc:35 ../login-utils/chsh.1.adoc:31
677 #: ../login-utils/last.1.adoc:46 ../login-utils/login.1.adoc:39
678 #: ../login-utils/lslogins.1.adoc:27 ../login-utils/newgrp.1.adoc:25
679 #: ../login-utils/nologin.8.adoc:25 ../login-utils/runuser.1.adoc:33
680 #: ../login-utils/su.1.adoc:34 ../login-utils/sulogin.8.adoc:50
681 #: ../login-utils/utmpdump.1.adoc:38 ../login-utils/vipw.8.adoc:57
682 #: ../misc-utils/blkid.8.adoc:42 ../misc-utils/cal.1.adoc:67
683 #: ../misc-utils/fadvise.1.adoc:24 ../misc-utils/fincore.1.adoc:29
684 #: ../misc-utils/findmnt.8.adoc:34 ../misc-utils/getopt.1.adoc:32
685 #: ../misc-utils/hardlink.1.adoc:41 ../misc-utils/kill.1.adoc:53
686 #: ../misc-utils/logger.1.adoc:57 ../misc-utils/look.1.adoc:57
687 #: ../misc-utils/lsblk.8.adoc:33 ../misc-utils/lsfd.1.adoc:39
688 #: ../misc-utils/lslocks.8.adoc:32 ../misc-utils/mcookie.1.adoc:29
689 #: ../misc-utils/namei.1.adoc:39 ../misc-utils/pipesz.1.adoc:35
690 #: ../misc-utils/rename.1.adoc:23 ../misc-utils/uuidd.8.adoc:25
691 #: ../misc-utils/uuidgen.1.adoc:29 ../misc-utils/uuidparse.1.adoc:48
692 #: ../misc-utils/waitpid.1.adoc:24 ../misc-utils/whereis.1.adoc:71
693 #: ../misc-utils/wipefs.8.adoc:38 ../schedutils/chrt.1.adoc:90
694 #: ../schedutils/ionice.1.adoc:46 ../schedutils/taskset.1.adoc:69
695 #: ../schedutils/uclampset.1.adoc:67 ../sys-utils/blkdiscard.8.adoc:27
696 #: ../sys-utils/blkzone.8.adoc:82 ../sys-utils/blkpr.8.adoc:23
697 #: ../sys-utils/chcpu.8.adoc:27 ../sys-utils/chmem.8.adoc:35
698 #: ../sys-utils/choom.1.adoc:23 ../sys-utils/ctrlaltdel.8.adoc:35
699 #: ../sys-utils/dmesg.1.adoc:37 ../sys-utils/eject.1.adoc:35
700 #: ../sys-utils/fallocate.1.adoc:27 ../sys-utils/flock.1.adoc:54
701 #: ../sys-utils/fsfreeze.8.adoc:29 ../sys-utils/fstrim.8.adoc:27
702 #: ../sys-utils/hwclock.8.adoc:111 ../sys-utils/ipcmk.1.adoc:25
703 #: ../sys-utils/ipcrm.1.adoc:36 ../sys-utils/ipcs.1.adoc:25
704 #: ../sys-utils/irqtop.1.adoc:23 ../sys-utils/ldattach.8.adoc:74
705 #: ../sys-utils/losetup.8.adoc:49 ../sys-utils/lscpu.1.adoc:31
706 #: ../sys-utils/lsipc.1.adoc:21 ../sys-utils/lsirq.1.adoc:23
707 #: ../sys-utils/lsmem.1.adoc:31 ../sys-utils/lsns.8.adoc:32
708 #: ../sys-utils/mountpoint.1.adoc:23 ../sys-utils/nsenter.1.adoc:47
709 #: ../sys-utils/pivot_root.8.adoc:33 ../sys-utils/readprofile.8.adoc:25
710 #: ../sys-utils/renice.1.adoc:57 ../sys-utils/rfkill.8.adoc:25
711 #: ../sys-utils/rtcwake.8.adoc:31 ../sys-utils/setarch.8.adoc:29
712 #: ../sys-utils/setpriv.1.adoc:23 ../sys-utils/setsid.1.adoc:23
713 #: ../sys-utils/swapon.8.adoc:29 ../sys-utils/switch_root.8.adoc:25
714 #: ../sys-utils/tunelp.8.adoc:21 ../sys-utils/umount.8.adoc:52
715 #: ../sys-utils/unshare.1.adoc:53 ../sys-utils/wdctl.8.adoc:25
716 #: ../sys-utils/zramctl.8.adoc:39 ../term-utils/agetty.8.adoc:56
717 #: ../term-utils/mesg.1.adoc:69 ../term-utils/script.1.adoc:62
718 #: ../term-utils/scriptlive.1.adoc:28 ../term-utils/scriptreplay.1.adoc:30
719 #: ../term-utils/setterm.1.adoc:28 ../term-utils/wall.1.adoc:60
720 #: ../term-utils/write.1.adoc:72 ../text-utils/col.1.adoc:60
721 #: ../text-utils/colcrt.1.adoc:56 ../text-utils/colrm.1.adoc:59
722 #: ../text-utils/column.1.adoc:66 ../text-utils/hexdump.1.adoc:57
723 #: ../text-utils/more.1.adoc:58 ../text-utils/pg.1.adoc:26
724 #: ../text-utils/rev.1.adoc:57 ../text-utils/ul.1.adoc:55
729 #. type: Labeled list
730 #: ../disk-utils/blockdev.8.adoc:33
736 #: ../disk-utils/blockdev.8.adoc:35
740 #. type: Labeled list
741 #: ../disk-utils/blockdev.8.adoc:36 ../disk-utils/mkfs.cramfs.8.adoc:35
747 #: ../disk-utils/blockdev.8.adoc:38 ../disk-utils/fsck.minix.8.adoc:58
748 #: ../sys-utils/rtcwake.8.adoc:107 ../sys-utils/setarch.8.adoc:44
749 #: ../sys-utils/swapon.8.adoc:91
753 #. type: Labeled list
754 #: ../disk-utils/blockdev.8.adoc:39
760 #: ../disk-utils/blockdev.8.adoc:41
762 "Print a report for the specified device. It is possible to give multiple "
763 "devices. If none is given, all devices which appear in _/proc/partitions_ "
764 "are shown. Note that the partition StartSec is in 512-byte sectors."
768 #: ../disk-utils/blockdev.8.adoc:44 ../disk-utils/cfdisk.8.adoc:61
769 #: ../disk-utils/sfdisk.8.adoc:52 ../sys-utils/blkzone.8.adoc:23
770 #: ../sys-utils/rfkill.8.adoc:44 ../text-utils/more.1.adoc:100
771 #: ../text-utils/pg.1.adoc:64
777 #: ../disk-utils/blockdev.8.adoc:47
778 msgid "It is possible to give multiple devices and multiple commands."
781 #. type: Labeled list
782 #: ../disk-utils/blockdev.8.adoc:48
784 msgid "*--flushbufs*"
788 #: ../disk-utils/blockdev.8.adoc:50
789 msgid "Flush buffers."
792 #. type: Labeled list
793 #: ../disk-utils/blockdev.8.adoc:51
795 msgid "*--getalignoff*"
799 #: ../disk-utils/blockdev.8.adoc:53
800 msgid "Get alignment offset."
803 #. type: Labeled list
804 #: ../disk-utils/blockdev.8.adoc:54
810 #: ../disk-utils/blockdev.8.adoc:56
812 "Print the blocksize in bytes. This size does not describe device topology. "
813 "It's the size used internally by the kernel and it may be modified (for "
814 "example) by filesystem driver on mount."
817 #. type: Labeled list
818 #: ../disk-utils/blockdev.8.adoc:57
820 msgid "*--getdiscardzeroes*"
824 #: ../disk-utils/blockdev.8.adoc:59
825 msgid "Get discard zeroes support status."
828 #. type: Labeled list
829 #: ../disk-utils/blockdev.8.adoc:60
831 msgid "*--getdiskseq*"
835 #: ../disk-utils/blockdev.8.adoc:62
836 msgid "Get disk sequence number."
839 #. type: Labeled list
840 #: ../disk-utils/blockdev.8.adoc:63
842 #| msgid "*-P*, *--pty*"
843 msgid "*--getzonesz*"
844 msgstr "*-P*, *--pty*"
847 #: ../disk-utils/blockdev.8.adoc:65
848 msgid "Get zone size in 512-byte sectors."
851 #. type: Labeled list
852 #: ../disk-utils/blockdev.8.adoc:66
858 #: ../disk-utils/blockdev.8.adoc:68
859 msgid "Get filesystem readahead in 512-byte sectors."
862 #. type: Labeled list
863 #: ../disk-utils/blockdev.8.adoc:69
869 #: ../disk-utils/blockdev.8.adoc:71
870 msgid "Get minimum I/O size."
873 #. type: Labeled list
874 #: ../disk-utils/blockdev.8.adoc:72
880 #: ../disk-utils/blockdev.8.adoc:74
881 msgid "Get optimal I/O size."
884 #. type: Labeled list
885 #: ../disk-utils/blockdev.8.adoc:75
887 msgid "*--getmaxsect*"
891 #: ../disk-utils/blockdev.8.adoc:77
892 msgid "Get max sectors per request."
895 #. type: Labeled list
896 #: ../disk-utils/blockdev.8.adoc:78
902 #: ../disk-utils/blockdev.8.adoc:80
903 msgid "Get physical block (sector) size."
906 #. type: Labeled list
907 #: ../disk-utils/blockdev.8.adoc:81
913 #: ../disk-utils/blockdev.8.adoc:83
914 msgid "Print readahead (in 512-byte sectors)."
917 #. type: Labeled list
918 #: ../disk-utils/blockdev.8.adoc:84
924 #: ../disk-utils/blockdev.8.adoc:86
925 msgid "Get read-only. Print 1 if the device is read-only, 0 otherwise."
928 #. type: Labeled list
929 #: ../disk-utils/blockdev.8.adoc:87
931 msgid "*--getsize64*"
935 #: ../disk-utils/blockdev.8.adoc:89
937 #| msgid "Print version and exit."
938 msgid "Print device size in bytes."
939 msgstr "Zobrazí verzi a skončí."
941 #. type: Labeled list
942 #: ../disk-utils/blockdev.8.adoc:90
948 #: ../disk-utils/blockdev.8.adoc:92
950 "Print device size (32-bit!) in sectors. Deprecated in favor of the *--getsz* "
954 #. type: Labeled list
955 #: ../disk-utils/blockdev.8.adoc:93
961 #: ../disk-utils/blockdev.8.adoc:95
962 msgid "Print logical sector size in bytes - usually 512."
965 #. type: Labeled list
966 #: ../disk-utils/blockdev.8.adoc:96
972 #: ../disk-utils/blockdev.8.adoc:98
973 msgid "Get size in 512-byte sectors."
976 #. type: Labeled list
977 #: ../disk-utils/blockdev.8.adoc:99
983 #: ../disk-utils/blockdev.8.adoc:101
984 msgid "Reread partition table"
987 #. type: Labeled list
988 #: ../disk-utils/blockdev.8.adoc:102
990 msgid "*--setbsz* _bytes_"
994 #: ../disk-utils/blockdev.8.adoc:104
996 "Set blocksize. Note that the block size is specific to the current file "
997 "descriptor opening the block device, so the change of block size only "
998 "persists for as long as *blockdev* has the device open, and is lost once "
1002 #. type: Labeled list
1003 #: ../disk-utils/blockdev.8.adoc:105
1005 msgid "*--setfra* _sectors_"
1009 #: ../disk-utils/blockdev.8.adoc:107
1010 msgid "Set filesystem readahead (same as *--setra* on 2.6 kernels)."
1013 #. type: Labeled list
1014 #: ../disk-utils/blockdev.8.adoc:108
1016 msgid "*--setra* _sectors_"
1020 #: ../disk-utils/blockdev.8.adoc:110
1021 msgid "Set readahead (in 512-byte sectors)."
1024 #. type: Labeled list
1025 #: ../disk-utils/blockdev.8.adoc:111
1031 #: ../disk-utils/blockdev.8.adoc:113
1033 "Set read-only. The currently active access to the device may not be affected "
1034 "by the change. For example, a filesystem already mounted in read-write mode "
1035 "will not be affected. The change applies after remount."
1038 #. type: Labeled list
1039 #: ../disk-utils/blockdev.8.adoc:114
1045 #: ../disk-utils/blockdev.8.adoc:116
1046 msgid "Set read-write."
1050 #: ../disk-utils/blockdev.8.adoc:117 ../disk-utils/cfdisk.8.adoc:139
1051 #: ../disk-utils/fdformat.8.adoc:70 ../disk-utils/fdisk.8.adoc:213
1052 #: ../disk-utils/fsck.8.adoc:154 ../disk-utils/fsck.minix.8.adoc:94
1053 #: ../disk-utils/mkfs.8.adoc:45 ../disk-utils/partx.8.adoc:128
1054 #: ../disk-utils/raw.8.adoc:57 ../disk-utils/sfdisk.8.adoc:449
1055 #: ../disk-utils/swaplabel.8.adoc:44 ../libblkid/libblkid.3.adoc:123
1056 #: ../libuuid/man/uuid.3.adoc:59 ../libuuid/man/uuid_clear.3.adoc:55
1057 #: ../libuuid/man/uuid_compare.3.adoc:59 ../libuuid/man/uuid_copy.3.adoc:59
1058 #: ../libuuid/man/uuid_generate.3.adoc:80 ../libuuid/man/uuid_is_null.3.adoc:55
1059 #: ../libuuid/man/uuid_parse.3.adoc:66 ../libuuid/man/uuid_time.3.adoc:59
1060 #: ../libuuid/man/uuid_unparse.3.adoc:63 ../login-utils/chfn.1.adoc:76
1061 #: ../login-utils/chsh.1.adoc:59 ../login-utils/last.1.adoc:125
1062 #: ../login-utils/login.1.adoc:165 ../login-utils/lslogins.1.adoc:139
1063 #: ../login-utils/newgrp.1.adoc:34 ../login-utils/nologin.8.adoc:63
1064 #: ../login-utils/sulogin.8.adoc:70 ../login-utils/utmpdump.1.adoc:71
1065 #: ../misc-utils/blkid.8.adoc:175 ../misc-utils/fadvise.1.adoc:53
1066 #: ../misc-utils/fincore.1.adoc:52 ../misc-utils/findfs.8.adoc:63
1067 #: ../misc-utils/findmnt.8.adoc:235 ../misc-utils/kill.1.adoc:102
1068 #: ../misc-utils/logger.1.adoc:242 ../misc-utils/lsblk.8.adoc:173
1069 #: ../misc-utils/lsfd.1.adoc:805 ../misc-utils/lslocks.8.adoc:115
1070 #: ../misc-utils/namei.1.adoc:69 ../misc-utils/pipesz.1.adoc:95
1071 #: ../misc-utils/uuidgen.1.adoc:65 ../misc-utils/uuidparse.1.adoc:64
1072 #: ../misc-utils/waitpid.1.adoc:53 ../misc-utils/wipefs.8.adoc:99
1073 #: ../schedutils/chrt.1.adoc:143 ../schedutils/ionice.1.adoc:86
1074 #: ../schedutils/taskset.1.adoc:136 ../schedutils/uclampset.1.adoc:126
1075 #: ../sys-utils/blkdiscard.8.adoc:70 ../sys-utils/blkzone.8.adoc:103
1076 #: ../sys-utils/blkpr.8.adoc:48 ../sys-utils/chcpu.8.adoc:68
1077 #: ../sys-utils/choom.1.adoc:47 ../sys-utils/ctrlaltdel.8.adoc:43
1078 #: ../sys-utils/dmesg.1.adoc:185 ../sys-utils/eject.1.adoc:113
1079 #: ../sys-utils/fallocate.1.adoc:81 ../sys-utils/flock.1.adoc:122
1080 #: ../sys-utils/fsfreeze.8.adoc:49 ../sys-utils/fstrim.8.adoc:87
1081 #: ../sys-utils/hwclock.8.adoc:388 ../sys-utils/ipcmk.1.adoc:45
1082 #: ../sys-utils/ipcs.1.adoc:84 ../sys-utils/irqtop.1.adoc:62
1083 #: ../sys-utils/ldattach.8.adoc:114 ../sys-utils/losetup.8.adoc:157
1084 #: ../sys-utils/lscpu.1.adoc:103 ../sys-utils/lsipc.1.adoc:101
1085 #: ../sys-utils/lsirq.1.adoc:45 ../sys-utils/lsmem.1.adoc:68
1086 #: ../sys-utils/lsns.8.adoc:86 ../sys-utils/mount.8.adoc:1684
1087 #: ../sys-utils/mountpoint.1.adoc:61 ../sys-utils/nsenter.1.adoc:153
1088 #: ../sys-utils/prlimit.1.adoc:131 ../sys-utils/rfkill.8.adoc:72
1089 #: ../sys-utils/rtcwake.8.adoc:122 ../sys-utils/setarch.8.adoc:89
1090 #: ../sys-utils/setpriv.1.adoc:110 ../sys-utils/setsid.1.adoc:40
1091 #: ../sys-utils/switch_root.8.adoc:41 ../sys-utils/unshare.1.adoc:256
1092 #: ../sys-utils/wdctl.8.adoc:68 ../sys-utils/zramctl.8.adoc:97
1093 #: ../term-utils/agetty.8.adoc:342 ../term-utils/scriptlive.1.adoc:62
1094 #: ../term-utils/scriptreplay.1.adoc:79 ../text-utils/more.1.adoc:190
1100 #: ../disk-utils/blockdev.8.adoc:120
1102 msgid "*blockdev* was written by Andries E. Brouwer and rewritten by Karel Zak.\n"
1107 #. cfdisk.8 -- man page for cfdisk
1108 #. Copyright 1994 Kevin E. Martin (martin@cs.unc.edu)
1109 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
1110 #. Permission is granted to make and distribute verbatim copies of this
1111 #. manual provided the copyright notice and this permission notice are
1112 #. preserved on all copies.
1113 #. Permission is granted to copy and distribute modified versions of this
1114 #. manual under the conditions for verbatim copying, provided that the
1115 #. entire resulting derived work is distributed under the terms of a
1116 #. permission notice identical to this one.
1118 #: ../disk-utils/cfdisk.8.adoc:16
1124 #: ../disk-utils/cfdisk.8.adoc:26
1125 msgid "cfdisk - display or manipulate a disk partition table"
1129 #: ../disk-utils/cfdisk.8.adoc:30
1131 msgid "*cfdisk* [options] [_device_]\n"
1135 #: ../disk-utils/cfdisk.8.adoc:34
1137 msgid "*cfdisk* is a curses-based program for partitioning any block device. The default device is _/dev/sda_.\n"
1141 #: ../disk-utils/cfdisk.8.adoc:36
1143 "Note that *cfdisk* provides basic partitioning functionality with a user-"
1144 "friendly interface. If you need advanced features, use *fdisk*(8) instead."
1148 #: ../disk-utils/cfdisk.8.adoc:38
1150 "All disk label changes will remain in memory only, and the disk will be "
1151 "unmodified until you decide to write your changes. Be careful before using "
1152 "the write command."
1156 #: ../disk-utils/cfdisk.8.adoc:40
1158 "Since version 2.25 *cfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
1159 "labels, but no longer provides any functionality for CHS (Cylinder-Head-"
1160 "Sector) addressing. CHS has never been important for Linux, and this "
1161 "addressing concept does not make any sense for new devices."
1165 #: ../disk-utils/cfdisk.8.adoc:42
1167 "Since version 2.25 *cfdisk* also does not provide a 'print' command any "
1168 "more. This functionality is provided by the utilities *partx*(8) and "
1169 "*lsblk*(8) in a very comfortable and rich way."
1173 #: ../disk-utils/cfdisk.8.adoc:44
1175 "If you want to remove an old partition table from a device, use *wipefs*(8)."
1178 #. type: Labeled list
1179 #: ../disk-utils/cfdisk.8.adoc:49
1181 #| msgid "*-s*, **--shell**=__shell__"
1182 msgid "*-L*, *--color*[**=**__when__]"
1183 msgstr "*-s*, **--shell**=__shell__"
1186 #: ../disk-utils/cfdisk.8.adoc:51
1188 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
1189 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
1190 "colors can be disabled, for the current built-in default see *--help* "
1191 "output. See also the *COLORS* section."
1194 #. type: Labeled list
1195 #: ../disk-utils/cfdisk.8.adoc:52 ../disk-utils/fdisk.8.adoc:64
1196 #: ../disk-utils/mkfs.bfs.8.adoc:38 ../disk-utils/mkfs.minix.8.adoc:49
1197 #: ../disk-utils/mkswap.8.adoc:55 ../disk-utils/sfdisk.8.adoc:158
1198 #: ../misc-utils/wipefs.8.adoc:52
1200 msgid "*--lock*[=_mode_]"
1204 #: ../disk-utils/cfdisk.8.adoc:54 ../disk-utils/fdisk.8.adoc:66
1205 #: ../disk-utils/mkfs.bfs.8.adoc:40 ../disk-utils/mkfs.minix.8.adoc:51
1206 #: ../disk-utils/mkswap.8.adoc:57 ../disk-utils/sfdisk.8.adoc:160
1208 "Use exclusive BSD lock for device or file it operates. The optional argument "
1209 "_mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument "
1210 "is omitted, it defaults to *yes*. This option overwrites environment "
1211 "variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, "
1212 "but it's recommended to avoid collisions with *systemd-udevd*(8) or other "
1216 #. type: Labeled list
1217 #: ../disk-utils/cfdisk.8.adoc:55 ../sys-utils/losetup.8.adoc:92
1218 #: ../sys-utils/mount.8.adoc:408 ../sys-utils/umount.8.adoc:105
1220 #| msgid "*-h*, *--help*"
1221 msgid "*-r*, *--read-only*"
1222 msgstr "*-h*, *--help*"
1225 #: ../disk-utils/cfdisk.8.adoc:57
1226 msgid "Forced open in read-only mode."
1229 #. type: Labeled list
1230 #: ../disk-utils/cfdisk.8.adoc:58
1232 #| msgid "*-V*, *--version*"
1233 msgid "*-z*, *--zero*"
1234 msgstr "*-V*, *--version*"
1237 #: ../disk-utils/cfdisk.8.adoc:60
1239 "Start with an in-memory zeroed partition table. This option does not zero "
1240 "the partition table on the disk; rather, it simply starts the program "
1241 "without reading the existing partition table. This option allows you to "
1242 "create a new partition table from scratch or from an *sfdisk*(8)-compatible "
1247 #: ../disk-utils/cfdisk.8.adoc:64
1249 "The commands for *cfdisk* can be entered by pressing the corresponding key "
1250 "(pressing _Enter_ after the command is not necessary). Here is a list of the "
1251 "available commands:"
1254 #. type: Labeled list
1255 #: ../disk-utils/cfdisk.8.adoc:65
1261 #: ../disk-utils/cfdisk.8.adoc:67
1263 "Toggle the bootable flag of the current partition. This allows you to select "
1264 "which primary partition is bootable on the drive. This command may not be "
1265 "available for all partition label types."
1268 #. type: Labeled list
1269 #: ../disk-utils/cfdisk.8.adoc:68 ../sys-utils/irqtop.1.adoc:53
1275 #: ../disk-utils/cfdisk.8.adoc:70
1277 "Delete the current partition. This will convert the current partition into "
1278 "free space and merge it with any free space immediately surrounding the "
1279 "current partition. A partition already marked as free space or marked as "
1280 "unusable cannot be deleted."
1283 #. type: Labeled list
1284 #: ../disk-utils/cfdisk.8.adoc:71 ../text-utils/pg.1.adoc:106
1290 #: ../disk-utils/cfdisk.8.adoc:73
1291 msgid "Show the help screen."
1294 #. type: Labeled list
1295 #: ../disk-utils/cfdisk.8.adoc:74 ../sys-utils/irqtop.1.adoc:56
1296 #: ../term-utils/mesg.1.adoc:61 ../text-utils/more.1.adoc:140
1303 #: ../disk-utils/cfdisk.8.adoc:76
1305 "Create a new partition from free space. *cfdisk* then prompts you for the "
1306 "size of the partition you want to create. The default size is equal to the "
1307 "entire available free space at the current position."
1311 #: ../disk-utils/cfdisk.8.adoc:78
1313 "The size may be followed by a multiplicative suffix: KiB (=1024), MiB "
1314 "(=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the \"iB\" is "
1315 "optional, e.g., \"K\" has the same meaning as \"KiB\")."
1318 #. type: Labeled list
1319 #: ../disk-utils/cfdisk.8.adoc:79
1325 #: ../disk-utils/cfdisk.8.adoc:81
1327 "Quit the program. This will exit the program without writing any data to the "
1331 #. type: Labeled list
1332 #: ../disk-utils/cfdisk.8.adoc:82
1339 #: ../disk-utils/cfdisk.8.adoc:84
1341 "Reduce or enlarge the current partition. *cfdisk* then prompts you for the "
1342 "new size of the partition. The default size is the current size. A partition "
1343 "marked as free space or marked as unusable cannot be resized."
1347 #: ../disk-utils/cfdisk.8.adoc:86
1349 msgid "*Note that reducing the size of a partition might destroy data on that partition.*\n"
1352 #. type: Labeled list
1353 #: ../disk-utils/cfdisk.8.adoc:87 ../text-utils/more.1.adoc:122
1360 #: ../disk-utils/cfdisk.8.adoc:89
1362 "Sort the partitions in ascending start-sector order. When deleting and "
1363 "adding partitions, it is likely that the numbering of the partitions will no "
1364 "longer match their order on the disk. This command restores that match."
1367 #. type: Labeled list
1368 #: ../disk-utils/cfdisk.8.adoc:90 ../sys-utils/irqtop.1.adoc:50
1374 #: ../disk-utils/cfdisk.8.adoc:92
1376 "Change the partition type. By default, new partitions are created as _Linux_ "
1380 #. type: Labeled list
1381 #: ../disk-utils/cfdisk.8.adoc:93
1388 #: ../disk-utils/cfdisk.8.adoc:95
1390 "Dump the current in-memory partition table to an **sfdisk**(8)-compatible "
1395 #: ../disk-utils/cfdisk.8.adoc:97
1397 "The script files are compatible between *cfdisk*, *fdisk*(8) *sfdisk*(8) and "
1398 "other libfdisk applications. For more details see *sfdisk*(8)."
1402 #: ../disk-utils/cfdisk.8.adoc:99
1404 "It is also possible to load an sfdisk-script into *cfdisk* if there is no "
1405 "partition table on the device or when you start *cfdisk* with the *--zero* "
1406 "command-line option."
1409 #. type: Labeled list
1410 #: ../disk-utils/cfdisk.8.adoc:100
1416 #: ../disk-utils/cfdisk.8.adoc:102
1418 "Write the partition table to disk (you must enter an uppercase W). Since "
1419 "this might destroy data on the disk, you must either confirm or deny the "
1420 "write by entering `yes' or `no'. If you enter `yes', *cfdisk* will write the "
1421 "partition table to disk and then tell the kernel to re-read the partition "
1422 "table from the disk."
1426 #: ../disk-utils/cfdisk.8.adoc:104
1428 "The re-reading of the partition table does not always work. In such a case "
1429 "you need to inform the kernel about any new partitions by using "
1430 "*partprobe*(8) or *partx*(8), or by rebooting the system."
1433 #. type: Labeled list
1434 #: ../disk-utils/cfdisk.8.adoc:105
1440 #: ../disk-utils/cfdisk.8.adoc:107
1441 msgid "Toggle extra information about a partition."
1444 #. type: Labeled list
1445 #: ../disk-utils/cfdisk.8.adoc:108
1447 msgid "_Up Arrow_, _Down Arrow_"
1451 #: ../disk-utils/cfdisk.8.adoc:110
1453 "Move the cursor to the previous or next partition. If there are more "
1454 "partitions than can be displayed on a screen, you can display the next "
1455 "(previous) set of partitions by moving down (up) at the last (first) "
1456 "partition displayed on the screen."
1459 #. type: Labeled list
1460 #: ../disk-utils/cfdisk.8.adoc:111
1462 msgid "_Left Arrow_, _Right Arrow_"
1466 #: ../disk-utils/cfdisk.8.adoc:113
1468 "Select the preceding or the next menu item. Hitting _Enter_ will execute the "
1469 "currently selected item."
1473 #: ../disk-utils/cfdisk.8.adoc:115
1475 "All commands can be entered with either uppercase or lowercase letters "
1476 "(except for **W**rite). When in a submenu or at a prompt, you can hit the "
1477 "_Esc_ key to return to the main menu."
1481 #: ../disk-utils/cfdisk.8.adoc:118
1483 msgid "*cfdisk* does not support color customization with a color-scheme file.\n"
1487 #: ../disk-utils/cfdisk.8.adoc:119 ../disk-utils/fdisk.8.adoc:193
1488 #: ../disk-utils/fsck.8.adoc:128 ../disk-utils/mkfs.minix.8.adoc:70
1489 #: ../disk-utils/mkswap.8.adoc:87 ../disk-utils/partx.8.adoc:101
1490 #: ../disk-utils/sfdisk.8.adoc:407 ../disk-utils/swaplabel.8.adoc:39
1491 #: ../lib/terminal-colors.d.5.adoc:129 ../login-utils/sulogin.8.adoc:66
1492 #: ../login-utils/vipw.8.adoc:61 ../misc-utils/blkid.8.adoc:171
1493 #: ../misc-utils/findfs.8.adoc:58 ../misc-utils/findmnt.8.adoc:192
1494 #: ../misc-utils/getopt.1.adoc:133 ../misc-utils/look.1.adoc:77
1495 #: ../misc-utils/lsblk.8.adoc:150 ../misc-utils/whereis.1.adoc:112
1496 #: ../misc-utils/wipefs.8.adoc:80 ../sys-utils/hwclock.8.adoc:357
1497 #: ../sys-utils/losetup.8.adoc:131 ../sys-utils/mount.8.adoc:1627
1498 #: ../sys-utils/mountpoint.1.adoc:52 ../sys-utils/swapon.8.adoc:123
1499 #: ../sys-utils/umount.8.adoc:150 ../term-utils/script.1.adoc:127
1500 #: ../text-utils/column.1.adoc:177 ../text-utils/more.1.adoc:164
1501 #: ../text-utils/pg.1.adoc:117 ../text-utils/ul.1.adoc:65
1506 #. type: Labeled list
1507 #: ../disk-utils/cfdisk.8.adoc:121
1509 msgid "*CFDISK_DEBUG*=all"
1513 #: ../disk-utils/cfdisk.8.adoc:123
1514 msgid "enables cfdisk debug output."
1517 #. type: Labeled list
1518 #: ../disk-utils/cfdisk.8.adoc:124 ../disk-utils/fdisk.8.adoc:198
1519 #: ../disk-utils/sfdisk.8.adoc:411
1521 msgid "*LIBFDISK_DEBUG*=all"
1525 #: ../disk-utils/cfdisk.8.adoc:126 ../disk-utils/fdisk.8.adoc:200
1526 #: ../disk-utils/sfdisk.8.adoc:413
1527 msgid "enables libfdisk debug output."
1530 #. type: Labeled list
1531 #: ../disk-utils/cfdisk.8.adoc:127 ../disk-utils/fdisk.8.adoc:201
1532 #: ../disk-utils/sfdisk.8.adoc:413 ../misc-utils/lsblk.8.adoc:155
1533 #: ../sys-utils/mount.8.adoc:1638 ../sys-utils/swapon.8.adoc:128
1535 msgid "*LIBBLKID_DEBUG*=all"
1539 #: ../disk-utils/cfdisk.8.adoc:129 ../disk-utils/fdisk.8.adoc:203
1540 #: ../disk-utils/fsck.8.adoc:146 ../disk-utils/mkswap.8.adoc:91
1541 #: ../disk-utils/partx.8.adoc:105 ../disk-utils/sfdisk.8.adoc:415
1542 #: ../disk-utils/swaplabel.8.adoc:43 ../misc-utils/findfs.8.adoc:62
1543 msgid "enables libblkid debug output."
1546 #. type: Labeled list
1547 #: ../disk-utils/cfdisk.8.adoc:130 ../disk-utils/fdisk.8.adoc:204
1548 #: ../disk-utils/sfdisk.8.adoc:415 ../misc-utils/findmnt.8.adoc:203
1549 #: ../misc-utils/lsblk.8.adoc:161
1551 msgid "*LIBSMARTCOLS_DEBUG*=all"
1555 #: ../disk-utils/cfdisk.8.adoc:132 ../disk-utils/fdisk.8.adoc:206
1556 #: ../disk-utils/sfdisk.8.adoc:417
1557 msgid "enables libsmartcols debug output."
1560 #. type: Labeled list
1561 #: ../disk-utils/cfdisk.8.adoc:133 ../disk-utils/fdisk.8.adoc:207
1562 #: ../misc-utils/findmnt.8.adoc:206 ../misc-utils/lsblk.8.adoc:164
1564 msgid "*LIBSMARTCOLS_DEBUG_PADDING*=on"
1568 #: ../disk-utils/cfdisk.8.adoc:135
1569 msgid "use visible padding characters. Requires enabled *LIBSMARTCOLS_DEBUG*."
1572 #. type: Labeled list
1573 #: ../disk-utils/cfdisk.8.adoc:136 ../disk-utils/fdisk.8.adoc:210
1574 #: ../disk-utils/sfdisk.8.adoc:417
1576 msgid "*LOCK_BLOCK_DEVICE*=<mode>"
1580 #: ../disk-utils/cfdisk.8.adoc:138 ../disk-utils/fdisk.8.adoc:212
1581 #: ../disk-utils/mkfs.minix.8.adoc:74 ../disk-utils/mkswap.8.adoc:94
1582 #: ../disk-utils/sfdisk.8.adoc:419 ../misc-utils/wipefs.8.adoc:87
1584 "use exclusive BSD lock. The mode is \"1\" or \"0\". See *--lock* for more "
1589 #: ../disk-utils/cfdisk.8.adoc:142 ../disk-utils/sfdisk.8.adoc:452
1590 #: ../login-utils/nologin.8.adoc:66 ../misc-utils/findmnt.8.adoc:238
1591 #: ../misc-utils/wipefs.8.adoc:102 ../sys-utils/choom.1.adoc:50
1592 #: ../sys-utils/dmesg.1.adoc:188 ../sys-utils/lsns.8.adoc:89
1593 #: ../sys-utils/mount.8.adoc:1687 ../sys-utils/mountpoint.1.adoc:64
1594 #: ../term-utils/scriptlive.1.adoc:65
1595 msgid "mailto:kzak@redhat.com[Karel Zak]"
1599 #: ../disk-utils/cfdisk.8.adoc:144
1601 "The current *cfdisk* implementation is based on the original *cfdisk* from "
1602 "mailto:martin@cs.unc.edu[Kevin E. Martin]."
1606 #: ../disk-utils/cfdisk.8.adoc:152
1616 #. delpart.8 -- man page for delpart
1617 #. Copyright 2007 Karel Zak <kzak@redhat.com>
1618 #. Copyright 2007 Red Hat, Inc.
1619 #. May be distributed under the GNU General Public License
1621 #: ../disk-utils/delpart.8.adoc:8
1627 #: ../disk-utils/delpart.8.adoc:18
1628 msgid "delpart - tell the kernel to forget about a partition"
1632 #: ../disk-utils/delpart.8.adoc:22
1634 msgid "*delpart* _device partition_\n"
1638 #: ../disk-utils/delpart.8.adoc:26
1640 msgid "*delpart* asks the Linux kernel to forget about the specified _partition_ (a number) on the specified _device_. The command is a simple wrapper around the \"del partition\" ioctl.\n"
1644 #: ../disk-utils/delpart.8.adoc:40
1654 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1655 #. May be distributed under the GNU General Public License
1657 #: ../disk-utils/fdformat.8.adoc:6
1663 #: ../disk-utils/fdformat.8.adoc:16
1664 msgid "fdformat - low-level format a floppy disk"
1668 #: ../disk-utils/fdformat.8.adoc:20
1670 msgid "*fdformat* [options] _device_\n"
1674 #: ../disk-utils/fdformat.8.adoc:24
1676 msgid "*fdformat* does a low-level format on a floppy disk. _device_ is usually one of the following (for floppy devices the major = 2, and the minor is shown for informational purposes only):\n"
1679 #. type: delimited block .
1680 #: ../disk-utils/fdformat.8.adoc:35
1683 "/dev/fd0d360 (minor = 4)\n"
1684 "/dev/fd0h1200 (minor = 8)\n"
1685 "/dev/fd0D360 (minor = 12)\n"
1686 "/dev/fd0H360 (minor = 12)\n"
1687 "/dev/fd0D720 (minor = 16)\n"
1688 "/dev/fd0H720 (minor = 16)\n"
1689 "/dev/fd0h360 (minor = 20)\n"
1690 "/dev/fd0h720 (minor = 24)\n"
1691 "/dev/fd0H1440 (minor = 28)\n"
1694 #. type: delimited block .
1695 #: ../disk-utils/fdformat.8.adoc:46
1698 "/dev/fd1d360 (minor = 5)\n"
1699 "/dev/fd1h1200 (minor = 9)\n"
1700 "/dev/fd1D360 (minor = 13)\n"
1701 "/dev/fd1H360 (minor = 13)\n"
1702 "/dev/fd1D720 (minor = 17)\n"
1703 "/dev/fd1H720 (minor = 17)\n"
1704 "/dev/fd1h360 (minor = 21)\n"
1705 "/dev/fd1h720 (minor = 25)\n"
1706 "/dev/fd1H1440 (minor = 29)\n"
1710 #: ../disk-utils/fdformat.8.adoc:49
1712 "The generic floppy devices, _/dev/fd0_ and _/dev/fd1_, will fail to work "
1713 "with *fdformat* when a non-standard format is being used, or if the format "
1714 "has not been autodetected earlier. In this case, use *setfdprm*(8) to load "
1715 "the disk parameters."
1718 #. type: Labeled list
1719 #: ../disk-utils/fdformat.8.adoc:52
1721 #| msgid "*-f*, *--fast*"
1722 msgid "*-f*, *--from* _N_"
1723 msgstr "*-f*, *--fast*"
1726 #: ../disk-utils/fdformat.8.adoc:54
1727 msgid "Start at the track _N_ (default is 0)."
1730 #. type: Labeled list
1731 #: ../disk-utils/fdformat.8.adoc:55
1733 #| msgid "*-P*, *--pty*"
1734 msgid "*-t*, *--to* _N_"
1735 msgstr "*-P*, *--pty*"
1738 #: ../disk-utils/fdformat.8.adoc:57
1739 msgid "Stop at the track _N_."
1742 #. type: Labeled list
1743 #: ../disk-utils/fdformat.8.adoc:58
1745 #| msgid "*-h*, *--help*"
1746 msgid "*-r*, *--repair* _N_"
1747 msgstr "*-h*, *--help*"
1750 #: ../disk-utils/fdformat.8.adoc:60
1751 msgid "Try to repair tracks failed during the verification (max _N_ retries)."
1754 #. type: Labeled list
1755 #: ../disk-utils/fdformat.8.adoc:61
1757 #| msgid "*-V*, *--version*"
1758 msgid "*-n*, *--no-verify*"
1759 msgstr "*-V*, *--version*"
1762 #: ../disk-utils/fdformat.8.adoc:63
1763 msgid "Skip the verification that is normally performed after the formatting."
1767 #: ../disk-utils/fdformat.8.adoc:66 ../disk-utils/mkswap.8.adoc:95
1768 #: ../disk-utils/raw.8.adoc:47 ../disk-utils/sfdisk.8.adoc:420
1769 #: ../login-utils/last.1.adoc:117 ../login-utils/lslogins.1.adoc:118
1770 #: ../login-utils/nologin.8.adoc:53 ../login-utils/su.1.adoc:133
1771 #: ../login-utils/utmpdump.1.adoc:51 ../misc-utils/cal.1.adoc:144
1772 #: ../misc-utils/kill.1.adoc:96 ../misc-utils/lsblk.8.adoc:167
1773 #: ../misc-utils/lslocks.8.adoc:104 ../misc-utils/pipesz.1.adoc:83
1774 #: ../schedutils/chrt.1.adoc:137 ../schedutils/ionice.1.adoc:68
1775 #: ../schedutils/uclampset.1.adoc:114 ../sys-utils/choom.1.adoc:33
1776 #: ../sys-utils/eject.1.adoc:97 ../sys-utils/flock.1.adoc:94
1777 #: ../sys-utils/fsfreeze.8.adoc:45 ../sys-utils/fstab.5.adoc:129
1778 #: ../sys-utils/hwclock.8.adoc:176 ../sys-utils/ipcrm.1.adoc:63
1779 #: ../sys-utils/ipcs.1.adoc:80 ../sys-utils/losetup.8.adoc:127
1780 #: ../sys-utils/mountpoint.1.adoc:57 ../sys-utils/nsenter.1.adoc:149
1781 #: ../sys-utils/prlimit.1.adoc:110 ../sys-utils/renice.1.adoc:84
1782 #: ../sys-utils/rtcwake.8.adoc:110 ../sys-utils/setpriv.1.adoc:94
1783 #: ../sys-utils/swapon.8.adoc:139 ../sys-utils/switch_root.8.adoc:33
1784 #: ../sys-utils/tunelp.8.adoc:64 ../sys-utils/unshare.1.adoc:146
1785 #: ../term-utils/script.1.adoc:134 ../term-utils/wall.1.adoc:73
1786 #: ../text-utils/col.1.adoc:90 ../text-utils/pg.1.adoc:136
1792 #: ../disk-utils/fdformat.8.adoc:69
1794 "This utility does not handle USB floppy disk drives. Use *ufiformat*(8) "
1799 #: ../disk-utils/fdformat.8.adoc:73
1800 msgid "mailto:almesber@nessie.cs.id.ethz.ch[Werner Almesberger]"
1804 #: ../disk-utils/fdformat.8.adoc:81
1814 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1815 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
1816 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
1817 #. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
1818 #. May be distributed under the GNU General Public License
1820 #: ../disk-utils/fdisk.8.adoc:9
1826 #: ../disk-utils/fdisk.8.adoc:20
1827 msgid "fdisk - manipulate disk partition table"
1831 #: ../disk-utils/fdisk.8.adoc:24
1833 msgid "*fdisk* [options] _device_\n"
1837 #: ../disk-utils/fdisk.8.adoc:26
1839 msgid "*fdisk* *-l* [_device_...]\n"
1843 #: ../disk-utils/fdisk.8.adoc:30
1845 msgid "*fdisk* is a dialog-driven program for creation and manipulation of partition tables. It understands GPT, MBR, Sun, SGI and BSD partition tables.\n"
1849 #: ../disk-utils/fdisk.8.adoc:32
1851 "Block devices can be divided into one or more logical disks called "
1852 "_partitions_. This division is recorded in the _partition table_, usually "
1853 "found in sector 0 of the disk. (In the BSD world one talks about `disk "
1854 "slices' and a `disklabel'.)"
1857 #. TRANSLATORS: Keep {plus} untranslated.
1859 #: ../disk-utils/fdisk.8.adoc:35
1861 "All partitioning is driven by device I/O limits (the topology) by default. "
1862 "*fdisk* is able to optimize the disk layout for a 4K-sector size and use an "
1863 "alignment offset on modern devices for MBR and GPT. It is always a good idea "
1864 "to follow *fdisk*'s defaults as the default values (e.g., first and last "
1865 "partition sectors) and partition sizes specified by the {plus}/-<size>{M,"
1866 "G,...} notation are always aligned according to the device properties."
1870 #: ../disk-utils/fdisk.8.adoc:37
1872 "CHS (Cylinder-Head-Sector) addressing is deprecated and not used by default. "
1873 "Please, do not follow old articles and recommendations with *fdisk -S <n> -H "
1874 "<n>* advices for SSD or 4K-sector devices."
1878 #: ../disk-utils/fdisk.8.adoc:39
1880 "Note that *partx*(8) provides a rich interface for scripts to print disk "
1881 "layouts, *fdisk* is mostly designed for humans. Backward compatibility in "
1882 "the output of *fdisk* is not guaranteed. The input (the commands) should "
1883 "always be backward compatible."
1886 #. type: Labeled list
1887 #: ../disk-utils/fdisk.8.adoc:42
1889 msgid "*-b*, *--sector-size* _sectorsize_"
1893 #: ../disk-utils/fdisk.8.adoc:44
1895 "Specify the sector size of the disk. Valid values are 512, 1024, 2048, and "
1896 "4096. (Recent kernels know the sector size. Use this option only on old "
1897 "kernels or to override the kernel's ideas.) Since util-linux-2.17, *fdisk* "
1898 "differentiates between logical and physical sector size. This option changes "
1899 "both sector sizes to _sectorsize_."
1902 #. type: Labeled list
1903 #: ../disk-utils/fdisk.8.adoc:45
1905 #| msgid "*-P*, *--pty*"
1906 msgid "*-B*, *--protect-boot*"
1907 msgstr "*-P*, *--pty*"
1910 #: ../disk-utils/fdisk.8.adoc:47
1912 "Don't erase the beginning of the first disk sector when creating a new disk "
1913 "label. This feature is supported for GPT and MBR."
1916 #. type: Labeled list
1917 #: ../disk-utils/fdisk.8.adoc:48
1919 #| msgid "*-c*, **--command**=__command__"
1920 msgid "*-c*, *--compatibility*[=_mode_]"
1921 msgstr "*-c*, **--command**=__příkaz__"
1924 #: ../disk-utils/fdisk.8.adoc:50
1926 "Specify the compatibility mode, 'dos' or 'nondos'. The default is non-DOS "
1927 "mode. For backward compatibility, it is possible to use the option without "
1928 "the _mode_ argument -- then the default is used. Note that the optional "
1929 "_mode_ argument cannot be separated from the *-c* option by a space, the "
1930 "correct form is for example *-c*=_dos_."
1933 #. type: Labeled list
1934 #: ../disk-utils/fdisk.8.adoc:53 ../sys-utils/dmesg.1.adoc:78
1935 #: ../text-utils/hexdump.1.adoc:83
1937 msgid "*-L*, *--color*[=_when_]"
1941 #: ../disk-utils/fdisk.8.adoc:55 ../disk-utils/sfdisk.8.adoc:151
1942 #: ../misc-utils/cal.1.adoc:119
1944 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
1945 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
1946 "colors can be disabled; for the current built-in default see the *--help* "
1947 "output. See also the *COLORS* section."
1950 #. type: Labeled list
1951 #: ../disk-utils/fdisk.8.adoc:56 ../disk-utils/fsck.minix.8.adoc:47
1952 #: ../disk-utils/partx.8.adoc:54 ../misc-utils/findmnt.8.adoc:78
1953 #: ../misc-utils/lsblk.8.adoc:70 ../sys-utils/losetup.8.adoc:101
1954 #: ../sys-utils/lsipc.1.adoc:53 ../sys-utils/lsns.8.adoc:37
1956 #| msgid "*-f*, *--fast*"
1957 msgid "*-l*, *--list*"
1958 msgstr "*-f*, *--fast*"
1961 #: ../disk-utils/fdisk.8.adoc:58
1962 msgid "List the partition tables for the specified devices and then exit."
1966 #: ../disk-utils/fdisk.8.adoc:60
1968 "If no devices are given, the devices mentioned in _/proc/partitions_ (if "
1969 "this file exists) are used. Devices are always listed in the order in which "
1970 "they are specified on the command-line, or by the kernel listed in _/proc/"
1974 #. type: Labeled list
1975 #: ../disk-utils/fdisk.8.adoc:61
1977 #| msgid "*-h*, *--help*"
1978 msgid "*-x*, *--list-details*"
1979 msgstr "*-h*, *--help*"
1982 #: ../disk-utils/fdisk.8.adoc:63
1983 msgid "Like *--list*, but provides more details."
1986 #. type: Labeled list
1987 #: ../disk-utils/fdisk.8.adoc:67
1989 #| msgid "*-P*, *--pty*"
1990 msgid "*-n*, *--noauto-pt*"
1991 msgstr "*-P*, *--pty*"
1994 #: ../disk-utils/fdisk.8.adoc:69
1996 "Don't automatically create a default partition table on empty device. The "
1997 "partition table has to be explicitly created by user (by command like 'o', "
2001 #. type: Labeled list
2002 #: ../disk-utils/fdisk.8.adoc:70 ../disk-utils/partx.8.adoc:69
2003 #: ../disk-utils/sfdisk.8.adoc:195 ../login-utils/lslogins.1.adoc:69
2004 #: ../misc-utils/fincore.1.adoc:37 ../misc-utils/findmnt.8.adoc:97
2005 #: ../misc-utils/lsblk.8.adoc:88 ../misc-utils/lsfd.1.adoc:50
2006 #: ../misc-utils/lslocks.8.adoc:46 ../sys-utils/irqtop.1.adoc:25
2007 #: ../sys-utils/lsipc.1.adoc:65 ../sys-utils/lsirq.1.adoc:28
2008 #: ../sys-utils/lsmem.1.adoc:45 ../sys-utils/lsns.8.adoc:43
2009 #: ../sys-utils/prlimit.1.adoc:46 ../sys-utils/wdctl.8.adoc:39
2010 #: ../sys-utils/zramctl.8.adoc:52
2012 #| msgid "*-P*, *--pty*"
2013 msgid "*-o*, *--output* _list_"
2014 msgstr "*-P*, *--pty*"
2017 #: ../disk-utils/fdisk.8.adoc:72 ../disk-utils/sfdisk.8.adoc:197
2018 #: ../misc-utils/lslocks.8.adoc:48 ../misc-utils/uuidparse.1.adoc:58
2019 #: ../misc-utils/wipefs.8.adoc:60 ../sys-utils/lsipc.1.adoc:67
2020 #: ../sys-utils/lsns.8.adoc:45
2022 "Specify which output columns to print. Use *--help* to get a list of all "
2023 "supported columns."
2026 #. TRANSLATORS: Keep {plus} untranslated.
2028 #: ../disk-utils/fdisk.8.adoc:74
2030 "The default list of columns may be extended if _list_ is specified in the "
2031 "format _{plus}list_ (e.g., *-o {plus}UUID*)."
2034 #. type: Labeled list
2035 #: ../disk-utils/fdisk.8.adoc:76
2037 #| msgid "*-P*, *--pty*"
2038 msgid "*-s*, *--getsz*"
2039 msgstr "*-P*, *--pty*"
2042 #: ../disk-utils/fdisk.8.adoc:78
2044 "Print the size in 512-byte sectors of each given block device. This option "
2045 "is DEPRECATED in favour of *blockdev*(8)."
2048 #. type: Labeled list
2049 #: ../disk-utils/fdisk.8.adoc:79 ../disk-utils/mkfs.8.adoc:29
2050 #: ../disk-utils/partx.8.adoc:84 ../sys-utils/blkpr.8.adoc:38
2051 #: ../sys-utils/lsns.8.adoc:61
2053 #| msgid "*-P*, *--pty*"
2054 msgid "*-t*, *--type* _type_"
2055 msgstr "*-P*, *--pty*"
2058 #: ../disk-utils/fdisk.8.adoc:81
2060 "Enable support only for disklabels of the specified _type_, and disable "
2061 "support for all other types."
2064 #. type: Labeled list
2065 #: ../disk-utils/fdisk.8.adoc:82
2067 msgid "*-u*, *--units*[=_unit_]"
2071 #: ../disk-utils/fdisk.8.adoc:84
2073 "When listing partition tables, show sizes in 'sectors' or in 'cylinders'. "
2074 "The default is to show sizes in sectors. For backward compatibility, it is "
2075 "possible to use the option without the _unit_ argument -- then the default "
2076 "is used. Note that the optional _unit_ argument cannot be separated from the "
2077 "*-u* option by a space, the correct form is for example '**-"
2078 "u=**__cylinders__'."
2081 #. type: Labeled list
2082 #: ../disk-utils/fdisk.8.adoc:85
2084 msgid "*-C*, *--cylinders* _number_"
2088 #: ../disk-utils/fdisk.8.adoc:87
2090 "Specify the _number_ of cylinders of the disk. I have no idea why anybody "
2091 "would want to do so."
2094 #. type: Labeled list
2095 #: ../disk-utils/fdisk.8.adoc:88
2097 msgid "*-H*, *--heads* _number_"
2101 #: ../disk-utils/fdisk.8.adoc:90
2103 "Specify the number of heads of the disk. (Not the physical number, of "
2104 "course, but the number used for partition tables.) Reasonable values are 255 "
2108 #. type: Labeled list
2109 #: ../disk-utils/fdisk.8.adoc:91
2111 msgid "*-S*, *--sectors* _number_"
2115 #: ../disk-utils/fdisk.8.adoc:93
2117 "Specify the number of sectors per track of the disk. (Not the physical "
2118 "number, of course, but the number used for partition tables.) A reasonable "
2122 #. type: Labeled list
2123 #: ../disk-utils/fdisk.8.adoc:94 ../disk-utils/sfdisk.8.adoc:213
2125 msgid "*-w*, *--wipe* _when_"
2129 #: ../disk-utils/fdisk.8.adoc:96
2131 "Wipe filesystem, RAID and partition-table signatures from the device, in "
2132 "order to avoid possible collisions. The argument _when_ can be *auto*, "
2133 "*never* or *always*. When this option is not given, the default is *auto*, "
2134 "in which case signatures are wiped only when in interactive mode. In all "
2135 "cases detected signatures are reported by warning messages before a new "
2136 "partition table is created. See also *wipefs*(8) command."
2139 #. type: Labeled list
2140 #: ../disk-utils/fdisk.8.adoc:97 ../disk-utils/sfdisk.8.adoc:216
2142 msgid "*-W*, *--wipe-partitions* _when_"
2146 #: ../disk-utils/fdisk.8.adoc:99
2148 "Wipe filesystem, RAID and partition-table signatures from a newly created "
2149 "partitions, in order to avoid possible collisions. The argument _when_ can "
2150 "be *auto*, *never* or *always*. When this option is not given, the default "
2151 "is *auto*, in which case signatures are wiped only when in interactive mode "
2152 "and after confirmation by user. In all cases detected signatures are "
2153 "reported by warning messages before a new partition is created. See also "
2154 "*wipefs*(8) command."
2158 #: ../disk-utils/fdisk.8.adoc:102 ../disk-utils/fsck.8.adoc:117
2159 #: ../disk-utils/sfdisk.8.adoc:221 ../sys-utils/blkpr.8.adoc:44
2160 #: ../sys-utils/setsid.1.adoc:36
2162 #| msgid "Display help text and exit."
2163 msgid "Display version information and exit."
2164 msgstr "Zobrazí text nápovědy a skončí."
2167 #: ../disk-utils/fdisk.8.adoc:103
2173 #: ../disk-utils/fdisk.8.adoc:106
2175 "The _device_ is usually _/dev/sda_, _/dev/sdb_ or so. A device name refers "
2176 "to the entire disk. Old systems without libata (a library used inside the "
2177 "Linux kernel to support ATA host controllers and devices) make a difference "
2178 "between IDE and SCSI disks. In such cases the device name will be _/dev/hd*_ "
2179 "(IDE) or _/dev/sd*_ (SCSI)."
2183 #: ../disk-utils/fdisk.8.adoc:108
2185 "The _partition_ is a device name followed by a partition number. For "
2186 "example, _/dev/sda1_ is the first partition on the first hard disk in the "
2187 "system. See also Linux kernel documentation (the _Documentation/admin-guide/"
2188 "devices.txt_ file)."
2192 #: ../disk-utils/fdisk.8.adoc:109
2197 #. TRANSLATORS: Keep {plus} untranslated.
2199 #: ../disk-utils/fdisk.8.adoc:114
2201 "The \"last sector\" dialog accepts partition size specified by number of "
2202 "sectors or by {plus}/-<size>{K,B,M,G,...} notation."
2205 #. TRANSLATORS: Keep {plus} untranslated.
2207 #: ../disk-utils/fdisk.8.adoc:118
2209 "If the size is prefixed by '{plus}' then it is interpreted as relative to "
2210 "the partition first sector. If the size is prefixed by '-' then it is "
2211 "interpreted as relative to the high limit (last available sector for the "
2216 #: ../disk-utils/fdisk.8.adoc:120
2218 "In the case the size is specified in bytes than the number may be followed "
2219 "by the multiplicative suffixes KiB=1024, MiB=1024*1024, and so on for GiB, "
2220 "TiB, PiB, EiB, ZiB and YiB. The \"iB\" is optional, e.g., \"K\" has the same "
2221 "meaning as \"KiB\"."
2224 #. TRANSLATORS: Keep {plus} untranslated.
2226 #: ../disk-utils/fdisk.8.adoc:124
2228 "The relative sizes are always aligned according to device I/O limits. The "
2229 "{plus}/-<size>{K,B,M,G,...} notation is recommended."
2233 #: ../disk-utils/fdisk.8.adoc:126
2235 "For backward compatibility *fdisk* also accepts the suffixes KB=1000, "
2236 "MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB. These 10^N suffixes "
2241 #: ../disk-utils/fdisk.8.adoc:127
2243 #| msgid "CONFIG FILES"
2244 msgid "SCRIPT FILES"
2245 msgstr "KONFIGURAČNÍ SOUBORY"
2248 #: ../disk-utils/fdisk.8.adoc:130
2250 msgid "*fdisk* allows reading (by 'I' command) *sfdisk*(8) compatible script files. The script is applied to in-memory partition table, and then it is possible to modify the partition table before you write it to the device.\n"
2254 #: ../disk-utils/fdisk.8.adoc:132
2256 "And vice-versa it is possible to write the current in-memory disk layout to "
2257 "the script file by command 'O'."
2261 #: ../disk-utils/fdisk.8.adoc:134
2263 "The script files are compatible between *cfdisk*(8), *sfdisk*(8), *fdisk* "
2264 "and other libfdisk applications. For more details see *sfdisk*(8)."
2268 #: ../disk-utils/fdisk.8.adoc:135
2273 #. type: Labeled list
2274 #: ../disk-utils/fdisk.8.adoc:137
2276 msgid "*GPT (GUID Partition Table)*"
2280 #: ../disk-utils/fdisk.8.adoc:139
2282 "GPT is modern standard for the layout of the partition table. GPT uses 64-"
2283 "bit logical block addresses, checksums, UUIDs and names for partitions and "
2284 "an unlimited number of partitions (although the number of partitions is "
2285 "usually restricted to 128 in many partitioning tools)."
2289 #: ../disk-utils/fdisk.8.adoc:141
2291 "Note that the first sector is still reserved for a *protective MBR* in the "
2292 "GPT specification. It prevents MBR-only partitioning tools from mis-"
2293 "recognizing and overwriting GPT disks."
2297 #: ../disk-utils/fdisk.8.adoc:143
2299 "GPT is always a better choice than MBR, especially on modern hardware with a "
2303 #. type: Labeled list
2304 #: ../disk-utils/fdisk.8.adoc:144
2306 msgid "*DOS-type (MBR)*"
2310 #: ../disk-utils/fdisk.8.adoc:146
2312 "A DOS-type partition table can describe an unlimited number of partitions. "
2313 "In sector 0 there is room for the description of 4 partitions (called "
2314 "`primary'). One of these may be an extended partition; this is a box holding "
2315 "logical partitions, with descriptors found in a linked list of sectors, each "
2316 "preceding the corresponding logical partitions. The four primary partitions, "
2317 "present or not, get numbers 1-4. Logical partitions are numbered starting "
2321 #. TRANSLATORS: Keep {plus} untranslated.
2323 #: ../disk-utils/fdisk.8.adoc:148
2325 "In a DOS-type partition table the starting offset and the size of each "
2326 "partition is stored in two ways: as an absolute number of sectors (given in "
2327 "32 bits), and as a *Cylinders/Heads/Sectors* triple (given in 10{plus}8{plus}"
2328 "6 bits). The former is OK -- with 512-byte sectors this will work up to 2 "
2329 "TB. The latter has two problems. First, these C/H/S fields can be filled "
2330 "only when the number of heads and the number of sectors per track are known. "
2331 "And second, even if we know what these numbers should be, the 24 bits that "
2332 "are available do not suffice. DOS uses C/H/S only, Windows uses both, Linux "
2333 "never uses C/H/S. The *C/H/S addressing is deprecated* and may be "
2334 "unsupported in some later *fdisk* version."
2338 #: ../disk-utils/fdisk.8.adoc:151
2340 msgid "*Please, read the DOS-mode section if you want DOS-compatible partitions.* *fdisk* does not care about cylinder boundaries by default.\n"
2343 #. type: Labeled list
2344 #: ../disk-utils/fdisk.8.adoc:152
2346 msgid "*BSD/Sun-type*"
2350 #: ../disk-utils/fdisk.8.adoc:154
2352 "A BSD/Sun disklabel can describe 8 partitions, the third of which should be "
2353 "a `whole disk' partition. Do not start a partition that actually uses its "
2354 "first sector (like a swap partition) at cylinder 0, since that will destroy "
2355 "the disklabel. Note that a *BSD label* is usually nested within a DOS "
2359 #. type: Labeled list
2360 #: ../disk-utils/fdisk.8.adoc:155
2362 msgid "*IRIX/SGI-type*"
2366 #: ../disk-utils/fdisk.8.adoc:157
2368 "An IRIX/SGI disklabel can describe 16 partitions, the eleventh of which "
2369 "should be an entire `volume' partition, while the ninth should be labeled "
2370 "`volume header'. The volume header will also cover the partition table, i."
2371 "e., it starts at block zero and extends by default over five cylinders. The "
2372 "remaining space in the volume header may be used by header directory "
2373 "entries. No partitions may overlap with the volume header. Also do not "
2374 "change its type or make some filesystem on it, since you will lose the "
2375 "partition table. Use this type of label only when working with Linux on IRIX/"
2376 "SGI machines or IRIX/SGI disks under Linux."
2380 #: ../disk-utils/fdisk.8.adoc:159
2382 "A *sync*(2) and an ioctl(BLKRRPART) (rereading the partition table from "
2383 "disk) are performed before exiting when the partition table has been updated."
2387 #: ../disk-utils/fdisk.8.adoc:160
2389 msgid "DOS mode and DOS 6.x WARNING"
2393 #: ../disk-utils/fdisk.8.adoc:163
2395 msgid "*Note that all this is deprecated. You don't have to care about things like* *geometry and cylinders on modern operating systems. If you really want* *DOS-compatible partitioning then you have to enable DOS mode and cylinder* *units by using the '-c=dos -u=cylinders' fdisk command-line options.*\n"
2399 #: ../disk-utils/fdisk.8.adoc:165
2401 "The DOS 6.x FORMAT command looks for some information in the first sector of "
2402 "the data area of the partition, and treats this information as more reliable "
2403 "than the information in the partition table. DOS FORMAT expects DOS FDISK to "
2404 "clear the first 512 bytes of the data area of a partition whenever a size "
2405 "change occurs. DOS FORMAT will look at this extra information even if the /U "
2406 "flag is given -- we consider this a bug in DOS FORMAT and DOS FDISK."
2410 #: ../disk-utils/fdisk.8.adoc:167
2412 "The bottom line is that if you use *fdisk* or *cfdisk*(8) to change the size "
2413 "of a DOS partition table entry, then you must also use *dd*(1) to *zero the "
2414 "first 512 bytes* of that partition before using DOS FORMAT to format the "
2415 "partition. For example, if you were using *fdisk* to make a DOS partition "
2416 "table entry for _/dev/sda1_, then (after exiting *fdisk* and rebooting Linux "
2417 "so that the partition table information is valid) you would use the command "
2418 "*dd if=/dev/zero of=/dev/sda1 bs=512 count=1* to zero the first 512 bytes of "
2423 #: ../disk-utils/fdisk.8.adoc:169
2425 msgid "*fdisk* usually obtains the disk geometry automatically. This is not necessarily the physical disk geometry (indeed, modern disks do not really have anything like a physical geometry, certainly not something that can be described in the simplistic Cylinders/Heads/Sectors form), but it is the disk geometry that MS-DOS uses for the partition table.\n"
2429 #: ../disk-utils/fdisk.8.adoc:171
2431 "Usually all goes well by default, and there are no problems if Linux is the "
2432 "only system on the disk. However, if the disk has to be shared with other "
2433 "operating systems, it is often a good idea to let an *fdisk* from another "
2434 "operating system make at least one partition. When Linux boots it looks at "
2435 "the partition table, and tries to deduce what (fake) geometry is required "
2436 "for good cooperation with other systems."
2440 #: ../disk-utils/fdisk.8.adoc:173
2442 "Whenever a partition table is printed out in DOS mode, a consistency check "
2443 "is performed on the partition table entries. This check verifies that the "
2444 "physical and logical start and end points are identical, and that each "
2445 "partition starts and ends on a cylinder boundary (except for the first "
2450 #: ../disk-utils/fdisk.8.adoc:175
2452 "Some versions of MS-DOS create a first partition which does not begin on a "
2453 "cylinder boundary, but on sector 2 of the first cylinder. Partitions "
2454 "beginning in cylinder 1 cannot begin on a cylinder boundary, but this is "
2455 "unlikely to cause difficulty unless you have OS/2 on your machine."
2459 #: ../disk-utils/fdisk.8.adoc:177
2461 "For best results, you should always use an OS-specific partition table "
2462 "program. For example, you should make DOS partitions with the DOS FDISK "
2463 "program and Linux partitions with the Linux *fdisk* or Linux *cfdisk*(8) "
2468 #: ../disk-utils/fdisk.8.adoc:180
2469 msgid "The logical color names supported by *fdisk* are:"
2472 #. type: Labeled list
2473 #: ../disk-utils/fdisk.8.adoc:181 ../disk-utils/sfdisk.8.adoc:400
2474 #: ../misc-utils/cal.1.adoc:159
2480 #: ../disk-utils/fdisk.8.adoc:183 ../disk-utils/sfdisk.8.adoc:402
2481 msgid "The header of the output tables."
2484 #. type: Labeled list
2485 #: ../disk-utils/fdisk.8.adoc:184
2487 msgid "*help-title*"
2491 #: ../disk-utils/fdisk.8.adoc:186
2492 msgid "The help section titles."
2495 #. type: Labeled list
2496 #: ../disk-utils/fdisk.8.adoc:187 ../disk-utils/sfdisk.8.adoc:402
2497 #: ../sys-utils/dmesg.1.adoc:175
2503 #: ../disk-utils/fdisk.8.adoc:189 ../disk-utils/sfdisk.8.adoc:404
2504 msgid "The warning messages."
2507 #. type: Labeled list
2508 #: ../disk-utils/fdisk.8.adoc:190 ../disk-utils/sfdisk.8.adoc:404
2514 #: ../disk-utils/fdisk.8.adoc:192 ../disk-utils/sfdisk.8.adoc:406
2515 msgid "The welcome message."
2518 #. type: Labeled list
2519 #: ../disk-utils/fdisk.8.adoc:195
2521 msgid "*FDISK_DEBUG*=all"
2525 #: ../disk-utils/fdisk.8.adoc:197
2526 msgid "enables fdisk debug output."
2530 #: ../disk-utils/fdisk.8.adoc:209 ../misc-utils/findmnt.8.adoc:208
2531 #: ../misc-utils/lsblk.8.adoc:166
2532 msgid "use visible padding characters."
2536 #: ../disk-utils/fdisk.8.adoc:217
2537 msgid "mailto:kzak@redhat.com[Karel Zak], mailto:dave@gnu.org[Davidlohr Bueso]"
2541 #: ../disk-utils/fdisk.8.adoc:219
2543 "The original version was written by Andries E. Brouwer, A. V. Le Blanc and "
2548 #: ../disk-utils/fdisk.8.adoc:226
2557 #. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
2558 #. This file may be copied under the terms of the GNU Public License.
2560 #: ../disk-utils/fsck.8.adoc:6
2566 #: ../disk-utils/fsck.8.adoc:16
2567 msgid "fsck - check and repair a Linux filesystem"
2571 #: ../disk-utils/fsck.8.adoc:20
2573 msgid "*fsck* [*-lsAVRTMNP*] [*-r* [_fd_]] [*-C* [_fd_]] [*-t* _fstype_] [_filesystem_...] [*--*] [_fs-specific-options_]\n"
2577 #: ../disk-utils/fsck.8.adoc:24
2579 msgid "*fsck* is used to check and optionally repair one or more Linux filesystems. _filesystem_ can be a device name (e.g., _/dev/hdc1_, _/dev/sdb2_), a mount point (e.g., _/_, _/usr_, _/home_), or a filesystem label or UUID specifier (e.g., UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd or LABEL=root). Normally, the *fsck* program will try to handle filesystems on different physical disk drives in parallel to reduce the total amount of time needed to check all of them.\n"
2583 #: ../disk-utils/fsck.8.adoc:26
2585 "If no filesystems are specified on the command line, and the *-A* option is "
2586 "not specified, *fsck* will default to checking filesystems in _/etc/fstab_ "
2587 "serially. This is equivalent to the *-As* options."
2591 #: ../disk-utils/fsck.8.adoc:28
2593 "The exit status returned by *fsck* is the sum of the following conditions:"
2596 #. type: Labeled list
2597 #: ../disk-utils/fsck.8.adoc:29 ../disk-utils/fsck.cramfs.8.adoc:42
2598 #: ../disk-utils/fsck.minix.8.adoc:80 ../disk-utils/isosize.8.adoc:35
2599 #: ../disk-utils/mkfs.cramfs.8.adoc:77 ../misc-utils/fadvise.1.adoc:48
2600 #: ../misc-utils/findfs.8.adoc:51 ../misc-utils/kill.1.adoc:43
2601 #: ../misc-utils/kill.1.adoc:89 ../misc-utils/rename.1.adoc:68
2602 #: ../misc-utils/waitpid.1.adoc:44 ../sys-utils/blkdiscard.8.adoc:61
2603 #: ../sys-utils/chcpu.8.adoc:59 ../sys-utils/chmem.8.adoc:58
2604 #: ../sys-utils/lsns.8.adoc:79 ../sys-utils/mount.8.adoc:1591
2605 #: ../sys-utils/mountpoint.1.adoc:43 ../sys-utils/swapon.8.adoc:98
2606 #: ../term-utils/mesg.1.adoc:80
2612 #: ../disk-utils/fsck.8.adoc:31 ../disk-utils/fsck.minix.8.adoc:82
2613 #: ../disk-utils/mkfs.minix.8.adoc:81
2617 #. type: Labeled list
2618 #: ../disk-utils/fsck.8.adoc:31 ../disk-utils/isosize.8.adoc:37
2619 #: ../misc-utils/fadvise.1.adoc:50 ../misc-utils/findfs.8.adoc:53
2620 #: ../misc-utils/kill.1.adoc:91 ../misc-utils/rename.1.adoc:71
2621 #: ../misc-utils/waitpid.1.adoc:46 ../sys-utils/blkdiscard.8.adoc:64
2622 #: ../sys-utils/chcpu.8.adoc:62 ../sys-utils/chmem.8.adoc:61
2623 #: ../sys-utils/lsns.8.adoc:81 ../sys-utils/mount.8.adoc:1594
2624 #: ../sys-utils/mountpoint.1.adoc:46 ../term-utils/mesg.1.adoc:82
2630 #: ../disk-utils/fsck.8.adoc:33
2631 msgid "Filesystem errors corrected"
2634 #. type: Labeled list
2635 #: ../disk-utils/fsck.8.adoc:33 ../misc-utils/findfs.8.adoc:55
2636 #: ../misc-utils/rename.1.adoc:74 ../misc-utils/waitpid.1.adoc:48
2637 #: ../sys-utils/blkdiscard.8.adoc:67 ../sys-utils/lsns.8.adoc:83
2638 #: ../sys-utils/mount.8.adoc:893 ../sys-utils/mount.8.adoc:1597
2639 #: ../sys-utils/swapon.8.adoc:101
2645 #: ../disk-utils/fsck.8.adoc:35
2646 msgid "System should be rebooted"
2649 #. type: Labeled list
2650 #: ../disk-utils/fsck.8.adoc:35 ../disk-utils/fsck.cramfs.8.adoc:44
2651 #: ../disk-utils/fsck.minix.8.adoc:84 ../misc-utils/rename.1.adoc:77
2652 #: ../sys-utils/mount.8.adoc:1600 ../sys-utils/swapon.8.adoc:104
2657 #. type: delimited block _
2658 #: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.minix.8.adoc:86
2659 msgid "Filesystem errors left uncorrected"
2662 #. type: Labeled list
2663 #: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.cramfs.8.adoc:46
2664 #: ../disk-utils/fsck.minix.8.adoc:88 ../disk-utils/mkfs.cramfs.8.adoc:79
2665 #: ../sys-utils/mount.8.adoc:1603 ../sys-utils/swapon.8.adoc:107
2671 #: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.minix.8.adoc:90
2672 #: ../disk-utils/mkfs.minix.8.adoc:83
2673 msgid "Operational error"
2676 #. type: Labeled list
2677 #: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.cramfs.8.adoc:48
2678 #: ../disk-utils/fsck.minix.8.adoc:90 ../sys-utils/mount.8.adoc:1606
2679 #: ../sys-utils/swapon.8.adoc:110
2685 #: ../disk-utils/fsck.8.adoc:41 ../disk-utils/fsck.minix.8.adoc:92
2686 #: ../disk-utils/mkfs.minix.8.adoc:85
2687 msgid "Usage or syntax error"
2690 #. type: Labeled list
2691 #: ../disk-utils/fsck.8.adoc:41 ../disk-utils/isosize.8.adoc:39
2692 #: ../sys-utils/mount.8.adoc:1609 ../sys-utils/mountpoint.1.adoc:49
2693 #: ../sys-utils/swapon.8.adoc:113
2699 #: ../disk-utils/fsck.8.adoc:43
2700 msgid "Checking canceled by user request"
2703 #. type: Labeled list
2704 #: ../disk-utils/fsck.8.adoc:43
2710 #: ../disk-utils/fsck.8.adoc:45
2711 msgid "Shared-library error"
2715 #: ../disk-utils/fsck.8.adoc:47
2717 "The exit status returned when multiple filesystems are checked is the bit-"
2718 "wise OR of the exit statuses for each filesystem that is checked."
2722 #: ../disk-utils/fsck.8.adoc:49
2724 "In actuality, *fsck* is simply a front-end for the various filesystem "
2725 "checkers (*fsck*._fstype_) available under Linux. The filesystem-specific "
2726 "checker is searched for in the *PATH* environment variable. If the *PATH* is "
2727 "undefined then fallback to _/sbin_."
2731 #: ../disk-utils/fsck.8.adoc:51
2733 "Please see the filesystem-specific checker manual pages for further details."
2736 #. type: Labeled list
2737 #: ../disk-utils/fsck.8.adoc:54 ../disk-utils/mkfs.bfs.8.adoc:47
2738 #: ../misc-utils/whereis.1.adoc:97
2744 #: ../disk-utils/fsck.8.adoc:56
2746 "Create an exclusive *flock*(2) lock file (_/run/fsck/<diskname>.lock_) for "
2747 "whole-disk device. This option can be used with one device only (this means "
2748 "that *-A* and *-l* are mutually exclusive). This option is recommended when "
2749 "more *fsck* instances are executed in the same time. The option is ignored "
2750 "when used for multiple devices or for non-rotating disks. *fsck* does not "
2751 "lock underlying devices when executed to check stacked devices (e.g. MD or "
2752 "DM) - this feature is not implemented yet."
2755 #. type: Labeled list
2756 #: ../disk-utils/fsck.8.adoc:57
2762 #: ../disk-utils/fsck.8.adoc:59
2764 "Report certain statistics for each fsck when it completes. These statistics "
2765 "include the exit status, the maximum run set size (in kilobytes), the "
2766 "elapsed all-clock time and the user and system CPU time used by the fsck "
2771 #: ../disk-utils/fsck.8.adoc:61
2773 msgid "*/dev/sda1: status 0, rss 92828, real 4.002804, user 2.677592, sys 0.86186*\n"
2777 #: ../disk-utils/fsck.8.adoc:63
2779 "GUI front-ends may specify a file descriptor _fd_, in which case the "
2780 "progress bar information will be sent to that file descriptor in a machine "
2781 "parsable format. For example:"
2785 #: ../disk-utils/fsck.8.adoc:65
2787 msgid "*/dev/sda1 0 92828 4.002804 2.677592 0.86186*\n"
2790 #. type: Labeled list
2791 #: ../disk-utils/fsck.8.adoc:66 ../disk-utils/mkfs.cramfs.8.adoc:59
2792 #: ../misc-utils/whereis.1.adoc:79 ../sys-utils/mount.8.adoc:413
2793 #: ../text-utils/pg.1.adoc:59
2799 #: ../disk-utils/fsck.8.adoc:68
2801 "Serialize *fsck* operations. This is a good idea if you are checking "
2802 "multiple filesystems and the checkers are in an interactive mode. (Note: "
2803 "*e2fsck*(8) runs in an interactive mode by default. To make *e2fsck*(8) run "
2804 "in a non-interactive mode, you must either specify the *-p* or *-a* option, "
2805 "if you wish for errors to be corrected automatically, or the *-n* option if "
2809 #. type: Labeled list
2810 #: ../disk-utils/fsck.8.adoc:69
2812 msgid "*-t* _fslist_"
2816 #: ../disk-utils/fsck.8.adoc:71
2818 "Specifies the type(s) of filesystem to be checked. When the *-A* flag is "
2819 "specified, only filesystems that match _fslist_ are checked. The _fslist_ "
2820 "parameter is a comma-separated list of filesystems and options specifiers. "
2821 "All of the filesystems in this comma-separated list may be prefixed by a "
2822 "negation operator '*no*' or '*!*', which requests that only those "
2823 "filesystems not listed in _fslist_ will be checked. If none of the "
2824 "filesystems in _fslist_ is prefixed by a negation operator, then only those "
2825 "listed filesystems will be checked."
2829 #: ../disk-utils/fsck.8.adoc:73
2831 "Options specifiers may be included in the comma-separated _fslist_. They "
2832 "must have the format **opts=**__fs-option__. If an options specifier is "
2833 "present, then only filesystems which contain _fs-option_ in their mount "
2834 "options field of _/etc/fstab_ will be checked. If the options specifier is "
2835 "prefixed by a negation operator, then only those filesystems that do not "
2836 "have _fs-option_ in their mount options field of _/etc/fstab_ will be "
2841 #: ../disk-utils/fsck.8.adoc:75
2843 "For example, if *opts=ro* appears in _fslist_, then only filesystems listed "
2844 "in _/etc/fstab_ with the *ro* option will be checked."
2848 #: ../disk-utils/fsck.8.adoc:77
2850 "For compatibility with Mandrake distributions whose boot scripts depend upon "
2851 "an unauthorized UI change to the *fsck* program, if a filesystem type of "
2852 "*loop* is found in _fslist_, it is treated as if *opts=loop* were specified "
2853 "as an argument to the *-t* option."
2857 #: ../disk-utils/fsck.8.adoc:79
2859 "Normally, the filesystem type is deduced by searching for _filesys_ in the _/"
2860 "etc/fstab_ file and using the corresponding entry. If the type cannot be "
2861 "deduced, and there is only a single filesystem given as an argument to the *-"
2862 "t* option, *fsck* will use the specified filesystem type. If this type is "
2863 "not available, then the default filesystem type (currently ext2) is used."
2866 #. type: Labeled list
2867 #: ../disk-utils/fsck.8.adoc:80
2873 #: ../disk-utils/fsck.8.adoc:82
2875 "Walk through the _/etc/fstab_ file and try to check all filesystems in one "
2876 "run. This option is typically used from the _/etc/rc_ system initialization "
2877 "file, instead of multiple commands for checking a single filesystem."
2881 #: ../disk-utils/fsck.8.adoc:84
2883 "The root filesystem will be checked first unless the *-P* option is "
2884 "specified (see below). After that, filesystems will be checked in the order "
2885 "specified by the _fs_passno_ (the sixth) field in the _/etc/fstab_ file. "
2886 "Filesystems with a _fs_passno_ value of 0 are skipped and are not checked at "
2887 "all. Filesystems with a _fs_passno_ value of greater than zero will be "
2888 "checked in order, with filesystems with the lowest _fs_passno_ number being "
2889 "checked first. If there are multiple filesystems with the same pass number, "
2890 "*fsck* will attempt to check them in parallel, although it will avoid "
2891 "running multiple filesystem checks on the same physical disk."
2895 #: ../disk-utils/fsck.8.adoc:86
2897 msgid "*fsck* does not check stacked devices (RAIDs, dm-crypt, ...) in parallel with any other device. See below for *FSCK_FORCE_ALL_PARALLEL* setting. The _/sys_ filesystem is used to determine dependencies between devices.\n"
2901 #: ../disk-utils/fsck.8.adoc:88
2903 "Hence, a very common configuration in _/etc/fstab_ files is to set the root "
2904 "filesystem to have a _fs_passno_ value of 1 and to set all other filesystems "
2905 "to have a _fs_passno_ value of 2. This will allow *fsck* to automatically "
2906 "run filesystem checkers in parallel if it is advantageous to do so. System "
2907 "administrators might choose not to use this configuration if they need to "
2908 "avoid multiple filesystem checks running in parallel for some reason - for "
2909 "example, if the machine in question is short on memory so that excessive "
2910 "paging is a concern."
2914 #: ../disk-utils/fsck.8.adoc:90
2916 msgid "*fsck* normally does not check whether the device actually exists before calling a filesystem specific checker. Therefore non-existing devices may cause the system to enter filesystem repair mode during boot if the filesystem specific checker returns a fatal error. The _/etc/fstab_ mount option *nofail* may be used to have *fsck* skip non-existing devices. *fsck* also skips non-existing devices that have the special filesystem type *auto*.\n"
2919 #. type: Labeled list
2920 #: ../disk-utils/fsck.8.adoc:91
2926 #: ../disk-utils/fsck.8.adoc:93
2928 "Display completion/progress bars for those filesystem checkers (currently "
2929 "only for ext[234]) which support them. *fsck* will manage the filesystem "
2930 "checkers so that only one of them will display a progress bar at a time. GUI "
2931 "front-ends may specify a file descriptor _fd_, in which case the progress "
2932 "bar information will be sent to that file descriptor."
2935 #. type: Labeled list
2936 #: ../disk-utils/fsck.8.adoc:94 ../schedutils/uclampset.1.adoc:72
2942 #: ../disk-utils/fsck.8.adoc:96
2944 "Do not check mounted filesystems and return an exit status of 0 for mounted "
2948 #. type: Labeled list
2949 #: ../disk-utils/fsck.8.adoc:97
2955 #: ../disk-utils/fsck.8.adoc:99
2956 msgid "Don't execute, just show what would be done."
2959 #. type: Labeled list
2960 #: ../disk-utils/fsck.8.adoc:100
2966 #: ../disk-utils/fsck.8.adoc:102
2968 "When the *-A* flag is set, check the root filesystem in parallel with the "
2969 "other filesystems. This is not the safest thing in the world to do, since if "
2970 "the root filesystem is in doubt things like the *e2fsck*(8) executable might "
2971 "be corrupted! This option is mainly provided for those sysadmins who don't "
2972 "want to repartition the root filesystem to be small and compact (which is "
2973 "really the right solution)."
2976 #. type: Labeled list
2977 #: ../disk-utils/fsck.8.adoc:103
2983 #: ../disk-utils/fsck.8.adoc:105
2985 "When checking all filesystems with the *-A* flag, skip the root filesystem. "
2986 "(This is useful in case the root filesystem has already been mounted read-"
2990 #. type: Labeled list
2991 #: ../disk-utils/fsck.8.adoc:106
2997 #: ../disk-utils/fsck.8.adoc:108
2998 msgid "Don't show the title on startup."
3001 #. type: Labeled list
3002 #: ../disk-utils/fsck.8.adoc:109
3008 #: ../disk-utils/fsck.8.adoc:111
3010 "Produce verbose output, including all filesystem-specific commands that are "
3014 #. type: Labeled list
3015 #: ../disk-utils/fsck.8.adoc:112
3017 #| msgid "*-h*, *--help*"
3018 msgid "*-?*, *--help*"
3019 msgstr "*-h*, *--help*"
3021 #. type: Labeled list
3022 #: ../disk-utils/fsck.8.adoc:115
3024 #| msgid "*-V*, *--version*"
3026 msgstr "*-V*, *--version*"
3029 #: ../disk-utils/fsck.8.adoc:118
3031 msgid "FILESYSTEM SPECIFIC OPTIONS"
3035 #: ../disk-utils/fsck.8.adoc:121
3037 msgid "*Options which are not understood by fsck are passed to the filesystem-specific checker!*\n"
3041 #: ../disk-utils/fsck.8.adoc:123
3043 "These options *must* not take arguments, as there is no way for *fsck* to be "
3044 "able to properly guess which options take arguments and which don't."
3048 #: ../disk-utils/fsck.8.adoc:125
3050 "Options and arguments which follow the *--* are treated as filesystem-"
3051 "specific options to be passed to the filesystem-specific checker."
3055 #: ../disk-utils/fsck.8.adoc:127
3057 "Please note that *fsck* is not designed to pass arbitrarily complicated "
3058 "options to filesystem-specific checkers. If you're doing something "
3059 "complicated, please just execute the filesystem-specific checker directly. "
3060 "If you pass *fsck* some horribly complicated options and arguments, and it "
3061 "doesn't do what you expect, *don't bother reporting it as a bug.* You're "
3062 "almost certainly doing something that you shouldn't be doing with *fsck*. "
3063 "Options to different filesystem-specific fsck's are not standardized."
3067 #: ../disk-utils/fsck.8.adoc:131
3069 "The *fsck* program's behavior is affected by the following environment "
3073 #. type: Labeled list
3074 #: ../disk-utils/fsck.8.adoc:132
3076 msgid "*FSCK_FORCE_ALL_PARALLEL*"
3080 #: ../disk-utils/fsck.8.adoc:134
3082 "If this environment variable is set, *fsck* will attempt to check all of the "
3083 "specified filesystems in parallel, regardless of whether the filesystems "
3084 "appear to be on the same device. (This is useful for RAID systems or high-"
3085 "end storage systems such as those sold by companies such as IBM or EMC.) "
3086 "Note that the _fs_passno_ value is still used."
3089 #. type: Labeled list
3090 #: ../disk-utils/fsck.8.adoc:135
3092 msgid "*FSCK_MAX_INST*"
3096 #: ../disk-utils/fsck.8.adoc:137
3098 "This environment variable will limit the maximum number of filesystem "
3099 "checkers that can be running at one time. This allows configurations which "
3100 "have a large number of disks to avoid *fsck* starting too many filesystem "
3101 "checkers at once, which might overload CPU and memory resources available on "
3102 "the system. If this value is zero, then an unlimited number of processes can "
3103 "be spawned. This is currently the default, but future versions of *fsck* may "
3104 "attempt to automatically determine how many filesystem checks can be run "
3105 "based on gathering accounting data from the operating system."
3108 #. type: Labeled list
3109 #: ../disk-utils/fsck.8.adoc:138
3115 #: ../disk-utils/fsck.8.adoc:140
3116 msgid "The *PATH* environment variable is used to find filesystem checkers."
3119 #. type: Labeled list
3120 #: ../disk-utils/fsck.8.adoc:141
3122 msgid "*FSTAB_FILE*"
3126 #: ../disk-utils/fsck.8.adoc:143
3128 "This environment variable allows the system administrator to override the "
3129 "standard location of the _/etc/fstab_ file. It is also useful for developers "
3130 "who are testing *fsck*."
3133 #. type: Labeled list
3134 #: ../disk-utils/fsck.8.adoc:144
3136 msgid "*LIBBLKID_DEBUG=all*"
3139 #. type: Labeled list
3140 #: ../disk-utils/fsck.8.adoc:147
3142 msgid "*LIBMOUNT_DEBUG=all*"
3146 #: ../disk-utils/fsck.8.adoc:149 ../sys-utils/mountpoint.1.adoc:56
3147 msgid "enables libmount debug output."
3151 #: ../disk-utils/fsck.8.adoc:150 ../lib/terminal-colors.d.5.adoc:134
3152 #: ../login-utils/last.1.adoc:112 ../login-utils/login.1.adoc:137
3153 #: ../login-utils/newgrp.1.adoc:29 ../login-utils/runuser.1.adoc:111
3154 #: ../login-utils/su.1.adoc:119 ../misc-utils/look.1.adoc:82
3155 #: ../misc-utils/mcookie.1.adoc:44 ../sys-utils/adjtime_config.5.adoc:50
3156 #: ../sys-utils/ctrlaltdel.8.adoc:39 ../sys-utils/fstab.5.adoc:124
3157 #: ../sys-utils/hwclock.8.adoc:365 ../sys-utils/losetup.8.adoc:136
3158 #: ../sys-utils/mount.8.adoc:1644 ../sys-utils/readprofile.8.adoc:56
3159 #: ../sys-utils/renice.1.adoc:79 ../sys-utils/rtcwake.8.adoc:114
3160 #: ../sys-utils/swapon.8.adoc:131 ../sys-utils/tunelp.8.adoc:59
3161 #: ../sys-utils/umount.8.adoc:158 ../sys-utils/zramctl.8.adoc:78
3162 #: ../term-utils/agetty.8.adoc:305 ../term-utils/mesg.1.adoc:87
3167 #. type: Labeled list
3168 #: ../disk-utils/fsck.8.adoc:153 ../sys-utils/fstab.5.adoc:50
3169 #: ../sys-utils/mount.8.adoc:1648 ../sys-utils/swapon.8.adoc:136
3170 #: ../sys-utils/umount.8.adoc:163
3172 msgid "_/etc/fstab_"
3173 msgstr "_/etc/fstab_"
3176 #: ../disk-utils/fsck.8.adoc:158
3177 msgid "mailto:tytso@mit.edu>[Theodore Ts'o], mailto:kzak@redhat.com[Karel Zak]"
3181 #: ../disk-utils/fsck.8.adoc:172
3186 "*fsck.ext2*(8) or *fsck.ext3*(8) or *e2fsck*(8),\n"
3187 "*fsck.cramfs*(8),\n"
3190 "*fsck.minix*(8),\n"
3191 "*fsck.msdos*(8),\n"
3198 #: ../disk-utils/fsck.cramfs.8.adoc:2
3200 msgid "fsck.cramfs(8)"
3204 #: ../disk-utils/fsck.cramfs.8.adoc:12
3205 msgid "fsck.cramfs - fsck compressed ROM file system"
3209 #: ../disk-utils/fsck.cramfs.8.adoc:16
3211 msgid "*fsck.cramfs* [options] _file_\n"
3215 #: ../disk-utils/fsck.cramfs.8.adoc:20
3217 msgid "*fsck.cramfs* is used to check the cramfs file system.\n"
3220 #. type: Labeled list
3221 #: ../disk-utils/fsck.cramfs.8.adoc:23 ../disk-utils/fsck.minix.8.adoc:56
3222 #: ../disk-utils/mkfs.bfs.8.adoc:41 ../disk-utils/partx.8.adoc:96
3223 #: ../misc-utils/hardlink.1.adoc:102 ../misc-utils/mcookie.1.adoc:39
3224 #: ../misc-utils/pipesz.1.adoc:64 ../misc-utils/rename.1.adoc:28
3225 #: ../misc-utils/waitpid.1.adoc:26 ../schedutils/chrt.1.adoc:101
3226 #: ../schedutils/uclampset.1.adoc:87 ../sys-utils/blkdiscard.8.adoc:52
3227 #: ../sys-utils/blkzone.8.adoc:98 ../sys-utils/chmem.8.adoc:49
3228 #: ../sys-utils/eject.1.adoc:84 ../sys-utils/fallocate.1.adoc:64
3229 #: ../sys-utils/hwclock.8.adoc:173 ../sys-utils/losetup.8.adoc:98
3230 #: ../sys-utils/mount.8.adoc:457 ../sys-utils/readprofile.8.adoc:51
3231 #: ../sys-utils/rtcwake.8.adoc:105 ../sys-utils/setarch.8.adoc:42
3232 #: ../sys-utils/swapon.8.adoc:89 ../sys-utils/umount.8.adoc:111
3233 #: ../term-utils/mesg.1.adoc:71
3235 #| msgid "*-V*, *--version*"
3236 msgid "*-v*, *--verbose*"
3237 msgstr "*-V*, *--version*"
3240 #: ../disk-utils/fsck.cramfs.8.adoc:25 ../disk-utils/mkfs.cramfs.8.adoc:37
3241 msgid "Enable verbose messaging."
3244 #. type: Labeled list
3245 #: ../disk-utils/fsck.cramfs.8.adoc:26
3247 msgid "*-b*, *--blocksize* _blocksize_"
3251 #: ../disk-utils/fsck.cramfs.8.adoc:28
3253 "Use this blocksize, defaults to page size. Must be equal to what was set at "
3254 "creation time. Only used for *--extract*."
3257 #. type: Labeled list
3258 #: ../disk-utils/fsck.cramfs.8.adoc:29
3260 msgid "*--extract*[=_directory_]"
3264 #: ../disk-utils/fsck.cramfs.8.adoc:31
3266 "Test to uncompress the whole file system. Optionally extract contents of the "
3267 "_file_ to _directory_."
3270 #. type: Labeled list
3271 #: ../disk-utils/fsck.cramfs.8.adoc:32
3277 #: ../disk-utils/fsck.cramfs.8.adoc:34 ../disk-utils/fsck.cramfs.8.adoc:37
3278 #: ../disk-utils/mkfs.bfs.8.adoc:46 ../disk-utils/mkfs.bfs.8.adoc:49
3279 msgid "This option is silently ignored."
3282 #. type: Labeled list
3283 #: ../disk-utils/fsck.cramfs.8.adoc:35
3289 #: ../disk-utils/fsck.cramfs.8.adoc:40 ../disk-utils/fsck.minix.8.adoc:76
3290 #: ../disk-utils/isosize.8.adoc:33 ../disk-utils/mkfs.bfs.8.adoc:53
3291 #: ../disk-utils/mkfs.cramfs.8.adoc:75 ../disk-utils/mkfs.minix.8.adoc:75
3292 #: ../login-utils/chfn.1.adoc:72 ../login-utils/chsh.1.adoc:55
3293 #: ../login-utils/lslogins.1.adoc:107 ../login-utils/runuser.1.adoc:97
3294 #: ../login-utils/su.1.adoc:106 ../misc-utils/blkid.8.adoc:148
3295 #: ../misc-utils/fadvise.1.adoc:44 ../misc-utils/findfs.8.adoc:49
3296 #: ../misc-utils/findmnt.8.adoc:186 ../misc-utils/kill.1.adoc:85
3297 #: ../misc-utils/logger.1.adoc:186 ../misc-utils/lsblk.8.adoc:136
3298 #: ../misc-utils/rename.1.adoc:66 ../misc-utils/waitpid.1.adoc:40
3299 #: ../sys-utils/blkdiscard.8.adoc:57 ../sys-utils/chcpu.8.adoc:55
3300 #: ../sys-utils/chmem.8.adoc:54 ../sys-utils/dmesg.1.adoc:181
3301 #: ../sys-utils/eject.1.adoc:93 ../sys-utils/flock.1.adoc:88
3302 #: ../sys-utils/fstrim.8.adoc:74 ../sys-utils/hwclock.8.adoc:347
3303 #: ../sys-utils/losetup.8.adoc:123 ../sys-utils/lsipc.1.adoc:86
3304 #: ../sys-utils/lsns.8.adoc:75 ../sys-utils/mount.8.adoc:1587
3305 #: ../sys-utils/mountpoint.1.adoc:39 ../sys-utils/swapon.8.adoc:94
3306 #: ../sys-utils/switch_root.8.adoc:29 ../sys-utils/zramctl.8.adoc:74
3307 #: ../term-utils/mesg.1.adoc:76 ../text-utils/hexdump.1.adoc:222
3310 msgstr "NÁVRATOVÁ HODNOTA"
3313 #: ../disk-utils/fsck.cramfs.8.adoc:44 ../disk-utils/isosize.8.adoc:37
3314 #: ../disk-utils/mkfs.cramfs.8.adoc:79 ../misc-utils/fadvise.1.adoc:50
3315 #: ../misc-utils/findfs.8.adoc:53 ../misc-utils/kill.1.adoc:91
3316 #: ../misc-utils/lsblk.8.adoc:140 ../misc-utils/waitpid.1.adoc:46
3317 #: ../sys-utils/blkdiscard.8.adoc:63 ../sys-utils/chcpu.8.adoc:61
3318 #: ../sys-utils/chmem.8.adoc:60 ../sys-utils/fstrim.8.adoc:78
3319 #: ../sys-utils/mount.8.adoc:1593 ../sys-utils/swapon.8.adoc:100
3324 #: ../disk-utils/fsck.cramfs.8.adoc:46
3325 msgid "file system was left uncorrected"
3329 #: ../disk-utils/fsck.cramfs.8.adoc:48 ../disk-utils/mkfs.cramfs.8.adoc:81
3330 msgid "operation error, such as unable to allocate memory"
3334 #: ../disk-utils/fsck.cramfs.8.adoc:50
3335 msgid "usage information was printed"
3339 #: ../disk-utils/fsck.cramfs.8.adoc:55
3343 "*mkfs.cramfs*(8)\n"
3346 #. Copyright 1992, 1993, 1994 Rickard E. Faith (faith@cs.unc.edu)
3347 #. May be freely distributed.
3349 #: ../disk-utils/fsck.minix.8.adoc:6
3351 msgid "fsck.minix(8)"
3355 #: ../disk-utils/fsck.minix.8.adoc:16
3356 msgid "fsck.minix - check consistency of Minix filesystem"
3360 #: ../disk-utils/fsck.minix.8.adoc:20
3362 msgid "*fsck.minix* [options] _device_\n"
3366 #: ../disk-utils/fsck.minix.8.adoc:24
3368 msgid "*fsck.minix* performs a consistency check for the Linux MINIX filesystem.\n"
3372 #: ../disk-utils/fsck.minix.8.adoc:26
3374 "The program assumes the filesystem is quiescent. *fsck.minix* should not be "
3375 "used on a mounted device unless you can be sure nobody is writing to it. "
3376 "Remember that the kernel can write to device when it searches for files."
3380 #: ../disk-utils/fsck.minix.8.adoc:28
3381 msgid "The _device_ name will usually have the following form:"
3385 #: ../disk-utils/fsck.minix.8.adoc:36
3388 "|/dev/hda[1-63] |IDE disk 1\n"
3389 "|/dev/hdb[1-63] |IDE disk 2\n"
3390 "|/dev/sda[1-15] |SCSI disk 1\n"
3391 "|/dev/sdb[1-15] |SCSI disk 2\n"
3394 #. type: delimited block _
3395 #: ../disk-utils/fsck.minix.8.adoc:40
3397 "If the filesystem was changed, i.e., repaired, then *fsck.minix* will print "
3398 "\"FILE SYSTEM HAS BEEN CHANGED\" and will *sync*(2) three times before "
3399 "exiting. There is _no_ need to reboot after check."
3403 #: ../disk-utils/fsck.minix.8.adoc:41 ../disk-utils/mkswap.8.adoc:31
3404 #: ../misc-utils/rename.1.adoc:48
3409 #. type: delimited block _
3410 #: ../disk-utils/fsck.minix.8.adoc:44
3412 msgid "*fsck.minix* should *not* be used on a mounted filesystem. Using *fsck.minix* on a mounted filesystem is very dangerous, due to the possibility that deleted files are still in use, and can seriously damage a perfectly good filesystem! If you absolutely have to run *fsck.minix* on a mounted filesystem, such as the root filesystem, make sure nothing is writing to the disk, and that no files are \"zombies\" waiting for deletion.\n"
3415 #. type: delimited block _
3416 #: ../disk-utils/fsck.minix.8.adoc:49
3417 msgid "List all filenames."
3420 #. type: Labeled list
3421 #: ../disk-utils/fsck.minix.8.adoc:50
3423 #| msgid "*-h*, *--help*"
3424 msgid "*-r*, *--repair*"
3425 msgstr "*-h*, *--help*"
3427 #. type: delimited block _
3428 #: ../disk-utils/fsck.minix.8.adoc:52
3429 msgid "Perform interactive repairs."
3432 #. type: Labeled list
3433 #: ../disk-utils/fsck.minix.8.adoc:53 ../sys-utils/rtcwake.8.adoc:36
3435 #| msgid "*-f*, *--fast*"
3436 msgid "*-a*, *--auto*"
3437 msgstr "*-f*, *--fast*"
3439 #. type: delimited block _
3440 #: ../disk-utils/fsck.minix.8.adoc:55
3442 "Perform automatic repairs. This option implies *--repair* and serves to "
3443 "answer all of the questions asked with the default. Note that this can be "
3444 "extremely dangerous in the case of extensive filesystem damage."
3447 #. type: Labeled list
3448 #: ../disk-utils/fsck.minix.8.adoc:59
3450 #| msgid "*-P*, *--pty*"
3451 msgid "*-s*, *--super*"
3452 msgstr "*-P*, *--pty*"
3454 #. type: delimited block _
3455 #: ../disk-utils/fsck.minix.8.adoc:61
3456 msgid "Output super-block information."
3459 #. type: Labeled list
3460 #: ../disk-utils/fsck.minix.8.adoc:62
3462 #| msgid "*-V*, *--version*"
3463 msgid "*-m*, *--uncleared*"
3464 msgstr "*-V*, *--version*"
3466 #. type: delimited block _
3467 #: ../disk-utils/fsck.minix.8.adoc:64
3468 msgid "Activate MINIX-like \"mode not cleared\" warnings."
3471 #. type: Labeled list
3472 #: ../disk-utils/fsck.minix.8.adoc:65 ../disk-utils/mkswap.8.adoc:44
3473 #: ../disk-utils/sfdisk.8.adoc:152 ../misc-utils/wipefs.8.adoc:46
3474 #: ../sys-utils/blkdiscard.8.adoc:31 ../sys-utils/blkzone.8.adoc:95
3475 #: ../sys-utils/umount.8.adoc:73
3477 #| msgid "*-f*, *--fast*"
3478 msgid "*-f*, *--force*"
3479 msgstr "*-f*, *--fast*"
3481 #. type: delimited block _
3482 #: ../disk-utils/fsck.minix.8.adoc:67
3484 "Force a filesystem check even if the filesystem was marked as valid. Marking "
3485 "is done by the kernel when the filesystem is unmounted."
3489 #: ../disk-utils/fsck.minix.8.adoc:70 ../term-utils/agetty.8.adoc:338
3494 #. type: delimited block _
3495 #: ../disk-utils/fsck.minix.8.adoc:73
3497 "There are numerous diagnostic messages. The ones mentioned here are the most "
3498 "commonly seen in normal usage."
3501 #. type: delimited block _
3502 #: ../disk-utils/fsck.minix.8.adoc:75
3504 "If the device does not exist, *fsck.minix* will print \"unable to read super "
3505 "block\". If the device exists, but is not a MINIX filesystem, *fsck.minix* "
3506 "will print \"bad magic number in super-block\"."
3509 #. type: delimited block _
3510 #: ../disk-utils/fsck.minix.8.adoc:79
3511 msgid "The exit status returned by *fsck.minix* is the sum of the following:"
3514 #. type: Labeled list
3515 #: ../disk-utils/fsck.minix.8.adoc:82 ../misc-utils/waitpid.1.adoc:50
3520 #. type: delimited block _
3521 #: ../disk-utils/fsck.minix.8.adoc:84
3523 "Filesystem errors corrected, system should be rebooted if filesystem was "
3527 #. type: Labeled list
3528 #: ../disk-utils/fsck.minix.8.adoc:86
3533 #. type: delimited block _
3534 #: ../disk-utils/fsck.minix.8.adoc:88
3535 msgid "Combination of exit statuses 3 and 4"
3538 #. type: delimited block _
3539 #: ../disk-utils/fsck.minix.8.adoc:97
3541 "mailto:torvalds@cs.helsinki.fi[Linus Torvalds]. Exit status values by mailto:"
3542 "faith@cs.unc.edu[Rik Faith] Added support for filesystem valid flag: mailto:"
3543 "greg%wind.uucp@plains.nodak.edu[Dr. Wettstein]. Check to prevent fsck of "
3544 "mounted filesystem added by mailto:quinlan@yggdrasil.com[Daniel Quinlan]. "
3545 "Minix v2 fs support by mailto:schwab@issan.informatik.uni-dortmund."
3546 "de[Andreas Schwab], updated by mailto:janl@math.uio.no[Nicolai Langfeldt]. "
3547 "Portability patch by mailto:rmk@ecs.soton.ac.uk[Russell King]."
3550 #. type: delimited block _
3551 #: ../disk-utils/fsck.minix.8.adoc:106
3558 "*mkfs.minix*(8),\n"
3563 #: ../disk-utils/isosize.8.adoc:2
3569 #: ../disk-utils/isosize.8.adoc:12
3570 msgid "isosize - output the length of an iso9660 filesystem"
3574 #: ../disk-utils/isosize.8.adoc:16
3576 msgid "*isosize* [options] _iso9660_image_file_\n"
3580 #: ../disk-utils/isosize.8.adoc:20
3582 "This command outputs the length of an iso9660 filesystem that is contained "
3583 "in the specified file. This file may be a normal file or a block device (e."
3584 "g. _/dev/hdd_ or _/dev/sr0_). In the absence of any options (and errors), it "
3585 "will output the size of the iso9660 filesystem in bytes. This can now be a "
3586 "large number (>> 4 GB)."
3589 #. type: Labeled list
3590 #: ../disk-utils/isosize.8.adoc:23
3592 #| msgid "*-f*, *--fast*"
3593 msgid "*-x*, *--sectors*"
3594 msgstr "*-f*, *--fast*"
3597 #: ../disk-utils/isosize.8.adoc:25
3599 "Show the block count and block size in human-readable form. The output uses "
3600 "the term \"sectors\" for \"blocks\"."
3603 #. type: Labeled list
3604 #: ../disk-utils/isosize.8.adoc:26 ../term-utils/scriptlive.1.adoc:42
3605 #: ../term-utils/scriptreplay.1.adoc:53
3607 msgid "*-d*, *--divisor* _number_"
3611 #: ../disk-utils/isosize.8.adoc:28
3613 "Only has an effect when *-x* is not given. The value shown (if no errors) is "
3614 "the iso9660 file size in bytes divided by _number_. So if _number_ is the "
3615 "block size then the shown value will be the block count."
3619 #: ../disk-utils/isosize.8.adoc:30
3621 "The size of the file (or block device) holding an iso9660 filesystem can be "
3622 "marginally larger than the actual size of the iso9660 filesystem. One reason "
3623 "for this is that cd writers are allowed to add \"run out\" sectors at the "
3624 "end of an iso9660 image."
3628 #: ../disk-utils/isosize.8.adoc:39
3629 msgid "generic failure, such as invalid usage"
3633 #: ../disk-utils/isosize.8.adoc:41 ../sys-utils/fstrim.8.adoc:82
3637 #. type: Labeled list
3638 #: ../disk-utils/isosize.8.adoc:41 ../misc-utils/kill.1.adoc:93
3639 #: ../misc-utils/rename.1.adoc:80 ../sys-utils/chcpu.8.adoc:65
3640 #: ../sys-utils/chmem.8.adoc:64 ../sys-utils/mount.8.adoc:1612
3641 #: ../sys-utils/swapon.8.adoc:116
3647 #: ../disk-utils/isosize.8.adoc:43
3652 #: ../disk-utils/mkfs.8.adoc:2
3658 #: ../disk-utils/mkfs.8.adoc:12
3659 msgid "mkfs - build a Linux filesystem"
3663 #: ../disk-utils/mkfs.8.adoc:16
3665 msgid "*mkfs* [options] [*-t* _type_] [_fs-options_] _device_ [_size_]\n"
3669 #: ../disk-utils/mkfs.8.adoc:20
3671 msgid "*This mkfs frontend is deprecated in favour of filesystem specific mkfs.<type> utils.*\n"
3675 #: ../disk-utils/mkfs.8.adoc:22
3677 msgid "*mkfs* is used to build a Linux filesystem on a device, usually a hard disk partition. The _device_ argument is either the device name (e.g., _/dev/hda1_, _/dev/sdb2_), or a regular file that shall contain the filesystem. The _size_ argument is the number of blocks to be used for the filesystem.\n"
3681 #: ../disk-utils/mkfs.8.adoc:24
3682 msgid "The exit status returned by *mkfs* is 0 on success and 1 on failure."
3686 #: ../disk-utils/mkfs.8.adoc:26
3688 "In actuality, *mkfs* is simply a front-end for the various filesystem "
3689 "builders (**mkfs.**__fstype__) available under Linux. The filesystem-"
3690 "specific builder is searched for via your *PATH* environment setting only. "
3691 "Please see the filesystem-specific builder manual pages for further details."
3695 #: ../disk-utils/mkfs.8.adoc:31
3697 "Specify the _type_ of filesystem to be built. If not specified, the default "
3698 "filesystem type (currently ext2) is used."
3701 #. type: Labeled list
3702 #: ../disk-utils/mkfs.8.adoc:32
3704 msgid "_fs-options_"
3708 #: ../disk-utils/mkfs.8.adoc:34
3710 "Filesystem-specific options to be passed to the real filesystem builder."
3713 #. type: Labeled list
3714 #: ../disk-utils/mkfs.8.adoc:35
3716 #| msgid "*-V*, *--version*"
3717 msgid "*-V*, *--verbose*"
3718 msgstr "*-V*, *--version*"
3721 #: ../disk-utils/mkfs.8.adoc:37
3723 "Produce verbose output, including all filesystem-specific commands that are "
3724 "executed. Specifying this option more than once inhibits execution of any "
3725 "filesystem-specific commands. This is really only useful for testing."
3729 #: ../disk-utils/mkfs.8.adoc:40
3731 "(Option *-V* will display version information only when it is the only "
3732 "parameter, otherwise it will work as *--verbose*.)"
3736 #: ../disk-utils/mkfs.8.adoc:41 ../disk-utils/raw.8.adoc:51
3737 #: ../login-utils/login.1.adoc:159 ../login-utils/utmpdump.1.adoc:67
3738 #: ../misc-utils/cal.1.adoc:177 ../misc-utils/getopt.1.adoc:141
3739 #: ../misc-utils/hardlink.1.adoc:138 ../misc-utils/mcookie.1.adoc:50
3740 #: ../misc-utils/namei.1.adoc:65 ../misc-utils/pipesz.1.adoc:91
3741 #: ../sys-utils/lscpu.1.adoc:95 ../sys-utils/mount.8.adoc:1670
3742 #: ../sys-utils/readprofile.8.adoc:67 ../term-utils/agetty.8.adoc:330
3743 #: ../term-utils/script.1.adoc:155 ../term-utils/setterm.1.adoc:163
3744 #: ../text-utils/colcrt.1.adoc:70 ../text-utils/column.1.adoc:185
3745 #: ../text-utils/ul.1.adoc:76
3751 #: ../disk-utils/mkfs.8.adoc:44
3753 "All generic options must precede and not be combined with filesystem-"
3754 "specific options. Some filesystem-specific programs do not automatically "
3755 "detect the device size and require the _size_ parameter to be specified."
3759 #: ../disk-utils/mkfs.8.adoc:50
3761 "mailto:david@ods.com[David Engel], mailto:waltje@uwalt.nl.mugnet.org[Fred N. "
3762 "van Kempen], mailto:sommel@sci.kun.nl[Ron Sommeling]."
3766 #: ../disk-utils/mkfs.8.adoc:52
3768 "The manual page was shamelessly adapted from Remy Card's version for the "
3773 #: ../disk-utils/mkfs.8.adoc:68
3785 "*mkfs.minix*(8),\n"
3786 "*mkfs.msdos*(8),\n"
3791 #. Copyright 1999 Andries E. Brouwer (aeb@cwi.nl)
3792 #. May be freely distributed.
3794 #: ../disk-utils/mkfs.bfs.8.adoc:6
3800 #: ../disk-utils/mkfs.bfs.8.adoc:16
3801 msgid "mkfs.bfs - make an SCO bfs filesystem"
3805 #: ../disk-utils/mkfs.bfs.8.adoc:20
3807 msgid "*mkfs.bfs* [options] _device_ [_block-count_]\n"
3811 #: ../disk-utils/mkfs.bfs.8.adoc:24
3813 msgid "*mkfs.bfs* creates an SCO bfs filesystem on a block device (usually a disk partition or a file accessed via the loop device).\n"
3817 #: ../disk-utils/mkfs.bfs.8.adoc:26
3819 "The _block-count_ parameter is the desired size of the filesystem, in "
3820 "blocks. If nothing is specified, the entire partition will be used."
3823 #. type: Labeled list
3824 #: ../disk-utils/mkfs.bfs.8.adoc:29
3826 msgid "*-N*, *--inodes* _number_"
3830 #: ../disk-utils/mkfs.bfs.8.adoc:31
3832 "Specify the desired _number_ of inodes (at most 512). If nothing is "
3833 "specified, some default number in the range 48-512 is picked depending on "
3834 "the size of the partition."
3837 #. type: Labeled list
3838 #: ../disk-utils/mkfs.bfs.8.adoc:32
3840 #| msgid "*-V*, *--version*"
3841 msgid "*-V*, *--vname* _label_"
3842 msgstr "*-V*, *--version*"
3845 #: ../disk-utils/mkfs.bfs.8.adoc:34
3846 msgid "Specify the volume _label_. I have no idea if/where this is used."
3849 #. type: Labeled list
3850 #: ../disk-utils/mkfs.bfs.8.adoc:35
3852 #| msgid "*-f*, *--fast*"
3853 msgid "*-F*, *--fname* _name_"
3854 msgstr "*-f*, *--fast*"
3857 #: ../disk-utils/mkfs.bfs.8.adoc:37
3858 msgid "Specify the filesystem _name_. I have no idea if/where this is used."
3862 #: ../disk-utils/mkfs.bfs.8.adoc:43 ../term-utils/mesg.1.adoc:73
3863 msgid "Explain what is being done."
3866 #. type: Labeled list
3867 #: ../disk-utils/mkfs.bfs.8.adoc:44 ../text-utils/pg.1.adoc:39
3873 #: ../disk-utils/mkfs.bfs.8.adoc:52
3874 msgid "Option *-V* only works as *--version* when it is the only option."
3878 #: ../disk-utils/mkfs.bfs.8.adoc:56
3880 "The exit status returned by *mkfs.bfs* is 0 when all went well, and 1 when "
3881 "something went wrong."
3885 #: ../disk-utils/mkfs.bfs.8.adoc:60
3891 #: ../disk-utils/mkfs.cramfs.8.adoc:2
3893 msgid "mkfs.cramfs(8)"
3897 #: ../disk-utils/mkfs.cramfs.8.adoc:12
3898 msgid "mkfs.cramfs - make compressed ROM file system"
3902 #: ../disk-utils/mkfs.cramfs.8.adoc:16
3904 msgid "*mkfs.cramfs* [options] _directory file_\n"
3908 #: ../disk-utils/mkfs.cramfs.8.adoc:20
3910 "Files on cramfs file systems are zlib-compressed one page at a time to allow "
3911 "random read access. The metadata is not compressed, but is expressed in a "
3912 "terse representation that is more space-efficient than conventional file "
3917 #: ../disk-utils/mkfs.cramfs.8.adoc:22
3919 "The file system is intentionally read-only to simplify its design; random "
3920 "write access for compressed files is difficult to implement. cramfs ships "
3921 "with a utility (*mkcramfs*(8)) to pack files into new cramfs images."
3925 #: ../disk-utils/mkfs.cramfs.8.adoc:24
3926 msgid "File sizes are limited to less than 16 MB."
3930 #: ../disk-utils/mkfs.cramfs.8.adoc:26
3932 "Maximum file system size is a little under 272 MB. (The last file on the "
3933 "file system must begin before the 256 MB block, but can extend past it.)"
3937 #: ../disk-utils/mkfs.cramfs.8.adoc:27 ../misc-utils/hardlink.1.adoc:134
3938 #: ../misc-utils/kill.1.adoc:35 ../term-utils/agetty.8.adoc:35
3939 #: ../term-utils/mesg.1.adoc:59
3945 #: ../disk-utils/mkfs.cramfs.8.adoc:30
3947 "The _directory_ is simply the root of the directory tree that we want to "
3948 "generate a compressed filesystem out of."
3952 #: ../disk-utils/mkfs.cramfs.8.adoc:32
3954 "The _file_ will contain the cram file system, which later can be mounted."
3957 #. type: Labeled list
3958 #: ../disk-utils/mkfs.cramfs.8.adoc:38
3964 #: ../disk-utils/mkfs.cramfs.8.adoc:40
3966 "Treat all warnings as errors, which are reflected as command exit status."
3969 #. type: Labeled list
3970 #: ../disk-utils/mkfs.cramfs.8.adoc:41
3972 msgid "*-b* _blocksize_"
3976 #: ../disk-utils/mkfs.cramfs.8.adoc:43
3977 msgid "Use defined block size, which has to be divisible by page size."
3980 #. type: Labeled list
3981 #: ../disk-utils/mkfs.cramfs.8.adoc:44
3983 msgid "*-e* _edition_"
3987 #: ../disk-utils/mkfs.cramfs.8.adoc:46
3988 msgid "Use defined file system edition number in superblock."
3991 #. type: Labeled list
3992 #: ../disk-utils/mkfs.cramfs.8.adoc:47
3994 msgid "*-N* _big, little, host_"
3998 #: ../disk-utils/mkfs.cramfs.8.adoc:49
3999 msgid "Use defined endianness. Value defaults to _host_."
4002 #. type: Labeled list
4003 #: ../disk-utils/mkfs.cramfs.8.adoc:50
4009 #: ../disk-utils/mkfs.cramfs.8.adoc:52
4010 msgid "Insert a _file_ to cramfs file system."
4013 #. type: Labeled list
4014 #: ../disk-utils/mkfs.cramfs.8.adoc:53
4020 #: ../disk-utils/mkfs.cramfs.8.adoc:55
4021 msgid "Set name of the cramfs file system."
4024 #. type: Labeled list
4025 #: ../disk-utils/mkfs.cramfs.8.adoc:56 ../login-utils/login.1.adoc:41
4031 #: ../disk-utils/mkfs.cramfs.8.adoc:58
4032 msgid "Pad by 512 bytes for boot code."
4036 #: ../disk-utils/mkfs.cramfs.8.adoc:61
4038 "This option is ignored. Originally the *-s* turned on directory entry "
4042 #. type: Labeled list
4043 #: ../disk-utils/mkfs.cramfs.8.adoc:62
4049 #: ../disk-utils/mkfs.cramfs.8.adoc:64
4050 msgid "Make explicit holes."
4053 #. type: Labeled list
4054 #: ../disk-utils/mkfs.cramfs.8.adoc:65
4056 msgid "*-l*[=_mode_]"
4060 #: ../disk-utils/mkfs.cramfs.8.adoc:72
4062 "Use exclusive BSD lock for device or file it operates. The optional "
4063 "argument _mode_ can be _yes_, _no_ (or 1 and 0) or _nonblock_. If the "
4064 "_mode_ argument is omitted, it defaults to _\"yes\"_. This option "
4065 "overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to "
4066 "use any lock at all, but it's recommended to avoid collisions with udevd or "
4071 #: ../disk-utils/mkfs.cramfs.8.adoc:86
4074 "*fsck.cramfs*(8),\n"
4078 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
4079 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4080 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
4081 #. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
4082 #. May be distributed under the GNU General Public License
4084 #: ../disk-utils/mkfs.minix.8.adoc:9
4086 msgid "mkfs.minix(8)"
4090 #: ../disk-utils/mkfs.minix.8.adoc:19
4091 msgid "mkfs.minix - make a Minix filesystem"
4095 #: ../disk-utils/mkfs.minix.8.adoc:23
4097 msgid "*mkfs.minix* [options] _device_ [_size-in-blocks_]\n"
4101 #: ../disk-utils/mkfs.minix.8.adoc:27
4103 msgid "*mkfs.minix* creates a Linux MINIX filesystem on a device (usually a disk partition).\n"
4107 #: ../disk-utils/mkfs.minix.8.adoc:29
4108 msgid "The _device_ is usually of the following form:"
4111 #. type: delimited block .
4112 #: ../disk-utils/mkfs.minix.8.adoc:35
4115 "/dev/hda[1-8] (IDE disk 1)\n"
4116 "/dev/hdb[1-8] (IDE disk 2)\n"
4117 "/dev/sda[1-8] (SCSI disk 1)\n"
4118 "/dev/sdb[1-8] (SCSI disk 2)\n"
4122 #: ../disk-utils/mkfs.minix.8.adoc:38
4124 "The device may be a block device or an image file of one, but this is not "
4125 "enforced. Expect not much fun on a character device :-)."
4129 #: ../disk-utils/mkfs.minix.8.adoc:40
4131 "The _size-in-blocks_ parameter is the desired size of the file system, in "
4132 "blocks. It is present only for backwards compatibility. If omitted the size "
4133 "will be determined automatically. Only block counts strictly greater than 10 "
4134 "and strictly less than 65536 are allowed."
4137 #. type: Labeled list
4138 #: ../disk-utils/mkfs.minix.8.adoc:43 ../disk-utils/mkswap.8.adoc:41
4139 #: ../misc-utils/pipesz.1.adoc:58
4141 #| msgid "*-h*, *--help*"
4142 msgid "*-c*, *--check*"
4143 msgstr "*-h*, *--help*"
4146 #: ../disk-utils/mkfs.minix.8.adoc:45
4148 "Check the device for bad blocks before creating the filesystem. If any are "
4149 "found, the count is printed."
4152 #. type: Labeled list
4153 #: ../disk-utils/mkfs.minix.8.adoc:46
4155 msgid "*-n*, *--namelength* _length_"
4159 #: ../disk-utils/mkfs.minix.8.adoc:48
4161 "Specify the maximum length of filenames. Currently, the only allowable "
4162 "values are 14 and 30 for file system versions 1 and 2. Version 3 allows only "
4163 "value 60. The default is 30."
4166 #. type: Labeled list
4167 #: ../disk-utils/mkfs.minix.8.adoc:52
4169 msgid "*-i*, *--inodes* _number_"
4173 #: ../disk-utils/mkfs.minix.8.adoc:54
4174 msgid "Specify the number of inodes for the filesystem."
4177 #. type: Labeled list
4178 #: ../disk-utils/mkfs.minix.8.adoc:55
4180 msgid "*-l*, *--badblocks* _filename_"
4184 #: ../disk-utils/mkfs.minix.8.adoc:57
4186 "Read the list of bad blocks from _filename_. The file has one bad-block "
4187 "number per line. The count of bad blocks read is printed."
4190 #. type: Labeled list
4191 #: ../disk-utils/mkfs.minix.8.adoc:58 ../misc-utils/kill.1.adoc:45
4197 #: ../disk-utils/mkfs.minix.8.adoc:60
4198 msgid "Make a Minix version 1 filesystem. This is the default."
4201 #. type: Labeled list
4202 #: ../disk-utils/mkfs.minix.8.adoc:61
4204 #| msgid "*-P*, *--pty*"
4206 msgstr "*-P*, *--pty*"
4209 #: ../disk-utils/mkfs.minix.8.adoc:63
4210 msgid "Make a Minix version 2 filesystem."
4213 #. type: Labeled list
4214 #: ../disk-utils/mkfs.minix.8.adoc:64
4220 #: ../disk-utils/mkfs.minix.8.adoc:66
4221 msgid "Make a Minix version 3 filesystem."
4225 #: ../disk-utils/mkfs.minix.8.adoc:69
4226 msgid "The long option cannot be combined with other options."
4229 #. type: Labeled list
4230 #: ../disk-utils/mkfs.minix.8.adoc:72 ../disk-utils/mkswap.8.adoc:92
4231 #: ../misc-utils/wipefs.8.adoc:85
4233 msgid "LOCK_BLOCK_DEVICE=<mode>"
4237 #: ../disk-utils/mkfs.minix.8.adoc:78
4238 msgid "The exit status returned by *mkfs.minix* is one of the following:"
4241 #. type: Labeled list
4242 #: ../disk-utils/mkfs.minix.8.adoc:79 ../login-utils/lslogins.1.adoc:109
4243 #: ../misc-utils/lsblk.8.adoc:138 ../sys-utils/fstrim.8.adoc:76
4244 #: ../sys-utils/lsipc.1.adoc:88
4249 #. type: Labeled list
4250 #: ../disk-utils/mkfs.minix.8.adoc:81
4255 #. type: Labeled list
4256 #: ../disk-utils/mkfs.minix.8.adoc:83
4263 #: ../disk-utils/mkfs.minix.8.adoc:91
4278 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4279 #. May be distributed under the GNU General Public License
4281 #: ../disk-utils/mkswap.8.adoc:6
4287 #: ../disk-utils/mkswap.8.adoc:16
4288 msgid "mkswap - set up a Linux swap area"
4292 #: ../disk-utils/mkswap.8.adoc:20
4294 msgid "*mkswap* [options] _device_ [_size_]\n"
4298 #: ../disk-utils/mkswap.8.adoc:24
4300 msgid "*mkswap* sets up a Linux swap area on a device or in a file.\n"
4304 #: ../disk-utils/mkswap.8.adoc:26
4306 "The _device_ argument will usually be a disk partition (something like _/dev/"
4307 "sdb7_) but can also be a file. The Linux kernel does not look at partition "
4308 "IDs, but many installation scripts will assume that partitions of hex type "
4309 "82 (LINUX_SWAP) are meant to be swap partitions. (*Warning: Solaris also "
4310 "uses this type. Be careful not to kill your Solaris partitions.*)"
4314 #: ../disk-utils/mkswap.8.adoc:28
4316 "The _size_ parameter is superfluous but retained for backwards "
4317 "compatibility. (It specifies the desired size of the swap area in 1024-byte "
4318 "blocks. *mkswap* will use the entire partition or file if it is omitted. "
4319 "Specifying it is unwise - a typo may destroy your disk.)"
4323 #: ../disk-utils/mkswap.8.adoc:30
4325 "After creating the swap area, you need the *swapon*(8) command to start "
4326 "using it. Usually swap areas are listed in _/etc/fstab_ so that they can be "
4327 "taken into use at boot time by a *swapon -a* command in some boot script."
4331 #: ../disk-utils/mkswap.8.adoc:34
4333 "The swap header does not touch the first block. A boot loader or disk label "
4334 "can be there, but it is not a recommended setup. The recommended setup is to "
4335 "use a separate partition for a Linux swap area."
4339 #: ../disk-utils/mkswap.8.adoc:36
4341 msgid "*mkswap*, like many others mkfs-like utils, *erases the first partition block to make any previous filesystem invisible.*\n"
4345 #: ../disk-utils/mkswap.8.adoc:38
4347 "However, *mkswap* refuses to erase the first block on a device with a disk "
4348 "label (SUN, BSD, ...)."
4352 #: ../disk-utils/mkswap.8.adoc:43
4354 "Check the device (if it is a block device) for bad blocks before creating "
4355 "the swap area. If any bad blocks are found, the count is printed."
4359 #: ../disk-utils/mkswap.8.adoc:46
4361 "Go ahead even if the command is stupid. This allows the creation of a swap "
4362 "area larger than the file or partition it resides on."
4366 #: ../disk-utils/mkswap.8.adoc:48
4368 "Also, without this option, *mkswap* will refuse to erase the first block on "
4369 "a device with a partition table."
4372 #. type: Labeled list
4373 #: ../disk-utils/mkswap.8.adoc:49 ../disk-utils/sfdisk.8.adoc:201
4374 #: ../misc-utils/getopt.1.adoc:47 ../misc-utils/hardlink.1.adoc:84
4375 #: ../misc-utils/pipesz.1.adoc:61 ../misc-utils/uuidd.8.adoc:53
4376 #: ../misc-utils/wipefs.8.adoc:72 ../sys-utils/blkdiscard.8.adoc:43
4377 #: ../sys-utils/mountpoint.1.adoc:28 ../sys-utils/umount.8.adoc:99
4378 #: ../term-utils/script.1.adoc:115
4380 #| msgid "*-P*, *--pty*"
4381 msgid "*-q*, *--quiet*"
4382 msgstr "*-P*, *--pty*"
4385 #: ../disk-utils/mkswap.8.adoc:51
4386 msgid "Suppress output and warning messages."
4389 #. type: Labeled list
4390 #: ../disk-utils/mkswap.8.adoc:52 ../disk-utils/swaplabel.8.adoc:33
4391 #: ../misc-utils/blkid.8.adoc:74 ../sys-utils/mount.8.adoc:341
4393 #| msgid "*-s*, **--shell**=__shell__"
4394 msgid "*-L*, *--label* _label_"
4395 msgstr "*-s*, **--shell**=__shell__"
4398 #: ../disk-utils/mkswap.8.adoc:54
4399 msgid "Specify a _label_ for the device, to allow *swapon*(8) by label."
4402 #. type: Labeled list
4403 #: ../disk-utils/mkswap.8.adoc:58
4405 msgid "*-p*, *--pagesize* _size_"
4409 #: ../disk-utils/mkswap.8.adoc:60
4411 "Specify the page _size_ (in bytes) to use. This option is usually "
4412 "unnecessary; *mkswap* reads the size from the kernel."
4415 #. type: Labeled list
4416 #: ../disk-utils/mkswap.8.adoc:61 ../disk-utils/swaplabel.8.adoc:36
4418 msgid "*-U*, *--uuid* _UUID_"
4422 #: ../disk-utils/mkswap.8.adoc:65
4424 "Specify the _UUID_ to use. The default is to generate a UUID. The format of "
4425 "the UUID is a series of hex digits separated by hyphens, like this: "
4426 "\"c1b9d5a2-f162-11cf-9ece-0020afc76f16\". The UUID parameter may also be one "
4430 #. type: Labeled list
4431 #: ../disk-utils/mkswap.8.adoc:66
4437 #: ../disk-utils/mkswap.8.adoc:68
4438 msgid "clear the filesystem UUID"
4441 #. type: Labeled list
4442 #: ../disk-utils/mkswap.8.adoc:68
4448 #: ../disk-utils/mkswap.8.adoc:70
4449 msgid "generate a new randomly-generated UUID"
4452 #. type: Labeled list
4453 #: ../disk-utils/mkswap.8.adoc:70 ../sys-utils/dmesg.1.adoc:160
4459 #: ../disk-utils/mkswap.8.adoc:72
4460 msgid "generate a new time-based UUID"
4463 #. type: Labeled list
4464 #: ../disk-utils/mkswap.8.adoc:73
4466 msgid "*-e*, *--endianness* _ENDIANNESS_"
4470 #: ../disk-utils/mkswap.8.adoc:75
4472 "Specify the _ENDIANNESS_ to use, valid arguments are *native*, *little* or "
4473 "*big*. The default is *native*."
4476 #. type: Labeled list
4477 #: ../disk-utils/mkswap.8.adoc:76 ../misc-utils/fadvise.1.adoc:34
4478 #: ../misc-utils/wipefs.8.adoc:64 ../sys-utils/blkdiscard.8.adoc:34
4479 #: ../sys-utils/fallocate.1.adoc:56 ../sys-utils/losetup.8.adoc:74
4481 #| msgid "*-f*, *--fast*"
4482 msgid "*-o*, *--offset* _offset_"
4483 msgstr "*-f*, *--fast*"
4486 #: ../disk-utils/mkswap.8.adoc:78
4487 msgid "Specify the _offset_ to write the swap area to."
4490 #. type: Labeled list
4491 #: ../disk-utils/mkswap.8.adoc:79
4493 #| msgid "*-V*, *--version*"
4494 msgid "*-v*, *--swapversion 1*"
4495 msgstr "*-V*, *--version*"
4498 #: ../disk-utils/mkswap.8.adoc:81
4500 "Specify the swap-space version. (This option is currently pointless, as the "
4501 "old *-v 0* option has become obsolete and now only *-v 1* is supported. The "
4502 "kernel has not supported v0 swap-space format since 2.5.22 (June 2002). The "
4503 "new version v1 is supported since 2.1.117 (August 1998).)"
4506 #. type: Labeled list
4507 #: ../disk-utils/mkswap.8.adoc:82 ../misc-utils/findmnt.8.adoc:175
4508 #: ../misc-utils/kill.1.adoc:67 ../sys-utils/flock.1.adoc:83
4509 #: ../sys-utils/prlimit.1.adoc:55
4515 #: ../disk-utils/mkswap.8.adoc:84
4517 "Verbose execution. With this option *mkswap* will output more details about "
4518 "detected problems during swap area set up."
4521 #. type: Labeled list
4522 #: ../disk-utils/mkswap.8.adoc:89 ../disk-utils/partx.8.adoc:103
4523 #: ../disk-utils/swaplabel.8.adoc:41 ../misc-utils/findfs.8.adoc:60
4524 #: ../misc-utils/wipefs.8.adoc:82
4526 msgid "LIBBLKID_DEBUG=all"
4530 #: ../disk-utils/mkswap.8.adoc:98
4532 "The maximum useful size of a swap area depends on the architecture and the "
4537 #: ../disk-utils/mkswap.8.adoc:100
4539 "The maximum number of the pages that is possible to address by swap area "
4540 "header is 4294967295 (32-bit unsigned int). The remaining space on the swap "
4541 "device is ignored."
4545 #: ../disk-utils/mkswap.8.adoc:102
4547 "Presently, Linux allows 32 swap areas. The areas in use can be seen in the "
4548 "file _/proc/swaps_."
4552 #: ../disk-utils/mkswap.8.adoc:104
4554 msgid "*mkswap* refuses areas smaller than 10 pages.\n"
4558 #: ../disk-utils/mkswap.8.adoc:106
4560 "If you don't know the page size that your machine uses, you can look it up "
4561 "with *getconf PAGESIZE*."
4565 #: ../disk-utils/mkswap.8.adoc:108
4567 "To set up a swap file, it is necessary to create that file before "
4568 "initializing it with *mkswap*, e.g. using a command like"
4571 #. type: delimited block .
4572 #: ../disk-utils/mkswap.8.adoc:111
4574 msgid "# dd if=/dev/zero of=swapfile bs=1MiB count=$((8*1024))\n"
4578 #: ../disk-utils/mkswap.8.adoc:114
4579 msgid "to create 8GiB swapfile."
4583 #: ../disk-utils/mkswap.8.adoc:116
4585 "Please read notes from *swapon*(8) about *the swap file use restrictions* "
4586 "(holes, preallocation and copy-on-write issues)."
4590 #: ../disk-utils/mkswap.8.adoc:121
4597 #. partx.8 -- man page for partx
4598 #. Copyright 2007 Karel Zak <kzak@redhat.com>
4599 #. Copyright 2007 Red Hat, Inc.
4600 #. Copyright 2010 Davidlohr Bueso <dave@gnu.org>
4601 #. May be distributed under the GNU General Public License
4603 #: ../disk-utils/partx.8.adoc:9
4609 #: ../disk-utils/partx.8.adoc:19
4611 "partx - tell the kernel about the presence and numbering of on-disk "
4616 #: ../disk-utils/partx.8.adoc:23
4618 msgid "*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] [*-n* _M_:_N_] [-] _disk_\n"
4622 #: ../disk-utils/partx.8.adoc:25
4624 msgid "*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] _partition_ [_disk_]\n"
4628 #: ../disk-utils/partx.8.adoc:29
4630 "Given a device or disk-image, *partx* tries to parse the partition table and "
4631 "list its contents. It can also tell the kernel to add or remove partitions "
4632 "from its bookkeeping."
4636 #: ../disk-utils/partx.8.adoc:31
4638 "The _disk_ argument is optional when a _partition_ argument is provided. To "
4639 "force scanning a partition as if it were a whole disk (for example to list "
4640 "nested subpartitions), use the argument \"-\" (hyphen-minus). For example:"
4643 #. type: delimited block _
4644 #: ../disk-utils/partx.8.adoc:34
4645 msgid "partx --show - /dev/sda3"
4649 #: ../disk-utils/partx.8.adoc:37
4650 msgid "This will see sda3 as a whole-disk rather than as a partition."
4654 #: ../disk-utils/partx.8.adoc:39
4656 msgid "*partx is not an fdisk program* - adding and removing partitions does not change the disk, it just tells the kernel about the presence and numbering of on-disk partitions.\n"
4659 #. type: Labeled list
4660 #: ../disk-utils/partx.8.adoc:42
4662 #| msgid "*-f*, *--fast*"
4663 msgid "*-a*, *--add*"
4664 msgstr "*-f*, *--fast*"
4667 #: ../disk-utils/partx.8.adoc:44
4668 msgid "Add the specified partitions, or read the disk and add all partitions."
4671 #. type: Labeled list
4672 #: ../disk-utils/partx.8.adoc:45 ../misc-utils/fincore.1.adoc:34
4673 #: ../misc-utils/findmnt.8.adoc:42 ../misc-utils/lsblk.8.adoc:41
4674 #: ../misc-utils/lslocks.8.adoc:34 ../sys-utils/ipcs.1.adoc:69
4675 #: ../sys-utils/lsipc.1.adoc:68 ../sys-utils/lsmem.1.adoc:36
4677 #| msgid "*-P*, *--pty*"
4678 msgid "*-b*, *--bytes*"
4679 msgstr "*-P*, *--pty*"
4681 #. type: Labeled list
4682 #: ../disk-utils/partx.8.adoc:48
4684 #| msgid "*-h*, *--help*"
4685 msgid "*-d*, *--delete*"
4686 msgstr "*-h*, *--help*"
4689 #: ../disk-utils/partx.8.adoc:50
4691 "Delete the specified partitions or all partitions. It is not error to remove "
4692 "non-existing partitions, so this option is possible to use together with "
4693 "large *--nr* ranges without care about the current partitions set on the "
4697 #. type: Labeled list
4698 #: ../disk-utils/partx.8.adoc:51
4700 #| msgid "*-V*, *--version*"
4701 msgid "*-g*, *--noheadings*"
4702 msgstr "*-V*, *--version*"
4705 #: ../disk-utils/partx.8.adoc:53
4706 msgid "Do not print a header line with *--show* or *--raw*."
4710 #: ../disk-utils/partx.8.adoc:56
4712 "List the partitions. Note that all numbers are in 512-byte sectors. This "
4713 "output format is DEPRECATED in favour of *--show*. Do not use it in newly "
4717 #. type: Labeled list
4718 #: ../disk-utils/partx.8.adoc:57
4720 msgid "*-n*, *--nr* __M__**:**_N_"
4724 #: ../disk-utils/partx.8.adoc:59
4726 "Specify the range of partitions. For backward compatibility also the format "
4727 "__M__**-**_N_ is supported. The range may contain negative numbers, for "
4728 "example *--nr -1:-1* means the last partition, and *--nr -2:-1* means the "
4729 "last two partitions. Supported range specifications are:"
4732 #. type: Labeled list
4733 #: ../disk-utils/partx.8.adoc:60
4739 #: ../disk-utils/partx.8.adoc:62
4740 msgid "Specifies just one partition (e.g. *--nr 3*)."
4743 #. type: Labeled list
4744 #: ../disk-utils/partx.8.adoc:62
4750 #: ../disk-utils/partx.8.adoc:64
4751 msgid "Specifies the lower limit only (e.g. *--nr 2:*)."
4754 #. type: Labeled list
4755 #: ../disk-utils/partx.8.adoc:64
4761 #: ../disk-utils/partx.8.adoc:66
4762 msgid "Specifies the upper limit only (e.g. *--nr :4*)."
4765 #. type: Labeled list
4766 #: ../disk-utils/partx.8.adoc:66
4768 msgid "__M__**:**_N_"
4772 #: ../disk-utils/partx.8.adoc:68
4773 msgid "Specifies the lower and upper limits (e.g. *--nr 2:4*)."
4777 #: ../disk-utils/partx.8.adoc:71
4779 "Define the output columns to use for *--show*, *--pairs* and *--raw* output. "
4780 "If no output arrangement is specified, then a default set is used. Use *--"
4781 "help* to get _list_ of all supported columns. This option cannot be combined "
4782 "with the *--add*, *--delete*, *--update* or *--list* options."
4785 #. type: Labeled list
4786 #: ../disk-utils/partx.8.adoc:72 ../login-utils/lslogins.1.adoc:72
4787 #: ../misc-utils/fincore.1.adoc:41 ../misc-utils/findmnt.8.adoc:103
4788 #: ../misc-utils/lslocks.8.adoc:52 ../sys-utils/losetup.8.adoc:107
4789 #: ../sys-utils/lscpu.1.adoc:92 ../sys-utils/lsmem.1.adoc:48
4790 #: ../sys-utils/lsns.8.adoc:48 ../sys-utils/rfkill.8.adoc:36
4791 #: ../sys-utils/swapon.8.adoc:74 ../sys-utils/zramctl.8.adoc:55
4793 msgid "*--output-all*"
4797 #: ../disk-utils/partx.8.adoc:74 ../misc-utils/fincore.1.adoc:43
4798 #: ../misc-utils/lsblk.8.adoc:95 ../misc-utils/lslocks.8.adoc:54
4799 #: ../sys-utils/losetup.8.adoc:109 ../sys-utils/lsmem.1.adoc:50
4800 #: ../sys-utils/lsns.8.adoc:50 ../sys-utils/rfkill.8.adoc:38
4801 #: ../sys-utils/swapon.8.adoc:76 ../sys-utils/zramctl.8.adoc:57
4802 msgid "Output all available columns."
4805 #. type: Labeled list
4806 #: ../disk-utils/partx.8.adoc:75 ../misc-utils/findmnt.8.adoc:106
4807 #: ../misc-utils/lsblk.8.adoc:96 ../sys-utils/lsirq.1.adoc:37
4808 #: ../sys-utils/lsmem.1.adoc:51
4810 #| msgid "*-P*, *--pty*"
4811 msgid "*-P*, *--pairs*"
4812 msgstr "*-P*, *--pty*"
4815 #: ../disk-utils/partx.8.adoc:77
4816 msgid "List the partitions using the KEY=\"value\" format."
4819 #. type: Labeled list
4820 #: ../disk-utils/partx.8.adoc:78 ../login-utils/lslogins.1.adoc:78
4821 #: ../misc-utils/fincore.1.adoc:44 ../misc-utils/findmnt.8.adoc:134
4822 #: ../misc-utils/lsblk.8.adoc:102 ../misc-utils/lsfd.1.adoc:57
4823 #: ../misc-utils/lslocks.8.adoc:58 ../misc-utils/uuidparse.1.adoc:59
4824 #: ../sys-utils/dmesg.1.adoc:110 ../sys-utils/lsipc.1.adoc:71
4825 #: ../sys-utils/lsmem.1.adoc:54 ../sys-utils/lsns.8.adoc:58
4826 #: ../sys-utils/rfkill.8.adoc:39 ../sys-utils/wdctl.8.adoc:54
4828 #| msgid "*-f*, *--fast*"
4829 msgid "*-r*, *--raw*"
4830 msgstr "*-f*, *--fast*"
4833 #: ../disk-utils/partx.8.adoc:80
4834 msgid "List the partitions using the raw output format."
4837 #. type: Labeled list
4838 #: ../disk-utils/partx.8.adoc:81
4840 #| msgid "*-h*, *--help*"
4841 msgid "*-s*, *--show*"
4842 msgstr "*-h*, *--help*"
4845 #: ../disk-utils/partx.8.adoc:83
4847 "List the partitions. The output columns can be selected and rearranged with "
4848 "the *--output* option. All numbers (except SIZE) are in 512-byte sectors."
4852 #: ../disk-utils/partx.8.adoc:86
4853 msgid "Specify the partition table type."
4856 #. type: Labeled list
4857 #: ../disk-utils/partx.8.adoc:87
4859 msgid "*--list-types*"
4863 #: ../disk-utils/partx.8.adoc:89
4864 msgid "List supported partition types and exit."
4867 #. type: Labeled list
4868 #: ../disk-utils/partx.8.adoc:90
4870 #| msgid "*-P*, *--pty*"
4871 msgid "*-u*, *--update*"
4872 msgstr "*-P*, *--pty*"
4875 #: ../disk-utils/partx.8.adoc:92
4876 msgid "Update the specified partitions."
4879 #. type: Labeled list
4880 #: ../disk-utils/partx.8.adoc:93
4882 msgid "*-S*, *--sector-size* _size_"
4886 #: ../disk-utils/partx.8.adoc:95
4887 msgid "Overwrite default sector size."
4891 #: ../disk-utils/partx.8.adoc:98 ../sys-utils/losetup.8.adoc:100
4892 #: ../sys-utils/mount.8.adoc:459 ../sys-utils/prlimit.1.adoc:57
4893 #: ../sys-utils/umount.8.adoc:113
4894 msgid "Verbose mode."
4898 #: ../disk-utils/partx.8.adoc:106 ../lib/terminal-colors.d.5.adoc:142
4899 #: ../misc-utils/uuidd.8.adoc:74 ../sys-utils/chmem.8.adoc:67
4900 #: ../sys-utils/losetup.8.adoc:144 ../sys-utils/pivot_root.8.adoc:37
4901 #: ../sys-utils/readprofile.8.adoc:77 ../sys-utils/rfkill.8.adoc:64
4902 #: ../sys-utils/setarch.8.adoc:80 ../sys-utils/zramctl.8.adoc:83
4903 #: ../term-utils/agetty.8.adoc:194
4908 #. type: Labeled list
4909 #: ../disk-utils/partx.8.adoc:108
4911 msgid "partx --show /dev/sdb3"
4914 #. type: Labeled list
4915 #: ../disk-utils/partx.8.adoc:109
4917 msgid "partx --show --nr 3 /dev/sdb"
4920 #. type: Labeled list
4921 #: ../disk-utils/partx.8.adoc:110
4923 msgid "partx --show /dev/sdb3 /dev/sdb"
4927 #: ../disk-utils/partx.8.adoc:112
4928 msgid "All three commands list partition 3 of _/dev/sdb_."
4931 #. type: Labeled list
4932 #: ../disk-utils/partx.8.adoc:113
4934 msgid "partx --show - /dev/sdb3"
4938 #: ../disk-utils/partx.8.adoc:115
4940 "Lists all subpartitions on _/dev/sdb3_ (the device is used as whole-disk)."
4943 #. type: Labeled list
4944 #: ../disk-utils/partx.8.adoc:116
4946 msgid "partx -o START -g --nr 5 /dev/sdb"
4950 #: ../disk-utils/partx.8.adoc:118
4951 msgid "Prints the start sector of partition 5 on _/dev/sdb_ without header."
4954 #. type: Labeled list
4955 #: ../disk-utils/partx.8.adoc:119
4957 msgid "partx -o SECTORS,SIZE /dev/sda5 /dev/sda"
4961 #: ../disk-utils/partx.8.adoc:121
4963 "Lists the length in sectors and human-readable size of partition 5 on _/dev/"
4967 #. type: Labeled list
4968 #: ../disk-utils/partx.8.adoc:122
4970 msgid "partx --add --nr 3:5 /dev/sdd"
4974 #: ../disk-utils/partx.8.adoc:124
4975 msgid "Adds all available partitions from 3 to 5 (inclusive) on _/dev/sdd_."
4978 #. type: Labeled list
4979 #: ../disk-utils/partx.8.adoc:125
4981 msgid "partx -d --nr :-1 /dev/sdd"
4985 #: ../disk-utils/partx.8.adoc:127
4986 msgid "Removes the last partition on _/dev/sdd_."
4990 #: ../disk-utils/partx.8.adoc:132
4991 msgid "mailto:dave@gnu.org[Davidlohr Bueso], mailto:kzak@redhat.com[Karel Zak]"
4995 #: ../disk-utils/partx.8.adoc:134
4997 "The original version was written by mailto:aeb@cwi.nl[Andries E. Brouwer]"
5001 #: ../disk-utils/partx.8.adoc:142
5012 #: ../disk-utils/raw.8.adoc:2
5018 #: ../disk-utils/raw.8.adoc:12
5019 msgid "raw - bind a Linux raw character device"
5023 #: ../disk-utils/raw.8.adoc:16
5025 msgid "*raw* _/dev/raw/raw<N>_ _<major>_ _<minor>_\n"
5029 #: ../disk-utils/raw.8.adoc:18
5031 msgid "*raw* _/dev/raw/raw<N>_ _/dev/<blockdev>_\n"
5035 #: ../disk-utils/raw.8.adoc:20
5037 msgid "*raw* *-q* _/dev/raw/raw<N>_\n"
5041 #: ../disk-utils/raw.8.adoc:22
5043 msgid "*raw* *-qa*\n"
5047 #: ../disk-utils/raw.8.adoc:26
5049 msgid "*raw* is used to bind a Linux raw character device to a block device. Any block device may be used: at the time of binding, the device driver does not even have to be accessible (it may be loaded on demand as a kernel module later).\n"
5053 #: ../disk-utils/raw.8.adoc:28
5055 msgid "*raw* is used in two modes: it either sets raw device bindings, or it queries existing bindings. When setting a raw device, _/dev/raw/raw<N>_ is the device name of an existing raw device node in the filesystem. The block device to which it is to be bound can be specified either in terms of its _major_ and _minor_ device numbers, or as a path name _/dev/<blockdev>_ to an existing block device file.\n"
5059 #: ../disk-utils/raw.8.adoc:30
5061 "The bindings already in existence can be queried with the *-q* option, which "
5062 "is used either with a raw device filename to query that one device, or with "
5063 "the *-a* option to query all bound raw devices."
5067 #: ../disk-utils/raw.8.adoc:32
5068 msgid "Unbinding can be done by specifying major and minor 0."
5072 #: ../disk-utils/raw.8.adoc:34
5074 "Once bound to a block device, a raw device can be opened, read and written, "
5075 "just like the block device it is bound to. However, the raw device does not "
5076 "behave exactly like the block device. In particular, access to the raw "
5077 "device bypasses the kernel's block buffer cache entirely: all I/O is done "
5078 "directly to and from the address space of the process performing the I/O. If "
5079 "the underlying block device driver can support DMA, then no data copying at "
5080 "all is required to complete the I/O."
5084 #: ../disk-utils/raw.8.adoc:36
5086 "Because raw I/O involves direct hardware access to a process's memory, a few "
5087 "extra restrictions must be observed. All I/Os must be correctly aligned in "
5088 "memory and on disk: they must start at a sector offset on disk, they must be "
5089 "an exact number of sectors long, and the data buffer in virtual memory must "
5090 "also be aligned to a multiple of the sector size. The sector size is 512 "
5091 "bytes for most devices."
5094 #. type: Labeled list
5095 #: ../disk-utils/raw.8.adoc:39
5097 #| msgid "*-P*, *--pty*"
5098 msgid "*-q*, *--query*"
5099 msgstr "*-P*, *--pty*"
5102 #: ../disk-utils/raw.8.adoc:41
5104 "Set query mode. *raw* will query an existing binding instead of setting a "
5108 #. type: Labeled list
5109 #: ../disk-utils/raw.8.adoc:42 ../misc-utils/kill.1.adoc:61
5110 #: ../misc-utils/lsblk.8.adoc:38 ../misc-utils/rename.1.adoc:34
5111 #: ../misc-utils/wipefs.8.adoc:40 ../sys-utils/ipcs.1.adoc:43
5112 #: ../sys-utils/losetup.8.adoc:53 ../sys-utils/lscpu.1.adoc:33
5113 #: ../sys-utils/lsmem.1.adoc:33 ../sys-utils/mount.8.adoc:307
5114 #: ../sys-utils/nsenter.1.adoc:53 ../sys-utils/readprofile.8.adoc:27
5115 #: ../sys-utils/swapon.8.adoc:31 ../sys-utils/umount.8.adoc:54
5117 #| msgid "*-h*, *--help*"
5118 msgid "*-a*, *--all*"
5119 msgstr "*-h*, *--help*"
5122 #: ../disk-utils/raw.8.adoc:44
5123 msgid "With *-q*, specify that all bound raw devices should be queried."
5127 #: ../disk-utils/raw.8.adoc:50
5129 "Rather than using raw devices applications should prefer *open*(2) devices, "
5130 "such as _/dev/sda1_, with the *O_DIRECT* flag."
5134 #: ../disk-utils/raw.8.adoc:54
5136 "The Linux *dd*(1) command should be used without the *bs=* option, or the "
5137 "blocksize needs to be a multiple of the sector size of the device (512 bytes "
5138 "usually), otherwise it will fail with \"Invalid Argument\" messages "
5143 #: ../disk-utils/raw.8.adoc:56
5145 "Raw I/O devices do not maintain cache coherency with the Linux block device "
5146 "buffer cache. If you use raw I/O to overwrite data already in the buffer "
5147 "cache, the buffer cache will no longer correspond to the contents of the "
5148 "actual storage device underneath. This is deliberate, but is regarded as "
5149 "either a bug or a feature, depending on who you ask!"
5153 #: ../disk-utils/raw.8.adoc:60
5154 msgid "mailto:sct@redhat.com[Stephen Tweedie]"
5157 #. resizepart.8 -- man page for resizepart
5158 #. Copyright 2012 Vivek Goyal <vgoyal@redhat.com>
5159 #. Copyright 2012 Red Hat, Inc.
5160 #. May be distributed under the GNU General Public License
5162 #: ../disk-utils/resizepart.8.adoc:8
5164 msgid "resizepart(8)"
5168 #: ../disk-utils/resizepart.8.adoc:18
5169 msgid "resizepart - tell the kernel about the new size of a partition"
5173 #: ../disk-utils/resizepart.8.adoc:22
5175 msgid "*resizepart* _device partition length_\n"
5179 #: ../disk-utils/resizepart.8.adoc:26
5181 msgid "*resizepart* tells the Linux kernel about the new size of the specified partition. The command is a simple wrapper around the \"resize partition\" ioctl.\n"
5185 #: ../disk-utils/resizepart.8.adoc:39
5186 msgid "The new length of the partition (in 512-byte sectors)."
5190 #: ../disk-utils/resizepart.8.adoc:50
5203 #. sfdisk.8 -- man page for sfdisk
5204 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
5205 #. Permission is granted to make and distribute verbatim copies of this
5206 #. manual provided the copyright notice and this permission notice are
5207 #. preserved on all copies.
5208 #. Permission is granted to copy and distribute modified versions of this
5209 #. manual under the conditions for verbatim copying, provided that the
5210 #. entire resulting derived work is distributed under the terms of a
5211 #. permission notice identical to this one.
5213 #: ../disk-utils/sfdisk.8.adoc:15
5219 #: ../disk-utils/sfdisk.8.adoc:27
5220 msgid "sfdisk - display or manipulate a disk partition table"
5224 #: ../disk-utils/sfdisk.8.adoc:31
5226 msgid "*sfdisk* [options] _device_ [*-N* _partition-number_]\n"
5230 #: ../disk-utils/sfdisk.8.adoc:33
5232 msgid "*sfdisk* [options] _command_\n"
5236 #: ../disk-utils/sfdisk.8.adoc:37
5238 msgid "*sfdisk* is a script-oriented tool for partitioning any block device. It runs in interactive mode if executed on a terminal (stdin refers to a terminal).\n"
5242 #: ../disk-utils/sfdisk.8.adoc:39
5244 "Since version 2.26 *sfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
5245 "labels, but no longer provides any functionality for CHS (Cylinder-Head-"
5246 "Sector) addressing. CHS has never been important for Linux, and this "
5247 "addressing concept does not make any sense for new devices."
5251 #: ../disk-utils/sfdisk.8.adoc:41
5253 msgid "*sfdisk* protects the first disk sector when create a new disk label. The option *--wipe always* disables this protection. Note that *fdisk*(8) and *cfdisk*(8) completely erase this area by default.\n"
5257 #: ../disk-utils/sfdisk.8.adoc:43
5259 msgid "*sfdisk* (since version 2.26) *aligns the start and end of partitions* to block-device I/O limits when relative sizes are specified, when the default values are used or when multiplicative suffixes (e.g., MiB) are used for sizes. It is possible that partition size will be optimized (reduced or enlarged) due to alignment if the start offset is specified exactly in sectors and partition size relative or by multiplicative suffixes.\n"
5263 #: ../disk-utils/sfdisk.8.adoc:45
5265 "The recommended way is not to specify start offsets at all and specify "
5266 "partition size in MiB, GiB (or so). In this case *sfdisk* aligns all "
5267 "partitions to block-device I/O limits (or when I/O limits are too small then "
5268 "to megabyte boundary to keep disk layout portable). If this default "
5269 "behaviour is unwanted (usually for very small partitions) then specify "
5270 "offsets and sizes in sectors. In this case *sfdisk* entirely follows "
5271 "specified numbers without any optimization."
5275 #: ../disk-utils/sfdisk.8.adoc:47
5277 msgid "*sfdisk* does not create the standard system partitions for SGI and SUN disk labels like *fdisk*(8) does. It is necessary to explicitly create all partitions including whole-disk system partitions.\n"
5281 #: ../disk-utils/sfdisk.8.adoc:49
5283 msgid "*sfdisk* uses *BLKRRPART* (reread partition table) ioctl to make sure that the device is not used by system or other tools (see also *--no-reread*). It's possible that this feature or another *sfdisk* activity races with *systemd-udevd*(8). The recommended way how to avoid possible collisions is to use *--lock* option. The exclusive lock will cause *systemd-udevd* to skip the event handling on the device.\n"
5287 #: ../disk-utils/sfdisk.8.adoc:51
5289 "The *sfdisk* prompt is only a hint for users and a displayed partition "
5290 "number does not mean that the same partition table entry will be created (if "
5291 "*-N* not specified), especially for tables with gaps."
5295 #: ../disk-utils/sfdisk.8.adoc:55
5296 msgid "The commands are mutually exclusive."
5299 #. type: Labeled list
5300 #: ../disk-utils/sfdisk.8.adoc:56
5302 msgid "[*-N* _partition-number_] __device__"
5306 #: ../disk-utils/sfdisk.8.adoc:58
5308 "The default *sfdisk* command is to read the specification for the desired "
5309 "partitioning of _device_ from standard input, and then create a partition "
5310 "table according to the specification. See below for the description of the "
5311 "input format. If standard input is a terminal, then *sfdisk* starts an "
5312 "interactive session."
5316 #: ../disk-utils/sfdisk.8.adoc:60
5318 "If the option *-N* is specified, then the changes are applied to the "
5319 "partition addressed by _partition-number_. The unspecified fields of the "
5320 "partition are not modified."
5324 #: ../disk-utils/sfdisk.8.adoc:62
5326 "Note that it's possible to address an unused partition with *-N*. For "
5327 "example, an MBR always contains 4 partitions, but the number of used "
5328 "partitions may be smaller. In this case *sfdisk* follows the default values "
5329 "from the partition table and does not use built-in defaults for the unused "
5330 "partition given with *-N*. See also *--append*."
5333 #. type: Labeled list
5334 #: ../disk-utils/sfdisk.8.adoc:63
5336 msgid "*-A*, *--activate* __device__ [__partition-number__...]"
5340 #: ../disk-utils/sfdisk.8.adoc:65
5342 "Switch on the bootable flag for the specified partitions and switch off the "
5343 "bootable flag on all unspecified partitions. The special placeholder '-' may "
5344 "be used instead of the partition numbers to switch off the bootable flag on "
5349 #: ../disk-utils/sfdisk.8.adoc:67
5351 "The activation command is supported for MBR and PMBR only. If a GPT label is "
5352 "detected, then *sfdisk* prints warning and automatically enters PMBR."
5356 #: ../disk-utils/sfdisk.8.adoc:69
5358 "If no _partition-number_ is specified, then list the partitions with an "
5362 #. type: Labeled list
5363 #: ../disk-utils/sfdisk.8.adoc:70
5365 msgid "*--backup-pt-sectors* _device_"
5369 #: ../disk-utils/sfdisk.8.adoc:72
5371 "Back up the current partition table sectors in binary format and exit. See "
5372 "the *BACKING UP THE PARTITION TABLE* section."
5375 #. type: Labeled list
5376 #: ../disk-utils/sfdisk.8.adoc:73
5378 msgid "*--delete* _device_ [__partition-number__...]"
5382 #: ../disk-utils/sfdisk.8.adoc:75
5383 msgid "Delete all or the specified partitions."
5386 #. type: Labeled list
5387 #: ../disk-utils/sfdisk.8.adoc:76
5389 msgid "*-d*, *--dump* _device_"
5393 #: ../disk-utils/sfdisk.8.adoc:78
5395 "Dump the partitions of a device in a format that is usable as input to "
5396 "*sfdisk*. See the *BACKING UP THE PARTITION TABLE* section."
5399 #. type: Labeled list
5400 #: ../disk-utils/sfdisk.8.adoc:79
5402 msgid "*-g*, *--show-geometry* [__device__...]"
5406 #: ../disk-utils/sfdisk.8.adoc:81
5408 "List the geometry of all or the specified devices. For backward "
5409 "compatibility the deprecated option *--show-pt-geometry* have the same "
5410 "meaning as this one."
5413 #. type: Labeled list
5414 #: ../disk-utils/sfdisk.8.adoc:82
5416 #| msgid "*-V*, *--version*"
5417 msgid "*-J*, *--json* _device_"
5418 msgstr "*-V*, *--version*"
5421 #: ../disk-utils/sfdisk.8.adoc:84
5423 "Dump the partitions of a device in JSON format. Note that *sfdisk* is not "
5424 "able to use JSON as input format."
5427 #. type: Labeled list
5428 #: ../disk-utils/sfdisk.8.adoc:85
5430 msgid "*-l*, *--list* [__device__...]"
5434 #: ../disk-utils/sfdisk.8.adoc:87
5436 "List the partitions of all or the specified devices. This command can be "
5437 "used together with *--verify*."
5440 #. type: Labeled list
5441 #: ../disk-utils/sfdisk.8.adoc:88
5443 msgid "*-F*, *--list-free* [__device__...]"
5447 #: ../disk-utils/sfdisk.8.adoc:90
5448 msgid "List the free unpartitioned areas on all or the specified devices."
5451 #. type: Labeled list
5452 #: ../disk-utils/sfdisk.8.adoc:91
5454 msgid "*--part-attrs* _device partition-number_ [__attributes__]"
5458 #: ../disk-utils/sfdisk.8.adoc:93
5460 "Change the GPT partition attribute bits. If _attributes_ is not specified, "
5461 "then print the current partition settings. The _attributes_ argument is a "
5462 "comma- or space-delimited list of bits numbers or bit names. For example, "
5463 "the string \"RequiredPartition,50,51\" sets three bits. The currently "
5464 "supported attribute bits are:"
5467 #. type: Labeled list
5468 #: ../disk-utils/sfdisk.8.adoc:94
5470 msgid "*Bit 0 (RequiredPartition)*"
5474 #: ../disk-utils/sfdisk.8.adoc:96
5476 "If this bit is set, the partition is required for the platform to function. "
5477 "The creator of the partition indicates that deletion or modification of the "
5478 "contents can result in loss of platform features or failure for the platform "
5479 "to boot or operate. The system cannot function normally if this partition is "
5480 "removed, and it should be considered part of the hardware of the system."
5483 #. type: Labeled list
5484 #: ../disk-utils/sfdisk.8.adoc:96
5486 msgid "*Bit 1 (NoBlockIOProtocol)*"
5490 #: ../disk-utils/sfdisk.8.adoc:98
5492 "EFI firmware should ignore the content of the partition and not try to read "
5496 #. type: Labeled list
5497 #: ../disk-utils/sfdisk.8.adoc:98
5499 msgid "*Bit 2 (LegacyBIOSBootable)*"
5503 #: ../disk-utils/sfdisk.8.adoc:100
5504 msgid "The partition may be bootable by legacy BIOS firmware."
5507 #. type: Labeled list
5508 #: ../disk-utils/sfdisk.8.adoc:100
5514 #: ../disk-utils/sfdisk.8.adoc:102
5516 "Undefined and must be zero. Reserved for expansion by future versions of the "
5517 "UEFI specification."
5520 #. type: Labeled list
5521 #: ../disk-utils/sfdisk.8.adoc:102
5523 msgid "*Bits 48-63*"
5527 #: ../disk-utils/sfdisk.8.adoc:104
5529 "Reserved for GUID specific use. The use of these bits will vary depending on "
5530 "the partition type. For example Microsoft uses bit 60 to indicate read-only, "
5531 "61 for shadow copy of another partition, 62 for hidden partitions and 63 to "
5532 "disable automount."
5535 #. type: Labeled list
5536 #: ../disk-utils/sfdisk.8.adoc:105
5538 msgid "*--part-label* _device partition-number_ [__label__]"
5542 #: ../disk-utils/sfdisk.8.adoc:107
5544 "Change the GPT partition name (label). If _label_ is not specified, then "
5545 "print the current partition label."
5548 #. type: Labeled list
5549 #: ../disk-utils/sfdisk.8.adoc:108
5551 msgid "*--part-type* _device partition-number_ [__type__]"
5555 #: ../disk-utils/sfdisk.8.adoc:110
5557 "Change the partition type. If _type_ is not specified, then print the "
5558 "current partition type."
5562 #: ../disk-utils/sfdisk.8.adoc:112
5564 "The _type_ argument is hexadecimal for MBR, GUID for GPT, type alias (e.g. "
5565 "\"linux\") or type shortcut (e.g. 'L'). For backward compatibility the "
5566 "options *-c* and *--id* have the same meaning as this one."
5569 #. type: Labeled list
5570 #: ../disk-utils/sfdisk.8.adoc:113
5572 msgid "*--part-uuid* _device partition-number_ [__uuid__]"
5576 #: ../disk-utils/sfdisk.8.adoc:115
5578 "Change the GPT partition UUID. If _uuid_ is not specified, then print the "
5579 "current partition UUID."
5582 #. type: Labeled list
5583 #: ../disk-utils/sfdisk.8.adoc:116
5585 msgid "*--disk-id* _device_ [__id__]"
5589 #: ../disk-utils/sfdisk.8.adoc:118
5591 "Change the disk identifier. If _id_ is not specified, then print the current "
5592 "identifier. The identifier is UUID for GPT or unsigned integer for MBR."
5595 #. type: Labeled list
5596 #: ../disk-utils/sfdisk.8.adoc:119
5598 msgid "*-r*, *--reorder* _device_"
5602 #: ../disk-utils/sfdisk.8.adoc:121
5603 msgid "Renumber the partitions, ordering them by their start offset."
5606 #. type: Labeled list
5607 #: ../disk-utils/sfdisk.8.adoc:122
5609 msgid "*-s*, *--show-size* [__device__...]"
5613 #: ../disk-utils/sfdisk.8.adoc:124
5615 "List the sizes of all or the specified devices in units of 1024 byte size. "
5616 "This command is DEPRECATED in favour of *blockdev*(8)."
5619 #. type: Labeled list
5620 #: ../disk-utils/sfdisk.8.adoc:125
5622 #| msgid "*-P*, *--pty*"
5623 msgid "*-T*, *--list-types*"
5624 msgstr "*-P*, *--pty*"
5627 #: ../disk-utils/sfdisk.8.adoc:127
5629 "Print all supported types for the current disk label or the label specified "
5633 #. type: Labeled list
5634 #: ../disk-utils/sfdisk.8.adoc:128
5636 msgid "*-V*, *--verify* [__device__...]"
5640 #: ../disk-utils/sfdisk.8.adoc:130
5641 msgid "Test whether the partition table and partitions seem correct."
5644 #. type: Labeled list
5645 #: ../disk-utils/sfdisk.8.adoc:131
5647 msgid "*--relocate* _oper_ _device_"
5651 #: ../disk-utils/sfdisk.8.adoc:133
5653 "Relocate partition table header. This command is currently supported for GPT "
5654 "header only. The argument _oper_ can be:"
5657 #. type: Labeled list
5658 #: ../disk-utils/sfdisk.8.adoc:134
5660 msgid "*gpt-bak-std*"
5664 #: ../disk-utils/sfdisk.8.adoc:136
5666 "Move GPT backup header to the standard location at the end of the device."
5669 #. type: Labeled list
5670 #: ../disk-utils/sfdisk.8.adoc:136
5672 msgid "*gpt-bak-mini*"
5676 #: ../disk-utils/sfdisk.8.adoc:138
5678 "Move GPT backup header behind the last partition. Note that UEFI standard "
5679 "requires the backup header at the end of the device and partitioning tools "
5680 "can automatically relocate the header to follow the standard."
5683 #. type: Labeled list
5684 #: ../disk-utils/sfdisk.8.adoc:141 ../term-utils/script.1.adoc:66
5686 #| msgid "*-P*, *--pty*"
5687 msgid "*-a*, *--append*"
5688 msgstr "*-P*, *--pty*"
5691 #: ../disk-utils/sfdisk.8.adoc:143
5693 "Don't create a new partition table, but only append the specified partitions."
5697 #: ../disk-utils/sfdisk.8.adoc:145
5699 "Note that unused partition maybe be re-used in this case although it is not "
5700 "the last partition in the partition table. See also *-N* to specify entry in "
5701 "the partition table."
5704 #. type: Labeled list
5705 #: ../disk-utils/sfdisk.8.adoc:146 ../misc-utils/wipefs.8.adoc:43
5707 #| msgid "*-P*, *--pty*"
5708 msgid "*-b*, *--backup*"
5709 msgstr "*-P*, *--pty*"
5712 #: ../disk-utils/sfdisk.8.adoc:148
5714 "Back up the current partition table sectors before starting the "
5715 "partitioning. The default backup file name is _~/sfdisk-<device>-<offset>."
5716 "bak_; to use another name see option *-O*, *--backup-file*. See section "
5717 "*BACKING UP THE PARTITION TABLE* for more details."
5720 #. type: Labeled list
5721 #: ../disk-utils/sfdisk.8.adoc:149
5723 msgid "*--color*[**=**__when__]"
5727 #: ../disk-utils/sfdisk.8.adoc:154
5728 msgid "Disable all consistency checking."
5731 #. type: Labeled list
5732 #: ../disk-utils/sfdisk.8.adoc:155
5738 #: ../disk-utils/sfdisk.8.adoc:157
5740 "Deprecated and ignored option. Partitioning that is compatible with Linux "
5741 "(and other modern operating systems) is the default."
5744 #. type: Labeled list
5745 #: ../disk-utils/sfdisk.8.adoc:161 ../misc-utils/rename.1.adoc:31
5746 #: ../misc-utils/wipefs.8.adoc:61
5748 #| msgid "*-f*, *--fast*"
5749 msgid "*-n*, *--no-act*"
5750 msgstr "*-f*, *--fast*"
5753 #: ../disk-utils/sfdisk.8.adoc:163
5754 msgid "Do everything except writing to the device."
5757 #. type: Labeled list
5758 #: ../disk-utils/sfdisk.8.adoc:164
5760 msgid "*--no-reread*"
5764 #: ../disk-utils/sfdisk.8.adoc:166
5766 "Do not check through the re-read-partition-table ioctl whether the device is "
5770 #. type: Labeled list
5771 #: ../disk-utils/sfdisk.8.adoc:167
5773 msgid "*--no-tell-kernel*"
5777 #: ../disk-utils/sfdisk.8.adoc:169
5779 "Don't tell the kernel about partition changes. This option is recommended "
5780 "together with *--no-reread* to modify a partition on used disk. The modified "
5781 "partition should not be used (e.g., mounted)."
5784 #. type: Labeled list
5785 #: ../disk-utils/sfdisk.8.adoc:170
5787 msgid "*-O*, *--backup-file* _path_"
5791 #: ../disk-utils/sfdisk.8.adoc:172
5793 "Override the default backup file name. Note that the device name and offset "
5794 "are always appended to the file name."
5797 #. type: Labeled list
5798 #: ../disk-utils/sfdisk.8.adoc:173
5800 msgid "*--move-data*[**=**__path__]"
5804 #: ../disk-utils/sfdisk.8.adoc:175
5806 "Move data after partition relocation, for example when moving the beginning "
5807 "of a partition to another place on the disk. The size of the partition has "
5808 "to remain the same, the new and old location may overlap. This option "
5809 "requires option *-N* in order to be processed on one specific partition only."
5813 #: ../disk-utils/sfdisk.8.adoc:177
5815 "The optional _path_ specifies log file name. The log file contains "
5816 "information about all read/write operations on the partition data. The word "
5817 "\"@default\" as a _path_ forces *sfdisk* to use _~/sfdisk-<devname>.move_ "
5818 "for the log. The log is optional since v2.35."
5822 #: ../disk-utils/sfdisk.8.adoc:179
5824 "Note that this operation is risky and not atomic. *Don't forget to backup "
5829 #: ../disk-utils/sfdisk.8.adoc:181
5830 msgid "See also *--move-use-fsync*."
5834 #: ../disk-utils/sfdisk.8.adoc:183
5836 "In the example below, the first command creates a 100MiB free area before "
5837 "the first partition and moves the data it contains (e.g., a filesystem), the "
5838 "next command creates a new partition from the free space (at offset 2048), "
5839 "and the last command reorders partitions to match disk order (the original "
5840 "sdc1 will become sdc2)."
5843 #. type: delimited block _
5844 #: ../disk-utils/sfdisk.8.adoc:186
5846 msgid "*echo '+100M,' | sfdisk --move-data /dev/sdc -N 1*\n"
5849 #. type: delimited block _
5850 #: ../disk-utils/sfdisk.8.adoc:188
5852 msgid "*echo '2048,' | sfdisk /dev/sdc --append*\n"
5855 #. type: delimited block _
5856 #: ../disk-utils/sfdisk.8.adoc:190
5858 msgid "*sfdisk /dev/sdc --reorder*\n"
5861 #. type: Labeled list
5862 #: ../disk-utils/sfdisk.8.adoc:192
5864 msgid "*--move-use-fsync*"
5868 #: ../disk-utils/sfdisk.8.adoc:194
5870 "Use the *fsync*(2) system call after each write when moving data to a new "
5871 "location by *--move-data*."
5874 #. TRANSLATORS: Keep {plus} untranslated.
5876 #: ../disk-utils/sfdisk.8.adoc:199
5878 "The default list of columns may be extended if _list_ is specified in the "
5879 "format _{plus}list_ (e.g., *-o +UUID*)."
5883 #: ../disk-utils/sfdisk.8.adoc:203
5884 msgid "Suppress extra info messages."
5887 #. type: Labeled list
5888 #: ../disk-utils/sfdisk.8.adoc:204
5890 #| msgid "*-P*, *--pty*"
5891 msgid "*-u*, *--unit S*"
5892 msgstr "*-P*, *--pty*"
5895 #: ../disk-utils/sfdisk.8.adoc:206
5897 "Deprecated option. Only the sector unit is supported. This option is not "
5898 "supported when using the *--show-size* command."
5901 #. type: Labeled list
5902 #: ../disk-utils/sfdisk.8.adoc:207
5904 #| msgid "*-h*, *--help*"
5905 msgid "*-X*, *--label* _type_"
5906 msgstr "*-h*, *--help*"
5909 #: ../disk-utils/sfdisk.8.adoc:209
5911 "Specify the disk label type (e.g., *dos*, *gpt*, ...). If this option is not "
5912 "given, then *sfdisk* defaults to the existing label, but if there is no "
5913 "label on the device yet, then the type defaults to *dos*. The default or the "
5914 "current label may be overwritten by the \"label: <name>\" script header "
5915 "line. The option *--label* does not force *sfdisk* to create empty disk "
5916 "label (see the *EMPTY DISK LABEL* section below)."
5919 #. type: Labeled list
5920 #: ../disk-utils/sfdisk.8.adoc:210
5922 msgid "*-Y*, *--label-nested* _type_"
5926 #: ../disk-utils/sfdisk.8.adoc:212
5928 "Force editing of a nested disk label. The primary disk label has to exist "
5929 "already. This option allows editing for example a hybrid/protective MBR on "
5934 #: ../disk-utils/sfdisk.8.adoc:215
5936 "Wipe filesystem, RAID and partition-table signatures from the device, in "
5937 "order to avoid possible collisions. The argument _when_ can be *auto*, "
5938 "*never* or *always*. When this option is not given, the default is *auto*, "
5939 "in which case signatures are wiped only when in interactive mode; except the "
5940 "old partition-table signatures which are always wiped before create a new "
5941 "partition-table if the argument _when_ is not *never*. The *auto* mode also "
5942 "does not wipe the first sector (boot sector), it is necessary to use the "
5943 "*always* mode to wipe this area. In all cases detected signatures are "
5944 "reported by warning messages before a new partition table is created. See "
5945 "also the *wipefs*(8) command."
5949 #: ../disk-utils/sfdisk.8.adoc:218
5951 "Wipe filesystem, RAID and partition-table signatures from a newly created "
5952 "partition, in order to avoid possible collisions. The argument _when_ can be "
5953 "*auto*, *never* or *always*. When this option is not given, the default is "
5954 "*auto*, in which case signatures are wiped only when in interactive mode and "
5955 "after confirmation by user. In all cases detected signatures are reported by "
5956 "warning messages after a new partition is created. See also *wipefs*(8) "
5960 #. type: Labeled list
5961 #: ../disk-utils/sfdisk.8.adoc:219
5963 #| msgid "*-V*, *--version*"
5964 msgid "*-v*, *--version*"
5965 msgstr "*-V*, *--version*"
5968 #: ../disk-utils/sfdisk.8.adoc:225
5970 msgid "INPUT FORMATS"
5974 #: ../disk-utils/sfdisk.8.adoc:228
5976 msgid "*sfdisk* supports two input formats and generic header lines.\n"
5980 #: ../disk-utils/sfdisk.8.adoc:229
5982 msgid "Header lines"
5986 #: ../disk-utils/sfdisk.8.adoc:232
5988 "The optional header lines specify generic information that apply to the "
5989 "partition table. The header-line format is:"
5993 #: ../disk-utils/sfdisk.8.adoc:234
5995 msgid "*<name>: <value>*\n"
5999 #: ../disk-utils/sfdisk.8.adoc:236
6000 msgid "The currently recognized headers are:"
6003 #. type: Labeled list
6004 #: ../disk-utils/sfdisk.8.adoc:237
6010 #: ../disk-utils/sfdisk.8.adoc:239
6011 msgid "Specify the partitioning unit. The only supported unit is *sectors*."
6014 #. type: Labeled list
6015 #: ../disk-utils/sfdisk.8.adoc:239
6021 #: ../disk-utils/sfdisk.8.adoc:241
6022 msgid "Specify the partition table type. For example *dos* or *gpt*."
6025 #. type: Labeled list
6026 #: ../disk-utils/sfdisk.8.adoc:241
6032 #: ../disk-utils/sfdisk.8.adoc:243
6034 "Specify the partition table identifier. It should be a hexadecimal number "
6035 "(with a 0x prefix) for MBR and a UUID for GPT."
6038 #. type: Labeled list
6039 #: ../disk-utils/sfdisk.8.adoc:243
6045 #: ../disk-utils/sfdisk.8.adoc:245
6047 "Specify the first usable sector for GPT partitions. This header is ignored "
6048 "if the script and device sector size differ. In this case *sfdisk* uses "
6049 "label specific default."
6052 #. type: Labeled list
6053 #: ../disk-utils/sfdisk.8.adoc:245
6059 #: ../disk-utils/sfdisk.8.adoc:247
6061 "Specify the last usable sector for GPT partitions. This header is ignored if "
6062 "the script and device sector size differ. In this case *sfdisk* uses label "
6066 #. type: Labeled list
6067 #: ../disk-utils/sfdisk.8.adoc:247
6069 msgid "*table-length*"
6073 #: ../disk-utils/sfdisk.8.adoc:249
6074 msgid "Specify the maximal number of GPT partitions."
6077 #. type: Labeled list
6078 #: ../disk-utils/sfdisk.8.adoc:249
6084 #: ../disk-utils/sfdisk.8.adoc:251
6086 "Specify minimal size in bytes used to calculate partitions alignment. The "
6087 "default is 1MiB and it's strongly recommended to use the default. Do not "
6088 "modify this variable if you're not sure."
6091 #. type: Labeled list
6092 #: ../disk-utils/sfdisk.8.adoc:251
6094 msgid "*sector-size*"
6098 #: ../disk-utils/sfdisk.8.adoc:253
6100 "Specify sector size. *sfdisk* always uses device sector size. Since version "
6101 "2.39 *sfdisk* recalculates sizes from dump if the script and device sector "
6106 #: ../disk-utils/sfdisk.8.adoc:255
6108 "Note that it is only possible to use header lines before the first partition "
6109 "is specified in the input."
6113 #: ../disk-utils/sfdisk.8.adoc:256
6115 msgid "Unnamed-fields format"
6118 #. type: delimited block _
6119 #: ../disk-utils/sfdisk.8.adoc:260
6120 msgid "_start size type bootable_"
6124 #: ../disk-utils/sfdisk.8.adoc:263
6125 msgid "where each line fills one partition descriptor."
6129 #: ../disk-utils/sfdisk.8.adoc:265
6131 "Fields are separated by whitespace, comma (recommended) or semicolon "
6132 "possibly followed by whitespace; initial and trailing whitespace is ignored. "
6133 "Numbers can be octal, decimal or hexadecimal; decimal is the default. When a "
6134 "field is absent, empty or specified as '-' a default value is used. But when "
6135 "the *-N* option (change a single partition) is given, the default for each "
6136 "field is its previous value."
6140 #: ../disk-utils/sfdisk.8.adoc:267
6142 "The default value of _start_ is the first non-assigned sector aligned "
6143 "according to device I/O limits. The default start offset for the first "
6144 "partition is 1 MiB. If the offset is followed by the multiplicative suffixes "
6145 "(KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB), then the number is interpreted "
6146 "as offset in bytes. Since v2.38 when the *-N* option (change a single "
6147 "partition) is given, a '{plus}' can be used to enlarge partition by move "
6148 "start of the partition if there is a free space before the partition."
6151 #. TRANSLATORS: Keep {plus} untranslated.
6153 #: ../disk-utils/sfdisk.8.adoc:270
6155 "The default value of _size_ indicates \"as much as possible\"; i.e., until "
6156 "the next partition or end-of-device. A numerical argument is by default "
6157 "interpreted as a number of sectors, however if the size is followed by one "
6158 "of the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB) "
6159 "then the number is interpreted as the size of the partition in bytes and it "
6160 "is then aligned according to the device I/O limits. A '{plus}' can be used "
6161 "instead of a number to enlarge the partition as much as possible. Note "
6162 "'{plus}' is equivalent to the default behaviour for a new partition; "
6163 "existing partitions will be resized as required."
6167 #: ../disk-utils/sfdisk.8.adoc:272
6169 "The partition _type_ is given in hex for MBR (DOS) where 0x prefix is "
6170 "optional; a GUID string for GPT; a shortcut or an alias. It's recommended to "
6171 "use two letters for MBR hex codes to avoid collision between deprecated "
6172 "shortcut 'E' and '0E' MBR hex code. For backward compatibility *sfdisk* "
6173 "tries to interpret _type_ as a shortcut as a first possibility in "
6174 "partitioning scripts although on other places (e.g. *--part-type* command) "
6175 "it tries shortcuts as the last possibility."
6179 #: ../disk-utils/sfdisk.8.adoc:274
6181 "Since v2.36 libfdisk supports partition type aliases as extension to "
6182 "shortcuts. The alias is a simple human readable word (e.g. \"linux\")."
6186 #: ../disk-utils/sfdisk.8.adoc:276
6188 "Since v2.37 libfdisk supports partition type names on input, ignoring the "
6189 "case of the characters and all non-alphanumeric and non-digit characters in "
6190 "the name (e.g. \"Linux /usr x86\" is the same as \"linux usr-x86\")."
6194 #: ../disk-utils/sfdisk.8.adoc:278
6195 msgid "Supported shortcuts and aliases:"
6198 #. type: Labeled list
6199 #: ../disk-utils/sfdisk.8.adoc:279
6201 msgid "*L - alias 'linux'*"
6205 #: ../disk-utils/sfdisk.8.adoc:281
6207 "Linux; means 83 for MBR and 0FC63DAF-8483-4772-8E79-3D69D8477DE4 for GPT."
6210 #. type: Labeled list
6211 #: ../disk-utils/sfdisk.8.adoc:282
6213 msgid "*S - alias 'swap'*"
6217 #: ../disk-utils/sfdisk.8.adoc:284
6219 "swap area; means 82 for MBR and 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F for GPT"
6222 #. type: Labeled list
6223 #: ../disk-utils/sfdisk.8.adoc:285
6225 msgid "*Ex - alias 'extended'*"
6229 #: ../disk-utils/sfdisk.8.adoc:287
6231 "MBR extended partition; means 05 for MBR. The original shortcut 'E' is "
6232 "deprecated due to collision with 0x0E MBR partition type."
6235 #. type: Labeled list
6236 #: ../disk-utils/sfdisk.8.adoc:288
6238 msgid "*H - alias 'home'*"
6242 #: ../disk-utils/sfdisk.8.adoc:290
6243 msgid "home partition; means 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 for GPT"
6246 #. type: Labeled list
6247 #: ../disk-utils/sfdisk.8.adoc:291
6249 msgid "*U - alias 'uefi'*"
6253 #: ../disk-utils/sfdisk.8.adoc:293
6255 "EFI System partition, means EF for MBR and C12A7328-F81F-11D2-"
6256 "BA4B-00A0C93EC93B for GPT"
6259 #. type: Labeled list
6260 #: ../disk-utils/sfdisk.8.adoc:294
6262 msgid "*R - alias 'raid'*"
6266 #: ../disk-utils/sfdisk.8.adoc:296
6268 "Linux RAID; means FD for MBR and A19D880F-05FC-4D3B-A006-743F0F84911E for GPT"
6271 #. type: Labeled list
6272 #: ../disk-utils/sfdisk.8.adoc:297
6274 msgid "*V - alias 'lvm'*"
6278 #: ../disk-utils/sfdisk.8.adoc:299
6279 msgid "LVM; means 8E for MBR and E6D6D379-F507-44C2-A23C-238F2A3DF928 for GPT"
6283 #: ../disk-utils/sfdisk.8.adoc:301
6284 msgid "The default _type_ value is _linux_."
6288 #: ../disk-utils/sfdisk.8.adoc:303
6290 "The shortcut 'X' for Linux extended partition (85) is deprecated in favour "
6294 #. TRANSLATORS: Keep {asterisk} untranslated.
6296 #: ../disk-utils/sfdisk.8.adoc:306
6298 "_bootable_ is specified as [*{asterisk}*|*-*], with as default not-bootable. "
6299 "The value of this field is irrelevant for Linux - when Linux runs it has "
6300 "been booted already - but it might play a role for certain boot loaders and "
6301 "for other operating systems."
6305 #: ../disk-utils/sfdisk.8.adoc:307
6307 msgid "Named-fields format"
6311 #: ../disk-utils/sfdisk.8.adoc:310
6313 "This format is more readable, robust, extensible and allows specifying "
6314 "additional information (e.g., a UUID). It is recommended to use this format "
6315 "to keep your scripts more readable."
6318 #. type: delimited block _
6319 #: ../disk-utils/sfdisk.8.adoc:313
6320 msgid "[_device_ *:*] _name_[**=**__value__], ..."
6324 #: ../disk-utils/sfdisk.8.adoc:316
6326 "The _device_ field is optional. *sfdisk* extracts the partition number from "
6327 "the device name. It allows specifying the partitions in random order. This "
6328 "functionality is mostly used by *--dump*. Don't use it if you are not sure."
6332 #: ../disk-utils/sfdisk.8.adoc:318
6334 "The _value_ can be between quotation marks (e.g., name=\"This is partition "
6335 "name\"). The fields *start=* and *size=* support '{plus}' and '-' in the "
6336 "same way as *Unnamed-fields format*."
6340 #: ../disk-utils/sfdisk.8.adoc:320
6341 msgid "The currently supported fields are:"
6344 #. type: Labeled list
6345 #: ../disk-utils/sfdisk.8.adoc:321
6347 msgid "**start=**__number__"
6351 #: ../disk-utils/sfdisk.8.adoc:323
6353 "The first non-assigned sector aligned according to device I/O limits. The "
6354 "default start offset for the first partition is 1 MiB. If the offset is "
6355 "followed by the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB "
6356 "and YiB), then the number is interpreted as offset in bytes."
6359 #. type: Labeled list
6360 #: ../disk-utils/sfdisk.8.adoc:324
6362 msgid "**size=**__number__"
6366 #: ../disk-utils/sfdisk.8.adoc:326
6368 "Specify the partition size in sectors. The number may be followed by the "
6369 "multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB), then "
6370 "it's interpreted as size in bytes and the size is aligned according to "
6371 "device I/O limits."
6374 #. type: Labeled list
6375 #: ../disk-utils/sfdisk.8.adoc:327
6381 #: ../disk-utils/sfdisk.8.adoc:329
6382 msgid "Mark the partition as bootable."
6385 #. type: Labeled list
6386 #: ../disk-utils/sfdisk.8.adoc:330
6388 msgid "**attrs=**__string__"
6392 #: ../disk-utils/sfdisk.8.adoc:332
6394 "Partition attributes, usually GPT partition attribute bits. See *--part-"
6395 "attrs* for more details about the GPT-bits string format."
6398 #. type: Labeled list
6399 #: ../disk-utils/sfdisk.8.adoc:333
6401 msgid "**uuid=**__string__"
6405 #: ../disk-utils/sfdisk.8.adoc:335
6406 msgid "GPT partition UUID."
6409 #. type: Labeled list
6410 #: ../disk-utils/sfdisk.8.adoc:336
6412 msgid "**name=**__string__"
6416 #: ../disk-utils/sfdisk.8.adoc:338
6417 msgid "GPT partition name."
6420 #. type: Labeled list
6421 #: ../disk-utils/sfdisk.8.adoc:339
6423 msgid "**type=**__code__"
6427 #: ../disk-utils/sfdisk.8.adoc:341
6429 "A hexadecimal number (without 0x) for an MBR partition, a GUID for a GPT "
6430 "partition, a shortcut as for unnamed-fields format or a type name (e.g. "
6431 "type=\"Linux /usr (x86)\"). See above the section about the unnamed-fields "
6432 "format for more details. For backward compatibility the *Id=* field has the "
6437 #: ../disk-utils/sfdisk.8.adoc:342
6439 msgid "EMPTY DISK LABEL"
6443 #: ../disk-utils/sfdisk.8.adoc:345
6445 msgid "*sfdisk* does not create partition table without partitions by default. The lines with partitions are expected in the script by default. The empty partition table has to be explicitly requested by \"label: <name>\" script header line without any partitions lines. For example:\n"
6448 #. type: delimited block _
6449 #: ../disk-utils/sfdisk.8.adoc:348
6451 msgid "*echo 'label: gpt' | sfdisk /dev/sdb*\n"
6455 #: ../disk-utils/sfdisk.8.adoc:351
6457 "creates empty GPT partition table. Note that the *--append* disables this "
6462 #: ../disk-utils/sfdisk.8.adoc:352
6464 msgid "BACKING UP THE PARTITION TABLE"
6468 #: ../disk-utils/sfdisk.8.adoc:355
6470 "It is recommended to save the layout of your devices. *sfdisk* supports two "
6475 #: ../disk-utils/sfdisk.8.adoc:356
6477 msgid "Dump in sfdisk compatible format"
6481 #: ../disk-utils/sfdisk.8.adoc:360
6483 "Use the *--dump* command to save a description of the device layout to a "
6484 "text file. The dump format is suitable for later *sfdisk* input. For "
6488 #. type: delimited block _
6489 #: ../disk-utils/sfdisk.8.adoc:362
6491 msgid "*sfdisk --dump /dev/sda > sda.dump*\n"
6495 #: ../disk-utils/sfdisk.8.adoc:365
6496 msgid "This can later be restored by:"
6499 #. type: delimited block _
6500 #: ../disk-utils/sfdisk.8.adoc:367
6502 msgid "*sfdisk /dev/sda < sda.dump*\n"
6506 #: ../disk-utils/sfdisk.8.adoc:370
6508 "Note that sfdisk completely restores partition types and partition UUIDs. "
6509 "This could potentially become problematic if you duplicate the same layout "
6510 "to different disks, as it may result in duplicate UUIDs within your system."
6514 #: ../disk-utils/sfdisk.8.adoc:371
6516 msgid "Full binary backup"
6520 #: ../disk-utils/sfdisk.8.adoc:374
6522 "If you want to do a full binary backup of all sectors where the partition "
6523 "table is stored, then use the *--backup-pt-sectors* command. It writes the "
6524 "sectors to _~/sfdisk-<device>-<offset>.bak_ files. The default name of the "
6525 "backup file can be changed with the *--backup-file* option. The backup files "
6526 "contain only raw data from the _device_. For example:"
6529 #. type: delimited block _
6530 #: ../disk-utils/sfdisk.8.adoc:377
6532 msgid "*sfdisk --backup-pt-sectors /dev/sda*\n"
6536 #: ../disk-utils/sfdisk.8.adoc:380
6537 msgid "The GPT header can later be restored by:"
6540 #. type: delimited block _
6541 #: ../disk-utils/sfdisk.8.adoc:383
6543 msgid "*dd if=~/sfdisk-sda-0x00000200.bak of=/dev/sda seek=$\\((0x00000200)) bs=1 conv=notrunc*\n"
6547 #: ../disk-utils/sfdisk.8.adoc:387
6549 "It's also possible to use the *--backup* option to create the same backup "
6550 "immediately after startup for other *sfdisk* commands. For example, backup "
6551 "partition table before deleting all partitions from partition table:"
6554 #. type: delimited block _
6555 #: ../disk-utils/sfdisk.8.adoc:389
6557 msgid "*sfdisk --backup --delete /dev/sda*\n"
6561 #: ../disk-utils/sfdisk.8.adoc:393
6562 msgid "The same concept of backup files is used by *wipefs*(8)."
6566 #: ../disk-utils/sfdisk.8.adoc:395
6568 "Note that *sfdisk* since version 2.26 no longer provides the *-I* option to "
6569 "restore sectors. *dd*(1) provides all necessary functionality."
6573 #: ../disk-utils/sfdisk.8.adoc:399
6574 msgid "The logical color names supported by *sfdisk* are:"
6577 #. type: Labeled list
6578 #: ../disk-utils/sfdisk.8.adoc:409
6580 msgid "*SFDISK_DEBUG*=all"
6584 #: ../disk-utils/sfdisk.8.adoc:411
6585 msgid "enables *sfdisk* debug output."
6589 #: ../disk-utils/sfdisk.8.adoc:423
6591 "Since version 2.26 *sfdisk* no longer provides the *-R* or *--re-read* "
6592 "option to force the kernel to reread the partition table. Use *blockdev --"
6593 "rereadpt* instead."
6597 #: ../disk-utils/sfdisk.8.adoc:425
6599 "Since version 2.26 *sfdisk* does not provide the *--DOS*, *--IBM*, *--DOS-"
6600 "extended*, *--unhide*, *--show-extended*, *--cylinders*, *--heads*, *--"
6601 "sectors*, *--inside-outer*, *--not-inside-outer* options."
6605 #: ../disk-utils/sfdisk.8.adoc:426 ../misc-utils/findmnt.8.adoc:209
6606 #: ../misc-utils/getopt.1.adoc:128 ../misc-utils/logger.1.adoc:233
6607 #: ../misc-utils/look.1.adoc:94 ../misc-utils/pipesz.1.adoc:69
6608 #: ../misc-utils/rename.1.adoc:83 ../misc-utils/uuidgen.1.adoc:61
6609 #: ../misc-utils/whereis.1.adoc:117 ../misc-utils/wipefs.8.adoc:88
6610 #: ../schedutils/chrt.1.adoc:106 ../schedutils/ionice.1.adoc:72
6611 #: ../sys-utils/flock.1.adoc:100 ../sys-utils/prlimit.1.adoc:114
6612 #: ../sys-utils/renice.1.adoc:96 ../sys-utils/setpriv.1.adoc:100
6613 #: ../sys-utils/unshare.1.adoc:150 ../term-utils/scriptlive.1.adoc:50
6614 #: ../term-utils/scriptreplay.1.adoc:67 ../text-utils/colcrt.1.adoc:83
6615 #: ../text-utils/column.1.adoc:209 ../text-utils/hexdump.1.adoc:230
6620 #. type: Labeled list
6621 #: ../disk-utils/sfdisk.8.adoc:428
6623 msgid "*sfdisk --list --label-nested=mbr /dev/sda*"
6627 #: ../disk-utils/sfdisk.8.adoc:430
6628 msgid "Print protective MBR on device with GPT disk label."
6631 #. type: Labeled list
6632 #: ../disk-utils/sfdisk.8.adoc:431
6634 msgid "*echo -e ',10M,L\\n,10M,L\\n,+,\\n' | sfdisk /dev/sdc*"
6638 #: ../disk-utils/sfdisk.8.adoc:433
6640 "Create three Linux partitions, with the default start, the size of the first "
6641 "two partitions is 10MiB, and the last partition fills all available space on "
6645 #. type: Labeled list
6646 #: ../disk-utils/sfdisk.8.adoc:434
6648 msgid "*echo -e 'size=10M, type=L\\n size=10M, type=L\\n size=+\\n' | sfdisk /dev/sdc*"
6652 #: ../disk-utils/sfdisk.8.adoc:436
6653 msgid "The same as the previous example, but in named-fields format."
6656 #. type: Labeled list
6657 #: ../disk-utils/sfdisk.8.adoc:437
6659 msgid "*echo -e 'type=swap' | sfdisk -N 3 /dev/sdc*"
6663 #: ../disk-utils/sfdisk.8.adoc:439
6664 msgid "Set type of the 3rd partition to 'swap'."
6667 #. type: Labeled list
6668 #: ../disk-utils/sfdisk.8.adoc:440
6670 msgid "*sfdisk --part-type /dev/sdc 3 swap*"
6674 #: ../disk-utils/sfdisk.8.adoc:442
6675 msgid "The same as the previous example, but without script use."
6678 #. type: Labeled list
6679 #: ../disk-utils/sfdisk.8.adoc:443
6681 msgid "*sfdisk --delete /dev/sdc 2*"
6685 #: ../disk-utils/sfdisk.8.adoc:445
6686 msgid "Delete 2nd partition."
6689 #. type: Labeled list
6690 #: ../disk-utils/sfdisk.8.adoc:446
6692 msgid "*echo \"\\+,+\" | sfdisk -N 3 --move-data /dev/sdc*"
6696 #: ../disk-utils/sfdisk.8.adoc:448
6698 "Enlarge 3rd partition in both directions, move start to use free space "
6699 "before the partition and enlarge the size to use all free space after to the "
6700 "partition, and move partition data too."
6704 #: ../disk-utils/sfdisk.8.adoc:454
6706 "The current *sfdisk* implementation is based on the original *sfdisk* from "
6707 "Andries E. Brouwer."
6711 #: ../disk-utils/sfdisk.8.adoc:462
6721 #. Copyright 2010 Jason Borden <jborden@bluehost.com>
6722 #. This file may be copied under the terms of the GNU Public License.
6724 #: ../disk-utils/swaplabel.8.adoc:6
6726 msgid "swaplabel(8)"
6730 #: ../disk-utils/swaplabel.8.adoc:16
6731 msgid "swaplabel - print or change the label or UUID of a swap area"
6735 #: ../disk-utils/swaplabel.8.adoc:20
6737 msgid "*swaplabel* [*-L* _label_] [*-U* _UUID_] _device_\n"
6741 #: ../disk-utils/swaplabel.8.adoc:24
6743 msgid "*swaplabel* will display or change the label or UUID of a swap partition located on _device_ (or regular file).\n"
6747 #: ../disk-utils/swaplabel.8.adoc:26
6749 "If the optional arguments *-L* and *-U* are not given, *swaplabel* will "
6750 "simply display the current swap-area label and UUID of _device_."
6754 #: ../disk-utils/swaplabel.8.adoc:28
6756 "If an optional argument is present, then *swaplabel* will change the "
6757 "appropriate value on _device_. These values can also be set during swap "
6758 "creation using *mkswap*(8). The *swaplabel* utility allows changing the "
6759 "label or UUID on an actively used swap device."
6763 #: ../disk-utils/swaplabel.8.adoc:35
6765 "Specify a new _label_ for the device. Swap partition labels can be at most "
6766 "16 characters long. If _label_ is longer than 16 characters, *swaplabel* "
6767 "will truncate it and print a warning message."
6771 #: ../disk-utils/swaplabel.8.adoc:38
6773 "Specify a new _UUID_ for the device. The _UUID_ must be in the standard "
6774 "8-4-4-4-12 character format, such as is output by *uuidgen*(1)."
6778 #: ../disk-utils/swaplabel.8.adoc:47
6780 msgid "*swaplabel* was written by mailto:jborden@bluehost.com[Jason Borden] and mailto:kzak@redhat.com[Karel Zak].\n"
6784 #: ../disk-utils/swaplabel.8.adoc:53
6799 #. terminal-colors.d.5 --
6800 #. Copyright 2014 Ondrej Oprala <ooprala@redhat.com>
6801 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
6802 #. Copyright 2014 Red Hat, Inc.
6803 #. May be distributed under the GNU General Public License
6805 #: ../lib/terminal-colors.d.5.adoc:10
6807 #| msgid "_/etc/terminal-colors.d/disable_"
6808 msgid "terminal-colors.d(5)"
6809 msgstr "_/etc/terminal-colors.d/disable_"
6811 #. type: Attribute :man manual:
6812 #: ../lib/terminal-colors.d.5.adoc:12 ../login-utils/utmpdump.1.adoc:61
6813 #: ../sys-utils/adjtime_config.5.adoc:4 ../sys-utils/fstab.5.adoc:38
6815 msgid "File formats"
6816 msgstr "Formáty souborů"
6819 #: ../lib/terminal-colors.d.5.adoc:20
6820 msgid "terminal-colors.d - configure output colorization for various utilities"
6824 #: ../lib/terminal-colors.d.5.adoc:24
6826 #| msgid "_/etc/terminal-colors.d/disable_"
6827 msgid "/etc/terminal-colors.d/_[[name][@term].][type]_"
6828 msgstr "_/etc/terminal-colors.d/disable_"
6831 #: ../lib/terminal-colors.d.5.adoc:28
6833 "Files in this directory determine the default behavior for utilities when "
6838 #: ../lib/terminal-colors.d.5.adoc:30
6840 "The _name_ is a utility name. The name is optional and when none is "
6841 "specified then the file is used for all unspecified utilities."
6845 #: ../lib/terminal-colors.d.5.adoc:32
6847 "The _term_ is a terminal identifier (the *TERM* environment variable). The "
6848 "terminal identifier is optional and when none is specified then the file is "
6849 "used for all unspecified terminals."
6853 #: ../lib/terminal-colors.d.5.adoc:34
6854 msgid "The _type_ is a file type. Supported file types are:"
6857 #. type: Labeled list
6858 #: ../lib/terminal-colors.d.5.adoc:35 ../sys-utils/rtcwake.8.adoc:87
6864 #: ../lib/terminal-colors.d.5.adoc:37
6865 msgid "Turns off output colorization for all compatible utilities."
6868 #. type: Labeled list
6869 #: ../lib/terminal-colors.d.5.adoc:38
6875 #: ../lib/terminal-colors.d.5.adoc:40
6876 msgid "Turns on output colorization; any matching *disable* files are ignored."
6879 #. type: Labeled list
6880 #: ../lib/terminal-colors.d.5.adoc:41
6886 #: ../lib/terminal-colors.d.5.adoc:43
6888 "Specifies colors used for output. The file format may be specific to the "
6889 "utility, the default format is described below."
6893 #: ../lib/terminal-colors.d.5.adoc:45
6895 "If there are more files that match for a utility, then the file with the "
6896 "more specific filename wins. For example, the filename \"@xterm.scheme\" has "
6897 "less priority than \"dmesg@xterm.scheme\". The lowest priority are those "
6898 "files without a utility name and terminal identifier (e.g., \"disable\")."
6902 #: ../lib/terminal-colors.d.5.adoc:48
6904 msgid "DEFAULT SCHEME FILES FORMAT"
6908 #: ../lib/terminal-colors.d.5.adoc:51
6909 msgid "The following statement is recognized:"
6912 #. type: delimited block _
6913 #: ../lib/terminal-colors.d.5.adoc:54
6915 msgid "*name color-sequence*\n"
6919 #: ../lib/terminal-colors.d.5.adoc:57
6921 "The *name* is a logical name of color sequence (for example \"error\"). The "
6922 "names are specific to the utilities. For more details always see the "
6923 "*COLORS* section in the man page for the utility."
6927 #: ../lib/terminal-colors.d.5.adoc:59
6929 "The *color-sequence* is a color name, ASCII color sequences or escape "
6934 #: ../lib/terminal-colors.d.5.adoc:60
6940 #: ../lib/terminal-colors.d.5.adoc:63
6942 "black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
6943 "lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
6944 "magenta, red, reset, reverse, and yellow."
6948 #: ../lib/terminal-colors.d.5.adoc:64
6950 msgid "ANSI color sequences"
6954 #: ../lib/terminal-colors.d.5.adoc:67
6956 "The color sequences are composed of sequences of numbers separated by "
6957 "semicolons. The most common codes are:"
6961 #: ../lib/terminal-colors.d.5.adoc:91
6964 "|0 |to restore default color\n"
6965 "|1 |for brighter colors\n"
6966 "|4 |for underlined text\n"
6967 "|5 |for flashing text\n"
6968 "|30 |for black foreground\n"
6969 "|31 |for red foreground\n"
6970 "|32 |for green foreground\n"
6971 "|33 |for yellow (or brown) foreground\n"
6972 "|34 |for blue foreground\n"
6973 "|35 |for purple foreground\n"
6974 "|36 |for cyan foreground\n"
6975 "|37 |for white (or gray) foreground\n"
6976 "|40 |for black background\n"
6977 "|41 |for red background\n"
6978 "|42 |for green background\n"
6979 "|43 |for yellow (or brown) background\n"
6980 "|44 |for blue background\n"
6981 "|45 |for purple background\n"
6982 "|46 |for cyan background\n"
6983 "|47 |for white (or gray) background\n"
6987 #: ../lib/terminal-colors.d.5.adoc:94
6989 msgid "Escape sequences"
6992 #. type: delimited block _
6993 #: ../lib/terminal-colors.d.5.adoc:97
6995 "To specify control or blank characters in the color sequences, C-style \\-"
6996 "escaped notation can be used:"
7000 #: ../lib/terminal-colors.d.5.adoc:114
7003 "|*\\a* |Bell (ASCII 7)\n"
7004 "|*\\b* |Backspace (ASCII 8)\n"
7005 "|*\\e* |Escape (ASCII 27)\n"
7006 "|*\\f* |Form feed (ASCII 12)\n"
7007 "|*\\n* |Newline (ASCII 10)\n"
7008 "|*\\r* |Carriage Return (ASCII 13)\n"
7009 "|*\\t* |Tab (ASCII 9)\n"
7010 "|*\\v* |Vertical Tab (ASCII 11)\n"
7011 "|*\\?* |Delete (ASCII 127)\n"
7013 "|*\\\\* |Backslash (\\)\n"
7014 "|*\\^* |Caret (^)\n"
7015 "|*\\#* |Hash mark (#)\n"
7018 #. type: delimited block _
7019 #: ../lib/terminal-colors.d.5.adoc:118
7021 "Please note that escapes are necessary to enter a space, backslash, caret, "
7022 "or any control character anywhere in the string, as well as a hash mark as "
7023 "the first character."
7026 #. type: delimited block _
7027 #: ../lib/terminal-colors.d.5.adoc:120
7029 "For example, to use a red background for alert messages in the output of "
7034 #: ../lib/terminal-colors.d.5.adoc:123
7036 msgid "*echo 'alert 37;41' >> /etc/terminal-colors.d/dmesg.scheme*\n"
7040 #: ../lib/terminal-colors.d.5.adoc:125
7042 #| msgid "*comment*"
7046 #. type: delimited block _
7047 #: ../lib/terminal-colors.d.5.adoc:128
7049 "Lines where the first non-blank character is a # (hash) are ignored. Any "
7050 "other use of the hash character is not interpreted as introducing a comment."
7053 #. type: Labeled list
7054 #: ../lib/terminal-colors.d.5.adoc:131
7056 msgid "*TERMINAL_COLORS_DEBUG*=all"
7060 #: ../lib/terminal-colors.d.5.adoc:133 ../misc-utils/whereis.1.adoc:116
7061 #: ../sys-utils/losetup.8.adoc:135
7062 msgid "enables debug output."
7065 #. type: delimited block _
7066 #: ../lib/terminal-colors.d.5.adoc:137
7067 msgid "_$XDG_CONFIG_HOME/terminal-colors.d_"
7070 #. type: delimited block _
7071 #: ../lib/terminal-colors.d.5.adoc:139
7073 #| msgid "_/etc/terminal-colors.d/disable_"
7074 msgid "_$HOME/.config/terminal-colors.d_"
7075 msgstr "_/etc/terminal-colors.d/disable_"
7077 #. type: delimited block _
7078 #: ../lib/terminal-colors.d.5.adoc:141
7080 #| msgid "_/etc/terminal-colors.d/disable_"
7081 msgid "_/etc/terminal-colors.d_"
7082 msgstr "_/etc/terminal-colors.d/disable_"
7084 #. type: delimited block _
7085 #: ../lib/terminal-colors.d.5.adoc:145
7086 msgid "Disable colors for all compatible utilities:"
7090 #: ../lib/terminal-colors.d.5.adoc:148 ../lib/terminal-colors.d.5.adoc:160
7092 #| msgid "_/etc/terminal-colors.d/disable_"
7093 msgid "*touch /etc/terminal-colors.d/disable*\n"
7094 msgstr "_/etc/terminal-colors.d/disable_"
7096 #. type: delimited block _
7097 #: ../lib/terminal-colors.d.5.adoc:151
7098 msgid "Disable colors for all compatible utils on a vt100 terminal:"
7102 #: ../lib/terminal-colors.d.5.adoc:154
7104 #| msgid "_/etc/terminal-colors.d/disable_"
7105 msgid "*touch /etc/terminal-colors.d/@vt100.disable*\n"
7106 msgstr "_/etc/terminal-colors.d/disable_"
7108 #. type: delimited block _
7109 #: ../lib/terminal-colors.d.5.adoc:157
7110 msgid "Disable colors for all compatible utils except *dmesg*(1):"
7114 #: ../lib/terminal-colors.d.5.adoc:162
7116 #| msgid "_/etc/terminal-colors.d/disable_"
7117 msgid "*touch /etc/terminal-colors.d/dmesg.enable*\n"
7118 msgstr "_/etc/terminal-colors.d/disable_"
7121 #: ../lib/terminal-colors.d.5.adoc:164 ../misc-utils/getopt.1.adoc:112
7122 #: ../term-utils/setterm.1.adoc:159
7124 #| msgid "AVAILABILITY"
7125 msgid "COMPATIBILITY"
7128 #. type: delimited block _
7129 #: ../lib/terminal-colors.d.5.adoc:167
7131 "The *terminal-colors.d* functionality is currently supported by all util-"
7132 "linux utilities which provides colorized output. For more details always see "
7133 "the *COLORS* section in the man page for the utility."
7136 #. Copyright 2001 Andreas Dilger (adilger@turbolinux.com)
7137 #. This man page was created for libblkid.so.1.0 from e2fsprogs-1.24.
7138 #. This file may be copied under the terms of the GNU Lesser General Public License.
7139 #. Created Wed Sep 14 12:02:12 2001, Andreas Dilger
7141 #: ../libblkid/libblkid.3.adoc:8
7146 #. type: Attribute :man manual:
7147 #: ../libblkid/libblkid.3.adoc:10 ../libuuid/man/uuid.3.adoc:35
7148 #: ../libuuid/man/uuid_clear.3.adoc:35 ../libuuid/man/uuid_compare.3.adoc:35
7149 #: ../libuuid/man/uuid_copy.3.adoc:35 ../libuuid/man/uuid_generate.3.adoc:37
7150 #: ../libuuid/man/uuid_is_null.3.adoc:35 ../libuuid/man/uuid_parse.3.adoc:35
7151 #: ../libuuid/man/uuid_time.3.adoc:35 ../libuuid/man/uuid_unparse.3.adoc:35
7153 msgid "Programmer's Manual"
7157 #: ../libblkid/libblkid.3.adoc:19
7158 msgid "libblkid - block device identification library"
7162 #: ../libblkid/libblkid.3.adoc:23
7164 msgid "*#include <blkid.h>*\n"
7168 #: ../libblkid/libblkid.3.adoc:25
7170 msgid "*cc* _file.c_ *-lblkid*\n"
7174 #: ../libblkid/libblkid.3.adoc:29
7176 "The *libblkid* library is used to identify block devices (disks) as to their "
7177 "content (e.g., filesystem type) as well as extracting additional information "
7178 "such as filesystem labels/volume names, unique identifiers/serial numbers. A "
7179 "common use is to allow use of *LABEL=* and *UUID=* tags instead of hard-"
7180 "coding specific block device names into configuration files. See list of all "
7181 "available tags in *TAGS* section."
7185 #: ../libblkid/libblkid.3.adoc:31
7187 "The low-level part of the library also allows the extraction of information "
7188 "about partitions and block device topology."
7192 #: ../libblkid/libblkid.3.adoc:33
7194 "The high-level part of the library keeps information about block devices in "
7195 "a cache file and is verified to still be valid before being returned to the "
7196 "user (if the user has read permission on the raw block device, otherwise "
7197 "not). The cache file also allows unprivileged users (normally anyone other "
7198 "than root, or those not in the \"disk\" group) to locate devices by label/"
7199 "id. The standard location of the cache file can be overridden by the "
7200 "environment variable *BLKID_FILE*."
7204 #: ../libblkid/libblkid.3.adoc:35
7206 "In situations where one is getting information about a single known device, "
7207 "it does not impact performance whether the cache is used or not (unless you "
7208 "are not able to read the block device directly)."
7212 #: ../libblkid/libblkid.3.adoc:37
7214 "The high-level part of the library supports two methods to determine *LABEL/"
7215 "UUID*. It reads information directly from a block device or reads "
7216 "information from /dev/disk/by-* udev symlinks. The udev is preferred method "
7221 #: ../libblkid/libblkid.3.adoc:39
7223 "If you are dealing with multiple devices, use of the cache is highly "
7224 "recommended (even if empty) as devices will be scanned at most one time and "
7225 "the on-disk cache will be updated if possible."
7229 #: ../libblkid/libblkid.3.adoc:41
7231 "In some cases (modular kernels), block devices are not even visible until "
7232 "after they are accessed the first time, so it is critical that there is some "
7233 "way to locate these devices without enumerating only visible devices, so the "
7234 "use of the cache file is *required* in this situation."
7238 #: ../libblkid/libblkid.3.adoc:42 ../misc-utils/blkid.8.adoc:158
7240 #| msgid "CONFIG FILES"
7241 msgid "CONFIGURATION FILE"
7242 msgstr "KONFIGURAČNÍ SOUBORY"
7245 #: ../libblkid/libblkid.3.adoc:45
7247 "The standard location of the _/etc/blkid.conf_ config file can be overridden "
7248 "by the environment variable *BLKID_CONF*. For more details about the config "
7249 "file see *blkid*(8) man page."
7253 #: ../libblkid/libblkid.3.adoc:46
7259 #: ../libblkid/libblkid.3.adoc:49
7261 "All available tags are listed below. Not all tags are supported for all file "
7262 "systems. To enable a tag, set one of the following flags with "
7263 "*blkid_probe_set_superblocks_flags*():"
7266 #. type: Labeled list
7267 #: ../libblkid/libblkid.3.adoc:50
7269 msgid "BLKID_SUBLKS_TYPE"
7273 #: ../libblkid/libblkid.3.adoc:53
7274 msgid "TYPE - filesystem type"
7277 #. type: Labeled list
7278 #: ../libblkid/libblkid.3.adoc:54
7280 msgid "BLKID_SUBLKS_SECTYPE"
7284 #: ../libblkid/libblkid.3.adoc:57
7285 msgid "SEC_TYPE - secondary filesystem type"
7288 #. type: Labeled list
7289 #: ../libblkid/libblkid.3.adoc:58
7291 msgid "BLKID_SUBLKS_LABEL"
7295 #: ../libblkid/libblkid.3.adoc:61
7296 msgid "LABEL - filesystem label"
7299 #. type: Labeled list
7300 #: ../libblkid/libblkid.3.adoc:62
7302 msgid "BLKID_SUBLKS_LABELRAW"
7306 #: ../libblkid/libblkid.3.adoc:65
7307 msgid "LABEL_RAW - raw label from FS superblock"
7310 #. type: Labeled list
7311 #: ../libblkid/libblkid.3.adoc:66
7313 msgid "BLKID_SUBLKS_UUID"
7317 #: ../libblkid/libblkid.3.adoc:69
7318 msgid "UUID - filesystem UUID (lower case)"
7322 #: ../libblkid/libblkid.3.adoc:71
7323 msgid "UUID_SUB - subvolume uuid (e.g. btrfs)"
7327 #: ../libblkid/libblkid.3.adoc:73
7328 msgid "LOGUUID - external log UUID (e.g. xfs)"
7331 #. type: Labeled list
7332 #: ../libblkid/libblkid.3.adoc:74
7334 msgid "BLKID_SUBLKS_UUIDRAW"
7338 #: ../libblkid/libblkid.3.adoc:77
7339 msgid "UUID_RAW - raw UUID from FS superblock"
7342 #. type: Labeled list
7343 #: ../libblkid/libblkid.3.adoc:78
7345 msgid "BLKID_SUBLKS_USAGE"
7349 #: ../libblkid/libblkid.3.adoc:81
7350 msgid "USAGE - usage string: \"raid\", \"filesystem\", etc."
7353 #. type: Labeled list
7354 #: ../libblkid/libblkid.3.adoc:82
7356 msgid "BLKID_SUBLKS_VERSION"
7360 #: ../libblkid/libblkid.3.adoc:85
7361 msgid "VERSION - filesystem version"
7364 #. type: Labeled list
7365 #: ../libblkid/libblkid.3.adoc:86
7367 msgid "BLKID_SUBLKS_MAGIC"
7371 #: ../libblkid/libblkid.3.adoc:89
7372 msgid "SBMAGIC - super block magic string"
7376 #: ../libblkid/libblkid.3.adoc:91
7377 msgid "SBMAGIC_OFFSET - offset of SBMAGIC"
7380 #. type: Labeled list
7381 #: ../libblkid/libblkid.3.adoc:92
7383 msgid "BLKID_SUBLKS_FSINFO"
7387 #: ../libblkid/libblkid.3.adoc:98
7389 "FSSIZE - size of filesystem. Note that for XFS this will return the same "
7390 "value as lsblk (without XFS's metadata), but for ext4 it will return the "
7391 "size with metadata and for BTRFS will not count overhead of RAID "
7392 "configuration (redundant data)."
7396 #: ../libblkid/libblkid.3.adoc:100
7397 msgid "FSLASTBLOCK - last fsblock/total number of fsblocks"
7401 #: ../libblkid/libblkid.3.adoc:102
7402 msgid "FSBLOCKSIZE - file system block size"
7405 #. type: Labeled list
7406 #: ../libblkid/libblkid.3.adoc:103
7408 msgid "The following tags are always enabled"
7412 #: ../libblkid/libblkid.3.adoc:106
7413 msgid "BLOCK_SIZE - minimal block size accessible by file system"
7417 #: ../libblkid/libblkid.3.adoc:108
7418 msgid "MOUNT - cluster mount name (ocfs only)"
7422 #: ../libblkid/libblkid.3.adoc:110
7423 msgid "EXT_JOURNAL - external journal UUID"
7427 #: ../libblkid/libblkid.3.adoc:112
7428 msgid "SYSTEM_ID - ISO9660 system identifier"
7432 #: ../libblkid/libblkid.3.adoc:114
7433 msgid "VOLUME_SET_ID - ISO9660 volume set identifier"
7437 #: ../libblkid/libblkid.3.adoc:116
7438 msgid "DATA_PREPARER_ID - ISO9660 data identifier"
7442 #: ../libblkid/libblkid.3.adoc:118
7443 msgid "PUBLISHER_ID - ISO9660 publisher identifier"
7447 #: ../libblkid/libblkid.3.adoc:120
7448 msgid "APPLICATION_ID - ISO9660 application identifier"
7452 #: ../libblkid/libblkid.3.adoc:122
7453 msgid "BOOT_SYSTEM_ID - ISO9660 boot system identifier"
7457 #: ../libblkid/libblkid.3.adoc:126
7459 msgid "*libblkid* was written by Andreas Dilger for the ext2 filesystem utilities, with input from Ted Ts'o. The library was subsequently heavily modified by Ted Ts'o.\n"
7463 #: ../libblkid/libblkid.3.adoc:128
7464 msgid "The low-level probing code was rewritten by Karel Zak."
7468 #: ../libblkid/libblkid.3.adoc:129
7474 #: ../libblkid/libblkid.3.adoc:132
7476 msgid "*libblkid* is available under the terms of the GNU Library General Public License (LGPL), version 2 (or at your discretion any later version).\n"
7480 #: ../libblkid/libblkid.3.adoc:137 ../misc-utils/wipefs.8.adoc:107
7490 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7491 #. Redistribution and use in source and binary forms, with or without
7492 #. modification, are permitted provided that the following conditions
7494 #. 1. Redistributions of source code must retain the above copyright
7495 #. notice, and the entire permission notice in its entirety,
7496 #. including the disclaimer of warranties.
7497 #. 2. Redistributions in binary form must reproduce the above copyright
7498 #. notice, this list of conditions and the following disclaimer in the
7499 #. documentation and/or other materials provided with the distribution.
7500 #. 3. The name of the author may not be used to endorse or promote
7501 #. products derived from this software without specific prior
7502 #. written permission.
7503 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7504 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7505 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7506 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7507 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7508 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7509 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7510 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7511 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7512 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7513 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7515 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7517 #: ../libuuid/man/uuid.3.adoc:33
7523 #: ../libuuid/man/uuid.3.adoc:44
7524 msgid "uuid - DCE compatible Universally Unique Identifier library"
7528 #: ../libuuid/man/uuid.3.adoc:48 ../libuuid/man/uuid_clear.3.adoc:48
7529 #: ../libuuid/man/uuid_compare.3.adoc:48 ../libuuid/man/uuid_copy.3.adoc:48
7530 #: ../libuuid/man/uuid_generate.3.adoc:50 ../libuuid/man/uuid_is_null.3.adoc:48
7531 #: ../libuuid/man/uuid_parse.3.adoc:48 ../libuuid/man/uuid_time.3.adoc:48
7532 #: ../libuuid/man/uuid_unparse.3.adoc:48
7534 msgid "*#include <uuid.h>*\n"
7538 #: ../libuuid/man/uuid.3.adoc:52
7540 "The UUID library is used to generate unique identifiers for objects that may "
7541 "be accessible beyond the local system. This library generates UUIDs "
7542 "compatible with those created by the Open Software Foundation (OSF) "
7543 "Distributed Computing Environment (DCE) utility *uuidgen*(1)."
7547 #: ../libuuid/man/uuid.3.adoc:54
7549 "The UUIDs generated by this library can be reasonably expected to be unique "
7550 "within a system, and unique across all systems. They could be used, for "
7551 "instance, to generate unique HTTP cookies across multiple web servers "
7552 "without communication between the servers, and without fear of a name clash."
7556 #: ../libuuid/man/uuid.3.adoc:55 ../libuuid/man/uuid_generate.3.adoc:76
7557 #: ../libuuid/man/uuid_parse.3.adoc:62 ../libuuid/man/uuid_unparse.3.adoc:59
7558 #: ../misc-utils/logger.1.adoc:229 ../misc-utils/uuidgen.1.adoc:57
7559 #: ../sys-utils/ipcs.1.adoc:76 ../text-utils/col.1.adoc:86
7560 #: ../text-utils/hexdump.1.adoc:226
7562 msgid "CONFORMING TO"
7566 #: ../libuuid/man/uuid.3.adoc:58 ../libuuid/man/uuid_generate.3.adoc:79
7568 "This library generates UUIDs compatible with OSF DCE 1.1, and hash based "
7569 "UUIDs V3 and V5 compatible with link:https://tools.ietf.org/html/"
7570 "rfc4122[RFC-4122]."
7574 #: ../libuuid/man/uuid.3.adoc:62 ../libuuid/man/uuid_clear.3.adoc:58
7575 #: ../libuuid/man/uuid_compare.3.adoc:62 ../libuuid/man/uuid_copy.3.adoc:62
7576 #: ../libuuid/man/uuid_generate.3.adoc:83 ../libuuid/man/uuid_is_null.3.adoc:58
7577 #: ../libuuid/man/uuid_parse.3.adoc:69 ../libuuid/man/uuid_time.3.adoc:62
7578 #: ../libuuid/man/uuid_unparse.3.adoc:66
7579 msgid "Theodore Y. Ts'o"
7583 #: ../libuuid/man/uuid.3.adoc:73
7586 "*uuid_clear*(3),\n"
7587 "*uuid_compare*(3),\n"
7589 "*uuid_generate*(3),\n"
7590 "*uuid_is_null*(3),\n"
7591 "*uuid_parse*(3),\n"
7593 "*uuid_unparse*(3)\n"
7599 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7600 #. Redistribution and use in source and binary forms, with or without
7601 #. modification, are permitted provided that the following conditions
7603 #. 1. Redistributions of source code must retain the above copyright
7604 #. notice, and the entire permission notice in its entirety,
7605 #. including the disclaimer of warranties.
7606 #. 2. Redistributions in binary form must reproduce the above copyright
7607 #. notice, this list of conditions and the following disclaimer in the
7608 #. documentation and/or other materials provided with the distribution.
7609 #. 3. The name of the author may not be used to endorse or promote
7610 #. products derived from this software without specific prior
7611 #. written permission.
7612 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7613 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7614 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7615 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7616 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7617 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7618 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7619 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7620 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7621 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7622 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7624 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7626 #: ../libuuid/man/uuid_clear.3.adoc:33
7628 msgid "uuid_clear(3)"
7632 #: ../libuuid/man/uuid_clear.3.adoc:44
7633 msgid "uuid_clear - reset value of UUID variable to the NULL value"
7637 #: ../libuuid/man/uuid_clear.3.adoc:50
7639 msgid "*void uuid_clear(uuid_t __uu__);*\n"
7643 #: ../libuuid/man/uuid_clear.3.adoc:54
7645 "The *uuid_clear*() function sets the value of the supplied uuid variable "
7646 "_uu_ to the NULL value."
7650 #: ../libuuid/man/uuid_clear.3.adoc:68
7654 "*uuid_compare*(3),\n"
7656 "*uuid_generate*(3),\n"
7657 "*uuid_is_null*(3),\n"
7658 "*uuid_parse*(3),\n"
7659 "*uuid_unparse*(3)\n"
7665 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7666 #. Redistribution and use in source and binary forms, with or without
7667 #. modification, are permitted provided that the following conditions
7669 #. 1. Redistributions of source code must retain the above copyright
7670 #. notice, and the entire permission notice in its entirety,
7671 #. including the disclaimer of warranties.
7672 #. 2. Redistributions in binary form must reproduce the above copyright
7673 #. notice, this list of conditions and the following disclaimer in the
7674 #. documentation and/or other materials provided with the distribution.
7675 #. 3. The name of the author may not be used to endorse or promote
7676 #. products derived from this software without specific prior
7677 #. written permission.
7678 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7679 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7680 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7681 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7682 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7683 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7684 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7685 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7686 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7687 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7688 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7690 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7692 #: ../libuuid/man/uuid_compare.3.adoc:33
7694 msgid "uuid_compare(3)"
7698 #: ../libuuid/man/uuid_compare.3.adoc:44
7699 msgid "uuid_compare - compare whether two UUIDs are the same"
7703 #: ../libuuid/man/uuid_compare.3.adoc:50
7705 msgid "*int uuid_compare(uuid_t __uu1__, uuid_t __uu2__)*\n"
7709 #: ../libuuid/man/uuid_compare.3.adoc:54
7711 "The *uuid_compare*() function compares the two supplied uuid variables _uu1_ "
7712 "and _uu2_ to each other."
7716 #: ../libuuid/man/uuid_compare.3.adoc:55 ../libuuid/man/uuid_copy.3.adoc:55
7717 #: ../libuuid/man/uuid_generate.3.adoc:72 ../libuuid/man/uuid_parse.3.adoc:58
7718 #: ../libuuid/man/uuid_time.3.adoc:55 ../schedutils/taskset.1.adoc:108
7720 msgid "RETURN VALUE"
7724 #: ../libuuid/man/uuid_compare.3.adoc:58
7726 "Returns an integer less than, equal to, or greater than zero if _uu1_ is "
7727 "found, respectively, to be lexicographically less than, equal, or greater "
7732 #: ../libuuid/man/uuid_compare.3.adoc:72
7736 "*uuid_clear*(3),\n"
7738 "*uuid_generate*(3),\n"
7739 "*uuid_is_null*(3),\n"
7740 "*uuid_parse*(3),\n"
7741 "*uuid_unparse*(3)\n"
7747 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7748 #. Redistribution and use in source and binary forms, with or without
7749 #. modification, are permitted provided that the following conditions
7751 #. 1. Redistributions of source code must retain the above copyright
7752 #. notice, and the entire permission notice in its entirety,
7753 #. including the disclaimer of warranties.
7754 #. 2. Redistributions in binary form must reproduce the above copyright
7755 #. notice, this list of conditions and the following disclaimer in the
7756 #. documentation and/or other materials provided with the distribution.
7757 #. 3. The name of the author may not be used to endorse or promote
7758 #. products derived from this software without specific prior
7759 #. written permission.
7760 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7761 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7762 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7763 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7764 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7765 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7766 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7767 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7768 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7769 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7770 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7772 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7774 #: ../libuuid/man/uuid_copy.3.adoc:33
7776 msgid "uuid_copy(3)"
7780 #: ../libuuid/man/uuid_copy.3.adoc:44
7781 msgid "uuid_copy - copy a UUID value"
7785 #: ../libuuid/man/uuid_copy.3.adoc:50
7787 msgid "*void uuid_copy(uuid_t __dst__, uuid_t __src__);*\n"
7791 #: ../libuuid/man/uuid_copy.3.adoc:54
7792 msgid "The *uuid_copy*() function copies the UUID variable _src_ to _dst_."
7796 #: ../libuuid/man/uuid_copy.3.adoc:58
7797 msgid "The copied UUID is returned in the location pointed to by _dst_."
7801 #: ../libuuid/man/uuid_copy.3.adoc:72
7805 "*uuid_clear*(3),\n"
7806 "*uuid_compare*(3),\n"
7807 "*uuid_generate*(3),\n"
7808 "*uuid_is_null*(3),\n"
7809 "*uuid_parse*(3),\n"
7810 "*uuid_unparse*(3)\n"
7816 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7818 #. Redistribution and use in source and binary forms, with or without
7819 #. modification, are permitted provided that the following conditions
7821 #. 1. Redistributions of source code must retain the above copyright
7822 #. notice, and the entire permission notice in its entirety,
7823 #. including the disclaimer of warranties.
7824 #. 2. Redistributions in binary form must reproduce the above copyright
7825 #. notice, this list of conditions and the following disclaimer in the
7826 #. documentation and/or other materials provided with the distribution.
7827 #. 3. The name of the author may not be used to endorse or promote
7828 #. products derived from this software without specific prior
7829 #. written permission.
7830 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7831 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7832 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7833 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7834 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7835 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7836 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7837 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7838 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7839 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7840 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7843 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7845 #: ../libuuid/man/uuid_generate.3.adoc:35
7847 msgid "uuid_generate(3)"
7851 #: ../libuuid/man/uuid_generate.3.adoc:46
7853 "uuid_generate, uuid_generate_random, uuid_generate_time, "
7854 "uuid_generate_time_safe - create a new unique UUID value"
7858 #: ../libuuid/man/uuid_generate.3.adoc:57
7861 "*void uuid_generate(uuid_t __out__);* +\n"
7862 "*void uuid_generate_random(uuid_t __out__);* +\n"
7863 "*void uuid_generate_time(uuid_t __out__);* +\n"
7864 "*int uuid_generate_time_safe(uuid_t __out__);* +\n"
7865 "*void uuid_generate_md5(uuid_t __out__, const uuid_t __ns__, const char __*name__, size_t __len__);* +\n"
7866 "*void uuid_generate_sha1(uuid_t __out__, const uuid_t __ns__, const char __*name__, size_t __len__);*\n"
7870 #: ../libuuid/man/uuid_generate.3.adoc:61
7872 "The *uuid_generate*() function creates a new universally unique identifier "
7873 "(UUID). The uuid will be generated based on high-quality randomness from "
7874 "*getrandom*(2), _/dev/urandom_, or _/dev/random_ if available. If it is not "
7875 "available, then *uuid_generate*() will use an alternative algorithm which "
7876 "uses the current time, the local ethernet MAC address (if available), and "
7877 "random data generated using a pseudo-random generator."
7881 #: ../libuuid/man/uuid_generate.3.adoc:63
7883 "The *uuid_generate_random*() function forces the use of the all-random UUID "
7884 "format, even if a high-quality random number generator is not available, in "
7885 "which case a pseudo-random generator will be substituted. Note that the use "
7886 "of a pseudo-random generator may compromise the uniqueness of UUIDs "
7887 "generated in this fashion."
7891 #: ../libuuid/man/uuid_generate.3.adoc:65
7893 "The *uuid_generate_time*() function forces the use of the alternative "
7894 "algorithm which uses the current time and the local ethernet MAC address (if "
7895 "available). This algorithm used to be the default one used to generate "
7896 "UUIDs, but because of the use of the ethernet MAC address, it can leak "
7897 "information about when and where the UUID was generated. This can cause "
7898 "privacy problems in some applications, so the *uuid_generate*() function "
7899 "only uses this algorithm if a high-quality source of randomness is not "
7900 "available. To guarantee uniqueness of UUIDs generated by concurrently "
7901 "running processes, the uuid library uses a global clock state counter (if "
7902 "the process has permissions to gain exclusive access to this file) and/or "
7903 "the *uuidd*(8) daemon, if it is running already or can be spawned by the "
7904 "process (if installed and the process has enough permissions to run it). If "
7905 "neither of these two synchronization mechanisms can be used, it is "
7906 "theoretically possible that two concurrently running processes obtain the "
7907 "same UUID(s). To tell whether the UUID has been generated in a safe manner, "
7908 "use *uuid_generate_time_safe*."
7912 #: ../libuuid/man/uuid_generate.3.adoc:67
7914 "The *uuid_generate_time_safe*() function is similar to "
7915 "*uuid_generate_time*(), except that it returns a value which denotes whether "
7916 "any of the synchronization mechanisms (see above) has been used."
7920 #: ../libuuid/man/uuid_generate.3.adoc:69
7922 "The UUID is 16 bytes (128 bits) long, which gives approximately 3.4x10^38 "
7923 "unique values (there are approximately 10^80 elementary particles in the "
7924 "universe according to Carl Sagan's _Cosmos_). The new UUID can reasonably be "
7925 "considered unique among all UUIDs created on the local system, and among "
7926 "UUIDs created on other systems in the past and in the future."
7930 #: ../libuuid/man/uuid_generate.3.adoc:71
7932 "The *uuid_generate_md5*() and *uuid_generate_sha1*() functions generate an "
7933 "MD5 and SHA1 hashed (predictable) UUID based on a well-known UUID providing "
7934 "the namespace and an arbitrary binary string. The UUIDs conform to V3 and V5 "
7935 "UUIDs per link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
7939 #: ../libuuid/man/uuid_generate.3.adoc:75
7941 "The newly created UUID is returned in the memory location pointed to by "
7942 "_out_. *uuid_generate_time_safe*() returns zero if the UUID has been "
7943 "generated in a safe manner, -1 otherwise."
7947 #: ../libuuid/man/uuid_generate.3.adoc:96
7952 "*uuid_clear*(3),\n"
7953 "*uuid_compare*(3),\n"
7955 "*uuid_is_null*(3),\n"
7956 "*uuid_parse*(3),\n"
7958 "*uuid_unparse*(3),\n"
7965 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7966 #. Redistribution and use in source and binary forms, with or without
7967 #. modification, are permitted provided that the following conditions
7969 #. 1. Redistributions of source code must retain the above copyright
7970 #. notice, and the entire permission notice in its entirety,
7971 #. including the disclaimer of warranties.
7972 #. 2. Redistributions in binary form must reproduce the above copyright
7973 #. notice, this list of conditions and the following disclaimer in the
7974 #. documentation and/or other materials provided with the distribution.
7975 #. 3. The name of the author may not be used to endorse or promote
7976 #. products derived from this software without specific prior
7977 #. written permission.
7978 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7979 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7980 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7981 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7982 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7983 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7984 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7985 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7986 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7987 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7988 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7990 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7992 #: ../libuuid/man/uuid_is_null.3.adoc:33
7994 msgid "uuid_is_null(3)"
7998 #: ../libuuid/man/uuid_is_null.3.adoc:44
7999 msgid "uuid_is_null - compare the value of the UUID to the NULL value"
8003 #: ../libuuid/man/uuid_is_null.3.adoc:50
8005 msgid "*int uuid_is_null(uuid_t __uu__);*\n"
8009 #: ../libuuid/man/uuid_is_null.3.adoc:54
8011 "The *uuid_is_null*() function compares the value of the supplied UUID "
8012 "variable _uu_ to the NULL value. If the value is equal to the NULL UUID, 1 "
8013 "is returned, otherwise 0 is returned."
8017 #: ../libuuid/man/uuid_is_null.3.adoc:69
8021 "*uuid_clear*(3),\n"
8022 "*uuid_compare*(3),\n"
8024 "*uuid_generate*(3),\n"
8026 "*uuid_parse*(3),\n"
8027 "*uuid_unparse*(3)\n"
8033 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8034 #. Redistribution and use in source and binary forms, with or without
8035 #. modification, are permitted provided that the following conditions
8037 #. 1. Redistributions of source code must retain the above copyright
8038 #. notice, and the entire permission notice in its entirety,
8039 #. including the disclaimer of warranties.
8040 #. 2. Redistributions in binary form must reproduce the above copyright
8041 #. notice, this list of conditions and the following disclaimer in the
8042 #. documentation and/or other materials provided with the distribution.
8043 #. 3. The name of the author may not be used to endorse or promote
8044 #. products derived from this software without specific prior
8045 #. written permission.
8046 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8047 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8048 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8049 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8050 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8051 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8052 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8053 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8054 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8055 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8056 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8058 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8060 #: ../libuuid/man/uuid_parse.3.adoc:33
8062 msgid "uuid_parse(3)"
8066 #: ../libuuid/man/uuid_parse.3.adoc:44
8067 msgid "uuid_parse - convert an input UUID string into binary representation"
8071 #: ../libuuid/man/uuid_parse.3.adoc:51
8074 "*int uuid_parse(char *__in__, uuid_t __uu__);* +\n"
8075 "*int uuid_parse_range(char *__in_start__, char *__in_end__, uuid_t __uu__);*\n"
8079 #: ../libuuid/man/uuid_parse.3.adoc:55
8081 "The *uuid_parse*() function converts the UUID string given by _in_ into the "
8082 "binary representation. The input UUID is a string of the form "
8083 "1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in *printf*(3) format \"%08x-%04x-%04x-"
8084 "%04x-%012x\", 36 bytes plus the trailing '\\0')."
8088 #: ../libuuid/man/uuid_parse.3.adoc:57
8090 "The *uuid_parse_range*() function works like *uuid_parse*() but parses only "
8091 "range in string specified by _in_start_ and _in_end_ pointers."
8095 #: ../libuuid/man/uuid_parse.3.adoc:61
8097 "Upon successfully parsing the input string, 0 is returned, and the UUID is "
8098 "stored in the location pointed to by _uu_, otherwise -1 is returned."
8102 #: ../libuuid/man/uuid_parse.3.adoc:65
8104 "This library parses UUIDs compatible with OSF DCE 1.1, and hash based UUIDs "
8105 "V3 and V5 compatible with link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
8109 #: ../libuuid/man/uuid_parse.3.adoc:80
8113 "*uuid_clear*(3),\n"
8114 "*uuid_compare*(3),\n"
8116 "*uuid_generate*(3),\n"
8117 "*uuid_is_null*(3),\n"
8119 "*uuid_unparse*(3)\n"
8125 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8126 #. Redistribution and use in source and binary forms, with or without
8127 #. modification, are permitted provided that the following conditions
8129 #. 1. Redistributions of source code must retain the above copyright
8130 #. notice, and the entire permission notice in its entirety,
8131 #. including the disclaimer of warranties.
8132 #. 2. Redistributions in binary form must reproduce the above copyright
8133 #. notice, this list of conditions and the following disclaimer in the
8134 #. documentation and/or other materials provided with the distribution.
8135 #. 3. The name of the author may not be used to endorse or promote
8136 #. products derived from this software without specific prior
8137 #. written permission.
8138 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8139 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8140 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8141 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8142 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8143 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8144 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8145 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8146 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8147 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8148 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8150 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8152 #: ../libuuid/man/uuid_time.3.adoc:33
8154 msgid "uuid_time(3)"
8158 #: ../libuuid/man/uuid_time.3.adoc:44
8159 msgid "uuid_time - extract the time at which the UUID was created"
8163 #: ../libuuid/man/uuid_time.3.adoc:50
8165 msgid "*time_t uuid_time(uuid_t __uu__, struct timeval *__ret_tv__)*\n"
8169 #: ../libuuid/man/uuid_time.3.adoc:54
8171 "The *uuid_time*() function extracts the time at which the supplied time-"
8172 "based UUID _uu_ was created. Note that the UUID creation time is only "
8173 "encoded within certain types of UUIDs. This function can only reasonably "
8174 "expect to extract the creation time for UUIDs created with the "
8175 "*uuid_generate_time*(3) and *uuid_generate_time_safe*(3) functions. It may "
8176 "or may not work with UUIDs created by other mechanisms."
8180 #: ../libuuid/man/uuid_time.3.adoc:58
8182 "The time at which the UUID was created, in seconds since January 1, 1970 GMT "
8183 "(the epoch), is returned (see *time*(2)). The time at which the UUID was "
8184 "created, in seconds and microseconds since the epoch, is also stored in the "
8185 "location pointed to by _ret_tv_ (see *gettimeofday*(2))."
8189 #: ../libuuid/man/uuid_time.3.adoc:73
8193 "*uuid_clear*(3),\n"
8194 "*uuid_compare*(3),\n"
8196 "*uuid_generate*(3),\n"
8197 "*uuid_is_null*(3),\n"
8198 "*uuid_parse*(3),\n"
8199 "*uuid_unparse*(3)\n"
8205 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8206 #. Redistribution and use in source and binary forms, with or without
8207 #. modification, are permitted provided that the following conditions
8209 #. 1. Redistributions of source code must retain the above copyright
8210 #. notice, and the entire permission notice in its entirety,
8211 #. including the disclaimer of warranties.
8212 #. 2. Redistributions in binary form must reproduce the above copyright
8213 #. notice, this list of conditions and the following disclaimer in the
8214 #. documentation and/or other materials provided with the distribution.
8215 #. 3. The name of the author may not be used to endorse or promote
8216 #. products derived from this software without specific prior
8217 #. written permission.
8218 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8219 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8220 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8221 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8222 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8223 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8224 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8225 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8226 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8227 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8228 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8230 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8232 #: ../libuuid/man/uuid_unparse.3.adoc:33
8234 msgid "uuid_unparse(3)"
8238 #: ../libuuid/man/uuid_unparse.3.adoc:44
8239 msgid "uuid_unparse - convert a UUID from binary representation to a string"
8243 #: ../libuuid/man/uuid_unparse.3.adoc:52
8246 "*void uuid_unparse(uuid_t __uu__, char *__out__);* +\n"
8247 "*void uuid_unparse_upper(uuid_t __uu__, char *__out__);* +\n"
8248 "*void uuid_unparse_lower(uuid_t __uu__, char *__out__);*\n"
8252 #: ../libuuid/man/uuid_unparse.3.adoc:56
8254 "The *uuid_unparse*() function converts the supplied UUID _uu_ from the "
8255 "binary representation into a 36-byte string (plus trailing '\\0') of the "
8256 "form 1b4e28ba-2fa1-11d2-883f-0016d3cca427 and stores this value in the "
8257 "character string pointed to by _out_. The case of the hex digits returned by "
8258 "*uuid_unparse*() may be upper or lower case, and is dependent on the system-"
8259 "dependent local default."
8263 #: ../libuuid/man/uuid_unparse.3.adoc:58
8265 "If the case of the hex digits is important then the functions "
8266 "*uuid_unparse_upper*() and *uuid_unparse_lower*() may be used."
8270 #: ../libuuid/man/uuid_unparse.3.adoc:62
8271 msgid "This library unparses UUIDs compatible with OSF DCE 1.1."
8275 #: ../libuuid/man/uuid_unparse.3.adoc:77
8279 "*uuid_clear*(3),\n"
8280 "*uuid_compare*(3),\n"
8282 "*uuid_generate*(3),\n"
8284 "*uuid_is_null*(3),\n"
8289 #. chfn.1 -- change your finger information
8290 #. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
8291 #. This program is free software. You can redistribute it and
8292 #. modify it under the terms of the GNU General Public License.
8293 #. There is no warranty.
8295 #: ../login-utils/chfn.1.adoc:10
8300 #. type: Attribute :man manual:
8301 #: ../login-utils/chfn.1.adoc:12 ../login-utils/chsh.1.adoc:12
8302 #: ../login-utils/last.1.adoc:21 ../login-utils/login.1.adoc:8
8303 #: ../login-utils/lslogins.1.adoc:6 ../login-utils/newgrp.1.adoc:6
8304 #: ../login-utils/runuser.1.adoc:4 ../login-utils/su.1.adoc:4
8305 #: ../login-utils/utmpdump.1.adoc:21 ../misc-utils/cal.1.adoc:41
8306 #: ../misc-utils/fadvise.1.adoc:4 ../misc-utils/fincore.1.adoc:9
8307 #: ../misc-utils/getopt.1.adoc:4 ../misc-utils/hardlink.1.adoc:10
8308 #: ../misc-utils/kill.1.adoc:9 ../misc-utils/logger.1.adoc:38
8309 #: ../misc-utils/look.1.adoc:38 ../misc-utils/lsfd.1.adoc:9
8310 #: ../misc-utils/mcookie.1.adoc:6 ../misc-utils/namei.1.adoc:4
8311 #: ../misc-utils/pipesz.1.adoc:4 ../misc-utils/rename.1.adoc:6
8312 #: ../misc-utils/uuidgen.1.adoc:8 ../misc-utils/uuidparse.1.adoc:6
8313 #: ../misc-utils/waitpid.1.adoc:4 ../misc-utils/whereis.1.adoc:38
8314 #: ../schedutils/chrt.1.adoc:28 ../schedutils/ionice.1.adoc:4
8315 #: ../schedutils/taskset.1.adoc:26 ../schedutils/uclampset.1.adoc:28
8316 #: ../sys-utils/choom.1.adoc:4 ../sys-utils/dmesg.1.adoc:8
8317 #: ../sys-utils/eject.1.adoc:12 ../sys-utils/fallocate.1.adoc:4
8318 #: ../sys-utils/flock.1.adoc:28 ../sys-utils/ipcmk.1.adoc:8
8319 #: ../sys-utils/ipcrm.1.adoc:8 ../sys-utils/ipcs.1.adoc:8
8320 #: ../sys-utils/irqtop.1.adoc:4 ../sys-utils/lscpu.1.adoc:4
8321 #: ../sys-utils/lsipc.1.adoc:4 ../sys-utils/lsirq.1.adoc:4
8322 #: ../sys-utils/lsmem.1.adoc:4 ../sys-utils/mountpoint.1.adoc:4
8323 #: ../sys-utils/nsenter.1.adoc:4 ../sys-utils/prlimit.1.adoc:9
8324 #: ../sys-utils/renice.1.adoc:38 ../sys-utils/setpriv.1.adoc:4
8325 #: ../sys-utils/setsid.1.adoc:6 ../sys-utils/unshare.1.adoc:4
8326 #: ../term-utils/mesg.1.adoc:38 ../term-utils/script.1.adoc:38
8327 #: ../term-utils/scriptlive.1.adoc:4 ../term-utils/scriptreplay.1.adoc:4
8328 #: ../term-utils/setterm.1.adoc:11 ../term-utils/wall.1.adoc:39
8329 #: ../term-utils/write.1.adoc:41 ../text-utils/col.1.adoc:41
8330 #: ../text-utils/colcrt.1.adoc:38 ../text-utils/colrm.1.adoc:38
8331 #: ../text-utils/column.1.adoc:38 ../text-utils/hexdump.1.adoc:38
8332 #: ../text-utils/line.1.adoc:5 ../text-utils/more.1.adoc:41
8333 #: ../text-utils/pg.1.adoc:5 ../text-utils/rev.1.adoc:38
8334 #: ../text-utils/ul.1.adoc:38
8336 msgid "User Commands"
8337 msgstr "Příručka uživatele"
8340 #: ../login-utils/chfn.1.adoc:20
8341 msgid "chfn - change your finger information"
8345 #: ../login-utils/chfn.1.adoc:24
8347 msgid "*chfn* [*-f* _full-name_] [*-o* _office_] [*-p* _office-phone_] [*-h* _home-phone_] [*-u*] [*-V*] [_username_]\n"
8351 #: ../login-utils/chfn.1.adoc:28
8353 msgid "*chfn* is used to change your finger information. This information is stored in the _/etc/passwd_ file, and is displayed by the *finger* program. The Linux *finger* command will display four pieces of information that can be changed by *chfn*: your real name, your work room and phone, and your home phone.\n"
8357 #: ../login-utils/chfn.1.adoc:30
8359 "Any of the four pieces of information can be specified on the command line. "
8360 "If no information is given on the command line, *chfn* enters interactive "
8365 #: ../login-utils/chfn.1.adoc:32
8367 "In interactive mode, *chfn* will prompt for each field. At a prompt, you can "
8368 "enter the new information, or just press return to leave the field "
8369 "unchanged. Enter the keyword \"none\" to make the field blank."
8373 #: ../login-utils/chfn.1.adoc:34
8375 msgid "*chfn* supports non-local entries (kerberos, LDAP, etc.) if linked with libuser, otherwise use *ypchfn*(1), *lchfn*(1) or any other implementation for non-local entries.\n"
8378 #. type: Labeled list
8379 #: ../login-utils/chfn.1.adoc:37
8381 msgid "*-f*, *--full-name* _full-name_"
8385 #: ../login-utils/chfn.1.adoc:39
8386 msgid "Specify your real name."
8389 #. type: Labeled list
8390 #: ../login-utils/chfn.1.adoc:40
8392 msgid "*-o*, *--office* _office_"
8396 #: ../login-utils/chfn.1.adoc:42
8397 msgid "Specify your office room number."
8400 #. type: Labeled list
8401 #: ../login-utils/chfn.1.adoc:43
8403 msgid "*-p*, *--office-phone* _office-phone_"
8407 #: ../login-utils/chfn.1.adoc:45
8408 msgid "Specify your office phone number."
8411 #. type: Labeled list
8412 #: ../login-utils/chfn.1.adoc:46
8414 msgid "*-h*, *--home-phone* _home-phone_"
8418 #: ../login-utils/chfn.1.adoc:48
8419 msgid "Specify your home phone number."
8422 #. type: Labeled list
8423 #: ../login-utils/chfn.1.adoc:49
8425 #| msgid "*-h*, *--help*"
8426 msgid "*-u*, *--help*"
8427 msgstr "*-h*, *--help*"
8430 #: ../login-utils/chfn.1.adoc:55 ../login-utils/chsh.1.adoc:46
8432 "Print version and exit. The short options *-V* have been used since version "
8433 "2.39; old versions use deprecated *-v*."
8437 #: ../login-utils/chfn.1.adoc:58 ../login-utils/login.1.adoc:57
8438 #: ../term-utils/agetty.8.adoc:185
8440 #| msgid "CONFIG FILES"
8441 msgid "CONFIG FILE ITEMS"
8442 msgstr "KONFIGURAČNÍ SOUBORY"
8445 #: ../login-utils/chfn.1.adoc:61
8447 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
8448 msgid "*chfn* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)). Note that the configuration file could be distributed with another package (e.g., shadow-utils). The following configuration items are relevant for *chfn*:\n"
8449 msgstr "*su* čte konfigurační soubory _/etc/default/su_ a _/etc/login.defs_. Následující konfigurační položky jsou relevantní pro *su*{colon}\n"
8451 #. type: Labeled list
8452 #: ../login-utils/chfn.1.adoc:62
8454 msgid "*CHFN_RESTRICT* _string_"
8458 #: ../login-utils/chfn.1.adoc:65
8459 msgid "Indicate which fields are changeable by *chfn*."
8463 #: ../login-utils/chfn.1.adoc:67
8465 "The boolean setting *\"yes\"* means that only the Office, Office Phone and "
8466 "Home Phone fields are changeable, and boolean setting *\"no\"* means that "
8467 "also the Full Name is changeable."
8471 #: ../login-utils/chfn.1.adoc:69
8473 "Another way to specify changeable fields is by abbreviations: f = Full Name, "
8474 "r = Office (room), w = Office (work) Phone, h = Home Phone. For example, "
8475 "*CHFN_RESTRICT \"wh\"* allows changing work and home phone numbers."
8479 #: ../login-utils/chfn.1.adoc:71
8481 "If *CHFN_RESTRICT* is undefined, then all finger information is read-only. "
8482 "This is the default."
8486 #: ../login-utils/chfn.1.adoc:75 ../login-utils/chsh.1.adoc:58
8487 #: ../sys-utils/eject.1.adoc:96
8489 "Returns 0 if operation was successful, 1 if operation failed or command "
8490 "syntax was not valid."
8494 #: ../login-utils/chfn.1.adoc:79 ../login-utils/chsh.1.adoc:62
8495 msgid "mailto:svalente@mit.edu[Salvatore Valente]"
8499 #: ../login-utils/chfn.1.adoc:86
8504 "*login.defs*(5),\n"
8509 #. chsh.1 -- change your login shell
8510 #. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
8511 #. This program is free software. You can redistribute it and
8512 #. modify it under the terms of the GNU General Public License.
8513 #. There is no warranty.
8515 #: ../login-utils/chsh.1.adoc:10
8521 #: ../login-utils/chsh.1.adoc:20
8522 msgid "chsh - change your login shell"
8526 #: ../login-utils/chsh.1.adoc:24
8528 msgid "*chsh* [*-s* _shell_] [*-l*] [*-h*] [*-V*] [_username_]\n"
8532 #: ../login-utils/chsh.1.adoc:28
8534 msgid "*chsh* is used to change your login shell. If a shell is not given on the command line, *chsh* prompts for one.\n"
8538 #: ../login-utils/chsh.1.adoc:30
8540 msgid "*chsh* supports non-local entries (kerberos, LDAP, etc.) if linked with libuser, otherwise use *ypchsh*(1), *lchsh*(1) or any other implementation for non-local entries.\n"
8543 #. type: Labeled list
8544 #: ../login-utils/chsh.1.adoc:33 ../misc-utils/getopt.1.adoc:53
8546 #| msgid "*-s*, **--shell**=__shell__"
8547 msgid "*-s*, *--shell* _shell_"
8548 msgstr "*-s*, **--shell**=__shell__"
8551 #: ../login-utils/chsh.1.adoc:35
8552 msgid "Specify your login shell."
8555 #. type: Labeled list
8556 #: ../login-utils/chsh.1.adoc:36
8558 #| msgid "*-h*, *--help*"
8559 msgid "*-l*, *--list-shells*"
8560 msgstr "*-h*, *--help*"
8563 #: ../login-utils/chsh.1.adoc:38
8564 msgid "Print the list of shells listed in _/etc/shells_ and exit."
8568 #: ../login-utils/chsh.1.adoc:42
8570 "Display help text and exit. The short options *-h* have been used since "
8571 "version 2.30; old versions use deprecated *-u*."
8575 #: ../login-utils/chsh.1.adoc:49
8577 msgid "VALID SHELLS"
8581 #: ../login-utils/chsh.1.adoc:52
8583 msgid "*chsh* will accept the full pathname of any executable file on the system.\n"
8587 #: ../login-utils/chsh.1.adoc:54
8589 "The default behavior for non-root users is to accept only shells listed in "
8590 "the _/etc/shells_ file, and issue a warning for root user. It can also be "
8591 "configured at compile-time to only issue a warning for all users."
8595 #: ../login-utils/chsh.1.adoc:69
8598 #| "*setpriv*(1),\n"
8599 #| "*login.defs*(5),\n"
8605 "*login.defs*(5),\n"
8610 "*login.defs*(5),\n"
8618 #. Copyright (C) 1998-2004 Miquel van Smoorenburg.
8619 #. This program is free software; you can redistribute it and/or modify
8620 #. it under the terms of the GNU General Public License as published by
8621 #. the Free Software Foundation; either version 2 of the License, or
8622 #. (at your option) any later version.
8623 #. This program is distributed in the hope that it will be useful,
8624 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
8625 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8626 #. GNU General Public License for more details.
8627 #. You should have received a copy of the GNU General Public License
8628 #. along with this program; if not, write to the Free Software
8629 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8631 #: ../login-utils/last.1.adoc:19
8637 #: ../login-utils/last.1.adoc:29
8638 msgid "last, lastb - show a listing of last logged in users"
8642 #: ../login-utils/last.1.adoc:33
8644 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
8645 msgid "*last* [options] [_username_...] [_tty_...]\n"
8646 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
8649 #: ../login-utils/last.1.adoc:35
8651 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
8652 msgid "*lastb* [options] [_username_...] [_tty_...]\n"
8653 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
8656 #: ../login-utils/last.1.adoc:39
8658 msgid "*last* searches back through the _/var/log/wtmp_ file (or the file designated by the *-f* option) and displays a list of all users logged in (and out) since that file was created. One or more _usernames_ and/or _ttys_ can be given, in which case *last* will show only the entries matching those arguments. Names of _ttys_ can be abbreviated, thus *last 0* is the same as *last tty0*.\n"
8662 #: ../login-utils/last.1.adoc:41
8664 "When catching a *SIGINT* signal (generated by the interrupt key, usually "
8665 "control-C) or a *SIGQUIT* signal, *last* will show how far it has searched "
8666 "through the file; in the case of the *SIGINT* signal *last* will then "
8671 #: ../login-utils/last.1.adoc:43
8673 "The pseudo user *reboot* logs in each time the system is rebooted. Thus "
8674 "*last reboot* will show a log of all the reboots since the log file was "
8679 #: ../login-utils/last.1.adoc:45
8681 msgid "*lastb* is the same as *last*, except that by default it shows a log of the _/var/log/btmp_ file, which contains all the bad login attempts.\n"
8684 #. type: Labeled list
8685 #: ../login-utils/last.1.adoc:48
8687 #| msgid "*-f*, *--fast*"
8688 msgid "*-a*, *--hostlast*"
8689 msgstr "*-f*, *--fast*"
8692 #: ../login-utils/last.1.adoc:50
8694 "Display the hostname in the last column. Useful in combination with the *--"
8698 #. type: Labeled list
8699 #: ../login-utils/last.1.adoc:51
8701 #| msgid "*-f*, *--fast*"
8702 msgid "*-d*, *--dns*"
8703 msgstr "*-f*, *--fast*"
8706 #: ../login-utils/last.1.adoc:53
8708 "For non-local logins, Linux stores not only the host name of the remote "
8709 "host, but its IP number as well. This option translates the IP number back "
8713 #. type: Labeled list
8714 #: ../login-utils/last.1.adoc:54 ../misc-utils/logger.1.adoc:67
8715 #: ../misc-utils/mcookie.1.adoc:31
8717 #| msgid "*-f*, *--fast*"
8718 msgid "*-f*, *--file* _file_"
8719 msgstr "*-f*, *--fast*"
8722 #: ../login-utils/last.1.adoc:56
8724 "Tell *last* to use a specific _file_ instead of _/var/log/wtmp_. The *--"
8725 "file* option can be given multiple times, and all of the specified files "
8726 "will be processed."
8729 #. type: Labeled list
8730 #: ../login-utils/last.1.adoc:57
8732 #| msgid "*-f*, *--fast*"
8733 msgid "*-F*, *--fulltimes*"
8734 msgstr "*-f*, *--fast*"
8737 #: ../login-utils/last.1.adoc:59
8738 msgid "Print full login and logout times and dates."
8741 #. type: Labeled list
8742 #: ../login-utils/last.1.adoc:60
8744 #| msgid "*-P*, *--pty*"
8745 msgid "*-i*, *--ip*"
8746 msgstr "*-P*, *--pty*"
8749 #: ../login-utils/last.1.adoc:62
8750 msgid "Like *--dns ,* but displays the host's IP number instead of the name."
8753 #. type: Labeled list
8754 #: ../login-utils/last.1.adoc:63
8756 msgid "**-**__number__; *-n*, *--limit* _number_"
8760 #: ../login-utils/last.1.adoc:65
8761 msgid "Tell *last* how many lines to show."
8764 #. type: Labeled list
8765 #: ../login-utils/last.1.adoc:66
8767 #| msgid "*-m*, *-p*, *--preserve-environment*"
8768 msgid "*-p*, *--present* _time_"
8769 msgstr "*-m*, *-p*, *--preserve-environment*"
8772 #: ../login-utils/last.1.adoc:68
8774 "Display the users who were present at the specified time. This is like using "
8775 "the options *--since* and *--until* together with the same _time_."
8778 #. type: Labeled list
8779 #: ../login-utils/last.1.adoc:69
8781 #| msgid "*-h*, *--help*"
8782 msgid "*-R*, *--nohostname*"
8783 msgstr "*-h*, *--help*"
8786 #: ../login-utils/last.1.adoc:71
8787 msgid "Suppresses the display of the hostname field."
8790 #. type: Labeled list
8791 #: ../login-utils/last.1.adoc:72
8793 #| msgid "*-V*, *--version*"
8794 msgid "*-s*, *--since* _time_"
8795 msgstr "*-V*, *--version*"
8798 #: ../login-utils/last.1.adoc:74
8800 "Display the state of logins since the specified _time_. This is useful, e."
8801 "g., to easily determine who was logged in at a particular time. The option "
8802 "is often combined with *--until*."
8805 #. type: Labeled list
8806 #: ../login-utils/last.1.adoc:75
8808 msgid "*-t*, *--until* _time_"
8812 #: ../login-utils/last.1.adoc:77
8813 msgid "Display the state of logins until the specified _time_."
8816 #. type: Labeled list
8817 #: ../login-utils/last.1.adoc:78
8819 #| msgid "*-h*, *--help*"
8820 msgid "*-T*, *--tab-separated*"
8821 msgstr "*-h*, *--help*"
8824 #: ../login-utils/last.1.adoc:80
8826 "Use ASCII *tab* characters to separate the columns in the output instead of "
8830 #. type: Labeled list
8831 #: ../login-utils/last.1.adoc:81 ../sys-utils/dmesg.1.adoc:135
8833 msgid "*--time-format* _format_"
8837 #: ../login-utils/last.1.adoc:83
8839 "Define the output timestamp _format_ to be one of _notime_, _short_, _full_, "
8840 "or _iso_. The _notime_ variant will not print any timestamps at all, _short_ "
8841 "is the default, and _full_ is the same as the *--fulltimes* option. The "
8842 "_iso_ variant will display the timestamp in ISO-8601 format. The ISO format "
8843 "contains timezone information, making it preferable when printouts are "
8844 "investigated outside of the system."
8847 #. type: Labeled list
8848 #: ../login-utils/last.1.adoc:84
8850 #| msgid "*-f*, *--fast*"
8851 msgid "*-w*, *--fullnames*"
8852 msgstr "*-f*, *--fast*"
8855 #: ../login-utils/last.1.adoc:86
8856 msgid "Display full user names and domain names in the output."
8859 #. type: Labeled list
8860 #: ../login-utils/last.1.adoc:87
8862 #| msgid "*-f*, *--fast*"
8863 msgid "*-x*, *--system*"
8864 msgstr "*-f*, *--fast*"
8867 #: ../login-utils/last.1.adoc:89
8868 msgid "Display the system shutdown entries and run level changes."
8872 #: ../login-utils/last.1.adoc:92
8874 msgid "TIME FORMATS"
8878 #: ../login-utils/last.1.adoc:95
8880 "The options that take the _time_ argument understand the following formats:"
8884 #: ../login-utils/last.1.adoc:110
8887 "|YYYYMMDDhhmmss |\n"
8888 "|YYYY-MM-DD hh:mm:ss |\n"
8889 "|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
8890 "|YYYY-MM-DD |(time will be set to 00:00:00)\n"
8891 "|hh:mm:ss |(date will be set to today)\n"
8892 "|hh:mm |(date will be set to today, seconds to 00)\n"
8894 "|yesterday |(time is set to 00:00:00)\n"
8895 "|today |(time is set to 00:00:00)\n"
8896 "|tomorrow |(time is set to 00:00:00)\n"
8902 #: ../login-utils/last.1.adoc:116
8903 msgid "_/var/log/wtmp_, _/var/log/btmp_"
8907 #: ../login-utils/last.1.adoc:120
8909 "The files _wtmp_ and _btmp_ might not be found. The system only logs "
8910 "information in these files if they are present. This is a local "
8911 "configuration issue. If you want the files to be used, they can be created "
8912 "with a simple *touch*(1) command (for example, *touch /var/log/wtmp*)."
8916 #: ../login-utils/last.1.adoc:122
8918 "An empty entry is a valid type of wtmp entry. It means that an empty file or "
8919 "file with zeros is not interpreted as an error."
8923 #: ../login-utils/last.1.adoc:124
8925 "The utmp file format uses fixed sizes of strings, which means that very long "
8926 "strings are impossible to store in the file and impossible to display by "
8927 "*last*. The usual limits are 32 bytes for a user and line name and 256 bytes "
8932 #: ../login-utils/last.1.adoc:128
8933 msgid "mailto:miquels@cistron.nl[Miquel van Smoorenburg]"
8937 #: ../login-utils/last.1.adoc:135
8940 #| "*getmntent*(3),\n"
8942 #| "*findmnt*(8),\n"
8957 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
8958 #. May be distributed under the GNU General Public License
8960 #: ../login-utils/login.1.adoc:6
8966 #: ../login-utils/login.1.adoc:16
8967 msgid "login - begin session on the system"
8971 #: ../login-utils/login.1.adoc:20
8973 msgid "*login* [*-p*] [*-h* _host_] [*-H*] [*-f* _username_|_username_]\n"
8977 #: ../login-utils/login.1.adoc:24
8979 msgid "*login* is used when signing onto a system. If no argument is given, *login* prompts for the username.\n"
8983 #: ../login-utils/login.1.adoc:26
8985 "The user is then prompted for a password, where appropriate. Echoing is "
8986 "disabled to prevent revealing the password. Only a number of password "
8987 "failures are permitted before *login* exits and the communications link is "
8988 "severed. See *LOGIN_RETRIES* in the *CONFIG FILE ITEMS* section."
8992 #: ../login-utils/login.1.adoc:28
8994 "If password aging has been enabled for the account, the user may be prompted "
8995 "for a new password before proceeding. In such case old password must be "
8996 "provided and the new password entered before continuing. Please refer to "
8997 "*passwd*(1) for more information."
9001 #: ../login-utils/login.1.adoc:30
9003 "The user and group ID will be set according to their values in the _/etc/"
9004 "passwd_ file. There is one exception if the user ID is zero. In this case, "
9005 "only the primary group ID of the account is set. This should allow the "
9006 "system administrator to login even in case of network problems. The "
9007 "environment variable values for *$HOME*, *$USER*, *$SHELL*, *$PATH*, "
9008 "*$LOGNAME*, and *$MAIL* are set according to the appropriate fields in the "
9009 "password entry. *$PATH* defaults to _/usr/local/bin:/bin:/usr/bin_ for "
9010 "normal users, and to _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/"
9011 "usr/bin_ for root, if not otherwise configured."
9015 #: ../login-utils/login.1.adoc:32
9017 "The environment variable *$TERM* will be preserved, if it exists, else it "
9018 "will be initialized to the terminal type on your tty. Other environment "
9019 "variables are preserved if the *-p* option is given."
9023 #: ../login-utils/login.1.adoc:34
9024 msgid "The environment variables defined by PAM are always preserved."
9028 #: ../login-utils/login.1.adoc:36
9030 "Then the user's shell is started. If no shell is specified for the user in _/"
9031 "etc/passwd_, then _/bin/sh_ is used. If there is no home directory specified "
9032 "in _/etc/passwd_, then _/_ is used, followed by _.hushlogin_ check as "
9037 #: ../login-utils/login.1.adoc:38
9039 "If the file _.hushlogin_ exists, then a \"quiet\" login is performed. This "
9040 "disables the checking of mail and the printing of the last login time and "
9041 "message of the day. Otherwise, if _/var/log/lastlog_ exists, the last login "
9042 "time is printed, and the current login is recorded."
9046 #: ../login-utils/login.1.adoc:43
9047 msgid "Used by *getty*(8) to tell *login* to preserve the environment."
9050 #. type: Labeled list
9051 #: ../login-utils/login.1.adoc:44 ../misc-utils/whereis.1.adoc:94
9052 #: ../text-utils/pg.1.adoc:45
9058 #: ../login-utils/login.1.adoc:46
9060 "Used to skip a login authentication. This option is usually used by the "
9061 "*getty*(8) autologin feature."
9064 #. type: Labeled list
9065 #: ../login-utils/login.1.adoc:47
9071 #: ../login-utils/login.1.adoc:49
9073 "Used by other servers (such as *telnetd*(8) to pass the name of the remote "
9074 "host to *login* so that it can be placed in utmp and wtmp. Only the "
9075 "superuser is allowed use this option."
9079 #: ../login-utils/login.1.adoc:51
9081 "Note that the *-h* option has an impact on the *PAM service* *name*. The "
9082 "standard service name is _login_, but with the *-h* option, the name is "
9083 "_remote_. It is necessary to create proper PAM config files (for example, _/"
9084 "etc/pam.d/login_ and _/etc/pam.d/remote_)."
9087 #. type: Labeled list
9088 #: ../login-utils/login.1.adoc:52
9094 #: ../login-utils/login.1.adoc:54
9096 "Used by other servers (for example, *telnetd*(8)) to tell *login* that "
9097 "printing the hostname should be suppressed in the login: prompt. See also "
9098 "*LOGIN_PLAIN_PROMPT* below."
9102 #: ../login-utils/login.1.adoc:60
9104 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
9105 msgid "*login* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for *login*:\n"
9106 msgstr "*su* čte konfigurační soubory _/etc/default/su_ a _/etc/login.defs_. Následující konfigurační položky jsou relevantní pro *su*{colon}\n"
9108 #. type: Labeled list
9109 #: ../login-utils/login.1.adoc:61
9111 #| msgid "*ENV_PATH* (string)"
9112 msgid "*MOTD_FILE* (string)"
9113 msgstr "*ENV_PATH* (řetězec)"
9116 #: ../login-utils/login.1.adoc:63
9118 "Specifies a \":\" delimited list of \"message of the day\" files and "
9119 "directories to be displayed upon login. If the specified path is a directory "
9120 "then displays all files with .motd file extension in version-sort order from "
9125 #: ../login-utils/login.1.adoc:65
9127 "The default value is _/usr/share/misc/motd:/run/motd:/etc/motd_. If the "
9128 "*MOTD_FILE* item is empty or a quiet login is enabled, then the message of "
9129 "the day is not displayed. Note that the same functionality is also provided "
9130 "by the *pam_motd*(8) PAM module."
9134 #: ../login-utils/login.1.adoc:67
9135 msgid "The directories in the *MOTD_FILE* are supported since version 2.36."
9139 #: ../login-utils/login.1.adoc:69
9141 "Note that *login* does not implement any filenames overriding behavior like "
9142 "pam_motd (see also *MOTD_FIRSTONLY*), but all content from all files is "
9143 "displayed. It is recommended to keep extra logic in content generators and "
9144 "use _/run/motd.d_ rather than rely on overriding behavior hardcoded in "
9148 #. type: Labeled list
9149 #: ../login-utils/login.1.adoc:70
9151 msgid "*MOTD_FIRSTONLY* (boolean)"
9155 #: ../login-utils/login.1.adoc:73
9157 "Forces *login* to stop display content specified by *MOTD_FILE* after the "
9158 "first accessible item in the list. Note that a directory is one item in this "
9159 "case. This option allows *login* semantics to be configured to be more "
9160 "compatible with pam_motd. The default value is _no_."
9163 #. type: Labeled list
9164 #: ../login-utils/login.1.adoc:74 ../term-utils/agetty.8.adoc:190
9166 msgid "*LOGIN_PLAIN_PROMPT* (boolean)"
9170 #: ../login-utils/login.1.adoc:77
9172 "Tell *login* that printing the hostname should be suppressed in the login: "
9173 "prompt. This is an alternative to the *-H* command line option. The default "
9177 #. type: Labeled list
9178 #: ../login-utils/login.1.adoc:78
9180 #| msgid "*FAIL_DELAY* (number)"
9181 msgid "*LOGIN_TIMEOUT* (number)"
9182 msgstr "*FAIL_DELAY* (číslo)"
9185 #: ../login-utils/login.1.adoc:81
9186 msgid "Maximum time in seconds for login. The default value is _60_."
9189 #. type: Labeled list
9190 #: ../login-utils/login.1.adoc:82
9192 #| msgid "*FAIL_DELAY* (number)"
9193 msgid "*LOGIN_RETRIES* (number)"
9194 msgstr "*FAIL_DELAY* (číslo)"
9197 #: ../login-utils/login.1.adoc:85
9199 "Maximum number of login retries in case of a bad password. The default value "
9203 #. type: Labeled list
9204 #: ../login-utils/login.1.adoc:86
9206 msgid "*LOGIN_KEEP_USERNAME* (boolean)"
9210 #: ../login-utils/login.1.adoc:89
9212 "Tell *login* to only re-prompt for the password if authentication failed, "
9213 "but the username is valid. The default value is _no_."
9216 #. type: Labeled list
9217 #: ../login-utils/login.1.adoc:90 ../login-utils/su.1.adoc:91
9219 msgid "*FAIL_DELAY* (number)"
9220 msgstr "*FAIL_DELAY* (číslo)"
9223 #: ../login-utils/login.1.adoc:93
9225 "Delay in seconds before being allowed another three tries after a login "
9226 "failure. The default value is _5_."
9229 #. type: Labeled list
9230 #: ../login-utils/login.1.adoc:94
9232 #| msgid "*ENV_PATH* (string)"
9233 msgid "*TTYPERM* (string)"
9234 msgstr "*ENV_PATH* (řetězec)"
9237 #: ../login-utils/login.1.adoc:97
9239 "The terminal permissions. The default value is _0600_ or _0620_ if tty group "
9243 #. type: Labeled list
9244 #: ../login-utils/login.1.adoc:98
9246 #| msgid "*ENV_ROOTPATH* (string)"
9247 msgid "*TTYGROUP* (string)"
9248 msgstr "*ENV_ROOTPATH* (řetězec)"
9251 #: ../login-utils/login.1.adoc:101
9253 "The login tty will be owned by the *TTYGROUP*. The default value is _tty_. "
9254 "If the *TTYGROUP* does not exist, then the ownership of the terminal is set "
9255 "to the user's primary group."
9259 #: ../login-utils/login.1.adoc:103
9261 "The *TTYGROUP* can be either the name of a group or a numeric group "
9265 #. type: Labeled list
9266 #: ../login-utils/login.1.adoc:104
9268 msgid "*HUSHLOGIN_FILE* (string)"
9272 #: ../login-utils/login.1.adoc:107
9274 "If defined, this file can inhibit all the usual chatter during the login "
9275 "sequence. If a full pathname (for example, _/etc/hushlogins_) is specified, "
9276 "then hushed mode will be enabled if the user's name or shell are found in "
9277 "the file. If this global hush login file is empty then the hushed mode will "
9278 "be enabled for all users."
9282 #: ../login-utils/login.1.adoc:109
9284 "If a full pathname is not specified, then hushed mode will be enabled if the "
9285 "file exists in the user's home directory."
9289 #: ../login-utils/login.1.adoc:111
9291 "The default is to check _/etc/hushlogins_ and if it does not exist then _~/."
9296 #: ../login-utils/login.1.adoc:113
9298 "If the *HUSHLOGIN_FILE* item is empty, then all the checks are disabled."
9301 #. type: Labeled list
9302 #: ../login-utils/login.1.adoc:114
9304 #| msgid "*ALWAYS_SET_PATH* (boolean)"
9305 msgid "*DEFAULT_HOME* (boolean)"
9306 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
9309 #: ../login-utils/login.1.adoc:117
9311 "Indicate if login is allowed if we cannot change directory to the home "
9312 "directory. If set to _yes_, the user will login in the root (/) directory if "
9313 "it is not possible to change directory to their home. The default value is "
9317 #. type: Labeled list
9318 #: ../login-utils/login.1.adoc:118
9320 msgid "*LASTLOG_UID_MAX* (unsigned number)"
9324 #: ../login-utils/login.1.adoc:121
9326 "Highest user ID number for which the _lastlog_ entries should be updated. As "
9327 "higher user IDs are usually tracked by remote user identity and "
9328 "authentication services there is no need to create a huge sparse _lastlog_ "
9329 "file for them. No LASTLOG_UID_MAX option present in the configuration means "
9330 "that there is no user ID limit for writing _lastlog_ entries. The default "
9331 "value is _ULONG_MAX_."
9334 #. type: Labeled list
9335 #: ../login-utils/login.1.adoc:122
9337 #| msgid "*ALWAYS_SET_PATH* (boolean)"
9338 msgid "*LOG_UNKFAIL_ENAB* (boolean)"
9339 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
9342 #: ../login-utils/login.1.adoc:125
9344 "Enable display of unknown usernames when login failures are recorded. The "
9345 "default value is _no_."
9349 #: ../login-utils/login.1.adoc:127
9351 "Note that logging unknown usernames may be a security issue if a user enters "
9352 "their password instead of their login name."
9355 #. type: Labeled list
9356 #: ../login-utils/login.1.adoc:128 ../login-utils/runuser.1.adoc:85
9357 #: ../login-utils/su.1.adoc:94
9359 msgid "*ENV_PATH* (string)"
9360 msgstr "*ENV_PATH* (řetězec)"
9363 #: ../login-utils/login.1.adoc:131
9366 #| "Defines the *PATH* environment variable for a regular user. The default "
9367 #| "value is _/usr/local/bin:/bin:/usr/bin_."
9369 "If set, it will be used to define the *PATH* environment variable when a "
9370 "regular user logs in. The default value is _/usr/local/bin:/bin:/usr/bin_."
9372 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
9373 "usr/local/bin:/bin:/usr/bin_."
9375 #. type: Labeled list
9376 #: ../login-utils/login.1.adoc:132 ../login-utils/runuser.1.adoc:88
9377 #: ../login-utils/su.1.adoc:97
9379 msgid "*ENV_ROOTPATH* (string)"
9380 msgstr "*ENV_ROOTPATH* (řetězec)"
9382 #. type: Labeled list
9383 #: ../login-utils/login.1.adoc:133 ../login-utils/runuser.1.adoc:89
9384 #: ../login-utils/su.1.adoc:98
9386 msgid "*ENV_SUPATH* (string)"
9387 msgstr "*ENV_SUPATH* (řetězec)"
9390 #: ../login-utils/login.1.adoc:136
9393 #| "Defines the *PATH* environment variable for root. *ENV_SUPATH* takes "
9394 #| "precedence. The default value is _/usr/local/sbin:/usr/local/bin:/sbin:/"
9395 #| "bin:/usr/sbin:/usr/bin_."
9397 "If set, it will be used to define the PATH environment variable when the "
9398 "superuser logs in. *ENV_ROOTPATH* takes precedence. The default value is _/"
9399 "usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_."
9401 "Určuje proměnnou prostředí *PATH* pro uživatele root. *ENV_SUPATH* má "
9402 "přednost. Výchozí hodnota je _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/"
9406 #: ../login-utils/login.1.adoc:150
9408 "_/var/run/utmp_, _/var/log/wtmp_, _/var/log/lastlog_, _/var/spool/mail/*_, _/"
9409 "etc/motd_, _/etc/passwd_, _/etc/nologin_, _/etc/pam.d/login_, _/etc/pam.d/"
9410 "remote_, _/etc/hushlogins_, _$HOME/.hushlogin_"
9414 #: ../login-utils/login.1.adoc:151 ../term-utils/agetty.8.adoc:322
9420 #: ../login-utils/login.1.adoc:154
9422 msgid "*login* supports configuration via systemd credentials (see https://systemd.io/CREDENTIALS/). *login* reads the following systemd credentials:\n"
9425 #. type: Labeled list
9426 #: ../login-utils/login.1.adoc:155
9428 msgid "*login.noauth* (boolean)"
9432 #: ../login-utils/login.1.adoc:158
9434 "If set, configures *login* to skip login authentication, similarly to the *-"
9439 #: ../login-utils/login.1.adoc:162
9441 "The undocumented BSD *-r* option is not supported. This may be required by "
9442 "some *rlogind*(8) programs."
9446 #: ../login-utils/login.1.adoc:164
9448 "A recursive login, as used to be possible in the good old days, no longer "
9449 "works; for most purposes *su*(1) is a satisfactory substitute. Indeed, for "
9450 "security reasons, *login* does a *vhangup*(2) system call to remove any "
9451 "possible listening processes on the tty. This is to avoid password sniffing. "
9452 "If one uses the command *login*, then the surrounding shell gets killed by "
9453 "*vhangup*(2) because it's no longer the true owner of the tty. This can be "
9454 "avoided by using *exec login* in a top-level shell or xterm."
9458 #: ../login-utils/login.1.adoc:168
9460 "Derived from BSD login 5.40 (5/9/89) by mailto:glad@daimi.dk[Michael Glad] "
9461 "for HP-UX. Ported to Linux 0.12: mailto:poe@daimi.aau.dk[Peter Orbaek]. "
9462 "Rewritten to a PAM-only version by mailto:kzak@redhat.com[Karel Zak]"
9466 #: ../login-utils/login.1.adoc:180
9480 #. Copyright 2014 Ondrej Oprala (ondrej.oprala@gmail.com)
9481 #. May be distributed under the GNU General Public License
9483 #: ../login-utils/lslogins.1.adoc:4
9489 #: ../login-utils/lslogins.1.adoc:14
9491 #| msgid "fstab - static information about the filesystems"
9492 msgid "lslogins - display information about known users in the system"
9493 msgstr "fstab - statická informace o souborových systémech"
9496 #: ../login-utils/lslogins.1.adoc:18
9498 msgid "*lslogins* [options] [*-s*|*-u*[=_UID_]] [*-g* _groups_] [*-l* _logins_] [_username_]\n"
9502 #: ../login-utils/lslogins.1.adoc:22
9504 "Examine the wtmp and btmp logs, _/etc/shadow_ (if necessary) and _/passwd_ "
9505 "and output the desired data."
9509 #: ../login-utils/lslogins.1.adoc:24
9511 "The optional argument _username_ forces *lslogins* to print all available "
9512 "details about the specified user only. In this case the output format is "
9513 "different than in case of *-l* or *-g* and unknown is _username_ reported as "
9518 #: ../login-utils/lslogins.1.adoc:26
9519 msgid "The default action is to list info about all the users in the system."
9523 #: ../login-utils/lslogins.1.adoc:30
9525 "Mandatory arguments to long options are mandatory for short options too."
9528 #. type: Labeled list
9529 #: ../login-utils/lslogins.1.adoc:31
9531 #| msgid "*-V*, *--version*"
9532 msgid "*-a*, *--acc-expiration*"
9533 msgstr "*-V*, *--version*"
9536 #: ../login-utils/lslogins.1.adoc:33
9538 "Display data about the date of last password change and the account "
9539 "expiration date (see *shadow*(5) for more info). (Requires root privileges.)"
9542 #. type: Labeled list
9543 #: ../login-utils/lslogins.1.adoc:34
9545 msgid "*--btmp-file* _path_"
9549 #: ../login-utils/lslogins.1.adoc:36
9550 msgid "Alternate path for btmp."
9553 #. type: Labeled list
9554 #: ../login-utils/lslogins.1.adoc:37
9556 msgid "*-c*, *--colon-separate*"
9560 #: ../login-utils/lslogins.1.adoc:39
9561 msgid "Separate info about each user with a colon instead of a newline."
9564 #. type: Labeled list
9565 #: ../login-utils/lslogins.1.adoc:40 ../sys-utils/lsipc.1.adoc:47
9567 #| msgid "*-P*, *--pty*"
9568 msgid "*-e*, *--export*"
9569 msgstr "*-P*, *--pty*"
9572 #: ../login-utils/lslogins.1.adoc:42
9573 msgid "Output data in the format of NAME=VALUE. See also option *--shell*."
9576 #. type: Labeled list
9577 #: ../login-utils/lslogins.1.adoc:43
9579 #| msgid "*-f*, *--fast*"
9580 msgid "*-f*, *--failed*"
9581 msgstr "*-f*, *--fast*"
9584 #: ../login-utils/lslogins.1.adoc:45
9585 msgid "Display data about the users' last failed login attempts."
9588 #. type: Labeled list
9589 #: ../login-utils/lslogins.1.adoc:46
9591 #| msgid "*-G*, **--supp-group**=__group__"
9592 msgid "*-G*, *--supp-groups*"
9593 msgstr "*-G*, **--supp-group**=__skupina__"
9596 #: ../login-utils/lslogins.1.adoc:48
9597 msgid "Show information about supplementary groups."
9600 #. type: Labeled list
9601 #: ../login-utils/lslogins.1.adoc:49
9603 #| msgid "*-g*, **--group**=__group__"
9604 msgid "*-g*, **--groups**=_groups_"
9605 msgstr "*-g*, **--group**=__skupina__"
9608 #: ../login-utils/lslogins.1.adoc:51
9610 "Only show data of users belonging to _groups_. More than one group may be "
9611 "specified; the list has to be comma-separated. Unknown group names are "
9616 #: ../login-utils/lslogins.1.adoc:53
9618 "Note that the relation between user and group may be invisible for the "
9619 "primary group if the user is not explicitly specified as group member (e.g., "
9620 "in _/etc/group_). If the command *lslogins* scans for groups then it uses "
9621 "the groups database only, and the user database with primary GID is not used "
9625 #. type: Labeled list
9626 #: ../login-utils/lslogins.1.adoc:54
9628 #| msgid "*-f*, *--fast*"
9629 msgid "*-L*, *--last*"
9630 msgstr "*-f*, *--fast*"
9633 #: ../login-utils/lslogins.1.adoc:56
9635 "Display data containing information about the users' last login sessions."
9638 #. type: Labeled list
9639 #: ../login-utils/lslogins.1.adoc:57
9641 #| msgid "*-*, *-l*, *--login*"
9642 msgid "*-l*, **--logins**=_logins_"
9643 msgstr "*-*, *-l*, *--login*"
9646 #: ../login-utils/lslogins.1.adoc:59
9648 "Only show data of users with a login specified in _logins_ (user names or "
9649 "user IDs). More than one login may be specified; the list has to be comma-"
9650 "separated. Unknown login names are ignored."
9653 #. type: Labeled list
9654 #: ../login-utils/lslogins.1.adoc:60 ../sys-utils/lsipc.1.adoc:56
9656 #| msgid "*-h*, *--help*"
9657 msgid "*-n*, *--newline*"
9658 msgstr "*-h*, *--help*"
9661 #: ../login-utils/lslogins.1.adoc:62 ../sys-utils/lsipc.1.adoc:58
9662 msgid "Display each piece of information on a separate line."
9665 #. type: Labeled list
9666 #: ../login-utils/lslogins.1.adoc:63 ../sys-utils/lsipc.1.adoc:59
9667 #: ../sys-utils/prlimit.1.adoc:43 ../sys-utils/swapon.8.adoc:77
9669 msgid "*--noheadings*"
9673 #: ../login-utils/lslogins.1.adoc:65 ../misc-utils/findmnt.8.adoc:92
9674 #: ../misc-utils/lsblk.8.adoc:87 ../misc-utils/lslocks.8.adoc:45
9675 #: ../misc-utils/uuidparse.1.adoc:55 ../misc-utils/wipefs.8.adoc:57
9676 #: ../sys-utils/lsipc.1.adoc:61 ../sys-utils/lsmem.1.adoc:44
9677 #: ../sys-utils/lsns.8.adoc:42 ../sys-utils/prlimit.1.adoc:45
9678 #: ../sys-utils/rfkill.8.adoc:32
9679 msgid "Do not print a header line."
9682 #. type: Labeled list
9683 #: ../login-utils/lslogins.1.adoc:66 ../misc-utils/lsfd.1.adoc:60
9684 #: ../sys-utils/lsipc.1.adoc:62
9686 msgid "*--notruncate*"
9690 #: ../login-utils/lslogins.1.adoc:68 ../sys-utils/lsipc.1.adoc:64
9691 msgid "Don't truncate output."
9695 #: ../login-utils/lslogins.1.adoc:71
9697 "Specify which output columns to print. The default list of columns may be "
9698 "extended if _list_ is specified in the format _+list_."
9702 #: ../login-utils/lslogins.1.adoc:74
9704 "Output all available columns. *--help* to get a list of all supported "
9708 #. type: Labeled list
9709 #: ../login-utils/lslogins.1.adoc:75
9711 #| msgid "*-P*, *--pty*"
9712 msgid "*-p*, *--pwd*"
9713 msgstr "*-P*, *--pty*"
9716 #: ../login-utils/lslogins.1.adoc:77
9717 msgid "Display information related to login by password (see also *-afL*)."
9721 #: ../login-utils/lslogins.1.adoc:80 ../sys-utils/lsipc.1.adoc:73
9722 msgid "Raw output (no columnation)."
9725 #. type: Labeled list
9726 #: ../login-utils/lslogins.1.adoc:81
9728 #| msgid "*-f*, *--fast*"
9729 msgid "*-s*, *--system-accs*"
9730 msgstr "*-f*, *--fast*"
9733 #: ../login-utils/lslogins.1.adoc:83
9735 "Show system accounts. These are by default all accounts with a UID between "
9736 "101 and 999 (inclusive), with the exception of either nobody or nfsnobody "
9737 "(UID 65534). This hardcoded default may be overwritten by parameters "
9738 "*SYS_UID_MIN* and *SYS_UID_MAX* in the file _/etc/login.defs_."
9741 #. type: Labeled list
9742 #: ../login-utils/lslogins.1.adoc:84 ../sys-utils/lsipc.1.adoc:77
9744 msgid "*--time-format* _type_"
9748 #: ../login-utils/lslogins.1.adoc:86 ../sys-utils/lsipc.1.adoc:79
9750 "Display dates in short, full or iso format. The default is short, this time "
9751 "format is designed to be space efficient and human readable."
9754 #. type: Labeled list
9755 #: ../login-utils/lslogins.1.adoc:87
9757 #| msgid "*-V*, *--version*"
9758 msgid "*-u*, *--user-accs*"
9759 msgstr "*-V*, *--version*"
9762 #: ../login-utils/lslogins.1.adoc:89
9764 "Show user accounts. These are by default all accounts with UID above 1000 "
9765 "(inclusive), with the exception of either nobody or nfsnobody (UID 65534). "
9766 "This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX "
9767 "in the file _/etc/login.defs_."
9770 #. type: Labeled list
9771 #: ../login-utils/lslogins.1.adoc:92
9773 msgid "*--wtmp-file* _path_"
9777 #: ../login-utils/lslogins.1.adoc:94
9778 msgid "Alternate path for wtmp."
9781 #. type: Labeled list
9782 #: ../login-utils/lslogins.1.adoc:95
9784 msgid "*--lastlog* _path_"
9788 #: ../login-utils/lslogins.1.adoc:97
9789 msgid "Alternate path for *lastlog*(8)."
9792 #. type: Labeled list
9793 #: ../login-utils/lslogins.1.adoc:98 ../misc-utils/findmnt.8.adoc:181
9794 #: ../misc-utils/lsblk.8.adoc:127 ../sys-utils/lsipc.1.adoc:83
9796 #| msgid "*-h*, *--help*"
9797 msgid "*-y*, *--shell*"
9798 msgstr "*-h*, *--help*"
9801 #: ../login-utils/lslogins.1.adoc:100 ../sys-utils/lsipc.1.adoc:85
9803 "The column name will be modified to contain only characters allowed for "
9804 "shell variable identifiers. This is usable, for example, with *--export*. "
9805 "Note that this feature has been automatically enabled for *--export* in "
9806 "version 2.37, but due to compatibility issues, now it's necessary to request "
9807 "this behavior by *--shell*."
9810 #. type: Labeled list
9811 #: ../login-utils/lslogins.1.adoc:101 ../misc-utils/namei.1.adoc:59
9813 #| msgid "*-P*, *--pty*"
9814 msgid "*-Z*, *--context*"
9815 msgstr "*-P*, *--pty*"
9818 #: ../login-utils/lslogins.1.adoc:103
9820 #| msgid "Display help text and exit."
9821 msgid "Display the users' security context."
9822 msgstr "Zobrazí text nápovědy a skončí."
9824 #. type: Labeled list
9825 #: ../login-utils/lslogins.1.adoc:104
9827 #| msgid "*-P*, *--pty*"
9828 msgid "*-z*, *--print0*"
9829 msgstr "*-P*, *--pty*"
9832 #: ../login-utils/lslogins.1.adoc:106
9833 msgid "Delimit user entries with a nul character, instead of a newline."
9837 #: ../login-utils/lslogins.1.adoc:111 ../sys-utils/lsipc.1.adoc:90
9841 #. type: Labeled list
9842 #: ../login-utils/lslogins.1.adoc:112 ../login-utils/runuser.1.adoc:103
9843 #: ../login-utils/su.1.adoc:112 ../misc-utils/lsblk.8.adoc:141
9844 #: ../sys-utils/fstrim.8.adoc:78 ../sys-utils/hwclock.8.adoc:295
9845 #: ../sys-utils/lsipc.1.adoc:91
9851 #: ../login-utils/lslogins.1.adoc:114 ../sys-utils/lsipc.1.adoc:93
9852 msgid "if incorrect arguments specified,"
9855 #. type: Labeled list
9856 #: ../login-utils/lslogins.1.adoc:115 ../sys-utils/hwclock.8.adoc:298
9857 #: ../sys-utils/lsipc.1.adoc:94
9863 #: ../login-utils/lslogins.1.adoc:117
9864 msgid "if a serious error occurs (e.g., a corrupt log)."
9868 #: ../login-utils/lslogins.1.adoc:121
9869 msgid "The default UID thresholds are read from _/etc/login.defs_."
9873 #: ../login-utils/lslogins.1.adoc:122
9875 msgid "Password status"
9879 #: ../login-utils/lslogins.1.adoc:125
9880 msgid "Multiple fields describe password status."
9883 #. type: Labeled list
9884 #: ../login-utils/lslogins.1.adoc:126
9886 msgid "*\"Password is locked\"*"
9890 #: ../login-utils/lslogins.1.adoc:128
9892 "The password is prefixed by '!!', and the user cannot login although the "
9893 "password is set or empty. This is common for new accounts without a set "
9897 #. type: Labeled list
9898 #: ../login-utils/lslogins.1.adoc:129
9900 msgid "*\"Password not required (empty)\"*"
9904 #: ../login-utils/lslogins.1.adoc:131
9906 "The password is not set (hash is missing); this is common for locked system "
9907 "accounts. Not requiring a password does not mean the user can log-in without "
9908 "a password. It depends on the password \"lock\" status."
9911 #. type: Labeled list
9912 #: ../login-utils/lslogins.1.adoc:132
9914 msgid "*\"Login by password disabled\"*"
9918 #: ../login-utils/lslogins.1.adoc:134
9920 "'yes' means that there is no valid password. The password hash is missing, "
9921 "or the hash method is unknown or contains invalid chars."
9925 #: ../login-utils/lslogins.1.adoc:135 ../login-utils/nologin.8.adoc:59
9926 #: ../login-utils/runuser.1.adoc:125 ../login-utils/su.1.adoc:141
9927 #: ../login-utils/vipw.8.adoc:68 ../misc-utils/cal.1.adoc:173
9928 #: ../misc-utils/look.1.adoc:90 ../misc-utils/lsfd.1.adoc:801
9929 #: ../sys-utils/fstab.5.adoc:135 ../sys-utils/lsipc.1.adoc:97
9930 #: ../sys-utils/mount.8.adoc:1666 ../sys-utils/renice.1.adoc:92
9931 #: ../sys-utils/rtcwake.8.adoc:118 ../sys-utils/swapon.8.adoc:163
9932 #: ../sys-utils/umount.8.adoc:169 ../term-utils/mesg.1.adoc:91
9933 #: ../term-utils/script.1.adoc:151 ../term-utils/wall.1.adoc:77
9934 #: ../term-utils/write.1.adoc:76 ../text-utils/col.1.adoc:123
9935 #: ../text-utils/colcrt.1.adoc:66 ../text-utils/colrm.1.adoc:63
9936 #: ../text-utils/column.1.adoc:181 ../text-utils/more.1.adoc:186
9937 #: ../text-utils/ul.1.adoc:72
9943 #: ../login-utils/lslogins.1.adoc:138
9945 "The *lslogins* utility is inspired by the *logins* utility, which first "
9946 "appeared in FreeBSD 4.10."
9950 #: ../login-utils/lslogins.1.adoc:143 ../sys-utils/lsipc.1.adoc:105
9952 "mailto:ooprala@redhat.com[Ondrej Oprala], mailto:kzak@redhat.com[Karel Zak]"
9956 #: ../login-utils/lslogins.1.adoc:150
9965 #. Original author unknown. This man page is in the public domain.
9966 #. Modified Sat Oct 9 17:46:48 1993 by faith@cs.unc.edu
9968 #: ../login-utils/newgrp.1.adoc:4
9974 #: ../login-utils/newgrp.1.adoc:14
9975 msgid "newgrp - log in to a new group"
9979 #: ../login-utils/newgrp.1.adoc:18
9981 msgid "*newgrp* [_group_]\n"
9985 #: ../login-utils/newgrp.1.adoc:22
9987 msgid "*newgrp* changes the group identification of its caller, analogously to *login*(1). The same person remains logged in, and the current directory is unchanged, but calculations of access permissions to files are performed with respect to the new group ID.\n"
9991 #: ../login-utils/newgrp.1.adoc:24
9992 msgid "If no group is specified, the GID is changed to the login GID."
9996 #: ../login-utils/newgrp.1.adoc:33
9997 msgid "_/etc/group_, _/etc/passwd_"
10000 #. type: Plain text
10001 #: ../login-utils/newgrp.1.adoc:37
10003 "Originally by Michael Haardt. Currently maintained by mailto:poe@daimi.aau."
10004 "dk[Peter Orbaek]."
10007 #. type: Plain text
10008 #: ../login-utils/newgrp.1.adoc:42
10016 #: ../login-utils/nologin.8.adoc:2
10021 #. type: Plain text
10022 #: ../login-utils/nologin.8.adoc:12
10023 msgid "nologin - politely refuse a login"
10026 #. type: Plain text
10027 #: ../login-utils/nologin.8.adoc:16
10029 msgid "*nologin* [*-V*] [*-h*]\n"
10032 #. type: Plain text
10033 #: ../login-utils/nologin.8.adoc:20
10035 msgid "*nologin* displays a message that an account is not available and exits non-zero. It is intended as a replacement shell field to deny login access to an account.\n"
10038 #. type: Plain text
10039 #: ../login-utils/nologin.8.adoc:22
10041 "If the file _/etc/nologin.txt_ exists, *nologin* displays its contents to "
10042 "the user instead of the default message."
10045 #. type: Plain text
10046 #: ../login-utils/nologin.8.adoc:24
10047 msgid "The exit status returned by *nologin* is always 1."
10050 #. type: Plain text
10051 #: ../login-utils/nologin.8.adoc:28
10053 #| msgid "*-c*, **--command**=__command__"
10054 msgid "*-c*, *--command* _command_\n"
10055 msgstr "*-c*, **--command**=__příkaz__"
10057 #. type: Plain text
10058 #: ../login-utils/nologin.8.adoc:30
10060 msgid "*--init-file*\n"
10063 #. type: Plain text
10064 #: ../login-utils/nologin.8.adoc:32
10066 msgid "*-i* *--interactive*\n"
10069 #. type: Plain text
10070 #: ../login-utils/nologin.8.adoc:34
10072 msgid "*--init-file* _file_\n"
10075 #. type: Plain text
10076 #: ../login-utils/nologin.8.adoc:36
10078 #| msgid "*-V*, *--version*"
10079 msgid "*-i*, *--interactive*\n"
10080 msgstr "*-V*, *--version*"
10082 #. type: Plain text
10083 #: ../login-utils/nologin.8.adoc:38
10085 #| msgid "*-*, *-l*, *--login*"
10086 msgid "*-l*, *--login*\n"
10087 msgstr "*-*, *-l*, *--login*"
10089 #. type: Plain text
10090 #: ../login-utils/nologin.8.adoc:40
10092 msgid "*--noprofile*\n"
10095 #. type: Plain text
10096 #: ../login-utils/nologin.8.adoc:42
10101 #. type: Plain text
10102 #: ../login-utils/nologin.8.adoc:44
10104 msgid "*--posix*\n"
10107 #. type: Plain text
10108 #: ../login-utils/nologin.8.adoc:46
10110 msgid "*--rcfile* _file_\n"
10113 #. type: Plain text
10114 #: ../login-utils/nologin.8.adoc:48
10116 #| msgid "*-V*, *--version*"
10117 msgid "*-r*, *--restricted*\n"
10118 msgstr "*-V*, *--version*"
10120 #. type: Plain text
10121 #: ../login-utils/nologin.8.adoc:50
10122 msgid "These shell command-line options are ignored to avoid *nologin* error."
10125 #. type: Plain text
10126 #: ../login-utils/nologin.8.adoc:56
10128 msgid "*nologin* is a per-account way to disable login (usually used for system accounts like http or ftp). *nologin* uses _/etc/nologin.txt_ as an optional source for a non-default message, the login access is always refused independently of the file.\n"
10131 #. type: Plain text
10132 #: ../login-utils/nologin.8.adoc:58
10134 msgid "*pam_nologin*(8) PAM module usually prevents all non-root users from logging into the system. *pam_nologin*(8) functionality is controlled by _/var/run/nologin_ or the _/etc/nologin_ file.\n"
10137 #. type: Plain text
10138 #: ../login-utils/nologin.8.adoc:62
10140 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
10141 msgid "The *nologin* command appeared in 4.4BSD."
10142 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
10144 #. type: Plain text
10145 #: ../login-utils/nologin.8.adoc:72
10150 "*pam_nologin*(8)\n"
10154 #: ../login-utils/runuser.1.adoc:2
10159 #. type: Plain text
10160 #: ../login-utils/runuser.1.adoc:12
10162 #| msgid "su - run a command with substitute user and group ID"
10163 msgid "runuser - run a command with substitute user and group ID"
10164 msgstr "su - spustí shell pod jiným uživatelským a skupinovým ID"
10166 #. type: Plain text
10167 #: ../login-utils/runuser.1.adoc:16
10169 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10170 msgid "*runuser* [options] *-u* _user_ [[--] _command_ [_argument_...]]\n"
10171 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10173 #. type: Plain text
10174 #: ../login-utils/runuser.1.adoc:18
10176 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10177 msgid "*runuser* [options] [*-*] [_user_ [_argument_...]]\n"
10178 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10180 #. type: Plain text
10181 #: ../login-utils/runuser.1.adoc:22
10183 msgid "*runuser* can be used to run commands with a substitute user and group ID. If the option *-u* is not given, *runuser* falls back to *su*-compatible semantics and a shell is executed. The difference between the commands *runuser* and *su* is that *runuser* does not ask for a password (because it may be executed by the root user only) and it uses a different PAM configuration. The command *runuser* does not have to be installed with set-user-ID permissions.\n"
10186 #. type: Plain text
10187 #: ../login-utils/runuser.1.adoc:24
10189 "If the PAM session is not required, then the recommended solution is to use "
10190 "the *setpriv*(1) command."
10193 #. type: Plain text
10194 #: ../login-utils/runuser.1.adoc:26
10196 "When called without arguments, *runuser* defaults to running an interactive "
10200 #. type: Plain text
10201 #: ../login-utils/runuser.1.adoc:28
10204 #| "For backward compatibility, *su* defaults to not change the current "
10205 #| "directory and to only set the environment variables *HOME* and *SHELL* "
10206 #| "(plus *USER* and *LOGNAME* if the target _user_ is not root). It is "
10207 #| "recommended to always use the *--login* option (instead of its shortcut *-"
10208 #| "*) to avoid side effects caused by mixing environments."
10210 "For backward compatibility, *runuser* defaults to not changing the current "
10211 "directory and to setting only the environment variables *HOME* and *SHELL* "
10212 "(plus *USER* and *LOGNAME* if the target _user_ is not root). This version "
10213 "of *runuser* uses PAM for session management."
10215 "Z důvodu zpětné kompatibility *su* ve výchozí podobě nemění pracovní adresář "
10216 "a z proměnných prostředí pouze změní *HOME* a *SHELL* (a *USER* a *LOGNAME*, "
10217 "není-li cílový _uživatel_ root). Doporučuje se vždy použít přepínač *--"
10218 "login* (namísto jeho zkratky *-*), aby se zamezilo vedlejším účinkům "
10219 "způsobeným pomícháním prostředí."
10221 #. type: Plain text
10222 #: ../login-utils/runuser.1.adoc:30
10225 #| "Note that *su* in all cases uses PAM (*pam_getenvlist*(3)) to do the "
10226 #| "final environment modification. Command-line options such as *--login* "
10227 #| "and *--preserve-environment* affect the environment before it is modified "
10230 "Note that *runuser* in all cases use PAM (pam_getenvlist()) to do the final "
10231 "environment modification. Command-line options such as *--login* and *--"
10232 "preserve-environment* affect the environment before it is modified by PAM."
10234 "Pamatujte, že *su* ve všech případech používá PAM (*pam_getenvlist*(3)), aby "
10235 "upravil konečné prostředí. Přepínače příkazové řádky jako *--login* nebo *--"
10236 "preserve-environment* ovlivňují prostředí před tím, než je změněno systémem "
10239 #. type: Plain text
10240 #: ../login-utils/runuser.1.adoc:32
10243 #| "Since version 2.38 *su* resets process resource limits RLIMIT_NICE, "
10244 #| "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10246 "Since version 2.38 *runuser* resets process resource limits RLIMIT_NICE, "
10247 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10249 "Od verze 2.38 *su* resetuje omezení zdrojů procesu RLIMIT_NICE, "
10250 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS a RLIMIT_NOFILE."
10252 #. type: Labeled list
10253 #: ../login-utils/runuser.1.adoc:35
10255 #| msgid "*-c*, **--command**=__command__"
10256 msgid "*-c*, *--command*=_command_"
10257 msgstr "*-c*, **--command**=__příkaz__"
10259 #. type: Plain text
10260 #: ../login-utils/runuser.1.adoc:37 ../login-utils/su.1.adoc:38
10261 msgid "Pass _command_ to the shell with the *-c* option."
10262 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
10264 #. type: Labeled list
10265 #: ../login-utils/runuser.1.adoc:38 ../login-utils/su.1.adoc:39
10267 msgid "*-f*, *--fast*"
10268 msgstr "*-f*, *--fast*"
10270 #. type: Plain text
10271 #: ../login-utils/runuser.1.adoc:40 ../login-utils/su.1.adoc:41
10273 "Pass *-f* to the shell, which may or may not be useful, depending on the "
10276 "Předá shellu *-f*, což může, nebo nemusí být užitečné v závislosti na shellu."
10278 #. type: Labeled list
10279 #: ../login-utils/runuser.1.adoc:41
10281 #| msgid "*-g*, **--group**=__group__"
10282 msgid "*-g*, *--group*=_group_"
10283 msgstr "*-g*, **--group**=__skupina__"
10285 #. type: Plain text
10286 #: ../login-utils/runuser.1.adoc:43
10289 #| "Specify the primary group. This option is available to the root user only."
10291 "The primary group to be used. This option is allowed for the root user only."
10293 "Určuje primární skupinu. Tento přepínač je dostupný pouze uživateli root."
10295 #. type: Labeled list
10296 #: ../login-utils/runuser.1.adoc:44
10298 #| msgid "*-G*, **--supp-group**=__group__"
10299 msgid "*-G*, *--supp-group*=_group_"
10300 msgstr "*-G*, **--supp-group**=__skupina__"
10302 #. type: Plain text
10303 #: ../login-utils/runuser.1.adoc:46 ../login-utils/su.1.adoc:47
10305 "Specify a supplementary group. This option is available to the root user "
10306 "only. The first specified supplementary group is also used as a primary "
10307 "group if the option *--group* is not specified."
10309 "Určuje doplňkovou skupinu. Tento přepínač je dostupný pouze uživateli root. "
10310 "První zadaná doplňková skupina se rovněž použije jako primární skupina, "
10311 "nebyl-li zadán přepínač *--group*."
10313 #. type: Labeled list
10314 #: ../login-utils/runuser.1.adoc:47 ../login-utils/su.1.adoc:48
10316 msgid "*-*, *-l*, *--login*"
10317 msgstr "*-*, *-l*, *--login*"
10319 #. type: Plain text
10320 #: ../login-utils/runuser.1.adoc:49 ../login-utils/su.1.adoc:50
10322 "Start the shell as a login shell with an environment similar to a real login:"
10324 "Spustí shell jako přihlašovací shell s prostředím podobným skutečnému "
10327 #. type: Plain text
10328 #: ../login-utils/runuser.1.adoc:51
10331 #| "clears all the environment variables except *TERM* and variables "
10332 #| "specified by *--whitelist-environment*"
10334 "clears all the environment variables except for *TERM* and variables "
10335 "specified by *--whitelist-environment*"
10337 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
10338 "whitelist-environment*"
10340 #. type: Plain text
10341 #: ../login-utils/runuser.1.adoc:52 ../login-utils/su.1.adoc:53
10343 "initializes the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, "
10346 "inicializuje proměnné prostředí *HOME*, *SHELL*, *USER*, *LOGNAME* a *PATH*"
10348 #. type: Plain text
10349 #: ../login-utils/runuser.1.adoc:53 ../login-utils/su.1.adoc:54
10350 msgid "changes to the target user's home directory"
10351 msgstr "přejde do domovského adresáře cílového uživatele"
10353 #. type: Plain text
10354 #: ../login-utils/runuser.1.adoc:54 ../login-utils/su.1.adoc:55
10356 "sets argv[0] of the shell to '*-*' in order to make the shell a login shell"
10358 "nastaví argv[0] shellu na '*-*', aby se shell stal shellem přihlašovacím"
10360 #. type: Labeled list
10361 #: ../login-utils/runuser.1.adoc:55 ../login-utils/su.1.adoc:59
10363 msgid "*-P*, *--pty*"
10364 msgstr "*-P*, *--pty*"
10366 #. type: Plain text
10367 #: ../login-utils/runuser.1.adoc:57
10370 #| "Create a pseudo-terminal for the session. The independent terminal "
10371 #| "provides better security as the user does not share a terminal with the "
10372 #| "original session. This can be used to avoid *TIOCSTI* ioctl terminal "
10373 #| "injection and other security attacks against terminal file descriptors. "
10374 #| "The entire session can also be moved to the background (e.g., *su --pty* "
10375 #| "**-** __username__ *-c* _application_ *&*). If the pseudo-terminal is "
10376 #| "enabled, then *su* works as a proxy between the sessions (sync stdin and "
10379 "Create a pseudo-terminal for the session. The independent terminal provides "
10380 "better security as the user does not share a terminal with the original "
10381 "session. This can be used to avoid TIOCSTI ioctl terminal injection and "
10382 "other security attacks against terminal file descriptors. The entire session "
10383 "can also be moved to the background (e.g., *runuser --pty* *-u* _username_ "
10384 "*--* _command_ *&*). If the pseudo-terminal is enabled, then *runuser* works "
10385 "as a proxy between the sessions (sync stdin and stdout)."
10387 "Pro relaci vytvoří pseudoterminál. Nezávislý terminál poskytuje větší "
10388 "bezpečí, neboť uživatel nesdílí terminál s původní relací. Toho lze využít "
10389 "k zabránění vložení řídícího volání *TIOCSTI* terminálu a jiným "
10390 "bezpečnostním útokům na deskriptory souboru terminálu. Rovněž celou relaci "
10391 "je možné přesunout na pozadí (např. *su --pty* **-** __uživatel__ *-c* "
10392 "_aplikace_ *&*). Je-li pseudoterminál zapnut, pak *su* bude pracovat jako "
10393 "prostředník mezi relacemi (synchronizovat standardní vstup a výstup)."
10395 #. type: Plain text
10396 #: ../login-utils/runuser.1.adoc:59
10399 #| "This feature is mostly designed for interactive sessions. If the standard "
10400 #| "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | "
10401 #| "su --pty*), then the *ECHO* flag for the pseudo-terminal is disabled to "
10402 #| "avoid messy output."
10404 "This feature is mostly designed for interactive sessions. If the standard "
10405 "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | "
10406 "runuser --pty -u* _user_), then the *ECHO* flag for the pseudo-terminal is "
10407 "disabled to avoid messy output."
10409 "Tato funkce je převážně navržena pro interaktivní relace. Pokud standardní "
10410 "vstup není terminál, ale například rourou (př. *echo \"date\" | su --pty*), "
10411 "pak příznak *ECHO* pseudoterminálu bude vypnut, aby se předešlo zaneřádění "
10414 #. type: Labeled list
10415 #: ../login-utils/runuser.1.adoc:60 ../login-utils/su.1.adoc:56
10417 msgid "*-m*, *-p*, *--preserve-environment*"
10418 msgstr "*-m*, *-p*, *--preserve-environment*"
10420 #. type: Plain text
10421 #: ../login-utils/runuser.1.adoc:62
10424 #| "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* "
10425 #| "or *LOGNAME*. This option is ignored if the option *--login* is specified."
10427 "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
10428 "*LOGNAME*. The option is ignored if the option *--login* is specified."
10430 "Zachová celé prostředí. Tj. nenastaví *HOME*, *SHELL*, *USER*, ani "
10431 "*LOGNAME*. Tento přepínač se ignoruje, byl-li uveden přepínač *--login*."
10433 #. type: Labeled list
10434 #: ../login-utils/runuser.1.adoc:63
10436 #| msgid "*-s*, **--shell**=__shell__"
10437 msgid "*-s*, *--shell*=_shell_"
10438 msgstr "*-s*, **--shell**=__shell__"
10440 #. type: Plain text
10441 #: ../login-utils/runuser.1.adoc:65 ../login-utils/su.1.adoc:66
10443 "Run the specified _shell_ instead of the default. The shell to run is "
10444 "selected according to the following rules, in order:"
10446 "Spustí zadaný _shell_ namísto výchozího. Který shell by se měl spustit, se "
10447 "vybírá na základě následujících pravidel v tomto pořadí:"
10449 #. type: Plain text
10450 #: ../login-utils/runuser.1.adoc:67 ../login-utils/su.1.adoc:68
10451 msgid "the shell specified with *--shell*"
10452 msgstr "shell zadaný pomocí *--shell*"
10454 #. type: Plain text
10455 #: ../login-utils/runuser.1.adoc:68
10458 #| "the shell specified in the environment variable *SHELL*, if the *--"
10459 #| "preserve-environment* option is used"
10461 "the shell specified in the environment variable *SHELL* if the *--preserve-"
10462 "environment* option is used"
10464 "shell určený proměnnou prostředí *SHELL*, je-li použit přepínač *--preserve-"
10467 #. type: Plain text
10468 #: ../login-utils/runuser.1.adoc:69 ../login-utils/su.1.adoc:70
10469 msgid "the shell listed in the passwd entry of the target user"
10470 msgstr "shell uvedený v záznamu passwd cílového uživatele"
10472 #. type: Plain text
10473 #: ../login-utils/runuser.1.adoc:70 ../login-utils/su.1.adoc:71
10477 #. type: Plain text
10478 #: ../login-utils/runuser.1.adoc:72
10481 #| "If the target user has a restricted shell (i.e., not listed in _/etc/"
10482 #| "shells_), the *--shell* option and the *SHELL* environment variables are "
10483 #| "ignored unless the calling user is root."
10485 "If the target user has a restricted shell (i.e., not listed in _/etc/"
10486 "shells_), then the *--shell* option and the *SHELL* environment variables "
10487 "are ignored unless the calling user is root."
10489 "Je-li shell cílového uživatele omezený (tj. neuvedený v _/etc/shells_), "
10490 "přepínač *--shell* a proměnná prostředí *SHELL* jsou ignorovány, pokud "
10491 "volajícím není root."
10493 #. type: Labeled list
10494 #: ../login-utils/runuser.1.adoc:73 ../login-utils/su.1.adoc:74
10496 msgid "**--session-command=**__command__"
10497 msgstr "**--session-command=**__příkaz__"
10499 #. type: Plain text
10500 #: ../login-utils/runuser.1.adoc:75 ../login-utils/su.1.adoc:76
10501 msgid "Same as *-c*, but do not create a new session. (Discouraged.)"
10502 msgstr "Stejné jako *-c*, ale nevytvoří novou relaci. (Nedoporučuje se.)"
10504 #. type: Labeled list
10505 #: ../login-utils/runuser.1.adoc:76
10507 #| msgid "*-w*, **--whitelist-environment**=__list__"
10508 msgid "*-w*, *--whitelist-environment*=_list_"
10509 msgstr "*-w*, **--whitelist-environment**=__seznam__"
10511 #. type: Plain text
10512 #: ../login-utils/runuser.1.adoc:78 ../login-utils/su.1.adoc:79
10514 "Don't reset the environment variables specified in the comma-separated "
10515 "_list_ when clearing the environment for *--login*. The whitelist is ignored "
10516 "for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*."
10518 "Neresetuje proměnné prostředí uvedené v čárkou odděleném _seznamu_, když se "
10519 "čistí prostředí pro *--login*. Tento seznam se ignoruje pro proměnné "
10520 "prostředí *HOME*, *SHELL*, *USER*, *LOGNAME* a *PATH*."
10523 #: ../login-utils/runuser.1.adoc:81 ../login-utils/su.1.adoc:86
10525 msgid "CONFIG FILES"
10526 msgstr "KONFIGURAČNÍ SOUBORY"
10528 #. type: Plain text
10529 #: ../login-utils/runuser.1.adoc:84
10531 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
10532 msgid "*runuser* reads the _/etc/default/runuser_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *runuser*:\n"
10533 msgstr "*su* čte konfigurační soubory _/etc/default/su_ a _/etc/login.defs_. Následující konfigurační položky jsou relevantní pro *su*{colon}\n"
10535 #. type: Plain text
10536 #: ../login-utils/runuser.1.adoc:87
10539 #| "Defines the *PATH* environment variable for a regular user. The default "
10540 #| "value is _/usr/local/bin:/bin:/usr/bin_."
10542 "Defines the PATH environment variable for a regular user. The default value "
10543 "is _/usr/local/bin:/bin:/usr/bin_."
10545 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
10546 "usr/local/bin:/bin:/usr/bin_."
10548 #. type: Plain text
10549 #: ../login-utils/runuser.1.adoc:91 ../login-utils/su.1.adoc:100
10551 "Defines the *PATH* environment variable for root. *ENV_SUPATH* takes "
10552 "precedence. The default value is _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/"
10553 "usr/sbin:/usr/bin_."
10555 "Určuje proměnnou prostředí *PATH* pro uživatele root. *ENV_SUPATH* má "
10556 "přednost. Výchozí hodnota je _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/"
10559 #. type: Labeled list
10560 #: ../login-utils/runuser.1.adoc:92 ../login-utils/su.1.adoc:101
10562 msgid "*ALWAYS_SET_PATH* (boolean)"
10563 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
10565 #. type: Plain text
10566 #: ../login-utils/runuser.1.adoc:94
10569 #| "If set to _yes_ and *--login* and *--preserve-environment* were not "
10570 #| "specified *su* initializes *PATH*."
10572 "If set to _yes_ and *--login* and *--preserve-environment* were not "
10573 "specified *runuser* initializes *PATH*."
10575 "Je-li nastaveno na _yes_ a *--login* a *--preserve-environment* nebyly-li "
10576 "zadány, *su* inicializuje *PATH*."
10578 #. type: Plain text
10579 #: ../login-utils/runuser.1.adoc:96 ../login-utils/su.1.adoc:105
10581 "The environment variable *PATH* may be different on systems where _/bin_ and "
10582 "_/sbin_ are merged into _/usr_; this variable is also affected by the *--"
10583 "login* command-line option and the PAM system setting (e.g., *pam_env*(8))."
10585 "Proměnná prostředí *PATH* se může lišit na systémech, kde _/bin_ a _/sbin_ "
10586 "jsou začleněny do _/usr_. Tato proměnná je rovněž ovlivněna přepínačem "
10587 "příkazové řádky *--login* a nastavením systému PAM (např. *pam_env*(8))."
10589 #. type: Plain text
10590 #: ../login-utils/runuser.1.adoc:100
10592 #| msgid "*su* normally returns the exit status of the command it executed. If the command was killed by a signal, *su* returns the number of the signal plus 128.\n"
10593 msgid "*runuser* normally returns the exit status of the command it executed. If the command was killed by a signal, *runuser* returns the number of the signal plus 128.\n"
10594 msgstr "Nástroj *su* běžně vrací návratovou hodnotu příkazu, který spustil. Byl-li příkaz zabit signálem, *su* vrátí číslo signálu plus 128.\n"
10596 #. type: Plain text
10597 #: ../login-utils/runuser.1.adoc:102
10599 #| msgid "Exit status generated by *su* itself:"
10600 msgid "Exit status generated by *runuser* itself:"
10601 msgstr "Návratová hodnota vyrobená nástrojem *su* samotným:"
10603 #. type: Plain text
10604 #: ../login-utils/runuser.1.adoc:105 ../login-utils/su.1.adoc:114
10605 msgid "Generic error before executing the requested command"
10606 msgstr "Obecná chyba před spuštěním požadovaného příkazu"
10608 #. type: Labeled list
10609 #: ../login-utils/runuser.1.adoc:105 ../login-utils/su.1.adoc:114
10614 #. type: Plain text
10615 #: ../login-utils/runuser.1.adoc:107 ../login-utils/su.1.adoc:116
10616 msgid "The requested command could not be executed"
10617 msgstr "Požadovaný příkaz nebylo možné spustit"
10619 #. type: Labeled list
10620 #: ../login-utils/runuser.1.adoc:107 ../login-utils/su.1.adoc:116
10625 #. type: Plain text
10626 #: ../login-utils/runuser.1.adoc:109 ../login-utils/su.1.adoc:118
10627 msgid "The requested command was not found"
10628 msgstr "Požadovaný příkaz nebyl nalezen"
10630 #. type: Labeled list
10631 #: ../login-utils/runuser.1.adoc:113
10633 #| msgid "_/etc/pam.d/su_"
10634 msgid "_/etc/pam.d/runuser_"
10635 msgstr "_/etc/pam.d/su_"
10637 #. type: Plain text
10638 #: ../login-utils/runuser.1.adoc:115 ../login-utils/su.1.adoc:123
10639 msgid "default PAM configuration file"
10640 msgstr "výchozí konfigurační soubor PAM"
10642 #. type: Labeled list
10643 #: ../login-utils/runuser.1.adoc:116
10645 #| msgid "_/etc/pam.d/su-l_"
10646 msgid "_/etc/pam.d/runuser-l_"
10647 msgstr "_/etc/pam.d/su-l_"
10649 #. type: Plain text
10650 #: ../login-utils/runuser.1.adoc:118 ../login-utils/su.1.adoc:126
10651 msgid "PAM configuration file if *--login* is specified"
10652 msgstr "konfigurační soubor PAM, byl-li zadán *--login*"
10654 #. type: Labeled list
10655 #: ../login-utils/runuser.1.adoc:119
10657 #| msgid "_/etc/default/su_"
10658 msgid "_/etc/default/runuser_"
10659 msgstr "_/etc/default/su_"
10661 #. type: Plain text
10662 #: ../login-utils/runuser.1.adoc:121
10664 #| msgid "command specific logindef config file"
10665 msgid "runuser specific logindef config file"
10666 msgstr "konfigurační soubor logindef určený tento nástroj"
10668 #. type: Labeled list
10669 #: ../login-utils/runuser.1.adoc:122 ../login-utils/su.1.adoc:130
10671 msgid "_/etc/login.defs_"
10672 msgstr "_/etc/login.defs_"
10674 #. type: Plain text
10675 #: ../login-utils/runuser.1.adoc:124 ../login-utils/su.1.adoc:132
10676 msgid "global logindef config file"
10677 msgstr "globální konfigurační soubor logindef"
10679 #. type: Plain text
10680 #: ../login-utils/runuser.1.adoc:128
10683 #| "This *su* command was derived from coreutils' *su*, which was based on an "
10684 #| "implementation by David MacKenzie. The util-linux version has been "
10685 #| "refactored by Karel Zak."
10687 "This *runuser* command was derived from coreutils' *su*, which was based on "
10688 "an implementation by David MacKenzie, and the Fedora *runuser* command by "
10691 "Tento nástroj *su* byl odvozen z *su* v balíku coreutils, který byl založen "
10692 "na implementaci Davida MacKenzie. Verze v util-linux byl přepsána Karlem "
10695 #. type: Plain text
10696 #: ../login-utils/runuser.1.adoc:136
10699 #| "*setpriv*(1),\n"
10700 #| "*login.defs*(5),\n"
10701 #| "*shells*(5),\n"
10703 #| "*runuser*(1)\n"
10707 "*login.defs*(5),\n"
10712 "*login.defs*(5),\n"
10718 #: ../login-utils/su.1.adoc:2
10723 #. type: Plain text
10724 #: ../login-utils/su.1.adoc:13
10725 msgid "su - run a command with substitute user and group ID"
10726 msgstr "su - spustí shell pod jiným uživatelským a skupinovým ID"
10728 #. type: Plain text
10729 #: ../login-utils/su.1.adoc:17
10731 msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10732 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10734 #. type: Plain text
10735 #: ../login-utils/su.1.adoc:21
10737 msgid "*su* allows commands to be run with a substitute user and group ID.\n"
10738 msgstr "*su* dovoluje příkazům běžet se změněným ID uživatele a skupiny.\n"
10740 #. type: Plain text
10741 #: ../login-utils/su.1.adoc:23
10743 "When called with no _user_ specified, *su* defaults to running an "
10744 "interactive shell as _root_. When _user_ is specified, additional "
10745 "__argument__s can be supplied, in which case they are passed to the shell."
10747 "Je-li zavolán bez udání _uživatele_, *su* spustí interaktivní shell jako "
10748 "_root_. Je-li _uživatel_ zadán, lze zadat další _argumenty_ a ty budou "
10749 "v takovém případě předány shellu."
10751 #. type: Plain text
10752 #: ../login-utils/su.1.adoc:25
10754 "For backward compatibility, *su* defaults to not change the current "
10755 "directory and to only set the environment variables *HOME* and *SHELL* (plus "
10756 "*USER* and *LOGNAME* if the target _user_ is not root). It is recommended to "
10757 "always use the *--login* option (instead of its shortcut *-*) to avoid side "
10758 "effects caused by mixing environments."
10760 "Z důvodu zpětné kompatibility *su* ve výchozí podobě nemění pracovní adresář "
10761 "a z proměnných prostředí pouze změní *HOME* a *SHELL* (a *USER* a *LOGNAME*, "
10762 "není-li cílový _uživatel_ root). Doporučuje se vždy použít přepínač *--"
10763 "login* (namísto jeho zkratky *-*), aby se zamezilo vedlejším účinkům "
10764 "způsobeným pomícháním prostředí."
10766 #. type: Plain text
10767 #: ../login-utils/su.1.adoc:27
10769 "This version of *su* uses PAM for authentication, account and session "
10770 "management. Some configuration options found in other *su* implementations, "
10771 "such as support for a wheel group, have to be configured via PAM."
10773 "Tato verze *su* používá pro autentizaci, autorizaci a správu relace PAM. "
10774 "Některé možnosti nastavení nacházející se v jiných implementacích *su*, jako "
10775 "podpora skupiny wheel, se musí nastavit přes PAM."
10777 #. type: Plain text
10778 #: ../login-utils/su.1.adoc:29
10780 msgid "*su* is mostly designed for unprivileged users, the recommended solution for privileged users (e.g., scripts executed by root) is to use non-set-user-ID command *runuser*(1) that does not require authentication and provides separate PAM configuration. If the PAM session is not required at all then the recommended solution is to use command *setpriv*(1).\n"
10781 msgstr "*su* je navrženo pro neprivilegované uživatele. Doporučené řešení pro privilegované uživatele (např. skripty spouštěné rootem) je použít program bez SUID *runuser*(1), který nepotřebuje autentizaci a přitom poskytuje samostatné nastavení PAM. Není-li relace PAM vůbec potřeba, pak doporučeným řešením je příkaz *setpriv*(1).\n"
10783 #. type: Plain text
10784 #: ../login-utils/su.1.adoc:31
10786 "Note that *su* in all cases uses PAM (*pam_getenvlist*(3)) to do the final "
10787 "environment modification. Command-line options such as *--login* and *--"
10788 "preserve-environment* affect the environment before it is modified by PAM."
10790 "Pamatujte, že *su* ve všech případech používá PAM (*pam_getenvlist*(3)), aby "
10791 "upravil konečné prostředí. Přepínače příkazové řádky jako *--login* nebo *--"
10792 "preserve-environment* ovlivňují prostředí před tím, než je změněno systémem "
10795 #. type: Plain text
10796 #: ../login-utils/su.1.adoc:33
10798 "Since version 2.38 *su* resets process resource limits RLIMIT_NICE, "
10799 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10801 "Od verze 2.38 *su* resetuje omezení zdrojů procesu RLIMIT_NICE, "
10802 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS a RLIMIT_NOFILE."
10804 #. type: Labeled list
10805 #: ../login-utils/su.1.adoc:36
10807 msgid "*-c*, **--command**=__command__"
10808 msgstr "*-c*, **--command**=__příkaz__"
10810 #. type: Labeled list
10811 #: ../login-utils/su.1.adoc:42
10813 msgid "*-g*, **--group**=__group__"
10814 msgstr "*-g*, **--group**=__skupina__"
10816 #. type: Plain text
10817 #: ../login-utils/su.1.adoc:44
10819 "Specify the primary group. This option is available to the root user only."
10821 "Určuje primární skupinu. Tento přepínač je dostupný pouze uživateli root."
10823 #. type: Labeled list
10824 #: ../login-utils/su.1.adoc:45
10826 msgid "*-G*, **--supp-group**=__group__"
10827 msgstr "*-G*, **--supp-group**=__skupina__"
10829 #. type: Plain text
10830 #: ../login-utils/su.1.adoc:52
10832 "clears all the environment variables except *TERM* and variables specified "
10833 "by *--whitelist-environment*"
10835 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
10836 "whitelist-environment*"
10838 #. type: Plain text
10839 #: ../login-utils/su.1.adoc:58
10841 "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
10842 "*LOGNAME*. This option is ignored if the option *--login* is specified."
10844 "Zachová celé prostředí. Tj. nenastaví *HOME*, *SHELL*, *USER*, ani "
10845 "*LOGNAME*. Tento přepínač se ignoruje, byl-li uveden přepínač *--login*."
10847 #. type: Plain text
10848 #: ../login-utils/su.1.adoc:61
10850 "Create a pseudo-terminal for the session. The independent terminal provides "
10851 "better security as the user does not share a terminal with the original "
10852 "session. This can be used to avoid *TIOCSTI* ioctl terminal injection and "
10853 "other security attacks against terminal file descriptors. The entire session "
10854 "can also be moved to the background (e.g., *su --pty* **-** __username__ *-"
10855 "c* _application_ *&*). If the pseudo-terminal is enabled, then *su* works as "
10856 "a proxy between the sessions (sync stdin and stdout)."
10858 "Pro relaci vytvoří pseudoterminál. Nezávislý terminál poskytuje větší "
10859 "bezpečí, neboť uživatel nesdílí terminál s původní relací. Toho lze využít "
10860 "k zabránění vložení řídícího volání *TIOCSTI* terminálu a jiným "
10861 "bezpečnostním útokům na deskriptory souboru terminálu. Rovněž celou relaci "
10862 "je možné přesunout na pozadí (např. *su --pty* **-** __uživatel__ *-c* "
10863 "_aplikace_ *&*). Je-li pseudoterminál zapnut, pak *su* bude pracovat jako "
10864 "prostředník mezi relacemi (synchronizovat standardní vstup a výstup)."
10866 #. type: Plain text
10867 #: ../login-utils/su.1.adoc:63
10869 "This feature is mostly designed for interactive sessions. If the standard "
10870 "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | su --"
10871 "pty*), then the *ECHO* flag for the pseudo-terminal is disabled to avoid "
10874 "Tato funkce je převážně navržena pro interaktivní relace. Pokud standardní "
10875 "vstup není terminál, ale například rourou (př. *echo \"date\" | su --pty*), "
10876 "pak příznak *ECHO* pseudoterminálu bude vypnut, aby se předešlo zaneřádění "
10879 #. type: Labeled list
10880 #: ../login-utils/su.1.adoc:64
10882 msgid "*-s*, **--shell**=__shell__"
10883 msgstr "*-s*, **--shell**=__shell__"
10885 #. type: Plain text
10886 #: ../login-utils/su.1.adoc:69
10888 "the shell specified in the environment variable *SHELL*, if the *--preserve-"
10889 "environment* option is used"
10891 "shell určený proměnnou prostředí *SHELL*, je-li použit přepínač *--preserve-"
10894 #. type: Plain text
10895 #: ../login-utils/su.1.adoc:73
10897 "If the target user has a restricted shell (i.e., not listed in _/etc/"
10898 "shells_), the *--shell* option and the *SHELL* environment variables are "
10899 "ignored unless the calling user is root."
10901 "Je-li shell cílového uživatele omezený (tj. neuvedený v _/etc/shells_), "
10902 "přepínač *--shell* a proměnná prostředí *SHELL* jsou ignorovány, pokud "
10903 "volajícím není root."
10905 #. type: Labeled list
10906 #: ../login-utils/su.1.adoc:77
10908 msgid "*-w*, **--whitelist-environment**=__list__"
10909 msgstr "*-w*, **--whitelist-environment**=__seznam__"
10912 #: ../login-utils/su.1.adoc:82 ../term-utils/script.1.adoc:123
10917 #. type: Plain text
10918 #: ../login-utils/su.1.adoc:85
10920 "Upon receiving either *SIGINT*, *SIGQUIT* or *SIGTERM*, *su* terminates its "
10921 "child and afterwards terminates itself with the received signal. The child "
10922 "is terminated by *SIGTERM*, after unsuccessful attempt and 2 seconds of "
10923 "delay the child is killed by *SIGKILL*."
10925 "Po přijetí signálu *SIGINT*, *SIGQUIT* nebo *SIGTERM* *su* ukončí svého "
10926 "potomka a poté ukončí sebe přijatým signálem. Potomek bude ukončen signálem "
10927 "*SIGTERM*. Při neúspěšném pokusu bude po 2 sekundách prodlení potomek zabit "
10928 "signálem *SIGKILL*."
10930 #. TRANSLATORS: Keep {colon} untranslated
10931 #. type: Plain text
10932 #: ../login-utils/su.1.adoc:90
10934 msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
10935 msgstr "*su* čte konfigurační soubory _/etc/default/su_ a _/etc/login.defs_. Následující konfigurační položky jsou relevantní pro *su*{colon}\n"
10937 #. type: Plain text
10938 #: ../login-utils/su.1.adoc:93
10940 "Delay in seconds in case of an authentication failure. The number must be a "
10941 "non-negative integer."
10943 "Zpoždění v sekundách v případě selhání přihlášení. Hodnota musí být "
10944 "nezáporné celé číslo."
10946 #. type: Plain text
10947 #: ../login-utils/su.1.adoc:96
10949 "Defines the *PATH* environment variable for a regular user. The default "
10950 "value is _/usr/local/bin:/bin:/usr/bin_."
10952 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
10953 "usr/local/bin:/bin:/usr/bin_."
10955 #. type: Plain text
10956 #: ../login-utils/su.1.adoc:103
10958 "If set to _yes_ and *--login* and *--preserve-environment* were not "
10959 "specified *su* initializes *PATH*."
10961 "Je-li nastaveno na _yes_ a *--login* a *--preserve-environment* nebyly-li "
10962 "zadány, *su* inicializuje *PATH*."
10964 #. type: Plain text
10965 #: ../login-utils/su.1.adoc:109
10967 msgid "*su* normally returns the exit status of the command it executed. If the command was killed by a signal, *su* returns the number of the signal plus 128.\n"
10968 msgstr "Nástroj *su* běžně vrací návratovou hodnotu příkazu, který spustil. Byl-li příkaz zabit signálem, *su* vrátí číslo signálu plus 128.\n"
10970 #. type: Plain text
10971 #: ../login-utils/su.1.adoc:111
10972 msgid "Exit status generated by *su* itself:"
10973 msgstr "Návratová hodnota vyrobená nástrojem *su* samotným:"
10975 #. type: Labeled list
10976 #: ../login-utils/su.1.adoc:121
10978 msgid "_/etc/pam.d/su_"
10979 msgstr "_/etc/pam.d/su_"
10981 #. type: Labeled list
10982 #: ../login-utils/su.1.adoc:124
10984 msgid "_/etc/pam.d/su-l_"
10985 msgstr "_/etc/pam.d/su-l_"
10987 #. type: Labeled list
10988 #: ../login-utils/su.1.adoc:127
10990 msgid "_/etc/default/su_"
10991 msgstr "_/etc/default/su_"
10993 #. type: Plain text
10994 #: ../login-utils/su.1.adoc:129
10995 msgid "command specific logindef config file"
10996 msgstr "konfigurační soubor logindef určený tento nástroj"
10998 #. type: Plain text
10999 #: ../login-utils/su.1.adoc:136
11001 "For security reasons, *su* always logs failed log-in attempts to the _btmp_ "
11002 "file, but it does not write to the _lastlog_ file at all. This solution can "
11003 "be used to control *su* behavior by PAM configuration. If you want to use "
11004 "the *pam_lastlog*(8) module to print warning message about failed log-in "
11005 "attempts then *pam_lastlog*(8) has to be configured to update the _lastlog_ "
11006 "file as well. For example by:"
11008 "Z bezpečnostních důvodů *su* vždy zaprotokoluje selhané pokusy o přihlášení "
11009 "to souboru _btmp_, avšak vůbec nezapisuje do souboru _lastlog_. Následující "
11010 "řešení pomocí nastavení PAM lze použít k ovlivnění chování *su*. Chcete-li "
11011 "používat modul *pam_lastlog*(8) pro vypisování varování o selhaných "
11012 "přihlašovacích pokusech, pak *pam_lastlog*(8) musí být nastaven tak, aby "
11013 "rovněž aktualizoval soubor _lastlog_. Například:"
11015 #. type: delimited block _
11016 #: ../login-utils/su.1.adoc:139
11017 msgid "session required pam_lastlog.so nowtmp"
11018 msgstr "session required pam_lastlog.so nowtmp"
11020 #. type: Plain text
11021 #: ../login-utils/su.1.adoc:144
11023 "This *su* command was derived from coreutils' *su*, which was based on an "
11024 "implementation by David MacKenzie. The util-linux version has been "
11025 "refactored by Karel Zak."
11027 "Tento nástroj *su* byl odvozen z *su* v balíku coreutils, který byl založen "
11028 "na implementaci Davida MacKenzie. Verze v util-linux byl přepsána Karlem "
11031 #. type: Plain text
11032 #: ../login-utils/su.1.adoc:152
11036 "*login.defs*(5),\n"
11042 "*login.defs*(5),\n"
11050 #. Copyright (C) 1998-2006 Miquel van Smoorenburg.
11051 #. Copyright (C) 2012 Karel Zak <kzak@redhat.com>
11052 #. This program is free software; you can redistribute it and/or modify
11053 #. it under the terms of the GNU General Public License as published by
11054 #. the Free Software Foundation; either version 2 of the License, or
11055 #. (at your option) any later version.
11056 #. This program is distributed in the hope that it will be useful,
11057 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
11058 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11059 #. GNU General Public License for more details.
11060 #. You should have received a copy of the GNU General Public License
11061 #. along with this program; if not, write to the Free Software
11062 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
11064 #: ../login-utils/sulogin.8.adoc:20
11069 #. type: Plain text
11070 #: ../login-utils/sulogin.8.adoc:31
11071 msgid "sulogin - single-user login"
11074 #. type: Plain text
11075 #: ../login-utils/sulogin.8.adoc:35
11077 msgid "*sulogin* [options] [_tty_]\n"
11080 #. type: Plain text
11081 #: ../login-utils/sulogin.8.adoc:39
11083 msgid "*sulogin* is invoked by *init* when the system goes into single-user mode.\n"
11086 #. type: Plain text
11087 #: ../login-utils/sulogin.8.adoc:41
11088 msgid "The user is prompted:"
11091 #. type: Plain text
11092 #: ../login-utils/sulogin.8.adoc:43
11094 "Give root password for system maintenance (or type Control-D for normal "
11098 #. type: Plain text
11099 #: ../login-utils/sulogin.8.adoc:45
11101 "If the root account is locked and *--force* is specified, no password is "
11105 #. type: Plain text
11106 #: ../login-utils/sulogin.8.adoc:47
11108 msgid "*sulogin* will be connected to the current terminal, or to the optional _tty_ device that can be specified on the command line (typically _/dev/console_).\n"
11111 #. type: Plain text
11112 #: ../login-utils/sulogin.8.adoc:49
11114 "When the user exits from the single-user shell, or presses control-D at the "
11115 "prompt, the system will continue to boot."
11118 #. type: Labeled list
11119 #: ../login-utils/sulogin.8.adoc:52
11121 #| msgid "*-f*, *--fast*"
11122 msgid "*-e*, *--force*"
11123 msgstr "*-f*, *--fast*"
11125 #. TRANSLATORS: Keep {asterisk} untranslated.
11126 #. type: Plain text
11127 #: ../login-utils/sulogin.8.adoc:54
11129 "If the default method of obtaining the root password from the system via "
11130 "*getpwnam*(3) fails, then examine _/etc/passwd_ and _/etc/shadow_ to get the "
11131 "password. If these files are damaged or nonexistent, or when root account is "
11132 "locked by '!' or '{asterisk}' at the begin of the password then *sulogin* "
11133 "will *start a root shell without asking for a password*."
11136 #. type: Plain text
11137 #: ../login-utils/sulogin.8.adoc:57
11139 "Only use the *-e* option if you are sure the console is physically protected "
11140 "against unauthorized access."
11143 #. type: Labeled list
11144 #: ../login-utils/sulogin.8.adoc:58
11146 #| msgid "*-h*, *--help*"
11147 msgid "*-p*, *--login-shell*"
11148 msgstr "*-h*, *--help*"
11150 #. type: Plain text
11151 #: ../login-utils/sulogin.8.adoc:60
11153 "Specifying this option causes *sulogin* to start the shell process as a "
11157 #. type: Labeled list
11158 #: ../login-utils/sulogin.8.adoc:61 ../misc-utils/waitpid.1.adoc:29
11160 msgid "*-t*, *--timeout* _seconds_"
11163 #. type: Plain text
11164 #: ../login-utils/sulogin.8.adoc:63
11166 "Specify the maximum amount of time to wait for user input. By default, "
11167 "*sulogin* will wait forever."
11170 #. type: Plain text
11171 #: ../login-utils/sulogin.8.adoc:69
11173 msgid "*sulogin* looks for the environment variable *SUSHELL* or *sushell* to determine what shell to start. If the environment variable is not set, it will try to execute root's shell from _/etc/passwd_. If that fails, it will fall back to _/bin/sh_.\n"
11176 #. type: Plain text
11177 #: ../login-utils/sulogin.8.adoc:73
11179 msgid "*sulogin* was written by Miquel van Smoorenburg for sysvinit and later ported to util-linux by Dave Reisner and Karel Zak.\n"
11185 #. Copyright (C) 2010 Michael Krapp
11186 #. This program is free software; you can redistribute it and/or modify
11187 #. it under the terms of the GNU General Public License as published by
11188 #. the Free Software Foundation; either version 2 of the License, or
11189 #. (at your option) any later version.
11190 #. This program is distributed in the hope that it will be useful,
11191 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
11192 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11193 #. GNU General Public License for more details.
11194 #. You should have received a copy of the GNU General Public License
11195 #. along with this program; if not, write to the Free Software
11196 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
11198 #: ../login-utils/utmpdump.1.adoc:19
11200 msgid "utmpdump(1)"
11203 #. type: Plain text
11204 #: ../login-utils/utmpdump.1.adoc:29
11205 msgid "utmpdump - dump UTMP and WTMP files in raw format"
11208 #. type: Plain text
11209 #: ../login-utils/utmpdump.1.adoc:33
11211 msgid "*utmpdump* [options] _filename_\n"
11214 #. type: Plain text
11215 #: ../login-utils/utmpdump.1.adoc:37
11217 msgid "*utmpdump* is a simple program to dump UTMP and WTMP files in raw format, so they can be examined. *utmpdump* reads from stdin unless a _filename_ is passed.\n"
11220 #. type: Labeled list
11221 #: ../login-utils/utmpdump.1.adoc:40
11223 #| msgid "*-f*, *--fast*"
11224 msgid "*-f*, *--follow*"
11225 msgstr "*-f*, *--fast*"
11227 #. type: Plain text
11228 #: ../login-utils/utmpdump.1.adoc:42
11229 msgid "Output appended data as the file grows."
11232 #. type: Labeled list
11233 #: ../login-utils/utmpdump.1.adoc:43
11235 #| msgid "*-P*, *--pty*"
11236 msgid "*-o*, *--output* _file_"
11237 msgstr "*-P*, *--pty*"
11239 #. type: Plain text
11240 #: ../login-utils/utmpdump.1.adoc:45
11241 msgid "Write command output to _file_ instead of standard output."
11244 #. type: Labeled list
11245 #: ../login-utils/utmpdump.1.adoc:46
11247 #| msgid "*-V*, *--version*"
11248 msgid "*-r*, *--reverse*"
11249 msgstr "*-V*, *--version*"
11251 #. type: Plain text
11252 #: ../login-utils/utmpdump.1.adoc:48
11254 "Undump, write back edited login information into the utmp or wtmp files."
11257 #. type: Plain text
11258 #: ../login-utils/utmpdump.1.adoc:54
11260 msgid "*utmpdump* can be useful in cases of corrupted utmp or wtmp entries. It can dump out utmp/wtmp to an ASCII file, which can then be edited to remove bogus entries, and reintegrated using:\n"
11263 #. type: delimited block _
11264 #: ../login-utils/utmpdump.1.adoc:57
11266 msgid "*utmpdump -r < ascii_file > wtmp*\n"
11269 #. type: Plain text
11270 #: ../login-utils/utmpdump.1.adoc:60
11271 msgid "But be warned, *utmpdump* was written for debugging purposes only."
11274 #. type: Plain text
11275 #: ../login-utils/utmpdump.1.adoc:64
11277 "Only the binary version of the *utmp*(5) is standardised. Textual dumps may "
11278 "become incompatible in future."
11281 #. type: Plain text
11282 #: ../login-utils/utmpdump.1.adoc:66
11284 "The version 2.28 was the last one that printed text output using *ctime*(3) "
11285 "timestamp format. Newer dumps use millisecond precision ISO-8601 timestamp "
11286 "format in UTC-0 timezone. Conversion from former timestamp format can be "
11287 "made to binary, although attempt to do so can lead the timestamps to drift "
11288 "amount of timezone offset."
11291 #. type: Plain text
11292 #: ../login-utils/utmpdump.1.adoc:70
11294 "You may *not* use the *-r* option, as the format for the utmp/wtmp files "
11295 "strongly depends on the input format. This tool was *not* written for normal "
11296 "use, but for debugging only."
11299 #. type: Plain text
11300 #: ../login-utils/utmpdump.1.adoc:74
11301 msgid "Michael Krapp"
11304 #. type: Plain text
11305 #: ../login-utils/utmpdump.1.adoc:81
11324 #. Copyright (c) 1983, 1991 The Regents of the University of California.
11325 #. All rights reserved.
11326 #. Redistribution and use in source and binary forms, with or without
11327 #. modification, are permitted provided that the following conditions
11329 #. 1. Redistributions of source code must retain the above copyright
11330 #. notice, this list of conditions and the following disclaimer.
11331 #. 2. Redistributions in binary form must reproduce the above copyright
11332 #. notice, this list of conditions and the following disclaimer in the
11333 #. documentation and/or other materials provided with the distribution.
11334 #. 3. All advertising materials mentioning features or use of this software
11335 #. must display the following acknowledgement:
11336 #. This product includes software developed by the University of
11337 #. California, Berkeley and its contributors.
11338 #. 4. Neither the name of the University nor the names of its contributors
11339 #. may be used to endorse or promote products derived from this software
11340 #. without specific prior written permission.
11341 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
11342 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
11343 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
11344 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
11345 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
11346 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
11347 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
11348 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
11349 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
11350 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
11352 #. @(#)vipw.8 6.7 (Berkeley) 3/16/91
11354 #: ../login-utils/vipw.8.adoc:36
11359 #. type: Plain text
11360 #: ../login-utils/vipw.8.adoc:46
11361 msgid "vipw, vigr - edit the password or group file"
11364 #. type: Plain text
11365 #: ../login-utils/vipw.8.adoc:50
11367 msgid "*vipw* [options]\n"
11370 #. type: Plain text
11371 #: ../login-utils/vipw.8.adoc:52
11373 msgid "*vigr* [options]\n"
11376 #. type: Plain text
11377 #: ../login-utils/vipw.8.adoc:56
11379 msgid "*vipw* edits the password file after setting the appropriate locks, and does any necessary processing after the password file is unlocked. If the password file is already locked for editing by another user, *vipw* will ask you to try again later. The default editor for *vipw* and *vigr* is *vi*(1). *vigr* edits the group file in the same manner as *vipw* does the passwd file.\n"
11382 #. type: Plain text
11383 #: ../login-utils/vipw.8.adoc:64
11385 "If the following environment variable exists, it will be utilized by *vipw* "
11389 #. type: Labeled list
11390 #: ../login-utils/vipw.8.adoc:65 ../text-utils/more.1.adoc:180
11395 #. type: Plain text
11396 #: ../login-utils/vipw.8.adoc:67
11398 "The editor specified by the string *EDITOR* will be invoked instead of the "
11399 "default editor *vi*(1)."
11402 #. type: Plain text
11403 #: ../login-utils/vipw.8.adoc:71
11405 "The *vipw* command appeared in 4.0BSD. The *vigr* command appeared in Util-"
11409 #. type: Plain text
11410 #: ../login-utils/vipw.8.adoc:78
11419 #. type: Plain text
11420 #: ../login-utils/vipw.8.adoc:81
11423 #| "The *{command}* command is part of the util-linux package which can be "
11424 #| "downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
11425 #| "Kernel Archive]."
11427 "The *vigr* and *vipw* commands are part of the util-linux package and are "
11428 "available from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
11431 "Příkaz *{command}* je součástí balíku util-linux, který lze stáhnout "
11432 "z https://www.kernel.org/pub/linux/utils/util-linux/[archivu jádra Linuxu]."
11434 #. Copyright 2000 Andreas Dilger (adilger@turbolinux.com)
11435 #. This file may be copied under the terms of the GNU Public License.
11437 #: ../misc-utils/blkid.8.adoc:4
11442 #. type: Plain text
11443 #: ../misc-utils/blkid.8.adoc:15
11444 msgid "blkid - locate/print block device attributes"
11447 #. type: Plain text
11448 #: ../misc-utils/blkid.8.adoc:19
11450 msgid "*blkid* *--label* _label_ | *--uuid* _uuid_\n"
11453 #. type: Plain text
11454 #: ../misc-utils/blkid.8.adoc:21
11456 msgid "*blkid* [*--no-encoding* *--garbage-collect* *--list-one* *--cache-file* _file_] [*--output* _format_] [*--match-tag* _tag_] [*--match-token* _NAME=value_] [_device_...]\n"
11459 #. type: Plain text
11460 #: ../misc-utils/blkid.8.adoc:23
11462 msgid "*blkid* *--probe* [*--offset* _offset_] [*--output* _format_] [*--size* _size_] [*--match-tag* _tag_] [*--match-types* _list_] [*--usages* _list_] [*--no-part-details*] _device_...\n"
11465 #. type: Plain text
11466 #: ../misc-utils/blkid.8.adoc:25
11468 msgid "*blkid* *--info* [*--output format*] [*--match-tag* _tag_] _device_...\n"
11471 #. type: Plain text
11472 #: ../misc-utils/blkid.8.adoc:29
11474 "The *blkid* program is the command-line interface to working with the "
11475 "*libblkid*(3) library. It can determine the type of content (e.g., "
11476 "filesystem or swap) that a block device holds, and also the attributes "
11477 "(tokens, NAME=value pairs) from the content metadata (e.g., LABEL or UUID "
11481 #. type: Plain text
11482 #: ../misc-utils/blkid.8.adoc:31
11484 msgid "*It is recommended to use* *lsblk*(8) *command to get information about block devices, or lsblk --fs to get an overview of filesystems, or* *findmnt*(8) *to search in already mounted filesystems.*\n"
11487 #. type: delimited block _
11488 #: ../misc-utils/blkid.8.adoc:34
11490 msgid "*lsblk*(8) provides more information, better control on output formatting, easy to use in scripts and it does not require root permissions to get actual information. *blkid* reads information directly from devices and for non-root users it returns cached unverified information. *blkid* is mostly designed for system services and to test *libblkid*(3) functionality.\n"
11493 #. type: Plain text
11494 #: ../misc-utils/blkid.8.adoc:37
11496 "When _device_ is specified, tokens from only this device are displayed. It "
11497 "is possible to specify multiple _device_ arguments on the command line. If "
11498 "none is given, all partitions or unpartitioned devices which appear in _/"
11499 "proc/partitions_ are shown, if they are recognized."
11502 #. type: Plain text
11503 #: ../misc-utils/blkid.8.adoc:39
11505 msgid "*blkid* has two main forms of operation: either searching for a device with a specific NAME=value pair, or displaying NAME=value pairs for one or more specified devices.\n"
11508 #. type: Plain text
11509 #: ../misc-utils/blkid.8.adoc:41
11511 "For security reasons *blkid* silently ignores all devices where the probing "
11512 "result is ambivalent (multiple colliding filesystems are detected). The low-"
11513 "level probing mode (*-p*) provides more information and extra exit status in "
11514 "this case. It's recommended to use *wipefs*(8) to get a detailed overview "
11515 "and to erase obsolete stuff (magic strings) from the device."
11518 #. type: Plain text
11519 #: ../misc-utils/blkid.8.adoc:45
11521 "The _size_ and _offset_ arguments may be followed by the multiplicative "
11522 "suffixes like KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, "
11523 "EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning "
11524 "as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, "
11525 "TB, PB, EB, ZB and YB."
11528 #. type: Labeled list
11529 #: ../misc-utils/blkid.8.adoc:46
11531 msgid "*-c*, *--cache-file* _cachefile_"
11534 #. type: Plain text
11535 #: ../misc-utils/blkid.8.adoc:48
11537 "Read from _cachefile_ instead of reading from the default cache file (see "
11538 "the *CONFIGURATION FILE* section for more details). If you want to start "
11539 "with a clean cache (i.e., don't report devices previously scanned but not "
11540 "necessarily available at this time), specify _/dev/null_."
11543 #. type: Labeled list
11544 #: ../misc-utils/blkid.8.adoc:49
11546 #| msgid "*-*, *-l*, *--login*"
11547 msgid "*-d*, *--no-encoding*"
11548 msgstr "*-*, *-l*, *--login*"
11550 #. type: Plain text
11551 #: ../misc-utils/blkid.8.adoc:51
11553 "Don't encode non-printing characters. The non-printing characters are "
11554 "encoded by ^ and M- notation by default. Note that the *--output udev* "
11555 "output format uses a different encoding which cannot be disabled."
11558 #. type: Labeled list
11559 #: ../misc-utils/blkid.8.adoc:52
11561 msgid "*-D*, *--no-part-details*"
11564 #. type: Plain text
11565 #: ../misc-utils/blkid.8.adoc:54
11567 "Don't print information (PART_ENTRY_* tags) from partition table in low-"
11568 "level probing mode."
11571 #. type: Labeled list
11572 #: ../misc-utils/blkid.8.adoc:55
11574 msgid "*-g*, *--garbage-collect*"
11577 #. type: Plain text
11578 #: ../misc-utils/blkid.8.adoc:57
11580 "Perform a garbage collection pass on the blkid cache to remove devices which "
11584 #. type: Labeled list
11585 #: ../misc-utils/blkid.8.adoc:58
11587 msgid "*-H*, *--hint* _setting_"
11590 #. type: Plain text
11591 #: ../misc-utils/blkid.8.adoc:62
11593 "Set probing hint. The hints are an optional way to force probing functions "
11594 "to check, for example, another location. The currently supported is "
11595 "\"session_offset=_number_\" to set session offset on multi-session UDF."
11598 #. type: Labeled list
11599 #: ../misc-utils/blkid.8.adoc:63 ../sys-utils/readprofile.8.adoc:33
11601 #| msgid "*-f*, *--fast*"
11602 msgid "*-i*, *--info*"
11603 msgstr "*-f*, *--fast*"
11605 #. type: Plain text
11606 #: ../misc-utils/blkid.8.adoc:65
11608 "Display information about I/O Limits (aka I/O topology). The 'export' output "
11609 "format is automatically enabled. This option can be used together with the "
11610 "*--probe* option."
11613 #. type: Labeled list
11614 #: ../misc-utils/blkid.8.adoc:66
11616 #| msgid "*-f*, *--fast*"
11617 msgid "*-k*, *--list-filesystems*"
11618 msgstr "*-f*, *--fast*"
11620 #. type: Plain text
11621 #: ../misc-utils/blkid.8.adoc:68
11622 msgid "List all known filesystems and RAIDs and exit."
11625 #. type: Labeled list
11626 #: ../misc-utils/blkid.8.adoc:69
11628 #| msgid "*-f*, *--fast*"
11629 msgid "*-l*, *--list-one*"
11630 msgstr "*-f*, *--fast*"
11632 #. type: Plain text
11633 #: ../misc-utils/blkid.8.adoc:71
11635 "Look up only one device that matches the search parameter specified with the "
11636 "*--match-token* option. If there are multiple devices that match the "
11637 "specified search parameter, then the device with the highest priority is "
11638 "returned, and/or the first device found at a given priority (but see below "
11639 "note about udev). Device types in order of decreasing priority are: Device "
11640 "Mapper, EVMS, LVM, MD, and finally regular block devices. If this option is "
11641 "not specified, *blkid* will print all of the devices that match the search "
11645 #. type: Plain text
11646 #: ../misc-utils/blkid.8.adoc:73
11648 "This option forces *blkid* to use udev when used for LABEL or UUID tokens in "
11649 "*--match-token*. The goal is to provide output consistent with other utils "
11650 "(like *mount*(8), etc.) on systems where the same tag is used for multiple "
11654 #. type: Plain text
11655 #: ../misc-utils/blkid.8.adoc:76
11657 "Look up the device that uses this filesystem _label_; this is equal to **--"
11658 "list-one --output device --match-token LABEL=**__label__. This lookup method "
11659 "is able to reliably use /dev/disk/by-label udev symlinks (dependent on a "
11660 "setting in _/etc/blkid.conf_). Avoid using the symlinks directly; it is not "
11661 "reliable to use the symlinks without verification. The *--label* option "
11662 "works on systems with and without udev."
11665 #. type: Plain text
11666 #: ../misc-utils/blkid.8.adoc:78
11668 "Unfortunately, the original *blkid*(8) from e2fsprogs uses the *-L* option "
11669 "as a synonym for *-o list*. For better portability, use **-l -o device -t "
11670 "LABEL=**__label__ and *-o list* in your scripts rather than the *-L* option."
11673 #. type: Labeled list
11674 #: ../misc-utils/blkid.8.adoc:79
11676 msgid "*-n*, *--match-types* _list_"
11679 #. type: Plain text
11680 #: ../misc-utils/blkid.8.adoc:81
11682 "Restrict the probing functions to the specified (comma-separated) _list_ of "
11683 "superblock types (names). The list items may be prefixed with \"no\" to "
11684 "specify the types which should be ignored. For example:"
11687 #. type: Plain text
11688 #: ../misc-utils/blkid.8.adoc:83
11690 msgid "*blkid --probe --match-types vfat,ext3,ext4 /dev/sda1*\n"
11693 #. type: Plain text
11694 #: ../misc-utils/blkid.8.adoc:85
11695 msgid "probes for vfat, ext3 and ext4 filesystems, and"
11698 #. type: Plain text
11699 #: ../misc-utils/blkid.8.adoc:87
11701 msgid "*blkid --probe --match-types nominix /dev/sda1*\n"
11704 #. type: Plain text
11705 #: ../misc-utils/blkid.8.adoc:89
11707 "probes for all supported formats except minix filesystems. This option is "
11708 "only useful together with *--probe*."
11711 #. type: Labeled list
11712 #: ../misc-utils/blkid.8.adoc:90
11714 msgid "*-o*, *--output* _format_"
11717 #. type: Plain text
11718 #: ../misc-utils/blkid.8.adoc:92
11720 "Use the specified output format. Note that the order of variables and "
11721 "devices is not fixed. See also option *-s*. The _format_ parameter may be:"
11724 #. type: Labeled list
11725 #: ../misc-utils/blkid.8.adoc:93
11730 #. type: Plain text
11731 #: ../misc-utils/blkid.8.adoc:95
11732 msgid "print all tags (the default)"
11735 #. type: Labeled list
11736 #: ../misc-utils/blkid.8.adoc:95
11741 #. type: Plain text
11742 #: ../misc-utils/blkid.8.adoc:97
11743 msgid "print the value of the tags"
11746 #. type: Labeled list
11747 #: ../misc-utils/blkid.8.adoc:97
11752 #. type: Plain text
11753 #: ../misc-utils/blkid.8.adoc:99
11755 "print the devices in a user-friendly format; this output format is "
11756 "unsupported for low-level probing (*--probe* or *--info*)."
11759 #. type: Plain text
11760 #: ../misc-utils/blkid.8.adoc:101
11761 msgid "This output format is *DEPRECATED* in favour of the *lsblk*(8) command."
11764 #. type: Labeled list
11765 #: ../misc-utils/blkid.8.adoc:101
11770 #. type: Plain text
11771 #: ../misc-utils/blkid.8.adoc:103
11773 "print the device name only; this output format is always enabled for the *--"
11774 "label* and *--uuid* options"
11777 #. type: Labeled list
11778 #: ../misc-utils/blkid.8.adoc:103
11783 #. TRANSLATORS: Please keep {underscore} untranslated.
11784 #. type: Plain text
11785 #: ../misc-utils/blkid.8.adoc:106
11787 "print key=\"value\" pairs for easy import into the udev environment; the "
11788 "keys are prefixed by ID_FS_ or ID_PART_ prefixes. The value may be modified "
11789 "to be safe for udev environment; allowed is plain ASCII, hex-escaping and "
11790 "valid UTF-8, everything else (including whitespaces) is replaced with "
11791 "'{underscore}'. The keys with __ENC_ postfix use hex-escaping for unsafe "
11795 #. type: Plain text
11796 #: ../misc-utils/blkid.8.adoc:108
11798 "The udev output returns the ID_FS_AMBIVALENT tag if more superblocks are "
11799 "detected, and ID_PART_ENTRY_* tags are always returned for all partitions "
11800 "including empty partitions."
11803 #. type: Plain text
11804 #: ../misc-utils/blkid.8.adoc:110
11805 msgid "This output format is *DEPRECATED*."
11808 #. type: Labeled list
11809 #: ../misc-utils/blkid.8.adoc:110
11814 #. type: Plain text
11815 #: ../misc-utils/blkid.8.adoc:112
11817 "print key=value pairs for easy import into the environment; this output "
11818 "format is automatically enabled when I/O Limits (*--info* option) are "
11822 #. type: Plain text
11823 #: ../misc-utils/blkid.8.adoc:114
11825 "The non-printing characters are encoded by ^ and M- notation and all "
11826 "potentially unsafe characters are escaped."
11829 #. type: Labeled list
11830 #: ../misc-utils/blkid.8.adoc:115
11832 #| msgid "*-f*, *--fast*"
11833 msgid "*-O*, *--offset* _offset_"
11834 msgstr "*-f*, *--fast*"
11836 #. type: Plain text
11837 #: ../misc-utils/blkid.8.adoc:117
11839 "Probe at the given _offset_ (only useful with *--probe*). This option can be "
11840 "used together with the *--info* option."
11843 #. type: Labeled list
11844 #: ../misc-utils/blkid.8.adoc:118
11846 #| msgid "*-P*, *--pty*"
11847 msgid "*-p*, *--probe*"
11848 msgstr "*-P*, *--pty*"
11850 #. type: Plain text
11851 #: ../misc-utils/blkid.8.adoc:120
11852 msgid "Switch to low-level superblock probing mode (bypassing the cache)."
11855 #. type: Plain text
11856 #: ../misc-utils/blkid.8.adoc:122
11858 "Note that low-level probing also returns information about partition table "
11859 "type (PTTYPE tag) and partitions (PART_ENTRY_* tags). The tag names produced "
11860 "by low-level probing are based on names used internally by libblkid and it "
11861 "may be different than when executed without *--probe* (for example "
11862 "PART_ENTRY_UUID= vs PARTUUID=). See also *--no-part-details*."
11865 #. type: Labeled list
11866 #: ../misc-utils/blkid.8.adoc:123
11868 msgid "*-s*, *--match-tag* _tag_"
11871 #. type: Plain text
11872 #: ../misc-utils/blkid.8.adoc:125
11874 "For each (specified) device, show only the tags that match _tag_. It is "
11875 "possible to specify multiple *--match-tag* options. If no tag is specified, "
11876 "then all tokens are shown for all (specified) devices. In order to just "
11877 "refresh the cache without showing any tokens, use *--match-tag none* with no "
11881 #. type: Labeled list
11882 #: ../misc-utils/blkid.8.adoc:126 ../misc-utils/logger.1.adoc:158
11884 #| msgid "*-s*, **--shell**=__shell__"
11885 msgid "*-S*, *--size* _size_"
11886 msgstr "*-s*, **--shell**=__shell__"
11888 #. type: Plain text
11889 #: ../misc-utils/blkid.8.adoc:128
11890 msgid "Override the size of device/file (only useful with *--probe*)."
11893 #. type: Labeled list
11894 #: ../misc-utils/blkid.8.adoc:129
11896 msgid "*-t*, *--match-token* _NAME=value_"
11899 #. type: Plain text
11900 #: ../misc-utils/blkid.8.adoc:131
11902 "Search for block devices with tokens named _NAME_ that have the value "
11903 "_value_, and display any devices which are found. Common values for _NAME_ "
11904 "include *TYPE*, *LABEL*, and *UUID*. If there are no devices specified on "
11905 "the command line, all block devices will be searched; otherwise only the "
11906 "specified devices are searched."
11909 #. type: Labeled list
11910 #: ../misc-utils/blkid.8.adoc:132
11912 msgid "*-u*, *--usages* _list_"
11915 #. type: Plain text
11916 #: ../misc-utils/blkid.8.adoc:134
11918 "Restrict the probing functions to the specified (comma-separated) _list_ of "
11919 "\"usage\" types. Supported usage types are: filesystem, raid, crypto and "
11920 "other. The list items may be prefixed with \"no\" to specify the usage types "
11921 "which should be ignored. For example:"
11924 #. type: Plain text
11925 #: ../misc-utils/blkid.8.adoc:136
11927 msgid "*blkid --probe --usages filesystem,other /dev/sda1*\n"
11930 #. type: Plain text
11931 #: ../misc-utils/blkid.8.adoc:138
11932 msgid "probes for all filesystem and other (e.g., swap) formats, and"
11935 #. type: Plain text
11936 #: ../misc-utils/blkid.8.adoc:140
11938 msgid "*blkid --probe --usages noraid /dev/sda1*\n"
11941 #. type: Plain text
11942 #: ../misc-utils/blkid.8.adoc:142
11944 "probes for all supported formats except RAIDs. This option is only useful "
11945 "together with *--probe*."
11948 #. type: Labeled list
11949 #: ../misc-utils/blkid.8.adoc:143 ../sys-utils/mount.8.adoc:454
11951 msgid "*-U*, *--uuid* _uuid_"
11954 #. type: Plain text
11955 #: ../misc-utils/blkid.8.adoc:145
11957 "Look up the device that uses this filesystem _uuid_. For more details see "
11958 "the *--label* option."
11961 #. type: Plain text
11962 #: ../misc-utils/blkid.8.adoc:151
11964 "If the specified device or device addressed by specified token (option *--"
11965 "match-token*) was found and it's possible to gather any information about "
11966 "the device, an exit status 0 is returned. Note the option *--match-tag* "
11967 "filters output tags, but it does not affect exit status."
11970 #. type: Plain text
11971 #: ../misc-utils/blkid.8.adoc:153
11973 "If the specified token was not found, or no (specified) devices could be "
11974 "identified, or it is impossible to gather any information about the device "
11975 "identifiers or device content an exit status of 2 is returned."
11978 #. type: Plain text
11979 #: ../misc-utils/blkid.8.adoc:155
11980 msgid "For usage or other errors, an exit status of 4 is returned."
11983 #. type: Plain text
11984 #: ../misc-utils/blkid.8.adoc:157
11986 "If an ambivalent probing result was detected by low-level probing mode (*-"
11987 "p*), an exit status of 8 is returned."
11990 #. type: Plain text
11991 #: ../misc-utils/blkid.8.adoc:161
11993 "The standard location of the _/etc/blkid.conf_ config file can be overridden "
11994 "by the environment variable *BLKID_CONF*. The following options control the "
11995 "libblkid library:"
11998 #. type: Labeled list
11999 #: ../misc-utils/blkid.8.adoc:162
12001 msgid "_SEND_UEVENT=<yes|not>_"
12004 #. type: Plain text
12005 #: ../misc-utils/blkid.8.adoc:164
12007 "Sends uevent when _/dev/disk/by-{label,uuid,partuuid,partlabel}/_ symlink "
12008 "does not match with LABEL, UUID, PARTUUID or PARTLABEL on the device. "
12009 "Default is \"yes\"."
12012 #. type: Labeled list
12013 #: ../misc-utils/blkid.8.adoc:165
12015 msgid "_CACHE_FILE=<path>_"
12018 #. type: Plain text
12019 #: ../misc-utils/blkid.8.adoc:167
12021 "Overrides the standard location of the cache file. This setting can be "
12022 "overridden by the environment variable *BLKID_FILE*. Default is _/run/blkid/"
12023 "blkid.tab_, or _/etc/blkid.tab_ on systems without a _/run_ directory."
12026 #. type: Labeled list
12027 #: ../misc-utils/blkid.8.adoc:168
12029 msgid "_EVALUATE=<methods>_"
12032 #. type: Plain text
12033 #: ../misc-utils/blkid.8.adoc:170
12035 "Defines LABEL and UUID evaluation method(s). Currently, the libblkid library "
12036 "supports the \"udev\" and \"scan\" methods. More than one method may be "
12037 "specified in a comma-separated list. Default is \"udev,scan\". The \"udev\" "
12038 "method uses udev _/dev/disk/by-*_ symlinks and the \"scan\" method scans all "
12039 "block devices from the _/proc/partitions_ file."
12042 #. type: Plain text
12043 #: ../misc-utils/blkid.8.adoc:174
12044 msgid "Setting _LIBBLKID_DEBUG=all_ enables debug output."
12047 #. type: Plain text
12048 #: ../misc-utils/blkid.8.adoc:178
12050 msgid "*blkid* was written by Andreas Dilger for libblkid and improved by Theodore Ts'o and Karel Zak.\n"
12053 #. type: Plain text
12054 #: ../misc-utils/blkid.8.adoc:185
12067 #. Copyright (c) 1989, 1990, 1993
12068 #. The Regents of the University of California. All rights reserved.
12069 #. This code is derived from software contributed to Berkeley by
12071 #. Redistribution and use in source and binary forms, with or without
12072 #. modification, are permitted provided that the following conditions
12074 #. 1. Redistributions of source code must retain the above copyright
12075 #. notice, this list of conditions and the following disclaimer.
12076 #. 2. Redistributions in binary form must reproduce the above copyright
12077 #. notice, this list of conditions and the following disclaimer in the
12078 #. documentation and/or other materials provided with the distribution.
12079 #. 3. All advertising materials mentioning features or use of this software
12080 #. must display the following acknowledgement:
12081 #. This product includes software developed by the University of
12082 #. California, Berkeley and its contributors.
12083 #. 4. Neither the name of the University nor the names of its contributors
12084 #. may be used to endorse or promote products derived from this software
12085 #. without specific prior written permission.
12086 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
12087 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
12088 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
12089 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
12090 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
12091 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
12092 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
12093 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
12094 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
12095 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
12097 #. @(#)cal.1 8.1 (Berkeley) 6/6/93
12099 #: ../misc-utils/cal.1.adoc:39
12104 #. type: Plain text
12105 #: ../misc-utils/cal.1.adoc:50
12106 msgid "cal - display a calendar"
12109 #. type: Plain text
12110 #: ../misc-utils/cal.1.adoc:54
12112 msgid "*cal* [options] [[[_day_] _month_] _year_]\n"
12115 #. type: Plain text
12116 #: ../misc-utils/cal.1.adoc:56
12118 msgid "*cal* [options] [_timestamp_|_monthname_]\n"
12121 #. type: Plain text
12122 #: ../misc-utils/cal.1.adoc:60
12124 msgid "*cal* displays a simple calendar. If no arguments are specified, the current month is displayed.\n"
12127 #. type: Plain text
12128 #: ../misc-utils/cal.1.adoc:62
12130 "The _month_ may be specified as a number (1-12), as a month name or as an "
12131 "abbreviated month name according to the current locales."
12134 #. type: Plain text
12135 #: ../misc-utils/cal.1.adoc:64
12137 "Two different calendar systems are used, Gregorian and Julian. These are "
12138 "nearly identical systems with Gregorian making a small adjustment to the "
12139 "frequency of leap years; this facilitates improved synchronization with "
12140 "solar events like the equinoxes. The Gregorian calendar reform was "
12141 "introduced in 1582, but its adoption continued up to 1923. By default *cal* "
12142 "uses the adoption date of 3 Sept 1752. From that date forward the Gregorian "
12143 "calendar is displayed; previous dates use the Julian calendar system. 11 "
12144 "days were removed at the time of adoption to bring the calendar in sync with "
12145 "solar events. So Sept 1752 has a mix of Julian and Gregorian dates by which "
12146 "the 2nd is followed by the 14th (the 3rd through the 13th are absent)."
12149 #. type: Plain text
12150 #: ../misc-utils/cal.1.adoc:66
12152 "Optionally, either the proleptic Gregorian calendar or the Julian calendar "
12153 "may be used exclusively. See *--reform* below."
12156 #. type: Labeled list
12157 #: ../misc-utils/cal.1.adoc:69
12159 #| msgid "*-h*, *--help*"
12160 msgid "*-1*, *--one*"
12161 msgstr "*-h*, *--help*"
12163 #. type: Plain text
12164 #: ../misc-utils/cal.1.adoc:71
12165 msgid "Display single month output. (This is the default.)"
12168 #. type: Labeled list
12169 #: ../misc-utils/cal.1.adoc:72
12171 #| msgid "*-h*, *--help*"
12172 msgid "*-3*, *--three*"
12173 msgstr "*-h*, *--help*"
12175 #. type: Plain text
12176 #: ../misc-utils/cal.1.adoc:74
12177 msgid "Display three months spanning the date."
12180 #. type: Labeled list
12181 #: ../misc-utils/cal.1.adoc:75
12183 msgid "*-n , --months* _number_"
12186 #. type: Plain text
12187 #: ../misc-utils/cal.1.adoc:77
12189 "Display _number_ of months, starting from the month containing the date."
12192 #. type: Labeled list
12193 #: ../misc-utils/cal.1.adoc:78
12195 msgid "*-S, --span*"
12198 #. type: Plain text
12199 #: ../misc-utils/cal.1.adoc:80
12200 msgid "Display months spanning the date."
12203 #. type: Labeled list
12204 #: ../misc-utils/cal.1.adoc:81
12206 #| msgid "*-P*, *--pty*"
12207 msgid "*-s*, *--sunday*"
12208 msgstr "*-P*, *--pty*"
12210 #. type: Plain text
12211 #: ../misc-utils/cal.1.adoc:83
12212 msgid "Display Sunday as the first day of the week."
12215 #. type: Labeled list
12216 #: ../misc-utils/cal.1.adoc:84
12218 #| msgid "*-P*, *--pty*"
12219 msgid "*-m*, *--monday*"
12220 msgstr "*-P*, *--pty*"
12222 #. type: Plain text
12223 #: ../misc-utils/cal.1.adoc:86
12224 msgid "Display Monday as the first day of the week."
12227 #. type: Labeled list
12228 #: ../misc-utils/cal.1.adoc:87 ../misc-utils/namei.1.adoc:53
12230 #| msgid "*-V*, *--version*"
12231 msgid "*-v*, *--vertical*"
12232 msgstr "*-V*, *--version*"
12234 #. type: Plain text
12235 #: ../misc-utils/cal.1.adoc:89
12236 msgid "Display using a vertical layout (aka *ncal*(1) mode)."
12239 #. type: Labeled list
12240 #: ../misc-utils/cal.1.adoc:90
12245 #. type: Plain text
12246 #: ../misc-utils/cal.1.adoc:92
12248 "Display the proleptic Gregorian calendar exclusively. This option does not "
12249 "affect week numbers and the first day of the week. See *--reform* below."
12252 #. type: Labeled list
12253 #: ../misc-utils/cal.1.adoc:93
12255 #| msgid "*-h*, *--help*"
12256 msgid "*-j*, *--julian*"
12257 msgstr "*-h*, *--help*"
12259 #. type: Plain text
12260 #: ../misc-utils/cal.1.adoc:95
12262 "Use day-of-year numbering for all calendars. These are also called ordinal "
12263 "days. Ordinal days range from 1 to 366. This option does not switch from the "
12264 "Gregorian to the Julian calendar system, that is controlled by the *--"
12268 #. type: Plain text
12269 #: ../misc-utils/cal.1.adoc:97
12271 "Sometimes Gregorian calendars using ordinal dates are referred to as Julian "
12272 "calendars. This can be confusing due to the many date related conventions "
12273 "that use Julian in their name: (ordinal) julian date, julian (calendar) "
12274 "date, (astronomical) julian date, (modified) julian date, and more. This "
12275 "option is named julian, because ordinal days are identified as julian by the "
12276 "POSIX standard. However, be aware that *cal* also uses the Julian calendar "
12277 "system. See *DESCRIPTION* above."
12280 #. type: Labeled list
12281 #: ../misc-utils/cal.1.adoc:98
12283 msgid "*--reform* _val_"
12286 #. type: Plain text
12287 #: ../misc-utils/cal.1.adoc:100
12289 "This option sets the adoption date of the Gregorian calendar reform. "
12290 "Calendar dates previous to reform use the Julian calendar system. Calendar "
12291 "dates after reform use the Gregorian calendar system. The argument _val_ can "
12295 #. type: Plain text
12296 #: ../misc-utils/cal.1.adoc:102
12298 "_1752_ - sets 3 September 1752 as the reform date (default). This is when "
12299 "the Gregorian calendar reform was adopted by the British Empire."
12302 #. type: Plain text
12303 #: ../misc-utils/cal.1.adoc:103
12305 "_gregorian_ - display Gregorian calendars exclusively. This special "
12306 "placeholder sets the reform date below the smallest year that *cal* can use; "
12307 "meaning all calendar output uses the Gregorian calendar system. This is "
12308 "called the proleptic Gregorian calendar, because dates prior to the calendar "
12309 "system's creation use extrapolated values."
12312 #. type: Plain text
12313 #: ../misc-utils/cal.1.adoc:104
12315 "_iso_ - alias of _gregorian_. The ISO 8601 standard for the representation "
12316 "of dates and times in information interchange requires using the proleptic "
12317 "Gregorian calendar."
12320 #. type: Plain text
12321 #: ../misc-utils/cal.1.adoc:105
12323 "_julian_ - display Julian calendars exclusively. This special placeholder "
12324 "sets the reform date above the largest year that *cal* can use; meaning all "
12325 "calendar output uses the Julian calendar system."
12328 #. type: Plain text
12329 #: ../misc-utils/cal.1.adoc:107
12331 #| msgid "DESCRIPTION"
12332 msgid "See *DESCRIPTION* above."
12335 #. type: Labeled list
12336 #: ../misc-utils/cal.1.adoc:108
12338 #| msgid "*-P*, *--pty*"
12339 msgid "*-y*, *--year*"
12340 msgstr "*-P*, *--pty*"
12342 #. type: Plain text
12343 #: ../misc-utils/cal.1.adoc:110
12344 msgid "Display a calendar for the whole year."
12347 #. type: Labeled list
12348 #: ../misc-utils/cal.1.adoc:111
12350 msgid "*-Y, --twelve*"
12353 #. type: Plain text
12354 #: ../misc-utils/cal.1.adoc:113
12355 msgid "Display a calendar for the next twelve months."
12358 #. type: Labeled list
12359 #: ../misc-utils/cal.1.adoc:114
12361 msgid "*-w*, *--week*[=_number_]"
12364 #. type: Plain text
12365 #: ../misc-utils/cal.1.adoc:116
12367 "Display week numbers in the calendar (US or ISO-8601). See the *NOTES* "
12368 "section for more details."
12371 #. type: Labeled list
12372 #: ../misc-utils/cal.1.adoc:117
12374 msgid "*--color*[=_when_]"
12377 #. type: Labeled list
12378 #: ../misc-utils/cal.1.adoc:120
12380 #| msgid "*-c*, **--command**=__command__"
12381 msgid "*-c, --columns*=_columns_"
12382 msgstr "*-c*, **--command**=__příkaz__"
12384 #. type: Plain text
12385 #: ../misc-utils/cal.1.adoc:122
12386 msgid "Number of columns to use. *auto* uses as many as fit the terminal."
12389 #. type: Labeled list
12390 #: ../misc-utils/cal.1.adoc:127
12392 msgid "*Single digits-only parameter (e.g., 'cal 2020')*"
12395 #. type: Plain text
12396 #: ../misc-utils/cal.1.adoc:129
12398 "Specifies the _year_ to be displayed; note the year must be fully specified: "
12399 "*cal 89* will not display a calendar for 1989."
12402 #. type: Labeled list
12403 #: ../misc-utils/cal.1.adoc:130
12405 msgid "*Single string parameter (e.g., 'cal tomorrow' or 'cal August')*"
12408 #. type: Plain text
12409 #: ../misc-utils/cal.1.adoc:132
12411 "Specifies _timestamp_ or a _month name_ (or abbreviated name) according to "
12412 "the current locales."
12415 #. type: Plain text
12416 #: ../misc-utils/cal.1.adoc:134
12418 "The special placeholders are accepted when parsing timestamp, \"now\" may be "
12419 "used to refer to the current time, \"today\", \"yesterday\", \"tomorrow\" "
12420 "refer to of the current day, the day before or the next day, respectively."
12423 #. TRANSLATORS: Please keep {plus} untranslated.
12424 #. type: Plain text
12425 #: ../misc-utils/cal.1.adoc:136
12427 "The relative date specifications are also accepted, in this case \"{plus}\" "
12428 "is evaluated to the current time plus the specified time span. "
12429 "Correspondingly, a time span that is prefixed with \"-\" is evaluated to the "
12430 "current time minus the specified time span, for example '{plus}2days'. "
12431 "Instead of prefixing the time span with \"{plus}\" or \"-\", it may also be "
12432 "suffixed with a space and the word \"left\" or \"ago\" (for example '1 week "
12436 #. type: Labeled list
12437 #: ../misc-utils/cal.1.adoc:138
12439 msgid "*Two parameters (e.g., 'cal 11 2020')*"
12442 #. type: Plain text
12443 #: ../misc-utils/cal.1.adoc:140
12444 msgid "Denote the _month_ (1 - 12) and _year_."
12447 #. type: Labeled list
12448 #: ../misc-utils/cal.1.adoc:141
12450 msgid "*Three parameters (e.g., 'cal 25 11 2020')*"
12453 #. type: Plain text
12454 #: ../misc-utils/cal.1.adoc:143
12456 "Denote the _day_ (1-31), _month and year_, and the day will be highlighted "
12457 "if the calendar is displayed on a terminal. If no parameters are specified, "
12458 "the current month's calendar is displayed."
12461 #. type: Plain text
12462 #: ../misc-utils/cal.1.adoc:147
12464 "A year starts on January 1. The first day of the week is determined by the "
12465 "locale or the *--sunday* and *--monday* options."
12468 #. type: Plain text
12469 #: ../misc-utils/cal.1.adoc:149
12471 "The week numbering depends on the choice of the first day of the week. If it "
12472 "is Sunday then the customary North American numbering is used, where 1 "
12473 "January is in week number 1. If it is Monday (*-m*) then the ISO 8601 "
12474 "standard week numbering is used, where the first Thursday is in week number "
12478 #. type: Plain text
12479 #: ../misc-utils/cal.1.adoc:152
12480 msgid "The logical color names supported by *cal* are:"
12483 #. type: Labeled list
12484 #: ../misc-utils/cal.1.adoc:153
12489 #. type: Plain text
12490 #: ../misc-utils/cal.1.adoc:155
12491 msgid "The current day."
12494 #. type: Labeled list
12495 #: ../misc-utils/cal.1.adoc:156
12497 msgid "*weeknumber*"
12500 #. type: Plain text
12501 #: ../misc-utils/cal.1.adoc:158
12502 msgid "The number of the week."
12505 #. type: Plain text
12506 #: ../misc-utils/cal.1.adoc:161
12507 msgid "The header of a month."
12510 #. type: Labeled list
12511 #: ../misc-utils/cal.1.adoc:162
12516 #. type: Plain text
12517 #: ../misc-utils/cal.1.adoc:164
12518 msgid "Days that fall within the work-week."
12521 #. type: Labeled list
12522 #: ../misc-utils/cal.1.adoc:165
12527 #. type: Plain text
12528 #: ../misc-utils/cal.1.adoc:167
12529 msgid "Days that fall outside the work-week."
12532 #. type: Plain text
12533 #: ../misc-utils/cal.1.adoc:169 ../sys-utils/mount.8.adoc:286
12534 msgid "For example:"
12537 #. type: delimited block _
12538 #: ../misc-utils/cal.1.adoc:171
12540 "echo -e 'weekend 35\\ntoday 1;41\\nheader yellow' > $HOME/.config/terminal-"
12541 "colors.d/cal.scheme"
12544 #. type: Plain text
12545 #: ../misc-utils/cal.1.adoc:176
12547 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
12548 msgid "A *cal* command appeared in Version 6 AT&T UNIX."
12549 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
12551 #. type: Plain text
12552 #: ../misc-utils/cal.1.adoc:180
12554 "The default *cal* output uses 3 September 1752 as the Gregorian calendar "
12555 "reform date. The historical reform dates for the other locales, including "
12556 "its introduction in October 1582, are not implemented."
12559 #. type: Plain text
12560 #: ../misc-utils/cal.1.adoc:182
12562 "Alternative calendars, such as the Umm al-Qura, the Solar Hijri, the Ge'ez, "
12563 "or the lunisolar Hindu, are not supported."
12566 #. type: Plain text
12567 #: ../misc-utils/cal.1.adoc:186
12569 #| msgid "_/etc/terminal-colors.d/disable_"
12570 msgid "*terminal-colors.d*(5)\n"
12571 msgstr "_/etc/terminal-colors.d/disable_"
12574 #: ../misc-utils/fadvise.1.adoc:2
12579 #. type: Plain text
12580 #: ../misc-utils/fadvise.1.adoc:12
12581 msgid "fadvise - utility to use the posix_fadvise system call"
12584 #. type: Plain text
12585 #: ../misc-utils/fadvise.1.adoc:16
12587 msgid "*fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] _filename_\n"
12590 #. type: Plain text
12591 #: ../misc-utils/fadvise.1.adoc:18
12593 msgid "*fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] -d _file-descriptor_\n"
12596 #. type: Plain text
12597 #: ../misc-utils/fadvise.1.adoc:23
12600 "*fadvise* is a simple command wrapping posix_fadvise system call\n"
12601 "that is for predeclaring an access pattern for file data.\n"
12604 #. type: Labeled list
12605 #: ../misc-utils/fadvise.1.adoc:26
12607 #| msgid "*-f*, *--fast*"
12608 msgid "*-d*, *--fd* _file-descriptor_"
12609 msgstr "*-f*, *--fast*"
12611 #. type: Plain text
12612 #: ../misc-utils/fadvise.1.adoc:29
12614 "Apply the advice to the file specified with the file descriptor instead of "
12615 "open a file specified with a file name."
12618 #. type: Labeled list
12619 #: ../misc-utils/fadvise.1.adoc:30
12621 #| msgid "*-V*, *--version*"
12622 msgid "*-a*, *--advice* _advice_"
12623 msgstr "*-V*, *--version*"
12625 #. type: Plain text
12626 #: ../misc-utils/fadvise.1.adoc:33
12628 "See the command output with *--help* option for available values for advice. "
12629 "If this option is omitted, \"dontneed\" is used as default advice."
12632 #. type: Plain text
12633 #: ../misc-utils/fadvise.1.adoc:37
12635 "Specifies the beginning offset of the range, in bytes. If this option is "
12636 "omitted, 0 is used as default advice."
12639 #. type: Labeled list
12640 #: ../misc-utils/fadvise.1.adoc:38 ../sys-utils/blkdiscard.8.adoc:37
12641 #: ../sys-utils/fallocate.1.adoc:50
12643 msgid "*-l*, *--length* _length_"
12646 #. type: Plain text
12647 #: ../misc-utils/fadvise.1.adoc:41
12649 "Specifies the length of the range, in bytes. If this option is omitted, 0 "
12650 "is used as default advice."
12653 #. type: Plain text
12654 #: ../misc-utils/fadvise.1.adoc:47
12656 msgid "*fadvise* has the following exit status values:\n"
12659 #. type: Plain text
12660 #: ../misc-utils/fadvise.1.adoc:52 ../misc-utils/waitpid.1.adoc:48
12661 msgid "unspecified failure"
12664 #. type: Plain text
12665 #: ../misc-utils/fadvise.1.adoc:56 ../misc-utils/fincore.1.adoc:55
12666 msgid "mailto:yamato@redhat.com[Masatake YAMATO]"
12669 #. type: Plain text
12670 #: ../misc-utils/fadvise.1.adoc:60
12672 msgid "*posix_fadvise*(2)\n"
12676 #. Copyright 2017 Red Hat, Inc.
12677 #. This file may be copied under the terms of the GNU Public License.
12679 #: ../misc-utils/fincore.1.adoc:7
12684 #. type: Plain text
12685 #: ../misc-utils/fincore.1.adoc:18
12686 msgid "fincore - count pages of file contents in core"
12689 #. type: Plain text
12690 #: ../misc-utils/fincore.1.adoc:22
12692 msgid "*fincore* [options] _file_...\n"
12695 #. type: Plain text
12696 #: ../misc-utils/fincore.1.adoc:26
12698 msgid "*fincore* counts pages of file contents being resident in memory (in core), and reports the numbers. If an error occurs during counting, then an error message is printed to the stderr and *fincore* continues processing the rest of files listed in a command line.\n"
12701 #. type: Plain text
12702 #: ../misc-utils/fincore.1.adoc:28 ../misc-utils/lsfd.1.adoc:34
12704 "The default output is subject to change. So whenever possible, you should "
12705 "avoid using default outputs in your scripts. Always explicitly define "
12706 "expected columns by using *--output* _columns-list_ in environments where a "
12707 "stable output is required."
12710 #. type: Labeled list
12711 #: ../misc-utils/fincore.1.adoc:31 ../misc-utils/findmnt.8.adoc:90
12712 #: ../misc-utils/lsblk.8.adoc:85 ../misc-utils/lsfd.1.adoc:47
12713 #: ../misc-utils/lslocks.8.adoc:43 ../misc-utils/uuidparse.1.adoc:53
12714 #: ../sys-utils/losetup.8.adoc:110 ../sys-utils/lsirq.1.adoc:25
12715 #: ../sys-utils/lsmem.1.adoc:42 ../sys-utils/lsns.8.adoc:40
12716 #: ../sys-utils/rfkill.8.adoc:30 ../sys-utils/wdctl.8.adoc:36
12717 #: ../sys-utils/zramctl.8.adoc:49
12719 #| msgid "*-V*, *--version*"
12720 msgid "*-n*, *--noheadings*"
12721 msgstr "*-V*, *--version*"
12723 #. type: Plain text
12724 #: ../misc-utils/fincore.1.adoc:33 ../sys-utils/zramctl.8.adoc:51
12725 msgid "Do not print a header line in status output."
12728 #. TRANSLATORS: Keep {plus} untranslated.
12729 #. type: Plain text
12730 #: ../misc-utils/fincore.1.adoc:39
12732 "Define output columns. See the *--help* output to get a list of the "
12733 "currently supported columns. The default list of columns may be extended if "
12734 "_list_ is specified in the format _{plus}list_."
12737 #. type: Plain text
12738 #: ../misc-utils/fincore.1.adoc:46 ../sys-utils/lsmem.1.adoc:56
12740 "Produce output in raw format. All potentially unsafe characters are hex-"
12741 "escaped (\\x<code>)."
12744 #. type: Labeled list
12745 #: ../misc-utils/fincore.1.adoc:47 ../misc-utils/findmnt.8.adoc:72
12746 #: ../misc-utils/lsblk.8.adoc:67 ../misc-utils/lsfd.1.adoc:44
12747 #: ../misc-utils/lslocks.8.adoc:40 ../misc-utils/uuidparse.1.adoc:50
12748 #: ../misc-utils/wipefs.8.adoc:49 ../sys-utils/dmesg.1.adoc:72
12749 #: ../sys-utils/losetup.8.adoc:116 ../sys-utils/lscpu.1.adoc:66
12750 #: ../sys-utils/lsipc.1.adoc:50 ../sys-utils/lsirq.1.adoc:34
12751 #: ../sys-utils/lsmem.1.adoc:39 ../sys-utils/lsns.8.adoc:34
12752 #: ../sys-utils/rfkill.8.adoc:27
12754 #| msgid "*-V*, *--version*"
12755 msgid "*-J*, *--json*"
12756 msgstr "*-V*, *--version*"
12758 #. type: Plain text
12759 #: ../misc-utils/fincore.1.adoc:49 ../misc-utils/findmnt.8.adoc:74
12760 #: ../misc-utils/lsfd.1.adoc:46 ../misc-utils/lslocks.8.adoc:42
12761 #: ../misc-utils/uuidparse.1.adoc:52 ../misc-utils/wipefs.8.adoc:51
12762 #: ../sys-utils/lsirq.1.adoc:36 ../sys-utils/lsmem.1.adoc:41
12763 #: ../sys-utils/lsns.8.adoc:36 ../sys-utils/rfkill.8.adoc:29
12764 msgid "Use JSON output format."
12767 #. type: Plain text
12768 #: ../misc-utils/fincore.1.adoc:62
12776 "*getpagesize*(2),\n"
12784 #. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
12785 #. This file may be copied under the terms of the GNU Public License.
12787 #: ../misc-utils/findfs.8.adoc:4
12792 #. type: Plain text
12793 #: ../misc-utils/findfs.8.adoc:14
12794 msgid "findfs - find a filesystem by label or UUID"
12797 #. type: Plain text
12798 #: ../misc-utils/findfs.8.adoc:18
12800 msgid "*findfs* *NAME*=_value_\n"
12803 #. type: Plain text
12804 #: ../misc-utils/findfs.8.adoc:22
12806 msgid "*findfs* will search the block devices in the system looking for a filesystem or partition with specified tag. The currently supported tags are:\n"
12809 #. type: Labeled list
12810 #: ../misc-utils/findfs.8.adoc:23
12812 msgid "*LABEL*=_<label>_"
12815 #. type: Plain text
12816 #: ../misc-utils/findfs.8.adoc:25
12817 msgid "Specifies filesystem label."
12820 #. type: Labeled list
12821 #: ../misc-utils/findfs.8.adoc:26
12823 msgid "*UUID*=_<uuid>_"
12826 #. type: Plain text
12827 #: ../misc-utils/findfs.8.adoc:28
12828 msgid "Specifies filesystem UUID."
12831 #. type: Labeled list
12832 #: ../misc-utils/findfs.8.adoc:29
12834 msgid "*PARTUUID*=_<uuid>_"
12837 #. type: Plain text
12838 #: ../misc-utils/findfs.8.adoc:31
12841 #| "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
12842 #| "identifiers are supported for example for GUID Partition Table (GPT)."
12844 "Specifies partition UUID. This partition identifier is supported for example "
12845 "for GUID Partition Table (GPT) partition tables."
12847 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
12848 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
12850 #. type: Labeled list
12851 #: ../misc-utils/findfs.8.adoc:32
12853 msgid "*PARTLABEL*=_<label>_"
12856 #. type: Plain text
12857 #: ../misc-utils/findfs.8.adoc:34
12860 #| "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
12861 #| "identifiers are supported for example for GUID Partition Table (GPT)."
12863 "Specifies partition label (name). The partition labels are supported for "
12864 "example for GUID Partition Table (GPT) or MAC partition tables."
12866 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
12867 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
12869 #. type: Plain text
12870 #: ../misc-utils/findfs.8.adoc:36
12872 "If the filesystem or partition is found, the device name will be printed on "
12876 #. type: Plain text
12877 #: ../misc-utils/findfs.8.adoc:38
12879 "The complete overview about filesystems and partitions you can get for "
12883 #. type: delimited block _
12884 #: ../misc-utils/findfs.8.adoc:41
12886 msgid "*lsblk --fs*\n"
12889 #. type: delimited block _
12890 #: ../misc-utils/findfs.8.adoc:43
12892 msgid "*partx --show <disk>*\n"
12895 #. type: delimited block _
12896 #: ../misc-utils/findfs.8.adoc:45
12901 #. type: Plain text
12902 #: ../misc-utils/findfs.8.adoc:55
12903 msgid "label or uuid cannot be found"
12906 #. type: Plain text
12907 #: ../misc-utils/findfs.8.adoc:57
12908 msgid "usage error, wrong number of arguments or unknown option"
12911 #. type: Plain text
12912 #: ../misc-utils/findfs.8.adoc:66
12914 msgid "*findfs* was originally written by mailto:tytso@mit.edu[Theodore Ts'o] and re-written for the util-linux package by mailto:kzak@redhat.com[Karel Zak].\n"
12917 #. type: Plain text
12918 #: ../misc-utils/findfs.8.adoc:72
12927 #: ../misc-utils/findmnt.8.adoc:2
12932 #. type: Plain text
12933 #: ../misc-utils/findmnt.8.adoc:13
12934 msgid "findmnt - find a filesystem"
12937 #. type: Plain text
12938 #: ../misc-utils/findmnt.8.adoc:17
12940 msgid "*findmnt* [options]\n"
12943 #. type: Plain text
12944 #: ../misc-utils/findmnt.8.adoc:19
12946 msgid "*findmnt* [options] _device_|_mountpoint_\n"
12949 #. type: Plain text
12950 #: ../misc-utils/findmnt.8.adoc:21
12952 msgid "*findmnt* [options] [*--source*] _device_ [*--target* _path_|*--mountpoint* _mountpoint_]\n"
12955 #. type: Plain text
12956 #: ../misc-utils/findmnt.8.adoc:25
12958 msgid "*findmnt* will list all mounted filesystems or search for a filesystem. The *findmnt* command is able to search in _/etc/fstab_, _/etc/mtab_ or _/proc/self/mountinfo_. If _device_ or _mountpoint_ is not given, all filesystems are shown.\n"
12961 #. type: Plain text
12962 #: ../misc-utils/findmnt.8.adoc:27
12964 "The device may be specified by device name, major:minor numbers, filesystem "
12965 "label or UUID, or partition label or UUID. Note that *findmnt* follows "
12966 "*mount*(8) behavior where a device name may be interpreted as a mountpoint "
12967 "(and vice versa) if the *--target*, *--mountpoint* or *--source* options are "
12971 #. type: Plain text
12972 #: ../misc-utils/findmnt.8.adoc:29
12974 "The command-line option *--target* accepts any file or directory and then "
12975 "*findmnt* displays the filesystem for the given path."
12978 #. type: Plain text
12979 #: ../misc-utils/findmnt.8.adoc:31
12981 "The command prints all mounted filesystems in the tree-like format by "
12982 "default. The default output, is subject to change. So whenever possible, you "
12983 "should avoid using default output in your scripts. Always explicitly define "
12984 "expected columns by using *--output columns-list* in environments where a "
12985 "stable output is required."
12988 #. type: Plain text
12989 #: ../misc-utils/findmnt.8.adoc:33
12991 "The relationship between block devices and filesystems is not always one-to-"
12992 "one. The filesystem may use more block devices. This is why *findmnt* "
12993 "provides SOURCE and SOURCES (pl.) columns. The column SOURCES displays all "
12994 "devices where it is possible to find the same filesystem UUID (or another "
12995 "tag specified in _fstab_ when executed with *--fstab* and *--evaluate*)."
12998 #. type: Labeled list
12999 #: ../misc-utils/findmnt.8.adoc:36
13001 #| msgid "*-h*, *--help*"
13002 msgid "*-A*, *--all*"
13003 msgstr "*-h*, *--help*"
13005 #. type: Plain text
13006 #: ../misc-utils/findmnt.8.adoc:38
13007 msgid "Disable all built-in filters and print all filesystems."
13010 #. type: Labeled list
13011 #: ../misc-utils/findmnt.8.adoc:39
13013 #| msgid "*-f*, *--fast*"
13014 msgid "*-a*, *--ascii*"
13015 msgstr "*-f*, *--fast*"
13017 #. type: Plain text
13018 #: ../misc-utils/findmnt.8.adoc:41
13019 msgid "Use ascii characters for tree formatting."
13022 #. type: Labeled list
13023 #: ../misc-utils/findmnt.8.adoc:45
13025 msgid "*-C*, *--nocanonicalize*"
13028 #. type: Plain text
13029 #: ../misc-utils/findmnt.8.adoc:47
13031 "Do not canonicalize paths at all. This option affects the comparing of paths "
13032 "and the evaluation of tags (LABEL, UUID, etc.)."
13035 #. type: Labeled list
13036 #: ../misc-utils/findmnt.8.adoc:48
13038 msgid "*-c*, *--canonicalize*"
13041 #. type: Plain text
13042 #: ../misc-utils/findmnt.8.adoc:50
13043 msgid "Canonicalize all printed paths."
13046 #. type: Labeled list
13047 #: ../misc-utils/findmnt.8.adoc:51
13049 msgid "*--deleted*"
13052 #. type: Plain text
13053 #: ../misc-utils/findmnt.8.adoc:53
13055 "Print filesystems where target (mountpoint) is marked as deleted by kernel."
13058 #. type: Labeled list
13059 #: ../misc-utils/findmnt.8.adoc:54
13061 #| msgid "*-f*, *--fast*"
13062 msgid "*-D*, *--df*"
13063 msgstr "*-f*, *--fast*"
13065 #. type: Plain text
13066 #: ../misc-utils/findmnt.8.adoc:56
13068 "Imitate the output of *df*(1). This option is equivalent to *-o SOURCE,"
13069 "FSTYPE,SIZE,USED,AVAIL,USE%,TARGET* but excludes all pseudo filesystems. Use "
13070 "*--all* to print all filesystems."
13073 #. type: Labeled list
13074 #: ../misc-utils/findmnt.8.adoc:57
13076 #| msgid "*-V*, *--version*"
13077 msgid "*-d*, *--direction* _word_"
13078 msgstr "*-V*, *--version*"
13080 #. type: Plain text
13081 #: ../misc-utils/findmnt.8.adoc:59
13082 msgid "The search direction, either *forward* or *backward*."
13085 #. type: Labeled list
13086 #: ../misc-utils/findmnt.8.adoc:60
13088 #| msgid "*-h*, *--help*"
13089 msgid "*-e*, *--evaluate*"
13090 msgstr "*-h*, *--help*"
13092 #. type: Plain text
13093 #: ../misc-utils/findmnt.8.adoc:62
13095 "Convert all tags (LABEL, UUID, PARTUUID, or PARTLABEL) to the corresponding "
13096 "device names for the SOURCE column. It's an unusual situation, but the same "
13097 "tag may be duplicated (used for more devices). For this purpose, there is "
13098 "SOURCES (pl.) column. This column displays by multi-line cell all devices "
13099 "where the tag is detected by libblkid. This option makes sense for _fstab_ "
13103 #. type: Labeled list
13104 #: ../misc-utils/findmnt.8.adoc:63
13106 msgid "*-F*, *--tab-file* _path_"
13109 #. type: Plain text
13110 #: ../misc-utils/findmnt.8.adoc:65
13112 "Search in an alternative file. If used with *--fstab*, *--mtab* or *--"
13113 "kernel*, then it overrides the default paths. If specified more than once, "
13114 "then tree-like output is disabled (see the *--list* option)."
13117 #. type: Labeled list
13118 #: ../misc-utils/findmnt.8.adoc:66
13120 #| msgid "*-f*, *--fast*"
13121 msgid "*-f*, *--first-only*"
13122 msgstr "*-f*, *--fast*"
13124 #. type: Plain text
13125 #: ../misc-utils/findmnt.8.adoc:68
13126 msgid "Print the first matching filesystem only."
13129 #. type: Labeled list
13130 #: ../misc-utils/findmnt.8.adoc:69
13132 #| msgid "*-V*, *--version*"
13133 msgid "*-i*, *--invert*"
13134 msgstr "*-V*, *--version*"
13136 #. type: Plain text
13137 #: ../misc-utils/findmnt.8.adoc:71
13138 msgid "Invert the sense of matching."
13141 #. type: Labeled list
13142 #: ../misc-utils/findmnt.8.adoc:75 ../sys-utils/dmesg.1.adoc:75
13144 #| msgid "*-h*, *--help*"
13145 msgid "*-k*, *--kernel*"
13146 msgstr "*-h*, *--help*"
13148 #. type: Plain text
13149 #: ../misc-utils/findmnt.8.adoc:77
13151 "Search in _/proc/self/mountinfo_. The output is in the tree-like format. "
13152 "This is the default. The output contains only mount options maintained by "
13153 "kernel (see also *--mtab*)."
13156 #. type: Plain text
13157 #: ../misc-utils/findmnt.8.adoc:80
13159 "Use the list output format. This output format is automatically enabled if "
13160 "the output is restricted by the *-t*, *-O*, *-S* or *-T* option and the "
13161 "option *--submounts* is not used or if more that one source file (the option "
13162 "*-F*) is specified."
13165 #. type: Labeled list
13166 #: ../misc-utils/findmnt.8.adoc:81
13168 msgid "*-M*, *--mountpoint* _path_"
13171 #. type: Plain text
13172 #: ../misc-utils/findmnt.8.adoc:83
13174 "Explicitly define the mountpoint file or directory. See also *--target*."
13177 #. type: Labeled list
13178 #: ../misc-utils/findmnt.8.adoc:84
13180 #| msgid "*-P*, *--pty*"
13181 msgid "*-m*, *--mtab*"
13182 msgstr "*-P*, *--pty*"
13184 #. type: Plain text
13185 #: ../misc-utils/findmnt.8.adoc:86
13187 "Search in _/etc/mtab_. The output is in the list format by default (see *--"
13188 "tree*). The output may include user space mount options."
13191 #. type: Labeled list
13192 #: ../misc-utils/findmnt.8.adoc:87
13194 #| msgid "*-f*, *--fast*"
13195 msgid "*-N*, *--task* _tid_"
13196 msgstr "*-f*, *--fast*"
13198 #. type: Plain text
13199 #: ../misc-utils/findmnt.8.adoc:89
13201 "Use alternative namespace _/proc/<tid>/mountinfo_ rather than the default _/"
13202 "proc/self/mountinfo_. If the option is specified more than once, then tree-"
13203 "like output is disabled (see the *--list* option). See also the *unshare*(1) "
13207 #. type: Labeled list
13208 #: ../misc-utils/findmnt.8.adoc:93
13210 msgid "*-O*, *--options* _list_"
13213 #. TRANSLATORS: Keep {plus} untranslated.
13214 #. type: Plain text
13215 #: ../misc-utils/findmnt.8.adoc:95
13217 "Limit the set of printed filesystems. More than one option may be specified "
13218 "in a comma-separated list. The *-t* and *-O* options are cumulative in "
13219 "effect. It is different from *-t* in that each option is matched exactly; a "
13220 "leading _no_ at the beginning does not have global meaning. The \"no\" can "
13221 "used for individual items in the list. The \"no\" prefix interpretation can "
13222 "be disabled by \"{plus}\" prefix."
13225 #. type: Plain text
13226 #: ../misc-utils/findmnt.8.adoc:99
13228 "Define output columns. See the *--help* output to get a list of the "
13229 "currently supported columns. The *TARGET* column contains tree formatting if "
13230 "the *--list* or *--raw* options are not specified."
13233 #. TRANSLATORS: Keep {plus} untranslated.
13234 #. type: Plain text
13235 #: ../misc-utils/findmnt.8.adoc:101
13237 "The default list of columns may be extended if _list_ is specified in the "
13238 "format _{plus}list_ (e.g., *findmnt -o {plus}PROPAGATION*)."
13241 #. type: Plain text
13242 #: ../misc-utils/findmnt.8.adoc:105
13244 "Output almost all available columns. The columns that require *--poll* are "
13248 #. type: Plain text
13249 #: ../misc-utils/findmnt.8.adoc:108 ../sys-utils/lsipc.1.adoc:49
13251 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
13252 "value characters are hex-escaped (\\x<code>). See also option *--shell*."
13255 #. type: Plain text
13256 #: ../misc-utils/findmnt.8.adoc:110
13258 "Note that SOURCES column, use multi-line cells. In these cases, the column "
13259 "use an array-like formatting in the output, for example *name=(\"aaa\" "
13260 "\"bbb\" \"ccc\")*."
13263 #. type: Labeled list
13264 #: ../misc-utils/findmnt.8.adoc:111
13266 msgid "*-p*, *--poll*[_=list_]"
13269 #. type: Plain text
13270 #: ../misc-utils/findmnt.8.adoc:113
13272 "Monitor changes in the _/proc/self/mountinfo_ file. Supported actions are: "
13273 "mount, umount, remount and move. More than one action may be specified in a "
13274 "comma-separated list. All actions are monitored by default."
13277 #. type: Plain text
13278 #: ../misc-utils/findmnt.8.adoc:115
13280 "The time for which *--poll* will block can be restricted with the *--"
13281 "timeout* or *--first-only* options."
13284 #. type: Plain text
13285 #: ../misc-utils/findmnt.8.adoc:117
13287 "The standard columns always use the new version of the information from the "
13288 "mountinfo file, except the umount action which is based on the original "
13289 "information cached by *findmnt*. The poll mode allows using extra columns:"
13292 #. type: Labeled list
13293 #: ../misc-utils/findmnt.8.adoc:118
13298 #. type: Plain text
13299 #: ../misc-utils/findmnt.8.adoc:120
13301 "mount, umount, move or remount action name; this column is enabled by default"
13304 #. type: Labeled list
13305 #: ../misc-utils/findmnt.8.adoc:120
13307 msgid "*OLD-TARGET*"
13310 #. type: Plain text
13311 #: ../misc-utils/findmnt.8.adoc:122
13312 msgid "available for umount and move actions"
13315 #. type: Labeled list
13316 #: ../misc-utils/findmnt.8.adoc:122
13319 msgid "*OLD-OPTIONS*"
13322 #. type: Plain text
13323 #: ../misc-utils/findmnt.8.adoc:124
13324 msgid "available for umount and remount actions"
13327 #. type: Labeled list
13328 #: ../misc-utils/findmnt.8.adoc:125
13333 #. type: Plain text
13334 #: ../misc-utils/findmnt.8.adoc:127
13335 msgid "Print only pseudo filesystems."
13338 #. type: Labeled list
13339 #: ../misc-utils/findmnt.8.adoc:128
13344 #. type: Plain text
13345 #: ../misc-utils/findmnt.8.adoc:130 ../misc-utils/findmnt.8.adoc:159
13346 msgid "Print only filesystems over-mounted by another filesystem."
13349 #. type: Labeled list
13350 #: ../misc-utils/findmnt.8.adoc:131
13352 #| msgid "*-V*, *--version*"
13353 msgid "*-R*, *--submounts*"
13354 msgstr "*-V*, *--version*"
13356 #. type: Plain text
13357 #: ../misc-utils/findmnt.8.adoc:133
13359 "Print recursively all submounts for the selected filesystems. The "
13360 "restrictions defined by options *-t*, *-O*, *-S*, *-T* and *--direction* are "
13361 "not applied to submounts. All submounts are always printed in tree-like "
13362 "order. The option enables the tree-like output format by default. This "
13363 "option has no effect for *--mtab* or *--fstab*."
13366 #. type: Plain text
13367 #: ../misc-utils/findmnt.8.adoc:136
13369 "Use raw output format. All potentially unsafe characters are hex-escaped "
13373 #. type: Plain text
13374 #: ../misc-utils/findmnt.8.adoc:138
13376 "Note that column SOURCES, use multi-line cells. In these cases, the column "
13377 "may produce more strings on the same line."
13380 #. type: Labeled list
13381 #: ../misc-utils/findmnt.8.adoc:139
13386 #. type: Plain text
13387 #: ../misc-utils/findmnt.8.adoc:141
13388 msgid "Print only real filesystems."
13391 #. type: Labeled list
13392 #: ../misc-utils/findmnt.8.adoc:142
13394 #| msgid "*-s*, **--shell**=__shell__"
13395 msgid "*-S*, *--source* _spec_"
13396 msgstr "*-s*, **--shell**=__shell__"
13398 #. type: Plain text
13399 #: ../misc-utils/findmnt.8.adoc:144
13401 "Explicitly define the mount source. Supported specifications are _device_, "
13402 "__maj__**:**_min_, **LABEL=**__label__, **UUID=**__uuid__, "
13403 "**PARTLABEL=**__label__ and **PARTUUID=**__uuid__."
13406 #. type: Labeled list
13407 #: ../misc-utils/findmnt.8.adoc:145
13409 #| msgid "*-f*, *--fast*"
13410 msgid "*-s*, *--fstab*"
13411 msgstr "*-f*, *--fast*"
13413 #. type: Plain text
13414 #: ../misc-utils/findmnt.8.adoc:147
13416 "Search in _/etc/fstab_. The output is in the list format (see *--list*)."
13419 #. type: Labeled list
13420 #: ../misc-utils/findmnt.8.adoc:148
13422 msgid "*-T*, *--target* _path_"
13425 #. type: Plain text
13426 #: ../misc-utils/findmnt.8.adoc:150
13428 "Define the mount target. If _path_ is not a mountpoint file or directory, "
13429 "then *findmnt* checks the _path_ elements in reverse order to get the "
13430 "mountpoint (this feature is supported only when searching in kernel files "
13431 "and unsupported for *--fstab*). It's recommended to use the option *--"
13432 "mountpoint* when checks of _path_ elements are unwanted and _path_ is a "
13433 "strictly specified mountpoint."
13436 #. type: Labeled list
13437 #: ../misc-utils/findmnt.8.adoc:151 ../misc-utils/wipefs.8.adoc:75
13438 #: ../sys-utils/fstrim.8.adoc:56
13440 #| msgid "*-P*, *--pty*"
13441 msgid "*-t*, *--types* _list_"
13442 msgstr "*-P*, *--pty*"
13444 #. type: Plain text
13445 #: ../misc-utils/findmnt.8.adoc:153
13447 "Limit the set of printed filesystems. More than one type may be specified in "
13448 "a comma-separated list. The list of filesystem types can be prefixed with "
13449 "*no* to specify the filesystem types on which no action should be taken. For "
13450 "more details see *mount*(8)."
13453 #. type: Labeled list
13454 #: ../misc-utils/findmnt.8.adoc:154
13459 #. type: Plain text
13460 #: ../misc-utils/findmnt.8.adoc:156
13462 "Enable tree-like output if possible. The options is silently ignored for "
13463 "tables where is missing child-parent relation (e.g., _fstab_)."
13466 #. type: Labeled list
13467 #: ../misc-utils/findmnt.8.adoc:157
13469 msgid "*--shadowed*"
13472 #. type: Labeled list
13473 #: ../misc-utils/findmnt.8.adoc:160
13475 #| msgid "*-P*, *--pty*"
13476 msgid "*-U*, *--uniq*"
13477 msgstr "*-P*, *--pty*"
13479 #. type: Plain text
13480 #: ../misc-utils/findmnt.8.adoc:162
13482 "Ignore filesystems with duplicate mount targets, thus effectively skipping "
13483 "over-mounted mount points."
13486 #. type: Labeled list
13487 #: ../misc-utils/findmnt.8.adoc:163 ../misc-utils/lslocks.8.adoc:61
13488 #: ../sys-utils/lsns.8.adoc:64
13490 #| msgid "*-f*, *--fast*"
13491 msgid "*-u*, *--notruncate*"
13492 msgstr "*-f*, *--fast*"
13494 #. type: Plain text
13495 #: ../misc-utils/findmnt.8.adoc:165
13497 "Do not truncate text in columns. The default is to not truncate the "
13498 "*TARGET*, *SOURCE*, *UUID*, *LABEL*, *PARTUUID*, *PARTLABEL* columns. This "
13499 "option disables text truncation also in all other columns."
13502 #. type: Labeled list
13503 #: ../misc-utils/findmnt.8.adoc:166
13505 #| msgid "*-f*, *--fast*"
13506 msgid "*-v*, *--nofsroot*"
13507 msgstr "*-f*, *--fast*"
13509 #. type: Plain text
13510 #: ../misc-utils/findmnt.8.adoc:168
13512 "Do not print a [/dir] in the SOURCE column for bind mounts or btrfs "
13516 #. type: Labeled list
13517 #: ../misc-utils/findmnt.8.adoc:169
13519 msgid "*-w*, *--timeout* _milliseconds_"
13522 #. type: Plain text
13523 #: ../misc-utils/findmnt.8.adoc:171
13525 "Specify an upper limit on the time for which *--poll* will block, in "
13529 #. type: Labeled list
13530 #: ../misc-utils/findmnt.8.adoc:172
13532 #| msgid "*-V*, *--version*"
13533 msgid "*-x*, *--verify*"
13534 msgstr "*-V*, *--version*"
13536 #. type: Plain text
13537 #: ../misc-utils/findmnt.8.adoc:174
13539 "Check mount table content. The default is to verify _/etc/fstab_ parsability "
13540 "and usability. It's possible to use this option also with *--tab-file*. It's "
13541 "possible to specify source (device) or target (mountpoint) to filter mount "
13542 "table. The option *--verbose* forces *findmnt* to print more details."
13545 #. type: Plain text
13546 #: ../misc-utils/findmnt.8.adoc:177
13547 msgid "Force *findmnt* to print more information (*--verify* only for now)."
13550 #. type: Labeled list
13551 #: ../misc-utils/findmnt.8.adoc:178
13553 msgid "*--vfs-all*"
13556 #. type: Plain text
13557 #: ../misc-utils/findmnt.8.adoc:180
13559 "When used with *VFS-OPTIONS* column, print all VFS (fs-independent) flags. "
13560 "This option is designed for auditing purposes to list also default VFS "
13561 "kernel mount options which are normally not listed."
13564 #. type: Plain text
13565 #: ../misc-utils/findmnt.8.adoc:183
13567 "The column name will be modified to contain only characters allowed for "
13568 "shell variable identifiers. This is usable, for example, with *--pairs*. "
13569 "Note that this feature has been automatically enabled for *--pairs* in "
13570 "version 2.37, but due to compatibility issues, now it's necessary to request "
13571 "this behavior by *--shell*."
13574 #. type: Plain text
13575 #: ../misc-utils/findmnt.8.adoc:191
13577 "The exit value is 0 if there is something to display, or 1 on any error (for "
13578 "example if no filesystem is found based on the user's filter specification, "
13579 "or the device path or mountpoint does not exist)."
13582 #. type: Labeled list
13583 #: ../misc-utils/findmnt.8.adoc:194 ../sys-utils/mount.8.adoc:1632
13584 #: ../sys-utils/umount.8.adoc:152
13586 msgid "*LIBMOUNT_FSTAB*=<path>"
13589 #. type: Plain text
13590 #: ../misc-utils/findmnt.8.adoc:196
13591 msgid "overrides the default location of the _fstab_ file"
13594 #. type: Labeled list
13595 #: ../misc-utils/findmnt.8.adoc:197
13597 msgid "*LIBMOUNT_MTAB*=<path>"
13600 #. type: Plain text
13601 #: ../misc-utils/findmnt.8.adoc:199
13602 msgid "overrides the default location of the _mtab_ file"
13605 #. type: Labeled list
13606 #: ../misc-utils/findmnt.8.adoc:200 ../misc-utils/lsblk.8.adoc:158
13607 #: ../sys-utils/mount.8.adoc:1635 ../sys-utils/mountpoint.1.adoc:54
13608 #: ../sys-utils/swapon.8.adoc:125 ../sys-utils/umount.8.adoc:155
13610 msgid "*LIBMOUNT_DEBUG*=all"
13613 #. type: Plain text
13614 #: ../misc-utils/findmnt.8.adoc:202 ../sys-utils/mount.8.adoc:1637
13615 msgid "enables libmount debug output"
13618 #. type: Plain text
13619 #: ../misc-utils/findmnt.8.adoc:205
13620 msgid "enables libsmartcols debug output"
13623 #. type: Labeled list
13624 #: ../misc-utils/findmnt.8.adoc:211
13626 msgid "*findmnt --fstab -t nfs*"
13629 #. type: Plain text
13630 #: ../misc-utils/findmnt.8.adoc:213
13631 msgid "Prints all NFS filesystems defined in _/etc/fstab_."
13634 #. type: Labeled list
13635 #: ../misc-utils/findmnt.8.adoc:214
13637 msgid "*findmnt --fstab /mnt/foo*"
13640 #. type: Plain text
13641 #: ../misc-utils/findmnt.8.adoc:216
13643 "Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/"
13644 "foo_. It also prints bind mounts where _/mnt/foo_ is a source."
13647 #. type: Labeled list
13648 #: ../misc-utils/findmnt.8.adoc:217
13650 msgid "*findmnt --fstab --target /mnt/foo*"
13653 #. type: Plain text
13654 #: ../misc-utils/findmnt.8.adoc:219
13656 "Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/"
13660 #. type: Labeled list
13661 #: ../misc-utils/findmnt.8.adoc:220
13663 msgid "*findmnt --fstab --evaluate*"
13666 #. type: Plain text
13667 #: ../misc-utils/findmnt.8.adoc:222
13669 "Prints all _/etc/fstab_ filesystems and converts LABEL= and UUID= tags to "
13670 "the real device names."
13673 #. type: Labeled list
13674 #: ../misc-utils/findmnt.8.adoc:223
13676 msgid "*findmnt -n --raw --evaluate --output=target LABEL=/boot*"
13679 #. type: Plain text
13680 #: ../misc-utils/findmnt.8.adoc:225
13682 "Prints only the mountpoint where the filesystem with label \"/boot\" is "
13686 #. type: Labeled list
13687 #: ../misc-utils/findmnt.8.adoc:226
13689 msgid "*findmnt --poll --mountpoint /mnt/foo*"
13692 #. type: Plain text
13693 #: ../misc-utils/findmnt.8.adoc:228
13694 msgid "Monitors mount, unmount, remount and move on _/mnt/foo_."
13697 #. type: Labeled list
13698 #: ../misc-utils/findmnt.8.adoc:229
13700 msgid "*findmnt --poll=umount --first-only --mountpoint /mnt/foo*"
13703 #. type: Plain text
13704 #: ../misc-utils/findmnt.8.adoc:231
13705 msgid "Waits for _/mnt/foo_ unmount."
13708 #. type: Labeled list
13709 #: ../misc-utils/findmnt.8.adoc:232
13711 msgid "*findmnt --poll=remount -t ext3 -O ro*"
13714 #. type: Plain text
13715 #: ../misc-utils/findmnt.8.adoc:234
13716 msgid "Monitors remounts to read-only mode on all ext3 filesystems."
13719 #. type: Plain text
13720 #: ../misc-utils/findmnt.8.adoc:243
13728 #: ../misc-utils/getopt.1.adoc:2
13733 #. type: Plain text
13734 #: ../misc-utils/getopt.1.adoc:13
13735 msgid "getopt - parse command options (enhanced)"
13738 #. type: Plain text
13739 #: ../misc-utils/getopt.1.adoc:17
13741 msgid "*getopt* _optstring_ _parameters_\n"
13744 #. type: Plain text
13745 #: ../misc-utils/getopt.1.adoc:19
13747 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
13748 msgid "*getopt* [options] [*--*] _optstring_ _parameters_\n"
13749 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
13751 #. type: Plain text
13752 #: ../misc-utils/getopt.1.adoc:21
13754 msgid "*getopt* [options] *-o*|*--options* _optstring_ [options] [*--*] _parameters_\n"
13757 #. type: Plain text
13758 #: ../misc-utils/getopt.1.adoc:25
13760 msgid "*getopt* is used to break up (_parse_) options in command lines for easy parsing by shell procedures, and to check for valid options. It uses the GNU *getopt*(3) routines to do this.\n"
13763 #. type: Plain text
13764 #: ../misc-utils/getopt.1.adoc:27
13766 "The parameters *getopt* is called with can be divided into two parts: "
13767 "options which modify the way *getopt* will do the parsing (the _options_ and "
13768 "the _optstring_ in the *SYNOPSIS*), and the parameters which are to be "
13769 "parsed (_parameters_ in the *SYNOPSIS*). The second part will start at the "
13770 "first non-option parameter that is not an option argument, or after the "
13771 "first occurrence of '*--*'. If no '*-o*' or '*--options*' option is found in "
13772 "the first part, the first parameter of the second part is used as the short "
13776 #. type: Plain text
13777 #: ../misc-utils/getopt.1.adoc:29
13779 "If the environment variable *GETOPT_COMPATIBLE* is set, or if the first "
13780 "_parameter_ is not an option (does not start with a '*-*', the first format "
13781 "in the *SYNOPSIS*), *getopt* will generate output that is compatible with "
13782 "that of other versions of *getopt*(1). It will still do parameter shuffling "
13783 "and recognize optional arguments (see the *COMPATIBILITY* section for more "
13787 #. type: Plain text
13788 #: ../misc-utils/getopt.1.adoc:31
13790 "Traditional implementations of *getopt*(1) are unable to cope with "
13791 "whitespace and other (shell-specific) special characters in arguments and "
13792 "non-option parameters. To solve this problem, this implementation can "
13793 "generate quoted output which must once again be interpreted by the shell "
13794 "(usually by using the *eval* command). This has the effect of preserving "
13795 "those characters, but you must call *getopt* in a way that is no longer "
13796 "compatible with other versions (the second or third format in the "
13797 "*SYNOPSIS*). To determine whether this enhanced version of *getopt*(1) is "
13798 "installed, a special test option (*-T*) can be used."
13801 #. type: Labeled list
13802 #: ../misc-utils/getopt.1.adoc:34 ../misc-utils/look.1.adoc:59
13804 #| msgid "*-V*, *--version*"
13805 msgid "*-a*, *--alternative*"
13806 msgstr "*-V*, *--version*"
13808 #. type: Plain text
13809 #: ../misc-utils/getopt.1.adoc:36
13810 msgid "Allow long options to start with a single '*-*'."
13813 #. type: Labeled list
13814 #: ../misc-utils/getopt.1.adoc:37
13816 msgid "*-l*, *--longoptions* _longopts_"
13819 #. type: Plain text
13820 #: ../misc-utils/getopt.1.adoc:39
13822 "The long (multi-character) options to be recognized. More than one option "
13823 "name may be specified at once, by separating the names with commas. This "
13824 "option may be given more than once, the _longopts_ are cumulative. Each long "
13825 "option name in _longopts_ may be followed by one colon to indicate it has a "
13826 "required argument, and by two colons to indicate it has an optional argument."
13829 #. type: Labeled list
13830 #: ../misc-utils/getopt.1.adoc:40
13832 msgid "*-n*, *--name* _progname_"
13835 #. type: Plain text
13836 #: ../misc-utils/getopt.1.adoc:42
13838 "The name that will be used by the *getopt*(3) routines when it reports "
13839 "errors. Note that errors of *getopt*(1) are still reported as coming from "
13843 #. type: Labeled list
13844 #: ../misc-utils/getopt.1.adoc:43
13846 msgid "*-o*, *--options* _shortopts_"
13849 #. TRANSLATORS: Keep {plus} untranslated.
13850 #. type: Plain text
13851 #: ../misc-utils/getopt.1.adoc:45
13853 "The short (one-character) options to be recognized. If this option is not "
13854 "found, the first parameter of *getopt* that does not start with a '*-*' (and "
13855 "is not an option argument) is used as the short options string. Each short "
13856 "option character in _shortopts_ may be followed by one colon to indicate it "
13857 "has a required argument, and by two colons to indicate it has an optional "
13858 "argument. The first character of shortopts may be '*{plus}*' or '*-*' to "
13859 "influence the way options are parsed and output is generated (see the "
13860 "*SCANNING MODES* section for details)."
13863 #. type: Plain text
13864 #: ../misc-utils/getopt.1.adoc:49
13865 msgid "Disable error reporting by *getopt*(3)."
13868 #. type: Labeled list
13869 #: ../misc-utils/getopt.1.adoc:50
13871 #| msgid "*-P*, *--pty*"
13872 msgid "*-Q*, *--quiet-output*"
13873 msgstr "*-P*, *--pty*"
13875 #. type: Plain text
13876 #: ../misc-utils/getopt.1.adoc:52
13878 "Do not generate normal output. Errors are still reported by *getopt*(3), "
13879 "unless you also use *-q*."
13882 #. type: Plain text
13883 #: ../misc-utils/getopt.1.adoc:55
13885 "Set quoting conventions to those of _shell_. If the *-s* option is not "
13886 "given, the *BASH* conventions are used. Valid arguments are currently "
13887 "'*sh*', '*bash*', '*csh*', and '*tcsh*'."
13890 #. type: Labeled list
13891 #: ../misc-utils/getopt.1.adoc:56
13893 #| msgid "*-f*, *--fast*"
13894 msgid "*-T*, *--test*"
13895 msgstr "*-f*, *--fast*"
13897 #. type: Plain text
13898 #: ../misc-utils/getopt.1.adoc:58
13900 "Test if your *getopt*(1) is this enhanced version or an old version. This "
13901 "generates no output, and sets the error status to 4. Other implementations "
13902 "of *getopt*(1), and this version if the environment variable "
13903 "*GETOPT_COMPATIBLE* is set, will return '*--*' and error status 0."
13906 #. type: Labeled list
13907 #: ../misc-utils/getopt.1.adoc:59
13909 #| msgid "*-P*, *--pty*"
13910 msgid "*-u*, *--unquoted*"
13911 msgstr "*-P*, *--pty*"
13913 #. type: Plain text
13914 #: ../misc-utils/getopt.1.adoc:61
13916 "Do not quote the output. Note that whitespace and special (shell-dependent) "
13917 "characters can cause havoc in this mode (like they do with other *getopt*(1) "
13918 "implementations)."
13922 #: ../misc-utils/getopt.1.adoc:64
13927 #. type: Plain text
13928 #: ../misc-utils/getopt.1.adoc:67
13930 "This section specifies the format of the second part of the parameters of "
13931 "*getopt* (the _parameters_ in the *SYNOPSIS*). The next section (*OUTPUT*) "
13932 "describes the output that is generated. These parameters were typically the "
13933 "parameters a shell function was called with. Care must be taken that each "
13934 "parameter the shell function was called with corresponds to exactly one "
13935 "parameter in the parameter list of *getopt* (see the *EXAMPLES*). All "
13936 "parsing is done by the GNU *getopt*(3) routines."
13939 #. type: Plain text
13940 #: ../misc-utils/getopt.1.adoc:69
13942 "The parameters are parsed from left to right. Each parameter is classified "
13943 "as a short option, a long option, an argument to an option, or a non-option "
13947 #. type: Plain text
13948 #: ../misc-utils/getopt.1.adoc:71
13950 "A simple short option is a '*-*' followed by a short option character. If "
13951 "the option has a required argument, it may be written directly after the "
13952 "option character or as the next parameter (i.e., separated by whitespace on "
13953 "the command line). If the option has an optional argument, it must be "
13954 "written directly after the option character if present."
13957 #. type: Plain text
13958 #: ../misc-utils/getopt.1.adoc:73
13960 "It is possible to specify several short options after one '*-*', as long as "
13961 "all (except possibly the last) do not have required or optional arguments."
13964 #. type: Plain text
13965 #: ../misc-utils/getopt.1.adoc:75
13967 "A long option normally begins with '*--*' followed by the long option name. "
13968 "If the option has a required argument, it may be written directly after the "
13969 "long option name, separated by '*=*', or as the next argument (i.e., "
13970 "separated by whitespace on the command line). If the option has an optional "
13971 "argument, it must be written directly after the long option name, separated "
13972 "by '*=*', if present (if you add the '*=*' but nothing behind it, it is "
13973 "interpreted as if no argument was present; this is a slight bug, see the "
13974 "*BUGS*). Long options may be abbreviated, as long as the abbreviation is not "
13978 #. TRANSLATORS: Keep {plus} untranslated.
13979 #. type: Plain text
13980 #: ../misc-utils/getopt.1.adoc:77
13982 "Each parameter not starting with a '*-*', and not a required argument of a "
13983 "previous option, is a non-option parameter. Each parameter after a '*--*' "
13984 "parameter is always interpreted as a non-option parameter. If the "
13985 "environment variable *POSIXLY_CORRECT* is set, or if the short option string "
13986 "started with a '*{plus}*', all remaining parameters are interpreted as non-"
13987 "option parameters as soon as the first non-option parameter is found."
13991 #: ../misc-utils/getopt.1.adoc:79 ../misc-utils/lslocks.8.adoc:66
13992 #: ../misc-utils/uuidparse.1.adoc:23
13997 #. type: Plain text
13998 #: ../misc-utils/getopt.1.adoc:82
14000 "Output is generated for each element described in the previous section. "
14001 "Output is done in the same order as the elements are specified in the input, "
14002 "except for non-option parameters. Output can be done in _compatible_ "
14003 "(_unquoted_) mode, or in such way that whitespace and other special "
14004 "characters within arguments and non-option parameters are preserved (see "
14005 "*QUOTING*). When the output is processed in the shell script, it will seem "
14006 "to be composed of distinct elements that can be processed one by one (by "
14007 "using the shift command in most shell languages). This is imperfect in "
14008 "unquoted mode, as elements can be split at unexpected places if they contain "
14009 "whitespace or special characters."
14012 #. type: Plain text
14013 #: ../misc-utils/getopt.1.adoc:84
14015 "If there are problems parsing the parameters, for example because a required "
14016 "argument is not found or an option is not recognized, an error will be "
14017 "reported on stderr, there will be no output for the offending element, and a "
14018 "non-zero error status is returned."
14021 #. type: Plain text
14022 #: ../misc-utils/getopt.1.adoc:86
14024 "For a short option, a single '*-*' and the option character are generated as "
14025 "one parameter. If the option has an argument, the next parameter will be the "
14026 "argument. If the option takes an optional argument, but none was found, the "
14027 "next parameter will be generated but be empty in quoting mode, but no second "
14028 "parameter will be generated in unquoted (compatible) mode. Note that many "
14029 "other *getopt*(1) implementations do not support optional arguments."
14032 #. type: Plain text
14033 #: ../misc-utils/getopt.1.adoc:88
14035 "If several short options were specified after a single '*-*', each will be "
14036 "present in the output as a separate parameter."
14039 #. type: Plain text
14040 #: ../misc-utils/getopt.1.adoc:90
14042 "For a long option, '*--*' and the full option name are generated as one "
14043 "parameter. This is done regardless whether the option was abbreviated or "
14044 "specified with a single '*-*' in the input. Arguments are handled as with "
14048 #. TRANSLATORS: Keep {plus} untranslated.
14049 #. type: Plain text
14050 #: ../misc-utils/getopt.1.adoc:92
14052 "Normally, no non-option parameters output is generated until all options and "
14053 "their arguments have been generated. Then '*--*' is generated as a single "
14054 "parameter, and after it the non-option parameters in the order they were "
14055 "found, each as a separate parameter. Only if the first character of the "
14056 "short options string was a '*-*', non-option parameter output is generated "
14057 "at the place they are found in the input (this is not supported if the first "
14058 "format of the *SYNOPSIS* is used; in that case all preceding occurrences of "
14059 "'*-*' and '*{plus}*' are ignored)."
14063 #: ../misc-utils/getopt.1.adoc:94
14068 #. type: Plain text
14069 #: ../misc-utils/getopt.1.adoc:97
14071 "In compatibility mode, whitespace or 'special' characters in arguments or "
14072 "non-option parameters are not handled correctly. As the output is fed to the "
14073 "shell script, the script does not know how it is supposed to break the "
14074 "output into separate parameters. To circumvent this problem, this "
14075 "implementation offers quoting. The idea is that output is generated with "
14076 "quotes around each parameter. When this output is once again fed to the "
14077 "shell (usually by a shell *eval* command), it is split correctly into "
14078 "separate parameters."
14081 #. type: Plain text
14082 #: ../misc-utils/getopt.1.adoc:99
14084 "Quoting is not enabled if the environment variable *GETOPT_COMPATIBLE* is "
14085 "set, if the first form of the *SYNOPSIS* is used, or if the option '*-u*' is "
14089 #. type: Plain text
14090 #: ../misc-utils/getopt.1.adoc:101
14092 "Different shells use different quoting conventions. You can use the '*-s*' "
14093 "option to select the shell you are using. The following shells are currently "
14094 "supported: '*sh*', '*bash*', '*csh*' and '*tcsh*'. Actually, only two "
14095 "'flavors' are distinguished: sh-like quoting conventions and csh-like "
14096 "quoting conventions. Chances are that if you use another shell script "
14097 "language, one of these flavors can still be used."
14101 #: ../misc-utils/getopt.1.adoc:102
14103 msgid "SCANNING MODES"
14106 #. TRANSLATORS: Keep {plus} untranslated.
14107 #. type: Plain text
14108 #: ../misc-utils/getopt.1.adoc:105
14110 "The first character of the short options string may be a '*-*' or a '*{plus}"
14111 "*' to indicate a special scanning mode. If the first calling form in the "
14112 "*SYNOPSIS* is used they are ignored; the environment variable "
14113 "*POSIXLY_CORRECT* is still examined, though."
14116 #. TRANSLATORS: Keep {plus} untranslated.
14117 #. type: Plain text
14118 #: ../misc-utils/getopt.1.adoc:108
14120 "If the first character is '*{plus}*', or if the environment variable "
14121 "*POSIXLY_CORRECT* is set, parsing stops as soon as the first non-option "
14122 "parameter (i.e., a parameter that does not start with a '*-*') is found that "
14123 "is not an option argument. The remaining parameters are all interpreted as "
14124 "non-option parameters."
14127 #. type: Plain text
14128 #: ../misc-utils/getopt.1.adoc:111
14130 "If the first character is a '*-*', non-option parameters are outputted at "
14131 "the place where they are found; in normal operation, they are all collected "
14132 "at the end of output after a '*--*' parameter has been generated. Note that "
14133 "this '*--*' parameter is still generated, but it will always be the last "
14134 "parameter in this mode."
14137 #. type: Plain text
14138 #: ../misc-utils/getopt.1.adoc:115
14140 "This version of *getopt*(1) is written to be as compatible as possible to "
14141 "other versions. Usually you can just replace them with this version without "
14142 "any modifications, and with some advantages."
14145 #. TRANSLATORS: Keep {plus} untranslated.
14146 #. type: Plain text
14147 #: ../misc-utils/getopt.1.adoc:117
14149 "If the first character of the first parameter of getopt is not a '*-*', "
14150 "*getopt* goes into compatibility mode. It will interpret its first parameter "
14151 "as the string of short options, and all other arguments will be parsed. It "
14152 "will still do parameter shuffling (i.e., all non-option parameters are "
14153 "output at the end), unless the environment variable *POSIXLY_CORRECT* is "
14154 "set, in which case, *getopt* will prepend a '*{plus}*' before short options "
14158 #. type: Plain text
14159 #: ../misc-utils/getopt.1.adoc:120
14161 "The environment variable *GETOPT_COMPATIBLE* forces *getopt* into "
14162 "compatibility mode. Setting both this environment variable and "
14163 "*POSIXLY_CORRECT* offers 100% compatibility for 'difficult' programs. "
14164 "Usually, though, neither is needed."
14167 #. TRANSLATORS: Keep {plus} untranslated.
14168 #. type: Plain text
14169 #: ../misc-utils/getopt.1.adoc:122
14171 "In compatibility mode, leading '*-*' and '*{plus}*' characters in the short "
14172 "options string are ignored."
14176 #: ../misc-utils/getopt.1.adoc:124
14178 msgid "RETURN CODES"
14181 #. type: Plain text
14182 #: ../misc-utils/getopt.1.adoc:127
14184 msgid "*getopt* returns error code *0* for successful parsing, *1* if *getopt*(3) returns errors, *2* if it does not understand its own parameters, *3* if an internal error occurs like out-of-memory, and *4* if it is called with *-T*.\n"
14187 #. TRANSLATORS: Don't translate _{package-docdir}_.
14188 #. type: Plain text
14189 #: ../misc-utils/getopt.1.adoc:132
14191 "Example scripts for (ba)sh and (t)csh are provided with the *getopt*(1) "
14192 "distribution, and are installed in _{package-docdir}_ directory."
14195 #. type: Labeled list
14196 #: ../misc-utils/getopt.1.adoc:135 ../text-utils/more.1.adoc:183
14198 msgid "*POSIXLY_CORRECT*"
14201 #. type: Plain text
14202 #: ../misc-utils/getopt.1.adoc:137
14204 "This environment variable is examined by the *getopt*(3) routines. If it is "
14205 "set, parsing stops as soon as a parameter is found that is not an option or "
14206 "an option argument. All remaining parameters are also interpreted as non-"
14207 "option parameters, regardless whether they start with a '*-*'."
14210 #. type: Labeled list
14211 #: ../misc-utils/getopt.1.adoc:138
14213 msgid "*GETOPT_COMPATIBLE*"
14216 #. type: Plain text
14217 #: ../misc-utils/getopt.1.adoc:140
14219 "Forces *getopt* to use the first calling format as specified in the "
14223 #. type: Plain text
14224 #: ../misc-utils/getopt.1.adoc:144
14226 msgid "*getopt*(3) can parse long options with optional arguments that are given an empty optional argument (but cannot do this for short options). This *getopt*(1) treats optional arguments that are empty as if they were not present.\n"
14229 #. type: Plain text
14230 #: ../misc-utils/getopt.1.adoc:146
14232 "The syntax if you do not want any short option variables at all is not very "
14233 "intuitive (you have to set them explicitly to the empty string)."
14237 #: ../misc-utils/getopt.1.adoc:147 ../misc-utils/hardlink.1.adoc:144
14238 #: ../misc-utils/uuidd.8.adoc:84
14243 #. type: Plain text
14244 #: ../misc-utils/getopt.1.adoc:150
14245 msgid "mailto:frodo@frodo.looijaard.name[Frodo Looijaard]"
14248 #. type: Plain text
14249 #: ../misc-utils/getopt.1.adoc:156
14265 #. SPDX-License-Identifier: MIT
14266 #. Copyright (C) 2008 - 2012 Julian Andres Klode. See hardlink.c for license.
14267 #. Copyright (C) 2021 Karel Zak <kzak@redhat.com>
14269 #: ../misc-utils/hardlink.1.adoc:8
14271 msgid "hardlink(1)"
14274 #. type: Plain text
14275 #: ../misc-utils/hardlink.1.adoc:18
14276 msgid "hardlink - link multiple copies of a file"
14279 #. type: Plain text
14280 #: ../misc-utils/hardlink.1.adoc:22
14282 msgid "*hardlink* [options] [_directory_|_file_]...\n"
14285 #. type: Plain text
14286 #: ../misc-utils/hardlink.1.adoc:27
14289 "*hardlink* is a tool that replaces copies of a file with either hardlinks\n"
14290 "or copy-on-write clones, thus saving space.\n"
14293 #. type: Plain text
14294 #: ../misc-utils/hardlink.1.adoc:35
14297 "*hardlink* first creates a binary tree of file sizes and then compares\n"
14298 "the content of files that have the same size. There are two basic content\n"
14299 "comparison methods. The *memcmp* method directly reads data blocks from\n"
14300 "files and compares them. The other method is based on checksums (like SHA256);\n"
14301 "in this case for each data block a checksum is calculated by the Linux kernel\n"
14302 "crypto API, and this checksum is stored in userspace and used for file\n"
14306 #. type: Plain text
14307 #: ../misc-utils/hardlink.1.adoc:40
14309 "For each file also an \"intro\" buffer (32 bytes) is cached. This buffer is "
14310 "used independently from the comparison method and requested cache-size and "
14311 "io-size. The \"intro\" buffer dramatically reduces operations with data "
14312 "content as files are very often different from the beginning."
14315 #. type: Labeled list
14316 #: ../misc-utils/hardlink.1.adoc:45
14318 #| msgid "*-P*, *--pty*"
14319 msgid "*-c*, *--content*"
14320 msgstr "*-P*, *--pty*"
14322 #. type: Plain text
14323 #: ../misc-utils/hardlink.1.adoc:47
14325 "Consider only file content, not attributes, when determining whether two "
14326 "files are equal. Same as *-pot*."
14329 #. type: Labeled list
14330 #: ../misc-utils/hardlink.1.adoc:48
14332 msgid "*-b*, *--io-size* _size_"
14335 #. type: Plain text
14336 #: ../misc-utils/hardlink.1.adoc:56
14338 "The size of the *read*(2) or *sendfile*(2) buffer used when comparing file "
14339 "contents. The _size_ argument may be followed by the multiplicative "
14340 "suffixes KiB, MiB, etc. The \"iB\" is optional, e.g., \"K\" has the same "
14341 "meaning as \"KiB\". The default is 8KiB for memcmp method and 1MiB for the "
14342 "other methods. The only memcmp method uses process memory for the buffer, "
14343 "other methods use zero-copy way and I/O operation is done in the kernel. The "
14344 "size may be altered on the fly to fit a number of cached content checksums."
14347 #. type: Labeled list
14348 #: ../misc-utils/hardlink.1.adoc:57
14350 #| msgid "*-f*, *--fast*"
14351 msgid "*-d*, *--respect-dir*"
14352 msgstr "*-f*, *--fast*"
14354 #. type: Plain text
14355 #: ../misc-utils/hardlink.1.adoc:59
14357 "Only try to link files with the same directory name. The top-level directory "
14358 "(as specified on the hardlink command line) is ignored. For example, "
14359 "*hardlink --respect-dir /foo /bar* will link _/foo/some/file_ with _/bar/"
14360 "some/file_, but not _/bar/other/file_. If combined with *--respect-name*, "
14361 "then entire paths (except the top-level directory) are compared."
14364 #. type: Labeled list
14365 #: ../misc-utils/hardlink.1.adoc:60
14367 #| msgid "*-f*, *--fast*"
14368 msgid "*-f*, *--respect-name*"
14369 msgstr "*-f*, *--fast*"
14371 #. type: Plain text
14372 #: ../misc-utils/hardlink.1.adoc:62
14374 "Only try to link files with the same (base)name. It's strongly recommended "
14375 "to use long options rather than *-f* which is interpreted in a different way "
14376 "by other *hardlink* implementations."
14379 #. type: Labeled list
14380 #: ../misc-utils/hardlink.1.adoc:63
14382 msgid "*-i*, *--include* _regex_"
14385 #. type: Plain text
14386 #: ../misc-utils/hardlink.1.adoc:65
14388 "A regular expression to include files. If the option *--exclude* has been "
14389 "given, this option re-includes files which would otherwise be excluded. If "
14390 "the option is used without *--exclude*, only files matched by the pattern "
14394 #. type: Labeled list
14395 #: ../misc-utils/hardlink.1.adoc:66
14397 #| msgid "*-h*, *--help*"
14398 msgid "*-m*, *--maximize*"
14399 msgstr "*-h*, *--help*"
14401 #. type: Plain text
14402 #: ../misc-utils/hardlink.1.adoc:68
14403 msgid "Among equal files, keep the file with the highest link count."
14406 #. type: Labeled list
14407 #: ../misc-utils/hardlink.1.adoc:69
14409 #| msgid "*-V*, *--version*"
14410 msgid "*-M*, *--minimize*"
14411 msgstr "*-V*, *--version*"
14413 #. type: Plain text
14414 #: ../misc-utils/hardlink.1.adoc:71
14415 msgid "Among equal files, keep the file with the lowest link count."
14418 #. type: Labeled list
14419 #: ../misc-utils/hardlink.1.adoc:72 ../sys-utils/rtcwake.8.adoc:93
14421 #| msgid "*-P*, *--pty*"
14422 msgid "*-n*, *--dry-run*"
14423 msgstr "*-P*, *--pty*"
14425 #. type: Plain text
14426 #: ../misc-utils/hardlink.1.adoc:74
14427 msgid "Do not act, just print what would happen."
14430 #. type: Labeled list
14431 #: ../misc-utils/hardlink.1.adoc:75
14433 #| msgid "*-V*, *--version*"
14434 msgid "*-o*, *--ignore-owner*"
14435 msgstr "*-V*, *--version*"
14437 #. type: Plain text
14438 #: ../misc-utils/hardlink.1.adoc:77
14440 "Link and compare files even if their owner information (user and group) "
14441 "differs. Results may be unpredictable."
14444 #. type: Labeled list
14445 #: ../misc-utils/hardlink.1.adoc:78
14447 #| msgid "*-P*, *--pty*"
14448 msgid "*-O*, *--keep-oldest*"
14449 msgstr "*-P*, *--pty*"
14451 #. type: Plain text
14452 #: ../misc-utils/hardlink.1.adoc:80
14454 "Among equal files, keep the oldest file (least recent modification time). By "
14455 "default, the newest file is kept. If *--maximize* or *--minimize* is "
14456 "specified, the link count has a higher precedence than the time of "
14460 #. type: Labeled list
14461 #: ../misc-utils/hardlink.1.adoc:81
14463 msgid "*-p*, *--ignore-mode*"
14466 #. type: Plain text
14467 #: ../misc-utils/hardlink.1.adoc:83
14469 "Link and compare files even if their mode is different. Results may be "
14470 "slightly unpredictable."
14473 #. type: Plain text
14474 #: ../misc-utils/hardlink.1.adoc:86
14475 msgid "Quiet mode, don't print anything."
14478 #. type: Labeled list
14479 #: ../misc-utils/hardlink.1.adoc:87
14481 msgid "*-r*, *--cache-size* _size_"
14484 #. type: Plain text
14485 #: ../misc-utils/hardlink.1.adoc:92
14487 "The size of the cache for content checksums. All non-memcmp methods "
14488 "calculate checksum for each file content block (see *--io-size*), these "
14489 "checksums are cached for the next comparison. The size is important for "
14490 "large files or a large sets of files of the same size. The default is 10MiB."
14493 #. type: Labeled list
14494 #: ../misc-utils/hardlink.1.adoc:93
14496 msgid "*-s*, *--minimum-size* _size_"
14499 #. type: Plain text
14500 #: ../misc-utils/hardlink.1.adoc:95
14502 "The minimum size to consider. By default this is 1, so empty files will not "
14503 "be linked. The _size_ argument may be followed by the multiplicative "
14504 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
14505 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
14509 #. type: Labeled list
14510 #: ../misc-utils/hardlink.1.adoc:96
14512 msgid "*-S*, *--maximum-size* _size_"
14515 #. type: Plain text
14516 #: ../misc-utils/hardlink.1.adoc:98
14518 "The maximum size to consider. By default this is 0 and 0 has the special "
14519 "meaning of unlimited. The _size_ argument may be followed by the "
14520 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
14521 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
14522 "meaning as \"KiB\")."
14525 #. type: Labeled list
14526 #: ../misc-utils/hardlink.1.adoc:99
14528 msgid "*-t*, *--ignore-time*"
14531 #. type: Plain text
14532 #: ../misc-utils/hardlink.1.adoc:101
14534 "Link and compare files even if their time of modification is different. This "
14535 "is usually a good choice."
14538 #. type: Plain text
14539 #: ../misc-utils/hardlink.1.adoc:104
14541 "Verbose output, explain to the user what is being done. If specified once, "
14542 "every hardlinked file is displayed. If specified twice, it also shows every "
14546 #. type: Labeled list
14547 #: ../misc-utils/hardlink.1.adoc:105
14549 msgid "*-x*, *--exclude* _regex_"
14552 #. type: Plain text
14553 #: ../misc-utils/hardlink.1.adoc:107
14555 "A regular expression which excludes files from being compared and linked."
14558 #. type: Labeled list
14559 #: ../misc-utils/hardlink.1.adoc:108
14561 msgid "*-X*, *--respect-xattrs*"
14564 #. type: Plain text
14565 #: ../misc-utils/hardlink.1.adoc:110
14566 msgid "Only try to link files with the same extended attributes."
14569 #. type: Labeled list
14570 #: ../misc-utils/hardlink.1.adoc:111
14572 msgid "*-y*, *--method* _name_"
14575 #. type: Plain text
14576 #: ../misc-utils/hardlink.1.adoc:117
14578 "Set the file content comparison method. The currently supported methods are "
14579 "sha256, sha1, crc32c and memcmp. The default is sha256, or memcmp if Linux "
14580 "Crypto API is not available. The methods based on checksums are implemented "
14581 "in zero-copy way, in this case file contents are not copied to the userspace "
14582 "and all calculation is done in kernel."
14585 #. type: Labeled list
14586 #: ../misc-utils/hardlink.1.adoc:118
14588 msgid "*--reflink*[=_when_]"
14591 #. type: Plain text
14592 #: ../misc-utils/hardlink.1.adoc:123
14594 "Create copy-on-write clones (aka reflinks) rather than hardlinks. The "
14595 "reflinked files share only on-disk data, but the file mode and owner can be "
14596 "different. It's recommended to use it with *--ignore-owner* and *--ignore-"
14597 "mode* options. This option implies *--skip-reflinks* to ignore already "
14601 #. type: Plain text
14602 #: ../misc-utils/hardlink.1.adoc:129
14604 "The optional argument _when_ can be *never*, *always*, or *auto*. If the "
14605 "_when_ argument is omitted, it defaults to *auto*, in this case, *hardlink* "
14606 "checks filesystem type and uses reflinks on BTRFS and XFS only, and fallback "
14607 "to hardlinks when creating reflink is impossible. The argument *always* "
14608 "disables filesystem type detection and fallback to hardlinks, in this case, "
14609 "only reflinks are allowed."
14612 #. type: Labeled list
14613 #: ../misc-utils/hardlink.1.adoc:130
14615 msgid "*--skip-reflinks*"
14618 #. type: Plain text
14619 #: ../misc-utils/hardlink.1.adoc:132
14621 "Ignore already cloned files. This option may be used without *--reflink* "
14622 "when creating classic hardlinks."
14625 #. type: Plain text
14626 #: ../misc-utils/hardlink.1.adoc:137
14628 msgid "*hardlink* takes one or more directories which will be searched for files to be linked.\n"
14631 #. type: Plain text
14632 #: ../misc-utils/hardlink.1.adoc:141
14634 "The original *hardlink* implementation uses the option *-f* to force "
14635 "hardlinks creation between filesystem. This very rarely usable feature is no "
14636 "more supported by the current *hardlink*."
14639 #. type: Plain text
14640 #: ../misc-utils/hardlink.1.adoc:143
14642 msgid "*hardlink* assumes that the trees it operates on do not change during operation. If a tree does change, the result is undefined and potentially dangerous. For example, if a regular file is replaced by a device, *hardlink* may start reading from the device. If a component of a path is replaced by a symbolic link or file permissions change, security may be compromised. Do not run *hardlink* on a changing tree or on a tree controlled by another user.\n"
14645 #. type: Plain text
14646 #: ../misc-utils/hardlink.1.adoc:147
14648 "There are multiple *hardlink* implementations. The very first implementation "
14649 "is from Jakub Jelinek for Fedora distribution, this implementation has been "
14650 "used in util-linux between versions v2.34 to v2.36. The current "
14651 "implementations is based on Debian version from Julian Andres Klode."
14654 #. Copyright 1994 Salvatore Valente (svalente@mit.edu)
14655 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
14656 #. May be distributed under the GNU General Public License
14658 #: ../misc-utils/kill.1.adoc:7
14663 #. type: Plain text
14664 #: ../misc-utils/kill.1.adoc:17
14665 msgid "kill - terminate a process"
14668 #. type: Plain text
14669 #: ../misc-utils/kill.1.adoc:21
14671 msgid "*kill* [**-**_signal_|*-s* _signal_|*-p*] [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _pid_|_name_...\n"
14674 #. type: Plain text
14675 #: ../misc-utils/kill.1.adoc:23
14677 msgid "*kill* *-l* [_number_] | *-L*\n"
14680 #. type: Plain text
14681 #: ../misc-utils/kill.1.adoc:28
14683 "The command *kill* sends the specified _signal_ to the specified processes "
14684 "or process groups."
14687 #. type: Plain text
14688 #: ../misc-utils/kill.1.adoc:30
14690 "If no signal is specified, the *TERM* signal is sent. The default action for "
14691 "this signal is to terminate the process. This signal should be used in "
14692 "preference to the *KILL* signal (number 9), since a process may install a "
14693 "handler for the TERM signal in order to perform clean-up steps before "
14694 "terminating in an orderly fashion. If a process does not terminate after a "
14695 "*TERM* signal has been sent, then the *KILL* signal may be used; be aware "
14696 "that the latter signal cannot be caught, and so does not give the target "
14697 "process the opportunity to perform any clean-up before terminating."
14700 #. type: Plain text
14701 #: ../misc-utils/kill.1.adoc:32
14703 "Most modern shells have a builtin *kill* command, with a usage rather "
14704 "similar to that of the command described here. The *--all*, *--pid*, and *--"
14705 "queue* options, and the possibility to specify processes by command name, "
14706 "are local extensions."
14709 #. type: Plain text
14710 #: ../misc-utils/kill.1.adoc:34
14712 "If _signal_ is 0, then no actual signal is sent, but error checking is still "
14716 #. type: Plain text
14717 #: ../misc-utils/kill.1.adoc:38
14719 "The list of processes to be signaled can be a mixture of names and PIDs."
14722 #. type: Labeled list
14723 #: ../misc-utils/kill.1.adoc:39
14728 #. type: Plain text
14729 #: ../misc-utils/kill.1.adoc:41
14730 msgid "Each _pid_ can be expressed in one of the following ways:"
14733 #. type: Labeled list
14734 #: ../misc-utils/kill.1.adoc:41
14739 #. type: Plain text
14740 #: ../misc-utils/kill.1.adoc:43
14741 msgid "where _n_ is larger than 0. The process with PID _n_ is signaled."
14744 #. type: Plain text
14745 #: ../misc-utils/kill.1.adoc:45
14746 msgid "All processes in the current process group are signaled."
14749 #. type: Plain text
14750 #: ../misc-utils/kill.1.adoc:47
14751 msgid "All processes with a PID larger than 1 are signaled."
14754 #. type: Labeled list
14755 #: ../misc-utils/kill.1.adoc:47
14760 #. type: Plain text
14761 #: ../misc-utils/kill.1.adoc:49
14763 "where _n_ is larger than 1. All processes in process group _n_ are signaled. "
14764 "When an argument of the form '-n' is given, and it is meant to denote a "
14765 "process group, either a signal must be specified first, or the argument must "
14766 "be preceded by a '--' option, otherwise it will be taken as the signal to "
14770 #. type: Labeled list
14771 #: ../misc-utils/kill.1.adoc:50
14776 #. type: Plain text
14777 #: ../misc-utils/kill.1.adoc:52
14778 msgid "All processes invoked using this _name_ will be signaled."
14781 #. type: Labeled list
14782 #: ../misc-utils/kill.1.adoc:55
14784 #| msgid "*-s*, **--shell**=__shell__"
14785 msgid "*-s*, *--signal* _signal_"
14786 msgstr "*-s*, **--shell**=__shell__"
14788 #. type: Plain text
14789 #: ../misc-utils/kill.1.adoc:57
14790 msgid "The signal to send. It may be given as a name or a number."
14793 #. type: Labeled list
14794 #: ../misc-utils/kill.1.adoc:57
14796 msgid "*-l*, *--list* [_number_]"
14799 #. type: Plain text
14800 #: ../misc-utils/kill.1.adoc:59
14802 "Print a list of signal names, or convert the given signal number to a name. "
14803 "The signals can be found in _/usr/include/linux/signal.h_."
14806 #. type: Labeled list
14807 #: ../misc-utils/kill.1.adoc:59
14809 #| msgid "*-P*, *--pty*"
14810 msgid "*-L*, *--table*"
14811 msgstr "*-P*, *--pty*"
14813 #. type: Plain text
14814 #: ../misc-utils/kill.1.adoc:61
14816 "Similar to *-l*, but it will print signal names and their corresponding "
14820 #. type: Plain text
14821 #: ../misc-utils/kill.1.adoc:63
14823 "Do not restrict the command-name-to-PID conversion to processes with the "
14824 "same UID as the present process."
14827 #. type: Labeled list
14828 #: ../misc-utils/kill.1.adoc:63 ../schedutils/chrt.1.adoc:98
14829 #: ../schedutils/taskset.1.adoc:77 ../schedutils/uclampset.1.adoc:78
14830 #: ../sys-utils/ipcs.1.adoc:56 ../sys-utils/prlimit.1.adoc:49
14831 #: ../sys-utils/renice.1.adoc:71
14833 #| msgid "*-P*, *--pty*"
14834 msgid "*-p*, *--pid*"
14835 msgstr "*-P*, *--pty*"
14837 #. type: Plain text
14838 #: ../misc-utils/kill.1.adoc:65
14840 "Only print the process ID (PID) of the named processes, do not send any "
14844 #. type: Labeled list
14845 #: ../misc-utils/kill.1.adoc:65
14847 #| msgid "*-h*, *--help*"
14848 msgid "*-r*, *--require-handler*"
14849 msgstr "*-h*, *--help*"
14851 #. type: Plain text
14852 #: ../misc-utils/kill.1.adoc:67
14854 "Do not send the signal if it is not caught in userspace by the signalled "
14858 #. type: Plain text
14859 #: ../misc-utils/kill.1.adoc:69
14860 msgid "Print PID(s) that will be signaled with *kill* along with the signal."
14863 #. type: Labeled list
14864 #: ../misc-utils/kill.1.adoc:69
14866 msgid "*-q*, *--queue* _value_"
14869 #. type: Plain text
14870 #: ../misc-utils/kill.1.adoc:71
14872 "Send the signal using *sigqueue*(3) rather than *kill*(2). The _value_ "
14873 "argument is an integer that is sent along with the signal. If the receiving "
14874 "process has installed a handler for this signal using the *SA_SIGINFO* flag "
14875 "to *sigaction*(2), then it can obtain this data via the _si_sigval_ field of "
14876 "the _siginfo_t_ structure."
14879 #. type: Labeled list
14880 #: ../misc-utils/kill.1.adoc:71
14882 msgid "*--timeout* _milliseconds signal_"
14885 #. type: Plain text
14886 #: ../misc-utils/kill.1.adoc:73
14888 "Send a signal defined in the usual way to a process, followed by an "
14889 "additional signal after a specified delay. The *--timeout* option causes "
14890 "*kill* to wait for a period defined in _milliseconds_ before sending a "
14891 "follow-up _signal_ to the process. This feature is implemented using the "
14892 "Linux kernel PID file descriptor feature in order to guarantee that the "
14893 "follow-up signal is sent to the same process or not sent if the process no "
14897 #. type: Plain text
14898 #: ../misc-utils/kill.1.adoc:75
14900 "Note that the operating system may re-use PIDs and implementing an "
14901 "equivalent feature in a shell using *kill* and *sleep* would be subject to "
14902 "races whereby the follow-up signal might be sent to a different process that "
14903 "used a recycled PID."
14906 #. type: Plain text
14907 #: ../misc-utils/kill.1.adoc:77
14909 "The *--timeout* option can be specified multiple times: the signals are sent "
14910 "sequentially with the specified timeouts. The *--timeout* option can be "
14911 "combined with the *--queue* option."
14914 #. type: Plain text
14915 #: ../misc-utils/kill.1.adoc:79
14917 "As an example, the following command sends the signals *QUIT*, *TERM* and "
14918 "*KILL* in sequence and waits for 1000 milliseconds between sending the "
14922 #. type: delimited block .
14923 #: ../misc-utils/kill.1.adoc:83
14926 "kill --verbose --timeout 1000 TERM --timeout 1000 KILL \\\n"
14927 " --signal QUIT 12345\n"
14930 #. type: Plain text
14931 #: ../misc-utils/kill.1.adoc:88
14933 msgid "*kill* has the following exit status values:\n"
14936 #. type: Plain text
14937 #: ../misc-utils/kill.1.adoc:93 ../misc-utils/lsblk.8.adoc:143
14938 #: ../sys-utils/chcpu.8.adoc:64 ../sys-utils/chmem.8.adoc:63
14939 #: ../sys-utils/fstrim.8.adoc:80
14943 #. type: Plain text
14944 #: ../misc-utils/kill.1.adoc:95
14945 msgid "partial success (when more than one process specified)"
14948 #. type: Plain text
14949 #: ../misc-utils/kill.1.adoc:99
14951 "Although it is possible to specify the TID (thread ID, see *gettid*(2)) of "
14952 "one of the threads in a multithreaded process as the argument of *kill*, the "
14953 "signal is nevertheless directed to the process (i.e., the entire thread "
14954 "group). In other words, it is not possible to send a signal to an explicitly "
14955 "selected thread in a multithreaded process. The signal will be delivered to "
14956 "an arbitrarily selected thread in the target process that is not blocking "
14957 "the signal. For more details, see *signal*(7) and the description of "
14958 "*CLONE_THREAD* in *clone*(2)."
14961 #. type: Plain text
14962 #: ../misc-utils/kill.1.adoc:101
14964 "Various shells provide a builtin *kill* command that is preferred in "
14965 "relation to the *kill*(1) executable described by this manual. The easiest "
14966 "way to ensure one is executing the command described in this page is to use "
14967 "the full path when calling the command, for example: */bin/kill --version*"
14970 #. type: Plain text
14971 #: ../misc-utils/kill.1.adoc:106
14973 "mailto:svalente@mit.edu[Salvatore Valente], mailto:kzak@redhat.com[Karel Zak]"
14976 #. type: Plain text
14977 #: ../misc-utils/kill.1.adoc:108
14978 msgid "The original version was taken from BSD 4.4."
14981 #. type: Plain text
14982 #: ../misc-utils/kill.1.adoc:117
14987 "*sigaction*(2),\n"
14996 #. Copyright (c) 1983, 1990, 1993
14997 #. The Regents of the University of California. All rights reserved.
14998 #. Redistribution and use in source and binary forms, with or without
14999 #. modification, are permitted provided that the following conditions
15001 #. 1. Redistributions of source code must retain the above copyright
15002 #. notice, this list of conditions and the following disclaimer.
15003 #. 2. Redistributions in binary form must reproduce the above copyright
15004 #. notice, this list of conditions and the following disclaimer in the
15005 #. documentation and/or other materials provided with the distribution.
15006 #. 3. All advertising materials mentioning features or use of this software
15007 #. must display the following acknowledgement:
15008 #. This product includes software developed by the University of
15009 #. California, Berkeley and its contributors.
15010 #. 4. Neither the name of the University nor the names of its contributors
15011 #. may be used to endorse or promote products derived from this software
15012 #. without specific prior written permission.
15013 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
15014 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15015 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15016 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
15017 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
15018 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
15019 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
15020 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
15021 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
15022 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
15024 #. @(#)logger.1 8.1 (Berkeley) 6/6/93
15026 #: ../misc-utils/logger.1.adoc:36
15031 #. type: Plain text
15032 #: ../misc-utils/logger.1.adoc:46
15033 msgid "logger - enter messages into the system log"
15036 #. type: Plain text
15037 #: ../misc-utils/logger.1.adoc:50
15039 msgid "*logger* [options] _message_\n"
15042 #. type: Plain text
15043 #: ../misc-utils/logger.1.adoc:54
15045 msgid "*logger* makes entries in the system log.\n"
15048 #. type: Plain text
15049 #: ../misc-utils/logger.1.adoc:56
15051 "When the optional _message_ argument is present, it is written to the log. "
15052 "If it is not present, and the *-f* option is not given either, then standard "
15056 #. type: Labeled list
15057 #: ../misc-utils/logger.1.adoc:59
15059 #| msgid "*-P*, *--pty*"
15060 msgid "*-d*, *--udp*"
15061 msgstr "*-P*, *--pty*"
15063 #. type: Plain text
15064 #: ../misc-utils/logger.1.adoc:61
15066 "Use datagrams (UDP) only. By default the connection is tried to the syslog "
15067 "port defined in _/etc/services_, which is often 514."
15070 #. type: Plain text
15071 #: ../misc-utils/logger.1.adoc:63 ../misc-utils/logger.1.adoc:174
15072 msgid "See also *--server* and *--socket* to specify where to connect."
15075 #. type: Labeled list
15076 #: ../misc-utils/logger.1.adoc:64
15078 #| msgid "*-P*, *--pty*"
15079 msgid "*-e*, *--skip-empty*"
15080 msgstr "*-P*, *--pty*"
15082 #. type: Plain text
15083 #: ../misc-utils/logger.1.adoc:66
15085 "Ignore empty lines when processing files. An empty line is defined to be a "
15086 "line without any characters. Thus a line consisting only of whitespace is "
15087 "NOT considered empty. Note that when the *--prio-prefix* option is "
15088 "specified, the priority is not part of the line. Thus an empty line in this "
15089 "mode is a line that does not have any characters after the priority prefix "
15093 #. type: Plain text
15094 #: ../misc-utils/logger.1.adoc:69
15096 "Log the contents of the specified _file_. This option cannot be combined "
15097 "with a command-line message."
15100 #. type: Labeled list
15101 #: ../misc-utils/logger.1.adoc:70
15106 #. type: Plain text
15107 #: ../misc-utils/logger.1.adoc:72
15108 msgid "Log the PID of the *logger* process with each line."
15111 #. type: Labeled list
15112 #: ../misc-utils/logger.1.adoc:73
15114 msgid "*--id*[**=**__id__]"
15117 #. type: Plain text
15118 #: ../misc-utils/logger.1.adoc:75
15120 "Log the PID of the *logger* process with each line. When the optional "
15121 "argument _id_ is specified, then it is used instead of the *logger* "
15122 "command's PID. The use of *--id=$$* (PPID) is recommended in scripts that "
15123 "send several messages."
15126 #. type: Plain text
15127 #: ../misc-utils/logger.1.adoc:77
15129 "Note that the system logging infrastructure (for example *systemd* when "
15130 "listening on _/dev/log_) may follow local socket credentials to overwrite "
15131 "the PID specified in the message. *logger*(1) is able to set those socket "
15132 "credentials to the given _id_, but only if you have root permissions and a "
15133 "process with the specified PID exists, otherwise the socket credentials are "
15134 "not modified and the problem is silently ignored."
15137 #. type: Labeled list
15138 #: ../misc-utils/logger.1.adoc:78
15140 msgid "*--journald*[**=**__file__]"
15143 #. type: Plain text
15144 #: ../misc-utils/logger.1.adoc:80
15146 "Write a *systemd* journal entry. The entry is read from the given _file_, "
15147 "when specified, otherwise from standard input. Each line must begin with a "
15148 "field that is accepted by *journald*; see *systemd.journal-fields*(7) for "
15149 "details. The use of a MESSAGE_ID field is generally a good idea, as it makes "
15150 "finding entries easy. Examples:"
15153 #. type: delimited block _
15154 #: ../misc-utils/logger.1.adoc:88
15157 " logger --journald <<end\n"
15158 " MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309\n"
15159 " MESSAGE=The dogs bark, but the caravan goes on.\n"
15161 " CARAVAN=goes on\n"
15165 #. type: delimited block _
15166 #: ../misc-utils/logger.1.adoc:90
15168 msgid " logger --journald=entry.txt\n"
15171 #. type: Plain text
15172 #: ../misc-utils/logger.1.adoc:93
15174 "Notice that *--journald* will ignore values of other options, such as "
15175 "priority. If priority is needed it must be within input, and use PRIORITY "
15176 "field. The simple execution of *journalctl*(1) will display MESSAGE field. "
15177 "Use *journalctl --output json-pretty* to see rest of the fields."
15180 #. type: Plain text
15181 #: ../misc-utils/logger.1.adoc:95
15183 "To include newlines in MESSAGE, specify MESSAGE several times. This is "
15184 "handled as a special case, other fields will be stored as an array in the "
15185 "journal if they appear multiple times."
15188 #. type: Labeled list
15189 #: ../misc-utils/logger.1.adoc:96
15191 msgid "*--msgid* _msgid_"
15194 #. type: Plain text
15195 #: ../misc-utils/logger.1.adoc:98
15197 "Sets the link:https://tools.ietf.org/html/rfc5424[RFC 5424] MSGID field. "
15198 "Note that the space character is not permitted inside of _msgid_. This "
15199 "option is only used if *--rfc5424* is specified as well; otherwise, it is "
15200 "silently ignored."
15203 #. type: Labeled list
15204 #: ../misc-utils/logger.1.adoc:99
15206 msgid "*-n*, *--server* _server_"
15209 #. type: Plain text
15210 #: ../misc-utils/logger.1.adoc:101
15212 "Write to the specified remote syslog _server_ instead of to the system log "
15213 "socket. Unless *--udp* or *--tcp* is specified, *logger* will first try to "
15214 "use UDP, but if this fails a TCP connection is attempted."
15217 #. type: Labeled list
15218 #: ../misc-utils/logger.1.adoc:102
15223 #. type: Plain text
15224 #: ../misc-utils/logger.1.adoc:104
15226 "Causes everything to be done except for writing the log message to the "
15227 "system log, and removing the connection to the journal. This option can be "
15228 "used together with *--stderr* for testing purposes."
15231 #. type: Labeled list
15232 #: ../misc-utils/logger.1.adoc:105
15234 msgid "*--octet-count*"
15237 #. type: Plain text
15238 #: ../misc-utils/logger.1.adoc:107
15240 "Use the link:https://tools.ietf.org/html/rfc6587[RFC 6587] octet counting "
15241 "framing method for sending messages. When this option is not used, the "
15242 "default is no framing on UDP, and RFC6587 non-transparent framing (also "
15243 "known as octet stuffing) on TCP."
15246 #. type: Labeled list
15247 #: ../misc-utils/logger.1.adoc:108
15249 #| msgid "*-P*, *--pty*"
15250 msgid "*-P*, *--port* _port_"
15251 msgstr "*-P*, *--pty*"
15253 #. type: Plain text
15254 #: ../misc-utils/logger.1.adoc:110
15256 "Use the specified _port_. When this option is not specified, the port "
15257 "defaults to *syslog* for udp and to *syslog-conn* for tcp connections."
15260 #. type: Labeled list
15261 #: ../misc-utils/logger.1.adoc:111 ../sys-utils/swapon.8.adoc:65
15263 msgid "*-p*, *--priority* _priority_"
15266 #. type: Plain text
15267 #: ../misc-utils/logger.1.adoc:113
15269 "Enter the message into the log with the specified _priority_. The priority "
15270 "may be specified numerically or as a _facility_._level_ pair. For example, *-"
15271 "p local3.info* logs the message as informational in the local3 facility. The "
15272 "default is *user.notice*."
15275 #. type: Labeled list
15276 #: ../misc-utils/logger.1.adoc:114
15278 msgid "*--prio-prefix*"
15281 #. type: Plain text
15282 #: ../misc-utils/logger.1.adoc:116
15284 "Look for a syslog prefix on every line read from standard input. This prefix "
15285 "is a decimal number within angle brackets that encodes both the facility and "
15286 "the level. The number is constructed by multiplying the facility by 8 and "
15287 "then adding the level. For example, *local0.info*, meaning facility=16 and "
15288 "level=6, becomes *<134>*."
15291 #. type: Plain text
15292 #: ../misc-utils/logger.1.adoc:118
15294 "If the prefix contains no facility, the facility defaults to what is "
15295 "specified by the *-p* option. Similarly, if no prefix is provided, the line "
15296 "is logged using the _priority_ given with *-p*."
15299 #. type: Plain text
15300 #: ../misc-utils/logger.1.adoc:120
15301 msgid "This option doesn't affect a command-line message."
15304 #. type: Labeled list
15305 #: ../misc-utils/logger.1.adoc:121
15307 msgid "*--rfc3164*"
15310 #. type: Plain text
15311 #: ../misc-utils/logger.1.adoc:123
15313 "Use the link:https://tools.ietf.org/html/rfc3164[RFC 3164] BSD syslog "
15314 "protocol to submit messages to a remote server."
15317 #. type: Labeled list
15318 #: ../misc-utils/logger.1.adoc:124
15320 msgid "*--rfc5424*[**=**__without__]"
15323 #. type: Plain text
15324 #: ../misc-utils/logger.1.adoc:126
15326 "Use the link:https://tools.ietf.org/html/rfc5424[RFC 5424] syslog protocol "
15327 "to submit messages to a remote server. The optional _without_ argument can "
15328 "be a comma-separated list of the following values: *notq*, *notime*, "
15332 #. type: Plain text
15333 #: ../misc-utils/logger.1.adoc:128
15335 "The *notq* value suppresses the time-quality structured data from the "
15336 "submitted message. The time-quality information shows whether the local "
15337 "clock was synchronized plus the maximum number of microseconds the timestamp "
15338 "might be off. The time quality is also automatically suppressed when *--sd-"
15339 "id timeQuality* is specified."
15342 #. type: Plain text
15343 #: ../misc-utils/logger.1.adoc:130
15345 "The *notime* value (which implies *notq*) suppresses the complete sender "
15346 "timestamp that is in ISO-8601 format, including microseconds and timezone."
15349 #. type: Plain text
15350 #: ../misc-utils/logger.1.adoc:132
15352 "The *nohost* value suppresses *gethostname*(2) information from the message "
15356 #. type: Plain text
15357 #: ../misc-utils/logger.1.adoc:134
15359 "The RFC 5424 protocol has been the default for *logger* since version 2.26."
15362 #. type: Labeled list
15363 #: ../misc-utils/logger.1.adoc:135
15365 #| msgid "*-f*, *--fast*"
15366 msgid "*-s*, *--stderr*"
15367 msgstr "*-f*, *--fast*"
15369 #. type: Plain text
15370 #: ../misc-utils/logger.1.adoc:137
15371 msgid "Output the message to standard error as well as to the system log."
15374 #. type: Labeled list
15375 #: ../misc-utils/logger.1.adoc:138
15377 msgid "*--sd-id* _name_[**@**__digits__]"
15380 #. type: Plain text
15381 #: ../misc-utils/logger.1.adoc:140
15383 "Specifies a structured data element ID for an RFC 5424 message header. The "
15384 "option has to be used before *--sd-param* to introduce a new element. The "
15385 "number of structured data elements is unlimited. The ID (_name_ plus "
15386 "possibly **@**__digits__) is case-sensitive and uniquely identifies the type "
15387 "and purpose of the element. The same ID must not exist more than once in a "
15388 "message. The **@**__digits__ part is required for user-defined non-"
15389 "standardized IDs."
15392 #. type: Plain text
15393 #: ../misc-utils/logger.1.adoc:142
15395 msgid "*logger* currently generates the *timeQuality* standardized element only. RFC 5424 also describes the elements *origin* (with parameters *ip*, *enterpriseId*, *software* and *swVersion*) and *meta* (with parameters *sequenceId*, *sysUpTime* and *language*). These element IDs may be specified without the **@**__digits__ suffix.\n"
15398 #. type: Labeled list
15399 #: ../misc-utils/logger.1.adoc:143
15401 msgid "*--sd-param* _name_=_value_"
15404 #. type: Plain text
15405 #: ../misc-utils/logger.1.adoc:145
15407 "Specifies a structured data element parameter, a name and value pair. The "
15408 "option has to be used after *--sd-id* and may be specified more than once "
15409 "for the same element. Note that the quotation marks around _value_ are "
15410 "required and must be escaped on the command line."
15413 #. type: delimited block .
15414 #: ../misc-utils/logger.1.adoc:153
15417 " logger --rfc5424 --sd-id zoo@123 \\\n"
15418 " --sd-param tiger=\"hungry\" \\\n"
15419 " --sd-param zebra=\"running\" \\\n"
15420 " --sd-id manager@123 \\\n"
15421 " --sd-param onMeeting=\"yes\" \\\n"
15422 " \"this is message\"\n"
15425 #. type: Plain text
15426 #: ../misc-utils/logger.1.adoc:155
15430 #. type: Plain text
15431 #: ../misc-utils/logger.1.adoc:157
15433 msgid "*<13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown=\"1\" isSynced=\"1\" syncAccuracy=\"218616\"][zoo@123 tiger=\"hungry\" zebra=\"running\"][manager@123 onMeeting=\"yes\"] this is message*\n"
15436 #. type: Plain text
15437 #: ../misc-utils/logger.1.adoc:160
15439 "Sets the maximum permitted message size to _size_. The default is 1KiB "
15440 "characters, which is the limit traditionally used and specified in RFC 3164. "
15441 "With RFC 5424, this limit has become flexible. A good assumption is that RFC "
15442 "5424 receivers can at least process 4KiB messages."
15445 #. type: Plain text
15446 #: ../misc-utils/logger.1.adoc:162
15448 "Most receivers accept messages larger than 1KiB over any type of syslog "
15449 "protocol. As such, the *--size* option affects *logger* in all cases (not "
15450 "only when *--rfc5424* was used)."
15453 #. type: Plain text
15454 #: ../misc-utils/logger.1.adoc:164
15456 "Note: the message-size limit limits the overall message size, including the "
15457 "syslog header. Header sizes vary depending on the selected options and the "
15458 "hostname length. As a rule of thumb, headers are usually not longer than 50 "
15459 "to 80 characters. When selecting a maximum message size, it is important to "
15460 "ensure that the receiver supports the max size as well, otherwise messages "
15461 "may become truncated. Again, as a rule of thumb two to four KiB message size "
15462 "should generally be OK, whereas anything larger should be verified to work."
15465 #. type: Labeled list
15466 #: ../misc-utils/logger.1.adoc:165
15468 msgid "*--socket-errors*[**=**__mode__]"
15471 #. type: Plain text
15472 #: ../misc-utils/logger.1.adoc:167
15474 "Print errors about Unix socket connections. The _mode_ can be a value of "
15475 "*off*, *on*, or *auto*. When the mode is *auto*, then *logger* will detect "
15476 "if the init process is *systemd*(1), and if so assumption is made _/dev/log_ "
15477 "can be used early at boot. Other init systems lack of _/dev/log_ will not "
15478 "cause errors that is identical with messaging using *openlog*(3) system "
15479 "call. The *logger*(1) before version 2.26 used *openlog*(3), and hence was "
15480 "unable to detected loss of messages sent to Unix sockets."
15483 #. type: Plain text
15484 #: ../misc-utils/logger.1.adoc:169
15486 "The default mode is *auto*. When errors are not enabled lost messages are "
15487 "not communicated and will result to successful exit status of *logger*(1) "
15491 #. type: Labeled list
15492 #: ../misc-utils/logger.1.adoc:170
15494 #| msgid "*-P*, *--pty*"
15495 msgid "*-T*, *--tcp*"
15496 msgstr "*-P*, *--pty*"
15498 #. type: Plain text
15499 #: ../misc-utils/logger.1.adoc:172
15501 "Use stream (TCP) only. By default the connection is tried to the _syslog-"
15502 "conn_ port defined in _/etc/services_, which is often _601_."
15505 #. type: Labeled list
15506 #: ../misc-utils/logger.1.adoc:175
15508 #| msgid "*-P*, *--pty*"
15509 msgid "*-t*, *--tag* _tag_"
15510 msgstr "*-P*, *--pty*"
15512 #. type: Plain text
15513 #: ../misc-utils/logger.1.adoc:177
15515 "Mark every line to be logged with the specified _tag_. The default tag is "
15516 "the name of the user logged in on the terminal (or a user name based on "
15517 "effective user ID)."
15520 #. type: Labeled list
15521 #: ../misc-utils/logger.1.adoc:178
15523 msgid "*-u*, *--socket* _socket_"
15526 #. type: Plain text
15527 #: ../misc-utils/logger.1.adoc:180
15528 msgid "Write to the specified _socket_ instead of to the system log socket."
15531 #. type: Labeled list
15532 #: ../misc-utils/logger.1.adoc:181
15537 #. type: Plain text
15538 #: ../misc-utils/logger.1.adoc:183
15540 "End the argument list. This allows the _message_ to start with a hyphen (-)."
15543 #. type: Plain text
15544 #: ../misc-utils/logger.1.adoc:189
15545 msgid "The *logger* utility exits 0 on success, and >0 if an error occurs."
15549 #: ../misc-utils/logger.1.adoc:190
15551 msgid "FACILITIES AND LEVELS"
15554 #. type: Plain text
15555 #: ../misc-utils/logger.1.adoc:193
15556 msgid "Valid facility names are:"
15559 #. type: Plain text
15560 #: ../misc-utils/logger.1.adoc:197
15564 "*authpriv* for security information of a sensitive nature +\n"
15568 #. type: Plain text
15569 #: ../misc-utils/logger.1.adoc:201
15574 "*kern* cannot be generated from userspace process, automatically converted to *user* +\n"
15577 #. type: Plain text
15578 #: ../misc-utils/logger.1.adoc:212
15590 "*security* deprecated synonym for *auth*\n"
15593 #. type: Plain text
15594 #: ../misc-utils/logger.1.adoc:214
15595 msgid "Valid level names are:"
15598 #. type: Plain text
15599 #: ../misc-utils/logger.1.adoc:226
15610 "*panic* deprecated synonym for *emerg* +\n"
15611 "*error* deprecated synonym for *err* +\n"
15612 "*warn* deprecated synonym for *warning* +\n"
15615 #. type: Plain text
15616 #: ../misc-utils/logger.1.adoc:228
15618 "For the priority order and intended purposes of these facilities and levels, "
15622 #. type: Plain text
15623 #: ../misc-utils/logger.1.adoc:232
15625 "The *logger* command is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
15629 #. type: delimited block _
15630 #: ../misc-utils/logger.1.adoc:236
15631 msgid "logger System rebooted"
15634 #. type: delimited block _
15635 #: ../misc-utils/logger.1.adoc:238
15636 msgid "logger -p local0.notice -t HOSTIDM -f /dev/idmc"
15639 #. type: delimited block _
15640 #: ../misc-utils/logger.1.adoc:240
15641 msgid "logger -n loghost.example.com System rebooted"
15644 #. type: Plain text
15645 #: ../misc-utils/logger.1.adoc:245
15647 "The *logger* command was originally written by University of California in "
15648 "1983-1993 and later rewritten by mailto:kzak@redhat.com[Karel Zak], mailto:"
15649 "rgerhards@adiscon.com[Rainer Gerhards], and mailto:kerolasa@iki.fi[Sami "
15653 #. type: Plain text
15654 #: ../misc-utils/logger.1.adoc:251
15657 "*journalctl*(1),\n"
15659 "*systemd.journal-fields*(7)\n"
15665 #. Copyright (c) 1990, 1993
15666 #. The Regents of the University of California. All rights reserved.
15667 #. Redistribution and use in source and binary forms, with or without
15668 #. modification, are permitted provided that the following conditions
15670 #. 1. Redistributions of source code must retain the above copyright
15671 #. notice, this list of conditions and the following disclaimer.
15672 #. 2. Redistributions in binary form must reproduce the above copyright
15673 #. notice, this list of conditions and the following disclaimer in the
15674 #. documentation and/or other materials provided with the distribution.
15675 #. 3. All advertising materials mentioning features or use of this software
15676 #. must display the following acknowledgement:
15677 #. This product includes software developed by the University of
15678 #. California, Berkeley and its contributors.
15679 #. 4. Neither the name of the University nor the names of its contributors
15680 #. may be used to endorse or promote products derived from this software
15681 #. without specific prior written permission.
15682 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
15683 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15684 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15685 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
15686 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
15687 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
15688 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
15689 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
15690 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
15691 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
15693 #. @(#)look.1 8.1 (Berkeley) 6/14/93
15695 #: ../misc-utils/look.1.adoc:36
15700 #. type: Plain text
15701 #: ../misc-utils/look.1.adoc:46
15702 msgid "look - display lines beginning with a given string"
15705 #. type: Plain text
15706 #: ../misc-utils/look.1.adoc:50
15708 msgid "*look* [options] _string_ [_file_]\n"
15711 #. type: Plain text
15712 #: ../misc-utils/look.1.adoc:54
15714 "The *look* utility displays any lines in _file_ which contain _string_ as a "
15715 "prefix. As *look* performs a binary search, the lines in _file_ must be "
15716 "sorted (where *sort*(1) was given the same options *-d* and/or *-f* that "
15717 "*look* is invoked with)."
15720 #. type: Plain text
15721 #: ../misc-utils/look.1.adoc:56
15723 "If _file_ is not specified, the file _/usr/share/dict/words_ is used, only "
15724 "alphanumeric characters are compared and the case of alphabetic characters "
15728 #. type: Plain text
15729 #: ../misc-utils/look.1.adoc:61
15730 msgid "Use the alternative dictionary file."
15733 #. type: Labeled list
15734 #: ../misc-utils/look.1.adoc:62
15736 #| msgid "*-h*, *--help*"
15737 msgid "*-d*, *--alphanum*"
15738 msgstr "*-h*, *--help*"
15740 #. type: Plain text
15741 #: ../misc-utils/look.1.adoc:64
15743 "Use normal dictionary character set and order, i.e., only blanks and "
15744 "alphanumeric characters are compared. This is on by default if no file is "
15748 #. type: Plain text
15749 #: ../misc-utils/look.1.adoc:66
15751 "Note that blanks have been added to dictionary character set for "
15752 "compatibility with *sort -d* command since version 2.28."
15755 #. type: Labeled list
15756 #: ../misc-utils/look.1.adoc:67
15758 #| msgid "*-f*, *--fast*"
15759 msgid "*-f*, *--ignore-case*"
15760 msgstr "*-f*, *--fast*"
15762 #. type: Plain text
15763 #: ../misc-utils/look.1.adoc:69
15765 "Ignore the case of alphabetic characters. This is on by default if no file "
15769 #. type: Labeled list
15770 #: ../misc-utils/look.1.adoc:70
15772 msgid "*-t*, *--terminate* _character_"
15775 #. type: Plain text
15776 #: ../misc-utils/look.1.adoc:72
15778 "Specify a string termination character, i.e., only the characters in "
15779 "_string_ up to and including the first occurrence of _character_ are "
15783 #. type: Plain text
15784 #: ../misc-utils/look.1.adoc:76
15786 "The *look* utility exits 0 if one or more lines were found and displayed, 1 "
15787 "if no lines were found, and >1 if an error occurred."
15790 #. type: Labeled list
15791 #: ../misc-utils/look.1.adoc:79
15796 #. type: Plain text
15797 #: ../misc-utils/look.1.adoc:81
15799 "Path to a dictionary file. The environment variable has greater priority "
15800 "than the dictionary path defined in the *FILES* segment."
15803 #. type: Labeled list
15804 #: ../misc-utils/look.1.adoc:84
15806 msgid "_/usr/share/dict/words_"
15809 #. type: Plain text
15810 #: ../misc-utils/look.1.adoc:86
15811 msgid "the dictionary"
15814 #. type: Labeled list
15815 #: ../misc-utils/look.1.adoc:87
15817 msgid "_/usr/share/dict/web2_"
15820 #. type: Plain text
15821 #: ../misc-utils/look.1.adoc:89
15822 msgid "the alternative dictionary"
15825 #. type: Plain text
15826 #: ../misc-utils/look.1.adoc:93
15828 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
15829 msgid "The *look* utility appeared in Version 7 AT&T Unix."
15830 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
15832 #. type: delimited block .
15833 #: ../misc-utils/look.1.adoc:99
15836 "sort -d /etc/passwd -o /tmp/look.dict\n"
15837 "look -t: root:foobar /tmp/look.dict\n"
15840 #. type: Plain text
15841 #: ../misc-utils/look.1.adoc:105
15849 #: ../misc-utils/lsblk.8.adoc:2
15854 #. type: Plain text
15855 #: ../misc-utils/lsblk.8.adoc:12
15856 msgid "lsblk - list block devices"
15859 #. type: Plain text
15860 #: ../misc-utils/lsblk.8.adoc:16
15862 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
15863 msgid "*lsblk* [options] [_device_...]\n"
15864 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
15866 #. type: Plain text
15867 #: ../misc-utils/lsblk.8.adoc:20
15869 msgid "*lsblk* lists information about all available or the specified block devices. The *lsblk* command reads the *sysfs* filesystem and *udev db* to gather information. If the udev db is not available or *lsblk* is compiled without udev support, then it tries to read LABELs, UUIDs and filesystem types from the block device. In this case root permissions are necessary.\n"
15872 #. type: Plain text
15873 #: ../misc-utils/lsblk.8.adoc:22
15875 "By default, the command prints all block devices (except RAM disks) in a "
15876 "tree-like format. The same device can be repeated in the tree if it relates "
15877 "to other devices. The *--merge* option is recommended for more complicated "
15878 "setups to gather groups of devices and describe complex N:M relationships."
15881 #. type: Plain text
15882 #: ../misc-utils/lsblk.8.adoc:24
15884 "The tree-like output (or *children[]* array in the JSON output) is enabled "
15885 "only if NAME column it present in the output or when *--tree* command line "
15886 "option is used. See also *--nodeps* and *--list* to control the tree "
15890 #. type: Plain text
15891 #: ../misc-utils/lsblk.8.adoc:26
15893 "The default output, as well as the default output from options like *--fs* "
15894 "and *--topology*, is subject to change. So whenever possible, you should "
15895 "avoid using default outputs in your scripts. Always explicitly define "
15896 "expected columns by using *--output* _columns-list_ and *--list* in "
15897 "environments where a stable output is required."
15900 #. type: Plain text
15901 #: ../misc-utils/lsblk.8.adoc:28
15902 msgid "Use *lsblk --help* to get a list of all available columns."
15905 #. type: Plain text
15906 #: ../misc-utils/lsblk.8.adoc:30
15908 "Note that *lsblk* might be executed in time when *udev* does not have all "
15909 "information about recently added or modified devices yet. In this case it is "
15910 "recommended to use *udevadm settle* before *lsblk* to synchronize with udev."
15913 #. type: Plain text
15914 #: ../misc-utils/lsblk.8.adoc:32
15916 "The relationship between block devices and filesystems is not always one-to-"
15917 "one. The filesystem may use more block devices, or the same filesystem may "
15918 "be accessible by more paths. This is the reason why *lsblk* provides "
15919 "MOUNTPOINT and MOUNTPOINTS (pl.) columns. The column MOUNTPOINT displays "
15920 "only one mount point (usually the last mounted instance of the filesystem), "
15921 "and the column MOUNTPOINTS displays by multi-line cell all mount points "
15922 "associated with the device."
15925 #. type: Labeled list
15926 #: ../misc-utils/lsblk.8.adoc:35
15928 #| msgid "*-P*, *--pty*"
15929 msgid "*-A*, *--noempty*"
15930 msgstr "*-P*, *--pty*"
15932 #. type: Plain text
15933 #: ../misc-utils/lsblk.8.adoc:37
15934 msgid "Don't print empty devices."
15937 #. type: Plain text
15938 #: ../misc-utils/lsblk.8.adoc:40
15940 "Disable all built-in filters and list all empty devices and RAM disk devices "
15944 #. type: Labeled list
15945 #: ../misc-utils/lsblk.8.adoc:44
15947 #| msgid "*-f*, *--fast*"
15948 msgid "*-D*, *--discard*"
15949 msgstr "*-f*, *--fast*"
15951 #. type: Plain text
15952 #: ../misc-utils/lsblk.8.adoc:46
15954 "Print information about the discarding capabilities (TRIM, UNMAP) for each "
15958 #. type: Labeled list
15959 #: ../misc-utils/lsblk.8.adoc:47
15961 #| msgid "*-h*, *--help*"
15962 msgid "*-d*, *--nodeps*"
15963 msgstr "*-h*, *--help*"
15965 #. type: Plain text
15966 #: ../misc-utils/lsblk.8.adoc:49
15968 "Do not print holder devices or slaves. For example, *lsblk --nodeps /dev/"
15969 "sda* prints information about the sda device only."
15972 #. type: Labeled list
15973 #: ../misc-utils/lsblk.8.adoc:50
15975 msgid "*-E*, *--dedup* _column_"
15978 #. type: Plain text
15979 #: ../misc-utils/lsblk.8.adoc:52
15981 "Use _column_ as a de-duplication key to de-duplicate output tree. If the key "
15982 "is not available for the device, or the device is a partition and parental "
15983 "whole-disk device provides the same key than the device is always printed."
15986 #. type: Plain text
15987 #: ../misc-utils/lsblk.8.adoc:54
15989 "The usual use case is to de-duplicate output on system multi-path devices, "
15990 "for example by *-E WWN*."
15993 #. type: Labeled list
15994 #: ../misc-utils/lsblk.8.adoc:55
15996 msgid "*-e*, *--exclude* _list_"
15999 #. type: Plain text
16000 #: ../misc-utils/lsblk.8.adoc:57
16002 "Exclude the devices specified by the comma-separated _list_ of major device "
16003 "numbers. Note that RAM disks (major=1) are excluded by default if *--all* is "
16004 "not specified. The filter is applied to the top-level devices only. This may "
16005 "be confusing for *--list* output format where hierarchy of the devices is "
16009 #. type: Labeled list
16010 #: ../misc-utils/lsblk.8.adoc:58
16012 #| msgid "*-f*, *--fast*"
16013 msgid "*-f*, *--fs*"
16014 msgstr "*-f*, *--fast*"
16016 #. type: Plain text
16017 #: ../misc-utils/lsblk.8.adoc:60
16019 "Output info about filesystems. This option is equivalent to *-o NAME,FSTYPE,"
16020 "FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS*. The authoritative information "
16021 "about filesystems and raids is provided by the *blkid*(8) command."
16024 #. type: Labeled list
16025 #: ../misc-utils/lsblk.8.adoc:61
16027 msgid "*-I*, *--include* _list_"
16030 #. type: Plain text
16031 #: ../misc-utils/lsblk.8.adoc:63
16033 "Include devices specified by the comma-separated _list_ of major device "
16034 "numbers. The filter is applied to the top-level devices only. This may be "
16035 "confusing for *--list* output format where hierarchy of the devices is not "
16039 #. type: Labeled list
16040 #: ../misc-utils/lsblk.8.adoc:64
16042 #| msgid "*-f*, *--fast*"
16043 msgid "*-i*, *--ascii*"
16044 msgstr "*-f*, *--fast*"
16046 #. type: Plain text
16047 #: ../misc-utils/lsblk.8.adoc:66
16048 msgid "Use ASCII characters for tree formatting."
16051 #. type: Plain text
16052 #: ../misc-utils/lsblk.8.adoc:69
16054 "Use JSON output format. It's strongly recommended to use *--output* and also "
16055 "*--tree* if necessary. Note that *children[]* is used only if NAME column or "
16056 "*--tree* is used."
16059 #. type: Plain text
16060 #: ../misc-utils/lsblk.8.adoc:72
16062 "Produce output in the form of a list. The output does not provide "
16063 "information about relationships between devices and since version 2.34 every "
16064 "device is printed only once if *--pairs* or *--raw* not specified (the "
16065 "parsable outputs are maintained in backwardly compatible way)."
16068 #. type: Labeled list
16069 #: ../misc-utils/lsblk.8.adoc:73
16071 #| msgid "*-h*, *--help*"
16072 msgid "*-M*, *--merge*"
16073 msgstr "*-h*, *--help*"
16075 #. type: Plain text
16076 #: ../misc-utils/lsblk.8.adoc:75
16078 "Group parents of sub-trees to provide more readable output for RAIDs and "
16079 "Multi-path devices. The tree-like output is required."
16082 #. type: Labeled list
16083 #: ../misc-utils/lsblk.8.adoc:76
16085 #| msgid "*-V*, *--version*"
16086 msgid "*-m*, *--perms*"
16087 msgstr "*-V*, *--version*"
16089 #. type: Plain text
16090 #: ../misc-utils/lsblk.8.adoc:78
16092 "Output info about device owner, group and mode. This option is equivalent to "
16093 "*-o NAME,SIZE,OWNER,GROUP,MODE*."
16096 #. type: Labeled list
16097 #: ../misc-utils/lsblk.8.adoc:79
16099 #| msgid "*-h*, *--help*"
16100 msgid "*-N*, *--nvme*"
16101 msgstr "*-h*, *--help*"
16103 #. type: Plain text
16104 #: ../misc-utils/lsblk.8.adoc:81
16105 msgid "Output info about NVMe devices only."
16108 #. type: Labeled list
16109 #: ../misc-utils/lsblk.8.adoc:82
16111 #| msgid "*-V*, *--version*"
16112 msgid "*-v*, *--virtio*"
16113 msgstr "*-V*, *--version*"
16115 #. type: Plain text
16116 #: ../misc-utils/lsblk.8.adoc:84
16117 msgid "Output info about virtio devices only."
16120 #. type: Plain text
16121 #: ../misc-utils/lsblk.8.adoc:90
16123 "Specify which output columns to print. Use *--help* to get a list of all "
16124 "supported columns. The columns may affect tree-like output. The default is "
16125 "to use tree for the column 'NAME' (see also *--tree*)."
16128 #. type: Plain text
16129 #: ../misc-utils/lsblk.8.adoc:92
16131 "The default list of columns may be extended if _list_ is specified in the "
16132 "format _+list_ (e.g., *lsblk -o +UUID*)."
16135 #. type: Labeled list
16136 #: ../misc-utils/lsblk.8.adoc:93
16138 #| msgid "*-P*, *--pty*"
16139 msgid "*-O*, *--output-all*"
16140 msgstr "*-P*, *--pty*"
16142 #. type: Plain text
16143 #: ../misc-utils/lsblk.8.adoc:98
16145 "Produce output in the form of key=\"value\" pairs. The output lines are "
16146 "still ordered by dependencies. All potentially unsafe value characters are "
16147 "hex-escaped (\\x<code>). See also option *--shell*."
16150 #. type: Labeled list
16151 #: ../misc-utils/lsblk.8.adoc:99
16153 #| msgid "*-P*, *--pty*"
16154 msgid "*-p*, *--paths*"
16155 msgstr "*-P*, *--pty*"
16157 #. type: Plain text
16158 #: ../misc-utils/lsblk.8.adoc:101
16159 msgid "Print full device paths."
16162 #. type: Plain text
16163 #: ../misc-utils/lsblk.8.adoc:104
16165 "Produce output in raw format. The output lines are still ordered by "
16166 "dependencies. All potentially unsafe characters are hex-escaped (\\x<code>) "
16167 "in the NAME, KNAME, LABEL, PARTLABEL and MOUNTPOINT columns."
16170 #. type: Labeled list
16171 #: ../misc-utils/lsblk.8.adoc:105
16173 #| msgid "*-f*, *--fast*"
16174 msgid "*-S*, *--scsi*"
16175 msgstr "*-f*, *--fast*"
16177 #. type: Plain text
16178 #: ../misc-utils/lsblk.8.adoc:107
16180 "Output info about SCSI devices only. All partitions, slaves and holder "
16181 "devices are ignored."
16184 #. type: Labeled list
16185 #: ../misc-utils/lsblk.8.adoc:108
16187 #| msgid "*-V*, *--version*"
16188 msgid "*-s*, *--inverse*"
16189 msgstr "*-V*, *--version*"
16191 #. type: Plain text
16192 #: ../misc-utils/lsblk.8.adoc:110
16194 "Print dependencies in inverse order. If the *--list* output is requested "
16195 "then the lines are still ordered by dependencies."
16198 #. type: Labeled list
16199 #: ../misc-utils/lsblk.8.adoc:111
16201 #| msgid "*-g*, **--group**=__group__"
16202 msgid "*-T*, *--tree*[**=**__column__]"
16203 msgstr "*-g*, **--group**=__skupina__"
16205 #. type: Plain text
16206 #: ../misc-utils/lsblk.8.adoc:113
16208 "Force tree-like output format. If _column_ is specified, then a tree is "
16209 "printed in the column. The default is NAME column."
16212 #. type: Labeled list
16213 #: ../misc-utils/lsblk.8.adoc:114
16215 #| msgid "*-P*, *--pty*"
16216 msgid "*-t*, *--topology*"
16217 msgstr "*-P*, *--pty*"
16219 #. type: Plain text
16220 #: ../misc-utils/lsblk.8.adoc:116
16221 msgid "Output info about block-device topology. This option is equivalent to"
16224 #. type: Plain text
16225 #: ../misc-utils/lsblk.8.adoc:118
16227 "NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME*."
16230 #. type: Labeled list
16231 #: ../misc-utils/lsblk.8.adoc:121
16233 msgid "*-w*, *--width* _number_"
16236 #. type: Plain text
16237 #: ../misc-utils/lsblk.8.adoc:123
16239 "Specifies output width as a number of characters. The default is the number "
16240 "of the terminal columns, and if not executed on a terminal, then output "
16241 "width is not restricted at all by default. This option also forces *lsblk* "
16242 "to assume that terminal control characters and unsafe characters are not "
16243 "allowed. The expected use-case is for example when *lsblk* is used by the "
16244 "*watch*(1) command."
16247 #. type: Labeled list
16248 #: ../misc-utils/lsblk.8.adoc:124
16250 msgid "*-x*, *--sort* _column_"
16253 #. type: Plain text
16254 #: ../misc-utils/lsblk.8.adoc:126
16256 "Sort output lines by _column_. This option enables *--list* output format by "
16257 "default. It is possible to use the option *--tree* to force tree-like output "
16258 "and than the tree branches are sorted by the _column_."
16261 #. type: Plain text
16262 #: ../misc-utils/lsblk.8.adoc:129
16264 "The column name will be modified to contain only characters allowed for "
16265 "shell variable identifiers, for example, MIN_IO and FSUSE_PCT instead of MIN-"
16266 "IO and FSUSE%. This is usable, for example, with *--pairs*. Note that this "
16267 "feature has been automatically enabled for *--pairs* in version 2.37, but "
16268 "due to compatibility issues, now it's necessary to request this behavior by "
16272 #. type: Labeled list
16273 #: ../misc-utils/lsblk.8.adoc:130
16275 #| msgid "*-h*, *--help*"
16276 msgid "*-z*, *--zoned*"
16277 msgstr "*-h*, *--help*"
16279 #. type: Plain text
16280 #: ../misc-utils/lsblk.8.adoc:132
16281 msgid "Print the zone related information for each device."
16284 #. type: Labeled list
16285 #: ../misc-utils/lsblk.8.adoc:133
16287 msgid "*--sysroot* _directory_"
16290 #. type: Plain text
16291 #: ../misc-utils/lsblk.8.adoc:135
16293 "Gather data for a Linux instance other than the instance from which the "
16294 "*lsblk* command is issued. The specified directory is the system root of the "
16295 "Linux instance to be inspected. The real device nodes in the target "
16296 "directory can be replaced by text files with udev attributes."
16299 #. type: Labeled list
16300 #: ../misc-utils/lsblk.8.adoc:144 ../sys-utils/fstrim.8.adoc:80
16305 #. type: Plain text
16306 #: ../misc-utils/lsblk.8.adoc:146
16307 msgid "none of specified devices found"
16310 #. type: Labeled list
16311 #: ../misc-utils/lsblk.8.adoc:147 ../sys-utils/fstrim.8.adoc:82
16316 #. type: Plain text
16317 #: ../misc-utils/lsblk.8.adoc:149
16318 msgid "some specified devices found, some not found"
16321 #. type: Labeled list
16322 #: ../misc-utils/lsblk.8.adoc:152
16324 msgid "*LSBLK_DEBUG*=all"
16327 #. type: Plain text
16328 #: ../misc-utils/lsblk.8.adoc:154
16329 msgid "enables *lsblk* debug output."
16332 #. type: Plain text
16333 #: ../misc-utils/lsblk.8.adoc:157 ../sys-utils/swapon.8.adoc:130
16334 msgid "enables *libblkid* debug output."
16337 #. type: Plain text
16338 #: ../misc-utils/lsblk.8.adoc:160 ../sys-utils/swapon.8.adoc:127
16339 msgid "enables *libmount* debug output."
16342 #. type: Plain text
16343 #: ../misc-utils/lsblk.8.adoc:163
16344 msgid "enables *libsmartcols* debug output."
16347 #. type: Plain text
16348 #: ../misc-utils/lsblk.8.adoc:170
16350 "For partitions, some information (e.g., queue attributes) is inherited from "
16351 "the parent device."
16354 #. type: Plain text
16355 #: ../misc-utils/lsblk.8.adoc:172
16357 "The *lsblk* command needs to be able to look up each block device by major:"
16358 "minor numbers, which is done by using _/sys/dev/block_. This sysfs block "
16359 "directory appeared in kernel 2.6.27 (October 2008). In case of problems with "
16360 "a new enough kernel, check that *CONFIG_SYSFS* was enabled at the time of "
16361 "the kernel build."
16364 #. type: Plain text
16365 #: ../misc-utils/lsblk.8.adoc:177
16367 "mailto:gmazyland@gmail.com[Milan Broz], mailto:kzak@redhat.com[Karel Zak]"
16370 #. type: Plain text
16371 #: ../misc-utils/lsblk.8.adoc:183
16387 #. Copyright 2021 Red Hat, Inc.
16388 #. This file may be copied under the terms of the GNU Public License.
16390 #: ../misc-utils/lsfd.1.adoc:7
16395 #. type: Plain text
16396 #: ../misc-utils/lsfd.1.adoc:18
16397 msgid "lsfd - list file descriptors"
16400 #. type: Plain text
16401 #: ../misc-utils/lsfd.1.adoc:22
16403 msgid "*lsfd* [option]\n"
16406 #. type: Plain text
16407 #: ../misc-utils/lsfd.1.adoc:30
16410 "*lsfd* is intended to be a modern replacement for *lsof*(8) on Linux systems.\n"
16411 "Unlike *lsof*, *lsfd* is specialized to Linux kernel; it supports Linux\n"
16412 "specific features like namespaces with simpler code. *lsfd* is not a\n"
16413 "drop-in replacement for *lsof*; they are different in the command line\n"
16414 "interface and output formats.\n"
16417 #. type: Plain text
16418 #: ../misc-utils/lsfd.1.adoc:38
16421 "*lsfd* uses Libsmartcols for output formatting and filtering. See the description of *--output*\n"
16422 "option for customizing the output format, and *--filter* option for filtering. Use *lsfd --help*\n"
16423 "to get a list of all available columns.\n"
16426 #. type: Labeled list
16427 #: ../misc-utils/lsfd.1.adoc:41
16429 #| msgid "*-h*, *--help*"
16430 msgid "*-l*, *--threads*"
16431 msgstr "*-h*, *--help*"
16433 #. type: Plain text
16434 #: ../misc-utils/lsfd.1.adoc:43
16435 msgid "List in threads level."
16438 #. type: Plain text
16439 #: ../misc-utils/lsfd.1.adoc:49 ../sys-utils/lsirq.1.adoc:27
16440 msgid "Don't print headings."
16443 #. type: Plain text
16444 #: ../misc-utils/lsfd.1.adoc:53
16446 "Specify which output columns to print. See the *OUTPUT COLUMNS* section for "
16447 "details of available columns."
16450 #. type: Plain text
16451 #: ../misc-utils/lsfd.1.adoc:56
16453 "The default list of columns may be extended if _list_ is specified in the "
16454 "format +_list_ (e.g., *lsfd -o +DELETED*)."
16457 #. type: Plain text
16458 #: ../misc-utils/lsfd.1.adoc:59
16459 msgid "Use raw output format."
16462 #. type: Plain text
16463 #: ../misc-utils/lsfd.1.adoc:62
16464 msgid "Don't truncate text in columns."
16467 #. type: Labeled list
16468 #: ../misc-utils/lsfd.1.adoc:63
16470 #| msgid "*-P*, *--pty*"
16471 msgid "*-p*, *--pid* _pids_"
16472 msgstr "*-P*, *--pty*"
16474 #. type: Plain text
16475 #: ../misc-utils/lsfd.1.adoc:67
16477 "Collect information only for specified processes. _pids_ is a list of pids. "
16478 "A comma or whitespaces can be used as separators. You can use this option "
16479 "with *pidof*(1). See *FILTER EXAMPLES*."
16482 #. type: Plain text
16483 #: ../misc-utils/lsfd.1.adoc:72
16485 "Both *-Q* option with an expression including PID, e.g. -Q (PID == 1), and *-"
16486 "p* option, e.g. -p 1, may print the same output but using *-p* option is "
16487 "much more efficient because *-p* option works at a much earlier stage of "
16488 "processing than the *-Q* option."
16491 #. type: Labeled list
16492 #: ../misc-utils/lsfd.1.adoc:73
16494 #| msgid "*-V*, *--version*"
16495 msgid "*-i*[4|6], *--inet*[=4|=6]"
16496 msgstr "*-V*, *--version*"
16498 #. type: Plain text
16499 #: ../misc-utils/lsfd.1.adoc:75
16500 msgid "List only IPv4 sockets and/or IPv6 sockets."
16503 #. type: Labeled list
16504 #: ../misc-utils/lsfd.1.adoc:76
16506 msgid "*-Q*, *--filter* _expr_"
16509 #. type: Plain text
16510 #: ../misc-utils/lsfd.1.adoc:79
16512 "Print only the files matching the condition represented by the _expr_. See "
16513 "also *FILTER EXAMPLES*."
16516 #. type: Labeled list
16517 #: ../misc-utils/lsfd.1.adoc:80
16519 msgid "*-C*, *--counter* __label__:__filter_expr__"
16522 #. type: Plain text
16523 #: ../misc-utils/lsfd.1.adoc:86
16525 "Define a custom counter used in *--summary* output. *lsfd* makes a counter "
16526 "named _label_. During collect information, *lsfd* counts files matching "
16527 "_filter_expr_, and stores the counted number to the counter named _label_. "
16528 "*lsfd* applies filters defined with *--filter* options before counting; "
16529 "files excluded by the filters are not counted."
16532 #. type: Plain text
16533 #: ../misc-utils/lsfd.1.adoc:90
16535 "See *FILTER EXPRESSION* about _filter_expr_. _label_ should not include `{` "
16536 "nor `:`. You can define multiple counters by specifying this option multiple "
16540 #. type: Plain text
16541 #: ../misc-utils/lsfd.1.adoc:92
16542 msgid "See also *COUNTER EXAMPLES*."
16545 #. type: Labeled list
16546 #: ../misc-utils/lsfd.1.adoc:93 ../sys-utils/lsmem.1.adoc:65
16548 msgid "*--summary*[=_when_]"
16551 #. type: Plain text
16552 #: ../misc-utils/lsfd.1.adoc:97
16554 "This option controls summary lines output. The optional argument _when_ can "
16555 "be *only*, *append* or *never*. If the _when_ argument is omitted, it "
16556 "defaults to *only*."
16559 #. type: Plain text
16560 #: ../misc-utils/lsfd.1.adoc:102
16562 "The summary reports counters. A counter consists of a label and an integer "
16563 "value. *--counter* is the option for defining a counter. If a user defines "
16564 "no counter, *lsfd* uses the definitions of pre-defined built-in counters "
16565 "(default counters) to make the summary output."
16568 #. TRANSLATORS: Keep {colon} untranslated.
16569 #. type: Plain text
16570 #: ../misc-utils/lsfd.1.adoc:104
16572 "CAUTION{colon} Using *--summary* and *--json* may make the output broken. "
16573 "Only combining *--summary*=*only* and *--json* is valid."
16576 #. type: Labeled list
16577 #: ../misc-utils/lsfd.1.adoc:106
16579 msgid "*--debug-filter*"
16582 #. type: Plain text
16583 #: ../misc-utils/lsfd.1.adoc:109
16585 "Dump the internal data structure for the filter and exit. This is useful "
16586 "only for *lsfd* developers."
16589 #. type: Labeled list
16590 #: ../misc-utils/lsfd.1.adoc:110
16592 msgid "*--dump-counters*"
16595 #. type: Plain text
16596 #: ../misc-utils/lsfd.1.adoc:112
16597 msgid "Dump the definition of counters used in *--summary* output."
16600 #. type: Labeled list
16601 #: ../misc-utils/lsfd.1.adoc:113
16603 #| msgid "*-f*, *--fast*"
16604 msgid "*-H*, *--list-columns*"
16605 msgstr "*-f*, *--fast*"
16607 #. type: Plain text
16608 #: ../misc-utils/lsfd.1.adoc:115
16609 msgid "List available columns that you can specify at *--output* option."
16613 #: ../misc-utils/lsfd.1.adoc:118
16615 msgid "OUTPUT COLUMNS"
16618 #. type: Plain text
16619 #: ../misc-utils/lsfd.1.adoc:121
16620 msgid "Each column has a type. Types are surround by < and >."
16623 #. TRANSLATORS: Keep {colon} untranslated.
16624 #. type: Plain text
16625 #: ../misc-utils/lsfd.1.adoc:125
16627 "CAUTION{colon} The names and types of columns are not stable yet. They may "
16628 "be changed in the future releases."
16631 #. type: Labeled list
16632 #: ../misc-utils/lsfd.1.adoc:126
16634 msgid "AINODECLASS <``string``>"
16637 #. type: Plain text
16638 #: ../misc-utils/lsfd.1.adoc:128
16639 msgid "Class of anonymous inode."
16642 #. type: Labeled list
16643 #: ../misc-utils/lsfd.1.adoc:129
16645 msgid "ASSOC <``string``>"
16648 #. type: Plain text
16649 #: ../misc-utils/lsfd.1.adoc:131
16650 msgid "Association between file and process."
16653 #. type: Labeled list
16654 #: ../misc-utils/lsfd.1.adoc:132
16656 msgid "BLKDRV <``string``>"
16659 #. type: Plain text
16660 #: ../misc-utils/lsfd.1.adoc:134
16661 msgid "Block device driver name resolved by `/proc/devices`."
16664 #. type: Labeled list
16665 #: ../misc-utils/lsfd.1.adoc:135
16667 msgid "BPF-MAP.ID <``number``>"
16670 #. type: Plain text
16671 #: ../misc-utils/lsfd.1.adoc:137
16672 msgid "Bpf map ID."
16675 #. type: Labeled list
16676 #: ../misc-utils/lsfd.1.adoc:138
16678 #| msgid "*ENV_PATH* (string)"
16679 msgid "BPF-MAP.TYPE <``string``>"
16680 msgstr "*ENV_PATH* (řetězec)"
16682 #. type: Plain text
16683 #: ../misc-utils/lsfd.1.adoc:140
16684 msgid "Decoded name of bpf map type."
16687 #. type: Labeled list
16688 #: ../misc-utils/lsfd.1.adoc:141
16690 msgid "BPF-MAP.TYPE.RAW <``number``>"
16693 #. type: Plain text
16694 #: ../misc-utils/lsfd.1.adoc:143
16695 msgid "Bpf map type (raw)."
16698 #. type: Labeled list
16699 #: ../misc-utils/lsfd.1.adoc:144
16701 #| msgid "*ENV_PATH* (string)"
16702 msgid "BPF.NAME <``string``>"
16703 msgstr "*ENV_PATH* (řetězec)"
16705 #. type: Plain text
16706 #: ../misc-utils/lsfd.1.adoc:146
16707 msgid "Bpf object name."
16710 #. type: Labeled list
16711 #: ../misc-utils/lsfd.1.adoc:147
16713 msgid "BPF-PROG.ID <``number``>"
16716 #. type: Plain text
16717 #: ../misc-utils/lsfd.1.adoc:149
16718 msgid "Bpf program ID."
16721 #. type: Labeled list
16722 #: ../misc-utils/lsfd.1.adoc:150
16724 #| msgid "*ENV_PATH* (string)"
16725 msgid "BPF-PROG.TYPE <``string``>"
16726 msgstr "*ENV_PATH* (řetězec)"
16728 #. type: Plain text
16729 #: ../misc-utils/lsfd.1.adoc:152
16730 msgid "Decoded name of bpf program type."
16733 #. type: Labeled list
16734 #: ../misc-utils/lsfd.1.adoc:153
16736 msgid "BPF-PROG.TYPE.RAW <``number``>"
16739 #. type: Plain text
16740 #: ../misc-utils/lsfd.1.adoc:155
16741 msgid "Bpf program type (raw)."
16744 #. type: Labeled list
16745 #: ../misc-utils/lsfd.1.adoc:156
16747 msgid "CHRDRV <``string``>"
16750 #. type: Plain text
16751 #: ../misc-utils/lsfd.1.adoc:158
16752 msgid "Character device driver name resolved by `/proc/devices`."
16755 #. type: Labeled list
16756 #: ../misc-utils/lsfd.1.adoc:159
16758 msgid "COMMAND <``string``>"
16761 #. type: Plain text
16762 #: ../misc-utils/lsfd.1.adoc:161
16763 msgid "Command of the process opening the file."
16766 #. type: Labeled list
16767 #: ../misc-utils/lsfd.1.adoc:162
16769 msgid "DELETED <``boolean``>"
16772 #. type: Plain text
16773 #: ../misc-utils/lsfd.1.adoc:164
16774 msgid "Reachability from the file system."
16777 #. type: Labeled list
16778 #: ../misc-utils/lsfd.1.adoc:165
16780 msgid "DEV <``string``>"
16783 #. type: Plain text
16784 #: ../misc-utils/lsfd.1.adoc:167
16785 msgid "ID of the device containing the file."
16788 #. type: Labeled list
16789 #: ../misc-utils/lsfd.1.adoc:168
16791 msgid "DEVTYPE <``string``>"
16794 #. type: Plain text
16795 #: ../misc-utils/lsfd.1.adoc:170
16796 msgid "Device type (`blk`, `char`, or `nodev`)."
16799 #. type: Labeled list
16800 #: ../misc-utils/lsfd.1.adoc:171
16802 msgid "ENDPOINT <``string``>"
16805 #. type: Plain text
16806 #: ../misc-utils/lsfd.1.adoc:173
16807 msgid "IPC endpoints information communicated with the fd."
16810 #. type: Plain text
16811 #: ../misc-utils/lsfd.1.adoc:177
16814 "*lsfd* collects endpoints within the processes that\n"
16815 "*lsfd* scans; *lsfd* may miss some endpoints\n"
16816 "if you limits the processes with *-p* option.\n"
16819 #. type: Plain text
16820 #: ../misc-utils/lsfd.1.adoc:180
16821 msgid "The format of the column depends on the object associated with the fd:"
16824 #. type: Labeled list
16825 #: ../misc-utils/lsfd.1.adoc:181
16830 #. type: Labeled list
16831 #: ../misc-utils/lsfd.1.adoc:182
16833 msgid "mqueue type"
16836 #. type: Labeled list
16837 #: ../misc-utils/lsfd.1.adoc:183
16839 msgid "ptmx and pts sources"
16842 #. type: Plain text
16843 #: ../misc-utils/lsfd.1.adoc:185
16844 msgid "_PID_,_COMMAND_,_ASSOC_[-r][-w]"
16847 #. type: Plain text
16848 #: ../misc-utils/lsfd.1.adoc:188
16850 "The last characters ([-r][-w]) represents the read and/or write mode of the "
16854 #. type: Labeled list
16855 #: ../misc-utils/lsfd.1.adoc:189
16857 msgid "eventfd type"
16860 #. type: Plain text
16861 #: ../misc-utils/lsfd.1.adoc:191
16862 msgid "_PID_,_COMMAND_,_ASSOC_"
16865 #. type: Labeled list
16866 #: ../misc-utils/lsfd.1.adoc:192 ../misc-utils/lsfd.1.adoc:340
16868 msgid "UNIX-STREAM"
16871 #. type: Plain text
16872 #: ../misc-utils/lsfd.1.adoc:194
16873 msgid "_PID_,_COMMAND_,_ASSOC_[-r?][-w?]"
16876 #. type: Plain text
16877 #: ../misc-utils/lsfd.1.adoc:197
16879 "About the last characters ([-r?][-w?]), see the description of _SOCK."
16883 #. type: Labeled list
16884 #: ../misc-utils/lsfd.1.adoc:198
16886 msgid "EVENTFD.ID <``number``>"
16889 #. type: Plain text
16890 #: ../misc-utils/lsfd.1.adoc:200
16891 msgid "Eventfd ID."
16894 #. type: Labeled list
16895 #: ../misc-utils/lsfd.1.adoc:201
16897 #| msgid "*ENV_PATH* (string)"
16898 msgid "EVENTPOLL.TFDS <``string``>"
16899 msgstr "*ENV_PATH* (řetězec)"
16901 #. type: Plain text
16902 #: ../misc-utils/lsfd.1.adoc:203
16903 msgid "File descriptors targeted by the eventpoll file."
16906 #. type: Labeled list
16907 #: ../misc-utils/lsfd.1.adoc:204
16909 msgid "FD <``number``>"
16912 #. type: Plain text
16913 #: ../misc-utils/lsfd.1.adoc:206
16914 msgid "File descriptor for the file."
16917 #. type: Labeled list
16918 #: ../misc-utils/lsfd.1.adoc:207
16920 msgid "FLAGS <``string``>"
16923 #. type: Plain text
16924 #: ../misc-utils/lsfd.1.adoc:209
16925 msgid "Flags specified when opening the file."
16928 #. type: Labeled list
16929 #: ../misc-utils/lsfd.1.adoc:210
16931 msgid "FUID <``number``>"
16934 #. type: Plain text
16935 #: ../misc-utils/lsfd.1.adoc:212
16936 msgid "User ID number of the file's owner."
16939 #. type: Labeled list
16940 #: ../misc-utils/lsfd.1.adoc:213
16942 msgid "INET.LADDR <``string``>"
16945 #. type: Plain text
16946 #: ../misc-utils/lsfd.1.adoc:215
16947 msgid "Local IP address."
16950 #. type: Labeled list
16951 #: ../misc-utils/lsfd.1.adoc:216
16953 msgid "INET.RADDR <``string``>"
16956 #. type: Plain text
16957 #: ../misc-utils/lsfd.1.adoc:218
16958 msgid "Remote IP address."
16961 #. type: Labeled list
16962 #: ../misc-utils/lsfd.1.adoc:219
16964 msgid "INET6.LADDR <``string``>"
16967 #. type: Plain text
16968 #: ../misc-utils/lsfd.1.adoc:221
16969 msgid "Local IP6 address."
16972 #. type: Labeled list
16973 #: ../misc-utils/lsfd.1.adoc:222
16975 msgid "INET6.RADDR <``string``>"
16978 #. type: Plain text
16979 #: ../misc-utils/lsfd.1.adoc:224
16980 msgid "Remote IP6 address."
16983 #. type: Labeled list
16984 #: ../misc-utils/lsfd.1.adoc:225
16986 msgid "INODE <``number``>"
16989 #. type: Plain text
16990 #: ../misc-utils/lsfd.1.adoc:227
16991 msgid "Inode number."
16994 #. type: Labeled list
16995 #: ../misc-utils/lsfd.1.adoc:228
16997 #| msgid "*ENV_PATH* (string)"
16998 msgid "INOTIFY.INODES <``string``>"
16999 msgstr "*ENV_PATH* (řetězec)"
17001 #. type: Plain text
17002 #: ../misc-utils/lsfd.1.adoc:232
17004 "Cooked version of INOTIFY.INODES.RAW. The format of the element is _inode-"
17005 "number_,_source-of-inode_."
17008 #. type: Labeled list
17009 #: ../misc-utils/lsfd.1.adoc:233
17011 #| msgid "*ENV_PATH* (string)"
17012 msgid "INOTIFY.INODES.RAW <``string``>"
17013 msgstr "*ENV_PATH* (řetězec)"
17015 #. type: Plain text
17016 #: ../misc-utils/lsfd.1.adoc:236
17018 "List of monitoring inodes. The format of the element is _inode-number_,"
17019 "_device-major_:_device-minor_."
17022 #. type: Labeled list
17023 #: ../misc-utils/lsfd.1.adoc:237
17025 msgid "KNAME <``string``>"
17032 #. It seems that the manpage backend of asciidoctor has limitations
17033 #. about emitting text with nested face specifications like:
17035 #. Not only u but also p is decorated with underline.
17036 #. type: Plain text
17037 #: ../misc-utils/lsfd.1.adoc:248
17039 "Raw file name extracted from from ``/proc/``_pid_``/fd/``_fd_ or ``/proc/"
17040 "``_pid_``/map_files/``_region_."
17043 #. type: Labeled list
17044 #: ../misc-utils/lsfd.1.adoc:249
17046 msgid "KTHREAD <``boolean``>"
17049 #. type: Plain text
17050 #: ../misc-utils/lsfd.1.adoc:251
17051 msgid "Whether the process is a kernel thread or not."
17054 #. type: Labeled list
17055 #: ../misc-utils/lsfd.1.adoc:252
17057 msgid "MAJ:MIN <``string``>"
17060 #. type: Plain text
17061 #: ../misc-utils/lsfd.1.adoc:254
17062 msgid "Device ID for special, or ID of device containing file."
17065 #. type: Labeled list
17066 #: ../misc-utils/lsfd.1.adoc:255
17068 msgid "MAPLEN <``number``>"
17071 #. type: Plain text
17072 #: ../misc-utils/lsfd.1.adoc:257
17073 msgid "Length of file mapping (in page)."
17076 #. type: Labeled list
17077 #: ../misc-utils/lsfd.1.adoc:258
17079 msgid "MISCDEV <``string``>"
17082 #. type: Plain text
17083 #: ../misc-utils/lsfd.1.adoc:260
17084 msgid "Misc character device name resolved by `/proc/misc`."
17087 #. type: Labeled list
17088 #: ../misc-utils/lsfd.1.adoc:261
17090 msgid "MNTID <``number``>"
17093 #. type: Plain text
17094 #: ../misc-utils/lsfd.1.adoc:263
17098 #. type: Labeled list
17099 #: ../misc-utils/lsfd.1.adoc:264
17101 msgid "MODE <``string``>"
17104 #. type: Plain text
17105 #: ../misc-utils/lsfd.1.adoc:266
17106 msgid "Access mode (rwx)."
17109 #. type: Labeled list
17110 #: ../misc-utils/lsfd.1.adoc:267
17112 msgid "NAME <``string``>"
17115 #. type: Plain text
17116 #: ../misc-utils/lsfd.1.adoc:269
17117 msgid "Cooked version of KNAME. It is mostly same as KNAME."
17120 #. type: Plain text
17121 #: ../misc-utils/lsfd.1.adoc:271
17122 msgid "Some files have special formats and information sources:"
17125 #. type: Labeled list
17126 #: ../misc-utils/lsfd.1.adoc:272
17131 #. type: Plain text
17132 #: ../misc-utils/lsfd.1.adoc:274
17133 msgid "id=_BPF-MAP.ID_ type=_BPF-MAP.TYPE_[ name=_BPF.NAME_]"
17136 #. type: Labeled list
17137 #: ../misc-utils/lsfd.1.adoc:275
17142 #. type: Plain text
17143 #: ../misc-utils/lsfd.1.adoc:277
17144 msgid "id=_BPF-PROG.ID_ type=_BPF-PROG.TYPE_[ name=_BPF.NAME_]"
17147 #. type: Labeled list
17148 #: ../misc-utils/lsfd.1.adoc:278
17150 #| msgid "*comment*"
17154 #. type: Plain text
17155 #: ../misc-utils/lsfd.1.adoc:280
17156 msgid "tfds=_EVENTPOLL.TFDS_"
17159 #. type: Labeled list
17160 #: ../misc-utils/lsfd.1.adoc:281
17162 #| msgid "*comment*"
17166 #. type: Plain text
17167 #: ../misc-utils/lsfd.1.adoc:283
17168 msgid "id=_EVENTFD.ID_"
17171 #. type: Labeled list
17172 #: ../misc-utils/lsfd.1.adoc:284
17177 #. type: Plain text
17178 #: ../misc-utils/lsfd.1.adoc:286
17179 msgid "inodes=_INOTIFY.INODES_"
17182 #. type: Labeled list
17183 #: ../misc-utils/lsfd.1.adoc:287
17188 #. type: Plain text
17189 #: ../misc-utils/lsfd.1.adoc:289
17190 msgid "iface=_TUN.IFACE_"
17193 #. type: Labeled list
17194 #: ../misc-utils/lsfd.1.adoc:290
17199 #. type: Plain text
17200 #: ../misc-utils/lsfd.1.adoc:292
17202 "protocol=_NETLINK.PROTOCOL_[ lport=_NETLINK.LPORT_[ group=_NETLINK.GROUPS_]]"
17205 #. type: Labeled list
17206 #: ../misc-utils/lsfd.1.adoc:293
17211 #. type: Plain text
17212 #: ../misc-utils/lsfd.1.adoc:295
17213 msgid "type=_SOCK.TYPE_[ protocol=_PACKET.PROTOCOL_][ iface=_PACKET.IFACE_]"
17216 #. type: Labeled list
17217 #: ../misc-utils/lsfd.1.adoc:296
17222 #. type: Plain text
17223 #: ../misc-utils/lsfd.1.adoc:298
17224 msgid "pid=_TARGET-PID_ comm=_TARGET-COMMAND_ nspid=_TARGET-NSPIDS_"
17227 #. type: Plain text
17228 #: ../misc-utils/lsfd.1.adoc:301
17231 "*lsfd* extracts _TARGET-PID_ and _TARGET-NSPIDS_ from\n"
17232 "``/proc/``_pid_``/fdinfo/``_fd_.\n"
17235 #. type: Labeled list
17236 #: ../misc-utils/lsfd.1.adoc:302
17241 #. type: Plain text
17242 #: ../misc-utils/lsfd.1.adoc:304
17244 "state=_SOCK.STATE_[ id=_PING.ID_][ laddr=_INET.LADDR_ [ raddr=_INET.RADDR_]]"
17247 #. type: Labeled list
17248 #: ../misc-utils/lsfd.1.adoc:305
17253 #. type: Plain text
17254 #: ../misc-utils/lsfd.1.adoc:307
17256 "state=_SOCK.STATE_[ id=_PING.ID_][ laddr=_INET6.LADDR_ [ raddr=_INET6."
17260 #. type: Labeled list
17261 #: ../misc-utils/lsfd.1.adoc:308
17266 #. type: Plain text
17267 #: ../misc-utils/lsfd.1.adoc:310
17268 msgid "tty-index=_PTMX.TTY-INDEX_"
17271 #. type: Plain text
17272 #: ../misc-utils/lsfd.1.adoc:313
17275 "*lsfd* extracts _PTMX.TTY-INDEX_ from\n"
17276 "``/proc/``_pid_``/fdinfo/``_fd_.\n"
17279 #. type: Labeled list
17280 #: ../misc-utils/lsfd.1.adoc:314
17285 #. type: Plain text
17286 #: ../misc-utils/lsfd.1.adoc:316
17288 "state=_SOCK.STATE_[ protocol=_RAW.PROTOCOL_ [ laddr=_INET.LADDR_ "
17289 "[ raddr=_INET.RADDR_]]]"
17292 #. type: Labeled list
17293 #: ../misc-utils/lsfd.1.adoc:317
17298 #. type: Plain text
17299 #: ../misc-utils/lsfd.1.adoc:319
17301 "state=_SOCK.STATE_[ protocol=_RAW.PROTOCOL_ [ laddr=_INET6.LADDR_ "
17302 "[ raddr=_INET6.RADDR_]]]"
17305 #. type: Labeled list
17306 #: ../misc-utils/lsfd.1.adoc:320
17311 #. type: Plain text
17312 #: ../misc-utils/lsfd.1.adoc:322
17313 msgid "mask=_SIGNALFD.MASK_"
17316 #. type: Labeled list
17317 #: ../misc-utils/lsfd.1.adoc:323
17322 #. type: Labeled list
17323 #: ../misc-utils/lsfd.1.adoc:324
17328 #. type: Plain text
17329 #: ../misc-utils/lsfd.1.adoc:326
17330 msgid "state=_SOCK.STATE_[ laddr=_TCP.LADDR_ [ raddr=_TCP.RADDR_]]"
17333 #. type: Labeled list
17334 #: ../misc-utils/lsfd.1.adoc:327
17339 #. type: Plain text
17340 #: ../misc-utils/lsfd.1.adoc:329
17342 "clockid=_TIMERFD.CLOCKID_[ remaining=_TIMERFD.REMAINING_ [ interval=_TIMERFD."
17346 #. type: Labeled list
17347 #: ../misc-utils/lsfd.1.adoc:330
17352 #. type: Labeled list
17353 #: ../misc-utils/lsfd.1.adoc:331
17358 #. type: Plain text
17359 #: ../misc-utils/lsfd.1.adoc:333
17360 msgid "state=_SOCK.STATE_[ laddr=_UDP.LADDR_ [ raddr=_UDP.RADDR_]]"
17363 #. type: Plain text
17364 #: ../misc-utils/lsfd.1.adoc:335
17366 msgid "*lsfd* hides ``raddr=`` if _UDP.RADDR_ is ``0.0.0.0`` and _UDP.RPORT_ is 0.\n"
17369 #. type: Labeled list
17370 #: ../misc-utils/lsfd.1.adoc:336
17375 #. type: Labeled list
17376 #: ../misc-utils/lsfd.1.adoc:337
17381 #. type: Plain text
17382 #: ../misc-utils/lsfd.1.adoc:339
17383 msgid "state=_SOCK.STATE_[ laddr=_UDPLITE.LADDR_ [ raddr=_UDPLITE.RADDR_]]"
17386 #. type: Plain text
17387 #: ../misc-utils/lsfd.1.adoc:342
17388 msgid "state=_SOCK.STATE_[ path=_UNIX.PATH_]"
17391 #. type: Labeled list
17392 #: ../misc-utils/lsfd.1.adoc:343
17397 #. type: Plain text
17398 #: ../misc-utils/lsfd.1.adoc:345
17399 msgid "state=_SOCK.STATE_[ path=_UNIX.PATH_] type=_SOCK.TYPE_"
17402 #. type: delimited block _
17403 #: ../misc-utils/lsfd.1.adoc:350
17405 "Note that `(deleted)` markers are removed from this column. Refer to "
17406 "_KNAME_, _DELETED_, or _XMODE_ to know the readability of the file from the "
17410 #. type: Labeled list
17411 #: ../misc-utils/lsfd.1.adoc:352
17413 msgid "NETLINK.GROUPS <``number``>"
17416 #. type: Plain text
17417 #: ../misc-utils/lsfd.1.adoc:354
17418 msgid "Netlink multicast groups."
17421 #. type: Labeled list
17422 #: ../misc-utils/lsfd.1.adoc:355
17424 msgid "NETLINK.LPORT <``number``>"
17427 #. type: Plain text
17428 #: ../misc-utils/lsfd.1.adoc:357
17429 msgid "Netlink local port id."
17432 #. type: Labeled list
17433 #: ../misc-utils/lsfd.1.adoc:358
17435 #| msgid "*ENV_PATH* (string)"
17436 msgid "NETLINK.PROTOCOL <``string``>"
17437 msgstr "*ENV_PATH* (řetězec)"
17439 #. type: Plain text
17440 #: ../misc-utils/lsfd.1.adoc:360
17441 msgid "Netlink protocol."
17444 #. type: Labeled list
17445 #: ../misc-utils/lsfd.1.adoc:361
17447 msgid "NLINK <``number``>"
17450 #. type: Plain text
17451 #: ../misc-utils/lsfd.1.adoc:363
17452 msgid "Link count."
17455 #. type: Labeled list
17456 #: ../misc-utils/lsfd.1.adoc:364
17458 msgid "NS.NAME <``string``>"
17461 #. type: Plain text
17462 #: ../misc-utils/lsfd.1.adoc:366
17463 msgid "Name (_NS.TYPE_:[_INODE_]) of the namespace specified with the file."
17466 #. type: Labeled list
17467 #: ../misc-utils/lsfd.1.adoc:367
17469 msgid "NS.TYPE <``string``>"
17472 #. type: Plain text
17473 #: ../misc-utils/lsfd.1.adoc:371
17475 "Type of the namespace specified with the file. The type is `mnt`, `cgroup`, "
17476 "`uts`, `ipc`, `user`, `pid`, `net`, `time`, or `unknown`."
17479 #. type: Labeled list
17480 #: ../misc-utils/lsfd.1.adoc:372
17482 msgid "OWNER <``string``>"
17485 #. type: Plain text
17486 #: ../misc-utils/lsfd.1.adoc:374
17487 msgid "Owner of the file."
17490 #. type: Labeled list
17491 #: ../misc-utils/lsfd.1.adoc:375
17493 msgid "PACKET.IFACE <``string``>"
17496 #. type: Plain text
17497 #: ../misc-utils/lsfd.1.adoc:377
17498 msgid "Interface name associated with the packet socket."
17501 #. type: Labeled list
17502 #: ../misc-utils/lsfd.1.adoc:378
17504 msgid "PACKET.PROTOCOL <``string``>"
17507 #. type: Plain text
17508 #: ../misc-utils/lsfd.1.adoc:380
17509 msgid "L3 protocol associated with the packet socket."
17512 #. type: Labeled list
17513 #: ../misc-utils/lsfd.1.adoc:381
17515 msgid "PARTITION <``string``>"
17518 #. type: Plain text
17519 #: ../misc-utils/lsfd.1.adoc:383
17520 msgid "Block device name resolved by `/proc/partition`."
17523 #. type: Labeled list
17524 #: ../misc-utils/lsfd.1.adoc:384
17526 msgid "PID <``number``>"
17529 #. type: Plain text
17530 #: ../misc-utils/lsfd.1.adoc:386
17531 msgid "PID of the process opening the file."
17534 #. type: Labeled list
17535 #: ../misc-utils/lsfd.1.adoc:387
17537 msgid "PIDFD.COMM <``string``>"
17540 #. type: Plain text
17541 #: ../misc-utils/lsfd.1.adoc:389
17542 msgid "Command of the process targeted by the pidfd."
17545 #. type: Labeled list
17546 #: ../misc-utils/lsfd.1.adoc:390
17548 msgid "PIDFD.NSPID <``string``>"
17551 #. type: Plain text
17552 #: ../misc-utils/lsfd.1.adoc:392
17553 msgid "Value of NSpid field in ``/proc/``_pid_``/fdinfo/``_fd_ of the pidfd."
17556 #. type: Plain text
17557 #: ../misc-utils/lsfd.1.adoc:394
17558 msgid "Quoted from kernel/fork.c of Linux source tree:"
17561 #. type: delimited block _
17562 #: ../misc-utils/lsfd.1.adoc:400
17564 "If pid namespaces are supported then this function will also print the pid "
17565 "of a given pidfd refers to for all descendant pid namespaces starting from "
17566 "the current pid namespace of the instance, i.e. the Pid field and the first "
17567 "entry in the NSpid field will be identical."
17570 #. type: delimited block _
17571 #: ../misc-utils/lsfd.1.adoc:404
17573 "Note that this differs from the Pid and NSpid fields in /proc/<pid>/status "
17574 "where Pid and NSpid are always shown relative to the pid namespace of the "
17578 #. type: Labeled list
17579 #: ../misc-utils/lsfd.1.adoc:406
17581 msgid "PIDFD.PID <``number``>"
17584 #. type: Plain text
17585 #: ../misc-utils/lsfd.1.adoc:408
17586 msgid "PID of the process targeted by the pidfd."
17589 #. type: Labeled list
17590 #: ../misc-utils/lsfd.1.adoc:409
17592 msgid "PING.ID <`number`>"
17595 #. type: Plain text
17596 #: ../misc-utils/lsfd.1.adoc:411
17597 msgid "ICMP echo request id used on the PING socket."
17600 #. type: Labeled list
17601 #: ../misc-utils/lsfd.1.adoc:412
17603 msgid "POS <``number``>"
17606 #. type: Plain text
17607 #: ../misc-utils/lsfd.1.adoc:414
17608 msgid "File position."
17611 #. type: Labeled list
17612 #: ../misc-utils/lsfd.1.adoc:415
17614 msgid "RAW.PROTOCOL <``number``>"
17617 #. type: Plain text
17618 #: ../misc-utils/lsfd.1.adoc:417
17619 msgid "Protocol number of the raw socket."
17622 #. type: Labeled list
17623 #: ../misc-utils/lsfd.1.adoc:418
17625 msgid "RDEV <``string``>"
17628 #. type: Plain text
17629 #: ../misc-utils/lsfd.1.adoc:420
17630 msgid "Device ID (if special file)."
17633 #. type: Labeled list
17634 #: ../misc-utils/lsfd.1.adoc:421
17636 #| msgid "*ENV_PATH* (string)"
17637 msgid "SIGNALFD.MASK <``string``>"
17638 msgstr "*ENV_PATH* (řetězec)"
17640 #. type: Plain text
17641 #: ../misc-utils/lsfd.1.adoc:423
17642 msgid "Masked signals."
17645 #. type: Labeled list
17646 #: ../misc-utils/lsfd.1.adoc:424
17648 msgid "SIZE <``number``>"
17651 #. type: Plain text
17652 #: ../misc-utils/lsfd.1.adoc:426
17656 #. type: Labeled list
17657 #: ../misc-utils/lsfd.1.adoc:427
17659 msgid "SOCK.LISTENING <``boolean``>"
17662 #. type: Plain text
17663 #: ../misc-utils/lsfd.1.adoc:429
17664 msgid "Listening socket."
17667 #. type: Labeled list
17668 #: ../misc-utils/lsfd.1.adoc:430
17670 msgid "SOCK.NETS <``number``>"
17673 #. type: Plain text
17674 #: ../misc-utils/lsfd.1.adoc:432
17675 msgid "Inode identifying network namespace where the socket belongs to."
17678 #. type: Labeled list
17679 #: ../misc-utils/lsfd.1.adoc:433
17681 msgid "SOCK.PROTONAME <``string``>"
17684 #. type: Plain text
17685 #: ../misc-utils/lsfd.1.adoc:435
17686 msgid "Protocol name."
17689 #. type: Labeled list
17690 #: ../misc-utils/lsfd.1.adoc:436
17692 #| msgid "*ENV_PATH* (string)"
17693 msgid "SOCK.SHUTDOWN <``string``>"
17694 msgstr "*ENV_PATH* (řetězec)"
17696 #. type: Plain text
17697 #: ../misc-utils/lsfd.1.adoc:438
17698 msgid "Shutdown state of socket."
17701 #. type: Labeled list
17702 #: ../misc-utils/lsfd.1.adoc:439
17707 #. type: Plain text
17708 #: ../misc-utils/lsfd.1.adoc:443
17710 "If the first character is _r_, the receptions are allowed. If it is _-_, "
17711 "the receptions are disallowed. If it is _?_, the state is unknown."
17714 #. type: Labeled list
17715 #: ../misc-utils/lsfd.1.adoc:444
17720 #. type: Plain text
17721 #: ../misc-utils/lsfd.1.adoc:448
17723 "If the second character is _w_, the transmissions are allowed. If it is _-"
17724 "_, the transmissions are disallowed. If it is _?_, the state is unknown."
17727 #. type: Labeled list
17728 #: ../misc-utils/lsfd.1.adoc:449
17730 msgid "SOCK.STATE <``string``>"
17733 #. type: Plain text
17734 #: ../misc-utils/lsfd.1.adoc:451
17735 msgid "State of socket."
17738 #. type: Labeled list
17739 #: ../misc-utils/lsfd.1.adoc:452
17741 msgid "SOCK.TYPE <``string``>"
17744 #. type: Plain text
17745 #: ../misc-utils/lsfd.1.adoc:455
17747 "Type of socket. Here type means the second parameter of socket system call:"
17750 #. type: Plain text
17751 #: ../misc-utils/lsfd.1.adoc:457
17755 #. type: Plain text
17756 #: ../misc-utils/lsfd.1.adoc:458
17760 #. type: Plain text
17761 #: ../misc-utils/lsfd.1.adoc:459
17765 #. type: Plain text
17766 #: ../misc-utils/lsfd.1.adoc:460
17770 #. type: Plain text
17771 #: ../misc-utils/lsfd.1.adoc:461
17775 #. type: Plain text
17776 #: ../misc-utils/lsfd.1.adoc:462
17780 #. type: Plain text
17781 #: ../misc-utils/lsfd.1.adoc:463
17785 #. type: Labeled list
17786 #: ../misc-utils/lsfd.1.adoc:464
17788 msgid "SOURCE <``string``>"
17791 #. type: Plain text
17792 #: ../misc-utils/lsfd.1.adoc:466
17793 msgid "File system, partition, or device containing the file."
17796 #. type: Labeled list
17797 #: ../misc-utils/lsfd.1.adoc:467
17799 #| msgid "*ENV_PATH* (string)"
17800 msgid "STTYPE <``string``>"
17801 msgstr "*ENV_PATH* (řetězec)"
17803 #. type: Plain text
17804 #: ../misc-utils/lsfd.1.adoc:469
17806 "Raw file types returned from *stat*(2): BLK, CHR, DIR, FIFO, LINK, REG, "
17810 #. type: Labeled list
17811 #: ../misc-utils/lsfd.1.adoc:470
17813 msgid "TCP.LADDR <``string``>"
17816 #. type: Plain text
17817 #: ../misc-utils/lsfd.1.adoc:472
17818 msgid "Local L3 (INET.LADDR or INET6.LADDR) address and local TCP port."
17821 #. type: Labeled list
17822 #: ../misc-utils/lsfd.1.adoc:473
17824 msgid "TCP.LPORT <``number``>"
17827 #. type: Plain text
17828 #: ../misc-utils/lsfd.1.adoc:475
17829 msgid "Local TCP port."
17832 #. type: Labeled list
17833 #: ../misc-utils/lsfd.1.adoc:476
17835 msgid "TCP.RADDR <``string``>"
17838 #. type: Plain text
17839 #: ../misc-utils/lsfd.1.adoc:478
17840 msgid "Remote L3 (INET.RADDR or INET6.RADDR) address and remote TCP port."
17843 #. type: Labeled list
17844 #: ../misc-utils/lsfd.1.adoc:479
17846 msgid "TCP.RPORT <``number``>"
17849 #. type: Plain text
17850 #: ../misc-utils/lsfd.1.adoc:481
17851 msgid "Remote TCP port."
17854 #. type: Labeled list
17855 #: ../misc-utils/lsfd.1.adoc:482
17857 msgid "TID <``number``>"
17860 #. type: Plain text
17861 #: ../misc-utils/lsfd.1.adoc:484
17862 msgid "Thread ID of the process opening the file."
17865 #. type: Labeled list
17866 #: ../misc-utils/lsfd.1.adoc:485
17868 #| msgid "*ENV_PATH* (string)"
17869 msgid "TIMERFD.CLOCKID <``string``>"
17870 msgstr "*ENV_PATH* (řetězec)"
17872 #. type: Plain text
17873 #: ../misc-utils/lsfd.1.adoc:487
17877 #. type: Labeled list
17878 #: ../misc-utils/lsfd.1.adoc:488
17880 msgid "TIMERFD.INTERVAL <``number``>"
17883 #. type: Plain text
17884 #: ../misc-utils/lsfd.1.adoc:490
17888 #. type: Labeled list
17889 #: ../misc-utils/lsfd.1.adoc:491
17891 msgid "TIMERFD.REMAINING <``number``>"
17894 #. type: Plain text
17895 #: ../misc-utils/lsfd.1.adoc:493
17896 msgid "Remaining time."
17899 #. type: Labeled list
17900 #: ../misc-utils/lsfd.1.adoc:494
17902 msgid "PTMX.TTY-INDEX <``number``>"
17905 #. type: Plain text
17906 #: ../misc-utils/lsfd.1.adoc:496
17907 msgid "TTY index of the counterpart."
17910 #. type: Labeled list
17911 #: ../misc-utils/lsfd.1.adoc:497
17913 #| msgid "*ENV_PATH* (string)"
17914 msgid "TUN.IFACE <``string``>"
17915 msgstr "*ENV_PATH* (řetězec)"
17917 #. type: Plain text
17918 #: ../misc-utils/lsfd.1.adoc:499
17919 msgid "Network intrface behind the tun device."
17922 #. type: Labeled list
17923 #: ../misc-utils/lsfd.1.adoc:500
17925 #| msgid "*ENV_PATH* (string)"
17926 msgid "TYPE <``string``>"
17927 msgstr "*ENV_PATH* (řetězec)"
17929 #. type: Plain text
17930 #: ../misc-utils/lsfd.1.adoc:504
17932 "Cooked version of STTYPE. It is same as STTYPE with exceptions. For SOCK, "
17933 "print the value for SOCK.PROTONAME. For UNKN, print the value for "
17934 "AINODECLASS if SOURCE is anon_inodefs."
17937 #. type: Labeled list
17938 #: ../misc-utils/lsfd.1.adoc:505
17940 msgid "UDP.LADDR <``string``>"
17943 #. type: Plain text
17944 #: ../misc-utils/lsfd.1.adoc:507
17945 msgid "Local IP address and local UDP port."
17948 #. type: Labeled list
17949 #: ../misc-utils/lsfd.1.adoc:508
17951 msgid "UDP.LPORT <``number``>"
17954 #. type: Plain text
17955 #: ../misc-utils/lsfd.1.adoc:510 ../misc-utils/lsfd.1.adoc:522
17956 msgid "Local UDP port."
17959 #. type: Labeled list
17960 #: ../misc-utils/lsfd.1.adoc:511
17962 msgid "UDP.RADDR <``string``>"
17965 #. type: Plain text
17966 #: ../misc-utils/lsfd.1.adoc:513
17967 msgid "Remote IP address and remote UDP port."
17970 #. type: Labeled list
17971 #: ../misc-utils/lsfd.1.adoc:514
17973 msgid "UDP.RPORT <``number``>"
17976 #. type: Plain text
17977 #: ../misc-utils/lsfd.1.adoc:516 ../misc-utils/lsfd.1.adoc:528
17978 msgid "Remote UDP port."
17981 #. type: Labeled list
17982 #: ../misc-utils/lsfd.1.adoc:517
17984 msgid "UDPLITE.LADDR <``string``>"
17987 #. type: Plain text
17988 #: ../misc-utils/lsfd.1.adoc:519
17989 msgid "Local IP address and local UDPLite port."
17992 #. type: Labeled list
17993 #: ../misc-utils/lsfd.1.adoc:520
17995 msgid "UDPLITE.LPORT <``number``>"
17998 #. type: Labeled list
17999 #: ../misc-utils/lsfd.1.adoc:523
18001 msgid "UDPLITE.RADDR <``string``>"
18004 #. type: Plain text
18005 #: ../misc-utils/lsfd.1.adoc:525
18006 msgid "Remote IP address and remote UDPLite port."
18009 #. type: Labeled list
18010 #: ../misc-utils/lsfd.1.adoc:526
18012 msgid "UDPLITE.RPORT <``number``>"
18015 #. type: Labeled list
18016 #: ../misc-utils/lsfd.1.adoc:529
18018 msgid "UID <``number``>"
18021 #. type: Plain text
18022 #: ../misc-utils/lsfd.1.adoc:531
18023 msgid "User ID number."
18026 #. type: Labeled list
18027 #: ../misc-utils/lsfd.1.adoc:532
18029 msgid "UNIX.PATH <``string``>"
18032 #. type: Plain text
18033 #: ../misc-utils/lsfd.1.adoc:534
18034 msgid "Filesystem pathname for UNIX domain socket."
18037 #. type: Labeled list
18038 #: ../misc-utils/lsfd.1.adoc:535
18040 msgid "USER <``string``>"
18043 #. type: Plain text
18044 #: ../misc-utils/lsfd.1.adoc:537
18045 msgid "User of the process."
18048 #. type: Labeled list
18049 #: ../misc-utils/lsfd.1.adoc:538
18051 #| msgid "*ENV_PATH* (string)"
18052 msgid "XMODE <``string``>"
18053 msgstr "*ENV_PATH* (řetězec)"
18055 #. type: Plain text
18056 #: ../misc-utils/lsfd.1.adoc:542
18058 "Extended version of _MODE_. This column may grow; new letters may be "
18059 "appended to _XMODE_ when *lsfd* supports a new state of file descriptors and/"
18060 "or memory mappings."
18063 #. type: Labeled list
18064 #: ../misc-utils/lsfd.1.adoc:543
18069 #. type: Plain text
18070 #: ../misc-utils/lsfd.1.adoc:545
18071 msgid "opened of mapped for reading. This is also in _MODE_."
18074 #. type: Labeled list
18075 #: ../misc-utils/lsfd.1.adoc:546
18080 #. type: Plain text
18081 #: ../misc-utils/lsfd.1.adoc:548
18082 msgid "opened of mapped for writing. This is also in _MODE_."
18085 #. type: Labeled list
18086 #: ../misc-utils/lsfd.1.adoc:549
18091 #. type: Plain text
18092 #: ../misc-utils/lsfd.1.adoc:551
18093 msgid "mapped for executing the code. This is also in _MODE_."
18096 #. type: Labeled list
18097 #: ../misc-utils/lsfd.1.adoc:552
18102 #. type: Plain text
18103 #: ../misc-utils/lsfd.1.adoc:554
18104 msgid "deleted from the file system. See also _DELETED._."
18107 #. type: Labeled list
18108 #: ../misc-utils/lsfd.1.adoc:555
18113 #. type: Plain text
18114 #: ../misc-utils/lsfd.1.adoc:560
18116 "locked or leased. _l_ represents a read, a shared lock or a read lease. _L_ "
18117 "represents a write or an exclusive lock or a write lease. If both read/"
18118 "shared and write/exclusive locks or leases are taken by a file descriptor, "
18119 "_L_ is used as the flag."
18122 #. type: Labeled list
18123 #: ../misc-utils/lsfd.1.adoc:561
18128 #. type: Plain text
18129 #: ../misc-utils/lsfd.1.adoc:568
18131 "Multiplexed. If the file descriptor is targeted by a eventpoll file or "
18132 "classical system calls for multiplexing (select, pselect, poll, and ppoll), "
18133 "this bit flag is set. Note that if an invocaiton of the classical system "
18134 "calls is interrupted, *lsfd* may fail to mark _m_ on the file descriptors "
18135 "monitored by the invocaiton. See *restart_syscall*(2)."
18139 #: ../misc-utils/lsfd.1.adoc:569
18141 msgid "FILTER EXPRESSION"
18144 #. type: Plain text
18145 #: ../misc-utils/lsfd.1.adoc:574
18148 "*lsfd* evaluates the expression passed to *--filter* option every time\n"
18149 "before printing a file line. *lsfd* prints the line only if the result\n"
18150 "of evaluation is `true`.\n"
18153 #. type: Plain text
18154 #: ../misc-utils/lsfd.1.adoc:580
18156 "An expression consists of column names, literals and, operators like: "
18157 "`DELETED`, `(PID == 1)`, `(NAME == \"/etc/passwd\")`, `(PID == 1) && "
18158 "DELETED`. `DELETED`, `PID`, and `NAME` are column names in the example. "
18159 "`1` and \"/etc/passwd\" are literals. `==` and `&&` are operators."
18162 #. type: Plain text
18163 #: ../misc-utils/lsfd.1.adoc:588
18165 "Before evaluation, *lsfd* substitutes column names in the given expression "
18166 "with actual column values in the line. There are three different data types: "
18167 "`boolean`, `string`, and `number`. For columns with a `boolean` type, the "
18168 "value can be stand-alone. For `string` and `number` values, the value must "
18169 "be an operand of an operator, for example, `(PID == 1)`. See *OUTPUT "
18170 "COLUMNS* about the types of columns."
18173 #. type: Plain text
18174 #: ../misc-utils/lsfd.1.adoc:591
18176 "Literal is for representing a value directly. See BOOLLIT, STRLIT, and "
18177 "NUMLIT. Different data types have different literal syntax."
18180 #. type: Plain text
18181 #: ../misc-utils/lsfd.1.adoc:595
18183 "An operator works with one or two operand(s). An operator has an expectation "
18184 "about the data type(s) of its operands. Giving an unexpected data type to an "
18185 "operator causes a syntax error."
18188 #. type: Plain text
18189 #: ../misc-utils/lsfd.1.adoc:599
18191 "Operators taking two operands are `and`, `or`, `eq`, `ne`, `le`, `lt`, `ge`, "
18192 "`gt`, `=~`, `!~`. Alphabetically named operators have C-language flavored "
18193 "aliases: `&&`, `||`, `==`, `!=`, `<`, `<=`, `>=`, and `>`."
18196 #. type: Plain text
18197 #: ../misc-utils/lsfd.1.adoc:601
18198 msgid "`!` is the only operator that takes one operand."
18201 #. type: Plain text
18202 #: ../misc-utils/lsfd.1.adoc:604
18204 "`eq`, `ne`, and their aliases expect operands have the same data type. "
18205 "Applying these operators return a `boolean`."
18208 #. type: Plain text
18209 #: ../misc-utils/lsfd.1.adoc:607
18211 "`and`, `or`, `not` and their aliases expect operands have `boolean` data "
18212 "type. Applying these operators return a `boolean`."
18215 #. type: Plain text
18216 #: ../misc-utils/lsfd.1.adoc:610
18218 "`lt`, `le`, `gt`, `ge`, and their aliases expect operands have `number` data "
18219 "types. Applying these operators return a `boolean`."
18222 #. type: Plain text
18223 #: ../misc-utils/lsfd.1.adoc:615
18225 "`=~` is for regular expression matching; if a string at the right side "
18226 "matches a regular expression at the left side, the result is true. The "
18227 "right side operand must be a string literal. See STRLIT about the syntax."
18230 #. type: Plain text
18231 #: ../misc-utils/lsfd.1.adoc:618
18233 "`!~` is a short-hand version of `not (STR =~ PAT)`; it inverts the result of "
18238 #: ../misc-utils/lsfd.1.adoc:619
18240 msgid "Limitations"
18243 #. type: Plain text
18244 #: ../misc-utils/lsfd.1.adoc:624
18246 "The current implementation does not define precedences within operators. "
18247 "Use `(` and `)` explicitly for grouping the sub-expressions if your "
18248 "expression uses more than two operators."
18251 #. type: Plain text
18252 #: ../misc-utils/lsfd.1.adoc:627
18254 "About `number` typed values, the filter engine supports only non-negative "
18255 "integers, and non-negative floating point numbers."
18259 #: ../misc-utils/lsfd.1.adoc:628
18261 msgid "Semi-formal syntax"
18264 #. TRANSLATORS: In the following messages, translate only the <``variables``>.
18265 #. type: Labeled list
18266 #: ../misc-utils/lsfd.1.adoc:631
18271 #. type: Plain text
18272 #: ../misc-utils/lsfd.1.adoc:632
18276 #. type: Labeled list
18277 #: ../misc-utils/lsfd.1.adoc:633
18282 #. type: Plain text
18283 #: ../misc-utils/lsfd.1.adoc:634
18284 msgid "COLUMN <``boolean``> | BOOLLIT | _(_ BOOLEXP _)_"
18287 #. type: Labeled list
18288 #: ../misc-utils/lsfd.1.adoc:635
18293 #. type: Plain text
18294 #: ../misc-utils/lsfd.1.adoc:636
18295 msgid "BOOLEXP0 | BOOLOP1 | BOOLOP2 | BOOLOP2BL | BOOLOP2CMP | BOOLOP2REG"
18298 #. type: Labeled list
18299 #: ../misc-utils/lsfd.1.adoc:637
18304 #. type: Plain text
18305 #: ../misc-utils/lsfd.1.adoc:638
18306 msgid "[\\_A-Za-z][-_:A-Za-z0-9]*"
18309 #. type: Labeled list
18310 #: ../misc-utils/lsfd.1.adoc:639
18315 #. type: Plain text
18316 #: ../misc-utils/lsfd.1.adoc:640
18317 msgid "_!_ BOOLEXP0 | _not_ BOOLEXP0"
18320 #. type: Labeled list
18321 #: ../misc-utils/lsfd.1.adoc:641
18326 #. type: Plain text
18327 #: ../misc-utils/lsfd.1.adoc:642
18328 msgid "COLUMN <``string``> | STRLIT"
18331 #. type: Labeled list
18332 #: ../misc-utils/lsfd.1.adoc:643
18337 #. type: Plain text
18338 #: ../misc-utils/lsfd.1.adoc:644
18339 msgid "COLUMN <``number``> | NUMLIT"
18342 #. type: Labeled list
18343 #: ../misc-utils/lsfd.1.adoc:645
18348 #. type: Plain text
18349 #: ../misc-utils/lsfd.1.adoc:646
18350 msgid "_true_ | _false_"
18353 #. type: Labeled list
18354 #: ../misc-utils/lsfd.1.adoc:647
18359 #. type: Plain text
18360 #: ../misc-utils/lsfd.1.adoc:648
18361 msgid "( [^\\] | _\\\\_ | _\\'_ | _\\\"_ )*"
18364 #. type: Labeled list
18365 #: ../misc-utils/lsfd.1.adoc:649
18370 #. type: Plain text
18371 #: ../misc-utils/lsfd.1.adoc:650
18372 msgid "_'_ CHARS _'_ | _\"_ CHARS _\"_"
18375 #. type: Labeled list
18376 #: ../misc-utils/lsfd.1.adoc:651
18381 #. type: Plain text
18382 #: ../misc-utils/lsfd.1.adoc:652
18383 msgid "INTLIT | FNUMLIT"
18386 #. type: Labeled list
18387 #: ../misc-utils/lsfd.1.adoc:653
18392 #. type: Plain text
18393 #: ../misc-utils/lsfd.1.adoc:654
18394 msgid "[1-9][0-9]* | _0_"
18397 #. type: Labeled list
18398 #: ../misc-utils/lsfd.1.adoc:655
18403 #. type: Plain text
18404 #: ../misc-utils/lsfd.1.adoc:656
18405 msgid "INTLIT _._ [0-9][0-9]*"
18408 #. type: Labeled list
18409 #: ../misc-utils/lsfd.1.adoc:657
18414 #. type: Plain text
18415 #: ../misc-utils/lsfd.1.adoc:658
18416 msgid "STREXP OP2 STREXP | NUMEXP OP2 NUMEXP | BOOLEXP0 OP2 BOOLEXP0"
18419 #. type: Labeled list
18420 #: ../misc-utils/lsfd.1.adoc:659
18425 #. type: Plain text
18426 #: ../misc-utils/lsfd.1.adoc:660
18427 msgid "_==_ | _eq_ | _!=_ | _ne_"
18430 #. type: Labeled list
18431 #: ../misc-utils/lsfd.1.adoc:661
18436 #. type: Plain text
18437 #: ../misc-utils/lsfd.1.adoc:662
18438 msgid "BOOLEXP0 OP2BL BOOLEXP0"
18441 #. type: Labeled list
18442 #: ../misc-utils/lsfd.1.adoc:663
18447 #. type: Plain text
18448 #: ../misc-utils/lsfd.1.adoc:664
18449 msgid "_&&_ | _and_ | _||_ | _or_"
18452 #. type: Labeled list
18453 #: ../misc-utils/lsfd.1.adoc:665
18455 msgid "BOOLOP2CMP "
18458 #. type: Plain text
18459 #: ../misc-utils/lsfd.1.adoc:666
18460 msgid "NUMEXP OP2CMP NUMEXP"
18463 #. type: Labeled list
18464 #: ../misc-utils/lsfd.1.adoc:667
18469 #. type: Plain text
18470 #: ../misc-utils/lsfd.1.adoc:668
18471 msgid "_<_ | _lt_ | _\\<=_ | _le_ | _>_ | _gt_ | _>=_ | _ge_"
18474 #. type: Labeled list
18475 #: ../misc-utils/lsfd.1.adoc:669
18477 msgid "BOOLOP2REG "
18480 #. type: Plain text
18481 #: ../misc-utils/lsfd.1.adoc:670
18482 msgid "STREXP OP2REG STRLIT"
18485 #. type: Labeled list
18486 #: ../misc-utils/lsfd.1.adoc:671
18491 #. type: Plain text
18492 #: ../misc-utils/lsfd.1.adoc:672
18493 msgid "_=~_ | _!~_"
18497 #: ../misc-utils/lsfd.1.adoc:673
18499 msgid "FILTER EXAMPLES"
18502 #. type: Plain text
18503 #: ../misc-utils/lsfd.1.adoc:678
18506 "*lsfd* has few options for filtering. In most of cases, what you should\n"
18507 "know is *-Q* (or *--filter*) option. Combined with *-o* (or\n"
18508 "*--output*) option, you can customize the output as you want.\n"
18511 #. TRANSLATORS: In the following messages, don't forget to add whitespace at the end!
18512 #. type: Labeled list
18513 #: ../misc-utils/lsfd.1.adoc:680
18515 msgid "List files associated with PID 1 and PID 2 processes: "
18518 #. type: delimited block .
18519 #: ../misc-utils/lsfd.1.adoc:683
18521 msgid "# lsfd -Q '(PID == 1) or (PID == 2)'\n"
18524 #. type: Labeled list
18525 #: ../misc-utils/lsfd.1.adoc:685 ../misc-utils/lsfd.1.adoc:710
18526 #: ../misc-utils/lsfd.1.adoc:720
18528 msgid "Do the same in an alternative way: "
18531 #. type: delimited block .
18532 #: ../misc-utils/lsfd.1.adoc:688
18534 msgid "# lsfd -Q '(PID == 1) || (PID == 2)'\n"
18537 #. type: Labeled list
18538 #: ../misc-utils/lsfd.1.adoc:690
18540 msgid "Do the same in a more efficient way: "
18543 #. type: delimited block .
18544 #: ../misc-utils/lsfd.1.adoc:693
18546 msgid "# lsfd --pid 1,2\n"
18549 #. type: Labeled list
18550 #: ../misc-utils/lsfd.1.adoc:695
18552 msgid "Whitescapes can be used instead of a comma: "
18555 #. type: delimited block .
18556 #: ../misc-utils/lsfd.1.adoc:698
18558 msgid "# lsfd --pid '1 2'\n"
18561 #. type: Labeled list
18562 #: ../misc-utils/lsfd.1.adoc:700
18564 msgid "Utilize *pidof*(1) for list the files associated with \"firefox\": "
18567 #. type: delimited block .
18568 #: ../misc-utils/lsfd.1.adoc:703
18570 msgid "# lsfd --pid \"$(pidof firefox)\"\n"
18573 #. type: Labeled list
18574 #: ../misc-utils/lsfd.1.adoc:705
18576 msgid "List the 1st file descriptor opened by PID 1 process: "
18579 #. type: delimited block .
18580 #: ../misc-utils/lsfd.1.adoc:708
18582 msgid "# lsfd -Q '(PID == 1) and (FD == 1)'\n"
18585 #. type: delimited block .
18586 #: ../misc-utils/lsfd.1.adoc:713
18588 msgid "# lsfd -Q '(PID == 1) && (FD == 1)'\n"
18591 #. type: Labeled list
18592 #: ../misc-utils/lsfd.1.adoc:715
18594 msgid "List all running executables: "
18597 #. type: delimited block .
18598 #: ../misc-utils/lsfd.1.adoc:718
18600 msgid "# lsfd -Q 'ASSOC == \"exe\"'\n"
18603 #. type: delimited block .
18604 #: ../misc-utils/lsfd.1.adoc:723
18606 msgid "# lsfd -Q 'ASSOC eq \"exe\"'\n"
18609 #. type: Labeled list
18610 #: ../misc-utils/lsfd.1.adoc:725
18612 msgid "Do the same but print only file names: "
18615 #. type: delimited block .
18616 #: ../misc-utils/lsfd.1.adoc:728
18618 msgid "# lsfd -o NAME -Q 'ASSOC eq \"exe\"' | sort -u\n"
18621 #. type: Labeled list
18622 #: ../misc-utils/lsfd.1.adoc:730
18624 msgid "List deleted files associated to processes: "
18627 #. type: delimited block .
18628 #: ../misc-utils/lsfd.1.adoc:733
18630 msgid "# lsfd -Q 'DELETED'\n"
18633 #. type: Labeled list
18634 #: ../misc-utils/lsfd.1.adoc:735
18636 msgid "List non-regular files: "
18639 #. type: delimited block .
18640 #: ../misc-utils/lsfd.1.adoc:738
18642 msgid "# lsfd -Q 'TYPE != \"REG\"'\n"
18645 #. type: Labeled list
18646 #: ../misc-utils/lsfd.1.adoc:740
18648 msgid "List block devices: "
18651 #. type: delimited block .
18652 #: ../misc-utils/lsfd.1.adoc:743
18654 msgid "# lsfd -Q 'DEVTYPE == \"blk\"'\n"
18657 #. type: Labeled list
18658 #: ../misc-utils/lsfd.1.adoc:745
18660 msgid "Do the same with TYPE column: "
18663 #. type: delimited block .
18664 #: ../misc-utils/lsfd.1.adoc:748
18666 msgid "# lsfd -Q 'TYPE == \"BLK\"'\n"
18669 #. type: Labeled list
18670 #: ../misc-utils/lsfd.1.adoc:750
18672 msgid "List files including \"dconf\" directory in their names: "
18675 #. type: delimited block .
18676 #: ../misc-utils/lsfd.1.adoc:753
18678 msgid "# lsfd -Q 'NAME =~ \".\\*/dconf/.*\"'\n"
18681 #. type: Labeled list
18682 #: ../misc-utils/lsfd.1.adoc:755
18684 msgid "List files opened in a QEMU virtual machine: "
18687 #. type: delimited block .
18688 #: ../misc-utils/lsfd.1.adoc:758
18690 msgid "# lsfd -Q '(COMMAND =~ \".\\*qemu.*\") and (FD >= 0)'\n"
18693 #. type: Labeled list
18694 #: ../misc-utils/lsfd.1.adoc:760
18696 msgid "Hide files associated to kernel threads: "
18699 #. type: delimited block .
18700 #: ../misc-utils/lsfd.1.adoc:763
18702 msgid "# lsfd -Q '!KTHREAD'\n"
18705 #. type: Labeled list
18706 #: ../misc-utils/lsfd.1.adoc:765
18708 msgid "List timerfd files expired within 0.5 seconds: "
18711 #. type: delimited block .
18712 #: ../misc-utils/lsfd.1.adoc:768
18714 msgid "# lsfd -Q '(TIMERFD.remaining < 0.5) and (TIMERFD.remaining > 0.0)'\n"
18718 #: ../misc-utils/lsfd.1.adoc:770
18720 msgid "COUNTER EXAMPLES"
18723 #. type: Labeled list
18724 #: ../misc-utils/lsfd.1.adoc:772
18726 msgid "Report the numbers of netlink socket descriptors and unix socket descriptors: "
18729 #. type: delimited block .
18730 #: ../misc-utils/lsfd.1.adoc:780
18733 "# lsfd --summary=only \\\n"
18734 "\t-C 'netlink sockets':'(NAME =~ \"NETLINK:.*\")' \\\n"
18735 "\t-C 'unix sockets':'(NAME =~ \"UNIX:.*\")'\n"
18737 " 57 netlink sockets\n"
18738 " 1552 unix sockets\n"
18741 #. type: Labeled list
18742 #: ../misc-utils/lsfd.1.adoc:782
18744 msgid "Do the same but print in JSON format: "
18747 #. type: delimited block .
18748 #: ../misc-utils/lsfd.1.adoc:798
18751 "# lsfd --summary=only --json \\\n"
18752 "\t-C 'netlink sockets':'(NAME =~ \"NETLINK:.*\")' \\\n"
18753 "\t-C 'unix sockets':'(NAME =~ \"UNIX:.*\")'\n"
18755 " \"lsfd-summary\": [\n"
18757 "\t \"value\": 15,\n"
18758 "\t \"counter\": \"netlink sockets\"\n"
18760 "\t \"value\": 798,\n"
18761 "\t \"counter\": \"unix sockets\"\n"
18767 #. type: Plain text
18768 #: ../misc-utils/lsfd.1.adoc:804
18769 msgid "The *lsfd* command is part of the util-linux package since v2.38."
18772 #. type: Plain text
18773 #: ../misc-utils/lsfd.1.adoc:809
18775 "mailto:yamato@redhat.com[Masatake YAMATO], mailto:kzak@redhat.com[Karel Zak]"
18778 #. type: Plain text
18779 #: ../misc-utils/lsfd.1.adoc:820
18793 #. Man page for the lslocks command.
18794 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
18795 #. May be distributed under the GNU General Public License
18796 #. Copyright 1994 Salvatore Valente (svalente@mit.edu)
18797 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
18798 #. May be distributed under the GNU General Public License
18800 #: ../misc-utils/lslocks.8.adoc:12
18805 #. type: Plain text
18806 #: ../misc-utils/lslocks.8.adoc:23
18807 msgid "lslocks - list local system locks"
18810 #. type: Plain text
18811 #: ../misc-utils/lslocks.8.adoc:27
18813 msgid "*lslocks* [options]\n"
18816 #. type: Plain text
18817 #: ../misc-utils/lslocks.8.adoc:31
18819 msgid "*lslocks* lists information about all the currently held file locks in a Linux system.\n"
18822 #. type: Labeled list
18823 #: ../misc-utils/lslocks.8.adoc:37
18825 msgid "*-i*, *--noinaccessible*"
18828 #. type: Plain text
18829 #: ../misc-utils/lslocks.8.adoc:39
18830 msgid "Ignore lock files which are inaccessible for the current user."
18833 #. TRANSLATORS: Keep {plus} untranslated.
18834 #. type: Plain text
18835 #: ../misc-utils/lslocks.8.adoc:50
18837 "The default list of columns may be extended if _list_ is specified in the "
18838 "format _{plus}list_ (e.g., *lslocks -o {plus}BLOCKER*)."
18841 #. type: Labeled list
18842 #: ../misc-utils/lslocks.8.adoc:55 ../sys-utils/choom.1.adoc:25
18844 #| msgid "*-P*, *--pty*"
18845 msgid "*-p*, *--pid* _pid_"
18846 msgstr "*-P*, *--pty*"
18848 #. type: Plain text
18849 #: ../misc-utils/lslocks.8.adoc:57
18850 msgid "Display only the locks held by the process with this _pid_."
18853 #. type: Plain text
18854 #: ../misc-utils/lslocks.8.adoc:60 ../misc-utils/uuidparse.1.adoc:61
18855 #: ../sys-utils/lsns.8.adoc:60 ../sys-utils/prlimit.1.adoc:54
18856 #: ../sys-utils/rfkill.8.adoc:41 ../sys-utils/wdctl.8.adoc:56
18857 msgid "Use the raw output format."
18860 #. type: Plain text
18861 #: ../misc-utils/lslocks.8.adoc:63 ../sys-utils/lsns.8.adoc:66
18862 msgid "Do not truncate text in columns."
18865 #. type: Labeled list
18866 #: ../misc-utils/lslocks.8.adoc:68
18871 #. type: Plain text
18872 #: ../misc-utils/lslocks.8.adoc:70
18873 msgid "The command name of the process holding the lock."
18876 #. type: Labeled list
18877 #: ../misc-utils/lslocks.8.adoc:71
18882 #. type: Plain text
18883 #: ../misc-utils/lslocks.8.adoc:73
18884 msgid "The process ID of the process."
18887 #. type: Labeled list
18888 #: ../misc-utils/lslocks.8.adoc:74
18893 #. type: Plain text
18894 #: ../misc-utils/lslocks.8.adoc:76
18896 "The type of lock; can be LEASE (created with *fcntl*(2)), FLOCK (created "
18897 "with *flock*(2)), POSIX (created with *fcntl*(2) and *lockf*(3)) or OFDLCK "
18898 "(created with *fcntl*(2))."
18901 #. type: Labeled list
18902 #: ../misc-utils/lslocks.8.adoc:77
18907 #. type: Plain text
18908 #: ../misc-utils/lslocks.8.adoc:79
18909 msgid "Size of the locked file."
18912 #. type: Labeled list
18913 #: ../misc-utils/lslocks.8.adoc:80
18918 #. type: Plain text
18919 #: ../misc-utils/lslocks.8.adoc:82
18920 msgid "The inode number."
18923 #. type: Labeled list
18924 #: ../misc-utils/lslocks.8.adoc:83
18929 #. type: Plain text
18930 #: ../misc-utils/lslocks.8.adoc:85
18931 msgid "The major:minor device number."
18934 #. type: Labeled list
18935 #: ../misc-utils/lslocks.8.adoc:86
18940 #. type: Plain text
18941 #: ../misc-utils/lslocks.8.adoc:88
18943 "The lock's access permissions (read, write). If the process is blocked and "
18944 "waiting for the lock, then the mode is postfixed with an '*' (asterisk)."
18947 #. type: Labeled list
18948 #: ../misc-utils/lslocks.8.adoc:89
18953 #. type: Plain text
18954 #: ../misc-utils/lslocks.8.adoc:91
18956 "Whether the lock is mandatory; 0 means no (meaning the lock is only "
18957 "advisory), 1 means yes. (See *fcntl*(2).)"
18960 #. type: Labeled list
18961 #: ../misc-utils/lslocks.8.adoc:92
18966 #. type: Plain text
18967 #: ../misc-utils/lslocks.8.adoc:94
18968 msgid "Relative byte offset of the lock."
18971 #. type: Labeled list
18972 #: ../misc-utils/lslocks.8.adoc:95
18977 #. type: Plain text
18978 #: ../misc-utils/lslocks.8.adoc:97
18979 msgid "Ending offset of the lock."
18982 #. type: Labeled list
18983 #: ../misc-utils/lslocks.8.adoc:98
18988 #. type: Plain text
18989 #: ../misc-utils/lslocks.8.adoc:100
18991 "Full path of the lock. If none is found, or there are no permissions to read "
18992 "the path, it will fall back to the device's mountpoint and \"...\" is "
18993 "appended to the path. The path might be truncated; use *--notruncate* to get "
18997 #. type: Labeled list
18998 #: ../misc-utils/lslocks.8.adoc:101
19003 #. type: Plain text
19004 #: ../misc-utils/lslocks.8.adoc:103
19005 msgid "The PID of the process which blocks the lock."
19008 #. type: Plain text
19009 #: ../misc-utils/lslocks.8.adoc:107
19011 "The *lslocks* command is meant to replace the *lslk*(8) command, originally "
19012 "written by mailto:abe@purdue.edu[Victor A. Abell] and unmaintained since "
19016 #. type: Plain text
19017 #: ../misc-utils/lslocks.8.adoc:114
19019 "\"The process holding the lock\" for leases, FLOCK locks, and OFD locks is a "
19020 "fake-concept. They are associated with the open file description on which "
19021 "they are acquired. With *fork*(2) and/or *cmsg*(3), multiple processes can "
19022 "share an open file description. So the holder process of a lease (or a lock) "
19023 "is not uniquely determined. *lslocks* shows the one of the holder processes "
19024 "in COMMAND and PID columns."
19027 #. type: Plain text
19028 #: ../misc-utils/lslocks.8.adoc:118
19029 msgid "mailto:dave@gnu.org[Davidlohr Bueso]"
19032 #. type: Plain text
19033 #: ../misc-utils/lslocks.8.adoc:124
19049 #. Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu)
19051 #: ../misc-utils/mcookie.1.adoc:4
19056 #. type: Plain text
19057 #: ../misc-utils/mcookie.1.adoc:14
19058 msgid "mcookie - generate magic cookies for xauth"
19061 #. type: Plain text
19062 #: ../misc-utils/mcookie.1.adoc:18
19064 msgid "*mcookie* [options]\n"
19067 #. type: Plain text
19068 #: ../misc-utils/mcookie.1.adoc:22
19070 msgid "*mcookie* generates a 128-bit random hexadecimal number for use with the X authority system. Typical usage:\n"
19073 #. type: delimited block _
19074 #: ../misc-utils/mcookie.1.adoc:25
19076 msgid "*xauth add :0 . `mcookie`*\n"
19079 #. type: Plain text
19080 #: ../misc-utils/mcookie.1.adoc:28
19082 "The \"random\" number generated is actually the MD5 message digest of random "
19083 "information coming from one of the sources *getrandom*(2) system call, _/dev/"
19084 "urandom_, _/dev/random_, or the _libc pseudo-random functions_, in this "
19085 "preference order. See also the option *--file*."
19088 #. type: Plain text
19089 #: ../misc-utils/mcookie.1.adoc:33
19091 "Use this _file_ as an additional source of randomness (for example _/dev/"
19092 "urandom_). When _file_ is '-', characters are read from standard input."
19095 #. type: Labeled list
19096 #: ../misc-utils/mcookie.1.adoc:34
19098 msgid "*-m*, *--max-size* _number_"
19101 #. type: Plain text
19102 #: ../misc-utils/mcookie.1.adoc:36
19104 "Read from _file_ only this _number_ of bytes. This option is meant to be "
19105 "used when reading additional randomness from a file or device."
19108 #. type: Plain text
19109 #: ../misc-utils/mcookie.1.adoc:38
19111 "The _number_ argument may be followed by the multiplicative suffixes "
19112 "KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "
19113 "\"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
19114 "suffixes KB=1000, MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB."
19117 #. type: Plain text
19118 #: ../misc-utils/mcookie.1.adoc:41
19120 "Inform where randomness originated, with amount of entropy read from each "
19124 #. type: Plain text
19125 #: ../misc-utils/mcookie.1.adoc:47
19126 msgid "_/dev/urandom_"
19129 #. type: Plain text
19130 #: ../misc-utils/mcookie.1.adoc:49
19131 msgid "_/dev/random_"
19134 #. type: Plain text
19135 #: ../misc-utils/mcookie.1.adoc:53
19136 msgid "It is assumed that none of the randomness sources will block."
19139 #. type: Plain text
19140 #: ../misc-utils/mcookie.1.adoc:60
19150 #: ../misc-utils/namei.1.adoc:2
19155 #. type: Plain text
19156 #: ../misc-utils/namei.1.adoc:12
19157 msgid "namei - follow a pathname until a terminal point is found"
19160 #. type: Plain text
19161 #: ../misc-utils/namei.1.adoc:16
19163 msgid "*namei* [options] _pathname_...\n"
19166 #. type: Plain text
19167 #: ../misc-utils/namei.1.adoc:20
19169 msgid "*namei* interprets its arguments as pathnames to any type of Unix file (symlinks, files, directories, and so forth). *namei* then follows each pathname until an endpoint is found (a file, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and starts following it, indenting the output to show the context.\n"
19172 #. type: Plain text
19173 #: ../misc-utils/namei.1.adoc:22
19175 "This program is useful for finding \"too many levels of symbolic links\" "
19179 #. type: Plain text
19180 #: ../misc-utils/namei.1.adoc:24
19182 "For each line of output, *namei* uses the following characters to identify "
19183 "the file type found:"
19186 #. type: delimited block .
19187 #: ../misc-utils/namei.1.adoc:35
19190 " f: = the pathname currently being resolved\n"
19192 " l = symbolic link (both the link and its contents are output)\n"
19194 " b = block device\n"
19195 " c = character device\n"
19196 " p = FIFO (named pipe)\n"
19197 " - = regular file\n"
19198 " ? = an error of some kind\n"
19201 #. type: Plain text
19202 #: ../misc-utils/namei.1.adoc:38
19204 msgid "*namei* prints an informative message when the maximum number of symbolic links this system can have has been exceeded.\n"
19207 #. type: Labeled list
19208 #: ../misc-utils/namei.1.adoc:41
19210 #| msgid "*-*, *-l*, *--login*"
19211 msgid "*-l*, *--long*"
19212 msgstr "*-*, *-l*, *--login*"
19214 #. type: Plain text
19215 #: ../misc-utils/namei.1.adoc:43
19216 msgid "Use the long listing format (same as *-m -o -v*)."
19219 #. type: Labeled list
19220 #: ../misc-utils/namei.1.adoc:44
19222 #| msgid "*-h*, *--help*"
19223 msgid "*-m*, *--modes*"
19224 msgstr "*-h*, *--help*"
19226 #. type: Plain text
19227 #: ../misc-utils/namei.1.adoc:46
19229 "Show the mode bits of each file type in the style of *ls*(1), for example "
19233 #. type: Labeled list
19234 #: ../misc-utils/namei.1.adoc:47
19236 #| msgid "*-V*, *--version*"
19237 msgid "*-n*, *--nosymlinks*"
19238 msgstr "*-V*, *--version*"
19240 #. type: Plain text
19241 #: ../misc-utils/namei.1.adoc:49
19242 msgid "Don't follow symlinks."
19245 #. type: Labeled list
19246 #: ../misc-utils/namei.1.adoc:50
19248 #| msgid "*-V*, *--version*"
19249 msgid "*-o*, *--owners*"
19250 msgstr "*-V*, *--version*"
19252 #. type: Plain text
19253 #: ../misc-utils/namei.1.adoc:52
19254 msgid "Show owner and group name of each file."
19257 #. type: Plain text
19258 #: ../misc-utils/namei.1.adoc:55
19259 msgid "Vertically align the modes and owners."
19262 #. type: Labeled list
19263 #: ../misc-utils/namei.1.adoc:56
19265 #| msgid "*-P*, *--pty*"
19266 msgid "*-x*, *--mountpoints*"
19267 msgstr "*-P*, *--pty*"
19269 #. type: Plain text
19270 #: ../misc-utils/namei.1.adoc:58
19271 msgid "Show mountpoint directories with a 'D' rather than a 'd'."
19274 #. type: Plain text
19275 #: ../misc-utils/namei.1.adoc:62
19277 "Show security context of the file or \"?\" if not available. The support "
19278 "for security contexts is optional and does not have to be compiled to the "
19282 #. type: Plain text
19283 #: ../misc-utils/namei.1.adoc:68
19284 msgid "To be discovered."
19287 #. type: Plain text
19288 #: ../misc-utils/namei.1.adoc:72
19290 "The original *namei* program was written by mailto:rogers@amadeus.wr.tek."
19291 "com[Roger Southwick]."
19294 #. type: Plain text
19295 #: ../misc-utils/namei.1.adoc:74
19297 "The program was rewritten by Karel Zak mailto:kzak@redhat.com[Karel Zak]."
19300 #. type: Plain text
19301 #: ../misc-utils/namei.1.adoc:80
19317 #: ../misc-utils/pipesz.1.adoc:2
19322 #. type: Plain text
19323 #: ../misc-utils/pipesz.1.adoc:12
19324 msgid "pipesz - set or examine pipe and FIFO buffer sizes"
19327 #. type: Plain text
19328 #: ../misc-utils/pipesz.1.adoc:16
19330 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
19331 msgid "*pipesz* [options] [--set _size_] [--] [_command_ [argument] ...]\n"
19332 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
19334 #. type: Plain text
19335 #: ../misc-utils/pipesz.1.adoc:18
19337 msgid "*pipesz* [options] --get\n"
19340 #. type: Plain text
19341 #: ../misc-utils/pipesz.1.adoc:22
19343 "Pipes and FIFOs maintain an internal buffer used to transfer data between "
19344 "the read end and the write end. In some cases, the default size of this "
19345 "internal buffer may not be appropriate. This program provides facilities to "
19346 "set and examine the size of these buffers."
19349 #. type: Plain text
19350 #: ../misc-utils/pipesz.1.adoc:24
19352 "The *--set* operation sets pipe buffer sizes. If it is specified, it must be "
19353 "specified with an explicit _size_. Otherwise, it is implied and the size is "
19354 "read from */proc/sys/fs/pipe-max-size*. The kernel may adjust _size_ as "
19355 "described in *fcntl*(2). To determine the actual buffer sizes set, use the "
19356 "*--verbose* option. If neither *--file* nor *--fd* are specified, *--set* "
19357 "acts on standard output."
19360 #. type: Plain text
19361 #: ../misc-utils/pipesz.1.adoc:26
19363 "The *--set* operation permits an optional _command_ to execute after setting "
19364 "the pipe buffer sizes. This command is executed with the adjusted pipes."
19367 #. type: Plain text
19368 #: ../misc-utils/pipesz.1.adoc:28
19370 "The *--get* operation outputs data in a tabular format. The first column is "
19371 "the name of the pipe as passed to *pipesz*. File descriptors are named as "
19372 "\"fd _N_\". The second column is the size, in bytes, of the pipe's internal "
19373 "buffer. The third column is the number of unread bytes currently in the "
19374 "pipe. The columns are separated by tabs ('\\t', ASCII 09h). If *--verbose* "
19375 "is specified, a descriptive header is also emitted. If neither *--file* nor "
19376 "*--fd* are specified, *--get* acts on standard input."
19379 #. type: Plain text
19380 #: ../misc-utils/pipesz.1.adoc:30
19382 "Unless the *--check* option is specified, *pipesz* does _not_ exit if it "
19383 "encounters an error while manipulating a file or file descriptor. This "
19384 "allows *pipesz* to be used generically without fear of disrupting the "
19385 "execution of pipelines should the type of certain files be later changed. "
19386 "For minimal disruption, the *--quiet* option prevents warnings from being "
19387 "emitted in these cases."
19390 #. type: Plain text
19391 #: ../misc-utils/pipesz.1.adoc:32
19393 "The kernel imposes limits on the amount of pipe buffer space unprivileged "
19394 "processes can use, though see *BUGS* below. The kernel will also refuse to "
19395 "shrink a pipe buffer if this would cause a loss of buffered data. See "
19396 "*pipe*(7) for additional details."
19399 #. type: Plain text
19400 #: ../misc-utils/pipesz.1.adoc:34
19402 msgid "*pipesz* supports specifying multiple short options consecutively, in the usual *getopt*(3) fashion. The first non-option argument is interpreted as _command_. If _command_ might begin with '-', use '--' to separate it from arguments to *pipesz*. In shell scripts, it is good practice to use '--' when parameter expansion is involved. *pipesz* itself does not read from standard input and does not write to standard output unless *--get*, *--help*, or *--version* are specified.\n"
19405 #. type: Labeled list
19406 #: ../misc-utils/pipesz.1.adoc:37
19408 #| msgid "*-P*, *--pty*"
19409 msgid "*-g*, *--get*"
19410 msgstr "*-P*, *--pty*"
19412 #. type: Plain text
19413 #: ../misc-utils/pipesz.1.adoc:39
19415 "Report the size of pipe buffers to standard output and exit. As a special "
19416 "behavior, if neither *--file* nor *--fd* are specified, standard input is "
19417 "examined. It is an error to specify this option in combination with *--set*."
19420 #. type: Labeled list
19421 #: ../misc-utils/pipesz.1.adoc:40
19423 #| msgid "*-s*, **--shell**=__shell__"
19424 msgid "*-s*, *--set* _size_"
19425 msgstr "*-s*, **--shell**=__shell__"
19427 #. type: Plain text
19428 #: ../misc-utils/pipesz.1.adoc:42
19430 "Set the size of the pipe buffers, in bytes. This option may be suffixed by "
19431 "_K_, _M_, _G_, _KiB_, _MiB_, or _GiB_ to indicate multiples of 1024. "
19432 "Fractional values are supported in this case. Additional suffixes are "
19433 "supported but are unlikely to be useful. If this option is not specified, a "
19434 "default value is used, as described above. If this option is specified "
19435 "multiple times, a warning is emitted and only the last-specified _size_ is "
19436 "used. As a special behavior, if neither *--file* nor *--fd* are specified, "
19437 "standard output is adjusted. It is an error to specify this option in "
19438 "combination with *--get*."
19441 #. type: Labeled list
19442 #: ../misc-utils/pipesz.1.adoc:43
19444 #| msgid "*-P*, *--pty*"
19445 msgid "*-f*, *--file* _path_"
19446 msgstr "*-P*, *--pty*"
19448 #. type: Plain text
19449 #: ../misc-utils/pipesz.1.adoc:45
19451 "Set the buffer size of the FIFO or pipe at _path_, relative to the current "
19452 "working directory. You may specify this option multiple times to affect "
19453 "different files, and you may do so in combination with *--fd*. Generally, "
19454 "this option is used with FIFOs, but it will also operate on anonymous pipes "
19455 "such as those found in */proc/PID/fd*. Changes to the buffer size of FIFOs "
19456 "are not preserved across system restarts."
19459 #. type: Labeled list
19460 #: ../misc-utils/pipesz.1.adoc:46
19462 #| msgid "*-P*, *--pty*"
19463 msgid "*-n*, *--fd* _fd_"
19464 msgstr "*-P*, *--pty*"
19466 #. type: Plain text
19467 #: ../misc-utils/pipesz.1.adoc:48
19469 "Set the buffer size of the pipe or FIFO passed to *pipesz* as the specified "
19470 "file descriptor number. You may specify this option multiple times to affect "
19471 "different file descriptors, and you may do so in combination with *--file*. "
19472 "Shorthand options are provided for the common cases of fd 0 (stdin), fd 1 "
19473 "(stdout), and fd 2 (stderr). These should suffice in most cases."
19476 #. type: Labeled list
19477 #: ../misc-utils/pipesz.1.adoc:49
19479 #| msgid "*-f*, *--fast*"
19480 msgid "*-i*, *--stdin*"
19481 msgstr "*-f*, *--fast*"
19483 #. type: Plain text
19484 #: ../misc-utils/pipesz.1.adoc:51
19485 msgid "Shorthand for *--fd 0*."
19488 #. type: Labeled list
19489 #: ../misc-utils/pipesz.1.adoc:52
19491 #| msgid "*-P*, *--pty*"
19492 msgid "*-o*, *--stdout*"
19493 msgstr "*-P*, *--pty*"
19495 #. type: Plain text
19496 #: ../misc-utils/pipesz.1.adoc:54
19497 msgid "Shorthand for *--fd 1*."
19500 #. type: Labeled list
19501 #: ../misc-utils/pipesz.1.adoc:55
19503 #| msgid "*-f*, *--fast*"
19504 msgid "*-e*, *--stderr*"
19505 msgstr "*-f*, *--fast*"
19507 #. type: Plain text
19508 #: ../misc-utils/pipesz.1.adoc:57
19509 msgid "Shorthand for *--fd 2*."
19512 #. type: Plain text
19513 #: ../misc-utils/pipesz.1.adoc:60
19515 "Exit, without executing _command_, in case of any error while manipulating a "
19516 "file or file descriptor. The default behavior if this is not specified is to "
19517 "emit a warning to standard error and continue."
19520 #. type: Plain text
19521 #: ../misc-utils/pipesz.1.adoc:63
19523 "Do not diagnose non-fatal errors to standard error. This option does not "
19524 "affect the normal output of *--get*, *--verbose*, *--help*, or *--version*."
19527 #. type: Plain text
19528 #: ../misc-utils/pipesz.1.adoc:66
19530 "If specified with *--get*, *pipesz* will emit a descriptive header above the "
19531 "table. Otherwise, if specified, *pipesz* will print the actual buffer sizes "
19532 "set by the kernel to standard error."
19535 #. type: Labeled list
19536 #: ../misc-utils/pipesz.1.adoc:71
19538 msgid "*pipesz* *dd* if=_file_ bs=1M | ..."
19541 #. type: Plain text
19542 #: ../misc-utils/pipesz.1.adoc:73
19544 "Runs *dd*(1) with an expanded standard output pipe, allowing it to avoid "
19545 "context switches when piping around large blocks."
19548 #. type: Labeled list
19549 #: ../misc-utils/pipesz.1.adoc:74
19551 msgid "*pipesz* -s1M -cf _/run/my-service.fifo_"
19554 #. type: Plain text
19555 #: ../misc-utils/pipesz.1.adoc:76
19557 "Sets the pipe buffer size of a service FIFO to 1,048,576 bytes. If the "
19558 "buffer size could not be set, *pipesz* exits with an error."
19561 #. type: Labeled list
19562 #: ../misc-utils/pipesz.1.adoc:77
19564 msgid "*echo* hello | *pipesz* -g"
19567 #. type: Plain text
19568 #: ../misc-utils/pipesz.1.adoc:79
19570 "Prints the size of pipe used by the shell to pass input to *pipesz*. Since "
19571 "*pipesz* does not read standard input, it may also report 6 unread bytes in "
19572 "the pipe, depending on relative timings."
19575 #. type: Labeled list
19576 #: ../misc-utils/pipesz.1.adoc:80
19578 msgid "*find* /proc/_PID_/fd -exec *pipesz* -gqf '{}' ';'"
19581 #. type: Plain text
19582 #: ../misc-utils/pipesz.1.adoc:82
19584 "Prints the size and number of unread bytes of all pipes in use by _PID_. If "
19585 "some pipes are routinely full, *pipesz* might be able to mitigate a "
19586 "processing bottleneck."
19589 #. type: Plain text
19590 #: ../misc-utils/pipesz.1.adoc:86
19592 "Linux supports adjusting the size of pipe buffers since kernel 2.6.35. This "
19593 "release also introduced */proc/sys/fs/pipe-max-size*."
19596 #. type: Plain text
19597 #: ../misc-utils/pipesz.1.adoc:88
19599 "This program uses *fcntl*(2) *F_GETPIPE_SZ*/*F_SETPIPE_SZ* to get and set "
19600 "pipe buffer sizes."
19603 #. type: Plain text
19604 #: ../misc-utils/pipesz.1.adoc:90
19606 "This program uses *ioctl*(2) *FIONREAD* to report the amount of unread data "
19607 "in pipes. If for some reason this fails, the amount of unread data is "
19611 #. type: Plain text
19612 #: ../misc-utils/pipesz.1.adoc:94
19614 "Before Linux 4.9, some bugs affect how certain resource limits are enforced "
19615 "when setting pipe buffer sizes. See *pipe*(7) for details."
19618 #. type: Plain text
19619 #: ../misc-utils/pipesz.1.adoc:98
19620 msgid "mailto:nwsharp@live.com[Nathan Sharp]"
19623 #. type: Plain text
19624 #: ../misc-utils/pipesz.1.adoc:102
19626 msgid "*pipe*(7)\n"
19629 #. Written by Andries E. Brouwer (aeb@cwi.nl)
19630 #. Placed in the public domain
19632 #: ../misc-utils/rename.1.adoc:4
19637 #. type: Plain text
19638 #: ../misc-utils/rename.1.adoc:14
19639 msgid "rename - rename files"
19642 #. type: Plain text
19643 #: ../misc-utils/rename.1.adoc:18
19645 msgid "*rename* [options] _expression replacement file_...\n"
19648 #. type: Plain text
19649 #: ../misc-utils/rename.1.adoc:22
19651 msgid "*rename* will rename the specified files by replacing the first occurrence of _expression_ in their name by _replacement_.\n"
19654 #. type: Labeled list
19655 #: ../misc-utils/rename.1.adoc:25
19657 #| msgid "*-V*, *--version*"
19658 msgid "*-s*, *--symlink*"
19659 msgstr "*-V*, *--version*"
19661 #. type: Plain text
19662 #: ../misc-utils/rename.1.adoc:27
19663 msgid "Do not rename a symlink but change where it points."
19666 #. type: Plain text
19667 #: ../misc-utils/rename.1.adoc:30
19668 msgid "Show which files were renamed, if any."
19671 #. type: Plain text
19672 #: ../misc-utils/rename.1.adoc:33
19673 msgid "Do not make any changes; add *--verbose* to see what would be made."
19676 #. type: Plain text
19677 #: ../misc-utils/rename.1.adoc:36
19678 msgid "Replace all occurrences of _expression_ rather than only the first one."
19681 #. type: Labeled list
19682 #: ../misc-utils/rename.1.adoc:37
19684 #| msgid "*-f*, *--fast*"
19685 msgid "*-l*, *--last*"
19686 msgstr "*-f*, *--fast*"
19688 #. type: Plain text
19689 #: ../misc-utils/rename.1.adoc:39
19690 msgid "Replace the last occurrence of _expression_ rather than the first one."
19693 #. type: Labeled list
19694 #: ../misc-utils/rename.1.adoc:40
19696 #| msgid "*-V*, *--version*"
19697 msgid "*-o*, *--no-overwrite*"
19698 msgstr "*-V*, *--version*"
19700 #. type: Plain text
19701 #: ../misc-utils/rename.1.adoc:42
19703 "Do not overwrite existing files. When *--symlink* is active, do not "
19704 "overwrite symlinks pointing to existing targets."
19707 #. type: Labeled list
19708 #: ../misc-utils/rename.1.adoc:43
19710 #| msgid "*-V*, *--version*"
19711 msgid "*-i*, *--interactive*"
19712 msgstr "*-V*, *--version*"
19714 #. type: Plain text
19715 #: ../misc-utils/rename.1.adoc:45
19716 msgid "Ask before overwriting existing files."
19719 #. type: Plain text
19720 #: ../misc-utils/rename.1.adoc:51
19722 "The renaming has no safeguards by default or without any one of the options "
19723 "*--no-overwrite*, *--interactive* or *--no-act*. If the user has permission "
19724 "to rewrite file names, the command will perform the action without any "
19725 "questions. For example, the result can be quite drastic when the command is "
19726 "run as root in the _/lib_ directory. Always make a backup before running the "
19727 "command, unless you truly know what you are doing."
19731 #: ../misc-utils/rename.1.adoc:52
19736 #. type: Plain text
19737 #: ../misc-utils/rename.1.adoc:55
19739 "If the _expression_ is empty, then by default _replacement_ will be added to "
19740 "the start of the filename. With *--all*, _replacement_ will be inserted in "
19741 "between every two characters of the filename, as well as at the start and "
19745 #. type: Plain text
19746 #: ../misc-utils/rename.1.adoc:57
19748 "Normally, only the final path component of a filename is updated. (Or with "
19749 "*--symlink*, only the final path component of the link.) But if either "
19750 "_expression_ or _replacement_ contains a _/_, the full path is updated. This "
19751 "can cause a file to be moved between folders. Creating folders, and moving "
19752 "files between filesystems, is not supported."
19756 #: ../misc-utils/rename.1.adoc:58
19758 msgid "INTERACTIVE MODE"
19761 #. type: Plain text
19762 #: ../misc-utils/rename.1.adoc:61
19764 "As most standard utilities rename can be used with a terminal device (tty in "
19765 "short) in canonical mode, where the line is buffered by the tty and you "
19766 "press ENTER to validate the user input. If you put your tty in cbreak mode "
19767 "however, rename requires only a single key press to answer the prompt. To "
19768 "set cbreak mode, run for example:"
19771 #. type: delimited block .
19772 #: ../misc-utils/rename.1.adoc:64
19774 msgid "sh -c 'stty -icanon min 1; \"$0\" \"$@\"; stty icanon' rename -i from to files\n"
19777 #. type: Plain text
19778 #: ../misc-utils/rename.1.adoc:70
19779 msgid "all requested rename operations were successful"
19782 #. type: Plain text
19783 #: ../misc-utils/rename.1.adoc:73
19784 msgid "all rename operations failed"
19787 #. type: Plain text
19788 #: ../misc-utils/rename.1.adoc:76
19789 msgid "some rename operations failed"
19792 #. type: Plain text
19793 #: ../misc-utils/rename.1.adoc:79
19794 msgid "nothing was renamed"
19797 #. type: Plain text
19798 #: ../misc-utils/rename.1.adoc:82
19799 msgid "unanticipated error occurred"
19802 #. type: Plain text
19803 #: ../misc-utils/rename.1.adoc:86
19805 "Given the files _foo1_, ..., _foo9_, _foo10_, ..., _foo278_, the commands"
19808 #. type: delimited block .
19809 #: ../misc-utils/rename.1.adoc:90
19812 "rename foo foo00 foo?\n"
19813 "rename foo foo0 foo??\n"
19816 #. type: Plain text
19817 #: ../misc-utils/rename.1.adoc:93
19819 "will turn them into _foo001_, ..., _foo009_, _foo010_, ..., _foo278_. And"
19822 #. type: delimited block .
19823 #: ../misc-utils/rename.1.adoc:96
19825 msgid "rename .htm .html *.htm\n"
19828 #. type: Plain text
19829 #: ../misc-utils/rename.1.adoc:99
19831 "will fix the extension of your html files. Provide an empty string for "
19835 #. type: delimited block .
19836 #: ../misc-utils/rename.1.adoc:102
19838 msgid "rename '_with_long_name' '' file_with_long_name.*\n"
19841 #. type: Plain text
19842 #: ../misc-utils/rename.1.adoc:105
19843 msgid "will remove the substring in the filenames."
19846 #. type: Plain text
19847 #: ../misc-utils/rename.1.adoc:109
19852 #. Copyright 2007 by Theodore Ts'o. All Rights Reserved.
19853 #. This file may be copied under the terms of the GNU Public License.
19855 #: ../misc-utils/uuidd.8.adoc:6
19860 #. type: Plain text
19861 #: ../misc-utils/uuidd.8.adoc:16
19862 msgid "uuidd - UUID generation daemon"
19865 #. type: Plain text
19866 #: ../misc-utils/uuidd.8.adoc:20
19868 msgid "*uuidd* [options]\n"
19871 #. type: Plain text
19872 #: ../misc-utils/uuidd.8.adoc:24
19874 "The *uuidd* daemon is used by the UUID library to generate universally "
19875 "unique identifiers (UUIDs), especially time-based UUIDs, in a secure and "
19876 "guaranteed-unique fashion, even in the face of large numbers of threads "
19877 "running on different CPUs trying to grab UUIDs."
19880 #. type: Labeled list
19881 #: ../misc-utils/uuidd.8.adoc:27
19883 #| msgid "*-c*, **--command**=__command__"
19884 msgid "*-C*, *--cont-clock*[=_time_]"
19885 msgstr "*-c*, **--command**=__příkaz__"
19887 #. type: Plain text
19888 #: ../misc-utils/uuidd.8.adoc:29
19890 "Activate continuous clock handling for time based UUIDs. *uuidd* could use "
19891 "all possible clock values, beginning with the daemon's start time. The "
19892 "optional argument can be used to set a value for the max_clock_offset. This "
19893 "gurantees, that a clock value of a UUID will always be within the range of "
19894 "the max_clock_offset."
19897 #. type: Plain text
19898 #: ../misc-utils/uuidd.8.adoc:31
19900 "The option '-C' or '--cont-clock' enables the feature with a default "
19901 "max_clock_offset of 2 hours."
19904 #. type: Plain text
19905 #: ../misc-utils/uuidd.8.adoc:33
19907 "The option '-C<NUM>[hd]' or '--cont-clock=<NUM>[hd]' enables the feature "
19908 "with a max_clock_offset of NUM seconds. In case of an appended h or d, the "
19909 "NUM value is read in hours or days. The minimum value is 60 seconds, the "
19910 "maximum value is 365 days."
19913 #. type: Labeled list
19914 #: ../misc-utils/uuidd.8.adoc:34 ../sys-utils/ldattach.8.adoc:88
19916 #| msgid "*-h*, *--help*"
19917 msgid "*-d*, *--debug*"
19918 msgstr "*-h*, *--help*"
19920 #. type: Plain text
19921 #: ../misc-utils/uuidd.8.adoc:36
19923 "Run *uuidd* in debugging mode. This prevents *uuidd* from running as a "
19927 #. type: Labeled list
19928 #: ../misc-utils/uuidd.8.adoc:37 ../sys-utils/flock.1.adoc:62
19929 #: ../sys-utils/nsenter.1.adoc:138
19931 #| msgid "*-f*, *--fast*"
19932 msgid "*-F*, *--no-fork*"
19933 msgstr "*-f*, *--fast*"
19935 #. type: Plain text
19936 #: ../misc-utils/uuidd.8.adoc:39
19937 msgid "Do not daemonize using a double-fork."
19940 #. type: Labeled list
19941 #: ../misc-utils/uuidd.8.adoc:40
19943 #| msgid "*-h*, *--help*"
19944 msgid "*-k*, *--kill*"
19945 msgstr "*-h*, *--help*"
19947 #. type: Plain text
19948 #: ../misc-utils/uuidd.8.adoc:42
19949 msgid "If currently a uuidd daemon is running, kill it."
19952 #. type: Labeled list
19953 #: ../misc-utils/uuidd.8.adoc:43
19955 msgid "*-n*, *--uuids* _number_"
19958 #. type: Plain text
19959 #: ../misc-utils/uuidd.8.adoc:45
19961 "When issuing a test request to a running *uuidd*, request a bulk response of "
19965 #. type: Labeled list
19966 #: ../misc-utils/uuidd.8.adoc:46
19968 #| msgid "*-P*, *--pty*"
19969 msgid "*-P*, *--no-pid*"
19970 msgstr "*-P*, *--pty*"
19972 #. type: Plain text
19973 #: ../misc-utils/uuidd.8.adoc:48
19974 msgid "Do not create a pid file."
19977 #. type: Labeled list
19978 #: ../misc-utils/uuidd.8.adoc:49
19980 #| msgid "*-P*, *--pty*"
19981 msgid "*-p*, *--pid* _path_"
19982 msgstr "*-P*, *--pty*"
19984 #. TRANSLATORS: Don't translate _{runstatedir}_.
19985 #. type: Plain text
19986 #: ../misc-utils/uuidd.8.adoc:51
19988 "Specify the pathname where the pid file should be written. By default, the "
19989 "pid file is written to _{runstatedir}/uuidd/uuidd.pid_."
19992 #. type: Plain text
19993 #: ../misc-utils/uuidd.8.adoc:55
19994 msgid "Suppress some failure messages."
19997 #. type: Labeled list
19998 #: ../misc-utils/uuidd.8.adoc:56 ../misc-utils/uuidgen.1.adoc:31
20000 #| msgid "*-V*, *--version*"
20001 msgid "*-r*, *--random*"
20002 msgstr "*-V*, *--version*"
20004 #. type: Plain text
20005 #: ../misc-utils/uuidd.8.adoc:58
20007 "Test uuidd by trying to connect to a running uuidd daemon and request it to "
20008 "return a random-based UUID."
20011 #. type: Labeled list
20012 #: ../misc-utils/uuidd.8.adoc:59
20014 msgid "*-S*, *--socket-activation*"
20017 #. type: Plain text
20018 #: ../misc-utils/uuidd.8.adoc:61
20020 "Do not create a socket but instead expect it to be provided by the calling "
20021 "process. This implies *--no-fork* and *--no-pid*. This option is intended to "
20022 "be used only with *systemd*(1). It needs to be enabled with a configure "
20026 #. type: Labeled list
20027 #: ../misc-utils/uuidd.8.adoc:62
20029 #| msgid "*-s*, **--shell**=__shell__"
20030 msgid "*-s*, *--socket* _path_"
20031 msgstr "*-s*, **--shell**=__shell__"
20033 #. TRANSLATORS: Don't translate _{runstatedir}_.
20034 #. type: Plain text
20035 #: ../misc-utils/uuidd.8.adoc:64
20037 "Make uuidd use this pathname for the unix-domain socket. By default, the "
20038 "pathname used is _{runstatedir}/uuidd/request_. This option is primarily for "
20039 "debugging purposes, since the pathname is hard-coded in the *libuuid* "
20043 #. type: Labeled list
20044 #: ../misc-utils/uuidd.8.adoc:66
20046 msgid "*-T*, *--timeout* _number_"
20049 #. type: Plain text
20050 #: ../misc-utils/uuidd.8.adoc:68
20051 msgid "Make *uuidd* exit after _number_ seconds of inactivity."
20054 #. type: Labeled list
20055 #: ../misc-utils/uuidd.8.adoc:69 ../misc-utils/uuidgen.1.adoc:34
20056 #: ../sys-utils/ipcs.1.adoc:59 ../sys-utils/lsipc.1.adoc:74
20058 #| msgid "*-P*, *--pty*"
20059 msgid "*-t*, *--time*"
20060 msgstr "*-P*, *--pty*"
20062 #. type: Plain text
20063 #: ../misc-utils/uuidd.8.adoc:71
20065 "Test *uuidd* by trying to connect to a running uuidd daemon and request it "
20066 "to return a time-based UUID."
20069 #. type: Plain text
20070 #: ../misc-utils/uuidd.8.adoc:77
20071 msgid "Start up a daemon, print 42 random keys, and then stop the daemon:"
20074 #. type: delimited block .
20075 #: ../misc-utils/uuidd.8.adoc:82
20078 "uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket\n"
20079 "uuidd -d -r -n 42 -s /tmp/uuidd.socket\n"
20080 "uuidd -d -k -s /tmp/uuidd.socket\n"
20083 #. type: Plain text
20084 #: ../misc-utils/uuidd.8.adoc:87
20085 msgid "The *uuidd* daemon was written by mailto:tytso@mit.edu[Theodore Ts'o]."
20088 #. type: Plain text
20089 #: ../misc-utils/uuidd.8.adoc:92
20096 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
20097 #. This file may be copied under the terms of the GNU Public License.
20099 #: ../misc-utils/uuidgen.1.adoc:6
20104 #. type: Plain text
20105 #: ../misc-utils/uuidgen.1.adoc:16
20106 msgid "uuidgen - create a new UUID value"
20109 #. type: Plain text
20110 #: ../misc-utils/uuidgen.1.adoc:20
20112 msgid "*uuidgen* [options]\n"
20115 #. type: Plain text
20116 #: ../misc-utils/uuidgen.1.adoc:24
20118 "The *uuidgen* program creates (and prints) a new universally unique "
20119 "identifier (UUID) using the *libuuid*(3) library. The new UUID can "
20120 "reasonably be considered unique among all UUIDs created on the local system, "
20121 "and among UUIDs created on other systems in the past and in the future."
20124 #. type: Plain text
20125 #: ../misc-utils/uuidgen.1.adoc:26
20127 "There are three types of UUIDs which *uuidgen* can generate: time-based "
20128 "UUIDs, random-based UUIDs, and hash-based UUIDs. By default *uuidgen* will "
20129 "generate a random-based UUID if a high-quality random number generator is "
20130 "present. Otherwise, it will choose a time-based UUID. It is possible to "
20131 "force the generation of one of these first two UUID types by using the *--"
20132 "random* or *--time* options."
20135 #. type: Plain text
20136 #: ../misc-utils/uuidgen.1.adoc:28
20138 "The third type of UUID is generated with the *--md5* or *--sha1* options, "
20139 "followed by *--namespace* _namespace_ and *--name* _name_. The _namespace_ "
20140 "may either be a well-known UUID, or else an alias to one of the well-known "
20141 "UUIDs defined in RFC 4122, that is *@dns*, *@url*, *@oid*, or *@x500*. The "
20142 "_name_ is an arbitrary string value. The generated UUID is the digest of the "
20143 "concatenation of the namespace UUID and the name value, hashed with the MD5 "
20144 "or SHA1 algorithms. It is, therefore, a predictable value which may be "
20145 "useful when UUIDs are being used as handles or nonces for more complex "
20146 "values or values which shouldn't be disclosed directly. See the RFC for more "
20150 #. type: Plain text
20151 #: ../misc-utils/uuidgen.1.adoc:33
20153 "Generate a random-based UUID. This method creates a UUID consisting mostly "
20154 "of random bits. It requires that the operating system has a high quality "
20155 "random number generator, such as _/dev/random_."
20158 #. type: Plain text
20159 #: ../misc-utils/uuidgen.1.adoc:36
20161 "Generate a time-based UUID. This method creates a UUID based on the system "
20162 "clock plus the system's ethernet hardware address, if present."
20165 #. type: Labeled list
20166 #: ../misc-utils/uuidgen.1.adoc:39
20168 #| msgid "*-P*, *--pty*"
20169 msgid "*-m*, *--md5*"
20170 msgstr "*-P*, *--pty*"
20172 #. type: Plain text
20173 #: ../misc-utils/uuidgen.1.adoc:41
20174 msgid "Use MD5 as the hash algorithm."
20177 #. type: Labeled list
20178 #: ../misc-utils/uuidgen.1.adoc:42
20180 #| msgid "*-h*, *--help*"
20181 msgid "*-s*, *--sha1*"
20182 msgstr "*-h*, *--help*"
20184 #. type: Plain text
20185 #: ../misc-utils/uuidgen.1.adoc:44
20186 msgid "Use SHA1 as the hash algorithm."
20189 #. type: Labeled list
20190 #: ../misc-utils/uuidgen.1.adoc:45
20192 msgid "*-n*, *--namespace* _namespace_"
20195 #. type: Plain text
20196 #: ../misc-utils/uuidgen.1.adoc:47
20198 "Generate the hash with the _namespace_ prefix. The _namespace_ is UUID, or "
20199 "'@ns' where \"ns\" is well-known predefined UUID addressed by namespace name "
20203 #. type: Labeled list
20204 #: ../misc-utils/uuidgen.1.adoc:48
20206 msgid "*-N*, *--name* _name_"
20209 #. type: Plain text
20210 #: ../misc-utils/uuidgen.1.adoc:50
20211 msgid "Generate the hash of the _name_."
20214 #. type: Labeled list
20215 #: ../misc-utils/uuidgen.1.adoc:51
20217 #| msgid "*-c*, **--command**=__command__"
20218 msgid "*-C*, *--count* _num_"
20219 msgstr "*-c*, **--command**=__příkaz__"
20221 #. type: Plain text
20222 #: ../misc-utils/uuidgen.1.adoc:53
20224 "Generate multiple UUIDs using the enhanced capability of the libuuid to "
20225 "cache time-based UUIDs, thus resulting in improved performance. However, "
20226 "this holds no significance for other UUID types."
20229 #. type: Labeled list
20230 #: ../misc-utils/uuidgen.1.adoc:54 ../sys-utils/lscpu.1.adoc:84
20232 #| msgid "*-h*, *--help*"
20233 msgid "*-x*, *--hex*"
20234 msgstr "*-h*, *--help*"
20236 #. type: Plain text
20237 #: ../misc-utils/uuidgen.1.adoc:56
20238 msgid "Interpret name _name_ as a hexadecimal string."
20241 #. type: Plain text
20242 #: ../misc-utils/uuidgen.1.adoc:60
20243 msgid "OSF DCE 1.1"
20246 #. type: Plain text
20247 #: ../misc-utils/uuidgen.1.adoc:64
20248 msgid "uuidgen --sha1 --namespace @dns --name \"www.example.com\""
20251 #. type: Plain text
20252 #: ../misc-utils/uuidgen.1.adoc:68
20254 msgid "*uuidgen* was written by Andreas Dilger for *libuuid*(3).\n"
20257 #. type: Plain text
20258 #: ../misc-utils/uuidgen.1.adoc:74
20261 "*uuidparse*(1),\n"
20263 "link:https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
20266 #. Copyright (c) 2017 Sami Kerola
20267 #. The 3-Clause BSD License
20269 #: ../misc-utils/uuidparse.1.adoc:4
20271 msgid "uuidparse(1)"
20274 #. type: Plain text
20275 #: ../misc-utils/uuidparse.1.adoc:14
20276 msgid "uuidparse - a utility to parse unique identifiers"
20279 #. type: Plain text
20280 #: ../misc-utils/uuidparse.1.adoc:18
20282 msgid "*uuidparse* [options] _uuid_\n"
20285 #. type: Plain text
20286 #: ../misc-utils/uuidparse.1.adoc:22
20288 "This command will parse unique identifier inputs from either command line "
20289 "arguments or standard input. The inputs are white-space separated."
20293 #: ../misc-utils/uuidparse.1.adoc:25
20299 #: ../misc-utils/uuidparse.1.adoc:33
20302 "|NCS |Network Computing System identifier. These were the original UUIDs.\n"
20303 "|DCE |The Open Software Foundation's (OSF) Distributed Computing Environment UUIDs.\n"
20304 "|Microsoft |Microsoft Windows platform globally unique identifier (GUID).\n"
20305 "|other |Unknown variant. Usually invalid input data.\n"
20309 #: ../misc-utils/uuidparse.1.adoc:35
20315 #: ../misc-utils/uuidparse.1.adoc:46
20318 "|nil |Special type for zero in type file.\n"
20319 "|time-based |The DCE time based.\n"
20320 "|DCE |The DCE time and MAC Address.\n"
20321 "|name-based |RFC 4122 md5sum hash.\n"
20322 "|random |RFC 4122 random.\n"
20323 "|sha1-based |RFC 4122 sha-1 hash.\n"
20324 "|unknown |Unknown type. Usually invalid input data.\n"
20327 #. type: Labeled list
20328 #: ../misc-utils/uuidparse.1.adoc:56 ../sys-utils/rfkill.8.adoc:33
20330 #| msgid "*-P*, *--pty*"
20331 msgid "*-o*, *--output*"
20332 msgstr "*-P*, *--pty*"
20334 #. type: Plain text
20335 #: ../misc-utils/uuidparse.1.adoc:67
20336 msgid "mailto:kerolasa@iki.fi[Sami Kerola]"
20339 #. type: Plain text
20340 #: ../misc-utils/uuidparse.1.adoc:73
20345 "https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
20349 #: ../misc-utils/waitpid.1.adoc:2
20354 #. type: Plain text
20355 #: ../misc-utils/waitpid.1.adoc:12
20356 msgid "waitpid - utility to wait for arbitrary processes"
20359 #. type: Plain text
20360 #: ../misc-utils/waitpid.1.adoc:16
20362 msgid "*waitpid* [-v] [*--timeout*|*-t* _seconds_] pid...\n"
20365 #. type: Plain text
20366 #: ../misc-utils/waitpid.1.adoc:20
20368 msgid "*waitpid* is a simple command to wait for arbitrary non-child processes.\n"
20371 #. type: Plain text
20372 #: ../misc-utils/waitpid.1.adoc:23
20374 "It exits after all processes whose PIDs have been passed as arguments have "
20378 #. type: Plain text
20379 #: ../misc-utils/waitpid.1.adoc:28
20380 msgid "Be more verbose."
20383 #. type: Plain text
20384 #: ../misc-utils/waitpid.1.adoc:31
20385 msgid "Maximum wait time."
20388 #. type: Labeled list
20389 #: ../misc-utils/waitpid.1.adoc:32
20391 #| msgid "*-f*, *--fast*"
20392 msgid "*-e*, *--exited*"
20393 msgstr "*-f*, *--fast*"
20395 #. type: Plain text
20396 #: ../misc-utils/waitpid.1.adoc:34
20397 msgid "Don't error on already exited PIDs."
20400 #. type: Labeled list
20401 #: ../misc-utils/waitpid.1.adoc:35 ../sys-utils/blkzone.8.adoc:92
20403 #| msgid "*-c*, **--command**=__command__"
20404 msgid "*-c*, *--count* _count_"
20405 msgstr "*-c*, **--command**=__příkaz__"
20407 #. type: Plain text
20408 #: ../misc-utils/waitpid.1.adoc:37
20409 msgid "Number of process exits to wait for."
20412 #. type: Plain text
20413 #: ../misc-utils/waitpid.1.adoc:43
20415 msgid "*waitpid* has the following exit status values:\n"
20418 #. type: Plain text
20419 #: ../misc-utils/waitpid.1.adoc:50
20420 msgid "system does not provide necessary functionality"
20423 #. type: Plain text
20424 #: ../misc-utils/waitpid.1.adoc:52
20425 msgid "timeout expired"
20428 #. type: Plain text
20429 #: ../misc-utils/waitpid.1.adoc:56
20430 msgid "mailto:thomas@t-8ch.de[Thomas WeiÃ
\9fschuh]"
20433 #. type: Plain text
20434 #: ../misc-utils/waitpid.1.adoc:60
20436 msgid "*waitpid*(2) *wait*(1P)\n"
20442 #. Copyright (c) 1980, 1990 The Regents of the University of California.
20443 #. All rights reserved.
20444 #. Redistribution and use in source and binary forms, with or without
20445 #. modification, are permitted provided that the following conditions
20447 #. 1. Redistributions of source code must retain the above copyright
20448 #. notice, this list of conditions and the following disclaimer.
20449 #. 2. Redistributions in binary form must reproduce the above copyright
20450 #. notice, this list of conditions and the following disclaimer in the
20451 #. documentation and/or other materials provided with the distribution.
20452 #. 3. All advertising materials mentioning features or use of this software
20453 #. must display the following acknowledgement:
20454 #. This product includes software developed by the University of
20455 #. California, Berkeley and its contributors.
20456 #. 4. Neither the name of the University nor the names of its contributors
20457 #. may be used to endorse or promote products derived from this software
20458 #. without specific prior written permission.
20459 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20460 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20461 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20462 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20463 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20464 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20465 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20466 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20467 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
20468 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
20470 #. @(#)whereis.1 from UCB 4.2
20472 #: ../misc-utils/whereis.1.adoc:36
20477 #. type: Plain text
20478 #: ../misc-utils/whereis.1.adoc:46
20480 "whereis - locate the binary, source, and manual page files for a command"
20483 #. type: Plain text
20484 #: ../misc-utils/whereis.1.adoc:50
20486 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
20487 msgid "*whereis* [options] [*-BMS* _directory_... *-f*] _name_...\n"
20488 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
20490 #. type: Plain text
20491 #: ../misc-utils/whereis.1.adoc:54
20493 msgid "*whereis* locates the binary, source and manual files for the specified command names. The supplied names are *first stripped of leading pathname components*. Prefixes of *s.* resulting from use of source code control are also dealt with. *whereis* then attempts to locate the desired program in the standard Linux places, and in the places specified by *$PATH* and *$MANPATH*.\n"
20496 #. type: Plain text
20497 #: ../misc-utils/whereis.1.adoc:56
20499 "The search restrictions (options *-b*, *-m* and *-s*) are cumulative and "
20500 "apply to the subsequent _name_ patterns on the command line. Any new search "
20501 "restriction resets the search mask. For example,"
20504 #. type: delimited block _
20505 #: ../misc-utils/whereis.1.adoc:59
20507 msgid "*whereis -bm ls tr -m gcc*\n"
20510 #. type: Plain text
20511 #: ../misc-utils/whereis.1.adoc:62
20513 "searches for \"ls\" and \"tr\" binaries and man pages, and for \"gcc\" man "
20517 #. type: Plain text
20518 #: ../misc-utils/whereis.1.adoc:64
20520 "The options *-B*, *-M* and *-S* reset search paths for the subsequent _name_ "
20521 "patterns. For example,"
20524 #. type: delimited block _
20525 #: ../misc-utils/whereis.1.adoc:67
20527 msgid "*whereis -m ls -M /usr/share/man/man1 -f cal*\n"
20530 #. type: Plain text
20531 #: ../misc-utils/whereis.1.adoc:70
20533 "searches for \"*ls*\" man pages in all default paths, but for \"cal\" in the "
20534 "_/usr/share/man/man1_ directory only."
20537 #. type: Labeled list
20538 #: ../misc-utils/whereis.1.adoc:73
20543 #. type: Plain text
20544 #: ../misc-utils/whereis.1.adoc:75
20545 msgid "Search for binaries."
20548 #. type: Labeled list
20549 #: ../misc-utils/whereis.1.adoc:76 ../schedutils/uclampset.1.adoc:69
20554 #. type: Plain text
20555 #: ../misc-utils/whereis.1.adoc:78
20556 msgid "Search for manuals."
20559 #. type: Plain text
20560 #: ../misc-utils/whereis.1.adoc:81
20561 msgid "Search for sources."
20564 #. type: Labeled list
20565 #: ../misc-utils/whereis.1.adoc:82
20570 #. type: Plain text
20571 #: ../misc-utils/whereis.1.adoc:84
20573 "Only show the command names that have unusual entries. A command is said to "
20574 "be unusual if it does not have just one entry of each explicitly requested "
20575 "type. Thus '*whereis -m -u **' asks for those files in the current directory "
20576 "which have no documentation file, or more than one."
20579 #. type: Labeled list
20580 #: ../misc-utils/whereis.1.adoc:85
20582 msgid "*-B* _list_"
20585 #. type: Plain text
20586 #: ../misc-utils/whereis.1.adoc:87
20588 "Limit the places where *whereis* searches for binaries, by a whitespace-"
20589 "separated list of directories."
20592 #. type: Labeled list
20593 #: ../misc-utils/whereis.1.adoc:88
20595 msgid "*-M* _list_"
20598 #. type: Plain text
20599 #: ../misc-utils/whereis.1.adoc:90
20601 "Limit the places where *whereis* searches for manuals and documentation in "
20602 "Info format, by a whitespace-separated list of directories."
20605 #. type: Labeled list
20606 #: ../misc-utils/whereis.1.adoc:91
20608 msgid "*-S* _list_"
20611 #. type: Plain text
20612 #: ../misc-utils/whereis.1.adoc:93
20614 "Limit the places where *whereis* searches for sources, by a whitespace-"
20615 "separated list of directories."
20618 #. type: Plain text
20619 #: ../misc-utils/whereis.1.adoc:96
20621 "Terminates the directory list and signals the start of filenames. It _must_ "
20622 "be used when any of the *-B*, *-M*, or *-S* options is used."
20625 #. type: Plain text
20626 #: ../misc-utils/whereis.1.adoc:99
20628 "Output the list of effective lookup paths that *whereis* is using. When none "
20629 "of *-B*, *-M*, or *-S* is specified, the option will output the hard-coded "
20630 "paths that the command was able to find on the system."
20633 #. type: Labeled list
20634 #: ../misc-utils/whereis.1.adoc:100
20639 #. type: Plain text
20640 #: ../misc-utils/whereis.1.adoc:102
20642 "Interpret the next names as a *glob(7)* patterns. *whereis* always compares "
20643 "only filenames (aka basename) and never complete path. Using directory names "
20644 "in the pattern has no effect. Donâ
\80\99t forget that the shell interprets the "
20645 "pattern when specified on the command line without quotes. Itâ
\80\99s necessary to "
20646 "use quotes for the _name_, for example:"
20649 #. type: delimited block _
20650 #: ../misc-utils/whereis.1.adoc:104
20652 msgid " whereis -g 'find*'\n"
20656 #: ../misc-utils/whereis.1.adoc:108
20658 msgid "FILE SEARCH PATHS"
20661 #. type: Plain text
20662 #: ../misc-utils/whereis.1.adoc:111
20664 "By default *whereis* tries to find files from hard-coded paths, which are "
20665 "defined with glob patterns. The command attempts to use the contents of "
20666 "*$PATH* and *$MANPATH* environment variables as default search path. The "
20667 "easiest way to know what paths are in use is to add the *-l* listing option. "
20668 "Effects of the *-B*, *-M*, and *-S* are displayed with *-l*."
20671 #. type: Labeled list
20672 #: ../misc-utils/whereis.1.adoc:114
20674 msgid "*WHEREIS_DEBUG*=all"
20677 #. type: Plain text
20678 #: ../misc-utils/whereis.1.adoc:120
20680 "To find all files in _/usr/bin_ which are not documented in _/usr/man/man1_ "
20681 "or have no source in _/usr/src_:"
20684 #. type: delimited block _
20685 #: ../misc-utils/whereis.1.adoc:123
20688 "*cd /usr/bin* +\n"
20689 "*whereis -u -ms -M /usr/man/man1 -S /usr/src -f **\n"
20692 #. Copyright 2009 by Karel Zak. All Rights Reserved.
20693 #. This file may be copied under the terms of the GNU Public License.
20695 #: ../misc-utils/wipefs.8.adoc:4
20700 #. type: Plain text
20701 #: ../misc-utils/wipefs.8.adoc:14
20702 msgid "wipefs - wipe a signature from a device"
20705 #. type: Plain text
20706 #: ../misc-utils/wipefs.8.adoc:18
20708 msgid "*wipefs* [options] _device_...\n"
20711 #. type: Plain text
20712 #: ../misc-utils/wipefs.8.adoc:20
20714 msgid "*wipefs* [*--backup*] *-o* _offset device_...\n"
20717 #. type: Plain text
20718 #: ../misc-utils/wipefs.8.adoc:22
20720 msgid "*wipefs* [*--backup*] *-a* _device_...\n"
20723 #. type: Plain text
20724 #: ../misc-utils/wipefs.8.adoc:27
20726 msgid "*wipefs* can erase filesystem, raid or partition-table signatures (magic strings) from the specified _device_ to make the signatures invisible for libblkid. *wipefs* does not erase the filesystem itself nor any other data from the device.\n"
20729 #. type: Plain text
20730 #: ../misc-utils/wipefs.8.adoc:29
20732 "When used without any options, *wipefs* lists all visible filesystems and "
20733 "the offsets of their basic signatures. The default output is subject to "
20734 "change. So whenever possible, you should avoid using default outputs in your "
20735 "scripts. Always explicitly define expected columns by using *--output* "
20736 "_columns-list_ in environments where a stable output is required."
20739 #. type: Plain text
20740 #: ../misc-utils/wipefs.8.adoc:31
20742 msgid "*wipefs* calls the *BLKRRPART* ioctl when it has erased a partition-table signature to inform the kernel about the change. The ioctl is called as the last step and when all specified signatures from all specified devices are already erased. This feature can be used to wipe content on partitions devices as well as partition table on a disk device, for example by *wipefs -a /dev/sdc1 /dev/sdc2 /dev/sdc*.\n"
20745 #. type: Plain text
20746 #: ../misc-utils/wipefs.8.adoc:33
20748 "Note that some filesystems and some partition tables store more magic "
20749 "strings on the device (e.g., FAT, ZFS, GPT). The *wipefs* command (since "
20750 "v2.31) lists all the offset where a magic strings have been detected."
20753 #. type: Plain text
20754 #: ../misc-utils/wipefs.8.adoc:35
20756 "When option *-a* is used, all magic strings that are visible for "
20757 "*libblkid*(3) are erased. In this case the *wipefs* scans the device again "
20758 "after each modification (erase) until no magic string is found."
20761 #. type: Plain text
20762 #: ../misc-utils/wipefs.8.adoc:37
20764 "Note that by default *wipefs* does not erase nested partition tables on non-"
20765 "whole disk devices. For this the option *--force* is required."
20768 #. type: Plain text
20769 #: ../misc-utils/wipefs.8.adoc:42
20771 "Erase all available signatures. The set of erased signatures can be "
20772 "restricted with the *-t* option."
20775 #. type: Plain text
20776 #: ../misc-utils/wipefs.8.adoc:45
20778 "Create a signature backup to the file _$HOME/wipefs-<devname>-<offset>.bak_. "
20779 "For more details see the *EXAMPLE* section."
20782 #. type: Plain text
20783 #: ../misc-utils/wipefs.8.adoc:48
20785 "Force erasure, even if the filesystem is mounted. This is required in order "
20786 "to erase a partition-table signature on a block device."
20789 #. type: Plain text
20790 #: ../misc-utils/wipefs.8.adoc:54
20792 "Use exclusive BSD lock for device or file it operates. The optional argument "
20793 "_mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument "
20794 "is omitted, it defaults to *\"yes\"*. This option overwrites environment "
20795 "variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, "
20796 "but it's recommended to avoid collisions with udevd or other tools."
20799 #. type: Labeled list
20800 #: ../misc-utils/wipefs.8.adoc:55
20802 #| msgid "*-V*, *--version*"
20803 msgid "*-i*, *--noheadings*"
20804 msgstr "*-V*, *--version*"
20806 #. type: Labeled list
20807 #: ../misc-utils/wipefs.8.adoc:58
20809 #| msgid "*-P*, *--pty*"
20810 msgid "*-O*, *--output* _list_"
20811 msgstr "*-P*, *--pty*"
20813 #. type: Plain text
20814 #: ../misc-utils/wipefs.8.adoc:63
20815 msgid "Causes everything to be done except for the *write*(2) call."
20818 #. type: Plain text
20819 #: ../misc-utils/wipefs.8.adoc:66
20821 "Specify the location (in bytes) of the signature which should be erased from "
20822 "the device. The _offset_ number may include a \"0x\" prefix; then the number "
20823 "will be interpreted as a hex value. It is possible to specify multiple *-o* "
20827 #. type: Plain text
20828 #: ../misc-utils/wipefs.8.adoc:68
20830 "The _offset_ argument may be followed by the multiplicative suffixes KiB "
20831 "(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
20832 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
20833 "the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
20837 #. type: Labeled list
20838 #: ../misc-utils/wipefs.8.adoc:69
20840 #| msgid "*-f*, *--fast*"
20841 msgid "*-p*, *--parsable*"
20842 msgstr "*-f*, *--fast*"
20844 #. type: Plain text
20845 #: ../misc-utils/wipefs.8.adoc:71
20847 "Print out in parsable instead of printable format. Encode all potentially "
20848 "unsafe characters of a string to the corresponding hex value prefixed by "
20852 #. type: Plain text
20853 #: ../misc-utils/wipefs.8.adoc:74
20854 msgid "Suppress any messages after a successful signature wipe."
20857 #. type: Plain text
20858 #: ../misc-utils/wipefs.8.adoc:77
20860 "Limit the set of printed or erased signatures. More than one type may be "
20861 "specified in a comma-separated list. The list or individual types can be "
20862 "prefixed with 'no' to specify the types on which no action should be taken. "
20863 "For more details see *mount*(8)."
20866 #. type: Plain text
20867 #: ../misc-utils/wipefs.8.adoc:84
20868 msgid "enables *libblkid*(3) debug output."
20871 #. type: Labeled list
20872 #: ../misc-utils/wipefs.8.adoc:90
20874 msgid "*wipefs /dev/sda**"
20877 #. type: Plain text
20878 #: ../misc-utils/wipefs.8.adoc:92
20879 msgid "Prints information about sda and all partitions on sda."
20882 #. type: Labeled list
20883 #: ../misc-utils/wipefs.8.adoc:93
20885 msgid "*wipefs --all --backup /dev/sdb*"
20888 #. type: Plain text
20889 #: ../misc-utils/wipefs.8.adoc:95
20891 "Erases all signatures from the device _/dev/sdb_ and creates a signature "
20892 "backup file _~/wipefs-sdb-<offset>.bak_ for each signature."
20895 #. type: Labeled list
20896 #: ../misc-utils/wipefs.8.adoc:96
20898 msgid "*dd if=~/wipefs-sdb-0x00000438.bak of=/dev/sdb seek=$\\((0x00000438)) bs=1 conv=notrunc*"
20901 #. type: Plain text
20902 #: ../misc-utils/wipefs.8.adoc:98
20904 "Restores an ext2 signature from the backup file _~/wipefs-sdb-0x00000438."
20914 #. Copyright (C) 2004 Robert Love
20915 #. Copyright (C) 2015 Karel Zak <kzak@redhat.com>
20916 #. This is free documentation; you can redistribute it and/or
20917 #. modify it under the terms of the GNU General Public License,
20918 #. version 2, as published by the Free Software Foundation.
20919 #. The GNU General Public License's references to "object code"
20920 #. and "executables" are to be interpreted as the output of any
20921 #. document formatting or typesetting system, including
20922 #. intermediate and printed output.
20923 #. This manual is distributed in the hope that it will be useful,
20924 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
20925 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20926 #. GNU General Public License for more details.
20927 #. You should have received a copy of the GNU General Public License along
20928 #. with this program; if not, write to the Free Software Foundation, Inc.,
20929 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20931 #: ../schedutils/chrt.1.adoc:26
20936 #. type: Plain text
20937 #: ../schedutils/chrt.1.adoc:37
20938 msgid "chrt - manipulate the real-time attributes of a process"
20941 #. type: Plain text
20942 #: ../schedutils/chrt.1.adoc:41
20944 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
20945 msgid "*chrt* [options] _priority command argument_ ...\n"
20946 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
20948 #. type: Plain text
20949 #: ../schedutils/chrt.1.adoc:43
20951 msgid "*chrt* [options] *-p* [_priority_] _PID_\n"
20954 #. type: Plain text
20955 #: ../schedutils/chrt.1.adoc:47
20957 msgid "*chrt* sets or retrieves the real-time scheduling attributes of an existing _PID_, or runs _command_ with the given attributes.\n"
20961 #: ../schedutils/chrt.1.adoc:48
20966 #. type: Labeled list
20967 #: ../schedutils/chrt.1.adoc:50
20969 #| msgid "*-h*, *--help*"
20970 msgid "*-o*, *--other*"
20971 msgstr "*-h*, *--help*"
20973 #. type: Plain text
20974 #: ../schedutils/chrt.1.adoc:52
20976 "Set scheduling policy to *SCHED_OTHER* (time-sharing scheduling). This is "
20977 "the default Linux scheduling policy."
20980 #. type: Labeled list
20981 #: ../schedutils/chrt.1.adoc:53
20983 #| msgid "*-f*, *--fast*"
20984 msgid "*-f*, *--fifo*"
20985 msgstr "*-f*, *--fast*"
20987 #. type: Plain text
20988 #: ../schedutils/chrt.1.adoc:55
20989 msgid "Set scheduling policy to *SCHED_FIFO* (first in-first out)."
20992 #. type: Labeled list
20993 #: ../schedutils/chrt.1.adoc:56
20995 #| msgid "*-P*, *--pty*"
20996 msgid "*-r*, *--rr*"
20997 msgstr "*-P*, *--pty*"
20999 #. type: Plain text
21000 #: ../schedutils/chrt.1.adoc:58
21002 "Set scheduling policy to *SCHED_RR* (round-robin scheduling). When no policy "
21003 "is defined, the *SCHED_RR* is used as the default."
21006 #. type: Labeled list
21007 #: ../schedutils/chrt.1.adoc:59
21009 #| msgid "*-f*, *--fast*"
21010 msgid "*-b*, *--batch*"
21011 msgstr "*-f*, *--fast*"
21013 #. type: Plain text
21014 #: ../schedutils/chrt.1.adoc:61
21016 "Set scheduling policy to *SCHED_BATCH* (scheduling batch processes). Linux-"
21017 "specific, supported since 2.6.16. The priority argument has to be set to "
21021 #. type: Labeled list
21022 #: ../schedutils/chrt.1.adoc:62
21024 #| msgid "*-h*, *--help*"
21025 msgid "*-i*, *--idle*"
21026 msgstr "*-h*, *--help*"
21028 #. type: Plain text
21029 #: ../schedutils/chrt.1.adoc:64
21031 "Set scheduling policy to *SCHED_IDLE* (scheduling very low priority jobs). "
21032 "Linux-specific, supported since 2.6.23. The priority argument has to be set "
21036 #. type: Labeled list
21037 #: ../schedutils/chrt.1.adoc:65
21039 #| msgid "*-h*, *--help*"
21040 msgid "*-d*, *--deadline*"
21041 msgstr "*-h*, *--help*"
21043 #. type: Plain text
21044 #: ../schedutils/chrt.1.adoc:67
21046 "Set scheduling policy to *SCHED_DEADLINE* (sporadic task model deadline "
21047 "scheduling). Linux-specific, supported since 3.14. The priority argument has "
21048 "to be set to zero. See also *--sched-runtime*, *--sched-deadline* and *--"
21049 "sched-period*. The relation between the options required by the kernel is "
21050 "runtime <= deadline <= period. *chrt* copies _period_ to _deadline_ if *--"
21051 "sched-deadline* is not specified and _deadline_ to _runtime_ if *--sched-"
21052 "runtime* is not specified. It means that at least *--sched-period* has to be "
21053 "specified. See *sched*(7) for more details."
21057 #: ../schedutils/chrt.1.adoc:68
21059 msgid "SCHEDULING OPTIONS"
21062 #. type: Labeled list
21063 #: ../schedutils/chrt.1.adoc:70
21065 msgid "*-T*, *--sched-runtime* _nanoseconds_"
21068 #. type: Plain text
21069 #: ../schedutils/chrt.1.adoc:72
21071 "Specifies runtime parameter for *SCHED_DEADLINE* policy (Linux-specific)."
21074 #. type: Labeled list
21075 #: ../schedutils/chrt.1.adoc:73
21077 msgid "*-P*, *--sched-period* _nanoseconds_"
21080 #. type: Plain text
21081 #: ../schedutils/chrt.1.adoc:75
21083 "Specifies period parameter for *SCHED_DEADLINE* policy (Linux-specific). "
21084 "Note that the kernel's lower limit is 100 milliseconds."
21087 #. type: Labeled list
21088 #: ../schedutils/chrt.1.adoc:76
21090 msgid "*-D*, *--sched-deadline* _nanoseconds_"
21093 #. type: Plain text
21094 #: ../schedutils/chrt.1.adoc:78
21096 "Specifies deadline parameter for *SCHED_DEADLINE* policy (Linux-specific)."
21099 #. type: Labeled list
21100 #: ../schedutils/chrt.1.adoc:79 ../schedutils/uclampset.1.adoc:84
21102 #| msgid "*-V*, *--version*"
21103 msgid "*-R*, *--reset-on-fork*"
21104 msgstr "*-V*, *--version*"
21106 #. type: Plain text
21107 #: ../schedutils/chrt.1.adoc:81
21109 "Use *SCHED_RESET_ON_FORK* or *SCHED_FLAG_RESET_ON_FORK* flag. Linux-"
21110 "specific, supported since 2.6.31."
21113 #. type: Plain text
21114 #: ../schedutils/chrt.1.adoc:83
21116 "Each thread has a _reset-on-fork_ scheduling flag. When this flag is set, "
21117 "children created by *fork*(2) do not inherit privileged scheduling policies. "
21118 "After the _reset-on-fork_ flag has been enabled, it can be reset only if the "
21119 "thread has the *CAP_SYS_NICE* capability. This flag is disabled in child "
21120 "processes created by *fork*(2)."
21123 #. type: Plain text
21124 #: ../schedutils/chrt.1.adoc:85
21126 "More precisely, if the _reset-on-fork_ flag is set, the following rules "
21127 "apply for subsequently created children:"
21130 #. type: Plain text
21131 #: ../schedutils/chrt.1.adoc:87
21133 "If the calling thread has a scheduling policy of *SCHED_FIFO* or *SCHED_RR*, "
21134 "the policy is reset to *SCHED_OTHER* in child processes."
21137 #. type: Plain text
21138 #: ../schedutils/chrt.1.adoc:89
21140 "If the calling process has a negative nice value, the nice value is reset to "
21141 "zero in child processes."
21144 #. type: Labeled list
21145 #: ../schedutils/chrt.1.adoc:92 ../schedutils/taskset.1.adoc:71
21146 #: ../schedutils/uclampset.1.adoc:75
21148 #| msgid "*-f*, *--fast*"
21149 msgid "*-a*, *--all-tasks*"
21150 msgstr "*-f*, *--fast*"
21152 #. type: Plain text
21153 #: ../schedutils/chrt.1.adoc:94
21155 "Set or retrieve the scheduling attributes of all the tasks (threads) for a "
21159 #. type: Labeled list
21160 #: ../schedutils/chrt.1.adoc:95
21162 #| msgid "*-f*, *--fast*"
21163 msgid "*-m*, *--max*"
21164 msgstr "*-f*, *--fast*"
21166 #. type: Plain text
21167 #: ../schedutils/chrt.1.adoc:97
21168 msgid "Show minimum and maximum valid priorities, then exit."
21171 #. type: Plain text
21172 #: ../schedutils/chrt.1.adoc:100 ../schedutils/taskset.1.adoc:79
21173 #: ../schedutils/uclampset.1.adoc:80
21174 msgid "Operate on an existing PID and do not launch a new task."
21177 #. type: Plain text
21178 #: ../schedutils/chrt.1.adoc:103 ../schedutils/uclampset.1.adoc:89
21179 msgid "Show status information."
21182 #. TRANSLATORS: Keep {colon} untranslated.
21183 #. type: Labeled list
21184 #: ../schedutils/chrt.1.adoc:109 ../schedutils/uclampset.1.adoc:95
21186 msgid "The default behavior is to run a new command{colon}"
21189 #. type: delimited block _
21190 #: ../schedutils/chrt.1.adoc:112
21192 msgid "*chrt* _priority_ _command_ [_arguments_]\n"
21195 #. TRANSLATORS: Keep {colon} untranslated
21196 #. type: Labeled list
21197 #: ../schedutils/chrt.1.adoc:114
21199 msgid "You can also retrieve the real-time attributes of an existing task{colon}"
21202 #. type: delimited block _
21203 #: ../schedutils/chrt.1.adoc:117
21205 msgid "*chrt -p* _PID_\n"
21208 #. TRANSLATORS: Keep {colon} untranslated.
21209 #. type: Labeled list
21210 #: ../schedutils/chrt.1.adoc:119 ../schedutils/uclampset.1.adoc:103
21212 msgid "Or set them{colon}"
21215 #. type: delimited block _
21216 #: ../schedutils/chrt.1.adoc:122
21218 msgid "*chrt -r -p* _priority PID_\n"
21221 #. type: Labeled list
21222 #: ../schedutils/chrt.1.adoc:123
21224 msgid "This, for example, sets real-time scheduling to priority _30_ for the process _PID_ with the *SCHED_RR* (round-robin) class{colon}"
21227 #. type: delimited block _
21228 #: ../schedutils/chrt.1.adoc:126
21230 msgid "*chrt -r -p 30* _PID_\n"
21233 #. type: Labeled list
21234 #: ../schedutils/chrt.1.adoc:127
21236 msgid "Reset priorities to default for a process{colon}"
21239 #. type: delimited block _
21240 #: ../schedutils/chrt.1.adoc:130
21242 msgid "*chrt -o -p 0* _PID_\n"
21245 #. type: Plain text
21246 #: ../schedutils/chrt.1.adoc:132
21248 "See *sched*(7) for a detailed discussion of the different scheduler classes "
21249 "and how they interact."
21253 #: ../schedutils/chrt.1.adoc:133 ../schedutils/taskset.1.adoc:104
21254 #: ../schedutils/uclampset.1.adoc:110
21256 msgid "PERMISSIONS"
21259 #. type: Plain text
21260 #: ../schedutils/chrt.1.adoc:136 ../schedutils/uclampset.1.adoc:113
21262 "A user must possess *CAP_SYS_NICE* to change the scheduling attributes of a "
21263 "process. Any user can retrieve the scheduling information."
21266 #. type: Plain text
21267 #: ../schedutils/chrt.1.adoc:140
21269 "Only *SCHED_FIFO*, *SCHED_OTHER* and *SCHED_RR* are part of POSIX 1003.1b "
21270 "Process Scheduling. The other scheduling attributes may be ignored on some "
21274 #. type: Plain text
21275 #: ../schedutils/chrt.1.adoc:142
21276 msgid "Linux' default scheduling policy is *SCHED_OTHER*."
21279 #. type: Plain text
21280 #: ../schedutils/chrt.1.adoc:147
21281 msgid "mailto:rml@tech9.net[Robert Love], mailto:kzak@redhat.com[Karel Zak]"
21284 #. type: Plain text
21285 #: ../schedutils/chrt.1.adoc:154 ../schedutils/uclampset.1.adoc:136
21301 #. type: Plain text
21302 #: ../schedutils/chrt.1.adoc:156
21304 "See *sched_setscheduler*(2) for a description of the Linux scheduling scheme."
21308 #: ../schedutils/ionice.1.adoc:2
21313 #. type: Plain text
21314 #: ../schedutils/ionice.1.adoc:13
21315 msgid "ionice - set or get process I/O scheduling class and priority"
21318 #. type: Plain text
21319 #: ../schedutils/ionice.1.adoc:17
21321 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-p* _PID_\n"
21324 #. type: Plain text
21325 #: ../schedutils/ionice.1.adoc:19
21327 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-P* _PGID_\n"
21330 #. type: Plain text
21331 #: ../schedutils/ionice.1.adoc:21
21333 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-u* _UID_\n"
21336 #. type: Plain text
21337 #: ../schedutils/ionice.1.adoc:23
21339 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] _command_ [argument] ...\n"
21342 #. type: Plain text
21343 #: ../schedutils/ionice.1.adoc:27
21345 "This program sets or gets the I/O scheduling class and priority for a "
21346 "program. If no arguments or just *-p* is given, *ionice* will query the "
21347 "current I/O scheduling class and priority for that process."
21350 #. type: Plain text
21351 #: ../schedutils/ionice.1.adoc:29
21353 "When _command_ is given, *ionice* will run this command with the given "
21354 "arguments. If no _class_ is specified, then _command_ will be executed with "
21355 "the \"best-effort\" scheduling class. The default priority level is 4."
21358 #. type: Plain text
21359 #: ../schedutils/ionice.1.adoc:31
21361 "As of this writing, a process can be in one of three scheduling classes:"
21364 #. type: Labeled list
21365 #: ../schedutils/ionice.1.adoc:32
21370 #. type: Plain text
21371 #: ../schedutils/ionice.1.adoc:34
21373 "A program running with idle I/O priority will only get disk time when no "
21374 "other program has asked for disk I/O for a defined grace period. The impact "
21375 "of an idle I/O process on normal system activity should be zero. This "
21376 "scheduling class does not take a priority argument. Presently, this "
21377 "scheduling class is permitted for an ordinary user (since kernel 2.6.25)."
21380 #. type: Labeled list
21381 #: ../schedutils/ionice.1.adoc:35
21383 msgid "*Best-effort*"
21386 #. type: Plain text
21387 #: ../schedutils/ionice.1.adoc:37
21389 "This is the effective scheduling class for any process that has not asked "
21390 "for a specific I/O priority. This class takes a priority argument from "
21391 "_0-7_, with a lower number being higher priority. Programs running at the "
21392 "same best-effort priority are served in a round-robin fashion."
21395 #. TRANSLATORS: Keep {plus} untranslated.
21396 #. type: Plain text
21397 #: ../schedutils/ionice.1.adoc:39
21399 "Note that before kernel 2.6.26 a process that has not asked for an I/O "
21400 "priority formally uses \"*none*\" as scheduling class, but the I/O scheduler "
21401 "will treat such processes as if it were in the best-effort class. The "
21402 "priority within the best-effort class will be dynamically derived from the "
21403 "CPU nice level of the process: io_priority = (cpu_nice {plus} 20) / 5."
21406 #. type: Plain text
21407 #: ../schedutils/ionice.1.adoc:42
21409 "For kernels after 2.6.26 with the CFQ I/O scheduler, a process that has not "
21410 "asked for an I/O priority inherits its CPU scheduling class. The I/O "
21411 "priority is derived from the CPU nice level of the process (same as before "
21415 #. type: Labeled list
21416 #: ../schedutils/ionice.1.adoc:43
21421 #. type: Plain text
21422 #: ../schedutils/ionice.1.adoc:45
21424 "The RT scheduling class is given first access to the disk, regardless of "
21425 "what else is going on in the system. Thus the RT class needs to be used with "
21426 "some care, as it can starve other processes. As with the best-effort class, "
21427 "8 priority levels are defined denoting how big a time slice a given process "
21428 "will receive on each scheduling window. This scheduling class is not "
21429 "permitted for an ordinary (i.e., non-root) user."
21432 #. type: Labeled list
21433 #: ../schedutils/ionice.1.adoc:48
21435 msgid "*-c*, *--class* _class_"
21438 #. type: Plain text
21439 #: ../schedutils/ionice.1.adoc:50
21441 "Specify the name or number of the scheduling class to use; `0` for none, `1` "
21442 "for realtime, `2` for best-effort, `3` for idle."
21445 #. type: Labeled list
21446 #: ../schedutils/ionice.1.adoc:51
21448 msgid "*-n*, *--classdata* _level_"
21451 #. type: Plain text
21452 #: ../schedutils/ionice.1.adoc:53
21454 "Specify the scheduling class data. This only has an effect if the class "
21455 "accepts an argument. For realtime and best-effort, _0-7_ are valid data "
21456 "(priority levels), and `0` represents the highest priority level."
21459 #. type: Labeled list
21460 #: ../schedutils/ionice.1.adoc:54
21462 msgid "*-p*, *--pid* _PID_..."
21465 #. type: Plain text
21466 #: ../schedutils/ionice.1.adoc:56
21468 "Specify the process IDs of running processes for which to get or set the "
21469 "scheduling parameters."
21472 #. type: Labeled list
21473 #: ../schedutils/ionice.1.adoc:57
21475 msgid "*-P*, *--pgid* _PGID_..."
21478 #. type: Plain text
21479 #: ../schedutils/ionice.1.adoc:59
21481 "Specify the process group IDs of running processes for which to get or set "
21482 "the scheduling parameters."
21485 #. type: Labeled list
21486 #: ../schedutils/ionice.1.adoc:60
21488 #| msgid "*-h*, *--help*"
21489 msgid "*-t*, *--ignore*"
21490 msgstr "*-h*, *--help*"
21492 #. type: Plain text
21493 #: ../schedutils/ionice.1.adoc:62
21495 "Ignore failure to set the requested priority. If _command_ was specified, "
21496 "run it even in case it was not possible to set the desired scheduling "
21497 "priority, which can happen due to insufficient privileges or an old kernel "
21501 #. type: Labeled list
21502 #: ../schedutils/ionice.1.adoc:63
21504 msgid "*-u*, *--uid* _UID_..."
21507 #. type: Plain text
21508 #: ../schedutils/ionice.1.adoc:65
21510 "Specify the user IDs of running processes for which to get or set the "
21511 "scheduling parameters."
21514 #. type: Plain text
21515 #: ../schedutils/ionice.1.adoc:71
21517 "Linux supports I/O scheduling priorities and classes since 2.6.13 with the "
21518 "CFQ I/O scheduler."
21521 #. type: Plain text
21522 #: ../schedutils/ionice.1.adoc:75
21523 msgid "# *ionice* -c 3 -p 89"
21526 #. type: Plain text
21527 #: ../schedutils/ionice.1.adoc:77
21528 msgid "Sets process with PID 89 as an idle I/O process."
21531 #. type: Plain text
21532 #: ../schedutils/ionice.1.adoc:79
21533 msgid "# *ionice* -c 2 -n 0 bash"
21536 #. type: Plain text
21537 #: ../schedutils/ionice.1.adoc:81
21538 msgid "Runs 'bash' as a best-effort program with highest priority."
21541 #. type: Plain text
21542 #: ../schedutils/ionice.1.adoc:83
21543 msgid "# *ionice* -p 89 91"
21546 #. type: Plain text
21547 #: ../schedutils/ionice.1.adoc:85
21548 msgid "Prints the class and priority of the processes with PID 89 and 91."
21551 #. type: Plain text
21552 #: ../schedutils/ionice.1.adoc:90
21553 msgid "mailto:jens@axboe.dk[Jens Axboe], mailto:kzak@redhat.com[Karel Zak]"
21556 #. type: Plain text
21557 #: ../schedutils/ionice.1.adoc:94
21559 msgid "*ioprio_set*(2)\n"
21566 #. taskset(1) manpage
21567 #. Copyright (C) 2004 Robert Love
21568 #. This is free documentation; you can redistribute it and/or
21569 #. modify it under the terms of the GNU General Public License,
21570 #. version 2, as published by the Free Software Foundation.
21571 #. The GNU General Public License's references to "object code"
21572 #. and "executables" are to be interpreted as the output of any
21573 #. document formatting or typesetting system, including
21574 #. intermediate and printed output.
21575 #. This manual is distributed in the hope that it will be useful,
21576 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
21577 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21578 #. GNU General Public License for more details.
21579 #. You should have received a copy of the GNU General Public License along
21580 #. with this program; if not, write to the Free Software Foundation, Inc.,
21581 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21583 #: ../schedutils/taskset.1.adoc:24
21588 #. type: Plain text
21589 #: ../schedutils/taskset.1.adoc:36
21590 msgid "taskset - set or retrieve a process's CPU affinity"
21593 #. type: Plain text
21594 #: ../schedutils/taskset.1.adoc:40
21596 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21597 msgid "*taskset* [options] _mask command_ [_argument_...]\n"
21598 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21600 #. type: Plain text
21601 #: ../schedutils/taskset.1.adoc:42
21603 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21604 msgid "*taskset* [options] *-p* [_mask_] _pid_\n"
21605 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21607 #. type: Plain text
21608 #: ../schedutils/taskset.1.adoc:46
21610 msgid "The *taskset* command is used to set or retrieve the CPU affinity of a running process given its _pid_, or to launch a new _command_ with a given CPU affinity. CPU affinity is a scheduler property that \"bonds\" a process to a given set of CPUs on the system. The Linux scheduler will honor the given CPU affinity and the process will not run on any other CPUs. Note that the Linux scheduler also supports natural CPU affinity: the scheduler attempts to keep processes on the same CPU as long as practical for performance reasons. Therefore, forcing a specific CPU affinity is useful only in certain applications. The affinity of some processes like kernel per-CPU threads cannot be set.\n"
21613 #. type: Plain text
21614 #: ../schedutils/taskset.1.adoc:48
21616 "The CPU affinity is represented as a bitmask, with the lowest order bit "
21617 "corresponding to the first logical CPU and the highest order bit "
21618 "corresponding to the last logical CPU. Not all CPUs may exist on a given "
21619 "system but a mask may specify more CPUs than are present. A retrieved mask "
21620 "will reflect only the bits that correspond to CPUs physically on the system. "
21621 "If an invalid mask is given (i.e., one that corresponds to no valid CPUs on "
21622 "the current system) an error is returned. The masks may be specified in "
21623 "hexadecimal (with or without a leading \"0x\"), or as a CPU list with the *--"
21624 "cpu-list* option. For example,"
21627 #. type: Labeled list
21628 #: ../schedutils/taskset.1.adoc:49
21630 msgid "*0x00000001*"
21633 #. type: Plain text
21634 #: ../schedutils/taskset.1.adoc:51
21635 msgid "is processor #0,"
21638 #. type: Labeled list
21639 #: ../schedutils/taskset.1.adoc:52
21641 msgid "*0x00000003*"
21644 #. type: Plain text
21645 #: ../schedutils/taskset.1.adoc:54
21646 msgid "is processors #0 and #1,"
21649 #. type: Labeled list
21650 #: ../schedutils/taskset.1.adoc:55
21655 #. type: Plain text
21656 #: ../schedutils/taskset.1.adoc:57
21657 msgid "is processors #0 through #31,"
21660 #. type: Labeled list
21661 #: ../schedutils/taskset.1.adoc:58
21666 #. type: Plain text
21667 #: ../schedutils/taskset.1.adoc:60
21668 msgid "is processors #1, #4, and #5,"
21671 #. type: Labeled list
21672 #: ../schedutils/taskset.1.adoc:61
21674 msgid "*--cpu-list 0-2,6*"
21677 #. type: Plain text
21678 #: ../schedutils/taskset.1.adoc:63
21679 msgid "is processors #0, #1, #2, and #6."
21682 #. type: Labeled list
21683 #: ../schedutils/taskset.1.adoc:64
21685 msgid "*--cpu-list 0-10:2*"
21688 #. type: Plain text
21689 #: ../schedutils/taskset.1.adoc:66
21691 "is processors #0, #2, #4, #6, #8 and #10. The suffix \":N\" specifies stride "
21692 "in the range, for example 0-10:3 is interpreted as 0,3,6,9 list."
21695 #. type: Plain text
21696 #: ../schedutils/taskset.1.adoc:68
21698 "When *taskset* returns, it is guaranteed that the given program has been "
21699 "scheduled to a legal CPU."
21702 #. type: Plain text
21703 #: ../schedutils/taskset.1.adoc:73
21705 "Set or retrieve the CPU affinity of all the tasks (threads) for a given PID."
21708 #. type: Labeled list
21709 #: ../schedutils/taskset.1.adoc:74
21711 #| msgid "*-P*, *--pty*"
21712 msgid "*-c*, *--cpu-list*"
21713 msgstr "*-P*, *--pty*"
21715 #. type: Plain text
21716 #: ../schedutils/taskset.1.adoc:76
21718 "Interpret _mask_ as numerical list of processors instead of a bitmask. "
21719 "Numbers are separated by commas and may include ranges. For example: "
21724 #: ../schedutils/taskset.1.adoc:82 ../schedutils/uclampset.1.adoc:92
21729 #. TRANSLATORS: Keep {colon} untranslated.
21730 #. type: Labeled list
21731 #: ../schedutils/taskset.1.adoc:85
21733 msgid "The default behavior is to run a new command with a given affinity mask{colon}"
21736 #. type: Plain text
21737 #: ../schedutils/taskset.1.adoc:87
21739 msgid "*taskset* _mask_ _command_ [_arguments_]\n"
21742 #. TRANSLATORS: Keep {colon} untranslated.
21743 #. type: Labeled list
21744 #: ../schedutils/taskset.1.adoc:89
21746 msgid "You can also retrieve the CPU affinity of an existing task{colon}"
21749 #. type: Plain text
21750 #: ../schedutils/taskset.1.adoc:91
21752 msgid "*taskset -p* _pid_\n"
21755 #. TRANSLATORS: Keep {colon} untranslated.
21756 #. type: Labeled list
21757 #: ../schedutils/taskset.1.adoc:93
21759 msgid "Or set it{colon}"
21762 #. type: Plain text
21763 #: ../schedutils/taskset.1.adoc:95
21765 msgid "*taskset -p* _mask pid_\n"
21768 #. TRANSLATORS: Keep {colon} untranslated.
21769 #. type: Labeled list
21770 #: ../schedutils/taskset.1.adoc:97
21772 msgid "When a cpu-list is specified for an existing process, the *-p* and *-c* options must be grouped together{colon}"
21775 #. type: Plain text
21776 #: ../schedutils/taskset.1.adoc:99
21778 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21779 msgid "*taskset -pc* _cpu-list pid_\n"
21780 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21782 #. TRANSLATORS: Keep {colon} untranslated.
21783 #. type: Labeled list
21784 #: ../schedutils/taskset.1.adoc:101
21786 msgid "The *--cpu-list* form is applicable only for launching new commands{colon}"
21789 #. type: Plain text
21790 #: ../schedutils/taskset.1.adoc:103
21792 msgid "*taskset --cpu-list* _cpu-list command_\n"
21795 #. type: Plain text
21796 #: ../schedutils/taskset.1.adoc:107
21798 "A user can change the CPU affinity of a process belonging to the same user. "
21799 "A user must possess *CAP_SYS_NICE* to change the CPU affinity of a process "
21800 "belonging to another user. A user can retrieve the affinity mask of any "
21804 #. type: Plain text
21805 #: ../schedutils/taskset.1.adoc:111
21807 msgid "*taskset* returns 0 in its affinity-getting mode as long as the provided PID exists.\n"
21810 #. type: Plain text
21811 #: ../schedutils/taskset.1.adoc:113
21813 msgid "*taskset* returns 0 in its affinity-setting mode as long as the underlying *sched_setaffinity*(2) system call does. The success of the command does not guarantee that the specified thread has actually migrated to the indicated CPU(s), but only that the thread will not migrate to a CPU outside the new affinity mask. For example, the affinity of the kernel thread kswapd can be set, but the thread may not immediately migrate and is not guaranteed to ever do so:\n"
21816 #. type: Plain text
21817 #: ../schedutils/taskset.1.adoc:125
21820 "$ ps ax -o comm,psr,pid | grep kswapd +\n"
21822 "$ sudo taskset -p 1 82 +\n"
21823 "pid 82's current affinity mask: 1 +\n"
21824 "pid 82's new affinity mask: 1 +\n"
21827 "$ ps ax -o comm,psr,pid | grep kswapd +\n"
21829 "$ taskset -p 82 +\n"
21830 "pid 82's current affinity mask: 1 +\n"
21833 #. type: Plain text
21834 #: ../schedutils/taskset.1.adoc:127
21836 "In contrast, when the user specifies an illegal affinity, taskset will print "
21837 "an error and return 1:"
21840 #. type: Plain text
21841 #: ../schedutils/taskset.1.adoc:135
21844 "$ ps ax -o comm,psr,pid | grep ksoftirqd/0 +\n"
21845 "ksoftirqd/0 0 14 +\n"
21846 "$ sudo taskset -p 1 14 +\n"
21847 "pid 14's current affinity mask: 1 +\n"
21848 "taskset: failed to set pid 14's affinity: Invalid argument +\n"
21853 #. type: Plain text
21854 #: ../schedutils/taskset.1.adoc:139
21855 msgid "Written by Robert M. Love."
21859 #: ../schedutils/taskset.1.adoc:140 ../sys-utils/chcpu.8.adoc:72
21860 #: ../sys-utils/flock.1.adoc:126 ../sys-utils/rtcwake.8.adoc:126
21861 #: ../term-utils/scriptlive.1.adoc:66 ../term-utils/scriptreplay.1.adoc:83
21866 #. TRANSLATORS: Keep {copyright} untranslated.
21867 #. type: Plain text
21868 #: ../schedutils/taskset.1.adoc:144
21870 "Copyright {copyright} 2004 Robert M. Love. This is free software; see the "
21871 "source for copying conditions. There is NO warranty; not even for "
21872 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
21875 #. type: Plain text
21876 #: ../schedutils/taskset.1.adoc:152
21882 "*sched_getaffinity*(2),\n"
21883 "*sched_setaffinity*(2)\n"
21886 #. type: Plain text
21887 #: ../schedutils/taskset.1.adoc:154
21888 msgid "See *sched*(7) for a description of the Linux scheduling scheme."
21896 #. uclampset(1) manpage
21897 #. Copyright (C) 2020-2021 Qais Yousef <qyousef@layalina.io>
21898 #. Copyright (C) 2020-2021 Arm Ltd
21899 #. This is free documentation; you can redistribute it and/or
21900 #. modify it under the terms of the GNU General Public License,
21901 #. version 2, as published by the Free Software Foundation.
21902 #. The GNU General Public License's references to "object code"
21903 #. and "executables" are to be interpreted as the output of any
21904 #. document formatting or typesetting system, including
21905 #. intermediate and printed output.
21906 #. This manual is distributed in the hope that it will be useful,
21907 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
21908 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21909 #. GNU General Public License for more details.
21910 #. You should have received a copy of the GNU General Public License along
21911 #. with this program; if not, write to the Free Software Foundation, Inc.,
21912 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21914 #: ../schedutils/uclampset.1.adoc:26
21916 msgid "uclampset(1)"
21919 #. type: Plain text
21920 #: ../schedutils/uclampset.1.adoc:38
21922 "uclampset - manipulate the utilization clamping attributes of the system or "
21926 #. type: Plain text
21927 #: ../schedutils/uclampset.1.adoc:42
21929 msgid "*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max] _command argument_\n"
21932 #. type: Plain text
21933 #: ../schedutils/uclampset.1.adoc:44
21935 msgid "*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max_] *-p* _PID_\n"
21938 #. type: Plain text
21939 #: ../schedutils/uclampset.1.adoc:48
21941 msgid "*uclampset* sets or retrieves the utilization clamping attributes of an existing _PID_, or runs _command_ with the given attributes.\n"
21944 #. type: Plain text
21945 #: ../schedutils/uclampset.1.adoc:50
21947 "Utilization clamping is a new feature added in v5.3. It gives a hint to the "
21948 "scheduler about the allowed range of utilization the task should be "
21952 #. type: Plain text
21953 #: ../schedutils/uclampset.1.adoc:52
21955 "The utilization of the task affects frequency selection and task placement. "
21956 "Only schedutil cpufreq governor understands handling util clamp hints at the "
21957 "time of writing. Consult your kernel docs for further info about other "
21958 "cpufreq governors support."
21961 #. type: Plain text
21962 #: ../schedutils/uclampset.1.adoc:54
21964 "If you're running on asymmetric heterogeneous system like Arm's big.LITTLE. "
21965 "Utilization clamping can help bias task placement. If the task is boosted "
21966 "such that _util_min_ value is higher than the little cores' capacity, then "
21967 "the scheduler will do its best to place it on a big core."
21970 #. type: Plain text
21971 #: ../schedutils/uclampset.1.adoc:56
21973 "Similarly, if _util_max_ is smaller than or equal the capacity of the little "
21974 "cores, then the scheduler can still choose to place it there even if the "
21975 "actual utilization of the task is at max."
21978 #. type: Plain text
21979 #: ../schedutils/uclampset.1.adoc:58
21981 "Setting a task's _uclamp_min_ to a none zero value will effectively boost "
21982 "the task as when it runs it'll always start from this utilization value."
21985 #. type: Plain text
21986 #: ../schedutils/uclampset.1.adoc:60
21988 "By setting a task's _uclamp_max_ below 1024, this will effectively cap the "
21989 "task as when it runs it'll never be able to go above this utilization value."
21992 #. type: Plain text
21993 #: ../schedutils/uclampset.1.adoc:62
21995 "The full utilization range is: [0:1024]. The special value -1 is used to "
21996 "reset to system's default."
21999 #. type: Plain text
22000 #: ../schedutils/uclampset.1.adoc:64
22001 msgid "Consult latest kernel documentation for more details:"
22004 #. type: Plain text
22005 #: ../schedutils/uclampset.1.adoc:66
22007 msgid "\thttps://kernel.org/doc/html/latest/scheduler/sched-util-clamp.html\n"
22010 #. type: Plain text
22011 #: ../schedutils/uclampset.1.adoc:71
22012 msgid "Set _util_min_ value."
22015 #. type: Plain text
22016 #: ../schedutils/uclampset.1.adoc:74
22017 msgid "Set _util_max_ value."
22020 #. type: Plain text
22021 #: ../schedutils/uclampset.1.adoc:77
22023 "Set or retrieve the utilization clamping attributes of all the tasks "
22024 "(threads) for a given PID."
22027 #. type: Labeled list
22028 #: ../schedutils/uclampset.1.adoc:81
22030 #| msgid "*-f*, *--fast*"
22031 msgid "*-s*, *--system*"
22032 msgstr "*-f*, *--fast*"
22034 #. type: Plain text
22035 #: ../schedutils/uclampset.1.adoc:83
22036 msgid "Set or retrieve the system-wide utilization clamping attributes."
22039 #. type: Plain text
22040 #: ../schedutils/uclampset.1.adoc:86
22041 msgid "Set *SCHED_FLAG_RESET_ON_FORK* flag."
22044 #. type: Plain text
22045 #: ../schedutils/uclampset.1.adoc:97
22047 msgid "*uclampset* _[-m uclamp_min]_ _[-M uclamp_max]_ _command_ [_arguments_]\n"
22050 #. TRANSLATORS: Keep {colon} untranslated.
22051 #. type: Labeled list
22052 #: ../schedutils/uclampset.1.adoc:99
22054 msgid "You can also retrieve the utilization clamping attributes of an existing task{colon}"
22057 #. type: Plain text
22058 #: ../schedutils/uclampset.1.adoc:101
22060 msgid "*uclampset -p* _PID_\n"
22063 #. type: Plain text
22064 #: ../schedutils/uclampset.1.adoc:105
22066 msgid "*uclampset -p* _PID_ _[-m uclamp_min]_ _[-M uclamp_max]_\n"
22069 #. TRANSLATORS: Keep {colon} untranslated.
22070 #. type: Labeled list
22071 #: ../schedutils/uclampset.1.adoc:107
22073 msgid "Or control the system-wide attributes{colon}"
22076 #. type: Plain text
22077 #: ../schedutils/uclampset.1.adoc:109
22079 msgid "*uclampset -s* _[-m uclamp_min]_ _[-M uclamp_max]_\n"
22082 #. type: Plain text
22083 #: ../schedutils/uclampset.1.adoc:117
22085 "The system wide utilization clamp attributes are there to control the "
22086 "_allowed_ range the tasks can use. By default both _uclamp_min_ and "
22087 "_uclamp_max_ are set to 1024. This means users can set the utilization clamp "
22088 "values for their task across the full range [0:1024]."
22091 #. TRANSLATORS: Keep {colon} untranslated.
22092 #. type: Labeled list
22093 #: ../schedutils/uclampset.1.adoc:119
22095 msgid "For example{colon}"
22098 #. type: Plain text
22099 #: ../schedutils/uclampset.1.adoc:121
22101 msgid "*uclampset -s* `-m 512` `-M 700`\n"
22104 #. type: Plain text
22105 #: ../schedutils/uclampset.1.adoc:123
22107 "will prevent any task from being boosted higher than 512. And all tasks in "
22108 "the systems are capped to a utilization of 700. Effectively rendering the "
22109 "maximum performance of the system to 700."
22112 #. type: Plain text
22113 #: ../schedutils/uclampset.1.adoc:125
22115 "Consult your kernel docs for the exact expected behavior on that kernel."
22118 #. type: Plain text
22119 #: ../schedutils/uclampset.1.adoc:129
22120 msgid "mailto:qyousef@layalina.io[Qais Yousef]"
22123 #. type: Plain text
22124 #: ../schedutils/uclampset.1.adoc:138
22126 "See *sched_setscheduler*(2) and *sched_setattr*(2) for a description of the "
22127 "Linux scheduling scheme."
22131 #: ../sys-utils/adjtime_config.5.adoc:2
22133 msgid "adjtime_config(5)"
22136 #. type: Plain text
22137 #: ../sys-utils/adjtime_config.5.adoc:12
22139 "adjtime_config - information about hardware clock setting and drift factor"
22142 #. type: Plain text
22143 #: ../sys-utils/adjtime_config.5.adoc:16 ../sys-utils/adjtime_config.5.adoc:53
22145 #| msgid "_/etc/pam.d/su_"
22146 msgid "_/etc/adjtime_"
22147 msgstr "_/etc/pam.d/su_"
22149 #. type: Plain text
22150 #: ../sys-utils/adjtime_config.5.adoc:20
22152 "The file _/etc/adjtime_ contains descriptive information about the hardware "
22153 "mode clock setting and clock drift factor. The file is read and write by "
22154 "*hwclock*(8); and read by programs like rtcwake to get RTC time mode."
22157 #. type: Plain text
22158 #: ../sys-utils/adjtime_config.5.adoc:22
22160 "The file is usually located in _/etc_, but tools like *hwclock*(8) or "
22161 "*rtcwake*(8) can use alternative location by command line options if write "
22162 "access to _/etc_ is unwanted. The default clock mode is \"UTC\" if the file "
22166 #. type: Plain text
22167 #: ../sys-utils/adjtime_config.5.adoc:24
22169 "The Hardware Clock is usually not very accurate. However, much of its "
22170 "inaccuracy is completely predictable - it gains or loses the same amount of "
22171 "time every day. This is called systematic drift. The util *hwclock*(8) keeps "
22172 "the file _/etc/adjtime_, that keeps some historical information. For more "
22173 "details see \"*The Adjust Function*\" and \"*The Adjtime File*\" sections "
22174 "from *hwclock*(8) man page."
22177 #. type: Plain text
22178 #: ../sys-utils/adjtime_config.5.adoc:26
22179 msgid "The _adjtime_ file is formatted in ASCII."
22183 #: ../sys-utils/adjtime_config.5.adoc:27
22188 #. type: Plain text
22189 #: ../sys-utils/adjtime_config.5.adoc:30
22190 msgid "Three numbers, separated by blanks:"
22193 #. type: Labeled list
22194 #: ../sys-utils/adjtime_config.5.adoc:31
22196 msgid "*drift factor*"
22199 #. type: Plain text
22200 #: ../sys-utils/adjtime_config.5.adoc:33
22201 msgid "the systematic drift rate in seconds per day (floating point decimal)"
22204 #. type: Labeled list
22205 #: ../sys-utils/adjtime_config.5.adoc:34
22207 msgid "*last adjust time*"
22210 #. type: Plain text
22211 #: ../sys-utils/adjtime_config.5.adoc:36
22213 "the resulting number of seconds since 1969 UTC of most recent adjustment or "
22214 "calibration (decimal integer)"
22217 #. type: Labeled list
22218 #: ../sys-utils/adjtime_config.5.adoc:37
22220 msgid "*adjustment status*"
22223 #. type: Plain text
22224 #: ../sys-utils/adjtime_config.5.adoc:39
22225 msgid "zero (for compatibility with *clock*(8)) as a floating point decimal"
22229 #: ../sys-utils/adjtime_config.5.adoc:40
22231 msgid "Second line"
22234 #. type: Labeled list
22235 #: ../sys-utils/adjtime_config.5.adoc:42
22237 msgid "*last calibration time*"
22240 #. type: Plain text
22241 #: ../sys-utils/adjtime_config.5.adoc:44
22243 "The resulting number of seconds since 1969 UTC of most recent calibration. "
22244 "Zero if there has been no calibration yet or it is known that any previous "
22245 "calibration is moot (for example, because the Hardware Clock has been found, "
22246 "since that calibration, not to contain a valid time). This is a decimal "
22251 #: ../sys-utils/adjtime_config.5.adoc:45
22256 #. type: Labeled list
22257 #: ../sys-utils/adjtime_config.5.adoc:47
22259 msgid "*clock mode*"
22262 #. type: Plain text
22263 #: ../sys-utils/adjtime_config.5.adoc:49
22265 "Supported values are *UTC* or *LOCAL*. Tells whether the Hardware Clock is "
22266 "set to Coordinated Universal Time or local time. You can always override "
22267 "this value with options on the *hwclock*(8) command line."
22270 #. type: Plain text
22271 #: ../sys-utils/adjtime_config.5.adoc:58
22279 #: ../sys-utils/blkdiscard.8.adoc:2
22281 msgid "blkdiscard(8)"
22284 #. type: Plain text
22285 #: ../sys-utils/blkdiscard.8.adoc:12
22286 msgid "blkdiscard - discard sectors on a device"
22289 #. type: Plain text
22290 #: ../sys-utils/blkdiscard.8.adoc:16
22292 msgid "*blkdiscard* [options] [*-o* _offset_] [*-l* _length_] _device_\n"
22295 #. type: Plain text
22296 #: ../sys-utils/blkdiscard.8.adoc:20
22298 msgid "*blkdiscard* is used to discard device sectors. This is useful for solid-state drivers (SSDs) and thinly-provisioned storage. Unlike *fstrim*(8), this command is used directly on the block device.\n"
22301 #. type: Plain text
22302 #: ../sys-utils/blkdiscard.8.adoc:22
22304 "By default, *blkdiscard* will discard all blocks on the device. Options may "
22305 "be used to modify this behavior based on range or size, as explained below."
22308 #. type: Plain text
22309 #: ../sys-utils/blkdiscard.8.adoc:24 ../sys-utils/blkzone.8.adoc:22
22310 #: ../sys-utils/blkpr.8.adoc:22
22311 msgid "The _device_ argument is the pathname of the block device."
22314 #. type: Plain text
22315 #: ../sys-utils/blkdiscard.8.adoc:26
22317 msgid "*WARNING: All data in the discarded region on the device will be lost!*\n"
22320 #. type: Plain text
22321 #: ../sys-utils/blkdiscard.8.adoc:30
22323 "The _offset_ and _length_ arguments may be followed by the multiplicative "
22324 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
22325 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
22326 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
22327 "PB, EB, ZB and YB."
22330 #. type: Plain text
22331 #: ../sys-utils/blkdiscard.8.adoc:33
22333 "Disable all checking. Since v2.36 the block device is open in exclusive mode "
22334 "(*O_EXCL*) by default to avoid collision with mounted filesystem or another "
22335 "kernel subsystem. The *--force* option disables the exclusive access mode."
22338 #. type: Plain text
22339 #: ../sys-utils/blkdiscard.8.adoc:36
22341 "Byte offset into the device from which to start discarding. The provided "
22342 "value must be aligned to the device sector size. The default value is zero."
22345 #. type: Plain text
22346 #: ../sys-utils/blkdiscard.8.adoc:39
22348 "The number of bytes to discard (counting from the starting point). The "
22349 "provided value must be aligned to the device sector size. If the specified "
22350 "value extends past the end of the device, *blkdiscard* will stop at the "
22351 "device size boundary. The default value extends to the end of the device."
22354 #. type: Labeled list
22355 #: ../sys-utils/blkdiscard.8.adoc:40
22357 msgid "*-p*, *--step* _length_"
22360 #. type: Plain text
22361 #: ../sys-utils/blkdiscard.8.adoc:42
22363 "The number of bytes to discard within one iteration. The default is to "
22364 "discard all by one ioctl call."
22367 #. type: Plain text
22368 #: ../sys-utils/blkdiscard.8.adoc:45
22369 msgid "Suppress warning messages."
22372 #. type: Labeled list
22373 #: ../sys-utils/blkdiscard.8.adoc:46
22375 #| msgid "*-h*, *--help*"
22376 msgid "*-s*, *--secure*"
22377 msgstr "*-h*, *--help*"
22379 #. type: Plain text
22380 #: ../sys-utils/blkdiscard.8.adoc:48
22382 "Perform a secure discard. A secure discard is the same as a regular discard "
22383 "except that all copies of the discarded blocks that were possibly created by "
22384 "garbage collection must also be erased. This requires support from the "
22388 #. type: Labeled list
22389 #: ../sys-utils/blkdiscard.8.adoc:49
22391 #| msgid "*-V*, *--version*"
22392 msgid "*-z*, *--zeroout*"
22393 msgstr "*-V*, *--version*"
22395 #. type: Plain text
22396 #: ../sys-utils/blkdiscard.8.adoc:51
22397 msgid "Zero-fill rather than discard."
22400 #. type: Plain text
22401 #: ../sys-utils/blkdiscard.8.adoc:54
22403 "Display the aligned values of _offset_ and _length_. If the *--step* option "
22404 "is specified, it prints the discard progress every second."
22407 #. type: Plain text
22408 #: ../sys-utils/blkdiscard.8.adoc:60
22410 msgid "*blkdiscard* has the following exit status values:\n"
22413 #. type: Plain text
22414 #: ../sys-utils/blkdiscard.8.adoc:66
22415 msgid "failure; incorrect invocation, permissions or any other generic error"
22418 #. type: Plain text
22419 #: ../sys-utils/blkdiscard.8.adoc:69
22420 msgid "failure; since v2.39, the device does not support discard operation"
22423 #. type: Plain text
22424 #: ../sys-utils/blkdiscard.8.adoc:74 ../sys-utils/fstrim.8.adoc:90
22426 "mailto:lczerner@redhat.com[Lukas Czerner], mailto:kzak@redhat.com[Karel Zak]"
22429 #. type: Plain text
22430 #: ../sys-utils/blkdiscard.8.adoc:78
22432 msgid "*fstrim*(8)\n"
22436 #: ../sys-utils/blkzone.8.adoc:2
22441 #. type: Plain text
22442 #: ../sys-utils/blkzone.8.adoc:12
22443 msgid "blkzone - run zone command on a device"
22446 #. type: Plain text
22447 #: ../sys-utils/blkzone.8.adoc:16
22449 msgid "*blkzone* _command_ [options] _device_\n"
22452 #. type: Plain text
22453 #: ../sys-utils/blkzone.8.adoc:20
22455 msgid "*blkzone* is used to run zone command on device that support the Zoned Block Commands (ZBC) or Zoned-device ATA Commands (ZAC). The zones to operate on can be specified using the offset, count and length options.\n"
22459 #: ../sys-utils/blkzone.8.adoc:25
22464 #. type: Plain text
22465 #: ../sys-utils/blkzone.8.adoc:28
22466 msgid "The command *blkzone report* is used to report device zone information."
22469 #. type: Plain text
22470 #: ../sys-utils/blkzone.8.adoc:30
22472 "By default, the command will report all zones from the start of the block "
22473 "device. Options may be used to modify this behavior, changing the starting "
22474 "zone or the size of the report, as explained below."
22477 #. type: Plain text
22478 #: ../sys-utils/blkzone.8.adoc:32
22479 msgid "Report output:"
22483 #: ../sys-utils/blkzone.8.adoc:42
22486 "|start |Zone start sector\n"
22487 "|len |Zone length in number of sectors\n"
22488 "|cap |Zone capacity in number of sectors\n"
22489 "|wptr |Zone write pointer position\n"
22490 "|reset |Reset write pointer recommended\n"
22491 "|non-seq |Non-sequential write resources active\n"
22492 "|cond |Zone condition\n"
22493 "|type |Zone type\n"
22496 #. type: Plain text
22497 #: ../sys-utils/blkzone.8.adoc:45
22498 msgid "Zone conditions:"
22502 #: ../sys-utils/blkzone.8.adoc:56
22506 "|nw |Not write pointer\n"
22509 "|oe |Explicitly opened\n"
22510 "|oi |Implicitly opened\n"
22513 "|x? |Reserved conditions (should not be reported)\n"
22517 #: ../sys-utils/blkzone.8.adoc:58
22522 #. type: Plain text
22523 #: ../sys-utils/blkzone.8.adoc:61
22525 "The command *blkzone capacity* is used to report device capacity information."
22528 #. type: Plain text
22529 #: ../sys-utils/blkzone.8.adoc:63
22531 "By default, the command will report the sum, in number of sectors, of all "
22532 "zone capacities on the device. Options may be used to modify this behavior, "
22533 "changing the starting zone or the size of the report, as explained below."
22537 #: ../sys-utils/blkzone.8.adoc:64
22542 #. type: Plain text
22543 #: ../sys-utils/blkzone.8.adoc:67
22545 "The command *blkzone reset* is used to reset one or more zones. Unlike "
22546 "*sg_reset_wp*(8), this command operates from the block layer and can reset a "
22551 #: ../sys-utils/blkzone.8.adoc:68
22556 #. type: Plain text
22557 #: ../sys-utils/blkzone.8.adoc:71
22559 "The command *blkzone open* is used to explicitly open one or more zones. "
22560 "Unlike *sg_zone*(8), open action, this command operates from the block layer "
22561 "and can open a range of zones."
22565 #: ../sys-utils/blkzone.8.adoc:72
22570 #. type: Plain text
22571 #: ../sys-utils/blkzone.8.adoc:75
22573 "The command *blkzone close* is used to close one or more zones. Unlike "
22574 "*sg_zone*(8), close action, this command operates from the block layer and "
22575 "can close a range of zones."
22579 #: ../sys-utils/blkzone.8.adoc:76
22584 #. type: Plain text
22585 #: ../sys-utils/blkzone.8.adoc:79
22587 "The command *blkzone finish* is used to finish (transition to full "
22588 "condition) one or more zones. Unlike *sg_zone*(8), finish action, this "
22589 "command operates from the block layer and can finish a range of zones."
22592 #. type: Plain text
22593 #: ../sys-utils/blkzone.8.adoc:81
22595 "By default, the *reset*, *open*, *close* and *finish* commands will operate "
22596 "from the zone at device sector 0 and operate on all zones. Options may be "
22597 "used to modify this behavior as explained below."
22600 #. type: Plain text
22601 #: ../sys-utils/blkzone.8.adoc:85
22603 "The _offset_ and _length_ option arguments may be followed by the "
22604 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
22605 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
22606 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
22607 "for GB, TB, PB, EB, ZB and YB. Additionally, the 0x prefix can be used to "
22608 "specify _offset_ and _length_ in hex."
22611 #. type: Labeled list
22612 #: ../sys-utils/blkzone.8.adoc:86
22614 #| msgid "*-f*, *--fast*"
22615 msgid "*-o*, *--offset* _sector_"
22616 msgstr "*-f*, *--fast*"
22618 #. type: Plain text
22619 #: ../sys-utils/blkzone.8.adoc:88
22621 "The starting zone specified as a sector offset. The provided offset in "
22622 "sector units (512 bytes) should match the start of a zone. The default value "
22626 #. type: Labeled list
22627 #: ../sys-utils/blkzone.8.adoc:89
22629 msgid "*-l*, *--length* _sectors_"
22632 #. type: Plain text
22633 #: ../sys-utils/blkzone.8.adoc:91
22635 "The maximum number of sectors the command should operate on. The default "
22636 "value is the number of sectors remaining after _offset_. This option cannot "
22637 "be used together with the option *--count*."
22640 #. type: Plain text
22641 #: ../sys-utils/blkzone.8.adoc:94
22643 "The maximum number of zones the command should operate on. The default value "
22644 "is the number of zones starting from _offset_. This option cannot be used "
22645 "together with the option *--length*."
22648 #. type: Plain text
22649 #: ../sys-utils/blkzone.8.adoc:97
22651 "Enforce commands to change zone status on block devices used by the system."
22654 #. type: Plain text
22655 #: ../sys-utils/blkzone.8.adoc:100
22657 "Display the number of zones returned in the report or the range of sectors "
22661 #. type: Plain text
22662 #: ../sys-utils/blkzone.8.adoc:107
22664 "mailto:shaun@tancheff.com[Shaun Tancheff], mailto:kzak@redhat.com[Karel Zak]"
22667 #. type: Plain text
22668 #: ../sys-utils/blkzone.8.adoc:111
22670 msgid "*sg_rep_zones*(8)\n"
22674 #: ../sys-utils/blkpr.8.adoc:2
22679 #. type: Plain text
22680 #: ../sys-utils/blkpr.8.adoc:12
22681 msgid "blkpr - run persistent reservations command on a device"
22684 #. type: Plain text
22685 #: ../sys-utils/blkpr.8.adoc:16
22687 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
22688 msgid "*blkpr* [options] _device_\n"
22689 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
22691 #. type: Plain text
22692 #: ../sys-utils/blkpr.8.adoc:20
22694 msgid "*blkpr* is used to run persistent reservations command on device that supports Persistent Reservations feature.\n"
22697 #. type: Labeled list
22698 #: ../sys-utils/blkpr.8.adoc:25 ../sys-utils/flock.1.adoc:56
22699 #: ../term-utils/script.1.adoc:69
22701 #| msgid "*-c*, **--command**=__command__"
22702 msgid "*-c*, *--command* _command_"
22703 msgstr "*-c*, **--command**=__příkaz__"
22705 #. type: Plain text
22706 #: ../sys-utils/blkpr.8.adoc:28
22708 "The command of persistent reservations, supported commands are *register*, "
22709 "*reserve*, *release*, *preempt*, *preempt-abort*, and *clear*."
22712 #. type: Labeled list
22713 #: ../sys-utils/blkpr.8.adoc:29
22715 #| msgid "*-s*, **--shell**=__shell__"
22716 msgid "*-k*, *--key* _key_"
22717 msgstr "*-s*, **--shell**=__shell__"
22719 #. type: Plain text
22720 #: ../sys-utils/blkpr.8.adoc:31
22722 #| msgid "The requested command was not found"
22723 msgid "The key the command should operate on."
22724 msgstr "Požadovaný příkaz nebyl nalezen"
22726 #. type: Labeled list
22727 #: ../sys-utils/blkpr.8.adoc:32
22729 #| msgid "*-c*, **--command**=__command__"
22730 msgid "*-K*, *--oldkey* _oldkey_"
22731 msgstr "*-c*, **--command**=__příkaz__"
22733 #. type: Plain text
22734 #: ../sys-utils/blkpr.8.adoc:34
22735 msgid "The old key the command should operate on."
22738 #. type: Labeled list
22739 #: ../sys-utils/blkpr.8.adoc:35
22741 #| msgid "*-f*, *--fast*"
22742 msgid "*-f*, *--flag* _flag_"
22743 msgstr "*-f*, *--fast*"
22745 #. type: Plain text
22746 #: ../sys-utils/blkpr.8.adoc:37
22747 msgid "Supported flag is *ignore-key*."
22750 #. type: Plain text
22751 #: ../sys-utils/blkpr.8.adoc:41
22753 "Supported types are *write-exclusive*, *exclusive-access*, *write-exclusive-"
22754 "reg-only*, *exclusive-access-reg-only*, *write-exclusive-all-regs*, and "
22755 "*exclusive-access-all-regs*."
22758 #. type: Plain text
22759 #: ../sys-utils/blkpr.8.adoc:51
22760 msgid "mailto:pizhenwei@bytedance.com[zhenwei pi]"
22763 #. type: Plain text
22764 #: ../sys-utils/blkpr.8.adoc:55
22766 msgid "*sg_persist*(8)\n"
22769 #. type: Plain text
22770 #: ../sys-utils/blkpr.8.adoc:59
22772 "Linux documentation at: <https://docs.kernel.org/block/pr.html> iSCSI "
22773 "specification at: <https://datatracker.ietf.org/doc/html/rfc3720> NVMe-oF "
22774 "specification at: <https://nvmexpress.org/nvme-over-fabrics-part-two/>"
22778 #: ../sys-utils/chcpu.8.adoc:2
22783 #. type: Plain text
22784 #: ../sys-utils/chcpu.8.adoc:12
22785 msgid "chcpu - configure CPUs"
22788 #. type: Plain text
22789 #: ../sys-utils/chcpu.8.adoc:16
22791 msgid "*chcpu* *-c*|*-d*|*-e*|*-g* _cpu-list_\n"
22794 #. type: Plain text
22795 #: ../sys-utils/chcpu.8.adoc:18
22797 msgid "*chcpu* *-p* _mode_\n"
22800 #. type: Plain text
22801 #: ../sys-utils/chcpu.8.adoc:20
22803 msgid "*chcpu* *-r*|*-h*|*-V*\n"
22806 #. type: Plain text
22807 #: ../sys-utils/chcpu.8.adoc:24
22809 msgid "*chcpu* can modify the state of CPUs. It can enable or disable CPUs, scan for new CPUs, change the CPU dispatching _mode_ of the underlying hypervisor, and request CPUs from the hypervisor (configure) or return CPUs to the hypervisor (deconfigure).\n"
22812 #. type: Plain text
22813 #: ../sys-utils/chcpu.8.adoc:26
22815 "Some options have a _cpu-list_ argument. Use this argument to specify a "
22816 "comma-separated list of CPUs. The list can contain individual CPU addresses "
22817 "or ranges of addresses. For example, *0,5,7,9-11* makes the command "
22818 "applicable to the CPUs with the addresses 0, 5, 7, 9, 10, and 11."
22821 #. type: Labeled list
22822 #: ../sys-utils/chcpu.8.adoc:29
22824 msgid "*-c*, *--configure* _cpu-list_"
22827 #. type: Plain text
22828 #: ../sys-utils/chcpu.8.adoc:31
22830 "Configure the specified CPUs. Configuring a CPU means that the hypervisor "
22831 "takes a CPU from the CPU pool and assigns it to the virtual hardware on "
22832 "which your kernel runs."
22835 #. type: Labeled list
22836 #: ../sys-utils/chcpu.8.adoc:32
22838 msgid "*-d*, *--disable* _cpu-list_"
22841 #. type: Plain text
22842 #: ../sys-utils/chcpu.8.adoc:34
22844 "Disable the specified CPUs. Disabling a CPU means that the kernel sets it "
22848 #. type: Labeled list
22849 #: ../sys-utils/chcpu.8.adoc:35
22851 msgid "*-e*, *--enable* _cpu-list_"
22854 #. type: Plain text
22855 #: ../sys-utils/chcpu.8.adoc:37
22857 "Enable the specified CPUs. Enabling a CPU means that the kernel sets it "
22858 "online. A CPU must be configured, see *-c*, before it can be enabled."
22861 #. type: Labeled list
22862 #: ../sys-utils/chcpu.8.adoc:38
22864 msgid "*-g*, *--deconfigure* _cpu-list_"
22867 #. type: Plain text
22868 #: ../sys-utils/chcpu.8.adoc:40
22870 "Deconfigure the specified CPUs. Deconfiguring a CPU means that the "
22871 "hypervisor removes the CPU from the virtual hardware on which the Linux "
22872 "instance runs and returns it to the CPU pool. A CPU must be offline, see *-"
22873 "d*, before it can be deconfigured."
22876 #. type: Labeled list
22877 #: ../sys-utils/chcpu.8.adoc:41
22879 msgid "*-p*, *--dispatch* _mode_"
22882 #. type: Plain text
22883 #: ../sys-utils/chcpu.8.adoc:43
22885 "Set the CPU dispatching _mode_ (polarization). This option has an effect "
22886 "only if your hardware architecture and hypervisor support CPU polarization. "
22887 "Available _modes_ are:"
22890 #. type: Labeled list
22891 #: ../sys-utils/chcpu.8.adoc:44
22893 msgid "*horizontal*"
22896 #. type: Plain text
22897 #: ../sys-utils/chcpu.8.adoc:46
22898 msgid "The workload is spread across all available CPUs."
22901 #. type: Labeled list
22902 #: ../sys-utils/chcpu.8.adoc:47
22907 #. type: Plain text
22908 #: ../sys-utils/chcpu.8.adoc:49
22909 msgid "The workload is concentrated on few CPUs."
22912 #. type: Labeled list
22913 #: ../sys-utils/chcpu.8.adoc:50
22915 #| msgid "*-V*, *--version*"
22916 msgid "*-r*, *--rescan*"
22917 msgstr "*-V*, *--version*"
22919 #. type: Plain text
22920 #: ../sys-utils/chcpu.8.adoc:52
22922 "Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the "
22923 "new CPUs. Use this option on systems that do not automatically detect newly "
22927 #. type: Plain text
22928 #: ../sys-utils/chcpu.8.adoc:58
22930 msgid "*chcpu* has the following exit status values:\n"
22933 #. type: Plain text
22934 #: ../sys-utils/chcpu.8.adoc:67 ../sys-utils/chmem.8.adoc:66
22935 msgid "partial success"
22938 #. type: Plain text
22939 #: ../sys-utils/chcpu.8.adoc:71
22940 msgid "mailto:heiko.carstens@de.ibm.com[Heiko Carstens]"
22943 #. type: Plain text
22944 #: ../sys-utils/chcpu.8.adoc:75
22945 msgid "Copyright IBM Corp. 2011"
22948 #. type: Plain text
22949 #: ../sys-utils/chcpu.8.adoc:79
22951 msgid "*lscpu*(1)\n"
22955 #: ../sys-utils/chmem.8.adoc:2
22960 #. type: Plain text
22961 #: ../sys-utils/chmem.8.adoc:12
22962 msgid "chmem - configure memory"
22965 #. type: Plain text
22966 #: ../sys-utils/chmem.8.adoc:16
22968 msgid "*chmem* [*-h] [*-V*] [*-v*] [*-e*|*-d*] [_SIZE_|_RANGE_ *-b* _BLOCKRANGE_] [*-z* _ZONE_]\n"
22971 #. type: Plain text
22972 #: ../sys-utils/chmem.8.adoc:20
22974 "The chmem command sets a particular size or range of memory online or "
22978 #. type: Plain text
22979 #: ../sys-utils/chmem.8.adoc:22
22981 "Specify _SIZE_ as <size>[m|M|g|G]. With m or M, <size> specifies the memory "
22982 "size in MiB (1024 x 1024 bytes). With g or G, <size> specifies the memory "
22983 "size in GiB (1024 x 1024 x 1024 bytes). The default unit is MiB."
22986 #. type: Plain text
22987 #: ../sys-utils/chmem.8.adoc:24
22989 "Specify _RANGE_ in the form 0x<start>-0x<end> as shown in the output of the "
22990 "*lsmem*(1) command. <start> is the hexadecimal address of the first byte and "
22991 "<end> is the hexadecimal address of the last byte in the memory range."
22994 #. type: Plain text
22995 #: ../sys-utils/chmem.8.adoc:26
22997 "Specify _BLOCKRANGE_ in the form <first>-<last> or <block> as shown in the "
22998 "output of the *lsmem*(1) command. <first> is the number of the first memory "
22999 "block and <last> is the number of the last memory block in the memory range. "
23000 "Alternatively a single block can be specified. _BLOCKRANGE_ requires the *--"
23004 #. type: Plain text
23005 #: ../sys-utils/chmem.8.adoc:28
23007 "Specify _ZONE_ as the name of a memory zone, as shown in the output of the "
23008 "*lsmem -o +ZONES* command. The output shows one or more valid memory zones "
23009 "for each memory range. If multiple zones are shown, then the memory range "
23010 "currently belongs to the first zone. By default, *chmem* will set memory "
23011 "online to the zone Movable, if this is among the valid zones. This default "
23012 "can be changed by specifying the *--zone* option with another valid zone. "
23013 "For memory ballooning, it is recommended to select the zone Movable for "
23014 "memory online and offline, if possible. Memory in this zone is much more "
23015 "likely to be able to be offlined again, but it cannot be used for arbitrary "
23016 "kernel allocations, only for migratable pages (e.g., anonymous and page "
23017 "cache pages). Use the *--help* option to see all available zones."
23020 #. type: Plain text
23021 #: ../sys-utils/chmem.8.adoc:30
23023 "_SIZE_ and _RANGE_ must be aligned to the Linux memory block size, as shown "
23024 "in the output of the *lsmem*(1) command."
23027 #. type: Plain text
23028 #: ../sys-utils/chmem.8.adoc:32
23030 "Setting memory online can fail for various reasons. On virtualized systems "
23031 "it can fail if the hypervisor does not have enough memory left, for example "
23032 "because memory was overcommitted. Setting memory offline can fail if Linux "
23033 "cannot free the memory. If only part of the requested memory can be set "
23034 "online or offline, a message tells you how much memory was set online or "
23035 "offline instead of the requested amount."
23038 #. type: Plain text
23039 #: ../sys-utils/chmem.8.adoc:34
23041 "When setting memory online *chmem* starts with the lowest memory block "
23042 "numbers. When setting memory offline *chmem* starts with the highest memory "
23046 #. type: Labeled list
23047 #: ../sys-utils/chmem.8.adoc:37
23049 #| msgid "*-h*, *--help*"
23050 msgid "*-b*, *--blocks*"
23051 msgstr "*-h*, *--help*"
23053 #. type: Plain text
23054 #: ../sys-utils/chmem.8.adoc:39
23056 "Use a _BLOCKRANGE_ parameter instead of _RANGE_ or _SIZE_ for the *--enable* "
23057 "and *--disable* options."
23060 #. type: Labeled list
23061 #: ../sys-utils/chmem.8.adoc:40
23063 #| msgid "*-h*, *--help*"
23064 msgid "*-d*, *--disable*"
23065 msgstr "*-h*, *--help*"
23067 #. type: Plain text
23068 #: ../sys-utils/chmem.8.adoc:42
23069 msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory offline."
23072 #. type: Labeled list
23073 #: ../sys-utils/chmem.8.adoc:43
23075 #| msgid "*-h*, *--help*"
23076 msgid "*-e*, *--enable*"
23077 msgstr "*-h*, *--help*"
23079 #. type: Plain text
23080 #: ../sys-utils/chmem.8.adoc:45
23081 msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online."
23084 #. type: Labeled list
23085 #: ../sys-utils/chmem.8.adoc:46
23087 #| msgid "*-h*, *--help*"
23088 msgid "*-z*, *--zone*"
23089 msgstr "*-h*, *--help*"
23091 #. type: Plain text
23092 #: ../sys-utils/chmem.8.adoc:48
23094 "Select the memory _ZONE_ where to set the specified _RANGE_, _SIZE_, or "
23095 "_BLOCKRANGE_ of memory online or offline. By default, memory will be set "
23096 "online to the zone Movable, if possible."
23099 #. type: Plain text
23100 #: ../sys-utils/chmem.8.adoc:51
23102 "Verbose mode. Causes *chmem* to print debugging messages about it's progress."
23105 #. type: Plain text
23106 #: ../sys-utils/chmem.8.adoc:57
23108 msgid "*chmem* has the following exit status values:\n"
23111 #. type: Labeled list
23112 #: ../sys-utils/chmem.8.adoc:69
23114 msgid "*chmem --enable 1024*"
23117 #. type: Plain text
23118 #: ../sys-utils/chmem.8.adoc:71
23119 msgid "This command requests 1024 MiB of memory to be set online."
23122 #. type: Labeled list
23123 #: ../sys-utils/chmem.8.adoc:72
23125 msgid "*chmem -e 2g*"
23128 #. type: Plain text
23129 #: ../sys-utils/chmem.8.adoc:74
23130 msgid "This command requests 2 GiB of memory to be set online."
23133 #. type: Labeled list
23134 #: ../sys-utils/chmem.8.adoc:75
23136 msgid "*chmem --disable 0x00000000e4000000-0x00000000f3ffffff*"
23139 #. type: Plain text
23140 #: ../sys-utils/chmem.8.adoc:77
23142 "This command requests the memory range starting with 0x00000000e4000000 and "
23143 "ending with 0x00000000f3ffffff to be set offline."
23146 #. type: Labeled list
23147 #: ../sys-utils/chmem.8.adoc:78
23149 msgid "*chmem -b -d 10*"
23152 #. type: Plain text
23153 #: ../sys-utils/chmem.8.adoc:80
23154 msgid "This command requests the memory block number 10 to be set offline."
23157 #. type: Plain text
23158 #: ../sys-utils/chmem.8.adoc:84
23160 msgid "*lsmem*(1)\n"
23164 #: ../sys-utils/choom.1.adoc:2
23169 #. type: Plain text
23170 #: ../sys-utils/choom.1.adoc:12
23171 msgid "choom - display and adjust OOM-killer score."
23174 #. type: Plain text
23175 #: ../sys-utils/choom.1.adoc:14
23177 msgid "*choom* *-p* _PID_\n"
23180 #. type: Plain text
23181 #: ../sys-utils/choom.1.adoc:16
23183 msgid "*choom* *-p* _PID_ *-n* _number_\n"
23186 #. type: Plain text
23187 #: ../sys-utils/choom.1.adoc:18
23189 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
23190 msgid "*choom* *-n* _number_ [--] _command_ [_argument_ ...]\n"
23191 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
23193 #. type: Plain text
23194 #: ../sys-utils/choom.1.adoc:22
23196 "The *choom* command displays and adjusts Out-Of-Memory killer score setting."
23199 #. type: Plain text
23200 #: ../sys-utils/choom.1.adoc:27
23201 msgid "Specifies process ID."
23204 #. type: Labeled list
23205 #: ../sys-utils/choom.1.adoc:28
23207 #| msgid "*-f*, *--fast*"
23208 msgid "*-n*, *--adjust* _value_"
23209 msgstr "*-f*, *--fast*"
23211 #. type: Plain text
23212 #: ../sys-utils/choom.1.adoc:30
23213 msgid "Specify the adjust score value."
23216 #. type: Plain text
23217 #: ../sys-utils/choom.1.adoc:36
23219 "Linux kernel uses the badness heuristic to select which process gets killed "
23220 "in out of memory conditions."
23223 #. type: Plain text
23224 #: ../sys-utils/choom.1.adoc:38
23226 "The badness heuristic assigns a value to each candidate task ranging from 0 "
23227 "(never kill) to 1000 (always kill) to determine which process is targeted. "
23228 "The units are roughly a proportion along that range of allowed memory the "
23229 "process may allocate from based on an estimation of its current memory and "
23230 "swap use. For example, if a task is using all allowed memory, its badness "
23231 "score will be 1000. If it is using half of its allowed memory, its score "
23235 #. type: Plain text
23236 #: ../sys-utils/choom.1.adoc:40
23238 "There is an additional factor included in the badness score: the current "
23239 "memory and swap usage is discounted by 3% for root processes."
23242 #. type: Plain text
23243 #: ../sys-utils/choom.1.adoc:42
23245 "The amount of \"allowed\" memory depends on the context in which the oom "
23246 "killer was called. If it is due to the memory assigned to the allocating "
23247 "task's cpuset being exhausted, the allowed memory represents the set of mems "
23248 "assigned to that cpuset. If it is due to a mempolicy's node(s) being "
23249 "exhausted, the allowed memory represents the set of mempolicy nodes. If it "
23250 "is due to a memory limit (or swap limit) being reached, the allowed memory "
23251 "is that configured limit. Finally, if it is due to the entire system being "
23252 "out of memory, the allowed memory represents all allocatable resources."
23255 #. type: Plain text
23256 #: ../sys-utils/choom.1.adoc:44
23258 "The adjust score value is added to the badness score before it is used to "
23259 "determine which task to kill. Acceptable values range from -1000 to +1000. "
23260 "This allows userspace to polarize the preference for oom killing either by "
23261 "always preferring a certain task or completely disabling it. The lowest "
23262 "possible value, -1000, is equivalent to disabling oom killing entirely for "
23263 "that task since it will always report a badness score of 0."
23266 #. type: Plain text
23267 #: ../sys-utils/choom.1.adoc:46
23269 "Setting an adjust score value of +500, for example, is roughly equivalent to "
23270 "allowing the remainder of tasks sharing the same system, cpuset, mempolicy, "
23271 "or memory controller resources to use at least 50% more memory. A value of "
23272 "-500, on the other hand, would be roughly equivalent to discounting 50% of "
23273 "the task's allowed memory from being considered as scoring against the task."
23276 #. type: Plain text
23277 #: ../sys-utils/choom.1.adoc:54
23279 msgid "*proc*(5)\n"
23282 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
23283 #. May be distributed under the GNU General Public License
23285 #: ../sys-utils/ctrlaltdel.8.adoc:6
23287 msgid "ctrlaltdel(8)"
23290 #. type: Plain text
23291 #: ../sys-utils/ctrlaltdel.8.adoc:16
23292 msgid "ctrlaltdel - set the function of the Ctrl-Alt-Del combination"
23295 #. type: Plain text
23296 #: ../sys-utils/ctrlaltdel.8.adoc:20
23298 msgid "*ctrlaltdel* *hard*|*soft*\n"
23301 #. type: Plain text
23302 #: ../sys-utils/ctrlaltdel.8.adoc:24
23304 "Based on examination of the _linux/kernel/reboot.c_ code, it is clear that "
23305 "there are two supported functions that the <Ctrl-Alt-Del> sequence can "
23309 #. type: Labeled list
23310 #: ../sys-utils/ctrlaltdel.8.adoc:25
23315 #. type: Plain text
23316 #: ../sys-utils/ctrlaltdel.8.adoc:27
23318 "Immediately reboot the computer without calling *sync*(2) and without any "
23319 "other preparation. This is the default."
23322 #. type: Labeled list
23323 #: ../sys-utils/ctrlaltdel.8.adoc:28
23328 #. type: Plain text
23329 #: ../sys-utils/ctrlaltdel.8.adoc:30
23331 "Make the kernel send the *SIGINT* (interrupt) signal to the *init* process "
23332 "(this is always the process with PID 1). If this option is used, the "
23333 "*init*(8) program must support this feature. Since there are now several "
23334 "*init*(8) programs in the Linux community, please consult the documentation "
23335 "for the version that you are currently using."
23338 #. type: Plain text
23339 #: ../sys-utils/ctrlaltdel.8.adoc:32
23341 "When the command is run without any argument, it will display the current "
23345 #. type: Plain text
23346 #: ../sys-utils/ctrlaltdel.8.adoc:34
23348 "The function of *ctrlaltdel* is usually set in the _/etc/rc.local_ file."
23351 #. type: Plain text
23352 #: ../sys-utils/ctrlaltdel.8.adoc:42
23353 msgid "_/etc/rc.local_"
23356 #. type: Plain text
23357 #: ../sys-utils/ctrlaltdel.8.adoc:46
23358 msgid "mailto:poe@daimi.aau.dk[Peter Orbaek]"
23361 #. type: Plain text
23362 #: ../sys-utils/ctrlaltdel.8.adoc:51
23369 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
23370 #. May be distributed under the GNU General Public License
23372 #: ../sys-utils/dmesg.1.adoc:6
23377 #. type: Plain text
23378 #: ../sys-utils/dmesg.1.adoc:16
23379 msgid "dmesg - print or control the kernel ring buffer"
23382 #. type: Plain text
23383 #: ../sys-utils/dmesg.1.adoc:20
23385 msgid "*dmesg* [options]\n"
23388 #. type: Plain text
23389 #: ../sys-utils/dmesg.1.adoc:22
23391 msgid "*dmesg* *--clear*\n"
23394 #. type: Plain text
23395 #: ../sys-utils/dmesg.1.adoc:24
23397 msgid "*dmesg* *--read-clear* [options]\n"
23400 #. type: Plain text
23401 #: ../sys-utils/dmesg.1.adoc:26
23403 msgid "*dmesg* *--console-level* _level_\n"
23406 #. type: Plain text
23407 #: ../sys-utils/dmesg.1.adoc:28
23409 msgid "*dmesg* *--console-on*\n"
23412 #. type: Plain text
23413 #: ../sys-utils/dmesg.1.adoc:30
23415 msgid "*dmesg* *--console-off*\n"
23418 #. type: Plain text
23419 #: ../sys-utils/dmesg.1.adoc:34
23421 msgid "*dmesg* is used to examine or control the kernel ring buffer.\n"
23424 #. type: Plain text
23425 #: ../sys-utils/dmesg.1.adoc:36
23427 "The default action is to display all messages from the kernel ring buffer."
23430 #. type: Plain text
23431 #: ../sys-utils/dmesg.1.adoc:40
23433 "The *--clear*, *--read-clear*, *--console-on*, *--console-off*, and *--"
23434 "console-level* options are mutually exclusive."
23437 #. type: Labeled list
23438 #: ../sys-utils/dmesg.1.adoc:41
23440 #| msgid "*-h*, *--help*"
23441 msgid "*-C*, *--clear*"
23442 msgstr "*-h*, *--help*"
23444 #. type: Plain text
23445 #: ../sys-utils/dmesg.1.adoc:43
23446 msgid "Clear the ring buffer."
23449 #. type: Labeled list
23450 #: ../sys-utils/dmesg.1.adoc:44
23452 #| msgid "*-h*, *--help*"
23453 msgid "*-c*, *--read-clear*"
23454 msgstr "*-h*, *--help*"
23456 #. type: Plain text
23457 #: ../sys-utils/dmesg.1.adoc:46
23458 msgid "Clear the ring buffer after first printing its contents."
23461 #. type: Labeled list
23462 #: ../sys-utils/dmesg.1.adoc:47
23464 msgid "*-D*, *--console-off*"
23467 #. type: Plain text
23468 #: ../sys-utils/dmesg.1.adoc:49
23469 msgid "Disable the printing of messages to the console."
23472 #. type: Labeled list
23473 #: ../sys-utils/dmesg.1.adoc:50
23475 #| msgid "*-h*, *--help*"
23476 msgid "*-d*, *--show-delta*"
23477 msgstr "*-h*, *--help*"
23479 #. type: Plain text
23480 #: ../sys-utils/dmesg.1.adoc:52
23482 "Display the timestamp and the time delta spent between messages. If used "
23483 "together with *--notime* then only the time delta without the timestamp is "
23487 #. type: Labeled list
23488 #: ../sys-utils/dmesg.1.adoc:53
23490 #| msgid "*-V*, *--version*"
23491 msgid "*-E*, *--console-on*"
23492 msgstr "*-V*, *--version*"
23494 #. type: Plain text
23495 #: ../sys-utils/dmesg.1.adoc:55
23496 msgid "Enable printing messages to the console."
23499 #. type: Labeled list
23500 #: ../sys-utils/dmesg.1.adoc:56
23502 #| msgid "*-h*, *--help*"
23503 msgid "*-e*, *--reltime*"
23504 msgstr "*-h*, *--help*"
23506 #. type: Plain text
23507 #: ../sys-utils/dmesg.1.adoc:58
23509 "Display the local time and the delta in human-readable format. Be aware that "
23510 "conversion to the local time could be inaccurate (see *-T* for more details)."
23513 #. type: Labeled list
23514 #: ../sys-utils/dmesg.1.adoc:59
23516 msgid "*-F*, *--file* _file_"
23519 #. type: Plain text
23520 #: ../sys-utils/dmesg.1.adoc:61
23522 "Read the syslog messages from the given _file_. Note that *-F* does not "
23523 "support messages in kmsg format. The old syslog format is supported only."
23526 #. type: Labeled list
23527 #: ../sys-utils/dmesg.1.adoc:62
23529 #| msgid "*-f*, *--fast*"
23530 msgid "*-f*, *--facility* _list_"
23531 msgstr "*-f*, *--fast*"
23533 #. type: Plain text
23534 #: ../sys-utils/dmesg.1.adoc:64
23536 "Restrict output to the given (comma-separated) _list_ of facilities. For "
23540 #. type: Plain text
23541 #: ../sys-utils/dmesg.1.adoc:66
23543 msgid "*dmesg --facility=daemon*\n"
23546 #. type: Plain text
23547 #: ../sys-utils/dmesg.1.adoc:68
23549 "will print messages from system daemons only. For all supported facilities "
23550 "see the *--help* output."
23553 #. type: Labeled list
23554 #: ../sys-utils/dmesg.1.adoc:69
23556 #| msgid "*-h*, *--help*"
23557 msgid "*-H*, *--human*"
23558 msgstr "*-h*, *--help*"
23560 #. type: Plain text
23561 #: ../sys-utils/dmesg.1.adoc:71
23563 "Enable human-readable output. See also *--color*, *--reltime* and *--"
23567 #. type: Plain text
23568 #: ../sys-utils/dmesg.1.adoc:74
23570 "Use JSON output format. The time output format is in \"sec.usec\" format "
23571 "only, log priority level is not decoded by default (use *--decode* to split "
23572 "into facility and priority), the other options to control the output format "
23573 "or time format are silently ignored."
23576 #. type: Plain text
23577 #: ../sys-utils/dmesg.1.adoc:77
23578 msgid "Print kernel messages."
23581 #. type: Plain text
23582 #: ../sys-utils/dmesg.1.adoc:80
23584 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
23585 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
23586 "colors can be disabled; for the current built-in default see the *--help* "
23587 "output. See also the *COLORS* section below."
23590 #. type: Labeled list
23591 #: ../sys-utils/dmesg.1.adoc:81
23593 #| msgid "*-h*, *--help*"
23594 msgid "*-l*, *--level* _list_"
23595 msgstr "*-h*, *--help*"
23597 #. type: Plain text
23598 #: ../sys-utils/dmesg.1.adoc:83
23600 "Restrict output to the given (comma-separated) _list_ of levels. For example:"
23603 #. type: Plain text
23604 #: ../sys-utils/dmesg.1.adoc:85
23606 msgid "*dmesg --level=err,warn*\n"
23609 #. type: Plain text
23610 #: ../sys-utils/dmesg.1.adoc:87
23612 "will print error and warning messages only. For all supported levels see the "
23616 #. type: Plain text
23617 #: ../sys-utils/dmesg.1.adoc:89
23619 "Appending a plus *+* to a level name also includes all higher levels. For "
23623 #. type: Plain text
23624 #: ../sys-utils/dmesg.1.adoc:91
23626 msgid "*dmesg --level=err+*\n"
23629 #. type: Plain text
23630 #: ../sys-utils/dmesg.1.adoc:93
23631 msgid "will print levels *err*, *crit*, *alert* and *emerg*."
23634 #. type: Plain text
23635 #: ../sys-utils/dmesg.1.adoc:95
23636 msgid "Prepending it will include all lower levels."
23639 #. type: Labeled list
23640 #: ../sys-utils/dmesg.1.adoc:96
23642 msgid "*-n*, *--console-level* _level_"
23645 #. type: Plain text
23646 #: ../sys-utils/dmesg.1.adoc:98
23648 "Set the _level_ at which printing of messages is done to the console. The "
23649 "_level_ is a level number or abbreviation of the level name. For all "
23650 "supported levels see the *--help* output."
23653 #. type: Plain text
23654 #: ../sys-utils/dmesg.1.adoc:100
23656 "For example, *-n 1* or *-n emerg* prevents all messages, except emergency "
23657 "(panic) messages, from appearing on the console. All levels of messages are "
23658 "still written to _/proc/kmsg_, so *syslogd*(8) can still be used to control "
23659 "exactly where kernel messages appear. When the *-n* option is used, *dmesg* "
23660 "will _not_ print or clear the kernel ring buffer."
23663 #. type: Labeled list
23664 #: ../sys-utils/dmesg.1.adoc:101
23666 msgid "*--noescape*"
23669 #. type: Plain text
23670 #: ../sys-utils/dmesg.1.adoc:103
23672 "The unprintable and potentially unsafe characters (e.g., broken multi-byte "
23673 "sequences, terminal controlling chars, etc.) are escaped in format \\x<hex> "
23674 "for security reason by default. This option disables this feature at all. "
23675 "It's usable for example for debugging purpose together with *--raw*. Be "
23676 "careful and don't use it by default."
23679 #. type: Labeled list
23680 #: ../sys-utils/dmesg.1.adoc:104
23682 #| msgid "*-P*, *--pty*"
23683 msgid "*-P*, *--nopager*"
23684 msgstr "*-P*, *--pty*"
23686 #. type: Plain text
23687 #: ../sys-utils/dmesg.1.adoc:106
23689 "Do not pipe output into a pager. A pager is enabled by default for *--human* "
23693 #. type: Labeled list
23694 #: ../sys-utils/dmesg.1.adoc:107
23696 #| msgid "*-V*, *--version*"
23697 msgid "*-p*, *--force-prefix*"
23698 msgstr "*-V*, *--version*"
23700 #. type: Plain text
23701 #: ../sys-utils/dmesg.1.adoc:109
23703 "Add facility, level or timestamp information to each line of a multi-line "
23707 #. type: Plain text
23708 #: ../sys-utils/dmesg.1.adoc:112
23710 "Print the raw message buffer, i.e., do not strip the log-level prefixes, but "
23711 "all unprintable characters are still escaped (see also *--noescape*)."
23714 #. type: Plain text
23715 #: ../sys-utils/dmesg.1.adoc:114
23717 "Note that the real raw format depends on the method how *dmesg* reads kernel "
23718 "messages. The _/dev/kmsg_ device uses a different format than *syslog*(2). "
23719 "For backward compatibility, *dmesg* returns data always in the *syslog*(2) "
23720 "format. It is possible to read the real raw data from _/dev/kmsg_ by, for "
23721 "example, the command 'dd if=/dev/kmsg iflag=nonblock'."
23724 #. type: Labeled list
23725 #: ../sys-utils/dmesg.1.adoc:115
23727 #| msgid "*-P*, *--pty*"
23728 msgid "*-S*, *--syslog*"
23729 msgstr "*-P*, *--pty*"
23731 #. type: Plain text
23732 #: ../sys-utils/dmesg.1.adoc:117
23734 "Force *dmesg* to use the *syslog*(2) kernel interface to read kernel "
23735 "messages. The default is to use _/dev/kmsg_ rather than *syslog*(2) since "
23739 #. type: Labeled list
23740 #: ../sys-utils/dmesg.1.adoc:118
23742 msgid "*-s*, *--buffer-size* _size_"
23745 #. type: Plain text
23746 #: ../sys-utils/dmesg.1.adoc:120
23748 "Use a buffer of _size_ to query the kernel ring buffer. This is 16392 by "
23749 "default. (The default kernel syslog buffer size was 4096 at first, 8192 "
23750 "since 1.3.54, 16384 since 2.1.113.) If you have set the kernel buffer to be "
23751 "larger than the default, then this option can be used to view the entire "
23755 #. type: Labeled list
23756 #: ../sys-utils/dmesg.1.adoc:121
23758 #| msgid "*-P*, *--pty*"
23759 msgid "*-T*, *--ctime*"
23760 msgstr "*-P*, *--pty*"
23762 #. type: Plain text
23763 #: ../sys-utils/dmesg.1.adoc:123
23764 msgid "Print human-readable timestamps."
23767 #. type: Plain text
23768 #: ../sys-utils/dmesg.1.adoc:125
23770 msgid "*Be aware that the timestamp could be inaccurate!* The *time* source used for the logs is *not updated after* system *SUSPEND*/*RESUME*. Timestamps are adjusted according to current delta between boottime and monotonic clocks, this works only for messages printed after last resume.\n"
23773 #. type: Labeled list
23774 #: ../sys-utils/dmesg.1.adoc:126
23776 msgid "*--since* _time_"
23779 #. type: Plain text
23780 #: ../sys-utils/dmesg.1.adoc:128
23782 "Display record since the specified time. Supported is the subsecond "
23783 "granularity. The time is possible to specify in absolute way as well as by "
23784 "relative notation (e.g. '1 hour ago'). Be aware that the timestamp could be "
23785 "inaccurate and see *--ctime* for more details."
23788 #. type: Labeled list
23789 #: ../sys-utils/dmesg.1.adoc:129
23791 msgid "*--until* _time_"
23794 #. type: Plain text
23795 #: ../sys-utils/dmesg.1.adoc:131
23797 "Display record until the specified time. Supported is the subsecond "
23798 "granularity. The time is possible to specify in absolute way as well as by "
23799 "relative notation (e.g. '1 hour ago'). Be aware that the timestamp could be "
23800 "inaccurate and see *--ctime* for more details."
23803 #. type: Labeled list
23804 #: ../sys-utils/dmesg.1.adoc:132
23806 #| msgid "*-P*, *--pty*"
23807 msgid "*-t*, *--notime*"
23808 msgstr "*-P*, *--pty*"
23810 #. type: Plain text
23811 #: ../sys-utils/dmesg.1.adoc:134
23812 msgid "Do not print kernel's timestamps."
23815 #. type: Plain text
23816 #: ../sys-utils/dmesg.1.adoc:137
23818 "Print timestamps using the given _format_, which can be *ctime*, *reltime*, "
23819 "*delta* or *iso*. The first three formats are aliases of the time-format-"
23820 "specific options. The *iso* format is a *dmesg* implementation of the "
23821 "ISO-8601 timestamp format. The purpose of this format is to make the "
23822 "comparing of timestamps between two systems, and any other parsing, easy. "
23823 "The definition of the *iso* timestamp is: YYYY-MM-DD<T>HH:MM:SS,"
23824 "<microseconds><-+><timezone offset from UTC>."
23827 #. type: Plain text
23828 #: ../sys-utils/dmesg.1.adoc:139
23830 "The *iso* format has the same issue as *ctime*: the time may be inaccurate "
23831 "when a system is suspended and resumed."
23834 #. type: Labeled list
23835 #: ../sys-utils/dmesg.1.adoc:140
23837 #| msgid "*-h*, *--help*"
23838 msgid "*-u*, *--userspace*"
23839 msgstr "*-h*, *--help*"
23841 #. type: Plain text
23842 #: ../sys-utils/dmesg.1.adoc:142
23843 msgid "Print userspace messages."
23846 #. type: Labeled list
23847 #: ../sys-utils/dmesg.1.adoc:143
23849 #| msgid "*-f*, *--fast*"
23850 msgid "*-w*, *--follow*"
23851 msgstr "*-f*, *--fast*"
23853 #. type: Plain text
23854 #: ../sys-utils/dmesg.1.adoc:145
23856 "Wait for new messages. This feature is supported only on systems with a "
23857 "readable _/dev/kmsg_ (since kernel 3.5.0)."
23860 #. type: Labeled list
23861 #: ../sys-utils/dmesg.1.adoc:146
23863 #| msgid "*-*, *-l*, *--login*"
23864 msgid "*-W*, *--follow-new*"
23865 msgstr "*-*, *-l*, *--login*"
23867 #. type: Plain text
23868 #: ../sys-utils/dmesg.1.adoc:148
23869 msgid "Wait and print only new messages."
23872 #. type: Labeled list
23873 #: ../sys-utils/dmesg.1.adoc:149
23875 #| msgid "*-h*, *--help*"
23876 msgid "*-x*, *--decode*"
23877 msgstr "*-h*, *--help*"
23879 #. type: Plain text
23880 #: ../sys-utils/dmesg.1.adoc:151
23882 "Decode facility and level (priority) numbers to human-readable prefixes."
23885 #. type: Plain text
23886 #: ../sys-utils/dmesg.1.adoc:156
23887 msgid "The logical color names supported by *dmesg* are:"
23890 #. type: Labeled list
23891 #: ../sys-utils/dmesg.1.adoc:157
23896 #. type: Plain text
23897 #: ../sys-utils/dmesg.1.adoc:159
23898 msgid "The message sub-system prefix (e.g., \"ACPI:\")."
23901 #. type: Plain text
23902 #: ../sys-utils/dmesg.1.adoc:162
23903 msgid "The message timestamp."
23906 #. type: Labeled list
23907 #: ../sys-utils/dmesg.1.adoc:163
23909 msgid "*timebreak*"
23912 #. type: Plain text
23913 #: ../sys-utils/dmesg.1.adoc:165
23915 "The message timestamp in short ctime format in *--reltime* or *--human* "
23919 #. type: Labeled list
23920 #: ../sys-utils/dmesg.1.adoc:166
23925 #. type: Plain text
23926 #: ../sys-utils/dmesg.1.adoc:168
23927 msgid "The text of the message with the alert log priority."
23930 #. type: Labeled list
23931 #: ../sys-utils/dmesg.1.adoc:169
23936 #. type: Plain text
23937 #: ../sys-utils/dmesg.1.adoc:171
23938 msgid "The text of the message with the critical log priority."
23941 #. type: Labeled list
23942 #: ../sys-utils/dmesg.1.adoc:172
23947 #. type: Plain text
23948 #: ../sys-utils/dmesg.1.adoc:174
23949 msgid "The text of the message with the error log priority."
23952 #. type: Plain text
23953 #: ../sys-utils/dmesg.1.adoc:177
23954 msgid "The text of the message with the warning log priority."
23957 #. type: Labeled list
23958 #: ../sys-utils/dmesg.1.adoc:178
23960 #| msgid "*defaults*"
23962 msgstr "*defaults*"
23964 #. type: Plain text
23965 #: ../sys-utils/dmesg.1.adoc:180
23966 msgid "The text of the message that inform about segmentation fault."
23969 #. type: Plain text
23970 #: ../sys-utils/dmesg.1.adoc:184
23972 msgid "*dmesg* can fail reporting permission denied error. This is usually caused by *dmesg_restrict* kernel setting, please see *syslog*(2) for more details.\n"
23975 #. type: Plain text
23976 #: ../sys-utils/dmesg.1.adoc:190
23978 msgid "*dmesg* was originally written by mailto:tytso@athena.mit.edu[Theodore Ts'o].\n"
23981 #. type: Plain text
23982 #: ../sys-utils/dmesg.1.adoc:195
23985 "*terminal-colors.d*(5),\n"
23990 #. Copyright (C) 1994-2005 Jeff Tranter (tranter@pobox.com)
23991 #. Copyright (C) 2012 Karel Zak <kzak@redhat.com>.
23992 #. It may be distributed under the GNU Public License, version 2, or
23993 #. any higher version. See section COPYING of the GNU Public license
23994 #. for conditions under which this file may be redistributed.
23996 #: ../sys-utils/eject.1.adoc:10
24001 #. type: Plain text
24002 #: ../sys-utils/eject.1.adoc:20
24003 msgid "eject - eject removable media"
24006 #. type: Plain text
24007 #: ../sys-utils/eject.1.adoc:22
24009 msgid "*eject* [options] _device_|_mountpoint_\n"
24012 #. type: Plain text
24013 #: ../sys-utils/eject.1.adoc:26
24015 msgid "*eject* allows removable media (typically a CD-ROM, floppy disk, tape, JAZ, ZIP or USB disk) to be ejected under software control. The command can also control some multi-disc CD-ROM changers, the auto-eject feature supported by some devices, and close the disc tray of some CD-ROM drives.\n"
24018 #. type: Plain text
24019 #: ../sys-utils/eject.1.adoc:28
24021 "The device corresponding to _device_ or _mountpoint_ is ejected. If no name "
24022 "is specified, the default name */dev/cdrom* is used. The device may be "
24023 "addressed by device name (e.g., 'sda'), device path (e.g., '/dev/sda'), "
24024 "UUID=__uuid__ or LABEL=__label__ tags."
24027 #. type: Plain text
24028 #: ../sys-utils/eject.1.adoc:30
24030 "There are four different methods of ejecting, depending on whether the "
24031 "device is a CD-ROM, SCSI device, removable floppy, or tape. By default "
24032 "*eject* tries all four methods in order until it succeeds."
24035 #. type: Plain text
24036 #: ../sys-utils/eject.1.adoc:32
24037 msgid "If a device partition is specified, the whole-disk device is used."
24040 #. type: Plain text
24041 #: ../sys-utils/eject.1.adoc:34
24043 "If the device or a device partition is currently mounted, it is unmounted "
24044 "before ejecting. The eject is processed on exclusive open block device file "
24045 "descriptor if *--no-unmount* or *--force* are not specified."
24048 #. type: Labeled list
24049 #: ../sys-utils/eject.1.adoc:37
24051 msgid "*-a*, **--auto on**|*off*"
24054 #. type: Plain text
24055 #: ../sys-utils/eject.1.adoc:39
24057 "This option controls the auto-eject mode, supported by some devices. When "
24058 "enabled, the drive automatically ejects when the device is closed."
24061 #. type: Labeled list
24062 #: ../sys-utils/eject.1.adoc:40
24064 msgid "*-c*, *--changerslot* _slot_"
24067 #. type: Plain text
24068 #: ../sys-utils/eject.1.adoc:42
24070 "With this option a CD slot can be selected from an ATAPI/IDE CD-ROM changer. "
24071 "The CD-ROM drive cannot be in use (mounted data CD or playing a music CD) "
24072 "for a change request to work. Please also note that the first slot of the "
24073 "changer is referred to as 0, not 1."
24076 #. type: Labeled list
24077 #: ../sys-utils/eject.1.adoc:43
24079 #| msgid "*-f*, *--fast*"
24080 msgid "*-d*, *--default*"
24081 msgstr "*-f*, *--fast*"
24083 #. type: Plain text
24084 #: ../sys-utils/eject.1.adoc:45
24085 msgid "List the default device name."
24088 #. type: Labeled list
24089 #: ../sys-utils/eject.1.adoc:46
24091 #| msgid "*-f*, *--fast*"
24092 msgid "*-F*, *--force*"
24093 msgstr "*-f*, *--fast*"
24095 #. type: Plain text
24096 #: ../sys-utils/eject.1.adoc:48
24098 "Force eject, don't check device type, don't open device with exclusive lock. "
24099 "The successful result may be false positive on non hot-pluggable devices."
24102 #. type: Labeled list
24103 #: ../sys-utils/eject.1.adoc:49
24105 #| msgid "*-P*, *--pty*"
24106 msgid "*-f*, *--floppy*"
24107 msgstr "*-P*, *--pty*"
24109 #. type: Plain text
24110 #: ../sys-utils/eject.1.adoc:51
24112 "This option specifies that the drive should be ejected using a removable "
24113 "floppy disk eject command."
24116 #. type: Labeled list
24117 #: ../sys-utils/eject.1.adoc:52
24119 msgid "*-i*, **--manualeject on**|*off*"
24122 #. type: Plain text
24123 #: ../sys-utils/eject.1.adoc:54
24125 "This option controls locking of the hardware eject button. When enabled, the "
24126 "drive will not be ejected when the button is pressed. This is useful when "
24127 "you are carrying a laptop in a bag or case and don't want it to eject if the "
24128 "button is inadvertently pressed."
24131 #. type: Labeled list
24132 #: ../sys-utils/eject.1.adoc:55
24134 msgid "*-M*, *--no-partitions-unmount*"
24137 #. type: Plain text
24138 #: ../sys-utils/eject.1.adoc:57
24140 "The option tells *eject* to not try to unmount other partitions on "
24141 "partitioned devices. If another partition is still mounted, the program will "
24142 "not attempt to eject the media. It will attempt to unmount only the device "
24143 "or mountpoint given on the command line."
24146 #. type: Labeled list
24147 #: ../sys-utils/eject.1.adoc:58
24149 #| msgid "*-P*, *--pty*"
24150 msgid "*-m*, *--no-unmount*"
24151 msgstr "*-P*, *--pty*"
24153 #. type: Plain text
24154 #: ../sys-utils/eject.1.adoc:60
24156 "The option tells *eject* to not try to unmount at all. If this option is not "
24157 "specified then *eject* opens the device with *O_EXCL* flag to be sure that "
24158 "the device is not used (since v2.35)."
24161 #. type: Labeled list
24162 #: ../sys-utils/eject.1.adoc:61
24164 #| msgid "*-P*, *--pty*"
24165 msgid "*-n*, *--noop*"
24166 msgstr "*-P*, *--pty*"
24168 #. type: Plain text
24169 #: ../sys-utils/eject.1.adoc:63
24171 "With this option the selected device is displayed but no action is performed."
24174 #. type: Labeled list
24175 #: ../sys-utils/eject.1.adoc:64
24177 #| msgid "*-P*, *--pty*"
24178 msgid "*-p*, *--proc*"
24179 msgstr "*-P*, *--pty*"
24181 #. type: Plain text
24182 #: ../sys-utils/eject.1.adoc:66
24184 "This option allows you to use _/proc/mounts_ instead _/etc/mtab_. It also "
24185 "passes the *-n* option to *umount*(8)."
24188 #. type: Labeled list
24189 #: ../sys-utils/eject.1.adoc:67
24191 #| msgid "*-P*, *--pty*"
24192 msgid "*-q*, *--tape*"
24193 msgstr "*-P*, *--pty*"
24195 #. type: Plain text
24196 #: ../sys-utils/eject.1.adoc:69
24198 "This option specifies that the drive should be ejected using a tape drive "
24202 #. type: Labeled list
24203 #: ../sys-utils/eject.1.adoc:70
24205 #| msgid "*-V*, *--version*"
24206 msgid "*-r*, *--cdrom*"
24207 msgstr "*-V*, *--version*"
24209 #. type: Plain text
24210 #: ../sys-utils/eject.1.adoc:72
24212 "This option specifies that the drive should be ejected using a CDROM eject "
24216 #. type: Labeled list
24217 #: ../sys-utils/eject.1.adoc:73
24219 #| msgid "*-f*, *--fast*"
24220 msgid "*-s*, *--scsi*"
24221 msgstr "*-f*, *--fast*"
24223 #. type: Plain text
24224 #: ../sys-utils/eject.1.adoc:75
24226 "This option specifies that the drive should be ejected using SCSI commands."
24229 #. type: Labeled list
24230 #: ../sys-utils/eject.1.adoc:76
24232 #| msgid "*-P*, *--pty*"
24233 msgid "*-T*, *--traytoggle*"
24234 msgstr "*-P*, *--pty*"
24236 #. type: Plain text
24237 #: ../sys-utils/eject.1.adoc:78
24239 "With this option the drive is given a CD-ROM tray close command if it's "
24240 "opened, and a CD-ROM tray eject command if it's closed. Not all devices "
24241 "support this command, because it uses the above CD-ROM tray close command."
24244 #. type: Labeled list
24245 #: ../sys-utils/eject.1.adoc:79
24247 #| msgid "*-P*, *--pty*"
24248 msgid "*-t*, *--trayclose*"
24249 msgstr "*-P*, *--pty*"
24251 #. type: Plain text
24252 #: ../sys-utils/eject.1.adoc:81
24254 "With this option the drive is given a CD-ROM tray close command. Not all "
24255 "devices support this command."
24258 #. type: Plain text
24259 #: ../sys-utils/eject.1.adoc:86
24261 "Run in verbose mode; more information is displayed about what the command is "
24265 #. type: Labeled list
24266 #: ../sys-utils/eject.1.adoc:87
24268 #| msgid "*-h*, *--help*"
24269 msgid "*-X*, *--listspeed*"
24270 msgstr "*-h*, *--help*"
24272 #. type: Plain text
24273 #: ../sys-utils/eject.1.adoc:89
24275 "With this option the CD-ROM drive will be probed to detect the available "
24276 "speeds. The output is a list of speeds which can be used as an argument of "
24277 "the *-x* option. This only works with Linux 2.6.13 or higher, on previous "
24278 "versions solely the maximum speed will be reported. Also note that some "
24279 "drives may not correctly report the speed and therefore this option does not "
24283 #. type: Labeled list
24284 #: ../sys-utils/eject.1.adoc:90
24286 msgid "*-x*, *--cdspeed* _speed_"
24289 #. type: Plain text
24290 #: ../sys-utils/eject.1.adoc:92
24292 "With this option the drive is given a CD-ROM select speed command. The "
24293 "_speed_ argument is a number indicating the desired speed (e.g., 8 for 8X "
24294 "speed), or 0 for maximum data rate. Not all devices support this command and "
24295 "you can only specify speeds that the drive is capable of. Every time the "
24296 "media is changed this option is cleared. This option can be used alone, or "
24297 "with the *-t* and *-c* options."
24300 #. type: Plain text
24301 #: ../sys-utils/eject.1.adoc:100
24303 msgid "*eject* only works with devices that support one or more of the four methods of ejecting. This includes most CD-ROM drives (IDE, SCSI, and proprietary), some SCSI tape drives, JAZ drives, ZIP drives (parallel port, SCSI, and IDE versions), and LS120 removable floppies. Users have also reported success with floppy drives on Sun SPARC and Apple Macintosh systems. If *eject* does not work, it is most likely a limitation of the kernel driver for the device and not the *eject* program itself.\n"
24306 #. type: Plain text
24307 #: ../sys-utils/eject.1.adoc:102
24309 "The *-r*, *-s*, *-f*, and *-q* options allow controlling which methods are "
24310 "used to eject. More than one method can be specified. If none of these "
24311 "options are specified, it tries all four (this works fine in most cases)."
24314 #. type: Plain text
24315 #: ../sys-utils/eject.1.adoc:104
24317 msgid "*eject* may not always be able to determine if the device is mounted (e.g., if it has several names). If the device name is a symbolic link, *eject* will follow the link and use the device that it points to.\n"
24320 #. type: Plain text
24321 #: ../sys-utils/eject.1.adoc:106
24323 "If *eject* determines that the device can have multiple partitions, it will "
24324 "attempt to unmount all mounted partitions of the device before ejecting (see "
24325 "also *--no-partitions-unmount*). If an unmount fails, the program will not "
24326 "attempt to eject the media."
24329 #. type: Plain text
24330 #: ../sys-utils/eject.1.adoc:108
24332 "You can eject an audio CD. Some CD-ROM drives will refuse to open the tray "
24333 "if the drive is empty. Some devices do not support the tray close command."
24336 #. type: Plain text
24337 #: ../sys-utils/eject.1.adoc:110
24339 "If the auto-eject feature is enabled, then the drive will always be ejected "
24340 "after running this command. Not all Linux kernel CD-ROM drivers support the "
24341 "auto-eject mode. There is no way to find out the state of the auto-eject "
24345 #. type: Plain text
24346 #: ../sys-utils/eject.1.adoc:112
24348 "You need appropriate privileges to access the device files. Running as root "
24349 "is required to eject some devices (e.g., SCSI devices)."
24352 #. type: Plain text
24353 #: ../sys-utils/eject.1.adoc:116
24355 "mailto:tranter@pobox.com[Jeff Tranter] - original author, mailto:kzak@redhat."
24356 "com[Karel Zak] and mailto:mluscon@redhat.com[Michal Luscon] - util-linux "
24360 #. type: Plain text
24361 #: ../sys-utils/eject.1.adoc:123
24364 #| "*getmntent*(3),\n"
24366 #| "*findmnt*(8),\n"
24375 "*getmntent*(3),\n"
24382 #: ../sys-utils/fallocate.1.adoc:2
24384 msgid "fallocate(1)"
24387 #. type: Plain text
24388 #: ../sys-utils/fallocate.1.adoc:12
24389 msgid "fallocate - preallocate or deallocate space to a file"
24392 #. type: Plain text
24393 #: ../sys-utils/fallocate.1.adoc:16
24395 msgid "*fallocate* [*-c*|*-p*|*-z*] [*-o* _offset_] *-l* _length_ [*-n*] _filename_\n"
24398 #. type: Plain text
24399 #: ../sys-utils/fallocate.1.adoc:18
24401 msgid "*fallocate* *-d* [*-o* _offset_] [*-l* _length_] _filename_\n"
24404 #. type: Plain text
24405 #: ../sys-utils/fallocate.1.adoc:20
24407 msgid "*fallocate* *-x* [*-o* _offset_] *-l* _length filename_\n"
24410 #. type: Plain text
24411 #: ../sys-utils/fallocate.1.adoc:24
24413 msgid "*fallocate* is used to manipulate the allocated disk space for a file, either to deallocate or preallocate it. For filesystems which support the *fallocate*(2) system call, preallocation is done quickly by allocating blocks and marking them as uninitialized, requiring no IO to the data blocks. This is much faster than creating a file by filling it with zeroes.\n"
24416 #. type: Plain text
24417 #: ../sys-utils/fallocate.1.adoc:26
24419 "The exit status returned by *fallocate* is 0 on success and 1 on failure."
24422 #. type: Plain text
24423 #: ../sys-utils/fallocate.1.adoc:30
24425 "The _length_ and _offset_ arguments may be followed by the multiplicative "
24426 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
24427 "ZiB, and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
24428 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
24429 "PB, EB, ZB, and YB."
24432 #. type: Plain text
24433 #: ../sys-utils/fallocate.1.adoc:32
24435 "The options *--collapse-range*, *--dig-holes*, *--punch-hole*, and *--zero-"
24436 "range* are mutually exclusive."
24439 #. type: Labeled list
24440 #: ../sys-utils/fallocate.1.adoc:33
24442 msgid "*-c*, *--collapse-range*"
24445 #. type: Plain text
24446 #: ../sys-utils/fallocate.1.adoc:35
24448 "Removes a byte range from a file, without leaving a hole. The byte range to "
24449 "be collapsed starts at _offset_ and continues for _length_ bytes. At the "
24450 "completion of the operation, the contents of the file starting at the "
24451 "location __offset__+_length_ will be appended at the location _offset_, and "
24452 "the file will be _length_ bytes smaller. The option *--keep-size* may not be "
24453 "specified for the collapse-range operation."
24456 #. type: Plain text
24457 #: ../sys-utils/fallocate.1.adoc:37
24459 "Available since Linux 3.15 for ext4 (only for extent-based files) and XFS."
24462 #. type: Plain text
24463 #: ../sys-utils/fallocate.1.adoc:39
24465 "A filesystem may place limitations on the granularity of the operation, in "
24466 "order to ensure efficient implementation. Typically, _offset_ and _length_ "
24467 "must be a multiple of the filesystem logical block size, which varies "
24468 "according to the filesystem type and configuration. If a filesystem has such "
24469 "a requirement, the operation will fail with the error *EINVAL* if this "
24470 "requirement is violated."
24473 #. type: Labeled list
24474 #: ../sys-utils/fallocate.1.adoc:40
24476 #| msgid "*-h*, *--help*"
24477 msgid "*-d*, *--dig-holes*"
24478 msgstr "*-h*, *--help*"
24480 #. type: Plain text
24481 #: ../sys-utils/fallocate.1.adoc:42
24483 "Detect and dig holes. This makes the file sparse in-place, without using "
24484 "extra disk space. The minimum size of the hole depends on filesystem I/O "
24485 "block size (usually 4096 bytes). Also, when using this option, *--keep-size* "
24486 "is implied. If no range is specified by *--offset* and *--length*, then the "
24487 "entire file is analyzed for holes."
24490 #. type: Plain text
24491 #: ../sys-utils/fallocate.1.adoc:44
24493 "You can think of this option as doing a \"*cp --sparse*\" and then renaming "
24494 "the destination file to the original, without the need for extra disk space."
24497 #. type: Plain text
24498 #: ../sys-utils/fallocate.1.adoc:46
24499 msgid "See *--punch-hole* for a list of supported filesystems."
24502 #. type: Labeled list
24503 #: ../sys-utils/fallocate.1.adoc:47
24505 #| msgid "*-V*, *--version*"
24506 msgid "*-i*, *--insert-range*"
24507 msgstr "*-V*, *--version*"
24509 #. type: Plain text
24510 #: ../sys-utils/fallocate.1.adoc:49
24511 msgid "Insert a hole of _length_ bytes from _offset_, shifting existing data."
24514 #. type: Plain text
24515 #: ../sys-utils/fallocate.1.adoc:52
24516 msgid "Specifies the length of the range, in bytes."
24519 #. type: Labeled list
24520 #: ../sys-utils/fallocate.1.adoc:53
24522 #| msgid "*-h*, *--help*"
24523 msgid "*-n*, *--keep-size*"
24524 msgstr "*-h*, *--help*"
24526 #. type: Plain text
24527 #: ../sys-utils/fallocate.1.adoc:55
24529 "Do not modify the apparent length of the file. This may effectively allocate "
24530 "blocks past EOF, which can be removed with a truncate."
24533 #. type: Plain text
24534 #: ../sys-utils/fallocate.1.adoc:58
24535 msgid "Specifies the beginning offset of the range, in bytes."
24538 #. type: Labeled list
24539 #: ../sys-utils/fallocate.1.adoc:59
24541 #| msgid "*-h*, *--help*"
24542 msgid "*-p*, *--punch-hole*"
24543 msgstr "*-h*, *--help*"
24545 #. type: Plain text
24546 #: ../sys-utils/fallocate.1.adoc:61
24548 "Deallocates space (i.e., creates a hole) in the byte range starting at "
24549 "_offset_ and continuing for _length_ bytes. Within the specified range, "
24550 "partial filesystem blocks are zeroed, and whole filesystem blocks are "
24551 "removed from the file. After a successful call, subsequent reads from this "
24552 "range will return zeroes. This option may not be specified at the same time "
24553 "as the *--zero-range* option. Also, when using this option, *--keep-size* is "
24557 #. type: Plain text
24558 #: ../sys-utils/fallocate.1.adoc:63
24560 "Supported for XFS (since Linux 2.6.38), ext4 (since Linux 3.0), Btrfs (since "
24561 "Linux 3.7), tmpfs (since Linux 3.5) and gfs2 (since Linux 4.16)."
24564 #. type: Plain text
24565 #: ../sys-utils/fallocate.1.adoc:66
24566 msgid "Enable verbose mode."
24569 #. type: Labeled list
24570 #: ../sys-utils/fallocate.1.adoc:67
24572 #| msgid "*-P*, *--pty*"
24573 msgid "*-x*, *--posix*"
24574 msgstr "*-P*, *--pty*"
24576 #. type: Plain text
24577 #: ../sys-utils/fallocate.1.adoc:69
24579 "Enable POSIX operation mode. In that mode allocation operation always "
24580 "completes, but it may take longer time when fast allocation is not supported "
24581 "by the underlying filesystem."
24584 #. type: Labeled list
24585 #: ../sys-utils/fallocate.1.adoc:70
24587 #| msgid "*-V*, *--version*"
24588 msgid "*-z*, *--zero-range*"
24589 msgstr "*-V*, *--version*"
24591 #. type: Plain text
24592 #: ../sys-utils/fallocate.1.adoc:72
24594 "Zeroes space in the byte range starting at _offset_ and continuing for "
24595 "_length_ bytes. Within the specified range, blocks are preallocated for the "
24596 "regions that span the holes in the file. After a successful call, subsequent "
24597 "reads from this range will return zeroes."
24600 #. type: Plain text
24601 #: ../sys-utils/fallocate.1.adoc:74
24603 "Zeroing is done within the filesystem preferably by converting the range "
24604 "into unwritten extents. This approach means that the specified range will "
24605 "not be physically zeroed out on the device (except for partial blocks at the "
24606 "either end of the range), and I/O is (otherwise) required only to update "
24610 #. type: Plain text
24611 #: ../sys-utils/fallocate.1.adoc:76
24613 "Option *--keep-size* can be specified to prevent file length modification."
24616 #. type: Plain text
24617 #: ../sys-utils/fallocate.1.adoc:78
24619 "Available since Linux 3.14 for ext4 (only for extent-based files) and XFS."
24622 #. type: Plain text
24623 #: ../sys-utils/fallocate.1.adoc:85
24625 "mailto:sandeen@redhat.com[Eric Sandeen], mailto:kzak@redhat.com[Karel Zak]"
24628 #. type: Plain text
24629 #: ../sys-utils/fallocate.1.adoc:91
24633 "*fallocate*(2),\n"
24634 "*posix_fallocate*(3)\n"
24640 #. Copyright 2003-2006 H. Peter Anvin - All Rights Reserved
24641 #. Permission is hereby granted, free of charge, to any person
24642 #. obtaining a copy of this software and associated documentation
24643 #. files (the "Software"), to deal in the Software without
24644 #. restriction, including without limitation the rights to use,
24645 #. copy, modify, merge, publish, distribute, sublicense, and/or
24646 #. sell copies of the Software, and to permit persons to whom
24647 #. the Software is furnished to do so, subject to the following
24649 #. The above copyright notice and this permission notice shall
24650 #. be included in all copies or substantial portions of the Software.
24651 #. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
24652 #. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
24653 #. OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24654 #. NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
24655 #. HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
24656 #. WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24657 #. FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
24658 #. OTHER DEALINGS IN THE SOFTWARE.
24660 #: ../sys-utils/flock.1.adoc:26
24665 #. type: Plain text
24666 #: ../sys-utils/flock.1.adoc:37
24667 msgid "flock - manage locks from shell scripts"
24670 #. type: Plain text
24671 #: ../sys-utils/flock.1.adoc:41
24673 msgid "*flock* [options] _file_|_directory_ _command_ [_arguments_]\n"
24676 #. type: Plain text
24677 #: ../sys-utils/flock.1.adoc:43
24679 msgid "*flock* [options] _file_|_directory_ *-c* _command_\n"
24682 #. type: Plain text
24683 #: ../sys-utils/flock.1.adoc:45
24685 msgid "*flock* [options] _number_\n"
24688 #. type: Plain text
24689 #: ../sys-utils/flock.1.adoc:49
24691 "This utility manages *flock*(2) locks from within shell scripts or from the "
24695 #. type: Plain text
24696 #: ../sys-utils/flock.1.adoc:51
24698 "The first and second of the above forms wrap the lock around the execution "
24699 "of a _command_, in a manner similar to *su*(1) or *newgrp*(1). They lock a "
24700 "specified _file_ or _directory_, which is created (assuming appropriate "
24701 "permissions) if it does not already exist. By default, if the lock cannot be "
24702 "immediately acquired, *flock* waits until the lock is available."
24705 #. type: Plain text
24706 #: ../sys-utils/flock.1.adoc:53
24708 "The third form uses an open file by its file descriptor _number_. See the "
24709 "examples below for how that can be used."
24712 #. type: Plain text
24713 #: ../sys-utils/flock.1.adoc:58
24715 #| msgid "Pass _command_ to the shell with the *-c* option."
24716 msgid "Pass a single _command_, without arguments, to the shell with *-c*."
24717 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
24719 #. type: Labeled list
24720 #: ../sys-utils/flock.1.adoc:59
24722 msgid "*-E*, *--conflict-exit-code* _number_"
24725 #. type: Plain text
24726 #: ../sys-utils/flock.1.adoc:61
24728 "The exit status used when the *-n* option is in use, and the conflicting "
24729 "lock exists, or the *-w* option is in use, and the timeout is reached. The "
24730 "default value is *1*. The _number_ has to be in the range of 0 to 255."
24733 #. type: Plain text
24734 #: ../sys-utils/flock.1.adoc:64
24736 "Do not fork before executing _command_. Upon execution the flock process is "
24737 "replaced by _command_ which continues to hold the lock. This option is "
24738 "incompatible with *--close* as there would otherwise be nothing left to hold "
24742 #. type: Labeled list
24743 #: ../sys-utils/flock.1.adoc:65
24745 #| msgid "*-*, *-l*, *--login*"
24746 msgid "*-e*, *-x*, *--exclusive*"
24747 msgstr "*-*, *-l*, *--login*"
24749 #. type: Plain text
24750 #: ../sys-utils/flock.1.adoc:67
24752 "Obtain an exclusive lock, sometimes called a write lock. This is the default."
24755 #. type: Labeled list
24756 #: ../sys-utils/flock.1.adoc:68
24758 #| msgid "*-*, *-l*, *--login*"
24759 msgid "*-n*, *--nb*, *--nonblock*"
24760 msgstr "*-*, *-l*, *--login*"
24762 #. type: Plain text
24763 #: ../sys-utils/flock.1.adoc:70
24765 "Fail rather than wait if the lock cannot be immediately acquired. See the *-"
24766 "E* option for the exit status used."
24769 #. type: Labeled list
24770 #: ../sys-utils/flock.1.adoc:71
24772 #| msgid "*-h*, *--help*"
24773 msgid "*-o*, *--close*"
24774 msgstr "*-h*, *--help*"
24776 #. type: Plain text
24777 #: ../sys-utils/flock.1.adoc:73
24779 "Close the file descriptor on which the lock is held before executing "
24780 "_command_. This is useful if _command_ spawns a child process which should "
24781 "not be holding the lock."
24784 #. type: Labeled list
24785 #: ../sys-utils/flock.1.adoc:74
24787 #| msgid "*-h*, *--help*"
24788 msgid "*-s*, *--shared*"
24789 msgstr "*-h*, *--help*"
24791 #. type: Plain text
24792 #: ../sys-utils/flock.1.adoc:76
24793 msgid "Obtain a shared lock, sometimes called a read lock."
24796 #. type: Labeled list
24797 #: ../sys-utils/flock.1.adoc:77
24799 #| msgid "*-h*, *--help*"
24800 msgid "*-u*, *--unlock*"
24801 msgstr "*-h*, *--help*"
24803 #. type: Plain text
24804 #: ../sys-utils/flock.1.adoc:79
24806 "Drop a lock. This is usually not required, since a lock is automatically "
24807 "dropped when the file is closed. However, it may be required in special "
24808 "cases, for example if the enclosed command group may have forked a "
24809 "background process which should not be holding the lock."
24812 #. type: Labeled list
24813 #: ../sys-utils/flock.1.adoc:80
24815 msgid "*-w*, *--wait*, *--timeout* _seconds_"
24818 #. type: Plain text
24819 #: ../sys-utils/flock.1.adoc:82
24821 "Fail if the lock cannot be acquired within _seconds_. Decimal fractional "
24822 "values are allowed. See the *-E* option for the exit status used. The zero "
24823 "number of _seconds_ is interpreted as *--nonblock*."
24826 #. type: Plain text
24827 #: ../sys-utils/flock.1.adoc:85
24829 "Report how long it took to acquire the lock, or why the lock could not be "
24833 #. type: Plain text
24834 #: ../sys-utils/flock.1.adoc:91
24836 "The command uses <sysexits.h> exit status values for everything, except when "
24837 "using either of the options *-n* or *-w* which report a failure to acquire "
24838 "the lock with an exit status given by the *-E* option, or 1 by default. The "
24839 "exit status given by *-E* has to be in the range of 0 to 255."
24842 #. type: Plain text
24843 #: ../sys-utils/flock.1.adoc:93
24845 "When using the _command_ variant, and executing the child worked, then the "
24846 "exit status is that of the child command."
24849 #. type: Plain text
24850 #: ../sys-utils/flock.1.adoc:97
24852 msgid "*flock* does not detect deadlock. See *flock*(2) for details.\n"
24855 #. type: Plain text
24856 #: ../sys-utils/flock.1.adoc:99
24858 "Some file systems (e. g. NFS and CIFS) have a limited implementation of "
24859 "*flock*(2) and flock may always fail. For details see *flock*(2), *nfs*(5) "
24860 "and *mount.cifs*(8). Depending on mount options, flock can always fail there."
24863 #. type: Plain text
24864 #: ../sys-utils/flock.1.adoc:103
24865 msgid "Note that \"shell> \" in examples is a command line prompt."
24868 #. type: Labeled list
24869 #: ../sys-utils/flock.1.adoc:104
24871 msgid "shell1> flock /tmp -c cat; shell2> flock -w .007 /tmp -c echo; /bin/echo $?"
24874 #. type: Plain text
24875 #: ../sys-utils/flock.1.adoc:106
24877 "Set exclusive lock to directory _/tmp_ and the second command will fail."
24880 #. type: Labeled list
24881 #: ../sys-utils/flock.1.adoc:107
24883 msgid "shell1> flock -s /tmp -c cat; shell2> flock -s -w .007 /tmp -c echo; /bin/echo $?"
24886 #. type: Plain text
24887 #: ../sys-utils/flock.1.adoc:109
24889 "Set shared lock to directory _/tmp_ and the second command will not fail. "
24890 "Notice that attempting to get exclusive lock with second command would fail."
24893 #. type: Labeled list
24894 #: ../sys-utils/flock.1.adoc:110
24896 msgid "shell> flock -x local-lock-file echo 'a b c'"
24899 #. type: Plain text
24900 #: ../sys-utils/flock.1.adoc:112
24902 "Grab the exclusive lock \"local-lock-file\" before running echo with 'a b c'."
24905 #. type: Labeled list
24906 #: ../sys-utils/flock.1.adoc:113
24908 msgid "(; flock -n 9 || exit 1; # ... commands executed under lock ...; ) 9>/var/lock/mylockfile"
24911 #. type: Plain text
24912 #: ../sys-utils/flock.1.adoc:115
24914 "The form is convenient inside shell scripts. The mode used to open the file "
24915 "doesn't matter to *flock*; using _>_ or _>>_ allows the lockfile to be "
24916 "created if it does not already exist, however, write permission is required. "
24917 "Using _<_ requires that the file already exists but only read permission is "
24921 #. type: Labeled list
24922 #: ../sys-utils/flock.1.adoc:116
24924 msgid "[ \"$\\{FLOCKER}\" != \"$0\" ] && exec env FLOCKER=\"$0\" flock -en \"$0\" \"$0\" \"$@\" || : "
24927 #. type: Plain text
24928 #: ../sys-utils/flock.1.adoc:118
24930 "This is useful boilerplate code for shell scripts. Put it at the top of the "
24931 "shell script you want to lock and it'll automatically lock itself on the "
24932 "first run. If the environment variable *$FLOCKER* is not set to the shell "
24933 "script that is being run, then execute *flock* and grab an exclusive non-"
24934 "blocking lock (using the script itself as the lock file) before re-execing "
24935 "itself with the right arguments. It also sets the *FLOCKER* environment "
24936 "variable to the right value so it doesn't run again."
24939 #. type: Labeled list
24940 #: ../sys-utils/flock.1.adoc:119
24942 msgid "shell> exec 4<>/var/lock/mylockfile; shell> flock -n 4"
24945 #. type: Plain text
24946 #: ../sys-utils/flock.1.adoc:121
24948 "This form is convenient for locking a file without spawning a subprocess. "
24949 "The shell opens the lock file for reading and writing as file descriptor 4, "
24950 "then *flock* is used to lock the descriptor."
24953 #. type: Plain text
24954 #: ../sys-utils/flock.1.adoc:125
24955 msgid "mailto:hpa@zytor.com[H. Peter Anvin]"
24958 #. TRANSLATORS: Keep {copyright} untranslated.
24959 #. type: Plain text
24960 #: ../sys-utils/flock.1.adoc:130
24962 "Copyright {copyright} 2003-2006 H. Peter Anvin. This is free software; see "
24963 "the source for copying conditions. There is NO warranty; not even for "
24964 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
24967 #. type: Plain text
24968 #: ../sys-utils/flock.1.adoc:134
24970 msgid "*flock*(2)\n"
24974 #: ../sys-utils/fsfreeze.8.adoc:2
24976 msgid "fsfreeze(8)"
24979 #. type: Plain text
24980 #: ../sys-utils/fsfreeze.8.adoc:12
24981 msgid "fsfreeze - suspend access to a filesystem (Ext3/4, ReiserFS, JFS, XFS)"
24984 #. type: Plain text
24985 #: ../sys-utils/fsfreeze.8.adoc:16
24987 msgid "*fsfreeze* *--freeze*|*--unfreeze* _mountpoint_\n"
24990 #. type: Plain text
24991 #: ../sys-utils/fsfreeze.8.adoc:20
24993 msgid "*fsfreeze* suspends or resumes access to a filesystem.\n"
24996 #. type: Plain text
24997 #: ../sys-utils/fsfreeze.8.adoc:22
24999 msgid "*fsfreeze* halts any new access to the filesystem and creates a stable image on disk. *fsfreeze* is intended to be used with hardware RAID devices that support the creation of snapshots.\n"
25002 #. type: Plain text
25003 #: ../sys-utils/fsfreeze.8.adoc:24
25005 msgid "*fsfreeze* is unnecessary for *device-mapper* devices. The device-mapper (and LVM) automatically freezes a filesystem on the device when a snapshot creation is requested. For more details see the *dmsetup*(8) man page.\n"
25008 #. type: Plain text
25009 #: ../sys-utils/fsfreeze.8.adoc:26
25011 "The _mountpoint_ argument is the pathname of the directory where the "
25012 "filesystem is mounted. The filesystem must be mounted to be frozen (see "
25016 #. type: Plain text
25017 #: ../sys-utils/fsfreeze.8.adoc:28
25019 "Note that access-time updates are also suspended if the filesystem is "
25020 "mounted with the traditional atime behavior (mount option *strictatime*, for "
25021 "more details see *mount*(8))."
25024 #. type: Labeled list
25025 #: ../sys-utils/fsfreeze.8.adoc:31
25027 #| msgid "*-f*, *--fast*"
25028 msgid "*-f*, *--freeze*"
25029 msgstr "*-f*, *--fast*"
25031 #. type: Plain text
25032 #: ../sys-utils/fsfreeze.8.adoc:33
25034 "This option requests the specified filesystem to be frozen from new "
25035 "modifications. When this is selected, all ongoing transactions in the "
25036 "filesystem are allowed to complete, new *write*(2) system calls are halted, "
25037 "other calls which modify the filesystem are halted, and all dirty data, "
25038 "metadata, and log information are written to disk. Any process attempting to "
25039 "write to the frozen filesystem will block waiting for the filesystem to be "
25043 #. type: Plain text
25044 #: ../sys-utils/fsfreeze.8.adoc:35
25046 "Note that even after freezing, the on-disk filesystem can contain "
25047 "information on files that are still in the process of unlinking. These files "
25048 "will not be unlinked until the filesystem is unfrozen or a clean mount of "
25049 "the snapshot is complete."
25052 #. type: Labeled list
25053 #: ../sys-utils/fsfreeze.8.adoc:36
25055 #| msgid "*-h*, *--help*"
25056 msgid "*-u*, *--unfreeze*"
25057 msgstr "*-h*, *--help*"
25059 #. type: Plain text
25060 #: ../sys-utils/fsfreeze.8.adoc:38
25062 "This option is used to un-freeze the filesystem and allow operations to "
25063 "continue. Any filesystem modifications that were blocked by the freeze are "
25064 "unblocked and allowed to complete."
25068 #: ../sys-utils/fsfreeze.8.adoc:41
25070 msgid "FILESYSTEM SUPPORT"
25073 #. type: Plain text
25074 #: ../sys-utils/fsfreeze.8.adoc:44
25076 "This command will work only if filesystem supports has support for freezing. "
25077 "List of these filesystems include (2016-12-18) *btrfs*, *ext2/3/4*, *f2fs*, "
25078 "*jfs*, *nilfs2*, *reiserfs*, and *xfs*. Previous list may be incomplete, as "
25079 "more filesystems get support. If in doubt easiest way to know if a "
25080 "filesystem has support is create a small loopback mount and test freezing it."
25083 #. type: Plain text
25084 #: ../sys-utils/fsfreeze.8.adoc:48
25085 msgid "This man page is based on *xfs_freeze*(8)."
25088 #. type: Plain text
25089 #: ../sys-utils/fsfreeze.8.adoc:52
25090 msgid "Written by Hajime Taira."
25093 #. type: Plain text
25094 #: ../sys-utils/fsfreeze.8.adoc:56 ../sys-utils/mountpoint.1.adoc:68
25096 msgid "*mount*(8)\n"
25102 #. Copyright (c) 1980, 1989, 1991 The Regents of the University of California.
25103 #. All rights reserved.
25104 #. Redistribution and use in source and binary forms, with or without
25105 #. modification, are permitted provided that the following conditions
25107 #. 1. Redistributions of source code must retain the above copyright
25108 #. notice, this list of conditions and the following disclaimer.
25109 #. 2. Redistributions in binary form must reproduce the above copyright
25110 #. notice, this list of conditions and the following disclaimer in the
25111 #. documentation and/or other materials provided with the distribution.
25112 #. 3. All advertising materials mentioning features or use of this software
25113 #. must display the following acknowledgement:
25114 #. This product includes software developed by the University of
25115 #. California, Berkeley and its contributors.
25116 #. 4. Neither the name of the University nor the names of its contributors
25117 #. may be used to endorse or promote products derived from this software
25118 #. without specific prior written permission.
25119 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25120 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25121 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25122 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25123 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25124 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25125 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25126 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25127 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25128 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25130 #. @(#)fstab.5 6.5 (Berkeley) 5/10/91
25132 #: ../sys-utils/fstab.5.adoc:36
25137 #. type: Plain text
25138 #: ../sys-utils/fstab.5.adoc:46
25139 msgid "fstab - static information about the filesystems"
25140 msgstr "fstab - statická informace o souborových systémech"
25142 #. type: Plain text
25143 #: ../sys-utils/fstab.5.adoc:54
25145 "The file *fstab* contains descriptive information about the filesystems the "
25146 "system can mount. *fstab* is only read by programs, and not written; it is "
25147 "the duty of the system administrator to properly create and maintain this "
25148 "file. The order of records in *fstab* is important because *fsck*(8), "
25149 "*mount*(8), and *umount*(8) sequentially iterate through *fstab* doing their "
25152 "Soubor *fstab* obsahuje popisnou informaci o souborových systémech, které "
25153 "systém umí připojit. *fstab* je programy pouze čten, nikoli zapisován. Je "
25154 "starostí správce jej správně vytvořit a udržovat. Pořadí záznamů ve *fstab* "
25155 "je důležité, protože nástroje *fsck*(8), *mount*(8) a *umount*(8) postupně "
25156 "*fstab* procházejí a řídí tak svoji činnost."
25158 #. type: Plain text
25159 #: ../sys-utils/fstab.5.adoc:56
25161 "The file is not read by *mount*(8) only but often is used by many other "
25162 "tools and daemons, and proper functionality may require additional steps. "
25163 "For example, on systemd-based systems, it's recommended to use 'systemctl "
25164 "daemon-reload' after *fstab* modification."
25167 #. type: Plain text
25168 #: ../sys-utils/fstab.5.adoc:58
25170 "Each filesystem is described on a separate line. Fields on each line are "
25171 "separated by tabs or spaces. Lines starting with '#' are comments. Blank "
25172 "lines are ignored."
25174 "Každý souborový systém je popsán na samostatném řádku. Jednotlivá pole "
25175 "každého řádku jsou oddělena tabulátory nebo mezerami. Řádky začínající "
25176 "znakem „#“ jsou komentáře. Prázdné řádky jsou ignorovány."
25178 #. type: Plain text
25179 #: ../sys-utils/fstab.5.adoc:60
25180 msgid "The following is a typical example of an *fstab* entry:"
25181 msgstr "Následuje typická ukázka záznamu *fstab*:"
25183 #. type: delimited block .
25184 #: ../sys-utils/fstab.5.adoc:63
25186 msgid "LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2\n"
25187 msgstr "LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2\n"
25190 #: ../sys-utils/fstab.5.adoc:65
25192 msgid "The first field (_fs_spec_)."
25193 msgstr "První položka (_fs_spec_)."
25195 #. type: Plain text
25196 #: ../sys-utils/fstab.5.adoc:68
25199 #| "This field describes the block special device, remote filesystem or "
25200 #| "filesystem image for loop device to be mounted or swap file or swap "
25201 #| "partition to be enabled."
25203 "This field describes the block special device, remote filesystem or "
25204 "filesystem image for loop device to be mounted or swap file or swap device "
25207 "Tato položka popisuje zvláštní blokové zařízení, vzdálený systém souborů "
25208 "nebo obraz se systémem souborů pro zařízení loop, který má být připojen, "
25209 "nebo odkládací soubor či oddíl, který má být zapnut."
25211 #. type: Plain text
25212 #: ../sys-utils/fstab.5.adoc:70
25214 "For ordinary mounts, it will hold (a link to) a block special device node "
25215 "(as created by *mknod*(2)) for the device to be mounted, like _/dev/cdrom_ "
25216 "or _/dev/sdb7_. For NFS mounts, this field is _<host>:<dir>_, e.g., _knuth."
25217 "aeb.nl:/_. For filesystems with no storage, any string can be used, and will "
25218 "show up in *df*(1) output, for example. Typical usage is _proc_ for "
25219 "*procfs*; _mem_, _none_, or _tmpfs_ for *tmpfs*. Other special filesystems, "
25220 "like *udev* and *sysfs*, are typically not listed in *fstab*."
25222 "Pro normální připojení toto je (odkaz na) i-uzel zvláštního blokového "
25223 "zařízení (lze vyrobit pomocí *mknod*(2)), jehož zařízení se má připojit. "
25224 "Například _/dev/cdrom_ nebo _/dev/sdb7_. Pro připojení NFS je tato položka "
25225 "_<stroj>:<adresář>_, například _knuth.aeb.nl:/_. V případě souborových "
25226 "systémů bez úložiště lze použít jakýkoliv řetězec. Tan pak bude například "
25227 "uveden ve výstupu *df*(1). Typické využití je _proc_ pro *procfs*; _mem_, "
25228 "_none_ nebo _tmpfs_ pro *tmpfs*. Další zvláštní souborové systémy, jako "
25229 "*udev* nebo *sysfs*, se do *fstab* obvykle neuvádějí."
25231 #. type: Plain text
25232 #: ../sys-utils/fstab.5.adoc:72
25234 "LABEL=<label> or UUID=<uuid> may be given instead of a device name. This is "
25235 "the recommended method, as device names are often a coincidence of hardware "
25236 "detection order, and can change when other disks are added or removed. For "
25237 "example, 'LABEL=Boot' or 'UUID=3e6be9de-8139-11d1-9106-a43f08d823a6'. (Use a "
25238 "filesystem-specific tool like *e2label*(8), *xfs_admin*(8), or *fatlabel*(8) "
25239 "to set LABELs on filesystems)."
25241 "Místo názvu zařízení lze zadat LABEL=<jmenovka> nebo UUID=<UUID>. Toto je "
25242 "doporučený postup, protože názvy zařízení jsou často výsledkem nahodilého "
25243 "pořadí detekce hardwaru a mohou se změnit, když se další disky přidají nebo "
25244 "odeberou. Příklady: „LABEL=Boot“ nebo „UUID=3e6be9de-8139-11d1-9106-"
25245 "a43f08d823a6“. (Jmenovku souborové systému můžete nastavit nástrojem určeným "
25246 "pro konkrétní souborový systém. Například *e2label*(8), *xfs_admin*(8) nebo "
25249 #. type: Plain text
25250 #: ../sys-utils/fstab.5.adoc:74
25252 "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
25253 "identifiers are supported for example for GUID Partition Table (GPT)."
25255 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
25256 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
25258 #. type: Plain text
25259 #: ../sys-utils/fstab.5.adoc:76
25261 "See *mount*(8), *blkid*(8) or *lsblk*(8) for more details about device "
25264 "Pro podrobnosti o identifikátorech zařízení nahlédněte do *mount*(8), "
25265 "*blkid*(8) a *lsblk*(8)."
25267 #. type: Plain text
25268 #: ../sys-utils/fstab.5.adoc:78
25270 "Note that *mount*(8) uses UUIDs as strings. The string representation of the "
25271 "UUID should be based on lower case characters. But when specifying the "
25272 "volume ID of FAT or NTFS file systems upper case characters are used (e.g "
25273 "UUID=\"A40D-85E7\" or UUID=\"61DB7756DB7779B3\")."
25275 "Pamatujte, že *mount*(8) používá UUID jako řetězce. Řetězcová reprezentace "
25276 "UUID by se měla zakládat na malých písmenech. Avšak pro zadání "
25277 "identifikátoru souborových systémů FAT a NFTS se používají písmena velká "
25278 "(např. UUID=\"A40D-85E7\" nebo UUID=\"61DB7756DB7779B3\")."
25281 #: ../sys-utils/fstab.5.adoc:79
25283 msgid "The second field (_fs_file_)."
25284 msgstr "Druhá položka (_fs_file_)."
25286 #. type: Plain text
25287 #: ../sys-utils/fstab.5.adoc:82
25290 #| "This field describes the mount point (target) for the filesystem. For "
25291 #| "swap partitions, this field should be specified as `none'. If the name of "
25292 #| "the mount point contains spaces or tabs these can be escaped as `\\040' "
25293 #| "and '\\011' respectively."
25295 "This field describes the mount point (target) for the filesystem. For swap "
25296 "area, this field should be specified as `none'. If the name of the mount "
25297 "point contains spaces or tabs these can be escaped as `\\040' and '\\011' "
25300 "Toto položka popisuje místo pro připojení (cíl) souborového systému. Pro "
25301 "odkládací oddíly by tato položka měla být vedena jako „none“. Pokud název "
25302 "místa připojení obsahuje mezery nebo tabulátory, lze je zapsat jako „\\040“ "
25306 #: ../sys-utils/fstab.5.adoc:83
25308 msgid "The third field (_fs_vfstype_)."
25309 msgstr "Třetí položka (_fs_vfstype_)."
25311 #. type: Plain text
25312 #: ../sys-utils/fstab.5.adoc:86
25314 "This field describes the type of the filesystem. Linux supports many "
25315 "filesystem types: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus, tmpfs, sysfs, "
25316 "proc, iso9660, udf, squashfs, nfs, cifs, and many more. For more details, "
25319 "Tato položka popisuje druh souborového systému. Linux podporuje mnoho druhů "
25320 "systémů: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus, tmpfs, sysfs, proc, "
25321 "iso9660, udf, squashfs, nfs, cifs a mnohé další. Pro podrobnosti vizte "
25324 #. type: Plain text
25325 #: ../sys-utils/fstab.5.adoc:88
25327 "An entry _swap_ denotes a file or partition to be used for swapping, cf. "
25328 "*swapon*(8). An entry _none_ is useful for bind or move mounts."
25330 "Záznam _swap_ označuje soubor nebo oddíl, který se má použít pro odkládaní "
25331 "(swap) paměti. Vizte *swapon*(8). Záznam _none_ se rovněž hodí pro vázaná "
25332 "(bind) připojení a přesunovaná (move) připojení."
25334 #. type: Plain text
25335 #: ../sys-utils/fstab.5.adoc:90
25336 msgid "More than one type may be specified in a comma-separated list."
25337 msgstr "Lze zadat více jak jeden druh. Oddělují se čárkami."
25339 #. type: Plain text
25340 #: ../sys-utils/fstab.5.adoc:92
25342 msgid "*mount*(8) and *umount*(8) support filesystem _subtypes_. The subtype is defined by '.subtype' suffix. For example 'fuse.sshfs'. It's recommended to use subtype notation rather than add any prefix to the first fstab field (for example 'sshfs#example.com' is deprecated).\n"
25343 msgstr "*mount*(8) a *umount*(8) podporují _podtypy_ souborových systémů. Podtyp se definuje pomocí přípony „.subtype“. Například „fuse.sshfs“. Je doporučeno použít zápis podtypem než přidávat předponu do první položky fstabu (příklad zastaralého použití je „sshfs#example.com“).\n"
25346 #: ../sys-utils/fstab.5.adoc:93
25348 msgid "The fourth field (_fs_mntops_)."
25349 msgstr "Čtvrtá položka (_fs_mntops_)."
25351 #. type: Plain text
25352 #: ../sys-utils/fstab.5.adoc:96
25353 msgid "This field describes the mount options associated with the filesystem."
25354 msgstr "Tato položka popisuje volby pro připojení souborového systému."
25356 #. type: Plain text
25357 #: ../sys-utils/fstab.5.adoc:98
25359 "It is formatted as a comma-separated list of options and is optional for "
25360 "*mount*(8) or *swapon*(8). The usual convention is to use at least "
25361 "\"defaults\" keyword there."
25364 #. type: Plain text
25365 #: ../sys-utils/fstab.5.adoc:100
25368 #| "It is formatted as a comma-separated list of options. It contains at "
25369 #| "least the type of mount (*ro* or *rw*), plus any additional options "
25370 #| "appropriate to the filesystem type (including performance-tuning "
25371 #| "options). For details, see *mount*(8) or *swapon*(8)."
25373 "It usually contains the type of mount (*ro* or *rw*, the default is *rw*), "
25374 "plus any additional options appropriate to the filesystem type (including "
25375 "performance-tuning options). For details, see *mount*(8) or *swapon*(8)."
25377 "Jedná se o seznamem voleb oddělených čárkami. Vždy obsahuje způsob připojení "
25378 "(*ro* nebo *rw*). Eventuálně další volby vhodné pro daný souborový systém "
25379 "(včetně voleb ovlivňujících výkon). Pro podrobnosti vizte *mount*(8) a "
25382 #. type: Plain text
25383 #: ../sys-utils/fstab.5.adoc:102
25384 msgid "Basic filesystem-independent options are:"
25385 msgstr "Základní volby nezávislé na souborovém systému jsou:"
25387 #. type: Labeled list
25388 #: ../sys-utils/fstab.5.adoc:103 ../sys-utils/mount.8.adoc:544
25391 msgstr "*defaults*"
25393 #. type: Plain text
25394 #: ../sys-utils/fstab.5.adoc:105
25396 "use default options. The default depends on the kernel and the filesystem. "
25397 "*mount*(8) does not have any hardcoded set of default options. The kernel "
25398 "default is usually rw, suid, dev, exec, auto, nouser, and async."
25401 #. type: Labeled list
25402 #: ../sys-utils/fstab.5.adoc:105 ../sys-utils/mount.8.adoc:517
25407 #. type: Plain text
25408 #: ../sys-utils/fstab.5.adoc:107
25409 msgid "do not mount when *mount -a* is given (e.g., at boot time)"
25410 msgstr "nepřipojovat, je-li voláno *mount -a* (například při startu systému)"
25412 #. type: Labeled list
25413 #: ../sys-utils/fstab.5.adoc:107 ../sys-utils/mount.8.adoc:675
25418 #. type: Plain text
25419 #: ../sys-utils/fstab.5.adoc:109
25420 msgid "allow a user to mount"
25421 msgstr "dovolí připojení běžným uživatelem"
25423 #. type: Labeled list
25424 #: ../sys-utils/fstab.5.adoc:109 ../sys-utils/mount.8.adoc:632
25429 #. type: Plain text
25430 #: ../sys-utils/fstab.5.adoc:111
25431 msgid "allow device owner to mount"
25432 msgstr "dovolí připojení vlastníkem zařízení"
25434 #. type: Labeled list
25435 #: ../sys-utils/fstab.5.adoc:111
25440 #. type: Plain text
25441 #: ../sys-utils/fstab.5.adoc:113
25442 msgid "or *x-<name>* for use by fstab-maintaining programs"
25443 msgstr "nebo *x-<název>* pro použití programy spravujícími fstab"
25445 #. type: Labeled list
25446 #: ../sys-utils/fstab.5.adoc:113 ../sys-utils/mount.8.adoc:588
25451 #. type: Plain text
25452 #: ../sys-utils/fstab.5.adoc:115
25453 msgid "do not report errors for this device if it does not exist."
25454 msgstr "nehlásí chyby k tomuto zařízení, pokud toto zařízení neexistuje."
25457 #: ../sys-utils/fstab.5.adoc:116
25459 msgid "The fifth field (_fs_freq_)."
25460 msgstr "Pátá položka (_fs_freq_)."
25462 #. type: Plain text
25463 #: ../sys-utils/fstab.5.adoc:119
25465 "This field is used by *dump*(8) to determine which filesystems need to be "
25466 "dumped. Defaults to zero (don't dump) if not present."
25468 "Tyto položku používá program *dump*(8), aby zjistil, který souborový systém "
25469 "má být zálohován. Pokud není uvedeno, výchozí hodnota je 0 (nezálohovat)."
25472 #: ../sys-utils/fstab.5.adoc:120
25474 msgid "The sixth field (_fs_passno_)."
25475 msgstr "Šestá položka (_fs_passno_)."
25477 #. type: Plain text
25478 #: ../sys-utils/fstab.5.adoc:123
25480 "This field is used by *fsck*(8) to determine the order in which filesystem "
25481 "checks are done at boot time. The root filesystem should be specified with a "
25482 "_fs_passno_ of 1. Other filesystems should have a _fs_passno_ of 2. "
25483 "Filesystems within a drive will be checked sequentially, but filesystems on "
25484 "different drives will be checked at the same time to utilize parallelism "
25485 "available in the hardware. Defaults to zero (don't check the filesystem) if "
25488 "Tuto položku používá program *fsck(8)* pro určení pořadí kontroly "
25489 "souborových systému při startu. Kořenový souborový systém by měl mít hodnotu "
25490 "_fs_passno_ rovnu 1, ostatní souborové systémy pak hodnotu _fs_passno rovnu "
25491 "2. Souborové systémy v rámci jedné diskové jednotky jsou kontrolovány "
25492 "postupně, nicméně systémy na různých jednotkách jsou kontrolovány najednou, "
25493 "aby se využil paralelismus stroje. Není-li hodnota uvedena, výchozí je nula "
25494 "(tzn. kontrola nebude provedena)."
25496 #. type: Plain text
25497 #: ../sys-utils/fstab.5.adoc:128
25498 msgid "_/etc/fstab_, _<fstab.h>_"
25499 msgstr "_/etc/fstab_, _<fstab.h>_"
25501 #. type: Plain text
25502 #: ../sys-utils/fstab.5.adoc:132
25504 "The proper way to read records from *fstab* is to use the routines "
25505 "*getmntent*(3) or *libmount*."
25507 "Správná metoda jak číst v programu *fstab* je použít proceduru "
25508 "*getmntent*(3) nebo *libmount*."
25510 #. type: Plain text
25511 #: ../sys-utils/fstab.5.adoc:134
25513 "The keyword *ignore* as a filesystem type (3rd field) is no longer supported "
25514 "by the pure libmount based mount utility (since util-linux v2.22)."
25516 "Klíčové slovo *ignore* použité jako druh souborového systému (3. položka) "
25517 "již není podporováno nástrojem mount, který je postaven čistě na knihovně "
25518 "libmount (util-linux od verze 2.22)."
25520 #. type: Plain text
25521 #: ../sys-utils/fstab.5.adoc:138
25522 msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
25523 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
25525 #. type: Plain text
25526 #: ../sys-utils/fstab.5.adoc:146
25529 "*getmntent*(3),\n"
25535 "*getmntent*(3),\n"
25542 #: ../sys-utils/fstrim.8.adoc:2
25547 #. type: Plain text
25548 #: ../sys-utils/fstrim.8.adoc:12
25549 msgid "fstrim - discard unused blocks on a mounted filesystem"
25552 #. type: Plain text
25553 #: ../sys-utils/fstrim.8.adoc:16
25555 msgid "*fstrim* [*-Aav*] [*-o* _offset_] [*-l* _length_] [*-m* _minimum-size_] [_mountpoint_]\n"
25558 #. type: Plain text
25559 #: ../sys-utils/fstrim.8.adoc:20
25561 msgid "*fstrim* is used on a mounted filesystem to discard (or \"trim\") blocks which are not in use by the filesystem. This is useful for solid-state drives (SSDs) and thinly-provisioned storage.\n"
25564 #. type: Plain text
25565 #: ../sys-utils/fstrim.8.adoc:22
25567 "By default, *fstrim* will discard all unused blocks in the filesystem. "
25568 "Options may be used to modify this behavior based on range or size, as "
25572 #. type: Plain text
25573 #: ../sys-utils/fstrim.8.adoc:24
25575 "The _mountpoint_ argument is the pathname of the directory where the "
25576 "filesystem is mounted and is required when *_-A_*, *_-a_*, *_--fstab_*, or "
25577 "*_--all_* are unspecified."
25580 #. type: Plain text
25581 #: ../sys-utils/fstrim.8.adoc:26
25583 "Running *fstrim* frequently, or even using *mount -o discard*, might "
25584 "negatively affect the lifetime of poor-quality SSD devices. For most desktop "
25585 "and server systems a sufficient trimming frequency is once a week. Note that "
25586 "not all devices support a queued trim, so each trim command incurs a "
25587 "performance penalty on whatever else might be trying to use the disk at the "
25591 #. type: Plain text
25592 #: ../sys-utils/fstrim.8.adoc:30
25594 "The _offset_, _length_, and _minimum-size_ arguments may be followed by the "
25595 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
25596 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
25597 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
25598 "for GB, TB, PB, EB, ZB and YB."
25601 #. type: Labeled list
25602 #: ../sys-utils/fstrim.8.adoc:31
25604 msgid "*-A, --fstab*"
25607 #. type: Plain text
25608 #: ../sys-utils/fstrim.8.adoc:33
25610 "Trim all mounted filesystems mentioned in _/etc/fstab_ on devices that "
25611 "support the discard operation. The root filesystem is determined from kernel "
25612 "command line if missing in the file. The other supplied options, like *--"
25613 "offset*, *--length* and *--minimum*, are applied to all these devices. "
25614 "Errors from filesystems that do not support the discard operation, read-only "
25615 "devices, autofs and read-only filesystems are silently ignored. Filesystems "
25616 "with \"X-fstrim.notrim\" mount option are skipped."
25619 #. type: Labeled list
25620 #: ../sys-utils/fstrim.8.adoc:34
25622 msgid "*-a, --all*"
25625 #. type: Plain text
25626 #: ../sys-utils/fstrim.8.adoc:36
25628 "Trim all mounted filesystems on devices that support the discard operation. "
25629 "The other supplied options, like *--offset*, *--length* and *--minimum*, are "
25630 "applied to all these devices. Errors from filesystems that do not support "
25631 "the discard operation, read-only devices and read-only filesystems are "
25632 "silently ignored."
25635 #. type: Labeled list
25636 #: ../sys-utils/fstrim.8.adoc:37
25638 msgid "*-n, --dry-run*"
25641 #. type: Plain text
25642 #: ../sys-utils/fstrim.8.adoc:39
25643 msgid "This option does everything apart from actually call *FITRIM* ioctl."
25646 #. type: Labeled list
25647 #: ../sys-utils/fstrim.8.adoc:40
25649 msgid "*-o, --offset* _offset_"
25652 #. type: Plain text
25653 #: ../sys-utils/fstrim.8.adoc:42
25655 "Byte offset in the filesystem from which to begin searching for free blocks "
25656 "to discard. The default value is zero, starting at the beginning of the "
25660 #. type: Labeled list
25661 #: ../sys-utils/fstrim.8.adoc:43
25663 msgid "*-l, --length* _length_"
25666 #. type: Plain text
25667 #: ../sys-utils/fstrim.8.adoc:45
25669 "The number of bytes (after the starting point) to search for free blocks to "
25670 "discard. If the specified value extends past the end of the filesystem, "
25671 "*fstrim* will stop at the filesystem size boundary. The default value "
25672 "extends to the end of the filesystem."
25675 #. type: Labeled list
25676 #: ../sys-utils/fstrim.8.adoc:46
25678 #| msgid "*-w*, **--whitelist-environment**=__list__"
25679 msgid "*-I, --listed-in* _list_"
25680 msgstr "*-w*, **--whitelist-environment**=__seznam__"
25682 #. type: Plain text
25683 #: ../sys-utils/fstrim.8.adoc:48
25685 "Specifies a colon-separated list of files in fstab or kernel mountinfo "
25686 "format. All missing or empty files are silently ignored. The evaluation of "
25687 "the _list_ stops after first non-empty file. For example:"
25690 #. type: Plain text
25691 #: ../sys-utils/fstrim.8.adoc:50
25693 msgid "*--listed-in /etc/fstab:/proc/self/mountinfo*.\n"
25696 #. type: Plain text
25697 #: ../sys-utils/fstrim.8.adoc:52
25698 msgid "Filesystems with \"X-fstrim.notrim\" mount option in fstab are skipped."
25701 #. type: Labeled list
25702 #: ../sys-utils/fstrim.8.adoc:53
25704 msgid "*-m, --minimum* _minimum-size_"
25707 #. type: Plain text
25708 #: ../sys-utils/fstrim.8.adoc:55
25710 "Minimum contiguous free range to discard, in bytes. (This value is "
25711 "internally rounded up to a multiple of the filesystem block size.) Free "
25712 "ranges smaller than this will be ignored and *fstrim* will adjust the "
25713 "minimum if it's smaller than the device's minimum, and report that "
25714 "(fstrim_range.minlen) back to userspace. By increasing this value, the "
25715 "*fstrim* operation will complete more quickly for filesystems with badly "
25716 "fragmented freespace, although not all blocks will be discarded. The default "
25717 "value is zero, discarding every free block."
25720 #. type: Plain text
25721 #: ../sys-utils/fstrim.8.adoc:63
25723 "Specifies allowed or forbidden filesystem types when used with *--all* or *--"
25724 "fstab*. The _list_ is a comma-separated list of the filesystem names. The "
25725 "_list_ follows how *mount -t* evaluates type patterns. Only specified "
25726 "filesystem types are allowed. All specified types are forbidden if the list "
25727 "is prefixed by \"no\" or each filesystem prefixed by \"no\" is forbidden. If "
25728 "the option is not used, then all filesystems (except \"autofs\") are allowed."
25731 #. type: Labeled list
25732 #: ../sys-utils/fstrim.8.adoc:64
25734 #| msgid "*-V*, *--version*"
25735 msgid "*-v, --verbose*"
25736 msgstr "*-V*, *--version*"
25738 #. type: Plain text
25739 #: ../sys-utils/fstrim.8.adoc:66
25741 "Verbose execution. With this option *fstrim* will output the number of bytes "
25742 "passed from the filesystem down the block stack to the device for potential "
25743 "discard. This number is a maximum discard amount from the storage device's "
25744 "perspective, because _FITRIM_ ioctl called repeated will keep sending the "
25745 "same sectors for discard repeatedly."
25748 #. type: Plain text
25749 #: ../sys-utils/fstrim.8.adoc:68
25751 msgid "*fstrim* will report the same potential discard bytes each time, but only sectors which had been written to between the discards would actually be discarded by the storage device. Further, the kernel block layer reserves the right to adjust the discard ranges to fit raid stripe geometry, non-trim capable devices in a LVM setup, etc. These reductions would not be reflected in fstrim_range.len (the *--length* option).\n"
25754 #. type: Labeled list
25755 #: ../sys-utils/fstrim.8.adoc:69
25757 msgid "*--quiet-unsupported*"
25760 #. type: Plain text
25761 #: ../sys-utils/fstrim.8.adoc:71
25763 "Suppress error messages if trim operation (ioctl) is unsupported. This "
25764 "option is meant to be used in *systemd* service file or in *cron*(8) scripts "
25765 "to hide warnings that are result of known problems, such as NTFS driver "
25766 "reporting _Bad file descriptor_ when device is mounted read-only, or lack of "
25767 "file system support for ioctl _FITRIM_ call. This option also cleans exit "
25768 "status when unsupported filesystem specified on *fstrim* command line."
25771 #. type: Plain text
25772 #: ../sys-utils/fstrim.8.adoc:84
25773 msgid "some filesystem discards have succeeded, some failed"
25776 #. type: Plain text
25777 #: ../sys-utils/fstrim.8.adoc:86
25779 "The command *fstrim --all* returns 0 (all succeeded), 32 (all failed) or 64 "
25780 "(some failed, some succeeded)."
25783 #. type: Plain text
25784 #: ../sys-utils/fstrim.8.adoc:95
25787 "*blkdiscard*(8),\n"
25792 #. hwclock.8 -- man page for util-linux' hwclock
25793 #. 2015-01-07 J William Piggott
25794 #. Authored new section: DATE-TIME CONFIGURATION.
25795 #. Subsections: Keeping Time..., LOCAL vs UTC, POSIX vs 'RIGHT'.
25797 #: ../sys-utils/hwclock.8.adoc:9
25802 #. type: Plain text
25803 #: ../sys-utils/hwclock.8.adoc:20
25804 msgid "hwclock - time clocks utility"
25807 #. type: Plain text
25808 #: ../sys-utils/hwclock.8.adoc:24
25810 msgid "*hwclock* [_function_] [_option_...]\n"
25813 #. type: Plain text
25814 #: ../sys-utils/hwclock.8.adoc:28
25816 msgid "*hwclock* is an administration tool for the time clocks. It can: display the Hardware Clock time; set the Hardware Clock to a specified time; set the Hardware Clock from the System Clock; set the System Clock from the Hardware Clock; compensate for Hardware Clock drift; correct the System Clock timescale; set the kernel's timezone, NTP timescale, and epoch (Alpha only); and predict future Hardware Clock values based on its drift rate.\n"
25819 #. type: Plain text
25820 #: ../sys-utils/hwclock.8.adoc:30
25822 "Since v2.26 important changes were made to the *--hctosys* function and the "
25823 "*--directisa* option, and a new option *--update-drift* was added. See their "
25824 "respective descriptions below."
25828 #: ../sys-utils/hwclock.8.adoc:31
25834 #. type: Plain text
25835 #: ../sys-utils/hwclock.8.adoc:34
25837 "The following functions are mutually exclusive, only one can be given at a "
25838 "time. If none is given, the default is *--show*."
25841 #. type: Labeled list
25842 #: ../sys-utils/hwclock.8.adoc:35
25844 msgid "*-a, --adjust*"
25847 #. type: Plain text
25848 #: ../sys-utils/hwclock.8.adoc:37
25850 "Add or subtract time from the Hardware Clock to account for systematic drift "
25851 "since the last time the clock was set or adjusted. See the discussion below, "
25852 "under *The Adjust Function*."
25855 #. type: Labeled list
25856 #: ../sys-utils/hwclock.8.adoc:38
25858 msgid "*--getepoch*; *--setepoch*"
25861 #. type: Plain text
25862 #: ../sys-utils/hwclock.8.adoc:40
25864 "These functions are for Alpha machines only, and are only available through "
25865 "the Linux kernel RTC driver."
25868 #. type: Plain text
25869 #: ../sys-utils/hwclock.8.adoc:42
25871 "They are used to read and set the kernel's Hardware Clock epoch value. Epoch "
25872 "is the number of years into AD to which a zero year value in the Hardware "
25873 "Clock refers. For example, if the machine's BIOS sets the year counter in "
25874 "the Hardware Clock to contain the number of full years since 1952, then the "
25875 "kernel's Hardware Clock epoch value must be 1952."
25878 #. type: Plain text
25879 #: ../sys-utils/hwclock.8.adoc:44
25881 "The *--setepoch* function requires using the *--epoch* option to specify the "
25882 "year. For example:"
25885 #. type: Plain text
25886 #: ../sys-utils/hwclock.8.adoc:46
25888 msgid "**hwclock --setepoch --epoch=1952**\n"
25891 #. type: Plain text
25892 #: ../sys-utils/hwclock.8.adoc:48
25894 "The RTC driver attempts to guess the correct epoch value, so setting it may "
25898 #. type: Plain text
25899 #: ../sys-utils/hwclock.8.adoc:50
25901 "This epoch value is used whenever *hwclock* reads or sets the Hardware Clock "
25902 "on an Alpha machine. For ISA machines the kernel uses the fixed Hardware "
25903 "Clock epoch of 1900."
25906 #. type: Labeled list
25907 #: ../sys-utils/hwclock.8.adoc:51
25909 msgid "**--param-get=**__parameter__; **--param-set=**__parameter__=__value__"
25912 #. type: Plain text
25913 #: ../sys-utils/hwclock.8.adoc:53
25915 "Read and set the RTC's parameter. This is useful, for example, to retrieve "
25916 "the RTC's feature or set the RTC's Backup Switchover Mode."
25919 #. type: Plain text
25920 #: ../sys-utils/hwclock.8.adoc:55
25922 "_parameter_ is either a numeric RTC parameter value (see the Kernel's "
25923 "_include/uapi/linux/rtc.h_) or an alias. See *--help* for a list of valid "
25924 "aliases. _parameter_ and _value_, if prefixed with 0x, are interpreted as "
25925 "hexadecimal, otherwise decimal values."
25928 #. type: Labeled list
25929 #: ../sys-utils/hwclock.8.adoc:56
25931 msgid "*--predict*"
25934 #. type: Plain text
25935 #: ../sys-utils/hwclock.8.adoc:58
25937 "Predict what the Hardware Clock will read in the future based upon the time "
25938 "given by the *--date* option and the information in _{ADJTIME_PATH}_. This "
25939 "is useful, for example, to account for drift when setting a Hardware Clock "
25940 "wakeup (aka alarm). See *rtcwake*(8)."
25943 #. type: Plain text
25944 #: ../sys-utils/hwclock.8.adoc:60
25946 "Do not use this function if the Hardware Clock is being modified by anything "
25947 "other than the current operating system's *hwclock* command, such as '11 "
25948 "minute mode' or from dual-booting another OS."
25951 #. type: Labeled list
25952 #: ../sys-utils/hwclock.8.adoc:61
25954 #| msgid "*-*, *-l*, *--login*"
25955 msgid "*-r*, *--show*; *--get*"
25956 msgstr "*-*, *-l*, *--login*"
25958 #. type: Plain text
25959 #: ../sys-utils/hwclock.8.adoc:63
25961 "Read the Hardware Clock and print its time to standard output in the *ISO "
25962 "8601* format. The time shown is always in local time, even if you keep your "
25963 "Hardware Clock in UTC. See the *--localtime* option."
25966 #. type: Plain text
25967 #: ../sys-utils/hwclock.8.adoc:65
25969 "Showing the Hardware Clock time is the default when no function is specified."
25972 #. type: Plain text
25973 #: ../sys-utils/hwclock.8.adoc:67
25975 "The *--get* function also applies drift correction to the time read, based "
25976 "upon the information in _{ADJTIME_PATH}_. Do not use this function if the "
25977 "Hardware Clock is being modified by anything other than the current "
25978 "operating system's *hwclock* command, such as '11 minute mode' or from dual-"
25979 "booting another OS."
25982 #. type: Labeled list
25983 #: ../sys-utils/hwclock.8.adoc:68
25985 #| msgid "*-P*, *--pty*"
25986 msgid "*-s*, *--hctosys*"
25987 msgstr "*-P*, *--pty*"
25989 #. type: Plain text
25990 #: ../sys-utils/hwclock.8.adoc:70
25992 "Set the System Clock from the Hardware Clock. The time read from the "
25993 "Hardware Clock is compensated to account for systematic drift before using "
25994 "it to set the System Clock. See the discussion below, under *The Adjust "
25998 #. type: Plain text
25999 #: ../sys-utils/hwclock.8.adoc:72
26001 "The System Clock must be kept in the UTC timescale for date-time "
26002 "applications to work correctly in conjunction with the timezone configured "
26003 "for the system. If the Hardware Clock is kept in local time then the time "
26004 "read from it must be shifted to the UTC timescale before using it to set the "
26005 "System Clock. The *--hctosys* function does this based upon the information "
26006 "in the _{ADJTIME_PATH}_ file or the command line arguments *--localtime* and "
26007 "*--utc*. Note: no daylight saving adjustment is made. See the discussion "
26008 "below, under *LOCAL vs UTC*."
26011 #. type: Plain text
26012 #: ../sys-utils/hwclock.8.adoc:74
26014 "The kernel also keeps a timezone value, the *--hctosys* function sets it to "
26015 "the timezone configured for the system. The system timezone is configured by "
26016 "the *TZ* environment variable or the _/etc/localtime_ file, as *tzset*(3) "
26017 "would interpret them. The obsolete _tz_dsttime_ field of the kernel's "
26018 "timezone value is set to zero. (For details on what this field used to mean, "
26019 "see *settimeofday*(2).)"
26022 #. type: Plain text
26023 #: ../sys-utils/hwclock.8.adoc:76
26025 "When used in a startup script, making the *--hctosys* function the first "
26026 "caller of *settimeofday*(2) from boot, it will set the NTP '11 minute mode' "
26027 "timescale via the _persistent_clock_is_local_ kernel variable. If the "
26028 "Hardware Clock's timescale configuration is changed then a reboot is "
26029 "required to inform the kernel. See the discussion below, under *Automatic "
26030 "Hardware Clock Synchronization by the Kernel*."
26033 #. type: Plain text
26034 #: ../sys-utils/hwclock.8.adoc:78
26036 "This is a good function to use in one of the system startup scripts before "
26037 "the file systems are mounted read/write."
26040 #. type: Plain text
26041 #: ../sys-utils/hwclock.8.adoc:80
26043 "This function should never be used on a running system. Jumping system time "
26044 "will cause problems, such as corrupted filesystem timestamps. Also, if "
26045 "something has changed the Hardware Clock, like NTP's '11 minute mode', then "
26046 "*--hctosys* will set the time incorrectly by including drift compensation."
26049 #. type: Plain text
26050 #: ../sys-utils/hwclock.8.adoc:82
26052 "Drift compensation can be inhibited by setting the drift factor in "
26053 "_{ADJTIME_PATH}_ to zero. This setting will be persistent as long as the *--"
26054 "update-drift* option is not used with *--systohc* at shutdown (or anywhere "
26055 "else). Another way to inhibit this is by using the *--noadjfile* option when "
26056 "calling the *--hctosys* function. A third method is to delete the "
26057 "_{ADJTIME_PATH}_ file. *Hwclock* will then default to using the UTC "
26058 "timescale for the Hardware Clock. If the Hardware Clock is ticking local "
26059 "time it will need to be defined in the file. This can be done by calling "
26060 "*hwclock --localtime --adjust*; when the file is not present this command "
26061 "will not actually adjust the Clock, but it will create the file with local "
26062 "time configured, and a drift factor of zero."
26065 #. type: Plain text
26066 #: ../sys-utils/hwclock.8.adoc:84
26068 "A condition under which inhibiting *hwclock*'s drift correction may be "
26069 "desired is when dual-booting multiple operating systems. If while this "
26070 "instance of Linux is stopped, another OS changes the Hardware Clock's value, "
26071 "then when this instance is started again the drift correction applied will "
26075 #. type: Plain text
26076 #: ../sys-utils/hwclock.8.adoc:86
26078 "For *hwclock*'s drift correction to work properly it is imperative that "
26079 "nothing changes the Hardware Clock while its Linux instance is not running."
26082 #. type: Labeled list
26083 #: ../sys-utils/hwclock.8.adoc:87
26088 #. type: Plain text
26089 #: ../sys-utils/hwclock.8.adoc:89
26091 "Set the Hardware Clock to the time given by the *--date* option, and update "
26092 "the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also "
26093 "(re)calculate the drift factor. Try it without the option if *--set* fails. "
26094 "See *--update-drift* below."
26097 #. type: Labeled list
26098 #: ../sys-utils/hwclock.8.adoc:90
26103 #. type: Plain text
26104 #: ../sys-utils/hwclock.8.adoc:92
26106 "This is an alternate to the *--hctosys* function that does not read the "
26107 "Hardware Clock nor set the System Clock; consequently there is not any drift "
26108 "correction. It is intended to be used in a startup script on systems with "
26109 "kernels above version 2.6 where you know the System Clock has been set from "
26110 "the Hardware Clock by the kernel during boot."
26113 #. type: Plain text
26114 #: ../sys-utils/hwclock.8.adoc:94
26116 "It does the following things that are detailed above in the *--hctosys* "
26120 #. type: Plain text
26121 #: ../sys-utils/hwclock.8.adoc:96
26123 "Corrects the System Clock timescale to UTC as needed. Only instead of "
26124 "accomplishing this by setting the System Clock, *hwclock* simply informs the "
26125 "kernel and it handles the change."
26128 #. type: Plain text
26129 #: ../sys-utils/hwclock.8.adoc:97
26130 msgid "Sets the kernel's NTP '11 minute mode' timescale."
26133 #. type: Plain text
26134 #: ../sys-utils/hwclock.8.adoc:98
26135 msgid "Sets the kernel's timezone."
26138 #. type: Plain text
26139 #: ../sys-utils/hwclock.8.adoc:100
26141 "The first two are only available on the first call of *settimeofday*(2) "
26142 "after boot. Consequently this option only makes sense when used in a startup "
26143 "script. If the Hardware Clocks timescale configuration is changed then a "
26144 "reboot would be required to inform the kernel."
26147 #. type: Labeled list
26148 #: ../sys-utils/hwclock.8.adoc:101
26150 #| msgid "*-f*, *--fast*"
26151 msgid "*-w*, *--systohc*"
26152 msgstr "*-f*, *--fast*"
26154 #. type: Plain text
26155 #: ../sys-utils/hwclock.8.adoc:103
26157 "Set the Hardware Clock from the System Clock, and update the timestamps in "
26158 "_{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the "
26159 "drift factor. Try it without the option if *--systohc* fails. See *--update-"
26163 #. type: Labeled list
26164 #: ../sys-utils/hwclock.8.adoc:104
26166 #| msgid "*-h*, *--help*"
26167 msgid "*--vl-read*, *--vl-clear*"
26168 msgstr "*-h*, *--help*"
26170 #. type: Plain text
26171 #: ../sys-utils/hwclock.8.adoc:106
26173 "Some RTC devices are able to monitor the voltage of the backup battery and "
26174 "thus provide a way for the user to know that the battery should be replaced. "
26175 "The *--vl-read* function retrieves the Voltage Low information and decodes "
26176 "the result into human-readable form. The *--vl-clear* function resets the "
26177 "Voltage Low information, which is necessary for some RTC devices after a "
26178 "battery replacement."
26181 #. type: Plain text
26182 #: ../sys-utils/hwclock.8.adoc:108
26184 "See the Kernel's _include/uapi/linux/rtc.h_ for details on which pieces of "
26185 "information may be returned. Note that not all RTC devices have this "
26186 "monitoring capability, nor do all drivers necessarily support reading the "
26190 #. type: Labeled list
26191 #: ../sys-utils/hwclock.8.adoc:113
26193 msgid "**--adjfile=**__filename__"
26196 #. type: Plain text
26197 #: ../sys-utils/hwclock.8.adoc:115
26198 msgid "Override the default _{ADJTIME_PATH}_ file path."
26201 #. type: Labeled list
26202 #: ../sys-utils/hwclock.8.adoc:116
26204 msgid "**--date=**__date_string__"
26207 #. type: Plain text
26208 #: ../sys-utils/hwclock.8.adoc:118
26210 "This option must be used with the *--set* or *--predict* functions, "
26211 "otherwise it is ignored."
26214 #. type: Plain text
26215 #: ../sys-utils/hwclock.8.adoc:120
26217 msgid "*hwclock --set --date='16:45'*\n"
26220 #. type: Plain text
26221 #: ../sys-utils/hwclock.8.adoc:122
26223 msgid "*hwclock --predict --date='2525-08-14 07:11:05'*\n"
26226 #. type: Plain text
26227 #: ../sys-utils/hwclock.8.adoc:124
26229 "The argument must be in local time, even if you keep your Hardware Clock in "
26230 "UTC. See the *--localtime* option. Therefore, the argument should not "
26231 "include any timezone information. It also should not be a relative time like "
26232 "\"+5 minutes\", because *hwclock*'s precision depends upon correlation "
26233 "between the argument's value and when the enter key is pressed. Fractional "
26234 "seconds are silently dropped. This option is capable of understanding many "
26235 "time and date formats, but the previous parameters should be observed."
26238 #. type: Labeled list
26239 #: ../sys-utils/hwclock.8.adoc:125
26241 #| msgid "**--session-command=**__command__"
26242 msgid "**--delay=**__seconds__"
26243 msgstr "**--session-command=**__příkaz__"
26245 #. type: Plain text
26246 #: ../sys-utils/hwclock.8.adoc:127
26248 "This option can be used to overwrite the internally used delay when setting "
26249 "the clock time. The default is 0.5 (500ms) for rtc_cmos, for another RTC "
26250 "types the delay is 0. If RTC type is impossible to determine (from sysfs) "
26251 "then it defaults also to 0.5 to be backwardly compatible."
26254 #. type: Plain text
26255 #: ../sys-utils/hwclock.8.adoc:129
26257 "The 500ms default is based on commonly used MC146818A-compatible (x86) "
26258 "hardware clock. This Hardware Clock can only be set to any integer time plus "
26259 "one half second. The integer time is required because there is no interface "
26260 "to set or get a fractional second. The additional half second delay is "
26261 "because the Hardware Clock updates to the following second precisely 500 ms "
26262 "after setting the new time. Unfortunately, this behavior is hardware "
26263 "specific and in some cases another delay is required."
26266 #. type: Labeled list
26267 #: ../sys-utils/hwclock.8.adoc:130
26269 #| msgid "*-h*, *--help*"
26270 msgid "*-D*, *--debug*"
26271 msgstr "*-h*, *--help*"
26273 #. type: Plain text
26274 #: ../sys-utils/hwclock.8.adoc:132
26276 "Use *--verbose*. The *--debug* option has been deprecated and may be "
26277 "repurposed or removed in a future release."
26280 #. type: Labeled list
26281 #: ../sys-utils/hwclock.8.adoc:133
26283 msgid "*--directisa*"
26286 #. type: Plain text
26287 #: ../sys-utils/hwclock.8.adoc:135
26289 "This option is meaningful for ISA compatible machines in the x86 and x86_64 "
26290 "family. For other machines, it has no effect. This option tells *hwclock* to "
26291 "use explicit I/O instructions to access the Hardware Clock. Without this "
26292 "option, *hwclock* will use the rtc device file, which it assumes to be "
26293 "driven by the Linux RTC device driver. As of v2.26 it will no longer "
26294 "automatically use directisa when the rtc driver is unavailable; this was "
26295 "causing an unsafe condition that could allow two processes to access the "
26296 "Hardware Clock at the same time. Direct hardware access from userspace "
26297 "should only be used for testing, troubleshooting, and as a last resort when "
26298 "all other methods fail. See the *--rtc* option."
26301 #. type: Labeled list
26302 #: ../sys-utils/hwclock.8.adoc:136
26304 msgid "**--epoch=**__year__"
26307 #. type: Plain text
26308 #: ../sys-utils/hwclock.8.adoc:138
26310 "This option is required when using the *--setepoch* function. The minimum "
26311 "_year_ value is 1900. The maximum is system dependent (*ULONG_MAX - 1*)."
26314 #. type: Labeled list
26315 #: ../sys-utils/hwclock.8.adoc:139
26317 msgid "*-f*, **--rtc=**__filename__"
26320 #. type: Plain text
26321 #: ../sys-utils/hwclock.8.adoc:141
26323 "Override *hwclock*'s default rtc device file name. Otherwise it will use the "
26324 "first one found in this order: _/dev/rtc0_, _/dev/rtc_, _/dev/misc/rtc_. For "
26325 "*IA-64:* _/dev/efirtc_ _/dev/misc/efirtc_"
26328 #. type: Labeled list
26329 #: ../sys-utils/hwclock.8.adoc:142
26331 msgid "*-l*, *--localtime*; *-u*, *--utc*"
26334 #. type: Plain text
26335 #: ../sys-utils/hwclock.8.adoc:144
26336 msgid "Indicate which timescale the Hardware Clock is set to."
26339 #. type: Plain text
26340 #: ../sys-utils/hwclock.8.adoc:146
26342 "The Hardware Clock may be configured to use either the UTC or the local "
26343 "timescale, but nothing in the clock itself says which alternative is being "
26344 "used. The *--localtime* or *--utc* options give this information to the "
26345 "*hwclock* command. If you specify the wrong one (or specify neither and take "
26346 "a wrong default), both setting and reading the Hardware Clock will be "
26350 #. type: Plain text
26351 #: ../sys-utils/hwclock.8.adoc:148
26353 "If you specify neither *--utc* nor *--localtime* then the one last given "
26354 "with a set function (*--set*, *--systohc*, or *--adjust*), as recorded in "
26355 "_{ADJTIME_PATH}_, will be used. If the adjtime file doesn't exist, the "
26359 #. type: Plain text
26360 #: ../sys-utils/hwclock.8.adoc:150
26362 "Note: daylight saving time changes may be inconsistent when the Hardware "
26363 "Clock is kept in local time. See the discussion below, under *LOCAL vs UTC*."
26366 #. type: Labeled list
26367 #: ../sys-utils/hwclock.8.adoc:151
26369 msgid "*--noadjfile*"
26372 #. type: Plain text
26373 #: ../sys-utils/hwclock.8.adoc:153
26375 "Disable the facilities provided by _{ADJTIME_PATH}_. *hwclock* will not read "
26376 "nor write to that file with this option. Either *--utc* or *--localtime* "
26377 "must be specified when using this option."
26380 #. type: Labeled list
26381 #: ../sys-utils/hwclock.8.adoc:154
26386 #. type: Plain text
26387 #: ../sys-utils/hwclock.8.adoc:156
26389 "Do not actually change anything on the system, that is, the Clocks or "
26390 "_{ADJTIME_PATH}_ (*--verbose* is implicit with this option)."
26393 #. type: Labeled list
26394 #: ../sys-utils/hwclock.8.adoc:157
26396 msgid "*--update-drift*"
26399 #. type: Plain text
26400 #: ../sys-utils/hwclock.8.adoc:159
26402 "Update the Hardware Clock's drift factor in _{ADJTIME_PATH}_. It can only be "
26403 "used with *--set* or *--systohc*."
26406 #. type: Plain text
26407 #: ../sys-utils/hwclock.8.adoc:161
26409 "A minimum four hour period between settings is required. This is to avoid "
26410 "invalid calculations. The longer the period, the more precise the resulting "
26411 "drift factor will be."
26414 #. type: Plain text
26415 #: ../sys-utils/hwclock.8.adoc:163
26417 "This option was added in v2.26, because it is typical for systems to call "
26418 "*hwclock --systohc* at shutdown; with the old behavior this would "
26419 "automatically (re)calculate the drift factor which caused several problems:"
26422 #. type: Plain text
26423 #: ../sys-utils/hwclock.8.adoc:165
26425 "When using NTP with an '11 minute mode' kernel the drift factor would be "
26426 "clobbered to near zero."
26429 #. type: Plain text
26430 #: ../sys-utils/hwclock.8.adoc:166
26432 "It would not allow the use of 'cold' drift correction. With most "
26433 "configurations using 'cold' drift will yield favorable results. Cold, means "
26434 "when the machine is turned off which can have a significant impact on the "
26438 #. type: Plain text
26439 #: ../sys-utils/hwclock.8.adoc:167
26441 "(Re)calculating drift factor on every shutdown delivers suboptimal results. "
26442 "For example, if ephemeral conditions cause the machine to be abnormally hot "
26443 "the drift factor calculation would be out of range."
26446 #. type: Plain text
26447 #: ../sys-utils/hwclock.8.adoc:168
26449 "Significantly increased system shutdown times (as of v2.31 when not using *--"
26450 "update-drift* the RTC is not read)."
26453 #. type: Plain text
26454 #: ../sys-utils/hwclock.8.adoc:170
26456 "Having *hwclock* calculate the drift factor is a good starting point, but "
26457 "for optimal results it will likely need to be adjusted by directly editing "
26458 "the _{ADJTIME_PATH}_ file. For most configurations once a machine's optimal "
26459 "drift factor is crafted it should not need to be changed. Therefore, the old "
26460 "behavior to automatically (re)calculate drift was changed and now requires "
26461 "this option to be used. See the discussion below, under *The Adjust "
26465 #. type: Plain text
26466 #: ../sys-utils/hwclock.8.adoc:172
26468 "This option requires reading the Hardware Clock before setting it. If it "
26469 "cannot be read, then this option will cause the set functions to fail. This "
26470 "can happen, for example, if the Hardware Clock is corrupted by a power "
26471 "failure. In that case, the clock must first be set without this option. "
26472 "Despite it not working, the resulting drift correction factor would be "
26476 #. type: Plain text
26477 #: ../sys-utils/hwclock.8.adoc:175
26478 msgid "Display more details about what *hwclock* is doing internally."
26482 #: ../sys-utils/hwclock.8.adoc:178
26484 msgid "Clocks in a Linux System"
26487 #. type: Plain text
26488 #: ../sys-utils/hwclock.8.adoc:181
26489 msgid "There are two types of date-time clocks:"
26492 #. type: Plain text
26493 #: ../sys-utils/hwclock.8.adoc:183
26495 msgid "*The Hardware Clock:* This clock is an independent hardware device, with its own power domain (battery, capacitor, etc), that operates when the machine is powered off, or even unplugged.\n"
26498 #. type: Plain text
26499 #: ../sys-utils/hwclock.8.adoc:185
26501 "On an ISA compatible system, this clock is specified as part of the ISA "
26502 "standard. A control program can read or set this clock only to a whole "
26503 "second, but it can also detect the edges of the 1 second clock ticks, so the "
26504 "clock actually has virtually infinite precision."
26507 #. type: Plain text
26508 #: ../sys-utils/hwclock.8.adoc:187
26510 "This clock is commonly called the hardware clock, the real time clock, the "
26511 "RTC, the BIOS clock, and the CMOS clock. Hardware Clock, in its capitalized "
26512 "form, was coined for use by *hwclock*. The Linux kernel also refers to it as "
26513 "the persistent clock."
26516 #. type: Plain text
26517 #: ../sys-utils/hwclock.8.adoc:189
26519 "Some non-ISA systems have a few real time clocks with only one of them "
26520 "having its own power domain. A very low power external I2C or SPI clock chip "
26521 "might be used with a backup battery as the hardware clock to initialize a "
26522 "more functional integrated real-time clock which is used for most other "
26526 #. type: Plain text
26527 #: ../sys-utils/hwclock.8.adoc:191
26529 msgid "*The System Clock:* This clock is part of the Linux kernel and is driven by a timer interrupt. (On an ISA machine, the timer interrupt is part of the ISA standard.) It has meaning only while Linux is running on the machine. The System Time is the number of seconds since 00:00:00 January 1, 1970 UTC (or more succinctly, the number of seconds since 1969 UTC). The System Time is not an integer, though. It has virtually infinite precision.\n"
26532 #. type: Plain text
26533 #: ../sys-utils/hwclock.8.adoc:193
26535 "The System Time is the time that matters. The Hardware Clock's basic purpose "
26536 "is to keep time when Linux is not running so that the System Clock can be "
26537 "initialized from it at boot. Note that in DOS, for which ISA was designed, "
26538 "the Hardware Clock is the only real time clock."
26541 #. type: Plain text
26542 #: ../sys-utils/hwclock.8.adoc:195
26544 "It is important that the System Time not have any discontinuities such as "
26545 "would happen if you used the *date*(1) program to set it while the system is "
26546 "running. You can, however, do whatever you want to the Hardware Clock while "
26547 "the system is running, and the next time Linux starts up, it will do so with "
26548 "the adjusted time from the Hardware Clock. Note: currently this is not "
26549 "possible on most systems because *hwclock --systohc* is called at shutdown."
26552 #. type: Plain text
26553 #: ../sys-utils/hwclock.8.adoc:197
26555 "The Linux kernel's timezone is set by *hwclock*. But don't be misled -- "
26556 "almost nobody cares what timezone the kernel thinks it is in. Instead, "
26557 "programs that care about the timezone (perhaps because they want to display "
26558 "a local time for you) almost always use a more traditional method of "
26559 "determining the timezone: They use the *TZ* environment variable or the _/"
26560 "etc/localtime_ file, as explained in the man page for *tzset*(3). However, "
26561 "some programs and fringe parts of the Linux kernel such as filesystems use "
26562 "the kernel's timezone value. An example is the vfat filesystem. If the "
26563 "kernel timezone value is wrong, the vfat filesystem will report and set the "
26564 "wrong timestamps on files. Another example is the kernel's NTP '11 minute "
26565 "mode'. If the kernel's timezone value and/or the _persistent_clock_is_local_ "
26566 "variable are wrong, then the Hardware Clock will be set incorrectly by '11 "
26567 "minute mode'. See the discussion below, under *Automatic Hardware Clock "
26568 "Synchronization by the Kernel*."
26571 #. type: Plain text
26572 #: ../sys-utils/hwclock.8.adoc:199
26574 msgid "*hwclock* sets the kernel's timezone to the value indicated by *TZ* or _/etc/localtime_ with the *--hctosys* or *--systz* functions.\n"
26577 #. type: Plain text
26578 #: ../sys-utils/hwclock.8.adoc:201
26580 "The kernel's timezone value actually consists of two parts: 1) a field "
26581 "tz_minuteswest indicating how many minutes local time (not adjusted for DST) "
26582 "lags behind UTC, and 2) a field tz_dsttime indicating the type of Daylight "
26583 "Savings Time (DST) convention that is in effect in the locality at the "
26584 "present time. This second field is not used under Linux and is always zero. "
26585 "See also *settimeofday*(2)."
26589 #: ../sys-utils/hwclock.8.adoc:202
26591 msgid "Hardware Clock Access Methods"
26594 #. type: Plain text
26595 #: ../sys-utils/hwclock.8.adoc:205
26597 msgid "*hwclock* uses many different ways to get and set Hardware Clock values. The most normal way is to do I/O to the rtc device special file, which is presumed to be driven by the rtc device driver. Also, Linux systems using the rtc framework with udev, are capable of supporting multiple Hardware Clocks. This may bring about the need to override the default rtc device by specifying one with the *--rtc* option.\n"
26600 #. type: Plain text
26601 #: ../sys-utils/hwclock.8.adoc:207
26603 "However, this method is not always available as older systems do not have an "
26604 "rtc driver. On these systems, the method of accessing the Hardware Clock "
26605 "depends on the system hardware."
26608 #. type: Plain text
26609 #: ../sys-utils/hwclock.8.adoc:209
26611 "On an ISA compatible system, *hwclock* can directly access the \"CMOS "
26612 "memory\" registers that constitute the clock, by doing I/O to Ports 0x70 and "
26613 "0x71. It does this with actual I/O instructions and consequently can only do "
26614 "it if running with superuser effective userid. This method may be used by "
26615 "specifying the *--directisa* option."
26618 #. type: Plain text
26619 #: ../sys-utils/hwclock.8.adoc:211
26621 "This is a really poor method of accessing the clock, for all the reasons "
26622 "that userspace programs are generally not supposed to do direct I/O and "
26623 "disable interrupts. *hwclock* provides it for testing, troubleshooting, and "
26624 "because it may be the only method available on ISA systems which do not have "
26625 "a working rtc device driver."
26629 #: ../sys-utils/hwclock.8.adoc:212
26631 msgid "The Adjust Function"
26634 #. type: Plain text
26635 #: ../sys-utils/hwclock.8.adoc:215
26637 "The Hardware Clock is usually not very accurate. However, much of its "
26638 "inaccuracy is completely predictable - it gains or loses the same amount of "
26639 "time every day. This is called systematic drift. *hwclock*'s *--adjust* "
26640 "function lets you apply systematic drift corrections to the Hardware Clock."
26643 #. type: Plain text
26644 #: ../sys-utils/hwclock.8.adoc:217
26646 "It works like this: *hwclock* keeps a file, _{ADJTIME_PATH}_, that keeps "
26647 "some historical information. This is called the adjtime file."
26650 #. type: Plain text
26651 #: ../sys-utils/hwclock.8.adoc:219
26653 "Suppose you start with no adjtime file. You issue a *hwclock --set* command "
26654 "to set the Hardware Clock to the true current time. *hwclock* creates the "
26655 "adjtime file and records in it the current time as the last time the clock "
26656 "was calibrated. Five days later, the clock has gained 10 seconds, so you "
26657 "issue a *hwclock --set --update-drift* command to set it back 10 seconds. "
26658 "*hwclock* updates the adjtime file to show the current time as the last time "
26659 "the clock was calibrated, and records 2 seconds per day as the systematic "
26660 "drift rate. 24 hours go by, and then you issue a *hwclock --adjust* command. "
26661 "*hwclock* consults the adjtime file and sees that the clock gains 2 seconds "
26662 "per day when left alone and that it has been left alone for exactly one day. "
26663 "So it subtracts 2 seconds from the Hardware Clock. It then records the "
26664 "current time as the last time the clock was adjusted. Another 24 hours go by "
26665 "and you issue another *hwclock --adjust*. *hwclock* does the same thing: "
26666 "subtracts 2 seconds and updates the adjtime file with the current time as "
26667 "the last time the clock was adjusted."
26670 #. type: Plain text
26671 #: ../sys-utils/hwclock.8.adoc:221
26673 "When you use the *--update-drift* option with *--set* or *--systohc*, the "
26674 "systematic drift rate is (re)calculated by comparing the fully drift "
26675 "corrected current Hardware Clock time with the new set time, from that it "
26676 "derives the 24 hour drift rate based on the last calibrated timestamp from "
26677 "the adjtime file. This updated drift factor is then saved in _{ADJTIME_PATH}"
26681 #. type: Plain text
26682 #: ../sys-utils/hwclock.8.adoc:223
26684 "A small amount of error creeps in when the Hardware Clock is set, so *--"
26685 "adjust* refrains from making any adjustment that is less than 1 second. "
26686 "Later on, when you request an adjustment again, the accumulated drift will "
26687 "be more than 1 second and *--adjust* will make the adjustment including any "
26688 "fractional amount."
26691 #. type: Plain text
26692 #: ../sys-utils/hwclock.8.adoc:225
26694 msgid "*hwclock --hctosys* also uses the adjtime file data to compensate the value read from the Hardware Clock before using it to set the System Clock. It does not share the 1 second limitation of *--adjust*, and will correct sub-second drift values immediately. It does not change the Hardware Clock time nor the adjtime file. This may eliminate the need to use *--adjust*, unless something else on the system needs the Hardware Clock to be compensated.\n"
26698 #: ../sys-utils/hwclock.8.adoc:226
26700 msgid "The Adjtime File"
26703 #. type: Plain text
26704 #: ../sys-utils/hwclock.8.adoc:229
26706 "While named for its historical purpose of controlling adjustments only, it "
26707 "actually contains other information used by *hwclock* from one invocation to "
26711 #. type: Plain text
26712 #: ../sys-utils/hwclock.8.adoc:231
26713 msgid "The format of the adjtime file is, in ASCII:"
26716 #. type: Plain text
26717 #: ../sys-utils/hwclock.8.adoc:233
26719 "Line 1: Three numbers, separated by blanks: 1) the systematic drift rate in "
26720 "seconds per day, floating point decimal; 2) the resulting number of seconds "
26721 "since 1969 UTC of most recent adjustment or calibration, decimal integer; 3) "
26722 "zero (for compatibility with *clock*(8)) as a floating point decimal."
26725 #. type: Plain text
26726 #: ../sys-utils/hwclock.8.adoc:235
26728 "Line 2: One number: the resulting number of seconds since 1969 UTC of most "
26729 "recent calibration. Zero if there has been no calibration yet or it is known "
26730 "that any previous calibration is moot (for example, because the Hardware "
26731 "Clock has been found, since that calibration, not to contain a valid time). "
26732 "This is a decimal integer."
26735 #. type: Plain text
26736 #: ../sys-utils/hwclock.8.adoc:237
26738 "Line 3: \"UTC\" or \"LOCAL\". Tells whether the Hardware Clock is set to "
26739 "Coordinated Universal Time or local time. You can always override this value "
26740 "with options on the *hwclock* command line."
26743 #. type: Plain text
26744 #: ../sys-utils/hwclock.8.adoc:239
26746 "You can use an adjtime file that was previously used with the *clock*(8) "
26747 "program with *hwclock*."
26751 #: ../sys-utils/hwclock.8.adoc:240
26753 msgid "Automatic Hardware Clock Synchronization by the Kernel"
26756 #. type: Plain text
26757 #: ../sys-utils/hwclock.8.adoc:243
26759 "You should be aware of another way that the Hardware Clock is kept "
26760 "synchronized in some systems. The Linux kernel has a mode wherein it copies "
26761 "the System Time to the Hardware Clock every 11 minutes. This mode is a "
26762 "compile time option, so not all kernels will have this capability. This is a "
26763 "good mode to use when you are using something sophisticated like NTP to keep "
26764 "your System Clock synchronized. (NTP is a way to keep your System Time "
26765 "synchronized either to a time server somewhere on the network or to a radio "
26766 "clock hooked up to your system. See RFC 1305.)"
26769 #. type: Plain text
26770 #: ../sys-utils/hwclock.8.adoc:245
26772 "If the kernel is compiled with the '11 minute mode' option it will be active "
26773 "when the kernel's clock discipline is in a synchronized state. When in this "
26774 "state, bit 6 (the bit that is set in the mask 0x0040) of the kernel's "
26775 "_time_status_ variable is unset. This value is output as the 'status' line "
26776 "of the *adjtimex --print* or *ntptime* commands."
26779 #. type: Plain text
26780 #: ../sys-utils/hwclock.8.adoc:247
26782 "It takes an outside influence, like the NTP daemon to put the kernel's clock "
26783 "discipline into a synchronized state, and therefore turn on '11 minute "
26784 "mode'. It can be turned off by running anything that sets the System Clock "
26785 "the old fashioned way, including *hwclock --hctosys*. However, if the NTP "
26786 "daemon is still running, it will turn '11 minute mode' back on again the "
26787 "next time it synchronizes the System Clock."
26790 #. type: Plain text
26791 #: ../sys-utils/hwclock.8.adoc:249
26793 "If your system runs with '11 minute mode' on, it may need to use either *--"
26794 "hctosys* or *--systz* in a startup script, especially if the Hardware Clock "
26795 "is configured to use the local timescale. Unless the kernel is informed of "
26796 "what timescale the Hardware Clock is using, it may clobber it with the wrong "
26797 "one. The kernel uses UTC by default."
26800 #. type: Plain text
26801 #: ../sys-utils/hwclock.8.adoc:251
26803 "The first userspace command to set the System Clock informs the kernel what "
26804 "timescale the Hardware Clock is using. This happens via the "
26805 "_persistent_clock_is_local_ kernel variable. If *--hctosys* or *--systz* is "
26806 "the first, it will set this variable according to the adjtime file or the "
26807 "appropriate command-line argument. Note that when using this capability and "
26808 "the Hardware Clock timescale configuration is changed, then a reboot is "
26809 "required to notify the kernel."
26812 #. type: Plain text
26813 #: ../sys-utils/hwclock.8.adoc:253
26815 msgid "*hwclock --adjust* should not be used with NTP '11 minute mode'.\n"
26819 #: ../sys-utils/hwclock.8.adoc:254
26821 msgid "ISA Hardware Clock Century value"
26824 #. type: Plain text
26825 #: ../sys-utils/hwclock.8.adoc:257
26827 "There is some sort of standard that defines CMOS memory Byte 50 on an ISA "
26828 "machine as an indicator of what century it is. *hwclock* does not use or set "
26829 "that byte because there are some machines that don't define the byte that "
26830 "way, and it really isn't necessary anyway, since the year-of-century does a "
26831 "good job of implying which century it is."
26834 #. type: Plain text
26835 #: ../sys-utils/hwclock.8.adoc:259
26837 "If you have a bona fide use for a CMOS century byte, contact the *hwclock* "
26838 "maintainer; an option may be appropriate."
26841 #. type: Plain text
26842 #: ../sys-utils/hwclock.8.adoc:261
26844 "Note that this section is only relevant when you are using the \"direct "
26845 "ISA\" method of accessing the Hardware Clock. ACPI provides a standard way "
26846 "to access century values, when they are supported by the hardware."
26850 #: ../sys-utils/hwclock.8.adoc:262
26852 msgid "DATE-TIME CONFIGURATION"
26856 #: ../sys-utils/hwclock.8.adoc:264
26858 msgid "Keeping Time without External Synchronization"
26861 #. type: Plain text
26862 #: ../sys-utils/hwclock.8.adoc:267
26863 msgid "This discussion is based on the following conditions:"
26866 #. type: Plain text
26867 #: ../sys-utils/hwclock.8.adoc:269
26869 "Nothing is running that alters the date-time clocks, such as NTP daemon or a "
26873 #. type: Plain text
26874 #: ../sys-utils/hwclock.8.adoc:270
26876 "The system timezone is configured for the correct local time. See below, "
26877 "under *POSIX vs 'RIGHT'*."
26880 #. type: Plain text
26881 #: ../sys-utils/hwclock.8.adoc:271
26883 "Early during startup the following are called, in this order: *adjtimex --"
26884 "tick* _value_ *--frequency* _value_ *hwclock --hctosys*"
26887 #. type: Plain text
26888 #: ../sys-utils/hwclock.8.adoc:272
26889 msgid "During shutdown the following is called: *hwclock --systohc*"
26892 #. type: Plain text
26893 #: ../sys-utils/hwclock.8.adoc:274
26894 msgid "Systems without *adjtimex* may use *ntptime*."
26897 #. type: Plain text
26898 #: ../sys-utils/hwclock.8.adoc:276
26900 "Whether maintaining precision time with NTP daemon or not, it makes sense to "
26901 "configure the system to keep reasonably good date-time on its own."
26904 #. type: Plain text
26905 #: ../sys-utils/hwclock.8.adoc:278
26907 "The first step in making that happen is having a clear understanding of the "
26908 "big picture. There are two completely separate hardware devices running at "
26909 "their own speed and drifting away from the 'correct' time at their own "
26910 "rates. The methods and software for drift correction are different for each "
26911 "of them. However, most systems are configured to exchange values between "
26912 "these two clocks at startup and shutdown. Now the individual device's time "
26913 "keeping errors are transferred back and forth between each other. Attempt to "
26914 "configure drift correction for only one of them, and the other's drift will "
26915 "be overlaid upon it."
26918 #. type: Plain text
26919 #: ../sys-utils/hwclock.8.adoc:280
26921 "This problem can be avoided when configuring drift correction for the System "
26922 "Clock by simply not shutting down the machine. This, plus the fact that all "
26923 "of *hwclock*'s precision (including calculating drift factors) depends upon "
26924 "the System Clock's rate being correct, means that configuration of the "
26925 "System Clock should be done first."
26928 #. type: Plain text
26929 #: ../sys-utils/hwclock.8.adoc:282
26931 "The System Clock drift is corrected with the *adjtimex*(8) command's *--"
26932 "tick* and *--frequency* options. These two work together: tick is the coarse "
26933 "adjustment and frequency is the fine adjustment. (For systems that do not "
26934 "have an *adjtimex* package, *ntptime -f* _ppm_ may be used instead.)"
26937 #. type: Plain text
26938 #: ../sys-utils/hwclock.8.adoc:284
26940 "Some Linux distributions attempt to automatically calculate the System Clock "
26941 "drift with *adjtimex*'s compare operation. Trying to correct one drifting "
26942 "clock by using another drifting clock as a reference is akin to a dog trying "
26943 "to catch its own tail. Success may happen eventually, but great effort and "
26944 "frustration will likely precede it. This automation may yield an improvement "
26945 "over no configuration, but expecting optimum results would be in error. A "
26946 "better choice for manual configuration would be *adjtimex*'s *--log* options."
26949 #. type: Plain text
26950 #: ../sys-utils/hwclock.8.adoc:286
26952 "It may be more effective to simply track the System Clock drift with *sntp*, "
26953 "or *date -Ins* and a precision timepiece, and then calculate the correction "
26957 #. type: Plain text
26958 #: ../sys-utils/hwclock.8.adoc:288
26960 "After setting the tick and frequency values, continue to test and refine the "
26961 "adjustments until the System Clock keeps good time. See *adjtimex*(2) for "
26962 "more information and the example demonstrating manual drift calculations."
26965 #. type: Plain text
26966 #: ../sys-utils/hwclock.8.adoc:290
26968 "Once the System Clock is ticking smoothly, move on to the Hardware Clock."
26971 #. type: Plain text
26972 #: ../sys-utils/hwclock.8.adoc:292
26974 "As a rule, cold drift will work best for most use cases. This should be true "
26975 "even for 24/7 machines whose normal downtime consists of a reboot. In that "
26976 "case the drift factor value makes little difference. But on the rare "
26977 "occasion that the machine is shut down for an extended period, then cold "
26978 "drift should yield better results."
26981 #. type: Plain text
26982 #: ../sys-utils/hwclock.8.adoc:294
26984 msgid "*Steps to calculate cold drift:*\n"
26987 #. type: Plain text
26988 #: ../sys-utils/hwclock.8.adoc:297
26990 msgid "*Ensure that NTP daemon will not be launched at startup.*\n"
26993 #. type: Plain text
26994 #: ../sys-utils/hwclock.8.adoc:300
26995 msgid "The _System Clock_ time must be correct at shutdown!"
26998 #. type: Labeled list
26999 #: ../sys-utils/hwclock.8.adoc:301
27004 #. type: Plain text
27005 #: ../sys-utils/hwclock.8.adoc:303
27006 msgid "Shut down the system."
27009 #. type: Labeled list
27010 #: ../sys-utils/hwclock.8.adoc:304
27015 #. type: Plain text
27016 #: ../sys-utils/hwclock.8.adoc:306
27017 msgid "Let an extended period pass without changing the Hardware Clock."
27020 #. type: Labeled list
27021 #: ../sys-utils/hwclock.8.adoc:307
27026 #. type: Plain text
27027 #: ../sys-utils/hwclock.8.adoc:309
27028 msgid "Start the system."
27031 #. type: Labeled list
27032 #: ../sys-utils/hwclock.8.adoc:310
27037 #. type: Plain text
27038 #: ../sys-utils/hwclock.8.adoc:312
27040 "Immediately use *hwclock* to set the correct time, adding the *--update-"
27044 #. type: Plain text
27045 #: ../sys-utils/hwclock.8.adoc:314
27047 "Note: if step 6 uses *--systohc*, then the System Clock must be set "
27048 "correctly (step 6a) just before doing so."
27051 #. type: Plain text
27052 #: ../sys-utils/hwclock.8.adoc:316
27054 "Having *hwclock* calculate the drift factor is a good starting point, but "
27055 "for optimal results it will likely need to be adjusted by directly editing "
27056 "the _{ADJTIME_PATH}_ file. Continue to test and refine the drift factor "
27057 "until the Hardware Clock is corrected properly at startup. To check this, "
27058 "first make sure that the System Time is correct before shutdown and then use "
27059 "*sntp*, or *date -Ins* and a precision timepiece, immediately after startup."
27063 #: ../sys-utils/hwclock.8.adoc:317
27065 msgid "LOCAL vs UTC"
27068 #. type: Plain text
27069 #: ../sys-utils/hwclock.8.adoc:320
27071 "Keeping the Hardware Clock in a local timescale causes inconsistent daylight "
27072 "saving time results:"
27075 #. type: Plain text
27076 #: ../sys-utils/hwclock.8.adoc:322
27078 "If Linux is running during a daylight saving time change, the time written "
27079 "to the Hardware Clock will be adjusted for the change."
27082 #. type: Plain text
27083 #: ../sys-utils/hwclock.8.adoc:323
27085 "If Linux is NOT running during a daylight saving time change, the time read "
27086 "from the Hardware Clock will NOT be adjusted for the change."
27089 #. type: Plain text
27090 #: ../sys-utils/hwclock.8.adoc:325
27092 "The Hardware Clock on an ISA compatible system keeps only a date and time, "
27093 "it has no concept of timezone nor daylight saving. Therefore, when *hwclock* "
27094 "is told that it is in local time, it assumes it is in the 'correct' local "
27095 "time and makes no adjustments to the time read from it."
27098 #. type: Plain text
27099 #: ../sys-utils/hwclock.8.adoc:327
27101 "Linux handles daylight saving time changes transparently only when the "
27102 "Hardware Clock is kept in the UTC timescale. Doing so is made easy for "
27103 "system administrators as *hwclock* uses local time for its output and as the "
27104 "argument to the *--date* option."
27107 #. type: Plain text
27108 #: ../sys-utils/hwclock.8.adoc:329
27110 "POSIX systems, like Linux, are designed to have the System Clock operate in "
27111 "the UTC timescale. The Hardware Clock's purpose is to initialize the System "
27112 "Clock, so also keeping it in UTC makes sense."
27115 #. type: Plain text
27116 #: ../sys-utils/hwclock.8.adoc:331
27118 "Linux does, however, attempt to accommodate the Hardware Clock being in the "
27119 "local timescale. This is primarily for dual-booting with older versions of "
27120 "MS Windows. From Windows 7 on, the RealTimeIsUniversal registry key is "
27121 "supposed to be working properly so that its Hardware Clock can be kept in "
27126 #: ../sys-utils/hwclock.8.adoc:332
27128 msgid "POSIX vs 'RIGHT'"
27131 #. type: Plain text
27132 #: ../sys-utils/hwclock.8.adoc:335
27134 "A discussion on date-time configuration would be incomplete without "
27135 "addressing timezones, this is mostly well covered by *tzset*(3). One area "
27136 "that seems to have no documentation is the 'right' directory of the Time "
27137 "Zone Database, sometimes called tz or zoneinfo."
27140 #. TRANSLATORS: Keep {plus} untranslated.
27141 #. type: Plain text
27142 #: ../sys-utils/hwclock.8.adoc:338
27144 "There are two separate databases in the zoneinfo system, posix and 'right'. "
27145 "'Right' (now named zoneinfo-leaps) includes leap seconds and posix does not. "
27146 "To use the 'right' database the System Clock must be set to (UTC {plus} leap "
27147 "seconds), which is equivalent to (TAI - 10). This allows calculating the "
27148 "exact number of seconds between two dates that cross a leap second epoch. "
27149 "The System Clock is then converted to the correct civil time, including UTC, "
27150 "by using the 'right' timezone files which subtract the leap seconds. Note: "
27151 "this configuration is considered experimental and is known to have issues."
27154 #. type: Plain text
27155 #: ../sys-utils/hwclock.8.adoc:340
27157 "To configure a system to use a particular database all of the files located "
27158 "in its directory must be copied to the root of _/usr/share/zoneinfo_. Files "
27159 "are never used directly from the posix or 'right' subdirectories, e.g., "
27160 "TZ='_right/Europe/Dublin_'. This habit was becoming so common that the "
27161 "upstream zoneinfo project restructured the system's file tree by moving the "
27162 "posix and 'right' subdirectories out of the zoneinfo directory and into "
27163 "sibling directories:"
27166 #. type: Plain text
27167 #: ../sys-utils/hwclock.8.adoc:342
27169 "_/usr/share/zoneinfo_, _/usr/share/zoneinfo-posix_, _/usr/share/zoneinfo-"
27173 #. type: Plain text
27174 #: ../sys-utils/hwclock.8.adoc:344
27176 "Unfortunately, some Linux distributions are changing it back to the old tree "
27177 "structure in their packages. So the problem of system administrators "
27178 "reaching into the 'right' subdirectory persists. This causes the system "
27179 "timezone to be configured to include leap seconds while the zoneinfo "
27180 "database is still configured to exclude them. Then when an application such "
27181 "as a World Clock needs the South_Pole timezone file; or an email MTA, or "
27182 "*hwclock* needs the UTC timezone file; they fetch it from the root of _/usr/"
27183 "share/zoneinfo_ , because that is what they are supposed to do. Those files "
27184 "exclude leap seconds, but the System Clock now includes them, causing an "
27185 "incorrect time conversion."
27188 #. type: Plain text
27189 #: ../sys-utils/hwclock.8.adoc:346
27191 "Attempting to mix and match files from these separate databases will not "
27192 "work, because they each require the System Clock to use a different "
27193 "timescale. The zoneinfo database must be configured to use either posix or "
27194 "'right', as described above, or by assigning a database path to the _TZDIR_ "
27195 "environment variable."
27198 #. type: Plain text
27199 #: ../sys-utils/hwclock.8.adoc:350
27200 msgid "One of the following exit values will be returned:"
27203 #. type: Labeled list
27204 #: ../sys-utils/hwclock.8.adoc:351
27206 msgid "*EXIT_SUCCESS* ('0' on POSIX systems)"
27209 #. type: Plain text
27210 #: ../sys-utils/hwclock.8.adoc:353
27211 msgid "Successful program execution."
27214 #. type: Labeled list
27215 #: ../sys-utils/hwclock.8.adoc:354
27217 msgid "*EXIT_FAILURE* ('1' on POSIX systems)"
27220 #. type: Plain text
27221 #: ../sys-utils/hwclock.8.adoc:356
27222 msgid "The operation failed or the command syntax was not valid."
27225 #. type: Labeled list
27226 #: ../sys-utils/hwclock.8.adoc:359
27231 #. type: Plain text
27232 #: ../sys-utils/hwclock.8.adoc:361
27234 "If this variable is set its value takes precedence over the system "
27235 "configured timezone."
27238 #. type: Labeled list
27239 #: ../sys-utils/hwclock.8.adoc:362
27244 #. type: Plain text
27245 #: ../sys-utils/hwclock.8.adoc:364
27247 "If this variable is set its value takes precedence over the system "
27248 "configured timezone database directory path."
27251 #. type: Plain text
27252 #: ../sys-utils/hwclock.8.adoc:367 ../sys-utils/rtcwake.8.adoc:117
27254 msgid "_{ADJTIME_PATH}_"
27257 #. type: Plain text
27258 #: ../sys-utils/hwclock.8.adoc:369
27260 "The configuration and state file for *hwclock*. See also *adjtime_config*(5)."
27263 #. type: Labeled list
27264 #: ../sys-utils/hwclock.8.adoc:370
27266 #| msgid "_/etc/login.defs_"
27267 msgid "_/etc/localtime_"
27268 msgstr "_/etc/login.defs_"
27270 #. type: Plain text
27271 #: ../sys-utils/hwclock.8.adoc:372
27272 msgid "The system timezone file."
27275 #. type: Labeled list
27276 #: ../sys-utils/hwclock.8.adoc:373
27278 msgid "_/usr/share/zoneinfo/_"
27281 #. type: Plain text
27282 #: ../sys-utils/hwclock.8.adoc:375
27283 msgid "The system timezone database directory."
27286 #. type: Plain text
27287 #: ../sys-utils/hwclock.8.adoc:377
27289 "Device files *hwclock* may try for Hardware Clock access: _/dev/rtc0_ _/dev/"
27290 "rtc_ _/dev/misc/rtc_ _/dev/efirtc_ _/dev/misc/efirtc_"
27293 #. type: Plain text
27294 #: ../sys-utils/hwclock.8.adoc:387
27298 "*adjtime_config*(5),\n"
27300 "*gettimeofday*(2),\n"
27301 "*settimeofday*(2),\n"
27306 #. type: Plain text
27307 #: ../sys-utils/hwclock.8.adoc:391
27309 "Written by mailto:bryanh@giraffe-data.com[Bryan Henderson], September 1996, "
27310 "based on work done on the *clock*(8) program by Charles Hedrick, Rob Hooft, "
27311 "and Harald Koenig. See the source code for complete history and credits."
27314 #. Copyright 2008 Hayden A. James (hayden.james@gmail.com)
27315 #. May be distributed under the GNU General Public License
27317 #: ../sys-utils/ipcmk.1.adoc:6
27322 #. type: Plain text
27323 #: ../sys-utils/ipcmk.1.adoc:16
27324 msgid "ipcmk - make various IPC resources"
27327 #. type: Plain text
27328 #: ../sys-utils/ipcmk.1.adoc:20
27330 msgid "*ipcmk* [options]\n"
27333 #. type: Plain text
27334 #: ../sys-utils/ipcmk.1.adoc:24
27336 msgid "*ipcmk* allows you to create System V inter-process communication (IPC) objects: shared memory segments, message queues, and semaphore arrays.\n"
27339 #. type: Plain text
27340 #: ../sys-utils/ipcmk.1.adoc:28
27341 msgid "Resources can be specified with these options:"
27344 #. type: Labeled list
27345 #: ../sys-utils/ipcmk.1.adoc:29
27347 #| msgid "*-s*, **--shell**=__shell__"
27348 msgid "*-M*, *--shmem* _size_"
27349 msgstr "*-s*, **--shell**=__shell__"
27351 #. type: Plain text
27352 #: ../sys-utils/ipcmk.1.adoc:31
27354 "Create a shared memory segment of _size_ bytes. The _size_ argument may be "
27355 "followed by the multiplicative suffixes KiB (=1024), MiB (=1024*1024), and "
27356 "so on for GiB, etc. (the \"iB\" is optional, e.g., \"K\" has the same "
27357 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
27361 #. type: Labeled list
27362 #: ../sys-utils/ipcmk.1.adoc:32
27364 #| msgid "*-h*, *--help*"
27365 msgid "*-Q*, *--queue*"
27366 msgstr "*-h*, *--help*"
27368 #. type: Plain text
27369 #: ../sys-utils/ipcmk.1.adoc:34
27370 msgid "Create a message queue."
27373 #. type: Labeled list
27374 #: ../sys-utils/ipcmk.1.adoc:35
27376 msgid "*-S*, *--semaphore* _number_"
27379 #. type: Plain text
27380 #: ../sys-utils/ipcmk.1.adoc:37
27381 msgid "Create a semaphore array with _number_ of elements."
27384 #. type: Plain text
27385 #: ../sys-utils/ipcmk.1.adoc:39
27386 msgid "Other options are:"
27389 #. type: Labeled list
27390 #: ../sys-utils/ipcmk.1.adoc:40
27392 msgid "*-p*, *--mode* _mode_"
27395 #. type: Plain text
27396 #: ../sys-utils/ipcmk.1.adoc:42
27397 msgid "Access permissions for the resource. Default is 0644."
27400 #. type: Plain text
27401 #: ../sys-utils/ipcmk.1.adoc:48
27402 msgid "mailto:hayden.james@gmail.com[Hayden A. James]"
27405 #. type: Plain text
27406 #: ../sys-utils/ipcmk.1.adoc:54
27414 #. Copyright 2002 Andre C. Mazzone (linuxdev@karagee.com)
27415 #. May be distributed under the GNU General Public License
27417 #: ../sys-utils/ipcrm.1.adoc:6
27422 #. type: Plain text
27423 #: ../sys-utils/ipcrm.1.adoc:17
27424 msgid "ipcrm - remove certain IPC resources"
27427 #. type: Plain text
27428 #: ../sys-utils/ipcrm.1.adoc:21
27430 msgid "*ipcrm* [options]\n"
27433 #. type: Plain text
27434 #: ../sys-utils/ipcrm.1.adoc:23
27436 msgid "*ipcrm* [*shm*|*msg*|*sem*] _ID_ ...\n"
27439 #. type: Plain text
27440 #: ../sys-utils/ipcrm.1.adoc:27
27442 msgid "*ipcrm* removes System V inter-process communication (IPC) objects and associated data structures from the system. In order to delete such objects, you must be superuser, or the creator or owner of the object.\n"
27445 #. type: Plain text
27446 #: ../sys-utils/ipcrm.1.adoc:29
27448 "System V IPC objects are of three types: shared memory, message queues, and "
27449 "semaphores. Deletion of a message queue or semaphore object is immediate "
27450 "(regardless of whether any process still holds an IPC identifier for the "
27451 "object). A shared memory object is only removed after all currently attached "
27452 "processes have detached (*shmdt*(2)) the object from their virtual address "
27456 #. type: Plain text
27457 #: ../sys-utils/ipcrm.1.adoc:31
27459 "Two syntax styles are supported. The old Linux historical syntax specifies a "
27460 "three-letter keyword indicating which class of object is to be deleted, "
27461 "followed by one or more IPC identifiers for objects of this type."
27464 #. type: Plain text
27465 #: ../sys-utils/ipcrm.1.adoc:33
27467 "The SUS-compliant syntax allows the specification of zero or more objects of "
27468 "all three types in a single command line, with objects specified either by "
27469 "key or by identifier (see below). Both keys and identifiers may be specified "
27470 "in decimal, hexadecimal (specified with an initial '0x' or '0X'), or octal "
27471 "(specified with an initial '0')."
27474 #. type: Plain text
27475 #: ../sys-utils/ipcrm.1.adoc:35
27477 "The details of the removes are described in *shmctl*(2), *msgctl*(2), and "
27478 "*semctl*(2). The identifiers and keys can be found by using *ipcs*(1)."
27481 #. type: Labeled list
27482 #: ../sys-utils/ipcrm.1.adoc:38
27484 msgid "*-a*, *--all* [*shm*] [*msg*] [*sem*]"
27487 #. type: Plain text
27488 #: ../sys-utils/ipcrm.1.adoc:40
27490 "Remove all resources. When an option argument is provided, the removal is "
27491 "performed only for the specified resource types."
27494 #. type: Plain text
27495 #: ../sys-utils/ipcrm.1.adoc:42
27497 "_Warning!_ Do not use *-a* if you are unsure how the software using the "
27498 "resources might react to missing objects. Some programs create these "
27499 "resources at startup and may not have any code to deal with an unexpected "
27503 #. type: Labeled list
27504 #: ../sys-utils/ipcrm.1.adoc:43
27506 #| msgid "*-s*, **--shell**=__shell__"
27507 msgid "*-M*, *--shmem-key* _shmkey_"
27508 msgstr "*-s*, **--shell**=__shell__"
27510 #. type: Plain text
27511 #: ../sys-utils/ipcrm.1.adoc:45
27513 "Remove the shared memory segment created with _shmkey_ after the last detach "
27517 #. type: Labeled list
27518 #: ../sys-utils/ipcrm.1.adoc:46
27520 #| msgid "*-s*, **--shell**=__shell__"
27521 msgid "*-m*, *--shmem-id* _shmid_"
27522 msgstr "*-s*, **--shell**=__shell__"
27524 #. type: Plain text
27525 #: ../sys-utils/ipcrm.1.adoc:48
27527 "Remove the shared memory segment identified by _shmid_ after the last detach "
27531 #. type: Labeled list
27532 #: ../sys-utils/ipcrm.1.adoc:49
27534 msgid "*-Q*, *--queue-key* _msgkey_"
27537 #. type: Plain text
27538 #: ../sys-utils/ipcrm.1.adoc:51
27539 msgid "Remove the message queue created with _msgkey_."
27542 #. type: Labeled list
27543 #: ../sys-utils/ipcrm.1.adoc:52
27545 msgid "*-q*, *--queue-id* _msgid_"
27548 #. type: Plain text
27549 #: ../sys-utils/ipcrm.1.adoc:54
27550 msgid "Remove the message queue identified by _msgid_."
27553 #. type: Labeled list
27554 #: ../sys-utils/ipcrm.1.adoc:55
27556 msgid "*-S*, *--semaphore-key* _semkey_"
27559 #. type: Plain text
27560 #: ../sys-utils/ipcrm.1.adoc:57
27561 msgid "Remove the semaphore created with _semkey_."
27564 #. type: Labeled list
27565 #: ../sys-utils/ipcrm.1.adoc:58
27567 msgid "*-s*, *--semaphore-id* _semid_"
27570 #. type: Plain text
27571 #: ../sys-utils/ipcrm.1.adoc:60
27572 msgid "Remove the semaphore identified by _semid_."
27575 #. TRANSLATORS: Keep {asterisk} untranslated; it expands to "*nix".
27576 #. type: Plain text
27577 #: ../sys-utils/ipcrm.1.adoc:67
27579 "In its first Linux implementation, *ipcrm* used the deprecated syntax shown "
27580 "in the second line of the *SYNOPSIS*. Functionality present in other "
27581 "{asterisk}nix implementations of *ipcrm* has since been added, namely the "
27582 "ability to delete resources by key (not just identifier), and to respect the "
27583 "same command-line syntax. For backward compatibility the previous syntax is "
27587 #. type: Plain text
27588 #: ../sys-utils/ipcrm.1.adoc:81
27604 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
27605 #. May be distributed under the GNU General Public License
27607 #: ../sys-utils/ipcs.1.adoc:6
27612 #. type: Plain text
27613 #: ../sys-utils/ipcs.1.adoc:16
27615 #| msgid "fstab - static information about the filesystems"
27616 msgid "ipcs - show information on IPC facilities"
27617 msgstr "fstab - statická informace o souborových systémech"
27619 #. type: Plain text
27620 #: ../sys-utils/ipcs.1.adoc:20
27622 msgid "*ipcs* [options]\n"
27625 #. type: Plain text
27626 #: ../sys-utils/ipcs.1.adoc:24
27628 msgid "*ipcs* shows information on System V inter-process communication facilities. By default it shows information about all three resources: shared memory segments, message queues, and semaphore arrays.\n"
27631 #. type: Labeled list
27632 #: ../sys-utils/ipcs.1.adoc:27 ../sys-utils/lsipc.1.adoc:23
27634 #| msgid "*-P*, *--pty*"
27635 msgid "*-i*, *--id* _id_"
27636 msgstr "*-P*, *--pty*"
27638 #. type: Plain text
27639 #: ../sys-utils/ipcs.1.adoc:29
27641 "Show full details on just the one resource element identified by _id_. This "
27642 "option needs to be combined with one of the three resource options: *-m*, *-"
27647 #: ../sys-utils/ipcs.1.adoc:32 ../sys-utils/lsipc.1.adoc:31
27649 msgid "Resource options"
27652 #. type: Labeled list
27653 #: ../sys-utils/ipcs.1.adoc:34 ../sys-utils/lsipc.1.adoc:33
27655 #| msgid "*-h*, *--help*"
27656 msgid "*-m*, *--shmems*"
27657 msgstr "*-h*, *--help*"
27659 #. type: Plain text
27660 #: ../sys-utils/ipcs.1.adoc:36 ../sys-utils/lsipc.1.adoc:35
27661 msgid "Write information about active shared memory segments."
27664 #. type: Labeled list
27665 #: ../sys-utils/ipcs.1.adoc:37 ../sys-utils/lsipc.1.adoc:36
27667 #| msgid "*-h*, *--help*"
27668 msgid "*-q*, *--queues*"
27669 msgstr "*-h*, *--help*"
27671 #. type: Plain text
27672 #: ../sys-utils/ipcs.1.adoc:39 ../sys-utils/lsipc.1.adoc:38
27673 msgid "Write information about active message queues."
27676 #. type: Labeled list
27677 #: ../sys-utils/ipcs.1.adoc:40 ../sys-utils/lsipc.1.adoc:39
27679 #| msgid "*-V*, *--version*"
27680 msgid "*-s*, *--semaphores*"
27681 msgstr "*-V*, *--version*"
27683 #. type: Plain text
27684 #: ../sys-utils/ipcs.1.adoc:42 ../sys-utils/lsipc.1.adoc:41
27685 msgid "Write information about active semaphore sets."
27688 #. type: Plain text
27689 #: ../sys-utils/ipcs.1.adoc:45
27690 msgid "Write information about all three resources (default)."
27694 #: ../sys-utils/ipcs.1.adoc:46
27696 #| msgid "File formats"
27697 msgid "Output formats"
27698 msgstr "Formáty souborů"
27700 #. type: Plain text
27701 #: ../sys-utils/ipcs.1.adoc:49
27702 msgid "Of these options only one takes effect: the last one specified."
27705 #. type: Labeled list
27706 #: ../sys-utils/ipcs.1.adoc:50 ../sys-utils/lsipc.1.adoc:44
27708 #| msgid "*-f*, *--fast*"
27709 msgid "*-c*, *--creator*"
27710 msgstr "*-f*, *--fast*"
27712 #. type: Plain text
27713 #: ../sys-utils/ipcs.1.adoc:52 ../sys-utils/lsipc.1.adoc:46
27714 msgid "Show creator and owner."
27717 #. type: Labeled list
27718 #: ../sys-utils/ipcs.1.adoc:53
27720 #| msgid "*-P*, *--pty*"
27721 msgid "*-l*, *--limits*"
27722 msgstr "*-P*, *--pty*"
27724 #. type: Plain text
27725 #: ../sys-utils/ipcs.1.adoc:55
27726 msgid "Show resource limits."
27729 #. type: Plain text
27730 #: ../sys-utils/ipcs.1.adoc:58
27731 msgid "Show PIDs of creator and last operator."
27734 #. type: Plain text
27735 #: ../sys-utils/ipcs.1.adoc:61 ../sys-utils/lsipc.1.adoc:76
27737 "Write time information. The time of the last control operation that changed "
27738 "the access permissions for all facilities, the time of the last *msgsnd*(2) "
27739 "and *msgrcv*(2) operations on message queues, the time of the last "
27740 "*shmat*(2) and *shmdt*(2) operations on shared memory, and the time of the "
27741 "last *semop*(2) operation on semaphores."
27744 #. type: Labeled list
27745 #: ../sys-utils/ipcs.1.adoc:62
27747 #| msgid "*-P*, *--pty*"
27748 msgid "*-u*, *--summary*"
27749 msgstr "*-P*, *--pty*"
27751 #. type: Plain text
27752 #: ../sys-utils/ipcs.1.adoc:64
27753 msgid "Show status summary."
27757 #: ../sys-utils/ipcs.1.adoc:65
27759 msgid "Representation"
27762 #. type: Plain text
27763 #: ../sys-utils/ipcs.1.adoc:68
27764 msgid "These affect only the *-l* (*--limits*) option."
27767 #. type: Labeled list
27768 #: ../sys-utils/ipcs.1.adoc:73
27773 #. type: Plain text
27774 #: ../sys-utils/ipcs.1.adoc:75
27776 #| msgid "Print the sizes in bytes rather than in a human-readable format."
27777 msgid "Print sizes in human-readable format."
27778 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
27780 #. type: Plain text
27781 #: ../sys-utils/ipcs.1.adoc:79
27783 "The Linux *ipcs* utility is not fully compatible to the POSIX *ipcs* "
27784 "utility. The Linux version does not support the POSIX *-a*, *-b* and *-o* "
27785 "options, but does support the *-l* and *-u* options not defined by POSIX. A "
27786 "portable application shall not use the *-a*, *-b*, *-o*, *-l*, and *-u* "
27790 #. type: Plain text
27791 #: ../sys-utils/ipcs.1.adoc:83
27793 "The current implementation of *ipcs* obtains information about available IPC "
27794 "resources by parsing the files in _/proc/sysvipc_. Before util-linux version "
27795 "v2.23, an alternate mechanism was used: the *IPC_STAT* command of "
27796 "*msgctl*(2), *semctl*(2), and *shmctl*(2). This mechanism is also used in "
27797 "later util-linux versions in the case where _/proc_ is unavailable. A "
27798 "limitation of the *IPC_STAT* mechanism is that it can only be used to "
27799 "retrieve information about IPC resources for which the user has read "
27803 #. type: Plain text
27804 #: ../sys-utils/ipcs.1.adoc:87
27805 msgid "mailto:balasub@cis.ohio-state.edu[Krishna Balasubramanian]"
27808 #. type: Plain text
27809 #: ../sys-utils/ipcs.1.adoc:100 ../sys-utils/lsipc.1.adoc:118
27825 #: ../sys-utils/irqtop.1.adoc:2
27830 #. type: Plain text
27831 #: ../sys-utils/irqtop.1.adoc:12
27832 msgid "irqtop - utility to display kernel interrupt information"
27835 #. type: Plain text
27836 #: ../sys-utils/irqtop.1.adoc:16
27838 msgid "*irqtop* [options]\n"
27841 #. type: Plain text
27842 #: ../sys-utils/irqtop.1.adoc:20
27843 msgid "Display kernel interrupt counter information in *top*(1) style view."
27846 #. type: Plain text
27847 #: ../sys-utils/irqtop.1.adoc:22 ../sys-utils/lsirq.1.adoc:22
27849 "The default output is subject to change. So whenever possible, you should "
27850 "avoid using default outputs in your scripts. Always explicitly define "
27851 "expected columns by using *--output*."
27854 #. type: Plain text
27855 #: ../sys-utils/irqtop.1.adoc:27 ../sys-utils/lsirq.1.adoc:30
27857 "Specify which output columns to print. Use *--help* to get a list of all "
27858 "supported columns. The default list of columns may be extended if list is "
27859 "specified in the format _+list_."
27862 #. type: Labeled list
27863 #: ../sys-utils/irqtop.1.adoc:28
27865 msgid "*-c*, *--cpu-stat* _mode_"
27868 #. type: Plain text
27869 #: ../sys-utils/irqtop.1.adoc:30
27871 "Show per-cpu statistics by specified mode. Available modes are: *auto*, "
27872 "*enable*, *disable*. The default option *auto* detects the width of window, "
27873 "then shows the per-cpu statistics if the width of window is large enough to "
27874 "show a full line of statistics."
27877 #. type: Labeled list
27878 #: ../sys-utils/irqtop.1.adoc:31
27880 #| msgid "*-P*, *--pty*"
27881 msgid "*-C*, *--cpu-list* _list_"
27882 msgstr "*-P*, *--pty*"
27884 #. type: Plain text
27885 #: ../sys-utils/irqtop.1.adoc:33
27886 msgid "Specify cpus in list format to show."
27889 #. type: Labeled list
27890 #: ../sys-utils/irqtop.1.adoc:34
27892 msgid "*-d*, *--delay* _seconds_"
27895 #. type: Plain text
27896 #: ../sys-utils/irqtop.1.adoc:36
27897 msgid "Update interrupt output every _seconds_ intervals."
27900 #. type: Labeled list
27901 #: ../sys-utils/irqtop.1.adoc:37 ../sys-utils/lsirq.1.adoc:31
27903 msgid "*-s*, *--sort* _column_"
27906 #. type: Plain text
27907 #: ../sys-utils/irqtop.1.adoc:39
27909 "Specify sort criteria by column name. See *--help* output to get column "
27910 "names. The sort criteria may be changes in interactive mode."
27913 #. type: Labeled list
27914 #: ../sys-utils/irqtop.1.adoc:40 ../sys-utils/lsirq.1.adoc:40
27916 #| msgid "*-f*, *--fast*"
27917 msgid "*-S*, *--softirq*"
27918 msgstr "*-f*, *--fast*"
27920 #. type: Plain text
27921 #: ../sys-utils/irqtop.1.adoc:42 ../sys-utils/lsirq.1.adoc:42
27922 msgid "Show softirqs information."
27926 #: ../sys-utils/irqtop.1.adoc:45
27928 msgid "INTERACTIVE MODE KEY COMMANDS"
27931 #. type: Labeled list
27932 #: ../sys-utils/irqtop.1.adoc:47
27937 #. type: Plain text
27938 #: ../sys-utils/irqtop.1.adoc:49
27939 msgid "sort by short irq name or number field"
27942 #. type: Plain text
27943 #: ../sys-utils/irqtop.1.adoc:52
27944 msgid "sort by total count of interrupts (the default)"
27947 #. type: Plain text
27948 #: ../sys-utils/irqtop.1.adoc:55
27949 msgid "sort by delta count of interrupts"
27952 #. type: Plain text
27953 #: ../sys-utils/irqtop.1.adoc:58
27954 msgid "sort by long descriptive name field"
27957 #. type: Labeled list
27958 #: ../sys-utils/irqtop.1.adoc:59
27963 #. type: Plain text
27964 #: ../sys-utils/irqtop.1.adoc:61
27965 msgid "stop updates and exit program"
27968 #. type: Plain text
27969 #: ../sys-utils/irqtop.1.adoc:67 ../sys-utils/lsirq.1.adoc:50
27971 "mailto:pizhenwei@bytedance.com[Zhenwei Pi], mailto:kerolasa@iki.fi[Sami "
27972 "Kerola], mailto:kzak@redhat.com[Karel Zak]"
27975 #. Copyright 2008 Tilman Schmidt (tilman@imap.cc)
27976 #. May be distributed under the GNU General Public License version 2 or later
27978 #: ../sys-utils/ldattach.8.adoc:6
27980 msgid "ldattach(8)"
27983 #. type: Plain text
27984 #: ../sys-utils/ldattach.8.adoc:16
27985 msgid "ldattach - attach a line discipline to a serial line"
27988 #. type: Plain text
27989 #: ../sys-utils/ldattach.8.adoc:20
27991 msgid "*ldattach* [*-1278denoVh*] [*-i* _iflag_] [*-s* _speed_] _ldisc device_\n"
27994 #. type: Plain text
27995 #: ../sys-utils/ldattach.8.adoc:24
27997 "The *ldattach* daemon opens the specified _device_ file (which should refer "
27998 "to a serial device) and attaches the line discipline _ldisc_ to it for "
27999 "processing of the sent and/or received data. It then goes into the "
28000 "background keeping the device open so that the line discipline stays loaded."
28003 #. type: Plain text
28004 #: ../sys-utils/ldattach.8.adoc:26
28006 "The line discipline _ldisc_ may be specified either by name or by number."
28009 #. type: Plain text
28010 #: ../sys-utils/ldattach.8.adoc:28
28012 "In order to detach the line discipline, *kill*(1) the *ldattach* process."
28015 #. type: Plain text
28016 #: ../sys-utils/ldattach.8.adoc:30
28017 msgid "With no arguments, *ldattach* prints usage information."
28021 #: ../sys-utils/ldattach.8.adoc:31
28023 msgid "LINE DISCIPLINES"
28026 #. type: Plain text
28027 #: ../sys-utils/ldattach.8.adoc:34
28029 "Depending on the kernel release, the following line disciplines are "
28033 #. type: Labeled list
28034 #: ../sys-utils/ldattach.8.adoc:35
28039 #. type: Plain text
28040 #: ../sys-utils/ldattach.8.adoc:37
28042 "The default line discipline, providing transparent operation (raw mode) as "
28043 "well as the habitual terminal line editing capabilities (cooked mode)."
28046 #. type: Labeled list
28047 #: ../sys-utils/ldattach.8.adoc:38
28049 msgid "*SLIP*(*1*)"
28052 #. type: Plain text
28053 #: ../sys-utils/ldattach.8.adoc:40
28055 "Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets "
28056 "over serial lines."
28059 #. type: Labeled list
28060 #: ../sys-utils/ldattach.8.adoc:41
28062 msgid "*MOUSE*(*2*)"
28065 #. type: Plain text
28066 #: ../sys-utils/ldattach.8.adoc:43
28067 msgid "Device driver for RS232 connected pointing devices (serial mice)."
28070 #. type: Labeled list
28071 #: ../sys-utils/ldattach.8.adoc:44
28076 #. type: Plain text
28077 #: ../sys-utils/ldattach.8.adoc:46
28079 "Point to Point Protocol (PPP) processor for transmitting network packets "
28080 "over serial lines."
28083 #. type: Labeled list
28084 #: ../sys-utils/ldattach.8.adoc:47
28086 msgid "*STRIP*(*4*); *AX25*(*5*); *X25*(*6*)"
28089 #. type: Plain text
28090 #: ../sys-utils/ldattach.8.adoc:49
28092 "Line driver for transmitting X.25 packets over asynchronous serial lines."
28095 #. type: Labeled list
28096 #: ../sys-utils/ldattach.8.adoc:50
28098 msgid "*6PACK*(*7*); *R3964*(*9*)"
28101 #. type: Plain text
28102 #: ../sys-utils/ldattach.8.adoc:52
28103 msgid "Driver for Simatic R3964 module."
28106 #. type: Labeled list
28107 #: ../sys-utils/ldattach.8.adoc:53
28109 msgid "*IRDA*(*11*)"
28112 #. type: Plain text
28113 #: ../sys-utils/ldattach.8.adoc:55
28115 "Linux IrDa (infrared data transmission) driver - see http://irda.sourceforge."
28119 #. type: Labeled list
28120 #: ../sys-utils/ldattach.8.adoc:56
28122 msgid "*HDLC*(*13*)"
28125 #. type: Plain text
28126 #: ../sys-utils/ldattach.8.adoc:58
28127 msgid "Synchronous HDLC driver."
28130 #. type: Labeled list
28131 #: ../sys-utils/ldattach.8.adoc:59
28133 msgid "*SYNC_PPP*(*14*)"
28136 #. type: Plain text
28137 #: ../sys-utils/ldattach.8.adoc:61
28138 msgid "Synchronous PPP driver."
28141 #. type: Labeled list
28142 #: ../sys-utils/ldattach.8.adoc:62
28144 msgid "*HCI*(*15*)"
28147 #. type: Plain text
28148 #: ../sys-utils/ldattach.8.adoc:64
28149 msgid "Bluetooth HCI UART driver."
28152 #. type: Labeled list
28153 #: ../sys-utils/ldattach.8.adoc:65
28155 msgid "*GIGASET_M101*(*16*)"
28158 #. type: Plain text
28159 #: ../sys-utils/ldattach.8.adoc:67
28160 msgid "Driver for Siemens Gigaset M101 serial DECT adapter."
28163 #. type: Labeled list
28164 #: ../sys-utils/ldattach.8.adoc:68
28166 msgid "*PPS*(*18*)"
28169 #. type: Plain text
28170 #: ../sys-utils/ldattach.8.adoc:70
28171 msgid "Driver for serial line Pulse Per Second (PPS) source."
28174 #. type: Labeled list
28175 #: ../sys-utils/ldattach.8.adoc:71
28177 msgid "*GSM0710*(*21*)"
28180 #. type: Plain text
28181 #: ../sys-utils/ldattach.8.adoc:73
28182 msgid "Driver for GSM 07.10 multiplexing protocol modem (CMUX)."
28185 #. type: Labeled list
28186 #: ../sys-utils/ldattach.8.adoc:76
28188 #| msgid "*-P*, *--pty*"
28189 msgid "*-1*, *--onestopbit*"
28190 msgstr "*-P*, *--pty*"
28192 #. type: Plain text
28193 #: ../sys-utils/ldattach.8.adoc:78
28194 msgid "Set the number of stop bits of the serial line to one."
28197 #. type: Labeled list
28198 #: ../sys-utils/ldattach.8.adoc:79
28200 #| msgid "*-P*, *--pty*"
28201 msgid "*-2*, *--twostopbits*"
28202 msgstr "*-P*, *--pty*"
28204 #. type: Plain text
28205 #: ../sys-utils/ldattach.8.adoc:81
28206 msgid "Set the number of stop bits of the serial line to two."
28209 #. type: Labeled list
28210 #: ../sys-utils/ldattach.8.adoc:82
28212 #| msgid "*-V*, *--version*"
28213 msgid "*-7*, *--sevenbits*"
28214 msgstr "*-V*, *--version*"
28216 #. type: Plain text
28217 #: ../sys-utils/ldattach.8.adoc:84
28218 msgid "Set the character size of the serial line to 7 bits."
28221 #. type: Labeled list
28222 #: ../sys-utils/ldattach.8.adoc:85
28224 #| msgid "*-P*, *--pty*"
28225 msgid "*-8*, *--eightbits*"
28226 msgstr "*-P*, *--pty*"
28228 #. type: Plain text
28229 #: ../sys-utils/ldattach.8.adoc:87
28230 msgid "Set the character size of the serial line to 8 bits."
28233 #. type: Plain text
28234 #: ../sys-utils/ldattach.8.adoc:90
28236 "Keep *ldattach* in the foreground so that it can be interrupted or debugged, "
28237 "and to print verbose messages about its progress to standard error output."
28240 #. type: Labeled list
28241 #: ../sys-utils/ldattach.8.adoc:91
28243 #| msgid "*-P*, *--pty*"
28244 msgid "*-e*, *--evenparity*"
28245 msgstr "*-P*, *--pty*"
28247 #. type: Plain text
28248 #: ../sys-utils/ldattach.8.adoc:93
28249 msgid "Set the parity of the serial line to even."
28252 #. type: Labeled list
28253 #: ../sys-utils/ldattach.8.adoc:94
28255 msgid "*-i*, *--iflag* [*-*]_value_..."
28258 #. type: Plain text
28259 #: ../sys-utils/ldattach.8.adoc:96
28261 "Set the specified bits in the c_iflag word of the serial line. The given "
28262 "_value_ may be a number or a symbolic name. If _value_ is prefixed by a "
28263 "minus sign, the specified bits are cleared instead. Several comma-separated "
28264 "values may be given in order to set and clear multiple bits."
28267 #. type: Labeled list
28268 #: ../sys-utils/ldattach.8.adoc:97
28270 #| msgid "*-P*, *--pty*"
28271 msgid "*-n*, *--noparity*"
28272 msgstr "*-P*, *--pty*"
28274 #. type: Plain text
28275 #: ../sys-utils/ldattach.8.adoc:99
28276 msgid "Set the parity of the serial line to none."
28279 #. type: Labeled list
28280 #: ../sys-utils/ldattach.8.adoc:100
28282 #| msgid "*-P*, *--pty*"
28283 msgid "*-o*, *--oddparity*"
28284 msgstr "*-P*, *--pty*"
28286 #. type: Plain text
28287 #: ../sys-utils/ldattach.8.adoc:102
28288 msgid "Set the parity of the serial line to odd."
28291 #. type: Labeled list
28292 #: ../sys-utils/ldattach.8.adoc:103
28294 #| msgid "*-s*, **--shell**=__shell__"
28295 msgid "*-s*, *--speed* _value_"
28296 msgstr "*-s*, **--shell**=__shell__"
28298 #. type: Plain text
28299 #: ../sys-utils/ldattach.8.adoc:105
28301 "Set the speed (the baud rate) of the serial line to the specified _value_."
28304 #. type: Labeled list
28305 #: ../sys-utils/ldattach.8.adoc:106
28307 #| msgid "*-c*, **--command**=__command__"
28308 msgid "*-c*, *--intro-command* _string_"
28309 msgstr "*-c*, **--command**=__příkaz__"
28311 #. type: Plain text
28312 #: ../sys-utils/ldattach.8.adoc:108
28314 "Define an intro command that is sent through the serial line before the "
28315 "invocation of *ldattach*. E.g. in conjunction with line discipline GSM0710, "
28316 "the command 'AT+CMUX=0\\r' is commonly suitable to switch the modem into the "
28320 #. type: Labeled list
28321 #: ../sys-utils/ldattach.8.adoc:109
28323 msgid "*-p*, *--pause* _value_"
28326 #. type: Plain text
28327 #: ../sys-utils/ldattach.8.adoc:111
28329 "Sleep for _value_ seconds before the invocation of *ldattach*. Default is "
28333 #. type: Plain text
28334 #: ../sys-utils/ldattach.8.adoc:117
28335 msgid "mailto:tilman@imap.cc[Tilman Schmidt]"
28338 #. type: Plain text
28339 #: ../sys-utils/ldattach.8.adoc:122
28342 "*inputattach*(1),\n"
28347 #: ../sys-utils/losetup.8.adoc:2
28352 #. type: Plain text
28353 #: ../sys-utils/losetup.8.adoc:12
28354 msgid "losetup - set up and control loop devices"
28357 #. type: Plain text
28358 #: ../sys-utils/losetup.8.adoc:16
28362 #. type: Plain text
28363 #: ../sys-utils/losetup.8.adoc:18
28365 msgid "*losetup* [_loopdev_]\n"
28368 #. type: Plain text
28369 #: ../sys-utils/losetup.8.adoc:20
28371 msgid "*losetup* *-l* [*-a*]\n"
28374 #. type: Plain text
28375 #: ../sys-utils/losetup.8.adoc:22
28377 msgid "*losetup* *-j* _file_ [*-o* _offset_]\n"
28380 #. type: Plain text
28381 #: ../sys-utils/losetup.8.adoc:24
28382 msgid "Detach a loop device:"
28385 #. type: Plain text
28386 #: ../sys-utils/losetup.8.adoc:26
28388 msgid "*losetup* *-d* _loopdev_ ...\n"
28391 #. type: Plain text
28392 #: ../sys-utils/losetup.8.adoc:28
28393 msgid "Detach all associated loop devices:"
28396 #. type: Plain text
28397 #: ../sys-utils/losetup.8.adoc:30
28399 msgid "*losetup* *-D*\n"
28402 #. type: Plain text
28403 #: ../sys-utils/losetup.8.adoc:32
28404 msgid "Set up a loop device:"
28407 #. type: Plain text
28408 #: ../sys-utils/losetup.8.adoc:34
28410 msgid "*losetup* [*-o* _offset_] [*--sizelimit* _size_] [*--sector-size* _size_] [*--loop-ref* _name_] [*-Pr*] [*--show*] *-f*|_loopdev file_\n"
28413 #. type: Plain text
28414 #: ../sys-utils/losetup.8.adoc:36
28415 msgid "Resize a loop device:"
28418 #. type: Plain text
28419 #: ../sys-utils/losetup.8.adoc:38
28421 msgid "*losetup* *-c* _loopdev_\n"
28424 #. type: Plain text
28425 #: ../sys-utils/losetup.8.adoc:42
28427 msgid "*losetup* is used to associate loop devices with regular files or block devices, to detach loop devices, and to query the status of a loop device. If only the _loopdev_ argument is given, the status of the corresponding loop device is shown. If no option is given, all loop devices are shown.\n"
28430 #. type: Plain text
28431 #: ../sys-utils/losetup.8.adoc:44
28433 "Note that the old output format (i.e., *losetup -a*) with comma-delimited "
28434 "strings is deprecated in favour of the *--list* output format."
28437 #. type: Plain text
28438 #: ../sys-utils/losetup.8.adoc:46
28440 "It's possible to create more independent loop devices for the same backing "
28441 "file. *This setup may be dangerous, can cause data loss, corruption and "
28442 "overwrites.* Use *--nooverlap* with *--find* during setup to avoid this "
28446 #. type: Plain text
28447 #: ../sys-utils/losetup.8.adoc:48
28449 "The loop device setup is not an atomic operation when used with *--find*, "
28450 "and *losetup* does not protect this operation by any lock. The number of "
28451 "attempts is internally restricted to a maximum of 16. It is recommended to "
28452 "use for example *flock*(1) to avoid a collision in heavily parallel use "
28456 #. type: Plain text
28457 #: ../sys-utils/losetup.8.adoc:52
28459 "The _size_ and _offset_ arguments may be followed by the multiplicative "
28460 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
28461 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
28462 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
28463 "PB, EB, ZB and YB."
28466 #. type: Plain text
28467 #: ../sys-utils/losetup.8.adoc:55
28469 "Show the status of all loop devices. Note that not all information is "
28470 "accessible for non-root users. See also *--list*. The old output format (as "
28471 "printed without *--list*) is deprecated."
28474 #. type: Labeled list
28475 #: ../sys-utils/losetup.8.adoc:56
28477 msgid "*-d*, *--detach* _loopdev_..."
28480 #. type: Plain text
28481 #: ../sys-utils/losetup.8.adoc:58
28483 "Detach the file or device associated with the specified loop device(s). Note "
28484 "that since Linux v3.7 kernel uses \"lazy device destruction\". The detach "
28485 "operation does not return *EBUSY* error anymore if device is actively used "
28486 "by system, but it is marked by autoclear flag and destroyed later."
28489 #. type: Labeled list
28490 #: ../sys-utils/losetup.8.adoc:59
28492 #| msgid "*-h*, *--help*"
28493 msgid "*-D*, *--detach-all*"
28494 msgstr "*-h*, *--help*"
28496 #. type: Plain text
28497 #: ../sys-utils/losetup.8.adoc:61
28498 msgid "Detach all associated loop devices."
28501 #. type: Labeled list
28502 #: ../sys-utils/losetup.8.adoc:62
28504 msgid "*-f*, *--find* [_file_]"
28507 #. type: Plain text
28508 #: ../sys-utils/losetup.8.adoc:64
28510 "Find the first unused loop device. If a _file_ argument is present, use the "
28511 "found device as loop device. Otherwise, just print its name."
28514 #. type: Labeled list
28515 #: ../sys-utils/losetup.8.adoc:65
28520 #. type: Plain text
28521 #: ../sys-utils/losetup.8.adoc:67
28523 "Display the name of the assigned loop device if the *-f* option and a _file_ "
28524 "argument are present."
28527 #. type: Labeled list
28528 #: ../sys-utils/losetup.8.adoc:68
28530 #| msgid "*-h*, *--help*"
28531 msgid "*-L*, *--nooverlap*"
28532 msgstr "*-h*, *--help*"
28534 #. type: Plain text
28535 #: ../sys-utils/losetup.8.adoc:70
28537 "Check for conflicts between loop devices to avoid situation when the same "
28538 "backing file is shared between more loop devices. If the file is already "
28539 "used by another device then re-use the device rather than a new one. The "
28540 "option makes sense only with *--find*."
28543 #. type: Labeled list
28544 #: ../sys-utils/losetup.8.adoc:71
28546 msgid "*-j*, *--associated* _file_ [*-o* _offset_]"
28549 #. type: Plain text
28550 #: ../sys-utils/losetup.8.adoc:73
28551 msgid "Show the status of all loop devices associated with the given _file_."
28554 #. type: Plain text
28555 #: ../sys-utils/losetup.8.adoc:76
28557 "The data start is moved _offset_ bytes into the specified file or device. "
28558 "The _offset_ may be followed by the multiplicative suffixes; see above."
28561 #. type: Labeled list
28562 #: ../sys-utils/losetup.8.adoc:77
28564 msgid "*--loop-ref* _string_"
28567 #. type: Plain text
28568 #: ../sys-utils/losetup.8.adoc:79
28570 "Set reference string. The backwardly compatible default is to use the "
28571 "backing filename as a reference in loop setup ioctl (aka lo_file_name). This "
28572 "option can overwrite this default behavior and set the reference to the "
28573 "_string_. The reference may be used by udevd in /dev/loop/by-ref. Linux "
28574 "kernel does not use the reference at all, but it could be used by some old "
28575 "utils that cannot read the backing file from sysfs. The reference is "
28576 "readable only for the root user (see *--output* +REF) and it is restricted "
28580 #. type: Labeled list
28581 #: ../sys-utils/losetup.8.adoc:80
28583 msgid "*--sizelimit* _size_"
28586 #. type: Plain text
28587 #: ../sys-utils/losetup.8.adoc:82
28589 "The data end is set to no more than _size_ bytes after the data start. The "
28590 "_size_ may be followed by the multiplicative suffixes; see above."
28593 #. type: Labeled list
28594 #: ../sys-utils/losetup.8.adoc:83
28596 msgid "*-b*, *--sector-size* _size_"
28599 #. type: Plain text
28600 #: ../sys-utils/losetup.8.adoc:85
28602 "Set the logical sector size of the loop device in bytes (since Linux 4.14). "
28603 "The option may be used when creating a new loop device as well as a stand-"
28604 "alone command to modify sector size of the already existing loop device."
28607 #. type: Labeled list
28608 #: ../sys-utils/losetup.8.adoc:86
28610 msgid "*-c*, *--set-capacity* _loopdev_"
28613 #. type: Plain text
28614 #: ../sys-utils/losetup.8.adoc:88
28616 "Force the loop driver to reread the size of the file associated with the "
28617 "specified loop device."
28620 #. type: Labeled list
28621 #: ../sys-utils/losetup.8.adoc:89
28623 #| msgid "*-P*, *--pty*"
28624 msgid "*-P*, *--partscan*"
28625 msgstr "*-P*, *--pty*"
28627 #. type: Plain text
28628 #: ../sys-utils/losetup.8.adoc:91
28630 "Force the kernel to scan the partition table on a newly created loop device. "
28631 "Note that the partition table parsing depends on sector sizes. The default "
28632 "is sector size is 512 bytes, otherwise you need to use the option *--sector-"
28633 "size* together with *--partscan*."
28636 #. type: Plain text
28637 #: ../sys-utils/losetup.8.adoc:94
28638 msgid "Set up a read-only loop device."
28641 #. type: Labeled list
28642 #: ../sys-utils/losetup.8.adoc:95
28644 msgid "*--direct-io*[**=on**|*off*]"
28647 #. type: Plain text
28648 #: ../sys-utils/losetup.8.adoc:97
28650 "Enable or disable direct I/O for the backing file. The optional argument can "
28651 "be either *on* or *off*. If the optional argument is omitted, it defaults to "
28655 #. type: Plain text
28656 #: ../sys-utils/losetup.8.adoc:103
28658 "If a loop device or the *-a* option is specified, print the default columns "
28659 "for either the specified loop device or all loop devices; the default is to "
28660 "print info about all devices. See also *--output*, *--noheadings*, *--raw*, "
28664 #. type: Labeled list
28665 #: ../sys-utils/losetup.8.adoc:104
28667 msgid "*-O*, *--output* _column_[,_column_]..."
28670 #. type: Plain text
28671 #: ../sys-utils/losetup.8.adoc:106
28673 "Specify the columns that are to be printed for the *--list* output. Use *--"
28674 "help* to get a list of all supported columns."
28677 #. type: Plain text
28678 #: ../sys-utils/losetup.8.adoc:112
28679 msgid "Don't print headings for *--list* output format."
28682 #. type: Labeled list
28683 #: ../sys-utils/losetup.8.adoc:113 ../sys-utils/prlimit.1.adoc:52
28684 #: ../sys-utils/swapon.8.adoc:80 ../sys-utils/zramctl.8.adoc:58
28689 #. type: Plain text
28690 #: ../sys-utils/losetup.8.adoc:115
28691 msgid "Use the raw *--list* output format."
28694 #. type: Plain text
28695 #: ../sys-utils/losetup.8.adoc:118
28696 msgid "Use JSON format for *--list* output."
28700 #: ../sys-utils/losetup.8.adoc:119
28702 #| msgid "DESCRIPTION"
28706 #. type: Plain text
28707 #: ../sys-utils/losetup.8.adoc:122
28709 msgid "*Cryptoloop is no longer supported in favor of dm-crypt.* For more details see *cryptsetup*(8).\n"
28712 #. type: Plain text
28713 #: ../sys-utils/losetup.8.adoc:126
28715 msgid "*losetup* returns 0 on success, nonzero on failure. When *losetup* displays the status of a loop device, it returns 1 if the device is not configured and 2 if an error occurred which prevented determining the status of the device.\n"
28718 #. type: Plain text
28719 #: ../sys-utils/losetup.8.adoc:130
28721 "Since version 2.37 *losetup* uses *LOOP_CONFIGURE* ioctl to setup a new loop "
28722 "device by one ioctl call. The old versions use *LOOP_SET_FD* and "
28723 "*LOOP_SET_STATUS64* ioctls to do the same."
28726 #. type: Labeled list
28727 #: ../sys-utils/losetup.8.adoc:133 ../sys-utils/mount.8.adoc:1641
28729 msgid "*LOOPDEV_DEBUG*=all"
28732 #. type: Labeled list
28733 #: ../sys-utils/losetup.8.adoc:138
28735 msgid "_/dev/loop[0..N]_"
28738 #. type: Plain text
28739 #: ../sys-utils/losetup.8.adoc:140
28740 msgid "loop block devices"
28743 #. type: Labeled list
28744 #: ../sys-utils/losetup.8.adoc:141
28746 msgid "_/dev/loop-control_"
28749 #. type: Plain text
28750 #: ../sys-utils/losetup.8.adoc:143
28751 msgid "loop control device"
28754 #. type: Plain text
28755 #: ../sys-utils/losetup.8.adoc:147
28757 "The following commands can be used as an example of using the loop device."
28760 #. type: Plain text
28761 #: ../sys-utils/losetup.8.adoc:156
28764 " # dd if=/dev/zero of=~/file.img bs=1024k count=10\n"
28765 " # losetup --find --show ~/file.img\n"
28767 " # mkfs -t ext2 /dev/loop0\n"
28768 " # mount /dev/loop0 /mnt\n"
28770 " # umount /dev/loop0\n"
28771 " # losetup --detach /dev/loop0\n"
28774 #. type: Plain text
28775 #: ../sys-utils/losetup.8.adoc:160
28777 "mailto:kzak@redhat.com[Karel Zak], based on the original version from mailto:"
28778 "tytso@athena.mit.edu[Theodore Ts'o]."
28782 #: ../sys-utils/lscpu.1.adoc:2
28788 #. type: Plain text
28789 #: ../sys-utils/lscpu.1.adoc:12
28791 #| msgid "fstab - static information about the filesystems"
28792 msgid "lscpu - display information about the CPU architecture"
28793 msgstr "fstab - statická informace o souborových systémech"
28795 #. type: Plain text
28796 #: ../sys-utils/lscpu.1.adoc:16
28798 msgid "*lscpu* [options]\n"
28801 #. type: Plain text
28802 #: ../sys-utils/lscpu.1.adoc:20
28804 msgid "*lscpu* gathers CPU architecture information from _sysfs_, _/proc/cpuinfo_ and any applicable architecture-specific libraries (e.g. *librtas* on Powerpc). The command output can be optimized for parsing or for easy readability by humans. The information includes, for example, the number of CPUs, threads, cores, sockets, and Non-Uniform Memory Access (NUMA) nodes. There is also information about the CPU caches and cache sharing, family, model, bogoMIPS, byte order, and stepping.\n"
28807 #. type: Plain text
28808 #: ../sys-utils/lscpu.1.adoc:22
28810 "The default output formatting on terminal is subject to change and maybe "
28811 "optimized for better readability. The output for non-terminals (e.g., pipes) "
28812 "is never affected by this optimization and it is always in \"Field: "
28813 "data\\n\" format. Use for example \"*lscpu | less*\" to see the default "
28814 "output without optimizations."
28817 #. type: Plain text
28818 #: ../sys-utils/lscpu.1.adoc:24
28820 "In virtualized environments, the CPU architecture information displayed "
28821 "reflects the configuration of the guest operating system which is typically "
28822 "different from the physical (host) system. On architectures that support "
28823 "retrieving physical topology information, *lscpu* also displays the number "
28824 "of physical sockets, chips, cores in the host system."
28827 #. type: Plain text
28828 #: ../sys-utils/lscpu.1.adoc:26
28830 "Options that result in an output table have a _list_ argument. Use this "
28831 "argument to customize the command output. Specify a comma-separated list of "
28832 "column labels to limit the output table to only the specified columns, "
28833 "arranged in the specified order. See *COLUMNS* for a list of valid column "
28834 "labels. The column labels are not case sensitive."
28837 #. type: Plain text
28838 #: ../sys-utils/lscpu.1.adoc:28
28840 "Not all columns are supported on all architectures. If an unsupported column "
28841 "is specified, *lscpu* prints the column but does not provide any data for it."
28844 #. type: Plain text
28845 #: ../sys-utils/lscpu.1.adoc:30
28847 "The cache sizes are reported as summary from all CPUs. The versions before "
28848 "v2.34 reported per-core sizes, but this output was confusing due to "
28849 "complicated CPUs topology and the way how caches are shared between CPUs. "
28850 "For more details about caches see *--cache*. Since version v2.37 *lscpu* "
28851 "follows cache IDs as provided by Linux kernel and it does not always start "
28855 #. type: Plain text
28856 #: ../sys-utils/lscpu.1.adoc:35
28858 "Include lines for online and offline CPUs in the output (default for *-e*). "
28859 "This option may only be specified together with option *-e* or *-p*."
28862 #. type: Labeled list
28863 #: ../sys-utils/lscpu.1.adoc:36
28865 #| msgid "*-P*, *--pty*"
28866 msgid "*-B*, *--bytes*"
28867 msgstr "*-P*, *--pty*"
28869 #. type: Labeled list
28870 #: ../sys-utils/lscpu.1.adoc:39
28872 #| msgid "*-h*, *--help*"
28873 msgid "*-b*, *--online*"
28874 msgstr "*-h*, *--help*"
28876 #. type: Plain text
28877 #: ../sys-utils/lscpu.1.adoc:41
28879 "Limit the output to online CPUs (default for *-p*). This option may only be "
28880 "specified together with option *-e* or *-p*."
28883 #. type: Labeled list
28884 #: ../sys-utils/lscpu.1.adoc:42
28886 msgid "*-C*, *--caches*[=_list_]"
28889 #. type: Plain text
28890 #: ../sys-utils/lscpu.1.adoc:44
28892 "Display details about CPU caches. For details about available information "
28893 "see *--help* output."
28896 #. type: Plain text
28897 #: ../sys-utils/lscpu.1.adoc:46
28899 "If the _list_ argument is omitted, all columns for which data is available "
28900 "are included in the command output."
28903 #. type: Plain text
28904 #: ../sys-utils/lscpu.1.adoc:48
28906 "When specifying the _list_ argument, the string of option, equal sign (=), "
28907 "and _list_ must not contain any blanks or other whitespace. Examples: *-"
28908 "C=NAME,ONE-SIZE* or *--caches=NAME,ONE-SIZE*."
28911 #. type: Plain text
28912 #: ../sys-utils/lscpu.1.adoc:50
28914 "The default list of columns may be extended if list is specified in the "
28915 "format +list (e.g., **lscpu -C=+ALLOC-POLICY**)."
28918 #. type: Labeled list
28919 #: ../sys-utils/lscpu.1.adoc:51
28921 #| msgid "*-*, *-l*, *--login*"
28922 msgid "*-c*, *--offline*"
28923 msgstr "*-*, *-l*, *--login*"
28925 #. type: Plain text
28926 #: ../sys-utils/lscpu.1.adoc:53
28928 "Limit the output to offline CPUs. This option may only be specified together "
28929 "with option *-e* or *-p*."
28932 #. type: Labeled list
28933 #: ../sys-utils/lscpu.1.adoc:54
28935 msgid "*--hierarchic*[=_when_]"
28938 #. type: Plain text
28939 #: ../sys-utils/lscpu.1.adoc:56
28941 "Use subsections in summary output. For backward compatibility, the default "
28942 "is to use subsections only when output on a terminal and flattened output on "
28943 "a non-terminal. The optional argument _when_ can be *never*, *always* or "
28944 "*auto*. If the _when_ argument is omitted, it defaults to \"always\"."
28947 #. type: Labeled list
28948 #: ../sys-utils/lscpu.1.adoc:57
28950 #| msgid "*-w*, **--whitelist-environment**=__list__"
28951 msgid "*-e*, *--extended*[=_list_]"
28952 msgstr "*-w*, **--whitelist-environment**=__seznam__"
28954 #. type: Plain text
28955 #: ../sys-utils/lscpu.1.adoc:59
28957 #| msgid "Print the sizes in bytes rather than in a human-readable format."
28958 msgid "Display the CPU information in human-readable format."
28959 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
28961 #. type: Plain text
28962 #: ../sys-utils/lscpu.1.adoc:61
28964 "If the _list_ argument is omitted, the default columns are included in the "
28965 "command output. The default output is subject to change."
28968 #. type: Plain text
28969 #: ../sys-utils/lscpu.1.adoc:63
28971 "When specifying the _list_ argument, the string of option, equal sign (=), "
28972 "and _list_ must not contain any blanks or other whitespace. Examples: '*-"
28973 "e=cpu,node*' or '*--extended=cpu,node*'."
28976 #. type: Plain text
28977 #: ../sys-utils/lscpu.1.adoc:65
28979 "The default list of columns may be extended if list is specified in the "
28980 "format +list (e.g., lscpu -e=+MHZ)."
28983 #. type: Plain text
28984 #: ../sys-utils/lscpu.1.adoc:71
28986 "Use JSON output format for the default summary or extended output (see *--"
28987 "extended*). For backward compatibility, JSON output follows the default "
28988 "summary behavior for non-terminals (e.g., pipes) where subsections are "
28989 "missing. See also *--hierarchic*."
28992 #. type: Labeled list
28993 #: ../sys-utils/lscpu.1.adoc:72
28995 msgid "*-p*, *--parse*[=_list_]"
28998 #. type: Plain text
28999 #: ../sys-utils/lscpu.1.adoc:74
29000 msgid "Optimize the command output for easy parsing."
29003 #. type: Plain text
29004 #: ../sys-utils/lscpu.1.adoc:76
29006 "If the _list_ argument is omitted, the command output is compatible with "
29007 "earlier versions of *lscpu*. In this compatible format, two commas are used "
29008 "to separate CPU cache columns. If no CPU caches are identified the cache "
29009 "column is omitted. If the _list_ argument is used, cache columns are "
29010 "separated with a colon (:)."
29013 #. type: Plain text
29014 #: ../sys-utils/lscpu.1.adoc:78
29016 "When specifying the _list_ argument, the string of option, equal sign (=), "
29017 "and _list_ must not contain any blanks or other whitespace. Examples: '*-"
29018 "p=cpu,node*' or '*--parse=cpu,node*'."
29021 #. type: Plain text
29022 #: ../sys-utils/lscpu.1.adoc:80
29024 "The default list of columns may be extended if list is specified in the "
29025 "format +list (e.g., lscpu -p=+MHZ)."
29028 #. type: Labeled list
29029 #: ../sys-utils/lscpu.1.adoc:81 ../sys-utils/lsmem.1.adoc:60
29031 msgid "*-s*, *--sysroot* _directory_"
29034 #. type: Plain text
29035 #: ../sys-utils/lscpu.1.adoc:83
29037 "Gather CPU data for a Linux instance other than the instance from which the "
29038 "*lscpu* command is issued. The specified _directory_ is the system root of "
29039 "the Linux instance to be inspected."
29042 #. type: Plain text
29043 #: ../sys-utils/lscpu.1.adoc:86
29045 "Use hexadecimal masks for CPU sets (for example \"ff\"). The default is to "
29046 "print the sets in list format (for example 0,1). Note that before version "
29047 "2.30 the mask has been printed with 0x prefix."
29050 #. type: Labeled list
29051 #: ../sys-utils/lscpu.1.adoc:87
29053 #| msgid "*-P*, *--pty*"
29054 msgid "*-y*, *--physical*"
29055 msgstr "*-P*, *--pty*"
29057 #. type: Plain text
29058 #: ../sys-utils/lscpu.1.adoc:89
29060 "Display physical IDs for all columns with topology elements (core, socket, "
29061 "etc.). Other than logical IDs, which are assigned by *lscpu*, physical IDs "
29062 "are platform-specific values that are provided by the kernel. Physical IDs "
29063 "are not necessarily unique and they might not be arranged sequentially. If "
29064 "the kernel could not retrieve a physical ID for an element *lscpu* prints "
29065 "the dash (-) character."
29068 #. type: Plain text
29069 #: ../sys-utils/lscpu.1.adoc:91
29070 msgid "The CPU logical numbers are not affected by this option."
29073 #. type: Plain text
29074 #: ../sys-utils/lscpu.1.adoc:94
29076 "Output all available columns. This option must be combined with either *--"
29077 "extended*, *--parse* or *--caches*."
29080 #. type: Plain text
29081 #: ../sys-utils/lscpu.1.adoc:98
29083 "The basic overview of CPU family, model, etc. is always based on the first "
29087 #. type: Plain text
29088 #: ../sys-utils/lscpu.1.adoc:100
29089 msgid "Sometimes in Xen Dom0 the kernel reports wrong data."
29092 #. type: Plain text
29093 #: ../sys-utils/lscpu.1.adoc:102
29094 msgid "On virtual hardware the number of cores per socket, etc. can be wrong."
29097 #. type: Plain text
29098 #: ../sys-utils/lscpu.1.adoc:108
29100 "mailto:qcai@redhat.com[Cai Qian], mailto:kzak@redhat.com[Karel Zak], mailto:"
29101 "heiko.carstens@de.ibm.com[Heiko Carstens]"
29104 #. type: Plain text
29105 #: ../sys-utils/lscpu.1.adoc:112
29107 msgid "*chcpu*(8)\n"
29111 #: ../sys-utils/lsipc.1.adoc:2
29116 #. type: Plain text
29117 #: ../sys-utils/lsipc.1.adoc:12
29119 "lsipc - show information on IPC facilities currently employed in the system"
29122 #. type: Plain text
29123 #: ../sys-utils/lsipc.1.adoc:16
29125 msgid "*lsipc* [options]\n"
29128 #. type: Plain text
29129 #: ../sys-utils/lsipc.1.adoc:20
29131 msgid "*lsipc* shows information on the System V inter-process communication facilities for which the calling process has read access.\n"
29134 #. type: Plain text
29135 #: ../sys-utils/lsipc.1.adoc:25
29137 "Show full details on just the one resource element identified by _id_. This "
29138 "option needs to be combined with one of the three resource options: *-m*, *-"
29139 "q* or *-s*. It is possible to override the default output format for this "
29140 "option with the *--list*, *--raw*, *--json* or *--export* option."
29143 #. type: Labeled list
29144 #: ../sys-utils/lsipc.1.adoc:26
29146 #| msgid "*-h*, *--help*"
29147 msgid "*-g*, *--global*"
29148 msgstr "*-h*, *--help*"
29150 #. type: Plain text
29151 #: ../sys-utils/lsipc.1.adoc:28
29153 "Show system-wide usage and limits of IPC resources. This option may be "
29154 "combined with one of the three resource options: *-m*, *-q* or *-s*. The "
29155 "default is to show information about all resources."
29159 #: ../sys-utils/lsipc.1.adoc:42
29161 msgid "Output formatting"
29164 #. type: Plain text
29165 #: ../sys-utils/lsipc.1.adoc:52
29166 msgid "Use the JSON output format."
29169 #. type: Plain text
29170 #: ../sys-utils/lsipc.1.adoc:55
29172 "Use the list output format. This is the default, except when *--id* is used."
29175 #. type: Plain text
29176 #: ../sys-utils/lsipc.1.adoc:70
29178 #| msgid "Print the sizes in bytes rather than in a human-readable format."
29179 msgid "Print size in bytes rather than in human readable format."
29180 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
29182 #. type: Labeled list
29183 #: ../sys-utils/lsipc.1.adoc:80
29185 #| msgid "*-P*, *--pty*"
29186 msgid "*-P*, *--numeric-perms*"
29187 msgstr "*-P*, *--pty*"
29189 #. type: Plain text
29190 #: ../sys-utils/lsipc.1.adoc:82
29191 msgid "Print numeric permissions in PERMS column."
29194 #. type: Plain text
29195 #: ../sys-utils/lsipc.1.adoc:96
29196 msgid "if a serious error occurs."
29199 #. type: Plain text
29200 #: ../sys-utils/lsipc.1.adoc:100
29201 msgid "The *lsipc* utility is inspired by the *ipcs*(1) utility."
29205 #: ../sys-utils/lsirq.1.adoc:2
29210 #. type: Plain text
29211 #: ../sys-utils/lsirq.1.adoc:12
29212 msgid "lsirq - utility to display kernel interrupt information"
29215 #. type: Plain text
29216 #: ../sys-utils/lsirq.1.adoc:16
29218 msgid "*lsirq* [options]\n"
29221 #. type: Plain text
29222 #: ../sys-utils/lsirq.1.adoc:20
29223 msgid "Display kernel interrupt counter information."
29226 #. type: Plain text
29227 #: ../sys-utils/lsirq.1.adoc:33
29229 "Specify sort criteria by column name. See *--help* output to get column "
29233 #. type: Plain text
29234 #: ../sys-utils/lsirq.1.adoc:39
29236 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
29237 "characters are hex-escaped (\\x<code>)."
29241 #: ../sys-utils/lsmem.1.adoc:2
29246 #. type: Plain text
29247 #: ../sys-utils/lsmem.1.adoc:12
29248 msgid "lsmem - list the ranges of available memory with their online status"
29251 #. type: Plain text
29252 #: ../sys-utils/lsmem.1.adoc:16
29254 msgid "*lsmem* [options]\n"
29257 #. type: Plain text
29258 #: ../sys-utils/lsmem.1.adoc:20
29260 "The *lsmem* command lists the ranges of available memory with their online "
29261 "status. The listed memory blocks correspond to the memory block "
29262 "representation in sysfs. The command also shows the memory block size and "
29263 "the amount of memory in online and offline state."
29266 #. type: Plain text
29267 #: ../sys-utils/lsmem.1.adoc:22
29269 "The default output is compatible with original implementation from s390-"
29270 "tools, but it's strongly recommended to avoid using default outputs in your "
29271 "scripts. Always explicitly define expected columns by using the *--output* "
29272 "option together with a columns list in environments where a stable output is "
29276 #. type: Plain text
29277 #: ../sys-utils/lsmem.1.adoc:24
29279 "The *lsmem* command lists a new memory range always when the current memory "
29280 "block distinguish from the previous block by some output column. This "
29281 "default behavior is possible to override by the *--split* option (e.g., "
29282 "*lsmem --split=ZONES*). The special word \"none\" may be used to ignore all "
29283 "differences between memory blocks and to create as large as possible "
29284 "continuous ranges. The opposite semantic is *--all* to list individual "
29288 #. type: Plain text
29289 #: ../sys-utils/lsmem.1.adoc:26
29291 "Note that some output columns may provide inaccurate information if a split "
29292 "policy forces *lsmem* to ignore differences in some attributes. For example "
29293 "if you merge removable and non-removable memory blocks to the one range than "
29294 "all the range will be marked as non-removable on *lsmem* output."
29297 #. type: Plain text
29298 #: ../sys-utils/lsmem.1.adoc:28
29300 "Not all columns are supported on all systems. If an unsupported column is "
29301 "specified, *lsmem* prints the column but does not provide any data for it."
29304 #. type: Plain text
29305 #: ../sys-utils/lsmem.1.adoc:30
29306 msgid "Use the *--help* option to see the columns description."
29309 #. type: Plain text
29310 #: ../sys-utils/lsmem.1.adoc:35
29312 "List each individual memory block, instead of combining memory blocks with "
29313 "similar attributes."
29316 #. type: Plain text
29317 #: ../sys-utils/lsmem.1.adoc:47
29319 "Specify which output columns to print. Use *--help* to get a list of all "
29320 "supported columns. The default list of columns may be extended if _list_ is "
29321 "specified in the format **+**__list__ (e.g., *lsmem -o +NODE*)."
29324 #. type: Plain text
29325 #: ../sys-utils/lsmem.1.adoc:53
29327 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
29328 "value characters are hex-escaped (\\x<code>)."
29331 #. type: Labeled list
29332 #: ../sys-utils/lsmem.1.adoc:57
29334 #| msgid "*-P*, *--pty*"
29335 msgid "*-S*, *--split* _list_"
29336 msgstr "*-P*, *--pty*"
29338 #. type: Plain text
29339 #: ../sys-utils/lsmem.1.adoc:59
29341 "Specify which columns (attributes) use to split memory blocks to ranges. The "
29342 "supported columns are STATE, REMOVABLE, NODE and ZONES, or \"none\". The "
29343 "other columns are silently ignored. For more details see *DESCRIPTION* above."
29346 #. type: Plain text
29347 #: ../sys-utils/lsmem.1.adoc:62
29349 "Gather memory data for a Linux instance other than the instance from which "
29350 "the *lsmem* command is issued. The specified _directory_ is the system root "
29351 "of the Linux instance to be inspected."
29354 #. type: Plain text
29355 #: ../sys-utils/lsmem.1.adoc:67
29357 "This option controls summary lines output. The optional argument _when_ can "
29358 "be *never*, *always* or *only*. If the _when_ argument is omitted, it "
29359 "defaults to *\"only\"*. The summary output is suppressed for *--raw*, *--"
29360 "pairs* and *--json*."
29363 #. type: Plain text
29364 #: ../sys-utils/lsmem.1.adoc:71
29366 msgid "*lsmem* was originally written by Gerald Schaefer for s390-tools in Perl. The C version for util-linux was written by Clemens von Mann, Heiko Carstens and Karel Zak.\n"
29369 #. type: Plain text
29370 #: ../sys-utils/lsmem.1.adoc:75
29372 msgid "*chmem*(8)\n"
29375 #. Man page for the lsns command.
29376 #. Copyright 2015 Karel Zak <kzak@redhat.com>
29377 #. May be distributed under the GNU General Public License
29379 #: ../sys-utils/lsns.8.adoc:7
29384 #. type: Plain text
29385 #: ../sys-utils/lsns.8.adoc:17
29386 msgid "lsns - list namespaces"
29389 #. type: Plain text
29390 #: ../sys-utils/lsns.8.adoc:21
29392 msgid "*lsns* [options] _namespace_\n"
29395 #. type: Plain text
29396 #: ../sys-utils/lsns.8.adoc:25
29398 msgid "*lsns* lists information about all the currently accessible namespaces or about the given _namespace_. The _namespace_ identifier is an inode number.\n"
29401 #. type: Plain text
29402 #: ../sys-utils/lsns.8.adoc:27
29404 "The default output is subject to change. So whenever possible, you should "
29405 "avoid using default outputs in your scripts. Always explicitly define "
29406 "expected output mode (*--tree* or *--list*) and columns by using the *--"
29407 "output* option together with a columns list in environments where a stable "
29408 "output is required."
29411 #. type: Plain text
29412 #: ../sys-utils/lsns.8.adoc:29
29414 "The *NSFS* column, printed when *net* is specified for the *--type* option, "
29415 "is special; it uses multi-line cells. Use the option *--nowrap* to switch to "
29416 "\",\"-separated single-line representation."
29419 #. type: Plain text
29420 #: ../sys-utils/lsns.8.adoc:31
29422 "Note that *lsns* reads information directly from the _/proc_ filesystem and "
29423 "for non-root users it may return incomplete information. The current _/proc_ "
29424 "filesystem may be unshared and affected by a PID namespace (see *unshare --"
29425 "mount-proc* for more details). *lsns* is not able to see persistent "
29426 "namespaces without processes where the namespace instance is held by a bind "
29427 "mount to /proc/_pid_/ns/_type_."
29430 #. type: Plain text
29431 #: ../sys-utils/lsns.8.adoc:39
29432 msgid "Use list output format."
29435 #. type: Plain text
29436 #: ../sys-utils/lsns.8.adoc:47
29438 "The default list of columns may be extended if _list_ is specified in the "
29439 "format **+**__list__ (e.g., *lsns -o +PATH*)."
29442 #. type: Labeled list
29443 #: ../sys-utils/lsns.8.adoc:51
29445 #| msgid "*-P*, *--pty*"
29446 msgid "*-P*, *--persistent*"
29447 msgstr "*-P*, *--pty*"
29449 #. type: Plain text
29450 #: ../sys-utils/lsns.8.adoc:54
29452 "Display only the namespaces without processes (aka persistent namespaces), "
29453 "created by bind mounting /proc/pid/ns/type files to a filesystem path."
29456 #. type: Labeled list
29457 #: ../sys-utils/lsns.8.adoc:55
29459 #| msgid "*-f*, *--fast*"
29460 msgid "*-p*, *--task* _PID_"
29461 msgstr "*-f*, *--fast*"
29463 #. type: Plain text
29464 #: ../sys-utils/lsns.8.adoc:57
29465 msgid "Display only the namespaces held by the process with this _PID_."
29468 #. type: Plain text
29469 #: ../sys-utils/lsns.8.adoc:63
29471 "Display the specified _type_ of namespaces only. The supported types are "
29472 "*mnt*, *net*, *ipc*, *user*, *pid*, *uts*, *cgroup* and *time*. This option "
29473 "may be given more than once."
29476 #. type: Labeled list
29477 #: ../sys-utils/lsns.8.adoc:67
29479 #| msgid "*-P*, *--pty*"
29480 msgid "*-W*, *--nowrap*"
29481 msgstr "*-P*, *--pty*"
29483 #. type: Plain text
29484 #: ../sys-utils/lsns.8.adoc:69
29485 msgid "Do not use multi-line text in columns."
29488 #. type: Labeled list
29489 #: ../sys-utils/lsns.8.adoc:70
29491 #| msgid "*-P*, *--pty*"
29492 msgid "*-T*, *--tree* _rel_"
29493 msgstr "*-P*, *--pty*"
29495 #. type: Plain text
29496 #: ../sys-utils/lsns.8.adoc:72
29498 "Use tree-like output format. If *process* is given as _rel_, print process "
29499 "tree(s) in each name space. This is default when *--tree* is not specified. "
29500 "If *parent* is given, print tree(s) constructed by the parent/child "
29501 "relationship. If *owner* is given, print tree(s) constructed by the owner/"
29502 "owned relationship. *owner* is used as default when _rel_ is omitted."
29505 #. type: Plain text
29506 #: ../sys-utils/lsns.8.adoc:78
29507 msgid "The *lsns* utility exits with one of the following values:"
29510 #. type: Plain text
29511 #: ../sys-utils/lsns.8.adoc:81
29515 #. type: Plain text
29516 #: ../sys-utils/lsns.8.adoc:83
29517 msgid "General error."
29520 #. type: Plain text
29521 #: ../sys-utils/lsns.8.adoc:85
29522 msgid "An ioctl was unknown to the kernel."
29525 #. type: Plain text
29526 #: ../sys-utils/lsns.8.adoc:98
29529 #| "*setpriv*(1),\n"
29530 #| "*login.defs*(5),\n"
29531 #| "*shells*(5),\n"
29533 #| "*runuser*(1)\n"
29538 "*namespaces*(7),\n"
29543 "*login.defs*(5),\n"
29553 #. Copyright (c) 1996-2004 Andries Brouwer
29554 #. Copyright (C) 2006-2012 Karel Zak <kzak@redhat.com>
29555 #. This page is somewhat derived from a page that was
29556 #. (c) 1980, 1989, 1991 The Regents of the University of California
29557 #. and had been heavily modified by Rik Faith and myself.
29558 #. (Probably no BSD text remains.)
29559 #. Fragments of text were written by Werner Almesberger, Remy Card,
29560 #. Stephen Tweedie and Eric Youngdale.
29561 #. This is free documentation; you can redistribute it and/or
29562 #. modify it under the terms of the GNU General Public License as
29563 #. published by the Free Software Foundation; either version 2 of
29564 #. the License, or (at your option) any later version.
29565 #. The GNU General Public License's references to "object code"
29566 #. and "executables" are to be interpreted as the output of any
29567 #. document formatting or typesetting system, including
29568 #. intermediate and printed output.
29569 #. This manual is distributed in the hope that it will be useful,
29570 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
29571 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
29572 #. GNU General Public License for more details.
29573 #. You should have received a copy of the GNU General Public License along
29574 #. with this program; if not, write to the Free Software Foundation, Inc.,
29575 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
29577 #: ../sys-utils/mount.8.adoc:32
29582 #. type: Plain text
29583 #: ../sys-utils/mount.8.adoc:43
29584 msgid "mount - mount a filesystem"
29587 #. type: Plain text
29588 #: ../sys-utils/mount.8.adoc:47
29590 msgid "*mount* [*-h*|*-V*]\n"
29593 #. type: Plain text
29594 #: ../sys-utils/mount.8.adoc:49
29596 msgid "*mount* [*-l*] [*-t* _fstype_]\n"
29599 #. type: Plain text
29600 #: ../sys-utils/mount.8.adoc:51
29602 msgid "*mount* *-a* [*-fFnrsvw*] [*-t* _fstype_] [*-O* _optlist_]\n"
29605 #. type: Plain text
29606 #: ../sys-utils/mount.8.adoc:53
29608 msgid "*mount* [*-fnrsvw*] [*-o* _options_] _device_|_mountpoint_\n"
29611 #. type: Plain text
29612 #: ../sys-utils/mount.8.adoc:55
29614 msgid "*mount* [*-fnrsvw*] [*-t* _fstype_] [*-o* _options_] _device mountpoint_\n"
29617 #. type: Plain text
29618 #: ../sys-utils/mount.8.adoc:57
29620 msgid "*mount* *--bind*|*--rbind*|*--move* _olddir newdir_\n"
29623 #. type: Plain text
29624 #: ../sys-utils/mount.8.adoc:59
29626 msgid "*mount* *--make-*[*shared*|*slave*|*private*|*unbindable*|*rshared*|*rslave*|*rprivate*|*runbindable*] _mountpoint_\n"
29629 #. type: Plain text
29630 #: ../sys-utils/mount.8.adoc:63
29632 "All files accessible in a Unix system are arranged in one big tree, the file "
29633 "hierarchy, rooted at _/_. These files can be spread out over several "
29634 "devices. The *mount* command serves to attach the filesystem found on some "
29635 "device to the big file tree. Conversely, the *umount*(8) command will detach "
29636 "it again. The filesystem is used to control how data is stored on the device "
29637 "or provided in a virtual way by network or other services."
29640 #. type: Plain text
29641 #: ../sys-utils/mount.8.adoc:65
29642 msgid "The standard form of the *mount* command is:"
29645 #. type: delimited block _
29646 #: ../sys-utils/mount.8.adoc:68
29648 msgid "*mount -t* _type device dir_\n"
29651 #. type: Plain text
29652 #: ../sys-utils/mount.8.adoc:71
29654 "This tells the kernel to attach the filesystem found on _device_ (which is "
29655 "of type _type_) at the directory _dir_. The option *-t* _type_ is optional. "
29656 "The *mount* command is usually able to detect a filesystem. The root "
29657 "permissions are necessary to mount a filesystem by default. See section "
29658 "\"Non-superuser mounts\" below for more details. The previous contents (if "
29659 "any) and owner and mode of _dir_ become invisible, and as long as this "
29660 "filesystem remains mounted, the pathname _dir_ refers to the root of the "
29661 "filesystem on _device_."
29664 #. type: Plain text
29665 #: ../sys-utils/mount.8.adoc:73
29666 msgid "If only the directory or the device is given, for example:"
29669 #. type: delimited block _
29670 #: ../sys-utils/mount.8.adoc:76
29672 msgid "*mount* _/dir_\n"
29675 #. type: Plain text
29676 #: ../sys-utils/mount.8.adoc:79
29678 "then *mount* looks for a mountpoint (and if not found then for a device) in "
29679 "the _/etc/fstab_ file. It's possible to use the *--target* or *--source* "
29680 "options to avoid ambiguous interpretation of the given argument. For example:"
29683 #. type: delimited block _
29684 #: ../sys-utils/mount.8.adoc:82
29686 msgid "*mount --target* _/mountpoint_\n"
29689 #. type: Plain text
29690 #: ../sys-utils/mount.8.adoc:85
29692 "The same filesystem may be mounted more than once, and in some cases (e.g., "
29693 "network filesystems) the same filesystem may be mounted on the same "
29694 "mountpoint multiple times. The *mount* command does not implement any policy "
29695 "to control this behavior. All behavior is controlled by the kernel and it is "
29696 "usually specific to the filesystem driver. The exception is *--all*, in this "
29697 "case already mounted filesystems are ignored (see *--all* below for more "
29702 #: ../sys-utils/mount.8.adoc:86
29704 msgid "Listing the mounts"
29707 #. type: Plain text
29708 #: ../sys-utils/mount.8.adoc:89
29709 msgid "The listing mode is maintained for backward compatibility only."
29712 #. type: Plain text
29713 #: ../sys-utils/mount.8.adoc:91
29715 "For more robust and customizable output use *findmnt*(8), *especially in "
29716 "your scripts*. Note that control characters in the mountpoint name are "
29717 "replaced with '?'."
29720 #. type: Plain text
29721 #: ../sys-utils/mount.8.adoc:93
29722 msgid "The following command lists all mounted filesystems (of type _type_):"
29725 #. type: delimited block _
29726 #: ../sys-utils/mount.8.adoc:96
29728 msgid "*mount* [*-l*] [*-t* _type_]\n"
29731 #. type: Plain text
29732 #: ../sys-utils/mount.8.adoc:99
29733 msgid "The option *-l* adds labels to this listing. See below."
29737 #: ../sys-utils/mount.8.adoc:100
29739 msgid "Indicating the device and filesystem"
29742 #. type: Plain text
29743 #: ../sys-utils/mount.8.adoc:103
29745 "Most devices are indicated by a filename (of a block special device), like _/"
29746 "dev/sda1_, but there are other possibilities. For example, in the case of an "
29747 "NFS mount, _device_ may look like _knuth.cwi.nl:/dir_."
29750 #. type: Plain text
29751 #: ../sys-utils/mount.8.adoc:105
29753 "The device names of disk partitions are unstable; hardware reconfiguration, "
29754 "and adding or removing a device can cause changes in names. This is the "
29755 "reason why it's strongly recommended to use filesystem or partition "
29756 "identifiers like UUID or LABEL. Currently supported identifiers (tags):"
29759 #. type: Labeled list
29760 #: ../sys-utils/mount.8.adoc:106
29762 msgid "LABEL=__label__"
29765 #. type: Plain text
29766 #: ../sys-utils/mount.8.adoc:108
29767 msgid "Human readable filesystem identifier. See also *-L*."
29770 #. type: Labeled list
29771 #: ../sys-utils/mount.8.adoc:109
29773 msgid "UUID=__uuid__"
29776 #. type: Plain text
29777 #: ../sys-utils/mount.8.adoc:111
29779 "Filesystem universally unique identifier. The format of the UUID is usually "
29780 "a series of hex digits separated by hyphens. See also *-U*."
29783 #. type: Plain text
29784 #: ../sys-utils/mount.8.adoc:113
29786 "Note that *mount* uses UUIDs as strings. The UUIDs from the command line or "
29787 "from *fstab*(5) are not converted to internal binary representation. The "
29788 "string representation of the UUID should be based on lower case characters."
29791 #. type: Labeled list
29792 #: ../sys-utils/mount.8.adoc:114
29794 msgid "PARTLABEL=__label__"
29797 #. type: Plain text
29798 #: ../sys-utils/mount.8.adoc:116
29800 "Human readable partition identifier. This identifier is independent on "
29801 "filesystem and does not change by *mkfs* or *mkswap* operations. It's "
29802 "supported for example for GUID Partition Tables (GPT)."
29805 #. type: Labeled list
29806 #: ../sys-utils/mount.8.adoc:117
29808 msgid "PARTUUID=__uuid__"
29811 #. type: Plain text
29812 #: ../sys-utils/mount.8.adoc:119
29814 "Partition universally unique identifier. This identifier is independent on "
29815 "filesystem and does not change by *mkfs* or *mkswap* operations. It's "
29816 "supported for example for GUID Partition Tables (GPT)."
29819 #. type: Labeled list
29820 #: ../sys-utils/mount.8.adoc:120
29825 #. type: Plain text
29826 #: ../sys-utils/mount.8.adoc:122
29828 "Hardware block device ID as generated by udevd. This identifier is usually "
29829 "based on WWN (unique storage identifier) and assigned by the hardware "
29830 "manufacturer. See *ls /dev/disk/by-id* for more details, this directory and "
29831 "running udevd is required. This identifier is not recommended for generic "
29832 "use as the identifier is not strictly defined and it depends on udev, udev "
29833 "rules and hardware."
29836 #. type: Plain text
29837 #: ../sys-utils/mount.8.adoc:124
29839 "The command *lsblk --fs* provides an overview of filesystems, LABELs and "
29840 "UUIDs on available block devices. The command *blkid -p <device>* provides "
29841 "details about a filesystem on the specified device."
29844 #. type: Plain text
29845 #: ../sys-utils/mount.8.adoc:126
29847 "Don't forget that there is no guarantee that UUIDs and labels are really "
29848 "unique, especially if you move, share or copy the device. Use *lsblk -o "
29849 "+UUID,PARTUUID* to verify that the UUIDs are really unique in your system."
29852 #. type: Plain text
29853 #: ../sys-utils/mount.8.adoc:128
29855 "The recommended setup is to use tags (e.g. *UUID*=_uuid_) rather than _/dev/"
29856 "disk/by-{label,uuid,id,partuuid,partlabel}_ udev symlinks in the _/etc/"
29857 "fstab_ file. Tags are more readable, robust and portable. The *mount*(8) "
29858 "command internally uses udev symlinks, so the use of symlinks in _/etc/"
29859 "fstab_ has no advantage over tags. For more details see *libblkid*(3)."
29862 #. type: Plain text
29863 #: ../sys-utils/mount.8.adoc:130
29865 "The _proc_ filesystem is not associated with a special device, and when "
29866 "mounting it, an arbitrary keyword - for example, __proc__ - can be used "
29867 "instead of a device specification. (The customary choice _none_ is less "
29868 "fortunate: the error message 'none already mounted' from *mount* can be "
29873 #: ../sys-utils/mount.8.adoc:131
29875 msgid "The files /etc/fstab, /etc/mtab and /proc/mounts"
29878 #. type: Plain text
29879 #: ../sys-utils/mount.8.adoc:134
29881 "The file _/etc/fstab_ (see *fstab*(5)), may contain lines describing what "
29882 "devices are usually mounted where, using which options. The default location "
29883 "of the *fstab*(5) file can be overridden with the *--fstab* _path_ command-"
29884 "line option (see below for more details)."
29887 #. type: Plain text
29888 #: ../sys-utils/mount.8.adoc:136
29890 #| msgid "User Commands"
29891 msgid "The command"
29892 msgstr "Příručka uživatele"
29894 #. type: delimited block _
29895 #: ../sys-utils/mount.8.adoc:139
29897 msgid "*mount -a* [*-t* _type_] [*-O* _optlist_]\n"
29900 #. type: Plain text
29901 #: ../sys-utils/mount.8.adoc:142
29903 "(usually given in a bootscript) causes all filesystems mentioned in _fstab_ "
29904 "(of the proper type and/or having or not having the proper options) to be "
29905 "mounted as indicated, except for those whose line contains the *noauto* "
29906 "keyword. Adding the *-F* option will make *mount* fork, so that the "
29907 "filesystems are mounted in parallel."
29910 #. type: Plain text
29911 #: ../sys-utils/mount.8.adoc:144
29913 "When mounting a filesystem mentioned in _fstab_ or _mtab_, it suffices to "
29914 "specify on the command line only the device, or only the mount point."
29917 #. type: Plain text
29918 #: ../sys-utils/mount.8.adoc:146
29920 "The programs *mount* and *umount*(8) traditionally maintained a list of "
29921 "currently mounted filesystems in the file _/etc/mtab_. The support for "
29922 "regular classic _/etc/mtab_ is completely disabled at compile time by "
29923 "default, because on current Linux systems it is better to make _/etc/mtab_ a "
29924 "symlink to _/proc/mounts_ instead. The regular _mtab_ file maintained in "
29925 "userspace cannot reliably work with namespaces, containers and other "
29926 "advanced Linux features. If the regular _mtab_ support is enabled, then it's "
29927 "possible to use the file as well as the symlink."
29930 #. type: Plain text
29931 #: ../sys-utils/mount.8.adoc:148
29933 "If no arguments are given to *mount*, the list of mounted filesystems is "
29937 #. type: Plain text
29938 #: ../sys-utils/mount.8.adoc:150
29940 "If you want to override mount options from _/etc/fstab_, you have to use the "
29944 #. type: delimited block _
29945 #: ../sys-utils/mount.8.adoc:153
29947 msgid "*mount* __device__|__dir__ *-o* _options_\n"
29950 #. type: Plain text
29951 #: ../sys-utils/mount.8.adoc:156
29953 "and then the mount options from the command line will be appended to the "
29954 "list of options from _/etc/fstab_. This default behaviour can be changed "
29955 "using the *--options-mode* command-line option. The usual behavior is that "
29956 "the last option wins if there are conflicting ones."
29959 #. type: Plain text
29960 #: ../sys-utils/mount.8.adoc:158
29962 "The *mount* program does not read the _/etc/fstab_ file if both _device_ (or "
29963 "LABEL, UUID, ID, PARTUUID or PARTLABEL) and _dir_ are specified. For "
29964 "example, to mount device *foo* at */dir*:"
29967 #. type: delimited block _
29968 #: ../sys-utils/mount.8.adoc:161
29970 msgid "*mount /dev/foo /dir*\n"
29973 #. type: Plain text
29974 #: ../sys-utils/mount.8.adoc:164
29976 "This default behaviour can be changed by using the *--options-source-force* "
29977 "command-line option to always read configuration from _fstab_. For non-root "
29978 "users *mount* always reads the _fstab_ configuration."
29982 #: ../sys-utils/mount.8.adoc:165
29984 msgid "Non-superuser mounts"
29987 #. type: Plain text
29988 #: ../sys-utils/mount.8.adoc:168
29990 "Normally, only the superuser can mount filesystems. However, when _fstab_ "
29991 "contains the *user* option on a line, anybody can mount the corresponding "
29995 #. type: Plain text
29996 #: ../sys-utils/mount.8.adoc:170
29997 msgid "Thus, given a line"
30000 #. type: delimited block _
30001 #: ../sys-utils/mount.8.adoc:173
30003 msgid "*/dev/cdrom /cd iso9660 ro,user,noauto,unhide*\n"
30006 #. type: Plain text
30007 #: ../sys-utils/mount.8.adoc:176
30009 "any user can mount the iso9660 filesystem found on an inserted CDROM using "
30013 #. type: delimited block _
30014 #: ../sys-utils/mount.8.adoc:179
30016 msgid "*mount /cd*\n"
30019 #. type: Plain text
30020 #: ../sys-utils/mount.8.adoc:182
30022 "Note that *mount* is very strict about non-root users and all paths "
30023 "specified on command line are verified before _fstab_ is parsed or a helper "
30024 "program is executed. It's strongly recommended to use a valid mountpoint to "
30025 "specify filesystem, otherwise *mount* may fail. For example it's a bad idea "
30026 "to use NFS or CIFS source on command line."
30029 #. type: Plain text
30030 #: ../sys-utils/mount.8.adoc:184
30032 "Since util-linux 2.35, *mount* does not exit when user permissions are "
30033 "inadequate according to libmount's internal security rules. Instead, it "
30034 "drops suid permissions and continues as regular non-root user. This behavior "
30035 "supports use-cases where root permissions are not necessary (e.g., fuse "
30036 "filesystems, user namespaces, etc)."
30039 #. type: Plain text
30040 #: ../sys-utils/mount.8.adoc:186
30042 "For more details, see *fstab*(5). Only the user that mounted a filesystem "
30043 "can unmount it again. If any user should be able to unmount it, then use "
30044 "*users* instead of *user* in the _fstab_ line. The *owner* option is similar "
30045 "to the *user* option, with the restriction that the user must be the owner "
30046 "of the special file. This may be useful e.g. for _/dev/fd_ if a login script "
30047 "makes the console user owner of this device. The *group* option is similar, "
30048 "with the restriction that the user must be a member of the group of the "
30052 #. type: Plain text
30053 #: ../sys-utils/mount.8.adoc:188
30055 "The *user* mount option is accepted if no username is specified. If used in "
30056 "the format *user=someone*, the option is silently ignored and visible only "
30057 "for external mount helpers (/sbin/mount.<type>) for compatibility with some "
30058 "network filesystems."
30062 #: ../sys-utils/mount.8.adoc:189
30064 msgid "Bind mount operation"
30067 #. type: Plain text
30068 #: ../sys-utils/mount.8.adoc:192
30069 msgid "Remount part of the file hierarchy somewhere else. The call is:"
30072 #. type: delimited block _
30073 #: ../sys-utils/mount.8.adoc:195 ../sys-utils/mount.8.adoc:233
30075 msgid "*mount --bind* _olddir newdir_\n"
30078 #. type: Plain text
30079 #: ../sys-utils/mount.8.adoc:198
30080 msgid "or by using this _fstab_ entry:"
30083 #. type: delimited block _
30084 #: ../sys-utils/mount.8.adoc:201
30086 msgid "**/**__olddir__ **/**__newdir__ *none bind*\n"
30089 #. type: Plain text
30090 #: ../sys-utils/mount.8.adoc:204
30091 msgid "After this call the same contents are accessible in two places."
30094 #. type: Plain text
30095 #: ../sys-utils/mount.8.adoc:206
30097 "It is important to understand that \"bind\" does not create any second-class "
30098 "or special node in the kernel VFS. The \"bind\" is just another operation to "
30099 "attach a filesystem. There is nowhere stored information that the filesystem "
30100 "has been attached by a \"bind\" operation. The _olddir_ and _newdir_ are "
30101 "independent and the _olddir_ may be unmounted."
30104 #. type: Plain text
30105 #: ../sys-utils/mount.8.adoc:208
30107 "One can also remount a single file (on a single file). It's also possible to "
30108 "use a bind mount to create a mountpoint from a regular directory, for "
30112 #. type: delimited block _
30113 #: ../sys-utils/mount.8.adoc:211
30115 msgid "*mount --bind foo foo*\n"
30118 #. type: Plain text
30119 #: ../sys-utils/mount.8.adoc:214
30121 "The bind mount call attaches only (part of) a single filesystem, not "
30122 "possible submounts. The entire file hierarchy including submounts can be "
30123 "attached a second place by using:"
30126 #. type: delimited block _
30127 #: ../sys-utils/mount.8.adoc:217
30129 msgid "*mount --rbind* _olddir newdir_\n"
30132 #. type: Plain text
30133 #: ../sys-utils/mount.8.adoc:220
30135 "Note that the filesystem mount options maintained by the kernel will remain "
30136 "the same as those on the original mount point. The userspace mount options "
30137 "(e.g., _netdev) will not be copied by *mount* and it's necessary to "
30138 "explicitly specify the options on the *mount* command line."
30141 #. type: Plain text
30142 #: ../sys-utils/mount.8.adoc:222
30144 "Since util-linux 2.27 *mount* permits changing the mount options by passing "
30145 "the relevant options along with *--bind*. For example:"
30148 #. type: delimited block _
30149 #: ../sys-utils/mount.8.adoc:225
30151 msgid "*mount -o bind,ro foo foo*\n"
30154 #. type: Plain text
30155 #: ../sys-utils/mount.8.adoc:228
30157 "This feature is not supported by the Linux kernel; it is implemented in "
30158 "userspace by an additional *mount*(2) remounting system call. This solution "
30162 #. type: Plain text
30163 #: ../sys-utils/mount.8.adoc:230
30165 "The alternative (classic) way to create a read-only bind mount is to use the "
30166 "remount operation, for example:"
30169 #. type: delimited block _
30170 #: ../sys-utils/mount.8.adoc:235
30172 msgid "*mount -o remount,bind,ro* _olddir newdir_\n"
30175 #. type: Plain text
30176 #: ../sys-utils/mount.8.adoc:238
30178 "Note that a read-only bind will create a read-only mountpoint (VFS entry), "
30179 "but the original filesystem superblock will still be writable, meaning that "
30180 "the _olddir_ will be writable, but the _newdir_ will be read-only."
30183 #. type: Plain text
30184 #: ../sys-utils/mount.8.adoc:240
30186 "It's also possible to change nosuid, nodev, noexec, noatime, nodiratime, "
30187 "relatime and nosymfollow VFS entry flags via a \"remount,bind\" operation. "
30188 "The other flags (for example filesystem-specific flags) are silently "
30189 "ignored. The classic *mount*(2) system call does not allow to change mount "
30190 "options recursively (for example with *-o rbind,ro*). The recursive semantic "
30191 "is possible with a new *mount_setattr*(2) kernel system call and it's "
30192 "supported since libmount from util-linux v2.39 by a new experimental "
30193 "\"recursive\" option argument (e.g. *-o rbind,ro=recursive*). For more "
30194 "details see the *FILESYSTEM-INDEPENDENT MOUNT OPTIONS* section."
30197 #. type: Plain text
30198 #: ../sys-utils/mount.8.adoc:242
30200 "Since util-linux 2.31, *mount* ignores the *bind* flag from _/etc/fstab_ on "
30201 "a *remount* operation (if *-o remount* is specified on command line). This "
30202 "is necessary to fully control mount options on remount by command line. In "
30203 "previous versions the bind flag has been always applied and it was "
30204 "impossible to re-define mount options without interaction with the bind "
30205 "semantic. This *mount* behavior does not affect situations when \"remount,"
30206 "bind\" is specified in the _/etc/fstab_ file."
30209 #. type: Plain text
30210 #: ../sys-utils/mount.8.adoc:244
30212 "Since util-linux 2.40, *mount* does not canonicalize the mountpoint path on "
30213 "bind operation if the target is a symlink. This feature is usable (only) "
30214 "with the new kernel mount API where *bind mount over symlinks* is supported."
30218 #: ../sys-utils/mount.8.adoc:245
30220 msgid "The move operation"
30223 #. type: Plain text
30224 #: ../sys-utils/mount.8.adoc:248
30225 msgid "Move a *mounted tree* to another place (atomically). The call is:"
30228 #. type: delimited block _
30229 #: ../sys-utils/mount.8.adoc:251
30231 msgid "*mount --move* _olddir newdir_\n"
30234 #. type: Plain text
30235 #: ../sys-utils/mount.8.adoc:254
30237 "This will cause the contents which previously appeared under _olddir_ to now "
30238 "be accessible under _newdir_. The physical location of the files is not "
30239 "changed. Note that _olddir_ has to be a mountpoint."
30242 #. type: Plain text
30243 #: ../sys-utils/mount.8.adoc:256
30245 "Note also that moving a mount residing under a shared mount is invalid and "
30246 "unsupported. Use *findmnt -o TARGET,PROPAGATION* to see the current "
30247 "propagation flags."
30251 #: ../sys-utils/mount.8.adoc:257
30253 msgid "Shared subtree operations"
30256 #. type: Plain text
30257 #: ../sys-utils/mount.8.adoc:260
30259 "Since Linux 2.6.15 it is possible to mark a mount and its submounts as "
30260 "shared, private, slave or unbindable. A shared mount provides the ability to "
30261 "create mirrors of that mount such that mounts and unmounts within any of the "
30262 "mirrors propagate to the other mirror. A slave mount receives propagation "
30263 "from its master, but not vice versa. A private mount carries no propagation "
30264 "abilities. An unbindable mount is a private mount which cannot be cloned "
30265 "through a bind operation. The detailed semantics are documented in "
30266 "_Documentation/filesystems/sharedsubtree.txt_ file in the kernel source "
30267 "tree; see also *mount_namespaces*(7)."
30270 #. type: Plain text
30271 #: ../sys-utils/mount.8.adoc:262
30272 msgid "Supported operations are:"
30275 #. type: delimited block .
30276 #: ../sys-utils/mount.8.adoc:268
30279 "mount --make-shared mountpoint\n"
30280 "mount --make-slave mountpoint\n"
30281 "mount --make-private mountpoint\n"
30282 "mount --make-unbindable mountpoint\n"
30285 #. type: Plain text
30286 #: ../sys-utils/mount.8.adoc:271
30288 "The following commands allow one to recursively change the type of all the "
30289 "mounts under a given mountpoint."
30292 #. type: delimited block .
30293 #: ../sys-utils/mount.8.adoc:277
30296 "mount --make-rshared mountpoint\n"
30297 "mount --make-rslave mountpoint\n"
30298 "mount --make-rprivate mountpoint\n"
30299 "mount --make-runbindable mountpoint\n"
30302 #. type: Plain text
30303 #: ../sys-utils/mount.8.adoc:280
30305 msgid "*mount* *does not read* *fstab*(5) when a *--make-** operation is requested. All necessary information has to be specified on the command line.\n"
30308 #. type: Plain text
30309 #: ../sys-utils/mount.8.adoc:282
30311 "Note that the Linux kernel does not allow changing multiple propagation "
30312 "flags with a single *mount*(2) system call, and the flags cannot be mixed "
30313 "with other mount options and operations."
30316 #. type: Plain text
30317 #: ../sys-utils/mount.8.adoc:284
30319 "Since util-linux 2.23 the *mount* command can be used to do more propagation "
30320 "(topology) changes by one *mount*(8) call and do it also together with other "
30321 "mount operations. The propagation flags are applied by additional *mount*(2) "
30322 "system calls when the preceding mount operations were successful. Note that "
30323 "this use case is not atomic. It is possible to specify the propagation flags "
30324 "in *fstab*(5) as mount options (*private*, *slave*, *shared*, *unbindable*, "
30325 "*rprivate*, *rslave*, *rshared*, *runbindable*)."
30328 #. type: delimited block .
30329 #: ../sys-utils/mount.8.adoc:289
30331 msgid "mount --make-private --make-unbindable /dev/sda1 /foo\n"
30334 #. type: Plain text
30335 #: ../sys-utils/mount.8.adoc:292
30336 msgid "is the same as:"
30339 #. type: delimited block .
30340 #: ../sys-utils/mount.8.adoc:297
30343 "mount /dev/sda1 /foo\n"
30344 "mount --make-private /foo\n"
30345 "mount --make-unbindable /foo\n"
30349 #: ../sys-utils/mount.8.adoc:299
30351 msgid "COMMAND-LINE OPTIONS"
30354 #. type: Plain text
30355 #: ../sys-utils/mount.8.adoc:302
30357 "The full set of mount options used by an invocation of *mount* is determined "
30358 "by first extracting the mount options for the filesystem from the _fstab_ "
30359 "table, then applying any options specified by the *-o* argument, and finally "
30360 "applying a *-r* or *-w* option, when present."
30363 #. type: Plain text
30364 #: ../sys-utils/mount.8.adoc:304
30366 "The *mount* command does not pass all command-line options to the **/sbin/"
30367 "mount.**__suffix__ mount helpers. The interface between *mount* and the "
30368 "mount helpers is described below in the *EXTERNAL HELPERS* section."
30371 #. type: Plain text
30372 #: ../sys-utils/mount.8.adoc:306
30373 msgid "Command-line options available for the *mount* command are:"
30376 #. type: Plain text
30377 #: ../sys-utils/mount.8.adoc:309
30379 "Mount all filesystems (of the given types) mentioned in _fstab_ (except for "
30380 "those whose line contains the *noauto* keyword). The filesystems are mounted "
30381 "following their order in _fstab_. The *mount* command compares filesystem "
30382 "source, target (and fs root for bind mount or btrfs) to detect already "
30383 "mounted filesystems. The kernel table with already mounted filesystems is "
30384 "cached during *mount --all*. This means that all duplicated _fstab_ entries "
30388 #. type: Plain text
30389 #: ../sys-utils/mount.8.adoc:311
30391 "The correct functionality depends on _/proc_ (to detect already mounted "
30392 "filesystems) and on _/sys_ (to evaluate filesystem tags like UUID= or "
30393 "LABEL=). It's strongly recommended to mount _/proc_ and _/sys_ filesystems "
30394 "before *mount -a* is executed, or keep /proc and /sys at the beginning of "
30398 #. type: Plain text
30399 #: ../sys-utils/mount.8.adoc:313
30401 "The option *--all* is possible to use for remount operation too. In this "
30402 "case all filters (*-t* and *-O*) are applied to the table of already mounted "
30406 #. type: Plain text
30407 #: ../sys-utils/mount.8.adoc:315
30409 "Since version 2.35 it is possible to use the command line option *-o* to "
30410 "alter mount options from _fstab_ (see also *--options-mode*)."
30413 #. type: Plain text
30414 #: ../sys-utils/mount.8.adoc:317
30416 "Note that it is a bad practice to use *mount -a* for _fstab_ checking. The "
30417 "recommended solution is *findmnt --verify*."
30420 #. type: Labeled list
30421 #: ../sys-utils/mount.8.adoc:318
30423 #| msgid "*-V*, *--version*"
30424 msgid "*-B*, *--bind*"
30425 msgstr "*-V*, *--version*"
30427 #. type: Plain text
30428 #: ../sys-utils/mount.8.adoc:320
30430 "Remount a subtree somewhere else (so that its contents are available in both "
30431 "places). See above, under *Bind mount operation*."
30434 #. type: Labeled list
30435 #: ../sys-utils/mount.8.adoc:321 ../sys-utils/umount.8.adoc:60
30437 msgid "*-c*, *--no-canonicalize*"
30440 #. type: Plain text
30441 #: ../sys-utils/mount.8.adoc:323
30443 "Don't canonicalize paths. The *mount* command canonicalizes all paths (from "
30444 "the command line or _fstab_) by default. The option is designed for mount "
30445 "helpers which call *mount -i*. It is strongly recommended to not use this "
30446 "command-line option for normal mount operations."
30449 #. type: Plain text
30450 #: ../sys-utils/mount.8.adoc:325
30452 "Since util-linux 2.40, mount does not canonicalize the mountpoint path on "
30453 "bind operation if the target is a symlink (see \"*Bind mount operation*\" "
30454 "section for more details)."
30457 #. type: Plain text
30458 #: ../sys-utils/mount.8.adoc:327
30460 "Note that *mount* does not pass this option to the **/sbin/mount.**__type__ "
30464 #. type: Labeled list
30465 #: ../sys-utils/mount.8.adoc:328
30467 #| msgid "*-f*, *--fast*"
30468 msgid "*-F*, *--fork*"
30469 msgstr "*-f*, *--fast*"
30471 #. type: Plain text
30472 #: ../sys-utils/mount.8.adoc:330
30474 "(Used in conjunction with *-a*.) Fork off a new incarnation of *mount* for "
30475 "each device. This will do the mounts on different devices or different NFS "
30476 "servers in parallel. This has the advantage that it is faster; also NFS "
30477 "timeouts proceed in parallel. A disadvantage is that the order of the mount "
30478 "operations is undefined. Thus, you cannot use this option if you want to "
30479 "mount both _/usr_ and _/usr/spool_."
30482 #. type: Labeled list
30483 #: ../sys-utils/mount.8.adoc:331
30485 #| msgid "*-f*, *--fast*"
30486 msgid "*-f, --fake*"
30487 msgstr "*-f*, *--fast*"
30489 #. type: Plain text
30490 #: ../sys-utils/mount.8.adoc:333
30492 "Causes everything to be done except for the mount-related system calls. The "
30493 "--fake option was originally designed to write an entry to /etc/mtab without "
30494 "actually mounting."
30497 #. type: Plain text
30498 #: ../sys-utils/mount.8.adoc:335
30500 "The /etc/mtab is no longer maintained in userspace, and starting from "
30501 "version 2.39, the mount operation can be a complex chain of operations with "
30502 "dependencies between the syscalls. The --fake option forces libmount to skip "
30503 "all mount source preparation, mount option analysis, and the actual mounting "
30507 #. type: Plain text
30508 #: ../sys-utils/mount.8.adoc:337
30510 "The difference between fake and non-fake execution is huge. This is the "
30511 "reason why the --fake option has minimal significance for the current "
30512 "mount(8) implementation and it is maintained mostly for backward "
30516 #. type: Labeled list
30517 #: ../sys-utils/mount.8.adoc:338
30519 msgid "*-i, --internal-only*"
30522 #. type: Plain text
30523 #: ../sys-utils/mount.8.adoc:340
30524 msgid "Don't call the **/sbin/mount.**__filesystem__ helper even if it exists."
30527 #. type: Plain text
30528 #: ../sys-utils/mount.8.adoc:343
30529 msgid "Mount the partition that has the specified _label_."
30532 #. type: Labeled list
30533 #: ../sys-utils/mount.8.adoc:344
30535 #| msgid "*-h*, *--help*"
30536 msgid "*-l*, *--show-labels*"
30537 msgstr "*-h*, *--help*"
30539 #. type: Plain text
30540 #: ../sys-utils/mount.8.adoc:346
30542 "Add the labels in the mount output. *mount* must have permission to read the "
30543 "disk device (e.g. be set-user-ID root) for this to work. One can set such a "
30544 "label for ext2, ext3 or ext4 using the *e2label*(8) utility, or for XFS "
30545 "using *xfs_admin*(8), or for reiserfs using *reiserfstune*(8)."
30548 #. type: Labeled list
30549 #: ../sys-utils/mount.8.adoc:347
30551 #| msgid "*-h*, *--help*"
30552 msgid "*-M*, *--move*"
30553 msgstr "*-h*, *--help*"
30555 #. type: Plain text
30556 #: ../sys-utils/mount.8.adoc:349
30558 "Move a subtree to some other place. See above, the subsection *The move "
30562 #. type: Labeled list
30563 #: ../sys-utils/mount.8.adoc:350
30565 #| msgid "*-c*, **--command**=__command__"
30566 msgid "*-m*, **--mkdir**[=__mode__]"
30567 msgstr "*-c*, **--command**=__příkaz__"
30569 #. type: Plain text
30570 #: ../sys-utils/mount.8.adoc:352
30572 "Allow to make a target directory (mountpoint) if it does not exist yet. "
30573 "Alias to \"-o X-mount.mkdir[=mode]\", the default mode is 0755. For more "
30574 "details see *X-mount.mkdir* below."
30577 #. type: Labeled list
30578 #: ../sys-utils/mount.8.adoc:353
30580 msgid "*--map-groups*, *--map-users* _inner_:_outer_:_count_"
30583 #. type: Plain text
30584 #: ../sys-utils/mount.8.adoc:355
30586 "Add the specified user/group mapping to an *X-mount.idmap* map. These "
30587 "options can be given multiple times to build up complete mappings for users "
30588 "and groups. For more details see *X-mount.idmap* below."
30591 #. type: Labeled list
30592 #: ../sys-utils/mount.8.adoc:356
30594 msgid "*--map-users* /proc/_PID_/ns/user"
30597 #. type: Plain text
30598 #: ../sys-utils/mount.8.adoc:358
30600 "Use the specified user namespace for user and group mapping in an id-mapped "
30601 "mount. This is an alias for \"-o X-mount.idmap=/proc/_PID_/ns/user\" and "
30602 "cannot be used twice nor together with the _inner_:_outer_:_count_ option "
30603 "format above. For more details see *X-mount.idmap* below."
30606 #. type: Labeled list
30607 #: ../sys-utils/mount.8.adoc:359 ../sys-utils/umount.8.adoc:93
30609 #| msgid "*-P*, *--pty*"
30610 msgid "*-n*, *--no-mtab*"
30611 msgstr "*-P*, *--pty*"
30613 #. type: Plain text
30614 #: ../sys-utils/mount.8.adoc:361
30616 "Mount without writing in _/etc/mtab_. This is necessary for example when _/"
30617 "etc_ is on a read-only filesystem."
30620 #. type: Labeled list
30621 #: ../sys-utils/mount.8.adoc:362 ../sys-utils/umount.8.adoc:86
30623 msgid "*-N*, *--namespace* _ns_"
30626 #. type: Plain text
30627 #: ../sys-utils/mount.8.adoc:364
30629 "Perform the mount operation in the mount namespace specified by _ns_. _ns_ "
30630 "is either PID of process running in that namespace or special file "
30631 "representing that namespace."
30634 #. type: Plain text
30635 #: ../sys-utils/mount.8.adoc:366
30637 msgid "*mount* switches to the mount namespace when it reads _/etc/fstab_, writes _/etc/mtab: (or writes to _/run/mount_) and calls *mount*(2), otherwise it runs in the original mount namespace. This means that the target namespace does not have to contain any libraries or other requirements necessary to execute the *mount*(2) call.\n"
30640 #. type: Plain text
30641 #: ../sys-utils/mount.8.adoc:368 ../sys-utils/umount.8.adoc:92
30642 msgid "See *mount_namespaces*(7) for more information."
30645 #. type: Labeled list
30646 #: ../sys-utils/mount.8.adoc:369
30648 msgid "*-O*, *--test-opts* _opts_"
30651 #. type: Plain text
30652 #: ../sys-utils/mount.8.adoc:371
30654 "Limit the set of filesystems to which the *-a* option applies. In this "
30655 "regard it is like the *-t* option except that *-O* is useless without *-a*. "
30656 "For example, the command"
30659 #. type: Plain text
30660 #: ../sys-utils/mount.8.adoc:373
30662 msgid "*mount -a -O no_netdev*\n"
30665 #. type: Plain text
30666 #: ../sys-utils/mount.8.adoc:375
30668 "mounts all filesystems except those which have the option _netdev_ specified "
30669 "in the options field in the _/etc/fstab_ file."
30672 #. type: Plain text
30673 #: ../sys-utils/mount.8.adoc:377
30675 "It is different from *-t* in that each option is matched exactly; a leading "
30676 "*no* at the beginning of one option does not negate the rest."
30679 #. type: Plain text
30680 #: ../sys-utils/mount.8.adoc:379
30682 "The *-t* and *-O* options are cumulative in effect; that is, the command"
30685 #. type: Plain text
30686 #: ../sys-utils/mount.8.adoc:381
30688 msgid "*mount -a -t ext2 -O _netdev*\n"
30691 #. type: Plain text
30692 #: ../sys-utils/mount.8.adoc:383
30694 "mounts all ext2 filesystems with the _netdev option, not all filesystems "
30695 "that are either ext2 or have the _netdev option specified."
30698 #. type: Labeled list
30699 #: ../sys-utils/mount.8.adoc:384 ../sys-utils/swapon.8.adoc:58
30701 msgid "*-o*, *--options* _opts_"
30704 #. type: Plain text
30705 #: ../sys-utils/mount.8.adoc:386
30707 "Use the specified mount options. The _opts_ argument is a comma-separated "
30708 "list. For example:"
30711 #. type: Plain text
30712 #: ../sys-utils/mount.8.adoc:388
30714 msgid "*mount LABEL=mydisk -o noatime,nodev,nosuid*\n"
30717 #. type: Plain text
30718 #: ../sys-utils/mount.8.adoc:390
30720 "Note that the order of the options matters, as the last option wins if there "
30721 "are conflicting ones. The options from the command line also overwrite "
30722 "options from fstab by default."
30725 #. type: Plain text
30726 #: ../sys-utils/mount.8.adoc:392
30728 "For more details, see the *FILESYSTEM-INDEPENDENT MOUNT OPTIONS* and "
30729 "*FILESYSTEM-SPECIFIC MOUNT OPTIONS* sections."
30732 #. type: Labeled list
30733 #: ../sys-utils/mount.8.adoc:393
30735 #| msgid "*-h*, *--help*"
30736 msgid "*--onlyonce*"
30737 msgstr "*-h*, *--help*"
30739 #. type: Plain text
30740 #: ../sys-utils/mount.8.adoc:395
30742 "Forces mount command to check if the filesystem is already mounted. This "
30743 "behavior is the default for *--all*; otherwise, it depends on the kernel "
30744 "filesystem driver. Some filesystems may be mounted more than once on the "
30745 "same mount point (e.g. tmpfs)."
30748 #. type: Labeled list
30749 #: ../sys-utils/mount.8.adoc:396
30751 msgid "*--options-mode* _mode_"
30754 #. type: Plain text
30755 #: ../sys-utils/mount.8.adoc:398
30757 "Controls how to combine options from _fstab_/_mtab_ with options from the "
30758 "command line. _mode_ can be one of *ignore*, *append*, *prepend* or "
30759 "*replace*. For example, *append* means that options from _fstab_ are "
30760 "appended to options from the command line. The default value is *prepend* -- "
30761 "it means command line options are evaluated after _fstab_ options. Note that "
30762 "the last option wins if there are conflicting ones."
30765 #. type: Labeled list
30766 #: ../sys-utils/mount.8.adoc:399
30768 msgid "*--options-source* _source_"
30771 #. type: Plain text
30772 #: ../sys-utils/mount.8.adoc:401
30774 "Source of default options. _source_ is a comma-separated list of *fstab*, "
30775 "*mtab* and *disable*. *disable* disables *fstab* and *mtab* and enables *--"
30776 "options-source-force*. The default value is *fstab,mtab*."
30779 #. type: Labeled list
30780 #: ../sys-utils/mount.8.adoc:402
30782 msgid "*--options-source-force*"
30785 #. type: Plain text
30786 #: ../sys-utils/mount.8.adoc:404
30788 "Use options from _fstab_/_mtab_ even if both _device_ and _dir_ are "
30792 #. type: Labeled list
30793 #: ../sys-utils/mount.8.adoc:405
30795 #| msgid "*-V*, *--version*"
30796 msgid "*-R*, *--rbind*"
30797 msgstr "*-V*, *--version*"
30799 #. type: Plain text
30800 #: ../sys-utils/mount.8.adoc:407
30802 "Remount a subtree and all possible submounts somewhere else (so that its "
30803 "contents are available in both places). See above, the subsection *Bind "
30804 "mount operation*."
30807 #. type: Plain text
30808 #: ../sys-utils/mount.8.adoc:410
30809 msgid "Mount the filesystem read-only. A synonym is *-o ro*."
30812 #. type: Plain text
30813 #: ../sys-utils/mount.8.adoc:412
30815 "Note that, depending on the filesystem type, state and kernel behavior, the "
30816 "system may still write to the device. For example, ext3 and ext4 will replay "
30817 "the journal if the filesystem is dirty. To prevent this kind of write "
30818 "access, you may want to mount an ext3 or ext4 filesystem with the *ro,"
30819 "noload* mount options or set the block device itself to read-only mode, see "
30820 "the *blockdev*(8) command."
30823 #. type: Plain text
30824 #: ../sys-utils/mount.8.adoc:415
30826 "Tolerate sloppy mount options rather than failing. This will ignore mount "
30827 "options not supported by a filesystem type. Not all filesystems support this "
30828 "option. Currently it's supported by the *mount.nfs* mount helper only."
30831 #. type: Labeled list
30832 #: ../sys-utils/mount.8.adoc:416
30834 msgid "*--source* _device_"
30837 #. type: Plain text
30838 #: ../sys-utils/mount.8.adoc:418
30840 "If only one argument for the *mount* command is given, then the argument "
30841 "might be interpreted as the target (mountpoint) or source (device). This "
30842 "option allows you to explicitly define that the argument is the mount source."
30845 #. type: Labeled list
30846 #: ../sys-utils/mount.8.adoc:419
30848 msgid "*--target* _directory_"
30851 #. type: Plain text
30852 #: ../sys-utils/mount.8.adoc:421
30854 "If only one argument for the mount command is given, then the argument might "
30855 "be interpreted as the target (mountpoint) or source (device). This option "
30856 "allows you to explicitly define that the argument is the mount target."
30859 #. type: Labeled list
30860 #: ../sys-utils/mount.8.adoc:422
30862 msgid "*--target-prefix* _directory_"
30865 #. type: Plain text
30866 #: ../sys-utils/mount.8.adoc:424
30868 "Prepend the specified directory to all mount targets. This option can be "
30869 "used to follow _fstab_, but mount operations are done in another place, for "
30873 #. type: Plain text
30874 #: ../sys-utils/mount.8.adoc:426
30876 msgid "*mount --all --target-prefix /chroot -o X-mount.mkdir*\n"
30879 #. type: Plain text
30880 #: ../sys-utils/mount.8.adoc:428
30882 "mounts all from system _fstab_ to _/chroot_, all missing mountpoint are "
30883 "created (due to X-mount.mkdir). See also *--fstab* to use an alternative "
30887 #. type: Labeled list
30888 #: ../sys-utils/mount.8.adoc:429 ../sys-utils/swapon.8.adoc:34
30890 #| msgid "*-f*, *--fast*"
30891 msgid "*-T*, *--fstab* _path_"
30892 msgstr "*-f*, *--fast*"
30894 #. type: Plain text
30895 #: ../sys-utils/mount.8.adoc:431
30897 "Specifies an alternative _fstab_ file. If _path_ is a directory, then the "
30898 "files in the directory are sorted by *strverscmp*(3); files that start with "
30899 "\".\" or without an _.fstab_ extension are ignored. The option can be "
30900 "specified more than once. This option is mostly designed for initramfs or "
30901 "chroot scripts where additional configuration is specified beyond standard "
30902 "system configuration."
30905 #. type: Plain text
30906 #: ../sys-utils/mount.8.adoc:433
30908 "Note that *mount* does not pass the option *--fstab* to the **/sbin/mount."
30909 "**__type__ helpers, meaning that the alternative _fstab_ files will be "
30910 "invisible for the helpers. This is no problem for normal mounts, but user "
30911 "(non-root) mounts always require _fstab_ to verify the user's rights."
30914 #. type: Labeled list
30915 #: ../sys-utils/mount.8.adoc:434
30917 msgid "*-t*, *--types* _fstype_"
30920 #. type: Plain text
30921 #: ../sys-utils/mount.8.adoc:436
30923 "The argument following the *-t* is used to indicate the filesystem type. The "
30924 "filesystem types which are currently supported depend on the running kernel. "
30925 "See _/proc/filesystems_ and _/lib/modules/$(uname -r)/kernel/fs_ for a "
30926 "complete list of the filesystems. The most common are ext2, ext3, ext4, xfs, "
30927 "btrfs, vfat, sysfs, proc, nfs and cifs."
30930 #. type: Plain text
30931 #: ../sys-utils/mount.8.adoc:438
30934 #| "*mount*(8) and *umount*(8) support filesystem _subtypes_. The subtype is "
30935 #| "defined by '.subtype' suffix. For example 'fuse.sshfs'. It's recommended "
30936 #| "to use subtype notation rather than add any prefix to the first fstab "
30937 #| "field (for example 'sshfs#example.com' is deprecated).\n"
30939 "The programs *mount* and *umount*(8) support filesystem subtypes. The "
30940 "subtype is defined by a '.subtype' suffix. For example 'fuse.sshfs'. It's "
30941 "recommended to use subtype notation rather than add any prefix to the mount "
30942 "source (for example 'sshfs#example.com' is deprecated)."
30944 "*mount*(8) a *umount*(8) podporují _podtypy_ souborových systémů. Podtyp se "
30945 "definuje pomocí přípony „.subtype“. Například „fuse.sshfs“. Je doporučeno "
30946 "použít zápis podtypem než přidávat předponu do první položky fstabu (příklad "
30947 "zastaralého použití je „sshfs#example.com“).\n"
30949 #. TRANSLATORS: Keep {asterisk} untranslated.
30950 #. type: Plain text
30951 #: ../sys-utils/mount.8.adoc:440
30953 "If no *-t* option is given, or if the *auto* type is specified, *mount* will "
30954 "try to guess the desired type. *mount* uses the *libblkid*(3) library for "
30955 "guessing the filesystem type; if that does not turn up anything that looks "
30956 "familiar, *mount* will try to read the file _/etc/filesystems_, or, if that "
30957 "does not exist, _/proc/filesystems_. All of the filesystem types listed "
30958 "there will be tried, except for those that are labeled \"nodev\" (e.g. "
30959 "_devpts_, _proc_ and _nfs_). If _/etc/filesystems_ ends in a line with a "
30960 "single {asterisk}, mount will read _/proc/filesystems_ afterwards. While "
30961 "trying, all filesystem types will be mounted with the mount option *silent*."
30964 #. type: Plain text
30965 #: ../sys-utils/mount.8.adoc:443
30967 "The *auto* type may be useful for user-mounted floppies. Creating a file _/"
30968 "etc/filesystems_ can be useful to change the probe order (e.g., to try vfat "
30969 "before msdos or ext3 before ext2) or if you use a kernel module autoloader."
30972 #. type: Plain text
30973 #: ../sys-utils/mount.8.adoc:445
30975 "More than one type may be specified in a comma-separated list, for the *-t* "
30976 "option as well as in an _/etc/fstab_ entry. The list of filesystem types for "
30977 "the *-t* option can be prefixed with *no* to specify the filesystem types on "
30978 "which no action should be taken. The prefix *no* has no effect when "
30979 "specified in an _/etc/fstab_ entry."
30982 #. type: Plain text
30983 #: ../sys-utils/mount.8.adoc:447
30985 "The prefix *no* can be meaningful with the *-a* option. For example, the "
30989 #. type: Plain text
30990 #: ../sys-utils/mount.8.adoc:449
30992 msgid "*mount -a -t nomsdos,smbfs*\n"
30995 #. type: Plain text
30996 #: ../sys-utils/mount.8.adoc:451
30997 msgid "mounts all filesystems except those of type _msdos_ and _smbfs_."
31000 #. type: Plain text
31001 #: ../sys-utils/mount.8.adoc:453
31003 "For most types all the *mount* program has to do is issue a simple "
31004 "*mount*(2) system call, and no detailed knowledge of the filesystem type is "
31005 "required. For a few types however (like nfs, nfs4, cifs, smbfs, ncpfs) an ad "
31006 "hoc code is necessary. The nfs, nfs4, cifs, smbfs, and ncpfs filesystems "
31007 "have a separate mount program. In order to make it possible to treat all "
31008 "types in a uniform way, *mount* will execute the program **/sbin/mount."
31009 "**__type__ (if that exists) when called with type _type_. Since different "
31010 "versions of the *smbmount* program have different calling conventions, */"
31011 "sbin/mount.smbfs* may have to be a shell script that sets up the desired "
31015 #. type: Plain text
31016 #: ../sys-utils/mount.8.adoc:456
31017 msgid "Mount the partition that has the specified _uuid_."
31020 #. type: Labeled list
31021 #: ../sys-utils/mount.8.adoc:460
31023 #| msgid "*-*, *-l*, *--login*"
31024 msgid "*-w*, *--rw*, *--read-write*"
31025 msgstr "*-*, *-l*, *--login*"
31027 #. type: Plain text
31028 #: ../sys-utils/mount.8.adoc:462
31030 "Mount the filesystem read/write. Read-write is the kernel default and the "
31031 "*mount* default is to try read-only if the previous *mount*(2) syscall with "
31032 "read-write flags on write-protected devices failed."
31035 #. type: Plain text
31036 #: ../sys-utils/mount.8.adoc:464
31037 msgid "A synonym is *-o rw*."
31040 #. type: Plain text
31041 #: ../sys-utils/mount.8.adoc:466
31043 "Note that specifying *-w* on the command line forces *mount* to never try "
31044 "read-only mount on write-protected devices or already mounted read-only "
31049 #: ../sys-utils/mount.8.adoc:469
31051 msgid "FILESYSTEM-INDEPENDENT MOUNT OPTIONS"
31054 #. type: Plain text
31055 #: ../sys-utils/mount.8.adoc:472
31057 "Some of these options are only useful when they appear in the _/etc/fstab_ "
31061 #. type: Plain text
31062 #: ../sys-utils/mount.8.adoc:474
31064 "Some of these options could be enabled or disabled by default in the system "
31065 "kernel. To check the current setting see the options in _/proc/mounts_. Note "
31066 "that filesystems also have per-filesystem specific default mount options "
31067 "(see for example *tune2fs -l* output for ext__N__ filesystems)."
31070 #. type: Plain text
31071 #: ../sys-utils/mount.8.adoc:476
31073 "The options *nosuid*, *noexec*, *nodiratime*, *relatime*, *noatime*, "
31074 "*strictatime*, and *nosymfollow* are interpreted only by the abstract VFS "
31075 "kernel layer and applied to the mountpoint node rather than to the "
31076 "filesystem itself. Try:"
31079 #. type: delimited block _
31080 #: ../sys-utils/mount.8.adoc:479
31082 msgid " findmnt -o TARGET,VFS-OPTIONS,FS-OPTIONS\n"
31085 #. type: Plain text
31086 #: ../sys-utils/mount.8.adoc:482
31087 msgid "to get a complete overview of filesystems and VFS options."
31090 #. type: Plain text
31091 #: ../sys-utils/mount.8.adoc:489
31093 "The read-only setting (*ro* or *rw*) is interpreted by VFS and the "
31094 "filesystem and depends on how the option is specified on the *mount*(8) "
31095 "command line. The default is to interpret it on the filesystem level. The "
31096 "operation \"-o bind,remount,ro\" is applied only to the VFS mountpoint, and "
31097 "operation \"-o remount,ro\" is applied to VFS and filesystem superblock. "
31098 "This semantic allows create a read-only mountpoint but keeps the filesystem "
31099 "writable from another mountpoint."
31102 #. type: Plain text
31103 #: ../sys-utils/mount.8.adoc:494
31105 "Since v2.39 libmount can use a new kernel mount interface to set the VFS "
31106 "options recursive. For backward compatibility, this feature is not enabled "
31107 "by default, although recursive operation (e.g. rbind) has been requested. "
31108 "The new option argument \"recursive\" could be specified, for example:"
31111 #. type: delimited block _
31112 #: ../sys-utils/mount.8.adoc:497
31114 msgid " mount -orbind,ro=recursive,noexec=recursive,nosuid /foo /bar\n"
31117 #. type: Plain text
31118 #: ../sys-utils/mount.8.adoc:502
31120 "recursively binds filesystems from /foo to /bar, /bar, and all submounts "
31121 "will be read-only and noexec, but only /bar itself will be \"nosuid\". The "
31122 "\"recursive\" optional argument for VFS mount options is an EXPERIMENTAL "
31126 #. type: Plain text
31127 #: ../sys-utils/mount.8.adoc:504
31129 "The following options apply to any filesystem that is being mounted (but not "
31130 "every filesystem actually honors them - e.g., the *sync* option today has an "
31131 "effect only for ext2, ext3, ext4, fat, vfat, ufs and xfs):"
31134 #. type: Labeled list
31135 #: ../sys-utils/mount.8.adoc:505
31140 #. type: Plain text
31141 #: ../sys-utils/mount.8.adoc:507
31143 "All I/O to the filesystem should be done asynchronously. (See also the "
31147 #. type: Labeled list
31148 #: ../sys-utils/mount.8.adoc:508
31153 #. type: Plain text
31154 #: ../sys-utils/mount.8.adoc:510
31156 "Do not use the *noatime* feature, so the inode access time is controlled by "
31157 "kernel defaults. See also the descriptions of the *relatime* and "
31158 "*strictatime* mount options."
31161 #. type: Labeled list
31162 #: ../sys-utils/mount.8.adoc:511
31164 #| msgid "*noauto*"
31168 #. type: Plain text
31169 #: ../sys-utils/mount.8.adoc:513
31171 "Do not update inode access times on this filesystem (e.g. for faster access "
31172 "on the news spool to speed up news servers). This works for all inode types "
31173 "(directories too), so it implies *nodiratime*."
31176 #. type: Labeled list
31177 #: ../sys-utils/mount.8.adoc:514
31179 #| msgid "*noauto*"
31183 #. type: Plain text
31184 #: ../sys-utils/mount.8.adoc:516
31186 #| msgid "Pass _command_ to the shell with the *-c* option."
31187 msgid "Can be mounted with the *-a* option."
31188 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
31190 #. type: Plain text
31191 #: ../sys-utils/mount.8.adoc:519
31193 "Can only be mounted explicitly (i.e., the *-a* option will not cause the "
31194 "filesystem to be mounted)."
31197 #. type: Labeled list
31198 #: ../sys-utils/mount.8.adoc:520
31200 msgid "**context=**__context__, **fscontext=**__context__, **defcontext=**__context__, and **rootcontext=**__context__"
31203 #. type: Plain text
31204 #: ../sys-utils/mount.8.adoc:522
31206 "The *context=* option is useful when mounting filesystems that do not "
31207 "support extended attributes, such as a floppy or hard disk formatted with "
31208 "VFAT, or systems that are not normally running under SELinux, such as an "
31209 "ext3 or ext4 formatted disk from a non-SELinux workstation. You can also use "
31210 "*context=* on filesystems you do not trust, such as a floppy. It also helps "
31211 "in compatibility with xattr-supporting filesystems on earlier 2.4.<x> kernel "
31212 "versions. Even where xattrs are supported, you can save time not having to "
31213 "label every file by assigning the entire disk one security context."
31216 #. type: Plain text
31217 #: ../sys-utils/mount.8.adoc:524
31219 "A commonly used option for removable media is *context=\"system_u:object_r:"
31223 #. type: Plain text
31224 #: ../sys-utils/mount.8.adoc:526
31226 "The *fscontext=* option works for all filesystems, regardless of their xattr "
31227 "support. The fscontext option sets the overarching filesystem label to a "
31228 "specific security context. This filesystem label is separate from the "
31229 "individual labels on the files. It represents the entire filesystem for "
31230 "certain kinds of permission checks, such as during mount or file creation. "
31231 "Individual file labels are still obtained from the xattrs on the files "
31232 "themselves. The context option actually sets the aggregate context that "
31233 "fscontext provides, in addition to supplying the same label for individual "
31237 #. type: Plain text
31238 #: ../sys-utils/mount.8.adoc:528
31240 "You can set the default security context for unlabeled files using "
31241 "*defcontext=* option. This overrides the value set for unlabeled files in "
31242 "the policy and requires a filesystem that supports xattr labeling."
31245 #. type: Plain text
31246 #: ../sys-utils/mount.8.adoc:530
31248 "The *rootcontext=* option allows you to explicitly label the root inode of a "
31249 "FS being mounted before that FS or inode becomes visible to userspace. This "
31250 "was found to be useful for things like stateless Linux. The special value "
31251 "*@target* can be used to assign the current context of the target mountpoint "
31255 #. type: Plain text
31256 #: ../sys-utils/mount.8.adoc:532
31258 "Note that the kernel rejects any remount request that includes the context "
31259 "option, *even* when unchanged from the current context."
31262 #. type: Plain text
31263 #: ../sys-utils/mount.8.adoc:534
31265 msgid "*Warning: the* _context_ *value might contain commas*, in which case the value has to be properly quoted, otherwise *mount* will interpret the comma as a separator between mount options. Don't forget that the shell strips off quotes and thus *double quoting is required*. For example:\n"
31268 #. type: delimited block .
31269 #: ../sys-utils/mount.8.adoc:539
31272 "mount -t tmpfs none /mnt -o \\\n"
31273 "'context=\"system_u:object_r:tmp_t:s0:c127,c456\",noexec'\n"
31276 #. type: delimited block _
31277 #: ../sys-utils/mount.8.adoc:543
31278 msgid "For more details, see *selinux*(8)."
31281 #. type: delimited block _
31282 #: ../sys-utils/mount.8.adoc:546
31284 #| msgid "use default options: rw, suid, dev, exec, auto, nouser, and async."
31286 "Use the default options: *rw*, *suid*, *dev*, *exec*, *auto*, *nouser*, and "
31288 msgstr "použije výchozí volby: rw, suid, dev, exec, auto, nouser a async."
31290 #. type: delimited block _
31291 #: ../sys-utils/mount.8.adoc:548
31293 "Note that the real set of all default mount options depends on the kernel "
31294 "and filesystem type. See the beginning of this section for more details."
31297 #. type: Labeled list
31298 #: ../sys-utils/mount.8.adoc:549
31303 #. type: delimited block _
31304 #: ../sys-utils/mount.8.adoc:551
31305 msgid "Interpret character or block special devices on the filesystem."
31308 #. type: Labeled list
31309 #: ../sys-utils/mount.8.adoc:552
31314 #. type: delimited block _
31315 #: ../sys-utils/mount.8.adoc:554
31316 msgid "Do not interpret character or block special devices on the filesystem."
31319 #. type: Labeled list
31320 #: ../sys-utils/mount.8.adoc:555
31325 #. type: delimited block _
31326 #: ../sys-utils/mount.8.adoc:557
31328 "Update directory inode access times on this filesystem. This is the default. "
31329 "(This option is ignored when *noatime* is set.)"
31332 #. type: Labeled list
31333 #: ../sys-utils/mount.8.adoc:558
31335 msgid "*nodiratime*"
31338 #. type: delimited block _
31339 #: ../sys-utils/mount.8.adoc:560
31341 "Do not update directory inode access times on this filesystem. (This option "
31342 "is implied when *noatime* is set.)"
31345 #. type: Labeled list
31346 #: ../sys-utils/mount.8.adoc:561
31351 #. type: delimited block _
31352 #: ../sys-utils/mount.8.adoc:563
31354 "All directory updates within the filesystem should be done synchronously. "
31355 "This affects the following system calls: *creat*(2), *link*(2), *unlink*(2), "
31356 "*symlink*(2), *mkdir*(2), *rmdir*(2), *mknod*(2) and *rename*(2)."
31359 #. type: Labeled list
31360 #: ../sys-utils/mount.8.adoc:564
31365 #. type: delimited block _
31366 #: ../sys-utils/mount.8.adoc:566
31367 msgid "Permit execution of binaries and other executable files."
31370 #. type: Labeled list
31371 #: ../sys-utils/mount.8.adoc:567
31376 #. type: delimited block _
31377 #: ../sys-utils/mount.8.adoc:569
31379 "Do not permit direct execution of any binaries on the mounted filesystem."
31382 #. type: Labeled list
31383 #: ../sys-utils/mount.8.adoc:570
31388 #. type: delimited block _
31389 #: ../sys-utils/mount.8.adoc:572
31391 "Allow an ordinary user to mount the filesystem if one of that user's groups "
31392 "matches the group of the device. This option implies the options *nosuid* "
31393 "and *nodev* (unless overridden by subsequent options, as in the option line "
31394 "*group,dev,suid*)."
31397 #. type: Labeled list
31398 #: ../sys-utils/mount.8.adoc:573
31400 #| msgid "*-V*, *--version*"
31402 msgstr "*-V*, *--version*"
31404 #. type: delimited block _
31405 #: ../sys-utils/mount.8.adoc:575
31407 "Every time the inode is modified, the i_version field will be incremented."
31410 #. type: Labeled list
31411 #: ../sys-utils/mount.8.adoc:576
31413 #| msgid "*-V*, *--version*"
31414 msgid "*noiversion*"
31415 msgstr "*-V*, *--version*"
31417 #. type: delimited block _
31418 #: ../sys-utils/mount.8.adoc:578
31419 msgid "Do not increment the i_version inode field."
31422 #. type: Labeled list
31423 #: ../sys-utils/mount.8.adoc:579
31428 #. type: delimited block _
31429 #: ../sys-utils/mount.8.adoc:581
31431 "Allow mandatory locks on this filesystem. See *fcntl*(2). This option was "
31432 "deprecated in Linux 5.15."
31435 #. type: Labeled list
31436 #: ../sys-utils/mount.8.adoc:582
31441 #. type: delimited block _
31442 #: ../sys-utils/mount.8.adoc:584
31443 msgid "Do not allow mandatory locks on this filesystem."
31446 #. type: Labeled list
31447 #: ../sys-utils/mount.8.adoc:585
31452 #. type: delimited block _
31453 #: ../sys-utils/mount.8.adoc:587
31455 "The filesystem resides on a device that requires network access (used to "
31456 "prevent the system from attempting to mount these filesystems until the "
31457 "network has been enabled on the system)."
31460 #. type: delimited block _
31461 #: ../sys-utils/mount.8.adoc:590
31463 #| msgid "do not report errors for this device if it does not exist."
31464 msgid "Do not report errors for this device if it does not exist."
31465 msgstr "nehlásí chyby k tomuto zařízení, pokud toto zařízení neexistuje."
31467 #. type: Labeled list
31468 #: ../sys-utils/mount.8.adoc:591
31473 #. type: delimited block _
31474 #: ../sys-utils/mount.8.adoc:593
31476 "Update inode access times relative to modify or change time. Access time is "
31477 "only updated if the previous access time was earlier than or equal to the "
31478 "current modify or change time. (Similar to *noatime*, but it doesn't break "
31479 "*mutt*(1) or other applications that need to know if a file has been read "
31480 "since the last time it was modified.)"
31483 #. type: delimited block _
31484 #: ../sys-utils/mount.8.adoc:595
31486 "Since Linux 2.6.30, the kernel defaults to the behavior provided by this "
31487 "option (unless *noatime* was specified), and the *strictatime* option is "
31488 "required to obtain traditional semantics. In addition, since Linux 2.6.30, "
31489 "the file's last access time is always updated if it is more than 1 day old."
31492 #. type: Labeled list
31493 #: ../sys-utils/mount.8.adoc:596
31495 msgid "*norelatime*"
31498 #. type: delimited block _
31499 #: ../sys-utils/mount.8.adoc:598
31501 "Do not use the *relatime* feature. See also the *strictatime* mount option."
31504 #. type: Labeled list
31505 #: ../sys-utils/mount.8.adoc:599
31507 msgid "*strictatime*"
31510 #. type: delimited block _
31511 #: ../sys-utils/mount.8.adoc:601
31513 "Allows to explicitly request full atime updates. This makes it possible for "
31514 "the kernel to default to *relatime* or *noatime* but still allow userspace "
31515 "to override it. For more details about the default system mount options see "
31519 #. type: Labeled list
31520 #: ../sys-utils/mount.8.adoc:602
31522 msgid "*nostrictatime*"
31525 #. type: delimited block _
31526 #: ../sys-utils/mount.8.adoc:604
31527 msgid "Use the kernel's default behavior for inode access time updates."
31530 #. type: Labeled list
31531 #: ../sys-utils/mount.8.adoc:605
31536 #. type: delimited block _
31537 #: ../sys-utils/mount.8.adoc:607
31539 "Only update times (atime, mtime, ctime) on the in-memory version of the file "
31543 #. type: delimited block _
31544 #: ../sys-utils/mount.8.adoc:609
31546 "This mount option significantly reduces writes to the inode table for "
31547 "workloads that perform frequent random writes to preallocated files."
31550 #. type: delimited block _
31551 #: ../sys-utils/mount.8.adoc:611
31552 msgid "The on-disk timestamps are updated only when:"
31555 #. type: delimited block _
31556 #: ../sys-utils/mount.8.adoc:613
31558 "the inode needs to be updated for some change unrelated to file timestamps"
31561 #. type: delimited block _
31562 #: ../sys-utils/mount.8.adoc:614
31563 msgid "the application employs *fsync*(2), *syncfs*(2), or *sync*(2)"
31566 #. type: delimited block _
31567 #: ../sys-utils/mount.8.adoc:615
31568 msgid "an undeleted inode is evicted from memory"
31571 #. type: delimited block _
31572 #: ../sys-utils/mount.8.adoc:616
31573 msgid "more than 24 hours have passed since the inode was written to disk."
31576 #. type: Labeled list
31577 #: ../sys-utils/mount.8.adoc:617
31579 msgid "*nolazytime*"
31582 #. type: delimited block _
31583 #: ../sys-utils/mount.8.adoc:619
31584 msgid "Do not use the lazytime feature."
31587 #. type: Labeled list
31588 #: ../sys-utils/mount.8.adoc:620
31593 #. type: delimited block _
31594 #: ../sys-utils/mount.8.adoc:622
31596 "Honor set-user-ID and set-group-ID bits or file capabilities when executing "
31597 "programs from this filesystem."
31600 #. type: Labeled list
31601 #: ../sys-utils/mount.8.adoc:623
31606 #. type: delimited block _
31607 #: ../sys-utils/mount.8.adoc:625
31609 "Do not honor set-user-ID and set-group-ID bits or file capabilities when "
31610 "executing programs from this filesystem. In addition, SELinux domain "
31611 "transitions require permission _nosuid_transition_, which in turn needs also "
31612 "policy capability _nnp_nosuid_transition_."
31615 #. type: Labeled list
31616 #: ../sys-utils/mount.8.adoc:626
31621 #. type: delimited block _
31622 #: ../sys-utils/mount.8.adoc:628
31623 msgid "Turn on the silent flag."
31626 #. type: Labeled list
31627 #: ../sys-utils/mount.8.adoc:629
31632 #. type: delimited block _
31633 #: ../sys-utils/mount.8.adoc:631
31634 msgid "Turn off the silent flag."
31637 #. type: delimited block _
31638 #: ../sys-utils/mount.8.adoc:634
31640 "Allow an ordinary user to mount the filesystem if that user is the owner of "
31641 "the device. This option implies the options *nosuid* and *nodev* (unless "
31642 "overridden by subsequent options, as in the option line *owner,dev,suid*)."
31645 #. type: Labeled list
31646 #: ../sys-utils/mount.8.adoc:635
31651 #. type: delimited block _
31652 #: ../sys-utils/mount.8.adoc:637
31654 "Attempt to remount an already-mounted filesystem. This is commonly used to "
31655 "change the mount flags for a filesystem, especially to make a readonly "
31656 "filesystem writable. It does not change device or mount point."
31659 #. type: delimited block _
31660 #: ../sys-utils/mount.8.adoc:639
31662 "The remount operation together with the *bind* flag has special semantics. "
31663 "See above, the subsection *Bind mount operation*."
31666 #. type: delimited block _
31667 #: ../sys-utils/mount.8.adoc:648
31669 "The default kernel behavior for VFS mount flags (nodev,nosuid,noexec,ro) is "
31670 "to reset all unspecified flags on remount. That's why *mount*(8) tries to "
31671 "keep the current setting according to _fstab_ or _/proc/self/mountinfo_. "
31672 "This default behavior is possible to change by *--options-mode*. The "
31673 "recursive change of the mount flags (supported since v2.39 on systems with "
31674 "*mount_setattr*(2) syscall), for example, *mount -o remount,ro=recursive*, "
31675 "do not use \"reset-unspecified\" behavior, and it works as a simple add/"
31676 "remove operation and unspecified flags are not modified."
31679 #. type: delimited block _
31680 #: ../sys-utils/mount.8.adoc:650
31682 "The remount functionality follows the standard way the *mount* command works "
31683 "with options from _fstab_. This means that *mount* does not read _fstab_ (or "
31684 "_mtab_) only when both _device_ and _dir_ are specified."
31687 #. type: delimited block _
31688 #: ../sys-utils/mount.8.adoc:652
31690 msgid "*mount -o remount,rw /dev/foo /dir*\n"
31693 #. type: delimited block _
31694 #: ../sys-utils/mount.8.adoc:654
31696 "After this call all old mount options are replaced and arbitrary stuff from "
31697 "_fstab_ (or _mtab_) is ignored, except the *loop=* option which is "
31698 "internally generated and maintained by the *mount* command."
31701 #. type: delimited block _
31702 #: ../sys-utils/mount.8.adoc:656
31704 msgid "*mount -o remount,rw /dir*\n"
31707 #. type: delimited block _
31708 #: ../sys-utils/mount.8.adoc:658
31710 "After this call, *mount* reads _fstab_ and merges these options with the "
31711 "options from the command line (*-o*). If no mountpoint is found in _fstab_, "
31712 "then it defaults to mount options from _/proc/self/mountinfo_."
31715 #. type: delimited block _
31716 #: ../sys-utils/mount.8.adoc:661
31718 msgid "*mount* allows the use of *--all* to remount all already mounted filesystems which match a specified filter (*-O* and *-t*). For example:\n"
31721 #. type: delimited block _
31722 #: ../sys-utils/mount.8.adoc:663
31724 msgid "*mount --all -o remount,ro -t vfat*\n"
31727 #. type: delimited block _
31728 #: ../sys-utils/mount.8.adoc:665
31730 "remounts all already mounted vfat filesystems in read-only mode. Each of the "
31731 "filesystems is remounted by *mount -o remount,ro* _/dir_ semantic. This "
31732 "means the *mount* command reads _fstab_ or _mtab_ and merges these options "
31733 "with the options from the command line."
31736 #. type: Labeled list
31737 #: ../sys-utils/mount.8.adoc:666
31742 #. type: delimited block _
31743 #: ../sys-utils/mount.8.adoc:668
31744 msgid "Mount the filesystem read-only."
31747 #. type: Labeled list
31748 #: ../sys-utils/mount.8.adoc:669
31753 #. type: delimited block _
31754 #: ../sys-utils/mount.8.adoc:671
31755 msgid "Mount the filesystem read-write."
31758 #. type: Labeled list
31759 #: ../sys-utils/mount.8.adoc:672
31764 #. type: delimited block _
31765 #: ../sys-utils/mount.8.adoc:674
31767 "All I/O to the filesystem should be done synchronously. In the case of media "
31768 "with a limited number of write cycles (e.g. some flash drives), *sync* may "
31769 "cause life-cycle shortening."
31772 #. type: delimited block _
31773 #: ../sys-utils/mount.8.adoc:677
31775 "Allow an ordinary user to mount the filesystem. The name of the mounting "
31776 "user is written to the _mtab_ file (or to the private libmount file in _/run/"
31777 "mount_ on systems without a regular _mtab_) so that this same user can "
31778 "unmount the filesystem again. This option implies the options *noexec*, "
31779 "*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
31780 "option line *user,exec,dev,suid*)."
31783 #. type: Labeled list
31784 #: ../sys-utils/mount.8.adoc:678
31790 #. type: delimited block _
31791 #: ../sys-utils/mount.8.adoc:680
31793 "Forbid an ordinary user to mount the filesystem. This is the default; it "
31794 "does not imply any other options."
31797 #. type: Labeled list
31798 #: ../sys-utils/mount.8.adoc:681
31804 #. type: delimited block _
31805 #: ../sys-utils/mount.8.adoc:683
31807 "Allow any user to mount and to unmount the filesystem, even when some other "
31808 "ordinary user mounted it. This option implies the options *noexec*, "
31809 "*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
31810 "option line *users,exec,dev,suid*)."
31813 #. type: Labeled list
31814 #: ../sys-utils/mount.8.adoc:684
31819 #. type: delimited block _
31820 #: ../sys-utils/mount.8.adoc:686
31822 "All options prefixed with \"X-\" are interpreted as comments or as userspace "
31823 "application-specific options. These options are not stored in user space (e."
31824 "g., _mtab_ file), nor sent to the mount._type_ helpers nor to the *mount*(2) "
31825 "system call. The suggested format is **X-**__appname__._option_."
31828 #. type: Labeled list
31829 #: ../sys-utils/mount.8.adoc:687
31834 #. type: delimited block _
31835 #: ../sys-utils/mount.8.adoc:689
31837 "The same as *X-** options, but stored permanently in user space. This means "
31838 "the options are also available for *umount*(8) or other operations. Note "
31839 "that maintaining mount options in user space is tricky, because it's "
31840 "necessary use libmount-based tools and there is no guarantee that the "
31841 "options will be always available (for example after a move mount operation "
31842 "or in unshared namespace)."
31845 #. type: delimited block _
31846 #: ../sys-utils/mount.8.adoc:691
31848 "Note that before util-linux v2.30 the x-* options have not been maintained "
31849 "by libmount and stored in user space (functionality was the same as for X-* "
31850 "now), but due to the growing number of use-cases (in initrd, systemd etc.) "
31851 "the functionality has been extended to keep existing _fstab_ configurations "
31852 "usable without a change."
31855 #. type: Labeled list
31856 #: ../sys-utils/mount.8.adoc:692
31858 #| msgid "*-P*, *--pty*"
31859 msgid "*X-mount.auto-fstypes*=_list_"
31860 msgstr "*-P*, *--pty*"
31862 #. type: delimited block _
31863 #: ../sys-utils/mount.8.adoc:695
31865 "Specifies allowed or forbidden filesystem types for automatic filesystem "
31869 #. type: delimited block _
31870 #: ../sys-utils/mount.8.adoc:699
31872 "The _list_ is a comma-separated list of the filesystem names. The automatic "
31873 "filesystem detection is triggered by the \"auto\" filesystem type or when "
31874 "the filesystem type is not specified."
31877 #. type: delimited block _
31878 #: ../sys-utils/mount.8.adoc:704
31880 "Thy _list_ follows how mount evaluates type patterns (see *-t* for more "
31881 "details). Only specified filesystem types are allowed, or all specified "
31882 "types are forbidden if the list is prefixed by \"no\"."
31885 #. type: delimited block _
31886 #: ../sys-utils/mount.8.adoc:708
31888 "For example, X-mount.auto-fstypes=\"ext4,btrfs\" accepts only ext4 and "
31889 "btrfs, and X-mount.auto-fstypes=\"novfat,xfs\" accepts all filesystems "
31890 "except vfat and xfs."
31893 #. type: delimited block _
31894 #: ../sys-utils/mount.8.adoc:712
31896 "Note that comma is used as a separator between mount options, it means that "
31897 "auto-fstypes values have to be properly quoted, donâ
\80\99t forget that the shell "
31898 "strips off quotes and thus double quoting is required. For example:"
31901 #. type: Plain text
31902 #: ../sys-utils/mount.8.adoc:714
31904 "mount -t auto -o'X-mount.auto-fstypes=\"noext2,ext3\"' /dev/sdc1 /mnt/test"
31907 #. type: Labeled list
31908 #: ../sys-utils/mount.8.adoc:716
31910 msgid "*X-mount.mkdir*[=_mode_]"
31913 #. type: delimited block _
31914 #: ../sys-utils/mount.8.adoc:718
31916 "Allow to make a target directory (mountpoint) if it does not exist yet. The "
31917 "optional argument _mode_ specifies the filesystem access mode used for "
31918 "*mkdir*(2) in octal notation. The default mode is 0755. This functionality "
31919 "is supported only for root users or when *mount* is executed without suid "
31920 "permissions. The option is also supported as *x-mount.mkdir*, but this "
31921 "notation is deprecated since v2.30. See also *--mkdir* command line option."
31924 #. type: Labeled list
31925 #: ../sys-utils/mount.8.adoc:719
31927 msgid "**X-mount.subdir=**__directory__"
31930 #. type: delimited block _
31931 #: ../sys-utils/mount.8.adoc:721
31933 "Allow mounting sub-directory from a filesystem instead of the root "
31934 "directory. For now, this feature is implemented by temporary filesystem root "
31935 "directory mount in unshared namespace and then bind the sub-directory to the "
31936 "final mount point and umount the root of the filesystem. The sub-directory "
31937 "mount shows up atomically for the rest of the system although it is "
31938 "implemented by multiple *mount*(2) syscalls."
31941 #. type: delimited block _
31942 #: ../sys-utils/mount.8.adoc:723
31944 "Note that this feature will not work in session with an unshared private "
31945 "mount namespace (after *unshare --mount*) on old kernels or with *mount*(8) "
31946 "without support for file-descriptors-based mount kernel API. In this case, "
31947 "you need *unshare --mount --propagation shared*."
31950 #. type: delimited block _
31951 #: ../sys-utils/mount.8.adoc:725
31952 msgid "This feature is EXPERIMENTAL."
31955 #. type: Labeled list
31956 #: ../sys-utils/mount.8.adoc:726
31958 msgid "*X-mount.owner*=_username_|_UID_, *X-mount.group*=_group_|_GID_"
31961 #. type: delimited block _
31962 #: ../sys-utils/mount.8.adoc:728
31964 "Set _mountpoint_'s ownership after mounting. Names resolved in the target "
31965 "mount namespace, see *-N*."
31968 #. type: Labeled list
31969 #: ../sys-utils/mount.8.adoc:729
31971 msgid "*X-mount.mode*=_mode_"
31974 #. type: delimited block _
31975 #: ../sys-utils/mount.8.adoc:731
31976 msgid "Set _mountpoint_'s mode after mounting."
31979 #. type: Labeled list
31980 #: ../sys-utils/mount.8.adoc:732
31982 msgid "*X-mount.idmap*=__id-type__:__id-mount__:__id-host__:__id-range__ [__id-type__:__id-mount__:__id-host__:__id-range__], *X-mount.idmap*=__file__"
31985 #. type: delimited block _
31986 #: ../sys-utils/mount.8.adoc:737
31988 "Use this option to create an idmapped mount. An idmapped mount allows to "
31989 "change ownership of all files located under a mount according to the ID-"
31990 "mapping associated with a user namespace. The ownership change is tied to "
31991 "the lifetime and localized to the relevant mount. The relevant ID-mapping "
31992 "can be specified in two ways:"
31995 #. type: delimited block _
31996 #: ../sys-utils/mount.8.adoc:739
31997 msgid "A user can specify the ID-mapping directly."
32000 #. type: delimited block _
32001 #: ../sys-utils/mount.8.adoc:747
32003 "The ID-mapping must be specified using the syntax __id-type__:__id-mount__:"
32004 "__id-host__:__id-range__. Specifying *u* as the __id-type__ prefix creates "
32005 "a UID-mapping, *g* creates a GID-mapping and omitting __id-type__ or "
32006 "specifying *b* creates both a UID- and GID-mapping. The __id-mount__ "
32007 "parameter indicates the starting ID in the new mount. The __id-host__ "
32008 "parameter indicates the starting ID in the filesystem. The __id-range__ "
32009 "parameter indicates how many IDs are to be mapped. It is possible to "
32010 "specify multiple ID-mappings. The individual ID-mappings must be separated "
32014 #. type: delimited block _
32015 #: ../sys-utils/mount.8.adoc:750
32017 "For example, the ID-mapping *X-mount.idmap=u:1000:0:1 g:1001:1:2 "
32018 "5000:1000:2* creates an idmapped mount where UID 0 is mapped to UID 1000, "
32019 "GID 1 is mapped to GUID 1001, GID 2 is mapped to GID 1002, UID and GID 1000 "
32020 "are mapped to 5000, and UID and GID 1001 are mapped to 5001 in the mount."
32023 #. type: delimited block _
32024 #: ../sys-utils/mount.8.adoc:753
32026 "When an ID-mapping is specified directly a new user namespace will be "
32027 "allocated with the requested ID-mapping. The newly created user namespace "
32028 "will be attached to the mount."
32031 #. type: delimited block _
32032 #: ../sys-utils/mount.8.adoc:754
32033 msgid "A user can specify a user namespace file."
32036 #. type: delimited block _
32037 #: ../sys-utils/mount.8.adoc:756
32039 "The user namespace will then be attached to the mount and the ID-mapping of "
32040 "the user namespace will become the ID-mapping of the mount."
32043 #. type: delimited block _
32044 #: ../sys-utils/mount.8.adoc:758
32046 "For example, *X-mount.idmap=/proc/PID/ns/user* will attach the user "
32047 "namespace of the process PID to the mount."
32050 #. type: Labeled list
32051 #: ../sys-utils/mount.8.adoc:759
32053 msgid "*nosymfollow*"
32056 #. type: delimited block _
32057 #: ../sys-utils/mount.8.adoc:761
32059 "Do not follow symlinks when resolving paths. Symlinks can still be created, "
32060 "and *readlink*(1), *readlink*(2), *realpath*(1), and *realpath*(3) all still "
32065 #: ../sys-utils/mount.8.adoc:762
32067 msgid "FILESYSTEM-SPECIFIC MOUNT OPTIONS"
32070 #. type: delimited block _
32071 #: ../sys-utils/mount.8.adoc:765
32073 "This section lists options that are specific to particular filesystems. "
32074 "Where possible, you should first consult filesystem-specific manual pages "
32075 "for details. Some of those pages are listed in the following table."
32079 #: ../sys-utils/mount.8.adoc:776
32082 "|*Filesystem(s)* |*Manual page*\n"
32083 "|btrfs |*btrfs*(5)\n"
32084 "|cifs |*mount.cifs*(8)\n"
32085 "|ext2, ext3, ext4 |*ext4*(5)\n"
32086 "|fuse |*fuse*(8)\n"
32088 "|tmpfs |*tmpfs*(5)\n"
32092 #. type: Plain text
32093 #: ../sys-utils/mount.8.adoc:779
32095 "Note that some of the pages listed above might be available only after you "
32096 "install the respective userland tools."
32099 #. type: Plain text
32100 #: ../sys-utils/mount.8.adoc:781
32102 "The following options apply only to certain filesystems. We sort them by "
32103 "filesystem. All options follow the *-o* flag."
32106 #. type: Plain text
32107 #: ../sys-utils/mount.8.adoc:783
32109 "What options are supported depends a bit on the running kernel. Further "
32110 "information may be available in filesystem-specific files in the kernel "
32111 "source subdirectory _Documentation/filesystems_."
32115 #: ../sys-utils/mount.8.adoc:784
32117 msgid "Mount options for adfs"
32120 #. type: Labeled list
32121 #: ../sys-utils/mount.8.adoc:786 ../sys-utils/mount.8.adoc:794
32122 #: ../sys-utils/mount.8.adoc:844 ../sys-utils/mount.8.adoc:875
32123 #: ../sys-utils/mount.8.adoc:1002 ../sys-utils/mount.8.adoc:1034
32125 msgid "**uid=**__value__ and **gid=**__value__"
32128 #. type: Plain text
32129 #: ../sys-utils/mount.8.adoc:788
32131 "Set the owner and group of the files in the filesystem (default: uid=gid=0)."
32134 #. type: Labeled list
32135 #: ../sys-utils/mount.8.adoc:789
32137 msgid "**ownmask=**__value__ and **othmask=**__value__"
32140 #. type: Plain text
32141 #: ../sys-utils/mount.8.adoc:791
32143 "Set the permission mask for ADFS 'owner' permissions and 'other' "
32144 "permissions, respectively (default: 0700 and 0077, respectively). See also _/"
32145 "usr/src/linux/Documentation/filesystems/adfs.rst_."
32149 #: ../sys-utils/mount.8.adoc:792
32151 msgid "Mount options for affs"
32154 #. type: Plain text
32155 #: ../sys-utils/mount.8.adoc:796
32157 "Set the owner and group of the root of the filesystem (default: uid=gid=0, "
32158 "but with option *uid* or *gid* without specified value, the UID and GID of "
32159 "the current process are taken)."
32162 #. type: Labeled list
32163 #: ../sys-utils/mount.8.adoc:797
32165 msgid "**setuid=**__value__ and **setgid=**__value__"
32168 #. type: Plain text
32169 #: ../sys-utils/mount.8.adoc:799
32170 msgid "Set the owner and group of all files."
32173 #. type: Labeled list
32174 #: ../sys-utils/mount.8.adoc:800 ../sys-utils/mount.8.adoc:837
32175 #: ../sys-utils/mount.8.adoc:847 ../sys-utils/mount.8.adoc:1040
32177 msgid "**mode=**__value__"
32180 #. type: Plain text
32181 #: ../sys-utils/mount.8.adoc:802
32183 "Set the mode of all files to _value_ & 0777 disregarding the original "
32184 "permissions. Add search permission to directories that have read permission. "
32185 "The value is given in octal."
32188 #. type: Labeled list
32189 #: ../sys-utils/mount.8.adoc:803
32194 #. type: Plain text
32195 #: ../sys-utils/mount.8.adoc:805
32196 msgid "Do not allow any changes to the protection bits on the filesystem."
32199 #. type: Labeled list
32200 #: ../sys-utils/mount.8.adoc:806
32206 #. type: Plain text
32207 #: ../sys-utils/mount.8.adoc:808
32209 "Set UID and GID of the root of the filesystem to the UID and GID of the "
32210 "mount point upon the first sync or umount, and then clear this option. "
32214 #. type: Labeled list
32215 #: ../sys-utils/mount.8.adoc:809
32220 #. type: Plain text
32221 #: ../sys-utils/mount.8.adoc:811
32222 msgid "Print an informational message for each successful mount."
32225 #. type: Labeled list
32226 #: ../sys-utils/mount.8.adoc:812
32228 msgid "**prefix=**__string__"
32231 #. type: Plain text
32232 #: ../sys-utils/mount.8.adoc:814
32233 msgid "Prefix used before volume name, when following a link."
32236 #. type: Labeled list
32237 #: ../sys-utils/mount.8.adoc:815
32239 msgid "**volume=**__string__"
32242 #. type: Plain text
32243 #: ../sys-utils/mount.8.adoc:817
32245 "Prefix (of length at most 30) used before '/' when following a symbolic link."
32248 #. type: Labeled list
32249 #: ../sys-utils/mount.8.adoc:818
32251 msgid "**reserved=**__value__"
32254 #. type: Plain text
32255 #: ../sys-utils/mount.8.adoc:820
32256 msgid "(Default: 2.) Number of unused blocks at the start of the device."
32259 #. type: Labeled list
32260 #: ../sys-utils/mount.8.adoc:821
32262 msgid "**root=**__value__"
32265 #. type: Plain text
32266 #: ../sys-utils/mount.8.adoc:823
32267 msgid "Give explicitly the location of the root block."
32270 #. type: Labeled list
32271 #: ../sys-utils/mount.8.adoc:824
32273 msgid "**bs=**__value__"
32276 #. type: Plain text
32277 #: ../sys-utils/mount.8.adoc:826
32278 msgid "Give blocksize. Allowed values are 512, 1024, 2048, 4096."
32281 #. type: Labeled list
32282 #: ../sys-utils/mount.8.adoc:827
32284 msgid "**grpquota**|**noquota**|**quota**|*usrquota*"
32287 #. type: Plain text
32288 #: ../sys-utils/mount.8.adoc:829
32290 "These options are accepted but ignored. (However, quota utilities may react "
32291 "to such strings in _/etc/fstab_.)"
32295 #: ../sys-utils/mount.8.adoc:830
32297 msgid "Mount options for debugfs"
32300 #. type: Plain text
32301 #: ../sys-utils/mount.8.adoc:833
32303 "The debugfs filesystem is a pseudo filesystem, traditionally mounted on _/"
32304 "sys/kernel/debug_. As of kernel version 3.4, debugfs has the following "
32308 #. type: Labeled list
32309 #: ../sys-utils/mount.8.adoc:834 ../sys-utils/mount.8.adoc:985
32311 msgid "**uid=**__n__**, gid=**__n__"
32314 #. type: Plain text
32315 #: ../sys-utils/mount.8.adoc:836
32316 msgid "Set the owner and group of the mountpoint."
32319 #. type: Plain text
32320 #: ../sys-utils/mount.8.adoc:839
32321 msgid "Sets the mode of the mountpoint."
32325 #: ../sys-utils/mount.8.adoc:840
32327 msgid "Mount options for devpts"
32330 #. type: Plain text
32331 #: ../sys-utils/mount.8.adoc:843
32333 "The devpts filesystem is a pseudo filesystem, traditionally mounted on _/dev/"
32334 "pts_. In order to acquire a pseudo terminal, a process opens _/dev/ptmx_; "
32335 "the number of the pseudo terminal is then made available to the process and "
32336 "the pseudo terminal slave can be accessed as _/dev/pts/_<number>."
32339 #. type: Plain text
32340 #: ../sys-utils/mount.8.adoc:846
32342 "This sets the owner or the group of newly created pseudo terminals to the "
32343 "specified values. When nothing is specified, they will be set to the UID and "
32344 "GID of the creating process. For example, if there is a tty group with GID "
32345 "5, then *gid=5* will cause newly created pseudo terminals to belong to the "
32349 #. type: Plain text
32350 #: ../sys-utils/mount.8.adoc:849
32352 "Set the mode of newly created pseudo terminals to the specified value. The "
32353 "default is 0600. A value of *mode=620* and *gid=5* makes \"mesg y\" the "
32354 "default on newly created pseudo terminals."
32357 #. type: Labeled list
32358 #: ../sys-utils/mount.8.adoc:850
32360 msgid "*newinstance*"
32363 #. type: Plain text
32364 #: ../sys-utils/mount.8.adoc:852
32366 "Create a private instance of the devpts filesystem, such that indices of "
32367 "pseudo terminals allocated in this new instance are independent of indices "
32368 "created in other instances of devpts."
32371 #. type: Plain text
32372 #: ../sys-utils/mount.8.adoc:854
32374 "All mounts of devpts without this *newinstance* option share the same set of "
32375 "pseudo terminal indices (i.e., legacy mode). Each mount of devpts with the "
32376 "*newinstance* option has a private set of pseudo terminal indices."
32379 #. type: Plain text
32380 #: ../sys-utils/mount.8.adoc:856
32382 "This option is mainly used to support containers in the Linux kernel. It is "
32383 "implemented in Linux kernel versions starting with 2.6.29. Further, this "
32384 "mount option is valid only if *CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled "
32385 "in the kernel configuration."
32388 #. type: Plain text
32389 #: ../sys-utils/mount.8.adoc:858
32391 "To use this option effectively, _/dev/ptmx_ must be a symbolic link to _pts/"
32392 "ptmx_. See _Documentation/filesystems/devpts.txt_ in the Linux kernel source "
32393 "tree for details."
32396 #. type: Labeled list
32397 #: ../sys-utils/mount.8.adoc:859
32399 msgid "**ptmxmode=**__value__"
32402 #. type: Plain text
32403 #: ../sys-utils/mount.8.adoc:861
32404 msgid "Set the mode for the new _ptmx_ device node in the devpts filesystem."
32407 #. type: Plain text
32408 #: ../sys-utils/mount.8.adoc:863
32410 "With the support for multiple instances of devpts (see *newinstance* option "
32411 "above), each instance has a private _ptmx_ node in the root of the devpts "
32412 "filesystem (typically _/dev/pts/ptmx_)."
32415 #. type: Plain text
32416 #: ../sys-utils/mount.8.adoc:865
32418 "For compatibility with older versions of the kernel, the default mode of the "
32419 "new _ptmx_ node is 0000. **ptmxmode=**__value__ specifies a more useful mode "
32420 "for the _ptmx_ node and is highly recommended when the *newinstance* option "
32424 #. type: Plain text
32425 #: ../sys-utils/mount.8.adoc:867
32427 "This option is only implemented in Linux kernel versions starting with "
32428 "2.6.29. Further, this option is valid only if "
32429 "*CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled in the kernel configuration."
32433 #: ../sys-utils/mount.8.adoc:868
32435 msgid "Mount options for fat"
32438 #. type: Plain text
32439 #: ../sys-utils/mount.8.adoc:871
32441 "(Note: _fat_ is not a separate filesystem, but a common part of the _msdos_, "
32442 "_umsdos_ and _vfat_ filesystems.)"
32445 #. type: Labeled list
32446 #: ../sys-utils/mount.8.adoc:872
32448 msgid "*blocksize=*{**512**|**1024**|*2048*}"
32451 #. type: Plain text
32452 #: ../sys-utils/mount.8.adoc:874
32453 msgid "Set blocksize (default 512). This option is obsolete."
32456 #. type: Plain text
32457 #: ../sys-utils/mount.8.adoc:877 ../sys-utils/mount.8.adoc:987
32458 #: ../sys-utils/mount.8.adoc:1004
32460 "Set the owner and group of all files. (Default: the UID and GID of the "
32461 "current process.)"
32464 #. type: Labeled list
32465 #: ../sys-utils/mount.8.adoc:878 ../sys-utils/mount.8.adoc:1005
32467 msgid "**umask=**__value__"
32470 #. type: Plain text
32471 #: ../sys-utils/mount.8.adoc:880 ../sys-utils/mount.8.adoc:1007
32473 "Set the umask (the bitmask of the permissions that are *not* present). The "
32474 "default is the umask of the current process. The value is given in octal."
32477 #. type: Labeled list
32478 #: ../sys-utils/mount.8.adoc:881
32480 msgid "**dmask=**__value__"
32483 #. type: Plain text
32484 #: ../sys-utils/mount.8.adoc:883
32486 "Set the umask applied to directories only. The default is the umask of the "
32487 "current process. The value is given in octal."
32490 #. type: Labeled list
32491 #: ../sys-utils/mount.8.adoc:884
32493 msgid "**fmask=**__value__"
32496 #. type: Plain text
32497 #: ../sys-utils/mount.8.adoc:886
32499 "Set the umask applied to regular files only. The default is the umask of the "
32500 "current process. The value is given in octal."
32503 #. type: Labeled list
32504 #: ../sys-utils/mount.8.adoc:887
32506 msgid "**allow_utime=**__value__"
32509 #. type: Plain text
32510 #: ../sys-utils/mount.8.adoc:889
32511 msgid "This option controls the permission check of mtime/atime."
32514 #. type: Labeled list
32515 #: ../sys-utils/mount.8.adoc:890
32520 #. type: Plain text
32521 #: ../sys-utils/mount.8.adoc:892
32523 "If current process is in group of file's group ID, you can change timestamp."
32526 #. type: Plain text
32527 #: ../sys-utils/mount.8.adoc:895
32528 msgid "Other users can change timestamp."
32531 #. type: Plain text
32532 #: ../sys-utils/mount.8.adoc:897
32534 "The default is set from 'dmask' option. (If the directory is writable, "
32535 "*utime*(2) is also allowed. I.e. ~dmask & 022)"
32538 #. type: Plain text
32539 #: ../sys-utils/mount.8.adoc:899
32541 "Normally *utime*(2) checks that the current process is owner of the file, or "
32542 "that it has the *CAP_FOWNER* capability. But FAT filesystems don't have UID/"
32543 "GID on disk, so the normal check is too inflexible. With this option you can "
32547 #. type: Labeled list
32548 #: ../sys-utils/mount.8.adoc:900
32550 msgid "**check=**__value__"
32553 #. type: Plain text
32554 #: ../sys-utils/mount.8.adoc:902
32555 msgid "Three different levels of pickiness can be chosen:"
32558 #. type: Labeled list
32559 #: ../sys-utils/mount.8.adoc:903
32561 msgid "*r*[*elaxed*]"
32564 #. type: Plain text
32565 #: ../sys-utils/mount.8.adoc:905
32567 "Upper and lower case are accepted and equivalent, long name parts are "
32568 "truncated (e.g. _verylongname.foobar_ becomes _verylong.foo_), leading and "
32569 "embedded spaces are accepted in each name part (name and extension)."
32572 #. type: Labeled list
32573 #: ../sys-utils/mount.8.adoc:906
32575 msgid "*n*[*ormal*]"
32578 #. type: Plain text
32579 #: ../sys-utils/mount.8.adoc:908
32581 "Like \"relaxed\", but many special characters (*, ?, <, spaces, etc.) are "
32582 "rejected. This is the default."
32585 #. type: Labeled list
32586 #: ../sys-utils/mount.8.adoc:909
32588 msgid "*s*[*trict*]"
32591 #. type: Plain text
32592 #: ../sys-utils/mount.8.adoc:911
32594 "Like \"normal\", but names that contain long parts or special characters "
32595 "that are sometimes used on Linux but are not accepted by MS-DOS (+, =, etc.) "
32599 #. type: Labeled list
32600 #: ../sys-utils/mount.8.adoc:912
32602 msgid "**codepage=**__value__"
32605 #. type: Plain text
32606 #: ../sys-utils/mount.8.adoc:914
32608 "Sets the codepage for converting to shortname characters on FAT and VFAT "
32609 "filesystems. By default, codepage 437 is used."
32612 #. type: Labeled list
32613 #: ../sys-utils/mount.8.adoc:915 ../sys-utils/mount.8.adoc:1011
32614 #: ../sys-utils/mount.8.adoc:1049
32616 msgid "**conv=**__mode__"
32619 #. type: Plain text
32620 #: ../sys-utils/mount.8.adoc:917
32621 msgid "This option is obsolete and may fail or be ignored."
32624 #. type: Labeled list
32625 #: ../sys-utils/mount.8.adoc:918
32627 msgid "**cvf_format=**__module__"
32630 #. type: Plain text
32631 #: ../sys-utils/mount.8.adoc:920
32633 "Forces the driver to use the CVF (Compressed Volume File) module "
32634 "cvf___module__ instead of auto-detection. If the kernel supports *kmod*, the "
32635 "**cvf_format=**__xxx__ option also controls on-demand CVF module loading. "
32636 "This option is obsolete."
32639 #. type: Labeled list
32640 #: ../sys-utils/mount.8.adoc:921
32642 msgid "**cvf_option=**__option__"
32645 #. type: Plain text
32646 #: ../sys-utils/mount.8.adoc:923
32647 msgid "Option passed to the CVF module. This option is obsolete."
32650 #. type: Labeled list
32651 #: ../sys-utils/mount.8.adoc:924
32656 #. type: Plain text
32657 #: ../sys-utils/mount.8.adoc:926
32659 "Turn on the _debug_ flag. A version string and a list of filesystem "
32660 "parameters will be printed (these data are also printed if the parameters "
32661 "appear to be inconsistent)."
32664 #. type: Labeled list
32665 #: ../sys-utils/mount.8.adoc:927
32670 #. type: Plain text
32671 #: ../sys-utils/mount.8.adoc:929
32673 "If set, causes discard/TRIM commands to be issued to the block device when "
32674 "blocks are freed. This is useful for SSD devices and sparse/thinly-"
32675 "provisioned LUNs."
32678 #. type: Labeled list
32679 #: ../sys-utils/mount.8.adoc:930
32681 msgid "*dos1xfloppy*"
32684 #. type: Plain text
32685 #: ../sys-utils/mount.8.adoc:932
32687 "If set, use a fallback default BIOS Parameter Block configuration, "
32688 "determined by backing device size. These static parameters match defaults "
32689 "assumed by DOS 1.x for 160 kiB, 180 kiB, 320 kiB, and 360 kiB floppies and "
32693 #. type: Labeled list
32694 #: ../sys-utils/mount.8.adoc:933
32696 msgid "*errors=*{**panic**|**continue**|*remount-ro*}"
32699 #. type: Plain text
32700 #: ../sys-utils/mount.8.adoc:935
32702 "Specify FAT behavior on critical errors: panic, continue without doing "
32703 "anything, or remount the partition in read-only mode (default behavior)."
32706 #. type: Labeled list
32707 #: ../sys-utils/mount.8.adoc:936
32709 msgid "*fat=*{**12**|**16**|*32*}"
32712 #. type: Plain text
32713 #: ../sys-utils/mount.8.adoc:938
32715 "Specify a 12, 16 or 32 bit fat. This overrides the automatic FAT type "
32716 "detection routine. Use with caution!"
32719 #. type: Labeled list
32720 #: ../sys-utils/mount.8.adoc:939 ../sys-utils/mount.8.adoc:1063
32722 msgid "**iocharset=**__value__"
32725 #. type: Plain text
32726 #: ../sys-utils/mount.8.adoc:941
32728 "Character set to use for converting between 8 bit characters and 16 bit "
32729 "Unicode characters. The default is iso8859-1. Long filenames are stored on "
32730 "disk in Unicode format."
32733 #. type: Labeled list
32734 #: ../sys-utils/mount.8.adoc:942
32736 msgid "*nfs=*{**stale_rw**|*nostale_ro*}"
32739 #. type: Plain text
32740 #: ../sys-utils/mount.8.adoc:944
32741 msgid "Enable this only if you want to export the FAT filesystem over NFS."
32744 #. type: Plain text
32745 #: ../sys-utils/mount.8.adoc:946
32747 msgid "*stale_rw*: This option maintains an index (cache) of directory inodes which is used by the nfs-related code to improve look-ups. Full file operations (read/write) over NFS are supported but with cache eviction at NFS server, this could result in spurious *ESTALE* errors.\n"
32750 #. type: Plain text
32751 #: ../sys-utils/mount.8.adoc:948
32753 msgid "*nostale_ro*: This option bases the inode number and file handle on the on-disk location of a file in the FAT directory entry. This ensures that *ESTALE* will not be returned after a file is evicted from the inode cache. However, it means that operations such as rename, create and unlink could cause file handles that previously pointed at one file to point at a different file, potentially causing data corruption. For this reason, this option also mounts the filesystem readonly.\n"
32756 #. type: Plain text
32757 #: ../sys-utils/mount.8.adoc:950
32759 "To maintain backward compatibility, *-o nfs* is also accepted, defaulting to "
32763 #. type: Labeled list
32764 #: ../sys-utils/mount.8.adoc:951
32769 #. type: Plain text
32770 #: ../sys-utils/mount.8.adoc:953
32772 "This option disables the conversion of timestamps between local time (as "
32773 "used by Windows on FAT) and UTC (which Linux uses internally). This is "
32774 "particularly useful when mounting devices (like digital cameras) that are "
32775 "set to UTC in order to avoid the pitfalls of local time."
32778 #. type: Labeled list
32779 #: ../sys-utils/mount.8.adoc:954
32781 msgid "**time_offset=**__minutes__"
32784 #. type: Plain text
32785 #: ../sys-utils/mount.8.adoc:956
32787 "Set offset for conversion of timestamps from local time used by FAT to UTC. "
32788 "I.e., _minutes_ will be subtracted from each timestamp to convert it to UTC "
32789 "used internally by Linux. This is useful when the time zone set in the "
32790 "kernel via *settimeofday*(2) is not the time zone used by the filesystem. "
32791 "Note that this option still does not provide correct time stamps in all "
32792 "cases in presence of DST - time stamps in a different DST setting will be "
32796 #. type: Labeled list
32797 #: ../sys-utils/mount.8.adoc:957 ../sys-utils/mount.8.adoc:997
32802 #. type: Plain text
32803 #: ../sys-utils/mount.8.adoc:959
32805 "Turn on the _quiet_ flag. Attempts to chown or chmod files do not return "
32806 "errors, although they fail. Use with caution!"
32809 #. type: Labeled list
32810 #: ../sys-utils/mount.8.adoc:960
32815 #. type: Plain text
32816 #: ../sys-utils/mount.8.adoc:962
32818 "FAT has the *ATTR_RO* (read-only) attribute. On Windows, the *ATTR_RO* of "
32819 "the directory will just be ignored, and is used only by applications as a "
32820 "flag (e.g. it's set for the customized folder)."
32823 #. type: Plain text
32824 #: ../sys-utils/mount.8.adoc:964
32826 "If you want to use *ATTR_RO* as read-only flag even for the directory, set "
32830 #. type: Labeled list
32831 #: ../sys-utils/mount.8.adoc:965
32836 #. type: Plain text
32837 #: ../sys-utils/mount.8.adoc:967
32839 "If set, the execute permission bits of the file will be allowed only if the "
32840 "extension part of the name is .EXE, .COM, or .BAT. Not set by default."
32843 #. type: Labeled list
32844 #: ../sys-utils/mount.8.adoc:968
32846 msgid "*sys_immutable*"
32849 #. type: Plain text
32850 #: ../sys-utils/mount.8.adoc:970
32852 "If set, *ATTR_SYS* attribute on FAT is handled as *IMMUTABLE* flag on Linux. "
32853 "Not set by default."
32856 #. type: Labeled list
32857 #: ../sys-utils/mount.8.adoc:971
32862 #. type: Plain text
32863 #: ../sys-utils/mount.8.adoc:973
32865 "If set, the filesystem will try to flush to disk more early than normal. Not "
32869 #. type: Labeled list
32870 #: ../sys-utils/mount.8.adoc:974
32876 #. type: Plain text
32877 #: ../sys-utils/mount.8.adoc:976
32879 "Use the \"free clusters\" value stored on *FSINFO*. It'll be used to "
32880 "determine number of free clusters without scanning disk. But it's not used "
32881 "by default, because recent Windows don't update it correctly in some case. "
32882 "If you are sure the \"free clusters\" on *FSINFO* is correct, by this option "
32883 "you can avoid scanning disk."
32886 #. type: Labeled list
32887 #: ../sys-utils/mount.8.adoc:977
32889 msgid "*dots*, *nodots*, *dotsOK=*[**yes**|*no*]"
32892 #. type: Plain text
32893 #: ../sys-utils/mount.8.adoc:979
32895 "Various misguided attempts to force Unix or DOS conventions onto a FAT "
32900 #: ../sys-utils/mount.8.adoc:980
32902 msgid "Mount options for hfs"
32905 #. type: Labeled list
32906 #: ../sys-utils/mount.8.adoc:982
32908 msgid "**creator=**__cccc__**, type=**__cccc__"
32911 #. type: Plain text
32912 #: ../sys-utils/mount.8.adoc:984
32914 "Set the creator/type values as shown by the MacOS finder used for creating "
32915 "new files. Default values: '????'."
32918 #. type: Labeled list
32919 #: ../sys-utils/mount.8.adoc:988
32921 msgid "**dir_umask=**__n__**, file_umask=**__n__**, umask=**__n__"
32924 #. type: Plain text
32925 #: ../sys-utils/mount.8.adoc:990
32927 "Set the umask used for all directories, all regular files, or all files and "
32928 "directories. Defaults to the umask of the current process."
32931 #. type: Labeled list
32932 #: ../sys-utils/mount.8.adoc:991
32934 #| msgid "**--session-command=**__command__"
32935 msgid "**session=**__n__"
32936 msgstr "**--session-command=**__příkaz__"
32938 #. type: Plain text
32939 #: ../sys-utils/mount.8.adoc:993
32941 "Select the CDROM session to mount. Defaults to leaving that decision to the "
32942 "CDROM driver. This option will fail with anything but a CDROM as underlying "
32946 #. type: Labeled list
32947 #: ../sys-utils/mount.8.adoc:994
32949 msgid "**part=**__n__"
32952 #. type: Plain text
32953 #: ../sys-utils/mount.8.adoc:996
32955 "Select partition number n from the device. Only makes sense for CDROMs. "
32956 "Defaults to not parsing the partition table at all."
32959 #. type: Plain text
32960 #: ../sys-utils/mount.8.adoc:999
32961 msgid "Don't complain about invalid mount options."
32965 #: ../sys-utils/mount.8.adoc:1000
32967 msgid "Mount options for hpfs"
32970 #. type: Labeled list
32971 #: ../sys-utils/mount.8.adoc:1008
32973 msgid "*case=*{**lower**|*asis*}"
32976 #. type: Plain text
32977 #: ../sys-utils/mount.8.adoc:1010
32979 "Convert all files names to lower case, or leave them. (Default: "
32983 #. type: Plain text
32984 #: ../sys-utils/mount.8.adoc:1013 ../sys-utils/mount.8.adoc:1051
32985 msgid "This option is obsolete and may fail or being ignored."
32988 #. type: Labeled list
32989 #: ../sys-utils/mount.8.adoc:1014
32994 #. type: Plain text
32995 #: ../sys-utils/mount.8.adoc:1016
32996 msgid "Do not abort mounting when certain consistency checks fail."
33000 #: ../sys-utils/mount.8.adoc:1017
33002 msgid "Mount options for iso9660"
33005 #. type: Plain text
33006 #: ../sys-utils/mount.8.adoc:1020
33008 "ISO 9660 is a standard describing a filesystem structure to be used on CD-"
33009 "ROMs. (This filesystem type is also seen on some DVDs. See also the _udf_ "
33013 #. type: Plain text
33014 #: ../sys-utils/mount.8.adoc:1022
33016 "Normal _iso9660_ filenames appear in an 8.3 format (i.e., DOS-like "
33017 "restrictions on filename length), and in addition all characters are in "
33018 "upper case. Also there is no field for file ownership, protection, number of "
33019 "links, provision for block/character devices, etc."
33022 #. type: Plain text
33023 #: ../sys-utils/mount.8.adoc:1024
33025 "Rock Ridge is an extension to iso9660 that provides all of these UNIX-like "
33026 "features. Basically there are extensions to each directory record that "
33027 "supply all of the additional information, and when Rock Ridge is in use, the "
33028 "filesystem is indistinguishable from a normal UNIX filesystem (except that "
33029 "it is read-only, of course)."
33032 #. type: Labeled list
33033 #: ../sys-utils/mount.8.adoc:1025
33038 #. type: Plain text
33039 #: ../sys-utils/mount.8.adoc:1027
33040 msgid "Disable the use of Rock Ridge extensions, even if available. Cf. *map*."
33043 #. type: Labeled list
33044 #: ../sys-utils/mount.8.adoc:1028
33049 #. type: Plain text
33050 #: ../sys-utils/mount.8.adoc:1030
33052 "Disable the use of Microsoft Joliet extensions, even if available. Cf. *map*."
33055 #. type: Labeled list
33056 #: ../sys-utils/mount.8.adoc:1031
33058 msgid "*check=*{*r*[*elaxed*]|*s*[*trict*]}"
33061 #. type: Plain text
33062 #: ../sys-utils/mount.8.adoc:1033
33064 "With *check=relaxed*, a filename is first converted to lower case before "
33065 "doing the lookup. This is probably only meaningful together with *norock* "
33066 "and *map=normal*. (Default: *check=strict*.)"
33069 #. type: Plain text
33070 #: ../sys-utils/mount.8.adoc:1036
33072 "Give all files in the filesystem the indicated user or group id, possibly "
33073 "overriding the information found in the Rock Ridge extensions. (Default: "
33077 #. type: Labeled list
33078 #: ../sys-utils/mount.8.adoc:1037
33080 msgid "*map=*{*n*[*ormal*]|*o*[*ff*]|*a*[*corn*]}"
33083 #. type: Plain text
33084 #: ../sys-utils/mount.8.adoc:1039
33086 "For non-Rock Ridge volumes, normal name translation maps upper to lower case "
33087 "ASCII, drops a trailing ';1', and converts ';' to '.'. With *map=off* no "
33088 "name translation is done. See *norock*. (Default: *map=normal*.) *map=acorn* "
33089 "is like *map=normal* but also apply Acorn extensions if present."
33092 #. type: Plain text
33093 #: ../sys-utils/mount.8.adoc:1042
33095 "For non-Rock Ridge volumes, give all files the indicated mode. (Default: "
33096 "read and execute permission for everybody.) Octal mode values require a "
33100 #. type: Labeled list
33101 #: ../sys-utils/mount.8.adoc:1043 ../sys-utils/mount.8.adoc:1358
33106 #. type: Plain text
33107 #: ../sys-utils/mount.8.adoc:1045
33109 "Also show hidden and associated files. (If the ordinary files and the "
33110 "associated or hidden files have the same filenames, this may make the "
33111 "ordinary files inaccessible.)"
33114 #. type: Labeled list
33115 #: ../sys-utils/mount.8.adoc:1046
33117 msgid "*block=*{**512**|**1024**|*2048*}"
33120 #. type: Plain text
33121 #: ../sys-utils/mount.8.adoc:1048
33122 msgid "Set the block size to the indicated value. (Default: *block=1024*.)"
33125 #. type: Labeled list
33126 #: ../sys-utils/mount.8.adoc:1052
33131 #. type: Plain text
33132 #: ../sys-utils/mount.8.adoc:1054
33134 "If the high byte of the file length contains other garbage, set this mount "
33135 "option to ignore the high order bits of the file length. This implies that a "
33136 "file cannot be larger than 16 MB."
33139 #. type: Labeled list
33140 #: ../sys-utils/mount.8.adoc:1055
33142 #| msgid "**--session-command=**__command__"
33143 msgid "**session=**__x__"
33144 msgstr "**--session-command=**__příkaz__"
33146 #. type: Plain text
33147 #: ../sys-utils/mount.8.adoc:1057
33148 msgid "Select number of session on a multisession CD."
33151 #. type: Labeled list
33152 #: ../sys-utils/mount.8.adoc:1058
33154 msgid "**sbsector=**__xxx__"
33157 #. type: Plain text
33158 #: ../sys-utils/mount.8.adoc:1060
33159 msgid "Session begins from sector xxx."
33162 #. type: Plain text
33163 #: ../sys-utils/mount.8.adoc:1062
33165 "The following options are the same as for vfat and specifying them only "
33166 "makes sense when using discs encoded using Microsoft's Joliet extensions."
33169 #. type: Plain text
33170 #: ../sys-utils/mount.8.adoc:1065
33172 "Character set to use for converting 16 bit Unicode characters on CD to 8 bit "
33173 "characters. The default is iso8859-1."
33176 #. type: Labeled list
33177 #: ../sys-utils/mount.8.adoc:1066 ../sys-utils/mount.8.adoc:1105
33178 #: ../sys-utils/mount.8.adoc:1382 ../sys-utils/mount.8.adoc:1480
33183 #. type: Plain text
33184 #: ../sys-utils/mount.8.adoc:1068
33185 msgid "Convert 16 bit Unicode characters on CD to UTF-8."
33189 #: ../sys-utils/mount.8.adoc:1069
33191 msgid "Mount options for jfs"
33194 #. type: Labeled list
33195 #: ../sys-utils/mount.8.adoc:1071 ../sys-utils/mount.8.adoc:1099
33197 msgid "**iocharset=**__name__"
33200 #. type: Plain text
33201 #: ../sys-utils/mount.8.adoc:1073
33203 "Character set to use for converting from Unicode to ASCII. The default is to "
33204 "do no conversion. Use *iocharset=utf8* for UTF8 translations. This requires "
33205 "*CONFIG_NLS_UTF8* to be set in the kernel _.config_ file."
33208 #. type: Labeled list
33209 #: ../sys-utils/mount.8.adoc:1074
33211 msgid "**resize=**__value__"
33214 #. type: Plain text
33215 #: ../sys-utils/mount.8.adoc:1076
33217 "Resize the volume to _value_ blocks. JFS only supports growing a volume, not "
33218 "shrinking it. This option is only valid during a remount, when the volume is "
33219 "mounted read-write. The *resize* keyword with no value will grow the volume "
33220 "to the full size of the partition."
33223 #. type: Labeled list
33224 #: ../sys-utils/mount.8.adoc:1077
33226 msgid "*nointegrity*"
33229 #. type: Plain text
33230 #: ../sys-utils/mount.8.adoc:1079
33232 "Do not write to the journal. The primary use of this option is to allow for "
33233 "higher performance when restoring a volume from backup media. The integrity "
33234 "of the volume is not guaranteed if the system abnormally ends."
33237 #. type: Labeled list
33238 #: ../sys-utils/mount.8.adoc:1080
33240 msgid "*integrity*"
33243 #. type: Plain text
33244 #: ../sys-utils/mount.8.adoc:1082
33246 "Default. Commit metadata changes to the journal. Use this option to remount "
33247 "a volume where the *nointegrity* option was previously specified in order to "
33248 "restore normal behavior."
33251 #. type: Labeled list
33252 #: ../sys-utils/mount.8.adoc:1083
33254 msgid "*errors=*{**continue**|**remount-ro**|*panic*}"
33257 #. type: Plain text
33258 #: ../sys-utils/mount.8.adoc:1085
33260 "Define the behavior when an error is encountered. (Either ignore errors and "
33261 "just mark the filesystem erroneous and continue, or remount the filesystem "
33262 "read-only, or panic and halt the system.)"
33265 #. type: Labeled list
33266 #: ../sys-utils/mount.8.adoc:1086
33268 msgid "**noquota**|**quota**|**usrquota**|*grpquota*"
33271 #. type: Plain text
33272 #: ../sys-utils/mount.8.adoc:1088
33273 msgid "These options are accepted but ignored."
33277 #: ../sys-utils/mount.8.adoc:1089
33279 msgid "Mount options for msdos"
33282 #. type: Plain text
33283 #: ../sys-utils/mount.8.adoc:1092
33285 "See mount options for fat. If the _msdos_ filesystem detects an "
33286 "inconsistency, it reports an error and sets the file system read-only. The "
33287 "filesystem can be made writable again by remounting it."
33291 #: ../sys-utils/mount.8.adoc:1093
33293 msgid "Mount options for ncpfs"
33296 #. type: Plain text
33297 #: ../sys-utils/mount.8.adoc:1096
33299 "Just like _nfs_, the _ncpfs_ implementation expects a binary argument (a "
33300 "_struct ncp_mount_data_) to the *mount*(2) system call. This argument is "
33301 "constructed by *ncpmount*(8) and the current version of *mount* (2.12) does "
33302 "not know anything about ncpfs."
33306 #: ../sys-utils/mount.8.adoc:1097
33308 msgid "Mount options for ntfs"
33311 #. type: Plain text
33312 #: ../sys-utils/mount.8.adoc:1101
33314 "Character set to use when returning file names. Unlike VFAT, NTFS suppresses "
33315 "names that contain nonconvertible characters. Deprecated."
33318 #. type: Labeled list
33319 #: ../sys-utils/mount.8.adoc:1102
33321 msgid "**nls=**__name__"
33324 #. type: Plain text
33325 #: ../sys-utils/mount.8.adoc:1104
33326 msgid "New name for the option earlier called _iocharset_."
33329 #. type: Plain text
33330 #: ../sys-utils/mount.8.adoc:1107
33331 msgid "Use UTF-8 for converting file names."
33334 #. type: Labeled list
33335 #: ../sys-utils/mount.8.adoc:1108
33337 msgid "*uni_xlate=*{**0**|**1**|*2*}"
33340 #. type: Plain text
33341 #: ../sys-utils/mount.8.adoc:1110
33343 "For 0 (or 'no' or 'false'), do not use escape sequences for unknown Unicode "
33344 "characters. For 1 (or 'yes' or 'true') or 2, use vfat-style 4-byte escape "
33345 "sequences starting with \":\". Here 2 gives a little-endian encoding and 1 a "
33346 "byteswapped bigendian encoding."
33349 #. type: Labeled list
33350 #: ../sys-utils/mount.8.adoc:1111
33352 msgid "*posix=[0|1]*"
33355 #. type: Plain text
33356 #: ../sys-utils/mount.8.adoc:1113
33358 "If enabled (posix=1), the filesystem distinguishes between upper and lower "
33359 "case. The 8.3 alias names are presented as hard links instead of being "
33360 "suppressed. This option is obsolete."
33363 #. type: Labeled list
33364 #: ../sys-utils/mount.8.adoc:1114
33366 msgid "**uid=**__value__, **gid=**__value__ and **umask=**__value__"
33369 #. type: Plain text
33370 #: ../sys-utils/mount.8.adoc:1116
33372 "Set the file permission on the filesystem. The umask value is given in "
33373 "octal. By default, the files are owned by root and not readable by somebody "
33378 #: ../sys-utils/mount.8.adoc:1117
33380 msgid "Mount options for overlay"
33383 #. type: Plain text
33384 #: ../sys-utils/mount.8.adoc:1120
33386 "Since Linux 3.18 the overlay pseudo filesystem implements a union mount for "
33387 "other filesystems."
33390 #. type: Plain text
33391 #: ../sys-utils/mount.8.adoc:1122
33393 "An overlay filesystem combines two filesystems - an *upper* filesystem and a "
33394 "*lower* filesystem. When a name exists in both filesystems, the object in "
33395 "the upper filesystem is visible while the object in the lower filesystem is "
33396 "either hidden or, in the case of directories, merged with the upper object."
33399 #. type: Plain text
33400 #: ../sys-utils/mount.8.adoc:1124
33402 "The lower filesystem can be any filesystem supported by Linux and does not "
33403 "need to be writable. The lower filesystem can even be another overlayfs. The "
33404 "upper filesystem will normally be writable and if it is it must support the "
33405 "creation of trusted.* extended attributes, and must provide a valid d_type "
33406 "in readdir responses, so NFS is not suitable."
33409 #. type: Plain text
33410 #: ../sys-utils/mount.8.adoc:1126
33412 "A read-only overlay of two read-only filesystems may use any filesystem "
33413 "type. The options *lowerdir* and *upperdir* are combined into a merged "
33414 "directory by using:"
33417 #. type: delimited block .
33418 #: ../sys-utils/mount.8.adoc:1131
33421 "mount -t overlay overlay \\\n"
33422 " -olowerdir=/lower,upperdir=/upper,workdir=/work /merged\n"
33425 #. type: Labeled list
33426 #: ../sys-utils/mount.8.adoc:1134
33428 msgid "**lowerdir=**__directory__"
33431 #. type: delimited block _
33432 #: ../sys-utils/mount.8.adoc:1136
33433 msgid "Any filesystem, does not need to be on a writable filesystem."
33436 #. type: Labeled list
33437 #: ../sys-utils/mount.8.adoc:1137
33439 msgid "**upperdir=**__directory__"
33442 #. type: delimited block _
33443 #: ../sys-utils/mount.8.adoc:1139
33444 msgid "The upperdir is normally on a writable filesystem."
33447 #. type: Labeled list
33448 #: ../sys-utils/mount.8.adoc:1140
33450 msgid "**workdir=**__directory__"
33453 #. type: delimited block _
33454 #: ../sys-utils/mount.8.adoc:1142
33456 "The workdir needs to be an empty directory on the same filesystem as "
33460 #. type: Labeled list
33461 #: ../sys-utils/mount.8.adoc:1143
33464 msgid "*userxattr*"
33467 #. type: delimited block _
33468 #: ../sys-utils/mount.8.adoc:1145
33470 "Use the \"*user.overlay.*\" xattr namespace instead of \"*trusted.overlay."
33471 "*\". This is useful for unprivileged mounting of overlayfs."
33474 #. type: Labeled list
33475 #: ../sys-utils/mount.8.adoc:1146
33477 msgid "*redirect_dir=*{**on**|**off**|**follow**|**nofollow**}"
33480 #. type: delimited block _
33481 #: ../sys-utils/mount.8.adoc:1148
33483 "If the _redirect_dir_ feature is enabled, then the directory will be copied "
33484 "up (but not the contents). Then the \"{**trusted**|**user**}.overlay."
33485 "redirect\" extended attribute is set to the path of the original location "
33486 "from the root of the overlay. Finally the directory is moved to the new "
33490 #. type: Labeled list
33491 #: ../sys-utils/mount.8.adoc:1149 ../sys-utils/rtcwake.8.adoc:84
33496 #. type: delimited block _
33497 #: ../sys-utils/mount.8.adoc:1151
33498 msgid "Redirects are enabled."
33501 #. type: Labeled list
33502 #: ../sys-utils/mount.8.adoc:1152 ../sys-utils/rtcwake.8.adoc:78
33503 #: ../term-utils/setterm.1.adoc:124
33508 #. type: delimited block _
33509 #: ../sys-utils/mount.8.adoc:1154
33511 "Redirects are not created and only followed if \"redirect_always_follow\" "
33512 "feature is enabled in the kernel/module config."
33515 #. type: Labeled list
33516 #: ../sys-utils/mount.8.adoc:1155
33521 #. type: delimited block _
33522 #: ../sys-utils/mount.8.adoc:1157
33523 msgid "Redirects are not created, but followed."
33526 #. type: Labeled list
33527 #: ../sys-utils/mount.8.adoc:1158
33529 #| msgid "*nofail*"
33533 #. type: delimited block _
33534 #: ../sys-utils/mount.8.adoc:1160
33536 "Redirects are not created and not followed (equivalent to "
33537 "\"redirect_dir=off\" if \"redirect_always_follow\" feature is not enabled)."
33540 #. type: Labeled list
33541 #: ../sys-utils/mount.8.adoc:1161
33543 msgid "*index=*{**on**|**off**}"
33546 #. type: delimited block _
33547 #: ../sys-utils/mount.8.adoc:1163
33549 "Inode index. If this feature is disabled and a file with multiple hard links "
33550 "is copied up, then this will \"break\" the link. Changes will not be "
33551 "propagated to other names referring to the same inode."
33554 #. type: Labeled list
33555 #: ../sys-utils/mount.8.adoc:1164
33557 msgid "*uuid=*{**on**|**off**}"
33560 #. type: delimited block _
33561 #: ../sys-utils/mount.8.adoc:1166
33563 "Can be used to replace UUID of the underlying filesystem in file handles "
33564 "with null, and effectively disable UUID checks. This can be useful in case "
33565 "the underlying disk is copied and the UUID of this copy is changed. This is "
33566 "only applicable if all lower/upper/work directories are on the same "
33567 "filesystem, otherwise it will fallback to normal behaviour."
33570 #. type: Labeled list
33571 #: ../sys-utils/mount.8.adoc:1167
33573 msgid "*nfs_export=*{**on**|**off**}"
33576 #. type: delimited block _
33577 #: ../sys-utils/mount.8.adoc:1170
33579 "When the underlying filesystems supports NFS export and the \"nfs_export\" "
33580 "feature is enabled, an overlay filesystem may be exported to NFS."
33583 #. type: delimited block _
33584 #: ../sys-utils/mount.8.adoc:1177
33586 "With the \"nfs_export\" feature, on copy_up of any lower object, an index "
33587 "entry is created under the index directory. The index entry name is the "
33588 "hexadecimal representation of the copy up origin file handle. For a non-"
33589 "directory object, the index entry is a hard link to the upper inode. For a "
33590 "directory object, the index entry has an extended attribute \"{**trusted**|"
33591 "**user**}.overlay.upper\" with an encoded file handle of the upper directory "
33595 #. type: Labeled list
33596 #: ../sys-utils/mount.8.adoc:1178
33598 msgid "When encoding a file handle from an overlay filesystem object, the following rules apply"
33601 #. type: delimited block _
33602 #: ../sys-utils/mount.8.adoc:1181
33603 msgid "For a non-upper object, encode a lower file handle from lower inode"
33606 #. type: delimited block _
33607 #: ../sys-utils/mount.8.adoc:1182
33608 msgid "For an indexed object, encode a lower file handle from copy_up origin"
33611 #. type: delimited block _
33612 #: ../sys-utils/mount.8.adoc:1183
33614 "For a pure-upper object and for an existing non-indexed upper object, encode "
33615 "an upper file handle from upper inode"
33618 #. type: Labeled list
33619 #: ../sys-utils/mount.8.adoc:1185
33621 msgid "The encoded overlay file handle includes"
33624 #. type: delimited block _
33625 #: ../sys-utils/mount.8.adoc:1188
33626 msgid "Header including path type information (e.g. lower/upper)"
33629 #. type: delimited block _
33630 #: ../sys-utils/mount.8.adoc:1189
33631 msgid "UUID of the underlying filesystem"
33634 #. type: delimited block _
33635 #: ../sys-utils/mount.8.adoc:1190
33636 msgid "Underlying filesystem encoding of underlying inode"
33639 #. type: Labeled list
33640 #: ../sys-utils/mount.8.adoc:1192
33642 msgid "This encoding format is identical to the encoding format of file handles that are stored in extended attribute \"{**trusted**|**user**}.overlay.origin\". When decoding an overlay file handle, the following steps are followed"
33645 #. type: delimited block _
33646 #: ../sys-utils/mount.8.adoc:1195
33647 msgid "Find underlying layer by UUID and path type information."
33650 #. type: delimited block _
33651 #: ../sys-utils/mount.8.adoc:1196
33652 msgid "Decode the underlying filesystem file handle to underlying dentry."
33655 #. type: delimited block _
33656 #: ../sys-utils/mount.8.adoc:1197
33657 msgid "For a lower file handle, lookup the handle in index directory by name."
33660 #. type: delimited block _
33661 #: ../sys-utils/mount.8.adoc:1198
33663 "If a whiteout is found in index, return **ESTALE**. This represents an "
33664 "overlay object that was deleted after its file handle was encoded."
33667 #. type: delimited block _
33668 #: ../sys-utils/mount.8.adoc:1199
33670 "For a non-directory, instantiate a disconnected overlay dentry from the "
33671 "decoded underlying dentry, the path type and index inode, if found."
33674 #. type: delimited block _
33675 #: ../sys-utils/mount.8.adoc:1200
33677 "For a directory, use the connected underlying decoded dentry, path type and "
33678 "index, to lookup a connected overlay dentry."
33681 #. type: delimited block _
33682 #: ../sys-utils/mount.8.adoc:1206
33684 "Decoding a non-directory file handle may return a disconnected dentry. "
33685 "copy_up of that disconnected dentry will create an upper index entry with no "
33689 #. type: delimited block _
33690 #: ../sys-utils/mount.8.adoc:1218
33692 "When overlay filesystem has multiple lower layers, a middle layer directory "
33693 "may have a \"redirect\" to lower directory. Because middle layer "
33694 "\"redirects\" are not indexed, a lower file handle that was encoded from the "
33695 "\"redirect\" origin directory, cannot be used to find the middle or upper "
33696 "layer directory. Similarly, a lower file handle that was encoded from a "
33697 "descendant of the \"redirect\" origin directory, cannot be used to "
33698 "reconstruct a connected overlay path. To mitigate the cases of directories "
33699 "that cannot be decoded from a lower file handle, these directories are "
33700 "copied up on encode and encoded as an upper file handle. On an overlay "
33701 "filesystem with no upper layer this mitigation cannot be used NFS export in "
33702 "this setup requires turning off redirect follow (e.g. "
33703 "\"__redirect_dir=nofollow__\")."
33706 #. type: delimited block _
33707 #: ../sys-utils/mount.8.adoc:1220
33709 "The overlay filesystem does not support non-directory connectable file "
33710 "handles, so exporting with the _subtree_check_ exportfs configuration will "
33711 "cause failures to lookup files over NFS."
33714 #. type: delimited block _
33715 #: ../sys-utils/mount.8.adoc:1222
33717 "When the NFS export feature is enabled, all directory index entries are "
33718 "verified on mount time to check that upper file handles are not stale. This "
33719 "verification may cause significant overhead in some cases."
33722 #. type: delimited block _
33723 #: ../sys-utils/mount.8.adoc:1225
33725 "Note: the mount options __index=off,nfs_export=on__ are conflicting for a "
33726 "read-write mount and will result in an error."
33729 #. type: Labeled list
33730 #: ../sys-utils/mount.8.adoc:1227
33732 msgid "*xino=*{**on**|**off**|**auto**}"
33735 #. type: delimited block _
33736 #: ../sys-utils/mount.8.adoc:1229
33738 "The \"xino\" feature composes a unique object identifier from the real "
33739 "object st_ino and an underlying fsid index. The \"xino\" feature uses the "
33740 "high inode number bits for fsid, because the underlying filesystems rarely "
33741 "use the high inode number bits. In case the underlying inode number does "
33742 "overflow into the high xino bits, overlay filesystem will fall back to the "
33743 "non xino behavior for that inode."
33746 #. type: delimited block _
33747 #: ../sys-utils/mount.8.adoc:1231
33749 "For a detailed description of the effect of this option please refer to "
33750 "https://docs.kernel.org/filesystems/overlayfs.html"
33753 #. type: Labeled list
33754 #: ../sys-utils/mount.8.adoc:1232
33756 msgid "*metacopy=*{**on**|**off**}"
33759 #. type: delimited block _
33760 #: ../sys-utils/mount.8.adoc:1234
33762 "When metadata only copy up feature is enabled, overlayfs will only copy up "
33763 "metadata (as opposed to whole file), when a metadata specific operation like "
33764 "chown/chmod is performed. Full file will be copied up later when file is "
33765 "opened for WRITE operation."
33768 #. type: delimited block _
33769 #: ../sys-utils/mount.8.adoc:1236
33771 "In other words, this is delayed data copy up operation and data is copied up "
33772 "when there is a need to actually modify data."
33775 #. type: Labeled list
33776 #: ../sys-utils/mount.8.adoc:1237
33781 #. type: delimited block _
33782 #: ../sys-utils/mount.8.adoc:1239
33784 "Volatile mounts are not guaranteed to survive a crash. It is strongly "
33785 "recommended that volatile mounts are only used if data written to the "
33786 "overlay can be recreated without significant effort."
33789 #. type: delimited block _
33790 #: ../sys-utils/mount.8.adoc:1241
33792 "The advantage of mounting with the \"volatile\" option is that all forms of "
33793 "sync calls to the upper filesystem are omitted."
33796 #. type: delimited block _
33797 #: ../sys-utils/mount.8.adoc:1243
33799 "In order to avoid a giving a false sense of safety, the syncfs (and fsync) "
33800 "semantics of volatile mounts are slightly different than that of the rest of "
33801 "VFS. If any writeback error occurs on the upperdirâ
\80\99s filesystem after a "
33802 "volatile mount takes place, all sync functions will return an error. Once "
33803 "this condition is reached, the filesystem will not recover, and every "
33804 "subsequent sync call will return an error, even if the upperdir has not "
33805 "experience a new error since the last sync call."
33808 #. type: delimited block _
33809 #: ../sys-utils/mount.8.adoc:1245
33811 "When overlay is mounted with \"volatile\" option, the directory \"$workdir/"
33812 "work/incompat/volatile\" is created. During next mount, overlay checks for "
33813 "this directory and refuses to mount if present. This is a strong indicator "
33814 "that user should throw away upper and work directories and create fresh one. "
33815 "In very limited cases where the user knows that the system has not crashed "
33816 "and contents of upperdir are intact, The \"volatile\" directory can be "
33821 #: ../sys-utils/mount.8.adoc:1246
33823 msgid "Mount options for reiserfs"
33826 #. type: delimited block _
33827 #: ../sys-utils/mount.8.adoc:1249
33828 msgid "Reiserfs is a journaling filesystem."
33831 #. type: Labeled list
33832 #: ../sys-utils/mount.8.adoc:1250
33837 #. type: delimited block _
33838 #: ../sys-utils/mount.8.adoc:1252
33840 "Instructs version 3.6 reiserfs software to mount a version 3.5 filesystem, "
33841 "using the 3.6 format for newly created objects. This filesystem will no "
33842 "longer be compatible with reiserfs 3.5 tools."
33845 #. type: Labeled list
33846 #: ../sys-utils/mount.8.adoc:1253
33848 msgid "*hash=*{**rupasov**|**tea**|**r5**|*detect*}"
33851 #. type: delimited block _
33852 #: ../sys-utils/mount.8.adoc:1255
33854 "Choose which hash function reiserfs will use to find files within "
33858 #. type: Labeled list
33859 #: ../sys-utils/mount.8.adoc:1256
33864 #. type: delimited block _
33865 #: ../sys-utils/mount.8.adoc:1258
33867 "A hash invented by Yury Yu. Rupasov. It is fast and preserves locality, "
33868 "mapping lexicographically close file names to close hash values. This option "
33869 "should not be used, as it causes a high probability of hash collisions."
33872 #. type: Labeled list
33873 #: ../sys-utils/mount.8.adoc:1259
33878 #. type: delimited block _
33879 #: ../sys-utils/mount.8.adoc:1261
33881 "A Davis-Meyer function implemented by Jeremy Fitzhardinge. It uses hash "
33882 "permuting bits in the name. It gets high randomness and, therefore, low "
33883 "probability of hash collisions at some CPU cost. This may be used if "
33884 "*EHASHCOLLISION* errors are experienced with the r5 hash."
33887 #. type: Labeled list
33888 #: ../sys-utils/mount.8.adoc:1262
33893 #. type: delimited block _
33894 #: ../sys-utils/mount.8.adoc:1264
33896 "A modified version of the rupasov hash. It is used by default and is the "
33897 "best choice unless the filesystem has huge directories and unusual file-name "
33901 #. type: Labeled list
33902 #: ../sys-utils/mount.8.adoc:1265
33907 #. type: delimited block _
33908 #: ../sys-utils/mount.8.adoc:1267
33910 "Instructs *mount* to detect which hash function is in use by examining the "
33911 "filesystem being mounted, and to write this information into the reiserfs "
33912 "superblock. This is only useful on the first mount of an old format "
33916 #. type: Labeled list
33917 #: ../sys-utils/mount.8.adoc:1268
33919 msgid "*hashed_relocation*"
33922 #. type: delimited block _
33923 #: ../sys-utils/mount.8.adoc:1270 ../sys-utils/mount.8.adoc:1273
33925 "Tunes the block allocator. This may provide performance improvements in some "
33929 #. type: Labeled list
33930 #: ../sys-utils/mount.8.adoc:1271
33932 msgid "*no_unhashed_relocation*"
33935 #. type: Labeled list
33936 #: ../sys-utils/mount.8.adoc:1274
33941 #. type: delimited block _
33942 #: ../sys-utils/mount.8.adoc:1276
33944 "Disable the border allocator algorithm invented by Yury Yu. Rupasov. This "
33945 "may provide performance improvements in some situations."
33948 #. type: Labeled list
33949 #: ../sys-utils/mount.8.adoc:1277
33954 #. type: delimited block _
33955 #: ../sys-utils/mount.8.adoc:1279
33957 "Disable journaling. This will provide slight performance improvements in "
33958 "some situations at the cost of losing reiserfs's fast recovery from crashes. "
33959 "Even with this option turned on, reiserfs still performs all journaling "
33960 "operations, save for actual writes into its journaling area. Implementation "
33961 "of _nolog_ is a work in progress."
33964 #. type: Labeled list
33965 #: ../sys-utils/mount.8.adoc:1280
33967 #| msgid "*nofail*"
33971 #. type: delimited block _
33972 #: ../sys-utils/mount.8.adoc:1282
33974 "By default, reiserfs stores small files and 'file tails' directly into its "
33975 "tree. This confuses some utilities such as *lilo*(8). This option is used to "
33976 "disable packing of files into the tree."
33979 #. type: Labeled list
33980 #: ../sys-utils/mount.8.adoc:1283
33982 msgid "*replayonly*"
33985 #. type: delimited block _
33986 #: ../sys-utils/mount.8.adoc:1285
33988 "Replay the transactions which are in the journal, but do not actually mount "
33989 "the filesystem. Mainly used by _reiserfsck_."
33992 #. type: Labeled list
33993 #: ../sys-utils/mount.8.adoc:1286
33995 msgid "**resize=**__number__"
33998 #. type: delimited block _
33999 #: ../sys-utils/mount.8.adoc:1288
34001 "A remount option which permits online expansion of reiserfs partitions. "
34002 "Instructs reiserfs to assume that the device has _number_ blocks. This "
34003 "option is designed for use with devices which are under logical volume "
34004 "management (LVM). There is a special _resizer_ utility which can be obtained "
34005 "from _ftp://ftp.namesys.com/pub/reiserfsprogs_."
34008 #. type: Labeled list
34009 #: ../sys-utils/mount.8.adoc:1289
34012 msgid "*user_xattr*"
34015 #. type: delimited block _
34016 #: ../sys-utils/mount.8.adoc:1291
34017 msgid "Enable Extended User Attributes. See the *attr*(1) manual page."
34020 #. type: Labeled list
34021 #: ../sys-utils/mount.8.adoc:1292
34026 #. type: delimited block _
34027 #: ../sys-utils/mount.8.adoc:1294
34028 msgid "Enable POSIX Access Control Lists. See the *acl*(5) manual page."
34031 #. type: Labeled list
34032 #: ../sys-utils/mount.8.adoc:1295
34034 msgid "*barrier=none* / *barrier=flush*"
34037 #. type: delimited block _
34038 #: ../sys-utils/mount.8.adoc:1297
34040 "This disables / enables the use of write barriers in the journaling code. "
34041 "*barrier=none* disables, *barrier=flush* enables (default). This also "
34042 "requires an IO stack which can support barriers, and if reiserfs gets an "
34043 "error on a barrier write, it will disable barriers again with a warning. "
34044 "Write barriers enforce proper on-disk ordering of journal commits, making "
34045 "volatile disk write caches safe to use, at some performance penalty. If your "
34046 "disks are battery-backed in one way or another, disabling barriers may "
34047 "safely improve performance."
34051 #: ../sys-utils/mount.8.adoc:1298
34053 msgid "Mount options for ubifs"
34056 #. type: delimited block _
34057 #: ../sys-utils/mount.8.adoc:1301
34059 "UBIFS is a flash filesystem which works on top of UBI volumes. Note that "
34060 "*atime* is not supported and is always turned off."
34063 #. type: delimited block _
34064 #: ../sys-utils/mount.8.adoc:1303
34065 msgid "The device name may be specified as"
34068 #. type: Labeled list
34069 #: ../sys-utils/mount.8.adoc:1305
34074 #. type: Plain text
34075 #: ../sys-utils/mount.8.adoc:1307
34076 msgid "UBI device number *X*, volume number *Y*"
34079 #. type: Labeled list
34080 #: ../sys-utils/mount.8.adoc:1307
34085 #. type: Plain text
34086 #: ../sys-utils/mount.8.adoc:1309
34087 msgid "UBI device number *0*, volume number *Y*"
34090 #. type: Labeled list
34091 #: ../sys-utils/mount.8.adoc:1309
34093 msgid "*ubiX:NAME*"
34096 #. type: Plain text
34097 #: ../sys-utils/mount.8.adoc:1311
34098 msgid "UBI device number *X*, volume with name *NAME*"
34101 #. type: Labeled list
34102 #: ../sys-utils/mount.8.adoc:1311
34107 #. type: Plain text
34108 #: ../sys-utils/mount.8.adoc:1313
34109 msgid "UBI device number *0*, volume with name *NAME*"
34112 #. type: delimited block _
34113 #: ../sys-utils/mount.8.adoc:1316
34114 msgid "Alternative *!* separator may be used instead of *:*."
34117 #. type: delimited block _
34118 #: ../sys-utils/mount.8.adoc:1318
34119 msgid "The following mount options are available:"
34122 #. type: Labeled list
34123 #: ../sys-utils/mount.8.adoc:1319
34125 msgid "*bulk_read*"
34128 #. type: delimited block _
34129 #: ../sys-utils/mount.8.adoc:1321
34131 "Enable bulk-read. VFS read-ahead is disabled because it slows down the "
34132 "filesystem. Bulk-Read is an internal optimization. Some flashes may read "
34133 "faster if the data are read at one go, rather than at several read requests. "
34134 "For example, OneNAND can do \"read-while-load\" if it reads more than one "
34138 #. type: Labeled list
34139 #: ../sys-utils/mount.8.adoc:1322
34141 msgid "*no_bulk_read*"
34144 #. type: delimited block _
34145 #: ../sys-utils/mount.8.adoc:1324
34146 msgid "Do not bulk-read. This is the default."
34149 #. type: Labeled list
34150 #: ../sys-utils/mount.8.adoc:1325
34152 msgid "*chk_data_crc*"
34155 #. type: delimited block _
34156 #: ../sys-utils/mount.8.adoc:1327
34157 msgid "Check data CRC-32 checksums. This is the default."
34160 #. type: Labeled list
34161 #: ../sys-utils/mount.8.adoc:1328
34163 msgid "*no_chk_data_crc*"
34166 #. type: delimited block _
34167 #: ../sys-utils/mount.8.adoc:1330
34169 "Do not check data CRC-32 checksums. With this option, the filesystem does "
34170 "not check CRC-32 checksum for data, but it does check it for the internal "
34171 "indexing information. This option only affects reading, not writing. CRC-32 "
34172 "is always calculated when writing the data."
34175 #. type: Labeled list
34176 #: ../sys-utils/mount.8.adoc:1331
34178 msgid "*compr=*{**none**|**lzo**|*zlib*}"
34181 #. type: delimited block _
34182 #: ../sys-utils/mount.8.adoc:1333
34184 "Select the default compressor which is used when new files are written. It "
34185 "is still possible to read compressed files if mounted with the *none* option."
34189 #: ../sys-utils/mount.8.adoc:1334
34191 msgid "Mount options for udf"
34194 #. type: delimited block _
34195 #: ../sys-utils/mount.8.adoc:1337
34197 "UDF is the \"Universal Disk Format\" filesystem defined by OSTA, the Optical "
34198 "Storage Technology Association, and is often used for DVD-ROM, frequently in "
34199 "the form of a hybrid UDF/ISO-9660 filesystem. It is, however, perfectly "
34200 "usable by itself on disk drives, flash drives and other block devices. See "
34204 #. type: Labeled list
34205 #: ../sys-utils/mount.8.adoc:1338
34210 #. type: delimited block _
34211 #: ../sys-utils/mount.8.adoc:1340
34213 "Make all files in the filesystem belong to the given user. uid=forget can be "
34214 "specified independently of (or usually in addition to) uid=<user> and "
34215 "results in UDF not storing uids to the media. In fact the recorded uid is "
34216 "the 32-bit overflow uid -1 as defined by the UDF standard. The value is "
34217 "given as either <user> which is a valid user name or the corresponding "
34218 "decimal user id, or the special string \"forget\"."
34221 #. type: Labeled list
34222 #: ../sys-utils/mount.8.adoc:1341
34227 #. type: delimited block _
34228 #: ../sys-utils/mount.8.adoc:1343
34230 "Make all files in the filesystem belong to the given group. gid=forget can "
34231 "be specified independently of (or usually in addition to) gid=<group> and "
34232 "results in UDF not storing gids to the media. In fact the recorded gid is "
34233 "the 32-bit overflow gid -1 as defined by the UDF standard. The value is "
34234 "given as either <group> which is a valid group name or the corresponding "
34235 "decimal group id, or the special string \"forget\"."
34238 #. type: Labeled list
34239 #: ../sys-utils/mount.8.adoc:1344
34244 #. type: delimited block _
34245 #: ../sys-utils/mount.8.adoc:1346
34247 "Mask out the given permissions from all inodes read from the filesystem. The "
34248 "value is given in octal."
34251 #. type: Labeled list
34252 #: ../sys-utils/mount.8.adoc:1347
34257 #. type: delimited block _
34258 #: ../sys-utils/mount.8.adoc:1349
34260 "If *mode=* is set the permissions of all non-directory inodes read from the "
34261 "filesystem will be set to the given mode. The value is given in octal."
34264 #. type: Labeled list
34265 #: ../sys-utils/mount.8.adoc:1350
34270 #. type: delimited block _
34271 #: ../sys-utils/mount.8.adoc:1352
34273 "If *dmode=* is set the permissions of all directory inodes read from the "
34274 "filesystem will be set to the given dmode. The value is given in octal."
34277 #. type: Labeled list
34278 #: ../sys-utils/mount.8.adoc:1353
34283 #. type: delimited block _
34284 #: ../sys-utils/mount.8.adoc:1355
34286 "Set the block size. Default value prior to kernel version 2.6.30 was 2048. "
34287 "Since 2.6.30 and prior to 4.11 it was logical device block size with "
34288 "fallback to 2048. Since 4.11 it is logical block size with fallback to any "
34289 "valid block size between logical device block size and 4096."
34292 #. type: delimited block _
34293 #: ../sys-utils/mount.8.adoc:1357
34295 "For other details see the *mkudffs*(8) 2.0+ manpage, see the *COMPATIBILITY* "
34296 "and *BLOCK SIZE* sections."
34299 #. type: delimited block _
34300 #: ../sys-utils/mount.8.adoc:1360
34301 msgid "Show otherwise hidden files."
34304 #. type: Labeled list
34305 #: ../sys-utils/mount.8.adoc:1361
34310 #. type: delimited block _
34311 #: ../sys-utils/mount.8.adoc:1363
34312 msgid "Show deleted files in lists."
34315 #. type: Labeled list
34316 #: ../sys-utils/mount.8.adoc:1364
34321 #. type: delimited block _
34322 #: ../sys-utils/mount.8.adoc:1366
34323 msgid "Embed data in the inode. (default)"
34326 #. type: Labeled list
34327 #: ../sys-utils/mount.8.adoc:1367
34329 msgid "*noadinicb*"
34332 #. type: delimited block _
34333 #: ../sys-utils/mount.8.adoc:1369
34334 msgid "Don't embed data in the inode."
34337 #. type: Labeled list
34338 #: ../sys-utils/mount.8.adoc:1370
34343 #. type: delimited block _
34344 #: ../sys-utils/mount.8.adoc:1372
34345 msgid "Use short UDF address descriptors."
34348 #. type: Labeled list
34349 #: ../sys-utils/mount.8.adoc:1373
34354 #. type: delimited block _
34355 #: ../sys-utils/mount.8.adoc:1375
34356 msgid "Use long UDF address descriptors. (default)"
34359 #. type: Labeled list
34360 #: ../sys-utils/mount.8.adoc:1376
34365 #. type: delimited block _
34366 #: ../sys-utils/mount.8.adoc:1378
34367 msgid "Unset strict conformance."
34370 #. type: Labeled list
34371 #: ../sys-utils/mount.8.adoc:1379
34373 msgid "*iocharset=*"
34376 #. type: delimited block _
34377 #: ../sys-utils/mount.8.adoc:1381
34379 "Set the NLS character set. This requires kernel compiled with "
34380 "*CONFIG_UDF_NLS* option."
34383 #. type: delimited block _
34384 #: ../sys-utils/mount.8.adoc:1384
34385 msgid "Set the UTF-8 character set."
34389 #: ../sys-utils/mount.8.adoc:1385
34391 msgid "Mount options for debugging and disaster recovery"
34394 #. type: Labeled list
34395 #: ../sys-utils/mount.8.adoc:1387
34400 #. type: delimited block _
34401 #: ../sys-utils/mount.8.adoc:1389
34402 msgid "Ignore the Volume Recognition Sequence and attempt to mount anyway."
34405 #. type: Labeled list
34406 #: ../sys-utils/mount.8.adoc:1390
34411 #. type: delimited block _
34412 #: ../sys-utils/mount.8.adoc:1392
34414 "Select the session number for multi-session recorded optical media. "
34415 "(default= last session)"
34418 #. type: Labeled list
34419 #: ../sys-utils/mount.8.adoc:1393
34424 #. type: delimited block _
34425 #: ../sys-utils/mount.8.adoc:1395
34426 msgid "Override standard anchor location. (default= 256)"
34429 #. type: Labeled list
34430 #: ../sys-utils/mount.8.adoc:1396
34432 msgid "*lastblock=*"
34435 #. type: delimited block _
34436 #: ../sys-utils/mount.8.adoc:1398
34437 msgid "Set the last block of the filesystem."
34441 #: ../sys-utils/mount.8.adoc:1399
34443 msgid "Unused historical mount options that may be encountered and should be removed"
34446 #. type: Labeled list
34447 #: ../sys-utils/mount.8.adoc:1401
34449 msgid "*uid=ignore*"
34452 #. type: delimited block _
34453 #: ../sys-utils/mount.8.adoc:1403
34454 msgid "Ignored, use uid=<user> instead."
34457 #. type: Labeled list
34458 #: ../sys-utils/mount.8.adoc:1404
34460 msgid "*gid=ignore*"
34463 #. type: delimited block _
34464 #: ../sys-utils/mount.8.adoc:1406
34465 msgid "Ignored, use gid=<group> instead."
34468 #. type: Labeled list
34469 #: ../sys-utils/mount.8.adoc:1407
34474 #. type: delimited block _
34475 #: ../sys-utils/mount.8.adoc:1409 ../sys-utils/mount.8.adoc:1412
34476 #: ../sys-utils/mount.8.adoc:1415 ../sys-utils/mount.8.adoc:1418
34477 msgid "Unimplemented and ignored."
34480 #. type: Labeled list
34481 #: ../sys-utils/mount.8.adoc:1410
34483 msgid "*partition=*"
34486 #. type: Labeled list
34487 #: ../sys-utils/mount.8.adoc:1413
34492 #. type: Labeled list
34493 #: ../sys-utils/mount.8.adoc:1416
34499 #: ../sys-utils/mount.8.adoc:1419
34501 msgid "Mount options for ufs"
34504 #. type: Labeled list
34505 #: ../sys-utils/mount.8.adoc:1421
34507 msgid "**ufstype=**__value__"
34510 #. type: delimited block _
34511 #: ../sys-utils/mount.8.adoc:1423
34513 "UFS is a filesystem widely used in different operating systems. The problem "
34514 "are differences among implementations. Features of some implementations are "
34515 "undocumented, so its hard to recognize the type of ufs automatically. That's "
34516 "why the user must specify the type of ufs by mount option. Possible values "
34520 #. type: Labeled list
34521 #: ../sys-utils/mount.8.adoc:1424
34526 #. type: delimited block _
34527 #: ../sys-utils/mount.8.adoc:1426
34529 "Old format of ufs, this is the default, read only. (Don't forget to give the "
34533 #. type: Labeled list
34534 #: ../sys-utils/mount.8.adoc:1427
34539 #. type: delimited block _
34540 #: ../sys-utils/mount.8.adoc:1429
34542 "For filesystems created by a BSD-like system (NetBSD, FreeBSD, OpenBSD)."
34545 #. type: Labeled list
34546 #: ../sys-utils/mount.8.adoc:1430
34551 #. type: delimited block _
34552 #: ../sys-utils/mount.8.adoc:1432
34553 msgid "Used in FreeBSD 5.x supported as read-write."
34556 #. type: Labeled list
34557 #: ../sys-utils/mount.8.adoc:1433
34562 #. type: delimited block _
34563 #: ../sys-utils/mount.8.adoc:1435
34564 msgid "Synonym for ufs2."
34567 #. type: Labeled list
34568 #: ../sys-utils/mount.8.adoc:1436
34573 #. type: delimited block _
34574 #: ../sys-utils/mount.8.adoc:1438
34575 msgid "For filesystems created by SunOS or Solaris on Sparc."
34578 #. type: Labeled list
34579 #: ../sys-utils/mount.8.adoc:1439
34584 #. type: delimited block _
34585 #: ../sys-utils/mount.8.adoc:1441
34586 msgid "For filesystems created by Solaris on x86."
34589 #. type: Labeled list
34590 #: ../sys-utils/mount.8.adoc:1442
34595 #. type: delimited block _
34596 #: ../sys-utils/mount.8.adoc:1444
34597 msgid "For filesystems created by HP-UX, read-only."
34600 #. type: Labeled list
34601 #: ../sys-utils/mount.8.adoc:1445
34606 #. type: delimited block _
34607 #: ../sys-utils/mount.8.adoc:1447
34609 "For filesystems created by NeXTStep (on NeXT station) (currently read only)."
34612 #. type: Labeled list
34613 #: ../sys-utils/mount.8.adoc:1448
34615 msgid "*nextstep-cd*"
34618 #. type: delimited block _
34619 #: ../sys-utils/mount.8.adoc:1450
34620 msgid "For NextStep CDROMs (block_size == 2048), read-only."
34623 #. type: Labeled list
34624 #: ../sys-utils/mount.8.adoc:1451
34629 #. type: delimited block _
34630 #: ../sys-utils/mount.8.adoc:1453
34632 "For filesystems created by OpenStep (currently read only). The same "
34633 "filesystem type is also used by macOS."
34636 #. type: Labeled list
34637 #: ../sys-utils/mount.8.adoc:1454
34639 msgid "**onerror=**__value__"
34642 #. type: delimited block _
34643 #: ../sys-utils/mount.8.adoc:1456
34644 msgid "Set behavior on error:"
34647 #. type: Labeled list
34648 #: ../sys-utils/mount.8.adoc:1457
34653 #. type: delimited block _
34654 #: ../sys-utils/mount.8.adoc:1459
34655 msgid "If an error is encountered, cause a kernel panic."
34658 #. type: Labeled list
34659 #: ../sys-utils/mount.8.adoc:1460
34661 msgid "[**lock**|**umount**|*repair*]"
34664 #. type: delimited block _
34665 #: ../sys-utils/mount.8.adoc:1462
34667 "These mount options don't do anything at present; when an error is "
34668 "encountered only a console message is printed."
34672 #: ../sys-utils/mount.8.adoc:1463
34674 msgid "Mount options for umsdos"
34677 #. type: delimited block _
34678 #: ../sys-utils/mount.8.adoc:1466
34680 "See mount options for msdos. The *dotsOK* option is explicitly killed by "
34685 #: ../sys-utils/mount.8.adoc:1467
34687 msgid "Mount options for vfat"
34690 #. type: delimited block _
34691 #: ../sys-utils/mount.8.adoc:1470
34693 "First of all, the mount options for _fat_ are recognized. The *dotsOK* "
34694 "option is explicitly killed by _vfat_. Furthermore, there are"
34697 #. type: Labeled list
34698 #: ../sys-utils/mount.8.adoc:1471
34700 msgid "*uni_xlate*"
34703 #. type: delimited block _
34704 #: ../sys-utils/mount.8.adoc:1473
34706 "Translate unhandled Unicode characters to special escaped sequences. This "
34707 "lets you backup and restore filenames that are created with any Unicode "
34708 "characters. Without this option, a '?' is used when no translation is "
34709 "possible. The escape character is ':' because it is otherwise invalid on the "
34710 "vfat filesystem. The escape sequence that gets used, where u is the Unicode "
34711 "character, is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12)."
34714 #. type: Labeled list
34715 #: ../sys-utils/mount.8.adoc:1474
34720 #. type: delimited block _
34721 #: ../sys-utils/mount.8.adoc:1476
34723 "Allow two files with names that only differ in case. This option is obsolete."
34726 #. type: Labeled list
34727 #: ../sys-utils/mount.8.adoc:1477
34729 #| msgid "*nofail*"
34730 msgid "*nonumtail*"
34733 #. type: delimited block _
34734 #: ../sys-utils/mount.8.adoc:1479
34736 "First try to make a short name without sequence number, before trying "
34740 #. type: delimited block _
34741 #: ../sys-utils/mount.8.adoc:1482
34743 "UTF8 is the filesystem safe 8-bit encoding of Unicode that is used by the "
34744 "console. It can be enabled for the filesystem with this option or disabled "
34745 "with utf8=0, utf8=no or utf8=false. If _uni_xlate_ gets set, UTF8 gets "
34749 #. type: Labeled list
34750 #: ../sys-utils/mount.8.adoc:1483
34752 msgid "**shortname=**__mode__"
34755 #. type: delimited block _
34756 #: ../sys-utils/mount.8.adoc:1485
34758 "Defines the behavior for creation and display of filenames which fit into "
34759 "8.3 characters. If a long name for a file exists, it will always be the "
34760 "preferred one for display. There are four __mode__s:"
34763 #. type: Labeled list
34764 #: ../sys-utils/mount.8.adoc:1486
34769 #. type: delimited block _
34770 #: ../sys-utils/mount.8.adoc:1488
34772 "Force the short name to lower case upon display; store a long name when the "
34773 "short name is not all upper case."
34776 #. type: Labeled list
34777 #: ../sys-utils/mount.8.adoc:1489
34782 #. type: delimited block _
34783 #: ../sys-utils/mount.8.adoc:1491
34785 "Force the short name to upper case upon display; store a long name when the "
34786 "short name is not all upper case."
34789 #. type: Labeled list
34790 #: ../sys-utils/mount.8.adoc:1492
34795 #. type: delimited block _
34796 #: ../sys-utils/mount.8.adoc:1494
34798 "Display the short name as is; store a long name when the short name is not "
34799 "all lower case or all upper case."
34802 #. type: Labeled list
34803 #: ../sys-utils/mount.8.adoc:1495
34808 #. type: delimited block _
34809 #: ../sys-utils/mount.8.adoc:1497
34811 "Display the short name as is; store a long name when the short name is not "
34812 "all upper case. This mode is the default since Linux 2.6.32."
34816 #: ../sys-utils/mount.8.adoc:1498
34818 msgid "Mount options for usbfs"
34821 #. type: Labeled list
34822 #: ../sys-utils/mount.8.adoc:1500
34824 msgid "**devuid=**__uid__ and **devgid=**__gid__ and **devmode=**__mode__"
34827 #. type: delimited block _
34828 #: ../sys-utils/mount.8.adoc:1502
34830 "Set the owner and group and mode of the device files in the usbfs filesystem "
34831 "(default: uid=gid=0, mode=0644). The mode is given in octal."
34834 #. type: Labeled list
34835 #: ../sys-utils/mount.8.adoc:1503
34837 msgid "**busuid=**__uid__ and **busgid=**__gid__ and **busmode=**__mode__"
34840 #. type: delimited block _
34841 #: ../sys-utils/mount.8.adoc:1505
34843 "Set the owner and group and mode of the bus directories in the usbfs "
34844 "filesystem (default: uid=gid=0, mode=0555). The mode is given in octal."
34847 #. type: Labeled list
34848 #: ../sys-utils/mount.8.adoc:1506
34850 msgid "**listuid=**__uid__ and **listgid=**__gid__ and **listmode=**__mode__"
34853 #. type: delimited block _
34854 #: ../sys-utils/mount.8.adoc:1508
34856 "Set the owner and group and mode of the file _devices_ (default: uid=gid=0, "
34857 "mode=0444). The mode is given in octal."
34861 #: ../sys-utils/mount.8.adoc:1509
34863 msgid "DM-VERITY SUPPORT"
34866 #. type: delimited block _
34867 #: ../sys-utils/mount.8.adoc:1512
34869 "The device-mapper verity target provides read-only transparent integrity "
34870 "checking of block devices using kernel crypto API. The *mount* command can "
34871 "open the dm-verity device and do the integrity verification before the "
34872 "device filesystem is mounted. Requires libcryptsetup with in libmount "
34873 "(optionally via *dlopen*(3)). If libcryptsetup supports extracting the root "
34874 "hash of an already mounted device, existing devices will be automatically "
34875 "reused in case of a match. Mount options for dm-verity:"
34878 #. type: Labeled list
34879 #: ../sys-utils/mount.8.adoc:1513
34881 msgid "**verity.hashdevice=**__path__"
34884 #. type: delimited block _
34885 #: ../sys-utils/mount.8.adoc:1515
34887 "Path to the hash tree device associated with the source volume to pass to dm-"
34891 #. type: Labeled list
34892 #: ../sys-utils/mount.8.adoc:1516
34894 msgid "**verity.roothash=**__hex__"
34897 #. type: delimited block _
34898 #: ../sys-utils/mount.8.adoc:1518
34900 "Hex-encoded hash of the root of _verity.hashdevice_. Mutually exclusive with "
34901 "_verity.roothashfile._"
34904 #. type: Labeled list
34905 #: ../sys-utils/mount.8.adoc:1519
34907 msgid "**verity.roothashfile=**__path__"
34910 #. type: delimited block _
34911 #: ../sys-utils/mount.8.adoc:1521
34913 "Path to file containing the hex-encoded hash of the root of _verity."
34914 "hashdevice._ Mutually exclusive with _verity.roothash._"
34917 #. type: Labeled list
34918 #: ../sys-utils/mount.8.adoc:1522
34920 msgid "**verity.hashoffset=**__offset__"
34923 #. type: delimited block _
34924 #: ../sys-utils/mount.8.adoc:1524
34926 "If the hash tree device is embedded in the source volume, _offset_ (default: "
34927 "0) is used by dm-verity to get to the tree."
34930 #. type: Labeled list
34931 #: ../sys-utils/mount.8.adoc:1525
34933 msgid "**verity.fecdevice=**__path__"
34936 #. type: delimited block _
34937 #: ../sys-utils/mount.8.adoc:1527
34939 "Path to the Forward Error Correction (FEC) device associated with the source "
34940 "volume to pass to dm-verity. Optional. Requires kernel built with "
34941 "*CONFIG_DM_VERITY_FEC*."
34944 #. type: Labeled list
34945 #: ../sys-utils/mount.8.adoc:1528
34947 msgid "**verity.fecoffset=**__offset__"
34950 #. type: delimited block _
34951 #: ../sys-utils/mount.8.adoc:1530
34953 "If the FEC device is embedded in the source volume, _offset_ (default: 0) is "
34954 "used by dm-verity to get to the FEC area. Optional."
34957 #. type: Labeled list
34958 #: ../sys-utils/mount.8.adoc:1531
34960 msgid "**verity.fecroots=**__value__"
34963 #. type: delimited block _
34964 #: ../sys-utils/mount.8.adoc:1533
34965 msgid "Parity bytes for FEC (default: 2). Optional."
34968 #. type: Labeled list
34969 #: ../sys-utils/mount.8.adoc:1534
34971 msgid "**verity.roothashsig=**__path__"
34974 #. type: delimited block _
34975 #: ../sys-utils/mount.8.adoc:1536
34977 "Path to *pkcs7*(1ssl) signature of root hash hex string. Requires "
34978 "crypt_activate_by_signed_key() from cryptsetup and kernel built with "
34979 "*CONFIG_DM_VERITY_VERIFY_ROOTHASH_SIG*. For device reuse, signatures have to "
34980 "be either used by all mounts of a device or by none. Optional."
34983 #. type: Labeled list
34984 #: ../sys-utils/mount.8.adoc:1537
34986 msgid "**verity.oncorruption=**__ignore__|__restart__|__panic__"
34989 #. type: delimited block _
34990 #: ../sys-utils/mount.8.adoc:1539
34992 "Instruct the kernel to ignore, reboot or panic when corruption is detected. "
34993 "By default the I/O operation simply fails. Requires Linux 4.1 or newer, and "
34994 "libcrypsetup 2.3.4 or newer. Optional."
34997 #. type: delimited block _
34998 #: ../sys-utils/mount.8.adoc:1541
34999 msgid "Supported since util-linux v2.35."
35002 #. type: delimited block _
35003 #: ../sys-utils/mount.8.adoc:1543
35004 msgid "For example commands:"
35007 #. type: delimited block .
35008 #: ../sys-utils/mount.8.adoc:1551
35011 "mksquashfs /etc /tmp/etc.raw\n"
35012 "veritysetup format /tmp/etc.raw /tmp/etc.verity --root-hash-file=/tmp/etc.roothash\n"
35013 "openssl smime -sign -in /tmp/etc.roothash -nocerts -inkey private.key \\\n"
35014 "-signer private.crt -noattr -binary -outform der -out /tmp/etc.roothash.p7s\n"
35015 "mount -o verity.hashdevice=/tmp/etc.verity,verity.roothashfile=/tmp/etc.roothash,\\\n"
35016 "verity.roothashsig=/tmp/etc.roothash.p7s /tmp/etc.raw /mnt\n"
35019 #. type: Plain text
35020 #: ../sys-utils/mount.8.adoc:1554
35022 "create squashfs image from _/etc_ directory, verity hash device and mount "
35023 "verified filesystem image to _/mnt_. The kernel will verify that the root "
35024 "hash is signed by a key from the kernel keyring if roothashsig is used."
35028 #: ../sys-utils/mount.8.adoc:1555
35030 msgid "LOOP-DEVICE SUPPORT"
35033 #. type: Plain text
35034 #: ../sys-utils/mount.8.adoc:1558
35036 "One further possible type is a mount via the loop device. For example, the "
35040 #. type: delimited block _
35041 #: ../sys-utils/mount.8.adoc:1561
35043 msgid "*mount /tmp/disk.img /mnt -t vfat -o loop=/dev/loop3*\n"
35046 #. type: Plain text
35047 #: ../sys-utils/mount.8.adoc:1564
35049 "will set up the loop device _/dev/loop3_ to correspond to the file _/tmp/"
35050 "disk.img_, and then mount this device on _/mnt_."
35053 #. type: Plain text
35054 #: ../sys-utils/mount.8.adoc:1566
35056 "If no explicit loop device is mentioned (but just an option '**-o loop**' is "
35057 "given), then *mount* will try to find some unused loop device and use that, "
35061 #. type: delimited block _
35062 #: ../sys-utils/mount.8.adoc:1569
35064 msgid "*mount /tmp/disk.img /mnt -o loop*\n"
35067 #. type: Plain text
35068 #: ../sys-utils/mount.8.adoc:1572
35070 "The *mount* command *automatically* creates a loop device from a regular "
35071 "file if a filesystem type is not specified or the filesystem is known for "
35072 "libblkid, for example:"
35075 #. type: delimited block _
35076 #: ../sys-utils/mount.8.adoc:1575
35078 msgid "*mount /tmp/disk.img /mnt*\n"
35081 #. type: delimited block _
35082 #: ../sys-utils/mount.8.adoc:1577
35084 msgid "*mount -t ext4 /tmp/disk.img /mnt*\n"
35087 #. type: Plain text
35088 #: ../sys-utils/mount.8.adoc:1580
35090 "This type of mount knows about three options, namely *loop*, *offset* and "
35091 "*sizelimit*, that are really options to *losetup*(8). (These options can be "
35092 "used in addition to those specific to the filesystem type.)"
35095 #. type: Plain text
35096 #: ../sys-utils/mount.8.adoc:1582
35098 "Since Linux 2.6.25 auto-destruction of loop devices is supported, meaning "
35099 "that any loop device allocated by *mount* will be freed by *umount* "
35100 "independently of _/etc/mtab_."
35103 #. type: Plain text
35104 #: ../sys-utils/mount.8.adoc:1584
35106 "You can also free a loop device by hand, using *losetup -d* or *umount -d*."
35109 #. type: Plain text
35110 #: ../sys-utils/mount.8.adoc:1586
35112 "Since util-linux v2.29, *mount* re-uses the loop device rather than "
35113 "initializing a new device if the same backing file is already used for some "
35114 "loop device with the same offset and sizelimit. This is necessary to avoid a "
35115 "filesystem corruption."
35118 #. type: Plain text
35119 #: ../sys-utils/mount.8.adoc:1590
35121 msgid "*mount* has the following exit status values (the bits can be ORed):\n"
35124 #. type: Plain text
35125 #: ../sys-utils/mount.8.adoc:1596
35126 msgid "incorrect invocation or permissions"
35129 #. type: Plain text
35130 #: ../sys-utils/mount.8.adoc:1599
35131 msgid "system error (out of memory, cannot fork, no more loop devices)"
35134 #. type: Plain text
35135 #: ../sys-utils/mount.8.adoc:1602
35136 msgid "internal *mount* bug"
35139 #. type: Plain text
35140 #: ../sys-utils/mount.8.adoc:1605
35141 msgid "user interrupt"
35144 #. type: Plain text
35145 #: ../sys-utils/mount.8.adoc:1608
35146 msgid "problems writing or locking _/etc/mtab_"
35149 #. type: Plain text
35150 #: ../sys-utils/mount.8.adoc:1611
35151 msgid "mount failure"
35154 #. type: Plain text
35155 #: ../sys-utils/mount.8.adoc:1614
35156 msgid "some mount succeeded"
35159 #. type: Plain text
35160 #: ../sys-utils/mount.8.adoc:1616
35162 "The command *mount -a* returns 0 (all succeeded), 32 (all failed), or 64 "
35163 "(some failed, some succeeded)."
35167 #: ../sys-utils/mount.8.adoc:1617 ../sys-utils/umount.8.adoc:130
35169 msgid "EXTERNAL HELPERS"
35172 #. type: Plain text
35173 #: ../sys-utils/mount.8.adoc:1620
35174 msgid "The syntax of external mount helpers is:"
35177 #. type: Plain text
35178 #: ../sys-utils/mount.8.adoc:1622
35180 msgid "**/sbin/mount.**__suffix__ _spec dir_ [*-sfnv*] [*-N* _namespace_] [*-o* _options_] [*-t* __type__**.**_subtype_]\n"
35183 #. type: Plain text
35184 #: ../sys-utils/mount.8.adoc:1624
35186 "where the _suffix_ is the filesystem type and the *-sfnvoN* options have the "
35187 "same meaning as the normal mount options. The *-t* option is used for "
35188 "filesystems with subtypes support (for example */sbin/mount.fuse -t fuse."
35192 #. type: Plain text
35193 #: ../sys-utils/mount.8.adoc:1626
35195 "The command *mount* does not pass the mount options *unbindable*, "
35196 "*runbindable*, *private*, *rprivate*, *slave*, *rslave*, *shared*, "
35197 "*rshared*, *auto*, *noauto*, *comment*, *x-**, *loop*, *offset* and "
35198 "*sizelimit* to the mount.<suffix> helpers. All other options are used in a "
35199 "comma-separated list as an argument to the *-o* option."
35202 #. type: Labeled list
35203 #: ../sys-utils/mount.8.adoc:1629
35205 msgid "*LIBMOUNT_FORCE_MOUNT2*={always|never|auto}"
35208 #. type: Plain text
35209 #: ../sys-utils/mount.8.adoc:1631
35211 "force to use classic mount(2) system call (requires support for new file "
35212 "descriptors based mount API). The default is *auto*; in this case, libmount "
35213 "tries to be smart and use classic mount(2) only for well-known issues. If "
35214 "the new mount API is unavailable, libmount can still use traditional "
35215 "mount(2), although LIBMOUNT_FORCE_MOUNT2 is set to *never*."
35218 #. type: Plain text
35219 #: ../sys-utils/mount.8.adoc:1634
35220 msgid "overrides the default location of the _fstab_ file (ignored for suid)"
35223 #. type: Plain text
35224 #: ../sys-utils/mount.8.adoc:1640
35225 msgid "enables libblkid debug output"
35228 #. type: Plain text
35229 #: ../sys-utils/mount.8.adoc:1643
35230 msgid "enables loop device setup debug output"
35233 #. type: Plain text
35234 #: ../sys-utils/mount.8.adoc:1647
35236 "See also \"*The files /etc/fstab, /etc/mtab and /proc/mounts*\" section "
35240 #. type: Plain text
35241 #: ../sys-utils/mount.8.adoc:1650
35242 msgid "filesystem table"
35245 #. type: Labeled list
35246 #: ../sys-utils/mount.8.adoc:1651
35248 msgid "_/run/mount_"
35251 #. type: Plain text
35252 #: ../sys-utils/mount.8.adoc:1653
35253 msgid "libmount private runtime directory"
35256 #. type: Labeled list
35257 #: ../sys-utils/mount.8.adoc:1654 ../sys-utils/umount.8.adoc:160
35259 #| msgid "_/etc/fstab_"
35260 msgid "_/etc/mtab_"
35261 msgstr "_/etc/fstab_"
35263 #. type: Plain text
35264 #: ../sys-utils/mount.8.adoc:1656
35265 msgid "table of mounted filesystems or symlink to _/proc/mounts_"
35268 #. type: Labeled list
35269 #: ../sys-utils/mount.8.adoc:1657
35271 #| msgid "_/etc/fstab_"
35272 msgid "_/etc/mtab~_"
35273 msgstr "_/etc/fstab_"
35275 #. type: Plain text
35276 #: ../sys-utils/mount.8.adoc:1659
35277 msgid "lock file (unused on systems with _mtab_ symlink)"
35280 #. type: Labeled list
35281 #: ../sys-utils/mount.8.adoc:1660
35283 #| msgid "_/etc/fstab_"
35284 msgid "_/etc/mtab.tmp_"
35285 msgstr "_/etc/fstab_"
35287 #. type: Plain text
35288 #: ../sys-utils/mount.8.adoc:1662
35289 msgid "temporary file (unused on systems with _mtab_ symlink)"
35292 #. type: Labeled list
35293 #: ../sys-utils/mount.8.adoc:1663
35295 #| msgid "_/etc/fstab_"
35296 msgid "_/etc/filesystems_"
35297 msgstr "_/etc/fstab_"
35299 #. type: Plain text
35300 #: ../sys-utils/mount.8.adoc:1665
35301 msgid "a list of filesystem types to try"
35304 #. type: Plain text
35305 #: ../sys-utils/mount.8.adoc:1669
35307 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
35308 msgid "A *mount* command existed in Version 5 AT&T UNIX."
35309 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
35311 #. type: Plain text
35312 #: ../sys-utils/mount.8.adoc:1673
35313 msgid "It is possible for a corrupted filesystem to cause a crash."
35316 #. type: Plain text
35317 #: ../sys-utils/mount.8.adoc:1675
35319 "Some Linux filesystems don't support *-o sync* and *-o dirsync* (the ext2, "
35320 "ext3, ext4, fat and vfat filesystems _do_ support synchronous updates (a la "
35321 "BSD) when mounted with the *sync* option)."
35324 #. type: Plain text
35325 #: ../sys-utils/mount.8.adoc:1677
35327 "The *-o remount* may not be able to change mount parameters (all _ext2fs_-"
35328 "specific parameters, except *sb*, are changeable with a remount, for "
35329 "example, but you can't change *gid* or *umask* for the _fatfs_)."
35332 #. type: Plain text
35333 #: ../sys-utils/mount.8.adoc:1679
35335 "It is possible that the files _/etc/mtab_ and _/proc/mounts_ don't match on "
35336 "systems with a regular _mtab_ file. The first file is based only on the "
35337 "*mount* command options, but the content of the second file also depends on "
35338 "the kernel and others settings (e.g. on a remote NFS server -- in certain "
35339 "cases the *mount* command may report unreliable information about an NFS "
35340 "mount point and the _/proc/mount_ file usually contains more reliable "
35341 "information.) This is another reason to replace the _mtab_ file with a "
35342 "symlink to the _/proc/mounts_ file."
35345 #. type: Plain text
35346 #: ../sys-utils/mount.8.adoc:1681
35348 "Checking files on NFS filesystems referenced by file descriptors (i.e. the "
35349 "*fcntl* and *ioctl* families of functions) may lead to inconsistent results "
35350 "due to the lack of a consistency check in the kernel even if the *noac* "
35351 "mount option is used."
35354 #. type: Plain text
35355 #: ../sys-utils/mount.8.adoc:1683
35357 "The *loop* option with the *offset* or *sizelimit* options used may fail "
35358 "when using older kernels if the *mount* command can't confirm that the size "
35359 "of the block device has been configured as requested. This situation can be "
35360 "worked around by using the *losetup*(8) command manually before calling "
35361 "*mount* with the configured loop device."
35364 #. type: Plain text
35365 #: ../sys-utils/mount.8.adoc:1709
35370 "*filesystems*(5),\n"
35374 "*mount_namespaces*(7),\n"
35390 #: ../sys-utils/mountpoint.1.adoc:2
35392 msgid "mountpoint(1)"
35395 #. type: Plain text
35396 #: ../sys-utils/mountpoint.1.adoc:12
35397 msgid "mountpoint - see if a directory or file is a mountpoint"
35400 #. type: Plain text
35401 #: ../sys-utils/mountpoint.1.adoc:16
35403 msgid "*mountpoint* [*-d*|*-q*] _directory_|_file_\n"
35406 #. type: Plain text
35407 #: ../sys-utils/mountpoint.1.adoc:18
35409 msgid "*mountpoint* *-x* _device_\n"
35412 #. type: Plain text
35413 #: ../sys-utils/mountpoint.1.adoc:22
35415 msgid "*mountpoint* checks whether the given _directory_ or _file_ is mentioned in the _/proc/self/mountinfo_ file.\n"
35418 #. type: Labeled list
35419 #: ../sys-utils/mountpoint.1.adoc:25
35421 #| msgid "*-f*, *--fast*"
35422 msgid "*-d*, *--fs-devno*"
35423 msgstr "*-f*, *--fast*"
35425 #. type: Plain text
35426 #: ../sys-utils/mountpoint.1.adoc:27
35428 "Show the major/minor numbers of the device that is mounted on the given "
35432 #. type: Plain text
35433 #: ../sys-utils/mountpoint.1.adoc:30
35434 msgid "Be quiet - don't print anything."
35437 #. type: Labeled list
35438 #: ../sys-utils/mountpoint.1.adoc:31
35440 msgid "*--nofollow*"
35443 #. type: Plain text
35444 #: ../sys-utils/mountpoint.1.adoc:33
35446 "Do not follow symbolic link if it the last element of the _directory_ path."
35449 #. type: Labeled list
35450 #: ../sys-utils/mountpoint.1.adoc:34
35452 #| msgid "*-h*, *--help*"
35453 msgid "*-x*, *--devno*"
35454 msgstr "*-h*, *--help*"
35456 #. type: Plain text
35457 #: ../sys-utils/mountpoint.1.adoc:36
35459 "Show the major/minor numbers of the given blockdevice on standard output."
35462 #. type: Plain text
35463 #: ../sys-utils/mountpoint.1.adoc:42
35465 msgid "*mountpoint* has the following exit status values:\n"
35468 #. type: Plain text
35469 #: ../sys-utils/mountpoint.1.adoc:45
35471 "success; the directory is a mountpoint, or device is block device on *--"
35475 #. type: Plain text
35476 #: ../sys-utils/mountpoint.1.adoc:48
35477 msgid "failure; incorrect invocation, permissions or system error"
35480 #. type: Plain text
35481 #: ../sys-utils/mountpoint.1.adoc:51
35483 "failure; the directory is not a mountpoint, or device is not a block device "
35487 #. type: Plain text
35488 #: ../sys-utils/mountpoint.1.adoc:60
35490 "The util-linux *mountpoint* implementation was written from scratch for "
35491 "libmount. The original version for sysvinit suite was written by Miquel van "
35496 #: ../sys-utils/nsenter.1.adoc:2
35501 #. type: Plain text
35502 #: ../sys-utils/nsenter.1.adoc:12
35503 msgid "nsenter - run program in different namespaces"
35506 #. type: Plain text
35507 #: ../sys-utils/nsenter.1.adoc:16
35509 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
35510 msgid "*nsenter* [options] [_program_ [_arguments_]]\n"
35511 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
35513 #. type: Plain text
35514 #: ../sys-utils/nsenter.1.adoc:20
35516 "The *nsenter* command executes _program_ in the namespace(s) that are "
35517 "specified in the command-line options (described below). If _program_ is not "
35518 "given, then \"$\\{SHELL}\" is run (default: _/bin/sh_)."
35521 #. type: Plain text
35522 #: ../sys-utils/nsenter.1.adoc:22
35523 msgid "Enterable namespaces are:"
35526 #. type: Labeled list
35527 #: ../sys-utils/nsenter.1.adoc:23 ../sys-utils/unshare.1.adoc:27
35529 msgid "*mount namespace*"
35532 #. type: Plain text
35533 #: ../sys-utils/nsenter.1.adoc:25
35535 "Mounting and unmounting filesystems will not affect the rest of the system, "
35536 "except for filesystems which are explicitly marked as shared (with *mount --"
35537 "make-shared*; see _/proc/self/mountinfo_ for the *shared* flag). For further "
35538 "details, see *mount_namespaces*(7) and the discussion of the *CLONE_NEWNS* "
35539 "flag in *clone*(2)."
35542 #. type: Labeled list
35543 #: ../sys-utils/nsenter.1.adoc:26 ../sys-utils/unshare.1.adoc:32
35545 msgid "*UTS namespace*"
35548 #. type: Plain text
35549 #: ../sys-utils/nsenter.1.adoc:28 ../sys-utils/unshare.1.adoc:34
35551 "Setting hostname or domainname will not affect the rest of the system. For "
35552 "further details, see *uts_namespaces*(7)."
35555 #. type: Labeled list
35556 #: ../sys-utils/nsenter.1.adoc:29 ../sys-utils/unshare.1.adoc:35
35558 msgid "*IPC namespace*"
35561 #. type: Plain text
35562 #: ../sys-utils/nsenter.1.adoc:31 ../sys-utils/unshare.1.adoc:37
35564 "The process will have an independent namespace for POSIX message queues as "
35565 "well as System V message queues, semaphore sets and shared memory segments. "
35566 "For further details, see *ipc_namespaces*(7)."
35569 #. type: Labeled list
35570 #: ../sys-utils/nsenter.1.adoc:32 ../sys-utils/unshare.1.adoc:38
35572 msgid "*network namespace*"
35575 #. type: Plain text
35576 #: ../sys-utils/nsenter.1.adoc:34 ../sys-utils/unshare.1.adoc:40
35578 "The process will have independent IPv4 and IPv6 stacks, IP routing tables, "
35579 "firewall rules, the _/proc/net_ and _/sys/class/net_ directory trees, "
35580 "sockets, etc. For further details, see *network_namespaces*(7)."
35583 #. type: Labeled list
35584 #: ../sys-utils/nsenter.1.adoc:35 ../sys-utils/unshare.1.adoc:41
35586 msgid "*PID namespace*"
35589 #. type: Plain text
35590 #: ../sys-utils/nsenter.1.adoc:37
35592 "Children will have a set of PID to process mappings separate from the "
35593 "*nsenter* process. *nsenter* will fork by default if changing the PID "
35594 "namespace, so that the new program and its children share the same PID "
35595 "namespace and are visible to each other. If *--no-fork* is used, the new "
35596 "program will be exec'ed without forking. For further details, see "
35597 "*pid_namespaces*(7)."
35600 #. type: Labeled list
35601 #: ../sys-utils/nsenter.1.adoc:38 ../sys-utils/unshare.1.adoc:47
35603 msgid "*user namespace*"
35606 #. type: Plain text
35607 #: ../sys-utils/nsenter.1.adoc:40 ../sys-utils/unshare.1.adoc:49
35609 "The process will have a distinct set of UIDs, GIDs and capabilities. For "
35610 "further details, see *user_namespaces*(7)."
35613 #. type: Labeled list
35614 #: ../sys-utils/nsenter.1.adoc:41 ../sys-utils/unshare.1.adoc:44
35616 msgid "*cgroup namespace*"
35619 #. type: Plain text
35620 #: ../sys-utils/nsenter.1.adoc:43 ../sys-utils/unshare.1.adoc:46
35622 "The process will have a virtualized view of _/proc/self/cgroup_, and new "
35623 "cgroup mounts will be rooted at the namespace cgroup root. For further "
35624 "details, see *cgroup_namespaces*(7)."
35627 #. type: Labeled list
35628 #: ../sys-utils/nsenter.1.adoc:44 ../sys-utils/unshare.1.adoc:50
35630 msgid "*time namespace*"
35633 #. type: Plain text
35634 #: ../sys-utils/nsenter.1.adoc:46 ../sys-utils/unshare.1.adoc:52
35636 "The process can have a distinct view of *CLOCK_MONOTONIC* and/or "
35637 "*CLOCK_BOOTTIME* which can be changed using _/proc/self/timens_offsets_. For "
35638 "further details, see *time_namespaces*(7)."
35641 #. TRANSLATORS: Keep {asterisk} untranslated.
35642 #. type: Plain text
35643 #: ../sys-utils/nsenter.1.adoc:51
35645 "Various of the options below that relate to namespaces take an optional "
35646 "_file_ argument. This should be one of the _/proc/[pid]/ns/{asterisk}_ files "
35647 "described in *namespaces*(7), or the pathname of a bind mount that was "
35648 "created on one of those files."
35651 #. type: Plain text
35652 #: ../sys-utils/nsenter.1.adoc:55
35654 "Enter all namespaces of the target process by the default _/proc/[pid]/ns/"
35655 "{asterisk}_ namespace paths. The default paths to the target process "
35656 "namespaces may be overwritten by namespace specific options (e.g., *--all --"
35657 "mount*=[_path_])."
35660 #. type: Plain text
35661 #: ../sys-utils/nsenter.1.adoc:57
35663 "The user namespace will be ignored if the same as the caller's current user "
35664 "namespace. It prevents a caller that has dropped capabilities from regaining "
35665 "those capabilities via a call to setns(). See *setns*(2) for more details."
35668 #. type: Labeled list
35669 #: ../sys-utils/nsenter.1.adoc:58
35671 #| msgid "*-f*, *--fast*"
35672 msgid "*-t*, *--target* _PID_"
35673 msgstr "*-f*, *--fast*"
35675 #. type: Plain text
35676 #: ../sys-utils/nsenter.1.adoc:60
35678 "Specify a target process to get contexts from. The paths to the contexts "
35679 "specified by _pid_ are:"
35682 #. type: Labeled list
35683 #: ../sys-utils/nsenter.1.adoc:61
35685 msgid "_/proc/pid/ns/mnt_"
35688 #. type: Plain text
35689 #: ../sys-utils/nsenter.1.adoc:63
35690 msgid "the mount namespace"
35693 #. type: Labeled list
35694 #: ../sys-utils/nsenter.1.adoc:63
35696 msgid "_/proc/pid/ns/uts_"
35699 #. type: Plain text
35700 #: ../sys-utils/nsenter.1.adoc:65
35701 msgid "the UTS namespace"
35704 #. type: Labeled list
35705 #: ../sys-utils/nsenter.1.adoc:65
35707 msgid "_/proc/pid/ns/ipc_"
35710 #. type: Plain text
35711 #: ../sys-utils/nsenter.1.adoc:67
35712 msgid "the IPC namespace"
35715 #. type: Labeled list
35716 #: ../sys-utils/nsenter.1.adoc:67
35718 msgid "_/proc/pid/ns/net_"
35721 #. type: Plain text
35722 #: ../sys-utils/nsenter.1.adoc:69
35723 msgid "the network namespace"
35726 #. type: Labeled list
35727 #: ../sys-utils/nsenter.1.adoc:69
35729 msgid "_/proc/pid/ns/pid_"
35732 #. type: Plain text
35733 #: ../sys-utils/nsenter.1.adoc:71
35734 msgid "the PID namespace"
35737 #. type: Labeled list
35738 #: ../sys-utils/nsenter.1.adoc:71
35740 msgid "_/proc/pid/ns/user_"
35743 #. type: Plain text
35744 #: ../sys-utils/nsenter.1.adoc:73
35745 msgid "the user namespace"
35748 #. type: Labeled list
35749 #: ../sys-utils/nsenter.1.adoc:73
35751 msgid "_/proc/pid/ns/cgroup_"
35754 #. type: Plain text
35755 #: ../sys-utils/nsenter.1.adoc:75
35756 msgid "the cgroup namespace"
35759 #. type: Labeled list
35760 #: ../sys-utils/nsenter.1.adoc:75
35762 msgid "_/proc/pid/ns/time_"
35765 #. type: Plain text
35766 #: ../sys-utils/nsenter.1.adoc:77
35767 msgid "the time namespace"
35770 #. type: Labeled list
35771 #: ../sys-utils/nsenter.1.adoc:77
35773 msgid "_/proc/pid/root_"
35776 #. type: Plain text
35777 #: ../sys-utils/nsenter.1.adoc:79
35778 msgid "the root directory"
35781 #. type: Labeled list
35782 #: ../sys-utils/nsenter.1.adoc:79
35784 msgid "_/proc/pid/cwd_"
35787 #. type: Plain text
35788 #: ../sys-utils/nsenter.1.adoc:81
35789 msgid "the working directory respectively"
35792 #. type: Labeled list
35793 #: ../sys-utils/nsenter.1.adoc:82
35795 msgid "*-m*, *--mount*[=_file_]"
35798 #. type: Plain text
35799 #: ../sys-utils/nsenter.1.adoc:84
35801 "Enter the mount namespace. If no file is specified, enter the mount "
35802 "namespace of the target process. If _file_ is specified, enter the mount "
35803 "namespace specified by _file_."
35806 #. type: Labeled list
35807 #: ../sys-utils/nsenter.1.adoc:85
35809 msgid "*-u*, *--uts*[=_file_]"
35812 #. type: Plain text
35813 #: ../sys-utils/nsenter.1.adoc:87
35815 "Enter the UTS namespace. If no file is specified, enter the UTS namespace of "
35816 "the target process. If _file_ is specified, enter the UTS namespace "
35817 "specified by _file_."
35820 #. type: Labeled list
35821 #: ../sys-utils/nsenter.1.adoc:88
35823 msgid "*-i*, *--ipc*[=_file_]"
35826 #. type: Plain text
35827 #: ../sys-utils/nsenter.1.adoc:90
35829 "Enter the IPC namespace. If no file is specified, enter the IPC namespace of "
35830 "the target process. If _file_ is specified, enter the IPC namespace "
35831 "specified by _file_."
35834 #. type: Labeled list
35835 #: ../sys-utils/nsenter.1.adoc:91
35837 msgid "*-n*, *--net*[=_file_]"
35840 #. type: Plain text
35841 #: ../sys-utils/nsenter.1.adoc:93
35843 "Enter the network namespace. If no file is specified, enter the network "
35844 "namespace of the target process. If _file_ is specified, enter the network "
35845 "namespace specified by _file_."
35848 #. type: Labeled list
35849 #: ../sys-utils/nsenter.1.adoc:94
35851 msgid "*-p*, *--pid*[=_file_]"
35854 #. type: Plain text
35855 #: ../sys-utils/nsenter.1.adoc:96
35857 "Enter the PID namespace. If no file is specified, enter the PID namespace of "
35858 "the target process. If _file_ is specified, enter the PID namespace "
35859 "specified by _file_."
35862 #. type: Labeled list
35863 #: ../sys-utils/nsenter.1.adoc:97
35865 #| msgid "*-s*, **--shell**=__shell__"
35866 msgid "*-U*, *--user*[=_file_]"
35867 msgstr "*-s*, **--shell**=__shell__"
35869 #. type: Plain text
35870 #: ../sys-utils/nsenter.1.adoc:99
35872 "Enter the user namespace. If no file is specified, enter the user namespace "
35873 "of the target process. If _file_ is specified, enter the user namespace "
35874 "specified by _file_. See also the *--setuid* and *--setgid* options."
35877 #. type: Labeled list
35878 #: ../sys-utils/nsenter.1.adoc:100
35880 #| msgid "*-h*, *--help*"
35881 msgid "*--user-parent*"
35882 msgstr "*-h*, *--help*"
35884 #. type: Plain text
35885 #: ../sys-utils/nsenter.1.adoc:103
35887 "Enter the parent user namespace. Parent user namespace will be acquired from "
35888 "any other enabled namespace. If combined with *--user* option the parent "
35889 "user namespace will be fetched from the user namespace and replace it."
35892 #. type: Labeled list
35893 #: ../sys-utils/nsenter.1.adoc:104
35895 #| msgid "*-g*, **--group**=__group__"
35896 msgid "*-C*, *--cgroup*[=_file_]"
35897 msgstr "*-g*, **--group**=__skupina__"
35899 #. type: Plain text
35900 #: ../sys-utils/nsenter.1.adoc:106
35902 "Enter the cgroup namespace. If no file is specified, enter the cgroup "
35903 "namespace of the target process. If _file_ is specified, enter the cgroup "
35904 "namespace specified by _file_."
35907 #. type: Labeled list
35908 #: ../sys-utils/nsenter.1.adoc:107
35910 msgid "*-T*, *--time*[=_file_]"
35913 #. type: Plain text
35914 #: ../sys-utils/nsenter.1.adoc:109
35916 "Enter the time namespace. If no file is specified, enter the time namespace "
35917 "of the target process. If _file_ is specified, enter the time namespace "
35918 "specified by _file_."
35921 #. type: Labeled list
35922 #: ../sys-utils/nsenter.1.adoc:110 ../sys-utils/unshare.1.adoc:135
35924 #| msgid "*-f*, *--fast*"
35925 msgid "*-G*, *--setgid* _gid_"
35926 msgstr "*-f*, *--fast*"
35928 #. type: Plain text
35929 #: ../sys-utils/nsenter.1.adoc:114
35931 "Set the group ID which will be used in the entered namespace and drop "
35932 "supplementary groups. *nsenter* always sets GID for user namespaces, the "
35933 "default is 0. If the argument \"follow\" is specified the GID of the target "
35937 #. type: Labeled list
35938 #: ../sys-utils/nsenter.1.adoc:115 ../sys-utils/unshare.1.adoc:132
35940 #| msgid "*-f*, *--fast*"
35941 msgid "*-S*, *--setuid* _uid_"
35942 msgstr "*-f*, *--fast*"
35944 #. type: Plain text
35945 #: ../sys-utils/nsenter.1.adoc:119
35947 "Set the user ID which will be used in the entered namespace. *nsenter* "
35948 "always sets UID for user namespaces, the default is 0. If the argument "
35949 "\"follow\" is specified the UID of the target process is used."
35952 #. type: Labeled list
35953 #: ../sys-utils/nsenter.1.adoc:120 ../sys-utils/unshare.1.adoc:84
35955 msgid "*--keep-caps*"
35958 #. type: Plain text
35959 #: ../sys-utils/nsenter.1.adoc:122 ../sys-utils/unshare.1.adoc:86
35961 "When the *--user* option is given, ensure that capabilities granted in the "
35962 "user namespace are preserved in the child process."
35965 #. type: Labeled list
35966 #: ../sys-utils/nsenter.1.adoc:123
35968 msgid "*--preserve-credentials*"
35971 #. type: Plain text
35972 #: ../sys-utils/nsenter.1.adoc:125
35974 "Don't modify UID and GID when enter user namespace. The default is to drops "
35975 "supplementary groups and sets GID and UID to 0."
35978 #. type: Labeled list
35979 #: ../sys-utils/nsenter.1.adoc:126
35981 msgid "*-r*, *--root*[=_directory_]"
35984 #. type: Plain text
35985 #: ../sys-utils/nsenter.1.adoc:128
35987 "Set the root directory. If no directory is specified, set the root directory "
35988 "to the root directory of the target process. If directory is specified, set "
35989 "the root directory to the specified directory. The specified _directory_ is "
35990 "open before it switches to the requested namespaces."
35993 #. type: Labeled list
35994 #: ../sys-utils/nsenter.1.adoc:129
35996 msgid "*-w*, *--wd*[=_directory_]"
35999 #. type: Plain text
36000 #: ../sys-utils/nsenter.1.adoc:131
36002 "Set the working directory. If no directory is specified, set the working "
36003 "directory to the working directory of the target process. If directory is "
36004 "specified, set the working directory to the specified directory. The "
36005 "specified _directory_ is open before it switches to the requested "
36006 "namespaces, it means the specified directory works as \"tunnel\" to the "
36007 "current namespace. See also *--wdns*."
36010 #. type: Labeled list
36011 #: ../sys-utils/nsenter.1.adoc:132
36013 msgid "*-W*, *--wdns*[=_directory_]"
36016 #. type: Plain text
36017 #: ../sys-utils/nsenter.1.adoc:134
36019 "Set the working directory. The _directory_ is open after switch to the "
36020 "requested namespaces and after *chroot*(2) call. The options *--wd* and *--"
36021 "wdns* are mutually exclusive."
36024 #. type: Labeled list
36025 #: ../sys-utils/nsenter.1.adoc:135
36027 #| msgid "*-h*, *--help*"
36028 msgid "*-e*, *--env*"
36029 msgstr "*-h*, *--help*"
36031 #. type: Plain text
36032 #: ../sys-utils/nsenter.1.adoc:137
36034 "Pass environment variables from the target process to the new process being "
36035 "created. If this option is not provided, the environment variables will "
36036 "remain the same as in the current namespace.."
36039 #. type: Plain text
36040 #: ../sys-utils/nsenter.1.adoc:140
36042 "Do not fork before exec'ing the specified program. By default, when entering "
36043 "a PID namespace, *nsenter* calls *fork* before calling *exec* so that any "
36044 "children will also be in the newly entered PID namespace."
36047 #. type: Labeled list
36048 #: ../sys-utils/nsenter.1.adoc:141
36050 msgid "*-Z*, *--follow-context*"
36053 #. type: Plain text
36054 #: ../sys-utils/nsenter.1.adoc:143
36056 "Set the SELinux security context used for executing a new process according "
36057 "to already running process specified by *--target* PID. (The util-linux has "
36058 "to be compiled with SELinux support otherwise the option is unavailable.)"
36061 #. type: Labeled list
36062 #: ../sys-utils/nsenter.1.adoc:144
36064 #| msgid "*-G*, **--supp-group**=__group__"
36065 msgid "*-c*, *--join-cgroup*"
36066 msgstr "*-G*, **--supp-group**=__skupina__"
36068 #. type: Plain text
36069 #: ../sys-utils/nsenter.1.adoc:146
36070 msgid "Add the initiated process to the cgroup of the target process."
36073 #. type: Plain text
36074 #: ../sys-utils/nsenter.1.adoc:152
36076 "The *--user-parent* option requires Linux 4.9 or higher, older kernels will "
36077 "raise inappropriate ioctl for device error."
36080 #. type: Plain text
36081 #: ../sys-utils/nsenter.1.adoc:157
36083 "mailto:biederm@xmission.com[Eric Biederman], mailto:kzak@redhat.com[Karel "
36087 #. type: Plain text
36088 #: ../sys-utils/nsenter.1.adoc:163
36093 "*namespaces*(7)\n"
36097 #: ../sys-utils/pivot_root.8.adoc:2
36099 msgid "pivot_root(8)"
36102 #. type: Plain text
36103 #: ../sys-utils/pivot_root.8.adoc:12
36104 msgid "pivot_root - change the root filesystem"
36107 #. type: Plain text
36108 #: ../sys-utils/pivot_root.8.adoc:16
36110 msgid "*pivot_root* _new_root_ _put_old_\n"
36113 #. type: Plain text
36114 #: ../sys-utils/pivot_root.8.adoc:20
36116 msgid "*pivot_root* moves the root file system of the current process to the directory _put_old_ and makes _new_root_ the new root file system. Since *pivot_root*(8) simply calls *pivot_root*(2), we refer to the man page of the latter for further details.\n"
36119 #. type: Plain text
36120 #: ../sys-utils/pivot_root.8.adoc:22
36122 "Note that, depending on the implementation of *pivot_root*, root and current "
36123 "working directory of the caller may or may not change. The following is a "
36124 "sequence for invoking *pivot_root* that works in either case, assuming that "
36125 "*pivot_root* and *chroot* are in the current *PATH*:"
36128 #. type: delimited block .
36129 #: ../sys-utils/pivot_root.8.adoc:27
36133 "pivot_root . put_old\n"
36134 "exec chroot . command\n"
36137 #. type: Plain text
36138 #: ../sys-utils/pivot_root.8.adoc:30
36140 "Note that *chroot* must be available under the old root and under the new "
36141 "root, because *pivot_root* may or may not have implicitly changed the root "
36142 "directory of the shell."
36145 #. type: Plain text
36146 #: ../sys-utils/pivot_root.8.adoc:32
36148 "Note that *exec chroot* changes the running executable, which is necessary "
36149 "if the old root directory should be unmounted afterwards. Also note that "
36150 "standard input, output, and error may still point to a device on the old "
36151 "root file system, keeping it busy. They can easily be changed when invoking "
36152 "*chroot* (see below; note the absence of leading slashes to make it work "
36153 "whether *pivot_root* has changed the shell's root or not)."
36156 #. type: Plain text
36157 #: ../sys-utils/pivot_root.8.adoc:40
36158 msgid "Change the root file system to _/dev/hda1_ from an interactive shell:"
36161 #. type: delimited block .
36162 #: ../sys-utils/pivot_root.8.adoc:47
36165 "mount /dev/hda1 /new-root\n"
36167 "pivot_root . old-root\n"
36168 "exec chroot . sh <dev/console >dev/console 2>&1\n"
36169 "umount /old-root\n"
36172 #. type: Plain text
36173 #: ../sys-utils/pivot_root.8.adoc:50
36175 "Mount the new root file system over NFS from 10.0.0.1:/my_root and run "
36179 #. type: delimited block .
36180 #: ../sys-utils/pivot_root.8.adoc:61
36183 "ifconfig lo 127.0.0.1 up # for portmap\n"
36184 "# configure Ethernet or such\n"
36185 "portmap # for lockd (implicitly started by mount)\n"
36186 "mount -o ro 10.0.0.1:/my_root /mnt\n"
36187 "killall portmap # portmap keeps old root busy\n"
36189 "pivot_root . old_root\n"
36190 "exec chroot . sh -c 'umount /old_root; exec /sbin/init' \\\n"
36191 " <dev/console >dev/console 2>&1\n"
36194 #. type: Plain text
36195 #: ../sys-utils/pivot_root.8.adoc:70
36199 "*pivot_root*(2),\n"
36201 "*switch_root*(8),\n"
36206 #. Copyright 2011 Davidlohr Bueso <dave@gnu.org>
36207 #. May be distributed under the GNU General Public License
36209 #: ../sys-utils/prlimit.1.adoc:7
36214 #. type: Plain text
36215 #: ../sys-utils/prlimit.1.adoc:18
36216 msgid "prlimit - get and set process resource limits"
36219 #. type: Plain text
36220 #: ../sys-utils/prlimit.1.adoc:22
36222 msgid "*prlimit* [options] [*--resource*[=_limits_]] [*--pid* _PID_]\n"
36225 #. type: Plain text
36226 #: ../sys-utils/prlimit.1.adoc:24
36228 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
36229 msgid "*prlimit* [options] [*--resource*[=_limits_]] _command_ [_argument_...]\n"
36230 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
36232 #. type: Plain text
36233 #: ../sys-utils/prlimit.1.adoc:28
36235 "Given a process ID and one or more resources, *prlimit* tries to retrieve "
36236 "and/or modify the limits."
36239 #. type: Plain text
36240 #: ../sys-utils/prlimit.1.adoc:30
36242 "When _command_ is given, *prlimit* will run this command with the given "
36246 #. type: Plain text
36247 #: ../sys-utils/prlimit.1.adoc:32
36249 "The _limits_ parameter is composed of a soft and a hard value, separated by "
36250 "a colon (:), in order to modify the existing values. If no _limits_ are "
36251 "given, *prlimit* will display the current values. If one of the values is "
36252 "not given, then the existing one will be used. To specify the unlimited or "
36253 "infinity limit (*RLIM_INFINITY*), the -1 or 'unlimited' string can be passed."
36256 #. type: Plain text
36257 #: ../sys-utils/prlimit.1.adoc:34
36259 "Because of the nature of limits, the soft limit must be lower or equal to "
36260 "the high limit (also called the ceiling). To see all available resource "
36261 "limits, refer to the *RESOURCE OPTIONS* section."
36264 #. TRANSLATORS: Keep {colon} untranslated.
36265 #. type: Plain text
36266 #: ../sys-utils/prlimit.1.adoc:37
36267 msgid "_soft_{colon}__hard__ Specify both limits."
36270 #. type: Plain text
36271 #: ../sys-utils/prlimit.1.adoc:38
36272 msgid "_soft_{colon} Specify only the soft limit."
36275 #. type: Plain text
36276 #: ../sys-utils/prlimit.1.adoc:39
36277 msgid "{colon}__hard__ Specify only the hard limit."
36280 #. type: Plain text
36281 #: ../sys-utils/prlimit.1.adoc:40
36282 msgid "_value_ Specify both limits to the same value."
36286 #: ../sys-utils/prlimit.1.adoc:41
36289 msgid "GENERAL OPTIONS"
36292 #. type: Plain text
36293 #: ../sys-utils/prlimit.1.adoc:48
36295 "Define the output columns to use. If no output arrangement is specified, "
36296 "then a default set is used. Use *--help* to get a list of all supported "
36300 #. type: Plain text
36301 #: ../sys-utils/prlimit.1.adoc:51
36303 "Specify the process id; if none is given, the running process will be used."
36307 #: ../sys-utils/prlimit.1.adoc:60
36310 msgid "RESOURCE OPTIONS"
36313 #. type: Labeled list
36314 #: ../sys-utils/prlimit.1.adoc:62
36316 #| msgid "*-w*, **--whitelist-environment**=__list__"
36317 msgid "*-c*, *--core*[=_limits_]"
36318 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36320 #. type: Plain text
36321 #: ../sys-utils/prlimit.1.adoc:64
36322 msgid "Maximum size of a core file."
36325 #. type: Labeled list
36326 #: ../sys-utils/prlimit.1.adoc:65
36328 #| msgid "*-w*, **--whitelist-environment**=__list__"
36329 msgid "*-d*, *--data*[=_limits_]"
36330 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36332 #. type: Plain text
36333 #: ../sys-utils/prlimit.1.adoc:67
36334 msgid "Maximum data size."
36337 #. type: Labeled list
36338 #: ../sys-utils/prlimit.1.adoc:68
36340 #| msgid "*-w*, **--whitelist-environment**=__list__"
36341 msgid "*-e*, *--nice*[=_limits_]"
36342 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36344 #. type: Plain text
36345 #: ../sys-utils/prlimit.1.adoc:70
36346 msgid "Maximum nice priority allowed to raise."
36349 #. type: Labeled list
36350 #: ../sys-utils/prlimit.1.adoc:71
36352 #| msgid "*-f*, *--fast*"
36353 msgid "*-f*, *--fsize*[=_limits_]"
36354 msgstr "*-f*, *--fast*"
36356 #. type: Plain text
36357 #: ../sys-utils/prlimit.1.adoc:73
36358 msgid "Maximum file size."
36361 #. type: Labeled list
36362 #: ../sys-utils/prlimit.1.adoc:74
36364 #| msgid "*-w*, **--whitelist-environment**=__list__"
36365 msgid "*-i*, *--sigpending*[=_limits_]"
36366 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36368 #. type: Plain text
36369 #: ../sys-utils/prlimit.1.adoc:76
36370 msgid "Maximum number of pending signals."
36373 #. type: Labeled list
36374 #: ../sys-utils/prlimit.1.adoc:77
36376 #| msgid "*-P*, *--pty*"
36377 msgid "*-l*, *--memlock*[=_limits_]"
36378 msgstr "*-P*, *--pty*"
36380 #. type: Plain text
36381 #: ../sys-utils/prlimit.1.adoc:79
36382 msgid "Maximum locked-in-memory address space."
36385 #. type: Labeled list
36386 #: ../sys-utils/prlimit.1.adoc:80
36388 #| msgid "*-P*, *--pty*"
36389 msgid "*-m*, *--rss*[=_limits_]"
36390 msgstr "*-P*, *--pty*"
36392 #. type: Plain text
36393 #: ../sys-utils/prlimit.1.adoc:82
36394 msgid "Maximum Resident Set Size (RSS)."
36397 #. type: Labeled list
36398 #: ../sys-utils/prlimit.1.adoc:83
36400 #| msgid "*-w*, **--whitelist-environment**=__list__"
36401 msgid "*-n*, *--nofile*[=_limits_]"
36402 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36404 #. type: Plain text
36405 #: ../sys-utils/prlimit.1.adoc:85
36406 msgid "Maximum number of open files."
36409 #. type: Labeled list
36410 #: ../sys-utils/prlimit.1.adoc:86
36412 #| msgid "*-w*, **--whitelist-environment**=__list__"
36413 msgid "*-q*, *--msgqueue*[=_limits_]"
36414 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36416 #. type: Plain text
36417 #: ../sys-utils/prlimit.1.adoc:88
36418 msgid "Maximum number of bytes in POSIX message queues."
36421 #. type: Labeled list
36422 #: ../sys-utils/prlimit.1.adoc:89
36424 #| msgid "*-w*, **--whitelist-environment**=__list__"
36425 msgid "*-r*, *--rtprio*[=_limits_]"
36426 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36428 #. type: Plain text
36429 #: ../sys-utils/prlimit.1.adoc:91
36430 msgid "Maximum real-time priority."
36433 #. type: Labeled list
36434 #: ../sys-utils/prlimit.1.adoc:92
36436 #| msgid "*-w*, **--whitelist-environment**=__list__"
36437 msgid "*-s*, *--stack*[=_limits_]"
36438 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36440 #. type: Plain text
36441 #: ../sys-utils/prlimit.1.adoc:94
36442 msgid "Maximum size of the stack."
36445 #. type: Labeled list
36446 #: ../sys-utils/prlimit.1.adoc:95
36448 #| msgid "*-P*, *--pty*"
36449 msgid "*-t*, *--cpu*[=_limits_]"
36450 msgstr "*-P*, *--pty*"
36452 #. type: Plain text
36453 #: ../sys-utils/prlimit.1.adoc:97
36454 msgid "CPU time, in seconds."
36457 #. type: Labeled list
36458 #: ../sys-utils/prlimit.1.adoc:98
36460 #| msgid "*-w*, **--whitelist-environment**=__list__"
36461 msgid "*-u*, *--nproc*[=_limits_]"
36462 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36464 #. type: Plain text
36465 #: ../sys-utils/prlimit.1.adoc:100
36466 msgid "Maximum number of processes."
36469 #. type: Labeled list
36470 #: ../sys-utils/prlimit.1.adoc:101
36472 #| msgid "*-P*, *--pty*"
36473 msgid "*-v*, *--as*[=_limits_]"
36474 msgstr "*-P*, *--pty*"
36476 #. type: Plain text
36477 #: ../sys-utils/prlimit.1.adoc:103
36478 msgid "Address space limit."
36481 #. type: Labeled list
36482 #: ../sys-utils/prlimit.1.adoc:104
36484 #| msgid "*-*, *-l*, *--login*"
36485 msgid "*-x*, *--locks*[=_limits_]"
36486 msgstr "*-*, *-l*, *--login*"
36488 #. type: Plain text
36489 #: ../sys-utils/prlimit.1.adoc:106
36490 msgid "Maximum number of file locks held."
36493 #. type: Labeled list
36494 #: ../sys-utils/prlimit.1.adoc:107
36496 #| msgid "*-w*, **--whitelist-environment**=__list__"
36497 msgid "*-y*, *--rttime*[=_limits_]"
36498 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36500 #. type: Plain text
36501 #: ../sys-utils/prlimit.1.adoc:109
36502 msgid "Timeout for real-time tasks."
36505 #. type: Plain text
36506 #: ../sys-utils/prlimit.1.adoc:113
36508 "The *prlimit*(2) system call is supported since Linux 2.6.36, older kernels "
36509 "will break this program."
36512 #. type: Labeled list
36513 #: ../sys-utils/prlimit.1.adoc:116
36515 msgid "*prlimit --pid 13134*"
36518 #. type: Plain text
36519 #: ../sys-utils/prlimit.1.adoc:118
36520 msgid "Display limit values for all current resources."
36523 #. type: Labeled list
36524 #: ../sys-utils/prlimit.1.adoc:119
36526 msgid "*prlimit --pid 13134 --rss --nofile=1024:4095*"
36529 #. type: Plain text
36530 #: ../sys-utils/prlimit.1.adoc:121
36532 "Display the limits of the RSS, and set the soft and hard limits for the "
36533 "number of open files to 1024 and 4095, respectively."
36536 #. type: Labeled list
36537 #: ../sys-utils/prlimit.1.adoc:122
36539 msgid "*prlimit --pid 13134 --nproc=512:*"
36542 #. type: Plain text
36543 #: ../sys-utils/prlimit.1.adoc:124
36544 msgid "Modify only the soft limit for the number of processes."
36547 #. type: Labeled list
36548 #: ../sys-utils/prlimit.1.adoc:125
36550 msgid "*prlimit --pid $$ --nproc=unlimited*"
36553 #. type: Plain text
36554 #: ../sys-utils/prlimit.1.adoc:127
36556 "Set for the current process both the soft and ceiling values for the number "
36557 "of processes to unlimited."
36560 #. type: Labeled list
36561 #: ../sys-utils/prlimit.1.adoc:128
36563 msgid "*prlimit --cpu=10 sort -u hugefile*"
36566 #. type: Plain text
36567 #: ../sys-utils/prlimit.1.adoc:130
36569 "Set both the soft and hard CPU time limit to ten seconds and run *sort*(1)."
36572 #. type: Plain text
36573 #: ../sys-utils/prlimit.1.adoc:134
36574 msgid "mailto:dave@gnu.org[Davidlohr Bueso] - In memory of Dennis M. Ritchie."
36577 #. type: Plain text
36578 #: ../sys-utils/prlimit.1.adoc:139
36586 #: ../sys-utils/readprofile.8.adoc:2
36588 msgid "readprofile(8)"
36591 #. type: Plain text
36592 #: ../sys-utils/readprofile.8.adoc:12
36593 msgid "readprofile - read kernel profiling information"
36596 #. type: Plain text
36597 #: ../sys-utils/readprofile.8.adoc:16
36599 msgid "*readprofile* [options]\n"
36603 #: ../sys-utils/readprofile.8.adoc:17
36608 #. type: Plain text
36609 #: ../sys-utils/readprofile.8.adoc:20
36610 msgid "This manpage documents version 2.0 of the program."
36613 #. type: Plain text
36614 #: ../sys-utils/readprofile.8.adoc:24
36616 "The *readprofile* command uses the _/proc/profile_ information to print "
36617 "ascii data on standard output. The output is organized in three columns: the "
36618 "first is the number of clock ticks, the second is the name of the C function "
36619 "in the kernel where those many ticks occurred, and the third is the "
36620 "normalized `load' of the procedure, calculated as a ratio between the number "
36621 "of ticks and the length of the procedure. The output is filled with blanks "
36622 "to ease readability."
36625 #. type: Plain text
36626 #: ../sys-utils/readprofile.8.adoc:29
36628 "Print all symbols in the mapfile. By default the procedures with reported "
36629 "ticks are not printed."
36632 #. type: Labeled list
36633 #: ../sys-utils/readprofile.8.adoc:30
36635 #| msgid "*-f*, *--fast*"
36636 msgid "*-b*, *--histbin*"
36637 msgstr "*-f*, *--fast*"
36639 #. type: Plain text
36640 #: ../sys-utils/readprofile.8.adoc:32
36641 msgid "Print individual histogram-bin counts."
36644 #. type: Plain text
36645 #: ../sys-utils/readprofile.8.adoc:35
36647 "Info. This makes *readprofile* only print the profiling step used by the "
36648 "kernel. The profiling step is the resolution of the profiling buffer, and is "
36649 "chosen during kernel configuration (through *make config*), or in the "
36650 "kernel's command line. If the *-t* (terse) switch is used together with *-i* "
36651 "only the decimal number is printed."
36654 #. type: Labeled list
36655 #: ../sys-utils/readprofile.8.adoc:36
36657 msgid "*-m*, *--mapfile* _mapfile_"
36660 #. type: Plain text
36661 #: ../sys-utils/readprofile.8.adoc:38
36663 "Specify a mapfile, which by default is _/usr/src/linux/System.map_. You "
36664 "should specify the map file on cmdline if your current kernel isn't the last "
36665 "one you compiled, or if you keep System.map elsewhere. If the name of the "
36666 "map file ends with _.gz_ it is decompressed on the fly."
36669 #. type: Labeled list
36670 #: ../sys-utils/readprofile.8.adoc:39
36672 msgid "*-M*, *--multiplier* _multiplier_"
36675 #. type: Plain text
36676 #: ../sys-utils/readprofile.8.adoc:41
36678 "On some architectures it is possible to alter the frequency at which the "
36679 "kernel delivers profiling interrupts to each CPU. This option allows you to "
36680 "set the frequency, as a multiplier of the system clock frequency, HZ. Linux "
36681 "2.6.16 dropped multiplier support for most systems. This option also resets "
36682 "the profiling buffer, and requires superuser privileges."
36685 #. type: Labeled list
36686 #: ../sys-utils/readprofile.8.adoc:42
36688 msgid "*-p*, *--profile* _pro-file_"
36691 #. type: Plain text
36692 #: ../sys-utils/readprofile.8.adoc:44
36694 "Specify a different profiling buffer, which by default is _/proc/profile_. "
36695 "Using a different pro-file is useful if you want to `freeze' the kernel "
36696 "profiling at some time and read it later. The _/proc/profile_ file can be "
36697 "copied using *cat*(1) or *cp*(1). There is no more support for compressed "
36698 "profile buffers, like in *readprofile-1.1*, because the program needs to "
36699 "know the size of the buffer in advance."
36702 #. type: Labeled list
36703 #: ../sys-utils/readprofile.8.adoc:45 ../sys-utils/tunelp.8.adoc:53
36704 #: ../sys-utils/zramctl.8.adoc:61
36706 #| msgid "*-f*, *--fast*"
36707 msgid "*-r*, *--reset*"
36708 msgstr "*-f*, *--fast*"
36710 #. type: Plain text
36711 #: ../sys-utils/readprofile.8.adoc:47
36713 "Reset the profiling buffer. This can only be invoked by root, because _/proc/"
36714 "profile_ is readable by everybody but writable only by the superuser. "
36715 "However, you can make *readprofile* set-user-ID 0, in order to reset the "
36716 "buffer without gaining privileges."
36719 #. type: Labeled list
36720 #: ../sys-utils/readprofile.8.adoc:48
36722 msgid "*-s, --counters*"
36725 #. type: Plain text
36726 #: ../sys-utils/readprofile.8.adoc:50
36727 msgid "Print individual counters within functions."
36730 #. type: Plain text
36731 #: ../sys-utils/readprofile.8.adoc:53
36733 "Verbose. The output is organized in four columns and filled with blanks. The "
36734 "first column is the RAM address of a kernel function, the second is the name "
36735 "of the function, the third is the number of clock ticks and the last is the "
36739 #. type: Labeled list
36740 #: ../sys-utils/readprofile.8.adoc:58
36742 msgid "_/proc/profile_"
36745 #. type: Plain text
36746 #: ../sys-utils/readprofile.8.adoc:60
36747 msgid "A binary snapshot of the profiling buffer."
36750 #. type: Labeled list
36751 #: ../sys-utils/readprofile.8.adoc:61
36753 msgid "_/usr/src/linux/System.map_"
36756 #. type: Plain text
36757 #: ../sys-utils/readprofile.8.adoc:63
36758 msgid "The symbol table for the kernel."
36761 #. type: Labeled list
36762 #: ../sys-utils/readprofile.8.adoc:64
36764 msgid "_/usr/src/linux/*_"
36767 #. type: Plain text
36768 #: ../sys-utils/readprofile.8.adoc:66
36769 msgid "The program being profiled :-)"
36772 #. type: Plain text
36773 #: ../sys-utils/readprofile.8.adoc:70
36775 msgid "*readprofile* only works with a 1.3.x or newer kernel, because _/proc/profile_ changed in the step from 1.2 to 1.3.\n"
36778 #. type: Plain text
36779 #: ../sys-utils/readprofile.8.adoc:72
36781 "This program only works with ELF kernels. The change for a.out kernels is "
36782 "trivial, and left as an exercise to the a.out user."
36785 #. type: Plain text
36786 #: ../sys-utils/readprofile.8.adoc:74
36788 "To enable profiling, the kernel must be rebooted, because no profiling "
36789 "module is available, and it wouldn't be easy to build. To enable profiling, "
36790 "you can specify *profile*=_2_ (or another number) on the kernel commandline. "
36791 "The number you specify is the two-exponent used as profiling step."
36794 #. type: Plain text
36795 #: ../sys-utils/readprofile.8.adoc:76
36797 "Profiling is disabled when interrupts are inhibited. This means that many "
36798 "profiling ticks happen when interrupts are re-enabled. Watch out for "
36799 "misleading information."
36802 #. type: Plain text
36803 #: ../sys-utils/readprofile.8.adoc:80
36804 msgid "Browse the profiling buffer ordering by clock ticks:"
36807 #. type: delimited block .
36808 #: ../sys-utils/readprofile.8.adoc:83
36810 msgid " readprofile | sort -nr | less\n"
36813 #. type: Plain text
36814 #: ../sys-utils/readprofile.8.adoc:86
36815 msgid "Print the 20 most loaded procedures:"
36818 #. type: delimited block .
36819 #: ../sys-utils/readprofile.8.adoc:89
36821 msgid " readprofile | sort -nr +2 | head -20\n"
36824 #. type: Plain text
36825 #: ../sys-utils/readprofile.8.adoc:92
36826 msgid "Print only filesystem profile:"
36829 #. type: delimited block .
36830 #: ../sys-utils/readprofile.8.adoc:95
36832 msgid " readprofile | grep _ext2\n"
36835 #. type: Plain text
36836 #: ../sys-utils/readprofile.8.adoc:98
36837 msgid "Look at all the kernel information, with ram addresses:"
36840 #. type: delimited block .
36841 #: ../sys-utils/readprofile.8.adoc:101
36843 msgid " readprofile -av | less\n"
36846 #. type: Plain text
36847 #: ../sys-utils/readprofile.8.adoc:104
36848 msgid "Browse a 'frozen' profile buffer for a non current kernel:"
36851 #. type: delimited block .
36852 #: ../sys-utils/readprofile.8.adoc:107
36854 msgid " readprofile -p ~/profile.freeze -m /zImage.map.gz\n"
36857 #. type: Plain text
36858 #: ../sys-utils/readprofile.8.adoc:110
36859 msgid "Request profiling at 2kHz per CPU, and reset the profiling buffer:"
36862 #. type: delimited block .
36863 #: ../sys-utils/readprofile.8.adoc:113
36865 msgid " sudo readprofile -M 20\n"
36872 #. Copyright (c) 1983, 1991, 1993
36873 #. The Regents of the University of California. All rights reserved.
36874 #. Redistribution and use in source and binary forms, with or without
36875 #. modification, are permitted provided that the following conditions
36877 #. 1. Redistributions of source code must retain the above copyright
36878 #. notice, this list of conditions and the following disclaimer.
36879 #. 2. Redistributions in binary form must reproduce the above copyright
36880 #. notice, this list of conditions and the following disclaimer in the
36881 #. documentation and/or other materials provided with the distribution.
36882 #. 3. All advertising materials mentioning features or use of this software
36883 #. must display the following acknowledgement:
36884 #. This product includes software developed by the University of
36885 #. California, Berkeley and its contributors.
36886 #. 4. Neither the name of the University nor the names of its contributors
36887 #. may be used to endorse or promote products derived from this software
36888 #. without specific prior written permission.
36889 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
36890 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
36891 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
36892 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
36893 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36894 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
36895 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36896 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36897 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
36898 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36900 #. @(#)renice.8 8.1 (Berkeley) 6/9/93
36902 #: ../sys-utils/renice.1.adoc:36
36904 #| msgid "write(1)"
36908 #. type: Plain text
36909 #: ../sys-utils/renice.1.adoc:46
36910 msgid "renice - alter priority of running processes"
36913 #. type: Plain text
36914 #: ../sys-utils/renice.1.adoc:50
36916 msgid "*renice* [*--priority|--relative*] _priority_ [*-g*|*-p*|*-u*] _identifier_...\n"
36919 #. type: Plain text
36920 #: ../sys-utils/renice.1.adoc:54
36922 msgid "*renice* alters the scheduling priority of one or more running processes. The first argument is the _priority_ value to be used. The other arguments are interpreted as process IDs (by default), process group IDs, user IDs, or user names. *renice*'ing a process group causes all processes in the process group to have their scheduling priority altered. *renice*'ing a user causes all processes owned by the user to have their scheduling priority altered.\n"
36925 #. type: Plain text
36926 #: ../sys-utils/renice.1.adoc:56
36928 "If no *-n*, *--priority* or *--relative* option is used, then the priority "
36929 "is set as *absolute*."
36932 #. type: Labeled list
36933 #: ../sys-utils/renice.1.adoc:59
36935 #| msgid "*-P*, *--pty*"
36936 msgid "*-n* _priority_"
36937 msgstr "*-P*, *--pty*"
36939 #. type: Plain text
36940 #: ../sys-utils/renice.1.adoc:61
36942 "Specify the *absolute* or *relative* (depending on environment variable "
36943 "POSIXLY_CORRECT) scheduling _priority_ to be used for the process, process "
36944 "group, or user. Use of the option *-n* is optional, but when used, it must "
36945 "be the first argument. See *NOTES* for more information."
36948 #. type: Labeled list
36949 #: ../sys-utils/renice.1.adoc:62
36951 #| msgid "*-P*, *--pty*"
36952 msgid "*--priority* _priority_"
36953 msgstr "*-P*, *--pty*"
36955 #. type: Plain text
36956 #: ../sys-utils/renice.1.adoc:64
36958 "Specify an *absolute* scheduling _priority_. _Priority_ is set to the given "
36959 "value. This is the default, when no option is specified."
36962 #. type: Labeled list
36963 #: ../sys-utils/renice.1.adoc:65
36965 msgid "*--relative* _priority_"
36968 #. type: Plain text
36969 #: ../sys-utils/renice.1.adoc:67
36971 "Specify a *relative* scheduling _priority_. Same as the standard POSIX *-n* "
36972 "option. _Priority_ gets _incremented/decremented_ by the given value."
36975 #. type: Labeled list
36976 #: ../sys-utils/renice.1.adoc:68
36978 #| msgid "*-P*, *--pty*"
36979 msgid "*-g*, *--pgrp*"
36980 msgstr "*-P*, *--pty*"
36982 #. type: Plain text
36983 #: ../sys-utils/renice.1.adoc:70
36984 msgid "Interpret the succeeding arguments as process group IDs."
36987 #. type: Plain text
36988 #: ../sys-utils/renice.1.adoc:73
36989 msgid "Interpret the succeeding arguments as process IDs (the default)."
36992 #. type: Labeled list
36993 #: ../sys-utils/renice.1.adoc:74
36995 #| msgid "*-h*, *--help*"
36996 msgid "*-u*, *--user*"
36997 msgstr "*-h*, *--help*"
36999 #. type: Plain text
37000 #: ../sys-utils/renice.1.adoc:76
37001 msgid "Interpret the succeeding arguments as usernames or UIDs."
37004 #. type: Labeled list
37005 #: ../sys-utils/renice.1.adoc:81
37007 #| msgid "_/etc/pam.d/su_"
37008 msgid "_/etc/passwd_"
37009 msgstr "_/etc/pam.d/su_"
37011 #. type: Plain text
37012 #: ../sys-utils/renice.1.adoc:83
37013 msgid "to map user names to user IDs"
37016 #. type: Plain text
37017 #: ../sys-utils/renice.1.adoc:87
37019 "Users other than the superuser may only alter the priority of processes they "
37020 "own. Furthermore, an unprivileged user can only _increase_ the \"nice "
37021 "value\" (i.e., choose a lower priority) and such changes are irreversible "
37022 "unless (since Linux 2.6.12) the user has a suitable \"nice\" resource limit "
37023 "(see *ulimit*(1p) and *getrlimit*(2))."
37026 #. type: Plain text
37027 #: ../sys-utils/renice.1.adoc:89
37029 "The superuser may alter the priority of any process and set the priority to "
37030 "any value in the range -20 to 19. Useful priorities are: 19 (the affected "
37031 "processes will run only when nothing else in the system wants to), 0 (the "
37032 "\"base\" scheduling priority), anything negative (to make things go very "
37036 #. type: Plain text
37037 #: ../sys-utils/renice.1.adoc:91
37039 "For historical reasons in this implementation, the *-n* option did not "
37040 "follow the POSIX specification. Therefore, instead of setting a *relative* "
37041 "priority, it sets an *absolute* priority by default. As this may not be "
37042 "desirable, this behavior can be controlled by setting the environment "
37043 "variable POSIXLY_CORRECT to be fully POSIX compliant. See the *-n* option "
37044 "for details. See *--relative* and *--priority* for options that do not "
37045 "change behavior depending on environment variables."
37048 #. type: Plain text
37049 #: ../sys-utils/renice.1.adoc:95
37051 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
37052 msgid "The *renice* command appeared in 4.0BSD."
37053 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
37055 #. type: Plain text
37056 #: ../sys-utils/renice.1.adoc:99
37058 "The following command would change the priority of the processes with PIDs "
37059 "987 and 32, plus all processes owned by the users daemon and root:"
37062 #. type: Plain text
37063 #: ../sys-utils/renice.1.adoc:101
37065 msgid "*renice +1 987 -u daemon root -p 32*\n"
37068 #. type: Plain text
37069 #: ../sys-utils/renice.1.adoc:110
37074 "*getpriority*(2),\n"
37075 "*setpriority*(2),\n"
37076 "*credentials*(7),\n"
37081 #: ../sys-utils/rfkill.8.adoc:2
37086 #. type: Plain text
37087 #: ../sys-utils/rfkill.8.adoc:12
37088 msgid "rfkill - tool for enabling and disabling wireless devices"
37091 #. type: Plain text
37092 #: ../sys-utils/rfkill.8.adoc:16
37094 msgid "*rfkill* [options] [_command_] [_ID_|_type_ ...]\n"
37097 #. type: Plain text
37098 #: ../sys-utils/rfkill.8.adoc:20
37100 msgid "*rfkill* lists, enabling and disabling wireless devices.\n"
37103 #. type: Plain text
37104 #: ../sys-utils/rfkill.8.adoc:22
37106 "The command \"list\" output format is deprecated and maintained for backward "
37107 "compatibility only. The new output format is the default when no command is "
37108 "specified or when the option *--output* is used."
37111 #. type: Plain text
37112 #: ../sys-utils/rfkill.8.adoc:24
37114 "The default output is subject to change. So whenever possible, you should "
37115 "avoid using default outputs in your scripts. Always explicitly define "
37116 "expected columns by using the *--output* option together with a columns list "
37117 "in environments where a stable output is required."
37120 #. type: Plain text
37121 #: ../sys-utils/rfkill.8.adoc:35
37123 "Specify which output columns to print. Use *--help* to get a list of "
37124 "available columns."
37127 #. type: Labeled list
37128 #: ../sys-utils/rfkill.8.adoc:46
37130 #| msgid "*-h*, *--help*"
37132 msgstr "*-h*, *--help*"
37134 #. type: Labeled list
37135 #: ../sys-utils/rfkill.8.adoc:49
37137 #| msgid "*comment*"
37141 #. type: Plain text
37142 #: ../sys-utils/rfkill.8.adoc:51
37143 msgid "Listen for rfkill events and display them on stdout."
37146 #. type: Labeled list
37147 #: ../sys-utils/rfkill.8.adoc:52
37149 msgid "*list* [__id__|__type__ ...]"
37152 #. type: Plain text
37153 #: ../sys-utils/rfkill.8.adoc:54
37155 "List the current state of all available devices. The command output format "
37156 "is deprecated, see the *DESCRIPTION* section. It is a good idea to check "
37157 "with *list* command _id_ or _type_ scope is appropriate before setting "
37158 "*block* or *unblock*. Special _all_ type string will match everything. Use "
37159 "of multiple _ID_ or _type_ arguments is supported. Possible types are all, "
37160 "{wlan | wifi}, bluetooth, {uwb | ultrawideband}, wimax, wwan, gps, fm, nfc."
37163 #. type: Labeled list
37164 #: ../sys-utils/rfkill.8.adoc:55
37166 msgid "**block** __id__|__type__ [...]"
37169 #. type: Plain text
37170 #: ../sys-utils/rfkill.8.adoc:57
37171 msgid "Disable the corresponding device."
37174 #. type: Labeled list
37175 #: ../sys-utils/rfkill.8.adoc:58
37177 msgid "**unblock** __id__|__type__ [...]"
37180 #. type: Plain text
37181 #: ../sys-utils/rfkill.8.adoc:60
37183 "Enable the corresponding device. If the device is hard-blocked, for example "
37184 "via a hardware switch, it will remain unavailable though it is now soft-"
37188 #. type: Labeled list
37189 #: ../sys-utils/rfkill.8.adoc:61
37191 msgid "**toggle** __id__|__type__ [...]"
37194 #. type: Plain text
37195 #: ../sys-utils/rfkill.8.adoc:63
37196 msgid "Enable or disable the corresponding device."
37199 #. type: delimited block .
37200 #: ../sys-utils/rfkill.8.adoc:70
37203 " rfkill --output ID,TYPE\n"
37204 " rfkill block all\n"
37205 " rfkill unblock wlan\n"
37206 " rfkill block bluetooth uwb wimax wwan gps fm nfc\n"
37209 #. type: Plain text
37210 #: ../sys-utils/rfkill.8.adoc:75
37212 msgid "*rfkill* was originally written by mailto:johannes@sipsolutions.net[Johannes Berg] and mailto:marcel@holtmann.org[Marcel Holtmann]. The code has been later modified by mailto:kerolasa@iki.fi[Sami Kerola] and mailto:kzak@redhat.com[Karel Zak] for the util-linux project.\n"
37215 #. type: Plain text
37216 #: ../sys-utils/rfkill.8.adoc:77
37218 "This manual page was written by mailto:linux@youmustbejoking.demon.co."
37219 "uk[Darren Salt] for the Debian project (and may be used by others)."
37222 #. type: Plain text
37223 #: ../sys-utils/rfkill.8.adoc:83
37227 "*systemd-rfkill*(8),\n"
37228 "https://docs.kernel.org/driver-api/rfkill.html[Linux kernel documentation]\n"
37232 #: ../sys-utils/rtcwake.8.adoc:2
37237 #. type: Plain text
37238 #: ../sys-utils/rtcwake.8.adoc:12
37239 msgid "rtcwake - enter a system sleep state until specified wakeup time"
37242 #. type: Plain text
37243 #: ../sys-utils/rtcwake.8.adoc:16
37245 msgid "*rtcwake* [options] [*-d* _device_] [*-m* _standby_mode_] {*-s* _seconds_|*-t* _time_t_}\n"
37248 #. type: Plain text
37249 #: ../sys-utils/rtcwake.8.adoc:20
37251 "This program is used to enter a system sleep state and to automatically wake "
37252 "from it at a specified time."
37255 #. type: Plain text
37256 #: ../sys-utils/rtcwake.8.adoc:22
37258 "This uses cross-platform Linux interfaces to enter a system sleep state, and "
37259 "leave it no later than a specified time. It uses any RTC framework driver "
37260 "that supports standard driver model wakeup flags."
37263 #. type: Plain text
37264 #: ../sys-utils/rtcwake.8.adoc:24
37266 "This is normally used like the old *apmsleep* utility, to wake from a "
37267 "suspend state like ACPI S1 (standby) or S3 (suspend-to-RAM). Most platforms "
37268 "can implement those without analogues of BIOS, APM, or ACPI."
37271 #. type: Plain text
37272 #: ../sys-utils/rtcwake.8.adoc:26
37274 "On some systems, this can also be used like *nvram-wakeup*, waking from "
37275 "states like ACPI S4 (suspend to disk). Not all systems have persistent media "
37276 "that are appropriate for such suspend modes."
37279 #. type: Plain text
37280 #: ../sys-utils/rtcwake.8.adoc:28
37282 "Note that alarm functionality depends on hardware; not every RTC is able to "
37283 "setup an alarm up to 24 hours in the future."
37286 #. type: Plain text
37287 #: ../sys-utils/rtcwake.8.adoc:30
37289 "The suspend setup may be interrupted by active hardware; for example "
37290 "wireless USB input devices that continue to send events for some fraction of "
37291 "a second after the return key is pressed. *rtcwake* tries to avoid this "
37292 "problem and it waits to the terminal to settle down before entering a system "
37296 #. type: Labeled list
37297 #: ../sys-utils/rtcwake.8.adoc:33
37299 msgid "*-A*, *--adjfile* _file_"
37302 #. type: Plain text
37303 #: ../sys-utils/rtcwake.8.adoc:35
37304 msgid "Specify an alternative path to the adjust file."
37307 #. type: Plain text
37308 #: ../sys-utils/rtcwake.8.adoc:38
37310 "Read the clock mode (whether the hardware clock is set to UTC or local time) "
37311 "from the _adjtime_ file, where *hwclock*(8) stores that information. This is "
37315 #. type: Labeled list
37316 #: ../sys-utils/rtcwake.8.adoc:39
37318 msgid "*--date* _timestamp_"
37321 #. type: Plain text
37322 #: ../sys-utils/rtcwake.8.adoc:41
37324 "Set the wakeup time to the value of the timestamp. Format of the timestamp "
37325 "can be any of the following:"
37329 #: ../sys-utils/rtcwake.8.adoc:52
37332 "|YYYYMMDDhhmmss |\n"
37333 "|YYYY-MM-DD hh:mm:ss |\n"
37334 "|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
37335 "|YYYY-MM-DD |(time will be set to 00:00:00)\n"
37336 "|hh:mm:ss |(date will be set to today)\n"
37337 "|hh:mm |(date will be set to today, seconds to 00)\n"
37338 "|tomorrow |(time is set to 00:00:00)\n"
37342 #. type: Labeled list
37343 #: ../sys-utils/rtcwake.8.adoc:54
37345 msgid "*-d*, *--device* _device_"
37348 #. type: Plain text
37349 #: ../sys-utils/rtcwake.8.adoc:56
37351 "Use the specified _device_ instead of *rtc0* as realtime clock. This option "
37352 "is only relevant if your system has more than one RTC. You may specify "
37353 "*rtc1*, *rtc2*, ... here."
37356 #. type: Labeled list
37357 #: ../sys-utils/rtcwake.8.adoc:57
37359 #| msgid "*-h*, *--help*"
37360 msgid "*-l*, *--local*"
37361 msgstr "*-h*, *--help*"
37363 #. type: Plain text
37364 #: ../sys-utils/rtcwake.8.adoc:59
37366 "Assume that the hardware clock is set to local time, regardless of the "
37367 "contents of the _adjtime_ file."
37370 #. type: Labeled list
37371 #: ../sys-utils/rtcwake.8.adoc:60
37373 msgid "*--list-modes*"
37376 #. type: Plain text
37377 #: ../sys-utils/rtcwake.8.adoc:62
37378 msgid "List available *--mode* option arguments."
37381 #. type: Labeled list
37382 #: ../sys-utils/rtcwake.8.adoc:63
37384 msgid "*-m*, *--mode* _mode_"
37387 #. type: Plain text
37388 #: ../sys-utils/rtcwake.8.adoc:65
37389 msgid "Go into the given standby state. Valid values for _mode_ are:"
37392 #. type: Labeled list
37393 #: ../sys-utils/rtcwake.8.adoc:66
37398 #. type: Plain text
37399 #: ../sys-utils/rtcwake.8.adoc:68
37401 "ACPI state S1. This state offers minimal, though real, power savings, while "
37402 "providing a very low-latency transition back to a working system. This is "
37403 "the default mode."
37406 #. type: Labeled list
37407 #: ../sys-utils/rtcwake.8.adoc:69
37412 #. type: Plain text
37413 #: ../sys-utils/rtcwake.8.adoc:71
37415 "The processes are frozen, all the devices are suspended and all the "
37416 "processors idled. This state is a general state that does not need any "
37417 "platform-specific support, but it saves less power than Suspend-to-RAM, "
37418 "because the system is still in a running state. (Available since Linux 3.9.)"
37421 #. type: Labeled list
37422 #: ../sys-utils/rtcwake.8.adoc:72
37427 #. type: Plain text
37428 #: ../sys-utils/rtcwake.8.adoc:74
37430 "ACPI state S3 (Suspend-to-RAM). This state offers significant power savings "
37431 "as everything in the system is put into a low-power state, except for "
37432 "memory, which is placed in self-refresh mode to retain its contents."
37435 #. type: Labeled list
37436 #: ../sys-utils/rtcwake.8.adoc:75
37441 #. type: Plain text
37442 #: ../sys-utils/rtcwake.8.adoc:77
37444 "ACPI state S4 (Suspend-to-disk). This state offers the greatest power "
37445 "savings, and can be used even in the absence of low-level platform support "
37446 "for power management. This state operates similarly to Suspend-to-RAM, but "
37447 "includes a final step of writing memory contents to disk."
37450 #. type: Plain text
37451 #: ../sys-utils/rtcwake.8.adoc:80
37453 "ACPI state S5 (Poweroff). This is done by calling '/sbin/shutdown'. Not "
37454 "officially supported by ACPI, but it usually works."
37457 #. type: Labeled list
37458 #: ../sys-utils/rtcwake.8.adoc:81
37463 #. type: Plain text
37464 #: ../sys-utils/rtcwake.8.adoc:83
37465 msgid "Don't suspend, only set the RTC wakeup time."
37468 #. type: Plain text
37469 #: ../sys-utils/rtcwake.8.adoc:86
37471 "Don't suspend, but read the RTC device until an alarm time appears. This "
37472 "mode is useful for debugging."
37475 #. type: Plain text
37476 #: ../sys-utils/rtcwake.8.adoc:89
37477 msgid "Disable a previously set alarm."
37480 #. type: Labeled list
37481 #: ../sys-utils/rtcwake.8.adoc:90
37486 #. type: Plain text
37487 #: ../sys-utils/rtcwake.8.adoc:92
37489 "Print alarm information in format: \"alarm: off|on <time>\". The time is in "
37490 "ctime() output format, e.g., \"alarm: on Tue Nov 16 04:48:45 2010\"."
37493 #. type: Plain text
37494 #: ../sys-utils/rtcwake.8.adoc:95
37496 "This option does everything apart from actually setting up the alarm, "
37497 "suspending the system, or waiting for the alarm."
37500 #. type: Labeled list
37501 #: ../sys-utils/rtcwake.8.adoc:96
37503 #| msgid "*-c*, **--command**=__command__"
37504 msgid "*-s*, *--seconds* _seconds_"
37505 msgstr "*-c*, **--command**=__příkaz__"
37507 #. type: Plain text
37508 #: ../sys-utils/rtcwake.8.adoc:98
37509 msgid "Set the wakeup time to _seconds_ in the future from now."
37512 #. type: Labeled list
37513 #: ../sys-utils/rtcwake.8.adoc:99
37515 msgid "*-t*, *--time* _time_t_"
37518 #. type: Plain text
37519 #: ../sys-utils/rtcwake.8.adoc:101
37521 "Set the wakeup time to the absolute time _time_t_. _time_t_ is the time in "
37522 "seconds since 1970-01-01, 00:00 UTC. Use the *date*(1) tool to convert "
37523 "between human-readable time and _time_t_."
37526 #. type: Labeled list
37527 #: ../sys-utils/rtcwake.8.adoc:102
37529 #| msgid "*-P*, *--pty*"
37530 msgid "*-u*, *--utc*"
37531 msgstr "*-P*, *--pty*"
37533 #. type: Plain text
37534 #: ../sys-utils/rtcwake.8.adoc:104
37536 "Assume that the hardware clock is set to UTC (Universal Time Coordinated), "
37537 "regardless of the contents of the _adjtime_ file."
37540 #. type: Plain text
37541 #: ../sys-utils/rtcwake.8.adoc:113
37543 "Some PC systems can't currently exit sleep states such as *mem* using only "
37544 "the kernel code accessed by this driver. They need help from userspace code "
37545 "to make the framebuffer work again."
37548 #. type: Plain text
37549 #: ../sys-utils/rtcwake.8.adoc:121
37551 "The program was posted several times on LKML and other lists before "
37552 "appearing in kernel commit message for Linux 2.6 in the GIT commit "
37553 "87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d."
37556 #. type: Plain text
37557 #: ../sys-utils/rtcwake.8.adoc:125
37559 "The program was written by mailto:dbrownell@users.sourceforge.net[David "
37560 "Brownell] and improved by mailto:bwalle@suse.de[Bernhard Walle]."
37563 #. type: Plain text
37564 #: ../sys-utils/rtcwake.8.adoc:129
37566 "This is free software. You may redistribute copies of it under the terms of "
37567 "the link:http://www.gnu.org/licenses/gpl.html[GNU General Public License]. "
37568 "There is NO WARRANTY, to the extent permitted by law."
37571 #. type: Plain text
37572 #: ../sys-utils/rtcwake.8.adoc:135
37579 "*adjtime_config*(5),\n"
37588 #: ../sys-utils/setarch.8.adoc:2
37593 #. type: Plain text
37594 #: ../sys-utils/setarch.8.adoc:12
37596 "setarch - change reported architecture in new program environment and/or set "
37597 "personality flags"
37600 #. type: Plain text
37601 #: ../sys-utils/setarch.8.adoc:16
37603 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
37604 msgid "*setarch* [_arch_] [options] [_program_ [_argument_...]]\n"
37605 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
37607 #. type: Plain text
37608 #: ../sys-utils/setarch.8.adoc:18
37610 msgid "*setarch* *--list*|*-h*|*-V*\n"
37613 #. type: Plain text
37614 #: ../sys-utils/setarch.8.adoc:20
37616 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
37617 msgid "*arch* [options] [_program_ [_argument_...]]\n"
37618 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
37620 #. type: Plain text
37621 #: ../sys-utils/setarch.8.adoc:24
37623 msgid "*setarch* modifies execution domains and process personality flags.\n"
37626 #. type: Plain text
37627 #: ../sys-utils/setarch.8.adoc:26
37629 "The execution domains currently only affects the output of *uname -m*. For "
37630 "example, on an AMD64 system, running *setarch i386* _program_ will cause "
37631 "_program_ to see i686 instead of _x86_64_ as the machine type. It can also "
37632 "be used to set various personality options. The default _program_ is */bin/"
37636 #. type: Plain text
37637 #: ../sys-utils/setarch.8.adoc:28
37639 "Since version 2.33 the _arch_ command line argument is optional and "
37640 "*setarch* may be used to change personality flags (ADDR_LIMIT_*, "
37641 "SHORT_INODE, etc) without modification of the execution domain."
37644 #. type: Labeled list
37645 #: ../sys-utils/setarch.8.adoc:31
37650 #. type: Plain text
37651 #: ../sys-utils/setarch.8.adoc:33
37653 "List the architectures that *setarch* knows about. Whether *setarch* can "
37654 "actually set each of these architectures depends on the running kernel."
37657 #. type: Labeled list
37658 #: ../sys-utils/setarch.8.adoc:34
37660 msgid "*--show[=personality]*"
37663 #. type: Plain text
37664 #: ../sys-utils/setarch.8.adoc:38
37666 "Show the currently active personality and flags. If the *personality* "
37667 "argument is provided, it is shown instead of the current one. *personality* "
37668 "is a hexadecimal number with values was described in *sys/personality.h*."
37671 #. type: Labeled list
37672 #: ../sys-utils/setarch.8.adoc:39
37674 msgid "*--uname-2.6*"
37677 #. type: Plain text
37678 #: ../sys-utils/setarch.8.adoc:41
37680 "Causes the _program_ to see a kernel version number beginning with 2.6. "
37681 "Turns on *UNAME26*."
37684 #. type: Labeled list
37685 #: ../sys-utils/setarch.8.adoc:45
37687 #| msgid "*-P*, *--pty*"
37688 msgid "*-3*, *--3gb*"
37689 msgstr "*-P*, *--pty*"
37691 #. type: Plain text
37692 #: ../sys-utils/setarch.8.adoc:47
37694 "Specifies _program_ should use a maximum of 3GB of address space. Supported "
37695 "on x86. Turns on *ADDR_LIMIT_3GB*."
37698 #. type: Labeled list
37699 #: ../sys-utils/setarch.8.adoc:48
37704 #. type: Plain text
37705 #: ../sys-utils/setarch.8.adoc:50
37707 "This option has no effect. It is retained for backward compatibility only, "
37708 "and may be removed in future releases."
37711 #. type: Labeled list
37712 #: ../sys-utils/setarch.8.adoc:51
37714 #| msgid "*-P*, *--pty*"
37715 msgid "*-B*, *--32bit*"
37716 msgstr "*-P*, *--pty*"
37718 #. type: Plain text
37719 #: ../sys-utils/setarch.8.adoc:53
37721 "Limit the address space to 32 bits to emulate hardware. Supported on ARM and "
37722 "Alpha. Turns on *ADDR_LIMIT_32BIT*."
37725 #. type: Labeled list
37726 #: ../sys-utils/setarch.8.adoc:54
37728 msgid "*-F*, *--fdpic-funcptrs*"
37731 #. type: Plain text
37732 #: ../sys-utils/setarch.8.adoc:56
37734 "Treat user-space function pointers to signal handlers as pointers to address "
37735 "descriptors. This option has no effect on architectures that do not support "
37736 "*FDPIC* ELF binaries. In kernel v4.14 support is limited to ARM, Blackfin, "
37737 "Fujitsu FR-V, and SuperH CPU architectures."
37740 #. type: Labeled list
37741 #: ../sys-utils/setarch.8.adoc:57
37743 #| msgid "*-V*, *--version*"
37744 msgid "*-I*, *--short-inode*"
37745 msgstr "*-V*, *--version*"
37747 #. type: Plain text
37748 #: ../sys-utils/setarch.8.adoc:59
37749 msgid "Obsolete bug emulation flag. Turns on *SHORT_INODE*."
37752 #. type: Labeled list
37753 #: ../sys-utils/setarch.8.adoc:60
37755 msgid "*-L*, *--addr-compat-layout*"
37758 #. type: Plain text
37759 #: ../sys-utils/setarch.8.adoc:62
37761 "Provide legacy virtual address space layout. Use when the _program_ binary "
37762 "does not have *PT_GNU_STACK* ELF header. Turns on *ADDR_COMPAT_LAYOUT*."
37765 #. type: Labeled list
37766 #: ../sys-utils/setarch.8.adoc:63
37768 msgid "*-R*, *--addr-no-randomize*"
37771 #. type: Plain text
37772 #: ../sys-utils/setarch.8.adoc:65
37774 "Disables randomization of the virtual address space. Turns on "
37775 "*ADDR_NO_RANDOMIZE*."
37778 #. type: Labeled list
37779 #: ../sys-utils/setarch.8.adoc:66
37781 #| msgid "*-V*, *--version*"
37782 msgid "*-S*, *--whole-seconds*"
37783 msgstr "*-V*, *--version*"
37785 #. type: Plain text
37786 #: ../sys-utils/setarch.8.adoc:68
37787 msgid "Obsolete bug emulation flag. Turns on *WHOLE_SECONDS*."
37790 #. type: Labeled list
37791 #: ../sys-utils/setarch.8.adoc:69
37793 msgid "*-T*, *--sticky-timeouts*"
37796 #. type: Plain text
37797 #: ../sys-utils/setarch.8.adoc:71
37799 "This makes *select*(2), *pselect*(2), and *ppoll*(2) system calls preserve "
37800 "the timeout value instead of modifying it to reflect the amount of time not "
37801 "slept when interrupted by a signal handler. Use when _program_ depends on "
37802 "this behavior. For more details see the timeout description in *select*(2) "
37803 "manual page. Turns on *STICKY_TIMEOUTS*."
37806 #. type: Labeled list
37807 #: ../sys-utils/setarch.8.adoc:72
37809 msgid "*-X*, *--read-implies-exec*"
37812 #. type: Plain text
37813 #: ../sys-utils/setarch.8.adoc:74
37815 "If this is set then *mmap*(2) *PROT_READ* will also add the *PROT_EXEC* bit "
37816 "- as expected by legacy x86 binaries. Notice that the ELF loader will "
37817 "automatically set this bit when it encounters a legacy binary. Turns on "
37818 "*READ_IMPLIES_EXEC*."
37821 #. type: Labeled list
37822 #: ../sys-utils/setarch.8.adoc:75
37824 msgid "*-Z*, *--mmap-page-zero*"
37827 #. type: Plain text
37828 #: ../sys-utils/setarch.8.adoc:77
37830 "SVr4 bug emulation that will set *mmap*(2) page zero as read-only. Use when "
37831 "_program_ depends on this behavior, and the source code is not available to "
37832 "be fixed. Turns on *MMAP_PAGE_ZERO*."
37835 #. type: delimited block .
37836 #: ../sys-utils/setarch.8.adoc:87
37839 "setarch --addr-no-randomize mytestprog\n"
37840 "setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm\n"
37841 "setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm\n"
37842 "setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm\n"
37845 #. type: Plain text
37846 #: ../sys-utils/setarch.8.adoc:94
37848 "mailto:sopwith@redhat.com[Elliot Lee], mailto:jnovy@redhat.com[Jindrich "
37849 "Novy], mailto:kzak@redhat.com[Karel Zak]"
37852 #. type: Plain text
37853 #: ../sys-utils/setarch.8.adoc:99
37856 "*personality*(2),\n"
37861 #: ../sys-utils/setpriv.1.adoc:2
37866 #. type: Plain text
37867 #: ../sys-utils/setpriv.1.adoc:12
37868 msgid "setpriv - run a program with different Linux privilege settings"
37871 #. type: Plain text
37872 #: ../sys-utils/setpriv.1.adoc:16
37874 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
37875 msgid "*setpriv* [options] _program_ [_arguments_]\n"
37876 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
37878 #. type: Plain text
37879 #: ../sys-utils/setpriv.1.adoc:20
37881 "Sets or queries various Linux privilege settings that are inherited across "
37885 #. type: Plain text
37886 #: ../sys-utils/setpriv.1.adoc:22
37888 "In comparison to *su*(1) and *runuser*(1), *setpriv* neither uses PAM, nor "
37889 "does it prompt for a password. It is a simple, non-set-user-ID wrapper "
37890 "around *execve*(2), and can be used to drop privileges in the same way as "
37891 "*setuidgid*(8) from *daemontools*, *chpst*(8) from *runit*, or similar tools "
37892 "shipped by other service managers."
37895 #. type: Labeled list
37896 #: ../sys-utils/setpriv.1.adoc:25
37898 msgid "*--clear-groups*"
37901 #. type: Plain text
37902 #: ../sys-utils/setpriv.1.adoc:27
37903 msgid "Clear supplementary groups."
37906 #. type: Labeled list
37907 #: ../sys-utils/setpriv.1.adoc:28
37909 #| msgid "*-P*, *--pty*"
37910 msgid "*-d*, *--dump*"
37911 msgstr "*-P*, *--pty*"
37913 #. type: Plain text
37914 #: ../sys-utils/setpriv.1.adoc:30
37916 "Dump the current privilege state. This option can be specified more than "
37917 "once to show extra, mostly useless, information. Incompatible with all other "
37921 #. type: Labeled list
37922 #: ../sys-utils/setpriv.1.adoc:31
37924 #| msgid "*-g*, **--group**=__group__"
37925 msgid "*--groups* _group_..."
37926 msgstr "*-g*, **--group**=__skupina__"
37928 #. type: Plain text
37929 #: ../sys-utils/setpriv.1.adoc:33
37931 "Set supplementary groups. The argument is a comma-separated list of GIDs or "
37935 #. type: Labeled list
37936 #: ../sys-utils/setpriv.1.adoc:34
37938 msgid "*--inh-caps* (*+*|*-*)_cap_..."
37941 #. type: Labeled list
37942 #: ../sys-utils/setpriv.1.adoc:35
37944 msgid "*--ambient-caps* (*+*|*-*)_cap_..."
37947 #. type: Labeled list
37948 #: ../sys-utils/setpriv.1.adoc:36
37950 msgid "*--bounding-set* (*+*|*-*)_cap_..."
37953 #. type: Plain text
37954 #: ../sys-utils/setpriv.1.adoc:38
37956 "Set the inheritable capabilities, ambient capabilities or the capability "
37957 "bounding set. See *capabilities*(7). The argument is a comma-separated list "
37958 "of **+**__cap__ and **-**__cap__ entries, which add or remove an entry "
37959 "respectively. _cap_ can either be a human-readable name as seen in "
37960 "*capabilities*(7) without the _cap__ prefix or of the format *cap_N*, where "
37961 "_N_ is the internal capability index used by Linux. *+all* and *-all* can be "
37962 "used to add or remove all caps."
37965 #. type: Plain text
37966 #: ../sys-utils/setpriv.1.adoc:40
37968 "The set of capabilities starts out as the current inheritable set for *--inh-"
37969 "caps*, the current ambient set for *--ambient-caps* and the current bounding "
37970 "set for *--bounding-set*."
37973 #. type: Plain text
37974 #: ../sys-utils/setpriv.1.adoc:42
37976 "Note the following restrictions (detailed in *capabilities*(7)) regarding "
37977 "modifications to these capability sets:"
37980 #. type: Plain text
37981 #: ../sys-utils/setpriv.1.adoc:44
37983 "A capability can be added to the inheritable set only if it is currently "
37984 "present in the bounding set."
37987 #. type: Plain text
37988 #: ../sys-utils/setpriv.1.adoc:45
37990 "A capability can be added to the ambient set only if it is currently present "
37991 "in both the permitted and inheritable sets."
37994 #. type: Plain text
37995 #: ../sys-utils/setpriv.1.adoc:46
37997 "Notwithstanding the syntax offered by *setpriv*, the kernel does not permit "
37998 "capabilities to be added to the bounding set."
38001 #. type: Plain text
38002 #: ../sys-utils/setpriv.1.adoc:48
38004 "If you drop a capability from the bounding set without also dropping it from "
38005 "the inheritable set, you are likely to become confused. Do not do that."
38008 #. type: Labeled list
38009 #: ../sys-utils/setpriv.1.adoc:49
38011 msgid "*--keep-groups*"
38014 #. type: Plain text
38015 #: ../sys-utils/setpriv.1.adoc:51
38017 "Preserve supplementary groups. Only useful in conjunction with *--rgid*, *--"
38018 "egid*, or *--regid*."
38021 #. type: Labeled list
38022 #: ../sys-utils/setpriv.1.adoc:52
38024 msgid "*--init-groups*"
38027 #. type: Plain text
38028 #: ../sys-utils/setpriv.1.adoc:54
38030 "Initialize supplementary groups using initgroups3. Only useful in "
38031 "conjunction with *--ruid* or *--reuid*."
38034 #. type: Labeled list
38035 #: ../sys-utils/setpriv.1.adoc:55
38037 msgid "*--list-caps*"
38040 #. type: Plain text
38041 #: ../sys-utils/setpriv.1.adoc:57
38042 msgid "List all known capabilities. This option must be specified alone."
38045 #. type: Labeled list
38046 #: ../sys-utils/setpriv.1.adoc:58
38048 msgid "*--no-new-privs*"
38051 #. type: Plain text
38052 #: ../sys-utils/setpriv.1.adoc:60
38054 "Set the _no_new_privs_ bit. With this bit set, *execve*(2) will not grant "
38055 "new privileges. For example, the set-user-ID and set-group-ID bits as well "
38056 "as file capabilities will be disabled. (Executing binaries with these bits "
38057 "set will still work, but they will not gain privileges. Certain LSMs, "
38058 "especially AppArmor, may result in failures to execute certain programs.) "
38059 "This bit is inherited by child processes and cannot be unset. See *prctl*(2) "
38060 "and _Documentation/prctl/no_new_privs.txt_ in the Linux kernel source."
38063 #. type: Plain text
38064 #: ../sys-utils/setpriv.1.adoc:62
38065 msgid "The _no_new_privs_ bit is supported since Linux 3.5."
38068 #. type: Labeled list
38069 #: ../sys-utils/setpriv.1.adoc:63
38071 msgid "*--rgid* _gid_, *--egid* _gid_, *--regid* _gid_"
38074 #. type: Plain text
38075 #: ../sys-utils/setpriv.1.adoc:65
38077 "Set the real, effective, or both GIDs. The _gid_ argument can be given as a "
38078 "textual group name."
38081 #. type: Plain text
38082 #: ../sys-utils/setpriv.1.adoc:67
38084 "For safety, you must specify one of *--clear-groups*, *--groups*, *--keep-"
38085 "groups*, or *--init-groups* if you set any primary _gid_."
38088 #. type: Labeled list
38089 #: ../sys-utils/setpriv.1.adoc:68
38091 msgid "*--ruid* _uid_, *--euid* _uid_, *--reuid* _uid_"
38094 #. type: Plain text
38095 #: ../sys-utils/setpriv.1.adoc:70
38097 "Set the real, effective, or both UIDs. The _uid_ argument can be given as a "
38098 "textual login name."
38101 #. type: Plain text
38102 #: ../sys-utils/setpriv.1.adoc:72
38104 "Setting a _uid_ or _gid_ does not change capabilities, although the exec "
38105 "call at the end might change capabilities. This means that, if you are root, "
38106 "you probably want to do something like:"
38109 #. type: Plain text
38110 #: ../sys-utils/setpriv.1.adoc:74
38112 msgid "*setpriv --reuid=1000 --regid=1000 --inh-caps=-all*\n"
38115 #. type: Labeled list
38116 #: ../sys-utils/setpriv.1.adoc:75
38118 msgid "*--securebits* (**+**|*-*)__securebit__..."
38121 #. type: Plain text
38122 #: ../sys-utils/setpriv.1.adoc:77
38124 "Set or clear securebits. The argument is a comma-separated list. The valid "
38125 "securebits are _noroot_, _noroot_locked_, _no_setuid_fixup_, "
38126 "_no_setuid_fixup_locked_, and _keep_caps_locked_. _keep_caps_ is cleared by "
38127 "*execve*(2) and is therefore not allowed."
38130 #. type: Labeled list
38131 #: ../sys-utils/setpriv.1.adoc:78
38133 msgid "**--pdeathsig keep**|**clear**|*<signal>*"
38136 #. type: Plain text
38137 #: ../sys-utils/setpriv.1.adoc:80
38139 "Keep, clear or set the parent death signal. Some LSMs, most notably SELinux "
38140 "and AppArmor, clear the signal when the process' credentials change. Using "
38141 "*--pdeathsig keep* will restore the parent death signal after changing "
38142 "credentials to remedy that situation."
38145 #. type: Labeled list
38146 #: ../sys-utils/setpriv.1.adoc:81
38148 msgid "*--selinux-label* _label_"
38151 #. type: Plain text
38152 #: ../sys-utils/setpriv.1.adoc:83
38154 "Request a particular SELinux transition (using a transition on exec, not "
38155 "dyntrans). This will fail and cause *setpriv* to abort if SELinux is not in "
38156 "use, and the transition may be ignored or cause *execve*(2) to fail at "
38157 "SELinux's whim. (In particular, this is unlikely to work in conjunction with "
38158 "_no_new_privs_.) This is similar to *runcon*(1)."
38161 #. type: Labeled list
38162 #: ../sys-utils/setpriv.1.adoc:84
38164 msgid "*--apparmor-profile* _profile_"
38167 #. type: Plain text
38168 #: ../sys-utils/setpriv.1.adoc:86
38170 "Request a particular AppArmor profile (using a transition on exec). This "
38171 "will fail and cause *setpriv* to abort if AppArmor is not in use, and the "
38172 "transition may be ignored or cause *execve*(2) to fail at AppArmor's whim."
38175 #. type: Labeled list
38176 #: ../sys-utils/setpriv.1.adoc:87
38178 msgid "*--reset-env*"
38181 #. type: Plain text
38182 #: ../sys-utils/setpriv.1.adoc:89
38184 "Clears all the environment variables except *TERM*; initializes the "
38185 "environment variables *HOME*, *SHELL*, *USER*, *LOGNAME* according to the "
38186 "user's passwd entry; sets *PATH* to _/usr/local/bin:/bin:/usr/bin_ for a "
38187 "regular user and to _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/"
38188 "usr/bin_ for root."
38191 #. type: Plain text
38192 #: ../sys-utils/setpriv.1.adoc:91
38195 #| "The environment variable *PATH* may be different on systems where _/bin_ "
38196 #| "and _/sbin_ are merged into _/usr_; this variable is also affected by the "
38197 #| "*--login* command-line option and the PAM system setting (e.g., "
38198 #| "*pam_env*(8))."
38200 "The environment variable *PATH* may be different on systems where _/bin_ and "
38201 "_/sbin_ are merged into _/usr_. The environment variable *SHELL* defaults to "
38202 "*/bin/sh* if none is given in the user's passwd entry."
38204 "Proměnná prostředí *PATH* se může lišit na systémech, kde _/bin_ a _/sbin_ "
38205 "jsou začleněny do _/usr_. Tato proměnná je rovněž ovlivněna přepínačem "
38206 "příkazové řádky *--login* a nastavením systému PAM (např. *pam_env*(8))."
38208 #. type: Plain text
38209 #: ../sys-utils/setpriv.1.adoc:97
38211 "If applying any specified option fails, _program_ will not be run and "
38212 "*setpriv* will return with exit status 127."
38215 #. type: Plain text
38216 #: ../sys-utils/setpriv.1.adoc:99
38218 "Be careful with this tool -- it may have unexpected security consequences. "
38219 "For example, setting _no_new_privs_ and then execing a program that is "
38220 "SELinux-confined (as this tool would do) may prevent the SELinux "
38221 "restrictions from taking effect."
38224 #. type: Plain text
38225 #: ../sys-utils/setpriv.1.adoc:103
38227 "If you're looking for behavior similar to *su*(1)/*runuser*(1), or *sudo*(8) "
38228 "(without the *-g* option), try something like:"
38231 #. type: Plain text
38232 #: ../sys-utils/setpriv.1.adoc:105
38234 msgid "*setpriv --reuid=1000 --regid=1000 --init-groups*\n"
38237 #. type: Plain text
38238 #: ../sys-utils/setpriv.1.adoc:107
38239 msgid "If you want to mimic daemontools' *setuid*(8), try:"
38242 #. type: Plain text
38243 #: ../sys-utils/setpriv.1.adoc:109
38245 msgid "*setpriv --reuid=1000 --regid=1000 --clear-groups*\n"
38248 #. type: Plain text
38249 #: ../sys-utils/setpriv.1.adoc:113
38250 msgid "mailto:luto@amacapital.net[Andy Lutomirski]"
38253 #. type: Plain text
38254 #: ../sys-utils/setpriv.1.adoc:120
38260 "*capabilities*(7)\n"
38263 #. Rick Sladkey <jrs@world.std.com>
38264 #. In the public domain.
38266 #: ../sys-utils/setsid.1.adoc:4
38271 #. type: Plain text
38272 #: ../sys-utils/setsid.1.adoc:14
38273 msgid "setsid - run a program in a new session"
38276 #. type: Plain text
38277 #: ../sys-utils/setsid.1.adoc:18
38279 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
38280 msgid "*setsid* [options] _program_ [_arguments_]\n"
38281 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
38283 #. type: Plain text
38284 #: ../sys-utils/setsid.1.adoc:22
38286 msgid "*setsid* runs a program in a new session. The command calls *fork*(2) if already a process group leader. Otherwise, it executes a program in the current process. This default behavior is possible to override by the *--fork* option.\n"
38289 #. type: Labeled list
38290 #: ../sys-utils/setsid.1.adoc:25
38292 #| msgid "*-P*, *--pty*"
38293 msgid "*-c*, *--ctty*"
38294 msgstr "*-P*, *--pty*"
38296 #. type: Plain text
38297 #: ../sys-utils/setsid.1.adoc:27
38298 msgid "Set the controlling terminal to the current one."
38301 #. type: Labeled list
38302 #: ../sys-utils/setsid.1.adoc:28 ../sys-utils/unshare.1.adoc:81
38304 #| msgid "*-f*, *--fast*"
38305 msgid "*-f*, *--fork*"
38306 msgstr "*-f*, *--fast*"
38308 #. type: Plain text
38309 #: ../sys-utils/setsid.1.adoc:30
38310 msgid "Always create a new process."
38313 #. type: Labeled list
38314 #: ../sys-utils/setsid.1.adoc:31
38316 #| msgid "*-f*, *--fast*"
38317 msgid "*-w*, *--wait*"
38318 msgstr "*-f*, *--fast*"
38320 #. type: Plain text
38321 #: ../sys-utils/setsid.1.adoc:33
38323 "Wait for the execution of the program to end, and return the exit status of "
38324 "this program as the exit status of *setsid*."
38327 #. type: Plain text
38328 #: ../sys-utils/setsid.1.adoc:43
38329 msgid "mailto:jrs@world.std.com[Rick Sladkey]"
38332 #. type: Plain text
38333 #: ../sys-utils/setsid.1.adoc:47
38335 msgid "*setsid*(2)\n"
38339 #: ../sys-utils/swapon.8.adoc:2
38344 #. type: Plain text
38345 #: ../sys-utils/swapon.8.adoc:12
38347 "swapon, swapoff - enable/disable devices and files for paging and swapping"
38350 #. type: Plain text
38351 #: ../sys-utils/swapon.8.adoc:16
38353 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
38354 msgid "*swapon* [options] [_specialfile_...]\n"
38355 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
38357 #. type: Plain text
38358 #: ../sys-utils/swapon.8.adoc:18
38360 msgid "*swapoff* [*-va*] [_specialfile_...]\n"
38363 #. type: Plain text
38364 #: ../sys-utils/swapon.8.adoc:22
38366 msgid "*swapon* is used to specify devices on which paging and swapping are to take place.\n"
38369 #. type: Plain text
38370 #: ../sys-utils/swapon.8.adoc:24
38372 "The device or file used is given by the _specialfile_ parameter. It may be "
38373 "of the form *-L* _label_ or *-U* _uuid_ to indicate a device by label or "
38377 #. type: Plain text
38378 #: ../sys-utils/swapon.8.adoc:26
38380 "Calls to *swapon* normally occur in the system boot scripts making all swap "
38381 "devices available, so that the paging and swapping activity is interleaved "
38382 "across several devices and files."
38385 #. type: Plain text
38386 #: ../sys-utils/swapon.8.adoc:28
38388 msgid "*swapoff* disables swapping on the specified devices and files. When the *-a* flag is given, swapping is disabled on all known swap devices and files (as found in _/proc/swaps_ or _/etc/fstab_).\n"
38391 #. type: Plain text
38392 #: ../sys-utils/swapon.8.adoc:33
38394 "All devices marked as \"swap\" in _/etc/fstab_ are made available, except "
38395 "for those with the \"noauto\" option. Devices that are already being used as "
38396 "swap are silently skipped."
38399 #. type: Plain text
38400 #: ../sys-utils/swapon.8.adoc:36
38402 "Specifies an alternative fstab file for compatibility with *mount*(8). If "
38403 "_path_ is a directory, then the files in the directory are sorted by "
38404 "*strverscmp*(3); files that start with \".\" or without an .fstab extension "
38405 "are ignored. The option can be specified more than once. This option is "
38406 "mostly designed for initramfs or chroot scripts where additional "
38407 "configuration is specified beyond standard system configuration."
38410 #. type: Labeled list
38411 #: ../sys-utils/swapon.8.adoc:37
38413 msgid "*-d*, *--discard*[**=**__policy__]"
38416 #. type: Plain text
38417 #: ../sys-utils/swapon.8.adoc:39
38419 "Enable swap discards, if the swap backing device supports the discard or "
38420 "trim operation. This may improve performance on some Solid State Devices, "
38421 "but often it does not. The option allows one to select between two available "
38422 "swap discard policies:"
38425 #. type: Labeled list
38426 #: ../sys-utils/swapon.8.adoc:40
38428 msgid "*--discard=once*"
38431 #. type: Plain text
38432 #: ../sys-utils/swapon.8.adoc:42
38434 "to perform a single-time discard operation for the whole swap area at "
38438 #. type: Labeled list
38439 #: ../sys-utils/swapon.8.adoc:43
38441 msgid "*--discard=pages*"
38444 #. type: Plain text
38445 #: ../sys-utils/swapon.8.adoc:45
38447 "to asynchronously discard freed swap pages before they are available for "
38451 #. type: Plain text
38452 #: ../sys-utils/swapon.8.adoc:48
38454 "If no policy is selected, the default behavior is to enable both discard "
38455 "types. The _/etc/fstab_ mount options *discard*, *discard=once*, or "
38456 "*discard=pages* may also be used to enable discard flags."
38459 #. type: Labeled list
38460 #: ../sys-utils/swapon.8.adoc:49
38462 #| msgid "*-f*, *--fast*"
38463 msgid "*-e*, *--ifexists*"
38464 msgstr "*-f*, *--fast*"
38466 #. type: Plain text
38467 #: ../sys-utils/swapon.8.adoc:51
38469 "Silently skip devices that do not exist. The _/etc/fstab_ mount option "
38470 "*nofail* may also be used to skip non-existing device."
38473 #. type: Labeled list
38474 #: ../sys-utils/swapon.8.adoc:52
38476 #| msgid "*-f*, *--fast*"
38477 msgid "*-f*, *--fixpgsz*"
38478 msgstr "*-f*, *--fast*"
38480 #. type: Plain text
38481 #: ../sys-utils/swapon.8.adoc:54
38483 "Reinitialize (exec mkswap) the swap space if its page size does not match "
38484 "that of the current running kernel. *mkswap*(8) initializes the whole device "
38485 "and does not check for bad blocks."
38488 #. type: Labeled list
38489 #: ../sys-utils/swapon.8.adoc:55
38491 msgid "*-L* _label_"
38494 #. type: Plain text
38495 #: ../sys-utils/swapon.8.adoc:57
38497 "Use the partition that has the specified _label_. (For this, access to _/"
38498 "proc/partitions_ is needed.)"
38501 #. type: Plain text
38502 #: ../sys-utils/swapon.8.adoc:60
38504 "Specify swap options by an __fstab__-compatible comma-separated string. For "
38508 #. type: Plain text
38509 #: ../sys-utils/swapon.8.adoc:62
38511 msgid "*swapon -o pri=1,discard=pages,nofail /dev/sda2*\n"
38514 #. type: Plain text
38515 #: ../sys-utils/swapon.8.adoc:64
38517 "The _opts_ string is evaluated last and overrides all other command line "
38521 #. type: Plain text
38522 #: ../sys-utils/swapon.8.adoc:67
38524 "Specify the priority of the swap device. _priority_ is a value between 0 and "
38525 "32767. Higher numbers indicate higher priority. See *swapon*(2) for a full "
38526 "description of swap priorities. Add **pri=**__value__ to the option field of "
38527 "_/etc/fstab_ for use with *swapon -a*. When no priority is defined, Linux "
38528 "kernel defaults to negative numbers."
38531 #. type: Labeled list
38532 #: ../sys-utils/swapon.8.adoc:68
38534 #| msgid "*-P*, *--pty*"
38535 msgid "*-s*, *--summary*"
38536 msgstr "*-P*, *--pty*"
38538 #. type: Plain text
38539 #: ../sys-utils/swapon.8.adoc:70
38541 "Display swap usage summary by device. Equivalent to *cat /proc/swaps*. This "
38542 "output format is DEPRECATED in favour of *--show* that provides better "
38543 "control on output data."
38546 #. type: Labeled list
38547 #: ../sys-utils/swapon.8.adoc:71
38549 msgid "*--show*[**=**__column__...]"
38552 #. type: Plain text
38553 #: ../sys-utils/swapon.8.adoc:73
38555 "Display a definable table of swap areas. See the *--help* output for a list "
38556 "of available columns."
38559 #. type: Plain text
38560 #: ../sys-utils/swapon.8.adoc:79
38561 msgid "Do not print headings when displaying *--show* output."
38564 #. type: Plain text
38565 #: ../sys-utils/swapon.8.adoc:82
38566 msgid "Display *--show* output without aligning table columns."
38569 #. type: Labeled list
38570 #: ../sys-utils/swapon.8.adoc:83
38575 #. type: Plain text
38576 #: ../sys-utils/swapon.8.adoc:85
38578 "Display swap size in bytes in *--show* output instead of in user-friendly "
38582 #. type: Labeled list
38583 #: ../sys-utils/swapon.8.adoc:86
38585 msgid "*-U* _uuid_"
38588 #. type: Plain text
38589 #: ../sys-utils/swapon.8.adoc:88
38590 msgid "Use the partition that has the specified _uuid_."
38593 #. type: Plain text
38594 #: ../sys-utils/swapon.8.adoc:97
38596 msgid "*swapoff* has the following exit status values since v2.36:\n"
38599 #. type: Plain text
38600 #: ../sys-utils/swapon.8.adoc:103
38601 msgid "system has insufficient memory to stop swapping (OOM)"
38604 #. type: Plain text
38605 #: ../sys-utils/swapon.8.adoc:106
38607 msgid "*swapoff*(2) syscall failed for another reason\n"
38610 #. type: Plain text
38611 #: ../sys-utils/swapon.8.adoc:109
38612 msgid "non-*swapoff*(2) syscall system error (out of memory, ...)"
38615 #. type: Plain text
38616 #: ../sys-utils/swapon.8.adoc:112
38617 msgid "usage or syntax error"
38620 #. type: Plain text
38621 #: ../sys-utils/swapon.8.adoc:115
38622 msgid "all swapoff failed on *--all*"
38625 #. type: Plain text
38626 #: ../sys-utils/swapon.8.adoc:118
38627 msgid "some swapoff succeeded on *--all*"
38630 #. type: Plain text
38631 #: ../sys-utils/swapon.8.adoc:120
38633 "The command *swapoff --all* returns 0 (all succeeded), 32 (all failed), or "
38634 "64 (some failed, some succeeded)."
38637 #. type: Plain text
38638 #: ../sys-utils/swapon.8.adoc:122
38640 "The old versions before v2.36 has no documented exit status, 0 means success "
38644 #. type: Labeled list
38645 #: ../sys-utils/swapon.8.adoc:133
38647 msgid "_/dev/sd??_"
38650 #. type: Plain text
38651 #: ../sys-utils/swapon.8.adoc:135
38652 msgid "standard paging devices"
38655 #. type: Plain text
38656 #: ../sys-utils/swapon.8.adoc:138
38658 #| msgid "Basic filesystem-independent options are:"
38659 msgid "ascii filesystem description table"
38660 msgstr "Základní volby nezávislé na souborovém systému jsou:"
38663 #: ../sys-utils/swapon.8.adoc:141
38665 msgid "Files with holes"
38668 #. type: Plain text
38669 #: ../sys-utils/swapon.8.adoc:144
38671 "The swap file implementation in the kernel expects to be able to write to "
38672 "the file directly, without the assistance of the filesystem. This is a "
38673 "problem on files with holes or on copy-on-write files on filesystems like "
38677 #. type: Plain text
38678 #: ../sys-utils/swapon.8.adoc:146
38680 "Commands like *cp*(1) or *truncate*(1) create files with holes. These files "
38681 "will be rejected by *swapon*."
38684 #. type: Plain text
38685 #: ../sys-utils/swapon.8.adoc:148
38687 "Preallocated files created by *fallocate*(1) may be interpreted as files "
38688 "with holes too depending of the filesystem. Preallocated swap files are "
38689 "supported on XFS since Linux 4.18."
38692 #. type: Plain text
38693 #: ../sys-utils/swapon.8.adoc:150
38695 "The most portable solution to create a swap file is to use *dd*(1) and _/dev/"
38700 #: ../sys-utils/swapon.8.adoc:151
38705 #. type: Plain text
38706 #: ../sys-utils/swapon.8.adoc:154
38708 "Swap files on Btrfs are supported since Linux 5.0 on files with *nocow* "
38709 "attribute. See the *btrfs*(5) manual page for more details."
38713 #: ../sys-utils/swapon.8.adoc:155
38718 #. type: Plain text
38719 #: ../sys-utils/swapon.8.adoc:158
38720 msgid "Swap over *NFS* may not work."
38724 #: ../sys-utils/swapon.8.adoc:159
38729 #. type: Plain text
38730 #: ../sys-utils/swapon.8.adoc:162
38732 msgid "*swapon* automatically detects and rewrites a swap space signature with old software suspend data (e.g., *S1SUSPEND*, *S2SUSPEND*, ...). The problem is that if we don't do it, then we get data corruption the next time an attempt at unsuspending is made.\n"
38735 #. type: Plain text
38736 #: ../sys-utils/swapon.8.adoc:166
38738 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
38739 msgid "The *swapon* command appeared in 4.0BSD."
38740 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
38742 #. type: Plain text
38743 #: ../sys-utils/swapon.8.adoc:177
38750 "*fallocate*(1),\n"
38757 #: ../sys-utils/switch_root.8.adoc:2
38759 msgid "switch_root(8)"
38762 #. type: Plain text
38763 #: ../sys-utils/switch_root.8.adoc:12
38765 "switch_root - switch to another filesystem as the root of the mount tree"
38768 #. type: Plain text
38769 #: ../sys-utils/switch_root.8.adoc:16
38771 msgid "*switch_root* [*-hV*]\n"
38774 #. type: Plain text
38775 #: ../sys-utils/switch_root.8.adoc:18
38777 msgid "*switch_root* _newroot init_ [_arg_...]\n"
38780 #. type: Plain text
38781 #: ../sys-utils/switch_root.8.adoc:22
38783 msgid "*switch_root* moves already mounted _/proc_, _/dev_, _/sys_ and _/run_ to _newroot_ and makes _newroot_ the new root filesystem and starts _init_ process.\n"
38786 #. type: Plain text
38787 #: ../sys-utils/switch_root.8.adoc:24
38789 msgid "*WARNING: switch_root removes recursively all files and directories on the current root filesystem.*\n"
38792 #. type: Plain text
38793 #: ../sys-utils/switch_root.8.adoc:32
38795 msgid "*switch_root* returns 1 on failure, it never returns on success.\n"
38798 #. type: Plain text
38799 #: ../sys-utils/switch_root.8.adoc:36
38801 msgid "*switch_root* will fail to function if _newroot_ is not the root of a mount. If you want to switch root into a directory that does not meet this requirement then you can first use a bind-mounting trick to turn any directory into a mount point:\n"
38804 #. type: delimited block .
38805 #: ../sys-utils/switch_root.8.adoc:39
38807 msgid "mount --bind $DIR $DIR\n"
38810 #. type: Plain text
38811 #: ../sys-utils/switch_root.8.adoc:46
38813 "mailto:pjones@redhat.com[Peter Jones], mailto:katzj@redhat.com[Jeremy Katz], "
38814 "mailto:kzak@redhat.com[Karel Zak]"
38817 #. type: Plain text
38818 #: ../sys-utils/switch_root.8.adoc:53
38821 #| "*getmntent*(3),\n"
38823 #| "*findmnt*(8),\n"
38832 "*getmntent*(3),\n"
38839 #: ../sys-utils/tunelp.8.adoc:2
38844 #. type: Plain text
38845 #: ../sys-utils/tunelp.8.adoc:12
38846 msgid "tunelp - set various parameters for the lp device"
38849 #. type: Plain text
38850 #: ../sys-utils/tunelp.8.adoc:16
38852 msgid "*tunelp* [options] _device_\n"
38855 #. type: Plain text
38856 #: ../sys-utils/tunelp.8.adoc:20
38858 msgid "*tunelp* sets several parameters for the /dev/lp__?__ devices, for better performance (or for any performance at all, if your printer won't work without it...) Without parameters, it tells whether the device is using interrupts, and if so, which one. With parameters, it sets the device characteristics accordingly.\n"
38861 #. type: Labeled list
38862 #: ../sys-utils/tunelp.8.adoc:23
38864 msgid "*-i*, *--irq* _argument_"
38867 #. type: Plain text
38868 #: ../sys-utils/tunelp.8.adoc:25
38870 "specifies the IRQ to use for the parallel port in question. If this is set "
38871 "to something non-zero, *-t* and *-c* have no effect. If your port does not "
38872 "use interrupts, this option will make printing stop. The command *tunelp -i "
38873 "0* restores non-interrupt driven (polling) action, and your printer should "
38874 "work again. If your parallel port does support interrupts, interrupt-driven "
38875 "printing should be somewhat faster and efficient, and will probably be "
38879 #. type: Plain text
38880 #: ../sys-utils/tunelp.8.adoc:27
38882 msgid "*NOTE*: This option will have no effect with kernel 2.1.131 or later since the irq is handled by the parport driver. You can change the parport irq for example via _/proc/parport/*/irq_. Read _/usr/src/linux/Documentation/admin-guide/parport.rst_ for more details on parport.\n"
38885 #. type: Labeled list
38886 #: ../sys-utils/tunelp.8.adoc:28
38888 msgid "*-t*, *--time* _milliseconds_"
38891 #. type: Plain text
38892 #: ../sys-utils/tunelp.8.adoc:30
38894 "is the amount of time in jiffies that the driver waits if the printer "
38895 "doesn't take a character for the number of tries dictated by the *-c* "
38896 "parameter. 10 is the default value. If you want fastest possible printing, "
38897 "and don't care about system load, you may set this to 0. If you don't care "
38898 "how fast your printer goes, or are printing text on a slow printer with a "
38899 "buffer, then 500 (5 seconds) should be fine, and will give you very low "
38900 "system load. This value generally should be lower for printing graphics than "
38901 "text, by a factor of approximately 10, for best performance."
38904 #. type: Labeled list
38905 #: ../sys-utils/tunelp.8.adoc:31
38907 msgid "*-c*, *--chars* _characters_"
38910 #. type: Plain text
38911 #: ../sys-utils/tunelp.8.adoc:33
38913 "is the number of times to try to output a character to the printer before "
38914 "sleeping for *-t* _TIME_. It is the number of times around a loop that tries "
38915 "to send a character to the printer. 120 appears to be a good value for most "
38916 "printers in polling mode. 1000 is the default, because there are some "
38917 "printers that become jerky otherwise, but you _must_ set this to '1' to "
38918 "handle the maximal CPU efficiency if you are using interrupts. If you have a "
38919 "very fast printer, a value of 10 might make more sense even if in polling "
38920 "mode. If you have a _really_ old printer, you can increase this further."
38923 #. type: Plain text
38924 #: ../sys-utils/tunelp.8.adoc:35
38926 "Setting *-t* _TIME_ to 0 is equivalent to setting *-c* _CHARS_ to infinity."
38929 #. type: Labeled list
38930 #: ../sys-utils/tunelp.8.adoc:36
38932 msgid "*-w*, *--wait* _milliseconds_"
38935 #. type: Plain text
38936 #: ../sys-utils/tunelp.8.adoc:38
38938 "is the number of usec we wait while playing with the strobe signal. While "
38939 "most printers appear to be able to deal with an extremely short strobe, some "
38940 "printers demand a longer one. Increasing this from the default 1 may make it "
38941 "possible to print with those printers. This may also make it possible to use "
38942 "longer cables. It's also possible to decrease this value to 0 if your "
38943 "printer is fast enough or your machine is slow enough."
38946 #. type: Labeled list
38947 #: ../sys-utils/tunelp.8.adoc:39
38949 msgid "*-a*, *--abort* _<on|off>_"
38952 #. type: Plain text
38953 #: ../sys-utils/tunelp.8.adoc:41
38955 "This is whether to abort on printer error - the default is not to. If you "
38956 "are sitting at your computer, you probably want to be able to see an error "
38957 "and fix it, and have the printer go on printing. On the other hand, if you "
38958 "aren't, you might rather that your printer spooler find out that the printer "
38959 "isn't ready, quit trying, and send you mail about it. The choice is yours."
38962 #. type: Labeled list
38963 #: ../sys-utils/tunelp.8.adoc:42
38965 msgid "*-o*, *--check-status* _<on|off>_"
38968 #. type: Plain text
38969 #: ../sys-utils/tunelp.8.adoc:44
38971 "This option is much like *-a*. It makes any *open*(2) of this device check "
38972 "to see that the device is on-line and not reporting any out of paper or "
38973 "other errors. This is the correct setting for most versions of *lpd*."
38976 #. type: Labeled list
38977 #: ../sys-utils/tunelp.8.adoc:45
38979 msgid "*-C*, *--careful* _<on|off>_"
38982 #. type: Plain text
38983 #: ../sys-utils/tunelp.8.adoc:47
38985 "This option adds extra (\"careful\") error checking. When this option is on, "
38986 "the printer driver will ensure that the printer is on-line and not reporting "
38987 "any out of paper or other errors before sending data. This is particularly "
38988 "useful for printers that normally appear to accept data when turned off."
38991 #. type: Plain text
38992 #: ../sys-utils/tunelp.8.adoc:49
38994 msgid "*NOTE*: This option is obsolete because it's the default in 2.1.131 kernel or later.\n"
38997 #. type: Labeled list
38998 #: ../sys-utils/tunelp.8.adoc:50
39000 #| msgid "*-f*, *--fast*"
39001 msgid "*-s*, *--status*"
39002 msgstr "*-f*, *--fast*"
39004 #. type: Plain text
39005 #: ../sys-utils/tunelp.8.adoc:52
39007 "This option returns the current printer status, both as a decimal number "
39008 "from 0..255, and as a list of active flags. When this option is specified, *-"
39009 "q* off, turning off the display of the current IRQ, is implied."
39012 #. type: Plain text
39013 #: ../sys-utils/tunelp.8.adoc:55
39015 "This option resets the port. It requires a Linux kernel version of 1.1.80 or "
39019 #. type: Labeled list
39020 #: ../sys-utils/tunelp.8.adoc:56
39022 msgid "*-q*, *--print-irq* _<on|off>_"
39025 #. type: Plain text
39026 #: ../sys-utils/tunelp.8.adoc:58
39027 msgid "This option sets printing the display of the current IRQ setting."
39030 #. type: Plain text
39031 #: ../sys-utils/tunelp.8.adoc:63
39032 msgid "_/dev/lp?_, _/proc/parport/*/*_"
39035 #. type: Plain text
39036 #: ../sys-utils/tunelp.8.adoc:67
39038 msgid "*-o*, *-C*, and *-s* all require a Linux kernel version of 1.1.76 or later.\n"
39041 #. type: Plain text
39042 #: ../sys-utils/tunelp.8.adoc:69
39044 msgid "*-C* requires a Linux version prior to 2.1.131.\n"
39051 #. Copyright (c) 1996 Andries Brouwer
39052 #. This page is somewhat derived from a page that was
39053 #. (c) 1980, 1989, 1991 The Regents of the University of California
39054 #. and had been heavily modified by Rik Faith and myself.
39055 #. This is free documentation; you can redistribute it and/or
39056 #. modify it under the terms of the GNU General Public License as
39057 #. published by the Free Software Foundation; either version 2 of
39058 #. the License, or (at your option) any later version.
39059 #. The GNU General Public License's references to "object code"
39060 #. and "executables" are to be interpreted as the output of any
39061 #. document formatting or typesetting system, including
39062 #. intermediate and printed output.
39063 #. This manual is distributed in the hope that it will be useful,
39064 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
39065 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
39066 #. GNU General Public License for more details.
39067 #. You should have received a copy of the GNU General Public License along
39068 #. with this program; if not, write to the Free Software Foundation, Inc.,
39069 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
39071 #: ../sys-utils/umount.8.adoc:27
39076 #. type: Plain text
39077 #: ../sys-utils/umount.8.adoc:37
39078 msgid "umount - unmount filesystems"
39081 #. type: Plain text
39082 #: ../sys-utils/umount.8.adoc:41
39084 msgid "*umount* *-a* [*-dflnrv*] [*-t* _fstype_] [*-O* _option_...]\n"
39087 #. type: Plain text
39088 #: ../sys-utils/umount.8.adoc:43
39090 msgid "*umount* [*-dflnrv*] {_directory_|_device_}\n"
39093 #. type: Plain text
39094 #: ../sys-utils/umount.8.adoc:45
39096 msgid "*umount* *-h*|*-V*\n"
39099 #. type: Plain text
39100 #: ../sys-utils/umount.8.adoc:49
39102 "The *umount* command detaches the mentioned filesystem(s) from the file "
39103 "hierarchy. A filesystem is specified by giving the directory where it has "
39104 "been mounted. Giving the special device on which the filesystem lives may "
39105 "also work, but is obsolete, mainly because it will fail in case this device "
39106 "was mounted on more than one directory."
39109 #. type: Plain text
39110 #: ../sys-utils/umount.8.adoc:51
39112 "Note that a filesystem cannot be unmounted when it is 'busy' - for example, "
39113 "when there are open files on it, or when some process has its working "
39114 "directory there, or when a swap file on it is in use. The offending process "
39115 "could even be *umount* itself - it opens libc, and libc in its turn may open "
39116 "for example locale files. A lazy unmount avoids this problem, but it may "
39117 "introduce other issues. See *--lazy* description below."
39120 #. type: Plain text
39121 #: ../sys-utils/umount.8.adoc:56
39123 "All of the filesystems described in _/proc/self/mountinfo_ (or in deprecated "
39124 "_/etc/mtab_) are unmounted, except the proc, devfs, devpts, sysfs, "
39125 "rpc_pipefs and nfsd filesystems. This list of the filesystems may be "
39126 "replaced by *--types* umount option."
39129 #. type: Labeled list
39130 #: ../sys-utils/umount.8.adoc:57
39132 #| msgid "*-f*, *--fast*"
39133 msgid "*-A*, *--all-targets*"
39134 msgstr "*-f*, *--fast*"
39136 #. type: Plain text
39137 #: ../sys-utils/umount.8.adoc:59
39139 "Unmount all mountpoints in the current mount namespace for the specified "
39140 "filesystem. The filesystem can be specified by one of the mountpoints or the "
39141 "device name (or UUID, etc.). When this option is used together with *--"
39142 "recursive*, then all nested mounts within the filesystem are recursively "
39143 "unmounted. This option is only supported on systems where _/etc/mtab_ is a "
39144 "symlink to _/proc/mounts_."
39147 #. type: Plain text
39148 #: ../sys-utils/umount.8.adoc:62
39150 "Do not canonicalize paths. The paths canonicalization is based on *stat*(2) "
39151 "and *readlink*(2) system calls. These system calls may hang in some cases "
39152 "(for example on NFS if server is not available). The option has to be used "
39153 "with canonical path to the mount point."
39156 #. type: Plain text
39157 #: ../sys-utils/umount.8.adoc:64
39158 msgid "This option is silently ignored by *umount* for non-root users."
39161 #. type: Plain text
39162 #: ../sys-utils/umount.8.adoc:66
39164 "For more details about this option see the *mount*(8) man page. Note that "
39165 "*umount* does not pass this option to the **/sbin/umount.**__type__ helpers."
39168 #. type: Labeled list
39169 #: ../sys-utils/umount.8.adoc:67
39171 #| msgid "*-h*, *--help*"
39172 msgid "*-d*, *--detach-loop*"
39173 msgstr "*-h*, *--help*"
39175 #. type: Plain text
39176 #: ../sys-utils/umount.8.adoc:69
39178 "When the unmounted device was a loop device, also free this loop device. "
39179 "This option is unnecessary for devices initialized by *mount*(8), in this "
39180 "case \"autoclear\" functionality is enabled by default."
39183 #. type: Labeled list
39184 #: ../sys-utils/umount.8.adoc:70
39189 #. type: Plain text
39190 #: ../sys-utils/umount.8.adoc:72
39192 "Causes everything to be done except for the actual system call or umount "
39193 "helper execution; this 'fakes' unmounting the filesystem. It can be used to "
39194 "remove entries from the deprecated _/etc/mtab_ that were unmounted earlier "
39195 "with the *-n* option."
39198 #. type: Plain text
39199 #: ../sys-utils/umount.8.adoc:75
39200 msgid "Force an unmount (in case of an unreachable NFS system)."
39203 #. type: Plain text
39204 #: ../sys-utils/umount.8.adoc:77
39206 "Note that this option does not guarantee that umount command does not hang. "
39207 "It's strongly recommended to use absolute paths without symlinks to avoid "
39208 "unwanted *readlink*(2) and *stat*(2) system calls on unreachable NFS in "
39212 #. type: Labeled list
39213 #: ../sys-utils/umount.8.adoc:78
39215 #| msgid "*-V*, *--version*"
39216 msgid "*-i*, *--internal-only*"
39217 msgstr "*-V*, *--version*"
39219 #. type: Plain text
39220 #: ../sys-utils/umount.8.adoc:80
39222 "Do not call the **/sbin/umount.**__filesystem__ helper even if it exists. By "
39223 "default such a helper program is called if it exists."
39226 #. type: Labeled list
39227 #: ../sys-utils/umount.8.adoc:81
39229 #| msgid "*-P*, *--pty*"
39230 msgid "*-l*, *--lazy*"
39231 msgstr "*-P*, *--pty*"
39233 #. type: Plain text
39234 #: ../sys-utils/umount.8.adoc:83
39236 "Lazy unmount. Detach the filesystem from the file hierarchy now, and clean "
39237 "up all references to this filesystem as soon as it is not busy anymore."
39240 #. type: Plain text
39241 #: ../sys-utils/umount.8.adoc:85
39243 "A system reboot would be expected in near future if you're going to use this "
39244 "option for network filesystem or local filesystem with submounts. The "
39245 "recommended use-case for *umount -l* is to prevent hangs on shutdown due to "
39246 "an unreachable network share where a normal *umount* will hang due to a "
39247 "downed server or a network partition. Remounts of the share will not be "
39251 #. type: Plain text
39252 #: ../sys-utils/umount.8.adoc:88
39254 "Perform *umount* in the mount namespace specified by _ns_. _ns_ is either "
39255 "PID of process running in that namespace or special file representing that "
39259 #. type: Plain text
39260 #: ../sys-utils/umount.8.adoc:90
39262 msgid "*umount* switches to the namespace when it reads _/etc/fstab_, writes _/etc/mtab_ (or writes to _/run/mount_) and calls *umount*(2) system call, otherwise it runs in the original namespace. It means that the target mount namespace does not have to contain any libraries or other requirements necessary to execute *umount*(2) command.\n"
39265 #. type: Plain text
39266 #: ../sys-utils/umount.8.adoc:95
39267 msgid "Unmount without writing in _/etc/mtab_."
39270 #. type: Labeled list
39271 #: ../sys-utils/umount.8.adoc:96
39273 msgid "*-O*, *--test-opts* _option_..."
39276 #. type: Plain text
39277 #: ../sys-utils/umount.8.adoc:98
39279 "Unmount only the filesystems that have the specified option set in _/etc/"
39280 "fstab_. More than one option may be specified in a comma-separated list. "
39281 "Each option can be prefixed with *no* to indicate that no action should be "
39282 "taken for this option."
39285 #. type: Plain text
39286 #: ../sys-utils/umount.8.adoc:101
39287 msgid "Suppress \"not mounted\" error messages."
39290 #. type: Labeled list
39291 #: ../sys-utils/umount.8.adoc:102
39293 #| msgid "*-V*, *--version*"
39294 msgid "*-R*, *--recursive*"
39295 msgstr "*-V*, *--version*"
39297 #. type: Plain text
39298 #: ../sys-utils/umount.8.adoc:104
39300 "Recursively unmount each specified directory. Recursion for each directory "
39301 "will stop if any unmount operation in the chain fails for any reason. The "
39302 "relationship between mountpoints is determined by _/proc/self/mountinfo_ "
39303 "entries. The filesystem must be specified by mountpoint path; a recursive "
39304 "unmount by device name (or UUID) is unsupported. Since version 2.37 it "
39305 "umounts also all over-mounted filesystems (more filesystems on the same "
39309 #. type: Plain text
39310 #: ../sys-utils/umount.8.adoc:107
39311 msgid "When an unmount fails, try to remount the filesystem read-only."
39314 #. type: Labeled list
39315 #: ../sys-utils/umount.8.adoc:108
39317 msgid "*-t*, *--types* _type_..."
39320 #. type: Plain text
39321 #: ../sys-utils/umount.8.adoc:110
39323 "Indicate that the actions should only be taken on filesystems of the "
39324 "specified _type_. More than one type may be specified in a comma-separated "
39325 "list. The list of filesystem types can be prefixed with *no* to indicate "
39326 "that no action should be taken for all of the mentioned types. Note that "
39327 "*umount* reads information about mounted filesystems from kernel (_/proc/"
39328 "mounts_) and filesystem names may be different than filesystem names used in "
39329 "the _/etc/fstab_ (e.g., \"nfs4\" vs. \"nfs\")."
39333 #: ../sys-utils/umount.8.adoc:116
39335 msgid "NON-SUPERUSER UMOUNTS"
39338 #. type: Plain text
39339 #: ../sys-utils/umount.8.adoc:119
39341 "Normally, only the superuser can umount filesystems. However, when _fstab_ "
39342 "contains the *user* option on a line, anybody can umount the corresponding "
39343 "filesystem. For more details see *mount*(8) man page."
39346 #. type: Plain text
39347 #: ../sys-utils/umount.8.adoc:121
39349 "Since version 2.34 the *umount* command can be used to perform umount "
39350 "operation also for fuse filesystems if kernel mount table contains user's "
39351 "ID. In this case _fstab_ *user=* mount option is not required."
39354 #. type: Plain text
39355 #: ../sys-utils/umount.8.adoc:123
39357 "Since version 2.35 *umount* command does not exit when user permissions are "
39358 "inadequate by internal *libmount* security rules. It drops suid permissions "
39359 "and continue as regular non-root user. This can be used to support use-cases "
39360 "where root permissions are not necessary (e.g., fuse filesystems, user "
39361 "namespaces, etc)."
39365 #: ../sys-utils/umount.8.adoc:124
39367 msgid "LOOP DEVICE"
39370 #. type: Plain text
39371 #: ../sys-utils/umount.8.adoc:127
39373 "The *umount* command will automatically detach loop device previously "
39374 "initialized by *mount*(8) command independently of _/etc/mtab_."
39377 #. type: Plain text
39378 #: ../sys-utils/umount.8.adoc:129
39380 "In this case the device is initialized with \"autoclear\" flag (see "
39381 "*losetup*(8) output for more details), otherwise it's necessary to use the "
39382 "option *--detach-loop* or call *losetup -d* _device_. The autoclear feature "
39383 "is supported since Linux 2.6.25."
39386 #. type: Plain text
39387 #: ../sys-utils/umount.8.adoc:133
39388 msgid "The syntax of external unmount helpers is:"
39391 #. type: delimited block _
39392 #: ../sys-utils/umount.8.adoc:136
39394 msgid "**umount.**__suffix__ {__directory__|_device_} [*-flnrv*] [*-N* _namespace_] [*-t* _type_._subtype_]\n"
39397 #. type: Plain text
39398 #: ../sys-utils/umount.8.adoc:139
39400 "where _suffix_ is the filesystem type (or the value from a *uhelper=* or "
39401 "*helper=* marker in the mtab file). The *-t* option can be used for "
39402 "filesystems that have subtype support. For example:"
39405 #. type: delimited block _
39406 #: ../sys-utils/umount.8.adoc:142
39408 msgid "*umount.fuse -t fuse.sshfs*\n"
39411 #. type: Plain text
39412 #: ../sys-utils/umount.8.adoc:145
39414 "A **uhelper=**__something__ marker (unprivileged helper) can appear in the _/"
39415 "etc/mtab_ file when ordinary users need to be able to unmount a mountpoint "
39416 "that is not defined in _/etc/fstab_ (for example for a device that was "
39417 "mounted by *udisks*(1))."
39420 #. type: Plain text
39421 #: ../sys-utils/umount.8.adoc:147
39423 "A **helper=**__type__ marker in the _mtab_ file will redirect all unmount "
39424 "requests to the **/sbin/umount.**__type__ helper independently of UID."
39427 #. type: Plain text
39428 #: ../sys-utils/umount.8.adoc:149
39430 "Note that _/etc/mtab_ is currently deprecated and *helper=* and other "
39431 "userspace mount options are maintained by *libmount*."
39434 #. type: Plain text
39435 #: ../sys-utils/umount.8.adoc:154
39436 msgid "overrides the default location of the _fstab_ file (ignored for *suid*)"
39439 #. type: Plain text
39440 #: ../sys-utils/umount.8.adoc:157
39441 msgid "enables *libmount* debug output"
39444 #. type: Plain text
39445 #: ../sys-utils/umount.8.adoc:162
39447 "table of mounted filesystems (deprecated and usually replaced by symlink to "
39451 #. type: Plain text
39452 #: ../sys-utils/umount.8.adoc:165
39453 msgid "table of known filesystems"
39456 #. type: Labeled list
39457 #: ../sys-utils/umount.8.adoc:166
39459 msgid "_/proc/self/mountinfo_"
39462 #. type: Plain text
39463 #: ../sys-utils/umount.8.adoc:168
39464 msgid "table of mounted filesystems generated by kernel."
39467 #. type: Plain text
39468 #: ../sys-utils/umount.8.adoc:172
39470 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
39471 msgid "A *umount* command appeared in Version 6 AT&T UNIX."
39472 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
39474 #. type: Plain text
39475 #: ../sys-utils/umount.8.adoc:179
39480 "*mount_namespaces*(7),\n"
39485 #: ../sys-utils/unshare.1.adoc:2
39490 #. type: Plain text
39491 #: ../sys-utils/unshare.1.adoc:12
39492 msgid "unshare - run program in new namespaces"
39495 #. type: Plain text
39496 #: ../sys-utils/unshare.1.adoc:16
39498 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
39499 msgid "*unshare* [options] [_program_ [_arguments_]]\n"
39500 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
39502 #. type: Plain text
39503 #: ../sys-utils/unshare.1.adoc:20
39505 "The *unshare* command creates new namespaces (as specified by the command-"
39506 "line options described below) and then executes the specified _program_. If "
39507 "_program_ is not given, then \"${SHELL}\" is run (default: _/bin/sh_)."
39510 #. type: Plain text
39511 #: ../sys-utils/unshare.1.adoc:22
39513 "By default, a new namespace persists only as long as it has member "
39514 "processes. A new namespace can be made persistent even when it has no member "
39515 "processes by bind mounting /proc/_pid_/ns/_type_ files to a filesystem path. "
39516 "A namespace that has been made persistent in this way can subsequently be "
39517 "entered with *nsenter*(1) even after the _program_ terminates (except PID "
39518 "namespaces where a permanently running init process is required). Once a "
39519 "persistent namespace is no longer needed, it can be unpersisted by using "
39520 "*umount*(8) to remove the bind mount. See the *EXAMPLES* section for more "
39524 #. type: Plain text
39525 #: ../sys-utils/unshare.1.adoc:24
39527 msgid "*unshare* since util-linux version 2.36 uses _/proc/[pid]/ns/pid_for_children_ and _/proc/[pid]/ns/time_for_children_ files for persistent PID and TIME namespaces. This change requires Linux kernel 4.17 or newer.\n"
39530 #. type: Plain text
39531 #: ../sys-utils/unshare.1.adoc:26
39532 msgid "The following types of namespaces can be created with *unshare*:"
39535 #. type: Plain text
39536 #: ../sys-utils/unshare.1.adoc:29
39538 "Mounting and unmounting filesystems will not affect the rest of the system, "
39539 "except for filesystems which are explicitly marked as shared (with *mount --"
39540 "make-shared*; see _/proc/self/mountinfo_ or *findmnt -o+PROPAGATION* for the "
39541 "*shared* flags). For further details, see *mount_namespaces*(7)."
39544 #. type: Plain text
39545 #: ../sys-utils/unshare.1.adoc:31
39547 msgid "*unshare* since util-linux version 2.27 automatically sets propagation to *private* in a new mount namespace to make sure that the new namespace is really unshared. It's possible to disable this feature with option *--propagation unchanged*. Note that *private* is the kernel default.\n"
39550 #. type: Plain text
39551 #: ../sys-utils/unshare.1.adoc:43
39553 "Children will have a distinct set of PID-to-process mappings from their "
39554 "parent. For further details, see *pid_namespaces*(7)."
39557 #. type: Labeled list
39558 #: ../sys-utils/unshare.1.adoc:55
39560 msgid "*-i*, *--ipc*[**=**__file__]"
39563 #. type: Plain text
39564 #: ../sys-utils/unshare.1.adoc:57
39566 "Create a new IPC namespace. If _file_ is specified, then the namespace is "
39567 "made persistent by creating a bind mount at _file_."
39570 #. type: Labeled list
39571 #: ../sys-utils/unshare.1.adoc:58
39573 msgid "*-m*, *--mount*[**=**__file__]"
39576 #. type: Plain text
39577 #: ../sys-utils/unshare.1.adoc:60
39579 "Create a new mount namespace. If _file_ is specified, then the namespace is "
39580 "made persistent by creating a bind mount at _file_. Note that _file_ must be "
39581 "located on a mount whose propagation type is not *shared* (or an error "
39582 "results). Use the command *findmnt -o+PROPAGATION* when not sure about the "
39583 "current setting. See also the examples below."
39586 #. type: Labeled list
39587 #: ../sys-utils/unshare.1.adoc:61
39589 #| msgid "*-s*, **--shell**=__shell__"
39590 msgid "*-n*, *--net*[**=**__file__]"
39591 msgstr "*-s*, **--shell**=__shell__"
39593 #. type: Plain text
39594 #: ../sys-utils/unshare.1.adoc:63
39596 "Create a new network namespace. If _file_ is specified, then the namespace "
39597 "is made persistent by creating a bind mount at _file_."
39600 #. type: Labeled list
39601 #: ../sys-utils/unshare.1.adoc:64
39603 msgid "*-p*, *--pid*[**=**__file__]"
39606 #. type: Plain text
39607 #: ../sys-utils/unshare.1.adoc:66
39609 "Create a new PID namespace. If _file_ is specified, then the namespace is "
39610 "made persistent by creating a bind mount at _file_. (Creation of a "
39611 "persistent PID namespace will fail if the *--fork* option is not also "
39615 #. type: Plain text
39616 #: ../sys-utils/unshare.1.adoc:68
39617 msgid "See also the *--fork* and *--mount-proc* options."
39620 #. type: Labeled list
39621 #: ../sys-utils/unshare.1.adoc:69
39623 #| msgid "*-s*, **--shell**=__shell__"
39624 msgid "*-u*, *--uts*[**=**__file__]"
39625 msgstr "*-s*, **--shell**=__shell__"
39627 #. type: Plain text
39628 #: ../sys-utils/unshare.1.adoc:71
39630 "Create a new UTS namespace. If _file_ is specified, then the namespace is "
39631 "made persistent by creating a bind mount at _file_."
39634 #. type: Labeled list
39635 #: ../sys-utils/unshare.1.adoc:72
39637 #| msgid "*-s*, **--shell**=__shell__"
39638 msgid "*-U*, *--user*[**=**__file__]"
39639 msgstr "*-s*, **--shell**=__shell__"
39641 #. type: Plain text
39642 #: ../sys-utils/unshare.1.adoc:74
39644 "Create a new user namespace. If _file_ is specified, then the namespace is "
39645 "made persistent by creating a bind mount at _file_."
39648 #. type: Labeled list
39649 #: ../sys-utils/unshare.1.adoc:75
39651 #| msgid "*-g*, **--group**=__group__"
39652 msgid "*-C*, *--cgroup*[**=**__file__]"
39653 msgstr "*-g*, **--group**=__skupina__"
39655 #. type: Plain text
39656 #: ../sys-utils/unshare.1.adoc:77
39658 "Create a new cgroup namespace. If _file_ is specified, then the namespace is "
39659 "made persistent by creating a bind mount at _file_."
39662 #. type: Labeled list
39663 #: ../sys-utils/unshare.1.adoc:78
39665 #| msgid "*-s*, **--shell**=__shell__"
39666 msgid "*-T*, *--time*[**=**__file__]"
39667 msgstr "*-s*, **--shell**=__shell__"
39669 #. type: Plain text
39670 #: ../sys-utils/unshare.1.adoc:80
39672 "Create a new time namespace. If _file_ is specified, then the namespace is "
39673 "made persistent by creating a bind mount at _file_. The *--monotonic* and *--"
39674 "boottime* options can be used to specify the corresponding offset in the "
39678 #. type: Plain text
39679 #: ../sys-utils/unshare.1.adoc:83
39681 "Fork the specified _program_ as a child process of *unshare* rather than "
39682 "running it directly. This is useful when creating a new PID namespace. Note "
39683 "that when *unshare* is waiting for the child process, then it ignores "
39684 "*SIGINT* and *SIGTERM* and does not forward any signals to the child. It is "
39685 "necessary to send signals to the child process."
39688 #. type: Labeled list
39689 #: ../sys-utils/unshare.1.adoc:87
39691 msgid "*--kill-child*[**=**__signame__]"
39694 #. type: Plain text
39695 #: ../sys-utils/unshare.1.adoc:89
39697 "When *unshare* terminates, have _signame_ be sent to the forked child "
39698 "process. Combined with *--pid* this allows for an easy and reliable killing "
39699 "of the entire process tree below *unshare*. If not given, _signame_ defaults "
39700 "to *SIGKILL*. This option implies *--fork*."
39703 #. type: Labeled list
39704 #: ../sys-utils/unshare.1.adoc:90
39706 msgid "*--mount-proc*[**=**__mountpoint__]"
39709 #. type: Plain text
39710 #: ../sys-utils/unshare.1.adoc:92
39712 "Just before running the program, mount the proc filesystem at _mountpoint_ "
39713 "(default is _/proc_). This is useful when creating a new PID namespace. It "
39714 "also implies creating a new mount namespace since the _/proc_ mount would "
39715 "otherwise mess up existing programs on the system. The new proc filesystem "
39716 "is explicitly mounted as private (with *MS_PRIVATE*|*MS_REC*)."
39719 #. type: Labeled list
39720 #: ../sys-utils/unshare.1.adoc:93
39722 msgid "**--map-user=**__uid|name__"
39725 #. type: Plain text
39726 #: ../sys-utils/unshare.1.adoc:95
39728 "Run the program only after the current effective user ID has been mapped to "
39729 "_uid_. If this option is specified multiple times, the last occurrence takes "
39730 "precedence. This option implies *--user*."
39733 #. type: Labeled list
39734 #: ../sys-utils/unshare.1.adoc:96
39736 msgid "**--map-users=**__inneruid:outeruid:count__|**auto**"
39739 #. type: Plain text
39740 #: ../sys-utils/unshare.1.adoc:98
39742 "Run the program only after the block of user IDs of size _count_ beginning "
39743 "at _outeruid_ has been mapped to the block of user IDs beginning at "
39744 "_inneruid_. This mapping is created with **newuidmap**(1). If the range of "
39745 "user IDs overlaps with the mapping specified by *--map-user*, then a "
39746 "\"hole\" will be removed from the mapping. This may result in the highest "
39747 "user ID of the mapping not being mapped. The special value *auto* will map "
39748 "the first block of user IDs owned by the effective user from _/etc/subuid_ "
39749 "to a block starting at user ID 0. If this option is specified multiple "
39750 "times, the last occurrence takes precedence. This option implies *--user*."
39753 #. type: Plain text
39754 #: ../sys-utils/unshare.1.adoc:100
39756 "Before util-linux version 2.39, this option expected a comma-separated "
39757 "argument of the form _outeruid,inneruid,count_ but that format is now "
39758 "deprecated for consistency with the ordering used in _/proc/[pid]/uid_map_ "
39759 "and the _X-mount.idmap_ mount option."
39762 #. type: Labeled list
39763 #: ../sys-utils/unshare.1.adoc:101
39765 #| msgid "*-G*, **--supp-group**=__group__"
39766 msgid "**--map-group=**__gid|name__"
39767 msgstr "*-G*, **--supp-group**=__skupina__"
39769 #. type: Plain text
39770 #: ../sys-utils/unshare.1.adoc:103
39772 "Run the program only after the current effective group ID has been mapped to "
39773 "_gid_. If this option is specified multiple times, the last occurrence takes "
39774 "precedence. This option implies *--setgroups=deny* and *--user*."
39777 #. type: Labeled list
39778 #: ../sys-utils/unshare.1.adoc:104
39780 msgid "**--map-groups=**__innergid:outergid:count__|**auto**"
39783 #. type: Plain text
39784 #: ../sys-utils/unshare.1.adoc:106
39786 "Run the program only after the block of group IDs of size _count_ beginning "
39787 "at _outergid_ has been mapped to the block of group IDs beginning at "
39788 "_innergid_. This mapping is created with **newgidmap**(1). If the range of "
39789 "group IDs overlaps with the mapping specified by *--map-group*, then a "
39790 "\"hole\" will be removed from the mapping. This may result in the highest "
39791 "group ID of the mapping not being mapped. The special value *auto* will map "
39792 "the first block of user IDs owned by the effective user from _/etc/subgid_ "
39793 "to a block starting at group ID 0. If this option is specified multiple "
39794 "times, the last occurrence takes precedence. This option implies *--user*."
39797 #. type: Plain text
39798 #: ../sys-utils/unshare.1.adoc:108
39800 "Before util-linux version 2.39, this option expected a comma-separated "
39801 "argument of the form _outergid,innergid,count_ but that format is now "
39802 "deprecated for consistency with the ordering used in _/proc/[pid]/gid_map_ "
39803 "and the _X-mount.idmap_ mount option."
39806 #. type: Labeled list
39807 #: ../sys-utils/unshare.1.adoc:109
39809 msgid "**--map-auto**"
39812 #. type: Plain text
39813 #: ../sys-utils/unshare.1.adoc:111
39815 "Map the first block of user IDs owned by the effective user from _/etc/"
39816 "subuid_ to a block starting at user ID 0. In the same manner, also map the "
39817 "first block of group IDs owned by the effective group from _/etc/subgid_ to "
39818 "a block starting at group ID 0. This option is intended to handle the common "
39819 "case where the first block of subordinate user and group IDs can map the "
39820 "whole user and group ID space. This option is equivalent to specifying *--"
39821 "map-users=auto* and *--map-groups=auto*."
39824 #. type: Labeled list
39825 #: ../sys-utils/unshare.1.adoc:112
39827 #| msgid "*-P*, *--pty*"
39828 msgid "*-r*, *--map-root-user*"
39829 msgstr "*-P*, *--pty*"
39831 #. type: Plain text
39832 #: ../sys-utils/unshare.1.adoc:114
39834 "Run the program only after the current effective user and group IDs have "
39835 "been mapped to the superuser UID and GID in the newly created user "
39836 "namespace. This makes it possible to conveniently gain capabilities needed "
39837 "to manage various aspects of the newly created namespaces (such as "
39838 "configuring interfaces in the network namespace or mounting filesystems in "
39839 "the mount namespace) even when run unprivileged. As a mere convenience "
39840 "feature, it does not support more sophisticated use cases, such as mapping "
39841 "multiple ranges of UIDs and GIDs. This option implies *--setgroups=deny* and "
39842 "*--user*. This option is equivalent to *--map-user=0 --map-group=0*."
39845 #. type: Labeled list
39846 #: ../sys-utils/unshare.1.adoc:115
39848 msgid "*-c*, *--map-current-user*"
39851 #. type: Plain text
39852 #: ../sys-utils/unshare.1.adoc:117
39854 "Run the program only after the current effective user and group IDs have "
39855 "been mapped to the same UID and GID in the newly created user namespace. "
39856 "This option implies *--setgroups=deny* and *--user*. This option is "
39857 "equivalent to *--map-user=$(id -ru) --map-group=$(id -rg)*."
39860 #. type: Labeled list
39861 #: ../sys-utils/unshare.1.adoc:118
39863 msgid "**--propagation private**|**shared**|**slave**|*unchanged*"
39866 #. type: Plain text
39867 #: ../sys-utils/unshare.1.adoc:120
39869 "Recursively set the mount propagation flag in the new mount namespace. The "
39870 "default is to set the propagation to _private_. It is possible to disable "
39871 "this feature with the argument *unchanged*. The option is silently ignored "
39872 "when the mount namespace (*--mount*) is not requested."
39875 #. type: Labeled list
39876 #: ../sys-utils/unshare.1.adoc:121
39878 msgid "**--setgroups allow**|*deny*"
39881 #. type: Plain text
39882 #: ../sys-utils/unshare.1.adoc:123
39883 msgid "Allow or deny the *setgroups*(2) system call in a user namespace."
39886 #. type: Plain text
39887 #: ../sys-utils/unshare.1.adoc:125
39889 "To be able to call *setgroups*(2), the calling process must at least have "
39890 "*CAP_SETGID*. But since Linux 3.19 a further restriction applies: the kernel "
39891 "gives permission to call *setgroups*(2) only after the GID map (**/proc/"
39892 "**__pid__*/gid_map*) has been set. The GID map is writable by root when "
39893 "*setgroups*(2) is enabled (i.e., *allow*, the default), and the GID map "
39894 "becomes writable by unprivileged processes when *setgroups*(2) is "
39895 "permanently disabled (with *deny*)."
39898 #. type: Labeled list
39899 #: ../sys-utils/unshare.1.adoc:126
39901 #| msgid "*-g*, **--group**=__group__"
39902 msgid "*-R*, **--root=**__dir__"
39903 msgstr "*-g*, **--group**=__skupina__"
39905 #. type: Plain text
39906 #: ../sys-utils/unshare.1.adoc:128
39907 msgid "run the command with root directory set to _dir_."
39910 #. type: Labeled list
39911 #: ../sys-utils/unshare.1.adoc:129
39913 #| msgid "*-g*, **--group**=__group__"
39914 msgid "*-w*, **--wd=**__dir__"
39915 msgstr "*-g*, **--group**=__skupina__"
39917 #. type: Plain text
39918 #: ../sys-utils/unshare.1.adoc:131
39919 msgid "change working directory to _dir_."
39922 #. type: Plain text
39923 #: ../sys-utils/unshare.1.adoc:134
39924 msgid "Set the user ID which will be used in the entered namespace."
39927 #. type: Plain text
39928 #: ../sys-utils/unshare.1.adoc:137
39930 "Set the group ID which will be used in the entered namespace and drop "
39931 "supplementary groups."
39934 #. type: Labeled list
39935 #: ../sys-utils/unshare.1.adoc:138
39937 msgid "*--monotonic* _offset_"
39940 #. type: Plain text
39941 #: ../sys-utils/unshare.1.adoc:140
39943 "Set the offset of *CLOCK_MONOTONIC* which will be used in the entered time "
39944 "namespace. This option requires unsharing a time namespace with *--time*."
39947 #. type: Labeled list
39948 #: ../sys-utils/unshare.1.adoc:141
39950 msgid "*--boottime* _offset_"
39953 #. type: Plain text
39954 #: ../sys-utils/unshare.1.adoc:143
39956 "Set the offset of *CLOCK_BOOTTIME* which will be used in the entered time "
39957 "namespace. This option requires unsharing a time namespace with *--time*."
39960 #. type: Plain text
39961 #: ../sys-utils/unshare.1.adoc:149
39963 "The proc and sysfs filesystems mounting as root in a user namespace have to "
39964 "be restricted so that a less privileged user cannot get more access to "
39965 "sensitive files that a more privileged user made unavailable. In short the "
39966 "rule for proc and sysfs is as close to a bind mount as possible."
39969 #. type: Plain text
39970 #: ../sys-utils/unshare.1.adoc:153
39972 "The following command creates a PID namespace, using *--fork* to ensure that "
39973 "the executed command is performed in a child process that (being the first "
39974 "process in the namespace) has PID 1. The *--mount-proc* option ensures that "
39975 "a new mount namespace is also simultaneously created and that a new "
39976 "*proc*(5) filesystem is mounted that contains information corresponding to "
39977 "the new PID namespace. When the *readlink*(1) command terminates, the new "
39978 "namespaces are automatically torn down."
39981 #. type: delimited block .
39982 #: ../sys-utils/unshare.1.adoc:157
39985 "# unshare --fork --pid --mount-proc readlink /proc/self\n"
39989 #. type: Plain text
39990 #: ../sys-utils/unshare.1.adoc:160
39992 "As an unprivileged user, create a new user namespace where the user's "
39993 "credentials are mapped to the root IDs inside the namespace:"
39996 #. type: delimited block .
39997 #: ../sys-utils/unshare.1.adoc:170
40003 "$ unshare --user --map-root-user \\\n"
40004 " sh -c 'whoami; cat /proc/self/uid_map /proc/self/gid_map'\n"
40010 #. type: Plain text
40011 #: ../sys-utils/unshare.1.adoc:173
40013 "As an unprivileged user, create a user namespace where the first 65536 IDs "
40014 "are all mapped, and the user's credentials are mapped to the root IDs inside "
40015 "the namespace. The map is determined by the subordinate IDs assigned in "
40016 "*subuid*(5) and *subgid*(5). Demonstrate this mapping by creating a file "
40017 "with user ID 1 and group ID 1. For brevity, only the user ID mappings are "
40021 #. type: delimited block .
40022 #: ../sys-utils/unshare.1.adoc:191
40027 "$ cat /etc/subuid\n"
40028 "1000:100000:65536\n"
40029 "$ unshare --user --map-auto --map-root-user\n"
40032 "# cat /proc/self/uid_map\n"
40034 " 1 100000 65535\n"
40035 "# touch file; chown 1:1 file\n"
40036 "# ls -ln --time-style=+ file\n"
40037 "-rw-r--r-- 1 1 1 0 file\n"
40039 "$ ls -ln --time-style=+ file\n"
40040 "-rw-r--r-- 1 100000 100000 0 file\n"
40043 #. type: Plain text
40044 #: ../sys-utils/unshare.1.adoc:194
40046 "The first of the following commands creates a new persistent UTS namespace "
40047 "and modifies the hostname as seen in that namespace. The namespace is then "
40048 "entered with *nsenter*(1) in order to display the modified hostname; this "
40049 "step demonstrates that the UTS namespace continues to exist even though the "
40050 "namespace had no member processes after the *unshare* command terminated. "
40051 "The namespace is then destroyed by removing the bind mount."
40054 #. type: delimited block .
40055 #: ../sys-utils/unshare.1.adoc:201
40058 "# touch /root/uts-ns\n"
40059 "# unshare --uts=/root/uts-ns hostname FOO\n"
40060 "# nsenter --uts=/root/uts-ns hostname\n"
40062 "# umount /root/uts-ns\n"
40065 #. type: Plain text
40066 #: ../sys-utils/unshare.1.adoc:204
40068 "The following commands establish a persistent mount namespace referenced by "
40069 "the bind mount _/root/namespaces/mnt_. In order to ensure that the creation "
40070 "of that bind mount succeeds, the parent directory (_/root/namespaces_) is "
40071 "made a bind mount whose propagation type is not *shared*."
40074 #. type: delimited block .
40075 #: ../sys-utils/unshare.1.adoc:210
40078 "# mount --bind /root/namespaces /root/namespaces\n"
40079 "# mount --make-private /root/namespaces\n"
40080 "# touch /root/namespaces/mnt\n"
40081 "# unshare --mount=/root/namespaces/mnt\n"
40084 #. type: Plain text
40085 #: ../sys-utils/unshare.1.adoc:213
40087 "The following commands demonstrate the use of the *--kill-child* option when "
40088 "creating a PID namespace, in order to ensure that when *unshare* is killed, "
40089 "all of the processes within the PID namespace are killed."
40092 #. type: delimited block .
40093 #: ../sys-utils/unshare.1.adoc:216
40095 msgid "# set +m # Don't print job status messages\n"
40098 #. type: delimited block .
40099 #: ../sys-utils/unshare.1.adoc:224
40102 "# unshare --pid --fork --mount-proc --kill-child -- \\\n"
40103 " bash --norc -c '(sleep 555 &) && (ps a &) && sleep 999' &\n"
40105 "# PID TTY STAT TIME COMMAND\n"
40106 " 1 pts/3 S+ 0:00 sleep 999\n"
40107 " 3 pts/3 S+ 0:00 sleep 555\n"
40108 " 5 pts/3 R+ 0:00 ps a\n"
40111 #. type: delimited block .
40112 #: ../sys-utils/unshare.1.adoc:229
40115 "# ps h -o 'comm' $! # Show that background job is unshare(1)\n"
40117 "# kill $! # Kill unshare(1)\n"
40121 #. type: Plain text
40122 #: ../sys-utils/unshare.1.adoc:232
40124 "The *pidof*(1) command prints no output, because the *sleep* processes have "
40125 "been killed. More precisely, when the *sleep* process that has PID 1 in the "
40126 "namespace (i.e., the namespace's init process) was killed, this caused all "
40127 "other processes in the namespace to be killed. By contrast, a similar series "
40128 "of commands where the *--kill-child* option is not used shows that when "
40129 "*unshare* terminates, the processes in the PID namespace are not killed:"
40132 #. type: delimited block .
40133 #: ../sys-utils/unshare.1.adoc:241
40136 "# unshare --pid --fork --mount-proc -- \\\n"
40137 " bash --norc -c '(sleep 555 &) && (ps a &) && sleep 999' &\n"
40139 "# PID TTY STAT TIME COMMAND\n"
40140 " 1 pts/3 S+ 0:00 sleep 999\n"
40141 " 3 pts/3 S+ 0:00 sleep 555\n"
40142 " 5 pts/3 R+ 0:00 ps a\n"
40145 #. type: delimited block .
40146 #: ../sys-utils/unshare.1.adoc:245
40154 #. type: Plain text
40155 #: ../sys-utils/unshare.1.adoc:248
40157 "The following example demonstrates the creation of a time namespace where "
40158 "the boottime clock is set to a point several years in the past:"
40161 #. type: delimited block .
40162 #: ../sys-utils/unshare.1.adoc:254
40165 "# uptime -p # Show uptime in initial time namespace\n"
40166 "up 21 hours, 30 minutes\n"
40167 "# unshare --time --fork --boottime 300000000 uptime -p\n"
40168 "up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes\n"
40171 #. type: Plain text
40172 #: ../sys-utils/unshare.1.adoc:260
40174 "mailto:dottedmag@dottedmag.net[Mikhail Gusarov], mailto:kzak@redhat."
40178 #. type: Plain text
40179 #: ../sys-utils/unshare.1.adoc:269
40182 "*newuidmap*(1),\n"
40183 "*newgidmap*(1),\n"
40186 "*namespaces*(7),\n"
40191 #: ../sys-utils/wdctl.8.adoc:2
40196 #. type: Plain text
40197 #: ../sys-utils/wdctl.8.adoc:12
40198 msgid "wdctl - show hardware watchdog status"
40201 #. type: Plain text
40202 #: ../sys-utils/wdctl.8.adoc:16
40204 msgid "*wdctl* [options] [_device_...]\n"
40207 #. type: Plain text
40208 #: ../sys-utils/wdctl.8.adoc:20
40210 "Show hardware watchdog status. The default device is _/dev/watchdog_. If "
40211 "more than one device is specified then the output is separated by one blank "
40215 #. type: Plain text
40216 #: ../sys-utils/wdctl.8.adoc:22
40218 "If the device is already used or user has no permissions to read from the "
40219 "device, then *wdctl* reads data from sysfs. In this case information about "
40220 "supported features (flags) might be missing."
40223 #. type: Plain text
40224 #: ../sys-utils/wdctl.8.adoc:24
40226 "Note that the number of supported watchdog features is hardware specific."
40229 #. type: Labeled list
40230 #: ../sys-utils/wdctl.8.adoc:27
40232 #| msgid "*-f*, *--fast*"
40233 msgid "*-f*, *--flags* _list_"
40234 msgstr "*-f*, *--fast*"
40236 #. type: Plain text
40237 #: ../sys-utils/wdctl.8.adoc:29
40238 msgid "Print only the specified flags."
40241 #. type: Labeled list
40242 #: ../sys-utils/wdctl.8.adoc:30
40244 #| msgid "*-f*, *--fast*"
40245 msgid "*-F*, *--noflags*"
40246 msgstr "*-f*, *--fast*"
40248 #. type: Plain text
40249 #: ../sys-utils/wdctl.8.adoc:32
40250 msgid "Do not print information about flags."
40253 #. type: Labeled list
40254 #: ../sys-utils/wdctl.8.adoc:33
40256 #| msgid "*-P*, *--pty*"
40257 msgid "*-I*, *--noident*"
40258 msgstr "*-P*, *--pty*"
40260 #. type: Plain text
40261 #: ../sys-utils/wdctl.8.adoc:35
40262 msgid "Do not print watchdog identity information."
40265 #. type: Plain text
40266 #: ../sys-utils/wdctl.8.adoc:38
40267 msgid "Do not print a header line for flags table."
40270 #. type: Plain text
40271 #: ../sys-utils/wdctl.8.adoc:41
40273 "Define the output columns to use in table of watchdog flags. If no output "
40274 "arrangement is specified, then a default set is used. Use *--help* to get "
40275 "list of all supported columns."
40278 #. type: Labeled list
40279 #: ../sys-utils/wdctl.8.adoc:42
40281 #| msgid "*-h*, *--help*"
40282 msgid "*-O*, *--oneline*"
40283 msgstr "*-h*, *--help*"
40285 #. type: Plain text
40286 #: ../sys-utils/wdctl.8.adoc:44
40288 "Print all wanted information on one line in key=\"value\" output format."
40291 #. type: Labeled list
40292 #: ../sys-utils/wdctl.8.adoc:45
40294 msgid "*-p*, *--setpretimeout* _seconds_"
40297 #. type: Plain text
40298 #: ../sys-utils/wdctl.8.adoc:50
40300 "Set the watchdog pre-timeout in seconds. A watchdog pre-timeout is a "
40301 "notification generated by the watchdog before the watchdog reset might occur "
40302 "in the event the watchdog has not been serviced. This notification is "
40303 "handled by the kernel and can be configured to take an action using sysfs or "
40304 "by **--setpregovernor**."
40307 #. type: Labeled list
40308 #: ../sys-utils/wdctl.8.adoc:51
40310 msgid "*-g*, *--setpregovernor* _governor_"
40313 #. type: Plain text
40314 #: ../sys-utils/wdctl.8.adoc:53
40316 "Set pre-timeout governor name. For available governors see default **wdctl** "
40320 #. type: Labeled list
40321 #: ../sys-utils/wdctl.8.adoc:57
40323 msgid "*-s*, *--settimeout* _seconds_"
40326 #. type: Plain text
40327 #: ../sys-utils/wdctl.8.adoc:59
40328 msgid "Set the watchdog timeout in seconds."
40331 #. type: Labeled list
40332 #: ../sys-utils/wdctl.8.adoc:60
40334 #| msgid "*-P*, *--pty*"
40335 msgid "*-T*, *--notimeouts*"
40336 msgstr "*-P*, *--pty*"
40338 #. type: Plain text
40339 #: ../sys-utils/wdctl.8.adoc:62
40340 msgid "Do not print watchdog timeouts."
40343 #. type: Labeled list
40344 #: ../sys-utils/wdctl.8.adoc:63
40346 #| msgid "*-f*, *--fast*"
40347 msgid "*-x*, *--flags-only*"
40348 msgstr "*-f*, *--fast*"
40350 #. type: Plain text
40351 #: ../sys-utils/wdctl.8.adoc:65
40352 msgid "Same as *-I -T*."
40355 #. type: Plain text
40356 #: ../sys-utils/wdctl.8.adoc:72
40358 "mailto:kzak@redhat.com[Karel Zak], mailto:lennart@poettering.net[Lennart "
40363 #: ../sys-utils/zramctl.8.adoc:2
40368 #. type: Plain text
40369 #: ../sys-utils/zramctl.8.adoc:12
40370 msgid "zramctl - set up and control zram devices"
40373 #. type: Labeled list
40374 #: ../sys-utils/zramctl.8.adoc:15
40379 #. type: Plain text
40380 #: ../sys-utils/zramctl.8.adoc:18
40382 msgid "*zramctl* [options]\n"
40385 #. type: Labeled list
40386 #: ../sys-utils/zramctl.8.adoc:19
40388 msgid "Reset zram: "
40391 #. type: Plain text
40392 #: ../sys-utils/zramctl.8.adoc:22
40394 msgid "*zramctl* *-r* _zramdev_...\n"
40397 #. type: Labeled list
40398 #: ../sys-utils/zramctl.8.adoc:23
40400 msgid "Print name of first unused zram device: "
40403 #. type: Plain text
40404 #: ../sys-utils/zramctl.8.adoc:26
40406 msgid "*zramctl* *-f*\n"
40409 #. type: Labeled list
40410 #: ../sys-utils/zramctl.8.adoc:27
40412 msgid "Set up a zram device: "
40415 #. type: Plain text
40416 #: ../sys-utils/zramctl.8.adoc:30
40418 msgid "*zramctl* [*-f* | _zramdev_] [*-s* _size_] [*-t* _number_] [*-a* _algorithm_]\n"
40421 #. type: Plain text
40422 #: ../sys-utils/zramctl.8.adoc:34
40424 msgid "*zramctl* is used to quickly set up zram device parameters, to reset zram devices, and to query the status of used zram devices.\n"
40427 #. type: Plain text
40428 #: ../sys-utils/zramctl.8.adoc:36
40429 msgid "If no option is given, all non-zero size zram devices are shown."
40432 #. type: Plain text
40433 #: ../sys-utils/zramctl.8.adoc:38
40435 "Note that _zramdev_ node specified on command line has to already exist. The "
40436 "command *zramctl* creates a new _/dev/zram<N>_ nodes only when *--find* "
40437 "option specified. It's possible (and common) that after system boot _/dev/"
40438 "zram<N>_ nodes are not created yet."
40441 #. type: Labeled list
40442 #: ../sys-utils/zramctl.8.adoc:41
40444 msgid "*-a*, **--algorithm lzo**|**lz4**|**lz4hc**|**deflate**|**842**|**zstd**"
40447 #. type: Plain text
40448 #: ../sys-utils/zramctl.8.adoc:43
40450 "Set the compression algorithm to be used for compressing data in the zram "
40454 #. type: Plain text
40455 #: ../sys-utils/zramctl.8.adoc:45
40457 "The *list of supported algorithms could be inaccurate* as it depends on the "
40458 "current kernel configuration. A basic overview can be obtained by using the "
40459 "command \"cat /sys/block/zram0/comp_algorithm\"; however, please note that "
40460 "this list might also be incomplete. This is due to the fact that ZRAM "
40461 "utilizes the Crypto API, and if certain algorithms were built as modules, it "
40462 "becomes impossible to enumerate all of them."
40465 #. type: Labeled list
40466 #: ../sys-utils/zramctl.8.adoc:46
40468 #| msgid "*-f*, *--fast*"
40469 msgid "*-f*, *--find*"
40470 msgstr "*-f*, *--fast*"
40472 #. type: Plain text
40473 #: ../sys-utils/zramctl.8.adoc:48
40475 "Find the first unused zram device. If a *--size* argument is present, then "
40476 "initialize the device."
40479 #. type: Plain text
40480 #: ../sys-utils/zramctl.8.adoc:54
40482 "Define the status output columns to be used. If no output arrangement is "
40483 "specified, then a default set is used. Use *--help* to get a list of all "
40484 "supported columns."
40487 #. type: Plain text
40488 #: ../sys-utils/zramctl.8.adoc:60
40489 msgid "Use the raw format for status output."
40492 #. type: Plain text
40493 #: ../sys-utils/zramctl.8.adoc:63
40495 "Reset the options of the specified zram device(s). Zram device settings can "
40496 "be changed only after a reset."
40499 #. type: Labeled list
40500 #: ../sys-utils/zramctl.8.adoc:64
40502 #| msgid "*-s*, **--shell**=__shell__"
40503 msgid "*-s*, *--size* _size_"
40504 msgstr "*-s*, **--shell**=__shell__"
40506 #. type: Plain text
40507 #: ../sys-utils/zramctl.8.adoc:66
40509 "Create a zram device of the specified _size_. Zram devices are aligned to "
40510 "memory pages; when the requested _size_ is not a multiple of the page size, "
40511 "it will be rounded up to the next multiple. When not otherwise specified, "
40512 "the unit of the _size_ parameter is bytes."
40515 #. type: Plain text
40516 #: ../sys-utils/zramctl.8.adoc:68
40518 "The _size_ argument may be followed by the multiplicative suffixes KiB "
40519 "(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
40520 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
40521 "suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and "
40525 #. type: Labeled list
40526 #: ../sys-utils/zramctl.8.adoc:69
40528 msgid "*-t*, *--streams* _number_"
40531 #. type: Plain text
40532 #: ../sys-utils/zramctl.8.adoc:71
40534 "Set the maximum number of compression streams that can be used for the "
40535 "device. The default is use all CPUs and one stream for kernels older than "
40539 #. type: Plain text
40540 #: ../sys-utils/zramctl.8.adoc:77
40542 msgid "*zramctl* returns 0 on success, nonzero on failure.\n"
40545 #. type: Labeled list
40546 #: ../sys-utils/zramctl.8.adoc:80
40548 msgid "_/dev/zram[0..N]_"
40551 #. type: Plain text
40552 #: ../sys-utils/zramctl.8.adoc:82
40553 msgid "zram block devices"
40556 #. type: Plain text
40557 #: ../sys-utils/zramctl.8.adoc:86
40559 "The following commands set up a zram device with a size of one gigabyte and "
40560 "use it as swap device."
40563 #. type: delimited block .
40564 #: ../sys-utils/zramctl.8.adoc:95
40567 " # zramctl --find --size 1024M\n"
40569 " # mkswap /dev/zram0\n"
40570 " # swapon /dev/zram0\n"
40572 " # swapoff /dev/zram0\n"
40573 " # zramctl --reset /dev/zram0\n"
40576 #. type: Plain text
40577 #: ../sys-utils/zramctl.8.adoc:101
40579 "mailto:nefelim4ag@gmail.com[Timofey Titovets], mailto:kzak@redhat.com[Karel "
40583 #. type: Plain text
40584 #: ../sys-utils/zramctl.8.adoc:105
40586 "link:https://docs.kernel.org/admin-guide/blockdev/zram.html[Linux kernel "
40591 #: ../term-utils/agetty.8.adoc:2
40596 #. type: Plain text
40597 #: ../term-utils/agetty.8.adoc:12
40598 msgid "agetty - alternative Linux getty"
40601 #. type: Plain text
40602 #: ../term-utils/agetty.8.adoc:16
40604 msgid "*agetty* [options] _port_ [_baud_rate_...] [_term_]\n"
40607 #. type: Plain text
40608 #: ../term-utils/agetty.8.adoc:20
40610 msgid "*agetty* opens a tty port, prompts for a login name and invokes the /bin/login command. It is normally invoked by *init*(8).\n"
40613 #. type: Plain text
40614 #: ../term-utils/agetty.8.adoc:22
40616 msgid "*agetty* has several _non-standard_ features that are useful for hardwired and for dial-in lines:\n"
40619 #. type: Plain text
40620 #: ../term-utils/agetty.8.adoc:24
40622 "Adapts the tty settings to parity bits and to erase, kill, end-of-line and "
40623 "uppercase characters when it reads a login name. The program can handle 7-"
40624 "bit characters with even, odd, none or space parity, and 8-bit characters "
40625 "with no parity. The following special characters are recognized: Control-U "
40626 "(kill); DEL and backspace (erase); carriage return and line feed (end of "
40627 "line). See also the *--erase-chars* and *--kill-chars* options."
40630 #. type: Plain text
40631 #: ../term-utils/agetty.8.adoc:25
40633 "Optionally deduces the baud rate from the CONNECT messages produced by "
40634 "Hayes(tm)-compatible modems."
40637 #. type: Plain text
40638 #: ../term-utils/agetty.8.adoc:26
40640 "Optionally does not hang up when it is given an already opened line (useful "
40641 "for call-back applications)."
40644 #. type: Plain text
40645 #: ../term-utils/agetty.8.adoc:27
40646 msgid "Optionally does not display the contents of the _/etc/issue_ file."
40649 #. type: Plain text
40650 #: ../term-utils/agetty.8.adoc:28
40652 "Optionally displays an alternative issue files or directories instead of _/"
40653 "etc/issue_ or _/etc/issue.d_."
40656 #. type: Plain text
40657 #: ../term-utils/agetty.8.adoc:29
40658 msgid "Optionally does not ask for a login name."
40661 #. type: Plain text
40662 #: ../term-utils/agetty.8.adoc:30
40664 "Optionally invokes a non-standard login program instead of _/bin/login_."
40667 #. type: Plain text
40668 #: ../term-utils/agetty.8.adoc:31
40669 msgid "Optionally turns on hardware flow control."
40672 #. type: Plain text
40673 #: ../term-utils/agetty.8.adoc:32
40674 msgid "Optionally forces the line to be local with no need for carrier detect."
40677 #. type: Plain text
40678 #: ../term-utils/agetty.8.adoc:34
40680 "This program does not use the _/etc/gettydefs_ (System V) or _/etc/gettytab_ "
40684 #. type: Labeled list
40685 #: ../term-utils/agetty.8.adoc:37
40690 #. type: Plain text
40691 #: ../term-utils/agetty.8.adoc:39
40693 "A path name relative to the _/dev_ directory. If a \"-\" is specified, "
40694 "*agetty* assumes that its standard input is already connected to a tty port "
40695 "and that a connection to a remote user has already been established."
40698 #. type: Plain text
40699 #: ../term-utils/agetty.8.adoc:41
40700 msgid "Under System V, a \"-\" _port_ argument should be preceded by a \"--\"."
40703 #. type: Labeled list
40704 #: ../term-utils/agetty.8.adoc:42
40706 msgid "_baud_rate_,..."
40709 #. type: Plain text
40710 #: ../term-utils/agetty.8.adoc:44
40712 "A comma-separated list of one or more baud rates. Each time *agetty* "
40713 "receives a BREAK character it advances through the list, which is treated as "
40714 "if it were circular."
40717 #. type: Plain text
40718 #: ../term-utils/agetty.8.adoc:46
40720 "Baud rates should be specified in descending order, so that the null "
40721 "character (Ctrl-@) can also be used for baud-rate switching."
40724 #. type: Plain text
40725 #: ../term-utils/agetty.8.adoc:48
40726 msgid "This argument is optional and unnecessary for *virtual terminals*."
40729 #. type: Plain text
40730 #: ../term-utils/agetty.8.adoc:50
40732 "The default for *serial terminals* is keep the current baud rate (see *--"
40733 "keep-baud*) and if unsuccessful then default to '9600'."
40736 #. type: Labeled list
40737 #: ../term-utils/agetty.8.adoc:51
40742 #. type: Plain text
40743 #: ../term-utils/agetty.8.adoc:53
40745 "The value to be used for the *TERM* environment variable. This overrides "
40746 "whatever *init*(1) may have set, and is inherited by login and the shell."
40749 #. type: Plain text
40750 #: ../term-utils/agetty.8.adoc:55
40752 "The default is 'vt100', or 'linux' for Linux on a virtual terminal, or "
40753 "'hurd' for GNU Hurd on a virtual terminal."
40756 #. type: Labeled list
40757 #: ../term-utils/agetty.8.adoc:58
40759 #| msgid "*-P*, *--pty*"
40760 msgid "*-8*, *--8bits*"
40761 msgstr "*-P*, *--pty*"
40763 #. type: Plain text
40764 #: ../term-utils/agetty.8.adoc:60
40765 msgid "Assume that the tty is 8-bit clean, hence disable parity detection."
40768 #. type: Labeled list
40769 #: ../term-utils/agetty.8.adoc:61
40771 msgid "*-a*, *--autologin* _username_"
40774 #. type: Plain text
40775 #: ../term-utils/agetty.8.adoc:63
40777 "Automatically log in the specified user without asking for a username or "
40778 "password. Using this option causes an *-f* _username_ option and argument to "
40779 "be added to the */bin/login* command line. See *--login-options*, which can "
40780 "be used to modify this option's behavior."
40783 #. type: Plain text
40784 #: ../term-utils/agetty.8.adoc:65
40786 "Note that *--autologin* may affect the way in which *getty* initializes the "
40787 "serial line, because on auto-login *agetty* does not read from the line and "
40788 "it has no opportunity optimize the line setting."
40791 #. type: Labeled list
40792 #: ../term-utils/agetty.8.adoc:66
40794 #| msgid "*-f*, *--fast*"
40795 msgid "*-c*, *--noreset*"
40796 msgstr "*-f*, *--fast*"
40798 #. type: Plain text
40799 #: ../term-utils/agetty.8.adoc:68
40801 "Do not reset terminal cflags (control modes). See *termios*(3) for more "
40805 #. type: Labeled list
40806 #: ../term-utils/agetty.8.adoc:69
40808 #| msgid "*-P*, *--pty*"
40809 msgid "*-E*, *--remote*"
40810 msgstr "*-P*, *--pty*"
40812 #. type: Plain text
40813 #: ../term-utils/agetty.8.adoc:71
40815 "Typically the *login*(1) command is given a remote hostname when called by "
40816 "something such as *telnetd*(8). This option allows *agetty* to pass what it "
40817 "is using for a hostname to *login*(1) for use in *utmp*(5). See *--host*, "
40818 "*login*(1), and *utmp*(5)."
40821 #. type: Plain text
40822 #: ../term-utils/agetty.8.adoc:73
40824 "If the *--host* _fakehost_ option is given, then an *-h* _fakehost_ option "
40825 "and argument are added to the _/bin/login_ command line."
40828 #. type: Plain text
40829 #: ../term-utils/agetty.8.adoc:75
40831 "If the *--nohostname* option is given, then an *-H* option is added to the */"
40832 "bin/login* command line."
40835 #. type: Plain text
40836 #: ../term-utils/agetty.8.adoc:77
40837 msgid "See *--login-options*."
40840 #. type: Labeled list
40841 #: ../term-utils/agetty.8.adoc:78
40843 msgid "*-f*, *--issue-file* _path_"
40846 #. type: Plain text
40847 #: ../term-utils/agetty.8.adoc:80
40849 "Specifies a \":\" delimited list of files and directories to be displayed "
40850 "instead of _/etc/issue_ (or other). All specified files and directories are "
40851 "displayed, missing or empty files are silently ignored. If the specified "
40852 "path is a directory then display all files with __.issue__ file extension in "
40853 "version-sort order from the directory. This allows custom messages to be "
40854 "displayed on different terminals. The *--noissue* option will override this "
40858 #. type: Labeled list
40859 #: ../term-utils/agetty.8.adoc:81
40861 msgid "*--show-issue*"
40864 #. type: Plain text
40865 #: ../term-utils/agetty.8.adoc:83
40867 "Display the current issue file (or other) on the current terminal and exit. "
40868 "Use this option to review the current setting, it is not designed for any "
40869 "other purpose. Note that output may use some default or incomplete "
40870 "information as proper output depends on terminal and *agetty* command line."
40873 #. type: Labeled list
40874 #: ../term-utils/agetty.8.adoc:84
40876 msgid "*-h, --flow-control*"
40879 #. type: Plain text
40880 #: ../term-utils/agetty.8.adoc:86
40882 "Enable hardware (RTS/CTS) flow control. It is left up to the application to "
40883 "disable software (XON/XOFF) flow protocol where appropriate."
40886 #. type: Labeled list
40887 #: ../term-utils/agetty.8.adoc:87
40889 #| msgid "*-f*, *--fast*"
40890 msgid "*-H*, *--host* _fakehost_"
40891 msgstr "*-f*, *--fast*"
40893 #. type: Plain text
40894 #: ../term-utils/agetty.8.adoc:89
40896 "Write the specified _fakehost_ into the utmp file. Normally, no login host "
40897 "is given, since *agetty* is used for local hardwired connections and "
40898 "consoles. However, this option can be useful for identifying terminal "
40899 "concentrators and the like."
40902 #. type: Labeled list
40903 #: ../term-utils/agetty.8.adoc:90
40905 #| msgid "*-h*, *--help*"
40906 msgid "*-i*, *--noissue*"
40907 msgstr "*-h*, *--help*"
40909 #. type: Plain text
40910 #: ../term-utils/agetty.8.adoc:92
40912 "Do not display the contents of _/etc/issue_ (or other) before writing the "
40913 "login prompt. Terminals or communications hardware may become confused when "
40914 "receiving lots of text at the wrong baud rate; dial-up scripts may fail if "
40915 "the login prompt is preceded by too much text."
40918 #. type: Labeled list
40919 #: ../term-utils/agetty.8.adoc:93
40921 msgid "*-I*, *--init-string* _initstring_"
40924 #. type: Plain text
40925 #: ../term-utils/agetty.8.adoc:95
40927 "Set an initial string to be sent to the tty or modem before sending anything "
40928 "else. This may be used to initialize a modem. Non-printable characters may "
40929 "be sent by writing their octal code preceded by a backslash (\\). For "
40930 "example, to send a linefeed character (ASCII 10, octal 012), write \\12."
40933 #. type: Labeled list
40934 #: ../term-utils/agetty.8.adoc:96
40936 #| msgid "*-V*, *--version*"
40937 msgid "*-J*, *--noclear*"
40938 msgstr "*-V*, *--version*"
40940 #. type: Plain text
40941 #: ../term-utils/agetty.8.adoc:98
40943 "Do not clear the screen before prompting for the login name. By default the "
40944 "screen is cleared."
40947 #. type: Labeled list
40948 #: ../term-utils/agetty.8.adoc:99
40950 msgid "*-l*, *--login-program* _login_program_"
40953 #. type: Plain text
40954 #: ../term-utils/agetty.8.adoc:101
40956 "Invoke the specified _login_program_ instead of /bin/login. This allows the "
40957 "use of a non-standard login program. Such a program could, for example, ask "
40958 "for a dial-up password or use a different password file. See *--login-"
40962 #. type: Labeled list
40963 #: ../term-utils/agetty.8.adoc:102
40965 #| msgid "*-c*, **--command**=__command__"
40966 msgid "*-L*, *--local-line*[=__mode__]"
40967 msgstr "*-c*, **--command**=__příkaz__"
40969 #. type: Plain text
40970 #: ../term-utils/agetty.8.adoc:104
40972 "Control the CLOCAL line flag. The optional _mode_ argument is *auto*, "
40973 "*always* or *never*. If the _mode_ argument is omitted, then the default is "
40974 "*always*. If the *--local-line* option is not given at all, then the default "
40978 #. type: Labeled list
40979 #: ../term-utils/agetty.8.adoc:105
40984 #. type: Plain text
40985 #: ../term-utils/agetty.8.adoc:107
40987 "Forces the line to be a local line with no need for carrier detect. This can "
40988 "be useful when you have a locally attached terminal where the serial line "
40989 "does not set the carrier-detect signal."
40992 #. type: Labeled list
40993 #: ../term-utils/agetty.8.adoc:107
40998 #. type: Plain text
40999 #: ../term-utils/agetty.8.adoc:109
41001 "Explicitly clears the CLOCAL flag from the line setting and the carrier-"
41002 "detect signal is expected on the line."
41005 #. type: Labeled list
41006 #: ../term-utils/agetty.8.adoc:109
41011 #. type: Plain text
41012 #: ../term-utils/agetty.8.adoc:111
41014 "The *agetty* default. Does not modify the CLOCAL setting and follows the "
41015 "setting enabled by the kernel."
41018 #. type: Labeled list
41019 #: ../term-utils/agetty.8.adoc:112
41021 #| msgid "*-f*, *--fast*"
41022 msgid "*-m*, *--extract-baud*"
41023 msgstr "*-f*, *--fast*"
41025 #. type: Plain text
41026 #: ../term-utils/agetty.8.adoc:114
41028 "Try to extract the baud rate from the CONNECT status message produced by "
41029 "Hayes(tm)-compatible modems. These status messages are of the form: "
41030 "\"<junk><speed><junk>\". *agetty* assumes that the modem emits its status "
41031 "message at the same speed as specified with (the first) _baud_rate_ value on "
41032 "the command line."
41035 #. type: Plain text
41036 #: ../term-utils/agetty.8.adoc:116
41038 "Since the *--extract-baud* feature may fail on heavily-loaded systems, you "
41039 "still should enable BREAK processing by enumerating all expected baud rates "
41040 "on the command line."
41043 #. type: Labeled list
41044 #: ../term-utils/agetty.8.adoc:117
41046 msgid "*--list-speeds*"
41049 #. type: Plain text
41050 #: ../term-utils/agetty.8.adoc:119
41051 msgid "Display supported baud rates. These are determined at compilation time."
41054 #. type: Labeled list
41055 #: ../term-utils/agetty.8.adoc:120
41057 #| msgid "*-*, *-l*, *--login*"
41058 msgid "*-n*, *--skip-login*"
41059 msgstr "*-*, *-l*, *--login*"
41061 #. type: Plain text
41062 #: ../term-utils/agetty.8.adoc:122
41064 "Do not prompt the user for a login name. This can be used in connection with "
41065 "the *--login-program* option to invoke a non-standard login process such as "
41066 "a BBS system. Note that with the *--skip-login* option, *agetty* gets no "
41067 "input from the user who logs in and therefore will not be able to figure out "
41068 "parity, character size, and newline processing of the connection. It "
41069 "defaults to space parity, 7 bit characters, and ASCII CR (13) end-of-line "
41070 "character. Beware that the program that *agetty* starts (usually /bin/login) "
41074 #. type: Labeled list
41075 #: ../term-utils/agetty.8.adoc:123
41077 #| msgid "*-h*, *--help*"
41078 msgid "*-N*, *--nonewline*"
41079 msgstr "*-h*, *--help*"
41081 #. type: Plain text
41082 #: ../term-utils/agetty.8.adoc:125
41083 msgid "Do not print a newline before writing out _/etc/issue_."
41086 #. type: Labeled list
41087 #: ../term-utils/agetty.8.adoc:126
41089 msgid "*-o*, *--login-options* _login_options_"
41092 #. type: Plain text
41093 #: ../term-utils/agetty.8.adoc:128
41095 "Options and arguments that are passed to *login*(1). Where \\u is replaced "
41096 "by the login name. For example:"
41099 #. type: Plain text
41100 #: ../term-utils/agetty.8.adoc:130
41102 msgid "*--login-options '-h darkstar \\-- \\u'*\n"
41105 #. type: Plain text
41106 #: ../term-utils/agetty.8.adoc:132
41107 msgid "See *--autologin*, *--login-program* and *--remote*."
41110 #. type: Plain text
41111 #: ../term-utils/agetty.8.adoc:134
41112 msgid "Please read the *SECURITY NOTICE* below before using this option."
41115 #. type: Labeled list
41116 #: ../term-utils/agetty.8.adoc:135
41118 #| msgid "*-*, *-l*, *--login*"
41119 msgid "*-p*, *--login-pause*"
41120 msgstr "*-*, *-l*, *--login*"
41122 #. type: Plain text
41123 #: ../term-utils/agetty.8.adoc:137
41125 "Wait for any key before dropping to the login prompt. Can be combined with "
41126 "*--autologin* to save memory by lazily spawning shells."
41129 #. type: Labeled list
41130 #: ../term-utils/agetty.8.adoc:138
41132 msgid "*-r*, *--chroot* _directory_"
41135 #. type: Plain text
41136 #: ../term-utils/agetty.8.adoc:140
41138 #| msgid "changes to the target user's home directory"
41139 msgid "Change root to the specified directory."
41140 msgstr "přejde do domovského adresáře cílového uživatele"
41142 #. type: Labeled list
41143 #: ../term-utils/agetty.8.adoc:141
41145 #| msgid "*-h*, *--help*"
41146 msgid "*-R*, *--hangup*"
41147 msgstr "*-h*, *--help*"
41149 #. type: Plain text
41150 #: ../term-utils/agetty.8.adoc:143
41151 msgid "Call *vhangup*(2) to do a virtual hangup of the specified terminal."
41154 #. type: Labeled list
41155 #: ../term-utils/agetty.8.adoc:144
41157 #| msgid "*-h*, *--help*"
41158 msgid "*-s*, *--keep-baud*"
41159 msgstr "*-h*, *--help*"
41161 #. type: Plain text
41162 #: ../term-utils/agetty.8.adoc:146
41164 "Try to keep the existing baud rate. The baud rates from the command line are "
41165 "used when *agetty* receives a BREAK character. If another baud rates "
41166 "specified then the original baud rate is also saved to the end of the wanted "
41167 "baud rates list. This can be used to return to the original baud rate after "
41168 "unexpected BREAKs."
41171 #. type: Labeled list
41172 #: ../term-utils/agetty.8.adoc:147 ../term-utils/wall.1.adoc:65
41174 msgid "*-t*, *--timeout* _timeout_"
41177 #. type: Plain text
41178 #: ../term-utils/agetty.8.adoc:149
41180 "Terminate if no user name could be read within _timeout_ seconds. Use of "
41181 "this option with hardwired terminal lines is not recommended."
41184 #. type: Labeled list
41185 #: ../term-utils/agetty.8.adoc:150
41187 #| msgid "*-f*, *--fast*"
41188 msgid "*-U*, *--detect-case*"
41189 msgstr "*-f*, *--fast*"
41191 #. type: Plain text
41192 #: ../term-utils/agetty.8.adoc:152
41194 "Turn on support for detecting an uppercase-only terminal. This setting will "
41195 "detect a login name containing only capitals as indicating an uppercase-only "
41196 "terminal and turn on some upper-to-lower case conversions. Note that this "
41197 "has no support for any Unicode characters."
41200 #. type: Labeled list
41201 #: ../term-utils/agetty.8.adoc:153
41203 #| msgid "*-f*, *--fast*"
41204 msgid "*-w*, *--wait-cr*"
41205 msgstr "*-f*, *--fast*"
41207 #. type: Plain text
41208 #: ../term-utils/agetty.8.adoc:155
41210 "Wait for the user or the modem to send a carriage-return or a linefeed "
41211 "character before sending the _/etc/issue_ file (or others) and the login "
41212 "prompt. This is useful with the *--init-string* option."
41215 #. type: Labeled list
41216 #: ../term-utils/agetty.8.adoc:156
41218 msgid "*--nohints*"
41221 #. type: Plain text
41222 #: ../term-utils/agetty.8.adoc:158
41223 msgid "Do not print hints about Num, Caps and Scroll Locks."
41226 #. type: Labeled list
41227 #: ../term-utils/agetty.8.adoc:159
41229 msgid "*--nohostname*"
41232 #. type: Plain text
41233 #: ../term-utils/agetty.8.adoc:161
41235 "By default the hostname will be printed. With this option enabled, no "
41236 "hostname at all will be shown. This setting is also possible to able by "
41237 "LOGIN_PLAIN_PROMPT option in the _/etc/login.defs_ configuration file (see "
41238 "below for more details)."
41241 #. type: Labeled list
41242 #: ../term-utils/agetty.8.adoc:162
41244 msgid "*--long-hostname*"
41247 #. type: Plain text
41248 #: ../term-utils/agetty.8.adoc:164
41250 "By default the hostname is only printed until the first dot. With this "
41251 "option enabled, the fully qualified hostname by *gethostname*(3P) or (if not "
41252 "found) by *getaddrinfo*(3) is shown."
41255 #. type: Labeled list
41256 #: ../term-utils/agetty.8.adoc:165
41258 msgid "*--erase-chars* _string_"
41261 #. type: Plain text
41262 #: ../term-utils/agetty.8.adoc:167
41264 "This option specifies additional characters that should be interpreted as a "
41265 "backspace (\"ignore the previous character\") when the user types the login "
41266 "name. The default additional 'erase' has been '#', but since util-linux 2.23 "
41267 "no additional erase characters are enabled by default."
41270 #. type: Labeled list
41271 #: ../term-utils/agetty.8.adoc:168
41273 msgid "*--kill-chars* _string_"
41276 #. type: Plain text
41277 #: ../term-utils/agetty.8.adoc:170
41279 "This option specifies additional characters that should be interpreted as a "
41280 "kill (\"ignore all previous characters\") when the user types the login "
41281 "name. The default additional 'kill' has been '@', but since util-linux 2.23 "
41282 "no additional kill characters are enabled by default."
41285 #. type: Labeled list
41286 #: ../term-utils/agetty.8.adoc:171
41288 msgid "*--chdir* _directory_"
41291 #. type: Plain text
41292 #: ../term-utils/agetty.8.adoc:173
41293 msgid "Change directory before the login."
41296 #. type: Labeled list
41297 #: ../term-utils/agetty.8.adoc:174
41299 msgid "*--delay* _number_"
41302 #. type: Plain text
41303 #: ../term-utils/agetty.8.adoc:176
41304 msgid "Sleep seconds before open tty."
41307 #. type: Labeled list
41308 #: ../term-utils/agetty.8.adoc:177
41310 msgid "*--nice* _number_"
41313 #. type: Plain text
41314 #: ../term-utils/agetty.8.adoc:179
41315 msgid "Run login with this priority."
41318 #. type: Labeled list
41319 #: ../term-utils/agetty.8.adoc:180
41324 #. type: Plain text
41325 #: ../term-utils/agetty.8.adoc:182
41327 "Ask all running *agetty* instances to reload and update their displayed "
41328 "prompts, if the user has not yet commenced logging in. After doing so the "
41329 "command will exit. This feature might be unsupported on systems without "
41330 "Linux *inotify*(7)."
41333 #. type: Plain text
41334 #: ../term-utils/agetty.8.adoc:189
41336 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
41338 "*agetty* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)).\n"
41339 "Note that the configuration file could be distributed with another package (usually shadow-utils).\n"
41340 "The following configuration items are relevant for *agetty*:\n"
41341 msgstr "*su* čte konfigurační soubory _/etc/default/su_ a _/etc/login.defs_. Následující konfigurační položky jsou relevantní pro *su*{colon}\n"
41343 #. type: Plain text
41344 #: ../term-utils/agetty.8.adoc:193
41346 "Tell *agetty* that printing the hostname should be suppressed in the login: "
41347 "prompt. This is an alternative to the *--nohostname* command line option. "
41348 "The default value is _no_."
41351 #. type: Plain text
41352 #: ../term-utils/agetty.8.adoc:197
41354 "This section shows examples for the process field of an entry in the _/etc/"
41355 "inittab_ file. You'll have to prepend appropriate values for the other "
41356 "fields. See *inittab*(5) for more details."
41359 #. type: Plain text
41360 #: ../term-utils/agetty.8.adoc:199
41361 msgid "For a hardwired line or a console tty:"
41364 #. type: delimited block _
41365 #: ../term-utils/agetty.8.adoc:202
41367 msgid "*/sbin/agetty 9600 ttyS1*\n"
41370 #. type: Plain text
41371 #: ../term-utils/agetty.8.adoc:205
41373 "For a directly connected terminal without proper carrier-detect wiring (try "
41374 "this if your terminal just sleeps instead of giving you a password: prompt):"
41377 #. type: delimited block _
41378 #: ../term-utils/agetty.8.adoc:208
41380 msgid "*/sbin/agetty --local-line 9600 ttyS1 vt100*\n"
41383 #. type: Plain text
41384 #: ../term-utils/agetty.8.adoc:211
41385 msgid "For an old-style dial-in line with a 9600/2400/1200 baud modem:"
41388 #. type: delimited block _
41389 #: ../term-utils/agetty.8.adoc:214
41391 msgid "*/sbin/agetty --extract-baud --timeout 60 ttyS1 9600,2400,1200*\n"
41394 #. type: Plain text
41395 #: ../term-utils/agetty.8.adoc:217
41397 "For a Hayes modem with a fixed 115200 bps interface to the machine (the "
41398 "example init string turns off modem echo and result codes, makes modem/"
41399 "computer DCD track modem/modem DCD, makes a DTR drop cause a disconnection, "
41400 "and turns on auto-answer after 1 ring):"
41403 #. type: delimited block _
41404 #: ../term-utils/agetty.8.adoc:220
41406 msgid "*/sbin/agetty --wait-cr --init-string 'ATE0Q1&D2&C1S0=1\\015' 115200 ttyS1*\n"
41410 #: ../term-utils/agetty.8.adoc:222
41412 msgid "SECURITY NOTICE"
41415 #. type: Plain text
41416 #: ../term-utils/agetty.8.adoc:225
41418 "If you use the *--login-program* and *--login-options* options, be aware "
41419 "that a malicious user may try to enter lognames with embedded options, which "
41420 "then get passed to the used login program. *agetty* does check for a leading "
41421 "\"-\" and makes sure the logname gets passed as one parameter (so embedded "
41422 "spaces will not create yet another parameter), but depending on how the "
41423 "login binary parses the command line that might not be sufficient. Check "
41424 "that the used login program cannot be abused this way."
41427 #. type: Plain text
41428 #: ../term-utils/agetty.8.adoc:227
41430 "Some programs use \"--\" to indicate that the rest of the command line "
41431 "should not be interpreted as options. Use this feature if available by "
41432 "passing \"--\" before the username gets passed by \\u."
41436 #: ../term-utils/agetty.8.adoc:228
41439 msgid "ISSUE FILES"
41442 #. type: Plain text
41443 #: ../term-utils/agetty.8.adoc:231
41445 "The default issue file is _/etc/issue_. If the file exists, then *agetty* "
41446 "also checks for _/etc/issue.d_ directory. The directory is optional "
41447 "extension to the default issue file and content of the directory is printed "
41448 "after _/etc/issue_ content. If the _/etc/issue_ does not exist, then the "
41449 "directory is ignored. All files *with .issue extension* from the directory "
41450 "are printed in version-sort order. The directory can be used to maintain 3rd-"
41451 "party messages independently on the primary system _/etc/issue_ file."
41454 #. type: Plain text
41455 #: ../term-utils/agetty.8.adoc:233
41457 "Since version 2.35 additional locations for issue file and directory are "
41458 "supported. If the default _/etc/issue_ does not exist, then *agetty* checks "
41459 "for _/run/issue_ and _/run/issue.d_, thereafter for _/usr/lib/issue_ and _/"
41460 "usr/lib/issue.d_. The directory _/etc_ is expected for host specific "
41461 "configuration, _/run_ is expected for generated stuff and _/usr/lib_ for "
41462 "static distribution maintained configuration."
41465 #. type: Plain text
41466 #: ../term-utils/agetty.8.adoc:235
41468 "The default path maybe overridden by *--issue-file* option. In this case "
41469 "specified path has to be file or directory and all the default issue file "
41470 "and directory locations are ignored."
41473 #. type: Plain text
41474 #: ../term-utils/agetty.8.adoc:237
41476 "The issue file feature can be completely disabled by *--noissue* option."
41479 #. type: Plain text
41480 #: ../term-utils/agetty.8.adoc:239
41482 "It is possible to review the current issue file by *agetty --show-issue* on "
41483 "the current terminal."
41486 #. type: Plain text
41487 #: ../term-utils/agetty.8.adoc:241
41489 "The issue files may contain certain escape codes to display the system name, "
41490 "date, time et cetera. All escape codes consist of a backslash (\\) "
41491 "immediately followed by one of the characters listed below."
41494 #. type: Labeled list
41495 #: ../term-utils/agetty.8.adoc:242
41497 msgid "4 or 4{_interface_}"
41500 #. type: Plain text
41501 #: ../term-utils/agetty.8.adoc:244
41503 "Insert the IPv4 address of the specified network interface (for example: "
41504 "\\4\\{eth0}). If the _interface_ argument is not specified, then select the "
41505 "first fully configured (UP, non-LOCALBACK, RUNNING) interface. If no "
41506 "configured interface is found, fall back to the IP address of the machine's "
41510 #. type: Labeled list
41511 #: ../term-utils/agetty.8.adoc:245
41513 msgid "6 or 6{_interface_}"
41516 #. type: Plain text
41517 #: ../term-utils/agetty.8.adoc:247
41518 msgid "The same as \\4 but for IPv6."
41521 #. type: Labeled list
41522 #: ../term-utils/agetty.8.adoc:248
41527 #. type: Plain text
41528 #: ../term-utils/agetty.8.adoc:250
41529 msgid "Insert the baudrate of the current line."
41532 #. type: Labeled list
41533 #: ../term-utils/agetty.8.adoc:251
41538 #. type: Plain text
41539 #: ../term-utils/agetty.8.adoc:253
41540 msgid "Insert the current date."
41543 #. type: Labeled list
41544 #: ../term-utils/agetty.8.adoc:254
41546 msgid "e or e{_name_}"
41549 #. type: Plain text
41550 #: ../term-utils/agetty.8.adoc:256
41552 "Translate the human-readable _name_ to an escape sequence and insert it (for "
41553 "example: \\e{red}Alert text.\\e{reset}). If the _name_ argument is not "
41554 "specified, then insert \\033. The currently supported names are: black, "
41555 "blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
41556 "lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
41557 "magenta, red, reset, reverse, yellow and white. All unknown names are "
41558 "silently ignored."
41561 #. type: Labeled list
41562 #: ../term-utils/agetty.8.adoc:257
41567 #. type: Plain text
41568 #: ../term-utils/agetty.8.adoc:259
41570 "Insert the system name (the name of the operating system). Same as 'uname -"
41571 "s'. See also the \\S escape code."
41574 #. type: Labeled list
41575 #: ../term-utils/agetty.8.adoc:260
41577 msgid "S or S{VARIABLE}"
41580 #. type: Plain text
41581 #: ../term-utils/agetty.8.adoc:262
41583 "Insert the VARIABLE data from _/etc/os-release_. If this file does not exist "
41584 "then fall back to _/usr/lib/os-release_. If the VARIABLE argument is not "
41585 "specified, then use PRETTY_NAME from the file or the system name (see \\s). "
41586 "This escape code can be used to keep _/etc/issue_ distribution and release "
41587 "independent. Note that \\S{ANSI_COLOR} is converted to the real terminal "
41591 #. type: Labeled list
41592 #: ../term-utils/agetty.8.adoc:263
41597 #. type: Plain text
41598 #: ../term-utils/agetty.8.adoc:265
41599 msgid "Insert the name of the current tty line."
41602 #. type: Labeled list
41603 #: ../term-utils/agetty.8.adoc:266
41608 #. type: Plain text
41609 #: ../term-utils/agetty.8.adoc:268
41610 msgid "Insert the architecture identifier of the machine. Same as *uname -m*."
41613 #. type: Labeled list
41614 #: ../term-utils/agetty.8.adoc:269
41619 #. type: Plain text
41620 #: ../term-utils/agetty.8.adoc:271
41622 "Insert the nodename of the machine, also known as the hostname. Same as "
41626 #. type: Labeled list
41627 #: ../term-utils/agetty.8.adoc:272
41632 #. type: Plain text
41633 #: ../term-utils/agetty.8.adoc:274
41634 msgid "Insert the NIS domainname of the machine. Same as *hostname -d*."
41637 #. type: Labeled list
41638 #: ../term-utils/agetty.8.adoc:275
41643 #. type: Plain text
41644 #: ../term-utils/agetty.8.adoc:277
41645 msgid "Insert the DNS domainname of the machine."
41648 #. type: Labeled list
41649 #: ../term-utils/agetty.8.adoc:278
41654 #. type: Plain text
41655 #: ../term-utils/agetty.8.adoc:280
41656 msgid "Insert the release number of the OS. Same as *uname -r*."
41659 #. type: Labeled list
41660 #: ../term-utils/agetty.8.adoc:281
41665 #. type: Plain text
41666 #: ../term-utils/agetty.8.adoc:283
41667 msgid "Insert the current time."
41670 #. type: Labeled list
41671 #: ../term-utils/agetty.8.adoc:284
41676 #. type: Plain text
41677 #: ../term-utils/agetty.8.adoc:286
41678 msgid "Insert the number of current users logged in."
41681 #. type: Labeled list
41682 #: ../term-utils/agetty.8.adoc:287
41687 #. type: Plain text
41688 #: ../term-utils/agetty.8.adoc:289
41690 "Insert the string \"1 user\" or \"<n> users\" where <n> is the number of "
41691 "current users logged in."
41694 #. type: Labeled list
41695 #: ../term-utils/agetty.8.adoc:290
41700 #. type: Plain text
41701 #: ../term-utils/agetty.8.adoc:292
41702 msgid "Insert the version of the OS, that is, the build-date and such."
41705 #. type: Plain text
41706 #: ../term-utils/agetty.8.adoc:294
41707 msgid "An example. On my system, the following _/etc/issue_ file:"
41710 #. type: delimited block .
41711 #: ../term-utils/agetty.8.adoc:297
41713 msgid "This is \\n.\\o (\\s \\m \\r) \\t\n"
41716 #. type: Plain text
41717 #: ../term-utils/agetty.8.adoc:300
41718 msgid "displays as:"
41721 #. type: delimited block .
41722 #: ../term-utils/agetty.8.adoc:303
41724 msgid "This is thingol.orcan.dk (Linux i386 1.1.9) 18:29:30\n"
41727 #. type: Labeled list
41728 #: ../term-utils/agetty.8.adoc:307
41730 msgid "_/var/run/utmp_"
41733 #. type: Plain text
41734 #: ../term-utils/agetty.8.adoc:309
41735 msgid "the system status file."
41738 #. type: Labeled list
41739 #: ../term-utils/agetty.8.adoc:310
41741 #| msgid "_/etc/pam.d/su_"
41742 msgid "_/etc/issue_"
41743 msgstr "_/etc/pam.d/su_"
41745 #. type: Plain text
41746 #: ../term-utils/agetty.8.adoc:312
41747 msgid "printed before the login prompt."
41750 #. type: Labeled list
41751 #: ../term-utils/agetty.8.adoc:313
41753 msgid "_/etc/os-release /usr/lib/os-release_"
41756 #. type: Plain text
41757 #: ../term-utils/agetty.8.adoc:315
41758 msgid "operating system identification data."
41761 #. type: Labeled list
41762 #: ../term-utils/agetty.8.adoc:316
41764 msgid "_/dev/console_"
41767 #. type: Plain text
41768 #: ../term-utils/agetty.8.adoc:318
41769 msgid "problem reports (if *syslog*(3) is not used)."
41772 #. type: Labeled list
41773 #: ../term-utils/agetty.8.adoc:319
41775 #| msgid "_/etc/fstab_"
41776 msgid "_/etc/inittab_"
41777 msgstr "_/etc/fstab_"
41779 #. type: Plain text
41780 #: ../term-utils/agetty.8.adoc:321
41782 msgid "*init*(8) configuration file for SysV-style init daemon.\n"
41785 #. type: Plain text
41786 #: ../term-utils/agetty.8.adoc:325
41788 msgid "*agetty* supports configuration via systemd credentials (see https://systemd.io/CREDENTIALS/). *agetty* reads the following systemd credentials:\n"
41791 #. type: Labeled list
41792 #: ../term-utils/agetty.8.adoc:326
41794 msgid "*agetty.autologin* (string)"
41797 #. type: Plain text
41798 #: ../term-utils/agetty.8.adoc:329
41800 "If set, configures *agetty* to automatically log in the specified user "
41801 "without asking for a username or password, similarly to the *--autologin* "
41805 #. type: Plain text
41806 #: ../term-utils/agetty.8.adoc:333
41808 "The baud-rate detection feature (the *--extract-baud* option) requires that "
41809 "*agetty* be scheduled soon enough after completion of a dial-in call (within "
41810 "30 ms with modems that talk at 2400 baud). For robustness, always use the *--"
41811 "extract-baud* option in combination with a multiple baud rate command-line "
41812 "argument, so that BREAK processing is enabled."
41815 #. type: Plain text
41816 #: ../term-utils/agetty.8.adoc:335
41818 "The text in the _/etc/issue_ file (or other) and the login prompt are always "
41819 "output with 7-bit characters and space parity."
41822 #. type: Plain text
41823 #: ../term-utils/agetty.8.adoc:337
41825 "The baud-rate detection feature (the *--extract-baud* option) requires that "
41826 "the modem emits its status message _after_ raising the DCD line."
41829 #. type: Plain text
41830 #: ../term-utils/agetty.8.adoc:341
41832 "Depending on how the program was configured, all diagnostics are written to "
41833 "the console device or reported via the *syslog*(3) facility. Error messages "
41834 "are produced if the _port_ argument does not specify a terminal device; if "
41835 "there is no utmp entry for the current process (System V only); and so on."
41838 #. type: Plain text
41839 #: ../term-utils/agetty.8.adoc:346
41840 msgid "mailto:werner@suse.de[Werner Fink], mailto:kzak@redhat.com[Karel Zak]"
41843 #. type: Plain text
41844 #: ../term-utils/agetty.8.adoc:348
41846 "The original *agetty* for serial terminals was written by mailto:wietse@wzv."
41847 "win.tue.nl[W.Z. Venema] and ported to Linux by mailto:poe@daimi.aau.dk[Peter "
41854 #. Copyright (c) 1987, 1990, 1993
41855 #. The Regents of the University of California. All rights reserved.
41856 #. Redistribution and use in source and binary forms, with or without
41857 #. modification, are permitted provided that the following conditions
41859 #. 1. Redistributions of source code must retain the above copyright
41860 #. notice, this list of conditions and the following disclaimer.
41861 #. 2. Redistributions in binary form must reproduce the above copyright
41862 #. notice, this list of conditions and the following disclaimer in the
41863 #. documentation and/or other materials provided with the distribution.
41864 #. 3. All advertising materials mentioning features or use of this software
41865 #. must display the following acknowledgement:
41866 #. This product includes software developed by the University of
41867 #. California, Berkeley and its contributors.
41868 #. 4. Neither the name of the University nor the names of its contributors
41869 #. may be used to endorse or promote products derived from this software
41870 #. without specific prior written permission.
41871 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
41872 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41873 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
41874 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
41875 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
41876 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
41877 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
41878 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
41879 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
41880 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
41882 #. @(#)mesg.1 8.1 (Berkeley) 6/6/93
41884 #: ../term-utils/mesg.1.adoc:36
41889 #. type: Plain text
41890 #: ../term-utils/mesg.1.adoc:46
41891 msgid "mesg - display (or do not display) messages from other users"
41894 #. type: Plain text
41895 #: ../term-utils/mesg.1.adoc:50
41897 msgid "*mesg* [_option_] [*n*|*y*]\n"
41900 #. type: Plain text
41901 #: ../term-utils/mesg.1.adoc:54
41903 "The *mesg* utility is invoked by a user to control write access others have "
41904 "to the terminal device associated with standard error output. If write "
41905 "access is allowed, then programs such as *talk*(1) and *write*(1) may "
41906 "display messages on the terminal."
41909 #. type: Plain text
41910 #: ../term-utils/mesg.1.adoc:56
41912 "Traditionally, write access is allowed by default. However, as users become "
41913 "more conscious of various security risks, there is a trend to remove write "
41914 "access by default, at least for the primary login shell. To make sure your "
41915 "ttys are set the way you want them to be set, *mesg* should be executed in "
41916 "your login scripts."
41919 #. type: Plain text
41920 #: ../term-utils/mesg.1.adoc:58
41922 "The *mesg* utility silently exits with error status 2 if not executed on a "
41923 "terminal. In this case executing *mesg* is pointless. The command line "
41924 "option *--verbose* forces *mesg* to print a warning in this situation. This "
41925 "behaviour has been introduced in version 2.33."
41928 #. type: Plain text
41929 #: ../term-utils/mesg.1.adoc:63
41930 msgid "Disallow messages."
41933 #. type: Labeled list
41934 #: ../term-utils/mesg.1.adoc:64
41939 #. type: Plain text
41940 #: ../term-utils/mesg.1.adoc:66
41941 msgid "Allow messages to be displayed."
41944 #. type: Plain text
41945 #: ../term-utils/mesg.1.adoc:68
41947 "If no arguments are given, *mesg* shows the current message status on "
41948 "standard error output."
41951 #. type: Plain text
41952 #: ../term-utils/mesg.1.adoc:79
41953 msgid "The *mesg* utility exits with one of the following values:"
41956 #. type: Plain text
41957 #: ../term-utils/mesg.1.adoc:82
41958 msgid "Messages are allowed."
41961 #. type: Plain text
41962 #: ../term-utils/mesg.1.adoc:84
41963 msgid "Messages are not allowed."
41966 #. type: Labeled list
41967 #: ../term-utils/mesg.1.adoc:84
41972 #. type: Plain text
41973 #: ../term-utils/mesg.1.adoc:86
41974 msgid "An error has occurred."
41977 #. type: Plain text
41978 #: ../term-utils/mesg.1.adoc:90
41979 msgid "_/dev/[pt]ty*_, _/dev/pts/[0-9]*_"
41982 #. type: Plain text
41983 #: ../term-utils/mesg.1.adoc:95
41986 "*mesg* (I) appears in the UNIX Programmer's Manual.\n"
41987 "It used to invert the current state with no argument before Version 7 AT&T UNIX.\n"
41990 #. type: Plain text
41991 #: ../term-utils/mesg.1.adoc:103
42004 #. Copyright (c) 1980, 1990 Regents of the University of California.
42005 #. All rights reserved.
42006 #. Redistribution and use in source and binary forms, with or without
42007 #. modification, are permitted provided that the following conditions
42009 #. 1. Redistributions of source code must retain the above copyright
42010 #. notice, this list of conditions and the following disclaimer.
42011 #. 2. Redistributions in binary form must reproduce the above copyright
42012 #. notice, this list of conditions and the following disclaimer in the
42013 #. documentation and/or other materials provided with the distribution.
42014 #. 3. All advertising materials mentioning features or use of this software
42015 #. must display the following acknowledgement:
42016 #. This product includes software developed by the University of
42017 #. California, Berkeley and its contributors.
42018 #. 4. Neither the name of the University nor the names of its contributors
42019 #. may be used to endorse or promote products derived from this software
42020 #. without specific prior written permission.
42021 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
42022 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42023 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
42024 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
42025 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
42026 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
42027 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
42028 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
42029 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
42030 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
42032 #. @(#)script.1 6.5 (Berkeley) 7/27/91
42034 #: ../term-utils/script.1.adoc:36
42039 #. type: Plain text
42040 #: ../term-utils/script.1.adoc:47
42041 msgid "script - make typescript of terminal session"
42044 #. type: Plain text
42045 #: ../term-utils/script.1.adoc:51
42047 msgid "*script* [options] [_file_]\n"
42050 #. type: Plain text
42051 #: ../term-utils/script.1.adoc:55
42053 msgid "*script* makes a typescript of everything on your terminal session. The terminal data are stored in raw form to the log file and information about timing to another (optional) structured log file. The timing log file is necessary to replay the session later by *scriptreplay*(1) and to store additional information about the session.\n"
42056 #. type: Plain text
42057 #: ../term-utils/script.1.adoc:57
42059 "Since version 2.35, *script* supports multiple streams and allows the "
42060 "logging of input and output to separate files or all the one file. This "
42061 "version also supports a new timing file which records additional "
42062 "information. The command *scriptreplay --summary* then provides all the "
42066 #. type: Plain text
42067 #: ../term-utils/script.1.adoc:59
42069 "If the argument _file_ or option *--log-out* _file_ is given, *script* saves "
42070 "the dialogue in this _file_. If no filename is given, the dialogue is saved "
42071 "in the file _typescript_."
42074 #. type: Plain text
42075 #: ../term-utils/script.1.adoc:61
42077 "Note that logging input using *--log-in* or *--log-io* may record security-"
42078 "sensitive information as the log file contains all terminal session input (e."
42079 "g., passwords) independently of the terminal echo flag setting."
42082 #. type: Plain text
42083 #: ../term-utils/script.1.adoc:65
42085 "Below, the _size_ argument may be followed by the multiplicative suffixes "
42086 "KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
42087 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
42088 "the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
42092 #. type: Plain text
42093 #: ../term-utils/script.1.adoc:68
42095 "Append the output to _file_ or to _typescript_, retaining the prior contents."
42098 #. type: Plain text
42099 #: ../term-utils/script.1.adoc:71
42101 "Run the _command_ rather than an interactive shell. This makes it easy for a "
42102 "script to capture the output of a program that behaves differently when its "
42103 "stdout is not a tty."
42106 #. type: Labeled list
42107 #: ../term-utils/script.1.adoc:72
42109 msgid "*-E*, *--echo* _when_"
42112 #. type: Plain text
42113 #: ../term-utils/script.1.adoc:74
42115 "This option controls the *ECHO* flag for the slave end of the session's "
42116 "pseudoterminal. The supported modes are _always_, _never_, or _auto_."
42119 #. type: Plain text
42120 #: ../term-utils/script.1.adoc:76
42122 "The default is _auto_ -- in this case, *ECHO* enabled for the pseudoterminal "
42123 "slave; if the current standard input is a terminal, *ECHO* is disabled for "
42124 "it to prevent double echo; if the current standard input is not a terminal "
42125 "(for example pipe: *echo date | script*) then keeping *ECHO* enabled for the "
42126 "pseudoterminal slave enables the standard input data to be viewed on screen "
42127 "while being recorded to session log simultaneously."
42130 #. type: Plain text
42131 #: ../term-utils/script.1.adoc:78
42133 "Note that 'never' mode affects content of the session output log, because "
42134 "users input is not repeated on output."
42137 #. type: Labeled list
42138 #: ../term-utils/script.1.adoc:79
42140 #| msgid "*-V*, *--version*"
42141 msgid "*-e*, *--return*"
42142 msgstr "*-V*, *--version*"
42144 #. TRANSLATORS: Keep {plus} untranslated.
42145 #. type: Plain text
42146 #: ../term-utils/script.1.adoc:81
42148 "Return the exit status of the child process. Uses the same format as bash "
42149 "termination on signal termination (i.e., exit status is 128 {plus} the "
42150 "signal number). The exit status of the child process is always stored in the "
42151 "type script file too."
42154 #. type: Labeled list
42155 #: ../term-utils/script.1.adoc:83
42157 #| msgid "*-f*, *--fast*"
42158 msgid "*-f*, *--flush*"
42159 msgstr "*-f*, *--fast*"
42161 #. type: Plain text
42162 #: ../term-utils/script.1.adoc:85
42164 "Flush output after each write. This is nice for telecooperation: one person "
42165 "does *mkfifo* _foo_; *script -f* _foo_, and another can supervise in real-"
42166 "time what is being done using *cat* _foo_. Note that flush has an impact on "
42167 "performance; it's possible to use *SIGUSR1* to flush logs on demand."
42170 #. type: Labeled list
42171 #: ../term-utils/script.1.adoc:86
42176 #. type: Plain text
42177 #: ../term-utils/script.1.adoc:88
42179 "Allow the default output file _typescript_ to be a hard or symbolic link. "
42180 "The command will follow a symbolic link."
42183 #. type: Labeled list
42184 #: ../term-utils/script.1.adoc:89 ../term-utils/scriptlive.1.adoc:33
42185 #: ../term-utils/scriptreplay.1.adoc:38
42187 #| msgid "*-*, *-l*, *--login*"
42188 msgid "*-B*, *--log-io* _file_"
42189 msgstr "*-*, *-l*, *--login*"
42191 #. type: Plain text
42192 #: ../term-utils/script.1.adoc:91
42194 "Log input and output to the same _file_. Note, this option makes sense only "
42195 "if *--log-timing* is also specified, otherwise it's impossible to separate "
42196 "output and input streams from the log _file_."
42199 #. type: Labeled list
42200 #: ../term-utils/script.1.adoc:92 ../term-utils/scriptlive.1.adoc:30
42201 #: ../term-utils/scriptreplay.1.adoc:32
42203 #| msgid "*-*, *-l*, *--login*"
42204 msgid "*-I*, *--log-in* _file_"
42205 msgstr "*-*, *-l*, *--login*"
42207 #. type: Plain text
42208 #: ../term-utils/script.1.adoc:94
42210 "Log input to the _file_. The log output is disabled if only *--log-in* "
42214 #. type: Plain text
42215 #: ../term-utils/script.1.adoc:96
42217 "Use this logging functionality carefully as it logs all input, including "
42218 "input when terminal has disabled echo flag (for example, password inputs)."
42221 #. type: Labeled list
42222 #: ../term-utils/script.1.adoc:97 ../term-utils/scriptreplay.1.adoc:35
42224 msgid "*-O*, *--log-out* _file_"
42227 #. type: Plain text
42228 #: ../term-utils/script.1.adoc:99
42230 "Log output to the _file_. The default is to log output to the file with name "
42231 "_typescript_ if the option *--log-out* or *--log-in* is not given. The log "
42232 "output is disabled if only *--log-in* specified."
42235 #. type: Labeled list
42236 #: ../term-utils/script.1.adoc:100 ../term-utils/scriptlive.1.adoc:39
42237 #: ../term-utils/scriptreplay.1.adoc:44
42239 msgid "*-T*, *--log-timing* _file_"
42242 #. type: Plain text
42243 #: ../term-utils/script.1.adoc:102
42245 "Log timing information to the _file_. Two timing file formats are supported "
42246 "now. The classic format is used when only one stream (input or output) "
42247 "logging is enabled. The multi-stream format is used on *--log-io* or when *--"
42248 "log-in* and *--log-out* are used together. See also *--logging-format*."
42251 #. type: Labeled list
42252 #: ../term-utils/script.1.adoc:103
42254 msgid "*-m*, *--logging-format* _format_"
42257 #. type: Plain text
42258 #: ../term-utils/script.1.adoc:105
42260 "Force use of _advanced_ or _classic_ timing log format. The default is the "
42261 "classic format to log only output and the advanced format when input as well "
42262 "as output logging is requested."
42265 #. type: Labeled list
42266 #: ../term-utils/script.1.adoc:106
42268 msgid "*Classic format*"
42271 #. type: Plain text
42272 #: ../term-utils/script.1.adoc:108
42274 "The timing log contains two fields, separated by a space. The first field "
42275 "indicates how much time elapsed since the previous output. The second field "
42276 "indicates how many characters were output this time."
42279 #. type: Labeled list
42280 #: ../term-utils/script.1.adoc:109
42282 msgid "*Advanced (multi-stream) format*"
42285 #. type: Plain text
42286 #: ../term-utils/script.1.adoc:111
42288 "The first field is an entry type identifier ('I'nput, 'O'utput, 'H'eader, "
42289 "'S'ignal). The second field is how much time elapsed since the previous "
42290 "entry, and the rest of the entry is type-specific data."
42293 #. type: Labeled list
42294 #: ../term-utils/script.1.adoc:112
42296 msgid "*-o*, *--output-limit* _size_"
42299 #. type: Plain text
42300 #: ../term-utils/script.1.adoc:114
42302 "Limit the size of the typescript and timing files to _size_ and stop the "
42303 "child process after this size is exceeded. The calculated file size does not "
42304 "include the start and done messages that the *script* command prepends and "
42305 "appends to the child process output. Due to buffering, the resulting output "
42306 "file might be larger than the specified value."
42309 #. type: Plain text
42310 #: ../term-utils/script.1.adoc:117
42311 msgid "Be quiet (do not write start and done messages to standard output)."
42314 #. type: Labeled list
42315 #: ../term-utils/script.1.adoc:118
42317 msgid "*-t*[_file_], *--timing*[=_file_]"
42320 #. type: Plain text
42321 #: ../term-utils/script.1.adoc:120
42323 "Output timing data to standard error, or to _file_ when given. This option "
42324 "is deprecated in favour of *--log-timing* where the _file_ argument is not "
42328 #. type: Plain text
42329 #: ../term-utils/script.1.adoc:126
42331 "Upon receiving *SIGUSR1*, *script* immediately flushes the output files."
42334 #. type: Plain text
42335 #: ../term-utils/script.1.adoc:130
42336 msgid "The following environment variable is utilized by *script*:"
42339 #. type: Labeled list
42340 #: ../term-utils/script.1.adoc:131 ../text-utils/more.1.adoc:171
42341 #: ../text-utils/pg.1.adoc:130
42346 #. type: Plain text
42347 #: ../term-utils/script.1.adoc:133
42349 "If the variable *SHELL* exists, the shell forked by *script* will be that "
42350 "shell. If *SHELL* is not set, the Bourne shell is assumed. (Most shells set "
42351 "this variable automatically)."
42354 #. type: Plain text
42355 #: ../term-utils/script.1.adoc:137
42357 "The script ends when the forked shell exits (a _control-D_ for the Bourne "
42358 "shell (*sh*(1p)), and _exit_, _logout_ or _control-d_ (if _ignoreeof_ is not "
42359 "set) for the C-shell, *csh*(1))."
42362 #. type: Plain text
42363 #: ../term-utils/script.1.adoc:139
42365 "Certain interactive commands, such as *vi*(1), create garbage in the "
42366 "typescript file. *script* works best with commands that do not manipulate "
42367 "the screen, the results are meant to emulate a hardcopy terminal."
42370 #. type: Plain text
42371 #: ../term-utils/script.1.adoc:141
42373 "It is not recommended to run *script* in non-interactive shells. The inner "
42374 "shell of *script* is always interactive, and this could lead to unexpected "
42375 "results. If you use *script* in the shell initialization file, you have to "
42376 "avoid entering an infinite loop. You can use for example the *.profile* "
42377 "file, which is read by login shells only:"
42380 #. type: delimited block .
42381 #: ../term-utils/script.1.adoc:147
42384 "if test -t 0 ; then\n"
42390 #. type: Plain text
42391 #: ../term-utils/script.1.adoc:150
42393 "You should also avoid use of *script* in command pipes, as *script* can read "
42394 "more input than you would expect."
42397 #. type: Plain text
42398 #: ../term-utils/script.1.adoc:154
42400 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
42401 msgid "The *script* command appeared in 3.0BSD."
42402 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
42404 #. type: Plain text
42405 #: ../term-utils/script.1.adoc:158
42407 msgid "*script* places _everything_ in the log file, including linefeeds and backspaces. This is not what the naive user expects.\n"
42410 #. type: Plain text
42411 #: ../term-utils/script.1.adoc:160
42413 msgid "*script* is primarily designed for interactive terminal sessions. When stdin is not a terminal (for example: *echo foo | script*), then the session can hang, because the interactive shell within the script session misses EOF and *script* has no clue when to close the session. See the *NOTES* section for more information.\n"
42416 #. type: Plain text
42417 #: ../term-utils/script.1.adoc:166
42420 "*csh*(1) (for the _history_ mechanism),\n"
42421 "*scriptreplay*(1),\n"
42422 "*scriptlive*(1)\n"
42430 #: ../term-utils/scriptlive.1.adoc:2
42432 #| msgid "write(1)"
42433 msgid "scriptlive(1)"
42436 #. type: Plain text
42437 #: ../term-utils/scriptlive.1.adoc:13
42438 msgid "scriptlive - re-run session typescripts, using timing information"
42441 #. type: Plain text
42442 #: ../term-utils/scriptlive.1.adoc:17
42444 msgid "*scriptlive* [options] [*-t*] _timingfile_ [*-I*|*-B*] _typescript_\n"
42447 #. type: Plain text
42448 #: ../term-utils/scriptlive.1.adoc:21
42450 "This program re-runs a typescript, using stdin typescript and timing "
42451 "information to ensure that input happens in the same rhythm as it originally "
42452 "appeared when the script was recorded."
42455 #. type: Plain text
42456 #: ../term-utils/scriptlive.1.adoc:23
42458 "The *session is executed* in a newly created pseudoterminal with the user's "
42459 "$SHELL (or defaults to _/bin/bash_)."
42462 #. type: Plain text
42463 #: ../term-utils/scriptlive.1.adoc:25
42465 msgid "*Be careful!* Do not forget that the typescript may contains arbitrary commands. It is recommended to use *\"scriptreplay --stream in --log-in typescript\"* (or with *--log-io* instead of *--log-in*) to verify the typescript before it is executed by *scriptlive*.\n"
42468 #. type: Plain text
42469 #: ../term-utils/scriptlive.1.adoc:27
42471 "The timing information is what *script*(1) outputs to file specified by *--"
42472 "log-timing*. The typescript has to contain stdin information and it is what "
42473 "script1 outputs to file specified by *--log-in* or *--log-io*."
42476 #. type: Plain text
42477 #: ../term-utils/scriptlive.1.adoc:32 ../term-utils/scriptreplay.1.adoc:34
42478 msgid "File containing *script*'s terminal input."
42481 #. type: Plain text
42482 #: ../term-utils/scriptlive.1.adoc:35 ../term-utils/scriptreplay.1.adoc:40
42483 msgid "File containing *script*'s terminal output and input."
42486 #. type: Labeled list
42487 #: ../term-utils/scriptlive.1.adoc:36 ../term-utils/scriptreplay.1.adoc:41
42489 msgid "*-t*, *--timing* _file_"
42492 #. type: Plain text
42493 #: ../term-utils/scriptlive.1.adoc:38 ../term-utils/scriptreplay.1.adoc:43
42495 "File containing *script*'s timing output. This option overrides old-style "
42499 #. type: Plain text
42500 #: ../term-utils/scriptlive.1.adoc:41
42502 "Aliased to *-t*, maintained for compatibility with *script*(1) command-line "
42506 #. type: Plain text
42507 #: ../term-utils/scriptlive.1.adoc:44 ../term-utils/scriptreplay.1.adoc:55
42509 "Speed up the replay displaying this _number_ of times. The argument is a "
42510 "floating-point number. It's called divisor because it divides the timings by "
42511 "this factor. This option overrides old-style arguments."
42514 #. type: Labeled list
42515 #: ../term-utils/scriptlive.1.adoc:45 ../term-utils/scriptreplay.1.adoc:56
42517 msgid "*-m*, *--maxdelay* _number_"
42520 #. type: Plain text
42521 #: ../term-utils/scriptlive.1.adoc:47 ../term-utils/scriptreplay.1.adoc:58
42523 "Set the maximum delay between updates to _number_ of seconds. The argument "
42524 "is a floating-point number. This can be used to avoid long pauses in the "
42525 "typescript replay."
42528 #. type: delimited block .
42529 #: ../term-utils/scriptlive.1.adoc:60
42532 "% script --log-timing file.tm --log-in script.in\n"
42533 "Script started, file is script.out\n"
42537 "Script done, file is script.out\n"
42538 "% scriptlive --log-timing file.tm --log-in script.in\n"
42541 #. TRANSLATORS: Keep {copyright} untranslated.
42542 #. type: Plain text
42543 #: ../term-utils/scriptlive.1.adoc:70
42544 msgid "Copyright {copyright} 2019 Karel Zak"
42547 #. type: Plain text
42548 #: ../term-utils/scriptlive.1.adoc:72 ../term-utils/scriptreplay.1.adoc:92
42550 "This is free software; see the source for copying conditions. There is NO "
42551 "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
42554 #. type: Plain text
42555 #: ../term-utils/scriptlive.1.adoc:74 ../term-utils/scriptreplay.1.adoc:94
42556 msgid "Released under the GNU General Public License version 2 or later."
42559 #. type: Plain text
42560 #: ../term-utils/scriptlive.1.adoc:79
42564 "*scriptreplay*(1)\n"
42568 #: ../term-utils/scriptreplay.1.adoc:2
42570 msgid "scriptreplay(1)"
42573 #. type: Plain text
42574 #: ../term-utils/scriptreplay.1.adoc:13
42575 msgid "scriptreplay - play back typescripts, using timing information"
42578 #. type: Plain text
42579 #: ../term-utils/scriptreplay.1.adoc:17
42581 msgid "*scriptreplay* [options] [*-t*] _timingfile_ [_typescript_ [_divisor_]]\n"
42584 #. type: Plain text
42585 #: ../term-utils/scriptreplay.1.adoc:21
42587 "This program replays a typescript, using timing information to ensure that "
42588 "output happens in the same rhythm as it originally appeared when the script "
42592 #. type: Plain text
42593 #: ../term-utils/scriptreplay.1.adoc:23
42595 "The replay simply displays the information again; the programs that were run "
42596 "when the typescript was being recorded are *not run again*. Since the same "
42597 "information is simply being displayed, *scriptreplay* is only guaranteed to "
42598 "work properly if run on the same type of terminal the typescript was "
42599 "recorded on. Otherwise, any escape characters in the typescript may be "
42600 "interpreted differently by the terminal to which *scriptreplay* is sending "
42604 #. type: Plain text
42605 #: ../term-utils/scriptreplay.1.adoc:25
42607 "The timing information is what *script*(1) outputs to file specified by *--"
42611 #. type: Plain text
42612 #: ../term-utils/scriptreplay.1.adoc:27
42614 "By default, the typescript to display is assumed to be named _typescript_, "
42615 "but other filenames may be specified, as the second parameter or with option "
42619 #. type: Plain text
42620 #: ../term-utils/scriptreplay.1.adoc:29
42622 "If the third parameter or *--divisor* is specified, it is used as a speed-up "
42623 "multiplier. For example, a speed-up of 2 makes *scriptreplay* go twice as "
42624 "fast, and a speed-down of 0.1 makes it go ten times slower than the original "
42628 #. type: Plain text
42629 #: ../term-utils/scriptreplay.1.adoc:37
42630 msgid "File containing *script*'s terminal output."
42633 #. type: Plain text
42634 #: ../term-utils/scriptreplay.1.adoc:46
42636 "This is an alias for *-t*, maintained for compatibility with *script*(1) "
42637 "command-line options."
42640 #. type: Labeled list
42641 #: ../term-utils/scriptreplay.1.adoc:47
42643 msgid "*-s*, *--typescript* _file_"
42646 #. type: Plain text
42647 #: ../term-utils/scriptreplay.1.adoc:49
42649 "File containing *script*'s terminal output. Deprecated alias to *--log-out*. "
42650 "This option overrides old-style arguments."
42653 #. type: Labeled list
42654 #: ../term-utils/scriptreplay.1.adoc:50
42656 #| msgid "*-c*, **--command**=__command__"
42657 msgid "*-c*, *--cr-mode* _mode_"
42658 msgstr "*-c*, **--command**=__příkaz__"
42660 #. type: Plain text
42661 #: ../term-utils/scriptreplay.1.adoc:52
42663 "Specifies how to use the CR (0x0D, carriage return) character from log "
42664 "files. The default mode is _auto_, in this case CR is replaced with line "
42665 "break for stdin log, because otherwise *scriptreplay* would overwrite the "
42666 "same line. The other modes are _never_ and _always_."
42669 #. type: Labeled list
42670 #: ../term-utils/scriptreplay.1.adoc:59
42672 msgid "*--summary*"
42675 #. type: Plain text
42676 #: ../term-utils/scriptreplay.1.adoc:61
42678 "Display details about the session recorded in the specified timing file and "
42679 "exit. The session has to be recorded using _advanced_ format (see "
42680 "*script*(1) option *--logging-format* for more details)."
42683 #. type: Labeled list
42684 #: ../term-utils/scriptreplay.1.adoc:62
42686 msgid "*-x*, *--stream* _type_"
42689 #. type: Plain text
42690 #: ../term-utils/scriptreplay.1.adoc:64
42692 "Forces *scriptreplay* to print only the specified stream. The supported "
42693 "stream types are _in_, _out_, _signal_, or _info_. This option is "
42694 "recommended for multi-stream logs (e.g., *--log-io*) in order to print only "
42698 #. type: delimited block .
42699 #: ../term-utils/scriptreplay.1.adoc:77
42702 "% script --log-timing file.tm --log-out script.out\n"
42703 "Script started, file is script.out\n"
42707 "Script done, file is script.out\n"
42708 "% scriptreplay --log-timing file.tm --log-out script.out\n"
42711 #. type: Plain text
42712 #: ../term-utils/scriptreplay.1.adoc:82
42714 "The original *scriptreplay* program was written by mailto:joey@kitenet."
42715 "net[Joey Hess]. The program was re-written in C by mailto:jay@gnu.org[James "
42716 "Youngman] and mailto:kzak@redhat.com[Karel Zak]"
42719 #. TRANSLATORS: Keep {copyright} untranslated.
42720 #. type: Plain text
42721 #: ../term-utils/scriptreplay.1.adoc:87
42722 msgid "Copyright {copyright} 2008 James Youngman"
42725 #. TRANSLATORS: Keep {copyright} untranslated.
42726 #. type: Plain text
42727 #: ../term-utils/scriptreplay.1.adoc:90
42728 msgid "Copyright {copyright} 2008-2019 Karel Zak"
42731 #. type: Plain text
42732 #: ../term-utils/scriptreplay.1.adoc:99
42736 "*scriptlive*(1)\n"
42739 #. Copyright 1990 Gordon Irlam (gordoni@cs.ua.oz.au)
42740 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
42741 #. Copyright 2000 Colin Watson (cjw44@cam.ac.uk)
42742 #. Do not restrict distribution.
42743 #. May be distributed under the GNU General Public License
42745 #: ../term-utils/setterm.1.adoc:9
42750 #. type: Plain text
42751 #: ../term-utils/setterm.1.adoc:19
42752 msgid "setterm - set terminal attributes"
42755 #. type: Plain text
42756 #: ../term-utils/setterm.1.adoc:23
42758 msgid "*setterm* [options]\n"
42761 #. type: Plain text
42762 #: ../term-utils/setterm.1.adoc:27
42764 msgid "*setterm* writes to standard output a character string that will invoke the specified terminal capabilities. Where possible _terminfo_ is consulted to find the string to use. Some options however (marked \"virtual consoles only\" below) do not correspond to a *terminfo*(5) capability. In this case, if the terminal type is \"con\" or \"linux\" the string that invokes the specified capabilities on the PC Minix virtual console driver is output. Options that are not implemented by the terminal are ignored.\n"
42767 #. type: Plain text
42768 #: ../term-utils/setterm.1.adoc:31
42769 msgid "For boolean options (*on* or *off*), the default is *on*."
42772 #. type: Plain text
42773 #: ../term-utils/setterm.1.adoc:33
42775 "Below, an _8-color_ can be *black*, *red*, *green*, *yellow*, *blue*, "
42776 "*magenta*, *cyan*, or *white*."
42779 #. type: Plain text
42780 #: ../term-utils/setterm.1.adoc:35
42782 "A _16-color_ can be an _8-color_, or *grey*, or *bright* followed by *red*, "
42783 "*green*, *yellow*, *blue*, *magenta*, *cyan*, or *white*."
42786 #. type: Plain text
42787 #: ../term-utils/setterm.1.adoc:37
42789 "The various color options may be set independently, at least on virtual "
42790 "consoles, though the results of setting multiple modes (for example, *--"
42791 "underline* and *--half-bright*) are hardware-dependent."
42794 #. type: Plain text
42795 #: ../term-utils/setterm.1.adoc:39
42797 "The optional arguments are recommended with '=' (equals sign) and not space "
42798 "between the option and the argument. For example --option=argument. "
42799 "*setterm* can interpret the next non-option argument as an optional argument "
42803 #. type: Labeled list
42804 #: ../term-utils/setterm.1.adoc:40
42806 msgid "*--appcursorkeys* on|off"
42809 #. type: Plain text
42810 #: ../term-utils/setterm.1.adoc:42
42812 "Sets Cursor Key Application Mode on or off. When on, ESC O A, ESC O B, etc. "
42813 "will be sent for the cursor keys instead of ESC [ A, ESC [ B, etc. See the "
42814 "_vi and Cursor-Keys_ section of the _Text-Terminal-HOWTO_ for how this can "
42815 "cause problems for *vi* users. Virtual consoles only."
42818 #. type: Labeled list
42819 #: ../term-utils/setterm.1.adoc:43
42821 msgid "*--append* _console_number_"
42824 #. type: Plain text
42825 #: ../term-utils/setterm.1.adoc:45
42827 "Like *--dump*, but appends to the snapshot file instead of overwriting it. "
42828 "Only works if no *--dump* options are given."
42831 #. type: Labeled list
42832 #: ../term-utils/setterm.1.adoc:46
42834 msgid "*--background* __8-color__|default"
42837 #. type: Plain text
42838 #: ../term-utils/setterm.1.adoc:48
42839 msgid "Sets the background text color."
42842 #. type: Labeled list
42843 #: ../term-utils/setterm.1.adoc:49
42845 msgid "*--blank*[=0-60|force|poke]"
42848 #. type: Plain text
42849 #: ../term-utils/setterm.1.adoc:51
42851 "Sets the interval of inactivity, in minutes, after which the screen will be "
42852 "automatically blanked (using APM if available). Without an argument, it gets "
42853 "the blank status (returns which vt was blanked, or zero for an unblanked "
42854 "vt). Virtual consoles only."
42857 #. type: Plain text
42858 #: ../term-utils/setterm.1.adoc:53
42859 msgid "The *force* argument keeps the screen blank even if a key is pressed."
42862 #. type: Plain text
42863 #: ../term-utils/setterm.1.adoc:55
42864 msgid "The *poke* argument unblanks the screen."
42867 #. type: Labeled list
42868 #: ../term-utils/setterm.1.adoc:56
42870 msgid "*--bfreq*[=_number_]"
42873 #. type: Plain text
42874 #: ../term-utils/setterm.1.adoc:58
42876 "Sets the bell frequency in Hertz. Without an argument, it defaults to *0*. "
42877 "Virtual consoles only."
42880 #. type: Labeled list
42881 #: ../term-utils/setterm.1.adoc:59
42883 msgid "*--blength*[=0-2000]"
42886 #. type: Plain text
42887 #: ../term-utils/setterm.1.adoc:61
42889 "Sets the bell duration in milliseconds. Without an argument, it defaults to "
42890 "*0*. Virtual consoles only."
42893 #. type: Labeled list
42894 #: ../term-utils/setterm.1.adoc:62
42896 msgid "*--blink* on|off"
42899 #. type: Plain text
42900 #: ../term-utils/setterm.1.adoc:64
42902 "Turns blink mode on or off. Except on a virtual console, *--blink off* turns "
42903 "off all attributes (bold, half-brightness, blink, reverse)."
42906 #. type: Labeled list
42907 #: ../term-utils/setterm.1.adoc:65
42909 msgid "*--bold* on|off"
42912 #. type: Plain text
42913 #: ../term-utils/setterm.1.adoc:67
42915 "urns bold (extra bright) mode on or off. Except on a virtual console, *--"
42916 "bold off* turns off all attributes (bold, half-brightness, blink, reverse)."
42919 #. type: Labeled list
42920 #: ../term-utils/setterm.1.adoc:68
42922 msgid "*--clear*[=all|rest]"
42925 #. type: Plain text
42926 #: ../term-utils/setterm.1.adoc:70
42928 "Without an argument or with the argument *all*, the entire screen is cleared "
42929 "and the cursor is set to the home position, just like *clear*(1) does. With "
42930 "the argument *rest*, the screen is cleared from the current cursor position "
42934 #. type: Labeled list
42935 #: ../term-utils/setterm.1.adoc:71
42937 msgid "*--clrtabs*[=_tab1 tab2 tab3_ ...]"
42940 #. type: Plain text
42941 #: ../term-utils/setterm.1.adoc:73
42943 "Clears tab stops from the given horizontal cursor positions, in the range "
42944 "*1-160*. Without arguments, it clears all tab stops. Virtual consoles only."
42947 #. type: Labeled list
42948 #: ../term-utils/setterm.1.adoc:74
42950 msgid "*--cursor* on|off"
42953 #. type: Plain text
42954 #: ../term-utils/setterm.1.adoc:76
42955 msgid "Turns the terminal's cursor on or off."
42958 #. type: Labeled list
42959 #: ../term-utils/setterm.1.adoc:77
42961 #| msgid "*defaults*"
42962 msgid "*--default*"
42963 msgstr "*defaults*"
42965 #. type: Plain text
42966 #: ../term-utils/setterm.1.adoc:79
42967 msgid "Sets the terminal's rendering options to the default values."
42970 #. type: Labeled list
42971 #: ../term-utils/setterm.1.adoc:80
42973 msgid "*--dump*[=_console_number_]"
42976 #. type: Plain text
42977 #: ../term-utils/setterm.1.adoc:82
42979 "Writes a snapshot of the virtual console with the given number to the file "
42980 "specified with the *--file* option, overwriting its contents; the default is "
42981 "_screen.dump_. Without an argument, it dumps the current virtual console. "
42982 "This overrides *--append*."
42985 #. type: Labeled list
42986 #: ../term-utils/setterm.1.adoc:83
42988 msgid "*--file* _filename_"
42991 #. type: Plain text
42992 #: ../term-utils/setterm.1.adoc:85
42994 "Sets the snapshot file name for any *--dump* or *--append* options on the "
42995 "same command line. If this option is not present, the default is _screen."
42996 "dump_ in the current directory. A path name that exceeds the system maximum "
42997 "will be truncated, see *PATH_MAX* from _linux/limits.h_ for the value."
43000 #. type: Labeled list
43001 #: ../term-utils/setterm.1.adoc:86
43003 msgid "*--foreground* __8-color__|default"
43006 #. type: Plain text
43007 #: ../term-utils/setterm.1.adoc:88
43008 msgid "Sets the foreground text color."
43011 #. type: Labeled list
43012 #: ../term-utils/setterm.1.adoc:89
43014 msgid "*--half-bright* on|off"
43017 #. type: Plain text
43018 #: ../term-utils/setterm.1.adoc:91
43020 "Turns dim (half-brightness) mode on or off. Except on a virtual console, *--"
43021 "half-bright off* turns off all attributes (bold, half-brightness, blink, "
43025 #. type: Labeled list
43026 #: ../term-utils/setterm.1.adoc:92
43028 msgid "*--hbcolor* _16-color_"
43031 #. type: Plain text
43032 #: ../term-utils/setterm.1.adoc:94
43033 msgid "Sets the color for half-bright characters."
43036 #. type: Labeled list
43037 #: ../term-utils/setterm.1.adoc:95
43039 msgid "*--initialize*"
43042 #. type: Plain text
43043 #: ../term-utils/setterm.1.adoc:97
43045 "Displays the terminal initialization string, which typically sets the "
43046 "terminal's rendering options, and other attributes to the default values."
43049 #. type: Labeled list
43050 #: ../term-utils/setterm.1.adoc:98
43052 msgid "*--inversescreen* on|off"
43055 #. type: Plain text
43056 #: ../term-utils/setterm.1.adoc:100
43057 msgid "Swaps foreground and background colors for the whole screen."
43060 #. type: Labeled list
43061 #: ../term-utils/setterm.1.adoc:101
43063 msgid "*--linewrap* on|off"
43066 #. type: Plain text
43067 #: ../term-utils/setterm.1.adoc:103
43068 msgid "Makes the terminal continue on a new line when a line is full."
43071 #. type: Labeled list
43072 #: ../term-utils/setterm.1.adoc:104
43074 msgid "*--msg* on|off"
43077 #. type: Plain text
43078 #: ../term-utils/setterm.1.adoc:106
43080 "Enables or disables the sending of kernel *printk*() messages to the "
43081 "console. Virtual consoles only."
43084 #. type: Labeled list
43085 #: ../term-utils/setterm.1.adoc:107
43087 msgid "*--msglevel* 0-8"
43090 #. type: Plain text
43091 #: ../term-utils/setterm.1.adoc:109
43093 "Sets the console logging level for kernel *printk()* messages. All messages "
43094 "strictly more important than this will be printed, so a logging level of *0* "
43095 "has the same effect as *--msg on* and a logging level of *8* will print all "
43096 "kernel messages. *klogd*(8) may be a more convenient interface to the "
43097 "logging of kernel messages."
43100 #. type: Plain text
43101 #: ../term-utils/setterm.1.adoc:111
43102 msgid "Virtual consoles only."
43105 #. type: Labeled list
43106 #: ../term-utils/setterm.1.adoc:112
43108 msgid "*--powerdown*[=0-60]"
43111 #. type: Plain text
43112 #: ../term-utils/setterm.1.adoc:114
43114 "Sets the VESA powerdown interval in minutes. Without an argument, it "
43115 "defaults to *0* (disable powerdown). If the console is blanked or the "
43116 "monitor is in suspend mode, then the monitor will go into vsync suspend mode "
43117 "or powerdown mode respectively after this period of time has elapsed."
43120 #. type: Labeled list
43121 #: ../term-utils/setterm.1.adoc:115
43123 msgid "*--powersave* _mode_"
43126 #. type: Plain text
43127 #: ../term-utils/setterm.1.adoc:117
43128 msgid "Valid values for _mode_ are:"
43131 #. type: Labeled list
43132 #: ../term-utils/setterm.1.adoc:118
43137 #. type: Plain text
43138 #: ../term-utils/setterm.1.adoc:120
43139 msgid "Puts the monitor into VESA vsync suspend mode."
43142 #. type: Labeled list
43143 #: ../term-utils/setterm.1.adoc:120
43148 #. type: Plain text
43149 #: ../term-utils/setterm.1.adoc:122
43150 msgid "Puts the monitor into VESA hsync suspend mode."
43153 #. type: Labeled list
43154 #: ../term-utils/setterm.1.adoc:122
43156 msgid "*powerdown*"
43159 #. type: Plain text
43160 #: ../term-utils/setterm.1.adoc:124
43161 msgid "Puts the monitor into VESA powerdown mode."
43164 #. type: Plain text
43165 #: ../term-utils/setterm.1.adoc:126
43166 msgid "Turns monitor VESA powersaving features."
43169 #. type: Labeled list
43170 #: ../term-utils/setterm.1.adoc:127
43172 msgid "*--regtabs*[=1-160]"
43175 #. type: Plain text
43176 #: ../term-utils/setterm.1.adoc:129
43178 "Clears all tab stops, then sets a regular tab stop pattern, with one tab "
43179 "every specified number of positions. Without an argument, it defaults to "
43180 "*8*. Virtual consoles only."
43183 #. type: Labeled list
43184 #: ../term-utils/setterm.1.adoc:130
43186 msgid "*--repeat* on|off"
43189 #. type: Plain text
43190 #: ../term-utils/setterm.1.adoc:132
43191 msgid "Turns keyboard repeat on or off. Virtual consoles only."
43194 #. type: Labeled list
43195 #: ../term-utils/setterm.1.adoc:133
43200 #. type: Plain text
43201 #: ../term-utils/setterm.1.adoc:135
43203 "Displays the terminal reset string, which typically resets the terminal to "
43204 "its power-on state."
43207 #. type: Labeled list
43208 #: ../term-utils/setterm.1.adoc:136
43213 #. type: Plain text
43214 #: ../term-utils/setterm.1.adoc:138
43216 "Reset terminal size by assessing maximum row and column. This is useful when "
43217 "actual geometry and kernel terminal driver are not in sync. Most notable use "
43218 "case is with serial consoles, that do not use *ioctl*(2) but just byte "
43219 "streams and breaks."
43222 #. type: Labeled list
43223 #: ../term-utils/setterm.1.adoc:139
43225 msgid "*--reverse* on|off"
43228 #. type: Plain text
43229 #: ../term-utils/setterm.1.adoc:141
43231 "Turns reverse video mode on or off. Except on a virtual console, *--reverse "
43232 "off* turns off all attributes (bold, half-brightness, blink, reverse)."
43235 #. type: Labeled list
43236 #: ../term-utils/setterm.1.adoc:142
43241 #. type: Plain text
43242 #: ../term-utils/setterm.1.adoc:144
43244 "Stores the terminal's current rendering options (foreground and background "
43245 "colors) as the values to be used at reset-to-default. Virtual consoles only."
43248 #. type: Labeled list
43249 #: ../term-utils/setterm.1.adoc:145
43251 msgid "*--tabs*[=_tab1 tab2 tab3_ ...]"
43254 #. type: Plain text
43255 #: ../term-utils/setterm.1.adoc:147
43257 "Sets tab stops at the given horizontal cursor positions, in the range "
43258 "*1-160*. Without arguments, it shows the current tab stop settings."
43261 #. type: Labeled list
43262 #: ../term-utils/setterm.1.adoc:148
43264 msgid "*--term* _terminal_name_"
43267 #. type: Plain text
43268 #: ../term-utils/setterm.1.adoc:150
43269 msgid "Overrides the *TERM* environment variable."
43272 #. type: Labeled list
43273 #: ../term-utils/setterm.1.adoc:151
43275 msgid "*--ulcolor* _16-color_"
43278 #. type: Plain text
43279 #: ../term-utils/setterm.1.adoc:153
43280 msgid "Sets the color for underlined characters. Virtual consoles only."
43283 #. type: Labeled list
43284 #: ../term-utils/setterm.1.adoc:154
43286 msgid "*--underline* on|off"
43289 #. type: Plain text
43290 #: ../term-utils/setterm.1.adoc:156
43291 msgid "Turns underline mode on or off."
43294 #. type: Plain text
43295 #: ../term-utils/setterm.1.adoc:162
43297 "Since version 2.25 *setterm* has support for long options with two hyphens, "
43298 "for example *--help*, beside the historical long options with a single "
43299 "hyphen, for example *-help*. In scripts it is better to use the backward-"
43300 "compatible single hyphen rather than the double hyphen. Currently there are "
43301 "no plans nor good reasons to discontinue single-hyphen compatibility."
43304 #. type: Plain text
43305 #: ../term-utils/setterm.1.adoc:166
43306 msgid "Differences between the Minix and Linux versions are not documented."
43309 #. type: Plain text
43310 #: ../term-utils/setterm.1.adoc:173
43323 #. Copyright (c) 1989, 1990 The Regents of the University of California.
43324 #. All rights reserved.
43325 #. Redistribution and use in source and binary forms, with or without
43326 #. modification, are permitted provided that the following conditions
43328 #. 1. Redistributions of source code must retain the above copyright
43329 #. notice, this list of conditions and the following disclaimer.
43330 #. 2. Redistributions in binary form must reproduce the above copyright
43331 #. notice, this list of conditions and the following disclaimer in the
43332 #. documentation and/or other materials provided with the distribution.
43333 #. 3. All advertising materials mentioning features or use of this software
43334 #. must display the following acknowledgement:
43335 #. This product includes software developed by the University of
43336 #. California, Berkeley and its contributors.
43337 #. 4. Neither the name of the University nor the names of its contributors
43338 #. may be used to endorse or promote products derived from this software
43339 #. without specific prior written permission.
43340 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43341 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43342 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43343 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43344 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43345 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43346 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43347 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43348 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43349 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43351 #. @(#)wall.1 6.5 (Berkeley) 4/23/91
43353 #: ../term-utils/wall.1.adoc:37
43358 #. type: Plain text
43359 #: ../term-utils/wall.1.adoc:47
43361 #| msgid "write - send a message to another user"
43362 msgid "wall - write a message to all users"
43363 msgstr "write - pošle zprávu jinému uživateli"
43365 #. type: Plain text
43366 #: ../term-utils/wall.1.adoc:51
43368 msgid "*wall* [*-n*] [*-t* _timeout_] [*-g* _group_] [_message_ | _file_]\n"
43371 #. type: Plain text
43372 #: ../term-utils/wall.1.adoc:55
43374 msgid "*wall* displays a _message_, or the contents of a _file_, or otherwise its standard input, on the terminals of all currently logged in users. The command will wrap lines that are longer than 79 characters. Short lines are whitespace padded to have 79 characters. The command will always put a carriage return and new line at the end of each line.\n"
43377 #. type: Plain text
43378 #: ../term-utils/wall.1.adoc:57
43380 "Only the superuser can write on the terminals of users who have chosen to "
43381 "deny messages or are using a program which automatically denies messages."
43384 #. type: Plain text
43385 #: ../term-utils/wall.1.adoc:59
43387 "Reading from a _file_ is refused when the invoker is not superuser and the "
43388 "program is set-user-ID or set-group-ID."
43391 #. type: Labeled list
43392 #: ../term-utils/wall.1.adoc:62
43394 #| msgid "*-V*, *--version*"
43395 msgid "*-n*, *--nobanner*"
43396 msgstr "*-V*, *--version*"
43398 #. type: Plain text
43399 #: ../term-utils/wall.1.adoc:64
43400 msgid "Suppress the banner."
43403 #. type: Plain text
43404 #: ../term-utils/wall.1.adoc:67
43406 "Abandon the write attempt to the terminals after _timeout_ seconds. This "
43407 "_timeout_ must be a positive integer. The default value is 300 seconds, "
43408 "which is a legacy from the time when people ran terminals over modem lines."
43411 #. type: Labeled list
43412 #: ../term-utils/wall.1.adoc:68
43414 #| msgid "*-g*, **--group**=__group__"
43415 msgid "*-g*, *--group* _group_"
43416 msgstr "*-g*, **--group**=__skupina__"
43418 #. type: Plain text
43419 #: ../term-utils/wall.1.adoc:70
43421 "Limit printing message to members of group defined as a _group_ argument. "
43422 "The argument can be group name or GID."
43425 #. type: Plain text
43426 #: ../term-utils/wall.1.adoc:76
43428 "Some sessions, such as *wdm*(1x), that have in the beginning of *utmp*(5) "
43429 "ut_type data a ':' character will not get the message from *wall*. This is "
43430 "done to avoid write errors."
43433 #. type: Plain text
43434 #: ../term-utils/wall.1.adoc:80
43436 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
43437 msgid "A *wall* command appeared in Version 7 AT&T UNIX."
43438 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
43440 #. type: Plain text
43441 #: ../term-utils/wall.1.adoc:87
43461 #. Copyright (c) 1989, 1993
43462 #. The Regents of the University of California. All rights reserved.
43463 #. This code is derived from software contributed to Berkeley by
43464 #. Jef Poskanzer and Craig Leres of the Lawrence Berkeley Laboratory.
43465 #. Redistribution and use in source and binary forms, with or without
43466 #. modification, are permitted provided that the following conditions
43468 #. 1. Redistributions of source code must retain the above copyright
43469 #. notice, this list of conditions and the following disclaimer.
43470 #. 2. Redistributions in binary form must reproduce the above copyright
43471 #. notice, this list of conditions and the following disclaimer in the
43472 #. documentation and/or other materials provided with the distribution.
43473 #. 3. All advertising materials mentioning features or use of this software
43474 #. must display the following acknowledgement:
43475 #. This product includes software developed by the University of
43476 #. California, Berkeley and its contributors.
43477 #. 4. Neither the name of the University nor the names of its contributors
43478 #. may be used to endorse or promote products derived from this software
43479 #. without specific prior written permission.
43480 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43481 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43482 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43483 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43484 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43485 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43486 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43487 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43488 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43489 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43491 #. @(#)write.1 8.1 (Berkeley) 6/6/93
43493 #: ../term-utils/write.1.adoc:39
43498 #. type: Plain text
43499 #: ../term-utils/write.1.adoc:49
43500 msgid "write - send a message to another user"
43501 msgstr "write - pošle zprávu jinému uživateli"
43503 #. type: Plain text
43504 #: ../term-utils/write.1.adoc:51
43506 msgid "*write* _user_ [_ttyname_]\n"
43507 msgstr "*write* _uživatel_ [_název_TTY_]\n"
43509 #. type: Plain text
43510 #: ../term-utils/write.1.adoc:55
43512 msgid "*write* allows you to communicate with other users, by copying lines from your terminal to theirs.\n"
43513 msgstr "*write* vám umožňuje komunikovat s ostatními uživateli, pomocí kopírování řádků z vašeho terminálu na jejich.\n"
43515 #. type: Plain text
43516 #: ../term-utils/write.1.adoc:57
43518 "When you run the *write* command, the user you are writing to gets a message "
43521 "Když spustíte příkaz *write*, uživatel, kterému píšete, dostane zprávu ve "
43524 #. type: delimited block .
43525 #: ../term-utils/write.1.adoc:60
43527 msgid "Message from yourname@yourhost on yourtty at hh:mm ...\n"
43528 msgstr "Zpráva od vaše_jméno@váš_počítač na vaše_TTY v hh:mm…\n"
43530 #. type: Plain text
43531 #: ../term-utils/write.1.adoc:63
43533 "Any further lines you enter will be copied to the specified user's terminal. "
43534 "If the other user wants to reply, they must run *write* as well."
43536 "Každé další napsané řádky se zkopírují na určený uživatelský terminál. Pokud "
43537 "chce druhý uživatel odpovědět, musí také spustit *write*."
43539 #. type: Plain text
43540 #: ../term-utils/write.1.adoc:65
43542 "When you are done, type an end-of-file or interrupt character. The other "
43543 "user will see the message *EOF* indicating that the conversation is over."
43545 "Když chcete skončit, vložte znak konce souboru (end-of-file, tj. CTRL+d) "
43546 "nebo přerušovací znak (CTRL+c). Druhý uživatel uvidí zprávu *EOF* ukazující, "
43547 "že konverzace skončila."
43549 #. type: Plain text
43550 #: ../term-utils/write.1.adoc:67
43552 "You can prevent people (other than the superuser) from writing to you with "
43553 "the *mesg*(1) command. Some commands, for example *nroff*(1) and *pr*(1), "
43554 "may automatically disallow writing, so that the output they produce isn't "
43557 "Psaní na svůj terminál můžete ostatním lidem (kromě superuživatele) zakázat "
43558 "pomocí příkazu *mesg*(1). Některé příkazy, např. *nroff*(1) a *pr*(1), mohou "
43559 "výpisy zakazovat automaticky, takže výstup, který vytváří, nebude zprávou "
43562 #. type: Plain text
43563 #: ../term-utils/write.1.adoc:69
43565 "If the user you want to write to is logged in on more than one terminal, you "
43566 "can specify which terminal to write to by giving the terminal name as the "
43567 "second operand to the *write* command. Alternatively, you can let *write* "
43568 "select one of the terminals - it will pick the one with the shortest idle "
43569 "time. This is so that if the user is logged in at work and also dialed up "
43570 "from home, the message will go to the right place."
43572 "Pokud je uživatel, kterému chcete psát, přihlášen na více terminálech, "
43573 "můžete určit, na který terminál se bude psát zadáním jména terminálu jako "
43574 "druhého parametru za příkazem *write*. Můžete také nechat program *write* "
43575 "vybrat jeden z terminálů - vybere se ten s nejkratší dobou nečinnosti. Pokud "
43576 "je tedy uživatel přihlášen v práci a zároveň je připojen z domova, zpráva "
43577 "dojde na správný terminál."
43579 #. type: Plain text
43580 #: ../term-utils/write.1.adoc:71
43582 "The traditional protocol for writing to someone is that the string _-o_, "
43583 "either at the end of a line or on a line by itself, means that it's the "
43584 "other person's turn to talk. The string _oo_ means that the person believes "
43585 "the conversation to be over."
43587 "Tradiční dohoda při psaní je, že značka _-o_, buď na konci řádku nebo na "
43588 "vlastním řádku, znamená, že je řada na druhé osobě. Znaky _oo_ znamenají, že "
43589 "osoba předpokládá, že konverzace skončila."
43591 #. type: Plain text
43592 #: ../term-utils/write.1.adoc:79
43594 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
43595 msgid "A *write* command appeared in Version 5 AT&T UNIX (Jun 1974)."
43596 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
43598 #. type: Plain text
43599 #: ../term-utils/write.1.adoc:85
43614 #. Copyright (c) 1990 The Regents of the University of California.
43615 #. All rights reserved.
43616 #. This code is derived from software contributed to Berkeley by
43617 #. Michael Rendell.
43618 #. Redistribution and use in source and binary forms, with or without
43619 #. modification, are permitted provided that the following conditions
43621 #. 1. Redistributions of source code must retain the above copyright
43622 #. notice, this list of conditions and the following disclaimer.
43623 #. 2. Redistributions in binary form must reproduce the above copyright
43624 #. notice, this list of conditions and the following disclaimer in the
43625 #. documentation and/or other materials provided with the distribution.
43626 #. 3. All advertising materials mentioning features or use of this software
43627 #. must display the following acknowledgement:
43628 #. This product includes software developed by the University of
43629 #. California, Berkeley and its contributors.
43630 #. 4. Neither the name of the University nor the names of its contributors
43631 #. may be used to endorse or promote products derived from this software
43632 #. without specific prior written permission.
43633 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43634 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43635 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43636 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43637 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43638 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43639 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43640 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43641 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43642 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43644 #. @(#)col.1 6.8 (Berkeley) 6/17/91
43646 #: ../text-utils/col.1.adoc:39
43651 #. type: Plain text
43652 #: ../text-utils/col.1.adoc:49
43653 msgid "col - filter reverse line feeds from input"
43656 #. type: Plain text
43657 #: ../text-utils/col.1.adoc:53
43659 msgid "*col* _options_\n"
43662 #. type: Plain text
43663 #: ../text-utils/col.1.adoc:57
43665 msgid "*col* filters out reverse (and half-reverse) line feeds so the output is in the correct order, with only forward and half-forward line feeds. It also replaces any whitespace characters with tabs where possible. This can be useful in processing the output of *nroff*(1) and *tbl*(1).\n"
43668 #. type: Plain text
43669 #: ../text-utils/col.1.adoc:59
43671 msgid "*col* reads from standard input and writes to standard output.\n"
43674 #. type: Labeled list
43675 #: ../text-utils/col.1.adoc:62
43677 msgid "*-b*, *--no-backspaces*"
43680 #. type: Plain text
43681 #: ../text-utils/col.1.adoc:64
43683 "Do not output any backspaces, printing only the last character written to "
43684 "each column position."
43687 #. type: Labeled list
43688 #: ../text-utils/col.1.adoc:65
43690 #| msgid "*-f*, *--fast*"
43691 msgid "*-f*, *--fine*"
43692 msgstr "*-f*, *--fast*"
43694 #. type: Plain text
43695 #: ../text-utils/col.1.adoc:67
43697 "Permit half-forward line feeds. Normally characters destined for a half-line "
43698 "boundary are printed on the following line."
43701 #. type: Labeled list
43702 #: ../text-utils/col.1.adoc:68
43704 #| msgid "*-f*, *--fast*"
43705 msgid "*-h*, *--tabs*"
43706 msgstr "*-f*, *--fast*"
43708 #. type: Plain text
43709 #: ../text-utils/col.1.adoc:70
43710 msgid "Output tabs instead of multiple spaces."
43713 #. type: Labeled list
43714 #: ../text-utils/col.1.adoc:71
43716 msgid "*-l*, *--lines* _number_"
43719 #. type: Plain text
43720 #: ../text-utils/col.1.adoc:73
43722 "Buffer at least _number_ lines in memory. By default, 128 lines are buffered."
43725 #. type: Labeled list
43726 #: ../text-utils/col.1.adoc:74
43728 #| msgid "*-f*, *--fast*"
43729 msgid "*-p*, *--pass*"
43730 msgstr "*-f*, *--fast*"
43732 #. type: Plain text
43733 #: ../text-utils/col.1.adoc:76
43735 "Force unknown control sequences to be passed through unchanged. Normally "
43736 "*col* will filter out any control sequences other than those recognized and "
43737 "interpreted by itself, which are listed below."
43740 #. type: Labeled list
43741 #: ../text-utils/col.1.adoc:77
43743 #| msgid "*-f*, *--fast*"
43744 msgid "*-x*, *--spaces*"
43745 msgstr "*-f*, *--fast*"
43747 #. type: Plain text
43748 #: ../text-utils/col.1.adoc:79
43749 msgid "Output multiple spaces instead of tabs."
43752 #. type: Labeled list
43753 #: ../text-utils/col.1.adoc:80
43755 #| msgid "*-h*, *--help*"
43756 msgid "*-H*, *--help*"
43757 msgstr "*-h*, *--help*"
43759 #. type: Plain text
43760 #: ../text-utils/col.1.adoc:89
43762 "The *col* utility conforms to the Single UNIX Specification, Version 2. The "
43763 "*-l* option is an extension to the standard."
43766 #. type: Plain text
43767 #: ../text-utils/col.1.adoc:93
43769 "The control sequences for carriage motion that *col* understands and their "
43770 "decimal values are listed in the following table:"
43773 #. type: Labeled list
43774 #: ../text-utils/col.1.adoc:94
43779 #. type: Plain text
43780 #: ../text-utils/col.1.adoc:96
43781 msgid "reverse line feed (escape then 7)"
43784 #. type: Labeled list
43785 #: ../text-utils/col.1.adoc:96
43790 #. type: Plain text
43791 #: ../text-utils/col.1.adoc:98
43792 msgid "half reverse line feed (escape then 8)"
43795 #. type: Labeled list
43796 #: ../text-utils/col.1.adoc:98
43801 #. type: Plain text
43802 #: ../text-utils/col.1.adoc:100
43803 msgid "half forward line feed (escape then 9)"
43806 #. type: Labeled list
43807 #: ../text-utils/col.1.adoc:100
43809 msgid "*backspace*"
43812 #. type: Plain text
43813 #: ../text-utils/col.1.adoc:102
43814 msgid "moves back one column (8); ignored in the first column"
43817 #. type: Labeled list
43818 #: ../text-utils/col.1.adoc:102
43823 #. type: Plain text
43824 #: ../text-utils/col.1.adoc:104
43825 msgid "forward line feed (10); also does carriage return"
43828 #. type: Labeled list
43829 #: ../text-utils/col.1.adoc:104
43831 msgid "*carriage return*"
43834 #. type: Plain text
43835 #: ../text-utils/col.1.adoc:106
43839 #. type: Labeled list
43840 #: ../text-utils/col.1.adoc:106
43845 #. type: Plain text
43846 #: ../text-utils/col.1.adoc:108
43847 msgid "shift to normal character set (15)"
43850 #. type: Labeled list
43851 #: ../text-utils/col.1.adoc:108
43853 msgid "*shift out*"
43856 #. type: Plain text
43857 #: ../text-utils/col.1.adoc:110
43858 msgid "shift to alternate character set (14)"
43861 #. type: Labeled list
43862 #: ../text-utils/col.1.adoc:110
43867 #. type: Plain text
43868 #: ../text-utils/col.1.adoc:112
43869 msgid "moves forward one column (32)"
43872 #. type: Labeled list
43873 #: ../text-utils/col.1.adoc:112
43878 #. type: Plain text
43879 #: ../text-utils/col.1.adoc:114
43880 msgid "moves forward to next tab stop (9)"
43883 #. type: Labeled list
43884 #: ../text-utils/col.1.adoc:114
43886 msgid "*vertical tab*"
43889 #. type: Plain text
43890 #: ../text-utils/col.1.adoc:116
43891 msgid "reverse line feed (11)"
43894 #. type: Plain text
43895 #: ../text-utils/col.1.adoc:118
43896 msgid "All unrecognized control characters and escape sequences are discarded."
43899 #. type: Plain text
43900 #: ../text-utils/col.1.adoc:120
43902 msgid "*col* keeps track of the character set as characters are read and makes sure the character set is correct when they are output.\n"
43905 #. type: Plain text
43906 #: ../text-utils/col.1.adoc:122
43908 "If the input attempts to back up to the last flushed line, *col* will "
43909 "display a warning message."
43912 #. type: Plain text
43913 #: ../text-utils/col.1.adoc:126
43915 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
43916 msgid "A *col* command appeared in Version 6 AT&T UNIX."
43917 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
43919 #. type: Plain text
43920 #: ../text-utils/col.1.adoc:132
43938 #. Copyright (c) 1980, 1990, 1993
43939 #. The Regents of the University of California. All rights reserved.
43940 #. Redistribution and use in source and binary forms, with or without
43941 #. modification, are permitted provided that the following conditions
43943 #. 1. Redistributions of source code must retain the above copyright
43944 #. notice, this list of conditions and the following disclaimer.
43945 #. 2. Redistributions in binary form must reproduce the above copyright
43946 #. notice, this list of conditions and the following disclaimer in the
43947 #. documentation and/or other materials provided with the distribution.
43948 #. 3. All advertising materials mentioning features or use of this software
43949 #. must display the following acknowledgement:
43950 #. This product includes software developed by the University of
43951 #. California, Berkeley and its contributors.
43952 #. 4. Neither the name of the University nor the names of its contributors
43953 #. may be used to endorse or promote products derived from this software
43954 #. without specific prior written permission.
43955 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43956 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43957 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43958 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43959 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43960 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43961 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43962 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43963 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43964 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43966 #. @(#)colcrt.1 8.1 (Berkeley) 6/30/93
43968 #: ../text-utils/colcrt.1.adoc:36
43973 #. type: Plain text
43974 #: ../text-utils/colcrt.1.adoc:47
43975 msgid "colcrt - filter nroff output for CRT previewing"
43978 #. type: Plain text
43979 #: ../text-utils/colcrt.1.adoc:51
43981 msgid "*colcrt* [options] [_file_ ...]\n"
43984 #. type: Plain text
43985 #: ../text-utils/colcrt.1.adoc:55
43987 msgid "*colcrt* provides virtual half-line and reverse line feed sequences for terminals without such capability, and on which overstriking is destructive. Half-line characters and underlining (changed to dashing `-') are placed on new lines in between the normal output lines.\n"
43990 #. type: Labeled list
43991 #: ../text-utils/colcrt.1.adoc:58
43993 #| msgid "*-V*, *--version*"
43994 msgid "*-*, *--no-underlining*"
43995 msgstr "*-V*, *--version*"
43997 #. type: Plain text
43998 #: ../text-utils/colcrt.1.adoc:60
44000 "Suppress all underlining. This option is especially useful for previewing "
44001 "_allboxed_ tables from *tbl*(1)."
44004 #. type: Labeled list
44005 #: ../text-utils/colcrt.1.adoc:61
44007 #| msgid "*-*, *-l*, *--login*"
44008 msgid "*-2*, *--half-lines*"
44009 msgstr "*-*, *-l*, *--login*"
44011 #. type: Plain text
44012 #: ../text-utils/colcrt.1.adoc:63
44014 "Causes all half-lines to be printed, effectively double spacing the output. "
44015 "Normally, a minimal space output format is used which will suppress empty "
44016 "lines. The program never suppresses two consecutive empty lines, however. "
44017 "The *-2* option is useful for sending output to the line printer when the "
44018 "output contains superscripts and subscripts which would otherwise be "
44019 "partially invisible."
44022 #. type: Plain text
44023 #: ../text-utils/colcrt.1.adoc:69
44025 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
44026 msgid "The *colcrt* command appeared in 3.0BSD."
44027 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
44029 #. type: Plain text
44030 #: ../text-utils/colcrt.1.adoc:73
44032 "Should fold underlines onto blanks even with the *-* option so that a true "
44033 "underline character would show."
44036 #. type: Plain text
44037 #: ../text-utils/colcrt.1.adoc:75
44038 msgid "Can't back up more than 102 lines."
44041 #. TRANSLATORS: Keep {plus} untranslated.
44042 #. type: Plain text
44043 #: ../text-utils/colcrt.1.adoc:78
44045 "General overstriking is lost; as a special case '|' overstruck with '-' or "
44046 "underline becomes '{plus}'."
44049 #. type: Plain text
44050 #: ../text-utils/colcrt.1.adoc:80
44051 msgid "Lines are trimmed to 132 characters."
44054 #. type: Plain text
44055 #: ../text-utils/colcrt.1.adoc:82
44057 "Some provision should be made for processing superscripts and subscripts in "
44058 "documents which are already double-spaced."
44061 #. type: Plain text
44062 #: ../text-utils/colcrt.1.adoc:86
44063 msgid "A typical use of *colcrt* would be:"
44066 #. type: delimited block _
44067 #: ../text-utils/colcrt.1.adoc:89
44069 msgid "*tbl exum2.n | nroff -ms | colcrt - | more*\n"
44072 #. type: Plain text
44073 #: ../text-utils/colcrt.1.adoc:99
44086 #. Copyright (c) 1980, 1990 The Regents of the University of California.
44087 #. All rights reserved.
44088 #. Redistribution and use in source and binary forms, with or without
44089 #. modification, are permitted provided that the following conditions
44091 #. 1. Redistributions of source code must retain the above copyright
44092 #. notice, this list of conditions and the following disclaimer.
44093 #. 2. Redistributions in binary form must reproduce the above copyright
44094 #. notice, this list of conditions and the following disclaimer in the
44095 #. documentation and/or other materials provided with the distribution.
44096 #. 3. All advertising materials mentioning features or use of this software
44097 #. must display the following acknowledgement:
44098 #. This product includes software developed by the University of
44099 #. California, Berkeley and its contributors.
44100 #. 4. Neither the name of the University nor the names of its contributors
44101 #. may be used to endorse or promote products derived from this software
44102 #. without specific prior written permission.
44103 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44104 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44105 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44106 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44107 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44108 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44109 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44110 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44111 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44112 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44114 #. @(#)colrm.1 6.6 (Berkeley) 3/14/91
44116 #: ../text-utils/colrm.1.adoc:36
44121 #. type: Plain text
44122 #: ../text-utils/colrm.1.adoc:46
44123 msgid "colrm - remove columns from a file"
44126 #. type: Plain text
44127 #: ../text-utils/colrm.1.adoc:50
44129 msgid "*colrm* _[first [last]]_\n"
44132 #. type: Plain text
44133 #: ../text-utils/colrm.1.adoc:54
44135 msgid "*colrm* removes selected columns from a file. Input is taken from standard input. Output is sent to standard output.\n"
44138 #. type: Plain text
44139 #: ../text-utils/colrm.1.adoc:56
44141 "If called with one parameter the columns of each line will be removed "
44142 "starting with the specified _first_ column. If called with two parameters "
44143 "the columns from the _first_ column to the _last_ column will be removed."
44146 #. type: Plain text
44147 #: ../text-utils/colrm.1.adoc:58
44148 msgid "Column numbering starts with column 1."
44151 #. type: Plain text
44152 #: ../text-utils/colrm.1.adoc:66
44154 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
44155 msgid "The *colrm* command appeared in 3.0BSD."
44156 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
44158 #. type: Plain text
44159 #: ../text-utils/colrm.1.adoc:73
44171 #. Copyright (c) 1989, 1990, 1993
44172 #. The Regents of the University of California. All rights reserved.
44173 #. Redistribution and use in source and binary forms, with or without
44174 #. modification, are permitted provided that the following conditions
44176 #. 1. Redistributions of source code must retain the above copyright
44177 #. notice, this list of conditions and the following disclaimer.
44178 #. 2. Redistributions in binary form must reproduce the above copyright
44179 #. notice, this list of conditions and the following disclaimer in the
44180 #. documentation and/or other materials provided with the distribution.
44181 #. 3. All advertising materials mentioning features or use of this software
44182 #. must display the following acknowledgement:
44183 #. This product includes software developed by the University of
44184 #. California, Berkeley and its contributors.
44185 #. 4. Neither the name of the University nor the names of its contributors
44186 #. may be used to endorse or promote products derived from this software
44187 #. without specific prior written permission.
44188 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44189 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44190 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44191 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44192 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44193 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44194 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44195 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44196 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44197 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44199 #. @(#)column.1 8.1 (Berkeley) 6/6/93
44201 #: ../text-utils/column.1.adoc:36
44206 #. type: Plain text
44207 #: ../text-utils/column.1.adoc:46
44208 msgid "column - columnate lists"
44211 #. type: Plain text
44212 #: ../text-utils/column.1.adoc:50
44214 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
44215 msgid "*column* [options] [_file_ ...]\n"
44216 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
44218 #. type: Plain text
44219 #: ../text-utils/column.1.adoc:54
44221 "The *column* utility formats its input into multiple columns. The util "
44222 "support three modes:"
44225 #. type: Labeled list
44226 #: ../text-utils/column.1.adoc:55
44228 msgid "*columns are filled before rows*"
44231 #. type: Plain text
44232 #: ../text-utils/column.1.adoc:57
44233 msgid "This is the default mode (required by backward compatibility)."
44236 #. type: Labeled list
44237 #: ../text-utils/column.1.adoc:58
44239 msgid "*rows are filled before columns*"
44242 #. type: Plain text
44243 #: ../text-utils/column.1.adoc:60
44244 msgid "This mode is enabled by option *-x, --fillrows*"
44247 #. type: Labeled list
44248 #: ../text-utils/column.1.adoc:61
44253 #. type: Plain text
44254 #: ../text-utils/column.1.adoc:63
44256 "Determine the number of columns the input contains and create a table. This "
44257 "mode is enabled by option *-t, --table* and columns formatting is possible "
44258 "to modify by *--table-** options. Use this mode if not sure. The output is "
44259 "aligned to the terminal width in interactive mode and the 80 columns in non-"
44260 "interactive mode (see *--output-width* for more details)."
44263 #. type: Plain text
44264 #: ../text-utils/column.1.adoc:65
44266 "Input is taken from _file_, or otherwise from standard input. Empty lines "
44267 "are ignored and all invalid multibyte sequences are encoded by x<hex> "
44271 #. type: Plain text
44272 #: ../text-utils/column.1.adoc:74
44274 "The argument _columns_ for *--table-** options is a comma separated list of "
44275 "the column names as defined by *--table-columns*, or names defined by *--"
44276 "table-column* or it's column number in order as specified by input. It's "
44277 "possible to mix names and numbers. The special placeholder '0' (e.g. -R0) "
44278 "may be used to specify all columns and '-1' (e.g. -R -1) to specify the last "
44279 "visible column. It's possible to use ranges like '1-5' when addressing "
44280 "columns by numbers."
44283 #. type: Labeled list
44284 #: ../text-utils/column.1.adoc:75
44286 msgid "*-J, --json*"
44289 #. type: Plain text
44290 #: ../text-utils/column.1.adoc:77
44292 "Use JSON output format to print the table, the option *--table-columns* is "
44293 "required and the option *--table-name* is recommended."
44296 #. type: Labeled list
44297 #: ../text-utils/column.1.adoc:78
44299 msgid "*-c, --output-width* _width_"
44302 #. type: Plain text
44303 #: ../text-utils/column.1.adoc:80
44305 "Output is formatted to a width specified as number of characters. The "
44306 "original name of this option is *--columns*; this name is deprecated since "
44307 "v2.30. Note that input longer than _width_ is not truncated by default. The "
44308 "default is a terminal width and the 80 columns in non-interactive mode. The "
44309 "column headers are never truncated."
44312 #. type: Plain text
44313 #: ../text-utils/column.1.adoc:82
44315 "The placeholder \"unlimited\" (or 0) is possible to use to not restrict "
44316 "output width. This is recommended for example when output to the files "
44317 "rather than on terminal."
44320 #. type: Labeled list
44321 #: ../text-utils/column.1.adoc:83
44323 msgid "*-d, --table-noheadings*"
44326 #. type: Plain text
44327 #: ../text-utils/column.1.adoc:85
44329 "Do not print header. This option allows the use of logical column names on "
44330 "the command line, but keeps the header hidden when printing the table."
44333 #. type: Labeled list
44334 #: ../text-utils/column.1.adoc:86
44336 msgid "*-o, --output-separator* _string_"
44339 #. type: Plain text
44340 #: ../text-utils/column.1.adoc:88
44341 msgid "Specify the columns delimiter for table output (default is two spaces)."
44344 #. type: Labeled list
44345 #: ../text-utils/column.1.adoc:89
44347 msgid "*-s, --separator* _separators_"
44350 #. type: Plain text
44351 #: ../text-utils/column.1.adoc:91
44352 msgid "Specify the possible input item delimiters (default is whitespace)."
44355 #. type: Labeled list
44356 #: ../text-utils/column.1.adoc:92
44358 msgid "*-t, --table*"
44361 #. type: Plain text
44362 #: ../text-utils/column.1.adoc:94
44364 "Determine the number of columns the input contains and create a table. "
44365 "Columns are delimited with whitespace, by default, or with the characters "
44366 "supplied using the *--output-separator* option. Table output is useful for "
44370 #. type: Labeled list
44371 #: ../text-utils/column.1.adoc:95
44373 msgid "*-C, --table-column* _properties_"
44376 #. type: Plain text
44377 #: ../text-utils/column.1.adoc:101
44379 "Define one column by comma separated list of column attributes. This option "
44380 "can be used more than once, every use defines just one column. The "
44381 "properties replace some of *--table-* options. For example *--table-column "
44382 "name=FOO,right* define one column where text is aligned to right. The option "
44383 "is mutually exclusive to *--table-columns*."
44386 #. type: Plain text
44387 #: ../text-utils/column.1.adoc:103
44388 msgid "The currently supported attributes are:"
44391 #. type: Labeled list
44392 #: ../text-utils/column.1.adoc:104
44394 msgid "*name=string*"
44397 #. type: Plain text
44398 #: ../text-utils/column.1.adoc:106
44399 msgid "Specifies column name."
44402 #. type: Labeled list
44403 #: ../text-utils/column.1.adoc:106
44408 #. type: Plain text
44409 #: ../text-utils/column.1.adoc:108
44411 "The column text can be truncated when necessary. The same as *--table-"
44415 #. type: Labeled list
44416 #: ../text-utils/column.1.adoc:108
44421 #. type: Plain text
44422 #: ../text-utils/column.1.adoc:110
44423 msgid "Right align text in the specified columns. The same as *--table-right*."
44426 #. type: Labeled list
44427 #: ../text-utils/column.1.adoc:110
44429 msgid "*width=number*"
44432 #. type: Plain text
44433 #: ../text-utils/column.1.adoc:113
44435 "Specifies column width. The width is used as a hint only. The width is "
44436 "strictly followed only when *strictwidth* attribute is used too."
44439 #. type: Labeled list
44440 #: ../text-utils/column.1.adoc:113
44442 msgid "*strictwidth*"
44445 #. type: Plain text
44446 #: ../text-utils/column.1.adoc:115
44447 msgid "Strictly follow column *width=* setting."
44450 #. type: Labeled list
44451 #: ../text-utils/column.1.adoc:115
44453 msgid "*noextreme*"
44456 #. type: Plain text
44457 #: ../text-utils/column.1.adoc:117
44459 "Specify columns where is possible to ignore unusually long cells. See *--"
44460 "table-noextreme* for more details."
44463 #. type: Labeled list
44464 #: ../text-utils/column.1.adoc:117
44469 #. type: Plain text
44470 #: ../text-utils/column.1.adoc:119
44472 "Specify columns where is possible to use multi-line cell for long text when "
44473 "necessary. See *--table-wrap*."
44476 #. type: Labeled list
44477 #: ../text-utils/column.1.adoc:119
44482 #. type: Plain text
44483 #: ../text-utils/column.1.adoc:121
44484 msgid "Don't print specified columns. See *--table-hide*."
44487 #. type: Labeled list
44488 #: ../text-utils/column.1.adoc:121
44490 msgid "*json=type*"
44493 #. type: Plain text
44494 #: ../text-utils/column.1.adoc:123
44496 "Define column type for JSON output, Supported are string, number and boolean."
44499 #. type: Labeled list
44500 #: ../text-utils/column.1.adoc:124
44502 msgid "*-N, --table-columns* _names_"
44505 #. type: Plain text
44506 #: ../text-utils/column.1.adoc:127
44508 "Specify the columns names by comma separated list of names. The names are "
44509 "used for the table header or to address column in option argument. See also "
44510 "*--table-column*."
44513 #. type: Labeled list
44514 #: ../text-utils/column.1.adoc:128
44516 msgid "*-l, --table-columns-limit* _number_"
44519 #. type: Plain text
44520 #: ../text-utils/column.1.adoc:130
44522 "Specify maximal number of the input columns. The last column will contain "
44523 "all remaining line data if the limit is smaller than the number of the "
44524 "columns in the input data."
44527 #. type: Labeled list
44528 #: ../text-utils/column.1.adoc:131
44530 msgid "*-R, --table-right* _columns_"
44533 #. type: Plain text
44534 #: ../text-utils/column.1.adoc:133
44535 msgid "Right align text in the specified columns."
44538 #. type: Labeled list
44539 #: ../text-utils/column.1.adoc:134
44541 msgid "*-T, --table-truncate* _columns_"
44544 #. type: Plain text
44545 #: ../text-utils/column.1.adoc:136
44547 "Specify columns where text can be truncated when necessary, otherwise very "
44548 "long table entries may be printed on multiple lines."
44551 #. type: Labeled list
44552 #: ../text-utils/column.1.adoc:137
44554 msgid "*-E, --table-noextreme* _columns_"
44557 #. type: Plain text
44558 #: ../text-utils/column.1.adoc:139
44560 "Specify columns where is possible to ignore unusually long (longer than "
44561 "average) cells when calculate column width. The option has impact to the "
44562 "width calculation and table formatting, but the printed text is not affected."
44565 #. type: Plain text
44566 #: ../text-utils/column.1.adoc:141
44567 msgid "The option is used for the last visible column by default."
44570 #. type: Labeled list
44571 #: ../text-utils/column.1.adoc:142
44573 msgid "*-e, --table-header-repeat*"
44576 #. type: Plain text
44577 #: ../text-utils/column.1.adoc:144
44578 msgid "Print header line for each page."
44581 #. type: Labeled list
44582 #: ../text-utils/column.1.adoc:145
44584 msgid "*-W, --table-wrap* _columns_"
44587 #. type: Plain text
44588 #: ../text-utils/column.1.adoc:147
44590 "Specify columns where is possible to use multi-line cell for long text when "
44594 #. type: Labeled list
44595 #: ../text-utils/column.1.adoc:148
44597 msgid "*-H, --table-hide* _columns_"
44600 #. type: Plain text
44601 #: ../text-utils/column.1.adoc:150
44603 "Don't print specified columns. The special placeholder '-' may be used to "
44604 "hide all unnamed columns (see *--table-columns*)."
44607 #. type: Labeled list
44608 #: ../text-utils/column.1.adoc:151
44610 msgid "*-O, --table-order* _columns_"
44613 #. type: Plain text
44614 #: ../text-utils/column.1.adoc:153
44615 msgid "Specify columns order on output."
44618 #. type: Labeled list
44619 #: ../text-utils/column.1.adoc:154
44621 msgid "*-n, --table-name* _name_"
44624 #. type: Plain text
44625 #: ../text-utils/column.1.adoc:156
44626 msgid "Specify the table name used for JSON output. The default is \"table\"."
44629 #. type: Labeled list
44630 #: ../text-utils/column.1.adoc:157
44632 #| msgid "*-P*, *--pty*"
44633 msgid "*-m, --table-maxout*"
44634 msgstr "*-P*, *--pty*"
44636 #. type: Plain text
44637 #: ../text-utils/column.1.adoc:159
44638 msgid "Fill all available space on output."
44641 #. type: Labeled list
44642 #: ../text-utils/column.1.adoc:160
44644 msgid "*-L, --keep-empty-lines*"
44647 #. type: Plain text
44648 #: ../text-utils/column.1.adoc:162
44650 "Preserve whitespace-only lines in the input. The default is ignore empty "
44651 "lines at all. This option's original name was *--table-empty-lines* but is "
44652 "now deprecated because it gives the false impression that the option only "
44653 "applies to table mode."
44656 #. type: Labeled list
44657 #: ../text-utils/column.1.adoc:163
44659 msgid "*-r, --tree* _column_"
44662 #. type: Plain text
44663 #: ../text-utils/column.1.adoc:165
44665 "Specify column to use tree-like output. Note that the circular dependencies "
44666 "and other anomalies in child and parent relation are silently ignored."
44669 #. type: Labeled list
44670 #: ../text-utils/column.1.adoc:166
44672 msgid "*-i, --tree-id* _column_"
44675 #. type: Plain text
44676 #: ../text-utils/column.1.adoc:168
44677 msgid "Specify column with line ID to create child-parent relation."
44680 #. type: Labeled list
44681 #: ../text-utils/column.1.adoc:169
44683 msgid "*-p, --tree-parent* _column_"
44686 #. type: Plain text
44687 #: ../text-utils/column.1.adoc:171
44688 msgid "Specify column with parent ID to create child-parent relation."
44691 #. type: Labeled list
44692 #: ../text-utils/column.1.adoc:172
44694 msgid "*-x, --fillrows*"
44697 #. type: Plain text
44698 #: ../text-utils/column.1.adoc:174
44699 msgid "Fill rows before filling columns."
44702 #. type: Plain text
44703 #: ../text-utils/column.1.adoc:180
44705 "The environment variable *COLUMNS* is used to determine the size of the "
44706 "screen if no other information is available."
44709 #. type: Plain text
44710 #: ../text-utils/column.1.adoc:184
44711 msgid "The *column* command appeared in 4.3BSD-Reno."
44714 #. type: Plain text
44715 #: ../text-utils/column.1.adoc:188
44716 msgid "Version 2.23 changed the *-s* option to be non-greedy, for example:"
44719 #. type: delimited block .
44720 #: ../text-utils/column.1.adoc:191
44722 msgid "printf \"a:b:c\\n1::3\\n\" | column -t -s ':'\n"
44725 #. type: Plain text
44726 #: ../text-utils/column.1.adoc:194
44727 msgid "Old output:"
44730 #. type: delimited block .
44731 #: ../text-utils/column.1.adoc:198
44738 #. type: Plain text
44739 #: ../text-utils/column.1.adoc:201
44740 msgid "New output (since util-linux 2.23):"
44743 #. type: delimited block .
44744 #: ../text-utils/column.1.adoc:205
44751 #. type: Plain text
44752 #: ../text-utils/column.1.adoc:208
44754 "Historical versions of this tool indicated that \"rows are filled before "
44755 "columns\" by default, and that the *-x* option reverses this. This wording "
44756 "did not reflect the actual behavior, and it has since been corrected (see "
44757 "above). Other implementations of *column* may continue to use the older "
44758 "documentation, but the behavior should be identical in any case."
44761 #. type: Plain text
44762 #: ../text-utils/column.1.adoc:212
44763 msgid "Print fstab with header line and align number to the right:"
44766 #. type: delimited block .
44767 #: ../text-utils/column.1.adoc:215
44769 msgid "sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ --table-right PASS,FREQ\n"
44772 #. type: Plain text
44773 #: ../text-utils/column.1.adoc:218
44774 msgid "Print fstab and hide unnamed columns:"
44777 #. type: delimited block .
44778 #: ../text-utils/column.1.adoc:221
44780 msgid "sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE --table-hide -\n"
44783 #. type: Plain text
44784 #: ../text-utils/column.1.adoc:224
44785 msgid "Print a tree:"
44788 #. type: delimited block .
44789 #: ../text-utils/column.1.adoc:232
44792 "echo -e '1 0 A\\n2 1 AA\\n3 1 AB\\n4 2 AAA\\n5 2 AAB' | column --tree-id 1 --tree-parent 2 --tree 3\n"
44800 #. type: Plain text
44801 #: ../text-utils/column.1.adoc:240
44820 #. Copyright (c) 1989, 1990, 1993
44821 #. The Regents of the University of California. All rights reserved.
44822 #. Redistribution and use in source and binary forms, with or without
44823 #. modification, are permitted provided that the following conditions
44825 #. 1. Redistributions of source code must retain the above copyright
44826 #. notice, this list of conditions and the following disclaimer.
44827 #. 2. Redistributions in binary form must reproduce the above copyright
44828 #. notice, this list of conditions and the following disclaimer in the
44829 #. documentation and/or other materials provided with the distribution.
44830 #. 3. All advertising materials mentioning features or use of this software
44831 #. must display the following acknowledgement:
44832 #. This product includes software developed by the University of
44833 #. California, Berkeley and its contributors.
44834 #. 4. Neither the name of the University nor the names of its contributors
44835 #. may be used to endorse or promote products derived from this software
44836 #. without specific prior written permission.
44837 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44838 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44839 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44840 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44841 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44842 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44843 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44844 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44845 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44846 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44848 #. @(#)hexdump.1 8.2 (Berkeley) 4/18/94
44850 #: ../text-utils/hexdump.1.adoc:36
44855 #. type: Plain text
44856 #: ../text-utils/hexdump.1.adoc:48
44858 "hexdump - display file contents in hexadecimal, decimal, octal, or ascii"
44861 #. type: Plain text
44862 #: ../text-utils/hexdump.1.adoc:50
44864 msgid "*hexdump* _options file_ ...\n"
44867 #. type: Plain text
44868 #: ../text-utils/hexdump.1.adoc:52
44870 msgid "*hd* _options file_ ...\n"
44873 #. type: Plain text
44874 #: ../text-utils/hexdump.1.adoc:56
44876 "The *hexdump* utility is a filter which displays the specified files, or "
44877 "standard input if no files are specified, in a user-specified format."
44880 #. type: Plain text
44881 #: ../text-utils/hexdump.1.adoc:60
44883 "Below, the _length_ and _offset_ arguments may be followed by the "
44884 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
44885 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
44886 "meaning as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on "
44887 "for GB, TB, PB, EB, ZB and YB."
44890 #. type: Labeled list
44891 #: ../text-utils/hexdump.1.adoc:61
44893 msgid "*-b*, *--one-byte-octal*"
44896 #. type: Plain text
44897 #: ../text-utils/hexdump.1.adoc:63
44899 "_One-byte octal display_. Display the input offset in hexadecimal, followed "
44900 "by sixteen space-separated, three-column, zero-filled bytes of input data, "
44901 "in octal, per line."
44904 #. type: Labeled list
44905 #: ../text-utils/hexdump.1.adoc:64
44907 #| msgid "*-P*, *--pty*"
44908 msgid "*-X*, *--one-byte-hex*"
44909 msgstr "*-P*, *--pty*"
44911 #. type: Plain text
44912 #: ../text-utils/hexdump.1.adoc:66
44914 "_One-byte hexadecimal display_. Display the input offset in hexadecimal, "
44915 "followed by sixteen space-separated, two-column, zero-filled bytes of input "
44916 "data, in hexadecimal, per line."
44919 #. type: Labeled list
44920 #: ../text-utils/hexdump.1.adoc:67
44922 msgid "*-c*, *--one-byte-char*"
44925 #. type: Plain text
44926 #: ../text-utils/hexdump.1.adoc:69
44928 "_One-byte character display_. Display the input offset in hexadecimal, "
44929 "followed by sixteen space-separated, three-column, space-filled characters "
44930 "of input data per line."
44933 #. type: Labeled list
44934 #: ../text-utils/hexdump.1.adoc:70
44936 #| msgid "*-V*, *--version*"
44937 msgid "*-C*, *--canonical*"
44938 msgstr "*-V*, *--version*"
44940 #. TRANSLATORS: Keep {plus} and {underscore} untranslated.
44941 #. type: Plain text
44942 #: ../text-utils/hexdump.1.adoc:72
44944 "_Canonical hex{plus}ASCII display_. Display the input offset in hexadecimal, "
44945 "followed by sixteen space-separated, two-column, hexadecimal bytes, followed "
44946 "by the same sixteen bytes in *%{underscore}p* format enclosed in *|* "
44947 "characters. Invoking the program as *hd* implies this option."
44950 #. type: Labeled list
44951 #: ../text-utils/hexdump.1.adoc:74
44953 msgid "*-d*, *--two-bytes-decimal*"
44956 #. type: Plain text
44957 #: ../text-utils/hexdump.1.adoc:76
44959 "_Two-byte decimal display_. Display the input offset in hexadecimal, "
44960 "followed by eight space-separated, five-column, zero-filled, two-byte units "
44961 "of input data, in unsigned decimal, per line."
44964 #. type: Labeled list
44965 #: ../text-utils/hexdump.1.adoc:77
44967 msgid "*-e*, *--format* _format_string_"
44970 #. type: Plain text
44971 #: ../text-utils/hexdump.1.adoc:79
44972 msgid "Specify a format string to be used for displaying data."
44975 #. type: Labeled list
44976 #: ../text-utils/hexdump.1.adoc:80
44978 #| msgid "*-f*, *--fast*"
44979 msgid "*-f*, *--format-file* _file_"
44980 msgstr "*-f*, *--fast*"
44982 #. type: Plain text
44983 #: ../text-utils/hexdump.1.adoc:82
44985 "Specify a file that contains one or more newline-separated format strings. "
44986 "Empty lines and lines whose first non-blank character is a hash mark (#) are "
44990 #. type: Plain text
44991 #: ../text-utils/hexdump.1.adoc:85
44993 "Accept color units for the output. The optional argument _when_ can be "
44994 "*auto*, *never* or *always*. If the _when_ argument is omitted, it defaults "
44995 "to *auto*. The colors can be disabled; for the current built-in default see "
44996 "the *--help* output. See also the *Colors* subsection and the *COLORS* "
45000 #. type: Labeled list
45001 #: ../text-utils/hexdump.1.adoc:86
45003 msgid "*-n*, *--length* _length_"
45006 #. type: Plain text
45007 #: ../text-utils/hexdump.1.adoc:88
45008 msgid "Interpret only _length_ bytes of input."
45011 #. type: Labeled list
45012 #: ../text-utils/hexdump.1.adoc:89
45014 msgid "*-o*, *--two-bytes-octal*"
45017 #. type: Plain text
45018 #: ../text-utils/hexdump.1.adoc:91
45020 "_Two-byte octal display_. Display the input offset in hexadecimal, followed "
45021 "by eight space-separated, six-column, zero-filled, two-byte quantities of "
45022 "input data, in octal, per line."
45025 #. type: Labeled list
45026 #: ../text-utils/hexdump.1.adoc:92
45028 #| msgid "*-s*, **--shell**=__shell__"
45029 msgid "*-s*, *--skip* _offset_"
45030 msgstr "*-s*, **--shell**=__shell__"
45032 #. type: Plain text
45033 #: ../text-utils/hexdump.1.adoc:94
45034 msgid "Skip _offset_ bytes from the beginning of the input."
45037 #. type: Labeled list
45038 #: ../text-utils/hexdump.1.adoc:95
45040 #| msgid "*-V*, *--version*"
45041 msgid "*-v*, *--no-squeezing*"
45042 msgstr "*-V*, *--version*"
45044 #. type: Plain text
45045 #: ../text-utils/hexdump.1.adoc:97
45047 "The *-v* option causes *hexdump* to display all input data. Without the *-v* "
45048 "option, any number of groups of output lines which would be identical to the "
45049 "immediately preceding group of output lines (except for the input offsets), "
45050 "are replaced with a line comprised of a single asterisk."
45053 #. type: Labeled list
45054 #: ../text-utils/hexdump.1.adoc:98
45056 #| msgid "*-P*, *--pty*"
45057 msgid "*-x*, *--two-bytes-hex*"
45058 msgstr "*-P*, *--pty*"
45060 #. type: Plain text
45061 #: ../text-utils/hexdump.1.adoc:100
45063 "_Two-byte hexadecimal display_. Display the input offset in hexadecimal, "
45064 "followed by eight space-separated, four-column, zero-filled, two-byte "
45065 "quantities of input data, in hexadecimal, per line."
45068 #. type: Plain text
45069 #: ../text-utils/hexdump.1.adoc:104
45071 "For each input file, *hexdump* sequentially copies the input to standard "
45072 "output, transforming the data according to the format strings specified by "
45073 "the *-e* and *-f* options, in the order that they were specified."
45077 #: ../text-utils/hexdump.1.adoc:105
45082 #. type: Plain text
45083 #: ../text-utils/hexdump.1.adoc:108
45085 "A format string contains any number of format units, separated by "
45086 "whitespace. A format unit contains up to three items: an iteration count, a "
45087 "byte count, and a format."
45090 #. type: Plain text
45091 #: ../text-utils/hexdump.1.adoc:110
45093 "The iteration count is an optional positive integer, which defaults to one. "
45094 "Each format is applied iteration count times."
45097 #. type: Plain text
45098 #: ../text-utils/hexdump.1.adoc:112
45100 "The byte count is an optional positive integer. If specified it defines the "
45101 "number of bytes to be interpreted by each iteration of the format."
45104 #. type: Plain text
45105 #: ../text-utils/hexdump.1.adoc:114
45107 "If an iteration count and/or a byte count is specified, a single slash must "
45108 "be placed after the iteration count and/or before the byte count to "
45109 "disambiguate them. Any whitespace before or after the slash is ignored."
45112 #. type: Plain text
45113 #: ../text-utils/hexdump.1.adoc:116
45115 "The format is required and must be surrounded by double quote (\" \") marks. "
45116 "It is interpreted as a fprintf-style format string (see *fprintf*(3)), with "
45117 "the following exceptions:"
45120 #. type: Labeled list
45121 #: ../text-utils/hexdump.1.adoc:117
45127 #. type: Plain text
45128 #: ../text-utils/hexdump.1.adoc:119
45129 msgid "An asterisk (*) may not be used as a field width or precision."
45132 #. type: Labeled list
45133 #: ../text-utils/hexdump.1.adoc:120
45138 #. type: Plain text
45139 #: ../text-utils/hexdump.1.adoc:122
45141 "A byte count or field precision _is_ required for each *s* conversion "
45142 "character (unlike the *fprintf*(3) default which prints the entire string if "
45143 "the precision is unspecified)."
45146 #. type: Labeled list
45147 #: ../text-utils/hexdump.1.adoc:123
45152 #. type: Plain text
45153 #: ../text-utils/hexdump.1.adoc:125
45155 "The conversion characters *h*, *l*, *n*, *p*, and *q* are not supported."
45158 #. type: Labeled list
45159 #: ../text-utils/hexdump.1.adoc:126
45164 #. type: Plain text
45165 #: ../text-utils/hexdump.1.adoc:128
45167 "The single character escape sequences described in the C standard are "
45172 #: ../text-utils/hexdump.1.adoc:139
45176 "|<alert character> |\\a\n"
45177 "|<backspace> |\\b\n"
45178 "|<form-feed> |\\f\n"
45179 "|<newline> |\\n\n"
45180 "|<carriage return> |\\r\n"
45182 "|<vertical tab> |\\v\n"
45186 #: ../text-utils/hexdump.1.adoc:142
45188 msgid "Conversion strings"
45191 #. type: delimited block _
45192 #: ../text-utils/hexdump.1.adoc:145
45194 "The *hexdump* utility also supports the following additional conversion "
45198 #. type: Labeled list
45199 #: ../text-utils/hexdump.1.adoc:146
45204 #. type: delimited block _
45205 #: ../text-utils/hexdump.1.adoc:148
45207 "Display the input offset, cumulative across input files, of the next byte to "
45208 "be displayed. The appended characters *d*, *o*, and *x* specify the display "
45209 "base as decimal, octal or hexadecimal respectively."
45212 #. type: Labeled list
45213 #: ../text-utils/hexdump.1.adoc:149
45218 #. type: delimited block _
45219 #: ../text-utils/hexdump.1.adoc:151
45221 "Almost identical to the *_a* conversion string except that it is only "
45222 "performed once, when all of the input data has been processed."
45225 #. type: Labeled list
45226 #: ../text-utils/hexdump.1.adoc:152
45231 #. type: delimited block _
45232 #: ../text-utils/hexdump.1.adoc:154
45234 "Output characters in the default character set. Non-printing characters are "
45235 "displayed in three-character, zero-padded octal, except for those "
45236 "representable by standard escape notation (see above), which are displayed "
45237 "as two-character strings."
45240 #. type: Labeled list
45241 #: ../text-utils/hexdump.1.adoc:155
45246 #. type: delimited block _
45247 #: ../text-utils/hexdump.1.adoc:157
45249 "Output characters in the default character set. Non-printing characters are "
45250 "displayed as a single '*.*'."
45253 #. type: Labeled list
45254 #: ../text-utils/hexdump.1.adoc:158
45259 #. type: delimited block _
45260 #: ../text-utils/hexdump.1.adoc:160
45262 "Output US ASCII characters, with the exception that control characters are "
45263 "displayed using the following, lower-case, names. Characters greater than "
45264 "0xff, hexadecimal, are displayed as hexadecimal strings."
45268 #: ../text-utils/hexdump.1.adoc:169
45271 "|000 nul |001 soh |002 stx |003 etx |004 eot |005 enq\n"
45272 "|006 ack |007 bel |008 bs |009 ht |00A lf |00B vt\n"
45273 "|00C ff |00D cr |00E so |00F si |010 dle |011 dc1\n"
45274 "|012 dc2 |013 dc3 |014 dc4 |015 nak |016 syn |017 etb\n"
45275 "|018 can |019 em |01A sub |01B esc |01C fs |01D gs\n"
45276 "|01E rs |01F us |0FF del | | |\n"
45280 #: ../text-utils/hexdump.1.adoc:172
45285 #. type: delimited block _
45286 #: ../text-utils/hexdump.1.adoc:175
45288 "When put at the end of a format specifier, *hexdump* highlights the "
45289 "respective string with the color specified. Conditions, if present, are "
45290 "evaluated prior to highlighting."
45293 #. type: delimited block _
45294 #: ../text-utils/hexdump.1.adoc:177
45296 msgid "*_L[color_unit_1,color_unit_2,...,color_unit_n]*\n"
45299 #. type: delimited block _
45300 #: ../text-utils/hexdump.1.adoc:179
45301 msgid "The full syntax of a color unit is as follows:"
45304 #. type: delimited block _
45305 #: ../text-utils/hexdump.1.adoc:181
45307 msgid "*[!]COLOR[:VALUE][@OFFSET_START[-END]]*\n"
45310 #. type: Labeled list
45311 #: ../text-utils/hexdump.1.adoc:182
45316 #. type: delimited block _
45317 #: ../text-utils/hexdump.1.adoc:184
45319 "Negate the condition. Please note that it only makes sense to negate a unit "
45320 "if both a value/string and an offset are specified. In that case the "
45321 "respective output string will be highlighted if and only if the value/string "
45322 "does not match the one at the offset."
45325 #. type: Labeled list
45326 #: ../text-utils/hexdump.1.adoc:185
45332 #. type: delimited block _
45333 #: ../text-utils/hexdump.1.adoc:187
45334 msgid "One of the 8 basic shell colors."
45337 #. type: Labeled list
45338 #: ../text-utils/hexdump.1.adoc:188
45343 #. type: delimited block _
45344 #: ../text-utils/hexdump.1.adoc:190
45346 "A value to be matched specified in hexadecimal, or octal base, or as a "
45347 "string. Please note that the usual C escape sequences are not interpreted by "
45348 "*hexdump* inside the color_units."
45351 #. type: Labeled list
45352 #: ../text-utils/hexdump.1.adoc:191
45357 #. type: delimited block _
45358 #: ../text-utils/hexdump.1.adoc:193
45360 "An offset or an offset range at which to check for a match. Please note that "
45361 "lone OFFSET_START uses the same value as END offset."
45365 #: ../text-utils/hexdump.1.adoc:194
45370 #. type: delimited block _
45371 #: ../text-utils/hexdump.1.adoc:197
45373 "The default and supported byte counts for the conversion characters are as "
45377 #. type: Labeled list
45378 #: ../text-utils/hexdump.1.adoc:198
45380 msgid "*%_c*, *%_p*, *%_u*, *%c*"
45383 #. type: delimited block _
45384 #: ../text-utils/hexdump.1.adoc:200
45385 msgid "One byte counts only."
45388 #. type: Labeled list
45389 #: ../text-utils/hexdump.1.adoc:201
45391 msgid "*%d*, *%i*, *%o*, *%u*, *%X*, *%x*"
45394 #. type: delimited block _
45395 #: ../text-utils/hexdump.1.adoc:203
45396 msgid "Four byte default, one, two and four byte counts supported."
45399 #. type: Labeled list
45400 #: ../text-utils/hexdump.1.adoc:204
45402 msgid "*%E*, *%e*, *%f*, *%G*, *%g*"
45405 #. type: delimited block _
45406 #: ../text-utils/hexdump.1.adoc:206
45407 msgid "Eight byte default, four byte counts supported."
45410 #. type: delimited block _
45411 #: ../text-utils/hexdump.1.adoc:208
45413 "The amount of data interpreted by each format string is the sum of the data "
45414 "required by each format unit, which is the iteration count times the byte "
45415 "count, or the iteration count times the number of bytes required by the "
45416 "format if the byte count is not specified."
45419 #. type: delimited block _
45420 #: ../text-utils/hexdump.1.adoc:210
45422 "The input is manipulated in _blocks_, where a block is defined as the "
45423 "largest amount of data specified by any format string. Format strings "
45424 "interpreting less than an input block's worth of data, whose last format "
45425 "unit both interprets some number of bytes and does not have a specified "
45426 "iteration count, have the iteration count incremented until the entire input "
45427 "block has been processed or there is not enough data remaining in the block "
45428 "to satisfy the format string."
45431 #. type: delimited block _
45432 #: ../text-utils/hexdump.1.adoc:212
45434 "If, either as a result of user specification or *hexdump* modifying the "
45435 "iteration count as described above, an iteration count is greater than one, "
45436 "no trailing whitespace characters are output during the last iteration."
45439 #. type: delimited block _
45440 #: ../text-utils/hexdump.1.adoc:214
45442 "It is an error to specify a byte count as well as multiple conversion "
45443 "characters or strings unless all but one of the conversion characters or "
45444 "strings is *_a* or *_A*."
45447 #. type: delimited block _
45448 #: ../text-utils/hexdump.1.adoc:216
45450 "If, as a result of the specification of the *-n* option or end-of-file being "
45451 "reached, input data only partially satisfies a format string, the input "
45452 "block is zero-padded sufficiently to display all available data (i.e., any "
45453 "format units overlapping the end of data will display some number of the "
45457 #. TRANSLATORS: Keep {plus} untranslated.
45458 #. type: delimited block _
45459 #: ../text-utils/hexdump.1.adoc:219
45461 "Further output by such format strings is replaced by an equivalent number of "
45462 "spaces. An equivalent number of spaces is defined as the number of spaces "
45463 "output by an *s* conversion character with the same field width and "
45464 "precision as the original conversion character or conversion string but with "
45465 "any '*{plus}*', ' ', '*#*' conversion flag characters removed, and "
45466 "referencing a NULL string."
45469 #. type: delimited block _
45470 #: ../text-utils/hexdump.1.adoc:221
45472 "If no format strings are specified, the default display is very similar to "
45473 "the *-x* output format (the *-x* option causes more space to be used between "
45474 "format units than in the default output)."
45477 #. type: delimited block _
45478 #: ../text-utils/hexdump.1.adoc:225
45480 msgid "*hexdump* exits 0 on success and > 0 if an error occurred.\n"
45483 #. type: delimited block _
45484 #: ../text-utils/hexdump.1.adoc:229
45486 "The *hexdump* utility is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
45490 #. type: delimited block _
45491 #: ../text-utils/hexdump.1.adoc:233
45492 msgid "Display the input in perusal format:"
45495 #. type: delimited block .
45496 #: ../text-utils/hexdump.1.adoc:238
45499 " \"%06.6_ao \" 12/1 \"%3_u \"\n"
45500 " \"\\t\" \"%_p \"\n"
45504 #. type: Plain text
45505 #: ../text-utils/hexdump.1.adoc:241
45506 msgid "Implement the *-x* option:"
45509 #. type: delimited block .
45510 #: ../text-utils/hexdump.1.adoc:245
45513 " \"%07.7_Ax\\n\"\n"
45514 " \"%07.7_ax \" 8/2 \"%04x \" \"\\n\"\n"
45517 #. type: Plain text
45518 #: ../text-utils/hexdump.1.adoc:248
45520 "MBR Boot Signature example: Highlight the addresses cyan and the bytes at "
45521 "offsets 510 and 511 green if their value is 0xAA55, red otherwise."
45524 #. type: delimited block .
45525 #: ../text-utils/hexdump.1.adoc:252
45528 " \"%07.7_Ax_L[cyan]\\n\"\n"
45529 " \"%07.7_ax_L[cyan] \" 8/2 \" %04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] \" \"\\n\"\n"
45536 #. This page is in the public domain
45538 #: ../text-utils/line.1.adoc:3
45540 #| msgid "write(1)"
45544 #. type: Plain text
45545 #: ../text-utils/line.1.adoc:13
45546 msgid "line - read one line"
45549 #. type: Plain text
45550 #: ../text-utils/line.1.adoc:17
45555 #. type: Plain text
45556 #: ../text-utils/line.1.adoc:21
45558 "The utility *line* copies one line (up to a newline) from standard input to "
45559 "standard output. It always prints at least a newline and returns an exit "
45560 "status of 1 on EOF or read error."
45563 #. type: Plain text
45564 #: ../text-utils/line.1.adoc:25
45566 msgid "*read*(1p)\n"
45573 #. Copyright (c) 1988, 1990 The Regents of the University of California.
45574 #. Copyright (c) 1988 Mark Nudleman
45575 #. All rights reserved.
45576 #. Redistribution and use in source and binary forms, with or without
45577 #. modification, are permitted provided that the following conditions
45579 #. 1. Redistributions of source code must retain the above copyright
45580 #. notice, this list of conditions and the following disclaimer.
45581 #. 2. Redistributions in binary form must reproduce the above copyright
45582 #. notice, this list of conditions and the following disclaimer in the
45583 #. documentation and/or other materials provided with the distribution.
45584 #. 3. All advertising materials mentioning features or use of this software
45585 #. must display the following acknowledgement:
45586 #. This product includes software developed by the University of
45587 #. California, Berkeley and its contributors.
45588 #. 4. Neither the name of the University nor the names of its contributors
45589 #. may be used to endorse or promote products derived from this software
45590 #. without specific prior written permission.
45591 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
45592 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45593 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45594 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
45595 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45596 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
45597 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
45598 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
45599 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
45600 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
45602 #. @(#)more.1 5.15 (Berkeley) 7/29/91
45603 #. Copyright (c) 1992 Rik Faith (faith@cs.unc.edu)
45605 #: ../text-utils/more.1.adoc:39
45607 #| msgid "write(1)"
45611 #. type: Plain text
45612 #: ../text-utils/more.1.adoc:49
45613 msgid "more - display the contents of a file in a terminal"
45616 #. type: Plain text
45617 #: ../text-utils/more.1.adoc:53
45619 msgid "*more* [options] _file_ ...\n"
45622 #. type: Plain text
45623 #: ../text-utils/more.1.adoc:57
45625 msgid "*more* is a filter for paging through text one screenful at a time. This version is especially primitive. Users should realize that *less*(1) provides *more*(1) emulation plus extensive enhancements.\n"
45628 #. type: Plain text
45629 #: ../text-utils/more.1.adoc:61
45631 "Options are also taken from the environment variable *MORE* (make sure to "
45632 "precede them with a dash (*-*)) but command-line options will override those."
45635 #. type: Labeled list
45636 #: ../text-utils/more.1.adoc:62
45638 #| msgid "*-f*, *--fast*"
45639 msgid "*-d*, *--silent*"
45640 msgstr "*-f*, *--fast*"
45642 #. type: Plain text
45643 #: ../text-utils/more.1.adoc:64
45645 "Prompt with \"[Press space to continue, 'q' to quit.]\", and display "
45646 "\"[Press 'h' for instructions.]\" instead of ringing the bell when an "
45647 "illegal key is pressed."
45650 #. type: Labeled list
45651 #: ../text-utils/more.1.adoc:65
45653 #| msgid "*-*, *-l*, *--login*"
45654 msgid "*-l*, *--logical*"
45655 msgstr "*-*, *-l*, *--login*"
45657 #. type: Plain text
45658 #: ../text-utils/more.1.adoc:67
45659 msgid "Do not pause after any line containing a *^L* (form feed)."
45662 #. type: Labeled list
45663 #: ../text-utils/more.1.adoc:68
45665 #| msgid "*-V*, *--version*"
45666 msgid "*-e*, *--exit-on-eof*"
45667 msgstr "*-V*, *--version*"
45669 #. type: Plain text
45670 #: ../text-utils/more.1.adoc:70
45672 "Exit on End-Of-File, enabled by default if POSIXLY_CORRECT environment "
45673 "variable is not set or if not executed on terminal."
45676 #. type: Labeled list
45677 #: ../text-utils/more.1.adoc:71
45679 #| msgid "*-f*, *--fast*"
45680 msgid "*-f*, *--no-pause*"
45681 msgstr "*-f*, *--fast*"
45683 #. type: Plain text
45684 #: ../text-utils/more.1.adoc:73
45686 "Count logical lines, rather than screen lines (i.e., long lines are not "
45690 #. type: Labeled list
45691 #: ../text-utils/more.1.adoc:74
45693 #| msgid "*-P*, *--pty*"
45694 msgid "*-p*, *--print-over*"
45695 msgstr "*-P*, *--pty*"
45697 #. type: Plain text
45698 #: ../text-utils/more.1.adoc:76
45700 "Do not scroll. Instead, clear the whole screen and then display the text. "
45701 "Notice that this option is switched on automatically if the executable is "
45705 #. type: Labeled list
45706 #: ../text-utils/more.1.adoc:77
45708 #| msgid "*-V*, *--version*"
45709 msgid "*-c*, *--clean-print*"
45710 msgstr "*-V*, *--version*"
45712 #. type: Plain text
45713 #: ../text-utils/more.1.adoc:79
45715 "Do not scroll. Instead, paint each screen from the top, clearing the "
45716 "remainder of each line as it is displayed."
45719 #. type: Labeled list
45720 #: ../text-utils/more.1.adoc:80
45722 #| msgid "*-h*, *--help*"
45723 msgid "*-s*, *--squeeze*"
45724 msgstr "*-h*, *--help*"
45726 #. type: Plain text
45727 #: ../text-utils/more.1.adoc:82
45728 msgid "Squeeze multiple blank lines into one."
45731 #. type: Labeled list
45732 #: ../text-utils/more.1.adoc:83
45734 #| msgid "*-P*, *--pty*"
45735 msgid "*-u*, *--plain*"
45736 msgstr "*-P*, *--pty*"
45738 #. type: Plain text
45739 #: ../text-utils/more.1.adoc:85
45741 "Suppress underlining. This option is silently ignored as backwards "
45745 #. type: Labeled list
45746 #: ../text-utils/more.1.adoc:86
45748 msgid "*-n*, *--lines* _number_"
45751 #. type: Plain text
45752 #: ../text-utils/more.1.adoc:88
45754 "Specify the _number_ of lines per screenful. The _number_ argument is a "
45755 "positive decimal integer. The *--lines* option shall override any values "
45756 "obtained from any other source, such as number of lines reported by terminal."
45759 #. type: Labeled list
45760 #: ../text-utils/more.1.adoc:89 ../text-utils/pg.1.adoc:36
45762 msgid "**-**__number__"
45765 #. type: Plain text
45766 #: ../text-utils/more.1.adoc:91
45767 msgid "A numeric option means the same as *--lines* option argument."
45770 #. type: Labeled list
45771 #: ../text-utils/more.1.adoc:92 ../text-utils/pg.1.adoc:30
45773 msgid "**+**__number__"
45776 #. type: Plain text
45777 #: ../text-utils/more.1.adoc:94
45778 msgid "Start displaying each file at line _number_."
45781 #. type: Labeled list
45782 #: ../text-utils/more.1.adoc:95
45784 msgid "**+**/__string__"
45787 #. type: Plain text
45788 #: ../text-utils/more.1.adoc:97
45789 msgid "The _string_ to be searched in each file before starting to display it."
45792 #. type: Plain text
45793 #: ../text-utils/more.1.adoc:103
45795 "Interactive commands for *more* are based on *vi*(1). Some commands may be "
45796 "preceded by a decimal number, called k in the descriptions below. In the "
45797 "following descriptions, *^X* means *control-X*."
45800 #. type: Labeled list
45801 #: ../text-utils/more.1.adoc:104
45806 #. type: Plain text
45807 #: ../text-utils/more.1.adoc:106
45809 "Help; display a summary of these commands. If you forget all other commands, "
45810 "remember this one."
45813 #. type: Labeled list
45814 #: ../text-utils/more.1.adoc:107
45819 #. type: Plain text
45820 #: ../text-utils/more.1.adoc:109
45821 msgid "Display next k lines of text. Defaults to current screen size."
45824 #. type: Labeled list
45825 #: ../text-utils/more.1.adoc:110
45830 #. type: Plain text
45831 #: ../text-utils/more.1.adoc:112
45833 "Display next k lines of text. Defaults to current screen size. Argument "
45834 "becomes new default."
45837 #. type: Labeled list
45838 #: ../text-utils/more.1.adoc:113
45843 #. type: Plain text
45844 #: ../text-utils/more.1.adoc:115
45846 "Display next k lines of text. Defaults to 1. Argument becomes new default."
45849 #. type: Labeled list
45850 #: ../text-utils/more.1.adoc:116
45852 msgid "*d* or *^D*"
45855 #. type: Plain text
45856 #: ../text-utils/more.1.adoc:118
45858 "Scroll k lines. Default is current scroll size, initially 11. Argument "
45859 "becomes new default."
45862 #. type: Labeled list
45863 #: ../text-utils/more.1.adoc:119
45865 msgid "*q* or *Q* or *INTERRUPT*"
45868 #. type: Plain text
45869 #: ../text-utils/more.1.adoc:121
45873 #. type: Plain text
45874 #: ../text-utils/more.1.adoc:124
45875 msgid "Skip forward k lines of text. Defaults to 1."
45878 #. type: Labeled list
45879 #: ../text-utils/more.1.adoc:125
45884 #. type: Plain text
45885 #: ../text-utils/more.1.adoc:127
45886 msgid "Skip forward k screenfuls of text. Defaults to 1."
45889 #. type: Labeled list
45890 #: ../text-utils/more.1.adoc:128
45892 msgid "*b* or *^B*"
45895 #. type: Plain text
45896 #: ../text-utils/more.1.adoc:130
45898 "Skip backwards k screenfuls of text. Defaults to 1. Only works with files, "
45902 #. type: Labeled list
45903 #: ../text-utils/more.1.adoc:131
45908 #. type: Plain text
45909 #: ../text-utils/more.1.adoc:133
45910 msgid "Go to the place where the last search started."
45913 #. type: Labeled list
45914 #: ../text-utils/more.1.adoc:134
45919 #. type: Plain text
45920 #: ../text-utils/more.1.adoc:136
45921 msgid "Display current line number."
45924 #. type: Labeled list
45925 #: ../text-utils/more.1.adoc:137
45930 #. type: Plain text
45931 #: ../text-utils/more.1.adoc:139
45932 msgid "Search for kth occurrence of regular expression. Defaults to 1."
45935 #. type: Plain text
45936 #: ../text-utils/more.1.adoc:142
45937 msgid "Search for kth occurrence of last regular expression. Defaults to 1."
45940 #. type: Labeled list
45941 #: ../text-utils/more.1.adoc:143
45943 #| msgid "*-c*, **--command**=__command__"
45944 msgid "*!command* or *:!command*"
45945 msgstr "*-c*, **--command**=__příkaz__"
45947 #. type: Plain text
45948 #: ../text-utils/more.1.adoc:145
45949 msgid "Execute _command_ in a subshell."
45952 #. type: Labeled list
45953 #: ../text-utils/more.1.adoc:146
45958 #. type: Plain text
45959 #: ../text-utils/more.1.adoc:148
45961 "Start up an editor at current line. The editor is taken from the environment "
45962 "variable *VISUAL* if defined, or *EDITOR* if *VISUAL* is not defined, or "
45963 "defaults to *vi*(1) if neither *VISUAL* nor *EDITOR* is defined."
45966 #. type: Labeled list
45967 #: ../text-utils/more.1.adoc:149
45972 #. type: Plain text
45973 #: ../text-utils/more.1.adoc:151
45974 msgid "Redraw screen."
45977 #. type: Labeled list
45978 #: ../text-utils/more.1.adoc:152
45983 #. type: Plain text
45984 #: ../text-utils/more.1.adoc:154
45985 msgid "Go to kth next file. Defaults to 1."
45988 #. type: Labeled list
45989 #: ../text-utils/more.1.adoc:155
45994 #. type: Plain text
45995 #: ../text-utils/more.1.adoc:157
45996 msgid "Go to kth previous file. Defaults to 1."
45999 #. type: Labeled list
46000 #: ../text-utils/more.1.adoc:158
46005 #. type: Plain text
46006 #: ../text-utils/more.1.adoc:160
46007 msgid "Display current file name and line number."
46010 #. type: Labeled list
46011 #: ../text-utils/more.1.adoc:161
46016 #. type: Plain text
46017 #: ../text-utils/more.1.adoc:163
46018 msgid "Repeat previous command."
46021 #. type: Plain text
46022 #: ../text-utils/more.1.adoc:167
46024 "The *more* command respects the following environment variables, if they "
46028 #. type: Labeled list
46029 #: ../text-utils/more.1.adoc:168
46034 #. type: Plain text
46035 #: ../text-utils/more.1.adoc:170
46036 msgid "This variable may be set with favored options to *more*."
46039 #. type: Plain text
46040 #: ../text-utils/more.1.adoc:173
46041 msgid "Current shell in use (normally set by the shell at login time)."
46044 #. type: Labeled list
46045 #: ../text-utils/more.1.adoc:174 ../text-utils/pg.1.adoc:133
46046 #: ../text-utils/ul.1.adoc:69
46051 #. type: Plain text
46052 #: ../text-utils/more.1.adoc:176
46054 "The terminal type used by *more* to get the terminal characteristics "
46055 "necessary to manipulate the screen."
46058 #. type: Labeled list
46059 #: ../text-utils/more.1.adoc:177
46064 #. type: Plain text
46065 #: ../text-utils/more.1.adoc:179
46066 msgid "The editor the user prefers. Invoked when command key _v_ is pressed."
46069 #. type: Plain text
46070 #: ../text-utils/more.1.adoc:182
46071 msgid "The editor of choice when *VISUAL* is not specified."
46074 #. type: Plain text
46075 #: ../text-utils/more.1.adoc:185
46076 msgid "Disable exit-on-eof (see option *-e* for more details)."
46079 #. type: Plain text
46080 #: ../text-utils/more.1.adoc:189
46082 "The *more* command appeared in 3.0BSD. This man page documents *more* "
46083 "version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux "
46084 "community. Documentation was produced using several other versions of the "
46085 "man page, and extensive inspection of the source code."
46088 #. type: Plain text
46089 #: ../text-utils/more.1.adoc:193
46090 msgid "Eric Shienbrood, UC Berkeley."
46093 #. type: Plain text
46094 #: ../text-utils/more.1.adoc:195
46095 msgid "Modified by Geoff Peck, UCB to add underlining, single spacing."
46098 #. type: Plain text
46099 #: ../text-utils/more.1.adoc:197
46100 msgid "Modified by John Foderaro, UCB to add -c and MORE environment variable."
46103 #. type: Plain text
46104 #: ../text-utils/more.1.adoc:202
46118 #. Copyright 2001 Gunnar Ritter
46120 #: ../text-utils/pg.1.adoc:3
46125 #. type: Plain text
46126 #: ../text-utils/pg.1.adoc:13
46127 msgid "pg - browse pagewise through text files"
46130 #. type: Plain text
46131 #: ../text-utils/pg.1.adoc:17
46133 msgid "*pg* *-*_amount_ *-p* _prompt_ *-cefnrs* +line +/pattern/ file_ ...\n"
46136 #. type: Plain text
46137 #: ../text-utils/pg.1.adoc:21
46139 msgid "*pg* displays a text file on a CRT one screenful at once. After each page, a prompt is displayed. The user may then either press the newline key to view the next page or one of the keys described below.\n"
46142 #. type: Plain text
46143 #: ../text-utils/pg.1.adoc:23
46145 "If no filename is given on the command line, *pg* reads from standard input. "
46146 "If standard output is not a terminal, *pg* acts like *cat*(1) but precedes "
46147 "each file with its name if there is more than one."
46150 #. type: Plain text
46151 #: ../text-utils/pg.1.adoc:25
46153 "If input comes from a pipe, *pg* stores the data in a buffer file while "
46154 "reading, to make navigation possible."
46157 #. type: Plain text
46158 #: ../text-utils/pg.1.adoc:29
46160 msgid "*pg* accepts the following options:\n"
46163 #. type: Plain text
46164 #: ../text-utils/pg.1.adoc:32
46165 msgid "Start at the given line number."
46168 #. type: Labeled list
46169 #: ../text-utils/pg.1.adoc:33
46171 msgid "**+/**__pattern__*/*"
46174 #. type: Plain text
46175 #: ../text-utils/pg.1.adoc:35
46177 "Start at the line containing the Basic Regular Expression _pattern_ given."
46180 #. type: Plain text
46181 #: ../text-utils/pg.1.adoc:38
46183 "The number of lines per page. By default, this is the number of CRT lines "
46187 #. type: Plain text
46188 #: ../text-utils/pg.1.adoc:41
46190 "Clear the screen before a page is displayed, if the terminfo entry for the "
46191 "terminal provides this capability."
46194 #. type: Labeled list
46195 #: ../text-utils/pg.1.adoc:42
46200 #. type: Plain text
46201 #: ../text-utils/pg.1.adoc:44
46202 msgid "Do not pause and display _(EOF)_ at the end of a file."
46205 #. type: Plain text
46206 #: ../text-utils/pg.1.adoc:47
46207 msgid "Do not split long lines."
46210 #. type: Labeled list
46211 #: ../text-utils/pg.1.adoc:48
46216 #. type: Plain text
46217 #: ../text-utils/pg.1.adoc:50
46219 "Without this option, commands must be terminated by a newline character."
46222 #. type: Plain text
46223 #: ../text-utils/pg.1.adoc:52
46224 msgid "With this option, *pg* advances once a command letter is entered."
46227 #. type: Labeled list
46228 #: ../text-utils/pg.1.adoc:53
46230 msgid "*-p* _string_"
46233 #. type: Plain text
46234 #: ../text-utils/pg.1.adoc:55
46236 "Instead of the normal prompt _:_, _string_ is displayed. If _string_ "
46237 "contains *%d*, its first occurrence is replaced by the number of the current "
46241 #. type: Labeled list
46242 #: ../text-utils/pg.1.adoc:56
46247 #. type: Plain text
46248 #: ../text-utils/pg.1.adoc:58
46249 msgid "Disallow the shell escape."
46252 #. type: Plain text
46253 #: ../text-utils/pg.1.adoc:61
46255 "Print messages in _standout_ mode, if the terminfo entry for the terminal "
46256 "provides this capability."
46259 #. type: Plain text
46260 #: ../text-utils/pg.1.adoc:67
46262 "The following commands may be entered at the prompt. Commands preceded by "
46263 "_i_ in this document accept a number as argument, positive or negative. If "
46264 "this argument starts with *+* or *-*, it is interpreted relative to the "
46265 "current position in the input file, otherwise relative to the beginning."
46268 #. type: Labeled list
46269 #: ../text-utils/pg.1.adoc:68
46271 msgid "__i__**<Enter>**"
46274 #. type: Plain text
46275 #: ../text-utils/pg.1.adoc:70
46277 #| msgid "Display help text and exit."
46278 msgid "Display the next or the indicated page."
46279 msgstr "Zobrazí text nápovědy a skončí."
46281 #. type: Labeled list
46282 #: ../text-utils/pg.1.adoc:71
46284 msgid "__i__**d** or *^D*"
46287 #. type: Plain text
46288 #: ../text-utils/pg.1.adoc:73
46290 "Display the next halfpage. If _i_ is given, it is always interpreted "
46291 "relative to the current position."
46294 #. type: Labeled list
46295 #: ../text-utils/pg.1.adoc:74
46300 #. type: Plain text
46301 #: ../text-utils/pg.1.adoc:76
46303 #| msgid "Display help text and exit."
46304 msgid "Display the next or the indicated line."
46305 msgstr "Zobrazí text nápovědy a skončí."
46307 #. type: Labeled list
46308 #: ../text-utils/pg.1.adoc:77
46313 #. type: Plain text
46314 #: ../text-utils/pg.1.adoc:79
46316 "Skip a page forward. _i_ must be a positive number and is always interpreted "
46317 "relative to the current position."
46320 #. type: Labeled list
46321 #: ../text-utils/pg.1.adoc:80
46323 msgid "__i__**w** or __i__**z**"
46326 #. type: Plain text
46327 #: ../text-utils/pg.1.adoc:82
46328 msgid "As *<Enter>* except that _i_ becomes the new page size."
46331 #. type: Labeled list
46332 #: ../text-utils/pg.1.adoc:83
46334 msgid "*.* or *^L*"
46337 #. type: Plain text
46338 #: ../text-utils/pg.1.adoc:85
46339 msgid "Redraw the screen."
46342 #. type: Labeled list
46343 #: ../text-utils/pg.1.adoc:86
46348 #. type: Plain text
46349 #: ../text-utils/pg.1.adoc:88
46350 msgid "Advance to the last line of the input file."
46353 #. type: Labeled list
46354 #: ../text-utils/pg.1.adoc:89
46356 msgid "__i__**/**__pattern__**/**"
46359 #. type: Plain text
46360 #: ../text-utils/pg.1.adoc:91
46362 "Search forward until the first or the _i_-th occurrence of the Basic Regular "
46363 "Expression _pattern_ is found. The search starts after the current page and "
46364 "stops at the end of the file. No wrap-around is performed. _i_ must be a "
46368 #. type: Labeled list
46369 #: ../text-utils/pg.1.adoc:92
46371 msgid "__i__**?**__pattern__**?** or __i__**^**__pattern__**^**"
46374 #. type: Plain text
46375 #: ../text-utils/pg.1.adoc:94
46377 "Search backward until the first or the _i_-th occurrence of the Basic "
46378 "Regular Expression _pattern_ is found. The search starts before the current "
46379 "page and stops at the beginning of the file. No wrap-around is performed. "
46380 "_i_ must be a positive number."
46383 #. type: Plain text
46384 #: ../text-utils/pg.1.adoc:96
46386 "The search commands accept an added letter. If *t* is given, the line "
46387 "containing the pattern is displayed at the top of the screen, which is the "
46388 "default. *m* selects the middle and *b* the bottom of the screen. The "
46389 "selected position is used in following searches, too."
46392 #. type: Labeled list
46393 #: ../text-utils/pg.1.adoc:97
46398 #. type: Plain text
46399 #: ../text-utils/pg.1.adoc:99
46400 msgid "Advance to the next file or _i_ files forward."
46403 #. type: Labeled list
46404 #: ../text-utils/pg.1.adoc:100
46409 #. type: Plain text
46410 #: ../text-utils/pg.1.adoc:102
46411 msgid "Reread the previous file or _i_ files backward."
46414 #. type: Labeled list
46415 #: ../text-utils/pg.1.adoc:103
46417 msgid "*s* _filename_"
46420 #. type: Plain text
46421 #: ../text-utils/pg.1.adoc:105
46422 msgid "Save the current file to the given _filename_."
46425 #. type: Plain text
46426 #: ../text-utils/pg.1.adoc:108
46427 msgid "Display a command summary."
46430 #. type: Labeled list
46431 #: ../text-utils/pg.1.adoc:109
46433 #| msgid "*-c*, **--command**=__command__"
46434 msgid "**!**__command__"
46435 msgstr "*-c*, **--command**=__příkaz__"
46437 #. type: Plain text
46438 #: ../text-utils/pg.1.adoc:111
46439 msgid "Execute _command_ using the shell."
46442 #. type: Labeled list
46443 #: ../text-utils/pg.1.adoc:112
46448 #. type: Plain text
46449 #: ../text-utils/pg.1.adoc:114
46453 #. type: Plain text
46454 #: ../text-utils/pg.1.adoc:116
46456 "If the user presses the interrupt or quit key while *pg* reads from the "
46457 "input file or writes on the terminal, *pg* will immediately display the "
46458 "prompt. In all other situations these keys will terminate *pg*."
46461 #. type: Plain text
46462 #: ../text-utils/pg.1.adoc:120
46463 msgid "The following environment variables affect the behavior of *pg*:"
46466 #. type: Labeled list
46467 #: ../text-utils/pg.1.adoc:121
46472 #. type: Plain text
46473 #: ../text-utils/pg.1.adoc:123
46474 msgid "Overrides the system-supplied number of columns if set."
46477 #. type: Labeled list
46478 #: ../text-utils/pg.1.adoc:124
46480 msgid "*LANG*, *LC_ALL*, *LC_COLLATE*, *LC_CTYPE*, *LC_MESSAGES*"
46483 #. type: Plain text
46484 #: ../text-utils/pg.1.adoc:126
46485 msgid "See *locale*(7)."
46488 #. type: Labeled list
46489 #: ../text-utils/pg.1.adoc:127
46494 #. type: Plain text
46495 #: ../text-utils/pg.1.adoc:129
46496 msgid "Overrides the system-supplied number of lines if set."
46499 #. type: Plain text
46500 #: ../text-utils/pg.1.adoc:132
46501 msgid "Used by the *!* command."
46504 #. type: Plain text
46505 #: ../text-utils/pg.1.adoc:135
46506 msgid "Determines the terminal type."
46509 #. type: Plain text
46510 #: ../text-utils/pg.1.adoc:139
46512 msgid "*pg* expects the terminal tabulators to be set every eight positions.\n"
46515 #. type: Plain text
46516 #: ../text-utils/pg.1.adoc:141
46517 msgid "Files that include NUL characters cannot be displayed by *pg*."
46520 #. type: Plain text
46521 #: ../text-utils/pg.1.adoc:151
46536 #. Copyright (c) 1985, 1992 The Regents of the University of California.
46537 #. All rights reserved.
46538 #. Redistribution and use in source and binary forms, with or without
46539 #. modification, are permitted provided that the following conditions
46541 #. 1. Redistributions of source code must retain the above copyright
46542 #. notice, this list of conditions and the following disclaimer.
46543 #. 2. Redistributions in binary form must reproduce the above copyright
46544 #. notice, this list of conditions and the following disclaimer in the
46545 #. documentation and/or other materials provided with the distribution.
46546 #. 3. All advertising materials mentioning features or use of this software
46547 #. must display the following acknowledgement:
46548 #. This product includes software developed by the University of
46549 #. California, Berkeley and its contributors.
46550 #. 4. Neither the name of the University nor the names of its contributors
46551 #. may be used to endorse or promote products derived from this software
46552 #. without specific prior written permission.
46553 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46554 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46555 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46556 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
46557 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46558 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46559 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46560 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
46561 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
46562 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46564 #. @(#)rev.1 6.3 (Berkeley) 3/21/92
46566 #: ../text-utils/rev.1.adoc:36
46571 #. type: Plain text
46572 #: ../text-utils/rev.1.adoc:46
46573 msgid "rev - reverse lines characterwise"
46576 #. type: Plain text
46577 #: ../text-utils/rev.1.adoc:50
46579 msgid "*rev* [option] [_file_...]\n"
46582 #. type: Plain text
46583 #: ../text-utils/rev.1.adoc:54
46585 "The *rev* utility copies the specified files to standard output, reversing "
46586 "the order of characters in every line. If no files are specified, standard "
46590 #. type: Plain text
46591 #: ../text-utils/rev.1.adoc:56
46593 "This utility is a line-oriented tool and it uses in-memory allocated buffer "
46594 "for a whole wide-char line. If the input file is huge and without line "
46595 "breaks then allocating the memory for the file may be unsuccessful."
46598 #. type: Labeled list
46599 #: ../text-utils/rev.1.adoc:61
46601 #| msgid "*-V*, *--version*"
46602 msgid "*-0*, *--zero*"
46603 msgstr "*-V*, *--version*"
46605 #. type: Plain text
46606 #: ../text-utils/rev.1.adoc:63
46607 msgid "_Zero termination_. Use the byte '\\0' as line separator."
46610 #. type: Plain text
46611 #: ../text-utils/rev.1.adoc:67
46619 #. Copyright (c) 1980, 1991, 1993
46620 #. The Regents of the University of California. All rights reserved.
46621 #. Redistribution and use in source and binary forms, with or without
46622 #. modification, are permitted provided that the following conditions
46624 #. 1. Redistributions of source code must retain the above copyright
46625 #. notice, this list of conditions and the following disclaimer.
46626 #. 2. Redistributions in binary form must reproduce the above copyright
46627 #. notice, this list of conditions and the following disclaimer in the
46628 #. documentation and/or other materials provided with the distribution.
46629 #. 3. All advertising materials mentioning features or use of this software
46630 #. must display the following acknowledgement:
46631 #. This product includes software developed by the University of
46632 #. California, Berkeley and its contributors.
46633 #. 4. Neither the name of the University nor the names of its contributors
46634 #. may be used to endorse or promote products derived from this software
46635 #. without specific prior written permission.
46636 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46637 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46638 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46639 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
46640 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46641 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46642 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46643 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
46644 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
46645 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46647 #. @(#)ul.1 8.1 (Berkeley) 6/6/93
46649 #: ../text-utils/ul.1.adoc:36
46654 #. type: Plain text
46655 #: ../text-utils/ul.1.adoc:46
46656 msgid "ul - do underlining"
46659 #. type: Plain text
46660 #: ../text-utils/ul.1.adoc:50
46662 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
46663 msgid "*ul* [options] [_file_...]\n"
46664 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
46666 #. type: Plain text
46667 #: ../text-utils/ul.1.adoc:54
46669 msgid "*ul* reads the named files (or standard input if none are given) and translates occurrences of underscores to the sequence which indicates underlining for the terminal in use, as specified by the environment variable *TERM*. The _terminfo_ database is read to determine the appropriate sequences for underlining. If the terminal is incapable of underlining but is capable of a standout mode, then that is used instead. If the terminal can overstrike, or handles underlining automatically, *ul* degenerates to *cat*(1). If the terminal cannot underline, underlining is ignored.\n"
46672 #. type: Labeled list
46673 #: ../text-utils/ul.1.adoc:57
46675 #| msgid "*-f*, *--fast*"
46676 msgid "*-i*, *--indicated*"
46677 msgstr "*-f*, *--fast*"
46679 #. type: Plain text
46680 #: ../text-utils/ul.1.adoc:59
46682 "Underlining is indicated by a separate line containing appropriate dashes "
46683 "`-'; this is useful when you want to look at the underlining which is "
46684 "present in an *nroff* output stream on a crt-terminal."
46687 #. type: Labeled list
46688 #: ../text-utils/ul.1.adoc:60
46690 msgid "*-t*, *-T*, *--terminal* _terminal_"
46693 #. type: Plain text
46694 #: ../text-utils/ul.1.adoc:62
46697 #| "clears all the environment variables except *TERM* and variables "
46698 #| "specified by *--whitelist-environment*"
46700 "Override the environment variable *TERM* with the specified _terminal_ type."
46702 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
46703 "whitelist-environment*"
46705 #. type: Plain text
46706 #: ../text-utils/ul.1.adoc:68
46707 msgid "The following environment variable is used:"
46710 #. type: Plain text
46711 #: ../text-utils/ul.1.adoc:71
46713 "The *TERM* variable is used to relate a tty device with its device "
46714 "capability description (see *terminfo*(5)). *TERM* is set at login time, "
46715 "either by the default terminal type specified in _/etc/ttys_ or as set "
46716 "during the login process by the user in their _login_ file (see *setenv*(3))."
46719 #. type: Plain text
46720 #: ../text-utils/ul.1.adoc:75
46722 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
46723 msgid "The *ul* command appeared in 3.0BSD."
46724 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
46726 #. type: Plain text
46727 #: ../text-utils/ul.1.adoc:79
46729 msgid "*nroff* usually outputs a series of backspaces and underlines intermixed with the text to indicate underlining. No attempt is made to optimize the backward motion.\n"
46732 #. type: Plain text
46733 #: ../text-utils/ul.1.adoc:88
46745 #~| msgid "*-h*, *--help*"
46746 #~ msgid "*y-*, *--shell*"
46747 #~ msgstr "*-h*, *--help*"
46750 #~| msgid "A *write* command appeared in Version 6 AT&T UNIX."
46751 #~ msgid "A *mesg* command appeared in Version 6 AT&T UNIX."
46752 #~ msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
46754 #~ msgid "use default options: rw, suid, dev, exec, auto, nouser, and async."
46755 #~ msgstr "použije výchozí volby: rw, suid, dev, exec, auto, nouser a async."