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: 2024-01-24 10:55+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/enosys.1.adoc:9
272 #: ../misc-utils/exch.1.adoc:9 ../misc-utils/fadvise.1.adoc:9
273 #: ../misc-utils/fincore.1.adoc:15 ../misc-utils/findfs.8.adoc:11
274 #: ../misc-utils/findmnt.8.adoc:10 ../misc-utils/getopt.1.adoc:10
275 #: ../misc-utils/hardlink.1.adoc:15 ../misc-utils/kill.1.adoc:14
276 #: ../misc-utils/logger.1.adoc:43 ../misc-utils/look.1.adoc:43
277 #: ../misc-utils/lsblk.8.adoc:9 ../misc-utils/lsclocks.1.adoc:9
278 #: ../misc-utils/lsfd.1.adoc:15 ../misc-utils/lslocks.8.adoc:20
279 #: ../misc-utils/mcookie.1.adoc:11 ../misc-utils/namei.1.adoc:9
280 #: ../misc-utils/pipesz.1.adoc:9 ../misc-utils/rename.1.adoc:11
281 #: ../misc-utils/uuidd.8.adoc:13 ../misc-utils/uuidgen.1.adoc:13
282 #: ../misc-utils/uuidparse.1.adoc:11 ../misc-utils/waitpid.1.adoc:9
283 #: ../misc-utils/whereis.1.adoc:43 ../misc-utils/wipefs.8.adoc:11
284 #: ../schedutils/chrt.1.adoc:34 ../schedutils/ionice.1.adoc:10
285 #: ../schedutils/taskset.1.adoc:33 ../schedutils/uclampset.1.adoc:34
286 #: ../sys-utils/adjtime_config.5.adoc:9 ../sys-utils/blkdiscard.8.adoc:9
287 #: ../sys-utils/blkzone.8.adoc:9 ../sys-utils/blkpr.8.adoc:9
288 #: ../sys-utils/chcpu.8.adoc:9 ../sys-utils/chmem.8.adoc:9
289 #: ../sys-utils/choom.1.adoc:9 ../sys-utils/ctrlaltdel.8.adoc:13
290 #: ../sys-utils/dmesg.1.adoc:13 ../sys-utils/eject.1.adoc:17
291 #: ../sys-utils/fallocate.1.adoc:9 ../sys-utils/flock.1.adoc:34
292 #: ../sys-utils/fsfreeze.8.adoc:9 ../sys-utils/fstab.5.adoc:43
293 #: ../sys-utils/fstrim.8.adoc:9 ../sys-utils/hwclock.8.adoc:17
294 #: ../sys-utils/ipcmk.1.adoc:13 ../sys-utils/ipcrm.1.adoc:14
295 #: ../sys-utils/ipcs.1.adoc:13 ../sys-utils/irqtop.1.adoc:9
296 #: ../sys-utils/ldattach.8.adoc:13 ../sys-utils/losetup.8.adoc:9
297 #: ../sys-utils/lscpu.1.adoc:9 ../sys-utils/lsipc.1.adoc:9
298 #: ../sys-utils/lsirq.1.adoc:9 ../sys-utils/lsmem.1.adoc:9
299 #: ../sys-utils/lsns.8.adoc:14 ../sys-utils/mount.8.adoc:40
300 #: ../sys-utils/mountpoint.1.adoc:9 ../sys-utils/nsenter.1.adoc:9
301 #: ../sys-utils/pivot_root.8.adoc:9 ../sys-utils/prlimit.1.adoc:15
302 #: ../sys-utils/readprofile.8.adoc:9 ../sys-utils/renice.1.adoc:43
303 #: ../sys-utils/rfkill.8.adoc:9 ../sys-utils/rtcwake.8.adoc:9
304 #: ../sys-utils/setarch.8.adoc:9 ../sys-utils/setpriv.1.adoc:9
305 #: ../sys-utils/setsid.1.adoc:11 ../sys-utils/swapon.8.adoc:9
306 #: ../sys-utils/switch_root.8.adoc:9 ../sys-utils/tunelp.8.adoc:9
307 #: ../sys-utils/umount.8.adoc:34 ../sys-utils/unshare.1.adoc:9
308 #: ../sys-utils/wdctl.8.adoc:9 ../sys-utils/zramctl.8.adoc:9
309 #: ../term-utils/agetty.8.adoc:9 ../term-utils/mesg.1.adoc:43
310 #: ../term-utils/script.1.adoc:44 ../term-utils/scriptlive.1.adoc:10
311 #: ../term-utils/scriptreplay.1.adoc:10 ../term-utils/setterm.1.adoc:16
312 #: ../term-utils/wall.1.adoc:44 ../term-utils/write.1.adoc:46
313 #: ../text-utils/col.1.adoc:46 ../text-utils/colcrt.1.adoc:44
314 #: ../text-utils/colrm.1.adoc:43 ../text-utils/column.1.adoc:43
315 #: ../text-utils/hexdump.1.adoc:45 ../text-utils/line.1.adoc:10
316 #: ../text-utils/more.1.adoc:46 ../text-utils/pg.1.adoc:10
317 #: ../text-utils/rev.1.adoc:43 ../text-utils/ul.1.adoc:43
323 #: ../disk-utils/addpart.8.adoc:18
324 msgid "addpart - tell the kernel about the existence of a partition"
328 #: ../disk-utils/addpart.8.adoc:19 ../disk-utils/blockdev.8.adoc:19
329 #: ../disk-utils/cfdisk.8.adoc:27 ../disk-utils/delpart.8.adoc:19
330 #: ../disk-utils/fdformat.8.adoc:17 ../disk-utils/fdisk.8.adoc:21
331 #: ../disk-utils/fsck.8.adoc:17 ../disk-utils/fsck.cramfs.8.adoc:13
332 #: ../disk-utils/fsck.minix.8.adoc:17 ../disk-utils/isosize.8.adoc:13
333 #: ../disk-utils/mkfs.8.adoc:13 ../disk-utils/mkfs.bfs.8.adoc:17
334 #: ../disk-utils/mkfs.cramfs.8.adoc:13 ../disk-utils/mkfs.minix.8.adoc:20
335 #: ../disk-utils/mkswap.8.adoc:17 ../disk-utils/partx.8.adoc:20
336 #: ../disk-utils/raw.8.adoc:13 ../disk-utils/resizepart.8.adoc:19
337 #: ../disk-utils/sfdisk.8.adoc:28 ../disk-utils/swaplabel.8.adoc:17
338 #: ../lib/terminal-colors.d.5.adoc:21 ../libblkid/libblkid.3.adoc:20
339 #: ../libuuid/man/uuid.3.adoc:45 ../libuuid/man/uuid_clear.3.adoc:45
340 #: ../libuuid/man/uuid_compare.3.adoc:45 ../libuuid/man/uuid_copy.3.adoc:45
341 #: ../libuuid/man/uuid_generate.3.adoc:47 ../libuuid/man/uuid_is_null.3.adoc:45
342 #: ../libuuid/man/uuid_parse.3.adoc:45 ../libuuid/man/uuid_time.3.adoc:45
343 #: ../libuuid/man/uuid_unparse.3.adoc:45 ../login-utils/chfn.1.adoc:21
344 #: ../login-utils/chsh.1.adoc:21 ../login-utils/last.1.adoc:30
345 #: ../login-utils/login.1.adoc:17 ../login-utils/lslogins.1.adoc:15
346 #: ../login-utils/newgrp.1.adoc:15 ../login-utils/nologin.8.adoc:13
347 #: ../login-utils/runuser.1.adoc:13 ../login-utils/su.1.adoc:14
348 #: ../login-utils/sulogin.8.adoc:32 ../login-utils/utmpdump.1.adoc:30
349 #: ../login-utils/vipw.8.adoc:47 ../misc-utils/blkid.8.adoc:16
350 #: ../misc-utils/cal.1.adoc:51 ../misc-utils/enosys.1.adoc:13
351 #: ../misc-utils/exch.1.adoc:13 ../misc-utils/fadvise.1.adoc:13
352 #: ../misc-utils/fincore.1.adoc:19 ../misc-utils/findfs.8.adoc:15
353 #: ../misc-utils/findmnt.8.adoc:14 ../misc-utils/getopt.1.adoc:14
354 #: ../misc-utils/hardlink.1.adoc:19 ../misc-utils/kill.1.adoc:18
355 #: ../misc-utils/logger.1.adoc:47 ../misc-utils/look.1.adoc:47
356 #: ../misc-utils/lsblk.8.adoc:13 ../misc-utils/lsclocks.1.adoc:13
357 #: ../misc-utils/lsfd.1.adoc:19 ../misc-utils/lslocks.8.adoc:24
358 #: ../misc-utils/mcookie.1.adoc:15 ../misc-utils/namei.1.adoc:13
359 #: ../misc-utils/pipesz.1.adoc:13 ../misc-utils/rename.1.adoc:15
360 #: ../misc-utils/uuidd.8.adoc:17 ../misc-utils/uuidgen.1.adoc:17
361 #: ../misc-utils/uuidparse.1.adoc:15 ../misc-utils/waitpid.1.adoc:13
362 #: ../misc-utils/whereis.1.adoc:47 ../misc-utils/wipefs.8.adoc:15
363 #: ../schedutils/chrt.1.adoc:38 ../schedutils/ionice.1.adoc:14
364 #: ../schedutils/taskset.1.adoc:37 ../schedutils/uclampset.1.adoc:39
365 #: ../sys-utils/adjtime_config.5.adoc:13 ../sys-utils/blkdiscard.8.adoc:13
366 #: ../sys-utils/blkzone.8.adoc:13 ../sys-utils/blkpr.8.adoc:13
367 #: ../sys-utils/chcpu.8.adoc:13 ../sys-utils/chmem.8.adoc:13
368 #: ../sys-utils/ctrlaltdel.8.adoc:17 ../sys-utils/dmesg.1.adoc:17
369 #: ../sys-utils/fallocate.1.adoc:13 ../sys-utils/flock.1.adoc:38
370 #: ../sys-utils/fsfreeze.8.adoc:13 ../sys-utils/fstab.5.adoc:47
371 #: ../sys-utils/fstrim.8.adoc:13 ../sys-utils/hwclock.8.adoc:21
372 #: ../sys-utils/ipcmk.1.adoc:17 ../sys-utils/ipcrm.1.adoc:18
373 #: ../sys-utils/ipcs.1.adoc:17 ../sys-utils/irqtop.1.adoc:13
374 #: ../sys-utils/ldattach.8.adoc:17 ../sys-utils/losetup.8.adoc:13
375 #: ../sys-utils/lscpu.1.adoc:13 ../sys-utils/lsipc.1.adoc:13
376 #: ../sys-utils/lsirq.1.adoc:13 ../sys-utils/lsmem.1.adoc:13
377 #: ../sys-utils/lsns.8.adoc:18 ../sys-utils/mount.8.adoc:44
378 #: ../sys-utils/mountpoint.1.adoc:13 ../sys-utils/nsenter.1.adoc:13
379 #: ../sys-utils/pivot_root.8.adoc:13 ../sys-utils/prlimit.1.adoc:19
380 #: ../sys-utils/readprofile.8.adoc:13 ../sys-utils/renice.1.adoc:47
381 #: ../sys-utils/rfkill.8.adoc:13 ../sys-utils/rtcwake.8.adoc:13
382 #: ../sys-utils/setarch.8.adoc:13 ../sys-utils/setpriv.1.adoc:13
383 #: ../sys-utils/setsid.1.adoc:15 ../sys-utils/swapon.8.adoc:13
384 #: ../sys-utils/switch_root.8.adoc:13 ../sys-utils/tunelp.8.adoc:13
385 #: ../sys-utils/umount.8.adoc:38 ../sys-utils/unshare.1.adoc:13
386 #: ../sys-utils/wdctl.8.adoc:13 ../sys-utils/zramctl.8.adoc:13
387 #: ../term-utils/agetty.8.adoc:13 ../term-utils/mesg.1.adoc:47
388 #: ../term-utils/script.1.adoc:48 ../term-utils/scriptlive.1.adoc:14
389 #: ../term-utils/scriptreplay.1.adoc:14 ../term-utils/setterm.1.adoc:20
390 #: ../term-utils/wall.1.adoc:48 ../term-utils/write.1.adoc:50
391 #: ../text-utils/col.1.adoc:50 ../text-utils/colcrt.1.adoc:48
392 #: ../text-utils/colrm.1.adoc:47 ../text-utils/column.1.adoc:47
393 #: ../text-utils/hexdump.1.adoc:49 ../text-utils/line.1.adoc:14
394 #: ../text-utils/more.1.adoc:50 ../text-utils/pg.1.adoc:14
395 #: ../text-utils/rev.1.adoc:47 ../text-utils/ul.1.adoc:47
401 #: ../disk-utils/addpart.8.adoc:22
403 msgid "*addpart* _device partition start length_\n"
407 #: ../disk-utils/addpart.8.adoc:23 ../disk-utils/blockdev.8.adoc:27
408 #: ../disk-utils/cfdisk.8.adoc:31 ../disk-utils/delpart.8.adoc:23
409 #: ../disk-utils/fdformat.8.adoc:21 ../disk-utils/fdisk.8.adoc:27
410 #: ../disk-utils/fsck.8.adoc:21 ../disk-utils/fsck.cramfs.8.adoc:17
411 #: ../disk-utils/fsck.minix.8.adoc:21 ../disk-utils/isosize.8.adoc:17
412 #: ../disk-utils/mkfs.8.adoc:17 ../disk-utils/mkfs.bfs.8.adoc:21
413 #: ../disk-utils/mkfs.cramfs.8.adoc:17 ../disk-utils/mkfs.minix.8.adoc:24
414 #: ../disk-utils/mkswap.8.adoc:23 ../disk-utils/partx.8.adoc:26
415 #: ../disk-utils/raw.8.adoc:23 ../disk-utils/resizepart.8.adoc:23
416 #: ../disk-utils/sfdisk.8.adoc:34 ../disk-utils/swaplabel.8.adoc:21
417 #: ../lib/terminal-colors.d.5.adoc:25 ../libblkid/libblkid.3.adoc:26
418 #: ../libuuid/man/uuid.3.adoc:49 ../libuuid/man/uuid_clear.3.adoc:51
419 #: ../libuuid/man/uuid_compare.3.adoc:51 ../libuuid/man/uuid_copy.3.adoc:51
420 #: ../libuuid/man/uuid_generate.3.adoc:58 ../libuuid/man/uuid_is_null.3.adoc:51
421 #: ../libuuid/man/uuid_parse.3.adoc:52 ../libuuid/man/uuid_time.3.adoc:51
422 #: ../libuuid/man/uuid_unparse.3.adoc:53 ../login-utils/chfn.1.adoc:25
423 #: ../login-utils/chsh.1.adoc:25 ../login-utils/last.1.adoc:36
424 #: ../login-utils/login.1.adoc:21 ../login-utils/lslogins.1.adoc:19
425 #: ../login-utils/newgrp.1.adoc:19 ../login-utils/nologin.8.adoc:17
426 #: ../login-utils/runuser.1.adoc:19 ../login-utils/su.1.adoc:18
427 #: ../login-utils/sulogin.8.adoc:36 ../login-utils/utmpdump.1.adoc:34
428 #: ../login-utils/vipw.8.adoc:53 ../misc-utils/blkid.8.adoc:26
429 #: ../misc-utils/cal.1.adoc:57 ../misc-utils/enosys.1.adoc:17
430 #: ../misc-utils/exch.1.adoc:17 ../misc-utils/fadvise.1.adoc:19
431 #: ../misc-utils/fincore.1.adoc:23 ../misc-utils/findfs.8.adoc:19
432 #: ../misc-utils/findmnt.8.adoc:22 ../misc-utils/getopt.1.adoc:22
433 #: ../misc-utils/hardlink.1.adoc:23 ../misc-utils/kill.1.adoc:25
434 #: ../misc-utils/logger.1.adoc:51 ../misc-utils/look.1.adoc:51
435 #: ../misc-utils/lsblk.8.adoc:17 ../misc-utils/lsclocks.1.adoc:17
436 #: ../misc-utils/lsfd.1.adoc:23 ../misc-utils/lslocks.8.adoc:28
437 #: ../misc-utils/mcookie.1.adoc:19 ../misc-utils/namei.1.adoc:17
438 #: ../misc-utils/pipesz.1.adoc:19 ../misc-utils/rename.1.adoc:19
439 #: ../misc-utils/uuidd.8.adoc:21 ../misc-utils/uuidgen.1.adoc:21
440 #: ../misc-utils/uuidparse.1.adoc:19 ../misc-utils/waitpid.1.adoc:17
441 #: ../misc-utils/whereis.1.adoc:51 ../misc-utils/wipefs.8.adoc:24
442 #: ../schedutils/chrt.1.adoc:44 ../schedutils/ionice.1.adoc:24
443 #: ../schedutils/taskset.1.adoc:43 ../schedutils/uclampset.1.adoc:45
444 #: ../sys-utils/adjtime_config.5.adoc:17 ../sys-utils/blkdiscard.8.adoc:17
445 #: ../sys-utils/blkzone.8.adoc:17 ../sys-utils/blkpr.8.adoc:17
446 #: ../sys-utils/chcpu.8.adoc:21 ../sys-utils/chmem.8.adoc:17
447 #: ../sys-utils/choom.1.adoc:19 ../sys-utils/ctrlaltdel.8.adoc:21
448 #: ../sys-utils/dmesg.1.adoc:31 ../sys-utils/eject.1.adoc:23
449 #: ../sys-utils/fallocate.1.adoc:21 ../sys-utils/flock.1.adoc:46
450 #: ../sys-utils/fsfreeze.8.adoc:17 ../sys-utils/fstab.5.adoc:51
451 #: ../sys-utils/fstrim.8.adoc:17 ../sys-utils/hwclock.8.adoc:25
452 #: ../sys-utils/ipcmk.1.adoc:21 ../sys-utils/ipcrm.1.adoc:24
453 #: ../sys-utils/ipcs.1.adoc:21 ../sys-utils/irqtop.1.adoc:17
454 #: ../sys-utils/ldattach.8.adoc:21 ../sys-utils/losetup.8.adoc:39
455 #: ../sys-utils/lscpu.1.adoc:17 ../sys-utils/lsipc.1.adoc:17
456 #: ../sys-utils/lsirq.1.adoc:17 ../sys-utils/lsmem.1.adoc:17
457 #: ../sys-utils/lsns.8.adoc:22 ../sys-utils/mount.8.adoc:60
458 #: ../sys-utils/mountpoint.1.adoc:19 ../sys-utils/nsenter.1.adoc:17
459 #: ../sys-utils/pivot_root.8.adoc:17 ../sys-utils/prlimit.1.adoc:25
460 #: ../sys-utils/readprofile.8.adoc:21 ../sys-utils/renice.1.adoc:51
461 #: ../sys-utils/rfkill.8.adoc:17 ../sys-utils/rtcwake.8.adoc:17
462 #: ../sys-utils/setarch.8.adoc:21 ../sys-utils/setpriv.1.adoc:17
463 #: ../sys-utils/setsid.1.adoc:19 ../sys-utils/swapon.8.adoc:19
464 #: ../sys-utils/switch_root.8.adoc:19 ../sys-utils/tunelp.8.adoc:17
465 #: ../sys-utils/umount.8.adoc:46 ../sys-utils/unshare.1.adoc:17
466 #: ../sys-utils/wdctl.8.adoc:17 ../sys-utils/zramctl.8.adoc:31
467 #: ../term-utils/agetty.8.adoc:17 ../term-utils/mesg.1.adoc:51
468 #: ../term-utils/script.1.adoc:52 ../term-utils/scriptlive.1.adoc:18
469 #: ../term-utils/scriptreplay.1.adoc:18 ../term-utils/setterm.1.adoc:24
470 #: ../term-utils/wall.1.adoc:52 ../term-utils/write.1.adoc:54
471 #: ../text-utils/col.1.adoc:54 ../text-utils/colcrt.1.adoc:52
472 #: ../text-utils/colrm.1.adoc:51 ../text-utils/column.1.adoc:51
473 #: ../text-utils/hexdump.1.adoc:55 ../text-utils/line.1.adoc:18
474 #: ../text-utils/more.1.adoc:54 ../text-utils/pg.1.adoc:18
475 #: ../text-utils/rev.1.adoc:51 ../text-utils/ul.1.adoc:51
481 #: ../disk-utils/addpart.8.adoc:26
483 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"
487 #: ../disk-utils/addpart.8.adoc:28 ../disk-utils/delpart.8.adoc:28
488 #: ../disk-utils/resizepart.8.adoc:28
489 msgid "This command doesn't manipulate partitions on a block device."
493 #: ../disk-utils/addpart.8.adoc:29 ../disk-utils/resizepart.8.adoc:29
494 #: ../misc-utils/cal.1.adoc:125
499 #. type: Labeled list
500 #: ../disk-utils/addpart.8.adoc:31 ../disk-utils/resizepart.8.adoc:31
506 #: ../disk-utils/addpart.8.adoc:33 ../disk-utils/resizepart.8.adoc:33
507 msgid "The disk device."
510 #. type: Labeled list
511 #: ../disk-utils/addpart.8.adoc:34 ../disk-utils/resizepart.8.adoc:34
517 #: ../disk-utils/addpart.8.adoc:36 ../disk-utils/resizepart.8.adoc:36
518 msgid "The partition number."
521 #. type: Labeled list
522 #: ../disk-utils/addpart.8.adoc:37
528 #: ../disk-utils/addpart.8.adoc:39
529 msgid "The beginning of the partition (in 512-byte sectors)."
532 #. type: Labeled list
533 #: ../disk-utils/addpart.8.adoc:40 ../disk-utils/resizepart.8.adoc:37
539 #: ../disk-utils/addpart.8.adoc:42
540 msgid "The length of the partition (in 512-byte sectors)."
544 #: ../disk-utils/addpart.8.adoc:45 ../disk-utils/cfdisk.8.adoc:145
545 #: ../disk-utils/delpart.8.adoc:33 ../disk-utils/fdformat.8.adoc:74
546 #: ../disk-utils/fdisk.8.adoc:220 ../disk-utils/fsck.8.adoc:159
547 #: ../disk-utils/fsck.cramfs.8.adoc:51 ../disk-utils/fsck.minix.8.adoc:98
548 #: ../disk-utils/mkfs.8.adoc:53 ../disk-utils/mkfs.bfs.8.adoc:57
549 #: ../disk-utils/mkfs.cramfs.8.adoc:82 ../disk-utils/mkfs.minix.8.adoc:86
550 #: ../disk-utils/mkswap.8.adoc:125 ../disk-utils/partx.8.adoc:135
551 #: ../disk-utils/resizepart.8.adoc:42 ../disk-utils/sfdisk.8.adoc:455
552 #: ../disk-utils/swaplabel.8.adoc:48 ../libblkid/libblkid.3.adoc:133
553 #: ../libuuid/man/uuid.3.adoc:63 ../libuuid/man/uuid_clear.3.adoc:59
554 #: ../libuuid/man/uuid_compare.3.adoc:63 ../libuuid/man/uuid_copy.3.adoc:63
555 #: ../libuuid/man/uuid_generate.3.adoc:84 ../libuuid/man/uuid_is_null.3.adoc:59
556 #: ../libuuid/man/uuid_parse.3.adoc:70 ../libuuid/man/uuid_time.3.adoc:63
557 #: ../libuuid/man/uuid_unparse.3.adoc:67 ../login-utils/chfn.1.adoc:80
558 #: ../login-utils/chsh.1.adoc:63 ../login-utils/last.1.adoc:129
559 #: ../login-utils/login.1.adoc:169 ../login-utils/lslogins.1.adoc:144
560 #: ../login-utils/newgrp.1.adoc:38 ../login-utils/nologin.8.adoc:67
561 #: ../login-utils/runuser.1.adoc:133 ../login-utils/su.1.adoc:149
562 #: ../login-utils/utmpdump.1.adoc:75 ../login-utils/vipw.8.adoc:72
563 #: ../misc-utils/blkid.8.adoc:179 ../misc-utils/cal.1.adoc:183
564 #: ../misc-utils/enosys.1.adoc:56 ../misc-utils/exch.1.adoc:41
565 #: ../misc-utils/fadvise.1.adoc:57 ../misc-utils/fincore.1.adoc:56
566 #: ../misc-utils/findfs.8.adoc:67 ../misc-utils/findmnt.8.adoc:245
567 #: ../misc-utils/getopt.1.adoc:151 ../misc-utils/kill.1.adoc:109
568 #: ../misc-utils/logger.1.adoc:246 ../misc-utils/look.1.adoc:101
569 #: ../misc-utils/lsblk.8.adoc:225 ../misc-utils/lsclocks.1.adoc:104
570 #: ../misc-utils/lsfd.1.adoc:706 ../misc-utils/lslocks.8.adoc:127
571 #: ../misc-utils/mcookie.1.adoc:54 ../misc-utils/namei.1.adoc:75
572 #: ../misc-utils/pipesz.1.adoc:99 ../misc-utils/rename.1.adoc:106
573 #: ../misc-utils/uuidd.8.adoc:88 ../misc-utils/uuidgen.1.adoc:69
574 #: ../misc-utils/uuidparse.1.adoc:68 ../misc-utils/waitpid.1.adoc:57
575 #: ../misc-utils/wipefs.8.adoc:103 ../schedutils/chrt.1.adoc:148
576 #: ../schedutils/ionice.1.adoc:91 ../schedutils/taskset.1.adoc:145
577 #: ../schedutils/uclampset.1.adoc:130 ../sys-utils/adjtime_config.5.adoc:54
578 #: ../sys-utils/blkdiscard.8.adoc:75 ../sys-utils/blkzone.8.adoc:108
579 #: ../sys-utils/blkpr.8.adoc:52 ../sys-utils/chcpu.8.adoc:76
580 #: ../sys-utils/chmem.8.adoc:81 ../sys-utils/choom.1.adoc:51
581 #: ../sys-utils/ctrlaltdel.8.adoc:47 ../sys-utils/dmesg.1.adoc:198
582 #: ../sys-utils/eject.1.adoc:117 ../sys-utils/fallocate.1.adoc:86
583 #: ../sys-utils/flock.1.adoc:131 ../sys-utils/fsfreeze.8.adoc:53
584 #: ../sys-utils/fstab.5.adoc:139 ../sys-utils/fstrim.8.adoc:91
585 #: ../sys-utils/hwclock.8.adoc:378 ../sys-utils/ipcmk.1.adoc:49
586 #: ../sys-utils/ipcrm.1.adoc:68 ../sys-utils/ipcs.1.adoc:88
587 #: ../sys-utils/ldattach.8.adoc:118 ../sys-utils/lscpu.1.adoc:109
588 #: ../sys-utils/lsipc.1.adoc:106 ../sys-utils/lsmem.1.adoc:72
589 #: ../sys-utils/lsns.8.adoc:90 ../sys-utils/mount.8.adoc:1688
590 #: ../sys-utils/mountpoint.1.adoc:65 ../sys-utils/nsenter.1.adoc:158
591 #: ../sys-utils/pivot_root.8.adoc:63 ../sys-utils/prlimit.1.adoc:135
592 #: ../sys-utils/renice.1.adoc:102 ../sys-utils/rfkill.8.adoc:78
593 #: ../sys-utils/rtcwake.8.adoc:130 ../sys-utils/setarch.8.adoc:95
594 #: ../sys-utils/setpriv.1.adoc:140 ../sys-utils/setsid.1.adoc:44
595 #: ../sys-utils/swapon.8.adoc:167 ../sys-utils/switch_root.8.adoc:47
596 #: ../sys-utils/umount.8.adoc:173 ../sys-utils/unshare.1.adoc:261
597 #: ../sys-utils/zramctl.8.adoc:102 ../term-utils/mesg.1.adoc:96
598 #: ../term-utils/script.1.adoc:161 ../term-utils/scriptlive.1.adoc:75
599 #: ../term-utils/scriptreplay.1.adoc:95 ../term-utils/setterm.1.adoc:167
600 #: ../term-utils/wall.1.adoc:81 ../term-utils/write.1.adoc:82
601 #: ../text-utils/col.1.adoc:127 ../text-utils/colcrt.1.adoc:92
602 #: ../text-utils/colrm.1.adoc:67 ../text-utils/column.1.adoc:234
603 #: ../text-utils/line.1.adoc:22 ../text-utils/more.1.adoc:198
604 #: ../text-utils/pg.1.adoc:142 ../text-utils/rev.1.adoc:64
605 #: ../text-utils/ul.1.adoc:80
608 msgstr "DALŠÍ INFORMACE"
611 #: ../disk-utils/addpart.8.adoc:52
614 #| "*getmntent*(3),\n"
633 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
634 #. Copyright 2007 Karel Zak <kzak@redhat.com>
635 #. May be distributed under the GNU General Public License
637 #: ../disk-utils/blockdev.8.adoc:8
643 #: ../disk-utils/blockdev.8.adoc:18
644 msgid "blockdev - call block device ioctls from the command line"
648 #: ../disk-utils/blockdev.8.adoc:22
650 msgid "*blockdev* [*-q*] [*-v*] _command_ [_command_...] _device_ [_device_...]\n"
654 #: ../disk-utils/blockdev.8.adoc:24
656 msgid "*blockdev* *--report* [_device_...]\n"
660 #: ../disk-utils/blockdev.8.adoc:26
662 msgid "*blockdev* *-h*|*-V*\n"
666 #: ../disk-utils/blockdev.8.adoc:30
668 "The utility *blockdev* allows one to call block device ioctls from the "
673 #: ../disk-utils/blockdev.8.adoc:31 ../disk-utils/cfdisk.8.adoc:45
674 #: ../disk-utils/delpart.8.adoc:29 ../disk-utils/fdformat.8.adoc:50
675 #: ../disk-utils/fdisk.8.adoc:40 ../disk-utils/fsck.8.adoc:52
676 #: ../disk-utils/fsck.cramfs.8.adoc:21 ../disk-utils/fsck.minix.8.adoc:45
677 #: ../disk-utils/isosize.8.adoc:21 ../disk-utils/mkfs.8.adoc:27
678 #: ../disk-utils/mkfs.bfs.8.adoc:27 ../disk-utils/mkfs.cramfs.8.adoc:33
679 #: ../disk-utils/mkfs.minix.8.adoc:41 ../disk-utils/mkswap.8.adoc:41
680 #: ../disk-utils/partx.8.adoc:40 ../disk-utils/raw.8.adoc:37
681 #: ../disk-utils/sfdisk.8.adoc:139 ../disk-utils/swaplabel.8.adoc:29
682 #: ../login-utils/chfn.1.adoc:35 ../login-utils/chsh.1.adoc:31
683 #: ../login-utils/last.1.adoc:46 ../login-utils/login.1.adoc:39
684 #: ../login-utils/lslogins.1.adoc:27 ../login-utils/newgrp.1.adoc:25
685 #: ../login-utils/nologin.8.adoc:25 ../login-utils/runuser.1.adoc:33
686 #: ../login-utils/su.1.adoc:34 ../login-utils/sulogin.8.adoc:50
687 #: ../login-utils/utmpdump.1.adoc:38 ../login-utils/vipw.8.adoc:57
688 #: ../misc-utils/blkid.8.adoc:42 ../misc-utils/cal.1.adoc:67
689 #: ../misc-utils/enosys.1.adoc:25 ../misc-utils/exch.1.adoc:24
690 #: ../misc-utils/fadvise.1.adoc:24 ../misc-utils/fincore.1.adoc:29
691 #: ../misc-utils/findmnt.8.adoc:34 ../misc-utils/getopt.1.adoc:32
692 #: ../misc-utils/hardlink.1.adoc:41 ../misc-utils/kill.1.adoc:53
693 #: ../misc-utils/logger.1.adoc:57 ../misc-utils/look.1.adoc:57
694 #: ../misc-utils/lsblk.8.adoc:33 ../misc-utils/lsclocks.1.adoc:24
695 #: ../misc-utils/lsfd.1.adoc:39 ../misc-utils/lslocks.8.adoc:32
696 #: ../misc-utils/mcookie.1.adoc:29 ../misc-utils/namei.1.adoc:39
697 #: ../misc-utils/pipesz.1.adoc:35 ../misc-utils/rename.1.adoc:23
698 #: ../misc-utils/uuidd.8.adoc:25 ../misc-utils/uuidgen.1.adoc:29
699 #: ../misc-utils/uuidparse.1.adoc:48 ../misc-utils/waitpid.1.adoc:24
700 #: ../misc-utils/whereis.1.adoc:71 ../misc-utils/wipefs.8.adoc:38
701 #: ../schedutils/chrt.1.adoc:90 ../schedutils/ionice.1.adoc:46
702 #: ../schedutils/taskset.1.adoc:69 ../schedutils/uclampset.1.adoc:67
703 #: ../sys-utils/blkdiscard.8.adoc:27 ../sys-utils/blkzone.8.adoc:82
704 #: ../sys-utils/blkpr.8.adoc:23 ../sys-utils/chcpu.8.adoc:27
705 #: ../sys-utils/chmem.8.adoc:35 ../sys-utils/choom.1.adoc:23
706 #: ../sys-utils/ctrlaltdel.8.adoc:35 ../sys-utils/dmesg.1.adoc:37
707 #: ../sys-utils/eject.1.adoc:35 ../sys-utils/fallocate.1.adoc:27
708 #: ../sys-utils/flock.1.adoc:54 ../sys-utils/fsfreeze.8.adoc:29
709 #: ../sys-utils/fstrim.8.adoc:27 ../sys-utils/hwclock.8.adoc:111
710 #: ../sys-utils/ipcmk.1.adoc:25 ../sys-utils/ipcrm.1.adoc:36
711 #: ../sys-utils/ipcs.1.adoc:25 ../sys-utils/irqtop.1.adoc:23
712 #: ../sys-utils/ldattach.8.adoc:74 ../sys-utils/losetup.8.adoc:49
713 #: ../sys-utils/lscpu.1.adoc:31 ../sys-utils/lsipc.1.adoc:21
714 #: ../sys-utils/lsirq.1.adoc:23 ../sys-utils/lsmem.1.adoc:31
715 #: ../sys-utils/lsns.8.adoc:32 ../sys-utils/mountpoint.1.adoc:23
716 #: ../sys-utils/nsenter.1.adoc:47 ../sys-utils/pivot_root.8.adoc:33
717 #: ../sys-utils/readprofile.8.adoc:25 ../sys-utils/renice.1.adoc:57
718 #: ../sys-utils/rfkill.8.adoc:25 ../sys-utils/rtcwake.8.adoc:31
719 #: ../sys-utils/setarch.8.adoc:29 ../sys-utils/setpriv.1.adoc:23
720 #: ../sys-utils/setsid.1.adoc:23 ../sys-utils/swapon.8.adoc:29
721 #: ../sys-utils/switch_root.8.adoc:25 ../sys-utils/tunelp.8.adoc:21
722 #: ../sys-utils/umount.8.adoc:52 ../sys-utils/unshare.1.adoc:53
723 #: ../sys-utils/wdctl.8.adoc:25 ../sys-utils/zramctl.8.adoc:39
724 #: ../term-utils/agetty.8.adoc:56 ../term-utils/mesg.1.adoc:69
725 #: ../term-utils/script.1.adoc:62 ../term-utils/scriptlive.1.adoc:28
726 #: ../term-utils/scriptreplay.1.adoc:30 ../term-utils/setterm.1.adoc:28
727 #: ../term-utils/wall.1.adoc:60 ../term-utils/write.1.adoc:74
728 #: ../text-utils/col.1.adoc:60 ../text-utils/colcrt.1.adoc:56
729 #: ../text-utils/colrm.1.adoc:59 ../text-utils/column.1.adoc:66
730 #: ../text-utils/hexdump.1.adoc:59 ../text-utils/more.1.adoc:58
731 #: ../text-utils/pg.1.adoc:26 ../text-utils/rev.1.adoc:57
732 #: ../text-utils/ul.1.adoc:55
737 #. type: Labeled list
738 #: ../disk-utils/blockdev.8.adoc:33
744 #: ../disk-utils/blockdev.8.adoc:35
748 #. type: Labeled list
749 #: ../disk-utils/blockdev.8.adoc:36 ../disk-utils/mkfs.cramfs.8.adoc:35
755 #: ../disk-utils/blockdev.8.adoc:38 ../disk-utils/fsck.minix.8.adoc:58
756 #: ../sys-utils/rtcwake.8.adoc:107 ../sys-utils/setarch.8.adoc:44
757 #: ../sys-utils/swapon.8.adoc:91
761 #. type: Labeled list
762 #: ../disk-utils/blockdev.8.adoc:39
768 #: ../disk-utils/blockdev.8.adoc:41
770 "Print a report for the specified device. It is possible to give multiple "
771 "devices. If none is given, all devices which appear in _/proc/partitions_ "
772 "are shown. Note that the partition StartSec is in 512-byte sectors."
776 #: ../disk-utils/blockdev.8.adoc:44 ../disk-utils/cfdisk.8.adoc:61
777 #: ../disk-utils/sfdisk.8.adoc:52 ../sys-utils/blkzone.8.adoc:23
778 #: ../sys-utils/rfkill.8.adoc:44 ../text-utils/more.1.adoc:100
779 #: ../text-utils/pg.1.adoc:64
785 #: ../disk-utils/blockdev.8.adoc:47
786 msgid "It is possible to give multiple devices and multiple commands."
789 #. type: Labeled list
790 #: ../disk-utils/blockdev.8.adoc:48
792 msgid "*--flushbufs*"
796 #: ../disk-utils/blockdev.8.adoc:50
797 msgid "Flush buffers."
800 #. type: Labeled list
801 #: ../disk-utils/blockdev.8.adoc:51
803 msgid "*--getalignoff*"
807 #: ../disk-utils/blockdev.8.adoc:53
808 msgid "Get alignment offset."
811 #. type: Labeled list
812 #: ../disk-utils/blockdev.8.adoc:54
818 #: ../disk-utils/blockdev.8.adoc:56
820 "Print the blocksize in bytes. This size does not describe device topology. "
821 "It's the size used internally by the kernel and it may be modified (for "
822 "example) by filesystem driver on mount."
825 #. type: Labeled list
826 #: ../disk-utils/blockdev.8.adoc:57
828 msgid "*--getdiscardzeroes*"
832 #: ../disk-utils/blockdev.8.adoc:59
833 msgid "Get discard zeroes support status."
836 #. type: Labeled list
837 #: ../disk-utils/blockdev.8.adoc:60
839 msgid "*--getdiskseq*"
843 #: ../disk-utils/blockdev.8.adoc:62
844 msgid "Get disk sequence number."
847 #. type: Labeled list
848 #: ../disk-utils/blockdev.8.adoc:63
850 #| msgid "*-P*, *--pty*"
851 msgid "*--getzonesz*"
852 msgstr "*-P*, *--pty*"
855 #: ../disk-utils/blockdev.8.adoc:65
856 msgid "Get zone size in 512-byte sectors."
859 #. type: Labeled list
860 #: ../disk-utils/blockdev.8.adoc:66
866 #: ../disk-utils/blockdev.8.adoc:68
867 msgid "Get filesystem readahead in 512-byte sectors."
870 #. type: Labeled list
871 #: ../disk-utils/blockdev.8.adoc:69
877 #: ../disk-utils/blockdev.8.adoc:71
878 msgid "Get minimum I/O size."
881 #. type: Labeled list
882 #: ../disk-utils/blockdev.8.adoc:72
888 #: ../disk-utils/blockdev.8.adoc:74
889 msgid "Get optimal I/O size."
892 #. type: Labeled list
893 #: ../disk-utils/blockdev.8.adoc:75
895 msgid "*--getmaxsect*"
899 #: ../disk-utils/blockdev.8.adoc:77
900 msgid "Get max sectors per request."
903 #. type: Labeled list
904 #: ../disk-utils/blockdev.8.adoc:78
910 #: ../disk-utils/blockdev.8.adoc:80
911 msgid "Get physical block (sector) size."
914 #. type: Labeled list
915 #: ../disk-utils/blockdev.8.adoc:81
921 #: ../disk-utils/blockdev.8.adoc:83
922 msgid "Print readahead (in 512-byte sectors)."
925 #. type: Labeled list
926 #: ../disk-utils/blockdev.8.adoc:84
932 #: ../disk-utils/blockdev.8.adoc:86
933 msgid "Get read-only. Print 1 if the device is read-only, 0 otherwise."
936 #. type: Labeled list
937 #: ../disk-utils/blockdev.8.adoc:87
939 msgid "*--getsize64*"
943 #: ../disk-utils/blockdev.8.adoc:89
945 #| msgid "Print version and exit."
946 msgid "Print device size in bytes."
947 msgstr "Zobrazí verzi a skončí."
949 #. type: Labeled list
950 #: ../disk-utils/blockdev.8.adoc:90
956 #: ../disk-utils/blockdev.8.adoc:92
958 "Print device size (32-bit!) in sectors. Deprecated in favor of the *--getsz* "
962 #. type: Labeled list
963 #: ../disk-utils/blockdev.8.adoc:93
969 #: ../disk-utils/blockdev.8.adoc:95
970 msgid "Print logical sector size in bytes - usually 512."
973 #. type: Labeled list
974 #: ../disk-utils/blockdev.8.adoc:96
980 #: ../disk-utils/blockdev.8.adoc:98
981 msgid "Get size in 512-byte sectors."
984 #. type: Labeled list
985 #: ../disk-utils/blockdev.8.adoc:99
991 #: ../disk-utils/blockdev.8.adoc:101
992 msgid "Reread partition table"
995 #. type: Labeled list
996 #: ../disk-utils/blockdev.8.adoc:102
998 msgid "*--setbsz* _bytes_"
1002 #: ../disk-utils/blockdev.8.adoc:104
1004 "Set blocksize. Note that the block size is specific to the current file "
1005 "descriptor opening the block device, so the change of block size only "
1006 "persists for as long as *blockdev* has the device open, and is lost once "
1010 #. type: Labeled list
1011 #: ../disk-utils/blockdev.8.adoc:105
1013 msgid "*--setfra* _sectors_"
1017 #: ../disk-utils/blockdev.8.adoc:107
1018 msgid "Set filesystem readahead (same as *--setra* on 2.6 kernels)."
1021 #. type: Labeled list
1022 #: ../disk-utils/blockdev.8.adoc:108
1024 msgid "*--setra* _sectors_"
1028 #: ../disk-utils/blockdev.8.adoc:110
1029 msgid "Set readahead (in 512-byte sectors)."
1032 #. type: Labeled list
1033 #: ../disk-utils/blockdev.8.adoc:111
1039 #: ../disk-utils/blockdev.8.adoc:113
1041 "Set read-only. The currently active access to the device may not be affected "
1042 "by the change. For example, a filesystem already mounted in read-write mode "
1043 "will not be affected. The change applies after remount."
1046 #. type: Labeled list
1047 #: ../disk-utils/blockdev.8.adoc:114
1053 #: ../disk-utils/blockdev.8.adoc:116
1054 msgid "Set read-write."
1058 #: ../disk-utils/blockdev.8.adoc:117 ../disk-utils/cfdisk.8.adoc:139
1059 #: ../disk-utils/fdformat.8.adoc:70 ../disk-utils/fdisk.8.adoc:213
1060 #: ../disk-utils/fsck.8.adoc:154 ../disk-utils/fsck.minix.8.adoc:94
1061 #: ../disk-utils/mkfs.8.adoc:45 ../disk-utils/partx.8.adoc:128
1062 #: ../disk-utils/raw.8.adoc:57 ../disk-utils/sfdisk.8.adoc:449
1063 #: ../disk-utils/swaplabel.8.adoc:44 ../libblkid/libblkid.3.adoc:123
1064 #: ../libuuid/man/uuid.3.adoc:59 ../libuuid/man/uuid_clear.3.adoc:55
1065 #: ../libuuid/man/uuid_compare.3.adoc:59 ../libuuid/man/uuid_copy.3.adoc:59
1066 #: ../libuuid/man/uuid_generate.3.adoc:80 ../libuuid/man/uuid_is_null.3.adoc:55
1067 #: ../libuuid/man/uuid_parse.3.adoc:66 ../libuuid/man/uuid_time.3.adoc:59
1068 #: ../libuuid/man/uuid_unparse.3.adoc:63 ../login-utils/chfn.1.adoc:76
1069 #: ../login-utils/chsh.1.adoc:59 ../login-utils/last.1.adoc:125
1070 #: ../login-utils/login.1.adoc:165 ../login-utils/lslogins.1.adoc:139
1071 #: ../login-utils/newgrp.1.adoc:34 ../login-utils/nologin.8.adoc:63
1072 #: ../login-utils/sulogin.8.adoc:70 ../login-utils/utmpdump.1.adoc:71
1073 #: ../misc-utils/blkid.8.adoc:175 ../misc-utils/enosys.1.adoc:52
1074 #: ../misc-utils/exch.1.adoc:37 ../misc-utils/fadvise.1.adoc:53
1075 #: ../misc-utils/fincore.1.adoc:52 ../misc-utils/findfs.8.adoc:63
1076 #: ../misc-utils/findmnt.8.adoc:241 ../misc-utils/kill.1.adoc:102
1077 #: ../misc-utils/logger.1.adoc:242 ../misc-utils/lsblk.8.adoc:220
1078 #: ../misc-utils/lsclocks.1.adoc:100 ../misc-utils/lsfd.1.adoc:701
1079 #: ../misc-utils/lslocks.8.adoc:123 ../misc-utils/namei.1.adoc:69
1080 #: ../misc-utils/pipesz.1.adoc:95 ../misc-utils/uuidgen.1.adoc:65
1081 #: ../misc-utils/uuidparse.1.adoc:64 ../misc-utils/waitpid.1.adoc:53
1082 #: ../misc-utils/wipefs.8.adoc:99 ../schedutils/chrt.1.adoc:143
1083 #: ../schedutils/ionice.1.adoc:86 ../schedutils/taskset.1.adoc:136
1084 #: ../schedutils/uclampset.1.adoc:126 ../sys-utils/blkdiscard.8.adoc:70
1085 #: ../sys-utils/blkzone.8.adoc:103 ../sys-utils/blkpr.8.adoc:48
1086 #: ../sys-utils/chcpu.8.adoc:68 ../sys-utils/choom.1.adoc:47
1087 #: ../sys-utils/ctrlaltdel.8.adoc:43 ../sys-utils/dmesg.1.adoc:192
1088 #: ../sys-utils/eject.1.adoc:113 ../sys-utils/fallocate.1.adoc:81
1089 #: ../sys-utils/flock.1.adoc:122 ../sys-utils/fsfreeze.8.adoc:49
1090 #: ../sys-utils/fstrim.8.adoc:87 ../sys-utils/hwclock.8.adoc:388
1091 #: ../sys-utils/ipcmk.1.adoc:45 ../sys-utils/ipcs.1.adoc:84
1092 #: ../sys-utils/irqtop.1.adoc:62 ../sys-utils/ldattach.8.adoc:114
1093 #: ../sys-utils/losetup.8.adoc:157 ../sys-utils/lscpu.1.adoc:103
1094 #: ../sys-utils/lsipc.1.adoc:101 ../sys-utils/lsirq.1.adoc:45
1095 #: ../sys-utils/lsmem.1.adoc:68 ../sys-utils/lsns.8.adoc:86
1096 #: ../sys-utils/mount.8.adoc:1684 ../sys-utils/mountpoint.1.adoc:61
1097 #: ../sys-utils/nsenter.1.adoc:153 ../sys-utils/prlimit.1.adoc:131
1098 #: ../sys-utils/rfkill.8.adoc:72 ../sys-utils/rtcwake.8.adoc:122
1099 #: ../sys-utils/setarch.8.adoc:89 ../sys-utils/setpriv.1.adoc:136
1100 #: ../sys-utils/setsid.1.adoc:40 ../sys-utils/switch_root.8.adoc:41
1101 #: ../sys-utils/unshare.1.adoc:256 ../sys-utils/wdctl.8.adoc:68
1102 #: ../sys-utils/zramctl.8.adoc:97 ../term-utils/agetty.8.adoc:342
1103 #: ../term-utils/scriptlive.1.adoc:62 ../term-utils/scriptreplay.1.adoc:79
1104 #: ../text-utils/more.1.adoc:190
1110 #: ../disk-utils/blockdev.8.adoc:120
1112 msgid "*blockdev* was written by Andries E. Brouwer and rewritten by Karel Zak.\n"
1117 #. cfdisk.8 -- man page for cfdisk
1118 #. Copyright 1994 Kevin E. Martin (martin@cs.unc.edu)
1119 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
1120 #. Permission is granted to make and distribute verbatim copies of this
1121 #. manual provided the copyright notice and this permission notice are
1122 #. preserved on all copies.
1123 #. Permission is granted to copy and distribute modified versions of this
1124 #. manual under the conditions for verbatim copying, provided that the
1125 #. entire resulting derived work is distributed under the terms of a
1126 #. permission notice identical to this one.
1128 #: ../disk-utils/cfdisk.8.adoc:16
1134 #: ../disk-utils/cfdisk.8.adoc:26
1135 msgid "cfdisk - display or manipulate a disk partition table"
1139 #: ../disk-utils/cfdisk.8.adoc:30
1141 msgid "*cfdisk* [options] [_device_]\n"
1145 #: ../disk-utils/cfdisk.8.adoc:34
1147 msgid "*cfdisk* is a curses-based program for partitioning any block device. The default device is _/dev/sda_.\n"
1151 #: ../disk-utils/cfdisk.8.adoc:36
1153 "Note that *cfdisk* provides basic partitioning functionality with a user-"
1154 "friendly interface. If you need advanced features, use *fdisk*(8) instead."
1158 #: ../disk-utils/cfdisk.8.adoc:38
1160 "All disk label changes will remain in memory only, and the disk will be "
1161 "unmodified until you decide to write your changes. Be careful before using "
1162 "the write command."
1166 #: ../disk-utils/cfdisk.8.adoc:40
1168 "Since version 2.25 *cfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
1169 "labels, but no longer provides any functionality for CHS (Cylinder-Head-"
1170 "Sector) addressing. CHS has never been important for Linux, and this "
1171 "addressing concept does not make any sense for new devices."
1175 #: ../disk-utils/cfdisk.8.adoc:42
1177 "Since version 2.25 *cfdisk* also does not provide a 'print' command any "
1178 "more. This functionality is provided by the utilities *partx*(8) and "
1179 "*lsblk*(8) in a very comfortable and rich way."
1183 #: ../disk-utils/cfdisk.8.adoc:44
1185 "If you want to remove an old partition table from a device, use *wipefs*(8)."
1188 #. type: Labeled list
1189 #: ../disk-utils/cfdisk.8.adoc:49
1191 #| msgid "*-s*, **--shell**=__shell__"
1192 msgid "*-L*, *--color*[**=**__when__]"
1193 msgstr "*-s*, **--shell**=__shell__"
1196 #: ../disk-utils/cfdisk.8.adoc:51
1198 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
1199 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
1200 "colors can be disabled, for the current built-in default see *--help* "
1201 "output. See also the *COLORS* section."
1204 #. type: Labeled list
1205 #: ../disk-utils/cfdisk.8.adoc:52 ../disk-utils/fdisk.8.adoc:64
1206 #: ../disk-utils/mkfs.bfs.8.adoc:38 ../disk-utils/mkfs.minix.8.adoc:49
1207 #: ../disk-utils/mkswap.8.adoc:60 ../disk-utils/sfdisk.8.adoc:158
1208 #: ../misc-utils/wipefs.8.adoc:52
1210 msgid "*--lock*[=_mode_]"
1214 #: ../disk-utils/cfdisk.8.adoc:54 ../disk-utils/fdisk.8.adoc:66
1215 #: ../disk-utils/mkfs.bfs.8.adoc:40 ../disk-utils/mkfs.minix.8.adoc:51
1216 #: ../disk-utils/mkswap.8.adoc:62 ../disk-utils/sfdisk.8.adoc:160
1218 "Use exclusive BSD lock for device or file it operates. The optional argument "
1219 "_mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument "
1220 "is omitted, it defaults to *yes*. This option overwrites environment "
1221 "variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, "
1222 "but it's recommended to avoid collisions with *systemd-udevd*(8) or other "
1226 #. type: Labeled list
1227 #: ../disk-utils/cfdisk.8.adoc:55 ../sys-utils/losetup.8.adoc:92
1228 #: ../sys-utils/mount.8.adoc:408 ../sys-utils/umount.8.adoc:105
1230 #| msgid "*-h*, *--help*"
1231 msgid "*-r*, *--read-only*"
1232 msgstr "*-h*, *--help*"
1235 #: ../disk-utils/cfdisk.8.adoc:57
1236 msgid "Forced open in read-only mode."
1239 #. type: Labeled list
1240 #: ../disk-utils/cfdisk.8.adoc:58
1242 #| msgid "*-V*, *--version*"
1243 msgid "*-z*, *--zero*"
1244 msgstr "*-V*, *--version*"
1247 #: ../disk-utils/cfdisk.8.adoc:60
1249 "Start with an in-memory zeroed partition table. This option does not zero "
1250 "the partition table on the disk; rather, it simply starts the program "
1251 "without reading the existing partition table. This option allows you to "
1252 "create a new partition table from scratch or from an *sfdisk*(8)-compatible "
1257 #: ../disk-utils/cfdisk.8.adoc:64
1259 "The commands for *cfdisk* can be entered by pressing the corresponding key "
1260 "(pressing _Enter_ after the command is not necessary). Here is a list of the "
1261 "available commands:"
1264 #. type: Labeled list
1265 #: ../disk-utils/cfdisk.8.adoc:65
1271 #: ../disk-utils/cfdisk.8.adoc:67
1273 "Toggle the bootable flag of the current partition. This allows you to select "
1274 "which primary partition is bootable on the drive. This command may not be "
1275 "available for all partition label types."
1278 #. type: Labeled list
1279 #: ../disk-utils/cfdisk.8.adoc:68 ../sys-utils/irqtop.1.adoc:53
1285 #: ../disk-utils/cfdisk.8.adoc:70
1287 "Delete the current partition. This will convert the current partition into "
1288 "free space and merge it with any free space immediately surrounding the "
1289 "current partition. A partition already marked as free space or marked as "
1290 "unusable cannot be deleted."
1293 #. type: Labeled list
1294 #: ../disk-utils/cfdisk.8.adoc:71 ../text-utils/pg.1.adoc:106
1300 #: ../disk-utils/cfdisk.8.adoc:73
1301 msgid "Show the help screen."
1304 #. type: Labeled list
1305 #: ../disk-utils/cfdisk.8.adoc:74 ../sys-utils/irqtop.1.adoc:56
1306 #: ../term-utils/mesg.1.adoc:61 ../text-utils/more.1.adoc:140
1313 #: ../disk-utils/cfdisk.8.adoc:76
1315 "Create a new partition from free space. *cfdisk* then prompts you for the "
1316 "size of the partition you want to create. The default size is equal to the "
1317 "entire available free space at the current position."
1321 #: ../disk-utils/cfdisk.8.adoc:78
1323 "The size may be followed by a multiplicative suffix: KiB (=1024), MiB "
1324 "(=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the \"iB\" is "
1325 "optional, e.g., \"K\" has the same meaning as \"KiB\")."
1328 #. type: Labeled list
1329 #: ../disk-utils/cfdisk.8.adoc:79
1335 #: ../disk-utils/cfdisk.8.adoc:81
1337 "Quit the program. This will exit the program without writing any data to the "
1341 #. type: Labeled list
1342 #: ../disk-utils/cfdisk.8.adoc:82
1349 #: ../disk-utils/cfdisk.8.adoc:84
1351 "Reduce or enlarge the current partition. *cfdisk* then prompts you for the "
1352 "new size of the partition. The default size is the current size. A partition "
1353 "marked as free space or marked as unusable cannot be resized."
1357 #: ../disk-utils/cfdisk.8.adoc:86
1359 msgid "*Note that reducing the size of a partition might destroy data on that partition.*\n"
1362 #. type: Labeled list
1363 #: ../disk-utils/cfdisk.8.adoc:87 ../text-utils/more.1.adoc:122
1370 #: ../disk-utils/cfdisk.8.adoc:89
1372 "Sort the partitions in ascending start-sector order. When deleting and "
1373 "adding partitions, it is likely that the numbering of the partitions will no "
1374 "longer match their order on the disk. This command restores that match."
1377 #. type: Labeled list
1378 #: ../disk-utils/cfdisk.8.adoc:90 ../sys-utils/irqtop.1.adoc:50
1384 #: ../disk-utils/cfdisk.8.adoc:92
1386 "Change the partition type. By default, new partitions are created as _Linux_ "
1390 #. type: Labeled list
1391 #: ../disk-utils/cfdisk.8.adoc:93
1398 #: ../disk-utils/cfdisk.8.adoc:95
1400 "Dump the current in-memory partition table to an **sfdisk**(8)-compatible "
1405 #: ../disk-utils/cfdisk.8.adoc:97
1407 "The script files are compatible between *cfdisk*, *fdisk*(8) *sfdisk*(8) and "
1408 "other libfdisk applications. For more details see *sfdisk*(8)."
1412 #: ../disk-utils/cfdisk.8.adoc:99
1414 "It is also possible to load an sfdisk-script into *cfdisk* if there is no "
1415 "partition table on the device or when you start *cfdisk* with the *--zero* "
1416 "command-line option."
1419 #. type: Labeled list
1420 #: ../disk-utils/cfdisk.8.adoc:100
1426 #: ../disk-utils/cfdisk.8.adoc:102
1428 "Write the partition table to disk (you must enter an uppercase W). Since "
1429 "this might destroy data on the disk, you must either confirm or deny the "
1430 "write by entering `yes' or `no'. If you enter `yes', *cfdisk* will write the "
1431 "partition table to disk and then tell the kernel to re-read the partition "
1432 "table from the disk."
1436 #: ../disk-utils/cfdisk.8.adoc:104
1438 "The re-reading of the partition table does not always work. In such a case "
1439 "you need to inform the kernel about any new partitions by using "
1440 "*partprobe*(8) or *partx*(8), or by rebooting the system."
1443 #. type: Labeled list
1444 #: ../disk-utils/cfdisk.8.adoc:105
1450 #: ../disk-utils/cfdisk.8.adoc:107
1451 msgid "Toggle extra information about a partition."
1454 #. type: Labeled list
1455 #: ../disk-utils/cfdisk.8.adoc:108
1457 msgid "_Up Arrow_, _Down Arrow_"
1461 #: ../disk-utils/cfdisk.8.adoc:110
1463 "Move the cursor to the previous or next partition. If there are more "
1464 "partitions than can be displayed on a screen, you can display the next "
1465 "(previous) set of partitions by moving down (up) at the last (first) "
1466 "partition displayed on the screen."
1469 #. type: Labeled list
1470 #: ../disk-utils/cfdisk.8.adoc:111
1472 msgid "_Left Arrow_, _Right Arrow_"
1476 #: ../disk-utils/cfdisk.8.adoc:113
1478 "Select the preceding or the next menu item. Hitting _Enter_ will execute the "
1479 "currently selected item."
1483 #: ../disk-utils/cfdisk.8.adoc:115
1485 "All commands can be entered with either uppercase or lowercase letters "
1486 "(except for **W**rite). When in a submenu or at a prompt, you can hit the "
1487 "_Esc_ key to return to the main menu."
1491 #: ../disk-utils/cfdisk.8.adoc:118
1493 msgid "*cfdisk* does not support color customization with a color-scheme file.\n"
1497 #: ../disk-utils/cfdisk.8.adoc:119 ../disk-utils/fdisk.8.adoc:193
1498 #: ../disk-utils/fsck.8.adoc:128 ../disk-utils/mkfs.minix.8.adoc:70
1499 #: ../disk-utils/mkswap.8.adoc:95 ../disk-utils/partx.8.adoc:101
1500 #: ../disk-utils/sfdisk.8.adoc:407 ../disk-utils/swaplabel.8.adoc:39
1501 #: ../lib/terminal-colors.d.5.adoc:129 ../login-utils/sulogin.8.adoc:66
1502 #: ../login-utils/vipw.8.adoc:61 ../misc-utils/blkid.8.adoc:171
1503 #: ../misc-utils/findfs.8.adoc:58 ../misc-utils/findmnt.8.adoc:198
1504 #: ../misc-utils/getopt.1.adoc:133 ../misc-utils/look.1.adoc:77
1505 #: ../misc-utils/lsblk.8.adoc:197 ../misc-utils/whereis.1.adoc:112
1506 #: ../misc-utils/wipefs.8.adoc:80 ../sys-utils/hwclock.8.adoc:357
1507 #: ../sys-utils/losetup.8.adoc:131 ../sys-utils/mount.8.adoc:1627
1508 #: ../sys-utils/mountpoint.1.adoc:52 ../sys-utils/swapon.8.adoc:123
1509 #: ../sys-utils/umount.8.adoc:150 ../term-utils/script.1.adoc:127
1510 #: ../text-utils/column.1.adoc:177 ../text-utils/more.1.adoc:164
1511 #: ../text-utils/pg.1.adoc:117 ../text-utils/ul.1.adoc:65
1516 #. type: Labeled list
1517 #: ../disk-utils/cfdisk.8.adoc:121
1519 msgid "*CFDISK_DEBUG*=all"
1523 #: ../disk-utils/cfdisk.8.adoc:123
1524 msgid "enables cfdisk debug output."
1527 #. type: Labeled list
1528 #: ../disk-utils/cfdisk.8.adoc:124 ../disk-utils/fdisk.8.adoc:198
1529 #: ../disk-utils/sfdisk.8.adoc:411
1531 msgid "*LIBFDISK_DEBUG*=all"
1535 #: ../disk-utils/cfdisk.8.adoc:126 ../disk-utils/fdisk.8.adoc:200
1536 #: ../disk-utils/sfdisk.8.adoc:413
1537 msgid "enables libfdisk debug output."
1540 #. type: Labeled list
1541 #: ../disk-utils/cfdisk.8.adoc:127 ../disk-utils/fdisk.8.adoc:201
1542 #: ../disk-utils/sfdisk.8.adoc:413 ../misc-utils/lsblk.8.adoc:202
1543 #: ../sys-utils/mount.8.adoc:1638 ../sys-utils/swapon.8.adoc:128
1545 msgid "*LIBBLKID_DEBUG*=all"
1549 #: ../disk-utils/cfdisk.8.adoc:129 ../disk-utils/fdisk.8.adoc:203
1550 #: ../disk-utils/fsck.8.adoc:146 ../disk-utils/mkswap.8.adoc:99
1551 #: ../disk-utils/partx.8.adoc:105 ../disk-utils/sfdisk.8.adoc:415
1552 #: ../disk-utils/swaplabel.8.adoc:43 ../misc-utils/findfs.8.adoc:62
1553 msgid "enables libblkid debug output."
1556 #. type: Labeled list
1557 #: ../disk-utils/cfdisk.8.adoc:130 ../disk-utils/fdisk.8.adoc:204
1558 #: ../disk-utils/sfdisk.8.adoc:415 ../misc-utils/findmnt.8.adoc:209
1559 #: ../misc-utils/lsblk.8.adoc:208
1561 msgid "*LIBSMARTCOLS_DEBUG*=all"
1565 #: ../disk-utils/cfdisk.8.adoc:132 ../disk-utils/fdisk.8.adoc:206
1566 #: ../disk-utils/sfdisk.8.adoc:417
1567 msgid "enables libsmartcols debug output."
1570 #. type: Labeled list
1571 #: ../disk-utils/cfdisk.8.adoc:133 ../disk-utils/fdisk.8.adoc:207
1572 #: ../misc-utils/findmnt.8.adoc:212 ../misc-utils/lsblk.8.adoc:211
1574 msgid "*LIBSMARTCOLS_DEBUG_PADDING*=on"
1578 #: ../disk-utils/cfdisk.8.adoc:135
1579 msgid "use visible padding characters. Requires enabled *LIBSMARTCOLS_DEBUG*."
1582 #. type: Labeled list
1583 #: ../disk-utils/cfdisk.8.adoc:136 ../disk-utils/fdisk.8.adoc:210
1584 #: ../disk-utils/sfdisk.8.adoc:417
1586 msgid "*LOCK_BLOCK_DEVICE*=<mode>"
1590 #: ../disk-utils/cfdisk.8.adoc:138 ../disk-utils/fdisk.8.adoc:212
1591 #: ../disk-utils/mkfs.minix.8.adoc:74 ../disk-utils/mkswap.8.adoc:102
1592 #: ../disk-utils/sfdisk.8.adoc:419 ../misc-utils/wipefs.8.adoc:87
1594 "use exclusive BSD lock. The mode is \"1\" or \"0\". See *--lock* for more "
1599 #: ../disk-utils/cfdisk.8.adoc:142 ../disk-utils/sfdisk.8.adoc:452
1600 #: ../login-utils/nologin.8.adoc:66 ../misc-utils/findmnt.8.adoc:244
1601 #: ../misc-utils/wipefs.8.adoc:102 ../sys-utils/choom.1.adoc:50
1602 #: ../sys-utils/dmesg.1.adoc:195 ../sys-utils/lsns.8.adoc:89
1603 #: ../sys-utils/mount.8.adoc:1687 ../sys-utils/mountpoint.1.adoc:64
1604 #: ../term-utils/scriptlive.1.adoc:65
1605 msgid "mailto:kzak@redhat.com[Karel Zak]"
1609 #: ../disk-utils/cfdisk.8.adoc:144
1611 "The current *cfdisk* implementation is based on the original *cfdisk* from "
1612 "mailto:martin@cs.unc.edu[Kevin E. Martin]."
1616 #: ../disk-utils/cfdisk.8.adoc:152
1626 #. delpart.8 -- man page for delpart
1627 #. Copyright 2007 Karel Zak <kzak@redhat.com>
1628 #. Copyright 2007 Red Hat, Inc.
1629 #. May be distributed under the GNU General Public License
1631 #: ../disk-utils/delpart.8.adoc:8
1637 #: ../disk-utils/delpart.8.adoc:18
1638 msgid "delpart - tell the kernel to forget about a partition"
1642 #: ../disk-utils/delpart.8.adoc:22
1644 msgid "*delpart* _device partition_\n"
1648 #: ../disk-utils/delpart.8.adoc:26
1650 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"
1654 #: ../disk-utils/delpart.8.adoc:40
1664 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1665 #. May be distributed under the GNU General Public License
1667 #: ../disk-utils/fdformat.8.adoc:6
1673 #: ../disk-utils/fdformat.8.adoc:16
1674 msgid "fdformat - low-level format a floppy disk"
1678 #: ../disk-utils/fdformat.8.adoc:20
1680 msgid "*fdformat* [options] _device_\n"
1684 #: ../disk-utils/fdformat.8.adoc:24
1686 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"
1689 #. type: delimited block .
1690 #: ../disk-utils/fdformat.8.adoc:35
1693 "/dev/fd0d360 (minor = 4)\n"
1694 "/dev/fd0h1200 (minor = 8)\n"
1695 "/dev/fd0D360 (minor = 12)\n"
1696 "/dev/fd0H360 (minor = 12)\n"
1697 "/dev/fd0D720 (minor = 16)\n"
1698 "/dev/fd0H720 (minor = 16)\n"
1699 "/dev/fd0h360 (minor = 20)\n"
1700 "/dev/fd0h720 (minor = 24)\n"
1701 "/dev/fd0H1440 (minor = 28)\n"
1704 #. type: delimited block .
1705 #: ../disk-utils/fdformat.8.adoc:46
1708 "/dev/fd1d360 (minor = 5)\n"
1709 "/dev/fd1h1200 (minor = 9)\n"
1710 "/dev/fd1D360 (minor = 13)\n"
1711 "/dev/fd1H360 (minor = 13)\n"
1712 "/dev/fd1D720 (minor = 17)\n"
1713 "/dev/fd1H720 (minor = 17)\n"
1714 "/dev/fd1h360 (minor = 21)\n"
1715 "/dev/fd1h720 (minor = 25)\n"
1716 "/dev/fd1H1440 (minor = 29)\n"
1720 #: ../disk-utils/fdformat.8.adoc:49
1722 "The generic floppy devices, _/dev/fd0_ and _/dev/fd1_, will fail to work "
1723 "with *fdformat* when a non-standard format is being used, or if the format "
1724 "has not been autodetected earlier. In this case, use *setfdprm*(8) to load "
1725 "the disk parameters."
1728 #. type: Labeled list
1729 #: ../disk-utils/fdformat.8.adoc:52
1731 #| msgid "*-f*, *--fast*"
1732 msgid "*-f*, *--from* _N_"
1733 msgstr "*-f*, *--fast*"
1736 #: ../disk-utils/fdformat.8.adoc:54
1737 msgid "Start at the track _N_ (default is 0)."
1740 #. type: Labeled list
1741 #: ../disk-utils/fdformat.8.adoc:55
1743 #| msgid "*-P*, *--pty*"
1744 msgid "*-t*, *--to* _N_"
1745 msgstr "*-P*, *--pty*"
1748 #: ../disk-utils/fdformat.8.adoc:57
1749 msgid "Stop at the track _N_."
1752 #. type: Labeled list
1753 #: ../disk-utils/fdformat.8.adoc:58
1755 #| msgid "*-h*, *--help*"
1756 msgid "*-r*, *--repair* _N_"
1757 msgstr "*-h*, *--help*"
1760 #: ../disk-utils/fdformat.8.adoc:60
1761 msgid "Try to repair tracks failed during the verification (max _N_ retries)."
1764 #. type: Labeled list
1765 #: ../disk-utils/fdformat.8.adoc:61
1767 #| msgid "*-V*, *--version*"
1768 msgid "*-n*, *--no-verify*"
1769 msgstr "*-V*, *--version*"
1772 #: ../disk-utils/fdformat.8.adoc:63
1773 msgid "Skip the verification that is normally performed after the formatting."
1777 #: ../disk-utils/fdformat.8.adoc:66 ../disk-utils/mkswap.8.adoc:103
1778 #: ../disk-utils/raw.8.adoc:47 ../disk-utils/sfdisk.8.adoc:420
1779 #: ../login-utils/last.1.adoc:117 ../login-utils/lslogins.1.adoc:118
1780 #: ../login-utils/nologin.8.adoc:53 ../login-utils/su.1.adoc:137
1781 #: ../login-utils/utmpdump.1.adoc:51 ../misc-utils/cal.1.adoc:144
1782 #: ../misc-utils/kill.1.adoc:96 ../misc-utils/lsblk.8.adoc:214
1783 #: ../misc-utils/lslocks.8.adoc:112 ../misc-utils/pipesz.1.adoc:83
1784 #: ../schedutils/chrt.1.adoc:137 ../schedutils/ionice.1.adoc:68
1785 #: ../schedutils/uclampset.1.adoc:114 ../sys-utils/choom.1.adoc:33
1786 #: ../sys-utils/eject.1.adoc:97 ../sys-utils/flock.1.adoc:94
1787 #: ../sys-utils/fsfreeze.8.adoc:45 ../sys-utils/fstab.5.adoc:129
1788 #: ../sys-utils/hwclock.8.adoc:176 ../sys-utils/ipcrm.1.adoc:63
1789 #: ../sys-utils/ipcs.1.adoc:80 ../sys-utils/losetup.8.adoc:127
1790 #: ../sys-utils/mountpoint.1.adoc:57 ../sys-utils/nsenter.1.adoc:149
1791 #: ../sys-utils/prlimit.1.adoc:110 ../sys-utils/renice.1.adoc:84
1792 #: ../sys-utils/rtcwake.8.adoc:110 ../sys-utils/setpriv.1.adoc:120
1793 #: ../sys-utils/swapon.8.adoc:139 ../sys-utils/switch_root.8.adoc:33
1794 #: ../sys-utils/tunelp.8.adoc:64 ../sys-utils/unshare.1.adoc:146
1795 #: ../term-utils/script.1.adoc:134 ../term-utils/wall.1.adoc:73
1796 #: ../text-utils/col.1.adoc:90 ../text-utils/pg.1.adoc:136
1802 #: ../disk-utils/fdformat.8.adoc:69
1804 "This utility does not handle USB floppy disk drives. Use *ufiformat*(8) "
1809 #: ../disk-utils/fdformat.8.adoc:73
1810 msgid "mailto:almesber@nessie.cs.id.ethz.ch[Werner Almesberger]"
1814 #: ../disk-utils/fdformat.8.adoc:81
1824 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1825 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
1826 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
1827 #. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
1828 #. May be distributed under the GNU General Public License
1830 #: ../disk-utils/fdisk.8.adoc:9
1836 #: ../disk-utils/fdisk.8.adoc:20
1837 msgid "fdisk - manipulate disk partition table"
1841 #: ../disk-utils/fdisk.8.adoc:24
1843 msgid "*fdisk* [options] _device_\n"
1847 #: ../disk-utils/fdisk.8.adoc:26
1849 msgid "*fdisk* *-l* [_device_...]\n"
1853 #: ../disk-utils/fdisk.8.adoc:30
1855 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"
1859 #: ../disk-utils/fdisk.8.adoc:32
1861 "Block devices can be divided into one or more logical disks called "
1862 "_partitions_. This division is recorded in the _partition table_, usually "
1863 "found in sector 0 of the disk. (In the BSD world one talks about `disk "
1864 "slices' and a `disklabel'.)"
1867 #. TRANSLATORS: Keep {plus} untranslated.
1869 #: ../disk-utils/fdisk.8.adoc:35
1871 "All partitioning is driven by device I/O limits (the topology) by default. "
1872 "*fdisk* is able to optimize the disk layout for a 4K-sector size and use an "
1873 "alignment offset on modern devices for MBR and GPT. It is always a good idea "
1874 "to follow *fdisk*'s defaults as the default values (e.g., first and last "
1875 "partition sectors) and partition sizes specified by the {plus}/-<size>{M,"
1876 "G,...} notation are always aligned according to the device properties."
1880 #: ../disk-utils/fdisk.8.adoc:37
1882 "CHS (Cylinder-Head-Sector) addressing is deprecated and not used by default. "
1883 "Please, do not follow old articles and recommendations with *fdisk -S <n> -H "
1884 "<n>* advices for SSD or 4K-sector devices."
1888 #: ../disk-utils/fdisk.8.adoc:39
1890 "Note that *partx*(8) provides a rich interface for scripts to print disk "
1891 "layouts, *fdisk* is mostly designed for humans. Backward compatibility in "
1892 "the output of *fdisk* is not guaranteed. The input (the commands) should "
1893 "always be backward compatible."
1896 #. type: Labeled list
1897 #: ../disk-utils/fdisk.8.adoc:42
1899 msgid "*-b*, *--sector-size* _sectorsize_"
1903 #: ../disk-utils/fdisk.8.adoc:44
1905 "Specify the sector size of the disk. Valid values are 512, 1024, 2048, and "
1906 "4096. (Recent kernels know the sector size. Use this option only on old "
1907 "kernels or to override the kernel's ideas.) Since util-linux-2.17, *fdisk* "
1908 "differentiates between logical and physical sector size. This option changes "
1909 "both sector sizes to _sectorsize_."
1912 #. type: Labeled list
1913 #: ../disk-utils/fdisk.8.adoc:45
1915 #| msgid "*-P*, *--pty*"
1916 msgid "*-B*, *--protect-boot*"
1917 msgstr "*-P*, *--pty*"
1920 #: ../disk-utils/fdisk.8.adoc:47
1922 "Don't erase the beginning of the first disk sector when creating a new disk "
1923 "label. This feature is supported for GPT and MBR."
1926 #. type: Labeled list
1927 #: ../disk-utils/fdisk.8.adoc:48
1929 #| msgid "*-c*, **--command**=__command__"
1930 msgid "*-c*, *--compatibility*[=_mode_]"
1931 msgstr "*-c*, **--command**=__příkaz__"
1934 #: ../disk-utils/fdisk.8.adoc:50
1936 "Specify the compatibility mode, 'dos' or 'nondos'. The default is non-DOS "
1937 "mode. For backward compatibility, it is possible to use the option without "
1938 "the _mode_ argument -- then the default is used. Note that the optional "
1939 "_mode_ argument cannot be separated from the *-c* option by a space, the "
1940 "correct form is for example *-c*=_dos_."
1943 #. type: Labeled list
1944 #: ../disk-utils/fdisk.8.adoc:53 ../sys-utils/dmesg.1.adoc:81
1945 #: ../text-utils/hexdump.1.adoc:85
1947 msgid "*-L*, *--color*[=_when_]"
1951 #: ../disk-utils/fdisk.8.adoc:55 ../disk-utils/sfdisk.8.adoc:151
1952 #: ../misc-utils/cal.1.adoc:119
1954 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
1955 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
1956 "colors can be disabled; for the current built-in default see the *--help* "
1957 "output. See also the *COLORS* section."
1960 #. type: Labeled list
1961 #: ../disk-utils/fdisk.8.adoc:56 ../disk-utils/fsck.minix.8.adoc:47
1962 #: ../disk-utils/partx.8.adoc:54 ../misc-utils/enosys.1.adoc:33
1963 #: ../misc-utils/findmnt.8.adoc:84 ../misc-utils/lsblk.8.adoc:73
1964 #: ../sys-utils/losetup.8.adoc:101 ../sys-utils/lsipc.1.adoc:53
1965 #: ../sys-utils/lsns.8.adoc:37
1967 #| msgid "*-f*, *--fast*"
1968 msgid "*-l*, *--list*"
1969 msgstr "*-f*, *--fast*"
1972 #: ../disk-utils/fdisk.8.adoc:58
1973 msgid "List the partition tables for the specified devices and then exit."
1977 #: ../disk-utils/fdisk.8.adoc:60
1979 "If no devices are given, the devices mentioned in _/proc/partitions_ (if "
1980 "this file exists) are used. Devices are always listed in the order in which "
1981 "they are specified on the command-line, or by the kernel listed in _/proc/"
1985 #. type: Labeled list
1986 #: ../disk-utils/fdisk.8.adoc:61
1988 #| msgid "*-h*, *--help*"
1989 msgid "*-x*, *--list-details*"
1990 msgstr "*-h*, *--help*"
1993 #: ../disk-utils/fdisk.8.adoc:63
1994 msgid "Like *--list*, but provides more details."
1997 #. type: Labeled list
1998 #: ../disk-utils/fdisk.8.adoc:67
2000 #| msgid "*-P*, *--pty*"
2001 msgid "*-n*, *--noauto-pt*"
2002 msgstr "*-P*, *--pty*"
2005 #: ../disk-utils/fdisk.8.adoc:69
2007 "Don't automatically create a default partition table on empty device. The "
2008 "partition table has to be explicitly created by user (by command like 'o', "
2012 #. type: Labeled list
2013 #: ../disk-utils/fdisk.8.adoc:70 ../disk-utils/partx.8.adoc:69
2014 #: ../disk-utils/sfdisk.8.adoc:195 ../login-utils/lslogins.1.adoc:69
2015 #: ../misc-utils/fincore.1.adoc:37 ../misc-utils/findmnt.8.adoc:103
2016 #: ../misc-utils/lsblk.8.adoc:91 ../misc-utils/lsclocks.1.adoc:32
2017 #: ../misc-utils/lsfd.1.adoc:50 ../misc-utils/lslocks.8.adoc:49
2018 #: ../sys-utils/irqtop.1.adoc:25 ../sys-utils/lsipc.1.adoc:65
2019 #: ../sys-utils/lsirq.1.adoc:28 ../sys-utils/lsmem.1.adoc:45
2020 #: ../sys-utils/lsns.8.adoc:43 ../sys-utils/prlimit.1.adoc:46
2021 #: ../sys-utils/wdctl.8.adoc:39 ../sys-utils/zramctl.8.adoc:52
2023 #| msgid "*-P*, *--pty*"
2024 msgid "*-o*, *--output* _list_"
2025 msgstr "*-P*, *--pty*"
2028 #: ../disk-utils/fdisk.8.adoc:72 ../disk-utils/sfdisk.8.adoc:197
2029 #: ../misc-utils/lslocks.8.adoc:51 ../misc-utils/uuidparse.1.adoc:58
2030 #: ../misc-utils/wipefs.8.adoc:60 ../sys-utils/lsipc.1.adoc:67
2031 #: ../sys-utils/lsns.8.adoc:45
2033 "Specify which output columns to print. Use *--help* to get a list of all "
2034 "supported columns."
2037 #. TRANSLATORS: Keep {plus} untranslated.
2039 #: ../disk-utils/fdisk.8.adoc:74
2041 "The default list of columns may be extended if _list_ is specified in the "
2042 "format _{plus}list_ (e.g., *-o {plus}UUID*)."
2045 #. type: Labeled list
2046 #: ../disk-utils/fdisk.8.adoc:76
2048 #| msgid "*-P*, *--pty*"
2049 msgid "*-s*, *--getsz*"
2050 msgstr "*-P*, *--pty*"
2053 #: ../disk-utils/fdisk.8.adoc:78
2055 "Print the size in 512-byte sectors of each given block device. This option "
2056 "is DEPRECATED in favour of *blockdev*(8)."
2059 #. type: Labeled list
2060 #: ../disk-utils/fdisk.8.adoc:79 ../disk-utils/mkfs.8.adoc:29
2061 #: ../disk-utils/partx.8.adoc:84 ../sys-utils/blkpr.8.adoc:38
2062 #: ../sys-utils/lsns.8.adoc:61
2064 #| msgid "*-P*, *--pty*"
2065 msgid "*-t*, *--type* _type_"
2066 msgstr "*-P*, *--pty*"
2069 #: ../disk-utils/fdisk.8.adoc:81
2071 "Enable support only for disklabels of the specified _type_, and disable "
2072 "support for all other types."
2075 #. type: Labeled list
2076 #: ../disk-utils/fdisk.8.adoc:82
2078 msgid "*-u*, *--units*[=_unit_]"
2082 #: ../disk-utils/fdisk.8.adoc:84
2084 "When listing partition tables, show sizes in 'sectors' or in 'cylinders'. "
2085 "The default is to show sizes in sectors. For backward compatibility, it is "
2086 "possible to use the option without the _unit_ argument -- then the default "
2087 "is used. Note that the optional _unit_ argument cannot be separated from the "
2088 "*-u* option by a space, the correct form is for example '**-"
2089 "u=**__cylinders__'."
2092 #. type: Labeled list
2093 #: ../disk-utils/fdisk.8.adoc:85
2095 msgid "*-C*, *--cylinders* _number_"
2099 #: ../disk-utils/fdisk.8.adoc:87
2101 "Specify the _number_ of cylinders of the disk. I have no idea why anybody "
2102 "would want to do so."
2105 #. type: Labeled list
2106 #: ../disk-utils/fdisk.8.adoc:88
2108 msgid "*-H*, *--heads* _number_"
2112 #: ../disk-utils/fdisk.8.adoc:90
2114 "Specify the number of heads of the disk. (Not the physical number, of "
2115 "course, but the number used for partition tables.) Reasonable values are 255 "
2119 #. type: Labeled list
2120 #: ../disk-utils/fdisk.8.adoc:91
2122 msgid "*-S*, *--sectors* _number_"
2126 #: ../disk-utils/fdisk.8.adoc:93
2128 "Specify the number of sectors per track of the disk. (Not the physical "
2129 "number, of course, but the number used for partition tables.) A reasonable "
2133 #. type: Labeled list
2134 #: ../disk-utils/fdisk.8.adoc:94 ../disk-utils/sfdisk.8.adoc:213
2136 msgid "*-w*, *--wipe* _when_"
2140 #: ../disk-utils/fdisk.8.adoc:96
2142 "Wipe filesystem, RAID and partition-table signatures from the device, in "
2143 "order to avoid possible collisions. The argument _when_ can be *auto*, "
2144 "*never* or *always*. When this option is not given, the default is *auto*, "
2145 "in which case signatures are wiped only when in interactive mode. In all "
2146 "cases detected signatures are reported by warning messages before a new "
2147 "partition table is created. See also *wipefs*(8) command."
2150 #. type: Labeled list
2151 #: ../disk-utils/fdisk.8.adoc:97 ../disk-utils/sfdisk.8.adoc:216
2153 msgid "*-W*, *--wipe-partitions* _when_"
2157 #: ../disk-utils/fdisk.8.adoc:99
2159 "Wipe filesystem, RAID and partition-table signatures from a newly created "
2160 "partitions, in order to avoid possible collisions. The argument _when_ can "
2161 "be *auto*, *never* or *always*. When this option is not given, the default "
2162 "is *auto*, in which case signatures are wiped only when in interactive mode "
2163 "and after confirmation by user. In all cases detected signatures are "
2164 "reported by warning messages before a new partition is created. See also "
2165 "*wipefs*(8) command."
2169 #: ../disk-utils/fdisk.8.adoc:102 ../disk-utils/fsck.8.adoc:117
2170 #: ../disk-utils/sfdisk.8.adoc:221 ../sys-utils/blkpr.8.adoc:44
2171 #: ../sys-utils/setsid.1.adoc:36
2173 #| msgid "Display help text and exit."
2174 msgid "Display version information and exit."
2175 msgstr "Zobrazí text nápovědy a skončí."
2178 #: ../disk-utils/fdisk.8.adoc:103
2184 #: ../disk-utils/fdisk.8.adoc:106
2186 "The _device_ is usually _/dev/sda_, _/dev/sdb_ or so. A device name refers "
2187 "to the entire disk. Old systems without libata (a library used inside the "
2188 "Linux kernel to support ATA host controllers and devices) make a difference "
2189 "between IDE and SCSI disks. In such cases the device name will be _/dev/hd*_ "
2190 "(IDE) or _/dev/sd*_ (SCSI)."
2194 #: ../disk-utils/fdisk.8.adoc:108
2196 "The _partition_ is a device name followed by a partition number. For "
2197 "example, _/dev/sda1_ is the first partition on the first hard disk in the "
2198 "system. See also Linux kernel documentation (the _Documentation/admin-guide/"
2199 "devices.txt_ file)."
2203 #: ../disk-utils/fdisk.8.adoc:109
2208 #. TRANSLATORS: Keep {plus} untranslated.
2210 #: ../disk-utils/fdisk.8.adoc:114
2212 "The \"last sector\" dialog accepts partition size specified by number of "
2213 "sectors or by {plus}/-<size>{K,B,M,G,...} notation."
2216 #. TRANSLATORS: Keep {plus} untranslated.
2218 #: ../disk-utils/fdisk.8.adoc:118
2220 "If the size is prefixed by '{plus}' then it is interpreted as relative to "
2221 "the partition first sector. If the size is prefixed by '-' then it is "
2222 "interpreted as relative to the high limit (last available sector for the "
2227 #: ../disk-utils/fdisk.8.adoc:120
2229 "In the case the size is specified in bytes than the number may be followed "
2230 "by the multiplicative suffixes KiB=1024, MiB=1024*1024, and so on for GiB, "
2231 "TiB, PiB, EiB, ZiB and YiB. The \"iB\" is optional, e.g., \"K\" has the same "
2232 "meaning as \"KiB\"."
2235 #. TRANSLATORS: Keep {plus} untranslated.
2237 #: ../disk-utils/fdisk.8.adoc:124
2239 "The relative sizes are always aligned according to device I/O limits. The "
2240 "{plus}/-<size>{K,B,M,G,...} notation is recommended."
2244 #: ../disk-utils/fdisk.8.adoc:126
2246 "For backward compatibility *fdisk* also accepts the suffixes KB=1000, "
2247 "MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB. These 10^N suffixes "
2252 #: ../disk-utils/fdisk.8.adoc:127
2254 #| msgid "CONFIG FILES"
2255 msgid "SCRIPT FILES"
2256 msgstr "KONFIGURAČNÍ SOUBORY"
2259 #: ../disk-utils/fdisk.8.adoc:130
2261 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"
2265 #: ../disk-utils/fdisk.8.adoc:132
2267 "And vice-versa it is possible to write the current in-memory disk layout to "
2268 "the script file by command 'O'."
2272 #: ../disk-utils/fdisk.8.adoc:134
2274 "The script files are compatible between *cfdisk*(8), *sfdisk*(8), *fdisk* "
2275 "and other libfdisk applications. For more details see *sfdisk*(8)."
2279 #: ../disk-utils/fdisk.8.adoc:135
2284 #. type: Labeled list
2285 #: ../disk-utils/fdisk.8.adoc:137
2287 msgid "*GPT (GUID Partition Table)*"
2291 #: ../disk-utils/fdisk.8.adoc:139
2293 "GPT is modern standard for the layout of the partition table. GPT uses 64-"
2294 "bit logical block addresses, checksums, UUIDs and names for partitions and "
2295 "an unlimited number of partitions (although the number of partitions is "
2296 "usually restricted to 128 in many partitioning tools)."
2300 #: ../disk-utils/fdisk.8.adoc:141
2302 "Note that the first sector is still reserved for a *protective MBR* in the "
2303 "GPT specification. It prevents MBR-only partitioning tools from mis-"
2304 "recognizing and overwriting GPT disks."
2308 #: ../disk-utils/fdisk.8.adoc:143
2310 "GPT is always a better choice than MBR, especially on modern hardware with a "
2314 #. type: Labeled list
2315 #: ../disk-utils/fdisk.8.adoc:144
2317 msgid "*DOS-type (MBR)*"
2321 #: ../disk-utils/fdisk.8.adoc:146
2323 "A DOS-type partition table can describe an unlimited number of partitions. "
2324 "In sector 0 there is room for the description of 4 partitions (called "
2325 "`primary'). One of these may be an extended partition; this is a box holding "
2326 "logical partitions, with descriptors found in a linked list of sectors, each "
2327 "preceding the corresponding logical partitions. The four primary partitions, "
2328 "present or not, get numbers 1-4. Logical partitions are numbered starting "
2332 #. TRANSLATORS: Keep {plus} untranslated.
2334 #: ../disk-utils/fdisk.8.adoc:148
2336 "In a DOS-type partition table the starting offset and the size of each "
2337 "partition is stored in two ways: as an absolute number of sectors (given in "
2338 "32 bits), and as a *Cylinders/Heads/Sectors* triple (given in 10{plus}8{plus}"
2339 "6 bits). The former is OK -- with 512-byte sectors this will work up to 2 "
2340 "TB. The latter has two problems. First, these C/H/S fields can be filled "
2341 "only when the number of heads and the number of sectors per track are known. "
2342 "And second, even if we know what these numbers should be, the 24 bits that "
2343 "are available do not suffice. DOS uses C/H/S only, Windows uses both, Linux "
2344 "never uses C/H/S. The *C/H/S addressing is deprecated* and may be "
2345 "unsupported in some later *fdisk* version."
2349 #: ../disk-utils/fdisk.8.adoc:151
2351 msgid "*Please, read the DOS-mode section if you want DOS-compatible partitions.* *fdisk* does not care about cylinder boundaries by default.\n"
2354 #. type: Labeled list
2355 #: ../disk-utils/fdisk.8.adoc:152
2357 msgid "*BSD/Sun-type*"
2361 #: ../disk-utils/fdisk.8.adoc:154
2363 "A BSD/Sun disklabel can describe 8 partitions, the third of which should be "
2364 "a `whole disk' partition. Do not start a partition that actually uses its "
2365 "first sector (like a swap partition) at cylinder 0, since that will destroy "
2366 "the disklabel. Note that a *BSD label* is usually nested within a DOS "
2370 #. type: Labeled list
2371 #: ../disk-utils/fdisk.8.adoc:155
2373 msgid "*IRIX/SGI-type*"
2377 #: ../disk-utils/fdisk.8.adoc:157
2379 "An IRIX/SGI disklabel can describe 16 partitions, the eleventh of which "
2380 "should be an entire `volume' partition, while the ninth should be labeled "
2381 "`volume header'. The volume header will also cover the partition table, i."
2382 "e., it starts at block zero and extends by default over five cylinders. The "
2383 "remaining space in the volume header may be used by header directory "
2384 "entries. No partitions may overlap with the volume header. Also do not "
2385 "change its type or make some filesystem on it, since you will lose the "
2386 "partition table. Use this type of label only when working with Linux on IRIX/"
2387 "SGI machines or IRIX/SGI disks under Linux."
2391 #: ../disk-utils/fdisk.8.adoc:159
2393 "A *sync*(2) and an ioctl(BLKRRPART) (rereading the partition table from "
2394 "disk) are performed before exiting when the partition table has been updated."
2398 #: ../disk-utils/fdisk.8.adoc:160
2400 msgid "DOS mode and DOS 6.x WARNING"
2404 #: ../disk-utils/fdisk.8.adoc:163
2406 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"
2410 #: ../disk-utils/fdisk.8.adoc:165
2412 "The DOS 6.x FORMAT command looks for some information in the first sector of "
2413 "the data area of the partition, and treats this information as more reliable "
2414 "than the information in the partition table. DOS FORMAT expects DOS FDISK to "
2415 "clear the first 512 bytes of the data area of a partition whenever a size "
2416 "change occurs. DOS FORMAT will look at this extra information even if the /U "
2417 "flag is given -- we consider this a bug in DOS FORMAT and DOS FDISK."
2421 #: ../disk-utils/fdisk.8.adoc:167
2423 "The bottom line is that if you use *fdisk* or *cfdisk*(8) to change the size "
2424 "of a DOS partition table entry, then you must also use *dd*(1) to *zero the "
2425 "first 512 bytes* of that partition before using DOS FORMAT to format the "
2426 "partition. For example, if you were using *fdisk* to make a DOS partition "
2427 "table entry for _/dev/sda1_, then (after exiting *fdisk* and rebooting Linux "
2428 "so that the partition table information is valid) you would use the command "
2429 "*dd if=/dev/zero of=/dev/sda1 bs=512 count=1* to zero the first 512 bytes of "
2434 #: ../disk-utils/fdisk.8.adoc:169
2436 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"
2440 #: ../disk-utils/fdisk.8.adoc:171
2442 "Usually all goes well by default, and there are no problems if Linux is the "
2443 "only system on the disk. However, if the disk has to be shared with other "
2444 "operating systems, it is often a good idea to let an *fdisk* from another "
2445 "operating system make at least one partition. When Linux boots it looks at "
2446 "the partition table, and tries to deduce what (fake) geometry is required "
2447 "for good cooperation with other systems."
2451 #: ../disk-utils/fdisk.8.adoc:173
2453 "Whenever a partition table is printed out in DOS mode, a consistency check "
2454 "is performed on the partition table entries. This check verifies that the "
2455 "physical and logical start and end points are identical, and that each "
2456 "partition starts and ends on a cylinder boundary (except for the first "
2461 #: ../disk-utils/fdisk.8.adoc:175
2463 "Some versions of MS-DOS create a first partition which does not begin on a "
2464 "cylinder boundary, but on sector 2 of the first cylinder. Partitions "
2465 "beginning in cylinder 1 cannot begin on a cylinder boundary, but this is "
2466 "unlikely to cause difficulty unless you have OS/2 on your machine."
2470 #: ../disk-utils/fdisk.8.adoc:177
2472 "For best results, you should always use an OS-specific partition table "
2473 "program. For example, you should make DOS partitions with the DOS FDISK "
2474 "program and Linux partitions with the Linux *fdisk* or Linux *cfdisk*(8) "
2479 #: ../disk-utils/fdisk.8.adoc:180
2480 msgid "The logical color names supported by *fdisk* are:"
2483 #. type: Labeled list
2484 #: ../disk-utils/fdisk.8.adoc:181 ../disk-utils/sfdisk.8.adoc:400
2485 #: ../misc-utils/cal.1.adoc:159
2491 #: ../disk-utils/fdisk.8.adoc:183 ../disk-utils/sfdisk.8.adoc:402
2492 msgid "The header of the output tables."
2495 #. type: Labeled list
2496 #: ../disk-utils/fdisk.8.adoc:184
2498 msgid "*help-title*"
2502 #: ../disk-utils/fdisk.8.adoc:186
2503 msgid "The help section titles."
2506 #. type: Labeled list
2507 #: ../disk-utils/fdisk.8.adoc:187 ../disk-utils/sfdisk.8.adoc:402
2508 #: ../sys-utils/dmesg.1.adoc:182
2514 #: ../disk-utils/fdisk.8.adoc:189 ../disk-utils/sfdisk.8.adoc:404
2515 msgid "The warning messages."
2518 #. type: Labeled list
2519 #: ../disk-utils/fdisk.8.adoc:190 ../disk-utils/sfdisk.8.adoc:404
2525 #: ../disk-utils/fdisk.8.adoc:192 ../disk-utils/sfdisk.8.adoc:406
2526 msgid "The welcome message."
2529 #. type: Labeled list
2530 #: ../disk-utils/fdisk.8.adoc:195
2532 msgid "*FDISK_DEBUG*=all"
2536 #: ../disk-utils/fdisk.8.adoc:197
2537 msgid "enables fdisk debug output."
2541 #: ../disk-utils/fdisk.8.adoc:209 ../misc-utils/findmnt.8.adoc:214
2542 #: ../misc-utils/lsblk.8.adoc:213
2543 msgid "use visible padding characters."
2547 #: ../disk-utils/fdisk.8.adoc:217
2548 msgid "mailto:kzak@redhat.com[Karel Zak], mailto:dave@gnu.org[Davidlohr Bueso]"
2552 #: ../disk-utils/fdisk.8.adoc:219
2554 "The original version was written by Andries E. Brouwer, A. V. Le Blanc and "
2559 #: ../disk-utils/fdisk.8.adoc:226
2568 #. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
2569 #. This file may be copied under the terms of the GNU Public License.
2571 #: ../disk-utils/fsck.8.adoc:6
2577 #: ../disk-utils/fsck.8.adoc:16
2578 msgid "fsck - check and repair a Linux filesystem"
2582 #: ../disk-utils/fsck.8.adoc:20
2584 msgid "*fsck* [*-lsAVRTMNP*] [*-r* [_fd_]] [*-C* [_fd_]] [*-t* _fstype_] [_filesystem_...] [*--*] [_fs-specific-options_]\n"
2588 #: ../disk-utils/fsck.8.adoc:24
2590 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"
2594 #: ../disk-utils/fsck.8.adoc:26
2596 "If no filesystems are specified on the command line, and the *-A* option is "
2597 "not specified, *fsck* will default to checking filesystems in _/etc/fstab_ "
2598 "serially. This is equivalent to the *-As* options."
2602 #: ../disk-utils/fsck.8.adoc:28
2604 "The exit status returned by *fsck* is the sum of the following conditions:"
2607 #. type: Labeled list
2608 #: ../disk-utils/fsck.8.adoc:29 ../disk-utils/fsck.cramfs.8.adoc:42
2609 #: ../disk-utils/fsck.minix.8.adoc:80 ../disk-utils/isosize.8.adoc:35
2610 #: ../disk-utils/mkfs.cramfs.8.adoc:77 ../misc-utils/exch.1.adoc:32
2611 #: ../misc-utils/fadvise.1.adoc:48 ../misc-utils/findfs.8.adoc:51
2612 #: ../misc-utils/kill.1.adoc:43 ../misc-utils/kill.1.adoc:89
2613 #: ../misc-utils/rename.1.adoc:68 ../misc-utils/waitpid.1.adoc:44
2614 #: ../sys-utils/blkdiscard.8.adoc:61 ../sys-utils/chcpu.8.adoc:59
2615 #: ../sys-utils/chmem.8.adoc:58 ../sys-utils/lsns.8.adoc:79
2616 #: ../sys-utils/mount.8.adoc:1591 ../sys-utils/mountpoint.1.adoc:43
2617 #: ../sys-utils/swapon.8.adoc:98 ../term-utils/mesg.1.adoc:80
2623 #: ../disk-utils/fsck.8.adoc:31 ../disk-utils/fsck.minix.8.adoc:82
2624 #: ../disk-utils/mkfs.minix.8.adoc:81
2628 #. type: Labeled list
2629 #: ../disk-utils/fsck.8.adoc:31 ../disk-utils/isosize.8.adoc:37
2630 #: ../misc-utils/enosys.1.adoc:46 ../misc-utils/exch.1.adoc:34
2631 #: ../misc-utils/fadvise.1.adoc:50 ../misc-utils/findfs.8.adoc:53
2632 #: ../misc-utils/kill.1.adoc:91 ../misc-utils/rename.1.adoc:71
2633 #: ../misc-utils/waitpid.1.adoc:46 ../sys-utils/blkdiscard.8.adoc:64
2634 #: ../sys-utils/chcpu.8.adoc:62 ../sys-utils/chmem.8.adoc:61
2635 #: ../sys-utils/lsns.8.adoc:81 ../sys-utils/mount.8.adoc:1594
2636 #: ../sys-utils/mountpoint.1.adoc:46 ../term-utils/mesg.1.adoc:82
2642 #: ../disk-utils/fsck.8.adoc:33
2643 msgid "Filesystem errors corrected"
2646 #. type: Labeled list
2647 #: ../disk-utils/fsck.8.adoc:33 ../misc-utils/enosys.1.adoc:49
2648 #: ../misc-utils/findfs.8.adoc:55 ../misc-utils/rename.1.adoc:74
2649 #: ../misc-utils/waitpid.1.adoc:48 ../sys-utils/blkdiscard.8.adoc:67
2650 #: ../sys-utils/lsns.8.adoc:83 ../sys-utils/mount.8.adoc:893
2651 #: ../sys-utils/mount.8.adoc:1597 ../sys-utils/swapon.8.adoc:101
2657 #: ../disk-utils/fsck.8.adoc:35
2658 msgid "System should be rebooted"
2661 #. type: Labeled list
2662 #: ../disk-utils/fsck.8.adoc:35 ../disk-utils/fsck.cramfs.8.adoc:44
2663 #: ../disk-utils/fsck.minix.8.adoc:84 ../misc-utils/rename.1.adoc:77
2664 #: ../sys-utils/mount.8.adoc:1600 ../sys-utils/swapon.8.adoc:104
2669 #. type: delimited block _
2670 #: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.minix.8.adoc:86
2671 msgid "Filesystem errors left uncorrected"
2674 #. type: Labeled list
2675 #: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.cramfs.8.adoc:46
2676 #: ../disk-utils/fsck.minix.8.adoc:88 ../disk-utils/mkfs.cramfs.8.adoc:79
2677 #: ../sys-utils/mount.8.adoc:1603 ../sys-utils/swapon.8.adoc:107
2683 #: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.minix.8.adoc:90
2684 #: ../disk-utils/mkfs.minix.8.adoc:83
2685 msgid "Operational error"
2688 #. type: Labeled list
2689 #: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.cramfs.8.adoc:48
2690 #: ../disk-utils/fsck.minix.8.adoc:90 ../sys-utils/mount.8.adoc:1606
2691 #: ../sys-utils/swapon.8.adoc:110
2697 #: ../disk-utils/fsck.8.adoc:41 ../disk-utils/fsck.minix.8.adoc:92
2698 #: ../disk-utils/mkfs.minix.8.adoc:85
2699 msgid "Usage or syntax error"
2702 #. type: Labeled list
2703 #: ../disk-utils/fsck.8.adoc:41 ../disk-utils/isosize.8.adoc:39
2704 #: ../sys-utils/mount.8.adoc:1609 ../sys-utils/mountpoint.1.adoc:49
2705 #: ../sys-utils/swapon.8.adoc:113
2711 #: ../disk-utils/fsck.8.adoc:43
2712 msgid "Checking canceled by user request"
2715 #. type: Labeled list
2716 #: ../disk-utils/fsck.8.adoc:43
2722 #: ../disk-utils/fsck.8.adoc:45
2723 msgid "Shared-library error"
2727 #: ../disk-utils/fsck.8.adoc:47
2729 "The exit status returned when multiple filesystems are checked is the bit-"
2730 "wise OR of the exit statuses for each filesystem that is checked."
2734 #: ../disk-utils/fsck.8.adoc:49
2736 "In actuality, *fsck* is simply a front-end for the various filesystem "
2737 "checkers (*fsck*._fstype_) available under Linux. The filesystem-specific "
2738 "checker is searched for in the *PATH* environment variable. If the *PATH* is "
2739 "undefined then fallback to _/sbin_."
2743 #: ../disk-utils/fsck.8.adoc:51
2745 "Please see the filesystem-specific checker manual pages for further details."
2748 #. type: Labeled list
2749 #: ../disk-utils/fsck.8.adoc:54 ../disk-utils/mkfs.bfs.8.adoc:47
2750 #: ../misc-utils/whereis.1.adoc:97
2756 #: ../disk-utils/fsck.8.adoc:56
2758 "Create an exclusive *flock*(2) lock file (_/run/fsck/<diskname>.lock_) for "
2759 "whole-disk device. This option can be used with one device only (this means "
2760 "that *-A* and *-l* are mutually exclusive). This option is recommended when "
2761 "more *fsck* instances are executed in the same time. The option is ignored "
2762 "when used for multiple devices or for non-rotating disks. *fsck* does not "
2763 "lock underlying devices when executed to check stacked devices (e.g. MD or "
2764 "DM) - this feature is not implemented yet."
2767 #. type: Labeled list
2768 #: ../disk-utils/fsck.8.adoc:57
2774 #: ../disk-utils/fsck.8.adoc:59
2776 "Report certain statistics for each fsck when it completes. These statistics "
2777 "include the exit status, the maximum run set size (in kilobytes), the "
2778 "elapsed all-clock time and the user and system CPU time used by the fsck "
2783 #: ../disk-utils/fsck.8.adoc:61
2785 msgid "*/dev/sda1: status 0, rss 92828, real 4.002804, user 2.677592, sys 0.86186*\n"
2789 #: ../disk-utils/fsck.8.adoc:63
2791 "GUI front-ends may specify a file descriptor _fd_, in which case the "
2792 "progress bar information will be sent to that file descriptor in a machine "
2793 "parsable format. For example:"
2797 #: ../disk-utils/fsck.8.adoc:65
2799 msgid "*/dev/sda1 0 92828 4.002804 2.677592 0.86186*\n"
2802 #. type: Labeled list
2803 #: ../disk-utils/fsck.8.adoc:66 ../disk-utils/mkfs.cramfs.8.adoc:59
2804 #: ../misc-utils/whereis.1.adoc:79 ../sys-utils/mount.8.adoc:413
2805 #: ../text-utils/pg.1.adoc:59
2811 #: ../disk-utils/fsck.8.adoc:68
2813 "Serialize *fsck* operations. This is a good idea if you are checking "
2814 "multiple filesystems and the checkers are in an interactive mode. (Note: "
2815 "*e2fsck*(8) runs in an interactive mode by default. To make *e2fsck*(8) run "
2816 "in a non-interactive mode, you must either specify the *-p* or *-a* option, "
2817 "if you wish for errors to be corrected automatically, or the *-n* option if "
2821 #. type: Labeled list
2822 #: ../disk-utils/fsck.8.adoc:69
2824 msgid "*-t* _fslist_"
2828 #: ../disk-utils/fsck.8.adoc:71
2830 "Specifies the type(s) of filesystem to be checked. When the *-A* flag is "
2831 "specified, only filesystems that match _fslist_ are checked. The _fslist_ "
2832 "parameter is a comma-separated list of filesystems and options specifiers. "
2833 "All of the filesystems in this comma-separated list may be prefixed by a "
2834 "negation operator '*no*' or '*!*', which requests that only those "
2835 "filesystems not listed in _fslist_ will be checked. If none of the "
2836 "filesystems in _fslist_ is prefixed by a negation operator, then only those "
2837 "listed filesystems will be checked."
2841 #: ../disk-utils/fsck.8.adoc:73
2843 "Options specifiers may be included in the comma-separated _fslist_. They "
2844 "must have the format **opts=**__fs-option__. If an options specifier is "
2845 "present, then only filesystems which contain _fs-option_ in their mount "
2846 "options field of _/etc/fstab_ will be checked. If the options specifier is "
2847 "prefixed by a negation operator, then only those filesystems that do not "
2848 "have _fs-option_ in their mount options field of _/etc/fstab_ will be "
2853 #: ../disk-utils/fsck.8.adoc:75
2855 "For example, if *opts=ro* appears in _fslist_, then only filesystems listed "
2856 "in _/etc/fstab_ with the *ro* option will be checked."
2860 #: ../disk-utils/fsck.8.adoc:77
2862 "For compatibility with Mandrake distributions whose boot scripts depend upon "
2863 "an unauthorized UI change to the *fsck* program, if a filesystem type of "
2864 "*loop* is found in _fslist_, it is treated as if *opts=loop* were specified "
2865 "as an argument to the *-t* option."
2869 #: ../disk-utils/fsck.8.adoc:79
2871 "Normally, the filesystem type is deduced by searching for _filesys_ in the _/"
2872 "etc/fstab_ file and using the corresponding entry. If the type cannot be "
2873 "deduced, and there is only a single filesystem given as an argument to the *-"
2874 "t* option, *fsck* will use the specified filesystem type. If this type is "
2875 "not available, then the default filesystem type (currently ext2) is used."
2878 #. type: Labeled list
2879 #: ../disk-utils/fsck.8.adoc:80
2885 #: ../disk-utils/fsck.8.adoc:82
2887 "Walk through the _/etc/fstab_ file and try to check all filesystems in one "
2888 "run. This option is typically used from the _/etc/rc_ system initialization "
2889 "file, instead of multiple commands for checking a single filesystem."
2893 #: ../disk-utils/fsck.8.adoc:84
2895 "The root filesystem will be checked first unless the *-P* option is "
2896 "specified (see below). After that, filesystems will be checked in the order "
2897 "specified by the _fs_passno_ (the sixth) field in the _/etc/fstab_ file. "
2898 "Filesystems with a _fs_passno_ value of 0 are skipped and are not checked at "
2899 "all. Filesystems with a _fs_passno_ value of greater than zero will be "
2900 "checked in order, with filesystems with the lowest _fs_passno_ number being "
2901 "checked first. If there are multiple filesystems with the same pass number, "
2902 "*fsck* will attempt to check them in parallel, although it will avoid "
2903 "running multiple filesystem checks on the same physical disk."
2907 #: ../disk-utils/fsck.8.adoc:86
2909 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"
2913 #: ../disk-utils/fsck.8.adoc:88
2915 "Hence, a very common configuration in _/etc/fstab_ files is to set the root "
2916 "filesystem to have a _fs_passno_ value of 1 and to set all other filesystems "
2917 "to have a _fs_passno_ value of 2. This will allow *fsck* to automatically "
2918 "run filesystem checkers in parallel if it is advantageous to do so. System "
2919 "administrators might choose not to use this configuration if they need to "
2920 "avoid multiple filesystem checks running in parallel for some reason - for "
2921 "example, if the machine in question is short on memory so that excessive "
2922 "paging is a concern."
2926 #: ../disk-utils/fsck.8.adoc:90
2928 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"
2931 #. type: Labeled list
2932 #: ../disk-utils/fsck.8.adoc:91
2938 #: ../disk-utils/fsck.8.adoc:93
2940 "Display completion/progress bars for those filesystem checkers (currently "
2941 "only for ext[234]) which support them. *fsck* will manage the filesystem "
2942 "checkers so that only one of them will display a progress bar at a time. GUI "
2943 "front-ends may specify a file descriptor _fd_, in which case the progress "
2944 "bar information will be sent to that file descriptor."
2947 #. type: Labeled list
2948 #: ../disk-utils/fsck.8.adoc:94 ../schedutils/uclampset.1.adoc:72
2954 #: ../disk-utils/fsck.8.adoc:96
2956 "Do not check mounted filesystems and return an exit status of 0 for mounted "
2960 #. type: Labeled list
2961 #: ../disk-utils/fsck.8.adoc:97
2967 #: ../disk-utils/fsck.8.adoc:99
2968 msgid "Don't execute, just show what would be done."
2971 #. type: Labeled list
2972 #: ../disk-utils/fsck.8.adoc:100
2978 #: ../disk-utils/fsck.8.adoc:102
2980 "When the *-A* flag is set, check the root filesystem in parallel with the "
2981 "other filesystems. This is not the safest thing in the world to do, since if "
2982 "the root filesystem is in doubt things like the *e2fsck*(8) executable might "
2983 "be corrupted! This option is mainly provided for those sysadmins who don't "
2984 "want to repartition the root filesystem to be small and compact (which is "
2985 "really the right solution)."
2988 #. type: Labeled list
2989 #: ../disk-utils/fsck.8.adoc:103
2995 #: ../disk-utils/fsck.8.adoc:105
2997 "When checking all filesystems with the *-A* flag, skip the root filesystem. "
2998 "(This is useful in case the root filesystem has already been mounted read-"
3002 #. type: Labeled list
3003 #: ../disk-utils/fsck.8.adoc:106
3009 #: ../disk-utils/fsck.8.adoc:108
3010 msgid "Don't show the title on startup."
3013 #. type: Labeled list
3014 #: ../disk-utils/fsck.8.adoc:109
3020 #: ../disk-utils/fsck.8.adoc:111
3022 "Produce verbose output, including all filesystem-specific commands that are "
3026 #. type: Labeled list
3027 #: ../disk-utils/fsck.8.adoc:112
3029 #| msgid "*-h*, *--help*"
3030 msgid "*-?*, *--help*"
3031 msgstr "*-h*, *--help*"
3033 #. type: Labeled list
3034 #: ../disk-utils/fsck.8.adoc:115
3036 #| msgid "*-V*, *--version*"
3038 msgstr "*-V*, *--version*"
3041 #: ../disk-utils/fsck.8.adoc:118
3043 msgid "FILESYSTEM SPECIFIC OPTIONS"
3047 #: ../disk-utils/fsck.8.adoc:121
3049 msgid "*Options which are not understood by fsck are passed to the filesystem-specific checker!*\n"
3053 #: ../disk-utils/fsck.8.adoc:123
3055 "These options *must* not take arguments, as there is no way for *fsck* to be "
3056 "able to properly guess which options take arguments and which don't."
3060 #: ../disk-utils/fsck.8.adoc:125
3062 "Options and arguments which follow the *--* are treated as filesystem-"
3063 "specific options to be passed to the filesystem-specific checker."
3067 #: ../disk-utils/fsck.8.adoc:127
3069 "Please note that *fsck* is not designed to pass arbitrarily complicated "
3070 "options to filesystem-specific checkers. If you're doing something "
3071 "complicated, please just execute the filesystem-specific checker directly. "
3072 "If you pass *fsck* some horribly complicated options and arguments, and it "
3073 "doesn't do what you expect, *don't bother reporting it as a bug.* You're "
3074 "almost certainly doing something that you shouldn't be doing with *fsck*. "
3075 "Options to different filesystem-specific fsck's are not standardized."
3079 #: ../disk-utils/fsck.8.adoc:131
3081 "The *fsck* program's behavior is affected by the following environment "
3085 #. type: Labeled list
3086 #: ../disk-utils/fsck.8.adoc:132
3088 msgid "*FSCK_FORCE_ALL_PARALLEL*"
3092 #: ../disk-utils/fsck.8.adoc:134
3094 "If this environment variable is set, *fsck* will attempt to check all of the "
3095 "specified filesystems in parallel, regardless of whether the filesystems "
3096 "appear to be on the same device. (This is useful for RAID systems or high-"
3097 "end storage systems such as those sold by companies such as IBM or EMC.) "
3098 "Note that the _fs_passno_ value is still used."
3101 #. type: Labeled list
3102 #: ../disk-utils/fsck.8.adoc:135
3104 msgid "*FSCK_MAX_INST*"
3108 #: ../disk-utils/fsck.8.adoc:137
3110 "This environment variable will limit the maximum number of filesystem "
3111 "checkers that can be running at one time. This allows configurations which "
3112 "have a large number of disks to avoid *fsck* starting too many filesystem "
3113 "checkers at once, which might overload CPU and memory resources available on "
3114 "the system. If this value is zero, then an unlimited number of processes can "
3115 "be spawned. This is currently the default, but future versions of *fsck* may "
3116 "attempt to automatically determine how many filesystem checks can be run "
3117 "based on gathering accounting data from the operating system."
3120 #. type: Labeled list
3121 #: ../disk-utils/fsck.8.adoc:138
3127 #: ../disk-utils/fsck.8.adoc:140
3128 msgid "The *PATH* environment variable is used to find filesystem checkers."
3131 #. type: Labeled list
3132 #: ../disk-utils/fsck.8.adoc:141
3134 msgid "*FSTAB_FILE*"
3138 #: ../disk-utils/fsck.8.adoc:143
3140 "This environment variable allows the system administrator to override the "
3141 "standard location of the _/etc/fstab_ file. It is also useful for developers "
3142 "who are testing *fsck*."
3145 #. type: Labeled list
3146 #: ../disk-utils/fsck.8.adoc:144
3148 msgid "*LIBBLKID_DEBUG=all*"
3151 #. type: Labeled list
3152 #: ../disk-utils/fsck.8.adoc:147
3154 msgid "*LIBMOUNT_DEBUG=all*"
3158 #: ../disk-utils/fsck.8.adoc:149 ../sys-utils/mountpoint.1.adoc:56
3159 msgid "enables libmount debug output."
3163 #: ../disk-utils/fsck.8.adoc:150 ../lib/terminal-colors.d.5.adoc:134
3164 #: ../login-utils/last.1.adoc:112 ../login-utils/login.1.adoc:137
3165 #: ../login-utils/newgrp.1.adoc:29 ../login-utils/runuser.1.adoc:115
3166 #: ../login-utils/su.1.adoc:123 ../misc-utils/look.1.adoc:82
3167 #: ../misc-utils/mcookie.1.adoc:44 ../sys-utils/adjtime_config.5.adoc:50
3168 #: ../sys-utils/ctrlaltdel.8.adoc:39 ../sys-utils/fstab.5.adoc:124
3169 #: ../sys-utils/hwclock.8.adoc:365 ../sys-utils/losetup.8.adoc:136
3170 #: ../sys-utils/mount.8.adoc:1644 ../sys-utils/readprofile.8.adoc:56
3171 #: ../sys-utils/renice.1.adoc:79 ../sys-utils/rtcwake.8.adoc:114
3172 #: ../sys-utils/swapon.8.adoc:131 ../sys-utils/tunelp.8.adoc:59
3173 #: ../sys-utils/umount.8.adoc:158 ../sys-utils/zramctl.8.adoc:78
3174 #: ../term-utils/agetty.8.adoc:305 ../term-utils/mesg.1.adoc:87
3179 #. type: Labeled list
3180 #: ../disk-utils/fsck.8.adoc:153 ../sys-utils/fstab.5.adoc:50
3181 #: ../sys-utils/mount.8.adoc:1648 ../sys-utils/swapon.8.adoc:136
3182 #: ../sys-utils/umount.8.adoc:163
3184 msgid "_/etc/fstab_"
3185 msgstr "_/etc/fstab_"
3188 #: ../disk-utils/fsck.8.adoc:158
3189 msgid "mailto:tytso@mit.edu>[Theodore Ts'o], mailto:kzak@redhat.com[Karel Zak]"
3193 #: ../disk-utils/fsck.8.adoc:172
3198 "*fsck.ext2*(8) or *fsck.ext3*(8) or *e2fsck*(8),\n"
3199 "*fsck.cramfs*(8),\n"
3202 "*fsck.minix*(8),\n"
3203 "*fsck.msdos*(8),\n"
3210 #: ../disk-utils/fsck.cramfs.8.adoc:2
3212 msgid "fsck.cramfs(8)"
3216 #: ../disk-utils/fsck.cramfs.8.adoc:12
3217 msgid "fsck.cramfs - fsck compressed ROM file system"
3221 #: ../disk-utils/fsck.cramfs.8.adoc:16
3223 msgid "*fsck.cramfs* [options] _file_\n"
3227 #: ../disk-utils/fsck.cramfs.8.adoc:20
3229 msgid "*fsck.cramfs* is used to check the cramfs file system.\n"
3232 #. type: Labeled list
3233 #: ../disk-utils/fsck.cramfs.8.adoc:23 ../disk-utils/fsck.minix.8.adoc:56
3234 #: ../disk-utils/mkfs.bfs.8.adoc:41 ../disk-utils/partx.8.adoc:96
3235 #: ../misc-utils/hardlink.1.adoc:102 ../misc-utils/mcookie.1.adoc:39
3236 #: ../misc-utils/pipesz.1.adoc:64 ../misc-utils/rename.1.adoc:28
3237 #: ../misc-utils/waitpid.1.adoc:26 ../schedutils/chrt.1.adoc:101
3238 #: ../schedutils/uclampset.1.adoc:87 ../sys-utils/blkdiscard.8.adoc:52
3239 #: ../sys-utils/blkzone.8.adoc:98 ../sys-utils/chmem.8.adoc:49
3240 #: ../sys-utils/eject.1.adoc:84 ../sys-utils/fallocate.1.adoc:64
3241 #: ../sys-utils/hwclock.8.adoc:173 ../sys-utils/losetup.8.adoc:98
3242 #: ../sys-utils/mount.8.adoc:457 ../sys-utils/readprofile.8.adoc:51
3243 #: ../sys-utils/rtcwake.8.adoc:105 ../sys-utils/setarch.8.adoc:42
3244 #: ../sys-utils/swapon.8.adoc:89 ../sys-utils/umount.8.adoc:111
3245 #: ../term-utils/mesg.1.adoc:71
3247 #| msgid "*-V*, *--version*"
3248 msgid "*-v*, *--verbose*"
3249 msgstr "*-V*, *--version*"
3252 #: ../disk-utils/fsck.cramfs.8.adoc:25 ../disk-utils/mkfs.cramfs.8.adoc:37
3253 msgid "Enable verbose messaging."
3256 #. type: Labeled list
3257 #: ../disk-utils/fsck.cramfs.8.adoc:26
3259 msgid "*-b*, *--blocksize* _blocksize_"
3263 #: ../disk-utils/fsck.cramfs.8.adoc:28
3265 "Use this blocksize, defaults to page size. Must be equal to what was set at "
3266 "creation time. Only used for *--extract*."
3269 #. type: Labeled list
3270 #: ../disk-utils/fsck.cramfs.8.adoc:29
3272 msgid "*--extract*[=_directory_]"
3276 #: ../disk-utils/fsck.cramfs.8.adoc:31
3278 "Test to uncompress the whole file system. Optionally extract contents of the "
3279 "_file_ to _directory_."
3282 #. type: Labeled list
3283 #: ../disk-utils/fsck.cramfs.8.adoc:32
3289 #: ../disk-utils/fsck.cramfs.8.adoc:34 ../disk-utils/fsck.cramfs.8.adoc:37
3290 #: ../disk-utils/mkfs.bfs.8.adoc:46 ../disk-utils/mkfs.bfs.8.adoc:49
3291 msgid "This option is silently ignored."
3294 #. type: Labeled list
3295 #: ../disk-utils/fsck.cramfs.8.adoc:35
3301 #: ../disk-utils/fsck.cramfs.8.adoc:40 ../disk-utils/fsck.minix.8.adoc:76
3302 #: ../disk-utils/isosize.8.adoc:33 ../disk-utils/mkfs.bfs.8.adoc:53
3303 #: ../disk-utils/mkfs.cramfs.8.adoc:75 ../disk-utils/mkfs.minix.8.adoc:75
3304 #: ../login-utils/chfn.1.adoc:72 ../login-utils/chsh.1.adoc:55
3305 #: ../login-utils/lslogins.1.adoc:107 ../login-utils/runuser.1.adoc:101
3306 #: ../login-utils/su.1.adoc:110 ../misc-utils/blkid.8.adoc:148
3307 #: ../misc-utils/enosys.1.adoc:41 ../misc-utils/exch.1.adoc:28
3308 #: ../misc-utils/fadvise.1.adoc:44 ../misc-utils/findfs.8.adoc:49
3309 #: ../misc-utils/findmnt.8.adoc:192 ../misc-utils/kill.1.adoc:85
3310 #: ../misc-utils/logger.1.adoc:186 ../misc-utils/lsblk.8.adoc:183
3311 #: ../misc-utils/rename.1.adoc:66 ../misc-utils/waitpid.1.adoc:40
3312 #: ../sys-utils/blkdiscard.8.adoc:57 ../sys-utils/chcpu.8.adoc:55
3313 #: ../sys-utils/chmem.8.adoc:54 ../sys-utils/dmesg.1.adoc:188
3314 #: ../sys-utils/eject.1.adoc:93 ../sys-utils/flock.1.adoc:88
3315 #: ../sys-utils/fstrim.8.adoc:74 ../sys-utils/hwclock.8.adoc:347
3316 #: ../sys-utils/losetup.8.adoc:123 ../sys-utils/lsipc.1.adoc:86
3317 #: ../sys-utils/lsns.8.adoc:75 ../sys-utils/mount.8.adoc:1587
3318 #: ../sys-utils/mountpoint.1.adoc:39 ../sys-utils/swapon.8.adoc:94
3319 #: ../sys-utils/switch_root.8.adoc:29 ../sys-utils/zramctl.8.adoc:74
3320 #: ../term-utils/mesg.1.adoc:76 ../text-utils/hexdump.1.adoc:224
3323 msgstr "NÁVRATOVÁ HODNOTA"
3326 #: ../disk-utils/fsck.cramfs.8.adoc:44 ../disk-utils/isosize.8.adoc:37
3327 #: ../disk-utils/mkfs.cramfs.8.adoc:79 ../misc-utils/exch.1.adoc:34
3328 #: ../misc-utils/fadvise.1.adoc:50 ../misc-utils/findfs.8.adoc:53
3329 #: ../misc-utils/kill.1.adoc:91 ../misc-utils/lsblk.8.adoc:187
3330 #: ../misc-utils/waitpid.1.adoc:46 ../sys-utils/blkdiscard.8.adoc:63
3331 #: ../sys-utils/chcpu.8.adoc:61 ../sys-utils/chmem.8.adoc:60
3332 #: ../sys-utils/fstrim.8.adoc:78 ../sys-utils/mount.8.adoc:1593
3333 #: ../sys-utils/swapon.8.adoc:100
3338 #: ../disk-utils/fsck.cramfs.8.adoc:46
3339 msgid "file system was left uncorrected"
3343 #: ../disk-utils/fsck.cramfs.8.adoc:48 ../disk-utils/mkfs.cramfs.8.adoc:81
3344 msgid "operation error, such as unable to allocate memory"
3348 #: ../disk-utils/fsck.cramfs.8.adoc:50
3349 msgid "usage information was printed"
3353 #: ../disk-utils/fsck.cramfs.8.adoc:55
3357 "*mkfs.cramfs*(8)\n"
3360 #. Copyright 1992, 1993, 1994 Rickard E. Faith (faith@cs.unc.edu)
3361 #. May be freely distributed.
3363 #: ../disk-utils/fsck.minix.8.adoc:6
3365 msgid "fsck.minix(8)"
3369 #: ../disk-utils/fsck.minix.8.adoc:16
3370 msgid "fsck.minix - check consistency of Minix filesystem"
3374 #: ../disk-utils/fsck.minix.8.adoc:20
3376 msgid "*fsck.minix* [options] _device_\n"
3380 #: ../disk-utils/fsck.minix.8.adoc:24
3382 msgid "*fsck.minix* performs a consistency check for the Linux MINIX filesystem.\n"
3386 #: ../disk-utils/fsck.minix.8.adoc:26
3388 "The program assumes the filesystem is quiescent. *fsck.minix* should not be "
3389 "used on a mounted device unless you can be sure nobody is writing to it. "
3390 "Remember that the kernel can write to device when it searches for files."
3394 #: ../disk-utils/fsck.minix.8.adoc:28
3395 msgid "The _device_ name will usually have the following form:"
3399 #: ../disk-utils/fsck.minix.8.adoc:36
3402 "|/dev/hda[1-63] |IDE disk 1\n"
3403 "|/dev/hdb[1-63] |IDE disk 2\n"
3404 "|/dev/sda[1-15] |SCSI disk 1\n"
3405 "|/dev/sdb[1-15] |SCSI disk 2\n"
3408 #. type: delimited block _
3409 #: ../disk-utils/fsck.minix.8.adoc:40
3411 "If the filesystem was changed, i.e., repaired, then *fsck.minix* will print "
3412 "\"FILE SYSTEM HAS BEEN CHANGED\" and will *sync*(2) three times before "
3413 "exiting. There is _no_ need to reboot after check."
3417 #: ../disk-utils/fsck.minix.8.adoc:41 ../disk-utils/mkswap.8.adoc:33
3418 #: ../misc-utils/rename.1.adoc:48
3423 #. type: delimited block _
3424 #: ../disk-utils/fsck.minix.8.adoc:44
3426 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"
3429 #. type: delimited block _
3430 #: ../disk-utils/fsck.minix.8.adoc:49
3431 msgid "List all filenames."
3434 #. type: Labeled list
3435 #: ../disk-utils/fsck.minix.8.adoc:50
3437 #| msgid "*-h*, *--help*"
3438 msgid "*-r*, *--repair*"
3439 msgstr "*-h*, *--help*"
3441 #. type: delimited block _
3442 #: ../disk-utils/fsck.minix.8.adoc:52
3443 msgid "Perform interactive repairs."
3446 #. type: Labeled list
3447 #: ../disk-utils/fsck.minix.8.adoc:53 ../sys-utils/rtcwake.8.adoc:36
3449 #| msgid "*-f*, *--fast*"
3450 msgid "*-a*, *--auto*"
3451 msgstr "*-f*, *--fast*"
3453 #. type: delimited block _
3454 #: ../disk-utils/fsck.minix.8.adoc:55
3456 "Perform automatic repairs. This option implies *--repair* and serves to "
3457 "answer all of the questions asked with the default. Note that this can be "
3458 "extremely dangerous in the case of extensive filesystem damage."
3461 #. type: Labeled list
3462 #: ../disk-utils/fsck.minix.8.adoc:59
3464 #| msgid "*-P*, *--pty*"
3465 msgid "*-s*, *--super*"
3466 msgstr "*-P*, *--pty*"
3468 #. type: delimited block _
3469 #: ../disk-utils/fsck.minix.8.adoc:61
3470 msgid "Output super-block information."
3473 #. type: Labeled list
3474 #: ../disk-utils/fsck.minix.8.adoc:62
3476 #| msgid "*-V*, *--version*"
3477 msgid "*-m*, *--uncleared*"
3478 msgstr "*-V*, *--version*"
3480 #. type: delimited block _
3481 #: ../disk-utils/fsck.minix.8.adoc:64
3482 msgid "Activate MINIX-like \"mode not cleared\" warnings."
3485 #. type: Labeled list
3486 #: ../disk-utils/fsck.minix.8.adoc:65 ../disk-utils/mkswap.8.adoc:49
3487 #: ../disk-utils/sfdisk.8.adoc:152 ../misc-utils/wipefs.8.adoc:46
3488 #: ../sys-utils/blkdiscard.8.adoc:31 ../sys-utils/blkzone.8.adoc:95
3489 #: ../sys-utils/umount.8.adoc:73
3491 #| msgid "*-f*, *--fast*"
3492 msgid "*-f*, *--force*"
3493 msgstr "*-f*, *--fast*"
3495 #. type: delimited block _
3496 #: ../disk-utils/fsck.minix.8.adoc:67
3498 "Force a filesystem check even if the filesystem was marked as valid. Marking "
3499 "is done by the kernel when the filesystem is unmounted."
3503 #: ../disk-utils/fsck.minix.8.adoc:70 ../term-utils/agetty.8.adoc:338
3508 #. type: delimited block _
3509 #: ../disk-utils/fsck.minix.8.adoc:73
3511 "There are numerous diagnostic messages. The ones mentioned here are the most "
3512 "commonly seen in normal usage."
3515 #. type: delimited block _
3516 #: ../disk-utils/fsck.minix.8.adoc:75
3518 "If the device does not exist, *fsck.minix* will print \"unable to read super "
3519 "block\". If the device exists, but is not a MINIX filesystem, *fsck.minix* "
3520 "will print \"bad magic number in super-block\"."
3523 #. type: delimited block _
3524 #: ../disk-utils/fsck.minix.8.adoc:79
3525 msgid "The exit status returned by *fsck.minix* is the sum of the following:"
3528 #. type: Labeled list
3529 #: ../disk-utils/fsck.minix.8.adoc:82 ../misc-utils/waitpid.1.adoc:50
3534 #. type: delimited block _
3535 #: ../disk-utils/fsck.minix.8.adoc:84
3537 "Filesystem errors corrected, system should be rebooted if filesystem was "
3541 #. type: Labeled list
3542 #: ../disk-utils/fsck.minix.8.adoc:86
3547 #. type: delimited block _
3548 #: ../disk-utils/fsck.minix.8.adoc:88
3549 msgid "Combination of exit statuses 3 and 4"
3552 #. type: delimited block _
3553 #: ../disk-utils/fsck.minix.8.adoc:97
3555 "mailto:torvalds@cs.helsinki.fi[Linus Torvalds]. Exit status values by mailto:"
3556 "faith@cs.unc.edu[Rik Faith] Added support for filesystem valid flag: mailto:"
3557 "greg%wind.uucp@plains.nodak.edu[Dr. Wettstein]. Check to prevent fsck of "
3558 "mounted filesystem added by mailto:quinlan@yggdrasil.com[Daniel Quinlan]. "
3559 "Minix v2 fs support by mailto:schwab@issan.informatik.uni-dortmund."
3560 "de[Andreas Schwab], updated by mailto:janl@math.uio.no[Nicolai Langfeldt]. "
3561 "Portability patch by mailto:rmk@ecs.soton.ac.uk[Russell King]."
3564 #. type: delimited block _
3565 #: ../disk-utils/fsck.minix.8.adoc:106
3572 "*mkfs.minix*(8),\n"
3577 #: ../disk-utils/isosize.8.adoc:2
3583 #: ../disk-utils/isosize.8.adoc:12
3584 msgid "isosize - output the length of an iso9660 filesystem"
3588 #: ../disk-utils/isosize.8.adoc:16
3590 msgid "*isosize* [options] _iso9660_image_file_\n"
3594 #: ../disk-utils/isosize.8.adoc:20
3596 "This command outputs the length of an iso9660 filesystem that is contained "
3597 "in the specified file. This file may be a normal file or a block device (e."
3598 "g. _/dev/hdd_ or _/dev/sr0_). In the absence of any options (and errors), it "
3599 "will output the size of the iso9660 filesystem in bytes. This can now be a "
3600 "large number (>> 4 GB)."
3603 #. type: Labeled list
3604 #: ../disk-utils/isosize.8.adoc:23
3606 #| msgid "*-f*, *--fast*"
3607 msgid "*-x*, *--sectors*"
3608 msgstr "*-f*, *--fast*"
3611 #: ../disk-utils/isosize.8.adoc:25
3613 "Show the block count and block size in human-readable form. The output uses "
3614 "the term \"sectors\" for \"blocks\"."
3617 #. type: Labeled list
3618 #: ../disk-utils/isosize.8.adoc:26 ../term-utils/scriptlive.1.adoc:42
3619 #: ../term-utils/scriptreplay.1.adoc:53
3621 msgid "*-d*, *--divisor* _number_"
3625 #: ../disk-utils/isosize.8.adoc:28
3627 "Only has an effect when *-x* is not given. The value shown (if no errors) is "
3628 "the iso9660 file size in bytes divided by _number_. So if _number_ is the "
3629 "block size then the shown value will be the block count."
3633 #: ../disk-utils/isosize.8.adoc:30
3635 "The size of the file (or block device) holding an iso9660 filesystem can be "
3636 "marginally larger than the actual size of the iso9660 filesystem. One reason "
3637 "for this is that cd writers are allowed to add \"run out\" sectors at the "
3638 "end of an iso9660 image."
3642 #: ../disk-utils/isosize.8.adoc:39
3643 msgid "generic failure, such as invalid usage"
3647 #: ../disk-utils/isosize.8.adoc:41 ../sys-utils/fstrim.8.adoc:82
3651 #. type: Labeled list
3652 #: ../disk-utils/isosize.8.adoc:41 ../misc-utils/kill.1.adoc:93
3653 #: ../misc-utils/rename.1.adoc:80 ../sys-utils/chcpu.8.adoc:65
3654 #: ../sys-utils/chmem.8.adoc:64 ../sys-utils/mount.8.adoc:1612
3655 #: ../sys-utils/swapon.8.adoc:116
3661 #: ../disk-utils/isosize.8.adoc:43
3666 #: ../disk-utils/mkfs.8.adoc:2
3672 #: ../disk-utils/mkfs.8.adoc:12
3673 msgid "mkfs - build a Linux filesystem"
3677 #: ../disk-utils/mkfs.8.adoc:16
3679 msgid "*mkfs* [options] [*-t* _type_] [_fs-options_] _device_ [_size_]\n"
3683 #: ../disk-utils/mkfs.8.adoc:20
3685 msgid "*This mkfs frontend is deprecated in favour of filesystem specific mkfs.<type> utils.*\n"
3689 #: ../disk-utils/mkfs.8.adoc:22
3691 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"
3695 #: ../disk-utils/mkfs.8.adoc:24
3696 msgid "The exit status returned by *mkfs* is 0 on success and 1 on failure."
3700 #: ../disk-utils/mkfs.8.adoc:26
3702 "In actuality, *mkfs* is simply a front-end for the various filesystem "
3703 "builders (**mkfs.**__fstype__) available under Linux. The filesystem-"
3704 "specific builder is searched for via your *PATH* environment setting only. "
3705 "Please see the filesystem-specific builder manual pages for further details."
3709 #: ../disk-utils/mkfs.8.adoc:31
3711 "Specify the _type_ of filesystem to be built. If not specified, the default "
3712 "filesystem type (currently ext2) is used."
3715 #. type: Labeled list
3716 #: ../disk-utils/mkfs.8.adoc:32
3718 msgid "_fs-options_"
3722 #: ../disk-utils/mkfs.8.adoc:34
3724 "Filesystem-specific options to be passed to the real filesystem builder."
3727 #. type: Labeled list
3728 #: ../disk-utils/mkfs.8.adoc:35
3730 #| msgid "*-V*, *--version*"
3731 msgid "*-V*, *--verbose*"
3732 msgstr "*-V*, *--version*"
3735 #: ../disk-utils/mkfs.8.adoc:37
3737 "Produce verbose output, including all filesystem-specific commands that are "
3738 "executed. Specifying this option more than once inhibits execution of any "
3739 "filesystem-specific commands. This is really only useful for testing."
3743 #: ../disk-utils/mkfs.8.adoc:40
3745 "(Option *-V* will display version information only when it is the only "
3746 "parameter, otherwise it will work as *--verbose*.)"
3750 #: ../disk-utils/mkfs.8.adoc:41 ../disk-utils/raw.8.adoc:51
3751 #: ../login-utils/login.1.adoc:159 ../login-utils/utmpdump.1.adoc:67
3752 #: ../misc-utils/cal.1.adoc:177 ../misc-utils/getopt.1.adoc:141
3753 #: ../misc-utils/hardlink.1.adoc:138 ../misc-utils/mcookie.1.adoc:50
3754 #: ../misc-utils/namei.1.adoc:65 ../misc-utils/pipesz.1.adoc:91
3755 #: ../sys-utils/lscpu.1.adoc:95 ../sys-utils/mount.8.adoc:1670
3756 #: ../sys-utils/readprofile.8.adoc:67 ../term-utils/agetty.8.adoc:330
3757 #: ../term-utils/script.1.adoc:155 ../term-utils/setterm.1.adoc:163
3758 #: ../text-utils/colcrt.1.adoc:70 ../text-utils/column.1.adoc:185
3759 #: ../text-utils/ul.1.adoc:76
3765 #: ../disk-utils/mkfs.8.adoc:44
3767 "All generic options must precede and not be combined with filesystem-"
3768 "specific options. Some filesystem-specific programs do not automatically "
3769 "detect the device size and require the _size_ parameter to be specified."
3773 #: ../disk-utils/mkfs.8.adoc:50
3775 "mailto:david@ods.com[David Engel], mailto:waltje@uwalt.nl.mugnet.org[Fred N. "
3776 "van Kempen], mailto:sommel@sci.kun.nl[Ron Sommeling]."
3780 #: ../disk-utils/mkfs.8.adoc:52
3782 "The manual page was shamelessly adapted from Remy Card's version for the "
3787 #: ../disk-utils/mkfs.8.adoc:68
3799 "*mkfs.minix*(8),\n"
3800 "*mkfs.msdos*(8),\n"
3805 #. Copyright 1999 Andries E. Brouwer (aeb@cwi.nl)
3806 #. May be freely distributed.
3808 #: ../disk-utils/mkfs.bfs.8.adoc:6
3814 #: ../disk-utils/mkfs.bfs.8.adoc:16
3815 msgid "mkfs.bfs - make an SCO bfs filesystem"
3819 #: ../disk-utils/mkfs.bfs.8.adoc:20
3821 msgid "*mkfs.bfs* [options] _device_ [_block-count_]\n"
3825 #: ../disk-utils/mkfs.bfs.8.adoc:24
3827 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"
3831 #: ../disk-utils/mkfs.bfs.8.adoc:26
3833 "The _block-count_ parameter is the desired size of the filesystem, in "
3834 "blocks. If nothing is specified, the entire partition will be used."
3837 #. type: Labeled list
3838 #: ../disk-utils/mkfs.bfs.8.adoc:29
3840 msgid "*-N*, *--inodes* _number_"
3844 #: ../disk-utils/mkfs.bfs.8.adoc:31
3846 "Specify the desired _number_ of inodes (at most 512). If nothing is "
3847 "specified, some default number in the range 48-512 is picked depending on "
3848 "the size of the partition."
3851 #. type: Labeled list
3852 #: ../disk-utils/mkfs.bfs.8.adoc:32
3854 #| msgid "*-V*, *--version*"
3855 msgid "*-V*, *--vname* _label_"
3856 msgstr "*-V*, *--version*"
3859 #: ../disk-utils/mkfs.bfs.8.adoc:34
3860 msgid "Specify the volume _label_. I have no idea if/where this is used."
3863 #. type: Labeled list
3864 #: ../disk-utils/mkfs.bfs.8.adoc:35
3866 #| msgid "*-f*, *--fast*"
3867 msgid "*-F*, *--fname* _name_"
3868 msgstr "*-f*, *--fast*"
3871 #: ../disk-utils/mkfs.bfs.8.adoc:37
3872 msgid "Specify the filesystem _name_. I have no idea if/where this is used."
3876 #: ../disk-utils/mkfs.bfs.8.adoc:43 ../term-utils/mesg.1.adoc:73
3877 msgid "Explain what is being done."
3880 #. type: Labeled list
3881 #: ../disk-utils/mkfs.bfs.8.adoc:44 ../text-utils/pg.1.adoc:39
3887 #: ../disk-utils/mkfs.bfs.8.adoc:52
3888 msgid "Option *-V* only works as *--version* when it is the only option."
3892 #: ../disk-utils/mkfs.bfs.8.adoc:56
3894 "The exit status returned by *mkfs.bfs* is 0 when all went well, and 1 when "
3895 "something went wrong."
3899 #: ../disk-utils/mkfs.bfs.8.adoc:60
3905 #: ../disk-utils/mkfs.cramfs.8.adoc:2
3907 msgid "mkfs.cramfs(8)"
3911 #: ../disk-utils/mkfs.cramfs.8.adoc:12
3912 msgid "mkfs.cramfs - make compressed ROM file system"
3916 #: ../disk-utils/mkfs.cramfs.8.adoc:16
3918 msgid "*mkfs.cramfs* [options] _directory file_\n"
3922 #: ../disk-utils/mkfs.cramfs.8.adoc:20
3924 "Files on cramfs file systems are zlib-compressed one page at a time to allow "
3925 "random read access. The metadata is not compressed, but is expressed in a "
3926 "terse representation that is more space-efficient than conventional file "
3931 #: ../disk-utils/mkfs.cramfs.8.adoc:22
3933 "The file system is intentionally read-only to simplify its design; random "
3934 "write access for compressed files is difficult to implement. cramfs ships "
3935 "with a utility (*mkcramfs*(8)) to pack files into new cramfs images."
3939 #: ../disk-utils/mkfs.cramfs.8.adoc:24
3940 msgid "File sizes are limited to less than 16 MB."
3944 #: ../disk-utils/mkfs.cramfs.8.adoc:26
3946 "Maximum file system size is a little under 272 MB. (The last file on the "
3947 "file system must begin before the 256 MB block, but can extend past it.)"
3951 #: ../disk-utils/mkfs.cramfs.8.adoc:27 ../misc-utils/hardlink.1.adoc:134
3952 #: ../misc-utils/kill.1.adoc:35 ../term-utils/agetty.8.adoc:35
3953 #: ../term-utils/mesg.1.adoc:59
3959 #: ../disk-utils/mkfs.cramfs.8.adoc:30
3961 "The _directory_ is simply the root of the directory tree that we want to "
3962 "generate a compressed filesystem out of."
3966 #: ../disk-utils/mkfs.cramfs.8.adoc:32
3968 "The _file_ will contain the cram file system, which later can be mounted."
3971 #. type: Labeled list
3972 #: ../disk-utils/mkfs.cramfs.8.adoc:38
3978 #: ../disk-utils/mkfs.cramfs.8.adoc:40
3980 "Treat all warnings as errors, which are reflected as command exit status."
3983 #. type: Labeled list
3984 #: ../disk-utils/mkfs.cramfs.8.adoc:41
3986 msgid "*-b* _blocksize_"
3990 #: ../disk-utils/mkfs.cramfs.8.adoc:43
3991 msgid "Use defined block size, which has to be divisible by page size."
3994 #. type: Labeled list
3995 #: ../disk-utils/mkfs.cramfs.8.adoc:44
3997 msgid "*-e* _edition_"
4001 #: ../disk-utils/mkfs.cramfs.8.adoc:46
4002 msgid "Use defined file system edition number in superblock."
4005 #. type: Labeled list
4006 #: ../disk-utils/mkfs.cramfs.8.adoc:47
4008 msgid "*-N* _big, little, host_"
4012 #: ../disk-utils/mkfs.cramfs.8.adoc:49
4013 msgid "Use defined endianness. Value defaults to _host_."
4016 #. type: Labeled list
4017 #: ../disk-utils/mkfs.cramfs.8.adoc:50
4023 #: ../disk-utils/mkfs.cramfs.8.adoc:52
4024 msgid "Insert a _file_ to cramfs file system."
4027 #. type: Labeled list
4028 #: ../disk-utils/mkfs.cramfs.8.adoc:53
4034 #: ../disk-utils/mkfs.cramfs.8.adoc:55
4035 msgid "Set name of the cramfs file system."
4038 #. type: Labeled list
4039 #: ../disk-utils/mkfs.cramfs.8.adoc:56 ../login-utils/login.1.adoc:41
4045 #: ../disk-utils/mkfs.cramfs.8.adoc:58
4046 msgid "Pad by 512 bytes for boot code."
4050 #: ../disk-utils/mkfs.cramfs.8.adoc:61
4052 "This option is ignored. Originally the *-s* turned on directory entry "
4056 #. type: Labeled list
4057 #: ../disk-utils/mkfs.cramfs.8.adoc:62
4063 #: ../disk-utils/mkfs.cramfs.8.adoc:64
4064 msgid "Make explicit holes."
4067 #. type: Labeled list
4068 #: ../disk-utils/mkfs.cramfs.8.adoc:65
4070 msgid "*-l*[=_mode_]"
4074 #: ../disk-utils/mkfs.cramfs.8.adoc:72
4076 "Use exclusive BSD lock for device or file it operates. The optional "
4077 "argument _mode_ can be _yes_, _no_ (or 1 and 0) or _nonblock_. If the "
4078 "_mode_ argument is omitted, it defaults to _\"yes\"_. This option "
4079 "overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to "
4080 "use any lock at all, but it's recommended to avoid collisions with udevd or "
4085 #: ../disk-utils/mkfs.cramfs.8.adoc:86
4088 "*fsck.cramfs*(8),\n"
4092 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
4093 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4094 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
4095 #. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
4096 #. May be distributed under the GNU General Public License
4098 #: ../disk-utils/mkfs.minix.8.adoc:9
4100 msgid "mkfs.minix(8)"
4104 #: ../disk-utils/mkfs.minix.8.adoc:19
4105 msgid "mkfs.minix - make a Minix filesystem"
4109 #: ../disk-utils/mkfs.minix.8.adoc:23
4111 msgid "*mkfs.minix* [options] _device_ [_size-in-blocks_]\n"
4115 #: ../disk-utils/mkfs.minix.8.adoc:27
4117 msgid "*mkfs.minix* creates a Linux MINIX filesystem on a device (usually a disk partition).\n"
4121 #: ../disk-utils/mkfs.minix.8.adoc:29
4122 msgid "The _device_ is usually of the following form:"
4125 #. type: delimited block .
4126 #: ../disk-utils/mkfs.minix.8.adoc:35
4129 "/dev/hda[1-8] (IDE disk 1)\n"
4130 "/dev/hdb[1-8] (IDE disk 2)\n"
4131 "/dev/sda[1-8] (SCSI disk 1)\n"
4132 "/dev/sdb[1-8] (SCSI disk 2)\n"
4136 #: ../disk-utils/mkfs.minix.8.adoc:38
4138 "The device may be a block device or an image file of one, but this is not "
4139 "enforced. Expect not much fun on a character device :-)."
4143 #: ../disk-utils/mkfs.minix.8.adoc:40
4145 "The _size-in-blocks_ parameter is the desired size of the file system, in "
4146 "blocks. It is present only for backwards compatibility. If omitted the size "
4147 "will be determined automatically. Only block counts strictly greater than 10 "
4148 "and strictly less than 65536 are allowed."
4151 #. type: Labeled list
4152 #: ../disk-utils/mkfs.minix.8.adoc:43 ../disk-utils/mkswap.8.adoc:43
4153 #: ../misc-utils/pipesz.1.adoc:58
4155 #| msgid "*-h*, *--help*"
4156 msgid "*-c*, *--check*"
4157 msgstr "*-h*, *--help*"
4160 #: ../disk-utils/mkfs.minix.8.adoc:45
4162 "Check the device for bad blocks before creating the filesystem. If any are "
4163 "found, the count is printed."
4166 #. type: Labeled list
4167 #: ../disk-utils/mkfs.minix.8.adoc:46
4169 msgid "*-n*, *--namelength* _length_"
4173 #: ../disk-utils/mkfs.minix.8.adoc:48
4175 "Specify the maximum length of filenames. Currently, the only allowable "
4176 "values are 14 and 30 for file system versions 1 and 2. Version 3 allows only "
4177 "value 60. The default is 30."
4180 #. type: Labeled list
4181 #: ../disk-utils/mkfs.minix.8.adoc:52
4183 msgid "*-i*, *--inodes* _number_"
4187 #: ../disk-utils/mkfs.minix.8.adoc:54
4188 msgid "Specify the number of inodes for the filesystem."
4191 #. type: Labeled list
4192 #: ../disk-utils/mkfs.minix.8.adoc:55
4194 msgid "*-l*, *--badblocks* _filename_"
4198 #: ../disk-utils/mkfs.minix.8.adoc:57
4200 "Read the list of bad blocks from _filename_. The file has one bad-block "
4201 "number per line. The count of bad blocks read is printed."
4204 #. type: Labeled list
4205 #: ../disk-utils/mkfs.minix.8.adoc:58 ../misc-utils/kill.1.adoc:45
4211 #: ../disk-utils/mkfs.minix.8.adoc:60
4212 msgid "Make a Minix version 1 filesystem. This is the default."
4215 #. type: Labeled list
4216 #: ../disk-utils/mkfs.minix.8.adoc:61
4218 #| msgid "*-P*, *--pty*"
4220 msgstr "*-P*, *--pty*"
4223 #: ../disk-utils/mkfs.minix.8.adoc:63
4224 msgid "Make a Minix version 2 filesystem."
4227 #. type: Labeled list
4228 #: ../disk-utils/mkfs.minix.8.adoc:64
4234 #: ../disk-utils/mkfs.minix.8.adoc:66
4235 msgid "Make a Minix version 3 filesystem."
4239 #: ../disk-utils/mkfs.minix.8.adoc:69
4240 msgid "The long option cannot be combined with other options."
4243 #. type: Labeled list
4244 #: ../disk-utils/mkfs.minix.8.adoc:72 ../disk-utils/mkswap.8.adoc:100
4245 #: ../misc-utils/wipefs.8.adoc:85
4247 msgid "LOCK_BLOCK_DEVICE=<mode>"
4251 #: ../disk-utils/mkfs.minix.8.adoc:78
4252 msgid "The exit status returned by *mkfs.minix* is one of the following:"
4255 #. type: Labeled list
4256 #: ../disk-utils/mkfs.minix.8.adoc:79 ../login-utils/lslogins.1.adoc:109
4257 #: ../misc-utils/lsblk.8.adoc:185 ../sys-utils/fstrim.8.adoc:76
4258 #: ../sys-utils/lsipc.1.adoc:88
4263 #. type: Labeled list
4264 #: ../disk-utils/mkfs.minix.8.adoc:81
4269 #. type: Labeled list
4270 #: ../disk-utils/mkfs.minix.8.adoc:83
4277 #: ../disk-utils/mkfs.minix.8.adoc:91
4292 #. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4293 #. May be distributed under the GNU General Public License
4295 #: ../disk-utils/mkswap.8.adoc:6
4301 #: ../disk-utils/mkswap.8.adoc:16
4302 msgid "mkswap - set up a Linux swap area"
4306 #: ../disk-utils/mkswap.8.adoc:20
4308 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
4309 msgid "*mkswap* [options] _device_ [_blocks_]\n"
4310 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
4313 #: ../disk-utils/mkswap.8.adoc:22
4315 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
4316 msgid "*mkswap* [options] --size _size_ --file _file_\n"
4317 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
4320 #: ../disk-utils/mkswap.8.adoc:26
4322 msgid "*mkswap* sets up a Linux swap area on a device or in a file.\n"
4326 #: ../disk-utils/mkswap.8.adoc:28
4328 "The _device_ argument will usually be a disk partition (something like _/dev/"
4329 "sdb7_) but can also be a file. The Linux kernel does not look at partition "
4330 "IDs, but many installation scripts will assume that partitions of hex type "
4331 "82 (LINUX_SWAP) are meant to be swap partitions. (*Warning: Solaris also "
4332 "uses this type. Be careful not to kill your Solaris partitions.*)"
4336 #: ../disk-utils/mkswap.8.adoc:30
4338 "The _blocks_ parameter is superfluous but retained for backwards "
4339 "compatibility. (It specifies the desired size of the swap area in 1024-byte "
4340 "blocks. *mkswap* will use the entire partition or file if it is omitted. "
4341 "Specifying it is unwise - a typo may destroy your disk.)"
4345 #: ../disk-utils/mkswap.8.adoc:32
4347 "After creating the swap area, you need the *swapon*(8) command to start "
4348 "using it. Usually swap areas are listed in _/etc/fstab_ so that they can be "
4349 "taken into use at boot time by a *swapon -a* command in some boot script."
4353 #: ../disk-utils/mkswap.8.adoc:36
4355 "The swap header does not touch the first block. A boot loader or disk label "
4356 "can be there, but it is not a recommended setup. The recommended setup is to "
4357 "use a separate partition for a Linux swap area."
4361 #: ../disk-utils/mkswap.8.adoc:38
4363 msgid "*mkswap*, like many others mkfs-like utils, *erases the first partition block to make any previous filesystem invisible.*\n"
4367 #: ../disk-utils/mkswap.8.adoc:40
4369 "However, *mkswap* refuses to erase the first block on a device with a disk "
4370 "label (SUN, BSD, ...)."
4374 #: ../disk-utils/mkswap.8.adoc:45
4376 "Check the device (if it is a block device) for bad blocks before creating "
4377 "the swap area. If any bad blocks are found, the count is printed."
4380 #. type: Labeled list
4381 #: ../disk-utils/mkswap.8.adoc:46
4383 #| msgid "*-f*, *--fast*"
4384 msgid "*-F*, *--file*"
4385 msgstr "*-f*, *--fast*"
4388 #: ../disk-utils/mkswap.8.adoc:48
4390 "Create a swap file with the appropriate file permissions and populated "
4395 #: ../disk-utils/mkswap.8.adoc:51
4397 "Go ahead even if the command is stupid. This allows the creation of a swap "
4398 "area larger than the file or partition it resides on."
4402 #: ../disk-utils/mkswap.8.adoc:53
4404 "Also, without this option, *mkswap* will refuse to erase the first block on "
4405 "a device with a partition table."
4408 #. type: Labeled list
4409 #: ../disk-utils/mkswap.8.adoc:54 ../disk-utils/sfdisk.8.adoc:201
4410 #: ../misc-utils/getopt.1.adoc:47 ../misc-utils/hardlink.1.adoc:84
4411 #: ../misc-utils/pipesz.1.adoc:61 ../misc-utils/uuidd.8.adoc:53
4412 #: ../misc-utils/wipefs.8.adoc:72 ../sys-utils/blkdiscard.8.adoc:43
4413 #: ../sys-utils/mountpoint.1.adoc:28 ../sys-utils/umount.8.adoc:99
4414 #: ../term-utils/script.1.adoc:115
4416 #| msgid "*-P*, *--pty*"
4417 msgid "*-q*, *--quiet*"
4418 msgstr "*-P*, *--pty*"
4421 #: ../disk-utils/mkswap.8.adoc:56
4422 msgid "Suppress output and warning messages."
4425 #. type: Labeled list
4426 #: ../disk-utils/mkswap.8.adoc:57 ../disk-utils/swaplabel.8.adoc:33
4427 #: ../misc-utils/blkid.8.adoc:74 ../sys-utils/mount.8.adoc:341
4429 #| msgid "*-s*, **--shell**=__shell__"
4430 msgid "*-L*, *--label* _label_"
4431 msgstr "*-s*, **--shell**=__shell__"
4434 #: ../disk-utils/mkswap.8.adoc:59
4435 msgid "Specify a _label_ for the device, to allow *swapon*(8) by label."
4438 #. type: Labeled list
4439 #: ../disk-utils/mkswap.8.adoc:63
4441 msgid "*-p*, *--pagesize* _size_"
4445 #: ../disk-utils/mkswap.8.adoc:65
4447 "Specify the page _size_ (in bytes) to use. This option is usually "
4448 "unnecessary; *mkswap* reads the size from the kernel."
4451 #. type: Labeled list
4452 #: ../disk-utils/mkswap.8.adoc:66 ../disk-utils/swaplabel.8.adoc:36
4454 msgid "*-U*, *--uuid* _UUID_"
4458 #: ../disk-utils/mkswap.8.adoc:70
4460 "Specify the _UUID_ to use. The default is to generate a UUID. The format of "
4461 "the UUID is a series of hex digits separated by hyphens, like this: "
4462 "\"c1b9d5a2-f162-11cf-9ece-0020afc76f16\". The UUID parameter may also be one "
4466 #. type: Labeled list
4467 #: ../disk-utils/mkswap.8.adoc:71
4473 #: ../disk-utils/mkswap.8.adoc:73
4474 msgid "clear the filesystem UUID"
4477 #. type: Labeled list
4478 #: ../disk-utils/mkswap.8.adoc:73
4484 #: ../disk-utils/mkswap.8.adoc:75
4485 msgid "generate a new randomly-generated UUID"
4488 #. type: Labeled list
4489 #: ../disk-utils/mkswap.8.adoc:75 ../sys-utils/dmesg.1.adoc:167
4495 #: ../disk-utils/mkswap.8.adoc:77
4496 msgid "generate a new time-based UUID"
4499 #. type: Labeled list
4500 #: ../disk-utils/mkswap.8.adoc:78
4502 msgid "*-e*, *--endianness* _ENDIANNESS_"
4506 #: ../disk-utils/mkswap.8.adoc:80
4508 "Specify the _ENDIANNESS_ to use, valid arguments are *native*, *little* or "
4509 "*big*. The default is *native*."
4512 #. type: Labeled list
4513 #: ../disk-utils/mkswap.8.adoc:81 ../misc-utils/fadvise.1.adoc:34
4514 #: ../misc-utils/wipefs.8.adoc:64 ../sys-utils/blkdiscard.8.adoc:34
4515 #: ../sys-utils/fallocate.1.adoc:56 ../sys-utils/losetup.8.adoc:74
4517 #| msgid "*-f*, *--fast*"
4518 msgid "*-o*, *--offset* _offset_"
4519 msgstr "*-f*, *--fast*"
4522 #: ../disk-utils/mkswap.8.adoc:83
4523 msgid "Specify the _offset_ to write the swap area to."
4526 #. type: Labeled list
4527 #: ../disk-utils/mkswap.8.adoc:84 ../sys-utils/zramctl.8.adoc:64
4529 #| msgid "*-s*, **--shell**=__shell__"
4530 msgid "*-s*, *--size* _size_"
4531 msgstr "*-s*, **--shell**=__shell__"
4534 #: ../disk-utils/mkswap.8.adoc:86
4536 "Specify the size of the created swap file in bytes and may be followed by a "
4537 "multiplicative suffix: KiB (=1024), MiB (=1024*1024), and so on for GiB, "
4538 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
4539 "meaning as \"KiB\"). If the file exists and is larger than _size_, it will "
4540 "be truncated to this size. This option only makes sense when used with *--"
4544 #. type: Labeled list
4545 #: ../disk-utils/mkswap.8.adoc:87
4547 #| msgid "*-V*, *--version*"
4548 msgid "*-v*, *--swapversion 1*"
4549 msgstr "*-V*, *--version*"
4552 #: ../disk-utils/mkswap.8.adoc:89
4554 "Specify the swap-space version. (This option is currently pointless, as the "
4555 "old *-v 0* option has become obsolete and now only *-v 1* is supported. The "
4556 "kernel has not supported v0 swap-space format since 2.5.22 (June 2002). The "
4557 "new version v1 is supported since 2.1.117 (August 1998).)"
4560 #. type: Labeled list
4561 #: ../disk-utils/mkswap.8.adoc:90 ../misc-utils/findmnt.8.adoc:181
4562 #: ../misc-utils/kill.1.adoc:67 ../sys-utils/flock.1.adoc:83
4563 #: ../sys-utils/prlimit.1.adoc:55
4569 #: ../disk-utils/mkswap.8.adoc:92
4571 "Verbose execution. With this option *mkswap* will output more details about "
4572 "detected problems during swap area set up."
4575 #. type: Labeled list
4576 #: ../disk-utils/mkswap.8.adoc:97 ../disk-utils/partx.8.adoc:103
4577 #: ../disk-utils/swaplabel.8.adoc:41 ../misc-utils/findfs.8.adoc:60
4578 #: ../misc-utils/wipefs.8.adoc:82
4580 msgid "LIBBLKID_DEBUG=all"
4584 #: ../disk-utils/mkswap.8.adoc:106
4586 "The maximum useful size of a swap area depends on the architecture and the "
4591 #: ../disk-utils/mkswap.8.adoc:108
4593 "The maximum number of the pages that is possible to address by swap area "
4594 "header is 4294967295 (32-bit unsigned int). The remaining space on the swap "
4595 "device is ignored."
4599 #: ../disk-utils/mkswap.8.adoc:110
4601 "Presently, Linux allows 32 swap areas. The areas in use can be seen in the "
4602 "file _/proc/swaps_."
4606 #: ../disk-utils/mkswap.8.adoc:112
4608 msgid "*mkswap* refuses areas smaller than 10 pages.\n"
4612 #: ../disk-utils/mkswap.8.adoc:114
4614 "If you don't know the page size that your machine uses, you can look it up "
4615 "with *getconf PAGESIZE*."
4619 #: ../disk-utils/mkswap.8.adoc:116
4621 "To set up a swap file, it is necessary to create that file before "
4622 "initializing it with *mkswap*, e.g. using a command like"
4625 #. type: delimited block .
4626 #: ../disk-utils/mkswap.8.adoc:119
4628 msgid "# dd if=/dev/zero of=swapfile bs=1MiB count=$((8*1024))\n"
4632 #: ../disk-utils/mkswap.8.adoc:122
4633 msgid "to create 8GiB swapfile."
4637 #: ../disk-utils/mkswap.8.adoc:124
4639 "Please read notes from *swapon*(8) about *the swap file use restrictions* "
4640 "(holes, preallocation and copy-on-write issues)."
4644 #: ../disk-utils/mkswap.8.adoc:129
4651 #. partx.8 -- man page for partx
4652 #. Copyright 2007 Karel Zak <kzak@redhat.com>
4653 #. Copyright 2007 Red Hat, Inc.
4654 #. Copyright 2010 Davidlohr Bueso <dave@gnu.org>
4655 #. May be distributed under the GNU General Public License
4657 #: ../disk-utils/partx.8.adoc:9
4663 #: ../disk-utils/partx.8.adoc:19
4665 "partx - tell the kernel about the presence and numbering of on-disk "
4670 #: ../disk-utils/partx.8.adoc:23
4672 msgid "*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] [*-n* _M_:_N_] [-] _disk_\n"
4676 #: ../disk-utils/partx.8.adoc:25
4678 msgid "*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] _partition_ [_disk_]\n"
4682 #: ../disk-utils/partx.8.adoc:29
4684 "Given a device or disk-image, *partx* tries to parse the partition table and "
4685 "list its contents. It can also tell the kernel to add or remove partitions "
4686 "from its bookkeeping."
4690 #: ../disk-utils/partx.8.adoc:31
4692 "The _disk_ argument is optional when a _partition_ argument is provided. To "
4693 "force scanning a partition as if it were a whole disk (for example to list "
4694 "nested subpartitions), use the argument \"-\" (hyphen-minus). For example:"
4697 #. type: delimited block _
4698 #: ../disk-utils/partx.8.adoc:34
4699 msgid "partx --show - /dev/sda3"
4703 #: ../disk-utils/partx.8.adoc:37
4704 msgid "This will see sda3 as a whole-disk rather than as a partition."
4708 #: ../disk-utils/partx.8.adoc:39
4710 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"
4713 #. type: Labeled list
4714 #: ../disk-utils/partx.8.adoc:42
4716 #| msgid "*-f*, *--fast*"
4717 msgid "*-a*, *--add*"
4718 msgstr "*-f*, *--fast*"
4721 #: ../disk-utils/partx.8.adoc:44
4722 msgid "Add the specified partitions, or read the disk and add all partitions."
4725 #. type: Labeled list
4726 #: ../disk-utils/partx.8.adoc:45 ../misc-utils/fincore.1.adoc:34
4727 #: ../misc-utils/findmnt.8.adoc:42 ../misc-utils/lsblk.8.adoc:41
4728 #: ../misc-utils/lslocks.8.adoc:34 ../sys-utils/ipcs.1.adoc:69
4729 #: ../sys-utils/lsipc.1.adoc:68 ../sys-utils/lsmem.1.adoc:36
4731 #| msgid "*-P*, *--pty*"
4732 msgid "*-b*, *--bytes*"
4733 msgstr "*-P*, *--pty*"
4735 #. type: Labeled list
4736 #: ../disk-utils/partx.8.adoc:48
4738 #| msgid "*-h*, *--help*"
4739 msgid "*-d*, *--delete*"
4740 msgstr "*-h*, *--help*"
4743 #: ../disk-utils/partx.8.adoc:50
4745 "Delete the specified partitions or all partitions. It is not error to remove "
4746 "non-existing partitions, so this option is possible to use together with "
4747 "large *--nr* ranges without care about the current partitions set on the "
4751 #. type: Labeled list
4752 #: ../disk-utils/partx.8.adoc:51
4754 #| msgid "*-V*, *--version*"
4755 msgid "*-g*, *--noheadings*"
4756 msgstr "*-V*, *--version*"
4759 #: ../disk-utils/partx.8.adoc:53
4760 msgid "Do not print a header line with *--show* or *--raw*."
4764 #: ../disk-utils/partx.8.adoc:56
4766 "List the partitions. Note that all numbers are in 512-byte sectors. This "
4767 "output format is DEPRECATED in favour of *--show*. Do not use it in newly "
4771 #. type: Labeled list
4772 #: ../disk-utils/partx.8.adoc:57
4774 msgid "*-n*, *--nr* __M__**:**_N_"
4778 #: ../disk-utils/partx.8.adoc:59
4780 "Specify the range of partitions. For backward compatibility also the format "
4781 "__M__**-**_N_ is supported. The range may contain negative numbers, for "
4782 "example *--nr -1:-1* means the last partition, and *--nr -2:-1* means the "
4783 "last two partitions. Supported range specifications are:"
4786 #. type: Labeled list
4787 #: ../disk-utils/partx.8.adoc:60
4793 #: ../disk-utils/partx.8.adoc:62
4794 msgid "Specifies just one partition (e.g. *--nr 3*)."
4797 #. type: Labeled list
4798 #: ../disk-utils/partx.8.adoc:62
4804 #: ../disk-utils/partx.8.adoc:64
4805 msgid "Specifies the lower limit only (e.g. *--nr 2:*)."
4808 #. type: Labeled list
4809 #: ../disk-utils/partx.8.adoc:64
4815 #: ../disk-utils/partx.8.adoc:66
4816 msgid "Specifies the upper limit only (e.g. *--nr :4*)."
4819 #. type: Labeled list
4820 #: ../disk-utils/partx.8.adoc:66
4822 msgid "__M__**:**_N_"
4826 #: ../disk-utils/partx.8.adoc:68
4827 msgid "Specifies the lower and upper limits (e.g. *--nr 2:4*)."
4831 #: ../disk-utils/partx.8.adoc:71
4833 "Define the output columns to use for *--show*, *--pairs* and *--raw* output. "
4834 "If no output arrangement is specified, then a default set is used. Use *--"
4835 "help* to get _list_ of all supported columns. This option cannot be combined "
4836 "with the *--add*, *--delete*, *--update* or *--list* options."
4839 #. type: Labeled list
4840 #: ../disk-utils/partx.8.adoc:72 ../login-utils/lslogins.1.adoc:72
4841 #: ../misc-utils/fincore.1.adoc:41 ../misc-utils/findmnt.8.adoc:109
4842 #: ../misc-utils/lsclocks.1.adoc:36 ../misc-utils/lslocks.8.adoc:55
4843 #: ../sys-utils/losetup.8.adoc:107 ../sys-utils/lscpu.1.adoc:92
4844 #: ../sys-utils/lsmem.1.adoc:48 ../sys-utils/lsns.8.adoc:48
4845 #: ../sys-utils/rfkill.8.adoc:36 ../sys-utils/swapon.8.adoc:74
4846 #: ../sys-utils/zramctl.8.adoc:55
4848 msgid "*--output-all*"
4852 #: ../disk-utils/partx.8.adoc:74 ../misc-utils/fincore.1.adoc:43
4853 #: ../misc-utils/lsblk.8.adoc:98 ../misc-utils/lslocks.8.adoc:57
4854 #: ../sys-utils/losetup.8.adoc:109 ../sys-utils/lsmem.1.adoc:50
4855 #: ../sys-utils/lsns.8.adoc:50 ../sys-utils/rfkill.8.adoc:38
4856 #: ../sys-utils/swapon.8.adoc:76 ../sys-utils/zramctl.8.adoc:57
4857 msgid "Output all available columns."
4860 #. type: Labeled list
4861 #: ../disk-utils/partx.8.adoc:75 ../misc-utils/findmnt.8.adoc:112
4862 #: ../misc-utils/lsblk.8.adoc:99 ../sys-utils/lsirq.1.adoc:37
4863 #: ../sys-utils/lsmem.1.adoc:51
4865 #| msgid "*-P*, *--pty*"
4866 msgid "*-P*, *--pairs*"
4867 msgstr "*-P*, *--pty*"
4870 #: ../disk-utils/partx.8.adoc:77
4871 msgid "List the partitions using the KEY=\"value\" format."
4874 #. type: Labeled list
4875 #: ../disk-utils/partx.8.adoc:78 ../login-utils/lslogins.1.adoc:78
4876 #: ../misc-utils/fincore.1.adoc:44 ../misc-utils/findmnt.8.adoc:140
4877 #: ../misc-utils/lsblk.8.adoc:149 ../misc-utils/lsclocks.1.adoc:39
4878 #: ../misc-utils/lsfd.1.adoc:57 ../misc-utils/lslocks.8.adoc:61
4879 #: ../misc-utils/uuidparse.1.adoc:59 ../sys-utils/dmesg.1.adoc:113
4880 #: ../sys-utils/lsipc.1.adoc:71 ../sys-utils/lsmem.1.adoc:54
4881 #: ../sys-utils/lsns.8.adoc:58 ../sys-utils/rfkill.8.adoc:39
4882 #: ../sys-utils/wdctl.8.adoc:54
4884 #| msgid "*-f*, *--fast*"
4885 msgid "*-r*, *--raw*"
4886 msgstr "*-f*, *--fast*"
4889 #: ../disk-utils/partx.8.adoc:80
4890 msgid "List the partitions using the raw output format."
4893 #. type: Labeled list
4894 #: ../disk-utils/partx.8.adoc:81
4896 #| msgid "*-h*, *--help*"
4897 msgid "*-s*, *--show*"
4898 msgstr "*-h*, *--help*"
4901 #: ../disk-utils/partx.8.adoc:83
4903 "List the partitions. The output columns can be selected and rearranged with "
4904 "the *--output* option. All numbers (except SIZE) are in 512-byte sectors."
4908 #: ../disk-utils/partx.8.adoc:86
4909 msgid "Specify the partition table type."
4912 #. type: Labeled list
4913 #: ../disk-utils/partx.8.adoc:87
4915 msgid "*--list-types*"
4919 #: ../disk-utils/partx.8.adoc:89
4920 msgid "List supported partition types and exit."
4923 #. type: Labeled list
4924 #: ../disk-utils/partx.8.adoc:90
4926 #| msgid "*-P*, *--pty*"
4927 msgid "*-u*, *--update*"
4928 msgstr "*-P*, *--pty*"
4931 #: ../disk-utils/partx.8.adoc:92
4932 msgid "Update the specified partitions."
4935 #. type: Labeled list
4936 #: ../disk-utils/partx.8.adoc:93
4938 msgid "*-S*, *--sector-size* _size_"
4942 #: ../disk-utils/partx.8.adoc:95
4943 msgid "Overwrite default sector size."
4947 #: ../disk-utils/partx.8.adoc:98 ../sys-utils/losetup.8.adoc:100
4948 #: ../sys-utils/mount.8.adoc:459 ../sys-utils/prlimit.1.adoc:57
4949 #: ../sys-utils/umount.8.adoc:113
4950 msgid "Verbose mode."
4954 #: ../disk-utils/partx.8.adoc:106 ../lib/terminal-colors.d.5.adoc:142
4955 #: ../misc-utils/uuidd.8.adoc:74 ../sys-utils/chmem.8.adoc:67
4956 #: ../sys-utils/losetup.8.adoc:144 ../sys-utils/pivot_root.8.adoc:37
4957 #: ../sys-utils/readprofile.8.adoc:77 ../sys-utils/rfkill.8.adoc:64
4958 #: ../sys-utils/setarch.8.adoc:80 ../sys-utils/zramctl.8.adoc:83
4959 #: ../term-utils/agetty.8.adoc:194
4964 #. type: Labeled list
4965 #: ../disk-utils/partx.8.adoc:108
4967 msgid "partx --show /dev/sdb3"
4970 #. type: Labeled list
4971 #: ../disk-utils/partx.8.adoc:109
4973 msgid "partx --show --nr 3 /dev/sdb"
4976 #. type: Labeled list
4977 #: ../disk-utils/partx.8.adoc:110
4979 msgid "partx --show /dev/sdb3 /dev/sdb"
4983 #: ../disk-utils/partx.8.adoc:112
4984 msgid "All three commands list partition 3 of _/dev/sdb_."
4987 #. type: Labeled list
4988 #: ../disk-utils/partx.8.adoc:113
4990 msgid "partx --show - /dev/sdb3"
4994 #: ../disk-utils/partx.8.adoc:115
4996 "Lists all subpartitions on _/dev/sdb3_ (the device is used as whole-disk)."
4999 #. type: Labeled list
5000 #: ../disk-utils/partx.8.adoc:116
5002 msgid "partx -o START -g --nr 5 /dev/sdb"
5006 #: ../disk-utils/partx.8.adoc:118
5007 msgid "Prints the start sector of partition 5 on _/dev/sdb_ without header."
5010 #. type: Labeled list
5011 #: ../disk-utils/partx.8.adoc:119
5013 msgid "partx -o SECTORS,SIZE /dev/sda5 /dev/sda"
5017 #: ../disk-utils/partx.8.adoc:121
5019 "Lists the length in sectors and human-readable size of partition 5 on _/dev/"
5023 #. type: Labeled list
5024 #: ../disk-utils/partx.8.adoc:122
5026 msgid "partx --add --nr 3:5 /dev/sdd"
5030 #: ../disk-utils/partx.8.adoc:124
5031 msgid "Adds all available partitions from 3 to 5 (inclusive) on _/dev/sdd_."
5034 #. type: Labeled list
5035 #: ../disk-utils/partx.8.adoc:125
5037 msgid "partx -d --nr :-1 /dev/sdd"
5041 #: ../disk-utils/partx.8.adoc:127
5042 msgid "Removes the last partition on _/dev/sdd_."
5046 #: ../disk-utils/partx.8.adoc:132
5047 msgid "mailto:dave@gnu.org[Davidlohr Bueso], mailto:kzak@redhat.com[Karel Zak]"
5051 #: ../disk-utils/partx.8.adoc:134
5053 "The original version was written by mailto:aeb@cwi.nl[Andries E. Brouwer]"
5057 #: ../disk-utils/partx.8.adoc:142
5068 #: ../disk-utils/raw.8.adoc:2
5074 #: ../disk-utils/raw.8.adoc:12
5075 msgid "raw - bind a Linux raw character device"
5079 #: ../disk-utils/raw.8.adoc:16
5081 msgid "*raw* _/dev/raw/raw<N>_ _<major>_ _<minor>_\n"
5085 #: ../disk-utils/raw.8.adoc:18
5087 msgid "*raw* _/dev/raw/raw<N>_ _/dev/<blockdev>_\n"
5091 #: ../disk-utils/raw.8.adoc:20
5093 msgid "*raw* *-q* _/dev/raw/raw<N>_\n"
5097 #: ../disk-utils/raw.8.adoc:22
5099 msgid "*raw* *-qa*\n"
5103 #: ../disk-utils/raw.8.adoc:26
5105 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"
5109 #: ../disk-utils/raw.8.adoc:28
5111 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"
5115 #: ../disk-utils/raw.8.adoc:30
5117 "The bindings already in existence can be queried with the *-q* option, which "
5118 "is used either with a raw device filename to query that one device, or with "
5119 "the *-a* option to query all bound raw devices."
5123 #: ../disk-utils/raw.8.adoc:32
5124 msgid "Unbinding can be done by specifying major and minor 0."
5128 #: ../disk-utils/raw.8.adoc:34
5130 "Once bound to a block device, a raw device can be opened, read and written, "
5131 "just like the block device it is bound to. However, the raw device does not "
5132 "behave exactly like the block device. In particular, access to the raw "
5133 "device bypasses the kernel's block buffer cache entirely: all I/O is done "
5134 "directly to and from the address space of the process performing the I/O. If "
5135 "the underlying block device driver can support DMA, then no data copying at "
5136 "all is required to complete the I/O."
5140 #: ../disk-utils/raw.8.adoc:36
5142 "Because raw I/O involves direct hardware access to a process's memory, a few "
5143 "extra restrictions must be observed. All I/Os must be correctly aligned in "
5144 "memory and on disk: they must start at a sector offset on disk, they must be "
5145 "an exact number of sectors long, and the data buffer in virtual memory must "
5146 "also be aligned to a multiple of the sector size. The sector size is 512 "
5147 "bytes for most devices."
5150 #. type: Labeled list
5151 #: ../disk-utils/raw.8.adoc:39
5153 #| msgid "*-P*, *--pty*"
5154 msgid "*-q*, *--query*"
5155 msgstr "*-P*, *--pty*"
5158 #: ../disk-utils/raw.8.adoc:41
5160 "Set query mode. *raw* will query an existing binding instead of setting a "
5164 #. type: Labeled list
5165 #: ../disk-utils/raw.8.adoc:42 ../misc-utils/kill.1.adoc:61
5166 #: ../misc-utils/lsblk.8.adoc:38 ../misc-utils/rename.1.adoc:34
5167 #: ../misc-utils/wipefs.8.adoc:40 ../sys-utils/ipcs.1.adoc:43
5168 #: ../sys-utils/losetup.8.adoc:53 ../sys-utils/lscpu.1.adoc:33
5169 #: ../sys-utils/lsmem.1.adoc:33 ../sys-utils/mount.8.adoc:307
5170 #: ../sys-utils/nsenter.1.adoc:53 ../sys-utils/readprofile.8.adoc:27
5171 #: ../sys-utils/swapon.8.adoc:31 ../sys-utils/umount.8.adoc:54
5173 #| msgid "*-h*, *--help*"
5174 msgid "*-a*, *--all*"
5175 msgstr "*-h*, *--help*"
5178 #: ../disk-utils/raw.8.adoc:44
5179 msgid "With *-q*, specify that all bound raw devices should be queried."
5183 #: ../disk-utils/raw.8.adoc:50
5185 "Rather than using raw devices applications should prefer *open*(2) devices, "
5186 "such as _/dev/sda1_, with the *O_DIRECT* flag."
5190 #: ../disk-utils/raw.8.adoc:54
5192 "The Linux *dd*(1) command should be used without the *bs=* option, or the "
5193 "blocksize needs to be a multiple of the sector size of the device (512 bytes "
5194 "usually), otherwise it will fail with \"Invalid Argument\" messages "
5199 #: ../disk-utils/raw.8.adoc:56
5201 "Raw I/O devices do not maintain cache coherency with the Linux block device "
5202 "buffer cache. If you use raw I/O to overwrite data already in the buffer "
5203 "cache, the buffer cache will no longer correspond to the contents of the "
5204 "actual storage device underneath. This is deliberate, but is regarded as "
5205 "either a bug or a feature, depending on who you ask!"
5209 #: ../disk-utils/raw.8.adoc:60
5210 msgid "mailto:sct@redhat.com[Stephen Tweedie]"
5213 #. resizepart.8 -- man page for resizepart
5214 #. Copyright 2012 Vivek Goyal <vgoyal@redhat.com>
5215 #. Copyright 2012 Red Hat, Inc.
5216 #. May be distributed under the GNU General Public License
5218 #: ../disk-utils/resizepart.8.adoc:8
5220 msgid "resizepart(8)"
5224 #: ../disk-utils/resizepart.8.adoc:18
5225 msgid "resizepart - tell the kernel about the new size of a partition"
5229 #: ../disk-utils/resizepart.8.adoc:22
5231 msgid "*resizepart* _device partition length_\n"
5235 #: ../disk-utils/resizepart.8.adoc:26
5237 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"
5241 #: ../disk-utils/resizepart.8.adoc:39
5242 msgid "The new length of the partition (in 512-byte sectors)."
5246 #: ../disk-utils/resizepart.8.adoc:50
5259 #. sfdisk.8 -- man page for sfdisk
5260 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
5261 #. Permission is granted to make and distribute verbatim copies of this
5262 #. manual provided the copyright notice and this permission notice are
5263 #. preserved on all copies.
5264 #. Permission is granted to copy and distribute modified versions of this
5265 #. manual under the conditions for verbatim copying, provided that the
5266 #. entire resulting derived work is distributed under the terms of a
5267 #. permission notice identical to this one.
5269 #: ../disk-utils/sfdisk.8.adoc:15
5275 #: ../disk-utils/sfdisk.8.adoc:27
5276 msgid "sfdisk - display or manipulate a disk partition table"
5280 #: ../disk-utils/sfdisk.8.adoc:31
5282 msgid "*sfdisk* [options] _device_ [*-N* _partition-number_]\n"
5286 #: ../disk-utils/sfdisk.8.adoc:33
5288 msgid "*sfdisk* [options] _command_\n"
5292 #: ../disk-utils/sfdisk.8.adoc:37
5294 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"
5298 #: ../disk-utils/sfdisk.8.adoc:39
5300 "Since version 2.26 *sfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
5301 "labels, but no longer provides any functionality for CHS (Cylinder-Head-"
5302 "Sector) addressing. CHS has never been important for Linux, and this "
5303 "addressing concept does not make any sense for new devices."
5307 #: ../disk-utils/sfdisk.8.adoc:41
5309 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"
5313 #: ../disk-utils/sfdisk.8.adoc:43
5315 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"
5319 #: ../disk-utils/sfdisk.8.adoc:45
5321 "The recommended way is not to specify start offsets at all and specify "
5322 "partition size in MiB, GiB (or so). In this case *sfdisk* aligns all "
5323 "partitions to block-device I/O limits (or when I/O limits are too small then "
5324 "to megabyte boundary to keep disk layout portable). If this default "
5325 "behaviour is unwanted (usually for very small partitions) then specify "
5326 "offsets and sizes in sectors. In this case *sfdisk* entirely follows "
5327 "specified numbers without any optimization."
5331 #: ../disk-utils/sfdisk.8.adoc:47
5333 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"
5337 #: ../disk-utils/sfdisk.8.adoc:49
5339 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"
5343 #: ../disk-utils/sfdisk.8.adoc:51
5345 "The *sfdisk* prompt is only a hint for users and a displayed partition "
5346 "number does not mean that the same partition table entry will be created (if "
5347 "*-N* not specified), especially for tables with gaps."
5351 #: ../disk-utils/sfdisk.8.adoc:55
5352 msgid "The commands are mutually exclusive."
5355 #. type: Labeled list
5356 #: ../disk-utils/sfdisk.8.adoc:56
5358 msgid "[*-N* _partition-number_] __device__"
5362 #: ../disk-utils/sfdisk.8.adoc:58
5364 "The default *sfdisk* command is to read the specification for the desired "
5365 "partitioning of _device_ from standard input, and then create a partition "
5366 "table according to the specification. See below for the description of the "
5367 "input format. If standard input is a terminal, then *sfdisk* starts an "
5368 "interactive session."
5372 #: ../disk-utils/sfdisk.8.adoc:60
5374 "If the option *-N* is specified, then the changes are applied to the "
5375 "partition addressed by _partition-number_. The unspecified fields of the "
5376 "partition are not modified."
5380 #: ../disk-utils/sfdisk.8.adoc:62
5382 "Note that it's possible to address an unused partition with *-N*. For "
5383 "example, an MBR always contains 4 partitions, but the number of used "
5384 "partitions may be smaller. In this case *sfdisk* follows the default values "
5385 "from the partition table and does not use built-in defaults for the unused "
5386 "partition given with *-N*. See also *--append*."
5389 #. type: Labeled list
5390 #: ../disk-utils/sfdisk.8.adoc:63
5392 msgid "*-A*, *--activate* __device__ [__partition-number__...]"
5396 #: ../disk-utils/sfdisk.8.adoc:65
5398 "Switch on the bootable flag for the specified partitions and switch off the "
5399 "bootable flag on all unspecified partitions. The special placeholder '-' may "
5400 "be used instead of the partition numbers to switch off the bootable flag on "
5405 #: ../disk-utils/sfdisk.8.adoc:67
5407 "The activation command is supported for MBR and PMBR only. If a GPT label is "
5408 "detected, then *sfdisk* prints warning and automatically enters PMBR."
5412 #: ../disk-utils/sfdisk.8.adoc:69
5414 "If no _partition-number_ is specified, then list the partitions with an "
5418 #. type: Labeled list
5419 #: ../disk-utils/sfdisk.8.adoc:70
5421 msgid "*--backup-pt-sectors* _device_"
5425 #: ../disk-utils/sfdisk.8.adoc:72
5427 "Back up the current partition table sectors in binary format and exit. See "
5428 "the *BACKING UP THE PARTITION TABLE* section."
5431 #. type: Labeled list
5432 #: ../disk-utils/sfdisk.8.adoc:73
5434 msgid "*--delete* _device_ [__partition-number__...]"
5438 #: ../disk-utils/sfdisk.8.adoc:75
5439 msgid "Delete all or the specified partitions."
5442 #. type: Labeled list
5443 #: ../disk-utils/sfdisk.8.adoc:76
5445 msgid "*-d*, *--dump* _device_"
5449 #: ../disk-utils/sfdisk.8.adoc:78
5451 "Dump the partitions of a device in a format that is usable as input to "
5452 "*sfdisk*. See the *BACKING UP THE PARTITION TABLE* section."
5455 #. type: Labeled list
5456 #: ../disk-utils/sfdisk.8.adoc:79
5458 msgid "*-g*, *--show-geometry* [__device__...]"
5462 #: ../disk-utils/sfdisk.8.adoc:81
5464 "List the geometry of all or the specified devices. For backward "
5465 "compatibility the deprecated option *--show-pt-geometry* have the same "
5466 "meaning as this one."
5469 #. type: Labeled list
5470 #: ../disk-utils/sfdisk.8.adoc:82
5472 #| msgid "*-V*, *--version*"
5473 msgid "*-J*, *--json* _device_"
5474 msgstr "*-V*, *--version*"
5477 #: ../disk-utils/sfdisk.8.adoc:84
5479 "Dump the partitions of a device in JSON format. Note that *sfdisk* is not "
5480 "able to use JSON as input format."
5483 #. type: Labeled list
5484 #: ../disk-utils/sfdisk.8.adoc:85
5486 msgid "*-l*, *--list* [__device__...]"
5490 #: ../disk-utils/sfdisk.8.adoc:87
5492 "List the partitions of all or the specified devices. This command can be "
5493 "used together with *--verify*."
5496 #. type: Labeled list
5497 #: ../disk-utils/sfdisk.8.adoc:88
5499 msgid "*-F*, *--list-free* [__device__...]"
5503 #: ../disk-utils/sfdisk.8.adoc:90
5504 msgid "List the free unpartitioned areas on all or the specified devices."
5507 #. type: Labeled list
5508 #: ../disk-utils/sfdisk.8.adoc:91
5510 msgid "*--part-attrs* _device partition-number_ [__attributes__]"
5514 #: ../disk-utils/sfdisk.8.adoc:93
5516 "Change the GPT partition attribute bits. If _attributes_ is not specified, "
5517 "then print the current partition settings. The _attributes_ argument is a "
5518 "comma- or space-delimited list of bits numbers or bit names. For example, "
5519 "the string \"RequiredPartition,50,51\" sets three bits. The currently "
5520 "supported attribute bits are:"
5523 #. type: Labeled list
5524 #: ../disk-utils/sfdisk.8.adoc:94
5526 msgid "*Bit 0 (RequiredPartition)*"
5530 #: ../disk-utils/sfdisk.8.adoc:96
5532 "If this bit is set, the partition is required for the platform to function. "
5533 "The creator of the partition indicates that deletion or modification of the "
5534 "contents can result in loss of platform features or failure for the platform "
5535 "to boot or operate. The system cannot function normally if this partition is "
5536 "removed, and it should be considered part of the hardware of the system."
5539 #. type: Labeled list
5540 #: ../disk-utils/sfdisk.8.adoc:96
5542 msgid "*Bit 1 (NoBlockIOProtocol)*"
5546 #: ../disk-utils/sfdisk.8.adoc:98
5548 "EFI firmware should ignore the content of the partition and not try to read "
5552 #. type: Labeled list
5553 #: ../disk-utils/sfdisk.8.adoc:98
5555 msgid "*Bit 2 (LegacyBIOSBootable)*"
5559 #: ../disk-utils/sfdisk.8.adoc:100
5560 msgid "The partition may be bootable by legacy BIOS firmware."
5563 #. type: Labeled list
5564 #: ../disk-utils/sfdisk.8.adoc:100
5570 #: ../disk-utils/sfdisk.8.adoc:102
5572 "Undefined and must be zero. Reserved for expansion by future versions of the "
5573 "UEFI specification."
5576 #. type: Labeled list
5577 #: ../disk-utils/sfdisk.8.adoc:102
5579 msgid "*Bits 48-63*"
5583 #: ../disk-utils/sfdisk.8.adoc:104
5585 "Reserved for GUID specific use. The use of these bits will vary depending on "
5586 "the partition type. For example Microsoft uses bit 60 to indicate read-only, "
5587 "61 for shadow copy of another partition, 62 for hidden partitions and 63 to "
5588 "disable automount."
5591 #. type: Labeled list
5592 #: ../disk-utils/sfdisk.8.adoc:105
5594 msgid "*--part-label* _device partition-number_ [__label__]"
5598 #: ../disk-utils/sfdisk.8.adoc:107
5600 "Change the GPT partition name (label). If _label_ is not specified, then "
5601 "print the current partition label."
5604 #. type: Labeled list
5605 #: ../disk-utils/sfdisk.8.adoc:108
5607 msgid "*--part-type* _device partition-number_ [__type__]"
5611 #: ../disk-utils/sfdisk.8.adoc:110
5613 "Change the partition type. If _type_ is not specified, then print the "
5614 "current partition type."
5618 #: ../disk-utils/sfdisk.8.adoc:112
5620 "The _type_ argument is hexadecimal for MBR, GUID for GPT, type alias (e.g. "
5621 "\"linux\") or type shortcut (e.g. 'L'). For backward compatibility the "
5622 "options *-c* and *--id* have the same meaning as this one."
5625 #. type: Labeled list
5626 #: ../disk-utils/sfdisk.8.adoc:113
5628 msgid "*--part-uuid* _device partition-number_ [__uuid__]"
5632 #: ../disk-utils/sfdisk.8.adoc:115
5634 "Change the GPT partition UUID. If _uuid_ is not specified, then print the "
5635 "current partition UUID."
5638 #. type: Labeled list
5639 #: ../disk-utils/sfdisk.8.adoc:116
5641 msgid "*--disk-id* _device_ [__id__]"
5645 #: ../disk-utils/sfdisk.8.adoc:118
5647 "Change the disk identifier. If _id_ is not specified, then print the current "
5648 "identifier. The identifier is UUID for GPT or unsigned integer for MBR."
5651 #. type: Labeled list
5652 #: ../disk-utils/sfdisk.8.adoc:119
5654 msgid "*-r*, *--reorder* _device_"
5658 #: ../disk-utils/sfdisk.8.adoc:121
5659 msgid "Renumber the partitions, ordering them by their start offset."
5662 #. type: Labeled list
5663 #: ../disk-utils/sfdisk.8.adoc:122
5665 msgid "*-s*, *--show-size* [__device__...]"
5669 #: ../disk-utils/sfdisk.8.adoc:124
5671 "List the sizes of all or the specified devices in units of 1024 byte size. "
5672 "This command is DEPRECATED in favour of *blockdev*(8)."
5675 #. type: Labeled list
5676 #: ../disk-utils/sfdisk.8.adoc:125
5678 #| msgid "*-P*, *--pty*"
5679 msgid "*-T*, *--list-types*"
5680 msgstr "*-P*, *--pty*"
5683 #: ../disk-utils/sfdisk.8.adoc:127
5685 "Print all supported types for the current disk label or the label specified "
5689 #. type: Labeled list
5690 #: ../disk-utils/sfdisk.8.adoc:128
5692 msgid "*-V*, *--verify* [__device__...]"
5696 #: ../disk-utils/sfdisk.8.adoc:130
5697 msgid "Test whether the partition table and partitions seem correct."
5700 #. type: Labeled list
5701 #: ../disk-utils/sfdisk.8.adoc:131
5703 msgid "*--relocate* _oper_ _device_"
5707 #: ../disk-utils/sfdisk.8.adoc:133
5709 "Relocate partition table header. This command is currently supported for GPT "
5710 "header only. The argument _oper_ can be:"
5713 #. type: Labeled list
5714 #: ../disk-utils/sfdisk.8.adoc:134
5716 msgid "*gpt-bak-std*"
5720 #: ../disk-utils/sfdisk.8.adoc:136
5722 "Move GPT backup header to the standard location at the end of the device."
5725 #. type: Labeled list
5726 #: ../disk-utils/sfdisk.8.adoc:136
5728 msgid "*gpt-bak-mini*"
5732 #: ../disk-utils/sfdisk.8.adoc:138
5734 "Move GPT backup header behind the last partition. Note that UEFI standard "
5735 "requires the backup header at the end of the device and partitioning tools "
5736 "can automatically relocate the header to follow the standard."
5739 #. type: Labeled list
5740 #: ../disk-utils/sfdisk.8.adoc:141 ../term-utils/script.1.adoc:66
5742 #| msgid "*-P*, *--pty*"
5743 msgid "*-a*, *--append*"
5744 msgstr "*-P*, *--pty*"
5747 #: ../disk-utils/sfdisk.8.adoc:143
5749 "Don't create a new partition table, but only append the specified partitions."
5753 #: ../disk-utils/sfdisk.8.adoc:145
5755 "Note that unused partition maybe be re-used in this case although it is not "
5756 "the last partition in the partition table. See also *-N* to specify entry in "
5757 "the partition table."
5760 #. type: Labeled list
5761 #: ../disk-utils/sfdisk.8.adoc:146
5763 #| msgid "*-P*, *--pty*"
5764 msgid "*-b*, *--backup*"
5765 msgstr "*-P*, *--pty*"
5768 #: ../disk-utils/sfdisk.8.adoc:148
5770 "Back up the current partition table sectors before starting the "
5771 "partitioning. The default backup file name is _~/sfdisk-<device>-<offset>."
5772 "bak_; to use another name see option *-O*, *--backup-file*. See section "
5773 "*BACKING UP THE PARTITION TABLE* for more details."
5776 #. type: Labeled list
5777 #: ../disk-utils/sfdisk.8.adoc:149
5779 msgid "*--color*[**=**__when__]"
5783 #: ../disk-utils/sfdisk.8.adoc:154
5784 msgid "Disable all consistency checking."
5787 #. type: Labeled list
5788 #: ../disk-utils/sfdisk.8.adoc:155
5794 #: ../disk-utils/sfdisk.8.adoc:157
5796 "Deprecated and ignored option. Partitioning that is compatible with Linux "
5797 "(and other modern operating systems) is the default."
5800 #. type: Labeled list
5801 #: ../disk-utils/sfdisk.8.adoc:161 ../misc-utils/rename.1.adoc:31
5802 #: ../misc-utils/wipefs.8.adoc:61
5804 #| msgid "*-f*, *--fast*"
5805 msgid "*-n*, *--no-act*"
5806 msgstr "*-f*, *--fast*"
5809 #: ../disk-utils/sfdisk.8.adoc:163
5810 msgid "Do everything except writing to the device."
5813 #. type: Labeled list
5814 #: ../disk-utils/sfdisk.8.adoc:164
5816 msgid "*--no-reread*"
5820 #: ../disk-utils/sfdisk.8.adoc:166
5822 "Do not check through the re-read-partition-table ioctl whether the device is "
5826 #. type: Labeled list
5827 #: ../disk-utils/sfdisk.8.adoc:167
5829 msgid "*--no-tell-kernel*"
5833 #: ../disk-utils/sfdisk.8.adoc:169
5835 "Don't tell the kernel about partition changes. This option is recommended "
5836 "together with *--no-reread* to modify a partition on used disk. The modified "
5837 "partition should not be used (e.g., mounted)."
5840 #. type: Labeled list
5841 #: ../disk-utils/sfdisk.8.adoc:170
5843 msgid "*-O*, *--backup-file* _path_"
5847 #: ../disk-utils/sfdisk.8.adoc:172
5849 "Override the default backup file name. Note that the device name and offset "
5850 "are always appended to the file name."
5853 #. type: Labeled list
5854 #: ../disk-utils/sfdisk.8.adoc:173
5856 msgid "*--move-data*[**=**__path__]"
5860 #: ../disk-utils/sfdisk.8.adoc:175
5862 "Move data after partition relocation, for example when moving the beginning "
5863 "of a partition to another place on the disk. The size of the partition has "
5864 "to remain the same, the new and old location may overlap. This option "
5865 "requires option *-N* in order to be processed on one specific partition only."
5869 #: ../disk-utils/sfdisk.8.adoc:177
5871 "The optional _path_ specifies log file name. The log file contains "
5872 "information about all read/write operations on the partition data. The word "
5873 "\"@default\" as a _path_ forces *sfdisk* to use _~/sfdisk-<devname>.move_ "
5874 "for the log. The log is optional since v2.35."
5878 #: ../disk-utils/sfdisk.8.adoc:179
5880 "Note that this operation is risky and not atomic. *Don't forget to backup "
5885 #: ../disk-utils/sfdisk.8.adoc:181
5886 msgid "See also *--move-use-fsync*."
5890 #: ../disk-utils/sfdisk.8.adoc:183
5892 "In the example below, the first command creates a 100MiB free area before "
5893 "the first partition and moves the data it contains (e.g., a filesystem), the "
5894 "next command creates a new partition from the free space (at offset 2048), "
5895 "and the last command reorders partitions to match disk order (the original "
5896 "sdc1 will become sdc2)."
5899 #. type: delimited block _
5900 #: ../disk-utils/sfdisk.8.adoc:186
5902 msgid "*echo '+100M,' | sfdisk --move-data /dev/sdc -N 1*\n"
5905 #. type: delimited block _
5906 #: ../disk-utils/sfdisk.8.adoc:188
5908 msgid "*echo '2048,' | sfdisk /dev/sdc --append*\n"
5911 #. type: delimited block _
5912 #: ../disk-utils/sfdisk.8.adoc:190
5914 msgid "*sfdisk /dev/sdc --reorder*\n"
5917 #. type: Labeled list
5918 #: ../disk-utils/sfdisk.8.adoc:192
5920 msgid "*--move-use-fsync*"
5924 #: ../disk-utils/sfdisk.8.adoc:194
5926 "Use the *fsync*(2) system call after each write when moving data to a new "
5927 "location by *--move-data*."
5930 #. TRANSLATORS: Keep {plus} untranslated.
5932 #: ../disk-utils/sfdisk.8.adoc:199
5934 "The default list of columns may be extended if _list_ is specified in the "
5935 "format _{plus}list_ (e.g., *-o +UUID*)."
5939 #: ../disk-utils/sfdisk.8.adoc:203
5940 msgid "Suppress extra info messages."
5943 #. type: Labeled list
5944 #: ../disk-utils/sfdisk.8.adoc:204
5946 #| msgid "*-P*, *--pty*"
5947 msgid "*-u*, *--unit S*"
5948 msgstr "*-P*, *--pty*"
5951 #: ../disk-utils/sfdisk.8.adoc:206
5953 "Deprecated option. Only the sector unit is supported. This option is not "
5954 "supported when using the *--show-size* command."
5957 #. type: Labeled list
5958 #: ../disk-utils/sfdisk.8.adoc:207
5960 #| msgid "*-h*, *--help*"
5961 msgid "*-X*, *--label* _type_"
5962 msgstr "*-h*, *--help*"
5965 #: ../disk-utils/sfdisk.8.adoc:209
5967 "Specify the disk label type (e.g., *dos*, *gpt*, ...). If this option is not "
5968 "given, then *sfdisk* defaults to the existing label, but if there is no "
5969 "label on the device yet, then the type defaults to *dos*. The default or the "
5970 "current label may be overwritten by the \"label: <name>\" script header "
5971 "line. The option *--label* does not force *sfdisk* to create empty disk "
5972 "label (see the *EMPTY DISK LABEL* section below)."
5975 #. type: Labeled list
5976 #: ../disk-utils/sfdisk.8.adoc:210
5978 msgid "*-Y*, *--label-nested* _type_"
5982 #: ../disk-utils/sfdisk.8.adoc:212
5984 "Force editing of a nested disk label. The primary disk label has to exist "
5985 "already. This option allows editing for example a hybrid/protective MBR on "
5990 #: ../disk-utils/sfdisk.8.adoc:215
5992 "Wipe filesystem, RAID and partition-table signatures from the device, in "
5993 "order to avoid possible collisions. The argument _when_ can be *auto*, "
5994 "*never* or *always*. When this option is not given, the default is *auto*, "
5995 "in which case signatures are wiped only when in interactive mode; except the "
5996 "old partition-table signatures which are always wiped before create a new "
5997 "partition-table if the argument _when_ is not *never*. The *auto* mode also "
5998 "does not wipe the first sector (boot sector), it is necessary to use the "
5999 "*always* mode to wipe this area. In all cases detected signatures are "
6000 "reported by warning messages before a new partition table is created. See "
6001 "also the *wipefs*(8) command."
6005 #: ../disk-utils/sfdisk.8.adoc:218
6007 "Wipe filesystem, RAID and partition-table signatures from a newly created "
6008 "partition, in order to avoid possible collisions. The argument _when_ can be "
6009 "*auto*, *never* or *always*. When this option is not given, the default is "
6010 "*auto*, in which case signatures are wiped only when in interactive mode and "
6011 "after confirmation by user. In all cases detected signatures are reported by "
6012 "warning messages after a new partition is created. See also *wipefs*(8) "
6016 #. type: Labeled list
6017 #: ../disk-utils/sfdisk.8.adoc:219
6019 #| msgid "*-V*, *--version*"
6020 msgid "*-v*, *--version*"
6021 msgstr "*-V*, *--version*"
6024 #: ../disk-utils/sfdisk.8.adoc:225
6026 msgid "INPUT FORMATS"
6030 #: ../disk-utils/sfdisk.8.adoc:228
6032 msgid "*sfdisk* supports two input formats and generic header lines.\n"
6036 #: ../disk-utils/sfdisk.8.adoc:229
6038 msgid "Header lines"
6042 #: ../disk-utils/sfdisk.8.adoc:232
6044 "The optional header lines specify generic information that apply to the "
6045 "partition table. The header-line format is:"
6049 #: ../disk-utils/sfdisk.8.adoc:234
6051 msgid "*<name>: <value>*\n"
6055 #: ../disk-utils/sfdisk.8.adoc:236
6056 msgid "The currently recognized headers are:"
6059 #. type: Labeled list
6060 #: ../disk-utils/sfdisk.8.adoc:237
6066 #: ../disk-utils/sfdisk.8.adoc:239
6067 msgid "Specify the partitioning unit. The only supported unit is *sectors*."
6070 #. type: Labeled list
6071 #: ../disk-utils/sfdisk.8.adoc:239
6077 #: ../disk-utils/sfdisk.8.adoc:241
6078 msgid "Specify the partition table type. For example *dos* or *gpt*."
6081 #. type: Labeled list
6082 #: ../disk-utils/sfdisk.8.adoc:241
6088 #: ../disk-utils/sfdisk.8.adoc:243
6090 "Specify the partition table identifier. It should be a hexadecimal number "
6091 "(with a 0x prefix) for MBR and a UUID for GPT."
6094 #. type: Labeled list
6095 #: ../disk-utils/sfdisk.8.adoc:243
6101 #: ../disk-utils/sfdisk.8.adoc:245
6103 "Specify the first usable sector for GPT partitions. This header is ignored "
6104 "if the script and device sector size differ. In this case *sfdisk* uses "
6105 "label specific default."
6108 #. type: Labeled list
6109 #: ../disk-utils/sfdisk.8.adoc:245
6115 #: ../disk-utils/sfdisk.8.adoc:247
6117 "Specify the last usable sector for GPT partitions. This header is ignored if "
6118 "the script and device sector size differ. In this case *sfdisk* uses label "
6122 #. type: Labeled list
6123 #: ../disk-utils/sfdisk.8.adoc:247
6125 msgid "*table-length*"
6129 #: ../disk-utils/sfdisk.8.adoc:249
6130 msgid "Specify the maximal number of GPT partitions."
6133 #. type: Labeled list
6134 #: ../disk-utils/sfdisk.8.adoc:249
6140 #: ../disk-utils/sfdisk.8.adoc:251
6142 "Specify minimal size in bytes used to calculate partitions alignment. The "
6143 "default is 1MiB and it's strongly recommended to use the default. Do not "
6144 "modify this variable if you're not sure."
6147 #. type: Labeled list
6148 #: ../disk-utils/sfdisk.8.adoc:251
6150 msgid "*sector-size*"
6154 #: ../disk-utils/sfdisk.8.adoc:253
6156 "Specify sector size. *sfdisk* always uses device sector size. Since version "
6157 "2.39 *sfdisk* recalculates sizes from dump if the script and device sector "
6162 #: ../disk-utils/sfdisk.8.adoc:255
6164 "Note that it is only possible to use header lines before the first partition "
6165 "is specified in the input."
6169 #: ../disk-utils/sfdisk.8.adoc:256
6171 msgid "Unnamed-fields format"
6174 #. type: delimited block _
6175 #: ../disk-utils/sfdisk.8.adoc:260
6176 msgid "_start size type bootable_"
6180 #: ../disk-utils/sfdisk.8.adoc:263
6181 msgid "where each line fills one partition descriptor."
6185 #: ../disk-utils/sfdisk.8.adoc:265
6187 "Fields are separated by whitespace, comma (recommended) or semicolon "
6188 "possibly followed by whitespace; initial and trailing whitespace is ignored. "
6189 "Numbers can be octal, decimal or hexadecimal; decimal is the default. When a "
6190 "field is absent, empty or specified as '-' a default value is used. But when "
6191 "the *-N* option (change a single partition) is given, the default for each "
6192 "field is its previous value."
6196 #: ../disk-utils/sfdisk.8.adoc:267
6198 "The default value of _start_ is the first non-assigned sector aligned "
6199 "according to device I/O limits. The default start offset for the first "
6200 "partition is 1 MiB. If the offset is followed by the multiplicative suffixes "
6201 "(KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB), then the number is interpreted "
6202 "as offset in bytes. Since v2.38 when the *-N* option (change a single "
6203 "partition) is given, a '{plus}' can be used to enlarge partition by move "
6204 "start of the partition if there is a free space before the partition."
6207 #. TRANSLATORS: Keep {plus} untranslated.
6209 #: ../disk-utils/sfdisk.8.adoc:270
6211 "The default value of _size_ indicates \"as much as possible\"; i.e., until "
6212 "the next partition or end-of-device. A numerical argument is by default "
6213 "interpreted as a number of sectors, however if the size is followed by one "
6214 "of the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB) "
6215 "then the number is interpreted as the size of the partition in bytes and it "
6216 "is then aligned according to the device I/O limits. A '{plus}' can be used "
6217 "instead of a number to enlarge the partition as much as possible. Note "
6218 "'{plus}' is equivalent to the default behaviour for a new partition; "
6219 "existing partitions will be resized as required."
6223 #: ../disk-utils/sfdisk.8.adoc:272
6225 "The partition _type_ is given in hex for MBR (DOS) where 0x prefix is "
6226 "optional; a GUID string for GPT; a shortcut or an alias. It's recommended to "
6227 "use two letters for MBR hex codes to avoid collision between deprecated "
6228 "shortcut 'E' and '0E' MBR hex code. For backward compatibility *sfdisk* "
6229 "tries to interpret _type_ as a shortcut as a first possibility in "
6230 "partitioning scripts although on other places (e.g. *--part-type* command) "
6231 "it tries shortcuts as the last possibility."
6235 #: ../disk-utils/sfdisk.8.adoc:274
6237 "Since v2.36 libfdisk supports partition type aliases as extension to "
6238 "shortcuts. The alias is a simple human readable word (e.g. \"linux\")."
6242 #: ../disk-utils/sfdisk.8.adoc:276
6244 "Since v2.37 libfdisk supports partition type names on input, ignoring the "
6245 "case of the characters and all non-alphanumeric and non-digit characters in "
6246 "the name (e.g. \"Linux /usr x86\" is the same as \"linux usr-x86\")."
6250 #: ../disk-utils/sfdisk.8.adoc:278
6251 msgid "Supported shortcuts and aliases:"
6254 #. type: Labeled list
6255 #: ../disk-utils/sfdisk.8.adoc:279
6257 msgid "*L - alias 'linux'*"
6261 #: ../disk-utils/sfdisk.8.adoc:281
6263 "Linux; means 83 for MBR and 0FC63DAF-8483-4772-8E79-3D69D8477DE4 for GPT."
6266 #. type: Labeled list
6267 #: ../disk-utils/sfdisk.8.adoc:282
6269 msgid "*S - alias 'swap'*"
6273 #: ../disk-utils/sfdisk.8.adoc:284
6275 "swap area; means 82 for MBR and 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F for GPT"
6278 #. type: Labeled list
6279 #: ../disk-utils/sfdisk.8.adoc:285
6281 msgid "*Ex - alias 'extended'*"
6285 #: ../disk-utils/sfdisk.8.adoc:287
6287 "MBR extended partition; means 05 for MBR. The original shortcut 'E' is "
6288 "deprecated due to collision with 0x0E MBR partition type."
6291 #. type: Labeled list
6292 #: ../disk-utils/sfdisk.8.adoc:288
6294 msgid "*H - alias 'home'*"
6298 #: ../disk-utils/sfdisk.8.adoc:290
6299 msgid "home partition; means 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 for GPT"
6302 #. type: Labeled list
6303 #: ../disk-utils/sfdisk.8.adoc:291
6305 msgid "*U - alias 'uefi'*"
6309 #: ../disk-utils/sfdisk.8.adoc:293
6311 "EFI System partition, means EF for MBR and C12A7328-F81F-11D2-"
6312 "BA4B-00A0C93EC93B for GPT"
6315 #. type: Labeled list
6316 #: ../disk-utils/sfdisk.8.adoc:294
6318 msgid "*R - alias 'raid'*"
6322 #: ../disk-utils/sfdisk.8.adoc:296
6324 "Linux RAID; means FD for MBR and A19D880F-05FC-4D3B-A006-743F0F84911E for GPT"
6327 #. type: Labeled list
6328 #: ../disk-utils/sfdisk.8.adoc:297
6330 msgid "*V - alias 'lvm'*"
6334 #: ../disk-utils/sfdisk.8.adoc:299
6335 msgid "LVM; means 8E for MBR and E6D6D379-F507-44C2-A23C-238F2A3DF928 for GPT"
6339 #: ../disk-utils/sfdisk.8.adoc:301
6340 msgid "The default _type_ value is _linux_."
6344 #: ../disk-utils/sfdisk.8.adoc:303
6346 "The shortcut 'X' for Linux extended partition (85) is deprecated in favour "
6350 #. TRANSLATORS: Keep {asterisk} untranslated.
6352 #: ../disk-utils/sfdisk.8.adoc:306
6354 "_bootable_ is specified as [*{asterisk}*|*-*], with as default not-bootable. "
6355 "The value of this field is irrelevant for Linux - when Linux runs it has "
6356 "been booted already - but it might play a role for certain boot loaders and "
6357 "for other operating systems."
6361 #: ../disk-utils/sfdisk.8.adoc:307
6363 msgid "Named-fields format"
6367 #: ../disk-utils/sfdisk.8.adoc:310
6369 "This format is more readable, robust, extensible and allows specifying "
6370 "additional information (e.g., a UUID). It is recommended to use this format "
6371 "to keep your scripts more readable."
6374 #. type: delimited block _
6375 #: ../disk-utils/sfdisk.8.adoc:313
6376 msgid "[_device_ *:*] _name_[**=**__value__], ..."
6380 #: ../disk-utils/sfdisk.8.adoc:316
6382 "The _device_ field is optional. *sfdisk* extracts the partition number from "
6383 "the device name. It allows specifying the partitions in random order. This "
6384 "functionality is mostly used by *--dump*. Don't use it if you are not sure."
6388 #: ../disk-utils/sfdisk.8.adoc:318
6390 "The _value_ can be between quotation marks (e.g., name=\"This is partition "
6391 "name\"). The fields *start=* and *size=* support '{plus}' and '-' in the "
6392 "same way as *Unnamed-fields format*."
6396 #: ../disk-utils/sfdisk.8.adoc:320
6397 msgid "The currently supported fields are:"
6400 #. type: Labeled list
6401 #: ../disk-utils/sfdisk.8.adoc:321
6403 msgid "**start=**__number__"
6407 #: ../disk-utils/sfdisk.8.adoc:323
6409 "The first non-assigned sector aligned according to device I/O limits. The "
6410 "default start offset for the first partition is 1 MiB. If the offset is "
6411 "followed by the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB "
6412 "and YiB), then the number is interpreted as offset in bytes."
6415 #. type: Labeled list
6416 #: ../disk-utils/sfdisk.8.adoc:324
6418 msgid "**size=**__number__"
6422 #: ../disk-utils/sfdisk.8.adoc:326
6424 "Specify the partition size in sectors. The number may be followed by the "
6425 "multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB), then "
6426 "it's interpreted as size in bytes and the size is aligned according to "
6427 "device I/O limits."
6430 #. type: Labeled list
6431 #: ../disk-utils/sfdisk.8.adoc:327
6437 #: ../disk-utils/sfdisk.8.adoc:329
6438 msgid "Mark the partition as bootable."
6441 #. type: Labeled list
6442 #: ../disk-utils/sfdisk.8.adoc:330
6444 msgid "**attrs=**__string__"
6448 #: ../disk-utils/sfdisk.8.adoc:332
6450 "Partition attributes, usually GPT partition attribute bits. See *--part-"
6451 "attrs* for more details about the GPT-bits string format."
6454 #. type: Labeled list
6455 #: ../disk-utils/sfdisk.8.adoc:333
6457 msgid "**uuid=**__string__"
6461 #: ../disk-utils/sfdisk.8.adoc:335
6462 msgid "GPT partition UUID."
6465 #. type: Labeled list
6466 #: ../disk-utils/sfdisk.8.adoc:336
6468 msgid "**name=**__string__"
6472 #: ../disk-utils/sfdisk.8.adoc:338
6473 msgid "GPT partition name."
6476 #. type: Labeled list
6477 #: ../disk-utils/sfdisk.8.adoc:339
6479 msgid "**type=**__code__"
6483 #: ../disk-utils/sfdisk.8.adoc:341
6485 "A hexadecimal number (without 0x) for an MBR partition, a GUID for a GPT "
6486 "partition, a shortcut as for unnamed-fields format or a type name (e.g. "
6487 "type=\"Linux /usr (x86)\"). See above the section about the unnamed-fields "
6488 "format for more details. For backward compatibility the *Id=* field has the "
6493 #: ../disk-utils/sfdisk.8.adoc:342
6495 msgid "EMPTY DISK LABEL"
6499 #: ../disk-utils/sfdisk.8.adoc:345
6501 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"
6504 #. type: delimited block _
6505 #: ../disk-utils/sfdisk.8.adoc:348
6507 msgid "*echo 'label: gpt' | sfdisk /dev/sdb*\n"
6511 #: ../disk-utils/sfdisk.8.adoc:351
6513 "creates empty GPT partition table. Note that the *--append* disables this "
6518 #: ../disk-utils/sfdisk.8.adoc:352
6520 msgid "BACKING UP THE PARTITION TABLE"
6524 #: ../disk-utils/sfdisk.8.adoc:355
6526 "It is recommended to save the layout of your devices. *sfdisk* supports two "
6531 #: ../disk-utils/sfdisk.8.adoc:356
6533 msgid "Dump in sfdisk compatible format"
6537 #: ../disk-utils/sfdisk.8.adoc:360
6539 "Use the *--dump* command to save a description of the device layout to a "
6540 "text file. The dump format is suitable for later *sfdisk* input. For "
6544 #. type: delimited block _
6545 #: ../disk-utils/sfdisk.8.adoc:362
6547 msgid "*sfdisk --dump /dev/sda > sda.dump*\n"
6551 #: ../disk-utils/sfdisk.8.adoc:365
6552 msgid "This can later be restored by:"
6555 #. type: delimited block _
6556 #: ../disk-utils/sfdisk.8.adoc:367
6558 msgid "*sfdisk /dev/sda < sda.dump*\n"
6562 #: ../disk-utils/sfdisk.8.adoc:370
6564 "Note that *sfdisk* completely restores partition types and partition UUIDs. "
6565 "This could potentially become problematic if you duplicate the same layout "
6566 "to different disks, as it may result in duplicate UUIDs within your system."
6570 #: ../disk-utils/sfdisk.8.adoc:371
6572 msgid "Full binary backup"
6576 #: ../disk-utils/sfdisk.8.adoc:374
6578 "If you want to do a full binary backup of all sectors where the partition "
6579 "table is stored, then use the *--backup-pt-sectors* command. It writes the "
6580 "sectors to _~/sfdisk-<device>-<offset>.bak_ files. The default name of the "
6581 "backup file can be changed with the *--backup-file* option. The backup files "
6582 "contain only raw data from the _device_. For example:"
6585 #. type: delimited block _
6586 #: ../disk-utils/sfdisk.8.adoc:377
6588 msgid "*sfdisk --backup-pt-sectors /dev/sda*\n"
6592 #: ../disk-utils/sfdisk.8.adoc:380
6593 msgid "The GPT header can later be restored by:"
6596 #. type: delimited block _
6597 #: ../disk-utils/sfdisk.8.adoc:383
6599 msgid "*dd if=~/sfdisk-sda-0x00000200.bak of=/dev/sda seek=$\\((0x00000200)) bs=1 conv=notrunc*\n"
6603 #: ../disk-utils/sfdisk.8.adoc:387
6605 "It's also possible to use the *--backup* option to create the same backup "
6606 "immediately after startup for other *sfdisk* commands. For example, backup "
6607 "partition table before deleting all partitions from partition table:"
6610 #. type: delimited block _
6611 #: ../disk-utils/sfdisk.8.adoc:389
6613 msgid "*sfdisk --backup --delete /dev/sda*\n"
6617 #: ../disk-utils/sfdisk.8.adoc:393
6618 msgid "The same concept of backup files is used by *wipefs*(8)."
6622 #: ../disk-utils/sfdisk.8.adoc:395
6624 "Note that *sfdisk* since version 2.26 no longer provides the *-I* option to "
6625 "restore sectors. *dd*(1) provides all necessary functionality."
6629 #: ../disk-utils/sfdisk.8.adoc:399
6630 msgid "The logical color names supported by *sfdisk* are:"
6633 #. type: Labeled list
6634 #: ../disk-utils/sfdisk.8.adoc:409
6636 msgid "*SFDISK_DEBUG*=all"
6640 #: ../disk-utils/sfdisk.8.adoc:411
6641 msgid "enables *sfdisk* debug output."
6645 #: ../disk-utils/sfdisk.8.adoc:423
6647 "Since version 2.26 *sfdisk* no longer provides the *-R* or *--re-read* "
6648 "option to force the kernel to reread the partition table. Use *blockdev --"
6649 "rereadpt* instead."
6653 #: ../disk-utils/sfdisk.8.adoc:425
6655 "Since version 2.26 *sfdisk* does not provide the *--DOS*, *--IBM*, *--DOS-"
6656 "extended*, *--unhide*, *--show-extended*, *--cylinders*, *--heads*, *--"
6657 "sectors*, *--inside-outer*, *--not-inside-outer* options."
6661 #: ../disk-utils/sfdisk.8.adoc:426 ../misc-utils/findmnt.8.adoc:215
6662 #: ../misc-utils/getopt.1.adoc:128 ../misc-utils/logger.1.adoc:233
6663 #: ../misc-utils/look.1.adoc:94 ../misc-utils/pipesz.1.adoc:69
6664 #: ../misc-utils/rename.1.adoc:83 ../misc-utils/uuidgen.1.adoc:61
6665 #: ../misc-utils/whereis.1.adoc:117 ../misc-utils/wipefs.8.adoc:88
6666 #: ../schedutils/chrt.1.adoc:106 ../schedutils/ionice.1.adoc:72
6667 #: ../sys-utils/flock.1.adoc:100 ../sys-utils/prlimit.1.adoc:114
6668 #: ../sys-utils/renice.1.adoc:96 ../sys-utils/setpriv.1.adoc:126
6669 #: ../sys-utils/unshare.1.adoc:150 ../term-utils/scriptlive.1.adoc:50
6670 #: ../term-utils/scriptreplay.1.adoc:67 ../text-utils/colcrt.1.adoc:83
6671 #: ../text-utils/column.1.adoc:209 ../text-utils/hexdump.1.adoc:232
6676 #. type: Labeled list
6677 #: ../disk-utils/sfdisk.8.adoc:428
6679 msgid "*sfdisk --list --label-nested=mbr /dev/sda*"
6683 #: ../disk-utils/sfdisk.8.adoc:430
6684 msgid "Print protective MBR on device with GPT disk label."
6687 #. type: Labeled list
6688 #: ../disk-utils/sfdisk.8.adoc:431
6690 msgid "*echo -e ',10M,L\\n,10M,L\\n,+,\\n' | sfdisk /dev/sdc*"
6694 #: ../disk-utils/sfdisk.8.adoc:433
6696 "Create three Linux partitions, with the default start, the size of the first "
6697 "two partitions is 10MiB, and the last partition fills all available space on "
6701 #. type: Labeled list
6702 #: ../disk-utils/sfdisk.8.adoc:434
6704 msgid "*echo -e 'size=10M, type=L\\n size=10M, type=L\\n size=+\\n' | sfdisk /dev/sdc*"
6708 #: ../disk-utils/sfdisk.8.adoc:436
6709 msgid "The same as the previous example, but in named-fields format."
6712 #. type: Labeled list
6713 #: ../disk-utils/sfdisk.8.adoc:437
6715 msgid "*echo -e 'type=swap' | sfdisk -N 3 /dev/sdc*"
6719 #: ../disk-utils/sfdisk.8.adoc:439
6720 msgid "Set type of the 3rd partition to 'swap'."
6723 #. type: Labeled list
6724 #: ../disk-utils/sfdisk.8.adoc:440
6726 msgid "*sfdisk --part-type /dev/sdc 3 swap*"
6730 #: ../disk-utils/sfdisk.8.adoc:442
6731 msgid "The same as the previous example, but without script use."
6734 #. type: Labeled list
6735 #: ../disk-utils/sfdisk.8.adoc:443
6737 msgid "*sfdisk --delete /dev/sdc 2*"
6741 #: ../disk-utils/sfdisk.8.adoc:445
6742 msgid "Delete 2nd partition."
6745 #. type: Labeled list
6746 #: ../disk-utils/sfdisk.8.adoc:446
6748 msgid "*echo \"\\+,+\" | sfdisk -N 3 --move-data /dev/sdc*"
6752 #: ../disk-utils/sfdisk.8.adoc:448
6754 "Enlarge 3rd partition in both directions, move start to use free space "
6755 "before the partition and enlarge the size to use all free space after to the "
6756 "partition, and move partition data too."
6760 #: ../disk-utils/sfdisk.8.adoc:454
6762 "The current *sfdisk* implementation is based on the original *sfdisk* from "
6763 "Andries E. Brouwer."
6767 #: ../disk-utils/sfdisk.8.adoc:462
6777 #. Copyright 2010 Jason Borden <jborden@bluehost.com>
6778 #. This file may be copied under the terms of the GNU Public License.
6780 #: ../disk-utils/swaplabel.8.adoc:6
6782 msgid "swaplabel(8)"
6786 #: ../disk-utils/swaplabel.8.adoc:16
6787 msgid "swaplabel - print or change the label or UUID of a swap area"
6791 #: ../disk-utils/swaplabel.8.adoc:20
6793 msgid "*swaplabel* [*-L* _label_] [*-U* _UUID_] _device_\n"
6797 #: ../disk-utils/swaplabel.8.adoc:24
6799 msgid "*swaplabel* will display or change the label or UUID of a swap partition located on _device_ (or regular file).\n"
6803 #: ../disk-utils/swaplabel.8.adoc:26
6805 "If the optional arguments *-L* and *-U* are not given, *swaplabel* will "
6806 "simply display the current swap-area label and UUID of _device_."
6810 #: ../disk-utils/swaplabel.8.adoc:28
6812 "If an optional argument is present, then *swaplabel* will change the "
6813 "appropriate value on _device_. These values can also be set during swap "
6814 "creation using *mkswap*(8). The *swaplabel* utility allows changing the "
6815 "label or UUID on an actively used swap device."
6819 #: ../disk-utils/swaplabel.8.adoc:35
6821 "Specify a new _label_ for the device. Swap partition labels can be at most "
6822 "16 characters long. If _label_ is longer than 16 characters, *swaplabel* "
6823 "will truncate it and print a warning message."
6827 #: ../disk-utils/swaplabel.8.adoc:38
6829 "Specify a new _UUID_ for the device. The _UUID_ must be in the standard "
6830 "8-4-4-4-12 character format, such as is output by *uuidgen*(1)."
6834 #: ../disk-utils/swaplabel.8.adoc:47
6836 msgid "*swaplabel* was written by mailto:jborden@bluehost.com[Jason Borden] and mailto:kzak@redhat.com[Karel Zak].\n"
6840 #: ../disk-utils/swaplabel.8.adoc:53
6855 #. terminal-colors.d.5 --
6856 #. Copyright 2014 Ondrej Oprala <ooprala@redhat.com>
6857 #. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
6858 #. Copyright 2014 Red Hat, Inc.
6859 #. May be distributed under the GNU General Public License
6861 #: ../lib/terminal-colors.d.5.adoc:10
6863 #| msgid "_/etc/terminal-colors.d/disable_"
6864 msgid "terminal-colors.d(5)"
6865 msgstr "_/etc/terminal-colors.d/disable_"
6867 #. type: Attribute :man manual:
6868 #: ../lib/terminal-colors.d.5.adoc:12 ../login-utils/utmpdump.1.adoc:61
6869 #: ../sys-utils/adjtime_config.5.adoc:4 ../sys-utils/fstab.5.adoc:38
6871 msgid "File formats"
6872 msgstr "Formáty souborů"
6875 #: ../lib/terminal-colors.d.5.adoc:20
6876 msgid "terminal-colors.d - configure output colorization for various utilities"
6880 #: ../lib/terminal-colors.d.5.adoc:24
6882 #| msgid "_/etc/terminal-colors.d/disable_"
6883 msgid "/etc/terminal-colors.d/_[[name][@term].][type]_"
6884 msgstr "_/etc/terminal-colors.d/disable_"
6887 #: ../lib/terminal-colors.d.5.adoc:28
6889 "Files in this directory determine the default behavior for utilities when "
6894 #: ../lib/terminal-colors.d.5.adoc:30
6896 "The _name_ is a utility name. The name is optional and when none is "
6897 "specified then the file is used for all unspecified utilities."
6901 #: ../lib/terminal-colors.d.5.adoc:32
6903 "The _term_ is a terminal identifier (the *TERM* environment variable). The "
6904 "terminal identifier is optional and when none is specified then the file is "
6905 "used for all unspecified terminals."
6909 #: ../lib/terminal-colors.d.5.adoc:34
6910 msgid "The _type_ is a file type. Supported file types are:"
6913 #. type: Labeled list
6914 #: ../lib/terminal-colors.d.5.adoc:35 ../sys-utils/rtcwake.8.adoc:87
6920 #: ../lib/terminal-colors.d.5.adoc:37
6921 msgid "Turns off output colorization for all compatible utilities."
6924 #. type: Labeled list
6925 #: ../lib/terminal-colors.d.5.adoc:38
6931 #: ../lib/terminal-colors.d.5.adoc:40
6932 msgid "Turns on output colorization; any matching *disable* files are ignored."
6935 #. type: Labeled list
6936 #: ../lib/terminal-colors.d.5.adoc:41
6942 #: ../lib/terminal-colors.d.5.adoc:43
6944 "Specifies colors used for output. The file format may be specific to the "
6945 "utility, the default format is described below."
6949 #: ../lib/terminal-colors.d.5.adoc:45
6951 "If there are more files that match for a utility, then the file with the "
6952 "more specific filename wins. For example, the filename \"@xterm.scheme\" has "
6953 "less priority than \"dmesg@xterm.scheme\". The lowest priority are those "
6954 "files without a utility name and terminal identifier (e.g., \"disable\")."
6958 #: ../lib/terminal-colors.d.5.adoc:48
6960 msgid "DEFAULT SCHEME FILES FORMAT"
6964 #: ../lib/terminal-colors.d.5.adoc:51
6965 msgid "The following statement is recognized:"
6968 #. type: delimited block _
6969 #: ../lib/terminal-colors.d.5.adoc:54
6971 msgid "*name color-sequence*\n"
6975 #: ../lib/terminal-colors.d.5.adoc:57
6977 "The *name* is a logical name of color sequence (for example \"error\"). The "
6978 "names are specific to the utilities. For more details always see the "
6979 "*COLORS* section in the man page for the utility."
6983 #: ../lib/terminal-colors.d.5.adoc:59
6985 "The *color-sequence* is a color name, ASCII color sequences or escape "
6990 #: ../lib/terminal-colors.d.5.adoc:60
6996 #: ../lib/terminal-colors.d.5.adoc:63
6998 "black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
6999 "lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
7000 "magenta, red, reset, reverse, and yellow."
7004 #: ../lib/terminal-colors.d.5.adoc:64
7006 msgid "ANSI color sequences"
7010 #: ../lib/terminal-colors.d.5.adoc:67
7012 "The color sequences are composed of sequences of numbers separated by "
7013 "semicolons. The most common codes are:"
7017 #: ../lib/terminal-colors.d.5.adoc:91
7020 "|0 |to restore default color\n"
7021 "|1 |for brighter colors\n"
7022 "|4 |for underlined text\n"
7023 "|5 |for flashing text\n"
7024 "|30 |for black foreground\n"
7025 "|31 |for red foreground\n"
7026 "|32 |for green foreground\n"
7027 "|33 |for yellow (or brown) foreground\n"
7028 "|34 |for blue foreground\n"
7029 "|35 |for purple foreground\n"
7030 "|36 |for cyan foreground\n"
7031 "|37 |for white (or gray) foreground\n"
7032 "|40 |for black background\n"
7033 "|41 |for red background\n"
7034 "|42 |for green background\n"
7035 "|43 |for yellow (or brown) background\n"
7036 "|44 |for blue background\n"
7037 "|45 |for purple background\n"
7038 "|46 |for cyan background\n"
7039 "|47 |for white (or gray) background\n"
7043 #: ../lib/terminal-colors.d.5.adoc:94
7045 msgid "Escape sequences"
7048 #. type: delimited block _
7049 #: ../lib/terminal-colors.d.5.adoc:97
7051 "To specify control or blank characters in the color sequences, C-style \\-"
7052 "escaped notation can be used:"
7056 #: ../lib/terminal-colors.d.5.adoc:114
7059 "|*\\a* |Bell (ASCII 7)\n"
7060 "|*\\b* |Backspace (ASCII 8)\n"
7061 "|*\\e* |Escape (ASCII 27)\n"
7062 "|*\\f* |Form feed (ASCII 12)\n"
7063 "|*\\n* |Newline (ASCII 10)\n"
7064 "|*\\r* |Carriage Return (ASCII 13)\n"
7065 "|*\\t* |Tab (ASCII 9)\n"
7066 "|*\\v* |Vertical Tab (ASCII 11)\n"
7067 "|*\\?* |Delete (ASCII 127)\n"
7069 "|*\\\\* |Backslash (\\)\n"
7070 "|*\\^* |Caret (^)\n"
7071 "|*\\#* |Hash mark (#)\n"
7074 #. type: delimited block _
7075 #: ../lib/terminal-colors.d.5.adoc:118
7077 "Please note that escapes are necessary to enter a space, backslash, caret, "
7078 "or any control character anywhere in the string, as well as a hash mark as "
7079 "the first character."
7082 #. type: delimited block _
7083 #: ../lib/terminal-colors.d.5.adoc:120
7085 "For example, to use a red background for alert messages in the output of "
7090 #: ../lib/terminal-colors.d.5.adoc:123
7092 msgid "*echo 'alert 37;41' >> /etc/terminal-colors.d/dmesg.scheme*\n"
7096 #: ../lib/terminal-colors.d.5.adoc:125
7098 #| msgid "*comment*"
7102 #. type: delimited block _
7103 #: ../lib/terminal-colors.d.5.adoc:128
7105 "Lines where the first non-blank character is a # (hash) are ignored. Any "
7106 "other use of the hash character is not interpreted as introducing a comment."
7109 #. type: Labeled list
7110 #: ../lib/terminal-colors.d.5.adoc:131
7112 msgid "*TERMINAL_COLORS_DEBUG*=all"
7116 #: ../lib/terminal-colors.d.5.adoc:133 ../misc-utils/whereis.1.adoc:116
7117 #: ../sys-utils/losetup.8.adoc:135
7118 msgid "enables debug output."
7121 #. type: delimited block _
7122 #: ../lib/terminal-colors.d.5.adoc:137
7123 msgid "_$XDG_CONFIG_HOME/terminal-colors.d_"
7126 #. type: delimited block _
7127 #: ../lib/terminal-colors.d.5.adoc:139
7129 #| msgid "_/etc/terminal-colors.d/disable_"
7130 msgid "_$HOME/.config/terminal-colors.d_"
7131 msgstr "_/etc/terminal-colors.d/disable_"
7133 #. type: delimited block _
7134 #: ../lib/terminal-colors.d.5.adoc:141
7136 #| msgid "_/etc/terminal-colors.d/disable_"
7137 msgid "_/etc/terminal-colors.d_"
7138 msgstr "_/etc/terminal-colors.d/disable_"
7140 #. type: delimited block _
7141 #: ../lib/terminal-colors.d.5.adoc:145
7142 msgid "Disable colors for all compatible utilities:"
7146 #: ../lib/terminal-colors.d.5.adoc:148 ../lib/terminal-colors.d.5.adoc:160
7148 #| msgid "_/etc/terminal-colors.d/disable_"
7149 msgid "*touch /etc/terminal-colors.d/disable*\n"
7150 msgstr "_/etc/terminal-colors.d/disable_"
7152 #. type: delimited block _
7153 #: ../lib/terminal-colors.d.5.adoc:151
7154 msgid "Disable colors for all compatible utils on a vt100 terminal:"
7158 #: ../lib/terminal-colors.d.5.adoc:154
7160 #| msgid "_/etc/terminal-colors.d/disable_"
7161 msgid "*touch /etc/terminal-colors.d/@vt100.disable*\n"
7162 msgstr "_/etc/terminal-colors.d/disable_"
7164 #. type: delimited block _
7165 #: ../lib/terminal-colors.d.5.adoc:157
7166 msgid "Disable colors for all compatible utils except *dmesg*(1):"
7170 #: ../lib/terminal-colors.d.5.adoc:162
7172 #| msgid "_/etc/terminal-colors.d/disable_"
7173 msgid "*touch /etc/terminal-colors.d/dmesg.enable*\n"
7174 msgstr "_/etc/terminal-colors.d/disable_"
7177 #: ../lib/terminal-colors.d.5.adoc:164 ../misc-utils/getopt.1.adoc:112
7178 #: ../term-utils/setterm.1.adoc:159
7180 #| msgid "AVAILABILITY"
7181 msgid "COMPATIBILITY"
7184 #. type: delimited block _
7185 #: ../lib/terminal-colors.d.5.adoc:167
7187 "The *terminal-colors.d* functionality is currently supported by all util-"
7188 "linux utilities which provides colorized output. For more details always see "
7189 "the *COLORS* section in the man page for the utility."
7192 #. Copyright 2001 Andreas Dilger (adilger@turbolinux.com)
7193 #. This man page was created for libblkid.so.1.0 from e2fsprogs-1.24.
7194 #. This file may be copied under the terms of the GNU Lesser General Public License.
7195 #. Created Wed Sep 14 12:02:12 2001, Andreas Dilger
7197 #: ../libblkid/libblkid.3.adoc:8
7202 #. type: Attribute :man manual:
7203 #: ../libblkid/libblkid.3.adoc:10 ../libuuid/man/uuid.3.adoc:35
7204 #: ../libuuid/man/uuid_clear.3.adoc:35 ../libuuid/man/uuid_compare.3.adoc:35
7205 #: ../libuuid/man/uuid_copy.3.adoc:35 ../libuuid/man/uuid_generate.3.adoc:37
7206 #: ../libuuid/man/uuid_is_null.3.adoc:35 ../libuuid/man/uuid_parse.3.adoc:35
7207 #: ../libuuid/man/uuid_time.3.adoc:35 ../libuuid/man/uuid_unparse.3.adoc:35
7209 msgid "Programmer's Manual"
7213 #: ../libblkid/libblkid.3.adoc:19
7214 msgid "libblkid - block device identification library"
7218 #: ../libblkid/libblkid.3.adoc:23
7220 msgid "*#include <blkid.h>*\n"
7224 #: ../libblkid/libblkid.3.adoc:25
7226 msgid "*cc* _file.c_ *-lblkid*\n"
7230 #: ../libblkid/libblkid.3.adoc:29
7232 "The *libblkid* library is used to identify block devices (disks) as to their "
7233 "content (e.g., filesystem type) as well as extracting additional information "
7234 "such as filesystem labels/volume names, unique identifiers/serial numbers. A "
7235 "common use is to allow use of *LABEL=* and *UUID=* tags instead of hard-"
7236 "coding specific block device names into configuration files. See list of all "
7237 "available tags in *TAGS* section."
7241 #: ../libblkid/libblkid.3.adoc:31
7243 "The low-level part of the library also allows the extraction of information "
7244 "about partitions and block device topology."
7248 #: ../libblkid/libblkid.3.adoc:33
7250 "The high-level part of the library keeps information about block devices in "
7251 "a cache file and is verified to still be valid before being returned to the "
7252 "user (if the user has read permission on the raw block device, otherwise "
7253 "not). The cache file also allows unprivileged users (normally anyone other "
7254 "than root, or those not in the \"disk\" group) to locate devices by label/"
7255 "id. The standard location of the cache file can be overridden by the "
7256 "environment variable *BLKID_FILE*."
7260 #: ../libblkid/libblkid.3.adoc:35
7262 "In situations where one is getting information about a single known device, "
7263 "it does not impact performance whether the cache is used or not (unless you "
7264 "are not able to read the block device directly)."
7268 #: ../libblkid/libblkid.3.adoc:37
7270 "The high-level part of the library supports two methods to determine *LABEL/"
7271 "UUID*. It reads information directly from a block device or reads "
7272 "information from /dev/disk/by-* udev symlinks. The udev is preferred method "
7277 #: ../libblkid/libblkid.3.adoc:39
7279 "If you are dealing with multiple devices, use of the cache is highly "
7280 "recommended (even if empty) as devices will be scanned at most one time and "
7281 "the on-disk cache will be updated if possible."
7285 #: ../libblkid/libblkid.3.adoc:41
7287 "In some cases (modular kernels), block devices are not even visible until "
7288 "after they are accessed the first time, so it is critical that there is some "
7289 "way to locate these devices without enumerating only visible devices, so the "
7290 "use of the cache file is *required* in this situation."
7294 #: ../libblkid/libblkid.3.adoc:42 ../misc-utils/blkid.8.adoc:158
7296 #| msgid "CONFIG FILES"
7297 msgid "CONFIGURATION FILE"
7298 msgstr "KONFIGURAČNÍ SOUBORY"
7301 #: ../libblkid/libblkid.3.adoc:45
7303 "The standard location of the _/etc/blkid.conf_ config file can be overridden "
7304 "by the environment variable *BLKID_CONF*. For more details about the config "
7305 "file see *blkid*(8) man page."
7309 #: ../libblkid/libblkid.3.adoc:46
7315 #: ../libblkid/libblkid.3.adoc:49
7317 "All available tags are listed below. Not all tags are supported for all file "
7318 "systems. To enable a tag, set one of the following flags with "
7319 "*blkid_probe_set_superblocks_flags*():"
7322 #. type: Labeled list
7323 #: ../libblkid/libblkid.3.adoc:50
7325 msgid "BLKID_SUBLKS_TYPE"
7329 #: ../libblkid/libblkid.3.adoc:53
7330 msgid "TYPE - filesystem type"
7333 #. type: Labeled list
7334 #: ../libblkid/libblkid.3.adoc:54
7336 msgid "BLKID_SUBLKS_SECTYPE"
7340 #: ../libblkid/libblkid.3.adoc:57
7341 msgid "SEC_TYPE - secondary filesystem type"
7344 #. type: Labeled list
7345 #: ../libblkid/libblkid.3.adoc:58
7347 msgid "BLKID_SUBLKS_LABEL"
7351 #: ../libblkid/libblkid.3.adoc:61
7352 msgid "LABEL - filesystem label"
7355 #. type: Labeled list
7356 #: ../libblkid/libblkid.3.adoc:62
7358 msgid "BLKID_SUBLKS_LABELRAW"
7362 #: ../libblkid/libblkid.3.adoc:65
7363 msgid "LABEL_RAW - raw label from FS superblock"
7366 #. type: Labeled list
7367 #: ../libblkid/libblkid.3.adoc:66
7369 msgid "BLKID_SUBLKS_UUID"
7373 #: ../libblkid/libblkid.3.adoc:69
7374 msgid "UUID - filesystem UUID (lower case)"
7378 #: ../libblkid/libblkid.3.adoc:71
7379 msgid "UUID_SUB - subvolume uuid (e.g. btrfs)"
7383 #: ../libblkid/libblkid.3.adoc:73
7384 msgid "LOGUUID - external log UUID (e.g. xfs)"
7387 #. type: Labeled list
7388 #: ../libblkid/libblkid.3.adoc:74
7390 msgid "BLKID_SUBLKS_UUIDRAW"
7394 #: ../libblkid/libblkid.3.adoc:77
7395 msgid "UUID_RAW - raw UUID from FS superblock"
7398 #. type: Labeled list
7399 #: ../libblkid/libblkid.3.adoc:78
7401 msgid "BLKID_SUBLKS_USAGE"
7405 #: ../libblkid/libblkid.3.adoc:81
7406 msgid "USAGE - usage string: \"raid\", \"filesystem\", etc."
7409 #. type: Labeled list
7410 #: ../libblkid/libblkid.3.adoc:82
7412 msgid "BLKID_SUBLKS_VERSION"
7416 #: ../libblkid/libblkid.3.adoc:85
7417 msgid "VERSION - filesystem version"
7420 #. type: Labeled list
7421 #: ../libblkid/libblkid.3.adoc:86
7423 msgid "BLKID_SUBLKS_MAGIC"
7427 #: ../libblkid/libblkid.3.adoc:89
7428 msgid "SBMAGIC - super block magic string"
7432 #: ../libblkid/libblkid.3.adoc:91
7433 msgid "SBMAGIC_OFFSET - offset of SBMAGIC"
7436 #. type: Labeled list
7437 #: ../libblkid/libblkid.3.adoc:92
7439 msgid "BLKID_SUBLKS_FSINFO"
7443 #: ../libblkid/libblkid.3.adoc:98
7445 "FSSIZE - size of filesystem. Note that for XFS this will return the same "
7446 "value as lsblk (without XFS's metadata), but for ext4 it will return the "
7447 "size with metadata and for BTRFS will not count overhead of RAID "
7448 "configuration (redundant data)."
7452 #: ../libblkid/libblkid.3.adoc:100
7453 msgid "FSLASTBLOCK - last fsblock/total number of fsblocks"
7457 #: ../libblkid/libblkid.3.adoc:102
7458 msgid "FSBLOCKSIZE - file system block size"
7461 #. type: Labeled list
7462 #: ../libblkid/libblkid.3.adoc:103
7464 msgid "The following tags are always enabled"
7468 #: ../libblkid/libblkid.3.adoc:106
7469 msgid "BLOCK_SIZE - minimal block size accessible by file system"
7473 #: ../libblkid/libblkid.3.adoc:108
7474 msgid "MOUNT - cluster mount name (ocfs only)"
7478 #: ../libblkid/libblkid.3.adoc:110
7479 msgid "EXT_JOURNAL - external journal UUID"
7483 #: ../libblkid/libblkid.3.adoc:112
7484 msgid "SYSTEM_ID - ISO9660 system identifier"
7488 #: ../libblkid/libblkid.3.adoc:114
7489 msgid "VOLUME_SET_ID - ISO9660 volume set identifier"
7493 #: ../libblkid/libblkid.3.adoc:116
7494 msgid "DATA_PREPARER_ID - ISO9660 data identifier"
7498 #: ../libblkid/libblkid.3.adoc:118
7499 msgid "PUBLISHER_ID - ISO9660 publisher identifier"
7503 #: ../libblkid/libblkid.3.adoc:120
7504 msgid "APPLICATION_ID - ISO9660 application identifier"
7508 #: ../libblkid/libblkid.3.adoc:122
7509 msgid "BOOT_SYSTEM_ID - ISO9660 boot system identifier"
7513 #: ../libblkid/libblkid.3.adoc:126
7515 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"
7519 #: ../libblkid/libblkid.3.adoc:128
7520 msgid "The low-level probing code was rewritten by Karel Zak."
7524 #: ../libblkid/libblkid.3.adoc:129
7530 #: ../libblkid/libblkid.3.adoc:132
7532 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"
7536 #: ../libblkid/libblkid.3.adoc:137 ../misc-utils/wipefs.8.adoc:107
7546 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7547 #. Redistribution and use in source and binary forms, with or without
7548 #. modification, are permitted provided that the following conditions
7550 #. 1. Redistributions of source code must retain the above copyright
7551 #. notice, and the entire permission notice in its entirety,
7552 #. including the disclaimer of warranties.
7553 #. 2. Redistributions in binary form must reproduce the above copyright
7554 #. notice, this list of conditions and the following disclaimer in the
7555 #. documentation and/or other materials provided with the distribution.
7556 #. 3. The name of the author may not be used to endorse or promote
7557 #. products derived from this software without specific prior
7558 #. written permission.
7559 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7560 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7561 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7562 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7563 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7564 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7565 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7566 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7567 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7568 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7569 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7571 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7573 #: ../libuuid/man/uuid.3.adoc:33
7579 #: ../libuuid/man/uuid.3.adoc:44
7580 msgid "uuid - DCE compatible Universally Unique Identifier library"
7584 #: ../libuuid/man/uuid.3.adoc:48 ../libuuid/man/uuid_clear.3.adoc:48
7585 #: ../libuuid/man/uuid_compare.3.adoc:48 ../libuuid/man/uuid_copy.3.adoc:48
7586 #: ../libuuid/man/uuid_generate.3.adoc:50 ../libuuid/man/uuid_is_null.3.adoc:48
7587 #: ../libuuid/man/uuid_parse.3.adoc:48 ../libuuid/man/uuid_time.3.adoc:48
7588 #: ../libuuid/man/uuid_unparse.3.adoc:48
7590 msgid "*#include <uuid.h>*\n"
7594 #: ../libuuid/man/uuid.3.adoc:52
7596 "The UUID library is used to generate unique identifiers for objects that may "
7597 "be accessible beyond the local system. This library generates UUIDs "
7598 "compatible with those created by the Open Software Foundation (OSF) "
7599 "Distributed Computing Environment (DCE) utility *uuidgen*(1)."
7603 #: ../libuuid/man/uuid.3.adoc:54
7605 "The UUIDs generated by this library can be reasonably expected to be unique "
7606 "within a system, and unique across all systems. They could be used, for "
7607 "instance, to generate unique HTTP cookies across multiple web servers "
7608 "without communication between the servers, and without fear of a name clash."
7612 #: ../libuuid/man/uuid.3.adoc:55 ../libuuid/man/uuid_generate.3.adoc:76
7613 #: ../libuuid/man/uuid_parse.3.adoc:62 ../libuuid/man/uuid_unparse.3.adoc:59
7614 #: ../misc-utils/logger.1.adoc:229 ../misc-utils/uuidgen.1.adoc:57
7615 #: ../sys-utils/ipcs.1.adoc:76 ../text-utils/col.1.adoc:86
7616 #: ../text-utils/hexdump.1.adoc:228
7618 msgid "CONFORMING TO"
7622 #: ../libuuid/man/uuid.3.adoc:58 ../libuuid/man/uuid_generate.3.adoc:79
7624 "This library generates UUIDs compatible with OSF DCE 1.1, and hash based "
7625 "UUIDs V3 and V5 compatible with link:https://tools.ietf.org/html/"
7626 "rfc4122[RFC-4122]."
7630 #: ../libuuid/man/uuid.3.adoc:62 ../libuuid/man/uuid_clear.3.adoc:58
7631 #: ../libuuid/man/uuid_compare.3.adoc:62 ../libuuid/man/uuid_copy.3.adoc:62
7632 #: ../libuuid/man/uuid_generate.3.adoc:83 ../libuuid/man/uuid_is_null.3.adoc:58
7633 #: ../libuuid/man/uuid_parse.3.adoc:69 ../libuuid/man/uuid_time.3.adoc:62
7634 #: ../libuuid/man/uuid_unparse.3.adoc:66
7635 msgid "Theodore Y. Ts'o"
7639 #: ../libuuid/man/uuid.3.adoc:73
7642 "*uuid_clear*(3),\n"
7643 "*uuid_compare*(3),\n"
7645 "*uuid_generate*(3),\n"
7646 "*uuid_is_null*(3),\n"
7647 "*uuid_parse*(3),\n"
7649 "*uuid_unparse*(3)\n"
7655 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7656 #. Redistribution and use in source and binary forms, with or without
7657 #. modification, are permitted provided that the following conditions
7659 #. 1. Redistributions of source code must retain the above copyright
7660 #. notice, and the entire permission notice in its entirety,
7661 #. including the disclaimer of warranties.
7662 #. 2. Redistributions in binary form must reproduce the above copyright
7663 #. notice, this list of conditions and the following disclaimer in the
7664 #. documentation and/or other materials provided with the distribution.
7665 #. 3. The name of the author may not be used to endorse or promote
7666 #. products derived from this software without specific prior
7667 #. written permission.
7668 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7669 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7670 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7671 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7672 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7673 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7674 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7675 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7676 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7677 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7678 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7680 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7682 #: ../libuuid/man/uuid_clear.3.adoc:33
7684 msgid "uuid_clear(3)"
7688 #: ../libuuid/man/uuid_clear.3.adoc:44
7689 msgid "uuid_clear - reset value of UUID variable to the NULL value"
7693 #: ../libuuid/man/uuid_clear.3.adoc:50
7695 msgid "*void uuid_clear(uuid_t __uu__);*\n"
7699 #: ../libuuid/man/uuid_clear.3.adoc:54
7701 "The *uuid_clear*() function sets the value of the supplied uuid variable "
7702 "_uu_ to the NULL value."
7706 #: ../libuuid/man/uuid_clear.3.adoc:68
7710 "*uuid_compare*(3),\n"
7712 "*uuid_generate*(3),\n"
7713 "*uuid_is_null*(3),\n"
7714 "*uuid_parse*(3),\n"
7715 "*uuid_unparse*(3)\n"
7721 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7722 #. Redistribution and use in source and binary forms, with or without
7723 #. modification, are permitted provided that the following conditions
7725 #. 1. Redistributions of source code must retain the above copyright
7726 #. notice, and the entire permission notice in its entirety,
7727 #. including the disclaimer of warranties.
7728 #. 2. Redistributions in binary form must reproduce the above copyright
7729 #. notice, this list of conditions and the following disclaimer in the
7730 #. documentation and/or other materials provided with the distribution.
7731 #. 3. The name of the author may not be used to endorse or promote
7732 #. products derived from this software without specific prior
7733 #. written permission.
7734 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7735 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7736 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7737 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7738 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7739 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7740 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7741 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7742 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7743 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7744 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7746 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7748 #: ../libuuid/man/uuid_compare.3.adoc:33
7750 msgid "uuid_compare(3)"
7754 #: ../libuuid/man/uuid_compare.3.adoc:44
7755 msgid "uuid_compare - compare whether two UUIDs are the same"
7759 #: ../libuuid/man/uuid_compare.3.adoc:50
7761 msgid "*int uuid_compare(uuid_t __uu1__, uuid_t __uu2__)*\n"
7765 #: ../libuuid/man/uuid_compare.3.adoc:54
7767 "The *uuid_compare*() function compares the two supplied uuid variables _uu1_ "
7768 "and _uu2_ to each other."
7772 #: ../libuuid/man/uuid_compare.3.adoc:55 ../libuuid/man/uuid_copy.3.adoc:55
7773 #: ../libuuid/man/uuid_generate.3.adoc:72 ../libuuid/man/uuid_parse.3.adoc:58
7774 #: ../libuuid/man/uuid_time.3.adoc:55 ../schedutils/taskset.1.adoc:108
7776 msgid "RETURN VALUE"
7780 #: ../libuuid/man/uuid_compare.3.adoc:58
7782 "Returns an integer less than, equal to, or greater than zero if _uu1_ is "
7783 "found, respectively, to be lexicographically less than, equal, or greater "
7788 #: ../libuuid/man/uuid_compare.3.adoc:72
7792 "*uuid_clear*(3),\n"
7794 "*uuid_generate*(3),\n"
7795 "*uuid_is_null*(3),\n"
7796 "*uuid_parse*(3),\n"
7797 "*uuid_unparse*(3)\n"
7803 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7804 #. Redistribution and use in source and binary forms, with or without
7805 #. modification, are permitted provided that the following conditions
7807 #. 1. Redistributions of source code must retain the above copyright
7808 #. notice, and the entire permission notice in its entirety,
7809 #. including the disclaimer of warranties.
7810 #. 2. Redistributions in binary form must reproduce the above copyright
7811 #. notice, this list of conditions and the following disclaimer in the
7812 #. documentation and/or other materials provided with the distribution.
7813 #. 3. The name of the author may not be used to endorse or promote
7814 #. products derived from this software without specific prior
7815 #. written permission.
7816 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7817 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7818 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7819 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7820 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7821 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7822 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7823 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7824 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7825 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7826 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7828 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7830 #: ../libuuid/man/uuid_copy.3.adoc:33
7832 msgid "uuid_copy(3)"
7836 #: ../libuuid/man/uuid_copy.3.adoc:44
7837 msgid "uuid_copy - copy a UUID value"
7841 #: ../libuuid/man/uuid_copy.3.adoc:50
7843 msgid "*void uuid_copy(uuid_t __dst__, uuid_t __src__);*\n"
7847 #: ../libuuid/man/uuid_copy.3.adoc:54
7848 msgid "The *uuid_copy*() function copies the UUID variable _src_ to _dst_."
7852 #: ../libuuid/man/uuid_copy.3.adoc:58
7853 msgid "The copied UUID is returned in the location pointed to by _dst_."
7857 #: ../libuuid/man/uuid_copy.3.adoc:72
7861 "*uuid_clear*(3),\n"
7862 "*uuid_compare*(3),\n"
7863 "*uuid_generate*(3),\n"
7864 "*uuid_is_null*(3),\n"
7865 "*uuid_parse*(3),\n"
7866 "*uuid_unparse*(3)\n"
7872 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7874 #. Redistribution and use in source and binary forms, with or without
7875 #. modification, are permitted provided that the following conditions
7877 #. 1. Redistributions of source code must retain the above copyright
7878 #. notice, and the entire permission notice in its entirety,
7879 #. including the disclaimer of warranties.
7880 #. 2. Redistributions in binary form must reproduce the above copyright
7881 #. notice, this list of conditions and the following disclaimer in the
7882 #. documentation and/or other materials provided with the distribution.
7883 #. 3. The name of the author may not be used to endorse or promote
7884 #. products derived from this software without specific prior
7885 #. written permission.
7886 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7887 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7888 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7889 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7890 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7891 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7892 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7893 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7894 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7895 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7896 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7899 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7901 #: ../libuuid/man/uuid_generate.3.adoc:35
7903 msgid "uuid_generate(3)"
7907 #: ../libuuid/man/uuid_generate.3.adoc:46
7909 "uuid_generate, uuid_generate_random, uuid_generate_time, "
7910 "uuid_generate_time_safe - create a new unique UUID value"
7914 #: ../libuuid/man/uuid_generate.3.adoc:57
7917 "*void uuid_generate(uuid_t __out__);* +\n"
7918 "*void uuid_generate_random(uuid_t __out__);* +\n"
7919 "*void uuid_generate_time(uuid_t __out__);* +\n"
7920 "*int uuid_generate_time_safe(uuid_t __out__);* +\n"
7921 "*void uuid_generate_md5(uuid_t __out__, const uuid_t __ns__, const char __*name__, size_t __len__);* +\n"
7922 "*void uuid_generate_sha1(uuid_t __out__, const uuid_t __ns__, const char __*name__, size_t __len__);*\n"
7926 #: ../libuuid/man/uuid_generate.3.adoc:61
7928 "The *uuid_generate*() function creates a new universally unique identifier "
7929 "(UUID). The uuid will be generated based on high-quality randomness from "
7930 "*getrandom*(2), _/dev/urandom_, or _/dev/random_ if available. If it is not "
7931 "available, then *uuid_generate*() will use an alternative algorithm which "
7932 "uses the current time, the local ethernet MAC address (if available), and "
7933 "random data generated using a pseudo-random generator."
7937 #: ../libuuid/man/uuid_generate.3.adoc:63
7939 "The *uuid_generate_random*() function forces the use of the all-random UUID "
7940 "format, even if a high-quality random number generator is not available, in "
7941 "which case a pseudo-random generator will be substituted. Note that the use "
7942 "of a pseudo-random generator may compromise the uniqueness of UUIDs "
7943 "generated in this fashion."
7947 #: ../libuuid/man/uuid_generate.3.adoc:65
7949 "The *uuid_generate_time*() function forces the use of the alternative "
7950 "algorithm which uses the current time and the local ethernet MAC address (if "
7951 "available). This algorithm used to be the default one used to generate "
7952 "UUIDs, but because of the use of the ethernet MAC address, it can leak "
7953 "information about when and where the UUID was generated. This can cause "
7954 "privacy problems in some applications, so the *uuid_generate*() function "
7955 "only uses this algorithm if a high-quality source of randomness is not "
7956 "available. To guarantee uniqueness of UUIDs generated by concurrently "
7957 "running processes, the uuid library uses a global clock state counter (if "
7958 "the process has permissions to gain exclusive access to this file) and/or "
7959 "the *uuidd*(8) daemon, if it is running already or can be spawned by the "
7960 "process (if installed and the process has enough permissions to run it). If "
7961 "neither of these two synchronization mechanisms can be used, it is "
7962 "theoretically possible that two concurrently running processes obtain the "
7963 "same UUID(s). To tell whether the UUID has been generated in a safe manner, "
7964 "use *uuid_generate_time_safe*."
7968 #: ../libuuid/man/uuid_generate.3.adoc:67
7970 "The *uuid_generate_time_safe*() function is similar to "
7971 "*uuid_generate_time*(), except that it returns a value which denotes whether "
7972 "any of the synchronization mechanisms (see above) has been used."
7976 #: ../libuuid/man/uuid_generate.3.adoc:69
7978 "The UUID is 16 bytes (128 bits) long, which gives approximately 3.4x10^38 "
7979 "unique values (there are approximately 10^80 elementary particles in the "
7980 "universe according to Carl Sagan's _Cosmos_). The new UUID can reasonably be "
7981 "considered unique among all UUIDs created on the local system, and among "
7982 "UUIDs created on other systems in the past and in the future."
7986 #: ../libuuid/man/uuid_generate.3.adoc:71
7988 "The *uuid_generate_md5*() and *uuid_generate_sha1*() functions generate an "
7989 "MD5 and SHA1 hashed (predictable) UUID based on a well-known UUID providing "
7990 "the namespace and an arbitrary binary string. The UUIDs conform to V3 and V5 "
7991 "UUIDs per link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
7995 #: ../libuuid/man/uuid_generate.3.adoc:75
7997 "The newly created UUID is returned in the memory location pointed to by "
7998 "_out_. *uuid_generate_time_safe*() returns zero if the UUID has been "
7999 "generated in a safe manner, -1 otherwise."
8003 #: ../libuuid/man/uuid_generate.3.adoc:96
8008 "*uuid_clear*(3),\n"
8009 "*uuid_compare*(3),\n"
8011 "*uuid_is_null*(3),\n"
8012 "*uuid_parse*(3),\n"
8014 "*uuid_unparse*(3),\n"
8021 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8022 #. Redistribution and use in source and binary forms, with or without
8023 #. modification, are permitted provided that the following conditions
8025 #. 1. Redistributions of source code must retain the above copyright
8026 #. notice, and the entire permission notice in its entirety,
8027 #. including the disclaimer of warranties.
8028 #. 2. Redistributions in binary form must reproduce the above copyright
8029 #. notice, this list of conditions and the following disclaimer in the
8030 #. documentation and/or other materials provided with the distribution.
8031 #. 3. The name of the author may not be used to endorse or promote
8032 #. products derived from this software without specific prior
8033 #. written permission.
8034 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8035 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8036 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8037 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8038 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8039 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8040 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8041 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8042 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8043 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8044 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8046 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8048 #: ../libuuid/man/uuid_is_null.3.adoc:33
8050 msgid "uuid_is_null(3)"
8054 #: ../libuuid/man/uuid_is_null.3.adoc:44
8055 msgid "uuid_is_null - compare the value of the UUID to the NULL value"
8059 #: ../libuuid/man/uuid_is_null.3.adoc:50
8061 msgid "*int uuid_is_null(uuid_t __uu__);*\n"
8065 #: ../libuuid/man/uuid_is_null.3.adoc:54
8067 "The *uuid_is_null*() function compares the value of the supplied UUID "
8068 "variable _uu_ to the NULL value. If the value is equal to the NULL UUID, 1 "
8069 "is returned, otherwise 0 is returned."
8073 #: ../libuuid/man/uuid_is_null.3.adoc:69
8077 "*uuid_clear*(3),\n"
8078 "*uuid_compare*(3),\n"
8080 "*uuid_generate*(3),\n"
8082 "*uuid_parse*(3),\n"
8083 "*uuid_unparse*(3)\n"
8089 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8090 #. Redistribution and use in source and binary forms, with or without
8091 #. modification, are permitted provided that the following conditions
8093 #. 1. Redistributions of source code must retain the above copyright
8094 #. notice, and the entire permission notice in its entirety,
8095 #. including the disclaimer of warranties.
8096 #. 2. Redistributions in binary form must reproduce the above copyright
8097 #. notice, this list of conditions and the following disclaimer in the
8098 #. documentation and/or other materials provided with the distribution.
8099 #. 3. The name of the author may not be used to endorse or promote
8100 #. products derived from this software without specific prior
8101 #. written permission.
8102 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8103 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8104 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8105 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8106 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8107 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8108 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8109 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8110 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8111 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8112 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8114 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8116 #: ../libuuid/man/uuid_parse.3.adoc:33
8118 msgid "uuid_parse(3)"
8122 #: ../libuuid/man/uuid_parse.3.adoc:44
8123 msgid "uuid_parse - convert an input UUID string into binary representation"
8127 #: ../libuuid/man/uuid_parse.3.adoc:51
8130 "*int uuid_parse(char *__in__, uuid_t __uu__);* +\n"
8131 "*int uuid_parse_range(char *__in_start__, char *__in_end__, uuid_t __uu__);*\n"
8135 #: ../libuuid/man/uuid_parse.3.adoc:55
8137 "The *uuid_parse*() function converts the UUID string given by _in_ into the "
8138 "binary representation. The input UUID is a string of the form "
8139 "1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in *printf*(3) format \"%08x-%04x-%04x-"
8140 "%04x-%012x\", 36 bytes plus the trailing '\\0')."
8144 #: ../libuuid/man/uuid_parse.3.adoc:57
8146 "The *uuid_parse_range*() function works like *uuid_parse*() but parses only "
8147 "range in string specified by _in_start_ and _in_end_ pointers."
8151 #: ../libuuid/man/uuid_parse.3.adoc:61
8153 "Upon successfully parsing the input string, 0 is returned, and the UUID is "
8154 "stored in the location pointed to by _uu_, otherwise -1 is returned."
8158 #: ../libuuid/man/uuid_parse.3.adoc:65
8160 "This library parses UUIDs compatible with OSF DCE 1.1, and hash based UUIDs "
8161 "V3 and V5 compatible with link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
8165 #: ../libuuid/man/uuid_parse.3.adoc:80
8169 "*uuid_clear*(3),\n"
8170 "*uuid_compare*(3),\n"
8172 "*uuid_generate*(3),\n"
8173 "*uuid_is_null*(3),\n"
8175 "*uuid_unparse*(3)\n"
8181 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8182 #. Redistribution and use in source and binary forms, with or without
8183 #. modification, are permitted provided that the following conditions
8185 #. 1. Redistributions of source code must retain the above copyright
8186 #. notice, and the entire permission notice in its entirety,
8187 #. including the disclaimer of warranties.
8188 #. 2. Redistributions in binary form must reproduce the above copyright
8189 #. notice, this list of conditions and the following disclaimer in the
8190 #. documentation and/or other materials provided with the distribution.
8191 #. 3. The name of the author may not be used to endorse or promote
8192 #. products derived from this software without specific prior
8193 #. written permission.
8194 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8195 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8196 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8197 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8198 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8199 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8200 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8201 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8202 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8203 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8204 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8206 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8208 #: ../libuuid/man/uuid_time.3.adoc:33
8210 msgid "uuid_time(3)"
8214 #: ../libuuid/man/uuid_time.3.adoc:44
8215 msgid "uuid_time - extract the time at which the UUID was created"
8219 #: ../libuuid/man/uuid_time.3.adoc:50
8221 msgid "*time_t uuid_time(uuid_t __uu__, struct timeval *__ret_tv__)*\n"
8225 #: ../libuuid/man/uuid_time.3.adoc:54
8227 "The *uuid_time*() function extracts the time at which the supplied time-"
8228 "based UUID _uu_ was created. Note that the UUID creation time is only "
8229 "encoded within certain types of UUIDs. This function can only reasonably "
8230 "expect to extract the creation time for UUIDs created with the "
8231 "*uuid_generate_time*(3) and *uuid_generate_time_safe*(3) functions. It may "
8232 "or may not work with UUIDs created by other mechanisms."
8236 #: ../libuuid/man/uuid_time.3.adoc:58
8238 "The time at which the UUID was created, in seconds since January 1, 1970 GMT "
8239 "(the epoch), is returned (see *time*(2)). The time at which the UUID was "
8240 "created, in seconds and microseconds since the epoch, is also stored in the "
8241 "location pointed to by _ret_tv_ (see *gettimeofday*(2))."
8245 #: ../libuuid/man/uuid_time.3.adoc:73
8249 "*uuid_clear*(3),\n"
8250 "*uuid_compare*(3),\n"
8252 "*uuid_generate*(3),\n"
8253 "*uuid_is_null*(3),\n"
8254 "*uuid_parse*(3),\n"
8255 "*uuid_unparse*(3)\n"
8261 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
8262 #. Redistribution and use in source and binary forms, with or without
8263 #. modification, are permitted provided that the following conditions
8265 #. 1. Redistributions of source code must retain the above copyright
8266 #. notice, and the entire permission notice in its entirety,
8267 #. including the disclaimer of warranties.
8268 #. 2. Redistributions in binary form must reproduce the above copyright
8269 #. notice, this list of conditions and the following disclaimer in the
8270 #. documentation and/or other materials provided with the distribution.
8271 #. 3. The name of the author may not be used to endorse or promote
8272 #. products derived from this software without specific prior
8273 #. written permission.
8274 #. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
8275 #. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
8276 #. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
8277 #. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
8278 #. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8279 #. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
8280 #. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
8281 #. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
8282 #. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
8283 #. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
8284 #. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
8286 #. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
8288 #: ../libuuid/man/uuid_unparse.3.adoc:33
8290 msgid "uuid_unparse(3)"
8294 #: ../libuuid/man/uuid_unparse.3.adoc:44
8295 msgid "uuid_unparse - convert a UUID from binary representation to a string"
8299 #: ../libuuid/man/uuid_unparse.3.adoc:52
8302 "*void uuid_unparse(uuid_t __uu__, char *__out__);* +\n"
8303 "*void uuid_unparse_upper(uuid_t __uu__, char *__out__);* +\n"
8304 "*void uuid_unparse_lower(uuid_t __uu__, char *__out__);*\n"
8308 #: ../libuuid/man/uuid_unparse.3.adoc:56
8310 "The *uuid_unparse*() function converts the supplied UUID _uu_ from the "
8311 "binary representation into a 36-byte string (plus trailing '\\0') of the "
8312 "form 1b4e28ba-2fa1-11d2-883f-0016d3cca427 and stores this value in the "
8313 "character string pointed to by _out_. The case of the hex digits returned by "
8314 "*uuid_unparse*() may be upper or lower case, and is dependent on the system-"
8315 "dependent local default."
8319 #: ../libuuid/man/uuid_unparse.3.adoc:58
8321 "If the case of the hex digits is important then the functions "
8322 "*uuid_unparse_upper*() and *uuid_unparse_lower*() may be used."
8326 #: ../libuuid/man/uuid_unparse.3.adoc:62
8327 msgid "This library unparses UUIDs compatible with OSF DCE 1.1."
8331 #: ../libuuid/man/uuid_unparse.3.adoc:77
8335 "*uuid_clear*(3),\n"
8336 "*uuid_compare*(3),\n"
8338 "*uuid_generate*(3),\n"
8340 "*uuid_is_null*(3),\n"
8345 #. chfn.1 -- change your finger information
8346 #. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
8347 #. This program is free software. You can redistribute it and
8348 #. modify it under the terms of the GNU General Public License.
8349 #. There is no warranty.
8351 #: ../login-utils/chfn.1.adoc:10
8356 #. type: Attribute :man manual:
8357 #: ../login-utils/chfn.1.adoc:12 ../login-utils/chsh.1.adoc:12
8358 #: ../login-utils/last.1.adoc:21 ../login-utils/login.1.adoc:8
8359 #: ../login-utils/lslogins.1.adoc:6 ../login-utils/newgrp.1.adoc:6
8360 #: ../login-utils/runuser.1.adoc:4 ../login-utils/su.1.adoc:4
8361 #: ../login-utils/utmpdump.1.adoc:21 ../misc-utils/cal.1.adoc:41
8362 #: ../misc-utils/enosys.1.adoc:4 ../misc-utils/exch.1.adoc:4
8363 #: ../misc-utils/fadvise.1.adoc:4 ../misc-utils/fincore.1.adoc:9
8364 #: ../misc-utils/getopt.1.adoc:4 ../misc-utils/hardlink.1.adoc:10
8365 #: ../misc-utils/kill.1.adoc:9 ../misc-utils/logger.1.adoc:38
8366 #: ../misc-utils/look.1.adoc:38 ../misc-utils/lsclocks.1.adoc:4
8367 #: ../misc-utils/lsfd.1.adoc:9 ../misc-utils/mcookie.1.adoc:6
8368 #: ../misc-utils/namei.1.adoc:4 ../misc-utils/pipesz.1.adoc:4
8369 #: ../misc-utils/rename.1.adoc:6 ../misc-utils/uuidgen.1.adoc:8
8370 #: ../misc-utils/uuidparse.1.adoc:6 ../misc-utils/waitpid.1.adoc:4
8371 #: ../misc-utils/whereis.1.adoc:38 ../schedutils/chrt.1.adoc:28
8372 #: ../schedutils/ionice.1.adoc:4 ../schedutils/taskset.1.adoc:26
8373 #: ../schedutils/uclampset.1.adoc:28 ../sys-utils/choom.1.adoc:4
8374 #: ../sys-utils/dmesg.1.adoc:8 ../sys-utils/eject.1.adoc:12
8375 #: ../sys-utils/fallocate.1.adoc:4 ../sys-utils/flock.1.adoc:28
8376 #: ../sys-utils/ipcmk.1.adoc:8 ../sys-utils/ipcrm.1.adoc:8
8377 #: ../sys-utils/ipcs.1.adoc:8 ../sys-utils/irqtop.1.adoc:4
8378 #: ../sys-utils/lscpu.1.adoc:4 ../sys-utils/lsipc.1.adoc:4
8379 #: ../sys-utils/lsirq.1.adoc:4 ../sys-utils/lsmem.1.adoc:4
8380 #: ../sys-utils/mountpoint.1.adoc:4 ../sys-utils/nsenter.1.adoc:4
8381 #: ../sys-utils/prlimit.1.adoc:9 ../sys-utils/renice.1.adoc:38
8382 #: ../sys-utils/setpriv.1.adoc:4 ../sys-utils/setsid.1.adoc:6
8383 #: ../sys-utils/unshare.1.adoc:4 ../term-utils/mesg.1.adoc:38
8384 #: ../term-utils/script.1.adoc:38 ../term-utils/scriptlive.1.adoc:4
8385 #: ../term-utils/scriptreplay.1.adoc:4 ../term-utils/setterm.1.adoc:11
8386 #: ../term-utils/wall.1.adoc:39 ../term-utils/write.1.adoc:41
8387 #: ../text-utils/col.1.adoc:41 ../text-utils/colcrt.1.adoc:38
8388 #: ../text-utils/colrm.1.adoc:38 ../text-utils/column.1.adoc:38
8389 #: ../text-utils/hexdump.1.adoc:38 ../text-utils/line.1.adoc:5
8390 #: ../text-utils/more.1.adoc:41 ../text-utils/pg.1.adoc:5
8391 #: ../text-utils/rev.1.adoc:38 ../text-utils/ul.1.adoc:38
8393 msgid "User Commands"
8394 msgstr "Příručka uživatele"
8397 #: ../login-utils/chfn.1.adoc:20
8398 msgid "chfn - change your finger information"
8402 #: ../login-utils/chfn.1.adoc:24
8404 msgid "*chfn* [*-f* _full-name_] [*-o* _office_] [*-p* _office-phone_] [*-h* _home-phone_] [*-u*] [*-V*] [_username_]\n"
8408 #: ../login-utils/chfn.1.adoc:28
8410 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"
8414 #: ../login-utils/chfn.1.adoc:30
8416 "Any of the four pieces of information can be specified on the command line. "
8417 "If no information is given on the command line, *chfn* enters interactive "
8422 #: ../login-utils/chfn.1.adoc:32
8424 "In interactive mode, *chfn* will prompt for each field. At a prompt, you can "
8425 "enter the new information, or just press return to leave the field "
8426 "unchanged. Enter the keyword \"none\" to make the field blank."
8430 #: ../login-utils/chfn.1.adoc:34
8432 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"
8435 #. type: Labeled list
8436 #: ../login-utils/chfn.1.adoc:37
8438 msgid "*-f*, *--full-name* _full-name_"
8442 #: ../login-utils/chfn.1.adoc:39
8443 msgid "Specify your real name."
8446 #. type: Labeled list
8447 #: ../login-utils/chfn.1.adoc:40
8449 msgid "*-o*, *--office* _office_"
8453 #: ../login-utils/chfn.1.adoc:42
8454 msgid "Specify your office room number."
8457 #. type: Labeled list
8458 #: ../login-utils/chfn.1.adoc:43
8460 msgid "*-p*, *--office-phone* _office-phone_"
8464 #: ../login-utils/chfn.1.adoc:45
8465 msgid "Specify your office phone number."
8468 #. type: Labeled list
8469 #: ../login-utils/chfn.1.adoc:46
8471 msgid "*-h*, *--home-phone* _home-phone_"
8475 #: ../login-utils/chfn.1.adoc:48
8476 msgid "Specify your home phone number."
8479 #. type: Labeled list
8480 #: ../login-utils/chfn.1.adoc:49
8482 #| msgid "*-h*, *--help*"
8483 msgid "*-u*, *--help*"
8484 msgstr "*-h*, *--help*"
8487 #: ../login-utils/chfn.1.adoc:55 ../login-utils/chsh.1.adoc:46
8489 "Print version and exit. The short options *-V* have been used since version "
8490 "2.39; old versions use deprecated *-v*."
8494 #: ../login-utils/chfn.1.adoc:58 ../login-utils/login.1.adoc:57
8495 #: ../term-utils/agetty.8.adoc:185
8497 #| msgid "CONFIG FILES"
8498 msgid "CONFIG FILE ITEMS"
8499 msgstr "KONFIGURAČNÍ SOUBORY"
8502 #: ../login-utils/chfn.1.adoc:61
8504 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
8505 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"
8506 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"
8508 #. type: Labeled list
8509 #: ../login-utils/chfn.1.adoc:62
8511 msgid "*CHFN_RESTRICT* _string_"
8515 #: ../login-utils/chfn.1.adoc:65
8516 msgid "Indicate which fields are changeable by *chfn*."
8520 #: ../login-utils/chfn.1.adoc:67
8522 "The boolean setting *\"yes\"* means that only the Office, Office Phone and "
8523 "Home Phone fields are changeable, and boolean setting *\"no\"* means that "
8524 "also the Full Name is changeable."
8528 #: ../login-utils/chfn.1.adoc:69
8530 "Another way to specify changeable fields is by abbreviations: f = Full Name, "
8531 "r = Office (room), w = Office (work) Phone, h = Home Phone. For example, "
8532 "*CHFN_RESTRICT \"wh\"* allows changing work and home phone numbers."
8536 #: ../login-utils/chfn.1.adoc:71
8538 "If *CHFN_RESTRICT* is undefined, then all finger information is read-only. "
8539 "This is the default."
8543 #: ../login-utils/chfn.1.adoc:75 ../login-utils/chsh.1.adoc:58
8544 #: ../sys-utils/eject.1.adoc:96
8546 "Returns 0 if operation was successful, 1 if operation failed or command "
8547 "syntax was not valid."
8551 #: ../login-utils/chfn.1.adoc:79 ../login-utils/chsh.1.adoc:62
8552 msgid "mailto:svalente@mit.edu[Salvatore Valente]"
8556 #: ../login-utils/chfn.1.adoc:86
8561 "*login.defs*(5),\n"
8566 #. chsh.1 -- change your login shell
8567 #. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
8568 #. This program is free software. You can redistribute it and
8569 #. modify it under the terms of the GNU General Public License.
8570 #. There is no warranty.
8572 #: ../login-utils/chsh.1.adoc:10
8578 #: ../login-utils/chsh.1.adoc:20
8579 msgid "chsh - change your login shell"
8583 #: ../login-utils/chsh.1.adoc:24
8585 msgid "*chsh* [*-s* _shell_] [*-l*] [*-h*] [*-V*] [_username_]\n"
8589 #: ../login-utils/chsh.1.adoc:28
8591 msgid "*chsh* is used to change your login shell. If a shell is not given on the command line, *chsh* prompts for one.\n"
8595 #: ../login-utils/chsh.1.adoc:30
8597 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"
8600 #. type: Labeled list
8601 #: ../login-utils/chsh.1.adoc:33 ../misc-utils/getopt.1.adoc:53
8603 #| msgid "*-s*, **--shell**=__shell__"
8604 msgid "*-s*, *--shell* _shell_"
8605 msgstr "*-s*, **--shell**=__shell__"
8608 #: ../login-utils/chsh.1.adoc:35
8609 msgid "Specify your login shell."
8612 #. type: Labeled list
8613 #: ../login-utils/chsh.1.adoc:36
8615 #| msgid "*-h*, *--help*"
8616 msgid "*-l*, *--list-shells*"
8617 msgstr "*-h*, *--help*"
8620 #: ../login-utils/chsh.1.adoc:38
8621 msgid "Print the list of shells listed in _/etc/shells_ and exit."
8625 #: ../login-utils/chsh.1.adoc:42
8627 "Display help text and exit. The short options *-h* have been used since "
8628 "version 2.30; old versions use deprecated *-u*."
8632 #: ../login-utils/chsh.1.adoc:49
8634 msgid "VALID SHELLS"
8638 #: ../login-utils/chsh.1.adoc:52
8640 msgid "*chsh* will accept the full pathname of any executable file on the system.\n"
8644 #: ../login-utils/chsh.1.adoc:54
8646 "The default behavior for non-root users is to accept only shells listed in "
8647 "the _/etc/shells_ file, and issue a warning for root user. It can also be "
8648 "configured at compile-time to only issue a warning for all users."
8652 #: ../login-utils/chsh.1.adoc:69
8655 #| "*setpriv*(1),\n"
8656 #| "*login.defs*(5),\n"
8662 "*login.defs*(5),\n"
8667 "*login.defs*(5),\n"
8675 #. Copyright (C) 1998-2004 Miquel van Smoorenburg.
8676 #. This program is free software; you can redistribute it and/or modify
8677 #. it under the terms of the GNU General Public License as published by
8678 #. the Free Software Foundation; either version 2 of the License, or
8679 #. (at your option) any later version.
8680 #. This program is distributed in the hope that it will be useful,
8681 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
8682 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8683 #. GNU General Public License for more details.
8684 #. You should have received a copy of the GNU General Public License
8685 #. along with this program; if not, write to the Free Software
8686 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8688 #: ../login-utils/last.1.adoc:19
8694 #: ../login-utils/last.1.adoc:29
8695 msgid "last, lastb - show a listing of last logged in users"
8699 #: ../login-utils/last.1.adoc:33
8701 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
8702 msgid "*last* [options] [_username_...] [_tty_...]\n"
8703 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
8706 #: ../login-utils/last.1.adoc:35
8708 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
8709 msgid "*lastb* [options] [_username_...] [_tty_...]\n"
8710 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
8713 #: ../login-utils/last.1.adoc:39
8715 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"
8719 #: ../login-utils/last.1.adoc:41
8721 "When catching a *SIGINT* signal (generated by the interrupt key, usually "
8722 "control-C) or a *SIGQUIT* signal, *last* will show how far it has searched "
8723 "through the file; in the case of the *SIGINT* signal *last* will then "
8728 #: ../login-utils/last.1.adoc:43
8730 "The pseudo user *reboot* logs in each time the system is rebooted. Thus "
8731 "*last reboot* will show a log of all the reboots since the log file was "
8736 #: ../login-utils/last.1.adoc:45
8738 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"
8741 #. type: Labeled list
8742 #: ../login-utils/last.1.adoc:48
8744 #| msgid "*-f*, *--fast*"
8745 msgid "*-a*, *--hostlast*"
8746 msgstr "*-f*, *--fast*"
8749 #: ../login-utils/last.1.adoc:50
8751 "Display the hostname in the last column. Useful in combination with the *--"
8755 #. type: Labeled list
8756 #: ../login-utils/last.1.adoc:51
8758 #| msgid "*-f*, *--fast*"
8759 msgid "*-d*, *--dns*"
8760 msgstr "*-f*, *--fast*"
8763 #: ../login-utils/last.1.adoc:53
8765 "For non-local logins, Linux stores not only the host name of the remote "
8766 "host, but its IP number as well. This option translates the IP number back "
8770 #. type: Labeled list
8771 #: ../login-utils/last.1.adoc:54 ../misc-utils/logger.1.adoc:67
8772 #: ../misc-utils/mcookie.1.adoc:31
8774 #| msgid "*-f*, *--fast*"
8775 msgid "*-f*, *--file* _file_"
8776 msgstr "*-f*, *--fast*"
8779 #: ../login-utils/last.1.adoc:56
8781 "Tell *last* to use a specific _file_ instead of _/var/log/wtmp_. The *--"
8782 "file* option can be given multiple times, and all of the specified files "
8783 "will be processed."
8786 #. type: Labeled list
8787 #: ../login-utils/last.1.adoc:57
8789 #| msgid "*-f*, *--fast*"
8790 msgid "*-F*, *--fulltimes*"
8791 msgstr "*-f*, *--fast*"
8794 #: ../login-utils/last.1.adoc:59
8795 msgid "Print full login and logout times and dates."
8798 #. type: Labeled list
8799 #: ../login-utils/last.1.adoc:60
8801 #| msgid "*-P*, *--pty*"
8802 msgid "*-i*, *--ip*"
8803 msgstr "*-P*, *--pty*"
8806 #: ../login-utils/last.1.adoc:62
8807 msgid "Like *--dns ,* but displays the host's IP number instead of the name."
8810 #. type: Labeled list
8811 #: ../login-utils/last.1.adoc:63
8813 msgid "**-**__number__; *-n*, *--limit* _number_"
8817 #: ../login-utils/last.1.adoc:65
8818 msgid "Tell *last* how many lines to show."
8821 #. type: Labeled list
8822 #: ../login-utils/last.1.adoc:66
8824 #| msgid "*-m*, *-p*, *--preserve-environment*"
8825 msgid "*-p*, *--present* _time_"
8826 msgstr "*-m*, *-p*, *--preserve-environment*"
8829 #: ../login-utils/last.1.adoc:68
8831 "Display the users who were present at the specified time. This is like using "
8832 "the options *--since* and *--until* together with the same _time_."
8835 #. type: Labeled list
8836 #: ../login-utils/last.1.adoc:69
8838 #| msgid "*-h*, *--help*"
8839 msgid "*-R*, *--nohostname*"
8840 msgstr "*-h*, *--help*"
8843 #: ../login-utils/last.1.adoc:71
8844 msgid "Suppresses the display of the hostname field."
8847 #. type: Labeled list
8848 #: ../login-utils/last.1.adoc:72
8850 #| msgid "*-V*, *--version*"
8851 msgid "*-s*, *--since* _time_"
8852 msgstr "*-V*, *--version*"
8855 #: ../login-utils/last.1.adoc:74
8857 "Display the state of logins since the specified _time_. This is useful, e."
8858 "g., to easily determine who was logged in at a particular time. The option "
8859 "is often combined with *--until*."
8862 #. type: Labeled list
8863 #: ../login-utils/last.1.adoc:75
8865 msgid "*-t*, *--until* _time_"
8869 #: ../login-utils/last.1.adoc:77
8870 msgid "Display the state of logins until the specified _time_."
8873 #. type: Labeled list
8874 #: ../login-utils/last.1.adoc:78
8876 #| msgid "*-h*, *--help*"
8877 msgid "*-T*, *--tab-separated*"
8878 msgstr "*-h*, *--help*"
8881 #: ../login-utils/last.1.adoc:80
8883 "Use ASCII *tab* characters to separate the columns in the output instead of "
8887 #. type: Labeled list
8888 #: ../login-utils/last.1.adoc:81 ../sys-utils/dmesg.1.adoc:138
8890 msgid "*--time-format* _format_"
8894 #: ../login-utils/last.1.adoc:83
8896 "Define the output timestamp _format_ to be one of _notime_, _short_, _full_, "
8897 "or _iso_. The _notime_ variant will not print any timestamps at all, _short_ "
8898 "is the default, and _full_ is the same as the *--fulltimes* option. The "
8899 "_iso_ variant will display the timestamp in ISO-8601 format. The ISO format "
8900 "contains timezone information, making it preferable when printouts are "
8901 "investigated outside of the system."
8904 #. type: Labeled list
8905 #: ../login-utils/last.1.adoc:84
8907 #| msgid "*-f*, *--fast*"
8908 msgid "*-w*, *--fullnames*"
8909 msgstr "*-f*, *--fast*"
8912 #: ../login-utils/last.1.adoc:86
8913 msgid "Display full user names and domain names in the output."
8916 #. type: Labeled list
8917 #: ../login-utils/last.1.adoc:87
8919 #| msgid "*-f*, *--fast*"
8920 msgid "*-x*, *--system*"
8921 msgstr "*-f*, *--fast*"
8924 #: ../login-utils/last.1.adoc:89
8925 msgid "Display the system shutdown entries and run level changes."
8929 #: ../login-utils/last.1.adoc:92
8931 msgid "TIME FORMATS"
8935 #: ../login-utils/last.1.adoc:95
8937 "The options that take the _time_ argument understand the following formats:"
8941 #: ../login-utils/last.1.adoc:110
8944 "|YYYYMMDDhhmmss |\n"
8945 "|YYYY-MM-DD hh:mm:ss |\n"
8946 "|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
8947 "|YYYY-MM-DD |(time will be set to 00:00:00)\n"
8948 "|hh:mm:ss |(date will be set to today)\n"
8949 "|hh:mm |(date will be set to today, seconds to 00)\n"
8951 "|yesterday |(time is set to 00:00:00)\n"
8952 "|today |(time is set to 00:00:00)\n"
8953 "|tomorrow |(time is set to 00:00:00)\n"
8959 #: ../login-utils/last.1.adoc:116
8960 msgid "_/var/log/wtmp_, _/var/log/btmp_"
8964 #: ../login-utils/last.1.adoc:120
8966 "The files _wtmp_ and _btmp_ might not be found. The system only logs "
8967 "information in these files if they are present. This is a local "
8968 "configuration issue. If you want the files to be used, they can be created "
8969 "with a simple *touch*(1) command (for example, *touch /var/log/wtmp*)."
8973 #: ../login-utils/last.1.adoc:122
8975 "An empty entry is a valid type of wtmp entry. It means that an empty file or "
8976 "file with zeros is not interpreted as an error."
8980 #: ../login-utils/last.1.adoc:124
8982 "The utmp file format uses fixed sizes of strings, which means that very long "
8983 "strings are impossible to store in the file and impossible to display by "
8984 "*last*. The usual limits are 32 bytes for a user and line name and 256 bytes "
8989 #: ../login-utils/last.1.adoc:128
8990 msgid "mailto:miquels@cistron.nl[Miquel van Smoorenburg]"
8994 #: ../login-utils/last.1.adoc:135
8997 #| "*getmntent*(3),\n"
8999 #| "*findmnt*(8),\n"
9014 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
9015 #. May be distributed under the GNU General Public License
9017 #: ../login-utils/login.1.adoc:6
9023 #: ../login-utils/login.1.adoc:16
9024 msgid "login - begin session on the system"
9028 #: ../login-utils/login.1.adoc:20
9030 msgid "*login* [*-p*] [*-h* _host_] [*-H*] [*-f* _username_|_username_]\n"
9034 #: ../login-utils/login.1.adoc:24
9036 msgid "*login* is used when signing onto a system. If no argument is given, *login* prompts for the username.\n"
9040 #: ../login-utils/login.1.adoc:26
9042 "The user is then prompted for a password, where appropriate. Echoing is "
9043 "disabled to prevent revealing the password. Only a number of password "
9044 "failures are permitted before *login* exits and the communications link is "
9045 "severed. See *LOGIN_RETRIES* in the *CONFIG FILE ITEMS* section."
9049 #: ../login-utils/login.1.adoc:28
9051 "If password aging has been enabled for the account, the user may be prompted "
9052 "for a new password before proceeding. In such case old password must be "
9053 "provided and the new password entered before continuing. Please refer to "
9054 "*passwd*(1) for more information."
9058 #: ../login-utils/login.1.adoc:30
9060 "The user and group ID will be set according to their values in the _/etc/"
9061 "passwd_ file. There is one exception if the user ID is zero. In this case, "
9062 "only the primary group ID of the account is set. This should allow the "
9063 "system administrator to login even in case of network problems. The "
9064 "environment variable values for *$HOME*, *$USER*, *$SHELL*, *$PATH*, "
9065 "*$LOGNAME*, and *$MAIL* are set according to the appropriate fields in the "
9066 "password entry. *$PATH* defaults to _/usr/local/bin:/bin:/usr/bin_ for "
9067 "normal users, and to _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/"
9068 "usr/bin_ for root, if not otherwise configured."
9072 #: ../login-utils/login.1.adoc:32
9074 "The environment variable *$TERM* will be preserved, if it exists, else it "
9075 "will be initialized to the terminal type on your tty. Other environment "
9076 "variables are preserved if the *-p* option is given."
9080 #: ../login-utils/login.1.adoc:34
9081 msgid "The environment variables defined by PAM are always preserved."
9085 #: ../login-utils/login.1.adoc:36
9087 "Then the user's shell is started. If no shell is specified for the user in _/"
9088 "etc/passwd_, then _/bin/sh_ is used. If the specified shell contains a "
9089 "space, it is treated as a shell script. If there is no home directory "
9090 "specified in _/etc/passwd_, then _/_ is used, followed by _.hushlogin_ check "
9091 "as described below."
9095 #: ../login-utils/login.1.adoc:38
9097 "If the file _.hushlogin_ exists, then a \"quiet\" login is performed. This "
9098 "disables the checking of mail and the printing of the last login time and "
9099 "message of the day. Otherwise, if _/var/log/lastlog_ exists, the last login "
9100 "time is printed, and the current login is recorded."
9104 #: ../login-utils/login.1.adoc:43
9105 msgid "Used by *getty*(8) to tell *login* to preserve the environment."
9108 #. type: Labeled list
9109 #: ../login-utils/login.1.adoc:44 ../misc-utils/whereis.1.adoc:94
9110 #: ../text-utils/pg.1.adoc:45
9116 #: ../login-utils/login.1.adoc:46
9118 "Used to skip a login authentication. This option is usually used by the "
9119 "*getty*(8) autologin feature."
9122 #. type: Labeled list
9123 #: ../login-utils/login.1.adoc:47
9129 #: ../login-utils/login.1.adoc:49
9131 "Used by other servers (such as *telnetd*(8) to pass the name of the remote "
9132 "host to *login* so that it can be placed in utmp and wtmp. Only the "
9133 "superuser is allowed use this option."
9137 #: ../login-utils/login.1.adoc:51
9139 "Note that the *-h* option has an impact on the *PAM service* *name*. The "
9140 "standard service name is _login_, but with the *-h* option, the name is "
9141 "_remote_. It is necessary to create proper PAM config files (for example, _/"
9142 "etc/pam.d/login_ and _/etc/pam.d/remote_)."
9145 #. type: Labeled list
9146 #: ../login-utils/login.1.adoc:52
9152 #: ../login-utils/login.1.adoc:54
9154 "Used by other servers (for example, *telnetd*(8)) to tell *login* that "
9155 "printing the hostname should be suppressed in the login: prompt. See also "
9156 "*LOGIN_PLAIN_PROMPT* below."
9160 #: ../login-utils/login.1.adoc:60
9162 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
9163 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"
9164 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"
9166 #. type: Labeled list
9167 #: ../login-utils/login.1.adoc:61
9169 #| msgid "*ENV_PATH* (string)"
9170 msgid "*MOTD_FILE* (string)"
9171 msgstr "*ENV_PATH* (řetězec)"
9174 #: ../login-utils/login.1.adoc:63
9176 "Specifies a \":\" delimited list of \"message of the day\" files and "
9177 "directories to be displayed upon login. If the specified path is a directory "
9178 "then displays all files with .motd file extension in version-sort order from "
9183 #: ../login-utils/login.1.adoc:65
9185 "The default value is _/usr/share/misc/motd:/run/motd:/etc/motd_. If the "
9186 "*MOTD_FILE* item is empty or a quiet login is enabled, then the message of "
9187 "the day is not displayed. Note that the same functionality is also provided "
9188 "by the *pam_motd*(8) PAM module."
9192 #: ../login-utils/login.1.adoc:67
9193 msgid "The directories in the *MOTD_FILE* are supported since version 2.36."
9197 #: ../login-utils/login.1.adoc:69
9199 "Note that *login* does not implement any filenames overriding behavior like "
9200 "pam_motd (see also *MOTD_FIRSTONLY*), but all content from all files is "
9201 "displayed. It is recommended to keep extra logic in content generators and "
9202 "use _/run/motd.d_ rather than rely on overriding behavior hardcoded in "
9206 #. type: Labeled list
9207 #: ../login-utils/login.1.adoc:70
9209 msgid "*MOTD_FIRSTONLY* (boolean)"
9213 #: ../login-utils/login.1.adoc:73
9215 "Forces *login* to stop display content specified by *MOTD_FILE* after the "
9216 "first accessible item in the list. Note that a directory is one item in this "
9217 "case. This option allows *login* semantics to be configured to be more "
9218 "compatible with pam_motd. The default value is _no_."
9221 #. type: Labeled list
9222 #: ../login-utils/login.1.adoc:74 ../term-utils/agetty.8.adoc:190
9224 msgid "*LOGIN_PLAIN_PROMPT* (boolean)"
9228 #: ../login-utils/login.1.adoc:77
9230 "Tell *login* that printing the hostname should be suppressed in the login: "
9231 "prompt. This is an alternative to the *-H* command line option. The default "
9235 #. type: Labeled list
9236 #: ../login-utils/login.1.adoc:78
9238 #| msgid "*FAIL_DELAY* (number)"
9239 msgid "*LOGIN_TIMEOUT* (number)"
9240 msgstr "*FAIL_DELAY* (číslo)"
9243 #: ../login-utils/login.1.adoc:81
9244 msgid "Maximum time in seconds for login. The default value is _60_."
9247 #. type: Labeled list
9248 #: ../login-utils/login.1.adoc:82
9250 #| msgid "*FAIL_DELAY* (number)"
9251 msgid "*LOGIN_RETRIES* (number)"
9252 msgstr "*FAIL_DELAY* (číslo)"
9255 #: ../login-utils/login.1.adoc:85
9257 "Maximum number of login retries in case of a bad password. The default value "
9261 #. type: Labeled list
9262 #: ../login-utils/login.1.adoc:86
9264 msgid "*LOGIN_KEEP_USERNAME* (boolean)"
9268 #: ../login-utils/login.1.adoc:89
9270 "Tell *login* to only re-prompt for the password if authentication failed, "
9271 "but the username is valid. The default value is _no_."
9274 #. type: Labeled list
9275 #: ../login-utils/login.1.adoc:90 ../login-utils/su.1.adoc:95
9277 msgid "*FAIL_DELAY* (number)"
9278 msgstr "*FAIL_DELAY* (číslo)"
9281 #: ../login-utils/login.1.adoc:93
9283 "Delay in seconds before being allowed another three tries after a login "
9284 "failure. The default value is _5_."
9287 #. type: Labeled list
9288 #: ../login-utils/login.1.adoc:94
9290 #| msgid "*ENV_PATH* (string)"
9291 msgid "*TTYPERM* (string)"
9292 msgstr "*ENV_PATH* (řetězec)"
9295 #: ../login-utils/login.1.adoc:97
9297 "The terminal permissions. The default value is _0600_ or _0620_ if tty group "
9301 #. type: Labeled list
9302 #: ../login-utils/login.1.adoc:98
9304 #| msgid "*ENV_ROOTPATH* (string)"
9305 msgid "*TTYGROUP* (string)"
9306 msgstr "*ENV_ROOTPATH* (řetězec)"
9309 #: ../login-utils/login.1.adoc:101
9311 "The login tty will be owned by the *TTYGROUP*. The default value is _tty_. "
9312 "If the *TTYGROUP* does not exist, then the ownership of the terminal is set "
9313 "to the user's primary group."
9317 #: ../login-utils/login.1.adoc:103
9319 "The *TTYGROUP* can be either the name of a group or a numeric group "
9323 #. type: Labeled list
9324 #: ../login-utils/login.1.adoc:104
9326 msgid "*HUSHLOGIN_FILE* (string)"
9330 #: ../login-utils/login.1.adoc:107
9332 "If defined, this file can inhibit all the usual chatter during the login "
9333 "sequence. If a full pathname (for example, _/etc/hushlogins_) is specified, "
9334 "then hushed mode will be enabled if the user's name or shell are found in "
9335 "the file. If this global hush login file is empty then the hushed mode will "
9336 "be enabled for all users."
9340 #: ../login-utils/login.1.adoc:109
9342 "If a full pathname is not specified, then hushed mode will be enabled if the "
9343 "file exists in the user's home directory."
9347 #: ../login-utils/login.1.adoc:111
9349 "The default is to check _/etc/hushlogins_ and if it does not exist then _~/."
9354 #: ../login-utils/login.1.adoc:113
9356 "If the *HUSHLOGIN_FILE* item is empty, then all the checks are disabled."
9359 #. type: Labeled list
9360 #: ../login-utils/login.1.adoc:114
9362 #| msgid "*ALWAYS_SET_PATH* (boolean)"
9363 msgid "*DEFAULT_HOME* (boolean)"
9364 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
9367 #: ../login-utils/login.1.adoc:117
9369 "Indicate if login is allowed if we cannot change directory to the home "
9370 "directory. If set to _yes_, the user will login in the root (/) directory if "
9371 "it is not possible to change directory to their home. The default value is "
9375 #. type: Labeled list
9376 #: ../login-utils/login.1.adoc:118
9378 msgid "*LASTLOG_UID_MAX* (unsigned number)"
9382 #: ../login-utils/login.1.adoc:121
9384 "Highest user ID number for which the _lastlog_ entries should be updated. As "
9385 "higher user IDs are usually tracked by remote user identity and "
9386 "authentication services there is no need to create a huge sparse _lastlog_ "
9387 "file for them. No LASTLOG_UID_MAX option present in the configuration means "
9388 "that there is no user ID limit for writing _lastlog_ entries. The default "
9389 "value is _ULONG_MAX_."
9392 #. type: Labeled list
9393 #: ../login-utils/login.1.adoc:122
9395 #| msgid "*ALWAYS_SET_PATH* (boolean)"
9396 msgid "*LOG_UNKFAIL_ENAB* (boolean)"
9397 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
9400 #: ../login-utils/login.1.adoc:125
9402 "Enable display of unknown usernames when login failures are recorded. The "
9403 "default value is _no_."
9407 #: ../login-utils/login.1.adoc:127
9409 "Note that logging unknown usernames may be a security issue if a user enters "
9410 "their password instead of their login name."
9413 #. type: Labeled list
9414 #: ../login-utils/login.1.adoc:128 ../login-utils/runuser.1.adoc:89
9415 #: ../login-utils/su.1.adoc:98
9417 msgid "*ENV_PATH* (string)"
9418 msgstr "*ENV_PATH* (řetězec)"
9421 #: ../login-utils/login.1.adoc:131
9424 #| "Defines the *PATH* environment variable for a regular user. The default "
9425 #| "value is _/usr/local/bin:/bin:/usr/bin_."
9427 "If set, it will be used to define the *PATH* environment variable when a "
9428 "regular user logs in. The default value is _/usr/local/bin:/bin:/usr/bin_."
9430 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
9431 "usr/local/bin:/bin:/usr/bin_."
9433 #. type: Labeled list
9434 #: ../login-utils/login.1.adoc:132 ../login-utils/runuser.1.adoc:92
9435 #: ../login-utils/su.1.adoc:101
9437 msgid "*ENV_ROOTPATH* (string)"
9438 msgstr "*ENV_ROOTPATH* (řetězec)"
9440 #. type: Labeled list
9441 #: ../login-utils/login.1.adoc:133 ../login-utils/runuser.1.adoc:93
9442 #: ../login-utils/su.1.adoc:102
9444 msgid "*ENV_SUPATH* (string)"
9445 msgstr "*ENV_SUPATH* (řetězec)"
9448 #: ../login-utils/login.1.adoc:136
9451 #| "Defines the *PATH* environment variable for root. *ENV_SUPATH* takes "
9452 #| "precedence. The default value is _/usr/local/sbin:/usr/local/bin:/sbin:/"
9453 #| "bin:/usr/sbin:/usr/bin_."
9455 "If set, it will be used to define the PATH environment variable when the "
9456 "superuser logs in. *ENV_ROOTPATH* takes precedence. The default value is _/"
9457 "usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_."
9459 "Určuje proměnnou prostředí *PATH* pro uživatele root. *ENV_SUPATH* má "
9460 "přednost. Výchozí hodnota je _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/"
9464 #: ../login-utils/login.1.adoc:150
9466 "_/var/run/utmp_, _/var/log/wtmp_, _/var/log/lastlog_, _/var/spool/mail/*_, _/"
9467 "etc/motd_, _/etc/passwd_, _/etc/nologin_, _/etc/pam.d/login_, _/etc/pam.d/"
9468 "remote_, _/etc/hushlogins_, _$HOME/.hushlogin_"
9472 #: ../login-utils/login.1.adoc:151 ../term-utils/agetty.8.adoc:322
9478 #: ../login-utils/login.1.adoc:154
9480 msgid "*login* supports configuration via systemd credentials (see https://systemd.io/CREDENTIALS/). *login* reads the following systemd credentials:\n"
9483 #. type: Labeled list
9484 #: ../login-utils/login.1.adoc:155
9486 msgid "*login.noauth* (boolean)"
9490 #: ../login-utils/login.1.adoc:158
9492 "If set, configures *login* to skip login authentication, similarly to the *-"
9497 #: ../login-utils/login.1.adoc:162
9499 "The undocumented BSD *-r* option is not supported. This may be required by "
9500 "some *rlogind*(8) programs."
9504 #: ../login-utils/login.1.adoc:164
9506 "A recursive login, as used to be possible in the good old days, no longer "
9507 "works; for most purposes *su*(1) is a satisfactory substitute. Indeed, for "
9508 "security reasons, *login* does a *vhangup*(2) system call to remove any "
9509 "possible listening processes on the tty. This is to avoid password sniffing. "
9510 "If one uses the command *login*, then the surrounding shell gets killed by "
9511 "*vhangup*(2) because it's no longer the true owner of the tty. This can be "
9512 "avoided by using *exec login* in a top-level shell or xterm."
9516 #: ../login-utils/login.1.adoc:168
9518 "Derived from BSD login 5.40 (5/9/89) by mailto:glad@daimi.dk[Michael Glad] "
9519 "for HP-UX. Ported to Linux 0.12: mailto:poe@daimi.aau.dk[Peter Orbaek]. "
9520 "Rewritten to a PAM-only version by mailto:kzak@redhat.com[Karel Zak]"
9524 #: ../login-utils/login.1.adoc:180
9538 #. Copyright 2014 Ondrej Oprala (ondrej.oprala@gmail.com)
9539 #. May be distributed under the GNU General Public License
9541 #: ../login-utils/lslogins.1.adoc:4
9547 #: ../login-utils/lslogins.1.adoc:14
9549 #| msgid "fstab - static information about the filesystems"
9550 msgid "lslogins - display information about known users in the system"
9551 msgstr "fstab - statická informace o souborových systémech"
9554 #: ../login-utils/lslogins.1.adoc:18
9556 msgid "*lslogins* [options] [*-s*|*-u*[=_UID_]] [*-g* _groups_] [*-l* _logins_] [_username_]\n"
9560 #: ../login-utils/lslogins.1.adoc:22
9562 "Examine the wtmp and btmp logs, _/etc/shadow_ (if necessary) and _/passwd_ "
9563 "and output the desired data."
9567 #: ../login-utils/lslogins.1.adoc:24
9569 "The optional argument _username_ forces *lslogins* to print all available "
9570 "details about the specified user only. In this case the output format is "
9571 "different than in case of *-l* or *-g* and unknown is _username_ reported as "
9576 #: ../login-utils/lslogins.1.adoc:26
9577 msgid "The default action is to list info about all the users in the system."
9581 #: ../login-utils/lslogins.1.adoc:30
9583 "Mandatory arguments to long options are mandatory for short options too."
9586 #. type: Labeled list
9587 #: ../login-utils/lslogins.1.adoc:31
9589 #| msgid "*-V*, *--version*"
9590 msgid "*-a*, *--acc-expiration*"
9591 msgstr "*-V*, *--version*"
9594 #: ../login-utils/lslogins.1.adoc:33
9596 "Display data about the date of last password change and the account "
9597 "expiration date (see *shadow*(5) for more info). (Requires root privileges.)"
9600 #. type: Labeled list
9601 #: ../login-utils/lslogins.1.adoc:34
9603 msgid "*--btmp-file* _path_"
9607 #: ../login-utils/lslogins.1.adoc:36
9608 msgid "Alternate path for btmp."
9611 #. type: Labeled list
9612 #: ../login-utils/lslogins.1.adoc:37
9614 msgid "*-c*, *--colon-separate*"
9618 #: ../login-utils/lslogins.1.adoc:39
9619 msgid "Separate info about each user with a colon instead of a newline."
9622 #. type: Labeled list
9623 #: ../login-utils/lslogins.1.adoc:40 ../sys-utils/lsipc.1.adoc:47
9625 #| msgid "*-P*, *--pty*"
9626 msgid "*-e*, *--export*"
9627 msgstr "*-P*, *--pty*"
9630 #: ../login-utils/lslogins.1.adoc:42
9631 msgid "Output data in the format of NAME=VALUE. See also option *--shell*."
9634 #. type: Labeled list
9635 #: ../login-utils/lslogins.1.adoc:43
9637 #| msgid "*-f*, *--fast*"
9638 msgid "*-f*, *--failed*"
9639 msgstr "*-f*, *--fast*"
9642 #: ../login-utils/lslogins.1.adoc:45
9643 msgid "Display data about the users' last failed login attempts."
9646 #. type: Labeled list
9647 #: ../login-utils/lslogins.1.adoc:46
9649 #| msgid "*-G*, **--supp-group**=__group__"
9650 msgid "*-G*, *--supp-groups*"
9651 msgstr "*-G*, **--supp-group**=__skupina__"
9654 #: ../login-utils/lslogins.1.adoc:48
9655 msgid "Show information about supplementary groups."
9658 #. type: Labeled list
9659 #: ../login-utils/lslogins.1.adoc:49
9661 #| msgid "*-g*, **--group**=__group__"
9662 msgid "*-g*, **--groups**=_groups_"
9663 msgstr "*-g*, **--group**=__skupina__"
9666 #: ../login-utils/lslogins.1.adoc:51
9668 "Only show data of users belonging to _groups_. More than one group may be "
9669 "specified; the list has to be comma-separated. Unknown group names are "
9674 #: ../login-utils/lslogins.1.adoc:53
9676 "Note that the relation between user and group may be invisible for the "
9677 "primary group if the user is not explicitly specified as group member (e.g., "
9678 "in _/etc/group_). If the command *lslogins* scans for groups then it uses "
9679 "the groups database only, and the user database with primary GID is not used "
9683 #. type: Labeled list
9684 #: ../login-utils/lslogins.1.adoc:54
9686 #| msgid "*-f*, *--fast*"
9687 msgid "*-L*, *--last*"
9688 msgstr "*-f*, *--fast*"
9691 #: ../login-utils/lslogins.1.adoc:56
9693 "Display data containing information about the users' last login sessions."
9696 #. type: Labeled list
9697 #: ../login-utils/lslogins.1.adoc:57
9699 #| msgid "*-*, *-l*, *--login*"
9700 msgid "*-l*, **--logins**=_logins_"
9701 msgstr "*-*, *-l*, *--login*"
9704 #: ../login-utils/lslogins.1.adoc:59
9706 "Only show data of users with a login specified in _logins_ (user names or "
9707 "user IDs). More than one login may be specified; the list has to be comma-"
9708 "separated. Unknown login names are ignored."
9711 #. type: Labeled list
9712 #: ../login-utils/lslogins.1.adoc:60 ../sys-utils/lsipc.1.adoc:56
9714 #| msgid "*-h*, *--help*"
9715 msgid "*-n*, *--newline*"
9716 msgstr "*-h*, *--help*"
9719 #: ../login-utils/lslogins.1.adoc:62 ../sys-utils/lsipc.1.adoc:58
9720 msgid "Display each piece of information on a separate line."
9723 #. type: Labeled list
9724 #: ../login-utils/lslogins.1.adoc:63 ../sys-utils/lsipc.1.adoc:59
9725 #: ../sys-utils/prlimit.1.adoc:43 ../sys-utils/swapon.8.adoc:77
9727 msgid "*--noheadings*"
9731 #: ../login-utils/lslogins.1.adoc:65 ../misc-utils/findmnt.8.adoc:98
9732 #: ../misc-utils/lsblk.8.adoc:90 ../misc-utils/lslocks.8.adoc:48
9733 #: ../misc-utils/uuidparse.1.adoc:55 ../misc-utils/wipefs.8.adoc:57
9734 #: ../sys-utils/lsipc.1.adoc:61 ../sys-utils/lsmem.1.adoc:44
9735 #: ../sys-utils/lsns.8.adoc:42 ../sys-utils/prlimit.1.adoc:45
9736 #: ../sys-utils/rfkill.8.adoc:32
9737 msgid "Do not print a header line."
9740 #. type: Labeled list
9741 #: ../login-utils/lslogins.1.adoc:66 ../misc-utils/lsfd.1.adoc:60
9742 #: ../sys-utils/lsipc.1.adoc:62
9744 msgid "*--notruncate*"
9748 #: ../login-utils/lslogins.1.adoc:68 ../sys-utils/lsipc.1.adoc:64
9749 msgid "Don't truncate output."
9753 #: ../login-utils/lslogins.1.adoc:71
9755 "Specify which output columns to print. The default list of columns may be "
9756 "extended if _list_ is specified in the format _+list_."
9760 #: ../login-utils/lslogins.1.adoc:74
9762 "Output all available columns. *--help* to get a list of all supported "
9766 #. type: Labeled list
9767 #: ../login-utils/lslogins.1.adoc:75
9769 #| msgid "*-P*, *--pty*"
9770 msgid "*-p*, *--pwd*"
9771 msgstr "*-P*, *--pty*"
9774 #: ../login-utils/lslogins.1.adoc:77
9775 msgid "Display information related to login by password (see also *-afL*)."
9779 #: ../login-utils/lslogins.1.adoc:80 ../sys-utils/lsipc.1.adoc:73
9780 msgid "Raw output (no columnation)."
9783 #. type: Labeled list
9784 #: ../login-utils/lslogins.1.adoc:81
9786 #| msgid "*-f*, *--fast*"
9787 msgid "*-s*, *--system-accs*"
9788 msgstr "*-f*, *--fast*"
9791 #: ../login-utils/lslogins.1.adoc:83
9793 "Show system accounts. These are by default all accounts with a UID between "
9794 "101 and 999 (inclusive), with the exception of either nobody or nfsnobody "
9795 "(UID 65534). This hardcoded default may be overwritten by parameters "
9796 "*SYS_UID_MIN* and *SYS_UID_MAX* in the file _/etc/login.defs_."
9799 #. type: Labeled list
9800 #: ../login-utils/lslogins.1.adoc:84 ../sys-utils/lsipc.1.adoc:77
9802 msgid "*--time-format* _type_"
9806 #: ../login-utils/lslogins.1.adoc:86 ../sys-utils/lsipc.1.adoc:79
9808 "Display dates in short, full or iso format. The default is short, this time "
9809 "format is designed to be space efficient and human readable."
9812 #. type: Labeled list
9813 #: ../login-utils/lslogins.1.adoc:87
9815 #| msgid "*-V*, *--version*"
9816 msgid "*-u*, *--user-accs*"
9817 msgstr "*-V*, *--version*"
9820 #: ../login-utils/lslogins.1.adoc:89
9822 "Show user accounts. These are by default all accounts with UID above 1000 "
9823 "(inclusive), with the exception of either nobody or nfsnobody (UID 65534). "
9824 "This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX "
9825 "in the file _/etc/login.defs_."
9828 #. type: Labeled list
9829 #: ../login-utils/lslogins.1.adoc:92
9831 msgid "*--wtmp-file* _path_"
9835 #: ../login-utils/lslogins.1.adoc:94
9836 msgid "Alternate path for wtmp."
9839 #. type: Labeled list
9840 #: ../login-utils/lslogins.1.adoc:95
9842 msgid "*--lastlog* _path_"
9846 #: ../login-utils/lslogins.1.adoc:97
9847 msgid "Alternate path for *lastlog*(8)."
9850 #. type: Labeled list
9851 #: ../login-utils/lslogins.1.adoc:98 ../misc-utils/findmnt.8.adoc:187
9852 #: ../misc-utils/lsblk.8.adoc:174 ../sys-utils/lsipc.1.adoc:83
9854 #| msgid "*-h*, *--help*"
9855 msgid "*-y*, *--shell*"
9856 msgstr "*-h*, *--help*"
9859 #: ../login-utils/lslogins.1.adoc:100 ../sys-utils/lsipc.1.adoc:85
9861 "The column name will be modified to contain only characters allowed for "
9862 "shell variable identifiers. This is usable, for example, with *--export*. "
9863 "Note that this feature has been automatically enabled for *--export* in "
9864 "version 2.37, but due to compatibility issues, now it's necessary to request "
9865 "this behavior by *--shell*."
9868 #. type: Labeled list
9869 #: ../login-utils/lslogins.1.adoc:101 ../misc-utils/namei.1.adoc:59
9871 #| msgid "*-P*, *--pty*"
9872 msgid "*-Z*, *--context*"
9873 msgstr "*-P*, *--pty*"
9876 #: ../login-utils/lslogins.1.adoc:103
9878 #| msgid "Display help text and exit."
9879 msgid "Display the users' security context."
9880 msgstr "Zobrazí text nápovědy a skončí."
9882 #. type: Labeled list
9883 #: ../login-utils/lslogins.1.adoc:104
9885 #| msgid "*-P*, *--pty*"
9886 msgid "*-z*, *--print0*"
9887 msgstr "*-P*, *--pty*"
9890 #: ../login-utils/lslogins.1.adoc:106
9891 msgid "Delimit user entries with a nul character, instead of a newline."
9895 #: ../login-utils/lslogins.1.adoc:111 ../sys-utils/lsipc.1.adoc:90
9899 #. type: Labeled list
9900 #: ../login-utils/lslogins.1.adoc:112 ../login-utils/runuser.1.adoc:107
9901 #: ../login-utils/su.1.adoc:116 ../misc-utils/lsblk.8.adoc:188
9902 #: ../sys-utils/fstrim.8.adoc:78 ../sys-utils/hwclock.8.adoc:295
9903 #: ../sys-utils/lsipc.1.adoc:91
9909 #: ../login-utils/lslogins.1.adoc:114 ../sys-utils/lsipc.1.adoc:93
9910 msgid "if incorrect arguments specified,"
9913 #. type: Labeled list
9914 #: ../login-utils/lslogins.1.adoc:115 ../sys-utils/hwclock.8.adoc:298
9915 #: ../sys-utils/lsipc.1.adoc:94
9921 #: ../login-utils/lslogins.1.adoc:117
9922 msgid "if a serious error occurs (e.g., a corrupt log)."
9926 #: ../login-utils/lslogins.1.adoc:121
9927 msgid "The default UID thresholds are read from _/etc/login.defs_."
9931 #: ../login-utils/lslogins.1.adoc:122
9933 msgid "Password status"
9937 #: ../login-utils/lslogins.1.adoc:125
9938 msgid "Multiple fields describe password status."
9941 #. type: Labeled list
9942 #: ../login-utils/lslogins.1.adoc:126
9944 msgid "*\"Password is locked\"*"
9948 #: ../login-utils/lslogins.1.adoc:128
9950 "The password is prefixed by '!!', and the user cannot login although the "
9951 "password is set or empty. This is common for new accounts without a set "
9955 #. type: Labeled list
9956 #: ../login-utils/lslogins.1.adoc:129
9958 msgid "*\"Password not required (empty)\"*"
9962 #: ../login-utils/lslogins.1.adoc:131
9964 "The password is not set (hash is missing); this is common for locked system "
9965 "accounts. Not requiring a password does not mean the user can log-in without "
9966 "a password. It depends on the password \"lock\" status."
9969 #. type: Labeled list
9970 #: ../login-utils/lslogins.1.adoc:132
9972 msgid "*\"Login by password disabled\"*"
9976 #: ../login-utils/lslogins.1.adoc:134
9978 "'yes' means that there is no valid password. The password hash is missing, "
9979 "or the hash method is unknown or contains invalid chars."
9983 #: ../login-utils/lslogins.1.adoc:135 ../login-utils/nologin.8.adoc:59
9984 #: ../login-utils/runuser.1.adoc:129 ../login-utils/su.1.adoc:145
9985 #: ../login-utils/vipw.8.adoc:68 ../misc-utils/cal.1.adoc:173
9986 #: ../misc-utils/look.1.adoc:90 ../misc-utils/lsfd.1.adoc:697
9987 #: ../sys-utils/fstab.5.adoc:135 ../sys-utils/lsipc.1.adoc:97
9988 #: ../sys-utils/mount.8.adoc:1666 ../sys-utils/renice.1.adoc:92
9989 #: ../sys-utils/rtcwake.8.adoc:118 ../sys-utils/swapon.8.adoc:163
9990 #: ../sys-utils/umount.8.adoc:169 ../term-utils/mesg.1.adoc:91
9991 #: ../term-utils/script.1.adoc:151 ../term-utils/wall.1.adoc:77
9992 #: ../term-utils/write.1.adoc:78 ../text-utils/col.1.adoc:123
9993 #: ../text-utils/colcrt.1.adoc:66 ../text-utils/colrm.1.adoc:63
9994 #: ../text-utils/column.1.adoc:181 ../text-utils/more.1.adoc:186
9995 #: ../text-utils/ul.1.adoc:72
10000 #. type: Plain text
10001 #: ../login-utils/lslogins.1.adoc:138
10003 "The *lslogins* utility is inspired by the *logins* utility, which first "
10004 "appeared in FreeBSD 4.10."
10007 #. type: Plain text
10008 #: ../login-utils/lslogins.1.adoc:143 ../sys-utils/lsipc.1.adoc:105
10010 "mailto:ooprala@redhat.com[Ondrej Oprala], mailto:kzak@redhat.com[Karel Zak]"
10013 #. type: Plain text
10014 #: ../login-utils/lslogins.1.adoc:150
10023 #. Original author unknown. This man page is in the public domain.
10024 #. Modified Sat Oct 9 17:46:48 1993 by faith@cs.unc.edu
10026 #: ../login-utils/newgrp.1.adoc:4
10031 #. type: Plain text
10032 #: ../login-utils/newgrp.1.adoc:14
10033 msgid "newgrp - log in to a new group"
10036 #. type: Plain text
10037 #: ../login-utils/newgrp.1.adoc:18
10039 msgid "*newgrp* [_group_]\n"
10042 #. type: Plain text
10043 #: ../login-utils/newgrp.1.adoc:22
10045 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"
10048 #. type: Plain text
10049 #: ../login-utils/newgrp.1.adoc:24
10050 msgid "If no group is specified, the GID is changed to the login GID."
10053 #. type: Plain text
10054 #: ../login-utils/newgrp.1.adoc:33
10055 msgid "_/etc/group_, _/etc/passwd_"
10058 #. type: Plain text
10059 #: ../login-utils/newgrp.1.adoc:37
10061 "Originally by Michael Haardt. Currently maintained by mailto:poe@daimi.aau."
10062 "dk[Peter Orbaek]."
10065 #. type: Plain text
10066 #: ../login-utils/newgrp.1.adoc:42
10074 #: ../login-utils/nologin.8.adoc:2
10079 #. type: Plain text
10080 #: ../login-utils/nologin.8.adoc:12
10081 msgid "nologin - politely refuse a login"
10084 #. type: Plain text
10085 #: ../login-utils/nologin.8.adoc:16
10087 msgid "*nologin* [*-V*] [*-h*]\n"
10090 #. type: Plain text
10091 #: ../login-utils/nologin.8.adoc:20
10093 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"
10096 #. type: Plain text
10097 #: ../login-utils/nologin.8.adoc:22
10099 "If the file _/etc/nologin.txt_ exists, *nologin* displays its contents to "
10100 "the user instead of the default message."
10103 #. type: Plain text
10104 #: ../login-utils/nologin.8.adoc:24
10105 msgid "The exit status returned by *nologin* is always 1."
10108 #. type: Plain text
10109 #: ../login-utils/nologin.8.adoc:28
10111 #| msgid "*-c*, **--command**=__command__"
10112 msgid "*-c*, *--command* _command_\n"
10113 msgstr "*-c*, **--command**=__příkaz__"
10115 #. type: Plain text
10116 #: ../login-utils/nologin.8.adoc:30
10118 msgid "*--init-file*\n"
10121 #. type: Plain text
10122 #: ../login-utils/nologin.8.adoc:32
10124 msgid "*-i* *--interactive*\n"
10127 #. type: Plain text
10128 #: ../login-utils/nologin.8.adoc:34
10130 msgid "*--init-file* _file_\n"
10133 #. type: Plain text
10134 #: ../login-utils/nologin.8.adoc:36
10136 #| msgid "*-V*, *--version*"
10137 msgid "*-i*, *--interactive*\n"
10138 msgstr "*-V*, *--version*"
10140 #. type: Plain text
10141 #: ../login-utils/nologin.8.adoc:38
10143 #| msgid "*-*, *-l*, *--login*"
10144 msgid "*-l*, *--login*\n"
10145 msgstr "*-*, *-l*, *--login*"
10147 #. type: Plain text
10148 #: ../login-utils/nologin.8.adoc:40
10150 msgid "*--noprofile*\n"
10153 #. type: Plain text
10154 #: ../login-utils/nologin.8.adoc:42
10159 #. type: Plain text
10160 #: ../login-utils/nologin.8.adoc:44
10162 msgid "*--posix*\n"
10165 #. type: Plain text
10166 #: ../login-utils/nologin.8.adoc:46
10168 msgid "*--rcfile* _file_\n"
10171 #. type: Plain text
10172 #: ../login-utils/nologin.8.adoc:48
10174 #| msgid "*-V*, *--version*"
10175 msgid "*-r*, *--restricted*\n"
10176 msgstr "*-V*, *--version*"
10178 #. type: Plain text
10179 #: ../login-utils/nologin.8.adoc:50
10180 msgid "These shell command-line options are ignored to avoid *nologin* error."
10183 #. type: Plain text
10184 #: ../login-utils/nologin.8.adoc:56
10186 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"
10189 #. type: Plain text
10190 #: ../login-utils/nologin.8.adoc:58
10192 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"
10195 #. type: Plain text
10196 #: ../login-utils/nologin.8.adoc:62
10198 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
10199 msgid "The *nologin* command appeared in 4.4BSD."
10200 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
10202 #. type: Plain text
10203 #: ../login-utils/nologin.8.adoc:72
10208 "*pam_nologin*(8)\n"
10212 #: ../login-utils/runuser.1.adoc:2
10217 #. type: Plain text
10218 #: ../login-utils/runuser.1.adoc:12
10220 #| msgid "su - run a command with substitute user and group ID"
10221 msgid "runuser - run a command with substitute user and group ID"
10222 msgstr "su - spustí shell pod jiným uživatelským a skupinovým ID"
10224 #. type: Plain text
10225 #: ../login-utils/runuser.1.adoc:16
10227 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10228 msgid "*runuser* [options] *-u* _user_ [[--] _command_ [_argument_...]]\n"
10229 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10231 #. type: Plain text
10232 #: ../login-utils/runuser.1.adoc:18
10234 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10235 msgid "*runuser* [options] [*-*] [_user_ [_argument_...]]\n"
10236 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10238 #. type: Plain text
10239 #: ../login-utils/runuser.1.adoc:22
10241 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"
10244 #. type: Plain text
10245 #: ../login-utils/runuser.1.adoc:24
10247 "If the PAM session is not required, then the recommended solution is to use "
10248 "the *setpriv*(1) command."
10251 #. type: Plain text
10252 #: ../login-utils/runuser.1.adoc:26
10254 "When called without arguments, *runuser* defaults to running an interactive "
10258 #. type: Plain text
10259 #: ../login-utils/runuser.1.adoc:28
10262 #| "For backward compatibility, *su* defaults to not change the current "
10263 #| "directory and to only set the environment variables *HOME* and *SHELL* "
10264 #| "(plus *USER* and *LOGNAME* if the target _user_ is not root). It is "
10265 #| "recommended to always use the *--login* option (instead of its shortcut *-"
10266 #| "*) to avoid side effects caused by mixing environments."
10268 "For backward compatibility, *runuser* defaults to not changing the current "
10269 "directory and to setting only the environment variables *HOME* and *SHELL* "
10270 "(plus *USER* and *LOGNAME* if the target _user_ is not root). This version "
10271 "of *runuser* uses PAM for session management."
10273 "Z důvodu zpětné kompatibility *su* ve výchozí podobě nemění pracovní adresář "
10274 "a z proměnných prostředí pouze změní *HOME* a *SHELL* (a *USER* a *LOGNAME*, "
10275 "není-li cílový _uživatel_ root). Doporučuje se vždy použít přepínač *--"
10276 "login* (namísto jeho zkratky *-*), aby se zamezilo vedlejším účinkům "
10277 "způsobeným pomícháním prostředí."
10279 #. type: Plain text
10280 #: ../login-utils/runuser.1.adoc:30
10283 #| "Note that *su* in all cases uses PAM (*pam_getenvlist*(3)) to do the "
10284 #| "final environment modification. Command-line options such as *--login* "
10285 #| "and *--preserve-environment* affect the environment before it is modified "
10288 "Note that *runuser* in all cases use PAM (pam_getenvlist()) to do the final "
10289 "environment modification. Command-line options such as *--login* and *--"
10290 "preserve-environment* affect the environment before it is modified by PAM."
10292 "Pamatujte, že *su* ve všech případech používá PAM (*pam_getenvlist*(3)), aby "
10293 "upravil konečné prostředí. Přepínače příkazové řádky jako *--login* nebo *--"
10294 "preserve-environment* ovlivňují prostředí před tím, než je změněno systémem "
10297 #. type: Plain text
10298 #: ../login-utils/runuser.1.adoc:32
10301 #| "Since version 2.38 *su* resets process resource limits RLIMIT_NICE, "
10302 #| "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10304 "Since version 2.38 *runuser* resets process resource limits RLIMIT_NICE, "
10305 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10307 "Od verze 2.38 *su* resetuje omezení zdrojů procesu RLIMIT_NICE, "
10308 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS a RLIMIT_NOFILE."
10310 #. type: Labeled list
10311 #: ../login-utils/runuser.1.adoc:35
10313 #| msgid "*-c*, **--command**=__command__"
10314 msgid "*-c*, *--command*=_command_"
10315 msgstr "*-c*, **--command**=__příkaz__"
10317 #. type: Plain text
10318 #: ../login-utils/runuser.1.adoc:37 ../login-utils/su.1.adoc:38
10319 msgid "Pass _command_ to the shell with the *-c* option."
10320 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
10322 #. type: Labeled list
10323 #: ../login-utils/runuser.1.adoc:38 ../login-utils/su.1.adoc:39
10325 msgid "*-f*, *--fast*"
10326 msgstr "*-f*, *--fast*"
10328 #. type: Plain text
10329 #: ../login-utils/runuser.1.adoc:40 ../login-utils/su.1.adoc:41
10331 "Pass *-f* to the shell, which may or may not be useful, depending on the "
10334 "Předá shellu *-f*, což může, nebo nemusí být užitečné v závislosti na shellu."
10336 #. type: Labeled list
10337 #: ../login-utils/runuser.1.adoc:41
10339 #| msgid "*-g*, **--group**=__group__"
10340 msgid "*-g*, *--group*=_group_"
10341 msgstr "*-g*, **--group**=__skupina__"
10343 #. type: Plain text
10344 #: ../login-utils/runuser.1.adoc:43
10347 #| "Specify the primary group. This option is available to the root user only."
10349 "The primary group to be used. This option is allowed for the root user only."
10351 "Určuje primární skupinu. Tento přepínač je dostupný pouze uživateli root."
10353 #. type: Labeled list
10354 #: ../login-utils/runuser.1.adoc:44
10356 #| msgid "*-G*, **--supp-group**=__group__"
10357 msgid "*-G*, *--supp-group*=_group_"
10358 msgstr "*-G*, **--supp-group**=__skupina__"
10360 #. type: Plain text
10361 #: ../login-utils/runuser.1.adoc:46 ../login-utils/su.1.adoc:47
10363 "Specify a supplementary group. This option is available to the root user "
10364 "only. The first specified supplementary group is also used as a primary "
10365 "group if the option *--group* is not specified."
10367 "Určuje doplňkovou skupinu. Tento přepínač je dostupný pouze uživateli root. "
10368 "První zadaná doplňková skupina se rovněž použije jako primární skupina, "
10369 "nebyl-li zadán přepínač *--group*."
10371 #. type: Labeled list
10372 #: ../login-utils/runuser.1.adoc:47 ../login-utils/su.1.adoc:48
10374 msgid "*-*, *-l*, *--login*"
10375 msgstr "*-*, *-l*, *--login*"
10377 #. type: Plain text
10378 #: ../login-utils/runuser.1.adoc:49 ../login-utils/su.1.adoc:50
10380 "Start the shell as a login shell with an environment similar to a real login:"
10382 "Spustí shell jako přihlašovací shell s prostředím podobným skutečnému "
10385 #. type: Plain text
10386 #: ../login-utils/runuser.1.adoc:51
10389 #| "clears all the environment variables except *TERM* and variables "
10390 #| "specified by *--whitelist-environment*"
10392 "clears all the environment variables except for *TERM* and variables "
10393 "specified by *--whitelist-environment*"
10395 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
10396 "whitelist-environment*"
10398 #. type: Plain text
10399 #: ../login-utils/runuser.1.adoc:52 ../login-utils/su.1.adoc:53
10401 "initializes the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, "
10404 "inicializuje proměnné prostředí *HOME*, *SHELL*, *USER*, *LOGNAME* a *PATH*"
10406 #. type: Plain text
10407 #: ../login-utils/runuser.1.adoc:53 ../login-utils/su.1.adoc:54
10408 msgid "changes to the target user's home directory"
10409 msgstr "přejde do domovského adresáře cílového uživatele"
10411 #. type: Plain text
10412 #: ../login-utils/runuser.1.adoc:54 ../login-utils/su.1.adoc:55
10414 "sets argv[0] of the shell to '*-*' in order to make the shell a login shell"
10416 "nastaví argv[0] shellu na '*-*', aby se shell stal shellem přihlašovacím"
10418 #. type: Labeled list
10419 #: ../login-utils/runuser.1.adoc:55 ../login-utils/su.1.adoc:56
10421 msgid "*-m*, *-p*, *--preserve-environment*"
10422 msgstr "*-m*, *-p*, *--preserve-environment*"
10424 #. type: Plain text
10425 #: ../login-utils/runuser.1.adoc:57
10428 #| "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* "
10429 #| "or *LOGNAME*. This option is ignored if the option *--login* is specified."
10431 "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
10432 "*LOGNAME*. The option is ignored if the option *--login* is specified."
10434 "Zachová celé prostředí. Tj. nenastaví *HOME*, *SHELL*, *USER*, ani "
10435 "*LOGNAME*. Tento přepínač se ignoruje, byl-li uveden přepínač *--login*."
10437 #. type: Labeled list
10438 #: ../login-utils/runuser.1.adoc:58 ../login-utils/su.1.adoc:59
10440 msgid "*-P*, *--pty*"
10441 msgstr "*-P*, *--pty*"
10443 #. type: Plain text
10444 #: ../login-utils/runuser.1.adoc:60
10447 #| "Create a pseudo-terminal for the session. The independent terminal "
10448 #| "provides better security as the user does not share a terminal with the "
10449 #| "original session. This can be used to avoid *TIOCSTI* ioctl terminal "
10450 #| "injection and other security attacks against terminal file descriptors. "
10451 #| "The entire session can also be moved to the background (e.g., *su --pty* "
10452 #| "**-** __username__ *-c* _application_ *&*). If the pseudo-terminal is "
10453 #| "enabled, then *su* works as a proxy between the sessions (sync stdin and "
10456 "Create a pseudo-terminal for the session. The independent terminal provides "
10457 "better security as the user does not share a terminal with the original "
10458 "session. This can be used to avoid TIOCSTI ioctl terminal injection and "
10459 "other security attacks against terminal file descriptors. The entire session "
10460 "can also be moved to the background (e.g., *runuser --pty* *-u* _username_ "
10461 "*--* _command_ *&*). If the pseudo-terminal is enabled, then *runuser* works "
10462 "as a proxy between the sessions (sync stdin and stdout)."
10464 "Pro relaci vytvoří pseudoterminál. Nezávislý terminál poskytuje větší "
10465 "bezpečí, neboť uživatel nesdílí terminál s původní relací. Toho lze využít "
10466 "k zabránění vložení řídícího volání *TIOCSTI* terminálu a jiným "
10467 "bezpečnostním útokům na deskriptory souboru terminálu. Rovněž celou relaci "
10468 "je možné přesunout na pozadí (např. *su --pty* **-** __uživatel__ *-c* "
10469 "_aplikace_ *&*). Je-li pseudoterminál zapnut, pak *su* bude pracovat jako "
10470 "prostředník mezi relacemi (synchronizovat standardní vstup a výstup)."
10472 #. type: Plain text
10473 #: ../login-utils/runuser.1.adoc:62
10476 #| "This feature is mostly designed for interactive sessions. If the standard "
10477 #| "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | "
10478 #| "su --pty*), then the *ECHO* flag for the pseudo-terminal is disabled to "
10479 #| "avoid messy output."
10481 "This feature is mostly designed for interactive sessions. If the standard "
10482 "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | "
10483 "runuser --pty -u* _user_), then the *ECHO* flag for the pseudo-terminal is "
10484 "disabled to avoid messy output."
10486 "Tato funkce je převážně navržena pro interaktivní relace. Pokud standardní "
10487 "vstup není terminál, ale například rourou (př. *echo \"date\" | su --pty*), "
10488 "pak příznak *ECHO* pseudoterminálu bude vypnut, aby se předešlo zaneřádění "
10491 #. type: Labeled list
10492 #: ../login-utils/runuser.1.adoc:63
10494 #| msgid "*-s*, **--shell**=__shell__"
10495 msgid "*-s*, *--shell*=_shell_"
10496 msgstr "*-s*, **--shell**=__shell__"
10498 #. type: Plain text
10499 #: ../login-utils/runuser.1.adoc:65 ../login-utils/su.1.adoc:66
10501 "Run the specified _shell_ instead of the default. The shell to run is "
10502 "selected according to the following rules, in order:"
10504 "Spustí zadaný _shell_ namísto výchozího. Který shell by se měl spustit, se "
10505 "vybírá na základě následujících pravidel v tomto pořadí:"
10507 #. type: Plain text
10508 #: ../login-utils/runuser.1.adoc:67 ../login-utils/su.1.adoc:68
10509 msgid "the shell specified with *--shell*"
10510 msgstr "shell zadaný pomocí *--shell*"
10512 #. type: Plain text
10513 #: ../login-utils/runuser.1.adoc:68
10516 #| "the shell specified in the environment variable *SHELL*, if the *--"
10517 #| "preserve-environment* option is used"
10519 "the shell specified in the environment variable *SHELL* if the *--preserve-"
10520 "environment* option is used"
10522 "shell určený proměnnou prostředí *SHELL*, je-li použit přepínač *--preserve-"
10525 #. type: Plain text
10526 #: ../login-utils/runuser.1.adoc:69 ../login-utils/su.1.adoc:70
10527 msgid "the shell listed in the passwd entry of the target user"
10528 msgstr "shell uvedený v záznamu passwd cílového uživatele"
10530 #. type: Plain text
10531 #: ../login-utils/runuser.1.adoc:70 ../login-utils/su.1.adoc:71
10535 #. type: Plain text
10536 #: ../login-utils/runuser.1.adoc:72
10539 #| "If the target user has a restricted shell (i.e., not listed in _/etc/"
10540 #| "shells_), the *--shell* option and the *SHELL* environment variables are "
10541 #| "ignored unless the calling user is root."
10543 "If the target user has a restricted shell (i.e., not listed in _/etc/"
10544 "shells_), then the *--shell* option and the *SHELL* environment variables "
10545 "are ignored unless the calling user is root."
10547 "Je-li shell cílového uživatele omezený (tj. neuvedený v _/etc/shells_), "
10548 "přepínač *--shell* a proměnná prostředí *SHELL* jsou ignorovány, pokud "
10549 "volajícím není root."
10551 #. type: Labeled list
10552 #: ../login-utils/runuser.1.adoc:73 ../login-utils/su.1.adoc:74
10554 msgid "**--session-command=**__command__"
10555 msgstr "**--session-command=**__příkaz__"
10557 #. type: Plain text
10558 #: ../login-utils/runuser.1.adoc:75 ../login-utils/su.1.adoc:76
10559 msgid "Same as *-c*, but do not create a new session. (Discouraged.)"
10560 msgstr "Stejné jako *-c*, ale nevytvoří novou relaci. (Nedoporučuje se.)"
10562 #. type: Labeled list
10563 #: ../login-utils/runuser.1.adoc:76 ../login-utils/su.1.adoc:77
10565 #| msgid "*-P*, *--pty*"
10566 msgid "*-T*, *--no-pty**"
10567 msgstr "*-P*, *--pty*"
10569 #. type: Plain text
10570 #: ../login-utils/runuser.1.adoc:79 ../login-utils/su.1.adoc:80
10572 "Do not create a pseudo-terminal, opposite of *--pty* and *-P*. Note that "
10573 "running without a pseudo-terminal opens the security risk of privilege "
10574 "escalation through TIOCSTI/TIOCLINUX ioctl command injection."
10577 #. type: Labeled list
10578 #: ../login-utils/runuser.1.adoc:80
10580 #| msgid "*-w*, **--whitelist-environment**=__list__"
10581 msgid "*-w*, *--whitelist-environment*=_list_"
10582 msgstr "*-w*, **--whitelist-environment**=__seznam__"
10584 #. type: Plain text
10585 #: ../login-utils/runuser.1.adoc:82 ../login-utils/su.1.adoc:83
10587 "Don't reset the environment variables specified in the comma-separated "
10588 "_list_ when clearing the environment for *--login*. The whitelist is ignored "
10589 "for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*."
10591 "Neresetuje proměnné prostředí uvedené v čárkou odděleném _seznamu_, když se "
10592 "čistí prostředí pro *--login*. Tento seznam se ignoruje pro proměnné "
10593 "prostředí *HOME*, *SHELL*, *USER*, *LOGNAME* a *PATH*."
10596 #: ../login-utils/runuser.1.adoc:85 ../login-utils/su.1.adoc:90
10598 msgid "CONFIG FILES"
10599 msgstr "KONFIGURAČNÍ SOUBORY"
10601 #. type: Plain text
10602 #: ../login-utils/runuser.1.adoc:88
10604 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
10605 msgid "*runuser* reads the _/etc/default/runuser_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *runuser*:\n"
10606 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"
10608 #. type: Plain text
10609 #: ../login-utils/runuser.1.adoc:91
10612 #| "Defines the *PATH* environment variable for a regular user. The default "
10613 #| "value is _/usr/local/bin:/bin:/usr/bin_."
10615 "Defines the PATH environment variable for a regular user. The default value "
10616 "is _/usr/local/bin:/bin:/usr/bin_."
10618 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
10619 "usr/local/bin:/bin:/usr/bin_."
10621 #. type: Plain text
10622 #: ../login-utils/runuser.1.adoc:95 ../login-utils/su.1.adoc:104
10624 "Defines the *PATH* environment variable for root. *ENV_SUPATH* takes "
10625 "precedence. The default value is _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/"
10626 "usr/sbin:/usr/bin_."
10628 "Určuje proměnnou prostředí *PATH* pro uživatele root. *ENV_SUPATH* má "
10629 "přednost. Výchozí hodnota je _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/"
10632 #. type: Labeled list
10633 #: ../login-utils/runuser.1.adoc:96 ../login-utils/su.1.adoc:105
10635 msgid "*ALWAYS_SET_PATH* (boolean)"
10636 msgstr "*ALWAYS_SET_PATH* (pravdivostní hodnota)"
10638 #. type: Plain text
10639 #: ../login-utils/runuser.1.adoc:98
10642 #| "If set to _yes_ and *--login* and *--preserve-environment* were not "
10643 #| "specified *su* initializes *PATH*."
10645 "If set to _yes_ and *--login* and *--preserve-environment* were not "
10646 "specified *runuser* initializes *PATH*."
10648 "Je-li nastaveno na _yes_ a *--login* a *--preserve-environment* nebyly-li "
10649 "zadány, *su* inicializuje *PATH*."
10651 #. type: Plain text
10652 #: ../login-utils/runuser.1.adoc:100 ../login-utils/su.1.adoc:109
10654 "The environment variable *PATH* may be different on systems where _/bin_ and "
10655 "_/sbin_ are merged into _/usr_; this variable is also affected by the *--"
10656 "login* command-line option and the PAM system setting (e.g., *pam_env*(8))."
10658 "Proměnná prostředí *PATH* se může lišit na systémech, kde _/bin_ a _/sbin_ "
10659 "jsou začleněny do _/usr_. Tato proměnná je rovněž ovlivněna přepínačem "
10660 "příkazové řádky *--login* a nastavením systému PAM (např. *pam_env*(8))."
10662 #. type: Plain text
10663 #: ../login-utils/runuser.1.adoc:104
10665 #| 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"
10666 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"
10667 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"
10669 #. type: Plain text
10670 #: ../login-utils/runuser.1.adoc:106
10672 #| msgid "Exit status generated by *su* itself:"
10673 msgid "Exit status generated by *runuser* itself:"
10674 msgstr "Návratová hodnota vyrobená nástrojem *su* samotným:"
10676 #. type: Plain text
10677 #: ../login-utils/runuser.1.adoc:109 ../login-utils/su.1.adoc:118
10678 msgid "Generic error before executing the requested command"
10679 msgstr "Obecná chyba před spuštěním požadovaného příkazu"
10681 #. type: Labeled list
10682 #: ../login-utils/runuser.1.adoc:109 ../login-utils/su.1.adoc:118
10687 #. type: Plain text
10688 #: ../login-utils/runuser.1.adoc:111 ../login-utils/su.1.adoc:120
10689 msgid "The requested command could not be executed"
10690 msgstr "Požadovaný příkaz nebylo možné spustit"
10692 #. type: Labeled list
10693 #: ../login-utils/runuser.1.adoc:111 ../login-utils/su.1.adoc:120
10698 #. type: Plain text
10699 #: ../login-utils/runuser.1.adoc:113 ../login-utils/su.1.adoc:122
10700 msgid "The requested command was not found"
10701 msgstr "Požadovaný příkaz nebyl nalezen"
10703 #. type: Labeled list
10704 #: ../login-utils/runuser.1.adoc:117
10706 #| msgid "_/etc/pam.d/su_"
10707 msgid "_/etc/pam.d/runuser_"
10708 msgstr "_/etc/pam.d/su_"
10710 #. type: Plain text
10711 #: ../login-utils/runuser.1.adoc:119 ../login-utils/su.1.adoc:127
10712 msgid "default PAM configuration file"
10713 msgstr "výchozí konfigurační soubor PAM"
10715 #. type: Labeled list
10716 #: ../login-utils/runuser.1.adoc:120
10718 #| msgid "_/etc/pam.d/su-l_"
10719 msgid "_/etc/pam.d/runuser-l_"
10720 msgstr "_/etc/pam.d/su-l_"
10722 #. type: Plain text
10723 #: ../login-utils/runuser.1.adoc:122 ../login-utils/su.1.adoc:130
10724 msgid "PAM configuration file if *--login* is specified"
10725 msgstr "konfigurační soubor PAM, byl-li zadán *--login*"
10727 #. type: Labeled list
10728 #: ../login-utils/runuser.1.adoc:123
10730 #| msgid "_/etc/default/su_"
10731 msgid "_/etc/default/runuser_"
10732 msgstr "_/etc/default/su_"
10734 #. type: Plain text
10735 #: ../login-utils/runuser.1.adoc:125
10737 #| msgid "command specific logindef config file"
10738 msgid "runuser specific logindef config file"
10739 msgstr "konfigurační soubor logindef určený tento nástroj"
10741 #. type: Labeled list
10742 #: ../login-utils/runuser.1.adoc:126 ../login-utils/su.1.adoc:134
10744 msgid "_/etc/login.defs_"
10745 msgstr "_/etc/login.defs_"
10747 #. type: Plain text
10748 #: ../login-utils/runuser.1.adoc:128 ../login-utils/su.1.adoc:136
10749 msgid "global logindef config file"
10750 msgstr "globální konfigurační soubor logindef"
10752 #. type: Plain text
10753 #: ../login-utils/runuser.1.adoc:132
10756 #| "This *su* command was derived from coreutils' *su*, which was based on an "
10757 #| "implementation by David MacKenzie. The util-linux version has been "
10758 #| "refactored by Karel Zak."
10760 "This *runuser* command was derived from coreutils' *su*, which was based on "
10761 "an implementation by David MacKenzie, and the Fedora *runuser* command by "
10764 "Tento nástroj *su* byl odvozen z *su* v balíku coreutils, který byl založen "
10765 "na implementaci Davida MacKenzie. Verze v util-linux byl přepsána Karlem "
10768 #. type: Plain text
10769 #: ../login-utils/runuser.1.adoc:140
10772 #| "*setpriv*(1),\n"
10773 #| "*login.defs*(5),\n"
10774 #| "*shells*(5),\n"
10776 #| "*runuser*(1)\n"
10780 "*login.defs*(5),\n"
10785 "*login.defs*(5),\n"
10791 #: ../login-utils/su.1.adoc:2
10796 #. type: Plain text
10797 #: ../login-utils/su.1.adoc:13
10798 msgid "su - run a command with substitute user and group ID"
10799 msgstr "su - spustí shell pod jiným uživatelským a skupinovým ID"
10801 #. type: Plain text
10802 #: ../login-utils/su.1.adoc:17
10804 msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10805 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
10807 #. type: Plain text
10808 #: ../login-utils/su.1.adoc:21
10810 msgid "*su* allows commands to be run with a substitute user and group ID.\n"
10811 msgstr "*su* dovoluje příkazům běžet se změněným ID uživatele a skupiny.\n"
10813 #. type: Plain text
10814 #: ../login-utils/su.1.adoc:23
10816 "When called with no _user_ specified, *su* defaults to running an "
10817 "interactive shell as _root_. When _user_ is specified, additional "
10818 "__argument__s can be supplied, in which case they are passed to the shell."
10820 "Je-li zavolán bez udání _uživatele_, *su* spustí interaktivní shell jako "
10821 "_root_. Je-li _uživatel_ zadán, lze zadat další _argumenty_ a ty budou "
10822 "v takovém případě předány shellu."
10824 #. type: Plain text
10825 #: ../login-utils/su.1.adoc:25
10827 "For backward compatibility, *su* defaults to not change the current "
10828 "directory and to only set the environment variables *HOME* and *SHELL* (plus "
10829 "*USER* and *LOGNAME* if the target _user_ is not root). It is recommended to "
10830 "always use the *--login* option (instead of its shortcut *-*) to avoid side "
10831 "effects caused by mixing environments."
10833 "Z důvodu zpětné kompatibility *su* ve výchozí podobě nemění pracovní adresář "
10834 "a z proměnných prostředí pouze změní *HOME* a *SHELL* (a *USER* a *LOGNAME*, "
10835 "není-li cílový _uživatel_ root). Doporučuje se vždy použít přepínač *--"
10836 "login* (namísto jeho zkratky *-*), aby se zamezilo vedlejším účinkům "
10837 "způsobeným pomícháním prostředí."
10839 #. type: Plain text
10840 #: ../login-utils/su.1.adoc:27
10842 "This version of *su* uses PAM for authentication, account and session "
10843 "management. Some configuration options found in other *su* implementations, "
10844 "such as support for a wheel group, have to be configured via PAM."
10846 "Tato verze *su* používá pro autentizaci, autorizaci a správu relace PAM. "
10847 "Některé možnosti nastavení nacházející se v jiných implementacích *su*, jako "
10848 "podpora skupiny wheel, se musí nastavit přes PAM."
10850 #. type: Plain text
10851 #: ../login-utils/su.1.adoc:29
10853 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"
10854 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"
10856 #. type: Plain text
10857 #: ../login-utils/su.1.adoc:31
10859 "Note that *su* in all cases uses PAM (*pam_getenvlist*(3)) to do the final "
10860 "environment modification. Command-line options such as *--login* and *--"
10861 "preserve-environment* affect the environment before it is modified by PAM."
10863 "Pamatujte, že *su* ve všech případech používá PAM (*pam_getenvlist*(3)), aby "
10864 "upravil konečné prostředí. Přepínače příkazové řádky jako *--login* nebo *--"
10865 "preserve-environment* ovlivňují prostředí před tím, než je změněno systémem "
10868 #. type: Plain text
10869 #: ../login-utils/su.1.adoc:33
10871 "Since version 2.38 *su* resets process resource limits RLIMIT_NICE, "
10872 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS and RLIMIT_NOFILE."
10874 "Od verze 2.38 *su* resetuje omezení zdrojů procesu RLIMIT_NICE, "
10875 "RLIMIT_RTPRIO, RLIMIT_FSIZE, RLIMIT_AS a RLIMIT_NOFILE."
10877 #. type: Labeled list
10878 #: ../login-utils/su.1.adoc:36
10880 msgid "*-c*, **--command**=__command__"
10881 msgstr "*-c*, **--command**=__příkaz__"
10883 #. type: Labeled list
10884 #: ../login-utils/su.1.adoc:42
10886 msgid "*-g*, **--group**=__group__"
10887 msgstr "*-g*, **--group**=__skupina__"
10889 #. type: Plain text
10890 #: ../login-utils/su.1.adoc:44
10892 "Specify the primary group. This option is available to the root user only."
10894 "Určuje primární skupinu. Tento přepínač je dostupný pouze uživateli root."
10896 #. type: Labeled list
10897 #: ../login-utils/su.1.adoc:45
10899 msgid "*-G*, **--supp-group**=__group__"
10900 msgstr "*-G*, **--supp-group**=__skupina__"
10902 #. type: Plain text
10903 #: ../login-utils/su.1.adoc:52
10905 "clears all the environment variables except *TERM* and variables specified "
10906 "by *--whitelist-environment*"
10908 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
10909 "whitelist-environment*"
10911 #. type: Plain text
10912 #: ../login-utils/su.1.adoc:58
10914 "Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
10915 "*LOGNAME*. This option is ignored if the option *--login* is specified."
10917 "Zachová celé prostředí. Tj. nenastaví *HOME*, *SHELL*, *USER*, ani "
10918 "*LOGNAME*. Tento přepínač se ignoruje, byl-li uveden přepínač *--login*."
10920 #. type: Plain text
10921 #: ../login-utils/su.1.adoc:61
10923 "Create a pseudo-terminal for the session. The independent terminal provides "
10924 "better security as the user does not share a terminal with the original "
10925 "session. This can be used to avoid *TIOCSTI* ioctl terminal injection and "
10926 "other security attacks against terminal file descriptors. The entire session "
10927 "can also be moved to the background (e.g., *su --pty* **-** __username__ *-"
10928 "c* _application_ *&*). If the pseudo-terminal is enabled, then *su* works as "
10929 "a proxy between the sessions (sync stdin and stdout)."
10931 "Pro relaci vytvoří pseudoterminál. Nezávislý terminál poskytuje větší "
10932 "bezpečí, neboť uživatel nesdílí terminál s původní relací. Toho lze využít "
10933 "k zabránění vložení řídícího volání *TIOCSTI* terminálu a jiným "
10934 "bezpečnostním útokům na deskriptory souboru terminálu. Rovněž celou relaci "
10935 "je možné přesunout na pozadí (např. *su --pty* **-** __uživatel__ *-c* "
10936 "_aplikace_ *&*). Je-li pseudoterminál zapnut, pak *su* bude pracovat jako "
10937 "prostředník mezi relacemi (synchronizovat standardní vstup a výstup)."
10939 #. type: Plain text
10940 #: ../login-utils/su.1.adoc:63
10942 "This feature is mostly designed for interactive sessions. If the standard "
10943 "input is not a terminal, but for example a pipe (e.g., *echo \"date\" | su --"
10944 "pty*), then the *ECHO* flag for the pseudo-terminal is disabled to avoid "
10947 "Tato funkce je převážně navržena pro interaktivní relace. Pokud standardní "
10948 "vstup není terminál, ale například rourou (př. *echo \"date\" | su --pty*), "
10949 "pak příznak *ECHO* pseudoterminálu bude vypnut, aby se předešlo zaneřádění "
10952 #. type: Labeled list
10953 #: ../login-utils/su.1.adoc:64
10955 msgid "*-s*, **--shell**=__shell__"
10956 msgstr "*-s*, **--shell**=__shell__"
10958 #. type: Plain text
10959 #: ../login-utils/su.1.adoc:69
10961 "the shell specified in the environment variable *SHELL*, if the *--preserve-"
10962 "environment* option is used"
10964 "shell určený proměnnou prostředí *SHELL*, je-li použit přepínač *--preserve-"
10967 #. type: Plain text
10968 #: ../login-utils/su.1.adoc:73
10970 "If the target user has a restricted shell (i.e., not listed in _/etc/"
10971 "shells_), the *--shell* option and the *SHELL* environment variables are "
10972 "ignored unless the calling user is root."
10974 "Je-li shell cílového uživatele omezený (tj. neuvedený v _/etc/shells_), "
10975 "přepínač *--shell* a proměnná prostředí *SHELL* jsou ignorovány, pokud "
10976 "volajícím není root."
10978 #. type: Labeled list
10979 #: ../login-utils/su.1.adoc:81
10981 msgid "*-w*, **--whitelist-environment**=__list__"
10982 msgstr "*-w*, **--whitelist-environment**=__seznam__"
10985 #: ../login-utils/su.1.adoc:86 ../term-utils/script.1.adoc:123
10990 #. type: Plain text
10991 #: ../login-utils/su.1.adoc:89
10993 "Upon receiving either *SIGINT*, *SIGQUIT* or *SIGTERM*, *su* terminates its "
10994 "child and afterwards terminates itself with the received signal. The child "
10995 "is terminated by *SIGTERM*, after unsuccessful attempt and 2 seconds of "
10996 "delay the child is killed by *SIGKILL*."
10998 "Po přijetí signálu *SIGINT*, *SIGQUIT* nebo *SIGTERM* *su* ukončí svého "
10999 "potomka a poté ukončí sebe přijatým signálem. Potomek bude ukončen signálem "
11000 "*SIGTERM*. Při neúspěšném pokusu bude po 2 sekundách prodlení potomek zabit "
11001 "signálem *SIGKILL*."
11003 #. TRANSLATORS: Keep {colon} untranslated
11004 #. type: Plain text
11005 #: ../login-utils/su.1.adoc:94
11007 msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
11008 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"
11010 #. type: Plain text
11011 #: ../login-utils/su.1.adoc:97
11013 "Delay in seconds in case of an authentication failure. The number must be a "
11014 "non-negative integer."
11016 "Zpoždění v sekundách v případě selhání přihlášení. Hodnota musí být "
11017 "nezáporné celé číslo."
11019 #. type: Plain text
11020 #: ../login-utils/su.1.adoc:100
11022 "Defines the *PATH* environment variable for a regular user. The default "
11023 "value is _/usr/local/bin:/bin:/usr/bin_."
11025 "Určuje proměnnou prostředí *PATH* pro běžné uživatele. Výchozí hodnota je _/"
11026 "usr/local/bin:/bin:/usr/bin_."
11028 #. type: Plain text
11029 #: ../login-utils/su.1.adoc:107
11031 "If set to _yes_ and *--login* and *--preserve-environment* were not "
11032 "specified *su* initializes *PATH*."
11034 "Je-li nastaveno na _yes_ a *--login* a *--preserve-environment* nebyly-li "
11035 "zadány, *su* inicializuje *PATH*."
11037 #. type: Plain text
11038 #: ../login-utils/su.1.adoc:113
11040 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"
11041 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"
11043 #. type: Plain text
11044 #: ../login-utils/su.1.adoc:115
11045 msgid "Exit status generated by *su* itself:"
11046 msgstr "Návratová hodnota vyrobená nástrojem *su* samotným:"
11048 #. type: Labeled list
11049 #: ../login-utils/su.1.adoc:125
11051 msgid "_/etc/pam.d/su_"
11052 msgstr "_/etc/pam.d/su_"
11054 #. type: Labeled list
11055 #: ../login-utils/su.1.adoc:128
11057 msgid "_/etc/pam.d/su-l_"
11058 msgstr "_/etc/pam.d/su-l_"
11060 #. type: Labeled list
11061 #: ../login-utils/su.1.adoc:131
11063 msgid "_/etc/default/su_"
11064 msgstr "_/etc/default/su_"
11066 #. type: Plain text
11067 #: ../login-utils/su.1.adoc:133
11068 msgid "command specific logindef config file"
11069 msgstr "konfigurační soubor logindef určený tento nástroj"
11071 #. type: Plain text
11072 #: ../login-utils/su.1.adoc:140
11074 "For security reasons, *su* always logs failed log-in attempts to the _btmp_ "
11075 "file, but it does not write to the _lastlog_ file at all. This solution can "
11076 "be used to control *su* behavior by PAM configuration. If you want to use "
11077 "the *pam_lastlog*(8) module to print warning message about failed log-in "
11078 "attempts then *pam_lastlog*(8) has to be configured to update the _lastlog_ "
11079 "file as well. For example by:"
11081 "Z bezpečnostních důvodů *su* vždy zaprotokoluje selhané pokusy o přihlášení "
11082 "to souboru _btmp_, avšak vůbec nezapisuje do souboru _lastlog_. Následující "
11083 "řešení pomocí nastavení PAM lze použít k ovlivnění chování *su*. Chcete-li "
11084 "používat modul *pam_lastlog*(8) pro vypisování varování o selhaných "
11085 "přihlašovacích pokusech, pak *pam_lastlog*(8) musí být nastaven tak, aby "
11086 "rovněž aktualizoval soubor _lastlog_. Například:"
11088 #. type: delimited block _
11089 #: ../login-utils/su.1.adoc:143
11090 msgid "session required pam_lastlog.so nowtmp"
11091 msgstr "session required pam_lastlog.so nowtmp"
11093 #. type: Plain text
11094 #: ../login-utils/su.1.adoc:148
11096 "This *su* command was derived from coreutils' *su*, which was based on an "
11097 "implementation by David MacKenzie. The util-linux version has been "
11098 "refactored by Karel Zak."
11100 "Tento nástroj *su* byl odvozen z *su* v balíku coreutils, který byl založen "
11101 "na implementaci Davida MacKenzie. Verze v util-linux byl přepsána Karlem "
11104 #. type: Plain text
11105 #: ../login-utils/su.1.adoc:156
11109 "*login.defs*(5),\n"
11115 "*login.defs*(5),\n"
11123 #. Copyright (C) 1998-2006 Miquel van Smoorenburg.
11124 #. Copyright (C) 2012 Karel Zak <kzak@redhat.com>
11125 #. This program is free software; you can redistribute it and/or modify
11126 #. it under the terms of the GNU General Public License as published by
11127 #. the Free Software Foundation; either version 2 of the License, or
11128 #. (at your option) any later version.
11129 #. This program is distributed in the hope that it will be useful,
11130 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
11131 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11132 #. GNU General Public License for more details.
11133 #. You should have received a copy of the GNU General Public License
11134 #. along with this program; if not, write to the Free Software
11135 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
11137 #: ../login-utils/sulogin.8.adoc:20
11142 #. type: Plain text
11143 #: ../login-utils/sulogin.8.adoc:31
11144 msgid "sulogin - single-user login"
11147 #. type: Plain text
11148 #: ../login-utils/sulogin.8.adoc:35
11150 msgid "*sulogin* [options] [_tty_]\n"
11153 #. type: Plain text
11154 #: ../login-utils/sulogin.8.adoc:39
11156 msgid "*sulogin* is invoked by *init* when the system goes into single-user mode.\n"
11159 #. type: Plain text
11160 #: ../login-utils/sulogin.8.adoc:41
11161 msgid "The user is prompted:"
11164 #. type: Plain text
11165 #: ../login-utils/sulogin.8.adoc:43
11167 "Give root password for system maintenance (or type Control-D for normal "
11171 #. type: Plain text
11172 #: ../login-utils/sulogin.8.adoc:45
11174 "If the root account is locked and *--force* is specified, no password is "
11178 #. type: Plain text
11179 #: ../login-utils/sulogin.8.adoc:47
11181 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"
11184 #. type: Plain text
11185 #: ../login-utils/sulogin.8.adoc:49
11187 "When the user exits from the single-user shell, or presses control-D at the "
11188 "prompt, the system will continue to boot."
11191 #. type: Labeled list
11192 #: ../login-utils/sulogin.8.adoc:52
11194 #| msgid "*-f*, *--fast*"
11195 msgid "*-e*, *--force*"
11196 msgstr "*-f*, *--fast*"
11198 #. TRANSLATORS: Keep {asterisk} untranslated.
11199 #. type: Plain text
11200 #: ../login-utils/sulogin.8.adoc:54
11202 "If the default method of obtaining the root password from the system via "
11203 "*getpwnam*(3) fails, then examine _/etc/passwd_ and _/etc/shadow_ to get the "
11204 "password. If these files are damaged or nonexistent, or when root account is "
11205 "locked by '!' or '{asterisk}' at the begin of the password then *sulogin* "
11206 "will *start a root shell without asking for a password*."
11209 #. type: Plain text
11210 #: ../login-utils/sulogin.8.adoc:57
11212 "Only use the *-e* option if you are sure the console is physically protected "
11213 "against unauthorized access."
11216 #. type: Labeled list
11217 #: ../login-utils/sulogin.8.adoc:58
11219 #| msgid "*-h*, *--help*"
11220 msgid "*-p*, *--login-shell*"
11221 msgstr "*-h*, *--help*"
11223 #. type: Plain text
11224 #: ../login-utils/sulogin.8.adoc:60
11226 "Specifying this option causes *sulogin* to start the shell process as a "
11230 #. type: Labeled list
11231 #: ../login-utils/sulogin.8.adoc:61 ../misc-utils/waitpid.1.adoc:29
11233 msgid "*-t*, *--timeout* _seconds_"
11236 #. type: Plain text
11237 #: ../login-utils/sulogin.8.adoc:63
11239 "Specify the maximum amount of time to wait for user input. By default, "
11240 "*sulogin* will wait forever."
11243 #. type: Plain text
11244 #: ../login-utils/sulogin.8.adoc:69
11246 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"
11249 #. type: Plain text
11250 #: ../login-utils/sulogin.8.adoc:73
11252 msgid "*sulogin* was written by Miquel van Smoorenburg for sysvinit and later ported to util-linux by Dave Reisner and Karel Zak.\n"
11258 #. Copyright (C) 2010 Michael Krapp
11259 #. This program is free software; you can redistribute it and/or modify
11260 #. it under the terms of the GNU General Public License as published by
11261 #. the Free Software Foundation; either version 2 of the License, or
11262 #. (at your option) any later version.
11263 #. This program is distributed in the hope that it will be useful,
11264 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
11265 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11266 #. GNU General Public License for more details.
11267 #. You should have received a copy of the GNU General Public License
11268 #. along with this program; if not, write to the Free Software
11269 #. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
11271 #: ../login-utils/utmpdump.1.adoc:19
11273 msgid "utmpdump(1)"
11276 #. type: Plain text
11277 #: ../login-utils/utmpdump.1.adoc:29
11278 msgid "utmpdump - dump UTMP and WTMP files in raw format"
11281 #. type: Plain text
11282 #: ../login-utils/utmpdump.1.adoc:33
11284 msgid "*utmpdump* [options] _filename_\n"
11287 #. type: Plain text
11288 #: ../login-utils/utmpdump.1.adoc:37
11290 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"
11293 #. type: Labeled list
11294 #: ../login-utils/utmpdump.1.adoc:40
11296 #| msgid "*-f*, *--fast*"
11297 msgid "*-f*, *--follow*"
11298 msgstr "*-f*, *--fast*"
11300 #. type: Plain text
11301 #: ../login-utils/utmpdump.1.adoc:42
11302 msgid "Output appended data as the file grows."
11305 #. type: Labeled list
11306 #: ../login-utils/utmpdump.1.adoc:43
11308 #| msgid "*-P*, *--pty*"
11309 msgid "*-o*, *--output* _file_"
11310 msgstr "*-P*, *--pty*"
11312 #. type: Plain text
11313 #: ../login-utils/utmpdump.1.adoc:45
11314 msgid "Write command output to _file_ instead of standard output."
11317 #. type: Labeled list
11318 #: ../login-utils/utmpdump.1.adoc:46
11320 #| msgid "*-V*, *--version*"
11321 msgid "*-r*, *--reverse*"
11322 msgstr "*-V*, *--version*"
11324 #. type: Plain text
11325 #: ../login-utils/utmpdump.1.adoc:48
11327 "Undump, write back edited login information into the utmp or wtmp files."
11330 #. type: Plain text
11331 #: ../login-utils/utmpdump.1.adoc:54
11333 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"
11336 #. type: delimited block _
11337 #: ../login-utils/utmpdump.1.adoc:57
11339 msgid "*utmpdump -r < ascii_file > wtmp*\n"
11342 #. type: Plain text
11343 #: ../login-utils/utmpdump.1.adoc:60
11344 msgid "But be warned, *utmpdump* was written for debugging purposes only."
11347 #. type: Plain text
11348 #: ../login-utils/utmpdump.1.adoc:64
11350 "Only the binary version of the *utmp*(5) is standardised. Textual dumps may "
11351 "become incompatible in future."
11354 #. type: Plain text
11355 #: ../login-utils/utmpdump.1.adoc:66
11357 "The version 2.28 was the last one that printed text output using *ctime*(3) "
11358 "timestamp format. Newer dumps use millisecond precision ISO-8601 timestamp "
11359 "format in UTC-0 timezone. Conversion from former timestamp format can be "
11360 "made to binary, although attempt to do so can lead the timestamps to drift "
11361 "amount of timezone offset."
11364 #. type: Plain text
11365 #: ../login-utils/utmpdump.1.adoc:70
11367 "You may *not* use the *-r* option, as the format for the utmp/wtmp files "
11368 "strongly depends on the input format. This tool was *not* written for normal "
11369 "use, but for debugging only."
11372 #. type: Plain text
11373 #: ../login-utils/utmpdump.1.adoc:74
11374 msgid "Michael Krapp"
11377 #. type: Plain text
11378 #: ../login-utils/utmpdump.1.adoc:81
11397 #. Copyright (c) 1983, 1991 The Regents of the University of California.
11398 #. All rights reserved.
11399 #. Redistribution and use in source and binary forms, with or without
11400 #. modification, are permitted provided that the following conditions
11402 #. 1. Redistributions of source code must retain the above copyright
11403 #. notice, this list of conditions and the following disclaimer.
11404 #. 2. Redistributions in binary form must reproduce the above copyright
11405 #. notice, this list of conditions and the following disclaimer in the
11406 #. documentation and/or other materials provided with the distribution.
11407 #. 3. All advertising materials mentioning features or use of this software
11408 #. must display the following acknowledgement:
11409 #. This product includes software developed by the University of
11410 #. California, Berkeley and its contributors.
11411 #. 4. Neither the name of the University nor the names of its contributors
11412 #. may be used to endorse or promote products derived from this software
11413 #. without specific prior written permission.
11414 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
11415 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
11416 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
11417 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
11418 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
11419 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
11420 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
11421 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
11422 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
11423 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
11425 #. @(#)vipw.8 6.7 (Berkeley) 3/16/91
11427 #: ../login-utils/vipw.8.adoc:36
11432 #. type: Plain text
11433 #: ../login-utils/vipw.8.adoc:46
11434 msgid "vipw, vigr - edit the password or group file"
11437 #. type: Plain text
11438 #: ../login-utils/vipw.8.adoc:50
11440 msgid "*vipw* [options]\n"
11443 #. type: Plain text
11444 #: ../login-utils/vipw.8.adoc:52
11446 msgid "*vigr* [options]\n"
11449 #. type: Plain text
11450 #: ../login-utils/vipw.8.adoc:56
11452 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"
11455 #. type: Plain text
11456 #: ../login-utils/vipw.8.adoc:64
11458 "If the following environment variable exists, it will be utilized by *vipw* "
11462 #. type: Labeled list
11463 #: ../login-utils/vipw.8.adoc:65 ../text-utils/more.1.adoc:180
11468 #. type: Plain text
11469 #: ../login-utils/vipw.8.adoc:67
11471 "The editor specified by the string *EDITOR* will be invoked instead of the "
11472 "default editor *vi*(1)."
11475 #. type: Plain text
11476 #: ../login-utils/vipw.8.adoc:71
11478 "The *vipw* command appeared in 4.0BSD. The *vigr* command appeared in Util-"
11482 #. type: Plain text
11483 #: ../login-utils/vipw.8.adoc:78
11492 #. type: Plain text
11493 #: ../login-utils/vipw.8.adoc:81
11496 #| "The *{command}* command is part of the util-linux package which can be "
11497 #| "downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
11498 #| "Kernel Archive]."
11500 "The *vigr* and *vipw* commands are part of the util-linux package and are "
11501 "available from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
11504 "Příkaz *{command}* je součástí balíku util-linux, který lze stáhnout "
11505 "z https://www.kernel.org/pub/linux/utils/util-linux/[archivu jádra Linuxu]."
11507 #. Copyright 2000 Andreas Dilger (adilger@turbolinux.com)
11508 #. This file may be copied under the terms of the GNU Public License.
11510 #: ../misc-utils/blkid.8.adoc:4
11515 #. type: Plain text
11516 #: ../misc-utils/blkid.8.adoc:15
11517 msgid "blkid - locate/print block device attributes"
11520 #. type: Plain text
11521 #: ../misc-utils/blkid.8.adoc:19
11523 msgid "*blkid* *--label* _label_ | *--uuid* _uuid_\n"
11526 #. type: Plain text
11527 #: ../misc-utils/blkid.8.adoc:21
11529 msgid "*blkid* [*--no-encoding* *--garbage-collect* *--list-one* *--cache-file* _file_] [*--output* _format_] [*--match-tag* _tag_] [*--match-token* _NAME=value_] [_device_...]\n"
11532 #. type: Plain text
11533 #: ../misc-utils/blkid.8.adoc:23
11535 msgid "*blkid* *--probe* [*--offset* _offset_] [*--output* _format_] [*--size* _size_] [*--match-tag* _tag_] [*--match-types* _list_] [*--usages* _list_] [*--no-part-details*] _device_...\n"
11538 #. type: Plain text
11539 #: ../misc-utils/blkid.8.adoc:25
11541 msgid "*blkid* *--info* [*--output format*] [*--match-tag* _tag_] _device_...\n"
11544 #. type: Plain text
11545 #: ../misc-utils/blkid.8.adoc:29
11547 "The *blkid* program is the command-line interface to working with the "
11548 "*libblkid*(3) library. It can determine the type of content (e.g., "
11549 "filesystem or swap) that a block device holds, and also the attributes "
11550 "(tokens, NAME=value pairs) from the content metadata (e.g., LABEL or UUID "
11554 #. type: Plain text
11555 #: ../misc-utils/blkid.8.adoc:31
11557 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"
11560 #. type: delimited block _
11561 #: ../misc-utils/blkid.8.adoc:34
11563 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"
11566 #. type: Plain text
11567 #: ../misc-utils/blkid.8.adoc:37
11569 "When _device_ is specified, tokens from only this device are displayed. It "
11570 "is possible to specify multiple _device_ arguments on the command line. If "
11571 "none is given, all partitions or unpartitioned devices which appear in _/"
11572 "proc/partitions_ are shown, if they are recognized."
11575 #. type: Plain text
11576 #: ../misc-utils/blkid.8.adoc:39
11578 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"
11581 #. type: Plain text
11582 #: ../misc-utils/blkid.8.adoc:41
11584 "For security reasons *blkid* silently ignores all devices where the probing "
11585 "result is ambivalent (multiple colliding filesystems are detected). The low-"
11586 "level probing mode (*-p*) provides more information and extra exit status in "
11587 "this case. It's recommended to use *wipefs*(8) to get a detailed overview "
11588 "and to erase obsolete stuff (magic strings) from the device."
11591 #. type: Plain text
11592 #: ../misc-utils/blkid.8.adoc:45
11594 "The _size_ and _offset_ arguments may be followed by the multiplicative "
11595 "suffixes like KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, "
11596 "EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning "
11597 "as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, "
11598 "TB, PB, EB, ZB and YB."
11601 #. type: Labeled list
11602 #: ../misc-utils/blkid.8.adoc:46
11604 msgid "*-c*, *--cache-file* _cachefile_"
11607 #. type: Plain text
11608 #: ../misc-utils/blkid.8.adoc:48
11610 "Read from _cachefile_ instead of reading from the default cache file (see "
11611 "the *CONFIGURATION FILE* section for more details). If you want to start "
11612 "with a clean cache (i.e., don't report devices previously scanned but not "
11613 "necessarily available at this time), specify _/dev/null_."
11616 #. type: Labeled list
11617 #: ../misc-utils/blkid.8.adoc:49
11619 #| msgid "*-*, *-l*, *--login*"
11620 msgid "*-d*, *--no-encoding*"
11621 msgstr "*-*, *-l*, *--login*"
11623 #. type: Plain text
11624 #: ../misc-utils/blkid.8.adoc:51
11626 "Don't encode non-printing characters. The non-printing characters are "
11627 "encoded by ^ and M- notation by default. Note that the *--output udev* "
11628 "output format uses a different encoding which cannot be disabled."
11631 #. type: Labeled list
11632 #: ../misc-utils/blkid.8.adoc:52
11634 msgid "*-D*, *--no-part-details*"
11637 #. type: Plain text
11638 #: ../misc-utils/blkid.8.adoc:54
11640 "Don't print information (PART_ENTRY_* tags) from partition table in low-"
11641 "level probing mode."
11644 #. type: Labeled list
11645 #: ../misc-utils/blkid.8.adoc:55
11647 msgid "*-g*, *--garbage-collect*"
11650 #. type: Plain text
11651 #: ../misc-utils/blkid.8.adoc:57
11653 "Perform a garbage collection pass on the blkid cache to remove devices which "
11657 #. type: Labeled list
11658 #: ../misc-utils/blkid.8.adoc:58
11660 msgid "*-H*, *--hint* _setting_"
11663 #. type: Plain text
11664 #: ../misc-utils/blkid.8.adoc:62
11666 "Set probing hint. The hints are an optional way to force probing functions "
11667 "to check, for example, another location. The currently supported is "
11668 "\"session_offset=_number_\" to set session offset on multi-session UDF."
11671 #. type: Labeled list
11672 #: ../misc-utils/blkid.8.adoc:63 ../sys-utils/readprofile.8.adoc:33
11674 #| msgid "*-f*, *--fast*"
11675 msgid "*-i*, *--info*"
11676 msgstr "*-f*, *--fast*"
11678 #. type: Plain text
11679 #: ../misc-utils/blkid.8.adoc:65
11681 "Display information about I/O Limits (aka I/O topology). The 'export' output "
11682 "format is automatically enabled. This option can be used together with the "
11683 "*--probe* option."
11686 #. type: Labeled list
11687 #: ../misc-utils/blkid.8.adoc:66
11689 #| msgid "*-f*, *--fast*"
11690 msgid "*-k*, *--list-filesystems*"
11691 msgstr "*-f*, *--fast*"
11693 #. type: Plain text
11694 #: ../misc-utils/blkid.8.adoc:68
11695 msgid "List all known filesystems and RAIDs and exit."
11698 #. type: Labeled list
11699 #: ../misc-utils/blkid.8.adoc:69
11701 #| msgid "*-f*, *--fast*"
11702 msgid "*-l*, *--list-one*"
11703 msgstr "*-f*, *--fast*"
11705 #. type: Plain text
11706 #: ../misc-utils/blkid.8.adoc:71
11708 "Look up only one device that matches the search parameter specified with the "
11709 "*--match-token* option. If there are multiple devices that match the "
11710 "specified search parameter, then the device with the highest priority is "
11711 "returned, and/or the first device found at a given priority (but see below "
11712 "note about udev). Device types in order of decreasing priority are: Device "
11713 "Mapper, EVMS, LVM, MD, and finally regular block devices. If this option is "
11714 "not specified, *blkid* will print all of the devices that match the search "
11718 #. type: Plain text
11719 #: ../misc-utils/blkid.8.adoc:73
11721 "This option forces *blkid* to use udev when used for LABEL or UUID tokens in "
11722 "*--match-token*. The goal is to provide output consistent with other utils "
11723 "(like *mount*(8), etc.) on systems where the same tag is used for multiple "
11727 #. type: Plain text
11728 #: ../misc-utils/blkid.8.adoc:76
11730 "Look up the device that uses this filesystem _label_; this is equal to **--"
11731 "list-one --output device --match-token LABEL=**__label__. This lookup method "
11732 "is able to reliably use /dev/disk/by-label udev symlinks (dependent on a "
11733 "setting in _/etc/blkid.conf_). Avoid using the symlinks directly; it is not "
11734 "reliable to use the symlinks without verification. The *--label* option "
11735 "works on systems with and without udev."
11738 #. type: Plain text
11739 #: ../misc-utils/blkid.8.adoc:78
11741 "Unfortunately, the original *blkid*(8) from e2fsprogs uses the *-L* option "
11742 "as a synonym for *-o list*. For better portability, use **-l -o device -t "
11743 "LABEL=**__label__ and *-o list* in your scripts rather than the *-L* option."
11746 #. type: Labeled list
11747 #: ../misc-utils/blkid.8.adoc:79
11749 msgid "*-n*, *--match-types* _list_"
11752 #. type: Plain text
11753 #: ../misc-utils/blkid.8.adoc:81
11755 "Restrict the probing functions to the specified (comma-separated) _list_ of "
11756 "superblock types (names). The list items may be prefixed with \"no\" to "
11757 "specify the types which should be ignored. For example:"
11760 #. type: Plain text
11761 #: ../misc-utils/blkid.8.adoc:83
11763 msgid "*blkid --probe --match-types vfat,ext3,ext4 /dev/sda1*\n"
11766 #. type: Plain text
11767 #: ../misc-utils/blkid.8.adoc:85
11768 msgid "probes for vfat, ext3 and ext4 filesystems, and"
11771 #. type: Plain text
11772 #: ../misc-utils/blkid.8.adoc:87
11774 msgid "*blkid --probe --match-types nominix /dev/sda1*\n"
11777 #. type: Plain text
11778 #: ../misc-utils/blkid.8.adoc:89
11780 "probes for all supported formats except minix filesystems. This option is "
11781 "only useful together with *--probe*."
11784 #. type: Labeled list
11785 #: ../misc-utils/blkid.8.adoc:90
11787 msgid "*-o*, *--output* _format_"
11790 #. type: Plain text
11791 #: ../misc-utils/blkid.8.adoc:92
11793 "Use the specified output format. Note that the order of variables and "
11794 "devices is not fixed. See also option *-s*. The _format_ parameter may be:"
11797 #. type: Labeled list
11798 #: ../misc-utils/blkid.8.adoc:93
11803 #. type: Plain text
11804 #: ../misc-utils/blkid.8.adoc:95
11805 msgid "print all tags (the default)"
11808 #. type: Labeled list
11809 #: ../misc-utils/blkid.8.adoc:95
11814 #. type: Plain text
11815 #: ../misc-utils/blkid.8.adoc:97
11816 msgid "print the value of the tags"
11819 #. type: Labeled list
11820 #: ../misc-utils/blkid.8.adoc:97
11825 #. type: Plain text
11826 #: ../misc-utils/blkid.8.adoc:99
11828 "print the devices in a user-friendly format; this output format is "
11829 "unsupported for low-level probing (*--probe* or *--info*)."
11832 #. type: Plain text
11833 #: ../misc-utils/blkid.8.adoc:101
11834 msgid "This output format is *DEPRECATED* in favour of the *lsblk*(8) command."
11837 #. type: Labeled list
11838 #: ../misc-utils/blkid.8.adoc:101
11843 #. type: Plain text
11844 #: ../misc-utils/blkid.8.adoc:103
11846 "print the device name only; this output format is always enabled for the *--"
11847 "label* and *--uuid* options"
11850 #. type: Labeled list
11851 #: ../misc-utils/blkid.8.adoc:103
11856 #. TRANSLATORS: Please keep {underscore} untranslated.
11857 #. type: Plain text
11858 #: ../misc-utils/blkid.8.adoc:106
11860 "print key=\"value\" pairs for easy import into the udev environment; the "
11861 "keys are prefixed by ID_FS_ or ID_PART_ prefixes. The value may be modified "
11862 "to be safe for udev environment; allowed is plain ASCII, hex-escaping and "
11863 "valid UTF-8, everything else (including whitespaces) is replaced with "
11864 "'{underscore}'. The keys with __ENC_ postfix use hex-escaping for unsafe "
11868 #. type: Plain text
11869 #: ../misc-utils/blkid.8.adoc:108
11871 "The udev output returns the ID_FS_AMBIVALENT tag if more superblocks are "
11872 "detected, and ID_PART_ENTRY_* tags are always returned for all partitions "
11873 "including empty partitions."
11876 #. type: Plain text
11877 #: ../misc-utils/blkid.8.adoc:110
11878 msgid "This output format is *DEPRECATED*."
11881 #. type: Labeled list
11882 #: ../misc-utils/blkid.8.adoc:110
11887 #. type: Plain text
11888 #: ../misc-utils/blkid.8.adoc:112
11890 "print key=value pairs for easy import into the environment; this output "
11891 "format is automatically enabled when I/O Limits (*--info* option) are "
11895 #. type: Plain text
11896 #: ../misc-utils/blkid.8.adoc:114
11898 "The non-printing characters are encoded by ^ and M- notation and all "
11899 "potentially unsafe characters are escaped."
11902 #. type: Labeled list
11903 #: ../misc-utils/blkid.8.adoc:115
11905 #| msgid "*-f*, *--fast*"
11906 msgid "*-O*, *--offset* _offset_"
11907 msgstr "*-f*, *--fast*"
11909 #. type: Plain text
11910 #: ../misc-utils/blkid.8.adoc:117
11912 "Probe at the given _offset_ (only useful with *--probe*). This option can be "
11913 "used together with the *--info* option."
11916 #. type: Labeled list
11917 #: ../misc-utils/blkid.8.adoc:118
11919 #| msgid "*-P*, *--pty*"
11920 msgid "*-p*, *--probe*"
11921 msgstr "*-P*, *--pty*"
11923 #. type: Plain text
11924 #: ../misc-utils/blkid.8.adoc:120
11925 msgid "Switch to low-level superblock probing mode (bypassing the cache)."
11928 #. type: Plain text
11929 #: ../misc-utils/blkid.8.adoc:122
11931 "Note that low-level probing also returns information about partition table "
11932 "type (PTTYPE tag) and partitions (PART_ENTRY_* tags). The tag names produced "
11933 "by low-level probing are based on names used internally by libblkid and it "
11934 "may be different than when executed without *--probe* (for example "
11935 "PART_ENTRY_UUID= vs PARTUUID=). See also *--no-part-details*."
11938 #. type: Labeled list
11939 #: ../misc-utils/blkid.8.adoc:123
11941 msgid "*-s*, *--match-tag* _tag_"
11944 #. type: Plain text
11945 #: ../misc-utils/blkid.8.adoc:125
11947 "For each (specified) device, show only the tags that match _tag_. It is "
11948 "possible to specify multiple *--match-tag* options. If no tag is specified, "
11949 "then all tokens are shown for all (specified) devices. In order to just "
11950 "refresh the cache without showing any tokens, use *--match-tag none* with no "
11954 #. type: Labeled list
11955 #: ../misc-utils/blkid.8.adoc:126 ../misc-utils/logger.1.adoc:158
11957 #| msgid "*-s*, **--shell**=__shell__"
11958 msgid "*-S*, *--size* _size_"
11959 msgstr "*-s*, **--shell**=__shell__"
11961 #. type: Plain text
11962 #: ../misc-utils/blkid.8.adoc:128
11963 msgid "Override the size of device/file (only useful with *--probe*)."
11966 #. type: Labeled list
11967 #: ../misc-utils/blkid.8.adoc:129
11969 msgid "*-t*, *--match-token* _NAME=value_"
11972 #. type: Plain text
11973 #: ../misc-utils/blkid.8.adoc:131
11975 "Search for block devices with tokens named _NAME_ that have the value "
11976 "_value_, and display any devices which are found. Common values for _NAME_ "
11977 "include *TYPE*, *LABEL*, and *UUID*. If there are no devices specified on "
11978 "the command line, all block devices will be searched; otherwise only the "
11979 "specified devices are searched."
11982 #. type: Labeled list
11983 #: ../misc-utils/blkid.8.adoc:132
11985 msgid "*-u*, *--usages* _list_"
11988 #. type: Plain text
11989 #: ../misc-utils/blkid.8.adoc:134
11991 "Restrict the probing functions to the specified (comma-separated) _list_ of "
11992 "\"usage\" types. Supported usage types are: filesystem, raid, crypto and "
11993 "other. The list items may be prefixed with \"no\" to specify the usage types "
11994 "which should be ignored. For example:"
11997 #. type: Plain text
11998 #: ../misc-utils/blkid.8.adoc:136
12000 msgid "*blkid --probe --usages filesystem,other /dev/sda1*\n"
12003 #. type: Plain text
12004 #: ../misc-utils/blkid.8.adoc:138
12005 msgid "probes for all filesystem and other (e.g., swap) formats, and"
12008 #. type: Plain text
12009 #: ../misc-utils/blkid.8.adoc:140
12011 msgid "*blkid --probe --usages noraid /dev/sda1*\n"
12014 #. type: Plain text
12015 #: ../misc-utils/blkid.8.adoc:142
12017 "probes for all supported formats except RAIDs. This option is only useful "
12018 "together with *--probe*."
12021 #. type: Labeled list
12022 #: ../misc-utils/blkid.8.adoc:143 ../sys-utils/mount.8.adoc:454
12024 msgid "*-U*, *--uuid* _uuid_"
12027 #. type: Plain text
12028 #: ../misc-utils/blkid.8.adoc:145
12030 "Look up the device that uses this filesystem _uuid_. For more details see "
12031 "the *--label* option."
12034 #. type: Plain text
12035 #: ../misc-utils/blkid.8.adoc:151
12037 "If the specified device or device addressed by specified token (option *--"
12038 "match-token*) was found and it's possible to gather any information about "
12039 "the device, an exit status 0 is returned. Note the option *--match-tag* "
12040 "filters output tags, but it does not affect exit status."
12043 #. type: Plain text
12044 #: ../misc-utils/blkid.8.adoc:153
12046 "If the specified token was not found, or no (specified) devices could be "
12047 "identified, or it is impossible to gather any information about the device "
12048 "identifiers or device content an exit status of 2 is returned."
12051 #. type: Plain text
12052 #: ../misc-utils/blkid.8.adoc:155
12053 msgid "For usage or other errors, an exit status of 4 is returned."
12056 #. type: Plain text
12057 #: ../misc-utils/blkid.8.adoc:157
12059 "If an ambivalent probing result was detected by low-level probing mode (*-"
12060 "p*), an exit status of 8 is returned."
12063 #. type: Plain text
12064 #: ../misc-utils/blkid.8.adoc:161
12066 "The standard location of the _/etc/blkid.conf_ config file can be overridden "
12067 "by the environment variable *BLKID_CONF*. The following options control the "
12068 "libblkid library:"
12071 #. type: Labeled list
12072 #: ../misc-utils/blkid.8.adoc:162
12074 msgid "_SEND_UEVENT=<yes|not>_"
12077 #. type: Plain text
12078 #: ../misc-utils/blkid.8.adoc:164
12080 "Sends uevent when _/dev/disk/by-{label,uuid,partuuid,partlabel}/_ symlink "
12081 "does not match with LABEL, UUID, PARTUUID or PARTLABEL on the device. "
12082 "Default is \"yes\"."
12085 #. type: Labeled list
12086 #: ../misc-utils/blkid.8.adoc:165
12088 msgid "_CACHE_FILE=<path>_"
12091 #. type: Plain text
12092 #: ../misc-utils/blkid.8.adoc:167
12094 "Overrides the standard location of the cache file. This setting can be "
12095 "overridden by the environment variable *BLKID_FILE*. Default is _/run/blkid/"
12096 "blkid.tab_, or _/etc/blkid.tab_ on systems without a _/run_ directory."
12099 #. type: Labeled list
12100 #: ../misc-utils/blkid.8.adoc:168
12102 msgid "_EVALUATE=<methods>_"
12105 #. type: Plain text
12106 #: ../misc-utils/blkid.8.adoc:170
12108 "Defines LABEL and UUID evaluation method(s). Currently, the libblkid library "
12109 "supports the \"udev\" and \"scan\" methods. More than one method may be "
12110 "specified in a comma-separated list. Default is \"udev,scan\". The \"udev\" "
12111 "method uses udev _/dev/disk/by-*_ symlinks and the \"scan\" method scans all "
12112 "block devices from the _/proc/partitions_ file."
12115 #. type: Plain text
12116 #: ../misc-utils/blkid.8.adoc:174
12117 msgid "Setting _LIBBLKID_DEBUG=all_ enables debug output."
12120 #. type: Plain text
12121 #: ../misc-utils/blkid.8.adoc:178
12123 msgid "*blkid* was written by Andreas Dilger for libblkid and improved by Theodore Ts'o and Karel Zak.\n"
12126 #. type: Plain text
12127 #: ../misc-utils/blkid.8.adoc:185
12140 #. Copyright (c) 1989, 1990, 1993
12141 #. The Regents of the University of California. All rights reserved.
12142 #. This code is derived from software contributed to Berkeley by
12144 #. Redistribution and use in source and binary forms, with or without
12145 #. modification, are permitted provided that the following conditions
12147 #. 1. Redistributions of source code must retain the above copyright
12148 #. notice, this list of conditions and the following disclaimer.
12149 #. 2. Redistributions in binary form must reproduce the above copyright
12150 #. notice, this list of conditions and the following disclaimer in the
12151 #. documentation and/or other materials provided with the distribution.
12152 #. 3. All advertising materials mentioning features or use of this software
12153 #. must display the following acknowledgement:
12154 #. This product includes software developed by the University of
12155 #. California, Berkeley and its contributors.
12156 #. 4. Neither the name of the University nor the names of its contributors
12157 #. may be used to endorse or promote products derived from this software
12158 #. without specific prior written permission.
12159 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
12160 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
12161 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
12162 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
12163 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
12164 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
12165 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
12166 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
12167 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
12168 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
12170 #. @(#)cal.1 8.1 (Berkeley) 6/6/93
12172 #: ../misc-utils/cal.1.adoc:39
12177 #. type: Plain text
12178 #: ../misc-utils/cal.1.adoc:50
12179 msgid "cal - display a calendar"
12182 #. type: Plain text
12183 #: ../misc-utils/cal.1.adoc:54
12185 msgid "*cal* [options] [[[_day_] _month_] _year_]\n"
12188 #. type: Plain text
12189 #: ../misc-utils/cal.1.adoc:56
12191 msgid "*cal* [options] [_timestamp_|_monthname_]\n"
12194 #. type: Plain text
12195 #: ../misc-utils/cal.1.adoc:60
12197 msgid "*cal* displays a simple calendar. If no arguments are specified, the current month is displayed.\n"
12200 #. type: Plain text
12201 #: ../misc-utils/cal.1.adoc:62
12203 "The _month_ may be specified as a number (1-12), as a month name or as an "
12204 "abbreviated month name according to the current locales."
12207 #. type: Plain text
12208 #: ../misc-utils/cal.1.adoc:64
12210 "Two different calendar systems are used, Gregorian and Julian. These are "
12211 "nearly identical systems with Gregorian making a small adjustment to the "
12212 "frequency of leap years; this facilitates improved synchronization with "
12213 "solar events like the equinoxes. The Gregorian calendar reform was "
12214 "introduced in 1582, but its adoption continued up to 1923. By default *cal* "
12215 "uses the adoption date of 3 Sept 1752. From that date forward the Gregorian "
12216 "calendar is displayed; previous dates use the Julian calendar system. 11 "
12217 "days were removed at the time of adoption to bring the calendar in sync with "
12218 "solar events. So Sept 1752 has a mix of Julian and Gregorian dates by which "
12219 "the 2nd is followed by the 14th (the 3rd through the 13th are absent)."
12222 #. type: Plain text
12223 #: ../misc-utils/cal.1.adoc:66
12225 "Optionally, either the proleptic Gregorian calendar or the Julian calendar "
12226 "may be used exclusively. See *--reform* below."
12229 #. type: Labeled list
12230 #: ../misc-utils/cal.1.adoc:69
12232 #| msgid "*-h*, *--help*"
12233 msgid "*-1*, *--one*"
12234 msgstr "*-h*, *--help*"
12236 #. type: Plain text
12237 #: ../misc-utils/cal.1.adoc:71
12238 msgid "Display single month output. (This is the default.)"
12241 #. type: Labeled list
12242 #: ../misc-utils/cal.1.adoc:72
12244 #| msgid "*-h*, *--help*"
12245 msgid "*-3*, *--three*"
12246 msgstr "*-h*, *--help*"
12248 #. type: Plain text
12249 #: ../misc-utils/cal.1.adoc:74
12250 msgid "Display three months spanning the date."
12253 #. type: Labeled list
12254 #: ../misc-utils/cal.1.adoc:75
12256 msgid "*-n , --months* _number_"
12259 #. type: Plain text
12260 #: ../misc-utils/cal.1.adoc:77
12262 "Display _number_ of months, starting from the month containing the date."
12265 #. type: Labeled list
12266 #: ../misc-utils/cal.1.adoc:78
12268 msgid "*-S, --span*"
12271 #. type: Plain text
12272 #: ../misc-utils/cal.1.adoc:80
12273 msgid "Display months spanning the date."
12276 #. type: Labeled list
12277 #: ../misc-utils/cal.1.adoc:81
12279 #| msgid "*-P*, *--pty*"
12280 msgid "*-s*, *--sunday*"
12281 msgstr "*-P*, *--pty*"
12283 #. type: Plain text
12284 #: ../misc-utils/cal.1.adoc:83
12285 msgid "Display Sunday as the first day of the week."
12288 #. type: Labeled list
12289 #: ../misc-utils/cal.1.adoc:84
12291 #| msgid "*-P*, *--pty*"
12292 msgid "*-m*, *--monday*"
12293 msgstr "*-P*, *--pty*"
12295 #. type: Plain text
12296 #: ../misc-utils/cal.1.adoc:86
12297 msgid "Display Monday as the first day of the week."
12300 #. type: Labeled list
12301 #: ../misc-utils/cal.1.adoc:87 ../misc-utils/namei.1.adoc:53
12303 #| msgid "*-V*, *--version*"
12304 msgid "*-v*, *--vertical*"
12305 msgstr "*-V*, *--version*"
12307 #. type: Plain text
12308 #: ../misc-utils/cal.1.adoc:89
12309 msgid "Display using a vertical layout (aka *ncal*(1) mode)."
12312 #. type: Labeled list
12313 #: ../misc-utils/cal.1.adoc:90
12318 #. type: Plain text
12319 #: ../misc-utils/cal.1.adoc:92
12321 "Display the proleptic Gregorian calendar exclusively. This option does not "
12322 "affect week numbers and the first day of the week. See *--reform* below."
12325 #. type: Labeled list
12326 #: ../misc-utils/cal.1.adoc:93
12328 #| msgid "*-h*, *--help*"
12329 msgid "*-j*, *--julian*"
12330 msgstr "*-h*, *--help*"
12332 #. type: Plain text
12333 #: ../misc-utils/cal.1.adoc:95
12335 "Use day-of-year numbering for all calendars. These are also called ordinal "
12336 "days. Ordinal days range from 1 to 366. This option does not switch from the "
12337 "Gregorian to the Julian calendar system, that is controlled by the *--"
12341 #. type: Plain text
12342 #: ../misc-utils/cal.1.adoc:97
12344 "Sometimes Gregorian calendars using ordinal dates are referred to as Julian "
12345 "calendars. This can be confusing due to the many date related conventions "
12346 "that use Julian in their name: (ordinal) julian date, julian (calendar) "
12347 "date, (astronomical) julian date, (modified) julian date, and more. This "
12348 "option is named julian, because ordinal days are identified as julian by the "
12349 "POSIX standard. However, be aware that *cal* also uses the Julian calendar "
12350 "system. See *DESCRIPTION* above."
12353 #. type: Labeled list
12354 #: ../misc-utils/cal.1.adoc:98
12356 msgid "*--reform* _val_"
12359 #. type: Plain text
12360 #: ../misc-utils/cal.1.adoc:100
12362 "This option sets the adoption date of the Gregorian calendar reform. "
12363 "Calendar dates previous to reform use the Julian calendar system. Calendar "
12364 "dates after reform use the Gregorian calendar system. The argument _val_ can "
12368 #. type: Plain text
12369 #: ../misc-utils/cal.1.adoc:102
12371 "_1752_ - sets 3 September 1752 as the reform date (default). This is when "
12372 "the Gregorian calendar reform was adopted by the British Empire."
12375 #. type: Plain text
12376 #: ../misc-utils/cal.1.adoc:103
12378 "_gregorian_ - display Gregorian calendars exclusively. This special "
12379 "placeholder sets the reform date below the smallest year that *cal* can use; "
12380 "meaning all calendar output uses the Gregorian calendar system. This is "
12381 "called the proleptic Gregorian calendar, because dates prior to the calendar "
12382 "system's creation use extrapolated values."
12385 #. type: Plain text
12386 #: ../misc-utils/cal.1.adoc:104
12388 "_iso_ - alias of _gregorian_. The ISO 8601 standard for the representation "
12389 "of dates and times in information interchange requires using the proleptic "
12390 "Gregorian calendar."
12393 #. type: Plain text
12394 #: ../misc-utils/cal.1.adoc:105
12396 "_julian_ - display Julian calendars exclusively. This special placeholder "
12397 "sets the reform date above the largest year that *cal* can use; meaning all "
12398 "calendar output uses the Julian calendar system."
12401 #. type: Plain text
12402 #: ../misc-utils/cal.1.adoc:107
12404 #| msgid "DESCRIPTION"
12405 msgid "See *DESCRIPTION* above."
12408 #. type: Labeled list
12409 #: ../misc-utils/cal.1.adoc:108
12411 #| msgid "*-P*, *--pty*"
12412 msgid "*-y*, *--year*"
12413 msgstr "*-P*, *--pty*"
12415 #. type: Plain text
12416 #: ../misc-utils/cal.1.adoc:110
12417 msgid "Display a calendar for the whole year."
12420 #. type: Labeled list
12421 #: ../misc-utils/cal.1.adoc:111
12423 msgid "*-Y, --twelve*"
12426 #. type: Plain text
12427 #: ../misc-utils/cal.1.adoc:113
12428 msgid "Display a calendar for the next twelve months."
12431 #. type: Labeled list
12432 #: ../misc-utils/cal.1.adoc:114
12434 msgid "*-w*, *--week*[=_number_]"
12437 #. type: Plain text
12438 #: ../misc-utils/cal.1.adoc:116
12440 "Display week numbers in the calendar (US or ISO-8601). See the *NOTES* "
12441 "section for more details."
12444 #. type: Labeled list
12445 #: ../misc-utils/cal.1.adoc:117
12447 msgid "*--color*[=_when_]"
12450 #. type: Labeled list
12451 #: ../misc-utils/cal.1.adoc:120
12453 #| msgid "*-c*, **--command**=__command__"
12454 msgid "*-c, --columns*=_columns_"
12455 msgstr "*-c*, **--command**=__příkaz__"
12457 #. type: Plain text
12458 #: ../misc-utils/cal.1.adoc:122
12459 msgid "Number of columns to use. *auto* uses as many as fit the terminal."
12462 #. type: Labeled list
12463 #: ../misc-utils/cal.1.adoc:127
12465 msgid "*Single digits-only parameter (e.g., 'cal 2020')*"
12468 #. type: Plain text
12469 #: ../misc-utils/cal.1.adoc:129
12471 "Specifies the _year_ to be displayed; note the year must be fully specified: "
12472 "*cal 89* will not display a calendar for 1989."
12475 #. type: Labeled list
12476 #: ../misc-utils/cal.1.adoc:130
12478 msgid "*Single string parameter (e.g., 'cal tomorrow' or 'cal August')*"
12481 #. type: Plain text
12482 #: ../misc-utils/cal.1.adoc:132
12484 "Specifies _timestamp_ or a _month name_ (or abbreviated name) according to "
12485 "the current locales."
12488 #. type: Plain text
12489 #: ../misc-utils/cal.1.adoc:134
12491 "The special placeholders are accepted when parsing timestamp, \"now\" may be "
12492 "used to refer to the current time, \"today\", \"yesterday\", \"tomorrow\" "
12493 "refer to of the current day, the day before or the next day, respectively."
12496 #. TRANSLATORS: Please keep {plus} untranslated.
12497 #. type: Plain text
12498 #: ../misc-utils/cal.1.adoc:136
12500 "The relative date specifications are also accepted, in this case \"{plus}\" "
12501 "is evaluated to the current time plus the specified time span. "
12502 "Correspondingly, a time span that is prefixed with \"-\" is evaluated to the "
12503 "current time minus the specified time span, for example '{plus}2days'. "
12504 "Instead of prefixing the time span with \"{plus}\" or \"-\", it may also be "
12505 "suffixed with a space and the word \"left\" or \"ago\" (for example '1 week "
12509 #. type: Labeled list
12510 #: ../misc-utils/cal.1.adoc:138
12512 msgid "*Two parameters (e.g., 'cal 11 2020')*"
12515 #. type: Plain text
12516 #: ../misc-utils/cal.1.adoc:140
12517 msgid "Denote the _month_ (1 - 12) and _year_."
12520 #. type: Labeled list
12521 #: ../misc-utils/cal.1.adoc:141
12523 msgid "*Three parameters (e.g., 'cal 25 11 2020')*"
12526 #. type: Plain text
12527 #: ../misc-utils/cal.1.adoc:143
12529 "Denote the _day_ (1-31), _month and year_, and the day will be highlighted "
12530 "if the calendar is displayed on a terminal. If no parameters are specified, "
12531 "the current month's calendar is displayed."
12534 #. type: Plain text
12535 #: ../misc-utils/cal.1.adoc:147
12537 "A year starts on January 1. The first day of the week is determined by the "
12538 "locale or the *--sunday* and *--monday* options."
12541 #. type: Plain text
12542 #: ../misc-utils/cal.1.adoc:149
12544 "The week numbering depends on the choice of the first day of the week. If it "
12545 "is Sunday then the customary North American numbering is used, where 1 "
12546 "January is in week number 1. If it is Monday (*-m*) then the ISO 8601 "
12547 "standard week numbering is used, where the first Thursday is in week number "
12551 #. type: Plain text
12552 #: ../misc-utils/cal.1.adoc:152
12553 msgid "The logical color names supported by *cal* are:"
12556 #. type: Labeled list
12557 #: ../misc-utils/cal.1.adoc:153
12562 #. type: Plain text
12563 #: ../misc-utils/cal.1.adoc:155
12564 msgid "The current day."
12567 #. type: Labeled list
12568 #: ../misc-utils/cal.1.adoc:156
12570 msgid "*weeknumber*"
12573 #. type: Plain text
12574 #: ../misc-utils/cal.1.adoc:158
12575 msgid "The number of the week."
12578 #. type: Plain text
12579 #: ../misc-utils/cal.1.adoc:161
12580 msgid "The header of a month."
12583 #. type: Labeled list
12584 #: ../misc-utils/cal.1.adoc:162
12589 #. type: Plain text
12590 #: ../misc-utils/cal.1.adoc:164
12591 msgid "Days that fall within the work-week."
12594 #. type: Labeled list
12595 #: ../misc-utils/cal.1.adoc:165
12600 #. type: Plain text
12601 #: ../misc-utils/cal.1.adoc:167
12602 msgid "Days that fall outside the work-week."
12605 #. type: Plain text
12606 #: ../misc-utils/cal.1.adoc:169 ../sys-utils/mount.8.adoc:286
12607 msgid "For example:"
12610 #. type: delimited block _
12611 #: ../misc-utils/cal.1.adoc:171
12613 "echo -e 'weekend 35\\ntoday 1;41\\nheader yellow' > $HOME/.config/terminal-"
12614 "colors.d/cal.scheme"
12617 #. type: Plain text
12618 #: ../misc-utils/cal.1.adoc:176
12620 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
12621 msgid "A *cal* command appeared in Version 6 AT&T UNIX."
12622 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
12624 #. type: Plain text
12625 #: ../misc-utils/cal.1.adoc:180
12627 "The default *cal* output uses 3 September 1752 as the Gregorian calendar "
12628 "reform date. The historical reform dates for the other locales, including "
12629 "its introduction in October 1582, are not implemented."
12632 #. type: Plain text
12633 #: ../misc-utils/cal.1.adoc:182
12635 "Alternative calendars, such as the Umm al-Qura, the Solar Hijri, the Ge'ez, "
12636 "or the lunisolar Hindu, are not supported."
12639 #. type: Plain text
12640 #: ../misc-utils/cal.1.adoc:186
12642 #| msgid "_/etc/terminal-colors.d/disable_"
12643 msgid "*terminal-colors.d*(5)\n"
12644 msgstr "_/etc/terminal-colors.d/disable_"
12647 #: ../misc-utils/enosys.1.adoc:2
12652 #. type: Plain text
12653 #: ../misc-utils/enosys.1.adoc:12
12654 msgid "enosys - utility make syscalls fail with ENOSYS"
12657 #. type: Plain text
12658 #: ../misc-utils/enosys.1.adoc:16
12660 msgid "*enosys* [*--syscall*|*-s* _syscall_] command\n"
12663 #. type: Plain text
12664 #: ../misc-utils/enosys.1.adoc:21
12667 "*enosys* is a simple command to execute a child process for which certain\n"
12668 "syscalls fail with errno ENOSYS.\n"
12671 #. type: Plain text
12672 #: ../misc-utils/enosys.1.adoc:24
12674 "It can be used to test the behavior of applications in the face of missing "
12675 "syscalls as would happen when running on old kernels."
12678 #. type: Labeled list
12679 #: ../misc-utils/enosys.1.adoc:27
12681 #| msgid "*-h*, *--help*"
12682 msgid "*-s*, *--syscall*"
12683 msgstr "*-h*, *--help*"
12685 #. type: Plain text
12686 #: ../misc-utils/enosys.1.adoc:29
12687 msgid "Syscall to block. Can be specified multiple times."
12690 #. type: Labeled list
12691 #: ../misc-utils/enosys.1.adoc:30
12693 #| msgid "*-f*, *--fast*"
12694 msgid "*-i*, *--ioctl*"
12695 msgstr "*-f*, *--fast*"
12697 #. type: Plain text
12698 #: ../misc-utils/enosys.1.adoc:32
12699 msgid "Ioctl to block. Can be specified multiple times."
12702 #. type: Plain text
12703 #: ../misc-utils/enosys.1.adoc:35
12704 msgid "List syscalls known to *enosys*."
12707 #. type: Labeled list
12708 #: ../misc-utils/enosys.1.adoc:36
12710 #| msgid "*-f*, *--fast*"
12711 msgid "*-m*, *--list-ioctl*"
12712 msgstr "*-f*, *--fast*"
12714 #. type: Plain text
12715 #: ../misc-utils/enosys.1.adoc:38
12716 msgid "List ioctls known to *enosys*."
12719 #. type: Plain text
12720 #: ../misc-utils/enosys.1.adoc:45
12723 "*enosys* exits with the status code of the executed process.\n"
12724 "The following values have special meanings:\n"
12727 #. type: Plain text
12728 #: ../misc-utils/enosys.1.adoc:48
12729 msgid "internal error"
12732 #. type: Plain text
12733 #: ../misc-utils/enosys.1.adoc:51
12734 msgid "system does not provide the necessary functionality"
12737 #. type: Plain text
12738 #: ../misc-utils/enosys.1.adoc:55 ../misc-utils/lsclocks.1.adoc:103
12739 #: ../misc-utils/waitpid.1.adoc:56
12740 msgid "mailto:thomas@t-8ch.de[Thomas WeiÃ
\9fschuh]"
12743 #. type: Plain text
12744 #: ../misc-utils/enosys.1.adoc:59
12746 msgid "*syscall*(2)\n"
12750 #: ../misc-utils/exch.1.adoc:2
12755 #. type: Plain text
12756 #: ../misc-utils/exch.1.adoc:12
12757 msgid "exch - atomically exchanges paths between two files"
12760 #. type: Plain text
12761 #: ../misc-utils/exch.1.adoc:16
12763 msgid "*exch* _oldpath_ _newpath_\n"
12766 #. type: Plain text
12767 #: ../misc-utils/exch.1.adoc:22
12770 "*exch* atomically exchanges oldpath and newpath.\n"
12771 "*exch* is a simple command wrapping *RENAME_EXCHANGE* of *renameat2*\n"
12775 #. type: Plain text
12776 #: ../misc-utils/exch.1.adoc:31
12778 msgid "*exch* has the following exit status values:\n"
12781 #. type: Plain text
12782 #: ../misc-utils/exch.1.adoc:36 ../misc-utils/fadvise.1.adoc:52
12783 #: ../misc-utils/waitpid.1.adoc:48
12784 msgid "unspecified failure"
12787 #. type: Plain text
12788 #: ../misc-utils/exch.1.adoc:40 ../misc-utils/fadvise.1.adoc:56
12789 #: ../misc-utils/fincore.1.adoc:55
12790 msgid "mailto:yamato@redhat.com[Masatake YAMATO]"
12793 #. type: Plain text
12794 #: ../misc-utils/exch.1.adoc:44
12796 msgid "*renameat2*(2)\n"
12800 #: ../misc-utils/fadvise.1.adoc:2
12805 #. type: Plain text
12806 #: ../misc-utils/fadvise.1.adoc:12
12807 msgid "fadvise - utility to use the posix_fadvise system call"
12810 #. type: Plain text
12811 #: ../misc-utils/fadvise.1.adoc:16
12813 msgid "*fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] _filename_\n"
12816 #. type: Plain text
12817 #: ../misc-utils/fadvise.1.adoc:18
12819 msgid "*fadvise* [*-a* _advice_] [*-o* _offset_] [*-l* _length_] -d _file-descriptor_\n"
12822 #. type: Plain text
12823 #: ../misc-utils/fadvise.1.adoc:23
12826 "*fadvise* is a simple command wrapping *posix_fadvise*(2) system call\n"
12827 "that is for predeclaring an access pattern for file data.\n"
12830 #. type: Labeled list
12831 #: ../misc-utils/fadvise.1.adoc:26
12833 #| msgid "*-f*, *--fast*"
12834 msgid "*-d*, *--fd* _file-descriptor_"
12835 msgstr "*-f*, *--fast*"
12837 #. type: Plain text
12838 #: ../misc-utils/fadvise.1.adoc:29
12840 "Apply the advice to the file specified with the file descriptor instead of "
12841 "open a file specified with a file name."
12844 #. type: Labeled list
12845 #: ../misc-utils/fadvise.1.adoc:30
12847 #| msgid "*-V*, *--version*"
12848 msgid "*-a*, *--advice* _advice_"
12849 msgstr "*-V*, *--version*"
12851 #. type: Plain text
12852 #: ../misc-utils/fadvise.1.adoc:33
12854 "See the command output with *--help* option for available values for advice. "
12855 "If this option is omitted, \"dontneed\" is used as default advice."
12858 #. type: Plain text
12859 #: ../misc-utils/fadvise.1.adoc:37
12861 "Specifies the beginning offset of the range, in bytes. If this option is "
12862 "omitted, 0 is used as default advice."
12865 #. type: Labeled list
12866 #: ../misc-utils/fadvise.1.adoc:38 ../sys-utils/blkdiscard.8.adoc:37
12867 #: ../sys-utils/fallocate.1.adoc:50
12869 msgid "*-l*, *--length* _length_"
12872 #. type: Plain text
12873 #: ../misc-utils/fadvise.1.adoc:41
12875 "Specifies the length of the range, in bytes. If this option is omitted, 0 "
12876 "is used as default advice."
12879 #. type: Plain text
12880 #: ../misc-utils/fadvise.1.adoc:47
12882 msgid "*fadvise* has the following exit status values:\n"
12885 #. type: Plain text
12886 #: ../misc-utils/fadvise.1.adoc:60
12888 msgid "*posix_fadvise*(2)\n"
12892 #. Copyright 2017 Red Hat, Inc.
12893 #. This file may be copied under the terms of the GNU Public License.
12895 #: ../misc-utils/fincore.1.adoc:7
12900 #. type: Plain text
12901 #: ../misc-utils/fincore.1.adoc:18
12902 msgid "fincore - count pages of file contents in core"
12905 #. type: Plain text
12906 #: ../misc-utils/fincore.1.adoc:22
12908 msgid "*fincore* [options] _file_...\n"
12911 #. type: Plain text
12912 #: ../misc-utils/fincore.1.adoc:26
12914 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"
12917 #. type: Plain text
12918 #: ../misc-utils/fincore.1.adoc:28 ../misc-utils/lsfd.1.adoc:34
12920 "The default output is subject to change. So whenever possible, you should "
12921 "avoid using default outputs in your scripts. Always explicitly define "
12922 "expected columns by using *--output* _columns-list_ in environments where a "
12923 "stable output is required."
12926 #. type: Labeled list
12927 #: ../misc-utils/fincore.1.adoc:31 ../misc-utils/findmnt.8.adoc:96
12928 #: ../misc-utils/lsblk.8.adoc:88 ../misc-utils/lsclocks.1.adoc:29
12929 #: ../misc-utils/lsfd.1.adoc:47 ../misc-utils/lslocks.8.adoc:46
12930 #: ../misc-utils/uuidparse.1.adoc:53 ../sys-utils/losetup.8.adoc:110
12931 #: ../sys-utils/lsirq.1.adoc:25 ../sys-utils/lsmem.1.adoc:42
12932 #: ../sys-utils/lsns.8.adoc:40 ../sys-utils/rfkill.8.adoc:30
12933 #: ../sys-utils/wdctl.8.adoc:36 ../sys-utils/zramctl.8.adoc:49
12935 #| msgid "*-V*, *--version*"
12936 msgid "*-n*, *--noheadings*"
12937 msgstr "*-V*, *--version*"
12939 #. type: Plain text
12940 #: ../misc-utils/fincore.1.adoc:33 ../sys-utils/zramctl.8.adoc:51
12941 msgid "Do not print a header line in status output."
12944 #. TRANSLATORS: Keep {plus} untranslated.
12945 #. type: Plain text
12946 #: ../misc-utils/fincore.1.adoc:39
12948 "Define output columns. See the *--help* output to get a list of the "
12949 "currently supported columns. The default list of columns may be extended if "
12950 "_list_ is specified in the format _{plus}list_."
12953 #. type: Plain text
12954 #: ../misc-utils/fincore.1.adoc:46 ../sys-utils/lsmem.1.adoc:56
12956 "Produce output in raw format. All potentially unsafe characters are hex-"
12957 "escaped (\\x<code>)."
12960 #. type: Labeled list
12961 #: ../misc-utils/fincore.1.adoc:47 ../misc-utils/findmnt.8.adoc:78
12962 #: ../misc-utils/lsblk.8.adoc:70 ../misc-utils/lsclocks.1.adoc:26
12963 #: ../misc-utils/lsfd.1.adoc:44 ../misc-utils/lslocks.8.adoc:43
12964 #: ../misc-utils/uuidparse.1.adoc:50 ../misc-utils/wipefs.8.adoc:49
12965 #: ../sys-utils/dmesg.1.adoc:72 ../sys-utils/losetup.8.adoc:116
12966 #: ../sys-utils/lscpu.1.adoc:66 ../sys-utils/lsipc.1.adoc:50
12967 #: ../sys-utils/lsirq.1.adoc:34 ../sys-utils/lsmem.1.adoc:39
12968 #: ../sys-utils/lsns.8.adoc:34 ../sys-utils/rfkill.8.adoc:27
12970 #| msgid "*-V*, *--version*"
12971 msgid "*-J*, *--json*"
12972 msgstr "*-V*, *--version*"
12974 #. type: Plain text
12975 #: ../misc-utils/fincore.1.adoc:49 ../misc-utils/findmnt.8.adoc:80
12976 #: ../misc-utils/lsclocks.1.adoc:28 ../misc-utils/lsfd.1.adoc:46
12977 #: ../misc-utils/lslocks.8.adoc:45 ../misc-utils/uuidparse.1.adoc:52
12978 #: ../misc-utils/wipefs.8.adoc:51 ../sys-utils/lsirq.1.adoc:36
12979 #: ../sys-utils/lsmem.1.adoc:41 ../sys-utils/lsns.8.adoc:36
12980 #: ../sys-utils/rfkill.8.adoc:29
12981 msgid "Use JSON output format."
12984 #. type: Plain text
12985 #: ../misc-utils/fincore.1.adoc:62
12993 "*getpagesize*(2),\n"
13001 #. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
13002 #. This file may be copied under the terms of the GNU Public License.
13004 #: ../misc-utils/findfs.8.adoc:4
13009 #. type: Plain text
13010 #: ../misc-utils/findfs.8.adoc:14
13011 msgid "findfs - find a filesystem by label or UUID"
13014 #. type: Plain text
13015 #: ../misc-utils/findfs.8.adoc:18
13017 msgid "*findfs* *NAME*=_value_\n"
13020 #. type: Plain text
13021 #: ../misc-utils/findfs.8.adoc:22
13023 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"
13026 #. type: Labeled list
13027 #: ../misc-utils/findfs.8.adoc:23
13029 msgid "*LABEL*=_<label>_"
13032 #. type: Plain text
13033 #: ../misc-utils/findfs.8.adoc:25
13034 msgid "Specifies filesystem label."
13037 #. type: Labeled list
13038 #: ../misc-utils/findfs.8.adoc:26
13040 msgid "*UUID*=_<uuid>_"
13043 #. type: Plain text
13044 #: ../misc-utils/findfs.8.adoc:28
13045 msgid "Specifies filesystem UUID."
13048 #. type: Labeled list
13049 #: ../misc-utils/findfs.8.adoc:29
13051 msgid "*PARTUUID*=_<uuid>_"
13054 #. type: Plain text
13055 #: ../misc-utils/findfs.8.adoc:31
13058 #| "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
13059 #| "identifiers are supported for example for GUID Partition Table (GPT)."
13061 "Specifies partition UUID. This partition identifier is supported for example "
13062 "for GUID Partition Table (GPT) partition tables."
13064 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
13065 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
13067 #. type: Labeled list
13068 #: ../misc-utils/findfs.8.adoc:32
13070 msgid "*PARTLABEL*=_<label>_"
13073 #. type: Plain text
13074 #: ../misc-utils/findfs.8.adoc:34
13077 #| "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
13078 #| "identifiers are supported for example for GUID Partition Table (GPT)."
13080 "Specifies partition label (name). The partition labels are supported for "
13081 "example for GUID Partition Table (GPT) or MAC partition tables."
13083 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
13084 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
13086 #. type: Plain text
13087 #: ../misc-utils/findfs.8.adoc:36
13089 "If the filesystem or partition is found, the device name will be printed on "
13093 #. type: Plain text
13094 #: ../misc-utils/findfs.8.adoc:38
13096 "The complete overview about filesystems and partitions you can get for "
13100 #. type: delimited block _
13101 #: ../misc-utils/findfs.8.adoc:41
13103 msgid "*lsblk --fs*\n"
13106 #. type: delimited block _
13107 #: ../misc-utils/findfs.8.adoc:43
13109 msgid "*partx --show <disk>*\n"
13112 #. type: delimited block _
13113 #: ../misc-utils/findfs.8.adoc:45
13118 #. type: Plain text
13119 #: ../misc-utils/findfs.8.adoc:55
13120 msgid "label or uuid cannot be found"
13123 #. type: Plain text
13124 #: ../misc-utils/findfs.8.adoc:57
13125 msgid "usage error, wrong number of arguments or unknown option"
13128 #. type: Plain text
13129 #: ../misc-utils/findfs.8.adoc:66
13131 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"
13134 #. type: Plain text
13135 #: ../misc-utils/findfs.8.adoc:72
13144 #: ../misc-utils/findmnt.8.adoc:2
13149 #. type: Plain text
13150 #: ../misc-utils/findmnt.8.adoc:13
13151 msgid "findmnt - find a filesystem"
13154 #. type: Plain text
13155 #: ../misc-utils/findmnt.8.adoc:17
13157 msgid "*findmnt* [options]\n"
13160 #. type: Plain text
13161 #: ../misc-utils/findmnt.8.adoc:19
13163 msgid "*findmnt* [options] _device_|_mountpoint_\n"
13166 #. type: Plain text
13167 #: ../misc-utils/findmnt.8.adoc:21
13169 msgid "*findmnt* [options] [*--source*] _device_ [*--target* _path_|*--mountpoint* _mountpoint_]\n"
13172 #. type: Plain text
13173 #: ../misc-utils/findmnt.8.adoc:25
13175 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"
13178 #. type: Plain text
13179 #: ../misc-utils/findmnt.8.adoc:27
13181 "The device may be specified by device name, major:minor numbers, filesystem "
13182 "label or UUID, or partition label or UUID. Note that *findmnt* follows "
13183 "*mount*(8) behavior where a device name may be interpreted as a mountpoint "
13184 "(and vice versa) if the *--target*, *--mountpoint* or *--source* options are "
13188 #. type: Plain text
13189 #: ../misc-utils/findmnt.8.adoc:29
13191 "The command-line option *--target* accepts any file or directory and then "
13192 "*findmnt* displays the filesystem for the given path."
13195 #. type: Plain text
13196 #: ../misc-utils/findmnt.8.adoc:31
13198 "The command prints all mounted filesystems in the tree-like format by "
13199 "default. The default output, is subject to change. So whenever possible, you "
13200 "should avoid using default output in your scripts. Always explicitly define "
13201 "expected columns by using *--output columns-list* in environments where a "
13202 "stable output is required."
13205 #. type: Plain text
13206 #: ../misc-utils/findmnt.8.adoc:33
13208 "The relationship between block devices and filesystems is not always one-to-"
13209 "one. The filesystem may use more block devices. This is why *findmnt* "
13210 "provides SOURCE and SOURCES (pl.) columns. The column SOURCES displays all "
13211 "devices where it is possible to find the same filesystem UUID (or another "
13212 "tag specified in _fstab_ when executed with *--fstab* and *--evaluate*)."
13215 #. type: Labeled list
13216 #: ../misc-utils/findmnt.8.adoc:36
13218 #| msgid "*-h*, *--help*"
13219 msgid "*-A*, *--all*"
13220 msgstr "*-h*, *--help*"
13222 #. type: Plain text
13223 #: ../misc-utils/findmnt.8.adoc:38
13224 msgid "Disable all built-in filters and print all filesystems."
13227 #. type: Labeled list
13228 #: ../misc-utils/findmnt.8.adoc:39
13230 #| msgid "*-f*, *--fast*"
13231 msgid "*-a*, *--ascii*"
13232 msgstr "*-f*, *--fast*"
13234 #. type: Plain text
13235 #: ../misc-utils/findmnt.8.adoc:41
13236 msgid "Use ascii characters for tree formatting."
13239 #. type: Labeled list
13240 #: ../misc-utils/findmnt.8.adoc:45
13242 msgid "*-C*, *--nocanonicalize*"
13245 #. type: Plain text
13246 #: ../misc-utils/findmnt.8.adoc:47
13248 "Do not canonicalize paths at all. This option affects the comparing of paths "
13249 "and the evaluation of tags (LABEL, UUID, etc.)."
13252 #. type: Labeled list
13253 #: ../misc-utils/findmnt.8.adoc:48
13255 msgid "*-c*, *--canonicalize*"
13258 #. type: Plain text
13259 #: ../misc-utils/findmnt.8.adoc:50
13260 msgid "Canonicalize all printed paths."
13263 #. type: Labeled list
13264 #: ../misc-utils/findmnt.8.adoc:51
13266 msgid "*--deleted*"
13269 #. type: Plain text
13270 #: ../misc-utils/findmnt.8.adoc:53
13272 "Print filesystems where target (mountpoint) is marked as deleted by kernel."
13275 #. type: Labeled list
13276 #: ../misc-utils/findmnt.8.adoc:54
13278 #| msgid "*-f*, *--fast*"
13279 msgid "*-D*, *--df*"
13280 msgstr "*-f*, *--fast*"
13282 #. type: Plain text
13283 #: ../misc-utils/findmnt.8.adoc:56
13285 "Imitate the output of *df*(1). This option is equivalent to *-o SOURCE,"
13286 "FSTYPE,SIZE,USED,AVAIL,USE%,TARGET* but excludes all pseudo filesystems. Use "
13287 "*--all* to print all filesystems. See also *-I*, *--dfi* options."
13290 #. type: Labeled list
13291 #: ../misc-utils/findmnt.8.adoc:57
13293 #| msgid "*-V*, *--version*"
13294 msgid "*-d*, *--direction* _word_"
13295 msgstr "*-V*, *--version*"
13297 #. type: Plain text
13298 #: ../misc-utils/findmnt.8.adoc:59
13299 msgid "The search direction, either *forward* or *backward*."
13302 #. type: Labeled list
13303 #: ../misc-utils/findmnt.8.adoc:60
13305 #| msgid "*-h*, *--help*"
13306 msgid "*-e*, *--evaluate*"
13307 msgstr "*-h*, *--help*"
13309 #. type: Plain text
13310 #: ../misc-utils/findmnt.8.adoc:62
13312 "Convert all tags (LABEL, UUID, PARTUUID, or PARTLABEL) to the corresponding "
13313 "device names for the SOURCE column. It's an unusual situation, but the same "
13314 "tag may be duplicated (used for more devices). For this purpose, there is "
13315 "SOURCES (pl.) column. This column displays by multi-line cell all devices "
13316 "where the tag is detected by libblkid. This option makes sense for _fstab_ "
13320 #. type: Labeled list
13321 #: ../misc-utils/findmnt.8.adoc:63
13323 msgid "*-F*, *--tab-file* _path_"
13326 #. type: Plain text
13327 #: ../misc-utils/findmnt.8.adoc:65
13329 "Search in an alternative file. If used with *--fstab*, *--mtab* or *--"
13330 "kernel*, then it overrides the default paths. If specified more than once, "
13331 "then tree-like output is disabled (see the *--list* option)."
13334 #. type: Labeled list
13335 #: ../misc-utils/findmnt.8.adoc:66
13337 #| msgid "*-f*, *--fast*"
13338 msgid "*-f*, *--first-only*"
13339 msgstr "*-f*, *--fast*"
13341 #. type: Plain text
13342 #: ../misc-utils/findmnt.8.adoc:68
13343 msgid "Print the first matching filesystem only."
13346 #. type: Labeled list
13347 #: ../misc-utils/findmnt.8.adoc:69 ../misc-utils/lsblk.8.adoc:44
13348 #: ../misc-utils/lsfd.1.adoc:113 ../misc-utils/lslocks.8.adoc:37
13350 #| msgid "*-f*, *--fast*"
13351 msgid "*-H*, *--list-columns*"
13352 msgstr "*-f*, *--fast*"
13354 #. type: Plain text
13355 #: ../misc-utils/findmnt.8.adoc:71 ../misc-utils/lsblk.8.adoc:46
13356 #: ../misc-utils/lslocks.8.adoc:39
13358 "List the available columns, use with *--json* or *--raw* to get output in "
13359 "machine-readable format."
13362 #. type: Labeled list
13363 #: ../misc-utils/findmnt.8.adoc:72
13365 #| msgid "*-f*, *--fast*"
13366 msgid "*-I*, *--dfi*"
13367 msgstr "*-f*, *--fast*"
13369 #. type: Plain text
13370 #: ../misc-utils/findmnt.8.adoc:74
13372 "Imitate the output of *df*(1) with its *-i* option. This option is "
13373 "equivalent to *-o SOURCE,FSTYPE,INO.TOTAL,INO.USED,INO.AVAIL,INO.USE%,"
13374 "TARGET* but excludes all pseudo filesystems. Use *--all* to print all "
13378 #. type: Labeled list
13379 #: ../misc-utils/findmnt.8.adoc:75
13381 #| msgid "*-V*, *--version*"
13382 msgid "*-i*, *--invert*"
13383 msgstr "*-V*, *--version*"
13385 #. type: Plain text
13386 #: ../misc-utils/findmnt.8.adoc:77
13387 msgid "Invert the sense of matching."
13390 #. type: Labeled list
13391 #: ../misc-utils/findmnt.8.adoc:81 ../sys-utils/dmesg.1.adoc:78
13393 #| msgid "*-h*, *--help*"
13394 msgid "*-k*, *--kernel*"
13395 msgstr "*-h*, *--help*"
13397 #. type: Plain text
13398 #: ../misc-utils/findmnt.8.adoc:83
13400 "Search in _/proc/self/mountinfo_. The output is in the tree-like format. "
13401 "This is the default. The output contains only mount options maintained by "
13402 "kernel (see also *--mtab*)."
13405 #. type: Plain text
13406 #: ../misc-utils/findmnt.8.adoc:86
13408 "Use the list output format. This output format is automatically enabled if "
13409 "the output is restricted by the *-t*, *-O*, *-S* or *-T* option and the "
13410 "option *--submounts* is not used or if more that one source file (the option "
13411 "*-F*) is specified."
13414 #. type: Labeled list
13415 #: ../misc-utils/findmnt.8.adoc:87
13417 msgid "*-M*, *--mountpoint* _path_"
13420 #. type: Plain text
13421 #: ../misc-utils/findmnt.8.adoc:89
13423 "Explicitly define the mountpoint file or directory. See also *--target*."
13426 #. type: Labeled list
13427 #: ../misc-utils/findmnt.8.adoc:90
13429 #| msgid "*-P*, *--pty*"
13430 msgid "*-m*, *--mtab*"
13431 msgstr "*-P*, *--pty*"
13433 #. type: Plain text
13434 #: ../misc-utils/findmnt.8.adoc:92
13436 "Search in _/etc/mtab_. The output is in the list format by default (see *--"
13437 "tree*). The output may include user space mount options."
13440 #. type: Labeled list
13441 #: ../misc-utils/findmnt.8.adoc:93
13443 #| msgid "*-f*, *--fast*"
13444 msgid "*-N*, *--task* _tid_"
13445 msgstr "*-f*, *--fast*"
13447 #. type: Plain text
13448 #: ../misc-utils/findmnt.8.adoc:95
13450 "Use alternative namespace _/proc/<tid>/mountinfo_ rather than the default _/"
13451 "proc/self/mountinfo_. If the option is specified more than once, then tree-"
13452 "like output is disabled (see the *--list* option). See also the *unshare*(1) "
13456 #. type: Labeled list
13457 #: ../misc-utils/findmnt.8.adoc:99
13459 msgid "*-O*, *--options* _list_"
13462 #. TRANSLATORS: Keep {plus} untranslated.
13463 #. type: Plain text
13464 #: ../misc-utils/findmnt.8.adoc:101
13466 "Limit the set of printed filesystems. More than one option may be specified "
13467 "in a comma-separated list. The *-t* and *-O* options are cumulative in "
13468 "effect. It is different from *-t* in that each option is matched exactly; a "
13469 "leading _no_ at the beginning does not have global meaning. The \"no\" can "
13470 "used for individual items in the list. The \"no\" prefix interpretation can "
13471 "be disabled by \"{plus}\" prefix."
13474 #. type: Plain text
13475 #: ../misc-utils/findmnt.8.adoc:105
13477 "Define output columns. See the *--help* output to get a list of the "
13478 "currently supported columns. The *TARGET* column contains tree formatting if "
13479 "the *--list* or *--raw* options are not specified."
13482 #. TRANSLATORS: Keep {plus} untranslated.
13483 #. type: Plain text
13484 #: ../misc-utils/findmnt.8.adoc:107
13486 "The default list of columns may be extended if _list_ is specified in the "
13487 "format _{plus}list_ (e.g., *findmnt -o {plus}PROPAGATION*)."
13490 #. type: Plain text
13491 #: ../misc-utils/findmnt.8.adoc:111
13493 "Output almost all available columns. The columns that require *--poll* are "
13497 #. type: Plain text
13498 #: ../misc-utils/findmnt.8.adoc:114 ../sys-utils/lsipc.1.adoc:49
13500 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
13501 "value characters are hex-escaped (\\x<code>). See also option *--shell*."
13504 #. type: Plain text
13505 #: ../misc-utils/findmnt.8.adoc:116
13507 "Note that SOURCES column, use multi-line cells. In these cases, the column "
13508 "use an array-like formatting in the output, for example *name=(\"aaa\" "
13509 "\"bbb\" \"ccc\")*."
13512 #. type: Labeled list
13513 #: ../misc-utils/findmnt.8.adoc:117
13515 msgid "*-p*, *--poll*[_=list_]"
13518 #. type: Plain text
13519 #: ../misc-utils/findmnt.8.adoc:119
13521 "Monitor changes in the _/proc/self/mountinfo_ file. Supported actions are: "
13522 "mount, umount, remount and move. More than one action may be specified in a "
13523 "comma-separated list. All actions are monitored by default."
13526 #. type: Plain text
13527 #: ../misc-utils/findmnt.8.adoc:121
13529 "The time for which *--poll* will block can be restricted with the *--"
13530 "timeout* or *--first-only* options."
13533 #. type: Plain text
13534 #: ../misc-utils/findmnt.8.adoc:123
13536 "The standard columns always use the new version of the information from the "
13537 "mountinfo file, except the umount action which is based on the original "
13538 "information cached by *findmnt*. The poll mode allows using extra columns:"
13541 #. type: Labeled list
13542 #: ../misc-utils/findmnt.8.adoc:124
13547 #. type: Plain text
13548 #: ../misc-utils/findmnt.8.adoc:126
13550 "mount, umount, move or remount action name; this column is enabled by default"
13553 #. type: Labeled list
13554 #: ../misc-utils/findmnt.8.adoc:126
13556 msgid "*OLD-TARGET*"
13559 #. type: Plain text
13560 #: ../misc-utils/findmnt.8.adoc:128
13561 msgid "available for umount and move actions"
13564 #. type: Labeled list
13565 #: ../misc-utils/findmnt.8.adoc:128
13568 msgid "*OLD-OPTIONS*"
13571 #. type: Plain text
13572 #: ../misc-utils/findmnt.8.adoc:130
13573 msgid "available for umount and remount actions"
13576 #. type: Labeled list
13577 #: ../misc-utils/findmnt.8.adoc:131
13582 #. type: Plain text
13583 #: ../misc-utils/findmnt.8.adoc:133
13584 msgid "Print only pseudo filesystems."
13587 #. type: Labeled list
13588 #: ../misc-utils/findmnt.8.adoc:134
13593 #. type: Plain text
13594 #: ../misc-utils/findmnt.8.adoc:136 ../misc-utils/findmnt.8.adoc:165
13595 msgid "Print only filesystems over-mounted by another filesystem."
13598 #. type: Labeled list
13599 #: ../misc-utils/findmnt.8.adoc:137
13601 #| msgid "*-V*, *--version*"
13602 msgid "*-R*, *--submounts*"
13603 msgstr "*-V*, *--version*"
13605 #. type: Plain text
13606 #: ../misc-utils/findmnt.8.adoc:139
13608 "Print recursively all submounts for the selected filesystems. The "
13609 "restrictions defined by options *-t*, *-O*, *-S*, *-T* and *--direction* are "
13610 "not applied to submounts. All submounts are always printed in tree-like "
13611 "order. The option enables the tree-like output format by default. This "
13612 "option has no effect for *--mtab* or *--fstab*."
13615 #. type: Plain text
13616 #: ../misc-utils/findmnt.8.adoc:142
13618 "Use raw output format. All potentially unsafe characters are hex-escaped "
13622 #. type: Plain text
13623 #: ../misc-utils/findmnt.8.adoc:144
13625 "Note that column SOURCES, use multi-line cells. In these cases, the column "
13626 "may produce more strings on the same line."
13629 #. type: Labeled list
13630 #: ../misc-utils/findmnt.8.adoc:145
13635 #. type: Plain text
13636 #: ../misc-utils/findmnt.8.adoc:147
13637 msgid "Print only real filesystems."
13640 #. type: Labeled list
13641 #: ../misc-utils/findmnt.8.adoc:148
13643 #| msgid "*-s*, **--shell**=__shell__"
13644 msgid "*-S*, *--source* _spec_"
13645 msgstr "*-s*, **--shell**=__shell__"
13647 #. type: Plain text
13648 #: ../misc-utils/findmnt.8.adoc:150
13650 "Explicitly define the mount source. Supported specifications are _device_, "
13651 "__maj__**:**_min_, **LABEL=**__label__, **UUID=**__uuid__, "
13652 "**PARTLABEL=**__label__ and **PARTUUID=**__uuid__."
13655 #. type: Labeled list
13656 #: ../misc-utils/findmnt.8.adoc:151
13658 #| msgid "*-f*, *--fast*"
13659 msgid "*-s*, *--fstab*"
13660 msgstr "*-f*, *--fast*"
13662 #. type: Plain text
13663 #: ../misc-utils/findmnt.8.adoc:153
13665 "Search in _/etc/fstab_. The output is in the list format (see *--list*)."
13668 #. type: Labeled list
13669 #: ../misc-utils/findmnt.8.adoc:154
13671 msgid "*-T*, *--target* _path_"
13674 #. type: Plain text
13675 #: ../misc-utils/findmnt.8.adoc:156
13677 "Define the mount target. If _path_ is not a mountpoint file or directory, "
13678 "then *findmnt* checks the _path_ elements in reverse order to get the "
13679 "mountpoint (this feature is supported only when searching in kernel files "
13680 "and unsupported for *--fstab*). It's recommended to use the option *--"
13681 "mountpoint* when checks of _path_ elements are unwanted and _path_ is a "
13682 "strictly specified mountpoint."
13685 #. type: Labeled list
13686 #: ../misc-utils/findmnt.8.adoc:157 ../misc-utils/wipefs.8.adoc:75
13687 #: ../sys-utils/fstrim.8.adoc:56
13689 #| msgid "*-P*, *--pty*"
13690 msgid "*-t*, *--types* _list_"
13691 msgstr "*-P*, *--pty*"
13693 #. type: Plain text
13694 #: ../misc-utils/findmnt.8.adoc:159
13696 "Limit the set of printed filesystems. More than one type may be specified in "
13697 "a comma-separated list. The list of filesystem types can be prefixed with "
13698 "*no* to specify the filesystem types on which no action should be taken. For "
13699 "more details see *mount*(8)."
13702 #. type: Labeled list
13703 #: ../misc-utils/findmnt.8.adoc:160
13708 #. type: Plain text
13709 #: ../misc-utils/findmnt.8.adoc:162
13711 "Enable tree-like output if possible. The options is silently ignored for "
13712 "tables where is missing child-parent relation (e.g., _fstab_)."
13715 #. type: Labeled list
13716 #: ../misc-utils/findmnt.8.adoc:163
13718 msgid "*--shadowed*"
13721 #. type: Labeled list
13722 #: ../misc-utils/findmnt.8.adoc:166
13724 #| msgid "*-P*, *--pty*"
13725 msgid "*-U*, *--uniq*"
13726 msgstr "*-P*, *--pty*"
13728 #. type: Plain text
13729 #: ../misc-utils/findmnt.8.adoc:168
13731 "Ignore filesystems with duplicate mount targets, thus effectively skipping "
13732 "over-mounted mount points."
13735 #. type: Labeled list
13736 #: ../misc-utils/findmnt.8.adoc:169 ../misc-utils/lslocks.8.adoc:64
13737 #: ../sys-utils/lsns.8.adoc:64
13739 #| msgid "*-f*, *--fast*"
13740 msgid "*-u*, *--notruncate*"
13741 msgstr "*-f*, *--fast*"
13743 #. type: Plain text
13744 #: ../misc-utils/findmnt.8.adoc:171
13746 "Do not truncate text in columns. The default is to not truncate the "
13747 "*TARGET*, *SOURCE*, *UUID*, *LABEL*, *PARTUUID*, *PARTLABEL* columns. This "
13748 "option disables text truncation also in all other columns."
13751 #. type: Labeled list
13752 #: ../misc-utils/findmnt.8.adoc:172
13754 #| msgid "*-f*, *--fast*"
13755 msgid "*-v*, *--nofsroot*"
13756 msgstr "*-f*, *--fast*"
13758 #. type: Plain text
13759 #: ../misc-utils/findmnt.8.adoc:174
13761 "Do not print a [/dir] in the SOURCE column for bind mounts or btrfs "
13765 #. type: Labeled list
13766 #: ../misc-utils/findmnt.8.adoc:175
13768 msgid "*-w*, *--timeout* _milliseconds_"
13771 #. type: Plain text
13772 #: ../misc-utils/findmnt.8.adoc:177
13774 "Specify an upper limit on the time for which *--poll* will block, in "
13778 #. type: Labeled list
13779 #: ../misc-utils/findmnt.8.adoc:178
13781 #| msgid "*-V*, *--version*"
13782 msgid "*-x*, *--verify*"
13783 msgstr "*-V*, *--version*"
13785 #. type: Plain text
13786 #: ../misc-utils/findmnt.8.adoc:180
13788 "Check mount table content. The default is to verify _/etc/fstab_ parsability "
13789 "and usability. It's possible to use this option also with *--tab-file*. It's "
13790 "possible to specify source (device) or target (mountpoint) to filter mount "
13791 "table. The option *--verbose* forces *findmnt* to print more details."
13794 #. type: Plain text
13795 #: ../misc-utils/findmnt.8.adoc:183
13796 msgid "Force *findmnt* to print more information (*--verify* only for now)."
13799 #. type: Labeled list
13800 #: ../misc-utils/findmnt.8.adoc:184
13802 msgid "*--vfs-all*"
13805 #. type: Plain text
13806 #: ../misc-utils/findmnt.8.adoc:186
13808 "When used with *VFS-OPTIONS* column, print all VFS (fs-independent) flags. "
13809 "This option is designed for auditing purposes to list also default VFS "
13810 "kernel mount options which are normally not listed."
13813 #. type: Plain text
13814 #: ../misc-utils/findmnt.8.adoc:189
13816 "The column name will be modified to contain only characters allowed for "
13817 "shell variable identifiers. This is usable, for example, with *--pairs*. "
13818 "Note that this feature has been automatically enabled for *--pairs* in "
13819 "version 2.37, but due to compatibility issues, now it's necessary to request "
13820 "this behavior by *--shell*."
13823 #. type: Plain text
13824 #: ../misc-utils/findmnt.8.adoc:197
13826 "The exit value is 0 if there is something to display, or 1 on any error (for "
13827 "example if no filesystem is found based on the user's filter specification, "
13828 "or the device path or mountpoint does not exist)."
13831 #. type: Labeled list
13832 #: ../misc-utils/findmnt.8.adoc:200 ../sys-utils/mount.8.adoc:1632
13833 #: ../sys-utils/umount.8.adoc:152
13835 msgid "*LIBMOUNT_FSTAB*=<path>"
13838 #. type: Plain text
13839 #: ../misc-utils/findmnt.8.adoc:202
13840 msgid "overrides the default location of the _fstab_ file"
13843 #. type: Labeled list
13844 #: ../misc-utils/findmnt.8.adoc:203
13846 msgid "*LIBMOUNT_MTAB*=<path>"
13849 #. type: Plain text
13850 #: ../misc-utils/findmnt.8.adoc:205
13851 msgid "overrides the default location of the _mtab_ file"
13854 #. type: Labeled list
13855 #: ../misc-utils/findmnt.8.adoc:206 ../misc-utils/lsblk.8.adoc:205
13856 #: ../sys-utils/mount.8.adoc:1635 ../sys-utils/mountpoint.1.adoc:54
13857 #: ../sys-utils/swapon.8.adoc:125 ../sys-utils/umount.8.adoc:155
13859 msgid "*LIBMOUNT_DEBUG*=all"
13862 #. type: Plain text
13863 #: ../misc-utils/findmnt.8.adoc:208 ../sys-utils/mount.8.adoc:1637
13864 msgid "enables libmount debug output"
13867 #. type: Plain text
13868 #: ../misc-utils/findmnt.8.adoc:211
13869 msgid "enables libsmartcols debug output"
13872 #. type: Labeled list
13873 #: ../misc-utils/findmnt.8.adoc:217
13875 msgid "*findmnt --fstab -t nfs*"
13878 #. type: Plain text
13879 #: ../misc-utils/findmnt.8.adoc:219
13880 msgid "Prints all NFS filesystems defined in _/etc/fstab_."
13883 #. type: Labeled list
13884 #: ../misc-utils/findmnt.8.adoc:220
13886 msgid "*findmnt --fstab /mnt/foo*"
13889 #. type: Plain text
13890 #: ../misc-utils/findmnt.8.adoc:222
13892 "Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/"
13893 "foo_. It also prints bind mounts where _/mnt/foo_ is a source."
13896 #. type: Labeled list
13897 #: ../misc-utils/findmnt.8.adoc:223
13899 msgid "*findmnt --fstab --target /mnt/foo*"
13902 #. type: Plain text
13903 #: ../misc-utils/findmnt.8.adoc:225
13905 "Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/"
13909 #. type: Labeled list
13910 #: ../misc-utils/findmnt.8.adoc:226
13912 msgid "*findmnt --fstab --evaluate*"
13915 #. type: Plain text
13916 #: ../misc-utils/findmnt.8.adoc:228
13918 "Prints all _/etc/fstab_ filesystems and converts LABEL= and UUID= tags to "
13919 "the real device names."
13922 #. type: Labeled list
13923 #: ../misc-utils/findmnt.8.adoc:229
13925 msgid "*findmnt -n --raw --evaluate --output=target LABEL=/boot*"
13928 #. type: Plain text
13929 #: ../misc-utils/findmnt.8.adoc:231
13931 "Prints only the mountpoint where the filesystem with label \"/boot\" is "
13935 #. type: Labeled list
13936 #: ../misc-utils/findmnt.8.adoc:232
13938 msgid "*findmnt --poll --mountpoint /mnt/foo*"
13941 #. type: Plain text
13942 #: ../misc-utils/findmnt.8.adoc:234
13943 msgid "Monitors mount, unmount, remount and move on _/mnt/foo_."
13946 #. type: Labeled list
13947 #: ../misc-utils/findmnt.8.adoc:235
13949 msgid "*findmnt --poll=umount --first-only --mountpoint /mnt/foo*"
13952 #. type: Plain text
13953 #: ../misc-utils/findmnt.8.adoc:237
13954 msgid "Waits for _/mnt/foo_ unmount."
13957 #. type: Labeled list
13958 #: ../misc-utils/findmnt.8.adoc:238
13960 msgid "*findmnt --poll=remount -t ext3 -O ro*"
13963 #. type: Plain text
13964 #: ../misc-utils/findmnt.8.adoc:240
13965 msgid "Monitors remounts to read-only mode on all ext3 filesystems."
13968 #. type: Plain text
13969 #: ../misc-utils/findmnt.8.adoc:249
13977 #: ../misc-utils/getopt.1.adoc:2
13982 #. type: Plain text
13983 #: ../misc-utils/getopt.1.adoc:13
13984 msgid "getopt - parse command options (enhanced)"
13987 #. type: Plain text
13988 #: ../misc-utils/getopt.1.adoc:17
13990 msgid "*getopt* _optstring_ _parameters_\n"
13993 #. type: Plain text
13994 #: ../misc-utils/getopt.1.adoc:19
13996 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
13997 msgid "*getopt* [options] [*--*] _optstring_ _parameters_\n"
13998 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
14000 #. type: Plain text
14001 #: ../misc-utils/getopt.1.adoc:21
14003 msgid "*getopt* [options] *-o*|*--options* _optstring_ [options] [*--*] _parameters_\n"
14006 #. type: Plain text
14007 #: ../misc-utils/getopt.1.adoc:25
14009 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"
14012 #. type: Plain text
14013 #: ../misc-utils/getopt.1.adoc:27
14015 "The parameters *getopt* is called with can be divided into two parts: "
14016 "options which modify the way *getopt* will do the parsing (the _options_ and "
14017 "the _optstring_ in the *SYNOPSIS*), and the parameters which are to be "
14018 "parsed (_parameters_ in the *SYNOPSIS*). The second part will start at the "
14019 "first non-option parameter that is not an option argument, or after the "
14020 "first occurrence of '*--*'. If no '*-o*' or '*--options*' option is found in "
14021 "the first part, the first parameter of the second part is used as the short "
14025 #. type: Plain text
14026 #: ../misc-utils/getopt.1.adoc:29
14028 "If the environment variable *GETOPT_COMPATIBLE* is set, or if the first "
14029 "_parameter_ is not an option (does not start with a '*-*', the first format "
14030 "in the *SYNOPSIS*), *getopt* will generate output that is compatible with "
14031 "that of other versions of *getopt*(1). It will still do parameter shuffling "
14032 "and recognize optional arguments (see the *COMPATIBILITY* section for more "
14036 #. type: Plain text
14037 #: ../misc-utils/getopt.1.adoc:31
14039 "Traditional implementations of *getopt*(1) are unable to cope with "
14040 "whitespace and other (shell-specific) special characters in arguments and "
14041 "non-option parameters. To solve this problem, this implementation can "
14042 "generate quoted output which must once again be interpreted by the shell "
14043 "(usually by using the *eval* command). This has the effect of preserving "
14044 "those characters, but you must call *getopt* in a way that is no longer "
14045 "compatible with other versions (the second or third format in the "
14046 "*SYNOPSIS*). To determine whether this enhanced version of *getopt*(1) is "
14047 "installed, a special test option (*-T*) can be used."
14050 #. type: Labeled list
14051 #: ../misc-utils/getopt.1.adoc:34 ../misc-utils/look.1.adoc:59
14053 #| msgid "*-V*, *--version*"
14054 msgid "*-a*, *--alternative*"
14055 msgstr "*-V*, *--version*"
14057 #. type: Plain text
14058 #: ../misc-utils/getopt.1.adoc:36
14059 msgid "Allow long options to start with a single '*-*'."
14062 #. type: Labeled list
14063 #: ../misc-utils/getopt.1.adoc:37
14065 msgid "*-l*, *--longoptions* _longopts_"
14068 #. type: Plain text
14069 #: ../misc-utils/getopt.1.adoc:39
14071 "The long (multi-character) options to be recognized. More than one option "
14072 "name may be specified at once, by separating the names with commas. This "
14073 "option may be given more than once, the _longopts_ are cumulative. Each long "
14074 "option name in _longopts_ may be followed by one colon to indicate it has a "
14075 "required argument, and by two colons to indicate it has an optional argument."
14078 #. type: Labeled list
14079 #: ../misc-utils/getopt.1.adoc:40
14081 msgid "*-n*, *--name* _progname_"
14084 #. type: Plain text
14085 #: ../misc-utils/getopt.1.adoc:42
14087 "The name that will be used by the *getopt*(3) routines when it reports "
14088 "errors. Note that errors of *getopt*(1) are still reported as coming from "
14092 #. type: Labeled list
14093 #: ../misc-utils/getopt.1.adoc:43
14095 msgid "*-o*, *--options* _shortopts_"
14098 #. TRANSLATORS: Keep {plus} untranslated.
14099 #. type: Plain text
14100 #: ../misc-utils/getopt.1.adoc:45
14102 "The short (one-character) options to be recognized. If this option is not "
14103 "found, the first parameter of *getopt* that does not start with a '*-*' (and "
14104 "is not an option argument) is used as the short options string. Each short "
14105 "option character in _shortopts_ may be followed by one colon to indicate it "
14106 "has a required argument, and by two colons to indicate it has an optional "
14107 "argument. The first character of shortopts may be '*{plus}*' or '*-*' to "
14108 "influence the way options are parsed and output is generated (see the "
14109 "*SCANNING MODES* section for details)."
14112 #. type: Plain text
14113 #: ../misc-utils/getopt.1.adoc:49
14114 msgid "Disable error reporting by *getopt*(3)."
14117 #. type: Labeled list
14118 #: ../misc-utils/getopt.1.adoc:50
14120 #| msgid "*-P*, *--pty*"
14121 msgid "*-Q*, *--quiet-output*"
14122 msgstr "*-P*, *--pty*"
14124 #. type: Plain text
14125 #: ../misc-utils/getopt.1.adoc:52
14127 "Do not generate normal output. Errors are still reported by *getopt*(3), "
14128 "unless you also use *-q*."
14131 #. type: Plain text
14132 #: ../misc-utils/getopt.1.adoc:55
14134 "Set quoting conventions to those of _shell_. If the *-s* option is not "
14135 "given, the *BASH* conventions are used. Valid arguments are currently "
14136 "'*sh*', '*bash*', '*csh*', and '*tcsh*'."
14139 #. type: Labeled list
14140 #: ../misc-utils/getopt.1.adoc:56
14142 #| msgid "*-f*, *--fast*"
14143 msgid "*-T*, *--test*"
14144 msgstr "*-f*, *--fast*"
14146 #. type: Plain text
14147 #: ../misc-utils/getopt.1.adoc:58
14149 "Test if your *getopt*(1) is this enhanced version or an old version. This "
14150 "generates no output, and sets the error status to 4. Other implementations "
14151 "of *getopt*(1), and this version if the environment variable "
14152 "*GETOPT_COMPATIBLE* is set, will return '*--*' and error status 0."
14155 #. type: Labeled list
14156 #: ../misc-utils/getopt.1.adoc:59
14158 #| msgid "*-P*, *--pty*"
14159 msgid "*-u*, *--unquoted*"
14160 msgstr "*-P*, *--pty*"
14162 #. type: Plain text
14163 #: ../misc-utils/getopt.1.adoc:61
14165 "Do not quote the output. Note that whitespace and special (shell-dependent) "
14166 "characters can cause havoc in this mode (like they do with other *getopt*(1) "
14167 "implementations)."
14171 #: ../misc-utils/getopt.1.adoc:64
14176 #. type: Plain text
14177 #: ../misc-utils/getopt.1.adoc:67
14179 "This section specifies the format of the second part of the parameters of "
14180 "*getopt* (the _parameters_ in the *SYNOPSIS*). The next section (*OUTPUT*) "
14181 "describes the output that is generated. These parameters were typically the "
14182 "parameters a shell function was called with. Care must be taken that each "
14183 "parameter the shell function was called with corresponds to exactly one "
14184 "parameter in the parameter list of *getopt* (see the *EXAMPLES*). All "
14185 "parsing is done by the GNU *getopt*(3) routines."
14188 #. type: Plain text
14189 #: ../misc-utils/getopt.1.adoc:69
14191 "The parameters are parsed from left to right. Each parameter is classified "
14192 "as a short option, a long option, an argument to an option, or a non-option "
14196 #. type: Plain text
14197 #: ../misc-utils/getopt.1.adoc:71
14199 "A simple short option is a '*-*' followed by a short option character. If "
14200 "the option has a required argument, it may be written directly after the "
14201 "option character or as the next parameter (i.e., separated by whitespace on "
14202 "the command line). If the option has an optional argument, it must be "
14203 "written directly after the option character if present."
14206 #. type: Plain text
14207 #: ../misc-utils/getopt.1.adoc:73
14209 "It is possible to specify several short options after one '*-*', as long as "
14210 "all (except possibly the last) do not have required or optional arguments."
14213 #. type: Plain text
14214 #: ../misc-utils/getopt.1.adoc:75
14216 "A long option normally begins with '*--*' followed by the long option name. "
14217 "If the option has a required argument, it may be written directly after the "
14218 "long option name, separated by '*=*', or as the next argument (i.e., "
14219 "separated by whitespace on the command line). If the option has an optional "
14220 "argument, it must be written directly after the long option name, separated "
14221 "by '*=*', if present (if you add the '*=*' but nothing behind it, it is "
14222 "interpreted as if no argument was present; this is a slight bug, see the "
14223 "*BUGS*). Long options may be abbreviated, as long as the abbreviation is not "
14227 #. TRANSLATORS: Keep {plus} untranslated.
14228 #. type: Plain text
14229 #: ../misc-utils/getopt.1.adoc:77
14231 "Each parameter not starting with a '*-*', and not a required argument of a "
14232 "previous option, is a non-option parameter. Each parameter after a '*--*' "
14233 "parameter is always interpreted as a non-option parameter. If the "
14234 "environment variable *POSIXLY_CORRECT* is set, or if the short option string "
14235 "started with a '*{plus}*', all remaining parameters are interpreted as non-"
14236 "option parameters as soon as the first non-option parameter is found."
14240 #: ../misc-utils/getopt.1.adoc:79 ../misc-utils/lslocks.8.adoc:69
14241 #: ../misc-utils/uuidparse.1.adoc:23
14246 #. type: Plain text
14247 #: ../misc-utils/getopt.1.adoc:82
14249 "Output is generated for each element described in the previous section. "
14250 "Output is done in the same order as the elements are specified in the input, "
14251 "except for non-option parameters. Output can be done in _compatible_ "
14252 "(_unquoted_) mode, or in such way that whitespace and other special "
14253 "characters within arguments and non-option parameters are preserved (see "
14254 "*QUOTING*). When the output is processed in the shell script, it will seem "
14255 "to be composed of distinct elements that can be processed one by one (by "
14256 "using the shift command in most shell languages). This is imperfect in "
14257 "unquoted mode, as elements can be split at unexpected places if they contain "
14258 "whitespace or special characters."
14261 #. type: Plain text
14262 #: ../misc-utils/getopt.1.adoc:84
14264 "If there are problems parsing the parameters, for example because a required "
14265 "argument is not found or an option is not recognized, an error will be "
14266 "reported on stderr, there will be no output for the offending element, and a "
14267 "non-zero error status is returned."
14270 #. type: Plain text
14271 #: ../misc-utils/getopt.1.adoc:86
14273 "For a short option, a single '*-*' and the option character are generated as "
14274 "one parameter. If the option has an argument, the next parameter will be the "
14275 "argument. If the option takes an optional argument, but none was found, the "
14276 "next parameter will be generated but be empty in quoting mode, but no second "
14277 "parameter will be generated in unquoted (compatible) mode. Note that many "
14278 "other *getopt*(1) implementations do not support optional arguments."
14281 #. type: Plain text
14282 #: ../misc-utils/getopt.1.adoc:88
14284 "If several short options were specified after a single '*-*', each will be "
14285 "present in the output as a separate parameter."
14288 #. type: Plain text
14289 #: ../misc-utils/getopt.1.adoc:90
14291 "For a long option, '*--*' and the full option name are generated as one "
14292 "parameter. This is done regardless whether the option was abbreviated or "
14293 "specified with a single '*-*' in the input. Arguments are handled as with "
14297 #. TRANSLATORS: Keep {plus} untranslated.
14298 #. type: Plain text
14299 #: ../misc-utils/getopt.1.adoc:92
14301 "Normally, no non-option parameters output is generated until all options and "
14302 "their arguments have been generated. Then '*--*' is generated as a single "
14303 "parameter, and after it the non-option parameters in the order they were "
14304 "found, each as a separate parameter. Only if the first character of the "
14305 "short options string was a '*-*', non-option parameter output is generated "
14306 "at the place they are found in the input (this is not supported if the first "
14307 "format of the *SYNOPSIS* is used; in that case all preceding occurrences of "
14308 "'*-*' and '*{plus}*' are ignored)."
14312 #: ../misc-utils/getopt.1.adoc:94
14317 #. type: Plain text
14318 #: ../misc-utils/getopt.1.adoc:97
14320 "In compatibility mode, whitespace or 'special' characters in arguments or "
14321 "non-option parameters are not handled correctly. As the output is fed to the "
14322 "shell script, the script does not know how it is supposed to break the "
14323 "output into separate parameters. To circumvent this problem, this "
14324 "implementation offers quoting. The idea is that output is generated with "
14325 "quotes around each parameter. When this output is once again fed to the "
14326 "shell (usually by a shell *eval* command), it is split correctly into "
14327 "separate parameters."
14330 #. type: Plain text
14331 #: ../misc-utils/getopt.1.adoc:99
14333 "Quoting is not enabled if the environment variable *GETOPT_COMPATIBLE* is "
14334 "set, if the first form of the *SYNOPSIS* is used, or if the option '*-u*' is "
14338 #. type: Plain text
14339 #: ../misc-utils/getopt.1.adoc:101
14341 "Different shells use different quoting conventions. You can use the '*-s*' "
14342 "option to select the shell you are using. The following shells are currently "
14343 "supported: '*sh*', '*bash*', '*csh*' and '*tcsh*'. Actually, only two "
14344 "'flavors' are distinguished: sh-like quoting conventions and csh-like "
14345 "quoting conventions. Chances are that if you use another shell script "
14346 "language, one of these flavors can still be used."
14350 #: ../misc-utils/getopt.1.adoc:102
14352 msgid "SCANNING MODES"
14355 #. TRANSLATORS: Keep {plus} untranslated.
14356 #. type: Plain text
14357 #: ../misc-utils/getopt.1.adoc:105
14359 "The first character of the short options string may be a '*-*' or a '*{plus}"
14360 "*' to indicate a special scanning mode. If the first calling form in the "
14361 "*SYNOPSIS* is used they are ignored; the environment variable "
14362 "*POSIXLY_CORRECT* is still examined, though."
14365 #. TRANSLATORS: Keep {plus} untranslated.
14366 #. type: Plain text
14367 #: ../misc-utils/getopt.1.adoc:108
14369 "If the first character is '*{plus}*', or if the environment variable "
14370 "*POSIXLY_CORRECT* is set, parsing stops as soon as the first non-option "
14371 "parameter (i.e., a parameter that does not start with a '*-*') is found that "
14372 "is not an option argument. The remaining parameters are all interpreted as "
14373 "non-option parameters."
14376 #. type: Plain text
14377 #: ../misc-utils/getopt.1.adoc:111
14379 "If the first character is a '*-*', non-option parameters are outputted at "
14380 "the place where they are found; in normal operation, they are all collected "
14381 "at the end of output after a '*--*' parameter has been generated. Note that "
14382 "this '*--*' parameter is still generated, but it will always be the last "
14383 "parameter in this mode."
14386 #. type: Plain text
14387 #: ../misc-utils/getopt.1.adoc:115
14389 "This version of *getopt*(1) is written to be as compatible as possible to "
14390 "other versions. Usually you can just replace them with this version without "
14391 "any modifications, and with some advantages."
14394 #. TRANSLATORS: Keep {plus} untranslated.
14395 #. type: Plain text
14396 #: ../misc-utils/getopt.1.adoc:117
14398 "If the first character of the first parameter of getopt is not a '*-*', "
14399 "*getopt* goes into compatibility mode. It will interpret its first parameter "
14400 "as the string of short options, and all other arguments will be parsed. It "
14401 "will still do parameter shuffling (i.e., all non-option parameters are "
14402 "output at the end), unless the environment variable *POSIXLY_CORRECT* is "
14403 "set, in which case, *getopt* will prepend a '*{plus}*' before short options "
14407 #. type: Plain text
14408 #: ../misc-utils/getopt.1.adoc:120
14410 "The environment variable *GETOPT_COMPATIBLE* forces *getopt* into "
14411 "compatibility mode. Setting both this environment variable and "
14412 "*POSIXLY_CORRECT* offers 100% compatibility for 'difficult' programs. "
14413 "Usually, though, neither is needed."
14416 #. TRANSLATORS: Keep {plus} untranslated.
14417 #. type: Plain text
14418 #: ../misc-utils/getopt.1.adoc:122
14420 "In compatibility mode, leading '*-*' and '*{plus}*' characters in the short "
14421 "options string are ignored."
14425 #: ../misc-utils/getopt.1.adoc:124
14427 msgid "RETURN CODES"
14430 #. type: Plain text
14431 #: ../misc-utils/getopt.1.adoc:127
14433 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"
14436 #. TRANSLATORS: Don't translate _{package-docdir}_.
14437 #. type: Plain text
14438 #: ../misc-utils/getopt.1.adoc:132
14440 "Example scripts for (ba)sh and (t)csh are provided with the *getopt*(1) "
14441 "distribution, and are installed in _{package-docdir}_ directory."
14444 #. type: Labeled list
14445 #: ../misc-utils/getopt.1.adoc:135 ../text-utils/more.1.adoc:183
14447 msgid "*POSIXLY_CORRECT*"
14450 #. type: Plain text
14451 #: ../misc-utils/getopt.1.adoc:137
14453 "This environment variable is examined by the *getopt*(3) routines. If it is "
14454 "set, parsing stops as soon as a parameter is found that is not an option or "
14455 "an option argument. All remaining parameters are also interpreted as non-"
14456 "option parameters, regardless whether they start with a '*-*'."
14459 #. type: Labeled list
14460 #: ../misc-utils/getopt.1.adoc:138
14462 msgid "*GETOPT_COMPATIBLE*"
14465 #. type: Plain text
14466 #: ../misc-utils/getopt.1.adoc:140
14468 "Forces *getopt* to use the first calling format as specified in the "
14472 #. type: Plain text
14473 #: ../misc-utils/getopt.1.adoc:144
14475 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"
14478 #. type: Plain text
14479 #: ../misc-utils/getopt.1.adoc:146
14481 "The syntax if you do not want any short option variables at all is not very "
14482 "intuitive (you have to set them explicitly to the empty string)."
14486 #: ../misc-utils/getopt.1.adoc:147 ../misc-utils/hardlink.1.adoc:144
14487 #: ../misc-utils/uuidd.8.adoc:84
14492 #. type: Plain text
14493 #: ../misc-utils/getopt.1.adoc:150
14494 msgid "mailto:frodo@frodo.looijaard.name[Frodo Looijaard]"
14497 #. type: Plain text
14498 #: ../misc-utils/getopt.1.adoc:156
14514 #. SPDX-License-Identifier: MIT
14515 #. Copyright (C) 2008 - 2012 Julian Andres Klode. See hardlink.c for license.
14516 #. Copyright (C) 2021 Karel Zak <kzak@redhat.com>
14518 #: ../misc-utils/hardlink.1.adoc:8
14520 msgid "hardlink(1)"
14523 #. type: Plain text
14524 #: ../misc-utils/hardlink.1.adoc:18
14525 msgid "hardlink - link multiple copies of a file"
14528 #. type: Plain text
14529 #: ../misc-utils/hardlink.1.adoc:22
14531 msgid "*hardlink* [options] [_directory_|_file_]...\n"
14534 #. type: Plain text
14535 #: ../misc-utils/hardlink.1.adoc:27
14538 "*hardlink* is a tool that replaces copies of a file with either hardlinks\n"
14539 "or copy-on-write clones, thus saving space.\n"
14542 #. type: Plain text
14543 #: ../misc-utils/hardlink.1.adoc:35
14546 "*hardlink* first creates a binary tree of file sizes and then compares\n"
14547 "the content of files that have the same size. There are two basic content\n"
14548 "comparison methods. The *memcmp* method directly reads data blocks from\n"
14549 "files and compares them. The other method is based on checksums (like SHA256);\n"
14550 "in this case for each data block a checksum is calculated by the Linux kernel\n"
14551 "crypto API, and this checksum is stored in userspace and used for file\n"
14555 #. type: Plain text
14556 #: ../misc-utils/hardlink.1.adoc:40
14558 "For each file also an \"intro\" buffer (32 bytes) is cached. This buffer is "
14559 "used independently from the comparison method and requested cache-size and "
14560 "io-size. The \"intro\" buffer dramatically reduces operations with data "
14561 "content as files are very often different from the beginning."
14564 #. type: Labeled list
14565 #: ../misc-utils/hardlink.1.adoc:45
14567 #| msgid "*-P*, *--pty*"
14568 msgid "*-c*, *--content*"
14569 msgstr "*-P*, *--pty*"
14571 #. type: Plain text
14572 #: ../misc-utils/hardlink.1.adoc:47
14574 "Consider only file content, not attributes, when determining whether two "
14575 "files are equal. Same as *-pot*."
14578 #. type: Labeled list
14579 #: ../misc-utils/hardlink.1.adoc:48
14581 msgid "*-b*, *--io-size* _size_"
14584 #. type: Plain text
14585 #: ../misc-utils/hardlink.1.adoc:56
14587 "The size of the *read*(2) or *sendfile*(2) buffer used when comparing file "
14588 "contents. The _size_ argument may be followed by the multiplicative "
14589 "suffixes KiB, MiB, etc. The \"iB\" is optional, e.g., \"K\" has the same "
14590 "meaning as \"KiB\". The default is 8KiB for memcmp method and 1MiB for the "
14591 "other methods. The only memcmp method uses process memory for the buffer, "
14592 "other methods use zero-copy way and I/O operation is done in the kernel. The "
14593 "size may be altered on the fly to fit a number of cached content checksums."
14596 #. type: Labeled list
14597 #: ../misc-utils/hardlink.1.adoc:57
14599 #| msgid "*-f*, *--fast*"
14600 msgid "*-d*, *--respect-dir*"
14601 msgstr "*-f*, *--fast*"
14603 #. type: Plain text
14604 #: ../misc-utils/hardlink.1.adoc:59
14606 "Only try to link files with the same directory name. The top-level directory "
14607 "(as specified on the *hardlink* command line) is ignored. For example, "
14608 "*hardlink --respect-dir /foo /bar* will link _/foo/some/file_ with _/bar/"
14609 "some/file_, but not _/bar/other/file_. If combined with *--respect-name*, "
14610 "then entire paths (except the top-level directory) are compared."
14613 #. type: Labeled list
14614 #: ../misc-utils/hardlink.1.adoc:60
14616 #| msgid "*-f*, *--fast*"
14617 msgid "*-f*, *--respect-name*"
14618 msgstr "*-f*, *--fast*"
14620 #. type: Plain text
14621 #: ../misc-utils/hardlink.1.adoc:62
14623 "Only try to link files with the same (base)name. It's strongly recommended "
14624 "to use long options rather than *-f* which is interpreted in a different way "
14625 "by other *hardlink* implementations."
14628 #. type: Labeled list
14629 #: ../misc-utils/hardlink.1.adoc:63
14631 msgid "*-i*, *--include* _regex_"
14634 #. type: Plain text
14635 #: ../misc-utils/hardlink.1.adoc:65
14637 "A regular expression to include files. If the option *--exclude* has been "
14638 "given, this option re-includes files which would otherwise be excluded. If "
14639 "the option is used without *--exclude*, only files matched by the pattern "
14643 #. type: Labeled list
14644 #: ../misc-utils/hardlink.1.adoc:66
14646 #| msgid "*-h*, *--help*"
14647 msgid "*-m*, *--maximize*"
14648 msgstr "*-h*, *--help*"
14650 #. type: Plain text
14651 #: ../misc-utils/hardlink.1.adoc:68
14652 msgid "Among equal files, keep the file with the highest link count."
14655 #. type: Labeled list
14656 #: ../misc-utils/hardlink.1.adoc:69
14658 #| msgid "*-V*, *--version*"
14659 msgid "*-M*, *--minimize*"
14660 msgstr "*-V*, *--version*"
14662 #. type: Plain text
14663 #: ../misc-utils/hardlink.1.adoc:71
14664 msgid "Among equal files, keep the file with the lowest link count."
14667 #. type: Labeled list
14668 #: ../misc-utils/hardlink.1.adoc:72 ../sys-utils/rtcwake.8.adoc:93
14670 #| msgid "*-P*, *--pty*"
14671 msgid "*-n*, *--dry-run*"
14672 msgstr "*-P*, *--pty*"
14674 #. type: Plain text
14675 #: ../misc-utils/hardlink.1.adoc:74
14676 msgid "Do not act, just print what would happen."
14679 #. type: Labeled list
14680 #: ../misc-utils/hardlink.1.adoc:75
14682 #| msgid "*-V*, *--version*"
14683 msgid "*-o*, *--ignore-owner*"
14684 msgstr "*-V*, *--version*"
14686 #. type: Plain text
14687 #: ../misc-utils/hardlink.1.adoc:77
14689 "Link and compare files even if their owner information (user and group) "
14690 "differs. Results may be unpredictable."
14693 #. type: Labeled list
14694 #: ../misc-utils/hardlink.1.adoc:78
14696 #| msgid "*-P*, *--pty*"
14697 msgid "*-O*, *--keep-oldest*"
14698 msgstr "*-P*, *--pty*"
14700 #. type: Plain text
14701 #: ../misc-utils/hardlink.1.adoc:80
14703 "Among equal files, keep the oldest file (least recent modification time). By "
14704 "default, the newest file is kept. If *--maximize* or *--minimize* is "
14705 "specified, the link count has a higher precedence than the time of "
14709 #. type: Labeled list
14710 #: ../misc-utils/hardlink.1.adoc:81
14712 msgid "*-p*, *--ignore-mode*"
14715 #. type: Plain text
14716 #: ../misc-utils/hardlink.1.adoc:83
14718 "Link and compare files even if their mode is different. Results may be "
14719 "slightly unpredictable."
14722 #. type: Plain text
14723 #: ../misc-utils/hardlink.1.adoc:86
14724 msgid "Quiet mode, don't print anything."
14727 #. type: Labeled list
14728 #: ../misc-utils/hardlink.1.adoc:87
14730 msgid "*-r*, *--cache-size* _size_"
14733 #. type: Plain text
14734 #: ../misc-utils/hardlink.1.adoc:92
14736 "The size of the cache for content checksums. All non-memcmp methods "
14737 "calculate checksum for each file content block (see *--io-size*), these "
14738 "checksums are cached for the next comparison. The size is important for "
14739 "large files or a large sets of files of the same size. The default is 10MiB."
14742 #. type: Labeled list
14743 #: ../misc-utils/hardlink.1.adoc:93
14745 msgid "*-s*, *--minimum-size* _size_"
14748 #. type: Plain text
14749 #: ../misc-utils/hardlink.1.adoc:95
14751 "The minimum size to consider. By default this is 1, so empty files will not "
14752 "be linked. The _size_ argument may be followed by the multiplicative "
14753 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
14754 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
14758 #. type: Labeled list
14759 #: ../misc-utils/hardlink.1.adoc:96
14761 msgid "*-S*, *--maximum-size* _size_"
14764 #. type: Plain text
14765 #: ../misc-utils/hardlink.1.adoc:98
14767 "The maximum size to consider. By default this is 0 and 0 has the special "
14768 "meaning of unlimited. The _size_ argument may be followed by the "
14769 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
14770 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
14771 "meaning as \"KiB\")."
14774 #. type: Labeled list
14775 #: ../misc-utils/hardlink.1.adoc:99
14777 msgid "*-t*, *--ignore-time*"
14780 #. type: Plain text
14781 #: ../misc-utils/hardlink.1.adoc:101
14783 "Link and compare files even if their time of modification is different. This "
14784 "is usually a good choice."
14787 #. type: Plain text
14788 #: ../misc-utils/hardlink.1.adoc:104
14790 "Verbose output, explain to the user what is being done. If specified once, "
14791 "every hardlinked file is displayed. If specified twice, it also shows every "
14795 #. type: Labeled list
14796 #: ../misc-utils/hardlink.1.adoc:105
14798 msgid "*-x*, *--exclude* _regex_"
14801 #. type: Plain text
14802 #: ../misc-utils/hardlink.1.adoc:107
14804 "A regular expression which excludes files from being compared and linked."
14807 #. type: Labeled list
14808 #: ../misc-utils/hardlink.1.adoc:108
14810 msgid "*-X*, *--respect-xattrs*"
14813 #. type: Plain text
14814 #: ../misc-utils/hardlink.1.adoc:110
14815 msgid "Only try to link files with the same extended attributes."
14818 #. type: Labeled list
14819 #: ../misc-utils/hardlink.1.adoc:111
14821 msgid "*-y*, *--method* _name_"
14824 #. type: Plain text
14825 #: ../misc-utils/hardlink.1.adoc:117
14827 "Set the file content comparison method. The currently supported methods are "
14828 "sha256, sha1, crc32c and memcmp. The default is sha256, or memcmp if Linux "
14829 "Crypto API is not available. The methods based on checksums are implemented "
14830 "in zero-copy way, in this case file contents are not copied to the userspace "
14831 "and all calculation is done in kernel."
14834 #. type: Labeled list
14835 #: ../misc-utils/hardlink.1.adoc:118
14837 msgid "*--reflink*[=_when_]"
14840 #. type: Plain text
14841 #: ../misc-utils/hardlink.1.adoc:123
14843 "Create copy-on-write clones (aka reflinks) rather than hardlinks. The "
14844 "reflinked files share only on-disk data, but the file mode and owner can be "
14845 "different. It's recommended to use it with *--ignore-owner* and *--ignore-"
14846 "mode* options. This option implies *--skip-reflinks* to ignore already "
14850 #. type: Plain text
14851 #: ../misc-utils/hardlink.1.adoc:129
14853 "The optional argument _when_ can be *never*, *always*, or *auto*. If the "
14854 "_when_ argument is omitted, it defaults to *auto*, in this case, *hardlink* "
14855 "checks filesystem type and uses reflinks on BTRFS and XFS only, and fallback "
14856 "to hardlinks when creating reflink is impossible. The argument *always* "
14857 "disables filesystem type detection and fallback to hardlinks, in this case, "
14858 "only reflinks are allowed."
14861 #. type: Labeled list
14862 #: ../misc-utils/hardlink.1.adoc:130
14864 msgid "*--skip-reflinks*"
14867 #. type: Plain text
14868 #: ../misc-utils/hardlink.1.adoc:132
14870 "Ignore already cloned files. This option may be used without *--reflink* "
14871 "when creating classic hardlinks."
14874 #. type: Plain text
14875 #: ../misc-utils/hardlink.1.adoc:137
14877 msgid "*hardlink* takes one or more directories which will be searched for files to be linked.\n"
14880 #. type: Plain text
14881 #: ../misc-utils/hardlink.1.adoc:141
14883 "The original *hardlink* implementation uses the option *-f* to force "
14884 "hardlinks creation between filesystem. This very rarely usable feature is no "
14885 "more supported by the current *hardlink*."
14888 #. type: Plain text
14889 #: ../misc-utils/hardlink.1.adoc:143
14891 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"
14894 #. type: Plain text
14895 #: ../misc-utils/hardlink.1.adoc:147
14897 "There are multiple *hardlink* implementations. The very first implementation "
14898 "is from Jakub Jelinek for Fedora distribution, this implementation has been "
14899 "used in util-linux between versions v2.34 to v2.36. The current "
14900 "implementations is based on Debian version from Julian Andres Klode."
14903 #. Copyright 1994 Salvatore Valente (svalente@mit.edu)
14904 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
14905 #. May be distributed under the GNU General Public License
14907 #: ../misc-utils/kill.1.adoc:7
14912 #. type: Plain text
14913 #: ../misc-utils/kill.1.adoc:17
14914 msgid "kill - terminate a process"
14917 #. type: Plain text
14918 #: ../misc-utils/kill.1.adoc:21
14920 msgid "*kill* [**-**_signal_|*-s* _signal_|*-p*] [*-q* _value_] [*-a*] [*--timeout* _milliseconds_ _signal_] [*--*] _pid_|_name_...\n"
14923 #. type: Plain text
14924 #: ../misc-utils/kill.1.adoc:23
14926 msgid "*kill* *-l* [_number_] | *-L*\n"
14929 #. type: Plain text
14930 #: ../misc-utils/kill.1.adoc:28
14932 "The command *kill* sends the specified _signal_ to the specified processes "
14933 "or process groups."
14936 #. type: Plain text
14937 #: ../misc-utils/kill.1.adoc:30
14939 "If no signal is specified, the *TERM* signal is sent. The default action for "
14940 "this signal is to terminate the process. This signal should be used in "
14941 "preference to the *KILL* signal (number 9), since a process may install a "
14942 "handler for the TERM signal in order to perform clean-up steps before "
14943 "terminating in an orderly fashion. If a process does not terminate after a "
14944 "*TERM* signal has been sent, then the *KILL* signal may be used; be aware "
14945 "that the latter signal cannot be caught, and so does not give the target "
14946 "process the opportunity to perform any clean-up before terminating."
14949 #. type: Plain text
14950 #: ../misc-utils/kill.1.adoc:32
14952 "Most modern shells have a builtin *kill* command, with a usage rather "
14953 "similar to that of the command described here. The *--all*, *--pid*, and *--"
14954 "queue* options, and the possibility to specify processes by command name, "
14955 "are local extensions."
14958 #. type: Plain text
14959 #: ../misc-utils/kill.1.adoc:34
14961 "If _signal_ is 0, then no actual signal is sent, but error checking is still "
14965 #. type: Plain text
14966 #: ../misc-utils/kill.1.adoc:38
14968 "The list of processes to be signaled can be a mixture of names and PIDs."
14971 #. type: Labeled list
14972 #: ../misc-utils/kill.1.adoc:39
14977 #. type: Plain text
14978 #: ../misc-utils/kill.1.adoc:41
14979 msgid "Each _pid_ can be expressed in one of the following ways:"
14982 #. type: Labeled list
14983 #: ../misc-utils/kill.1.adoc:41
14988 #. type: Plain text
14989 #: ../misc-utils/kill.1.adoc:43
14990 msgid "where _n_ is larger than 0. The process with PID _n_ is signaled."
14993 #. type: Plain text
14994 #: ../misc-utils/kill.1.adoc:45
14995 msgid "All processes in the current process group are signaled."
14998 #. type: Plain text
14999 #: ../misc-utils/kill.1.adoc:47
15000 msgid "All processes with a PID larger than 1 are signaled."
15003 #. type: Labeled list
15004 #: ../misc-utils/kill.1.adoc:47
15009 #. type: Plain text
15010 #: ../misc-utils/kill.1.adoc:49
15012 "where _n_ is larger than 1. All processes in process group _n_ are signaled. "
15013 "When an argument of the form '-n' is given, and it is meant to denote a "
15014 "process group, either a signal must be specified first, or the argument must "
15015 "be preceded by a '--' option, otherwise it will be taken as the signal to "
15019 #. type: Labeled list
15020 #: ../misc-utils/kill.1.adoc:50
15025 #. type: Plain text
15026 #: ../misc-utils/kill.1.adoc:52
15027 msgid "All processes invoked using this _name_ will be signaled."
15030 #. type: Labeled list
15031 #: ../misc-utils/kill.1.adoc:55
15033 #| msgid "*-s*, **--shell**=__shell__"
15034 msgid "*-s*, *--signal* _signal_"
15035 msgstr "*-s*, **--shell**=__shell__"
15037 #. type: Plain text
15038 #: ../misc-utils/kill.1.adoc:57
15039 msgid "The signal to send. It may be given as a name or a number."
15042 #. type: Labeled list
15043 #: ../misc-utils/kill.1.adoc:57
15045 msgid "*-l*, *--list* [_number_]"
15048 #. type: Plain text
15049 #: ../misc-utils/kill.1.adoc:59
15051 "Print a list of signal names, or convert the given signal number to a name. "
15052 "The signals can be found in _/usr/include/linux/signal.h_."
15055 #. type: Labeled list
15056 #: ../misc-utils/kill.1.adoc:59
15058 #| msgid "*-P*, *--pty*"
15059 msgid "*-L*, *--table*"
15060 msgstr "*-P*, *--pty*"
15062 #. type: Plain text
15063 #: ../misc-utils/kill.1.adoc:61
15065 "Similar to *-l*, but it will print signal names and their corresponding "
15069 #. type: Plain text
15070 #: ../misc-utils/kill.1.adoc:63
15072 "Do not restrict the command-name-to-PID conversion to processes with the "
15073 "same UID as the present process."
15076 #. type: Labeled list
15077 #: ../misc-utils/kill.1.adoc:63 ../schedutils/chrt.1.adoc:98
15078 #: ../schedutils/taskset.1.adoc:77 ../schedutils/uclampset.1.adoc:78
15079 #: ../sys-utils/ipcs.1.adoc:56 ../sys-utils/prlimit.1.adoc:49
15080 #: ../sys-utils/renice.1.adoc:71
15082 #| msgid "*-P*, *--pty*"
15083 msgid "*-p*, *--pid*"
15084 msgstr "*-P*, *--pty*"
15086 #. type: Plain text
15087 #: ../misc-utils/kill.1.adoc:65
15089 "Only print the process ID (PID) of the named processes, do not send any "
15093 #. type: Labeled list
15094 #: ../misc-utils/kill.1.adoc:65
15096 #| msgid "*-h*, *--help*"
15097 msgid "*-r*, *--require-handler*"
15098 msgstr "*-h*, *--help*"
15100 #. type: Plain text
15101 #: ../misc-utils/kill.1.adoc:67
15103 "Do not send the signal if it is not caught in userspace by the signalled "
15107 #. type: Plain text
15108 #: ../misc-utils/kill.1.adoc:69
15109 msgid "Print PID(s) that will be signaled with *kill* along with the signal."
15112 #. type: Labeled list
15113 #: ../misc-utils/kill.1.adoc:69
15115 msgid "*-q*, *--queue* _value_"
15118 #. type: Plain text
15119 #: ../misc-utils/kill.1.adoc:71
15121 "Send the signal using *sigqueue*(3) rather than *kill*(2). The _value_ "
15122 "argument is an integer that is sent along with the signal. If the receiving "
15123 "process has installed a handler for this signal using the *SA_SIGINFO* flag "
15124 "to *sigaction*(2), then it can obtain this data via the _si_sigval_ field of "
15125 "the _siginfo_t_ structure."
15128 #. type: Labeled list
15129 #: ../misc-utils/kill.1.adoc:71
15131 msgid "*--timeout* _milliseconds signal_"
15134 #. type: Plain text
15135 #: ../misc-utils/kill.1.adoc:73
15137 "Send a signal defined in the usual way to a process, followed by an "
15138 "additional signal after a specified delay. The *--timeout* option causes "
15139 "*kill* to wait for a period defined in _milliseconds_ before sending a "
15140 "follow-up _signal_ to the process. This feature is implemented using the "
15141 "Linux kernel PID file descriptor feature in order to guarantee that the "
15142 "follow-up signal is sent to the same process or not sent if the process no "
15146 #. type: Plain text
15147 #: ../misc-utils/kill.1.adoc:75
15149 "Note that the operating system may re-use PIDs and implementing an "
15150 "equivalent feature in a shell using *kill* and *sleep* would be subject to "
15151 "races whereby the follow-up signal might be sent to a different process that "
15152 "used a recycled PID."
15155 #. type: Plain text
15156 #: ../misc-utils/kill.1.adoc:77
15158 "The *--timeout* option can be specified multiple times: the signals are sent "
15159 "sequentially with the specified timeouts. The *--timeout* option can be "
15160 "combined with the *--queue* option."
15163 #. type: Plain text
15164 #: ../misc-utils/kill.1.adoc:79
15166 "As an example, the following command sends the signals *QUIT*, *TERM* and "
15167 "*KILL* in sequence and waits for 1000 milliseconds between sending the "
15171 #. type: delimited block .
15172 #: ../misc-utils/kill.1.adoc:83
15175 "kill --verbose --timeout 1000 TERM --timeout 1000 KILL \\\n"
15176 " --signal QUIT 12345\n"
15179 #. type: Plain text
15180 #: ../misc-utils/kill.1.adoc:88
15182 msgid "*kill* has the following exit status values:\n"
15185 #. type: Plain text
15186 #: ../misc-utils/kill.1.adoc:93 ../misc-utils/lsblk.8.adoc:190
15187 #: ../sys-utils/chcpu.8.adoc:64 ../sys-utils/chmem.8.adoc:63
15188 #: ../sys-utils/fstrim.8.adoc:80
15192 #. type: Plain text
15193 #: ../misc-utils/kill.1.adoc:95
15194 msgid "partial success (when more than one process specified)"
15197 #. type: Plain text
15198 #: ../misc-utils/kill.1.adoc:99
15200 "Although it is possible to specify the TID (thread ID, see *gettid*(2)) of "
15201 "one of the threads in a multithreaded process as the argument of *kill*, the "
15202 "signal is nevertheless directed to the process (i.e., the entire thread "
15203 "group). In other words, it is not possible to send a signal to an explicitly "
15204 "selected thread in a multithreaded process. The signal will be delivered to "
15205 "an arbitrarily selected thread in the target process that is not blocking "
15206 "the signal. For more details, see *signal*(7) and the description of "
15207 "*CLONE_THREAD* in *clone*(2)."
15210 #. type: Plain text
15211 #: ../misc-utils/kill.1.adoc:101
15213 "Various shells provide a builtin *kill* command that is preferred in "
15214 "relation to the *kill*(1) executable described by this manual. The easiest "
15215 "way to ensure one is executing the command described in this page is to use "
15216 "the full path when calling the command, for example: */bin/kill --version*"
15219 #. type: Plain text
15220 #: ../misc-utils/kill.1.adoc:106
15222 "mailto:svalente@mit.edu[Salvatore Valente], mailto:kzak@redhat.com[Karel Zak]"
15225 #. type: Plain text
15226 #: ../misc-utils/kill.1.adoc:108
15227 msgid "The original version was taken from BSD 4.4."
15230 #. type: Plain text
15231 #: ../misc-utils/kill.1.adoc:117
15236 "*sigaction*(2),\n"
15245 #. Copyright (c) 1983, 1990, 1993
15246 #. The Regents of the University of California. All rights reserved.
15247 #. Redistribution and use in source and binary forms, with or without
15248 #. modification, are permitted provided that the following conditions
15250 #. 1. Redistributions of source code must retain the above copyright
15251 #. notice, this list of conditions and the following disclaimer.
15252 #. 2. Redistributions in binary form must reproduce the above copyright
15253 #. notice, this list of conditions and the following disclaimer in the
15254 #. documentation and/or other materials provided with the distribution.
15255 #. 3. All advertising materials mentioning features or use of this software
15256 #. must display the following acknowledgement:
15257 #. This product includes software developed by the University of
15258 #. California, Berkeley and its contributors.
15259 #. 4. Neither the name of the University nor the names of its contributors
15260 #. may be used to endorse or promote products derived from this software
15261 #. without specific prior written permission.
15262 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
15263 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15264 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15265 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
15266 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
15267 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
15268 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
15269 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
15270 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
15271 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
15273 #. @(#)logger.1 8.1 (Berkeley) 6/6/93
15275 #: ../misc-utils/logger.1.adoc:36
15280 #. type: Plain text
15281 #: ../misc-utils/logger.1.adoc:46
15282 msgid "logger - enter messages into the system log"
15285 #. type: Plain text
15286 #: ../misc-utils/logger.1.adoc:50
15288 msgid "*logger* [options] _message_\n"
15291 #. type: Plain text
15292 #: ../misc-utils/logger.1.adoc:54
15294 msgid "*logger* makes entries in the system log.\n"
15297 #. type: Plain text
15298 #: ../misc-utils/logger.1.adoc:56
15300 "When the optional _message_ argument is present, it is written to the log. "
15301 "If it is not present, and the *-f* option is not given either, then standard "
15305 #. type: Labeled list
15306 #: ../misc-utils/logger.1.adoc:59
15308 #| msgid "*-P*, *--pty*"
15309 msgid "*-d*, *--udp*"
15310 msgstr "*-P*, *--pty*"
15312 #. type: Plain text
15313 #: ../misc-utils/logger.1.adoc:61
15315 "Use datagrams (UDP) only. By default the connection is tried to the syslog "
15316 "port defined in _/etc/services_, which is often 514."
15319 #. type: Plain text
15320 #: ../misc-utils/logger.1.adoc:63 ../misc-utils/logger.1.adoc:174
15321 msgid "See also *--server* and *--socket* to specify where to connect."
15324 #. type: Labeled list
15325 #: ../misc-utils/logger.1.adoc:64
15327 #| msgid "*-P*, *--pty*"
15328 msgid "*-e*, *--skip-empty*"
15329 msgstr "*-P*, *--pty*"
15331 #. type: Plain text
15332 #: ../misc-utils/logger.1.adoc:66
15334 "Ignore empty lines when processing files. An empty line is defined to be a "
15335 "line without any characters. Thus a line consisting only of whitespace is "
15336 "NOT considered empty. Note that when the *--prio-prefix* option is "
15337 "specified, the priority is not part of the line. Thus an empty line in this "
15338 "mode is a line that does not have any characters after the priority prefix "
15342 #. type: Plain text
15343 #: ../misc-utils/logger.1.adoc:69
15345 "Log the contents of the specified _file_. This option cannot be combined "
15346 "with a command-line message."
15349 #. type: Labeled list
15350 #: ../misc-utils/logger.1.adoc:70
15355 #. type: Plain text
15356 #: ../misc-utils/logger.1.adoc:72
15357 msgid "Log the PID of the *logger* process with each line."
15360 #. type: Labeled list
15361 #: ../misc-utils/logger.1.adoc:73
15363 msgid "*--id*[**=**__id__]"
15366 #. type: Plain text
15367 #: ../misc-utils/logger.1.adoc:75
15369 "Log the PID of the *logger* process with each line. When the optional "
15370 "argument _id_ is specified, then it is used instead of the *logger* "
15371 "command's PID. The use of *--id=$$* (PPID) is recommended in scripts that "
15372 "send several messages."
15375 #. type: Plain text
15376 #: ../misc-utils/logger.1.adoc:77
15378 "Note that the system logging infrastructure (for example *systemd* when "
15379 "listening on _/dev/log_) may follow local socket credentials to overwrite "
15380 "the PID specified in the message. *logger*(1) is able to set those socket "
15381 "credentials to the given _id_, but only if you have root permissions and a "
15382 "process with the specified PID exists, otherwise the socket credentials are "
15383 "not modified and the problem is silently ignored."
15386 #. type: Labeled list
15387 #: ../misc-utils/logger.1.adoc:78
15389 msgid "*--journald*[**=**__file__]"
15392 #. type: Plain text
15393 #: ../misc-utils/logger.1.adoc:80
15395 "Write a *systemd* journal entry. The entry is read from the given _file_, "
15396 "when specified, otherwise from standard input. Each line must begin with a "
15397 "field that is accepted by *journald*; see *systemd.journal-fields*(7) for "
15398 "details. The use of a MESSAGE_ID field is generally a good idea, as it makes "
15399 "finding entries easy. Examples:"
15402 #. type: delimited block _
15403 #: ../misc-utils/logger.1.adoc:88
15406 " logger --journald <<end\n"
15407 " MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309\n"
15408 " MESSAGE=The dogs bark, but the caravan goes on.\n"
15410 " CARAVAN=goes on\n"
15414 #. type: delimited block _
15415 #: ../misc-utils/logger.1.adoc:90
15417 msgid " logger --journald=entry.txt\n"
15420 #. type: Plain text
15421 #: ../misc-utils/logger.1.adoc:93
15423 "Notice that *--journald* will ignore values of other options, such as "
15424 "priority. If priority is needed it must be within input, and use PRIORITY "
15425 "field. The simple execution of *journalctl*(1) will display MESSAGE field. "
15426 "Use *journalctl --output json-pretty* to see rest of the fields."
15429 #. type: Plain text
15430 #: ../misc-utils/logger.1.adoc:95
15432 "To include newlines in MESSAGE, specify MESSAGE several times. This is "
15433 "handled as a special case, other fields will be stored as an array in the "
15434 "journal if they appear multiple times."
15437 #. type: Labeled list
15438 #: ../misc-utils/logger.1.adoc:96
15440 msgid "*--msgid* _msgid_"
15443 #. type: Plain text
15444 #: ../misc-utils/logger.1.adoc:98
15446 "Sets the link:https://tools.ietf.org/html/rfc5424[RFC 5424] MSGID field. "
15447 "Note that the space character is not permitted inside of _msgid_. This "
15448 "option is only used if *--rfc5424* is specified as well; otherwise, it is "
15449 "silently ignored."
15452 #. type: Labeled list
15453 #: ../misc-utils/logger.1.adoc:99
15455 msgid "*-n*, *--server* _server_"
15458 #. type: Plain text
15459 #: ../misc-utils/logger.1.adoc:101
15461 "Write to the specified remote syslog _server_ instead of to the system log "
15462 "socket. Unless *--udp* or *--tcp* is specified, *logger* will first try to "
15463 "use UDP, but if this fails a TCP connection is attempted."
15466 #. type: Labeled list
15467 #: ../misc-utils/logger.1.adoc:102
15472 #. type: Plain text
15473 #: ../misc-utils/logger.1.adoc:104
15475 "Causes everything to be done except for writing the log message to the "
15476 "system log, and removing the connection to the journal. This option can be "
15477 "used together with *--stderr* for testing purposes."
15480 #. type: Labeled list
15481 #: ../misc-utils/logger.1.adoc:105
15483 msgid "*--octet-count*"
15486 #. type: Plain text
15487 #: ../misc-utils/logger.1.adoc:107
15489 "Use the link:https://tools.ietf.org/html/rfc6587[RFC 6587] octet counting "
15490 "framing method for sending messages. When this option is not used, the "
15491 "default is no framing on UDP, and RFC6587 non-transparent framing (also "
15492 "known as octet stuffing) on TCP."
15495 #. type: Labeled list
15496 #: ../misc-utils/logger.1.adoc:108
15498 #| msgid "*-P*, *--pty*"
15499 msgid "*-P*, *--port* _port_"
15500 msgstr "*-P*, *--pty*"
15502 #. type: Plain text
15503 #: ../misc-utils/logger.1.adoc:110
15505 "Use the specified _port_. When this option is not specified, the port "
15506 "defaults to *syslog* for udp and to *syslog-conn* for tcp connections."
15509 #. type: Labeled list
15510 #: ../misc-utils/logger.1.adoc:111 ../sys-utils/swapon.8.adoc:65
15512 msgid "*-p*, *--priority* _priority_"
15515 #. type: Plain text
15516 #: ../misc-utils/logger.1.adoc:113
15518 "Enter the message into the log with the specified _priority_. The priority "
15519 "may be specified numerically or as a _facility_._level_ pair. For example, *-"
15520 "p local3.info* logs the message as informational in the local3 facility. The "
15521 "default is *user.notice*."
15524 #. type: Labeled list
15525 #: ../misc-utils/logger.1.adoc:114
15527 msgid "*--prio-prefix*"
15530 #. type: Plain text
15531 #: ../misc-utils/logger.1.adoc:116
15533 "Look for a syslog prefix on every line read from standard input. This prefix "
15534 "is a decimal number within angle brackets that encodes both the facility and "
15535 "the level. The number is constructed by multiplying the facility by 8 and "
15536 "then adding the level. For example, *local0.info*, meaning facility=16 and "
15537 "level=6, becomes *<134>*."
15540 #. type: Plain text
15541 #: ../misc-utils/logger.1.adoc:118
15543 "If the prefix contains no facility, the facility defaults to what is "
15544 "specified by the *-p* option. Similarly, if no prefix is provided, the line "
15545 "is logged using the _priority_ given with *-p*."
15548 #. type: Plain text
15549 #: ../misc-utils/logger.1.adoc:120
15550 msgid "This option doesn't affect a command-line message."
15553 #. type: Labeled list
15554 #: ../misc-utils/logger.1.adoc:121
15556 msgid "*--rfc3164*"
15559 #. type: Plain text
15560 #: ../misc-utils/logger.1.adoc:123
15562 "Use the link:https://tools.ietf.org/html/rfc3164[RFC 3164] BSD syslog "
15563 "protocol to submit messages to a remote server."
15566 #. type: Labeled list
15567 #: ../misc-utils/logger.1.adoc:124
15569 msgid "*--rfc5424*[**=**__without__]"
15572 #. type: Plain text
15573 #: ../misc-utils/logger.1.adoc:126
15575 "Use the link:https://tools.ietf.org/html/rfc5424[RFC 5424] syslog protocol "
15576 "to submit messages to a remote server. The optional _without_ argument can "
15577 "be a comma-separated list of the following values: *notq*, *notime*, "
15581 #. type: Plain text
15582 #: ../misc-utils/logger.1.adoc:128
15584 "The *notq* value suppresses the time-quality structured data from the "
15585 "submitted message. The time-quality information shows whether the local "
15586 "clock was synchronized plus the maximum number of microseconds the timestamp "
15587 "might be off. The time quality is also automatically suppressed when *--sd-"
15588 "id timeQuality* is specified."
15591 #. type: Plain text
15592 #: ../misc-utils/logger.1.adoc:130
15594 "The *notime* value (which implies *notq*) suppresses the complete sender "
15595 "timestamp that is in ISO-8601 format, including microseconds and timezone."
15598 #. type: Plain text
15599 #: ../misc-utils/logger.1.adoc:132
15601 "The *nohost* value suppresses *gethostname*(2) information from the message "
15605 #. type: Plain text
15606 #: ../misc-utils/logger.1.adoc:134
15608 "The RFC 5424 protocol has been the default for *logger* since version 2.26."
15611 #. type: Labeled list
15612 #: ../misc-utils/logger.1.adoc:135
15614 #| msgid "*-f*, *--fast*"
15615 msgid "*-s*, *--stderr*"
15616 msgstr "*-f*, *--fast*"
15618 #. type: Plain text
15619 #: ../misc-utils/logger.1.adoc:137
15620 msgid "Output the message to standard error as well as to the system log."
15623 #. type: Labeled list
15624 #: ../misc-utils/logger.1.adoc:138
15626 msgid "*--sd-id* _name_[**@**__digits__]"
15629 #. type: Plain text
15630 #: ../misc-utils/logger.1.adoc:140
15632 "Specifies a structured data element ID for an RFC 5424 message header. The "
15633 "option has to be used before *--sd-param* to introduce a new element. The "
15634 "number of structured data elements is unlimited. The ID (_name_ plus "
15635 "possibly **@**__digits__) is case-sensitive and uniquely identifies the type "
15636 "and purpose of the element. The same ID must not exist more than once in a "
15637 "message. The **@**__digits__ part is required for user-defined non-"
15638 "standardized IDs."
15641 #. type: Plain text
15642 #: ../misc-utils/logger.1.adoc:142
15644 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"
15647 #. type: Labeled list
15648 #: ../misc-utils/logger.1.adoc:143
15650 msgid "*--sd-param* _name_=_value_"
15653 #. type: Plain text
15654 #: ../misc-utils/logger.1.adoc:145
15656 "Specifies a structured data element parameter, a name and value pair. The "
15657 "option has to be used after *--sd-id* and may be specified more than once "
15658 "for the same element. Note that the quotation marks around _value_ are "
15659 "required and must be escaped on the command line."
15662 #. type: delimited block .
15663 #: ../misc-utils/logger.1.adoc:153
15666 " logger --rfc5424 --sd-id zoo@123 \\\n"
15667 " --sd-param tiger=\"hungry\" \\\n"
15668 " --sd-param zebra=\"running\" \\\n"
15669 " --sd-id manager@123 \\\n"
15670 " --sd-param onMeeting=\"yes\" \\\n"
15671 " \"this is message\"\n"
15674 #. type: Plain text
15675 #: ../misc-utils/logger.1.adoc:155
15679 #. type: Plain text
15680 #: ../misc-utils/logger.1.adoc:157
15682 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"
15685 #. type: Plain text
15686 #: ../misc-utils/logger.1.adoc:160
15688 "Sets the maximum permitted message size to _size_. The default is 1KiB "
15689 "characters, which is the limit traditionally used and specified in RFC 3164. "
15690 "With RFC 5424, this limit has become flexible. A good assumption is that RFC "
15691 "5424 receivers can at least process 4KiB messages."
15694 #. type: Plain text
15695 #: ../misc-utils/logger.1.adoc:162
15697 "Most receivers accept messages larger than 1KiB over any type of syslog "
15698 "protocol. As such, the *--size* option affects *logger* in all cases (not "
15699 "only when *--rfc5424* was used)."
15702 #. type: Plain text
15703 #: ../misc-utils/logger.1.adoc:164
15705 "Note: the message-size limit limits the overall message size, including the "
15706 "syslog header. Header sizes vary depending on the selected options and the "
15707 "hostname length. As a rule of thumb, headers are usually not longer than 50 "
15708 "to 80 characters. When selecting a maximum message size, it is important to "
15709 "ensure that the receiver supports the max size as well, otherwise messages "
15710 "may become truncated. Again, as a rule of thumb two to four KiB message size "
15711 "should generally be OK, whereas anything larger should be verified to work."
15714 #. type: Labeled list
15715 #: ../misc-utils/logger.1.adoc:165
15717 msgid "*--socket-errors*[**=**__mode__]"
15720 #. type: Plain text
15721 #: ../misc-utils/logger.1.adoc:167
15723 "Print errors about Unix socket connections. The _mode_ can be a value of "
15724 "*off*, *on*, or *auto*. When the mode is *auto*, then *logger* will detect "
15725 "if the init process is *systemd*(1), and if so assumption is made _/dev/log_ "
15726 "can be used early at boot. Other init systems lack of _/dev/log_ will not "
15727 "cause errors that is identical with messaging using *openlog*(3) system "
15728 "call. The *logger*(1) before version 2.26 used *openlog*(3), and hence was "
15729 "unable to detected loss of messages sent to Unix sockets."
15732 #. type: Plain text
15733 #: ../misc-utils/logger.1.adoc:169
15735 "The default mode is *auto*. When errors are not enabled lost messages are "
15736 "not communicated and will result to successful exit status of *logger*(1) "
15740 #. type: Labeled list
15741 #: ../misc-utils/logger.1.adoc:170
15743 #| msgid "*-P*, *--pty*"
15744 msgid "*-T*, *--tcp*"
15745 msgstr "*-P*, *--pty*"
15747 #. type: Plain text
15748 #: ../misc-utils/logger.1.adoc:172
15750 "Use stream (TCP) only. By default the connection is tried to the _syslog-"
15751 "conn_ port defined in _/etc/services_, which is often _601_."
15754 #. type: Labeled list
15755 #: ../misc-utils/logger.1.adoc:175
15757 #| msgid "*-P*, *--pty*"
15758 msgid "*-t*, *--tag* _tag_"
15759 msgstr "*-P*, *--pty*"
15761 #. type: Plain text
15762 #: ../misc-utils/logger.1.adoc:177
15764 "Mark every line to be logged with the specified _tag_. The default tag is "
15765 "the name of the user logged in on the terminal (or a user name based on "
15766 "effective user ID)."
15769 #. type: Labeled list
15770 #: ../misc-utils/logger.1.adoc:178
15772 msgid "*-u*, *--socket* _socket_"
15775 #. type: Plain text
15776 #: ../misc-utils/logger.1.adoc:180
15777 msgid "Write to the specified _socket_ instead of to the system log socket."
15780 #. type: Labeled list
15781 #: ../misc-utils/logger.1.adoc:181
15786 #. type: Plain text
15787 #: ../misc-utils/logger.1.adoc:183
15789 "End the argument list. This allows the _message_ to start with a hyphen (-)."
15792 #. type: Plain text
15793 #: ../misc-utils/logger.1.adoc:189
15794 msgid "The *logger* utility exits 0 on success, and >0 if an error occurs."
15798 #: ../misc-utils/logger.1.adoc:190
15800 msgid "FACILITIES AND LEVELS"
15803 #. type: Plain text
15804 #: ../misc-utils/logger.1.adoc:193
15805 msgid "Valid facility names are:"
15808 #. type: Plain text
15809 #: ../misc-utils/logger.1.adoc:197
15813 "*authpriv* for security information of a sensitive nature +\n"
15817 #. type: Plain text
15818 #: ../misc-utils/logger.1.adoc:201
15823 "*kern* cannot be generated from userspace process, automatically converted to *user* +\n"
15826 #. type: Plain text
15827 #: ../misc-utils/logger.1.adoc:212
15839 "*security* deprecated synonym for *auth*\n"
15842 #. type: Plain text
15843 #: ../misc-utils/logger.1.adoc:214
15844 msgid "Valid level names are:"
15847 #. type: Plain text
15848 #: ../misc-utils/logger.1.adoc:226
15859 "*panic* deprecated synonym for *emerg* +\n"
15860 "*error* deprecated synonym for *err* +\n"
15861 "*warn* deprecated synonym for *warning* +\n"
15864 #. type: Plain text
15865 #: ../misc-utils/logger.1.adoc:228
15867 "For the priority order and intended purposes of these facilities and levels, "
15871 #. type: Plain text
15872 #: ../misc-utils/logger.1.adoc:232
15874 "The *logger* command is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
15878 #. type: delimited block _
15879 #: ../misc-utils/logger.1.adoc:236
15880 msgid "logger System rebooted"
15883 #. type: delimited block _
15884 #: ../misc-utils/logger.1.adoc:238
15885 msgid "logger -p local0.notice -t HOSTIDM -f /dev/idmc"
15888 #. type: delimited block _
15889 #: ../misc-utils/logger.1.adoc:240
15890 msgid "logger -n loghost.example.com System rebooted"
15893 #. type: Plain text
15894 #: ../misc-utils/logger.1.adoc:245
15896 "The *logger* command was originally written by University of California in "
15897 "1983-1993 and later rewritten by mailto:kzak@redhat.com[Karel Zak], mailto:"
15898 "rgerhards@adiscon.com[Rainer Gerhards], and mailto:kerolasa@iki.fi[Sami "
15902 #. type: Plain text
15903 #: ../misc-utils/logger.1.adoc:251
15906 "*journalctl*(1),\n"
15908 "*systemd.journal-fields*(7)\n"
15914 #. Copyright (c) 1990, 1993
15915 #. The Regents of the University of California. All rights reserved.
15916 #. Redistribution and use in source and binary forms, with or without
15917 #. modification, are permitted provided that the following conditions
15919 #. 1. Redistributions of source code must retain the above copyright
15920 #. notice, this list of conditions and the following disclaimer.
15921 #. 2. Redistributions in binary form must reproduce the above copyright
15922 #. notice, this list of conditions and the following disclaimer in the
15923 #. documentation and/or other materials provided with the distribution.
15924 #. 3. All advertising materials mentioning features or use of this software
15925 #. must display the following acknowledgement:
15926 #. This product includes software developed by the University of
15927 #. California, Berkeley and its contributors.
15928 #. 4. Neither the name of the University nor the names of its contributors
15929 #. may be used to endorse or promote products derived from this software
15930 #. without specific prior written permission.
15931 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
15932 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15933 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15934 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
15935 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
15936 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
15937 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
15938 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
15939 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
15940 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
15942 #. @(#)look.1 8.1 (Berkeley) 6/14/93
15944 #: ../misc-utils/look.1.adoc:36
15949 #. type: Plain text
15950 #: ../misc-utils/look.1.adoc:46
15951 msgid "look - display lines beginning with a given string"
15954 #. type: Plain text
15955 #: ../misc-utils/look.1.adoc:50
15957 msgid "*look* [options] _string_ [_file_]\n"
15960 #. type: Plain text
15961 #: ../misc-utils/look.1.adoc:54
15963 "The *look* utility displays any lines in _file_ which contain _string_ as a "
15964 "prefix. As *look* performs a binary search, the lines in _file_ must be "
15965 "sorted (where *sort*(1) was given the same options *-d* and/or *-f* that "
15966 "*look* is invoked with)."
15969 #. type: Plain text
15970 #: ../misc-utils/look.1.adoc:56
15972 "If _file_ is not specified, the file _/usr/share/dict/words_ is used, only "
15973 "alphanumeric characters are compared and the case of alphabetic characters "
15977 #. type: Plain text
15978 #: ../misc-utils/look.1.adoc:61
15979 msgid "Use the alternative dictionary file."
15982 #. type: Labeled list
15983 #: ../misc-utils/look.1.adoc:62
15985 #| msgid "*-h*, *--help*"
15986 msgid "*-d*, *--alphanum*"
15987 msgstr "*-h*, *--help*"
15989 #. type: Plain text
15990 #: ../misc-utils/look.1.adoc:64
15992 "Use normal dictionary character set and order, i.e., only blanks and "
15993 "alphanumeric characters are compared. This is on by default if no file is "
15997 #. type: Plain text
15998 #: ../misc-utils/look.1.adoc:66
16000 "Note that blanks have been added to dictionary character set for "
16001 "compatibility with *sort -d* command since version 2.28."
16004 #. type: Labeled list
16005 #: ../misc-utils/look.1.adoc:67
16007 #| msgid "*-f*, *--fast*"
16008 msgid "*-f*, *--ignore-case*"
16009 msgstr "*-f*, *--fast*"
16011 #. type: Plain text
16012 #: ../misc-utils/look.1.adoc:69
16014 "Ignore the case of alphabetic characters. This is on by default if no file "
16018 #. type: Labeled list
16019 #: ../misc-utils/look.1.adoc:70
16021 msgid "*-t*, *--terminate* _character_"
16024 #. type: Plain text
16025 #: ../misc-utils/look.1.adoc:72
16027 "Specify a string termination character, i.e., only the characters in "
16028 "_string_ up to and including the first occurrence of _character_ are "
16032 #. type: Plain text
16033 #: ../misc-utils/look.1.adoc:76
16035 "The *look* utility exits 0 if one or more lines were found and displayed, 1 "
16036 "if no lines were found, and >1 if an error occurred."
16039 #. type: Labeled list
16040 #: ../misc-utils/look.1.adoc:79
16045 #. type: Plain text
16046 #: ../misc-utils/look.1.adoc:81
16048 "Path to a dictionary file. The environment variable has greater priority "
16049 "than the dictionary path defined in the *FILES* segment."
16052 #. type: Labeled list
16053 #: ../misc-utils/look.1.adoc:84
16055 msgid "_/usr/share/dict/words_"
16058 #. type: Plain text
16059 #: ../misc-utils/look.1.adoc:86
16060 msgid "the dictionary"
16063 #. type: Labeled list
16064 #: ../misc-utils/look.1.adoc:87
16066 msgid "_/usr/share/dict/web2_"
16069 #. type: Plain text
16070 #: ../misc-utils/look.1.adoc:89
16071 msgid "the alternative dictionary"
16074 #. type: Plain text
16075 #: ../misc-utils/look.1.adoc:93
16077 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
16078 msgid "The *look* utility appeared in Version 7 AT&T Unix."
16079 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
16081 #. type: delimited block .
16082 #: ../misc-utils/look.1.adoc:99
16085 "sort -d /etc/passwd -o /tmp/look.dict\n"
16086 "look -t: root:foobar /tmp/look.dict\n"
16089 #. type: Plain text
16090 #: ../misc-utils/look.1.adoc:105
16098 #: ../misc-utils/lsblk.8.adoc:2
16103 #. type: Plain text
16104 #: ../misc-utils/lsblk.8.adoc:12
16105 msgid "lsblk - list block devices"
16108 #. type: Plain text
16109 #: ../misc-utils/lsblk.8.adoc:16
16111 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
16112 msgid "*lsblk* [options] [_device_...]\n"
16113 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
16115 #. type: Plain text
16116 #: ../misc-utils/lsblk.8.adoc:20
16118 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"
16121 #. type: Plain text
16122 #: ../misc-utils/lsblk.8.adoc:22
16124 "By default, the command prints all block devices (except RAM disks) in a "
16125 "tree-like format. The same device can be repeated in the tree if it relates "
16126 "to other devices. The *--merge* option is recommended for more complicated "
16127 "setups to gather groups of devices and describe complex N:M relationships."
16130 #. type: Plain text
16131 #: ../misc-utils/lsblk.8.adoc:24
16133 "The tree-like output (or *children[]* array in the JSON output) is enabled "
16134 "only if NAME column it present in the output or when *--tree* command line "
16135 "option is used. See also *--nodeps* and *--list* to control the tree "
16139 #. type: Plain text
16140 #: ../misc-utils/lsblk.8.adoc:26
16142 "The default output, as well as the default output from options like *--fs* "
16143 "and *--topology*, is subject to change. So whenever possible, you should "
16144 "avoid using default outputs in your scripts. Always explicitly define "
16145 "expected columns by using *--output* _columns-list_ and *--list* in "
16146 "environments where a stable output is required."
16149 #. type: Plain text
16150 #: ../misc-utils/lsblk.8.adoc:28
16151 msgid "Use *lsblk --list-columns* to get a list of all available columns."
16154 #. type: Plain text
16155 #: ../misc-utils/lsblk.8.adoc:30
16157 "Note that *lsblk* might be executed in time when *udev* does not have all "
16158 "information about recently added or modified devices yet. In this case it is "
16159 "recommended to use *udevadm settle* before *lsblk* to synchronize with udev."
16162 #. type: Plain text
16163 #: ../misc-utils/lsblk.8.adoc:32
16165 "The relationship between block devices and filesystems is not always one-to-"
16166 "one. The filesystem may use more block devices, or the same filesystem may "
16167 "be accessible by more paths. This is the reason why *lsblk* provides "
16168 "MOUNTPOINT and MOUNTPOINTS (pl.) columns. The column MOUNTPOINT displays "
16169 "only one mount point (usually the last mounted instance of the filesystem), "
16170 "and the column MOUNTPOINTS displays by multi-line cell all mount points "
16171 "associated with the device."
16174 #. type: Labeled list
16175 #: ../misc-utils/lsblk.8.adoc:35
16177 #| msgid "*-P*, *--pty*"
16178 msgid "*-A*, *--noempty*"
16179 msgstr "*-P*, *--pty*"
16181 #. type: Plain text
16182 #: ../misc-utils/lsblk.8.adoc:37
16183 msgid "Don't print empty devices."
16186 #. type: Plain text
16187 #: ../misc-utils/lsblk.8.adoc:40
16189 "Disable all built-in filters and list all empty devices and RAM disk devices "
16193 #. type: Labeled list
16194 #: ../misc-utils/lsblk.8.adoc:47
16196 #| msgid "*-f*, *--fast*"
16197 msgid "*-D*, *--discard*"
16198 msgstr "*-f*, *--fast*"
16200 #. type: Plain text
16201 #: ../misc-utils/lsblk.8.adoc:49
16203 "Print information about the discarding capabilities (TRIM, UNMAP) for each "
16207 #. type: Labeled list
16208 #: ../misc-utils/lsblk.8.adoc:50
16210 #| msgid "*-h*, *--help*"
16211 msgid "*-d*, *--nodeps*"
16212 msgstr "*-h*, *--help*"
16214 #. type: Plain text
16215 #: ../misc-utils/lsblk.8.adoc:52
16217 "Do not print holder devices or slaves. For example, *lsblk --nodeps /dev/"
16218 "sda* prints information about the sda device only."
16221 #. type: Labeled list
16222 #: ../misc-utils/lsblk.8.adoc:53
16224 msgid "*-E*, *--dedup* _column_"
16227 #. type: Plain text
16228 #: ../misc-utils/lsblk.8.adoc:55
16230 "Use _column_ as a de-duplication key to de-duplicate output tree. If the key "
16231 "is not available for the device, or the device is a partition and parental "
16232 "whole-disk device provides the same key than the device is always printed."
16235 #. type: Plain text
16236 #: ../misc-utils/lsblk.8.adoc:57
16238 "The usual use case is to de-duplicate output on system multi-path devices, "
16239 "for example by *-E WWN*."
16242 #. type: Labeled list
16243 #: ../misc-utils/lsblk.8.adoc:58
16245 msgid "*-e*, *--exclude* _list_"
16248 #. type: Plain text
16249 #: ../misc-utils/lsblk.8.adoc:60
16251 "Exclude the devices specified by the comma-separated _list_ of major device "
16252 "numbers. Note that RAM disks (major=1) are excluded by default if *--all* is "
16253 "not specified. The filter is applied to the top-level devices only. This may "
16254 "be confusing for *--list* output format where hierarchy of the devices is "
16258 #. type: Labeled list
16259 #: ../misc-utils/lsblk.8.adoc:61
16261 #| msgid "*-f*, *--fast*"
16262 msgid "*-f*, *--fs*"
16263 msgstr "*-f*, *--fast*"
16265 #. type: Plain text
16266 #: ../misc-utils/lsblk.8.adoc:63
16268 "Output info about filesystems. This option is equivalent to *-o NAME,FSTYPE,"
16269 "FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS*. The authoritative information "
16270 "about filesystems and raids is provided by the *blkid*(8) command."
16273 #. type: Labeled list
16274 #: ../misc-utils/lsblk.8.adoc:64
16276 msgid "*-I*, *--include* _list_"
16279 #. type: Plain text
16280 #: ../misc-utils/lsblk.8.adoc:66
16282 "Include devices specified by the comma-separated _list_ of major device "
16283 "numbers. The filter is applied to the top-level devices only. This may be "
16284 "confusing for *--list* output format where hierarchy of the devices is not "
16288 #. type: Labeled list
16289 #: ../misc-utils/lsblk.8.adoc:67
16291 #| msgid "*-f*, *--fast*"
16292 msgid "*-i*, *--ascii*"
16293 msgstr "*-f*, *--fast*"
16295 #. type: Plain text
16296 #: ../misc-utils/lsblk.8.adoc:69
16297 msgid "Use ASCII characters for tree formatting."
16300 #. type: Plain text
16301 #: ../misc-utils/lsblk.8.adoc:72
16303 "Use JSON output format. It's strongly recommended to use *--output* and also "
16304 "*--tree* if necessary. Note that *children[]* is used only if NAME column or "
16305 "*--tree* is used."
16308 #. type: Plain text
16309 #: ../misc-utils/lsblk.8.adoc:75
16311 "Produce output in the form of a list. The output does not provide "
16312 "information about relationships between devices and since version 2.34 every "
16313 "device is printed only once if *--pairs* or *--raw* not specified (the "
16314 "parsable outputs are maintained in backwardly compatible way)."
16317 #. type: Labeled list
16318 #: ../misc-utils/lsblk.8.adoc:76
16320 #| msgid "*-h*, *--help*"
16321 msgid "*-M*, *--merge*"
16322 msgstr "*-h*, *--help*"
16324 #. type: Plain text
16325 #: ../misc-utils/lsblk.8.adoc:78
16327 "Group parents of sub-trees to provide more readable output for RAIDs and "
16328 "Multi-path devices. The tree-like output is required."
16331 #. type: Labeled list
16332 #: ../misc-utils/lsblk.8.adoc:79
16334 #| msgid "*-V*, *--version*"
16335 msgid "*-m*, *--perms*"
16336 msgstr "*-V*, *--version*"
16338 #. type: Plain text
16339 #: ../misc-utils/lsblk.8.adoc:81
16341 "Output info about device owner, group and mode. This option is equivalent to "
16342 "*-o NAME,SIZE,OWNER,GROUP,MODE*."
16345 #. type: Labeled list
16346 #: ../misc-utils/lsblk.8.adoc:82
16348 #| msgid "*-h*, *--help*"
16349 msgid "*-N*, *--nvme*"
16350 msgstr "*-h*, *--help*"
16352 #. type: Plain text
16353 #: ../misc-utils/lsblk.8.adoc:84
16354 msgid "Output info about NVMe devices only."
16357 #. type: Labeled list
16358 #: ../misc-utils/lsblk.8.adoc:85
16360 #| msgid "*-V*, *--version*"
16361 msgid "*-v*, *--virtio*"
16362 msgstr "*-V*, *--version*"
16364 #. type: Plain text
16365 #: ../misc-utils/lsblk.8.adoc:87
16366 msgid "Output info about virtio devices only."
16369 #. type: Plain text
16370 #: ../misc-utils/lsblk.8.adoc:93
16372 "Specify which output columns to print. Use *--list-columns* to get a list of "
16373 "all supported columns. The columns may affect tree-like output. The default "
16374 "is to use tree for the column 'NAME' (see also *--tree*)."
16377 #. type: Plain text
16378 #: ../misc-utils/lsblk.8.adoc:95
16380 "The default list of columns may be extended if _list_ is specified in the "
16381 "format _+list_ (e.g., *lsblk -o +UUID*)."
16384 #. type: Labeled list
16385 #: ../misc-utils/lsblk.8.adoc:96
16387 #| msgid "*-P*, *--pty*"
16388 msgid "*-O*, *--output-all*"
16389 msgstr "*-P*, *--pty*"
16391 #. type: Plain text
16392 #: ../misc-utils/lsblk.8.adoc:101
16394 "Produce output in the form of key=\"value\" pairs. The output lines are "
16395 "still ordered by dependencies. All potentially unsafe value characters are "
16396 "hex-escaped (\\x<code>). See also option *--shell*."
16399 #. type: Labeled list
16400 #: ../misc-utils/lsblk.8.adoc:102
16402 #| msgid "*-P*, *--pty*"
16403 msgid "*-p*, *--paths*"
16404 msgstr "*-P*, *--pty*"
16406 #. type: Plain text
16407 #: ../misc-utils/lsblk.8.adoc:104
16408 msgid "Print full device paths."
16411 #. type: Labeled list
16412 #: ../misc-utils/lsblk.8.adoc:105 ../misc-utils/lsfd.1.adoc:76
16414 msgid "*-Q*, *--filter* _expr_"
16417 #. type: Plain text
16418 #: ../misc-utils/lsblk.8.adoc:111
16420 "Print only the devices that meet the conditions specified by the expr. The "
16421 "filter is assessed prior to lsblk collecting data for all output columns. "
16422 "Only the necessary data for the lazy evaluation of the expression is "
16423 "retrieved from the system. This approach can enhance performance when "
16424 "compared to post-filtering, as commonly done by tools such as grep(1)."
16427 #. type: Plain text
16428 #: ../misc-utils/lsblk.8.adoc:115
16430 "This feature is EXPERIMENTAL. See also *scols-filter*(5). For example "
16431 "exclude sda and sdb, but print everything else ('!~' is a negative regular "
16432 "expression matching operator):"
16435 #. type: delimited block _
16436 #: ../misc-utils/lsblk.8.adoc:117
16438 msgid " lsblk --filter 'NAME !~ \"sd[ab]\"'\n"
16441 #. type: Labeled list
16442 #: ../misc-utils/lsblk.8.adoc:119
16444 msgid "*--highlight* _expr_"
16447 #. type: Plain text
16448 #: ../misc-utils/lsblk.8.adoc:122
16450 "Colorize lines matching the expression. This feature is EXPERIMENTAL. See "
16451 "also *scols-filter*(5)."
16454 #. type: Labeled list
16455 #: ../misc-utils/lsblk.8.adoc:123
16457 msgid "*--ct* _name_ [: _param_ [: _function_ ]]"
16460 #. type: Plain text
16461 #: ../misc-utils/lsblk.8.adoc:129
16463 "Define a custom counter. The counters are printed after the standard "
16464 "output. The _name_ is the custom name of the counter, the optional _param_ "
16465 "is the name of the column to be used for the counter, and the optional "
16466 "_function_ specifies the aggregation function, supported functions are: "
16467 "count, min, max, or sum. The default is count."
16470 #. type: Plain text
16471 #: ../misc-utils/lsblk.8.adoc:132
16473 "If the _param_ is not specified, then the counter counts the number of "
16474 "lines. This feature is EXPERIMENTAL. See also *--ct-filter*."
16477 #. type: Plain text
16478 #: ../misc-utils/lsblk.8.adoc:135
16480 "For example, *--ct MyCounter:SIZE:sum* will count the summary for SIZE from "
16481 "all lines; and to count the number of SATA disks, it is possible to use:"
16484 #. type: delimited block _
16485 #: ../misc-utils/lsblk.8.adoc:138
16487 msgid " lsblk --ct-filter 'TYPE==\"disk\" && TRAN==\"sata\"' --ct \"Number of SATA devices\"\n"
16490 #. type: Labeled list
16491 #: ../misc-utils/lsblk.8.adoc:141
16493 #| msgid "*-f*, *--fast*"
16494 msgid "*--ct-filter* _expr_"
16495 msgstr "*-f*, *--fast*"
16497 #. type: Plain text
16498 #: ../misc-utils/lsblk.8.adoc:144
16500 "Define a restriction for the next counter. This feature is EXPERIMENTAL. See "
16501 "also *--ct* and *scols-filter*(5). For example, aggregate sizes by device "
16505 #. type: delimited block _
16506 #: ../misc-utils/lsblk.8.adoc:147
16509 " lsblk --ct-filter 'TYPE==\"part\"' --ct Partitions:SIZE:sum \\\n"
16510 " --ct-filter 'TYPE==\"disk\"' --ct WholeDisks:SIZE:sum\n"
16513 #. type: Plain text
16514 #: ../misc-utils/lsblk.8.adoc:151
16516 "Produce output in raw format. The output lines are still ordered by "
16517 "dependencies. All potentially unsafe characters are hex-escaped (\\x<code>) "
16518 "in the NAME, KNAME, LABEL, PARTLABEL and MOUNTPOINT columns."
16521 #. type: Labeled list
16522 #: ../misc-utils/lsblk.8.adoc:152
16524 #| msgid "*-f*, *--fast*"
16525 msgid "*-S*, *--scsi*"
16526 msgstr "*-f*, *--fast*"
16528 #. type: Plain text
16529 #: ../misc-utils/lsblk.8.adoc:154
16531 "Output info about SCSI devices only. All partitions, slaves and holder "
16532 "devices are ignored."
16535 #. type: Labeled list
16536 #: ../misc-utils/lsblk.8.adoc:155
16538 #| msgid "*-V*, *--version*"
16539 msgid "*-s*, *--inverse*"
16540 msgstr "*-V*, *--version*"
16542 #. type: Plain text
16543 #: ../misc-utils/lsblk.8.adoc:157
16545 "Print dependencies in inverse order. If the *--list* output is requested "
16546 "then the lines are still ordered by dependencies."
16549 #. type: Labeled list
16550 #: ../misc-utils/lsblk.8.adoc:158
16552 #| msgid "*-g*, **--group**=__group__"
16553 msgid "*-T*, *--tree*[**=**__column__]"
16554 msgstr "*-g*, **--group**=__skupina__"
16556 #. type: Plain text
16557 #: ../misc-utils/lsblk.8.adoc:160
16559 "Force tree-like output format. If _column_ is specified, then a tree is "
16560 "printed in the column. The default is NAME column."
16563 #. type: Labeled list
16564 #: ../misc-utils/lsblk.8.adoc:161
16566 #| msgid "*-P*, *--pty*"
16567 msgid "*-t*, *--topology*"
16568 msgstr "*-P*, *--pty*"
16570 #. type: Plain text
16571 #: ../misc-utils/lsblk.8.adoc:163
16572 msgid "Output info about block-device topology. This option is equivalent to"
16575 #. type: Plain text
16576 #: ../misc-utils/lsblk.8.adoc:165
16578 "NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME*."
16581 #. type: Labeled list
16582 #: ../misc-utils/lsblk.8.adoc:168
16584 msgid "*-w*, *--width* _number_"
16587 #. type: Plain text
16588 #: ../misc-utils/lsblk.8.adoc:170
16590 "Specifies output width as a number of characters. The default is the number "
16591 "of the terminal columns, and if not executed on a terminal, then output "
16592 "width is not restricted at all by default. This option also forces *lsblk* "
16593 "to assume that terminal control characters and unsafe characters are not "
16594 "allowed. The expected use-case is for example when *lsblk* is used by the "
16595 "*watch*(1) command."
16598 #. type: Labeled list
16599 #: ../misc-utils/lsblk.8.adoc:171
16601 msgid "*-x*, *--sort* _column_"
16604 #. type: Plain text
16605 #: ../misc-utils/lsblk.8.adoc:173
16607 "Sort output lines by _column_. This option enables *--list* output format by "
16608 "default. It is possible to use the option *--tree* to force tree-like output "
16609 "and than the tree branches are sorted by the _column_."
16612 #. type: Plain text
16613 #: ../misc-utils/lsblk.8.adoc:176
16615 "The column name will be modified to contain only characters allowed for "
16616 "shell variable identifiers, for example, MIN_IO and FSUSE_PCT instead of MIN-"
16617 "IO and FSUSE%. This is usable, for example, with *--pairs*. Note that this "
16618 "feature has been automatically enabled for *--pairs* in version 2.37, but "
16619 "due to compatibility issues, now it's necessary to request this behavior by "
16623 #. type: Labeled list
16624 #: ../misc-utils/lsblk.8.adoc:177
16626 #| msgid "*-h*, *--help*"
16627 msgid "*-z*, *--zoned*"
16628 msgstr "*-h*, *--help*"
16630 #. type: Plain text
16631 #: ../misc-utils/lsblk.8.adoc:179
16632 msgid "Print the zone related information for each device."
16635 #. type: Labeled list
16636 #: ../misc-utils/lsblk.8.adoc:180
16638 msgid "*--sysroot* _directory_"
16641 #. type: Plain text
16642 #: ../misc-utils/lsblk.8.adoc:182
16644 "Gather data for a Linux instance other than the instance from which the "
16645 "*lsblk* command is issued. The specified directory is the system root of the "
16646 "Linux instance to be inspected. The real device nodes in the target "
16647 "directory can be replaced by text files with udev attributes."
16650 #. type: Labeled list
16651 #: ../misc-utils/lsblk.8.adoc:191 ../sys-utils/fstrim.8.adoc:80
16656 #. type: Plain text
16657 #: ../misc-utils/lsblk.8.adoc:193
16658 msgid "none of specified devices found"
16661 #. type: Labeled list
16662 #: ../misc-utils/lsblk.8.adoc:194 ../sys-utils/fstrim.8.adoc:82
16667 #. type: Plain text
16668 #: ../misc-utils/lsblk.8.adoc:196
16669 msgid "some specified devices found, some not found"
16672 #. type: Labeled list
16673 #: ../misc-utils/lsblk.8.adoc:199
16675 msgid "*LSBLK_DEBUG*=all"
16678 #. type: Plain text
16679 #: ../misc-utils/lsblk.8.adoc:201
16680 msgid "enables *lsblk* debug output."
16683 #. type: Plain text
16684 #: ../misc-utils/lsblk.8.adoc:204 ../sys-utils/swapon.8.adoc:130
16685 msgid "enables *libblkid* debug output."
16688 #. type: Plain text
16689 #: ../misc-utils/lsblk.8.adoc:207 ../sys-utils/swapon.8.adoc:127
16690 msgid "enables *libmount* debug output."
16693 #. type: Plain text
16694 #: ../misc-utils/lsblk.8.adoc:210
16695 msgid "enables *libsmartcols* debug output."
16698 #. type: Plain text
16699 #: ../misc-utils/lsblk.8.adoc:217
16701 "For partitions, some information (e.g., queue attributes) is inherited from "
16702 "the parent device."
16705 #. type: Plain text
16706 #: ../misc-utils/lsblk.8.adoc:219
16708 "The *lsblk* command needs to be able to look up each block device by major:"
16709 "minor numbers, which is done by using _/sys/dev/block_. This sysfs block "
16710 "directory appeared in kernel 2.6.27 (October 2008). In case of problems with "
16711 "a new enough kernel, check that *CONFIG_SYSFS* was enabled at the time of "
16712 "the kernel build."
16715 #. type: Plain text
16716 #: ../misc-utils/lsblk.8.adoc:224
16718 "mailto:gmazyland@gmail.com[Milan Broz], mailto:kzak@redhat.com[Karel Zak]"
16721 #. type: Plain text
16722 #: ../misc-utils/lsblk.8.adoc:231
16725 #| "*setpriv*(1),\n"
16726 #| "*login.defs*(5),\n"
16727 #| "*shells*(5),\n"
16729 #| "*runuser*(1)\n"
16734 "*scols-filter*(5)\n"
16737 "*login.defs*(5),\n"
16743 #: ../misc-utils/lsclocks.1.adoc:2
16745 msgid "lsclocks(1)"
16748 #. type: Plain text
16749 #: ../misc-utils/lsclocks.1.adoc:12
16750 msgid "lsclocks - display system clocks"
16753 #. type: Plain text
16754 #: ../misc-utils/lsclocks.1.adoc:16
16756 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
16757 msgid "*lsclocks* [option]\n"
16758 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
16760 #. type: Plain text
16761 #: ../misc-utils/lsclocks.1.adoc:20
16763 msgid "*lsclocks* is a simple command to display system clocks.\n"
16766 #. type: Plain text
16767 #: ../misc-utils/lsclocks.1.adoc:23
16769 "It allows to display information like current time and resolution of clocks "
16770 "like CLOCK_MONOTONIC, CLOCK_REALTIME and CLOCK_BOOTTIME."
16773 #. type: Plain text
16774 #: ../misc-utils/lsclocks.1.adoc:31 ../misc-utils/lsfd.1.adoc:49
16775 #: ../sys-utils/lsirq.1.adoc:27
16776 msgid "Don't print headings."
16779 #. type: Plain text
16780 #: ../misc-utils/lsclocks.1.adoc:35 ../misc-utils/lsfd.1.adoc:53
16782 "Specify which output columns to print. See the *OUTPUT COLUMNS* section for "
16783 "details of available columns."
16786 #. type: Plain text
16787 #: ../misc-utils/lsclocks.1.adoc:38
16789 #| msgid "File formats"
16790 msgid "Output all columns."
16791 msgstr "Formáty souborů"
16793 #. type: Plain text
16794 #: ../misc-utils/lsclocks.1.adoc:41 ../misc-utils/lsfd.1.adoc:59
16795 msgid "Use raw output format."
16798 #. type: Labeled list
16799 #: ../misc-utils/lsclocks.1.adoc:42
16801 #| msgid "*-P*, *--pty*"
16802 msgid "*-r*, *--time* _clock_"
16803 msgstr "*-P*, *--pty*"
16805 #. type: Plain text
16806 #: ../misc-utils/lsclocks.1.adoc:44
16807 msgid "Show current time of one specific clock."
16810 #. type: Labeled list
16811 #: ../misc-utils/lsclocks.1.adoc:45
16813 msgid "*--no-discover-dynamic*"
16816 #. type: Plain text
16817 #: ../misc-utils/lsclocks.1.adoc:47
16818 msgid "Do not try to discover dynamic clocks."
16821 #. type: Labeled list
16822 #: ../misc-utils/lsclocks.1.adoc:48
16824 #| msgid "*-s*, **--shell**=__shell__"
16825 msgid "*-d*, *--dynamic-clock* _path_"
16826 msgstr "*-s*, **--shell**=__shell__"
16828 #. type: Plain text
16829 #: ../misc-utils/lsclocks.1.adoc:51
16830 msgid "Also display specified dynamic clock. Can be specified multiple times."
16833 #. type: Labeled list
16834 #: ../misc-utils/lsclocks.1.adoc:52
16836 #| msgid "*-V*, *--version*"
16837 msgid "*--no-discover-rtc*"
16838 msgstr "*-V*, *--version*"
16840 #. type: Plain text
16841 #: ../misc-utils/lsclocks.1.adoc:54
16842 msgid "Do not try to discover RTCs."
16845 #. type: Labeled list
16846 #: ../misc-utils/lsclocks.1.adoc:55
16848 #| msgid "*-f*, *--fast*"
16849 msgid "*-x*, *--rtc* _path_"
16850 msgstr "*-f*, *--fast*"
16852 #. type: Plain text
16853 #: ../misc-utils/lsclocks.1.adoc:58
16854 msgid "Also display specified RTC. Can be specified multiple times."
16857 #. type: Labeled list
16858 #: ../misc-utils/lsclocks.1.adoc:59
16860 #| msgid "*-P*, *--pty*"
16861 msgid "*-c*, *--cpu-clock* _pid_"
16862 msgstr "*-P*, *--pty*"
16864 #. type: Plain text
16865 #: ../misc-utils/lsclocks.1.adoc:62
16867 "Also display CPU clock of specified process. Can be specified multiple "
16872 #: ../misc-utils/lsclocks.1.adoc:65 ../misc-utils/lsfd.1.adoc:118
16874 msgid "OUTPUT COLUMNS"
16877 #. type: Plain text
16878 #: ../misc-utils/lsclocks.1.adoc:68 ../misc-utils/lsfd.1.adoc:121
16879 msgid "Each column has a type. Types are surround by < and >."
16882 #. type: Labeled list
16883 #: ../misc-utils/lsclocks.1.adoc:69 ../misc-utils/lsfd.1.adoc:500
16885 #| msgid "*ENV_PATH* (string)"
16886 msgid "TYPE <``string``>"
16887 msgstr "*ENV_PATH* (řetězec)"
16889 #. type: Plain text
16890 #: ../misc-utils/lsclocks.1.adoc:71
16891 msgid "Clock type."
16894 #. type: Labeled list
16895 #: ../misc-utils/lsclocks.1.adoc:72
16897 msgid "ID <``number``>"
16900 #. type: Plain text
16901 #: ../misc-utils/lsclocks.1.adoc:74
16902 msgid "Numeric clock ID."
16905 #. type: Labeled list
16906 #: ../misc-utils/lsclocks.1.adoc:75
16908 #| msgid "*ENV_PATH* (string)"
16909 msgid "CLOCK <``string``>"
16910 msgstr "*ENV_PATH* (řetězec)"
16912 #. type: Plain text
16913 #: ../misc-utils/lsclocks.1.adoc:77
16914 msgid "Name in the form *CLOCK_*"
16917 #. type: Labeled list
16918 #: ../misc-utils/lsclocks.1.adoc:78 ../misc-utils/lsfd.1.adoc:267
16920 msgid "NAME <``string``>"
16923 #. type: Plain text
16924 #: ../misc-utils/lsclocks.1.adoc:80
16925 msgid "Shorter, easier to read name."
16928 #. type: Labeled list
16929 #: ../misc-utils/lsclocks.1.adoc:81
16931 msgid "TIME <``number``>"
16934 #. type: Plain text
16935 #: ../misc-utils/lsclocks.1.adoc:83
16936 msgid "Current clock timestamp as returned by *clock_gettime()*."
16939 #. type: Labeled list
16940 #: ../misc-utils/lsclocks.1.adoc:84
16942 #| msgid "*ENV_PATH* (string)"
16943 msgid "ISO_TIME <``string``>"
16944 msgstr "*ENV_PATH* (řetězec)"
16946 #. type: Plain text
16947 #: ../misc-utils/lsclocks.1.adoc:86
16948 msgid "ISO8601 formatted version of *TIME*."
16951 #. type: Labeled list
16952 #: ../misc-utils/lsclocks.1.adoc:87
16954 msgid "RESOL_RAW <``number``>"
16957 #. type: Plain text
16958 #: ../misc-utils/lsclocks.1.adoc:89
16959 msgid "Clock resolution as returned by *clock_getres*(2)."
16962 #. type: Labeled list
16963 #: ../misc-utils/lsclocks.1.adoc:90
16965 msgid "RESOL <``number``>"
16968 #. type: Plain text
16969 #: ../misc-utils/lsclocks.1.adoc:92
16970 msgid "Human readable version of *RESOL_RAW*."
16973 #. type: Labeled list
16974 #: ../misc-utils/lsclocks.1.adoc:93
16976 #| msgid "*ENV_PATH* (string)"
16977 msgid "REL_TIME <``string``>"
16978 msgstr "*ENV_PATH* (řetězec)"
16980 #. type: Plain text
16981 #: ../misc-utils/lsclocks.1.adoc:95
16983 msgid "*TIME* time formatted as time range.\n"
16986 #. type: Labeled list
16987 #: ../misc-utils/lsclocks.1.adoc:96
16989 msgid "NS_OFFSET <``number``>"
16992 #. type: Plain text
16993 #: ../misc-utils/lsclocks.1.adoc:98
16995 "Offset of the current namespace to the parent namespace as read from */proc/"
16996 "self/timens_offsets*."
16999 #. type: Plain text
17000 #: ../misc-utils/lsclocks.1.adoc:107
17002 msgid "*clock_getres*(2) *clock_gettime*(2)\n"
17006 #. Copyright 2021 Red Hat, Inc.
17007 #. This file may be copied under the terms of the GNU Public License.
17009 #: ../misc-utils/lsfd.1.adoc:7
17014 #. type: Plain text
17015 #: ../misc-utils/lsfd.1.adoc:18
17016 msgid "lsfd - list file descriptors"
17019 #. type: Plain text
17020 #: ../misc-utils/lsfd.1.adoc:22
17022 msgid "*lsfd* [option]\n"
17025 #. type: Plain text
17026 #: ../misc-utils/lsfd.1.adoc:30
17029 "*lsfd* is intended to be a modern replacement for *lsof*(8) on Linux systems.\n"
17030 "Unlike *lsof*, *lsfd* is specialized to Linux kernel; it supports Linux\n"
17031 "specific features like namespaces with simpler code. *lsfd* is not a\n"
17032 "drop-in replacement for *lsof*; they are different in the command line\n"
17033 "interface and output formats.\n"
17036 #. type: Plain text
17037 #: ../misc-utils/lsfd.1.adoc:38
17040 "*lsfd* uses Libsmartcols for output formatting and filtering. See the description of *--output*\n"
17041 "option for customizing the output format, and *--filter* option for filtering. Use *lsfd --list-columns*\n"
17042 "to get a list of all available columns.\n"
17045 #. type: Labeled list
17046 #: ../misc-utils/lsfd.1.adoc:41
17048 #| msgid "*-h*, *--help*"
17049 msgid "*-l*, *--threads*"
17050 msgstr "*-h*, *--help*"
17052 #. type: Plain text
17053 #: ../misc-utils/lsfd.1.adoc:43
17054 msgid "List in threads level."
17057 #. type: Plain text
17058 #: ../misc-utils/lsfd.1.adoc:56
17060 "The default list of columns may be extended if _list_ is specified in the "
17061 "format +_list_ (e.g., *lsfd -o +DELETED*)."
17064 #. type: Plain text
17065 #: ../misc-utils/lsfd.1.adoc:62
17066 msgid "Don't truncate text in columns."
17069 #. type: Labeled list
17070 #: ../misc-utils/lsfd.1.adoc:63
17072 #| msgid "*-P*, *--pty*"
17073 msgid "*-p*, *--pid* _pids_"
17074 msgstr "*-P*, *--pty*"
17076 #. type: Plain text
17077 #: ../misc-utils/lsfd.1.adoc:67
17079 "Collect information only for specified processes. _pids_ is a list of pids. "
17080 "A comma or whitespaces can be used as separators. You can use this option "
17081 "with *pidof*(1). See *FILTER EXAMPLES*."
17084 #. type: Plain text
17085 #: ../misc-utils/lsfd.1.adoc:72
17087 "Both *-Q* option with an expression including PID, e.g. -Q (PID == 1), and *-"
17088 "p* option, e.g. -p 1, may print the same output but using *-p* option is "
17089 "much more efficient because *-p* option works at a much earlier stage of "
17090 "processing than the *-Q* option."
17093 #. type: Labeled list
17094 #: ../misc-utils/lsfd.1.adoc:73
17096 #| msgid "*-V*, *--version*"
17097 msgid "*-i*[4|6], *--inet*[=4|=6]"
17098 msgstr "*-V*, *--version*"
17100 #. type: Plain text
17101 #: ../misc-utils/lsfd.1.adoc:75
17102 msgid "List only IPv4 sockets and/or IPv6 sockets."
17105 #. type: Plain text
17106 #: ../misc-utils/lsfd.1.adoc:79
17108 "Print only the files matching the condition represented by the _expr_. See "
17109 "also *scols-filter*(5) and *FILTER EXAMPLES*."
17112 #. type: Labeled list
17113 #: ../misc-utils/lsfd.1.adoc:80
17115 msgid "*-C*, *--counter* __label__:__filter_expr__"
17118 #. type: Plain text
17119 #: ../misc-utils/lsfd.1.adoc:86
17121 "Define a custom counter used in *--summary* output. *lsfd* makes a counter "
17122 "named _label_. During collect information, *lsfd* counts files matching "
17123 "_filter_expr_, and stores the counted number to the counter named _label_. "
17124 "*lsfd* applies filters defined with *--filter* options before counting; "
17125 "files excluded by the filters are not counted."
17128 #. type: Plain text
17129 #: ../misc-utils/lsfd.1.adoc:90
17131 "See *scols-filter*(5) about _filter_expr_. _label_ should not include `{` "
17132 "nor `:`. You can define multiple counters by specifying this option multiple "
17136 #. type: Plain text
17137 #: ../misc-utils/lsfd.1.adoc:92
17138 msgid "See also *COUNTER EXAMPLES*."
17141 #. type: Labeled list
17142 #: ../misc-utils/lsfd.1.adoc:93 ../sys-utils/lsmem.1.adoc:65
17144 msgid "*--summary*[=_when_]"
17147 #. type: Plain text
17148 #: ../misc-utils/lsfd.1.adoc:97
17150 "This option controls summary lines output. The optional argument _when_ can "
17151 "be *only*, *append* or *never*. If the _when_ argument is omitted, it "
17152 "defaults to *only*."
17155 #. type: Plain text
17156 #: ../misc-utils/lsfd.1.adoc:102
17158 "The summary reports counters. A counter consists of a label and an integer "
17159 "value. *--counter* is the option for defining a counter. If a user defines "
17160 "no counter, *lsfd* uses the definitions of pre-defined built-in counters "
17161 "(default counters) to make the summary output."
17164 #. TRANSLATORS: Keep {colon} untranslated.
17165 #. type: Plain text
17166 #: ../misc-utils/lsfd.1.adoc:104
17168 "CAUTION{colon} Using *--summary* and *--json* may make the output broken. "
17169 "Only combining *--summary*=*only* and *--json* is valid."
17172 #. type: Labeled list
17173 #: ../misc-utils/lsfd.1.adoc:106
17175 msgid "*--debug-filter*"
17178 #. type: Plain text
17179 #: ../misc-utils/lsfd.1.adoc:109
17181 "Dump the internal data structure for the filter and exit. This is useful "
17182 "only for *lsfd* developers."
17185 #. type: Labeled list
17186 #: ../misc-utils/lsfd.1.adoc:110
17188 msgid "*--dump-counters*"
17191 #. type: Plain text
17192 #: ../misc-utils/lsfd.1.adoc:112
17193 msgid "Dump the definition of counters used in *--summary* output."
17196 #. type: Plain text
17197 #: ../misc-utils/lsfd.1.adoc:115
17198 msgid "List available columns that you can specify at *--output* option."
17201 #. TRANSLATORS: Keep {colon} untranslated.
17202 #. type: Plain text
17203 #: ../misc-utils/lsfd.1.adoc:125
17205 "CAUTION{colon} The names and types of columns are not stable yet. They may "
17206 "be changed in the future releases."
17209 #. type: Labeled list
17210 #: ../misc-utils/lsfd.1.adoc:126
17212 msgid "AINODECLASS <``string``>"
17215 #. type: Plain text
17216 #: ../misc-utils/lsfd.1.adoc:128
17217 msgid "Class of anonymous inode."
17220 #. type: Labeled list
17221 #: ../misc-utils/lsfd.1.adoc:129
17223 msgid "ASSOC <``string``>"
17226 #. type: Plain text
17227 #: ../misc-utils/lsfd.1.adoc:131
17228 msgid "Association between file and process."
17231 #. type: Labeled list
17232 #: ../misc-utils/lsfd.1.adoc:132
17234 msgid "BLKDRV <``string``>"
17237 #. type: Plain text
17238 #: ../misc-utils/lsfd.1.adoc:134
17239 msgid "Block device driver name resolved by `/proc/devices`."
17242 #. type: Labeled list
17243 #: ../misc-utils/lsfd.1.adoc:135
17245 msgid "BPF-MAP.ID <``number``>"
17248 #. type: Plain text
17249 #: ../misc-utils/lsfd.1.adoc:137
17250 msgid "Bpf map ID."
17253 #. type: Labeled list
17254 #: ../misc-utils/lsfd.1.adoc:138
17256 #| msgid "*ENV_PATH* (string)"
17257 msgid "BPF-MAP.TYPE <``string``>"
17258 msgstr "*ENV_PATH* (řetězec)"
17260 #. type: Plain text
17261 #: ../misc-utils/lsfd.1.adoc:140
17262 msgid "Decoded name of bpf map type."
17265 #. type: Labeled list
17266 #: ../misc-utils/lsfd.1.adoc:141
17268 msgid "BPF-MAP.TYPE.RAW <``number``>"
17271 #. type: Plain text
17272 #: ../misc-utils/lsfd.1.adoc:143
17273 msgid "Bpf map type (raw)."
17276 #. type: Labeled list
17277 #: ../misc-utils/lsfd.1.adoc:144
17279 #| msgid "*ENV_PATH* (string)"
17280 msgid "BPF.NAME <``string``>"
17281 msgstr "*ENV_PATH* (řetězec)"
17283 #. type: Plain text
17284 #: ../misc-utils/lsfd.1.adoc:146
17285 msgid "Bpf object name."
17288 #. type: Labeled list
17289 #: ../misc-utils/lsfd.1.adoc:147
17291 msgid "BPF-PROG.ID <``number``>"
17294 #. type: Plain text
17295 #: ../misc-utils/lsfd.1.adoc:149
17296 msgid "Bpf program ID."
17299 #. type: Labeled list
17300 #: ../misc-utils/lsfd.1.adoc:150
17302 #| msgid "*ENV_PATH* (string)"
17303 msgid "BPF-PROG.TYPE <``string``>"
17304 msgstr "*ENV_PATH* (řetězec)"
17306 #. type: Plain text
17307 #: ../misc-utils/lsfd.1.adoc:152
17308 msgid "Decoded name of bpf program type."
17311 #. type: Labeled list
17312 #: ../misc-utils/lsfd.1.adoc:153
17314 msgid "BPF-PROG.TYPE.RAW <``number``>"
17317 #. type: Plain text
17318 #: ../misc-utils/lsfd.1.adoc:155
17319 msgid "Bpf program type (raw)."
17322 #. type: Labeled list
17323 #: ../misc-utils/lsfd.1.adoc:156
17325 msgid "CHRDRV <``string``>"
17328 #. type: Plain text
17329 #: ../misc-utils/lsfd.1.adoc:158
17330 msgid "Character device driver name resolved by `/proc/devices`."
17333 #. type: Labeled list
17334 #: ../misc-utils/lsfd.1.adoc:159
17336 msgid "COMMAND <``string``>"
17339 #. type: Plain text
17340 #: ../misc-utils/lsfd.1.adoc:161
17341 msgid "Command of the process opening the file."
17344 #. type: Labeled list
17345 #: ../misc-utils/lsfd.1.adoc:162
17347 msgid "DELETED <``boolean``>"
17350 #. type: Plain text
17351 #: ../misc-utils/lsfd.1.adoc:164
17352 msgid "Reachability from the file system."
17355 #. type: Labeled list
17356 #: ../misc-utils/lsfd.1.adoc:165
17358 msgid "DEV <``string``>"
17361 #. type: Plain text
17362 #: ../misc-utils/lsfd.1.adoc:167
17363 msgid "ID of the device containing the file."
17366 #. type: Labeled list
17367 #: ../misc-utils/lsfd.1.adoc:168
17369 msgid "DEVTYPE <``string``>"
17372 #. type: Plain text
17373 #: ../misc-utils/lsfd.1.adoc:170
17374 msgid "Device type (`blk`, `char`, or `nodev`)."
17377 #. type: Labeled list
17378 #: ../misc-utils/lsfd.1.adoc:171
17380 msgid "ENDPOINT <``string``>"
17383 #. type: Plain text
17384 #: ../misc-utils/lsfd.1.adoc:173
17385 msgid "IPC endpoints information communicated with the fd."
17388 #. type: Plain text
17389 #: ../misc-utils/lsfd.1.adoc:177
17392 "*lsfd* collects endpoints within the processes that\n"
17393 "*lsfd* scans; *lsfd* may miss some endpoints\n"
17394 "if you limits the processes with *-p* option.\n"
17397 #. type: Plain text
17398 #: ../misc-utils/lsfd.1.adoc:180
17399 msgid "The format of the column depends on the object associated with the fd:"
17402 #. type: Labeled list
17403 #: ../misc-utils/lsfd.1.adoc:181
17408 #. type: Labeled list
17409 #: ../misc-utils/lsfd.1.adoc:182
17411 msgid "mqueue type"
17414 #. type: Labeled list
17415 #: ../misc-utils/lsfd.1.adoc:183
17417 msgid "ptmx and pts sources"
17420 #. type: Plain text
17421 #: ../misc-utils/lsfd.1.adoc:185
17422 msgid "_PID_,_COMMAND_,_ASSOC_[-r][-w]"
17425 #. type: Plain text
17426 #: ../misc-utils/lsfd.1.adoc:188
17428 "The last characters ([-r][-w]) represents the read and/or write mode of the "
17432 #. type: Labeled list
17433 #: ../misc-utils/lsfd.1.adoc:189
17435 msgid "eventfd type"
17438 #. type: Plain text
17439 #: ../misc-utils/lsfd.1.adoc:191
17440 msgid "_PID_,_COMMAND_,_ASSOC_"
17443 #. type: Labeled list
17444 #: ../misc-utils/lsfd.1.adoc:192 ../misc-utils/lsfd.1.adoc:340
17446 msgid "UNIX-STREAM"
17449 #. type: Plain text
17450 #: ../misc-utils/lsfd.1.adoc:194
17451 msgid "_PID_,_COMMAND_,_ASSOC_[-r?][-w?]"
17454 #. type: Plain text
17455 #: ../misc-utils/lsfd.1.adoc:197
17457 "About the last characters ([-r?][-w?]), see the description of _SOCK."
17461 #. type: Labeled list
17462 #: ../misc-utils/lsfd.1.adoc:198
17464 msgid "EVENTFD.ID <``number``>"
17467 #. type: Plain text
17468 #: ../misc-utils/lsfd.1.adoc:200
17469 msgid "Eventfd ID."
17472 #. type: Labeled list
17473 #: ../misc-utils/lsfd.1.adoc:201
17475 #| msgid "*ENV_PATH* (string)"
17476 msgid "EVENTPOLL.TFDS <``string``>"
17477 msgstr "*ENV_PATH* (řetězec)"
17479 #. type: Plain text
17480 #: ../misc-utils/lsfd.1.adoc:203
17481 msgid "File descriptors targeted by the eventpoll file."
17484 #. type: Labeled list
17485 #: ../misc-utils/lsfd.1.adoc:204
17487 msgid "FD <``number``>"
17490 #. type: Plain text
17491 #: ../misc-utils/lsfd.1.adoc:206
17492 msgid "File descriptor for the file."
17495 #. type: Labeled list
17496 #: ../misc-utils/lsfd.1.adoc:207
17498 msgid "FLAGS <``string``>"
17501 #. type: Plain text
17502 #: ../misc-utils/lsfd.1.adoc:209
17503 msgid "Flags specified when opening the file."
17506 #. type: Labeled list
17507 #: ../misc-utils/lsfd.1.adoc:210
17509 msgid "FUID <``number``>"
17512 #. type: Plain text
17513 #: ../misc-utils/lsfd.1.adoc:212
17514 msgid "User ID number of the file's owner."
17517 #. type: Labeled list
17518 #: ../misc-utils/lsfd.1.adoc:213
17520 msgid "INET.LADDR <``string``>"
17523 #. type: Plain text
17524 #: ../misc-utils/lsfd.1.adoc:215
17525 msgid "Local IP address."
17528 #. type: Labeled list
17529 #: ../misc-utils/lsfd.1.adoc:216
17531 msgid "INET.RADDR <``string``>"
17534 #. type: Plain text
17535 #: ../misc-utils/lsfd.1.adoc:218
17536 msgid "Remote IP address."
17539 #. type: Labeled list
17540 #: ../misc-utils/lsfd.1.adoc:219
17542 msgid "INET6.LADDR <``string``>"
17545 #. type: Plain text
17546 #: ../misc-utils/lsfd.1.adoc:221
17547 msgid "Local IP6 address."
17550 #. type: Labeled list
17551 #: ../misc-utils/lsfd.1.adoc:222
17553 msgid "INET6.RADDR <``string``>"
17556 #. type: Plain text
17557 #: ../misc-utils/lsfd.1.adoc:224
17558 msgid "Remote IP6 address."
17561 #. type: Labeled list
17562 #: ../misc-utils/lsfd.1.adoc:225
17564 msgid "INODE <``number``>"
17567 #. type: Plain text
17568 #: ../misc-utils/lsfd.1.adoc:227
17569 msgid "Inode number."
17572 #. type: Labeled list
17573 #: ../misc-utils/lsfd.1.adoc:228
17575 #| msgid "*ENV_PATH* (string)"
17576 msgid "INOTIFY.INODES <``string``>"
17577 msgstr "*ENV_PATH* (řetězec)"
17579 #. type: Plain text
17580 #: ../misc-utils/lsfd.1.adoc:232
17582 "Cooked version of INOTIFY.INODES.RAW. The format of the element is _inode-"
17583 "number_,_source-of-inode_."
17586 #. type: Labeled list
17587 #: ../misc-utils/lsfd.1.adoc:233
17589 #| msgid "*ENV_PATH* (string)"
17590 msgid "INOTIFY.INODES.RAW <``string``>"
17591 msgstr "*ENV_PATH* (řetězec)"
17593 #. type: Plain text
17594 #: ../misc-utils/lsfd.1.adoc:236
17596 "List of monitoring inodes. The format of the element is _inode-number_,"
17597 "_device-major_:_device-minor_."
17600 #. type: Labeled list
17601 #: ../misc-utils/lsfd.1.adoc:237
17603 msgid "KNAME <``string``>"
17610 #. It seems that the manpage backend of asciidoctor has limitations
17611 #. about emitting text with nested face specifications like:
17613 #. Not only u but also p is decorated with underline.
17614 #. type: Plain text
17615 #: ../misc-utils/lsfd.1.adoc:248
17617 "Raw file name extracted from from ``/proc/``_pid_``/fd/``_fd_ or ``/proc/"
17618 "``_pid_``/map_files/``_region_."
17621 #. type: Labeled list
17622 #: ../misc-utils/lsfd.1.adoc:249
17624 msgid "KTHREAD <``boolean``>"
17627 #. type: Plain text
17628 #: ../misc-utils/lsfd.1.adoc:251
17629 msgid "Whether the process is a kernel thread or not."
17632 #. type: Labeled list
17633 #: ../misc-utils/lsfd.1.adoc:252
17635 msgid "MAJ:MIN <``string``>"
17638 #. type: Plain text
17639 #: ../misc-utils/lsfd.1.adoc:254
17640 msgid "Device ID for special, or ID of device containing file."
17643 #. type: Labeled list
17644 #: ../misc-utils/lsfd.1.adoc:255
17646 msgid "MAPLEN <``number``>"
17649 #. type: Plain text
17650 #: ../misc-utils/lsfd.1.adoc:257
17651 msgid "Length of file mapping (in page)."
17654 #. type: Labeled list
17655 #: ../misc-utils/lsfd.1.adoc:258
17657 msgid "MISCDEV <``string``>"
17660 #. type: Plain text
17661 #: ../misc-utils/lsfd.1.adoc:260
17662 msgid "Misc character device name resolved by `/proc/misc`."
17665 #. type: Labeled list
17666 #: ../misc-utils/lsfd.1.adoc:261
17668 msgid "MNTID <``number``>"
17671 #. type: Plain text
17672 #: ../misc-utils/lsfd.1.adoc:263
17676 #. type: Labeled list
17677 #: ../misc-utils/lsfd.1.adoc:264
17679 msgid "MODE <``string``>"
17682 #. type: Plain text
17683 #: ../misc-utils/lsfd.1.adoc:266
17684 msgid "Access mode (rwx)."
17687 #. type: Plain text
17688 #: ../misc-utils/lsfd.1.adoc:269
17689 msgid "Cooked version of KNAME. It is mostly same as KNAME."
17692 #. type: Plain text
17693 #: ../misc-utils/lsfd.1.adoc:271
17694 msgid "Some files have special formats and information sources:"
17697 #. type: Labeled list
17698 #: ../misc-utils/lsfd.1.adoc:272
17703 #. type: Plain text
17704 #: ../misc-utils/lsfd.1.adoc:274
17705 msgid "id=_BPF-MAP.ID_ type=_BPF-MAP.TYPE_[ name=_BPF.NAME_]"
17708 #. type: Labeled list
17709 #: ../misc-utils/lsfd.1.adoc:275
17714 #. type: Plain text
17715 #: ../misc-utils/lsfd.1.adoc:277
17716 msgid "id=_BPF-PROG.ID_ type=_BPF-PROG.TYPE_[ name=_BPF.NAME_]"
17719 #. type: Labeled list
17720 #: ../misc-utils/lsfd.1.adoc:278
17722 #| msgid "*comment*"
17726 #. type: Plain text
17727 #: ../misc-utils/lsfd.1.adoc:280
17728 msgid "tfds=_EVENTPOLL.TFDS_"
17731 #. type: Labeled list
17732 #: ../misc-utils/lsfd.1.adoc:281
17734 #| msgid "*comment*"
17738 #. type: Plain text
17739 #: ../misc-utils/lsfd.1.adoc:283
17740 msgid "id=_EVENTFD.ID_"
17743 #. type: Labeled list
17744 #: ../misc-utils/lsfd.1.adoc:284
17749 #. type: Plain text
17750 #: ../misc-utils/lsfd.1.adoc:286
17751 msgid "inodes=_INOTIFY.INODES_"
17754 #. type: Labeled list
17755 #: ../misc-utils/lsfd.1.adoc:287
17760 #. type: Plain text
17761 #: ../misc-utils/lsfd.1.adoc:289
17762 msgid "iface=_TUN.IFACE_"
17765 #. type: Labeled list
17766 #: ../misc-utils/lsfd.1.adoc:290
17771 #. type: Plain text
17772 #: ../misc-utils/lsfd.1.adoc:292
17774 "protocol=_NETLINK.PROTOCOL_[ lport=_NETLINK.LPORT_[ group=_NETLINK.GROUPS_]]"
17777 #. type: Labeled list
17778 #: ../misc-utils/lsfd.1.adoc:293
17783 #. type: Plain text
17784 #: ../misc-utils/lsfd.1.adoc:295
17785 msgid "type=_SOCK.TYPE_[ protocol=_PACKET.PROTOCOL_][ iface=_PACKET.IFACE_]"
17788 #. type: Labeled list
17789 #: ../misc-utils/lsfd.1.adoc:296
17794 #. type: Plain text
17795 #: ../misc-utils/lsfd.1.adoc:298
17796 msgid "pid=_TARGET-PID_ comm=_TARGET-COMMAND_ nspid=_TARGET-NSPIDS_"
17799 #. type: Plain text
17800 #: ../misc-utils/lsfd.1.adoc:301
17803 "*lsfd* extracts _TARGET-PID_ and _TARGET-NSPIDS_ from\n"
17804 "``/proc/``_pid_``/fdinfo/``_fd_.\n"
17807 #. type: Labeled list
17808 #: ../misc-utils/lsfd.1.adoc:302
17813 #. type: Plain text
17814 #: ../misc-utils/lsfd.1.adoc:304
17816 "state=_SOCK.STATE_[ id=_PING.ID_][ laddr=_INET.LADDR_ [ raddr=_INET.RADDR_]]"
17819 #. type: Labeled list
17820 #: ../misc-utils/lsfd.1.adoc:305
17825 #. type: Plain text
17826 #: ../misc-utils/lsfd.1.adoc:307
17828 "state=_SOCK.STATE_[ id=_PING.ID_][ laddr=_INET6.LADDR_ [ raddr=_INET6."
17832 #. type: Labeled list
17833 #: ../misc-utils/lsfd.1.adoc:308
17838 #. type: Plain text
17839 #: ../misc-utils/lsfd.1.adoc:310
17840 msgid "tty-index=_PTMX.TTY-INDEX_"
17843 #. type: Plain text
17844 #: ../misc-utils/lsfd.1.adoc:313
17847 "*lsfd* extracts _PTMX.TTY-INDEX_ from\n"
17848 "``/proc/``_pid_``/fdinfo/``_fd_.\n"
17851 #. type: Labeled list
17852 #: ../misc-utils/lsfd.1.adoc:314
17857 #. type: Plain text
17858 #: ../misc-utils/lsfd.1.adoc:316
17860 "state=_SOCK.STATE_[ protocol=_RAW.PROTOCOL_ [ laddr=_INET.LADDR_ "
17861 "[ raddr=_INET.RADDR_]]]"
17864 #. type: Labeled list
17865 #: ../misc-utils/lsfd.1.adoc:317
17870 #. type: Plain text
17871 #: ../misc-utils/lsfd.1.adoc:319
17873 "state=_SOCK.STATE_[ protocol=_RAW.PROTOCOL_ [ laddr=_INET6.LADDR_ "
17874 "[ raddr=_INET6.RADDR_]]]"
17877 #. type: Labeled list
17878 #: ../misc-utils/lsfd.1.adoc:320
17883 #. type: Plain text
17884 #: ../misc-utils/lsfd.1.adoc:322
17885 msgid "mask=_SIGNALFD.MASK_"
17888 #. type: Labeled list
17889 #: ../misc-utils/lsfd.1.adoc:323
17894 #. type: Labeled list
17895 #: ../misc-utils/lsfd.1.adoc:324
17900 #. type: Plain text
17901 #: ../misc-utils/lsfd.1.adoc:326
17902 msgid "state=_SOCK.STATE_[ laddr=_TCP.LADDR_ [ raddr=_TCP.RADDR_]]"
17905 #. type: Labeled list
17906 #: ../misc-utils/lsfd.1.adoc:327
17911 #. type: Plain text
17912 #: ../misc-utils/lsfd.1.adoc:329
17914 "clockid=_TIMERFD.CLOCKID_[ remaining=_TIMERFD.REMAINING_ [ interval=_TIMERFD."
17918 #. type: Labeled list
17919 #: ../misc-utils/lsfd.1.adoc:330
17924 #. type: Labeled list
17925 #: ../misc-utils/lsfd.1.adoc:331
17930 #. type: Plain text
17931 #: ../misc-utils/lsfd.1.adoc:333
17932 msgid "state=_SOCK.STATE_[ laddr=_UDP.LADDR_ [ raddr=_UDP.RADDR_]]"
17935 #. type: Plain text
17936 #: ../misc-utils/lsfd.1.adoc:335
17938 msgid "*lsfd* hides ``raddr=`` if _UDP.RADDR_ is ``0.0.0.0`` and _UDP.RPORT_ is 0.\n"
17941 #. type: Labeled list
17942 #: ../misc-utils/lsfd.1.adoc:336
17947 #. type: Labeled list
17948 #: ../misc-utils/lsfd.1.adoc:337
17953 #. type: Plain text
17954 #: ../misc-utils/lsfd.1.adoc:339
17955 msgid "state=_SOCK.STATE_[ laddr=_UDPLITE.LADDR_ [ raddr=_UDPLITE.RADDR_]]"
17958 #. type: Plain text
17959 #: ../misc-utils/lsfd.1.adoc:342
17960 msgid "state=_SOCK.STATE_[ path=_UNIX.PATH_]"
17963 #. type: Labeled list
17964 #: ../misc-utils/lsfd.1.adoc:343
17969 #. type: Plain text
17970 #: ../misc-utils/lsfd.1.adoc:345
17971 msgid "state=_SOCK.STATE_[ path=_UNIX.PATH_] type=_SOCK.TYPE_"
17974 #. type: delimited block _
17975 #: ../misc-utils/lsfd.1.adoc:350
17977 "Note that `(deleted)` markers are removed from this column. Refer to "
17978 "_KNAME_, _DELETED_, or _XMODE_ to know the readability of the file from the "
17982 #. type: Labeled list
17983 #: ../misc-utils/lsfd.1.adoc:352
17985 msgid "NETLINK.GROUPS <``number``>"
17988 #. type: Plain text
17989 #: ../misc-utils/lsfd.1.adoc:354
17990 msgid "Netlink multicast groups."
17993 #. type: Labeled list
17994 #: ../misc-utils/lsfd.1.adoc:355
17996 msgid "NETLINK.LPORT <``number``>"
17999 #. type: Plain text
18000 #: ../misc-utils/lsfd.1.adoc:357
18001 msgid "Netlink local port id."
18004 #. type: Labeled list
18005 #: ../misc-utils/lsfd.1.adoc:358
18007 #| msgid "*ENV_PATH* (string)"
18008 msgid "NETLINK.PROTOCOL <``string``>"
18009 msgstr "*ENV_PATH* (řetězec)"
18011 #. type: Plain text
18012 #: ../misc-utils/lsfd.1.adoc:360
18013 msgid "Netlink protocol."
18016 #. type: Labeled list
18017 #: ../misc-utils/lsfd.1.adoc:361
18019 msgid "NLINK <``number``>"
18022 #. type: Plain text
18023 #: ../misc-utils/lsfd.1.adoc:363
18024 msgid "Link count."
18027 #. type: Labeled list
18028 #: ../misc-utils/lsfd.1.adoc:364
18030 msgid "NS.NAME <``string``>"
18033 #. type: Plain text
18034 #: ../misc-utils/lsfd.1.adoc:366
18035 msgid "Name (_NS.TYPE_:[_INODE_]) of the namespace specified with the file."
18038 #. type: Labeled list
18039 #: ../misc-utils/lsfd.1.adoc:367
18041 msgid "NS.TYPE <``string``>"
18044 #. type: Plain text
18045 #: ../misc-utils/lsfd.1.adoc:371
18047 "Type of the namespace specified with the file. The type is `mnt`, `cgroup`, "
18048 "`uts`, `ipc`, `user`, `pid`, `net`, `time`, or `unknown`."
18051 #. type: Labeled list
18052 #: ../misc-utils/lsfd.1.adoc:372
18054 msgid "OWNER <``string``>"
18057 #. type: Plain text
18058 #: ../misc-utils/lsfd.1.adoc:374
18059 msgid "Owner of the file."
18062 #. type: Labeled list
18063 #: ../misc-utils/lsfd.1.adoc:375
18065 msgid "PACKET.IFACE <``string``>"
18068 #. type: Plain text
18069 #: ../misc-utils/lsfd.1.adoc:377
18070 msgid "Interface name associated with the packet socket."
18073 #. type: Labeled list
18074 #: ../misc-utils/lsfd.1.adoc:378
18076 msgid "PACKET.PROTOCOL <``string``>"
18079 #. type: Plain text
18080 #: ../misc-utils/lsfd.1.adoc:380
18081 msgid "L3 protocol associated with the packet socket."
18084 #. type: Labeled list
18085 #: ../misc-utils/lsfd.1.adoc:381
18087 msgid "PARTITION <``string``>"
18090 #. type: Plain text
18091 #: ../misc-utils/lsfd.1.adoc:383
18092 msgid "Block device name resolved by `/proc/partition`."
18095 #. type: Labeled list
18096 #: ../misc-utils/lsfd.1.adoc:384
18098 msgid "PID <``number``>"
18101 #. type: Plain text
18102 #: ../misc-utils/lsfd.1.adoc:386
18103 msgid "PID of the process opening the file."
18106 #. type: Labeled list
18107 #: ../misc-utils/lsfd.1.adoc:387
18109 msgid "PIDFD.COMM <``string``>"
18112 #. type: Plain text
18113 #: ../misc-utils/lsfd.1.adoc:389
18114 msgid "Command of the process targeted by the pidfd."
18117 #. type: Labeled list
18118 #: ../misc-utils/lsfd.1.adoc:390
18120 msgid "PIDFD.NSPID <``string``>"
18123 #. type: Plain text
18124 #: ../misc-utils/lsfd.1.adoc:392
18125 msgid "Value of NSpid field in ``/proc/``_pid_``/fdinfo/``_fd_ of the pidfd."
18128 #. type: Plain text
18129 #: ../misc-utils/lsfd.1.adoc:394
18130 msgid "Quoted from kernel/fork.c of Linux source tree:"
18133 #. type: delimited block _
18134 #: ../misc-utils/lsfd.1.adoc:400
18136 "If pid namespaces are supported then this function will also print the pid "
18137 "of a given pidfd refers to for all descendant pid namespaces starting from "
18138 "the current pid namespace of the instance, i.e. the Pid field and the first "
18139 "entry in the NSpid field will be identical."
18142 #. type: delimited block _
18143 #: ../misc-utils/lsfd.1.adoc:404
18145 "Note that this differs from the Pid and NSpid fields in /proc/<pid>/status "
18146 "where Pid and NSpid are always shown relative to the pid namespace of the "
18150 #. type: Labeled list
18151 #: ../misc-utils/lsfd.1.adoc:406
18153 msgid "PIDFD.PID <``number``>"
18156 #. type: Plain text
18157 #: ../misc-utils/lsfd.1.adoc:408
18158 msgid "PID of the process targeted by the pidfd."
18161 #. type: Labeled list
18162 #: ../misc-utils/lsfd.1.adoc:409
18164 msgid "PING.ID <`number`>"
18167 #. type: Plain text
18168 #: ../misc-utils/lsfd.1.adoc:411
18169 msgid "ICMP echo request id used on the PING socket."
18172 #. type: Labeled list
18173 #: ../misc-utils/lsfd.1.adoc:412
18175 msgid "POS <``number``>"
18178 #. type: Plain text
18179 #: ../misc-utils/lsfd.1.adoc:414
18180 msgid "File position."
18183 #. type: Labeled list
18184 #: ../misc-utils/lsfd.1.adoc:415
18186 msgid "RAW.PROTOCOL <``number``>"
18189 #. type: Plain text
18190 #: ../misc-utils/lsfd.1.adoc:417
18191 msgid "Protocol number of the raw socket."
18194 #. type: Labeled list
18195 #: ../misc-utils/lsfd.1.adoc:418
18197 msgid "RDEV <``string``>"
18200 #. type: Plain text
18201 #: ../misc-utils/lsfd.1.adoc:420
18202 msgid "Device ID (if special file)."
18205 #. type: Labeled list
18206 #: ../misc-utils/lsfd.1.adoc:421
18208 #| msgid "*ENV_PATH* (string)"
18209 msgid "SIGNALFD.MASK <``string``>"
18210 msgstr "*ENV_PATH* (řetězec)"
18212 #. type: Plain text
18213 #: ../misc-utils/lsfd.1.adoc:423
18214 msgid "Masked signals."
18217 #. type: Labeled list
18218 #: ../misc-utils/lsfd.1.adoc:424
18220 msgid "SIZE <``number``>"
18223 #. type: Plain text
18224 #: ../misc-utils/lsfd.1.adoc:426
18228 #. type: Labeled list
18229 #: ../misc-utils/lsfd.1.adoc:427
18231 msgid "SOCK.LISTENING <``boolean``>"
18234 #. type: Plain text
18235 #: ../misc-utils/lsfd.1.adoc:429
18236 msgid "Listening socket."
18239 #. type: Labeled list
18240 #: ../misc-utils/lsfd.1.adoc:430
18242 msgid "SOCK.NETS <``number``>"
18245 #. type: Plain text
18246 #: ../misc-utils/lsfd.1.adoc:432
18247 msgid "Inode identifying network namespace where the socket belongs to."
18250 #. type: Labeled list
18251 #: ../misc-utils/lsfd.1.adoc:433
18253 msgid "SOCK.PROTONAME <``string``>"
18256 #. type: Plain text
18257 #: ../misc-utils/lsfd.1.adoc:435
18258 msgid "Protocol name."
18261 #. type: Labeled list
18262 #: ../misc-utils/lsfd.1.adoc:436
18264 #| msgid "*ENV_PATH* (string)"
18265 msgid "SOCK.SHUTDOWN <``string``>"
18266 msgstr "*ENV_PATH* (řetězec)"
18268 #. type: Plain text
18269 #: ../misc-utils/lsfd.1.adoc:438
18270 msgid "Shutdown state of socket."
18273 #. type: Labeled list
18274 #: ../misc-utils/lsfd.1.adoc:439
18279 #. type: Plain text
18280 #: ../misc-utils/lsfd.1.adoc:443
18282 "If the first character is _r_, the receptions are allowed. If it is _-_, "
18283 "the receptions are disallowed. If it is _?_, the state is unknown."
18286 #. type: Labeled list
18287 #: ../misc-utils/lsfd.1.adoc:444
18292 #. type: Plain text
18293 #: ../misc-utils/lsfd.1.adoc:448
18295 "If the second character is _w_, the transmissions are allowed. If it is _-"
18296 "_, the transmissions are disallowed. If it is _?_, the state is unknown."
18299 #. type: Labeled list
18300 #: ../misc-utils/lsfd.1.adoc:449
18302 msgid "SOCK.STATE <``string``>"
18305 #. type: Plain text
18306 #: ../misc-utils/lsfd.1.adoc:451
18307 msgid "State of socket."
18310 #. type: Labeled list
18311 #: ../misc-utils/lsfd.1.adoc:452
18313 msgid "SOCK.TYPE <``string``>"
18316 #. type: Plain text
18317 #: ../misc-utils/lsfd.1.adoc:455
18319 "Type of socket. Here type means the second parameter of socket system call:"
18322 #. type: Plain text
18323 #: ../misc-utils/lsfd.1.adoc:457
18327 #. type: Plain text
18328 #: ../misc-utils/lsfd.1.adoc:458
18332 #. type: Plain text
18333 #: ../misc-utils/lsfd.1.adoc:459
18337 #. type: Plain text
18338 #: ../misc-utils/lsfd.1.adoc:460
18342 #. type: Plain text
18343 #: ../misc-utils/lsfd.1.adoc:461
18347 #. type: Plain text
18348 #: ../misc-utils/lsfd.1.adoc:462
18352 #. type: Plain text
18353 #: ../misc-utils/lsfd.1.adoc:463
18357 #. type: Labeled list
18358 #: ../misc-utils/lsfd.1.adoc:464
18360 msgid "SOURCE <``string``>"
18363 #. type: Plain text
18364 #: ../misc-utils/lsfd.1.adoc:466
18365 msgid "File system, partition, or device containing the file."
18368 #. type: Labeled list
18369 #: ../misc-utils/lsfd.1.adoc:467
18371 #| msgid "*ENV_PATH* (string)"
18372 msgid "STTYPE <``string``>"
18373 msgstr "*ENV_PATH* (řetězec)"
18375 #. type: Plain text
18376 #: ../misc-utils/lsfd.1.adoc:469
18378 "Raw file types returned from *stat*(2): BLK, CHR, DIR, FIFO, LINK, REG, "
18382 #. type: Labeled list
18383 #: ../misc-utils/lsfd.1.adoc:470
18385 msgid "TCP.LADDR <``string``>"
18388 #. type: Plain text
18389 #: ../misc-utils/lsfd.1.adoc:472
18390 msgid "Local L3 (INET.LADDR or INET6.LADDR) address and local TCP port."
18393 #. type: Labeled list
18394 #: ../misc-utils/lsfd.1.adoc:473
18396 msgid "TCP.LPORT <``number``>"
18399 #. type: Plain text
18400 #: ../misc-utils/lsfd.1.adoc:475
18401 msgid "Local TCP port."
18404 #. type: Labeled list
18405 #: ../misc-utils/lsfd.1.adoc:476
18407 msgid "TCP.RADDR <``string``>"
18410 #. type: Plain text
18411 #: ../misc-utils/lsfd.1.adoc:478
18412 msgid "Remote L3 (INET.RADDR or INET6.RADDR) address and remote TCP port."
18415 #. type: Labeled list
18416 #: ../misc-utils/lsfd.1.adoc:479
18418 msgid "TCP.RPORT <``number``>"
18421 #. type: Plain text
18422 #: ../misc-utils/lsfd.1.adoc:481
18423 msgid "Remote TCP port."
18426 #. type: Labeled list
18427 #: ../misc-utils/lsfd.1.adoc:482
18429 msgid "TID <``number``>"
18432 #. type: Plain text
18433 #: ../misc-utils/lsfd.1.adoc:484
18434 msgid "Thread ID of the process opening the file."
18437 #. type: Labeled list
18438 #: ../misc-utils/lsfd.1.adoc:485
18440 #| msgid "*ENV_PATH* (string)"
18441 msgid "TIMERFD.CLOCKID <``string``>"
18442 msgstr "*ENV_PATH* (řetězec)"
18444 #. type: Plain text
18445 #: ../misc-utils/lsfd.1.adoc:487
18449 #. type: Labeled list
18450 #: ../misc-utils/lsfd.1.adoc:488
18452 msgid "TIMERFD.INTERVAL <``number``>"
18455 #. type: Plain text
18456 #: ../misc-utils/lsfd.1.adoc:490
18460 #. type: Labeled list
18461 #: ../misc-utils/lsfd.1.adoc:491
18463 msgid "TIMERFD.REMAINING <``number``>"
18466 #. type: Plain text
18467 #: ../misc-utils/lsfd.1.adoc:493
18468 msgid "Remaining time."
18471 #. type: Labeled list
18472 #: ../misc-utils/lsfd.1.adoc:494
18474 msgid "PTMX.TTY-INDEX <``number``>"
18477 #. type: Plain text
18478 #: ../misc-utils/lsfd.1.adoc:496
18479 msgid "TTY index of the counterpart."
18482 #. type: Labeled list
18483 #: ../misc-utils/lsfd.1.adoc:497
18485 #| msgid "*ENV_PATH* (string)"
18486 msgid "TUN.IFACE <``string``>"
18487 msgstr "*ENV_PATH* (řetězec)"
18489 #. type: Plain text
18490 #: ../misc-utils/lsfd.1.adoc:499
18491 msgid "Network interface behind the tun device."
18494 #. type: Plain text
18495 #: ../misc-utils/lsfd.1.adoc:504
18497 "Cooked version of STTYPE. It is same as STTYPE with exceptions. For SOCK, "
18498 "print the value for SOCK.PROTONAME. For UNKN, print the value for "
18499 "AINODECLASS if SOURCE is anon_inodefs."
18502 #. type: Labeled list
18503 #: ../misc-utils/lsfd.1.adoc:505
18505 msgid "UDP.LADDR <``string``>"
18508 #. type: Plain text
18509 #: ../misc-utils/lsfd.1.adoc:507
18510 msgid "Local IP address and local UDP port."
18513 #. type: Labeled list
18514 #: ../misc-utils/lsfd.1.adoc:508
18516 msgid "UDP.LPORT <``number``>"
18519 #. type: Plain text
18520 #: ../misc-utils/lsfd.1.adoc:510 ../misc-utils/lsfd.1.adoc:522
18521 msgid "Local UDP port."
18524 #. type: Labeled list
18525 #: ../misc-utils/lsfd.1.adoc:511
18527 msgid "UDP.RADDR <``string``>"
18530 #. type: Plain text
18531 #: ../misc-utils/lsfd.1.adoc:513
18532 msgid "Remote IP address and remote UDP port."
18535 #. type: Labeled list
18536 #: ../misc-utils/lsfd.1.adoc:514
18538 msgid "UDP.RPORT <``number``>"
18541 #. type: Plain text
18542 #: ../misc-utils/lsfd.1.adoc:516 ../misc-utils/lsfd.1.adoc:528
18543 msgid "Remote UDP port."
18546 #. type: Labeled list
18547 #: ../misc-utils/lsfd.1.adoc:517
18549 msgid "UDPLITE.LADDR <``string``>"
18552 #. type: Plain text
18553 #: ../misc-utils/lsfd.1.adoc:519
18554 msgid "Local IP address and local UDPLite port."
18557 #. type: Labeled list
18558 #: ../misc-utils/lsfd.1.adoc:520
18560 msgid "UDPLITE.LPORT <``number``>"
18563 #. type: Labeled list
18564 #: ../misc-utils/lsfd.1.adoc:523
18566 msgid "UDPLITE.RADDR <``string``>"
18569 #. type: Plain text
18570 #: ../misc-utils/lsfd.1.adoc:525
18571 msgid "Remote IP address and remote UDPLite port."
18574 #. type: Labeled list
18575 #: ../misc-utils/lsfd.1.adoc:526
18577 msgid "UDPLITE.RPORT <``number``>"
18580 #. type: Labeled list
18581 #: ../misc-utils/lsfd.1.adoc:529
18583 msgid "UID <``number``>"
18586 #. type: Plain text
18587 #: ../misc-utils/lsfd.1.adoc:531
18588 msgid "User ID number."
18591 #. type: Labeled list
18592 #: ../misc-utils/lsfd.1.adoc:532
18594 msgid "UNIX.PATH <``string``>"
18597 #. type: Plain text
18598 #: ../misc-utils/lsfd.1.adoc:534
18599 msgid "Filesystem pathname for UNIX domain socket."
18602 #. type: Labeled list
18603 #: ../misc-utils/lsfd.1.adoc:535
18605 msgid "USER <``string``>"
18608 #. type: Plain text
18609 #: ../misc-utils/lsfd.1.adoc:537
18610 msgid "User of the process."
18613 #. type: Labeled list
18614 #: ../misc-utils/lsfd.1.adoc:538
18616 #| msgid "*ENV_PATH* (string)"
18617 msgid "XMODE <``string``>"
18618 msgstr "*ENV_PATH* (řetězec)"
18620 #. type: Plain text
18621 #: ../misc-utils/lsfd.1.adoc:542
18623 "Extended version of _MODE_. This column may grow; new letters may be "
18624 "appended to _XMODE_ when *lsfd* supports a new state of file descriptors and/"
18625 "or memory mappings."
18628 #. type: Labeled list
18629 #: ../misc-utils/lsfd.1.adoc:543
18634 #. type: Plain text
18635 #: ../misc-utils/lsfd.1.adoc:545
18636 msgid "opened of mapped for reading. This is also in _MODE_."
18639 #. type: Labeled list
18640 #: ../misc-utils/lsfd.1.adoc:546
18645 #. type: Plain text
18646 #: ../misc-utils/lsfd.1.adoc:548
18647 msgid "opened of mapped for writing. This is also in _MODE_."
18650 #. type: Labeled list
18651 #: ../misc-utils/lsfd.1.adoc:549
18656 #. type: Plain text
18657 #: ../misc-utils/lsfd.1.adoc:551
18658 msgid "mapped for executing the code. This is also in _MODE_."
18661 #. type: Labeled list
18662 #: ../misc-utils/lsfd.1.adoc:552
18667 #. type: Plain text
18668 #: ../misc-utils/lsfd.1.adoc:554
18669 msgid "deleted from the file system. See also _DELETED_."
18672 #. type: Labeled list
18673 #: ../misc-utils/lsfd.1.adoc:555
18678 #. type: Plain text
18679 #: ../misc-utils/lsfd.1.adoc:560
18681 "locked or leased. _l_ represents a read, a shared lock or a read lease. _L_ "
18682 "represents a write or an exclusive lock or a write lease. If both read/"
18683 "shared and write/exclusive locks or leases are taken by a file descriptor, "
18684 "_L_ is used as the flag."
18687 #. type: Labeled list
18688 #: ../misc-utils/lsfd.1.adoc:561
18693 #. type: Plain text
18694 #: ../misc-utils/lsfd.1.adoc:568
18696 "Multiplexed. If the file descriptor is targeted by a eventpoll file or "
18697 "classical system calls for multiplexing (select, pselect, poll, and ppoll), "
18698 "this bit flag is set. Note that if an invocation of the classical system "
18699 "calls is interrupted, *lsfd* may fail to mark _m_ on the file descriptors "
18700 "monitored by the invocation. See *restart_syscall*(2)."
18704 #: ../misc-utils/lsfd.1.adoc:569
18706 msgid "FILTER EXAMPLES"
18709 #. type: Plain text
18710 #: ../misc-utils/lsfd.1.adoc:574
18713 "*lsfd* has few options for filtering. In most of cases, what you should\n"
18714 "know is *-Q* (or *--filter*) option. Combined with *-o* (or\n"
18715 "*--output*) option, you can customize the output as you want.\n"
18718 #. TRANSLATORS: In the following messages, don't forget to add whitespace at the end!
18719 #. type: Labeled list
18720 #: ../misc-utils/lsfd.1.adoc:576
18722 msgid "List files associated with PID 1 and PID 2 processes: "
18725 #. type: delimited block .
18726 #: ../misc-utils/lsfd.1.adoc:579
18728 msgid "# lsfd -Q '(PID == 1) or (PID == 2)'\n"
18731 #. type: Labeled list
18732 #: ../misc-utils/lsfd.1.adoc:581 ../misc-utils/lsfd.1.adoc:606
18733 #: ../misc-utils/lsfd.1.adoc:616
18735 msgid "Do the same in an alternative way: "
18738 #. type: delimited block .
18739 #: ../misc-utils/lsfd.1.adoc:584
18741 msgid "# lsfd -Q '(PID == 1) || (PID == 2)'\n"
18744 #. type: Labeled list
18745 #: ../misc-utils/lsfd.1.adoc:586
18747 msgid "Do the same in a more efficient way: "
18750 #. type: delimited block .
18751 #: ../misc-utils/lsfd.1.adoc:589
18753 msgid "# lsfd --pid 1,2\n"
18756 #. type: Labeled list
18757 #: ../misc-utils/lsfd.1.adoc:591
18759 msgid "Whitescapes can be used instead of a comma: "
18762 #. type: delimited block .
18763 #: ../misc-utils/lsfd.1.adoc:594
18765 msgid "# lsfd --pid '1 2'\n"
18768 #. type: Labeled list
18769 #: ../misc-utils/lsfd.1.adoc:596
18771 msgid "Utilize *pidof*(1) for list the files associated with \"firefox\": "
18774 #. type: delimited block .
18775 #: ../misc-utils/lsfd.1.adoc:599
18777 msgid "# lsfd --pid \"$(pidof firefox)\"\n"
18780 #. type: Labeled list
18781 #: ../misc-utils/lsfd.1.adoc:601
18783 msgid "List the 1st file descriptor opened by PID 1 process: "
18786 #. type: delimited block .
18787 #: ../misc-utils/lsfd.1.adoc:604
18789 msgid "# lsfd -Q '(PID == 1) and (FD == 1)'\n"
18792 #. type: delimited block .
18793 #: ../misc-utils/lsfd.1.adoc:609
18795 msgid "# lsfd -Q '(PID == 1) && (FD == 1)'\n"
18798 #. type: Labeled list
18799 #: ../misc-utils/lsfd.1.adoc:611
18801 msgid "List all running executables: "
18804 #. type: delimited block .
18805 #: ../misc-utils/lsfd.1.adoc:614
18807 msgid "# lsfd -Q 'ASSOC == \"exe\"'\n"
18810 #. type: delimited block .
18811 #: ../misc-utils/lsfd.1.adoc:619
18813 msgid "# lsfd -Q 'ASSOC eq \"exe\"'\n"
18816 #. type: Labeled list
18817 #: ../misc-utils/lsfd.1.adoc:621
18819 msgid "Do the same but print only file names: "
18822 #. type: delimited block .
18823 #: ../misc-utils/lsfd.1.adoc:624
18825 msgid "# lsfd -o NAME -Q 'ASSOC eq \"exe\"' | sort -u\n"
18828 #. type: Labeled list
18829 #: ../misc-utils/lsfd.1.adoc:626
18831 msgid "List deleted files associated to processes: "
18834 #. type: delimited block .
18835 #: ../misc-utils/lsfd.1.adoc:629
18837 msgid "# lsfd -Q 'DELETED'\n"
18840 #. type: Labeled list
18841 #: ../misc-utils/lsfd.1.adoc:631
18843 msgid "List non-regular files: "
18846 #. type: delimited block .
18847 #: ../misc-utils/lsfd.1.adoc:634
18849 msgid "# lsfd -Q 'TYPE != \"REG\"'\n"
18852 #. type: Labeled list
18853 #: ../misc-utils/lsfd.1.adoc:636
18855 msgid "List block devices: "
18858 #. type: delimited block .
18859 #: ../misc-utils/lsfd.1.adoc:639
18861 msgid "# lsfd -Q 'DEVTYPE == \"blk\"'\n"
18864 #. type: Labeled list
18865 #: ../misc-utils/lsfd.1.adoc:641
18867 msgid "Do the same with TYPE column: "
18870 #. type: delimited block .
18871 #: ../misc-utils/lsfd.1.adoc:644
18873 msgid "# lsfd -Q 'TYPE == \"BLK\"'\n"
18876 #. type: Labeled list
18877 #: ../misc-utils/lsfd.1.adoc:646
18879 msgid "List files including \"dconf\" directory in their names: "
18882 #. type: delimited block .
18883 #: ../misc-utils/lsfd.1.adoc:649
18885 msgid "# lsfd -Q 'NAME =~ \".\\*/dconf/.*\"'\n"
18888 #. type: Labeled list
18889 #: ../misc-utils/lsfd.1.adoc:651
18891 msgid "List files opened in a QEMU virtual machine: "
18894 #. type: delimited block .
18895 #: ../misc-utils/lsfd.1.adoc:654
18897 msgid "# lsfd -Q '(COMMAND =~ \".\\*qemu.*\") and (FD >= 0)'\n"
18900 #. type: Labeled list
18901 #: ../misc-utils/lsfd.1.adoc:656
18903 msgid "Hide files associated to kernel threads: "
18906 #. type: delimited block .
18907 #: ../misc-utils/lsfd.1.adoc:659
18909 msgid "# lsfd -Q '!KTHREAD'\n"
18912 #. type: Labeled list
18913 #: ../misc-utils/lsfd.1.adoc:661
18915 msgid "List timerfd files expired within 0.5 seconds: "
18918 #. type: delimited block .
18919 #: ../misc-utils/lsfd.1.adoc:664
18921 msgid "# lsfd -Q '(TIMERFD.remaining < 0.5) and (TIMERFD.remaining > 0.0)'\n"
18925 #: ../misc-utils/lsfd.1.adoc:666
18927 msgid "COUNTER EXAMPLES"
18930 #. type: Labeled list
18931 #: ../misc-utils/lsfd.1.adoc:668
18933 msgid "Report the numbers of netlink socket descriptors and unix socket descriptors: "
18936 #. type: delimited block .
18937 #: ../misc-utils/lsfd.1.adoc:676
18940 "# lsfd --summary=only \\\n"
18941 "\t-C 'netlink sockets':'(NAME =~ \"NETLINK:.*\")' \\\n"
18942 "\t-C 'unix sockets':'(NAME =~ \"UNIX:.*\")'\n"
18944 " 57 netlink sockets\n"
18945 " 1552 unix sockets\n"
18948 #. type: Labeled list
18949 #: ../misc-utils/lsfd.1.adoc:678
18951 msgid "Do the same but print in JSON format: "
18954 #. type: delimited block .
18955 #: ../misc-utils/lsfd.1.adoc:694
18958 "# lsfd --summary=only --json \\\n"
18959 "\t-C 'netlink sockets':'(NAME =~ \"NETLINK:.*\")' \\\n"
18960 "\t-C 'unix sockets':'(NAME =~ \"UNIX:.*\")'\n"
18962 " \"lsfd-summary\": [\n"
18964 "\t \"value\": 15,\n"
18965 "\t \"counter\": \"netlink sockets\"\n"
18967 "\t \"value\": 798,\n"
18968 "\t \"counter\": \"unix sockets\"\n"
18974 #. type: Plain text
18975 #: ../misc-utils/lsfd.1.adoc:700
18976 msgid "The *lsfd* command is part of the util-linux package since v2.38."
18979 #. type: Plain text
18980 #: ../misc-utils/lsfd.1.adoc:705
18982 "mailto:yamato@redhat.com[Masatake YAMATO], mailto:kzak@redhat.com[Karel Zak]"
18985 #. type: Plain text
18986 #: ../misc-utils/lsfd.1.adoc:717
18995 "*scols-filter*(5)\n"
19001 #. Man page for the lslocks command.
19002 #. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
19003 #. May be distributed under the GNU General Public License
19004 #. Copyright 1994 Salvatore Valente (svalente@mit.edu)
19005 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
19006 #. May be distributed under the GNU General Public License
19008 #: ../misc-utils/lslocks.8.adoc:12
19013 #. type: Plain text
19014 #: ../misc-utils/lslocks.8.adoc:23
19015 msgid "lslocks - list local system locks"
19018 #. type: Plain text
19019 #: ../misc-utils/lslocks.8.adoc:27
19021 msgid "*lslocks* [options]\n"
19024 #. type: Plain text
19025 #: ../misc-utils/lslocks.8.adoc:31
19027 msgid "*lslocks* lists information about all the currently held file locks in a Linux system.\n"
19030 #. type: Labeled list
19031 #: ../misc-utils/lslocks.8.adoc:40
19033 msgid "*-i*, *--noinaccessible*"
19036 #. type: Plain text
19037 #: ../misc-utils/lslocks.8.adoc:42
19038 msgid "Ignore lock files which are inaccessible for the current user."
19041 #. TRANSLATORS: Keep {plus} untranslated.
19042 #. type: Plain text
19043 #: ../misc-utils/lslocks.8.adoc:53
19045 "The default list of columns may be extended if _list_ is specified in the "
19046 "format _{plus}list_ (e.g., *lslocks -o {plus}BLOCKER*)."
19049 #. type: Labeled list
19050 #: ../misc-utils/lslocks.8.adoc:58 ../sys-utils/choom.1.adoc:25
19052 #| msgid "*-P*, *--pty*"
19053 msgid "*-p*, *--pid* _pid_"
19054 msgstr "*-P*, *--pty*"
19056 #. type: Plain text
19057 #: ../misc-utils/lslocks.8.adoc:60
19058 msgid "Display only the locks held by the process with this _pid_."
19061 #. type: Plain text
19062 #: ../misc-utils/lslocks.8.adoc:63 ../misc-utils/uuidparse.1.adoc:61
19063 #: ../sys-utils/lsns.8.adoc:60 ../sys-utils/prlimit.1.adoc:54
19064 #: ../sys-utils/rfkill.8.adoc:41 ../sys-utils/wdctl.8.adoc:56
19065 msgid "Use the raw output format."
19068 #. type: Plain text
19069 #: ../misc-utils/lslocks.8.adoc:66 ../sys-utils/lsns.8.adoc:66
19070 msgid "Do not truncate text in columns."
19073 #. type: Labeled list
19074 #: ../misc-utils/lslocks.8.adoc:71
19079 #. type: Plain text
19080 #: ../misc-utils/lslocks.8.adoc:73
19081 msgid "The command name of the process holding the lock."
19084 #. type: Labeled list
19085 #: ../misc-utils/lslocks.8.adoc:74
19090 #. type: Plain text
19091 #: ../misc-utils/lslocks.8.adoc:76
19092 msgid "The process ID of the process."
19095 #. type: Labeled list
19096 #: ../misc-utils/lslocks.8.adoc:77
19101 #. type: Plain text
19102 #: ../misc-utils/lslocks.8.adoc:79
19104 "The type of lock; can be LEASE (created with *fcntl*(2)), FLOCK (created "
19105 "with *flock*(2)), POSIX (created with *fcntl*(2) and *lockf*(3)) or OFDLCK "
19106 "(created with *fcntl*(2))."
19109 #. type: Labeled list
19110 #: ../misc-utils/lslocks.8.adoc:80
19115 #. type: Plain text
19116 #: ../misc-utils/lslocks.8.adoc:82
19117 msgid "Size of the locked file."
19120 #. type: Labeled list
19121 #: ../misc-utils/lslocks.8.adoc:83
19126 #. type: Plain text
19127 #: ../misc-utils/lslocks.8.adoc:85
19128 msgid "The inode number."
19131 #. type: Labeled list
19132 #: ../misc-utils/lslocks.8.adoc:86
19137 #. type: Plain text
19138 #: ../misc-utils/lslocks.8.adoc:88
19139 msgid "The major:minor device number."
19142 #. type: Labeled list
19143 #: ../misc-utils/lslocks.8.adoc:89
19148 #. type: Plain text
19149 #: ../misc-utils/lslocks.8.adoc:91
19151 "The lock's access permissions (read, write). If the process is blocked and "
19152 "waiting for the lock, then the mode is postfixed with an '*' (asterisk)."
19155 #. type: Labeled list
19156 #: ../misc-utils/lslocks.8.adoc:92
19161 #. type: Plain text
19162 #: ../misc-utils/lslocks.8.adoc:94
19164 "Whether the lock is mandatory; 0 means no (meaning the lock is only "
19165 "advisory), 1 means yes. (See *fcntl*(2).)"
19168 #. type: Labeled list
19169 #: ../misc-utils/lslocks.8.adoc:95
19174 #. type: Plain text
19175 #: ../misc-utils/lslocks.8.adoc:97
19176 msgid "Relative byte offset of the lock."
19179 #. type: Labeled list
19180 #: ../misc-utils/lslocks.8.adoc:98
19185 #. type: Plain text
19186 #: ../misc-utils/lslocks.8.adoc:100
19187 msgid "Ending offset of the lock."
19190 #. type: Labeled list
19191 #: ../misc-utils/lslocks.8.adoc:101
19196 #. type: Plain text
19197 #: ../misc-utils/lslocks.8.adoc:103
19199 "Full path of the lock. If none is found, or there are no permissions to read "
19200 "the path, it will fall back to the device's mountpoint and \"...\" is "
19201 "appended to the path. The path might be truncated; use *--notruncate* to get "
19205 #. type: Labeled list
19206 #: ../misc-utils/lslocks.8.adoc:104
19211 #. type: Plain text
19212 #: ../misc-utils/lslocks.8.adoc:106
19213 msgid "The PID of the process which blocks the lock."
19216 #. type: Labeled list
19217 #: ../misc-utils/lslocks.8.adoc:107
19222 #. type: Plain text
19223 #: ../misc-utils/lslocks.8.adoc:111
19225 "The holder(s) of the lock. The format of the holder is _PID_,_COMMAND_,"
19226 "_FD_. If a lock is an open file description-oriented lock, there can be "
19227 "more than one holder for the lock. See the NOTES below."
19230 #. type: Plain text
19231 #: ../misc-utils/lslocks.8.adoc:115
19233 "The *lslocks* command is meant to replace the *lslk*(8) command, originally "
19234 "written by mailto:abe@purdue.edu[Victor A. Abell] and unmaintained since "
19238 #. type: Plain text
19239 #: ../misc-utils/lslocks.8.adoc:122
19241 "\"The process holding the lock\" for leases, FLOCK locks, and OFD locks is a "
19242 "fake-concept. They are associated with the open file description on which "
19243 "they are acquired. With *fork*(2) and/or *cmsg*(3), multiple processes can "
19244 "share an open file description. So the holder process of a lease (or a lock) "
19245 "is not uniquely determined. *lslocks* shows the one of the holder processes "
19246 "in COMMAND and PID columns."
19249 #. type: Plain text
19250 #: ../misc-utils/lslocks.8.adoc:126
19251 msgid "mailto:dave@gnu.org[Davidlohr Bueso]"
19254 #. type: Plain text
19255 #: ../misc-utils/lslocks.8.adoc:132
19271 #. Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu)
19273 #: ../misc-utils/mcookie.1.adoc:4
19278 #. type: Plain text
19279 #: ../misc-utils/mcookie.1.adoc:14
19280 msgid "mcookie - generate magic cookies for xauth"
19283 #. type: Plain text
19284 #: ../misc-utils/mcookie.1.adoc:18
19286 msgid "*mcookie* [options]\n"
19289 #. type: Plain text
19290 #: ../misc-utils/mcookie.1.adoc:22
19292 msgid "*mcookie* generates a 128-bit random hexadecimal number for use with the X authority system. Typical usage:\n"
19295 #. type: delimited block _
19296 #: ../misc-utils/mcookie.1.adoc:25
19298 msgid "*xauth add :0 . `mcookie`*\n"
19301 #. type: Plain text
19302 #: ../misc-utils/mcookie.1.adoc:28
19304 "The \"random\" number generated is actually the MD5 message digest of random "
19305 "information coming from one of the sources *getrandom*(2) system call, _/dev/"
19306 "urandom_, _/dev/random_, or the _libc pseudo-random functions_, in this "
19307 "preference order. See also the option *--file*."
19310 #. type: Plain text
19311 #: ../misc-utils/mcookie.1.adoc:33
19313 "Use this _file_ as an additional source of randomness (for example _/dev/"
19314 "urandom_). When _file_ is '-', characters are read from standard input."
19317 #. type: Labeled list
19318 #: ../misc-utils/mcookie.1.adoc:34
19320 msgid "*-m*, *--max-size* _number_"
19323 #. type: Plain text
19324 #: ../misc-utils/mcookie.1.adoc:36
19326 "Read from _file_ only this _number_ of bytes. This option is meant to be "
19327 "used when reading additional randomness from a file or device."
19330 #. type: Plain text
19331 #: ../misc-utils/mcookie.1.adoc:38
19333 "The _number_ argument may be followed by the multiplicative suffixes "
19334 "KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "
19335 "\"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
19336 "suffixes KB=1000, MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB."
19339 #. type: Plain text
19340 #: ../misc-utils/mcookie.1.adoc:41
19342 "Inform where randomness originated, with amount of entropy read from each "
19346 #. type: Plain text
19347 #: ../misc-utils/mcookie.1.adoc:47
19348 msgid "_/dev/urandom_"
19351 #. type: Plain text
19352 #: ../misc-utils/mcookie.1.adoc:49
19353 msgid "_/dev/random_"
19356 #. type: Plain text
19357 #: ../misc-utils/mcookie.1.adoc:53
19358 msgid "It is assumed that none of the randomness sources will block."
19361 #. type: Plain text
19362 #: ../misc-utils/mcookie.1.adoc:60
19372 #: ../misc-utils/namei.1.adoc:2
19377 #. type: Plain text
19378 #: ../misc-utils/namei.1.adoc:12
19379 msgid "namei - follow a pathname until a terminal point is found"
19382 #. type: Plain text
19383 #: ../misc-utils/namei.1.adoc:16
19385 msgid "*namei* [options] _pathname_...\n"
19388 #. type: Plain text
19389 #: ../misc-utils/namei.1.adoc:20
19391 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"
19394 #. type: Plain text
19395 #: ../misc-utils/namei.1.adoc:22
19397 "This program is useful for finding \"too many levels of symbolic links\" "
19401 #. type: Plain text
19402 #: ../misc-utils/namei.1.adoc:24
19404 "For each line of output, *namei* uses the following characters to identify "
19405 "the file type found:"
19408 #. type: delimited block .
19409 #: ../misc-utils/namei.1.adoc:35
19412 " f: = the pathname currently being resolved\n"
19414 " l = symbolic link (both the link and its contents are output)\n"
19416 " b = block device\n"
19417 " c = character device\n"
19418 " p = FIFO (named pipe)\n"
19419 " - = regular file\n"
19420 " ? = an error of some kind\n"
19423 #. type: Plain text
19424 #: ../misc-utils/namei.1.adoc:38
19426 msgid "*namei* prints an informative message when the maximum number of symbolic links this system can have has been exceeded.\n"
19429 #. type: Labeled list
19430 #: ../misc-utils/namei.1.adoc:41
19432 #| msgid "*-*, *-l*, *--login*"
19433 msgid "*-l*, *--long*"
19434 msgstr "*-*, *-l*, *--login*"
19436 #. type: Plain text
19437 #: ../misc-utils/namei.1.adoc:43
19438 msgid "Use the long listing format (same as *-m -o -v*)."
19441 #. type: Labeled list
19442 #: ../misc-utils/namei.1.adoc:44
19444 #| msgid "*-h*, *--help*"
19445 msgid "*-m*, *--modes*"
19446 msgstr "*-h*, *--help*"
19448 #. type: Plain text
19449 #: ../misc-utils/namei.1.adoc:46
19451 "Show the mode bits of each file type in the style of *ls*(1), for example "
19455 #. type: Labeled list
19456 #: ../misc-utils/namei.1.adoc:47
19458 #| msgid "*-V*, *--version*"
19459 msgid "*-n*, *--nosymlinks*"
19460 msgstr "*-V*, *--version*"
19462 #. type: Plain text
19463 #: ../misc-utils/namei.1.adoc:49
19464 msgid "Don't follow symlinks."
19467 #. type: Labeled list
19468 #: ../misc-utils/namei.1.adoc:50
19470 #| msgid "*-V*, *--version*"
19471 msgid "*-o*, *--owners*"
19472 msgstr "*-V*, *--version*"
19474 #. type: Plain text
19475 #: ../misc-utils/namei.1.adoc:52
19476 msgid "Show owner and group name of each file."
19479 #. type: Plain text
19480 #: ../misc-utils/namei.1.adoc:55
19481 msgid "Vertically align the modes and owners."
19484 #. type: Labeled list
19485 #: ../misc-utils/namei.1.adoc:56
19487 #| msgid "*-P*, *--pty*"
19488 msgid "*-x*, *--mountpoints*"
19489 msgstr "*-P*, *--pty*"
19491 #. type: Plain text
19492 #: ../misc-utils/namei.1.adoc:58
19493 msgid "Show mountpoint directories with a 'D' rather than a 'd'."
19496 #. type: Plain text
19497 #: ../misc-utils/namei.1.adoc:62
19499 "Show security context of the file or \"?\" if not available. The support "
19500 "for security contexts is optional and does not have to be compiled to the "
19504 #. type: Plain text
19505 #: ../misc-utils/namei.1.adoc:68
19506 msgid "To be discovered."
19509 #. type: Plain text
19510 #: ../misc-utils/namei.1.adoc:72
19512 "The original *namei* program was written by mailto:rogers@amadeus.wr.tek."
19513 "com[Roger Southwick]."
19516 #. type: Plain text
19517 #: ../misc-utils/namei.1.adoc:74
19519 "The program was rewritten by Karel Zak mailto:kzak@redhat.com[Karel Zak]."
19522 #. type: Plain text
19523 #: ../misc-utils/namei.1.adoc:80
19539 #: ../misc-utils/pipesz.1.adoc:2
19544 #. type: Plain text
19545 #: ../misc-utils/pipesz.1.adoc:12
19546 msgid "pipesz - set or examine pipe and FIFO buffer sizes"
19549 #. type: Plain text
19550 #: ../misc-utils/pipesz.1.adoc:16
19552 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
19553 msgid "*pipesz* [options] [--set _size_] [--] [_command_ [argument] ...]\n"
19554 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
19556 #. type: Plain text
19557 #: ../misc-utils/pipesz.1.adoc:18
19559 msgid "*pipesz* [options] --get\n"
19562 #. type: Plain text
19563 #: ../misc-utils/pipesz.1.adoc:22
19565 "Pipes and FIFOs maintain an internal buffer used to transfer data between "
19566 "the read end and the write end. In some cases, the default size of this "
19567 "internal buffer may not be appropriate. This program provides facilities to "
19568 "set and examine the size of these buffers."
19571 #. type: Plain text
19572 #: ../misc-utils/pipesz.1.adoc:24
19574 "The *--set* operation sets pipe buffer sizes. If it is specified, it must be "
19575 "specified with an explicit _size_. Otherwise, it is implied and the size is "
19576 "read from */proc/sys/fs/pipe-max-size*. The kernel may adjust _size_ as "
19577 "described in *fcntl*(2). To determine the actual buffer sizes set, use the "
19578 "*--verbose* option. If neither *--file* nor *--fd* are specified, *--set* "
19579 "acts on standard output."
19582 #. type: Plain text
19583 #: ../misc-utils/pipesz.1.adoc:26
19585 "The *--set* operation permits an optional _command_ to execute after setting "
19586 "the pipe buffer sizes. This command is executed with the adjusted pipes."
19589 #. type: Plain text
19590 #: ../misc-utils/pipesz.1.adoc:28
19592 "The *--get* operation outputs data in a tabular format. The first column is "
19593 "the name of the pipe as passed to *pipesz*. File descriptors are named as "
19594 "\"fd _N_\". The second column is the size, in bytes, of the pipe's internal "
19595 "buffer. The third column is the number of unread bytes currently in the "
19596 "pipe. The columns are separated by tabs ('\\t', ASCII 09h). If *--verbose* "
19597 "is specified, a descriptive header is also emitted. If neither *--file* nor "
19598 "*--fd* are specified, *--get* acts on standard input."
19601 #. type: Plain text
19602 #: ../misc-utils/pipesz.1.adoc:30
19604 "Unless the *--check* option is specified, *pipesz* does _not_ exit if it "
19605 "encounters an error while manipulating a file or file descriptor. This "
19606 "allows *pipesz* to be used generically without fear of disrupting the "
19607 "execution of pipelines should the type of certain files be later changed. "
19608 "For minimal disruption, the *--quiet* option prevents warnings from being "
19609 "emitted in these cases."
19612 #. type: Plain text
19613 #: ../misc-utils/pipesz.1.adoc:32
19615 "The kernel imposes limits on the amount of pipe buffer space unprivileged "
19616 "processes can use, though see *BUGS* below. The kernel will also refuse to "
19617 "shrink a pipe buffer if this would cause a loss of buffered data. See "
19618 "*pipe*(7) for additional details."
19621 #. type: Plain text
19622 #: ../misc-utils/pipesz.1.adoc:34
19624 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"
19627 #. type: Labeled list
19628 #: ../misc-utils/pipesz.1.adoc:37
19630 #| msgid "*-P*, *--pty*"
19631 msgid "*-g*, *--get*"
19632 msgstr "*-P*, *--pty*"
19634 #. type: Plain text
19635 #: ../misc-utils/pipesz.1.adoc:39
19637 "Report the size of pipe buffers to standard output and exit. As a special "
19638 "behavior, if neither *--file* nor *--fd* are specified, standard input is "
19639 "examined. It is an error to specify this option in combination with *--set*."
19642 #. type: Labeled list
19643 #: ../misc-utils/pipesz.1.adoc:40
19645 #| msgid "*-s*, **--shell**=__shell__"
19646 msgid "*-s*, *--set* _size_"
19647 msgstr "*-s*, **--shell**=__shell__"
19649 #. type: Plain text
19650 #: ../misc-utils/pipesz.1.adoc:42
19652 "Set the size of the pipe buffers, in bytes. This option may be suffixed by "
19653 "_K_, _M_, _G_, _KiB_, _MiB_, or _GiB_ to indicate multiples of 1024. "
19654 "Fractional values are supported in this case. Additional suffixes are "
19655 "supported but are unlikely to be useful. If this option is not specified, a "
19656 "default value is used, as described above. If this option is specified "
19657 "multiple times, a warning is emitted and only the last-specified _size_ is "
19658 "used. As a special behavior, if neither *--file* nor *--fd* are specified, "
19659 "standard output is adjusted. It is an error to specify this option in "
19660 "combination with *--get*."
19663 #. type: Labeled list
19664 #: ../misc-utils/pipesz.1.adoc:43
19666 #| msgid "*-P*, *--pty*"
19667 msgid "*-f*, *--file* _path_"
19668 msgstr "*-P*, *--pty*"
19670 #. type: Plain text
19671 #: ../misc-utils/pipesz.1.adoc:45
19673 "Set the buffer size of the FIFO or pipe at _path_, relative to the current "
19674 "working directory. You may specify this option multiple times to affect "
19675 "different files, and you may do so in combination with *--fd*. Generally, "
19676 "this option is used with FIFOs, but it will also operate on anonymous pipes "
19677 "such as those found in */proc/PID/fd*. Changes to the buffer size of FIFOs "
19678 "are not preserved across system restarts."
19681 #. type: Labeled list
19682 #: ../misc-utils/pipesz.1.adoc:46
19684 #| msgid "*-P*, *--pty*"
19685 msgid "*-n*, *--fd* _fd_"
19686 msgstr "*-P*, *--pty*"
19688 #. type: Plain text
19689 #: ../misc-utils/pipesz.1.adoc:48
19691 "Set the buffer size of the pipe or FIFO passed to *pipesz* as the specified "
19692 "file descriptor number. You may specify this option multiple times to affect "
19693 "different file descriptors, and you may do so in combination with *--file*. "
19694 "Shorthand options are provided for the common cases of fd 0 (stdin), fd 1 "
19695 "(stdout), and fd 2 (stderr). These should suffice in most cases."
19698 #. type: Labeled list
19699 #: ../misc-utils/pipesz.1.adoc:49
19701 #| msgid "*-f*, *--fast*"
19702 msgid "*-i*, *--stdin*"
19703 msgstr "*-f*, *--fast*"
19705 #. type: Plain text
19706 #: ../misc-utils/pipesz.1.adoc:51
19707 msgid "Shorthand for *--fd 0*."
19710 #. type: Labeled list
19711 #: ../misc-utils/pipesz.1.adoc:52
19713 #| msgid "*-P*, *--pty*"
19714 msgid "*-o*, *--stdout*"
19715 msgstr "*-P*, *--pty*"
19717 #. type: Plain text
19718 #: ../misc-utils/pipesz.1.adoc:54
19719 msgid "Shorthand for *--fd 1*."
19722 #. type: Labeled list
19723 #: ../misc-utils/pipesz.1.adoc:55
19725 #| msgid "*-f*, *--fast*"
19726 msgid "*-e*, *--stderr*"
19727 msgstr "*-f*, *--fast*"
19729 #. type: Plain text
19730 #: ../misc-utils/pipesz.1.adoc:57
19731 msgid "Shorthand for *--fd 2*."
19734 #. type: Plain text
19735 #: ../misc-utils/pipesz.1.adoc:60
19737 "Exit, without executing _command_, in case of any error while manipulating a "
19738 "file or file descriptor. The default behavior if this is not specified is to "
19739 "emit a warning to standard error and continue."
19742 #. type: Plain text
19743 #: ../misc-utils/pipesz.1.adoc:63
19745 "Do not diagnose non-fatal errors to standard error. This option does not "
19746 "affect the normal output of *--get*, *--verbose*, *--help*, or *--version*."
19749 #. type: Plain text
19750 #: ../misc-utils/pipesz.1.adoc:66
19752 "If specified with *--get*, *pipesz* will emit a descriptive header above the "
19753 "table. Otherwise, if specified, *pipesz* will print the actual buffer sizes "
19754 "set by the kernel to standard error."
19757 #. type: Labeled list
19758 #: ../misc-utils/pipesz.1.adoc:71
19760 msgid "*pipesz* *dd* if=_file_ bs=1M | ..."
19763 #. type: Plain text
19764 #: ../misc-utils/pipesz.1.adoc:73
19766 "Runs *dd*(1) with an expanded standard output pipe, allowing it to avoid "
19767 "context switches when piping around large blocks."
19770 #. type: Labeled list
19771 #: ../misc-utils/pipesz.1.adoc:74
19773 msgid "*pipesz* -s1M -cf _/run/my-service.fifo_"
19776 #. type: Plain text
19777 #: ../misc-utils/pipesz.1.adoc:76
19779 "Sets the pipe buffer size of a service FIFO to 1,048,576 bytes. If the "
19780 "buffer size could not be set, *pipesz* exits with an error."
19783 #. type: Labeled list
19784 #: ../misc-utils/pipesz.1.adoc:77
19786 msgid "*echo* hello | *pipesz* -g"
19789 #. type: Plain text
19790 #: ../misc-utils/pipesz.1.adoc:79
19792 "Prints the size of pipe used by the shell to pass input to *pipesz*. Since "
19793 "*pipesz* does not read standard input, it may also report 6 unread bytes in "
19794 "the pipe, depending on relative timings."
19797 #. type: Labeled list
19798 #: ../misc-utils/pipesz.1.adoc:80
19800 msgid "*find* /proc/_PID_/fd -exec *pipesz* -gqf '{}' ';'"
19803 #. type: Plain text
19804 #: ../misc-utils/pipesz.1.adoc:82
19806 "Prints the size and number of unread bytes of all pipes in use by _PID_. If "
19807 "some pipes are routinely full, *pipesz* might be able to mitigate a "
19808 "processing bottleneck."
19811 #. type: Plain text
19812 #: ../misc-utils/pipesz.1.adoc:86
19814 "Linux supports adjusting the size of pipe buffers since kernel 2.6.35. This "
19815 "release also introduced */proc/sys/fs/pipe-max-size*."
19818 #. type: Plain text
19819 #: ../misc-utils/pipesz.1.adoc:88
19821 "This program uses *fcntl*(2) *F_GETPIPE_SZ*/*F_SETPIPE_SZ* to get and set "
19822 "pipe buffer sizes."
19825 #. type: Plain text
19826 #: ../misc-utils/pipesz.1.adoc:90
19828 "This program uses *ioctl*(2) *FIONREAD* to report the amount of unread data "
19829 "in pipes. If for some reason this fails, the amount of unread data is "
19833 #. type: Plain text
19834 #: ../misc-utils/pipesz.1.adoc:94
19836 "Before Linux 4.9, some bugs affect how certain resource limits are enforced "
19837 "when setting pipe buffer sizes. See *pipe*(7) for details."
19840 #. type: Plain text
19841 #: ../misc-utils/pipesz.1.adoc:98
19842 msgid "mailto:nwsharp@live.com[Nathan Sharp]"
19845 #. type: Plain text
19846 #: ../misc-utils/pipesz.1.adoc:102
19848 msgid "*pipe*(7)\n"
19851 #. Written by Andries E. Brouwer (aeb@cwi.nl)
19852 #. Placed in the public domain
19854 #: ../misc-utils/rename.1.adoc:4
19859 #. type: Plain text
19860 #: ../misc-utils/rename.1.adoc:14
19861 msgid "rename - rename files"
19864 #. type: Plain text
19865 #: ../misc-utils/rename.1.adoc:18
19867 msgid "*rename* [options] _expression replacement file_...\n"
19870 #. type: Plain text
19871 #: ../misc-utils/rename.1.adoc:22
19873 msgid "*rename* will rename the specified files by replacing the first occurrence of _expression_ in their name by _replacement_.\n"
19876 #. type: Labeled list
19877 #: ../misc-utils/rename.1.adoc:25
19879 #| msgid "*-V*, *--version*"
19880 msgid "*-s*, *--symlink*"
19881 msgstr "*-V*, *--version*"
19883 #. type: Plain text
19884 #: ../misc-utils/rename.1.adoc:27
19885 msgid "Do not rename a symlink but change where it points."
19888 #. type: Plain text
19889 #: ../misc-utils/rename.1.adoc:30
19890 msgid "Show which files were renamed, if any."
19893 #. type: Plain text
19894 #: ../misc-utils/rename.1.adoc:33
19895 msgid "Do not make any changes; add *--verbose* to see what would be made."
19898 #. type: Plain text
19899 #: ../misc-utils/rename.1.adoc:36
19900 msgid "Replace all occurrences of _expression_ rather than only the first one."
19903 #. type: Labeled list
19904 #: ../misc-utils/rename.1.adoc:37
19906 #| msgid "*-f*, *--fast*"
19907 msgid "*-l*, *--last*"
19908 msgstr "*-f*, *--fast*"
19910 #. type: Plain text
19911 #: ../misc-utils/rename.1.adoc:39
19912 msgid "Replace the last occurrence of _expression_ rather than the first one."
19915 #. type: Labeled list
19916 #: ../misc-utils/rename.1.adoc:40
19918 #| msgid "*-V*, *--version*"
19919 msgid "*-o*, *--no-overwrite*"
19920 msgstr "*-V*, *--version*"
19922 #. type: Plain text
19923 #: ../misc-utils/rename.1.adoc:42
19925 "Do not overwrite existing files. When *--symlink* is active, do not "
19926 "overwrite symlinks pointing to existing targets."
19929 #. type: Labeled list
19930 #: ../misc-utils/rename.1.adoc:43
19932 #| msgid "*-V*, *--version*"
19933 msgid "*-i*, *--interactive*"
19934 msgstr "*-V*, *--version*"
19936 #. type: Plain text
19937 #: ../misc-utils/rename.1.adoc:45
19938 msgid "Ask before overwriting existing files."
19941 #. type: Plain text
19942 #: ../misc-utils/rename.1.adoc:51
19944 "The renaming has no safeguards by default or without any one of the options "
19945 "*--no-overwrite*, *--interactive* or *--no-act*. If the user has permission "
19946 "to rewrite file names, the command will perform the action without any "
19947 "questions. For example, the result can be quite drastic when the command is "
19948 "run as root in the _/lib_ directory. Always make a backup before running the "
19949 "command, unless you truly know what you are doing."
19953 #: ../misc-utils/rename.1.adoc:52
19958 #. type: Plain text
19959 #: ../misc-utils/rename.1.adoc:55
19961 "If the _expression_ is empty, then by default _replacement_ will be added to "
19962 "the start of the filename. With *--all*, _replacement_ will be inserted in "
19963 "between every two characters of the filename, as well as at the start and "
19967 #. type: Plain text
19968 #: ../misc-utils/rename.1.adoc:57
19970 "Normally, only the final path component of a filename is updated. (Or with "
19971 "*--symlink*, only the final path component of the link.) But if either "
19972 "_expression_ or _replacement_ contains a _/_, the full path is updated. This "
19973 "can cause a file to be moved between folders. Creating folders, and moving "
19974 "files between filesystems, is not supported."
19978 #: ../misc-utils/rename.1.adoc:58
19980 msgid "INTERACTIVE MODE"
19983 #. type: Plain text
19984 #: ../misc-utils/rename.1.adoc:61
19986 "As most standard utilities rename can be used with a terminal device (tty in "
19987 "short) in canonical mode, where the line is buffered by the tty and you "
19988 "press ENTER to validate the user input. If you put your tty in cbreak mode "
19989 "however, rename requires only a single key press to answer the prompt. To "
19990 "set cbreak mode, run for example:"
19993 #. type: delimited block .
19994 #: ../misc-utils/rename.1.adoc:64
19996 msgid "sh -c 'stty -icanon min 1; \"$0\" \"$@\"; stty icanon' rename -i from to files\n"
19999 #. type: Plain text
20000 #: ../misc-utils/rename.1.adoc:70
20001 msgid "all requested rename operations were successful"
20004 #. type: Plain text
20005 #: ../misc-utils/rename.1.adoc:73
20006 msgid "all rename operations failed"
20009 #. type: Plain text
20010 #: ../misc-utils/rename.1.adoc:76
20011 msgid "some rename operations failed"
20014 #. type: Plain text
20015 #: ../misc-utils/rename.1.adoc:79
20016 msgid "nothing was renamed"
20019 #. type: Plain text
20020 #: ../misc-utils/rename.1.adoc:82
20021 msgid "unanticipated error occurred"
20024 #. type: Plain text
20025 #: ../misc-utils/rename.1.adoc:86
20027 "Given the files _foo1_, ..., _foo9_, _foo10_, ..., _foo278_, the commands"
20030 #. type: delimited block .
20031 #: ../misc-utils/rename.1.adoc:90
20034 "rename foo foo00 foo?\n"
20035 "rename foo foo0 foo??\n"
20038 #. type: Plain text
20039 #: ../misc-utils/rename.1.adoc:93
20041 "will turn them into _foo001_, ..., _foo009_, _foo010_, ..., _foo278_. And"
20044 #. type: delimited block .
20045 #: ../misc-utils/rename.1.adoc:96
20047 msgid "rename .htm .html *.htm\n"
20050 #. type: Plain text
20051 #: ../misc-utils/rename.1.adoc:99
20053 "will fix the extension of your html files. Provide an empty string for "
20057 #. type: delimited block .
20058 #: ../misc-utils/rename.1.adoc:102
20060 msgid "rename '_with_long_name' '' file_with_long_name.*\n"
20063 #. type: Plain text
20064 #: ../misc-utils/rename.1.adoc:105
20065 msgid "will remove the substring in the filenames."
20068 #. type: Plain text
20069 #: ../misc-utils/rename.1.adoc:109
20074 #. Copyright 2007 by Theodore Ts'o. All Rights Reserved.
20075 #. This file may be copied under the terms of the GNU Public License.
20077 #: ../misc-utils/uuidd.8.adoc:6
20082 #. type: Plain text
20083 #: ../misc-utils/uuidd.8.adoc:16
20084 msgid "uuidd - UUID generation daemon"
20087 #. type: Plain text
20088 #: ../misc-utils/uuidd.8.adoc:20
20090 msgid "*uuidd* [options]\n"
20093 #. type: Plain text
20094 #: ../misc-utils/uuidd.8.adoc:24
20096 "The *uuidd* daemon is used by the UUID library to generate universally "
20097 "unique identifiers (UUIDs), especially time-based UUIDs, in a secure and "
20098 "guaranteed-unique fashion, even in the face of large numbers of threads "
20099 "running on different CPUs trying to grab UUIDs."
20102 #. type: Labeled list
20103 #: ../misc-utils/uuidd.8.adoc:27
20105 #| msgid "*-c*, **--command**=__command__"
20106 msgid "*-C*, *--cont-clock*[=_time_]"
20107 msgstr "*-c*, **--command**=__příkaz__"
20109 #. type: Plain text
20110 #: ../misc-utils/uuidd.8.adoc:29
20112 "Activate continuous clock handling for time based UUIDs. *uuidd* could use "
20113 "all possible clock values, beginning with the daemon's start time. The "
20114 "optional argument can be used to set a value for the max_clock_offset. This "
20115 "gurantees, that a clock value of a UUID will always be within the range of "
20116 "the max_clock_offset."
20119 #. type: Plain text
20120 #: ../misc-utils/uuidd.8.adoc:31
20122 "The option *-C* or *--cont-clock* enables the feature with a default "
20123 "max_clock_offset of 2 hours."
20126 #. type: Plain text
20127 #: ../misc-utils/uuidd.8.adoc:33
20129 "The option *-C<NUM>[hd]* or *--cont-clock=<NUM>[hd]* enables the feature "
20130 "with a max_clock_offset of NUM seconds. In case of an appended h or d, the "
20131 "NUM value is read in hours or days. The minimum value is 60 seconds, the "
20132 "maximum value is 365 days."
20135 #. type: Labeled list
20136 #: ../misc-utils/uuidd.8.adoc:34 ../sys-utils/ldattach.8.adoc:88
20138 #| msgid "*-h*, *--help*"
20139 msgid "*-d*, *--debug*"
20140 msgstr "*-h*, *--help*"
20142 #. type: Plain text
20143 #: ../misc-utils/uuidd.8.adoc:36
20145 "Run *uuidd* in debugging mode. This prevents *uuidd* from running as a "
20149 #. type: Labeled list
20150 #: ../misc-utils/uuidd.8.adoc:37 ../sys-utils/flock.1.adoc:62
20151 #: ../sys-utils/nsenter.1.adoc:138
20153 #| msgid "*-f*, *--fast*"
20154 msgid "*-F*, *--no-fork*"
20155 msgstr "*-f*, *--fast*"
20157 #. type: Plain text
20158 #: ../misc-utils/uuidd.8.adoc:39
20159 msgid "Do not daemonize using a double-fork."
20162 #. type: Labeled list
20163 #: ../misc-utils/uuidd.8.adoc:40
20165 #| msgid "*-h*, *--help*"
20166 msgid "*-k*, *--kill*"
20167 msgstr "*-h*, *--help*"
20169 #. type: Plain text
20170 #: ../misc-utils/uuidd.8.adoc:42
20171 msgid "If currently a uuidd daemon is running, kill it."
20174 #. type: Labeled list
20175 #: ../misc-utils/uuidd.8.adoc:43
20177 msgid "*-n*, *--uuids* _number_"
20180 #. type: Plain text
20181 #: ../misc-utils/uuidd.8.adoc:45
20183 "When issuing a test request to a running *uuidd*, request a bulk response of "
20187 #. type: Labeled list
20188 #: ../misc-utils/uuidd.8.adoc:46
20190 #| msgid "*-P*, *--pty*"
20191 msgid "*-P*, *--no-pid*"
20192 msgstr "*-P*, *--pty*"
20194 #. type: Plain text
20195 #: ../misc-utils/uuidd.8.adoc:48
20196 msgid "Do not create a pid file."
20199 #. type: Labeled list
20200 #: ../misc-utils/uuidd.8.adoc:49
20202 #| msgid "*-P*, *--pty*"
20203 msgid "*-p*, *--pid* _path_"
20204 msgstr "*-P*, *--pty*"
20206 #. TRANSLATORS: Don't translate _{runstatedir}_.
20207 #. type: Plain text
20208 #: ../misc-utils/uuidd.8.adoc:51
20210 "Specify the pathname where the pid file should be written. By default, the "
20211 "pid file is written to _{runstatedir}/uuidd/uuidd.pid_."
20214 #. type: Plain text
20215 #: ../misc-utils/uuidd.8.adoc:55
20216 msgid "Suppress some failure messages."
20219 #. type: Labeled list
20220 #: ../misc-utils/uuidd.8.adoc:56 ../misc-utils/uuidgen.1.adoc:31
20222 #| msgid "*-V*, *--version*"
20223 msgid "*-r*, *--random*"
20224 msgstr "*-V*, *--version*"
20226 #. type: Plain text
20227 #: ../misc-utils/uuidd.8.adoc:58
20229 "Test uuidd by trying to connect to a running uuidd daemon and request it to "
20230 "return a random-based UUID."
20233 #. type: Labeled list
20234 #: ../misc-utils/uuidd.8.adoc:59
20236 msgid "*-S*, *--socket-activation*"
20239 #. type: Plain text
20240 #: ../misc-utils/uuidd.8.adoc:61
20242 "Do not create a socket but instead expect it to be provided by the calling "
20243 "process. This implies *--no-fork* and *--no-pid*. This option is intended to "
20244 "be used only with *systemd*(1). It needs to be enabled with a configure "
20248 #. type: Labeled list
20249 #: ../misc-utils/uuidd.8.adoc:62
20251 #| msgid "*-s*, **--shell**=__shell__"
20252 msgid "*-s*, *--socket* _path_"
20253 msgstr "*-s*, **--shell**=__shell__"
20255 #. TRANSLATORS: Don't translate _{runstatedir}_.
20256 #. type: Plain text
20257 #: ../misc-utils/uuidd.8.adoc:64
20259 "Make uuidd use this pathname for the unix-domain socket. By default, the "
20260 "pathname used is _{runstatedir}/uuidd/request_. This option is primarily for "
20261 "debugging purposes, since the pathname is hard-coded in the *libuuid* "
20265 #. type: Labeled list
20266 #: ../misc-utils/uuidd.8.adoc:66
20268 msgid "*-T*, *--timeout* _number_"
20271 #. type: Plain text
20272 #: ../misc-utils/uuidd.8.adoc:68
20273 msgid "Make *uuidd* exit after _number_ seconds of inactivity."
20276 #. type: Labeled list
20277 #: ../misc-utils/uuidd.8.adoc:69 ../misc-utils/uuidgen.1.adoc:34
20278 #: ../sys-utils/ipcs.1.adoc:59 ../sys-utils/lsipc.1.adoc:74
20280 #| msgid "*-P*, *--pty*"
20281 msgid "*-t*, *--time*"
20282 msgstr "*-P*, *--pty*"
20284 #. type: Plain text
20285 #: ../misc-utils/uuidd.8.adoc:71
20287 "Test *uuidd* by trying to connect to a running uuidd daemon and request it "
20288 "to return a time-based UUID."
20291 #. type: Plain text
20292 #: ../misc-utils/uuidd.8.adoc:77
20293 msgid "Start up a daemon, print 42 random keys, and then stop the daemon:"
20296 #. type: delimited block .
20297 #: ../misc-utils/uuidd.8.adoc:82
20300 "uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket\n"
20301 "uuidd -d -r -n 42 -s /tmp/uuidd.socket\n"
20302 "uuidd -d -k -s /tmp/uuidd.socket\n"
20305 #. type: Plain text
20306 #: ../misc-utils/uuidd.8.adoc:87
20307 msgid "The *uuidd* daemon was written by mailto:tytso@mit.edu[Theodore Ts'o]."
20310 #. type: Plain text
20311 #: ../misc-utils/uuidd.8.adoc:92
20318 #. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
20319 #. This file may be copied under the terms of the GNU Public License.
20321 #: ../misc-utils/uuidgen.1.adoc:6
20326 #. type: Plain text
20327 #: ../misc-utils/uuidgen.1.adoc:16
20328 msgid "uuidgen - create a new UUID value"
20331 #. type: Plain text
20332 #: ../misc-utils/uuidgen.1.adoc:20
20334 msgid "*uuidgen* [options]\n"
20337 #. type: Plain text
20338 #: ../misc-utils/uuidgen.1.adoc:24
20340 "The *uuidgen* program creates (and prints) a new universally unique "
20341 "identifier (UUID) using the *libuuid*(3) library. The new UUID can "
20342 "reasonably be considered unique among all UUIDs created on the local system, "
20343 "and among UUIDs created on other systems in the past and in the future."
20346 #. type: Plain text
20347 #: ../misc-utils/uuidgen.1.adoc:26
20349 "There are three types of UUIDs which *uuidgen* can generate: time-based "
20350 "UUIDs, random-based UUIDs, and hash-based UUIDs. By default *uuidgen* will "
20351 "generate a random-based UUID if a high-quality random number generator is "
20352 "present. Otherwise, it will choose a time-based UUID. It is possible to "
20353 "force the generation of one of these first two UUID types by using the *--"
20354 "random* or *--time* options."
20357 #. type: Plain text
20358 #: ../misc-utils/uuidgen.1.adoc:28
20360 "The third type of UUID is generated with the *--md5* or *--sha1* options, "
20361 "followed by *--namespace* _namespace_ and *--name* _name_. The _namespace_ "
20362 "may either be a well-known UUID, or else an alias to one of the well-known "
20363 "UUIDs defined in RFC 4122, that is *@dns*, *@url*, *@oid*, or *@x500*. The "
20364 "_name_ is an arbitrary string value. The generated UUID is the digest of the "
20365 "concatenation of the namespace UUID and the name value, hashed with the MD5 "
20366 "or SHA1 algorithms. It is, therefore, a predictable value which may be "
20367 "useful when UUIDs are being used as handles or nonces for more complex "
20368 "values or values which shouldn't be disclosed directly. See the RFC for more "
20372 #. type: Plain text
20373 #: ../misc-utils/uuidgen.1.adoc:33
20375 "Generate a random-based UUID. This method creates a UUID consisting mostly "
20376 "of random bits. It requires that the operating system has a high quality "
20377 "random number generator, such as _/dev/random_."
20380 #. type: Plain text
20381 #: ../misc-utils/uuidgen.1.adoc:36
20383 "Generate a time-based UUID. This method creates a UUID based on the system "
20384 "clock plus the system's ethernet hardware address, if present."
20387 #. type: Labeled list
20388 #: ../misc-utils/uuidgen.1.adoc:39
20390 #| msgid "*-P*, *--pty*"
20391 msgid "*-m*, *--md5*"
20392 msgstr "*-P*, *--pty*"
20394 #. type: Plain text
20395 #: ../misc-utils/uuidgen.1.adoc:41
20396 msgid "Use MD5 as the hash algorithm."
20399 #. type: Labeled list
20400 #: ../misc-utils/uuidgen.1.adoc:42
20402 #| msgid "*-h*, *--help*"
20403 msgid "*-s*, *--sha1*"
20404 msgstr "*-h*, *--help*"
20406 #. type: Plain text
20407 #: ../misc-utils/uuidgen.1.adoc:44
20408 msgid "Use SHA1 as the hash algorithm."
20411 #. type: Labeled list
20412 #: ../misc-utils/uuidgen.1.adoc:45
20414 msgid "*-n*, *--namespace* _namespace_"
20417 #. type: Plain text
20418 #: ../misc-utils/uuidgen.1.adoc:47
20420 "Generate the hash with the _namespace_ prefix. The _namespace_ is UUID, or "
20421 "'@ns' where \"ns\" is well-known predefined UUID addressed by namespace name "
20425 #. type: Labeled list
20426 #: ../misc-utils/uuidgen.1.adoc:48
20428 msgid "*-N*, *--name* _name_"
20431 #. type: Plain text
20432 #: ../misc-utils/uuidgen.1.adoc:50
20433 msgid "Generate the hash of the _name_."
20436 #. type: Labeled list
20437 #: ../misc-utils/uuidgen.1.adoc:51
20439 #| msgid "*-c*, **--command**=__command__"
20440 msgid "*-C*, *--count* _num_"
20441 msgstr "*-c*, **--command**=__příkaz__"
20443 #. type: Plain text
20444 #: ../misc-utils/uuidgen.1.adoc:53
20446 "Generate multiple UUIDs using the enhanced capability of the libuuid to "
20447 "cache time-based UUIDs, thus resulting in improved performance. However, "
20448 "this holds no significance for other UUID types."
20451 #. type: Labeled list
20452 #: ../misc-utils/uuidgen.1.adoc:54 ../sys-utils/lscpu.1.adoc:84
20454 #| msgid "*-h*, *--help*"
20455 msgid "*-x*, *--hex*"
20456 msgstr "*-h*, *--help*"
20458 #. type: Plain text
20459 #: ../misc-utils/uuidgen.1.adoc:56
20460 msgid "Interpret name _name_ as a hexadecimal string."
20463 #. type: Plain text
20464 #: ../misc-utils/uuidgen.1.adoc:60
20465 msgid "OSF DCE 1.1"
20468 #. type: Plain text
20469 #: ../misc-utils/uuidgen.1.adoc:64
20470 msgid "uuidgen --sha1 --namespace @dns --name \"www.example.com\""
20473 #. type: Plain text
20474 #: ../misc-utils/uuidgen.1.adoc:68
20476 msgid "*uuidgen* was written by Andreas Dilger for *libuuid*(3).\n"
20479 #. type: Plain text
20480 #: ../misc-utils/uuidgen.1.adoc:74
20483 "*uuidparse*(1),\n"
20485 "link:https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
20488 #. Copyright (c) 2017 Sami Kerola
20489 #. The 3-Clause BSD License
20491 #: ../misc-utils/uuidparse.1.adoc:4
20493 msgid "uuidparse(1)"
20496 #. type: Plain text
20497 #: ../misc-utils/uuidparse.1.adoc:14
20498 msgid "uuidparse - a utility to parse unique identifiers"
20501 #. type: Plain text
20502 #: ../misc-utils/uuidparse.1.adoc:18
20504 msgid "*uuidparse* [options] _uuid_\n"
20507 #. type: Plain text
20508 #: ../misc-utils/uuidparse.1.adoc:22
20510 "This command will parse unique identifier inputs from either command line "
20511 "arguments or standard input. The inputs are white-space separated."
20515 #: ../misc-utils/uuidparse.1.adoc:25
20521 #: ../misc-utils/uuidparse.1.adoc:33
20524 "|NCS |Network Computing System identifier. These were the original UUIDs.\n"
20525 "|DCE |The Open Software Foundation's (OSF) Distributed Computing Environment UUIDs.\n"
20526 "|Microsoft |Microsoft Windows platform globally unique identifier (GUID).\n"
20527 "|other |Unknown variant. Usually invalid input data.\n"
20531 #: ../misc-utils/uuidparse.1.adoc:35
20537 #: ../misc-utils/uuidparse.1.adoc:46
20540 "|nil |Special type for zero in type file.\n"
20541 "|time-based |The DCE time based.\n"
20542 "|DCE |The DCE time and MAC Address.\n"
20543 "|name-based |RFC 4122 md5sum hash.\n"
20544 "|random |RFC 4122 random.\n"
20545 "|sha1-based |RFC 4122 sha-1 hash.\n"
20546 "|unknown |Unknown type. Usually invalid input data.\n"
20549 #. type: Labeled list
20550 #: ../misc-utils/uuidparse.1.adoc:56 ../sys-utils/rfkill.8.adoc:33
20552 #| msgid "*-P*, *--pty*"
20553 msgid "*-o*, *--output*"
20554 msgstr "*-P*, *--pty*"
20556 #. type: Plain text
20557 #: ../misc-utils/uuidparse.1.adoc:67
20558 msgid "mailto:kerolasa@iki.fi[Sami Kerola]"
20561 #. type: Plain text
20562 #: ../misc-utils/uuidparse.1.adoc:73
20567 "https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
20571 #: ../misc-utils/waitpid.1.adoc:2
20576 #. type: Plain text
20577 #: ../misc-utils/waitpid.1.adoc:12
20578 msgid "waitpid - utility to wait for arbitrary processes"
20581 #. type: Plain text
20582 #: ../misc-utils/waitpid.1.adoc:16
20584 msgid "*waitpid* [-v] [*--timeout*|*-t* _seconds_] pid...\n"
20587 #. type: Plain text
20588 #: ../misc-utils/waitpid.1.adoc:20
20590 msgid "*waitpid* is a simple command to wait for arbitrary non-child processes.\n"
20593 #. type: Plain text
20594 #: ../misc-utils/waitpid.1.adoc:23
20596 "It exits after all processes whose PIDs have been passed as arguments have "
20600 #. type: Plain text
20601 #: ../misc-utils/waitpid.1.adoc:28
20602 msgid "Be more verbose."
20605 #. type: Plain text
20606 #: ../misc-utils/waitpid.1.adoc:31
20607 msgid "Maximum wait time."
20610 #. type: Labeled list
20611 #: ../misc-utils/waitpid.1.adoc:32
20613 #| msgid "*-f*, *--fast*"
20614 msgid "*-e*, *--exited*"
20615 msgstr "*-f*, *--fast*"
20617 #. type: Plain text
20618 #: ../misc-utils/waitpid.1.adoc:34
20619 msgid "Don't error on already exited PIDs."
20622 #. type: Labeled list
20623 #: ../misc-utils/waitpid.1.adoc:35 ../sys-utils/blkzone.8.adoc:92
20625 #| msgid "*-c*, **--command**=__command__"
20626 msgid "*-c*, *--count* _count_"
20627 msgstr "*-c*, **--command**=__příkaz__"
20629 #. type: Plain text
20630 #: ../misc-utils/waitpid.1.adoc:37
20631 msgid "Number of process exits to wait for."
20634 #. type: Plain text
20635 #: ../misc-utils/waitpid.1.adoc:43
20637 msgid "*waitpid* has the following exit status values:\n"
20640 #. type: Plain text
20641 #: ../misc-utils/waitpid.1.adoc:50
20642 msgid "system does not provide necessary functionality"
20645 #. type: Plain text
20646 #: ../misc-utils/waitpid.1.adoc:52
20647 msgid "timeout expired"
20650 #. type: Plain text
20651 #: ../misc-utils/waitpid.1.adoc:60
20653 msgid "*waitpid*(2) *wait*(1P)\n"
20659 #. Copyright (c) 1980, 1990 The Regents of the University of California.
20660 #. All rights reserved.
20661 #. Redistribution and use in source and binary forms, with or without
20662 #. modification, are permitted provided that the following conditions
20664 #. 1. Redistributions of source code must retain the above copyright
20665 #. notice, this list of conditions and the following disclaimer.
20666 #. 2. Redistributions in binary form must reproduce the above copyright
20667 #. notice, this list of conditions and the following disclaimer in the
20668 #. documentation and/or other materials provided with the distribution.
20669 #. 3. All advertising materials mentioning features or use of this software
20670 #. must display the following acknowledgement:
20671 #. This product includes software developed by the University of
20672 #. California, Berkeley and its contributors.
20673 #. 4. Neither the name of the University nor the names of its contributors
20674 #. may be used to endorse or promote products derived from this software
20675 #. without specific prior written permission.
20676 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20677 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20678 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20679 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20680 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20681 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20682 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20683 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20684 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
20685 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
20687 #. @(#)whereis.1 from UCB 4.2
20689 #: ../misc-utils/whereis.1.adoc:36
20694 #. type: Plain text
20695 #: ../misc-utils/whereis.1.adoc:46
20697 "whereis - locate the binary, source, and manual page files for a command"
20700 #. type: Plain text
20701 #: ../misc-utils/whereis.1.adoc:50
20703 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
20704 msgid "*whereis* [options] [*-BMS* _directory_... *-f*] _name_...\n"
20705 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
20707 #. type: Plain text
20708 #: ../misc-utils/whereis.1.adoc:54
20710 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"
20713 #. type: Plain text
20714 #: ../misc-utils/whereis.1.adoc:56
20716 "The search restrictions (options *-b*, *-m* and *-s*) are cumulative and "
20717 "apply to the subsequent _name_ patterns on the command line. Any new search "
20718 "restriction resets the search mask. For example,"
20721 #. type: delimited block _
20722 #: ../misc-utils/whereis.1.adoc:59
20724 msgid "*whereis -bm ls tr -m gcc*\n"
20727 #. type: Plain text
20728 #: ../misc-utils/whereis.1.adoc:62
20730 "searches for \"ls\" and \"tr\" binaries and man pages, and for \"gcc\" man "
20734 #. type: Plain text
20735 #: ../misc-utils/whereis.1.adoc:64
20737 "The options *-B*, *-M* and *-S* reset search paths for the subsequent _name_ "
20738 "patterns. For example,"
20741 #. type: delimited block _
20742 #: ../misc-utils/whereis.1.adoc:67
20744 msgid "*whereis -m ls -M /usr/share/man/man1 -f cal*\n"
20747 #. type: Plain text
20748 #: ../misc-utils/whereis.1.adoc:70
20750 "searches for \"*ls*\" man pages in all default paths, but for \"cal\" in the "
20751 "_/usr/share/man/man1_ directory only."
20754 #. type: Labeled list
20755 #: ../misc-utils/whereis.1.adoc:73
20760 #. type: Plain text
20761 #: ../misc-utils/whereis.1.adoc:75
20762 msgid "Search for binaries."
20765 #. type: Labeled list
20766 #: ../misc-utils/whereis.1.adoc:76 ../schedutils/uclampset.1.adoc:69
20771 #. type: Plain text
20772 #: ../misc-utils/whereis.1.adoc:78
20773 msgid "Search for manuals."
20776 #. type: Plain text
20777 #: ../misc-utils/whereis.1.adoc:81
20778 msgid "Search for sources."
20781 #. type: Labeled list
20782 #: ../misc-utils/whereis.1.adoc:82
20787 #. type: Plain text
20788 #: ../misc-utils/whereis.1.adoc:84
20790 "Only show the command names that have unusual entries. A command is said to "
20791 "be unusual if it does not have just one entry of each explicitly requested "
20792 "type. Thus '*whereis -m -u **' asks for those files in the current directory "
20793 "which have no documentation file, or more than one."
20796 #. type: Labeled list
20797 #: ../misc-utils/whereis.1.adoc:85
20799 msgid "*-B* _list_"
20802 #. type: Plain text
20803 #: ../misc-utils/whereis.1.adoc:87
20805 "Limit the places where *whereis* searches for binaries, by a whitespace-"
20806 "separated list of directories."
20809 #. type: Labeled list
20810 #: ../misc-utils/whereis.1.adoc:88
20812 msgid "*-M* _list_"
20815 #. type: Plain text
20816 #: ../misc-utils/whereis.1.adoc:90
20818 "Limit the places where *whereis* searches for manuals and documentation in "
20819 "Info format, by a whitespace-separated list of directories."
20822 #. type: Labeled list
20823 #: ../misc-utils/whereis.1.adoc:91
20825 msgid "*-S* _list_"
20828 #. type: Plain text
20829 #: ../misc-utils/whereis.1.adoc:93
20831 "Limit the places where *whereis* searches for sources, by a whitespace-"
20832 "separated list of directories."
20835 #. type: Plain text
20836 #: ../misc-utils/whereis.1.adoc:96
20838 "Terminates the directory list and signals the start of filenames. It _must_ "
20839 "be used when any of the *-B*, *-M*, or *-S* options is used."
20842 #. type: Plain text
20843 #: ../misc-utils/whereis.1.adoc:99
20845 "Output the list of effective lookup paths that *whereis* is using. When none "
20846 "of *-B*, *-M*, or *-S* is specified, the option will output the hard-coded "
20847 "paths that the command was able to find on the system."
20850 #. type: Labeled list
20851 #: ../misc-utils/whereis.1.adoc:100
20856 #. type: Plain text
20857 #: ../misc-utils/whereis.1.adoc:102
20859 "Interpret the next names as a *glob(7)* patterns. *whereis* always compares "
20860 "only filenames (aka basename) and never complete path. Using directory names "
20861 "in the pattern has no effect. Donâ
\80\99t forget that the shell interprets the "
20862 "pattern when specified on the command line without quotes. Itâ
\80\99s necessary to "
20863 "use quotes for the _name_, for example:"
20866 #. type: delimited block _
20867 #: ../misc-utils/whereis.1.adoc:104
20869 msgid " whereis -g 'find*'\n"
20873 #: ../misc-utils/whereis.1.adoc:108
20875 msgid "FILE SEARCH PATHS"
20878 #. type: Plain text
20879 #: ../misc-utils/whereis.1.adoc:111
20881 "By default *whereis* tries to find files from hard-coded paths, which are "
20882 "defined with glob patterns. The command attempts to use the contents of "
20883 "*$PATH* and *$MANPATH* environment variables as default search path. The "
20884 "easiest way to know what paths are in use is to add the *-l* listing option. "
20885 "Effects of the *-B*, *-M*, and *-S* are displayed with *-l*."
20888 #. type: Labeled list
20889 #: ../misc-utils/whereis.1.adoc:114
20891 msgid "*WHEREIS_DEBUG*=all"
20894 #. type: Plain text
20895 #: ../misc-utils/whereis.1.adoc:120
20897 "To find all files in _/usr/bin_ which are not documented in _/usr/man/man1_ "
20898 "or have no source in _/usr/src_:"
20901 #. type: delimited block _
20902 #: ../misc-utils/whereis.1.adoc:123
20905 "*cd /usr/bin* +\n"
20906 "*whereis -u -ms -M /usr/man/man1 -S /usr/src -f **\n"
20909 #. Copyright 2009 by Karel Zak. All Rights Reserved.
20910 #. This file may be copied under the terms of the GNU Public License.
20912 #: ../misc-utils/wipefs.8.adoc:4
20917 #. type: Plain text
20918 #: ../misc-utils/wipefs.8.adoc:14
20919 msgid "wipefs - wipe a signature from a device"
20922 #. type: Plain text
20923 #: ../misc-utils/wipefs.8.adoc:18
20925 msgid "*wipefs* [options] _device_...\n"
20928 #. type: Plain text
20929 #: ../misc-utils/wipefs.8.adoc:20
20931 msgid "*wipefs* [*--backup*] *-o* _offset device_...\n"
20934 #. type: Plain text
20935 #: ../misc-utils/wipefs.8.adoc:22
20937 msgid "*wipefs* [*--backup*] *-a* _device_...\n"
20940 #. type: Plain text
20941 #: ../misc-utils/wipefs.8.adoc:27
20943 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"
20946 #. type: Plain text
20947 #: ../misc-utils/wipefs.8.adoc:29
20949 "When used without any options, *wipefs* lists all visible filesystems and "
20950 "the offsets of their basic signatures. The default output is subject to "
20951 "change. So whenever possible, you should avoid using default outputs in your "
20952 "scripts. Always explicitly define expected columns by using *--output* "
20953 "_columns-list_ in environments where a stable output is required."
20956 #. type: Plain text
20957 #: ../misc-utils/wipefs.8.adoc:31
20959 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 partition devices as well as a partition table on a disk device, for example by *wipefs -a /dev/sdc1 /dev/sdc2 /dev/sdc*.\n"
20962 #. type: Plain text
20963 #: ../misc-utils/wipefs.8.adoc:33
20965 "Note that some filesystems and some partition tables store more magic "
20966 "strings on the device (e.g., FAT, ZFS, GPT). The *wipefs* command (since "
20967 "v2.31) lists all the offsets where magic strings have been detected."
20970 #. type: Plain text
20971 #: ../misc-utils/wipefs.8.adoc:35
20973 "When option *-a* is used, all magic strings that are visible for "
20974 "*libblkid*(3) are erased. In this case the *wipefs* scans the device again "
20975 "after each modification (erase) until no magic string is found."
20978 #. type: Plain text
20979 #: ../misc-utils/wipefs.8.adoc:37
20981 "Note that by default *wipefs* does not erase nested partition tables on non-"
20982 "whole disk devices. For this the option *--force* is required."
20985 #. type: Plain text
20986 #: ../misc-utils/wipefs.8.adoc:42
20988 "Erase all available signatures. The set of erased signatures can be "
20989 "restricted with the *-t* option."
20992 #. type: Labeled list
20993 #: ../misc-utils/wipefs.8.adoc:43
20995 #| msgid "*-P*, *--pty*"
20996 msgid "*-b*, *--backup*[=_dir_]"
20997 msgstr "*-P*, *--pty*"
20999 #. type: Plain text
21000 #: ../misc-utils/wipefs.8.adoc:45
21002 "Create a signature backup to the file _wipefs-<devname>-<offset>.bak_ in "
21003 "_$HOME_ or the directory specified as the optional argument. For more "
21004 "details see the *EXAMPLE* section."
21007 #. type: Plain text
21008 #: ../misc-utils/wipefs.8.adoc:48
21010 "Force erasure, even if the filesystem is mounted. This is required in order "
21011 "to erase a partition-table signature on a block device."
21014 #. type: Plain text
21015 #: ../misc-utils/wipefs.8.adoc:54
21017 "Use exclusive BSD lock for device or file it operates. The optional argument "
21018 "_mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument "
21019 "is omitted, it defaults to *\"yes\"*. This option overwrites environment "
21020 "variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, "
21021 "but it's recommended to avoid collisions with udevd or other tools."
21024 #. type: Labeled list
21025 #: ../misc-utils/wipefs.8.adoc:55
21027 #| msgid "*-V*, *--version*"
21028 msgid "*-i*, *--noheadings*"
21029 msgstr "*-V*, *--version*"
21031 #. type: Labeled list
21032 #: ../misc-utils/wipefs.8.adoc:58
21034 #| msgid "*-P*, *--pty*"
21035 msgid "*-O*, *--output* _list_"
21036 msgstr "*-P*, *--pty*"
21038 #. type: Plain text
21039 #: ../misc-utils/wipefs.8.adoc:63
21040 msgid "Causes everything to be done except for the *write*(2) call."
21043 #. type: Plain text
21044 #: ../misc-utils/wipefs.8.adoc:66
21046 "Specify the location (in bytes) of the signature which should be erased from "
21047 "the device. The _offset_ number may include a \"0x\" prefix; then the number "
21048 "will be interpreted as a hex value. It is possible to specify multiple *-o* "
21052 #. type: Plain text
21053 #: ../misc-utils/wipefs.8.adoc:68
21055 "The _offset_ argument may be followed by the multiplicative suffixes KiB "
21056 "(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
21057 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
21058 "the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
21062 #. type: Labeled list
21063 #: ../misc-utils/wipefs.8.adoc:69
21065 #| msgid "*-f*, *--fast*"
21066 msgid "*-p*, *--parsable*"
21067 msgstr "*-f*, *--fast*"
21069 #. type: Plain text
21070 #: ../misc-utils/wipefs.8.adoc:71
21072 "Print out in parsable instead of printable format. Encode all potentially "
21073 "unsafe characters of a string to the corresponding hex value prefixed by "
21077 #. type: Plain text
21078 #: ../misc-utils/wipefs.8.adoc:74
21079 msgid "Suppress any messages after a successful signature wipe."
21082 #. type: Plain text
21083 #: ../misc-utils/wipefs.8.adoc:77
21085 "Limit the set of printed or erased signatures. More than one type may be "
21086 "specified in a comma-separated list. The list or individual types can be "
21087 "prefixed with 'no' to specify the types on which no action should be taken. "
21088 "For more details see *mount*(8)."
21091 #. type: Plain text
21092 #: ../misc-utils/wipefs.8.adoc:84
21093 msgid "enables *libblkid*(3) debug output."
21096 #. type: Labeled list
21097 #: ../misc-utils/wipefs.8.adoc:90
21099 msgid "*wipefs /dev/sda**"
21102 #. type: Plain text
21103 #: ../misc-utils/wipefs.8.adoc:92
21104 msgid "Prints information about sda and all partitions on sda."
21107 #. type: Labeled list
21108 #: ../misc-utils/wipefs.8.adoc:93
21110 msgid "*wipefs --all --backup /dev/sdb*"
21113 #. type: Plain text
21114 #: ../misc-utils/wipefs.8.adoc:95
21116 "Erases all signatures from the device _/dev/sdb_ and creates a signature "
21117 "backup file _~/wipefs-sdb-<offset>.bak_ for each signature."
21120 #. type: Labeled list
21121 #: ../misc-utils/wipefs.8.adoc:96
21123 msgid "*dd if=~/wipefs-sdb-0x00000438.bak of=/dev/sdb seek=$\\((0x00000438)) bs=1 conv=notrunc*"
21126 #. type: Plain text
21127 #: ../misc-utils/wipefs.8.adoc:98
21129 "Restores an ext2 signature from the backup file _~/wipefs-sdb-0x00000438."
21139 #. Copyright (C) 2004 Robert Love
21140 #. Copyright (C) 2015 Karel Zak <kzak@redhat.com>
21141 #. This is free documentation; you can redistribute it and/or
21142 #. modify it under the terms of the GNU General Public License,
21143 #. version 2, as published by the Free Software Foundation.
21144 #. The GNU General Public License's references to "object code"
21145 #. and "executables" are to be interpreted as the output of any
21146 #. document formatting or typesetting system, including
21147 #. intermediate and printed output.
21148 #. This manual is distributed in the hope that it will be useful,
21149 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
21150 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21151 #. GNU General Public License for more details.
21152 #. You should have received a copy of the GNU General Public License along
21153 #. with this program; if not, write to the Free Software Foundation, Inc.,
21154 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21156 #: ../schedutils/chrt.1.adoc:26
21161 #. type: Plain text
21162 #: ../schedutils/chrt.1.adoc:37
21163 msgid "chrt - manipulate the real-time attributes of a process"
21166 #. type: Plain text
21167 #: ../schedutils/chrt.1.adoc:41
21169 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21170 msgid "*chrt* [options] _priority command argument_ ...\n"
21171 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21173 #. type: Plain text
21174 #: ../schedutils/chrt.1.adoc:43
21176 msgid "*chrt* [options] *-p* [_priority_] _PID_\n"
21179 #. type: Plain text
21180 #: ../schedutils/chrt.1.adoc:47
21182 msgid "*chrt* sets or retrieves the real-time scheduling attributes of an existing _PID_, or runs _command_ with the given attributes.\n"
21186 #: ../schedutils/chrt.1.adoc:48
21191 #. type: Labeled list
21192 #: ../schedutils/chrt.1.adoc:50
21194 #| msgid "*-h*, *--help*"
21195 msgid "*-o*, *--other*"
21196 msgstr "*-h*, *--help*"
21198 #. type: Plain text
21199 #: ../schedutils/chrt.1.adoc:52
21201 "Set scheduling policy to *SCHED_OTHER* (time-sharing scheduling). This is "
21202 "the default Linux scheduling policy."
21205 #. type: Labeled list
21206 #: ../schedutils/chrt.1.adoc:53
21208 #| msgid "*-f*, *--fast*"
21209 msgid "*-f*, *--fifo*"
21210 msgstr "*-f*, *--fast*"
21212 #. type: Plain text
21213 #: ../schedutils/chrt.1.adoc:55
21214 msgid "Set scheduling policy to *SCHED_FIFO* (first in-first out)."
21217 #. type: Labeled list
21218 #: ../schedutils/chrt.1.adoc:56
21220 #| msgid "*-P*, *--pty*"
21221 msgid "*-r*, *--rr*"
21222 msgstr "*-P*, *--pty*"
21224 #. type: Plain text
21225 #: ../schedutils/chrt.1.adoc:58
21227 "Set scheduling policy to *SCHED_RR* (round-robin scheduling). When no policy "
21228 "is defined, the *SCHED_RR* is used as the default."
21231 #. type: Labeled list
21232 #: ../schedutils/chrt.1.adoc:59
21234 #| msgid "*-f*, *--fast*"
21235 msgid "*-b*, *--batch*"
21236 msgstr "*-f*, *--fast*"
21238 #. type: Plain text
21239 #: ../schedutils/chrt.1.adoc:61
21241 "Set scheduling policy to *SCHED_BATCH* (scheduling batch processes). Linux-"
21242 "specific, supported since 2.6.16. The priority argument has to be set to "
21246 #. type: Labeled list
21247 #: ../schedutils/chrt.1.adoc:62
21249 #| msgid "*-h*, *--help*"
21250 msgid "*-i*, *--idle*"
21251 msgstr "*-h*, *--help*"
21253 #. type: Plain text
21254 #: ../schedutils/chrt.1.adoc:64
21256 "Set scheduling policy to *SCHED_IDLE* (scheduling very low priority jobs). "
21257 "Linux-specific, supported since 2.6.23. The priority argument has to be set "
21261 #. type: Labeled list
21262 #: ../schedutils/chrt.1.adoc:65
21264 #| msgid "*-h*, *--help*"
21265 msgid "*-d*, *--deadline*"
21266 msgstr "*-h*, *--help*"
21268 #. type: Plain text
21269 #: ../schedutils/chrt.1.adoc:67
21271 "Set scheduling policy to *SCHED_DEADLINE* (sporadic task model deadline "
21272 "scheduling). Linux-specific, supported since 3.14. The priority argument has "
21273 "to be set to zero. See also *--sched-runtime*, *--sched-deadline* and *--"
21274 "sched-period*. The relation between the options required by the kernel is "
21275 "runtime <= deadline <= period. *chrt* copies _period_ to _deadline_ if *--"
21276 "sched-deadline* is not specified and _deadline_ to _runtime_ if *--sched-"
21277 "runtime* is not specified. It means that at least *--sched-period* has to be "
21278 "specified. See *sched*(7) for more details."
21282 #: ../schedutils/chrt.1.adoc:68
21284 msgid "SCHEDULING OPTIONS"
21287 #. type: Labeled list
21288 #: ../schedutils/chrt.1.adoc:70
21290 msgid "*-T*, *--sched-runtime* _nanoseconds_"
21293 #. type: Plain text
21294 #: ../schedutils/chrt.1.adoc:72
21296 "Specifies runtime parameter for *SCHED_DEADLINE* policy (Linux-specific)."
21299 #. type: Labeled list
21300 #: ../schedutils/chrt.1.adoc:73
21302 msgid "*-P*, *--sched-period* _nanoseconds_"
21305 #. type: Plain text
21306 #: ../schedutils/chrt.1.adoc:75
21308 "Specifies period parameter for *SCHED_DEADLINE* policy (Linux-specific). "
21309 "Note that the kernel's lower limit is 100 milliseconds."
21312 #. type: Labeled list
21313 #: ../schedutils/chrt.1.adoc:76
21315 msgid "*-D*, *--sched-deadline* _nanoseconds_"
21318 #. type: Plain text
21319 #: ../schedutils/chrt.1.adoc:78
21321 "Specifies deadline parameter for *SCHED_DEADLINE* policy (Linux-specific)."
21324 #. type: Labeled list
21325 #: ../schedutils/chrt.1.adoc:79 ../schedutils/uclampset.1.adoc:84
21327 #| msgid "*-V*, *--version*"
21328 msgid "*-R*, *--reset-on-fork*"
21329 msgstr "*-V*, *--version*"
21331 #. type: Plain text
21332 #: ../schedutils/chrt.1.adoc:81
21334 "Use *SCHED_RESET_ON_FORK* or *SCHED_FLAG_RESET_ON_FORK* flag. Linux-"
21335 "specific, supported since 2.6.31."
21338 #. type: Plain text
21339 #: ../schedutils/chrt.1.adoc:83
21341 "Each thread has a _reset-on-fork_ scheduling flag. When this flag is set, "
21342 "children created by *fork*(2) do not inherit privileged scheduling policies. "
21343 "After the _reset-on-fork_ flag has been enabled, it can be reset only if the "
21344 "thread has the *CAP_SYS_NICE* capability. This flag is disabled in child "
21345 "processes created by *fork*(2)."
21348 #. type: Plain text
21349 #: ../schedutils/chrt.1.adoc:85
21351 "More precisely, if the _reset-on-fork_ flag is set, the following rules "
21352 "apply for subsequently created children:"
21355 #. type: Plain text
21356 #: ../schedutils/chrt.1.adoc:87
21358 "If the calling thread has a scheduling policy of *SCHED_FIFO* or *SCHED_RR*, "
21359 "the policy is reset to *SCHED_OTHER* in child processes."
21362 #. type: Plain text
21363 #: ../schedutils/chrt.1.adoc:89
21365 "If the calling process has a negative nice value, the nice value is reset to "
21366 "zero in child processes."
21369 #. type: Labeled list
21370 #: ../schedutils/chrt.1.adoc:92 ../schedutils/taskset.1.adoc:71
21371 #: ../schedutils/uclampset.1.adoc:75
21373 #| msgid "*-f*, *--fast*"
21374 msgid "*-a*, *--all-tasks*"
21375 msgstr "*-f*, *--fast*"
21377 #. type: Plain text
21378 #: ../schedutils/chrt.1.adoc:94
21380 "Set or retrieve the scheduling attributes of all the tasks (threads) for a "
21384 #. type: Labeled list
21385 #: ../schedutils/chrt.1.adoc:95
21387 #| msgid "*-f*, *--fast*"
21388 msgid "*-m*, *--max*"
21389 msgstr "*-f*, *--fast*"
21391 #. type: Plain text
21392 #: ../schedutils/chrt.1.adoc:97
21393 msgid "Show minimum and maximum valid priorities, then exit."
21396 #. type: Plain text
21397 #: ../schedutils/chrt.1.adoc:100 ../schedutils/taskset.1.adoc:79
21398 #: ../schedutils/uclampset.1.adoc:80
21399 msgid "Operate on an existing PID and do not launch a new task."
21402 #. type: Plain text
21403 #: ../schedutils/chrt.1.adoc:103 ../schedutils/uclampset.1.adoc:89
21404 msgid "Show status information."
21407 #. TRANSLATORS: Keep {colon} untranslated.
21408 #. type: Labeled list
21409 #: ../schedutils/chrt.1.adoc:109 ../schedutils/uclampset.1.adoc:95
21411 msgid "The default behavior is to run a new command{colon}"
21414 #. type: delimited block _
21415 #: ../schedutils/chrt.1.adoc:112
21417 msgid "*chrt* _priority_ _command_ [_arguments_]\n"
21420 #. TRANSLATORS: Keep {colon} untranslated
21421 #. type: Labeled list
21422 #: ../schedutils/chrt.1.adoc:114
21424 msgid "You can also retrieve the real-time attributes of an existing task{colon}"
21427 #. type: delimited block _
21428 #: ../schedutils/chrt.1.adoc:117
21430 msgid "*chrt -p* _PID_\n"
21433 #. TRANSLATORS: Keep {colon} untranslated.
21434 #. type: Labeled list
21435 #: ../schedutils/chrt.1.adoc:119 ../schedutils/uclampset.1.adoc:103
21437 msgid "Or set them{colon}"
21440 #. type: delimited block _
21441 #: ../schedutils/chrt.1.adoc:122
21443 msgid "*chrt -r -p* _priority PID_\n"
21446 #. type: Labeled list
21447 #: ../schedutils/chrt.1.adoc:123
21449 msgid "This, for example, sets real-time scheduling to priority _30_ for the process _PID_ with the *SCHED_RR* (round-robin) class{colon}"
21452 #. type: delimited block _
21453 #: ../schedutils/chrt.1.adoc:126
21455 msgid "*chrt -r -p 30* _PID_\n"
21458 #. type: Labeled list
21459 #: ../schedutils/chrt.1.adoc:127
21461 msgid "Reset priorities to default for a process{colon}"
21464 #. type: delimited block _
21465 #: ../schedutils/chrt.1.adoc:130
21467 msgid "*chrt -o -p 0* _PID_\n"
21470 #. type: Plain text
21471 #: ../schedutils/chrt.1.adoc:132
21473 "See *sched*(7) for a detailed discussion of the different scheduler classes "
21474 "and how they interact."
21478 #: ../schedutils/chrt.1.adoc:133 ../schedutils/taskset.1.adoc:104
21479 #: ../schedutils/uclampset.1.adoc:110
21481 msgid "PERMISSIONS"
21484 #. type: Plain text
21485 #: ../schedutils/chrt.1.adoc:136 ../schedutils/uclampset.1.adoc:113
21487 "A user must possess *CAP_SYS_NICE* to change the scheduling attributes of a "
21488 "process. Any user can retrieve the scheduling information."
21491 #. type: Plain text
21492 #: ../schedutils/chrt.1.adoc:140
21494 "Only *SCHED_FIFO*, *SCHED_OTHER* and *SCHED_RR* are part of POSIX 1003.1b "
21495 "Process Scheduling. The other scheduling attributes may be ignored on some "
21499 #. type: Plain text
21500 #: ../schedutils/chrt.1.adoc:142
21501 msgid "Linux' default scheduling policy is *SCHED_OTHER*."
21504 #. type: Plain text
21505 #: ../schedutils/chrt.1.adoc:147
21506 msgid "mailto:rml@tech9.net[Robert Love], mailto:kzak@redhat.com[Karel Zak]"
21509 #. type: Plain text
21510 #: ../schedutils/chrt.1.adoc:154 ../schedutils/uclampset.1.adoc:136
21526 #. type: Plain text
21527 #: ../schedutils/chrt.1.adoc:156
21529 "See *sched_setscheduler*(2) for a description of the Linux scheduling scheme."
21533 #: ../schedutils/ionice.1.adoc:2
21538 #. type: Plain text
21539 #: ../schedutils/ionice.1.adoc:13
21540 msgid "ionice - set or get process I/O scheduling class and priority"
21543 #. type: Plain text
21544 #: ../schedutils/ionice.1.adoc:17
21546 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-p* _PID_\n"
21549 #. type: Plain text
21550 #: ../schedutils/ionice.1.adoc:19
21552 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-P* _PGID_\n"
21555 #. type: Plain text
21556 #: ../schedutils/ionice.1.adoc:21
21558 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-u* _UID_\n"
21561 #. type: Plain text
21562 #: ../schedutils/ionice.1.adoc:23
21564 msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] _command_ [argument] ...\n"
21567 #. type: Plain text
21568 #: ../schedutils/ionice.1.adoc:27
21570 "This program sets or gets the I/O scheduling class and priority for a "
21571 "program. If no arguments or just *-p* is given, *ionice* will query the "
21572 "current I/O scheduling class and priority for that process."
21575 #. type: Plain text
21576 #: ../schedutils/ionice.1.adoc:29
21578 "When _command_ is given, *ionice* will run this command with the given "
21579 "arguments. If no _class_ is specified, then _command_ will be executed with "
21580 "the \"best-effort\" scheduling class. The default priority level is 4."
21583 #. type: Plain text
21584 #: ../schedutils/ionice.1.adoc:31
21586 "As of this writing, a process can be in one of three scheduling classes:"
21589 #. type: Labeled list
21590 #: ../schedutils/ionice.1.adoc:32
21595 #. type: Plain text
21596 #: ../schedutils/ionice.1.adoc:34
21598 "A program running with idle I/O priority will only get disk time when no "
21599 "other program has asked for disk I/O for a defined grace period. The impact "
21600 "of an idle I/O process on normal system activity should be zero. This "
21601 "scheduling class does not take a priority argument. Presently, this "
21602 "scheduling class is permitted for an ordinary user (since kernel 2.6.25)."
21605 #. type: Labeled list
21606 #: ../schedutils/ionice.1.adoc:35
21608 msgid "*Best-effort*"
21611 #. type: Plain text
21612 #: ../schedutils/ionice.1.adoc:37
21614 "This is the effective scheduling class for any process that has not asked "
21615 "for a specific I/O priority. This class takes a priority argument from "
21616 "_0-7_, with a lower number being higher priority. Programs running at the "
21617 "same best-effort priority are served in a round-robin fashion."
21620 #. TRANSLATORS: Keep {plus} untranslated.
21621 #. type: Plain text
21622 #: ../schedutils/ionice.1.adoc:39
21624 "Note that before kernel 2.6.26 a process that has not asked for an I/O "
21625 "priority formally uses \"*none*\" as scheduling class, but the I/O scheduler "
21626 "will treat such processes as if it were in the best-effort class. The "
21627 "priority within the best-effort class will be dynamically derived from the "
21628 "CPU nice level of the process: io_priority = (cpu_nice {plus} 20) / 5."
21631 #. type: Plain text
21632 #: ../schedutils/ionice.1.adoc:42
21634 "For kernels after 2.6.26 with the CFQ I/O scheduler, a process that has not "
21635 "asked for an I/O priority inherits its CPU scheduling class. The I/O "
21636 "priority is derived from the CPU nice level of the process (same as before "
21640 #. type: Labeled list
21641 #: ../schedutils/ionice.1.adoc:43
21646 #. type: Plain text
21647 #: ../schedutils/ionice.1.adoc:45
21649 "The RT scheduling class is given first access to the disk, regardless of "
21650 "what else is going on in the system. Thus the RT class needs to be used with "
21651 "some care, as it can starve other processes. As with the best-effort class, "
21652 "8 priority levels are defined denoting how big a time slice a given process "
21653 "will receive on each scheduling window. This scheduling class is not "
21654 "permitted for an ordinary (i.e., non-root) user."
21657 #. type: Labeled list
21658 #: ../schedutils/ionice.1.adoc:48
21660 msgid "*-c*, *--class* _class_"
21663 #. type: Plain text
21664 #: ../schedutils/ionice.1.adoc:50
21666 "Specify the name or number of the scheduling class to use; `0` for none, `1` "
21667 "for realtime, `2` for best-effort, `3` for idle."
21670 #. type: Labeled list
21671 #: ../schedutils/ionice.1.adoc:51
21673 msgid "*-n*, *--classdata* _level_"
21676 #. type: Plain text
21677 #: ../schedutils/ionice.1.adoc:53
21679 "Specify the scheduling class data. This only has an effect if the class "
21680 "accepts an argument. For realtime and best-effort, _0-7_ are valid data "
21681 "(priority levels), and `0` represents the highest priority level."
21684 #. type: Labeled list
21685 #: ../schedutils/ionice.1.adoc:54
21687 msgid "*-p*, *--pid* _PID_..."
21690 #. type: Plain text
21691 #: ../schedutils/ionice.1.adoc:56
21693 "Specify the process IDs of running processes for which to get or set the "
21694 "scheduling parameters."
21697 #. type: Labeled list
21698 #: ../schedutils/ionice.1.adoc:57
21700 msgid "*-P*, *--pgid* _PGID_..."
21703 #. type: Plain text
21704 #: ../schedutils/ionice.1.adoc:59
21706 "Specify the process group IDs of running processes for which to get or set "
21707 "the scheduling parameters."
21710 #. type: Labeled list
21711 #: ../schedutils/ionice.1.adoc:60
21713 #| msgid "*-h*, *--help*"
21714 msgid "*-t*, *--ignore*"
21715 msgstr "*-h*, *--help*"
21717 #. type: Plain text
21718 #: ../schedutils/ionice.1.adoc:62
21720 "Ignore failure to set the requested priority. If _command_ was specified, "
21721 "run it even in case it was not possible to set the desired scheduling "
21722 "priority, which can happen due to insufficient privileges or an old kernel "
21726 #. type: Labeled list
21727 #: ../schedutils/ionice.1.adoc:63
21729 msgid "*-u*, *--uid* _UID_..."
21732 #. type: Plain text
21733 #: ../schedutils/ionice.1.adoc:65
21735 "Specify the user IDs of running processes for which to get or set the "
21736 "scheduling parameters."
21739 #. type: Plain text
21740 #: ../schedutils/ionice.1.adoc:71
21742 "Linux supports I/O scheduling priorities and classes since 2.6.13 with the "
21743 "CFQ I/O scheduler."
21746 #. type: Plain text
21747 #: ../schedutils/ionice.1.adoc:75
21748 msgid "# *ionice* -c 3 -p 89"
21751 #. type: Plain text
21752 #: ../schedutils/ionice.1.adoc:77
21753 msgid "Sets process with PID 89 as an idle I/O process."
21756 #. type: Plain text
21757 #: ../schedutils/ionice.1.adoc:79
21758 msgid "# *ionice* -c 2 -n 0 bash"
21761 #. type: Plain text
21762 #: ../schedutils/ionice.1.adoc:81
21763 msgid "Runs 'bash' as a best-effort program with highest priority."
21766 #. type: Plain text
21767 #: ../schedutils/ionice.1.adoc:83
21768 msgid "# *ionice* -p 89 91"
21771 #. type: Plain text
21772 #: ../schedutils/ionice.1.adoc:85
21773 msgid "Prints the class and priority of the processes with PID 89 and 91."
21776 #. type: Plain text
21777 #: ../schedutils/ionice.1.adoc:90
21778 msgid "mailto:jens@axboe.dk[Jens Axboe], mailto:kzak@redhat.com[Karel Zak]"
21781 #. type: Plain text
21782 #: ../schedutils/ionice.1.adoc:94
21784 msgid "*ioprio_set*(2)\n"
21791 #. taskset(1) manpage
21792 #. Copyright (C) 2004 Robert Love
21793 #. This is free documentation; you can redistribute it and/or
21794 #. modify it under the terms of the GNU General Public License,
21795 #. version 2, as published by the Free Software Foundation.
21796 #. The GNU General Public License's references to "object code"
21797 #. and "executables" are to be interpreted as the output of any
21798 #. document formatting or typesetting system, including
21799 #. intermediate and printed output.
21800 #. This manual is distributed in the hope that it will be useful,
21801 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
21802 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21803 #. GNU General Public License for more details.
21804 #. You should have received a copy of the GNU General Public License along
21805 #. with this program; if not, write to the Free Software Foundation, Inc.,
21806 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21808 #: ../schedutils/taskset.1.adoc:24
21813 #. type: Plain text
21814 #: ../schedutils/taskset.1.adoc:36
21815 msgid "taskset - set or retrieve a process's CPU affinity"
21818 #. type: Plain text
21819 #: ../schedutils/taskset.1.adoc:40
21821 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21822 msgid "*taskset* [options] _mask command_ [_argument_...]\n"
21823 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21825 #. type: Plain text
21826 #: ../schedutils/taskset.1.adoc:42
21828 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
21829 msgid "*taskset* [options] *-p* [_mask_] _pid_\n"
21830 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
21832 #. type: Plain text
21833 #: ../schedutils/taskset.1.adoc:46
21835 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"
21838 #. type: Plain text
21839 #: ../schedutils/taskset.1.adoc:48
21841 "The CPU affinity is represented as a bitmask, with the lowest order bit "
21842 "corresponding to the first logical CPU and the highest order bit "
21843 "corresponding to the last logical CPU. Not all CPUs may exist on a given "
21844 "system but a mask may specify more CPUs than are present. A retrieved mask "
21845 "will reflect only the bits that correspond to CPUs physically on the system. "
21846 "If an invalid mask is given (i.e., one that corresponds to no valid CPUs on "
21847 "the current system) an error is returned. The masks may be specified in "
21848 "hexadecimal (with or without a leading \"0x\"), or as a CPU list with the *--"
21849 "cpu-list* option. For example,"
21852 #. type: Labeled list
21853 #: ../schedutils/taskset.1.adoc:49
21855 msgid "*0x00000001*"
21858 #. type: Plain text
21859 #: ../schedutils/taskset.1.adoc:51
21860 msgid "is processor #0,"
21863 #. type: Labeled list
21864 #: ../schedutils/taskset.1.adoc:52
21866 msgid "*0x00000003*"
21869 #. type: Plain text
21870 #: ../schedutils/taskset.1.adoc:54
21871 msgid "is processors #0 and #1,"
21874 #. type: Labeled list
21875 #: ../schedutils/taskset.1.adoc:55
21880 #. type: Plain text
21881 #: ../schedutils/taskset.1.adoc:57
21882 msgid "is processors #0 through #31,"
21885 #. type: Labeled list
21886 #: ../schedutils/taskset.1.adoc:58
21891 #. type: Plain text
21892 #: ../schedutils/taskset.1.adoc:60
21893 msgid "is processors #1, #4, and #5,"
21896 #. type: Labeled list
21897 #: ../schedutils/taskset.1.adoc:61
21899 msgid "*--cpu-list 0-2,6*"
21902 #. type: Plain text
21903 #: ../schedutils/taskset.1.adoc:63
21904 msgid "is processors #0, #1, #2, and #6."
21907 #. type: Labeled list
21908 #: ../schedutils/taskset.1.adoc:64
21910 msgid "*--cpu-list 0-10:2*"
21913 #. type: Plain text
21914 #: ../schedutils/taskset.1.adoc:66
21916 "is processors #0, #2, #4, #6, #8 and #10. The suffix \":N\" specifies stride "
21917 "in the range, for example 0-10:3 is interpreted as 0,3,6,9 list."
21920 #. type: Plain text
21921 #: ../schedutils/taskset.1.adoc:68
21923 "When *taskset* returns, it is guaranteed that the given program has been "
21924 "scheduled to a legal CPU."
21927 #. type: Plain text
21928 #: ../schedutils/taskset.1.adoc:73
21930 "Set or retrieve the CPU affinity of all the tasks (threads) for a given PID."
21933 #. type: Labeled list
21934 #: ../schedutils/taskset.1.adoc:74
21936 #| msgid "*-P*, *--pty*"
21937 msgid "*-c*, *--cpu-list*"
21938 msgstr "*-P*, *--pty*"
21940 #. type: Plain text
21941 #: ../schedutils/taskset.1.adoc:76
21943 "Interpret _mask_ as numerical list of processors instead of a bitmask. "
21944 "Numbers are separated by commas and may include ranges. For example: "
21949 #: ../schedutils/taskset.1.adoc:82 ../schedutils/uclampset.1.adoc:92
21954 #. TRANSLATORS: Keep {colon} untranslated.
21955 #. type: Labeled list
21956 #: ../schedutils/taskset.1.adoc:85
21958 msgid "The default behavior is to run a new command with a given affinity mask{colon}"
21961 #. type: Plain text
21962 #: ../schedutils/taskset.1.adoc:87
21964 msgid "*taskset* _mask_ _command_ [_arguments_]\n"
21967 #. TRANSLATORS: Keep {colon} untranslated.
21968 #. type: Labeled list
21969 #: ../schedutils/taskset.1.adoc:89
21971 msgid "You can also retrieve the CPU affinity of an existing task{colon}"
21974 #. type: Plain text
21975 #: ../schedutils/taskset.1.adoc:91
21977 msgid "*taskset -p* _pid_\n"
21980 #. TRANSLATORS: Keep {colon} untranslated.
21981 #. type: Labeled list
21982 #: ../schedutils/taskset.1.adoc:93
21984 msgid "Or set it{colon}"
21987 #. type: Plain text
21988 #: ../schedutils/taskset.1.adoc:95
21990 msgid "*taskset -p* _mask pid_\n"
21993 #. TRANSLATORS: Keep {colon} untranslated.
21994 #. type: Labeled list
21995 #: ../schedutils/taskset.1.adoc:97
21997 msgid "When a cpu-list is specified for an existing process, the *-p* and *-c* options must be grouped together{colon}"
22000 #. type: Plain text
22001 #: ../schedutils/taskset.1.adoc:99
22003 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
22004 msgid "*taskset -pc* _cpu-list pid_\n"
22005 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
22007 #. TRANSLATORS: Keep {colon} untranslated.
22008 #. type: Labeled list
22009 #: ../schedutils/taskset.1.adoc:101
22011 msgid "The *--cpu-list* form is applicable only for launching new commands{colon}"
22014 #. type: Plain text
22015 #: ../schedutils/taskset.1.adoc:103
22017 msgid "*taskset --cpu-list* _cpu-list command_\n"
22020 #. type: Plain text
22021 #: ../schedutils/taskset.1.adoc:107
22023 "A user can change the CPU affinity of a process belonging to the same user. "
22024 "A user must possess *CAP_SYS_NICE* to change the CPU affinity of a process "
22025 "belonging to another user. A user can retrieve the affinity mask of any "
22029 #. type: Plain text
22030 #: ../schedutils/taskset.1.adoc:111
22032 msgid "*taskset* returns 0 in its affinity-getting mode as long as the provided PID exists.\n"
22035 #. type: Plain text
22036 #: ../schedutils/taskset.1.adoc:113
22038 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"
22041 #. type: Plain text
22042 #: ../schedutils/taskset.1.adoc:125
22045 "$ ps ax -o comm,psr,pid | grep kswapd +\n"
22047 "$ sudo taskset -p 1 82 +\n"
22048 "pid 82's current affinity mask: 1 +\n"
22049 "pid 82's new affinity mask: 1 +\n"
22052 "$ ps ax -o comm,psr,pid | grep kswapd +\n"
22054 "$ taskset -p 82 +\n"
22055 "pid 82's current affinity mask: 1 +\n"
22058 #. type: Plain text
22059 #: ../schedutils/taskset.1.adoc:127
22061 "In contrast, when the user specifies an illegal affinity, taskset will print "
22062 "an error and return 1:"
22065 #. type: Plain text
22066 #: ../schedutils/taskset.1.adoc:135
22069 "$ ps ax -o comm,psr,pid | grep ksoftirqd/0 +\n"
22070 "ksoftirqd/0 0 14 +\n"
22071 "$ sudo taskset -p 1 14 +\n"
22072 "pid 14's current affinity mask: 1 +\n"
22073 "taskset: failed to set pid 14's affinity: Invalid argument +\n"
22078 #. type: Plain text
22079 #: ../schedutils/taskset.1.adoc:139
22080 msgid "Written by Robert M. Love."
22084 #: ../schedutils/taskset.1.adoc:140 ../sys-utils/chcpu.8.adoc:72
22085 #: ../sys-utils/flock.1.adoc:126 ../sys-utils/rtcwake.8.adoc:126
22086 #: ../term-utils/scriptlive.1.adoc:66 ../term-utils/scriptreplay.1.adoc:83
22091 #. TRANSLATORS: Keep {copyright} untranslated.
22092 #. type: Plain text
22093 #: ../schedutils/taskset.1.adoc:144
22095 "Copyright {copyright} 2004 Robert M. Love. This is free software; see the "
22096 "source for copying conditions. There is NO warranty; not even for "
22097 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
22100 #. type: Plain text
22101 #: ../schedutils/taskset.1.adoc:152
22107 "*sched_getaffinity*(2),\n"
22108 "*sched_setaffinity*(2)\n"
22111 #. type: Plain text
22112 #: ../schedutils/taskset.1.adoc:154
22113 msgid "See *sched*(7) for a description of the Linux scheduling scheme."
22121 #. uclampset(1) manpage
22122 #. Copyright (C) 2020-2021 Qais Yousef <qyousef@layalina.io>
22123 #. Copyright (C) 2020-2021 Arm Ltd
22124 #. This is free documentation; you can redistribute it and/or
22125 #. modify it under the terms of the GNU General Public License,
22126 #. version 2, as published by the Free Software Foundation.
22127 #. The GNU General Public License's references to "object code"
22128 #. and "executables" are to be interpreted as the output of any
22129 #. document formatting or typesetting system, including
22130 #. intermediate and printed output.
22131 #. This manual is distributed in the hope that it will be useful,
22132 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
22133 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22134 #. GNU General Public License for more details.
22135 #. You should have received a copy of the GNU General Public License along
22136 #. with this program; if not, write to the Free Software Foundation, Inc.,
22137 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22139 #: ../schedutils/uclampset.1.adoc:26
22141 msgid "uclampset(1)"
22144 #. type: Plain text
22145 #: ../schedutils/uclampset.1.adoc:38
22147 "uclampset - manipulate the utilization clamping attributes of the system or "
22151 #. type: Plain text
22152 #: ../schedutils/uclampset.1.adoc:42
22154 msgid "*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max] _command argument_\n"
22157 #. type: Plain text
22158 #: ../schedutils/uclampset.1.adoc:44
22160 msgid "*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max_] *-p* _PID_\n"
22163 #. type: Plain text
22164 #: ../schedutils/uclampset.1.adoc:48
22166 msgid "*uclampset* sets or retrieves the utilization clamping attributes of an existing _PID_, or runs _command_ with the given attributes.\n"
22169 #. type: Plain text
22170 #: ../schedutils/uclampset.1.adoc:50
22172 "Utilization clamping is a new feature added in v5.3. It gives a hint to the "
22173 "scheduler about the allowed range of utilization the task should be "
22177 #. type: Plain text
22178 #: ../schedutils/uclampset.1.adoc:52
22180 "The utilization of the task affects frequency selection and task placement. "
22181 "Only schedutil cpufreq governor understands handling util clamp hints at the "
22182 "time of writing. Consult your kernel docs for further info about other "
22183 "cpufreq governors support."
22186 #. type: Plain text
22187 #: ../schedutils/uclampset.1.adoc:54
22189 "If you're running on asymmetric heterogeneous system like Arm's big.LITTLE. "
22190 "Utilization clamping can help bias task placement. If the task is boosted "
22191 "such that _util_min_ value is higher than the little cores' capacity, then "
22192 "the scheduler will do its best to place it on a big core."
22195 #. type: Plain text
22196 #: ../schedutils/uclampset.1.adoc:56
22198 "Similarly, if _util_max_ is smaller than or equal the capacity of the little "
22199 "cores, then the scheduler can still choose to place it there even if the "
22200 "actual utilization of the task is at max."
22203 #. type: Plain text
22204 #: ../schedutils/uclampset.1.adoc:58
22206 "Setting a task's _uclamp_min_ to a none zero value will effectively boost "
22207 "the task as when it runs it'll always start from this utilization value."
22210 #. type: Plain text
22211 #: ../schedutils/uclampset.1.adoc:60
22213 "By setting a task's _uclamp_max_ below 1024, this will effectively cap the "
22214 "task as when it runs it'll never be able to go above this utilization value."
22217 #. type: Plain text
22218 #: ../schedutils/uclampset.1.adoc:62
22220 "The full utilization range is: [0:1024]. The special value -1 is used to "
22221 "reset to system's default."
22224 #. type: Plain text
22225 #: ../schedutils/uclampset.1.adoc:64
22226 msgid "Consult latest kernel documentation for more details:"
22229 #. type: Plain text
22230 #: ../schedutils/uclampset.1.adoc:66
22232 msgid "\thttps://kernel.org/doc/html/latest/scheduler/sched-util-clamp.html\n"
22235 #. type: Plain text
22236 #: ../schedutils/uclampset.1.adoc:71
22237 msgid "Set _util_min_ value."
22240 #. type: Plain text
22241 #: ../schedutils/uclampset.1.adoc:74
22242 msgid "Set _util_max_ value."
22245 #. type: Plain text
22246 #: ../schedutils/uclampset.1.adoc:77
22248 "Set or retrieve the utilization clamping attributes of all the tasks "
22249 "(threads) for a given PID."
22252 #. type: Labeled list
22253 #: ../schedutils/uclampset.1.adoc:81
22255 #| msgid "*-f*, *--fast*"
22256 msgid "*-s*, *--system*"
22257 msgstr "*-f*, *--fast*"
22259 #. type: Plain text
22260 #: ../schedutils/uclampset.1.adoc:83
22261 msgid "Set or retrieve the system-wide utilization clamping attributes."
22264 #. type: Plain text
22265 #: ../schedutils/uclampset.1.adoc:86
22266 msgid "Set *SCHED_FLAG_RESET_ON_FORK* flag."
22269 #. type: Plain text
22270 #: ../schedutils/uclampset.1.adoc:97
22272 msgid "*uclampset* _[-m uclamp_min]_ _[-M uclamp_max]_ _command_ [_arguments_]\n"
22275 #. TRANSLATORS: Keep {colon} untranslated.
22276 #. type: Labeled list
22277 #: ../schedutils/uclampset.1.adoc:99
22279 msgid "You can also retrieve the utilization clamping attributes of an existing task{colon}"
22282 #. type: Plain text
22283 #: ../schedutils/uclampset.1.adoc:101
22285 msgid "*uclampset -p* _PID_\n"
22288 #. type: Plain text
22289 #: ../schedutils/uclampset.1.adoc:105
22291 msgid "*uclampset -p* _PID_ _[-m uclamp_min]_ _[-M uclamp_max]_\n"
22294 #. TRANSLATORS: Keep {colon} untranslated.
22295 #. type: Labeled list
22296 #: ../schedutils/uclampset.1.adoc:107
22298 msgid "Or control the system-wide attributes{colon}"
22301 #. type: Plain text
22302 #: ../schedutils/uclampset.1.adoc:109
22304 msgid "*uclampset -s* _[-m uclamp_min]_ _[-M uclamp_max]_\n"
22307 #. type: Plain text
22308 #: ../schedutils/uclampset.1.adoc:117
22310 "The system wide utilization clamp attributes are there to control the "
22311 "_allowed_ range the tasks can use. By default both _uclamp_min_ and "
22312 "_uclamp_max_ are set to 1024. This means users can set the utilization clamp "
22313 "values for their task across the full range [0:1024]."
22316 #. TRANSLATORS: Keep {colon} untranslated.
22317 #. type: Labeled list
22318 #: ../schedutils/uclampset.1.adoc:119
22320 msgid "For example{colon}"
22323 #. type: Plain text
22324 #: ../schedutils/uclampset.1.adoc:121
22326 msgid "*uclampset -s* `-m 512` `-M 700`\n"
22329 #. type: Plain text
22330 #: ../schedutils/uclampset.1.adoc:123
22332 "will prevent any task from being boosted higher than 512. And all tasks in "
22333 "the systems are capped to a utilization of 700. Effectively rendering the "
22334 "maximum performance of the system to 700."
22337 #. type: Plain text
22338 #: ../schedutils/uclampset.1.adoc:125
22340 "Consult your kernel docs for the exact expected behavior on that kernel."
22343 #. type: Plain text
22344 #: ../schedutils/uclampset.1.adoc:129
22345 msgid "mailto:qyousef@layalina.io[Qais Yousef]"
22348 #. type: Plain text
22349 #: ../schedutils/uclampset.1.adoc:138
22351 "See *sched_setscheduler*(2) and *sched_setattr*(2) for a description of the "
22352 "Linux scheduling scheme."
22356 #: ../sys-utils/adjtime_config.5.adoc:2
22358 msgid "adjtime_config(5)"
22361 #. type: Plain text
22362 #: ../sys-utils/adjtime_config.5.adoc:12
22364 "adjtime_config - information about hardware clock setting and drift factor"
22367 #. type: Plain text
22368 #: ../sys-utils/adjtime_config.5.adoc:16 ../sys-utils/adjtime_config.5.adoc:53
22370 #| msgid "_/etc/pam.d/su_"
22371 msgid "_/etc/adjtime_"
22372 msgstr "_/etc/pam.d/su_"
22374 #. type: Plain text
22375 #: ../sys-utils/adjtime_config.5.adoc:20
22377 "The file _/etc/adjtime_ contains descriptive information about the hardware "
22378 "mode clock setting and clock drift factor. The file is read and write by "
22379 "*hwclock*(8); and read by programs like rtcwake to get RTC time mode."
22382 #. type: Plain text
22383 #: ../sys-utils/adjtime_config.5.adoc:22
22385 "The file is usually located in _/etc_, but tools like *hwclock*(8) or "
22386 "*rtcwake*(8) can use alternative location by command line options if write "
22387 "access to _/etc_ is unwanted. The default clock mode is \"UTC\" if the file "
22391 #. type: Plain text
22392 #: ../sys-utils/adjtime_config.5.adoc:24
22394 "The Hardware Clock is usually not very accurate. However, much of its "
22395 "inaccuracy is completely predictable - it gains or loses the same amount of "
22396 "time every day. This is called systematic drift. The util *hwclock*(8) keeps "
22397 "the file _/etc/adjtime_, that keeps some historical information. For more "
22398 "details see \"*The Adjust Function*\" and \"*The Adjtime File*\" sections "
22399 "from *hwclock*(8) man page."
22402 #. type: Plain text
22403 #: ../sys-utils/adjtime_config.5.adoc:26
22404 msgid "The _adjtime_ file is formatted in ASCII."
22408 #: ../sys-utils/adjtime_config.5.adoc:27
22413 #. type: Plain text
22414 #: ../sys-utils/adjtime_config.5.adoc:30
22415 msgid "Three numbers, separated by blanks:"
22418 #. type: Labeled list
22419 #: ../sys-utils/adjtime_config.5.adoc:31
22421 msgid "*drift factor*"
22424 #. type: Plain text
22425 #: ../sys-utils/adjtime_config.5.adoc:33
22426 msgid "the systematic drift rate in seconds per day (floating point decimal)"
22429 #. type: Labeled list
22430 #: ../sys-utils/adjtime_config.5.adoc:34
22432 msgid "*last adjust time*"
22435 #. type: Plain text
22436 #: ../sys-utils/adjtime_config.5.adoc:36
22438 "the resulting number of seconds since 1969 UTC of most recent adjustment or "
22439 "calibration (decimal integer)"
22442 #. type: Labeled list
22443 #: ../sys-utils/adjtime_config.5.adoc:37
22445 msgid "*adjustment status*"
22448 #. type: Plain text
22449 #: ../sys-utils/adjtime_config.5.adoc:39
22450 msgid "zero (for compatibility with *clock*(8)) as a floating point decimal"
22454 #: ../sys-utils/adjtime_config.5.adoc:40
22456 msgid "Second line"
22459 #. type: Labeled list
22460 #: ../sys-utils/adjtime_config.5.adoc:42
22462 msgid "*last calibration time*"
22465 #. type: Plain text
22466 #: ../sys-utils/adjtime_config.5.adoc:44
22468 "The resulting number of seconds since 1969 UTC of most recent calibration. "
22469 "Zero if there has been no calibration yet or it is known that any previous "
22470 "calibration is moot (for example, because the Hardware Clock has been found, "
22471 "since that calibration, not to contain a valid time). This is a decimal "
22476 #: ../sys-utils/adjtime_config.5.adoc:45
22481 #. type: Labeled list
22482 #: ../sys-utils/adjtime_config.5.adoc:47
22484 msgid "*clock mode*"
22487 #. type: Plain text
22488 #: ../sys-utils/adjtime_config.5.adoc:49
22490 "Supported values are *UTC* or *LOCAL*. Tells whether the Hardware Clock is "
22491 "set to Coordinated Universal Time or local time. You can always override "
22492 "this value with options on the *hwclock*(8) command line."
22495 #. type: Plain text
22496 #: ../sys-utils/adjtime_config.5.adoc:58
22504 #: ../sys-utils/blkdiscard.8.adoc:2
22506 msgid "blkdiscard(8)"
22509 #. type: Plain text
22510 #: ../sys-utils/blkdiscard.8.adoc:12
22511 msgid "blkdiscard - discard sectors on a device"
22514 #. type: Plain text
22515 #: ../sys-utils/blkdiscard.8.adoc:16
22517 msgid "*blkdiscard* [options] [*-o* _offset_] [*-l* _length_] _device_\n"
22520 #. type: Plain text
22521 #: ../sys-utils/blkdiscard.8.adoc:20
22523 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"
22526 #. type: Plain text
22527 #: ../sys-utils/blkdiscard.8.adoc:22
22529 "By default, *blkdiscard* will discard all blocks on the device. Options may "
22530 "be used to modify this behavior based on range or size, as explained below."
22533 #. type: Plain text
22534 #: ../sys-utils/blkdiscard.8.adoc:24 ../sys-utils/blkzone.8.adoc:22
22535 #: ../sys-utils/blkpr.8.adoc:22
22536 msgid "The _device_ argument is the pathname of the block device."
22539 #. type: Plain text
22540 #: ../sys-utils/blkdiscard.8.adoc:26
22542 msgid "*WARNING: All data in the discarded region on the device will be lost!*\n"
22545 #. type: Plain text
22546 #: ../sys-utils/blkdiscard.8.adoc:30
22548 "The _offset_ and _length_ arguments may be followed by the multiplicative "
22549 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
22550 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
22551 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
22552 "PB, EB, ZB and YB."
22555 #. type: Plain text
22556 #: ../sys-utils/blkdiscard.8.adoc:33
22558 "Disable all checking. Since v2.36 the block device is open in exclusive mode "
22559 "(*O_EXCL*) by default to avoid collision with mounted filesystem or another "
22560 "kernel subsystem. The *--force* option disables the exclusive access mode."
22563 #. type: Plain text
22564 #: ../sys-utils/blkdiscard.8.adoc:36
22566 "Byte offset into the device from which to start discarding. The provided "
22567 "value must be aligned to the device sector size. The default value is zero."
22570 #. type: Plain text
22571 #: ../sys-utils/blkdiscard.8.adoc:39
22573 "The number of bytes to discard (counting from the starting point). The "
22574 "provided value must be aligned to the device sector size. If the specified "
22575 "value extends past the end of the device, *blkdiscard* will stop at the "
22576 "device size boundary. The default value extends to the end of the device."
22579 #. type: Labeled list
22580 #: ../sys-utils/blkdiscard.8.adoc:40
22582 msgid "*-p*, *--step* _length_"
22585 #. type: Plain text
22586 #: ../sys-utils/blkdiscard.8.adoc:42
22588 "The number of bytes to discard within one iteration. The default is to "
22589 "discard all by one ioctl call."
22592 #. type: Plain text
22593 #: ../sys-utils/blkdiscard.8.adoc:45
22594 msgid "Suppress warning messages."
22597 #. type: Labeled list
22598 #: ../sys-utils/blkdiscard.8.adoc:46
22600 #| msgid "*-h*, *--help*"
22601 msgid "*-s*, *--secure*"
22602 msgstr "*-h*, *--help*"
22604 #. type: Plain text
22605 #: ../sys-utils/blkdiscard.8.adoc:48
22607 "Perform a secure discard. A secure discard is the same as a regular discard "
22608 "except that all copies of the discarded blocks that were possibly created by "
22609 "garbage collection must also be erased. This requires support from the "
22613 #. type: Labeled list
22614 #: ../sys-utils/blkdiscard.8.adoc:49
22616 #| msgid "*-V*, *--version*"
22617 msgid "*-z*, *--zeroout*"
22618 msgstr "*-V*, *--version*"
22620 #. type: Plain text
22621 #: ../sys-utils/blkdiscard.8.adoc:51
22622 msgid "Zero-fill rather than discard."
22625 #. type: Plain text
22626 #: ../sys-utils/blkdiscard.8.adoc:54
22628 "Display the aligned values of _offset_ and _length_. If the *--step* option "
22629 "is specified, it prints the discard progress every second."
22632 #. type: Plain text
22633 #: ../sys-utils/blkdiscard.8.adoc:60
22635 msgid "*blkdiscard* has the following exit status values:\n"
22638 #. type: Plain text
22639 #: ../sys-utils/blkdiscard.8.adoc:66
22640 msgid "failure; incorrect invocation, permissions or any other generic error"
22643 #. type: Plain text
22644 #: ../sys-utils/blkdiscard.8.adoc:69
22645 msgid "failure; since v2.39, the device does not support discard operation"
22648 #. type: Plain text
22649 #: ../sys-utils/blkdiscard.8.adoc:74 ../sys-utils/fstrim.8.adoc:90
22651 "mailto:lczerner@redhat.com[Lukas Czerner], mailto:kzak@redhat.com[Karel Zak]"
22654 #. type: Plain text
22655 #: ../sys-utils/blkdiscard.8.adoc:78
22657 msgid "*fstrim*(8)\n"
22661 #: ../sys-utils/blkzone.8.adoc:2
22666 #. type: Plain text
22667 #: ../sys-utils/blkzone.8.adoc:12
22668 msgid "blkzone - run zone command on a device"
22671 #. type: Plain text
22672 #: ../sys-utils/blkzone.8.adoc:16
22674 msgid "*blkzone* _command_ [options] _device_\n"
22677 #. type: Plain text
22678 #: ../sys-utils/blkzone.8.adoc:20
22680 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"
22684 #: ../sys-utils/blkzone.8.adoc:25
22689 #. type: Plain text
22690 #: ../sys-utils/blkzone.8.adoc:28
22691 msgid "The command *blkzone report* is used to report device zone information."
22694 #. type: Plain text
22695 #: ../sys-utils/blkzone.8.adoc:30
22697 "By default, the command will report all zones from the start of the block "
22698 "device. Options may be used to modify this behavior, changing the starting "
22699 "zone or the size of the report, as explained below."
22702 #. type: Plain text
22703 #: ../sys-utils/blkzone.8.adoc:32
22704 msgid "Report output:"
22708 #: ../sys-utils/blkzone.8.adoc:42
22711 "|start |Zone start sector\n"
22712 "|len |Zone length in number of sectors\n"
22713 "|cap |Zone capacity in number of sectors\n"
22714 "|wptr |Zone write pointer position\n"
22715 "|reset |Reset write pointer recommended\n"
22716 "|non-seq |Non-sequential write resources active\n"
22717 "|cond |Zone condition\n"
22718 "|type |Zone type\n"
22721 #. type: Plain text
22722 #: ../sys-utils/blkzone.8.adoc:45
22723 msgid "Zone conditions:"
22727 #: ../sys-utils/blkzone.8.adoc:56
22731 "|nw |Not write pointer\n"
22734 "|oe |Explicitly opened\n"
22735 "|oi |Implicitly opened\n"
22738 "|x? |Reserved conditions (should not be reported)\n"
22742 #: ../sys-utils/blkzone.8.adoc:58
22747 #. type: Plain text
22748 #: ../sys-utils/blkzone.8.adoc:61
22750 "The command *blkzone capacity* is used to report device capacity information."
22753 #. type: Plain text
22754 #: ../sys-utils/blkzone.8.adoc:63
22756 "By default, the command will report the sum, in number of sectors, of all "
22757 "zone capacities on the device. Options may be used to modify this behavior, "
22758 "changing the starting zone or the size of the report, as explained below."
22762 #: ../sys-utils/blkzone.8.adoc:64
22767 #. type: Plain text
22768 #: ../sys-utils/blkzone.8.adoc:67
22770 "The command *blkzone reset* is used to reset one or more zones. Unlike "
22771 "*sg_reset_wp*(8), this command operates from the block layer and can reset a "
22776 #: ../sys-utils/blkzone.8.adoc:68
22781 #. type: Plain text
22782 #: ../sys-utils/blkzone.8.adoc:71
22784 "The command *blkzone open* is used to explicitly open one or more zones. "
22785 "Unlike *sg_zone*(8), open action, this command operates from the block layer "
22786 "and can open a range of zones."
22790 #: ../sys-utils/blkzone.8.adoc:72
22795 #. type: Plain text
22796 #: ../sys-utils/blkzone.8.adoc:75
22798 "The command *blkzone close* is used to close one or more zones. Unlike "
22799 "*sg_zone*(8), close action, this command operates from the block layer and "
22800 "can close a range of zones."
22804 #: ../sys-utils/blkzone.8.adoc:76
22809 #. type: Plain text
22810 #: ../sys-utils/blkzone.8.adoc:79
22812 "The command *blkzone finish* is used to finish (transition to full "
22813 "condition) one or more zones. Unlike *sg_zone*(8), finish action, this "
22814 "command operates from the block layer and can finish a range of zones."
22817 #. type: Plain text
22818 #: ../sys-utils/blkzone.8.adoc:81
22820 "By default, the *reset*, *open*, *close* and *finish* commands will operate "
22821 "from the zone at device sector 0 and operate on all zones. Options may be "
22822 "used to modify this behavior as explained below."
22825 #. type: Plain text
22826 #: ../sys-utils/blkzone.8.adoc:85
22828 "The _offset_ and _length_ option arguments may be followed by the "
22829 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
22830 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
22831 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
22832 "for GB, TB, PB, EB, ZB and YB. Additionally, the 0x prefix can be used to "
22833 "specify _offset_ and _length_ in hex."
22836 #. type: Labeled list
22837 #: ../sys-utils/blkzone.8.adoc:86
22839 #| msgid "*-f*, *--fast*"
22840 msgid "*-o*, *--offset* _sector_"
22841 msgstr "*-f*, *--fast*"
22843 #. type: Plain text
22844 #: ../sys-utils/blkzone.8.adoc:88
22846 "The starting zone specified as a sector offset. The provided offset in "
22847 "sector units (512 bytes) should match the start of a zone. The default value "
22851 #. type: Labeled list
22852 #: ../sys-utils/blkzone.8.adoc:89
22854 msgid "*-l*, *--length* _sectors_"
22857 #. type: Plain text
22858 #: ../sys-utils/blkzone.8.adoc:91
22860 "The maximum number of sectors the command should operate on. The default "
22861 "value is the number of sectors remaining after _offset_. This option cannot "
22862 "be used together with the option *--count*."
22865 #. type: Plain text
22866 #: ../sys-utils/blkzone.8.adoc:94
22868 "The maximum number of zones the command should operate on. The default value "
22869 "is the number of zones starting from _offset_. This option cannot be used "
22870 "together with the option *--length*."
22873 #. type: Plain text
22874 #: ../sys-utils/blkzone.8.adoc:97
22876 "Enforce commands to change zone status on block devices used by the system."
22879 #. type: Plain text
22880 #: ../sys-utils/blkzone.8.adoc:100
22882 "Display the number of zones returned in the report or the range of sectors "
22886 #. type: Plain text
22887 #: ../sys-utils/blkzone.8.adoc:107
22889 "mailto:shaun@tancheff.com[Shaun Tancheff], mailto:kzak@redhat.com[Karel Zak]"
22892 #. type: Plain text
22893 #: ../sys-utils/blkzone.8.adoc:111
22895 msgid "*sg_rep_zones*(8)\n"
22899 #: ../sys-utils/blkpr.8.adoc:2
22904 #. type: Plain text
22905 #: ../sys-utils/blkpr.8.adoc:12
22906 msgid "blkpr - run persistent reservations command on a device"
22909 #. type: Plain text
22910 #: ../sys-utils/blkpr.8.adoc:16
22912 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
22913 msgid "*blkpr* [options] _device_\n"
22914 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
22916 #. type: Plain text
22917 #: ../sys-utils/blkpr.8.adoc:20
22919 msgid "*blkpr* is used to run persistent reservations command on device that supports Persistent Reservations feature.\n"
22922 #. type: Labeled list
22923 #: ../sys-utils/blkpr.8.adoc:25 ../sys-utils/flock.1.adoc:56
22924 #: ../term-utils/script.1.adoc:69
22926 #| msgid "*-c*, **--command**=__command__"
22927 msgid "*-c*, *--command* _command_"
22928 msgstr "*-c*, **--command**=__příkaz__"
22930 #. type: Plain text
22931 #: ../sys-utils/blkpr.8.adoc:28
22933 "The command of persistent reservations, supported commands are *register*, "
22934 "*reserve*, *release*, *preempt*, *preempt-abort*, and *clear*."
22937 #. type: Labeled list
22938 #: ../sys-utils/blkpr.8.adoc:29
22940 #| msgid "*-s*, **--shell**=__shell__"
22941 msgid "*-k*, *--key* _key_"
22942 msgstr "*-s*, **--shell**=__shell__"
22944 #. type: Plain text
22945 #: ../sys-utils/blkpr.8.adoc:31
22947 #| msgid "The requested command was not found"
22948 msgid "The key the command should operate on."
22949 msgstr "Požadovaný příkaz nebyl nalezen"
22951 #. type: Labeled list
22952 #: ../sys-utils/blkpr.8.adoc:32
22954 #| msgid "*-c*, **--command**=__command__"
22955 msgid "*-K*, *--oldkey* _oldkey_"
22956 msgstr "*-c*, **--command**=__příkaz__"
22958 #. type: Plain text
22959 #: ../sys-utils/blkpr.8.adoc:34
22960 msgid "The old key the command should operate on."
22963 #. type: Labeled list
22964 #: ../sys-utils/blkpr.8.adoc:35
22966 #| msgid "*-f*, *--fast*"
22967 msgid "*-f*, *--flag* _flag_"
22968 msgstr "*-f*, *--fast*"
22970 #. type: Plain text
22971 #: ../sys-utils/blkpr.8.adoc:37
22972 msgid "Supported flag is *ignore-key*."
22975 #. type: Plain text
22976 #: ../sys-utils/blkpr.8.adoc:41
22978 "Supported types are *write-exclusive*, *exclusive-access*, *write-exclusive-"
22979 "reg-only*, *exclusive-access-reg-only*, *write-exclusive-all-regs*, and "
22980 "*exclusive-access-all-regs*."
22983 #. type: Plain text
22984 #: ../sys-utils/blkpr.8.adoc:51
22985 msgid "mailto:pizhenwei@bytedance.com[zhenwei pi]"
22988 #. type: Plain text
22989 #: ../sys-utils/blkpr.8.adoc:55
22991 msgid "*sg_persist*(8)\n"
22994 #. type: Plain text
22995 #: ../sys-utils/blkpr.8.adoc:59
22997 "Linux documentation at: <https://docs.kernel.org/block/pr.html> iSCSI "
22998 "specification at: <https://datatracker.ietf.org/doc/html/rfc3720> NVMe-oF "
22999 "specification at: <https://nvmexpress.org/nvme-over-fabrics-part-two/>"
23003 #: ../sys-utils/chcpu.8.adoc:2
23008 #. type: Plain text
23009 #: ../sys-utils/chcpu.8.adoc:12
23010 msgid "chcpu - configure CPUs"
23013 #. type: Plain text
23014 #: ../sys-utils/chcpu.8.adoc:16
23016 msgid "*chcpu* *-c*|*-d*|*-e*|*-g* _cpu-list_\n"
23019 #. type: Plain text
23020 #: ../sys-utils/chcpu.8.adoc:18
23022 msgid "*chcpu* *-p* _mode_\n"
23025 #. type: Plain text
23026 #: ../sys-utils/chcpu.8.adoc:20
23028 msgid "*chcpu* *-r*|*-h*|*-V*\n"
23031 #. type: Plain text
23032 #: ../sys-utils/chcpu.8.adoc:24
23034 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"
23037 #. type: Plain text
23038 #: ../sys-utils/chcpu.8.adoc:26
23040 "Some options have a _cpu-list_ argument. Use this argument to specify a "
23041 "comma-separated list of CPUs. The list can contain individual CPU addresses "
23042 "or ranges of addresses. For example, *0,5,7,9-11* makes the command "
23043 "applicable to the CPUs with the addresses 0, 5, 7, 9, 10, and 11."
23046 #. type: Labeled list
23047 #: ../sys-utils/chcpu.8.adoc:29
23049 msgid "*-c*, *--configure* _cpu-list_"
23052 #. type: Plain text
23053 #: ../sys-utils/chcpu.8.adoc:31
23055 "Configure the specified CPUs. Configuring a CPU means that the hypervisor "
23056 "takes a CPU from the CPU pool and assigns it to the virtual hardware on "
23057 "which your kernel runs."
23060 #. type: Labeled list
23061 #: ../sys-utils/chcpu.8.adoc:32
23063 msgid "*-d*, *--disable* _cpu-list_"
23066 #. type: Plain text
23067 #: ../sys-utils/chcpu.8.adoc:34
23069 "Disable the specified CPUs. Disabling a CPU means that the kernel sets it "
23073 #. type: Labeled list
23074 #: ../sys-utils/chcpu.8.adoc:35
23076 msgid "*-e*, *--enable* _cpu-list_"
23079 #. type: Plain text
23080 #: ../sys-utils/chcpu.8.adoc:37
23082 "Enable the specified CPUs. Enabling a CPU means that the kernel sets it "
23083 "online. A CPU must be configured, see *-c*, before it can be enabled."
23086 #. type: Labeled list
23087 #: ../sys-utils/chcpu.8.adoc:38
23089 msgid "*-g*, *--deconfigure* _cpu-list_"
23092 #. type: Plain text
23093 #: ../sys-utils/chcpu.8.adoc:40
23095 "Deconfigure the specified CPUs. Deconfiguring a CPU means that the "
23096 "hypervisor removes the CPU from the virtual hardware on which the Linux "
23097 "instance runs and returns it to the CPU pool. A CPU must be offline, see *-"
23098 "d*, before it can be deconfigured."
23101 #. type: Labeled list
23102 #: ../sys-utils/chcpu.8.adoc:41
23104 msgid "*-p*, *--dispatch* _mode_"
23107 #. type: Plain text
23108 #: ../sys-utils/chcpu.8.adoc:43
23110 "Set the CPU dispatching _mode_ (polarization). This option has an effect "
23111 "only if your hardware architecture and hypervisor support CPU polarization. "
23112 "Available _modes_ are:"
23115 #. type: Labeled list
23116 #: ../sys-utils/chcpu.8.adoc:44
23118 msgid "*horizontal*"
23121 #. type: Plain text
23122 #: ../sys-utils/chcpu.8.adoc:46
23123 msgid "The workload is spread across all available CPUs."
23126 #. type: Labeled list
23127 #: ../sys-utils/chcpu.8.adoc:47
23132 #. type: Plain text
23133 #: ../sys-utils/chcpu.8.adoc:49
23134 msgid "The workload is concentrated on few CPUs."
23137 #. type: Labeled list
23138 #: ../sys-utils/chcpu.8.adoc:50
23140 #| msgid "*-V*, *--version*"
23141 msgid "*-r*, *--rescan*"
23142 msgstr "*-V*, *--version*"
23144 #. type: Plain text
23145 #: ../sys-utils/chcpu.8.adoc:52
23147 "Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the "
23148 "new CPUs. Use this option on systems that do not automatically detect newly "
23152 #. type: Plain text
23153 #: ../sys-utils/chcpu.8.adoc:58
23155 msgid "*chcpu* has the following exit status values:\n"
23158 #. type: Plain text
23159 #: ../sys-utils/chcpu.8.adoc:67 ../sys-utils/chmem.8.adoc:66
23160 msgid "partial success"
23163 #. type: Plain text
23164 #: ../sys-utils/chcpu.8.adoc:71
23165 msgid "mailto:heiko.carstens@de.ibm.com[Heiko Carstens]"
23168 #. type: Plain text
23169 #: ../sys-utils/chcpu.8.adoc:75
23170 msgid "Copyright IBM Corp. 2011"
23173 #. type: Plain text
23174 #: ../sys-utils/chcpu.8.adoc:79
23176 msgid "*lscpu*(1)\n"
23180 #: ../sys-utils/chmem.8.adoc:2
23185 #. type: Plain text
23186 #: ../sys-utils/chmem.8.adoc:12
23187 msgid "chmem - configure memory"
23190 #. type: Plain text
23191 #: ../sys-utils/chmem.8.adoc:16
23193 msgid "*chmem* [*-h] [*-V*] [*-v*] [*-e*|*-d*] [_SIZE_|_RANGE_ *-b* _BLOCKRANGE_] [*-z* _ZONE_]\n"
23196 #. type: Plain text
23197 #: ../sys-utils/chmem.8.adoc:20
23199 "The chmem command sets a particular size or range of memory online or "
23203 #. type: Plain text
23204 #: ../sys-utils/chmem.8.adoc:22
23206 "Specify _SIZE_ as <size>[m|M|g|G]. With m or M, <size> specifies the memory "
23207 "size in MiB (1024 x 1024 bytes). With g or G, <size> specifies the memory "
23208 "size in GiB (1024 x 1024 x 1024 bytes). The default unit is MiB."
23211 #. type: Plain text
23212 #: ../sys-utils/chmem.8.adoc:24
23214 "Specify _RANGE_ in the form 0x<start>-0x<end> as shown in the output of the "
23215 "*lsmem*(1) command. <start> is the hexadecimal address of the first byte and "
23216 "<end> is the hexadecimal address of the last byte in the memory range."
23219 #. type: Plain text
23220 #: ../sys-utils/chmem.8.adoc:26
23222 "Specify _BLOCKRANGE_ in the form <first>-<last> or <block> as shown in the "
23223 "output of the *lsmem*(1) command. <first> is the number of the first memory "
23224 "block and <last> is the number of the last memory block in the memory range. "
23225 "Alternatively a single block can be specified. _BLOCKRANGE_ requires the *--"
23229 #. type: Plain text
23230 #: ../sys-utils/chmem.8.adoc:28
23232 "Specify _ZONE_ as the name of a memory zone, as shown in the output of the "
23233 "*lsmem -o +ZONES* command. The output shows one or more valid memory zones "
23234 "for each memory range. If multiple zones are shown, then the memory range "
23235 "currently belongs to the first zone. By default, *chmem* will set memory "
23236 "online to the zone Movable, if this is among the valid zones. This default "
23237 "can be changed by specifying the *--zone* option with another valid zone. "
23238 "For memory ballooning, it is recommended to select the zone Movable for "
23239 "memory online and offline, if possible. Memory in this zone is much more "
23240 "likely to be able to be offlined again, but it cannot be used for arbitrary "
23241 "kernel allocations, only for migratable pages (e.g., anonymous and page "
23242 "cache pages). Use the *--help* option to see all available zones."
23245 #. type: Plain text
23246 #: ../sys-utils/chmem.8.adoc:30
23248 "_SIZE_ and _RANGE_ must be aligned to the Linux memory block size, as shown "
23249 "in the output of the *lsmem*(1) command."
23252 #. type: Plain text
23253 #: ../sys-utils/chmem.8.adoc:32
23255 "Setting memory online can fail for various reasons. On virtualized systems "
23256 "it can fail if the hypervisor does not have enough memory left, for example "
23257 "because memory was overcommitted. Setting memory offline can fail if Linux "
23258 "cannot free the memory. If only part of the requested memory can be set "
23259 "online or offline, a message tells you how much memory was set online or "
23260 "offline instead of the requested amount."
23263 #. type: Plain text
23264 #: ../sys-utils/chmem.8.adoc:34
23266 "When setting memory online *chmem* starts with the lowest memory block "
23267 "numbers. When setting memory offline *chmem* starts with the highest memory "
23271 #. type: Labeled list
23272 #: ../sys-utils/chmem.8.adoc:37
23274 #| msgid "*-h*, *--help*"
23275 msgid "*-b*, *--blocks*"
23276 msgstr "*-h*, *--help*"
23278 #. type: Plain text
23279 #: ../sys-utils/chmem.8.adoc:39
23281 "Use a _BLOCKRANGE_ parameter instead of _RANGE_ or _SIZE_ for the *--enable* "
23282 "and *--disable* options."
23285 #. type: Labeled list
23286 #: ../sys-utils/chmem.8.adoc:40
23288 #| msgid "*-h*, *--help*"
23289 msgid "*-d*, *--disable*"
23290 msgstr "*-h*, *--help*"
23292 #. type: Plain text
23293 #: ../sys-utils/chmem.8.adoc:42
23294 msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory offline."
23297 #. type: Labeled list
23298 #: ../sys-utils/chmem.8.adoc:43
23300 #| msgid "*-h*, *--help*"
23301 msgid "*-e*, *--enable*"
23302 msgstr "*-h*, *--help*"
23304 #. type: Plain text
23305 #: ../sys-utils/chmem.8.adoc:45
23306 msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online."
23309 #. type: Labeled list
23310 #: ../sys-utils/chmem.8.adoc:46
23312 #| msgid "*-h*, *--help*"
23313 msgid "*-z*, *--zone*"
23314 msgstr "*-h*, *--help*"
23316 #. type: Plain text
23317 #: ../sys-utils/chmem.8.adoc:48
23319 "Select the memory _ZONE_ where to set the specified _RANGE_, _SIZE_, or "
23320 "_BLOCKRANGE_ of memory online or offline. By default, memory will be set "
23321 "online to the zone Movable, if possible."
23324 #. type: Plain text
23325 #: ../sys-utils/chmem.8.adoc:51
23327 "Verbose mode. Causes *chmem* to print debugging messages about it's progress."
23330 #. type: Plain text
23331 #: ../sys-utils/chmem.8.adoc:57
23333 msgid "*chmem* has the following exit status values:\n"
23336 #. type: Labeled list
23337 #: ../sys-utils/chmem.8.adoc:69
23339 msgid "*chmem --enable 1024*"
23342 #. type: Plain text
23343 #: ../sys-utils/chmem.8.adoc:71
23344 msgid "This command requests 1024 MiB of memory to be set online."
23347 #. type: Labeled list
23348 #: ../sys-utils/chmem.8.adoc:72
23350 msgid "*chmem -e 2g*"
23353 #. type: Plain text
23354 #: ../sys-utils/chmem.8.adoc:74
23355 msgid "This command requests 2 GiB of memory to be set online."
23358 #. type: Labeled list
23359 #: ../sys-utils/chmem.8.adoc:75
23361 msgid "*chmem --disable 0x00000000e4000000-0x00000000f3ffffff*"
23364 #. type: Plain text
23365 #: ../sys-utils/chmem.8.adoc:77
23367 "This command requests the memory range starting with 0x00000000e4000000 and "
23368 "ending with 0x00000000f3ffffff to be set offline."
23371 #. type: Labeled list
23372 #: ../sys-utils/chmem.8.adoc:78
23374 msgid "*chmem -b -d 10*"
23377 #. type: Plain text
23378 #: ../sys-utils/chmem.8.adoc:80
23379 msgid "This command requests the memory block number 10 to be set offline."
23382 #. type: Plain text
23383 #: ../sys-utils/chmem.8.adoc:84
23385 msgid "*lsmem*(1)\n"
23389 #: ../sys-utils/choom.1.adoc:2
23394 #. type: Plain text
23395 #: ../sys-utils/choom.1.adoc:12
23396 msgid "choom - display and adjust OOM-killer score."
23399 #. type: Plain text
23400 #: ../sys-utils/choom.1.adoc:14
23402 msgid "*choom* *-p* _PID_\n"
23405 #. type: Plain text
23406 #: ../sys-utils/choom.1.adoc:16
23408 msgid "*choom* *-p* _PID_ *-n* _number_\n"
23411 #. type: Plain text
23412 #: ../sys-utils/choom.1.adoc:18
23414 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
23415 msgid "*choom* *-n* _number_ [--] _command_ [_argument_ ...]\n"
23416 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
23418 #. type: Plain text
23419 #: ../sys-utils/choom.1.adoc:22
23421 "The *choom* command displays and adjusts Out-Of-Memory killer score setting."
23424 #. type: Plain text
23425 #: ../sys-utils/choom.1.adoc:27
23426 msgid "Specifies process ID."
23429 #. type: Labeled list
23430 #: ../sys-utils/choom.1.adoc:28
23432 #| msgid "*-f*, *--fast*"
23433 msgid "*-n*, *--adjust* _value_"
23434 msgstr "*-f*, *--fast*"
23436 #. type: Plain text
23437 #: ../sys-utils/choom.1.adoc:30
23438 msgid "Specify the adjust score value."
23441 #. type: Plain text
23442 #: ../sys-utils/choom.1.adoc:36
23444 "Linux kernel uses the badness heuristic to select which process gets killed "
23445 "in out of memory conditions."
23448 #. type: Plain text
23449 #: ../sys-utils/choom.1.adoc:38
23451 "The badness heuristic assigns a value to each candidate task ranging from 0 "
23452 "(never kill) to 1000 (always kill) to determine which process is targeted. "
23453 "The units are roughly a proportion along that range of allowed memory the "
23454 "process may allocate from based on an estimation of its current memory and "
23455 "swap use. For example, if a task is using all allowed memory, its badness "
23456 "score will be 1000. If it is using half of its allowed memory, its score "
23460 #. type: Plain text
23461 #: ../sys-utils/choom.1.adoc:40
23463 "There is an additional factor included in the badness score: the current "
23464 "memory and swap usage is discounted by 3% for root processes."
23467 #. type: Plain text
23468 #: ../sys-utils/choom.1.adoc:42
23470 "The amount of \"allowed\" memory depends on the context in which the oom "
23471 "killer was called. If it is due to the memory assigned to the allocating "
23472 "task's cpuset being exhausted, the allowed memory represents the set of mems "
23473 "assigned to that cpuset. If it is due to a mempolicy's node(s) being "
23474 "exhausted, the allowed memory represents the set of mempolicy nodes. If it "
23475 "is due to a memory limit (or swap limit) being reached, the allowed memory "
23476 "is that configured limit. Finally, if it is due to the entire system being "
23477 "out of memory, the allowed memory represents all allocatable resources."
23480 #. type: Plain text
23481 #: ../sys-utils/choom.1.adoc:44
23483 "The adjust score value is added to the badness score before it is used to "
23484 "determine which task to kill. Acceptable values range from -1000 to +1000. "
23485 "This allows userspace to polarize the preference for oom killing either by "
23486 "always preferring a certain task or completely disabling it. The lowest "
23487 "possible value, -1000, is equivalent to disabling oom killing entirely for "
23488 "that task since it will always report a badness score of 0."
23491 #. type: Plain text
23492 #: ../sys-utils/choom.1.adoc:46
23494 "Setting an adjust score value of +500, for example, is roughly equivalent to "
23495 "allowing the remainder of tasks sharing the same system, cpuset, mempolicy, "
23496 "or memory controller resources to use at least 50% more memory. A value of "
23497 "-500, on the other hand, would be roughly equivalent to discounting 50% of "
23498 "the task's allowed memory from being considered as scoring against the task."
23501 #. type: Plain text
23502 #: ../sys-utils/choom.1.adoc:54
23504 msgid "*proc*(5)\n"
23507 #. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
23508 #. May be distributed under the GNU General Public License
23510 #: ../sys-utils/ctrlaltdel.8.adoc:6
23512 msgid "ctrlaltdel(8)"
23515 #. type: Plain text
23516 #: ../sys-utils/ctrlaltdel.8.adoc:16
23517 msgid "ctrlaltdel - set the function of the Ctrl-Alt-Del combination"
23520 #. type: Plain text
23521 #: ../sys-utils/ctrlaltdel.8.adoc:20
23523 msgid "*ctrlaltdel* *hard*|*soft*\n"
23526 #. type: Plain text
23527 #: ../sys-utils/ctrlaltdel.8.adoc:24
23529 "Based on examination of the _linux/kernel/reboot.c_ code, it is clear that "
23530 "there are two supported functions that the <Ctrl-Alt-Del> sequence can "
23534 #. type: Labeled list
23535 #: ../sys-utils/ctrlaltdel.8.adoc:25
23540 #. type: Plain text
23541 #: ../sys-utils/ctrlaltdel.8.adoc:27
23543 "Immediately reboot the computer without calling *sync*(2) and without any "
23544 "other preparation. This is the default."
23547 #. type: Labeled list
23548 #: ../sys-utils/ctrlaltdel.8.adoc:28
23553 #. type: Plain text
23554 #: ../sys-utils/ctrlaltdel.8.adoc:30
23556 "Make the kernel send the *SIGINT* (interrupt) signal to the *init* process "
23557 "(this is always the process with PID 1). If this option is used, the "
23558 "*init*(8) program must support this feature. Since there are now several "
23559 "*init*(8) programs in the Linux community, please consult the documentation "
23560 "for the version that you are currently using."
23563 #. type: Plain text
23564 #: ../sys-utils/ctrlaltdel.8.adoc:32
23566 "When the command is run without any argument, it will display the current "
23570 #. type: Plain text
23571 #: ../sys-utils/ctrlaltdel.8.adoc:34
23573 "The function of *ctrlaltdel* is usually set in the _/etc/rc.local_ file."
23576 #. type: Plain text
23577 #: ../sys-utils/ctrlaltdel.8.adoc:42
23578 msgid "_/etc/rc.local_"
23581 #. type: Plain text
23582 #: ../sys-utils/ctrlaltdel.8.adoc:46
23583 msgid "mailto:poe@daimi.aau.dk[Peter Orbaek]"
23586 #. type: Plain text
23587 #: ../sys-utils/ctrlaltdel.8.adoc:51
23594 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
23595 #. May be distributed under the GNU General Public License
23597 #: ../sys-utils/dmesg.1.adoc:6
23602 #. type: Plain text
23603 #: ../sys-utils/dmesg.1.adoc:16
23604 msgid "dmesg - print or control the kernel ring buffer"
23607 #. type: Plain text
23608 #: ../sys-utils/dmesg.1.adoc:20
23610 msgid "*dmesg* [options]\n"
23613 #. type: Plain text
23614 #: ../sys-utils/dmesg.1.adoc:22
23616 msgid "*dmesg* *--clear*\n"
23619 #. type: Plain text
23620 #: ../sys-utils/dmesg.1.adoc:24
23622 msgid "*dmesg* *--read-clear* [options]\n"
23625 #. type: Plain text
23626 #: ../sys-utils/dmesg.1.adoc:26
23628 msgid "*dmesg* *--console-level* _level_\n"
23631 #. type: Plain text
23632 #: ../sys-utils/dmesg.1.adoc:28
23634 msgid "*dmesg* *--console-on*\n"
23637 #. type: Plain text
23638 #: ../sys-utils/dmesg.1.adoc:30
23640 msgid "*dmesg* *--console-off*\n"
23643 #. type: Plain text
23644 #: ../sys-utils/dmesg.1.adoc:34
23646 msgid "*dmesg* is used to examine or control the kernel ring buffer.\n"
23649 #. type: Plain text
23650 #: ../sys-utils/dmesg.1.adoc:36
23652 "The default action is to display all messages from the kernel ring buffer."
23655 #. type: Plain text
23656 #: ../sys-utils/dmesg.1.adoc:40
23658 "The *--clear*, *--read-clear*, *--console-on*, *--console-off*, and *--"
23659 "console-level* options are mutually exclusive."
23662 #. type: Labeled list
23663 #: ../sys-utils/dmesg.1.adoc:41
23665 #| msgid "*-h*, *--help*"
23666 msgid "*-C*, *--clear*"
23667 msgstr "*-h*, *--help*"
23669 #. type: Plain text
23670 #: ../sys-utils/dmesg.1.adoc:43
23671 msgid "Clear the ring buffer."
23674 #. type: Labeled list
23675 #: ../sys-utils/dmesg.1.adoc:44
23677 #| msgid "*-h*, *--help*"
23678 msgid "*-c*, *--read-clear*"
23679 msgstr "*-h*, *--help*"
23681 #. type: Plain text
23682 #: ../sys-utils/dmesg.1.adoc:46
23683 msgid "Clear the ring buffer after first printing its contents."
23686 #. type: Labeled list
23687 #: ../sys-utils/dmesg.1.adoc:47
23689 msgid "*-D*, *--console-off*"
23692 #. type: Plain text
23693 #: ../sys-utils/dmesg.1.adoc:49
23694 msgid "Disable the printing of messages to the console."
23697 #. type: Labeled list
23698 #: ../sys-utils/dmesg.1.adoc:50
23700 #| msgid "*-h*, *--help*"
23701 msgid "*-d*, *--show-delta*"
23702 msgstr "*-h*, *--help*"
23704 #. type: Plain text
23705 #: ../sys-utils/dmesg.1.adoc:52
23707 "Display the timestamp and the time delta spent between messages. If used "
23708 "together with *--notime* then only the time delta without the timestamp is "
23712 #. type: Labeled list
23713 #: ../sys-utils/dmesg.1.adoc:53
23715 #| msgid "*-V*, *--version*"
23716 msgid "*-E*, *--console-on*"
23717 msgstr "*-V*, *--version*"
23719 #. type: Plain text
23720 #: ../sys-utils/dmesg.1.adoc:55
23721 msgid "Enable printing messages to the console."
23724 #. type: Labeled list
23725 #: ../sys-utils/dmesg.1.adoc:56
23727 #| msgid "*-h*, *--help*"
23728 msgid "*-e*, *--reltime*"
23729 msgstr "*-h*, *--help*"
23731 #. type: Plain text
23732 #: ../sys-utils/dmesg.1.adoc:58
23734 "Display the local time and the delta in human-readable format. Be aware that "
23735 "conversion to the local time could be inaccurate (see *-T* for more details)."
23738 #. type: Labeled list
23739 #: ../sys-utils/dmesg.1.adoc:59
23741 msgid "*-F*, *--file* _file_"
23744 #. type: Plain text
23745 #: ../sys-utils/dmesg.1.adoc:61
23747 "Read the syslog messages from the given _file_. Note that *-F* does not "
23748 "support messages in kmsg format. See *-K* instead."
23751 #. type: Labeled list
23752 #: ../sys-utils/dmesg.1.adoc:62
23754 #| msgid "*-f*, *--fast*"
23755 msgid "*-f*, *--facility* _list_"
23756 msgstr "*-f*, *--fast*"
23758 #. type: Plain text
23759 #: ../sys-utils/dmesg.1.adoc:64
23761 "Restrict output to the given (comma-separated) _list_ of facilities. For "
23765 #. type: Plain text
23766 #: ../sys-utils/dmesg.1.adoc:66
23768 msgid "*dmesg --facility=daemon*\n"
23771 #. type: Plain text
23772 #: ../sys-utils/dmesg.1.adoc:68
23774 "will print messages from system daemons only. For all supported facilities "
23775 "see the *--help* output."
23778 #. type: Labeled list
23779 #: ../sys-utils/dmesg.1.adoc:69
23781 #| msgid "*-h*, *--help*"
23782 msgid "*-H*, *--human*"
23783 msgstr "*-h*, *--help*"
23785 #. type: Plain text
23786 #: ../sys-utils/dmesg.1.adoc:71
23788 "Enable human-readable output. See also *--color*, *--reltime* and *--"
23792 #. type: Plain text
23793 #: ../sys-utils/dmesg.1.adoc:74
23795 "Use JSON output format. The time output format is in \"sec.usec\" format "
23796 "only, log priority level is not decoded by default (use *--decode* to split "
23797 "into facility and priority), the other options to control the output format "
23798 "or time format are silently ignored."
23801 #. type: Labeled list
23802 #: ../sys-utils/dmesg.1.adoc:75
23804 #| msgid "*-f*, *--fast*"
23805 msgid "*-K*, *--kmsg-file* _file_"
23806 msgstr "*-f*, *--fast*"
23808 #. type: Plain text
23809 #: ../sys-utils/dmesg.1.adoc:77
23811 "Read the /dev/kmsg messages from the given _file_. Different record as "
23812 "expected to be separated by a NULL byte."
23815 #. type: Plain text
23816 #: ../sys-utils/dmesg.1.adoc:80
23817 msgid "Print kernel messages."
23820 #. type: Plain text
23821 #: ../sys-utils/dmesg.1.adoc:83
23823 "Colorize the output. The optional argument _when_ can be *auto*, *never* or "
23824 "*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
23825 "colors can be disabled; for the current built-in default see the *--help* "
23826 "output. See also the *COLORS* section below."
23829 #. type: Labeled list
23830 #: ../sys-utils/dmesg.1.adoc:84
23832 #| msgid "*-h*, *--help*"
23833 msgid "*-l*, *--level* _list_"
23834 msgstr "*-h*, *--help*"
23836 #. type: Plain text
23837 #: ../sys-utils/dmesg.1.adoc:86
23839 "Restrict output to the given (comma-separated) _list_ of levels. For example:"
23842 #. type: Plain text
23843 #: ../sys-utils/dmesg.1.adoc:88
23845 msgid "*dmesg --level=err,warn*\n"
23848 #. type: Plain text
23849 #: ../sys-utils/dmesg.1.adoc:90
23851 "will print error and warning messages only. For all supported levels see the "
23855 #. type: Plain text
23856 #: ../sys-utils/dmesg.1.adoc:92
23858 "Appending a plus *+* to a level name also includes all higher levels. For "
23862 #. type: Plain text
23863 #: ../sys-utils/dmesg.1.adoc:94
23865 msgid "*dmesg --level=err+*\n"
23868 #. type: Plain text
23869 #: ../sys-utils/dmesg.1.adoc:96
23870 msgid "will print levels *err*, *crit*, *alert* and *emerg*."
23873 #. type: Plain text
23874 #: ../sys-utils/dmesg.1.adoc:98
23875 msgid "Prepending it will include all lower levels."
23878 #. type: Labeled list
23879 #: ../sys-utils/dmesg.1.adoc:99
23881 msgid "*-n*, *--console-level* _level_"
23884 #. type: Plain text
23885 #: ../sys-utils/dmesg.1.adoc:101
23887 "Set the _level_ at which printing of messages is done to the console. The "
23888 "_level_ is a level number or abbreviation of the level name. For all "
23889 "supported levels see the *--help* output."
23892 #. type: Plain text
23893 #: ../sys-utils/dmesg.1.adoc:103
23895 "For example, *-n 1* or *-n emerg* prevents all messages, except emergency "
23896 "(panic) messages, from appearing on the console. All levels of messages are "
23897 "still written to _/proc/kmsg_, so *syslogd*(8) can still be used to control "
23898 "exactly where kernel messages appear. When the *-n* option is used, *dmesg* "
23899 "will _not_ print or clear the kernel ring buffer."
23902 #. type: Labeled list
23903 #: ../sys-utils/dmesg.1.adoc:104
23905 msgid "*--noescape*"
23908 #. type: Plain text
23909 #: ../sys-utils/dmesg.1.adoc:106
23911 "The unprintable and potentially unsafe characters (e.g., broken multi-byte "
23912 "sequences, terminal controlling chars, etc.) are escaped in format \\x<hex> "
23913 "for security reason by default. This option disables this feature at all. "
23914 "It's usable for example for debugging purpose together with *--raw*. Be "
23915 "careful and don't use it by default."
23918 #. type: Labeled list
23919 #: ../sys-utils/dmesg.1.adoc:107
23921 #| msgid "*-P*, *--pty*"
23922 msgid "*-P*, *--nopager*"
23923 msgstr "*-P*, *--pty*"
23925 #. type: Plain text
23926 #: ../sys-utils/dmesg.1.adoc:109
23928 "Do not pipe output into a pager. A pager is enabled by default for *--human* "
23932 #. type: Labeled list
23933 #: ../sys-utils/dmesg.1.adoc:110
23935 #| msgid "*-V*, *--version*"
23936 msgid "*-p*, *--force-prefix*"
23937 msgstr "*-V*, *--version*"
23939 #. type: Plain text
23940 #: ../sys-utils/dmesg.1.adoc:112
23942 "Add facility, level or timestamp information to each line of a multi-line "
23946 #. type: Plain text
23947 #: ../sys-utils/dmesg.1.adoc:115
23949 "Print the raw message buffer, i.e., do not strip the log-level prefixes, but "
23950 "all unprintable characters are still escaped (see also *--noescape*)."
23953 #. type: Plain text
23954 #: ../sys-utils/dmesg.1.adoc:117
23956 "Note that the real raw format depends on the method how *dmesg* reads kernel "
23957 "messages. The _/dev/kmsg_ device uses a different format than *syslog*(2). "
23958 "For backward compatibility, *dmesg* returns data always in the *syslog*(2) "
23959 "format. It is possible to read the real raw data from _/dev/kmsg_ by, for "
23960 "example, the command 'dd if=/dev/kmsg iflag=nonblock'."
23963 #. type: Labeled list
23964 #: ../sys-utils/dmesg.1.adoc:118
23966 #| msgid "*-P*, *--pty*"
23967 msgid "*-S*, *--syslog*"
23968 msgstr "*-P*, *--pty*"
23970 #. type: Plain text
23971 #: ../sys-utils/dmesg.1.adoc:120
23973 "Force *dmesg* to use the *syslog*(2) kernel interface to read kernel "
23974 "messages. The default is to use _/dev/kmsg_ rather than *syslog*(2) since "
23978 #. type: Labeled list
23979 #: ../sys-utils/dmesg.1.adoc:121
23981 msgid "*-s*, *--buffer-size* _size_"
23984 #. type: Plain text
23985 #: ../sys-utils/dmesg.1.adoc:123
23987 "Use a buffer of _size_ to query the kernel ring buffer. This is 16392 by "
23988 "default. (The default kernel syslog buffer size was 4096 at first, 8192 "
23989 "since 1.3.54, 16384 since 2.1.113.) If you have set the kernel buffer to be "
23990 "larger than the default, then this option can be used to view the entire "
23994 #. type: Labeled list
23995 #: ../sys-utils/dmesg.1.adoc:124
23997 #| msgid "*-P*, *--pty*"
23998 msgid "*-T*, *--ctime*"
23999 msgstr "*-P*, *--pty*"
24001 #. type: Plain text
24002 #: ../sys-utils/dmesg.1.adoc:126
24003 msgid "Print human-readable timestamps."
24006 #. type: Plain text
24007 #: ../sys-utils/dmesg.1.adoc:128
24009 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"
24012 #. type: Labeled list
24013 #: ../sys-utils/dmesg.1.adoc:129
24015 msgid "*--since* _time_"
24018 #. type: Plain text
24019 #: ../sys-utils/dmesg.1.adoc:131
24021 "Display record since the specified time. Supported is the subsecond "
24022 "granularity. The time is possible to specify in absolute way as well as by "
24023 "relative notation (e.g. '1 hour ago'). Be aware that the timestamp could be "
24024 "inaccurate and see *--ctime* for more details."
24027 #. type: Labeled list
24028 #: ../sys-utils/dmesg.1.adoc:132
24030 msgid "*--until* _time_"
24033 #. type: Plain text
24034 #: ../sys-utils/dmesg.1.adoc:134
24036 "Display record until the specified time. Supported is the subsecond "
24037 "granularity. The time is possible to specify in absolute way as well as by "
24038 "relative notation (e.g. '1 hour ago'). Be aware that the timestamp could be "
24039 "inaccurate and see *--ctime* for more details."
24042 #. type: Labeled list
24043 #: ../sys-utils/dmesg.1.adoc:135
24045 #| msgid "*-P*, *--pty*"
24046 msgid "*-t*, *--notime*"
24047 msgstr "*-P*, *--pty*"
24049 #. type: Plain text
24050 #: ../sys-utils/dmesg.1.adoc:137
24051 msgid "Do not print kernel's timestamps."
24054 #. type: Plain text
24055 #: ../sys-utils/dmesg.1.adoc:140
24057 "Print timestamps using the given _format_, which can be *ctime*, *reltime*, "
24058 "*delta*, *iso* or *raw*. The first three formats are aliases of the time-"
24059 "format-specific options. The *raw* format uses the default timestamp format "
24060 "showing seconds since boot. The *iso* format is a *dmesg* implementation of "
24061 "the ISO-8601 timestamp format. The purpose of this format is to make the "
24062 "comparing of timestamps between two systems, and any other parsing, easy. "
24063 "The definition of the *iso* timestamp is: YYYY-MM-DD<T>HH:MM:SS,"
24064 "<microseconds><-+><timezone offset from UTC>."
24067 #. type: Plain text
24068 #: ../sys-utils/dmesg.1.adoc:142
24070 "The *iso* format has the same issue as *ctime*: the time may be inaccurate "
24071 "when a system is suspended and resumed."
24074 #. type: Plain text
24075 #: ../sys-utils/dmesg.1.adoc:144
24077 msgid "*--time-format* may be used multiple times with different values for _format_ to output each specified format.\n"
24080 #. type: Plain text
24081 #: ../sys-utils/dmesg.1.adoc:146
24082 msgid "The *delta* always follows *ctime* or *raw* if specified together."
24085 #. type: Labeled list
24086 #: ../sys-utils/dmesg.1.adoc:147
24088 #| msgid "*-h*, *--help*"
24089 msgid "*-u*, *--userspace*"
24090 msgstr "*-h*, *--help*"
24092 #. type: Plain text
24093 #: ../sys-utils/dmesg.1.adoc:149
24094 msgid "Print userspace messages."
24097 #. type: Labeled list
24098 #: ../sys-utils/dmesg.1.adoc:150
24100 #| msgid "*-f*, *--fast*"
24101 msgid "*-w*, *--follow*"
24102 msgstr "*-f*, *--fast*"
24104 #. type: Plain text
24105 #: ../sys-utils/dmesg.1.adoc:152
24107 "Wait for new messages. This feature is supported only on systems with a "
24108 "readable _/dev/kmsg_ (since kernel 3.5.0)."
24111 #. type: Labeled list
24112 #: ../sys-utils/dmesg.1.adoc:153
24114 #| msgid "*-*, *-l*, *--login*"
24115 msgid "*-W*, *--follow-new*"
24116 msgstr "*-*, *-l*, *--login*"
24118 #. type: Plain text
24119 #: ../sys-utils/dmesg.1.adoc:155
24120 msgid "Wait and print only new messages."
24123 #. type: Labeled list
24124 #: ../sys-utils/dmesg.1.adoc:156
24126 #| msgid "*-h*, *--help*"
24127 msgid "*-x*, *--decode*"
24128 msgstr "*-h*, *--help*"
24130 #. type: Plain text
24131 #: ../sys-utils/dmesg.1.adoc:158
24133 "Decode facility and level (priority) numbers to human-readable prefixes."
24136 #. type: Plain text
24137 #: ../sys-utils/dmesg.1.adoc:163
24138 msgid "The logical color names supported by *dmesg* are:"
24141 #. type: Labeled list
24142 #: ../sys-utils/dmesg.1.adoc:164
24147 #. type: Plain text
24148 #: ../sys-utils/dmesg.1.adoc:166
24149 msgid "The message sub-system prefix (e.g., \"ACPI:\")."
24152 #. type: Plain text
24153 #: ../sys-utils/dmesg.1.adoc:169
24154 msgid "The message timestamp."
24157 #. type: Labeled list
24158 #: ../sys-utils/dmesg.1.adoc:170
24160 msgid "*timebreak*"
24163 #. type: Plain text
24164 #: ../sys-utils/dmesg.1.adoc:172
24166 "The message timestamp in short ctime format in *--reltime* or *--human* "
24170 #. type: Labeled list
24171 #: ../sys-utils/dmesg.1.adoc:173
24176 #. type: Plain text
24177 #: ../sys-utils/dmesg.1.adoc:175
24178 msgid "The text of the message with the alert log priority."
24181 #. type: Labeled list
24182 #: ../sys-utils/dmesg.1.adoc:176
24187 #. type: Plain text
24188 #: ../sys-utils/dmesg.1.adoc:178
24189 msgid "The text of the message with the critical log priority."
24192 #. type: Labeled list
24193 #: ../sys-utils/dmesg.1.adoc:179
24198 #. type: Plain text
24199 #: ../sys-utils/dmesg.1.adoc:181
24200 msgid "The text of the message with the error log priority."
24203 #. type: Plain text
24204 #: ../sys-utils/dmesg.1.adoc:184
24205 msgid "The text of the message with the warning log priority."
24208 #. type: Labeled list
24209 #: ../sys-utils/dmesg.1.adoc:185
24211 #| msgid "*defaults*"
24213 msgstr "*defaults*"
24215 #. type: Plain text
24216 #: ../sys-utils/dmesg.1.adoc:187
24217 msgid "The text of the message that inform about segmentation fault."
24220 #. type: Plain text
24221 #: ../sys-utils/dmesg.1.adoc:191
24223 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"
24226 #. type: Plain text
24227 #: ../sys-utils/dmesg.1.adoc:197
24229 msgid "*dmesg* was originally written by mailto:tytso@athena.mit.edu[Theodore Ts'o].\n"
24232 #. type: Plain text
24233 #: ../sys-utils/dmesg.1.adoc:202
24236 "*terminal-colors.d*(5),\n"
24241 #. Copyright (C) 1994-2005 Jeff Tranter (tranter@pobox.com)
24242 #. Copyright (C) 2012 Karel Zak <kzak@redhat.com>.
24243 #. It may be distributed under the GNU Public License, version 2, or
24244 #. any higher version. See section COPYING of the GNU Public license
24245 #. for conditions under which this file may be redistributed.
24247 #: ../sys-utils/eject.1.adoc:10
24252 #. type: Plain text
24253 #: ../sys-utils/eject.1.adoc:20
24254 msgid "eject - eject removable media"
24257 #. type: Plain text
24258 #: ../sys-utils/eject.1.adoc:22
24260 msgid "*eject* [options] _device_|_mountpoint_\n"
24263 #. type: Plain text
24264 #: ../sys-utils/eject.1.adoc:26
24266 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"
24269 #. type: Plain text
24270 #: ../sys-utils/eject.1.adoc:28
24272 "The device corresponding to _device_ or _mountpoint_ is ejected. If no name "
24273 "is specified, the default name */dev/cdrom* is used. The device may be "
24274 "addressed by device name (e.g., 'sda'), device path (e.g., '/dev/sda'), "
24275 "UUID=__uuid__ or LABEL=__label__ tags."
24278 #. type: Plain text
24279 #: ../sys-utils/eject.1.adoc:30
24281 "There are four different methods of ejecting, depending on whether the "
24282 "device is a CD-ROM, SCSI device, removable floppy, or tape. By default "
24283 "*eject* tries all four methods in order until it succeeds."
24286 #. type: Plain text
24287 #: ../sys-utils/eject.1.adoc:32
24288 msgid "If a device partition is specified, the whole-disk device is used."
24291 #. type: Plain text
24292 #: ../sys-utils/eject.1.adoc:34
24294 "If the device or a device partition is currently mounted, it is unmounted "
24295 "before ejecting. The eject is processed on exclusive open block device file "
24296 "descriptor if *--no-unmount* or *--force* are not specified."
24299 #. type: Labeled list
24300 #: ../sys-utils/eject.1.adoc:37
24302 msgid "*-a*, **--auto on**|*off*"
24305 #. type: Plain text
24306 #: ../sys-utils/eject.1.adoc:39
24308 "This option controls the auto-eject mode, supported by some devices. When "
24309 "enabled, the drive automatically ejects when the device is closed."
24312 #. type: Labeled list
24313 #: ../sys-utils/eject.1.adoc:40
24315 msgid "*-c*, *--changerslot* _slot_"
24318 #. type: Plain text
24319 #: ../sys-utils/eject.1.adoc:42
24321 "With this option a CD slot can be selected from an ATAPI/IDE CD-ROM changer. "
24322 "The CD-ROM drive cannot be in use (mounted data CD or playing a music CD) "
24323 "for a change request to work. Please also note that the first slot of the "
24324 "changer is referred to as 0, not 1."
24327 #. type: Labeled list
24328 #: ../sys-utils/eject.1.adoc:43
24330 #| msgid "*-f*, *--fast*"
24331 msgid "*-d*, *--default*"
24332 msgstr "*-f*, *--fast*"
24334 #. type: Plain text
24335 #: ../sys-utils/eject.1.adoc:45
24336 msgid "List the default device name."
24339 #. type: Labeled list
24340 #: ../sys-utils/eject.1.adoc:46
24342 #| msgid "*-f*, *--fast*"
24343 msgid "*-F*, *--force*"
24344 msgstr "*-f*, *--fast*"
24346 #. type: Plain text
24347 #: ../sys-utils/eject.1.adoc:48
24349 "Force eject, don't check device type, don't open device with exclusive lock. "
24350 "The successful result may be false positive on non hot-pluggable devices."
24353 #. type: Labeled list
24354 #: ../sys-utils/eject.1.adoc:49
24356 #| msgid "*-P*, *--pty*"
24357 msgid "*-f*, *--floppy*"
24358 msgstr "*-P*, *--pty*"
24360 #. type: Plain text
24361 #: ../sys-utils/eject.1.adoc:51
24363 "This option specifies that the drive should be ejected using a removable "
24364 "floppy disk eject command."
24367 #. type: Labeled list
24368 #: ../sys-utils/eject.1.adoc:52
24370 msgid "*-i*, **--manualeject on**|*off*"
24373 #. type: Plain text
24374 #: ../sys-utils/eject.1.adoc:54
24376 "This option controls locking of the hardware eject button. When enabled, the "
24377 "drive will not be ejected when the button is pressed. This is useful when "
24378 "you are carrying a laptop in a bag or case and don't want it to eject if the "
24379 "button is inadvertently pressed."
24382 #. type: Labeled list
24383 #: ../sys-utils/eject.1.adoc:55
24385 msgid "*-M*, *--no-partitions-unmount*"
24388 #. type: Plain text
24389 #: ../sys-utils/eject.1.adoc:57
24391 "The option tells *eject* to not try to unmount other partitions on "
24392 "partitioned devices. If another partition is still mounted, the program will "
24393 "not attempt to eject the media. It will attempt to unmount only the device "
24394 "or mountpoint given on the command line."
24397 #. type: Labeled list
24398 #: ../sys-utils/eject.1.adoc:58
24400 #| msgid "*-P*, *--pty*"
24401 msgid "*-m*, *--no-unmount*"
24402 msgstr "*-P*, *--pty*"
24404 #. type: Plain text
24405 #: ../sys-utils/eject.1.adoc:60
24407 "The option tells *eject* to not try to unmount at all. If this option is not "
24408 "specified then *eject* opens the device with *O_EXCL* flag to be sure that "
24409 "the device is not used (since v2.35)."
24412 #. type: Labeled list
24413 #: ../sys-utils/eject.1.adoc:61
24415 #| msgid "*-P*, *--pty*"
24416 msgid "*-n*, *--noop*"
24417 msgstr "*-P*, *--pty*"
24419 #. type: Plain text
24420 #: ../sys-utils/eject.1.adoc:63
24422 "With this option the selected device is displayed but no action is performed."
24425 #. type: Labeled list
24426 #: ../sys-utils/eject.1.adoc:64
24428 #| msgid "*-P*, *--pty*"
24429 msgid "*-p*, *--proc*"
24430 msgstr "*-P*, *--pty*"
24432 #. type: Plain text
24433 #: ../sys-utils/eject.1.adoc:66
24435 "This option allows you to use _/proc/mounts_ instead _/etc/mtab_. It also "
24436 "passes the *-n* option to *umount*(8)."
24439 #. type: Labeled list
24440 #: ../sys-utils/eject.1.adoc:67
24442 #| msgid "*-P*, *--pty*"
24443 msgid "*-q*, *--tape*"
24444 msgstr "*-P*, *--pty*"
24446 #. type: Plain text
24447 #: ../sys-utils/eject.1.adoc:69
24449 "This option specifies that the drive should be ejected using a tape drive "
24453 #. type: Labeled list
24454 #: ../sys-utils/eject.1.adoc:70
24456 #| msgid "*-V*, *--version*"
24457 msgid "*-r*, *--cdrom*"
24458 msgstr "*-V*, *--version*"
24460 #. type: Plain text
24461 #: ../sys-utils/eject.1.adoc:72
24463 "This option specifies that the drive should be ejected using a CDROM eject "
24467 #. type: Labeled list
24468 #: ../sys-utils/eject.1.adoc:73
24470 #| msgid "*-f*, *--fast*"
24471 msgid "*-s*, *--scsi*"
24472 msgstr "*-f*, *--fast*"
24474 #. type: Plain text
24475 #: ../sys-utils/eject.1.adoc:75
24477 "This option specifies that the drive should be ejected using SCSI commands."
24480 #. type: Labeled list
24481 #: ../sys-utils/eject.1.adoc:76
24483 #| msgid "*-P*, *--pty*"
24484 msgid "*-T*, *--traytoggle*"
24485 msgstr "*-P*, *--pty*"
24487 #. type: Plain text
24488 #: ../sys-utils/eject.1.adoc:78
24490 "With this option the drive is given a CD-ROM tray close command if it's "
24491 "opened, and a CD-ROM tray eject command if it's closed. Not all devices "
24492 "support this command, because it uses the above CD-ROM tray close command."
24495 #. type: Labeled list
24496 #: ../sys-utils/eject.1.adoc:79
24498 #| msgid "*-P*, *--pty*"
24499 msgid "*-t*, *--trayclose*"
24500 msgstr "*-P*, *--pty*"
24502 #. type: Plain text
24503 #: ../sys-utils/eject.1.adoc:81
24505 "With this option the drive is given a CD-ROM tray close command. Not all "
24506 "devices support this command."
24509 #. type: Plain text
24510 #: ../sys-utils/eject.1.adoc:86
24512 "Run in verbose mode; more information is displayed about what the command is "
24516 #. type: Labeled list
24517 #: ../sys-utils/eject.1.adoc:87
24519 #| msgid "*-h*, *--help*"
24520 msgid "*-X*, *--listspeed*"
24521 msgstr "*-h*, *--help*"
24523 #. type: Plain text
24524 #: ../sys-utils/eject.1.adoc:89
24526 "With this option the CD-ROM drive will be probed to detect the available "
24527 "speeds. The output is a list of speeds which can be used as an argument of "
24528 "the *-x* option. This only works with Linux 2.6.13 or higher, on previous "
24529 "versions solely the maximum speed will be reported. Also note that some "
24530 "drives may not correctly report the speed and therefore this option does not "
24534 #. type: Labeled list
24535 #: ../sys-utils/eject.1.adoc:90
24537 msgid "*-x*, *--cdspeed* _speed_"
24540 #. type: Plain text
24541 #: ../sys-utils/eject.1.adoc:92
24543 "With this option the drive is given a CD-ROM select speed command. The "
24544 "_speed_ argument is a number indicating the desired speed (e.g., 8 for 8X "
24545 "speed), or 0 for maximum data rate. Not all devices support this command and "
24546 "you can only specify speeds that the drive is capable of. Every time the "
24547 "media is changed this option is cleared. This option can be used alone, or "
24548 "with the *-t* and *-c* options."
24551 #. type: Plain text
24552 #: ../sys-utils/eject.1.adoc:100
24554 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"
24557 #. type: Plain text
24558 #: ../sys-utils/eject.1.adoc:102
24560 "The *-r*, *-s*, *-f*, and *-q* options allow controlling which methods are "
24561 "used to eject. More than one method can be specified. If none of these "
24562 "options are specified, it tries all four (this works fine in most cases)."
24565 #. type: Plain text
24566 #: ../sys-utils/eject.1.adoc:104
24568 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"
24571 #. type: Plain text
24572 #: ../sys-utils/eject.1.adoc:106
24574 "If *eject* determines that the device can have multiple partitions, it will "
24575 "attempt to unmount all mounted partitions of the device before ejecting (see "
24576 "also *--no-partitions-unmount*). If an unmount fails, the program will not "
24577 "attempt to eject the media."
24580 #. type: Plain text
24581 #: ../sys-utils/eject.1.adoc:108
24583 "You can eject an audio CD. Some CD-ROM drives will refuse to open the tray "
24584 "if the drive is empty. Some devices do not support the tray close command."
24587 #. type: Plain text
24588 #: ../sys-utils/eject.1.adoc:110
24590 "If the auto-eject feature is enabled, then the drive will always be ejected "
24591 "after running this command. Not all Linux kernel CD-ROM drivers support the "
24592 "auto-eject mode. There is no way to find out the state of the auto-eject "
24596 #. type: Plain text
24597 #: ../sys-utils/eject.1.adoc:112
24599 "You need appropriate privileges to access the device files. Running as root "
24600 "is required to eject some devices (e.g., SCSI devices)."
24603 #. type: Plain text
24604 #: ../sys-utils/eject.1.adoc:116
24606 "mailto:tranter@pobox.com[Jeff Tranter] - original author, mailto:kzak@redhat."
24607 "com[Karel Zak] and mailto:mluscon@redhat.com[Michal Luscon] - util-linux "
24611 #. type: Plain text
24612 #: ../sys-utils/eject.1.adoc:123
24615 #| "*getmntent*(3),\n"
24617 #| "*findmnt*(8),\n"
24626 "*getmntent*(3),\n"
24633 #: ../sys-utils/fallocate.1.adoc:2
24635 msgid "fallocate(1)"
24638 #. type: Plain text
24639 #: ../sys-utils/fallocate.1.adoc:12
24640 msgid "fallocate - preallocate or deallocate space to a file"
24643 #. type: Plain text
24644 #: ../sys-utils/fallocate.1.adoc:16
24646 msgid "*fallocate* [*-c*|*-p*|*-z*] [*-o* _offset_] *-l* _length_ [*-n*] _filename_\n"
24649 #. type: Plain text
24650 #: ../sys-utils/fallocate.1.adoc:18
24652 msgid "*fallocate* *-d* [*-o* _offset_] [*-l* _length_] _filename_\n"
24655 #. type: Plain text
24656 #: ../sys-utils/fallocate.1.adoc:20
24658 msgid "*fallocate* *-x* [*-o* _offset_] *-l* _length filename_\n"
24661 #. type: Plain text
24662 #: ../sys-utils/fallocate.1.adoc:24
24664 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"
24667 #. type: Plain text
24668 #: ../sys-utils/fallocate.1.adoc:26
24670 "The exit status returned by *fallocate* is 0 on success and 1 on failure."
24673 #. type: Plain text
24674 #: ../sys-utils/fallocate.1.adoc:30
24676 "The _length_ and _offset_ arguments may be followed by the multiplicative "
24677 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
24678 "ZiB, and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
24679 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
24680 "PB, EB, ZB, and YB."
24683 #. type: Plain text
24684 #: ../sys-utils/fallocate.1.adoc:32
24686 "The options *--collapse-range*, *--dig-holes*, *--punch-hole*, and *--zero-"
24687 "range* are mutually exclusive."
24690 #. type: Labeled list
24691 #: ../sys-utils/fallocate.1.adoc:33
24693 msgid "*-c*, *--collapse-range*"
24696 #. type: Plain text
24697 #: ../sys-utils/fallocate.1.adoc:35
24699 "Removes a byte range from a file, without leaving a hole. The byte range to "
24700 "be collapsed starts at _offset_ and continues for _length_ bytes. At the "
24701 "completion of the operation, the contents of the file starting at the "
24702 "location __offset__+_length_ will be appended at the location _offset_, and "
24703 "the file will be _length_ bytes smaller. The option *--keep-size* may not be "
24704 "specified for the collapse-range operation."
24707 #. type: Plain text
24708 #: ../sys-utils/fallocate.1.adoc:37
24710 "Available since Linux 3.15 for ext4 (only for extent-based files) and XFS."
24713 #. type: Plain text
24714 #: ../sys-utils/fallocate.1.adoc:39
24716 "A filesystem may place limitations on the granularity of the operation, in "
24717 "order to ensure efficient implementation. Typically, _offset_ and _length_ "
24718 "must be a multiple of the filesystem logical block size, which varies "
24719 "according to the filesystem type and configuration. If a filesystem has such "
24720 "a requirement, the operation will fail with the error *EINVAL* if this "
24721 "requirement is violated."
24724 #. type: Labeled list
24725 #: ../sys-utils/fallocate.1.adoc:40
24727 #| msgid "*-h*, *--help*"
24728 msgid "*-d*, *--dig-holes*"
24729 msgstr "*-h*, *--help*"
24731 #. type: Plain text
24732 #: ../sys-utils/fallocate.1.adoc:42
24734 "Detect and dig holes. This makes the file sparse in-place, without using "
24735 "extra disk space. The minimum size of the hole depends on filesystem I/O "
24736 "block size (usually 4096 bytes). Also, when using this option, *--keep-size* "
24737 "is implied. If no range is specified by *--offset* and *--length*, then the "
24738 "entire file is analyzed for holes."
24741 #. type: Plain text
24742 #: ../sys-utils/fallocate.1.adoc:44
24744 "You can think of this option as doing a \"*cp --sparse*\" and then renaming "
24745 "the destination file to the original, without the need for extra disk space."
24748 #. type: Plain text
24749 #: ../sys-utils/fallocate.1.adoc:46
24750 msgid "See *--punch-hole* for a list of supported filesystems."
24753 #. type: Labeled list
24754 #: ../sys-utils/fallocate.1.adoc:47
24756 #| msgid "*-V*, *--version*"
24757 msgid "*-i*, *--insert-range*"
24758 msgstr "*-V*, *--version*"
24760 #. type: Plain text
24761 #: ../sys-utils/fallocate.1.adoc:49
24762 msgid "Insert a hole of _length_ bytes from _offset_, shifting existing data."
24765 #. type: Plain text
24766 #: ../sys-utils/fallocate.1.adoc:52
24767 msgid "Specifies the length of the range, in bytes."
24770 #. type: Labeled list
24771 #: ../sys-utils/fallocate.1.adoc:53
24773 #| msgid "*-h*, *--help*"
24774 msgid "*-n*, *--keep-size*"
24775 msgstr "*-h*, *--help*"
24777 #. type: Plain text
24778 #: ../sys-utils/fallocate.1.adoc:55
24780 "Do not modify the apparent length of the file. This may effectively allocate "
24781 "blocks past EOF, which can be removed with a truncate."
24784 #. type: Plain text
24785 #: ../sys-utils/fallocate.1.adoc:58
24786 msgid "Specifies the beginning offset of the range, in bytes."
24789 #. type: Labeled list
24790 #: ../sys-utils/fallocate.1.adoc:59
24792 #| msgid "*-h*, *--help*"
24793 msgid "*-p*, *--punch-hole*"
24794 msgstr "*-h*, *--help*"
24796 #. type: Plain text
24797 #: ../sys-utils/fallocate.1.adoc:61
24799 "Deallocates space (i.e., creates a hole) in the byte range starting at "
24800 "_offset_ and continuing for _length_ bytes. Within the specified range, "
24801 "partial filesystem blocks are zeroed, and whole filesystem blocks are "
24802 "removed from the file. After a successful call, subsequent reads from this "
24803 "range will return zeroes. This option may not be specified at the same time "
24804 "as the *--zero-range* option. Also, when using this option, *--keep-size* is "
24808 #. type: Plain text
24809 #: ../sys-utils/fallocate.1.adoc:63
24811 "Supported for XFS (since Linux 2.6.38), ext4 (since Linux 3.0), Btrfs (since "
24812 "Linux 3.7), tmpfs (since Linux 3.5) and gfs2 (since Linux 4.16)."
24815 #. type: Plain text
24816 #: ../sys-utils/fallocate.1.adoc:66
24817 msgid "Enable verbose mode."
24820 #. type: Labeled list
24821 #: ../sys-utils/fallocate.1.adoc:67
24823 #| msgid "*-P*, *--pty*"
24824 msgid "*-x*, *--posix*"
24825 msgstr "*-P*, *--pty*"
24827 #. type: Plain text
24828 #: ../sys-utils/fallocate.1.adoc:69
24830 "Enable POSIX operation mode. In that mode allocation operation always "
24831 "completes, but it may take longer time when fast allocation is not supported "
24832 "by the underlying filesystem."
24835 #. type: Labeled list
24836 #: ../sys-utils/fallocate.1.adoc:70
24838 #| msgid "*-V*, *--version*"
24839 msgid "*-z*, *--zero-range*"
24840 msgstr "*-V*, *--version*"
24842 #. type: Plain text
24843 #: ../sys-utils/fallocate.1.adoc:72
24845 "Zeroes space in the byte range starting at _offset_ and continuing for "
24846 "_length_ bytes. Within the specified range, blocks are preallocated for the "
24847 "regions that span the holes in the file. After a successful call, subsequent "
24848 "reads from this range will return zeroes."
24851 #. type: Plain text
24852 #: ../sys-utils/fallocate.1.adoc:74
24854 "Zeroing is done within the filesystem preferably by converting the range "
24855 "into unwritten extents. This approach means that the specified range will "
24856 "not be physically zeroed out on the device (except for partial blocks at the "
24857 "either end of the range), and I/O is (otherwise) required only to update "
24861 #. type: Plain text
24862 #: ../sys-utils/fallocate.1.adoc:76
24864 "Option *--keep-size* can be specified to prevent file length modification."
24867 #. type: Plain text
24868 #: ../sys-utils/fallocate.1.adoc:78
24870 "Available since Linux 3.14 for ext4 (only for extent-based files) and XFS."
24873 #. type: Plain text
24874 #: ../sys-utils/fallocate.1.adoc:85
24876 "mailto:sandeen@redhat.com[Eric Sandeen], mailto:kzak@redhat.com[Karel Zak]"
24879 #. type: Plain text
24880 #: ../sys-utils/fallocate.1.adoc:91
24884 "*fallocate*(2),\n"
24885 "*posix_fallocate*(3)\n"
24891 #. Copyright 2003-2006 H. Peter Anvin - All Rights Reserved
24892 #. Permission is hereby granted, free of charge, to any person
24893 #. obtaining a copy of this software and associated documentation
24894 #. files (the "Software"), to deal in the Software without
24895 #. restriction, including without limitation the rights to use,
24896 #. copy, modify, merge, publish, distribute, sublicense, and/or
24897 #. sell copies of the Software, and to permit persons to whom
24898 #. the Software is furnished to do so, subject to the following
24900 #. The above copyright notice and this permission notice shall
24901 #. be included in all copies or substantial portions of the Software.
24902 #. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
24903 #. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
24904 #. OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24905 #. NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
24906 #. HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
24907 #. WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24908 #. FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
24909 #. OTHER DEALINGS IN THE SOFTWARE.
24911 #: ../sys-utils/flock.1.adoc:26
24916 #. type: Plain text
24917 #: ../sys-utils/flock.1.adoc:37
24918 msgid "flock - manage locks from shell scripts"
24921 #. type: Plain text
24922 #: ../sys-utils/flock.1.adoc:41
24924 msgid "*flock* [options] _file_|_directory_ _command_ [_arguments_]\n"
24927 #. type: Plain text
24928 #: ../sys-utils/flock.1.adoc:43
24930 msgid "*flock* [options] _file_|_directory_ *-c* _command_\n"
24933 #. type: Plain text
24934 #: ../sys-utils/flock.1.adoc:45
24936 msgid "*flock* [options] _number_\n"
24939 #. type: Plain text
24940 #: ../sys-utils/flock.1.adoc:49
24942 "This utility manages *flock*(2) locks from within shell scripts or from the "
24946 #. type: Plain text
24947 #: ../sys-utils/flock.1.adoc:51
24949 "The first and second of the above forms wrap the lock around the execution "
24950 "of a _command_, in a manner similar to *su*(1) or *newgrp*(1). They lock a "
24951 "specified _file_ or _directory_, which is created (assuming appropriate "
24952 "permissions) if it does not already exist. By default, if the lock cannot be "
24953 "immediately acquired, *flock* waits until the lock is available."
24956 #. type: Plain text
24957 #: ../sys-utils/flock.1.adoc:53
24959 "The third form uses an open file by its file descriptor _number_. See the "
24960 "examples below for how that can be used."
24963 #. type: Plain text
24964 #: ../sys-utils/flock.1.adoc:58
24966 #| msgid "Pass _command_ to the shell with the *-c* option."
24967 msgid "Pass a single _command_, without arguments, to the shell with *-c*."
24968 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
24970 #. type: Labeled list
24971 #: ../sys-utils/flock.1.adoc:59
24973 msgid "*-E*, *--conflict-exit-code* _number_"
24976 #. type: Plain text
24977 #: ../sys-utils/flock.1.adoc:61
24979 "The exit status used when the *-n* option is in use, and the conflicting "
24980 "lock exists, or the *-w* option is in use, and the timeout is reached. The "
24981 "default value is *1*. The _number_ has to be in the range of 0 to 255."
24984 #. type: Plain text
24985 #: ../sys-utils/flock.1.adoc:64
24987 "Do not fork before executing _command_. Upon execution the flock process is "
24988 "replaced by _command_ which continues to hold the lock. This option is "
24989 "incompatible with *--close* as there would otherwise be nothing left to hold "
24993 #. type: Labeled list
24994 #: ../sys-utils/flock.1.adoc:65
24996 #| msgid "*-*, *-l*, *--login*"
24997 msgid "*-e*, *-x*, *--exclusive*"
24998 msgstr "*-*, *-l*, *--login*"
25000 #. type: Plain text
25001 #: ../sys-utils/flock.1.adoc:67
25003 "Obtain an exclusive lock, sometimes called a write lock. This is the default."
25006 #. type: Labeled list
25007 #: ../sys-utils/flock.1.adoc:68
25009 #| msgid "*-*, *-l*, *--login*"
25010 msgid "*-n*, *--nb*, *--nonblock*"
25011 msgstr "*-*, *-l*, *--login*"
25013 #. type: Plain text
25014 #: ../sys-utils/flock.1.adoc:70
25016 "Fail rather than wait if the lock cannot be immediately acquired. See the *-"
25017 "E* option for the exit status used."
25020 #. type: Labeled list
25021 #: ../sys-utils/flock.1.adoc:71
25023 #| msgid "*-h*, *--help*"
25024 msgid "*-o*, *--close*"
25025 msgstr "*-h*, *--help*"
25027 #. type: Plain text
25028 #: ../sys-utils/flock.1.adoc:73
25030 "Close the file descriptor on which the lock is held before executing "
25031 "_command_. This is useful if _command_ spawns a child process which should "
25032 "not be holding the lock."
25035 #. type: Labeled list
25036 #: ../sys-utils/flock.1.adoc:74
25038 #| msgid "*-h*, *--help*"
25039 msgid "*-s*, *--shared*"
25040 msgstr "*-h*, *--help*"
25042 #. type: Plain text
25043 #: ../sys-utils/flock.1.adoc:76
25044 msgid "Obtain a shared lock, sometimes called a read lock."
25047 #. type: Labeled list
25048 #: ../sys-utils/flock.1.adoc:77
25050 #| msgid "*-h*, *--help*"
25051 msgid "*-u*, *--unlock*"
25052 msgstr "*-h*, *--help*"
25054 #. type: Plain text
25055 #: ../sys-utils/flock.1.adoc:79
25057 "Drop a lock. This is usually not required, since a lock is automatically "
25058 "dropped when the file is closed. However, it may be required in special "
25059 "cases, for example if the enclosed command group may have forked a "
25060 "background process which should not be holding the lock."
25063 #. type: Labeled list
25064 #: ../sys-utils/flock.1.adoc:80
25066 msgid "*-w*, *--wait*, *--timeout* _seconds_"
25069 #. type: Plain text
25070 #: ../sys-utils/flock.1.adoc:82
25072 "Fail if the lock cannot be acquired within _seconds_. Decimal fractional "
25073 "values are allowed. See the *-E* option for the exit status used. The zero "
25074 "number of _seconds_ is interpreted as *--nonblock*."
25077 #. type: Plain text
25078 #: ../sys-utils/flock.1.adoc:85
25080 "Report how long it took to acquire the lock, or why the lock could not be "
25084 #. type: Plain text
25085 #: ../sys-utils/flock.1.adoc:91
25087 "The command uses <sysexits.h> exit status values for everything, except when "
25088 "using either of the options *-n* or *-w* which report a failure to acquire "
25089 "the lock with an exit status given by the *-E* option, or 1 by default. The "
25090 "exit status given by *-E* has to be in the range of 0 to 255."
25093 #. type: Plain text
25094 #: ../sys-utils/flock.1.adoc:93
25096 "When using the _command_ variant, and executing the child worked, then the "
25097 "exit status is that of the child command."
25100 #. type: Plain text
25101 #: ../sys-utils/flock.1.adoc:97
25103 msgid "*flock* does not detect deadlock. See *flock*(2) for details.\n"
25106 #. type: Plain text
25107 #: ../sys-utils/flock.1.adoc:99
25109 "Some file systems (e. g. NFS and CIFS) have a limited implementation of "
25110 "*flock*(2) and flock may always fail. For details see *flock*(2), *nfs*(5) "
25111 "and *mount.cifs*(8). Depending on mount options, flock can always fail there."
25114 #. type: Plain text
25115 #: ../sys-utils/flock.1.adoc:103
25116 msgid "Note that \"shell> \" in examples is a command line prompt."
25119 #. type: Labeled list
25120 #: ../sys-utils/flock.1.adoc:104
25122 msgid "shell1> flock /tmp -c cat; shell2> flock -w .007 /tmp -c echo; /bin/echo $?"
25125 #. type: Plain text
25126 #: ../sys-utils/flock.1.adoc:106
25128 "Set exclusive lock to directory _/tmp_ and the second command will fail."
25131 #. type: Labeled list
25132 #: ../sys-utils/flock.1.adoc:107
25134 msgid "shell1> flock -s /tmp -c cat; shell2> flock -s -w .007 /tmp -c echo; /bin/echo $?"
25137 #. type: Plain text
25138 #: ../sys-utils/flock.1.adoc:109
25140 "Set shared lock to directory _/tmp_ and the second command will not fail. "
25141 "Notice that attempting to get exclusive lock with second command would fail."
25144 #. type: Labeled list
25145 #: ../sys-utils/flock.1.adoc:110
25147 msgid "shell> flock -x local-lock-file echo 'a b c'"
25150 #. type: Plain text
25151 #: ../sys-utils/flock.1.adoc:112
25153 "Grab the exclusive lock \"local-lock-file\" before running echo with 'a b c'."
25156 #. type: Labeled list
25157 #: ../sys-utils/flock.1.adoc:113
25159 msgid "(; flock -n 9 || exit 1; # ... commands executed under lock ...; ) 9>/var/lock/mylockfile"
25162 #. type: Plain text
25163 #: ../sys-utils/flock.1.adoc:115
25165 "The form is convenient inside shell scripts. The mode used to open the file "
25166 "doesn't matter to *flock*; using _>_ or _>>_ allows the lockfile to be "
25167 "created if it does not already exist, however, write permission is required. "
25168 "Using _<_ requires that the file already exists but only read permission is "
25172 #. type: Labeled list
25173 #: ../sys-utils/flock.1.adoc:116
25175 msgid "[ \"$\\{FLOCKER}\" != \"$0\" ] && exec env FLOCKER=\"$0\" flock -en \"$0\" \"$0\" \"$@\" || : "
25178 #. type: Plain text
25179 #: ../sys-utils/flock.1.adoc:118
25181 "This is useful boilerplate code for shell scripts. Put it at the top of the "
25182 "shell script you want to lock and it'll automatically lock itself on the "
25183 "first run. If the environment variable *$FLOCKER* is not set to the shell "
25184 "script that is being run, then execute *flock* and grab an exclusive non-"
25185 "blocking lock (using the script itself as the lock file) before re-execing "
25186 "itself with the right arguments. It also sets the *FLOCKER* environment "
25187 "variable to the right value so it doesn't run again."
25190 #. type: Labeled list
25191 #: ../sys-utils/flock.1.adoc:119
25193 msgid "shell> exec 4<>/var/lock/mylockfile; shell> flock -n 4"
25196 #. type: Plain text
25197 #: ../sys-utils/flock.1.adoc:121
25199 "This form is convenient for locking a file without spawning a subprocess. "
25200 "The shell opens the lock file for reading and writing as file descriptor 4, "
25201 "then *flock* is used to lock the descriptor."
25204 #. type: Plain text
25205 #: ../sys-utils/flock.1.adoc:125
25206 msgid "mailto:hpa@zytor.com[H. Peter Anvin]"
25209 #. TRANSLATORS: Keep {copyright} untranslated.
25210 #. type: Plain text
25211 #: ../sys-utils/flock.1.adoc:130
25213 "Copyright {copyright} 2003-2006 H. Peter Anvin. This is free software; see "
25214 "the source for copying conditions. There is NO warranty; not even for "
25215 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
25218 #. type: Plain text
25219 #: ../sys-utils/flock.1.adoc:134
25221 msgid "*flock*(2)\n"
25225 #: ../sys-utils/fsfreeze.8.adoc:2
25227 msgid "fsfreeze(8)"
25230 #. type: Plain text
25231 #: ../sys-utils/fsfreeze.8.adoc:12
25232 msgid "fsfreeze - suspend access to a filesystem (Ext3/4, ReiserFS, JFS, XFS)"
25235 #. type: Plain text
25236 #: ../sys-utils/fsfreeze.8.adoc:16
25238 msgid "*fsfreeze* *--freeze*|*--unfreeze* _mountpoint_\n"
25241 #. type: Plain text
25242 #: ../sys-utils/fsfreeze.8.adoc:20
25244 msgid "*fsfreeze* suspends or resumes access to a filesystem.\n"
25247 #. type: Plain text
25248 #: ../sys-utils/fsfreeze.8.adoc:22
25250 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"
25253 #. type: Plain text
25254 #: ../sys-utils/fsfreeze.8.adoc:24
25256 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"
25259 #. type: Plain text
25260 #: ../sys-utils/fsfreeze.8.adoc:26
25262 "The _mountpoint_ argument is the pathname of the directory where the "
25263 "filesystem is mounted. The filesystem must be mounted to be frozen (see "
25267 #. type: Plain text
25268 #: ../sys-utils/fsfreeze.8.adoc:28
25270 "Note that access-time updates are also suspended if the filesystem is "
25271 "mounted with the traditional atime behavior (mount option *strictatime*, for "
25272 "more details see *mount*(8))."
25275 #. type: Labeled list
25276 #: ../sys-utils/fsfreeze.8.adoc:31
25278 #| msgid "*-f*, *--fast*"
25279 msgid "*-f*, *--freeze*"
25280 msgstr "*-f*, *--fast*"
25282 #. type: Plain text
25283 #: ../sys-utils/fsfreeze.8.adoc:33
25285 "This option requests the specified filesystem to be frozen from new "
25286 "modifications. When this is selected, all ongoing transactions in the "
25287 "filesystem are allowed to complete, new *write*(2) system calls are halted, "
25288 "other calls which modify the filesystem are halted, and all dirty data, "
25289 "metadata, and log information are written to disk. Any process attempting to "
25290 "write to the frozen filesystem will block waiting for the filesystem to be "
25294 #. type: Plain text
25295 #: ../sys-utils/fsfreeze.8.adoc:35
25297 "Note that even after freezing, the on-disk filesystem can contain "
25298 "information on files that are still in the process of unlinking. These files "
25299 "will not be unlinked until the filesystem is unfrozen or a clean mount of "
25300 "the snapshot is complete."
25303 #. type: Labeled list
25304 #: ../sys-utils/fsfreeze.8.adoc:36
25306 #| msgid "*-h*, *--help*"
25307 msgid "*-u*, *--unfreeze*"
25308 msgstr "*-h*, *--help*"
25310 #. type: Plain text
25311 #: ../sys-utils/fsfreeze.8.adoc:38
25313 "This option is used to un-freeze the filesystem and allow operations to "
25314 "continue. Any filesystem modifications that were blocked by the freeze are "
25315 "unblocked and allowed to complete."
25319 #: ../sys-utils/fsfreeze.8.adoc:41
25321 msgid "FILESYSTEM SUPPORT"
25324 #. type: Plain text
25325 #: ../sys-utils/fsfreeze.8.adoc:44
25327 "This command will work only if filesystem supports has support for freezing. "
25328 "List of these filesystems include (2016-12-18) *btrfs*, *ext2/3/4*, *f2fs*, "
25329 "*jfs*, *nilfs2*, *reiserfs*, and *xfs*. Previous list may be incomplete, as "
25330 "more filesystems get support. If in doubt easiest way to know if a "
25331 "filesystem has support is create a small loopback mount and test freezing it."
25334 #. type: Plain text
25335 #: ../sys-utils/fsfreeze.8.adoc:48
25336 msgid "This man page is based on *xfs_freeze*(8)."
25339 #. type: Plain text
25340 #: ../sys-utils/fsfreeze.8.adoc:52
25341 msgid "Written by Hajime Taira."
25344 #. type: Plain text
25345 #: ../sys-utils/fsfreeze.8.adoc:56 ../sys-utils/mountpoint.1.adoc:68
25347 msgid "*mount*(8)\n"
25353 #. Copyright (c) 1980, 1989, 1991 The Regents of the University of California.
25354 #. All rights reserved.
25355 #. Redistribution and use in source and binary forms, with or without
25356 #. modification, are permitted provided that the following conditions
25358 #. 1. Redistributions of source code must retain the above copyright
25359 #. notice, this list of conditions and the following disclaimer.
25360 #. 2. Redistributions in binary form must reproduce the above copyright
25361 #. notice, this list of conditions and the following disclaimer in the
25362 #. documentation and/or other materials provided with the distribution.
25363 #. 3. All advertising materials mentioning features or use of this software
25364 #. must display the following acknowledgement:
25365 #. This product includes software developed by the University of
25366 #. California, Berkeley and its contributors.
25367 #. 4. Neither the name of the University nor the names of its contributors
25368 #. may be used to endorse or promote products derived from this software
25369 #. without specific prior written permission.
25370 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25371 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25372 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25373 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25374 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25375 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25376 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25377 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25378 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25379 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25381 #. @(#)fstab.5 6.5 (Berkeley) 5/10/91
25383 #: ../sys-utils/fstab.5.adoc:36
25388 #. type: Plain text
25389 #: ../sys-utils/fstab.5.adoc:46
25390 msgid "fstab - static information about the filesystems"
25391 msgstr "fstab - statická informace o souborových systémech"
25393 #. type: Plain text
25394 #: ../sys-utils/fstab.5.adoc:54
25396 "The file *fstab* contains descriptive information about the filesystems the "
25397 "system can mount. *fstab* is only read by programs, and not written; it is "
25398 "the duty of the system administrator to properly create and maintain this "
25399 "file. The order of records in *fstab* is important because *fsck*(8), "
25400 "*mount*(8), and *umount*(8) sequentially iterate through *fstab* doing their "
25403 "Soubor *fstab* obsahuje popisnou informaci o souborových systémech, které "
25404 "systém umí připojit. *fstab* je programy pouze čten, nikoli zapisován. Je "
25405 "starostí správce jej správně vytvořit a udržovat. Pořadí záznamů ve *fstab* "
25406 "je důležité, protože nástroje *fsck*(8), *mount*(8) a *umount*(8) postupně "
25407 "*fstab* procházejí a řídí tak svoji činnost."
25409 #. type: Plain text
25410 #: ../sys-utils/fstab.5.adoc:56
25412 "The file is not read by *mount*(8) only but often is used by many other "
25413 "tools and daemons, and proper functionality may require additional steps. "
25414 "For example, on systemd-based systems, it's recommended to use *systemctl "
25415 "daemon-reload* after *fstab* modification."
25418 #. type: Plain text
25419 #: ../sys-utils/fstab.5.adoc:58
25421 "Each filesystem is described on a separate line. Fields on each line are "
25422 "separated by tabs or spaces. Lines starting with '#' are comments. Blank "
25423 "lines are ignored."
25425 "Každý souborový systém je popsán na samostatném řádku. Jednotlivá pole "
25426 "každého řádku jsou oddělena tabulátory nebo mezerami. Řádky začínající "
25427 "znakem „#“ jsou komentáře. Prázdné řádky jsou ignorovány."
25429 #. type: Plain text
25430 #: ../sys-utils/fstab.5.adoc:60
25431 msgid "The following is a typical example of an *fstab* entry:"
25432 msgstr "Následuje typická ukázka záznamu *fstab*:"
25434 #. type: delimited block .
25435 #: ../sys-utils/fstab.5.adoc:63
25437 msgid "LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2\n"
25438 msgstr "LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2\n"
25441 #: ../sys-utils/fstab.5.adoc:65
25443 msgid "The first field (_fs_spec_)."
25444 msgstr "První položka (_fs_spec_)."
25446 #. type: Plain text
25447 #: ../sys-utils/fstab.5.adoc:68
25450 #| "This field describes the block special device, remote filesystem or "
25451 #| "filesystem image for loop device to be mounted or swap file or swap "
25452 #| "partition to be enabled."
25454 "This field describes the block special device, remote filesystem or "
25455 "filesystem image for loop device to be mounted or swap file or swap device "
25458 "Tato položka popisuje zvláštní blokové zařízení, vzdálený systém souborů "
25459 "nebo obraz se systémem souborů pro zařízení loop, který má být připojen, "
25460 "nebo odkládací soubor či oddíl, který má být zapnut."
25462 #. type: Plain text
25463 #: ../sys-utils/fstab.5.adoc:70
25465 "For ordinary mounts, it will hold (a link to) a block special device node "
25466 "(as created by *mknod*(2)) for the device to be mounted, like _/dev/cdrom_ "
25467 "or _/dev/sdb7_. For NFS mounts, this field is _<host>:<dir>_, e.g., _knuth."
25468 "aeb.nl:/_. For filesystems with no storage, any string can be used, and will "
25469 "show up in *df*(1) output, for example. Typical usage is _proc_ for "
25470 "*procfs*; _mem_, _none_, or _tmpfs_ for *tmpfs*. Other special filesystems, "
25471 "like *udev* and *sysfs*, are typically not listed in *fstab*."
25473 "Pro normální připojení toto je (odkaz na) i-uzel zvláštního blokového "
25474 "zařízení (lze vyrobit pomocí *mknod*(2)), jehož zařízení se má připojit. "
25475 "Například _/dev/cdrom_ nebo _/dev/sdb7_. Pro připojení NFS je tato položka "
25476 "_<stroj>:<adresář>_, například _knuth.aeb.nl:/_. V případě souborových "
25477 "systémů bez úložiště lze použít jakýkoliv řetězec. Tan pak bude například "
25478 "uveden ve výstupu *df*(1). Typické využití je _proc_ pro *procfs*; _mem_, "
25479 "_none_ nebo _tmpfs_ pro *tmpfs*. Další zvláštní souborové systémy, jako "
25480 "*udev* nebo *sysfs*, se do *fstab* obvykle neuvádějí."
25482 #. type: Plain text
25483 #: ../sys-utils/fstab.5.adoc:72
25485 "LABEL=<label> or UUID=<uuid> may be given instead of a device name. This is "
25486 "the recommended method, as device names are often a coincidence of hardware "
25487 "detection order, and can change when other disks are added or removed. For "
25488 "example, 'LABEL=Boot' or 'UUID=3e6be9de-8139-11d1-9106-a43f08d823a6'. (Use a "
25489 "filesystem-specific tool like *e2label*(8), *xfs_admin*(8), or *fatlabel*(8) "
25490 "to set LABELs on filesystems)."
25492 "Místo názvu zařízení lze zadat LABEL=<jmenovka> nebo UUID=<UUID>. Toto je "
25493 "doporučený postup, protože názvy zařízení jsou často výsledkem nahodilého "
25494 "pořadí detekce hardwaru a mohou se změnit, když se další disky přidají nebo "
25495 "odeberou. Příklady: „LABEL=Boot“ nebo „UUID=3e6be9de-8139-11d1-9106-"
25496 "a43f08d823a6“. (Jmenovku souborové systému můžete nastavit nástrojem určeným "
25497 "pro konkrétní souborový systém. Například *e2label*(8), *xfs_admin*(8) nebo "
25500 #. type: Plain text
25501 #: ../sys-utils/fstab.5.adoc:74
25503 "It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
25504 "identifiers are supported for example for GUID Partition Table (GPT)."
25506 "Rovněž je možné použít *PARTUUID=* nebo *PARTLABEL=*. Tyto identifikátory "
25507 "oddílů jsou podporovány například s tabulkou rozdělení disku GUID (GPT)."
25509 #. type: Plain text
25510 #: ../sys-utils/fstab.5.adoc:76
25512 "See *mount*(8), *blkid*(8) or *lsblk*(8) for more details about device "
25515 "Pro podrobnosti o identifikátorech zařízení nahlédněte do *mount*(8), "
25516 "*blkid*(8) a *lsblk*(8)."
25518 #. type: Plain text
25519 #: ../sys-utils/fstab.5.adoc:78
25521 "Note that *mount*(8) uses UUIDs as strings. The string representation of the "
25522 "UUID should be based on lower case characters. But when specifying the "
25523 "volume ID of FAT or NTFS file systems upper case characters are used (e.g "
25524 "UUID=\"A40D-85E7\" or UUID=\"61DB7756DB7779B3\")."
25526 "Pamatujte, že *mount*(8) používá UUID jako řetězce. Řetězcová reprezentace "
25527 "UUID by se měla zakládat na malých písmenech. Avšak pro zadání "
25528 "identifikátoru souborových systémů FAT a NFTS se používají písmena velká "
25529 "(např. UUID=\"A40D-85E7\" nebo UUID=\"61DB7756DB7779B3\")."
25532 #: ../sys-utils/fstab.5.adoc:79
25534 msgid "The second field (_fs_file_)."
25535 msgstr "Druhá položka (_fs_file_)."
25537 #. type: Plain text
25538 #: ../sys-utils/fstab.5.adoc:82
25541 #| "This field describes the mount point (target) for the filesystem. For "
25542 #| "swap partitions, this field should be specified as `none'. If the name of "
25543 #| "the mount point contains spaces or tabs these can be escaped as `\\040' "
25544 #| "and '\\011' respectively."
25546 "This field describes the mount point (target) for the filesystem. For swap "
25547 "area, this field should be specified as `none'. If the name of the mount "
25548 "point contains spaces or tabs these can be escaped as `\\040' and '\\011' "
25551 "Toto položka popisuje místo pro připojení (cíl) souborového systému. Pro "
25552 "odkládací oddíly by tato položka měla být vedena jako „none“. Pokud název "
25553 "místa připojení obsahuje mezery nebo tabulátory, lze je zapsat jako „\\040“ "
25557 #: ../sys-utils/fstab.5.adoc:83
25559 msgid "The third field (_fs_vfstype_)."
25560 msgstr "Třetí položka (_fs_vfstype_)."
25562 #. type: Plain text
25563 #: ../sys-utils/fstab.5.adoc:86
25565 "This field describes the type of the filesystem. Linux supports many "
25566 "filesystem types: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus, tmpfs, sysfs, "
25567 "proc, iso9660, udf, squashfs, nfs, cifs, and many more. For more details, "
25570 "Tato položka popisuje druh souborového systému. Linux podporuje mnoho druhů "
25571 "systémů: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus, tmpfs, sysfs, proc, "
25572 "iso9660, udf, squashfs, nfs, cifs a mnohé další. Pro podrobnosti vizte "
25575 #. type: Plain text
25576 #: ../sys-utils/fstab.5.adoc:88
25578 "An entry _swap_ denotes a file or partition to be used for swapping, cf. "
25579 "*swapon*(8). An entry _none_ is useful for bind or move mounts."
25581 "Záznam _swap_ označuje soubor nebo oddíl, který se má použít pro odkládaní "
25582 "(swap) paměti. Vizte *swapon*(8). Záznam _none_ se rovněž hodí pro vázaná "
25583 "(bind) připojení a přesunovaná (move) připojení."
25585 #. type: Plain text
25586 #: ../sys-utils/fstab.5.adoc:90
25587 msgid "More than one type may be specified in a comma-separated list."
25588 msgstr "Lze zadat více jak jeden druh. Oddělují se čárkami."
25590 #. type: Plain text
25591 #: ../sys-utils/fstab.5.adoc:92
25593 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"
25594 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"
25597 #: ../sys-utils/fstab.5.adoc:93
25599 msgid "The fourth field (_fs_mntops_)."
25600 msgstr "Čtvrtá položka (_fs_mntops_)."
25602 #. type: Plain text
25603 #: ../sys-utils/fstab.5.adoc:96
25604 msgid "This field describes the mount options associated with the filesystem."
25605 msgstr "Tato položka popisuje volby pro připojení souborového systému."
25607 #. type: Plain text
25608 #: ../sys-utils/fstab.5.adoc:98
25610 "It is formatted as a comma-separated list of options and is optional for "
25611 "*mount*(8) or *swapon*(8). The usual convention is to use at least "
25612 "\"defaults\" keyword there."
25615 #. type: Plain text
25616 #: ../sys-utils/fstab.5.adoc:100
25619 #| "It is formatted as a comma-separated list of options. It contains at "
25620 #| "least the type of mount (*ro* or *rw*), plus any additional options "
25621 #| "appropriate to the filesystem type (including performance-tuning "
25622 #| "options). For details, see *mount*(8) or *swapon*(8)."
25624 "It usually contains the type of mount (*ro* or *rw*, the default is *rw*), "
25625 "plus any additional options appropriate to the filesystem type (including "
25626 "performance-tuning options). For details, see *mount*(8) or *swapon*(8)."
25628 "Jedná se o seznamem voleb oddělených čárkami. Vždy obsahuje způsob připojení "
25629 "(*ro* nebo *rw*). Eventuálně další volby vhodné pro daný souborový systém "
25630 "(včetně voleb ovlivňujících výkon). Pro podrobnosti vizte *mount*(8) a "
25633 #. type: Plain text
25634 #: ../sys-utils/fstab.5.adoc:102
25635 msgid "Basic filesystem-independent options are:"
25636 msgstr "Základní volby nezávislé na souborovém systému jsou:"
25638 #. type: Labeled list
25639 #: ../sys-utils/fstab.5.adoc:103 ../sys-utils/mount.8.adoc:544
25642 msgstr "*defaults*"
25644 #. type: Plain text
25645 #: ../sys-utils/fstab.5.adoc:105
25647 "use default options. The default depends on the kernel and the filesystem. "
25648 "*mount*(8) does not have any hardcoded set of default options. The kernel "
25649 "default is usually rw, suid, dev, exec, auto, nouser, and async."
25652 #. type: Labeled list
25653 #: ../sys-utils/fstab.5.adoc:105 ../sys-utils/mount.8.adoc:517
25658 #. type: Plain text
25659 #: ../sys-utils/fstab.5.adoc:107
25660 msgid "do not mount when *mount -a* is given (e.g., at boot time)"
25661 msgstr "nepřipojovat, je-li voláno *mount -a* (například při startu systému)"
25663 #. type: Labeled list
25664 #: ../sys-utils/fstab.5.adoc:107 ../sys-utils/mount.8.adoc:675
25669 #. type: Plain text
25670 #: ../sys-utils/fstab.5.adoc:109
25671 msgid "allow a user to mount"
25672 msgstr "dovolí připojení běžným uživatelem"
25674 #. type: Labeled list
25675 #: ../sys-utils/fstab.5.adoc:109 ../sys-utils/mount.8.adoc:632
25680 #. type: Plain text
25681 #: ../sys-utils/fstab.5.adoc:111
25682 msgid "allow device owner to mount"
25683 msgstr "dovolí připojení vlastníkem zařízení"
25685 #. type: Labeled list
25686 #: ../sys-utils/fstab.5.adoc:111
25691 #. type: Plain text
25692 #: ../sys-utils/fstab.5.adoc:113
25693 msgid "or *x-<name>* for use by fstab-maintaining programs"
25694 msgstr "nebo *x-<název>* pro použití programy spravujícími fstab"
25696 #. type: Labeled list
25697 #: ../sys-utils/fstab.5.adoc:113 ../sys-utils/mount.8.adoc:588
25702 #. type: Plain text
25703 #: ../sys-utils/fstab.5.adoc:115
25704 msgid "do not report errors for this device if it does not exist."
25705 msgstr "nehlásí chyby k tomuto zařízení, pokud toto zařízení neexistuje."
25708 #: ../sys-utils/fstab.5.adoc:116
25710 msgid "The fifth field (_fs_freq_)."
25711 msgstr "Pátá položka (_fs_freq_)."
25713 #. type: Plain text
25714 #: ../sys-utils/fstab.5.adoc:119
25716 "This field is used by *dump*(8) to determine which filesystems need to be "
25717 "dumped. Defaults to zero (don't dump) if not present."
25719 "Tyto položku používá program *dump*(8), aby zjistil, který souborový systém "
25720 "má být zálohován. Pokud není uvedeno, výchozí hodnota je 0 (nezálohovat)."
25723 #: ../sys-utils/fstab.5.adoc:120
25725 msgid "The sixth field (_fs_passno_)."
25726 msgstr "Šestá položka (_fs_passno_)."
25728 #. type: Plain text
25729 #: ../sys-utils/fstab.5.adoc:123
25731 "This field is used by *fsck*(8) to determine the order in which filesystem "
25732 "checks are done at boot time. The root filesystem should be specified with a "
25733 "_fs_passno_ of 1. Other filesystems should have a _fs_passno_ of 2. "
25734 "Filesystems within a drive will be checked sequentially, but filesystems on "
25735 "different drives will be checked at the same time to utilize parallelism "
25736 "available in the hardware. Defaults to zero (don't check the filesystem) if "
25739 "Tuto položku používá program *fsck(8)* pro určení pořadí kontroly "
25740 "souborových systému při startu. Kořenový souborový systém by měl mít hodnotu "
25741 "_fs_passno_ rovnu 1, ostatní souborové systémy pak hodnotu _fs_passno rovnu "
25742 "2. Souborové systémy v rámci jedné diskové jednotky jsou kontrolovány "
25743 "postupně, nicméně systémy na různých jednotkách jsou kontrolovány najednou, "
25744 "aby se využil paralelismus stroje. Není-li hodnota uvedena, výchozí je nula "
25745 "(tzn. kontrola nebude provedena)."
25747 #. type: Plain text
25748 #: ../sys-utils/fstab.5.adoc:128
25749 msgid "_/etc/fstab_, _<fstab.h>_"
25750 msgstr "_/etc/fstab_, _<fstab.h>_"
25752 #. type: Plain text
25753 #: ../sys-utils/fstab.5.adoc:132
25755 "The proper way to read records from *fstab* is to use the routines "
25756 "*getmntent*(3) or *libmount*."
25758 "Správná metoda jak číst v programu *fstab* je použít proceduru "
25759 "*getmntent*(3) nebo *libmount*."
25761 #. type: Plain text
25762 #: ../sys-utils/fstab.5.adoc:134
25764 "The keyword *ignore* as a filesystem type (3rd field) is no longer supported "
25765 "by the pure libmount based mount utility (since util-linux v2.22)."
25767 "Klíčové slovo *ignore* použité jako druh souborového systému (3. položka) "
25768 "již není podporováno nástrojem mount, který je postaven čistě na knihovně "
25769 "libmount (util-linux od verze 2.22)."
25771 #. type: Plain text
25772 #: ../sys-utils/fstab.5.adoc:138
25773 msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
25774 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
25776 #. type: Plain text
25777 #: ../sys-utils/fstab.5.adoc:146
25780 "*getmntent*(3),\n"
25786 "*getmntent*(3),\n"
25793 #: ../sys-utils/fstrim.8.adoc:2
25798 #. type: Plain text
25799 #: ../sys-utils/fstrim.8.adoc:12
25800 msgid "fstrim - discard unused blocks on a mounted filesystem"
25803 #. type: Plain text
25804 #: ../sys-utils/fstrim.8.adoc:16
25806 msgid "*fstrim* [*-Aav*] [*-o* _offset_] [*-l* _length_] [*-m* _minimum-size_] [_mountpoint_]\n"
25809 #. type: Plain text
25810 #: ../sys-utils/fstrim.8.adoc:20
25812 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"
25815 #. type: Plain text
25816 #: ../sys-utils/fstrim.8.adoc:22
25818 "By default, *fstrim* will discard all unused blocks in the filesystem. "
25819 "Options may be used to modify this behavior based on range or size, as "
25823 #. type: Plain text
25824 #: ../sys-utils/fstrim.8.adoc:24
25826 "The _mountpoint_ argument is the pathname of the directory where the "
25827 "filesystem is mounted and is required when *_-A_*, *_-a_*, *_--fstab_*, or "
25828 "*_--all_* are unspecified."
25831 #. type: Plain text
25832 #: ../sys-utils/fstrim.8.adoc:26
25834 "Running *fstrim* frequently, or even using *mount -o discard*, might "
25835 "negatively affect the lifetime of poor-quality SSD devices. For most desktop "
25836 "and server systems a sufficient trimming frequency is once a week. Note that "
25837 "not all devices support a queued trim, so each trim command incurs a "
25838 "performance penalty on whatever else might be trying to use the disk at the "
25842 #. type: Plain text
25843 #: ../sys-utils/fstrim.8.adoc:30
25845 "The _offset_, _length_, and _minimum-size_ arguments may be followed by the "
25846 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
25847 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
25848 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
25849 "for GB, TB, PB, EB, ZB and YB."
25852 #. type: Labeled list
25853 #: ../sys-utils/fstrim.8.adoc:31
25855 msgid "*-A, --fstab*"
25858 #. type: Plain text
25859 #: ../sys-utils/fstrim.8.adoc:33
25861 "Trim all mounted filesystems mentioned in _/etc/fstab_ on devices that "
25862 "support the discard operation. The root filesystem is determined from kernel "
25863 "command line if missing in the file. The other supplied options, like *--"
25864 "offset*, *--length* and *--minimum*, are applied to all these devices. "
25865 "Errors from filesystems that do not support the discard operation, read-only "
25866 "devices, autofs and read-only filesystems are silently ignored. Filesystems "
25867 "with \"X-fstrim.notrim\" mount option are skipped."
25870 #. type: Labeled list
25871 #: ../sys-utils/fstrim.8.adoc:34
25873 msgid "*-a, --all*"
25876 #. type: Plain text
25877 #: ../sys-utils/fstrim.8.adoc:36
25879 "Trim all mounted filesystems on devices that support the discard operation. "
25880 "The other supplied options, like *--offset*, *--length* and *--minimum*, are "
25881 "applied to all these devices. Errors from filesystems that do not support "
25882 "the discard operation, read-only devices and read-only filesystems are "
25883 "silently ignored."
25886 #. type: Labeled list
25887 #: ../sys-utils/fstrim.8.adoc:37
25889 msgid "*-n, --dry-run*"
25892 #. type: Plain text
25893 #: ../sys-utils/fstrim.8.adoc:39
25894 msgid "This option does everything apart from actually call *FITRIM* ioctl."
25897 #. type: Labeled list
25898 #: ../sys-utils/fstrim.8.adoc:40
25900 msgid "*-o, --offset* _offset_"
25903 #. type: Plain text
25904 #: ../sys-utils/fstrim.8.adoc:42
25906 "Byte offset in the filesystem from which to begin searching for free blocks "
25907 "to discard. The default value is zero, starting at the beginning of the "
25911 #. type: Labeled list
25912 #: ../sys-utils/fstrim.8.adoc:43
25914 msgid "*-l, --length* _length_"
25917 #. type: Plain text
25918 #: ../sys-utils/fstrim.8.adoc:45
25920 "The number of bytes (after the starting point) to search for free blocks to "
25921 "discard. If the specified value extends past the end of the filesystem, "
25922 "*fstrim* will stop at the filesystem size boundary. The default value "
25923 "extends to the end of the filesystem."
25926 #. type: Labeled list
25927 #: ../sys-utils/fstrim.8.adoc:46
25929 #| msgid "*-w*, **--whitelist-environment**=__list__"
25930 msgid "*-I, --listed-in* _list_"
25931 msgstr "*-w*, **--whitelist-environment**=__seznam__"
25933 #. type: Plain text
25934 #: ../sys-utils/fstrim.8.adoc:48
25936 "Specifies a colon-separated list of files in fstab or kernel mountinfo "
25937 "format. All missing or empty files are silently ignored. The evaluation of "
25938 "the _list_ stops after first non-empty file. For example:"
25941 #. type: Plain text
25942 #: ../sys-utils/fstrim.8.adoc:50
25944 msgid "*--listed-in /etc/fstab:/proc/self/mountinfo*.\n"
25947 #. type: Plain text
25948 #: ../sys-utils/fstrim.8.adoc:52
25949 msgid "Filesystems with \"X-fstrim.notrim\" mount option in fstab are skipped."
25952 #. type: Labeled list
25953 #: ../sys-utils/fstrim.8.adoc:53
25955 msgid "*-m, --minimum* _minimum-size_"
25958 #. type: Plain text
25959 #: ../sys-utils/fstrim.8.adoc:55
25961 "Minimum contiguous free range to discard, in bytes. (This value is "
25962 "internally rounded up to a multiple of the filesystem block size.) Free "
25963 "ranges smaller than this will be ignored and *fstrim* will adjust the "
25964 "minimum if it's smaller than the device's minimum, and report that "
25965 "(fstrim_range.minlen) back to userspace. By increasing this value, the "
25966 "*fstrim* operation will complete more quickly for filesystems with badly "
25967 "fragmented freespace, although not all blocks will be discarded. The default "
25968 "value is zero, discarding every free block."
25971 #. type: Plain text
25972 #: ../sys-utils/fstrim.8.adoc:63
25974 "Specifies allowed or forbidden filesystem types when used with *--all* or *--"
25975 "fstab*. The _list_ is a comma-separated list of the filesystem names. The "
25976 "_list_ follows how *mount -t* evaluates type patterns. Only specified "
25977 "filesystem types are allowed. All specified types are forbidden if the list "
25978 "is prefixed by \"no\" or each filesystem prefixed by \"no\" is forbidden. If "
25979 "the option is not used, then all filesystems (except \"autofs\") are allowed."
25982 #. type: Labeled list
25983 #: ../sys-utils/fstrim.8.adoc:64
25985 #| msgid "*-V*, *--version*"
25986 msgid "*-v, --verbose*"
25987 msgstr "*-V*, *--version*"
25989 #. type: Plain text
25990 #: ../sys-utils/fstrim.8.adoc:66
25992 "Verbose execution. With this option *fstrim* will output the number of bytes "
25993 "passed from the filesystem down the block stack to the device for potential "
25994 "discard. This number is a maximum discard amount from the storage device's "
25995 "perspective, because _FITRIM_ ioctl called repeated will keep sending the "
25996 "same sectors for discard repeatedly."
25999 #. type: Plain text
26000 #: ../sys-utils/fstrim.8.adoc:68
26002 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"
26005 #. type: Labeled list
26006 #: ../sys-utils/fstrim.8.adoc:69
26008 msgid "*--quiet-unsupported*"
26011 #. type: Plain text
26012 #: ../sys-utils/fstrim.8.adoc:71
26014 "Suppress error messages if trim operation (ioctl) is unsupported. This "
26015 "option is meant to be used in *systemd* service file or in *cron*(8) scripts "
26016 "to hide warnings that are result of known problems, such as NTFS driver "
26017 "reporting _Bad file descriptor_ when device is mounted read-only, or lack of "
26018 "file system support for ioctl _FITRIM_ call. This option also cleans exit "
26019 "status when unsupported filesystem specified on *fstrim* command line."
26022 #. type: Plain text
26023 #: ../sys-utils/fstrim.8.adoc:84
26024 msgid "some filesystem discards have succeeded, some failed"
26027 #. type: Plain text
26028 #: ../sys-utils/fstrim.8.adoc:86
26030 "The command *fstrim --all* returns 0 (all succeeded), 32 (all failed) or 64 "
26031 "(some failed, some succeeded)."
26034 #. type: Plain text
26035 #: ../sys-utils/fstrim.8.adoc:95
26038 "*blkdiscard*(8),\n"
26043 #. hwclock.8 -- man page for util-linux' hwclock
26044 #. 2015-01-07 J William Piggott
26045 #. Authored new section: DATE-TIME CONFIGURATION.
26046 #. Subsections: Keeping Time..., LOCAL vs UTC, POSIX vs 'RIGHT'.
26048 #: ../sys-utils/hwclock.8.adoc:9
26053 #. type: Plain text
26054 #: ../sys-utils/hwclock.8.adoc:20
26055 msgid "hwclock - time clocks utility"
26058 #. type: Plain text
26059 #: ../sys-utils/hwclock.8.adoc:24
26061 msgid "*hwclock* [_function_] [_option_...]\n"
26064 #. type: Plain text
26065 #: ../sys-utils/hwclock.8.adoc:28
26067 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"
26070 #. type: Plain text
26071 #: ../sys-utils/hwclock.8.adoc:30
26073 "Since v2.26 important changes were made to the *--hctosys* function and the "
26074 "*--directisa* option, and a new option *--update-drift* was added. See their "
26075 "respective descriptions below."
26079 #: ../sys-utils/hwclock.8.adoc:31
26085 #. type: Plain text
26086 #: ../sys-utils/hwclock.8.adoc:34
26088 "The following functions are mutually exclusive, only one can be given at a "
26089 "time. If none is given, the default is *--show*."
26092 #. type: Labeled list
26093 #: ../sys-utils/hwclock.8.adoc:35
26095 msgid "*-a, --adjust*"
26098 #. type: Plain text
26099 #: ../sys-utils/hwclock.8.adoc:37
26101 "Add or subtract time from the Hardware Clock to account for systematic drift "
26102 "since the last time the clock was set or adjusted. See the discussion below, "
26103 "under *The Adjust Function*."
26106 #. type: Labeled list
26107 #: ../sys-utils/hwclock.8.adoc:38
26109 msgid "*--getepoch*; *--setepoch*"
26112 #. type: Plain text
26113 #: ../sys-utils/hwclock.8.adoc:40
26115 "These functions are for Alpha machines only, and are only available through "
26116 "the Linux kernel RTC driver."
26119 #. type: Plain text
26120 #: ../sys-utils/hwclock.8.adoc:42
26122 "They are used to read and set the kernel's Hardware Clock epoch value. Epoch "
26123 "is the number of years into AD to which a zero year value in the Hardware "
26124 "Clock refers. For example, if the machine's BIOS sets the year counter in "
26125 "the Hardware Clock to contain the number of full years since 1952, then the "
26126 "kernel's Hardware Clock epoch value must be 1952."
26129 #. type: Plain text
26130 #: ../sys-utils/hwclock.8.adoc:44
26132 "The *--setepoch* function requires using the *--epoch* option to specify the "
26133 "year. For example:"
26136 #. type: Plain text
26137 #: ../sys-utils/hwclock.8.adoc:46
26139 msgid "**hwclock --setepoch --epoch=1952**\n"
26142 #. type: Plain text
26143 #: ../sys-utils/hwclock.8.adoc:48
26145 "The RTC driver attempts to guess the correct epoch value, so setting it may "
26149 #. type: Plain text
26150 #: ../sys-utils/hwclock.8.adoc:50
26152 "This epoch value is used whenever *hwclock* reads or sets the Hardware Clock "
26153 "on an Alpha machine. For ISA machines the kernel uses the fixed Hardware "
26154 "Clock epoch of 1900."
26157 #. type: Labeled list
26158 #: ../sys-utils/hwclock.8.adoc:51
26160 msgid "**--param-get=**__parameter__; **--param-set=**__parameter__=__value__"
26163 #. type: Plain text
26164 #: ../sys-utils/hwclock.8.adoc:53
26166 "Read and set the RTC's parameter. This is useful, for example, to retrieve "
26167 "the RTC's feature or set the RTC's Backup Switchover Mode."
26170 #. type: Plain text
26171 #: ../sys-utils/hwclock.8.adoc:55
26173 "_parameter_ is either a numeric RTC parameter value (see the Kernel's "
26174 "_include/uapi/linux/rtc.h_) or an alias. See *--help* for a list of valid "
26175 "aliases. _parameter_ and _value_, if prefixed with 0x, are interpreted as "
26176 "hexadecimal, otherwise decimal values."
26179 #. type: Labeled list
26180 #: ../sys-utils/hwclock.8.adoc:56
26182 msgid "*--predict*"
26185 #. type: Plain text
26186 #: ../sys-utils/hwclock.8.adoc:58
26188 "Predict what the Hardware Clock will read in the future based upon the time "
26189 "given by the *--date* option and the information in _{ADJTIME_PATH}_. This "
26190 "is useful, for example, to account for drift when setting a Hardware Clock "
26191 "wakeup (aka alarm). See *rtcwake*(8)."
26194 #. type: Plain text
26195 #: ../sys-utils/hwclock.8.adoc:60
26197 "Do not use this function if the Hardware Clock is being modified by anything "
26198 "other than the current operating system's *hwclock* command, such as '11 "
26199 "minute mode' or from dual-booting another OS."
26202 #. type: Labeled list
26203 #: ../sys-utils/hwclock.8.adoc:61
26205 #| msgid "*-*, *-l*, *--login*"
26206 msgid "*-r*, *--show*; *--get*"
26207 msgstr "*-*, *-l*, *--login*"
26209 #. type: Plain text
26210 #: ../sys-utils/hwclock.8.adoc:63
26212 "Read the Hardware Clock and print its time to standard output in the *ISO "
26213 "8601* format. The time shown is always in local time, even if you keep your "
26214 "Hardware Clock in UTC. See the *--localtime* option."
26217 #. type: Plain text
26218 #: ../sys-utils/hwclock.8.adoc:65
26220 "Showing the Hardware Clock time is the default when no function is specified."
26223 #. type: Plain text
26224 #: ../sys-utils/hwclock.8.adoc:67
26226 "The *--get* function also applies drift correction to the time read, based "
26227 "upon the information in _{ADJTIME_PATH}_. Do not use this function if the "
26228 "Hardware Clock is being modified by anything other than the current "
26229 "operating system's *hwclock* command, such as '11 minute mode' or from dual-"
26230 "booting another OS."
26233 #. type: Labeled list
26234 #: ../sys-utils/hwclock.8.adoc:68
26236 #| msgid "*-P*, *--pty*"
26237 msgid "*-s*, *--hctosys*"
26238 msgstr "*-P*, *--pty*"
26240 #. type: Plain text
26241 #: ../sys-utils/hwclock.8.adoc:70
26243 "Set the System Clock from the Hardware Clock. The time read from the "
26244 "Hardware Clock is compensated to account for systematic drift before using "
26245 "it to set the System Clock. See the discussion below, under *The Adjust "
26249 #. type: Plain text
26250 #: ../sys-utils/hwclock.8.adoc:72
26252 "The System Clock must be kept in the UTC timescale for date-time "
26253 "applications to work correctly in conjunction with the timezone configured "
26254 "for the system. If the Hardware Clock is kept in local time then the time "
26255 "read from it must be shifted to the UTC timescale before using it to set the "
26256 "System Clock. The *--hctosys* function does this based upon the information "
26257 "in the _{ADJTIME_PATH}_ file or the command line arguments *--localtime* and "
26258 "*--utc*. Note: no daylight saving adjustment is made. See the discussion "
26259 "below, under *LOCAL vs UTC*."
26262 #. type: Plain text
26263 #: ../sys-utils/hwclock.8.adoc:74
26265 "The kernel also keeps a timezone value, the *--hctosys* function sets it to "
26266 "the timezone configured for the system. The system timezone is configured by "
26267 "the *TZ* environment variable or the _/etc/localtime_ file, as *tzset*(3) "
26268 "would interpret them. The obsolete _tz_dsttime_ field of the kernel's "
26269 "timezone value is set to zero. (For details on what this field used to mean, "
26270 "see *settimeofday*(2).)"
26273 #. type: Plain text
26274 #: ../sys-utils/hwclock.8.adoc:76
26276 "When used in a startup script, making the *--hctosys* function the first "
26277 "caller of *settimeofday*(2) from boot, it will set the NTP '11 minute mode' "
26278 "timescale via the _persistent_clock_is_local_ kernel variable. If the "
26279 "Hardware Clock's timescale configuration is changed then a reboot is "
26280 "required to inform the kernel. See the discussion below, under *Automatic "
26281 "Hardware Clock Synchronization by the Kernel*."
26284 #. type: Plain text
26285 #: ../sys-utils/hwclock.8.adoc:78
26287 "This is a good function to use in one of the system startup scripts before "
26288 "the file systems are mounted read/write."
26291 #. type: Plain text
26292 #: ../sys-utils/hwclock.8.adoc:80
26294 "This function should never be used on a running system. Jumping system time "
26295 "will cause problems, such as corrupted filesystem timestamps. Also, if "
26296 "something has changed the Hardware Clock, like NTP's '11 minute mode', then "
26297 "*--hctosys* will set the time incorrectly by including drift compensation."
26300 #. type: Plain text
26301 #: ../sys-utils/hwclock.8.adoc:82
26303 "Drift compensation can be inhibited by setting the drift factor in "
26304 "_{ADJTIME_PATH}_ to zero. This setting will be persistent as long as the *--"
26305 "update-drift* option is not used with *--systohc* at shutdown (or anywhere "
26306 "else). Another way to inhibit this is by using the *--noadjfile* option when "
26307 "calling the *--hctosys* function. A third method is to delete the "
26308 "_{ADJTIME_PATH}_ file. *Hwclock* will then default to using the UTC "
26309 "timescale for the Hardware Clock. If the Hardware Clock is ticking local "
26310 "time it will need to be defined in the file. This can be done by calling "
26311 "*hwclock --localtime --adjust*; when the file is not present this command "
26312 "will not actually adjust the Clock, but it will create the file with local "
26313 "time configured, and a drift factor of zero."
26316 #. type: Plain text
26317 #: ../sys-utils/hwclock.8.adoc:84
26319 "A condition under which inhibiting *hwclock*'s drift correction may be "
26320 "desired is when dual-booting multiple operating systems. If while this "
26321 "instance of Linux is stopped, another OS changes the Hardware Clock's value, "
26322 "then when this instance is started again the drift correction applied will "
26326 #. type: Plain text
26327 #: ../sys-utils/hwclock.8.adoc:86
26329 "For *hwclock*'s drift correction to work properly it is imperative that "
26330 "nothing changes the Hardware Clock while its Linux instance is not running."
26333 #. type: Labeled list
26334 #: ../sys-utils/hwclock.8.adoc:87
26339 #. type: Plain text
26340 #: ../sys-utils/hwclock.8.adoc:89
26342 "Set the Hardware Clock to the time given by the *--date* option, and update "
26343 "the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also "
26344 "(re)calculate the drift factor. Try it without the option if *--set* fails. "
26345 "See *--update-drift* below."
26348 #. type: Labeled list
26349 #: ../sys-utils/hwclock.8.adoc:90
26354 #. type: Plain text
26355 #: ../sys-utils/hwclock.8.adoc:92
26357 "This is an alternate to the *--hctosys* function that does not read the "
26358 "Hardware Clock nor set the System Clock; consequently there is not any drift "
26359 "correction. It is intended to be used in a startup script on systems with "
26360 "kernels above version 2.6 where you know the System Clock has been set from "
26361 "the Hardware Clock by the kernel during boot."
26364 #. type: Plain text
26365 #: ../sys-utils/hwclock.8.adoc:94
26367 "It does the following things that are detailed above in the *--hctosys* "
26371 #. type: Plain text
26372 #: ../sys-utils/hwclock.8.adoc:96
26374 "Corrects the System Clock timescale to UTC as needed. Only instead of "
26375 "accomplishing this by setting the System Clock, *hwclock* simply informs the "
26376 "kernel and it handles the change."
26379 #. type: Plain text
26380 #: ../sys-utils/hwclock.8.adoc:97
26381 msgid "Sets the kernel's NTP '11 minute mode' timescale."
26384 #. type: Plain text
26385 #: ../sys-utils/hwclock.8.adoc:98
26386 msgid "Sets the kernel's timezone."
26389 #. type: Plain text
26390 #: ../sys-utils/hwclock.8.adoc:100
26392 "The first two are only available on the first call of *settimeofday*(2) "
26393 "after boot. Consequently this option only makes sense when used in a startup "
26394 "script. If the Hardware Clocks timescale configuration is changed then a "
26395 "reboot would be required to inform the kernel."
26398 #. type: Labeled list
26399 #: ../sys-utils/hwclock.8.adoc:101
26401 #| msgid "*-f*, *--fast*"
26402 msgid "*-w*, *--systohc*"
26403 msgstr "*-f*, *--fast*"
26405 #. type: Plain text
26406 #: ../sys-utils/hwclock.8.adoc:103
26408 "Set the Hardware Clock from the System Clock, and update the timestamps in "
26409 "_{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the "
26410 "drift factor. Try it without the option if *--systohc* fails. See *--update-"
26414 #. type: Labeled list
26415 #: ../sys-utils/hwclock.8.adoc:104
26417 #| msgid "*-h*, *--help*"
26418 msgid "*--vl-read*, *--vl-clear*"
26419 msgstr "*-h*, *--help*"
26421 #. type: Plain text
26422 #: ../sys-utils/hwclock.8.adoc:106
26424 "Some RTC devices are able to monitor the voltage of the backup battery and "
26425 "thus provide a way for the user to know that the battery should be replaced. "
26426 "The *--vl-read* function retrieves the Voltage Low information and decodes "
26427 "the result into human-readable form. The *--vl-clear* function resets the "
26428 "Voltage Low information, which is necessary for some RTC devices after a "
26429 "battery replacement."
26432 #. type: Plain text
26433 #: ../sys-utils/hwclock.8.adoc:108
26435 "See the Kernel's _include/uapi/linux/rtc.h_ for details on which pieces of "
26436 "information may be returned. Note that not all RTC devices have this "
26437 "monitoring capability, nor do all drivers necessarily support reading the "
26441 #. type: Labeled list
26442 #: ../sys-utils/hwclock.8.adoc:113
26444 msgid "**--adjfile=**__filename__"
26447 #. type: Plain text
26448 #: ../sys-utils/hwclock.8.adoc:115
26449 msgid "Override the default _{ADJTIME_PATH}_ file path."
26452 #. type: Labeled list
26453 #: ../sys-utils/hwclock.8.adoc:116
26455 msgid "**--date=**__date_string__"
26458 #. type: Plain text
26459 #: ../sys-utils/hwclock.8.adoc:118
26461 "This option must be used with the *--set* or *--predict* functions, "
26462 "otherwise it is ignored."
26465 #. type: Plain text
26466 #: ../sys-utils/hwclock.8.adoc:120
26468 msgid "*hwclock --set --date='16:45'*\n"
26471 #. type: Plain text
26472 #: ../sys-utils/hwclock.8.adoc:122
26474 msgid "*hwclock --predict --date='2525-08-14 07:11:05'*\n"
26477 #. type: Plain text
26478 #: ../sys-utils/hwclock.8.adoc:124
26480 "The argument must be in local time, even if you keep your Hardware Clock in "
26481 "UTC. See the *--localtime* option. Therefore, the argument should not "
26482 "include any timezone information. It also should not be a relative time like "
26483 "\"+5 minutes\", because *hwclock*'s precision depends upon correlation "
26484 "between the argument's value and when the enter key is pressed. Fractional "
26485 "seconds are silently dropped. This option is capable of understanding many "
26486 "time and date formats, but the previous parameters should be observed."
26489 #. type: Labeled list
26490 #: ../sys-utils/hwclock.8.adoc:125
26492 #| msgid "**--session-command=**__command__"
26493 msgid "**--delay=**__seconds__"
26494 msgstr "**--session-command=**__příkaz__"
26496 #. type: Plain text
26497 #: ../sys-utils/hwclock.8.adoc:127
26499 "This option can be used to overwrite the internally used delay when setting "
26500 "the clock time. The default is 0.5 (500ms) for rtc_cmos, for another RTC "
26501 "types the delay is 0. If RTC type is impossible to determine (from sysfs) "
26502 "then it defaults also to 0.5 to be backwardly compatible."
26505 #. type: Plain text
26506 #: ../sys-utils/hwclock.8.adoc:129
26508 "The 500ms default is based on commonly used MC146818A-compatible (x86) "
26509 "hardware clock. This Hardware Clock can only be set to any integer time plus "
26510 "one half second. The integer time is required because there is no interface "
26511 "to set or get a fractional second. The additional half second delay is "
26512 "because the Hardware Clock updates to the following second precisely 500 ms "
26513 "after setting the new time. Unfortunately, this behavior is hardware "
26514 "specific and in some cases another delay is required."
26517 #. type: Labeled list
26518 #: ../sys-utils/hwclock.8.adoc:130
26520 #| msgid "*-h*, *--help*"
26521 msgid "*-D*, *--debug*"
26522 msgstr "*-h*, *--help*"
26524 #. type: Plain text
26525 #: ../sys-utils/hwclock.8.adoc:132
26527 "Use *--verbose*. The *--debug* option has been deprecated and may be "
26528 "repurposed or removed in a future release."
26531 #. type: Labeled list
26532 #: ../sys-utils/hwclock.8.adoc:133
26534 msgid "*--directisa*"
26537 #. type: Plain text
26538 #: ../sys-utils/hwclock.8.adoc:135
26540 "This option is meaningful for ISA compatible machines in the x86 and x86_64 "
26541 "family. For other machines, it has no effect. This option tells *hwclock* to "
26542 "use explicit I/O instructions to access the Hardware Clock. Without this "
26543 "option, *hwclock* will use the rtc device file, which it assumes to be "
26544 "driven by the Linux RTC device driver. As of v2.26 it will no longer "
26545 "automatically use directisa when the rtc driver is unavailable; this was "
26546 "causing an unsafe condition that could allow two processes to access the "
26547 "Hardware Clock at the same time. Direct hardware access from userspace "
26548 "should only be used for testing, troubleshooting, and as a last resort when "
26549 "all other methods fail. See the *--rtc* option."
26552 #. type: Labeled list
26553 #: ../sys-utils/hwclock.8.adoc:136
26555 msgid "**--epoch=**__year__"
26558 #. type: Plain text
26559 #: ../sys-utils/hwclock.8.adoc:138
26561 "This option is required when using the *--setepoch* function. The minimum "
26562 "_year_ value is 1900. The maximum is system dependent (*ULONG_MAX - 1*)."
26565 #. type: Labeled list
26566 #: ../sys-utils/hwclock.8.adoc:139
26568 msgid "*-f*, **--rtc=**__filename__"
26571 #. type: Plain text
26572 #: ../sys-utils/hwclock.8.adoc:141
26574 "Override *hwclock*'s default rtc device file name. Otherwise it will use the "
26575 "first one found in this order: _/dev/rtc0_, _/dev/rtc_, _/dev/misc/rtc_. For "
26576 "*IA-64:* _/dev/efirtc_ _/dev/misc/efirtc_"
26579 #. type: Labeled list
26580 #: ../sys-utils/hwclock.8.adoc:142
26582 msgid "*-l*, *--localtime*; *-u*, *--utc*"
26585 #. type: Plain text
26586 #: ../sys-utils/hwclock.8.adoc:144
26587 msgid "Indicate which timescale the Hardware Clock is set to."
26590 #. type: Plain text
26591 #: ../sys-utils/hwclock.8.adoc:146
26593 "The Hardware Clock may be configured to use either the UTC or the local "
26594 "timescale, but nothing in the clock itself says which alternative is being "
26595 "used. The *--localtime* or *--utc* options give this information to the "
26596 "*hwclock* command. If you specify the wrong one (or specify neither and take "
26597 "a wrong default), both setting and reading the Hardware Clock will be "
26601 #. type: Plain text
26602 #: ../sys-utils/hwclock.8.adoc:148
26604 "If you specify neither *--utc* nor *--localtime* then the one last given "
26605 "with a set function (*--set*, *--systohc*, or *--adjust*), as recorded in "
26606 "_{ADJTIME_PATH}_, will be used. If the adjtime file doesn't exist, the "
26610 #. type: Plain text
26611 #: ../sys-utils/hwclock.8.adoc:150
26613 "Note: daylight saving time changes may be inconsistent when the Hardware "
26614 "Clock is kept in local time. See the discussion below, under *LOCAL vs UTC*."
26617 #. type: Labeled list
26618 #: ../sys-utils/hwclock.8.adoc:151
26620 msgid "*--noadjfile*"
26623 #. type: Plain text
26624 #: ../sys-utils/hwclock.8.adoc:153
26626 "Disable the facilities provided by _{ADJTIME_PATH}_. *hwclock* will not read "
26627 "nor write to that file with this option. Either *--utc* or *--localtime* "
26628 "must be specified when using this option."
26631 #. type: Labeled list
26632 #: ../sys-utils/hwclock.8.adoc:154
26637 #. type: Plain text
26638 #: ../sys-utils/hwclock.8.adoc:156
26640 "Do not actually change anything on the system, that is, the Clocks or "
26641 "_{ADJTIME_PATH}_ (*--verbose* is implicit with this option)."
26644 #. type: Labeled list
26645 #: ../sys-utils/hwclock.8.adoc:157
26647 msgid "*--update-drift*"
26650 #. type: Plain text
26651 #: ../sys-utils/hwclock.8.adoc:159
26653 "Update the Hardware Clock's drift factor in _{ADJTIME_PATH}_. It can only be "
26654 "used with *--set* or *--systohc*."
26657 #. type: Plain text
26658 #: ../sys-utils/hwclock.8.adoc:161
26660 "A minimum four hour period between settings is required. This is to avoid "
26661 "invalid calculations. The longer the period, the more precise the resulting "
26662 "drift factor will be."
26665 #. type: Plain text
26666 #: ../sys-utils/hwclock.8.adoc:163
26668 "This option was added in v2.26, because it is typical for systems to call "
26669 "*hwclock --systohc* at shutdown; with the old behavior this would "
26670 "automatically (re)calculate the drift factor which caused several problems:"
26673 #. type: Plain text
26674 #: ../sys-utils/hwclock.8.adoc:165
26676 "When using NTP with an '11 minute mode' kernel the drift factor would be "
26677 "clobbered to near zero."
26680 #. type: Plain text
26681 #: ../sys-utils/hwclock.8.adoc:166
26683 "It would not allow the use of 'cold' drift correction. With most "
26684 "configurations using 'cold' drift will yield favorable results. Cold, means "
26685 "when the machine is turned off which can have a significant impact on the "
26689 #. type: Plain text
26690 #: ../sys-utils/hwclock.8.adoc:167
26692 "(Re)calculating drift factor on every shutdown delivers suboptimal results. "
26693 "For example, if ephemeral conditions cause the machine to be abnormally hot "
26694 "the drift factor calculation would be out of range."
26697 #. type: Plain text
26698 #: ../sys-utils/hwclock.8.adoc:168
26700 "Significantly increased system shutdown times (as of v2.31 when not using *--"
26701 "update-drift* the RTC is not read)."
26704 #. type: Plain text
26705 #: ../sys-utils/hwclock.8.adoc:170
26707 "Having *hwclock* calculate the drift factor is a good starting point, but "
26708 "for optimal results it will likely need to be adjusted by directly editing "
26709 "the _{ADJTIME_PATH}_ file. For most configurations once a machine's optimal "
26710 "drift factor is crafted it should not need to be changed. Therefore, the old "
26711 "behavior to automatically (re)calculate drift was changed and now requires "
26712 "this option to be used. See the discussion below, under *The Adjust "
26716 #. type: Plain text
26717 #: ../sys-utils/hwclock.8.adoc:172
26719 "This option requires reading the Hardware Clock before setting it. If it "
26720 "cannot be read, then this option will cause the set functions to fail. This "
26721 "can happen, for example, if the Hardware Clock is corrupted by a power "
26722 "failure. In that case, the clock must first be set without this option. "
26723 "Despite it not working, the resulting drift correction factor would be "
26727 #. type: Plain text
26728 #: ../sys-utils/hwclock.8.adoc:175
26729 msgid "Display more details about what *hwclock* is doing internally."
26733 #: ../sys-utils/hwclock.8.adoc:178
26735 msgid "Clocks in a Linux System"
26738 #. type: Plain text
26739 #: ../sys-utils/hwclock.8.adoc:181
26740 msgid "There are two types of date-time clocks:"
26743 #. type: Plain text
26744 #: ../sys-utils/hwclock.8.adoc:183
26746 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"
26749 #. type: Plain text
26750 #: ../sys-utils/hwclock.8.adoc:185
26752 "On an ISA compatible system, this clock is specified as part of the ISA "
26753 "standard. A control program can read or set this clock only to a whole "
26754 "second, but it can also detect the edges of the 1 second clock ticks, so the "
26755 "clock actually has virtually infinite precision."
26758 #. type: Plain text
26759 #: ../sys-utils/hwclock.8.adoc:187
26761 "This clock is commonly called the hardware clock, the real time clock, the "
26762 "RTC, the BIOS clock, and the CMOS clock. Hardware Clock, in its capitalized "
26763 "form, was coined for use by *hwclock*. The Linux kernel also refers to it as "
26764 "the persistent clock."
26767 #. type: Plain text
26768 #: ../sys-utils/hwclock.8.adoc:189
26770 "Some non-ISA systems have a few real time clocks with only one of them "
26771 "having its own power domain. A very low power external I2C or SPI clock chip "
26772 "might be used with a backup battery as the hardware clock to initialize a "
26773 "more functional integrated real-time clock which is used for most other "
26777 #. type: Plain text
26778 #: ../sys-utils/hwclock.8.adoc:191
26780 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"
26783 #. type: Plain text
26784 #: ../sys-utils/hwclock.8.adoc:193
26786 "The System Time is the time that matters. The Hardware Clock's basic purpose "
26787 "is to keep time when Linux is not running so that the System Clock can be "
26788 "initialized from it at boot. Note that in DOS, for which ISA was designed, "
26789 "the Hardware Clock is the only real time clock."
26792 #. type: Plain text
26793 #: ../sys-utils/hwclock.8.adoc:195
26795 "It is important that the System Time not have any discontinuities such as "
26796 "would happen if you used the *date*(1) program to set it while the system is "
26797 "running. You can, however, do whatever you want to the Hardware Clock while "
26798 "the system is running, and the next time Linux starts up, it will do so with "
26799 "the adjusted time from the Hardware Clock. Note: currently this is not "
26800 "possible on most systems because *hwclock --systohc* is called at shutdown."
26803 #. type: Plain text
26804 #: ../sys-utils/hwclock.8.adoc:197
26806 "The Linux kernel's timezone is set by *hwclock*. But don't be misled -- "
26807 "almost nobody cares what timezone the kernel thinks it is in. Instead, "
26808 "programs that care about the timezone (perhaps because they want to display "
26809 "a local time for you) almost always use a more traditional method of "
26810 "determining the timezone: They use the *TZ* environment variable or the _/"
26811 "etc/localtime_ file, as explained in the man page for *tzset*(3). However, "
26812 "some programs and fringe parts of the Linux kernel such as filesystems use "
26813 "the kernel's timezone value. An example is the vfat filesystem. If the "
26814 "kernel timezone value is wrong, the vfat filesystem will report and set the "
26815 "wrong timestamps on files. Another example is the kernel's NTP '11 minute "
26816 "mode'. If the kernel's timezone value and/or the _persistent_clock_is_local_ "
26817 "variable are wrong, then the Hardware Clock will be set incorrectly by '11 "
26818 "minute mode'. See the discussion below, under *Automatic Hardware Clock "
26819 "Synchronization by the Kernel*."
26822 #. type: Plain text
26823 #: ../sys-utils/hwclock.8.adoc:199
26825 msgid "*hwclock* sets the kernel's timezone to the value indicated by *TZ* or _/etc/localtime_ with the *--hctosys* or *--systz* functions.\n"
26828 #. type: Plain text
26829 #: ../sys-utils/hwclock.8.adoc:201
26831 "The kernel's timezone value actually consists of two parts: 1) a field "
26832 "tz_minuteswest indicating how many minutes local time (not adjusted for DST) "
26833 "lags behind UTC, and 2) a field tz_dsttime indicating the type of Daylight "
26834 "Savings Time (DST) convention that is in effect in the locality at the "
26835 "present time. This second field is not used under Linux and is always zero. "
26836 "See also *settimeofday*(2)."
26840 #: ../sys-utils/hwclock.8.adoc:202
26842 msgid "Hardware Clock Access Methods"
26845 #. type: Plain text
26846 #: ../sys-utils/hwclock.8.adoc:205
26848 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"
26851 #. type: Plain text
26852 #: ../sys-utils/hwclock.8.adoc:207
26854 "However, this method is not always available as older systems do not have an "
26855 "rtc driver. On these systems, the method of accessing the Hardware Clock "
26856 "depends on the system hardware."
26859 #. type: Plain text
26860 #: ../sys-utils/hwclock.8.adoc:209
26862 "On an ISA compatible system, *hwclock* can directly access the \"CMOS "
26863 "memory\" registers that constitute the clock, by doing I/O to Ports 0x70 and "
26864 "0x71. It does this with actual I/O instructions and consequently can only do "
26865 "it if running with superuser effective userid. This method may be used by "
26866 "specifying the *--directisa* option."
26869 #. type: Plain text
26870 #: ../sys-utils/hwclock.8.adoc:211
26872 "This is a really poor method of accessing the clock, for all the reasons "
26873 "that userspace programs are generally not supposed to do direct I/O and "
26874 "disable interrupts. *hwclock* provides it for testing, troubleshooting, and "
26875 "because it may be the only method available on ISA systems which do not have "
26876 "a working rtc device driver."
26880 #: ../sys-utils/hwclock.8.adoc:212
26882 msgid "The Adjust Function"
26885 #. type: Plain text
26886 #: ../sys-utils/hwclock.8.adoc:215
26888 "The Hardware Clock is usually not very accurate. However, much of its "
26889 "inaccuracy is completely predictable - it gains or loses the same amount of "
26890 "time every day. This is called systematic drift. *hwclock*'s *--adjust* "
26891 "function lets you apply systematic drift corrections to the Hardware Clock."
26894 #. type: Plain text
26895 #: ../sys-utils/hwclock.8.adoc:217
26897 "It works like this: *hwclock* keeps a file, _{ADJTIME_PATH}_, that keeps "
26898 "some historical information. This is called the adjtime file."
26901 #. type: Plain text
26902 #: ../sys-utils/hwclock.8.adoc:219
26904 "Suppose you start with no adjtime file. You issue a *hwclock --set* command "
26905 "to set the Hardware Clock to the true current time. *hwclock* creates the "
26906 "adjtime file and records in it the current time as the last time the clock "
26907 "was calibrated. Five days later, the clock has gained 10 seconds, so you "
26908 "issue a *hwclock --set --update-drift* command to set it back 10 seconds. "
26909 "*hwclock* updates the adjtime file to show the current time as the last time "
26910 "the clock was calibrated, and records 2 seconds per day as the systematic "
26911 "drift rate. 24 hours go by, and then you issue a *hwclock --adjust* command. "
26912 "*hwclock* consults the adjtime file and sees that the clock gains 2 seconds "
26913 "per day when left alone and that it has been left alone for exactly one day. "
26914 "So it subtracts 2 seconds from the Hardware Clock. It then records the "
26915 "current time as the last time the clock was adjusted. Another 24 hours go by "
26916 "and you issue another *hwclock --adjust*. *hwclock* does the same thing: "
26917 "subtracts 2 seconds and updates the adjtime file with the current time as "
26918 "the last time the clock was adjusted."
26921 #. type: Plain text
26922 #: ../sys-utils/hwclock.8.adoc:221
26924 "When you use the *--update-drift* option with *--set* or *--systohc*, the "
26925 "systematic drift rate is (re)calculated by comparing the fully drift "
26926 "corrected current Hardware Clock time with the new set time, from that it "
26927 "derives the 24 hour drift rate based on the last calibrated timestamp from "
26928 "the adjtime file. This updated drift factor is then saved in _{ADJTIME_PATH}"
26932 #. type: Plain text
26933 #: ../sys-utils/hwclock.8.adoc:223
26935 "A small amount of error creeps in when the Hardware Clock is set, so *--"
26936 "adjust* refrains from making any adjustment that is less than 1 second. "
26937 "Later on, when you request an adjustment again, the accumulated drift will "
26938 "be more than 1 second and *--adjust* will make the adjustment including any "
26939 "fractional amount."
26942 #. type: Plain text
26943 #: ../sys-utils/hwclock.8.adoc:225
26945 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"
26949 #: ../sys-utils/hwclock.8.adoc:226
26951 msgid "The Adjtime File"
26954 #. type: Plain text
26955 #: ../sys-utils/hwclock.8.adoc:229
26957 "While named for its historical purpose of controlling adjustments only, it "
26958 "actually contains other information used by *hwclock* from one invocation to "
26962 #. type: Plain text
26963 #: ../sys-utils/hwclock.8.adoc:231
26964 msgid "The format of the adjtime file is, in ASCII:"
26967 #. type: Plain text
26968 #: ../sys-utils/hwclock.8.adoc:233
26970 "Line 1: Three numbers, separated by blanks: 1) the systematic drift rate in "
26971 "seconds per day, floating point decimal; 2) the resulting number of seconds "
26972 "since 1969 UTC of most recent adjustment or calibration, decimal integer; 3) "
26973 "zero (for compatibility with *clock*(8)) as a floating point decimal."
26976 #. type: Plain text
26977 #: ../sys-utils/hwclock.8.adoc:235
26979 "Line 2: One number: the resulting number of seconds since 1969 UTC of most "
26980 "recent calibration. Zero if there has been no calibration yet or it is known "
26981 "that any previous calibration is moot (for example, because the Hardware "
26982 "Clock has been found, since that calibration, not to contain a valid time). "
26983 "This is a decimal integer."
26986 #. type: Plain text
26987 #: ../sys-utils/hwclock.8.adoc:237
26989 "Line 3: \"UTC\" or \"LOCAL\". Tells whether the Hardware Clock is set to "
26990 "Coordinated Universal Time or local time. You can always override this value "
26991 "with options on the *hwclock* command line."
26994 #. type: Plain text
26995 #: ../sys-utils/hwclock.8.adoc:239
26997 "You can use an adjtime file that was previously used with the *clock*(8) "
26998 "program with *hwclock*."
27002 #: ../sys-utils/hwclock.8.adoc:240
27004 msgid "Automatic Hardware Clock Synchronization by the Kernel"
27007 #. type: Plain text
27008 #: ../sys-utils/hwclock.8.adoc:243
27010 "You should be aware of another way that the Hardware Clock is kept "
27011 "synchronized in some systems. The Linux kernel has a mode wherein it copies "
27012 "the System Time to the Hardware Clock every 11 minutes. This mode is a "
27013 "compile time option, so not all kernels will have this capability. This is a "
27014 "good mode to use when you are using something sophisticated like NTP to keep "
27015 "your System Clock synchronized. (NTP is a way to keep your System Time "
27016 "synchronized either to a time server somewhere on the network or to a radio "
27017 "clock hooked up to your system. See RFC 1305.)"
27020 #. type: Plain text
27021 #: ../sys-utils/hwclock.8.adoc:245
27023 "If the kernel is compiled with the '11 minute mode' option it will be active "
27024 "when the kernel's clock discipline is in a synchronized state. When in this "
27025 "state, bit 6 (the bit that is set in the mask 0x0040) of the kernel's "
27026 "_time_status_ variable is unset. This value is output as the 'status' line "
27027 "of the *adjtimex --print* or *ntptime* commands."
27030 #. type: Plain text
27031 #: ../sys-utils/hwclock.8.adoc:247
27033 "It takes an outside influence, like the NTP daemon to put the kernel's clock "
27034 "discipline into a synchronized state, and therefore turn on '11 minute "
27035 "mode'. It can be turned off by running anything that sets the System Clock "
27036 "the old fashioned way, including *hwclock --hctosys*. However, if the NTP "
27037 "daemon is still running, it will turn '11 minute mode' back on again the "
27038 "next time it synchronizes the System Clock."
27041 #. type: Plain text
27042 #: ../sys-utils/hwclock.8.adoc:249
27044 "If your system runs with '11 minute mode' on, it may need to use either *--"
27045 "hctosys* or *--systz* in a startup script, especially if the Hardware Clock "
27046 "is configured to use the local timescale. Unless the kernel is informed of "
27047 "what timescale the Hardware Clock is using, it may clobber it with the wrong "
27048 "one. The kernel uses UTC by default."
27051 #. type: Plain text
27052 #: ../sys-utils/hwclock.8.adoc:251
27054 "The first userspace command to set the System Clock informs the kernel what "
27055 "timescale the Hardware Clock is using. This happens via the "
27056 "_persistent_clock_is_local_ kernel variable. If *--hctosys* or *--systz* is "
27057 "the first, it will set this variable according to the adjtime file or the "
27058 "appropriate command-line argument. Note that when using this capability and "
27059 "the Hardware Clock timescale configuration is changed, then a reboot is "
27060 "required to notify the kernel."
27063 #. type: Plain text
27064 #: ../sys-utils/hwclock.8.adoc:253
27066 msgid "*hwclock --adjust* should not be used with NTP '11 minute mode'.\n"
27070 #: ../sys-utils/hwclock.8.adoc:254
27072 msgid "ISA Hardware Clock Century value"
27075 #. type: Plain text
27076 #: ../sys-utils/hwclock.8.adoc:257
27078 "There is some sort of standard that defines CMOS memory Byte 50 on an ISA "
27079 "machine as an indicator of what century it is. *hwclock* does not use or set "
27080 "that byte because there are some machines that don't define the byte that "
27081 "way, and it really isn't necessary anyway, since the year-of-century does a "
27082 "good job of implying which century it is."
27085 #. type: Plain text
27086 #: ../sys-utils/hwclock.8.adoc:259
27088 "If you have a bona fide use for a CMOS century byte, contact the *hwclock* "
27089 "maintainer; an option may be appropriate."
27092 #. type: Plain text
27093 #: ../sys-utils/hwclock.8.adoc:261
27095 "Note that this section is only relevant when you are using the \"direct "
27096 "ISA\" method of accessing the Hardware Clock. ACPI provides a standard way "
27097 "to access century values, when they are supported by the hardware."
27101 #: ../sys-utils/hwclock.8.adoc:262
27103 msgid "DATE-TIME CONFIGURATION"
27107 #: ../sys-utils/hwclock.8.adoc:264
27109 msgid "Keeping Time without External Synchronization"
27112 #. type: Plain text
27113 #: ../sys-utils/hwclock.8.adoc:267
27114 msgid "This discussion is based on the following conditions:"
27117 #. type: Plain text
27118 #: ../sys-utils/hwclock.8.adoc:269
27120 "Nothing is running that alters the date-time clocks, such as NTP daemon or a "
27124 #. type: Plain text
27125 #: ../sys-utils/hwclock.8.adoc:270
27127 "The system timezone is configured for the correct local time. See below, "
27128 "under *POSIX vs 'RIGHT'*."
27131 #. type: Plain text
27132 #: ../sys-utils/hwclock.8.adoc:271
27134 "Early during startup the following are called, in this order: *adjtimex --"
27135 "tick* _value_ *--frequency* _value_ *hwclock --hctosys*"
27138 #. type: Plain text
27139 #: ../sys-utils/hwclock.8.adoc:272
27140 msgid "During shutdown the following is called: *hwclock --systohc*"
27143 #. type: Plain text
27144 #: ../sys-utils/hwclock.8.adoc:274
27145 msgid "Systems without *adjtimex* may use *ntptime*."
27148 #. type: Plain text
27149 #: ../sys-utils/hwclock.8.adoc:276
27151 "Whether maintaining precision time with NTP daemon or not, it makes sense to "
27152 "configure the system to keep reasonably good date-time on its own."
27155 #. type: Plain text
27156 #: ../sys-utils/hwclock.8.adoc:278
27158 "The first step in making that happen is having a clear understanding of the "
27159 "big picture. There are two completely separate hardware devices running at "
27160 "their own speed and drifting away from the 'correct' time at their own "
27161 "rates. The methods and software for drift correction are different for each "
27162 "of them. However, most systems are configured to exchange values between "
27163 "these two clocks at startup and shutdown. Now the individual device's time "
27164 "keeping errors are transferred back and forth between each other. Attempt to "
27165 "configure drift correction for only one of them, and the other's drift will "
27166 "be overlaid upon it."
27169 #. type: Plain text
27170 #: ../sys-utils/hwclock.8.adoc:280
27172 "This problem can be avoided when configuring drift correction for the System "
27173 "Clock by simply not shutting down the machine. This, plus the fact that all "
27174 "of *hwclock*'s precision (including calculating drift factors) depends upon "
27175 "the System Clock's rate being correct, means that configuration of the "
27176 "System Clock should be done first."
27179 #. type: Plain text
27180 #: ../sys-utils/hwclock.8.adoc:282
27182 "The System Clock drift is corrected with the *adjtimex*(8) command's *--"
27183 "tick* and *--frequency* options. These two work together: tick is the coarse "
27184 "adjustment and frequency is the fine adjustment. (For systems that do not "
27185 "have an *adjtimex* package, *ntptime -f* _ppm_ may be used instead.)"
27188 #. type: Plain text
27189 #: ../sys-utils/hwclock.8.adoc:284
27191 "Some Linux distributions attempt to automatically calculate the System Clock "
27192 "drift with *adjtimex*'s compare operation. Trying to correct one drifting "
27193 "clock by using another drifting clock as a reference is akin to a dog trying "
27194 "to catch its own tail. Success may happen eventually, but great effort and "
27195 "frustration will likely precede it. This automation may yield an improvement "
27196 "over no configuration, but expecting optimum results would be in error. A "
27197 "better choice for manual configuration would be *adjtimex*'s *--log* options."
27200 #. type: Plain text
27201 #: ../sys-utils/hwclock.8.adoc:286
27203 "It may be more effective to simply track the System Clock drift with *sntp*, "
27204 "or *date -Ins* and a precision timepiece, and then calculate the correction "
27208 #. type: Plain text
27209 #: ../sys-utils/hwclock.8.adoc:288
27211 "After setting the tick and frequency values, continue to test and refine the "
27212 "adjustments until the System Clock keeps good time. See *adjtimex*(2) for "
27213 "more information and the example demonstrating manual drift calculations."
27216 #. type: Plain text
27217 #: ../sys-utils/hwclock.8.adoc:290
27219 "Once the System Clock is ticking smoothly, move on to the Hardware Clock."
27222 #. type: Plain text
27223 #: ../sys-utils/hwclock.8.adoc:292
27225 "As a rule, cold drift will work best for most use cases. This should be true "
27226 "even for 24/7 machines whose normal downtime consists of a reboot. In that "
27227 "case the drift factor value makes little difference. But on the rare "
27228 "occasion that the machine is shut down for an extended period, then cold "
27229 "drift should yield better results."
27232 #. type: Plain text
27233 #: ../sys-utils/hwclock.8.adoc:294
27235 msgid "*Steps to calculate cold drift:*\n"
27238 #. type: Plain text
27239 #: ../sys-utils/hwclock.8.adoc:297
27241 msgid "*Ensure that NTP daemon will not be launched at startup.*\n"
27244 #. type: Plain text
27245 #: ../sys-utils/hwclock.8.adoc:300
27246 msgid "The _System Clock_ time must be correct at shutdown!"
27249 #. type: Labeled list
27250 #: ../sys-utils/hwclock.8.adoc:301
27255 #. type: Plain text
27256 #: ../sys-utils/hwclock.8.adoc:303
27257 msgid "Shut down the system."
27260 #. type: Labeled list
27261 #: ../sys-utils/hwclock.8.adoc:304
27266 #. type: Plain text
27267 #: ../sys-utils/hwclock.8.adoc:306
27268 msgid "Let an extended period pass without changing the Hardware Clock."
27271 #. type: Labeled list
27272 #: ../sys-utils/hwclock.8.adoc:307
27277 #. type: Plain text
27278 #: ../sys-utils/hwclock.8.adoc:309
27279 msgid "Start the system."
27282 #. type: Labeled list
27283 #: ../sys-utils/hwclock.8.adoc:310
27288 #. type: Plain text
27289 #: ../sys-utils/hwclock.8.adoc:312
27291 "Immediately use *hwclock* to set the correct time, adding the *--update-"
27295 #. type: Plain text
27296 #: ../sys-utils/hwclock.8.adoc:314
27298 "Note: if step 6 uses *--systohc*, then the System Clock must be set "
27299 "correctly (step 6a) just before doing so."
27302 #. type: Plain text
27303 #: ../sys-utils/hwclock.8.adoc:316
27305 "Having *hwclock* calculate the drift factor is a good starting point, but "
27306 "for optimal results it will likely need to be adjusted by directly editing "
27307 "the _{ADJTIME_PATH}_ file. Continue to test and refine the drift factor "
27308 "until the Hardware Clock is corrected properly at startup. To check this, "
27309 "first make sure that the System Time is correct before shutdown and then use "
27310 "*sntp*, or *date -Ins* and a precision timepiece, immediately after startup."
27314 #: ../sys-utils/hwclock.8.adoc:317
27316 msgid "LOCAL vs UTC"
27319 #. type: Plain text
27320 #: ../sys-utils/hwclock.8.adoc:320
27322 "Keeping the Hardware Clock in a local timescale causes inconsistent daylight "
27323 "saving time results:"
27326 #. type: Plain text
27327 #: ../sys-utils/hwclock.8.adoc:322
27329 "If Linux is running during a daylight saving time change, the time written "
27330 "to the Hardware Clock will be adjusted for the change."
27333 #. type: Plain text
27334 #: ../sys-utils/hwclock.8.adoc:323
27336 "If Linux is NOT running during a daylight saving time change, the time read "
27337 "from the Hardware Clock will NOT be adjusted for the change."
27340 #. type: Plain text
27341 #: ../sys-utils/hwclock.8.adoc:325
27343 "The Hardware Clock on an ISA compatible system keeps only a date and time, "
27344 "it has no concept of timezone nor daylight saving. Therefore, when *hwclock* "
27345 "is told that it is in local time, it assumes it is in the 'correct' local "
27346 "time and makes no adjustments to the time read from it."
27349 #. type: Plain text
27350 #: ../sys-utils/hwclock.8.adoc:327
27352 "Linux handles daylight saving time changes transparently only when the "
27353 "Hardware Clock is kept in the UTC timescale. Doing so is made easy for "
27354 "system administrators as *hwclock* uses local time for its output and as the "
27355 "argument to the *--date* option."
27358 #. type: Plain text
27359 #: ../sys-utils/hwclock.8.adoc:329
27361 "POSIX systems, like Linux, are designed to have the System Clock operate in "
27362 "the UTC timescale. The Hardware Clock's purpose is to initialize the System "
27363 "Clock, so also keeping it in UTC makes sense."
27366 #. type: Plain text
27367 #: ../sys-utils/hwclock.8.adoc:331
27369 "Linux does, however, attempt to accommodate the Hardware Clock being in the "
27370 "local timescale. This is primarily for dual-booting with older versions of "
27371 "MS Windows. From Windows 7 on, the RealTimeIsUniversal registry key is "
27372 "supposed to be working properly so that its Hardware Clock can be kept in "
27377 #: ../sys-utils/hwclock.8.adoc:332
27379 msgid "POSIX vs 'RIGHT'"
27382 #. type: Plain text
27383 #: ../sys-utils/hwclock.8.adoc:335
27385 "A discussion on date-time configuration would be incomplete without "
27386 "addressing timezones, this is mostly well covered by *tzset*(3). One area "
27387 "that seems to have no documentation is the 'right' directory of the Time "
27388 "Zone Database, sometimes called tz or zoneinfo."
27391 #. TRANSLATORS: Keep {plus} untranslated.
27392 #. type: Plain text
27393 #: ../sys-utils/hwclock.8.adoc:338
27395 "There are two separate databases in the zoneinfo system, posix and 'right'. "
27396 "'Right' (now named zoneinfo-leaps) includes leap seconds and posix does not. "
27397 "To use the 'right' database the System Clock must be set to (UTC {plus} leap "
27398 "seconds), which is equivalent to (TAI - 10). This allows calculating the "
27399 "exact number of seconds between two dates that cross a leap second epoch. "
27400 "The System Clock is then converted to the correct civil time, including UTC, "
27401 "by using the 'right' timezone files which subtract the leap seconds. Note: "
27402 "this configuration is considered experimental and is known to have issues."
27405 #. type: Plain text
27406 #: ../sys-utils/hwclock.8.adoc:340
27408 "To configure a system to use a particular database all of the files located "
27409 "in its directory must be copied to the root of _/usr/share/zoneinfo_. Files "
27410 "are never used directly from the posix or 'right' subdirectories, e.g., "
27411 "TZ='_right/Europe/Dublin_'. This habit was becoming so common that the "
27412 "upstream zoneinfo project restructured the system's file tree by moving the "
27413 "posix and 'right' subdirectories out of the zoneinfo directory and into "
27414 "sibling directories:"
27417 #. type: Plain text
27418 #: ../sys-utils/hwclock.8.adoc:342
27420 "_/usr/share/zoneinfo_, _/usr/share/zoneinfo-posix_, _/usr/share/zoneinfo-"
27424 #. type: Plain text
27425 #: ../sys-utils/hwclock.8.adoc:344
27427 "Unfortunately, some Linux distributions are changing it back to the old tree "
27428 "structure in their packages. So the problem of system administrators "
27429 "reaching into the 'right' subdirectory persists. This causes the system "
27430 "timezone to be configured to include leap seconds while the zoneinfo "
27431 "database is still configured to exclude them. Then when an application such "
27432 "as a World Clock needs the South_Pole timezone file; or an email MTA, or "
27433 "*hwclock* needs the UTC timezone file; they fetch it from the root of _/usr/"
27434 "share/zoneinfo_ , because that is what they are supposed to do. Those files "
27435 "exclude leap seconds, but the System Clock now includes them, causing an "
27436 "incorrect time conversion."
27439 #. type: Plain text
27440 #: ../sys-utils/hwclock.8.adoc:346
27442 "Attempting to mix and match files from these separate databases will not "
27443 "work, because they each require the System Clock to use a different "
27444 "timescale. The zoneinfo database must be configured to use either posix or "
27445 "'right', as described above, or by assigning a database path to the _TZDIR_ "
27446 "environment variable."
27449 #. type: Plain text
27450 #: ../sys-utils/hwclock.8.adoc:350
27451 msgid "One of the following exit values will be returned:"
27454 #. type: Labeled list
27455 #: ../sys-utils/hwclock.8.adoc:351
27457 msgid "*EXIT_SUCCESS* ('0' on POSIX systems)"
27460 #. type: Plain text
27461 #: ../sys-utils/hwclock.8.adoc:353
27462 msgid "Successful program execution."
27465 #. type: Labeled list
27466 #: ../sys-utils/hwclock.8.adoc:354
27468 msgid "*EXIT_FAILURE* ('1' on POSIX systems)"
27471 #. type: Plain text
27472 #: ../sys-utils/hwclock.8.adoc:356
27473 msgid "The operation failed or the command syntax was not valid."
27476 #. type: Labeled list
27477 #: ../sys-utils/hwclock.8.adoc:359
27482 #. type: Plain text
27483 #: ../sys-utils/hwclock.8.adoc:361
27485 "If this variable is set its value takes precedence over the system "
27486 "configured timezone."
27489 #. type: Labeled list
27490 #: ../sys-utils/hwclock.8.adoc:362
27495 #. type: Plain text
27496 #: ../sys-utils/hwclock.8.adoc:364
27498 "If this variable is set its value takes precedence over the system "
27499 "configured timezone database directory path."
27502 #. type: Plain text
27503 #: ../sys-utils/hwclock.8.adoc:367 ../sys-utils/rtcwake.8.adoc:117
27505 msgid "_{ADJTIME_PATH}_"
27508 #. type: Plain text
27509 #: ../sys-utils/hwclock.8.adoc:369
27511 "The configuration and state file for *hwclock*. See also *adjtime_config*(5)."
27514 #. type: Labeled list
27515 #: ../sys-utils/hwclock.8.adoc:370
27517 #| msgid "_/etc/login.defs_"
27518 msgid "_/etc/localtime_"
27519 msgstr "_/etc/login.defs_"
27521 #. type: Plain text
27522 #: ../sys-utils/hwclock.8.adoc:372
27523 msgid "The system timezone file."
27526 #. type: Labeled list
27527 #: ../sys-utils/hwclock.8.adoc:373
27529 msgid "_/usr/share/zoneinfo/_"
27532 #. type: Plain text
27533 #: ../sys-utils/hwclock.8.adoc:375
27534 msgid "The system timezone database directory."
27537 #. type: Plain text
27538 #: ../sys-utils/hwclock.8.adoc:377
27540 "Device files *hwclock* may try for Hardware Clock access: _/dev/rtc0_ _/dev/"
27541 "rtc_ _/dev/misc/rtc_ _/dev/efirtc_ _/dev/misc/efirtc_"
27544 #. type: Plain text
27545 #: ../sys-utils/hwclock.8.adoc:387
27549 "*adjtime_config*(5),\n"
27551 "*gettimeofday*(2),\n"
27552 "*settimeofday*(2),\n"
27557 #. type: Plain text
27558 #: ../sys-utils/hwclock.8.adoc:391
27560 "Written by mailto:bryanh@giraffe-data.com[Bryan Henderson], September 1996, "
27561 "based on work done on the *clock*(8) program by Charles Hedrick, Rob Hooft, "
27562 "and Harald Koenig. See the source code for complete history and credits."
27565 #. Copyright 2008 Hayden A. James (hayden.james@gmail.com)
27566 #. May be distributed under the GNU General Public License
27568 #: ../sys-utils/ipcmk.1.adoc:6
27573 #. type: Plain text
27574 #: ../sys-utils/ipcmk.1.adoc:16
27575 msgid "ipcmk - make various IPC resources"
27578 #. type: Plain text
27579 #: ../sys-utils/ipcmk.1.adoc:20
27581 msgid "*ipcmk* [options]\n"
27584 #. type: Plain text
27585 #: ../sys-utils/ipcmk.1.adoc:24
27587 msgid "*ipcmk* allows you to create System V inter-process communication (IPC) objects: shared memory segments, message queues, and semaphore arrays.\n"
27590 #. type: Plain text
27591 #: ../sys-utils/ipcmk.1.adoc:28
27592 msgid "Resources can be specified with these options:"
27595 #. type: Labeled list
27596 #: ../sys-utils/ipcmk.1.adoc:29
27598 #| msgid "*-s*, **--shell**=__shell__"
27599 msgid "*-M*, *--shmem* _size_"
27600 msgstr "*-s*, **--shell**=__shell__"
27602 #. type: Plain text
27603 #: ../sys-utils/ipcmk.1.adoc:31
27605 "Create a shared memory segment of _size_ bytes. The _size_ argument may be "
27606 "followed by the multiplicative suffixes KiB (=1024), MiB (=1024*1024), and "
27607 "so on for GiB, etc. (the \"iB\" is optional, e.g., \"K\" has the same "
27608 "meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
27612 #. type: Labeled list
27613 #: ../sys-utils/ipcmk.1.adoc:32
27615 #| msgid "*-h*, *--help*"
27616 msgid "*-Q*, *--queue*"
27617 msgstr "*-h*, *--help*"
27619 #. type: Plain text
27620 #: ../sys-utils/ipcmk.1.adoc:34
27621 msgid "Create a message queue."
27624 #. type: Labeled list
27625 #: ../sys-utils/ipcmk.1.adoc:35
27627 msgid "*-S*, *--semaphore* _number_"
27630 #. type: Plain text
27631 #: ../sys-utils/ipcmk.1.adoc:37
27632 msgid "Create a semaphore array with _number_ of elements."
27635 #. type: Plain text
27636 #: ../sys-utils/ipcmk.1.adoc:39
27637 msgid "Other options are:"
27640 #. type: Labeled list
27641 #: ../sys-utils/ipcmk.1.adoc:40
27643 msgid "*-p*, *--mode* _mode_"
27646 #. type: Plain text
27647 #: ../sys-utils/ipcmk.1.adoc:42
27648 msgid "Access permissions for the resource. Default is 0644."
27651 #. type: Plain text
27652 #: ../sys-utils/ipcmk.1.adoc:48
27653 msgid "mailto:hayden.james@gmail.com[Hayden A. James]"
27656 #. type: Plain text
27657 #: ../sys-utils/ipcmk.1.adoc:54
27665 #. Copyright 2002 Andre C. Mazzone (linuxdev@karagee.com)
27666 #. May be distributed under the GNU General Public License
27668 #: ../sys-utils/ipcrm.1.adoc:6
27673 #. type: Plain text
27674 #: ../sys-utils/ipcrm.1.adoc:17
27675 msgid "ipcrm - remove certain IPC resources"
27678 #. type: Plain text
27679 #: ../sys-utils/ipcrm.1.adoc:21
27681 msgid "*ipcrm* [options]\n"
27684 #. type: Plain text
27685 #: ../sys-utils/ipcrm.1.adoc:23
27687 msgid "*ipcrm* [*shm*|*msg*|*sem*] _ID_ ...\n"
27690 #. type: Plain text
27691 #: ../sys-utils/ipcrm.1.adoc:27
27693 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"
27696 #. type: Plain text
27697 #: ../sys-utils/ipcrm.1.adoc:29
27699 "System V IPC objects are of three types: shared memory, message queues, and "
27700 "semaphores. Deletion of a message queue or semaphore object is immediate "
27701 "(regardless of whether any process still holds an IPC identifier for the "
27702 "object). A shared memory object is only removed after all currently attached "
27703 "processes have detached (*shmdt*(2)) the object from their virtual address "
27707 #. type: Plain text
27708 #: ../sys-utils/ipcrm.1.adoc:31
27710 "Two syntax styles are supported. The old Linux historical syntax specifies a "
27711 "three-letter keyword indicating which class of object is to be deleted, "
27712 "followed by one or more IPC identifiers for objects of this type."
27715 #. type: Plain text
27716 #: ../sys-utils/ipcrm.1.adoc:33
27718 "The SUS-compliant syntax allows the specification of zero or more objects of "
27719 "all three types in a single command line, with objects specified either by "
27720 "key or by identifier (see below). Both keys and identifiers may be specified "
27721 "in decimal, hexadecimal (specified with an initial '0x' or '0X'), or octal "
27722 "(specified with an initial '0')."
27725 #. type: Plain text
27726 #: ../sys-utils/ipcrm.1.adoc:35
27728 "The details of the removes are described in *shmctl*(2), *msgctl*(2), and "
27729 "*semctl*(2). The identifiers and keys can be found by using *ipcs*(1)."
27732 #. type: Labeled list
27733 #: ../sys-utils/ipcrm.1.adoc:38
27735 msgid "*-a*, *--all* [*shm*] [*msg*] [*sem*]"
27738 #. type: Plain text
27739 #: ../sys-utils/ipcrm.1.adoc:40
27741 "Remove all resources. When an option argument is provided, the removal is "
27742 "performed only for the specified resource types."
27745 #. type: Plain text
27746 #: ../sys-utils/ipcrm.1.adoc:42
27748 "_Warning!_ Do not use *-a* if you are unsure how the software using the "
27749 "resources might react to missing objects. Some programs create these "
27750 "resources at startup and may not have any code to deal with an unexpected "
27754 #. type: Labeled list
27755 #: ../sys-utils/ipcrm.1.adoc:43
27757 #| msgid "*-s*, **--shell**=__shell__"
27758 msgid "*-M*, *--shmem-key* _shmkey_"
27759 msgstr "*-s*, **--shell**=__shell__"
27761 #. type: Plain text
27762 #: ../sys-utils/ipcrm.1.adoc:45
27764 "Remove the shared memory segment created with _shmkey_ after the last detach "
27768 #. type: Labeled list
27769 #: ../sys-utils/ipcrm.1.adoc:46
27771 #| msgid "*-s*, **--shell**=__shell__"
27772 msgid "*-m*, *--shmem-id* _shmid_"
27773 msgstr "*-s*, **--shell**=__shell__"
27775 #. type: Plain text
27776 #: ../sys-utils/ipcrm.1.adoc:48
27778 "Remove the shared memory segment identified by _shmid_ after the last detach "
27782 #. type: Labeled list
27783 #: ../sys-utils/ipcrm.1.adoc:49
27785 msgid "*-Q*, *--queue-key* _msgkey_"
27788 #. type: Plain text
27789 #: ../sys-utils/ipcrm.1.adoc:51
27790 msgid "Remove the message queue created with _msgkey_."
27793 #. type: Labeled list
27794 #: ../sys-utils/ipcrm.1.adoc:52
27796 msgid "*-q*, *--queue-id* _msgid_"
27799 #. type: Plain text
27800 #: ../sys-utils/ipcrm.1.adoc:54
27801 msgid "Remove the message queue identified by _msgid_."
27804 #. type: Labeled list
27805 #: ../sys-utils/ipcrm.1.adoc:55
27807 msgid "*-S*, *--semaphore-key* _semkey_"
27810 #. type: Plain text
27811 #: ../sys-utils/ipcrm.1.adoc:57
27812 msgid "Remove the semaphore created with _semkey_."
27815 #. type: Labeled list
27816 #: ../sys-utils/ipcrm.1.adoc:58
27818 msgid "*-s*, *--semaphore-id* _semid_"
27821 #. type: Plain text
27822 #: ../sys-utils/ipcrm.1.adoc:60
27823 msgid "Remove the semaphore identified by _semid_."
27826 #. TRANSLATORS: Keep {asterisk} untranslated; it expands to "*nix".
27827 #. type: Plain text
27828 #: ../sys-utils/ipcrm.1.adoc:67
27830 "In its first Linux implementation, *ipcrm* used the deprecated syntax shown "
27831 "in the second line of the *SYNOPSIS*. Functionality present in other "
27832 "{asterisk}nix implementations of *ipcrm* has since been added, namely the "
27833 "ability to delete resources by key (not just identifier), and to respect the "
27834 "same command-line syntax. For backward compatibility the previous syntax is "
27838 #. type: Plain text
27839 #: ../sys-utils/ipcrm.1.adoc:81
27855 #. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
27856 #. May be distributed under the GNU General Public License
27858 #: ../sys-utils/ipcs.1.adoc:6
27863 #. type: Plain text
27864 #: ../sys-utils/ipcs.1.adoc:16
27866 #| msgid "fstab - static information about the filesystems"
27867 msgid "ipcs - show information on IPC facilities"
27868 msgstr "fstab - statická informace o souborových systémech"
27870 #. type: Plain text
27871 #: ../sys-utils/ipcs.1.adoc:20
27873 msgid "*ipcs* [options]\n"
27876 #. type: Plain text
27877 #: ../sys-utils/ipcs.1.adoc:24
27879 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"
27882 #. type: Labeled list
27883 #: ../sys-utils/ipcs.1.adoc:27 ../sys-utils/lsipc.1.adoc:23
27885 #| msgid "*-P*, *--pty*"
27886 msgid "*-i*, *--id* _id_"
27887 msgstr "*-P*, *--pty*"
27889 #. type: Plain text
27890 #: ../sys-utils/ipcs.1.adoc:29
27892 "Show full details on just the one resource element identified by _id_. This "
27893 "option needs to be combined with one of the three resource options: *-m*, *-"
27898 #: ../sys-utils/ipcs.1.adoc:32 ../sys-utils/lsipc.1.adoc:31
27900 msgid "Resource options"
27903 #. type: Labeled list
27904 #: ../sys-utils/ipcs.1.adoc:34 ../sys-utils/lsipc.1.adoc:33
27906 #| msgid "*-h*, *--help*"
27907 msgid "*-m*, *--shmems*"
27908 msgstr "*-h*, *--help*"
27910 #. type: Plain text
27911 #: ../sys-utils/ipcs.1.adoc:36 ../sys-utils/lsipc.1.adoc:35
27912 msgid "Write information about active shared memory segments."
27915 #. type: Labeled list
27916 #: ../sys-utils/ipcs.1.adoc:37 ../sys-utils/lsipc.1.adoc:36
27918 #| msgid "*-h*, *--help*"
27919 msgid "*-q*, *--queues*"
27920 msgstr "*-h*, *--help*"
27922 #. type: Plain text
27923 #: ../sys-utils/ipcs.1.adoc:39 ../sys-utils/lsipc.1.adoc:38
27924 msgid "Write information about active message queues."
27927 #. type: Labeled list
27928 #: ../sys-utils/ipcs.1.adoc:40 ../sys-utils/lsipc.1.adoc:39
27930 #| msgid "*-V*, *--version*"
27931 msgid "*-s*, *--semaphores*"
27932 msgstr "*-V*, *--version*"
27934 #. type: Plain text
27935 #: ../sys-utils/ipcs.1.adoc:42 ../sys-utils/lsipc.1.adoc:41
27936 msgid "Write information about active semaphore sets."
27939 #. type: Plain text
27940 #: ../sys-utils/ipcs.1.adoc:45
27941 msgid "Write information about all three resources (default)."
27945 #: ../sys-utils/ipcs.1.adoc:46
27947 #| msgid "File formats"
27948 msgid "Output formats"
27949 msgstr "Formáty souborů"
27951 #. type: Plain text
27952 #: ../sys-utils/ipcs.1.adoc:49
27953 msgid "Of these options only one takes effect: the last one specified."
27956 #. type: Labeled list
27957 #: ../sys-utils/ipcs.1.adoc:50 ../sys-utils/lsipc.1.adoc:44
27959 #| msgid "*-f*, *--fast*"
27960 msgid "*-c*, *--creator*"
27961 msgstr "*-f*, *--fast*"
27963 #. type: Plain text
27964 #: ../sys-utils/ipcs.1.adoc:52 ../sys-utils/lsipc.1.adoc:46
27965 msgid "Show creator and owner."
27968 #. type: Labeled list
27969 #: ../sys-utils/ipcs.1.adoc:53
27971 #| msgid "*-P*, *--pty*"
27972 msgid "*-l*, *--limits*"
27973 msgstr "*-P*, *--pty*"
27975 #. type: Plain text
27976 #: ../sys-utils/ipcs.1.adoc:55
27977 msgid "Show resource limits."
27980 #. type: Plain text
27981 #: ../sys-utils/ipcs.1.adoc:58
27982 msgid "Show PIDs of creator and last operator."
27985 #. type: Plain text
27986 #: ../sys-utils/ipcs.1.adoc:61 ../sys-utils/lsipc.1.adoc:76
27988 "Write time information. The time of the last control operation that changed "
27989 "the access permissions for all facilities, the time of the last *msgsnd*(2) "
27990 "and *msgrcv*(2) operations on message queues, the time of the last "
27991 "*shmat*(2) and *shmdt*(2) operations on shared memory, and the time of the "
27992 "last *semop*(2) operation on semaphores."
27995 #. type: Labeled list
27996 #: ../sys-utils/ipcs.1.adoc:62
27998 #| msgid "*-P*, *--pty*"
27999 msgid "*-u*, *--summary*"
28000 msgstr "*-P*, *--pty*"
28002 #. type: Plain text
28003 #: ../sys-utils/ipcs.1.adoc:64
28004 msgid "Show status summary."
28008 #: ../sys-utils/ipcs.1.adoc:65
28010 msgid "Representation"
28013 #. type: Plain text
28014 #: ../sys-utils/ipcs.1.adoc:68
28015 msgid "These affect only the *-l* (*--limits*) option."
28018 #. type: Labeled list
28019 #: ../sys-utils/ipcs.1.adoc:73
28024 #. type: Plain text
28025 #: ../sys-utils/ipcs.1.adoc:75
28027 #| msgid "Print the sizes in bytes rather than in a human-readable format."
28028 msgid "Print sizes in human-readable format."
28029 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
28031 #. type: Plain text
28032 #: ../sys-utils/ipcs.1.adoc:79
28034 "The Linux *ipcs* utility is not fully compatible to the POSIX *ipcs* "
28035 "utility. The Linux version does not support the POSIX *-a*, *-b* and *-o* "
28036 "options, but does support the *-l* and *-u* options not defined by POSIX. A "
28037 "portable application shall not use the *-a*, *-b*, *-o*, *-l*, and *-u* "
28041 #. type: Plain text
28042 #: ../sys-utils/ipcs.1.adoc:83
28044 "The current implementation of *ipcs* obtains information about available IPC "
28045 "resources by parsing the files in _/proc/sysvipc_. Before util-linux version "
28046 "v2.23, an alternate mechanism was used: the *IPC_STAT* command of "
28047 "*msgctl*(2), *semctl*(2), and *shmctl*(2). This mechanism is also used in "
28048 "later util-linux versions in the case where _/proc_ is unavailable. A "
28049 "limitation of the *IPC_STAT* mechanism is that it can only be used to "
28050 "retrieve information about IPC resources for which the user has read "
28054 #. type: Plain text
28055 #: ../sys-utils/ipcs.1.adoc:87
28056 msgid "mailto:balasub@cis.ohio-state.edu[Krishna Balasubramanian]"
28059 #. type: Plain text
28060 #: ../sys-utils/ipcs.1.adoc:100 ../sys-utils/lsipc.1.adoc:118
28076 #: ../sys-utils/irqtop.1.adoc:2
28081 #. type: Plain text
28082 #: ../sys-utils/irqtop.1.adoc:12
28083 msgid "irqtop - utility to display kernel interrupt information"
28086 #. type: Plain text
28087 #: ../sys-utils/irqtop.1.adoc:16
28089 msgid "*irqtop* [options]\n"
28092 #. type: Plain text
28093 #: ../sys-utils/irqtop.1.adoc:20
28094 msgid "Display kernel interrupt counter information in *top*(1) style view."
28097 #. type: Plain text
28098 #: ../sys-utils/irqtop.1.adoc:22 ../sys-utils/lsirq.1.adoc:22
28100 "The default output is subject to change. So whenever possible, you should "
28101 "avoid using default outputs in your scripts. Always explicitly define "
28102 "expected columns by using *--output*."
28105 #. type: Plain text
28106 #: ../sys-utils/irqtop.1.adoc:27 ../sys-utils/lsirq.1.adoc:30
28108 "Specify which output columns to print. Use *--help* to get a list of all "
28109 "supported columns. The default list of columns may be extended if list is "
28110 "specified in the format _+list_."
28113 #. type: Labeled list
28114 #: ../sys-utils/irqtop.1.adoc:28
28116 msgid "*-c*, *--cpu-stat* _mode_"
28119 #. type: Plain text
28120 #: ../sys-utils/irqtop.1.adoc:30
28122 "Show per-cpu statistics by specified mode. Available modes are: *auto*, "
28123 "*enable*, *disable*. The default option *auto* detects the width of window, "
28124 "then shows the per-cpu statistics if the width of window is large enough to "
28125 "show a full line of statistics."
28128 #. type: Labeled list
28129 #: ../sys-utils/irqtop.1.adoc:31
28131 #| msgid "*-P*, *--pty*"
28132 msgid "*-C*, *--cpu-list* _list_"
28133 msgstr "*-P*, *--pty*"
28135 #. type: Plain text
28136 #: ../sys-utils/irqtop.1.adoc:33
28137 msgid "Specify cpus in list format to show."
28140 #. type: Labeled list
28141 #: ../sys-utils/irqtop.1.adoc:34
28143 msgid "*-d*, *--delay* _seconds_"
28146 #. type: Plain text
28147 #: ../sys-utils/irqtop.1.adoc:36
28148 msgid "Update interrupt output every _seconds_ intervals."
28151 #. type: Labeled list
28152 #: ../sys-utils/irqtop.1.adoc:37 ../sys-utils/lsirq.1.adoc:31
28154 msgid "*-s*, *--sort* _column_"
28157 #. type: Plain text
28158 #: ../sys-utils/irqtop.1.adoc:39
28160 "Specify sort criteria by column name. See *--help* output to get column "
28161 "names. The sort criteria may be changes in interactive mode."
28164 #. type: Labeled list
28165 #: ../sys-utils/irqtop.1.adoc:40 ../sys-utils/lsirq.1.adoc:40
28167 #| msgid "*-f*, *--fast*"
28168 msgid "*-S*, *--softirq*"
28169 msgstr "*-f*, *--fast*"
28171 #. type: Plain text
28172 #: ../sys-utils/irqtop.1.adoc:42 ../sys-utils/lsirq.1.adoc:42
28173 msgid "Show softirqs information."
28177 #: ../sys-utils/irqtop.1.adoc:45
28179 msgid "INTERACTIVE MODE KEY COMMANDS"
28182 #. type: Labeled list
28183 #: ../sys-utils/irqtop.1.adoc:47
28188 #. type: Plain text
28189 #: ../sys-utils/irqtop.1.adoc:49
28190 msgid "sort by short irq name or number field"
28193 #. type: Plain text
28194 #: ../sys-utils/irqtop.1.adoc:52
28195 msgid "sort by total count of interrupts (the default)"
28198 #. type: Plain text
28199 #: ../sys-utils/irqtop.1.adoc:55
28200 msgid "sort by delta count of interrupts"
28203 #. type: Plain text
28204 #: ../sys-utils/irqtop.1.adoc:58
28205 msgid "sort by long descriptive name field"
28208 #. type: Labeled list
28209 #: ../sys-utils/irqtop.1.adoc:59
28214 #. type: Plain text
28215 #: ../sys-utils/irqtop.1.adoc:61
28216 msgid "stop updates and exit program"
28219 #. type: Plain text
28220 #: ../sys-utils/irqtop.1.adoc:67 ../sys-utils/lsirq.1.adoc:50
28222 "mailto:pizhenwei@bytedance.com[Zhenwei Pi], mailto:kerolasa@iki.fi[Sami "
28223 "Kerola], mailto:kzak@redhat.com[Karel Zak]"
28226 #. Copyright 2008 Tilman Schmidt (tilman@imap.cc)
28227 #. May be distributed under the GNU General Public License version 2 or later
28229 #: ../sys-utils/ldattach.8.adoc:6
28231 msgid "ldattach(8)"
28234 #. type: Plain text
28235 #: ../sys-utils/ldattach.8.adoc:16
28236 msgid "ldattach - attach a line discipline to a serial line"
28239 #. type: Plain text
28240 #: ../sys-utils/ldattach.8.adoc:20
28242 msgid "*ldattach* [*-1278denoVh*] [*-i* _iflag_] [*-s* _speed_] _ldisc device_\n"
28245 #. type: Plain text
28246 #: ../sys-utils/ldattach.8.adoc:24
28248 "The *ldattach* daemon opens the specified _device_ file (which should refer "
28249 "to a serial device) and attaches the line discipline _ldisc_ to it for "
28250 "processing of the sent and/or received data. It then goes into the "
28251 "background keeping the device open so that the line discipline stays loaded."
28254 #. type: Plain text
28255 #: ../sys-utils/ldattach.8.adoc:26
28257 "The line discipline _ldisc_ may be specified either by name or by number."
28260 #. type: Plain text
28261 #: ../sys-utils/ldattach.8.adoc:28
28263 "In order to detach the line discipline, *kill*(1) the *ldattach* process."
28266 #. type: Plain text
28267 #: ../sys-utils/ldattach.8.adoc:30
28268 msgid "With no arguments, *ldattach* prints usage information."
28272 #: ../sys-utils/ldattach.8.adoc:31
28274 msgid "LINE DISCIPLINES"
28277 #. type: Plain text
28278 #: ../sys-utils/ldattach.8.adoc:34
28280 "Depending on the kernel release, the following line disciplines are "
28284 #. type: Labeled list
28285 #: ../sys-utils/ldattach.8.adoc:35
28290 #. type: Plain text
28291 #: ../sys-utils/ldattach.8.adoc:37
28293 "The default line discipline, providing transparent operation (raw mode) as "
28294 "well as the habitual terminal line editing capabilities (cooked mode)."
28297 #. type: Labeled list
28298 #: ../sys-utils/ldattach.8.adoc:38
28300 msgid "*SLIP*(*1*)"
28303 #. type: Plain text
28304 #: ../sys-utils/ldattach.8.adoc:40
28306 "Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets "
28307 "over serial lines."
28310 #. type: Labeled list
28311 #: ../sys-utils/ldattach.8.adoc:41
28313 msgid "*MOUSE*(*2*)"
28316 #. type: Plain text
28317 #: ../sys-utils/ldattach.8.adoc:43
28318 msgid "Device driver for RS232 connected pointing devices (serial mice)."
28321 #. type: Labeled list
28322 #: ../sys-utils/ldattach.8.adoc:44
28327 #. type: Plain text
28328 #: ../sys-utils/ldattach.8.adoc:46
28330 "Point to Point Protocol (PPP) processor for transmitting network packets "
28331 "over serial lines."
28334 #. type: Labeled list
28335 #: ../sys-utils/ldattach.8.adoc:47
28337 msgid "*STRIP*(*4*); *AX25*(*5*); *X25*(*6*)"
28340 #. type: Plain text
28341 #: ../sys-utils/ldattach.8.adoc:49
28343 "Line driver for transmitting X.25 packets over asynchronous serial lines."
28346 #. type: Labeled list
28347 #: ../sys-utils/ldattach.8.adoc:50
28349 msgid "*6PACK*(*7*); *R3964*(*9*)"
28352 #. type: Plain text
28353 #: ../sys-utils/ldattach.8.adoc:52
28354 msgid "Driver for Simatic R3964 module."
28357 #. type: Labeled list
28358 #: ../sys-utils/ldattach.8.adoc:53
28360 msgid "*IRDA*(*11*)"
28363 #. type: Plain text
28364 #: ../sys-utils/ldattach.8.adoc:55
28366 "Linux IrDa (infrared data transmission) driver - see http://irda.sourceforge."
28370 #. type: Labeled list
28371 #: ../sys-utils/ldattach.8.adoc:56
28373 msgid "*HDLC*(*13*)"
28376 #. type: Plain text
28377 #: ../sys-utils/ldattach.8.adoc:58
28378 msgid "Synchronous HDLC driver."
28381 #. type: Labeled list
28382 #: ../sys-utils/ldattach.8.adoc:59
28384 msgid "*SYNC_PPP*(*14*)"
28387 #. type: Plain text
28388 #: ../sys-utils/ldattach.8.adoc:61
28389 msgid "Synchronous PPP driver."
28392 #. type: Labeled list
28393 #: ../sys-utils/ldattach.8.adoc:62
28395 msgid "*HCI*(*15*)"
28398 #. type: Plain text
28399 #: ../sys-utils/ldattach.8.adoc:64
28400 msgid "Bluetooth HCI UART driver."
28403 #. type: Labeled list
28404 #: ../sys-utils/ldattach.8.adoc:65
28406 msgid "*GIGASET_M101*(*16*)"
28409 #. type: Plain text
28410 #: ../sys-utils/ldattach.8.adoc:67
28411 msgid "Driver for Siemens Gigaset M101 serial DECT adapter."
28414 #. type: Labeled list
28415 #: ../sys-utils/ldattach.8.adoc:68
28417 msgid "*PPS*(*18*)"
28420 #. type: Plain text
28421 #: ../sys-utils/ldattach.8.adoc:70
28422 msgid "Driver for serial line Pulse Per Second (PPS) source."
28425 #. type: Labeled list
28426 #: ../sys-utils/ldattach.8.adoc:71
28428 msgid "*GSM0710*(*21*)"
28431 #. type: Plain text
28432 #: ../sys-utils/ldattach.8.adoc:73
28433 msgid "Driver for GSM 07.10 multiplexing protocol modem (CMUX)."
28436 #. type: Labeled list
28437 #: ../sys-utils/ldattach.8.adoc:76
28439 #| msgid "*-P*, *--pty*"
28440 msgid "*-1*, *--onestopbit*"
28441 msgstr "*-P*, *--pty*"
28443 #. type: Plain text
28444 #: ../sys-utils/ldattach.8.adoc:78
28445 msgid "Set the number of stop bits of the serial line to one."
28448 #. type: Labeled list
28449 #: ../sys-utils/ldattach.8.adoc:79
28451 #| msgid "*-P*, *--pty*"
28452 msgid "*-2*, *--twostopbits*"
28453 msgstr "*-P*, *--pty*"
28455 #. type: Plain text
28456 #: ../sys-utils/ldattach.8.adoc:81
28457 msgid "Set the number of stop bits of the serial line to two."
28460 #. type: Labeled list
28461 #: ../sys-utils/ldattach.8.adoc:82
28463 #| msgid "*-V*, *--version*"
28464 msgid "*-7*, *--sevenbits*"
28465 msgstr "*-V*, *--version*"
28467 #. type: Plain text
28468 #: ../sys-utils/ldattach.8.adoc:84
28469 msgid "Set the character size of the serial line to 7 bits."
28472 #. type: Labeled list
28473 #: ../sys-utils/ldattach.8.adoc:85
28475 #| msgid "*-P*, *--pty*"
28476 msgid "*-8*, *--eightbits*"
28477 msgstr "*-P*, *--pty*"
28479 #. type: Plain text
28480 #: ../sys-utils/ldattach.8.adoc:87
28481 msgid "Set the character size of the serial line to 8 bits."
28484 #. type: Plain text
28485 #: ../sys-utils/ldattach.8.adoc:90
28487 "Keep *ldattach* in the foreground so that it can be interrupted or debugged, "
28488 "and to print verbose messages about its progress to standard error output."
28491 #. type: Labeled list
28492 #: ../sys-utils/ldattach.8.adoc:91
28494 #| msgid "*-P*, *--pty*"
28495 msgid "*-e*, *--evenparity*"
28496 msgstr "*-P*, *--pty*"
28498 #. type: Plain text
28499 #: ../sys-utils/ldattach.8.adoc:93
28500 msgid "Set the parity of the serial line to even."
28503 #. type: Labeled list
28504 #: ../sys-utils/ldattach.8.adoc:94
28506 msgid "*-i*, *--iflag* [*-*]_value_..."
28509 #. type: Plain text
28510 #: ../sys-utils/ldattach.8.adoc:96
28512 "Set the specified bits in the c_iflag word of the serial line. The given "
28513 "_value_ may be a number or a symbolic name. If _value_ is prefixed by a "
28514 "minus sign, the specified bits are cleared instead. Several comma-separated "
28515 "values may be given in order to set and clear multiple bits."
28518 #. type: Labeled list
28519 #: ../sys-utils/ldattach.8.adoc:97
28521 #| msgid "*-P*, *--pty*"
28522 msgid "*-n*, *--noparity*"
28523 msgstr "*-P*, *--pty*"
28525 #. type: Plain text
28526 #: ../sys-utils/ldattach.8.adoc:99
28527 msgid "Set the parity of the serial line to none."
28530 #. type: Labeled list
28531 #: ../sys-utils/ldattach.8.adoc:100
28533 #| msgid "*-P*, *--pty*"
28534 msgid "*-o*, *--oddparity*"
28535 msgstr "*-P*, *--pty*"
28537 #. type: Plain text
28538 #: ../sys-utils/ldattach.8.adoc:102
28539 msgid "Set the parity of the serial line to odd."
28542 #. type: Labeled list
28543 #: ../sys-utils/ldattach.8.adoc:103
28545 #| msgid "*-s*, **--shell**=__shell__"
28546 msgid "*-s*, *--speed* _value_"
28547 msgstr "*-s*, **--shell**=__shell__"
28549 #. type: Plain text
28550 #: ../sys-utils/ldattach.8.adoc:105
28552 "Set the speed (the baud rate) of the serial line to the specified _value_."
28555 #. type: Labeled list
28556 #: ../sys-utils/ldattach.8.adoc:106
28558 #| msgid "*-c*, **--command**=__command__"
28559 msgid "*-c*, *--intro-command* _string_"
28560 msgstr "*-c*, **--command**=__příkaz__"
28562 #. type: Plain text
28563 #: ../sys-utils/ldattach.8.adoc:108
28565 "Define an intro command that is sent through the serial line before the "
28566 "invocation of *ldattach*. E.g. in conjunction with line discipline GSM0710, "
28567 "the command 'AT+CMUX=0\\r' is commonly suitable to switch the modem into the "
28571 #. type: Labeled list
28572 #: ../sys-utils/ldattach.8.adoc:109
28574 msgid "*-p*, *--pause* _value_"
28577 #. type: Plain text
28578 #: ../sys-utils/ldattach.8.adoc:111
28580 "Sleep for _value_ seconds before the invocation of *ldattach*. Default is "
28584 #. type: Plain text
28585 #: ../sys-utils/ldattach.8.adoc:117
28586 msgid "mailto:tilman@imap.cc[Tilman Schmidt]"
28589 #. type: Plain text
28590 #: ../sys-utils/ldattach.8.adoc:122
28593 "*inputattach*(1),\n"
28598 #: ../sys-utils/losetup.8.adoc:2
28603 #. type: Plain text
28604 #: ../sys-utils/losetup.8.adoc:12
28605 msgid "losetup - set up and control loop devices"
28608 #. type: Plain text
28609 #: ../sys-utils/losetup.8.adoc:16
28613 #. type: Plain text
28614 #: ../sys-utils/losetup.8.adoc:18
28616 msgid "*losetup* [_loopdev_]\n"
28619 #. type: Plain text
28620 #: ../sys-utils/losetup.8.adoc:20
28622 msgid "*losetup* *-l* [*-a*]\n"
28625 #. type: Plain text
28626 #: ../sys-utils/losetup.8.adoc:22
28628 msgid "*losetup* *-j* _file_ [*-o* _offset_]\n"
28631 #. type: Plain text
28632 #: ../sys-utils/losetup.8.adoc:24
28633 msgid "Detach a loop device:"
28636 #. type: Plain text
28637 #: ../sys-utils/losetup.8.adoc:26
28639 msgid "*losetup* *-d* _loopdev_ ...\n"
28642 #. type: Plain text
28643 #: ../sys-utils/losetup.8.adoc:28
28644 msgid "Detach all associated loop devices:"
28647 #. type: Plain text
28648 #: ../sys-utils/losetup.8.adoc:30
28650 msgid "*losetup* *-D*\n"
28653 #. type: Plain text
28654 #: ../sys-utils/losetup.8.adoc:32
28655 msgid "Set up a loop device:"
28658 #. type: Plain text
28659 #: ../sys-utils/losetup.8.adoc:34
28661 msgid "*losetup* [*-o* _offset_] [*--sizelimit* _size_] [*--sector-size* _size_] [*--loop-ref* _name_] [*-Pr*] [*--show*] *-f*|_loopdev file_\n"
28664 #. type: Plain text
28665 #: ../sys-utils/losetup.8.adoc:36
28666 msgid "Resize a loop device:"
28669 #. type: Plain text
28670 #: ../sys-utils/losetup.8.adoc:38
28672 msgid "*losetup* *-c* _loopdev_\n"
28675 #. type: Plain text
28676 #: ../sys-utils/losetup.8.adoc:42
28678 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"
28681 #. type: Plain text
28682 #: ../sys-utils/losetup.8.adoc:44
28684 "Note that the old output format (i.e., *losetup -a*) with comma-delimited "
28685 "strings is deprecated in favour of the *--list* output format."
28688 #. type: Plain text
28689 #: ../sys-utils/losetup.8.adoc:46
28691 "It's possible to create more independent loop devices for the same backing "
28692 "file. *This setup may be dangerous, can cause data loss, corruption and "
28693 "overwrites.* Use *--nooverlap* with *--find* during setup to avoid this "
28697 #. type: Plain text
28698 #: ../sys-utils/losetup.8.adoc:48
28700 "The loop device setup is not an atomic operation when used with *--find*, "
28701 "and *losetup* does not protect this operation by any lock. The number of "
28702 "attempts is internally restricted to a maximum of 16. It is recommended to "
28703 "use for example *flock*(1) to avoid a collision in heavily parallel use "
28707 #. type: Plain text
28708 #: ../sys-utils/losetup.8.adoc:52
28710 "The _size_ and _offset_ arguments may be followed by the multiplicative "
28711 "suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
28712 "ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
28713 "\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
28714 "PB, EB, ZB and YB."
28717 #. type: Plain text
28718 #: ../sys-utils/losetup.8.adoc:55
28720 "Show the status of all loop devices. Note that not all information is "
28721 "accessible for non-root users. See also *--list*. The old output format (as "
28722 "printed without *--list*) is deprecated."
28725 #. type: Labeled list
28726 #: ../sys-utils/losetup.8.adoc:56
28728 msgid "*-d*, *--detach* _loopdev_..."
28731 #. type: Plain text
28732 #: ../sys-utils/losetup.8.adoc:58
28734 "Detach the file or device associated with the specified loop device(s). Note "
28735 "that since Linux v3.7 kernel uses \"lazy device destruction\". The detach "
28736 "operation does not return *EBUSY* error anymore if device is actively used "
28737 "by system, but it is marked by autoclear flag and destroyed later."
28740 #. type: Labeled list
28741 #: ../sys-utils/losetup.8.adoc:59
28743 #| msgid "*-h*, *--help*"
28744 msgid "*-D*, *--detach-all*"
28745 msgstr "*-h*, *--help*"
28747 #. type: Plain text
28748 #: ../sys-utils/losetup.8.adoc:61
28749 msgid "Detach all associated loop devices."
28752 #. type: Labeled list
28753 #: ../sys-utils/losetup.8.adoc:62
28755 msgid "*-f*, *--find* [_file_]"
28758 #. type: Plain text
28759 #: ../sys-utils/losetup.8.adoc:64
28761 "Find the first unused loop device. If a _file_ argument is present, use the "
28762 "found device as loop device. Otherwise, just print its name."
28765 #. type: Labeled list
28766 #: ../sys-utils/losetup.8.adoc:65
28771 #. type: Plain text
28772 #: ../sys-utils/losetup.8.adoc:67
28774 "Display the name of the assigned loop device if the *-f* option and a _file_ "
28775 "argument are present."
28778 #. type: Labeled list
28779 #: ../sys-utils/losetup.8.adoc:68
28781 #| msgid "*-h*, *--help*"
28782 msgid "*-L*, *--nooverlap*"
28783 msgstr "*-h*, *--help*"
28785 #. type: Plain text
28786 #: ../sys-utils/losetup.8.adoc:70
28788 "Check for conflicts between loop devices to avoid situation when the same "
28789 "backing file is shared between more loop devices. If the file is already "
28790 "used by another device then re-use the device rather than a new one. The "
28791 "option makes sense only with *--find*."
28794 #. type: Labeled list
28795 #: ../sys-utils/losetup.8.adoc:71
28797 msgid "*-j*, *--associated* _file_ [*-o* _offset_]"
28800 #. type: Plain text
28801 #: ../sys-utils/losetup.8.adoc:73
28802 msgid "Show the status of all loop devices associated with the given _file_."
28805 #. type: Plain text
28806 #: ../sys-utils/losetup.8.adoc:76
28808 "The data start is moved _offset_ bytes into the specified file or device. "
28809 "The _offset_ may be followed by the multiplicative suffixes; see above."
28812 #. type: Labeled list
28813 #: ../sys-utils/losetup.8.adoc:77
28815 msgid "*--loop-ref* _string_"
28818 #. type: Plain text
28819 #: ../sys-utils/losetup.8.adoc:79
28821 "Set reference string. The backwardly compatible default is to use the "
28822 "backing filename as a reference in loop setup ioctl (aka lo_file_name). This "
28823 "option can overwrite this default behavior and set the reference to the "
28824 "_string_. The reference may be used by udevd in /dev/loop/by-ref. Linux "
28825 "kernel does not use the reference at all, but it could be used by some old "
28826 "utils that cannot read the backing file from sysfs. The reference is "
28827 "readable only for the root user (see *--output* +REF) and it is restricted "
28831 #. type: Labeled list
28832 #: ../sys-utils/losetup.8.adoc:80
28834 msgid "*--sizelimit* _size_"
28837 #. type: Plain text
28838 #: ../sys-utils/losetup.8.adoc:82
28840 "The data end is set to no more than _size_ bytes after the data start. The "
28841 "_size_ may be followed by the multiplicative suffixes; see above."
28844 #. type: Labeled list
28845 #: ../sys-utils/losetup.8.adoc:83
28847 msgid "*-b*, *--sector-size* _size_"
28850 #. type: Plain text
28851 #: ../sys-utils/losetup.8.adoc:85
28853 "Set the logical sector size of the loop device in bytes (since Linux 4.14). "
28854 "The option may be used when creating a new loop device as well as a stand-"
28855 "alone command to modify sector size of the already existing loop device."
28858 #. type: Labeled list
28859 #: ../sys-utils/losetup.8.adoc:86
28861 msgid "*-c*, *--set-capacity* _loopdev_"
28864 #. type: Plain text
28865 #: ../sys-utils/losetup.8.adoc:88
28867 "Force the loop driver to reread the size of the file associated with the "
28868 "specified loop device."
28871 #. type: Labeled list
28872 #: ../sys-utils/losetup.8.adoc:89
28874 #| msgid "*-P*, *--pty*"
28875 msgid "*-P*, *--partscan*"
28876 msgstr "*-P*, *--pty*"
28878 #. type: Plain text
28879 #: ../sys-utils/losetup.8.adoc:91
28881 "Force the kernel to scan the partition table on a newly created loop device. "
28882 "Note that the partition table parsing depends on sector sizes. The default "
28883 "is sector size is 512 bytes, otherwise you need to use the option *--sector-"
28884 "size* together with *--partscan*."
28887 #. type: Plain text
28888 #: ../sys-utils/losetup.8.adoc:94
28889 msgid "Set up a read-only loop device."
28892 #. type: Labeled list
28893 #: ../sys-utils/losetup.8.adoc:95
28895 msgid "*--direct-io*[**=on**|*off*]"
28898 #. type: Plain text
28899 #: ../sys-utils/losetup.8.adoc:97
28901 "Enable or disable direct I/O for the backing file. The optional argument can "
28902 "be either *on* or *off*. If the optional argument is omitted, it defaults to "
28906 #. type: Plain text
28907 #: ../sys-utils/losetup.8.adoc:103
28909 "If a loop device or the *-a* option is specified, print the default columns "
28910 "for either the specified loop device or all loop devices; the default is to "
28911 "print info about all devices. See also *--output*, *--noheadings*, *--raw*, "
28915 #. type: Labeled list
28916 #: ../sys-utils/losetup.8.adoc:104
28918 msgid "*-O*, *--output* _column_[,_column_]..."
28921 #. type: Plain text
28922 #: ../sys-utils/losetup.8.adoc:106
28924 "Specify the columns that are to be printed for the *--list* output. Use *--"
28925 "help* to get a list of all supported columns."
28928 #. type: Plain text
28929 #: ../sys-utils/losetup.8.adoc:112
28930 msgid "Don't print headings for *--list* output format."
28933 #. type: Labeled list
28934 #: ../sys-utils/losetup.8.adoc:113 ../sys-utils/prlimit.1.adoc:52
28935 #: ../sys-utils/swapon.8.adoc:80 ../sys-utils/zramctl.8.adoc:58
28940 #. type: Plain text
28941 #: ../sys-utils/losetup.8.adoc:115
28942 msgid "Use the raw *--list* output format."
28945 #. type: Plain text
28946 #: ../sys-utils/losetup.8.adoc:118
28947 msgid "Use JSON format for *--list* output."
28951 #: ../sys-utils/losetup.8.adoc:119
28953 #| msgid "DESCRIPTION"
28957 #. type: Plain text
28958 #: ../sys-utils/losetup.8.adoc:122
28960 msgid "*Cryptoloop is no longer supported in favor of dm-crypt.* For more details see *cryptsetup*(8).\n"
28963 #. type: Plain text
28964 #: ../sys-utils/losetup.8.adoc:126
28966 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"
28969 #. type: Plain text
28970 #: ../sys-utils/losetup.8.adoc:130
28972 "Since version 2.37 *losetup* uses *LOOP_CONFIGURE* ioctl to setup a new loop "
28973 "device by one ioctl call. The old versions use *LOOP_SET_FD* and "
28974 "*LOOP_SET_STATUS64* ioctls to do the same."
28977 #. type: Labeled list
28978 #: ../sys-utils/losetup.8.adoc:133 ../sys-utils/mount.8.adoc:1641
28980 msgid "*LOOPDEV_DEBUG*=all"
28983 #. type: Labeled list
28984 #: ../sys-utils/losetup.8.adoc:138
28986 msgid "_/dev/loop[0..N]_"
28989 #. type: Plain text
28990 #: ../sys-utils/losetup.8.adoc:140
28991 msgid "loop block devices"
28994 #. type: Labeled list
28995 #: ../sys-utils/losetup.8.adoc:141
28997 msgid "_/dev/loop-control_"
29000 #. type: Plain text
29001 #: ../sys-utils/losetup.8.adoc:143
29002 msgid "loop control device"
29005 #. type: Plain text
29006 #: ../sys-utils/losetup.8.adoc:147
29008 "The following commands can be used as an example of using the loop device."
29011 #. type: Plain text
29012 #: ../sys-utils/losetup.8.adoc:156
29015 " # dd if=/dev/zero of=~/file.img bs=1024k count=10\n"
29016 " # losetup --find --show ~/file.img\n"
29018 " # mkfs -t ext2 /dev/loop0\n"
29019 " # mount /dev/loop0 /mnt\n"
29021 " # umount /dev/loop0\n"
29022 " # losetup --detach /dev/loop0\n"
29025 #. type: Plain text
29026 #: ../sys-utils/losetup.8.adoc:160
29028 "mailto:kzak@redhat.com[Karel Zak], based on the original version from mailto:"
29029 "tytso@athena.mit.edu[Theodore Ts'o]."
29033 #: ../sys-utils/lscpu.1.adoc:2
29039 #. type: Plain text
29040 #: ../sys-utils/lscpu.1.adoc:12
29042 #| msgid "fstab - static information about the filesystems"
29043 msgid "lscpu - display information about the CPU architecture"
29044 msgstr "fstab - statická informace o souborových systémech"
29046 #. type: Plain text
29047 #: ../sys-utils/lscpu.1.adoc:16
29049 msgid "*lscpu* [options]\n"
29052 #. type: Plain text
29053 #: ../sys-utils/lscpu.1.adoc:20
29055 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"
29058 #. type: Plain text
29059 #: ../sys-utils/lscpu.1.adoc:22
29061 "The default output formatting on terminal is subject to change and maybe "
29062 "optimized for better readability. The output for non-terminals (e.g., pipes) "
29063 "is never affected by this optimization and it is always in \"Field: "
29064 "data\\n\" format. Use for example \"*lscpu | less*\" to see the default "
29065 "output without optimizations."
29068 #. type: Plain text
29069 #: ../sys-utils/lscpu.1.adoc:24
29071 "In virtualized environments, the CPU architecture information displayed "
29072 "reflects the configuration of the guest operating system which is typically "
29073 "different from the physical (host) system. On architectures that support "
29074 "retrieving physical topology information, *lscpu* also displays the number "
29075 "of physical sockets, chips, cores in the host system."
29078 #. type: Plain text
29079 #: ../sys-utils/lscpu.1.adoc:26
29081 "Options that result in an output table have a _list_ argument. Use this "
29082 "argument to customize the command output. Specify a comma-separated list of "
29083 "column labels to limit the output table to only the specified columns, "
29084 "arranged in the specified order. See *COLUMNS* for a list of valid column "
29085 "labels. The column labels are not case sensitive."
29088 #. type: Plain text
29089 #: ../sys-utils/lscpu.1.adoc:28
29091 "Not all columns are supported on all architectures. If an unsupported column "
29092 "is specified, *lscpu* prints the column but does not provide any data for it."
29095 #. type: Plain text
29096 #: ../sys-utils/lscpu.1.adoc:30
29098 "The cache sizes are reported as summary from all CPUs. The versions before "
29099 "v2.34 reported per-core sizes, but this output was confusing due to "
29100 "complicated CPUs topology and the way how caches are shared between CPUs. "
29101 "For more details about caches see *--cache*. Since version v2.37 *lscpu* "
29102 "follows cache IDs as provided by Linux kernel and it does not always start "
29106 #. type: Plain text
29107 #: ../sys-utils/lscpu.1.adoc:35
29109 "Include lines for online and offline CPUs in the output (default for *-e*). "
29110 "This option may only be specified together with option *-e* or *-p*."
29113 #. type: Labeled list
29114 #: ../sys-utils/lscpu.1.adoc:36
29116 #| msgid "*-P*, *--pty*"
29117 msgid "*-B*, *--bytes*"
29118 msgstr "*-P*, *--pty*"
29120 #. type: Labeled list
29121 #: ../sys-utils/lscpu.1.adoc:39
29123 #| msgid "*-h*, *--help*"
29124 msgid "*-b*, *--online*"
29125 msgstr "*-h*, *--help*"
29127 #. type: Plain text
29128 #: ../sys-utils/lscpu.1.adoc:41
29130 "Limit the output to online CPUs (default for *-p*). This option may only be "
29131 "specified together with option *-e* or *-p*."
29134 #. type: Labeled list
29135 #: ../sys-utils/lscpu.1.adoc:42
29137 msgid "*-C*, *--caches*[=_list_]"
29140 #. type: Plain text
29141 #: ../sys-utils/lscpu.1.adoc:44
29143 "Display details about CPU caches. For details about available information "
29144 "see *--help* output."
29147 #. type: Plain text
29148 #: ../sys-utils/lscpu.1.adoc:46
29150 "If the _list_ argument is omitted, all columns for which data is available "
29151 "are included in the command output."
29154 #. type: Plain text
29155 #: ../sys-utils/lscpu.1.adoc:48
29157 "When specifying the _list_ argument, the string of option, equal sign (=), "
29158 "and _list_ must not contain any blanks or other whitespace. Examples: *-"
29159 "C=NAME,ONE-SIZE* or *--caches=NAME,ONE-SIZE*."
29162 #. type: Plain text
29163 #: ../sys-utils/lscpu.1.adoc:50
29165 "The default list of columns may be extended if list is specified in the "
29166 "format +list (e.g., **lscpu -C=+ALLOC-POLICY**)."
29169 #. type: Labeled list
29170 #: ../sys-utils/lscpu.1.adoc:51
29172 #| msgid "*-*, *-l*, *--login*"
29173 msgid "*-c*, *--offline*"
29174 msgstr "*-*, *-l*, *--login*"
29176 #. type: Plain text
29177 #: ../sys-utils/lscpu.1.adoc:53
29179 "Limit the output to offline CPUs. This option may only be specified together "
29180 "with option *-e* or *-p*."
29183 #. type: Labeled list
29184 #: ../sys-utils/lscpu.1.adoc:54
29186 msgid "*--hierarchic*[=_when_]"
29189 #. type: Plain text
29190 #: ../sys-utils/lscpu.1.adoc:56
29192 "Use subsections in summary output. For backward compatibility, the default "
29193 "is to use subsections only when output on a terminal and flattened output on "
29194 "a non-terminal. The optional argument _when_ can be *never*, *always* or "
29195 "*auto*. If the _when_ argument is omitted, it defaults to \"always\"."
29198 #. type: Labeled list
29199 #: ../sys-utils/lscpu.1.adoc:57
29201 #| msgid "*-w*, **--whitelist-environment**=__list__"
29202 msgid "*-e*, *--extended*[=_list_]"
29203 msgstr "*-w*, **--whitelist-environment**=__seznam__"
29205 #. type: Plain text
29206 #: ../sys-utils/lscpu.1.adoc:59
29208 #| msgid "Print the sizes in bytes rather than in a human-readable format."
29209 msgid "Display the CPU information in human-readable format."
29210 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
29212 #. type: Plain text
29213 #: ../sys-utils/lscpu.1.adoc:61
29215 "If the _list_ argument is omitted, the default columns are included in the "
29216 "command output. The default output is subject to change."
29219 #. type: Plain text
29220 #: ../sys-utils/lscpu.1.adoc:63
29222 "When specifying the _list_ argument, the string of option, equal sign (=), "
29223 "and _list_ must not contain any blanks or other whitespace. Examples: '*-"
29224 "e=cpu,node*' or '*--extended=cpu,node*'."
29227 #. type: Plain text
29228 #: ../sys-utils/lscpu.1.adoc:65
29230 "The default list of columns may be extended if list is specified in the "
29231 "format +list (e.g., lscpu -e=+MHZ)."
29234 #. type: Plain text
29235 #: ../sys-utils/lscpu.1.adoc:71
29237 "Use JSON output format for the default summary or extended output (see *--"
29238 "extended*). For backward compatibility, JSON output follows the default "
29239 "summary behavior for non-terminals (e.g., pipes) where subsections are "
29240 "missing. See also *--hierarchic*."
29243 #. type: Labeled list
29244 #: ../sys-utils/lscpu.1.adoc:72
29246 msgid "*-p*, *--parse*[=_list_]"
29249 #. type: Plain text
29250 #: ../sys-utils/lscpu.1.adoc:74
29251 msgid "Optimize the command output for easy parsing."
29254 #. type: Plain text
29255 #: ../sys-utils/lscpu.1.adoc:76
29257 "If the _list_ argument is omitted, the command output is compatible with "
29258 "earlier versions of *lscpu*. In this compatible format, two commas are used "
29259 "to separate CPU cache columns. If no CPU caches are identified the cache "
29260 "column is omitted. If the _list_ argument is used, cache columns are "
29261 "separated with a colon (:)."
29264 #. type: Plain text
29265 #: ../sys-utils/lscpu.1.adoc:78
29267 "When specifying the _list_ argument, the string of option, equal sign (=), "
29268 "and _list_ must not contain any blanks or other whitespace. Examples: '*-"
29269 "p=cpu,node*' or '*--parse=cpu,node*'."
29272 #. type: Plain text
29273 #: ../sys-utils/lscpu.1.adoc:80
29275 "The default list of columns may be extended if list is specified in the "
29276 "format +list (e.g., lscpu -p=+MHZ)."
29279 #. type: Labeled list
29280 #: ../sys-utils/lscpu.1.adoc:81 ../sys-utils/lsmem.1.adoc:60
29282 msgid "*-s*, *--sysroot* _directory_"
29285 #. type: Plain text
29286 #: ../sys-utils/lscpu.1.adoc:83
29288 "Gather CPU data for a Linux instance other than the instance from which the "
29289 "*lscpu* command is issued. The specified _directory_ is the system root of "
29290 "the Linux instance to be inspected."
29293 #. type: Plain text
29294 #: ../sys-utils/lscpu.1.adoc:86
29296 "Use hexadecimal masks for CPU sets (for example \"ff\"). The default is to "
29297 "print the sets in list format (for example 0,1). Note that before version "
29298 "2.30 the mask has been printed with 0x prefix."
29301 #. type: Labeled list
29302 #: ../sys-utils/lscpu.1.adoc:87
29304 #| msgid "*-P*, *--pty*"
29305 msgid "*-y*, *--physical*"
29306 msgstr "*-P*, *--pty*"
29308 #. type: Plain text
29309 #: ../sys-utils/lscpu.1.adoc:89
29311 "Display physical IDs for all columns with topology elements (core, socket, "
29312 "etc.). Other than logical IDs, which are assigned by *lscpu*, physical IDs "
29313 "are platform-specific values that are provided by the kernel. Physical IDs "
29314 "are not necessarily unique and they might not be arranged sequentially. If "
29315 "the kernel could not retrieve a physical ID for an element *lscpu* prints "
29316 "the dash (-) character."
29319 #. type: Plain text
29320 #: ../sys-utils/lscpu.1.adoc:91
29321 msgid "The CPU logical numbers are not affected by this option."
29324 #. type: Plain text
29325 #: ../sys-utils/lscpu.1.adoc:94
29327 "Output all available columns. This option must be combined with either *--"
29328 "extended*, *--parse* or *--caches*."
29331 #. type: Plain text
29332 #: ../sys-utils/lscpu.1.adoc:98
29334 "The basic overview of CPU family, model, etc. is always based on the first "
29338 #. type: Plain text
29339 #: ../sys-utils/lscpu.1.adoc:100
29340 msgid "Sometimes in Xen Dom0 the kernel reports wrong data."
29343 #. type: Plain text
29344 #: ../sys-utils/lscpu.1.adoc:102
29345 msgid "On virtual hardware the number of cores per socket, etc. can be wrong."
29348 #. type: Plain text
29349 #: ../sys-utils/lscpu.1.adoc:108
29351 "mailto:qcai@redhat.com[Cai Qian], mailto:kzak@redhat.com[Karel Zak], mailto:"
29352 "heiko.carstens@de.ibm.com[Heiko Carstens]"
29355 #. type: Plain text
29356 #: ../sys-utils/lscpu.1.adoc:112
29358 msgid "*chcpu*(8)\n"
29362 #: ../sys-utils/lsipc.1.adoc:2
29367 #. type: Plain text
29368 #: ../sys-utils/lsipc.1.adoc:12
29370 "lsipc - show information on IPC facilities currently employed in the system"
29373 #. type: Plain text
29374 #: ../sys-utils/lsipc.1.adoc:16
29376 msgid "*lsipc* [options]\n"
29379 #. type: Plain text
29380 #: ../sys-utils/lsipc.1.adoc:20
29382 msgid "*lsipc* shows information on the System V inter-process communication facilities for which the calling process has read access.\n"
29385 #. type: Plain text
29386 #: ../sys-utils/lsipc.1.adoc:25
29388 "Show full details on just the one resource element identified by _id_. This "
29389 "option needs to be combined with one of the three resource options: *-m*, *-"
29390 "q* or *-s*. It is possible to override the default output format for this "
29391 "option with the *--list*, *--raw*, *--json* or *--export* option."
29394 #. type: Labeled list
29395 #: ../sys-utils/lsipc.1.adoc:26
29397 #| msgid "*-h*, *--help*"
29398 msgid "*-g*, *--global*"
29399 msgstr "*-h*, *--help*"
29401 #. type: Plain text
29402 #: ../sys-utils/lsipc.1.adoc:28
29404 "Show system-wide usage and limits of IPC resources. This option may be "
29405 "combined with one of the three resource options: *-m*, *-q* or *-s*. The "
29406 "default is to show information about all resources."
29410 #: ../sys-utils/lsipc.1.adoc:42
29412 msgid "Output formatting"
29415 #. type: Plain text
29416 #: ../sys-utils/lsipc.1.adoc:52
29417 msgid "Use the JSON output format."
29420 #. type: Plain text
29421 #: ../sys-utils/lsipc.1.adoc:55
29423 "Use the list output format. This is the default, except when *--id* is used."
29426 #. type: Plain text
29427 #: ../sys-utils/lsipc.1.adoc:70
29429 #| msgid "Print the sizes in bytes rather than in a human-readable format."
29430 msgid "Print size in bytes rather than in human readable format."
29431 msgstr "Zobrazí velikosti v bajtech namísto v podobě srozumitelnější lidem."
29433 #. type: Labeled list
29434 #: ../sys-utils/lsipc.1.adoc:80
29436 #| msgid "*-P*, *--pty*"
29437 msgid "*-P*, *--numeric-perms*"
29438 msgstr "*-P*, *--pty*"
29440 #. type: Plain text
29441 #: ../sys-utils/lsipc.1.adoc:82
29442 msgid "Print numeric permissions in PERMS column."
29445 #. type: Plain text
29446 #: ../sys-utils/lsipc.1.adoc:96
29447 msgid "if a serious error occurs."
29450 #. type: Plain text
29451 #: ../sys-utils/lsipc.1.adoc:100
29452 msgid "The *lsipc* utility is inspired by the *ipcs*(1) utility."
29456 #: ../sys-utils/lsirq.1.adoc:2
29461 #. type: Plain text
29462 #: ../sys-utils/lsirq.1.adoc:12
29463 msgid "lsirq - utility to display kernel interrupt information"
29466 #. type: Plain text
29467 #: ../sys-utils/lsirq.1.adoc:16
29469 msgid "*lsirq* [options]\n"
29472 #. type: Plain text
29473 #: ../sys-utils/lsirq.1.adoc:20
29474 msgid "Display kernel interrupt counter information."
29477 #. type: Plain text
29478 #: ../sys-utils/lsirq.1.adoc:33
29480 "Specify sort criteria by column name. See *--help* output to get column "
29484 #. type: Plain text
29485 #: ../sys-utils/lsirq.1.adoc:39
29487 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
29488 "characters are hex-escaped (\\x<code>)."
29492 #: ../sys-utils/lsmem.1.adoc:2
29497 #. type: Plain text
29498 #: ../sys-utils/lsmem.1.adoc:12
29499 msgid "lsmem - list the ranges of available memory with their online status"
29502 #. type: Plain text
29503 #: ../sys-utils/lsmem.1.adoc:16
29505 msgid "*lsmem* [options]\n"
29508 #. type: Plain text
29509 #: ../sys-utils/lsmem.1.adoc:20
29511 "The *lsmem* command lists the ranges of available memory with their online "
29512 "status. The listed memory blocks correspond to the memory block "
29513 "representation in sysfs. The command also shows the memory block size and "
29514 "the amount of memory in online and offline state."
29517 #. type: Plain text
29518 #: ../sys-utils/lsmem.1.adoc:22
29520 "The default output is compatible with original implementation from s390-"
29521 "tools, but it's strongly recommended to avoid using default outputs in your "
29522 "scripts. Always explicitly define expected columns by using the *--output* "
29523 "option together with a columns list in environments where a stable output is "
29527 #. type: Plain text
29528 #: ../sys-utils/lsmem.1.adoc:24
29530 "The *lsmem* command lists a new memory range always when the current memory "
29531 "block distinguish from the previous block by some output column. This "
29532 "default behavior is possible to override by the *--split* option (e.g., "
29533 "*lsmem --split=ZONES*). The special word \"none\" may be used to ignore all "
29534 "differences between memory blocks and to create as large as possible "
29535 "continuous ranges. The opposite semantic is *--all* to list individual "
29539 #. type: Plain text
29540 #: ../sys-utils/lsmem.1.adoc:26
29542 "Note that some output columns may provide inaccurate information if a split "
29543 "policy forces *lsmem* to ignore differences in some attributes. For example "
29544 "if you merge removable and non-removable memory blocks to the one range than "
29545 "all the range will be marked as non-removable on *lsmem* output."
29548 #. type: Plain text
29549 #: ../sys-utils/lsmem.1.adoc:28
29551 "Not all columns are supported on all systems. If an unsupported column is "
29552 "specified, *lsmem* prints the column but does not provide any data for it."
29555 #. type: Plain text
29556 #: ../sys-utils/lsmem.1.adoc:30
29557 msgid "Use the *--help* option to see the columns description."
29560 #. type: Plain text
29561 #: ../sys-utils/lsmem.1.adoc:35
29563 "List each individual memory block, instead of combining memory blocks with "
29564 "similar attributes."
29567 #. type: Plain text
29568 #: ../sys-utils/lsmem.1.adoc:47
29570 "Specify which output columns to print. Use *--help* to get a list of all "
29571 "supported columns. The default list of columns may be extended if _list_ is "
29572 "specified in the format **+**__list__ (e.g., *lsmem -o +NODE*)."
29575 #. type: Plain text
29576 #: ../sys-utils/lsmem.1.adoc:53
29578 "Produce output in the form of key=\"value\" pairs. All potentially unsafe "
29579 "value characters are hex-escaped (\\x<code>)."
29582 #. type: Labeled list
29583 #: ../sys-utils/lsmem.1.adoc:57
29585 #| msgid "*-P*, *--pty*"
29586 msgid "*-S*, *--split* _list_"
29587 msgstr "*-P*, *--pty*"
29589 #. type: Plain text
29590 #: ../sys-utils/lsmem.1.adoc:59
29592 "Specify which columns (attributes) use to split memory blocks to ranges. The "
29593 "supported columns are STATE, REMOVABLE, NODE and ZONES, or \"none\". The "
29594 "other columns are silently ignored. For more details see *DESCRIPTION* above."
29597 #. type: Plain text
29598 #: ../sys-utils/lsmem.1.adoc:62
29600 "Gather memory data for a Linux instance other than the instance from which "
29601 "the *lsmem* command is issued. The specified _directory_ is the system root "
29602 "of the Linux instance to be inspected."
29605 #. type: Plain text
29606 #: ../sys-utils/lsmem.1.adoc:67
29608 "This option controls summary lines output. The optional argument _when_ can "
29609 "be *never*, *always* or *only*. If the _when_ argument is omitted, it "
29610 "defaults to *\"only\"*. The summary output is suppressed for *--raw*, *--"
29611 "pairs* and *--json*."
29614 #. type: Plain text
29615 #: ../sys-utils/lsmem.1.adoc:71
29617 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"
29620 #. type: Plain text
29621 #: ../sys-utils/lsmem.1.adoc:75
29623 msgid "*chmem*(8)\n"
29626 #. Man page for the lsns command.
29627 #. Copyright 2015 Karel Zak <kzak@redhat.com>
29628 #. May be distributed under the GNU General Public License
29630 #: ../sys-utils/lsns.8.adoc:7
29635 #. type: Plain text
29636 #: ../sys-utils/lsns.8.adoc:17
29637 msgid "lsns - list namespaces"
29640 #. type: Plain text
29641 #: ../sys-utils/lsns.8.adoc:21
29643 msgid "*lsns* [options] _namespace_\n"
29646 #. type: Plain text
29647 #: ../sys-utils/lsns.8.adoc:25
29649 msgid "*lsns* lists information about all the currently accessible namespaces or about the given _namespace_. The _namespace_ identifier is an inode number.\n"
29652 #. type: Plain text
29653 #: ../sys-utils/lsns.8.adoc:27
29655 "The default output is subject to change. So whenever possible, you should "
29656 "avoid using default outputs in your scripts. Always explicitly define "
29657 "expected output mode (*--tree* or *--list*) and columns by using the *--"
29658 "output* option together with a columns list in environments where a stable "
29659 "output is required."
29662 #. type: Plain text
29663 #: ../sys-utils/lsns.8.adoc:29
29665 "The *NSFS* column, printed when *net* is specified for the *--type* option, "
29666 "is special; it uses multi-line cells. Use the option *--nowrap* to switch to "
29667 "\",\"-separated single-line representation."
29670 #. type: Plain text
29671 #: ../sys-utils/lsns.8.adoc:31
29673 "Note that *lsns* reads information directly from the _/proc_ filesystem and "
29674 "for non-root users it may return incomplete information. The current _/proc_ "
29675 "filesystem may be unshared and affected by a PID namespace (see *unshare --"
29676 "mount-proc* for more details). *lsns* is not able to see persistent "
29677 "namespaces without processes where the namespace instance is held by a bind "
29678 "mount to /proc/_pid_/ns/_type_."
29681 #. type: Plain text
29682 #: ../sys-utils/lsns.8.adoc:39
29683 msgid "Use list output format."
29686 #. type: Plain text
29687 #: ../sys-utils/lsns.8.adoc:47
29689 "The default list of columns may be extended if _list_ is specified in the "
29690 "format **+**__list__ (e.g., *lsns -o +PATH*)."
29693 #. type: Labeled list
29694 #: ../sys-utils/lsns.8.adoc:51
29696 #| msgid "*-P*, *--pty*"
29697 msgid "*-P*, *--persistent*"
29698 msgstr "*-P*, *--pty*"
29700 #. type: Plain text
29701 #: ../sys-utils/lsns.8.adoc:54
29703 "Display only the namespaces without processes (aka persistent namespaces), "
29704 "created by bind mounting /proc/pid/ns/type files to a filesystem path."
29707 #. type: Labeled list
29708 #: ../sys-utils/lsns.8.adoc:55
29710 #| msgid "*-f*, *--fast*"
29711 msgid "*-p*, *--task* _PID_"
29712 msgstr "*-f*, *--fast*"
29714 #. type: Plain text
29715 #: ../sys-utils/lsns.8.adoc:57
29716 msgid "Display only the namespaces held by the process with this _PID_."
29719 #. type: Plain text
29720 #: ../sys-utils/lsns.8.adoc:63
29722 "Display the specified _type_ of namespaces only. The supported types are "
29723 "*mnt*, *net*, *ipc*, *user*, *pid*, *uts*, *cgroup* and *time*. This option "
29724 "may be given more than once."
29727 #. type: Labeled list
29728 #: ../sys-utils/lsns.8.adoc:67
29730 #| msgid "*-P*, *--pty*"
29731 msgid "*-W*, *--nowrap*"
29732 msgstr "*-P*, *--pty*"
29734 #. type: Plain text
29735 #: ../sys-utils/lsns.8.adoc:69
29736 msgid "Do not use multi-line text in columns."
29739 #. type: Labeled list
29740 #: ../sys-utils/lsns.8.adoc:70
29742 #| msgid "*-P*, *--pty*"
29743 msgid "*-T*, *--tree* _rel_"
29744 msgstr "*-P*, *--pty*"
29746 #. type: Plain text
29747 #: ../sys-utils/lsns.8.adoc:72
29749 "Use tree-like output format. If *process* is given as _rel_, print process "
29750 "tree(s) in each name space. This is default when *--tree* is not specified. "
29751 "If *parent* is given, print tree(s) constructed by the parent/child "
29752 "relationship. If *owner* is given, print tree(s) constructed by the owner/"
29753 "owned relationship. *owner* is used as default when _rel_ is omitted."
29756 #. type: Plain text
29757 #: ../sys-utils/lsns.8.adoc:78
29758 msgid "The *lsns* utility exits with one of the following values:"
29761 #. type: Plain text
29762 #: ../sys-utils/lsns.8.adoc:81
29766 #. type: Plain text
29767 #: ../sys-utils/lsns.8.adoc:83
29768 msgid "General error."
29771 #. type: Plain text
29772 #: ../sys-utils/lsns.8.adoc:85
29773 msgid "An ioctl was unknown to the kernel."
29776 #. type: Plain text
29777 #: ../sys-utils/lsns.8.adoc:98
29780 #| "*setpriv*(1),\n"
29781 #| "*login.defs*(5),\n"
29782 #| "*shells*(5),\n"
29784 #| "*runuser*(1)\n"
29789 "*namespaces*(7),\n"
29794 "*login.defs*(5),\n"
29804 #. Copyright (c) 1996-2004 Andries Brouwer
29805 #. Copyright (C) 2006-2012 Karel Zak <kzak@redhat.com>
29806 #. This page is somewhat derived from a page that was
29807 #. (c) 1980, 1989, 1991 The Regents of the University of California
29808 #. and had been heavily modified by Rik Faith and myself.
29809 #. (Probably no BSD text remains.)
29810 #. Fragments of text were written by Werner Almesberger, Remy Card,
29811 #. Stephen Tweedie and Eric Youngdale.
29812 #. This is free documentation; you can redistribute it and/or
29813 #. modify it under the terms of the GNU General Public License as
29814 #. published by the Free Software Foundation; either version 2 of
29815 #. the License, or (at your option) any later version.
29816 #. The GNU General Public License's references to "object code"
29817 #. and "executables" are to be interpreted as the output of any
29818 #. document formatting or typesetting system, including
29819 #. intermediate and printed output.
29820 #. This manual is distributed in the hope that it will be useful,
29821 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
29822 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
29823 #. GNU General Public License for more details.
29824 #. You should have received a copy of the GNU General Public License along
29825 #. with this program; if not, write to the Free Software Foundation, Inc.,
29826 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
29828 #: ../sys-utils/mount.8.adoc:32
29833 #. type: Plain text
29834 #: ../sys-utils/mount.8.adoc:43
29835 msgid "mount - mount a filesystem"
29838 #. type: Plain text
29839 #: ../sys-utils/mount.8.adoc:47
29841 msgid "*mount* [*-h*|*-V*]\n"
29844 #. type: Plain text
29845 #: ../sys-utils/mount.8.adoc:49
29847 msgid "*mount* [*-l*] [*-t* _fstype_]\n"
29850 #. type: Plain text
29851 #: ../sys-utils/mount.8.adoc:51
29853 msgid "*mount* *-a* [*-fFnrsvw*] [*-t* _fstype_] [*-O* _optlist_]\n"
29856 #. type: Plain text
29857 #: ../sys-utils/mount.8.adoc:53
29859 msgid "*mount* [*-fnrsvw*] [*-o* _options_] _device_|_mountpoint_\n"
29862 #. type: Plain text
29863 #: ../sys-utils/mount.8.adoc:55
29865 msgid "*mount* [*-fnrsvw*] [*-t* _fstype_] [*-o* _options_] _device mountpoint_\n"
29868 #. type: Plain text
29869 #: ../sys-utils/mount.8.adoc:57
29871 msgid "*mount* *--bind*|*--rbind*|*--move* _olddir newdir_\n"
29874 #. type: Plain text
29875 #: ../sys-utils/mount.8.adoc:59
29877 msgid "*mount* *--make-*[*shared*|*slave*|*private*|*unbindable*|*rshared*|*rslave*|*rprivate*|*runbindable*] _mountpoint_\n"
29880 #. type: Plain text
29881 #: ../sys-utils/mount.8.adoc:63
29883 "All files accessible in a Unix system are arranged in one big tree, the file "
29884 "hierarchy, rooted at _/_. These files can be spread out over several "
29885 "devices. The *mount* command serves to attach the filesystem found on some "
29886 "device to the big file tree. Conversely, the *umount*(8) command will detach "
29887 "it again. The filesystem is used to control how data is stored on the device "
29888 "or provided in a virtual way by network or other services."
29891 #. type: Plain text
29892 #: ../sys-utils/mount.8.adoc:65
29893 msgid "The standard form of the *mount* command is:"
29896 #. type: delimited block _
29897 #: ../sys-utils/mount.8.adoc:68
29899 msgid "*mount -t* _type device dir_\n"
29902 #. type: Plain text
29903 #: ../sys-utils/mount.8.adoc:71
29905 "This tells the kernel to attach the filesystem found on _device_ (which is "
29906 "of type _type_) at the directory _dir_. The option *-t* _type_ is optional. "
29907 "The *mount* command is usually able to detect a filesystem. The root "
29908 "permissions are necessary to mount a filesystem by default. See section "
29909 "\"Non-superuser mounts\" below for more details. The previous contents (if "
29910 "any) and owner and mode of _dir_ become invisible, and as long as this "
29911 "filesystem remains mounted, the pathname _dir_ refers to the root of the "
29912 "filesystem on _device_."
29915 #. type: Plain text
29916 #: ../sys-utils/mount.8.adoc:73
29917 msgid "If only the directory or the device is given, for example:"
29920 #. type: delimited block _
29921 #: ../sys-utils/mount.8.adoc:76
29923 msgid "*mount* _/dir_\n"
29926 #. type: Plain text
29927 #: ../sys-utils/mount.8.adoc:79
29929 "then *mount* looks for a mountpoint (and if not found then for a device) in "
29930 "the _/etc/fstab_ file. It's possible to use the *--target* or *--source* "
29931 "options to avoid ambiguous interpretation of the given argument. For example:"
29934 #. type: delimited block _
29935 #: ../sys-utils/mount.8.adoc:82
29937 msgid "*mount --target* _/mountpoint_\n"
29940 #. type: Plain text
29941 #: ../sys-utils/mount.8.adoc:85
29943 "The same filesystem may be mounted more than once, and in some cases (e.g., "
29944 "network filesystems) the same filesystem may be mounted on the same "
29945 "mountpoint multiple times. The *mount* command does not implement any policy "
29946 "to control this behavior. All behavior is controlled by the kernel and it is "
29947 "usually specific to the filesystem driver. The exception is *--all*, in this "
29948 "case already mounted filesystems are ignored (see *--all* below for more "
29953 #: ../sys-utils/mount.8.adoc:86
29955 msgid "Listing the mounts"
29958 #. type: Plain text
29959 #: ../sys-utils/mount.8.adoc:89
29960 msgid "The listing mode is maintained for backward compatibility only."
29963 #. type: Plain text
29964 #: ../sys-utils/mount.8.adoc:91
29966 "For more robust and customizable output use *findmnt*(8), *especially in "
29967 "your scripts*. Note that control characters in the mountpoint name are "
29968 "replaced with '?'."
29971 #. type: Plain text
29972 #: ../sys-utils/mount.8.adoc:93
29973 msgid "The following command lists all mounted filesystems (of type _type_):"
29976 #. type: delimited block _
29977 #: ../sys-utils/mount.8.adoc:96
29979 msgid "*mount* [*-l*] [*-t* _type_]\n"
29982 #. type: Plain text
29983 #: ../sys-utils/mount.8.adoc:99
29984 msgid "The option *-l* adds labels to this listing. See below."
29988 #: ../sys-utils/mount.8.adoc:100
29990 msgid "Indicating the device and filesystem"
29993 #. type: Plain text
29994 #: ../sys-utils/mount.8.adoc:103
29996 "Most devices are indicated by a filename (of a block special device), like _/"
29997 "dev/sda1_, but there are other possibilities. For example, in the case of an "
29998 "NFS mount, _device_ may look like _knuth.cwi.nl:/dir_."
30001 #. type: Plain text
30002 #: ../sys-utils/mount.8.adoc:105
30004 "The device names of disk partitions are unstable; hardware reconfiguration, "
30005 "and adding or removing a device can cause changes in names. This is the "
30006 "reason why it's strongly recommended to use filesystem or partition "
30007 "identifiers like UUID or LABEL. Currently supported identifiers (tags):"
30010 #. type: Labeled list
30011 #: ../sys-utils/mount.8.adoc:106
30013 msgid "LABEL=__label__"
30016 #. type: Plain text
30017 #: ../sys-utils/mount.8.adoc:108
30018 msgid "Human readable filesystem identifier. See also *-L*."
30021 #. type: Labeled list
30022 #: ../sys-utils/mount.8.adoc:109
30024 msgid "UUID=__uuid__"
30027 #. type: Plain text
30028 #: ../sys-utils/mount.8.adoc:111
30030 "Filesystem universally unique identifier. The format of the UUID is usually "
30031 "a series of hex digits separated by hyphens. See also *-U*."
30034 #. type: Plain text
30035 #: ../sys-utils/mount.8.adoc:113
30037 "Note that *mount* uses UUIDs as strings. The UUIDs from the command line or "
30038 "from *fstab*(5) are not converted to internal binary representation. The "
30039 "string representation of the UUID should be based on lower case characters."
30042 #. type: Labeled list
30043 #: ../sys-utils/mount.8.adoc:114
30045 msgid "PARTLABEL=__label__"
30048 #. type: Plain text
30049 #: ../sys-utils/mount.8.adoc:116
30051 "Human readable partition identifier. This identifier is independent on "
30052 "filesystem and does not change by *mkfs* or *mkswap* operations. It's "
30053 "supported for example for GUID Partition Tables (GPT)."
30056 #. type: Labeled list
30057 #: ../sys-utils/mount.8.adoc:117
30059 msgid "PARTUUID=__uuid__"
30062 #. type: Plain text
30063 #: ../sys-utils/mount.8.adoc:119
30065 "Partition universally unique identifier. This identifier is independent on "
30066 "filesystem and does not change by *mkfs* or *mkswap* operations. It's "
30067 "supported for example for GUID Partition Tables (GPT)."
30070 #. type: Labeled list
30071 #: ../sys-utils/mount.8.adoc:120
30076 #. type: Plain text
30077 #: ../sys-utils/mount.8.adoc:122
30079 "Hardware block device ID as generated by udevd. This identifier is usually "
30080 "based on WWN (unique storage identifier) and assigned by the hardware "
30081 "manufacturer. See *ls /dev/disk/by-id* for more details, this directory and "
30082 "running udevd is required. This identifier is not recommended for generic "
30083 "use as the identifier is not strictly defined and it depends on udev, udev "
30084 "rules and hardware."
30087 #. type: Plain text
30088 #: ../sys-utils/mount.8.adoc:124
30090 "The command *lsblk --fs* provides an overview of filesystems, LABELs and "
30091 "UUIDs on available block devices. The command *blkid -p <device>* provides "
30092 "details about a filesystem on the specified device."
30095 #. type: Plain text
30096 #: ../sys-utils/mount.8.adoc:126
30098 "Don't forget that there is no guarantee that UUIDs and labels are really "
30099 "unique, especially if you move, share or copy the device. Use *lsblk -o "
30100 "+UUID,PARTUUID* to verify that the UUIDs are really unique in your system."
30103 #. type: Plain text
30104 #: ../sys-utils/mount.8.adoc:128
30106 "The recommended setup is to use tags (e.g. *UUID*=_uuid_) rather than _/dev/"
30107 "disk/by-{label,uuid,id,partuuid,partlabel}_ udev symlinks in the _/etc/"
30108 "fstab_ file. Tags are more readable, robust and portable. The *mount*(8) "
30109 "command internally uses udev symlinks, so the use of symlinks in _/etc/"
30110 "fstab_ has no advantage over tags. For more details see *libblkid*(3)."
30113 #. type: Plain text
30114 #: ../sys-utils/mount.8.adoc:130
30116 "The _proc_ filesystem is not associated with a special device, and when "
30117 "mounting it, an arbitrary keyword - for example, __proc__ - can be used "
30118 "instead of a device specification. (The customary choice _none_ is less "
30119 "fortunate: the error message 'none already mounted' from *mount* can be "
30124 #: ../sys-utils/mount.8.adoc:131
30126 msgid "The files /etc/fstab, /etc/mtab and /proc/mounts"
30129 #. type: Plain text
30130 #: ../sys-utils/mount.8.adoc:134
30132 "The file _/etc/fstab_ (see *fstab*(5)), may contain lines describing what "
30133 "devices are usually mounted where, using which options. The default location "
30134 "of the *fstab*(5) file can be overridden with the *--fstab* _path_ command-"
30135 "line option (see below for more details)."
30138 #. type: Plain text
30139 #: ../sys-utils/mount.8.adoc:136
30141 #| msgid "User Commands"
30142 msgid "The command"
30143 msgstr "Příručka uživatele"
30145 #. type: delimited block _
30146 #: ../sys-utils/mount.8.adoc:139
30148 msgid "*mount -a* [*-t* _type_] [*-O* _optlist_]\n"
30151 #. type: Plain text
30152 #: ../sys-utils/mount.8.adoc:142
30154 "(usually given in a bootscript) causes all filesystems mentioned in _fstab_ "
30155 "(of the proper type and/or having or not having the proper options) to be "
30156 "mounted as indicated, except for those whose line contains the *noauto* "
30157 "keyword. Adding the *-F* option will make *mount* fork, so that the "
30158 "filesystems are mounted in parallel."
30161 #. type: Plain text
30162 #: ../sys-utils/mount.8.adoc:144
30164 "When mounting a filesystem mentioned in _fstab_ or _mtab_, it suffices to "
30165 "specify on the command line only the device, or only the mount point."
30168 #. type: Plain text
30169 #: ../sys-utils/mount.8.adoc:146
30171 "The programs *mount* and *umount*(8) traditionally maintained a list of "
30172 "currently mounted filesystems in the file _/etc/mtab_. The support for "
30173 "regular classic _/etc/mtab_ is completely disabled at compile time by "
30174 "default, because on current Linux systems it is better to make _/etc/mtab_ a "
30175 "symlink to _/proc/mounts_ instead. The regular _mtab_ file maintained in "
30176 "userspace cannot reliably work with namespaces, containers and other "
30177 "advanced Linux features. If the regular _mtab_ support is enabled, then it's "
30178 "possible to use the file as well as the symlink."
30181 #. type: Plain text
30182 #: ../sys-utils/mount.8.adoc:148
30184 "If no arguments are given to *mount*, the list of mounted filesystems is "
30188 #. type: Plain text
30189 #: ../sys-utils/mount.8.adoc:150
30191 "If you want to override mount options from _/etc/fstab_, you have to use the "
30195 #. type: delimited block _
30196 #: ../sys-utils/mount.8.adoc:153
30198 msgid "*mount* __device__|__dir__ *-o* _options_\n"
30201 #. type: Plain text
30202 #: ../sys-utils/mount.8.adoc:156
30204 "and then the mount options from the command line will be appended to the "
30205 "list of options from _/etc/fstab_. This default behaviour can be changed "
30206 "using the *--options-mode* command-line option. The usual behavior is that "
30207 "the last option wins if there are conflicting ones."
30210 #. type: Plain text
30211 #: ../sys-utils/mount.8.adoc:158
30213 "The *mount* program does not read the _/etc/fstab_ file if both _device_ (or "
30214 "LABEL, UUID, ID, PARTUUID or PARTLABEL) and _dir_ are specified. For "
30215 "example, to mount device *foo* at */dir*:"
30218 #. type: delimited block _
30219 #: ../sys-utils/mount.8.adoc:161
30221 msgid "*mount /dev/foo /dir*\n"
30224 #. type: Plain text
30225 #: ../sys-utils/mount.8.adoc:164
30227 "This default behaviour can be changed by using the *--options-source-force* "
30228 "command-line option to always read configuration from _fstab_. For non-root "
30229 "users *mount* always reads the _fstab_ configuration."
30233 #: ../sys-utils/mount.8.adoc:165
30235 msgid "Non-superuser mounts"
30238 #. type: Plain text
30239 #: ../sys-utils/mount.8.adoc:168
30241 "Normally, only the superuser can mount filesystems. However, when _fstab_ "
30242 "contains the *user* option on a line, anybody can mount the corresponding "
30246 #. type: Plain text
30247 #: ../sys-utils/mount.8.adoc:170
30248 msgid "Thus, given a line"
30251 #. type: delimited block _
30252 #: ../sys-utils/mount.8.adoc:173
30254 msgid "*/dev/cdrom /cd iso9660 ro,user,noauto,unhide*\n"
30257 #. type: Plain text
30258 #: ../sys-utils/mount.8.adoc:176
30260 "any user can mount the iso9660 filesystem found on an inserted CDROM using "
30264 #. type: delimited block _
30265 #: ../sys-utils/mount.8.adoc:179
30267 msgid "*mount /cd*\n"
30270 #. type: Plain text
30271 #: ../sys-utils/mount.8.adoc:182
30273 "Note that *mount* is very strict about non-root users and all paths "
30274 "specified on command line are verified before _fstab_ is parsed or a helper "
30275 "program is executed. It's strongly recommended to use a valid mountpoint to "
30276 "specify filesystem, otherwise *mount* may fail. For example it's a bad idea "
30277 "to use NFS or CIFS source on command line."
30280 #. type: Plain text
30281 #: ../sys-utils/mount.8.adoc:184
30283 "Since util-linux 2.35, *mount* does not exit when user permissions are "
30284 "inadequate according to libmount's internal security rules. Instead, it "
30285 "drops suid permissions and continues as regular non-root user. This behavior "
30286 "supports use-cases where root permissions are not necessary (e.g., fuse "
30287 "filesystems, user namespaces, etc)."
30290 #. type: Plain text
30291 #: ../sys-utils/mount.8.adoc:186
30293 "For more details, see *fstab*(5). Only the user that mounted a filesystem "
30294 "can unmount it again. If any user should be able to unmount it, then use "
30295 "*users* instead of *user* in the _fstab_ line. The *owner* option is similar "
30296 "to the *user* option, with the restriction that the user must be the owner "
30297 "of the special file. This may be useful e.g. for _/dev/fd_ if a login script "
30298 "makes the console user owner of this device. The *group* option is similar, "
30299 "with the restriction that the user must be a member of the group of the "
30303 #. type: Plain text
30304 #: ../sys-utils/mount.8.adoc:188
30306 "The *user* mount option is accepted if no username is specified. If used in "
30307 "the format *user=someone*, the option is silently ignored and visible only "
30308 "for external mount helpers (/sbin/mount.<type>) for compatibility with some "
30309 "network filesystems."
30313 #: ../sys-utils/mount.8.adoc:189
30315 msgid "Bind mount operation"
30318 #. type: Plain text
30319 #: ../sys-utils/mount.8.adoc:192
30320 msgid "Remount part of the file hierarchy somewhere else. The call is:"
30323 #. type: delimited block _
30324 #: ../sys-utils/mount.8.adoc:195 ../sys-utils/mount.8.adoc:233
30326 msgid "*mount --bind* _olddir newdir_\n"
30329 #. type: Plain text
30330 #: ../sys-utils/mount.8.adoc:198
30331 msgid "or by using this _fstab_ entry:"
30334 #. type: delimited block _
30335 #: ../sys-utils/mount.8.adoc:201
30337 msgid "**/**__olddir__ **/**__newdir__ *none bind*\n"
30340 #. type: Plain text
30341 #: ../sys-utils/mount.8.adoc:204
30342 msgid "After this call the same contents are accessible in two places."
30345 #. type: Plain text
30346 #: ../sys-utils/mount.8.adoc:206
30348 "It is important to understand that \"bind\" does not create any second-class "
30349 "or special node in the kernel VFS. The \"bind\" is just another operation to "
30350 "attach a filesystem. There is nowhere stored information that the filesystem "
30351 "has been attached by a \"bind\" operation. The _olddir_ and _newdir_ are "
30352 "independent and the _olddir_ may be unmounted."
30355 #. type: Plain text
30356 #: ../sys-utils/mount.8.adoc:208
30358 "One can also remount a single file (on a single file). It's also possible to "
30359 "use a bind mount to create a mountpoint from a regular directory, for "
30363 #. type: delimited block _
30364 #: ../sys-utils/mount.8.adoc:211
30366 msgid "*mount --bind foo foo*\n"
30369 #. type: Plain text
30370 #: ../sys-utils/mount.8.adoc:214
30372 "The bind mount call attaches only (part of) a single filesystem, not "
30373 "possible submounts. The entire file hierarchy including submounts can be "
30374 "attached a second place by using:"
30377 #. type: delimited block _
30378 #: ../sys-utils/mount.8.adoc:217
30380 msgid "*mount --rbind* _olddir newdir_\n"
30383 #. type: Plain text
30384 #: ../sys-utils/mount.8.adoc:220
30386 "Note that the filesystem mount options maintained by the kernel will remain "
30387 "the same as those on the original mount point. The userspace mount options "
30388 "(e.g., _netdev) will not be copied by *mount* and it's necessary to "
30389 "explicitly specify the options on the *mount* command line."
30392 #. type: Plain text
30393 #: ../sys-utils/mount.8.adoc:222
30395 "Since util-linux 2.27 *mount* permits changing the mount options by passing "
30396 "the relevant options along with *--bind*. For example:"
30399 #. type: delimited block _
30400 #: ../sys-utils/mount.8.adoc:225
30402 msgid "*mount -o bind,ro foo foo*\n"
30405 #. type: Plain text
30406 #: ../sys-utils/mount.8.adoc:228
30408 "This feature is not supported by the Linux kernel; it is implemented in "
30409 "userspace by an additional *mount*(2) remounting system call. This solution "
30413 #. type: Plain text
30414 #: ../sys-utils/mount.8.adoc:230
30416 "The alternative (classic) way to create a read-only bind mount is to use the "
30417 "remount operation, for example:"
30420 #. type: delimited block _
30421 #: ../sys-utils/mount.8.adoc:235
30423 msgid "*mount -o remount,bind,ro* _olddir newdir_\n"
30426 #. type: Plain text
30427 #: ../sys-utils/mount.8.adoc:238
30429 "Note that a read-only bind will create a read-only mountpoint (VFS entry), "
30430 "but the original filesystem superblock will still be writable, meaning that "
30431 "the _olddir_ will be writable, but the _newdir_ will be read-only."
30434 #. type: Plain text
30435 #: ../sys-utils/mount.8.adoc:240
30437 "It's also possible to change nosuid, nodev, noexec, noatime, nodiratime, "
30438 "relatime and nosymfollow VFS entry flags via a \"remount,bind\" operation. "
30439 "The other flags (for example filesystem-specific flags) are silently "
30440 "ignored. The classic *mount*(2) system call does not allow to change mount "
30441 "options recursively (for example with *-o rbind,ro*). The recursive semantic "
30442 "is possible with a new *mount_setattr*(2) kernel system call and it's "
30443 "supported since libmount from util-linux v2.39 by a new experimental "
30444 "\"recursive\" option argument (e.g. *-o rbind,ro=recursive*). For more "
30445 "details see the *FILESYSTEM-INDEPENDENT MOUNT OPTIONS* section."
30448 #. type: Plain text
30449 #: ../sys-utils/mount.8.adoc:242
30451 "Since util-linux 2.31, *mount* ignores the *bind* flag from _/etc/fstab_ on "
30452 "a *remount* operation (if *-o remount* is specified on command line). This "
30453 "is necessary to fully control mount options on remount by command line. In "
30454 "previous versions the bind flag has been always applied and it was "
30455 "impossible to re-define mount options without interaction with the bind "
30456 "semantic. This *mount* behavior does not affect situations when \"remount,"
30457 "bind\" is specified in the _/etc/fstab_ file."
30460 #. type: Plain text
30461 #: ../sys-utils/mount.8.adoc:244
30463 "Since util-linux 2.40, *mount* does not canonicalize the mountpoint path on "
30464 "bind operation if the target is a symlink. This feature is usable (only) "
30465 "with the new kernel mount API where *bind mount over symlinks* is supported."
30469 #: ../sys-utils/mount.8.adoc:245
30471 msgid "The move operation"
30474 #. type: Plain text
30475 #: ../sys-utils/mount.8.adoc:248
30476 msgid "Move a *mounted tree* to another place (atomically). The call is:"
30479 #. type: delimited block _
30480 #: ../sys-utils/mount.8.adoc:251
30482 msgid "*mount --move* _olddir newdir_\n"
30485 #. type: Plain text
30486 #: ../sys-utils/mount.8.adoc:254
30488 "This will cause the contents which previously appeared under _olddir_ to now "
30489 "be accessible under _newdir_. The physical location of the files is not "
30490 "changed. Note that _olddir_ has to be a mountpoint."
30493 #. type: Plain text
30494 #: ../sys-utils/mount.8.adoc:256
30496 "Note also that moving a mount residing under a shared mount is invalid and "
30497 "unsupported. Use *findmnt -o TARGET,PROPAGATION* to see the current "
30498 "propagation flags."
30502 #: ../sys-utils/mount.8.adoc:257
30504 msgid "Shared subtree operations"
30507 #. type: Plain text
30508 #: ../sys-utils/mount.8.adoc:260
30510 "Since Linux 2.6.15 it is possible to mark a mount and its submounts as "
30511 "shared, private, slave or unbindable. A shared mount provides the ability to "
30512 "create mirrors of that mount such that mounts and unmounts within any of the "
30513 "mirrors propagate to the other mirror. A slave mount receives propagation "
30514 "from its master, but not vice versa. A private mount carries no propagation "
30515 "abilities. An unbindable mount is a private mount which cannot be cloned "
30516 "through a bind operation. The detailed semantics are documented in "
30517 "_Documentation/filesystems/sharedsubtree.txt_ file in the kernel source "
30518 "tree; see also *mount_namespaces*(7)."
30521 #. type: Plain text
30522 #: ../sys-utils/mount.8.adoc:262
30523 msgid "Supported operations are:"
30526 #. type: delimited block .
30527 #: ../sys-utils/mount.8.adoc:268
30530 "mount --make-shared mountpoint\n"
30531 "mount --make-slave mountpoint\n"
30532 "mount --make-private mountpoint\n"
30533 "mount --make-unbindable mountpoint\n"
30536 #. type: Plain text
30537 #: ../sys-utils/mount.8.adoc:271
30539 "The following commands allow one to recursively change the type of all the "
30540 "mounts under a given mountpoint."
30543 #. type: delimited block .
30544 #: ../sys-utils/mount.8.adoc:277
30547 "mount --make-rshared mountpoint\n"
30548 "mount --make-rslave mountpoint\n"
30549 "mount --make-rprivate mountpoint\n"
30550 "mount --make-runbindable mountpoint\n"
30553 #. type: Plain text
30554 #: ../sys-utils/mount.8.adoc:280
30556 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"
30559 #. type: Plain text
30560 #: ../sys-utils/mount.8.adoc:282
30562 "Note that the Linux kernel does not allow changing multiple propagation "
30563 "flags with a single *mount*(2) system call, and the flags cannot be mixed "
30564 "with other mount options and operations."
30567 #. type: Plain text
30568 #: ../sys-utils/mount.8.adoc:284
30570 "Since util-linux 2.23 the *mount* command can be used to do more propagation "
30571 "(topology) changes by one *mount*(8) call and do it also together with other "
30572 "mount operations. The propagation flags are applied by additional *mount*(2) "
30573 "system calls when the preceding mount operations were successful. Note that "
30574 "this use case is not atomic. It is possible to specify the propagation flags "
30575 "in *fstab*(5) as mount options (*private*, *slave*, *shared*, *unbindable*, "
30576 "*rprivate*, *rslave*, *rshared*, *runbindable*)."
30579 #. type: delimited block .
30580 #: ../sys-utils/mount.8.adoc:289
30582 msgid "mount --make-private --make-unbindable /dev/sda1 /foo\n"
30585 #. type: Plain text
30586 #: ../sys-utils/mount.8.adoc:292
30587 msgid "is the same as:"
30590 #. type: delimited block .
30591 #: ../sys-utils/mount.8.adoc:297
30594 "mount /dev/sda1 /foo\n"
30595 "mount --make-private /foo\n"
30596 "mount --make-unbindable /foo\n"
30600 #: ../sys-utils/mount.8.adoc:299
30602 msgid "COMMAND-LINE OPTIONS"
30605 #. type: Plain text
30606 #: ../sys-utils/mount.8.adoc:302
30608 "The full set of mount options used by an invocation of *mount* is determined "
30609 "by first extracting the mount options for the filesystem from the _fstab_ "
30610 "table, then applying any options specified by the *-o* argument, and finally "
30611 "applying a *-r* or *-w* option, when present."
30614 #. type: Plain text
30615 #: ../sys-utils/mount.8.adoc:304
30617 "The *mount* command does not pass all command-line options to the **/sbin/"
30618 "mount.**__suffix__ mount helpers. The interface between *mount* and the "
30619 "mount helpers is described below in the *EXTERNAL HELPERS* section."
30622 #. type: Plain text
30623 #: ../sys-utils/mount.8.adoc:306
30624 msgid "Command-line options available for the *mount* command are:"
30627 #. type: Plain text
30628 #: ../sys-utils/mount.8.adoc:309
30630 "Mount all filesystems (of the given types) mentioned in _fstab_ (except for "
30631 "those whose line contains the *noauto* keyword). The filesystems are mounted "
30632 "following their order in _fstab_. The *mount* command compares filesystem "
30633 "source, target (and fs root for bind mount or btrfs) to detect already "
30634 "mounted filesystems. The kernel table with already mounted filesystems is "
30635 "cached during *mount --all*. This means that all duplicated _fstab_ entries "
30639 #. type: Plain text
30640 #: ../sys-utils/mount.8.adoc:311
30642 "The correct functionality depends on _/proc_ (to detect already mounted "
30643 "filesystems) and on _/sys_ (to evaluate filesystem tags like UUID= or "
30644 "LABEL=). It's strongly recommended to mount _/proc_ and _/sys_ filesystems "
30645 "before *mount -a* is executed, or keep /proc and /sys at the beginning of "
30649 #. type: Plain text
30650 #: ../sys-utils/mount.8.adoc:313
30652 "The option *--all* is possible to use for remount operation too. In this "
30653 "case all filters (*-t* and *-O*) are applied to the table of already mounted "
30657 #. type: Plain text
30658 #: ../sys-utils/mount.8.adoc:315
30660 "Since version 2.35 it is possible to use the command line option *-o* to "
30661 "alter mount options from _fstab_ (see also *--options-mode*)."
30664 #. type: Plain text
30665 #: ../sys-utils/mount.8.adoc:317
30667 "Note that it is a bad practice to use *mount -a* for _fstab_ checking. The "
30668 "recommended solution is *findmnt --verify*."
30671 #. type: Labeled list
30672 #: ../sys-utils/mount.8.adoc:318
30674 #| msgid "*-V*, *--version*"
30675 msgid "*-B*, *--bind*"
30676 msgstr "*-V*, *--version*"
30678 #. type: Plain text
30679 #: ../sys-utils/mount.8.adoc:320
30681 "Remount a subtree somewhere else (so that its contents are available in both "
30682 "places). See above, under *Bind mount operation*."
30685 #. type: Labeled list
30686 #: ../sys-utils/mount.8.adoc:321 ../sys-utils/umount.8.adoc:60
30688 msgid "*-c*, *--no-canonicalize*"
30691 #. type: Plain text
30692 #: ../sys-utils/mount.8.adoc:323
30694 "Don't canonicalize paths. The *mount* command canonicalizes all paths (from "
30695 "the command line or _fstab_) by default. The option is designed for mount "
30696 "helpers which call *mount -i*. It is strongly recommended to not use this "
30697 "command-line option for normal mount operations."
30700 #. type: Plain text
30701 #: ../sys-utils/mount.8.adoc:325
30703 "Since util-linux 2.40, mount does not canonicalize the mountpoint path on "
30704 "bind operation if the target is a symlink (see \"*Bind mount operation*\" "
30705 "section for more details)."
30708 #. type: Plain text
30709 #: ../sys-utils/mount.8.adoc:327
30711 "Note that *mount* does not pass this option to the **/sbin/mount.**__type__ "
30715 #. type: Labeled list
30716 #: ../sys-utils/mount.8.adoc:328
30718 #| msgid "*-f*, *--fast*"
30719 msgid "*-F*, *--fork*"
30720 msgstr "*-f*, *--fast*"
30722 #. type: Plain text
30723 #: ../sys-utils/mount.8.adoc:330
30725 "(Used in conjunction with *-a*.) Fork off a new incarnation of *mount* for "
30726 "each device. This will do the mounts on different devices or different NFS "
30727 "servers in parallel. This has the advantage that it is faster; also NFS "
30728 "timeouts proceed in parallel. A disadvantage is that the order of the mount "
30729 "operations is undefined. Thus, you cannot use this option if you want to "
30730 "mount both _/usr_ and _/usr/spool_."
30733 #. type: Labeled list
30734 #: ../sys-utils/mount.8.adoc:331
30736 #| msgid "*-f*, *--fast*"
30737 msgid "*-f, --fake*"
30738 msgstr "*-f*, *--fast*"
30740 #. type: Plain text
30741 #: ../sys-utils/mount.8.adoc:333
30743 "Causes everything to be done except for the mount-related system calls. The "
30744 "*--fake* option was originally designed to write an entry to _/etc/mtab_ "
30745 "without actually mounting."
30748 #. type: Plain text
30749 #: ../sys-utils/mount.8.adoc:335
30751 "The _/etc/mtab_ is no longer maintained in userspace, and starting from "
30752 "version 2.39, the mount operation can be a complex chain of operations with "
30753 "dependencies between the syscalls. The *--fake* option forces libmount to "
30754 "skip all mount source preparation, mount option analysis, and the actual "
30755 "mounting process."
30758 #. type: Plain text
30759 #: ../sys-utils/mount.8.adoc:337
30761 "The difference between fake and non-fake execution is huge. This is the "
30762 "reason why the *--fake* option has minimal significance for the current "
30763 "*mount*(8) implementation and it is maintained mostly for backward "
30767 #. type: Labeled list
30768 #: ../sys-utils/mount.8.adoc:338
30770 msgid "*-i, --internal-only*"
30773 #. type: Plain text
30774 #: ../sys-utils/mount.8.adoc:340
30775 msgid "Don't call the **/sbin/mount.**__filesystem__ helper even if it exists."
30778 #. type: Plain text
30779 #: ../sys-utils/mount.8.adoc:343
30780 msgid "Mount the partition that has the specified _label_."
30783 #. type: Labeled list
30784 #: ../sys-utils/mount.8.adoc:344
30786 #| msgid "*-h*, *--help*"
30787 msgid "*-l*, *--show-labels*"
30788 msgstr "*-h*, *--help*"
30790 #. type: Plain text
30791 #: ../sys-utils/mount.8.adoc:346
30793 "Add the labels in the mount output. *mount* must have permission to read the "
30794 "disk device (e.g. be set-user-ID root) for this to work. One can set such a "
30795 "label for ext2, ext3 or ext4 using the *e2label*(8) utility, or for XFS "
30796 "using *xfs_admin*(8), or for reiserfs using *reiserfstune*(8)."
30799 #. type: Labeled list
30800 #: ../sys-utils/mount.8.adoc:347
30802 #| msgid "*-h*, *--help*"
30803 msgid "*-M*, *--move*"
30804 msgstr "*-h*, *--help*"
30806 #. type: Plain text
30807 #: ../sys-utils/mount.8.adoc:349
30809 "Move a subtree to some other place. See above, the subsection *The move "
30813 #. type: Labeled list
30814 #: ../sys-utils/mount.8.adoc:350
30816 #| msgid "*-c*, **--command**=__command__"
30817 msgid "*-m*, **--mkdir**[=__mode__]"
30818 msgstr "*-c*, **--command**=__příkaz__"
30820 #. type: Plain text
30821 #: ../sys-utils/mount.8.adoc:352
30823 "Allow to make a target directory (mountpoint) if it does not exist yet. "
30824 "Alias to \"-o X-mount.mkdir[=mode]\", the default mode is 0755. For more "
30825 "details see *X-mount.mkdir* below."
30828 #. type: Labeled list
30829 #: ../sys-utils/mount.8.adoc:353
30831 msgid "*--map-groups*, *--map-users* _inner_:_outer_:_count_"
30834 #. type: Plain text
30835 #: ../sys-utils/mount.8.adoc:355
30837 "Add the specified user/group mapping to an *X-mount.idmap* map. These "
30838 "options can be given multiple times to build up complete mappings for users "
30839 "and groups. For more details see *X-mount.idmap* below."
30842 #. type: Labeled list
30843 #: ../sys-utils/mount.8.adoc:356
30845 msgid "*--map-users* /proc/_PID_/ns/user"
30848 #. type: Plain text
30849 #: ../sys-utils/mount.8.adoc:358
30851 "Use the specified user namespace for user and group mapping in an id-mapped "
30852 "mount. This is an alias for \"-o X-mount.idmap=/proc/_PID_/ns/user\" and "
30853 "cannot be used twice nor together with the _inner_:_outer_:_count_ option "
30854 "format above. For more details see *X-mount.idmap* below."
30857 #. type: Labeled list
30858 #: ../sys-utils/mount.8.adoc:359 ../sys-utils/umount.8.adoc:93
30860 #| msgid "*-P*, *--pty*"
30861 msgid "*-n*, *--no-mtab*"
30862 msgstr "*-P*, *--pty*"
30864 #. type: Plain text
30865 #: ../sys-utils/mount.8.adoc:361
30867 "Mount without writing in _/etc/mtab_. This is necessary for example when _/"
30868 "etc_ is on a read-only filesystem."
30871 #. type: Labeled list
30872 #: ../sys-utils/mount.8.adoc:362 ../sys-utils/umount.8.adoc:86
30874 msgid "*-N*, *--namespace* _ns_"
30877 #. type: Plain text
30878 #: ../sys-utils/mount.8.adoc:364
30880 "Perform the mount operation in the mount namespace specified by _ns_. _ns_ "
30881 "is either PID of process running in that namespace or special file "
30882 "representing that namespace."
30885 #. type: Plain text
30886 #: ../sys-utils/mount.8.adoc:366
30888 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"
30891 #. type: Plain text
30892 #: ../sys-utils/mount.8.adoc:368 ../sys-utils/umount.8.adoc:92
30893 msgid "See *mount_namespaces*(7) for more information."
30896 #. type: Labeled list
30897 #: ../sys-utils/mount.8.adoc:369
30899 msgid "*-O*, *--test-opts* _opts_"
30902 #. type: Plain text
30903 #: ../sys-utils/mount.8.adoc:371
30905 "Limit the set of filesystems to which the *-a* option applies. In this "
30906 "regard it is like the *-t* option except that *-O* is useless without *-a*. "
30907 "For example, the command"
30910 #. type: Plain text
30911 #: ../sys-utils/mount.8.adoc:373
30913 msgid "*mount -a -O no_netdev*\n"
30916 #. type: Plain text
30917 #: ../sys-utils/mount.8.adoc:375
30919 "mounts all filesystems except those which have the option _netdev_ specified "
30920 "in the options field in the _/etc/fstab_ file."
30923 #. type: Plain text
30924 #: ../sys-utils/mount.8.adoc:377
30926 "It is different from *-t* in that each option is matched exactly; a leading "
30927 "*no* at the beginning of one option does not negate the rest."
30930 #. type: Plain text
30931 #: ../sys-utils/mount.8.adoc:379
30933 "The *-t* and *-O* options are cumulative in effect; that is, the command"
30936 #. type: Plain text
30937 #: ../sys-utils/mount.8.adoc:381
30939 msgid "*mount -a -t ext2 -O _netdev*\n"
30942 #. type: Plain text
30943 #: ../sys-utils/mount.8.adoc:383
30945 "mounts all ext2 filesystems with the _netdev option, not all filesystems "
30946 "that are either ext2 or have the _netdev option specified."
30949 #. type: Labeled list
30950 #: ../sys-utils/mount.8.adoc:384 ../sys-utils/swapon.8.adoc:58
30952 msgid "*-o*, *--options* _opts_"
30955 #. type: Plain text
30956 #: ../sys-utils/mount.8.adoc:386
30958 "Use the specified mount options. The _opts_ argument is a comma-separated "
30959 "list. For example:"
30962 #. type: Plain text
30963 #: ../sys-utils/mount.8.adoc:388
30965 msgid "*mount LABEL=mydisk -o noatime,nodev,nosuid*\n"
30968 #. type: Plain text
30969 #: ../sys-utils/mount.8.adoc:390
30971 "Note that the order of the options matters, as the last option wins if there "
30972 "are conflicting ones. The options from the command line also overwrite "
30973 "options from fstab by default."
30976 #. type: Plain text
30977 #: ../sys-utils/mount.8.adoc:392
30979 "For more details, see the *FILESYSTEM-INDEPENDENT MOUNT OPTIONS* and "
30980 "*FILESYSTEM-SPECIFIC MOUNT OPTIONS* sections."
30983 #. type: Labeled list
30984 #: ../sys-utils/mount.8.adoc:393
30986 #| msgid "*-h*, *--help*"
30987 msgid "*--onlyonce*"
30988 msgstr "*-h*, *--help*"
30990 #. type: Plain text
30991 #: ../sys-utils/mount.8.adoc:395
30993 "Forces *mount* command to check if the filesystem is already mounted. This "
30994 "behavior is the default for *--all*; otherwise, it depends on the kernel "
30995 "filesystem driver. Some filesystems may be mounted more than once on the "
30996 "same mount point (e.g. tmpfs)."
30999 #. type: Labeled list
31000 #: ../sys-utils/mount.8.adoc:396
31002 msgid "*--options-mode* _mode_"
31005 #. type: Plain text
31006 #: ../sys-utils/mount.8.adoc:398
31008 "Controls how to combine options from _fstab_/_mtab_ with options from the "
31009 "command line. _mode_ can be one of *ignore*, *append*, *prepend* or "
31010 "*replace*. For example, *append* means that options from _fstab_ are "
31011 "appended to options from the command line. The default value is *prepend* -- "
31012 "it means command line options are evaluated after _fstab_ options. Note that "
31013 "the last option wins if there are conflicting ones."
31016 #. type: Labeled list
31017 #: ../sys-utils/mount.8.adoc:399
31019 msgid "*--options-source* _source_"
31022 #. type: Plain text
31023 #: ../sys-utils/mount.8.adoc:401
31025 "Source of default options. _source_ is a comma-separated list of *fstab*, "
31026 "*mtab* and *disable*. *disable* disables *fstab* and *mtab* and enables *--"
31027 "options-source-force*. The default value is *fstab,mtab*."
31030 #. type: Labeled list
31031 #: ../sys-utils/mount.8.adoc:402
31033 msgid "*--options-source-force*"
31036 #. type: Plain text
31037 #: ../sys-utils/mount.8.adoc:404
31039 "Use options from _fstab_/_mtab_ even if both _device_ and _dir_ are "
31043 #. type: Labeled list
31044 #: ../sys-utils/mount.8.adoc:405
31046 #| msgid "*-V*, *--version*"
31047 msgid "*-R*, *--rbind*"
31048 msgstr "*-V*, *--version*"
31050 #. type: Plain text
31051 #: ../sys-utils/mount.8.adoc:407
31053 "Remount a subtree and all possible submounts somewhere else (so that its "
31054 "contents are available in both places). See above, the subsection *Bind "
31055 "mount operation*."
31058 #. type: Plain text
31059 #: ../sys-utils/mount.8.adoc:410
31060 msgid "Mount the filesystem read-only. A synonym is *-o ro*."
31063 #. type: Plain text
31064 #: ../sys-utils/mount.8.adoc:412
31066 "Note that, depending on the filesystem type, state and kernel behavior, the "
31067 "system may still write to the device. For example, ext3 and ext4 will replay "
31068 "the journal if the filesystem is dirty. To prevent this kind of write "
31069 "access, you may want to mount an ext3 or ext4 filesystem with the *ro,"
31070 "noload* mount options or set the block device itself to read-only mode, see "
31071 "the *blockdev*(8) command."
31074 #. type: Plain text
31075 #: ../sys-utils/mount.8.adoc:415
31077 "Tolerate sloppy mount options rather than failing. This will ignore mount "
31078 "options not supported by a filesystem type. Not all filesystems support this "
31079 "option. Currently it's supported by the *mount.nfs* mount helper only."
31082 #. type: Labeled list
31083 #: ../sys-utils/mount.8.adoc:416
31085 msgid "*--source* _device_"
31088 #. type: Plain text
31089 #: ../sys-utils/mount.8.adoc:418
31091 "If only one argument for the *mount* command is given, then the argument "
31092 "might be interpreted as the target (mountpoint) or source (device). This "
31093 "option allows you to explicitly define that the argument is the mount source."
31096 #. type: Labeled list
31097 #: ../sys-utils/mount.8.adoc:419
31099 msgid "*--target* _directory_"
31102 #. type: Plain text
31103 #: ../sys-utils/mount.8.adoc:421
31105 "If only one argument for the mount command is given, then the argument might "
31106 "be interpreted as the target (mountpoint) or source (device). This option "
31107 "allows you to explicitly define that the argument is the mount target."
31110 #. type: Labeled list
31111 #: ../sys-utils/mount.8.adoc:422
31113 msgid "*--target-prefix* _directory_"
31116 #. type: Plain text
31117 #: ../sys-utils/mount.8.adoc:424
31119 "Prepend the specified directory to all mount targets. This option can be "
31120 "used to follow _fstab_, but mount operations are done in another place, for "
31124 #. type: Plain text
31125 #: ../sys-utils/mount.8.adoc:426
31127 msgid "*mount --all --target-prefix /chroot -o X-mount.mkdir*\n"
31130 #. type: Plain text
31131 #: ../sys-utils/mount.8.adoc:428
31133 "mounts all from system _fstab_ to _/chroot_, all missing mountpoint are "
31134 "created (due to X-mount.mkdir). See also *--fstab* to use an alternative "
31138 #. type: Labeled list
31139 #: ../sys-utils/mount.8.adoc:429 ../sys-utils/swapon.8.adoc:34
31141 #| msgid "*-f*, *--fast*"
31142 msgid "*-T*, *--fstab* _path_"
31143 msgstr "*-f*, *--fast*"
31145 #. type: Plain text
31146 #: ../sys-utils/mount.8.adoc:431
31148 "Specifies an alternative _fstab_ file. If _path_ is a directory, then the "
31149 "files in the directory are sorted by *strverscmp*(3); files that start with "
31150 "\".\" or without an _.fstab_ extension are ignored. The option can be "
31151 "specified more than once. This option is mostly designed for initramfs or "
31152 "chroot scripts where additional configuration is specified beyond standard "
31153 "system configuration."
31156 #. type: Plain text
31157 #: ../sys-utils/mount.8.adoc:433
31159 "Note that *mount* does not pass the option *--fstab* to the **/sbin/mount."
31160 "**__type__ helpers, meaning that the alternative _fstab_ files will be "
31161 "invisible for the helpers. This is no problem for normal mounts, but user "
31162 "(non-root) mounts always require _fstab_ to verify the user's rights."
31165 #. type: Labeled list
31166 #: ../sys-utils/mount.8.adoc:434
31168 msgid "*-t*, *--types* _fstype_"
31171 #. type: Plain text
31172 #: ../sys-utils/mount.8.adoc:436
31174 "The argument following the *-t* is used to indicate the filesystem type. The "
31175 "filesystem types which are currently supported depend on the running kernel. "
31176 "See _/proc/filesystems_ and _/lib/modules/$(uname -r)/kernel/fs_ for a "
31177 "complete list of the filesystems. The most common are ext2, ext3, ext4, xfs, "
31178 "btrfs, vfat, sysfs, proc, nfs and cifs."
31181 #. type: Plain text
31182 #: ../sys-utils/mount.8.adoc:438
31185 #| "*mount*(8) and *umount*(8) support filesystem _subtypes_. The subtype is "
31186 #| "defined by '.subtype' suffix. For example 'fuse.sshfs'. It's recommended "
31187 #| "to use subtype notation rather than add any prefix to the first fstab "
31188 #| "field (for example 'sshfs#example.com' is deprecated).\n"
31190 "The programs *mount* and *umount*(8) support filesystem subtypes. The "
31191 "subtype is defined by a '.subtype' suffix. For example 'fuse.sshfs'. It's "
31192 "recommended to use subtype notation rather than add any prefix to the mount "
31193 "source (for example 'sshfs#example.com' is deprecated)."
31195 "*mount*(8) a *umount*(8) podporují _podtypy_ souborových systémů. Podtyp se "
31196 "definuje pomocí přípony „.subtype“. Například „fuse.sshfs“. Je doporučeno "
31197 "použít zápis podtypem než přidávat předponu do první položky fstabu (příklad "
31198 "zastaralého použití je „sshfs#example.com“).\n"
31200 #. TRANSLATORS: Keep {asterisk} untranslated.
31201 #. type: Plain text
31202 #: ../sys-utils/mount.8.adoc:440
31204 "If no *-t* option is given, or if the *auto* type is specified, *mount* will "
31205 "try to guess the desired type. *mount* uses the *libblkid*(3) library for "
31206 "guessing the filesystem type; if that does not turn up anything that looks "
31207 "familiar, *mount* will try to read the file _/etc/filesystems_, or, if that "
31208 "does not exist, _/proc/filesystems_. All of the filesystem types listed "
31209 "there will be tried, except for those that are labeled \"nodev\" (e.g. "
31210 "_devpts_, _proc_ and _nfs_). If _/etc/filesystems_ ends in a line with a "
31211 "single {asterisk}, mount will read _/proc/filesystems_ afterwards. While "
31212 "trying, all filesystem types will be mounted with the mount option *silent*."
31215 #. type: Plain text
31216 #: ../sys-utils/mount.8.adoc:443
31218 "The *auto* type may be useful for user-mounted floppies. Creating a file _/"
31219 "etc/filesystems_ can be useful to change the probe order (e.g., to try vfat "
31220 "before msdos or ext3 before ext2) or if you use a kernel module autoloader."
31223 #. type: Plain text
31224 #: ../sys-utils/mount.8.adoc:445
31226 "More than one type may be specified in a comma-separated list, for the *-t* "
31227 "option as well as in an _/etc/fstab_ entry. The list of filesystem types for "
31228 "the *-t* option can be prefixed with *no* to specify the filesystem types on "
31229 "which no action should be taken. The prefix *no* has no effect when "
31230 "specified in an _/etc/fstab_ entry."
31233 #. type: Plain text
31234 #: ../sys-utils/mount.8.adoc:447
31236 "The prefix *no* can be meaningful with the *-a* option. For example, the "
31240 #. type: Plain text
31241 #: ../sys-utils/mount.8.adoc:449
31243 msgid "*mount -a -t nomsdos,smbfs*\n"
31246 #. type: Plain text
31247 #: ../sys-utils/mount.8.adoc:451
31248 msgid "mounts all filesystems except those of type _msdos_ and _smbfs_."
31251 #. type: Plain text
31252 #: ../sys-utils/mount.8.adoc:453
31254 "For most types all the *mount* program has to do is issue a simple "
31255 "*mount*(2) system call, and no detailed knowledge of the filesystem type is "
31256 "required. For a few types however (like nfs, nfs4, cifs, smbfs, ncpfs) an ad "
31257 "hoc code is necessary. The nfs, nfs4, cifs, smbfs, and ncpfs filesystems "
31258 "have a separate mount program. In order to make it possible to treat all "
31259 "types in a uniform way, *mount* will execute the program **/sbin/mount."
31260 "**__type__ (if that exists) when called with type _type_. Since different "
31261 "versions of the *smbmount* program have different calling conventions, */"
31262 "sbin/mount.smbfs* may have to be a shell script that sets up the desired "
31266 #. type: Plain text
31267 #: ../sys-utils/mount.8.adoc:456
31268 msgid "Mount the partition that has the specified _uuid_."
31271 #. type: Labeled list
31272 #: ../sys-utils/mount.8.adoc:460
31274 #| msgid "*-*, *-l*, *--login*"
31275 msgid "*-w*, *--rw*, *--read-write*"
31276 msgstr "*-*, *-l*, *--login*"
31278 #. type: Plain text
31279 #: ../sys-utils/mount.8.adoc:462
31281 "Mount the filesystem read/write. Read-write is the kernel default and the "
31282 "*mount* default is to try read-only if the previous *mount*(2) syscall with "
31283 "read-write flags on write-protected devices failed."
31286 #. type: Plain text
31287 #: ../sys-utils/mount.8.adoc:464
31288 msgid "A synonym is *-o rw*."
31291 #. type: Plain text
31292 #: ../sys-utils/mount.8.adoc:466
31294 "Note that specifying *-w* on the command line forces *mount* to never try "
31295 "read-only mount on write-protected devices or already mounted read-only "
31300 #: ../sys-utils/mount.8.adoc:469
31302 msgid "FILESYSTEM-INDEPENDENT MOUNT OPTIONS"
31305 #. type: Plain text
31306 #: ../sys-utils/mount.8.adoc:472
31308 "Some of these options are only useful when they appear in the _/etc/fstab_ "
31312 #. type: Plain text
31313 #: ../sys-utils/mount.8.adoc:474
31315 "Some of these options could be enabled or disabled by default in the system "
31316 "kernel. To check the current setting see the options in _/proc/mounts_. Note "
31317 "that filesystems also have per-filesystem specific default mount options "
31318 "(see for example *tune2fs -l* output for ext__N__ filesystems)."
31321 #. type: Plain text
31322 #: ../sys-utils/mount.8.adoc:476
31324 "The options *nosuid*, *noexec*, *nodiratime*, *relatime*, *noatime*, "
31325 "*strictatime*, and *nosymfollow* are interpreted only by the abstract VFS "
31326 "kernel layer and applied to the mountpoint node rather than to the "
31327 "filesystem itself. Try:"
31330 #. type: delimited block _
31331 #: ../sys-utils/mount.8.adoc:479
31333 msgid " findmnt -o TARGET,VFS-OPTIONS,FS-OPTIONS\n"
31336 #. type: Plain text
31337 #: ../sys-utils/mount.8.adoc:482
31338 msgid "to get a complete overview of filesystems and VFS options."
31341 #. type: Plain text
31342 #: ../sys-utils/mount.8.adoc:489
31344 "The read-only setting (*ro* or *rw*) is interpreted by VFS and the "
31345 "filesystem and depends on how the option is specified on the *mount*(8) "
31346 "command line. The default is to interpret it on the filesystem level. The "
31347 "operation \"-o bind,remount,ro\" is applied only to the VFS mountpoint, and "
31348 "operation \"-o remount,ro\" is applied to VFS and filesystem superblock. "
31349 "This semantic allows create a read-only mountpoint but keeps the filesystem "
31350 "writable from another mountpoint."
31353 #. type: Plain text
31354 #: ../sys-utils/mount.8.adoc:494
31356 "Since v2.39 libmount can use a new kernel mount interface to set the VFS "
31357 "options recursive. For backward compatibility, this feature is not enabled "
31358 "by default, although recursive operation (e.g. rbind) has been requested. "
31359 "The new option argument \"recursive\" could be specified, for example:"
31362 #. type: delimited block _
31363 #: ../sys-utils/mount.8.adoc:497
31365 msgid " mount -orbind,ro=recursive,noexec=recursive,nosuid /foo /bar\n"
31368 #. type: Plain text
31369 #: ../sys-utils/mount.8.adoc:502
31371 "recursively binds filesystems from /foo to /bar, /bar, and all submounts "
31372 "will be read-only and noexec, but only /bar itself will be \"nosuid\". The "
31373 "\"recursive\" optional argument for VFS mount options is an EXPERIMENTAL "
31377 #. type: Plain text
31378 #: ../sys-utils/mount.8.adoc:504
31380 "The following options apply to any filesystem that is being mounted (but not "
31381 "every filesystem actually honors them - e.g., the *sync* option today has an "
31382 "effect only for ext2, ext3, ext4, fat, vfat, ufs and xfs):"
31385 #. type: Labeled list
31386 #: ../sys-utils/mount.8.adoc:505
31391 #. type: Plain text
31392 #: ../sys-utils/mount.8.adoc:507
31394 "All I/O to the filesystem should be done asynchronously. (See also the "
31398 #. type: Labeled list
31399 #: ../sys-utils/mount.8.adoc:508
31404 #. type: Plain text
31405 #: ../sys-utils/mount.8.adoc:510
31407 "Do not use the *noatime* feature, so the inode access time is controlled by "
31408 "kernel defaults. See also the descriptions of the *relatime* and "
31409 "*strictatime* mount options."
31412 #. type: Labeled list
31413 #: ../sys-utils/mount.8.adoc:511
31415 #| msgid "*noauto*"
31419 #. type: Plain text
31420 #: ../sys-utils/mount.8.adoc:513
31422 "Do not update inode access times on this filesystem (e.g. for faster access "
31423 "on the news spool to speed up news servers). This works for all inode types "
31424 "(directories too), so it implies *nodiratime*."
31427 #. type: Labeled list
31428 #: ../sys-utils/mount.8.adoc:514
31430 #| msgid "*noauto*"
31434 #. type: Plain text
31435 #: ../sys-utils/mount.8.adoc:516
31437 #| msgid "Pass _command_ to the shell with the *-c* option."
31438 msgid "Can be mounted with the *-a* option."
31439 msgstr "Předá _příkaz_ shellu pomocí přepínače *-c*."
31441 #. type: Plain text
31442 #: ../sys-utils/mount.8.adoc:519
31444 "Can only be mounted explicitly (i.e., the *-a* option will not cause the "
31445 "filesystem to be mounted)."
31448 #. type: Labeled list
31449 #: ../sys-utils/mount.8.adoc:520
31451 msgid "**context=**__context__, **fscontext=**__context__, **defcontext=**__context__, and **rootcontext=**__context__"
31454 #. type: Plain text
31455 #: ../sys-utils/mount.8.adoc:522
31457 "The *context=* option is useful when mounting filesystems that do not "
31458 "support extended attributes, such as a floppy or hard disk formatted with "
31459 "VFAT, or systems that are not normally running under SELinux, such as an "
31460 "ext3 or ext4 formatted disk from a non-SELinux workstation. You can also use "
31461 "*context=* on filesystems you do not trust, such as a floppy. It also helps "
31462 "in compatibility with xattr-supporting filesystems on earlier 2.4.<x> kernel "
31463 "versions. Even where xattrs are supported, you can save time not having to "
31464 "label every file by assigning the entire disk one security context."
31467 #. type: Plain text
31468 #: ../sys-utils/mount.8.adoc:524
31470 "A commonly used option for removable media is *context=\"system_u:object_r:"
31474 #. type: Plain text
31475 #: ../sys-utils/mount.8.adoc:526
31477 "The *fscontext=* option works for all filesystems, regardless of their xattr "
31478 "support. The fscontext option sets the overarching filesystem label to a "
31479 "specific security context. This filesystem label is separate from the "
31480 "individual labels on the files. It represents the entire filesystem for "
31481 "certain kinds of permission checks, such as during mount or file creation. "
31482 "Individual file labels are still obtained from the xattrs on the files "
31483 "themselves. The context option actually sets the aggregate context that "
31484 "fscontext provides, in addition to supplying the same label for individual "
31488 #. type: Plain text
31489 #: ../sys-utils/mount.8.adoc:528
31491 "You can set the default security context for unlabeled files using "
31492 "*defcontext=* option. This overrides the value set for unlabeled files in "
31493 "the policy and requires a filesystem that supports xattr labeling."
31496 #. type: Plain text
31497 #: ../sys-utils/mount.8.adoc:530
31499 "The *rootcontext=* option allows you to explicitly label the root inode of a "
31500 "FS being mounted before that FS or inode becomes visible to userspace. This "
31501 "was found to be useful for things like stateless Linux. The special value "
31502 "*@target* can be used to assign the current context of the target mountpoint "
31506 #. type: Plain text
31507 #: ../sys-utils/mount.8.adoc:532
31509 "Note that the kernel rejects any remount request that includes the context "
31510 "option, *even* when unchanged from the current context."
31513 #. type: Plain text
31514 #: ../sys-utils/mount.8.adoc:534
31516 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"
31519 #. type: delimited block .
31520 #: ../sys-utils/mount.8.adoc:539
31523 "mount -t tmpfs none /mnt -o \\\n"
31524 "'context=\"system_u:object_r:tmp_t:s0:c127,c456\",noexec'\n"
31527 #. type: delimited block _
31528 #: ../sys-utils/mount.8.adoc:543
31529 msgid "For more details, see *selinux*(8)."
31532 #. type: delimited block _
31533 #: ../sys-utils/mount.8.adoc:546
31535 #| msgid "use default options: rw, suid, dev, exec, auto, nouser, and async."
31537 "Use the default options: *rw*, *suid*, *dev*, *exec*, *auto*, *nouser*, and "
31539 msgstr "použije výchozí volby: rw, suid, dev, exec, auto, nouser a async."
31541 #. type: delimited block _
31542 #: ../sys-utils/mount.8.adoc:548
31544 "Note that the real set of all default mount options depends on the kernel "
31545 "and filesystem type. See the beginning of this section for more details."
31548 #. type: Labeled list
31549 #: ../sys-utils/mount.8.adoc:549
31554 #. type: delimited block _
31555 #: ../sys-utils/mount.8.adoc:551
31556 msgid "Interpret character or block special devices on the filesystem."
31559 #. type: Labeled list
31560 #: ../sys-utils/mount.8.adoc:552
31565 #. type: delimited block _
31566 #: ../sys-utils/mount.8.adoc:554
31567 msgid "Do not interpret character or block special devices on the filesystem."
31570 #. type: Labeled list
31571 #: ../sys-utils/mount.8.adoc:555
31576 #. type: delimited block _
31577 #: ../sys-utils/mount.8.adoc:557
31579 "Update directory inode access times on this filesystem. This is the default. "
31580 "(This option is ignored when *noatime* is set.)"
31583 #. type: Labeled list
31584 #: ../sys-utils/mount.8.adoc:558
31586 msgid "*nodiratime*"
31589 #. type: delimited block _
31590 #: ../sys-utils/mount.8.adoc:560
31592 "Do not update directory inode access times on this filesystem. (This option "
31593 "is implied when *noatime* is set.)"
31596 #. type: Labeled list
31597 #: ../sys-utils/mount.8.adoc:561
31602 #. type: delimited block _
31603 #: ../sys-utils/mount.8.adoc:563
31605 "All directory updates within the filesystem should be done synchronously. "
31606 "This affects the following system calls: *creat*(2), *link*(2), *unlink*(2), "
31607 "*symlink*(2), *mkdir*(2), *rmdir*(2), *mknod*(2) and *rename*(2)."
31610 #. type: Labeled list
31611 #: ../sys-utils/mount.8.adoc:564
31616 #. type: delimited block _
31617 #: ../sys-utils/mount.8.adoc:566
31618 msgid "Permit execution of binaries and other executable files."
31621 #. type: Labeled list
31622 #: ../sys-utils/mount.8.adoc:567
31627 #. type: delimited block _
31628 #: ../sys-utils/mount.8.adoc:569
31630 "Do not permit direct execution of any binaries on the mounted filesystem."
31633 #. type: Labeled list
31634 #: ../sys-utils/mount.8.adoc:570
31639 #. type: delimited block _
31640 #: ../sys-utils/mount.8.adoc:572
31642 "Allow an ordinary user to mount the filesystem if one of that user's groups "
31643 "matches the group of the device. This option implies the options *nosuid* "
31644 "and *nodev* (unless overridden by subsequent options, as in the option line "
31645 "*group,dev,suid*)."
31648 #. type: Labeled list
31649 #: ../sys-utils/mount.8.adoc:573
31651 #| msgid "*-V*, *--version*"
31653 msgstr "*-V*, *--version*"
31655 #. type: delimited block _
31656 #: ../sys-utils/mount.8.adoc:575
31658 "Every time the inode is modified, the i_version field will be incremented."
31661 #. type: Labeled list
31662 #: ../sys-utils/mount.8.adoc:576
31664 #| msgid "*-V*, *--version*"
31665 msgid "*noiversion*"
31666 msgstr "*-V*, *--version*"
31668 #. type: delimited block _
31669 #: ../sys-utils/mount.8.adoc:578
31670 msgid "Do not increment the i_version inode field."
31673 #. type: Labeled list
31674 #: ../sys-utils/mount.8.adoc:579
31679 #. type: delimited block _
31680 #: ../sys-utils/mount.8.adoc:581
31682 "Allow mandatory locks on this filesystem. See *fcntl*(2). This option was "
31683 "deprecated in Linux 5.15."
31686 #. type: Labeled list
31687 #: ../sys-utils/mount.8.adoc:582
31692 #. type: delimited block _
31693 #: ../sys-utils/mount.8.adoc:584
31694 msgid "Do not allow mandatory locks on this filesystem."
31697 #. type: Labeled list
31698 #: ../sys-utils/mount.8.adoc:585
31703 #. type: delimited block _
31704 #: ../sys-utils/mount.8.adoc:587
31706 "The filesystem resides on a device that requires network access (used to "
31707 "prevent the system from attempting to mount these filesystems until the "
31708 "network has been enabled on the system)."
31711 #. type: delimited block _
31712 #: ../sys-utils/mount.8.adoc:590
31714 #| msgid "do not report errors for this device if it does not exist."
31715 msgid "Do not report errors for this device if it does not exist."
31716 msgstr "nehlásí chyby k tomuto zařízení, pokud toto zařízení neexistuje."
31718 #. type: Labeled list
31719 #: ../sys-utils/mount.8.adoc:591
31724 #. type: delimited block _
31725 #: ../sys-utils/mount.8.adoc:593
31727 "Update inode access times relative to modify or change time. Access time is "
31728 "only updated if the previous access time was earlier than or equal to the "
31729 "current modify or change time. (Similar to *noatime*, but it doesn't break "
31730 "*mutt*(1) or other applications that need to know if a file has been read "
31731 "since the last time it was modified.)"
31734 #. type: delimited block _
31735 #: ../sys-utils/mount.8.adoc:595
31737 "Since Linux 2.6.30, the kernel defaults to the behavior provided by this "
31738 "option (unless *noatime* was specified), and the *strictatime* option is "
31739 "required to obtain traditional semantics. In addition, since Linux 2.6.30, "
31740 "the file's last access time is always updated if it is more than 1 day old."
31743 #. type: Labeled list
31744 #: ../sys-utils/mount.8.adoc:596
31746 msgid "*norelatime*"
31749 #. type: delimited block _
31750 #: ../sys-utils/mount.8.adoc:598
31752 "Do not use the *relatime* feature. See also the *strictatime* mount option."
31755 #. type: Labeled list
31756 #: ../sys-utils/mount.8.adoc:599
31758 msgid "*strictatime*"
31761 #. type: delimited block _
31762 #: ../sys-utils/mount.8.adoc:601
31764 "Allows to explicitly request full atime updates. This makes it possible for "
31765 "the kernel to default to *relatime* or *noatime* but still allow userspace "
31766 "to override it. For more details about the default system mount options see "
31770 #. type: Labeled list
31771 #: ../sys-utils/mount.8.adoc:602
31773 msgid "*nostrictatime*"
31776 #. type: delimited block _
31777 #: ../sys-utils/mount.8.adoc:604
31778 msgid "Use the kernel's default behavior for inode access time updates."
31781 #. type: Labeled list
31782 #: ../sys-utils/mount.8.adoc:605
31787 #. type: delimited block _
31788 #: ../sys-utils/mount.8.adoc:607
31790 "Only update times (atime, mtime, ctime) on the in-memory version of the file "
31794 #. type: delimited block _
31795 #: ../sys-utils/mount.8.adoc:609
31797 "This mount option significantly reduces writes to the inode table for "
31798 "workloads that perform frequent random writes to preallocated files."
31801 #. type: delimited block _
31802 #: ../sys-utils/mount.8.adoc:611
31803 msgid "The on-disk timestamps are updated only when:"
31806 #. type: delimited block _
31807 #: ../sys-utils/mount.8.adoc:613
31809 "the inode needs to be updated for some change unrelated to file timestamps"
31812 #. type: delimited block _
31813 #: ../sys-utils/mount.8.adoc:614
31814 msgid "the application employs *fsync*(2), *syncfs*(2), or *sync*(2)"
31817 #. type: delimited block _
31818 #: ../sys-utils/mount.8.adoc:615
31819 msgid "an undeleted inode is evicted from memory"
31822 #. type: delimited block _
31823 #: ../sys-utils/mount.8.adoc:616
31824 msgid "more than 24 hours have passed since the inode was written to disk."
31827 #. type: Labeled list
31828 #: ../sys-utils/mount.8.adoc:617
31830 msgid "*nolazytime*"
31833 #. type: delimited block _
31834 #: ../sys-utils/mount.8.adoc:619
31835 msgid "Do not use the lazytime feature."
31838 #. type: Labeled list
31839 #: ../sys-utils/mount.8.adoc:620
31844 #. type: delimited block _
31845 #: ../sys-utils/mount.8.adoc:622
31847 "Honor set-user-ID and set-group-ID bits or file capabilities when executing "
31848 "programs from this filesystem."
31851 #. type: Labeled list
31852 #: ../sys-utils/mount.8.adoc:623
31857 #. type: delimited block _
31858 #: ../sys-utils/mount.8.adoc:625
31860 "Do not honor set-user-ID and set-group-ID bits or file capabilities when "
31861 "executing programs from this filesystem. In addition, SELinux domain "
31862 "transitions require permission _nosuid_transition_, which in turn needs also "
31863 "policy capability _nnp_nosuid_transition_."
31866 #. type: Labeled list
31867 #: ../sys-utils/mount.8.adoc:626
31872 #. type: delimited block _
31873 #: ../sys-utils/mount.8.adoc:628
31874 msgid "Turn on the silent flag."
31877 #. type: Labeled list
31878 #: ../sys-utils/mount.8.adoc:629
31883 #. type: delimited block _
31884 #: ../sys-utils/mount.8.adoc:631
31885 msgid "Turn off the silent flag."
31888 #. type: delimited block _
31889 #: ../sys-utils/mount.8.adoc:634
31891 "Allow an ordinary user to mount the filesystem if that user is the owner of "
31892 "the device. This option implies the options *nosuid* and *nodev* (unless "
31893 "overridden by subsequent options, as in the option line *owner,dev,suid*)."
31896 #. type: Labeled list
31897 #: ../sys-utils/mount.8.adoc:635
31902 #. type: delimited block _
31903 #: ../sys-utils/mount.8.adoc:637
31905 "Attempt to remount an already-mounted filesystem. This is commonly used to "
31906 "change the mount flags for a filesystem, especially to make a readonly "
31907 "filesystem writable. It does not change device or mount point."
31910 #. type: delimited block _
31911 #: ../sys-utils/mount.8.adoc:639
31913 "The remount operation together with the *bind* flag has special semantics. "
31914 "See above, the subsection *Bind mount operation*."
31917 #. type: delimited block _
31918 #: ../sys-utils/mount.8.adoc:648
31920 "The default kernel behavior for VFS mount flags (nodev,nosuid,noexec,ro) is "
31921 "to reset all unspecified flags on remount. That's why *mount*(8) tries to "
31922 "keep the current setting according to _fstab_ or _/proc/self/mountinfo_. "
31923 "This default behavior is possible to change by *--options-mode*. The "
31924 "recursive change of the mount flags (supported since v2.39 on systems with "
31925 "*mount_setattr*(2) syscall), for example, *mount -o remount,ro=recursive*, "
31926 "do not use \"reset-unspecified\" behavior, and it works as a simple add/"
31927 "remove operation and unspecified flags are not modified."
31930 #. type: delimited block _
31931 #: ../sys-utils/mount.8.adoc:650
31933 "The remount functionality follows the standard way the *mount* command works "
31934 "with options from _fstab_. This means that *mount* does not read _fstab_ (or "
31935 "_mtab_) only when both _device_ and _dir_ are specified."
31938 #. type: delimited block _
31939 #: ../sys-utils/mount.8.adoc:652
31941 msgid "*mount -o remount,rw /dev/foo /dir*\n"
31944 #. type: delimited block _
31945 #: ../sys-utils/mount.8.adoc:654
31947 "After this call all old mount options are replaced and arbitrary stuff from "
31948 "_fstab_ (or _mtab_) is ignored, except the *loop=* option which is "
31949 "internally generated and maintained by the *mount* command."
31952 #. type: delimited block _
31953 #: ../sys-utils/mount.8.adoc:656
31955 msgid "*mount -o remount,rw /dir*\n"
31958 #. type: delimited block _
31959 #: ../sys-utils/mount.8.adoc:658
31961 "After this call, *mount* reads _fstab_ and merges these options with the "
31962 "options from the command line (*-o*). If no mountpoint is found in _fstab_, "
31963 "then it defaults to mount options from _/proc/self/mountinfo_."
31966 #. type: delimited block _
31967 #: ../sys-utils/mount.8.adoc:661
31969 msgid "*mount* allows the use of *--all* to remount all already mounted filesystems which match a specified filter (*-O* and *-t*). For example:\n"
31972 #. type: delimited block _
31973 #: ../sys-utils/mount.8.adoc:663
31975 msgid "*mount --all -o remount,ro -t vfat*\n"
31978 #. type: delimited block _
31979 #: ../sys-utils/mount.8.adoc:665
31981 "remounts all already mounted vfat filesystems in read-only mode. Each of the "
31982 "filesystems is remounted by *mount -o remount,ro* _/dir_ semantic. This "
31983 "means the *mount* command reads _fstab_ or _mtab_ and merges these options "
31984 "with the options from the command line."
31987 #. type: Labeled list
31988 #: ../sys-utils/mount.8.adoc:666
31993 #. type: delimited block _
31994 #: ../sys-utils/mount.8.adoc:668
31995 msgid "Mount the filesystem read-only."
31998 #. type: Labeled list
31999 #: ../sys-utils/mount.8.adoc:669
32004 #. type: delimited block _
32005 #: ../sys-utils/mount.8.adoc:671
32006 msgid "Mount the filesystem read-write."
32009 #. type: Labeled list
32010 #: ../sys-utils/mount.8.adoc:672
32015 #. type: delimited block _
32016 #: ../sys-utils/mount.8.adoc:674
32018 "All I/O to the filesystem should be done synchronously. In the case of media "
32019 "with a limited number of write cycles (e.g. some flash drives), *sync* may "
32020 "cause life-cycle shortening."
32023 #. type: delimited block _
32024 #: ../sys-utils/mount.8.adoc:677
32026 "Allow an ordinary user to mount the filesystem. The name of the mounting "
32027 "user is written to the _mtab_ file (or to the private libmount file in _/run/"
32028 "mount_ on systems without a regular _mtab_) so that this same user can "
32029 "unmount the filesystem again. This option implies the options *noexec*, "
32030 "*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
32031 "option line *user,exec,dev,suid*)."
32034 #. type: Labeled list
32035 #: ../sys-utils/mount.8.adoc:678
32041 #. type: delimited block _
32042 #: ../sys-utils/mount.8.adoc:680
32044 "Forbid an ordinary user to mount the filesystem. This is the default; it "
32045 "does not imply any other options."
32048 #. type: Labeled list
32049 #: ../sys-utils/mount.8.adoc:681
32055 #. type: delimited block _
32056 #: ../sys-utils/mount.8.adoc:683
32058 "Allow any user to mount and to unmount the filesystem, even when some other "
32059 "ordinary user mounted it. This option implies the options *noexec*, "
32060 "*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
32061 "option line *users,exec,dev,suid*)."
32064 #. type: Labeled list
32065 #: ../sys-utils/mount.8.adoc:684
32070 #. type: delimited block _
32071 #: ../sys-utils/mount.8.adoc:686
32073 "All options prefixed with \"X-\" are interpreted as comments or as userspace "
32074 "application-specific options. These options are not stored in user space (e."
32075 "g., _mtab_ file), nor sent to the mount._type_ helpers nor to the *mount*(2) "
32076 "system call. The suggested format is **X-**__appname__._option_."
32079 #. type: Labeled list
32080 #: ../sys-utils/mount.8.adoc:687
32085 #. type: delimited block _
32086 #: ../sys-utils/mount.8.adoc:689
32088 "The same as *X-** options, but stored permanently in user space. This means "
32089 "the options are also available for *umount*(8) or other operations. Note "
32090 "that maintaining mount options in user space is tricky, because it's "
32091 "necessary use libmount-based tools and there is no guarantee that the "
32092 "options will be always available (for example after a move mount operation "
32093 "or in unshared namespace)."
32096 #. type: delimited block _
32097 #: ../sys-utils/mount.8.adoc:691
32099 "Note that before util-linux v2.30 the x-* options have not been maintained "
32100 "by libmount and stored in user space (functionality was the same as for X-* "
32101 "now), but due to the growing number of use-cases (in initrd, systemd etc.) "
32102 "the functionality has been extended to keep existing _fstab_ configurations "
32103 "usable without a change."
32106 #. type: Labeled list
32107 #: ../sys-utils/mount.8.adoc:692
32109 #| msgid "*-P*, *--pty*"
32110 msgid "*X-mount.auto-fstypes*=_list_"
32111 msgstr "*-P*, *--pty*"
32113 #. type: delimited block _
32114 #: ../sys-utils/mount.8.adoc:695
32116 "Specifies allowed or forbidden filesystem types for automatic filesystem "
32120 #. type: delimited block _
32121 #: ../sys-utils/mount.8.adoc:699
32123 "The _list_ is a comma-separated list of the filesystem names. The automatic "
32124 "filesystem detection is triggered by the \"auto\" filesystem type or when "
32125 "the filesystem type is not specified."
32128 #. type: delimited block _
32129 #: ../sys-utils/mount.8.adoc:704
32131 "The _list_ follows how mount evaluates type patterns (see *-t* for more "
32132 "details). Only specified filesystem types are allowed, or all specified "
32133 "types are forbidden if the list is prefixed by \"no\"."
32136 #. type: delimited block _
32137 #: ../sys-utils/mount.8.adoc:708
32139 "For example, X-mount.auto-fstypes=\"ext4,btrfs\" accepts only ext4 and "
32140 "btrfs, and X-mount.auto-fstypes=\"novfat,xfs\" accepts all filesystems "
32141 "except vfat and xfs."
32144 #. type: delimited block _
32145 #: ../sys-utils/mount.8.adoc:712
32147 "Note that comma is used as a separator between mount options, it means that "
32148 "auto-fstypes values have to be properly quoted, donâ
\80\99t forget that the shell "
32149 "strips off quotes and thus double quoting is required. For example:"
32152 #. type: Plain text
32153 #: ../sys-utils/mount.8.adoc:714
32155 "mount -t auto -o'X-mount.auto-fstypes=\"noext2,ext3\"' /dev/sdc1 /mnt/test"
32158 #. type: Labeled list
32159 #: ../sys-utils/mount.8.adoc:716
32161 msgid "*X-mount.mkdir*[=_mode_]"
32164 #. type: delimited block _
32165 #: ../sys-utils/mount.8.adoc:718
32167 "Allow to make a target directory (mountpoint) if it does not exist yet. The "
32168 "optional argument _mode_ specifies the filesystem access mode used for "
32169 "*mkdir*(2) in octal notation. The default mode is 0755. This functionality "
32170 "is supported only for root users or when *mount* is executed without suid "
32171 "permissions. The option is also supported as *x-mount.mkdir*, but this "
32172 "notation is deprecated since v2.30. See also *--mkdir* command line option."
32175 #. type: Labeled list
32176 #: ../sys-utils/mount.8.adoc:719
32178 msgid "**X-mount.subdir=**__directory__"
32181 #. type: delimited block _
32182 #: ../sys-utils/mount.8.adoc:721
32184 "Allow mounting sub-directory from a filesystem instead of the root "
32185 "directory. For now, this feature is implemented by temporary filesystem root "
32186 "directory mount in unshared namespace and then bind the sub-directory to the "
32187 "final mount point and umount the root of the filesystem. The sub-directory "
32188 "mount shows up atomically for the rest of the system although it is "
32189 "implemented by multiple *mount*(2) syscalls."
32192 #. type: delimited block _
32193 #: ../sys-utils/mount.8.adoc:723
32195 "Note that this feature will not work in session with an unshared private "
32196 "mount namespace (after *unshare --mount*) on old kernels or with *mount*(8) "
32197 "without support for file-descriptors-based mount kernel API. In this case, "
32198 "you need *unshare --mount --propagation shared*."
32201 #. type: delimited block _
32202 #: ../sys-utils/mount.8.adoc:725
32203 msgid "This feature is EXPERIMENTAL."
32206 #. type: Labeled list
32207 #: ../sys-utils/mount.8.adoc:726
32209 msgid "*X-mount.owner*=_username_|_UID_, *X-mount.group*=_group_|_GID_"
32212 #. type: delimited block _
32213 #: ../sys-utils/mount.8.adoc:728
32215 "Set _mountpoint_'s ownership after mounting. Names resolved in the target "
32216 "mount namespace, see *-N*."
32219 #. type: Labeled list
32220 #: ../sys-utils/mount.8.adoc:729
32222 msgid "*X-mount.mode*=_mode_"
32225 #. type: delimited block _
32226 #: ../sys-utils/mount.8.adoc:731
32227 msgid "Set _mountpoint_'s mode after mounting."
32230 #. type: Labeled list
32231 #: ../sys-utils/mount.8.adoc:732
32233 msgid "*X-mount.idmap*=__id-type__:__id-mount__:__id-host__:__id-range__ [__id-type__:__id-mount__:__id-host__:__id-range__], *X-mount.idmap*=__file__"
32236 #. type: delimited block _
32237 #: ../sys-utils/mount.8.adoc:737
32239 "Use this option to create an idmapped mount. An idmapped mount allows to "
32240 "change ownership of all files located under a mount according to the ID-"
32241 "mapping associated with a user namespace. The ownership change is tied to "
32242 "the lifetime and localized to the relevant mount. The relevant ID-mapping "
32243 "can be specified in two ways:"
32246 #. type: delimited block _
32247 #: ../sys-utils/mount.8.adoc:739
32248 msgid "A user can specify the ID-mapping directly."
32251 #. type: delimited block _
32252 #: ../sys-utils/mount.8.adoc:747
32254 "The ID-mapping must be specified using the syntax __id-type__:__id-mount__:"
32255 "__id-host__:__id-range__. Specifying *u* as the __id-type__ prefix creates "
32256 "a UID-mapping, *g* creates a GID-mapping and omitting __id-type__ or "
32257 "specifying *b* creates both a UID- and GID-mapping. The __id-mount__ "
32258 "parameter indicates the starting ID in the new mount. The __id-host__ "
32259 "parameter indicates the starting ID in the filesystem. The __id-range__ "
32260 "parameter indicates how many IDs are to be mapped. It is possible to "
32261 "specify multiple ID-mappings. The individual ID-mappings must be separated "
32265 #. type: delimited block _
32266 #: ../sys-utils/mount.8.adoc:750
32268 "For example, the ID-mapping *X-mount.idmap=u:1000:0:1 g:1001:1:2 "
32269 "5000:1000:2* creates an idmapped mount where UID 0 is mapped to UID 1000, "
32270 "GID 1 is mapped to GUID 1001, GID 2 is mapped to GID 1002, UID and GID 1000 "
32271 "are mapped to 5000, and UID and GID 1001 are mapped to 5001 in the mount."
32274 #. type: delimited block _
32275 #: ../sys-utils/mount.8.adoc:753
32277 "When an ID-mapping is specified directly a new user namespace will be "
32278 "allocated with the requested ID-mapping. The newly created user namespace "
32279 "will be attached to the mount."
32282 #. type: delimited block _
32283 #: ../sys-utils/mount.8.adoc:754
32284 msgid "A user can specify a user namespace file."
32287 #. type: delimited block _
32288 #: ../sys-utils/mount.8.adoc:756
32290 "The user namespace will then be attached to the mount and the ID-mapping of "
32291 "the user namespace will become the ID-mapping of the mount."
32294 #. type: delimited block _
32295 #: ../sys-utils/mount.8.adoc:758
32297 "For example, *X-mount.idmap=/proc/PID/ns/user* will attach the user "
32298 "namespace of the process PID to the mount."
32301 #. type: Labeled list
32302 #: ../sys-utils/mount.8.adoc:759
32304 msgid "*nosymfollow*"
32307 #. type: delimited block _
32308 #: ../sys-utils/mount.8.adoc:761
32310 "Do not follow symlinks when resolving paths. Symlinks can still be created, "
32311 "and *readlink*(1), *readlink*(2), *realpath*(1), and *realpath*(3) all still "
32316 #: ../sys-utils/mount.8.adoc:762
32318 msgid "FILESYSTEM-SPECIFIC MOUNT OPTIONS"
32321 #. type: delimited block _
32322 #: ../sys-utils/mount.8.adoc:765
32324 "This section lists options that are specific to particular filesystems. "
32325 "Where possible, you should first consult filesystem-specific manual pages "
32326 "for details. Some of those pages are listed in the following table."
32330 #: ../sys-utils/mount.8.adoc:776
32333 "|*Filesystem(s)* |*Manual page*\n"
32334 "|btrfs |*btrfs*(5)\n"
32335 "|cifs |*mount.cifs*(8)\n"
32336 "|ext2, ext3, ext4 |*ext4*(5)\n"
32337 "|fuse |*fuse*(8)\n"
32339 "|tmpfs |*tmpfs*(5)\n"
32343 #. type: Plain text
32344 #: ../sys-utils/mount.8.adoc:779
32346 "Note that some of the pages listed above might be available only after you "
32347 "install the respective userland tools."
32350 #. type: Plain text
32351 #: ../sys-utils/mount.8.adoc:781
32353 "The following options apply only to certain filesystems. We sort them by "
32354 "filesystem. All options follow the *-o* flag."
32357 #. type: Plain text
32358 #: ../sys-utils/mount.8.adoc:783
32360 "What options are supported depends a bit on the running kernel. Further "
32361 "information may be available in filesystem-specific files in the kernel "
32362 "source subdirectory _Documentation/filesystems_."
32366 #: ../sys-utils/mount.8.adoc:784
32368 msgid "Mount options for adfs"
32371 #. type: Labeled list
32372 #: ../sys-utils/mount.8.adoc:786 ../sys-utils/mount.8.adoc:794
32373 #: ../sys-utils/mount.8.adoc:844 ../sys-utils/mount.8.adoc:875
32374 #: ../sys-utils/mount.8.adoc:1002 ../sys-utils/mount.8.adoc:1034
32376 msgid "**uid=**__value__ and **gid=**__value__"
32379 #. type: Plain text
32380 #: ../sys-utils/mount.8.adoc:788
32382 "Set the owner and group of the files in the filesystem (default: uid=gid=0)."
32385 #. type: Labeled list
32386 #: ../sys-utils/mount.8.adoc:789
32388 msgid "**ownmask=**__value__ and **othmask=**__value__"
32391 #. type: Plain text
32392 #: ../sys-utils/mount.8.adoc:791
32394 "Set the permission mask for ADFS 'owner' permissions and 'other' "
32395 "permissions, respectively (default: 0700 and 0077, respectively). See also _/"
32396 "usr/src/linux/Documentation/filesystems/adfs.rst_."
32400 #: ../sys-utils/mount.8.adoc:792
32402 msgid "Mount options for affs"
32405 #. type: Plain text
32406 #: ../sys-utils/mount.8.adoc:796
32408 "Set the owner and group of the root of the filesystem (default: uid=gid=0, "
32409 "but with option *uid* or *gid* without specified value, the UID and GID of "
32410 "the current process are taken)."
32413 #. type: Labeled list
32414 #: ../sys-utils/mount.8.adoc:797
32416 msgid "**setuid=**__value__ and **setgid=**__value__"
32419 #. type: Plain text
32420 #: ../sys-utils/mount.8.adoc:799
32421 msgid "Set the owner and group of all files."
32424 #. type: Labeled list
32425 #: ../sys-utils/mount.8.adoc:800 ../sys-utils/mount.8.adoc:837
32426 #: ../sys-utils/mount.8.adoc:847 ../sys-utils/mount.8.adoc:1040
32428 msgid "**mode=**__value__"
32431 #. type: Plain text
32432 #: ../sys-utils/mount.8.adoc:802
32434 "Set the mode of all files to _value_ & 0777 disregarding the original "
32435 "permissions. Add search permission to directories that have read permission. "
32436 "The value is given in octal."
32439 #. type: Labeled list
32440 #: ../sys-utils/mount.8.adoc:803
32445 #. type: Plain text
32446 #: ../sys-utils/mount.8.adoc:805
32447 msgid "Do not allow any changes to the protection bits on the filesystem."
32450 #. type: Labeled list
32451 #: ../sys-utils/mount.8.adoc:806
32457 #. type: Plain text
32458 #: ../sys-utils/mount.8.adoc:808
32460 "Set UID and GID of the root of the filesystem to the UID and GID of the "
32461 "mount point upon the first sync or umount, and then clear this option. "
32465 #. type: Labeled list
32466 #: ../sys-utils/mount.8.adoc:809
32471 #. type: Plain text
32472 #: ../sys-utils/mount.8.adoc:811
32473 msgid "Print an informational message for each successful mount."
32476 #. type: Labeled list
32477 #: ../sys-utils/mount.8.adoc:812
32479 msgid "**prefix=**__string__"
32482 #. type: Plain text
32483 #: ../sys-utils/mount.8.adoc:814
32484 msgid "Prefix used before volume name, when following a link."
32487 #. type: Labeled list
32488 #: ../sys-utils/mount.8.adoc:815
32490 msgid "**volume=**__string__"
32493 #. type: Plain text
32494 #: ../sys-utils/mount.8.adoc:817
32496 "Prefix (of length at most 30) used before '/' when following a symbolic link."
32499 #. type: Labeled list
32500 #: ../sys-utils/mount.8.adoc:818
32502 msgid "**reserved=**__value__"
32505 #. type: Plain text
32506 #: ../sys-utils/mount.8.adoc:820
32507 msgid "(Default: 2.) Number of unused blocks at the start of the device."
32510 #. type: Labeled list
32511 #: ../sys-utils/mount.8.adoc:821
32513 msgid "**root=**__value__"
32516 #. type: Plain text
32517 #: ../sys-utils/mount.8.adoc:823
32518 msgid "Give explicitly the location of the root block."
32521 #. type: Labeled list
32522 #: ../sys-utils/mount.8.adoc:824
32524 msgid "**bs=**__value__"
32527 #. type: Plain text
32528 #: ../sys-utils/mount.8.adoc:826
32529 msgid "Give blocksize. Allowed values are 512, 1024, 2048, 4096."
32532 #. type: Labeled list
32533 #: ../sys-utils/mount.8.adoc:827
32535 msgid "**grpquota**|**noquota**|**quota**|*usrquota*"
32538 #. type: Plain text
32539 #: ../sys-utils/mount.8.adoc:829
32541 "These options are accepted but ignored. (However, quota utilities may react "
32542 "to such strings in _/etc/fstab_.)"
32546 #: ../sys-utils/mount.8.adoc:830
32548 msgid "Mount options for debugfs"
32551 #. type: Plain text
32552 #: ../sys-utils/mount.8.adoc:833
32554 "The debugfs filesystem is a pseudo filesystem, traditionally mounted on _/"
32555 "sys/kernel/debug_. As of kernel version 3.4, debugfs has the following "
32559 #. type: Labeled list
32560 #: ../sys-utils/mount.8.adoc:834 ../sys-utils/mount.8.adoc:985
32562 msgid "**uid=**__n__**, gid=**__n__"
32565 #. type: Plain text
32566 #: ../sys-utils/mount.8.adoc:836
32567 msgid "Set the owner and group of the mountpoint."
32570 #. type: Plain text
32571 #: ../sys-utils/mount.8.adoc:839
32572 msgid "Sets the mode of the mountpoint."
32576 #: ../sys-utils/mount.8.adoc:840
32578 msgid "Mount options for devpts"
32581 #. type: Plain text
32582 #: ../sys-utils/mount.8.adoc:843
32584 "The devpts filesystem is a pseudo filesystem, traditionally mounted on _/dev/"
32585 "pts_. In order to acquire a pseudo terminal, a process opens _/dev/ptmx_; "
32586 "the number of the pseudo terminal is then made available to the process and "
32587 "the pseudo terminal slave can be accessed as _/dev/pts/_<number>."
32590 #. type: Plain text
32591 #: ../sys-utils/mount.8.adoc:846
32593 "This sets the owner or the group of newly created pseudo terminals to the "
32594 "specified values. When nothing is specified, they will be set to the UID and "
32595 "GID of the creating process. For example, if there is a tty group with GID "
32596 "5, then *gid=5* will cause newly created pseudo terminals to belong to the "
32600 #. type: Plain text
32601 #: ../sys-utils/mount.8.adoc:849
32603 "Set the mode of newly created pseudo terminals to the specified value. The "
32604 "default is 0600. A value of *mode=620* and *gid=5* makes \"mesg y\" the "
32605 "default on newly created pseudo terminals."
32608 #. type: Labeled list
32609 #: ../sys-utils/mount.8.adoc:850
32611 msgid "*newinstance*"
32614 #. type: Plain text
32615 #: ../sys-utils/mount.8.adoc:852
32617 "Create a private instance of the devpts filesystem, such that indices of "
32618 "pseudo terminals allocated in this new instance are independent of indices "
32619 "created in other instances of devpts."
32622 #. type: Plain text
32623 #: ../sys-utils/mount.8.adoc:854
32625 "All mounts of devpts without this *newinstance* option share the same set of "
32626 "pseudo terminal indices (i.e., legacy mode). Each mount of devpts with the "
32627 "*newinstance* option has a private set of pseudo terminal indices."
32630 #. type: Plain text
32631 #: ../sys-utils/mount.8.adoc:856
32633 "This option is mainly used to support containers in the Linux kernel. It is "
32634 "implemented in Linux kernel versions starting with 2.6.29. Further, this "
32635 "mount option is valid only if *CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled "
32636 "in the kernel configuration."
32639 #. type: Plain text
32640 #: ../sys-utils/mount.8.adoc:858
32642 "To use this option effectively, _/dev/ptmx_ must be a symbolic link to _pts/"
32643 "ptmx_. See _Documentation/filesystems/devpts.txt_ in the Linux kernel source "
32644 "tree for details."
32647 #. type: Labeled list
32648 #: ../sys-utils/mount.8.adoc:859
32650 msgid "**ptmxmode=**__value__"
32653 #. type: Plain text
32654 #: ../sys-utils/mount.8.adoc:861
32655 msgid "Set the mode for the new _ptmx_ device node in the devpts filesystem."
32658 #. type: Plain text
32659 #: ../sys-utils/mount.8.adoc:863
32661 "With the support for multiple instances of devpts (see *newinstance* option "
32662 "above), each instance has a private _ptmx_ node in the root of the devpts "
32663 "filesystem (typically _/dev/pts/ptmx_)."
32666 #. type: Plain text
32667 #: ../sys-utils/mount.8.adoc:865
32669 "For compatibility with older versions of the kernel, the default mode of the "
32670 "new _ptmx_ node is 0000. **ptmxmode=**__value__ specifies a more useful mode "
32671 "for the _ptmx_ node and is highly recommended when the *newinstance* option "
32675 #. type: Plain text
32676 #: ../sys-utils/mount.8.adoc:867
32678 "This option is only implemented in Linux kernel versions starting with "
32679 "2.6.29. Further, this option is valid only if "
32680 "*CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled in the kernel configuration."
32684 #: ../sys-utils/mount.8.adoc:868
32686 msgid "Mount options for fat"
32689 #. type: Plain text
32690 #: ../sys-utils/mount.8.adoc:871
32692 "(Note: _fat_ is not a separate filesystem, but a common part of the _msdos_, "
32693 "_umsdos_ and _vfat_ filesystems.)"
32696 #. type: Labeled list
32697 #: ../sys-utils/mount.8.adoc:872
32699 msgid "*blocksize=*{**512**|**1024**|*2048*}"
32702 #. type: Plain text
32703 #: ../sys-utils/mount.8.adoc:874
32704 msgid "Set blocksize (default 512). This option is obsolete."
32707 #. type: Plain text
32708 #: ../sys-utils/mount.8.adoc:877 ../sys-utils/mount.8.adoc:987
32709 #: ../sys-utils/mount.8.adoc:1004
32711 "Set the owner and group of all files. (Default: the UID and GID of the "
32712 "current process.)"
32715 #. type: Labeled list
32716 #: ../sys-utils/mount.8.adoc:878 ../sys-utils/mount.8.adoc:1005
32718 msgid "**umask=**__value__"
32721 #. type: Plain text
32722 #: ../sys-utils/mount.8.adoc:880 ../sys-utils/mount.8.adoc:1007
32724 "Set the umask (the bitmask of the permissions that are *not* present). The "
32725 "default is the umask of the current process. The value is given in octal."
32728 #. type: Labeled list
32729 #: ../sys-utils/mount.8.adoc:881
32731 msgid "**dmask=**__value__"
32734 #. type: Plain text
32735 #: ../sys-utils/mount.8.adoc:883
32737 "Set the umask applied to directories only. The default is the umask of the "
32738 "current process. The value is given in octal."
32741 #. type: Labeled list
32742 #: ../sys-utils/mount.8.adoc:884
32744 msgid "**fmask=**__value__"
32747 #. type: Plain text
32748 #: ../sys-utils/mount.8.adoc:886
32750 "Set the umask applied to regular files only. The default is the umask of the "
32751 "current process. The value is given in octal."
32754 #. type: Labeled list
32755 #: ../sys-utils/mount.8.adoc:887
32757 msgid "**allow_utime=**__value__"
32760 #. type: Plain text
32761 #: ../sys-utils/mount.8.adoc:889
32762 msgid "This option controls the permission check of mtime/atime."
32765 #. type: Labeled list
32766 #: ../sys-utils/mount.8.adoc:890
32771 #. type: Plain text
32772 #: ../sys-utils/mount.8.adoc:892
32774 "If current process is in group of file's group ID, you can change timestamp."
32777 #. type: Plain text
32778 #: ../sys-utils/mount.8.adoc:895
32779 msgid "Other users can change timestamp."
32782 #. type: Plain text
32783 #: ../sys-utils/mount.8.adoc:897
32785 "The default is set from 'dmask' option. (If the directory is writable, "
32786 "*utime*(2) is also allowed. I.e. ~dmask & 022)"
32789 #. type: Plain text
32790 #: ../sys-utils/mount.8.adoc:899
32792 "Normally *utime*(2) checks that the current process is owner of the file, or "
32793 "that it has the *CAP_FOWNER* capability. But FAT filesystems don't have UID/"
32794 "GID on disk, so the normal check is too inflexible. With this option you can "
32798 #. type: Labeled list
32799 #: ../sys-utils/mount.8.adoc:900
32801 msgid "**check=**__value__"
32804 #. type: Plain text
32805 #: ../sys-utils/mount.8.adoc:902
32806 msgid "Three different levels of pickiness can be chosen:"
32809 #. type: Labeled list
32810 #: ../sys-utils/mount.8.adoc:903
32812 msgid "*r*[*elaxed*]"
32815 #. type: Plain text
32816 #: ../sys-utils/mount.8.adoc:905
32818 "Upper and lower case are accepted and equivalent, long name parts are "
32819 "truncated (e.g. _verylongname.foobar_ becomes _verylong.foo_), leading and "
32820 "embedded spaces are accepted in each name part (name and extension)."
32823 #. type: Labeled list
32824 #: ../sys-utils/mount.8.adoc:906
32826 msgid "*n*[*ormal*]"
32829 #. type: Plain text
32830 #: ../sys-utils/mount.8.adoc:908
32832 "Like \"relaxed\", but many special characters (*, ?, <, spaces, etc.) are "
32833 "rejected. This is the default."
32836 #. type: Labeled list
32837 #: ../sys-utils/mount.8.adoc:909
32839 msgid "*s*[*trict*]"
32842 #. type: Plain text
32843 #: ../sys-utils/mount.8.adoc:911
32845 "Like \"normal\", but names that contain long parts or special characters "
32846 "that are sometimes used on Linux but are not accepted by MS-DOS (+, =, etc.) "
32850 #. type: Labeled list
32851 #: ../sys-utils/mount.8.adoc:912
32853 msgid "**codepage=**__value__"
32856 #. type: Plain text
32857 #: ../sys-utils/mount.8.adoc:914
32859 "Sets the codepage for converting to shortname characters on FAT and VFAT "
32860 "filesystems. By default, codepage 437 is used."
32863 #. type: Labeled list
32864 #: ../sys-utils/mount.8.adoc:915 ../sys-utils/mount.8.adoc:1011
32865 #: ../sys-utils/mount.8.adoc:1049
32867 msgid "**conv=**__mode__"
32870 #. type: Plain text
32871 #: ../sys-utils/mount.8.adoc:917
32872 msgid "This option is obsolete and may fail or be ignored."
32875 #. type: Labeled list
32876 #: ../sys-utils/mount.8.adoc:918
32878 msgid "**cvf_format=**__module__"
32881 #. type: Plain text
32882 #: ../sys-utils/mount.8.adoc:920
32884 "Forces the driver to use the CVF (Compressed Volume File) module "
32885 "cvf___module__ instead of auto-detection. If the kernel supports *kmod*, the "
32886 "**cvf_format=**__xxx__ option also controls on-demand CVF module loading. "
32887 "This option is obsolete."
32890 #. type: Labeled list
32891 #: ../sys-utils/mount.8.adoc:921
32893 msgid "**cvf_option=**__option__"
32896 #. type: Plain text
32897 #: ../sys-utils/mount.8.adoc:923
32898 msgid "Option passed to the CVF module. This option is obsolete."
32901 #. type: Labeled list
32902 #: ../sys-utils/mount.8.adoc:924
32907 #. type: Plain text
32908 #: ../sys-utils/mount.8.adoc:926
32910 "Turn on the _debug_ flag. A version string and a list of filesystem "
32911 "parameters will be printed (these data are also printed if the parameters "
32912 "appear to be inconsistent)."
32915 #. type: Labeled list
32916 #: ../sys-utils/mount.8.adoc:927
32921 #. type: Plain text
32922 #: ../sys-utils/mount.8.adoc:929
32924 "If set, causes discard/TRIM commands to be issued to the block device when "
32925 "blocks are freed. This is useful for SSD devices and sparse/thinly-"
32926 "provisioned LUNs."
32929 #. type: Labeled list
32930 #: ../sys-utils/mount.8.adoc:930
32932 msgid "*dos1xfloppy*"
32935 #. type: Plain text
32936 #: ../sys-utils/mount.8.adoc:932
32938 "If set, use a fallback default BIOS Parameter Block configuration, "
32939 "determined by backing device size. These static parameters match defaults "
32940 "assumed by DOS 1.x for 160 kiB, 180 kiB, 320 kiB, and 360 kiB floppies and "
32944 #. type: Labeled list
32945 #: ../sys-utils/mount.8.adoc:933
32947 msgid "*errors=*{**panic**|**continue**|*remount-ro*}"
32950 #. type: Plain text
32951 #: ../sys-utils/mount.8.adoc:935
32953 "Specify FAT behavior on critical errors: panic, continue without doing "
32954 "anything, or remount the partition in read-only mode (default behavior)."
32957 #. type: Labeled list
32958 #: ../sys-utils/mount.8.adoc:936
32960 msgid "*fat=*{**12**|**16**|*32*}"
32963 #. type: Plain text
32964 #: ../sys-utils/mount.8.adoc:938
32966 "Specify a 12, 16 or 32 bit fat. This overrides the automatic FAT type "
32967 "detection routine. Use with caution!"
32970 #. type: Labeled list
32971 #: ../sys-utils/mount.8.adoc:939 ../sys-utils/mount.8.adoc:1063
32973 msgid "**iocharset=**__value__"
32976 #. type: Plain text
32977 #: ../sys-utils/mount.8.adoc:941
32979 "Character set to use for converting between 8 bit characters and 16 bit "
32980 "Unicode characters. The default is iso8859-1. Long filenames are stored on "
32981 "disk in Unicode format."
32984 #. type: Labeled list
32985 #: ../sys-utils/mount.8.adoc:942
32987 msgid "*nfs=*{**stale_rw**|*nostale_ro*}"
32990 #. type: Plain text
32991 #: ../sys-utils/mount.8.adoc:944
32992 msgid "Enable this only if you want to export the FAT filesystem over NFS."
32995 #. type: Plain text
32996 #: ../sys-utils/mount.8.adoc:946
32998 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"
33001 #. type: Plain text
33002 #: ../sys-utils/mount.8.adoc:948
33004 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"
33007 #. type: Plain text
33008 #: ../sys-utils/mount.8.adoc:950
33010 "To maintain backward compatibility, *-o nfs* is also accepted, defaulting to "
33014 #. type: Labeled list
33015 #: ../sys-utils/mount.8.adoc:951
33020 #. type: Plain text
33021 #: ../sys-utils/mount.8.adoc:953
33023 "This option disables the conversion of timestamps between local time (as "
33024 "used by Windows on FAT) and UTC (which Linux uses internally). This is "
33025 "particularly useful when mounting devices (like digital cameras) that are "
33026 "set to UTC in order to avoid the pitfalls of local time."
33029 #. type: Labeled list
33030 #: ../sys-utils/mount.8.adoc:954
33032 msgid "**time_offset=**__minutes__"
33035 #. type: Plain text
33036 #: ../sys-utils/mount.8.adoc:956
33038 "Set offset for conversion of timestamps from local time used by FAT to UTC. "
33039 "I.e., _minutes_ will be subtracted from each timestamp to convert it to UTC "
33040 "used internally by Linux. This is useful when the time zone set in the "
33041 "kernel via *settimeofday*(2) is not the time zone used by the filesystem. "
33042 "Note that this option still does not provide correct time stamps in all "
33043 "cases in presence of DST - time stamps in a different DST setting will be "
33047 #. type: Labeled list
33048 #: ../sys-utils/mount.8.adoc:957 ../sys-utils/mount.8.adoc:997
33053 #. type: Plain text
33054 #: ../sys-utils/mount.8.adoc:959
33056 "Turn on the _quiet_ flag. Attempts to chown or chmod files do not return "
33057 "errors, although they fail. Use with caution!"
33060 #. type: Labeled list
33061 #: ../sys-utils/mount.8.adoc:960
33066 #. type: Plain text
33067 #: ../sys-utils/mount.8.adoc:962
33069 "FAT has the *ATTR_RO* (read-only) attribute. On Windows, the *ATTR_RO* of "
33070 "the directory will just be ignored, and is used only by applications as a "
33071 "flag (e.g. it's set for the customized folder)."
33074 #. type: Plain text
33075 #: ../sys-utils/mount.8.adoc:964
33077 "If you want to use *ATTR_RO* as read-only flag even for the directory, set "
33081 #. type: Labeled list
33082 #: ../sys-utils/mount.8.adoc:965
33087 #. type: Plain text
33088 #: ../sys-utils/mount.8.adoc:967
33090 "If set, the execute permission bits of the file will be allowed only if the "
33091 "extension part of the name is .EXE, .COM, or .BAT. Not set by default."
33094 #. type: Labeled list
33095 #: ../sys-utils/mount.8.adoc:968
33097 msgid "*sys_immutable*"
33100 #. type: Plain text
33101 #: ../sys-utils/mount.8.adoc:970
33103 "If set, *ATTR_SYS* attribute on FAT is handled as *IMMUTABLE* flag on Linux. "
33104 "Not set by default."
33107 #. type: Labeled list
33108 #: ../sys-utils/mount.8.adoc:971
33113 #. type: Plain text
33114 #: ../sys-utils/mount.8.adoc:973
33116 "If set, the filesystem will try to flush to disk more early than normal. Not "
33120 #. type: Labeled list
33121 #: ../sys-utils/mount.8.adoc:974
33127 #. type: Plain text
33128 #: ../sys-utils/mount.8.adoc:976
33130 "Use the \"free clusters\" value stored on *FSINFO*. It'll be used to "
33131 "determine number of free clusters without scanning disk. But it's not used "
33132 "by default, because recent Windows don't update it correctly in some case. "
33133 "If you are sure the \"free clusters\" on *FSINFO* is correct, by this option "
33134 "you can avoid scanning disk."
33137 #. type: Labeled list
33138 #: ../sys-utils/mount.8.adoc:977
33140 msgid "*dots*, *nodots*, *dotsOK=*[**yes**|*no*]"
33143 #. type: Plain text
33144 #: ../sys-utils/mount.8.adoc:979
33146 "Various misguided attempts to force Unix or DOS conventions onto a FAT "
33151 #: ../sys-utils/mount.8.adoc:980
33153 msgid "Mount options for hfs"
33156 #. type: Labeled list
33157 #: ../sys-utils/mount.8.adoc:982
33159 msgid "**creator=**__cccc__**, type=**__cccc__"
33162 #. type: Plain text
33163 #: ../sys-utils/mount.8.adoc:984
33165 "Set the creator/type values as shown by the MacOS finder used for creating "
33166 "new files. Default values: '????'."
33169 #. type: Labeled list
33170 #: ../sys-utils/mount.8.adoc:988
33172 msgid "**dir_umask=**__n__**, file_umask=**__n__**, umask=**__n__"
33175 #. type: Plain text
33176 #: ../sys-utils/mount.8.adoc:990
33178 "Set the umask used for all directories, all regular files, or all files and "
33179 "directories. Defaults to the umask of the current process."
33182 #. type: Labeled list
33183 #: ../sys-utils/mount.8.adoc:991
33185 #| msgid "**--session-command=**__command__"
33186 msgid "**session=**__n__"
33187 msgstr "**--session-command=**__příkaz__"
33189 #. type: Plain text
33190 #: ../sys-utils/mount.8.adoc:993
33192 "Select the CDROM session to mount. Defaults to leaving that decision to the "
33193 "CDROM driver. This option will fail with anything but a CDROM as underlying "
33197 #. type: Labeled list
33198 #: ../sys-utils/mount.8.adoc:994
33200 msgid "**part=**__n__"
33203 #. type: Plain text
33204 #: ../sys-utils/mount.8.adoc:996
33206 "Select partition number n from the device. Only makes sense for CDROMs. "
33207 "Defaults to not parsing the partition table at all."
33210 #. type: Plain text
33211 #: ../sys-utils/mount.8.adoc:999
33212 msgid "Don't complain about invalid mount options."
33216 #: ../sys-utils/mount.8.adoc:1000
33218 msgid "Mount options for hpfs"
33221 #. type: Labeled list
33222 #: ../sys-utils/mount.8.adoc:1008
33224 msgid "*case=*{**lower**|*asis*}"
33227 #. type: Plain text
33228 #: ../sys-utils/mount.8.adoc:1010
33230 "Convert all files names to lower case, or leave them. (Default: "
33234 #. type: Plain text
33235 #: ../sys-utils/mount.8.adoc:1013 ../sys-utils/mount.8.adoc:1051
33236 msgid "This option is obsolete and may fail or being ignored."
33239 #. type: Labeled list
33240 #: ../sys-utils/mount.8.adoc:1014
33245 #. type: Plain text
33246 #: ../sys-utils/mount.8.adoc:1016
33247 msgid "Do not abort mounting when certain consistency checks fail."
33251 #: ../sys-utils/mount.8.adoc:1017
33253 msgid "Mount options for iso9660"
33256 #. type: Plain text
33257 #: ../sys-utils/mount.8.adoc:1020
33259 "ISO 9660 is a standard describing a filesystem structure to be used on CD-"
33260 "ROMs. (This filesystem type is also seen on some DVDs. See also the _udf_ "
33264 #. type: Plain text
33265 #: ../sys-utils/mount.8.adoc:1022
33267 "Normal _iso9660_ filenames appear in an 8.3 format (i.e., DOS-like "
33268 "restrictions on filename length), and in addition all characters are in "
33269 "upper case. Also there is no field for file ownership, protection, number of "
33270 "links, provision for block/character devices, etc."
33273 #. type: Plain text
33274 #: ../sys-utils/mount.8.adoc:1024
33276 "Rock Ridge is an extension to iso9660 that provides all of these UNIX-like "
33277 "features. Basically there are extensions to each directory record that "
33278 "supply all of the additional information, and when Rock Ridge is in use, the "
33279 "filesystem is indistinguishable from a normal UNIX filesystem (except that "
33280 "it is read-only, of course)."
33283 #. type: Labeled list
33284 #: ../sys-utils/mount.8.adoc:1025
33289 #. type: Plain text
33290 #: ../sys-utils/mount.8.adoc:1027
33291 msgid "Disable the use of Rock Ridge extensions, even if available. Cf. *map*."
33294 #. type: Labeled list
33295 #: ../sys-utils/mount.8.adoc:1028
33300 #. type: Plain text
33301 #: ../sys-utils/mount.8.adoc:1030
33303 "Disable the use of Microsoft Joliet extensions, even if available. Cf. *map*."
33306 #. type: Labeled list
33307 #: ../sys-utils/mount.8.adoc:1031
33309 msgid "*check=*{*r*[*elaxed*]|*s*[*trict*]}"
33312 #. type: Plain text
33313 #: ../sys-utils/mount.8.adoc:1033
33315 "With *check=relaxed*, a filename is first converted to lower case before "
33316 "doing the lookup. This is probably only meaningful together with *norock* "
33317 "and *map=normal*. (Default: *check=strict*.)"
33320 #. type: Plain text
33321 #: ../sys-utils/mount.8.adoc:1036
33323 "Give all files in the filesystem the indicated user or group id, possibly "
33324 "overriding the information found in the Rock Ridge extensions. (Default: "
33328 #. type: Labeled list
33329 #: ../sys-utils/mount.8.adoc:1037
33331 msgid "*map=*{*n*[*ormal*]|*o*[*ff*]|*a*[*corn*]}"
33334 #. type: Plain text
33335 #: ../sys-utils/mount.8.adoc:1039
33337 "For non-Rock Ridge volumes, normal name translation maps upper to lower case "
33338 "ASCII, drops a trailing ';1', and converts ';' to '.'. With *map=off* no "
33339 "name translation is done. See *norock*. (Default: *map=normal*.) *map=acorn* "
33340 "is like *map=normal* but also apply Acorn extensions if present."
33343 #. type: Plain text
33344 #: ../sys-utils/mount.8.adoc:1042
33346 "For non-Rock Ridge volumes, give all files the indicated mode. (Default: "
33347 "read and execute permission for everybody.) Octal mode values require a "
33351 #. type: Labeled list
33352 #: ../sys-utils/mount.8.adoc:1043 ../sys-utils/mount.8.adoc:1358
33357 #. type: Plain text
33358 #: ../sys-utils/mount.8.adoc:1045
33360 "Also show hidden and associated files. (If the ordinary files and the "
33361 "associated or hidden files have the same filenames, this may make the "
33362 "ordinary files inaccessible.)"
33365 #. type: Labeled list
33366 #: ../sys-utils/mount.8.adoc:1046
33368 msgid "*block=*{**512**|**1024**|*2048*}"
33371 #. type: Plain text
33372 #: ../sys-utils/mount.8.adoc:1048
33373 msgid "Set the block size to the indicated value. (Default: *block=1024*.)"
33376 #. type: Labeled list
33377 #: ../sys-utils/mount.8.adoc:1052
33382 #. type: Plain text
33383 #: ../sys-utils/mount.8.adoc:1054
33385 "If the high byte of the file length contains other garbage, set this mount "
33386 "option to ignore the high order bits of the file length. This implies that a "
33387 "file cannot be larger than 16 MB."
33390 #. type: Labeled list
33391 #: ../sys-utils/mount.8.adoc:1055
33393 #| msgid "**--session-command=**__command__"
33394 msgid "**session=**__x__"
33395 msgstr "**--session-command=**__příkaz__"
33397 #. type: Plain text
33398 #: ../sys-utils/mount.8.adoc:1057
33399 msgid "Select number of session on a multisession CD."
33402 #. type: Labeled list
33403 #: ../sys-utils/mount.8.adoc:1058
33405 msgid "**sbsector=**__xxx__"
33408 #. type: Plain text
33409 #: ../sys-utils/mount.8.adoc:1060
33410 msgid "Session begins from sector xxx."
33413 #. type: Plain text
33414 #: ../sys-utils/mount.8.adoc:1062
33416 "The following options are the same as for vfat and specifying them only "
33417 "makes sense when using discs encoded using Microsoft's Joliet extensions."
33420 #. type: Plain text
33421 #: ../sys-utils/mount.8.adoc:1065
33423 "Character set to use for converting 16 bit Unicode characters on CD to 8 bit "
33424 "characters. The default is iso8859-1."
33427 #. type: Labeled list
33428 #: ../sys-utils/mount.8.adoc:1066 ../sys-utils/mount.8.adoc:1105
33429 #: ../sys-utils/mount.8.adoc:1382 ../sys-utils/mount.8.adoc:1480
33434 #. type: Plain text
33435 #: ../sys-utils/mount.8.adoc:1068
33436 msgid "Convert 16 bit Unicode characters on CD to UTF-8."
33440 #: ../sys-utils/mount.8.adoc:1069
33442 msgid "Mount options for jfs"
33445 #. type: Labeled list
33446 #: ../sys-utils/mount.8.adoc:1071 ../sys-utils/mount.8.adoc:1099
33448 msgid "**iocharset=**__name__"
33451 #. type: Plain text
33452 #: ../sys-utils/mount.8.adoc:1073
33454 "Character set to use for converting from Unicode to ASCII. The default is to "
33455 "do no conversion. Use *iocharset=utf8* for UTF8 translations. This requires "
33456 "*CONFIG_NLS_UTF8* to be set in the kernel _.config_ file."
33459 #. type: Labeled list
33460 #: ../sys-utils/mount.8.adoc:1074
33462 msgid "**resize=**__value__"
33465 #. type: Plain text
33466 #: ../sys-utils/mount.8.adoc:1076
33468 "Resize the volume to _value_ blocks. JFS only supports growing a volume, not "
33469 "shrinking it. This option is only valid during a remount, when the volume is "
33470 "mounted read-write. The *resize* keyword with no value will grow the volume "
33471 "to the full size of the partition."
33474 #. type: Labeled list
33475 #: ../sys-utils/mount.8.adoc:1077
33477 msgid "*nointegrity*"
33480 #. type: Plain text
33481 #: ../sys-utils/mount.8.adoc:1079
33483 "Do not write to the journal. The primary use of this option is to allow for "
33484 "higher performance when restoring a volume from backup media. The integrity "
33485 "of the volume is not guaranteed if the system abnormally ends."
33488 #. type: Labeled list
33489 #: ../sys-utils/mount.8.adoc:1080
33491 msgid "*integrity*"
33494 #. type: Plain text
33495 #: ../sys-utils/mount.8.adoc:1082
33497 "Default. Commit metadata changes to the journal. Use this option to remount "
33498 "a volume where the *nointegrity* option was previously specified in order to "
33499 "restore normal behavior."
33502 #. type: Labeled list
33503 #: ../sys-utils/mount.8.adoc:1083
33505 msgid "*errors=*{**continue**|**remount-ro**|*panic*}"
33508 #. type: Plain text
33509 #: ../sys-utils/mount.8.adoc:1085
33511 "Define the behavior when an error is encountered. (Either ignore errors and "
33512 "just mark the filesystem erroneous and continue, or remount the filesystem "
33513 "read-only, or panic and halt the system.)"
33516 #. type: Labeled list
33517 #: ../sys-utils/mount.8.adoc:1086
33519 msgid "**noquota**|**quota**|**usrquota**|*grpquota*"
33522 #. type: Plain text
33523 #: ../sys-utils/mount.8.adoc:1088
33524 msgid "These options are accepted but ignored."
33528 #: ../sys-utils/mount.8.adoc:1089
33530 msgid "Mount options for msdos"
33533 #. type: Plain text
33534 #: ../sys-utils/mount.8.adoc:1092
33536 "See mount options for fat. If the _msdos_ filesystem detects an "
33537 "inconsistency, it reports an error and sets the file system read-only. The "
33538 "filesystem can be made writable again by remounting it."
33542 #: ../sys-utils/mount.8.adoc:1093
33544 msgid "Mount options for ncpfs"
33547 #. type: Plain text
33548 #: ../sys-utils/mount.8.adoc:1096
33550 "Just like _nfs_, the _ncpfs_ implementation expects a binary argument (a "
33551 "_struct ncp_mount_data_) to the *mount*(2) system call. This argument is "
33552 "constructed by *ncpmount*(8) and the current version of *mount* (2.12) does "
33553 "not know anything about ncpfs."
33557 #: ../sys-utils/mount.8.adoc:1097
33559 msgid "Mount options for ntfs"
33562 #. type: Plain text
33563 #: ../sys-utils/mount.8.adoc:1101
33565 "Character set to use when returning file names. Unlike VFAT, NTFS suppresses "
33566 "names that contain nonconvertible characters. Deprecated."
33569 #. type: Labeled list
33570 #: ../sys-utils/mount.8.adoc:1102
33572 msgid "**nls=**__name__"
33575 #. type: Plain text
33576 #: ../sys-utils/mount.8.adoc:1104
33577 msgid "New name for the option earlier called _iocharset_."
33580 #. type: Plain text
33581 #: ../sys-utils/mount.8.adoc:1107
33582 msgid "Use UTF-8 for converting file names."
33585 #. type: Labeled list
33586 #: ../sys-utils/mount.8.adoc:1108
33588 msgid "*uni_xlate=*{**0**|**1**|*2*}"
33591 #. type: Plain text
33592 #: ../sys-utils/mount.8.adoc:1110
33594 "For 0 (or 'no' or 'false'), do not use escape sequences for unknown Unicode "
33595 "characters. For 1 (or 'yes' or 'true') or 2, use vfat-style 4-byte escape "
33596 "sequences starting with \":\". Here 2 gives a little-endian encoding and 1 a "
33597 "byteswapped bigendian encoding."
33600 #. type: Labeled list
33601 #: ../sys-utils/mount.8.adoc:1111
33603 msgid "*posix=[0|1]*"
33606 #. type: Plain text
33607 #: ../sys-utils/mount.8.adoc:1113
33609 "If enabled (posix=1), the filesystem distinguishes between upper and lower "
33610 "case. The 8.3 alias names are presented as hard links instead of being "
33611 "suppressed. This option is obsolete."
33614 #. type: Labeled list
33615 #: ../sys-utils/mount.8.adoc:1114
33617 msgid "**uid=**__value__, **gid=**__value__ and **umask=**__value__"
33620 #. type: Plain text
33621 #: ../sys-utils/mount.8.adoc:1116
33623 "Set the file permission on the filesystem. The umask value is given in "
33624 "octal. By default, the files are owned by root and not readable by somebody "
33629 #: ../sys-utils/mount.8.adoc:1117
33631 msgid "Mount options for overlay"
33634 #. type: Plain text
33635 #: ../sys-utils/mount.8.adoc:1120
33637 "Since Linux 3.18 the overlay pseudo filesystem implements a union mount for "
33638 "other filesystems."
33641 #. type: Plain text
33642 #: ../sys-utils/mount.8.adoc:1122
33644 "An overlay filesystem combines two filesystems - an *upper* filesystem and a "
33645 "*lower* filesystem. When a name exists in both filesystems, the object in "
33646 "the upper filesystem is visible while the object in the lower filesystem is "
33647 "either hidden or, in the case of directories, merged with the upper object."
33650 #. type: Plain text
33651 #: ../sys-utils/mount.8.adoc:1124
33653 "The lower filesystem can be any filesystem supported by Linux and does not "
33654 "need to be writable. The lower filesystem can even be another overlayfs. The "
33655 "upper filesystem will normally be writable and if it is it must support the "
33656 "creation of trusted.* extended attributes, and must provide a valid d_type "
33657 "in readdir responses, so NFS is not suitable."
33660 #. type: Plain text
33661 #: ../sys-utils/mount.8.adoc:1126
33663 "A read-only overlay of two read-only filesystems may use any filesystem "
33664 "type. The options *lowerdir* and *upperdir* are combined into a merged "
33665 "directory by using:"
33668 #. type: delimited block .
33669 #: ../sys-utils/mount.8.adoc:1131
33672 "mount -t overlay overlay \\\n"
33673 " -olowerdir=/lower,upperdir=/upper,workdir=/work /merged\n"
33676 #. type: Labeled list
33677 #: ../sys-utils/mount.8.adoc:1134
33679 msgid "**lowerdir=**__directory__"
33682 #. type: delimited block _
33683 #: ../sys-utils/mount.8.adoc:1136
33684 msgid "Any filesystem, does not need to be on a writable filesystem."
33687 #. type: Labeled list
33688 #: ../sys-utils/mount.8.adoc:1137
33690 msgid "**upperdir=**__directory__"
33693 #. type: delimited block _
33694 #: ../sys-utils/mount.8.adoc:1139
33695 msgid "The upperdir is normally on a writable filesystem."
33698 #. type: Labeled list
33699 #: ../sys-utils/mount.8.adoc:1140
33701 msgid "**workdir=**__directory__"
33704 #. type: delimited block _
33705 #: ../sys-utils/mount.8.adoc:1142
33707 "The workdir needs to be an empty directory on the same filesystem as "
33711 #. type: Labeled list
33712 #: ../sys-utils/mount.8.adoc:1143
33715 msgid "*userxattr*"
33718 #. type: delimited block _
33719 #: ../sys-utils/mount.8.adoc:1145
33721 "Use the \"*user.overlay.*\" xattr namespace instead of \"*trusted.overlay."
33722 "*\". This is useful for unprivileged mounting of overlayfs."
33725 #. type: Labeled list
33726 #: ../sys-utils/mount.8.adoc:1146
33728 msgid "*redirect_dir=*{**on**|**off**|**follow**|**nofollow**}"
33731 #. type: delimited block _
33732 #: ../sys-utils/mount.8.adoc:1148
33734 "If the _redirect_dir_ feature is enabled, then the directory will be copied "
33735 "up (but not the contents). Then the \"{**trusted**|**user**}.overlay."
33736 "redirect\" extended attribute is set to the path of the original location "
33737 "from the root of the overlay. Finally the directory is moved to the new "
33741 #. type: Labeled list
33742 #: ../sys-utils/mount.8.adoc:1149 ../sys-utils/rtcwake.8.adoc:84
33747 #. type: delimited block _
33748 #: ../sys-utils/mount.8.adoc:1151
33749 msgid "Redirects are enabled."
33752 #. type: Labeled list
33753 #: ../sys-utils/mount.8.adoc:1152 ../sys-utils/rtcwake.8.adoc:78
33754 #: ../term-utils/setterm.1.adoc:124
33759 #. type: delimited block _
33760 #: ../sys-utils/mount.8.adoc:1154
33762 "Redirects are not created and only followed if \"redirect_always_follow\" "
33763 "feature is enabled in the kernel/module config."
33766 #. type: Labeled list
33767 #: ../sys-utils/mount.8.adoc:1155
33772 #. type: delimited block _
33773 #: ../sys-utils/mount.8.adoc:1157
33774 msgid "Redirects are not created, but followed."
33777 #. type: Labeled list
33778 #: ../sys-utils/mount.8.adoc:1158
33780 #| msgid "*nofail*"
33784 #. type: delimited block _
33785 #: ../sys-utils/mount.8.adoc:1160
33787 "Redirects are not created and not followed (equivalent to "
33788 "\"redirect_dir=off\" if \"redirect_always_follow\" feature is not enabled)."
33791 #. type: Labeled list
33792 #: ../sys-utils/mount.8.adoc:1161
33794 msgid "*index=*{**on**|**off**}"
33797 #. type: delimited block _
33798 #: ../sys-utils/mount.8.adoc:1163
33800 "Inode index. If this feature is disabled and a file with multiple hard links "
33801 "is copied up, then this will \"break\" the link. Changes will not be "
33802 "propagated to other names referring to the same inode."
33805 #. type: Labeled list
33806 #: ../sys-utils/mount.8.adoc:1164
33808 msgid "*uuid=*{**on**|**off**}"
33811 #. type: delimited block _
33812 #: ../sys-utils/mount.8.adoc:1166
33814 "Can be used to replace UUID of the underlying filesystem in file handles "
33815 "with null, and effectively disable UUID checks. This can be useful in case "
33816 "the underlying disk is copied and the UUID of this copy is changed. This is "
33817 "only applicable if all lower/upper/work directories are on the same "
33818 "filesystem, otherwise it will fallback to normal behaviour."
33821 #. type: Labeled list
33822 #: ../sys-utils/mount.8.adoc:1167
33824 msgid "*nfs_export=*{**on**|**off**}"
33827 #. type: delimited block _
33828 #: ../sys-utils/mount.8.adoc:1170
33830 "When the underlying filesystems supports NFS export and the \"nfs_export\" "
33831 "feature is enabled, an overlay filesystem may be exported to NFS."
33834 #. type: delimited block _
33835 #: ../sys-utils/mount.8.adoc:1177
33837 "With the \"nfs_export\" feature, on copy_up of any lower object, an index "
33838 "entry is created under the index directory. The index entry name is the "
33839 "hexadecimal representation of the copy up origin file handle. For a non-"
33840 "directory object, the index entry is a hard link to the upper inode. For a "
33841 "directory object, the index entry has an extended attribute \"{**trusted**|"
33842 "**user**}.overlay.upper\" with an encoded file handle of the upper directory "
33846 #. type: Labeled list
33847 #: ../sys-utils/mount.8.adoc:1178
33849 msgid "When encoding a file handle from an overlay filesystem object, the following rules apply"
33852 #. type: delimited block _
33853 #: ../sys-utils/mount.8.adoc:1181
33854 msgid "For a non-upper object, encode a lower file handle from lower inode"
33857 #. type: delimited block _
33858 #: ../sys-utils/mount.8.adoc:1182
33859 msgid "For an indexed object, encode a lower file handle from copy_up origin"
33862 #. type: delimited block _
33863 #: ../sys-utils/mount.8.adoc:1183
33865 "For a pure-upper object and for an existing non-indexed upper object, encode "
33866 "an upper file handle from upper inode"
33869 #. type: Labeled list
33870 #: ../sys-utils/mount.8.adoc:1185
33872 msgid "The encoded overlay file handle includes"
33875 #. type: delimited block _
33876 #: ../sys-utils/mount.8.adoc:1188
33877 msgid "Header including path type information (e.g. lower/upper)"
33880 #. type: delimited block _
33881 #: ../sys-utils/mount.8.adoc:1189
33882 msgid "UUID of the underlying filesystem"
33885 #. type: delimited block _
33886 #: ../sys-utils/mount.8.adoc:1190
33887 msgid "Underlying filesystem encoding of underlying inode"
33890 #. type: Labeled list
33891 #: ../sys-utils/mount.8.adoc:1192
33893 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"
33896 #. type: delimited block _
33897 #: ../sys-utils/mount.8.adoc:1195
33898 msgid "Find underlying layer by UUID and path type information."
33901 #. type: delimited block _
33902 #: ../sys-utils/mount.8.adoc:1196
33903 msgid "Decode the underlying filesystem file handle to underlying dentry."
33906 #. type: delimited block _
33907 #: ../sys-utils/mount.8.adoc:1197
33908 msgid "For a lower file handle, lookup the handle in index directory by name."
33911 #. type: delimited block _
33912 #: ../sys-utils/mount.8.adoc:1198
33914 "If a whiteout is found in index, return **ESTALE**. This represents an "
33915 "overlay object that was deleted after its file handle was encoded."
33918 #. type: delimited block _
33919 #: ../sys-utils/mount.8.adoc:1199
33921 "For a non-directory, instantiate a disconnected overlay dentry from the "
33922 "decoded underlying dentry, the path type and index inode, if found."
33925 #. type: delimited block _
33926 #: ../sys-utils/mount.8.adoc:1200
33928 "For a directory, use the connected underlying decoded dentry, path type and "
33929 "index, to lookup a connected overlay dentry."
33932 #. type: delimited block _
33933 #: ../sys-utils/mount.8.adoc:1206
33935 "Decoding a non-directory file handle may return a disconnected dentry. "
33936 "copy_up of that disconnected dentry will create an upper index entry with no "
33940 #. type: delimited block _
33941 #: ../sys-utils/mount.8.adoc:1218
33943 "When overlay filesystem has multiple lower layers, a middle layer directory "
33944 "may have a \"redirect\" to lower directory. Because middle layer "
33945 "\"redirects\" are not indexed, a lower file handle that was encoded from the "
33946 "\"redirect\" origin directory, cannot be used to find the middle or upper "
33947 "layer directory. Similarly, a lower file handle that was encoded from a "
33948 "descendant of the \"redirect\" origin directory, cannot be used to "
33949 "reconstruct a connected overlay path. To mitigate the cases of directories "
33950 "that cannot be decoded from a lower file handle, these directories are "
33951 "copied up on encode and encoded as an upper file handle. On an overlay "
33952 "filesystem with no upper layer this mitigation cannot be used NFS export in "
33953 "this setup requires turning off redirect follow (e.g. "
33954 "\"__redirect_dir=nofollow__\")."
33957 #. type: delimited block _
33958 #: ../sys-utils/mount.8.adoc:1220
33960 "The overlay filesystem does not support non-directory connectable file "
33961 "handles, so exporting with the _subtree_check_ exportfs configuration will "
33962 "cause failures to lookup files over NFS."
33965 #. type: delimited block _
33966 #: ../sys-utils/mount.8.adoc:1222
33968 "When the NFS export feature is enabled, all directory index entries are "
33969 "verified on mount time to check that upper file handles are not stale. This "
33970 "verification may cause significant overhead in some cases."
33973 #. type: delimited block _
33974 #: ../sys-utils/mount.8.adoc:1225
33976 "Note: the mount options __index=off,nfs_export=on__ are conflicting for a "
33977 "read-write mount and will result in an error."
33980 #. type: Labeled list
33981 #: ../sys-utils/mount.8.adoc:1227
33983 msgid "*xino=*{**on**|**off**|**auto**}"
33986 #. type: delimited block _
33987 #: ../sys-utils/mount.8.adoc:1229
33989 "The \"xino\" feature composes a unique object identifier from the real "
33990 "object st_ino and an underlying fsid index. The \"xino\" feature uses the "
33991 "high inode number bits for fsid, because the underlying filesystems rarely "
33992 "use the high inode number bits. In case the underlying inode number does "
33993 "overflow into the high xino bits, overlay filesystem will fall back to the "
33994 "non xino behavior for that inode."
33997 #. type: delimited block _
33998 #: ../sys-utils/mount.8.adoc:1231
34000 "For a detailed description of the effect of this option please refer to "
34001 "https://docs.kernel.org/filesystems/overlayfs.html"
34004 #. type: Labeled list
34005 #: ../sys-utils/mount.8.adoc:1232
34007 msgid "*metacopy=*{**on**|**off**}"
34010 #. type: delimited block _
34011 #: ../sys-utils/mount.8.adoc:1234
34013 "When metadata only copy up feature is enabled, overlayfs will only copy up "
34014 "metadata (as opposed to whole file), when a metadata specific operation like "
34015 "chown/chmod is performed. Full file will be copied up later when file is "
34016 "opened for WRITE operation."
34019 #. type: delimited block _
34020 #: ../sys-utils/mount.8.adoc:1236
34022 "In other words, this is delayed data copy up operation and data is copied up "
34023 "when there is a need to actually modify data."
34026 #. type: Labeled list
34027 #: ../sys-utils/mount.8.adoc:1237
34032 #. type: delimited block _
34033 #: ../sys-utils/mount.8.adoc:1239
34035 "Volatile mounts are not guaranteed to survive a crash. It is strongly "
34036 "recommended that volatile mounts are only used if data written to the "
34037 "overlay can be recreated without significant effort."
34040 #. type: delimited block _
34041 #: ../sys-utils/mount.8.adoc:1241
34043 "The advantage of mounting with the \"volatile\" option is that all forms of "
34044 "sync calls to the upper filesystem are omitted."
34047 #. type: delimited block _
34048 #: ../sys-utils/mount.8.adoc:1243
34050 "In order to avoid a giving a false sense of safety, the syncfs (and fsync) "
34051 "semantics of volatile mounts are slightly different than that of the rest of "
34052 "VFS. If any writeback error occurs on the upperdirâ
\80\99s filesystem after a "
34053 "volatile mount takes place, all sync functions will return an error. Once "
34054 "this condition is reached, the filesystem will not recover, and every "
34055 "subsequent sync call will return an error, even if the upperdir has not "
34056 "experience a new error since the last sync call."
34059 #. type: delimited block _
34060 #: ../sys-utils/mount.8.adoc:1245
34062 "When overlay is mounted with \"volatile\" option, the directory \"$workdir/"
34063 "work/incompat/volatile\" is created. During next mount, overlay checks for "
34064 "this directory and refuses to mount if present. This is a strong indicator "
34065 "that user should throw away upper and work directories and create fresh one. "
34066 "In very limited cases where the user knows that the system has not crashed "
34067 "and contents of upperdir are intact, The \"volatile\" directory can be "
34072 #: ../sys-utils/mount.8.adoc:1246
34074 msgid "Mount options for reiserfs"
34077 #. type: delimited block _
34078 #: ../sys-utils/mount.8.adoc:1249
34079 msgid "Reiserfs is a journaling filesystem."
34082 #. type: Labeled list
34083 #: ../sys-utils/mount.8.adoc:1250
34088 #. type: delimited block _
34089 #: ../sys-utils/mount.8.adoc:1252
34091 "Instructs version 3.6 reiserfs software to mount a version 3.5 filesystem, "
34092 "using the 3.6 format for newly created objects. This filesystem will no "
34093 "longer be compatible with reiserfs 3.5 tools."
34096 #. type: Labeled list
34097 #: ../sys-utils/mount.8.adoc:1253
34099 msgid "*hash=*{**rupasov**|**tea**|**r5**|*detect*}"
34102 #. type: delimited block _
34103 #: ../sys-utils/mount.8.adoc:1255
34105 "Choose which hash function reiserfs will use to find files within "
34109 #. type: Labeled list
34110 #: ../sys-utils/mount.8.adoc:1256
34115 #. type: delimited block _
34116 #: ../sys-utils/mount.8.adoc:1258
34118 "A hash invented by Yury Yu. Rupasov. It is fast and preserves locality, "
34119 "mapping lexicographically close file names to close hash values. This option "
34120 "should not be used, as it causes a high probability of hash collisions."
34123 #. type: Labeled list
34124 #: ../sys-utils/mount.8.adoc:1259
34129 #. type: delimited block _
34130 #: ../sys-utils/mount.8.adoc:1261
34132 "A Davis-Meyer function implemented by Jeremy Fitzhardinge. It uses hash "
34133 "permuting bits in the name. It gets high randomness and, therefore, low "
34134 "probability of hash collisions at some CPU cost. This may be used if "
34135 "*EHASHCOLLISION* errors are experienced with the r5 hash."
34138 #. type: Labeled list
34139 #: ../sys-utils/mount.8.adoc:1262
34144 #. type: delimited block _
34145 #: ../sys-utils/mount.8.adoc:1264
34147 "A modified version of the rupasov hash. It is used by default and is the "
34148 "best choice unless the filesystem has huge directories and unusual file-name "
34152 #. type: Labeled list
34153 #: ../sys-utils/mount.8.adoc:1265
34158 #. type: delimited block _
34159 #: ../sys-utils/mount.8.adoc:1267
34161 "Instructs *mount* to detect which hash function is in use by examining the "
34162 "filesystem being mounted, and to write this information into the reiserfs "
34163 "superblock. This is only useful on the first mount of an old format "
34167 #. type: Labeled list
34168 #: ../sys-utils/mount.8.adoc:1268
34170 msgid "*hashed_relocation*"
34173 #. type: delimited block _
34174 #: ../sys-utils/mount.8.adoc:1270 ../sys-utils/mount.8.adoc:1273
34176 "Tunes the block allocator. This may provide performance improvements in some "
34180 #. type: Labeled list
34181 #: ../sys-utils/mount.8.adoc:1271
34183 msgid "*no_unhashed_relocation*"
34186 #. type: Labeled list
34187 #: ../sys-utils/mount.8.adoc:1274
34192 #. type: delimited block _
34193 #: ../sys-utils/mount.8.adoc:1276
34195 "Disable the border allocator algorithm invented by Yury Yu. Rupasov. This "
34196 "may provide performance improvements in some situations."
34199 #. type: Labeled list
34200 #: ../sys-utils/mount.8.adoc:1277
34205 #. type: delimited block _
34206 #: ../sys-utils/mount.8.adoc:1279
34208 "Disable journaling. This will provide slight performance improvements in "
34209 "some situations at the cost of losing reiserfs's fast recovery from crashes. "
34210 "Even with this option turned on, reiserfs still performs all journaling "
34211 "operations, save for actual writes into its journaling area. Implementation "
34212 "of _nolog_ is a work in progress."
34215 #. type: Labeled list
34216 #: ../sys-utils/mount.8.adoc:1280
34218 #| msgid "*nofail*"
34222 #. type: delimited block _
34223 #: ../sys-utils/mount.8.adoc:1282
34225 "By default, reiserfs stores small files and 'file tails' directly into its "
34226 "tree. This confuses some utilities such as *lilo*(8). This option is used to "
34227 "disable packing of files into the tree."
34230 #. type: Labeled list
34231 #: ../sys-utils/mount.8.adoc:1283
34233 msgid "*replayonly*"
34236 #. type: delimited block _
34237 #: ../sys-utils/mount.8.adoc:1285
34239 "Replay the transactions which are in the journal, but do not actually mount "
34240 "the filesystem. Mainly used by _reiserfsck_."
34243 #. type: Labeled list
34244 #: ../sys-utils/mount.8.adoc:1286
34246 msgid "**resize=**__number__"
34249 #. type: delimited block _
34250 #: ../sys-utils/mount.8.adoc:1288
34252 "A remount option which permits online expansion of reiserfs partitions. "
34253 "Instructs reiserfs to assume that the device has _number_ blocks. This "
34254 "option is designed for use with devices which are under logical volume "
34255 "management (LVM). There is a special _resizer_ utility which can be obtained "
34256 "from _ftp://ftp.namesys.com/pub/reiserfsprogs_."
34259 #. type: Labeled list
34260 #: ../sys-utils/mount.8.adoc:1289
34263 msgid "*user_xattr*"
34266 #. type: delimited block _
34267 #: ../sys-utils/mount.8.adoc:1291
34268 msgid "Enable Extended User Attributes. See the *attr*(1) manual page."
34271 #. type: Labeled list
34272 #: ../sys-utils/mount.8.adoc:1292
34277 #. type: delimited block _
34278 #: ../sys-utils/mount.8.adoc:1294
34279 msgid "Enable POSIX Access Control Lists. See the *acl*(5) manual page."
34282 #. type: Labeled list
34283 #: ../sys-utils/mount.8.adoc:1295
34285 msgid "*barrier=none* / *barrier=flush*"
34288 #. type: delimited block _
34289 #: ../sys-utils/mount.8.adoc:1297
34291 "This disables / enables the use of write barriers in the journaling code. "
34292 "*barrier=none* disables, *barrier=flush* enables (default). This also "
34293 "requires an IO stack which can support barriers, and if reiserfs gets an "
34294 "error on a barrier write, it will disable barriers again with a warning. "
34295 "Write barriers enforce proper on-disk ordering of journal commits, making "
34296 "volatile disk write caches safe to use, at some performance penalty. If your "
34297 "disks are battery-backed in one way or another, disabling barriers may "
34298 "safely improve performance."
34302 #: ../sys-utils/mount.8.adoc:1298
34304 msgid "Mount options for ubifs"
34307 #. type: delimited block _
34308 #: ../sys-utils/mount.8.adoc:1301
34310 "UBIFS is a flash filesystem which works on top of UBI volumes. Note that "
34311 "*atime* is not supported and is always turned off."
34314 #. type: delimited block _
34315 #: ../sys-utils/mount.8.adoc:1303
34316 msgid "The device name may be specified as"
34319 #. type: Labeled list
34320 #: ../sys-utils/mount.8.adoc:1305
34325 #. type: Plain text
34326 #: ../sys-utils/mount.8.adoc:1307
34327 msgid "UBI device number *X*, volume number *Y*"
34330 #. type: Labeled list
34331 #: ../sys-utils/mount.8.adoc:1307
34336 #. type: Plain text
34337 #: ../sys-utils/mount.8.adoc:1309
34338 msgid "UBI device number *0*, volume number *Y*"
34341 #. type: Labeled list
34342 #: ../sys-utils/mount.8.adoc:1309
34344 msgid "*ubiX:NAME*"
34347 #. type: Plain text
34348 #: ../sys-utils/mount.8.adoc:1311
34349 msgid "UBI device number *X*, volume with name *NAME*"
34352 #. type: Labeled list
34353 #: ../sys-utils/mount.8.adoc:1311
34358 #. type: Plain text
34359 #: ../sys-utils/mount.8.adoc:1313
34360 msgid "UBI device number *0*, volume with name *NAME*"
34363 #. type: delimited block _
34364 #: ../sys-utils/mount.8.adoc:1316
34365 msgid "Alternative *!* separator may be used instead of *:*."
34368 #. type: delimited block _
34369 #: ../sys-utils/mount.8.adoc:1318
34370 msgid "The following mount options are available:"
34373 #. type: Labeled list
34374 #: ../sys-utils/mount.8.adoc:1319
34376 msgid "*bulk_read*"
34379 #. type: delimited block _
34380 #: ../sys-utils/mount.8.adoc:1321
34382 "Enable bulk-read. VFS read-ahead is disabled because it slows down the "
34383 "filesystem. Bulk-Read is an internal optimization. Some flashes may read "
34384 "faster if the data are read at one go, rather than at several read requests. "
34385 "For example, OneNAND can do \"read-while-load\" if it reads more than one "
34389 #. type: Labeled list
34390 #: ../sys-utils/mount.8.adoc:1322
34392 msgid "*no_bulk_read*"
34395 #. type: delimited block _
34396 #: ../sys-utils/mount.8.adoc:1324
34397 msgid "Do not bulk-read. This is the default."
34400 #. type: Labeled list
34401 #: ../sys-utils/mount.8.adoc:1325
34403 msgid "*chk_data_crc*"
34406 #. type: delimited block _
34407 #: ../sys-utils/mount.8.adoc:1327
34408 msgid "Check data CRC-32 checksums. This is the default."
34411 #. type: Labeled list
34412 #: ../sys-utils/mount.8.adoc:1328
34414 msgid "*no_chk_data_crc*"
34417 #. type: delimited block _
34418 #: ../sys-utils/mount.8.adoc:1330
34420 "Do not check data CRC-32 checksums. With this option, the filesystem does "
34421 "not check CRC-32 checksum for data, but it does check it for the internal "
34422 "indexing information. This option only affects reading, not writing. CRC-32 "
34423 "is always calculated when writing the data."
34426 #. type: Labeled list
34427 #: ../sys-utils/mount.8.adoc:1331
34429 msgid "*compr=*{**none**|**lzo**|*zlib*}"
34432 #. type: delimited block _
34433 #: ../sys-utils/mount.8.adoc:1333
34435 "Select the default compressor which is used when new files are written. It "
34436 "is still possible to read compressed files if mounted with the *none* option."
34440 #: ../sys-utils/mount.8.adoc:1334
34442 msgid "Mount options for udf"
34445 #. type: delimited block _
34446 #: ../sys-utils/mount.8.adoc:1337
34448 "UDF is the \"Universal Disk Format\" filesystem defined by OSTA, the Optical "
34449 "Storage Technology Association, and is often used for DVD-ROM, frequently in "
34450 "the form of a hybrid UDF/ISO-9660 filesystem. It is, however, perfectly "
34451 "usable by itself on disk drives, flash drives and other block devices. See "
34455 #. type: Labeled list
34456 #: ../sys-utils/mount.8.adoc:1338
34461 #. type: delimited block _
34462 #: ../sys-utils/mount.8.adoc:1340
34464 "Make all files in the filesystem belong to the given user. uid=forget can be "
34465 "specified independently of (or usually in addition to) uid=<user> and "
34466 "results in UDF not storing uids to the media. In fact the recorded uid is "
34467 "the 32-bit overflow uid -1 as defined by the UDF standard. The value is "
34468 "given as either <user> which is a valid user name or the corresponding "
34469 "decimal user id, or the special string \"forget\"."
34472 #. type: Labeled list
34473 #: ../sys-utils/mount.8.adoc:1341
34478 #. type: delimited block _
34479 #: ../sys-utils/mount.8.adoc:1343
34481 "Make all files in the filesystem belong to the given group. gid=forget can "
34482 "be specified independently of (or usually in addition to) gid=<group> and "
34483 "results in UDF not storing gids to the media. In fact the recorded gid is "
34484 "the 32-bit overflow gid -1 as defined by the UDF standard. The value is "
34485 "given as either <group> which is a valid group name or the corresponding "
34486 "decimal group id, or the special string \"forget\"."
34489 #. type: Labeled list
34490 #: ../sys-utils/mount.8.adoc:1344
34495 #. type: delimited block _
34496 #: ../sys-utils/mount.8.adoc:1346
34498 "Mask out the given permissions from all inodes read from the filesystem. The "
34499 "value is given in octal."
34502 #. type: Labeled list
34503 #: ../sys-utils/mount.8.adoc:1347
34508 #. type: delimited block _
34509 #: ../sys-utils/mount.8.adoc:1349
34511 "If *mode=* is set the permissions of all non-directory inodes read from the "
34512 "filesystem will be set to the given mode. The value is given in octal."
34515 #. type: Labeled list
34516 #: ../sys-utils/mount.8.adoc:1350
34521 #. type: delimited block _
34522 #: ../sys-utils/mount.8.adoc:1352
34524 "If *dmode=* is set the permissions of all directory inodes read from the "
34525 "filesystem will be set to the given dmode. The value is given in octal."
34528 #. type: Labeled list
34529 #: ../sys-utils/mount.8.adoc:1353
34534 #. type: delimited block _
34535 #: ../sys-utils/mount.8.adoc:1355
34537 "Set the block size. Default value prior to kernel version 2.6.30 was 2048. "
34538 "Since 2.6.30 and prior to 4.11 it was logical device block size with "
34539 "fallback to 2048. Since 4.11 it is logical block size with fallback to any "
34540 "valid block size between logical device block size and 4096."
34543 #. type: delimited block _
34544 #: ../sys-utils/mount.8.adoc:1357
34546 "For other details see the *mkudffs*(8) 2.0+ manpage, see the *COMPATIBILITY* "
34547 "and *BLOCK SIZE* sections."
34550 #. type: delimited block _
34551 #: ../sys-utils/mount.8.adoc:1360
34552 msgid "Show otherwise hidden files."
34555 #. type: Labeled list
34556 #: ../sys-utils/mount.8.adoc:1361
34561 #. type: delimited block _
34562 #: ../sys-utils/mount.8.adoc:1363
34563 msgid "Show deleted files in lists."
34566 #. type: Labeled list
34567 #: ../sys-utils/mount.8.adoc:1364
34572 #. type: delimited block _
34573 #: ../sys-utils/mount.8.adoc:1366
34574 msgid "Embed data in the inode. (default)"
34577 #. type: Labeled list
34578 #: ../sys-utils/mount.8.adoc:1367
34580 msgid "*noadinicb*"
34583 #. type: delimited block _
34584 #: ../sys-utils/mount.8.adoc:1369
34585 msgid "Don't embed data in the inode."
34588 #. type: Labeled list
34589 #: ../sys-utils/mount.8.adoc:1370
34594 #. type: delimited block _
34595 #: ../sys-utils/mount.8.adoc:1372
34596 msgid "Use short UDF address descriptors."
34599 #. type: Labeled list
34600 #: ../sys-utils/mount.8.adoc:1373
34605 #. type: delimited block _
34606 #: ../sys-utils/mount.8.adoc:1375
34607 msgid "Use long UDF address descriptors. (default)"
34610 #. type: Labeled list
34611 #: ../sys-utils/mount.8.adoc:1376
34616 #. type: delimited block _
34617 #: ../sys-utils/mount.8.adoc:1378
34618 msgid "Unset strict conformance."
34621 #. type: Labeled list
34622 #: ../sys-utils/mount.8.adoc:1379
34624 msgid "*iocharset=*"
34627 #. type: delimited block _
34628 #: ../sys-utils/mount.8.adoc:1381
34630 "Set the NLS character set. This requires kernel compiled with "
34631 "*CONFIG_UDF_NLS* option."
34634 #. type: delimited block _
34635 #: ../sys-utils/mount.8.adoc:1384
34636 msgid "Set the UTF-8 character set."
34640 #: ../sys-utils/mount.8.adoc:1385
34642 msgid "Mount options for debugging and disaster recovery"
34645 #. type: Labeled list
34646 #: ../sys-utils/mount.8.adoc:1387
34651 #. type: delimited block _
34652 #: ../sys-utils/mount.8.adoc:1389
34653 msgid "Ignore the Volume Recognition Sequence and attempt to mount anyway."
34656 #. type: Labeled list
34657 #: ../sys-utils/mount.8.adoc:1390
34662 #. type: delimited block _
34663 #: ../sys-utils/mount.8.adoc:1392
34665 "Select the session number for multi-session recorded optical media. "
34666 "(default= last session)"
34669 #. type: Labeled list
34670 #: ../sys-utils/mount.8.adoc:1393
34675 #. type: delimited block _
34676 #: ../sys-utils/mount.8.adoc:1395
34677 msgid "Override standard anchor location. (default= 256)"
34680 #. type: Labeled list
34681 #: ../sys-utils/mount.8.adoc:1396
34683 msgid "*lastblock=*"
34686 #. type: delimited block _
34687 #: ../sys-utils/mount.8.adoc:1398
34688 msgid "Set the last block of the filesystem."
34692 #: ../sys-utils/mount.8.adoc:1399
34694 msgid "Unused historical mount options that may be encountered and should be removed"
34697 #. type: Labeled list
34698 #: ../sys-utils/mount.8.adoc:1401
34700 msgid "*uid=ignore*"
34703 #. type: delimited block _
34704 #: ../sys-utils/mount.8.adoc:1403
34705 msgid "Ignored, use uid=<user> instead."
34708 #. type: Labeled list
34709 #: ../sys-utils/mount.8.adoc:1404
34711 msgid "*gid=ignore*"
34714 #. type: delimited block _
34715 #: ../sys-utils/mount.8.adoc:1406
34716 msgid "Ignored, use gid=<group> instead."
34719 #. type: Labeled list
34720 #: ../sys-utils/mount.8.adoc:1407
34725 #. type: delimited block _
34726 #: ../sys-utils/mount.8.adoc:1409 ../sys-utils/mount.8.adoc:1412
34727 #: ../sys-utils/mount.8.adoc:1415 ../sys-utils/mount.8.adoc:1418
34728 msgid "Unimplemented and ignored."
34731 #. type: Labeled list
34732 #: ../sys-utils/mount.8.adoc:1410
34734 msgid "*partition=*"
34737 #. type: Labeled list
34738 #: ../sys-utils/mount.8.adoc:1413
34743 #. type: Labeled list
34744 #: ../sys-utils/mount.8.adoc:1416
34750 #: ../sys-utils/mount.8.adoc:1419
34752 msgid "Mount options for ufs"
34755 #. type: Labeled list
34756 #: ../sys-utils/mount.8.adoc:1421
34758 msgid "**ufstype=**__value__"
34761 #. type: delimited block _
34762 #: ../sys-utils/mount.8.adoc:1423
34764 "UFS is a filesystem widely used in different operating systems. The problem "
34765 "are differences among implementations. Features of some implementations are "
34766 "undocumented, so its hard to recognize the type of ufs automatically. That's "
34767 "why the user must specify the type of ufs by mount option. Possible values "
34771 #. type: Labeled list
34772 #: ../sys-utils/mount.8.adoc:1424
34777 #. type: delimited block _
34778 #: ../sys-utils/mount.8.adoc:1426
34780 "Old format of ufs, this is the default, read only. (Don't forget to give the "
34784 #. type: Labeled list
34785 #: ../sys-utils/mount.8.adoc:1427
34790 #. type: delimited block _
34791 #: ../sys-utils/mount.8.adoc:1429
34793 "For filesystems created by a BSD-like system (NetBSD, FreeBSD, OpenBSD)."
34796 #. type: Labeled list
34797 #: ../sys-utils/mount.8.adoc:1430
34802 #. type: delimited block _
34803 #: ../sys-utils/mount.8.adoc:1432
34804 msgid "Used in FreeBSD 5.x supported as read-write."
34807 #. type: Labeled list
34808 #: ../sys-utils/mount.8.adoc:1433
34813 #. type: delimited block _
34814 #: ../sys-utils/mount.8.adoc:1435
34815 msgid "Synonym for ufs2."
34818 #. type: Labeled list
34819 #: ../sys-utils/mount.8.adoc:1436
34824 #. type: delimited block _
34825 #: ../sys-utils/mount.8.adoc:1438
34826 msgid "For filesystems created by SunOS or Solaris on Sparc."
34829 #. type: Labeled list
34830 #: ../sys-utils/mount.8.adoc:1439
34835 #. type: delimited block _
34836 #: ../sys-utils/mount.8.adoc:1441
34837 msgid "For filesystems created by Solaris on x86."
34840 #. type: Labeled list
34841 #: ../sys-utils/mount.8.adoc:1442
34846 #. type: delimited block _
34847 #: ../sys-utils/mount.8.adoc:1444
34848 msgid "For filesystems created by HP-UX, read-only."
34851 #. type: Labeled list
34852 #: ../sys-utils/mount.8.adoc:1445
34857 #. type: delimited block _
34858 #: ../sys-utils/mount.8.adoc:1447
34860 "For filesystems created by NeXTStep (on NeXT station) (currently read only)."
34863 #. type: Labeled list
34864 #: ../sys-utils/mount.8.adoc:1448
34866 msgid "*nextstep-cd*"
34869 #. type: delimited block _
34870 #: ../sys-utils/mount.8.adoc:1450
34871 msgid "For NextStep CDROMs (block_size == 2048), read-only."
34874 #. type: Labeled list
34875 #: ../sys-utils/mount.8.adoc:1451
34880 #. type: delimited block _
34881 #: ../sys-utils/mount.8.adoc:1453
34883 "For filesystems created by OpenStep (currently read only). The same "
34884 "filesystem type is also used by macOS."
34887 #. type: Labeled list
34888 #: ../sys-utils/mount.8.adoc:1454
34890 msgid "**onerror=**__value__"
34893 #. type: delimited block _
34894 #: ../sys-utils/mount.8.adoc:1456
34895 msgid "Set behavior on error:"
34898 #. type: Labeled list
34899 #: ../sys-utils/mount.8.adoc:1457
34904 #. type: delimited block _
34905 #: ../sys-utils/mount.8.adoc:1459
34906 msgid "If an error is encountered, cause a kernel panic."
34909 #. type: Labeled list
34910 #: ../sys-utils/mount.8.adoc:1460
34912 msgid "[**lock**|**umount**|*repair*]"
34915 #. type: delimited block _
34916 #: ../sys-utils/mount.8.adoc:1462
34918 "These mount options don't do anything at present; when an error is "
34919 "encountered only a console message is printed."
34923 #: ../sys-utils/mount.8.adoc:1463
34925 msgid "Mount options for umsdos"
34928 #. type: delimited block _
34929 #: ../sys-utils/mount.8.adoc:1466
34931 "See mount options for msdos. The *dotsOK* option is explicitly killed by "
34936 #: ../sys-utils/mount.8.adoc:1467
34938 msgid "Mount options for vfat"
34941 #. type: delimited block _
34942 #: ../sys-utils/mount.8.adoc:1470
34944 "First of all, the mount options for _fat_ are recognized. The *dotsOK* "
34945 "option is explicitly killed by _vfat_. Furthermore, there are"
34948 #. type: Labeled list
34949 #: ../sys-utils/mount.8.adoc:1471
34951 msgid "*uni_xlate*"
34954 #. type: delimited block _
34955 #: ../sys-utils/mount.8.adoc:1473
34957 "Translate unhandled Unicode characters to special escaped sequences. This "
34958 "lets you backup and restore filenames that are created with any Unicode "
34959 "characters. Without this option, a '?' is used when no translation is "
34960 "possible. The escape character is ':' because it is otherwise invalid on the "
34961 "vfat filesystem. The escape sequence that gets used, where u is the Unicode "
34962 "character, is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12)."
34965 #. type: Labeled list
34966 #: ../sys-utils/mount.8.adoc:1474
34971 #. type: delimited block _
34972 #: ../sys-utils/mount.8.adoc:1476
34974 "Allow two files with names that only differ in case. This option is obsolete."
34977 #. type: Labeled list
34978 #: ../sys-utils/mount.8.adoc:1477
34980 #| msgid "*nofail*"
34981 msgid "*nonumtail*"
34984 #. type: delimited block _
34985 #: ../sys-utils/mount.8.adoc:1479
34987 "First try to make a short name without sequence number, before trying "
34991 #. type: delimited block _
34992 #: ../sys-utils/mount.8.adoc:1482
34994 "UTF8 is the filesystem safe 8-bit encoding of Unicode that is used by the "
34995 "console. It can be enabled for the filesystem with this option or disabled "
34996 "with utf8=0, utf8=no or utf8=false. If _uni_xlate_ gets set, UTF8 gets "
35000 #. type: Labeled list
35001 #: ../sys-utils/mount.8.adoc:1483
35003 msgid "**shortname=**__mode__"
35006 #. type: delimited block _
35007 #: ../sys-utils/mount.8.adoc:1485
35009 "Defines the behavior for creation and display of filenames which fit into "
35010 "8.3 characters. If a long name for a file exists, it will always be the "
35011 "preferred one for display. There are four __mode__s:"
35014 #. type: Labeled list
35015 #: ../sys-utils/mount.8.adoc:1486
35020 #. type: delimited block _
35021 #: ../sys-utils/mount.8.adoc:1488
35023 "Force the short name to lower case upon display; store a long name when the "
35024 "short name is not all upper case."
35027 #. type: Labeled list
35028 #: ../sys-utils/mount.8.adoc:1489
35033 #. type: delimited block _
35034 #: ../sys-utils/mount.8.adoc:1491
35036 "Force the short name to upper case upon display; store a long name when the "
35037 "short name is not all upper case."
35040 #. type: Labeled list
35041 #: ../sys-utils/mount.8.adoc:1492
35046 #. type: delimited block _
35047 #: ../sys-utils/mount.8.adoc:1494
35049 "Display the short name as is; store a long name when the short name is not "
35050 "all lower case or all upper case."
35053 #. type: Labeled list
35054 #: ../sys-utils/mount.8.adoc:1495
35059 #. type: delimited block _
35060 #: ../sys-utils/mount.8.adoc:1497
35062 "Display the short name as is; store a long name when the short name is not "
35063 "all upper case. This mode is the default since Linux 2.6.32."
35067 #: ../sys-utils/mount.8.adoc:1498
35069 msgid "Mount options for usbfs"
35072 #. type: Labeled list
35073 #: ../sys-utils/mount.8.adoc:1500
35075 msgid "**devuid=**__uid__ and **devgid=**__gid__ and **devmode=**__mode__"
35078 #. type: delimited block _
35079 #: ../sys-utils/mount.8.adoc:1502
35081 "Set the owner and group and mode of the device files in the usbfs filesystem "
35082 "(default: uid=gid=0, mode=0644). The mode is given in octal."
35085 #. type: Labeled list
35086 #: ../sys-utils/mount.8.adoc:1503
35088 msgid "**busuid=**__uid__ and **busgid=**__gid__ and **busmode=**__mode__"
35091 #. type: delimited block _
35092 #: ../sys-utils/mount.8.adoc:1505
35094 "Set the owner and group and mode of the bus directories in the usbfs "
35095 "filesystem (default: uid=gid=0, mode=0555). The mode is given in octal."
35098 #. type: Labeled list
35099 #: ../sys-utils/mount.8.adoc:1506
35101 msgid "**listuid=**__uid__ and **listgid=**__gid__ and **listmode=**__mode__"
35104 #. type: delimited block _
35105 #: ../sys-utils/mount.8.adoc:1508
35107 "Set the owner and group and mode of the file _devices_ (default: uid=gid=0, "
35108 "mode=0444). The mode is given in octal."
35112 #: ../sys-utils/mount.8.adoc:1509
35114 msgid "DM-VERITY SUPPORT"
35117 #. type: delimited block _
35118 #: ../sys-utils/mount.8.adoc:1512
35120 "The device-mapper verity target provides read-only transparent integrity "
35121 "checking of block devices using kernel crypto API. The *mount* command can "
35122 "open the dm-verity device and do the integrity verification before the "
35123 "device filesystem is mounted. Requires libcryptsetup with in libmount "
35124 "(optionally via *dlopen*(3)). If libcryptsetup supports extracting the root "
35125 "hash of an already mounted device, existing devices will be automatically "
35126 "reused in case of a match. Mount options for dm-verity:"
35129 #. type: Labeled list
35130 #: ../sys-utils/mount.8.adoc:1513
35132 msgid "**verity.hashdevice=**__path__"
35135 #. type: delimited block _
35136 #: ../sys-utils/mount.8.adoc:1515
35138 "Path to the hash tree device associated with the source volume to pass to dm-"
35142 #. type: Labeled list
35143 #: ../sys-utils/mount.8.adoc:1516
35145 msgid "**verity.roothash=**__hex__"
35148 #. type: delimited block _
35149 #: ../sys-utils/mount.8.adoc:1518
35151 "Hex-encoded hash of the root of _verity.hashdevice_. Mutually exclusive with "
35152 "_verity.roothashfile._"
35155 #. type: Labeled list
35156 #: ../sys-utils/mount.8.adoc:1519
35158 msgid "**verity.roothashfile=**__path__"
35161 #. type: delimited block _
35162 #: ../sys-utils/mount.8.adoc:1521
35164 "Path to file containing the hex-encoded hash of the root of _verity."
35165 "hashdevice._ Mutually exclusive with _verity.roothash._"
35168 #. type: Labeled list
35169 #: ../sys-utils/mount.8.adoc:1522
35171 msgid "**verity.hashoffset=**__offset__"
35174 #. type: delimited block _
35175 #: ../sys-utils/mount.8.adoc:1524
35177 "If the hash tree device is embedded in the source volume, _offset_ (default: "
35178 "0) is used by dm-verity to get to the tree."
35181 #. type: Labeled list
35182 #: ../sys-utils/mount.8.adoc:1525
35184 msgid "**verity.fecdevice=**__path__"
35187 #. type: delimited block _
35188 #: ../sys-utils/mount.8.adoc:1527
35190 "Path to the Forward Error Correction (FEC) device associated with the source "
35191 "volume to pass to dm-verity. Optional. Requires kernel built with "
35192 "*CONFIG_DM_VERITY_FEC*."
35195 #. type: Labeled list
35196 #: ../sys-utils/mount.8.adoc:1528
35198 msgid "**verity.fecoffset=**__offset__"
35201 #. type: delimited block _
35202 #: ../sys-utils/mount.8.adoc:1530
35204 "If the FEC device is embedded in the source volume, _offset_ (default: 0) is "
35205 "used by dm-verity to get to the FEC area. Optional."
35208 #. type: Labeled list
35209 #: ../sys-utils/mount.8.adoc:1531
35211 msgid "**verity.fecroots=**__value__"
35214 #. type: delimited block _
35215 #: ../sys-utils/mount.8.adoc:1533
35216 msgid "Parity bytes for FEC (default: 2). Optional."
35219 #. type: Labeled list
35220 #: ../sys-utils/mount.8.adoc:1534
35222 msgid "**verity.roothashsig=**__path__"
35225 #. type: delimited block _
35226 #: ../sys-utils/mount.8.adoc:1536
35228 "Path to *pkcs7*(1ssl) signature of root hash hex string. Requires "
35229 "crypt_activate_by_signed_key() from cryptsetup and kernel built with "
35230 "*CONFIG_DM_VERITY_VERIFY_ROOTHASH_SIG*. For device reuse, signatures have to "
35231 "be either used by all mounts of a device or by none. Optional."
35234 #. type: Labeled list
35235 #: ../sys-utils/mount.8.adoc:1537
35237 msgid "**verity.oncorruption=**__ignore__|__restart__|__panic__"
35240 #. type: delimited block _
35241 #: ../sys-utils/mount.8.adoc:1539
35243 "Instruct the kernel to ignore, reboot or panic when corruption is detected. "
35244 "By default the I/O operation simply fails. Requires Linux 4.1 or newer, and "
35245 "libcrypsetup 2.3.4 or newer. Optional."
35248 #. type: delimited block _
35249 #: ../sys-utils/mount.8.adoc:1541
35250 msgid "Supported since util-linux v2.35."
35253 #. type: delimited block _
35254 #: ../sys-utils/mount.8.adoc:1543
35255 msgid "For example commands:"
35258 #. type: delimited block .
35259 #: ../sys-utils/mount.8.adoc:1551
35262 "mksquashfs /etc /tmp/etc.raw\n"
35263 "veritysetup format /tmp/etc.raw /tmp/etc.verity --root-hash-file=/tmp/etc.roothash\n"
35264 "openssl smime -sign -in /tmp/etc.roothash -nocerts -inkey private.key \\\n"
35265 "-signer private.crt -noattr -binary -outform der -out /tmp/etc.roothash.p7s\n"
35266 "mount -o verity.hashdevice=/tmp/etc.verity,verity.roothashfile=/tmp/etc.roothash,\\\n"
35267 "verity.roothashsig=/tmp/etc.roothash.p7s /tmp/etc.raw /mnt\n"
35270 #. type: Plain text
35271 #: ../sys-utils/mount.8.adoc:1554
35273 "create squashfs image from _/etc_ directory, verity hash device and mount "
35274 "verified filesystem image to _/mnt_. The kernel will verify that the root "
35275 "hash is signed by a key from the kernel keyring if roothashsig is used."
35279 #: ../sys-utils/mount.8.adoc:1555
35281 msgid "LOOP-DEVICE SUPPORT"
35284 #. type: Plain text
35285 #: ../sys-utils/mount.8.adoc:1558
35287 "One further possible type is a mount via the loop device. For example, the "
35291 #. type: delimited block _
35292 #: ../sys-utils/mount.8.adoc:1561
35294 msgid "*mount /tmp/disk.img /mnt -t vfat -o loop=/dev/loop3*\n"
35297 #. type: Plain text
35298 #: ../sys-utils/mount.8.adoc:1564
35300 "will set up the loop device _/dev/loop3_ to correspond to the file _/tmp/"
35301 "disk.img_, and then mount this device on _/mnt_."
35304 #. type: Plain text
35305 #: ../sys-utils/mount.8.adoc:1566
35307 "If no explicit loop device is mentioned (but just an option '**-o loop**' is "
35308 "given), then *mount* will try to find some unused loop device and use that, "
35312 #. type: delimited block _
35313 #: ../sys-utils/mount.8.adoc:1569
35315 msgid "*mount /tmp/disk.img /mnt -o loop*\n"
35318 #. type: Plain text
35319 #: ../sys-utils/mount.8.adoc:1572
35321 "The *mount* command *automatically* creates a loop device from a regular "
35322 "file if a filesystem type is not specified or the filesystem is known for "
35323 "libblkid, for example:"
35326 #. type: delimited block _
35327 #: ../sys-utils/mount.8.adoc:1575
35329 msgid "*mount /tmp/disk.img /mnt*\n"
35332 #. type: delimited block _
35333 #: ../sys-utils/mount.8.adoc:1577
35335 msgid "*mount -t ext4 /tmp/disk.img /mnt*\n"
35338 #. type: Plain text
35339 #: ../sys-utils/mount.8.adoc:1580
35341 "This type of mount knows about three options, namely *loop*, *offset* and "
35342 "*sizelimit*, that are really options to *losetup*(8). (These options can be "
35343 "used in addition to those specific to the filesystem type.)"
35346 #. type: Plain text
35347 #: ../sys-utils/mount.8.adoc:1582
35349 "Since Linux 2.6.25 auto-destruction of loop devices is supported, meaning "
35350 "that any loop device allocated by *mount* will be freed by *umount* "
35351 "independently of _/etc/mtab_."
35354 #. type: Plain text
35355 #: ../sys-utils/mount.8.adoc:1584
35357 "You can also free a loop device by hand, using *losetup -d* or *umount -d*."
35360 #. type: Plain text
35361 #: ../sys-utils/mount.8.adoc:1586
35363 "Since util-linux v2.29, *mount* re-uses the loop device rather than "
35364 "initializing a new device if the same backing file is already used for some "
35365 "loop device with the same offset and sizelimit. This is necessary to avoid a "
35366 "filesystem corruption."
35369 #. type: Plain text
35370 #: ../sys-utils/mount.8.adoc:1590
35372 msgid "*mount* has the following exit status values (the bits can be ORed):\n"
35375 #. type: Plain text
35376 #: ../sys-utils/mount.8.adoc:1596
35377 msgid "incorrect invocation or permissions"
35380 #. type: Plain text
35381 #: ../sys-utils/mount.8.adoc:1599
35382 msgid "system error (out of memory, cannot fork, no more loop devices)"
35385 #. type: Plain text
35386 #: ../sys-utils/mount.8.adoc:1602
35387 msgid "internal *mount* bug"
35390 #. type: Plain text
35391 #: ../sys-utils/mount.8.adoc:1605
35392 msgid "user interrupt"
35395 #. type: Plain text
35396 #: ../sys-utils/mount.8.adoc:1608
35397 msgid "problems writing or locking _/etc/mtab_"
35400 #. type: Plain text
35401 #: ../sys-utils/mount.8.adoc:1611
35402 msgid "mount failure"
35405 #. type: Plain text
35406 #: ../sys-utils/mount.8.adoc:1614
35407 msgid "some mount succeeded"
35410 #. type: Plain text
35411 #: ../sys-utils/mount.8.adoc:1616
35413 "The command *mount -a* returns 0 (all succeeded), 32 (all failed), or 64 "
35414 "(some failed, some succeeded)."
35418 #: ../sys-utils/mount.8.adoc:1617 ../sys-utils/umount.8.adoc:130
35420 msgid "EXTERNAL HELPERS"
35423 #. type: Plain text
35424 #: ../sys-utils/mount.8.adoc:1620
35425 msgid "The syntax of external mount helpers is:"
35428 #. type: Plain text
35429 #: ../sys-utils/mount.8.adoc:1622
35431 msgid "**/sbin/mount.**__suffix__ _spec dir_ [*-sfnv*] [*-N* _namespace_] [*-o* _options_] [*-t* __type__**.**_subtype_]\n"
35434 #. type: Plain text
35435 #: ../sys-utils/mount.8.adoc:1624
35437 "where the _suffix_ is the filesystem type and the *-sfnvoN* options have the "
35438 "same meaning as the normal mount options. The *-t* option is used for "
35439 "filesystems with subtypes support (for example */sbin/mount.fuse -t fuse."
35443 #. type: Plain text
35444 #: ../sys-utils/mount.8.adoc:1626
35446 "The command *mount* does not pass the mount options *unbindable*, "
35447 "*runbindable*, *private*, *rprivate*, *slave*, *rslave*, *shared*, "
35448 "*rshared*, *auto*, *noauto*, *comment*, *x-**, *loop*, *offset* and "
35449 "*sizelimit* to the mount.<suffix> helpers. All other options are used in a "
35450 "comma-separated list as an argument to the *-o* option."
35453 #. type: Labeled list
35454 #: ../sys-utils/mount.8.adoc:1629
35456 msgid "*LIBMOUNT_FORCE_MOUNT2*={always|never|auto}"
35459 #. type: Plain text
35460 #: ../sys-utils/mount.8.adoc:1631
35462 "force to use classic *mount*(2) system call (requires support for new file "
35463 "descriptors based mount API). The default is *auto*; in this case, libmount "
35464 "tries to be smart and use classic *mount*(2) only for well-known issues. If "
35465 "the new mount API is unavailable, libmount can still use traditional "
35466 "*mount*(2), although LIBMOUNT_FORCE_MOUNT2 is set to *never*."
35469 #. type: Plain text
35470 #: ../sys-utils/mount.8.adoc:1634
35471 msgid "overrides the default location of the _fstab_ file (ignored for suid)"
35474 #. type: Plain text
35475 #: ../sys-utils/mount.8.adoc:1640
35476 msgid "enables libblkid debug output"
35479 #. type: Plain text
35480 #: ../sys-utils/mount.8.adoc:1643
35481 msgid "enables loop device setup debug output"
35484 #. type: Plain text
35485 #: ../sys-utils/mount.8.adoc:1647
35487 "See also \"*The files /etc/fstab, /etc/mtab and /proc/mounts*\" section "
35491 #. type: Plain text
35492 #: ../sys-utils/mount.8.adoc:1650
35493 msgid "filesystem table"
35496 #. type: Labeled list
35497 #: ../sys-utils/mount.8.adoc:1651
35499 msgid "_/run/mount_"
35502 #. type: Plain text
35503 #: ../sys-utils/mount.8.adoc:1653
35504 msgid "libmount private runtime directory"
35507 #. type: Labeled list
35508 #: ../sys-utils/mount.8.adoc:1654 ../sys-utils/umount.8.adoc:160
35510 #| msgid "_/etc/fstab_"
35511 msgid "_/etc/mtab_"
35512 msgstr "_/etc/fstab_"
35514 #. type: Plain text
35515 #: ../sys-utils/mount.8.adoc:1656
35516 msgid "table of mounted filesystems or symlink to _/proc/mounts_"
35519 #. type: Labeled list
35520 #: ../sys-utils/mount.8.adoc:1657
35522 #| msgid "_/etc/fstab_"
35523 msgid "_/etc/mtab~_"
35524 msgstr "_/etc/fstab_"
35526 #. type: Plain text
35527 #: ../sys-utils/mount.8.adoc:1659
35528 msgid "lock file (unused on systems with _mtab_ symlink)"
35531 #. type: Labeled list
35532 #: ../sys-utils/mount.8.adoc:1660
35534 #| msgid "_/etc/fstab_"
35535 msgid "_/etc/mtab.tmp_"
35536 msgstr "_/etc/fstab_"
35538 #. type: Plain text
35539 #: ../sys-utils/mount.8.adoc:1662
35540 msgid "temporary file (unused on systems with _mtab_ symlink)"
35543 #. type: Labeled list
35544 #: ../sys-utils/mount.8.adoc:1663
35546 #| msgid "_/etc/fstab_"
35547 msgid "_/etc/filesystems_"
35548 msgstr "_/etc/fstab_"
35550 #. type: Plain text
35551 #: ../sys-utils/mount.8.adoc:1665
35552 msgid "a list of filesystem types to try"
35555 #. type: Plain text
35556 #: ../sys-utils/mount.8.adoc:1669
35558 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
35559 msgid "A *mount* command existed in Version 5 AT&T UNIX."
35560 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
35562 #. type: Plain text
35563 #: ../sys-utils/mount.8.adoc:1673
35564 msgid "It is possible for a corrupted filesystem to cause a crash."
35567 #. type: Plain text
35568 #: ../sys-utils/mount.8.adoc:1675
35570 "Some Linux filesystems don't support *-o sync* and *-o dirsync* (the ext2, "
35571 "ext3, ext4, fat and vfat filesystems _do_ support synchronous updates (a la "
35572 "BSD) when mounted with the *sync* option)."
35575 #. type: Plain text
35576 #: ../sys-utils/mount.8.adoc:1677
35578 "The *-o remount* may not be able to change mount parameters (all _ext2fs_-"
35579 "specific parameters, except *sb*, are changeable with a remount, for "
35580 "example, but you can't change *gid* or *umask* for the _fatfs_)."
35583 #. type: Plain text
35584 #: ../sys-utils/mount.8.adoc:1679
35586 "It is possible that the files _/etc/mtab_ and _/proc/mounts_ don't match on "
35587 "systems with a regular _mtab_ file. The first file is based only on the "
35588 "*mount* command options, but the content of the second file also depends on "
35589 "the kernel and others settings (e.g. on a remote NFS server -- in certain "
35590 "cases the *mount* command may report unreliable information about an NFS "
35591 "mount point and the _/proc/mount_ file usually contains more reliable "
35592 "information.) This is another reason to replace the _mtab_ file with a "
35593 "symlink to the _/proc/mounts_ file."
35596 #. type: Plain text
35597 #: ../sys-utils/mount.8.adoc:1681
35599 "Checking files on NFS filesystems referenced by file descriptors (i.e. the "
35600 "*fcntl* and *ioctl* families of functions) may lead to inconsistent results "
35601 "due to the lack of a consistency check in the kernel even if the *noac* "
35602 "mount option is used."
35605 #. type: Plain text
35606 #: ../sys-utils/mount.8.adoc:1683
35608 "The *loop* option with the *offset* or *sizelimit* options used may fail "
35609 "when using older kernels if the *mount* command can't confirm that the size "
35610 "of the block device has been configured as requested. This situation can be "
35611 "worked around by using the *losetup*(8) command manually before calling "
35612 "*mount* with the configured loop device."
35615 #. type: Plain text
35616 #: ../sys-utils/mount.8.adoc:1709
35621 "*filesystems*(5),\n"
35625 "*mount_namespaces*(7),\n"
35641 #: ../sys-utils/mountpoint.1.adoc:2
35643 msgid "mountpoint(1)"
35646 #. type: Plain text
35647 #: ../sys-utils/mountpoint.1.adoc:12
35648 msgid "mountpoint - see if a directory or file is a mountpoint"
35651 #. type: Plain text
35652 #: ../sys-utils/mountpoint.1.adoc:16
35654 msgid "*mountpoint* [*-d*|*-q*] _directory_|_file_\n"
35657 #. type: Plain text
35658 #: ../sys-utils/mountpoint.1.adoc:18
35660 msgid "*mountpoint* *-x* _device_\n"
35663 #. type: Plain text
35664 #: ../sys-utils/mountpoint.1.adoc:22
35666 msgid "*mountpoint* checks whether the given _directory_ or _file_ is mentioned in the _/proc/self/mountinfo_ file.\n"
35669 #. type: Labeled list
35670 #: ../sys-utils/mountpoint.1.adoc:25
35672 #| msgid "*-f*, *--fast*"
35673 msgid "*-d*, *--fs-devno*"
35674 msgstr "*-f*, *--fast*"
35676 #. type: Plain text
35677 #: ../sys-utils/mountpoint.1.adoc:27
35679 "Show the major/minor numbers of the device that is mounted on the given "
35683 #. type: Plain text
35684 #: ../sys-utils/mountpoint.1.adoc:30
35685 msgid "Be quiet - don't print anything."
35688 #. type: Labeled list
35689 #: ../sys-utils/mountpoint.1.adoc:31
35691 msgid "*--nofollow*"
35694 #. type: Plain text
35695 #: ../sys-utils/mountpoint.1.adoc:33
35697 "Do not follow symbolic link if it the last element of the _directory_ path."
35700 #. type: Labeled list
35701 #: ../sys-utils/mountpoint.1.adoc:34
35703 #| msgid "*-h*, *--help*"
35704 msgid "*-x*, *--devno*"
35705 msgstr "*-h*, *--help*"
35707 #. type: Plain text
35708 #: ../sys-utils/mountpoint.1.adoc:36
35710 "Show the major/minor numbers of the given blockdevice on standard output."
35713 #. type: Plain text
35714 #: ../sys-utils/mountpoint.1.adoc:42
35716 msgid "*mountpoint* has the following exit status values:\n"
35719 #. type: Plain text
35720 #: ../sys-utils/mountpoint.1.adoc:45
35722 "success; the directory is a mountpoint, or device is block device on *--"
35726 #. type: Plain text
35727 #: ../sys-utils/mountpoint.1.adoc:48
35728 msgid "failure; incorrect invocation, permissions or system error"
35731 #. type: Plain text
35732 #: ../sys-utils/mountpoint.1.adoc:51
35734 "failure; the directory is not a mountpoint, or device is not a block device "
35738 #. type: Plain text
35739 #: ../sys-utils/mountpoint.1.adoc:60
35741 "The util-linux *mountpoint* implementation was written from scratch for "
35742 "libmount. The original version for sysvinit suite was written by Miquel van "
35747 #: ../sys-utils/nsenter.1.adoc:2
35752 #. type: Plain text
35753 #: ../sys-utils/nsenter.1.adoc:12
35754 msgid "nsenter - run program in different namespaces"
35757 #. type: Plain text
35758 #: ../sys-utils/nsenter.1.adoc:16
35760 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
35761 msgid "*nsenter* [options] [_program_ [_arguments_]]\n"
35762 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
35764 #. type: Plain text
35765 #: ../sys-utils/nsenter.1.adoc:20
35767 "The *nsenter* command executes _program_ in the namespace(s) that are "
35768 "specified in the command-line options (described below). If _program_ is not "
35769 "given, then \"$\\{SHELL}\" is run (default: _/bin/sh_)."
35772 #. type: Plain text
35773 #: ../sys-utils/nsenter.1.adoc:22
35774 msgid "Enterable namespaces are:"
35777 #. type: Labeled list
35778 #: ../sys-utils/nsenter.1.adoc:23 ../sys-utils/unshare.1.adoc:27
35780 msgid "*mount namespace*"
35783 #. type: Plain text
35784 #: ../sys-utils/nsenter.1.adoc:25
35786 "Mounting and unmounting filesystems will not affect the rest of the system, "
35787 "except for filesystems which are explicitly marked as shared (with *mount --"
35788 "make-shared*; see _/proc/self/mountinfo_ for the *shared* flag). For further "
35789 "details, see *mount_namespaces*(7) and the discussion of the *CLONE_NEWNS* "
35790 "flag in *clone*(2)."
35793 #. type: Labeled list
35794 #: ../sys-utils/nsenter.1.adoc:26 ../sys-utils/unshare.1.adoc:32
35796 msgid "*UTS namespace*"
35799 #. type: Plain text
35800 #: ../sys-utils/nsenter.1.adoc:28 ../sys-utils/unshare.1.adoc:34
35802 "Setting hostname or domainname will not affect the rest of the system. For "
35803 "further details, see *uts_namespaces*(7)."
35806 #. type: Labeled list
35807 #: ../sys-utils/nsenter.1.adoc:29 ../sys-utils/unshare.1.adoc:35
35809 msgid "*IPC namespace*"
35812 #. type: Plain text
35813 #: ../sys-utils/nsenter.1.adoc:31 ../sys-utils/unshare.1.adoc:37
35815 "The process will have an independent namespace for POSIX message queues as "
35816 "well as System V message queues, semaphore sets and shared memory segments. "
35817 "For further details, see *ipc_namespaces*(7)."
35820 #. type: Labeled list
35821 #: ../sys-utils/nsenter.1.adoc:32 ../sys-utils/unshare.1.adoc:38
35823 msgid "*network namespace*"
35826 #. type: Plain text
35827 #: ../sys-utils/nsenter.1.adoc:34 ../sys-utils/unshare.1.adoc:40
35829 "The process will have independent IPv4 and IPv6 stacks, IP routing tables, "
35830 "firewall rules, the _/proc/net_ and _/sys/class/net_ directory trees, "
35831 "sockets, etc. For further details, see *network_namespaces*(7)."
35834 #. type: Labeled list
35835 #: ../sys-utils/nsenter.1.adoc:35 ../sys-utils/unshare.1.adoc:41
35837 msgid "*PID namespace*"
35840 #. type: Plain text
35841 #: ../sys-utils/nsenter.1.adoc:37
35843 "Children will have a set of PID to process mappings separate from the "
35844 "*nsenter* process. *nsenter* will fork by default if changing the PID "
35845 "namespace, so that the new program and its children share the same PID "
35846 "namespace and are visible to each other. If *--no-fork* is used, the new "
35847 "program will be exec'ed without forking. For further details, see "
35848 "*pid_namespaces*(7)."
35851 #. type: Labeled list
35852 #: ../sys-utils/nsenter.1.adoc:38 ../sys-utils/unshare.1.adoc:47
35854 msgid "*user namespace*"
35857 #. type: Plain text
35858 #: ../sys-utils/nsenter.1.adoc:40 ../sys-utils/unshare.1.adoc:49
35860 "The process will have a distinct set of UIDs, GIDs and capabilities. For "
35861 "further details, see *user_namespaces*(7)."
35864 #. type: Labeled list
35865 #: ../sys-utils/nsenter.1.adoc:41 ../sys-utils/unshare.1.adoc:44
35867 msgid "*cgroup namespace*"
35870 #. type: Plain text
35871 #: ../sys-utils/nsenter.1.adoc:43 ../sys-utils/unshare.1.adoc:46
35873 "The process will have a virtualized view of _/proc/self/cgroup_, and new "
35874 "cgroup mounts will be rooted at the namespace cgroup root. For further "
35875 "details, see *cgroup_namespaces*(7)."
35878 #. type: Labeled list
35879 #: ../sys-utils/nsenter.1.adoc:44 ../sys-utils/unshare.1.adoc:50
35881 msgid "*time namespace*"
35884 #. type: Plain text
35885 #: ../sys-utils/nsenter.1.adoc:46 ../sys-utils/unshare.1.adoc:52
35887 "The process can have a distinct view of *CLOCK_MONOTONIC* and/or "
35888 "*CLOCK_BOOTTIME* which can be changed using _/proc/self/timens_offsets_. For "
35889 "further details, see *time_namespaces*(7)."
35892 #. TRANSLATORS: Keep {asterisk} untranslated.
35893 #. type: Plain text
35894 #: ../sys-utils/nsenter.1.adoc:51
35896 "Various of the options below that relate to namespaces take an optional "
35897 "_file_ argument. This should be one of the _/proc/[pid]/ns/{asterisk}_ files "
35898 "described in *namespaces*(7), or the pathname of a bind mount that was "
35899 "created on one of those files."
35902 #. type: Plain text
35903 #: ../sys-utils/nsenter.1.adoc:55
35905 "Enter all namespaces of the target process by the default _/proc/[pid]/ns/"
35906 "{asterisk}_ namespace paths. The default paths to the target process "
35907 "namespaces may be overwritten by namespace specific options (e.g., *--all --"
35908 "mount*=[_path_])."
35911 #. type: Plain text
35912 #: ../sys-utils/nsenter.1.adoc:57
35914 "The user namespace will be ignored if the same as the caller's current user "
35915 "namespace. It prevents a caller that has dropped capabilities from regaining "
35916 "those capabilities via a call to setns(). See *setns*(2) for more details."
35919 #. type: Labeled list
35920 #: ../sys-utils/nsenter.1.adoc:58
35922 #| msgid "*-f*, *--fast*"
35923 msgid "*-t*, *--target* _PID_"
35924 msgstr "*-f*, *--fast*"
35926 #. type: Plain text
35927 #: ../sys-utils/nsenter.1.adoc:60
35929 "Specify a target process to get contexts from. The paths to the contexts "
35930 "specified by _pid_ are:"
35933 #. type: Labeled list
35934 #: ../sys-utils/nsenter.1.adoc:61
35936 msgid "_/proc/pid/ns/mnt_"
35939 #. type: Plain text
35940 #: ../sys-utils/nsenter.1.adoc:63
35941 msgid "the mount namespace"
35944 #. type: Labeled list
35945 #: ../sys-utils/nsenter.1.adoc:63
35947 msgid "_/proc/pid/ns/uts_"
35950 #. type: Plain text
35951 #: ../sys-utils/nsenter.1.adoc:65
35952 msgid "the UTS namespace"
35955 #. type: Labeled list
35956 #: ../sys-utils/nsenter.1.adoc:65
35958 msgid "_/proc/pid/ns/ipc_"
35961 #. type: Plain text
35962 #: ../sys-utils/nsenter.1.adoc:67
35963 msgid "the IPC namespace"
35966 #. type: Labeled list
35967 #: ../sys-utils/nsenter.1.adoc:67
35969 msgid "_/proc/pid/ns/net_"
35972 #. type: Plain text
35973 #: ../sys-utils/nsenter.1.adoc:69
35974 msgid "the network namespace"
35977 #. type: Labeled list
35978 #: ../sys-utils/nsenter.1.adoc:69
35980 msgid "_/proc/pid/ns/pid_"
35983 #. type: Plain text
35984 #: ../sys-utils/nsenter.1.adoc:71
35985 msgid "the PID namespace"
35988 #. type: Labeled list
35989 #: ../sys-utils/nsenter.1.adoc:71
35991 msgid "_/proc/pid/ns/user_"
35994 #. type: Plain text
35995 #: ../sys-utils/nsenter.1.adoc:73
35996 msgid "the user namespace"
35999 #. type: Labeled list
36000 #: ../sys-utils/nsenter.1.adoc:73
36002 msgid "_/proc/pid/ns/cgroup_"
36005 #. type: Plain text
36006 #: ../sys-utils/nsenter.1.adoc:75
36007 msgid "the cgroup namespace"
36010 #. type: Labeled list
36011 #: ../sys-utils/nsenter.1.adoc:75
36013 msgid "_/proc/pid/ns/time_"
36016 #. type: Plain text
36017 #: ../sys-utils/nsenter.1.adoc:77
36018 msgid "the time namespace"
36021 #. type: Labeled list
36022 #: ../sys-utils/nsenter.1.adoc:77
36024 msgid "_/proc/pid/root_"
36027 #. type: Plain text
36028 #: ../sys-utils/nsenter.1.adoc:79
36029 msgid "the root directory"
36032 #. type: Labeled list
36033 #: ../sys-utils/nsenter.1.adoc:79
36035 msgid "_/proc/pid/cwd_"
36038 #. type: Plain text
36039 #: ../sys-utils/nsenter.1.adoc:81
36040 msgid "the working directory respectively"
36043 #. type: Labeled list
36044 #: ../sys-utils/nsenter.1.adoc:82
36046 msgid "*-m*, *--mount*[=_file_]"
36049 #. type: Plain text
36050 #: ../sys-utils/nsenter.1.adoc:84
36052 "Enter the mount namespace. If no file is specified, enter the mount "
36053 "namespace of the target process. If _file_ is specified, enter the mount "
36054 "namespace specified by _file_."
36057 #. type: Labeled list
36058 #: ../sys-utils/nsenter.1.adoc:85
36060 msgid "*-u*, *--uts*[=_file_]"
36063 #. type: Plain text
36064 #: ../sys-utils/nsenter.1.adoc:87
36066 "Enter the UTS namespace. If no file is specified, enter the UTS namespace of "
36067 "the target process. If _file_ is specified, enter the UTS namespace "
36068 "specified by _file_."
36071 #. type: Labeled list
36072 #: ../sys-utils/nsenter.1.adoc:88
36074 msgid "*-i*, *--ipc*[=_file_]"
36077 #. type: Plain text
36078 #: ../sys-utils/nsenter.1.adoc:90
36080 "Enter the IPC namespace. If no file is specified, enter the IPC namespace of "
36081 "the target process. If _file_ is specified, enter the IPC namespace "
36082 "specified by _file_."
36085 #. type: Labeled list
36086 #: ../sys-utils/nsenter.1.adoc:91
36088 msgid "*-n*, *--net*[=_file_]"
36091 #. type: Plain text
36092 #: ../sys-utils/nsenter.1.adoc:93
36094 "Enter the network namespace. If no file is specified, enter the network "
36095 "namespace of the target process. If _file_ is specified, enter the network "
36096 "namespace specified by _file_."
36099 #. type: Labeled list
36100 #: ../sys-utils/nsenter.1.adoc:94
36102 msgid "*-p*, *--pid*[=_file_]"
36105 #. type: Plain text
36106 #: ../sys-utils/nsenter.1.adoc:96
36108 "Enter the PID namespace. If no file is specified, enter the PID namespace of "
36109 "the target process. If _file_ is specified, enter the PID namespace "
36110 "specified by _file_."
36113 #. type: Labeled list
36114 #: ../sys-utils/nsenter.1.adoc:97
36116 #| msgid "*-s*, **--shell**=__shell__"
36117 msgid "*-U*, *--user*[=_file_]"
36118 msgstr "*-s*, **--shell**=__shell__"
36120 #. type: Plain text
36121 #: ../sys-utils/nsenter.1.adoc:99
36123 "Enter the user namespace. If no file is specified, enter the user namespace "
36124 "of the target process. If _file_ is specified, enter the user namespace "
36125 "specified by _file_. See also the *--setuid* and *--setgid* options."
36128 #. type: Labeled list
36129 #: ../sys-utils/nsenter.1.adoc:100
36131 #| msgid "*-h*, *--help*"
36132 msgid "*--user-parent*"
36133 msgstr "*-h*, *--help*"
36135 #. type: Plain text
36136 #: ../sys-utils/nsenter.1.adoc:103
36138 "Enter the parent user namespace. Parent user namespace will be acquired from "
36139 "any other enabled namespace. If combined with *--user* option the parent "
36140 "user namespace will be fetched from the user namespace and replace it."
36143 #. type: Labeled list
36144 #: ../sys-utils/nsenter.1.adoc:104
36146 #| msgid "*-g*, **--group**=__group__"
36147 msgid "*-C*, *--cgroup*[=_file_]"
36148 msgstr "*-g*, **--group**=__skupina__"
36150 #. type: Plain text
36151 #: ../sys-utils/nsenter.1.adoc:106
36153 "Enter the cgroup namespace. If no file is specified, enter the cgroup "
36154 "namespace of the target process. If _file_ is specified, enter the cgroup "
36155 "namespace specified by _file_."
36158 #. type: Labeled list
36159 #: ../sys-utils/nsenter.1.adoc:107
36161 msgid "*-T*, *--time*[=_file_]"
36164 #. type: Plain text
36165 #: ../sys-utils/nsenter.1.adoc:109
36167 "Enter the time namespace. If no file is specified, enter the time namespace "
36168 "of the target process. If _file_ is specified, enter the time namespace "
36169 "specified by _file_."
36172 #. type: Labeled list
36173 #: ../sys-utils/nsenter.1.adoc:110 ../sys-utils/unshare.1.adoc:135
36175 #| msgid "*-f*, *--fast*"
36176 msgid "*-G*, *--setgid* _gid_"
36177 msgstr "*-f*, *--fast*"
36179 #. type: Plain text
36180 #: ../sys-utils/nsenter.1.adoc:114
36182 "Set the group ID which will be used in the entered namespace and drop "
36183 "supplementary groups. *nsenter* always sets GID for user namespaces, the "
36184 "default is 0. If the argument \"follow\" is specified the GID of the target "
36188 #. type: Labeled list
36189 #: ../sys-utils/nsenter.1.adoc:115 ../sys-utils/unshare.1.adoc:132
36191 #| msgid "*-f*, *--fast*"
36192 msgid "*-S*, *--setuid* _uid_"
36193 msgstr "*-f*, *--fast*"
36195 #. type: Plain text
36196 #: ../sys-utils/nsenter.1.adoc:119
36198 "Set the user ID which will be used in the entered namespace. *nsenter* "
36199 "always sets UID for user namespaces, the default is 0. If the argument "
36200 "\"follow\" is specified the UID of the target process is used."
36203 #. type: Labeled list
36204 #: ../sys-utils/nsenter.1.adoc:120 ../sys-utils/unshare.1.adoc:84
36206 msgid "*--keep-caps*"
36209 #. type: Plain text
36210 #: ../sys-utils/nsenter.1.adoc:122 ../sys-utils/unshare.1.adoc:86
36212 "When the *--user* option is given, ensure that capabilities granted in the "
36213 "user namespace are preserved in the child process."
36216 #. type: Labeled list
36217 #: ../sys-utils/nsenter.1.adoc:123
36219 msgid "*--preserve-credentials*"
36222 #. type: Plain text
36223 #: ../sys-utils/nsenter.1.adoc:125
36225 "Don't modify UID and GID when enter user namespace. The default is to drops "
36226 "supplementary groups and sets GID and UID to 0."
36229 #. type: Labeled list
36230 #: ../sys-utils/nsenter.1.adoc:126
36232 msgid "*-r*, *--root*[=_directory_]"
36235 #. type: Plain text
36236 #: ../sys-utils/nsenter.1.adoc:128
36238 "Set the root directory. If no directory is specified, set the root directory "
36239 "to the root directory of the target process. If directory is specified, set "
36240 "the root directory to the specified directory. The specified _directory_ is "
36241 "open before it switches to the requested namespaces."
36244 #. type: Labeled list
36245 #: ../sys-utils/nsenter.1.adoc:129
36247 msgid "*-w*, *--wd*[=_directory_]"
36250 #. type: Plain text
36251 #: ../sys-utils/nsenter.1.adoc:131
36253 "Set the working directory. If no directory is specified, set the working "
36254 "directory to the working directory of the target process. If directory is "
36255 "specified, set the working directory to the specified directory. The "
36256 "specified _directory_ is open before it switches to the requested "
36257 "namespaces, it means the specified directory works as \"tunnel\" to the "
36258 "current namespace. See also *--wdns*."
36261 #. type: Labeled list
36262 #: ../sys-utils/nsenter.1.adoc:132
36264 msgid "*-W*, *--wdns*[=_directory_]"
36267 #. type: Plain text
36268 #: ../sys-utils/nsenter.1.adoc:134
36270 "Set the working directory. The _directory_ is open after switch to the "
36271 "requested namespaces and after *chroot*(2) call. The options *--wd* and *--"
36272 "wdns* are mutually exclusive."
36275 #. type: Labeled list
36276 #: ../sys-utils/nsenter.1.adoc:135
36278 #| msgid "*-h*, *--help*"
36279 msgid "*-e*, *--env*"
36280 msgstr "*-h*, *--help*"
36282 #. type: Plain text
36283 #: ../sys-utils/nsenter.1.adoc:137
36285 "Pass environment variables from the target process to the new process being "
36286 "created. If this option is not provided, the environment variables will "
36287 "remain the same as in the current namespace.."
36290 #. type: Plain text
36291 #: ../sys-utils/nsenter.1.adoc:140
36293 "Do not fork before exec'ing the specified program. By default, when entering "
36294 "a PID namespace, *nsenter* calls *fork* before calling *exec* so that any "
36295 "children will also be in the newly entered PID namespace."
36298 #. type: Labeled list
36299 #: ../sys-utils/nsenter.1.adoc:141
36301 msgid "*-Z*, *--follow-context*"
36304 #. type: Plain text
36305 #: ../sys-utils/nsenter.1.adoc:143
36307 "Set the SELinux security context used for executing a new process according "
36308 "to already running process specified by *--target* PID. (The util-linux has "
36309 "to be compiled with SELinux support otherwise the option is unavailable.)"
36312 #. type: Labeled list
36313 #: ../sys-utils/nsenter.1.adoc:144
36315 #| msgid "*-G*, **--supp-group**=__group__"
36316 msgid "*-c*, *--join-cgroup*"
36317 msgstr "*-G*, **--supp-group**=__skupina__"
36319 #. type: Plain text
36320 #: ../sys-utils/nsenter.1.adoc:146
36321 msgid "Add the initiated process to the cgroup of the target process."
36324 #. type: Plain text
36325 #: ../sys-utils/nsenter.1.adoc:152
36327 "The *--user-parent* option requires Linux 4.9 or higher, older kernels will "
36328 "raise inappropriate ioctl for device error."
36331 #. type: Plain text
36332 #: ../sys-utils/nsenter.1.adoc:157
36334 "mailto:biederm@xmission.com[Eric Biederman], mailto:kzak@redhat.com[Karel "
36338 #. type: Plain text
36339 #: ../sys-utils/nsenter.1.adoc:163
36344 "*namespaces*(7)\n"
36348 #: ../sys-utils/pivot_root.8.adoc:2
36350 msgid "pivot_root(8)"
36353 #. type: Plain text
36354 #: ../sys-utils/pivot_root.8.adoc:12
36355 msgid "pivot_root - change the root filesystem"
36358 #. type: Plain text
36359 #: ../sys-utils/pivot_root.8.adoc:16
36361 msgid "*pivot_root* _new_root_ _put_old_\n"
36364 #. type: Plain text
36365 #: ../sys-utils/pivot_root.8.adoc:20
36367 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"
36370 #. type: Plain text
36371 #: ../sys-utils/pivot_root.8.adoc:22
36373 "Note that, depending on the implementation of *pivot_root*, root and current "
36374 "working directory of the caller may or may not change. The following is a "
36375 "sequence for invoking *pivot_root* that works in either case, assuming that "
36376 "*pivot_root* and *chroot* are in the current *PATH*:"
36379 #. type: delimited block .
36380 #: ../sys-utils/pivot_root.8.adoc:27
36384 "pivot_root . put_old\n"
36385 "exec chroot . command\n"
36388 #. type: Plain text
36389 #: ../sys-utils/pivot_root.8.adoc:30
36391 "Note that *chroot* must be available under the old root and under the new "
36392 "root, because *pivot_root* may or may not have implicitly changed the root "
36393 "directory of the shell."
36396 #. type: Plain text
36397 #: ../sys-utils/pivot_root.8.adoc:32
36399 "Note that *exec chroot* changes the running executable, which is necessary "
36400 "if the old root directory should be unmounted afterwards. Also note that "
36401 "standard input, output, and error may still point to a device on the old "
36402 "root file system, keeping it busy. They can easily be changed when invoking "
36403 "*chroot* (see below; note the absence of leading slashes to make it work "
36404 "whether *pivot_root* has changed the shell's root or not)."
36407 #. type: Plain text
36408 #: ../sys-utils/pivot_root.8.adoc:40
36409 msgid "Change the root file system to _/dev/hda1_ from an interactive shell:"
36412 #. type: delimited block .
36413 #: ../sys-utils/pivot_root.8.adoc:47
36416 "mount /dev/hda1 /new-root\n"
36418 "pivot_root . old-root\n"
36419 "exec chroot . sh <dev/console >dev/console 2>&1\n"
36420 "umount /old-root\n"
36423 #. type: Plain text
36424 #: ../sys-utils/pivot_root.8.adoc:50
36426 "Mount the new root file system over NFS from 10.0.0.1:/my_root and run "
36430 #. type: delimited block .
36431 #: ../sys-utils/pivot_root.8.adoc:61
36434 "ifconfig lo 127.0.0.1 up # for portmap\n"
36435 "# configure Ethernet or such\n"
36436 "portmap # for lockd (implicitly started by mount)\n"
36437 "mount -o ro 10.0.0.1:/my_root /mnt\n"
36438 "killall portmap # portmap keeps old root busy\n"
36440 "pivot_root . old_root\n"
36441 "exec chroot . sh -c 'umount /old_root; exec /sbin/init' \\\n"
36442 " <dev/console >dev/console 2>&1\n"
36445 #. type: Plain text
36446 #: ../sys-utils/pivot_root.8.adoc:70
36450 "*pivot_root*(2),\n"
36452 "*switch_root*(8),\n"
36457 #. Copyright 2011 Davidlohr Bueso <dave@gnu.org>
36458 #. May be distributed under the GNU General Public License
36460 #: ../sys-utils/prlimit.1.adoc:7
36465 #. type: Plain text
36466 #: ../sys-utils/prlimit.1.adoc:18
36467 msgid "prlimit - get and set process resource limits"
36470 #. type: Plain text
36471 #: ../sys-utils/prlimit.1.adoc:22
36473 msgid "*prlimit* [options] [*--resource*[=_limits_]] [*--pid* _PID_]\n"
36476 #. type: Plain text
36477 #: ../sys-utils/prlimit.1.adoc:24
36479 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
36480 msgid "*prlimit* [options] [*--resource*[=_limits_]] _command_ [_argument_...]\n"
36481 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
36483 #. type: Plain text
36484 #: ../sys-utils/prlimit.1.adoc:28
36486 "Given a process ID and one or more resources, *prlimit* tries to retrieve "
36487 "and/or modify the limits."
36490 #. type: Plain text
36491 #: ../sys-utils/prlimit.1.adoc:30
36493 "When _command_ is given, *prlimit* will run this command with the given "
36497 #. type: Plain text
36498 #: ../sys-utils/prlimit.1.adoc:32
36500 "The _limits_ parameter is composed of a soft and a hard value, separated by "
36501 "a colon (:), in order to modify the existing values. If no _limits_ are "
36502 "given, *prlimit* will display the current values. If one of the values is "
36503 "not given, then the existing one will be used. To specify the unlimited or "
36504 "infinity limit (*RLIM_INFINITY*), the -1 or 'unlimited' string can be passed."
36507 #. type: Plain text
36508 #: ../sys-utils/prlimit.1.adoc:34
36510 "Because of the nature of limits, the soft limit must be lower or equal to "
36511 "the high limit (also called the ceiling). To see all available resource "
36512 "limits, refer to the *RESOURCE OPTIONS* section."
36515 #. TRANSLATORS: Keep {colon} untranslated.
36516 #. type: Plain text
36517 #: ../sys-utils/prlimit.1.adoc:37
36518 msgid "_soft_{colon}__hard__ Specify both limits."
36521 #. type: Plain text
36522 #: ../sys-utils/prlimit.1.adoc:38
36523 msgid "_soft_{colon} Specify only the soft limit."
36526 #. type: Plain text
36527 #: ../sys-utils/prlimit.1.adoc:39
36528 msgid "{colon}__hard__ Specify only the hard limit."
36531 #. type: Plain text
36532 #: ../sys-utils/prlimit.1.adoc:40
36533 msgid "_value_ Specify both limits to the same value."
36537 #: ../sys-utils/prlimit.1.adoc:41
36540 msgid "GENERAL OPTIONS"
36543 #. type: Plain text
36544 #: ../sys-utils/prlimit.1.adoc:48
36546 "Define the output columns to use. If no output arrangement is specified, "
36547 "then a default set is used. Use *--help* to get a list of all supported "
36551 #. type: Plain text
36552 #: ../sys-utils/prlimit.1.adoc:51
36554 "Specify the process id; if none is given, the running process will be used."
36558 #: ../sys-utils/prlimit.1.adoc:60
36561 msgid "RESOURCE OPTIONS"
36564 #. type: Labeled list
36565 #: ../sys-utils/prlimit.1.adoc:62
36567 #| msgid "*-w*, **--whitelist-environment**=__list__"
36568 msgid "*-c*, *--core*[=_limits_]"
36569 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36571 #. type: Plain text
36572 #: ../sys-utils/prlimit.1.adoc:64
36573 msgid "Maximum size of a core file."
36576 #. type: Labeled list
36577 #: ../sys-utils/prlimit.1.adoc:65
36579 #| msgid "*-w*, **--whitelist-environment**=__list__"
36580 msgid "*-d*, *--data*[=_limits_]"
36581 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36583 #. type: Plain text
36584 #: ../sys-utils/prlimit.1.adoc:67
36585 msgid "Maximum data size."
36588 #. type: Labeled list
36589 #: ../sys-utils/prlimit.1.adoc:68
36591 #| msgid "*-w*, **--whitelist-environment**=__list__"
36592 msgid "*-e*, *--nice*[=_limits_]"
36593 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36595 #. type: Plain text
36596 #: ../sys-utils/prlimit.1.adoc:70
36597 msgid "Maximum nice priority allowed to raise."
36600 #. type: Labeled list
36601 #: ../sys-utils/prlimit.1.adoc:71
36603 #| msgid "*-f*, *--fast*"
36604 msgid "*-f*, *--fsize*[=_limits_]"
36605 msgstr "*-f*, *--fast*"
36607 #. type: Plain text
36608 #: ../sys-utils/prlimit.1.adoc:73
36609 msgid "Maximum file size."
36612 #. type: Labeled list
36613 #: ../sys-utils/prlimit.1.adoc:74
36615 #| msgid "*-w*, **--whitelist-environment**=__list__"
36616 msgid "*-i*, *--sigpending*[=_limits_]"
36617 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36619 #. type: Plain text
36620 #: ../sys-utils/prlimit.1.adoc:76
36621 msgid "Maximum number of pending signals."
36624 #. type: Labeled list
36625 #: ../sys-utils/prlimit.1.adoc:77
36627 #| msgid "*-P*, *--pty*"
36628 msgid "*-l*, *--memlock*[=_limits_]"
36629 msgstr "*-P*, *--pty*"
36631 #. type: Plain text
36632 #: ../sys-utils/prlimit.1.adoc:79
36633 msgid "Maximum locked-in-memory address space."
36636 #. type: Labeled list
36637 #: ../sys-utils/prlimit.1.adoc:80
36639 #| msgid "*-P*, *--pty*"
36640 msgid "*-m*, *--rss*[=_limits_]"
36641 msgstr "*-P*, *--pty*"
36643 #. type: Plain text
36644 #: ../sys-utils/prlimit.1.adoc:82
36645 msgid "Maximum Resident Set Size (RSS)."
36648 #. type: Labeled list
36649 #: ../sys-utils/prlimit.1.adoc:83
36651 #| msgid "*-w*, **--whitelist-environment**=__list__"
36652 msgid "*-n*, *--nofile*[=_limits_]"
36653 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36655 #. type: Plain text
36656 #: ../sys-utils/prlimit.1.adoc:85
36657 msgid "Maximum number of open files."
36660 #. type: Labeled list
36661 #: ../sys-utils/prlimit.1.adoc:86
36663 #| msgid "*-w*, **--whitelist-environment**=__list__"
36664 msgid "*-q*, *--msgqueue*[=_limits_]"
36665 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36667 #. type: Plain text
36668 #: ../sys-utils/prlimit.1.adoc:88
36669 msgid "Maximum number of bytes in POSIX message queues."
36672 #. type: Labeled list
36673 #: ../sys-utils/prlimit.1.adoc:89
36675 #| msgid "*-w*, **--whitelist-environment**=__list__"
36676 msgid "*-r*, *--rtprio*[=_limits_]"
36677 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36679 #. type: Plain text
36680 #: ../sys-utils/prlimit.1.adoc:91
36681 msgid "Maximum real-time priority."
36684 #. type: Labeled list
36685 #: ../sys-utils/prlimit.1.adoc:92
36687 #| msgid "*-w*, **--whitelist-environment**=__list__"
36688 msgid "*-s*, *--stack*[=_limits_]"
36689 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36691 #. type: Plain text
36692 #: ../sys-utils/prlimit.1.adoc:94
36693 msgid "Maximum size of the stack."
36696 #. type: Labeled list
36697 #: ../sys-utils/prlimit.1.adoc:95
36699 #| msgid "*-P*, *--pty*"
36700 msgid "*-t*, *--cpu*[=_limits_]"
36701 msgstr "*-P*, *--pty*"
36703 #. type: Plain text
36704 #: ../sys-utils/prlimit.1.adoc:97
36705 msgid "CPU time, in seconds."
36708 #. type: Labeled list
36709 #: ../sys-utils/prlimit.1.adoc:98
36711 #| msgid "*-w*, **--whitelist-environment**=__list__"
36712 msgid "*-u*, *--nproc*[=_limits_]"
36713 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36715 #. type: Plain text
36716 #: ../sys-utils/prlimit.1.adoc:100
36717 msgid "Maximum number of processes."
36720 #. type: Labeled list
36721 #: ../sys-utils/prlimit.1.adoc:101
36723 #| msgid "*-P*, *--pty*"
36724 msgid "*-v*, *--as*[=_limits_]"
36725 msgstr "*-P*, *--pty*"
36727 #. type: Plain text
36728 #: ../sys-utils/prlimit.1.adoc:103
36729 msgid "Address space limit."
36732 #. type: Labeled list
36733 #: ../sys-utils/prlimit.1.adoc:104
36735 #| msgid "*-*, *-l*, *--login*"
36736 msgid "*-x*, *--locks*[=_limits_]"
36737 msgstr "*-*, *-l*, *--login*"
36739 #. type: Plain text
36740 #: ../sys-utils/prlimit.1.adoc:106
36741 msgid "Maximum number of file locks held."
36744 #. type: Labeled list
36745 #: ../sys-utils/prlimit.1.adoc:107
36747 #| msgid "*-w*, **--whitelist-environment**=__list__"
36748 msgid "*-y*, *--rttime*[=_limits_]"
36749 msgstr "*-w*, **--whitelist-environment**=__seznam__"
36751 #. type: Plain text
36752 #: ../sys-utils/prlimit.1.adoc:109
36753 msgid "Timeout for real-time tasks."
36756 #. type: Plain text
36757 #: ../sys-utils/prlimit.1.adoc:113
36759 "The *prlimit*(2) system call is supported since Linux 2.6.36, older kernels "
36760 "will break this program."
36763 #. type: Labeled list
36764 #: ../sys-utils/prlimit.1.adoc:116
36766 msgid "*prlimit --pid 13134*"
36769 #. type: Plain text
36770 #: ../sys-utils/prlimit.1.adoc:118
36771 msgid "Display limit values for all current resources."
36774 #. type: Labeled list
36775 #: ../sys-utils/prlimit.1.adoc:119
36777 msgid "*prlimit --pid 13134 --rss --nofile=1024:4095*"
36780 #. type: Plain text
36781 #: ../sys-utils/prlimit.1.adoc:121
36783 "Display the limits of the RSS, and set the soft and hard limits for the "
36784 "number of open files to 1024 and 4095, respectively."
36787 #. type: Labeled list
36788 #: ../sys-utils/prlimit.1.adoc:122
36790 msgid "*prlimit --pid 13134 --nproc=512:*"
36793 #. type: Plain text
36794 #: ../sys-utils/prlimit.1.adoc:124
36795 msgid "Modify only the soft limit for the number of processes."
36798 #. type: Labeled list
36799 #: ../sys-utils/prlimit.1.adoc:125
36801 msgid "*prlimit --pid $$ --nproc=unlimited*"
36804 #. type: Plain text
36805 #: ../sys-utils/prlimit.1.adoc:127
36807 "Set for the current process both the soft and ceiling values for the number "
36808 "of processes to unlimited."
36811 #. type: Labeled list
36812 #: ../sys-utils/prlimit.1.adoc:128
36814 msgid "*prlimit --cpu=10 sort -u hugefile*"
36817 #. type: Plain text
36818 #: ../sys-utils/prlimit.1.adoc:130
36820 "Set both the soft and hard CPU time limit to ten seconds and run *sort*(1)."
36823 #. type: Plain text
36824 #: ../sys-utils/prlimit.1.adoc:134
36825 msgid "mailto:dave@gnu.org[Davidlohr Bueso] - In memory of Dennis M. Ritchie."
36828 #. type: Plain text
36829 #: ../sys-utils/prlimit.1.adoc:139
36837 #: ../sys-utils/readprofile.8.adoc:2
36839 msgid "readprofile(8)"
36842 #. type: Plain text
36843 #: ../sys-utils/readprofile.8.adoc:12
36844 msgid "readprofile - read kernel profiling information"
36847 #. type: Plain text
36848 #: ../sys-utils/readprofile.8.adoc:16
36850 msgid "*readprofile* [options]\n"
36854 #: ../sys-utils/readprofile.8.adoc:17
36859 #. type: Plain text
36860 #: ../sys-utils/readprofile.8.adoc:20
36861 msgid "This manpage documents version 2.0 of the program."
36864 #. type: Plain text
36865 #: ../sys-utils/readprofile.8.adoc:24
36867 "The *readprofile* command uses the _/proc/profile_ information to print "
36868 "ascii data on standard output. The output is organized in three columns: the "
36869 "first is the number of clock ticks, the second is the name of the C function "
36870 "in the kernel where those many ticks occurred, and the third is the "
36871 "normalized `load' of the procedure, calculated as a ratio between the number "
36872 "of ticks and the length of the procedure. The output is filled with blanks "
36873 "to ease readability."
36876 #. type: Plain text
36877 #: ../sys-utils/readprofile.8.adoc:29
36879 "Print all symbols in the mapfile. By default the procedures with reported "
36880 "ticks are not printed."
36883 #. type: Labeled list
36884 #: ../sys-utils/readprofile.8.adoc:30
36886 #| msgid "*-f*, *--fast*"
36887 msgid "*-b*, *--histbin*"
36888 msgstr "*-f*, *--fast*"
36890 #. type: Plain text
36891 #: ../sys-utils/readprofile.8.adoc:32
36892 msgid "Print individual histogram-bin counts."
36895 #. type: Plain text
36896 #: ../sys-utils/readprofile.8.adoc:35
36898 "Info. This makes *readprofile* only print the profiling step used by the "
36899 "kernel. The profiling step is the resolution of the profiling buffer, and is "
36900 "chosen during kernel configuration (through *make config*), or in the "
36901 "kernel's command line. If the *-t* (terse) switch is used together with *-i* "
36902 "only the decimal number is printed."
36905 #. type: Labeled list
36906 #: ../sys-utils/readprofile.8.adoc:36
36908 msgid "*-m*, *--mapfile* _mapfile_"
36911 #. type: Plain text
36912 #: ../sys-utils/readprofile.8.adoc:38
36914 "Specify a mapfile, which by default is _/usr/src/linux/System.map_. You "
36915 "should specify the map file on cmdline if your current kernel isn't the last "
36916 "one you compiled, or if you keep System.map elsewhere. If the name of the "
36917 "map file ends with _.gz_ it is decompressed on the fly."
36920 #. type: Labeled list
36921 #: ../sys-utils/readprofile.8.adoc:39
36923 msgid "*-M*, *--multiplier* _multiplier_"
36926 #. type: Plain text
36927 #: ../sys-utils/readprofile.8.adoc:41
36929 "On some architectures it is possible to alter the frequency at which the "
36930 "kernel delivers profiling interrupts to each CPU. This option allows you to "
36931 "set the frequency, as a multiplier of the system clock frequency, HZ. Linux "
36932 "2.6.16 dropped multiplier support for most systems. This option also resets "
36933 "the profiling buffer, and requires superuser privileges."
36936 #. type: Labeled list
36937 #: ../sys-utils/readprofile.8.adoc:42
36939 msgid "*-p*, *--profile* _pro-file_"
36942 #. type: Plain text
36943 #: ../sys-utils/readprofile.8.adoc:44
36945 "Specify a different profiling buffer, which by default is _/proc/profile_. "
36946 "Using a different pro-file is useful if you want to `freeze' the kernel "
36947 "profiling at some time and read it later. The _/proc/profile_ file can be "
36948 "copied using *cat*(1) or *cp*(1). There is no more support for compressed "
36949 "profile buffers, like in *readprofile-1.1*, because the program needs to "
36950 "know the size of the buffer in advance."
36953 #. type: Labeled list
36954 #: ../sys-utils/readprofile.8.adoc:45 ../sys-utils/tunelp.8.adoc:53
36955 #: ../sys-utils/zramctl.8.adoc:61
36957 #| msgid "*-f*, *--fast*"
36958 msgid "*-r*, *--reset*"
36959 msgstr "*-f*, *--fast*"
36961 #. type: Plain text
36962 #: ../sys-utils/readprofile.8.adoc:47
36964 "Reset the profiling buffer. This can only be invoked by root, because _/proc/"
36965 "profile_ is readable by everybody but writable only by the superuser. "
36966 "However, you can make *readprofile* set-user-ID 0, in order to reset the "
36967 "buffer without gaining privileges."
36970 #. type: Labeled list
36971 #: ../sys-utils/readprofile.8.adoc:48
36973 msgid "*-s, --counters*"
36976 #. type: Plain text
36977 #: ../sys-utils/readprofile.8.adoc:50
36978 msgid "Print individual counters within functions."
36981 #. type: Plain text
36982 #: ../sys-utils/readprofile.8.adoc:53
36984 "Verbose. The output is organized in four columns and filled with blanks. The "
36985 "first column is the RAM address of a kernel function, the second is the name "
36986 "of the function, the third is the number of clock ticks and the last is the "
36990 #. type: Labeled list
36991 #: ../sys-utils/readprofile.8.adoc:58
36993 msgid "_/proc/profile_"
36996 #. type: Plain text
36997 #: ../sys-utils/readprofile.8.adoc:60
36998 msgid "A binary snapshot of the profiling buffer."
37001 #. type: Labeled list
37002 #: ../sys-utils/readprofile.8.adoc:61
37004 msgid "_/usr/src/linux/System.map_"
37007 #. type: Plain text
37008 #: ../sys-utils/readprofile.8.adoc:63
37009 msgid "The symbol table for the kernel."
37012 #. type: Labeled list
37013 #: ../sys-utils/readprofile.8.adoc:64
37015 msgid "_/usr/src/linux/*_"
37018 #. type: Plain text
37019 #: ../sys-utils/readprofile.8.adoc:66
37020 msgid "The program being profiled :-)"
37023 #. type: Plain text
37024 #: ../sys-utils/readprofile.8.adoc:70
37026 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"
37029 #. type: Plain text
37030 #: ../sys-utils/readprofile.8.adoc:72
37032 "This program only works with ELF kernels. The change for a.out kernels is "
37033 "trivial, and left as an exercise to the a.out user."
37036 #. type: Plain text
37037 #: ../sys-utils/readprofile.8.adoc:74
37039 "To enable profiling, the kernel must be rebooted, because no profiling "
37040 "module is available, and it wouldn't be easy to build. To enable profiling, "
37041 "you can specify *profile*=_2_ (or another number) on the kernel commandline. "
37042 "The number you specify is the two-exponent used as profiling step."
37045 #. type: Plain text
37046 #: ../sys-utils/readprofile.8.adoc:76
37048 "Profiling is disabled when interrupts are inhibited. This means that many "
37049 "profiling ticks happen when interrupts are re-enabled. Watch out for "
37050 "misleading information."
37053 #. type: Plain text
37054 #: ../sys-utils/readprofile.8.adoc:80
37055 msgid "Browse the profiling buffer ordering by clock ticks:"
37058 #. type: delimited block .
37059 #: ../sys-utils/readprofile.8.adoc:83
37061 msgid " readprofile | sort -nr | less\n"
37064 #. type: Plain text
37065 #: ../sys-utils/readprofile.8.adoc:86
37066 msgid "Print the 20 most loaded procedures:"
37069 #. type: delimited block .
37070 #: ../sys-utils/readprofile.8.adoc:89
37072 msgid " readprofile | sort -nr +2 | head -20\n"
37075 #. type: Plain text
37076 #: ../sys-utils/readprofile.8.adoc:92
37077 msgid "Print only filesystem profile:"
37080 #. type: delimited block .
37081 #: ../sys-utils/readprofile.8.adoc:95
37083 msgid " readprofile | grep _ext2\n"
37086 #. type: Plain text
37087 #: ../sys-utils/readprofile.8.adoc:98
37088 msgid "Look at all the kernel information, with ram addresses:"
37091 #. type: delimited block .
37092 #: ../sys-utils/readprofile.8.adoc:101
37094 msgid " readprofile -av | less\n"
37097 #. type: Plain text
37098 #: ../sys-utils/readprofile.8.adoc:104
37099 msgid "Browse a 'frozen' profile buffer for a non current kernel:"
37102 #. type: delimited block .
37103 #: ../sys-utils/readprofile.8.adoc:107
37105 msgid " readprofile -p ~/profile.freeze -m /zImage.map.gz\n"
37108 #. type: Plain text
37109 #: ../sys-utils/readprofile.8.adoc:110
37110 msgid "Request profiling at 2kHz per CPU, and reset the profiling buffer:"
37113 #. type: delimited block .
37114 #: ../sys-utils/readprofile.8.adoc:113
37116 msgid " sudo readprofile -M 20\n"
37123 #. Copyright (c) 1983, 1991, 1993
37124 #. The Regents of the University of California. All rights reserved.
37125 #. Redistribution and use in source and binary forms, with or without
37126 #. modification, are permitted provided that the following conditions
37128 #. 1. Redistributions of source code must retain the above copyright
37129 #. notice, this list of conditions and the following disclaimer.
37130 #. 2. Redistributions in binary form must reproduce the above copyright
37131 #. notice, this list of conditions and the following disclaimer in the
37132 #. documentation and/or other materials provided with the distribution.
37133 #. 3. All advertising materials mentioning features or use of this software
37134 #. must display the following acknowledgement:
37135 #. This product includes software developed by the University of
37136 #. California, Berkeley and its contributors.
37137 #. 4. Neither the name of the University nor the names of its contributors
37138 #. may be used to endorse or promote products derived from this software
37139 #. without specific prior written permission.
37140 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
37141 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37142 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
37143 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
37144 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37145 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37146 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
37147 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
37148 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37149 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37151 #. @(#)renice.8 8.1 (Berkeley) 6/9/93
37153 #: ../sys-utils/renice.1.adoc:36
37155 #| msgid "write(1)"
37159 #. type: Plain text
37160 #: ../sys-utils/renice.1.adoc:46
37161 msgid "renice - alter priority of running processes"
37164 #. type: Plain text
37165 #: ../sys-utils/renice.1.adoc:50
37167 msgid "*renice* [*--priority|--relative*] _priority_ [*-g*|*-p*|*-u*] _identifier_...\n"
37170 #. type: Plain text
37171 #: ../sys-utils/renice.1.adoc:54
37173 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"
37176 #. type: Plain text
37177 #: ../sys-utils/renice.1.adoc:56
37179 "If no *-n*, *--priority* or *--relative* option is used, then the priority "
37180 "is set as *absolute*."
37183 #. type: Labeled list
37184 #: ../sys-utils/renice.1.adoc:59
37186 #| msgid "*-P*, *--pty*"
37187 msgid "*-n* _priority_"
37188 msgstr "*-P*, *--pty*"
37190 #. type: Plain text
37191 #: ../sys-utils/renice.1.adoc:61
37193 "Specify the *absolute* or *relative* (depending on environment variable "
37194 "POSIXLY_CORRECT) scheduling _priority_ to be used for the process, process "
37195 "group, or user. Use of the option *-n* is optional, but when used, it must "
37196 "be the first argument. See *NOTES* for more information."
37199 #. type: Labeled list
37200 #: ../sys-utils/renice.1.adoc:62
37202 #| msgid "*-P*, *--pty*"
37203 msgid "*--priority* _priority_"
37204 msgstr "*-P*, *--pty*"
37206 #. type: Plain text
37207 #: ../sys-utils/renice.1.adoc:64
37209 "Specify an *absolute* scheduling _priority_. _Priority_ is set to the given "
37210 "value. This is the default, when no option is specified."
37213 #. type: Labeled list
37214 #: ../sys-utils/renice.1.adoc:65
37216 msgid "*--relative* _priority_"
37219 #. type: Plain text
37220 #: ../sys-utils/renice.1.adoc:67
37222 "Specify a *relative* scheduling _priority_. Same as the standard POSIX *-n* "
37223 "option. _Priority_ gets _incremented/decremented_ by the given value."
37226 #. type: Labeled list
37227 #: ../sys-utils/renice.1.adoc:68
37229 #| msgid "*-P*, *--pty*"
37230 msgid "*-g*, *--pgrp*"
37231 msgstr "*-P*, *--pty*"
37233 #. type: Plain text
37234 #: ../sys-utils/renice.1.adoc:70
37235 msgid "Interpret the succeeding arguments as process group IDs."
37238 #. type: Plain text
37239 #: ../sys-utils/renice.1.adoc:73
37240 msgid "Interpret the succeeding arguments as process IDs (the default)."
37243 #. type: Labeled list
37244 #: ../sys-utils/renice.1.adoc:74
37246 #| msgid "*-h*, *--help*"
37247 msgid "*-u*, *--user*"
37248 msgstr "*-h*, *--help*"
37250 #. type: Plain text
37251 #: ../sys-utils/renice.1.adoc:76
37252 msgid "Interpret the succeeding arguments as usernames or UIDs."
37255 #. type: Labeled list
37256 #: ../sys-utils/renice.1.adoc:81
37258 #| msgid "_/etc/pam.d/su_"
37259 msgid "_/etc/passwd_"
37260 msgstr "_/etc/pam.d/su_"
37262 #. type: Plain text
37263 #: ../sys-utils/renice.1.adoc:83
37264 msgid "to map user names to user IDs"
37267 #. type: Plain text
37268 #: ../sys-utils/renice.1.adoc:87
37270 "Users other than the superuser may only alter the priority of processes they "
37271 "own. Furthermore, an unprivileged user can only _increase_ the \"nice "
37272 "value\" (i.e., choose a lower priority) and such changes are irreversible "
37273 "unless (since Linux 2.6.12) the user has a suitable \"nice\" resource limit "
37274 "(see *ulimit*(1p) and *getrlimit*(2))."
37277 #. type: Plain text
37278 #: ../sys-utils/renice.1.adoc:89
37280 "The superuser may alter the priority of any process and set the priority to "
37281 "any value in the range -20 to 19. Useful priorities are: 19 (the affected "
37282 "processes will run only when nothing else in the system wants to), 0 (the "
37283 "\"base\" scheduling priority), anything negative (to make things go very "
37287 #. type: Plain text
37288 #: ../sys-utils/renice.1.adoc:91
37290 "For historical reasons in this implementation, the *-n* option did not "
37291 "follow the POSIX specification. Therefore, instead of setting a *relative* "
37292 "priority, it sets an *absolute* priority by default. As this may not be "
37293 "desirable, this behavior can be controlled by setting the environment "
37294 "variable POSIXLY_CORRECT to be fully POSIX compliant. See the *-n* option "
37295 "for details. See *--relative* and *--priority* for options that do not "
37296 "change behavior depending on environment variables."
37299 #. type: Plain text
37300 #: ../sys-utils/renice.1.adoc:95
37302 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
37303 msgid "The *renice* command appeared in 4.0BSD."
37304 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
37306 #. type: Plain text
37307 #: ../sys-utils/renice.1.adoc:99
37309 "The following command would change the priority of the processes with PIDs "
37310 "987 and 32, plus all processes owned by the users daemon and root:"
37313 #. type: Plain text
37314 #: ../sys-utils/renice.1.adoc:101
37316 msgid "*renice +1 987 -u daemon root -p 32*\n"
37319 #. type: Plain text
37320 #: ../sys-utils/renice.1.adoc:110
37325 "*getpriority*(2),\n"
37326 "*setpriority*(2),\n"
37327 "*credentials*(7),\n"
37332 #: ../sys-utils/rfkill.8.adoc:2
37337 #. type: Plain text
37338 #: ../sys-utils/rfkill.8.adoc:12
37339 msgid "rfkill - tool for enabling and disabling wireless devices"
37342 #. type: Plain text
37343 #: ../sys-utils/rfkill.8.adoc:16
37345 msgid "*rfkill* [options] [_command_] [_ID_|_type_ ...]\n"
37348 #. type: Plain text
37349 #: ../sys-utils/rfkill.8.adoc:20
37351 msgid "*rfkill* lists, enabling and disabling wireless devices.\n"
37354 #. type: Plain text
37355 #: ../sys-utils/rfkill.8.adoc:22
37357 "The command \"list\" output format is deprecated and maintained for backward "
37358 "compatibility only. The new output format is the default when no command is "
37359 "specified or when the option *--output* is used."
37362 #. type: Plain text
37363 #: ../sys-utils/rfkill.8.adoc:24
37365 "The default output is subject to change. So whenever possible, you should "
37366 "avoid using default outputs in your scripts. Always explicitly define "
37367 "expected columns by using the *--output* option together with a columns list "
37368 "in environments where a stable output is required."
37371 #. type: Plain text
37372 #: ../sys-utils/rfkill.8.adoc:35
37374 "Specify which output columns to print. Use *--help* to get a list of "
37375 "available columns."
37378 #. type: Labeled list
37379 #: ../sys-utils/rfkill.8.adoc:46
37381 #| msgid "*-h*, *--help*"
37383 msgstr "*-h*, *--help*"
37385 #. type: Labeled list
37386 #: ../sys-utils/rfkill.8.adoc:49
37388 #| msgid "*comment*"
37392 #. type: Plain text
37393 #: ../sys-utils/rfkill.8.adoc:51
37394 msgid "Listen for rfkill events and display them on stdout."
37397 #. type: Labeled list
37398 #: ../sys-utils/rfkill.8.adoc:52
37400 msgid "*list* [__id__|__type__ ...]"
37403 #. type: Plain text
37404 #: ../sys-utils/rfkill.8.adoc:54
37406 "List the current state of all available devices. The command output format "
37407 "is deprecated, see the *DESCRIPTION* section. It is a good idea to check "
37408 "with *list* command _id_ or _type_ scope is appropriate before setting "
37409 "*block* or *unblock*. Special _all_ type string will match everything. Use "
37410 "of multiple _ID_ or _type_ arguments is supported. Possible types are all, "
37411 "{wlan | wifi}, bluetooth, {uwb | ultrawideband}, wimax, wwan, gps, fm, nfc."
37414 #. type: Labeled list
37415 #: ../sys-utils/rfkill.8.adoc:55
37417 msgid "**block** __id__|__type__ [...]"
37420 #. type: Plain text
37421 #: ../sys-utils/rfkill.8.adoc:57
37422 msgid "Disable the corresponding device."
37425 #. type: Labeled list
37426 #: ../sys-utils/rfkill.8.adoc:58
37428 msgid "**unblock** __id__|__type__ [...]"
37431 #. type: Plain text
37432 #: ../sys-utils/rfkill.8.adoc:60
37434 "Enable the corresponding device. If the device is hard-blocked, for example "
37435 "via a hardware switch, it will remain unavailable though it is now soft-"
37439 #. type: Labeled list
37440 #: ../sys-utils/rfkill.8.adoc:61
37442 msgid "**toggle** __id__|__type__ [...]"
37445 #. type: Plain text
37446 #: ../sys-utils/rfkill.8.adoc:63
37447 msgid "Enable or disable the corresponding device."
37450 #. type: delimited block .
37451 #: ../sys-utils/rfkill.8.adoc:70
37454 " rfkill --output ID,TYPE\n"
37455 " rfkill block all\n"
37456 " rfkill unblock wlan\n"
37457 " rfkill block bluetooth uwb wimax wwan gps fm nfc\n"
37460 #. type: Plain text
37461 #: ../sys-utils/rfkill.8.adoc:75
37463 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"
37466 #. type: Plain text
37467 #: ../sys-utils/rfkill.8.adoc:77
37469 "This manual page was written by mailto:linux@youmustbejoking.demon.co."
37470 "uk[Darren Salt] for the Debian project (and may be used by others)."
37473 #. type: Plain text
37474 #: ../sys-utils/rfkill.8.adoc:83
37478 "*systemd-rfkill*(8),\n"
37479 "https://docs.kernel.org/driver-api/rfkill.html[Linux kernel documentation]\n"
37483 #: ../sys-utils/rtcwake.8.adoc:2
37488 #. type: Plain text
37489 #: ../sys-utils/rtcwake.8.adoc:12
37490 msgid "rtcwake - enter a system sleep state until specified wakeup time"
37493 #. type: Plain text
37494 #: ../sys-utils/rtcwake.8.adoc:16
37496 msgid "*rtcwake* [options] [*-d* _device_] [*-m* _standby_mode_] {*-s* _seconds_|*-t* _time_t_}\n"
37499 #. type: Plain text
37500 #: ../sys-utils/rtcwake.8.adoc:20
37502 "This program is used to enter a system sleep state and to automatically wake "
37503 "from it at a specified time."
37506 #. type: Plain text
37507 #: ../sys-utils/rtcwake.8.adoc:22
37509 "This uses cross-platform Linux interfaces to enter a system sleep state, and "
37510 "leave it no later than a specified time. It uses any RTC framework driver "
37511 "that supports standard driver model wakeup flags."
37514 #. type: Plain text
37515 #: ../sys-utils/rtcwake.8.adoc:24
37517 "This is normally used like the old *apmsleep* utility, to wake from a "
37518 "suspend state like ACPI S1 (standby) or S3 (suspend-to-RAM). Most platforms "
37519 "can implement those without analogues of BIOS, APM, or ACPI."
37522 #. type: Plain text
37523 #: ../sys-utils/rtcwake.8.adoc:26
37525 "On some systems, this can also be used like *nvram-wakeup*, waking from "
37526 "states like ACPI S4 (suspend to disk). Not all systems have persistent media "
37527 "that are appropriate for such suspend modes."
37530 #. type: Plain text
37531 #: ../sys-utils/rtcwake.8.adoc:28
37533 "Note that alarm functionality depends on hardware; not every RTC is able to "
37534 "setup an alarm up to 24 hours in the future."
37537 #. type: Plain text
37538 #: ../sys-utils/rtcwake.8.adoc:30
37540 "The suspend setup may be interrupted by active hardware; for example "
37541 "wireless USB input devices that continue to send events for some fraction of "
37542 "a second after the return key is pressed. *rtcwake* tries to avoid this "
37543 "problem and it waits to the terminal to settle down before entering a system "
37547 #. type: Labeled list
37548 #: ../sys-utils/rtcwake.8.adoc:33
37550 msgid "*-A*, *--adjfile* _file_"
37553 #. type: Plain text
37554 #: ../sys-utils/rtcwake.8.adoc:35
37555 msgid "Specify an alternative path to the adjust file."
37558 #. type: Plain text
37559 #: ../sys-utils/rtcwake.8.adoc:38
37561 "Read the clock mode (whether the hardware clock is set to UTC or local time) "
37562 "from the _adjtime_ file, where *hwclock*(8) stores that information. This is "
37566 #. type: Labeled list
37567 #: ../sys-utils/rtcwake.8.adoc:39
37569 msgid "*--date* _timestamp_"
37572 #. type: Plain text
37573 #: ../sys-utils/rtcwake.8.adoc:41
37575 "Set the wakeup time to the value of the timestamp. Format of the timestamp "
37576 "can be any of the following:"
37580 #: ../sys-utils/rtcwake.8.adoc:52
37583 "|YYYYMMDDhhmmss |\n"
37584 "|YYYY-MM-DD hh:mm:ss |\n"
37585 "|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
37586 "|YYYY-MM-DD |(time will be set to 00:00:00)\n"
37587 "|hh:mm:ss |(date will be set to today)\n"
37588 "|hh:mm |(date will be set to today, seconds to 00)\n"
37589 "|tomorrow |(time is set to 00:00:00)\n"
37593 #. type: Labeled list
37594 #: ../sys-utils/rtcwake.8.adoc:54
37596 msgid "*-d*, *--device* _device_"
37599 #. type: Plain text
37600 #: ../sys-utils/rtcwake.8.adoc:56
37602 "Use the specified _device_ instead of *rtc0* as realtime clock. This option "
37603 "is only relevant if your system has more than one RTC. You may specify "
37604 "*rtc1*, *rtc2*, ... here."
37607 #. type: Labeled list
37608 #: ../sys-utils/rtcwake.8.adoc:57
37610 #| msgid "*-h*, *--help*"
37611 msgid "*-l*, *--local*"
37612 msgstr "*-h*, *--help*"
37614 #. type: Plain text
37615 #: ../sys-utils/rtcwake.8.adoc:59
37617 "Assume that the hardware clock is set to local time, regardless of the "
37618 "contents of the _adjtime_ file."
37621 #. type: Labeled list
37622 #: ../sys-utils/rtcwake.8.adoc:60
37624 msgid "*--list-modes*"
37627 #. type: Plain text
37628 #: ../sys-utils/rtcwake.8.adoc:62
37629 msgid "List available *--mode* option arguments."
37632 #. type: Labeled list
37633 #: ../sys-utils/rtcwake.8.adoc:63
37635 msgid "*-m*, *--mode* _mode_"
37638 #. type: Plain text
37639 #: ../sys-utils/rtcwake.8.adoc:65
37640 msgid "Go into the given standby state. Valid values for _mode_ are:"
37643 #. type: Labeled list
37644 #: ../sys-utils/rtcwake.8.adoc:66
37649 #. type: Plain text
37650 #: ../sys-utils/rtcwake.8.adoc:68
37652 "ACPI state S1. This state offers minimal, though real, power savings, while "
37653 "providing a very low-latency transition back to a working system. This is "
37654 "the default mode."
37657 #. type: Labeled list
37658 #: ../sys-utils/rtcwake.8.adoc:69
37663 #. type: Plain text
37664 #: ../sys-utils/rtcwake.8.adoc:71
37666 "The processes are frozen, all the devices are suspended and all the "
37667 "processors idled. This state is a general state that does not need any "
37668 "platform-specific support, but it saves less power than Suspend-to-RAM, "
37669 "because the system is still in a running state. (Available since Linux 3.9.)"
37672 #. type: Labeled list
37673 #: ../sys-utils/rtcwake.8.adoc:72
37678 #. type: Plain text
37679 #: ../sys-utils/rtcwake.8.adoc:74
37681 "ACPI state S3 (Suspend-to-RAM). This state offers significant power savings "
37682 "as everything in the system is put into a low-power state, except for "
37683 "memory, which is placed in self-refresh mode to retain its contents."
37686 #. type: Labeled list
37687 #: ../sys-utils/rtcwake.8.adoc:75
37692 #. type: Plain text
37693 #: ../sys-utils/rtcwake.8.adoc:77
37695 "ACPI state S4 (Suspend-to-disk). This state offers the greatest power "
37696 "savings, and can be used even in the absence of low-level platform support "
37697 "for power management. This state operates similarly to Suspend-to-RAM, but "
37698 "includes a final step of writing memory contents to disk."
37701 #. type: Plain text
37702 #: ../sys-utils/rtcwake.8.adoc:80
37704 "ACPI state S5 (Poweroff). This is done by calling '/sbin/shutdown'. Not "
37705 "officially supported by ACPI, but it usually works."
37708 #. type: Labeled list
37709 #: ../sys-utils/rtcwake.8.adoc:81
37714 #. type: Plain text
37715 #: ../sys-utils/rtcwake.8.adoc:83
37716 msgid "Don't suspend, only set the RTC wakeup time."
37719 #. type: Plain text
37720 #: ../sys-utils/rtcwake.8.adoc:86
37722 "Don't suspend, but read the RTC device until an alarm time appears. This "
37723 "mode is useful for debugging."
37726 #. type: Plain text
37727 #: ../sys-utils/rtcwake.8.adoc:89
37728 msgid "Disable a previously set alarm."
37731 #. type: Labeled list
37732 #: ../sys-utils/rtcwake.8.adoc:90
37737 #. type: Plain text
37738 #: ../sys-utils/rtcwake.8.adoc:92
37740 "Print alarm information in format: \"alarm: off|on <time>\". The time is in "
37741 "ctime() output format, e.g., \"alarm: on Tue Nov 16 04:48:45 2010\"."
37744 #. type: Plain text
37745 #: ../sys-utils/rtcwake.8.adoc:95
37747 "This option does everything apart from actually setting up the alarm, "
37748 "suspending the system, or waiting for the alarm."
37751 #. type: Labeled list
37752 #: ../sys-utils/rtcwake.8.adoc:96
37754 #| msgid "*-c*, **--command**=__command__"
37755 msgid "*-s*, *--seconds* _seconds_"
37756 msgstr "*-c*, **--command**=__příkaz__"
37758 #. type: Plain text
37759 #: ../sys-utils/rtcwake.8.adoc:98
37760 msgid "Set the wakeup time to _seconds_ in the future from now."
37763 #. type: Labeled list
37764 #: ../sys-utils/rtcwake.8.adoc:99
37766 msgid "*-t*, *--time* _time_t_"
37769 #. type: Plain text
37770 #: ../sys-utils/rtcwake.8.adoc:101
37772 "Set the wakeup time to the absolute time _time_t_. _time_t_ is the time in "
37773 "seconds since 1970-01-01, 00:00 UTC. Use the *date*(1) tool to convert "
37774 "between human-readable time and _time_t_."
37777 #. type: Labeled list
37778 #: ../sys-utils/rtcwake.8.adoc:102
37780 #| msgid "*-P*, *--pty*"
37781 msgid "*-u*, *--utc*"
37782 msgstr "*-P*, *--pty*"
37784 #. type: Plain text
37785 #: ../sys-utils/rtcwake.8.adoc:104
37787 "Assume that the hardware clock is set to UTC (Universal Time Coordinated), "
37788 "regardless of the contents of the _adjtime_ file."
37791 #. type: Plain text
37792 #: ../sys-utils/rtcwake.8.adoc:113
37794 "Some PC systems can't currently exit sleep states such as *mem* using only "
37795 "the kernel code accessed by this driver. They need help from userspace code "
37796 "to make the framebuffer work again."
37799 #. type: Plain text
37800 #: ../sys-utils/rtcwake.8.adoc:121
37802 "The program was posted several times on LKML and other lists before "
37803 "appearing in kernel commit message for Linux 2.6 in the GIT commit "
37804 "87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d."
37807 #. type: Plain text
37808 #: ../sys-utils/rtcwake.8.adoc:125
37810 "The program was written by mailto:dbrownell@users.sourceforge.net[David "
37811 "Brownell] and improved by mailto:bwalle@suse.de[Bernhard Walle]."
37814 #. type: Plain text
37815 #: ../sys-utils/rtcwake.8.adoc:129
37817 "This is free software. You may redistribute copies of it under the terms of "
37818 "the link:http://www.gnu.org/licenses/gpl.html[GNU General Public License]. "
37819 "There is NO WARRANTY, to the extent permitted by law."
37822 #. type: Plain text
37823 #: ../sys-utils/rtcwake.8.adoc:135
37830 "*adjtime_config*(5),\n"
37839 #: ../sys-utils/setarch.8.adoc:2
37844 #. type: Plain text
37845 #: ../sys-utils/setarch.8.adoc:12
37847 "setarch - change reported architecture in new program environment and/or set "
37848 "personality flags"
37851 #. type: Plain text
37852 #: ../sys-utils/setarch.8.adoc:16
37854 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
37855 msgid "*setarch* [_arch_] [options] [_program_ [_argument_...]]\n"
37856 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
37858 #. type: Plain text
37859 #: ../sys-utils/setarch.8.adoc:18
37861 msgid "*setarch* *--list*|*-h*|*-V*\n"
37864 #. type: Plain text
37865 #: ../sys-utils/setarch.8.adoc:20
37867 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
37868 msgid "*arch* [options] [_program_ [_argument_...]]\n"
37869 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
37871 #. type: Plain text
37872 #: ../sys-utils/setarch.8.adoc:24
37874 msgid "*setarch* modifies execution domains and process personality flags.\n"
37877 #. type: Plain text
37878 #: ../sys-utils/setarch.8.adoc:26
37880 "The execution domains currently only affects the output of *uname -m*. For "
37881 "example, on an AMD64 system, running *setarch i386* _program_ will cause "
37882 "_program_ to see i686 instead of _x86_64_ as the machine type. It can also "
37883 "be used to set various personality options. The default _program_ is */bin/"
37887 #. type: Plain text
37888 #: ../sys-utils/setarch.8.adoc:28
37890 "Since version 2.33 the _arch_ command line argument is optional and "
37891 "*setarch* may be used to change personality flags (ADDR_LIMIT_*, "
37892 "SHORT_INODE, etc) without modification of the execution domain."
37895 #. type: Labeled list
37896 #: ../sys-utils/setarch.8.adoc:31
37901 #. type: Plain text
37902 #: ../sys-utils/setarch.8.adoc:33
37904 "List the architectures that *setarch* knows about. Whether *setarch* can "
37905 "actually set each of these architectures depends on the running kernel."
37908 #. type: Labeled list
37909 #: ../sys-utils/setarch.8.adoc:34
37911 msgid "*--show[=personality]*"
37914 #. type: Plain text
37915 #: ../sys-utils/setarch.8.adoc:38
37917 "Show the currently active personality and flags. If the *personality* "
37918 "argument is provided, it is shown instead of the current one. *personality* "
37919 "is a hexadecimal number with values was described in *sys/personality.h*."
37922 #. type: Labeled list
37923 #: ../sys-utils/setarch.8.adoc:39
37925 msgid "*--uname-2.6*"
37928 #. type: Plain text
37929 #: ../sys-utils/setarch.8.adoc:41
37931 "Causes the _program_ to see a kernel version number beginning with 2.6. "
37932 "Turns on *UNAME26*."
37935 #. type: Labeled list
37936 #: ../sys-utils/setarch.8.adoc:45
37938 #| msgid "*-P*, *--pty*"
37939 msgid "*-3*, *--3gb*"
37940 msgstr "*-P*, *--pty*"
37942 #. type: Plain text
37943 #: ../sys-utils/setarch.8.adoc:47
37945 "Specifies _program_ should use a maximum of 3GB of address space. Supported "
37946 "on x86. Turns on *ADDR_LIMIT_3GB*."
37949 #. type: Labeled list
37950 #: ../sys-utils/setarch.8.adoc:48
37955 #. type: Plain text
37956 #: ../sys-utils/setarch.8.adoc:50
37958 "This option has no effect. It is retained for backward compatibility only, "
37959 "and may be removed in future releases."
37962 #. type: Labeled list
37963 #: ../sys-utils/setarch.8.adoc:51
37965 #| msgid "*-P*, *--pty*"
37966 msgid "*-B*, *--32bit*"
37967 msgstr "*-P*, *--pty*"
37969 #. type: Plain text
37970 #: ../sys-utils/setarch.8.adoc:53
37972 "Limit the address space to 32 bits to emulate hardware. Supported on ARM and "
37973 "Alpha. Turns on *ADDR_LIMIT_32BIT*."
37976 #. type: Labeled list
37977 #: ../sys-utils/setarch.8.adoc:54
37979 msgid "*-F*, *--fdpic-funcptrs*"
37982 #. type: Plain text
37983 #: ../sys-utils/setarch.8.adoc:56
37985 "Treat user-space function pointers to signal handlers as pointers to address "
37986 "descriptors. This option has no effect on architectures that do not support "
37987 "*FDPIC* ELF binaries. In kernel v4.14 support is limited to ARM, Blackfin, "
37988 "Fujitsu FR-V, and SuperH CPU architectures."
37991 #. type: Labeled list
37992 #: ../sys-utils/setarch.8.adoc:57
37994 #| msgid "*-V*, *--version*"
37995 msgid "*-I*, *--short-inode*"
37996 msgstr "*-V*, *--version*"
37998 #. type: Plain text
37999 #: ../sys-utils/setarch.8.adoc:59
38000 msgid "Obsolete bug emulation flag. Turns on *SHORT_INODE*."
38003 #. type: Labeled list
38004 #: ../sys-utils/setarch.8.adoc:60
38006 msgid "*-L*, *--addr-compat-layout*"
38009 #. type: Plain text
38010 #: ../sys-utils/setarch.8.adoc:62
38012 "Provide legacy virtual address space layout. Use when the _program_ binary "
38013 "does not have *PT_GNU_STACK* ELF header. Turns on *ADDR_COMPAT_LAYOUT*."
38016 #. type: Labeled list
38017 #: ../sys-utils/setarch.8.adoc:63
38019 msgid "*-R*, *--addr-no-randomize*"
38022 #. type: Plain text
38023 #: ../sys-utils/setarch.8.adoc:65
38025 "Disables randomization of the virtual address space. Turns on "
38026 "*ADDR_NO_RANDOMIZE*."
38029 #. type: Labeled list
38030 #: ../sys-utils/setarch.8.adoc:66
38032 #| msgid "*-V*, *--version*"
38033 msgid "*-S*, *--whole-seconds*"
38034 msgstr "*-V*, *--version*"
38036 #. type: Plain text
38037 #: ../sys-utils/setarch.8.adoc:68
38038 msgid "Obsolete bug emulation flag. Turns on *WHOLE_SECONDS*."
38041 #. type: Labeled list
38042 #: ../sys-utils/setarch.8.adoc:69
38044 msgid "*-T*, *--sticky-timeouts*"
38047 #. type: Plain text
38048 #: ../sys-utils/setarch.8.adoc:71
38050 "This makes *select*(2), *pselect*(2), and *ppoll*(2) system calls preserve "
38051 "the timeout value instead of modifying it to reflect the amount of time not "
38052 "slept when interrupted by a signal handler. Use when _program_ depends on "
38053 "this behavior. For more details see the timeout description in *select*(2) "
38054 "manual page. Turns on *STICKY_TIMEOUTS*."
38057 #. type: Labeled list
38058 #: ../sys-utils/setarch.8.adoc:72
38060 msgid "*-X*, *--read-implies-exec*"
38063 #. type: Plain text
38064 #: ../sys-utils/setarch.8.adoc:74
38066 "If this is set then *mmap*(2) *PROT_READ* will also add the *PROT_EXEC* bit "
38067 "- as expected by legacy x86 binaries. Notice that the ELF loader will "
38068 "automatically set this bit when it encounters a legacy binary. Turns on "
38069 "*READ_IMPLIES_EXEC*."
38072 #. type: Labeled list
38073 #: ../sys-utils/setarch.8.adoc:75
38075 msgid "*-Z*, *--mmap-page-zero*"
38078 #. type: Plain text
38079 #: ../sys-utils/setarch.8.adoc:77
38081 "SVr4 bug emulation that will set *mmap*(2) page zero as read-only. Use when "
38082 "_program_ depends on this behavior, and the source code is not available to "
38083 "be fixed. Turns on *MMAP_PAGE_ZERO*."
38086 #. type: delimited block .
38087 #: ../sys-utils/setarch.8.adoc:87
38090 "setarch --addr-no-randomize mytestprog\n"
38091 "setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm\n"
38092 "setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm\n"
38093 "setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm\n"
38096 #. type: Plain text
38097 #: ../sys-utils/setarch.8.adoc:94
38099 "mailto:sopwith@redhat.com[Elliot Lee], mailto:jnovy@redhat.com[Jindrich "
38100 "Novy], mailto:kzak@redhat.com[Karel Zak]"
38103 #. type: Plain text
38104 #: ../sys-utils/setarch.8.adoc:99
38107 "*personality*(2),\n"
38112 #: ../sys-utils/setpriv.1.adoc:2
38117 #. type: Plain text
38118 #: ../sys-utils/setpriv.1.adoc:12
38119 msgid "setpriv - run a program with different Linux privilege settings"
38122 #. type: Plain text
38123 #: ../sys-utils/setpriv.1.adoc:16
38125 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
38126 msgid "*setpriv* [options] _program_ [_arguments_]\n"
38127 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
38129 #. type: Plain text
38130 #: ../sys-utils/setpriv.1.adoc:20
38132 "Sets or queries various Linux privilege settings that are inherited across "
38136 #. type: Plain text
38137 #: ../sys-utils/setpriv.1.adoc:22
38139 "In comparison to *su*(1) and *runuser*(1), *setpriv* neither uses PAM, nor "
38140 "does it prompt for a password. It is a simple, non-set-user-ID wrapper "
38141 "around *execve*(2), and can be used to drop privileges in the same way as "
38142 "*setuidgid*(8) from *daemontools*, *chpst*(8) from *runit*, or similar tools "
38143 "shipped by other service managers."
38146 #. type: Labeled list
38147 #: ../sys-utils/setpriv.1.adoc:25
38149 msgid "*--clear-groups*"
38152 #. type: Plain text
38153 #: ../sys-utils/setpriv.1.adoc:27
38154 msgid "Clear supplementary groups."
38157 #. type: Labeled list
38158 #: ../sys-utils/setpriv.1.adoc:28
38160 #| msgid "*-P*, *--pty*"
38161 msgid "*-d*, *--dump*"
38162 msgstr "*-P*, *--pty*"
38164 #. type: Plain text
38165 #: ../sys-utils/setpriv.1.adoc:30
38167 "Dump the current privilege state. This option can be specified more than "
38168 "once to show extra, mostly useless, information. Incompatible with all other "
38172 #. type: Labeled list
38173 #: ../sys-utils/setpriv.1.adoc:31
38175 #| msgid "*-g*, **--group**=__group__"
38176 msgid "*--groups* _group_..."
38177 msgstr "*-g*, **--group**=__skupina__"
38179 #. type: Plain text
38180 #: ../sys-utils/setpriv.1.adoc:33
38182 "Set supplementary groups. The argument is a comma-separated list of GIDs or "
38186 #. type: Labeled list
38187 #: ../sys-utils/setpriv.1.adoc:34
38189 msgid "*--inh-caps* (*+*|*-*)_cap_..."
38192 #. type: Labeled list
38193 #: ../sys-utils/setpriv.1.adoc:35
38195 msgid "*--ambient-caps* (*+*|*-*)_cap_..."
38198 #. type: Labeled list
38199 #: ../sys-utils/setpriv.1.adoc:36
38201 msgid "*--bounding-set* (*+*|*-*)_cap_..."
38204 #. type: Plain text
38205 #: ../sys-utils/setpriv.1.adoc:38
38207 "Set the inheritable capabilities, ambient capabilities or the capability "
38208 "bounding set. See *capabilities*(7). The argument is a comma-separated list "
38209 "of **+**__cap__ and **-**__cap__ entries, which add or remove an entry "
38210 "respectively. _cap_ can either be a human-readable name as seen in "
38211 "*capabilities*(7) without the _cap__ prefix or of the format *cap_N*, where "
38212 "_N_ is the internal capability index used by Linux. *+all* and *-all* can be "
38213 "used to add or remove all caps."
38216 #. type: Plain text
38217 #: ../sys-utils/setpriv.1.adoc:40
38219 "The set of capabilities starts out as the current inheritable set for *--inh-"
38220 "caps*, the current ambient set for *--ambient-caps* and the current bounding "
38221 "set for *--bounding-set*."
38224 #. type: Plain text
38225 #: ../sys-utils/setpriv.1.adoc:42
38227 "Note the following restrictions (detailed in *capabilities*(7)) regarding "
38228 "modifications to these capability sets:"
38231 #. type: Plain text
38232 #: ../sys-utils/setpriv.1.adoc:44
38234 "A capability can be added to the inheritable set only if it is currently "
38235 "present in the bounding set."
38238 #. type: Plain text
38239 #: ../sys-utils/setpriv.1.adoc:45
38241 "A capability can be added to the ambient set only if it is currently present "
38242 "in both the permitted and inheritable sets."
38245 #. type: Plain text
38246 #: ../sys-utils/setpriv.1.adoc:46
38248 "Notwithstanding the syntax offered by *setpriv*, the kernel does not permit "
38249 "capabilities to be added to the bounding set."
38252 #. type: Plain text
38253 #: ../sys-utils/setpriv.1.adoc:48
38255 "If you drop a capability from the bounding set without also dropping it from "
38256 "the inheritable set, you are likely to become confused. Do not do that."
38259 #. type: Labeled list
38260 #: ../sys-utils/setpriv.1.adoc:49
38262 msgid "*--keep-groups*"
38265 #. type: Plain text
38266 #: ../sys-utils/setpriv.1.adoc:51
38268 "Preserve supplementary groups. Only useful in conjunction with *--rgid*, *--"
38269 "egid*, or *--regid*."
38272 #. type: Labeled list
38273 #: ../sys-utils/setpriv.1.adoc:52
38275 msgid "*--init-groups*"
38278 #. type: Plain text
38279 #: ../sys-utils/setpriv.1.adoc:54
38281 "Initialize supplementary groups using initgroups3. Only useful in "
38282 "conjunction with *--ruid* or *--reuid*."
38285 #. type: Labeled list
38286 #: ../sys-utils/setpriv.1.adoc:55
38288 msgid "*--list-caps*"
38291 #. type: Plain text
38292 #: ../sys-utils/setpriv.1.adoc:57
38293 msgid "List all known capabilities. This option must be specified alone."
38296 #. type: Labeled list
38297 #: ../sys-utils/setpriv.1.adoc:58
38299 msgid "*--no-new-privs*"
38302 #. type: Plain text
38303 #: ../sys-utils/setpriv.1.adoc:60
38305 "Set the _no_new_privs_ bit. With this bit set, *execve*(2) will not grant "
38306 "new privileges. For example, the set-user-ID and set-group-ID bits as well "
38307 "as file capabilities will be disabled. (Executing binaries with these bits "
38308 "set will still work, but they will not gain privileges. Certain LSMs, "
38309 "especially AppArmor, may result in failures to execute certain programs.) "
38310 "This bit is inherited by child processes and cannot be unset. See *prctl*(2) "
38311 "and _Documentation/prctl/no_new_privs.txt_ in the Linux kernel source."
38314 #. type: Plain text
38315 #: ../sys-utils/setpriv.1.adoc:62
38316 msgid "The _no_new_privs_ bit is supported since Linux 3.5."
38319 #. type: Labeled list
38320 #: ../sys-utils/setpriv.1.adoc:63
38322 msgid "*--rgid* _gid_, *--egid* _gid_, *--regid* _gid_"
38325 #. type: Plain text
38326 #: ../sys-utils/setpriv.1.adoc:65
38328 "Set the real, effective, or both GIDs. The _gid_ argument can be given as a "
38329 "textual group name."
38332 #. type: Plain text
38333 #: ../sys-utils/setpriv.1.adoc:67
38335 "For safety, you must specify one of *--clear-groups*, *--groups*, *--keep-"
38336 "groups*, or *--init-groups* if you set any primary _gid_."
38339 #. type: Labeled list
38340 #: ../sys-utils/setpriv.1.adoc:68
38342 msgid "*--ruid* _uid_, *--euid* _uid_, *--reuid* _uid_"
38345 #. type: Plain text
38346 #: ../sys-utils/setpriv.1.adoc:70
38348 "Set the real, effective, or both UIDs. The _uid_ argument can be given as a "
38349 "textual login name."
38352 #. type: Plain text
38353 #: ../sys-utils/setpriv.1.adoc:72
38355 "Setting a _uid_ or _gid_ does not change capabilities, although the exec "
38356 "call at the end might change capabilities. This means that, if you are root, "
38357 "you probably want to do something like:"
38360 #. type: Plain text
38361 #: ../sys-utils/setpriv.1.adoc:74
38363 msgid "*setpriv --reuid=1000 --regid=1000 --inh-caps=-all*\n"
38366 #. type: Labeled list
38367 #: ../sys-utils/setpriv.1.adoc:75
38369 msgid "*--securebits* (**+**|*-*)__securebit__..."
38372 #. type: Plain text
38373 #: ../sys-utils/setpriv.1.adoc:77
38375 "Set or clear securebits. The argument is a comma-separated list. The valid "
38376 "securebits are _noroot_, _noroot_locked_, _no_setuid_fixup_, "
38377 "_no_setuid_fixup_locked_, and _keep_caps_locked_. _keep_caps_ is cleared by "
38378 "*execve*(2) and is therefore not allowed."
38381 #. type: Labeled list
38382 #: ../sys-utils/setpriv.1.adoc:78
38384 msgid "**--pdeathsig keep**|**clear**|*<signal>*"
38387 #. type: Plain text
38388 #: ../sys-utils/setpriv.1.adoc:80
38390 "Keep, clear or set the parent death signal. Some LSMs, most notably SELinux "
38391 "and AppArmor, clear the signal when the process' credentials change. Using "
38392 "*--pdeathsig keep* will restore the parent death signal after changing "
38393 "credentials to remedy that situation."
38396 #. type: Labeled list
38397 #: ../sys-utils/setpriv.1.adoc:81
38399 msgid "*--selinux-label* _label_"
38402 #. type: Plain text
38403 #: ../sys-utils/setpriv.1.adoc:83
38405 "Request a particular SELinux transition (using a transition on exec, not "
38406 "dyntrans). This will fail and cause *setpriv* to abort if SELinux is not in "
38407 "use, and the transition may be ignored or cause *execve*(2) to fail at "
38408 "SELinux's whim. (In particular, this is unlikely to work in conjunction with "
38409 "_no_new_privs_.) This is similar to *runcon*(1)."
38412 #. type: Labeled list
38413 #: ../sys-utils/setpriv.1.adoc:84
38415 msgid "*--apparmor-profile* _profile_"
38418 #. type: Plain text
38419 #: ../sys-utils/setpriv.1.adoc:86
38421 "Request a particular AppArmor profile (using a transition on exec). This "
38422 "will fail and cause *setpriv* to abort if AppArmor is not in use, and the "
38423 "transition may be ignored or cause *execve*(2) to fail at AppArmor's whim."
38426 #. type: Labeled list
38427 #: ../sys-utils/setpriv.1.adoc:87
38429 msgid "*--landlock-access* _access_"
38432 #. type: Plain text
38433 #: ../sys-utils/setpriv.1.adoc:90
38435 "Enable landlock restrictions for a specific set of system accesses. To "
38436 "allow specific subgroups of accesses use *--landlock-rule*."
38439 #. type: Plain text
38440 #: ../sys-utils/setpriv.1.adoc:92
38441 msgid "Block all filesystem access:"
38444 #. type: Plain text
38445 #: ../sys-utils/setpriv.1.adoc:94
38447 msgid "*setpriv --landlock-access fs*\n"
38450 #. type: Plain text
38451 #: ../sys-utils/setpriv.1.adoc:96
38452 msgid "Block all file deletions and directory creations:"
38455 #. type: Plain text
38456 #: ../sys-utils/setpriv.1.adoc:98
38458 msgid "*setpriv --landlock-access fs:remove-file,make-dir*\n"
38461 #. type: Plain text
38462 #: ../sys-utils/setpriv.1.adoc:100
38463 msgid "For a complete set of supported access categories use *setpriv --help*."
38466 #. type: Labeled list
38467 #: ../sys-utils/setpriv.1.adoc:101
38469 msgid "*--landlock-rule* _rule_"
38472 #. type: Plain text
38473 #: ../sys-utils/setpriv.1.adoc:104
38475 "Allow one specific access from the categories blocked by *--landlock-access*."
38478 #. type: Plain text
38479 #: ../sys-utils/setpriv.1.adoc:106
38480 msgid "The syntax is as follows:"
38483 #. type: Plain text
38484 #: ../sys-utils/setpriv.1.adoc:108
38486 msgid "*--landlock-rule $ruletype:$access:$rulearg*\n"
38489 #. type: Plain text
38490 #: ../sys-utils/setpriv.1.adoc:110
38491 msgid "For example grant file read access to everything under */boot*:"
38494 #. type: Plain text
38495 #: ../sys-utils/setpriv.1.adoc:112
38497 msgid "*--landlock-rule path-beneath:read-file:/boot*\n"
38500 #. type: Labeled list
38501 #: ../sys-utils/setpriv.1.adoc:113
38503 msgid "*--reset-env*"
38506 #. type: Plain text
38507 #: ../sys-utils/setpriv.1.adoc:115
38509 "Clears all the environment variables except *TERM*; initializes the "
38510 "environment variables *HOME*, *SHELL*, *USER*, *LOGNAME* according to the "
38511 "user's passwd entry; sets *PATH* to _/usr/local/bin:/bin:/usr/bin_ for a "
38512 "regular user and to _/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/"
38513 "usr/bin_ for root."
38516 #. type: Plain text
38517 #: ../sys-utils/setpriv.1.adoc:117
38520 #| "The environment variable *PATH* may be different on systems where _/bin_ "
38521 #| "and _/sbin_ are merged into _/usr_; this variable is also affected by the "
38522 #| "*--login* command-line option and the PAM system setting (e.g., "
38523 #| "*pam_env*(8))."
38525 "The environment variable *PATH* may be different on systems where _/bin_ and "
38526 "_/sbin_ are merged into _/usr_. The environment variable *SHELL* defaults to "
38527 "*/bin/sh* if none is given in the user's passwd entry."
38529 "Proměnná prostředí *PATH* se může lišit na systémech, kde _/bin_ a _/sbin_ "
38530 "jsou začleněny do _/usr_. Tato proměnná je rovněž ovlivněna přepínačem "
38531 "příkazové řádky *--login* a nastavením systému PAM (např. *pam_env*(8))."
38533 #. type: Plain text
38534 #: ../sys-utils/setpriv.1.adoc:123
38536 "If applying any specified option fails, _program_ will not be run and "
38537 "*setpriv* will return with exit status 127."
38540 #. type: Plain text
38541 #: ../sys-utils/setpriv.1.adoc:125
38543 "Be careful with this tool -- it may have unexpected security consequences. "
38544 "For example, setting _no_new_privs_ and then execing a program that is "
38545 "SELinux-confined (as this tool would do) may prevent the SELinux "
38546 "restrictions from taking effect."
38549 #. type: Plain text
38550 #: ../sys-utils/setpriv.1.adoc:129
38552 "If you're looking for behavior similar to *su*(1)/*runuser*(1), or *sudo*(8) "
38553 "(without the *-g* option), try something like:"
38556 #. type: Plain text
38557 #: ../sys-utils/setpriv.1.adoc:131
38559 msgid "*setpriv --reuid=1000 --regid=1000 --init-groups*\n"
38562 #. type: Plain text
38563 #: ../sys-utils/setpriv.1.adoc:133
38564 msgid "If you want to mimic daemontools' *setuid*(8), try:"
38567 #. type: Plain text
38568 #: ../sys-utils/setpriv.1.adoc:135
38570 msgid "*setpriv --reuid=1000 --regid=1000 --clear-groups*\n"
38573 #. type: Plain text
38574 #: ../sys-utils/setpriv.1.adoc:139
38575 msgid "mailto:luto@amacapital.net[Andy Lutomirski]"
38578 #. type: Plain text
38579 #: ../sys-utils/setpriv.1.adoc:147
38582 #| "*setpriv*(1),\n"
38583 #| "*login.defs*(5),\n"
38584 #| "*shells*(5),\n"
38586 #| "*runuser*(1)\n"
38591 "*capabilities*(7)\n"
38595 "*login.defs*(5),\n"
38600 #. Rick Sladkey <jrs@world.std.com>
38601 #. In the public domain.
38603 #: ../sys-utils/setsid.1.adoc:4
38608 #. type: Plain text
38609 #: ../sys-utils/setsid.1.adoc:14
38610 msgid "setsid - run a program in a new session"
38613 #. type: Plain text
38614 #: ../sys-utils/setsid.1.adoc:18
38616 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
38617 msgid "*setsid* [options] _program_ [_arguments_]\n"
38618 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
38620 #. type: Plain text
38621 #: ../sys-utils/setsid.1.adoc:22
38623 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"
38626 #. type: Labeled list
38627 #: ../sys-utils/setsid.1.adoc:25
38629 #| msgid "*-P*, *--pty*"
38630 msgid "*-c*, *--ctty*"
38631 msgstr "*-P*, *--pty*"
38633 #. type: Plain text
38634 #: ../sys-utils/setsid.1.adoc:27
38635 msgid "Set the controlling terminal to the current one."
38638 #. type: Labeled list
38639 #: ../sys-utils/setsid.1.adoc:28 ../sys-utils/unshare.1.adoc:81
38641 #| msgid "*-f*, *--fast*"
38642 msgid "*-f*, *--fork*"
38643 msgstr "*-f*, *--fast*"
38645 #. type: Plain text
38646 #: ../sys-utils/setsid.1.adoc:30
38647 msgid "Always create a new process."
38650 #. type: Labeled list
38651 #: ../sys-utils/setsid.1.adoc:31
38653 #| msgid "*-f*, *--fast*"
38654 msgid "*-w*, *--wait*"
38655 msgstr "*-f*, *--fast*"
38657 #. type: Plain text
38658 #: ../sys-utils/setsid.1.adoc:33
38660 "Wait for the execution of the program to end, and return the exit status of "
38661 "this program as the exit status of *setsid*."
38664 #. type: Plain text
38665 #: ../sys-utils/setsid.1.adoc:43
38666 msgid "mailto:jrs@world.std.com[Rick Sladkey]"
38669 #. type: Plain text
38670 #: ../sys-utils/setsid.1.adoc:47
38672 msgid "*setsid*(2)\n"
38676 #: ../sys-utils/swapon.8.adoc:2
38681 #. type: Plain text
38682 #: ../sys-utils/swapon.8.adoc:12
38684 "swapon, swapoff - enable/disable devices and files for paging and swapping"
38687 #. type: Plain text
38688 #: ../sys-utils/swapon.8.adoc:16
38690 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
38691 msgid "*swapon* [options] [_specialfile_...]\n"
38692 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
38694 #. type: Plain text
38695 #: ../sys-utils/swapon.8.adoc:18
38697 msgid "*swapoff* [*-va*] [_specialfile_...]\n"
38700 #. type: Plain text
38701 #: ../sys-utils/swapon.8.adoc:22
38703 msgid "*swapon* is used to specify devices on which paging and swapping are to take place.\n"
38706 #. type: Plain text
38707 #: ../sys-utils/swapon.8.adoc:24
38709 "The device or file used is given by the _specialfile_ parameter. It may be "
38710 "of the form *-L* _label_ or *-U* _uuid_ to indicate a device by label or "
38714 #. type: Plain text
38715 #: ../sys-utils/swapon.8.adoc:26
38717 "Calls to *swapon* normally occur in the system boot scripts making all swap "
38718 "devices available, so that the paging and swapping activity is interleaved "
38719 "across several devices and files."
38722 #. type: Plain text
38723 #: ../sys-utils/swapon.8.adoc:28
38725 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"
38728 #. type: Plain text
38729 #: ../sys-utils/swapon.8.adoc:33
38731 "All devices marked as \"swap\" in _/etc/fstab_ are made available, except "
38732 "for those with the \"noauto\" option. Devices that are already being used as "
38733 "swap are silently skipped."
38736 #. type: Plain text
38737 #: ../sys-utils/swapon.8.adoc:36
38739 "Specifies an alternative fstab file for compatibility with *mount*(8). If "
38740 "_path_ is a directory, then the files in the directory are sorted by "
38741 "*strverscmp*(3); files that start with \".\" or without an .fstab extension "
38742 "are ignored. The option can be specified more than once. This option is "
38743 "mostly designed for initramfs or chroot scripts where additional "
38744 "configuration is specified beyond standard system configuration."
38747 #. type: Labeled list
38748 #: ../sys-utils/swapon.8.adoc:37
38750 msgid "*-d*, *--discard*[**=**__policy__]"
38753 #. type: Plain text
38754 #: ../sys-utils/swapon.8.adoc:39
38756 "Enable swap discards, if the swap backing device supports the discard or "
38757 "trim operation. This may improve performance on some Solid State Devices, "
38758 "but often it does not. The option allows one to select between two available "
38759 "swap discard policies:"
38762 #. type: Labeled list
38763 #: ../sys-utils/swapon.8.adoc:40
38765 msgid "*--discard=once*"
38768 #. type: Plain text
38769 #: ../sys-utils/swapon.8.adoc:42
38771 "to perform a single-time discard operation for the whole swap area at "
38775 #. type: Labeled list
38776 #: ../sys-utils/swapon.8.adoc:43
38778 msgid "*--discard=pages*"
38781 #. type: Plain text
38782 #: ../sys-utils/swapon.8.adoc:45
38784 "to asynchronously discard freed swap pages before they are available for "
38788 #. type: Plain text
38789 #: ../sys-utils/swapon.8.adoc:48
38791 "If no policy is selected, the default behavior is to enable both discard "
38792 "types. The _/etc/fstab_ mount options *discard*, *discard=once*, or "
38793 "*discard=pages* may also be used to enable discard flags."
38796 #. type: Labeled list
38797 #: ../sys-utils/swapon.8.adoc:49
38799 #| msgid "*-f*, *--fast*"
38800 msgid "*-e*, *--ifexists*"
38801 msgstr "*-f*, *--fast*"
38803 #. type: Plain text
38804 #: ../sys-utils/swapon.8.adoc:51
38806 "Silently skip devices that do not exist. The _/etc/fstab_ mount option "
38807 "*nofail* may also be used to skip non-existing device."
38810 #. type: Labeled list
38811 #: ../sys-utils/swapon.8.adoc:52
38813 #| msgid "*-f*, *--fast*"
38814 msgid "*-f*, *--fixpgsz*"
38815 msgstr "*-f*, *--fast*"
38817 #. type: Plain text
38818 #: ../sys-utils/swapon.8.adoc:54
38820 "Reinitialize (exec mkswap) the swap space if its page size does not match "
38821 "that of the current running kernel. *mkswap*(8) initializes the whole device "
38822 "and does not check for bad blocks."
38825 #. type: Labeled list
38826 #: ../sys-utils/swapon.8.adoc:55
38828 msgid "*-L* _label_"
38831 #. type: Plain text
38832 #: ../sys-utils/swapon.8.adoc:57
38834 "Use the partition that has the specified _label_. (For this, access to _/"
38835 "proc/partitions_ is needed.)"
38838 #. type: Plain text
38839 #: ../sys-utils/swapon.8.adoc:60
38841 "Specify swap options by an __fstab__-compatible comma-separated string. For "
38845 #. type: Plain text
38846 #: ../sys-utils/swapon.8.adoc:62
38848 msgid "*swapon -o pri=1,discard=pages,nofail /dev/sda2*\n"
38851 #. type: Plain text
38852 #: ../sys-utils/swapon.8.adoc:64
38854 "The _opts_ string is evaluated last and overrides all other command line "
38858 #. type: Plain text
38859 #: ../sys-utils/swapon.8.adoc:67
38861 "Specify the priority of the swap device. _priority_ is a value between 0 and "
38862 "32767. Higher numbers indicate higher priority. See *swapon*(2) for a full "
38863 "description of swap priorities. Add **pri=**__value__ to the option field of "
38864 "_/etc/fstab_ for use with *swapon -a*. When no priority is defined, Linux "
38865 "kernel defaults to negative numbers."
38868 #. type: Labeled list
38869 #: ../sys-utils/swapon.8.adoc:68
38871 #| msgid "*-P*, *--pty*"
38872 msgid "*-s*, *--summary*"
38873 msgstr "*-P*, *--pty*"
38875 #. type: Plain text
38876 #: ../sys-utils/swapon.8.adoc:70
38878 "Display swap usage summary by device. Equivalent to *cat /proc/swaps*. This "
38879 "output format is DEPRECATED in favour of *--show* that provides better "
38880 "control on output data."
38883 #. type: Labeled list
38884 #: ../sys-utils/swapon.8.adoc:71
38886 msgid "*--show*[**=**__column__...]"
38889 #. type: Plain text
38890 #: ../sys-utils/swapon.8.adoc:73
38892 "Display a definable table of swap areas. See the *--help* output for a list "
38893 "of available columns."
38896 #. type: Plain text
38897 #: ../sys-utils/swapon.8.adoc:79
38898 msgid "Do not print headings when displaying *--show* output."
38901 #. type: Plain text
38902 #: ../sys-utils/swapon.8.adoc:82
38903 msgid "Display *--show* output without aligning table columns."
38906 #. type: Labeled list
38907 #: ../sys-utils/swapon.8.adoc:83
38912 #. type: Plain text
38913 #: ../sys-utils/swapon.8.adoc:85
38915 "Display swap size in bytes in *--show* output instead of in user-friendly "
38919 #. type: Labeled list
38920 #: ../sys-utils/swapon.8.adoc:86
38922 msgid "*-U* _uuid_"
38925 #. type: Plain text
38926 #: ../sys-utils/swapon.8.adoc:88
38927 msgid "Use the partition that has the specified _uuid_."
38930 #. type: Plain text
38931 #: ../sys-utils/swapon.8.adoc:97
38933 msgid "*swapoff* has the following exit status values since v2.36:\n"
38936 #. type: Plain text
38937 #: ../sys-utils/swapon.8.adoc:103
38938 msgid "system has insufficient memory to stop swapping (OOM)"
38941 #. type: Plain text
38942 #: ../sys-utils/swapon.8.adoc:106
38944 msgid "*swapoff*(2) syscall failed for another reason\n"
38947 #. type: Plain text
38948 #: ../sys-utils/swapon.8.adoc:109
38949 msgid "non-*swapoff*(2) syscall system error (out of memory, ...)"
38952 #. type: Plain text
38953 #: ../sys-utils/swapon.8.adoc:112
38954 msgid "usage or syntax error"
38957 #. type: Plain text
38958 #: ../sys-utils/swapon.8.adoc:115
38959 msgid "all swapoff failed on *--all*"
38962 #. type: Plain text
38963 #: ../sys-utils/swapon.8.adoc:118
38964 msgid "some swapoff succeeded on *--all*"
38967 #. type: Plain text
38968 #: ../sys-utils/swapon.8.adoc:120
38970 "The command *swapoff --all* returns 0 (all succeeded), 32 (all failed), or "
38971 "64 (some failed, some succeeded)."
38974 #. type: Plain text
38975 #: ../sys-utils/swapon.8.adoc:122
38977 "The old versions before v2.36 has no documented exit status, 0 means success "
38981 #. type: Labeled list
38982 #: ../sys-utils/swapon.8.adoc:133
38984 msgid "_/dev/sd??_"
38987 #. type: Plain text
38988 #: ../sys-utils/swapon.8.adoc:135
38989 msgid "standard paging devices"
38992 #. type: Plain text
38993 #: ../sys-utils/swapon.8.adoc:138
38995 #| msgid "Basic filesystem-independent options are:"
38996 msgid "ascii filesystem description table"
38997 msgstr "Základní volby nezávislé na souborovém systému jsou:"
39000 #: ../sys-utils/swapon.8.adoc:141
39002 msgid "Files with holes"
39005 #. type: Plain text
39006 #: ../sys-utils/swapon.8.adoc:144
39008 "The swap file implementation in the kernel expects to be able to write to "
39009 "the file directly, without the assistance of the filesystem. This is a "
39010 "problem on files with holes or on copy-on-write files on filesystems like "
39014 #. type: Plain text
39015 #: ../sys-utils/swapon.8.adoc:146
39017 "Commands like *cp*(1) or *truncate*(1) create files with holes. These files "
39018 "will be rejected by *swapon*."
39021 #. type: Plain text
39022 #: ../sys-utils/swapon.8.adoc:148
39024 "Preallocated files created by *fallocate*(1) may be interpreted as files "
39025 "with holes too depending of the filesystem. Preallocated swap files are "
39026 "supported on XFS since Linux 4.18."
39029 #. type: Plain text
39030 #: ../sys-utils/swapon.8.adoc:150
39032 "The most portable solution to create a swap file is to use *dd*(1) and _/dev/"
39037 #: ../sys-utils/swapon.8.adoc:151
39042 #. type: Plain text
39043 #: ../sys-utils/swapon.8.adoc:154
39045 "Swap files on Btrfs are supported since Linux 5.0 on files with *nocow* "
39046 "attribute. See the *btrfs*(5) manual page for more details."
39050 #: ../sys-utils/swapon.8.adoc:155
39055 #. type: Plain text
39056 #: ../sys-utils/swapon.8.adoc:158
39057 msgid "Swap over *NFS* may not work."
39061 #: ../sys-utils/swapon.8.adoc:159
39066 #. type: Plain text
39067 #: ../sys-utils/swapon.8.adoc:162
39069 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"
39072 #. type: Plain text
39073 #: ../sys-utils/swapon.8.adoc:166
39075 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
39076 msgid "The *swapon* command appeared in 4.0BSD."
39077 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
39079 #. type: Plain text
39080 #: ../sys-utils/swapon.8.adoc:177
39087 "*fallocate*(1),\n"
39094 #: ../sys-utils/switch_root.8.adoc:2
39096 msgid "switch_root(8)"
39099 #. type: Plain text
39100 #: ../sys-utils/switch_root.8.adoc:12
39102 "switch_root - switch to another filesystem as the root of the mount tree"
39105 #. type: Plain text
39106 #: ../sys-utils/switch_root.8.adoc:16
39108 msgid "*switch_root* [*-hV*]\n"
39111 #. type: Plain text
39112 #: ../sys-utils/switch_root.8.adoc:18
39114 msgid "*switch_root* _newroot init_ [_arg_...]\n"
39117 #. type: Plain text
39118 #: ../sys-utils/switch_root.8.adoc:22
39120 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"
39123 #. type: Plain text
39124 #: ../sys-utils/switch_root.8.adoc:24
39126 msgid "*WARNING: switch_root removes recursively all files and directories on the current root filesystem.*\n"
39129 #. type: Plain text
39130 #: ../sys-utils/switch_root.8.adoc:32
39132 msgid "*switch_root* returns 1 on failure, it never returns on success.\n"
39135 #. type: Plain text
39136 #: ../sys-utils/switch_root.8.adoc:36
39138 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"
39141 #. type: delimited block .
39142 #: ../sys-utils/switch_root.8.adoc:39
39144 msgid "mount --bind $DIR $DIR\n"
39147 #. type: Plain text
39148 #: ../sys-utils/switch_root.8.adoc:46
39150 "mailto:pjones@redhat.com[Peter Jones], mailto:katzj@redhat.com[Jeremy Katz], "
39151 "mailto:kzak@redhat.com[Karel Zak]"
39154 #. type: Plain text
39155 #: ../sys-utils/switch_root.8.adoc:53
39158 #| "*getmntent*(3),\n"
39160 #| "*findmnt*(8),\n"
39169 "*getmntent*(3),\n"
39176 #: ../sys-utils/tunelp.8.adoc:2
39181 #. type: Plain text
39182 #: ../sys-utils/tunelp.8.adoc:12
39183 msgid "tunelp - set various parameters for the lp device"
39186 #. type: Plain text
39187 #: ../sys-utils/tunelp.8.adoc:16
39189 msgid "*tunelp* [options] _device_\n"
39192 #. type: Plain text
39193 #: ../sys-utils/tunelp.8.adoc:20
39195 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"
39198 #. type: Labeled list
39199 #: ../sys-utils/tunelp.8.adoc:23
39201 msgid "*-i*, *--irq* _argument_"
39204 #. type: Plain text
39205 #: ../sys-utils/tunelp.8.adoc:25
39207 "specifies the IRQ to use for the parallel port in question. If this is set "
39208 "to something non-zero, *-t* and *-c* have no effect. If your port does not "
39209 "use interrupts, this option will make printing stop. The command *tunelp -i "
39210 "0* restores non-interrupt driven (polling) action, and your printer should "
39211 "work again. If your parallel port does support interrupts, interrupt-driven "
39212 "printing should be somewhat faster and efficient, and will probably be "
39216 #. type: Plain text
39217 #: ../sys-utils/tunelp.8.adoc:27
39219 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"
39222 #. type: Labeled list
39223 #: ../sys-utils/tunelp.8.adoc:28
39225 msgid "*-t*, *--time* _milliseconds_"
39228 #. type: Plain text
39229 #: ../sys-utils/tunelp.8.adoc:30
39231 "is the amount of time in jiffies that the driver waits if the printer "
39232 "doesn't take a character for the number of tries dictated by the *-c* "
39233 "parameter. 10 is the default value. If you want fastest possible printing, "
39234 "and don't care about system load, you may set this to 0. If you don't care "
39235 "how fast your printer goes, or are printing text on a slow printer with a "
39236 "buffer, then 500 (5 seconds) should be fine, and will give you very low "
39237 "system load. This value generally should be lower for printing graphics than "
39238 "text, by a factor of approximately 10, for best performance."
39241 #. type: Labeled list
39242 #: ../sys-utils/tunelp.8.adoc:31
39244 msgid "*-c*, *--chars* _characters_"
39247 #. type: Plain text
39248 #: ../sys-utils/tunelp.8.adoc:33
39250 "is the number of times to try to output a character to the printer before "
39251 "sleeping for *-t* _TIME_. It is the number of times around a loop that tries "
39252 "to send a character to the printer. 120 appears to be a good value for most "
39253 "printers in polling mode. 1000 is the default, because there are some "
39254 "printers that become jerky otherwise, but you _must_ set this to '1' to "
39255 "handle the maximal CPU efficiency if you are using interrupts. If you have a "
39256 "very fast printer, a value of 10 might make more sense even if in polling "
39257 "mode. If you have a _really_ old printer, you can increase this further."
39260 #. type: Plain text
39261 #: ../sys-utils/tunelp.8.adoc:35
39263 "Setting *-t* _TIME_ to 0 is equivalent to setting *-c* _CHARS_ to infinity."
39266 #. type: Labeled list
39267 #: ../sys-utils/tunelp.8.adoc:36
39269 msgid "*-w*, *--wait* _milliseconds_"
39272 #. type: Plain text
39273 #: ../sys-utils/tunelp.8.adoc:38
39275 "is the number of usec we wait while playing with the strobe signal. While "
39276 "most printers appear to be able to deal with an extremely short strobe, some "
39277 "printers demand a longer one. Increasing this from the default 1 may make it "
39278 "possible to print with those printers. This may also make it possible to use "
39279 "longer cables. It's also possible to decrease this value to 0 if your "
39280 "printer is fast enough or your machine is slow enough."
39283 #. type: Labeled list
39284 #: ../sys-utils/tunelp.8.adoc:39
39286 msgid "*-a*, *--abort* _<on|off>_"
39289 #. type: Plain text
39290 #: ../sys-utils/tunelp.8.adoc:41
39292 "This is whether to abort on printer error - the default is not to. If you "
39293 "are sitting at your computer, you probably want to be able to see an error "
39294 "and fix it, and have the printer go on printing. On the other hand, if you "
39295 "aren't, you might rather that your printer spooler find out that the printer "
39296 "isn't ready, quit trying, and send you mail about it. The choice is yours."
39299 #. type: Labeled list
39300 #: ../sys-utils/tunelp.8.adoc:42
39302 msgid "*-o*, *--check-status* _<on|off>_"
39305 #. type: Plain text
39306 #: ../sys-utils/tunelp.8.adoc:44
39308 "This option is much like *-a*. It makes any *open*(2) of this device check "
39309 "to see that the device is on-line and not reporting any out of paper or "
39310 "other errors. This is the correct setting for most versions of *lpd*."
39313 #. type: Labeled list
39314 #: ../sys-utils/tunelp.8.adoc:45
39316 msgid "*-C*, *--careful* _<on|off>_"
39319 #. type: Plain text
39320 #: ../sys-utils/tunelp.8.adoc:47
39322 "This option adds extra (\"careful\") error checking. When this option is on, "
39323 "the printer driver will ensure that the printer is on-line and not reporting "
39324 "any out of paper or other errors before sending data. This is particularly "
39325 "useful for printers that normally appear to accept data when turned off."
39328 #. type: Plain text
39329 #: ../sys-utils/tunelp.8.adoc:49
39331 msgid "*NOTE*: This option is obsolete because it's the default in 2.1.131 kernel or later.\n"
39334 #. type: Labeled list
39335 #: ../sys-utils/tunelp.8.adoc:50
39337 #| msgid "*-f*, *--fast*"
39338 msgid "*-s*, *--status*"
39339 msgstr "*-f*, *--fast*"
39341 #. type: Plain text
39342 #: ../sys-utils/tunelp.8.adoc:52
39344 "This option returns the current printer status, both as a decimal number "
39345 "from 0..255, and as a list of active flags. When this option is specified, *-"
39346 "q* off, turning off the display of the current IRQ, is implied."
39349 #. type: Plain text
39350 #: ../sys-utils/tunelp.8.adoc:55
39352 "This option resets the port. It requires a Linux kernel version of 1.1.80 or "
39356 #. type: Labeled list
39357 #: ../sys-utils/tunelp.8.adoc:56
39359 msgid "*-q*, *--print-irq* _<on|off>_"
39362 #. type: Plain text
39363 #: ../sys-utils/tunelp.8.adoc:58
39364 msgid "This option sets printing the display of the current IRQ setting."
39367 #. type: Plain text
39368 #: ../sys-utils/tunelp.8.adoc:63
39369 msgid "_/dev/lp?_, _/proc/parport/*/*_"
39372 #. type: Plain text
39373 #: ../sys-utils/tunelp.8.adoc:67
39375 msgid "*-o*, *-C*, and *-s* all require a Linux kernel version of 1.1.76 or later.\n"
39378 #. type: Plain text
39379 #: ../sys-utils/tunelp.8.adoc:69
39381 msgid "*-C* requires a Linux version prior to 2.1.131.\n"
39388 #. Copyright (c) 1996 Andries Brouwer
39389 #. This page is somewhat derived from a page that was
39390 #. (c) 1980, 1989, 1991 The Regents of the University of California
39391 #. and had been heavily modified by Rik Faith and myself.
39392 #. This is free documentation; you can redistribute it and/or
39393 #. modify it under the terms of the GNU General Public License as
39394 #. published by the Free Software Foundation; either version 2 of
39395 #. the License, or (at your option) any later version.
39396 #. The GNU General Public License's references to "object code"
39397 #. and "executables" are to be interpreted as the output of any
39398 #. document formatting or typesetting system, including
39399 #. intermediate and printed output.
39400 #. This manual is distributed in the hope that it will be useful,
39401 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
39402 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
39403 #. GNU General Public License for more details.
39404 #. You should have received a copy of the GNU General Public License along
39405 #. with this program; if not, write to the Free Software Foundation, Inc.,
39406 #. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
39408 #: ../sys-utils/umount.8.adoc:27
39413 #. type: Plain text
39414 #: ../sys-utils/umount.8.adoc:37
39415 msgid "umount - unmount filesystems"
39418 #. type: Plain text
39419 #: ../sys-utils/umount.8.adoc:41
39421 msgid "*umount* *-a* [*-dflnrv*] [*-t* _fstype_] [*-O* _option_...]\n"
39424 #. type: Plain text
39425 #: ../sys-utils/umount.8.adoc:43
39427 msgid "*umount* [*-dflnrv*] {_directory_|_device_}\n"
39430 #. type: Plain text
39431 #: ../sys-utils/umount.8.adoc:45
39433 msgid "*umount* *-h*|*-V*\n"
39436 #. type: Plain text
39437 #: ../sys-utils/umount.8.adoc:49
39439 "The *umount* command detaches the mentioned filesystem(s) from the file "
39440 "hierarchy. A filesystem is specified by giving the directory where it has "
39441 "been mounted. Giving the special device on which the filesystem lives may "
39442 "also work, but is obsolete, mainly because it will fail in case this device "
39443 "was mounted on more than one directory."
39446 #. type: Plain text
39447 #: ../sys-utils/umount.8.adoc:51
39449 "Note that a filesystem cannot be unmounted when it is 'busy' - for example, "
39450 "when there are open files on it, or when some process has its working "
39451 "directory there, or when a swap file on it is in use. The offending process "
39452 "could even be *umount* itself - it opens libc, and libc in its turn may open "
39453 "for example locale files. A lazy unmount avoids this problem, but it may "
39454 "introduce other issues. See *--lazy* description below."
39457 #. type: Plain text
39458 #: ../sys-utils/umount.8.adoc:56
39460 "All of the filesystems described in _/proc/self/mountinfo_ (or in deprecated "
39461 "_/etc/mtab_) are unmounted, except the proc, devfs, devpts, sysfs, "
39462 "rpc_pipefs and nfsd filesystems. This list of the filesystems may be "
39463 "replaced by *--types* umount option."
39466 #. type: Labeled list
39467 #: ../sys-utils/umount.8.adoc:57
39469 #| msgid "*-f*, *--fast*"
39470 msgid "*-A*, *--all-targets*"
39471 msgstr "*-f*, *--fast*"
39473 #. type: Plain text
39474 #: ../sys-utils/umount.8.adoc:59
39476 "Unmount all mountpoints in the current mount namespace for the specified "
39477 "filesystem. The filesystem can be specified by one of the mountpoints or the "
39478 "device name (or UUID, etc.). When this option is used together with *--"
39479 "recursive*, then all nested mounts within the filesystem are recursively "
39480 "unmounted. This option is only supported on systems where _/etc/mtab_ is a "
39481 "symlink to _/proc/mounts_."
39484 #. type: Plain text
39485 #: ../sys-utils/umount.8.adoc:62
39487 "Do not canonicalize paths. The paths canonicalization is based on *stat*(2) "
39488 "and *readlink*(2) system calls. These system calls may hang in some cases "
39489 "(for example on NFS if server is not available). The option has to be used "
39490 "with canonical path to the mount point."
39493 #. type: Plain text
39494 #: ../sys-utils/umount.8.adoc:64
39495 msgid "This option is silently ignored by *umount* for non-root users."
39498 #. type: Plain text
39499 #: ../sys-utils/umount.8.adoc:66
39501 "For more details about this option see the *mount*(8) man page. Note that "
39502 "*umount* does not pass this option to the **/sbin/umount.**__type__ helpers."
39505 #. type: Labeled list
39506 #: ../sys-utils/umount.8.adoc:67
39508 #| msgid "*-h*, *--help*"
39509 msgid "*-d*, *--detach-loop*"
39510 msgstr "*-h*, *--help*"
39512 #. type: Plain text
39513 #: ../sys-utils/umount.8.adoc:69
39515 "When the unmounted device was a loop device, also free this loop device. "
39516 "This option is unnecessary for devices initialized by *mount*(8), in this "
39517 "case \"autoclear\" functionality is enabled by default."
39520 #. type: Labeled list
39521 #: ../sys-utils/umount.8.adoc:70
39526 #. type: Plain text
39527 #: ../sys-utils/umount.8.adoc:72
39529 "Causes everything to be done except for the actual system call or umount "
39530 "helper execution; this 'fakes' unmounting the filesystem. It can be used to "
39531 "remove entries from the deprecated _/etc/mtab_ that were unmounted earlier "
39532 "with the *-n* option."
39535 #. type: Plain text
39536 #: ../sys-utils/umount.8.adoc:75
39537 msgid "Force an unmount (in case of an unreachable NFS system)."
39540 #. type: Plain text
39541 #: ../sys-utils/umount.8.adoc:77
39543 "Note that this option does not guarantee that umount command does not hang. "
39544 "It's strongly recommended to use absolute paths without symlinks to avoid "
39545 "unwanted *readlink*(2) and *stat*(2) system calls on unreachable NFS in "
39549 #. type: Labeled list
39550 #: ../sys-utils/umount.8.adoc:78
39552 #| msgid "*-V*, *--version*"
39553 msgid "*-i*, *--internal-only*"
39554 msgstr "*-V*, *--version*"
39556 #. type: Plain text
39557 #: ../sys-utils/umount.8.adoc:80
39559 "Do not call the **/sbin/umount.**__filesystem__ helper even if it exists. By "
39560 "default such a helper program is called if it exists."
39563 #. type: Labeled list
39564 #: ../sys-utils/umount.8.adoc:81
39566 #| msgid "*-P*, *--pty*"
39567 msgid "*-l*, *--lazy*"
39568 msgstr "*-P*, *--pty*"
39570 #. type: Plain text
39571 #: ../sys-utils/umount.8.adoc:83
39573 "Lazy unmount. Detach the filesystem from the file hierarchy now, and clean "
39574 "up all references to this filesystem as soon as it is not busy anymore."
39577 #. type: Plain text
39578 #: ../sys-utils/umount.8.adoc:85
39580 "A system reboot would be expected in near future if you're going to use this "
39581 "option for network filesystem or local filesystem with submounts. The "
39582 "recommended use-case for *umount -l* is to prevent hangs on shutdown due to "
39583 "an unreachable network share where a normal *umount* will hang due to a "
39584 "downed server or a network partition. Remounts of the share will not be "
39588 #. type: Plain text
39589 #: ../sys-utils/umount.8.adoc:88
39591 "Perform *umount* in the mount namespace specified by _ns_. _ns_ is either "
39592 "PID of process running in that namespace or special file representing that "
39596 #. type: Plain text
39597 #: ../sys-utils/umount.8.adoc:90
39599 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"
39602 #. type: Plain text
39603 #: ../sys-utils/umount.8.adoc:95
39604 msgid "Unmount without writing in _/etc/mtab_."
39607 #. type: Labeled list
39608 #: ../sys-utils/umount.8.adoc:96
39610 msgid "*-O*, *--test-opts* _option_..."
39613 #. type: Plain text
39614 #: ../sys-utils/umount.8.adoc:98
39616 "Unmount only the filesystems that have the specified option set in _/etc/"
39617 "fstab_. More than one option may be specified in a comma-separated list. "
39618 "Each option can be prefixed with *no* to indicate that no action should be "
39619 "taken for this option."
39622 #. type: Plain text
39623 #: ../sys-utils/umount.8.adoc:101
39624 msgid "Suppress \"not mounted\" error messages."
39627 #. type: Labeled list
39628 #: ../sys-utils/umount.8.adoc:102
39630 #| msgid "*-V*, *--version*"
39631 msgid "*-R*, *--recursive*"
39632 msgstr "*-V*, *--version*"
39634 #. type: Plain text
39635 #: ../sys-utils/umount.8.adoc:104
39637 "Recursively unmount each specified directory. Recursion for each directory "
39638 "will stop if any unmount operation in the chain fails for any reason. The "
39639 "relationship between mountpoints is determined by _/proc/self/mountinfo_ "
39640 "entries. The filesystem must be specified by mountpoint path; a recursive "
39641 "unmount by device name (or UUID) is unsupported. Since version 2.37 it "
39642 "umounts also all over-mounted filesystems (more filesystems on the same "
39646 #. type: Plain text
39647 #: ../sys-utils/umount.8.adoc:107
39648 msgid "When an unmount fails, try to remount the filesystem read-only."
39651 #. type: Labeled list
39652 #: ../sys-utils/umount.8.adoc:108
39654 msgid "*-t*, *--types* _type_..."
39657 #. type: Plain text
39658 #: ../sys-utils/umount.8.adoc:110
39660 "Indicate that the actions should only be taken on filesystems of the "
39661 "specified _type_. More than one type may be specified in a comma-separated "
39662 "list. The list of filesystem types can be prefixed with *no* to indicate "
39663 "that no action should be taken for all of the mentioned types. Note that "
39664 "*umount* reads information about mounted filesystems from kernel (_/proc/"
39665 "mounts_) and filesystem names may be different than filesystem names used in "
39666 "the _/etc/fstab_ (e.g., \"nfs4\" vs. \"nfs\")."
39670 #: ../sys-utils/umount.8.adoc:116
39672 msgid "NON-SUPERUSER UMOUNTS"
39675 #. type: Plain text
39676 #: ../sys-utils/umount.8.adoc:119
39678 "Normally, only the superuser can umount filesystems. However, when _fstab_ "
39679 "contains the *user* option on a line, anybody can umount the corresponding "
39680 "filesystem. For more details see *mount*(8) man page."
39683 #. type: Plain text
39684 #: ../sys-utils/umount.8.adoc:121
39686 "Since version 2.34 the *umount* command can be used to perform umount "
39687 "operation also for fuse filesystems if kernel mount table contains user's "
39688 "ID. In this case _fstab_ *user=* mount option is not required."
39691 #. type: Plain text
39692 #: ../sys-utils/umount.8.adoc:123
39694 "Since version 2.35 *umount* command does not exit when user permissions are "
39695 "inadequate by internal *libmount* security rules. It drops suid permissions "
39696 "and continue as regular non-root user. This can be used to support use-cases "
39697 "where root permissions are not necessary (e.g., fuse filesystems, user "
39698 "namespaces, etc)."
39702 #: ../sys-utils/umount.8.adoc:124
39704 msgid "LOOP DEVICE"
39707 #. type: Plain text
39708 #: ../sys-utils/umount.8.adoc:127
39710 "The *umount* command will automatically detach loop device previously "
39711 "initialized by *mount*(8) command independently of _/etc/mtab_."
39714 #. type: Plain text
39715 #: ../sys-utils/umount.8.adoc:129
39717 "In this case the device is initialized with \"autoclear\" flag (see "
39718 "*losetup*(8) output for more details), otherwise it's necessary to use the "
39719 "option *--detach-loop* or call *losetup -d* _device_. The autoclear feature "
39720 "is supported since Linux 2.6.25."
39723 #. type: Plain text
39724 #: ../sys-utils/umount.8.adoc:133
39725 msgid "The syntax of external unmount helpers is:"
39728 #. type: delimited block _
39729 #: ../sys-utils/umount.8.adoc:136
39731 msgid "**umount.**__suffix__ {__directory__|_device_} [*-flnrv*] [*-N* _namespace_] [*-t* _type_._subtype_]\n"
39734 #. type: Plain text
39735 #: ../sys-utils/umount.8.adoc:139
39737 "where _suffix_ is the filesystem type (or the value from a *uhelper=* or "
39738 "*helper=* marker in the mtab file). The *-t* option can be used for "
39739 "filesystems that have subtype support. For example:"
39742 #. type: delimited block _
39743 #: ../sys-utils/umount.8.adoc:142
39745 msgid "*umount.fuse -t fuse.sshfs*\n"
39748 #. type: Plain text
39749 #: ../sys-utils/umount.8.adoc:145
39751 "A **uhelper=**__something__ marker (unprivileged helper) can appear in the _/"
39752 "etc/mtab_ file when ordinary users need to be able to unmount a mountpoint "
39753 "that is not defined in _/etc/fstab_ (for example for a device that was "
39754 "mounted by *udisks*(1))."
39757 #. type: Plain text
39758 #: ../sys-utils/umount.8.adoc:147
39760 "A **helper=**__type__ marker in the _mtab_ file will redirect all unmount "
39761 "requests to the **/sbin/umount.**__type__ helper independently of UID."
39764 #. type: Plain text
39765 #: ../sys-utils/umount.8.adoc:149
39767 "Note that _/etc/mtab_ is currently deprecated and *helper=* and other "
39768 "userspace mount options are maintained by *libmount*."
39771 #. type: Plain text
39772 #: ../sys-utils/umount.8.adoc:154
39773 msgid "overrides the default location of the _fstab_ file (ignored for *suid*)"
39776 #. type: Plain text
39777 #: ../sys-utils/umount.8.adoc:157
39778 msgid "enables *libmount* debug output"
39781 #. type: Plain text
39782 #: ../sys-utils/umount.8.adoc:162
39784 "table of mounted filesystems (deprecated and usually replaced by symlink to "
39788 #. type: Plain text
39789 #: ../sys-utils/umount.8.adoc:165
39790 msgid "table of known filesystems"
39793 #. type: Labeled list
39794 #: ../sys-utils/umount.8.adoc:166
39796 msgid "_/proc/self/mountinfo_"
39799 #. type: Plain text
39800 #: ../sys-utils/umount.8.adoc:168
39801 msgid "table of mounted filesystems generated by kernel."
39804 #. type: Plain text
39805 #: ../sys-utils/umount.8.adoc:172
39807 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
39808 msgid "A *umount* command appeared in Version 6 AT&T UNIX."
39809 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
39811 #. type: Plain text
39812 #: ../sys-utils/umount.8.adoc:179
39817 "*mount_namespaces*(7),\n"
39822 #: ../sys-utils/unshare.1.adoc:2
39827 #. type: Plain text
39828 #: ../sys-utils/unshare.1.adoc:12
39829 msgid "unshare - run program in new namespaces"
39832 #. type: Plain text
39833 #: ../sys-utils/unshare.1.adoc:16
39835 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
39836 msgid "*unshare* [options] [_program_ [_arguments_]]\n"
39837 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
39839 #. type: Plain text
39840 #: ../sys-utils/unshare.1.adoc:20
39842 "The *unshare* command creates new namespaces (as specified by the command-"
39843 "line options described below) and then executes the specified _program_. If "
39844 "_program_ is not given, then \"${SHELL}\" is run (default: _/bin/sh_)."
39847 #. type: Plain text
39848 #: ../sys-utils/unshare.1.adoc:22
39850 "By default, a new namespace persists only as long as it has member "
39851 "processes. A new namespace can be made persistent even when it has no member "
39852 "processes by bind mounting /proc/_pid_/ns/_type_ files to a filesystem path. "
39853 "A namespace that has been made persistent in this way can subsequently be "
39854 "entered with *nsenter*(1) even after the _program_ terminates (except PID "
39855 "namespaces where a permanently running init process is required). Once a "
39856 "persistent namespace is no longer needed, it can be unpersisted by using "
39857 "*umount*(8) to remove the bind mount. See the *EXAMPLES* section for more "
39861 #. type: Plain text
39862 #: ../sys-utils/unshare.1.adoc:24
39864 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"
39867 #. type: Plain text
39868 #: ../sys-utils/unshare.1.adoc:26
39869 msgid "The following types of namespaces can be created with *unshare*:"
39872 #. type: Plain text
39873 #: ../sys-utils/unshare.1.adoc:29
39875 "Mounting and unmounting filesystems will not affect the rest of the system, "
39876 "except for filesystems which are explicitly marked as shared (with *mount --"
39877 "make-shared*; see _/proc/self/mountinfo_ or *findmnt -o+PROPAGATION* for the "
39878 "*shared* flags). For further details, see *mount_namespaces*(7)."
39881 #. type: Plain text
39882 #: ../sys-utils/unshare.1.adoc:31
39884 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"
39887 #. type: Plain text
39888 #: ../sys-utils/unshare.1.adoc:43
39890 "Children will have a distinct set of PID-to-process mappings from their "
39891 "parent. For further details, see *pid_namespaces*(7)."
39894 #. type: Labeled list
39895 #: ../sys-utils/unshare.1.adoc:55
39897 msgid "*-i*, *--ipc*[**=**__file__]"
39900 #. type: Plain text
39901 #: ../sys-utils/unshare.1.adoc:57
39903 "Create a new IPC namespace. If _file_ is specified, then the namespace is "
39904 "made persistent by creating a bind mount at _file_."
39907 #. type: Labeled list
39908 #: ../sys-utils/unshare.1.adoc:58
39910 msgid "*-m*, *--mount*[**=**__file__]"
39913 #. type: Plain text
39914 #: ../sys-utils/unshare.1.adoc:60
39916 "Create a new mount namespace. If _file_ is specified, then the namespace is "
39917 "made persistent by creating a bind mount at _file_. Note that _file_ must be "
39918 "located on a mount whose propagation type is not *shared* (or an error "
39919 "results). Use the command *findmnt -o+PROPAGATION* when not sure about the "
39920 "current setting. See also the examples below."
39923 #. type: Labeled list
39924 #: ../sys-utils/unshare.1.adoc:61
39926 #| msgid "*-s*, **--shell**=__shell__"
39927 msgid "*-n*, *--net*[**=**__file__]"
39928 msgstr "*-s*, **--shell**=__shell__"
39930 #. type: Plain text
39931 #: ../sys-utils/unshare.1.adoc:63
39933 "Create a new network namespace. If _file_ is specified, then the namespace "
39934 "is made persistent by creating a bind mount at _file_."
39937 #. type: Labeled list
39938 #: ../sys-utils/unshare.1.adoc:64
39940 msgid "*-p*, *--pid*[**=**__file__]"
39943 #. type: Plain text
39944 #: ../sys-utils/unshare.1.adoc:66
39946 "Create a new PID namespace. If _file_ is specified, then the namespace is "
39947 "made persistent by creating a bind mount at _file_. (Creation of a "
39948 "persistent PID namespace will fail if the *--fork* option is not also "
39952 #. type: Plain text
39953 #: ../sys-utils/unshare.1.adoc:68
39954 msgid "See also the *--fork* and *--mount-proc* options."
39957 #. type: Labeled list
39958 #: ../sys-utils/unshare.1.adoc:69
39960 #| msgid "*-s*, **--shell**=__shell__"
39961 msgid "*-u*, *--uts*[**=**__file__]"
39962 msgstr "*-s*, **--shell**=__shell__"
39964 #. type: Plain text
39965 #: ../sys-utils/unshare.1.adoc:71
39967 "Create a new UTS namespace. If _file_ is specified, then the namespace is "
39968 "made persistent by creating a bind mount at _file_."
39971 #. type: Labeled list
39972 #: ../sys-utils/unshare.1.adoc:72
39974 #| msgid "*-s*, **--shell**=__shell__"
39975 msgid "*-U*, *--user*[**=**__file__]"
39976 msgstr "*-s*, **--shell**=__shell__"
39978 #. type: Plain text
39979 #: ../sys-utils/unshare.1.adoc:74
39981 "Create a new user namespace. If _file_ is specified, then the namespace is "
39982 "made persistent by creating a bind mount at _file_."
39985 #. type: Labeled list
39986 #: ../sys-utils/unshare.1.adoc:75
39988 #| msgid "*-g*, **--group**=__group__"
39989 msgid "*-C*, *--cgroup*[**=**__file__]"
39990 msgstr "*-g*, **--group**=__skupina__"
39992 #. type: Plain text
39993 #: ../sys-utils/unshare.1.adoc:77
39995 "Create a new cgroup namespace. If _file_ is specified, then the namespace is "
39996 "made persistent by creating a bind mount at _file_."
39999 #. type: Labeled list
40000 #: ../sys-utils/unshare.1.adoc:78
40002 #| msgid "*-s*, **--shell**=__shell__"
40003 msgid "*-T*, *--time*[**=**__file__]"
40004 msgstr "*-s*, **--shell**=__shell__"
40006 #. type: Plain text
40007 #: ../sys-utils/unshare.1.adoc:80
40009 "Create a new time namespace. If _file_ is specified, then the namespace is "
40010 "made persistent by creating a bind mount at _file_. The *--monotonic* and *--"
40011 "boottime* options can be used to specify the corresponding offset in the "
40015 #. type: Plain text
40016 #: ../sys-utils/unshare.1.adoc:83
40018 "Fork the specified _program_ as a child process of *unshare* rather than "
40019 "running it directly. This is useful when creating a new PID namespace. Note "
40020 "that when *unshare* is waiting for the child process, then it ignores "
40021 "*SIGINT* and *SIGTERM* and does not forward any signals to the child. It is "
40022 "necessary to send signals to the child process."
40025 #. type: Labeled list
40026 #: ../sys-utils/unshare.1.adoc:87
40028 msgid "*--kill-child*[**=**__signame__]"
40031 #. type: Plain text
40032 #: ../sys-utils/unshare.1.adoc:89
40034 "When *unshare* terminates, have _signame_ be sent to the forked child "
40035 "process. Combined with *--pid* this allows for an easy and reliable killing "
40036 "of the entire process tree below *unshare*. If not given, _signame_ defaults "
40037 "to *SIGKILL*. This option implies *--fork*."
40040 #. type: Labeled list
40041 #: ../sys-utils/unshare.1.adoc:90
40043 msgid "*--mount-proc*[**=**__mountpoint__]"
40046 #. type: Plain text
40047 #: ../sys-utils/unshare.1.adoc:92
40049 "Just before running the program, mount the proc filesystem at _mountpoint_ "
40050 "(default is _/proc_). This is useful when creating a new PID namespace. It "
40051 "also implies creating a new mount namespace since the _/proc_ mount would "
40052 "otherwise mess up existing programs on the system. The new proc filesystem "
40053 "is explicitly mounted as private (with *MS_PRIVATE*|*MS_REC*)."
40056 #. type: Labeled list
40057 #: ../sys-utils/unshare.1.adoc:93
40059 msgid "**--map-user=**__uid|name__"
40062 #. type: Plain text
40063 #: ../sys-utils/unshare.1.adoc:95
40065 "Run the program only after the current effective user ID has been mapped to "
40066 "_uid_. If this option is specified multiple times, the last occurrence takes "
40067 "precedence. This option implies *--user*."
40070 #. type: Labeled list
40071 #: ../sys-utils/unshare.1.adoc:96
40073 msgid "**--map-users=**__inneruid:outeruid:count__|**auto**|**all**"
40076 #. type: Plain text
40077 #: ../sys-utils/unshare.1.adoc:98
40079 "Run the program only after the block of user IDs of size _count_ beginning "
40080 "at _outeruid_ has been mapped to the block of user IDs beginning at "
40081 "_inneruid_. This mapping is created with **newuidmap**(1) if *unshare* was "
40082 "run unprivileged. If the range of user IDs overlaps with the mapping "
40083 "specified by *--map-user*, then a \"hole\" will be removed from the mapping. "
40084 "This may result in the highest user ID of the mapping not being mapped. Use "
40085 "*--map-users* multiple times to map more than one block of user IDs. The "
40086 "special value *auto* will map the first block of user IDs owned by the "
40087 "effective user from _/etc/subuid_ to a block starting at user ID 0. The "
40088 "special value *all* will create a pass-through map for every user ID "
40089 "available in the parent namespace. This option implies *--user*."
40092 #. type: Plain text
40093 #: ../sys-utils/unshare.1.adoc:100
40095 "Before util-linux version 2.39, this option expected a comma-separated "
40096 "argument of the form _outeruid,inneruid,count_ but that format is now "
40097 "deprecated for consistency with the ordering used in _/proc/[pid]/uid_map_ "
40098 "and the _X-mount.idmap_ mount option."
40101 #. type: Labeled list
40102 #: ../sys-utils/unshare.1.adoc:101
40104 #| msgid "*-G*, **--supp-group**=__group__"
40105 msgid "**--map-group=**__gid|name__"
40106 msgstr "*-G*, **--supp-group**=__skupina__"
40108 #. type: Plain text
40109 #: ../sys-utils/unshare.1.adoc:103
40111 "Run the program only after the current effective group ID has been mapped to "
40112 "_gid_. If this option is specified multiple times, the last occurrence takes "
40113 "precedence. This option implies *--setgroups=deny* and *--user*."
40116 #. type: Labeled list
40117 #: ../sys-utils/unshare.1.adoc:104
40119 msgid "**--map-groups=**__innergid:outergid:count__|**auto**|**all**"
40122 #. type: Plain text
40123 #: ../sys-utils/unshare.1.adoc:106
40125 "Run the program only after the block of group IDs of size _count_ beginning "
40126 "at _outergid_ has been mapped to the block of group IDs beginning at "
40127 "_innergid_. This mapping is created with **newgidmap**(1) if *unshare* was "
40128 "run unprivileged. If the range of group IDs overlaps with the mapping "
40129 "specified by *--map-group*, then a \"hole\" will be removed from the "
40130 "mapping. This may result in the highest group ID of the mapping not being "
40131 "mapped. Use *--map-groups* multiple times to map more than one block of "
40132 "group IDs. The special value *auto* will map the first block of user IDs "
40133 "owned by the effective user from _/etc/subgid_ to a block starting at group "
40134 "ID 0. The special value *all* will create a pass-through map for every group "
40135 "ID available in the parent namespace. This option implies *--user*."
40138 #. type: Plain text
40139 #: ../sys-utils/unshare.1.adoc:108
40141 "Before util-linux version 2.39, this option expected a comma-separated "
40142 "argument of the form _outergid,innergid,count_ but that format is now "
40143 "deprecated for consistency with the ordering used in _/proc/[pid]/gid_map_ "
40144 "and the _X-mount.idmap_ mount option."
40147 #. type: Labeled list
40148 #: ../sys-utils/unshare.1.adoc:109
40150 msgid "**--map-auto**"
40153 #. type: Plain text
40154 #: ../sys-utils/unshare.1.adoc:111
40156 "Map the first block of user IDs owned by the effective user from _/etc/"
40157 "subuid_ to a block starting at user ID 0. In the same manner, also map the "
40158 "first block of group IDs owned by the effective group from _/etc/subgid_ to "
40159 "a block starting at group ID 0. This option is intended to handle the common "
40160 "case where the first block of subordinate user and group IDs can map the "
40161 "whole user and group ID space. This option is equivalent to specifying *--"
40162 "map-users=auto* and *--map-groups=auto*."
40165 #. type: Labeled list
40166 #: ../sys-utils/unshare.1.adoc:112
40168 #| msgid "*-P*, *--pty*"
40169 msgid "*-r*, *--map-root-user*"
40170 msgstr "*-P*, *--pty*"
40172 #. type: Plain text
40173 #: ../sys-utils/unshare.1.adoc:114
40175 "Run the program only after the current effective user and group IDs have "
40176 "been mapped to the superuser UID and GID in the newly created user "
40177 "namespace. This makes it possible to conveniently gain capabilities needed "
40178 "to manage various aspects of the newly created namespaces (such as "
40179 "configuring interfaces in the network namespace or mounting filesystems in "
40180 "the mount namespace) even when run unprivileged. As a mere convenience "
40181 "feature, it does not support more sophisticated use cases, such as mapping "
40182 "multiple ranges of UIDs and GIDs. This option implies *--setgroups=deny* and "
40183 "*--user*. This option is equivalent to *--map-user=0 --map-group=0*."
40186 #. type: Labeled list
40187 #: ../sys-utils/unshare.1.adoc:115
40189 msgid "*-c*, *--map-current-user*"
40192 #. type: Plain text
40193 #: ../sys-utils/unshare.1.adoc:117
40195 "Run the program only after the current effective user and group IDs have "
40196 "been mapped to the same UID and GID in the newly created user namespace. "
40197 "This option implies *--setgroups=deny* and *--user*. This option is "
40198 "equivalent to *--map-user=$(id -ru) --map-group=$(id -rg)*."
40201 #. type: Labeled list
40202 #: ../sys-utils/unshare.1.adoc:118
40204 msgid "**--propagation private**|**shared**|**slave**|*unchanged*"
40207 #. type: Plain text
40208 #: ../sys-utils/unshare.1.adoc:120
40210 "Recursively set the mount propagation flag in the new mount namespace. The "
40211 "default is to set the propagation to _private_. It is possible to disable "
40212 "this feature with the argument *unchanged*. The option is silently ignored "
40213 "when the mount namespace (*--mount*) is not requested."
40216 #. type: Labeled list
40217 #: ../sys-utils/unshare.1.adoc:121
40219 msgid "**--setgroups allow**|*deny*"
40222 #. type: Plain text
40223 #: ../sys-utils/unshare.1.adoc:123
40224 msgid "Allow or deny the *setgroups*(2) system call in a user namespace."
40227 #. type: Plain text
40228 #: ../sys-utils/unshare.1.adoc:125
40230 "To be able to call *setgroups*(2), the calling process must at least have "
40231 "*CAP_SETGID*. But since Linux 3.19 a further restriction applies: the kernel "
40232 "gives permission to call *setgroups*(2) only after the GID map (**/proc/"
40233 "**__pid__*/gid_map*) has been set. The GID map is writable by root when "
40234 "*setgroups*(2) is enabled (i.e., *allow*, the default), and the GID map "
40235 "becomes writable by unprivileged processes when *setgroups*(2) is "
40236 "permanently disabled (with *deny*)."
40239 #. type: Labeled list
40240 #: ../sys-utils/unshare.1.adoc:126
40242 #| msgid "*-g*, **--group**=__group__"
40243 msgid "*-R*, **--root=**__dir__"
40244 msgstr "*-g*, **--group**=__skupina__"
40246 #. type: Plain text
40247 #: ../sys-utils/unshare.1.adoc:128
40248 msgid "run the command with root directory set to _dir_."
40251 #. type: Labeled list
40252 #: ../sys-utils/unshare.1.adoc:129
40254 #| msgid "*-g*, **--group**=__group__"
40255 msgid "*-w*, **--wd=**__dir__"
40256 msgstr "*-g*, **--group**=__skupina__"
40258 #. type: Plain text
40259 #: ../sys-utils/unshare.1.adoc:131
40260 msgid "change working directory to _dir_."
40263 #. type: Plain text
40264 #: ../sys-utils/unshare.1.adoc:134
40265 msgid "Set the user ID which will be used in the entered namespace."
40268 #. type: Plain text
40269 #: ../sys-utils/unshare.1.adoc:137
40271 "Set the group ID which will be used in the entered namespace and drop "
40272 "supplementary groups."
40275 #. type: Labeled list
40276 #: ../sys-utils/unshare.1.adoc:138
40278 msgid "*--monotonic* _offset_"
40281 #. type: Plain text
40282 #: ../sys-utils/unshare.1.adoc:140
40284 "Set the offset of *CLOCK_MONOTONIC* which will be used in the entered time "
40285 "namespace. This option requires unsharing a time namespace with *--time*."
40288 #. type: Labeled list
40289 #: ../sys-utils/unshare.1.adoc:141
40291 msgid "*--boottime* _offset_"
40294 #. type: Plain text
40295 #: ../sys-utils/unshare.1.adoc:143
40297 "Set the offset of *CLOCK_BOOTTIME* which will be used in the entered time "
40298 "namespace. This option requires unsharing a time namespace with *--time*."
40301 #. type: Plain text
40302 #: ../sys-utils/unshare.1.adoc:149
40304 "The proc and sysfs filesystems mounting as root in a user namespace have to "
40305 "be restricted so that a less privileged user cannot get more access to "
40306 "sensitive files that a more privileged user made unavailable. In short the "
40307 "rule for proc and sysfs is as close to a bind mount as possible."
40310 #. type: Plain text
40311 #: ../sys-utils/unshare.1.adoc:153
40313 "The following command creates a PID namespace, using *--fork* to ensure that "
40314 "the executed command is performed in a child process that (being the first "
40315 "process in the namespace) has PID 1. The *--mount-proc* option ensures that "
40316 "a new mount namespace is also simultaneously created and that a new "
40317 "*proc*(5) filesystem is mounted that contains information corresponding to "
40318 "the new PID namespace. When the *readlink*(1) command terminates, the new "
40319 "namespaces are automatically torn down."
40322 #. type: delimited block .
40323 #: ../sys-utils/unshare.1.adoc:157
40326 "# unshare --fork --pid --mount-proc readlink /proc/self\n"
40330 #. type: Plain text
40331 #: ../sys-utils/unshare.1.adoc:160
40333 "As an unprivileged user, create a new user namespace where the user's "
40334 "credentials are mapped to the root IDs inside the namespace:"
40337 #. type: delimited block .
40338 #: ../sys-utils/unshare.1.adoc:170
40344 "$ unshare --user --map-root-user \\\n"
40345 " sh -c 'whoami; cat /proc/self/uid_map /proc/self/gid_map'\n"
40351 #. type: Plain text
40352 #: ../sys-utils/unshare.1.adoc:173
40354 "As an unprivileged user, create a user namespace where the first 65536 IDs "
40355 "are all mapped, and the user's credentials are mapped to the root IDs inside "
40356 "the namespace. The map is determined by the subordinate IDs assigned in "
40357 "*subuid*(5) and *subgid*(5). Demonstrate this mapping by creating a file "
40358 "with user ID 1 and group ID 1. For brevity, only the user ID mappings are "
40362 #. type: delimited block .
40363 #: ../sys-utils/unshare.1.adoc:191
40368 "$ cat /etc/subuid\n"
40369 "1000:100000:65536\n"
40370 "$ unshare --user --map-auto --map-root-user\n"
40373 "# cat /proc/self/uid_map\n"
40375 " 1 100000 65535\n"
40376 "# touch file; chown 1:1 file\n"
40377 "# ls -ln --time-style=+ file\n"
40378 "-rw-r--r-- 1 1 1 0 file\n"
40380 "$ ls -ln --time-style=+ file\n"
40381 "-rw-r--r-- 1 100000 100000 0 file\n"
40384 #. type: Plain text
40385 #: ../sys-utils/unshare.1.adoc:194
40387 "The first of the following commands creates a new persistent UTS namespace "
40388 "and modifies the hostname as seen in that namespace. The namespace is then "
40389 "entered with *nsenter*(1) in order to display the modified hostname; this "
40390 "step demonstrates that the UTS namespace continues to exist even though the "
40391 "namespace had no member processes after the *unshare* command terminated. "
40392 "The namespace is then destroyed by removing the bind mount."
40395 #. type: delimited block .
40396 #: ../sys-utils/unshare.1.adoc:201
40399 "# touch /root/uts-ns\n"
40400 "# unshare --uts=/root/uts-ns hostname FOO\n"
40401 "# nsenter --uts=/root/uts-ns hostname\n"
40403 "# umount /root/uts-ns\n"
40406 #. type: Plain text
40407 #: ../sys-utils/unshare.1.adoc:204
40409 "The following commands establish a persistent mount namespace referenced by "
40410 "the bind mount _/root/namespaces/mnt_. In order to ensure that the creation "
40411 "of that bind mount succeeds, the parent directory (_/root/namespaces_) is "
40412 "made a bind mount whose propagation type is not *shared*."
40415 #. type: delimited block .
40416 #: ../sys-utils/unshare.1.adoc:210
40419 "# mount --bind /root/namespaces /root/namespaces\n"
40420 "# mount --make-private /root/namespaces\n"
40421 "# touch /root/namespaces/mnt\n"
40422 "# unshare --mount=/root/namespaces/mnt\n"
40425 #. type: Plain text
40426 #: ../sys-utils/unshare.1.adoc:213
40428 "The following commands demonstrate the use of the *--kill-child* option when "
40429 "creating a PID namespace, in order to ensure that when *unshare* is killed, "
40430 "all of the processes within the PID namespace are killed."
40433 #. type: delimited block .
40434 #: ../sys-utils/unshare.1.adoc:216
40436 msgid "# set +m # Don't print job status messages\n"
40439 #. type: delimited block .
40440 #: ../sys-utils/unshare.1.adoc:224
40443 "# unshare --pid --fork --mount-proc --kill-child -- \\\n"
40444 " bash --norc -c '(sleep 555 &) && (ps a &) && sleep 999' &\n"
40446 "# PID TTY STAT TIME COMMAND\n"
40447 " 1 pts/3 S+ 0:00 sleep 999\n"
40448 " 3 pts/3 S+ 0:00 sleep 555\n"
40449 " 5 pts/3 R+ 0:00 ps a\n"
40452 #. type: delimited block .
40453 #: ../sys-utils/unshare.1.adoc:229
40456 "# ps h -o 'comm' $! # Show that background job is unshare(1)\n"
40458 "# kill $! # Kill unshare(1)\n"
40462 #. type: Plain text
40463 #: ../sys-utils/unshare.1.adoc:232
40465 "The *pidof*(1) command prints no output, because the *sleep* processes have "
40466 "been killed. More precisely, when the *sleep* process that has PID 1 in the "
40467 "namespace (i.e., the namespace's init process) was killed, this caused all "
40468 "other processes in the namespace to be killed. By contrast, a similar series "
40469 "of commands where the *--kill-child* option is not used shows that when "
40470 "*unshare* terminates, the processes in the PID namespace are not killed:"
40473 #. type: delimited block .
40474 #: ../sys-utils/unshare.1.adoc:241
40477 "# unshare --pid --fork --mount-proc -- \\\n"
40478 " bash --norc -c '(sleep 555 &) && (ps a &) && sleep 999' &\n"
40480 "# PID TTY STAT TIME COMMAND\n"
40481 " 1 pts/3 S+ 0:00 sleep 999\n"
40482 " 3 pts/3 S+ 0:00 sleep 555\n"
40483 " 5 pts/3 R+ 0:00 ps a\n"
40486 #. type: delimited block .
40487 #: ../sys-utils/unshare.1.adoc:245
40495 #. type: Plain text
40496 #: ../sys-utils/unshare.1.adoc:248
40498 "The following example demonstrates the creation of a time namespace where "
40499 "the boottime clock is set to a point several years in the past:"
40502 #. type: delimited block .
40503 #: ../sys-utils/unshare.1.adoc:254
40506 "# uptime -p # Show uptime in initial time namespace\n"
40507 "up 21 hours, 30 minutes\n"
40508 "# unshare --time --fork --boottime 300000000 uptime -p\n"
40509 "up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes\n"
40512 #. type: Plain text
40513 #: ../sys-utils/unshare.1.adoc:260
40515 "mailto:dottedmag@dottedmag.net[Mikhail Gusarov], mailto:kzak@redhat."
40519 #. type: Plain text
40520 #: ../sys-utils/unshare.1.adoc:269
40523 "*newuidmap*(1),\n"
40524 "*newgidmap*(1),\n"
40527 "*namespaces*(7),\n"
40532 #: ../sys-utils/wdctl.8.adoc:2
40537 #. type: Plain text
40538 #: ../sys-utils/wdctl.8.adoc:12
40539 msgid "wdctl - show hardware watchdog status"
40542 #. type: Plain text
40543 #: ../sys-utils/wdctl.8.adoc:16
40545 msgid "*wdctl* [options] [_device_...]\n"
40548 #. type: Plain text
40549 #: ../sys-utils/wdctl.8.adoc:20
40551 "Show hardware watchdog status. The default device is _/dev/watchdog_. If "
40552 "more than one device is specified then the output is separated by one blank "
40556 #. type: Plain text
40557 #: ../sys-utils/wdctl.8.adoc:22
40559 "If the device is already used or user has no permissions to read from the "
40560 "device, then *wdctl* reads data from sysfs. In this case information about "
40561 "supported features (flags) might be missing."
40564 #. type: Plain text
40565 #: ../sys-utils/wdctl.8.adoc:24
40567 "Note that the number of supported watchdog features is hardware specific."
40570 #. type: Labeled list
40571 #: ../sys-utils/wdctl.8.adoc:27
40573 #| msgid "*-f*, *--fast*"
40574 msgid "*-f*, *--flags* _list_"
40575 msgstr "*-f*, *--fast*"
40577 #. type: Plain text
40578 #: ../sys-utils/wdctl.8.adoc:29
40579 msgid "Print only the specified flags."
40582 #. type: Labeled list
40583 #: ../sys-utils/wdctl.8.adoc:30
40585 #| msgid "*-f*, *--fast*"
40586 msgid "*-F*, *--noflags*"
40587 msgstr "*-f*, *--fast*"
40589 #. type: Plain text
40590 #: ../sys-utils/wdctl.8.adoc:32
40591 msgid "Do not print information about flags."
40594 #. type: Labeled list
40595 #: ../sys-utils/wdctl.8.adoc:33
40597 #| msgid "*-P*, *--pty*"
40598 msgid "*-I*, *--noident*"
40599 msgstr "*-P*, *--pty*"
40601 #. type: Plain text
40602 #: ../sys-utils/wdctl.8.adoc:35
40603 msgid "Do not print watchdog identity information."
40606 #. type: Plain text
40607 #: ../sys-utils/wdctl.8.adoc:38
40608 msgid "Do not print a header line for flags table."
40611 #. type: Plain text
40612 #: ../sys-utils/wdctl.8.adoc:41
40614 "Define the output columns to use in table of watchdog flags. If no output "
40615 "arrangement is specified, then a default set is used. Use *--help* to get "
40616 "list of all supported columns."
40619 #. type: Labeled list
40620 #: ../sys-utils/wdctl.8.adoc:42
40622 #| msgid "*-h*, *--help*"
40623 msgid "*-O*, *--oneline*"
40624 msgstr "*-h*, *--help*"
40626 #. type: Plain text
40627 #: ../sys-utils/wdctl.8.adoc:44
40629 "Print all wanted information on one line in key=\"value\" output format."
40632 #. type: Labeled list
40633 #: ../sys-utils/wdctl.8.adoc:45
40635 msgid "*-p*, *--setpretimeout* _seconds_"
40638 #. type: Plain text
40639 #: ../sys-utils/wdctl.8.adoc:50
40641 "Set the watchdog pre-timeout in seconds. A watchdog pre-timeout is a "
40642 "notification generated by the watchdog before the watchdog reset might occur "
40643 "in the event the watchdog has not been serviced. This notification is "
40644 "handled by the kernel and can be configured to take an action using sysfs or "
40645 "by **--setpregovernor**."
40648 #. type: Labeled list
40649 #: ../sys-utils/wdctl.8.adoc:51
40651 msgid "*-g*, *--setpregovernor* _governor_"
40654 #. type: Plain text
40655 #: ../sys-utils/wdctl.8.adoc:53
40657 "Set pre-timeout governor name. For available governors see default **wdctl** "
40661 #. type: Labeled list
40662 #: ../sys-utils/wdctl.8.adoc:57
40664 msgid "*-s*, *--settimeout* _seconds_"
40667 #. type: Plain text
40668 #: ../sys-utils/wdctl.8.adoc:59
40669 msgid "Set the watchdog timeout in seconds."
40672 #. type: Labeled list
40673 #: ../sys-utils/wdctl.8.adoc:60
40675 #| msgid "*-P*, *--pty*"
40676 msgid "*-T*, *--notimeouts*"
40677 msgstr "*-P*, *--pty*"
40679 #. type: Plain text
40680 #: ../sys-utils/wdctl.8.adoc:62
40681 msgid "Do not print watchdog timeouts."
40684 #. type: Labeled list
40685 #: ../sys-utils/wdctl.8.adoc:63
40687 #| msgid "*-f*, *--fast*"
40688 msgid "*-x*, *--flags-only*"
40689 msgstr "*-f*, *--fast*"
40691 #. type: Plain text
40692 #: ../sys-utils/wdctl.8.adoc:65
40693 msgid "Same as *-I -T*."
40696 #. type: Plain text
40697 #: ../sys-utils/wdctl.8.adoc:72
40699 "mailto:kzak@redhat.com[Karel Zak], mailto:lennart@poettering.net[Lennart "
40704 #: ../sys-utils/zramctl.8.adoc:2
40709 #. type: Plain text
40710 #: ../sys-utils/zramctl.8.adoc:12
40711 msgid "zramctl - set up and control zram devices"
40714 #. type: Labeled list
40715 #: ../sys-utils/zramctl.8.adoc:15
40720 #. type: Plain text
40721 #: ../sys-utils/zramctl.8.adoc:18
40723 msgid "*zramctl* [options]\n"
40726 #. type: Labeled list
40727 #: ../sys-utils/zramctl.8.adoc:19
40729 msgid "Reset zram: "
40732 #. type: Plain text
40733 #: ../sys-utils/zramctl.8.adoc:22
40735 msgid "*zramctl* *-r* _zramdev_...\n"
40738 #. type: Labeled list
40739 #: ../sys-utils/zramctl.8.adoc:23
40741 msgid "Print name of first unused zram device: "
40744 #. type: Plain text
40745 #: ../sys-utils/zramctl.8.adoc:26
40747 msgid "*zramctl* *-f*\n"
40750 #. type: Labeled list
40751 #: ../sys-utils/zramctl.8.adoc:27
40753 msgid "Set up a zram device: "
40756 #. type: Plain text
40757 #: ../sys-utils/zramctl.8.adoc:30
40759 msgid "*zramctl* [*-f* | _zramdev_] [*-s* _size_] [*-t* _number_] [*-a* _algorithm_]\n"
40762 #. type: Plain text
40763 #: ../sys-utils/zramctl.8.adoc:34
40765 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"
40768 #. type: Plain text
40769 #: ../sys-utils/zramctl.8.adoc:36
40770 msgid "If no option is given, all non-zero size zram devices are shown."
40773 #. type: Plain text
40774 #: ../sys-utils/zramctl.8.adoc:38
40776 "Note that _zramdev_ node specified on command line has to already exist. The "
40777 "command *zramctl* creates a new _/dev/zram<N>_ nodes only when *--find* "
40778 "option specified. It's possible (and common) that after system boot _/dev/"
40779 "zram<N>_ nodes are not created yet."
40782 #. type: Labeled list
40783 #: ../sys-utils/zramctl.8.adoc:41
40785 msgid "*-a*, **--algorithm lzo**|**lz4**|**lz4hc**|**deflate**|**842**|**zstd**"
40788 #. type: Plain text
40789 #: ../sys-utils/zramctl.8.adoc:43
40791 "Set the compression algorithm to be used for compressing data in the zram "
40795 #. type: Plain text
40796 #: ../sys-utils/zramctl.8.adoc:45
40798 "The *list of supported algorithms could be inaccurate* as it depends on the "
40799 "current kernel configuration. A basic overview can be obtained by using the "
40800 "command \"cat /sys/block/zram0/comp_algorithm\"; however, please note that "
40801 "this list might also be incomplete. This is due to the fact that ZRAM "
40802 "utilizes the Crypto API, and if certain algorithms were built as modules, it "
40803 "becomes impossible to enumerate all of them."
40806 #. type: Labeled list
40807 #: ../sys-utils/zramctl.8.adoc:46
40809 #| msgid "*-f*, *--fast*"
40810 msgid "*-f*, *--find*"
40811 msgstr "*-f*, *--fast*"
40813 #. type: Plain text
40814 #: ../sys-utils/zramctl.8.adoc:48
40816 "Find the first unused zram device. If a *--size* argument is present, then "
40817 "initialize the device."
40820 #. type: Plain text
40821 #: ../sys-utils/zramctl.8.adoc:54
40823 "Define the status output columns to be used. If no output arrangement is "
40824 "specified, then a default set is used. Use *--help* to get a list of all "
40825 "supported columns."
40828 #. type: Plain text
40829 #: ../sys-utils/zramctl.8.adoc:60
40830 msgid "Use the raw format for status output."
40833 #. type: Plain text
40834 #: ../sys-utils/zramctl.8.adoc:63
40836 "Reset the options of the specified zram device(s). Zram device settings can "
40837 "be changed only after a reset."
40840 #. type: Plain text
40841 #: ../sys-utils/zramctl.8.adoc:66
40843 "Create a zram device of the specified _size_. Zram devices are aligned to "
40844 "memory pages; when the requested _size_ is not a multiple of the page size, "
40845 "it will be rounded up to the next multiple. When not otherwise specified, "
40846 "the unit of the _size_ parameter is bytes."
40849 #. type: Plain text
40850 #: ../sys-utils/zramctl.8.adoc:68
40852 "The _size_ argument may be followed by the multiplicative suffixes KiB "
40853 "(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
40854 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
40855 "suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and "
40859 #. type: Labeled list
40860 #: ../sys-utils/zramctl.8.adoc:69
40862 msgid "*-t*, *--streams* _number_"
40865 #. type: Plain text
40866 #: ../sys-utils/zramctl.8.adoc:71
40868 "Set the maximum number of compression streams that can be used for the "
40869 "device. The default is use all CPUs and one stream for kernels older than "
40873 #. type: Plain text
40874 #: ../sys-utils/zramctl.8.adoc:77
40876 msgid "*zramctl* returns 0 on success, nonzero on failure.\n"
40879 #. type: Labeled list
40880 #: ../sys-utils/zramctl.8.adoc:80
40882 msgid "_/dev/zram[0..N]_"
40885 #. type: Plain text
40886 #: ../sys-utils/zramctl.8.adoc:82
40887 msgid "zram block devices"
40890 #. type: Plain text
40891 #: ../sys-utils/zramctl.8.adoc:86
40893 "The following commands set up a zram device with a size of one gigabyte and "
40894 "use it as swap device."
40897 #. type: delimited block .
40898 #: ../sys-utils/zramctl.8.adoc:95
40901 " # zramctl --find --size 1024M\n"
40903 " # mkswap /dev/zram0\n"
40904 " # swapon /dev/zram0\n"
40906 " # swapoff /dev/zram0\n"
40907 " # zramctl --reset /dev/zram0\n"
40910 #. type: Plain text
40911 #: ../sys-utils/zramctl.8.adoc:101
40913 "mailto:nefelim4ag@gmail.com[Timofey Titovets], mailto:kzak@redhat.com[Karel "
40917 #. type: Plain text
40918 #: ../sys-utils/zramctl.8.adoc:105
40920 "link:https://docs.kernel.org/admin-guide/blockdev/zram.html[Linux kernel "
40925 #: ../term-utils/agetty.8.adoc:2
40930 #. type: Plain text
40931 #: ../term-utils/agetty.8.adoc:12
40932 msgid "agetty - alternative Linux getty"
40935 #. type: Plain text
40936 #: ../term-utils/agetty.8.adoc:16
40938 msgid "*agetty* [options] _port_ [_baud_rate_...] [_term_]\n"
40941 #. type: Plain text
40942 #: ../term-utils/agetty.8.adoc:20
40944 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"
40947 #. type: Plain text
40948 #: ../term-utils/agetty.8.adoc:22
40950 msgid "*agetty* has several _non-standard_ features that are useful for hardwired and for dial-in lines:\n"
40953 #. type: Plain text
40954 #: ../term-utils/agetty.8.adoc:24
40956 "Adapts the tty settings to parity bits and to erase, kill, end-of-line and "
40957 "uppercase characters when it reads a login name. The program can handle 7-"
40958 "bit characters with even, odd, none or space parity, and 8-bit characters "
40959 "with no parity. The following special characters are recognized: Control-U "
40960 "(kill); DEL and backspace (erase); carriage return and line feed (end of "
40961 "line). See also the *--erase-chars* and *--kill-chars* options."
40964 #. type: Plain text
40965 #: ../term-utils/agetty.8.adoc:25
40967 "Optionally deduces the baud rate from the CONNECT messages produced by "
40968 "Hayes(tm)-compatible modems."
40971 #. type: Plain text
40972 #: ../term-utils/agetty.8.adoc:26
40974 "Optionally does not hang up when it is given an already opened line (useful "
40975 "for call-back applications)."
40978 #. type: Plain text
40979 #: ../term-utils/agetty.8.adoc:27
40980 msgid "Optionally does not display the contents of the _/etc/issue_ file."
40983 #. type: Plain text
40984 #: ../term-utils/agetty.8.adoc:28
40986 "Optionally displays an alternative issue files or directories instead of _/"
40987 "etc/issue_ or _/etc/issue.d_."
40990 #. type: Plain text
40991 #: ../term-utils/agetty.8.adoc:29
40992 msgid "Optionally does not ask for a login name."
40995 #. type: Plain text
40996 #: ../term-utils/agetty.8.adoc:30
40998 "Optionally invokes a non-standard login program instead of _/bin/login_."
41001 #. type: Plain text
41002 #: ../term-utils/agetty.8.adoc:31
41003 msgid "Optionally turns on hardware flow control."
41006 #. type: Plain text
41007 #: ../term-utils/agetty.8.adoc:32
41008 msgid "Optionally forces the line to be local with no need for carrier detect."
41011 #. type: Plain text
41012 #: ../term-utils/agetty.8.adoc:34
41014 "This program does not use the _/etc/gettydefs_ (System V) or _/etc/gettytab_ "
41018 #. type: Labeled list
41019 #: ../term-utils/agetty.8.adoc:37
41024 #. type: Plain text
41025 #: ../term-utils/agetty.8.adoc:39
41027 "A path name relative to the _/dev_ directory. If a \"-\" is specified, "
41028 "*agetty* assumes that its standard input is already connected to a tty port "
41029 "and that a connection to a remote user has already been established."
41032 #. type: Plain text
41033 #: ../term-utils/agetty.8.adoc:41
41034 msgid "Under System V, a \"-\" _port_ argument should be preceded by a \"--\"."
41037 #. type: Labeled list
41038 #: ../term-utils/agetty.8.adoc:42
41040 msgid "_baud_rate_,..."
41043 #. type: Plain text
41044 #: ../term-utils/agetty.8.adoc:44
41046 "A comma-separated list of one or more baud rates. Each time *agetty* "
41047 "receives a BREAK character it advances through the list, which is treated as "
41048 "if it were circular."
41051 #. type: Plain text
41052 #: ../term-utils/agetty.8.adoc:46
41054 "Baud rates should be specified in descending order, so that the null "
41055 "character (Ctrl-@) can also be used for baud-rate switching."
41058 #. type: Plain text
41059 #: ../term-utils/agetty.8.adoc:48
41060 msgid "This argument is optional and unnecessary for *virtual terminals*."
41063 #. type: Plain text
41064 #: ../term-utils/agetty.8.adoc:50
41066 "The default for *serial terminals* is keep the current baud rate (see *--"
41067 "keep-baud*) and if unsuccessful then default to '9600'."
41070 #. type: Labeled list
41071 #: ../term-utils/agetty.8.adoc:51
41076 #. type: Plain text
41077 #: ../term-utils/agetty.8.adoc:53
41079 "The value to be used for the *TERM* environment variable. This overrides "
41080 "whatever *init*(1) may have set, and is inherited by login and the shell."
41083 #. type: Plain text
41084 #: ../term-utils/agetty.8.adoc:55
41086 "The default is 'vt100', or 'linux' for Linux on a virtual terminal, or "
41087 "'hurd' for GNU Hurd on a virtual terminal."
41090 #. type: Labeled list
41091 #: ../term-utils/agetty.8.adoc:58
41093 #| msgid "*-P*, *--pty*"
41094 msgid "*-8*, *--8bits*"
41095 msgstr "*-P*, *--pty*"
41097 #. type: Plain text
41098 #: ../term-utils/agetty.8.adoc:60
41099 msgid "Assume that the tty is 8-bit clean, hence disable parity detection."
41102 #. type: Labeled list
41103 #: ../term-utils/agetty.8.adoc:61
41105 msgid "*-a*, *--autologin* _username_"
41108 #. type: Plain text
41109 #: ../term-utils/agetty.8.adoc:63
41111 "Automatically log in the specified user without asking for a username or "
41112 "password. Using this option causes an *-f* _username_ option and argument to "
41113 "be added to the */bin/login* command line. See *--login-options*, which can "
41114 "be used to modify this option's behavior."
41117 #. type: Plain text
41118 #: ../term-utils/agetty.8.adoc:65
41120 "Note that *--autologin* may affect the way in which *getty* initializes the "
41121 "serial line, because on auto-login *agetty* does not read from the line and "
41122 "it has no opportunity optimize the line setting."
41125 #. type: Labeled list
41126 #: ../term-utils/agetty.8.adoc:66
41128 #| msgid "*-f*, *--fast*"
41129 msgid "*-c*, *--noreset*"
41130 msgstr "*-f*, *--fast*"
41132 #. type: Plain text
41133 #: ../term-utils/agetty.8.adoc:68
41135 "Do not reset terminal cflags (control modes). See *termios*(3) for more "
41139 #. type: Labeled list
41140 #: ../term-utils/agetty.8.adoc:69
41142 #| msgid "*-P*, *--pty*"
41143 msgid "*-E*, *--remote*"
41144 msgstr "*-P*, *--pty*"
41146 #. type: Plain text
41147 #: ../term-utils/agetty.8.adoc:71
41149 "Typically the *login*(1) command is given a remote hostname when called by "
41150 "something such as *telnetd*(8). This option allows *agetty* to pass what it "
41151 "is using for a hostname to *login*(1) for use in *utmp*(5). See *--host*, "
41152 "*login*(1), and *utmp*(5)."
41155 #. type: Plain text
41156 #: ../term-utils/agetty.8.adoc:73
41158 "If the *--host* _fakehost_ option is given, then an *-h* _fakehost_ option "
41159 "and argument are added to the _/bin/login_ command line."
41162 #. type: Plain text
41163 #: ../term-utils/agetty.8.adoc:75
41165 "If the *--nohostname* option is given, then an *-H* option is added to the */"
41166 "bin/login* command line."
41169 #. type: Plain text
41170 #: ../term-utils/agetty.8.adoc:77
41171 msgid "See *--login-options*."
41174 #. type: Labeled list
41175 #: ../term-utils/agetty.8.adoc:78
41177 msgid "*-f*, *--issue-file* _path_"
41180 #. type: Plain text
41181 #: ../term-utils/agetty.8.adoc:80
41183 "Specifies a \":\" delimited list of files and directories to be displayed "
41184 "instead of _/etc/issue_ (or other). All specified files and directories are "
41185 "displayed, missing or empty files are silently ignored. If the specified "
41186 "path is a directory then display all files with __.issue__ file extension in "
41187 "version-sort order from the directory. This allows custom messages to be "
41188 "displayed on different terminals. The *--noissue* option will override this "
41192 #. type: Labeled list
41193 #: ../term-utils/agetty.8.adoc:81
41195 msgid "*--show-issue*"
41198 #. type: Plain text
41199 #: ../term-utils/agetty.8.adoc:83
41201 "Display the current issue file (or other) on the current terminal and exit. "
41202 "Use this option to review the current setting, it is not designed for any "
41203 "other purpose. Note that output may use some default or incomplete "
41204 "information as proper output depends on terminal and *agetty* command line."
41207 #. type: Labeled list
41208 #: ../term-utils/agetty.8.adoc:84
41210 msgid "*-h, --flow-control*"
41213 #. type: Plain text
41214 #: ../term-utils/agetty.8.adoc:86
41216 "Enable hardware (RTS/CTS) flow control. It is left up to the application to "
41217 "disable software (XON/XOFF) flow protocol where appropriate."
41220 #. type: Labeled list
41221 #: ../term-utils/agetty.8.adoc:87
41223 #| msgid "*-f*, *--fast*"
41224 msgid "*-H*, *--host* _fakehost_"
41225 msgstr "*-f*, *--fast*"
41227 #. type: Plain text
41228 #: ../term-utils/agetty.8.adoc:89
41230 "Write the specified _fakehost_ into the utmp file. Normally, no login host "
41231 "is given, since *agetty* is used for local hardwired connections and "
41232 "consoles. However, this option can be useful for identifying terminal "
41233 "concentrators and the like."
41236 #. type: Labeled list
41237 #: ../term-utils/agetty.8.adoc:90
41239 #| msgid "*-h*, *--help*"
41240 msgid "*-i*, *--noissue*"
41241 msgstr "*-h*, *--help*"
41243 #. type: Plain text
41244 #: ../term-utils/agetty.8.adoc:92
41246 "Do not display the contents of _/etc/issue_ (or other) before writing the "
41247 "login prompt. Terminals or communications hardware may become confused when "
41248 "receiving lots of text at the wrong baud rate; dial-up scripts may fail if "
41249 "the login prompt is preceded by too much text."
41252 #. type: Labeled list
41253 #: ../term-utils/agetty.8.adoc:93
41255 msgid "*-I*, *--init-string* _initstring_"
41258 #. type: Plain text
41259 #: ../term-utils/agetty.8.adoc:95
41261 "Set an initial string to be sent to the tty or modem before sending anything "
41262 "else. This may be used to initialize a modem. Non-printable characters may "
41263 "be sent by writing their octal code preceded by a backslash (\\). For "
41264 "example, to send a linefeed character (ASCII 10, octal 012), write \\12."
41267 #. type: Labeled list
41268 #: ../term-utils/agetty.8.adoc:96
41270 #| msgid "*-V*, *--version*"
41271 msgid "*-J*, *--noclear*"
41272 msgstr "*-V*, *--version*"
41274 #. type: Plain text
41275 #: ../term-utils/agetty.8.adoc:98
41277 "Do not clear the screen before prompting for the login name. By default the "
41278 "screen is cleared."
41281 #. type: Labeled list
41282 #: ../term-utils/agetty.8.adoc:99
41284 msgid "*-l*, *--login-program* _login_program_"
41287 #. type: Plain text
41288 #: ../term-utils/agetty.8.adoc:101
41290 "Invoke the specified _login_program_ instead of /bin/login. This allows the "
41291 "use of a non-standard login program. Such a program could, for example, ask "
41292 "for a dial-up password or use a different password file. See *--login-"
41296 #. type: Labeled list
41297 #: ../term-utils/agetty.8.adoc:102
41299 #| msgid "*-c*, **--command**=__command__"
41300 msgid "*-L*, *--local-line*[=__mode__]"
41301 msgstr "*-c*, **--command**=__příkaz__"
41303 #. type: Plain text
41304 #: ../term-utils/agetty.8.adoc:104
41306 "Control the CLOCAL line flag. The optional _mode_ argument is *auto*, "
41307 "*always* or *never*. If the _mode_ argument is omitted, then the default is "
41308 "*always*. If the *--local-line* option is not given at all, then the default "
41312 #. type: Labeled list
41313 #: ../term-utils/agetty.8.adoc:105
41318 #. type: Plain text
41319 #: ../term-utils/agetty.8.adoc:107
41321 "Forces the line to be a local line with no need for carrier detect. This can "
41322 "be useful when you have a locally attached terminal where the serial line "
41323 "does not set the carrier-detect signal."
41326 #. type: Labeled list
41327 #: ../term-utils/agetty.8.adoc:107
41332 #. type: Plain text
41333 #: ../term-utils/agetty.8.adoc:109
41335 "Explicitly clears the CLOCAL flag from the line setting and the carrier-"
41336 "detect signal is expected on the line."
41339 #. type: Labeled list
41340 #: ../term-utils/agetty.8.adoc:109
41345 #. type: Plain text
41346 #: ../term-utils/agetty.8.adoc:111
41348 "The *agetty* default. Does not modify the CLOCAL setting and follows the "
41349 "setting enabled by the kernel."
41352 #. type: Labeled list
41353 #: ../term-utils/agetty.8.adoc:112
41355 #| msgid "*-f*, *--fast*"
41356 msgid "*-m*, *--extract-baud*"
41357 msgstr "*-f*, *--fast*"
41359 #. type: Plain text
41360 #: ../term-utils/agetty.8.adoc:114
41362 "Try to extract the baud rate from the CONNECT status message produced by "
41363 "Hayes(tm)-compatible modems. These status messages are of the form: "
41364 "\"<junk><speed><junk>\". *agetty* assumes that the modem emits its status "
41365 "message at the same speed as specified with (the first) _baud_rate_ value on "
41366 "the command line."
41369 #. type: Plain text
41370 #: ../term-utils/agetty.8.adoc:116
41372 "Since the *--extract-baud* feature may fail on heavily-loaded systems, you "
41373 "still should enable BREAK processing by enumerating all expected baud rates "
41374 "on the command line."
41377 #. type: Labeled list
41378 #: ../term-utils/agetty.8.adoc:117
41380 msgid "*--list-speeds*"
41383 #. type: Plain text
41384 #: ../term-utils/agetty.8.adoc:119
41385 msgid "Display supported baud rates. These are determined at compilation time."
41388 #. type: Labeled list
41389 #: ../term-utils/agetty.8.adoc:120
41391 #| msgid "*-*, *-l*, *--login*"
41392 msgid "*-n*, *--skip-login*"
41393 msgstr "*-*, *-l*, *--login*"
41395 #. type: Plain text
41396 #: ../term-utils/agetty.8.adoc:122
41398 "Do not prompt the user for a login name. This can be used in connection with "
41399 "the *--login-program* option to invoke a non-standard login process such as "
41400 "a BBS system. Note that with the *--skip-login* option, *agetty* gets no "
41401 "input from the user who logs in and therefore will not be able to figure out "
41402 "parity, character size, and newline processing of the connection. It "
41403 "defaults to space parity, 7 bit characters, and ASCII CR (13) end-of-line "
41404 "character. Beware that the program that *agetty* starts (usually /bin/login) "
41408 #. type: Labeled list
41409 #: ../term-utils/agetty.8.adoc:123
41411 #| msgid "*-h*, *--help*"
41412 msgid "*-N*, *--nonewline*"
41413 msgstr "*-h*, *--help*"
41415 #. type: Plain text
41416 #: ../term-utils/agetty.8.adoc:125
41417 msgid "Do not print a newline before writing out _/etc/issue_."
41420 #. type: Labeled list
41421 #: ../term-utils/agetty.8.adoc:126
41423 msgid "*-o*, *--login-options* _login_options_"
41426 #. type: Plain text
41427 #: ../term-utils/agetty.8.adoc:128
41429 "Options and arguments that are passed to *login*(1). Where \\u is replaced "
41430 "by the login name. For example:"
41433 #. type: Plain text
41434 #: ../term-utils/agetty.8.adoc:130
41436 msgid "*--login-options '-h darkstar \\-- \\u'*\n"
41439 #. type: Plain text
41440 #: ../term-utils/agetty.8.adoc:132
41441 msgid "See *--autologin*, *--login-program* and *--remote*."
41444 #. type: Plain text
41445 #: ../term-utils/agetty.8.adoc:134
41446 msgid "Please read the *SECURITY NOTICE* below before using this option."
41449 #. type: Labeled list
41450 #: ../term-utils/agetty.8.adoc:135
41452 #| msgid "*-*, *-l*, *--login*"
41453 msgid "*-p*, *--login-pause*"
41454 msgstr "*-*, *-l*, *--login*"
41456 #. type: Plain text
41457 #: ../term-utils/agetty.8.adoc:137
41459 "Wait for any key before dropping to the login prompt. Can be combined with "
41460 "*--autologin* to save memory by lazily spawning shells."
41463 #. type: Labeled list
41464 #: ../term-utils/agetty.8.adoc:138
41466 msgid "*-r*, *--chroot* _directory_"
41469 #. type: Plain text
41470 #: ../term-utils/agetty.8.adoc:140
41472 #| msgid "changes to the target user's home directory"
41473 msgid "Change root to the specified directory."
41474 msgstr "přejde do domovského adresáře cílového uživatele"
41476 #. type: Labeled list
41477 #: ../term-utils/agetty.8.adoc:141
41479 #| msgid "*-h*, *--help*"
41480 msgid "*-R*, *--hangup*"
41481 msgstr "*-h*, *--help*"
41483 #. type: Plain text
41484 #: ../term-utils/agetty.8.adoc:143
41485 msgid "Call *vhangup*(2) to do a virtual hangup of the specified terminal."
41488 #. type: Labeled list
41489 #: ../term-utils/agetty.8.adoc:144
41491 #| msgid "*-h*, *--help*"
41492 msgid "*-s*, *--keep-baud*"
41493 msgstr "*-h*, *--help*"
41495 #. type: Plain text
41496 #: ../term-utils/agetty.8.adoc:146
41498 "Try to keep the existing baud rate. The baud rates from the command line are "
41499 "used when *agetty* receives a BREAK character. If another baud rates "
41500 "specified then the original baud rate is also saved to the end of the wanted "
41501 "baud rates list. This can be used to return to the original baud rate after "
41502 "unexpected BREAKs."
41505 #. type: Labeled list
41506 #: ../term-utils/agetty.8.adoc:147 ../term-utils/wall.1.adoc:65
41508 msgid "*-t*, *--timeout* _timeout_"
41511 #. type: Plain text
41512 #: ../term-utils/agetty.8.adoc:149
41514 "Terminate if no user name could be read within _timeout_ seconds. Use of "
41515 "this option with hardwired terminal lines is not recommended."
41518 #. type: Labeled list
41519 #: ../term-utils/agetty.8.adoc:150
41521 #| msgid "*-f*, *--fast*"
41522 msgid "*-U*, *--detect-case*"
41523 msgstr "*-f*, *--fast*"
41525 #. type: Plain text
41526 #: ../term-utils/agetty.8.adoc:152
41528 "Turn on support for detecting an uppercase-only terminal. This setting will "
41529 "detect a login name containing only capitals as indicating an uppercase-only "
41530 "terminal and turn on some upper-to-lower case conversions. Note that this "
41531 "has no support for any Unicode characters."
41534 #. type: Labeled list
41535 #: ../term-utils/agetty.8.adoc:153
41537 #| msgid "*-f*, *--fast*"
41538 msgid "*-w*, *--wait-cr*"
41539 msgstr "*-f*, *--fast*"
41541 #. type: Plain text
41542 #: ../term-utils/agetty.8.adoc:155
41544 "Wait for the user or the modem to send a carriage-return or a linefeed "
41545 "character before sending the _/etc/issue_ file (or others) and the login "
41546 "prompt. This is useful with the *--init-string* option."
41549 #. type: Labeled list
41550 #: ../term-utils/agetty.8.adoc:156
41552 msgid "*--nohints*"
41555 #. type: Plain text
41556 #: ../term-utils/agetty.8.adoc:158
41557 msgid "Do not print hints about Num, Caps and Scroll Locks."
41560 #. type: Labeled list
41561 #: ../term-utils/agetty.8.adoc:159
41563 msgid "*--nohostname*"
41566 #. type: Plain text
41567 #: ../term-utils/agetty.8.adoc:161
41569 "By default the hostname will be printed. With this option enabled, no "
41570 "hostname at all will be shown. This setting is also possible to able by "
41571 "LOGIN_PLAIN_PROMPT option in the _/etc/login.defs_ configuration file (see "
41572 "below for more details)."
41575 #. type: Labeled list
41576 #: ../term-utils/agetty.8.adoc:162
41578 msgid "*--long-hostname*"
41581 #. type: Plain text
41582 #: ../term-utils/agetty.8.adoc:164
41584 "By default the hostname is only printed until the first dot. With this "
41585 "option enabled, the fully qualified hostname by *gethostname*(3P) or (if not "
41586 "found) by *getaddrinfo*(3) is shown."
41589 #. type: Labeled list
41590 #: ../term-utils/agetty.8.adoc:165
41592 msgid "*--erase-chars* _string_"
41595 #. type: Plain text
41596 #: ../term-utils/agetty.8.adoc:167
41598 "This option specifies additional characters that should be interpreted as a "
41599 "backspace (\"ignore the previous character\") when the user types the login "
41600 "name. The default additional 'erase' has been '#', but since util-linux 2.23 "
41601 "no additional erase characters are enabled by default."
41604 #. type: Labeled list
41605 #: ../term-utils/agetty.8.adoc:168
41607 msgid "*--kill-chars* _string_"
41610 #. type: Plain text
41611 #: ../term-utils/agetty.8.adoc:170
41613 "This option specifies additional characters that should be interpreted as a "
41614 "kill (\"ignore all previous characters\") when the user types the login "
41615 "name. The default additional 'kill' has been '@', but since util-linux 2.23 "
41616 "no additional kill characters are enabled by default."
41619 #. type: Labeled list
41620 #: ../term-utils/agetty.8.adoc:171
41622 msgid "*--chdir* _directory_"
41625 #. type: Plain text
41626 #: ../term-utils/agetty.8.adoc:173
41627 msgid "Change directory before the login."
41630 #. type: Labeled list
41631 #: ../term-utils/agetty.8.adoc:174
41633 msgid "*--delay* _number_"
41636 #. type: Plain text
41637 #: ../term-utils/agetty.8.adoc:176
41638 msgid "Sleep seconds before open tty."
41641 #. type: Labeled list
41642 #: ../term-utils/agetty.8.adoc:177
41644 msgid "*--nice* _number_"
41647 #. type: Plain text
41648 #: ../term-utils/agetty.8.adoc:179
41649 msgid "Run login with this priority."
41652 #. type: Labeled list
41653 #: ../term-utils/agetty.8.adoc:180
41658 #. type: Plain text
41659 #: ../term-utils/agetty.8.adoc:182
41661 "Ask all running *agetty* instances to reload and update their displayed "
41662 "prompts, if the user has not yet commenced logging in. After doing so the "
41663 "command will exit. This feature might be unsupported on systems without "
41664 "Linux *inotify*(7)."
41667 #. type: Plain text
41668 #: ../term-utils/agetty.8.adoc:189
41670 #| msgid "*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration files. The following configuration items are relevant for *su*{colon}\n"
41672 "*agetty* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)).\n"
41673 "Note that the configuration file could be distributed with another package (usually shadow-utils).\n"
41674 "The following configuration items are relevant for *agetty*:\n"
41675 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"
41677 #. type: Plain text
41678 #: ../term-utils/agetty.8.adoc:193
41680 "Tell *agetty* that printing the hostname should be suppressed in the login: "
41681 "prompt. This is an alternative to the *--nohostname* command line option. "
41682 "The default value is _no_."
41685 #. type: Plain text
41686 #: ../term-utils/agetty.8.adoc:197
41688 "This section shows examples for the process field of an entry in the _/etc/"
41689 "inittab_ file. You'll have to prepend appropriate values for the other "
41690 "fields. See *inittab*(5) for more details."
41693 #. type: Plain text
41694 #: ../term-utils/agetty.8.adoc:199
41695 msgid "For a hardwired line or a console tty:"
41698 #. type: delimited block _
41699 #: ../term-utils/agetty.8.adoc:202
41701 msgid "*/sbin/agetty 9600 ttyS1*\n"
41704 #. type: Plain text
41705 #: ../term-utils/agetty.8.adoc:205
41707 "For a directly connected terminal without proper carrier-detect wiring (try "
41708 "this if your terminal just sleeps instead of giving you a password: prompt):"
41711 #. type: delimited block _
41712 #: ../term-utils/agetty.8.adoc:208
41714 msgid "*/sbin/agetty --local-line 9600 ttyS1 vt100*\n"
41717 #. type: Plain text
41718 #: ../term-utils/agetty.8.adoc:211
41719 msgid "For an old-style dial-in line with a 9600/2400/1200 baud modem:"
41722 #. type: delimited block _
41723 #: ../term-utils/agetty.8.adoc:214
41725 msgid "*/sbin/agetty --extract-baud --timeout 60 ttyS1 9600,2400,1200*\n"
41728 #. type: Plain text
41729 #: ../term-utils/agetty.8.adoc:217
41731 "For a Hayes modem with a fixed 115200 bps interface to the machine (the "
41732 "example init string turns off modem echo and result codes, makes modem/"
41733 "computer DCD track modem/modem DCD, makes a DTR drop cause a disconnection, "
41734 "and turns on auto-answer after 1 ring):"
41737 #. type: delimited block _
41738 #: ../term-utils/agetty.8.adoc:220
41740 msgid "*/sbin/agetty --wait-cr --init-string 'ATE0Q1&D2&C1S0=1\\015' 115200 ttyS1*\n"
41744 #: ../term-utils/agetty.8.adoc:222
41746 msgid "SECURITY NOTICE"
41749 #. type: Plain text
41750 #: ../term-utils/agetty.8.adoc:225
41752 "If you use the *--login-program* and *--login-options* options, be aware "
41753 "that a malicious user may try to enter lognames with embedded options, which "
41754 "then get passed to the used login program. *agetty* does check for a leading "
41755 "\"-\" and makes sure the logname gets passed as one parameter (so embedded "
41756 "spaces will not create yet another parameter), but depending on how the "
41757 "login binary parses the command line that might not be sufficient. Check "
41758 "that the used login program cannot be abused this way."
41761 #. type: Plain text
41762 #: ../term-utils/agetty.8.adoc:227
41764 "Some programs use \"--\" to indicate that the rest of the command line "
41765 "should not be interpreted as options. Use this feature if available by "
41766 "passing \"--\" before the username gets passed by \\u."
41770 #: ../term-utils/agetty.8.adoc:228
41773 msgid "ISSUE FILES"
41776 #. type: Plain text
41777 #: ../term-utils/agetty.8.adoc:231
41779 "The default issue file is _/etc/issue_. If the file exists, then *agetty* "
41780 "also checks for _/etc/issue.d_ directory. The directory is optional "
41781 "extension to the default issue file and content of the directory is printed "
41782 "after _/etc/issue_ content. If the _/etc/issue_ does not exist, then the "
41783 "directory is ignored. All files *with .issue extension* from the directory "
41784 "are printed in version-sort order. The directory can be used to maintain 3rd-"
41785 "party messages independently on the primary system _/etc/issue_ file."
41788 #. type: Plain text
41789 #: ../term-utils/agetty.8.adoc:233
41791 "Since version 2.35 additional locations for issue file and directory are "
41792 "supported. If the default _/etc/issue_ does not exist, then *agetty* checks "
41793 "for _/run/issue_ and _/run/issue.d_, thereafter for _/usr/lib/issue_ and _/"
41794 "usr/lib/issue.d_. The directory _/etc_ is expected for host specific "
41795 "configuration, _/run_ is expected for generated stuff and _/usr/lib_ for "
41796 "static distribution maintained configuration."
41799 #. type: Plain text
41800 #: ../term-utils/agetty.8.adoc:235
41802 "The default path maybe overridden by *--issue-file* option. In this case "
41803 "specified path has to be file or directory and all the default issue file "
41804 "and directory locations are ignored."
41807 #. type: Plain text
41808 #: ../term-utils/agetty.8.adoc:237
41810 "The issue file feature can be completely disabled by *--noissue* option."
41813 #. type: Plain text
41814 #: ../term-utils/agetty.8.adoc:239
41816 "It is possible to review the current issue file by *agetty --show-issue* on "
41817 "the current terminal."
41820 #. type: Plain text
41821 #: ../term-utils/agetty.8.adoc:241
41823 "The issue files may contain certain escape codes to display the system name, "
41824 "date, time et cetera. All escape codes consist of a backslash (\\) "
41825 "immediately followed by one of the characters listed below."
41828 #. type: Labeled list
41829 #: ../term-utils/agetty.8.adoc:242
41831 msgid "4 or 4{_interface_}"
41834 #. type: Plain text
41835 #: ../term-utils/agetty.8.adoc:244
41837 "Insert the IPv4 address of the specified network interface (for example: "
41838 "\\4\\{eth0}). If the _interface_ argument is not specified, then select the "
41839 "first fully configured (UP, non-LOCALBACK, RUNNING) interface. If no "
41840 "configured interface is found, fall back to the IP address of the machine's "
41844 #. type: Labeled list
41845 #: ../term-utils/agetty.8.adoc:245
41847 msgid "6 or 6{_interface_}"
41850 #. type: Plain text
41851 #: ../term-utils/agetty.8.adoc:247
41852 msgid "The same as \\4 but for IPv6."
41855 #. type: Labeled list
41856 #: ../term-utils/agetty.8.adoc:248
41861 #. type: Plain text
41862 #: ../term-utils/agetty.8.adoc:250
41863 msgid "Insert the baudrate of the current line."
41866 #. type: Labeled list
41867 #: ../term-utils/agetty.8.adoc:251
41872 #. type: Plain text
41873 #: ../term-utils/agetty.8.adoc:253
41874 msgid "Insert the current date."
41877 #. type: Labeled list
41878 #: ../term-utils/agetty.8.adoc:254
41880 msgid "e or e{_name_}"
41883 #. type: Plain text
41884 #: ../term-utils/agetty.8.adoc:256
41886 "Translate the human-readable _name_ to an escape sequence and insert it (for "
41887 "example: \\e{red}Alert text.\\e{reset}). If the _name_ argument is not "
41888 "specified, then insert \\033. The currently supported names are: black, "
41889 "blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
41890 "lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
41891 "magenta, red, reset, reverse, yellow and white. All unknown names are "
41892 "silently ignored."
41895 #. type: Labeled list
41896 #: ../term-utils/agetty.8.adoc:257
41901 #. type: Plain text
41902 #: ../term-utils/agetty.8.adoc:259
41904 "Insert the system name (the name of the operating system). Same as 'uname -"
41905 "s'. See also the \\S escape code."
41908 #. type: Labeled list
41909 #: ../term-utils/agetty.8.adoc:260
41911 msgid "S or S{VARIABLE}"
41914 #. type: Plain text
41915 #: ../term-utils/agetty.8.adoc:262
41917 "Insert the VARIABLE data from _/etc/os-release_. If this file does not exist "
41918 "then fall back to _/usr/lib/os-release_. If the VARIABLE argument is not "
41919 "specified, then use PRETTY_NAME from the file or the system name (see \\s). "
41920 "This escape code can be used to keep _/etc/issue_ distribution and release "
41921 "independent. Note that \\S{ANSI_COLOR} is converted to the real terminal "
41925 #. type: Labeled list
41926 #: ../term-utils/agetty.8.adoc:263
41931 #. type: Plain text
41932 #: ../term-utils/agetty.8.adoc:265
41933 msgid "Insert the name of the current tty line."
41936 #. type: Labeled list
41937 #: ../term-utils/agetty.8.adoc:266
41942 #. type: Plain text
41943 #: ../term-utils/agetty.8.adoc:268
41944 msgid "Insert the architecture identifier of the machine. Same as *uname -m*."
41947 #. type: Labeled list
41948 #: ../term-utils/agetty.8.adoc:269
41953 #. type: Plain text
41954 #: ../term-utils/agetty.8.adoc:271
41956 "Insert the nodename of the machine, also known as the hostname. Same as "
41960 #. type: Labeled list
41961 #: ../term-utils/agetty.8.adoc:272
41966 #. type: Plain text
41967 #: ../term-utils/agetty.8.adoc:274
41968 msgid "Insert the NIS domainname of the machine. Same as *hostname -d*."
41971 #. type: Labeled list
41972 #: ../term-utils/agetty.8.adoc:275
41977 #. type: Plain text
41978 #: ../term-utils/agetty.8.adoc:277
41979 msgid "Insert the DNS domainname of the machine."
41982 #. type: Labeled list
41983 #: ../term-utils/agetty.8.adoc:278
41988 #. type: Plain text
41989 #: ../term-utils/agetty.8.adoc:280
41990 msgid "Insert the release number of the OS. Same as *uname -r*."
41993 #. type: Labeled list
41994 #: ../term-utils/agetty.8.adoc:281
41999 #. type: Plain text
42000 #: ../term-utils/agetty.8.adoc:283
42001 msgid "Insert the current time."
42004 #. type: Labeled list
42005 #: ../term-utils/agetty.8.adoc:284
42010 #. type: Plain text
42011 #: ../term-utils/agetty.8.adoc:286
42012 msgid "Insert the number of current users logged in."
42015 #. type: Labeled list
42016 #: ../term-utils/agetty.8.adoc:287
42021 #. type: Plain text
42022 #: ../term-utils/agetty.8.adoc:289
42024 "Insert the string \"1 user\" or \"<n> users\" where <n> is the number of "
42025 "current users logged in."
42028 #. type: Labeled list
42029 #: ../term-utils/agetty.8.adoc:290
42034 #. type: Plain text
42035 #: ../term-utils/agetty.8.adoc:292
42036 msgid "Insert the version of the OS, that is, the build-date and such."
42039 #. type: Plain text
42040 #: ../term-utils/agetty.8.adoc:294
42041 msgid "An example. On my system, the following _/etc/issue_ file:"
42044 #. type: delimited block .
42045 #: ../term-utils/agetty.8.adoc:297
42047 msgid "This is \\n.\\o (\\s \\m \\r) \\t\n"
42050 #. type: Plain text
42051 #: ../term-utils/agetty.8.adoc:300
42052 msgid "displays as:"
42055 #. type: delimited block .
42056 #: ../term-utils/agetty.8.adoc:303
42058 msgid "This is thingol.orcan.dk (Linux i386 1.1.9) 18:29:30\n"
42061 #. type: Labeled list
42062 #: ../term-utils/agetty.8.adoc:307
42064 msgid "_/var/run/utmp_"
42067 #. type: Plain text
42068 #: ../term-utils/agetty.8.adoc:309
42069 msgid "the system status file."
42072 #. type: Labeled list
42073 #: ../term-utils/agetty.8.adoc:310
42075 #| msgid "_/etc/pam.d/su_"
42076 msgid "_/etc/issue_"
42077 msgstr "_/etc/pam.d/su_"
42079 #. type: Plain text
42080 #: ../term-utils/agetty.8.adoc:312
42081 msgid "printed before the login prompt."
42084 #. type: Labeled list
42085 #: ../term-utils/agetty.8.adoc:313
42087 msgid "_/etc/os-release /usr/lib/os-release_"
42090 #. type: Plain text
42091 #: ../term-utils/agetty.8.adoc:315
42092 msgid "operating system identification data."
42095 #. type: Labeled list
42096 #: ../term-utils/agetty.8.adoc:316
42098 msgid "_/dev/console_"
42101 #. type: Plain text
42102 #: ../term-utils/agetty.8.adoc:318
42103 msgid "problem reports (if *syslog*(3) is not used)."
42106 #. type: Labeled list
42107 #: ../term-utils/agetty.8.adoc:319
42109 #| msgid "_/etc/fstab_"
42110 msgid "_/etc/inittab_"
42111 msgstr "_/etc/fstab_"
42113 #. type: Plain text
42114 #: ../term-utils/agetty.8.adoc:321
42116 msgid "*init*(8) configuration file for SysV-style init daemon.\n"
42119 #. type: Plain text
42120 #: ../term-utils/agetty.8.adoc:325
42122 msgid "*agetty* supports configuration via systemd credentials (see https://systemd.io/CREDENTIALS/). *agetty* reads the following systemd credentials:\n"
42125 #. type: Labeled list
42126 #: ../term-utils/agetty.8.adoc:326
42128 msgid "*agetty.autologin* (string)"
42131 #. type: Plain text
42132 #: ../term-utils/agetty.8.adoc:329
42134 "If set, configures *agetty* to automatically log in the specified user "
42135 "without asking for a username or password, similarly to the *--autologin* "
42139 #. type: Plain text
42140 #: ../term-utils/agetty.8.adoc:333
42142 "The baud-rate detection feature (the *--extract-baud* option) requires that "
42143 "*agetty* be scheduled soon enough after completion of a dial-in call (within "
42144 "30 ms with modems that talk at 2400 baud). For robustness, always use the *--"
42145 "extract-baud* option in combination with a multiple baud rate command-line "
42146 "argument, so that BREAK processing is enabled."
42149 #. type: Plain text
42150 #: ../term-utils/agetty.8.adoc:335
42152 "The text in the _/etc/issue_ file (or other) and the login prompt are always "
42153 "output with 7-bit characters and space parity."
42156 #. type: Plain text
42157 #: ../term-utils/agetty.8.adoc:337
42159 "The baud-rate detection feature (the *--extract-baud* option) requires that "
42160 "the modem emits its status message _after_ raising the DCD line."
42163 #. type: Plain text
42164 #: ../term-utils/agetty.8.adoc:341
42166 "Depending on how the program was configured, all diagnostics are written to "
42167 "the console device or reported via the *syslog*(3) facility. Error messages "
42168 "are produced if the _port_ argument does not specify a terminal device; if "
42169 "there is no utmp entry for the current process (System V only); and so on."
42172 #. type: Plain text
42173 #: ../term-utils/agetty.8.adoc:346
42174 msgid "mailto:werner@suse.de[Werner Fink], mailto:kzak@redhat.com[Karel Zak]"
42177 #. type: Plain text
42178 #: ../term-utils/agetty.8.adoc:348
42180 "The original *agetty* for serial terminals was written by mailto:wietse@wzv."
42181 "win.tue.nl[W.Z. Venema] and ported to Linux by mailto:poe@daimi.aau.dk[Peter "
42188 #. Copyright (c) 1987, 1990, 1993
42189 #. The Regents of the University of California. All rights reserved.
42190 #. Redistribution and use in source and binary forms, with or without
42191 #. modification, are permitted provided that the following conditions
42193 #. 1. Redistributions of source code must retain the above copyright
42194 #. notice, this list of conditions and the following disclaimer.
42195 #. 2. Redistributions in binary form must reproduce the above copyright
42196 #. notice, this list of conditions and the following disclaimer in the
42197 #. documentation and/or other materials provided with the distribution.
42198 #. 3. All advertising materials mentioning features or use of this software
42199 #. must display the following acknowledgement:
42200 #. This product includes software developed by the University of
42201 #. California, Berkeley and its contributors.
42202 #. 4. Neither the name of the University nor the names of its contributors
42203 #. may be used to endorse or promote products derived from this software
42204 #. without specific prior written permission.
42205 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
42206 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42207 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
42208 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
42209 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
42210 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
42211 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
42212 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
42213 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
42214 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
42216 #. @(#)mesg.1 8.1 (Berkeley) 6/6/93
42218 #: ../term-utils/mesg.1.adoc:36
42223 #. type: Plain text
42224 #: ../term-utils/mesg.1.adoc:46
42225 msgid "mesg - display (or do not display) messages from other users"
42228 #. type: Plain text
42229 #: ../term-utils/mesg.1.adoc:50
42231 msgid "*mesg* [_option_] [*n*|*y*]\n"
42234 #. type: Plain text
42235 #: ../term-utils/mesg.1.adoc:54
42237 "The *mesg* utility is invoked by a user to control write access others have "
42238 "to the terminal device associated with standard error output. If write "
42239 "access is allowed, then programs such as *talk*(1) and *write*(1) may "
42240 "display messages on the terminal."
42243 #. type: Plain text
42244 #: ../term-utils/mesg.1.adoc:56
42246 "Traditionally, write access is allowed by default. However, as users become "
42247 "more conscious of various security risks, there is a trend to remove write "
42248 "access by default, at least for the primary login shell. To make sure your "
42249 "ttys are set the way you want them to be set, *mesg* should be executed in "
42250 "your login scripts."
42253 #. type: Plain text
42254 #: ../term-utils/mesg.1.adoc:58
42256 "The *mesg* utility silently exits with error status 2 if not executed on a "
42257 "terminal. In this case executing *mesg* is pointless. The command line "
42258 "option *--verbose* forces *mesg* to print a warning in this situation. This "
42259 "behaviour has been introduced in version 2.33."
42262 #. type: Plain text
42263 #: ../term-utils/mesg.1.adoc:63
42264 msgid "Disallow messages."
42267 #. type: Labeled list
42268 #: ../term-utils/mesg.1.adoc:64
42273 #. type: Plain text
42274 #: ../term-utils/mesg.1.adoc:66
42275 msgid "Allow messages to be displayed."
42278 #. type: Plain text
42279 #: ../term-utils/mesg.1.adoc:68
42281 "If no arguments are given, *mesg* shows the current message status on "
42282 "standard error output."
42285 #. type: Plain text
42286 #: ../term-utils/mesg.1.adoc:79
42287 msgid "The *mesg* utility exits with one of the following values:"
42290 #. type: Plain text
42291 #: ../term-utils/mesg.1.adoc:82
42292 msgid "Messages are allowed."
42295 #. type: Plain text
42296 #: ../term-utils/mesg.1.adoc:84
42297 msgid "Messages are not allowed."
42300 #. type: Labeled list
42301 #: ../term-utils/mesg.1.adoc:84
42306 #. type: Plain text
42307 #: ../term-utils/mesg.1.adoc:86
42308 msgid "An error has occurred."
42311 #. type: Plain text
42312 #: ../term-utils/mesg.1.adoc:90
42313 msgid "_/dev/[pt]ty*_, _/dev/pts/[0-9]*_"
42316 #. type: Plain text
42317 #: ../term-utils/mesg.1.adoc:95
42320 "*mesg* (I) appears in the UNIX Programmer's Manual.\n"
42321 "It used to invert the current state with no argument before Version 7 AT&T UNIX.\n"
42324 #. type: Plain text
42325 #: ../term-utils/mesg.1.adoc:103
42338 #. Copyright (c) 1980, 1990 Regents of the University of California.
42339 #. All rights reserved.
42340 #. Redistribution and use in source and binary forms, with or without
42341 #. modification, are permitted provided that the following conditions
42343 #. 1. Redistributions of source code must retain the above copyright
42344 #. notice, this list of conditions and the following disclaimer.
42345 #. 2. Redistributions in binary form must reproduce the above copyright
42346 #. notice, this list of conditions and the following disclaimer in the
42347 #. documentation and/or other materials provided with the distribution.
42348 #. 3. All advertising materials mentioning features or use of this software
42349 #. must display the following acknowledgement:
42350 #. This product includes software developed by the University of
42351 #. California, Berkeley and its contributors.
42352 #. 4. Neither the name of the University nor the names of its contributors
42353 #. may be used to endorse or promote products derived from this software
42354 #. without specific prior written permission.
42355 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
42356 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42357 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
42358 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
42359 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
42360 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
42361 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
42362 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
42363 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
42364 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
42366 #. @(#)script.1 6.5 (Berkeley) 7/27/91
42368 #: ../term-utils/script.1.adoc:36
42373 #. type: Plain text
42374 #: ../term-utils/script.1.adoc:47
42375 msgid "script - make typescript of terminal session"
42378 #. type: Plain text
42379 #: ../term-utils/script.1.adoc:51
42381 msgid "*script* [options] [_file_]\n"
42384 #. type: Plain text
42385 #: ../term-utils/script.1.adoc:55
42387 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"
42390 #. type: Plain text
42391 #: ../term-utils/script.1.adoc:57
42393 "Since version 2.35, *script* supports multiple streams and allows the "
42394 "logging of input and output to separate files or all the one file. This "
42395 "version also supports a new timing file which records additional "
42396 "information. The command *scriptreplay --summary* then provides all the "
42400 #. type: Plain text
42401 #: ../term-utils/script.1.adoc:59
42403 "If the argument _file_ or option *--log-out* _file_ is given, *script* saves "
42404 "the dialogue in this _file_. If no filename is given, the dialogue is saved "
42405 "in the file _typescript_."
42408 #. type: Plain text
42409 #: ../term-utils/script.1.adoc:61
42411 "Note that logging input using *--log-in* or *--log-io* may record security-"
42412 "sensitive information as the log file contains all terminal session input (e."
42413 "g., passwords) independently of the terminal echo flag setting."
42416 #. type: Plain text
42417 #: ../term-utils/script.1.adoc:65
42419 "Below, the _size_ argument may be followed by the multiplicative suffixes "
42420 "KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
42421 "(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
42422 "the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
42426 #. type: Plain text
42427 #: ../term-utils/script.1.adoc:68
42429 "Append the output to _file_ or to _typescript_, retaining the prior contents."
42432 #. type: Plain text
42433 #: ../term-utils/script.1.adoc:71
42435 "Run the _command_ rather than an interactive shell. This makes it easy for a "
42436 "script to capture the output of a program that behaves differently when its "
42437 "stdout is not a tty."
42440 #. type: Labeled list
42441 #: ../term-utils/script.1.adoc:72
42443 msgid "*-E*, *--echo* _when_"
42446 #. type: Plain text
42447 #: ../term-utils/script.1.adoc:74
42449 "This option controls the *ECHO* flag for the slave end of the session's "
42450 "pseudoterminal. The supported modes are _always_, _never_, or _auto_."
42453 #. type: Plain text
42454 #: ../term-utils/script.1.adoc:76
42456 "The default is _auto_ -- in this case, *ECHO* enabled for the pseudoterminal "
42457 "slave; if the current standard input is a terminal, *ECHO* is disabled for "
42458 "it to prevent double echo; if the current standard input is not a terminal "
42459 "(for example pipe: *echo date | script*) then keeping *ECHO* enabled for the "
42460 "pseudoterminal slave enables the standard input data to be viewed on screen "
42461 "while being recorded to session log simultaneously."
42464 #. type: Plain text
42465 #: ../term-utils/script.1.adoc:78
42467 "Note that 'never' mode affects content of the session output log, because "
42468 "users input is not repeated on output."
42471 #. type: Labeled list
42472 #: ../term-utils/script.1.adoc:79
42474 #| msgid "*-V*, *--version*"
42475 msgid "*-e*, *--return*"
42476 msgstr "*-V*, *--version*"
42478 #. TRANSLATORS: Keep {plus} untranslated.
42479 #. type: Plain text
42480 #: ../term-utils/script.1.adoc:81
42482 "Return the exit status of the child process. Uses the same format as bash "
42483 "termination on signal termination (i.e., exit status is 128 {plus} the "
42484 "signal number). The exit status of the child process is always stored in the "
42485 "type script file too."
42488 #. type: Labeled list
42489 #: ../term-utils/script.1.adoc:83
42491 #| msgid "*-f*, *--fast*"
42492 msgid "*-f*, *--flush*"
42493 msgstr "*-f*, *--fast*"
42495 #. type: Plain text
42496 #: ../term-utils/script.1.adoc:85
42498 "Flush output after each write. This is nice for telecooperation: one person "
42499 "does *mkfifo* _foo_; *script -f* _foo_, and another can supervise in real-"
42500 "time what is being done using *cat* _foo_. Note that flush has an impact on "
42501 "performance; it's possible to use *SIGUSR1* to flush logs on demand."
42504 #. type: Labeled list
42505 #: ../term-utils/script.1.adoc:86
42510 #. type: Plain text
42511 #: ../term-utils/script.1.adoc:88
42513 "Allow the default output file _typescript_ to be a hard or symbolic link. "
42514 "The command will follow a symbolic link."
42517 #. type: Labeled list
42518 #: ../term-utils/script.1.adoc:89 ../term-utils/scriptlive.1.adoc:33
42519 #: ../term-utils/scriptreplay.1.adoc:38
42521 #| msgid "*-*, *-l*, *--login*"
42522 msgid "*-B*, *--log-io* _file_"
42523 msgstr "*-*, *-l*, *--login*"
42525 #. type: Plain text
42526 #: ../term-utils/script.1.adoc:91
42528 "Log input and output to the same _file_. Note, this option makes sense only "
42529 "if *--log-timing* is also specified, otherwise it's impossible to separate "
42530 "output and input streams from the log _file_."
42533 #. type: Labeled list
42534 #: ../term-utils/script.1.adoc:92 ../term-utils/scriptlive.1.adoc:30
42535 #: ../term-utils/scriptreplay.1.adoc:32
42537 #| msgid "*-*, *-l*, *--login*"
42538 msgid "*-I*, *--log-in* _file_"
42539 msgstr "*-*, *-l*, *--login*"
42541 #. type: Plain text
42542 #: ../term-utils/script.1.adoc:94
42544 "Log input to the _file_. The log output is disabled if only *--log-in* "
42548 #. type: Plain text
42549 #: ../term-utils/script.1.adoc:96
42551 "Use this logging functionality carefully as it logs all input, including "
42552 "input when terminal has disabled echo flag (for example, password inputs)."
42555 #. type: Labeled list
42556 #: ../term-utils/script.1.adoc:97 ../term-utils/scriptreplay.1.adoc:35
42558 msgid "*-O*, *--log-out* _file_"
42561 #. type: Plain text
42562 #: ../term-utils/script.1.adoc:99
42564 "Log output to the _file_. The default is to log output to the file with name "
42565 "_typescript_ if the option *--log-out* or *--log-in* is not given. The log "
42566 "output is disabled if only *--log-in* specified."
42569 #. type: Labeled list
42570 #: ../term-utils/script.1.adoc:100 ../term-utils/scriptlive.1.adoc:39
42571 #: ../term-utils/scriptreplay.1.adoc:44
42573 msgid "*-T*, *--log-timing* _file_"
42576 #. type: Plain text
42577 #: ../term-utils/script.1.adoc:102
42579 "Log timing information to the _file_. Two timing file formats are supported "
42580 "now. The classic format is used when only one stream (input or output) "
42581 "logging is enabled. The multi-stream format is used on *--log-io* or when *--"
42582 "log-in* and *--log-out* are used together. See also *--logging-format*."
42585 #. type: Labeled list
42586 #: ../term-utils/script.1.adoc:103
42588 msgid "*-m*, *--logging-format* _format_"
42591 #. type: Plain text
42592 #: ../term-utils/script.1.adoc:105
42594 "Force use of _advanced_ or _classic_ timing log format. The default is the "
42595 "classic format to log only output and the advanced format when input as well "
42596 "as output logging is requested."
42599 #. type: Labeled list
42600 #: ../term-utils/script.1.adoc:106
42602 msgid "*Classic format*"
42605 #. type: Plain text
42606 #: ../term-utils/script.1.adoc:108
42608 "The timing log contains two fields, separated by a space. The first field "
42609 "indicates how much time elapsed since the previous output. The second field "
42610 "indicates how many characters were output this time."
42613 #. type: Labeled list
42614 #: ../term-utils/script.1.adoc:109
42616 msgid "*Advanced (multi-stream) format*"
42619 #. type: Plain text
42620 #: ../term-utils/script.1.adoc:111
42622 "The first field is an entry type identifier ('I'nput, 'O'utput, 'H'eader, "
42623 "'S'ignal). The second field is how much time elapsed since the previous "
42624 "entry, and the rest of the entry is type-specific data."
42627 #. type: Labeled list
42628 #: ../term-utils/script.1.adoc:112
42630 msgid "*-o*, *--output-limit* _size_"
42633 #. type: Plain text
42634 #: ../term-utils/script.1.adoc:114
42636 "Limit the size of the typescript and timing files to _size_ and stop the "
42637 "child process after this size is exceeded. The calculated file size does not "
42638 "include the start and done messages that the *script* command prepends and "
42639 "appends to the child process output. Due to buffering, the resulting output "
42640 "file might be larger than the specified value."
42643 #. type: Plain text
42644 #: ../term-utils/script.1.adoc:117
42645 msgid "Be quiet (do not write start and done messages to standard output)."
42648 #. type: Labeled list
42649 #: ../term-utils/script.1.adoc:118
42651 msgid "*-t*[_file_], *--timing*[=_file_]"
42654 #. type: Plain text
42655 #: ../term-utils/script.1.adoc:120
42657 "Output timing data to standard error, or to _file_ when given. This option "
42658 "is deprecated in favour of *--log-timing* where the _file_ argument is not "
42662 #. type: Plain text
42663 #: ../term-utils/script.1.adoc:126
42665 "Upon receiving *SIGUSR1*, *script* immediately flushes the output files."
42668 #. type: Plain text
42669 #: ../term-utils/script.1.adoc:130
42670 msgid "The following environment variable is utilized by *script*:"
42673 #. type: Labeled list
42674 #: ../term-utils/script.1.adoc:131 ../text-utils/more.1.adoc:171
42675 #: ../text-utils/pg.1.adoc:130
42680 #. type: Plain text
42681 #: ../term-utils/script.1.adoc:133
42683 "If the variable *SHELL* exists, the shell forked by *script* will be that "
42684 "shell. If *SHELL* is not set, the Bourne shell is assumed. (Most shells set "
42685 "this variable automatically)."
42688 #. type: Plain text
42689 #: ../term-utils/script.1.adoc:137
42691 "The script ends when the forked shell exits (a _control-D_ for the Bourne "
42692 "shell (*sh*(1p)), and _exit_, _logout_ or _control-d_ (if _ignoreeof_ is not "
42693 "set) for the C-shell, *csh*(1))."
42696 #. type: Plain text
42697 #: ../term-utils/script.1.adoc:139
42699 "Certain interactive commands, such as *vi*(1), create garbage in the "
42700 "typescript file. *script* works best with commands that do not manipulate "
42701 "the screen, the results are meant to emulate a hardcopy terminal."
42704 #. type: Plain text
42705 #: ../term-utils/script.1.adoc:141
42707 "It is not recommended to run *script* in non-interactive shells. The inner "
42708 "shell of *script* is always interactive, and this could lead to unexpected "
42709 "results. If you use *script* in the shell initialization file, you have to "
42710 "avoid entering an infinite loop. You can use for example the *.profile* "
42711 "file, which is read by login shells only:"
42714 #. type: delimited block .
42715 #: ../term-utils/script.1.adoc:147
42718 "if test -t 0 ; then\n"
42724 #. type: Plain text
42725 #: ../term-utils/script.1.adoc:150
42727 "You should also avoid use of *script* in command pipes, as *script* can read "
42728 "more input than you would expect."
42731 #. type: Plain text
42732 #: ../term-utils/script.1.adoc:154
42734 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
42735 msgid "The *script* command appeared in 3.0BSD."
42736 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
42738 #. type: Plain text
42739 #: ../term-utils/script.1.adoc:158
42741 msgid "*script* places _everything_ in the log file, including linefeeds and backspaces. This is not what the naive user expects.\n"
42744 #. type: Plain text
42745 #: ../term-utils/script.1.adoc:160
42747 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"
42750 #. type: Plain text
42751 #: ../term-utils/script.1.adoc:166
42754 "*csh*(1) (for the _history_ mechanism),\n"
42755 "*scriptreplay*(1),\n"
42756 "*scriptlive*(1)\n"
42764 #: ../term-utils/scriptlive.1.adoc:2
42766 #| msgid "write(1)"
42767 msgid "scriptlive(1)"
42770 #. type: Plain text
42771 #: ../term-utils/scriptlive.1.adoc:13
42772 msgid "scriptlive - re-run session typescripts, using timing information"
42775 #. type: Plain text
42776 #: ../term-utils/scriptlive.1.adoc:17
42778 msgid "*scriptlive* [options] [*-t*] _timingfile_ [*-I*|*-B*] _typescript_\n"
42781 #. type: Plain text
42782 #: ../term-utils/scriptlive.1.adoc:21
42784 "This program re-runs a typescript, using stdin typescript and timing "
42785 "information to ensure that input happens in the same rhythm as it originally "
42786 "appeared when the script was recorded."
42789 #. type: Plain text
42790 #: ../term-utils/scriptlive.1.adoc:23
42792 "The *session is executed* in a newly created pseudoterminal with the user's "
42793 "$SHELL (or defaults to _/bin/bash_)."
42796 #. type: Plain text
42797 #: ../term-utils/scriptlive.1.adoc:25
42799 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"
42802 #. type: Plain text
42803 #: ../term-utils/scriptlive.1.adoc:27
42805 "The timing information is what *script*(1) outputs to file specified by *--"
42806 "log-timing*. The typescript has to contain stdin information and it is what "
42807 "script1 outputs to file specified by *--log-in* or *--log-io*."
42810 #. type: Plain text
42811 #: ../term-utils/scriptlive.1.adoc:32 ../term-utils/scriptreplay.1.adoc:34
42812 msgid "File containing *script*'s terminal input."
42815 #. type: Plain text
42816 #: ../term-utils/scriptlive.1.adoc:35 ../term-utils/scriptreplay.1.adoc:40
42817 msgid "File containing *script*'s terminal output and input."
42820 #. type: Labeled list
42821 #: ../term-utils/scriptlive.1.adoc:36 ../term-utils/scriptreplay.1.adoc:41
42823 msgid "*-t*, *--timing* _file_"
42826 #. type: Plain text
42827 #: ../term-utils/scriptlive.1.adoc:38 ../term-utils/scriptreplay.1.adoc:43
42829 "File containing *script*'s timing output. This option overrides old-style "
42833 #. type: Plain text
42834 #: ../term-utils/scriptlive.1.adoc:41
42836 "Aliased to *-t*, maintained for compatibility with *script*(1) command-line "
42840 #. type: Plain text
42841 #: ../term-utils/scriptlive.1.adoc:44 ../term-utils/scriptreplay.1.adoc:55
42843 "Speed up the replay displaying this _number_ of times. The argument is a "
42844 "floating-point number. It's called divisor because it divides the timings by "
42845 "this factor. This option overrides old-style arguments."
42848 #. type: Labeled list
42849 #: ../term-utils/scriptlive.1.adoc:45 ../term-utils/scriptreplay.1.adoc:56
42851 msgid "*-m*, *--maxdelay* _number_"
42854 #. type: Plain text
42855 #: ../term-utils/scriptlive.1.adoc:47 ../term-utils/scriptreplay.1.adoc:58
42857 "Set the maximum delay between updates to _number_ of seconds. The argument "
42858 "is a floating-point number. This can be used to avoid long pauses in the "
42859 "typescript replay."
42862 #. type: delimited block .
42863 #: ../term-utils/scriptlive.1.adoc:60
42866 "% script --log-timing file.tm --log-in script.in\n"
42867 "Script started, file is script.out\n"
42871 "Script done, file is script.out\n"
42872 "% scriptlive --log-timing file.tm --log-in script.in\n"
42875 #. TRANSLATORS: Keep {copyright} untranslated.
42876 #. type: Plain text
42877 #: ../term-utils/scriptlive.1.adoc:70
42878 msgid "Copyright {copyright} 2019 Karel Zak"
42881 #. type: Plain text
42882 #: ../term-utils/scriptlive.1.adoc:72 ../term-utils/scriptreplay.1.adoc:92
42884 "This is free software; see the source for copying conditions. There is NO "
42885 "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
42888 #. type: Plain text
42889 #: ../term-utils/scriptlive.1.adoc:74 ../term-utils/scriptreplay.1.adoc:94
42890 msgid "Released under the GNU General Public License version 2 or later."
42893 #. type: Plain text
42894 #: ../term-utils/scriptlive.1.adoc:79
42898 "*scriptreplay*(1)\n"
42902 #: ../term-utils/scriptreplay.1.adoc:2
42904 msgid "scriptreplay(1)"
42907 #. type: Plain text
42908 #: ../term-utils/scriptreplay.1.adoc:13
42909 msgid "scriptreplay - play back typescripts, using timing information"
42912 #. type: Plain text
42913 #: ../term-utils/scriptreplay.1.adoc:17
42915 msgid "*scriptreplay* [options] [*-t*] _timingfile_ [_typescript_ [_divisor_]]\n"
42918 #. type: Plain text
42919 #: ../term-utils/scriptreplay.1.adoc:21
42921 "This program replays a typescript, using timing information to ensure that "
42922 "output happens in the same rhythm as it originally appeared when the script "
42926 #. type: Plain text
42927 #: ../term-utils/scriptreplay.1.adoc:23
42929 "The replay simply displays the information again; the programs that were run "
42930 "when the typescript was being recorded are *not run again*. Since the same "
42931 "information is simply being displayed, *scriptreplay* is only guaranteed to "
42932 "work properly if run on the same type of terminal the typescript was "
42933 "recorded on. Otherwise, any escape characters in the typescript may be "
42934 "interpreted differently by the terminal to which *scriptreplay* is sending "
42938 #. type: Plain text
42939 #: ../term-utils/scriptreplay.1.adoc:25
42941 "The timing information is what *script*(1) outputs to file specified by *--"
42945 #. type: Plain text
42946 #: ../term-utils/scriptreplay.1.adoc:27
42948 "By default, the typescript to display is assumed to be named _typescript_, "
42949 "but other filenames may be specified, as the second parameter or with option "
42953 #. type: Plain text
42954 #: ../term-utils/scriptreplay.1.adoc:29
42956 "If the third parameter or *--divisor* is specified, it is used as a speed-up "
42957 "multiplier. For example, a speed-up of 2 makes *scriptreplay* go twice as "
42958 "fast, and a speed-down of 0.1 makes it go ten times slower than the original "
42962 #. type: Plain text
42963 #: ../term-utils/scriptreplay.1.adoc:37
42964 msgid "File containing *script*'s terminal output."
42967 #. type: Plain text
42968 #: ../term-utils/scriptreplay.1.adoc:46
42970 "This is an alias for *-t*, maintained for compatibility with *script*(1) "
42971 "command-line options."
42974 #. type: Labeled list
42975 #: ../term-utils/scriptreplay.1.adoc:47
42977 msgid "*-s*, *--typescript* _file_"
42980 #. type: Plain text
42981 #: ../term-utils/scriptreplay.1.adoc:49
42983 "File containing *script*'s terminal output. Deprecated alias to *--log-out*. "
42984 "This option overrides old-style arguments."
42987 #. type: Labeled list
42988 #: ../term-utils/scriptreplay.1.adoc:50
42990 #| msgid "*-c*, **--command**=__command__"
42991 msgid "*-c*, *--cr-mode* _mode_"
42992 msgstr "*-c*, **--command**=__příkaz__"
42994 #. type: Plain text
42995 #: ../term-utils/scriptreplay.1.adoc:52
42997 "Specifies how to use the CR (0x0D, carriage return) character from log "
42998 "files. The default mode is _auto_, in this case CR is replaced with line "
42999 "break for stdin log, because otherwise *scriptreplay* would overwrite the "
43000 "same line. The other modes are _never_ and _always_."
43003 #. type: Labeled list
43004 #: ../term-utils/scriptreplay.1.adoc:59
43006 msgid "*--summary*"
43009 #. type: Plain text
43010 #: ../term-utils/scriptreplay.1.adoc:61
43012 "Display details about the session recorded in the specified timing file and "
43013 "exit. The session has to be recorded using _advanced_ format (see "
43014 "*script*(1) option *--logging-format* for more details)."
43017 #. type: Labeled list
43018 #: ../term-utils/scriptreplay.1.adoc:62
43020 msgid "*-x*, *--stream* _type_"
43023 #. type: Plain text
43024 #: ../term-utils/scriptreplay.1.adoc:64
43026 "Forces *scriptreplay* to print only the specified stream. The supported "
43027 "stream types are _in_, _out_, _signal_, or _info_. This option is "
43028 "recommended for multi-stream logs (e.g., *--log-io*) in order to print only "
43032 #. type: delimited block .
43033 #: ../term-utils/scriptreplay.1.adoc:77
43036 "% script --log-timing file.tm --log-out script.out\n"
43037 "Script started, file is script.out\n"
43041 "Script done, file is script.out\n"
43042 "% scriptreplay --log-timing file.tm --log-out script.out\n"
43045 #. type: Plain text
43046 #: ../term-utils/scriptreplay.1.adoc:82
43048 "The original *scriptreplay* program was written by mailto:joey@kitenet."
43049 "net[Joey Hess]. The program was re-written in C by mailto:jay@gnu.org[James "
43050 "Youngman] and mailto:kzak@redhat.com[Karel Zak]"
43053 #. TRANSLATORS: Keep {copyright} untranslated.
43054 #. type: Plain text
43055 #: ../term-utils/scriptreplay.1.adoc:87
43056 msgid "Copyright {copyright} 2008 James Youngman"
43059 #. TRANSLATORS: Keep {copyright} untranslated.
43060 #. type: Plain text
43061 #: ../term-utils/scriptreplay.1.adoc:90
43062 msgid "Copyright {copyright} 2008-2019 Karel Zak"
43065 #. type: Plain text
43066 #: ../term-utils/scriptreplay.1.adoc:99
43070 "*scriptlive*(1)\n"
43073 #. Copyright 1990 Gordon Irlam (gordoni@cs.ua.oz.au)
43074 #. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
43075 #. Copyright 2000 Colin Watson (cjw44@cam.ac.uk)
43076 #. Do not restrict distribution.
43077 #. May be distributed under the GNU General Public License
43079 #: ../term-utils/setterm.1.adoc:9
43084 #. type: Plain text
43085 #: ../term-utils/setterm.1.adoc:19
43086 msgid "setterm - set terminal attributes"
43089 #. type: Plain text
43090 #: ../term-utils/setterm.1.adoc:23
43092 msgid "*setterm* [options]\n"
43095 #. type: Plain text
43096 #: ../term-utils/setterm.1.adoc:27
43098 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"
43101 #. type: Plain text
43102 #: ../term-utils/setterm.1.adoc:31
43103 msgid "For boolean options (*on* or *off*), the default is *on*."
43106 #. type: Plain text
43107 #: ../term-utils/setterm.1.adoc:33
43109 "Below, an _8-color_ can be *black*, *red*, *green*, *yellow*, *blue*, "
43110 "*magenta*, *cyan*, or *white*."
43113 #. type: Plain text
43114 #: ../term-utils/setterm.1.adoc:35
43116 "A _16-color_ can be an _8-color_, or *grey*, or *bright* followed by *red*, "
43117 "*green*, *yellow*, *blue*, *magenta*, *cyan*, or *white*."
43120 #. type: Plain text
43121 #: ../term-utils/setterm.1.adoc:37
43123 "The various color options may be set independently, at least on virtual "
43124 "consoles, though the results of setting multiple modes (for example, *--"
43125 "underline* and *--half-bright*) are hardware-dependent."
43128 #. type: Plain text
43129 #: ../term-utils/setterm.1.adoc:39
43131 "The optional arguments are recommended with '=' (equals sign) and not space "
43132 "between the option and the argument. For example --option=argument. "
43133 "*setterm* can interpret the next non-option argument as an optional argument "
43137 #. type: Labeled list
43138 #: ../term-utils/setterm.1.adoc:40
43140 msgid "*--appcursorkeys* on|off"
43143 #. type: Plain text
43144 #: ../term-utils/setterm.1.adoc:42
43146 "Sets Cursor Key Application Mode on or off. When on, ESC O A, ESC O B, etc. "
43147 "will be sent for the cursor keys instead of ESC [ A, ESC [ B, etc. See the "
43148 "_vi and Cursor-Keys_ section of the _Text-Terminal-HOWTO_ for how this can "
43149 "cause problems for *vi* users. Virtual consoles only."
43152 #. type: Labeled list
43153 #: ../term-utils/setterm.1.adoc:43
43155 msgid "*--append* _console_number_"
43158 #. type: Plain text
43159 #: ../term-utils/setterm.1.adoc:45
43161 "Like *--dump*, but appends to the snapshot file instead of overwriting it. "
43162 "Only works if no *--dump* options are given."
43165 #. type: Labeled list
43166 #: ../term-utils/setterm.1.adoc:46
43168 msgid "*--background* __8-color__|default"
43171 #. type: Plain text
43172 #: ../term-utils/setterm.1.adoc:48
43173 msgid "Sets the background text color."
43176 #. type: Labeled list
43177 #: ../term-utils/setterm.1.adoc:49
43179 msgid "*--blank*[=0-60|force|poke]"
43182 #. type: Plain text
43183 #: ../term-utils/setterm.1.adoc:51
43185 "Sets the interval of inactivity, in minutes, after which the screen will be "
43186 "automatically blanked (using APM if available). Without an argument, it gets "
43187 "the blank status (returns which vt was blanked, or zero for an unblanked "
43188 "vt). Virtual consoles only."
43191 #. type: Plain text
43192 #: ../term-utils/setterm.1.adoc:53
43193 msgid "The *force* argument keeps the screen blank even if a key is pressed."
43196 #. type: Plain text
43197 #: ../term-utils/setterm.1.adoc:55
43198 msgid "The *poke* argument unblanks the screen."
43201 #. type: Labeled list
43202 #: ../term-utils/setterm.1.adoc:56
43204 msgid "*--bfreq*[=_number_]"
43207 #. type: Plain text
43208 #: ../term-utils/setterm.1.adoc:58
43210 "Sets the bell frequency in Hertz. Without an argument, it defaults to *0*. "
43211 "Virtual consoles only."
43214 #. type: Labeled list
43215 #: ../term-utils/setterm.1.adoc:59
43217 msgid "*--blength*[=0-2000]"
43220 #. type: Plain text
43221 #: ../term-utils/setterm.1.adoc:61
43223 "Sets the bell duration in milliseconds. Without an argument, it defaults to "
43224 "*0*. Virtual consoles only."
43227 #. type: Labeled list
43228 #: ../term-utils/setterm.1.adoc:62
43230 msgid "*--blink* on|off"
43233 #. type: Plain text
43234 #: ../term-utils/setterm.1.adoc:64
43236 "Turns blink mode on or off. Except on a virtual console, *--blink off* turns "
43237 "off all attributes (bold, half-brightness, blink, reverse)."
43240 #. type: Labeled list
43241 #: ../term-utils/setterm.1.adoc:65
43243 msgid "*--bold* on|off"
43246 #. type: Plain text
43247 #: ../term-utils/setterm.1.adoc:67
43249 "urns bold (extra bright) mode on or off. Except on a virtual console, *--"
43250 "bold off* turns off all attributes (bold, half-brightness, blink, reverse)."
43253 #. type: Labeled list
43254 #: ../term-utils/setterm.1.adoc:68
43256 msgid "*--clear*[=all|rest]"
43259 #. type: Plain text
43260 #: ../term-utils/setterm.1.adoc:70
43262 "Without an argument or with the argument *all*, the entire screen is cleared "
43263 "and the cursor is set to the home position, just like *clear*(1) does. With "
43264 "the argument *rest*, the screen is cleared from the current cursor position "
43268 #. type: Labeled list
43269 #: ../term-utils/setterm.1.adoc:71
43271 msgid "*--clrtabs*[=_tab1 tab2 tab3_ ...]"
43274 #. type: Plain text
43275 #: ../term-utils/setterm.1.adoc:73
43277 "Clears tab stops from the given horizontal cursor positions, in the range "
43278 "*1-160*. Without arguments, it clears all tab stops. Virtual consoles only."
43281 #. type: Labeled list
43282 #: ../term-utils/setterm.1.adoc:74
43284 msgid "*--cursor* on|off"
43287 #. type: Plain text
43288 #: ../term-utils/setterm.1.adoc:76
43289 msgid "Turns the terminal's cursor on or off."
43292 #. type: Labeled list
43293 #: ../term-utils/setterm.1.adoc:77
43295 #| msgid "*defaults*"
43296 msgid "*--default*"
43297 msgstr "*defaults*"
43299 #. type: Plain text
43300 #: ../term-utils/setterm.1.adoc:79
43301 msgid "Sets the terminal's rendering options to the default values."
43304 #. type: Labeled list
43305 #: ../term-utils/setterm.1.adoc:80
43307 msgid "*--dump*[=_console_number_]"
43310 #. type: Plain text
43311 #: ../term-utils/setterm.1.adoc:82
43313 "Writes a snapshot of the virtual console with the given number to the file "
43314 "specified with the *--file* option, overwriting its contents; the default is "
43315 "_screen.dump_. Without an argument, it dumps the current virtual console. "
43316 "This overrides *--append*."
43319 #. type: Labeled list
43320 #: ../term-utils/setterm.1.adoc:83
43322 msgid "*--file* _filename_"
43325 #. type: Plain text
43326 #: ../term-utils/setterm.1.adoc:85
43328 "Sets the snapshot file name for any *--dump* or *--append* options on the "
43329 "same command line. If this option is not present, the default is _screen."
43330 "dump_ in the current directory. A path name that exceeds the system maximum "
43331 "will be truncated, see *PATH_MAX* from _linux/limits.h_ for the value."
43334 #. type: Labeled list
43335 #: ../term-utils/setterm.1.adoc:86
43337 msgid "*--foreground* __8-color__|default"
43340 #. type: Plain text
43341 #: ../term-utils/setterm.1.adoc:88
43342 msgid "Sets the foreground text color."
43345 #. type: Labeled list
43346 #: ../term-utils/setterm.1.adoc:89
43348 msgid "*--half-bright* on|off"
43351 #. type: Plain text
43352 #: ../term-utils/setterm.1.adoc:91
43354 "Turns dim (half-brightness) mode on or off. Except on a virtual console, *--"
43355 "half-bright off* turns off all attributes (bold, half-brightness, blink, "
43359 #. type: Labeled list
43360 #: ../term-utils/setterm.1.adoc:92
43362 msgid "*--hbcolor* _16-color_"
43365 #. type: Plain text
43366 #: ../term-utils/setterm.1.adoc:94
43367 msgid "Sets the color for half-bright characters."
43370 #. type: Labeled list
43371 #: ../term-utils/setterm.1.adoc:95
43373 msgid "*--initialize*"
43376 #. type: Plain text
43377 #: ../term-utils/setterm.1.adoc:97
43379 "Displays the terminal initialization string, which typically sets the "
43380 "terminal's rendering options, and other attributes to the default values."
43383 #. type: Labeled list
43384 #: ../term-utils/setterm.1.adoc:98
43386 msgid "*--inversescreen* on|off"
43389 #. type: Plain text
43390 #: ../term-utils/setterm.1.adoc:100
43391 msgid "Swaps foreground and background colors for the whole screen."
43394 #. type: Labeled list
43395 #: ../term-utils/setterm.1.adoc:101
43397 msgid "*--linewrap* on|off"
43400 #. type: Plain text
43401 #: ../term-utils/setterm.1.adoc:103
43402 msgid "Makes the terminal continue on a new line when a line is full."
43405 #. type: Labeled list
43406 #: ../term-utils/setterm.1.adoc:104
43408 msgid "*--msg* on|off"
43411 #. type: Plain text
43412 #: ../term-utils/setterm.1.adoc:106
43414 "Enables or disables the sending of kernel *printk*() messages to the "
43415 "console. Virtual consoles only."
43418 #. type: Labeled list
43419 #: ../term-utils/setterm.1.adoc:107
43421 msgid "*--msglevel* 0-8"
43424 #. type: Plain text
43425 #: ../term-utils/setterm.1.adoc:109
43427 "Sets the console logging level for kernel *printk()* messages. All messages "
43428 "strictly more important than this will be printed, so a logging level of *0* "
43429 "has the same effect as *--msg on* and a logging level of *8* will print all "
43430 "kernel messages. *klogd*(8) may be a more convenient interface to the "
43431 "logging of kernel messages."
43434 #. type: Plain text
43435 #: ../term-utils/setterm.1.adoc:111
43436 msgid "Virtual consoles only."
43439 #. type: Labeled list
43440 #: ../term-utils/setterm.1.adoc:112
43442 msgid "*--powerdown*[=0-60]"
43445 #. type: Plain text
43446 #: ../term-utils/setterm.1.adoc:114
43448 "Sets the VESA powerdown interval in minutes. Without an argument, it "
43449 "defaults to *0* (disable powerdown). If the console is blanked or the "
43450 "monitor is in suspend mode, then the monitor will go into vsync suspend mode "
43451 "or powerdown mode respectively after this period of time has elapsed."
43454 #. type: Labeled list
43455 #: ../term-utils/setterm.1.adoc:115
43457 msgid "*--powersave* _mode_"
43460 #. type: Plain text
43461 #: ../term-utils/setterm.1.adoc:117
43462 msgid "Valid values for _mode_ are:"
43465 #. type: Labeled list
43466 #: ../term-utils/setterm.1.adoc:118
43471 #. type: Plain text
43472 #: ../term-utils/setterm.1.adoc:120
43473 msgid "Puts the monitor into VESA vsync suspend mode."
43476 #. type: Labeled list
43477 #: ../term-utils/setterm.1.adoc:120
43482 #. type: Plain text
43483 #: ../term-utils/setterm.1.adoc:122
43484 msgid "Puts the monitor into VESA hsync suspend mode."
43487 #. type: Labeled list
43488 #: ../term-utils/setterm.1.adoc:122
43490 msgid "*powerdown*"
43493 #. type: Plain text
43494 #: ../term-utils/setterm.1.adoc:124
43495 msgid "Puts the monitor into VESA powerdown mode."
43498 #. type: Plain text
43499 #: ../term-utils/setterm.1.adoc:126
43500 msgid "Turns monitor VESA powersaving features."
43503 #. type: Labeled list
43504 #: ../term-utils/setterm.1.adoc:127
43506 msgid "*--regtabs*[=1-160]"
43509 #. type: Plain text
43510 #: ../term-utils/setterm.1.adoc:129
43512 "Clears all tab stops, then sets a regular tab stop pattern, with one tab "
43513 "every specified number of positions. Without an argument, it defaults to "
43514 "*8*. Virtual consoles only."
43517 #. type: Labeled list
43518 #: ../term-utils/setterm.1.adoc:130
43520 msgid "*--repeat* on|off"
43523 #. type: Plain text
43524 #: ../term-utils/setterm.1.adoc:132
43525 msgid "Turns keyboard repeat on or off. Virtual consoles only."
43528 #. type: Labeled list
43529 #: ../term-utils/setterm.1.adoc:133
43534 #. type: Plain text
43535 #: ../term-utils/setterm.1.adoc:135
43537 "Displays the terminal reset string, which typically resets the terminal to "
43538 "its power-on state."
43541 #. type: Labeled list
43542 #: ../term-utils/setterm.1.adoc:136
43547 #. type: Plain text
43548 #: ../term-utils/setterm.1.adoc:138
43550 "Reset terminal size by assessing maximum row and column. This is useful when "
43551 "actual geometry and kernel terminal driver are not in sync. Most notable use "
43552 "case is with serial consoles, that do not use *ioctl*(2) but just byte "
43553 "streams and breaks."
43556 #. type: Labeled list
43557 #: ../term-utils/setterm.1.adoc:139
43559 msgid "*--reverse* on|off"
43562 #. type: Plain text
43563 #: ../term-utils/setterm.1.adoc:141
43565 "Turns reverse video mode on or off. Except on a virtual console, *--reverse "
43566 "off* turns off all attributes (bold, half-brightness, blink, reverse)."
43569 #. type: Labeled list
43570 #: ../term-utils/setterm.1.adoc:142
43575 #. type: Plain text
43576 #: ../term-utils/setterm.1.adoc:144
43578 "Stores the terminal's current rendering options (foreground and background "
43579 "colors) as the values to be used at reset-to-default. Virtual consoles only."
43582 #. type: Labeled list
43583 #: ../term-utils/setterm.1.adoc:145
43585 msgid "*--tabs*[=_tab1 tab2 tab3_ ...]"
43588 #. type: Plain text
43589 #: ../term-utils/setterm.1.adoc:147
43591 "Sets tab stops at the given horizontal cursor positions, in the range "
43592 "*1-160*. Without arguments, it shows the current tab stop settings."
43595 #. type: Labeled list
43596 #: ../term-utils/setterm.1.adoc:148
43598 msgid "*--term* _terminal_name_"
43601 #. type: Plain text
43602 #: ../term-utils/setterm.1.adoc:150
43603 msgid "Overrides the *TERM* environment variable."
43606 #. type: Labeled list
43607 #: ../term-utils/setterm.1.adoc:151
43609 msgid "*--ulcolor* _16-color_"
43612 #. type: Plain text
43613 #: ../term-utils/setterm.1.adoc:153
43614 msgid "Sets the color for underlined characters. Virtual consoles only."
43617 #. type: Labeled list
43618 #: ../term-utils/setterm.1.adoc:154
43620 msgid "*--underline* on|off"
43623 #. type: Plain text
43624 #: ../term-utils/setterm.1.adoc:156
43625 msgid "Turns underline mode on or off."
43628 #. type: Plain text
43629 #: ../term-utils/setterm.1.adoc:162
43631 "Since version 2.25 *setterm* has support for long options with two hyphens, "
43632 "for example *--help*, beside the historical long options with a single "
43633 "hyphen, for example *-help*. In scripts it is better to use the backward-"
43634 "compatible single hyphen rather than the double hyphen. Currently there are "
43635 "no plans nor good reasons to discontinue single-hyphen compatibility."
43638 #. type: Plain text
43639 #: ../term-utils/setterm.1.adoc:166
43640 msgid "Differences between the Minix and Linux versions are not documented."
43643 #. type: Plain text
43644 #: ../term-utils/setterm.1.adoc:173
43657 #. Copyright (c) 1989, 1990 The Regents of the University of California.
43658 #. All rights reserved.
43659 #. Redistribution and use in source and binary forms, with or without
43660 #. modification, are permitted provided that the following conditions
43662 #. 1. Redistributions of source code must retain the above copyright
43663 #. notice, this list of conditions and the following disclaimer.
43664 #. 2. Redistributions in binary form must reproduce the above copyright
43665 #. notice, this list of conditions and the following disclaimer in the
43666 #. documentation and/or other materials provided with the distribution.
43667 #. 3. All advertising materials mentioning features or use of this software
43668 #. must display the following acknowledgement:
43669 #. This product includes software developed by the University of
43670 #. California, Berkeley and its contributors.
43671 #. 4. Neither the name of the University nor the names of its contributors
43672 #. may be used to endorse or promote products derived from this software
43673 #. without specific prior written permission.
43674 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43675 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43676 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43677 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43678 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43679 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43680 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43681 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43682 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43683 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43685 #. @(#)wall.1 6.5 (Berkeley) 4/23/91
43687 #: ../term-utils/wall.1.adoc:37
43692 #. type: Plain text
43693 #: ../term-utils/wall.1.adoc:47
43695 #| msgid "write - send a message to another user"
43696 msgid "wall - write a message to all users"
43697 msgstr "write - pošle zprávu jinému uživateli"
43699 #. type: Plain text
43700 #: ../term-utils/wall.1.adoc:51
43702 msgid "*wall* [*-n*] [*-t* _timeout_] [*-g* _group_] [_message_ | _file_]\n"
43705 #. type: Plain text
43706 #: ../term-utils/wall.1.adoc:55
43708 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"
43711 #. type: Plain text
43712 #: ../term-utils/wall.1.adoc:57
43714 "Only the superuser can write on the terminals of users who have chosen to "
43715 "deny messages or are using a program which automatically denies messages."
43718 #. type: Plain text
43719 #: ../term-utils/wall.1.adoc:59
43721 "Reading from a _file_ is refused when the invoker is not superuser and the "
43722 "program is set-user-ID or set-group-ID."
43725 #. type: Labeled list
43726 #: ../term-utils/wall.1.adoc:62
43728 #| msgid "*-V*, *--version*"
43729 msgid "*-n*, *--nobanner*"
43730 msgstr "*-V*, *--version*"
43732 #. type: Plain text
43733 #: ../term-utils/wall.1.adoc:64
43734 msgid "Suppress the banner."
43737 #. type: Plain text
43738 #: ../term-utils/wall.1.adoc:67
43740 "Abandon the write attempt to the terminals after _timeout_ seconds. This "
43741 "_timeout_ must be a positive integer. The default value is 300 seconds, "
43742 "which is a legacy from the time when people ran terminals over modem lines."
43745 #. type: Labeled list
43746 #: ../term-utils/wall.1.adoc:68
43748 #| msgid "*-g*, **--group**=__group__"
43749 msgid "*-g*, *--group* _group_"
43750 msgstr "*-g*, **--group**=__skupina__"
43752 #. type: Plain text
43753 #: ../term-utils/wall.1.adoc:70
43755 "Limit printing message to members of group defined as a _group_ argument. "
43756 "The argument can be group name or GID."
43759 #. type: Plain text
43760 #: ../term-utils/wall.1.adoc:76
43762 "Some sessions, such as *wdm*(1x), that have in the beginning of *utmp*(5) "
43763 "ut_type data a ':' character will not get the message from *wall*. This is "
43764 "done to avoid write errors."
43767 #. type: Plain text
43768 #: ../term-utils/wall.1.adoc:80
43770 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
43771 msgid "A *wall* command appeared in Version 7 AT&T UNIX."
43772 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
43774 #. type: Plain text
43775 #: ../term-utils/wall.1.adoc:87
43795 #. Copyright (c) 1989, 1993
43796 #. The Regents of the University of California. All rights reserved.
43797 #. This code is derived from software contributed to Berkeley by
43798 #. Jef Poskanzer and Craig Leres of the Lawrence Berkeley Laboratory.
43799 #. Redistribution and use in source and binary forms, with or without
43800 #. modification, are permitted provided that the following conditions
43802 #. 1. Redistributions of source code must retain the above copyright
43803 #. notice, this list of conditions and the following disclaimer.
43804 #. 2. Redistributions in binary form must reproduce the above copyright
43805 #. notice, this list of conditions and the following disclaimer in the
43806 #. documentation and/or other materials provided with the distribution.
43807 #. 3. All advertising materials mentioning features or use of this software
43808 #. must display the following acknowledgement:
43809 #. This product includes software developed by the University of
43810 #. California, Berkeley and its contributors.
43811 #. 4. Neither the name of the University nor the names of its contributors
43812 #. may be used to endorse or promote products derived from this software
43813 #. without specific prior written permission.
43814 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43815 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43816 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43817 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43818 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43819 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43820 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43821 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43822 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43823 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43825 #. @(#)write.1 8.1 (Berkeley) 6/6/93
43827 #: ../term-utils/write.1.adoc:39
43832 #. type: Plain text
43833 #: ../term-utils/write.1.adoc:49
43834 msgid "write - send a message to another user"
43835 msgstr "write - pošle zprávu jinému uživateli"
43837 #. type: Plain text
43838 #: ../term-utils/write.1.adoc:53
43840 msgid "*write* _user_ [_ttyname_]\n"
43841 msgstr "*write* _uživatel_ [_název_TTY_]\n"
43843 #. type: Plain text
43844 #: ../term-utils/write.1.adoc:57
43846 msgid "*write* allows you to communicate with other users, by copying lines from your terminal to theirs.\n"
43847 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"
43849 #. type: Plain text
43850 #: ../term-utils/write.1.adoc:59
43852 "When you run the *write* command, the user you are writing to gets a message "
43855 "Když spustíte příkaz *write*, uživatel, kterému píšete, dostane zprávu ve "
43858 #. type: delimited block .
43859 #: ../term-utils/write.1.adoc:62
43861 msgid "Message from yourname@yourhost on yourtty at hh:mm ...\n"
43862 msgstr "Zpráva od vaše_jméno@váš_počítač na vaše_TTY v hh:mm…\n"
43864 #. type: Plain text
43865 #: ../term-utils/write.1.adoc:65
43867 "Any further lines you enter will be copied to the specified user's terminal. "
43868 "If the other user wants to reply, they must run *write* as well."
43870 "Každé další napsané řádky se zkopírují na určený uživatelský terminál. Pokud "
43871 "chce druhý uživatel odpovědět, musí také spustit *write*."
43873 #. type: Plain text
43874 #: ../term-utils/write.1.adoc:67
43876 "When you are done, type an end-of-file or interrupt character. The other "
43877 "user will see the message *EOF* indicating that the conversation is over."
43879 "Když chcete skončit, vložte znak konce souboru (end-of-file, tj. CTRL+d) "
43880 "nebo přerušovací znak (CTRL+c). Druhý uživatel uvidí zprávu *EOF* ukazující, "
43881 "že konverzace skončila."
43883 #. type: Plain text
43884 #: ../term-utils/write.1.adoc:69
43886 "You can prevent people (other than the superuser) from writing to you with "
43887 "the *mesg*(1) command. Some commands, for example *nroff*(1) and *pr*(1), "
43888 "may automatically disallow writing, so that the output they produce isn't "
43891 "Psaní na svůj terminál můžete ostatním lidem (kromě superuživatele) zakázat "
43892 "pomocí příkazu *mesg*(1). Některé příkazy, např. *nroff*(1) a *pr*(1), mohou "
43893 "výpisy zakazovat automaticky, takže výstup, který vytváří, nebude zprávou "
43896 #. type: Plain text
43897 #: ../term-utils/write.1.adoc:71
43899 "If the user you want to write to is logged in on more than one terminal, you "
43900 "can specify which terminal to write to by giving the terminal name as the "
43901 "second operand to the *write* command. Alternatively, you can let *write* "
43902 "select one of the terminals - it will pick the one with the shortest idle "
43903 "time. This is so that if the user is logged in at work and also dialed up "
43904 "from home, the message will go to the right place."
43906 "Pokud je uživatel, kterému chcete psát, přihlášen na více terminálech, "
43907 "můžete určit, na který terminál se bude psát zadáním jména terminálu jako "
43908 "druhého parametru za příkazem *write*. Můžete také nechat program *write* "
43909 "vybrat jeden z terminálů - vybere se ten s nejkratší dobou nečinnosti. Pokud "
43910 "je tedy uživatel přihlášen v práci a zároveň je připojen z domova, zpráva "
43911 "dojde na správný terminál."
43913 #. type: Plain text
43914 #: ../term-utils/write.1.adoc:73
43916 "The traditional protocol for writing to someone is that the string _-o_, "
43917 "either at the end of a line or on a line by itself, means that it's the "
43918 "other person's turn to talk. The string _oo_ means that the person believes "
43919 "the conversation to be over."
43921 "Tradiční dohoda při psaní je, že značka _-o_, buď na konci řádku nebo na "
43922 "vlastním řádku, znamená, že je řada na druhé osobě. Znaky _oo_ znamenají, že "
43923 "osoba předpokládá, že konverzace skončila."
43925 #. type: Plain text
43926 #: ../term-utils/write.1.adoc:81
43928 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
43929 msgid "A *write* command appeared in Version 5 AT&T UNIX (Jun 1974)."
43930 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
43932 #. type: Plain text
43933 #: ../term-utils/write.1.adoc:87
43948 #. Copyright (c) 1990 The Regents of the University of California.
43949 #. All rights reserved.
43950 #. This code is derived from software contributed to Berkeley by
43951 #. Michael Rendell.
43952 #. Redistribution and use in source and binary forms, with or without
43953 #. modification, are permitted provided that the following conditions
43955 #. 1. Redistributions of source code must retain the above copyright
43956 #. notice, this list of conditions and the following disclaimer.
43957 #. 2. Redistributions in binary form must reproduce the above copyright
43958 #. notice, this list of conditions and the following disclaimer in the
43959 #. documentation and/or other materials provided with the distribution.
43960 #. 3. All advertising materials mentioning features or use of this software
43961 #. must display the following acknowledgement:
43962 #. This product includes software developed by the University of
43963 #. California, Berkeley and its contributors.
43964 #. 4. Neither the name of the University nor the names of its contributors
43965 #. may be used to endorse or promote products derived from this software
43966 #. without specific prior written permission.
43967 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
43968 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43969 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43970 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
43971 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43972 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
43973 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43974 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
43975 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
43976 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43978 #. @(#)col.1 6.8 (Berkeley) 6/17/91
43980 #: ../text-utils/col.1.adoc:39
43985 #. type: Plain text
43986 #: ../text-utils/col.1.adoc:49
43987 msgid "col - filter reverse line feeds from input"
43990 #. type: Plain text
43991 #: ../text-utils/col.1.adoc:53
43993 msgid "*col* _options_\n"
43996 #. type: Plain text
43997 #: ../text-utils/col.1.adoc:57
43999 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"
44002 #. type: Plain text
44003 #: ../text-utils/col.1.adoc:59
44005 msgid "*col* reads from standard input and writes to standard output.\n"
44008 #. type: Labeled list
44009 #: ../text-utils/col.1.adoc:62
44011 msgid "*-b*, *--no-backspaces*"
44014 #. type: Plain text
44015 #: ../text-utils/col.1.adoc:64
44017 "Do not output any backspaces, printing only the last character written to "
44018 "each column position."
44021 #. type: Labeled list
44022 #: ../text-utils/col.1.adoc:65
44024 #| msgid "*-f*, *--fast*"
44025 msgid "*-f*, *--fine*"
44026 msgstr "*-f*, *--fast*"
44028 #. type: Plain text
44029 #: ../text-utils/col.1.adoc:67
44031 "Permit half-forward line feeds. Normally characters destined for a half-line "
44032 "boundary are printed on the following line."
44035 #. type: Labeled list
44036 #: ../text-utils/col.1.adoc:68
44038 #| msgid "*-f*, *--fast*"
44039 msgid "*-h*, *--tabs*"
44040 msgstr "*-f*, *--fast*"
44042 #. type: Plain text
44043 #: ../text-utils/col.1.adoc:70
44044 msgid "Output tabs instead of multiple spaces."
44047 #. type: Labeled list
44048 #: ../text-utils/col.1.adoc:71
44050 msgid "*-l*, *--lines* _number_"
44053 #. type: Plain text
44054 #: ../text-utils/col.1.adoc:73
44056 "Buffer at least _number_ lines in memory. By default, 128 lines are buffered."
44059 #. type: Labeled list
44060 #: ../text-utils/col.1.adoc:74
44062 #| msgid "*-f*, *--fast*"
44063 msgid "*-p*, *--pass*"
44064 msgstr "*-f*, *--fast*"
44066 #. type: Plain text
44067 #: ../text-utils/col.1.adoc:76
44069 "Force unknown control sequences to be passed through unchanged. Normally "
44070 "*col* will filter out any control sequences other than those recognized and "
44071 "interpreted by itself, which are listed below."
44074 #. type: Labeled list
44075 #: ../text-utils/col.1.adoc:77
44077 #| msgid "*-f*, *--fast*"
44078 msgid "*-x*, *--spaces*"
44079 msgstr "*-f*, *--fast*"
44081 #. type: Plain text
44082 #: ../text-utils/col.1.adoc:79
44083 msgid "Output multiple spaces instead of tabs."
44086 #. type: Labeled list
44087 #: ../text-utils/col.1.adoc:80
44089 #| msgid "*-h*, *--help*"
44090 msgid "*-H*, *--help*"
44091 msgstr "*-h*, *--help*"
44093 #. type: Plain text
44094 #: ../text-utils/col.1.adoc:89
44096 "The *col* utility conforms to the Single UNIX Specification, Version 2. The "
44097 "*-l* option is an extension to the standard."
44100 #. type: Plain text
44101 #: ../text-utils/col.1.adoc:93
44103 "The control sequences for carriage motion that *col* understands and their "
44104 "decimal values are listed in the following table:"
44107 #. type: Labeled list
44108 #: ../text-utils/col.1.adoc:94
44113 #. type: Plain text
44114 #: ../text-utils/col.1.adoc:96
44115 msgid "reverse line feed (escape then 7)"
44118 #. type: Labeled list
44119 #: ../text-utils/col.1.adoc:96
44124 #. type: Plain text
44125 #: ../text-utils/col.1.adoc:98
44126 msgid "half reverse line feed (escape then 8)"
44129 #. type: Labeled list
44130 #: ../text-utils/col.1.adoc:98
44135 #. type: Plain text
44136 #: ../text-utils/col.1.adoc:100
44137 msgid "half forward line feed (escape then 9)"
44140 #. type: Labeled list
44141 #: ../text-utils/col.1.adoc:100
44143 msgid "*backspace*"
44146 #. type: Plain text
44147 #: ../text-utils/col.1.adoc:102
44148 msgid "moves back one column (8); ignored in the first column"
44151 #. type: Labeled list
44152 #: ../text-utils/col.1.adoc:102
44157 #. type: Plain text
44158 #: ../text-utils/col.1.adoc:104
44159 msgid "forward line feed (10); also does carriage return"
44162 #. type: Labeled list
44163 #: ../text-utils/col.1.adoc:104
44165 msgid "*carriage return*"
44168 #. type: Plain text
44169 #: ../text-utils/col.1.adoc:106
44173 #. type: Labeled list
44174 #: ../text-utils/col.1.adoc:106
44179 #. type: Plain text
44180 #: ../text-utils/col.1.adoc:108
44181 msgid "shift to normal character set (15)"
44184 #. type: Labeled list
44185 #: ../text-utils/col.1.adoc:108
44187 msgid "*shift out*"
44190 #. type: Plain text
44191 #: ../text-utils/col.1.adoc:110
44192 msgid "shift to alternate character set (14)"
44195 #. type: Labeled list
44196 #: ../text-utils/col.1.adoc:110
44201 #. type: Plain text
44202 #: ../text-utils/col.1.adoc:112
44203 msgid "moves forward one column (32)"
44206 #. type: Labeled list
44207 #: ../text-utils/col.1.adoc:112
44212 #. type: Plain text
44213 #: ../text-utils/col.1.adoc:114
44214 msgid "moves forward to next tab stop (9)"
44217 #. type: Labeled list
44218 #: ../text-utils/col.1.adoc:114
44220 msgid "*vertical tab*"
44223 #. type: Plain text
44224 #: ../text-utils/col.1.adoc:116
44225 msgid "reverse line feed (11)"
44228 #. type: Plain text
44229 #: ../text-utils/col.1.adoc:118
44230 msgid "All unrecognized control characters and escape sequences are discarded."
44233 #. type: Plain text
44234 #: ../text-utils/col.1.adoc:120
44236 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"
44239 #. type: Plain text
44240 #: ../text-utils/col.1.adoc:122
44242 "If the input attempts to back up to the last flushed line, *col* will "
44243 "display a warning message."
44246 #. type: Plain text
44247 #: ../text-utils/col.1.adoc:126
44249 #| msgid "A *write* command appeared in Version 6 AT&T UNIX."
44250 msgid "A *col* command appeared in Version 6 AT&T UNIX."
44251 msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
44253 #. type: Plain text
44254 #: ../text-utils/col.1.adoc:132
44272 #. Copyright (c) 1980, 1990, 1993
44273 #. The Regents of the University of California. All rights reserved.
44274 #. Redistribution and use in source and binary forms, with or without
44275 #. modification, are permitted provided that the following conditions
44277 #. 1. Redistributions of source code must retain the above copyright
44278 #. notice, this list of conditions and the following disclaimer.
44279 #. 2. Redistributions in binary form must reproduce the above copyright
44280 #. notice, this list of conditions and the following disclaimer in the
44281 #. documentation and/or other materials provided with the distribution.
44282 #. 3. All advertising materials mentioning features or use of this software
44283 #. must display the following acknowledgement:
44284 #. This product includes software developed by the University of
44285 #. California, Berkeley and its contributors.
44286 #. 4. Neither the name of the University nor the names of its contributors
44287 #. may be used to endorse or promote products derived from this software
44288 #. without specific prior written permission.
44289 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44290 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44291 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44292 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44293 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44294 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44295 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44296 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44297 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44298 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44300 #. @(#)colcrt.1 8.1 (Berkeley) 6/30/93
44302 #: ../text-utils/colcrt.1.adoc:36
44307 #. type: Plain text
44308 #: ../text-utils/colcrt.1.adoc:47
44309 msgid "colcrt - filter nroff output for CRT previewing"
44312 #. type: Plain text
44313 #: ../text-utils/colcrt.1.adoc:51
44315 msgid "*colcrt* [options] [_file_ ...]\n"
44318 #. type: Plain text
44319 #: ../text-utils/colcrt.1.adoc:55
44321 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"
44324 #. type: Labeled list
44325 #: ../text-utils/colcrt.1.adoc:58
44327 #| msgid "*-V*, *--version*"
44328 msgid "*-*, *--no-underlining*"
44329 msgstr "*-V*, *--version*"
44331 #. type: Plain text
44332 #: ../text-utils/colcrt.1.adoc:60
44334 "Suppress all underlining. This option is especially useful for previewing "
44335 "_allboxed_ tables from *tbl*(1)."
44338 #. type: Labeled list
44339 #: ../text-utils/colcrt.1.adoc:61
44341 #| msgid "*-*, *-l*, *--login*"
44342 msgid "*-2*, *--half-lines*"
44343 msgstr "*-*, *-l*, *--login*"
44345 #. type: Plain text
44346 #: ../text-utils/colcrt.1.adoc:63
44348 "Causes all half-lines to be printed, effectively double spacing the output. "
44349 "Normally, a minimal space output format is used which will suppress empty "
44350 "lines. The program never suppresses two consecutive empty lines, however. "
44351 "The *-2* option is useful for sending output to the line printer when the "
44352 "output contains superscripts and subscripts which would otherwise be "
44353 "partially invisible."
44356 #. type: Plain text
44357 #: ../text-utils/colcrt.1.adoc:69
44359 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
44360 msgid "The *colcrt* command appeared in 3.0BSD."
44361 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
44363 #. type: Plain text
44364 #: ../text-utils/colcrt.1.adoc:73
44366 "Should fold underlines onto blanks even with the *-* option so that a true "
44367 "underline character would show."
44370 #. type: Plain text
44371 #: ../text-utils/colcrt.1.adoc:75
44372 msgid "Can't back up more than 102 lines."
44375 #. TRANSLATORS: Keep {plus} untranslated.
44376 #. type: Plain text
44377 #: ../text-utils/colcrt.1.adoc:78
44379 "General overstriking is lost; as a special case '|' overstruck with '-' or "
44380 "underline becomes '{plus}'."
44383 #. type: Plain text
44384 #: ../text-utils/colcrt.1.adoc:80
44385 msgid "Lines are trimmed to 132 characters."
44388 #. type: Plain text
44389 #: ../text-utils/colcrt.1.adoc:82
44391 "Some provision should be made for processing superscripts and subscripts in "
44392 "documents which are already double-spaced."
44395 #. type: Plain text
44396 #: ../text-utils/colcrt.1.adoc:86
44397 msgid "A typical use of *colcrt* would be:"
44400 #. type: delimited block _
44401 #: ../text-utils/colcrt.1.adoc:89
44403 msgid "*tbl exum2.n | nroff -ms | colcrt - | more*\n"
44406 #. type: Plain text
44407 #: ../text-utils/colcrt.1.adoc:99
44420 #. Copyright (c) 1980, 1990 The Regents of the University of California.
44421 #. All rights reserved.
44422 #. Redistribution and use in source and binary forms, with or without
44423 #. modification, are permitted provided that the following conditions
44425 #. 1. Redistributions of source code must retain the above copyright
44426 #. notice, this list of conditions and the following disclaimer.
44427 #. 2. Redistributions in binary form must reproduce the above copyright
44428 #. notice, this list of conditions and the following disclaimer in the
44429 #. documentation and/or other materials provided with the distribution.
44430 #. 3. All advertising materials mentioning features or use of this software
44431 #. must display the following acknowledgement:
44432 #. This product includes software developed by the University of
44433 #. California, Berkeley and its contributors.
44434 #. 4. Neither the name of the University nor the names of its contributors
44435 #. may be used to endorse or promote products derived from this software
44436 #. without specific prior written permission.
44437 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44438 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44439 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44440 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44441 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44442 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44443 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44444 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44445 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44446 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44448 #. @(#)colrm.1 6.6 (Berkeley) 3/14/91
44450 #: ../text-utils/colrm.1.adoc:36
44455 #. type: Plain text
44456 #: ../text-utils/colrm.1.adoc:46
44457 msgid "colrm - remove columns from a file"
44460 #. type: Plain text
44461 #: ../text-utils/colrm.1.adoc:50
44463 msgid "*colrm* _[first [last]]_\n"
44466 #. type: Plain text
44467 #: ../text-utils/colrm.1.adoc:54
44469 msgid "*colrm* removes selected columns from a file. Input is taken from standard input. Output is sent to standard output.\n"
44472 #. type: Plain text
44473 #: ../text-utils/colrm.1.adoc:56
44475 "If called with one parameter the columns of each line will be removed "
44476 "starting with the specified _first_ column. If called with two parameters "
44477 "the columns from the _first_ column to the _last_ column will be removed."
44480 #. type: Plain text
44481 #: ../text-utils/colrm.1.adoc:58
44482 msgid "Column numbering starts with column 1."
44485 #. type: Plain text
44486 #: ../text-utils/colrm.1.adoc:66
44488 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
44489 msgid "The *colrm* command appeared in 3.0BSD."
44490 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
44492 #. type: Plain text
44493 #: ../text-utils/colrm.1.adoc:73
44505 #. Copyright (c) 1989, 1990, 1993
44506 #. The Regents of the University of California. All rights reserved.
44507 #. Redistribution and use in source and binary forms, with or without
44508 #. modification, are permitted provided that the following conditions
44510 #. 1. Redistributions of source code must retain the above copyright
44511 #. notice, this list of conditions and the following disclaimer.
44512 #. 2. Redistributions in binary form must reproduce the above copyright
44513 #. notice, this list of conditions and the following disclaimer in the
44514 #. documentation and/or other materials provided with the distribution.
44515 #. 3. All advertising materials mentioning features or use of this software
44516 #. must display the following acknowledgement:
44517 #. This product includes software developed by the University of
44518 #. California, Berkeley and its contributors.
44519 #. 4. Neither the name of the University nor the names of its contributors
44520 #. may be used to endorse or promote products derived from this software
44521 #. without specific prior written permission.
44522 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44523 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44524 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44525 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
44526 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
44527 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44528 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
44529 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
44530 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
44531 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
44533 #. @(#)column.1 8.1 (Berkeley) 6/6/93
44535 #: ../text-utils/column.1.adoc:36
44540 #. type: Plain text
44541 #: ../text-utils/column.1.adoc:46
44542 msgid "column - columnate lists"
44545 #. type: Plain text
44546 #: ../text-utils/column.1.adoc:50
44548 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
44549 msgid "*column* [options] [_file_ ...]\n"
44550 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
44552 #. type: Plain text
44553 #: ../text-utils/column.1.adoc:54
44555 "The *column* utility formats its input into multiple columns. The util "
44556 "support three modes:"
44559 #. type: Labeled list
44560 #: ../text-utils/column.1.adoc:55
44562 msgid "*columns are filled before rows*"
44565 #. type: Plain text
44566 #: ../text-utils/column.1.adoc:57
44567 msgid "This is the default mode (required by backward compatibility)."
44570 #. type: Labeled list
44571 #: ../text-utils/column.1.adoc:58
44573 msgid "*rows are filled before columns*"
44576 #. type: Plain text
44577 #: ../text-utils/column.1.adoc:60
44578 msgid "This mode is enabled by option *-x, --fillrows*"
44581 #. type: Labeled list
44582 #: ../text-utils/column.1.adoc:61
44587 #. type: Plain text
44588 #: ../text-utils/column.1.adoc:63
44590 "Determine the number of columns the input contains and create a table. This "
44591 "mode is enabled by option *-t, --table* and columns formatting is possible "
44592 "to modify by *--table-** options. Use this mode if not sure. The output is "
44593 "aligned to the terminal width in interactive mode and the 80 columns in non-"
44594 "interactive mode (see *--output-width* for more details)."
44597 #. type: Plain text
44598 #: ../text-utils/column.1.adoc:65
44600 "Input is taken from _file_, or otherwise from standard input. Empty lines "
44601 "are ignored and all invalid multibyte sequences are encoded by x<hex> "
44605 #. type: Plain text
44606 #: ../text-utils/column.1.adoc:74
44608 "The argument _columns_ for *--table-** options is a comma separated list of "
44609 "the column names as defined by *--table-columns*, or names defined by *--"
44610 "table-column* or it's column number in order as specified by input. It's "
44611 "possible to mix names and numbers. The special placeholder '0' (e.g. -R0) "
44612 "may be used to specify all columns and '-1' (e.g. -R -1) to specify the last "
44613 "visible column. It's possible to use ranges like '1-5' when addressing "
44614 "columns by numbers."
44617 #. type: Labeled list
44618 #: ../text-utils/column.1.adoc:75
44620 msgid "*-J, --json*"
44623 #. type: Plain text
44624 #: ../text-utils/column.1.adoc:77
44626 "Use JSON output format to print the table, the option *--table-columns* is "
44627 "required and the option *--table-name* is recommended."
44630 #. type: Labeled list
44631 #: ../text-utils/column.1.adoc:78
44633 msgid "*-c, --output-width* _width_"
44636 #. type: Plain text
44637 #: ../text-utils/column.1.adoc:80
44639 "Output is formatted to a width specified as number of characters. The "
44640 "original name of this option is *--columns*; this name is deprecated since "
44641 "v2.30. Note that input longer than _width_ is not truncated by default. The "
44642 "default is a terminal width and the 80 columns in non-interactive mode. The "
44643 "column headers are never truncated."
44646 #. type: Plain text
44647 #: ../text-utils/column.1.adoc:82
44649 "The placeholder \"unlimited\" (or 0) is possible to use to not restrict "
44650 "output width. This is recommended for example when output to the files "
44651 "rather than on terminal."
44654 #. type: Labeled list
44655 #: ../text-utils/column.1.adoc:83
44657 msgid "*-d, --table-noheadings*"
44660 #. type: Plain text
44661 #: ../text-utils/column.1.adoc:85
44663 "Do not print header. This option allows the use of logical column names on "
44664 "the command line, but keeps the header hidden when printing the table."
44667 #. type: Labeled list
44668 #: ../text-utils/column.1.adoc:86
44670 msgid "*-o, --output-separator* _string_"
44673 #. type: Plain text
44674 #: ../text-utils/column.1.adoc:88
44675 msgid "Specify the columns delimiter for table output (default is two spaces)."
44678 #. type: Labeled list
44679 #: ../text-utils/column.1.adoc:89
44681 msgid "*-s, --separator* _separators_"
44684 #. type: Plain text
44685 #: ../text-utils/column.1.adoc:91
44686 msgid "Specify the possible input item delimiters (default is whitespace)."
44689 #. type: Labeled list
44690 #: ../text-utils/column.1.adoc:92
44692 msgid "*-t, --table*"
44695 #. type: Plain text
44696 #: ../text-utils/column.1.adoc:94
44698 "Determine the number of columns the input contains and create a table. "
44699 "Columns are delimited with whitespace, by default, or with the characters "
44700 "supplied using the *--output-separator* option. Table output is useful for "
44704 #. type: Labeled list
44705 #: ../text-utils/column.1.adoc:95
44707 msgid "*-C, --table-column* _properties_"
44710 #. type: Plain text
44711 #: ../text-utils/column.1.adoc:101
44713 "Define one column by comma separated list of column attributes. This option "
44714 "can be used more than once, every use defines just one column. The "
44715 "properties replace some of *--table-* options. For example *--table-column "
44716 "name=FOO,right* define one column where text is aligned to right. The option "
44717 "is mutually exclusive to *--table-columns*."
44720 #. type: Plain text
44721 #: ../text-utils/column.1.adoc:103
44722 msgid "The currently supported attributes are:"
44725 #. type: Labeled list
44726 #: ../text-utils/column.1.adoc:104
44728 msgid "*name=string*"
44731 #. type: Plain text
44732 #: ../text-utils/column.1.adoc:106
44733 msgid "Specifies column name."
44736 #. type: Labeled list
44737 #: ../text-utils/column.1.adoc:106
44742 #. type: Plain text
44743 #: ../text-utils/column.1.adoc:108
44745 "The column text can be truncated when necessary. The same as *--table-"
44749 #. type: Labeled list
44750 #: ../text-utils/column.1.adoc:108
44755 #. type: Plain text
44756 #: ../text-utils/column.1.adoc:110
44757 msgid "Right align text in the specified columns. The same as *--table-right*."
44760 #. type: Labeled list
44761 #: ../text-utils/column.1.adoc:110
44763 msgid "*width=number*"
44766 #. type: Plain text
44767 #: ../text-utils/column.1.adoc:113
44769 "Specifies column width. The width is used as a hint only. The width is "
44770 "strictly followed only when *strictwidth* attribute is used too."
44773 #. type: Labeled list
44774 #: ../text-utils/column.1.adoc:113
44776 msgid "*strictwidth*"
44779 #. type: Plain text
44780 #: ../text-utils/column.1.adoc:115
44781 msgid "Strictly follow column *width=* setting."
44784 #. type: Labeled list
44785 #: ../text-utils/column.1.adoc:115
44787 msgid "*noextreme*"
44790 #. type: Plain text
44791 #: ../text-utils/column.1.adoc:117
44793 "Specify columns where is possible to ignore unusually long cells. See *--"
44794 "table-noextreme* for more details."
44797 #. type: Labeled list
44798 #: ../text-utils/column.1.adoc:117
44803 #. type: Plain text
44804 #: ../text-utils/column.1.adoc:119
44806 "Specify columns where is possible to use multi-line cell for long text when "
44807 "necessary. See *--table-wrap*."
44810 #. type: Labeled list
44811 #: ../text-utils/column.1.adoc:119
44816 #. type: Plain text
44817 #: ../text-utils/column.1.adoc:121
44818 msgid "Don't print specified columns. See *--table-hide*."
44821 #. type: Labeled list
44822 #: ../text-utils/column.1.adoc:121
44824 msgid "*json=type*"
44827 #. type: Plain text
44828 #: ../text-utils/column.1.adoc:123
44830 "Define column type for JSON output, Supported are string, number and boolean."
44833 #. type: Labeled list
44834 #: ../text-utils/column.1.adoc:124
44836 msgid "*-N, --table-columns* _names_"
44839 #. type: Plain text
44840 #: ../text-utils/column.1.adoc:127
44842 "Specify the columns names by comma separated list of names. The names are "
44843 "used for the table header or to address column in option argument. See also "
44844 "*--table-column*."
44847 #. type: Labeled list
44848 #: ../text-utils/column.1.adoc:128
44850 msgid "*-l, --table-columns-limit* _number_"
44853 #. type: Plain text
44854 #: ../text-utils/column.1.adoc:130
44856 "Specify maximal number of the input columns. The last column will contain "
44857 "all remaining line data if the limit is smaller than the number of the "
44858 "columns in the input data."
44861 #. type: Labeled list
44862 #: ../text-utils/column.1.adoc:131
44864 msgid "*-R, --table-right* _columns_"
44867 #. type: Plain text
44868 #: ../text-utils/column.1.adoc:133
44869 msgid "Right align text in the specified columns."
44872 #. type: Labeled list
44873 #: ../text-utils/column.1.adoc:134
44875 msgid "*-T, --table-truncate* _columns_"
44878 #. type: Plain text
44879 #: ../text-utils/column.1.adoc:136
44881 "Specify columns where text can be truncated when necessary, otherwise very "
44882 "long table entries may be printed on multiple lines."
44885 #. type: Labeled list
44886 #: ../text-utils/column.1.adoc:137
44888 msgid "*-E, --table-noextreme* _columns_"
44891 #. type: Plain text
44892 #: ../text-utils/column.1.adoc:139
44894 "Specify columns where is possible to ignore unusually long (longer than "
44895 "average) cells when calculate column width. The option has impact to the "
44896 "width calculation and table formatting, but the printed text is not affected."
44899 #. type: Plain text
44900 #: ../text-utils/column.1.adoc:141
44901 msgid "The option is used for the last visible column by default."
44904 #. type: Labeled list
44905 #: ../text-utils/column.1.adoc:142
44907 msgid "*-e, --table-header-repeat*"
44910 #. type: Plain text
44911 #: ../text-utils/column.1.adoc:144
44912 msgid "Print header line for each page."
44915 #. type: Labeled list
44916 #: ../text-utils/column.1.adoc:145
44918 msgid "*-W, --table-wrap* _columns_"
44921 #. type: Plain text
44922 #: ../text-utils/column.1.adoc:147
44924 "Specify columns where is possible to use multi-line cell for long text when "
44928 #. type: Labeled list
44929 #: ../text-utils/column.1.adoc:148
44931 msgid "*-H, --table-hide* _columns_"
44934 #. type: Plain text
44935 #: ../text-utils/column.1.adoc:150
44937 "Don't print specified columns. The special placeholder '-' may be used to "
44938 "hide all unnamed columns (see *--table-columns*)."
44941 #. type: Labeled list
44942 #: ../text-utils/column.1.adoc:151
44944 msgid "*-O, --table-order* _columns_"
44947 #. type: Plain text
44948 #: ../text-utils/column.1.adoc:153
44949 msgid "Specify columns order on output."
44952 #. type: Labeled list
44953 #: ../text-utils/column.1.adoc:154
44955 msgid "*-n, --table-name* _name_"
44958 #. type: Plain text
44959 #: ../text-utils/column.1.adoc:156
44960 msgid "Specify the table name used for JSON output. The default is \"table\"."
44963 #. type: Labeled list
44964 #: ../text-utils/column.1.adoc:157
44966 #| msgid "*-P*, *--pty*"
44967 msgid "*-m, --table-maxout*"
44968 msgstr "*-P*, *--pty*"
44970 #. type: Plain text
44971 #: ../text-utils/column.1.adoc:159
44972 msgid "Fill all available space on output."
44975 #. type: Labeled list
44976 #: ../text-utils/column.1.adoc:160
44978 msgid "*-L, --keep-empty-lines*"
44981 #. type: Plain text
44982 #: ../text-utils/column.1.adoc:162
44984 "Preserve whitespace-only lines in the input. The default is ignore empty "
44985 "lines at all. This option's original name was *--table-empty-lines* but is "
44986 "now deprecated because it gives the false impression that the option only "
44987 "applies to table mode."
44990 #. type: Labeled list
44991 #: ../text-utils/column.1.adoc:163
44993 msgid "*-r, --tree* _column_"
44996 #. type: Plain text
44997 #: ../text-utils/column.1.adoc:165
44999 "Specify column to use tree-like output. Note that the circular dependencies "
45000 "and other anomalies in child and parent relation are silently ignored."
45003 #. type: Labeled list
45004 #: ../text-utils/column.1.adoc:166
45006 msgid "*-i, --tree-id* _column_"
45009 #. type: Plain text
45010 #: ../text-utils/column.1.adoc:168
45011 msgid "Specify column with line ID to create child-parent relation."
45014 #. type: Labeled list
45015 #: ../text-utils/column.1.adoc:169
45017 msgid "*-p, --tree-parent* _column_"
45020 #. type: Plain text
45021 #: ../text-utils/column.1.adoc:171
45022 msgid "Specify column with parent ID to create child-parent relation."
45025 #. type: Labeled list
45026 #: ../text-utils/column.1.adoc:172
45028 msgid "*-x, --fillrows*"
45031 #. type: Plain text
45032 #: ../text-utils/column.1.adoc:174
45033 msgid "Fill rows before filling columns."
45036 #. type: Plain text
45037 #: ../text-utils/column.1.adoc:180
45039 "The environment variable *COLUMNS* is used to determine the size of the "
45040 "screen if no other information is available."
45043 #. type: Plain text
45044 #: ../text-utils/column.1.adoc:184
45045 msgid "The *column* command appeared in 4.3BSD-Reno."
45048 #. type: Plain text
45049 #: ../text-utils/column.1.adoc:188
45050 msgid "Version 2.23 changed the *-s* option to be non-greedy, for example:"
45053 #. type: delimited block .
45054 #: ../text-utils/column.1.adoc:191
45056 msgid "printf \"a:b:c\\n1::3\\n\" | column -t -s ':'\n"
45059 #. type: Plain text
45060 #: ../text-utils/column.1.adoc:194
45061 msgid "Old output:"
45064 #. type: delimited block .
45065 #: ../text-utils/column.1.adoc:198
45072 #. type: Plain text
45073 #: ../text-utils/column.1.adoc:201
45074 msgid "New output (since util-linux 2.23):"
45077 #. type: delimited block .
45078 #: ../text-utils/column.1.adoc:205
45085 #. type: Plain text
45086 #: ../text-utils/column.1.adoc:208
45088 "Historical versions of this tool indicated that \"rows are filled before "
45089 "columns\" by default, and that the *-x* option reverses this. This wording "
45090 "did not reflect the actual behavior, and it has since been corrected (see "
45091 "above). Other implementations of *column* may continue to use the older "
45092 "documentation, but the behavior should be identical in any case."
45095 #. type: Plain text
45096 #: ../text-utils/column.1.adoc:212
45097 msgid "Print fstab with header line and align number to the right:"
45100 #. type: delimited block .
45101 #: ../text-utils/column.1.adoc:215
45103 msgid "sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ --table-right PASS,FREQ\n"
45106 #. type: Plain text
45107 #: ../text-utils/column.1.adoc:218
45108 msgid "Print fstab and hide unnamed columns:"
45111 #. type: delimited block .
45112 #: ../text-utils/column.1.adoc:221
45114 msgid "sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE --table-hide -\n"
45117 #. type: Plain text
45118 #: ../text-utils/column.1.adoc:224
45119 msgid "Print a tree:"
45122 #. type: delimited block .
45123 #: ../text-utils/column.1.adoc:232
45126 "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"
45134 #. type: Plain text
45135 #: ../text-utils/column.1.adoc:240
45154 #. Copyright (c) 1989, 1990, 1993
45155 #. The Regents of the University of California. All rights reserved.
45156 #. Redistribution and use in source and binary forms, with or without
45157 #. modification, are permitted provided that the following conditions
45159 #. 1. Redistributions of source code must retain the above copyright
45160 #. notice, this list of conditions and the following disclaimer.
45161 #. 2. Redistributions in binary form must reproduce the above copyright
45162 #. notice, this list of conditions and the following disclaimer in the
45163 #. documentation and/or other materials provided with the distribution.
45164 #. 3. All advertising materials mentioning features or use of this software
45165 #. must display the following acknowledgement:
45166 #. This product includes software developed by the University of
45167 #. California, Berkeley and its contributors.
45168 #. 4. Neither the name of the University nor the names of its contributors
45169 #. may be used to endorse or promote products derived from this software
45170 #. without specific prior written permission.
45171 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
45172 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45173 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45174 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
45175 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45176 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
45177 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
45178 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
45179 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
45180 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
45182 #. @(#)hexdump.1 8.2 (Berkeley) 4/18/94
45184 #: ../text-utils/hexdump.1.adoc:36
45189 #. type: Plain text
45190 #: ../text-utils/hexdump.1.adoc:48
45192 "hexdump - display file contents in hexadecimal, decimal, octal, or ascii"
45195 #. type: Plain text
45196 #: ../text-utils/hexdump.1.adoc:52
45198 msgid "*hexdump* _options file_ ...\n"
45201 #. type: Plain text
45202 #: ../text-utils/hexdump.1.adoc:54
45204 msgid "*hd* _options file_ ...\n"
45207 #. type: Plain text
45208 #: ../text-utils/hexdump.1.adoc:58
45210 "The *hexdump* utility is a filter which displays the specified files, or "
45211 "standard input if no files are specified, in a user-specified format."
45214 #. type: Plain text
45215 #: ../text-utils/hexdump.1.adoc:62
45217 "Below, the _length_ and _offset_ arguments may be followed by the "
45218 "multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
45219 "TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
45220 "meaning as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on "
45221 "for GB, TB, PB, EB, ZB and YB."
45224 #. type: Labeled list
45225 #: ../text-utils/hexdump.1.adoc:63
45227 msgid "*-b*, *--one-byte-octal*"
45230 #. type: Plain text
45231 #: ../text-utils/hexdump.1.adoc:65
45233 "_One-byte octal display_. Display the input offset in hexadecimal, followed "
45234 "by sixteen space-separated, three-column, zero-filled bytes of input data, "
45235 "in octal, per line."
45238 #. type: Labeled list
45239 #: ../text-utils/hexdump.1.adoc:66
45241 #| msgid "*-P*, *--pty*"
45242 msgid "*-X*, *--one-byte-hex*"
45243 msgstr "*-P*, *--pty*"
45245 #. type: Plain text
45246 #: ../text-utils/hexdump.1.adoc:68
45248 "_One-byte hexadecimal display_. Display the input offset in hexadecimal, "
45249 "followed by sixteen space-separated, two-column, zero-filled bytes of input "
45250 "data, in hexadecimal, per line."
45253 #. type: Labeled list
45254 #: ../text-utils/hexdump.1.adoc:69
45256 msgid "*-c*, *--one-byte-char*"
45259 #. type: Plain text
45260 #: ../text-utils/hexdump.1.adoc:71
45262 "_One-byte character display_. Display the input offset in hexadecimal, "
45263 "followed by sixteen space-separated, three-column, space-filled characters "
45264 "of input data per line."
45267 #. type: Labeled list
45268 #: ../text-utils/hexdump.1.adoc:72
45270 #| msgid "*-V*, *--version*"
45271 msgid "*-C*, *--canonical*"
45272 msgstr "*-V*, *--version*"
45274 #. TRANSLATORS: Keep {plus} and {underscore} untranslated.
45275 #. type: Plain text
45276 #: ../text-utils/hexdump.1.adoc:74
45278 "_Canonical hex{plus}ASCII display_. Display the input offset in hexadecimal, "
45279 "followed by sixteen space-separated, two-column, hexadecimal bytes, followed "
45280 "by the same sixteen bytes in *%{underscore}p* format enclosed in *|* "
45281 "characters. Invoking the program as *hd* implies this option."
45284 #. type: Labeled list
45285 #: ../text-utils/hexdump.1.adoc:76
45287 msgid "*-d*, *--two-bytes-decimal*"
45290 #. type: Plain text
45291 #: ../text-utils/hexdump.1.adoc:78
45293 "_Two-byte decimal display_. Display the input offset in hexadecimal, "
45294 "followed by eight space-separated, five-column, zero-filled, two-byte units "
45295 "of input data, in unsigned decimal, per line."
45298 #. type: Labeled list
45299 #: ../text-utils/hexdump.1.adoc:79
45301 msgid "*-e*, *--format* _format_string_"
45304 #. type: Plain text
45305 #: ../text-utils/hexdump.1.adoc:81
45306 msgid "Specify a format string to be used for displaying data."
45309 #. type: Labeled list
45310 #: ../text-utils/hexdump.1.adoc:82
45312 #| msgid "*-f*, *--fast*"
45313 msgid "*-f*, *--format-file* _file_"
45314 msgstr "*-f*, *--fast*"
45316 #. type: Plain text
45317 #: ../text-utils/hexdump.1.adoc:84
45319 "Specify a file that contains one or more newline-separated format strings. "
45320 "Empty lines and lines whose first non-blank character is a hash mark (#) are "
45324 #. type: Plain text
45325 #: ../text-utils/hexdump.1.adoc:87
45327 "Accept color units for the output. The optional argument _when_ can be "
45328 "*auto*, *never* or *always*. If the _when_ argument is omitted, it defaults "
45329 "to *auto*. The colors can be disabled; for the current built-in default see "
45330 "the *--help* output. See also the *Colors* subsection and the *COLORS* "
45334 #. type: Labeled list
45335 #: ../text-utils/hexdump.1.adoc:88
45337 msgid "*-n*, *--length* _length_"
45340 #. type: Plain text
45341 #: ../text-utils/hexdump.1.adoc:90
45342 msgid "Interpret only _length_ bytes of input."
45345 #. type: Labeled list
45346 #: ../text-utils/hexdump.1.adoc:91
45348 msgid "*-o*, *--two-bytes-octal*"
45351 #. type: Plain text
45352 #: ../text-utils/hexdump.1.adoc:93
45354 "_Two-byte octal display_. Display the input offset in hexadecimal, followed "
45355 "by eight space-separated, six-column, zero-filled, two-byte quantities of "
45356 "input data, in octal, per line."
45359 #. type: Labeled list
45360 #: ../text-utils/hexdump.1.adoc:94
45362 #| msgid "*-s*, **--shell**=__shell__"
45363 msgid "*-s*, *--skip* _offset_"
45364 msgstr "*-s*, **--shell**=__shell__"
45366 #. type: Plain text
45367 #: ../text-utils/hexdump.1.adoc:96
45368 msgid "Skip _offset_ bytes from the beginning of the input."
45371 #. type: Labeled list
45372 #: ../text-utils/hexdump.1.adoc:97
45374 #| msgid "*-V*, *--version*"
45375 msgid "*-v*, *--no-squeezing*"
45376 msgstr "*-V*, *--version*"
45378 #. type: Plain text
45379 #: ../text-utils/hexdump.1.adoc:99
45381 "The *-v* option causes *hexdump* to display all input data. Without the *-v* "
45382 "option, any number of groups of output lines which would be identical to the "
45383 "immediately preceding group of output lines (except for the input offsets), "
45384 "are replaced with a line comprised of a single asterisk."
45387 #. type: Labeled list
45388 #: ../text-utils/hexdump.1.adoc:100
45390 #| msgid "*-P*, *--pty*"
45391 msgid "*-x*, *--two-bytes-hex*"
45392 msgstr "*-P*, *--pty*"
45394 #. type: Plain text
45395 #: ../text-utils/hexdump.1.adoc:102
45397 "_Two-byte hexadecimal display_. Display the input offset in hexadecimal, "
45398 "followed by eight space-separated, four-column, zero-filled, two-byte "
45399 "quantities of input data, in hexadecimal, per line."
45402 #. type: Plain text
45403 #: ../text-utils/hexdump.1.adoc:106
45405 "For each input file, *hexdump* sequentially copies the input to standard "
45406 "output, transforming the data according to the format strings specified by "
45407 "the *-e* and *-f* options, in the order that they were specified."
45411 #: ../text-utils/hexdump.1.adoc:107
45416 #. type: Plain text
45417 #: ../text-utils/hexdump.1.adoc:110
45419 "A format string contains any number of format units, separated by "
45420 "whitespace. A format unit contains up to three items: an iteration count, a "
45421 "byte count, and a format."
45424 #. type: Plain text
45425 #: ../text-utils/hexdump.1.adoc:112
45427 "The iteration count is an optional positive integer, which defaults to one. "
45428 "Each format is applied iteration count times."
45431 #. type: Plain text
45432 #: ../text-utils/hexdump.1.adoc:114
45434 "The byte count is an optional positive integer. If specified it defines the "
45435 "number of bytes to be interpreted by each iteration of the format."
45438 #. type: Plain text
45439 #: ../text-utils/hexdump.1.adoc:116
45441 "If an iteration count and/or a byte count is specified, a single slash must "
45442 "be placed after the iteration count and/or before the byte count to "
45443 "disambiguate them. Any whitespace before or after the slash is ignored."
45446 #. type: Plain text
45447 #: ../text-utils/hexdump.1.adoc:118
45449 "The format is required and must be surrounded by double quote (\" \") marks. "
45450 "It is interpreted as a fprintf-style format string (see *fprintf*(3)), with "
45451 "the following exceptions:"
45454 #. type: Labeled list
45455 #: ../text-utils/hexdump.1.adoc:119
45461 #. type: Plain text
45462 #: ../text-utils/hexdump.1.adoc:121
45463 msgid "An asterisk (*) may not be used as a field width or precision."
45466 #. type: Labeled list
45467 #: ../text-utils/hexdump.1.adoc:122
45472 #. type: Plain text
45473 #: ../text-utils/hexdump.1.adoc:124
45475 "A byte count or field precision _is_ required for each *s* conversion "
45476 "character (unlike the *fprintf*(3) default which prints the entire string if "
45477 "the precision is unspecified)."
45480 #. type: Labeled list
45481 #: ../text-utils/hexdump.1.adoc:125
45486 #. type: Plain text
45487 #: ../text-utils/hexdump.1.adoc:127
45489 "The conversion characters *h*, *l*, *n*, *p*, and *q* are not supported."
45492 #. type: Labeled list
45493 #: ../text-utils/hexdump.1.adoc:128
45498 #. type: Plain text
45499 #: ../text-utils/hexdump.1.adoc:130
45501 "The single character escape sequences described in the C standard are "
45506 #: ../text-utils/hexdump.1.adoc:141
45510 "|<alert character> |\\a\n"
45511 "|<backspace> |\\b\n"
45512 "|<form-feed> |\\f\n"
45513 "|<newline> |\\n\n"
45514 "|<carriage return> |\\r\n"
45516 "|<vertical tab> |\\v\n"
45520 #: ../text-utils/hexdump.1.adoc:144
45522 msgid "Conversion strings"
45525 #. type: delimited block _
45526 #: ../text-utils/hexdump.1.adoc:147
45528 "The *hexdump* utility also supports the following additional conversion "
45532 #. type: Labeled list
45533 #: ../text-utils/hexdump.1.adoc:148
45538 #. type: delimited block _
45539 #: ../text-utils/hexdump.1.adoc:150
45541 "Display the input offset, cumulative across input files, of the next byte to "
45542 "be displayed. The appended characters *d*, *o*, and *x* specify the display "
45543 "base as decimal, octal or hexadecimal respectively."
45546 #. type: Labeled list
45547 #: ../text-utils/hexdump.1.adoc:151
45552 #. type: delimited block _
45553 #: ../text-utils/hexdump.1.adoc:153
45555 "Almost identical to the *_a* conversion string except that it is only "
45556 "performed once, when all of the input data has been processed."
45559 #. type: Labeled list
45560 #: ../text-utils/hexdump.1.adoc:154
45565 #. type: delimited block _
45566 #: ../text-utils/hexdump.1.adoc:156
45568 "Output characters in the default character set. Non-printing characters are "
45569 "displayed in three-character, zero-padded octal, except for those "
45570 "representable by standard escape notation (see above), which are displayed "
45571 "as two-character strings."
45574 #. type: Labeled list
45575 #: ../text-utils/hexdump.1.adoc:157
45580 #. type: delimited block _
45581 #: ../text-utils/hexdump.1.adoc:159
45583 "Output characters in the default character set. Non-printing characters are "
45584 "displayed as a single '*.*'."
45587 #. type: Labeled list
45588 #: ../text-utils/hexdump.1.adoc:160
45593 #. type: delimited block _
45594 #: ../text-utils/hexdump.1.adoc:162
45596 "Output US ASCII characters, with the exception that control characters are "
45597 "displayed using the following, lower-case, names. Characters greater than "
45598 "0xff, hexadecimal, are displayed as hexadecimal strings."
45602 #: ../text-utils/hexdump.1.adoc:171
45605 "|000 nul |001 soh |002 stx |003 etx |004 eot |005 enq\n"
45606 "|006 ack |007 bel |008 bs |009 ht |00A lf |00B vt\n"
45607 "|00C ff |00D cr |00E so |00F si |010 dle |011 dc1\n"
45608 "|012 dc2 |013 dc3 |014 dc4 |015 nak |016 syn |017 etb\n"
45609 "|018 can |019 em |01A sub |01B esc |01C fs |01D gs\n"
45610 "|01E rs |01F us |0FF del | | |\n"
45614 #: ../text-utils/hexdump.1.adoc:174
45619 #. type: delimited block _
45620 #: ../text-utils/hexdump.1.adoc:177
45622 "When put at the end of a format specifier, *hexdump* highlights the "
45623 "respective string with the color specified. Conditions, if present, are "
45624 "evaluated prior to highlighting."
45627 #. type: delimited block _
45628 #: ../text-utils/hexdump.1.adoc:179
45630 msgid "*_L[color_unit_1,color_unit_2,...,color_unit_n]*\n"
45633 #. type: delimited block _
45634 #: ../text-utils/hexdump.1.adoc:181
45635 msgid "The full syntax of a color unit is as follows:"
45638 #. type: delimited block _
45639 #: ../text-utils/hexdump.1.adoc:183
45641 msgid "*[!]COLOR[:VALUE][@OFFSET_START[-END]]*\n"
45644 #. type: Labeled list
45645 #: ../text-utils/hexdump.1.adoc:184
45650 #. type: delimited block _
45651 #: ../text-utils/hexdump.1.adoc:186
45653 "Negate the condition. Please note that it only makes sense to negate a unit "
45654 "if both a value/string and an offset are specified. In that case the "
45655 "respective output string will be highlighted if and only if the value/string "
45656 "does not match the one at the offset."
45659 #. type: Labeled list
45660 #: ../text-utils/hexdump.1.adoc:187
45666 #. type: delimited block _
45667 #: ../text-utils/hexdump.1.adoc:189
45668 msgid "One of the 8 basic shell colors."
45671 #. type: Labeled list
45672 #: ../text-utils/hexdump.1.adoc:190
45677 #. type: delimited block _
45678 #: ../text-utils/hexdump.1.adoc:192
45680 "A value to be matched specified in hexadecimal, or octal base, or as a "
45681 "string. Please note that the usual C escape sequences are not interpreted by "
45682 "*hexdump* inside the color_units."
45685 #. type: Labeled list
45686 #: ../text-utils/hexdump.1.adoc:193
45691 #. type: delimited block _
45692 #: ../text-utils/hexdump.1.adoc:195
45694 "An offset or an offset range at which to check for a match. Please note that "
45695 "lone OFFSET_START uses the same value as END offset."
45699 #: ../text-utils/hexdump.1.adoc:196
45704 #. type: delimited block _
45705 #: ../text-utils/hexdump.1.adoc:199
45707 "The default and supported byte counts for the conversion characters are as "
45711 #. type: Labeled list
45712 #: ../text-utils/hexdump.1.adoc:200
45714 msgid "*%_c*, *%_p*, *%_u*, *%c*"
45717 #. type: delimited block _
45718 #: ../text-utils/hexdump.1.adoc:202
45719 msgid "One byte counts only."
45722 #. type: Labeled list
45723 #: ../text-utils/hexdump.1.adoc:203
45725 msgid "*%d*, *%i*, *%o*, *%u*, *%X*, *%x*"
45728 #. type: delimited block _
45729 #: ../text-utils/hexdump.1.adoc:205
45730 msgid "Four byte default, one, two and four byte counts supported."
45733 #. type: Labeled list
45734 #: ../text-utils/hexdump.1.adoc:206
45736 msgid "*%E*, *%e*, *%f*, *%G*, *%g*"
45739 #. type: delimited block _
45740 #: ../text-utils/hexdump.1.adoc:208
45741 msgid "Eight byte default, four byte counts supported."
45744 #. type: delimited block _
45745 #: ../text-utils/hexdump.1.adoc:210
45747 "The amount of data interpreted by each format string is the sum of the data "
45748 "required by each format unit, which is the iteration count times the byte "
45749 "count, or the iteration count times the number of bytes required by the "
45750 "format if the byte count is not specified."
45753 #. type: delimited block _
45754 #: ../text-utils/hexdump.1.adoc:212
45756 "The input is manipulated in _blocks_, where a block is defined as the "
45757 "largest amount of data specified by any format string. Format strings "
45758 "interpreting less than an input block's worth of data, whose last format "
45759 "unit both interprets some number of bytes and does not have a specified "
45760 "iteration count, have the iteration count incremented until the entire input "
45761 "block has been processed or there is not enough data remaining in the block "
45762 "to satisfy the format string."
45765 #. type: delimited block _
45766 #: ../text-utils/hexdump.1.adoc:214
45768 "If, either as a result of user specification or *hexdump* modifying the "
45769 "iteration count as described above, an iteration count is greater than one, "
45770 "no trailing whitespace characters are output during the last iteration."
45773 #. type: delimited block _
45774 #: ../text-utils/hexdump.1.adoc:216
45776 "It is an error to specify a byte count as well as multiple conversion "
45777 "characters or strings unless all but one of the conversion characters or "
45778 "strings is *_a* or *_A*."
45781 #. type: delimited block _
45782 #: ../text-utils/hexdump.1.adoc:218
45784 "If, as a result of the specification of the *-n* option or end-of-file being "
45785 "reached, input data only partially satisfies a format string, the input "
45786 "block is zero-padded sufficiently to display all available data (i.e., any "
45787 "format units overlapping the end of data will display some number of the "
45791 #. TRANSLATORS: Keep {plus} untranslated.
45792 #. type: delimited block _
45793 #: ../text-utils/hexdump.1.adoc:221
45795 "Further output by such format strings is replaced by an equivalent number of "
45796 "spaces. An equivalent number of spaces is defined as the number of spaces "
45797 "output by an *s* conversion character with the same field width and "
45798 "precision as the original conversion character or conversion string but with "
45799 "any '*{plus}*', ' ', '*#*' conversion flag characters removed, and "
45800 "referencing a NULL string."
45803 #. type: delimited block _
45804 #: ../text-utils/hexdump.1.adoc:223
45806 "If no format strings are specified, the default display is very similar to "
45807 "the *-x* output format (the *-x* option causes more space to be used between "
45808 "format units than in the default output)."
45811 #. type: delimited block _
45812 #: ../text-utils/hexdump.1.adoc:227
45814 msgid "*hexdump* exits 0 on success and > 0 if an error occurred.\n"
45817 #. type: delimited block _
45818 #: ../text-utils/hexdump.1.adoc:231
45820 "The *hexdump* utility is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
45824 #. type: delimited block _
45825 #: ../text-utils/hexdump.1.adoc:235
45826 msgid "Display the input in perusal format:"
45829 #. type: delimited block .
45830 #: ../text-utils/hexdump.1.adoc:240
45833 " \"%06.6_ao \" 12/1 \"%3_u \"\n"
45834 " \"\\t\" \"%_p \"\n"
45838 #. type: Plain text
45839 #: ../text-utils/hexdump.1.adoc:243
45840 msgid "Implement the *-x* option:"
45843 #. type: delimited block .
45844 #: ../text-utils/hexdump.1.adoc:247
45847 " \"%07.7_Ax\\n\"\n"
45848 " \"%07.7_ax \" 8/2 \"%04x \" \"\\n\"\n"
45851 #. type: Plain text
45852 #: ../text-utils/hexdump.1.adoc:250
45854 "MBR Boot Signature example: Highlight the addresses cyan and the bytes at "
45855 "offsets 510 and 511 green if their value is 0xAA55, red otherwise."
45858 #. type: delimited block .
45859 #: ../text-utils/hexdump.1.adoc:254
45862 " \"%07.7_Ax_L[cyan]\\n\"\n"
45863 " \"%07.7_ax_L[cyan] \" 8/2 \" %04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] \" \"\\n\"\n"
45870 #. This page is in the public domain
45872 #: ../text-utils/line.1.adoc:3
45874 #| msgid "write(1)"
45878 #. type: Plain text
45879 #: ../text-utils/line.1.adoc:13
45880 msgid "line - read one line"
45883 #. type: Plain text
45884 #: ../text-utils/line.1.adoc:17
45889 #. type: Plain text
45890 #: ../text-utils/line.1.adoc:21
45892 "The utility *line* copies one line (up to a newline) from standard input to "
45893 "standard output. It always prints at least a newline and returns an exit "
45894 "status of 1 on EOF or read error."
45897 #. type: Plain text
45898 #: ../text-utils/line.1.adoc:25
45900 msgid "*read*(1p)\n"
45907 #. Copyright (c) 1988, 1990 The Regents of the University of California.
45908 #. Copyright (c) 1988 Mark Nudleman
45909 #. All rights reserved.
45910 #. Redistribution and use in source and binary forms, with or without
45911 #. modification, are permitted provided that the following conditions
45913 #. 1. Redistributions of source code must retain the above copyright
45914 #. notice, this list of conditions and the following disclaimer.
45915 #. 2. Redistributions in binary form must reproduce the above copyright
45916 #. notice, this list of conditions and the following disclaimer in the
45917 #. documentation and/or other materials provided with the distribution.
45918 #. 3. All advertising materials mentioning features or use of this software
45919 #. must display the following acknowledgement:
45920 #. This product includes software developed by the University of
45921 #. California, Berkeley and its contributors.
45922 #. 4. Neither the name of the University nor the names of its contributors
45923 #. may be used to endorse or promote products derived from this software
45924 #. without specific prior written permission.
45925 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
45926 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45927 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45928 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
45929 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45930 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
45931 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
45932 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
45933 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
45934 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
45936 #. @(#)more.1 5.15 (Berkeley) 7/29/91
45937 #. Copyright (c) 1992 Rik Faith (faith@cs.unc.edu)
45939 #: ../text-utils/more.1.adoc:39
45941 #| msgid "write(1)"
45945 #. type: Plain text
45946 #: ../text-utils/more.1.adoc:49
45947 msgid "more - display the contents of a file in a terminal"
45950 #. type: Plain text
45951 #: ../text-utils/more.1.adoc:53
45953 msgid "*more* [options] _file_ ...\n"
45956 #. type: Plain text
45957 #: ../text-utils/more.1.adoc:57
45959 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"
45962 #. type: Plain text
45963 #: ../text-utils/more.1.adoc:61
45965 "Options are also taken from the environment variable *MORE* (make sure to "
45966 "precede them with a dash (*-*)) but command-line options will override those."
45969 #. type: Labeled list
45970 #: ../text-utils/more.1.adoc:62
45972 #| msgid "*-f*, *--fast*"
45973 msgid "*-d*, *--silent*"
45974 msgstr "*-f*, *--fast*"
45976 #. type: Plain text
45977 #: ../text-utils/more.1.adoc:64
45979 "Prompt with \"[Press space to continue, 'q' to quit.]\", and display "
45980 "\"[Press 'h' for instructions.]\" instead of ringing the bell when an "
45981 "illegal key is pressed."
45984 #. type: Labeled list
45985 #: ../text-utils/more.1.adoc:65
45987 #| msgid "*-*, *-l*, *--login*"
45988 msgid "*-l*, *--logical*"
45989 msgstr "*-*, *-l*, *--login*"
45991 #. type: Plain text
45992 #: ../text-utils/more.1.adoc:67
45993 msgid "Do not pause after any line containing a *^L* (form feed)."
45996 #. type: Labeled list
45997 #: ../text-utils/more.1.adoc:68
45999 #| msgid "*-V*, *--version*"
46000 msgid "*-e*, *--exit-on-eof*"
46001 msgstr "*-V*, *--version*"
46003 #. type: Plain text
46004 #: ../text-utils/more.1.adoc:70
46006 "Exit on End-Of-File, enabled by default if POSIXLY_CORRECT environment "
46007 "variable is not set or if not executed on terminal."
46010 #. type: Labeled list
46011 #: ../text-utils/more.1.adoc:71
46013 #| msgid "*-f*, *--fast*"
46014 msgid "*-f*, *--no-pause*"
46015 msgstr "*-f*, *--fast*"
46017 #. type: Plain text
46018 #: ../text-utils/more.1.adoc:73
46020 "Count logical lines, rather than screen lines (i.e., long lines are not "
46024 #. type: Labeled list
46025 #: ../text-utils/more.1.adoc:74
46027 #| msgid "*-P*, *--pty*"
46028 msgid "*-p*, *--print-over*"
46029 msgstr "*-P*, *--pty*"
46031 #. type: Plain text
46032 #: ../text-utils/more.1.adoc:76
46034 "Do not scroll. Instead, clear the whole screen and then display the text. "
46035 "Notice that this option is switched on automatically if the executable is "
46039 #. type: Labeled list
46040 #: ../text-utils/more.1.adoc:77
46042 #| msgid "*-V*, *--version*"
46043 msgid "*-c*, *--clean-print*"
46044 msgstr "*-V*, *--version*"
46046 #. type: Plain text
46047 #: ../text-utils/more.1.adoc:79
46049 "Do not scroll. Instead, paint each screen from the top, clearing the "
46050 "remainder of each line as it is displayed."
46053 #. type: Labeled list
46054 #: ../text-utils/more.1.adoc:80
46056 #| msgid "*-h*, *--help*"
46057 msgid "*-s*, *--squeeze*"
46058 msgstr "*-h*, *--help*"
46060 #. type: Plain text
46061 #: ../text-utils/more.1.adoc:82
46062 msgid "Squeeze multiple blank lines into one."
46065 #. type: Labeled list
46066 #: ../text-utils/more.1.adoc:83
46068 #| msgid "*-P*, *--pty*"
46069 msgid "*-u*, *--plain*"
46070 msgstr "*-P*, *--pty*"
46072 #. type: Plain text
46073 #: ../text-utils/more.1.adoc:85
46075 "Suppress underlining. This option is silently ignored as backwards "
46079 #. type: Labeled list
46080 #: ../text-utils/more.1.adoc:86
46082 msgid "*-n*, *--lines* _number_"
46085 #. type: Plain text
46086 #: ../text-utils/more.1.adoc:88
46088 "Specify the _number_ of lines per screenful. The _number_ argument is a "
46089 "positive decimal integer. The *--lines* option shall override any values "
46090 "obtained from any other source, such as number of lines reported by terminal."
46093 #. type: Labeled list
46094 #: ../text-utils/more.1.adoc:89 ../text-utils/pg.1.adoc:36
46096 msgid "**-**__number__"
46099 #. type: Plain text
46100 #: ../text-utils/more.1.adoc:91
46101 msgid "A numeric option means the same as *--lines* option argument."
46104 #. type: Labeled list
46105 #: ../text-utils/more.1.adoc:92 ../text-utils/pg.1.adoc:30
46107 msgid "**+**__number__"
46110 #. type: Plain text
46111 #: ../text-utils/more.1.adoc:94
46112 msgid "Start displaying each file at line _number_."
46115 #. type: Labeled list
46116 #: ../text-utils/more.1.adoc:95
46118 msgid "**+**/__string__"
46121 #. type: Plain text
46122 #: ../text-utils/more.1.adoc:97
46123 msgid "The _string_ to be searched in each file before starting to display it."
46126 #. type: Plain text
46127 #: ../text-utils/more.1.adoc:103
46129 "Interactive commands for *more* are based on *vi*(1). Some commands may be "
46130 "preceded by a decimal number, called k in the descriptions below. In the "
46131 "following descriptions, *^X* means *control-X*."
46134 #. type: Labeled list
46135 #: ../text-utils/more.1.adoc:104
46140 #. type: Plain text
46141 #: ../text-utils/more.1.adoc:106
46143 "Help; display a summary of these commands. If you forget all other commands, "
46144 "remember this one."
46147 #. type: Labeled list
46148 #: ../text-utils/more.1.adoc:107
46153 #. type: Plain text
46154 #: ../text-utils/more.1.adoc:109
46155 msgid "Display next k lines of text. Defaults to current screen size."
46158 #. type: Labeled list
46159 #: ../text-utils/more.1.adoc:110
46164 #. type: Plain text
46165 #: ../text-utils/more.1.adoc:112
46167 "Display next k lines of text. Defaults to current screen size. Argument "
46168 "becomes new default."
46171 #. type: Labeled list
46172 #: ../text-utils/more.1.adoc:113
46177 #. type: Plain text
46178 #: ../text-utils/more.1.adoc:115
46180 "Display next k lines of text. Defaults to 1. Argument becomes new default."
46183 #. type: Labeled list
46184 #: ../text-utils/more.1.adoc:116
46186 msgid "*d* or *^D*"
46189 #. type: Plain text
46190 #: ../text-utils/more.1.adoc:118
46192 "Scroll k lines. Default is current scroll size, initially 11. Argument "
46193 "becomes new default."
46196 #. type: Labeled list
46197 #: ../text-utils/more.1.adoc:119
46199 msgid "*q* or *Q* or *INTERRUPT*"
46202 #. type: Plain text
46203 #: ../text-utils/more.1.adoc:121
46207 #. type: Plain text
46208 #: ../text-utils/more.1.adoc:124
46209 msgid "Skip forward k lines of text. Defaults to 1."
46212 #. type: Labeled list
46213 #: ../text-utils/more.1.adoc:125
46218 #. type: Plain text
46219 #: ../text-utils/more.1.adoc:127
46220 msgid "Skip forward k screenfuls of text. Defaults to 1."
46223 #. type: Labeled list
46224 #: ../text-utils/more.1.adoc:128
46226 msgid "*b* or *^B*"
46229 #. type: Plain text
46230 #: ../text-utils/more.1.adoc:130
46232 "Skip backwards k screenfuls of text. Defaults to 1. Only works with files, "
46236 #. type: Labeled list
46237 #: ../text-utils/more.1.adoc:131
46242 #. type: Plain text
46243 #: ../text-utils/more.1.adoc:133
46244 msgid "Go to the place where the last search started."
46247 #. type: Labeled list
46248 #: ../text-utils/more.1.adoc:134
46253 #. type: Plain text
46254 #: ../text-utils/more.1.adoc:136
46255 msgid "Display current line number."
46258 #. type: Labeled list
46259 #: ../text-utils/more.1.adoc:137
46264 #. type: Plain text
46265 #: ../text-utils/more.1.adoc:139
46266 msgid "Search for kth occurrence of regular expression. Defaults to 1."
46269 #. type: Plain text
46270 #: ../text-utils/more.1.adoc:142
46271 msgid "Search for kth occurrence of last regular expression. Defaults to 1."
46274 #. type: Labeled list
46275 #: ../text-utils/more.1.adoc:143
46277 #| msgid "*-c*, **--command**=__command__"
46278 msgid "*!command* or *:!command*"
46279 msgstr "*-c*, **--command**=__příkaz__"
46281 #. type: Plain text
46282 #: ../text-utils/more.1.adoc:145
46283 msgid "Execute _command_ in a subshell."
46286 #. type: Labeled list
46287 #: ../text-utils/more.1.adoc:146
46292 #. type: Plain text
46293 #: ../text-utils/more.1.adoc:148
46295 "Start up an editor at current line. The editor is taken from the environment "
46296 "variable *VISUAL* if defined, or *EDITOR* if *VISUAL* is not defined, or "
46297 "defaults to *vi*(1) if neither *VISUAL* nor *EDITOR* is defined."
46300 #. type: Labeled list
46301 #: ../text-utils/more.1.adoc:149
46306 #. type: Plain text
46307 #: ../text-utils/more.1.adoc:151
46308 msgid "Redraw screen."
46311 #. type: Labeled list
46312 #: ../text-utils/more.1.adoc:152
46317 #. type: Plain text
46318 #: ../text-utils/more.1.adoc:154
46319 msgid "Go to kth next file. Defaults to 1."
46322 #. type: Labeled list
46323 #: ../text-utils/more.1.adoc:155
46328 #. type: Plain text
46329 #: ../text-utils/more.1.adoc:157
46330 msgid "Go to kth previous file. Defaults to 1."
46333 #. type: Labeled list
46334 #: ../text-utils/more.1.adoc:158
46339 #. type: Plain text
46340 #: ../text-utils/more.1.adoc:160
46341 msgid "Display current file name and line number."
46344 #. type: Labeled list
46345 #: ../text-utils/more.1.adoc:161
46350 #. type: Plain text
46351 #: ../text-utils/more.1.adoc:163
46352 msgid "Repeat previous command."
46355 #. type: Plain text
46356 #: ../text-utils/more.1.adoc:167
46358 "The *more* command respects the following environment variables, if they "
46362 #. type: Labeled list
46363 #: ../text-utils/more.1.adoc:168
46368 #. type: Plain text
46369 #: ../text-utils/more.1.adoc:170
46370 msgid "This variable may be set with favored options to *more*."
46373 #. type: Plain text
46374 #: ../text-utils/more.1.adoc:173
46375 msgid "Current shell in use (normally set by the shell at login time)."
46378 #. type: Labeled list
46379 #: ../text-utils/more.1.adoc:174 ../text-utils/pg.1.adoc:133
46380 #: ../text-utils/ul.1.adoc:69
46385 #. type: Plain text
46386 #: ../text-utils/more.1.adoc:176
46388 "The terminal type used by *more* to get the terminal characteristics "
46389 "necessary to manipulate the screen."
46392 #. type: Labeled list
46393 #: ../text-utils/more.1.adoc:177
46398 #. type: Plain text
46399 #: ../text-utils/more.1.adoc:179
46400 msgid "The editor the user prefers. Invoked when command key _v_ is pressed."
46403 #. type: Plain text
46404 #: ../text-utils/more.1.adoc:182
46405 msgid "The editor of choice when *VISUAL* is not specified."
46408 #. type: Plain text
46409 #: ../text-utils/more.1.adoc:185
46410 msgid "Disable exit-on-eof (see option *-e* for more details)."
46413 #. type: Plain text
46414 #: ../text-utils/more.1.adoc:189
46416 "The *more* command appeared in 3.0BSD. This man page documents *more* "
46417 "version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux "
46418 "community. Documentation was produced using several other versions of the "
46419 "man page, and extensive inspection of the source code."
46422 #. type: Plain text
46423 #: ../text-utils/more.1.adoc:193
46424 msgid "Eric Shienbrood, UC Berkeley."
46427 #. type: Plain text
46428 #: ../text-utils/more.1.adoc:195
46429 msgid "Modified by Geoff Peck, UCB to add underlining, single spacing."
46432 #. type: Plain text
46433 #: ../text-utils/more.1.adoc:197
46434 msgid "Modified by John Foderaro, UCB to add -c and MORE environment variable."
46437 #. type: Plain text
46438 #: ../text-utils/more.1.adoc:202
46452 #. Copyright 2001 Gunnar Ritter
46454 #: ../text-utils/pg.1.adoc:3
46459 #. type: Plain text
46460 #: ../text-utils/pg.1.adoc:13
46461 msgid "pg - browse pagewise through text files"
46464 #. type: Plain text
46465 #: ../text-utils/pg.1.adoc:17
46467 msgid "*pg* *-*_amount_ *-p* _prompt_ *-cefnrs* +line +/pattern/ file_ ...\n"
46470 #. type: Plain text
46471 #: ../text-utils/pg.1.adoc:21
46473 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"
46476 #. type: Plain text
46477 #: ../text-utils/pg.1.adoc:23
46479 "If no filename is given on the command line, *pg* reads from standard input. "
46480 "If standard output is not a terminal, *pg* acts like *cat*(1) but precedes "
46481 "each file with its name if there is more than one."
46484 #. type: Plain text
46485 #: ../text-utils/pg.1.adoc:25
46487 "If input comes from a pipe, *pg* stores the data in a buffer file while "
46488 "reading, to make navigation possible."
46491 #. type: Plain text
46492 #: ../text-utils/pg.1.adoc:29
46494 msgid "*pg* accepts the following options:\n"
46497 #. type: Plain text
46498 #: ../text-utils/pg.1.adoc:32
46499 msgid "Start at the given line number."
46502 #. type: Labeled list
46503 #: ../text-utils/pg.1.adoc:33
46505 msgid "**+/**__pattern__*/*"
46508 #. type: Plain text
46509 #: ../text-utils/pg.1.adoc:35
46511 "Start at the line containing the Basic Regular Expression _pattern_ given."
46514 #. type: Plain text
46515 #: ../text-utils/pg.1.adoc:38
46517 "The number of lines per page. By default, this is the number of CRT lines "
46521 #. type: Plain text
46522 #: ../text-utils/pg.1.adoc:41
46524 "Clear the screen before a page is displayed, if the terminfo entry for the "
46525 "terminal provides this capability."
46528 #. type: Labeled list
46529 #: ../text-utils/pg.1.adoc:42
46534 #. type: Plain text
46535 #: ../text-utils/pg.1.adoc:44
46536 msgid "Do not pause and display _(EOF)_ at the end of a file."
46539 #. type: Plain text
46540 #: ../text-utils/pg.1.adoc:47
46541 msgid "Do not split long lines."
46544 #. type: Labeled list
46545 #: ../text-utils/pg.1.adoc:48
46550 #. type: Plain text
46551 #: ../text-utils/pg.1.adoc:50
46553 "Without this option, commands must be terminated by a newline character."
46556 #. type: Plain text
46557 #: ../text-utils/pg.1.adoc:52
46558 msgid "With this option, *pg* advances once a command letter is entered."
46561 #. type: Labeled list
46562 #: ../text-utils/pg.1.adoc:53
46564 msgid "*-p* _string_"
46567 #. type: Plain text
46568 #: ../text-utils/pg.1.adoc:55
46570 "Instead of the normal prompt _:_, _string_ is displayed. If _string_ "
46571 "contains *%d*, its first occurrence is replaced by the number of the current "
46575 #. type: Labeled list
46576 #: ../text-utils/pg.1.adoc:56
46581 #. type: Plain text
46582 #: ../text-utils/pg.1.adoc:58
46583 msgid "Disallow the shell escape."
46586 #. type: Plain text
46587 #: ../text-utils/pg.1.adoc:61
46589 "Print messages in _standout_ mode, if the terminfo entry for the terminal "
46590 "provides this capability."
46593 #. type: Plain text
46594 #: ../text-utils/pg.1.adoc:67
46596 "The following commands may be entered at the prompt. Commands preceded by "
46597 "_i_ in this document accept a number as argument, positive or negative. If "
46598 "this argument starts with *+* or *-*, it is interpreted relative to the "
46599 "current position in the input file, otherwise relative to the beginning."
46602 #. type: Labeled list
46603 #: ../text-utils/pg.1.adoc:68
46605 msgid "__i__**<Enter>**"
46608 #. type: Plain text
46609 #: ../text-utils/pg.1.adoc:70
46611 #| msgid "Display help text and exit."
46612 msgid "Display the next or the indicated page."
46613 msgstr "Zobrazí text nápovědy a skončí."
46615 #. type: Labeled list
46616 #: ../text-utils/pg.1.adoc:71
46618 msgid "__i__**d** or *^D*"
46621 #. type: Plain text
46622 #: ../text-utils/pg.1.adoc:73
46624 "Display the next halfpage. If _i_ is given, it is always interpreted "
46625 "relative to the current position."
46628 #. type: Labeled list
46629 #: ../text-utils/pg.1.adoc:74
46634 #. type: Plain text
46635 #: ../text-utils/pg.1.adoc:76
46637 #| msgid "Display help text and exit."
46638 msgid "Display the next or the indicated line."
46639 msgstr "Zobrazí text nápovědy a skončí."
46641 #. type: Labeled list
46642 #: ../text-utils/pg.1.adoc:77
46647 #. type: Plain text
46648 #: ../text-utils/pg.1.adoc:79
46650 "Skip a page forward. _i_ must be a positive number and is always interpreted "
46651 "relative to the current position."
46654 #. type: Labeled list
46655 #: ../text-utils/pg.1.adoc:80
46657 msgid "__i__**w** or __i__**z**"
46660 #. type: Plain text
46661 #: ../text-utils/pg.1.adoc:82
46662 msgid "As *<Enter>* except that _i_ becomes the new page size."
46665 #. type: Labeled list
46666 #: ../text-utils/pg.1.adoc:83
46668 msgid "*.* or *^L*"
46671 #. type: Plain text
46672 #: ../text-utils/pg.1.adoc:85
46673 msgid "Redraw the screen."
46676 #. type: Labeled list
46677 #: ../text-utils/pg.1.adoc:86
46682 #. type: Plain text
46683 #: ../text-utils/pg.1.adoc:88
46684 msgid "Advance to the last line of the input file."
46687 #. type: Labeled list
46688 #: ../text-utils/pg.1.adoc:89
46690 msgid "__i__**/**__pattern__**/**"
46693 #. type: Plain text
46694 #: ../text-utils/pg.1.adoc:91
46696 "Search forward until the first or the _i_-th occurrence of the Basic Regular "
46697 "Expression _pattern_ is found. The search starts after the current page and "
46698 "stops at the end of the file. No wrap-around is performed. _i_ must be a "
46702 #. type: Labeled list
46703 #: ../text-utils/pg.1.adoc:92
46705 msgid "__i__**?**__pattern__**?** or __i__**^**__pattern__**^**"
46708 #. type: Plain text
46709 #: ../text-utils/pg.1.adoc:94
46711 "Search backward until the first or the _i_-th occurrence of the Basic "
46712 "Regular Expression _pattern_ is found. The search starts before the current "
46713 "page and stops at the beginning of the file. No wrap-around is performed. "
46714 "_i_ must be a positive number."
46717 #. type: Plain text
46718 #: ../text-utils/pg.1.adoc:96
46720 "The search commands accept an added letter. If *t* is given, the line "
46721 "containing the pattern is displayed at the top of the screen, which is the "
46722 "default. *m* selects the middle and *b* the bottom of the screen. The "
46723 "selected position is used in following searches, too."
46726 #. type: Labeled list
46727 #: ../text-utils/pg.1.adoc:97
46732 #. type: Plain text
46733 #: ../text-utils/pg.1.adoc:99
46734 msgid "Advance to the next file or _i_ files forward."
46737 #. type: Labeled list
46738 #: ../text-utils/pg.1.adoc:100
46743 #. type: Plain text
46744 #: ../text-utils/pg.1.adoc:102
46745 msgid "Reread the previous file or _i_ files backward."
46748 #. type: Labeled list
46749 #: ../text-utils/pg.1.adoc:103
46751 msgid "*s* _filename_"
46754 #. type: Plain text
46755 #: ../text-utils/pg.1.adoc:105
46756 msgid "Save the current file to the given _filename_."
46759 #. type: Plain text
46760 #: ../text-utils/pg.1.adoc:108
46761 msgid "Display a command summary."
46764 #. type: Labeled list
46765 #: ../text-utils/pg.1.adoc:109
46767 #| msgid "*-c*, **--command**=__command__"
46768 msgid "**!**__command__"
46769 msgstr "*-c*, **--command**=__příkaz__"
46771 #. type: Plain text
46772 #: ../text-utils/pg.1.adoc:111
46773 msgid "Execute _command_ using the shell."
46776 #. type: Labeled list
46777 #: ../text-utils/pg.1.adoc:112
46782 #. type: Plain text
46783 #: ../text-utils/pg.1.adoc:114
46787 #. type: Plain text
46788 #: ../text-utils/pg.1.adoc:116
46790 "If the user presses the interrupt or quit key while *pg* reads from the "
46791 "input file or writes on the terminal, *pg* will immediately display the "
46792 "prompt. In all other situations these keys will terminate *pg*."
46795 #. type: Plain text
46796 #: ../text-utils/pg.1.adoc:120
46797 msgid "The following environment variables affect the behavior of *pg*:"
46800 #. type: Labeled list
46801 #: ../text-utils/pg.1.adoc:121
46806 #. type: Plain text
46807 #: ../text-utils/pg.1.adoc:123
46808 msgid "Overrides the system-supplied number of columns if set."
46811 #. type: Labeled list
46812 #: ../text-utils/pg.1.adoc:124
46814 msgid "*LANG*, *LC_ALL*, *LC_COLLATE*, *LC_CTYPE*, *LC_MESSAGES*"
46817 #. type: Plain text
46818 #: ../text-utils/pg.1.adoc:126
46819 msgid "See *locale*(7)."
46822 #. type: Labeled list
46823 #: ../text-utils/pg.1.adoc:127
46828 #. type: Plain text
46829 #: ../text-utils/pg.1.adoc:129
46830 msgid "Overrides the system-supplied number of lines if set."
46833 #. type: Plain text
46834 #: ../text-utils/pg.1.adoc:132
46835 msgid "Used by the *!* command."
46838 #. type: Plain text
46839 #: ../text-utils/pg.1.adoc:135
46840 msgid "Determines the terminal type."
46843 #. type: Plain text
46844 #: ../text-utils/pg.1.adoc:139
46846 msgid "*pg* expects the terminal tabulators to be set every eight positions.\n"
46849 #. type: Plain text
46850 #: ../text-utils/pg.1.adoc:141
46851 msgid "Files that include NUL characters cannot be displayed by *pg*."
46854 #. type: Plain text
46855 #: ../text-utils/pg.1.adoc:151
46870 #. Copyright (c) 1985, 1992 The Regents of the University of California.
46871 #. All rights reserved.
46872 #. Redistribution and use in source and binary forms, with or without
46873 #. modification, are permitted provided that the following conditions
46875 #. 1. Redistributions of source code must retain the above copyright
46876 #. notice, this list of conditions and the following disclaimer.
46877 #. 2. Redistributions in binary form must reproduce the above copyright
46878 #. notice, this list of conditions and the following disclaimer in the
46879 #. documentation and/or other materials provided with the distribution.
46880 #. 3. All advertising materials mentioning features or use of this software
46881 #. must display the following acknowledgement:
46882 #. This product includes software developed by the University of
46883 #. California, Berkeley and its contributors.
46884 #. 4. Neither the name of the University nor the names of its contributors
46885 #. may be used to endorse or promote products derived from this software
46886 #. without specific prior written permission.
46887 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46888 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46889 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46890 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
46891 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46892 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46893 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46894 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
46895 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
46896 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46898 #. @(#)rev.1 6.3 (Berkeley) 3/21/92
46900 #: ../text-utils/rev.1.adoc:36
46905 #. type: Plain text
46906 #: ../text-utils/rev.1.adoc:46
46907 msgid "rev - reverse lines characterwise"
46910 #. type: Plain text
46911 #: ../text-utils/rev.1.adoc:50
46913 msgid "*rev* [option] [_file_...]\n"
46916 #. type: Plain text
46917 #: ../text-utils/rev.1.adoc:54
46919 "The *rev* utility copies the specified files to standard output, reversing "
46920 "the order of characters in every line. If no files are specified, standard "
46924 #. type: Plain text
46925 #: ../text-utils/rev.1.adoc:56
46927 "This utility is a line-oriented tool and it uses in-memory allocated buffer "
46928 "for a whole wide-char line. If the input file is huge and without line "
46929 "breaks then allocating the memory for the file may be unsuccessful."
46932 #. type: Labeled list
46933 #: ../text-utils/rev.1.adoc:61
46935 #| msgid "*-V*, *--version*"
46936 msgid "*-0*, *--zero*"
46937 msgstr "*-V*, *--version*"
46939 #. type: Plain text
46940 #: ../text-utils/rev.1.adoc:63
46941 msgid "_Zero termination_. Use the byte '\\0' as line separator."
46944 #. type: Plain text
46945 #: ../text-utils/rev.1.adoc:67
46953 #. Copyright (c) 1980, 1991, 1993
46954 #. The Regents of the University of California. All rights reserved.
46955 #. Redistribution and use in source and binary forms, with or without
46956 #. modification, are permitted provided that the following conditions
46958 #. 1. Redistributions of source code must retain the above copyright
46959 #. notice, this list of conditions and the following disclaimer.
46960 #. 2. Redistributions in binary form must reproduce the above copyright
46961 #. notice, this list of conditions and the following disclaimer in the
46962 #. documentation and/or other materials provided with the distribution.
46963 #. 3. All advertising materials mentioning features or use of this software
46964 #. must display the following acknowledgement:
46965 #. This product includes software developed by the University of
46966 #. California, Berkeley and its contributors.
46967 #. 4. Neither the name of the University nor the names of its contributors
46968 #. may be used to endorse or promote products derived from this software
46969 #. without specific prior written permission.
46970 #. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46971 #. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46972 #. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46973 #. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
46974 #. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46975 #. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46976 #. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46977 #. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
46978 #. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
46979 #. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46981 #. @(#)ul.1 8.1 (Berkeley) 6/6/93
46983 #: ../text-utils/ul.1.adoc:36
46988 #. type: Plain text
46989 #: ../text-utils/ul.1.adoc:46
46990 msgid "ul - do underlining"
46993 #. type: Plain text
46994 #: ../text-utils/ul.1.adoc:50
46996 #| msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
46997 msgid "*ul* [options] [_file_...]\n"
46998 msgstr "*su* [přepínače] [*-*] [_uživatel_ [_argument_…]]\n"
47000 #. type: Plain text
47001 #: ../text-utils/ul.1.adoc:54
47003 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"
47006 #. type: Labeled list
47007 #: ../text-utils/ul.1.adoc:57
47009 #| msgid "*-f*, *--fast*"
47010 msgid "*-i*, *--indicated*"
47011 msgstr "*-f*, *--fast*"
47013 #. type: Plain text
47014 #: ../text-utils/ul.1.adoc:59
47016 "Underlining is indicated by a separate line containing appropriate dashes "
47017 "`-'; this is useful when you want to look at the underlining which is "
47018 "present in an *nroff* output stream on a crt-terminal."
47021 #. type: Labeled list
47022 #: ../text-utils/ul.1.adoc:60
47024 msgid "*-t*, *-T*, *--terminal* _terminal_"
47027 #. type: Plain text
47028 #: ../text-utils/ul.1.adoc:62
47031 #| "clears all the environment variables except *TERM* and variables "
47032 #| "specified by *--whitelist-environment*"
47034 "Override the environment variable *TERM* with the specified _terminal_ type."
47036 "vyčistí všechny proměnné prostředí kromě *TERM* a proměnných zadaných v *--"
47037 "whitelist-environment*"
47039 #. type: Plain text
47040 #: ../text-utils/ul.1.adoc:68
47041 msgid "The following environment variable is used:"
47044 #. type: Plain text
47045 #: ../text-utils/ul.1.adoc:71
47047 "The *TERM* variable is used to relate a tty device with its device "
47048 "capability description (see *terminfo*(5)). *TERM* is set at login time, "
47049 "either by the default terminal type specified in _/etc/ttys_ or as set "
47050 "during the login process by the user in their _login_ file (see *setenv*(3))."
47053 #. type: Plain text
47054 #: ../text-utils/ul.1.adoc:75
47056 #| msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
47057 msgid "The *ul* command appeared in 3.0BSD."
47058 msgstr "Předchůdce formátu souboru *fstab* se objevil v 4.0BSD."
47060 #. type: Plain text
47061 #: ../text-utils/ul.1.adoc:79
47063 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"
47066 #. type: Plain text
47067 #: ../text-utils/ul.1.adoc:88
47086 #~ "*findmnt*(8)\n"
47093 #~| msgid "*-h*, *--help*"
47094 #~ msgid "*y-*, *--shell*"
47095 #~ msgstr "*-h*, *--help*"
47098 #~| msgid "A *write* command appeared in Version 6 AT&T UNIX."
47099 #~ msgid "A *mesg* command appeared in Version 6 AT&T UNIX."
47100 #~ msgstr "Příkaz *write* se objevil v AT&T UNIXu verze 6."
47102 #~ msgid "use default options: rw, suid, dev, exec, auto, nouser, and async."
47103 #~ msgstr "použije výchozí volby: rw, suid, dev, exec, auto, nouser a async."