]> git.ipfire.org Git - thirdparty/util-linux.git/blame - po-man/util-linux-man.pot
build-sys: (po-man) force .pot file update on 'make dist'
[thirdparty/util-linux.git] / po-man / util-linux-man.pot
CommitLineData
36e96905
MB
1# SOME DESCRIPTIVE TITLE
2# Copyright (C) YEAR Free Software Foundation, Inc.
3# This file is distributed under the same license as the PACKAGE package.
4# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5#
6#, fuzzy
7msgid ""
8msgstr ""
9"Project-Id-Version: PACKAGE VERSION\n"
2bee5365 10"POT-Creation-Date: 2021-03-29 18:26+0200\n"
36e96905
MB
11"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13"Language-Team: LANGUAGE <LL@li.org>\n"
14"Language: \n"
15"MIME-Version: 1.0\n"
16"Content-Type: text/plain; charset=UTF-8\n"
17"Content-Transfer-Encoding: 8bit\n"
18
19#. type: Title ==
2bee5365 20#: ../man-common/bugreports.adoc:1
36e96905
MB
21#, no-wrap
22msgid "REPORTING BUGS"
23msgstr ""
24
25#. type: Plain text
2bee5365 26#: ../man-common/bugreports.adoc:3
36e96905
MB
27msgid ""
28"For bug reports, use the issue tracker at "
cd252c66 29"https://github.com/util-linux/util-linux/issues."
36e96905
MB
30msgstr ""
31
32#. type: Title ==
2bee5365
MB
33#: ../man-common/footer-config.adoc:1 ../man-common/footer-lib.adoc:1
34#: ../man-common/footer.adoc:1 ../login-utils/vipw.8.adoc:75
36e96905
MB
35#, no-wrap
36msgid "AVAILABILITY"
37msgstr ""
38
39#. TRANSLATORS: Keep *{configfile}* untranslated, it will be replaced with the name of the configuration file.
40#. type: Plain text
2bee5365 41#: ../man-common/footer-config.adoc:4
36e96905
MB
42#, no-wrap
43msgid ""
44"*{configfile}* is part of the util-linux package which can be downloaded "
45"from https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel "
46"Archive].\n"
47msgstr ""
48
49#. 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.
50#. type: Plain text
2bee5365 51#: ../man-common/footer-lib.adoc:4
36e96905
MB
52msgid ""
53"The *{lib}* library is part of the util-linux package since version "
54"{firstversion}. It can be downloaded from "
55"https://www.kernel.org/pub/linux/utils/util-linux/[Linux Kernel Archive]."
56msgstr ""
57
58#. TRANSLATORS: Keep *{command}* untranslated, it will be replaced with the command name.
59#. type: Plain text
2bee5365 60#: ../man-common/footer.adoc:4
36e96905
MB
61msgid ""
62"The *{command}* command is part of the util-linux package which can be "
63"downloaded from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
64"Kernel Archive]."
65msgstr ""
66
67#. type: Title ==
2bee5365 68#: ../man-common/translation.adoc:1
36e96905
MB
69#, no-wrap
70msgid "TRANSLATION"
71msgstr ""
72
73#. type: Plain text
2bee5365 74#: ../man-common/translation.adoc:6
36e96905
MB
75msgid ""
76"For the authors of this translation, see the header of the corresponding "
77"*.po file at GNU TP: "
78"http://translationproject.org/domain/util-linux-man.html"
79msgstr ""
80
81#. TRANSLATORS: Please replace %1 with the address of the mailing list of your
82#. translation team.
83#. type: Plain text
2bee5365 84#: ../man-common/translation.adoc:12
36e96905
MB
85msgid "Report man page translation bugs to: <%1>"
86msgstr ""
87
88#. addpart.8 -- man page for addpart
89#. Copyright 2007 Karel Zak <kzak@redhat.com>
90#. Copyright 2007 Red Hat, Inc.
91#. May be distributed under the GNU General Public License
92#. type: Title =
93#: ../disk-utils/addpart.8.adoc:8
94#, no-wrap
95msgid "addpart(8)"
96msgstr ""
97
98#. type: Attribute :man manual:
99#: ../disk-utils/addpart.8.adoc:10 ../disk-utils/blockdev.8.adoc:10
100#: ../disk-utils/cfdisk.8.adoc:18 ../disk-utils/delpart.8.adoc:10
101#: ../disk-utils/fdformat.8.adoc:8 ../disk-utils/fdisk.8.adoc:11
102#: ../disk-utils/fsck.8.adoc:8 ../disk-utils/fsck.cramfs.8.adoc:4
103#: ../disk-utils/fsck.minix.8.adoc:8 ../disk-utils/isosize.8.adoc:4
104#: ../disk-utils/mkfs.8.adoc:4 ../disk-utils/mkfs.bfs.8.adoc:8
105#: ../disk-utils/mkfs.cramfs.8.adoc:4 ../disk-utils/mkfs.minix.8.adoc:11
106#: ../disk-utils/mkswap.8.adoc:8 ../disk-utils/partx.8.adoc:11
107#: ../disk-utils/raw.8.adoc:4 ../disk-utils/resizepart.8.adoc:10
108#: ../disk-utils/sfdisk.8.adoc:17 ../disk-utils/swaplabel.8.adoc:8
109#: ../login-utils/nologin.8.adoc:4 ../login-utils/sulogin.8.adoc:22
110#: ../login-utils/vipw.8.adoc:38 ../misc-utils/blkid.8.adoc:6
111#: ../misc-utils/findfs.8.adoc:6 ../misc-utils/findmnt.8.adoc:4
112#: ../misc-utils/lsblk.8.adoc:4 ../misc-utils/lslocks.8.adoc:14
113#: ../misc-utils/uuidd.8.adoc:8 ../misc-utils/wipefs.8.adoc:6
114#: ../sys-utils/blkdiscard.8.adoc:4 ../sys-utils/blkzone.8.adoc:4
115#: ../sys-utils/chcpu.8.adoc:4 ../sys-utils/chmem.8.adoc:4
116#: ../sys-utils/ctrlaltdel.8.adoc:8 ../sys-utils/fsfreeze.8.adoc:4
117#: ../sys-utils/fstrim.8.adoc:4 ../sys-utils/hwclock.8.adoc:11
118#: ../sys-utils/ldattach.8.adoc:8 ../sys-utils/losetup.8.adoc:4
119#: ../sys-utils/lsns.8.adoc:9 ../sys-utils/mount.8.adoc:34
120#: ../sys-utils/pivot_root.8.adoc:4 ../sys-utils/readprofile.8.adoc:4
121#: ../sys-utils/rfkill.8.adoc:4 ../sys-utils/rtcwake.8.adoc:4
122#: ../sys-utils/setarch.8.adoc:4 ../sys-utils/swapon.8.adoc:4
123#: ../sys-utils/switch_root.8.adoc:4 ../sys-utils/tunelp.8.adoc:4
124#: ../sys-utils/umount.8.adoc:29 ../sys-utils/wdctl.8.adoc:4
125#: ../sys-utils/zramctl.8.adoc:4 ../term-utils/agetty.8.adoc:4
126#, no-wrap
127msgid "System Administration"
128msgstr ""
129
130#. type: Title ==
131#: ../disk-utils/addpart.8.adoc:15 ../disk-utils/blockdev.8.adoc:15
132#: ../disk-utils/cfdisk.8.adoc:23 ../disk-utils/delpart.8.adoc:15
133#: ../disk-utils/fdformat.8.adoc:13 ../disk-utils/fdisk.8.adoc:17
134#: ../disk-utils/fsck.8.adoc:13 ../disk-utils/fsck.cramfs.8.adoc:9
135#: ../disk-utils/fsck.minix.8.adoc:13 ../disk-utils/isosize.8.adoc:9
136#: ../disk-utils/mkfs.8.adoc:9 ../disk-utils/mkfs.bfs.8.adoc:13
137#: ../disk-utils/mkfs.cramfs.8.adoc:9 ../disk-utils/mkfs.minix.8.adoc:16
138#: ../disk-utils/mkswap.8.adoc:13 ../disk-utils/partx.8.adoc:16
139#: ../disk-utils/raw.8.adoc:9 ../disk-utils/resizepart.8.adoc:15
140#: ../disk-utils/sfdisk.8.adoc:24 ../disk-utils/swaplabel.8.adoc:13
141#: ../lib/terminal-colors.d.5.adoc:17 ../libblkid/libblkid.3.adoc:16
142#: ../libuuid/man/uuid.3.adoc:41 ../libuuid/man/uuid_clear.3.adoc:41
143#: ../libuuid/man/uuid_compare.3.adoc:41 ../libuuid/man/uuid_copy.3.adoc:41
144#: ../libuuid/man/uuid_generate.3.adoc:43 ../libuuid/man/uuid_is_null.3.adoc:41
145#: ../libuuid/man/uuid_parse.3.adoc:41 ../libuuid/man/uuid_time.3.adoc:41
146#: ../libuuid/man/uuid_unparse.3.adoc:41 ../login-utils/chfn.1.adoc:17
147#: ../login-utils/chsh.1.adoc:17 ../login-utils/last.1.adoc:26
148#: ../login-utils/login.1.adoc:13 ../login-utils/lslogins.1.adoc:11
149#: ../login-utils/newgrp.1.adoc:11 ../login-utils/nologin.8.adoc:9
150#: ../login-utils/runuser.1.adoc:9 ../login-utils/su.1.adoc:9
151#: ../login-utils/sulogin.8.adoc:28 ../login-utils/utmpdump.1.adoc:26
152#: ../login-utils/vipw.8.adoc:43 ../misc-utils/blkid.8.adoc:12
153#: ../misc-utils/cal.1.adoc:47 ../misc-utils/fincore.1.adoc:15
154#: ../misc-utils/findfs.8.adoc:11 ../misc-utils/findmnt.8.adoc:10
155#: ../misc-utils/getopt.1.adoc:10 ../misc-utils/hardlink.1.adoc:15
156#: ../misc-utils/kill.1.adoc:14 ../misc-utils/logger.1.adoc:43
157#: ../misc-utils/look.1.adoc:43 ../misc-utils/lsblk.8.adoc:9
158#: ../misc-utils/lslocks.8.adoc:20 ../misc-utils/mcookie.1.adoc:11
159#: ../misc-utils/namei.1.adoc:9 ../misc-utils/rename.1.adoc:11
160#: ../misc-utils/uuidd.8.adoc:13 ../misc-utils/uuidgen.1.adoc:13
161#: ../misc-utils/uuidparse.1.adoc:11 ../misc-utils/whereis.1.adoc:43
162#: ../misc-utils/wipefs.8.adoc:11 ../schedutils/chrt.1.adoc:34
163#: ../schedutils/ionice.1.adoc:10 ../schedutils/taskset.1.adoc:33
164#: ../schedutils/uclampset.1.adoc:33 ../sys-utils/adjtime_config.5.adoc:9
165#: ../sys-utils/blkdiscard.8.adoc:9 ../sys-utils/blkzone.8.adoc:9
166#: ../sys-utils/chcpu.8.adoc:9 ../sys-utils/chmem.8.adoc:9
167#: ../sys-utils/choom.1.adoc:9 ../sys-utils/ctrlaltdel.8.adoc:13
168#: ../sys-utils/dmesg.1.adoc:13 ../sys-utils/eject.1.adoc:17
b81d5971 169#: ../sys-utils/fallocate.1.adoc:9 ../sys-utils/flock.1.adoc:34
36e96905 170#: ../sys-utils/fsfreeze.8.adoc:9 ../sys-utils/fstab.5.adoc:43
9b7051d5 171#: ../sys-utils/fstrim.8.adoc:9 ../sys-utils/hwclock.8.adoc:17
36e96905
MB
172#: ../sys-utils/ipcmk.1.adoc:13 ../sys-utils/ipcrm.1.adoc:14
173#: ../sys-utils/ipcs.1.adoc:13 ../sys-utils/irqtop.1.adoc:9
174#: ../sys-utils/ldattach.8.adoc:13 ../sys-utils/losetup.8.adoc:9
175#: ../sys-utils/lscpu.1.adoc:9 ../sys-utils/lsipc.1.adoc:9
176#: ../sys-utils/lsirq.1.adoc:9 ../sys-utils/lsmem.1.adoc:9
177#: ../sys-utils/lsns.8.adoc:14 ../sys-utils/mount.8.adoc:40
178#: ../sys-utils/mountpoint.1.adoc:9 ../sys-utils/nsenter.1.adoc:9
179#: ../sys-utils/pivot_root.8.adoc:9 ../sys-utils/prlimit.1.adoc:15
180#: ../sys-utils/readprofile.8.adoc:9 ../sys-utils/renice.1.adoc:43
181#: ../sys-utils/rfkill.8.adoc:9 ../sys-utils/rtcwake.8.adoc:9
182#: ../sys-utils/setarch.8.adoc:9 ../sys-utils/setpriv.1.adoc:9
183#: ../sys-utils/setsid.1.adoc:11 ../sys-utils/swapon.8.adoc:9
184#: ../sys-utils/switch_root.8.adoc:9 ../sys-utils/tunelp.8.adoc:9
185#: ../sys-utils/umount.8.adoc:34 ../sys-utils/unshare.1.adoc:9
186#: ../sys-utils/wdctl.8.adoc:9 ../sys-utils/zramctl.8.adoc:9
187#: ../term-utils/agetty.8.adoc:9 ../term-utils/mesg.1.adoc:43
5db1d29a 188#: ../term-utils/script.1.adoc:44 ../term-utils/scriptlive.1.adoc:10
36e96905
MB
189#: ../term-utils/scriptreplay.1.adoc:10 ../term-utils/setterm.1.adoc:16
190#: ../term-utils/wall.1.adoc:44 ../term-utils/write.1.adoc:46
191#: ../text-utils/col.1.adoc:46 ../text-utils/colcrt.1.adoc:44
192#: ../text-utils/colrm.1.adoc:43 ../text-utils/column.1.adoc:43
193#: ../text-utils/hexdump.1.adoc:45 ../text-utils/line.1.adoc:10
194#: ../text-utils/more.1.adoc:46 ../text-utils/pg.1.adoc:10
195#: ../text-utils/rev.1.adoc:43 ../text-utils/ul.1.adoc:43
196#, no-wrap
197msgid "NAME"
198msgstr ""
199
200#. type: Plain text
201#: ../disk-utils/addpart.8.adoc:18
202msgid "addpart - tell the kernel about the existence of a partition"
203msgstr ""
204
205#. type: Title ==
206#: ../disk-utils/addpart.8.adoc:19 ../disk-utils/blockdev.8.adoc:19
207#: ../disk-utils/cfdisk.8.adoc:27 ../disk-utils/delpart.8.adoc:19
208#: ../disk-utils/fdformat.8.adoc:17 ../disk-utils/fdisk.8.adoc:21
209#: ../disk-utils/fsck.8.adoc:17 ../disk-utils/fsck.cramfs.8.adoc:13
210#: ../disk-utils/fsck.minix.8.adoc:17 ../disk-utils/isosize.8.adoc:13
211#: ../disk-utils/mkfs.8.adoc:13 ../disk-utils/mkfs.bfs.8.adoc:17
212#: ../disk-utils/mkfs.cramfs.8.adoc:13 ../disk-utils/mkfs.minix.8.adoc:20
213#: ../disk-utils/mkswap.8.adoc:17 ../disk-utils/partx.8.adoc:20
214#: ../disk-utils/raw.8.adoc:13 ../disk-utils/resizepart.8.adoc:19
215#: ../disk-utils/sfdisk.8.adoc:28 ../disk-utils/swaplabel.8.adoc:17
216#: ../lib/terminal-colors.d.5.adoc:21 ../libblkid/libblkid.3.adoc:20
217#: ../libuuid/man/uuid.3.adoc:45 ../libuuid/man/uuid_clear.3.adoc:45
218#: ../libuuid/man/uuid_compare.3.adoc:45 ../libuuid/man/uuid_copy.3.adoc:45
219#: ../libuuid/man/uuid_generate.3.adoc:47 ../libuuid/man/uuid_is_null.3.adoc:45
220#: ../libuuid/man/uuid_parse.3.adoc:45 ../libuuid/man/uuid_time.3.adoc:45
221#: ../libuuid/man/uuid_unparse.3.adoc:45 ../login-utils/chfn.1.adoc:21
222#: ../login-utils/chsh.1.adoc:21 ../login-utils/last.1.adoc:30
223#: ../login-utils/login.1.adoc:17 ../login-utils/lslogins.1.adoc:15
224#: ../login-utils/newgrp.1.adoc:15 ../login-utils/nologin.8.adoc:13
225#: ../login-utils/runuser.1.adoc:13 ../login-utils/su.1.adoc:13
226#: ../login-utils/sulogin.8.adoc:32 ../login-utils/utmpdump.1.adoc:30
227#: ../login-utils/vipw.8.adoc:47 ../misc-utils/blkid.8.adoc:16
228#: ../misc-utils/cal.1.adoc:51 ../misc-utils/fincore.1.adoc:19
229#: ../misc-utils/findfs.8.adoc:15 ../misc-utils/findmnt.8.adoc:14
230#: ../misc-utils/getopt.1.adoc:14 ../misc-utils/hardlink.1.adoc:19
231#: ../misc-utils/kill.1.adoc:18 ../misc-utils/logger.1.adoc:47
232#: ../misc-utils/look.1.adoc:47 ../misc-utils/lsblk.8.adoc:13
233#: ../misc-utils/lslocks.8.adoc:24 ../misc-utils/mcookie.1.adoc:15
234#: ../misc-utils/namei.1.adoc:13 ../misc-utils/rename.1.adoc:15
235#: ../misc-utils/uuidd.8.adoc:17 ../misc-utils/uuidgen.1.adoc:17
236#: ../misc-utils/uuidparse.1.adoc:15 ../misc-utils/whereis.1.adoc:47
237#: ../misc-utils/wipefs.8.adoc:15 ../schedutils/chrt.1.adoc:38
238#: ../schedutils/ionice.1.adoc:14 ../schedutils/taskset.1.adoc:37
239#: ../schedutils/uclampset.1.adoc:38 ../sys-utils/adjtime_config.5.adoc:13
240#: ../sys-utils/blkdiscard.8.adoc:13 ../sys-utils/blkzone.8.adoc:13
241#: ../sys-utils/chcpu.8.adoc:13 ../sys-utils/chmem.8.adoc:13
242#: ../sys-utils/ctrlaltdel.8.adoc:17 ../sys-utils/dmesg.1.adoc:17
b81d5971 243#: ../sys-utils/fallocate.1.adoc:13 ../sys-utils/flock.1.adoc:38
36e96905 244#: ../sys-utils/fsfreeze.8.adoc:13 ../sys-utils/fstab.5.adoc:47
9b7051d5 245#: ../sys-utils/fstrim.8.adoc:13 ../sys-utils/hwclock.8.adoc:21
36e96905
MB
246#: ../sys-utils/ipcmk.1.adoc:17 ../sys-utils/ipcrm.1.adoc:18
247#: ../sys-utils/ipcs.1.adoc:17 ../sys-utils/irqtop.1.adoc:13
248#: ../sys-utils/ldattach.8.adoc:17 ../sys-utils/losetup.8.adoc:13
249#: ../sys-utils/lscpu.1.adoc:13 ../sys-utils/lsipc.1.adoc:13
250#: ../sys-utils/lsirq.1.adoc:13 ../sys-utils/lsmem.1.adoc:13
251#: ../sys-utils/lsns.8.adoc:18 ../sys-utils/mount.8.adoc:44
252#: ../sys-utils/mountpoint.1.adoc:13 ../sys-utils/nsenter.1.adoc:13
253#: ../sys-utils/pivot_root.8.adoc:13 ../sys-utils/prlimit.1.adoc:19
254#: ../sys-utils/readprofile.8.adoc:13 ../sys-utils/renice.1.adoc:47
255#: ../sys-utils/rfkill.8.adoc:13 ../sys-utils/rtcwake.8.adoc:13
256#: ../sys-utils/setarch.8.adoc:13 ../sys-utils/setpriv.1.adoc:13
257#: ../sys-utils/setsid.1.adoc:15 ../sys-utils/swapon.8.adoc:13
258#: ../sys-utils/switch_root.8.adoc:13 ../sys-utils/tunelp.8.adoc:13
259#: ../sys-utils/umount.8.adoc:38 ../sys-utils/unshare.1.adoc:13
260#: ../sys-utils/wdctl.8.adoc:13 ../sys-utils/zramctl.8.adoc:13
261#: ../term-utils/agetty.8.adoc:13 ../term-utils/mesg.1.adoc:47
5db1d29a 262#: ../term-utils/script.1.adoc:48 ../term-utils/scriptlive.1.adoc:14
36e96905
MB
263#: ../term-utils/scriptreplay.1.adoc:14 ../term-utils/setterm.1.adoc:20
264#: ../term-utils/wall.1.adoc:48 ../text-utils/col.1.adoc:50
265#: ../text-utils/colcrt.1.adoc:48 ../text-utils/colrm.1.adoc:47
266#: ../text-utils/column.1.adoc:47 ../text-utils/line.1.adoc:14
267#: ../text-utils/more.1.adoc:50 ../text-utils/pg.1.adoc:14
268#: ../text-utils/rev.1.adoc:47 ../text-utils/ul.1.adoc:47
269#, no-wrap
270msgid "SYNOPSIS"
271msgstr ""
272
273#. type: Plain text
274#: ../disk-utils/addpart.8.adoc:22
275#, no-wrap
276msgid "*addpart* _device partition start length_\n"
277msgstr ""
278
279#. type: Title ==
280#: ../disk-utils/addpart.8.adoc:23 ../disk-utils/blockdev.8.adoc:27
281#: ../disk-utils/cfdisk.8.adoc:31 ../disk-utils/delpart.8.adoc:23
282#: ../disk-utils/fdformat.8.adoc:21 ../disk-utils/fdisk.8.adoc:27
283#: ../disk-utils/fsck.8.adoc:21 ../disk-utils/fsck.cramfs.8.adoc:17
284#: ../disk-utils/fsck.minix.8.adoc:21 ../disk-utils/isosize.8.adoc:17
285#: ../disk-utils/mkfs.8.adoc:17 ../disk-utils/mkfs.bfs.8.adoc:21
286#: ../disk-utils/mkfs.cramfs.8.adoc:17 ../disk-utils/mkfs.minix.8.adoc:24
287#: ../disk-utils/mkswap.8.adoc:21 ../disk-utils/partx.8.adoc:26
288#: ../disk-utils/raw.8.adoc:23 ../disk-utils/resizepart.8.adoc:23
289#: ../disk-utils/sfdisk.8.adoc:34 ../disk-utils/swaplabel.8.adoc:21
290#: ../lib/terminal-colors.d.5.adoc:25 ../libblkid/libblkid.3.adoc:26
291#: ../libuuid/man/uuid.3.adoc:49 ../libuuid/man/uuid_clear.3.adoc:51
292#: ../libuuid/man/uuid_compare.3.adoc:51 ../libuuid/man/uuid_copy.3.adoc:51
293#: ../libuuid/man/uuid_generate.3.adoc:58 ../libuuid/man/uuid_is_null.3.adoc:51
294#: ../libuuid/man/uuid_parse.3.adoc:52 ../libuuid/man/uuid_time.3.adoc:51
295#: ../libuuid/man/uuid_unparse.3.adoc:53 ../login-utils/chfn.1.adoc:25
296#: ../login-utils/chsh.1.adoc:25 ../login-utils/last.1.adoc:36
297#: ../login-utils/login.1.adoc:21 ../login-utils/lslogins.1.adoc:19
298#: ../login-utils/newgrp.1.adoc:19 ../login-utils/nologin.8.adoc:17
299#: ../login-utils/runuser.1.adoc:19 ../login-utils/su.1.adoc:17
300#: ../login-utils/sulogin.8.adoc:36 ../login-utils/utmpdump.1.adoc:34
301#: ../login-utils/vipw.8.adoc:53 ../misc-utils/blkid.8.adoc:26
302#: ../misc-utils/cal.1.adoc:57 ../misc-utils/fincore.1.adoc:23
303#: ../misc-utils/findfs.8.adoc:19 ../misc-utils/findmnt.8.adoc:22
304#: ../misc-utils/getopt.1.adoc:20 ../misc-utils/hardlink.1.adoc:23
305#: ../misc-utils/kill.1.adoc:25 ../misc-utils/logger.1.adoc:51
306#: ../misc-utils/look.1.adoc:51 ../misc-utils/lsblk.8.adoc:17
307#: ../misc-utils/lslocks.8.adoc:28 ../misc-utils/mcookie.1.adoc:19
308#: ../misc-utils/namei.1.adoc:17 ../misc-utils/rename.1.adoc:19
309#: ../misc-utils/uuidd.8.adoc:21 ../misc-utils/uuidgen.1.adoc:21
310#: ../misc-utils/uuidparse.1.adoc:19 ../misc-utils/whereis.1.adoc:51
311#: ../misc-utils/wipefs.8.adoc:24 ../schedutils/chrt.1.adoc:44
312#: ../schedutils/ionice.1.adoc:24 ../schedutils/taskset.1.adoc:43
313#: ../schedutils/uclampset.1.adoc:44 ../sys-utils/adjtime_config.5.adoc:17
314#: ../sys-utils/blkdiscard.8.adoc:17 ../sys-utils/blkzone.8.adoc:17
315#: ../sys-utils/chcpu.8.adoc:21 ../sys-utils/chmem.8.adoc:17
316#: ../sys-utils/choom.1.adoc:19 ../sys-utils/ctrlaltdel.8.adoc:21
317#: ../sys-utils/dmesg.1.adoc:31 ../sys-utils/eject.1.adoc:23
b81d5971 318#: ../sys-utils/fallocate.1.adoc:21 ../sys-utils/flock.1.adoc:46
36e96905 319#: ../sys-utils/fsfreeze.8.adoc:17 ../sys-utils/fstab.5.adoc:51
9b7051d5 320#: ../sys-utils/fstrim.8.adoc:17 ../sys-utils/hwclock.8.adoc:25
36e96905
MB
321#: ../sys-utils/ipcmk.1.adoc:21 ../sys-utils/ipcrm.1.adoc:24
322#: ../sys-utils/ipcs.1.adoc:21 ../sys-utils/irqtop.1.adoc:17
323#: ../sys-utils/ldattach.8.adoc:21 ../sys-utils/losetup.8.adoc:39
324#: ../sys-utils/lscpu.1.adoc:17 ../sys-utils/lsipc.1.adoc:17
325#: ../sys-utils/lsirq.1.adoc:17 ../sys-utils/lsmem.1.adoc:17
326#: ../sys-utils/lsns.8.adoc:22 ../sys-utils/mount.8.adoc:60
327#: ../sys-utils/mountpoint.1.adoc:19 ../sys-utils/nsenter.1.adoc:17
328#: ../sys-utils/pivot_root.8.adoc:17 ../sys-utils/prlimit.1.adoc:25
329#: ../sys-utils/readprofile.8.adoc:21 ../sys-utils/renice.1.adoc:51
330#: ../sys-utils/rfkill.8.adoc:17 ../sys-utils/rtcwake.8.adoc:17
331#: ../sys-utils/setarch.8.adoc:21 ../sys-utils/setpriv.1.adoc:17
332#: ../sys-utils/setsid.1.adoc:19 ../sys-utils/swapon.8.adoc:19
333#: ../sys-utils/switch_root.8.adoc:19 ../sys-utils/tunelp.8.adoc:17
334#: ../sys-utils/umount.8.adoc:46 ../sys-utils/unshare.1.adoc:17
335#: ../sys-utils/wdctl.8.adoc:17 ../sys-utils/zramctl.8.adoc:31
336#: ../term-utils/agetty.8.adoc:17 ../term-utils/mesg.1.adoc:51
5db1d29a 337#: ../term-utils/script.1.adoc:52 ../term-utils/scriptlive.1.adoc:18
36e96905
MB
338#: ../term-utils/scriptreplay.1.adoc:18 ../term-utils/setterm.1.adoc:24
339#: ../term-utils/wall.1.adoc:52 ../term-utils/write.1.adoc:52
340#: ../text-utils/col.1.adoc:54 ../text-utils/colcrt.1.adoc:52
341#: ../text-utils/colrm.1.adoc:51 ../text-utils/column.1.adoc:51
342#: ../text-utils/hexdump.1.adoc:51 ../text-utils/line.1.adoc:18
343#: ../text-utils/more.1.adoc:54 ../text-utils/pg.1.adoc:18
344#: ../text-utils/rev.1.adoc:51 ../text-utils/ul.1.adoc:51
345#, no-wrap
346msgid "DESCRIPTION"
347msgstr ""
348
349#. type: Plain text
350#: ../disk-utils/addpart.8.adoc:26
351#, no-wrap
352msgid ""
353"*addpart* tells the Linux kernel about the existence of the specified "
354"partition. The command is a simple wrapper around the \"add partition\" "
355"ioctl.\n"
356msgstr ""
357
358#. type: Plain text
359#: ../disk-utils/addpart.8.adoc:28 ../disk-utils/delpart.8.adoc:28
360#: ../disk-utils/resizepart.8.adoc:28
361msgid "This command doesn't manipulate partitions on a block device."
362msgstr ""
363
364#. type: Title ==
365#: ../disk-utils/addpart.8.adoc:29 ../disk-utils/resizepart.8.adoc:29
366#: ../misc-utils/cal.1.adoc:126
367#, no-wrap
368msgid "PARAMETERS"
369msgstr ""
370
371#. type: Labeled list
372#: ../disk-utils/addpart.8.adoc:31 ../disk-utils/resizepart.8.adoc:31
373#, no-wrap
374msgid "_device_"
375msgstr ""
376
377#. type: Plain text
378#: ../disk-utils/addpart.8.adoc:33 ../disk-utils/resizepart.8.adoc:33
379msgid "The disk device."
380msgstr ""
381
382#. type: Labeled list
383#: ../disk-utils/addpart.8.adoc:34 ../disk-utils/resizepart.8.adoc:34
384#, no-wrap
385msgid "_partition_"
386msgstr ""
387
388#. type: Plain text
389#: ../disk-utils/addpart.8.adoc:36 ../disk-utils/resizepart.8.adoc:36
390msgid "The partition number."
391msgstr ""
392
393#. type: Labeled list
394#: ../disk-utils/addpart.8.adoc:37
395#, no-wrap
396msgid "_start_"
397msgstr ""
398
399#. type: Plain text
400#: ../disk-utils/addpart.8.adoc:39
401msgid "The beginning of the partition (in 512-byte sectors)."
402msgstr ""
403
404#. type: Labeled list
405#: ../disk-utils/addpart.8.adoc:40 ../disk-utils/resizepart.8.adoc:37
406#, no-wrap
407msgid "_length_"
408msgstr ""
409
410#. type: Plain text
411#: ../disk-utils/addpart.8.adoc:42
412msgid "The length of the partition (in 512-byte sectors)."
413msgstr ""
414
415#. type: Title ==
416#: ../disk-utils/addpart.8.adoc:43 ../disk-utils/cfdisk.8.adoc:154
417#: ../disk-utils/delpart.8.adoc:29 ../disk-utils/fdformat.8.adoc:78
418#: ../disk-utils/fdisk.8.adoc:224 ../disk-utils/fsck.8.adoc:159
419#: ../disk-utils/fsck.cramfs.8.adoc:55 ../disk-utils/fsck.minix.8.adoc:102
420#: ../disk-utils/mkfs.8.adoc:56 ../disk-utils/mkfs.bfs.8.adoc:57
421#: ../disk-utils/mkfs.cramfs.8.adoc:78 ../disk-utils/mkfs.minix.8.adoc:89
422#: ../disk-utils/mkswap.8.adoc:103 ../disk-utils/partx.8.adoc:139
423#: ../disk-utils/resizepart.8.adoc:40 ../disk-utils/sfdisk.8.adoc:410
424#: ../disk-utils/swaplabel.8.adoc:49 ../libblkid/libblkid.3.adoc:56
425#: ../libuuid/man/uuid.3.adoc:63 ../libuuid/man/uuid_clear.3.adoc:59
426#: ../libuuid/man/uuid_compare.3.adoc:63 ../libuuid/man/uuid_copy.3.adoc:63
427#: ../libuuid/man/uuid_generate.3.adoc:84 ../libuuid/man/uuid_is_null.3.adoc:59
428#: ../libuuid/man/uuid_parse.3.adoc:70 ../libuuid/man/uuid_time.3.adoc:63
429#: ../libuuid/man/uuid_unparse.3.adoc:67 ../login-utils/chfn.1.adoc:77
430#: ../login-utils/chsh.1.adoc:59 ../login-utils/last.1.adoc:120
431#: ../login-utils/login.1.adoc:163 ../login-utils/lslogins.1.adoc:132
432#: ../login-utils/newgrp.1.adoc:34 ../login-utils/nologin.8.adoc:71
433#: ../login-utils/runuser.1.adoc:131 ../login-utils/su.1.adoc:145
434#: ../login-utils/utmpdump.1.adoc:79 ../login-utils/vipw.8.adoc:68
435#: ../misc-utils/blkid.8.adoc:178 ../misc-utils/fincore.1.adoc:57
2bee5365 436#: ../misc-utils/findfs.8.adoc:65 ../misc-utils/findmnt.8.adoc:219
36e96905
MB
437#: ../misc-utils/getopt.1.adoc:153 ../misc-utils/kill.1.adoc:107
438#: ../misc-utils/logger.1.adoc:242 ../misc-utils/look.1.adoc:105
439#: ../misc-utils/lsblk.8.adoc:166 ../misc-utils/lslocks.8.adoc:112
440#: ../misc-utils/mcookie.1.adoc:58 ../misc-utils/namei.1.adoc:75
441#: ../misc-utils/rename.1.adoc:98 ../misc-utils/uuidd.8.adoc:85
442#: ../misc-utils/uuidgen.1.adoc:70 ../misc-utils/uuidparse.1.adoc:72
443#: ../misc-utils/wipefs.8.adoc:107 ../schedutils/chrt.1.adoc:142
444#: ../schedutils/ionice.1.adoc:95 ../schedutils/taskset.1.adoc:113
445#: ../schedutils/uclampset.1.adoc:129 ../sys-utils/adjtime_config.5.adoc:54
446#: ../sys-utils/blkdiscard.8.adoc:62 ../sys-utils/blkzone.8.adoc:112
447#: ../sys-utils/chcpu.8.adoc:80 ../sys-utils/chmem.8.adoc:85
448#: ../sys-utils/choom.1.adoc:55 ../sys-utils/ctrlaltdel.8.adoc:51
449#: ../sys-utils/dmesg.1.adoc:187 ../sys-utils/eject.1.adoc:121
b81d5971 450#: ../sys-utils/fallocate.1.adoc:90 ../sys-utils/flock.1.adoc:129
36e96905 451#: ../sys-utils/fsfreeze.8.adoc:57 ../sys-utils/fstab.5.adoc:135
9b7051d5 452#: ../sys-utils/fstrim.8.adoc:85 ../sys-utils/hwclock.8.adoc:372
36e96905
MB
453#: ../sys-utils/ipcmk.1.adoc:53 ../sys-utils/ipcrm.1.adoc:72
454#: ../sys-utils/ipcs.1.adoc:91 ../sys-utils/ldattach.8.adoc:122
455#: ../sys-utils/lscpu.1.adoc:162 ../sys-utils/lsipc.1.adoc:107
456#: ../sys-utils/lsmem.1.adoc:76 ../sys-utils/lsns.8.adoc:76
457#: ../sys-utils/mount.8.adoc:1456 ../sys-utils/mountpoint.1.adoc:69
3a213557 458#: ../sys-utils/nsenter.1.adoc:138 ../sys-utils/pivot_root.8.adoc:67
36e96905
MB
459#: ../sys-utils/prlimit.1.adoc:139 ../sys-utils/renice.1.adoc:96
460#: ../sys-utils/rfkill.8.adoc:82 ../sys-utils/rtcwake.8.adoc:134
461#: ../sys-utils/setarch.8.adoc:94 ../sys-utils/setpriv.1.adoc:118
462#: ../sys-utils/setsid.1.adoc:44 ../sys-utils/swapon.8.adoc:168
463#: ../sys-utils/switch_root.8.adoc:51 ../sys-utils/umount.8.adoc:180
464#: ../sys-utils/unshare.1.adoc:236 ../sys-utils/zramctl.8.adoc:104
465#: ../term-utils/mesg.1.adoc:99 ../term-utils/script.1.adoc:166
5db1d29a 466#: ../term-utils/scriptlive.1.adoc:79 ../term-utils/scriptreplay.1.adoc:99
36e96905
MB
467#: ../term-utils/setterm.1.adoc:171 ../term-utils/wall.1.adoc:85
468#: ../term-utils/write.1.adoc:84 ../text-utils/col.1.adoc:127
469#: ../text-utils/colcrt.1.adoc:96 ../text-utils/colrm.1.adoc:71
470#: ../text-utils/column.1.adoc:198 ../text-utils/line.1.adoc:22
471#: ../text-utils/more.1.adoc:196 ../text-utils/pg.1.adoc:146
472#: ../text-utils/rev.1.adoc:65 ../text-utils/ul.1.adoc:84
473#, no-wrap
474msgid "SEE ALSO"
475msgstr ""
476
477#. type: Plain text
478#: ../disk-utils/addpart.8.adoc:50
479#, no-wrap
480msgid ""
481"*delpart*(8),\n"
482"*fdisk*(8),\n"
483"*parted*(8),\n"
484"*partprobe*(8),\n"
485"*partx*(8)\n"
486msgstr ""
487
488#. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
489#. Copyright 2007 Karel Zak <kzak@redhat.com>
490#
491#. May be distributed under the GNU General Public License
492#. type: Title =
493#: ../disk-utils/blockdev.8.adoc:8
494#, no-wrap
495msgid "blockdev(8)"
496msgstr ""
497
498#. type: Plain text
499#: ../disk-utils/blockdev.8.adoc:18
500msgid "blockdev - call block device ioctls from the command line"
501msgstr ""
502
503#. type: Plain text
504#: ../disk-utils/blockdev.8.adoc:22
505#, no-wrap
506msgid "*blockdev* [*-q*] [*-v*] _command_ [_command_...] _device_ [_device_...]\n"
507msgstr ""
508
509#. type: Plain text
510#: ../disk-utils/blockdev.8.adoc:24
511#, no-wrap
512msgid "*blockdev* *--report* [_device_...]\n"
513msgstr ""
514
515#. type: Plain text
516#: ../disk-utils/blockdev.8.adoc:26
517#, no-wrap
518msgid "*blockdev* *-h*|*-V*\n"
519msgstr ""
520
521#. type: Plain text
522#: ../disk-utils/blockdev.8.adoc:30
523msgid ""
524"The utility *blockdev* allows one to call block device ioctls from the "
525"command line."
526msgstr ""
527
528#. type: Title ==
529#: ../disk-utils/blockdev.8.adoc:31 ../disk-utils/cfdisk.8.adoc:45
530#: ../disk-utils/fdformat.8.adoc:50 ../disk-utils/fdisk.8.adoc:40
531#: ../disk-utils/fsck.8.adoc:52 ../disk-utils/fsck.cramfs.8.adoc:21
532#: ../disk-utils/fsck.minix.8.adoc:45 ../disk-utils/isosize.8.adoc:21
533#: ../disk-utils/mkfs.8.adoc:27 ../disk-utils/mkfs.bfs.8.adoc:27
534#: ../disk-utils/mkfs.cramfs.8.adoc:33 ../disk-utils/mkfs.minix.8.adoc:41
535#: ../disk-utils/mkswap.8.adoc:39 ../disk-utils/partx.8.adoc:40
536#: ../disk-utils/raw.8.adoc:37 ../disk-utils/sfdisk.8.adoc:136
537#: ../disk-utils/swaplabel.8.adoc:29 ../login-utils/chfn.1.adoc:35
538#: ../login-utils/chsh.1.adoc:31 ../login-utils/last.1.adoc:46
539#: ../login-utils/login.1.adoc:37 ../login-utils/lslogins.1.adoc:27
540#: ../login-utils/nologin.8.adoc:25 ../login-utils/runuser.1.adoc:31
541#: ../login-utils/su.1.adoc:31 ../login-utils/sulogin.8.adoc:50
542#: ../login-utils/utmpdump.1.adoc:38 ../misc-utils/blkid.8.adoc:42
543#: ../misc-utils/cal.1.adoc:67 ../misc-utils/fincore.1.adoc:29
2bee5365 544#: ../misc-utils/findmnt.8.adoc:32 ../misc-utils/getopt.1.adoc:30
36e96905
MB
545#: ../misc-utils/hardlink.1.adoc:27 ../misc-utils/kill.1.adoc:53
546#: ../misc-utils/logger.1.adoc:57 ../misc-utils/look.1.adoc:57
547#: ../misc-utils/lsblk.8.adoc:29 ../misc-utils/lslocks.8.adoc:34
548#: ../misc-utils/mcookie.1.adoc:29 ../misc-utils/namei.1.adoc:39
549#: ../misc-utils/rename.1.adoc:23 ../misc-utils/uuidd.8.adoc:25
550#: ../misc-utils/uuidgen.1.adoc:29 ../misc-utils/uuidparse.1.adoc:48
551#: ../misc-utils/whereis.1.adoc:71 ../misc-utils/wipefs.8.adoc:38
552#: ../schedutils/chrt.1.adoc:90 ../schedutils/ionice.1.adoc:46
553#: ../schedutils/taskset.1.adoc:69 ../schedutils/uclampset.1.adoc:62
554#: ../sys-utils/blkdiscard.8.adoc:27 ../sys-utils/blkzone.8.adoc:82
555#: ../sys-utils/chcpu.8.adoc:27 ../sys-utils/chmem.8.adoc:35
556#: ../sys-utils/choom.1.adoc:23 ../sys-utils/ctrlaltdel.8.adoc:35
557#: ../sys-utils/dmesg.1.adoc:37 ../sys-utils/eject.1.adoc:35
b81d5971 558#: ../sys-utils/fallocate.1.adoc:27 ../sys-utils/flock.1.adoc:54
36e96905 559#: ../sys-utils/fsfreeze.8.adoc:29 ../sys-utils/fstrim.8.adoc:27
9b7051d5 560#: ../sys-utils/hwclock.8.adoc:105 ../sys-utils/ipcmk.1.adoc:25
36e96905
MB
561#: ../sys-utils/ipcrm.1.adoc:36 ../sys-utils/ipcs.1.adoc:25
562#: ../sys-utils/irqtop.1.adoc:23 ../sys-utils/ldattach.8.adoc:74
563#: ../sys-utils/losetup.8.adoc:49 ../sys-utils/lscpu.1.adoc:84
564#: ../sys-utils/lsipc.1.adoc:21 ../sys-utils/lsirq.1.adoc:23
565#: ../sys-utils/lsmem.1.adoc:31 ../sys-utils/lsns.8.adoc:32
566#: ../sys-utils/mountpoint.1.adoc:23 ../sys-utils/nsenter.1.adoc:47
3a213557 567#: ../sys-utils/pivot_root.8.adoc:33 ../sys-utils/readprofile.8.adoc:25
36e96905
MB
568#: ../sys-utils/renice.1.adoc:55 ../sys-utils/rfkill.8.adoc:25
569#: ../sys-utils/rtcwake.8.adoc:31 ../sys-utils/setarch.8.adoc:29
570#: ../sys-utils/setpriv.1.adoc:23 ../sys-utils/setsid.1.adoc:23
571#: ../sys-utils/swapon.8.adoc:29 ../sys-utils/switch_root.8.adoc:25
572#: ../sys-utils/tunelp.8.adoc:21 ../sys-utils/umount.8.adoc:52
573#: ../sys-utils/unshare.1.adoc:53 ../sys-utils/wdctl.8.adoc:25
574#: ../sys-utils/zramctl.8.adoc:39 ../term-utils/agetty.8.adoc:56
575#: ../term-utils/mesg.1.adoc:69 ../term-utils/script.1.adoc:62
5db1d29a 576#: ../term-utils/scriptlive.1.adoc:28 ../term-utils/scriptreplay.1.adoc:30
36e96905
MB
577#: ../term-utils/setterm.1.adoc:28 ../term-utils/wall.1.adoc:60
578#: ../term-utils/write.1.adoc:72 ../text-utils/col.1.adoc:60
579#: ../text-utils/colcrt.1.adoc:56 ../text-utils/colrm.1.adoc:59
580#: ../text-utils/column.1.adoc:66 ../text-utils/hexdump.1.adoc:55
581#: ../text-utils/more.1.adoc:58 ../text-utils/pg.1.adoc:26
582#: ../text-utils/rev.1.adoc:57 ../text-utils/ul.1.adoc:55
583#, no-wrap
584msgid "OPTIONS"
585msgstr ""
586
587#. type: Labeled list
588#: ../disk-utils/blockdev.8.adoc:33
589#, no-wrap
590msgid "*-q*"
591msgstr ""
592
593#. type: Plain text
594#: ../disk-utils/blockdev.8.adoc:35
595msgid "Be quiet."
596msgstr ""
597
598#. type: Labeled list
599#: ../disk-utils/blockdev.8.adoc:36 ../disk-utils/mkfs.cramfs.8.adoc:35
600#, no-wrap
601msgid "*-v*"
602msgstr ""
603
604#. type: Plain text
605#: ../disk-utils/blockdev.8.adoc:38 ../disk-utils/fsck.minix.8.adoc:58
606#: ../sys-utils/rtcwake.8.adoc:107 ../sys-utils/setarch.8.adoc:39
607#: ../sys-utils/swapon.8.adoc:91
608msgid "Be verbose."
609msgstr ""
610
611#. type: Labeled list
612#: ../disk-utils/blockdev.8.adoc:39
613#, no-wrap
614msgid "*--report*"
615msgstr ""
616
617#. type: Plain text
618#: ../disk-utils/blockdev.8.adoc:41
619msgid ""
620"Print a report for the specified device. It is possible to give multiple "
621"devices. If none is given, all devices which appear in _/proc/partitions_ "
622"are shown. Note that the partition StartSec is in 512-byte sectors."
623msgstr ""
624
625#. type: Labeled list
626#: ../disk-utils/blockdev.8.adoc:42 ../disk-utils/cfdisk.8.adoc:47
627#: ../disk-utils/fdformat.8.adoc:67 ../disk-utils/fdisk.8.adoc:51
628#: ../disk-utils/fsck.cramfs.8.adoc:41 ../disk-utils/fsck.minix.8.adoc:71
629#: ../disk-utils/mkfs.8.adoc:41 ../disk-utils/mkfs.bfs.8.adoc:47
630#: ../disk-utils/mkfs.cramfs.8.adoc:65 ../disk-utils/mkfs.minix.8.adoc:70
631#: ../disk-utils/mkswap.8.adoc:67 ../disk-utils/partx.8.adoc:102
632#: ../disk-utils/raw.8.adoc:45 ../disk-utils/sfdisk.8.adoc:213
633#: ../disk-utils/swaplabel.8.adoc:31 ../login-utils/chsh.1.adoc:39
634#: ../login-utils/lslogins.1.adoc:54 ../login-utils/nologin.8.adoc:51
635#: ../login-utils/runuser.1.adoc:80 ../login-utils/su.1.adoc:80
636#: ../login-utils/sulogin.8.adoc:64 ../login-utils/utmpdump.1.adoc:52
637#: ../misc-utils/blkid.8.adoc:58 ../misc-utils/cal.1.adoc:123
2bee5365 638#: ../misc-utils/fincore.1.adoc:50 ../misc-utils/findmnt.8.adoc:64
36e96905
MB
639#: ../misc-utils/getopt.1.adoc:35 ../misc-utils/hardlink.1.adoc:29
640#: ../misc-utils/logger.1.adoc:184 ../misc-utils/look.1.adoc:76
641#: ../misc-utils/lsblk.8.adoc:54 ../misc-utils/lslocks.8.adoc:69
642#: ../misc-utils/mcookie.1.adoc:45 ../misc-utils/namei.1.adoc:62
643#: ../misc-utils/rename.1.adoc:43 ../misc-utils/uuidd.8.adoc:68
644#: ../misc-utils/uuidgen.1.adoc:37 ../misc-utils/uuidparse.1.adoc:65
645#: ../misc-utils/whereis.1.adoc:100 ../misc-utils/wipefs.8.adoc:49
646#: ../schedutils/chrt.1.adoc:107 ../schedutils/ionice.1.adoc:63
647#: ../schedutils/taskset.1.adoc:83 ../schedutils/uclampset.1.adoc:88
648#: ../sys-utils/blkdiscard.8.adoc:55 ../sys-utils/blkzone.8.adoc:104
649#: ../sys-utils/chcpu.8.adoc:56 ../sys-utils/chmem.8.adoc:49
650#: ../sys-utils/choom.1.adoc:31 ../sys-utils/ctrlaltdel.8.adoc:40
651#: ../sys-utils/dmesg.1.adoc:144 ../sys-utils/eject.1.adoc:52
b81d5971 652#: ../sys-utils/fallocate.1.adoc:82 ../sys-utils/flock.1.adoc:89
36e96905 653#: ../sys-utils/fsfreeze.8.adoc:42 ../sys-utils/fstrim.8.adoc:65
9b7051d5 654#: ../sys-utils/hwclock.8.adoc:102 ../sys-utils/ipcmk.1.adoc:46
36e96905
MB
655#: ../sys-utils/ipcrm.1.adoc:64 ../sys-utils/ipcs.1.adoc:30
656#: ../sys-utils/irqtop.1.adoc:40 ../sys-utils/ldattach.8.adoc:115
657#: ../sys-utils/losetup.8.adoc:119 ../sys-utils/lscpu.1.adoc:116
658#: ../sys-utils/lsipc.1.adoc:29 ../sys-utils/lsirq.1.adoc:46
659#: ../sys-utils/lsmem.1.adoc:39 ../sys-utils/lsns.8.adoc:69
660#: ../sys-utils/mount.8.adoc:442 ../sys-utils/mountpoint.1.adoc:40
3a213557 661#: ../sys-utils/nsenter.1.adoc:130 ../sys-utils/pivot_root.8.adoc:38
36e96905
MB
662#: ../sys-utils/readprofile.8.adoc:57 ../sys-utils/renice.1.adoc:72
663#: ../sys-utils/rtcwake.8.adoc:111 ../sys-utils/setarch.8.adoc:76
664#: ../sys-utils/setpriv.1.adoc:95 ../sys-utils/setsid.1.adoc:37
665#: ../sys-utils/swapon.8.adoc:52 ../sys-utils/umount.8.adoc:117
666#: ../sys-utils/unshare.1.adoc:134 ../sys-utils/wdctl.8.adoc:60
667#: ../sys-utils/zramctl.8.adoc:73 ../term-utils/mesg.1.adoc:77
5db1d29a 668#: ../term-utils/script.1.adoc:125 ../term-utils/scriptlive.1.adoc:51
36e96905
MB
669#: ../term-utils/scriptreplay.1.adoc:68 ../term-utils/wall.1.adoc:74
670#: ../term-utils/write.1.adoc:77 ../text-utils/colcrt.1.adoc:67
671#: ../text-utils/colrm.1.adoc:64 ../text-utils/hexdump.1.adoc:99
672#: ../text-utils/pg.1.adoc:65 ../text-utils/rev.1.adoc:62
673#: ../text-utils/ul.1.adoc:66
674#, no-wrap
675msgid "*-h*, *--help*"
676msgstr ""
677
678#. type: Plain text
679#: ../disk-utils/blockdev.8.adoc:44 ../disk-utils/cfdisk.8.adoc:49
680#: ../disk-utils/fdformat.8.adoc:69 ../disk-utils/fsck.8.adoc:114
681#: ../disk-utils/fsck.cramfs.8.adoc:43 ../disk-utils/fsck.minix.8.adoc:73
682#: ../disk-utils/mkfs.8.adoc:43 ../disk-utils/mkfs.bfs.8.adoc:49
683#: ../disk-utils/mkfs.cramfs.8.adoc:67 ../disk-utils/mkfs.minix.8.adoc:72
684#: ../disk-utils/mkswap.8.adoc:69 ../disk-utils/partx.8.adoc:104
685#: ../disk-utils/raw.8.adoc:47 ../disk-utils/sfdisk.8.adoc:215
686#: ../disk-utils/swaplabel.8.adoc:33 ../login-utils/chfn.1.adoc:51
687#: ../login-utils/chsh.1.adoc:41 ../login-utils/login.1.adoc:55
688#: ../login-utils/nologin.8.adoc:53 ../login-utils/runuser.1.adoc:82
689#: ../login-utils/su.1.adoc:82 ../login-utils/sulogin.8.adoc:66
690#: ../login-utils/utmpdump.1.adoc:54 ../misc-utils/cal.1.adoc:125
2bee5365 691#: ../misc-utils/fincore.1.adoc:52 ../misc-utils/findmnt.8.adoc:66
36e96905
MB
692#: ../misc-utils/logger.1.adoc:186 ../misc-utils/look.1.adoc:78
693#: ../misc-utils/lsblk.8.adoc:56 ../misc-utils/lslocks.8.adoc:71
694#: ../misc-utils/mcookie.1.adoc:47 ../misc-utils/namei.1.adoc:64
695#: ../misc-utils/rename.1.adoc:45 ../misc-utils/uuidgen.1.adoc:39
696#: ../misc-utils/uuidparse.1.adoc:67 ../misc-utils/whereis.1.adoc:102
697#: ../misc-utils/wipefs.8.adoc:51 ../schedutils/chrt.1.adoc:109
698#: ../schedutils/ionice.1.adoc:65 ../schedutils/taskset.1.adoc:85
699#: ../schedutils/uclampset.1.adoc:90 ../sys-utils/blkdiscard.8.adoc:57
700#: ../sys-utils/blkzone.8.adoc:106 ../sys-utils/chcpu.8.adoc:58
701#: ../sys-utils/choom.1.adoc:33 ../sys-utils/ctrlaltdel.8.adoc:42
702#: ../sys-utils/dmesg.1.adoc:146 ../sys-utils/eject.1.adoc:54
b81d5971 703#: ../sys-utils/fallocate.1.adoc:84 ../sys-utils/flock.1.adoc:91
36e96905 704#: ../sys-utils/fsfreeze.8.adoc:44 ../sys-utils/fstrim.8.adoc:67
9b7051d5 705#: ../sys-utils/hwclock.8.adoc:104 ../sys-utils/ipcmk.1.adoc:48
36e96905
MB
706#: ../sys-utils/ipcrm.1.adoc:66 ../sys-utils/ipcs.1.adoc:32
707#: ../sys-utils/irqtop.1.adoc:42 ../sys-utils/ldattach.8.adoc:117
708#: ../sys-utils/losetup.8.adoc:121 ../sys-utils/lscpu.1.adoc:118
709#: ../sys-utils/lsipc.1.adoc:31 ../sys-utils/lsirq.1.adoc:48
710#: ../sys-utils/lsmem.1.adoc:41 ../sys-utils/lsns.8.adoc:71
711#: ../sys-utils/mount.8.adoc:444 ../sys-utils/mountpoint.1.adoc:42
3a213557 712#: ../sys-utils/nsenter.1.adoc:132 ../sys-utils/pivot_root.8.adoc:40
36e96905
MB
713#: ../sys-utils/prlimit.1.adoc:45 ../sys-utils/readprofile.8.adoc:59
714#: ../sys-utils/renice.1.adoc:74 ../sys-utils/rfkill.8.adoc:44
715#: ../sys-utils/rfkill.8.adoc:52 ../sys-utils/rtcwake.8.adoc:113
716#: ../sys-utils/setarch.8.adoc:78 ../sys-utils/setpriv.1.adoc:97
717#: ../sys-utils/setsid.1.adoc:39 ../sys-utils/swapon.8.adoc:54
718#: ../sys-utils/switch_root.8.adoc:29 ../sys-utils/umount.8.adoc:119
719#: ../sys-utils/unshare.1.adoc:136 ../sys-utils/wdctl.8.adoc:62
720#: ../sys-utils/zramctl.8.adoc:75 ../term-utils/agetty.8.adoc:188
721#: ../term-utils/mesg.1.adoc:79 ../term-utils/script.1.adoc:127
5db1d29a 722#: ../term-utils/scriptlive.1.adoc:53 ../term-utils/scriptreplay.1.adoc:70
36e96905
MB
723#: ../term-utils/wall.1.adoc:76 ../term-utils/write.1.adoc:79
724#: ../text-utils/col.1.adoc:85 ../text-utils/colcrt.1.adoc:69
725#: ../text-utils/colrm.1.adoc:66 ../text-utils/column.1.adoc:140
726#: ../text-utils/hexdump.1.adoc:101 ../text-utils/more.1.adoc:97
727#: ../text-utils/pg.1.adoc:67 ../text-utils/rev.1.adoc:64
728#: ../text-utils/ul.1.adoc:68
729msgid "Display help text and exit."
730msgstr ""
731
732#. type: Labeled list
733#: ../disk-utils/blockdev.8.adoc:45 ../disk-utils/cfdisk.8.adoc:59
734#: ../disk-utils/fdformat.8.adoc:64 ../disk-utils/fdisk.8.adoc:101
735#: ../disk-utils/fsck.cramfs.8.adoc:38 ../disk-utils/fsck.minix.8.adoc:68
736#: ../disk-utils/mkfs.8.adoc:38 ../disk-utils/mkfs.bfs.8.adoc:50
737#: ../disk-utils/mkfs.cramfs.8.adoc:68 ../disk-utils/mkfs.minix.8.adoc:67
738#: ../disk-utils/mkswap.8.adoc:70 ../disk-utils/partx.8.adoc:99
739#: ../disk-utils/raw.8.adoc:48 ../login-utils/login.1.adoc:56
740#: ../login-utils/lslogins.1.adoc:93 ../login-utils/nologin.8.adoc:54
741#: ../login-utils/runuser.1.adoc:77 ../login-utils/su.1.adoc:77
742#: ../login-utils/sulogin.8.adoc:67 ../login-utils/utmpdump.1.adoc:49
743#: ../misc-utils/blkid.8.adoc:144 ../misc-utils/cal.1.adoc:120
744#: ../misc-utils/fincore.1.adoc:47 ../misc-utils/getopt.1.adoc:63
745#: ../misc-utils/logger.1.adoc:181 ../misc-utils/look.1.adoc:73
746#: ../misc-utils/lsblk.8.adoc:109 ../misc-utils/lslocks.8.adoc:66
747#: ../misc-utils/mcookie.1.adoc:42 ../misc-utils/namei.1.adoc:59
748#: ../misc-utils/rename.1.adoc:40 ../misc-utils/uuidd.8.adoc:65
749#: ../misc-utils/uuidgen.1.adoc:40 ../misc-utils/uuidparse.1.adoc:62
750#: ../misc-utils/whereis.1.adoc:103 ../misc-utils/wipefs.8.adoc:81
751#: ../schedutils/chrt.1.adoc:104 ../schedutils/ionice.1.adoc:69
752#: ../schedutils/taskset.1.adoc:80 ../schedutils/uclampset.1.adoc:85
753#: ../sys-utils/blkdiscard.8.adoc:52 ../sys-utils/blkzone.8.adoc:101
754#: ../sys-utils/chcpu.8.adoc:53 ../sys-utils/chmem.8.adoc:55
755#: ../sys-utils/choom.1.adoc:34 ../sys-utils/ctrlaltdel.8.adoc:37
756#: ../sys-utils/dmesg.1.adoc:141 ../sys-utils/eject.1.adoc:85
b81d5971 757#: ../sys-utils/fallocate.1.adoc:79 ../sys-utils/flock.1.adoc:86
36e96905 758#: ../sys-utils/fsfreeze.8.adoc:39 ../sys-utils/fstrim.8.adoc:62
9b7051d5 759#: ../sys-utils/hwclock.8.adoc:99 ../sys-utils/ipcmk.1.adoc:43
36e96905
MB
760#: ../sys-utils/ipcrm.1.adoc:61 ../sys-utils/ipcs.1.adoc:33
761#: ../sys-utils/irqtop.1.adoc:37 ../sys-utils/ldattach.8.adoc:112
762#: ../sys-utils/losetup.8.adoc:116 ../sys-utils/lscpu.1.adoc:142
763#: ../sys-utils/lsipc.1.adoc:32 ../sys-utils/lsirq.1.adoc:43
764#: ../sys-utils/lsmem.1.adoc:66 ../sys-utils/lsns.8.adoc:66
765#: ../sys-utils/mount.8.adoc:439 ../sys-utils/mountpoint.1.adoc:37
3a213557 766#: ../sys-utils/nsenter.1.adoc:127 ../sys-utils/pivot_root.8.adoc:35
36e96905
MB
767#: ../sys-utils/readprofile.8.adoc:54 ../sys-utils/renice.1.adoc:69
768#: ../sys-utils/rtcwake.8.adoc:108 ../sys-utils/setarch.8.adoc:73
769#: ../sys-utils/setpriv.1.adoc:92 ../sys-utils/setsid.1.adoc:34
770#: ../sys-utils/swapon.8.adoc:92 ../sys-utils/umount.8.adoc:114
771#: ../sys-utils/unshare.1.adoc:131 ../sys-utils/wdctl.8.adoc:57
772#: ../sys-utils/zramctl.8.adoc:70 ../term-utils/mesg.1.adoc:74
5db1d29a 773#: ../term-utils/script.1.adoc:122 ../term-utils/scriptlive.1.adoc:48
36e96905
MB
774#: ../term-utils/scriptreplay.1.adoc:65 ../term-utils/wall.1.adoc:71
775#: ../term-utils/write.1.adoc:74 ../text-utils/col.1.adoc:80
776#: ../text-utils/colcrt.1.adoc:64 ../text-utils/colrm.1.adoc:61
777#: ../text-utils/column.1.adoc:135 ../text-utils/hexdump.1.adoc:96
778#: ../text-utils/more.1.adoc:98 ../text-utils/pg.1.adoc:62
779#: ../text-utils/rev.1.adoc:59 ../text-utils/ul.1.adoc:63
780#, no-wrap
781msgid "*-V*, *--version*"
782msgstr ""
783
784#. type: Plain text
785#: ../disk-utils/blockdev.8.adoc:47
786msgid "Print version and exit."
787msgstr ""
788
789#. type: Title ==
790#: ../disk-utils/blockdev.8.adoc:48 ../disk-utils/cfdisk.8.adoc:65
791#: ../disk-utils/sfdisk.8.adoc:52 ../sys-utils/blkzone.8.adoc:23
792#: ../sys-utils/rfkill.8.adoc:48 ../text-utils/more.1.adoc:101
793#: ../text-utils/pg.1.adoc:68
794#, no-wrap
795msgid "COMMANDS"
796msgstr ""
797
798#. type: Plain text
799#: ../disk-utils/blockdev.8.adoc:51
800msgid "It is possible to give multiple devices and multiple commands."
801msgstr ""
802
803#. type: Labeled list
804#: ../disk-utils/blockdev.8.adoc:52
805#, no-wrap
806msgid "*--flushbufs*"
807msgstr ""
808
809#. type: Plain text
810#: ../disk-utils/blockdev.8.adoc:54
811msgid "Flush buffers."
812msgstr ""
813
814#. type: Labeled list
815#: ../disk-utils/blockdev.8.adoc:55
816#, no-wrap
817msgid "*--getalignoff*"
818msgstr ""
819
820#. type: Plain text
821#: ../disk-utils/blockdev.8.adoc:57
822msgid "Get alignment offset."
823msgstr ""
824
825#. type: Labeled list
826#: ../disk-utils/blockdev.8.adoc:58
827#, no-wrap
828msgid "*--getbsz*"
829msgstr ""
830
831#. type: Plain text
832#: ../disk-utils/blockdev.8.adoc:60
833msgid ""
834"Print the blocksize in bytes. This size does not describe device "
835"topology. It's the size used internally by the kernel and it may be modified "
836"(for example) by filesystem driver on mount."
837msgstr ""
838
839#. type: Labeled list
840#: ../disk-utils/blockdev.8.adoc:61
841#, no-wrap
842msgid "*--getdiscardzeroes*"
843msgstr ""
844
845#. type: Plain text
846#: ../disk-utils/blockdev.8.adoc:63
847msgid "Get discard zeroes support status."
848msgstr ""
849
850#. type: Labeled list
851#: ../disk-utils/blockdev.8.adoc:64
852#, no-wrap
853msgid "*--getfra*"
854msgstr ""
855
856#. type: Plain text
857#: ../disk-utils/blockdev.8.adoc:66
858msgid "Get filesystem readahead in 512-byte sectors."
859msgstr ""
860
861#. type: Labeled list
862#: ../disk-utils/blockdev.8.adoc:67
863#, no-wrap
864msgid "*--getiomin*"
865msgstr ""
866
867#. type: Plain text
868#: ../disk-utils/blockdev.8.adoc:69
869msgid "Get minimum I/O size."
870msgstr ""
871
872#. type: Labeled list
873#: ../disk-utils/blockdev.8.adoc:70
874#, no-wrap
875msgid "*--getioopt*"
876msgstr ""
877
878#. type: Plain text
879#: ../disk-utils/blockdev.8.adoc:72
880msgid "Get optimal I/O size."
881msgstr ""
882
883#. type: Labeled list
884#: ../disk-utils/blockdev.8.adoc:73
885#, no-wrap
886msgid "*--getmaxsect*"
887msgstr ""
888
889#. type: Plain text
890#: ../disk-utils/blockdev.8.adoc:75
891msgid "Get max sectors per request."
892msgstr ""
893
894#. type: Labeled list
895#: ../disk-utils/blockdev.8.adoc:76
896#, no-wrap
897msgid "*--getpbsz*"
898msgstr ""
899
900#. type: Plain text
901#: ../disk-utils/blockdev.8.adoc:78
902msgid "Get physical block (sector) size."
903msgstr ""
904
905#. type: Labeled list
906#: ../disk-utils/blockdev.8.adoc:79
907#, no-wrap
908msgid "*--getra*"
909msgstr ""
910
911#. type: Plain text
912#: ../disk-utils/blockdev.8.adoc:81
913msgid "Print readahead (in 512-byte sectors)."
914msgstr ""
915
916#. type: Labeled list
917#: ../disk-utils/blockdev.8.adoc:82
918#, no-wrap
919msgid "*--getro*"
920msgstr ""
921
922#. type: Plain text
923#: ../disk-utils/blockdev.8.adoc:84
924msgid "Get read-only. Print 1 if the device is read-only, 0 otherwise."
925msgstr ""
926
927#. type: Labeled list
928#: ../disk-utils/blockdev.8.adoc:85
929#, no-wrap
930msgid "*--getsize64*"
931msgstr ""
932
933#. type: Plain text
934#: ../disk-utils/blockdev.8.adoc:87
935msgid "Print device size in bytes."
936msgstr ""
937
938#. type: Labeled list
939#: ../disk-utils/blockdev.8.adoc:88
940#, no-wrap
941msgid "*--getsize*"
942msgstr ""
943
944#. type: Plain text
945#: ../disk-utils/blockdev.8.adoc:90
946msgid ""
947"Print device size (32-bit!) in sectors. Deprecated in favor of the *--getsz* "
948"option."
949msgstr ""
950
951#. type: Labeled list
952#: ../disk-utils/blockdev.8.adoc:91
953#, no-wrap
954msgid "*--getss*"
955msgstr ""
956
957#. type: Plain text
958#: ../disk-utils/blockdev.8.adoc:93
959msgid "Print logical sector size in bytes - usually 512."
960msgstr ""
961
962#. type: Labeled list
963#: ../disk-utils/blockdev.8.adoc:94
964#, no-wrap
965msgid "*--getsz*"
966msgstr ""
967
968#. type: Plain text
969#: ../disk-utils/blockdev.8.adoc:96
970msgid "Get size in 512-byte sectors."
971msgstr ""
972
973#. type: Labeled list
974#: ../disk-utils/blockdev.8.adoc:97
975#, no-wrap
976msgid "*--rereadpt*"
977msgstr ""
978
979#. type: Plain text
980#: ../disk-utils/blockdev.8.adoc:99
981msgid "Reread partition table"
982msgstr ""
983
984#. type: Labeled list
985#: ../disk-utils/blockdev.8.adoc:100
986#, no-wrap
987msgid "*--setbsz* _bytes_"
988msgstr ""
989
990#. type: Plain text
991#: ../disk-utils/blockdev.8.adoc:102
992msgid ""
993"Set blocksize. Note that the block size is specific to the current file "
994"descriptor opening the block device, so the change of block size only "
995"persists for as long as *blockdev* has the device open, and is lost once "
996"*blockdev* exits."
997msgstr ""
998
999#. type: Labeled list
1000#: ../disk-utils/blockdev.8.adoc:103
1001#, no-wrap
1002msgid "*--setfra* _sectors_"
1003msgstr ""
1004
1005#. type: Plain text
1006#: ../disk-utils/blockdev.8.adoc:105
1007msgid "Set filesystem readahead (same as *--setra* on 2.6 kernels)."
1008msgstr ""
1009
1010#. type: Labeled list
1011#: ../disk-utils/blockdev.8.adoc:106
1012#, no-wrap
1013msgid "*--setra* _sectors_"
1014msgstr ""
1015
1016#. type: Plain text
1017#: ../disk-utils/blockdev.8.adoc:108
1018msgid "Set readahead (in 512-byte sectors)."
1019msgstr ""
1020
1021#. type: Labeled list
1022#: ../disk-utils/blockdev.8.adoc:109
1023#, no-wrap
1024msgid "*--setro*"
1025msgstr ""
1026
1027#. type: Plain text
1028#: ../disk-utils/blockdev.8.adoc:111
1029msgid ""
1030"Set read-only. The currently active access to the device may not be affected "
1031"by the change. For example, a filesystem already mounted in read-write mode "
1032"will not be affected. The change applies after remount."
1033msgstr ""
1034
1035#. type: Labeled list
1036#: ../disk-utils/blockdev.8.adoc:112
1037#, no-wrap
1038msgid "*--setrw*"
1039msgstr ""
1040
1041#. type: Plain text
1042#: ../disk-utils/blockdev.8.adoc:114
1043msgid "Set read-write."
1044msgstr ""
1045
1046#. type: Title ==
1047#: ../disk-utils/blockdev.8.adoc:115 ../disk-utils/cfdisk.8.adoc:148
1048#: ../disk-utils/fdformat.8.adoc:74 ../disk-utils/fdisk.8.adoc:217
1049#: ../disk-utils/fsck.8.adoc:154 ../disk-utils/fsck.minix.8.adoc:98
1050#: ../disk-utils/mkfs.8.adoc:48 ../disk-utils/partx.8.adoc:132
1051#: ../disk-utils/raw.8.adoc:61 ../disk-utils/sfdisk.8.adoc:404
1052#: ../disk-utils/swaplabel.8.adoc:45 ../libblkid/libblkid.3.adoc:46
1053#: ../libuuid/man/uuid.3.adoc:59 ../libuuid/man/uuid_clear.3.adoc:55
1054#: ../libuuid/man/uuid_compare.3.adoc:59 ../libuuid/man/uuid_copy.3.adoc:59
1055#: ../libuuid/man/uuid_generate.3.adoc:80 ../libuuid/man/uuid_is_null.3.adoc:55
1056#: ../libuuid/man/uuid_parse.3.adoc:66 ../libuuid/man/uuid_time.3.adoc:59
1057#: ../libuuid/man/uuid_unparse.3.adoc:63 ../login-utils/chfn.1.adoc:73
1058#: ../login-utils/chsh.1.adoc:55 ../login-utils/last.1.adoc:116
1059#: ../login-utils/login.1.adoc:159 ../login-utils/lslogins.1.adoc:127
1060#: ../login-utils/newgrp.1.adoc:30 ../login-utils/nologin.8.adoc:67
1061#: ../login-utils/sulogin.8.adoc:74 ../login-utils/utmpdump.1.adoc:75
1062#: ../misc-utils/blkid.8.adoc:174 ../misc-utils/fincore.1.adoc:53
2bee5365 1063#: ../misc-utils/findfs.8.adoc:61 ../misc-utils/findmnt.8.adoc:215
36e96905
MB
1064#: ../misc-utils/kill.1.adoc:100 ../misc-utils/logger.1.adoc:238
1065#: ../misc-utils/lsblk.8.adoc:161 ../misc-utils/lslocks.8.adoc:108
1066#: ../misc-utils/namei.1.adoc:69 ../misc-utils/uuidgen.1.adoc:66
1067#: ../misc-utils/uuidparse.1.adoc:68 ../misc-utils/wipefs.8.adoc:103
1068#: ../schedutils/chrt.1.adoc:137 ../schedutils/ionice.1.adoc:90
1069#: ../schedutils/taskset.1.adoc:104 ../schedutils/uclampset.1.adoc:125
1070#: ../sys-utils/blkdiscard.8.adoc:58 ../sys-utils/blkzone.8.adoc:107
1071#: ../sys-utils/chcpu.8.adoc:72 ../sys-utils/choom.1.adoc:51
1072#: ../sys-utils/ctrlaltdel.8.adoc:47 ../sys-utils/dmesg.1.adoc:181
1073#: ../sys-utils/eject.1.adoc:117 ../sys-utils/fallocate.1.adoc:85
b81d5971 1074#: ../sys-utils/flock.1.adoc:120 ../sys-utils/fsfreeze.8.adoc:53
9b7051d5 1075#: ../sys-utils/fstrim.8.adoc:81 ../sys-utils/hwclock.8.adoc:381
36e96905
MB
1076#: ../sys-utils/ipcmk.1.adoc:49 ../sys-utils/ipcs.1.adoc:87
1077#: ../sys-utils/irqtop.1.adoc:60 ../sys-utils/ldattach.8.adoc:118
1078#: ../sys-utils/losetup.8.adoc:160 ../sys-utils/lscpu.1.adoc:156
1079#: ../sys-utils/lsipc.1.adoc:102 ../sys-utils/lsirq.1.adoc:49
1080#: ../sys-utils/lsmem.1.adoc:72 ../sys-utils/lsns.8.adoc:72
1081#: ../sys-utils/mount.8.adoc:1452 ../sys-utils/mountpoint.1.adoc:65
1082#: ../sys-utils/nsenter.1.adoc:133 ../sys-utils/prlimit.1.adoc:135
1083#: ../sys-utils/rfkill.8.adoc:76 ../sys-utils/rtcwake.8.adoc:126
1084#: ../sys-utils/setarch.8.adoc:88 ../sys-utils/setpriv.1.adoc:114
1085#: ../sys-utils/setsid.1.adoc:40 ../sys-utils/switch_root.8.adoc:45
1086#: ../sys-utils/unshare.1.adoc:231 ../sys-utils/wdctl.8.adoc:63
1087#: ../sys-utils/zramctl.8.adoc:99 ../term-utils/agetty.8.adoc:329
5db1d29a 1088#: ../term-utils/scriptlive.1.adoc:66 ../term-utils/scriptreplay.1.adoc:83
36e96905
MB
1089#: ../text-utils/more.1.adoc:188
1090#, no-wrap
1091msgid "AUTHORS"
1092msgstr ""
1093
1094#. type: Plain text
1095#: ../disk-utils/blockdev.8.adoc:118
1096#, no-wrap
1097msgid "*blockdev* was written by Andries E. Brouwer and rewritten by Karel Zak.\n"
1098msgstr ""
1099
1100#. cfdisk.8 -- man page for cfdisk
1101#. Copyright 1994 Kevin E. Martin (martin@cs.unc.edu)
1102#. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
1103#
1104#. Permission is granted to make and distribute verbatim copies of this
1105#. manual provided the copyright notice and this permission notice are
1106#. preserved on all copies.
1107#
1108#. Permission is granted to copy and distribute modified versions of this
1109#. manual under the conditions for verbatim copying, provided that the
1110#. entire resulting derived work is distributed under the terms of a
1111#. permission notice identical to this one.
1112#. type: Title =
1113#: ../disk-utils/cfdisk.8.adoc:16
1114#, no-wrap
1115msgid "cfdisk(8)"
1116msgstr ""
1117
1118#. type: Plain text
1119#: ../disk-utils/cfdisk.8.adoc:26
1120msgid "cfdisk - display or manipulate a disk partition table"
1121msgstr ""
1122
1123#. type: Plain text
1124#: ../disk-utils/cfdisk.8.adoc:30
1125#, no-wrap
1126msgid "*cfdisk* [options] [_device_]\n"
1127msgstr ""
1128
1129#. type: Plain text
1130#: ../disk-utils/cfdisk.8.adoc:34
1131#, no-wrap
1132msgid ""
1133"*cfdisk* is a curses-based program for partitioning any block device. The "
1134"default device is _/dev/sda_.\n"
1135msgstr ""
1136
1137#. type: Plain text
1138#: ../disk-utils/cfdisk.8.adoc:36
1139msgid ""
1140"Note that *cfdisk* provides basic partitioning functionality with a "
1141"user-friendly interface. If you need advanced features, use *fdisk*(8) "
1142"instead."
1143msgstr ""
1144
1145#. type: Plain text
1146#: ../disk-utils/cfdisk.8.adoc:38
1147msgid ""
1148"All disk label changes will remain in memory only, and the disk will be "
1149"unmodified until you decide to write your changes. Be careful before using "
1150"the write command."
1151msgstr ""
1152
1153#. type: Plain text
1154#: ../disk-utils/cfdisk.8.adoc:40
1155msgid ""
1156"Since version 2.25 *cfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
1157"labels, but no longer provides any functionality for CHS "
1158"(Cylinder-Head-Sector) addressing. CHS has never been important for Linux, "
1159"and this addressing concept does not make any sense for new devices."
1160msgstr ""
1161
1162#. type: Plain text
1163#: ../disk-utils/cfdisk.8.adoc:42
1164msgid ""
1165"Since version 2.25 *cfdisk* also does not provide a 'print' command any "
1166"more. This functionality is provided by the utilities *partx*(8) and "
1167"*lsblk*(8) in a very comfortable and rich way."
1168msgstr ""
1169
1170#. type: Plain text
1171#: ../disk-utils/cfdisk.8.adoc:44
1172msgid "If you want to remove an old partition table from a device, use *wipefs*(8)."
1173msgstr ""
1174
1175#. type: Labeled list
1176#: ../disk-utils/cfdisk.8.adoc:50
1177#, no-wrap
1178msgid "*-L*, *--color*[**=**__when__]"
1179msgstr ""
1180
1181#. type: Plain text
1182#: ../disk-utils/cfdisk.8.adoc:52
1183msgid ""
1184"Colorize the output. The optional argument _when_ can be *auto*, *never* or "
1185"*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
1186"colors can be disabled, for the current built-in default see *--help* "
1187"output. See also the COLORS section."
1188msgstr ""
1189
1190#. type: Labeled list
1191#: ../disk-utils/cfdisk.8.adoc:53 ../disk-utils/fdisk.8.adoc:65
1192#: ../disk-utils/mkfs.minix.8.adoc:49 ../disk-utils/mkswap.8.adoc:52
1193#: ../disk-utils/sfdisk.8.adoc:155 ../misc-utils/wipefs.8.adoc:55
1194#, no-wrap
1195msgid "*--lock*[=_mode_]"
1196msgstr ""
1197
1198#. type: Plain text
1199#: ../disk-utils/cfdisk.8.adoc:55 ../disk-utils/fdisk.8.adoc:67
1200#: ../disk-utils/mkfs.minix.8.adoc:51 ../disk-utils/mkswap.8.adoc:54
1201#: ../disk-utils/sfdisk.8.adoc:157 ../misc-utils/wipefs.8.adoc:57
1202msgid ""
1203"Use exclusive BSD lock for device or file it operates. The optional argument "
1204"_mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument "
1205"is omitted, it defaults to *\"yes\"*. This option overwrites environment "
1206"variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, "
1207"but it's recommended to avoid collisions with udevd or other tools."
1208msgstr ""
1209
1210#. type: Labeled list
1211#: ../disk-utils/cfdisk.8.adoc:56 ../sys-utils/losetup.8.adoc:89
1212#: ../sys-utils/mount.8.adoc:380 ../sys-utils/umount.8.adoc:105
1213#, no-wrap
1214msgid "*-r*, *--read-only*"
1215msgstr ""
1216
1217#. type: Plain text
1218#: ../disk-utils/cfdisk.8.adoc:58
1219msgid "Forced open in read-only mode."
1220msgstr ""
1221
1222#. type: Plain text
1223#: ../disk-utils/cfdisk.8.adoc:61 ../disk-utils/fdformat.8.adoc:66
1224#: ../disk-utils/fdisk.8.adoc:103 ../disk-utils/fsck.8.adoc:117
1225#: ../disk-utils/fsck.cramfs.8.adoc:40 ../disk-utils/fsck.minix.8.adoc:70
1226#: ../disk-utils/mkfs.cramfs.8.adoc:70 ../disk-utils/mkswap.8.adoc:72
1227#: ../disk-utils/partx.8.adoc:101 ../disk-utils/raw.8.adoc:50
1228#: ../disk-utils/sfdisk.8.adoc:212 ../login-utils/chfn.1.adoc:54
1229#: ../login-utils/chsh.1.adoc:44 ../login-utils/login.1.adoc:58
1230#: ../login-utils/lslogins.1.adoc:95 ../login-utils/nologin.8.adoc:56
1231#: ../login-utils/runuser.1.adoc:79 ../login-utils/su.1.adoc:79
1232#: ../login-utils/sulogin.8.adoc:69 ../login-utils/utmpdump.1.adoc:51
1233#: ../misc-utils/cal.1.adoc:122 ../misc-utils/fincore.1.adoc:49
1234#: ../misc-utils/logger.1.adoc:183 ../misc-utils/look.1.adoc:75
1235#: ../misc-utils/lsblk.8.adoc:111 ../misc-utils/lslocks.8.adoc:68
1236#: ../misc-utils/mcookie.1.adoc:44 ../misc-utils/namei.1.adoc:61
1237#: ../misc-utils/rename.1.adoc:42 ../misc-utils/uuidgen.1.adoc:42
1238#: ../misc-utils/uuidparse.1.adoc:64 ../misc-utils/whereis.1.adoc:105
1239#: ../misc-utils/wipefs.8.adoc:83 ../schedutils/chrt.1.adoc:106
1240#: ../schedutils/ionice.1.adoc:71 ../schedutils/taskset.1.adoc:82
1241#: ../schedutils/uclampset.1.adoc:87 ../sys-utils/blkdiscard.8.adoc:54
1242#: ../sys-utils/blkzone.8.adoc:103 ../sys-utils/chcpu.8.adoc:55
1243#: ../sys-utils/choom.1.adoc:36 ../sys-utils/ctrlaltdel.8.adoc:39
1244#: ../sys-utils/dmesg.1.adoc:143 ../sys-utils/eject.1.adoc:87
b81d5971 1245#: ../sys-utils/fallocate.1.adoc:81 ../sys-utils/flock.1.adoc:88
36e96905 1246#: ../sys-utils/fsfreeze.8.adoc:41 ../sys-utils/fstrim.8.adoc:64
9b7051d5 1247#: ../sys-utils/hwclock.8.adoc:101 ../sys-utils/ipcmk.1.adoc:45
36e96905
MB
1248#: ../sys-utils/ipcrm.1.adoc:63 ../sys-utils/ipcs.1.adoc:35
1249#: ../sys-utils/irqtop.1.adoc:39 ../sys-utils/ldattach.8.adoc:114
1250#: ../sys-utils/losetup.8.adoc:118 ../sys-utils/lscpu.1.adoc:144
1251#: ../sys-utils/lsipc.1.adoc:34 ../sys-utils/lsirq.1.adoc:45
1252#: ../sys-utils/lsmem.1.adoc:68 ../sys-utils/lsns.8.adoc:68
1253#: ../sys-utils/mount.8.adoc:441 ../sys-utils/mountpoint.1.adoc:39
3a213557 1254#: ../sys-utils/nsenter.1.adoc:129 ../sys-utils/pivot_root.8.adoc:37
36e96905
MB
1255#: ../sys-utils/prlimit.1.adoc:63 ../sys-utils/readprofile.8.adoc:56
1256#: ../sys-utils/renice.1.adoc:71 ../sys-utils/rfkill.8.adoc:47
1257#: ../sys-utils/rtcwake.8.adoc:110 ../sys-utils/setarch.8.adoc:75
1258#: ../sys-utils/setpriv.1.adoc:94 ../sys-utils/setsid.1.adoc:36
1259#: ../sys-utils/swapon.8.adoc:94 ../sys-utils/switch_root.8.adoc:32
1260#: ../sys-utils/umount.8.adoc:116 ../sys-utils/unshare.1.adoc:133
1261#: ../sys-utils/wdctl.8.adoc:59 ../sys-utils/zramctl.8.adoc:72
1262#: ../term-utils/agetty.8.adoc:185 ../term-utils/mesg.1.adoc:76
5db1d29a 1263#: ../term-utils/script.1.adoc:124 ../term-utils/scriptlive.1.adoc:50
36e96905
MB
1264#: ../term-utils/scriptreplay.1.adoc:67 ../term-utils/wall.1.adoc:73
1265#: ../term-utils/write.1.adoc:76 ../text-utils/col.1.adoc:82
1266#: ../text-utils/colcrt.1.adoc:66 ../text-utils/colrm.1.adoc:63
1267#: ../text-utils/column.1.adoc:137 ../text-utils/hexdump.1.adoc:98
1268#: ../text-utils/more.1.adoc:100 ../text-utils/pg.1.adoc:64
1269#: ../text-utils/rev.1.adoc:61 ../text-utils/ul.1.adoc:65
1270msgid "Display version information and exit."
1271msgstr ""
1272
1273#. type: Labeled list
1274#: ../disk-utils/cfdisk.8.adoc:62
1275#, no-wrap
1276msgid "*-z*, *--zero*"
1277msgstr ""
1278
1279#. type: Plain text
1280#: ../disk-utils/cfdisk.8.adoc:64
1281msgid ""
1282"Start with an in-memory zeroed partition table. This option does not zero "
1283"the partition table on the disk; rather, it simply starts the program "
1284"without reading the existing partition table. This option allows you to "
1285"create a new partition table from scratch or from an *sfdisk*(8)-compatible "
1286"script."
1287msgstr ""
1288
1289#. type: Plain text
1290#: ../disk-utils/cfdisk.8.adoc:68
1291msgid ""
1292"The commands for *cfdisk* can be entered by pressing the corresponding key "
1293"(pressing _Enter_ after the command is not necessary). Here is a list of the "
1294"available commands:"
1295msgstr ""
1296
1297#. type: Labeled list
1298#: ../disk-utils/cfdisk.8.adoc:69
1299#, no-wrap
1300msgid "*b*"
1301msgstr ""
1302
1303#. type: Plain text
1304#: ../disk-utils/cfdisk.8.adoc:71
1305msgid ""
1306"Toggle the bootable flag of the current partition. This allows you to select "
1307"which primary partition is bootable on the drive. This command may not be "
1308"available for all partition label types."
1309msgstr ""
1310
1311#. type: Labeled list
1312#: ../disk-utils/cfdisk.8.adoc:72 ../sys-utils/irqtop.1.adoc:51
1313#, no-wrap
1314msgid "*d*"
1315msgstr ""
1316
1317#. type: Plain text
1318#: ../disk-utils/cfdisk.8.adoc:74
1319msgid ""
1320"Delete the current partition. This will convert the current partition into "
1321"free space and merge it with any free space immediately surrounding the "
1322"current partition. A partition already marked as free space or marked as "
1323"unusable cannot be deleted."
1324msgstr ""
1325
1326#. type: Labeled list
1327#: ../disk-utils/cfdisk.8.adoc:75 ../text-utils/pg.1.adoc:110
1328#, no-wrap
1329msgid "*h*"
1330msgstr ""
1331
1332#. type: Plain text
1333#: ../disk-utils/cfdisk.8.adoc:77
1334msgid "Show the help screen."
1335msgstr ""
1336
1337#. type: Labeled list
1338#: ../disk-utils/cfdisk.8.adoc:78 ../sys-utils/irqtop.1.adoc:54
1339#: ../term-utils/mesg.1.adoc:61 ../text-utils/more.1.adoc:141
1340#, no-wrap
1341msgid "*n*"
1342msgstr ""
1343
1344#. type: Plain text
1345#: ../disk-utils/cfdisk.8.adoc:80
1346msgid ""
1347"Create a new partition from free space. *cfdisk* then prompts you for the "
1348"size of the partition you want to create. The default size is equal to the "
1349"entire available free space at the current position."
1350msgstr ""
1351
1352#. type: Plain text
1353#: ../disk-utils/cfdisk.8.adoc:82
1354msgid ""
1355"The size may be followed by a multiplicative suffix: KiB (=1024), MiB "
1356"(=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the \"iB\" is "
1357"optional, e.g., \"K\" has the same meaning as \"KiB\")."
1358msgstr ""
1359
1360#. type: Labeled list
1361#: ../disk-utils/cfdisk.8.adoc:83
1362#, no-wrap
1363msgid "*q*"
1364msgstr ""
1365
1366#. type: Plain text
1367#: ../disk-utils/cfdisk.8.adoc:85
1368msgid ""
1369"Quit the program. This will exit the program without writing any data to the "
1370"disk."
1371msgstr ""
1372
1373#. type: Labeled list
1374#: ../disk-utils/cfdisk.8.adoc:86
1375#, no-wrap
1376msgid "*r*"
1377msgstr ""
1378
1379#. type: Plain text
1380#: ../disk-utils/cfdisk.8.adoc:88
1381msgid ""
1382"Reduce or enlarge the current partition. *cfdisk* then prompts you for the "
1383"new size of the partition. The default size is the current size. A partition "
1384"marked as free space or marked as unusable cannot be resized."
1385msgstr ""
1386
1387#. type: Plain text
1388#: ../disk-utils/cfdisk.8.adoc:90
1389#, no-wrap
1390msgid ""
1391"*Note that reducing the size of a partition might destroy data on that "
1392"partition.*\n"
1393msgstr ""
1394
1395#. type: Labeled list
1396#: ../disk-utils/cfdisk.8.adoc:91 ../text-utils/more.1.adoc:123
1397#, no-wrap
1398msgid "*s*"
1399msgstr ""
1400
1401#. type: Plain text
1402#: ../disk-utils/cfdisk.8.adoc:93
1403msgid ""
1404"Sort the partitions in ascending start-sector order. When deleting and "
1405"adding partitions, it is likely that the numbering of the partitions will no "
1406"longer match their order on the disk. This command restores that match."
1407msgstr ""
1408
1409#. type: Labeled list
1410#: ../disk-utils/cfdisk.8.adoc:94 ../sys-utils/irqtop.1.adoc:48
1411#, no-wrap
1412msgid "*t*"
1413msgstr ""
1414
1415#. type: Plain text
1416#: ../disk-utils/cfdisk.8.adoc:96
1417msgid ""
1418"Change the partition type. By default, new partitions are created as _Linux_ "
1419"partitions."
1420msgstr ""
1421
1422#. type: Labeled list
1423#: ../disk-utils/cfdisk.8.adoc:97
1424#, no-wrap
1425msgid "*u*"
1426msgstr ""
1427
1428#. type: Plain text
1429#: ../disk-utils/cfdisk.8.adoc:99
1430msgid ""
1431"Dump the current in-memory partition table to an sfdisk-compatible script "
1432"file."
1433msgstr ""
1434
1435#. type: Plain text
1436#: ../disk-utils/cfdisk.8.adoc:101
1437msgid ""
1438"The script files are compatible between *cfdisk*, *fdisk*(8) *sfdisk*(8) and "
1439"other libfdisk applications. For more details see *sfdisk*(8)."
1440msgstr ""
1441
1442#. type: Plain text
1443#: ../disk-utils/cfdisk.8.adoc:103
1444msgid ""
1445"It is also possible to load an sfdisk-script into *cfdisk* if there is no "
1446"partition table on the device or when you start *cfdisk* with the *--zero* "
1447"command-line option."
1448msgstr ""
1449
1450#. type: Labeled list
1451#: ../disk-utils/cfdisk.8.adoc:104
1452#, no-wrap
1453msgid "*W*"
1454msgstr ""
1455
1456#. type: Plain text
1457#: ../disk-utils/cfdisk.8.adoc:106
1458msgid ""
1459"Write the partition table to disk (you must enter an uppercase W). Since "
1460"this might destroy data on the disk, you must either confirm or deny the "
1461"write by entering `yes' or `no'. If you enter `yes', *cfdisk* will write the "
1462"partition table to disk and then tell the kernel to re-read the partition "
1463"table from the disk."
1464msgstr ""
1465
1466#. type: Plain text
1467#: ../disk-utils/cfdisk.8.adoc:108
1468msgid ""
1469"The re-reading of the partition table does not always work. In such a case "
1470"you need to inform the kernel about any new partitions by using "
1471"*partprobe*(8) or *partx*(8), or by rebooting the system."
1472msgstr ""
1473
1474#. type: Labeled list
1475#: ../disk-utils/cfdisk.8.adoc:109
1476#, no-wrap
1477msgid "*x*"
1478msgstr ""
1479
1480#. type: Plain text
1481#: ../disk-utils/cfdisk.8.adoc:111
1482msgid "Toggle extra information about a partition."
1483msgstr ""
1484
1485#. type: Labeled list
1486#: ../disk-utils/cfdisk.8.adoc:112
1487#, no-wrap
1488msgid "_Up Arrow_, _Down Arrow_"
1489msgstr ""
1490
1491#. type: Plain text
1492#: ../disk-utils/cfdisk.8.adoc:114
1493msgid ""
1494"Move the cursor to the previous or next partition. If there are more "
1495"partitions than can be displayed on a screen, you can display the next "
1496"(previous) set of partitions by moving down (up) at the last (first) "
1497"partition displayed on the screen."
1498msgstr ""
1499
1500#. type: Labeled list
1501#: ../disk-utils/cfdisk.8.adoc:115
1502#, no-wrap
1503msgid "_Left Arrow_, _Right Arrow_"
1504msgstr ""
1505
1506#. type: Plain text
1507#: ../disk-utils/cfdisk.8.adoc:117
1508msgid ""
1509"Select the preceding or the next menu item. Hitting _Enter_ will execute the "
1510"currently selected item."
1511msgstr ""
1512
1513#. type: Plain text
1514#: ../disk-utils/cfdisk.8.adoc:119
1515msgid ""
1516"All commands can be entered with either uppercase or lowercase letters "
1517"(except for **W**rite). When in a submenu or at a prompt, you can hit the "
1518"_Esc_ key to return to the main menu."
1519msgstr ""
1520
1521#. type: Title ==
1522#: ../disk-utils/cfdisk.8.adoc:120 ../disk-utils/fdisk.8.adoc:179
1523#: ../disk-utils/sfdisk.8.adoc:372 ../misc-utils/cal.1.adoc:151
1524#: ../sys-utils/dmesg.1.adoc:147 ../text-utils/hexdump.1.adoc:253
1525#, no-wrap
1526msgid "COLORS"
1527msgstr ""
1528
1529#. type: Plain text
1530#: ../disk-utils/cfdisk.8.adoc:123
1531msgid ""
1532"Implicit coloring can be disabled by creating the empty file "
1533"_/etc/terminal-colors.d/cfdisk.disable_."
1534msgstr ""
1535
1536#. type: Plain text
1537#: ../disk-utils/cfdisk.8.adoc:125 ../misc-utils/cal.1.adoc:160
1538#: ../text-utils/hexdump.1.adoc:258
1539msgid ""
1540"See *terminal-colors.d*(5) for more details about colorization "
1541"configuration."
1542msgstr ""
1543
1544#. type: Plain text
1545#: ../disk-utils/cfdisk.8.adoc:127
1546#, no-wrap
1547msgid "*cfdisk* does not support color customization with a color-scheme file.\n"
1548msgstr ""
1549
1550#. type: Title ==
1551#: ../disk-utils/cfdisk.8.adoc:128 ../disk-utils/fdisk.8.adoc:197
1552#: ../disk-utils/fsck.8.adoc:128 ../disk-utils/mkfs.minix.8.adoc:73
1553#: ../disk-utils/mkswap.8.adoc:73 ../disk-utils/partx.8.adoc:105
1554#: ../disk-utils/sfdisk.8.adoc:385 ../disk-utils/swaplabel.8.adoc:40
1555#: ../lib/terminal-colors.d.5.adoc:129 ../login-utils/sulogin.8.adoc:70
1556#: ../login-utils/vipw.8.adoc:57 ../misc-utils/blkid.8.adoc:170
2bee5365 1557#: ../misc-utils/findfs.8.adoc:56 ../misc-utils/findmnt.8.adoc:172
36e96905
MB
1558#: ../misc-utils/getopt.1.adoc:135 ../misc-utils/look.1.adoc:81
1559#: ../misc-utils/lsblk.8.adoc:138 ../misc-utils/whereis.1.adoc:110
9b7051d5 1560#: ../misc-utils/wipefs.8.adoc:84 ../sys-utils/hwclock.8.adoc:351
36e96905
MB
1561#: ../sys-utils/losetup.8.adoc:134 ../sys-utils/mount.8.adoc:1395
1562#: ../sys-utils/mountpoint.1.adoc:56 ../sys-utils/swapon.8.adoc:124
1563#: ../sys-utils/umount.8.adoc:154 ../term-utils/script.1.adoc:132
1564#: ../text-utils/column.1.adoc:141 ../text-utils/more.1.adoc:165
1565#: ../text-utils/pg.1.adoc:121 ../text-utils/ul.1.adoc:69
1566#, no-wrap
1567msgid "ENVIRONMENT"
1568msgstr ""
1569
1570#. type: Labeled list
1571#: ../disk-utils/cfdisk.8.adoc:130
1572#, no-wrap
1573msgid "*CFDISK_DEBUG*=all"
1574msgstr ""
1575
1576#. type: Plain text
1577#: ../disk-utils/cfdisk.8.adoc:132
1578msgid "enables cfdisk debug output."
1579msgstr ""
1580
1581#. type: Labeled list
1582#: ../disk-utils/cfdisk.8.adoc:133 ../disk-utils/fdisk.8.adoc:202
1583#, no-wrap
1584msgid "*LIBFDISK_DEBUG*=all"
1585msgstr ""
1586
1587#. type: Plain text
1588#: ../disk-utils/cfdisk.8.adoc:135 ../disk-utils/fdisk.8.adoc:204
1589#: ../disk-utils/sfdisk.8.adoc:391
1590msgid "enables libfdisk debug output."
1591msgstr ""
1592
1593#. type: Labeled list
1594#: ../disk-utils/cfdisk.8.adoc:136 ../disk-utils/fdisk.8.adoc:205
1595#, no-wrap
1596msgid "*LIBBLKID_DEBUG*=all"
1597msgstr ""
1598
1599#. type: Plain text
1600#: ../disk-utils/cfdisk.8.adoc:138 ../disk-utils/fdisk.8.adoc:207
1601#: ../disk-utils/fsck.8.adoc:146 ../disk-utils/mkswap.8.adoc:77
1602#: ../disk-utils/partx.8.adoc:109 ../disk-utils/sfdisk.8.adoc:393
1603#: ../disk-utils/swaplabel.8.adoc:44 ../misc-utils/findfs.8.adoc:60
1604msgid "enables libblkid debug output."
1605msgstr ""
1606
1607#. type: Labeled list
1608#: ../disk-utils/cfdisk.8.adoc:139 ../disk-utils/fdisk.8.adoc:208
1609#, no-wrap
1610msgid "*LIBSMARTCOLS_DEBUG*=all"
1611msgstr ""
1612
1613#. type: Plain text
1614#: ../disk-utils/cfdisk.8.adoc:141 ../disk-utils/fdisk.8.adoc:210
1615#: ../disk-utils/sfdisk.8.adoc:395
1616msgid "enables libsmartcols debug output."
1617msgstr ""
1618
1619#. type: Labeled list
1620#: ../disk-utils/cfdisk.8.adoc:142 ../disk-utils/fdisk.8.adoc:211
1621#, no-wrap
1622msgid "*LIBSMARTCOLS_DEBUG_PADDING*=on"
1623msgstr ""
1624
1625#. type: Plain text
1626#: ../disk-utils/cfdisk.8.adoc:144 ../disk-utils/fdisk.8.adoc:213
1627msgid "use visible padding characters. Requires enabled *LIBSMARTCOLS_DEBUG*."
1628msgstr ""
1629
1630#. type: Labeled list
1631#: ../disk-utils/cfdisk.8.adoc:145 ../disk-utils/fdisk.8.adoc:214
1632#, no-wrap
1633msgid "*LOCK_BLOCK_DEVICE*=<mode>"
1634msgstr ""
1635
1636#. type: Plain text
1637#: ../disk-utils/cfdisk.8.adoc:147 ../disk-utils/fdisk.8.adoc:216
1638#: ../disk-utils/mkfs.minix.8.adoc:77 ../disk-utils/mkswap.8.adoc:80
1639#: ../disk-utils/sfdisk.8.adoc:397 ../misc-utils/wipefs.8.adoc:91
1640msgid ""
1641"use exclusive BSD lock. The mode is \"1\" or \"0\". See *--lock* for more "
1642"details."
1643msgstr ""
1644
1645#. type: Plain text
1646#: ../disk-utils/cfdisk.8.adoc:151 ../disk-utils/sfdisk.8.adoc:407
2bee5365 1647#: ../login-utils/nologin.8.adoc:70 ../misc-utils/findmnt.8.adoc:218
3cb97156
MB
1648#: ../misc-utils/wipefs.8.adoc:106 ../sys-utils/choom.1.adoc:54
1649#: ../sys-utils/dmesg.1.adoc:184 ../sys-utils/lsns.8.adoc:75
1650#: ../sys-utils/mount.8.adoc:1455 ../sys-utils/mountpoint.1.adoc:68
5db1d29a 1651#: ../term-utils/scriptlive.1.adoc:69
36e96905
MB
1652msgid "mailto:kzak@redhat.com[Karel Zak]"
1653msgstr ""
1654
1655#. type: Plain text
1656#: ../disk-utils/cfdisk.8.adoc:153
1657msgid ""
1658"The current *cfdisk* implementation is based on the original *cfdisk* from "
1659"mailto:martin@cs.unc.edu[Kevin E. Martin]."
1660msgstr ""
1661
1662#. type: Plain text
1663#: ../disk-utils/cfdisk.8.adoc:161
1664#, no-wrap
1665msgid ""
1666"*fdisk*(8),\n"
1667"*parted*(8),\n"
1668"*partprobe*(8),\n"
1669"*partx*(8),\n"
1670"*sfdisk*(8)\n"
1671msgstr ""
1672
1673#. delpart.8 -- man page for delpart
1674#. Copyright 2007 Karel Zak <kzak@redhat.com>
1675#. Copyright 2007 Red Hat, Inc.
1676#. May be distributed under the GNU General Public License
1677#. type: Title =
1678#: ../disk-utils/delpart.8.adoc:8
1679#, no-wrap
1680msgid "delpart(8)"
1681msgstr ""
1682
1683#. type: Plain text
1684#: ../disk-utils/delpart.8.adoc:18
1685msgid "delpart - tell the kernel to forget about a partition"
1686msgstr ""
1687
1688#. type: Plain text
1689#: ../disk-utils/delpart.8.adoc:22
1690#, no-wrap
1691msgid "*delpart* _device partition_\n"
1692msgstr ""
1693
1694#. type: Plain text
1695#: ../disk-utils/delpart.8.adoc:26
1696#, no-wrap
1697msgid ""
1698"*delpart* asks the Linux kernel to forget about the specified _partition_ (a "
1699"number) on the specified _device_. The command is a simple wrapper around "
1700"the \"del partition\" ioctl.\n"
1701msgstr ""
1702
1703#. type: Plain text
1704#: ../disk-utils/delpart.8.adoc:36
1705#, no-wrap
1706msgid ""
1707"*addpart*(8),\n"
1708"*fdisk*(8),\n"
1709"*parted*(8),\n"
1710"*partprobe*(8),\n"
1711"*partx*(8)\n"
1712msgstr ""
1713
1714#. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1715#. May be distributed under the GNU General Public License
1716#. type: Title =
1717#: ../disk-utils/fdformat.8.adoc:6
1718#, no-wrap
1719msgid "fdformat(8)"
1720msgstr ""
1721
1722#. type: Plain text
1723#: ../disk-utils/fdformat.8.adoc:16
1724msgid "fdformat - low-level format a floppy disk"
1725msgstr ""
1726
1727#. type: Plain text
1728#: ../disk-utils/fdformat.8.adoc:20
1729#, no-wrap
1730msgid "*fdformat* [options] _device_\n"
1731msgstr ""
1732
1733#. type: Plain text
1734#: ../disk-utils/fdformat.8.adoc:24
1735#, no-wrap
1736msgid ""
1737"*fdformat* does a low-level format on a floppy disk. _device_ is usually one "
1738"of the following (for floppy devices the major = 2, and the minor is shown "
1739"for informational purposes only):\n"
1740msgstr ""
1741
1742#. type: delimited block .
1743#: ../disk-utils/fdformat.8.adoc:35
1744#, no-wrap
1745msgid ""
1746"/dev/fd0d360 (minor = 4)\n"
1747"/dev/fd0h1200 (minor = 8)\n"
1748"/dev/fd0D360 (minor = 12)\n"
1749"/dev/fd0H360 (minor = 12)\n"
1750"/dev/fd0D720 (minor = 16)\n"
1751"/dev/fd0H720 (minor = 16)\n"
1752"/dev/fd0h360 (minor = 20)\n"
1753"/dev/fd0h720 (minor = 24)\n"
1754"/dev/fd0H1440 (minor = 28)\n"
1755msgstr ""
1756
1757#. type: delimited block .
1758#: ../disk-utils/fdformat.8.adoc:46
1759#, no-wrap
1760msgid ""
1761"/dev/fd1d360 (minor = 5)\n"
1762"/dev/fd1h1200 (minor = 9)\n"
1763"/dev/fd1D360 (minor = 13)\n"
1764"/dev/fd1H360 (minor = 13)\n"
1765"/dev/fd1D720 (minor = 17)\n"
1766"/dev/fd1H720 (minor = 17)\n"
1767"/dev/fd1h360 (minor = 21)\n"
1768"/dev/fd1h720 (minor = 25)\n"
1769"/dev/fd1H1440 (minor = 29)\n"
1770msgstr ""
1771
1772#. type: Plain text
1773#: ../disk-utils/fdformat.8.adoc:49
1774msgid ""
1775"The generic floppy devices, _/dev/fd0_ and _/dev/fd1_, will fail to work "
1776"with *fdformat* when a non-standard format is being used, or if the format "
1777"has not been autodetected earlier. In this case, use *setfdprm*(8) to load "
1778"the disk parameters."
1779msgstr ""
1780
1781#. type: Labeled list
1782#: ../disk-utils/fdformat.8.adoc:52
1783#, no-wrap
1784msgid "*-f*, *--from* _N_"
1785msgstr ""
1786
1787#. type: Plain text
1788#: ../disk-utils/fdformat.8.adoc:54
1789msgid "Start at the track _N_ (default is 0)."
1790msgstr ""
1791
1792#. type: Labeled list
1793#: ../disk-utils/fdformat.8.adoc:55
1794#, no-wrap
1795msgid "*-t*, *--to* _N_"
1796msgstr ""
1797
1798#. type: Plain text
1799#: ../disk-utils/fdformat.8.adoc:57
1800msgid "Stop at the track _N_."
1801msgstr ""
1802
1803#. type: Labeled list
1804#: ../disk-utils/fdformat.8.adoc:58
1805#, no-wrap
1806msgid "*-r*, *--repair* _N_"
1807msgstr ""
1808
1809#. type: Plain text
1810#: ../disk-utils/fdformat.8.adoc:60
1811msgid "Try to repair tracks failed during the verification (max _N_ retries)."
1812msgstr ""
1813
1814#. type: Labeled list
1815#: ../disk-utils/fdformat.8.adoc:61
1816#, no-wrap
1817msgid "*-n*, *--no-verify*"
1818msgstr ""
1819
1820#. type: Plain text
1821#: ../disk-utils/fdformat.8.adoc:63
1822msgid "Skip the verification that is normally performed after the formatting."
1823msgstr ""
1824
1825#. type: Title ==
1826#: ../disk-utils/fdformat.8.adoc:70 ../disk-utils/mkswap.8.adoc:81
1827#: ../disk-utils/raw.8.adoc:51 ../disk-utils/sfdisk.8.adoc:398
1828#: ../login-utils/last.1.adoc:112 ../login-utils/lslogins.1.adoc:119
1829#: ../login-utils/nologin.8.adoc:57 ../login-utils/su.1.adoc:133
1830#: ../login-utils/utmpdump.1.adoc:55 ../misc-utils/cal.1.adoc:145
1831#: ../misc-utils/kill.1.adoc:94 ../misc-utils/lsblk.8.adoc:155
1832#: ../misc-utils/lslocks.8.adoc:104 ../schedutils/chrt.1.adoc:131
1833#: ../schedutils/ionice.1.adoc:72 ../schedutils/uclampset.1.adoc:113
1834#: ../sys-utils/choom.1.adoc:37 ../sys-utils/eject.1.adoc:101
1835#: ../sys-utils/fsfreeze.8.adoc:49 ../sys-utils/fstab.5.adoc:125
9b7051d5 1836#: ../sys-utils/hwclock.8.adoc:170 ../sys-utils/ipcrm.1.adoc:67
36e96905
MB
1837#: ../sys-utils/ipcs.1.adoc:83 ../sys-utils/losetup.8.adoc:130
1838#: ../sys-utils/mountpoint.1.adoc:61 ../sys-utils/prlimit.1.adoc:114
1839#: ../sys-utils/renice.1.adoc:80 ../sys-utils/rtcwake.8.adoc:114
1840#: ../sys-utils/setpriv.1.adoc:98 ../sys-utils/swapon.8.adoc:140
1841#: ../sys-utils/switch_root.8.adoc:37 ../sys-utils/tunelp.8.adoc:64
1842#: ../sys-utils/unshare.1.adoc:137 ../term-utils/script.1.adoc:139
1843#: ../term-utils/wall.1.adoc:77 ../text-utils/col.1.adoc:90
1844#: ../text-utils/pg.1.adoc:140
1845#, no-wrap
1846msgid "NOTES"
1847msgstr ""
1848
1849#. type: Plain text
1850#: ../disk-utils/fdformat.8.adoc:73
1851msgid ""
1852"This utility does not handle USB floppy disk drives. Use *ufiformat*(8) "
1853"instead."
1854msgstr ""
1855
1856#. type: Plain text
1857#: ../disk-utils/fdformat.8.adoc:77
1858msgid "mailto:almesber@nessie.cs.id.ethz.ch[Werner Almesberger]"
1859msgstr ""
1860
1861#. type: Plain text
1862#: ../disk-utils/fdformat.8.adoc:85
1863#, no-wrap
1864msgid ""
1865"*fd*(4),\n"
1866"*emkfs*(8),\n"
1867"*mkfs*(8),\n"
1868"*setfdprm*(8),\n"
1869"*ufiformat*(8)\n"
1870msgstr ""
1871
1872#. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
1873#. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
1874#. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
1875#. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
1876#. May be distributed under the GNU General Public License
1877#. type: Title =
1878#: ../disk-utils/fdisk.8.adoc:9
1879#, no-wrap
1880msgid "fdisk(8)"
1881msgstr ""
1882
1883#. type: Plain text
1884#: ../disk-utils/fdisk.8.adoc:20
1885msgid "fdisk - manipulate disk partition table"
1886msgstr ""
1887
1888#. type: Plain text
1889#: ../disk-utils/fdisk.8.adoc:24
1890#, no-wrap
1891msgid "*fdisk* [options] _device_\n"
1892msgstr ""
1893
1894#. type: Plain text
1895#: ../disk-utils/fdisk.8.adoc:26
1896#, no-wrap
1897msgid "*fdisk* *-l* [_device_...]\n"
1898msgstr ""
1899
1900#. type: Plain text
1901#: ../disk-utils/fdisk.8.adoc:30
1902#, no-wrap
1903msgid ""
1904"*fdisk* is a dialog-driven program for creation and manipulation of "
1905"partition tables. It understands GPT, MBR, Sun, SGI and BSD partition "
1906"tables.\n"
1907msgstr ""
1908
1909#. type: Plain text
1910#: ../disk-utils/fdisk.8.adoc:32
1911msgid ""
1912"Block devices can be divided into one or more logical disks called "
1913"_partitions_. This division is recorded in the _partition table_, usually "
1914"found in sector 0 of the disk. (In the BSD world one talks about `disk "
1915"slices' and a `disklabel'.)"
1916msgstr ""
1917
1918#. TRANSLATORS: Keep {plus} untranslated.
1919#. type: Plain text
1920#: ../disk-utils/fdisk.8.adoc:35
1921msgid ""
1922"All partitioning is driven by device I/O limits (the topology) by "
1923"default. *fdisk* is able to optimize the disk layout for a 4K-sector size "
1924"and use an alignment offset on modern devices for MBR and GPT. It is always "
1925"a good idea to follow *fdisk*'s defaults as the default values (e.g., first "
1926"and last partition sectors) and partition sizes specified by the "
1927"{plus}/-<size>{M,G,...} notation are always aligned according to the device "
1928"properties."
1929msgstr ""
1930
1931#. type: Plain text
1932#: ../disk-utils/fdisk.8.adoc:37
1933msgid ""
1934"CHS (Cylinder-Head-Sector) addressing is deprecated and not used by "
1935"default. Please, do not follow old articles and recommendations with *fdisk "
1936"-S <n> -H <n>* advices for SSD or 4K-sector devices."
1937msgstr ""
1938
1939#. type: Plain text
1940#: ../disk-utils/fdisk.8.adoc:39
1941msgid ""
1942"Note that *partx*(8) provides a rich interface for scripts to print disk "
1943"layouts, *fdisk* is mostly designed for humans. Backward compatibility in "
1944"the output of *fdisk* is not guaranteed. The input (the commands) should "
1945"always be backward compatible."
1946msgstr ""
1947
1948#. type: Labeled list
1949#: ../disk-utils/fdisk.8.adoc:42
1950#, no-wrap
1951msgid "*-b*, *--sector-size* _sectorsize_"
1952msgstr ""
1953
1954#. type: Plain text
1955#: ../disk-utils/fdisk.8.adoc:44
1956msgid ""
1957"Specify the sector size of the disk. Valid values are 512, 1024, 2048, and "
1958"4096. (Recent kernels know the sector size. Use this option only on old "
1959"kernels or to override the kernel's ideas.) Since util-linux-2.17, *fdisk* "
1960"differentiates between logical and physical sector size. This option changes "
1961"both sector sizes to _sectorsize_."
1962msgstr ""
1963
1964#. type: Labeled list
1965#: ../disk-utils/fdisk.8.adoc:45
1966#, no-wrap
1967msgid "*-B*, *--protect-boot*"
1968msgstr ""
1969
1970#. type: Plain text
1971#: ../disk-utils/fdisk.8.adoc:47
1972msgid ""
1973"Don't erase the beginning of the first disk sector when creating a new disk "
1974"label. This feature is supported for GPT and MBR."
1975msgstr ""
1976
1977#. type: Labeled list
1978#: ../disk-utils/fdisk.8.adoc:48
1979#, no-wrap
1980msgid "*-c*, *--compatibility*[=_mode_]"
1981msgstr ""
1982
1983#. type: Plain text
1984#: ../disk-utils/fdisk.8.adoc:50
1985msgid ""
1986"Specify the compatibility mode, 'dos' or 'nondos'. The default is non-DOS "
1987"mode. For backward compatibility, it is possible to use the option without "
1988"the _mode_ argument -- then the default is used. Note that the optional "
1989"_mode_ argument cannot be separated from the *-c* option by a space, the "
1990"correct form is for example *-c*=_dos_."
1991msgstr ""
1992
1993#. type: Plain text
1994#: ../disk-utils/fdisk.8.adoc:53
1995msgid "Display a help text and exit."
1996msgstr ""
1997
1998#. type: Labeled list
1999#: ../disk-utils/fdisk.8.adoc:54 ../sys-utils/dmesg.1.adoc:75
2000#: ../text-utils/hexdump.1.adoc:78
2001#, no-wrap
2002msgid "*-L*, *--color*[=_when_]"
2003msgstr ""
2004
2005#. type: Plain text
2006#: ../disk-utils/fdisk.8.adoc:56 ../disk-utils/sfdisk.8.adoc:148
2007#: ../misc-utils/cal.1.adoc:119
2008msgid ""
2009"Colorize the output. The optional argument _when_ can be *auto*, *never* or "
2010"*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
2011"colors can be disabled; for the current built-in default see the *--help* "
2012"output. See also the *COLORS* section."
2013msgstr ""
2014
2015#. type: Labeled list
2016#: ../disk-utils/fdisk.8.adoc:57 ../disk-utils/fsck.minix.8.adoc:47
2bee5365 2017#: ../disk-utils/partx.8.adoc:54 ../misc-utils/findmnt.8.adoc:76
36e96905
MB
2018#: ../misc-utils/lsblk.8.adoc:66 ../sys-utils/losetup.8.adoc:98
2019#: ../sys-utils/lsipc.1.adoc:57 ../sys-utils/lsns.8.adoc:37
2020#, no-wrap
2021msgid "*-l*, *--list*"
2022msgstr ""
2023
2024#. type: Plain text
2025#: ../disk-utils/fdisk.8.adoc:59
2026msgid "List the partition tables for the specified devices and then exit."
2027msgstr ""
2028
2029#. type: Plain text
2030#: ../disk-utils/fdisk.8.adoc:61
2031msgid ""
2032"If no devices are given, the devices mentioned in _/proc/partitions_ (if "
2033"this file exists) are used. Devices are always listed in the order in which "
2034"they are specified on the command-line, or by the kernel listed in "
2035"_/proc/partitions_."
2036msgstr ""
2037
2038#. type: Labeled list
2039#: ../disk-utils/fdisk.8.adoc:62
2040#, no-wrap
2041msgid "*-x*, *--list-details*"
2042msgstr ""
2043
2044#. type: Plain text
2045#: ../disk-utils/fdisk.8.adoc:64
2046msgid "Like *--list*, but provides more details."
2047msgstr ""
2048
2049#. type: Labeled list
2050#: ../disk-utils/fdisk.8.adoc:68
2051#, no-wrap
2052msgid "*-n*, *--noauto-pt*"
2053msgstr ""
2054
2055#. type: Plain text
2056#: ../disk-utils/fdisk.8.adoc:70
2057msgid ""
2058"Don't automatically create a default partition table on empty device. The "
2059"partition table has to be explicitly created by user (by command like 'o', "
2060"'g', etc.)."
2061msgstr ""
2062
2063#. type: Labeled list
2064#: ../disk-utils/fdisk.8.adoc:71 ../disk-utils/partx.8.adoc:69
2065#: ../disk-utils/sfdisk.8.adoc:186 ../login-utils/lslogins.1.adoc:72
2bee5365 2066#: ../misc-utils/fincore.1.adoc:37 ../misc-utils/findmnt.8.adoc:95
36e96905
MB
2067#: ../misc-utils/lsblk.8.adoc:78 ../misc-utils/lslocks.8.adoc:48
2068#: ../sys-utils/irqtop.1.adoc:25 ../sys-utils/lsipc.1.adoc:69
2069#: ../sys-utils/lsirq.1.adoc:28 ../sys-utils/lsmem.1.adoc:48
2070#: ../sys-utils/lsns.8.adoc:43 ../sys-utils/wdctl.8.adoc:39
2071#: ../sys-utils/zramctl.8.adoc:50
2072#, no-wrap
2073msgid "*-o*, *--output* _list_"
2074msgstr ""
2075
2076#. type: Plain text
2077#: ../disk-utils/fdisk.8.adoc:73 ../disk-utils/sfdisk.8.adoc:188
2078#: ../misc-utils/lslocks.8.adoc:50 ../misc-utils/uuidparse.1.adoc:58
2079#: ../misc-utils/wipefs.8.adoc:63 ../sys-utils/lsipc.1.adoc:71
2080#: ../sys-utils/lsns.8.adoc:45
2081msgid ""
2082"Specify which output columns to print. Use *--help* to get a list of all "
2083"supported columns."
2084msgstr ""
2085
2086#. TRANSLATORS: Keep {plus} untranslated.
2087#. type: Plain text
2088#: ../disk-utils/fdisk.8.adoc:76
2089msgid ""
2090"The default list of columns may be extended if _list_ is specified in the "
2091"format _{plus}list_ (e.g., *-o {plus}UUID*)."
2092msgstr ""
2093
2094#. type: Labeled list
2095#: ../disk-utils/fdisk.8.adoc:77
2096#, no-wrap
2097msgid "*-s*, *--getsz*"
2098msgstr ""
2099
2100#. type: Plain text
2101#: ../disk-utils/fdisk.8.adoc:79
2102msgid ""
2103"Print the size in 512-byte sectors of each given block device. This option "
2104"is DEPRECATED in favour of *blockdev*(8)."
2105msgstr ""
2106
2107#. type: Labeled list
2108#: ../disk-utils/fdisk.8.adoc:80 ../disk-utils/mkfs.8.adoc:29
2109#: ../disk-utils/partx.8.adoc:84 ../sys-utils/lsns.8.adoc:57
2110#, no-wrap
2111msgid "*-t*, *--type* _type_"
2112msgstr ""
2113
2114#. type: Plain text
2115#: ../disk-utils/fdisk.8.adoc:82
2116msgid ""
2117"Enable support only for disklabels of the specified _type_, and disable "
2118"support for all other types."
2119msgstr ""
2120
2121#. type: Labeled list
2122#: ../disk-utils/fdisk.8.adoc:83
2123#, no-wrap
2124msgid "*-u*, *--units*[=_unit_]"
2125msgstr ""
2126
2127#. type: Plain text
2128#: ../disk-utils/fdisk.8.adoc:85
2129msgid ""
2130"When listing partition tables, show sizes in 'sectors' or in "
2131"'cylinders'. The default is to show sizes in sectors. For backward "
2132"compatibility, it is possible to use the option without the _unit_ argument "
2133"-- then the default is used. Note that the optional _unit_ argument cannot "
2134"be separated from the *-u* option by a space, the correct form is for "
2135"example '*-u=*_cylinders_'."
2136msgstr ""
2137
2138#. type: Labeled list
2139#: ../disk-utils/fdisk.8.adoc:86
2140#, no-wrap
2141msgid "*-C*, *--cylinders* _number_"
2142msgstr ""
2143
2144#. type: Plain text
2145#: ../disk-utils/fdisk.8.adoc:88
2146msgid ""
2147"Specify the number of cylinders of the disk. I have no idea why anybody "
2148"would want to do so."
2149msgstr ""
2150
2151#. type: Labeled list
2152#: ../disk-utils/fdisk.8.adoc:89
2153#, no-wrap
2154msgid "*-H*, *--heads* _number_"
2155msgstr ""
2156
2157#. type: Plain text
2158#: ../disk-utils/fdisk.8.adoc:91
2159msgid ""
2160"Specify the number of heads of the disk. (Not the physical number, of "
2161"course, but the number used for partition tables.) Reasonable values are 255 "
2162"and 16."
2163msgstr ""
2164
2165#. type: Labeled list
2166#: ../disk-utils/fdisk.8.adoc:92
2167#, no-wrap
2168msgid "*-S*, *--sectors* _number_"
2169msgstr ""
2170
2171#. type: Plain text
2172#: ../disk-utils/fdisk.8.adoc:94
2173msgid ""
2174"Specify the number of sectors per track of the disk. (Not the physical "
2175"number, of course, but the number used for partition tables.) A reasonable "
2176"value is 63."
2177msgstr ""
2178
2179#. type: Labeled list
2180#: ../disk-utils/fdisk.8.adoc:95 ../disk-utils/sfdisk.8.adoc:204
2181#, no-wrap
2182msgid "*-w*, *--wipe* _when_"
2183msgstr ""
2184
2185#. type: Plain text
2186#: ../disk-utils/fdisk.8.adoc:97
2187msgid ""
2188"Wipe filesystem, RAID and partition-table signatures from the device, in "
2189"order to avoid possible collisions. The argument _when_ can be *auto*, "
2190"*never* or *always*. When this option is not given, the default is *auto*, "
2191"in which case signatures are wiped only when in interactive mode. In all "
2192"cases detected signatures are reported by warning messages before a new "
2193"partition table is created. See also *wipefs*(8) command."
2194msgstr ""
2195
2196#. type: Labeled list
2197#: ../disk-utils/fdisk.8.adoc:98 ../disk-utils/sfdisk.8.adoc:207
2198#, no-wrap
2199msgid "*-W*, *--wipe-partitions* _when_"
2200msgstr ""
2201
2202#. type: Plain text
2203#: ../disk-utils/fdisk.8.adoc:100
2204msgid ""
2205"Wipe filesystem, RAID and partition-table signatures from a newly created "
2206"partitions, in order to avoid possible collisions. The argument _when_ can "
2207"be *auto*, *never* or *always*. When this option is not given, the default "
2208"is *auto*, in which case signatures are wiped only when in interactive mode "
2209"and after confirmation by user. In all cases detected signatures are "
2210"reported by warning messages before a new partition is created. See also "
2211"*wipefs*(8) command."
2212msgstr ""
2213
2214#. type: Title ==
2215#: ../disk-utils/fdisk.8.adoc:104
2216#, no-wrap
2217msgid "DEVICES"
2218msgstr ""
2219
2220#. type: Plain text
2221#: ../disk-utils/fdisk.8.adoc:107
2222msgid ""
2223"The _device_ is usually _/dev/sda_, _/dev/sdb_ or so. A device name refers "
2224"to the entire disk. Old systems without libata (a library used inside the "
2225"Linux kernel to support ATA host controllers and devices) make a difference "
2226"between IDE and SCSI disks. In such cases the device name will be _/dev/hd*_ "
2227"(IDE) or _/dev/sd*_ (SCSI)."
2228msgstr ""
2229
2230#. type: Plain text
2231#: ../disk-utils/fdisk.8.adoc:109
2232msgid ""
2233"The _partition_ is a device name followed by a partition number. For "
2234"example, _/dev/sda1_ is the first partition on the first hard disk in the "
2235"system. See also Linux kernel documentation (the "
2236"_Documentation/admin-guide/devices.txt_ file)."
2237msgstr ""
2238
2239#. type: Title ==
2240#: ../disk-utils/fdisk.8.adoc:110
2241#, no-wrap
2242msgid "SIZES"
2243msgstr ""
2244
2245#. TRANSLATORS: Keep {plus} untranslated.
2246#. type: Plain text
2247#: ../disk-utils/fdisk.8.adoc:115
2248msgid ""
2249"The \"last sector\" dialog accepts partition size specified by number of "
2250"sectors or by {plus}/-<size>{K,B,M,G,...} notation."
2251msgstr ""
2252
2253#. TRANSLATORS: Keep {plus} untranslated.
2254#. type: Plain text
2255#: ../disk-utils/fdisk.8.adoc:119
2256msgid ""
2257"If the size is prefixed by '{plus}' then it is interpreted as relative to "
2258"the partition first sector. If the size is prefixed by '-' then it is "
2259"interpreted as relative to the high limit (last available sector for the "
2260"partition)."
2261msgstr ""
2262
2263#. type: Plain text
2264#: ../disk-utils/fdisk.8.adoc:121
2265msgid ""
2266"In the case the size is specified in bytes than the number may be followed "
2267"by the multiplicative suffixes KiB=1024, MiB=1024*1024, and so on for GiB, "
2268"TiB, PiB, EiB, ZiB and YiB. The \"iB\" is optional, e.g., \"K\" has the same "
2269"meaning as \"KiB\"."
2270msgstr ""
2271
2272#. TRANSLATORS: Keep {plus} untranslated.
2273#. type: Plain text
2274#: ../disk-utils/fdisk.8.adoc:125
2275msgid ""
2276"The relative sizes are always aligned according to device I/O limits. The "
2277"{plus}/-<size>{K,B,M,G,...} notation is recommended."
2278msgstr ""
2279
2280#. type: Plain text
2281#: ../disk-utils/fdisk.8.adoc:127
2282msgid ""
2283"For backward compatibility fdisk also accepts the suffixes KB=1000, "
2284"MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB. These 10^N suffixes "
2285"are deprecated."
2286msgstr ""
2287
2288#. type: Title ==
2289#: ../disk-utils/fdisk.8.adoc:128
2290#, no-wrap
2291msgid "SCRIPT FILES"
2292msgstr ""
2293
2294#. type: Plain text
2295#: ../disk-utils/fdisk.8.adoc:131
2296#, no-wrap
2297msgid ""
2298"*fdisk* allows reading (by 'I' command) *sfdisk*(8) compatible script "
2299"files. The script is applied to in-memory partition table, and then it is "
2300"possible to modify the partition table before you write it to the device.\n"
2301msgstr ""
2302
2303#. type: Plain text
2304#: ../disk-utils/fdisk.8.adoc:133
2305msgid ""
2306"And vice-versa it is possible to write the current in-memory disk layout to "
2307"the script file by command 'O'."
2308msgstr ""
2309
2310#. type: Plain text
2311#: ../disk-utils/fdisk.8.adoc:135
2312msgid ""
2313"The script files are compatible between *cfdisk*(8), *sfdisk*(8), *fdisk* "
2314"and other libfdisk applications. For more details see *sfdisk*(8)."
2315msgstr ""
2316
2317#. type: Title ==
2318#: ../disk-utils/fdisk.8.adoc:136
2319#, no-wrap
2320msgid "DISK LABELS"
2321msgstr ""
2322
2323#. type: Labeled list
2324#: ../disk-utils/fdisk.8.adoc:138
2325#, no-wrap
2326msgid "*GPT (GUID Partition Table)*"
2327msgstr ""
2328
2329#. type: Plain text
2330#: ../disk-utils/fdisk.8.adoc:140
2331msgid ""
2332"GPT is modern standard for the layout of the partition table. GPT uses "
2333"64-bit logical block addresses, checksums, UUIDs and names for partitions "
2334"and an unlimited number of partitions (although the number of partitions is "
2335"usually restricted to 128 in many partitioning tools)."
2336msgstr ""
2337
2338#. type: Plain text
2339#: ../disk-utils/fdisk.8.adoc:142
2340msgid ""
2341"Note that the first sector is still reserved for a *protective MBR* in the "
2342"GPT specification. It prevents MBR-only partitioning tools from "
2343"mis-recognizing and overwriting GPT disks."
2344msgstr ""
2345
2346#. type: Plain text
2347#: ../disk-utils/fdisk.8.adoc:144
2348msgid ""
2349"GPT is always a better choice than MBR, especially on modern hardware with a "
2350"UEFI boot loader."
2351msgstr ""
2352
2353#. type: Labeled list
2354#: ../disk-utils/fdisk.8.adoc:145
2355#, no-wrap
2356msgid "*DOS-type (MBR)*"
2357msgstr ""
2358
2359#. type: Plain text
2360#: ../disk-utils/fdisk.8.adoc:147
2361msgid ""
2362"A DOS-type partition table can describe an unlimited number of "
2363"partitions. In sector 0 there is room for the description of 4 partitions "
2364"(called `primary'). One of these may be an extended partition; this is a box "
2365"holding logical partitions, with descriptors found in a linked list of "
2366"sectors, each preceding the corresponding logical partitions. The four "
2367"primary partitions, present or not, get numbers 1-4. Logical partitions are "
2368"numbered starting from 5."
2369msgstr ""
2370
2371#. TRANSLATORS: Keep {plus} untranslated.
2372#. type: Plain text
2373#: ../disk-utils/fdisk.8.adoc:150
2374msgid ""
2375"In a DOS-type partition table the starting offset and the size of each "
2376"partition is stored in two ways: as an absolute number of sectors (given in "
2377"32 bits), and as a *Cylinders/Heads/Sectors* triple (given in "
2378"10{plus}8{plus}6 bits). The former is OK -- with 512-byte sectors this will "
2379"work up to 2 TB. The latter has two problems. First, these C/H/S fields can "
2380"be filled only when the number of heads and the number of sectors per track "
2381"are known. And second, even if we know what these numbers should be, the 24 "
2382"bits that are available do not suffice. DOS uses C/H/S only, Windows uses "
2383"both, Linux never uses C/H/S. The *C/H/S addressing is deprecated* and may "
2384"be unsupported in some later *fdisk* version."
2385msgstr ""
2386
2387#. type: Plain text
2388#: ../disk-utils/fdisk.8.adoc:152
2389#, no-wrap
2390msgid ""
2391"*Please, read the DOS-mode section if you want DOS-compatible partitions.* "
2392"*fdisk* does not care about cylinder boundaries by default.\n"
2393msgstr ""
2394
2395#. type: Labeled list
2396#: ../disk-utils/fdisk.8.adoc:153
2397#, no-wrap
2398msgid "*BSD/Sun-type*"
2399msgstr ""
2400
2401#. type: Plain text
2402#: ../disk-utils/fdisk.8.adoc:155
2403msgid ""
2404"A BSD/Sun disklabel can describe 8 partitions, the third of which should be "
2405"a `whole disk' partition. Do not start a partition that actually uses its "
2406"first sector (like a swap partition) at cylinder 0, since that will destroy "
2407"the disklabel. Note that a *BSD label* is usually nested within a DOS "
2408"partition."
2409msgstr ""
2410
2411#. type: Labeled list
2412#: ../disk-utils/fdisk.8.adoc:156
2413#, no-wrap
2414msgid "*IRIX/SGI-type*"
2415msgstr ""
2416
2417#. type: Plain text
2418#: ../disk-utils/fdisk.8.adoc:158
2419msgid ""
2420"An IRIX/SGI disklabel can describe 16 partitions, the eleventh of which "
2421"should be an entire `volume' partition, while the ninth should be labeled "
2422"`volume header'. The volume header will also cover the partition table, "
2423"i.e., it starts at block zero and extends by default over five "
2424"cylinders. The remaining space in the volume header may be used by header "
2425"directory entries. No partitions may overlap with the volume header. Also do "
2426"not change its type or make some filesystem on it, since you will lose the "
2427"partition table. Use this type of label only when working with Linux on "
2428"IRIX/SGI machines or IRIX/SGI disks under Linux."
2429msgstr ""
2430
2431#. type: Plain text
2432#: ../disk-utils/fdisk.8.adoc:160
2433msgid ""
2434"A sync() and an ioctl(BLKRRPART) (rereading the partition table from disk) "
2435"are performed before exiting when the partition table has been updated."
2436msgstr ""
2437
2438#. type: Title ==
2439#: ../disk-utils/fdisk.8.adoc:161
2440#, no-wrap
2441msgid "DOS mode and DOS 6.x WARNING"
2442msgstr ""
2443
2444#. type: Plain text
2445#: ../disk-utils/fdisk.8.adoc:164
2446#, no-wrap
2447msgid ""
2448"*Note that all this is deprecated. You don't have to care about things like* "
2449"*geometry and cylinders on modern operating systems. If you really want* "
2450"*DOS-compatible partitioning then you have to enable DOS mode and cylinder* "
2451"*units by using the '-c=dos -u=cylinders' fdisk command-line options.*\n"
2452msgstr ""
2453
2454#. type: Plain text
2455#: ../disk-utils/fdisk.8.adoc:166
2456msgid ""
2457"The DOS 6.x FORMAT command looks for some information in the first sector of "
2458"the data area of the partition, and treats this information as more reliable "
2459"than the information in the partition table. DOS FORMAT expects DOS FDISK to "
2460"clear the first 512 bytes of the data area of a partition whenever a size "
2461"change occurs. DOS FORMAT will look at this extra information even if the /U "
2462"flag is given -- we consider this a bug in DOS FORMAT and DOS FDISK."
2463msgstr ""
2464
2465#. type: Plain text
2466#: ../disk-utils/fdisk.8.adoc:168
2467msgid ""
2468"The bottom line is that if you use *fdisk* or *cfdisk* to change the size of "
2469"a DOS partition table entry, then you must also use *dd*(1) to *zero the "
2470"first 512 bytes* of that partition before using DOS FORMAT to format the "
2471"partition. For example, if you were using *fdisk* to make a DOS partition "
2472"table entry for _/dev/sda1_, then (after exiting *fdisk* and rebooting Linux "
2473"so that the partition table information is valid) you would use the command "
2474"*dd if=/dev/zero of=/dev/sda1 bs=512 count=1* to zero the first 512 bytes of "
2475"the partition."
2476msgstr ""
2477
2478#. type: Plain text
2479#: ../disk-utils/fdisk.8.adoc:170
2480#, no-wrap
2481msgid ""
2482"*fdisk* usually obtains the disk geometry automatically. This is not "
2483"necessarily the physical disk geometry (indeed, modern disks do not really "
2484"have anything like a physical geometry, certainly not something that can be "
2485"described in the simplistic Cylinders/Heads/Sectors form), but it is the "
2486"disk geometry that MS-DOS uses for the partition table.\n"
2487msgstr ""
2488
2489#. type: Plain text
2490#: ../disk-utils/fdisk.8.adoc:172
2491msgid ""
2492"Usually all goes well by default, and there are no problems if Linux is the "
2493"only system on the disk. However, if the disk has to be shared with other "
2494"operating systems, it is often a good idea to let an *fdisk* from another "
2495"operating system make at least one partition. When Linux boots it looks at "
2496"the partition table, and tries to deduce what (fake) geometry is required "
2497"for good cooperation with other systems."
2498msgstr ""
2499
2500#. type: Plain text
2501#: ../disk-utils/fdisk.8.adoc:174
2502msgid ""
2503"Whenever a partition table is printed out in DOS mode, a consistency check "
2504"is performed on the partition table entries. This check verifies that the "
2505"physical and logical start and end points are identical, and that each "
2506"partition starts and ends on a cylinder boundary (except for the first "
2507"partition)."
2508msgstr ""
2509
2510#. type: Plain text
2511#: ../disk-utils/fdisk.8.adoc:176
2512msgid ""
2513"Some versions of MS-DOS create a first partition which does not begin on a "
2514"cylinder boundary, but on sector 2 of the first cylinder. Partitions "
2515"beginning in cylinder 1 cannot begin on a cylinder boundary, but this is "
2516"unlikely to cause difficulty unless you have OS/2 on your machine."
2517msgstr ""
2518
2519#. type: Plain text
2520#: ../disk-utils/fdisk.8.adoc:178
2521msgid ""
2522"For best results, you should always use an OS-specific partition table "
2523"program. For example, you should make DOS partitions with the DOS FDISK "
2524"program and Linux partitions with the Linux *fdisk* or Linux *cfdisk*(8) "
2525"programs."
2526msgstr ""
2527
2528#. type: Plain text
2529#: ../disk-utils/fdisk.8.adoc:182
2530msgid ""
2531"Implicit coloring can be disabled by an empty file "
2532"_/etc/terminal-colors.d/fdisk.disable_."
2533msgstr ""
2534
2535#. type: Plain text
2536#: ../disk-utils/fdisk.8.adoc:184
2537msgid ""
2538"See *terminal-colors.d*(5) for more details about colorization "
2539"configuration. The logical color names supported by *fdisk* are:"
2540msgstr ""
2541
2542#. type: Labeled list
2543#: ../disk-utils/fdisk.8.adoc:185 ../disk-utils/sfdisk.8.adoc:378
2544#, no-wrap
2545msgid "*header*"
2546msgstr ""
2547
2548#. type: Plain text
2549#: ../disk-utils/fdisk.8.adoc:187 ../disk-utils/sfdisk.8.adoc:380
2550msgid "The header of the output tables."
2551msgstr ""
2552
2553#. type: Labeled list
2554#: ../disk-utils/fdisk.8.adoc:188
2555#, no-wrap
2556msgid "*help-title*"
2557msgstr ""
2558
2559#. type: Plain text
2560#: ../disk-utils/fdisk.8.adoc:190
2561msgid "The help section titles."
2562msgstr ""
2563
2564#. type: Labeled list
2565#: ../disk-utils/fdisk.8.adoc:191 ../disk-utils/sfdisk.8.adoc:380
2566#: ../sys-utils/dmesg.1.adoc:171
2567#, no-wrap
2568msgid "*warn*"
2569msgstr ""
2570
2571#. type: Plain text
2572#: ../disk-utils/fdisk.8.adoc:193 ../disk-utils/sfdisk.8.adoc:382
2573msgid "The warning messages."
2574msgstr ""
2575
2576#. type: Labeled list
2577#: ../disk-utils/fdisk.8.adoc:194 ../disk-utils/sfdisk.8.adoc:382
2578#, no-wrap
2579msgid "*welcome*"
2580msgstr ""
2581
2582#. type: Plain text
2583#: ../disk-utils/fdisk.8.adoc:196 ../disk-utils/sfdisk.8.adoc:384
2584msgid "The welcome message."
2585msgstr ""
2586
2587#. type: Labeled list
2588#: ../disk-utils/fdisk.8.adoc:199
2589#, no-wrap
2590msgid "*FDISK_DEBUG*=all"
2591msgstr ""
2592
2593#. type: Plain text
2594#: ../disk-utils/fdisk.8.adoc:201
2595msgid "enables fdisk debug output."
2596msgstr ""
2597
2598#. type: Plain text
2599#: ../disk-utils/fdisk.8.adoc:221
2600msgid "mailto:kzak@redhat.com[Karel Zak], mailto:dave@gnu.org[Davidlohr Bueso]"
2601msgstr ""
2602
2603#. type: Plain text
2604#: ../disk-utils/fdisk.8.adoc:223
2605msgid ""
2606"The original version was written by Andries E. Brouwer, A. V. Le Blanc and "
2607"others."
2608msgstr ""
2609
2610#. type: Plain text
2611#: ../disk-utils/fdisk.8.adoc:230
2612#, no-wrap
2613msgid ""
2614"*cfdisk*(8),\n"
2615"*mkfs*(8),\n"
2616"*partx*(8),\n"
2617"*sfdisk*(8)\n"
2618msgstr ""
2619
2620#. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
2621#. This file may be copied under the terms of the GNU Public License.
2622#. type: Title =
2623#: ../disk-utils/fsck.8.adoc:6
2624#, no-wrap
2625msgid "fsck(8)"
2626msgstr ""
2627
2628#. type: Plain text
2629#: ../disk-utils/fsck.8.adoc:16
2630msgid "fsck - check and repair a Linux filesystem"
2631msgstr ""
2632
2633#. type: Plain text
2634#: ../disk-utils/fsck.8.adoc:20
2635#, no-wrap
2636msgid ""
2637"*fsck* [*-lsAVRTMNP*] [*-r* [_fd_]] [*-C* [_fd_] [*-t* _fstype_] "
2638"[_filesystem_...] [*--*] [_fs-specific-options_]\n"
2639msgstr ""
2640
2641#. type: Plain text
2642#: ../disk-utils/fsck.8.adoc:24
2643#, no-wrap
2644msgid ""
2645"*fsck* is used to check and optionally repair one or more Linux "
2646"filesystems. _filesystem_ can be a device name (e.g., _/dev/hdc1_, "
2647"_/dev/sdb2_), a mount point (e.g., _/_, _/usr_, _/home_), or an filesystem "
2648"label or UUID specifier (e.g., UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd or "
2649"LABEL=root). Normally, the *fsck* program will try to handle filesystems on "
2650"different physical disk drives in parallel to reduce the total amount of "
2651"time needed to check all of them.\n"
2652msgstr ""
2653
2654#. type: Plain text
2655#: ../disk-utils/fsck.8.adoc:26
2656msgid ""
2657"If no filesystems are specified on the command line, and the *-A* option is "
2658"not specified, *fsck* will default to checking filesystems in _/etc/fstab_ "
2659"serially. This is equivalent to the *-As* options."
2660msgstr ""
2661
2662#. type: Plain text
2663#: ../disk-utils/fsck.8.adoc:28
2664msgid "The exit status returned by *fsck* is the sum of the following conditions:"
2665msgstr ""
2666
2667#. type: Labeled list
2668#: ../disk-utils/fsck.8.adoc:29 ../disk-utils/fsck.cramfs.8.adoc:46
2669#: ../disk-utils/fsck.minix.8.adoc:84 ../disk-utils/isosize.8.adoc:33
2670#: ../disk-utils/mkfs.cramfs.8.adoc:73 ../misc-utils/findfs.8.adoc:49
2671#: ../misc-utils/kill.1.adoc:43 ../misc-utils/kill.1.adoc:87
2672#: ../misc-utils/rename.1.adoc:60 ../sys-utils/chcpu.8.adoc:63
2673#: ../sys-utils/chmem.8.adoc:62 ../sys-utils/mount.8.adoc:1359
2674#: ../sys-utils/mountpoint.1.adoc:47 ../sys-utils/swapon.8.adoc:99
2675#: ../term-utils/mesg.1.adoc:84
2676#, no-wrap
2677msgid "*0*"
2678msgstr ""
2679
2680#. type: Plain text
2681#: ../disk-utils/fsck.8.adoc:31 ../disk-utils/fsck.minix.8.adoc:86
2682#: ../disk-utils/mkfs.minix.8.adoc:84
2683msgid "No errors"
2684msgstr ""
2685
2686#. type: Labeled list
2687#: ../disk-utils/fsck.8.adoc:31 ../disk-utils/isosize.8.adoc:35
2688#: ../misc-utils/findfs.8.adoc:51 ../misc-utils/kill.1.adoc:89
2689#: ../misc-utils/rename.1.adoc:63 ../sys-utils/chcpu.8.adoc:66
2690#: ../sys-utils/chmem.8.adoc:65 ../sys-utils/mount.8.adoc:1362
2691#: ../sys-utils/mountpoint.1.adoc:50 ../term-utils/mesg.1.adoc:86
2692#, no-wrap
2693msgid "*1*"
2694msgstr ""
2695
2696#. type: Plain text
2697#: ../disk-utils/fsck.8.adoc:33
2698msgid "Filesystem errors corrected"
2699msgstr ""
2700
2701#. type: Labeled list
2702#: ../disk-utils/fsck.8.adoc:33 ../misc-utils/findfs.8.adoc:53
2703#: ../misc-utils/rename.1.adoc:66 ../sys-utils/mount.8.adoc:766
2704#: ../sys-utils/mount.8.adoc:1365 ../sys-utils/swapon.8.adoc:102
2705#, no-wrap
2706msgid "*2*"
2707msgstr ""
2708
2709#. type: Plain text
2710#: ../disk-utils/fsck.8.adoc:35
2711msgid "System should be rebooted"
2712msgstr ""
2713
2714#. type: Labeled list
2715#: ../disk-utils/fsck.8.adoc:35 ../disk-utils/fsck.cramfs.8.adoc:48
2716#: ../disk-utils/fsck.minix.8.adoc:88 ../misc-utils/rename.1.adoc:69
2717#: ../sys-utils/mount.8.adoc:1368 ../sys-utils/swapon.8.adoc:105
2718#, no-wrap
2719msgid "*4*"
2720msgstr ""
2721
2722#. type: delimited block _
2723#: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.minix.8.adoc:90
2724msgid "Filesystem errors left uncorrected"
2725msgstr ""
2726
2727#. type: Labeled list
2728#: ../disk-utils/fsck.8.adoc:37 ../disk-utils/fsck.cramfs.8.adoc:50
2729#: ../disk-utils/fsck.minix.8.adoc:92 ../disk-utils/mkfs.cramfs.8.adoc:75
2730#: ../sys-utils/mount.8.adoc:1371 ../sys-utils/swapon.8.adoc:108
2731#, no-wrap
2732msgid "*8*"
2733msgstr ""
2734
2735#. type: Plain text
2736#: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.minix.8.adoc:94
2737#: ../disk-utils/mkfs.minix.8.adoc:86
2738msgid "Operational error"
2739msgstr ""
2740
2741#. type: Labeled list
2742#: ../disk-utils/fsck.8.adoc:39 ../disk-utils/fsck.cramfs.8.adoc:52
2743#: ../disk-utils/fsck.minix.8.adoc:94 ../sys-utils/mount.8.adoc:1374
2744#: ../sys-utils/swapon.8.adoc:111
2745#, no-wrap
2746msgid "*16*"
2747msgstr ""
2748
2749#. type: Plain text
2750#: ../disk-utils/fsck.8.adoc:41 ../disk-utils/fsck.minix.8.adoc:96
2751#: ../disk-utils/mkfs.minix.8.adoc:88
2752msgid "Usage or syntax error"
2753msgstr ""
2754
2755#. type: Labeled list
2756#: ../disk-utils/fsck.8.adoc:41 ../disk-utils/isosize.8.adoc:37
2757#: ../schedutils/taskset.1.adoc:58 ../sys-utils/mount.8.adoc:1377
2758#: ../sys-utils/mountpoint.1.adoc:53 ../sys-utils/swapon.8.adoc:114
2759#, no-wrap
2760msgid "*32*"
2761msgstr ""
2762
2763#. type: Plain text
2764#: ../disk-utils/fsck.8.adoc:43
2765msgid "Checking canceled by user request"
2766msgstr ""
2767
2768#. type: Labeled list
2769#: ../disk-utils/fsck.8.adoc:43
2770#, no-wrap
2771msgid "*128*"
2772msgstr ""
2773
2774#. type: Plain text
2775#: ../disk-utils/fsck.8.adoc:45
2776msgid "Shared-library error"
2777msgstr ""
2778
2779#. type: Plain text
2780#: ../disk-utils/fsck.8.adoc:47
2781msgid ""
2782"The exit status returned when multiple filesystems are checked is the "
2783"bit-wise OR of the exit statuses for each filesystem that is checked."
2784msgstr ""
2785
2786#. type: Plain text
2787#: ../disk-utils/fsck.8.adoc:49
2788msgid ""
2789"In actuality, *fsck* is simply a front-end for the various filesystem "
2790"checkers (*fsck*._fstype_) available under Linux. The filesystem-specific "
2791"checker is searched for in the *PATH* environment variable. If the *PATH* is "
2792"undefined then fallback to _/sbin_."
2793msgstr ""
2794
2795#. type: Plain text
2796#: ../disk-utils/fsck.8.adoc:51
2797msgid "Please see the filesystem-specific checker manual pages for further details."
2798msgstr ""
2799
2800#. type: Labeled list
2801#: ../disk-utils/fsck.8.adoc:54 ../disk-utils/mkfs.bfs.8.adoc:44
2802#: ../misc-utils/whereis.1.adoc:97
2803#, no-wrap
2804msgid "*-l*"
2805msgstr ""
2806
2807#. type: Plain text
2808#: ../disk-utils/fsck.8.adoc:56
2809msgid ""
2810"Create an exclusive *flock*(2) lock file (_/run/fsck/<diskname>.lock_) for "
2811"whole-disk device. This option can be used with one device only (this means "
2812"that *-A* and *-l* are mutually exclusive). This option is recommended when "
2813"more *fsck* instances are executed in the same time. The option is ignored "
2814"when used for multiple devices or for non-rotating disks. *fsck* does not "
2815"lock underlying devices when executed to check stacked devices (e.g. MD or "
2816"DM) - this feature is not implemented yet."
2817msgstr ""
2818
2819#. type: Labeled list
2820#: ../disk-utils/fsck.8.adoc:57
2821#, no-wrap
2822msgid "*-r* [_fd_]"
2823msgstr ""
2824
2825#. type: Plain text
2826#: ../disk-utils/fsck.8.adoc:59
2827msgid ""
2828"Report certain statistics for each fsck when it completes. These statistics "
2829"include the exit status, the maximum run set size (in kilobytes), the "
2830"elapsed all-clock time and the user and system CPU time used by the fsck "
2831"run. For example:"
2832msgstr ""
2833
2834#. type: Plain text
2835#: ../disk-utils/fsck.8.adoc:61
2836#, no-wrap
2837msgid ""
2838"*/dev/sda1: status 0, rss 92828, real 4.002804, user 2.677592, sys "
2839"0.86186*\n"
2840msgstr ""
2841
2842#. type: Plain text
2843#: ../disk-utils/fsck.8.adoc:63
2844msgid ""
2845"GUI front-ends may specify a file descriptor _fd_, in which case the "
2846"progress bar information will be sent to that file descriptor in a machine "
2847"parsable format. For example:"
2848msgstr ""
2849
2850#. type: Plain text
2851#: ../disk-utils/fsck.8.adoc:65
2852#, no-wrap
2853msgid "*/dev/sda1 0 92828 4.002804 2.677592 0.86186*\n"
2854msgstr ""
2855
2856#. type: Labeled list
2857#: ../disk-utils/fsck.8.adoc:66 ../disk-utils/mkfs.cramfs.8.adoc:59
2858#: ../misc-utils/whereis.1.adoc:79 ../sys-utils/mount.8.adoc:385
2859#: ../text-utils/pg.1.adoc:59
2860#, no-wrap
2861msgid "*-s*"
2862msgstr ""
2863
2864#. type: Plain text
2865#: ../disk-utils/fsck.8.adoc:68
2866msgid ""
2867"Serialize *fsck* operations. This is a good idea if you are checking "
2868"multiple filesystems and the checkers are in an interactive mode. (Note: "
2869"*e2fsck*(8) runs in an interactive mode by default. To make *e2fsck*(8) run "
2870"in a non-interactive mode, you must either specify the *-p* or *-a* option, "
2871"if you wish for errors to be corrected automatically, or the *-n* option if "
2872"you do not.)"
2873msgstr ""
2874
2875#. type: Labeled list
2876#: ../disk-utils/fsck.8.adoc:69
2877#, no-wrap
2878msgid "*-t* _fslist_"
2879msgstr ""
2880
2881#. type: Plain text
2882#: ../disk-utils/fsck.8.adoc:71
2883msgid ""
2884"Specifies the type(s) of filesystem to be checked. When the *-A* flag is "
2885"specified, only filesystems that match _fslist_ are checked. The _fslist_ "
2886"parameter is a comma-separated list of filesystems and options "
2887"specifiers. All of the filesystems in this comma-separated list may be "
2888"prefixed by a negation operator '*no*' or '*!*', which requests that only "
2889"those filesystems not listed in _fslist_ will be checked. If none of the "
2890"filesystems in _fslist_ is prefixed by a negation operator, then only those "
2891"listed filesystems will be checked."
2892msgstr ""
2893
2894#. type: Plain text
2895#: ../disk-utils/fsck.8.adoc:73
2896msgid ""
2897"Options specifiers may be included in the comma-separated _fslist_. They "
2898"must have the format **opts=**__fs-option__. If an options specifier is "
2899"present, then only filesystems which contain _fs-option_ in their mount "
2900"options field of _/etc/fstab_ will be checked. If the options specifier is "
2901"prefixed by a negation operator, then only those filesystems that do not "
2902"have _fs-option_ in their mount options field of _/etc/fstab_ will be "
2903"checked."
2904msgstr ""
2905
2906#. type: Plain text
2907#: ../disk-utils/fsck.8.adoc:75
2908msgid ""
2909"For example, if *opts=ro* appears in _fslist_, then only filesystems listed "
2910"in _/etc/fstab_ with the *ro* option will be checked."
2911msgstr ""
2912
2913#. type: Plain text
2914#: ../disk-utils/fsck.8.adoc:77
2915msgid ""
2916"For compatibility with Mandrake distributions whose boot scripts depend upon "
2917"an unauthorized UI change to the *fsck* program, if a filesystem type of "
2918"*loop* is found in _fslist_, it is treated as if *opts=loop* were specified "
2919"as an argument to the *-t* option."
2920msgstr ""
2921
2922#. type: Plain text
2923#: ../disk-utils/fsck.8.adoc:79
2924msgid ""
2925"Normally, the filesystem type is deduced by searching for _filesys_ in the "
2926"_/etc/fstab_ file and using the corresponding entry. If the type cannot be "
2927"deduced, and there is only a single filesystem given as an argument to the "
2928"*-t* option, *fsck* will use the specified filesystem type. If this type is "
2929"not available, then the default filesystem type (currently ext2) is used."
2930msgstr ""
2931
2932#. type: Labeled list
2933#: ../disk-utils/fsck.8.adoc:80
2934#, no-wrap
2935msgid "*-A*"
2936msgstr ""
2937
2938#. type: Plain text
2939#: ../disk-utils/fsck.8.adoc:82
2940msgid ""
2941"Walk through the _/etc/fstab_ file and try to check all filesystems in one "
2942"run. This option is typically used from the _/etc/rc_ system initialization "
2943"file, instead of multiple commands for checking a single filesystem."
2944msgstr ""
2945
2946#. type: Plain text
2947#: ../disk-utils/fsck.8.adoc:84
2948msgid ""
2949"The root filesystem will be checked first unless the *-P* option is "
2950"specified (see below). After that, filesystems will be checked in the order "
2951"specified by the _fs_passno_ (the sixth) field in the _/etc/fstab_ "
2952"file. Filesystems with a _fs_passno_ value of 0 are skipped and are not "
2953"checked at all. Filesystems with a _fs_passno_ value of greater than zero "
2954"will be checked in order, with filesystems with the lowest _fs_passno_ "
2955"number being checked first. If there are multiple filesystems with the same "
2956"pass number, *fsck* will attempt to check them in parallel, although it will "
2957"avoid running multiple filesystem checks on the same physical disk."
2958msgstr ""
2959
2960#. type: Plain text
2961#: ../disk-utils/fsck.8.adoc:86
2962#, no-wrap
2963msgid ""
2964"*fsck* does not check stacked devices (RAIDs, dm-crypt, ...) in parallel "
2965"with any other device. See below for *FSCK_FORCE_ALL_PARALLEL* setting. The "
2966"_/sys_ filesystem is used to determine dependencies between devices.\n"
2967msgstr ""
2968
2969#. type: Plain text
2970#: ../disk-utils/fsck.8.adoc:88
2971msgid ""
2972"Hence, a very common configuration in _/etc/fstab_ files is to set the root "
2973"filesystem to have a _fs_passno_ value of 1 and to set all other filesystems "
2974"to have a _fs_passno_ value of 2. This will allow *fsck* to automatically "
2975"run filesystem checkers in parallel if it is advantageous to do so. System "
2976"administrators might choose not to use this configuration if they need to "
2977"avoid multiple filesystem checks running in parallel for some reason - for "
2978"example, if the machine in question is short on memory so that excessive "
2979"paging is a concern."
2980msgstr ""
2981
2982#. type: Plain text
2983#: ../disk-utils/fsck.8.adoc:90
2984#, no-wrap
2985msgid ""
2986"*fsck* normally does not check whether the device actually exists before "
2987"calling a filesystem specific checker. Therefore non-existing devices may "
2988"cause the system to enter filesystem repair mode during boot if the "
2989"filesystem specific checker returns a fatal error. The _/etc/fstab_ mount "
2990"option *nofail* may be used to have *fsck* skip non-existing devices. *fsck* "
2991"also skips non-existing devices that have the special filesystem type "
2992"*auto*.\n"
2993msgstr ""
2994
2995#. type: Labeled list
2996#: ../disk-utils/fsck.8.adoc:91
2997#, no-wrap
2998msgid "*-C* [_fd_]"
2999msgstr ""
3000
3001#. type: Plain text
3002#: ../disk-utils/fsck.8.adoc:93
3003msgid ""
3004"Display completion/progress bars for those filesystem checkers (currently "
3005"only for ext[234]) which support them. *fsck* will manage the filesystem "
3006"checkers so that only one of them will display a progress bar at a time. GUI "
3007"front-ends may specify a file descriptor _fd_, in which case the progress "
3008"bar information will be sent to that file descriptor."
3009msgstr ""
3010
3011#. type: Labeled list
3012#: ../disk-utils/fsck.8.adoc:94 ../schedutils/uclampset.1.adoc:67
3013#, no-wrap
3014msgid "*-M*"
3015msgstr ""
3016
3017#. type: Plain text
3018#: ../disk-utils/fsck.8.adoc:96
3019msgid ""
3020"Do not check mounted filesystems and return an exit status of 0 for mounted "
3021"filesystems."
3022msgstr ""
3023
3024#. type: Labeled list
3025#: ../disk-utils/fsck.8.adoc:97
3026#, no-wrap
3027msgid "*-N*"
3028msgstr ""
3029
3030#. type: Plain text
3031#: ../disk-utils/fsck.8.adoc:99
3032msgid "Don't execute, just show what would be done."
3033msgstr ""
3034
3035#. type: Labeled list
3036#: ../disk-utils/fsck.8.adoc:100
3037#, no-wrap
3038msgid "*-P*"
3039msgstr ""
3040
3041#. type: Plain text
3042#: ../disk-utils/fsck.8.adoc:102
3043msgid ""
3044"When the *-A* flag is set, check the root filesystem in parallel with the "
3045"other filesystems. This is not the safest thing in the world to do, since if "
3046"the root filesystem is in doubt things like the *e2fsck*(8) executable might "
3047"be corrupted! This option is mainly provided for those sysadmins who don't "
3048"want to repartition the root filesystem to be small and compact (which is "
3049"really the right solution)."
3050msgstr ""
3051
3052#. type: Labeled list
3053#: ../disk-utils/fsck.8.adoc:103
3054#, no-wrap
3055msgid "*-R*"
3056msgstr ""
3057
3058#. type: Plain text
3059#: ../disk-utils/fsck.8.adoc:105
3060msgid ""
3061"When checking all filesystems with the *-A* flag, skip the root "
3062"filesystem. (This is useful in case the root filesystem has already been "
3063"mounted read-write.)"
3064msgstr ""
3065
3066#. type: Labeled list
3067#: ../disk-utils/fsck.8.adoc:106
3068#, no-wrap
3069msgid "*-T*"
3070msgstr ""
3071
3072#. type: Plain text
3073#: ../disk-utils/fsck.8.adoc:108
3074msgid "Don't show the title on startup."
3075msgstr ""
3076
3077#. type: Labeled list
3078#: ../disk-utils/fsck.8.adoc:109
3079#, no-wrap
3080msgid "*-V*"
3081msgstr ""
3082
3083#. type: Plain text
3084#: ../disk-utils/fsck.8.adoc:111
3085msgid ""
3086"Produce verbose output, including all filesystem-specific commands that are "
3087"executed."
3088msgstr ""
3089
3090#. type: Labeled list
3091#: ../disk-utils/fsck.8.adoc:112
3092#, no-wrap
3093msgid "*-?*, *--help*"
3094msgstr ""
3095
3096#. type: Labeled list
3097#: ../disk-utils/fsck.8.adoc:115 ../sys-utils/rfkill.8.adoc:45
3098#: ../term-utils/agetty.8.adoc:183 ../term-utils/setterm.1.adoc:157
3099#, no-wrap
3100msgid "*--version*"
3101msgstr ""
3102
3103#. type: Title ==
3104#: ../disk-utils/fsck.8.adoc:118
3105#, no-wrap
3106msgid "FILESYSTEM SPECIFIC OPTIONS"
3107msgstr ""
3108
3109#. type: Plain text
3110#: ../disk-utils/fsck.8.adoc:121
3111#, no-wrap
3112msgid ""
3113"*Options which are not understood by fsck are passed to the "
3114"filesystem-specific checker!*\n"
3115msgstr ""
3116
3117#. type: Plain text
3118#: ../disk-utils/fsck.8.adoc:123
3119msgid ""
3120"These options *must* not take arguments, as there is no way for *fsck* to be "
3121"able to properly guess which options take arguments and which don't."
3122msgstr ""
3123
3124#. type: Plain text
3125#: ../disk-utils/fsck.8.adoc:125
3126msgid ""
3127"Options and arguments which follow the *--* are treated as "
3128"filesystem-specific options to be passed to the filesystem-specific checker."
3129msgstr ""
3130
3131#. type: Plain text
3132#: ../disk-utils/fsck.8.adoc:127
3133msgid ""
3134"Please note that *fsck* is not designed to pass arbitrarily complicated "
3135"options to filesystem-specific checkers. If you're doing something "
3136"complicated, please just execute the filesystem-specific checker "
3137"directly. If you pass *fsck* some horribly complicated options and "
3138"arguments, and it doesn't do what you expect, *don't bother reporting it as "
3139"a bug.* You're almost certainly doing something that you shouldn't be doing "
3140"with *fsck*. Options to different filesystem-specific fsck's are not "
3141"standardized."
3142msgstr ""
3143
3144#. type: Plain text
3145#: ../disk-utils/fsck.8.adoc:131
3146msgid ""
3147"The *fsck* program's behavior is affected by the following environment "
3148"variables:"
3149msgstr ""
3150
3151#. type: Labeled list
3152#: ../disk-utils/fsck.8.adoc:132
3153#, no-wrap
3154msgid "*FSCK_FORCE_ALL_PARALLEL*"
3155msgstr ""
3156
3157#. type: Plain text
3158#: ../disk-utils/fsck.8.adoc:134
3159msgid ""
3160"If this environment variable is set, *fsck* will attempt to check all of the "
3161"specified filesystems in parallel, regardless of whether the filesystems "
3162"appear to be on the same device. (This is useful for RAID systems or "
3163"high-end storage systems such as those sold by companies such as IBM or "
3164"EMC.) Note that the _fs_passno_ value is still used."
3165msgstr ""
3166
3167#. type: Labeled list
3168#: ../disk-utils/fsck.8.adoc:135
3169#, no-wrap
3170msgid "*FSCK_MAX_INST*"
3171msgstr ""
3172
3173#. type: Plain text
3174#: ../disk-utils/fsck.8.adoc:137
3175msgid ""
3176"This environment variable will limit the maximum number of filesystem "
3177"checkers that can be running at one time. This allows configurations which "
3178"have a large number of disks to avoid *fsck* starting too many filesystem "
3179"checkers at once, which might overload CPU and memory resources available on "
3180"the system. If this value is zero, then an unlimited number of processes can "
3181"be spawned. This is currently the default, but future versions of *fsck* may "
3182"attempt to automatically determine how many filesystem checks can be run "
3183"based on gathering accounting data from the operating system."
3184msgstr ""
3185
3186#. type: Labeled list
3187#: ../disk-utils/fsck.8.adoc:138
3188#, no-wrap
3189msgid "*PATH*"
3190msgstr ""
3191
3192#. type: Plain text
3193#: ../disk-utils/fsck.8.adoc:140
3194msgid "The *PATH* environment variable is used to find filesystem checkers."
3195msgstr ""
3196
3197#. type: Labeled list
3198#: ../disk-utils/fsck.8.adoc:141
3199#, no-wrap
3200msgid "*FSTAB_FILE*"
3201msgstr ""
3202
3203#. type: Plain text
3204#: ../disk-utils/fsck.8.adoc:143
3205msgid ""
3206"This environment variable allows the system administrator to override the "
3207"standard location of the _/etc/fstab_ file. It is also useful for developers "
3208"who are testing *fsck*."
3209msgstr ""
3210
3211#. type: Labeled list
3212#: ../disk-utils/fsck.8.adoc:144
3213#, no-wrap
3214msgid "*LIBBLKID_DEBUG=all*"
3215msgstr ""
3216
3217#. type: Labeled list
3218#: ../disk-utils/fsck.8.adoc:147
3219#, no-wrap
3220msgid "*LIBMOUNT_DEBUG=all*"
3221msgstr ""
3222
3223#. type: Plain text
3224#: ../disk-utils/fsck.8.adoc:149 ../sys-utils/mountpoint.1.adoc:60
3225msgid "enables libmount debug output."
3226msgstr ""
3227
3228#. type: Title ==
3229#: ../disk-utils/fsck.8.adoc:150 ../lib/terminal-colors.d.5.adoc:134
3230#: ../login-utils/last.1.adoc:107 ../login-utils/login.1.adoc:139
3231#: ../login-utils/newgrp.1.adoc:25 ../login-utils/runuser.1.adoc:113
3232#: ../login-utils/su.1.adoc:119 ../misc-utils/look.1.adoc:86
3233#: ../misc-utils/mcookie.1.adoc:48 ../sys-utils/adjtime_config.5.adoc:50
3234#: ../sys-utils/ctrlaltdel.8.adoc:43 ../sys-utils/fstab.5.adoc:120
9b7051d5 3235#: ../sys-utils/hwclock.8.adoc:359 ../sys-utils/losetup.8.adoc:139
36e96905
MB
3236#: ../sys-utils/mount.8.adoc:1412 ../sys-utils/readprofile.8.adoc:60
3237#: ../sys-utils/renice.1.adoc:75 ../sys-utils/rtcwake.8.adoc:118
3238#: ../sys-utils/swapon.8.adoc:132 ../sys-utils/tunelp.8.adoc:59
3239#: ../sys-utils/umount.8.adoc:165 ../sys-utils/zramctl.8.adoc:80
3240#: ../term-utils/agetty.8.adoc:300 ../term-utils/mesg.1.adoc:91
3241#, no-wrap
3242msgid "FILES"
3243msgstr ""
3244
3245#. type: Labeled list
3246#: ../disk-utils/fsck.8.adoc:153 ../sys-utils/fstab.5.adoc:50
3247#: ../sys-utils/mount.8.adoc:1416 ../sys-utils/swapon.8.adoc:137
3248#: ../sys-utils/umount.8.adoc:170
3249#, no-wrap
3250msgid "_/etc/fstab_"
3251msgstr ""
3252
3253#. type: Plain text
3254#: ../disk-utils/fsck.8.adoc:158
3255msgid "mailto:tytso@mit.edu>[Theodore Ts'o], mailto:kzak@redhat.com[Karel Zak]"
3256msgstr ""
3257
3258#. type: Plain text
3259#: ../disk-utils/fsck.8.adoc:172
3260#, no-wrap
3261msgid ""
3262"*fstab*(5),\n"
3263"*mkfs*(8),\n"
3264"*fsck.ext2*(8) or *fsck.ext3*(8) or *e2fsck*(8),\n"
3265"*fsck.cramfs*(8),\n"
3266"*fsck.jfs*(8),\n"
3267"*fsck.nfs*(8),\n"
3268"*fsck.minix*(8),\n"
3269"*fsck.msdos*(8),\n"
3270"*fsck.vfat*(8),\n"
3271"*fsck.xfs*(8),\n"
3272"*reiserfsck*(8)\n"
3273msgstr ""
3274
3275#. type: Title =
3276#: ../disk-utils/fsck.cramfs.8.adoc:2
3277#, no-wrap
3278msgid "fsck.cramfs(8)"
3279msgstr ""
3280
3281#. type: Plain text
3282#: ../disk-utils/fsck.cramfs.8.adoc:12
3283msgid "fsck.cramfs - fsck compressed ROM file system"
3284msgstr ""
3285
3286#. type: Plain text
3287#: ../disk-utils/fsck.cramfs.8.adoc:16
3288#, no-wrap
3289msgid "*fsck.cramfs* [options] _file_\n"
3290msgstr ""
3291
3292#. type: Plain text
3293#: ../disk-utils/fsck.cramfs.8.adoc:20
3294#, no-wrap
3295msgid "*fsck.cramfs* is used to check the cramfs file system.\n"
3296msgstr ""
3297
3298#. type: Labeled list
3299#: ../disk-utils/fsck.cramfs.8.adoc:23 ../disk-utils/fsck.minix.8.adoc:56
3300#: ../disk-utils/mkfs.bfs.8.adoc:38 ../disk-utils/partx.8.adoc:96
3301#: ../misc-utils/hardlink.1.adoc:32 ../misc-utils/mcookie.1.adoc:39
3302#: ../misc-utils/rename.1.adoc:28 ../schedutils/chrt.1.adoc:101
3303#: ../schedutils/uclampset.1.adoc:82 ../sys-utils/blkdiscard.8.adoc:49
3304#: ../sys-utils/blkzone.8.adoc:98 ../sys-utils/chmem.8.adoc:52
3305#: ../sys-utils/eject.1.adoc:88 ../sys-utils/fallocate.1.adoc:64
9b7051d5 3306#: ../sys-utils/hwclock.8.adoc:167 ../sys-utils/losetup.8.adoc:95
36e96905
MB
3307#: ../sys-utils/mount.8.adoc:429 ../sys-utils/readprofile.8.adoc:51
3308#: ../sys-utils/rtcwake.8.adoc:105 ../sys-utils/setarch.8.adoc:37
3309#: ../sys-utils/swapon.8.adoc:89 ../sys-utils/umount.8.adoc:111
3310#: ../term-utils/mesg.1.adoc:71
3311#, no-wrap
3312msgid "*-v*, *--verbose*"
3313msgstr ""
3314
3315#. type: Plain text
3316#: ../disk-utils/fsck.cramfs.8.adoc:25 ../disk-utils/mkfs.cramfs.8.adoc:37
3317msgid "Enable verbose messaging."
3318msgstr ""
3319
3320#. type: Labeled list
3321#: ../disk-utils/fsck.cramfs.8.adoc:26
3322#, no-wrap
3323msgid "*-b*, *--blocksize* _blocksize_"
3324msgstr ""
3325
3326#. type: Plain text
3327#: ../disk-utils/fsck.cramfs.8.adoc:28
3328msgid ""
3329"Use this blocksize, defaults to page size. Must be equal to what was set at "
3330"creation time. Only used for *--extract*."
3331msgstr ""
3332
3333#. type: Labeled list
3334#: ../disk-utils/fsck.cramfs.8.adoc:29
3335#, no-wrap
3336msgid "*--extract*[=_directory_]"
3337msgstr ""
3338
3339#. type: Plain text
3340#: ../disk-utils/fsck.cramfs.8.adoc:31
3341msgid ""
3342"Test to uncompress the whole file system. Optionally extract contents of the "
3343"_file_ to _directory_."
3344msgstr ""
3345
3346#. type: Labeled list
3347#: ../disk-utils/fsck.cramfs.8.adoc:32
3348#, no-wrap
3349msgid "*-a*"
3350msgstr ""
3351
3352#. type: Plain text
3353#: ../disk-utils/fsck.cramfs.8.adoc:34 ../disk-utils/fsck.cramfs.8.adoc:37
3354#: ../disk-utils/mkfs.bfs.8.adoc:43 ../disk-utils/mkfs.bfs.8.adoc:46
3355msgid "This option is silently ignored."
3356msgstr ""
3357
3358#. type: Labeled list
3359#: ../disk-utils/fsck.cramfs.8.adoc:35
3360#, no-wrap
3361msgid "*-y*"
3362msgstr ""
3363
3364#. type: Title ==
3365#: ../disk-utils/fsck.cramfs.8.adoc:44 ../disk-utils/fsck.minix.8.adoc:80
3366#: ../disk-utils/isosize.8.adoc:31 ../disk-utils/mkfs.bfs.8.adoc:53
3367#: ../disk-utils/mkfs.cramfs.8.adoc:71 ../disk-utils/mkfs.minix.8.adoc:78
3368#: ../login-utils/chfn.1.adoc:69 ../login-utils/chsh.1.adoc:51
3369#: ../login-utils/lslogins.1.adoc:108 ../login-utils/runuser.1.adoc:99
3370#: ../login-utils/su.1.adoc:106 ../misc-utils/blkid.8.adoc:147
3371#: ../misc-utils/findfs.8.adoc:47 ../misc-utils/kill.1.adoc:83
3372#: ../misc-utils/logger.1.adoc:187 ../misc-utils/lsblk.8.adoc:124
3373#: ../misc-utils/rename.1.adoc:58 ../sys-utils/chcpu.8.adoc:59
3374#: ../sys-utils/chmem.8.adoc:58 ../sys-utils/dmesg.1.adoc:177
b81d5971 3375#: ../sys-utils/eject.1.adoc:97 ../sys-utils/flock.1.adoc:92
9b7051d5 3376#: ../sys-utils/fstrim.8.adoc:68 ../sys-utils/hwclock.8.adoc:341
36e96905
MB
3377#: ../sys-utils/losetup.8.adoc:126 ../sys-utils/lsipc.1.adoc:87
3378#: ../sys-utils/mount.8.adoc:1355 ../sys-utils/mountpoint.1.adoc:43
3379#: ../sys-utils/swapon.8.adoc:95 ../sys-utils/switch_root.8.adoc:33
3380#: ../sys-utils/zramctl.8.adoc:76 ../term-utils/mesg.1.adoc:80
3381#: ../text-utils/hexdump.1.adoc:221
3382#, no-wrap
3383msgid "EXIT STATUS"
3384msgstr ""
3385
3386#. type: Plain text
3387#: ../disk-utils/fsck.cramfs.8.adoc:48 ../disk-utils/isosize.8.adoc:35
3388#: ../disk-utils/mkfs.cramfs.8.adoc:75 ../misc-utils/findfs.8.adoc:51
3389#: ../misc-utils/kill.1.adoc:89 ../misc-utils/lsblk.8.adoc:128
3390#: ../sys-utils/chcpu.8.adoc:65 ../sys-utils/chmem.8.adoc:64
3391#: ../sys-utils/fstrim.8.adoc:72 ../sys-utils/mount.8.adoc:1361
3392#: ../sys-utils/swapon.8.adoc:101
3393msgid "success"
3394msgstr ""
3395
3396#. type: Plain text
3397#: ../disk-utils/fsck.cramfs.8.adoc:50
3398msgid "file system was left uncorrected"
3399msgstr ""
3400
3401#. type: Plain text
3402#: ../disk-utils/fsck.cramfs.8.adoc:52 ../disk-utils/mkfs.cramfs.8.adoc:77
3403msgid "operation error, such as unable to allocate memory"
3404msgstr ""
3405
3406#. type: Plain text
3407#: ../disk-utils/fsck.cramfs.8.adoc:54
3408msgid "usage information was printed"
3409msgstr ""
3410
3411#. type: Plain text
3412#: ../disk-utils/fsck.cramfs.8.adoc:59
3413#, no-wrap
3414msgid ""
3415"*mount*(8),\n"
3416"*mkfs.cramfs*(8)\n"
3417msgstr ""
3418
3419#. Copyright 1992, 1993, 1994 Rickard E. Faith (faith@cs.unc.edu)
3420#. May be freely distributed.
3421#. type: Title =
3422#: ../disk-utils/fsck.minix.8.adoc:6
3423#, no-wrap
3424msgid "fsck.minix(8)"
3425msgstr ""
3426
3427#. type: Plain text
3428#: ../disk-utils/fsck.minix.8.adoc:16
3429msgid "fsck.minix - check consistency of Minix filesystem"
3430msgstr ""
3431
3432#. type: Plain text
3433#: ../disk-utils/fsck.minix.8.adoc:20
3434#, no-wrap
3435msgid "*fsck.minix* [options] _device_\n"
3436msgstr ""
3437
3438#. type: Plain text
3439#: ../disk-utils/fsck.minix.8.adoc:24
3440#, no-wrap
3441msgid "*fsck.minix* performs a consistency check for the Linux MINIX filesystem.\n"
3442msgstr ""
3443
3444#. type: Plain text
3445#: ../disk-utils/fsck.minix.8.adoc:26
3446msgid ""
3447"The program assumes the filesystem is quiescent. *fsck.minix* should not be "
3448"used on a mounted device unless you can be sure nobody is writing to "
3449"it. Remember that the kernel can write to device when it searches for files."
3450msgstr ""
3451
3452#. type: Plain text
3453#: ../disk-utils/fsck.minix.8.adoc:28
3454msgid "The _device_ name will usually have the following form:"
3455msgstr ""
3456
3457#. type: Table
3458#: ../disk-utils/fsck.minix.8.adoc:36
3459#, no-wrap
3460msgid ""
3461"|/dev/hda[1-63] |IDE disk 1\n"
3462"|/dev/hdb[1-63] |IDE disk 2\n"
3463"|/dev/sda[1-15] |SCSI disk 1\n"
3464"|/dev/sdb[1-15] |SCSI disk 2\n"
3465msgstr ""
3466
3467#. type: delimited block _
3468#: ../disk-utils/fsck.minix.8.adoc:40
3469msgid ""
3470"If the filesystem was changed, i.e., repaired, then *fsck.minix* will print "
3471"\"FILE SYSTEM HAS CHANGED\" and will *sync*(2) three times before "
3472"exiting. There is _no_ need to reboot after check."
3473msgstr ""
3474
3475#. type: Title ==
3476#: ../disk-utils/fsck.minix.8.adoc:41 ../disk-utils/mkswap.8.adoc:31
3477#: ../misc-utils/rename.1.adoc:46
3478#, no-wrap
3479msgid "WARNING"
3480msgstr ""
3481
3482#. type: delimited block _
3483#: ../disk-utils/fsck.minix.8.adoc:44
3484#, no-wrap
3485msgid ""
3486"*fsck.minix* should *not* be used on a mounted filesystem. Using "
3487"*fsck.minix* on a mounted filesystem is very dangerous, due to the "
3488"possibility that deleted files are still in use, and can seriously damage a "
3489"perfectly good filesystem! If you absolutely have to run *fsck.minix* on a "
3490"mounted filesystem, such as the root filesystem, make sure nothing is "
3491"writing to the disk, and that no files are \"zombies\" waiting for "
3492"deletion.\n"
3493msgstr ""
3494
3495#. type: delimited block _
3496#: ../disk-utils/fsck.minix.8.adoc:49
3497msgid "List all filenames."
3498msgstr ""
3499
3500#. type: Labeled list
3501#: ../disk-utils/fsck.minix.8.adoc:50
3502#, no-wrap
3503msgid "*-r*, *--repair*"
3504msgstr ""
3505
3506#. type: delimited block _
3507#: ../disk-utils/fsck.minix.8.adoc:52
3508msgid "Perform interactive repairs."
3509msgstr ""
3510
3511#. type: Labeled list
3512#: ../disk-utils/fsck.minix.8.adoc:53 ../sys-utils/rtcwake.8.adoc:36
3513#, no-wrap
3514msgid "*-a*, *--auto*"
3515msgstr ""
3516
3517#. type: delimited block _
3518#: ../disk-utils/fsck.minix.8.adoc:55
3519msgid ""
3520"Perform automatic repairs. This option implies *--repair* and serves to "
3521"answer all of the questions asked with the default. Note that this can be "
3522"extremely dangerous in the case of extensive filesystem damage."
3523msgstr ""
3524
3525#. type: Labeled list
3526#: ../disk-utils/fsck.minix.8.adoc:59
3527#, no-wrap
3528msgid "*-s*, *--super*"
3529msgstr ""
3530
3531#. type: delimited block _
3532#: ../disk-utils/fsck.minix.8.adoc:61
3533msgid "Output super-block information."
3534msgstr ""
3535
3536#. type: Labeled list
3537#: ../disk-utils/fsck.minix.8.adoc:62
3538#, no-wrap
3539msgid "*-m*, *--uncleared*"
3540msgstr ""
3541
3542#. type: delimited block _
3543#: ../disk-utils/fsck.minix.8.adoc:64
3544msgid "Activate MINIX-like \"mode not cleared\" warnings."
3545msgstr ""
3546
3547#. type: Labeled list
3548#: ../disk-utils/fsck.minix.8.adoc:65 ../disk-utils/mkswap.8.adoc:44
3549#: ../disk-utils/sfdisk.8.adoc:149 ../misc-utils/wipefs.8.adoc:46
3550#: ../sys-utils/blkdiscard.8.adoc:31 ../sys-utils/blkzone.8.adoc:95
3551#: ../sys-utils/umount.8.adoc:73
3552#, no-wrap
3553msgid "*-f*, *--force*"
3554msgstr ""
3555
3556#. type: delimited block _
3557#: ../disk-utils/fsck.minix.8.adoc:67
3558msgid ""
3559"Force a filesystem check even if the filesystem was marked as valid. Marking "
3560"is done by the kernel when the filesystem is unmounted."
3561msgstr ""
3562
3563#. type: Title ==
3564#: ../disk-utils/fsck.minix.8.adoc:74 ../term-utils/agetty.8.adoc:325
3565#, no-wrap
3566msgid "DIAGNOSTICS"
3567msgstr ""
3568
3569#. type: delimited block _
3570#: ../disk-utils/fsck.minix.8.adoc:77
3571msgid ""
3572"There are numerous diagnostic messages. The ones mentioned here are the most "
3573"commonly seen in normal usage."
3574msgstr ""
3575
3576#. type: delimited block _
3577#: ../disk-utils/fsck.minix.8.adoc:79
3578msgid ""
3579"If the device does not exist, *fsck.minix* will print \"unable to read super "
3580"block\". If the device exists, but is not a MINIX filesystem, *fsck.minix* "
3581"will print \"bad magic number in super-block\"."
3582msgstr ""
3583
3584#. type: delimited block _
3585#: ../disk-utils/fsck.minix.8.adoc:83
3586msgid "The exit status returned by *fsck.minix* is the sum of the following:"
3587msgstr ""
3588
3589#. type: Labeled list
3590#: ../disk-utils/fsck.minix.8.adoc:86
3591#, no-wrap
3592msgid "*3*"
3593msgstr ""
3594
3595#. type: delimited block _
3596#: ../disk-utils/fsck.minix.8.adoc:88
3597msgid ""
3598"Filesystem errors corrected, system should be rebooted if filesystem was "
3599"mounted"
3600msgstr ""
3601
3602#. type: Labeled list
3603#: ../disk-utils/fsck.minix.8.adoc:90
3604#, no-wrap
3605msgid "*7*"
3606msgstr ""
3607
3608#. type: delimited block _
3609#: ../disk-utils/fsck.minix.8.adoc:92
3610msgid "Combination of exit statuses 3 and 4"
3611msgstr ""
3612
3613#. type: delimited block _
3614#: ../disk-utils/fsck.minix.8.adoc:101
3615msgid ""
3616"mailto:torvalds@cs.helsinki.fi[Linus Torvalds]. Exit status values by "
3617"mailto:faith@cs.unc.edu[Rik Faith] Added support for filesystem valid flag: "
3618"mailto:greg%wind.uucp@plains.nodak.edu[Dr. Wettstein]. Check to prevent fsck "
3619"of mounted filesystem added by mailto:quinlan@yggdrasil.com[Daniel "
3620"Quinlan]. Minix v2 fs support by "
3621"mailto:schwab@issan.informatik.uni-dortmund.de[Andreas Schwab], updated by "
3622"mailto:janl@math.uio.no[Nicolai Langfeldt]. Portability patch by "
3623"mailto:rmk@ecs.soton.ac.uk[Russell King]."
3624msgstr ""
3625
3626#. type: delimited block _
3627#: ../disk-utils/fsck.minix.8.adoc:110
3628#, no-wrap
3629msgid ""
3630"*fsck*(8),\n"
3631"*fsck.ext2*(8),\n"
3632"*mkfs*(8),\n"
3633"*mkfs.ext2*(8),\n"
3634"*mkfs.minix*(8),\n"
3635"*reboot*(8)\n"
3636msgstr ""
3637
3638#. type: Title =
3639#: ../disk-utils/isosize.8.adoc:2
3640#, no-wrap
3641msgid "isosize(8)"
3642msgstr ""
3643
3644#. type: Plain text
3645#: ../disk-utils/isosize.8.adoc:12
3646msgid "isosize - output the length of an iso9660 filesystem"
3647msgstr ""
3648
3649#. type: Plain text
3650#: ../disk-utils/isosize.8.adoc:16
3651#, no-wrap
3652msgid "*isosize* [options] _iso9660_image_file_\n"
3653msgstr ""
3654
3655#. type: Plain text
3656#: ../disk-utils/isosize.8.adoc:20
3657msgid ""
3658"This command outputs the length of an iso9660 filesystem that is contained "
3659"in the specified file. This file may be a normal file or a block device "
3660"(e.g. _/dev/hdd_ or _/dev/sr0_). In the absence of any options (and errors), "
3661"it will output the size of the iso9660 filesystem in bytes. This can now be "
3cb97156 3662"a large number (>> 4 GB)."
36e96905
MB
3663msgstr ""
3664
3665#. type: Labeled list
3666#: ../disk-utils/isosize.8.adoc:23
3667#, no-wrap
3668msgid "*-x*, *--sectors*"
3669msgstr ""
3670
3671#. type: Plain text
3672#: ../disk-utils/isosize.8.adoc:25
3673msgid ""
3674"Show the block count and block size in human-readable form. The output uses "
3675"the term \"sectors\" for \"blocks\"."
3676msgstr ""
3677
3678#. type: Labeled list
5db1d29a 3679#: ../disk-utils/isosize.8.adoc:26 ../term-utils/scriptlive.1.adoc:42
36e96905
MB
3680#: ../term-utils/scriptreplay.1.adoc:53
3681#, no-wrap
3682msgid "*-d*, *--divisor* _number_"
3683msgstr ""
3684
3685#. type: Plain text
3686#: ../disk-utils/isosize.8.adoc:28
3687msgid ""
3688"Only has an effect when *-x* is not given. The value shown (if no errors) is "
3689"the iso9660 file size in bytes divided by _number_. So if _number_ is the "
3690"block size then the shown value will be the block count."
3691msgstr ""
3692
3693#. type: Plain text
3694#: ../disk-utils/isosize.8.adoc:30
3695msgid ""
3696"The size of the file (or block device) holding an iso9660 filesystem can be "
3697"marginally larger than the actual size of the iso9660 filesystem. One reason "
3698"for this is that cd writers are allowed to add \"run out\" sectors at the "
3699"end of an iso9660 image."
3700msgstr ""
3701
3702#. type: Plain text
3703#: ../disk-utils/isosize.8.adoc:37
3704msgid "generic failure, such as invalid usage"
3705msgstr ""
3706
3707#. type: Plain text
3708#: ../disk-utils/isosize.8.adoc:39 ../sys-utils/fstrim.8.adoc:76
3709msgid "all failed"
3710msgstr ""
3711
3712#. type: Labeled list
3713#: ../disk-utils/isosize.8.adoc:39 ../misc-utils/kill.1.adoc:91
3714#: ../misc-utils/rename.1.adoc:72 ../sys-utils/chcpu.8.adoc:69
3715#: ../sys-utils/chmem.8.adoc:68 ../sys-utils/mount.8.adoc:1380
3716#: ../sys-utils/swapon.8.adoc:117
3717#, no-wrap
3718msgid "*64*"
3719msgstr ""
3720
3721#. type: Plain text
3722#: ../disk-utils/isosize.8.adoc:41
3723msgid "some failed"
3724msgstr ""
3725
3726#. type: Title =
3727#: ../disk-utils/mkfs.8.adoc:2
3728#, no-wrap
3729msgid "mkfs(8)"
3730msgstr ""
3731
3732#. type: Plain text
3733#: ../disk-utils/mkfs.8.adoc:12
3734msgid "mkfs - build a Linux filesystem"
3735msgstr ""
3736
3737#. type: Plain text
3738#: ../disk-utils/mkfs.8.adoc:16
3739#, no-wrap
3740msgid "*mkfs* [options] [*-t* _type_] [_fs-options_] _device_ [_size_]\n"
3741msgstr ""
3742
3743#. type: Plain text
3744#: ../disk-utils/mkfs.8.adoc:20
3745#, no-wrap
3746msgid ""
3747"*This mkfs frontend is deprecated in favour of filesystem specific "
3748"mkfs.<type> utils.*\n"
3749msgstr ""
3750
3751#. type: Plain text
3752#: ../disk-utils/mkfs.8.adoc:22
3753#, no-wrap
3754msgid ""
3755"*mkfs* is used to build a Linux filesystem on a device, usually a hard disk "
3756"partition. The _device_ argument is either the device name (e.g., "
3757"_/dev/hda1_, _/dev/sdb2_), or a regular file that shall contain the "
3758"filesystem. The _size_ argument is the number of blocks to be used for the "
3759"filesystem.\n"
3760msgstr ""
3761
3762#. type: Plain text
3763#: ../disk-utils/mkfs.8.adoc:24
3764msgid "The exit status returned by *mkfs* is 0 on success and 1 on failure."
3765msgstr ""
3766
3767#. type: Plain text
3768#: ../disk-utils/mkfs.8.adoc:26
3769msgid ""
3770"In actuality, *mkfs* is simply a front-end for the various filesystem "
3771"builders (**mkfs.**__fstype__) available under Linux. The "
3772"filesystem-specific builder is searched for via your *PATH* environment "
3773"setting only. Please see the filesystem-specific builder manual pages for "
3774"further details."
3775msgstr ""
3776
3777#. type: Plain text
3778#: ../disk-utils/mkfs.8.adoc:31
3779msgid ""
3780"Specify the _type_ of filesystem to be built. If not specified, the default "
3781"filesystem type (currently ext2) is used."
3782msgstr ""
3783
3784#. type: Labeled list
3785#: ../disk-utils/mkfs.8.adoc:32
3786#, no-wrap
3787msgid "_fs-options_"
3788msgstr ""
3789
3790#. type: Plain text
3791#: ../disk-utils/mkfs.8.adoc:34
3792msgid "Filesystem-specific options to be passed to the real filesystem builder."
3793msgstr ""
3794
3795#. type: Labeled list
3796#: ../disk-utils/mkfs.8.adoc:35
3797#, no-wrap
3798msgid "*-V*, *--verbose*"
3799msgstr ""
3800
3801#. type: Plain text
3802#: ../disk-utils/mkfs.8.adoc:37
3803msgid ""
3804"Produce verbose output, including all filesystem-specific commands that are "
3805"executed. Specifying this option more than once inhibits execution of any "
3806"filesystem-specific commands. This is really only useful for testing."
3807msgstr ""
3808
3809#. type: Plain text
3810#: ../disk-utils/mkfs.8.adoc:40
3811msgid ""
3812"Display version information and exit. (Option *-V* will display version "
3813"information only when it is the only parameter, otherwise it will work as "
3814"*--verbose*.)"
3815msgstr ""
3816
3817#. type: Title ==
3818#: ../disk-utils/mkfs.8.adoc:44 ../disk-utils/raw.8.adoc:55
3819#: ../login-utils/login.1.adoc:153 ../login-utils/utmpdump.1.adoc:71
3820#: ../misc-utils/cal.1.adoc:165 ../misc-utils/getopt.1.adoc:143
3821#: ../misc-utils/hardlink.1.adoc:78 ../misc-utils/mcookie.1.adoc:54
3822#: ../misc-utils/namei.1.adoc:65 ../sys-utils/lscpu.1.adoc:148
3823#: ../sys-utils/mount.8.adoc:1438 ../sys-utils/readprofile.8.adoc:71
3824#: ../term-utils/agetty.8.adoc:317 ../term-utils/script.1.adoc:160
3825#: ../term-utils/setterm.1.adoc:167 ../text-utils/colcrt.1.adoc:74
3826#: ../text-utils/column.1.adoc:149 ../text-utils/ul.1.adoc:80
3827#, no-wrap
3828msgid "BUGS"
3829msgstr ""
3830
3831#. type: Plain text
3832#: ../disk-utils/mkfs.8.adoc:47
3833msgid ""
3834"All generic options must precede and not be combined with "
3835"filesystem-specific options. Some filesystem-specific programs do not "
3836"automatically detect the device size and require the _size_ parameter to be "
3837"specified."
3838msgstr ""
3839
3840#. type: Plain text
3841#: ../disk-utils/mkfs.8.adoc:53
3842msgid ""
3843"mailto:david@ods.com[David Engel], mailto:waltje@uwalt.nl.mugnet.org[Fred "
3844"N. van Kempen], mailto:sommel@sci.kun.nl[Ron Sommeling]."
3845msgstr ""
3846
3847#. type: Plain text
3848#: ../disk-utils/mkfs.8.adoc:55
3849msgid ""
3850"The manual page was shamelessly adapted from Remy Card's version for the "
3851"ext2 filesystem."
3852msgstr ""
3853
3854#. type: Plain text
3855#: ../disk-utils/mkfs.8.adoc:71
3856#, no-wrap
3857msgid ""
3858"*fs*(5),\n"
3859"*badblocks*(8),\n"
3860"*fsck*(8),\n"
3861"*mkdosfs*(8),\n"
3862"*mke2fs*(8),\n"
3863"*mkfs.bfs*(8),\n"
3864"*mkfs.ext2*(8),\n"
3865"*mkfs.ext3*(8),\n"
3866"*mkfs.ext4*(8),\n"
3867"*mkfs.minix*(8),\n"
3868"*mkfs.msdos*(8),\n"
3869"*mkfs.vfat*(8),\n"
3870"*mkfs.xfs*(8)\n"
3871msgstr ""
3872
3873#. Copyright 1999 Andries E. Brouwer (aeb@cwi.nl)
3874#. May be freely distributed.
3875#. type: Title =
3876#: ../disk-utils/mkfs.bfs.8.adoc:6
3877#, no-wrap
3878msgid "mkfs.bfs(8)"
3879msgstr ""
3880
3881#. type: Plain text
3882#: ../disk-utils/mkfs.bfs.8.adoc:16
3883msgid "mkfs.bfs - make an SCO bfs filesystem"
3884msgstr ""
3885
3886#. type: Plain text
3887#: ../disk-utils/mkfs.bfs.8.adoc:20
3888#, no-wrap
3889msgid "*mkfs.bfs* [options] _device_ [_block-count_]\n"
3890msgstr ""
3891
3892#. type: Plain text
3893#: ../disk-utils/mkfs.bfs.8.adoc:24
3894#, no-wrap
3895msgid ""
3896"*mkfs.bfs* creates an SCO bfs filesystem on a block device (usually a disk "
3897"partition or a file accessed via the loop device).\n"
3898msgstr ""
3899
3900#. type: Plain text
3901#: ../disk-utils/mkfs.bfs.8.adoc:26
3902msgid ""
3903"The _block-count_ parameter is the desired size of the filesystem, in "
3904"blocks. If nothing is specified, the entire partition will be used."
3905msgstr ""
3906
3907#. type: Labeled list
3908#: ../disk-utils/mkfs.bfs.8.adoc:29
3909#, no-wrap
3910msgid "*-N*, *--inodes* _number_"
3911msgstr ""
3912
3913#. type: Plain text
3914#: ../disk-utils/mkfs.bfs.8.adoc:31
3915msgid ""
3916"Specify the desired _number_ of inodes (at most 512). If nothing is "
3917"specified, some default number in the range 48-512 is picked depending on "
3918"the size of the partition."
3919msgstr ""
3920
3921#. type: Labeled list
3922#: ../disk-utils/mkfs.bfs.8.adoc:32
3923#, no-wrap
3924msgid "*-V*, *--vname* _label_"
3925msgstr ""
3926
3927#. type: Plain text
3928#: ../disk-utils/mkfs.bfs.8.adoc:34
3929msgid "Specify the volume _label_. I have no idea if/where this is used."
3930msgstr ""
3931
3932#. type: Labeled list
3933#: ../disk-utils/mkfs.bfs.8.adoc:35
3934#, no-wrap
3935msgid "*-F*, *--fname* _name_"
3936msgstr ""
3937
3938#. type: Plain text
3939#: ../disk-utils/mkfs.bfs.8.adoc:37
3940msgid "Specify the filesystem _name_. I have no idea if/where this is used."
3941msgstr ""
3942
3943#. type: Plain text
3944#: ../disk-utils/mkfs.bfs.8.adoc:40 ../term-utils/mesg.1.adoc:73
3945msgid "Explain what is being done."
3946msgstr ""
3947
3948#. type: Labeled list
3949#: ../disk-utils/mkfs.bfs.8.adoc:41 ../text-utils/pg.1.adoc:39
3950#, no-wrap
3951msgid "*-c*"
3952msgstr ""
3953
3954#. type: Plain text
3955#: ../disk-utils/mkfs.bfs.8.adoc:52
3956msgid ""
3957"Display version information and exit. Option *-V* only works as *--version* "
3958"when it is the only option."
3959msgstr ""
3960
3961#. type: Plain text
3962#: ../disk-utils/mkfs.bfs.8.adoc:56
3963msgid ""
3964"The exit status returned by *mkfs.bfs* is 0 when all went well, and 1 when "
3965"something went wrong."
3966msgstr ""
3967
3968#. type: Plain text
3969#: ../disk-utils/mkfs.bfs.8.adoc:60
3970#, no-wrap
3971msgid "*mkfs*(8)\n"
3972msgstr ""
3973
3974#. type: Title =
3975#: ../disk-utils/mkfs.cramfs.8.adoc:2
3976#, no-wrap
3977msgid "mkfs.cramfs(8)"
3978msgstr ""
3979
3980#. type: Plain text
3981#: ../disk-utils/mkfs.cramfs.8.adoc:12
3982msgid "mkfs.cramfs - make compressed ROM file system"
3983msgstr ""
3984
3985#. type: Plain text
3986#: ../disk-utils/mkfs.cramfs.8.adoc:16
3987#, no-wrap
3988msgid "*mkfs.cramfs* [options] _directory file_\n"
3989msgstr ""
3990
3991#. type: Plain text
3992#: ../disk-utils/mkfs.cramfs.8.adoc:20
3993msgid ""
3994"Files on cramfs file systems are zlib-compressed one page at a time to allow "
3995"random read access. The metadata is not compressed, but is expressed in a "
3996"terse representation that is more space-efficient than conventional file "
3997"systems."
3998msgstr ""
3999
4000#. type: Plain text
4001#: ../disk-utils/mkfs.cramfs.8.adoc:22
4002msgid ""
4003"The file system is intentionally read-only to simplify its design; random "
4004"write access for compressed files is difficult to implement. cramfs ships "
4005"with a utility (*mkcramfs*(8)) to pack files into new cramfs images."
4006msgstr ""
4007
4008#. type: Plain text
4009#: ../disk-utils/mkfs.cramfs.8.adoc:24
9b7051d5 4010msgid "File sizes are limited to less than 16 MB."
36e96905
MB
4011msgstr ""
4012
4013#. type: Plain text
4014#: ../disk-utils/mkfs.cramfs.8.adoc:26
4015msgid ""
9b7051d5
MB
4016"Maximum file system size is a little under 272 MB. (The last file on the "
4017"file system must begin before the 256 MB block, but can extend past it.)"
36e96905
MB
4018msgstr ""
4019
4020#. type: Title ==
4021#: ../disk-utils/mkfs.cramfs.8.adoc:27 ../misc-utils/hardlink.1.adoc:74
4022#: ../misc-utils/kill.1.adoc:35 ../term-utils/agetty.8.adoc:35
4023#: ../term-utils/mesg.1.adoc:59
4024#, no-wrap
4025msgid "ARGUMENTS"
4026msgstr ""
4027
4028#. type: Plain text
4029#: ../disk-utils/mkfs.cramfs.8.adoc:30
4030msgid ""
4031"The _directory_ is simply the root of the directory tree that we want to "
4032"generate a compressed filesystem out of."
4033msgstr ""
4034
4035#. type: Plain text
4036#: ../disk-utils/mkfs.cramfs.8.adoc:32
4037msgid "The _file_ will contain the cram file system, which later can be mounted."
4038msgstr ""
4039
4040#. type: Labeled list
4041#: ../disk-utils/mkfs.cramfs.8.adoc:38
4042#, no-wrap
4043msgid "*-E*"
4044msgstr ""
4045
4046#. type: Plain text
4047#: ../disk-utils/mkfs.cramfs.8.adoc:40
4048msgid "Treat all warnings as errors, which are reflected as command exit status."
4049msgstr ""
4050
4051#. type: Labeled list
4052#: ../disk-utils/mkfs.cramfs.8.adoc:41
4053#, no-wrap
4054msgid "*-b* _blocksize_"
4055msgstr ""
4056
4057#. type: Plain text
4058#: ../disk-utils/mkfs.cramfs.8.adoc:43
4059msgid "Use defined block size, which has to be divisible by page size."
4060msgstr ""
4061
4062#. type: Labeled list
4063#: ../disk-utils/mkfs.cramfs.8.adoc:44
4064#, no-wrap
4065msgid "*-e* _edition_"
4066msgstr ""
4067
4068#. type: Plain text
4069#: ../disk-utils/mkfs.cramfs.8.adoc:46
4070msgid "Use defined file system edition number in superblock."
4071msgstr ""
4072
4073#. type: Labeled list
4074#: ../disk-utils/mkfs.cramfs.8.adoc:47
4075#, no-wrap
4076msgid "*-N* _big, little, host_"
4077msgstr ""
4078
4079#. type: Plain text
4080#: ../disk-utils/mkfs.cramfs.8.adoc:49
4081msgid "Use defined endianness. Value defaults to _host_."
4082msgstr ""
4083
4084#. type: Labeled list
4085#: ../disk-utils/mkfs.cramfs.8.adoc:50
4086#, no-wrap
4087msgid "*-i* _file_"
4088msgstr ""
4089
4090#. type: Plain text
4091#: ../disk-utils/mkfs.cramfs.8.adoc:52
4092msgid "Insert a _file_ to cramfs file system."
4093msgstr ""
4094
4095#. type: Labeled list
4096#: ../disk-utils/mkfs.cramfs.8.adoc:53
4097#, no-wrap
4098msgid "*-n* _name_"
4099msgstr ""
4100
4101#. type: Plain text
4102#: ../disk-utils/mkfs.cramfs.8.adoc:55
4103msgid "Set name of the cramfs file system."
4104msgstr ""
4105
4106#. type: Labeled list
4107#: ../disk-utils/mkfs.cramfs.8.adoc:56 ../login-utils/login.1.adoc:39
4108#, no-wrap
4109msgid "*-p*"
4110msgstr ""
4111
4112#. type: Plain text
4113#: ../disk-utils/mkfs.cramfs.8.adoc:58
4114msgid "Pad by 512 bytes for boot code."
4115msgstr ""
4116
4117#. type: Plain text
4118#: ../disk-utils/mkfs.cramfs.8.adoc:61
4119msgid ""
4120"This option is ignored. Originally the *-s* turned on directory entry "
4121"sorting."
4122msgstr ""
4123
4124#. type: Labeled list
4125#: ../disk-utils/mkfs.cramfs.8.adoc:62
4126#, no-wrap
4127msgid "*-z*"
4128msgstr ""
4129
4130#. type: Plain text
4131#: ../disk-utils/mkfs.cramfs.8.adoc:64
4132msgid "Make explicit holes."
4133msgstr ""
4134
4135#. type: Plain text
4136#: ../disk-utils/mkfs.cramfs.8.adoc:82
4137#, no-wrap
4138msgid ""
4139"*fsck.cramfs*(8),\n"
4140"*mount*(8)\n"
4141msgstr ""
4142
4143#. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
4144#. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4145#. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
4146#. Copyright (C) 2013 Karel Zak <kzak@redhat.com>
4147#. May be distributed under the GNU General Public License
4148#. type: Title =
4149#: ../disk-utils/mkfs.minix.8.adoc:9
4150#, no-wrap
4151msgid "mkfs.minix(8)"
4152msgstr ""
4153
4154#. type: Plain text
4155#: ../disk-utils/mkfs.minix.8.adoc:19
4156msgid "mkfs.minix - make a Minix filesystem"
4157msgstr ""
4158
4159#. type: Plain text
4160#: ../disk-utils/mkfs.minix.8.adoc:23
4161#, no-wrap
4162msgid "*mkfs.minix* [options] _device_ [_size-in-blocks_]\n"
4163msgstr ""
4164
4165#. type: Plain text
4166#: ../disk-utils/mkfs.minix.8.adoc:27
4167#, no-wrap
4168msgid ""
4169"*mkfs.minix* creates a Linux MINIX filesystem on a device (usually a disk "
4170"partition).\n"
4171msgstr ""
4172
4173#. type: Plain text
4174#: ../disk-utils/mkfs.minix.8.adoc:29
4175msgid "The _device_ is usually of the following form:"
4176msgstr ""
4177
4178#. type: delimited block .
4179#: ../disk-utils/mkfs.minix.8.adoc:35
4180#, no-wrap
4181msgid ""
4182"/dev/hda[1-8] (IDE disk 1)\n"
4183"/dev/hdb[1-8] (IDE disk 2)\n"
4184"/dev/sda[1-8] (SCSI disk 1)\n"
4185"/dev/sdb[1-8] (SCSI disk 2)\n"
4186msgstr ""
4187
4188#. type: Plain text
4189#: ../disk-utils/mkfs.minix.8.adoc:38
4190msgid ""
4191"The device may be a block device or an image file of one, but this is not "
4192"enforced. Expect not much fun on a character device :-)."
4193msgstr ""
4194
4195#. type: Plain text
4196#: ../disk-utils/mkfs.minix.8.adoc:40
4197msgid ""
4198"The _size-in-blocks_ parameter is the desired size of the file system, in "
4199"blocks. It is present only for backwards compatibility. If omitted the size "
4200"will be determined automatically. Only block counts strictly greater than 10 "
4201"and strictly less than 65536 are allowed."
4202msgstr ""
4203
4204#. type: Labeled list
4205#: ../disk-utils/mkfs.minix.8.adoc:43 ../disk-utils/mkswap.8.adoc:41
4206#, no-wrap
4207msgid "*-c*, *--check*"
4208msgstr ""
4209
4210#. type: Plain text
4211#: ../disk-utils/mkfs.minix.8.adoc:45
4212msgid ""
4213"Check the device for bad blocks before creating the filesystem. If any are "
4214"found, the count is printed."
4215msgstr ""
4216
4217#. type: Labeled list
4218#: ../disk-utils/mkfs.minix.8.adoc:46
4219#, no-wrap
4220msgid "*-n*, *--namelength* _length_"
4221msgstr ""
4222
4223#. type: Plain text
4224#: ../disk-utils/mkfs.minix.8.adoc:48
4225msgid ""
4226"Specify the maximum length of filenames. Currently, the only allowable "
4227"values are 14 and 30 for file system versions 1 and 2. Version 3 allows only "
4228"value 60. The default is 30."
4229msgstr ""
4230
4231#. type: Labeled list
4232#: ../disk-utils/mkfs.minix.8.adoc:52
4233#, no-wrap
4234msgid "*-i*, *--inodes* _number_"
4235msgstr ""
4236
4237#. type: Plain text
4238#: ../disk-utils/mkfs.minix.8.adoc:54
4239msgid "Specify the number of inodes for the filesystem."
4240msgstr ""
4241
4242#. type: Labeled list
4243#: ../disk-utils/mkfs.minix.8.adoc:55
4244#, no-wrap
4245msgid "*-l*, *--badblocks* _filename_"
4246msgstr ""
4247
4248#. type: Plain text
4249#: ../disk-utils/mkfs.minix.8.adoc:57
4250msgid ""
4251"Read the list of bad blocks from _filename_. The file has one bad-block "
4252"number per line. The count of bad blocks read is printed."
4253msgstr ""
4254
4255#. type: Labeled list
4256#: ../disk-utils/mkfs.minix.8.adoc:58 ../misc-utils/kill.1.adoc:45
4257#, no-wrap
4258msgid "*-1*"
4259msgstr ""
4260
4261#. type: Plain text
4262#: ../disk-utils/mkfs.minix.8.adoc:60
4263msgid "Make a Minix version 1 filesystem. This is the default."
4264msgstr ""
4265
4266#. type: Labeled list
4267#: ../disk-utils/mkfs.minix.8.adoc:61
4268#, no-wrap
4269msgid "*-2*, *-v*"
4270msgstr ""
4271
4272#. type: Plain text
4273#: ../disk-utils/mkfs.minix.8.adoc:63
4274msgid "Make a Minix version 2 filesystem."
4275msgstr ""
4276
4277#. type: Labeled list
4278#: ../disk-utils/mkfs.minix.8.adoc:64
4279#, no-wrap
4280msgid "*-3*"
4281msgstr ""
4282
4283#. type: Plain text
4284#: ../disk-utils/mkfs.minix.8.adoc:66
4285msgid "Make a Minix version 3 filesystem."
4286msgstr ""
4287
4288#. type: Plain text
4289#: ../disk-utils/mkfs.minix.8.adoc:69
4290msgid ""
4291"Display version information and exit. The long option cannot be combined "
4292"with other options."
4293msgstr ""
4294
4295#. type: Labeled list
4296#: ../disk-utils/mkfs.minix.8.adoc:75 ../disk-utils/mkswap.8.adoc:78
4297#: ../disk-utils/sfdisk.8.adoc:395 ../misc-utils/wipefs.8.adoc:89
4298#, no-wrap
4299msgid "LOCK_BLOCK_DEVICE=<mode>"
4300msgstr ""
4301
4302#. type: Plain text
4303#: ../disk-utils/mkfs.minix.8.adoc:81
4304msgid "The exit status returned by *mkfs.minix* is one of the following:"
4305msgstr ""
4306
4307#. type: Labeled list
4308#: ../disk-utils/mkfs.minix.8.adoc:82 ../login-utils/lslogins.1.adoc:110
4309#: ../misc-utils/lsblk.8.adoc:126 ../sys-utils/fstrim.8.adoc:70
4310#: ../sys-utils/lsipc.1.adoc:89
4311#, no-wrap
4312msgid "0"
4313msgstr ""
4314
4315#. type: Labeled list
4316#: ../disk-utils/mkfs.minix.8.adoc:84
4317#, no-wrap
4318msgid "8"
4319msgstr ""
4320
4321#. type: Labeled list
4322#: ../disk-utils/mkfs.minix.8.adoc:86
4323#, no-wrap
4324msgid "16"
4325msgstr ""
4326
4327#. type: Plain text
4328#: ../disk-utils/mkfs.minix.8.adoc:94
4329#, no-wrap
4330msgid ""
4331"*fsck*(8),\n"
4332"*mkfs*(8),\n"
4333"*reboot*(8)\n"
4334msgstr ""
4335
4336#. Copyright 1998 Andries E. Brouwer (aeb@cwi.nl)
4337#. May be distributed under the GNU General Public License
4338#. type: Title =
4339#: ../disk-utils/mkswap.8.adoc:6
4340#, no-wrap
4341msgid "mkswap(8)"
4342msgstr ""
4343
4344#. type: Plain text
4345#: ../disk-utils/mkswap.8.adoc:16
4346msgid "mkswap - set up a Linux swap area"
4347msgstr ""
4348
4349#. type: Plain text
4350#: ../disk-utils/mkswap.8.adoc:20
4351#, no-wrap
4352msgid "*mkswap* [options] _device_ [_size_]\n"
4353msgstr ""
4354
4355#. type: Plain text
4356#: ../disk-utils/mkswap.8.adoc:24
4357#, no-wrap
4358msgid "*mkswap* sets up a Linux swap area on a device or in a file.\n"
4359msgstr ""
4360
4361#. type: Plain text
4362#: ../disk-utils/mkswap.8.adoc:26
4363msgid ""
4364"The _device_ argument will usually be a disk partition (something like "
4365"_/dev/sdb7_) but can also be a file. The Linux kernel does not look at "
4366"partition IDs, but many installation scripts will assume that partitions of "
4367"hex type 82 (LINUX_SWAP) are meant to be swap partitions. (*Warning: Solaris "
4368"also uses this type. Be careful not to kill your Solaris partitions.*)"
4369msgstr ""
4370
4371#. type: Plain text
4372#: ../disk-utils/mkswap.8.adoc:28
4373msgid ""
4374"The _size_ parameter is superfluous but retained for backwards "
4375"compatibility. (It specifies the desired size of the swap area in 1024-byte "
4376"blocks. *mkswap* will use the entire partition or file if it is "
4377"omitted. Specifying it is unwise - a typo may destroy your disk.)"
4378msgstr ""
4379
4380#. type: Plain text
4381#: ../disk-utils/mkswap.8.adoc:30
4382msgid ""
4383"After creating the swap area, you need the *swapon* command to start using "
4384"it. Usually swap areas are listed in _/etc/fstab_ so that they can be taken "
4385"into use at boot time by a *swapon -a* command in some boot script."
4386msgstr ""
4387
4388#. type: Plain text
4389#: ../disk-utils/mkswap.8.adoc:34
4390msgid ""
4391"The swap header does not touch the first block. A boot loader or disk label "
4392"can be there, but it is not a recommended setup. The recommended setup is to "
4393"use a separate partition for a Linux swap area."
4394msgstr ""
4395
4396#. type: Plain text
4397#: ../disk-utils/mkswap.8.adoc:36
4398#, no-wrap
4399msgid ""
4400"*mkswap*, like many others mkfs-like utils, *erases the first partition "
4401"block to make any previous filesystem invisible.*\n"
4402msgstr ""
4403
4404#. type: Plain text
4405#: ../disk-utils/mkswap.8.adoc:38
4406msgid ""
4407"However, *mkswap* refuses to erase the first block on a device with a disk "
4408"label (SUN, BSD, ...)."
4409msgstr ""
4410
4411#. type: Plain text
4412#: ../disk-utils/mkswap.8.adoc:43
4413msgid ""
4414"Check the device (if it is a block device) for bad blocks before creating "
4415"the swap area. If any bad blocks are found, the count is printed."
4416msgstr ""
4417
4418#. type: Plain text
4419#: ../disk-utils/mkswap.8.adoc:46
4420msgid ""
4421"Go ahead even if the command is stupid. This allows the creation of a swap "
4422"area larger than the file or partition it resides on."
4423msgstr ""
4424
4425#. type: Plain text
4426#: ../disk-utils/mkswap.8.adoc:48
4427msgid ""
4428"Also, without this option, *mkswap* will refuse to erase the first block on "
4429"a device with a partition table."
4430msgstr ""
4431
4432#. type: Labeled list
4433#: ../disk-utils/mkswap.8.adoc:49 ../disk-utils/swaplabel.8.adoc:34
4434#: ../misc-utils/blkid.8.adoc:72 ../sys-utils/mount.8.adoc:327
4435#, no-wrap
4436msgid "*-L*, *--label* _label_"
4437msgstr ""
4438
4439#. type: Plain text
4440#: ../disk-utils/mkswap.8.adoc:51
4441msgid "Specify a _label_ for the device, to allow *swapon* by label."
4442msgstr ""
4443
4444#. type: Labeled list
4445#: ../disk-utils/mkswap.8.adoc:55
4446#, no-wrap
4447msgid "*-p*, *--pagesize* _size_"
4448msgstr ""
4449
4450#. type: Plain text
4451#: ../disk-utils/mkswap.8.adoc:57
4452msgid ""
4453"Specify the page _size_ (in bytes) to use. This option is usually "
4454"unnecessary; *mkswap* reads the size from the kernel."
4455msgstr ""
4456
4457#. type: Labeled list
4458#: ../disk-utils/mkswap.8.adoc:58 ../disk-utils/swaplabel.8.adoc:37
4459#, no-wrap
4460msgid "*-U*, *--uuid* _UUID_"
4461msgstr ""
4462
4463#. type: Plain text
4464#: ../disk-utils/mkswap.8.adoc:60
4465msgid "Specify the _UUID_ to use. The default is to generate a UUID."
4466msgstr ""
4467
4468#. type: Labeled list
4469#: ../disk-utils/mkswap.8.adoc:61
4470#, no-wrap
4471msgid "*-v*, *--swapversion 1*"
4472msgstr ""
4473
4474#. type: Plain text
4475#: ../disk-utils/mkswap.8.adoc:63
4476msgid ""
4477"Specify the swap-space version. (This option is currently pointless, as the "
4478"old *-v 0* option has become obsolete and now only *-v 1* is supported. The "
4479"kernel has not supported v0 swap-space format since 2.5.22 (June 2002). The "
4480"new version v1 is supported since 2.1.117 (August 1998).)"
4481msgstr ""
4482
4483#. type: Labeled list
2bee5365 4484#: ../disk-utils/mkswap.8.adoc:64 ../misc-utils/findmnt.8.adoc:166
b81d5971 4485#: ../misc-utils/kill.1.adoc:65 ../sys-utils/flock.1.adoc:83
36e96905
MB
4486#: ../sys-utils/prlimit.1.adoc:58
4487#, no-wrap
4488msgid "*--verbose*"
4489msgstr ""
4490
4491#. type: Plain text
4492#: ../disk-utils/mkswap.8.adoc:66
4493msgid ""
4494"Verbose execution. With this option *mkswap* will output more details about "
4495"detected problems during swap area set up."
4496msgstr ""
4497
4498#. type: Labeled list
4499#: ../disk-utils/mkswap.8.adoc:75 ../disk-utils/partx.8.adoc:107
4500#: ../disk-utils/sfdisk.8.adoc:391 ../disk-utils/swaplabel.8.adoc:42
4501#: ../misc-utils/findfs.8.adoc:58 ../misc-utils/lsblk.8.adoc:143
4502#: ../misc-utils/wipefs.8.adoc:86 ../sys-utils/mount.8.adoc:1406
4503#: ../sys-utils/swapon.8.adoc:129
4504#, no-wrap
4505msgid "LIBBLKID_DEBUG=all"
4506msgstr ""
4507
4508#. type: Plain text
4509#: ../disk-utils/mkswap.8.adoc:84
4510msgid ""
4511"The maximum useful size of a swap area depends on the architecture and the "
4512"kernel version."
4513msgstr ""
4514
4515#. type: Plain text
4516#: ../disk-utils/mkswap.8.adoc:86
4517msgid ""
4518"The maximum number of the pages that is possible to address by swap area "
4519"header is 4294967295 (32-bit unsigned int). The remaining space on the swap "
4520"device is ignored."
4521msgstr ""
4522
4523#. type: Plain text
4524#: ../disk-utils/mkswap.8.adoc:88
4525msgid ""
4526"Presently, Linux allows 32 swap areas. The areas in use can be seen in the "
4527"file _/proc/swaps_."
4528msgstr ""
4529
4530#. type: Plain text
4531#: ../disk-utils/mkswap.8.adoc:90
4532#, no-wrap
4533msgid "*mkswap* refuses areas smaller than 10 pages.\n"
4534msgstr ""
4535
4536#. type: Plain text
4537#: ../disk-utils/mkswap.8.adoc:92
4538msgid ""
4539"If you don't know the page size that your machine uses, you may be able to "
4540"look it up with *cat /proc/cpuinfo* (or you may not - the contents of this "
4541"file depend on architecture and kernel version)."
4542msgstr ""
4543
4544#. type: Plain text
4545#: ../disk-utils/mkswap.8.adoc:94
4546msgid ""
4547"To set up a swap file, it is necessary to create that file before "
4548"initializing it with *mkswap*, e.g. using a command like"
4549msgstr ""
4550
4551#. type: delimited block .
4552#: ../disk-utils/mkswap.8.adoc:97
4553#, no-wrap
4554msgid "# dd if=/dev/zero of=swapfile bs=1MiB count=$((8*1024))\n"
4555msgstr ""
4556
4557#. type: Plain text
4558#: ../disk-utils/mkswap.8.adoc:100
4559msgid "to create 8GiB swapfile."
4560msgstr ""
4561
4562#. type: Plain text
4563#: ../disk-utils/mkswap.8.adoc:102
4564msgid ""
4565"Please read notes from *swapon*(8) about *the swap file use restrictions* "
4566"(holes, preallocation and copy-on-write issues)."
4567msgstr ""
4568
4569#. type: Plain text
4570#: ../disk-utils/mkswap.8.adoc:107
4571#, no-wrap
4572msgid ""
4573"*fdisk*(8),\n"
4574"*swapon*(8)\n"
4575msgstr ""
4576
4577#. partx.8 -- man page for partx
4578#. Copyright 2007 Karel Zak <kzak@redhat.com>
4579#. Copyright 2007 Red Hat, Inc.
4580#. Copyright 2010 Davidlohr Bueso <dave@gnu.org>
4581#. May be distributed under the GNU General Public License
4582#. type: Title =
4583#: ../disk-utils/partx.8.adoc:9
4584#, no-wrap
4585msgid "partx(8)"
4586msgstr ""
4587
4588#. type: Plain text
4589#: ../disk-utils/partx.8.adoc:19
4590msgid ""
4591"partx - tell the kernel about the presence and numbering of on-disk "
4592"partitions"
4593msgstr ""
4594
4595#. type: Plain text
4596#: ../disk-utils/partx.8.adoc:23
4597#, no-wrap
4598msgid ""
4599"*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] [*-n* _M_:_N_] [-] "
4600"_disk_\n"
4601msgstr ""
4602
4603#. type: Plain text
4604#: ../disk-utils/partx.8.adoc:25
4605#, no-wrap
4606msgid "*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] _partition_ [_disk_]\n"
4607msgstr ""
4608
4609#. type: Plain text
4610#: ../disk-utils/partx.8.adoc:29
4611msgid ""
4612"Given a device or disk-image, *partx* tries to parse the partition table and "
4613"list its contents. It can also tell the kernel to add or remove partitions "
4614"from its bookkeeping."
4615msgstr ""
4616
4617#. type: Plain text
4618#: ../disk-utils/partx.8.adoc:31
4619msgid ""
4620"The _disk_ argument is optional when a _partition_ argument is provided. To "
4621"force scanning a partition as if it were a whole disk (for example to list "
4622"nested subpartitions), use the argument \"-\" (hyphen-minus). For example:"
4623msgstr ""
4624
4625#. type: delimited block _
4626#: ../disk-utils/partx.8.adoc:34
4627msgid "partx --show - /dev/sda3"
4628msgstr ""
4629
4630#. type: Plain text
4631#: ../disk-utils/partx.8.adoc:37
4632msgid "This will see sda3 as a whole-disk rather than as a partition."
4633msgstr ""
4634
4635#. type: Plain text
4636#: ../disk-utils/partx.8.adoc:39
4637#, no-wrap
4638msgid ""
4639"*partx is not an fdisk program* - adding and removing partitions does not "
4640"change the disk, it just tells the kernel about the presence and numbering "
4641"of on-disk partitions.\n"
4642msgstr ""
4643
4644#. type: Labeled list
4645#: ../disk-utils/partx.8.adoc:42
4646#, no-wrap
4647msgid "*-a*, *--add*"
4648msgstr ""
4649
4650#. type: Plain text
4651#: ../disk-utils/partx.8.adoc:44
4652msgid "Add the specified partitions, or read the disk and add all partitions."
4653msgstr ""
4654
4655#. type: Labeled list
4656#: ../disk-utils/partx.8.adoc:45 ../misc-utils/fincore.1.adoc:34
2bee5365 4657#: ../misc-utils/findmnt.8.adoc:40 ../misc-utils/lsblk.8.adoc:34
36e96905
MB
4658#: ../misc-utils/lslocks.8.adoc:36 ../sys-utils/ipcs.1.adoc:73
4659#: ../sys-utils/lsipc.1.adoc:72 ../sys-utils/lsmem.1.adoc:36
4660#, no-wrap
4661msgid "*-b*, *--bytes*"
4662msgstr ""
4663
4664#. type: Plain text
4665#: ../disk-utils/partx.8.adoc:47
4666msgid "Print the SIZE column in bytes rather than in human-readable format."
4667msgstr ""
4668
4669#. type: Labeled list
4670#: ../disk-utils/partx.8.adoc:48
4671#, no-wrap
4672msgid "*-d*, *--delete*"
4673msgstr ""
4674
4675#. type: Plain text
4676#: ../disk-utils/partx.8.adoc:50
4677msgid ""
4678"Delete the specified partitions or all partitions. It is not error to remove "
4679"non-existing partitions, so this option is possible to use together with "
4680"large *--nr* ranges without care about the current partitions set on the "
4681"device."
4682msgstr ""
4683
4684#. type: Labeled list
4685#: ../disk-utils/partx.8.adoc:51
4686#, no-wrap
4687msgid "*-g*, *--noheadings*"
4688msgstr ""
4689
4690#. type: Plain text
4691#: ../disk-utils/partx.8.adoc:53
4692msgid "Do not print a header line with *--show* or *--raw*."
4693msgstr ""
4694
4695#. type: Plain text
4696#: ../disk-utils/partx.8.adoc:56
4697msgid ""
4698"List the partitions. Note that all numbers are in 512-byte sectors. This "
4699"output format is DEPRECATED in favour of *--show*. Do not use it in newly "
4700"written scripts."
4701msgstr ""
4702
4703#. type: Labeled list
4704#: ../disk-utils/partx.8.adoc:57
4705#, no-wrap
4706msgid "*-n*, *--nr* __M__**:**_N_"
4707msgstr ""
4708
4709#. type: Plain text
4710#: ../disk-utils/partx.8.adoc:59
4711msgid ""
4712"Specify the range of partitions. For backward compatibility also the format "
4713"__M__**-**_N_ is supported. The range may contain negative numbers, for "
4714"example *--nr -1:-1* means the last partition, and *--nr -2:-1* means the "
4715"last two partitions. Supported range specifications are:"
4716msgstr ""
4717
4718#. type: Labeled list
4719#: ../disk-utils/partx.8.adoc:60
4720#, no-wrap
4721msgid "_M_"
4722msgstr ""
4723
4724#. type: Plain text
4725#: ../disk-utils/partx.8.adoc:62
4726msgid "Specifies just one partition (e.g. *--nr 3*)."
4727msgstr ""
4728
4729#. type: Labeled list
4730#: ../disk-utils/partx.8.adoc:62
4731#, no-wrap
4732msgid "__M__**:**"
4733msgstr ""
4734
4735#. type: Plain text
4736#: ../disk-utils/partx.8.adoc:64
4737msgid "Specifies the lower limit only (e.g. *--nr 2:*)."
4738msgstr ""
4739
4740#. type: Labeled list
4741#: ../disk-utils/partx.8.adoc:64
4742#, no-wrap
4743msgid "**:**__N__"
4744msgstr ""
4745
4746#. type: Plain text
4747#: ../disk-utils/partx.8.adoc:66
4748msgid "Specifies the upper limit only (e.g. *--nr :4*)."
4749msgstr ""
4750
4751#. type: Labeled list
4752#: ../disk-utils/partx.8.adoc:66
4753#, no-wrap
4754msgid "__M__**:**_N_"
4755msgstr ""
4756
4757#. type: Plain text
4758#: ../disk-utils/partx.8.adoc:68
4759msgid "Specifies the lower and upper limits (e.g. *--nr 2:4*)."
4760msgstr ""
4761
4762#. type: Plain text
4763#: ../disk-utils/partx.8.adoc:71
4764msgid ""
4765"Define the output columns to use for *--show*, *--pairs* and *--raw* "
4766"output. If no output arrangement is specified, then a default set is "
4767"used. Use *--help* to get _list_ of all supported columns. This option "
4768"cannot be combined with the *--add*, *--delete*, *--update* or *--list* "
4769"options."
4770msgstr ""
4771
4772#. type: Labeled list
4773#: ../disk-utils/partx.8.adoc:72 ../login-utils/lslogins.1.adoc:75
2bee5365 4774#: ../misc-utils/findmnt.8.adoc:101 ../misc-utils/lslocks.8.adoc:54
36e96905
MB
4775#: ../sys-utils/losetup.8.adoc:104 ../sys-utils/lscpu.1.adoc:145
4776#: ../sys-utils/lsmem.1.adoc:51 ../sys-utils/lsns.8.adoc:48
4777#: ../sys-utils/rfkill.8.adoc:36 ../sys-utils/swapon.8.adoc:74
4778#: ../sys-utils/zramctl.8.adoc:53
4779#, no-wrap
4780msgid "*--output-all*"
4781msgstr ""
4782
4783#. type: Plain text
4784#: ../disk-utils/partx.8.adoc:74 ../misc-utils/lsblk.8.adoc:85
4785#: ../misc-utils/lslocks.8.adoc:56 ../sys-utils/losetup.8.adoc:106
4786#: ../sys-utils/lsmem.1.adoc:53 ../sys-utils/lsns.8.adoc:50
4787#: ../sys-utils/rfkill.8.adoc:38 ../sys-utils/swapon.8.adoc:76
4788#: ../sys-utils/zramctl.8.adoc:55
4789msgid "Output all available columns."
4790msgstr ""
4791
4792#. type: Labeled list
2bee5365 4793#: ../disk-utils/partx.8.adoc:75 ../misc-utils/findmnt.8.adoc:104
36e96905
MB
4794#: ../misc-utils/lsblk.8.adoc:86 ../sys-utils/lsirq.1.adoc:37
4795#: ../sys-utils/lsmem.1.adoc:54
4796#, no-wrap
4797msgid "*-P*, *--pairs*"
4798msgstr ""
4799
4800#. type: Plain text
4801#: ../disk-utils/partx.8.adoc:77
4802msgid "List the partitions using the KEY=\"value\" format."
4803msgstr ""
4804
4805#. type: Labeled list
4806#: ../disk-utils/partx.8.adoc:78 ../login-utils/lslogins.1.adoc:81
2bee5365 4807#: ../misc-utils/fincore.1.adoc:41 ../misc-utils/findmnt.8.adoc:130
36e96905
MB
4808#: ../misc-utils/lsblk.8.adoc:92 ../misc-utils/lslocks.8.adoc:60
4809#: ../misc-utils/uuidparse.1.adoc:59 ../sys-utils/dmesg.1.adoc:99
4810#: ../sys-utils/lsipc.1.adoc:75 ../sys-utils/lsmem.1.adoc:57
4811#: ../sys-utils/lsns.8.adoc:54 ../sys-utils/rfkill.8.adoc:39
4812#: ../sys-utils/wdctl.8.adoc:45
4813#, no-wrap
4814msgid "*-r*, *--raw*"
4815msgstr ""
4816
4817#. type: Plain text
4818#: ../disk-utils/partx.8.adoc:80
4819msgid "List the partitions using the raw output format."
4820msgstr ""
4821
4822#. type: Labeled list
4823#: ../disk-utils/partx.8.adoc:81
4824#, no-wrap
4825msgid "*-s*, *--show*"
4826msgstr ""
4827
4828#. type: Plain text
4829#: ../disk-utils/partx.8.adoc:83
4830msgid ""
4831"List the partitions. The output columns can be selected and rearranged with "
4832"the *--output* option. All numbers (except SIZE) are in 512-byte sectors."
4833msgstr ""
4834
4835#. type: Plain text
4836#: ../disk-utils/partx.8.adoc:86
4837msgid "Specify the partition table type."
4838msgstr ""
4839
4840#. type: Labeled list
4841#: ../disk-utils/partx.8.adoc:87
4842#, no-wrap
4843msgid "*--list-types*"
4844msgstr ""
4845
4846#. type: Plain text
4847#: ../disk-utils/partx.8.adoc:89
4848msgid "List supported partition types and exit."
4849msgstr ""
4850
4851#. type: Labeled list
4852#: ../disk-utils/partx.8.adoc:90
4853#, no-wrap
4854msgid "*-u*, *--update*"
4855msgstr ""
4856
4857#. type: Plain text
4858#: ../disk-utils/partx.8.adoc:92
4859msgid "Update the specified partitions."
4860msgstr ""
4861
4862#. type: Labeled list
4863#: ../disk-utils/partx.8.adoc:93
4864#, no-wrap
4865msgid "*-S*, *--sector-size* _size_"
4866msgstr ""
4867
4868#. type: Plain text
4869#: ../disk-utils/partx.8.adoc:95
4870msgid "Overwrite default sector size."
4871msgstr ""
4872
4873#. type: Plain text
4874#: ../disk-utils/partx.8.adoc:98 ../sys-utils/losetup.8.adoc:97
4875#: ../sys-utils/mount.8.adoc:431 ../sys-utils/prlimit.1.adoc:60
4876#: ../sys-utils/umount.8.adoc:113
4877msgid "Verbose mode."
4878msgstr ""
4879
4880#. type: Title ==
4881#: ../disk-utils/partx.8.adoc:110 ../lib/terminal-colors.d.5.adoc:142
4882#: ../misc-utils/uuidd.8.adoc:71 ../sys-utils/chmem.8.adoc:71
3a213557 4883#: ../sys-utils/losetup.8.adoc:147 ../sys-utils/pivot_root.8.adoc:41
36e96905
MB
4884#: ../sys-utils/readprofile.8.adoc:81 ../sys-utils/rfkill.8.adoc:68
4885#: ../sys-utils/setarch.8.adoc:79 ../sys-utils/zramctl.8.adoc:85
4886#: ../term-utils/agetty.8.adoc:189
4887#, no-wrap
4888msgid "EXAMPLE"
4889msgstr ""
4890
4891#. type: Labeled list
4892#: ../disk-utils/partx.8.adoc:112
4893#, no-wrap
4894msgid "partx --show /dev/sdb3"
4895msgstr ""
4896
4897#. type: Labeled list
4898#: ../disk-utils/partx.8.adoc:113
4899#, no-wrap
4900msgid "partx --show --nr 3 /dev/sdb"
4901msgstr ""
4902
4903#. type: Labeled list
4904#: ../disk-utils/partx.8.adoc:114
4905#, no-wrap
4906msgid "partx --show /dev/sdb3 /dev/sdb"
4907msgstr ""
4908
4909#. type: Plain text
4910#: ../disk-utils/partx.8.adoc:116
4911msgid "All three commands list partition 3 of /dev/sdb."
4912msgstr ""
4913
4914#. type: Labeled list
4915#: ../disk-utils/partx.8.adoc:117
4916#, no-wrap
4917msgid "partx --show - /dev/sdb3"
4918msgstr ""
4919
4920#. type: Plain text
4921#: ../disk-utils/partx.8.adoc:119
4922msgid "Lists all subpartitions on _/dev/sdb3_ (the device is used as whole-disk)."
4923msgstr ""
4924
4925#. type: Labeled list
4926#: ../disk-utils/partx.8.adoc:120
4927#, no-wrap
4928msgid "partx -o START -g --nr 5 /dev/sdb"
4929msgstr ""
4930
4931#. type: Plain text
4932#: ../disk-utils/partx.8.adoc:122
4933msgid "Prints the start sector of partition 5 on _/dev/sdb_ without header."
4934msgstr ""
4935
4936#. type: Labeled list
4937#: ../disk-utils/partx.8.adoc:123
4938#, no-wrap
4939msgid "partx -o SECTORS,SIZE /dev/sda5 /dev/sda"
4940msgstr ""
4941
4942#. type: Plain text
4943#: ../disk-utils/partx.8.adoc:125
4944msgid ""
4945"Lists the length in sectors and human-readable size of partition 5 on "
4946"_/dev/sda_."
4947msgstr ""
4948
4949#. type: Labeled list
4950#: ../disk-utils/partx.8.adoc:126
4951#, no-wrap
4952msgid "partx --add --nr 3:5 /dev/sdd"
4953msgstr ""
4954
4955#. type: Plain text
4956#: ../disk-utils/partx.8.adoc:128
4957msgid "Adds all available partitions from 3 to 5 (inclusive) on _/dev/sdd_."
4958msgstr ""
4959
4960#. type: Labeled list
4961#: ../disk-utils/partx.8.adoc:129
4962#, no-wrap
4963msgid "partx -d --nr :-1 /dev/sdd"
4964msgstr ""
4965
4966#. type: Plain text
4967#: ../disk-utils/partx.8.adoc:131
4968msgid "Removes the last partition on _/dev/sdd_."
4969msgstr ""
4970
4971#. type: Plain text
4972#: ../disk-utils/partx.8.adoc:136
4973msgid "mailto:dave@gnu.org[Davidlohr Bueso], mailto:kzak@redhat.com[Karel Zak]"
4974msgstr ""
4975
4976#. type: Plain text
4977#: ../disk-utils/partx.8.adoc:138
4978msgid "The original version was written by mailto:aeb@cwi.nl[Andries E. Brouwer]"
4979msgstr ""
4980
4981#. type: Plain text
4982#: ../disk-utils/partx.8.adoc:146
4983#, no-wrap
4984msgid ""
4985"*addpart*(8),\n"
4986"*delpart*(8),\n"
4987"*fdisk*(8),\n"
4988"*parted*(8),\n"
4989"*partprobe*(8)\n"
4990msgstr ""
4991
4992#. type: Title =
4993#: ../disk-utils/raw.8.adoc:2
4994#, no-wrap
4995msgid "raw(8)"
4996msgstr ""
4997
4998#. type: Plain text
4999#: ../disk-utils/raw.8.adoc:12
5000msgid "raw - bind a Linux raw character device"
5001msgstr ""
5002
5003#. type: Plain text
5004#: ../disk-utils/raw.8.adoc:16
5005#, no-wrap
5006msgid "*raw* _/dev/raw/raw<N>_ _<major>_ _<minor>_\n"
5007msgstr ""
5008
5009#. type: Plain text
5010#: ../disk-utils/raw.8.adoc:18
5011#, no-wrap
5012msgid "*raw* _/dev/raw/raw<N>_ _/dev/<blockdev>_\n"
5013msgstr ""
5014
5015#. type: Plain text
5016#: ../disk-utils/raw.8.adoc:20
5017#, no-wrap
5018msgid "*raw* *-q* _/dev/raw/raw<N>_\n"
5019msgstr ""
5020
5021#. type: Plain text
5022#: ../disk-utils/raw.8.adoc:22
5023#, no-wrap
5024msgid "*raw* *-qa*\n"
5025msgstr ""
5026
5027#. type: Plain text
5028#: ../disk-utils/raw.8.adoc:26
5029#, no-wrap
5030msgid ""
5031"*raw* is used to bind a Linux raw character device to a block device. Any "
5032"block device may be used: at the time of binding, the device driver does not "
5033"even have to be accessible (it may be loaded on demand as a kernel module "
5034"later).\n"
5035msgstr ""
5036
5037#. type: Plain text
5038#: ../disk-utils/raw.8.adoc:28
5039#, no-wrap
5040msgid ""
5041"*raw* is used in two modes: it either sets raw device bindings, or it "
5042"queries existing bindings. When setting a raw device, _/dev/raw/raw<N>_ is "
5043"the device name of an existing raw device node in the filesystem. The block "
5044"device to which it is to be bound can be specified either in terms of its "
5045"_major_ and _minor_ device numbers, or as a path name _/dev/<blockdev>_ to "
5046"an existing block device file.\n"
5047msgstr ""
5048
5049#. type: Plain text
5050#: ../disk-utils/raw.8.adoc:30
5051msgid ""
5052"The bindings already in existence can be queried with the *-q* option, which "
5053"is used either with a raw device filename to query that one device, or with "
5054"the *-a* option to query all bound raw devices."
5055msgstr ""
5056
5057#. type: Plain text
5058#: ../disk-utils/raw.8.adoc:32
5059msgid "Unbinding can be done by specifying major and minor 0."
5060msgstr ""
5061
5062#. type: Plain text
5063#: ../disk-utils/raw.8.adoc:34
5064msgid ""
5065"Once bound to a block device, a raw device can be opened, read and written, "
5066"just like the block device it is bound to. However, the raw device does not "
5067"behave exactly like the block device. In particular, access to the raw "
5068"device bypasses the kernel's block buffer cache entirely: all I/O is done "
5069"directly to and from the address space of the process performing the I/O. If "
5070"the underlying block device driver can support DMA, then no data copying at "
5071"all is required to complete the I/O."
5072msgstr ""
5073
5074#. type: Plain text
5075#: ../disk-utils/raw.8.adoc:36
5076msgid ""
5077"Because raw I/O involves direct hardware access to a process's memory, a few "
5078"extra restrictions must be observed. All I/Os must be correctly aligned in "
5079"memory and on disk: they must start at a sector offset on disk, they must be "
5080"an exact number of sectors long, and the data buffer in virtual memory must "
5081"also be aligned to a multiple of the sector size. The sector size is 512 "
5082"bytes for most devices."
5083msgstr ""
5084
5085#. type: Labeled list
5086#: ../disk-utils/raw.8.adoc:39
5087#, no-wrap
5088msgid "*-q*, *--query*"
5089msgstr ""
5090
5091#. type: Plain text
5092#: ../disk-utils/raw.8.adoc:41
5093msgid ""
5094"Set query mode. *raw* will query an existing binding instead of setting a "
5095"new one."
5096msgstr ""
5097
5098#. type: Labeled list
5099#: ../disk-utils/raw.8.adoc:42 ../misc-utils/kill.1.adoc:61
5100#: ../misc-utils/lsblk.8.adoc:31 ../misc-utils/wipefs.8.adoc:40
5101#: ../sys-utils/ipcs.1.adoc:47 ../sys-utils/losetup.8.adoc:53
5102#: ../sys-utils/lscpu.1.adoc:86 ../sys-utils/lsmem.1.adoc:33
5103#: ../sys-utils/mount.8.adoc:301 ../sys-utils/nsenter.1.adoc:53
5104#: ../sys-utils/readprofile.8.adoc:27 ../sys-utils/swapon.8.adoc:31
5105#: ../sys-utils/umount.8.adoc:54
5106#, no-wrap
5107msgid "*-a*, *--all*"
5108msgstr ""
5109
5110#. type: Plain text
5111#: ../disk-utils/raw.8.adoc:44
5112msgid "With *-q*, specify that all bound raw devices should be queried."
5113msgstr ""
5114
5115#. type: Plain text
5116#: ../disk-utils/raw.8.adoc:54
5117msgid ""
5118"Rather than using raw devices applications should prefer open2 devices, such "
5119"as _/dev/sda1_, with the *O_DIRECT* flag."
5120msgstr ""
5121
5122#. type: Plain text
5123#: ../disk-utils/raw.8.adoc:58
5124msgid ""
5125"The Linux *dd*(1) command should be used without the *bs=* option, or the "
5126"blocksize needs to be a multiple of the sector size of the device (512 bytes "
5127"usually), otherwise it will fail with \"Invalid Argument\" messages "
5128"(*EINVAL*)."
5129msgstr ""
5130
5131#. type: Plain text
5132#: ../disk-utils/raw.8.adoc:60
5133msgid ""
5134"Raw I/O devices do not maintain cache coherency with the Linux block device "
5135"buffer cache. If you use raw I/O to overwrite data already in the buffer "
5136"cache, the buffer cache will no longer correspond to the contents of the "
5137"actual storage device underneath. This is deliberate, but is regarded as "
5138"either a bug or a feature, depending on who you ask!"
5139msgstr ""
5140
5141#. type: Plain text
5142#: ../disk-utils/raw.8.adoc:64
5143msgid "mailto:sct@redhat.com[Stephen Tweedie]"
5144msgstr ""
5145
5146#. resizepart.8 -- man page for resizepart
5147#. Copyright 2012 Vivek Goyal <vgoyal@redhat.com>
5148#. Copyright 2012 Red Hat, Inc.
5149#. May be distributed under the GNU General Public License
5150#. type: Title =
5151#: ../disk-utils/resizepart.8.adoc:8
5152#, no-wrap
5153msgid "resizepart(8)"
5154msgstr ""
5155
5156#. type: Plain text
5157#: ../disk-utils/resizepart.8.adoc:18
5158msgid "resizepart - tell the kernel about the new size of a partition"
5159msgstr ""
5160
5161#. type: Plain text
5162#: ../disk-utils/resizepart.8.adoc:22
5163#, no-wrap
5164msgid "*resizepart* _device partition length_\n"
5165msgstr ""
5166
5167#. type: Plain text
5168#: ../disk-utils/resizepart.8.adoc:26
5169#, no-wrap
5170msgid ""
5171"*resizepart* tells the Linux kernel about the new size of the specified "
5172"partition. The command is a simple wrapper around the \"resize partition\" "
5173"ioctl.\n"
5174msgstr ""
5175
5176#. type: Plain text
5177#: ../disk-utils/resizepart.8.adoc:39
5178msgid "The new length of the partition (in 512-byte sectors)."
5179msgstr ""
5180
5181#. type: Plain text
5182#: ../disk-utils/resizepart.8.adoc:48
5183#, no-wrap
5184msgid ""
5185"*addpart*(8),\n"
5186"*delpart*(8),\n"
5187"*fdisk*(8),\n"
5188"*parted*(8),\n"
5189"*partprobe*(8),\n"
5190"*partx*(8)\n"
5191msgstr ""
5192
5193#. sfdisk.8 -- man page for sfdisk
5194#. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
5195#
5196#. Permission is granted to make and distribute verbatim copies of this
5197#. manual provided the copyright notice and this permission notice are
5198#. preserved on all copies.
5199#
5200#. Permission is granted to copy and distribute modified versions of this
5201#. manual under the conditions for verbatim copying, provided that the
5202#. entire resulting derived work is distributed under the terms of a
5203#. permission notice identical to this one.
5204#. type: Title =
5205#: ../disk-utils/sfdisk.8.adoc:15
5206#, no-wrap
5207msgid "sfdisk(8)"
5208msgstr ""
5209
5210#. type: Plain text
5211#: ../disk-utils/sfdisk.8.adoc:27
5212msgid "sfdisk - display or manipulate a disk partition table"
5213msgstr ""
5214
5215#. type: Plain text
5216#: ../disk-utils/sfdisk.8.adoc:31
5217#, no-wrap
5218msgid "*sfdisk* [options] _device_ [*-N* _partition-number_]\n"
5219msgstr ""
5220
5221#. type: Plain text
5222#: ../disk-utils/sfdisk.8.adoc:33
5223#, no-wrap
5224msgid "*sfdisk* [options] _command_]\n"
5225msgstr ""
5226
5227#. type: Plain text
5228#: ../disk-utils/sfdisk.8.adoc:37
5229#, no-wrap
5230msgid ""
5231"*sfdisk* is a script-oriented tool for partitioning any block device. It "
5232"runs in interactive mode if executed on a terminal (stdin refers to a "
5233"terminal).\n"
5234msgstr ""
5235
5236#. type: Plain text
5237#: ../disk-utils/sfdisk.8.adoc:39
5238msgid ""
5239"Since version 2.26 *sfdisk* supports MBR (DOS), GPT, SUN and SGI disk "
5240"labels, but no longer provides any functionality for CHS "
5241"(Cylinder-Head-Sector) addressing. CHS has never been important for Linux, "
5242"and this addressing concept does not make any sense for new devices."
5243msgstr ""
5244
5245#. type: Plain text
5246#: ../disk-utils/sfdisk.8.adoc:41
5247#, no-wrap
5248msgid ""
5249"*sfdisk* protects the first disk sector when create a new disk label. The "
5250"option *--wipe always* disables this protection. Note that *fdisk*(8) and "
5251"*cfdisk*(8) completely erase this area by default.\n"
5252msgstr ""
5253
5254#. type: Plain text
5255#: ../disk-utils/sfdisk.8.adoc:43
5256#, no-wrap
5257msgid ""
5258"*sfdisk* (since version 2.26) *aligns the start and end of partitions* to "
5259"block-device I/O limits when relative sizes are specified, when the default "
5260"values are used or when multiplicative suffixes (e.g., MiB) are used for "
5261"sizes. It is possible that partition size will be optimized (reduced or "
5262"enlarged) due to alignment if the start offset is specified exactly in "
5263"sectors and partition size relative or by multiplicative suffixes.\n"
5264msgstr ""
5265
5266#. type: Plain text
5267#: ../disk-utils/sfdisk.8.adoc:45
5268msgid ""
5269"The recommended way is not to specify start offsets at all and specify "
5270"partition size in MiB, GiB (or so). In this case *sfdisk* aligns all "
5271"partitions to block-device I/O limits (or when I/O limits are too small then "
5272"to megabyte boundary to keep disk layout portable). If this default "
5273"behaviour is unwanted (usually for very small partitions) then specify "
5274"offsets and sizes in sectors. In this case *sfdisk* entirely follows "
5275"specified numbers without any optimization."
5276msgstr ""
5277
5278#. type: Plain text
5279#: ../disk-utils/sfdisk.8.adoc:47
5280#, no-wrap
5281msgid ""
5282"*sfdisk* does not create the standard system partitions for SGI and SUN disk "
5283"labels like *fdisk*(8) does. It is necessary to explicitly create all "
5284"partitions including whole-disk system partitions.\n"
5285msgstr ""
5286
5287#. type: Plain text
5288#: ../disk-utils/sfdisk.8.adoc:49
5289#, no-wrap
5290msgid ""
5291"*sfdisk* uses *BLKRRPART* (reread partition table) ioctl to make sure that "
5292"the device is not used by system or other tools (see also "
5293"*--no-reread*). It's possible that this feature or another *sfdisk* activity "
5294"races with *udevd*. The recommended way how to avoid possible collisions is "
5295"to use *--lock* option. The exclusive lock will cause udevd to skip the "
5296"event handling on the device.\n"
5297msgstr ""
5298
5299#. type: Plain text
5300#: ../disk-utils/sfdisk.8.adoc:51
5301msgid ""
5302"The *sfdisk* prompt is only a hint for users and a displayed partition "
5303"number does not mean that the same partition table entry will be created (if "
5304"*-N* not specified), especially for tables with gaps."
5305msgstr ""
5306
5307#. type: Plain text
5308#: ../disk-utils/sfdisk.8.adoc:55
5309msgid "The commands are mutually exclusive."
5310msgstr ""
5311
5312#. type: Labeled list
5313#: ../disk-utils/sfdisk.8.adoc:56
5314#, no-wrap
5315msgid "[*-N* _partition-number_] __device__"
5316msgstr ""
5317
5318#. type: Plain text
5319#: ../disk-utils/sfdisk.8.adoc:58
5320msgid ""
5321"The default *sfdisk* command is to read the specification for the desired "
5322"partitioning of _device_ from standard input, and then create a partition "
5323"table according to the specification. See below for the description of the "
5324"input format. If standard input is a terminal, then *sfdisk* starts an "
5325"interactive session."
5326msgstr ""
5327
5328#. type: Plain text
5329#: ../disk-utils/sfdisk.8.adoc:60
5330msgid ""
5331"If the option *-N* is specified, then the changes are applied to the "
5332"partition addressed by _partition-number_. The unspecified fields of the "
5333"partition are not modified."
5334msgstr ""
5335
5336#. type: Plain text
5337#: ../disk-utils/sfdisk.8.adoc:62
5338msgid ""
5339"Note that it's possible to address an unused partition with *-N*. For "
5340"example, an MBR always contains 4 partitions, but the number of used "
5341"partitions may be smaller. In this case *sfdisk* follows the default values "
5342"from the partition table and does not use built-in defaults for the unused "
5343"partition given with *-N*. See also *--append*."
5344msgstr ""
5345
5346#. type: Labeled list
5347#: ../disk-utils/sfdisk.8.adoc:63
5348#, no-wrap
5349msgid "*-A*, *--activate* __device__ [__partition-number__...]"
5350msgstr ""
5351
5352#. type: Plain text
5353#: ../disk-utils/sfdisk.8.adoc:65
5354msgid ""
5355"Switch on the bootable flag for the specified partitions and switch off the "
5356"bootable flag on all unspecified partitions. The special placeholder '-' may "
5357"be used instead of the partition numbers to switch off the bootable flag on "
5358"all partitions."
5359msgstr ""
5360
5361#. type: Plain text
5362#: ../disk-utils/sfdisk.8.adoc:67
5363msgid ""
5364"The activation command is supported for MBR and PMBR only. If a GPT label is "
5365"detected, then *sfdisk* prints warning and automatically enters PMBR."
5366msgstr ""
5367
5368#. type: Plain text
5369#: ../disk-utils/sfdisk.8.adoc:69
5370msgid ""
5371"If no _partition-number_ is specified, then list the partitions with an "
5372"enabled flag."
5373msgstr ""
5374
5375#. type: Labeled list
5376#: ../disk-utils/sfdisk.8.adoc:70
5377#, no-wrap
5378msgid "*--delete* _device_ [__partition-number__...]"
5379msgstr ""
5380
5381#. type: Plain text
5382#: ../disk-utils/sfdisk.8.adoc:72
5383msgid "Delete all or the specified partitions."
5384msgstr ""
5385
5386#. type: Labeled list
5387#: ../disk-utils/sfdisk.8.adoc:73
5388#, no-wrap
5389msgid "*-d*, *--dump* _device_"
5390msgstr ""
5391
5392#. type: Plain text
5393#: ../disk-utils/sfdisk.8.adoc:75
5394msgid ""
5395"Dump the partitions of a device in a format that is usable as input to "
5396"*sfdisk*. See the section *BACKING UP THE PARTITION TABLE*."
5397msgstr ""
5398
5399#. type: Labeled list
5400#: ../disk-utils/sfdisk.8.adoc:76
5401#, no-wrap
5402msgid "*-g*, *--show-geometry* [__device__...]"
5403msgstr ""
5404
5405#. type: Plain text
5406#: ../disk-utils/sfdisk.8.adoc:78
5407msgid ""
5408"List the geometry of all or the specified devices. For backward "
5409"compatibility the deprecated option *--show-pt-geometry* have the same "
5410"meaning as this one."
5411msgstr ""
5412
5413#. type: Labeled list
5414#: ../disk-utils/sfdisk.8.adoc:79
5415#, no-wrap
5416msgid "*-J*, *--json* _device_"
5417msgstr ""
5418
5419#. type: Plain text
5420#: ../disk-utils/sfdisk.8.adoc:81
5421msgid ""
5422"Dump the partitions of a device in JSON format. Note that *sfdisk* is not "
5423"able to use JSON as input format."
5424msgstr ""
5425
5426#. type: Labeled list
5427#: ../disk-utils/sfdisk.8.adoc:82
5428#, no-wrap
5429msgid "*-l*, *--list* [__device__...]"
5430msgstr ""
5431
5432#. type: Plain text
5433#: ../disk-utils/sfdisk.8.adoc:84
5434msgid ""
5435"List the partitions of all or the specified devices. This command can be "
5436"used together with *--verify*."
5437msgstr ""
5438
5439#. type: Labeled list
5440#: ../disk-utils/sfdisk.8.adoc:85
5441#, no-wrap
5442msgid "*-F*, *--list-free* [__device__...]"
5443msgstr ""
5444
5445#. type: Plain text
5446#: ../disk-utils/sfdisk.8.adoc:87
5447msgid "List the free unpartitioned areas on all or the specified devices."
5448msgstr ""
5449
5450#. type: Labeled list
5451#: ../disk-utils/sfdisk.8.adoc:88
5452#, no-wrap
5453msgid "*--part-attrs* _device partition-number_ [__attributes__]"
5454msgstr ""
5455
5456#. type: Plain text
5457#: ../disk-utils/sfdisk.8.adoc:90
5458msgid ""
5459"Change the GPT partition attribute bits. If _attributes_ is not specified, "
5460"then print the current partition settings. The _attributes_ argument is a "
5461"comma- or space-delimited list of bits numbers or bit names. For example, "
5462"the string \"RequiredPartition,50,51\" sets three bits. The currently "
5463"supported attribute bits are:"
5464msgstr ""
5465
5466#. type: Labeled list
5467#: ../disk-utils/sfdisk.8.adoc:91
5468#, no-wrap
5469msgid "*Bit 0 (RequiredPartition)*"
5470msgstr ""
5471
5472#. type: Plain text
5473#: ../disk-utils/sfdisk.8.adoc:93
5474msgid ""
5475"If this bit is set, the partition is required for the platform to "
5476"function. The creator of the partition indicates that deletion or "
5477"modification of the contents can result in loss of platform features or "
5478"failure for the platform to boot or operate. The system cannot function "
5479"normally if this partition is removed, and it should be considered part of "
5480"the hardware of the system."
5481msgstr ""
5482
5483#. type: Labeled list
5484#: ../disk-utils/sfdisk.8.adoc:93
5485#, no-wrap
5486msgid "*Bit 1 (NoBlockIOProtocol)*"
5487msgstr ""
5488
5489#. type: Plain text
5490#: ../disk-utils/sfdisk.8.adoc:95
5491msgid ""
5492"EFI firmware should ignore the content of the partition and not try to read "
5493"from it."
5494msgstr ""
5495
5496#. type: Labeled list
5497#: ../disk-utils/sfdisk.8.adoc:95
5498#, no-wrap
5499msgid "*Bit 2 (LegacyBIOSBootable)*"
5500msgstr ""
5501
5502#. type: Plain text
5503#: ../disk-utils/sfdisk.8.adoc:97
5504msgid "The partition may be bootable by legacy BIOS firmware."
5505msgstr ""
5506
5507#. type: Labeled list
5508#: ../disk-utils/sfdisk.8.adoc:97
5509#, no-wrap
5510msgid "*Bits 3-47*"
5511msgstr ""
5512
5513#. type: Plain text
5514#: ../disk-utils/sfdisk.8.adoc:99
5515msgid ""
5516"Undefined and must be zero. Reserved for expansion by future versions of the "
5517"UEFI specification."
5518msgstr ""
5519
5520#. type: Labeled list
5521#: ../disk-utils/sfdisk.8.adoc:99
5522#, no-wrap
5523msgid "*Bits 48-63*"
5524msgstr ""
5525
5526#. type: Plain text
5527#: ../disk-utils/sfdisk.8.adoc:101
5528msgid ""
5529"Reserved for GUID specific use. The use of these bits will vary depending on "
5530"the partition type. For example Microsoft uses bit 60 to indicate read-only, "
5531"61 for shadow copy of another partition, 62 for hidden partitions and 63 to "
5532"disable automount."
5533msgstr ""
5534
5535#. type: Labeled list
5536#: ../disk-utils/sfdisk.8.adoc:102
5537#, no-wrap
5538msgid "*--part-label* _device partition-number_ [__label__]"
5539msgstr ""
5540
5541#. type: Plain text
5542#: ../disk-utils/sfdisk.8.adoc:104
5543msgid ""
5544"Change the GPT partition name (label). If _label_ is not specified, then "
5545"print the current partition label."
5546msgstr ""
5547
5548#. type: Labeled list
5549#: ../disk-utils/sfdisk.8.adoc:105
5550#, no-wrap
5551msgid "*--part-type* _device partition-number_ [__type__]"
5552msgstr ""
5553
5554#. type: Plain text
5555#: ../disk-utils/sfdisk.8.adoc:107
5556msgid ""
5557"Change the partition type. If _type_ is not specified, then print the "
5558"current partition type."
5559msgstr ""
5560
5561#. type: Plain text
5562#: ../disk-utils/sfdisk.8.adoc:109
5563msgid ""
5564"The _type_ argument is hexadecimal for MBR, GUID for GPT, type alias "
5565"(e.g. \"linux\") or type shortcut (e.g. 'L'). For backward compatibility the "
5566"options *-c* and *--id* have the same meaning as this one."
5567msgstr ""
5568
5569#. type: Labeled list
5570#: ../disk-utils/sfdisk.8.adoc:110
5571#, no-wrap
5572msgid "*--part-uuid* _device partition-number_ [__uuid__]"
5573msgstr ""
5574
5575#. type: Plain text
5576#: ../disk-utils/sfdisk.8.adoc:112
5577msgid ""
5578"Change the GPT partition UUID. If _uuid_ is not specified, then print the "
5579"current partition UUID."
5580msgstr ""
5581
5582#. type: Labeled list
5583#: ../disk-utils/sfdisk.8.adoc:113
5584#, no-wrap
5585msgid "*--disk-id* _device_ [__id__]"
5586msgstr ""
5587
5588#. type: Plain text
5589#: ../disk-utils/sfdisk.8.adoc:115
5590msgid ""
5591"Change the disk identifier. If _id_ is not specified, then print the current "
5592"identifier. The identifier is UUID for GPT or unsigned integer for MBR."
5593msgstr ""
5594
5595#. type: Labeled list
5596#: ../disk-utils/sfdisk.8.adoc:116
5597#, no-wrap
5598msgid "*-r*, *--reorder* _device_"
5599msgstr ""
5600
5601#. type: Plain text
5602#: ../disk-utils/sfdisk.8.adoc:118
5603msgid "Renumber the partitions, ordering them by their start offset."
5604msgstr ""
5605
5606#. type: Labeled list
5607#: ../disk-utils/sfdisk.8.adoc:119
5608#, no-wrap
5609msgid "*-s*, *--show-size* [__device__...]"
5610msgstr ""
5611
5612#. type: Plain text
5613#: ../disk-utils/sfdisk.8.adoc:121
5614msgid ""
5615"List the sizes of all or the specified devices in units of 1024 byte "
5616"size. This command is DEPRECATED in favour of *blockdev*(8)."
5617msgstr ""
5618
5619#. type: Labeled list
5620#: ../disk-utils/sfdisk.8.adoc:122
5621#, no-wrap
5622msgid "*-T*, *--list-types*"
5623msgstr ""
5624
5625#. type: Plain text
5626#: ../disk-utils/sfdisk.8.adoc:124
5627msgid ""
5628"Print all supported types for the current disk label or the label specified "
5629"by *--label*."
5630msgstr ""
5631
5632#. type: Labeled list
5633#: ../disk-utils/sfdisk.8.adoc:125
5634#, no-wrap
5635msgid "*-V*, *--verify* [__device__...]"
5636msgstr ""
5637
5638#. type: Plain text
5639#: ../disk-utils/sfdisk.8.adoc:127
5640msgid "Test whether the partition table and partitions seem correct."
5641msgstr ""
5642
5643#. type: Labeled list
5644#: ../disk-utils/sfdisk.8.adoc:128
5645#, no-wrap
5646msgid "*--relocate* _oper_ _device_"
5647msgstr ""
5648
5649#. type: Plain text
5650#: ../disk-utils/sfdisk.8.adoc:130
5651msgid ""
5652"Relocate partition table header. This command is currently supported for GPT "
5653"header only. The argument _oper_ can be:"
5654msgstr ""
5655
5656#. type: Labeled list
5657#: ../disk-utils/sfdisk.8.adoc:131
5658#, no-wrap
5659msgid "*gpt-bak-std*"
5660msgstr ""
5661
5662#. type: Plain text
5663#: ../disk-utils/sfdisk.8.adoc:133
5664msgid "Move GPT backup header to the standard location at the end of the device."
5665msgstr ""
5666
5667#. type: Labeled list
5668#: ../disk-utils/sfdisk.8.adoc:133
5669#, no-wrap
5670msgid "*gpt-bak-mini*"
5671msgstr ""
5672
5673#. type: Plain text
5674#: ../disk-utils/sfdisk.8.adoc:135
5675msgid ""
5676"Move GPT backup header behind the last partition. Note that UEFI standard "
5677"requires the backup header at the end of the device and partitioning tools "
5678"can automatically relocate the header to follow the standard."
5679msgstr ""
5680
5681#. type: Labeled list
5682#: ../disk-utils/sfdisk.8.adoc:138 ../term-utils/script.1.adoc:66
5683#, no-wrap
5684msgid "*-a*, *--append*"
5685msgstr ""
5686
5687#. type: Plain text
5688#: ../disk-utils/sfdisk.8.adoc:140
5689msgid ""
5690"Don't create a new partition table, but only append the specified "
5691"partitions."
5692msgstr ""
5693
5694#. type: Plain text
5695#: ../disk-utils/sfdisk.8.adoc:142
5696msgid ""
5697"Note that unused partition maybe be re-used in this case although it is not "
5698"the last partition in the partition table. See also *-N* to specify entry in "
5699"the partition table."
5700msgstr ""
5701
5702#. type: Labeled list
5703#: ../disk-utils/sfdisk.8.adoc:143 ../misc-utils/wipefs.8.adoc:43
5704#, no-wrap
5705msgid "*-b*, *--backup*"
5706msgstr ""
5707
5708#. type: Plain text
5709#: ../disk-utils/sfdisk.8.adoc:145
5710msgid ""
5711"Back up the current partition table sectors before starting the "
5712"partitioning. The default backup file name is "
5713"_~/sfdisk-<device>-<offset>.bak_; to use another name see option *-O*, "
5714"*--backup-file*."
5715msgstr ""
5716
5717#. type: Labeled list
5718#: ../disk-utils/sfdisk.8.adoc:146
5719#, no-wrap
5720msgid "*--color*[**=**__when__]"
5721msgstr ""
5722
5723#. type: Plain text
5724#: ../disk-utils/sfdisk.8.adoc:151
5725msgid "Disable all consistency checking."
5726msgstr ""
5727
5728#. type: Labeled list
5729#: ../disk-utils/sfdisk.8.adoc:152
5730#, no-wrap
5731msgid "*--Linux*"
5732msgstr ""
5733
5734#. type: Plain text
5735#: ../disk-utils/sfdisk.8.adoc:154
5736msgid ""
5737"Deprecated and ignored option. Partitioning that is compatible with Linux "
5738"(and other modern operating systems) is the default."
5739msgstr ""
5740
5741#. type: Labeled list
5742#: ../disk-utils/sfdisk.8.adoc:158 ../misc-utils/rename.1.adoc:31
5743#: ../misc-utils/wipefs.8.adoc:64
5744#, no-wrap
5745msgid "*-n*, *--no-act*"
5746msgstr ""
5747
5748#. type: Plain text
5749#: ../disk-utils/sfdisk.8.adoc:160
5750msgid "Do everything except writing to the device."
5751msgstr ""
5752
5753#. type: Labeled list
5754#: ../disk-utils/sfdisk.8.adoc:161
5755#, no-wrap
5756msgid "*--no-reread*"
5757msgstr ""
5758
5759#. type: Plain text
5760#: ../disk-utils/sfdisk.8.adoc:163
5761msgid ""
5762"Do not check through the re-read-partition-table ioctl whether the device is "
5763"in use."
5764msgstr ""
5765
5766#. type: Labeled list
5767#: ../disk-utils/sfdisk.8.adoc:164
5768#, no-wrap
5769msgid "*--no-tell-kernel*"
5770msgstr ""
5771
5772#. type: Plain text
5773#: ../disk-utils/sfdisk.8.adoc:166
5774msgid ""
5775"Don't tell the kernel about partition changes. This option is recommended "
5776"together with *--no-reread* to modify a partition on used disk. The modified "
5777"partition should not be used (e.g., mounted)."
5778msgstr ""
5779
5780#. type: Labeled list
5781#: ../disk-utils/sfdisk.8.adoc:167
5782#, no-wrap
5783msgid "*-O*, *--backup-file* _path_"
5784msgstr ""
5785
5786#. type: Plain text
5787#: ../disk-utils/sfdisk.8.adoc:169
5788msgid ""
5789"Override the default backup file name. Note that the device name and offset "
5790"are always appended to the file name."
5791msgstr ""
5792
5793#. type: Labeled list
5794#: ../disk-utils/sfdisk.8.adoc:170
5795#, no-wrap
5796msgid "*--move-data*[**=**__path__]"
5797msgstr ""
5798
5799#. type: Plain text
5800#: ../disk-utils/sfdisk.8.adoc:172
5801msgid ""
5802"Move data after partition relocation, for example when moving the beginning "
5803"of a partition to another place on the disk. The size of the partition has "
5804"to remain the same, the new and old location may overlap. This option "
5805"requires option *-N* in order to be processed on one specific partition "
5806"only."
5807msgstr ""
5808
5809#. type: Plain text
5810#: ../disk-utils/sfdisk.8.adoc:174
5811msgid ""
5812"The optional _path_ specifies log file name. The log file contains "
5813"information about all read/write operations on the partition data. The word "
5814"\"@default\" as a _path_ forces sfdisk to use _~/sfdisk-<devname>.move_ for "
5815"the log. The log is optional since v2.35."
5816msgstr ""
5817
5818#. type: Plain text
5819#: ../disk-utils/sfdisk.8.adoc:176
5820msgid ""
5821"Note that this operation is risky and not atomic. *Don't forget to backup "
5822"your data!*"
5823msgstr ""
5824
5825#. type: Plain text
5826#: ../disk-utils/sfdisk.8.adoc:178
5827msgid "See also *--move-use-fsync*."
5828msgstr ""
5829
5830#. type: Plain text
5831#: ../disk-utils/sfdisk.8.adoc:180
5832msgid ""
5833"In the example below, the first command creates a 100MiB free area before "
5834"the first partition and moves the data it contains (e.g., a filesystem), the "
5835"next command creates a new partition from the free space (at offset 2048), "
5836"and the last command reorders partitions to match disk order (the original "
5837"sdc1 will become sdc2)."
5838msgstr ""
5839
5840#. type: Plain text
5841#: ../disk-utils/sfdisk.8.adoc:182
5842#, no-wrap
5843msgid ""
5844"*echo '+100M,' | sfdisk --move-data /dev/sdc -N 1* *echo '2048,' | sfdisk "
5845"/dev/sdc --append* *sfdisk /dev/sdc --reorder*\n"
5846msgstr ""
5847
5848#. type: Labeled list
5849#: ../disk-utils/sfdisk.8.adoc:183
5850#, no-wrap
5851msgid "*--move-use-fsync*"
5852msgstr ""
5853
5854#. type: Plain text
5855#: ../disk-utils/sfdisk.8.adoc:185
5856msgid ""
5857"Use the *fsync*(2) system call after each write when moving data to a new "
5858"location by *--move-data*."
5859msgstr ""
5860
5861#. TRANSLATORS: Keep {plus} untranslated.
5862#. type: Plain text
5863#: ../disk-utils/sfdisk.8.adoc:191
5864msgid ""
5865"The default list of columns may be extended if _list_ is specified in the "
5866"format _{plus}list_ (e.g., *-o +UUID*)."
5867msgstr ""
5868
5869#. type: Labeled list
5870#: ../disk-utils/sfdisk.8.adoc:192 ../misc-utils/getopt.1.adoc:48
5871#: ../misc-utils/hardlink.1.adoc:35 ../misc-utils/uuidd.8.adoc:46
5872#: ../misc-utils/wipefs.8.adoc:75 ../sys-utils/mountpoint.1.adoc:28
5873#: ../sys-utils/umount.8.adoc:99 ../term-utils/script.1.adoc:116
5874#, no-wrap
5875msgid "*-q*, *--quiet*"
5876msgstr ""
5877
5878#. type: Plain text
5879#: ../disk-utils/sfdisk.8.adoc:194
5880msgid "Suppress extra info messages."
5881msgstr ""
5882
5883#. type: Labeled list
5884#: ../disk-utils/sfdisk.8.adoc:195
5885#, no-wrap
5886msgid "*-u*, *--unit S*"
5887msgstr ""
5888
5889#. type: Plain text
5890#: ../disk-utils/sfdisk.8.adoc:197
5891msgid ""
5892"Deprecated option. Only the sector unit is supported. This option is not "
5893"supported when using the *--show-size* command."
5894msgstr ""
5895
5896#. type: Labeled list
5897#: ../disk-utils/sfdisk.8.adoc:198
5898#, no-wrap
5899msgid "*-X*, *--label* _type_"
5900msgstr ""
5901
5902#. type: Plain text
5903#: ../disk-utils/sfdisk.8.adoc:200
5904msgid ""
5905"Specify the disk label type (e.g., *dos*, *gpt*, ...). If this option is not "
5906"given, then *sfdisk* defaults to the existing label, but if there is no "
5907"label on the device yet, then the type defaults to *dos*. The default or the "
5908"current label may be overwritten by the \"label: <name>\" script header "
5909"line. The option *--label* does not force *sfdisk* to create empty disk "
5910"label (see the *EMPTY DISK LABEL* section below)."
5911msgstr ""
5912
5913#. type: Labeled list
5914#: ../disk-utils/sfdisk.8.adoc:201
5915#, no-wrap
5916msgid "*-Y*, *--label-nested* _type_"
5917msgstr ""
5918
5919#. type: Plain text
5920#: ../disk-utils/sfdisk.8.adoc:203
5921msgid ""
5922"Force editing of a nested disk label. The primary disk label has to exist "
5923"already. This option allows editing for example a hybrid/protective MBR on "
5924"devices with GPT."
5925msgstr ""
5926
5927#. type: Plain text
5928#: ../disk-utils/sfdisk.8.adoc:206
5929msgid ""
5930"Wipe filesystem, RAID and partition-table signatures from the device, in "
5931"order to avoid possible collisions. The argument _when_ can be *auto*, "
5932"*never* or *always*. When this option is not given, the default is *auto*, "
5933"in which case signatures are wiped only when in interactive mode; except the "
5934"old partition-table signatures which are always wiped before create a new "
5935"partition-table if the argument _when_ is not *never*. The *auto* mode also "
5936"does not wipe the first sector (boot sector), it is necessary to use the "
5937"*always* mode to wipe this area. In all cases detected signatures are "
5938"reported by warning messages before a new partition table is created. See "
5939"also the *wipefs*(8) command."
5940msgstr ""
5941
5942#. type: Plain text
5943#: ../disk-utils/sfdisk.8.adoc:209
5944msgid ""
5945"Wipe filesystem, RAID and partition-table signatures from a newly created "
5946"partitions, in order to avoid possible collisions. The argument _when_ can "
5947"be *auto*, *never* or *always*. When this option is not given, the default "
5948"is *auto*, in which case signatures are wiped only when in interactive mode "
5949"and after confirmation by user. In all cases detected signatures are "
5950"reported by warning messages after a new partition is created. See also "
5951"*wipefs*(8) command."
5952msgstr ""
5953
5954#. type: Labeled list
5955#: ../disk-utils/sfdisk.8.adoc:210 ../login-utils/chfn.1.adoc:52
5956#: ../login-utils/chsh.1.adoc:42
5957#, no-wrap
5958msgid "*-v*, *--version*"
5959msgstr ""
5960
5961#. type: Title ==
5962#: ../disk-utils/sfdisk.8.adoc:216
5963#, no-wrap
5964msgid "INPUT FORMATS"
5965msgstr ""
5966
5967#. type: Plain text
5968#: ../disk-utils/sfdisk.8.adoc:219
5969#, no-wrap
5970msgid "*sfdisk* supports two input formats and generic header lines.\n"
5971msgstr ""
5972
5973#. type: Title ===
5974#: ../disk-utils/sfdisk.8.adoc:220
5975#, no-wrap
5976msgid "Header lines"
5977msgstr ""
5978
5979#. type: Plain text
5980#: ../disk-utils/sfdisk.8.adoc:223
5981msgid ""
5982"The optional header lines specify generic information that apply to the "
5983"partition table. The header-line format is:"
5984msgstr ""
5985
5986#. type: Plain text
5987#: ../disk-utils/sfdisk.8.adoc:225
5988#, no-wrap
5989msgid "*<name>: <value>*\n"
5990msgstr ""
5991
5992#. type: Plain text
5993#: ../disk-utils/sfdisk.8.adoc:227
5994msgid "The currently recognized headers are:"
5995msgstr ""
5996
5997#. type: Labeled list
5998#: ../disk-utils/sfdisk.8.adoc:228
5999#, no-wrap
6000msgid "*unit*"
6001msgstr ""
6002
6003#. type: Plain text
6004#: ../disk-utils/sfdisk.8.adoc:230
6005msgid "Specify the partitioning unit. The only supported unit is *sectors*."
6006msgstr ""
6007
6008#. type: Labeled list
6009#: ../disk-utils/sfdisk.8.adoc:230
6010#, no-wrap
6011msgid "*label*"
6012msgstr ""
6013
6014#. type: Plain text
6015#: ../disk-utils/sfdisk.8.adoc:232
6016msgid "Specify the partition table type. For example *dos* or *gpt*."
6017msgstr ""
6018
6019#. type: Labeled list
6020#: ../disk-utils/sfdisk.8.adoc:232
6021#, no-wrap
6022msgid "*label-id*"
6023msgstr ""
6024
6025#. type: Plain text
6026#: ../disk-utils/sfdisk.8.adoc:234
6027msgid ""
6028"Specify the partition table identifier. It should be a hexadecimal number "
6029"(with a 0x prefix) for MBR and a UUID for GPT."
6030msgstr ""
6031
6032#. type: Labeled list
6033#: ../disk-utils/sfdisk.8.adoc:234
6034#, no-wrap
6035msgid "*first-lba*"
6036msgstr ""
6037
6038#. type: Plain text
6039#: ../disk-utils/sfdisk.8.adoc:236
6040msgid "Specify the first usable sector for GPT partitions."
6041msgstr ""
6042
6043#. type: Labeled list
6044#: ../disk-utils/sfdisk.8.adoc:236
6045#, no-wrap
6046msgid "*last-lba*"
6047msgstr ""
6048
6049#. type: Plain text
6050#: ../disk-utils/sfdisk.8.adoc:238
6051msgid "Specify the last usable sector for GPT partitions."
6052msgstr ""
6053
6054#. type: Labeled list
6055#: ../disk-utils/sfdisk.8.adoc:238
6056#, no-wrap
6057msgid "*table-length*"
6058msgstr ""
6059
6060#. type: Plain text
6061#: ../disk-utils/sfdisk.8.adoc:240
6062msgid "Specify the maximal number of GPT partitions."
6063msgstr ""
6064
6065#. type: Labeled list
6066#: ../disk-utils/sfdisk.8.adoc:240
6067#, no-wrap
6068msgid "*grain*"
6069msgstr ""
6070
6071#. type: Plain text
6072#: ../disk-utils/sfdisk.8.adoc:242
6073msgid ""
6074"Specify minimal size in bytes used to calculate partitions alignment. The "
6075"default is 1MiB and it's strongly recommended to use the default. Do not "
6076"modify this variable if you're not sure."
6077msgstr ""
6078
6079#. type: Labeled list
6080#: ../disk-utils/sfdisk.8.adoc:242
6081#, no-wrap
6082msgid "*sector-size*"
6083msgstr ""
6084
6085#. type: Plain text
6086#: ../disk-utils/sfdisk.8.adoc:244
6087msgid ""
6088"Specify sector size. This header is informative only and it is not used when "
6089"sfdisk creates a new partition table, in this case the real device specific "
6090"value is always used and sector size from the dump is ignored."
6091msgstr ""
6092
6093#. type: Plain text
6094#: ../disk-utils/sfdisk.8.adoc:246
6095msgid ""
6096"Note that it is only possible to use header lines before the first partition "
6097"is specified in the input."
6098msgstr ""
6099
6100#. type: Title ===
6101#: ../disk-utils/sfdisk.8.adoc:247
6102#, no-wrap
6103msgid "Unnamed-fields format"
6104msgstr ""
6105
6106#. type: delimited block _
6107#: ../disk-utils/sfdisk.8.adoc:251
6108msgid "_start size type bootable_"
6109msgstr ""
6110
6111#. type: Plain text
6112#: ../disk-utils/sfdisk.8.adoc:254
6113msgid "where each line fills one partition descriptor."
6114msgstr ""
6115
6116#. type: Plain text
6117#: ../disk-utils/sfdisk.8.adoc:256
6118msgid ""
6119"Fields are separated by whitespace, comma or semicolon possibly followed by "
6120"whitespace; initial and trailing whitespace is ignored. Numbers can be "
6121"octal, decimal or hexadecimal; decimal is the default. When a field is "
6122"absent, empty or specified as '-' a default value is used. But when the *-N* "
6123"option (change a single partition) is given, the default for each field is "
6124"its previous value."
6125msgstr ""
6126
6127#. type: Plain text
6128#: ../disk-utils/sfdisk.8.adoc:258
6129msgid ""
6130"The default value of _start_ is the first non-assigned sector aligned "
6131"according to device I/O limits. The default start offset for the first "
6132"partition is 1 MiB. The offset may be followed by the multiplicative "
6133"suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB) then the number is "
6134"interpreted as offset in bytes."
6135msgstr ""
6136
6137#. TRANSLATORS: Keep {plus} untranslated.
6138#. type: Plain text
6139#: ../disk-utils/sfdisk.8.adoc:261
6140msgid ""
6141"The default value of _size_ indicates \"as much as possible\"; i.e., until "
6142"the next partition or end-of-device. A numerical argument is by default "
6143"interpreted as a number of sectors, however if the size is followed by one "
6144"of the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB) "
6145"then the number is interpreted as the size of the partition in bytes and it "
6146"is then aligned according to the device I/O limits. A '{plus}' can be used "
6147"instead of a number to enlarge the partition as much as possible. Note "
6148"'{plus}' is equivalent to the default behaviour for a new partition; "
6149"existing partitions will be resized as required."
6150msgstr ""
6151
6152#. type: Plain text
6153#: ../disk-utils/sfdisk.8.adoc:263
6154msgid ""
6155"The partition _type_ is given in hex for MBR (DOS) where 0x prefix is "
6156"optional; a GUID string for GPT; a shortcut or an alias. It's recommended to "
6157"use two letters for MBR hex codes to avoid collision between deprecated "
6158"shortcut 'E' and '0E' MBR hex code. For backward compatibility *sfdisk* "
6159"tries to interpret _type_ as a shortcut as a first possibility in "
6160"partitioning scripts although on other places (e.g. *--part-type* command) "
6161"it tries shortcuts as the last possibility."
6162msgstr ""
6163
6164#. type: Plain text
6165#: ../disk-utils/sfdisk.8.adoc:265
6166msgid ""
6167"Since v2.36 libfdisk supports partition type aliases as extension to "
6168"shortcuts. The alias is a simple human readable word (e.g. \"linux\")."
6169msgstr ""
6170
6171#. type: Plain text
6172#: ../disk-utils/sfdisk.8.adoc:267
6173msgid ""
6174"Since v2.37 libfdisk supports partition type names on input, ignoring the "
6175"case of the characters and all non-alphanumeric and non-digit characters in "
6176"the name (e.g. \"Linux /usr x86\" is the same as \"linux usr-x86\")."
6177msgstr ""
6178
6179#. type: Plain text
6180#: ../disk-utils/sfdisk.8.adoc:269
6181msgid "Supported shortcuts and aliases:"
6182msgstr ""
6183
6184#. type: Labeled list
6185#: ../disk-utils/sfdisk.8.adoc:270
6186#, no-wrap
6187msgid "*L - alias 'linux'*"
6188msgstr ""
6189
6190#. type: Plain text
6191#: ../disk-utils/sfdisk.8.adoc:272
6192msgid "Linux; means 83 for MBR and 0FC63DAF-8483-4772-8E79-3D69D8477DE4 for GPT."
6193msgstr ""
6194
6195#. type: Labeled list
6196#: ../disk-utils/sfdisk.8.adoc:273
6197#, no-wrap
6198msgid "*S - alias 'swap'*"
6199msgstr ""
6200
6201#. type: Plain text
6202#: ../disk-utils/sfdisk.8.adoc:275
6203msgid "swap area; means 82 for MBR and 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F for GPT"
6204msgstr ""
6205
6206#. type: Labeled list
6207#: ../disk-utils/sfdisk.8.adoc:276
6208#, no-wrap
6209msgid "*Ex - alias 'extended'*"
6210msgstr ""
6211
6212#. type: Plain text
6213#: ../disk-utils/sfdisk.8.adoc:278
6214msgid ""
6215"MBR extended partition; means 05 for MBR. The original shortcut 'E' is "
6216"deprecated due to collision with 0x0E MBR partition type."
6217msgstr ""
6218
6219#. type: Labeled list
6220#: ../disk-utils/sfdisk.8.adoc:279
6221#, no-wrap
6222msgid "*H - alias 'home'*"
6223msgstr ""
6224
6225#. type: Plain text
6226#: ../disk-utils/sfdisk.8.adoc:281
6227msgid "home partition; means 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 for GPT"
6228msgstr ""
6229
6230#. type: Labeled list
6231#: ../disk-utils/sfdisk.8.adoc:282
6232#, no-wrap
6233msgid "*U - alias 'uefi'*"
6234msgstr ""
6235
6236#. type: Plain text
6237#: ../disk-utils/sfdisk.8.adoc:284
6238msgid ""
6239"EFI System partition, means EF for MBR and "
6240"C12A7328-F81F-11D2-BA4B-00A0C93EC93B for GPT"
6241msgstr ""
6242
6243#. type: Labeled list
6244#: ../disk-utils/sfdisk.8.adoc:285
6245#, no-wrap
6246msgid "*R - alias 'raid'*"
6247msgstr ""
6248
6249#. type: Plain text
6250#: ../disk-utils/sfdisk.8.adoc:287
6251msgid ""
6252"Linux RAID; means FD for MBR and A19D880F-05FC-4D3B-A006-743F0F84911E for "
6253"GPT"
6254msgstr ""
6255
6256#. type: Labeled list
6257#: ../disk-utils/sfdisk.8.adoc:288
6258#, no-wrap
6259msgid "*V - alias 'lvm'*"
6260msgstr ""
6261
6262#. type: Plain text
6263#: ../disk-utils/sfdisk.8.adoc:290
6264msgid "LVM; means 8E for MBR and E6D6D379-F507-44C2-A23C-238F2A3DF928 for GPT"
6265msgstr ""
6266
6267#. type: Plain text
6268#: ../disk-utils/sfdisk.8.adoc:292
6269msgid "The default _type_ value is _linux_."
6270msgstr ""
6271
6272#. type: Plain text
6273#: ../disk-utils/sfdisk.8.adoc:294
6274msgid ""
6275"The shortcut 'X' for Linux extended partition (85) is deprecated in favour "
6276"of 'Ex'."
6277msgstr ""
6278
6279#. TRANSLATORS: Keep {asterisk} untranslated.
6280#. type: Plain text
6281#: ../disk-utils/sfdisk.8.adoc:297
6282msgid ""
6283"_bootable_ is specified as [*{asterisk}*|*-*], with as default "
6284"not-bootable. The value of this field is irrelevant for Linux - when Linux "
6285"runs it has been booted already - but it might play a role for certain boot "
6286"loaders and for other operating systems."
6287msgstr ""
6288
6289#. type: Title ===
6290#: ../disk-utils/sfdisk.8.adoc:298
6291#, no-wrap
6292msgid "Named-fields format"
6293msgstr ""
6294
6295#. type: Plain text
6296#: ../disk-utils/sfdisk.8.adoc:301
6297msgid ""
6298"This format is more readable, robust, extensible and allows specifying "
6299"additional information (e.g., a UUID). It is recommended to use this format "
6300"to keep your scripts more readable."
6301msgstr ""
6302
6303#. type: delimited block _
6304#: ../disk-utils/sfdisk.8.adoc:304
6305msgid "[_device_ *:*] _name_[**=**__value__], ..."
6306msgstr ""
6307
6308#. type: Plain text
6309#: ../disk-utils/sfdisk.8.adoc:307
6310msgid ""
6311"The _device_ field is optional. *sfdisk* extracts the partition number from "
6312"the device name. It allows specifying the partitions in random order. This "
6313"functionality is mostly used by *--dump*. Don't use it if you are not sure."
6314msgstr ""
6315
6316#. type: Plain text
6317#: ../disk-utils/sfdisk.8.adoc:309
6318msgid ""
6319"The _value_ can be between quotation marks (e.g., name=\"This is partition "
6320"name\"). The currently supported fields are:"
6321msgstr ""
6322
6323#. type: Labeled list
6324#: ../disk-utils/sfdisk.8.adoc:310
6325#, no-wrap
6326msgid "**start=**__number__"
6327msgstr ""
6328
6329#. type: Plain text
6330#: ../disk-utils/sfdisk.8.adoc:312
6331msgid ""
6332"The first non-assigned sector aligned according to device I/O limits. The "
6333"default start offset for the first partition is 1 MiB. The offset may be "
6334"followed by the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB "
6335"and YiB) then the number is interpreted as offset in bytes."
6336msgstr ""
6337
6338#. type: Labeled list
6339#: ../disk-utils/sfdisk.8.adoc:313
6340#, no-wrap
6341msgid "**size=**__number__"
6342msgstr ""
6343
6344#. type: Plain text
6345#: ../disk-utils/sfdisk.8.adoc:315
6346msgid ""
6347"Specify the partition size in sectors. The number may be followed by the "
6348"multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, EiB, ZiB and YiB), then "
6349"it's interpreted as size in bytes and the size is aligned according to "
6350"device I/O limits."
6351msgstr ""
6352
6353#. type: Labeled list
6354#: ../disk-utils/sfdisk.8.adoc:316
6355#, no-wrap
6356msgid "*bootable*"
6357msgstr ""
6358
6359#. type: Plain text
6360#: ../disk-utils/sfdisk.8.adoc:318
6361msgid "Mark the partition as bootable."
6362msgstr ""
6363
6364#. type: Labeled list
6365#: ../disk-utils/sfdisk.8.adoc:319
6366#, no-wrap
6367msgid "**attrs=**__string__"
6368msgstr ""
6369
6370#. type: Plain text
6371#: ../disk-utils/sfdisk.8.adoc:321
6372msgid ""
6373"Partition attributes, usually GPT partition attribute bits. See "
6374"*--part-attrs* for more details about the GPT-bits string format."
6375msgstr ""
6376
6377#. type: Labeled list
6378#: ../disk-utils/sfdisk.8.adoc:322
6379#, no-wrap
6380msgid "**uuid=**__string__"
6381msgstr ""
6382
6383#. type: Plain text
6384#: ../disk-utils/sfdisk.8.adoc:324
6385msgid "GPT partition UUID."
6386msgstr ""
6387
6388#. type: Labeled list
6389#: ../disk-utils/sfdisk.8.adoc:325
6390#, no-wrap
6391msgid "**name=**__string__"
6392msgstr ""
6393
6394#. type: Plain text
6395#: ../disk-utils/sfdisk.8.adoc:327
6396msgid "GPT partition name."
6397msgstr ""
6398
6399#. type: Labeled list
6400#: ../disk-utils/sfdisk.8.adoc:328
6401#, no-wrap
6402msgid "**type=**__code__"
6403msgstr ""
6404
6405#. type: Plain text
6406#: ../disk-utils/sfdisk.8.adoc:330
6407msgid ""
6408"A hexadecimal number (without 0x) for an MBR partition, a GUID for a GPT "
6409"partition, a shortcut as for unnamed-fields format or a type name "
6410"(e.g. type=\"Linux /usr (x86)\"). See above the section about the "
6411"unnamed-fields format for more details. For backward compatibility the *Id=* "
6412"field has the same meaning."
6413msgstr ""
6414
6415#. type: Title ==
6416#: ../disk-utils/sfdisk.8.adoc:331
6417#, no-wrap
6418msgid "EMPTY DISK LABEL"
6419msgstr ""
6420
6421#. type: Plain text
6422#: ../disk-utils/sfdisk.8.adoc:334
6423#, no-wrap
6424msgid ""
6425"*sfdisk* does not create partition table without partitions by default. The "
6426"lines with partitions are expected in the script by default. The empty "
6427"partition table has to be explicitly requested by \"label: <name>\" script "
6428"header line without any partitions lines. For example:\n"
6429msgstr ""
6430
6431#. type: delimited block _
6432#: ../disk-utils/sfdisk.8.adoc:337
6433#, no-wrap
6434msgid "*echo 'label: gpt' | sfdisk /dev/sdb*\n"
6435msgstr ""
6436
6437#. type: Plain text
6438#: ../disk-utils/sfdisk.8.adoc:340
6439msgid ""
6440"creates empty GPT partition table. Note that the *--append* disables this "
6441"feature."
6442msgstr ""
6443
6444#. type: Title ==
6445#: ../disk-utils/sfdisk.8.adoc:341
6446#, no-wrap
6447msgid "BACKING UP THE PARTITION TABLE"
6448msgstr ""
6449
6450#. type: Plain text
6451#: ../disk-utils/sfdisk.8.adoc:344
6452msgid ""
6453"It is recommended to save the layout of your devices. *sfdisk* supports two "
6454"ways."
6455msgstr ""
6456
6457#. type: Plain text
6458#: ../disk-utils/sfdisk.8.adoc:346
6459msgid ""
6460"Use the *--dump* option to save a description of the device layout to a text "
6461"file. The dump format is suitable for later *sfdisk* input. For example:"
6462msgstr ""
6463
6464#. type: delimited block _
6465#: ../disk-utils/sfdisk.8.adoc:349
6466#, no-wrap
6467msgid "*sfdisk --dump /dev/sda > sda.dump*\n"
6468msgstr ""
6469
6470#. type: Plain text
6471#: ../disk-utils/sfdisk.8.adoc:352
6472msgid "This can later be restored by:"
6473msgstr ""
6474
6475#. type: delimited block _
6476#: ../disk-utils/sfdisk.8.adoc:355
6477#, no-wrap
6478msgid "*sfdisk /dev/sda < sda.dump*\n"
6479msgstr ""
6480
6481#. type: Plain text
6482#: ../disk-utils/sfdisk.8.adoc:358
6483msgid ""
6484"If you want to do a full (binary) backup of all sectors where the partition "
6485"table is stored, then use the *--backup* option. It writes the sectors to "
6486"_~/sfdisk-<device>-<offset>.bak_ files. The default name of the backup file "
6487"can be changed with the *--backup-file* option. The backup files contain "
6488"only raw data from the _device_. Note that the same concept of backup files "
6489"is used by *wipefs*(8). For example:"
6490msgstr ""
6491
6492#. type: delimited block _
6493#: ../disk-utils/sfdisk.8.adoc:361
6494#, no-wrap
6495msgid "*sfdisk --backup /dev/sda*\n"
6496msgstr ""
6497
6498#. type: Plain text
6499#: ../disk-utils/sfdisk.8.adoc:364
6500msgid "The GPT header can later be restored by:"
6501msgstr ""
6502
6503#. type: delimited block _
6504#: ../disk-utils/sfdisk.8.adoc:368
6505#, no-wrap
6506msgid ""
6507"dd if=~/sfdisk-sda-0x00000200.bak of=/dev/sda \\\n"
6508" seek=$((0x00000200)) bs=1 conv=notrunc\n"
6509msgstr ""
6510
6511#. type: Plain text
6512#: ../disk-utils/sfdisk.8.adoc:371
6513msgid ""
6514"Note that *sfdisk* since version 2.26 no longer provides the *-I* option to "
6515"restore sectors. *dd*(1) provides all necessary functionality."
6516msgstr ""
6517
6518#. type: Plain text
6519#: ../disk-utils/sfdisk.8.adoc:375
6520msgid ""
6521"Implicit coloring can be disabled by an empty file "
6522"_/etc/terminal-colors.d/sfdisk.disable_."
6523msgstr ""
6524
6525#. type: Plain text
6526#: ../disk-utils/sfdisk.8.adoc:377
6527msgid ""
6528"See *terminal-colors.d*(5) for more details about colorization "
6529"configuration. The logical color names supported by *sfdisk* are:"
6530msgstr ""
6531
6532#. type: Labeled list
6533#: ../disk-utils/sfdisk.8.adoc:387
6534#, no-wrap
6535msgid "SFDISK_DEBUG=all"
6536msgstr ""
6537
6538#. type: Plain text
6539#: ../disk-utils/sfdisk.8.adoc:389
6540msgid "enables *sfdisk* debug output."
6541msgstr ""
6542
6543#. type: Labeled list
6544#: ../disk-utils/sfdisk.8.adoc:389
6545#, no-wrap
6546msgid "LIBFDISK_DEBUG=all"
6547msgstr ""
6548
6549#. type: Labeled list
2bee5365 6550#: ../disk-utils/sfdisk.8.adoc:393 ../misc-utils/findmnt.8.adoc:183
36e96905
MB
6551#: ../misc-utils/lsblk.8.adoc:149
6552#, no-wrap
6553msgid "LIBSMARTCOLS_DEBUG=all"
6554msgstr ""
6555
6556#. type: Plain text
6557#: ../disk-utils/sfdisk.8.adoc:401
6558msgid ""
6559"Since version 2.26 *sfdisk* no longer provides the *-R* or *--re-read* "
6560"option to force the kernel to reread the partition table. Use *blockdev "
6561"--rereadpt* instead."
6562msgstr ""
6563
6564#. type: Plain text
6565#: ../disk-utils/sfdisk.8.adoc:403
6566msgid ""
6567"Since version 2.26 *sfdisk* does not provide the *--DOS*, *--IBM*, "
6568"*--DOS-extended*, *--unhide*, *--show-extended*, *--cylinders*, *--heads*, "
6569"*--sectors*, *--inside-outer*, *--not-inside-outer* options."
6570msgstr ""
6571
6572#. type: Plain text
6573#: ../disk-utils/sfdisk.8.adoc:409
6574msgid ""
6575"The current *sfdisk* implementation is based on the original *sfdisk* from "
6576"Andries E. Brouwer."
6577msgstr ""
6578
6579#. type: Plain text
6580#: ../disk-utils/sfdisk.8.adoc:417
6581#, no-wrap
6582msgid ""
6583"*fdisk*(8),\n"
6584"*cfdisk*(8),\n"
6585"*parted*(8),\n"
6586"*partprobe*(8),\n"
6587"*partx*(8)\n"
6588msgstr ""
6589
6590#. Copyright 2010 Jason Borden <jborden@bluehost.com>
6591#. This file may be copied under the terms of the GNU Public License.
6592#. type: Title =
6593#: ../disk-utils/swaplabel.8.adoc:6
6594#, no-wrap
6595msgid "swaplabel(8)"
6596msgstr ""
6597
6598#. type: Plain text
6599#: ../disk-utils/swaplabel.8.adoc:16
6600msgid "swaplabel - print or change the label or UUID of a swap area"
6601msgstr ""
6602
6603#. type: Plain text
6604#: ../disk-utils/swaplabel.8.adoc:20
6605#, no-wrap
6606msgid "*swaplabel* [*-L* _label_] [*-U* _UUID_] _device_\n"
6607msgstr ""
6608
6609#. type: Plain text
6610#: ../disk-utils/swaplabel.8.adoc:24
6611#, no-wrap
6612msgid ""
6613"*swaplabel* will display or change the label or UUID of a swap partition "
6614"located on _device_ (or regular file).\n"
6615msgstr ""
6616
6617#. type: Plain text
6618#: ../disk-utils/swaplabel.8.adoc:26
6619msgid ""
6620"If the optional arguments *-L* and *-U* are not given, *swaplabel* will "
6621"simply display the current swap-area label and UUID of _device_."
6622msgstr ""
6623
6624#. type: Plain text
6625#: ../disk-utils/swaplabel.8.adoc:28
6626msgid ""
6627"If an optional argument is present, then *swaplabel* will change the "
6628"appropriate value on _device_. These values can also be set during swap "
6629"creation using *mkswap*(8). The *swaplabel* utility allows changing the "
6630"label or UUID on an actively used swap device."
6631msgstr ""
6632
6633#. type: Plain text
6634#: ../disk-utils/swaplabel.8.adoc:36
6635msgid ""
6636"Specify a new _label_ for the device. Swap partition labels can be at most "
6637"16 characters long. If _label_ is longer than 16 characters, *swaplabel* "
6638"will truncate it and print a warning message."
6639msgstr ""
6640
6641#. type: Plain text
6642#: ../disk-utils/swaplabel.8.adoc:39
6643msgid ""
6644"Specify a new _UUID_ for the device. The _UUID_ must be in the standard "
6645"8-4-4-4-12 character format, such as is output by *uuidgen*(1)."
6646msgstr ""
6647
6648#. type: Plain text
6649#: ../disk-utils/swaplabel.8.adoc:48
6650#, no-wrap
6651msgid ""
6652"*swaplabel* was written by mailto:jborden@bluehost.com[Jason Borden] and "
6653"mailto:kzak@redhat.com[Karel Zak].\n"
6654msgstr ""
6655
6656#. type: Plain text
6657#: ../disk-utils/swaplabel.8.adoc:54
6658#, no-wrap
6659msgid ""
6660"*uuidgen*(1),\n"
6661"*mkswap*(8),\n"
6662"*swapon*(8)\n"
6663msgstr ""
6664
6665#. terminal-colors.d.5 --
6666#. Copyright 2014 Ondrej Oprala <ooprala@redhat.com>
6667#. Copyright (C) 2014 Karel Zak <kzak@redhat.com>
6668#. Copyright 2014 Red Hat, Inc.
6669#. May be distributed under the GNU General Public License
6670#. type: Title =
6671#: ../lib/terminal-colors.d.5.adoc:10
6672#, no-wrap
6673msgid "terminal-colors.d(5)"
6674msgstr ""
6675
6676#. type: Attribute :man manual:
6677#: ../lib/terminal-colors.d.5.adoc:12 ../login-utils/utmpdump.1.adoc:65
6678#: ../sys-utils/adjtime_config.5.adoc:4 ../sys-utils/fstab.5.adoc:38
6679#, no-wrap
6680msgid "File formats"
6681msgstr ""
6682
6683#. type: Plain text
6684#: ../lib/terminal-colors.d.5.adoc:20
6685msgid "terminal-colors.d - configure output colorization for various utilities"
6686msgstr ""
6687
6688#. type: Plain text
6689#: ../lib/terminal-colors.d.5.adoc:24
6690msgid "/etc/terminal-colors.d/_[[name][@term].][type]_"
6691msgstr ""
6692
6693#. type: Plain text
6694#: ../lib/terminal-colors.d.5.adoc:28
6695msgid ""
6696"Files in this directory determine the default behavior for utilities when "
6697"coloring output."
6698msgstr ""
6699
6700#. type: Plain text
6701#: ../lib/terminal-colors.d.5.adoc:30
6702msgid ""
6703"The _name_ is a utility name. The name is optional and when none is "
6704"specified then the file is used for all unspecified utilities."
6705msgstr ""
6706
6707#. type: Plain text
6708#: ../lib/terminal-colors.d.5.adoc:32
6709msgid ""
6710"The _term_ is a terminal identifier (the TERM environment variable). The "
6711"terminal identifier is optional and when none is specified then the file is "
6712"used for all unspecified terminals."
6713msgstr ""
6714
6715#. type: Plain text
6716#: ../lib/terminal-colors.d.5.adoc:34
6717msgid "The _type_ is a file type. Supported file types are:"
6718msgstr ""
6719
6720#. type: Labeled list
6721#: ../lib/terminal-colors.d.5.adoc:35 ../sys-utils/rtcwake.8.adoc:87
6722#, no-wrap
6723msgid "*disable*"
6724msgstr ""
6725
6726#. type: Plain text
6727#: ../lib/terminal-colors.d.5.adoc:37
6728msgid "Turns off output colorization for all compatible utilities."
6729msgstr ""
6730
6731#. type: Labeled list
6732#: ../lib/terminal-colors.d.5.adoc:38
6733#, no-wrap
6734msgid "*enable*"
6735msgstr ""
6736
6737#. type: Plain text
6738#: ../lib/terminal-colors.d.5.adoc:40
6739msgid "Turns on output colorization; any matching *disable* files are ignored."
6740msgstr ""
6741
6742#. type: Labeled list
6743#: ../lib/terminal-colors.d.5.adoc:41
6744#, no-wrap
6745msgid "*scheme*"
6746msgstr ""
6747
6748#. type: Plain text
6749#: ../lib/terminal-colors.d.5.adoc:43
6750msgid ""
6751"Specifies colors used for output. The file format may be specific to the "
6752"utility, the default format is described below."
6753msgstr ""
6754
6755#. type: Plain text
6756#: ../lib/terminal-colors.d.5.adoc:45
6757msgid ""
6758"If there are more files that match for a utility, then the file with the "
6759"more specific filename wins. For example, the filename \"@xterm.scheme\" has "
6760"less priority than \"dmesg@xterm.scheme\". The lowest priority are those "
6761"files without a utility name and terminal identifier (e.g., \"disable\")."
6762msgstr ""
6763
6764#. type: Plain text
6765#: ../lib/terminal-colors.d.5.adoc:47
6766msgid ""
6767"The user-specific _$XDG_CONFIG_HOME/terminal-colors.d_ or "
6768"_$HOME/.config/terminal-colors.d_ overrides the global setting."
6769msgstr ""
6770
6771#. type: Title ==
6772#: ../lib/terminal-colors.d.5.adoc:48
6773#, no-wrap
6774msgid "DEFAULT SCHEME FILES FORMAT"
6775msgstr ""
6776
6777#. type: Plain text
6778#: ../lib/terminal-colors.d.5.adoc:51
6779msgid "The following statement is recognized:"
6780msgstr ""
6781
6782#. type: delimited block _
6783#: ../lib/terminal-colors.d.5.adoc:54
6784#, no-wrap
6785msgid "*name color-sequence*\n"
6786msgstr ""
6787
6788#. type: Plain text
6789#: ../lib/terminal-colors.d.5.adoc:57
6790msgid ""
6791"The *name* is a logical name of color sequence (for example \"error\"). The "
6792"names are specific to the utilities. For more details always see the COLORS "
6793"section in the man page for the utility."
6794msgstr ""
6795
6796#. type: Plain text
6797#: ../lib/terminal-colors.d.5.adoc:59
6798msgid ""
6799"The *color-sequence* is a color name, ASCII color sequences or escape "
6800"sequences."
6801msgstr ""
6802
6803#. type: Title ===
6804#: ../lib/terminal-colors.d.5.adoc:60
6805#, no-wrap
6806msgid "Color names"
6807msgstr ""
6808
6809#. type: Plain text
6810#: ../lib/terminal-colors.d.5.adoc:63
6811msgid ""
6812"black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
6813"lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
6814"magenta, red, reset, reverse, and yellow."
6815msgstr ""
6816
6817#. type: Title ===
6818#: ../lib/terminal-colors.d.5.adoc:64
6819#, no-wrap
6820msgid "ANSI color sequences"
6821msgstr ""
6822
6823#. type: Plain text
6824#: ../lib/terminal-colors.d.5.adoc:67
6825msgid ""
6826"The color sequences are composed of sequences of numbers separated by "
6827"semicolons. The most common codes are:"
6828msgstr ""
6829
6830#. type: Table
6831#: ../lib/terminal-colors.d.5.adoc:91
6832#, no-wrap
6833msgid ""
6834"|0 |to restore default color\n"
6835"|1 |for brighter colors\n"
6836"|4 |for underlined text\n"
6837"|5 |for flashing text\n"
6838"|30 |for black foreground\n"
6839"|31 |for red foreground\n"
6840"|32 |for green foreground\n"
6841"|33 |for yellow (or brown) foreground\n"
6842"|34 |for blue foreground\n"
6843"|35 |for purple foreground\n"
6844"|36 |for cyan foreground\n"
6845"|37 |for white (or gray) foreground\n"
6846"|40 |for black background\n"
6847"|41 |for red background\n"
6848"|42 |for green background\n"
6849"|43 |for yellow (or brown) background\n"
6850"|44 |for blue background\n"
6851"|45 |for purple background\n"
6852"|46 |for cyan background\n"
6853"|47 |for white (or gray) background\n"
6854msgstr ""
6855
6856#. type: Title ===
6857#: ../lib/terminal-colors.d.5.adoc:94
6858#, no-wrap
6859msgid "Escape sequences"
6860msgstr ""
6861
6862#. type: delimited block _
6863#: ../lib/terminal-colors.d.5.adoc:97
6864msgid ""
6865"To specify control or blank characters in the color sequences, C-style "
6866"\\-escaped notation can be used:"
6867msgstr ""
6868
6869#. type: Table
6870#: ../lib/terminal-colors.d.5.adoc:114
6871#, no-wrap
6872msgid ""
6873"|*\\a* |Bell (ASCII 7)\n"
6874"|*\\b* |Backspace (ASCII 8)\n"
6875"|*\\e* |Escape (ASCII 27)\n"
6876"|*\\f* |Form feed (ASCII 12)\n"
6877"|*\\n* |Newline (ASCII 10)\n"
6878"|*\\r* |Carriage Return (ASCII 13)\n"
6879"|*\\t* |Tab (ASCII 9)\n"
6880"|*\\v* |Vertical Tab (ASCII 11)\n"
6881"|*\\?* |Delete (ASCII 127)\n"
6882"|*\\_* |Space\n"
6883"|*\\\\* |Backslash (\\)\n"
6884"|*\\^* |Caret (^)\n"
6885"|*\\#* |Hash mark (#)\n"
6886msgstr ""
6887
6888#. type: delimited block _
6889#: ../lib/terminal-colors.d.5.adoc:118
6890msgid ""
6891"Please note that escapes are necessary to enter a space, backslash, caret, "
6892"or any control character anywhere in the string, as well as a hash mark as "
6893"the first character."
6894msgstr ""
6895
6896#. type: delimited block _
6897#: ../lib/terminal-colors.d.5.adoc:120
6898msgid ""
6899"For example, to use a red background for alert messages in the output of "
6900"*dmesg*(1), use:"
6901msgstr ""
6902
6903#. type: Plain text
6904#: ../lib/terminal-colors.d.5.adoc:123
6905#, no-wrap
6906msgid "*echo 'alert 37;41' >> /etc/terminal-colors.d/dmesg.scheme*\n"
6907msgstr ""
6908
6909#. type: Title ===
6910#: ../lib/terminal-colors.d.5.adoc:125
6911#, no-wrap
6912msgid "Comments"
6913msgstr ""
6914
6915#. type: delimited block _
6916#: ../lib/terminal-colors.d.5.adoc:128
6917msgid ""
6918"Lines where the first non-blank character is a # (hash) are ignored. Any "
6919"other use of the hash character is not interpreted as introducing a comment."
6920msgstr ""
6921
6922#. type: Labeled list
6923#: ../lib/terminal-colors.d.5.adoc:131
6924#, no-wrap
6925msgid "TERMINAL_COLORS_DEBUG=all"
6926msgstr ""
6927
6928#. type: Plain text
6929#: ../lib/terminal-colors.d.5.adoc:133 ../misc-utils/whereis.1.adoc:114
6930#: ../sys-utils/losetup.8.adoc:138
6931msgid "enables debug output."
6932msgstr ""
6933
6934#. type: delimited block _
6935#: ../lib/terminal-colors.d.5.adoc:137
6936msgid "_$XDG_CONFIG_HOME/terminal-colors.d_"
6937msgstr ""
6938
6939#. type: delimited block _
6940#: ../lib/terminal-colors.d.5.adoc:139
6941msgid "_$HOME/.config/terminal-colors.d_"
6942msgstr ""
6943
6944#. type: delimited block _
6945#: ../lib/terminal-colors.d.5.adoc:141
6946msgid "_/etc/terminal-colors.d_"
6947msgstr ""
6948
6949#. type: delimited block _
6950#: ../lib/terminal-colors.d.5.adoc:145
6951msgid "Disable colors for all compatible utilities:"
6952msgstr ""
6953
6954#. type: Plain text
6955#: ../lib/terminal-colors.d.5.adoc:148 ../lib/terminal-colors.d.5.adoc:160
6956#, no-wrap
6957msgid "*touch /etc/terminal-colors.d/disable*\n"
6958msgstr ""
6959
6960#. type: delimited block _
6961#: ../lib/terminal-colors.d.5.adoc:151
6962msgid "Disable colors for all compatible utils on a vt100 terminal:"
6963msgstr ""
6964
6965#. type: Plain text
6966#: ../lib/terminal-colors.d.5.adoc:154
6967#, no-wrap
6968msgid "*touch /etc/terminal-colors.d/@vt100.disable*\n"
6969msgstr ""
6970
6971#. type: delimited block _
6972#: ../lib/terminal-colors.d.5.adoc:157
6973msgid "Disable colors for all compatible utils except *dmesg*(1):"
6974msgstr ""
6975
6976#. type: Plain text
6977#: ../lib/terminal-colors.d.5.adoc:162
6978#, no-wrap
6979msgid "*touch /etc/terminal-colors.d/dmesg.enable*\n"
6980msgstr ""
6981
6982#. type: Title ==
6983#: ../lib/terminal-colors.d.5.adoc:164 ../misc-utils/getopt.1.adoc:114
6984#: ../term-utils/setterm.1.adoc:163
6985#, no-wrap
6986msgid "COMPATIBILITY"
6987msgstr ""
6988
6989#. type: delimited block _
6990#: ../lib/terminal-colors.d.5.adoc:167
6991msgid ""
6992"The terminal-colors.d functionality is currently supported by all util-linux "
6993"utilities which provides colorized output. For more details always see the "
6994"COLORS section in the man page for the utility."
6995msgstr ""
6996
6997#. Copyright 2001 Andreas Dilger (adilger@turbolinux.com)
6998#. This man page was created for libblkid.so.1.0 from e2fsprogs-1.24.
6999#. This file may be copied under the terms of the GNU Lesser General Public License.
7000#. Created Wed Sep 14 12:02:12 2001, Andreas Dilger
7001#. type: Title =
7002#: ../libblkid/libblkid.3.adoc:8
7003#, no-wrap
7004msgid "libblkid(3)"
7005msgstr ""
7006
7007#. type: Attribute :man manual:
7008#: ../libblkid/libblkid.3.adoc:10 ../libuuid/man/uuid.3.adoc:35
7009#: ../libuuid/man/uuid_clear.3.adoc:35 ../libuuid/man/uuid_compare.3.adoc:35
7010#: ../libuuid/man/uuid_copy.3.adoc:35 ../libuuid/man/uuid_generate.3.adoc:37
7011#: ../libuuid/man/uuid_is_null.3.adoc:35 ../libuuid/man/uuid_parse.3.adoc:35
7012#: ../libuuid/man/uuid_time.3.adoc:35 ../libuuid/man/uuid_unparse.3.adoc:35
7013#, no-wrap
7014msgid "Programmer's Manual"
7015msgstr ""
7016
7017#. type: Plain text
7018#: ../libblkid/libblkid.3.adoc:19
7019msgid "libblkid - block device identification library"
7020msgstr ""
7021
7022#. type: Plain text
7023#: ../libblkid/libblkid.3.adoc:23
7024#, no-wrap
7025msgid "*#include <blkid.h>*\n"
7026msgstr ""
7027
7028#. type: Plain text
7029#: ../libblkid/libblkid.3.adoc:25
7030#, no-wrap
7031msgid "*cc* _file.c_ *-lblkid*\n"
7032msgstr ""
7033
7034#. type: Plain text
7035#: ../libblkid/libblkid.3.adoc:29
7036msgid ""
7037"The *libblkid* library is used to identify block devices (disks) as to their "
7038"content (e.g., filesystem type) as well as extracting additional information "
7039"such as filesystem labels/volume names, unique identifiers/serial numbers. A "
7040"common use is to allow use of *LABEL=* and *UUID=* tags instead of "
7041"hard-coding specific block device names into configuration files."
7042msgstr ""
7043
7044#. type: Plain text
7045#: ../libblkid/libblkid.3.adoc:31
7046msgid ""
7047"The low-level part of the library also allows the extraction of information "
7048"about partitions and block device topology."
7049msgstr ""
7050
7051#. type: Plain text
7052#: ../libblkid/libblkid.3.adoc:33
7053msgid ""
7054"The high-level part of the library keeps information about block devices in "
7055"a cache file and is verified to still be valid before being returned to the "
7056"user (if the user has read permission on the raw block device, otherwise "
7057"not). The cache file also allows unprivileged users (normally anyone other "
7058"than root, or those not in the \"disk\" group) to locate devices by "
7059"label/id. The standard location of the cache file can be overridden by the "
7060"environment variable *BLKID_FILE*."
7061msgstr ""
7062
7063#. type: Plain text
7064#: ../libblkid/libblkid.3.adoc:35
7065msgid ""
7066"In situations where one is getting information about a single known device, "
7067"it does not impact performance whether the cache is used or not (unless you "
7068"are not able to read the block device directly)."
7069msgstr ""
7070
7071#. type: Plain text
7072#: ../libblkid/libblkid.3.adoc:37
7073msgid ""
7074"The high-level part of the library supports two methods to evaluate "
7075"*LABEL/UUID*. It reads information directly from a block device or read "
7076"information from /dev/disk/by-* udev symlinks. The udev is preferred method "
7077"by default."
7078msgstr ""
7079
7080#. type: Plain text
7081#: ../libblkid/libblkid.3.adoc:39
7082msgid ""
7083"If you are dealing with multiple devices, use of the cache is highly "
7084"recommended (even if empty) as devices will be scanned at most one time and "
7085"the on-disk cache will be updated if possible."
7086msgstr ""
7087
7088#. type: Plain text
7089#: ../libblkid/libblkid.3.adoc:41
7090msgid ""
7091"In some cases (modular kernels), block devices are not even visible until "
7092"after they are accessed the first time, so it is critical that there is some "
7093"way to locate these devices without enumerating only visible devices, so the "
7094"use of the cache file is *required* in this situation."
7095msgstr ""
7096
7097#. type: Title ==
7098#: ../libblkid/libblkid.3.adoc:42 ../misc-utils/blkid.8.adoc:157
7099#, no-wrap
7100msgid "CONFIGURATION FILE"
7101msgstr ""
7102
7103#. type: Plain text
7104#: ../libblkid/libblkid.3.adoc:45
7105msgid ""
7106"The standard location of the _/etc/blkid.conf_ config file can be overridden "
7107"by the environment variable *BLKID_CONF*. For more details about the config "
7108"file see *blkid*(8) man page."
7109msgstr ""
7110
7111#. type: Plain text
7112#: ../libblkid/libblkid.3.adoc:49
7113#, no-wrap
7114msgid ""
7115"*libblkid* was written by Andreas Dilger for the ext2 filesystem utilities, "
7116"with input from Ted Ts'o. The library was subsequently heavily modified by "
7117"Ted Ts'o.\n"
7118msgstr ""
7119
7120#. type: Plain text
7121#: ../libblkid/libblkid.3.adoc:51
7122msgid "The low-level probing code was rewritten by Karel Zak."
7123msgstr ""
7124
7125#. type: Title ==
7126#: ../libblkid/libblkid.3.adoc:52
7127#, no-wrap
7128msgid "COPYING"
7129msgstr ""
7130
7131#. type: Plain text
7132#: ../libblkid/libblkid.3.adoc:55
7133#, no-wrap
7134msgid ""
7135"*libblkid* is available under the terms of the GNU Library General Public "
7136"License (LGPL), version 2 (or at your discretion any later version).\n"
7137msgstr ""
7138
7139#. type: Plain text
7140#: ../libblkid/libblkid.3.adoc:60
7141#, no-wrap
7142msgid ""
7143"*blkid*(8), \n"
7144"*findfs*(8)\n"
7145msgstr ""
7146
7147#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7148#
7149#. Redistribution and use in source and binary forms, with or without
7150#. modification, are permitted provided that the following conditions
7151#. are met:
7152#. 1. Redistributions of source code must retain the above copyright
7153#. notice, and the entire permission notice in its entirety,
7154#. including the disclaimer of warranties.
7155#. 2. Redistributions in binary form must reproduce the above copyright
7156#. notice, this list of conditions and the following disclaimer in the
7157#. documentation and/or other materials provided with the distribution.
7158#. 3. The name of the author may not be used to endorse or promote
7159#. products derived from this software without specific prior
7160#. written permission.
7161#
7162#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7163#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7164#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7165#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7166#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7167#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7168#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7169#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7170#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7171#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7172#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7173#. DAMAGE.
7174#
7175#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7176#. type: Title =
7177#: ../libuuid/man/uuid.3.adoc:33
7178#, no-wrap
7179msgid "uuid(3)"
7180msgstr ""
7181
7182#. type: Plain text
7183#: ../libuuid/man/uuid.3.adoc:44
7184msgid "uuid - DCE compatible Universally Unique Identifier library"
7185msgstr ""
7186
7187#. type: Plain text
7188#: ../libuuid/man/uuid.3.adoc:48 ../libuuid/man/uuid_clear.3.adoc:48
7189#: ../libuuid/man/uuid_compare.3.adoc:48 ../libuuid/man/uuid_copy.3.adoc:48
7190#: ../libuuid/man/uuid_generate.3.adoc:50 ../libuuid/man/uuid_is_null.3.adoc:48
7191#: ../libuuid/man/uuid_parse.3.adoc:48 ../libuuid/man/uuid_time.3.adoc:48
7192#: ../libuuid/man/uuid_unparse.3.adoc:48
7193#, no-wrap
7194msgid "*#include <uuid.h>*\n"
7195msgstr ""
7196
7197#. type: Plain text
7198#: ../libuuid/man/uuid.3.adoc:52
7199msgid ""
7200"The UUID library is used to generate unique identifiers for objects that may "
7201"be accessible beyond the local system. This library generates UUIDs "
7202"compatible with those created by the Open Software Foundation (OSF) "
7203"Distributed Computing Environment (DCE) utility *uuidgen*(1)."
7204msgstr ""
7205
7206#. type: Plain text
7207#: ../libuuid/man/uuid.3.adoc:54
7208msgid ""
7209"The UUIDs generated by this library can be reasonably expected to be unique "
7210"within a system, and unique across all systems. They could be used, for "
7211"instance, to generate unique HTTP cookies across multiple web servers "
7212"without communication between the servers, and without fear of a name clash."
7213msgstr ""
7214
7215#. type: Title ==
7216#: ../libuuid/man/uuid.3.adoc:55 ../libuuid/man/uuid_generate.3.adoc:76
7217#: ../libuuid/man/uuid_parse.3.adoc:62 ../libuuid/man/uuid_unparse.3.adoc:59
7218#: ../misc-utils/logger.1.adoc:230 ../misc-utils/uuidgen.1.adoc:58
7219#: ../sys-utils/ipcs.1.adoc:79 ../text-utils/col.1.adoc:86
7220#: ../text-utils/hexdump.1.adoc:225
7221#, no-wrap
7222msgid "CONFORMING TO"
7223msgstr ""
7224
7225#. type: Plain text
7226#: ../libuuid/man/uuid.3.adoc:58 ../libuuid/man/uuid_generate.3.adoc:79
7227msgid ""
7228"This library generates UUIDs compatible with OSF DCE 1.1, and hash based "
7229"UUIDs V3 and V5 compatible with "
7230"link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
7231msgstr ""
7232
7233#. type: Plain text
7234#: ../libuuid/man/uuid.3.adoc:62 ../libuuid/man/uuid_clear.3.adoc:58
7235#: ../libuuid/man/uuid_compare.3.adoc:62 ../libuuid/man/uuid_copy.3.adoc:62
7236#: ../libuuid/man/uuid_generate.3.adoc:83 ../libuuid/man/uuid_is_null.3.adoc:58
7237#: ../libuuid/man/uuid_parse.3.adoc:69 ../libuuid/man/uuid_time.3.adoc:62
7238#: ../libuuid/man/uuid_unparse.3.adoc:66
7239msgid "Theodore Y. Ts'o"
7240msgstr ""
7241
7242#. type: Plain text
7243#: ../libuuid/man/uuid.3.adoc:73
7244#, no-wrap
7245msgid ""
7246"*uuid_clear*(3),\n"
7247"*uuid_compare*(3),\n"
7248"*uuid_copy*(3),\n"
7249"*uuid_generate*(3),\n"
7250"*uuid_is_null*(3),\n"
7251"*uuid_parse*(3),\n"
7252"*uuid_time*(3),\n"
7253"*uuid_unparse*(3)\n"
7254msgstr ""
7255
7256#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7257#
7258#. Redistribution and use in source and binary forms, with or without
7259#. modification, are permitted provided that the following conditions
7260#. are met:
7261#. 1. Redistributions of source code must retain the above copyright
7262#. notice, and the entire permission notice in its entirety,
7263#. including the disclaimer of warranties.
7264#. 2. Redistributions in binary form must reproduce the above copyright
7265#. notice, this list of conditions and the following disclaimer in the
7266#. documentation and/or other materials provided with the distribution.
7267#. 3. The name of the author may not be used to endorse or promote
7268#. products derived from this software without specific prior
7269#. written permission.
7270#
7271#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7272#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7273#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7274#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7275#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7276#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7277#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7278#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7279#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7280#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7281#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7282#. DAMAGE.
7283#
7284#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7285#. type: Title =
7286#: ../libuuid/man/uuid_clear.3.adoc:33
7287#, no-wrap
7288msgid "uuid_clear(3)"
7289msgstr ""
7290
7291#. type: Plain text
7292#: ../libuuid/man/uuid_clear.3.adoc:44
7293msgid "uuid_clear - reset value of UUID variable to the NULL value"
7294msgstr ""
7295
7296#. type: Plain text
7297#: ../libuuid/man/uuid_clear.3.adoc:50
7298#, no-wrap
7299msgid "*void uuid_clear(uuid_t __uu__);*\n"
7300msgstr ""
7301
7302#. type: Plain text
7303#: ../libuuid/man/uuid_clear.3.adoc:54
7304msgid ""
7305"The *uuid_clear*() function sets the value of the supplied uuid variable "
7306"_uu_ to the NULL value."
7307msgstr ""
7308
7309#. type: Plain text
7310#: ../libuuid/man/uuid_clear.3.adoc:68
7311#, no-wrap
7312msgid ""
7313"*uuid*(3),\n"
7314"*uuid_compare*(3),\n"
7315"*uuid_copy*(3),\n"
7316"*uuid_generate*(3),\n"
7317"*uuid_is_null*(3),\n"
7318"*uuid_parse*(3),\n"
7319"*uuid_unparse*(3)\n"
7320msgstr ""
7321
7322#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7323#
7324#. Redistribution and use in source and binary forms, with or without
7325#. modification, are permitted provided that the following conditions
7326#. are met:
7327#. 1. Redistributions of source code must retain the above copyright
7328#. notice, and the entire permission notice in its entirety,
7329#. including the disclaimer of warranties.
7330#. 2. Redistributions in binary form must reproduce the above copyright
7331#. notice, this list of conditions and the following disclaimer in the
7332#. documentation and/or other materials provided with the distribution.
7333#. 3. The name of the author may not be used to endorse or promote
7334#. products derived from this software without specific prior
7335#. written permission.
7336#
7337#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7338#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7339#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7340#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7341#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7342#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7343#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7344#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7345#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7346#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7347#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7348#. DAMAGE.
7349#
7350#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7351#. type: Title =
7352#: ../libuuid/man/uuid_compare.3.adoc:33
7353#, no-wrap
7354msgid "uuid_compare(3)"
7355msgstr ""
7356
7357#. type: Plain text
7358#: ../libuuid/man/uuid_compare.3.adoc:44
7359msgid "uuid_compare - compare whether two UUIDs are the same"
7360msgstr ""
7361
7362#. type: Plain text
7363#: ../libuuid/man/uuid_compare.3.adoc:50
7364#, no-wrap
7365msgid "*int uuid_compare(uuid_t __uu1__, uuid_t __uu2__)*\n"
7366msgstr ""
7367
7368#. type: Plain text
7369#: ../libuuid/man/uuid_compare.3.adoc:54
7370msgid ""
7371"The *uuid_compare*() function compares the two supplied uuid variables _uu1_ "
7372"and _uu2_ to each other."
7373msgstr ""
7374
7375#. type: Title ==
7376#: ../libuuid/man/uuid_compare.3.adoc:55 ../libuuid/man/uuid_copy.3.adoc:55
7377#: ../libuuid/man/uuid_generate.3.adoc:72 ../libuuid/man/uuid_parse.3.adoc:58
7378#: ../libuuid/man/uuid_time.3.adoc:55
7379#, no-wrap
7380msgid "RETURN VALUE"
7381msgstr ""
7382
7383#. type: Plain text
7384#: ../libuuid/man/uuid_compare.3.adoc:58
7385msgid ""
7386"Returns an integer less than, equal to, or greater than zero if _uu1_ is "
7387"found, respectively, to be lexicographically less than, equal, or greater "
7388"than _uu2_."
7389msgstr ""
7390
7391#. type: Plain text
7392#: ../libuuid/man/uuid_compare.3.adoc:72
7393#, no-wrap
7394msgid ""
7395"*uuid*(3),\n"
7396"*uuid_clear*(3),\n"
7397"*uuid_copy*(3),\n"
7398"*uuid_generate*(3),\n"
7399"*uuid_is_null*(3),\n"
7400"*uuid_parse*(3),\n"
7401"*uuid_unparse*(3)\n"
7402msgstr ""
7403
7404#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7405#
7406#. Redistribution and use in source and binary forms, with or without
7407#. modification, are permitted provided that the following conditions
7408#. are met:
7409#. 1. Redistributions of source code must retain the above copyright
7410#. notice, and the entire permission notice in its entirety,
7411#. including the disclaimer of warranties.
7412#. 2. Redistributions in binary form must reproduce the above copyright
7413#. notice, this list of conditions and the following disclaimer in the
7414#. documentation and/or other materials provided with the distribution.
7415#. 3. The name of the author may not be used to endorse or promote
7416#. products derived from this software without specific prior
7417#. written permission.
7418#
7419#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7420#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7421#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7422#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7423#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7424#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7425#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7426#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7427#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7428#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7429#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7430#. DAMAGE.
7431#
7432#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7433#. type: Title =
7434#: ../libuuid/man/uuid_copy.3.adoc:33
7435#, no-wrap
7436msgid "uuid_copy(3)"
7437msgstr ""
7438
7439#. type: Plain text
7440#: ../libuuid/man/uuid_copy.3.adoc:44
7441msgid "uuid_copy - copy a UUID value"
7442msgstr ""
7443
7444#. type: Plain text
7445#: ../libuuid/man/uuid_copy.3.adoc:50
7446#, no-wrap
7447msgid "*void uuid_copy(uuid_t __dst__, uuid_t __src__;*\n"
7448msgstr ""
7449
7450#. type: Plain text
7451#: ../libuuid/man/uuid_copy.3.adoc:54
7452msgid "The *uuid_copy*() function copies the UUID variable _src_ to _dst_."
7453msgstr ""
7454
7455#. type: Plain text
7456#: ../libuuid/man/uuid_copy.3.adoc:58
7457msgid "The copied UUID is returned in the location pointed to by _dst_."
7458msgstr ""
7459
7460#. type: Plain text
7461#: ../libuuid/man/uuid_copy.3.adoc:72
7462#, no-wrap
7463msgid ""
7464"*uuid*(3),\n"
7465"*uuid_clear*(3),\n"
7466"*uuid_compare*(3),\n"
7467"*uuid_generate*(3),\n"
7468"*uuid_is_null*(3),\n"
7469"*uuid_parse*(3),\n"
7470"*uuid_unparse*(3)\n"
7471msgstr ""
7472
7473#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7474#
7475#. %Begin-Header%
7476#. Redistribution and use in source and binary forms, with or without
7477#. modification, are permitted provided that the following conditions
7478#. are met:
7479#. 1. Redistributions of source code must retain the above copyright
7480#. notice, and the entire permission notice in its entirety,
7481#. including the disclaimer of warranties.
7482#. 2. Redistributions in binary form must reproduce the above copyright
7483#. notice, this list of conditions and the following disclaimer in the
7484#. documentation and/or other materials provided with the distribution.
7485#. 3. The name of the author may not be used to endorse or promote
7486#. products derived from this software without specific prior
7487#. written permission.
7488#
7489#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7490#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7491#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7492#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7493#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7494#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7495#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7496#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7497#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7498#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7499#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7500#. DAMAGE.
7501#. %End-Header%
7502#
7503#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7504#. type: Title =
7505#: ../libuuid/man/uuid_generate.3.adoc:35
7506#, no-wrap
7507msgid "uuid_generate(3)"
7508msgstr ""
7509
7510#. type: Plain text
7511#: ../libuuid/man/uuid_generate.3.adoc:46
7512msgid ""
7513"uuid_generate, uuid_generate_random, uuid_generate_time, "
7514"uuid_generate_time_safe - create a new unique UUID value"
7515msgstr ""
7516
7517#. type: Plain text
7518#: ../libuuid/man/uuid_generate.3.adoc:57
7519#, no-wrap
7520msgid ""
7521"*void uuid_generate(uuid_t __out__);* +\n"
7522"*void uuid_generate_random(uuid_t __out__);* +\n"
7523"*void uuid_generate_time(uuid_t __out__);* +\n"
7524"*int uuid_generate_time_safe(uuid_t __out__);* +\n"
7525"*void uuid_generate_md5(uuid_t __out__, const uuid_t __ns__, const char "
7526"__*name__, size_t __len__);* +\n"
7527"*void uuid_generate_sha1(uuid_t __out__, const uuid_t __ns__, const char "
7528"__*name__, size_t __len__);*\n"
7529msgstr ""
7530
7531#. type: Plain text
7532#: ../libuuid/man/uuid_generate.3.adoc:61
7533msgid ""
7534"The *uuid_generate*() function creates a new universally unique identifier "
7535"(UUID). The uuid will be generated based on high-quality randomness from "
7536"*getrandom*(2), _/dev/urandom_, or _/dev/random_ if available. If it is not "
7537"available, then *uuid_generate*() will use an alternative algorithm which "
7538"uses the current time, the local ethernet MAC address (if available), and "
7539"random data generated using a pseudo-random generator."
7540msgstr ""
7541
7542#. type: Plain text
7543#: ../libuuid/man/uuid_generate.3.adoc:63
7544msgid ""
7545"The *uuid_generate_random*() function forces the use of the all-random UUID "
7546"format, even if a high-quality random number generator is not available, in "
7547"which case a pseudo-random generator will be substituted. Note that the use "
7548"of a pseudo-random generator may compromise the uniqueness of UUIDs "
7549"generated in this fashion."
7550msgstr ""
7551
7552#. type: Plain text
7553#: ../libuuid/man/uuid_generate.3.adoc:65
7554msgid ""
7555"The *uuid_generate_time*() function forces the use of the alternative "
7556"algorithm which uses the current time and the local ethernet MAC address (if "
7557"available). This algorithm used to be the default one used to generate "
7558"UUIDs, but because of the use of the ethernet MAC address, it can leak "
7559"information about when and where the UUID was generated. This can cause "
7560"privacy problems in some applications, so the *uuid_generate*() function "
7561"only uses this algorithm if a high-quality source of randomness is not "
7562"available. To guarantee uniqueness of UUIDs generated by concurrently "
7563"running processes, the uuid library uses a global clock state counter (if "
7564"the process has permissions to gain exclusive access to this file) and/or "
7565"the *uuidd* daemon, if it is running already or can be spawned by the "
7566"process (if installed and the process has enough permissions to run it). If "
7567"neither of these two synchronization mechanisms can be used, it is "
7568"theoretically possible that two concurrently running processes obtain the "
7569"same UUID(s). To tell whether the UUID has been generated in a safe manner, "
7570"use *uuid_generate_time_safe*."
7571msgstr ""
7572
7573#. type: Plain text
7574#: ../libuuid/man/uuid_generate.3.adoc:67
7575msgid ""
7576"The *uuid_generate_time_safe*() function is similar to "
7577"*uuid_generate_time*(), except that it returns a value which denotes whether "
7578"any of the synchronization mechanisms (see above) has been used."
7579msgstr ""
7580
7581#. type: Plain text
7582#: ../libuuid/man/uuid_generate.3.adoc:69
7583msgid ""
7584"The UUID is 16 bytes (128 bits) long, which gives approximately 3.4x10^38 "
7585"unique values (there are approximately 10^80 elementary particles in the "
7586"universe according to Carl Sagan's _Cosmos_). The new UUID can reasonably be "
7587"considered unique among all UUIDs created on the local system, and among "
7588"UUIDs created on other systems in the past and in the future."
7589msgstr ""
7590
7591#. type: Plain text
7592#: ../libuuid/man/uuid_generate.3.adoc:71
7593msgid ""
7594"The *uuid_generate_md5*() and *uuid_generate_sha1*() functions generate an "
7595"MD5 and SHA1 hashed (predictable) UUID based on a well-known UUID providing "
7596"the namespace and an arbitrary binary string. The UUIDs conform to V3 and V5 "
7597"UUIDs per link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
7598msgstr ""
7599
7600#. type: Plain text
7601#: ../libuuid/man/uuid_generate.3.adoc:75
7602msgid ""
7603"The newly created UUID is returned in the memory location pointed to by "
7604"_out_. *uuid_generate_time_safe*() returns zero if the UUID has been "
7605"generated in a safe manner, -1 otherwise."
7606msgstr ""
7607
7608#. type: Plain text
7609#: ../libuuid/man/uuid_generate.3.adoc:96
7610#, no-wrap
7611msgid ""
7612"*uuidgen*(1),\n"
7613"*uuid*(3),\n"
7614"*uuid_clear*(3),\n"
7615"*uuid_compare*(3),\n"
7616"*uuid_copy*(3),\n"
7617"*uuid_is_null*(3),\n"
7618"*uuid_parse*(3),\n"
7619"*uuid_time*(3),\n"
7620"*uuid_unparse*(3),\n"
7621"*uuidd*(8)\n"
7622msgstr ""
7623
7624#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7625#
7626#. Redistribution and use in source and binary forms, with or without
7627#. modification, are permitted provided that the following conditions
7628#. are met:
7629#. 1. Redistributions of source code must retain the above copyright
7630#. notice, and the entire permission notice in its entirety,
7631#. including the disclaimer of warranties.
7632#. 2. Redistributions in binary form must reproduce the above copyright
7633#. notice, this list of conditions and the following disclaimer in the
7634#. documentation and/or other materials provided with the distribution.
7635#. 3. The name of the author may not be used to endorse or promote
7636#. products derived from this software without specific prior
7637#. written permission.
7638#
7639#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7640#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7641#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7642#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7643#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7644#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7645#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7646#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7647#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7648#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7649#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7650#. DAMAGE.
7651#
7652#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7653#. type: Title =
7654#: ../libuuid/man/uuid_is_null.3.adoc:33
7655#, no-wrap
7656msgid "uuid_is_null(3)"
7657msgstr ""
7658
7659#. type: Plain text
7660#: ../libuuid/man/uuid_is_null.3.adoc:44
7661msgid "uuid_is_null - compare the value of the UUID to the NULL value"
7662msgstr ""
7663
7664#. type: Plain text
7665#: ../libuuid/man/uuid_is_null.3.adoc:50
7666#, no-wrap
7667msgid "*int uuid_is_null(uuid_t __uu__);*\n"
7668msgstr ""
7669
7670#. type: Plain text
7671#: ../libuuid/man/uuid_is_null.3.adoc:54
7672msgid ""
7673"The *uuid_is_null*() function compares the value of the supplied UUID "
7674"variable _uu_ to the NULL value. If the value is equal to the NULL UUID, 1 "
7675"is returned, otherwise 0 is returned."
7676msgstr ""
7677
7678#. type: Plain text
7679#: ../libuuid/man/uuid_is_null.3.adoc:69
7680#, no-wrap
7681msgid ""
7682"*uuid*(3),\n"
7683"*uuid_clear*(3),\n"
7684"*uuid_compare*(3),\n"
7685"*uuid_copy*(3),\n"
7686"*uuid_generate*(3),\n"
7687"*uuid_time*(3),\n"
7688"*uuid_parse*(3),\n"
7689"*uuid_unparse*(3)\n"
7690msgstr ""
7691
7692#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7693#
7694#. Redistribution and use in source and binary forms, with or without
7695#. modification, are permitted provided that the following conditions
7696#. are met:
7697#. 1. Redistributions of source code must retain the above copyright
7698#. notice, and the entire permission notice in its entirety,
7699#. including the disclaimer of warranties.
7700#. 2. Redistributions in binary form must reproduce the above copyright
7701#. notice, this list of conditions and the following disclaimer in the
7702#. documentation and/or other materials provided with the distribution.
7703#. 3. The name of the author may not be used to endorse or promote
7704#. products derived from this software without specific prior
7705#. written permission.
7706#
7707#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7708#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7709#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7710#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7711#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7712#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7713#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7714#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7715#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7716#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7717#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7718#. DAMAGE.
7719#
7720#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7721#. type: Title =
7722#: ../libuuid/man/uuid_parse.3.adoc:33
7723#, no-wrap
7724msgid "uuid_parse(3)"
7725msgstr ""
7726
7727#. type: Plain text
7728#: ../libuuid/man/uuid_parse.3.adoc:44
7729msgid "uuid_parse - convert an input UUID string into binary representation"
7730msgstr ""
7731
7732#. type: Plain text
7733#: ../libuuid/man/uuid_parse.3.adoc:51
7734#, no-wrap
7735msgid ""
7736"*int uuid_parse(char *__in__, uuid_t __uu__);* +\n"
7737"*int uuid_parse_range(char *__in_start__, char *__in_end__, uuid_t "
7738"__uu__);*\n"
7739msgstr ""
7740
7741#. type: Plain text
7742#: ../libuuid/man/uuid_parse.3.adoc:55
7743msgid ""
7744"The *uuid_parse*() function converts the UUID string given by _in_ into the "
7745"binary representation. The input UUID is a string of the form "
7746"1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in *printf*(3) format "
7747"\"%08x-%04x-%04x-%04x-%012x\", 36 bytes plus the trailing '\\0')."
7748msgstr ""
7749
7750#. type: Plain text
7751#: ../libuuid/man/uuid_parse.3.adoc:57
7752msgid ""
7753"The *uuid_parse_range*() function works like *uuid_parse*() but parses only "
7754"range in string specified by _in_start_ and _in_end_ pointers."
7755msgstr ""
7756
7757#. type: Plain text
7758#: ../libuuid/man/uuid_parse.3.adoc:61
7759msgid ""
7760"Upon successfully parsing the input string, 0 is returned, and the UUID is "
7761"stored in the location pointed to by _uu_, otherwise -1 is returned."
7762msgstr ""
7763
7764#. type: Plain text
7765#: ../libuuid/man/uuid_parse.3.adoc:65
7766msgid ""
7767"This library parses UUIDs compatible with OSF DCE 1.1, and hash based UUIDs "
7768"V3 and V5 compatible with "
7769"link:https://tools.ietf.org/html/rfc4122[RFC-4122]."
7770msgstr ""
7771
7772#. type: Plain text
7773#: ../libuuid/man/uuid_parse.3.adoc:80
7774#, no-wrap
7775msgid ""
7776"*uuid*(3),\n"
7777"*uuid_clear*(3),\n"
7778"*uuid_compare*(3),\n"
7779"*uuid_copy*(3),\n"
7780"*uuid_generate*(3),\n"
7781"*uuid_is_null*(3),\n"
7782"*uuid_time*(3),\n"
7783"*uuid_unparse*(3)\n"
7784msgstr ""
7785
7786#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7787#
7788#. Redistribution and use in source and binary forms, with or without
7789#. modification, are permitted provided that the following conditions
7790#. are met:
7791#. 1. Redistributions of source code must retain the above copyright
7792#. notice, and the entire permission notice in its entirety,
7793#. including the disclaimer of warranties.
7794#. 2. Redistributions in binary form must reproduce the above copyright
7795#. notice, this list of conditions and the following disclaimer in the
7796#. documentation and/or other materials provided with the distribution.
7797#. 3. The name of the author may not be used to endorse or promote
7798#. products derived from this software without specific prior
7799#. written permission.
7800#
7801#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7802#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7803#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7804#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7805#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7806#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7807#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7808#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7809#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7810#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7811#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7812#. DAMAGE.
7813#
7814#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7815#. type: Title =
7816#: ../libuuid/man/uuid_time.3.adoc:33
7817#, no-wrap
7818msgid "uuid_time(3)"
7819msgstr ""
7820
7821#. type: Plain text
7822#: ../libuuid/man/uuid_time.3.adoc:44
7823msgid "uuid_time - extract the time at which the UUID was created"
7824msgstr ""
7825
7826#. type: Plain text
7827#: ../libuuid/man/uuid_time.3.adoc:50
7828#, no-wrap
7829msgid "*time_t uuid_time(uuid_t __uu__, struct timeval *__ret_tv__)*\n"
7830msgstr ""
7831
7832#. type: Plain text
7833#: ../libuuid/man/uuid_time.3.adoc:54
7834msgid ""
7835"The *uuid_time*() function extracts the time at which the supplied "
7836"time-based UUID _uu_ was created. Note that the UUID creation time is only "
7837"encoded within certain types of UUIDs. This function can only reasonably "
7838"expect to extract the creation time for UUIDs created with the "
7839"*uuid_generate_time*(3) and *uuid_generate_time_safe*(3) functions. It may "
7840"or may not work with UUIDs created by other mechanisms."
7841msgstr ""
7842
7843#. type: Plain text
7844#: ../libuuid/man/uuid_time.3.adoc:58
7845msgid ""
7846"The time at which the UUID was created, in seconds since January 1, 1970 GMT "
7847"(the epoch), is returned (see *time*(2)). The time at which the UUID was "
7848"created, in seconds and microseconds since the epoch, is also stored in the "
7849"location pointed to by _ret_tv_ (see *gettimeofday*(2))."
7850msgstr ""
7851
7852#. type: Plain text
7853#: ../libuuid/man/uuid_time.3.adoc:73
7854#, no-wrap
7855msgid ""
7856"*uuid*(3),\n"
7857"*uuid_clear*(3),\n"
7858"*uuid_compare*(3),\n"
7859"*uuid_copy*(3),\n"
7860"*uuid_generate*(3),\n"
7861"*uuid_is_null*(3),\n"
7862"*uuid_parse*(3),\n"
7863"*uuid_unparse*(3)\n"
7864msgstr ""
7865
7866#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
7867#
7868#. Redistribution and use in source and binary forms, with or without
7869#. modification, are permitted provided that the following conditions
7870#. are met:
7871#. 1. Redistributions of source code must retain the above copyright
7872#. notice, and the entire permission notice in its entirety,
7873#. including the disclaimer of warranties.
7874#. 2. Redistributions in binary form must reproduce the above copyright
7875#. notice, this list of conditions and the following disclaimer in the
7876#. documentation and/or other materials provided with the distribution.
7877#. 3. The name of the author may not be used to endorse or promote
7878#. products derived from this software without specific prior
7879#. written permission.
7880#
7881#. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
7882#. WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7883#. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
7884#. WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
7885#. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7886#. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
7887#. OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
7888#. BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
7889#. LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
7890#. (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
7891#. USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
7892#. DAMAGE.
7893#
7894#. Created Wed Mar 10 17:42:12 1999, Andreas Dilger
7895#. type: Title =
7896#: ../libuuid/man/uuid_unparse.3.adoc:33
7897#, no-wrap
7898msgid "uuid_unparse(3)"
7899msgstr ""
7900
7901#. type: Plain text
7902#: ../libuuid/man/uuid_unparse.3.adoc:44
7903msgid "uuid_unparse - convert a UUID from binary representation to a string"
7904msgstr ""
7905
7906#. type: Plain text
7907#: ../libuuid/man/uuid_unparse.3.adoc:52
7908#, no-wrap
7909msgid ""
7910"*void uuid_unparse(uuid_t __uu__, char *__out__);* +\n"
7911"*void uuid_unparse_upper(uuid_t __uu__, char *__out__);* +\n"
7912"*void uuid_unparse_lower(uuid_t __uu__, char *__out__);*\n"
7913msgstr ""
7914
7915#. type: Plain text
7916#: ../libuuid/man/uuid_unparse.3.adoc:56
7917msgid ""
7918"The *uuid_unparse*() function converts the supplied UUID _uu_ from the "
7919"binary representation into a 36-byte string (plus trailing '\\0') of the "
7920"form 1b4e28ba-2fa1-11d2-883f-0016d3cca427 and stores this value in the "
7921"character string pointed to by _out_. The case of the hex digits returned by "
7922"*uuid_unparse*() may be upper or lower case, and is dependent on the "
7923"system-dependent local default."
7924msgstr ""
7925
7926#. type: Plain text
7927#: ../libuuid/man/uuid_unparse.3.adoc:58
7928msgid ""
7929"If the case of the hex digits is important then the functions "
7930"*uuid_unparse_upper*() and *uuid_unparse_lower*() may be used."
7931msgstr ""
7932
7933#. type: Plain text
7934#: ../libuuid/man/uuid_unparse.3.adoc:62
7935msgid "This library unparses UUIDs compatible with OSF DCE 1.1."
7936msgstr ""
7937
7938#. type: Plain text
7939#: ../libuuid/man/uuid_unparse.3.adoc:77
7940#, no-wrap
7941msgid ""
7942"*uuid*(3),\n"
7943"*uuid_clear*(3),\n"
7944"*uuid_compare*(3),\n"
7945"*uuid_copy*(3),\n"
7946"*uuid_generate*(3),\n"
7947"*uuid_time*(3),\n"
7948"*uuid_is_null*(3),\n"
7949"*uuid_parse*(3)\n"
7950msgstr ""
7951
7952#. chfn.1 -- change your finger information
7953#. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
7954#
7955#. This program is free software. You can redistribute it and
7956#. modify it under the terms of the GNU General Public License.
7957#. There is no warranty.
7958#. type: Title =
7959#: ../login-utils/chfn.1.adoc:10
7960#, no-wrap
7961msgid "chfn(1)"
7962msgstr ""
7963
7964#. type: Attribute :man manual:
7965#: ../login-utils/chfn.1.adoc:12 ../login-utils/chsh.1.adoc:12
7966#: ../login-utils/last.1.adoc:21 ../login-utils/login.1.adoc:8
7967#: ../login-utils/lslogins.1.adoc:6 ../login-utils/newgrp.1.adoc:6
7968#: ../login-utils/runuser.1.adoc:4 ../login-utils/su.1.adoc:4
7969#: ../login-utils/utmpdump.1.adoc:21 ../misc-utils/cal.1.adoc:41
7970#: ../misc-utils/fincore.1.adoc:9 ../misc-utils/getopt.1.adoc:4
7971#: ../misc-utils/hardlink.1.adoc:10 ../misc-utils/kill.1.adoc:9
7972#: ../misc-utils/logger.1.adoc:38 ../misc-utils/look.1.adoc:38
7973#: ../misc-utils/mcookie.1.adoc:6 ../misc-utils/namei.1.adoc:4
7974#: ../misc-utils/rename.1.adoc:6 ../misc-utils/uuidgen.1.adoc:8
7975#: ../misc-utils/uuidparse.1.adoc:6 ../misc-utils/whereis.1.adoc:38
7976#: ../schedutils/chrt.1.adoc:28 ../schedutils/ionice.1.adoc:4
7977#: ../schedutils/taskset.1.adoc:26 ../schedutils/uclampset.1.adoc:28
7978#: ../sys-utils/choom.1.adoc:4 ../sys-utils/dmesg.1.adoc:8
7979#: ../sys-utils/eject.1.adoc:12 ../sys-utils/fallocate.1.adoc:4
7980#: ../sys-utils/flock.1.adoc:28 ../sys-utils/ipcmk.1.adoc:8
7981#: ../sys-utils/ipcrm.1.adoc:8 ../sys-utils/ipcs.1.adoc:8
7982#: ../sys-utils/irqtop.1.adoc:4 ../sys-utils/lscpu.1.adoc:4
7983#: ../sys-utils/lsipc.1.adoc:4 ../sys-utils/lsirq.1.adoc:4
7984#: ../sys-utils/lsmem.1.adoc:4 ../sys-utils/mountpoint.1.adoc:4
7985#: ../sys-utils/nsenter.1.adoc:4 ../sys-utils/prlimit.1.adoc:9
7986#: ../sys-utils/renice.1.adoc:38 ../sys-utils/setpriv.1.adoc:4
7987#: ../sys-utils/setsid.1.adoc:6 ../sys-utils/unshare.1.adoc:4
7988#: ../term-utils/mesg.1.adoc:38 ../term-utils/script.1.adoc:38
7989#: ../term-utils/scriptlive.1.adoc:4 ../term-utils/scriptreplay.1.adoc:4
7990#: ../term-utils/setterm.1.adoc:11 ../term-utils/wall.1.adoc:39
7991#: ../term-utils/write.1.adoc:41 ../text-utils/col.1.adoc:41
7992#: ../text-utils/colcrt.1.adoc:38 ../text-utils/colrm.1.adoc:38
7993#: ../text-utils/column.1.adoc:38 ../text-utils/hexdump.1.adoc:38
7994#: ../text-utils/line.1.adoc:5 ../text-utils/more.1.adoc:41
7995#: ../text-utils/pg.1.adoc:5 ../text-utils/rev.1.adoc:38
7996#: ../text-utils/ul.1.adoc:38
7997#, no-wrap
7998msgid "User Commands"
7999msgstr ""
8000
8001#. type: Plain text
8002#: ../login-utils/chfn.1.adoc:20
8003msgid "chfn - change your finger information"
8004msgstr ""
8005
8006#. type: Plain text
8007#: ../login-utils/chfn.1.adoc:24
8008#, no-wrap
8009msgid ""
8010"*chfn* [*-f* _full-name_] [*-o* _office_] [*-p* _office-phone_] [*-h* "
8011"_home-phone_] [*-u*] [*-v*] [_username_]\n"
8012msgstr ""
8013
8014#. type: Plain text
8015#: ../login-utils/chfn.1.adoc:28
8016#, no-wrap
8017msgid ""
8018"*chfn* is used to change your finger information. This information is stored "
8019"in the _/etc/passwd_ file, and is displayed by the *finger* program. The "
8020"Linux *finger* command will display four pieces of information that can be "
8021"changed by *chfn*: your real name, your work room and phone, and your home "
8022"phone.\n"
8023msgstr ""
8024
8025#. type: Plain text
8026#: ../login-utils/chfn.1.adoc:30
8027msgid ""
8028"Any of the four pieces of information can be specified on the command "
8029"line. If no information is given on the command line, *chfn* enters "
8030"interactive mode."
8031msgstr ""
8032
8033#. type: Plain text
8034#: ../login-utils/chfn.1.adoc:32
8035msgid ""
8036"In interactive mode, *chfn* will prompt for each field. At a prompt, you can "
8037"enter the new information, or just press return to leave the field "
8038"unchanged. Enter the keyword \"none\" to make the field blank."
8039msgstr ""
8040
8041#. type: Plain text
8042#: ../login-utils/chfn.1.adoc:34
8043#, no-wrap
8044msgid ""
8045"*chfn* supports non-local entries (kerberos, LDAP, etc.) if linked with "
8046"libuser, otherwise use *ypchfn*(1), *lchfn*(1) or any other implementation "
8047"for non-local entries.\n"
8048msgstr ""
8049
8050#. type: Labeled list
8051#: ../login-utils/chfn.1.adoc:37
8052#, no-wrap
8053msgid "*-f*, *--full-name* _full-name_"
8054msgstr ""
8055
8056#. type: Plain text
8057#: ../login-utils/chfn.1.adoc:39
8058msgid "Specify your real name."
8059msgstr ""
8060
8061#. type: Labeled list
8062#: ../login-utils/chfn.1.adoc:40
8063#, no-wrap
8064msgid "*-o*, *--office* _office_"
8065msgstr ""
8066
8067#. type: Plain text
8068#: ../login-utils/chfn.1.adoc:42
8069msgid "Specify your office room number."
8070msgstr ""
8071
8072#. type: Labeled list
8073#: ../login-utils/chfn.1.adoc:43
8074#, no-wrap
8075msgid "*-p*, *--office-phone* _office-phone_"
8076msgstr ""
8077
8078#. type: Plain text
8079#: ../login-utils/chfn.1.adoc:45
8080msgid "Specify your office phone number."
8081msgstr ""
8082
8083#. type: Labeled list
8084#: ../login-utils/chfn.1.adoc:46
8085#, no-wrap
8086msgid "*-h*, *--home-phone* _home-phone_"
8087msgstr ""
8088
8089#. type: Plain text
8090#: ../login-utils/chfn.1.adoc:48
8091msgid "Specify your home phone number."
8092msgstr ""
8093
8094#. type: Labeled list
8095#: ../login-utils/chfn.1.adoc:49
8096#, no-wrap
8097msgid "*-u*, *--help*"
8098msgstr ""
8099
8100#. type: Title ==
8101#: ../login-utils/chfn.1.adoc:55 ../login-utils/login.1.adoc:59
8102#, no-wrap
8103msgid "CONFIG FILE ITEMS"
8104msgstr ""
8105
8106#. type: Plain text
8107#: ../login-utils/chfn.1.adoc:58
8108#, no-wrap
8109msgid ""
8110"*chfn* reads the _/etc/login.defs_ configuration file (see "
8111"*login.defs*(5)). Note that the configuration file could be distributed with "
8112"another package (e.g., shadow-utils). The following configuration items are "
8113"relevant for *chfn*:\n"
8114msgstr ""
8115
8116#. type: Labeled list
8117#: ../login-utils/chfn.1.adoc:59
8118#, no-wrap
8119msgid "*CHFN_RESTRICT* _string_"
8120msgstr ""
8121
8122#. type: Plain text
8123#: ../login-utils/chfn.1.adoc:62
8124msgid "Indicate which fields are changeable by *chfn*."
8125msgstr ""
8126
8127#. type: Plain text
8128#: ../login-utils/chfn.1.adoc:64
8129msgid ""
8130"The boolean setting *\"yes\"* means that only the Office, Office Phone and "
8131"Home Phone fields are changeable, and boolean setting *\"no\"* means that "
8132"also the Full Name is changeable."
8133msgstr ""
8134
8135#. type: Plain text
8136#: ../login-utils/chfn.1.adoc:66
8137msgid ""
8138"Another way to specify changeable fields is by abbreviations: f = Full Name, "
8139"r = Office (room), w = Office (work) Phone, h = Home Phone. For example, "
8140"*CHFN_RESTRICT \"wh\"* allows changing work and home phone numbers."
8141msgstr ""
8142
8143#. type: Plain text
8144#: ../login-utils/chfn.1.adoc:68
8145msgid ""
8146"If *CHFN_RESTRICT* is undefined, then all finger information is "
8147"read-only. This is the default."
8148msgstr ""
8149
8150#. type: Plain text
8151#: ../login-utils/chfn.1.adoc:72 ../login-utils/chsh.1.adoc:54
8152#: ../sys-utils/eject.1.adoc:100
8153msgid ""
8154"Returns 0 if operation was successful, 1 if operation failed or command "
8155"syntax was not valid."
8156msgstr ""
8157
8158#. type: Plain text
8159#: ../login-utils/chfn.1.adoc:76 ../login-utils/chsh.1.adoc:58
8160msgid "mailto:svalente@mit.edu[Salvatore Valente]"
8161msgstr ""
8162
8163#. type: Plain text
8164#: ../login-utils/chfn.1.adoc:83
8165#, no-wrap
8166msgid ""
8167"*chsh*(1),\n"
8168"*finger*(1),\n"
8169"*login.defs*(5),\n"
8170"*passwd*(5)\n"
8171msgstr ""
8172
8173#. chsh.1 -- change your login shell
8174#. (c) 1994 by salvatore valente <svalente@athena.mit.edu>
8175#
8176#. This program is free software. You can redistribute it and
8177#. modify it under the terms of the GNU General Public License.
8178#. There is no warranty.
8179#. type: Title =
8180#: ../login-utils/chsh.1.adoc:10
8181#, no-wrap
8182msgid "chsh(1)"
8183msgstr ""
8184
8185#. type: Plain text
8186#: ../login-utils/chsh.1.adoc:20
8187msgid "chsh - change your login shell"
8188msgstr ""
8189
8190#. type: Plain text
8191#: ../login-utils/chsh.1.adoc:24
8192#, no-wrap
8193msgid "*chsh* [*-s* _shell_] [*-l*] [*-h*] [*-v*] [_username_]\n"
8194msgstr ""
8195
8196#. type: Plain text
8197#: ../login-utils/chsh.1.adoc:28
8198#, no-wrap
8199msgid ""
8200"*chsh* is used to change your login shell. If a shell is not given on the "
8201"command line, *chsh* prompts for one.\n"
8202msgstr ""
8203
8204#. type: Plain text
8205#: ../login-utils/chsh.1.adoc:30
8206#, no-wrap
8207msgid ""
8208"*chsh* supports non-local entries (kerberos, LDAP, etc.) if linked with "
8209"libuser, otherwise use *ypchsh*(1), *lchsh*(1) or any other implementation "
8210"for non-local entries.\n"
8211msgstr ""
8212
8213#. type: Labeled list
8214#: ../login-utils/chsh.1.adoc:33 ../misc-utils/getopt.1.adoc:54
8215#, no-wrap
8216msgid "*-s*, *--shell* _shell_"
8217msgstr ""
8218
8219#. type: Plain text
8220#: ../login-utils/chsh.1.adoc:35
8221msgid "Specify your login shell."
8222msgstr ""
8223
8224#. type: Labeled list
8225#: ../login-utils/chsh.1.adoc:36
8226#, no-wrap
8227msgid "*-l*, *--list-shells*"
8228msgstr ""
8229
8230#. type: Plain text
8231#: ../login-utils/chsh.1.adoc:38
8232msgid "Print the list of shells listed in _/etc/shells_ and exit."
8233msgstr ""
8234
8235#. type: Title ==
8236#: ../login-utils/chsh.1.adoc:45
8237#, no-wrap
8238msgid "VALID SHELLS"
8239msgstr ""
8240
8241#. type: Plain text
8242#: ../login-utils/chsh.1.adoc:48
8243#, no-wrap
8244msgid "*chsh* will accept the full pathname of any executable file on the system.\n"
8245msgstr ""
8246
8247#. type: Plain text
8248#: ../login-utils/chsh.1.adoc:50
8249msgid ""
8250"The default behavior for non-root users is to accept only shells listed in "
8251"the _/etc/shells_ file, and issue a warning for root user. It can also be "
8252"configured at compile-time to only issue a warning for all users."
8253msgstr ""
8254
8255#. type: Plain text
8256#: ../login-utils/chsh.1.adoc:65
8257#, no-wrap
8258msgid ""
8259"*login*(1),\n"
8260"*login.defs*(5),\n"
8261"*passwd*(5),\n"
8262"*shells*(5)\n"
8263msgstr ""
8264
8265#. Copyright (C) 1998-2004 Miquel van Smoorenburg.
8266#
8267#. This program is free software; you can redistribute it and/or modify
8268#. it under the terms of the GNU General Public License as published by
8269#. the Free Software Foundation; either version 2 of the License, or
8270#. (at your option) any later version.
8271#
8272#. This program is distributed in the hope that it will be useful,
8273#. but WITHOUT ANY WARRANTY; without even the implied warranty of
8274#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8275#. GNU General Public License for more details.
8276#
8277#. You should have received a copy of the GNU General Public License
8278#. along with this program; if not, write to the Free Software
8279#. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8280#. type: Title =
8281#: ../login-utils/last.1.adoc:19
8282#, no-wrap
8283msgid "last(1)"
8284msgstr ""
8285
8286#. type: Plain text
8287#: ../login-utils/last.1.adoc:29
8288msgid "last, lastb - show a listing of last logged in users"
8289msgstr ""
8290
8291#. type: Plain text
8292#: ../login-utils/last.1.adoc:33
8293#, no-wrap
8294msgid "*last* [options] [_username_...] [_tty_...]\n"
8295msgstr ""
8296
8297#. type: Plain text
8298#: ../login-utils/last.1.adoc:35
8299#, no-wrap
8300msgid "*lastb* [options] [_username_...] [_tty_...]\n"
8301msgstr ""
8302
8303#. type: Plain text
8304#: ../login-utils/last.1.adoc:39
8305#, no-wrap
8306msgid ""
8307"*last* searches back through the _/var/log/wtmp_ file (or the file "
8308"designated by the *-f* option) and displays a list of all users logged in "
8309"(and out) since that file was created. One or more _usernames_ and/or _ttys_ "
8310"can be given, in which case *last* will show only the entries matching those "
8311"arguments. Names of _ttys_ can be abbreviated, thus *last 0* is the same as "
8312"*last tty0*.\n"
8313msgstr ""
8314
8315#. type: Plain text
8316#: ../login-utils/last.1.adoc:41
8317msgid ""
8318"When catching a *SIGINT* signal (generated by the interrupt key, usually "
8319"control-C) or a SIGQUIT signal, *last* will show how far it has searched "
8320"through the file; in the case of the *SIGINT* signal *last* will then "
8321"terminate."
8322msgstr ""
8323
8324#. type: Plain text
8325#: ../login-utils/last.1.adoc:43
8326msgid ""
8327"The pseudo user *reboot* logs in each time the system is rebooted. Thus "
8328"*last reboot* will show a log of all the reboots since the log file was "
8329"created."
8330msgstr ""
8331
8332#. type: Plain text
8333#: ../login-utils/last.1.adoc:45
8334#, no-wrap
8335msgid ""
8336"*lastb* is the same as *last*, except that by default it shows a log of the "
8337"_/var/log/btmp_ file, which contains all the bad login attempts.\n"
8338msgstr ""
8339
8340#. type: Labeled list
8341#: ../login-utils/last.1.adoc:48
8342#, no-wrap
8343msgid "*-a*, *--hostlast*"
8344msgstr ""
8345
8346#. type: Plain text
8347#: ../login-utils/last.1.adoc:50
8348msgid ""
8349"Display the hostname in the last column. Useful in combination with the "
8350"*--dns* option."
8351msgstr ""
8352
8353#. type: Labeled list
8354#: ../login-utils/last.1.adoc:51
8355#, no-wrap
8356msgid "*-d*, *--dns*"
8357msgstr ""
8358
8359#. type: Plain text
8360#: ../login-utils/last.1.adoc:53
8361msgid ""
8362"For non-local logins, Linux stores not only the host name of the remote "
8363"host, but its IP number as well. This option translates the IP number back "
8364"into a hostname."
8365msgstr ""
8366
8367#. type: Labeled list
8368#: ../login-utils/last.1.adoc:54 ../misc-utils/logger.1.adoc:67
8369#: ../misc-utils/mcookie.1.adoc:31
8370#, no-wrap
8371msgid "*-f*, *--file* _file_"
8372msgstr ""
8373
8374#. type: Plain text
8375#: ../login-utils/last.1.adoc:56
8376msgid ""
8377"Tell *last* to use a specific _file_ instead of _/var/log/wtmp_. The "
8378"*--file* option can be given multiple times, and all of the specified files "
8379"will be processed."
8380msgstr ""
8381
8382#. type: Labeled list
8383#: ../login-utils/last.1.adoc:57
8384#, no-wrap
8385msgid "*-F*, *--fulltimes*"
8386msgstr ""
8387
8388#. type: Plain text
8389#: ../login-utils/last.1.adoc:59
8390msgid "Print full login and logout times and dates."
8391msgstr ""
8392
8393#. type: Labeled list
8394#: ../login-utils/last.1.adoc:60
8395#, no-wrap
8396msgid "*-i*, *--ip*"
8397msgstr ""
8398
8399#. type: Plain text
8400#: ../login-utils/last.1.adoc:62
8401msgid "Like *--dns ,* but displays the host's IP number instead of the name."
8402msgstr ""
8403
8404#. type: Labeled list
8405#: ../login-utils/last.1.adoc:63
8406#, no-wrap
8407msgid "**-**__number__; *-n*, *--limit* _number_"
8408msgstr ""
8409
8410#. type: Plain text
8411#: ../login-utils/last.1.adoc:65
8412msgid "Tell *last* how many lines to show."
8413msgstr ""
8414
8415#. type: Labeled list
8416#: ../login-utils/last.1.adoc:66
8417#, no-wrap
8418msgid "*-p*, *--present* _time_"
8419msgstr ""
8420
8421#. type: Plain text
8422#: ../login-utils/last.1.adoc:68
8423msgid ""
8424"Display the users who were present at the specified time. This is like using "
8425"the options *--since* and *--until* together with the same _time_."
8426msgstr ""
8427
8428#. type: Labeled list
8429#: ../login-utils/last.1.adoc:69
8430#, no-wrap
8431msgid "*-R*, *--nohostname*"
8432msgstr ""
8433
8434#. type: Plain text
8435#: ../login-utils/last.1.adoc:71
8436msgid "Suppresses the display of the hostname field."
8437msgstr ""
8438
8439#. type: Labeled list
8440#: ../login-utils/last.1.adoc:72
8441#, no-wrap
8442msgid "*-s*, *--since* _time_"
8443msgstr ""
8444
8445#. type: Plain text
8446#: ../login-utils/last.1.adoc:74
8447msgid ""
8448"Display the state of logins since the specified _time_. This is useful, "
8449"e.g., to easily determine who was logged in at a particular time. The option "
8450"is often combined with *--until*."
8451msgstr ""
8452
8453#. type: Labeled list
8454#: ../login-utils/last.1.adoc:75
8455#, no-wrap
8456msgid "*-t*, *--until* _time_"
8457msgstr ""
8458
8459#. type: Plain text
8460#: ../login-utils/last.1.adoc:77
8461msgid "Display the state of logins until the specified _time_."
8462msgstr ""
8463
8464#. type: Labeled list
8465#: ../login-utils/last.1.adoc:78 ../sys-utils/dmesg.1.adoc:124
8466#, no-wrap
8467msgid "*--time-format* _format_"
8468msgstr ""
8469
8470#. type: Plain text
8471#: ../login-utils/last.1.adoc:80
8472msgid ""
8473"Define the output timestamp _format_ to be one of _notime_, _short_, _full_, "
8474"or _iso_. The _notime_ variant will not print any timestamps at all, _short_ "
8475"is the default, and _full_ is the same as the *--fulltimes* option. The "
8476"_iso_ variant will display the timestamp in ISO-8601 format. The ISO format "
8477"contains timezone information, making it preferable when printouts are "
8478"investigated outside of the system."
8479msgstr ""
8480
8481#. type: Labeled list
8482#: ../login-utils/last.1.adoc:81
8483#, no-wrap
8484msgid "*-w*, *--fullnames*"
8485msgstr ""
8486
8487#. type: Plain text
8488#: ../login-utils/last.1.adoc:83
8489msgid "Display full user names and domain names in the output."
8490msgstr ""
8491
8492#. type: Labeled list
8493#: ../login-utils/last.1.adoc:84
8494#, no-wrap
8495msgid "*-x*, *--system*"
8496msgstr ""
8497
8498#. type: Plain text
8499#: ../login-utils/last.1.adoc:86
8500msgid "Display the system shutdown entries and run level changes."
8501msgstr ""
8502
8503#. type: Title ==
8504#: ../login-utils/last.1.adoc:87
8505#, no-wrap
8506msgid "TIME FORMATS"
8507msgstr ""
8508
8509#. type: Plain text
8510#: ../login-utils/last.1.adoc:90
8511msgid "The options that take the _time_ argument understand the following formats:"
8512msgstr ""
8513
8514#. type: Table
8515#: ../login-utils/last.1.adoc:105
8516#, no-wrap
8517msgid ""
8518"|YYYYMMDDhhmmss |\n"
8519"|YYYY-MM-DD hh:mm:ss |\n"
8520"|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
8521"|YYYY-MM-DD |(time will be set to 00:00:00)\n"
8522"|hh:mm:ss |(date will be set to today)\n"
8523"|hh:mm |(date will be set to today, seconds to 00)\n"
8524"|now |\n"
8525"|yesterday |(time is set to 00:00:00)\n"
8526"|today |(time is set to 00:00:00)\n"
8527"|tomorrow |(time is set to 00:00:00)\n"
8528"|+5min |\n"
8529"|-5days |\n"
8530msgstr ""
8531
8532#. type: Plain text
8533#: ../login-utils/last.1.adoc:111
8534msgid "_/var/log/wtmp_, _/var/log/btmp_"
8535msgstr ""
8536
8537#. type: Plain text
8538#: ../login-utils/last.1.adoc:115
8539msgid ""
8540"The files _wtmp_ and _btmp_ might not be found. The system only logs "
8541"information in these files if they are present. This is a local "
8542"configuration issue. If you want the files to be used, they can be created "
8543"with a simple *touch*(1) command (for example, *touch /var/log/wtmp*)."
8544msgstr ""
8545
8546#. type: Plain text
8547#: ../login-utils/last.1.adoc:119
8548msgid "mailto:miquels@cistron.nl[Miquel van Smoorenburg]"
8549msgstr ""
8550
8551#. type: Plain text
8552#: ../login-utils/last.1.adoc:126
8553#, no-wrap
8554msgid ""
8555"*login*(1),\n"
8556"*wtmp*(5),\n"
8557"*init*(8),\n"
8558"*shutdown*(8)\n"
8559msgstr ""
8560
8561#. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
8562#. May be distributed under the GNU General Public License
8563#. type: Title =
8564#: ../login-utils/login.1.adoc:6
8565#, no-wrap
8566msgid "login(1)"
8567msgstr ""
8568
8569#. type: Plain text
8570#: ../login-utils/login.1.adoc:16
8571msgid "login - begin session on the system"
8572msgstr ""
8573
8574#. type: Plain text
8575#: ../login-utils/login.1.adoc:20
8576#, no-wrap
8577msgid "*login* [*-p*] [*-h* _host_] [*-H*] [*-f* _username_|_username_]\n"
8578msgstr ""
8579
8580#. type: Plain text
8581#: ../login-utils/login.1.adoc:24
8582#, no-wrap
8583msgid ""
8584"*login* is used when signing onto a system. If no argument is given, *login* "
8585"prompts for the username.\n"
8586msgstr ""
8587
8588#. type: Plain text
8589#: ../login-utils/login.1.adoc:26
8590msgid ""
8591"The user is then prompted for a password, where appropriate. Echoing is "
8592"disabled to prevent revealing the password. Only a number of password "
8593"failures are permitted before *login* exits and the communications link is "
8594"severed. See *LOGIN_RETRIES* in CONFIG FILE ITEMS section."
8595msgstr ""
8596
8597#. type: Plain text
8598#: ../login-utils/login.1.adoc:28
8599msgid ""
8600"If password aging has been enabled for the account, the user may be prompted "
8601"for a new password before proceeding. In such case old password must be "
8602"provided and the new password entered before continuing. Please refer to "
8603"*passwd*(1) for more information."
8604msgstr ""
8605
8606#. type: Plain text
8607#: ../login-utils/login.1.adoc:30
8608msgid ""
8609"The user and group ID will be set according to their values in the "
8610"_/etc/passwd_ file. There is one exception if the user ID is zero. In this "
8611"case, only the primary group ID of the account is set. This should allow the "
8612"system administrator to login even in case of network problems. The "
8613"environment variable values for *$HOME*, *$USER*, *$SHELL*, *$PATH*, "
8614"*$LOGNAME*, and *$MAIL* are set according to the appropriate fields in the "
8615"password entry. *$PATH* defaults to _/usr/local/bin:/bin:/usr/bin_ for "
8616"normal users, and to "
8617"_/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_ for root, if "
8618"not otherwise configured."
8619msgstr ""
8620
8621#. type: Plain text
8622#: ../login-utils/login.1.adoc:32
8623msgid ""
8624"The environment variable *$TERM* will be preserved, if it exists, else it "
8625"will be initialized to the terminal type on your tty. Other environment "
8626"variables are preserved if the *-p* option is given."
8627msgstr ""
8628
8629#. type: Plain text
8630#: ../login-utils/login.1.adoc:34
8631msgid ""
8632"Then the user's shell is started. If no shell is specified for the user in "
8633"_/etc/passwd_, then _/bin/sh_ is used. If there is no home directory "
8634"specified in _/etc/passwd_, then _/_ is used, followed by _.hushlogin_ check "
8635"as described below."
8636msgstr ""
8637
8638#. type: Plain text
8639#: ../login-utils/login.1.adoc:36
8640msgid ""
8641"If the file _.hushlogin_ exists, then a \"quiet\" login is performed. This "
8642"disables the checking of mail and the printing of the last login time and "
8643"message of the day. Otherwise, if _/var/log/lastlog_ exists, the last login "
8644"time is printed, and the current login is recorded."
8645msgstr ""
8646
8647#. type: Plain text
8648#: ../login-utils/login.1.adoc:41
8649msgid "Used by *getty*(8) to tell *login* to preserve the environment."
8650msgstr ""
8651
8652#. type: Labeled list
8653#: ../login-utils/login.1.adoc:42 ../misc-utils/whereis.1.adoc:94
8654#: ../text-utils/pg.1.adoc:45
8655#, no-wrap
8656msgid "*-f*"
8657msgstr ""
8658
8659#. type: Plain text
8660#: ../login-utils/login.1.adoc:44
8661msgid ""
8662"Used to skip a login authentication. This option is usually used by the "
8663"*getty*(8) autologin feature."
8664msgstr ""
8665
8666#. type: Labeled list
8667#: ../login-utils/login.1.adoc:45
8668#, no-wrap
8669msgid "*-h*"
8670msgstr ""
8671
8672#. type: Plain text
8673#: ../login-utils/login.1.adoc:47
8674msgid ""
8675"Used by other servers (such as *telnetd*(8) to pass the name of the remote "
8676"host to *login* so that it can be placed in utmp and wtmp. Only the "
8677"superuser is allowed use this option."
8678msgstr ""
8679
8680#. type: Plain text
8681#: ../login-utils/login.1.adoc:49
8682msgid ""
8683"Note that the *-h* option has an impact on the *PAM service* *name*. The "
8684"standard service name is _login_, but with the *-h* option, the name is "
8685"_remote_. It is necessary to create proper PAM config files (for example, "
8686"_/etc/pam.d/login_ and _/etc/pam.d/remote_)."
8687msgstr ""
8688
8689#. type: Labeled list
8690#: ../login-utils/login.1.adoc:50
8691#, no-wrap
8692msgid "*-H*"
8693msgstr ""
8694
8695#. type: Plain text
8696#: ../login-utils/login.1.adoc:52
8697msgid ""
8698"Used by other servers (for example, *telnetd*(8)) to tell *login* that "
8699"printing the hostname should be suppressed in the login: prompt. See also "
8700"*LOGIN_PLAIN_PROMPT* below."
8701msgstr ""
8702
8703#. type: Labeled list
8704#: ../login-utils/login.1.adoc:53 ../sys-utils/rfkill.8.adoc:42
8705#: ../term-utils/agetty.8.adoc:186 ../term-utils/setterm.1.adoc:160
8706#: ../text-utils/more.1.adoc:95
8707#, no-wrap
8708msgid "*--help*"
8709msgstr ""
8710
8711#. type: Plain text
8712#: ../login-utils/login.1.adoc:62
8713#, no-wrap
8714msgid ""
8715"*login* reads the _/etc/login.defs_ configuration file (see "
8716"login.defs(5)). Note that the configuration file could be distributed with "
8717"another package (usually shadow-utils). The following configuration items "
8718"are relevant for *login*:\n"
8719msgstr ""
8720
8721#. type: Labeled list
8722#: ../login-utils/login.1.adoc:63
8723#, no-wrap
8724msgid "*MOTD_FILE* (string)"
8725msgstr ""
8726
8727#. type: Plain text
8728#: ../login-utils/login.1.adoc:65
8729msgid ""
8730"Specifies a \":\" delimited list of \"message of the day\" files and "
8731"directories to be displayed upon login. If the specified path is a directory "
8732"then displays all files with .motd file extension in version-sort order from "
8733"the directory."
8734msgstr ""
8735
8736#. type: Plain text
8737#: ../login-utils/login.1.adoc:67
8738msgid ""
8739"The default value is _/usr/share/misc/motd:/run/motd:/etc/motd_. If the "
8740"*MOTD_FILE* item is empty or a quiet login is enabled, then the message of "
8741"the day is not displayed. Note that the same functionality is also provided "
8742"by the *pam_motd*(8) PAM module."
8743msgstr ""
8744
8745#. type: Plain text
8746#: ../login-utils/login.1.adoc:69
8747msgid "The directories in the *MOTD_FILE* are supported since version 2.36."
8748msgstr ""
8749
8750#. type: Plain text
8751#: ../login-utils/login.1.adoc:71
8752msgid ""
8753"Note that *login* does not implement any filenames overriding behavior like "
8754"pam_motd (see also *MOTD_FIRSTONLY*), but all content from all files is "
8755"displayed. It is recommended to keep extra logic in content generators and "
8756"use _/run/motd.d_ rather than rely on overriding behavior hardcoded in "
8757"system tools."
8758msgstr ""
8759
8760#. type: Labeled list
8761#: ../login-utils/login.1.adoc:72
8762#, no-wrap
8763msgid "*MOTD_FIRSTONLY* (boolean)"
8764msgstr ""
8765
8766#. type: Plain text
8767#: ../login-utils/login.1.adoc:75
8768msgid ""
8769"Forces *login* to stop display content specified by *MOTD_FILE* after the "
8770"first accessible item in the list. Note that a directory is one item in this "
8771"case. This option allows *login* semantics to be configured to be more "
8772"compatible with pam_motd. The default value is _no_."
8773msgstr ""
8774
8775#. type: Labeled list
8776#: ../login-utils/login.1.adoc:76
8777#, no-wrap
8778msgid "*LOGIN_PLAIN_PROMPT* (boolean)"
8779msgstr ""
8780
8781#. type: Plain text
8782#: ../login-utils/login.1.adoc:79
8783msgid ""
8784"Tell *login* that printing the hostname should be suppressed in the login: "
8785"prompt. This is an alternative to the *-H* command line option. The default "
8786"value is _no_."
8787msgstr ""
8788
8789#. type: Labeled list
8790#: ../login-utils/login.1.adoc:80
8791#, no-wrap
8792msgid "*LOGIN_TIMEOUT* (number)"
8793msgstr ""
8794
8795#. type: Plain text
8796#: ../login-utils/login.1.adoc:83
8797msgid "Maximum time in seconds for login. The default value is _60_."
8798msgstr ""
8799
8800#. type: Labeled list
8801#: ../login-utils/login.1.adoc:84
8802#, no-wrap
8803msgid "*LOGIN_RETRIES* (number)"
8804msgstr ""
8805
8806#. type: Plain text
8807#: ../login-utils/login.1.adoc:87
8808msgid ""
8809"Maximum number of login retries in case of a bad password. The default value "
8810"is _3_."
8811msgstr ""
8812
8813#. type: Labeled list
8814#: ../login-utils/login.1.adoc:88
8815#, no-wrap
8816msgid "*LOGIN_KEEP_USERNAME* (boolean)"
8817msgstr ""
8818
8819#. type: Plain text
8820#: ../login-utils/login.1.adoc:91
8821msgid ""
8822"Tell *login* to only re-prompt for the password if authentication failed, "
8823"but the username is valid. The default value is _no_."
8824msgstr ""
8825
8826#. type: Labeled list
8827#: ../login-utils/login.1.adoc:92 ../login-utils/su.1.adoc:91
8828#, no-wrap
8829msgid "*FAIL_DELAY* (number)"
8830msgstr ""
8831
8832#. type: Plain text
8833#: ../login-utils/login.1.adoc:95
8834msgid ""
8835"Delay in seconds before being allowed another three tries after a login "
8836"failure. The default value is _5_."
8837msgstr ""
8838
8839#. type: Labeled list
8840#: ../login-utils/login.1.adoc:96
8841#, no-wrap
8842msgid "*TTYPERM* (string)"
8843msgstr ""
8844
8845#. type: Plain text
8846#: ../login-utils/login.1.adoc:99
8847msgid ""
8848"The terminal permissions. The default value is _0600_ or _0620_ if tty group "
8849"is used."
8850msgstr ""
8851
8852#. type: Labeled list
8853#: ../login-utils/login.1.adoc:100
8854#, no-wrap
8855msgid "*TTYGROUP* (string)"
8856msgstr ""
8857
8858#. type: Plain text
8859#: ../login-utils/login.1.adoc:103
8860msgid ""
8861"The login tty will be owned by the *TTYGROUP*. The default value is "
8862"_tty_. If the *TTYGROUP* does not exist, then the ownership of the terminal "
5db1d29a 8863"is set to the user's primary group."
36e96905
MB
8864msgstr ""
8865
8866#. type: Plain text
8867#: ../login-utils/login.1.adoc:105
8868msgid ""
8869"The *TTYGROUP* can be either the name of a group or a numeric group "
8870"identifier."
8871msgstr ""
8872
8873#. type: Labeled list
8874#: ../login-utils/login.1.adoc:106
8875#, no-wrap
8876msgid "*HUSHLOGIN_FILE* (string)"
8877msgstr ""
8878
8879#. type: Plain text
8880#: ../login-utils/login.1.adoc:109
8881msgid ""
8882"If defined, this file can inhibit all the usual chatter during the login "
8883"sequence. If a full pathname (for example, _/etc/hushlogins_) is specified, "
5db1d29a 8884"then hushed mode will be enabled if the user's name or shell are found in "
36e96905
MB
8885"the file. If this global hush login file is empty then the hushed mode will "
8886"be enabled for all users."
8887msgstr ""
8888
8889#. type: Plain text
8890#: ../login-utils/login.1.adoc:111
8891msgid ""
8892"If a full pathname is not specified, then hushed mode will be enabled if the "
5db1d29a 8893"file exists in the user's home directory."
36e96905
MB
8894msgstr ""
8895
8896#. type: Plain text
8897#: ../login-utils/login.1.adoc:113
8898msgid ""
8899"The default is to check _/etc/hushlogins_ and if it does not exist then "
8900"_~/.hushlogin_."
8901msgstr ""
8902
8903#. type: Plain text
8904#: ../login-utils/login.1.adoc:115
8905msgid "If the *HUSHLOGIN_FILE* item is empty, then all the checks are disabled."
8906msgstr ""
8907
8908#. type: Labeled list
8909#: ../login-utils/login.1.adoc:116
8910#, no-wrap
8911msgid "*DEFAULT_HOME* (boolean)"
8912msgstr ""
8913
8914#. type: Plain text
8915#: ../login-utils/login.1.adoc:119
8916msgid ""
8917"Indicate if login is allowed if we cannot change directory to the home "
8918"directory. If set to _yes_, the user will login in the root (/) directory if "
8919"it is not possible to change directory to their home. The default value is "
8920"_yes_."
8921msgstr ""
8922
8923#. type: Labeled list
8924#: ../login-utils/login.1.adoc:120
8925#, no-wrap
8926msgid "*LASTLOG_UID_MAX* (unsigned number)"
8927msgstr ""
8928
8929#. type: Plain text
8930#: ../login-utils/login.1.adoc:123
8931msgid ""
8932"Highest user ID number for which the _lastlog_ entries should be updated. As "
8933"higher user IDs are usually tracked by remote user identity and "
8934"authentication services there is no need to create a huge sparse _lastlog_ "
8935"file for them. No LASTLOG_UID_MAX option present in the configuration means "
8936"that there is no user ID limit for writing _lastlog_ entries. The default "
8937"value is _ULONG_MAX_."
8938msgstr ""
8939
8940#. type: Labeled list
8941#: ../login-utils/login.1.adoc:124
8942#, no-wrap
8943msgid "*LOG_UNKFAIL_ENAB* (boolean)"
8944msgstr ""
8945
8946#. type: Plain text
8947#: ../login-utils/login.1.adoc:127
8948msgid ""
8949"Enable display of unknown usernames when login failures are recorded. The "
8950"default value is _no_."
8951msgstr ""
8952
8953#. type: Plain text
8954#: ../login-utils/login.1.adoc:129
8955msgid ""
8956"Note that logging unknown usernames may be a security issue if a user enters "
8957"their password instead of their login name."
8958msgstr ""
8959
8960#. type: Labeled list
8961#: ../login-utils/login.1.adoc:130 ../login-utils/runuser.1.adoc:87
8962#: ../login-utils/su.1.adoc:94
8963#, no-wrap
8964msgid "*ENV_PATH* (string)"
8965msgstr ""
8966
8967#. type: Plain text
8968#: ../login-utils/login.1.adoc:133
8969msgid ""
8970"If set, it will be used to define the *PATH* environment variable when a "
8971"regular user logs in. The default value is _/usr/local/bin:/bin:/usr/bin_."
8972msgstr ""
8973
8974#. type: Labeled list
8975#: ../login-utils/login.1.adoc:134 ../login-utils/runuser.1.adoc:90
8976#: ../login-utils/su.1.adoc:97
8977#, no-wrap
8978msgid "*ENV_ROOTPATH* (string)"
8979msgstr ""
8980
8981#. type: Labeled list
8982#: ../login-utils/login.1.adoc:135 ../login-utils/runuser.1.adoc:91
8983#: ../login-utils/su.1.adoc:98
8984#, no-wrap
8985msgid "*ENV_SUPATH* (string)"
8986msgstr ""
8987
8988#. type: Plain text
8989#: ../login-utils/login.1.adoc:138
8990msgid ""
8991"If set, it will be used to define the PATH environment variable when the "
8992"superuser logs in. *ENV_ROOTPATH* takes precedence. The default value is "
8993"_/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_."
8994msgstr ""
8995
8996#. type: Plain text
8997#: ../login-utils/login.1.adoc:152
8998msgid ""
8999"_/var/run/utmp_, _/var/log/wtmp_, _/var/log/lastlog_, _/var/spool/mail/*_, "
9000"_/etc/motd_, _/etc/passwd_, _/etc/nologin_, _/etc/pam.d/login_, "
9001"_/etc/pam.d/remote_, _/etc/hushlogins_, _$HOME/.hushlogin_"
9002msgstr ""
9003
9004#. type: Plain text
9005#: ../login-utils/login.1.adoc:156
9006msgid ""
9007"The undocumented BSD *-r* option is not supported. This may be required by "
9008"some *rlogind*(8) programs."
9009msgstr ""
9010
9011#. type: Plain text
9012#: ../login-utils/login.1.adoc:158
9013msgid ""
9014"A recursive login, as used to be possible in the good old days, no longer "
9015"works; for most purposes *su*(1) is a satisfactory substitute. Indeed, for "
9016"security reasons, *login* does a *vhangup*(2) system call to remove any "
9017"possible listening processes on the tty. This is to avoid password "
9018"sniffing. If one uses the command *login*, then the surrounding shell gets "
9019"killed by *vhangup*(2) because it's no longer the true owner of the "
9020"tty. This can be avoided by using *exec login* in a top-level shell or "
9021"xterm."
9022msgstr ""
9023
9024#. type: Plain text
9025#: ../login-utils/login.1.adoc:162
9026msgid ""
9027"Derived from BSD login 5.40 (5/9/89) by mailto:glad@daimi.dk[Michael Glad] "
9028"for HP-UX. Ported to Linux 0.12: mailto:poe@daimi.aau.dk[Peter "
9029"Orbaek]. Rewritten to a PAM-only version by mailto:kzak@redhat.com[Karel "
9030"Zak]"
9031msgstr ""
9032
9033#. type: Plain text
9034#: ../login-utils/login.1.adoc:174
9035#, no-wrap
9036msgid ""
9037"*mail*(1),\n"
9038"*passwd*(1),\n"
9039"*passwd*(5),\n"
9040"*utmp*(5),\n"
9041"*environ*(7),\n"
9042"*getty*(8),\n"
9043"*init*(8),\n"
9044"*lastlog*(8),\n"
9045"*shutdown*(8)\n"
9046msgstr ""
9047
9048#. Copyright 2014 Ondrej Oprala (ondrej.oprala@gmail.com)
9049#. May be distributed under the GNU General Public License
9050#. type: Title =
9051#: ../login-utils/lslogins.1.adoc:4
9052#, no-wrap
9053msgid "lslogins(1)"
9054msgstr ""
9055
9056#. type: Plain text
9057#: ../login-utils/lslogins.1.adoc:14
9058msgid "lslogins - display information about known users in the system"
9059msgstr ""
9060
9061#. type: Plain text
9062#: ../login-utils/lslogins.1.adoc:18
9063#, no-wrap
9064msgid ""
9065"*lslogins* [options] [*-s*|*-u*[=_UID_]] [*-g* _groups_] [*-l* _logins_] "
9066"[_username_]\n"
9067msgstr ""
9068
9069#. type: Plain text
9070#: ../login-utils/lslogins.1.adoc:22
9071msgid ""
9072"Examine the wtmp and btmp logs, _/etc/shadow_ (if necessary) and _/passwd_ "
9073"and output the desired data."
9074msgstr ""
9075
9076#. type: Plain text
9077#: ../login-utils/lslogins.1.adoc:24
9078msgid ""
9079"The optional argument _username_ forces *lslogins* to print all available "
9080"details about the specified user only. In this case the output format is "
9081"different than in case of *-l* or *-g* and unknown is _username_ reported as "
9082"an error."
9083msgstr ""
9084
9085#. type: Plain text
9086#: ../login-utils/lslogins.1.adoc:26
9087msgid "The default action is to list info about all the users in the system."
9088msgstr ""
9089
9090#. type: Plain text
9091#: ../login-utils/lslogins.1.adoc:30
9092msgid "Mandatory arguments to long options are mandatory for short options too."
9093msgstr ""
9094
9095#. type: Labeled list
9096#: ../login-utils/lslogins.1.adoc:31
9097#, no-wrap
9098msgid "*-a*, *--acc-expiration*"
9099msgstr ""
9100
9101#. type: Plain text
9102#: ../login-utils/lslogins.1.adoc:33
9103msgid ""
9104"Display data about the date of last password change and the account "
9105"expiration date (see *shadow*(5) for more info). (Requires root privileges.)"
9106msgstr ""
9107
9108#. type: Labeled list
9109#: ../login-utils/lslogins.1.adoc:34
9110#, no-wrap
9111msgid "*--btmp-file* _path_"
9112msgstr ""
9113
9114#. type: Plain text
9115#: ../login-utils/lslogins.1.adoc:36
9116msgid "Alternate path for btmp."
9117msgstr ""
9118
9119#. type: Labeled list
9120#: ../login-utils/lslogins.1.adoc:37
9121#, no-wrap
9122msgid "*-c*, *--colon-separate*"
9123msgstr ""
9124
9125#. type: Plain text
9126#: ../login-utils/lslogins.1.adoc:39
9127msgid "Separate info about each user with a colon instead of a newline."
9128msgstr ""
9129
9130#. type: Labeled list
9131#: ../login-utils/lslogins.1.adoc:40 ../sys-utils/lsipc.1.adoc:51
9132#, no-wrap
9133msgid "*-e*, *--export*"
9134msgstr ""
9135
9136#. type: Plain text
9137#: ../login-utils/lslogins.1.adoc:42
9138msgid "Output data in the format of NAME=VALUE."
9139msgstr ""
9140
9141#. type: Labeled list
9142#: ../login-utils/lslogins.1.adoc:43
9143#, no-wrap
9144msgid "*-f*, *--failed*"
9145msgstr ""
9146
9147#. type: Plain text
9148#: ../login-utils/lslogins.1.adoc:45
9149msgid "Display data about the users' last failed login attempts."
9150msgstr ""
9151
9152#. type: Labeled list
9153#: ../login-utils/lslogins.1.adoc:46
9154#, no-wrap
9155msgid "*-G*, *--supp-groups*"
9156msgstr ""
9157
9158#. type: Plain text
9159#: ../login-utils/lslogins.1.adoc:48
9160msgid "Show information about supplementary groups."
9161msgstr ""
9162
9163#. type: Labeled list
9164#: ../login-utils/lslogins.1.adoc:49
9165#, no-wrap
9166msgid "*-g*, **--groups**=_groups_"
9167msgstr ""
9168
9169#. type: Plain text
9170#: ../login-utils/lslogins.1.adoc:51
9171msgid ""
9172"Only show data of users belonging to _groups_. More than one group may be "
9173"specified; the list has to be comma-separated. Unknown group names are "
9174"ignored."
9175msgstr ""
9176
9177#. type: Plain text
9178#: ../login-utils/lslogins.1.adoc:53
9179msgid ""
9180"Note that relation between user and group may be invisible for primary group "
9181"if the user is not explicitly specify as group member (e.g., in "
9182"_/etc/group_). If the command *lslogins* scans for groups than it uses "
9183"groups database only, and user database with primary GID is not used at all."
9184msgstr ""
9185
9186#. type: Plain text
9187#: ../login-utils/lslogins.1.adoc:56
9188msgid "Display help information and exit."
9189msgstr ""
9190
9191#. type: Labeled list
9192#: ../login-utils/lslogins.1.adoc:57
9193#, no-wrap
9194msgid "*-L*, *--last*"
9195msgstr ""
9196
9197#. type: Plain text
9198#: ../login-utils/lslogins.1.adoc:59
9199msgid "Display data containing information about the users' last login sessions."
9200msgstr ""
9201
9202#. type: Labeled list
9203#: ../login-utils/lslogins.1.adoc:60
9204#, no-wrap
9205msgid "*-l*, **--logins**=_logins_"
9206msgstr ""
9207
9208#. type: Plain text
9209#: ../login-utils/lslogins.1.adoc:62
9210msgid ""
9211"Only show data of users with a login specified in _logins_ (user names or "
9212"user IDS). More than one login may be specified; the list has to be "
9213"comma-separated. Unknown login names are ignored."
9214msgstr ""
9215
9216#. type: Labeled list
9217#: ../login-utils/lslogins.1.adoc:63 ../sys-utils/lsipc.1.adoc:60
9218#, no-wrap
9219msgid "*-n*, *--newline*"
9220msgstr ""
9221
9222#. type: Plain text
9223#: ../login-utils/lslogins.1.adoc:65 ../sys-utils/lsipc.1.adoc:62
9224msgid "Display each piece of information on a separate line."
9225msgstr ""
9226
9227#. type: Labeled list
9228#: ../login-utils/lslogins.1.adoc:66 ../sys-utils/lsipc.1.adoc:63
9229#: ../sys-utils/prlimit.1.adoc:46 ../sys-utils/swapon.8.adoc:77
9230#, no-wrap
9231msgid "*--noheadings*"
9232msgstr ""
9233
9234#. type: Plain text
2bee5365 9235#: ../login-utils/lslogins.1.adoc:68 ../misc-utils/findmnt.8.adoc:90
36e96905
MB
9236#: ../misc-utils/lsblk.8.adoc:77 ../misc-utils/lslocks.8.adoc:47
9237#: ../misc-utils/uuidparse.1.adoc:55 ../misc-utils/wipefs.8.adoc:60
9238#: ../sys-utils/lsipc.1.adoc:65 ../sys-utils/lsmem.1.adoc:47
9239#: ../sys-utils/lsns.8.adoc:42 ../sys-utils/prlimit.1.adoc:48
9240#: ../sys-utils/rfkill.8.adoc:32
9241msgid "Do not print a header line."
9242msgstr ""
9243
9244#. type: Labeled list
9245#: ../login-utils/lslogins.1.adoc:69 ../sys-utils/lsipc.1.adoc:66
9246#, no-wrap
9247msgid "*--notruncate*"
9248msgstr ""
9249
9250#. type: Plain text
9251#: ../login-utils/lslogins.1.adoc:71 ../sys-utils/lsipc.1.adoc:68
9252msgid "Don't truncate output."
9253msgstr ""
9254
9255#. type: Plain text
9256#: ../login-utils/lslogins.1.adoc:74
9257msgid ""
9258"Specify which output columns to print. The default list of columns may be "
9259"extended if _list_ is specified in the format _+list_."
9260msgstr ""
9261
9262#. type: Plain text
9263#: ../login-utils/lslogins.1.adoc:77
9264msgid ""
9265"Output all available columns. *--help* to get a list of all supported "
9266"columns."
9267msgstr ""
9268
9269#. type: Labeled list
9270#: ../login-utils/lslogins.1.adoc:78
9271#, no-wrap
9272msgid "*-p*, *--pwd*"
9273msgstr ""
9274
9275#. type: Plain text
9276#: ../login-utils/lslogins.1.adoc:80
9277msgid "Display information related to login by password (see also *-afL).*"
9278msgstr ""
9279
9280#. type: Plain text
9281#: ../login-utils/lslogins.1.adoc:83 ../sys-utils/lsipc.1.adoc:77
9282msgid "Raw output (no columnation)."
9283msgstr ""
9284
9285#. type: Labeled list
9286#: ../login-utils/lslogins.1.adoc:84
9287#, no-wrap
9288msgid "*-s*, *--system-accs*"
9289msgstr ""
9290
9291#. type: Plain text
9292#: ../login-utils/lslogins.1.adoc:86
9293msgid ""
9b7051d5
MB
9294"Show system accounts. These are by default all accounts with a UID between "
9295"101 and 999 (inclusive), with the exception of either nobody or nfsnobody "
9296"(UID 65534). This hardcoded default may be overwritten by parameters "
9297"SYS_UID_MIN and SYS_UID_MAX in the file _/etc/login.defs_."
36e96905
MB
9298msgstr ""
9299
9300#. type: Labeled list
9301#: ../login-utils/lslogins.1.adoc:87 ../sys-utils/lsipc.1.adoc:81
9302#, no-wrap
9303msgid "*--time-format* _type_"
9304msgstr ""
9305
9306#. type: Plain text
9307#: ../login-utils/lslogins.1.adoc:89 ../sys-utils/lsipc.1.adoc:83
9308msgid ""
9309"Display dates in short, full or iso format. The default is short, this time "
9310"format is designed to be space efficient and human readable."
9311msgstr ""
9312
9313#. type: Labeled list
9314#: ../login-utils/lslogins.1.adoc:90
9315#, no-wrap
9316msgid "*-u*, *--user-accs*"
9317msgstr ""
9318
9319#. type: Plain text
9320#: ../login-utils/lslogins.1.adoc:92
9321msgid ""
9322"Show user accounts. These are by default all accounts with UID above 1000 "
9323"(inclusive), with the exception of either nobody or nfsnobody (UID "
9324"65534). This hardcoded default maybe overwritten by parameters UID_MIN and "
9325"UID_MAX in the file _/etc/login.defs_."
9326msgstr ""
9327
9328#. type: Labeled list
9329#: ../login-utils/lslogins.1.adoc:96
9330#, no-wrap
9331msgid "*--wtmp-file* _path_"
9332msgstr ""
9333
9334#. type: Plain text
9335#: ../login-utils/lslogins.1.adoc:98
9336msgid "Alternate path for wtmp."
9337msgstr ""
9338
9339#. type: Labeled list
9340#: ../login-utils/lslogins.1.adoc:99
9341#, no-wrap
9342msgid "*--lastlog* _path_"
9343msgstr ""
9344
9345#. type: Plain text
9346#: ../login-utils/lslogins.1.adoc:101
9347msgid "Alternate path for *lastlog*(8)."
9348msgstr ""
9349
9350#. type: Labeled list
9351#: ../login-utils/lslogins.1.adoc:102
9352#, no-wrap
9353msgid "*-Z*, *--context*"
9354msgstr ""
9355
9356#. type: Plain text
9357#: ../login-utils/lslogins.1.adoc:104
9358msgid "Display the users' security context."
9359msgstr ""
9360
9361#. type: Labeled list
9362#: ../login-utils/lslogins.1.adoc:105
9363#, no-wrap
9364msgid "*-z*, *--print0*"
9365msgstr ""
9366
9367#. type: Plain text
9368#: ../login-utils/lslogins.1.adoc:107
9369msgid "Delimit user entries with a nul character, instead of a newline."
9370msgstr ""
9371
9372#. type: Plain text
9373#: ../login-utils/lslogins.1.adoc:112 ../sys-utils/lsipc.1.adoc:91
9374msgid "if OK,"
9375msgstr ""
9376
9377#. type: Labeled list
9378#: ../login-utils/lslogins.1.adoc:113 ../login-utils/runuser.1.adoc:105
9379#: ../login-utils/su.1.adoc:112 ../misc-utils/lsblk.8.adoc:129
9b7051d5 9380#: ../sys-utils/fstrim.8.adoc:72 ../sys-utils/hwclock.8.adoc:289
36e96905
MB
9381#: ../sys-utils/lsipc.1.adoc:92
9382#, no-wrap
9383msgid "1"
9384msgstr ""
9385
9386#. type: Plain text
9387#: ../login-utils/lslogins.1.adoc:115 ../sys-utils/lsipc.1.adoc:94
9388msgid "if incorrect arguments specified,"
9389msgstr ""
9390
9391#. type: Labeled list
9b7051d5 9392#: ../login-utils/lslogins.1.adoc:116 ../sys-utils/hwclock.8.adoc:292
36e96905
MB
9393#: ../sys-utils/lsipc.1.adoc:95
9394#, no-wrap
9395msgid "2"
9396msgstr ""
9397
9398#. type: Plain text
9399#: ../login-utils/lslogins.1.adoc:118
9400msgid "if a serious error occurs (e.g., a corrupt log)."
9401msgstr ""
9402
9403#. type: Plain text
9404#: ../login-utils/lslogins.1.adoc:122
9405msgid "The default UID thresholds are read from _/etc/login.defs_."
9406msgstr ""
9407
9408#. type: Title ==
9409#: ../login-utils/lslogins.1.adoc:123 ../login-utils/nologin.8.adoc:63
9410#: ../login-utils/runuser.1.adoc:127 ../login-utils/su.1.adoc:141
9411#: ../login-utils/vipw.8.adoc:64 ../misc-utils/cal.1.adoc:161
9412#: ../misc-utils/look.1.adoc:94 ../sys-utils/fstab.5.adoc:131
9413#: ../sys-utils/lsipc.1.adoc:98 ../sys-utils/mount.8.adoc:1434
9414#: ../sys-utils/renice.1.adoc:86 ../sys-utils/rtcwake.8.adoc:122
9415#: ../sys-utils/swapon.8.adoc:164 ../sys-utils/umount.8.adoc:176
9416#: ../term-utils/mesg.1.adoc:95 ../term-utils/script.1.adoc:156
9417#: ../term-utils/wall.1.adoc:81 ../term-utils/write.1.adoc:80
9418#: ../text-utils/col.1.adoc:123 ../text-utils/colcrt.1.adoc:70
9419#: ../text-utils/colrm.1.adoc:67 ../text-utils/column.1.adoc:145
9420#: ../text-utils/more.1.adoc:184 ../text-utils/ul.1.adoc:76
9421#, no-wrap
9422msgid "HISTORY"
9423msgstr ""
9424
9425#. type: Plain text
9426#: ../login-utils/lslogins.1.adoc:126
9427msgid ""
9428"The *lslogins* utility is inspired by the *logins* utility, which first "
9429"appeared in FreeBSD 4.10."
9430msgstr ""
9431
9432#. type: Plain text
9433#: ../login-utils/lslogins.1.adoc:131 ../sys-utils/lsipc.1.adoc:106
9434msgid "mailto:ooprala@redhat.com[Ondrej Oprala], mailto:kzak@redhat.com[Karel Zak]"
9435msgstr ""
9436
9437#. type: Plain text
9438#: ../login-utils/lslogins.1.adoc:138
9439#, no-wrap
9440msgid ""
9441"*group*(5),\n"
9442"*passwd*(5),\n"
9443"*shadow*(5),\n"
9444"*utmp*(5)\n"
9445msgstr ""
9446
9447#. Original author unknown. This man page is in the public domain.
9448#. Modified Sat Oct 9 17:46:48 1993 by faith@cs.unc.edu
9449#. type: Title =
9450#: ../login-utils/newgrp.1.adoc:4
9451#, no-wrap
9452msgid "newgrp(1)"
9453msgstr ""
9454
9455#. type: Plain text
9456#: ../login-utils/newgrp.1.adoc:14
9457msgid "newgrp - log in to a new group"
9458msgstr ""
9459
9460#. type: Plain text
9461#: ../login-utils/newgrp.1.adoc:18
9462msgid "newgrp [_group_]"
9463msgstr ""
9464
9465#. type: Plain text
9466#: ../login-utils/newgrp.1.adoc:22
9467#, no-wrap
9468msgid ""
9469"*newgrp* changes the group identification of its caller, analogously to "
9470"*login*(1). The same person remains logged in, and the current directory is "
9471"unchanged, but calculations of access permissions to files are performed "
9472"with respect to the new group ID.\n"
9473msgstr ""
9474
9475#. type: Plain text
9476#: ../login-utils/newgrp.1.adoc:24
9477msgid "If no group is specified, the GID is changed to the login GID."
9478msgstr ""
9479
9480#. type: Plain text
9481#: ../login-utils/newgrp.1.adoc:29
9482msgid "_/etc/group_, _/etc/passwd_"
9483msgstr ""
9484
9485#. type: Plain text
9486#: ../login-utils/newgrp.1.adoc:33
9487msgid ""
9488"Originally by Michael Haardt. Currently maintained by "
9489"mailto:poe@daimi.aau.dk[Peter Orbaek]."
9490msgstr ""
9491
9492#. type: Plain text
9493#: ../login-utils/newgrp.1.adoc:38
9494#, no-wrap
9495msgid ""
9496"*login*(1),\n"
9497"*group*(5)\n"
9498msgstr ""
9499
9500#. type: Title =
9501#: ../login-utils/nologin.8.adoc:2
9502#, no-wrap
9503msgid "nologin(8)"
9504msgstr ""
9505
9506#. type: Plain text
9507#: ../login-utils/nologin.8.adoc:12
9508msgid "nologin - politely refuse a login"
9509msgstr ""
9510
9511#. type: Plain text
9512#: ../login-utils/nologin.8.adoc:16
9513#, no-wrap
9514msgid "*nologin* [*-V*] [*-h*]\n"
9515msgstr ""
9516
9517#. type: Plain text
9518#: ../login-utils/nologin.8.adoc:20
9519#, no-wrap
9520msgid ""
9521"*nologin* displays a message that an account is not available and exits "
9522"non-zero. It is intended as a replacement shell field to deny login access "
9523"to an account.\n"
9524msgstr ""
9525
9526#. type: Plain text
9527#: ../login-utils/nologin.8.adoc:22
9528msgid ""
9529"If the file _/etc/nologin.txt_ exists, *nologin* displays its contents to "
9530"the user instead of the default message."
9531msgstr ""
9532
9533#. type: Plain text
9534#: ../login-utils/nologin.8.adoc:24
9535msgid "The exit status returned by *nologin* is always 1."
9536msgstr ""
9537
9538#. type: Plain text
9539#: ../login-utils/nologin.8.adoc:28
9540#, no-wrap
9541msgid "*-c*, *--command* _command_\n"
9542msgstr ""
9543
9544#. type: Plain text
9545#: ../login-utils/nologin.8.adoc:30
9546#, no-wrap
9547msgid "*--init-file*\n"
9548msgstr ""
9549
9550#. type: Plain text
9551#: ../login-utils/nologin.8.adoc:32
9552#, no-wrap
9553msgid "*-i* *--interactive*\n"
9554msgstr ""
9555
9556#. type: Plain text
9557#: ../login-utils/nologin.8.adoc:34
9558#, no-wrap
9559msgid "*--init-file* _file_\n"
9560msgstr ""
9561
9562#. type: Plain text
9563#: ../login-utils/nologin.8.adoc:36
9564#, no-wrap
9565msgid "*-i*, *--interactive*\n"
9566msgstr ""
9567
9568#. type: Plain text
9569#: ../login-utils/nologin.8.adoc:38
9570#, no-wrap
9571msgid "*-l*, *--login*\n"
9572msgstr ""
9573
9574#. type: Plain text
9575#: ../login-utils/nologin.8.adoc:40
9576#, no-wrap
9577msgid "*--noprofile*\n"
9578msgstr ""
9579
9580#. type: Plain text
9581#: ../login-utils/nologin.8.adoc:42
9582#, no-wrap
9583msgid "*--norc*\n"
9584msgstr ""
9585
9586#. type: Plain text
9587#: ../login-utils/nologin.8.adoc:44
9588#, no-wrap
9589msgid "*--posix*\n"
9590msgstr ""
9591
9592#. type: Plain text
9593#: ../login-utils/nologin.8.adoc:46
9594#, no-wrap
9595msgid "*--rcfile* _file_\n"
9596msgstr ""
9597
9598#. type: Plain text
9599#: ../login-utils/nologin.8.adoc:48
9600#, no-wrap
9601msgid "*-r*, *--restricted*\n"
9602msgstr ""
9603
9604#. type: Plain text
9605#: ../login-utils/nologin.8.adoc:50
9606msgid "These shell command-line options are ignored to avoid *nologin* error."
9607msgstr ""
9608
9609#. type: Plain text
9610#: ../login-utils/nologin.8.adoc:60
9611#, no-wrap
9612msgid ""
9613"*nologin* is a per-account way to disable login (usually used for system "
9614"accounts like http or ftp). *nologin* uses _/etc/nologin.txt_ as an optional "
9615"source for a non-default message, the login access is always refused "
9616"independently of the file.\n"
9617msgstr ""
9618
9619#. type: Plain text
9620#: ../login-utils/nologin.8.adoc:62
9621#, no-wrap
9622msgid ""
9623"*pam_nologin*(8) PAM module usually prevents all non-root users from logging "
9624"into the system. *pam_nologin*(8) functionality is controlled by "
9625"_/var/run/nologin_ or the _/etc/nologin_ file.\n"
9626msgstr ""
9627
9628#. type: Plain text
9629#: ../login-utils/nologin.8.adoc:66
9630msgid "The *nologin* command appeared in 4.4BSD."
9631msgstr ""
9632
9633#. type: Plain text
9634#: ../login-utils/nologin.8.adoc:76
9635#, no-wrap
9636msgid ""
9637"*login*(1),\n"
9638"*passwd*(5),\n"
9639"*pam_nologin*(8)\n"
9640msgstr ""
9641
9642#. type: Title =
9643#: ../login-utils/runuser.1.adoc:2
9644#, no-wrap
9645msgid "runuser(1)"
9646msgstr ""
9647
9648#. type: Plain text
9649#: ../login-utils/runuser.1.adoc:12
9650msgid "runuser - run a command with substitute user and group ID"
9651msgstr ""
9652
9653#. type: Plain text
9654#: ../login-utils/runuser.1.adoc:16
9655#, no-wrap
9656msgid "*runuser* [options] *-u* _user_ [[--] _command_ [_argument_...]]\n"
9657msgstr ""
9658
9659#. type: Plain text
9660#: ../login-utils/runuser.1.adoc:18
9661#, no-wrap
9662msgid "*runuser* [options] [*-*] [_user_ [_argument_...]]\n"
9663msgstr ""
9664
9665#. type: Plain text
9666#: ../login-utils/runuser.1.adoc:22
9667#, no-wrap
9668msgid ""
9669"*runuser* can be used to run commands with a substitute user and group "
9670"ID. If the option *-u* is not given, *runuser* falls back to *su*-compatible "
9671"semantics and a shell is executed. The difference between the commands "
9672"*runuser* and *su* is that *runuser* does not ask for a password (because it "
9673"may be executed by the root user only) and it uses a different PAM "
9674"configuration. The command *runuser* does not have to be installed with "
9675"set-user-ID permissions.\n"
9676msgstr ""
9677
9678#. type: Plain text
9679#: ../login-utils/runuser.1.adoc:24
9680msgid ""
9681"If the PAM session is not required, then the recommended solution is to use "
9682"the *setpriv*(1) command."
9683msgstr ""
9684
9685#. type: Plain text
9686#: ../login-utils/runuser.1.adoc:26
9687msgid ""
9688"When called without arguments, *runuser* defaults to running an interactive "
9689"shell as _root_."
9690msgstr ""
9691
9692#. type: Plain text
9693#: ../login-utils/runuser.1.adoc:28
9694msgid ""
9695"For backward compatibility, *runuser* defaults to not changing the current "
9696"directory and to setting only the environment variables *HOME* and *SHELL* "
9697"(plus *USER* and *LOGNAME* if the target _user_ is not root). This version "
9698"of *runuser* uses PAM for session management."
9699msgstr ""
9700
9701#. type: Plain text
9702#: ../login-utils/runuser.1.adoc:30
9703msgid ""
9704"Note that *runuser* in all cases use PAM (pam_getenvlist()) to do the final "
9705"environment modification. Command-line options such as *--login* and "
9706"*--preserve-environment* affect the environment before it is modified by "
9707"PAM."
9708msgstr ""
9709
9710#. type: Labeled list
9711#: ../login-utils/runuser.1.adoc:33
9712#, no-wrap
9713msgid "*-c*, *--command*=_command_"
9714msgstr ""
9715
9716#. type: Plain text
9717#: ../login-utils/runuser.1.adoc:35 ../login-utils/su.1.adoc:35
9718msgid "Pass _command_ to the shell with the *-c* option."
9719msgstr ""
9720
9721#. type: Labeled list
9722#: ../login-utils/runuser.1.adoc:36 ../login-utils/su.1.adoc:36
9723#, no-wrap
9724msgid "*-f*, *--fast*"
9725msgstr ""
9726
9727#. type: Plain text
9728#: ../login-utils/runuser.1.adoc:38 ../login-utils/su.1.adoc:38
9729msgid ""
9730"Pass *-f* to the shell, which may or may not be useful, depending on the "
9731"shell."
9732msgstr ""
9733
9734#. type: Labeled list
9735#: ../login-utils/runuser.1.adoc:39
9736#, no-wrap
9737msgid "*-g*, *--group*=_group_"
9738msgstr ""
9739
9740#. type: Plain text
9741#: ../login-utils/runuser.1.adoc:41
9742msgid "The primary group to be used. This option is allowed for the root user only."
9743msgstr ""
9744
9745#. type: Labeled list
9746#: ../login-utils/runuser.1.adoc:42
9747#, no-wrap
9748msgid "*-G*, *--supp-group*=_group_"
9749msgstr ""
9750
9751#. type: Plain text
9752#: ../login-utils/runuser.1.adoc:44 ../login-utils/su.1.adoc:44
9753msgid ""
9754"Specify a supplementary group. This option is available to the root user "
9755"only. The first specified supplementary group is also used as a primary "
9756"group if the option *--group* is not specified."
9757msgstr ""
9758
9759#. type: Labeled list
9760#: ../login-utils/runuser.1.adoc:45 ../login-utils/su.1.adoc:45
9761#, no-wrap
9762msgid "*-*, *-l*, *--login*"
9763msgstr ""
9764
9765#. type: Plain text
9766#: ../login-utils/runuser.1.adoc:47 ../login-utils/su.1.adoc:47
9767msgid ""
9768"Start the shell as a login shell with an environment similar to a real "
9769"login:"
9770msgstr ""
9771
9772#. type: Plain text
9773#: ../login-utils/runuser.1.adoc:49
9774msgid ""
9775"clears all the environment variables except for *TERM* and variables "
9776"specified by *--whitelist-environment*"
9777msgstr ""
9778
9779#. type: Plain text
9780#: ../login-utils/runuser.1.adoc:50 ../login-utils/su.1.adoc:50
9781msgid ""
9782"initializes the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, "
9783"and *PATH*"
9784msgstr ""
9785
9786#. type: Plain text
9787#: ../login-utils/runuser.1.adoc:51 ../login-utils/su.1.adoc:51
9788msgid "changes to the target user's home directory"
9789msgstr ""
9790
9791#. type: Plain text
9792#: ../login-utils/runuser.1.adoc:52 ../login-utils/su.1.adoc:52
9793msgid "sets argv[0] of the shell to '*-*' in order to make the shell a login shell"
9794msgstr ""
9795
9796#. type: Labeled list
9797#: ../login-utils/runuser.1.adoc:53 ../login-utils/su.1.adoc:56
9798#, no-wrap
9799msgid "*-P*, *--pty*"
9800msgstr ""
9801
9802#. type: Plain text
9803#: ../login-utils/runuser.1.adoc:55
9804msgid ""
9805"Create a pseudo-terminal for the session. The independent terminal provides "
9806"better security as the user does not share a terminal with the original "
9807"session. This can be used to avoid TIOCSTI ioctl terminal injection and "
9808"other security attacks against terminal file descriptors. The entire session "
9809"can also be moved to the background (e.g., *runuser --pty -u username -- "
9810"command &*). If the pseudo-terminal is enabled, then *runuser* works as a "
9811"proxy between the sessions (copy stdin and stdout)."
9812msgstr ""
9813
9814#. type: Plain text
9815#: ../login-utils/runuser.1.adoc:57
9816msgid ""
9817"This feature is mostly designed for interactive sessions. If the standard "
9818"input is not a terminal, but for example a pipe (e.g., *echo \"date\" | "
9819"runuser --pty -u user*), then the ECHO flag for the pseudo-terminal is "
9820"disabled to avoid messy output."
9821msgstr ""
9822
9823#. type: Labeled list
9824#: ../login-utils/runuser.1.adoc:58 ../login-utils/su.1.adoc:53
9825#, no-wrap
9826msgid "*-m*, *-p*, *--preserve-environment*"
9827msgstr ""
9828
9829#. type: Plain text
9830#: ../login-utils/runuser.1.adoc:60
9831msgid ""
9832"Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
9833"*LOGNAME*. The option is ignored if the option *--login* is specified."
9834msgstr ""
9835
9836#. type: Labeled list
9837#: ../login-utils/runuser.1.adoc:61
9838#, no-wrap
9839msgid "*-s*, *--shell*=_shell_"
9840msgstr ""
9841
9842#. type: Plain text
9843#: ../login-utils/runuser.1.adoc:63 ../login-utils/su.1.adoc:63
9844msgid ""
9845"Run the specified _shell_ instead of the default. The shell to run is "
9846"selected according to the following rules, in order:"
9847msgstr ""
9848
9849#. type: Plain text
9850#: ../login-utils/runuser.1.adoc:65 ../login-utils/su.1.adoc:65
9851msgid "the shell specified with *--shell*"
9852msgstr ""
9853
9854#. type: Plain text
9855#: ../login-utils/runuser.1.adoc:66
9856msgid ""
9857"the shell specified in the environment variable *SHELL* if the "
9858"*--preserve-environment* option is used"
9859msgstr ""
9860
9861#. type: Plain text
9862#: ../login-utils/runuser.1.adoc:67 ../login-utils/su.1.adoc:67
9863msgid "the shell listed in the passwd entry of the target user"
9864msgstr ""
9865
9866#. type: Plain text
9867#: ../login-utils/runuser.1.adoc:68 ../login-utils/su.1.adoc:68
9868msgid "/bin/sh"
9869msgstr ""
9870
9871#. type: Plain text
9872#: ../login-utils/runuser.1.adoc:70
9873msgid ""
9874"If the target user has a restricted shell (i.e., not listed in "
9875"_/etc/shells_), then the *--shell* option and the *SHELL* environment "
9876"variables are ignored unless the calling user is root."
9877msgstr ""
9878
9879#. type: Labeled list
9880#: ../login-utils/runuser.1.adoc:71 ../login-utils/su.1.adoc:71
9881#, no-wrap
9882msgid "**--session-command=**__command__"
9883msgstr ""
9884
9885#. type: Plain text
9886#: ../login-utils/runuser.1.adoc:73 ../login-utils/su.1.adoc:73
9887msgid "Same as *-c*, but do not create a new session. (Discouraged.)"
9888msgstr ""
9889
9890#. type: Labeled list
9891#: ../login-utils/runuser.1.adoc:74
9892#, no-wrap
9893msgid "*-w*, *--whitelist-environment*=_list_"
9894msgstr ""
9895
9896#. type: Plain text
9897#: ../login-utils/runuser.1.adoc:76 ../login-utils/su.1.adoc:76
9898msgid ""
9899"Don't reset the environment variables specified in the comma-separated "
9900"_list_ when clearing the environment for *--login*. The whitelist is ignored "
9901"for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and "
9902"*PATH*."
9903msgstr ""
9904
9905#. type: Title ==
9906#: ../login-utils/runuser.1.adoc:83 ../login-utils/su.1.adoc:87
9907#, no-wrap
9908msgid "CONFIG FILES"
9909msgstr ""
9910
9911#. type: Plain text
9912#: ../login-utils/runuser.1.adoc:86
9913#, no-wrap
9914msgid ""
9915"*runuser* reads the _/etc/default/runuser_ and _/etc/login.defs_ "
9916"configuration files. The following configuration items are relevant for "
9917"*runuser*:\n"
9918msgstr ""
9919
9920#. type: Plain text
9921#: ../login-utils/runuser.1.adoc:89
9922msgid ""
9923"Defines the PATH environment variable for a regular user. The default value "
9924"is _/usr/local/bin:/bin:/usr/bin_."
9925msgstr ""
9926
9927#. type: Plain text
9928#: ../login-utils/runuser.1.adoc:93 ../login-utils/su.1.adoc:100
9929msgid ""
9930"Defines the *PATH* environment variable for root. *ENV_SUPATH* takes "
9931"precedence. The default value is "
9932"_/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_."
9933msgstr ""
9934
9935#. type: Labeled list
9936#: ../login-utils/runuser.1.adoc:94 ../login-utils/su.1.adoc:101
9937#, no-wrap
9938msgid "*ALWAYS_SET_PATH* (boolean)"
9939msgstr ""
9940
9941#. type: Plain text
9942#: ../login-utils/runuser.1.adoc:96
9943msgid ""
9944"If set to _yes_ and --login and --preserve-environment were not specified "
9945"*runuser* initializes *PATH*."
9946msgstr ""
9947
9948#. type: Plain text
9949#: ../login-utils/runuser.1.adoc:98 ../login-utils/su.1.adoc:105
9950msgid ""
9951"The environment variable *PATH* may be different on systems where _/bin_ and "
9952"_/sbin_ are merged into _/usr_; this variable is also affected by the "
9953"*--login* command-line option and the PAM system setting (e.g., "
9954"*pam_env*(8))."
9955msgstr ""
9956
9957#. type: Plain text
9958#: ../login-utils/runuser.1.adoc:102
9959#, no-wrap
9960msgid ""
9961"*runuser* normally returns the exit status of the command it executed. If "
9962"the command was killed by a signal, *runuser* returns the number of the "
9963"signal plus 128.\n"
9964msgstr ""
9965
9966#. type: Plain text
9967#: ../login-utils/runuser.1.adoc:104
9968msgid "Exit status generated by *runuser* itself:"
9969msgstr ""
9970
9971#. type: Plain text
9972#: ../login-utils/runuser.1.adoc:107 ../login-utils/su.1.adoc:114
9973msgid "Generic error before executing the requested command"
9974msgstr ""
9975
9976#. type: Labeled list
9977#: ../login-utils/runuser.1.adoc:107 ../login-utils/su.1.adoc:114
9978#, no-wrap
9979msgid "126"
9980msgstr ""
9981
9982#. type: Plain text
9983#: ../login-utils/runuser.1.adoc:109 ../login-utils/su.1.adoc:116
9984msgid "The requested command could not be executed"
9985msgstr ""
9986
9987#. type: Labeled list
9988#: ../login-utils/runuser.1.adoc:109 ../login-utils/su.1.adoc:116
9989#, no-wrap
9990msgid "127"
9991msgstr ""
9992
9993#. type: Plain text
9994#: ../login-utils/runuser.1.adoc:111 ../login-utils/su.1.adoc:118
9995msgid "The requested command was not found"
9996msgstr ""
9997
9998#. type: Labeled list
9999#: ../login-utils/runuser.1.adoc:115
10000#, no-wrap
10001msgid "_/etc/pam.d/runuser_"
10002msgstr ""
10003
10004#. type: Plain text
10005#: ../login-utils/runuser.1.adoc:117 ../login-utils/su.1.adoc:123
10006msgid "default PAM configuration file"
10007msgstr ""
10008
10009#. type: Labeled list
10010#: ../login-utils/runuser.1.adoc:118
10011#, no-wrap
10012msgid "_/etc/pam.d/runuser-l_"
10013msgstr ""
10014
10015#. type: Plain text
10016#: ../login-utils/runuser.1.adoc:120 ../login-utils/su.1.adoc:126
10017msgid "PAM configuration file if *--login* is specified"
10018msgstr ""
10019
10020#. type: Labeled list
10021#: ../login-utils/runuser.1.adoc:121
10022#, no-wrap
10023msgid "_/etc/default/runuser_"
10024msgstr ""
10025
10026#. type: Plain text
10027#: ../login-utils/runuser.1.adoc:123
10028msgid "runuser specific logindef config file"
10029msgstr ""
10030
10031#. type: Labeled list
10032#: ../login-utils/runuser.1.adoc:124 ../login-utils/su.1.adoc:130
10033#, no-wrap
10034msgid "_/etc/login.defs_"
10035msgstr ""
10036
10037#. type: Plain text
10038#: ../login-utils/runuser.1.adoc:126 ../login-utils/su.1.adoc:132
10039msgid "global logindef config file"
10040msgstr ""
10041
10042#. type: Plain text
10043#: ../login-utils/runuser.1.adoc:130
10044msgid ""
10045"This *runuser* command was derived from coreutils' *su*, which was based on "
10046"an implementation by David MacKenzie, and the Fedora *runuser* command by "
10047"Dan Walsh."
10048msgstr ""
10049
10050#. type: Plain text
10051#: ../login-utils/runuser.1.adoc:138
10052#, no-wrap
10053msgid ""
10054"*setpriv*(1),\n"
10055"*su*(1),\n"
10056"*login.defs*(5),\n"
10057"*shells*(5),\n"
10058"*pam*(8)\n"
10059msgstr ""
10060
10061#. type: Title =
10062#: ../login-utils/su.1.adoc:2
10063#, no-wrap
10064msgid "su(1)"
10065msgstr ""
10066
10067#. type: Plain text
10068#: ../login-utils/su.1.adoc:12
10069msgid "su - run a command with substitute user and group ID"
10070msgstr ""
10071
10072#. type: Plain text
10073#: ../login-utils/su.1.adoc:16
10074#, no-wrap
10075msgid "*su* [options] [*-*] [_user_ [_argument_...]]\n"
10076msgstr ""
10077
10078#. type: Plain text
10079#: ../login-utils/su.1.adoc:20
10080#, no-wrap
10081msgid "*su* allows commands to be run with a substitute user and group ID.\n"
10082msgstr ""
10083
10084#. type: Plain text
10085#: ../login-utils/su.1.adoc:22
10086msgid ""
10087"When called with no _user_ specified, *su* defaults to running an "
10088"interactive shell as _root_. When _user_ is specified, additional "
10089"__argument__s can be supplied, in which case they are passed to the shell."
10090msgstr ""
10091
10092#. type: Plain text
10093#: ../login-utils/su.1.adoc:24
10094msgid ""
10095"For backward compatibility, *su* defaults to not change the current "
10096"directory and to only set the environment variables *HOME* and *SHELL* (plus "
10097"*USER* and *LOGNAME* if the target _user_ is not root). It is recommended to "
10098"always use the *--login* option (instead of its shortcut *-*) to avoid side "
10099"effects caused by mixing environments."
10100msgstr ""
10101
10102#. type: Plain text
10103#: ../login-utils/su.1.adoc:26
10104msgid ""
10105"This version of *su* uses PAM for authentication, account and session "
10106"management. Some configuration options found in other *su* implementations, "
10107"such as support for a wheel group, have to be configured via PAM."
10108msgstr ""
10109
10110#. type: Plain text
10111#: ../login-utils/su.1.adoc:28
10112#, no-wrap
10113msgid ""
10114"*su* is mostly designed for unprivileged users, the recommended solution for "
10115"privileged users (e.g., scripts executed by root) is to use non-set-user-ID "
10116"command *runuser*(1) that does not require authentication and provides "
10117"separate PAM configuration. If the PAM session is not required at all then "
10118"the recommended solution is to use command *setpriv*(1).\n"
10119msgstr ""
10120
10121#. type: Plain text
10122#: ../login-utils/su.1.adoc:30
10123msgid ""
10124"Note that *su* in all cases uses PAM (*pam_getenvlist*(3)) to do the final "
10125"environment modification. Command-line options such as *--login* and "
10126"*--preserve-environment* affect the environment before it is modified by "
10127"PAM."
10128msgstr ""
10129
10130#. type: Labeled list
10131#: ../login-utils/su.1.adoc:33
10132#, no-wrap
10133msgid "*-c*, **--command**=__command__"
10134msgstr ""
10135
10136#. type: Labeled list
10137#: ../login-utils/su.1.adoc:39
10138#, no-wrap
10139msgid "*-g*, **--group**=__group__"
10140msgstr ""
10141
10142#. type: Plain text
10143#: ../login-utils/su.1.adoc:41
10144msgid "Specify the primary group. This option is available to the root user only."
10145msgstr ""
10146
10147#. type: Labeled list
10148#: ../login-utils/su.1.adoc:42
10149#, no-wrap
10150msgid "*-G*, **--supp-group**=__group__"
10151msgstr ""
10152
10153#. type: Plain text
10154#: ../login-utils/su.1.adoc:49
10155msgid ""
10156"clears all the environment variables except *TERM* and variables specified "
10157"by *--whitelist-environment*"
10158msgstr ""
10159
10160#. type: Plain text
10161#: ../login-utils/su.1.adoc:55
10162msgid ""
10163"Preserve the entire environment, i.e., do not set *HOME*, *SHELL*, *USER* or "
10164"*LOGNAME*. This option is ignored if the option *--login* is specified."
10165msgstr ""
10166
10167#. type: Plain text
10168#: ../login-utils/su.1.adoc:58
10169msgid ""
10170"Create a pseudo-terminal for the session. The independent terminal provides "
10171"better security as the user does not share a terminal with the original "
10172"session. This can be used to avoid TIOCSTI ioctl terminal injection and "
10173"other security attacks against terminal file descriptors. The entire session "
10174"can also be moved to the background (e.g., \"su --pty - username -c "
10175"application &\"). If the pseudo-terminal is enabled, then *su* works as a "
10176"proxy between the sessions (copy stdin and stdout)."
10177msgstr ""
10178
10179#. type: Plain text
10180#: ../login-utils/su.1.adoc:60
10181msgid ""
10182"This feature is mostly designed for interactive sessions. If the standard "
10183"input is not a terminal, but for example a pipe (e.g., echo \"date\" | su "
10184"--pty), then the ECHO flag for the pseudo-terminal is disabled to avoid "
10185"messy output."
10186msgstr ""
10187
10188#. type: Labeled list
10189#: ../login-utils/su.1.adoc:61
10190#, no-wrap
10191msgid "*-s*, **--shell**=__shell__"
10192msgstr ""
10193
10194#. type: Plain text
10195#: ../login-utils/su.1.adoc:66
10196msgid ""
10197"the shell specified in the environment variable *SHELL*, if the "
10198"*--preserve-environment* option is used"
10199msgstr ""
10200
10201#. type: Plain text
10202#: ../login-utils/su.1.adoc:70
10203msgid ""
10204"If the target user has a restricted shell (i.e., not listed in /etc/shells), "
10205"the *--shell* option and the *SHELL* environment variables are ignored "
10206"unless the calling user is root."
10207msgstr ""
10208
10209#. type: Labeled list
10210#: ../login-utils/su.1.adoc:74
10211#, no-wrap
10212msgid "*-w*, **--whitelist-environment**=__list__"
10213msgstr ""
10214
10215#. type: Title ==
10216#: ../login-utils/su.1.adoc:83 ../term-utils/script.1.adoc:128
10217#, no-wrap
10218msgid "SIGNALS"
10219msgstr ""
10220
10221#. type: Plain text
10222#: ../login-utils/su.1.adoc:86
10223msgid ""
10224"Upon receiving either *SIGINT*, *SIGQUIT* or *SIGTERM*, *su* terminates its "
10225"child and afterwards terminates itself with the received signal. The child "
10226"is terminated by *SIGTERM*, after unsuccessful attempt and 2 seconds of "
10227"delay the child is killed by *SIGKILL*."
10228msgstr ""
10229
10230#. type: Plain text
10231#: ../login-utils/su.1.adoc:90
10232#, no-wrap
10233msgid ""
10234"*su* reads the _/etc/default/su_ and _/etc/login.defs_ configuration "
10235"files. The following configuration items are relevant for *su:*\n"
10236msgstr ""
10237
10238#. type: Plain text
10239#: ../login-utils/su.1.adoc:93
10240msgid ""
10241"Delay in seconds in case of an authentication failure. The number must be a "
10242"non-negative integer."
10243msgstr ""
10244
10245#. type: Plain text
10246#: ../login-utils/su.1.adoc:96
10247msgid ""
10248"Defines the *PATH* environment variable for a regular user. The default "
10249"value is _/usr/local/bin:/bin:/usr/bin_."
10250msgstr ""
10251
10252#. type: Plain text
10253#: ../login-utils/su.1.adoc:103
10254msgid ""
10255"If set to _yes_ and *--login* and *--preserve-environment* were not "
10256"specified *su* initializes *PATH*."
10257msgstr ""
10258
10259#. type: Plain text
10260#: ../login-utils/su.1.adoc:109
10261#, no-wrap
10262msgid ""
10263"*su* normally returns the exit status of the command it executed. If the "
10264"command was killed by a signal, *su* returns the number of the signal plus "
10265"128.\n"
10266msgstr ""
10267
10268#. type: Plain text
10269#: ../login-utils/su.1.adoc:111
10270msgid "Exit status generated by *su* itself:"
10271msgstr ""
10272
10273#. type: Labeled list
10274#: ../login-utils/su.1.adoc:121
10275#, no-wrap
10276msgid "_/etc/pam.d/su_"
10277msgstr ""
10278
10279#. type: Labeled list
10280#: ../login-utils/su.1.adoc:124
10281#, no-wrap
10282msgid "_/etc/pam.d/su-l_"
10283msgstr ""
10284
10285#. type: Labeled list
10286#: ../login-utils/su.1.adoc:127
10287#, no-wrap
10288msgid "_/etc/default/su_"
10289msgstr ""
10290
10291#. type: Plain text
10292#: ../login-utils/su.1.adoc:129
10293msgid "command specific logindef config file"
10294msgstr ""
10295
10296#. type: Plain text
10297#: ../login-utils/su.1.adoc:136
10298msgid ""
10299"For security reasons, *su* always logs failed log-in attempts to the btmp "
10300"file, but it does not write to the _lastlog_ file at all. This solution can "
10301"be used to control *su* behavior by PAM configuration. If you want to use "
10302"the *pam_lastlog*(8) module to print warning message about failed log-in "
10303"attempts then *pam_lastlog*(8) has to be configured to update the _lastlog_ "
10304"file as well. For example by:"
10305msgstr ""
10306
10307#. type: delimited block _
10308#: ../login-utils/su.1.adoc:139
10309msgid "session required pam_lastlog.so nowtmp"
10310msgstr ""
10311
10312#. type: Plain text
10313#: ../login-utils/su.1.adoc:144
10314msgid ""
10315"This *su* command was derived from coreutils' *su*, which was based on an "
10316"implementation by David MacKenzie. The util-linux version has been "
10317"refactored by Karel Zak."
10318msgstr ""
10319
10320#. type: Plain text
10321#: ../login-utils/su.1.adoc:152
10322#, no-wrap
10323msgid ""
10324"*setpriv*(1),\n"
10325"*login.defs*(5),\n"
10326"*shells*(5),\n"
10327"*pam*(8),\n"
10328"*runuser*(1)\n"
10329msgstr ""
10330
10331#. Copyright (C) 1998-2006 Miquel van Smoorenburg.
10332#. Copyright (C) 2012 Karel Zak <kzak@redhat.com>
10333#
10334#. This program is free software; you can redistribute it and/or modify
10335#. it under the terms of the GNU General Public License as published by
10336#. the Free Software Foundation; either version 2 of the License, or
10337#. (at your option) any later version.
10338#
10339#. This program is distributed in the hope that it will be useful,
10340#. but WITHOUT ANY WARRANTY; without even the implied warranty of
10341#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10342#. GNU General Public License for more details.
10343#
10344#. You should have received a copy of the GNU General Public License
10345#. along with this program; if not, write to the Free Software
10346#. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
10347#. type: Title =
10348#: ../login-utils/sulogin.8.adoc:20
10349#, no-wrap
10350msgid "sulogin(8)"
10351msgstr ""
10352
10353#. type: Plain text
10354#: ../login-utils/sulogin.8.adoc:31
10355msgid "sulogin - single-user login"
10356msgstr ""
10357
10358#. type: Plain text
10359#: ../login-utils/sulogin.8.adoc:35
10360#, no-wrap
10361msgid "*sulogin* [options] [_tty_]\n"
10362msgstr ""
10363
10364#. type: Plain text
10365#: ../login-utils/sulogin.8.adoc:39
10366#, no-wrap
10367msgid "*sulogin* is invoked by *init* when the system goes into single-user mode.\n"
10368msgstr ""
10369
10370#. type: Plain text
10371#: ../login-utils/sulogin.8.adoc:41
10372msgid "The user is prompted:"
10373msgstr ""
10374
10375#. type: Plain text
10376#: ../login-utils/sulogin.8.adoc:43
10377msgid ""
10378"Give root password for system maintenance (or type Control-D for normal "
10379"startup):"
10380msgstr ""
10381
10382#. type: Plain text
10383#: ../login-utils/sulogin.8.adoc:45
10384msgid ""
10385"If the root account is locked and *--force* is specified, no password is "
10386"required."
10387msgstr ""
10388
10389#. type: Plain text
10390#: ../login-utils/sulogin.8.adoc:47
10391#, no-wrap
10392msgid ""
10393"*sulogin* will be connected to the current terminal, or to the optional "
10394"_tty_ device that can be specified on the command line (typically "
10395"_/dev/console_).\n"
10396msgstr ""
10397
10398#. type: Plain text
10399#: ../login-utils/sulogin.8.adoc:49
10400msgid ""
10401"When the user exits from the single-user shell, or presses control-D at the "
10402"prompt, the system will continue to boot."
10403msgstr ""
10404
10405#. type: Labeled list
10406#: ../login-utils/sulogin.8.adoc:52
10407#, no-wrap
10408msgid "*-e*, *--force*"
10409msgstr ""
10410
10411#. TRANSLATORS: Keep {asterisk} untranslated.
10412#. type: Plain text
10413#: ../login-utils/sulogin.8.adoc:55
10414msgid ""
10415"If the default method of obtaining the root password from the system via "
10416"*getpwnam*(3) fails, then examine _/etc/passwd_ and _/etc/shadow_ to get the "
10417"password. If these files are damaged or nonexistent, or when root account is "
10418"locked by '!' or '{asterisk}' at the begin of the password then *sulogin* "
10419"will *start a root shell without asking for a password*."
10420msgstr ""
10421
10422#. type: Plain text
10423#: ../login-utils/sulogin.8.adoc:57
10424msgid ""
10425"Only use the *-e* option if you are sure the console is physically protected "
10426"against unauthorized access."
10427msgstr ""
10428
10429#. type: Labeled list
10430#: ../login-utils/sulogin.8.adoc:58
10431#, no-wrap
10432msgid "*-p*, *--login-shell*"
10433msgstr ""
10434
10435#. type: Plain text
10436#: ../login-utils/sulogin.8.adoc:60
10437msgid ""
10438"Specifying this option causes *sulogin* to start the shell process as a "
10439"login shell."
10440msgstr ""
10441
10442#. type: Labeled list
10443#: ../login-utils/sulogin.8.adoc:61
10444#, no-wrap
10445msgid "*-t*, *--timeout* _seconds_"
10446msgstr ""
10447
10448#. type: Plain text
10449#: ../login-utils/sulogin.8.adoc:63
10450msgid ""
10451"Specify the maximum amount of time to wait for user input. By default, "
10452"*sulogin* will wait forever."
10453msgstr ""
10454
10455#. type: Plain text
10456#: ../login-utils/sulogin.8.adoc:73
10457#, no-wrap
10458msgid ""
10459"*sulogin* looks for the environment variable *SUSHELL* or *sushell* to "
10460"determine what shell to start. If the environment variable is not set, it "
10461"will try to execute root's shell from _/etc/passwd_. If that fails, it will "
10462"fall back to _/bin/sh_.\n"
10463msgstr ""
10464
10465#. type: Plain text
10466#: ../login-utils/sulogin.8.adoc:77
10467#, no-wrap
10468msgid ""
10469"*sulogin* was written by Miquel van Smoorenburg for sysvinit and later "
10470"ported to util-linux by Dave Reisner and Karel Zak.\n"
10471msgstr ""
10472
10473#. Copyright (C) 2010 Michael Krapp
10474#
10475#. This program is free software; you can redistribute it and/or modify
10476#. it under the terms of the GNU General Public License as published by
10477#. the Free Software Foundation; either version 2 of the License, or
10478#. (at your option) any later version.
10479#
10480#. This program is distributed in the hope that it will be useful,
10481#. but WITHOUT ANY WARRANTY; without even the implied warranty of
10482#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10483#. GNU General Public License for more details.
10484#
10485#. You should have received a copy of the GNU General Public License
10486#. along with this program; if not, write to the Free Software
10487#. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
10488#. type: Title =
10489#: ../login-utils/utmpdump.1.adoc:19
10490#, no-wrap
10491msgid "utmpdump(1)"
10492msgstr ""
10493
10494#. type: Plain text
10495#: ../login-utils/utmpdump.1.adoc:29
10496msgid "utmpdump - dump UTMP and WTMP files in raw format"
10497msgstr ""
10498
10499#. type: Plain text
10500#: ../login-utils/utmpdump.1.adoc:33
10501#, no-wrap
10502msgid "*utmpdump* [options] _filename_\n"
10503msgstr ""
10504
10505#. type: Plain text
10506#: ../login-utils/utmpdump.1.adoc:37
10507#, no-wrap
10508msgid ""
10509"*utmpdump* is a simple program to dump UTMP and WTMP files in raw format, so "
10510"they can be examined. *utmpdump* reads from stdin unless a _filename_ is "
10511"passed.\n"
10512msgstr ""
10513
10514#. type: Labeled list
10515#: ../login-utils/utmpdump.1.adoc:40
10516#, no-wrap
10517msgid "*-f*, *--follow*"
10518msgstr ""
10519
10520#. type: Plain text
10521#: ../login-utils/utmpdump.1.adoc:42
10522msgid "Output appended data as the file grows."
10523msgstr ""
10524
10525#. type: Labeled list
10526#: ../login-utils/utmpdump.1.adoc:43
10527#, no-wrap
10528msgid "*-o*, *--output* _file_"
10529msgstr ""
10530
10531#. type: Plain text
10532#: ../login-utils/utmpdump.1.adoc:45
10533msgid "Write command output to _file_ instead of standard output."
10534msgstr ""
10535
10536#. type: Labeled list
10537#: ../login-utils/utmpdump.1.adoc:46
10538#, no-wrap
10539msgid "*-r*, *--reverse*"
10540msgstr ""
10541
10542#. type: Plain text
10543#: ../login-utils/utmpdump.1.adoc:48
10544msgid "Undump, write back edited login information into the utmp or wtmp files."
10545msgstr ""
10546
10547#. type: Plain text
10548#: ../login-utils/utmpdump.1.adoc:58
10549#, no-wrap
10550msgid ""
10551"*utmpdump* can be useful in cases of corrupted utmp or wtmp entries. It can "
10552"dump out utmp/wtmp to an ASCII file, which can then be edited to remove "
10553"bogus entries, and reintegrated using:\n"
10554msgstr ""
10555
10556#. type: delimited block _
10557#: ../login-utils/utmpdump.1.adoc:61
10558#, no-wrap
10559msgid "*utmpdump -r < ascii_file > wtmp*\n"
10560msgstr ""
10561
10562#. type: Plain text
10563#: ../login-utils/utmpdump.1.adoc:64
10564msgid "But be warned, *utmpdump* was written for debugging purposes only."
10565msgstr ""
10566
10567#. type: Plain text
10568#: ../login-utils/utmpdump.1.adoc:68
10569msgid ""
10570"Only the binary version of the *utmp*(5) is standardised. Textual dumps may "
10571"become incompatible in future."
10572msgstr ""
10573
10574#. type: Plain text
10575#: ../login-utils/utmpdump.1.adoc:70
10576msgid ""
10577"The version 2.28 was the last one that printed text output using *ctime*(3) "
10578"timestamp format. Newer dumps use millisecond precision ISO-8601 timestamp "
10579"format in UTC-0 timezone. Conversion from former timestamp format can be "
10580"made to binary, although attempt to do so can lead the timestamps to drift "
10581"amount of timezone offset."
10582msgstr ""
10583
10584#. type: Plain text
10585#: ../login-utils/utmpdump.1.adoc:74
10586msgid ""
10587"You may *not* use the *-r* option, as the format for the utmp/wtmp files "
10588"strongly depends on the input format. This tool was *not* written for normal "
10589"use, but for debugging only."
10590msgstr ""
10591
10592#. type: Plain text
10593#: ../login-utils/utmpdump.1.adoc:78
10594msgid "Michael Krapp"
10595msgstr ""
10596
10597#. type: Plain text
10598#: ../login-utils/utmpdump.1.adoc:85
10599#, no-wrap
10600msgid ""
10601"*last*(1),\n"
10602"*w*(1),\n"
10603"*who*(1),\n"
10604"*utmp*(5)\n"
10605msgstr ""
10606
10607#. Copyright (c) 1983, 1991 The Regents of the University of California.
10608#. All rights reserved.
10609#
10610#. Redistribution and use in source and binary forms, with or without
10611#. modification, are permitted provided that the following conditions
10612#. are met:
10613#. 1. Redistributions of source code must retain the above copyright
10614#. notice, this list of conditions and the following disclaimer.
10615#. 2. Redistributions in binary form must reproduce the above copyright
10616#. notice, this list of conditions and the following disclaimer in the
10617#. documentation and/or other materials provided with the distribution.
10618#. 3. All advertising materials mentioning features or use of this software
10619#. must display the following acknowledgement:
10620#. This product includes software developed by the University of
10621#. California, Berkeley and its contributors.
10622#. 4. Neither the name of the University nor the names of its contributors
10623#. may be used to endorse or promote products derived from this software
10624#. without specific prior written permission.
10625#
10626#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
10627#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
10628#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
10629#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
10630#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
10631#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
10632#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
10633#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
10634#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
10635#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
10636#. SUCH DAMAGE.
10637#
10638#. @(#)vipw.8 6.7 (Berkeley) 3/16/91
10639#. type: Title =
10640#: ../login-utils/vipw.8.adoc:36
10641#, no-wrap
10642msgid "vipw(8)"
10643msgstr ""
10644
10645#. type: Plain text
10646#: ../login-utils/vipw.8.adoc:46
10647msgid "vipw, vigr - edit the password or group file"
10648msgstr ""
10649
10650#. type: Plain text
10651#: ../login-utils/vipw.8.adoc:50
10652#, no-wrap
10653msgid "*vipw* [options]\n"
10654msgstr ""
10655
10656#. type: Plain text
10657#: ../login-utils/vipw.8.adoc:52
10658#, no-wrap
10659msgid "*vigr* [options]\n"
10660msgstr ""
10661
10662#. type: Plain text
10663#: ../login-utils/vipw.8.adoc:56
10664#, no-wrap
10665msgid ""
10666"*vipw* edits the password file after setting the appropriate locks, and does "
10667"any necessary processing after the password file is unlocked. If the "
10668"password file is already locked for editing by another user, *vipw* will ask "
10669"you to try again later. The default editor for *vipw* and *vigr* is "
10670"*vi*(1). *vigr* edits the group file in the same manner as *vipw* does the "
10671"passwd file.\n"
10672msgstr ""
10673
10674#. type: Plain text
10675#: ../login-utils/vipw.8.adoc:60
10676msgid ""
10677"If the following environment variable exists, it will be utilized by *vipw* "
10678"and *vigr*:"
10679msgstr ""
10680
10681#. type: Labeled list
10682#: ../login-utils/vipw.8.adoc:61 ../text-utils/more.1.adoc:181
10683#, no-wrap
10684msgid "*EDITOR*"
10685msgstr ""
10686
10687#. type: Plain text
10688#: ../login-utils/vipw.8.adoc:63
10689msgid ""
10690"The editor specified by the string *EDITOR* will be invoked instead of the "
10691"default editor *vi*(1)."
10692msgstr ""
10693
10694#. type: Plain text
10695#: ../login-utils/vipw.8.adoc:67
10696msgid ""
10697"The *vipw* command appeared in 4.0BSD. The *vigr* command appeared in "
10698"Util-Linux 2.6."
10699msgstr ""
10700
10701#. type: Plain text
10702#: ../login-utils/vipw.8.adoc:74
10703#, no-wrap
10704msgid ""
10705"*vi*(1),\n"
10706"*passwd*(1),\n"
10707"*flock*(2),\n"
10708"*passwd*(5)\n"
10709msgstr ""
10710
10711#. type: Plain text
10712#: ../login-utils/vipw.8.adoc:77
10713msgid ""
10714"The *vigr* and *vipw* commands are part of the util-linux package and are "
10715"available from https://www.kernel.org/pub/linux/utils/util-linux/[Linux "
10716"Kernel Archive]"
10717msgstr ""
10718
10719#. Copyright 2000 Andreas Dilger (adilger@turbolinux.com)
10720#. This file may be copied under the terms of the GNU Public License.
10721#. type: Title =
10722#: ../misc-utils/blkid.8.adoc:4
10723#, no-wrap
10724msgid "blkid(8)"
10725msgstr ""
10726
10727#. type: Plain text
10728#: ../misc-utils/blkid.8.adoc:15
10729msgid "blkid - locate/print block device attributes"
10730msgstr ""
10731
10732#. type: Plain text
10733#: ../misc-utils/blkid.8.adoc:19
10734#, no-wrap
10735msgid "*blkid* *--label* _label_ | *--uuid* _uuid_\n"
10736msgstr ""
10737
10738#. type: Plain text
10739#: ../misc-utils/blkid.8.adoc:21
10740#, no-wrap
10741msgid ""
10742"*blkid* [*--no-encoding* *--garbage-collect* *--list-one* *--cache-file* "
10743"_file_] [*--output* _format_][*--match-tag* _tag_] [*--match-token* "
10744"_NAME=value_] [_device_...]\n"
10745msgstr ""
10746
10747#. type: Plain text
10748#: ../misc-utils/blkid.8.adoc:23
10749#, no-wrap
10750msgid ""
10751"*blkid* *--probe* [*--offset* _offset_] [*--output* _format_] [*--size* "
10752"_size_] [*--match-tag* _tag_] [*--match-types* _list_] [*--usages* _list_] "
10753"[*--no-part-details*] _device_...\n"
10754msgstr ""
10755
10756#. type: Plain text
10757#: ../misc-utils/blkid.8.adoc:25
10758#, no-wrap
10759msgid "*blkid* *--info* [*--output format*] [*--match-tag* _tag_] _device_...\n"
10760msgstr ""
10761
10762#. type: Plain text
10763#: ../misc-utils/blkid.8.adoc:29
10764msgid ""
10765"The *blkid* program is the command-line interface to working with the "
10766"*libblkid*(3) library. It can determine the type of content (e.g., "
10767"filesystem or swap) that a block device holds, and also the attributes "
10768"(tokens, NAME=value pairs) from the content metadata (e.g., LABEL or UUID "
10769"fields)."
10770msgstr ""
10771
10772#. type: Plain text
10773#: ../misc-utils/blkid.8.adoc:31
10774#, no-wrap
10775msgid ""
10776"*It is recommended to use* *lsblk*(8) *command to get information about "
10777"block devices, or lsblk --fs to get an overview of filesystems, or* "
10778"*findmnt*(8) *to search in already mounted filesystems.*\n"
10779msgstr ""
10780
10781#. type: delimited block _
10782#: ../misc-utils/blkid.8.adoc:34
10783#, no-wrap
10784msgid ""
10785"*lsblk*(8) provides more information, better control on output formatting, "
10786"easy to use in scripts and it does not require root permissions to get "
10787"actual information. *blkid* reads information directly from devices and for "
10788"non-root users it returns cached unverified information. *blkid* is mostly "
10789"designed for system services and to test *libblkid*(3) functionality.\n"
10790msgstr ""
10791
10792#. type: Plain text
10793#: ../misc-utils/blkid.8.adoc:37
10794msgid ""
10795"When _device_ is specified, tokens from only this device are displayed. It "
10796"is possible to specify multiple _device_ arguments on the command line. If "
10797"none is given, all partitions or unpartitioned devices which appear in "
10798"_/proc/partitions_ are shown, if they are recognized."
10799msgstr ""
10800
10801#. type: Plain text
10802#: ../misc-utils/blkid.8.adoc:39
10803#, no-wrap
10804msgid ""
10805"*blkid* has two main forms of operation: either searching for a device with "
10806"a specific NAME=value pair, or displaying NAME=value pairs for one or more "
10807"specified devices.\n"
10808msgstr ""
10809
10810#. type: Plain text
10811#: ../misc-utils/blkid.8.adoc:41
10812msgid ""
10813"For security reasons *blkid* silently ignores all devices where the probing "
10814"result is ambivalent (multiple colliding filesystems are detected). The "
10815"low-level probing mode (*-p*) provides more information and extra exit "
10816"status in this case. It's recommended to use *wipefs*(8) to get a detailed "
10817"overview and to erase obsolete stuff (magic strings) from the device."
10818msgstr ""
10819
10820#. type: Plain text
10821#: ../misc-utils/blkid.8.adoc:45
10822msgid ""
10823"The _size_ and _offset_ arguments may be followed by the multiplicative "
10824"suffixes like KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, "
10825"EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning "
10826"as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, "
10827"TB, PB, EB, ZB and YB."
10828msgstr ""
10829
10830#. type: Labeled list
10831#: ../misc-utils/blkid.8.adoc:46
10832#, no-wrap
10833msgid "*-c*, *--cache-file* _cachefile_"
10834msgstr ""
10835
10836#. type: Plain text
10837#: ../misc-utils/blkid.8.adoc:48
10838msgid ""
10839"Read from _cachefile_ instead of reading from the default cache file (see "
10840"the CONFIGURATION FILE section for more details). If you want to start with "
10841"a clean cache (i.e., don't report devices previously scanned but not "
10842"necessarily available at this time), specify _/dev/null_."
10843msgstr ""
10844
10845#. type: Labeled list
10846#: ../misc-utils/blkid.8.adoc:49
10847#, no-wrap
10848msgid "*-d*, *--no-encoding*"
10849msgstr ""
10850
10851#. type: Plain text
10852#: ../misc-utils/blkid.8.adoc:51
10853msgid ""
10854"Don't encode non-printing characters. The non-printing characters are "
10855"encoded by ^ and M- notation by default. Note that the *--output udev* "
10856"output format uses a different encoding which cannot be disabled."
10857msgstr ""
10858
10859#. type: Labeled list
10860#: ../misc-utils/blkid.8.adoc:52
10861#, no-wrap
10862msgid "*-D*, *--no-part-details*"
10863msgstr ""
10864
10865#. type: Plain text
10866#: ../misc-utils/blkid.8.adoc:54
10867msgid ""
10868"Don't print information (PART_ENTRY_* tags) from partition table in "
10869"low-level probing mode."
10870msgstr ""
10871
10872#. type: Labeled list
10873#: ../misc-utils/blkid.8.adoc:55
10874#, no-wrap
10875msgid "*-g*, *--garbage-collect*"
10876msgstr ""
10877
10878#. type: Plain text
10879#: ../misc-utils/blkid.8.adoc:57
10880msgid ""
10881"Perform a garbage collection pass on the blkid cache to remove devices which "
10882"no longer exist."
10883msgstr ""
10884
10885#. type: Plain text
10886#: ../misc-utils/blkid.8.adoc:60
10887msgid "Display a usage message and exit."
10888msgstr ""
10889
10890#. type: Labeled list
10891#: ../misc-utils/blkid.8.adoc:61 ../sys-utils/readprofile.8.adoc:33
10892#, no-wrap
10893msgid "*-i*, *--info*"
10894msgstr ""
10895
10896#. type: Plain text
10897#: ../misc-utils/blkid.8.adoc:63
10898msgid ""
10899"Display information about I/O Limits (aka I/O topology). The 'export' output "
10900"format is automatically enabled. This option can be used together with the "
10901"*--probe* option."
10902msgstr ""
10903
10904#. type: Labeled list
10905#: ../misc-utils/blkid.8.adoc:64
10906#, no-wrap
10907msgid "*-k*, *--list-filesystems*"
10908msgstr ""
10909
10910#. type: Plain text
10911#: ../misc-utils/blkid.8.adoc:66
10912msgid "List all known filesystems and RAIDs and exit."
10913msgstr ""
10914
10915#. type: Labeled list
10916#: ../misc-utils/blkid.8.adoc:67
10917#, no-wrap
10918msgid "*-l*, *--list-one*"
10919msgstr ""
10920
10921#. type: Plain text
10922#: ../misc-utils/blkid.8.adoc:69
10923msgid ""
10924"Look up only one device that matches the search parameter specified with the "
10925"*--match-token* option. If there are multiple devices that match the "
10926"specified search parameter, then the device with the highest priority is "
10927"returned, and/or the first device found at a given priority (but see below "
10928"note about udev). Device types in order of decreasing priority are: Device "
10929"Mapper, EVMS, LVM, MD, and finally regular block devices. If this option is "
10930"not specified, *blkid* will print all of the devices that match the search "
10931"parameter."
10932msgstr ""
10933
10934#. type: Plain text
10935#: ../misc-utils/blkid.8.adoc:71
10936msgid ""
10937"This option forces *blkid* to use udev when used for LABEL or UUID tokens in "
10938"*--match-token*. The goal is to provide output consistent with other utils "
10939"(like *mount*(8), etc.) on systems where the same tag is used for multiple "
10940"devices."
10941msgstr ""
10942
10943#. type: Plain text
10944#: ../misc-utils/blkid.8.adoc:74
10945msgid ""
10946"Look up the device that uses this filesystem _label_; this is equal to "
10947"**--list-one --output device --match-token LABEL=**__label__. This lookup "
10948"method is able to reliably use /dev/disk/by-label udev symlinks (dependent "
10949"on a setting in _/etc/blkid.conf_). Avoid using the symlinks directly; it is "
10950"not reliable to use the symlinks without verification. The *--label* option "
10951"works on systems with and without udev."
10952msgstr ""
10953
10954#. type: Plain text
10955#: ../misc-utils/blkid.8.adoc:76
10956msgid ""
10957"Unfortunately, the original *blkid*(8) from e2fsprogs uses the *-L* option "
10958"as a synonym for *-o list*. For better portability, use **-l -o device -t "
10959"LABEL=**__label__ and *-o list* in your scripts rather than the *-L* option."
10960msgstr ""
10961
10962#. type: Labeled list
10963#: ../misc-utils/blkid.8.adoc:77
10964#, no-wrap
10965msgid "*-n*, *--match-types* _list_"
10966msgstr ""
10967
10968#. type: Plain text
10969#: ../misc-utils/blkid.8.adoc:79
10970msgid ""
10971"Restrict the probing functions to the specified (comma-separated) _list_ of "
10972"superblock types (names). The list items may be prefixed with \"no\" to "
10973"specify the types which should be ignored. For example:"
10974msgstr ""
10975
10976#. type: Plain text
10977#: ../misc-utils/blkid.8.adoc:81
10978#, no-wrap
10979msgid "*blkid --probe --match-types vfat,ext3,ext4 /dev/sda1*\n"
10980msgstr ""
10981
10982#. type: Plain text
10983#: ../misc-utils/blkid.8.adoc:83
10984msgid "probes for vfat, ext3 and ext4 filesystems, and"
10985msgstr ""
10986
10987#. type: Plain text
10988#: ../misc-utils/blkid.8.adoc:85
10989#, no-wrap
10990msgid "*blkid --probe --match-types nominix /dev/sda1*\n"
10991msgstr ""
10992
10993#. type: Plain text
10994#: ../misc-utils/blkid.8.adoc:87
10995msgid ""
10996"probes for all supported formats except minix filesystems. This option is "
10997"only useful together with *--probe*."
10998msgstr ""
10999
11000#. type: Labeled list
11001#: ../misc-utils/blkid.8.adoc:88
11002#, no-wrap
11003msgid "*-o*, *--output* _format_"
11004msgstr ""
11005
11006#. type: Plain text
11007#: ../misc-utils/blkid.8.adoc:90
11008msgid ""
11009"Use the specified output format. Note that the order of variables and "
11010"devices is not fixed. See also option *-s*. The _format_ parameter may be:"
11011msgstr ""
11012
11013#. type: Labeled list
11014#: ../misc-utils/blkid.8.adoc:91
11015#, no-wrap
11016msgid "*full*"
11017msgstr ""
11018
11019#. type: Plain text
11020#: ../misc-utils/blkid.8.adoc:93
11021msgid "print all tags (the default)"
11022msgstr ""
11023
11024#. type: Labeled list
11025#: ../misc-utils/blkid.8.adoc:93
11026#, no-wrap
11027msgid "*value*"
11028msgstr ""
11029
11030#. type: Plain text
11031#: ../misc-utils/blkid.8.adoc:95
11032msgid "print the value of the tags"
11033msgstr ""
11034
11035#. type: Labeled list
11036#: ../misc-utils/blkid.8.adoc:95
11037#, no-wrap
11038msgid "*list*"
11039msgstr ""
11040
11041#. type: Plain text
11042#: ../misc-utils/blkid.8.adoc:97
11043msgid ""
11044"print the devices in a user-friendly format; this output format is "
11045"unsupported for low-level probing (*--probe* or *--info*)."
11046msgstr ""
11047
11048#. type: Plain text
11049#: ../misc-utils/blkid.8.adoc:99
11050msgid "This output format is *DEPRECATED* in favour of the *lsblk*(8) command."
11051msgstr ""
11052
11053#. type: Labeled list
11054#: ../misc-utils/blkid.8.adoc:99
11055#, no-wrap
11056msgid "*device*"
11057msgstr ""
11058
11059#. type: Plain text
11060#: ../misc-utils/blkid.8.adoc:101
11061msgid ""
11062"print the device name only; this output format is always enabled for the "
11063"*--label* and *--uuid* options"
11064msgstr ""
11065
11066#. type: Labeled list
11067#: ../misc-utils/blkid.8.adoc:101
11068#, no-wrap
11069msgid "*udev*"
11070msgstr ""
11071
11072#. TRANSLATORS: Please keep {underscore} untranslated.
11073#. type: Plain text
11074#: ../misc-utils/blkid.8.adoc:104
11075msgid ""
11076"print key=\"value\" pairs for easy import into the udev environment; the "
11077"keys are prefixed by ID_FS_ or ID_PART_ prefixes. The value may be modified "
11078"to be safe for udev environment; allowed is plain ASCII, hex-escaping and "
11079"valid UTF-8, everything else (including whitespaces) is replaced with "
11080"'{underscore}'. The keys with __ENC_ postfix use hex-escaping for unsafe "
11081"chars."
11082msgstr ""
11083
11084#. type: Plain text
11085#: ../misc-utils/blkid.8.adoc:106
11086msgid ""
11087"The udev output returns the ID_FS_AMBIVALENT tag if more superblocks are "
11088"detected, and ID_PART_ENTRY_* tags are always returned for all partitions "
11089"including empty partitions."
11090msgstr ""
11091
11092#. type: Plain text
11093#: ../misc-utils/blkid.8.adoc:108
11094msgid "This output format is *DEPRECATED*."
11095msgstr ""
11096
11097#. type: Labeled list
11098#: ../misc-utils/blkid.8.adoc:108
11099#, no-wrap
11100msgid "*export*"
11101msgstr ""
11102
11103#. type: Plain text
11104#: ../misc-utils/blkid.8.adoc:110
11105msgid ""
11106"print key=value pairs for easy import into the environment; this output "
11107"format is automatically enabled when I/O Limits (*--info* option) are "
11108"requested."
11109msgstr ""
11110
11111#. type: Plain text
11112#: ../misc-utils/blkid.8.adoc:112
11113msgid ""
11114"The non-printing characters are encoded by ^ and M- notation and all "
11115"potentially unsafe characters are escaped."
11116msgstr ""
11117
11118#. type: Labeled list
11119#: ../misc-utils/blkid.8.adoc:113
11120#, no-wrap
11121msgid "*-O*, *--offset* _offset_"
11122msgstr ""
11123
11124#. type: Plain text
11125#: ../misc-utils/blkid.8.adoc:115
11126msgid ""
11127"Probe at the given _offset_ (only useful with *--probe*). This option can be "
11128"used together with the *--info* option."
11129msgstr ""
11130
11131#. type: Labeled list
11132#: ../misc-utils/blkid.8.adoc:116
11133#, no-wrap
11134msgid "*-p*, *--probe*"
11135msgstr ""
11136
11137#. type: Plain text
11138#: ../misc-utils/blkid.8.adoc:118
11139msgid "Switch to low-level superblock probing mode (bypassing the cache)."
11140msgstr ""
11141
11142#. type: Plain text
11143#: ../misc-utils/blkid.8.adoc:120
11144msgid ""
11145"Note that low-level probing also returns information about partition table "
11146"type (PTTYPE tag) and partitions (PART_ENTRY_* tags). The tag names produced "
11147"by low-level probing are based on names used internally by libblkid and it "
11148"may be different than when executed without *--probe* (for example "
11149"PART_ENTRY_UUID= vs PARTUUID=). See also *--no-part-details*."
11150msgstr ""
11151
11152#. type: Labeled list
11153#: ../misc-utils/blkid.8.adoc:121
11154#, no-wrap
11155msgid "*-s*, *--match-tag* _tag_"
11156msgstr ""
11157
11158#. type: Plain text
11159#: ../misc-utils/blkid.8.adoc:123
11160msgid ""
11161"For each (specified) device, show only the tags that match _tag_. It is "
11162"possible to specify multiple *--match-tag* options. If no tag is specified, "
11163"then all tokens are shown for all (specified) devices. In order to just "
11164"refresh the cache without showing any tokens, use *--match-tag none* with no "
11165"other options."
11166msgstr ""
11167
11168#. type: Labeled list
11169#: ../misc-utils/blkid.8.adoc:124 ../misc-utils/logger.1.adoc:155
11170#, no-wrap
11171msgid "*-S*, *--size* _size_"
11172msgstr ""
11173
11174#. type: Plain text
11175#: ../misc-utils/blkid.8.adoc:126
11176msgid "Override the size of device/file (only useful with *--probe*)."
11177msgstr ""
11178
11179#. type: Labeled list
11180#: ../misc-utils/blkid.8.adoc:127
11181#, no-wrap
11182msgid "*-t*, *--match-token* _NAME=value_"
11183msgstr ""
11184
11185#. type: Plain text
11186#: ../misc-utils/blkid.8.adoc:129
11187msgid ""
11188"Search for block devices with tokens named _NAME_ that have the value "
11189"_value_, and display any devices which are found. Common values for _NAME_ "
11190"include *TYPE*, *LABEL*, and *UUID*. If there are no devices specified on "
11191"the command line, all block devices will be searched; otherwise only the "
11192"specified devices are searched."
11193msgstr ""
11194
11195#. type: Labeled list
11196#: ../misc-utils/blkid.8.adoc:130
11197#, no-wrap
11198msgid "*-u*, *--usages* _list_"
11199msgstr ""
11200
11201#. type: Plain text
11202#: ../misc-utils/blkid.8.adoc:132
11203msgid ""
11204"Restrict the probing functions to the specified (comma-separated) _list_ of "
11205"\"usage\" types. Supported usage types are: filesystem, raid, crypto and "
11206"other. The list items may be prefixed with \"no\" to specify the usage types "
11207"which should be ignored. For example:"
11208msgstr ""
11209
11210#. type: Plain text
11211#: ../misc-utils/blkid.8.adoc:134
11212#, no-wrap
11213msgid "*blkid --probe --usages filesystem,other /dev/sda1*\n"
11214msgstr ""
11215
11216#. type: Plain text
11217#: ../misc-utils/blkid.8.adoc:136
11218msgid "probes for all filesystem and other (e.g., swap) formats, and"
11219msgstr ""
11220
11221#. type: Plain text
11222#: ../misc-utils/blkid.8.adoc:138
11223#, no-wrap
11224msgid "*blkid --probe --usages noraid /dev/sda1*\n"
11225msgstr ""
11226
11227#. type: Plain text
11228#: ../misc-utils/blkid.8.adoc:140
11229msgid ""
11230"probes for all supported formats except RAIDs. This option is only useful "
11231"together with *--probe*."
11232msgstr ""
11233
11234#. type: Labeled list
11235#: ../misc-utils/blkid.8.adoc:141 ../sys-utils/mount.8.adoc:426
11236#, no-wrap
11237msgid "*-U*, *--uuid* _uuid_"
11238msgstr ""
11239
11240#. type: Plain text
11241#: ../misc-utils/blkid.8.adoc:143
11242msgid ""
11243"Look up the device that uses this filesystem _uuid_. For more details see "
11244"the *--label* option."
11245msgstr ""
11246
11247#. type: Plain text
11248#: ../misc-utils/blkid.8.adoc:146
11249msgid "Display version number and exit."
11250msgstr ""
11251
11252#. type: Plain text
11253#: ../misc-utils/blkid.8.adoc:150
11254msgid ""
11255"If the specified device or device addressed by specified token (option "
11256"*--match-token*) was found and it's possible to gather any information about "
11257"the device, an exit status 0 is returned. Note the option *--match-tag* "
11258"filters output tags, but it does not affect exit status."
11259msgstr ""
11260
11261#. type: Plain text
11262#: ../misc-utils/blkid.8.adoc:152
11263msgid ""
11264"If the specified token was not found, or no (specified) devices could be "
11265"identified, or it is impossible to gather any information about the device "
11266"identifiers or device content an exit status of 2 is returned."
11267msgstr ""
11268
11269#. type: Plain text
11270#: ../misc-utils/blkid.8.adoc:154
11271msgid "For usage or other errors, an exit status of 4 is returned."
11272msgstr ""
11273
11274#. type: Plain text
11275#: ../misc-utils/blkid.8.adoc:156
11276msgid ""
11277"If an ambivalent probing result was detected by low-level probing mode "
11278"(*-p*), an exit status of 8 is returned."
11279msgstr ""
11280
11281#. type: Plain text
11282#: ../misc-utils/blkid.8.adoc:160
11283msgid ""
11284"The standard location of the _/etc/blkid.conf_ config file can be overridden "
11285"by the environment variable BLKID_CONF. The following options control the "
11286"libblkid library:"
11287msgstr ""
11288
11289#. type: Labeled list
11290#: ../misc-utils/blkid.8.adoc:161
11291#, no-wrap
11292msgid "_SEND_UEVENT=<yes|not>_"
11293msgstr ""
11294
11295#. type: Plain text
11296#: ../misc-utils/blkid.8.adoc:163
11297msgid ""
11298"Sends uevent when _/dev/disk/by-{label,uuid,partuuid,partlabel}/_ symlink "
11299"does not match with LABEL, UUID, PARTUUID or PARTLABEL on the "
11300"device. Default is \"yes\"."
11301msgstr ""
11302
11303#. type: Labeled list
11304#: ../misc-utils/blkid.8.adoc:164
11305#, no-wrap
11306msgid "_CACHE_FILE=<path>_"
11307msgstr ""
11308
11309#. type: Plain text
11310#: ../misc-utils/blkid.8.adoc:166
11311msgid ""
11312"Overrides the standard location of the cache file. This setting can be "
11313"overridden by the environment variable *BLKID_FILE*. Default is "
11314"_/run/blkid/blkid.tab_, or _/etc/blkid.tab_ on systems without a _/run_ "
11315"directory."
11316msgstr ""
11317
11318#. type: Labeled list
11319#: ../misc-utils/blkid.8.adoc:167
11320#, no-wrap
11321msgid "_EVALUATE=<methods>_"
11322msgstr ""
11323
11324#. type: Plain text
11325#: ../misc-utils/blkid.8.adoc:169
11326msgid ""
11327"Defines LABEL and UUID evaluation method(s). Currently, the libblkid library "
11328"supports the \"udev\" and \"scan\" methods. More than one method may be "
11329"specified in a comma-separated list. Default is \"udev,scan\". The \"udev\" "
11330"method uses udev _/dev/disk/by-*_ symlinks and the \"scan\" method scans all "
11331"block devices from the _/proc/partitions_ file."
11332msgstr ""
11333
11334#. type: Plain text
11335#: ../misc-utils/blkid.8.adoc:173
11336msgid "Setting _LIBBLKID_DEBUG=all_ enables debug output."
11337msgstr ""
11338
11339#. type: Plain text
11340#: ../misc-utils/blkid.8.adoc:177
11341#, no-wrap
11342msgid ""
11343"*blkid* was written by Andreas Dilger for libblkid and improved by Theodore "
11344"Ts'o and Karel Zak.\n"
11345msgstr ""
11346
11347#. type: Plain text
11348#: ../misc-utils/blkid.8.adoc:184
11349#, no-wrap
11350msgid ""
11351"*libblkid*(3),\n"
11352"*findfs*(8),\n"
11353"*lsblk*(8),\n"
11354"*wipefs*(8)\n"
11355msgstr ""
11356
11357#. Copyright (c) 1989, 1990, 1993
11358#. The Regents of the University of California. All rights reserved.
11359#
11360#. This code is derived from software contributed to Berkeley by
11361#. Kim Letkeman.
11362#
11363#. Redistribution and use in source and binary forms, with or without
11364#. modification, are permitted provided that the following conditions
11365#. are met:
11366#. 1. Redistributions of source code must retain the above copyright
11367#. notice, this list of conditions and the following disclaimer.
11368#. 2. Redistributions in binary form must reproduce the above copyright
11369#. notice, this list of conditions and the following disclaimer in the
11370#. documentation and/or other materials provided with the distribution.
11371#. 3. All advertising materials mentioning features or use of this software
11372#. must display the following acknowledgement:
11373#. This product includes software developed by the University of
11374#. California, Berkeley and its contributors.
11375#. 4. Neither the name of the University nor the names of its contributors
11376#. may be used to endorse or promote products derived from this software
11377#. without specific prior written permission.
11378#
11379#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
11380#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
11381#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
11382#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
11383#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
11384#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
11385#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
11386#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
11387#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
11388#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
11389#. SUCH DAMAGE.
11390#
11391#. @(#)cal.1 8.1 (Berkeley) 6/6/93
11392#. type: Title =
11393#: ../misc-utils/cal.1.adoc:39
11394#, no-wrap
11395msgid "cal(1)"
11396msgstr ""
11397
11398#. type: Plain text
11399#: ../misc-utils/cal.1.adoc:50
11400msgid "cal - display a calendar"
11401msgstr ""
11402
11403#. type: Plain text
11404#: ../misc-utils/cal.1.adoc:54
11405#, no-wrap
11406msgid "*cal* [options] [[[_day_] _month_] _year_]\n"
11407msgstr ""
11408
11409#. type: Plain text
11410#: ../misc-utils/cal.1.adoc:56
11411#, no-wrap
11412msgid "*cal* [options] [_timestamp_|_monthname_]\n"
11413msgstr ""
11414
11415#. type: Plain text
11416#: ../misc-utils/cal.1.adoc:60
11417#, no-wrap
11418msgid ""
11419"*cal* displays a simple calendar. If no arguments are specified, the current "
11420"month is displayed.\n"
11421msgstr ""
11422
11423#. type: Plain text
11424#: ../misc-utils/cal.1.adoc:62
11425msgid ""
11426"The _month_ may be specified as a number (1-12), as a month name or as an "
11427"abbreviated month name according to the current locales."
11428msgstr ""
11429
11430#. type: Plain text
11431#: ../misc-utils/cal.1.adoc:64
11432msgid ""
11433"Two different calendar systems are used, Gregorian and Julian. These are "
11434"nearly identical systems with Gregorian making a small adjustment to the "
11435"frequency of leap years; this facilitates improved synchronization with "
11436"solar events like the equinoxes. The Gregorian calendar reform was "
11437"introduced in 1582, but its adoption continued up to 1923. By default *cal* "
11438"uses the adoption date of 3 Sept 1752. From that date forward the Gregorian "
11439"calendar is displayed; previous dates use the Julian calendar system. 11 "
11440"days were removed at the time of adoption to bring the calendar in sync with "
11441"solar events. So Sept 1752 has a mix of Julian and Gregorian dates by which "
11442"the 2nd is followed by the 14th (the 3rd through the 13th are absent)."
11443msgstr ""
11444
11445#. type: Plain text
11446#: ../misc-utils/cal.1.adoc:66
11447msgid ""
11448"Optionally, either the proleptic Gregorian calendar or the Julian calendar "
11449"may be used exclusively. See *--reform* below."
11450msgstr ""
11451
11452#. type: Labeled list
11453#: ../misc-utils/cal.1.adoc:69
11454#, no-wrap
11455msgid "*-1*, *--one*"
11456msgstr ""
11457
11458#. type: Plain text
11459#: ../misc-utils/cal.1.adoc:71
11460msgid "Display single month output. (This is the default.)"
11461msgstr ""
11462
11463#. type: Labeled list
11464#: ../misc-utils/cal.1.adoc:72
11465#, no-wrap
11466msgid "*-3*, *--three*"
11467msgstr ""
11468
11469#. type: Plain text
11470#: ../misc-utils/cal.1.adoc:74
11471msgid "Display three months spanning the date."
11472msgstr ""
11473
11474#. type: Labeled list
11475#: ../misc-utils/cal.1.adoc:75
11476#, no-wrap
11477msgid "*-n , --months* _number_"
11478msgstr ""
11479
11480#. type: Plain text
11481#: ../misc-utils/cal.1.adoc:77
11482msgid "Display _number_ of months, starting from the month containing the date."
11483msgstr ""
11484
11485#. type: Labeled list
11486#: ../misc-utils/cal.1.adoc:78
11487#, no-wrap
11488msgid "*-S, --span*"
11489msgstr ""
11490
11491#. type: Plain text
11492#: ../misc-utils/cal.1.adoc:80
11493msgid "Display months spanning the date."
11494msgstr ""
11495
11496#. type: Labeled list
11497#: ../misc-utils/cal.1.adoc:81
11498#, no-wrap
11499msgid "*-s*, *--sunday*"
11500msgstr ""
11501
11502#. type: Plain text
11503#: ../misc-utils/cal.1.adoc:83
11504msgid "Display Sunday as the first day of the week."
11505msgstr ""
11506
11507#. type: Labeled list
11508#: ../misc-utils/cal.1.adoc:84
11509#, no-wrap
11510msgid "*-m*, *--monday*"
11511msgstr ""
11512
11513#. type: Plain text
11514#: ../misc-utils/cal.1.adoc:86
11515msgid "Display Monday as the first day of the week."
11516msgstr ""
11517
11518#. type: Labeled list
11519#: ../misc-utils/cal.1.adoc:87 ../misc-utils/namei.1.adoc:53
11520#, no-wrap
11521msgid "*-v*, *--vertical*"
11522msgstr ""
11523
11524#. type: Plain text
11525#: ../misc-utils/cal.1.adoc:89
11526msgid "Display using a vertical layout (aka *ncal*(1) mode)."
11527msgstr ""
11528
11529#. type: Labeled list
11530#: ../misc-utils/cal.1.adoc:90
11531#, no-wrap
11532msgid "*--iso*"
11533msgstr ""
11534
11535#. type: Plain text
11536#: ../misc-utils/cal.1.adoc:92
11537msgid ""
11538"Display the proleptic Gregorian calendar exclusively. This option does not "
11539"affect week numbers and the first day of the week. See *--reform* below."
11540msgstr ""
11541
11542#. type: Labeled list
11543#: ../misc-utils/cal.1.adoc:93
11544#, no-wrap
11545msgid "*-j*, *--julian*"
11546msgstr ""
11547
11548#. type: Plain text
11549#: ../misc-utils/cal.1.adoc:95
11550msgid ""
11551"Use day-of-year numbering for all calendars. These are also called ordinal "
11552"days. Ordinal days range from 1 to 366. This option does not switch from the "
11553"Gregorian to the Julian calendar system, that is controlled by the "
11554"*--reform* option."
11555msgstr ""
11556
11557#. type: Plain text
11558#: ../misc-utils/cal.1.adoc:97
11559msgid ""
11560"Sometimes Gregorian calendars using ordinal dates are referred to as Julian "
11561"calendars. This can be confusing due to the many date related conventions "
11562"that use Julian in their name: (ordinal) julian date, julian (calendar) "
11563"date, (astronomical) julian date, (modified) julian date, and more. This "
11564"option is named julian, because ordinal days are identified as julian by the "
11565"POSIX standard. However, be aware that *cal* also uses the Julian calendar "
11566"system. See *DESCRIPTION* above."
11567msgstr ""
11568
11569#. type: Labeled list
11570#: ../misc-utils/cal.1.adoc:98
11571#, no-wrap
11572msgid "*--reform* _val_"
11573msgstr ""
11574
11575#. type: Plain text
11576#: ../misc-utils/cal.1.adoc:100
11577msgid ""
11578"This option sets the adoption date of the Gregorian calendar "
11579"reform. Calendar dates previous to reform use the Julian calendar "
11580"system. Calendar dates after reform use the Gregorian calendar system. The "
11581"argument _val_ can be:"
11582msgstr ""
11583
11584#. type: Plain text
11585#: ../misc-utils/cal.1.adoc:102
11586msgid ""
11587"_1752_ - sets 3 September 1752 as the reform date (default). This is when "
11588"the Gregorian calendar reform was adopted by the British Empire."
11589msgstr ""
11590
11591#. type: Plain text
11592#: ../misc-utils/cal.1.adoc:103
11593msgid ""
11594"_gregorian_ - display Gregorian calendars exclusively. This special "
11595"placeholder sets the reform date below the smallest year that *cal* can use; "
11596"meaning all calendar output uses the Gregorian calendar system. This is "
11597"called the proleptic Gregorian calendar, because dates prior to the calendar "
11598"system's creation use extrapolated values."
11599msgstr ""
11600
11601#. type: Plain text
11602#: ../misc-utils/cal.1.adoc:104
11603msgid ""
11604"_iso_ - alias of _gregorian_. The ISO 8601 standard for the representation "
11605"of dates and times in information interchange requires using the proleptic "
11606"Gregorian calendar."
11607msgstr ""
11608
11609#. type: Plain text
11610#: ../misc-utils/cal.1.adoc:105
11611msgid ""
11612"_julian_ - display Julian calendars exclusively. This special placeholder "
11613"sets the reform date above the largest year that *cal* can use; meaning all "
11614"calendar output uses the Julian calendar system."
11615msgstr ""
11616
11617#. type: Plain text
11618#: ../misc-utils/cal.1.adoc:107
11619msgid "See *DESCRIPTION* above."
11620msgstr ""
11621
11622#. type: Labeled list
11623#: ../misc-utils/cal.1.adoc:108
11624#, no-wrap
11625msgid "*-y*, *--year*"
11626msgstr ""
11627
11628#. type: Plain text
11629#: ../misc-utils/cal.1.adoc:110
11630msgid "Display a calendar for the whole year."
11631msgstr ""
11632
11633#. type: Labeled list
11634#: ../misc-utils/cal.1.adoc:111
11635#, no-wrap
11636msgid "*-Y, --twelve*"
11637msgstr ""
11638
11639#. type: Plain text
11640#: ../misc-utils/cal.1.adoc:113
11641msgid "Display a calendar for the next twelve months."
11642msgstr ""
11643
11644#. type: Labeled list
11645#: ../misc-utils/cal.1.adoc:114
11646#, no-wrap
11647msgid "*-w*, *--week*[=_number_]"
11648msgstr ""
11649
11650#. type: Plain text
11651#: ../misc-utils/cal.1.adoc:116
11652msgid ""
11653"Display week numbers in the calendar (US or ISO-8601). See NOTES section for "
11654"more details."
11655msgstr ""
11656
11657#. type: Labeled list
11658#: ../misc-utils/cal.1.adoc:117
11659#, no-wrap
11660msgid "*--color*[=_when_]"
11661msgstr ""
11662
11663#. type: Labeled list
11664#: ../misc-utils/cal.1.adoc:128
11665#, no-wrap
11666msgid "*Single digits-only parameter (e.g., 'cal 2020')*"
11667msgstr ""
11668
11669#. type: Plain text
11670#: ../misc-utils/cal.1.adoc:130
11671msgid ""
11672"Specifies the _year_ to be displayed; note the year must be fully specified: "
11673"*cal 89* will not display a calendar for 1989."
11674msgstr ""
11675
11676#. type: Labeled list
11677#: ../misc-utils/cal.1.adoc:131
11678#, no-wrap
11679msgid "*Single string parameter (e.g., 'cal tomorrow' or 'cal August')*"
11680msgstr ""
11681
11682#. type: Plain text
11683#: ../misc-utils/cal.1.adoc:133
11684msgid ""
11685"Specifies _timestamp_ or a _month name_ (or abbreviated name) according to "
11686"the current locales."
11687msgstr ""
11688
11689#. type: Plain text
11690#: ../misc-utils/cal.1.adoc:135
11691msgid ""
11692"The special placeholders are accepted when parsing timestamp, \"now\" may be "
11693"used to refer to the current time, \"today\", \"yesterday\", \"tomorrow\" "
11694"refer to of the current day, the day before or the next day, respectively."
11695msgstr ""
11696
11697#. TRANSLATORS: Please keep {plus} untranslated.
11698#. type: Plain text
11699#: ../misc-utils/cal.1.adoc:138
11700msgid ""
11701"The relative date specifications are also accepted, in this case \"{plus}\" "
11702"is evaluated to the current time plus the specified time "
11703"span. Correspondingly, a time span that is prefixed with \"-\" is evaluated "
11704"to the current time minus the specified time span, for example "
11705"'{plus}2days'. Instead of prefixing the time span with \"{plus}\" or \"-\", "
11706"it may also be suffixed with a space and the word \"left\" or \"ago\" (for "
11707"example '1 week ago')."
11708msgstr ""
11709
11710#. type: Labeled list
11711#: ../misc-utils/cal.1.adoc:139
11712#, no-wrap
11713msgid "*Two parameters (e.g., 'cal 11 2020')*"
11714msgstr ""
11715
11716#. type: Plain text
11717#: ../misc-utils/cal.1.adoc:141
11718msgid "Denote the _month_ (1 - 12) and _year_."
11719msgstr ""
11720
11721#. type: Labeled list
11722#: ../misc-utils/cal.1.adoc:142
11723#, no-wrap
11724msgid "*Three parameters (e.g., 'cal 25 11 2020')*"
11725msgstr ""
11726
11727#. type: Plain text
11728#: ../misc-utils/cal.1.adoc:144
11729msgid ""
11730"Denote the _day_ (1-31), _month and year_, and the day will be highlighted "
11731"if the calendar is displayed on a terminal. If no parameters are specified, "
11732"the current month's calendar is displayed."
11733msgstr ""
11734
11735#. type: Plain text
11736#: ../misc-utils/cal.1.adoc:148
11737msgid ""
11738"A year starts on January 1. The first day of the week is determined by the "
11739"locale or the *--sunday* and *--monday* options."
11740msgstr ""
11741
11742#. type: Plain text
11743#: ../misc-utils/cal.1.adoc:150
11744msgid ""
11745"The week numbering depends on the choice of the first day of the week. If it "
11746"is Sunday then the customary North American numbering is used, where 1 "
11747"January is in week number 1. If it is Monday (*-m*) then the ISO 8601 "
11748"standard week numbering is used, where the first Thursday is in week number "
11749"1."
11750msgstr ""
11751
11752#. type: Plain text
11753#: ../misc-utils/cal.1.adoc:154
11754msgid "Implicit coloring can be disabled as follows:"
11755msgstr ""
11756
11757#. type: delimited block _
11758#: ../misc-utils/cal.1.adoc:157
11759#, no-wrap
11760msgid "*touch /etc/terminal-colors.d/cal.disable*\n"
11761msgstr ""
11762
11763#. type: Plain text
11764#: ../misc-utils/cal.1.adoc:164
11765msgid "A *cal* command appeared in Version 6 AT&T UNIX."
11766msgstr ""
11767
11768#. type: Plain text
11769#: ../misc-utils/cal.1.adoc:168
11770msgid ""
11771"The default *cal* output uses 3 September 1752 as the Gregorian calendar "
11772"reform date. The historical reform dates for the other locales, including "
11773"its introduction in October 1582, are not implemented."
11774msgstr ""
11775
11776#. type: Plain text
11777#: ../misc-utils/cal.1.adoc:170
11778msgid ""
11779"Alternative calendars, such as the Umm al-Qura, the Solar Hijri, the Ge'ez, "
11780"or the lunisolar Hindu, are not supported."
11781msgstr ""
11782
11783#. Copyright 2017 Red Hat, Inc.
11784#
11785#. This file may be copied under the terms of the GNU Public License.
11786#. type: Title =
11787#: ../misc-utils/fincore.1.adoc:7
11788#, no-wrap
11789msgid "fincore(1)"
11790msgstr ""
11791
11792#. type: Plain text
11793#: ../misc-utils/fincore.1.adoc:18
11794msgid "fincore - count pages of file contents in core"
11795msgstr ""
11796
11797#. type: Plain text
11798#: ../misc-utils/fincore.1.adoc:22
11799#, no-wrap
11800msgid "*fincore* [options] _file_...\n"
11801msgstr ""
11802
11803#. type: Plain text
11804#: ../misc-utils/fincore.1.adoc:26
11805#, no-wrap
11806msgid ""
11807"*fincore* counts pages of file contents being resident in memory (in core), "
11808"and reports the numbers. If an error occurs during counting, then an error "
11809"message is printed to the stderr and *fincore* continues processing the rest "
11810"of files listed in a command line.\n"
11811msgstr ""
11812
11813#. type: Plain text
11814#: ../misc-utils/fincore.1.adoc:28
11815msgid ""
11816"The default output is subject to change. So whenever possible, you should "
11817"avoid using default outputs in your scripts. Always explicitly define "
11818"expected columns by using *--output* _columns-list_ in environments where a "
11819"stable output is required."
11820msgstr ""
11821
11822#. type: Labeled list
2bee5365 11823#: ../misc-utils/fincore.1.adoc:31 ../misc-utils/findmnt.8.adoc:88
36e96905
MB
11824#: ../misc-utils/lsblk.8.adoc:75 ../misc-utils/lslocks.8.adoc:45
11825#: ../misc-utils/uuidparse.1.adoc:53 ../sys-utils/losetup.8.adoc:107
11826#: ../sys-utils/lsirq.1.adoc:25 ../sys-utils/lsmem.1.adoc:45
11827#: ../sys-utils/lsns.8.adoc:40 ../sys-utils/rfkill.8.adoc:30
11828#: ../sys-utils/wdctl.8.adoc:36 ../sys-utils/zramctl.8.adoc:47
11829#, no-wrap
11830msgid "*-n*, *--noheadings*"
11831msgstr ""
11832
11833#. type: Plain text
11834#: ../misc-utils/fincore.1.adoc:33 ../sys-utils/zramctl.8.adoc:49
11835msgid "Do not print a header line in status output."
11836msgstr ""
11837
11838#. type: Plain text
11839#: ../misc-utils/fincore.1.adoc:36 ../misc-utils/lsblk.8.adoc:36
11840#: ../misc-utils/lslocks.8.adoc:38 ../sys-utils/lsmem.1.adoc:38
11841msgid "Print the SIZE column in bytes rather than in a human-readable format."
11842msgstr ""
11843
11844#. TRANSLATORS: Keep {plus} untranslated.
11845#. type: Plain text
11846#: ../misc-utils/fincore.1.adoc:40
11847msgid ""
11848"Define output columns. See the *--help* output to get a list of the "
11849"currently supported columns. The default list of columns may be extended if "
11850"_list_ is specified in the format _{plus}list_."
11851msgstr ""
11852
11853#. type: Plain text
11854#: ../misc-utils/fincore.1.adoc:43 ../sys-utils/lsmem.1.adoc:59
11855msgid ""
11856"Produce output in raw format. All potentially unsafe characters are "
11857"hex-escaped (\\x<code>)."
11858msgstr ""
11859
11860#. type: Labeled list
2bee5365 11861#: ../misc-utils/fincore.1.adoc:44 ../misc-utils/findmnt.8.adoc:70
36e96905
MB
11862#: ../misc-utils/lsblk.8.adoc:63 ../misc-utils/lslocks.8.adoc:42
11863#: ../misc-utils/uuidparse.1.adoc:50 ../misc-utils/wipefs.8.adoc:52
11864#: ../sys-utils/losetup.8.adoc:113 ../sys-utils/lscpu.1.adoc:119
11865#: ../sys-utils/lsipc.1.adoc:54 ../sys-utils/lsirq.1.adoc:34
11866#: ../sys-utils/lsmem.1.adoc:42 ../sys-utils/lsns.8.adoc:34
11867#: ../sys-utils/rfkill.8.adoc:27
11868#, no-wrap
11869msgid "*-J*, *--json*"
11870msgstr ""
11871
11872#. type: Plain text
2bee5365 11873#: ../misc-utils/fincore.1.adoc:46 ../misc-utils/findmnt.8.adoc:72
36e96905
MB
11874#: ../misc-utils/lslocks.8.adoc:44 ../misc-utils/uuidparse.1.adoc:52
11875#: ../misc-utils/wipefs.8.adoc:54 ../sys-utils/lsirq.1.adoc:36
11876#: ../sys-utils/lsmem.1.adoc:44 ../sys-utils/lsns.8.adoc:36
11877#: ../sys-utils/rfkill.8.adoc:29
11878msgid "Use JSON output format."
11879msgstr ""
11880
11881#. type: Plain text
11882#: ../misc-utils/fincore.1.adoc:56
11883msgid "mailto:yamato@redhat.com[Masatake YAMATO]"
11884msgstr ""
11885
11886#. type: Plain text
11887#: ../misc-utils/fincore.1.adoc:62
11888#, no-wrap
11889msgid ""
11890"*mincore*(2),\n"
11891"*getpagesize*(2),\n"
11892"*getconf*(1p)\n"
11893msgstr ""
11894
11895#. Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved.
11896#. This file may be copied under the terms of the GNU Public License.
11897#. type: Title =
11898#: ../misc-utils/findfs.8.adoc:4
11899#, no-wrap
11900msgid "findfs(8)"
11901msgstr ""
11902
11903#. type: Plain text
11904#: ../misc-utils/findfs.8.adoc:14
11905msgid "findfs - find a filesystem by label or UUID"
11906msgstr ""
11907
11908#. type: Plain text
11909#: ../misc-utils/findfs.8.adoc:18
11910#, no-wrap
11911msgid "*findfs* *NAME*=_value_\n"
11912msgstr ""
11913
11914#. type: Plain text
11915#: ../misc-utils/findfs.8.adoc:22
11916#, no-wrap
11917msgid ""
11918"*findfs* will search the block devices in the system looking for a "
11919"filesystem or partition with specified tag. The currently supported tags "
11920"are:\n"
11921msgstr ""
11922
11923#. type: Labeled list
11924#: ../misc-utils/findfs.8.adoc:23
11925#, no-wrap
11926msgid "*LABEL*=_<label>_"
11927msgstr ""
11928
11929#. type: Plain text
11930#: ../misc-utils/findfs.8.adoc:25
11931msgid "Specifies filesystem label."
11932msgstr ""
11933
11934#. type: Labeled list
11935#: ../misc-utils/findfs.8.adoc:26
11936#, no-wrap
11937msgid "*UUID*=_<uuid>_"
11938msgstr ""
11939
11940#. type: Plain text
11941#: ../misc-utils/findfs.8.adoc:28
11942msgid "Specifies filesystem UUID."
11943msgstr ""
11944
11945#. type: Labeled list
11946#: ../misc-utils/findfs.8.adoc:29
11947#, no-wrap
11948msgid "*PARTUUID*=_<uuid>_"
11949msgstr ""
11950
11951#. type: Plain text
11952#: ../misc-utils/findfs.8.adoc:31
11953msgid ""
11954"Specifies partition UUID. This partition identifier is supported for example "
11955"for GUID Partition Table (GPT) partition tables."
11956msgstr ""
11957
11958#. type: Labeled list
11959#: ../misc-utils/findfs.8.adoc:32
11960#, no-wrap
11961msgid "*PARTLABEL*=_<label>_"
11962msgstr ""
11963
11964#. type: Plain text
11965#: ../misc-utils/findfs.8.adoc:34
11966msgid ""
11967"Specifies partition label (name). The partition labels are supported for "
11968"example for GUID Partition Table (GPT) or MAC partition tables."
11969msgstr ""
11970
11971#. type: Plain text
11972#: ../misc-utils/findfs.8.adoc:36
11973msgid ""
11974"If the filesystem or partition is found, the device name will be printed on "
11975"stdout."
11976msgstr ""
11977
11978#. type: Plain text
11979#: ../misc-utils/findfs.8.adoc:38
11980msgid ""
11981"The complete overview about filesystems and partitions you can get for "
11982"example by"
11983msgstr ""
11984
11985#. type: delimited block _
11986#: ../misc-utils/findfs.8.adoc:41
11987#, no-wrap
11988msgid "*lsblk --fs*\n"
11989msgstr ""
11990
11991#. type: delimited block _
11992#: ../misc-utils/findfs.8.adoc:43
11993#, no-wrap
11994msgid "*partx --show <disk>*\n"
11995msgstr ""
11996
11997#. type: delimited block _
11998#: ../misc-utils/findfs.8.adoc:45
11999#, no-wrap
12000msgid "*blkid*\n"
12001msgstr ""
12002
12003#. type: Plain text
12004#: ../misc-utils/findfs.8.adoc:53
12005msgid "label or uuid cannot be found"
12006msgstr ""
12007
12008#. type: Plain text
12009#: ../misc-utils/findfs.8.adoc:55
12010msgid "usage error, wrong number of arguments or unknown option"
12011msgstr ""
12012
12013#. type: Plain text
12014#: ../misc-utils/findfs.8.adoc:64
12015#, no-wrap
12016msgid ""
12017"*findfs* was originally written by mailto:tytso@mit.edu[Theodore Ts'o] and "
12018"re-written for the util-linux package by mailto:kzak@redhat.com[Karel "
12019"Zak].\n"
12020msgstr ""
12021
12022#. type: Plain text
12023#: ../misc-utils/findfs.8.adoc:70
12024#, no-wrap
12025msgid ""
12026"*blkid*(8),\n"
12027"*lsblk*(8),\n"
12028"*partx*(8)\n"
12029msgstr ""
12030
12031#. type: Title =
12032#: ../misc-utils/findmnt.8.adoc:2
12033#, no-wrap
12034msgid "findmnt(8)"
12035msgstr ""
12036
12037#. type: Plain text
12038#: ../misc-utils/findmnt.8.adoc:13
12039msgid "findmnt - find a filesystem"
12040msgstr ""
12041
12042#. type: Plain text
12043#: ../misc-utils/findmnt.8.adoc:17
12044#, no-wrap
12045msgid "*findmnt* [options]\n"
12046msgstr ""
12047
12048#. type: Plain text
12049#: ../misc-utils/findmnt.8.adoc:19
12050#, no-wrap
12051msgid "*findmnt* [options] _device_|_mountpoint_\n"
12052msgstr ""
12053
12054#. type: Plain text
12055#: ../misc-utils/findmnt.8.adoc:21
12056#, no-wrap
12057msgid ""
2bee5365
MB
12058"*findmnt* [options] [*--source*] _device_ [*--target* _path_|*--mountpoint* "
12059"_mountpoint_]\n"
36e96905
MB
12060msgstr ""
12061
12062#. type: Plain text
12063#: ../misc-utils/findmnt.8.adoc:25
12064#, no-wrap
12065msgid ""
12066"*findmnt* will list all mounted filesystems or search for a filesystem. The "
5db1d29a 12067"*findmnt* command is able to search in _/etc/fstab_, _/etc/mtab_ or "
36e96905
MB
12068"_/proc/self/mountinfo_. If _device_ or _mountpoint_ is not given, all "
12069"filesystems are shown.\n"
12070msgstr ""
12071
12072#. type: Plain text
12073#: ../misc-utils/findmnt.8.adoc:27
12074msgid ""
12075"The device may be specified by device name, major:minor numbers, filesystem "
5db1d29a 12076"label or UUID, or partition label or UUID. Note that *findmnt* follows "
36e96905
MB
12077"*mount*(8) behavior where a device name may be interpreted as a mountpoint "
12078"(and vice versa) if the *--target*, *--mountpoint* or *--source* options are "
12079"not specified."
12080msgstr ""
12081
12082#. type: Plain text
12083#: ../misc-utils/findmnt.8.adoc:29
12084msgid ""
2bee5365
MB
12085"The command-line option *--target* accepts any file or directory and then "
12086"*findmnt* displays the filesystem for the given path."
12087msgstr ""
12088
12089#. type: Plain text
12090#: ../misc-utils/findmnt.8.adoc:31
12091msgid ""
36e96905
MB
12092"The command prints all mounted filesystems in the tree-like format by "
12093"default."
12094msgstr ""
12095
12096#. type: Labeled list
2bee5365 12097#: ../misc-utils/findmnt.8.adoc:34
36e96905
MB
12098#, no-wrap
12099msgid "*-A*, *--all*"
12100msgstr ""
12101
12102#. type: Plain text
2bee5365 12103#: ../misc-utils/findmnt.8.adoc:36
36e96905
MB
12104msgid "Disable all built-in filters and print all filesystems."
12105msgstr ""
12106
12107#. type: Labeled list
2bee5365 12108#: ../misc-utils/findmnt.8.adoc:37
36e96905
MB
12109#, no-wrap
12110msgid "*-a*, *--ascii*"
12111msgstr ""
12112
12113#. type: Plain text
2bee5365 12114#: ../misc-utils/findmnt.8.adoc:39
36e96905
MB
12115msgid "Use ascii characters for tree formatting."
12116msgstr ""
12117
12118#. type: Plain text
2bee5365 12119#: ../misc-utils/findmnt.8.adoc:42
36e96905
MB
12120msgid ""
12121"Print the SIZE, USED and AVAIL columns in bytes rather than in a "
12122"human-readable format."
12123msgstr ""
12124
12125#. type: Labeled list
2bee5365 12126#: ../misc-utils/findmnt.8.adoc:43
36e96905
MB
12127#, no-wrap
12128msgid "*-C*, *--nocanonicalize*"
12129msgstr ""
12130
12131#. type: Plain text
2bee5365 12132#: ../misc-utils/findmnt.8.adoc:45
36e96905
MB
12133msgid ""
12134"Do not canonicalize paths at all. This option affects the comparing of paths "
12135"and the evaluation of tags (LABEL, UUID, etc.)."
12136msgstr ""
12137
12138#. type: Labeled list
2bee5365 12139#: ../misc-utils/findmnt.8.adoc:46
36e96905
MB
12140#, no-wrap
12141msgid "*-c*, *--canonicalize*"
12142msgstr ""
12143
12144#. type: Plain text
2bee5365 12145#: ../misc-utils/findmnt.8.adoc:48
36e96905
MB
12146msgid "Canonicalize all printed paths."
12147msgstr ""
12148
12149#. type: Labeled list
2bee5365 12150#: ../misc-utils/findmnt.8.adoc:49
36e96905
MB
12151#, no-wrap
12152msgid "*-D*, *--df*"
12153msgstr ""
12154
12155#. type: Plain text
2bee5365 12156#: ../misc-utils/findmnt.8.adoc:51
36e96905
MB
12157msgid ""
12158"Imitate the output of df1. This option is equivalent to *-o "
12159"SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET* but excludes all pseudo "
12160"filesystems. Use *--all* to print all filesystems."
12161msgstr ""
12162
12163#. type: Labeled list
2bee5365 12164#: ../misc-utils/findmnt.8.adoc:52
36e96905
MB
12165#, no-wrap
12166msgid "*-d*, *--direction* _word_"
12167msgstr ""
12168
12169#. type: Plain text
2bee5365 12170#: ../misc-utils/findmnt.8.adoc:54
36e96905
MB
12171msgid "The search direction, either *forward* or *backward*."
12172msgstr ""
12173
12174#. type: Labeled list
2bee5365 12175#: ../misc-utils/findmnt.8.adoc:55
36e96905
MB
12176#, no-wrap
12177msgid "*-e*, *--evaluate*"
12178msgstr ""
12179
12180#. type: Plain text
2bee5365 12181#: ../misc-utils/findmnt.8.adoc:57
36e96905
MB
12182msgid ""
12183"Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the corresponding "
12184"device names."
12185msgstr ""
12186
12187#. type: Labeled list
2bee5365 12188#: ../misc-utils/findmnt.8.adoc:58
36e96905
MB
12189#, no-wrap
12190msgid "*-F*, *--tab-file* _path_"
12191msgstr ""
12192
12193#. type: Plain text
2bee5365 12194#: ../misc-utils/findmnt.8.adoc:60
36e96905
MB
12195msgid ""
12196"Search in an alternative file. If used with *--fstab*, *--mtab* or "
12197"*--kernel*, then it overrides the default paths. If specified more than "
12198"once, then tree-like output is disabled (see the *--list* option)."
12199msgstr ""
12200
12201#. type: Labeled list
2bee5365 12202#: ../misc-utils/findmnt.8.adoc:61
36e96905
MB
12203#, no-wrap
12204msgid "*-f*, *--first-only*"
12205msgstr ""
12206
12207#. type: Plain text
2bee5365 12208#: ../misc-utils/findmnt.8.adoc:63
36e96905
MB
12209msgid "Print the first matching filesystem only."
12210msgstr ""
12211
12212#. type: Labeled list
2bee5365 12213#: ../misc-utils/findmnt.8.adoc:67
36e96905
MB
12214#, no-wrap
12215msgid "*-i*, *--invert*"
12216msgstr ""
12217
12218#. type: Plain text
2bee5365 12219#: ../misc-utils/findmnt.8.adoc:69
36e96905
MB
12220msgid "Invert the sense of matching."
12221msgstr ""
12222
12223#. type: Labeled list
2bee5365 12224#: ../misc-utils/findmnt.8.adoc:73 ../sys-utils/dmesg.1.adoc:72
36e96905
MB
12225#, no-wrap
12226msgid "*-k*, *--kernel*"
12227msgstr ""
12228
12229#. type: Plain text
2bee5365 12230#: ../misc-utils/findmnt.8.adoc:75
36e96905
MB
12231msgid ""
12232"Search in _/proc/self/mountinfo_. The output is in the tree-like "
12233"format. This is the default. The output contains only mount options "
12234"maintained by kernel (see also *--mtab)*."
12235msgstr ""
12236
12237#. type: Plain text
2bee5365 12238#: ../misc-utils/findmnt.8.adoc:78
36e96905
MB
12239msgid ""
12240"Use the list output format. This output format is automatically enabled if "
12241"the output is restricted by the *-t*, *-O*, *-S* or *-T* option and the "
12242"option *--submounts* is not used or if more that one source file (the option "
12243"*-F*) is specified."
12244msgstr ""
12245
12246#. type: Labeled list
2bee5365 12247#: ../misc-utils/findmnt.8.adoc:79
36e96905
MB
12248#, no-wrap
12249msgid "*-M*, *--mountpoint* _path_"
12250msgstr ""
12251
12252#. type: Plain text
2bee5365 12253#: ../misc-utils/findmnt.8.adoc:81
36e96905
MB
12254msgid "Explicitly define the mountpoint file or directory. See also *--target*."
12255msgstr ""
12256
12257#. type: Labeled list
2bee5365 12258#: ../misc-utils/findmnt.8.adoc:82
36e96905
MB
12259#, no-wrap
12260msgid "*-m*, *--mtab*"
12261msgstr ""
12262
12263#. type: Plain text
2bee5365 12264#: ../misc-utils/findmnt.8.adoc:84
36e96905
MB
12265msgid ""
12266"Search in _/etc/mtab_. The output is in the list format by default (see "
12267"*--tree*). The output may include user space mount options."
12268msgstr ""
12269
12270#. type: Labeled list
2bee5365 12271#: ../misc-utils/findmnt.8.adoc:85
36e96905
MB
12272#, no-wrap
12273msgid "*-N*, *--task* _tid_"
12274msgstr ""
12275
12276#. type: Plain text
2bee5365 12277#: ../misc-utils/findmnt.8.adoc:87
36e96905
MB
12278msgid ""
12279"Use alternative namespace _/proc/<tid>/mountinfo_ rather than the default "
12280"_/proc/self/mountinfo_. If the option is specified more than once, then "
12281"tree-like output is disabled (see the *--list* option). See also the "
12282"*unshare*(1) command."
12283msgstr ""
12284
12285#. type: Labeled list
2bee5365 12286#: ../misc-utils/findmnt.8.adoc:91
36e96905
MB
12287#, no-wrap
12288msgid "*-O*, *--options* _list_"
12289msgstr ""
12290
12291#. TRANSLATORS: Keep {plus} untranslated.
12292#. type: Plain text
2bee5365 12293#: ../misc-utils/findmnt.8.adoc:94
36e96905
MB
12294msgid ""
12295"Limit the set of printed filesystems. More than one option may be specified "
12296"in a comma-separated list. The *-t* and *-O* options are cumulative in "
12297"effect. It is different from *-t* in that each option is matched exactly; a "
12298"leading _no_ at the beginning does not have global meaning. The \"no\" can "
12299"used for individual items in the list. The \"no\" prefix interpretation can "
12300"be disabled by \"{plus}\" prefix."
12301msgstr ""
12302
12303#. type: Plain text
2bee5365 12304#: ../misc-utils/findmnt.8.adoc:97
36e96905
MB
12305msgid ""
12306"Define output columns. See the *--help* output to get a list of the "
12307"currently supported columns. The *TARGET* column contains tree formatting if "
12308"the *--list* or *--raw* options are not specified."
12309msgstr ""
12310
12311#. TRANSLATORS: Keep {plus} untranslated.
12312#. type: Plain text
2bee5365 12313#: ../misc-utils/findmnt.8.adoc:100
36e96905
MB
12314msgid ""
12315"The default list of columns may be extended if _list_ is specified in the "
12316"format _{plus}list_ (e.g., *findmnt -o {plus}PROPAGATION*)."
12317msgstr ""
12318
12319#. type: Plain text
2bee5365 12320#: ../misc-utils/findmnt.8.adoc:103
36e96905
MB
12321msgid ""
12322"Output almost all available columns. The columns that require *--poll* are "
12323"not included."
12324msgstr ""
12325
12326#. type: Plain text
2bee5365 12327#: ../misc-utils/findmnt.8.adoc:106
36e96905
MB
12328msgid ""
12329"Produce output in the form of key=\"value\" pairs. All potentially unsafe "
12330"value characters are hex-escaped (\\x<code>). The key (variable name) will "
12331"be modified to contain only characters allowed for a shell variable "
12332"identifiers, for example, FS_OPTIONS and USE_PCT instead of FS-OPTIONS and "
12333"USE%."
12334msgstr ""
12335
12336#. type: Labeled list
2bee5365 12337#: ../misc-utils/findmnt.8.adoc:107
36e96905
MB
12338#, no-wrap
12339msgid "*-p*, *--poll*[_=list_]"
12340msgstr ""
12341
12342#. type: Plain text
2bee5365 12343#: ../misc-utils/findmnt.8.adoc:109
36e96905
MB
12344msgid ""
12345"Monitor changes in the _/proc/self/mountinfo_ file. Supported actions are: "
12346"mount, umount, remount and move. More than one action may be specified in a "
12347"comma-separated list. All actions are monitored by default."
12348msgstr ""
12349
12350#. type: Plain text
2bee5365 12351#: ../misc-utils/findmnt.8.adoc:111
36e96905
MB
12352msgid ""
12353"The time for which *--poll* will block can be restricted with the "
12354"*--timeout* or *--first-only* options."
12355msgstr ""
12356
12357#. type: Plain text
2bee5365 12358#: ../misc-utils/findmnt.8.adoc:113
36e96905
MB
12359msgid ""
12360"The standard columns always use the new version of the information from the "
12361"mountinfo file, except the umount action which is based on the original "
12362"information cached by *findmnt*. The poll mode allows using extra columns:"
12363msgstr ""
12364
12365#. type: Labeled list
2bee5365 12366#: ../misc-utils/findmnt.8.adoc:114
36e96905
MB
12367#, no-wrap
12368msgid "*ACTION*"
12369msgstr ""
12370
12371#. type: Plain text
2bee5365 12372#: ../misc-utils/findmnt.8.adoc:116
36e96905
MB
12373msgid ""
12374"mount, umount, move or remount action name; this column is enabled by "
12375"default"
12376msgstr ""
12377
12378#. type: Labeled list
2bee5365 12379#: ../misc-utils/findmnt.8.adoc:116
36e96905
MB
12380#, no-wrap
12381msgid "*OLD-TARGET*"
12382msgstr ""
12383
12384#. type: Plain text
2bee5365 12385#: ../misc-utils/findmnt.8.adoc:118
36e96905
MB
12386msgid "available for umount and move actions"
12387msgstr ""
12388
12389#. type: Labeled list
2bee5365 12390#: ../misc-utils/findmnt.8.adoc:118
36e96905
MB
12391#, no-wrap
12392msgid "*OLD-OPTIONS*"
12393msgstr ""
12394
12395#. type: Plain text
2bee5365 12396#: ../misc-utils/findmnt.8.adoc:120
36e96905
MB
12397msgid "available for umount and remount actions"
12398msgstr ""
12399
12400#. type: Labeled list
2bee5365 12401#: ../misc-utils/findmnt.8.adoc:121
36e96905
MB
12402#, no-wrap
12403msgid "*--pseudo*"
12404msgstr ""
12405
12406#. type: Plain text
2bee5365 12407#: ../misc-utils/findmnt.8.adoc:123
36e96905
MB
12408msgid "Print only pseudo filesystems."
12409msgstr ""
12410
12411#. type: Labeled list
2bee5365 12412#: ../misc-utils/findmnt.8.adoc:124
36e96905
MB
12413#, no-wrap
12414msgid "*--shadow*"
12415msgstr ""
12416
12417#. type: Plain text
2bee5365 12418#: ../misc-utils/findmnt.8.adoc:126
36e96905
MB
12419msgid "Print only filesystems over-mounted by another filesystem."
12420msgstr ""
12421
12422#. type: Labeled list
2bee5365 12423#: ../misc-utils/findmnt.8.adoc:127
36e96905
MB
12424#, no-wrap
12425msgid "*-R*, *--submounts*"
12426msgstr ""
12427
12428#. type: Plain text
2bee5365 12429#: ../misc-utils/findmnt.8.adoc:129
36e96905
MB
12430msgid ""
12431"Print recursively all submounts for the selected filesystems. The "
5db1d29a
MB
12432"restrictions defined by options *-t*, *-O*, *-S*, *-T* and *--direction* are "
12433"not applied to submounts. All submounts are always printed in tree-like "
36e96905
MB
12434"order. The option enables the tree-like output format by default. This "
12435"option has no effect for *--mtab* or *--fstab*."
12436msgstr ""
12437
12438#. type: Plain text
2bee5365 12439#: ../misc-utils/findmnt.8.adoc:132
36e96905
MB
12440msgid ""
12441"Use raw output format. All potentially unsafe characters are hex-escaped "
12442"(\\x<code>)."
12443msgstr ""
12444
12445#. type: Labeled list
2bee5365 12446#: ../misc-utils/findmnt.8.adoc:133
36e96905
MB
12447#, no-wrap
12448msgid "*--real*"
12449msgstr ""
12450
12451#. type: Plain text
2bee5365 12452#: ../misc-utils/findmnt.8.adoc:135
36e96905
MB
12453msgid "Print only real filesystems."
12454msgstr ""
12455
12456#. type: Labeled list
2bee5365 12457#: ../misc-utils/findmnt.8.adoc:136
36e96905
MB
12458#, no-wrap
12459msgid "*-S*, *--source* _spec_"
12460msgstr ""
12461
12462#. type: Plain text
2bee5365 12463#: ../misc-utils/findmnt.8.adoc:138
36e96905
MB
12464msgid ""
12465"Explicitly define the mount source. Supported specifications are _device_, "
12466"__maj__**:**_min_, **LABEL=**__label__, **UUID=**__uuid__, "
12467"**PARTLABEL=**__label__ and **PARTUUID=**__uuid__."
12468msgstr ""
12469
12470#. type: Labeled list
2bee5365 12471#: ../misc-utils/findmnt.8.adoc:139
36e96905
MB
12472#, no-wrap
12473msgid "*-s*, *--fstab*"
12474msgstr ""
12475
12476#. type: Plain text
2bee5365 12477#: ../misc-utils/findmnt.8.adoc:141
36e96905
MB
12478msgid "Search in _/etc/fstab_. The output is in the list format (see *--list*)."
12479msgstr ""
12480
12481#. type: Labeled list
2bee5365 12482#: ../misc-utils/findmnt.8.adoc:142
36e96905
MB
12483#, no-wrap
12484msgid "*-T*, *--target* _path_"
12485msgstr ""
12486
12487#. type: Plain text
2bee5365 12488#: ../misc-utils/findmnt.8.adoc:144
36e96905
MB
12489msgid ""
12490"Define the mount target. If _path_ is not a mountpoint file or directory, "
12491"then *findmnt* checks the _path_ elements in reverse order to get the "
12492"mountpoint (this feature is supported only when searching in kernel files "
12493"and unsupported for *--fstab*). It's recommended to use the option "
12494"*--mountpoint* when checks of _path_ elements are unwanted and _path_ is a "
12495"strictly specified mountpoint."
12496msgstr ""
12497
12498#. type: Labeled list
2bee5365 12499#: ../misc-utils/findmnt.8.adoc:145 ../misc-utils/wipefs.8.adoc:78
36e96905
MB
12500#, no-wrap
12501msgid "*-t*, *--types* _list_"
12502msgstr ""
12503
12504#. type: Plain text
2bee5365 12505#: ../misc-utils/findmnt.8.adoc:147
36e96905
MB
12506msgid ""
12507"Limit the set of printed filesystems. More than one type may be specified in "
12508"a comma-separated list. The list of filesystem types can be prefixed with "
12509"*no* to specify the filesystem types on which no action should be taken. For "
12510"more details see *mount*(8)."
12511msgstr ""
12512
12513#. type: Labeled list
2bee5365 12514#: ../misc-utils/findmnt.8.adoc:148
36e96905
MB
12515#, no-wrap
12516msgid "*--tree*"
12517msgstr ""
12518
12519#. type: Plain text
2bee5365 12520#: ../misc-utils/findmnt.8.adoc:150
36e96905
MB
12521msgid ""
12522"Enable tree-like output if possible. The options is silently ignored for "
12523"tables where is missing child-parent relation (e.g., fstab)."
12524msgstr ""
12525
12526#. type: Labeled list
2bee5365 12527#: ../misc-utils/findmnt.8.adoc:151
36e96905
MB
12528#, no-wrap
12529msgid "*-U*, *--uniq*"
12530msgstr ""
12531
12532#. type: Plain text
2bee5365 12533#: ../misc-utils/findmnt.8.adoc:153
36e96905
MB
12534msgid ""
12535"Ignore filesystems with duplicate mount targets, thus effectively skipping "
12536"over-mounted mount points."
12537msgstr ""
12538
12539#. type: Labeled list
2bee5365 12540#: ../misc-utils/findmnt.8.adoc:154 ../misc-utils/lslocks.8.adoc:63
36e96905
MB
12541#: ../sys-utils/lsns.8.adoc:60
12542#, no-wrap
12543msgid "*-u*, *--notruncate*"
12544msgstr ""
12545
12546#. type: Plain text
2bee5365 12547#: ../misc-utils/findmnt.8.adoc:156
36e96905
MB
12548msgid ""
12549"Do not truncate text in columns. The default is to not truncate the "
12550"*TARGET*, *SOURCE*, *UUID*, *LABEL*, *PARTUUID*, *PARTLABEL* columns. This "
12551"option disables text truncation also in all other columns."
12552msgstr ""
12553
12554#. type: Labeled list
2bee5365 12555#: ../misc-utils/findmnt.8.adoc:157
36e96905
MB
12556#, no-wrap
12557msgid "*-v*, *--nofsroot*"
12558msgstr ""
12559
12560#. type: Plain text
2bee5365 12561#: ../misc-utils/findmnt.8.adoc:159
36e96905
MB
12562msgid ""
12563"Do not print a [/dir] in the SOURCE column for bind mounts or btrfs "
12564"subvolumes."
12565msgstr ""
12566
12567#. type: Labeled list
2bee5365 12568#: ../misc-utils/findmnt.8.adoc:160
36e96905
MB
12569#, no-wrap
12570msgid "*-w*, *--timeout* _milliseconds_"
12571msgstr ""
12572
12573#. type: Plain text
2bee5365 12574#: ../misc-utils/findmnt.8.adoc:162
36e96905
MB
12575msgid ""
12576"Specify an upper limit on the time for which *--poll* will block, in "
12577"milliseconds."
12578msgstr ""
12579
12580#. type: Labeled list
2bee5365 12581#: ../misc-utils/findmnt.8.adoc:163
36e96905
MB
12582#, no-wrap
12583msgid "*-x*, *--verify*"
12584msgstr ""
12585
12586#. type: Plain text
2bee5365 12587#: ../misc-utils/findmnt.8.adoc:165
36e96905
MB
12588msgid ""
12589"Check mount table content. The default is to verify _/etc/fstab_ parsability "
12590"and usability. It's possible to use this option also with *--tab-file*. It's "
12591"possible to specify source (device) or target (mountpoint) to filter mount "
12592"table. The option *--verbose* forces findmnt to print more details."
12593msgstr ""
12594
12595#. type: Plain text
2bee5365 12596#: ../misc-utils/findmnt.8.adoc:168
36e96905
MB
12597msgid "Force findmnt to print more information (*--verify* only for now)."
12598msgstr ""
12599
12600#. type: Labeled list
2bee5365 12601#: ../misc-utils/findmnt.8.adoc:169
36e96905
MB
12602#, no-wrap
12603msgid "*--vfs-all*"
12604msgstr ""
12605
12606#. type: Plain text
2bee5365 12607#: ../misc-utils/findmnt.8.adoc:171
36e96905
MB
12608msgid ""
12609"When used with *VFS-OPTIONS* column, print all VFS (fs-independent) "
12610"flags. This option is designed for auditing purposes to list also default "
12611"VFS kernel mount options which are normally not listed."
12612msgstr ""
12613
12614#. type: Labeled list
2bee5365 12615#: ../misc-utils/findmnt.8.adoc:174 ../sys-utils/mount.8.adoc:1397
36e96905
MB
12616#: ../sys-utils/umount.8.adoc:156
12617#, no-wrap
12618msgid "LIBMOUNT_FSTAB=<path>"
12619msgstr ""
12620
12621#. type: Plain text
2bee5365 12622#: ../misc-utils/findmnt.8.adoc:176
36e96905
MB
12623msgid "overrides the default location of the fstab file"
12624msgstr ""
12625
12626#. type: Labeled list
2bee5365 12627#: ../misc-utils/findmnt.8.adoc:177 ../sys-utils/mount.8.adoc:1400
36e96905
MB
12628#: ../sys-utils/umount.8.adoc:159
12629#, no-wrap
12630msgid "LIBMOUNT_MTAB=<path>"
12631msgstr ""
12632
12633#. type: Plain text
2bee5365 12634#: ../misc-utils/findmnt.8.adoc:179
36e96905
MB
12635msgid "overrides the default location of the mtab file"
12636msgstr ""
12637
12638#. type: Labeled list
2bee5365 12639#: ../misc-utils/findmnt.8.adoc:180 ../misc-utils/lsblk.8.adoc:146
36e96905
MB
12640#: ../sys-utils/mount.8.adoc:1403 ../sys-utils/mountpoint.1.adoc:58
12641#: ../sys-utils/swapon.8.adoc:126 ../sys-utils/umount.8.adoc:162
12642#, no-wrap
12643msgid "LIBMOUNT_DEBUG=all"
12644msgstr ""
12645
12646#. type: Plain text
2bee5365 12647#: ../misc-utils/findmnt.8.adoc:182 ../sys-utils/mount.8.adoc:1405
36e96905
MB
12648msgid "enables libmount debug output"
12649msgstr ""
12650
12651#. type: Plain text
2bee5365 12652#: ../misc-utils/findmnt.8.adoc:185
36e96905
MB
12653msgid "enables libsmartcols debug output"
12654msgstr ""
12655
12656#. type: Labeled list
2bee5365 12657#: ../misc-utils/findmnt.8.adoc:186 ../misc-utils/lsblk.8.adoc:152
36e96905
MB
12658#, no-wrap
12659msgid "LIBSMARTCOLS_DEBUG_PADDING=on"
12660msgstr ""
12661
12662#. type: Plain text
2bee5365 12663#: ../misc-utils/findmnt.8.adoc:188 ../misc-utils/lsblk.8.adoc:154
36e96905
MB
12664msgid "use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG."
12665msgstr ""
12666
12667#. type: Title ==
2bee5365 12668#: ../misc-utils/findmnt.8.adoc:189 ../misc-utils/getopt.1.adoc:130
36e96905
MB
12669#: ../misc-utils/logger.1.adoc:234 ../misc-utils/look.1.adoc:98
12670#: ../misc-utils/rename.1.adoc:75 ../misc-utils/uuidgen.1.adoc:62
12671#: ../misc-utils/whereis.1.adoc:115 ../misc-utils/wipefs.8.adoc:92
b81d5971 12672#: ../schedutils/ionice.1.adoc:76 ../sys-utils/flock.1.adoc:98
36e96905
MB
12673#: ../sys-utils/prlimit.1.adoc:118 ../sys-utils/renice.1.adoc:90
12674#: ../sys-utils/setpriv.1.adoc:104 ../sys-utils/unshare.1.adoc:141
5db1d29a 12675#: ../term-utils/scriptlive.1.adoc:54 ../term-utils/scriptreplay.1.adoc:71
36e96905
MB
12676#: ../text-utils/colcrt.1.adoc:87 ../text-utils/column.1.adoc:173
12677#: ../text-utils/hexdump.1.adoc:229
12678#, no-wrap
12679msgid "EXAMPLES"
12680msgstr ""
12681
12682#. type: Labeled list
2bee5365 12683#: ../misc-utils/findmnt.8.adoc:191
36e96905
MB
12684#, no-wrap
12685msgid "*findmnt --fstab -t nfs*"
12686msgstr ""
12687
12688#. type: Plain text
2bee5365 12689#: ../misc-utils/findmnt.8.adoc:193
36e96905
MB
12690msgid "Prints all NFS filesystems defined in _/etc/fstab_."
12691msgstr ""
12692
12693#. type: Labeled list
2bee5365 12694#: ../misc-utils/findmnt.8.adoc:194
36e96905
MB
12695#, no-wrap
12696msgid "*findmnt --fstab /mnt/foo*"
12697msgstr ""
12698
12699#. type: Plain text
2bee5365 12700#: ../misc-utils/findmnt.8.adoc:196
36e96905
MB
12701msgid ""
12702"Prints all _/etc/fstab_ filesystems where the mountpoint directory is "
12703"_/mnt/foo_. It also prints bind mounts where _/mnt/foo_ is a source."
12704msgstr ""
12705
12706#. type: Labeled list
2bee5365 12707#: ../misc-utils/findmnt.8.adoc:197
36e96905
MB
12708#, no-wrap
12709msgid "*findmnt --fstab --target /mnt/foo*"
12710msgstr ""
12711
12712#. type: Plain text
2bee5365 12713#: ../misc-utils/findmnt.8.adoc:199
36e96905
MB
12714msgid ""
12715"Prints all _/etc/fstab_ filesystems where the mountpoint directory is "
12716"_/mnt/foo_."
12717msgstr ""
12718
12719#. type: Labeled list
2bee5365 12720#: ../misc-utils/findmnt.8.adoc:200
36e96905
MB
12721#, no-wrap
12722msgid "*findmnt --fstab --evaluate*"
12723msgstr ""
12724
12725#. type: Plain text
2bee5365 12726#: ../misc-utils/findmnt.8.adoc:202
36e96905
MB
12727msgid ""
12728"Prints all _/etc/fstab_ filesystems and converts LABEL= and UUID= tags to "
12729"the real device names."
12730msgstr ""
12731
12732#. type: Labeled list
2bee5365 12733#: ../misc-utils/findmnt.8.adoc:203
36e96905
MB
12734#, no-wrap
12735msgid "*findmnt -n --raw --evaluate --output=target LABEL=/boot*"
12736msgstr ""
12737
12738#. type: Plain text
2bee5365 12739#: ../misc-utils/findmnt.8.adoc:205
36e96905
MB
12740msgid ""
12741"Prints only the mountpoint where the filesystem with label \"/boot\" is "
12742"mounted."
12743msgstr ""
12744
12745#. type: Labeled list
2bee5365 12746#: ../misc-utils/findmnt.8.adoc:206
36e96905
MB
12747#, no-wrap
12748msgid "*findmnt --poll --mountpoint /mnt/foo*"
12749msgstr ""
12750
12751#. type: Plain text
2bee5365 12752#: ../misc-utils/findmnt.8.adoc:208
36e96905
MB
12753msgid "Monitors mount, unmount, remount and move on _/mnt/foo_."
12754msgstr ""
12755
12756#. type: Labeled list
2bee5365 12757#: ../misc-utils/findmnt.8.adoc:209
36e96905
MB
12758#, no-wrap
12759msgid "*findmnt --poll=umount --first-only --mountpoint /mnt/foo*"
12760msgstr ""
12761
12762#. type: Plain text
2bee5365 12763#: ../misc-utils/findmnt.8.adoc:211
36e96905
MB
12764msgid "Waits for _/mnt/foo_ unmount."
12765msgstr ""
12766
12767#. type: Labeled list
2bee5365 12768#: ../misc-utils/findmnt.8.adoc:212
36e96905
MB
12769#, no-wrap
12770msgid "*findmnt --poll=remount -t ext3 -O ro*"
12771msgstr ""
12772
12773#. type: Plain text
2bee5365 12774#: ../misc-utils/findmnt.8.adoc:214
36e96905
MB
12775msgid "Monitors remounts to read-only mode on all ext3 filesystems."
12776msgstr ""
12777
36e96905 12778#. type: Plain text
2bee5365 12779#: ../misc-utils/findmnt.8.adoc:223
36e96905
MB
12780#, no-wrap
12781msgid ""
12782"*fstab*(5),\n"
12783"*mount*(8)\n"
12784msgstr ""
12785
12786#. type: Title =
12787#: ../misc-utils/getopt.1.adoc:2
12788#, no-wrap
12789msgid "getopt(1)"
12790msgstr ""
12791
12792#. type: Plain text
12793#: ../misc-utils/getopt.1.adoc:13
12794msgid "getopt - parse command options (enhanced)"
12795msgstr ""
12796
12797#. type: Plain text
12798#: ../misc-utils/getopt.1.adoc:19
12799#, no-wrap
12800msgid ""
12801"*getopt* _optstring_ _parameters_\n"
12802"*getopt* [options] [*--*] _optstring_ _parameters_\n"
12803"*getopt* [options] *-o*|*--options* _optstring_ [options] [*--*] "
12804"_parameters_\n"
12805msgstr ""
12806
12807#. type: Plain text
12808#: ../misc-utils/getopt.1.adoc:23
12809#, no-wrap
12810msgid ""
12811"*getopt* is used to break up (_parse_) options in command lines for easy "
12812"parsing by shell procedures, and to check for valid options. It uses the GNU "
12813"*getopt*(3) routines to do this.\n"
12814msgstr ""
12815
12816#. type: Plain text
12817#: ../misc-utils/getopt.1.adoc:25
12818msgid ""
12819"The parameters *getopt* is called with can be divided into two parts: "
12820"options which modify the way *getopt* will do the parsing (the _options_ and "
12821"the _optstring_ in the *SYNOPSIS*), and the parameters which are to be "
12822"parsed (_parameters_ in the *SYNOPSIS*). The second part will start at the "
12823"first non-option parameter that is not an option argument, or after the "
12824"first occurrence of '*--*'. If no '*-o*' or '*--options*' option is found in "
12825"the first part, the first parameter of the second part is used as the short "
12826"options string."
12827msgstr ""
12828
12829#. type: Plain text
12830#: ../misc-utils/getopt.1.adoc:27
12831msgid ""
12832"If the environment variable *GETOPT_COMPATIBLE* is set, or if the first "
12833"_parameter_ is not an option (does not start with a '*-*', the first format "
12834"in the *SYNOPSIS*), *getopt* will generate output that is compatible with "
12835"that of other versions of *getopt*(1). It will still do parameter shuffling "
12836"and recognize optional arguments (see section *COMPATIBILITY* for more "
12837"information)."
12838msgstr ""
12839
12840#. type: Plain text
12841#: ../misc-utils/getopt.1.adoc:29
12842msgid ""
12843"Traditional implementations of *getopt*(1) are unable to cope with "
12844"whitespace and other (shell-specific) special characters in arguments and "
12845"non-option parameters. To solve this problem, this implementation can "
12846"generate quoted output which must once again be interpreted by the shell "
12847"(usually by using the *eval* command). This has the effect of preserving "
12848"those characters, but you must call *getopt* in a way that is no longer "
12849"compatible with other versions (the second or third format in the "
12850"*SYNOPSIS*). To determine whether this enhanced version of *getopt*(1) is "
12851"installed, a special test option (*-T*) can be used."
12852msgstr ""
12853
12854#. type: Labeled list
12855#: ../misc-utils/getopt.1.adoc:32 ../misc-utils/look.1.adoc:59
12856#, no-wrap
12857msgid "*-a*, *--alternative*"
12858msgstr ""
12859
12860#. type: Plain text
12861#: ../misc-utils/getopt.1.adoc:34
12862msgid "Allow long options to start with a single '*-*'."
12863msgstr ""
12864
12865#. type: Plain text
12866#: ../misc-utils/getopt.1.adoc:37
12867msgid "Display help text and exit. No other output is generated."
12868msgstr ""
12869
12870#. type: Labeled list
12871#: ../misc-utils/getopt.1.adoc:38
12872#, no-wrap
12873msgid "*-l*, *--longoptions* _longopts_"
12874msgstr ""
12875
12876#. type: Plain text
12877#: ../misc-utils/getopt.1.adoc:40
12878msgid ""
12879"The long (multi-character) options to be recognized. More than one option "
12880"name may be specified at once, by separating the names with commas. This "
12881"option may be given more than once, the _longopts_ are cumulative. Each long "
12882"option name in _longopts_ may be followed by one colon to indicate it has a "
12883"required argument, and by two colons to indicate it has an optional "
12884"argument."
12885msgstr ""
12886
12887#. type: Labeled list
12888#: ../misc-utils/getopt.1.adoc:41
12889#, no-wrap
12890msgid "*-n*, *--name* _progname_"
12891msgstr ""
12892
12893#. type: Plain text
12894#: ../misc-utils/getopt.1.adoc:43
12895msgid ""
12896"The name that will be used by the *getopt*(3) routines when it reports "
12897"errors. Note that errors of *getopt*(1) are still reported as coming from "
12898"getopt."
12899msgstr ""
12900
12901#. type: Labeled list
12902#: ../misc-utils/getopt.1.adoc:44
12903#, no-wrap
12904msgid "*-o*, *--options* _shortopts_"
12905msgstr ""
12906
12907#. TRANSLATORS: Keep {plus} untranslated.
12908#. type: Plain text
12909#: ../misc-utils/getopt.1.adoc:47
12910msgid ""
12911"The short (one-character) options to be recognized. If this option is not "
12912"found, the first parameter of *getopt* that does not start with a '*-*' (and "
12913"is not an option argument) is used as the short options string. Each short "
12914"option character in _shortopts_ may be followed by one colon to indicate it "
12915"has a required argument, and by two colons to indicate it has an optional "
12916"argument. The first character of shortopts may be '*{plus}*' or '*-*' to "
12917"influence the way options are parsed and output is generated (see section "
12918"*SCANNING MODES* for details)."
12919msgstr ""
12920
12921#. type: Plain text
12922#: ../misc-utils/getopt.1.adoc:50
12923msgid "Disable error reporting by *getopt*(3)."
12924msgstr ""
12925
12926#. type: Labeled list
12927#: ../misc-utils/getopt.1.adoc:51
12928#, no-wrap
12929msgid "*-Q*, *--quiet-output*"
12930msgstr ""
12931
12932#. type: Plain text
12933#: ../misc-utils/getopt.1.adoc:53
12934msgid ""
12935"Do not generate normal output. Errors are still reported by *getopt*(3), "
12936"unless you also use *-q*."
12937msgstr ""
12938
12939#. type: Plain text
12940#: ../misc-utils/getopt.1.adoc:56
12941msgid ""
12942"Set quoting conventions to those of _shell_. If the *-s* option is not "
12943"given, the BASH conventions are used. Valid arguments are currently '*sh*' "
12944"'*bash*', '*csh*', and '*tcsh*'."
12945msgstr ""
12946
12947#. type: Labeled list
12948#: ../misc-utils/getopt.1.adoc:57
12949#, no-wrap
12950msgid "*-T*, *--test*"
12951msgstr ""
12952
12953#. type: Plain text
12954#: ../misc-utils/getopt.1.adoc:59
12955msgid ""
12956"Test if your *getopt*(1) is this enhanced version or an old version. This "
12957"generates no output, and sets the error status to 4. Other implementations "
12958"of *getopt*(1), and this version if the environment variable "
12959"*GETOPT_COMPATIBLE* is set, will return '*--*' and error status 0."
12960msgstr ""
12961
12962#. type: Labeled list
12963#: ../misc-utils/getopt.1.adoc:60
12964#, no-wrap
12965msgid "*-u*, *--unquoted*"
12966msgstr ""
12967
12968#. type: Plain text
12969#: ../misc-utils/getopt.1.adoc:62
12970msgid ""
12971"Do not quote the output. Note that whitespace and special (shell-dependent) "
12972"characters can cause havoc in this mode (like they do with other *getopt*(1) "
12973"implementations)."
12974msgstr ""
12975
12976#. type: Plain text
12977#: ../misc-utils/getopt.1.adoc:65
12978msgid "Display version information and exit. No other output is generated."
12979msgstr ""
12980
12981#. type: Title ==
12982#: ../misc-utils/getopt.1.adoc:66
12983#, no-wrap
12984msgid "PARSING"
12985msgstr ""
12986
12987#. type: Plain text
12988#: ../misc-utils/getopt.1.adoc:69
12989msgid ""
12990"This section specifies the format of the second part of the parameters of "
12991"*getopt* (the _parameters_ in the *SYNOPSIS*). The next section (*OUTPUT*) "
12992"describes the output that is generated. These parameters were typically the "
12993"parameters a shell function was called with. Care must be taken that each "
12994"parameter the shell function was called with corresponds to exactly one "
12995"parameter in the parameter list of *getopt* (see the *EXAMPLES*). All "
12996"parsing is done by the GNU *getopt*(3) routines."
12997msgstr ""
12998
12999#. type: Plain text
13000#: ../misc-utils/getopt.1.adoc:71
13001msgid ""
13002"The parameters are parsed from left to right. Each parameter is classified "
13003"as a short option, a long option, an argument to an option, or a non-option "
13004"parameter."
13005msgstr ""
13006
13007#. type: Plain text
13008#: ../misc-utils/getopt.1.adoc:73
13009msgid ""
13010"A simple short option is a '*-*' followed by a short option character. If "
13011"the option has a required argument, it may be written directly after the "
13012"option character or as the next parameter (i.e., separated by whitespace on "
13013"the command line). If the option has an optional argument, it must be "
13014"written directly after the option character if present."
13015msgstr ""
13016
13017#. type: Plain text
13018#: ../misc-utils/getopt.1.adoc:75
13019msgid ""
13020"It is possible to specify several short options after one '*-*', as long as "
13021"all (except possibly the last) do not have required or optional arguments."
13022msgstr ""
13023
13024#. type: Plain text
13025#: ../misc-utils/getopt.1.adoc:77
13026msgid ""
13027"A long option normally begins with '*--*' followed by the long option "
13028"name. If the option has a required argument, it may be written directly "
13029"after the long option name, separated by '*=*', or as the next argument "
13030"(i.e., separated by whitespace on the command line). If the option has an "
13031"optional argument, it must be written directly after the long option name, "
13032"separated by '*=*', if present (if you add the '*=*' but nothing behind it, "
13033"it is interpreted as if no argument was present; this is a slight bug, see "
13034"the *BUGS*). Long options may be abbreviated, as long as the abbreviation is "
13035"not ambiguous."
13036msgstr ""
13037
13038#. TRANSLATORS: Keep {plus} untranslated.
13039#. type: Plain text
13040#: ../misc-utils/getopt.1.adoc:80
13041msgid ""
13042"Each parameter not starting with a '*-*', and not a required argument of a "
13043"previous option, is a non-option parameter. Each parameter after a '*--*' "
13044"parameter is always interpreted as a non-option parameter. If the "
13045"environment variable *POSIXLY_CORRECT* is set, or if the short option string "
13046"started with a '*{plus}*', all remaining parameters are interpreted as "
13047"non-option parameters as soon as the first non-option parameter is found."
13048msgstr ""
13049
13050#. type: Title ==
13051#: ../misc-utils/getopt.1.adoc:81 ../misc-utils/lslocks.8.adoc:72
13052#: ../misc-utils/uuidparse.1.adoc:23
13053#, no-wrap
13054msgid "OUTPUT"
13055msgstr ""
13056
13057#. type: Plain text
13058#: ../misc-utils/getopt.1.adoc:84
13059msgid ""
13060"Output is generated for each element described in the previous "
13061"section. Output is done in the same order as the elements are specified in "
13062"the input, except for non-option parameters. Output can be done in "
13063"_compatible_ (_unquoted_) mode, or in such way that whitespace and other "
13064"special characters within arguments and non-option parameters are preserved "
13065"(see *QUOTING*). When the output is processed in the shell script, it will "
13066"seem to be composed of distinct elements that can be processed one by one "
13067"(by using the shift command in most shell languages). This is imperfect in "
13068"unquoted mode, as elements can be split at unexpected places if they contain "
13069"whitespace or special characters."
13070msgstr ""
13071
13072#. type: Plain text
13073#: ../misc-utils/getopt.1.adoc:86
13074msgid ""
13075"If there are problems parsing the parameters, for example because a required "
13076"argument is not found or an option is not recognized, an error will be "
13077"reported on stderr, there will be no output for the offending element, and a "
13078"non-zero error status is returned."
13079msgstr ""
13080
13081#. type: Plain text
13082#: ../misc-utils/getopt.1.adoc:88
13083msgid ""
13084"For a short option, a single '*-*' and the option character are generated as "
13085"one parameter. If the option has an argument, the next parameter will be the "
13086"argument. If the option takes an optional argument, but none was found, the "
13087"next parameter will be generated but be empty in quoting mode, but no second "
13088"parameter will be generated in unquoted (compatible) mode. Note that many "
13089"other *getopt*(1) implementations do not support optional arguments."
13090msgstr ""
13091
13092#. type: Plain text
13093#: ../misc-utils/getopt.1.adoc:90
13094msgid ""
13095"If several short options were specified after a single '*-*', each will be "
13096"present in the output as a separate parameter."
13097msgstr ""
13098
13099#. type: Plain text
13100#: ../misc-utils/getopt.1.adoc:92
13101msgid ""
13102"For a long option, '*--*' and the full option name are generated as one "
13103"parameter. This is done regardless whether the option was abbreviated or "
13104"specified with a single '*-*' in the input. Arguments are handled as with "
13105"short options."
13106msgstr ""
13107
13108#. TRANSLATORS: Keep {plus} untranslated.
13109#. type: Plain text
13110#: ../misc-utils/getopt.1.adoc:95
13111msgid ""
13112"Normally, no non-option parameters output is generated until all options and "
13113"their arguments have been generated. Then '*--*' is generated as a single "
13114"parameter, and after it the non-option parameters in the order they were "
13115"found, each as a separate parameter. Only if the first character of the "
13116"short options string was a '*-*', non-option parameter output is generated "
13117"at the place they are found in the input (this is not supported if the first "
13118"format of the *SYNOPSIS* is used; in that case all preceding occurrences of "
13119"'*-*' and '*{plus}*' are ignored)."
13120msgstr ""
13121
13122#. type: Title ==
13123#: ../misc-utils/getopt.1.adoc:96
13124#, no-wrap
13125msgid "QUOTING"
13126msgstr ""
13127
13128#. type: Plain text
13129#: ../misc-utils/getopt.1.adoc:99
13130msgid ""
13131"In compatibility mode, whitespace or 'special' characters in arguments or "
13132"non-option parameters are not handled correctly. As the output is fed to the "
13133"shell script, the script does not know how it is supposed to break the "
13134"output into separate parameters. To circumvent this problem, this "
13135"implementation offers quoting. The idea is that output is generated with "
13136"quotes around each parameter. When this output is once again fed to the "
13137"shell (usually by a shell *eval* command), it is split correctly into "
13138"separate parameters."
13139msgstr ""
13140
13141#. type: Plain text
13142#: ../misc-utils/getopt.1.adoc:101
13143msgid ""
13144"Quoting is not enabled if the environment variable *GETOPT_COMPATIBLE* is "
13145"set, if the first form of the *SYNOPSIS* is used, or if the option '*-u*' is "
13146"found."
13147msgstr ""
13148
13149#. type: Plain text
13150#: ../misc-utils/getopt.1.adoc:103
13151msgid ""
13152"Different shells use different quoting conventions. You can use the '*-s*' "
13153"option to select the shell you are using. The following shells are currently "
13154"supported: '*sh*', '*bash*', '*csh*' and '*tcsh*'. Actually, only two "
13155"'flavors' are distinguished: sh-like quoting conventions and csh-like "
13156"quoting conventions. Chances are that if you use another shell script "
13157"language, one of these flavors can still be used."
13158msgstr ""
13159
13160#. type: Title ==
13161#: ../misc-utils/getopt.1.adoc:104
13162#, no-wrap
13163msgid "SCANNING MODES"
13164msgstr ""
13165
13166#. TRANSLATORS: Keep {plus} untranslated.
13167#. type: Plain text
13168#: ../misc-utils/getopt.1.adoc:108
13169msgid ""
13170"The first character of the short options string may be a '*-*' or a "
13171"'*{plus}*' to indicate a special scanning mode. If the first calling form in "
13172"the *SYNOPSIS* is used they are ignored; the environment variable "
13173"*POSIXLY_CORRECT* is still examined, though."
13174msgstr ""
13175
13176#. TRANSLATORS: Keep {plus} untranslated.
13177#. type: Plain text
13178#: ../misc-utils/getopt.1.adoc:111
13179msgid ""
13180"If the first character is '*{plus}*', or if the environment variable "
13181"*POSIXLY_CORRECT* is set, parsing stops as soon as the first non-option "
13182"parameter (i.e., a parameter that does not start with a '*-*') is found that "
13183"is not an option argument. The remaining parameters are all interpreted as "
13184"non-option parameters."
13185msgstr ""
13186
13187#. type: Plain text
13188#: ../misc-utils/getopt.1.adoc:113
13189msgid ""
13190"If the first character is a '*-*', non-option parameters are outputted at "
13191"the place where they are found; in normal operation, they are all collected "
13192"at the end of output after a '*--*' parameter has been generated. Note that "
13193"this '*--*' parameter is still generated, but it will always be the last "
13194"parameter in this mode."
13195msgstr ""
13196
13197#. type: Plain text
13198#: ../misc-utils/getopt.1.adoc:117
13199msgid ""
13200"This version of *getopt*(1) is written to be as compatible as possible to "
13201"other versions. Usually you can just replace them with this version without "
13202"any modifications, and with some advantages."
13203msgstr ""
13204
13205#. TRANSLATORS: Keep {plus} untranslated.
13206#. type: Plain text
13207#: ../misc-utils/getopt.1.adoc:120
13208msgid ""
13209"If the first character of the first parameter of getopt is not a '*-*', "
13210"*getopt* goes into compatibility mode. It will interpret its first parameter "
13211"as the string of short options, and all other arguments will be parsed. It "
13212"will still do parameter shuffling (i.e., all non-option parameters are "
13213"output at the end), unless the environment variable *POSIXLY_CORRECT* is "
13214"set, in which case, *getopt* will prepend a '*{plus}*' before short options "
13215"automatically."
13216msgstr ""
13217
13218#. type: Plain text
13219#: ../misc-utils/getopt.1.adoc:122
13220msgid ""
13221"The environment variable *GETOPT_COMPATIBLE* forces *getopt* into "
13222"compatibility mode. Setting both this environment variable and "
13223"*POSIXLY_CORRECT* offers 100% compatibility for 'difficult' "
13224"programs. Usually, though, neither is needed."
13225msgstr ""
13226
13227#. TRANSLATORS: Keep {plus} untranslated.
13228#. type: Plain text
13229#: ../misc-utils/getopt.1.adoc:125
13230msgid ""
13231"In compatibility mode, leading '*-*' and '*{plus}*' characters in the short "
13232"options string are ignored."
13233msgstr ""
13234
13235#. type: Title ==
13236#: ../misc-utils/getopt.1.adoc:126
13237#, no-wrap
13238msgid "RETURN CODES"
13239msgstr ""
13240
13241#. type: Plain text
13242#: ../misc-utils/getopt.1.adoc:129
13243#, no-wrap
13244msgid ""
13245"*getopt* returns error code *0* for successful parsing, *1* if *getopt*(3) "
13246"returns errors, *2* if it does not understand its own parameters, *3* if an "
13247"internal error occurs like out-of-memory, and *4* if it is called with "
13248"*-T*.\n"
13249msgstr ""
13250
13251#. TRANSLATORS: Don't translate _{docdir}_.
13252#. type: Plain text
13253#: ../misc-utils/getopt.1.adoc:134
13254msgid ""
13255"Example scripts for (ba)sh and (t)csh are provided with the *getopt*(1) "
13256"distribution, and are installed in _{docdir}_ directory."
13257msgstr ""
13258
13259#. type: Labeled list
13260#: ../misc-utils/getopt.1.adoc:137
13261#, no-wrap
13262msgid "*POSIXLY_CORRECT*"
13263msgstr ""
13264
13265#. type: Plain text
13266#: ../misc-utils/getopt.1.adoc:139
13267msgid ""
13268"This environment variable is examined by the *getopt*(3) routines. If it is "
13269"set, parsing stops as soon as a parameter is found that is not an option or "
13270"an option argument. All remaining parameters are also interpreted as "
13271"non-option parameters, regardless whether they start with a '*-*'."
13272msgstr ""
13273
13274#. type: Labeled list
13275#: ../misc-utils/getopt.1.adoc:140
13276#, no-wrap
13277msgid "*GETOPT_COMPATIBLE*"
13278msgstr ""
13279
13280#. type: Plain text
13281#: ../misc-utils/getopt.1.adoc:142
13282msgid ""
13283"Forces *getopt* to use the first calling format as specified in the "
13284"*SYNOPSIS*."
13285msgstr ""
13286
13287#. type: Plain text
13288#: ../misc-utils/getopt.1.adoc:146
13289#, no-wrap
13290msgid ""
13291"*getopt*(3) can parse long options with optional arguments that are given an "
13292"empty optional argument (but cannot do this for short options). This "
13293"*getopt*(1) treats optional arguments that are empty as if they were not "
13294"present.\n"
13295msgstr ""
13296
13297#. type: Plain text
13298#: ../misc-utils/getopt.1.adoc:148
13299msgid ""
13300"The syntax if you do not want any short option variables at all is not very "
13301"intuitive (you have to set them explicitly to the empty string)."
13302msgstr ""
13303
13304#. type: Title ==
13305#: ../misc-utils/getopt.1.adoc:149 ../misc-utils/hardlink.1.adoc:84
13306#: ../misc-utils/uuidd.8.adoc:81
13307#, no-wrap
13308msgid "AUTHOR"
13309msgstr ""
13310
13311#. type: Plain text
13312#: ../misc-utils/getopt.1.adoc:152
13313msgid "mailto:frodo@frodo.looijaard.name[Frodo Looijaard]"
13314msgstr ""
13315
13316#. type: Plain text
13317#: ../misc-utils/getopt.1.adoc:158
13318#, no-wrap
13319msgid ""
13320"*bash*(1),\n"
13321"*tcsh*(1),\n"
13322"*getopt*(3)\n"
13323msgstr ""
13324
13325#. SPDX-License-Identifier: MIT
13326#
13327#. Copyright (C) 2008 - 2012 Julian Andres Klode. See hardlink.c for license.
13328#. Copyright (C) 2021 Karel Zak <kzak@redhat.com>
13329#. type: Title =
13330#: ../misc-utils/hardlink.1.adoc:8
13331#, no-wrap
13332msgid "hardlink(1)"
13333msgstr ""
13334
13335#. type: Plain text
13336#: ../misc-utils/hardlink.1.adoc:18
13337msgid "hardlink - link multiple copies of a file"
13338msgstr ""
13339
13340#. type: Plain text
13341#: ../misc-utils/hardlink.1.adoc:22
13342#, no-wrap
13343msgid "*hardlink* [options] [_directory_|_file_]...\n"
13344msgstr ""
13345
13346#. type: Plain text
13347#: ../misc-utils/hardlink.1.adoc:26
13348#, no-wrap
13349msgid ""
13350"*hardlink* is a tool which replaces copies of a file with hardlinks, "
13351"therefore saving space.\n"
13352msgstr ""
13353
13354#. type: Plain text
13355#: ../misc-utils/hardlink.1.adoc:31
13356msgid "print quick usage details to the screen."
13357msgstr ""
13358
13359#. type: Plain text
13360#: ../misc-utils/hardlink.1.adoc:34
13361msgid ""
13362"More verbose output. If specified once, every hardlinked file is displayed, "
13363"if specified twice, it also shows every comparison."
13364msgstr ""
13365
13366#. type: Plain text
13367#: ../misc-utils/hardlink.1.adoc:37
13368msgid "Quiet mode, don't print anything."
13369msgstr ""
13370
13371#. type: Labeled list
13372#: ../misc-utils/hardlink.1.adoc:38 ../sys-utils/rtcwake.8.adoc:93
13373#, no-wrap
13374msgid "*-n*, *--dry-run*"
13375msgstr ""
13376
13377#. type: Plain text
13378#: ../misc-utils/hardlink.1.adoc:40
13379msgid "Do not act, just print what would happen."
13380msgstr ""
13381
13382#. type: Labeled list
13383#: ../misc-utils/hardlink.1.adoc:41
13384#, no-wrap
13385msgid "*-f*, *--respect-name*"
13386msgstr ""
13387
13388#. type: Plain text
13389#: ../misc-utils/hardlink.1.adoc:43
13390msgid ""
13391"Only try to link files with the same (basename). It's strongly recommended "
13392"to use long options rather than *-f* which is interpreted in a different way "
13393"by others *hardlink* implementations."
13394msgstr ""
13395
13396#. type: Labeled list
13397#: ../misc-utils/hardlink.1.adoc:44
13398#, no-wrap
13399msgid "*-p*, *--ignore-mode*"
13400msgstr ""
13401
13402#. type: Plain text
13403#: ../misc-utils/hardlink.1.adoc:46
13404msgid ""
13405"Link/compare files even if their mode is different. This may be a bit "
13406"unpredictable."
13407msgstr ""
13408
13409#. type: Labeled list
13410#: ../misc-utils/hardlink.1.adoc:47
13411#, no-wrap
13412msgid "*-o*, *--ignore-owner*"
13413msgstr ""
13414
13415#. type: Plain text
13416#: ../misc-utils/hardlink.1.adoc:49
13417msgid ""
13418"Link/compare files even if their owner (user and group) is different. It is "
13419"not predictable."
13420msgstr ""
13421
13422#. type: Labeled list
13423#: ../misc-utils/hardlink.1.adoc:50
13424#, no-wrap
13425msgid "*-t*, *--ignore-time*"
13426msgstr ""
13427
13428#. type: Plain text
13429#: ../misc-utils/hardlink.1.adoc:52
13430msgid ""
13431"Link/compare files even if their time of modification is different. You "
13432"almost always want this."
13433msgstr ""
13434
13435#. type: Labeled list
13436#: ../misc-utils/hardlink.1.adoc:53
13437#, no-wrap
13438msgid "*-X*, *--respect-xattrs*"
13439msgstr ""
13440
13441#. type: Plain text
13442#: ../misc-utils/hardlink.1.adoc:55
13443msgid "Only try to link files with the same extended attributes."
13444msgstr ""
13445
13446#. type: Labeled list
13447#: ../misc-utils/hardlink.1.adoc:56
13448#, no-wrap
13449msgid "*-m*, *--maximize*"
13450msgstr ""
13451
13452#. type: Plain text
13453#: ../misc-utils/hardlink.1.adoc:58
13454msgid "Among equal files, keep the file with the highest link count."
13455msgstr ""
13456
13457#. type: Labeled list
13458#: ../misc-utils/hardlink.1.adoc:59
13459#, no-wrap
13460msgid "*-M*, *--minimize*"
13461msgstr ""
13462
13463#. type: Plain text
13464#: ../misc-utils/hardlink.1.adoc:61
13465msgid "Among equal files, keep the file with the lowest link count."
13466msgstr ""
13467
13468#. type: Labeled list
13469#: ../misc-utils/hardlink.1.adoc:62
13470#, no-wrap
13471msgid "*-O*, *--keep-oldest*"
13472msgstr ""
13473
13474#. type: Plain text
13475#: ../misc-utils/hardlink.1.adoc:64
13476msgid ""
13477"Among equal files, keep the oldest file (least recent modification time). By "
13478"default, the newest file is kept. If *--maximize* or *--minimize* is "
13479"specified, the link count has a higher precedence than the time of "
13480"modification."
13481msgstr ""
13482
13483#. type: Labeled list
13484#: ../misc-utils/hardlink.1.adoc:65
13485#, no-wrap
13486msgid "*-x*, *--exclude* _regex_"
13487msgstr ""
13488
13489#. type: Plain text
13490#: ../misc-utils/hardlink.1.adoc:67
13491msgid "A regular expression which excludes files from being compared and linked."
13492msgstr ""
13493
13494#. type: Labeled list
13495#: ../misc-utils/hardlink.1.adoc:68
13496#, no-wrap
13497msgid "*-i*, *--include* _regex_"
13498msgstr ""
13499
13500#. type: Plain text
13501#: ../misc-utils/hardlink.1.adoc:70
13502msgid ""
13503"A regular expression to include files. If the option *--exclude* has been "
13504"given, this option re-includes files which would otherwise be excluded. If "
13505"the option is used without *--exclude*, only files matched by the pattern "
13506"are included."
13507msgstr ""
13508
13509#. type: Labeled list
13510#: ../misc-utils/hardlink.1.adoc:71
13511#, no-wrap
13512msgid "*-s*, *--minimum-size* _size_"
13513msgstr ""
13514
13515#. type: Plain text
13516#: ../misc-utils/hardlink.1.adoc:73
13517msgid ""
13518"The minimum size to consider. By default this is 1, so empty files will not "
13519"be linked. The _size_ argument may be followed by the multiplicative "
13520"suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
13521"ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
13522"\"KiB\")."
13523msgstr ""
13524
13525#. type: Plain text
13526#: ../misc-utils/hardlink.1.adoc:77
13527#, no-wrap
13528msgid ""
13529"*hardlink* takes one or more directories which will be searched for files to "
13530"be linked.\n"
13531msgstr ""
13532
13533#. type: Plain text
13534#: ../misc-utils/hardlink.1.adoc:81
13535msgid ""
13536"The original *hardlink* implementation uses the option *-f* to force "
13537"hardlinks creation between filesystem. This very rarely usable feature is no "
13538"more supported by the current hardlink."
13539msgstr ""
13540
13541#. type: Plain text
13542#: ../misc-utils/hardlink.1.adoc:83
13543#, no-wrap
13544msgid ""
13545"*hardlink* assumes that the trees it operates on do not change during "
13546"operation. If a tree does change, the result is undefined and potentially "
13547"dangerous. For example, if a regular file is replaced by a device, hardlink "
13548"may start reading from the device. If a component of a path is replaced by a "
13549"symbolic link or file permissions change, security may be compromised. Do "
13550"not run hardlink on a changing tree or on a tree controlled by another "
13551"user.\n"
13552msgstr ""
13553
13554#. type: Plain text
13555#: ../misc-utils/hardlink.1.adoc:87
13556msgid ""
13557"There are multiple *hardlink* implementations. The very first implementation "
13558"is from Jakub Jelinek for Fedora distribution, this implementation has been "
13559"used in util-linux between versions v2.34 to v2.36. The current "
13560"implementations is based on Debian version from Julian Andres Klode."
13561msgstr ""
13562
13563#. Copyright 1994 Salvatore Valente (svalente@mit.edu)
13564#. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
13565#. May be distributed under the GNU General Public License
13566#. type: Title =
13567#: ../misc-utils/kill.1.adoc:7
13568#, no-wrap
13569msgid "kill(1)"
13570msgstr ""
13571
13572#. type: Plain text
13573#: ../misc-utils/kill.1.adoc:17
13574msgid "kill - terminate a process"
13575msgstr ""
13576
13577#. type: Plain text
13578#: ../misc-utils/kill.1.adoc:21
13579#, no-wrap
13580msgid ""
13581"*kill* [-signal|*-s* _signal_|*-p*] [*-q* _value_] [*-a*] [*--timeout* "
13582"_milliseconds_ _signal_] [*--*] _pid_|_name_...\n"
13583msgstr ""
13584
13585#. type: Plain text
13586#: ../misc-utils/kill.1.adoc:23
13587#, no-wrap
13588msgid "*kill* *-l* [_number_] | *-L*\n"
13589msgstr ""
13590
13591#. type: Plain text
13592#: ../misc-utils/kill.1.adoc:28
13593msgid ""
13594"The command *kill* sends the specified _signal_ to the specified processes "
13595"or process groups."
13596msgstr ""
13597
13598#. type: Plain text
13599#: ../misc-utils/kill.1.adoc:30
13600msgid ""
13601"If no signal is specified, the TERM signal is sent. The default action for "
13602"this signal is to terminate the process. This signal should be used in "
13603"preference to the KILL signal (number 9), since a process may install a "
13604"handler for the TERM signal in order to perform clean-up steps before "
13605"terminating in an orderly fashion. If a process does not terminate after a "
13606"TERM signal has been sent, then the KILL signal may be used; be aware that "
13607"the latter signal cannot be caught, and so does not give the target process "
13608"the opportunity to perform any clean-up before terminating."
13609msgstr ""
13610
13611#. type: Plain text
13612#: ../misc-utils/kill.1.adoc:32
13613msgid ""
13614"Most modern shells have a builtin *kill* command, with a usage rather "
13615"similar to that of the command described here. The *--all*, *--pid*, and "
13616"*--queue* options, and the possibility to specify processes by command name, "
13617"are local extensions."
13618msgstr ""
13619
13620#. type: Plain text
13621#: ../misc-utils/kill.1.adoc:34
13622msgid ""
13623"If _signal_ is 0, then no actual signal is sent, but error checking is still "
13624"performed."
13625msgstr ""
13626
13627#. type: Plain text
13628#: ../misc-utils/kill.1.adoc:38
13629msgid "The list of processes to be signaled can be a mixture of names and PIDs."
13630msgstr ""
13631
13632#. type: Labeled list
13633#: ../misc-utils/kill.1.adoc:39
13634#, no-wrap
13635msgid "_pid_"
13636msgstr ""
13637
13638#. type: Plain text
13639#: ../misc-utils/kill.1.adoc:41
13640msgid "Each _pid_ can be expressed in one of the following ways:"
13641msgstr ""
13642
13643#. type: Labeled list
13644#: ../misc-utils/kill.1.adoc:41
13645#, no-wrap
13646msgid "_n_"
13647msgstr ""
13648
13649#. type: Plain text
13650#: ../misc-utils/kill.1.adoc:43
13651msgid "where _n_ is larger than 0. The process with PID _n_ is signaled."
13652msgstr ""
13653
13654#. type: Plain text
13655#: ../misc-utils/kill.1.adoc:45
13656msgid "All processes in the current process group are signaled."
13657msgstr ""
13658
13659#. type: Plain text
13660#: ../misc-utils/kill.1.adoc:47
13661msgid "All processes with a PID larger than 1 are signaled."
13662msgstr ""
13663
13664#. type: Labeled list
13665#: ../misc-utils/kill.1.adoc:47
13666#, no-wrap
13667msgid "**-**__n__"
13668msgstr ""
13669
13670#. type: Plain text
13671#: ../misc-utils/kill.1.adoc:49
13672msgid ""
13673"where _n_ is larger than 1. All processes in process group _n_ are "
13674"signaled. When an argument of the form '-n' is given, and it is meant to "
13675"denote a process group, either a signal must be specified first, or the "
13676"argument must be preceded by a '--' option, otherwise it will be taken as "
13677"the signal to send."
13678msgstr ""
13679
13680#. type: Labeled list
13681#: ../misc-utils/kill.1.adoc:50
13682#, no-wrap
13683msgid "_name_"
13684msgstr ""
13685
13686#. type: Plain text
13687#: ../misc-utils/kill.1.adoc:52
13688msgid "All processes invoked using this _name_ will be signaled."
13689msgstr ""
13690
13691#. type: Labeled list
13692#: ../misc-utils/kill.1.adoc:55
13693#, no-wrap
13694msgid "*-s*, *--signal* _signal_"
13695msgstr ""
13696
13697#. type: Plain text
13698#: ../misc-utils/kill.1.adoc:57
13699msgid "The signal to send. It may be given as a name or a number."
13700msgstr ""
13701
13702#. type: Labeled list
13703#: ../misc-utils/kill.1.adoc:57
13704#, no-wrap
13705msgid "*-l*, *--list* [_number_]"
13706msgstr ""
13707
13708#. type: Plain text
13709#: ../misc-utils/kill.1.adoc:59
13710msgid ""
13711"Print a list of signal names, or convert the given signal number to a "
13712"name. The signals can be found in _/usr/include/linux/signal.h_."
13713msgstr ""
13714
13715#. type: Labeled list
13716#: ../misc-utils/kill.1.adoc:59
13717#, no-wrap
13718msgid "*-L*, *--table*"
13719msgstr ""
13720
13721#. type: Plain text
13722#: ../misc-utils/kill.1.adoc:61
13723msgid ""
13724"Similar to *-l*, but it will print signal names and their corresponding "
13725"numbers."
13726msgstr ""
13727
13728#. type: Plain text
13729#: ../misc-utils/kill.1.adoc:63
13730msgid ""
13731"Do not restrict the command-name-to-PID conversion to processes with the "
13732"same UID as the present process."
13733msgstr ""
13734
13735#. type: Labeled list
13736#: ../misc-utils/kill.1.adoc:63 ../schedutils/chrt.1.adoc:98
13737#: ../schedutils/taskset.1.adoc:77 ../schedutils/uclampset.1.adoc:73
13738#: ../sys-utils/ipcs.1.adoc:60 ../sys-utils/renice.1.adoc:63
13739#, no-wrap
13740msgid "*-p*, *--pid*"
13741msgstr ""
13742
13743#. type: Plain text
13744#: ../misc-utils/kill.1.adoc:65
13745msgid ""
13746"Only print the process ID (PID) of the named processes, do not send any "
13747"signals."
13748msgstr ""
13749
13750#. type: Plain text
13751#: ../misc-utils/kill.1.adoc:67
13752msgid "Print PID(s) that will be signaled with *kill* along with the signal."
13753msgstr ""
13754
13755#. type: Labeled list
13756#: ../misc-utils/kill.1.adoc:67
13757#, no-wrap
13758msgid "*-q*, *--queue* _value_"
13759msgstr ""
13760
13761#. type: Plain text
13762#: ../misc-utils/kill.1.adoc:69
13763msgid ""
13764"Send the signal using *sigqueue*(3) rather than *kill*(2). The _value_ "
13765"argument is an integer that is sent along with the signal. If the receiving "
13766"process has installed a handler for this signal using the *SA_SIGINFO* flag "
13767"to *sigaction*(2), then it can obtain this data via the _si_sigval_ field of "
13768"the _siginfo_t_ structure."
13769msgstr ""
13770
13771#. type: Labeled list
13772#: ../misc-utils/kill.1.adoc:69
13773#, no-wrap
13774msgid "*--timeout* _milliseconds signal_"
13775msgstr ""
13776
13777#. type: Plain text
13778#: ../misc-utils/kill.1.adoc:71
13779msgid ""
13780"Send a signal defined in the usual way to a process, followed by an "
13781"additional signal after a specified delay. The *--timeout* option causes "
13782"*kill* to wait for a period defined in _milliseconds_ before sending a "
13783"follow-up _signal_ to the process. This feature is implemented using the "
13784"Linux kernel PID file descriptor feature in order to guarantee that the "
13785"follow-up signal is sent to the same process or not sent if the process no "
13786"longer exists."
13787msgstr ""
13788
13789#. type: Plain text
13790#: ../misc-utils/kill.1.adoc:73
13791msgid ""
13792"Note that the operating system may re-use PIDs and implementing an "
13793"equivalent feature in a shell using *kill* and *sleep* would be subject to "
13794"races whereby the follow-up signal might be sent to a different process that "
13795"used a recycled PID."
13796msgstr ""
13797
13798#. type: Plain text
13799#: ../misc-utils/kill.1.adoc:75
13800msgid ""
13801"The *--timeout* option can be specified multiple times: the signals are sent "
13802"sequentially with the specified timeouts. The *--timeout* option can be "
13803"combined with the *--queue* option."
13804msgstr ""
13805
13806#. type: Plain text
13807#: ../misc-utils/kill.1.adoc:77
13808msgid ""
13809"As an example, the following command sends the signals QUIT, TERM and KILL "
13810"in sequence and waits for 1000 milliseconds between sending the signals:"
13811msgstr ""
13812
13813#. type: delimited block .
13814#: ../misc-utils/kill.1.adoc:81
13815#, no-wrap
13816msgid ""
13817"kill --verbose --timeout 1000 TERM --timeout 1000 KILL \\\n"
13818" --signal QUIT 12345\n"
13819msgstr ""
13820
13821#. type: Plain text
13822#: ../misc-utils/kill.1.adoc:86
13823#, no-wrap
13824msgid "*kill* has the following exit status values:\n"
13825msgstr ""
13826
13827#. type: Plain text
13828#: ../misc-utils/kill.1.adoc:91 ../misc-utils/lsblk.8.adoc:131
13829#: ../sys-utils/chcpu.8.adoc:68 ../sys-utils/chmem.8.adoc:67
13830#: ../sys-utils/fstrim.8.adoc:74
13831msgid "failure"
13832msgstr ""
13833
13834#. type: Plain text
13835#: ../misc-utils/kill.1.adoc:93
13836msgid "partial success (when more than one process specified)"
13837msgstr ""
13838
13839#. type: Plain text
13840#: ../misc-utils/kill.1.adoc:97
13841msgid ""
13842"Although it is possible to specify the TID (thread ID, see *gettid*(2)) of "
13843"one of the threads in a multithreaded process as the argument of *kill*, the "
13844"signal is nevertheless directed to the process (i.e., the entire thread "
13845"group). In other words, it is not possible to send a signal to an explicitly "
13846"selected thread in a multithreaded process. The signal will be delivered to "
13847"an arbitrarily selected thread in the target process that is not blocking "
13848"the signal. For more details, see *signal*(7) and the description of "
13849"*CLONE_THREAD* in *clone*(2)."
13850msgstr ""
13851
13852#. type: Plain text
13853#: ../misc-utils/kill.1.adoc:99
13854msgid ""
13855"Various shells provide a builtin *kill* command that is preferred in "
13856"relation to the *kill*(1) executable described by this manual. The easiest "
13857"way to ensure one is executing the command described in this page is to use "
13858"the full path when calling the command, for example: */bin/kill --version*"
13859msgstr ""
13860
13861#. type: Plain text
13862#: ../misc-utils/kill.1.adoc:104
13863msgid ""
13864"mailto:svalente@mit.edu[Salvatore Valente], mailto:kzak@redhat.com[Karel "
13865"Zak]"
13866msgstr ""
13867
13868#. type: Plain text
13869#: ../misc-utils/kill.1.adoc:106
13870msgid "The original version was taken from BSD 4.4."
13871msgstr ""
13872
13873#. type: Plain text
13874#: ../misc-utils/kill.1.adoc:115
13875#, no-wrap
13876msgid ""
13877"*bash*(1),\n"
13878"*tcsh*(1),\n"
13879"*sigaction*(2),\n"
13880"*kill*(2),\n"
13881"*sigqueue*(3),\n"
13882"*signal*(7)\n"
13883msgstr ""
13884
13885#. Copyright (c) 1983, 1990, 1993
13886#. The Regents of the University of California. All rights reserved.
13887#
13888#. Redistribution and use in source and binary forms, with or without
13889#. modification, are permitted provided that the following conditions
13890#. are met:
13891#. 1. Redistributions of source code must retain the above copyright
13892#. notice, this list of conditions and the following disclaimer.
13893#. 2. Redistributions in binary form must reproduce the above copyright
13894#. notice, this list of conditions and the following disclaimer in the
13895#. documentation and/or other materials provided with the distribution.
13896#. 3. All advertising materials mentioning features or use of this software
13897#. must display the following acknowledgement:
13898#. This product includes software developed by the University of
13899#. California, Berkeley and its contributors.
13900#. 4. Neither the name of the University nor the names of its contributors
13901#. may be used to endorse or promote products derived from this software
13902#. without specific prior written permission.
13903#
13904#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
13905#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
13906#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
13907#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
13908#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
13909#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
13910#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
13911#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
13912#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
13913#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
13914#. SUCH DAMAGE.
13915#
13916#. @(#)logger.1 8.1 (Berkeley) 6/6/93
13917#. type: Title =
13918#: ../misc-utils/logger.1.adoc:36
13919#, no-wrap
13920msgid "logger(1)"
13921msgstr ""
13922
13923#. type: Plain text
13924#: ../misc-utils/logger.1.adoc:46
13925msgid "logger - enter messages into the system log"
13926msgstr ""
13927
13928#. type: Plain text
13929#: ../misc-utils/logger.1.adoc:50
13930#, no-wrap
13931msgid "*logger* [options] _message_\n"
13932msgstr ""
13933
13934#. type: Plain text
13935#: ../misc-utils/logger.1.adoc:54
13936#, no-wrap
13937msgid "*logger* makes entries in the system log.\n"
13938msgstr ""
13939
13940#. type: Plain text
13941#: ../misc-utils/logger.1.adoc:56
13942msgid ""
13943"When the optional _message_ argument is present, it is written to the "
13944"log. If it is not present, and the *-f* option is not given either, then "
13945"standard input is logged."
13946msgstr ""
13947
13948#. type: Labeled list
13949#: ../misc-utils/logger.1.adoc:59
13950#, no-wrap
13951msgid "*-d*, *--udp*"
13952msgstr ""
13953
13954#. type: Plain text
13955#: ../misc-utils/logger.1.adoc:61
13956msgid ""
13957"Use datagrams (UDP) only. By default the connection is tried to the syslog "
13958"port defined in _/etc/services_, which is often 514."
13959msgstr ""
13960
13961#. type: Plain text
13962#: ../misc-utils/logger.1.adoc:63 ../misc-utils/logger.1.adoc:171
13963msgid "See also *--server* and *--socket* to specify where to connect."
13964msgstr ""
13965
13966#. type: Labeled list
13967#: ../misc-utils/logger.1.adoc:64
13968#, no-wrap
13969msgid "*-e*, *--skip-empty*"
13970msgstr ""
13971
13972#. type: Plain text
13973#: ../misc-utils/logger.1.adoc:66
13974msgid ""
13975"Ignore empty lines when processing files. An empty line is defined to be a "
13976"line without any characters. Thus a line consisting only of whitespace is "
13977"NOT considered empty. Note that when the *--prio-prefix* option is "
13978"specified, the priority is not part of the line. Thus an empty line in this "
13979"mode is a line that does not have any characters after the priority prefix "
13980"(e.g., *<13>*)."
13981msgstr ""
13982
13983#. type: Plain text
13984#: ../misc-utils/logger.1.adoc:69
13985msgid ""
13986"Log the contents of the specified _file_. This option cannot be combined "
13987"with a command-line message."
13988msgstr ""
13989
13990#. type: Labeled list
13991#: ../misc-utils/logger.1.adoc:70
13992#, no-wrap
13993msgid "*-i*"
13994msgstr ""
13995
13996#. type: Plain text
13997#: ../misc-utils/logger.1.adoc:72
13998msgid "Log the PID of the logger process with each line."
13999msgstr ""
14000
14001#. type: Labeled list
14002#: ../misc-utils/logger.1.adoc:73
14003#, no-wrap
14004msgid "*--id*[**=**__id__]"
14005msgstr ""
14006
14007#. type: Plain text
14008#: ../misc-utils/logger.1.adoc:75
14009msgid ""
14010"Log the PID of the logger process with each line. When the optional argument "
14011"_id_ is specified, then it is used instead of the logger command's PID. The "
14012"use of *--id=$$* (PPID) is recommended in scripts that send several "
14013"messages."
14014msgstr ""
14015
14016#. type: Plain text
14017#: ../misc-utils/logger.1.adoc:77
14018msgid ""
14019"Note that the system logging infrastructure (for example *systemd* when "
14020"listening on _/dev/log_) may follow local socket credentials to overwrite "
14021"the PID specified in the message. *logger*(1) is able to set those socket "
14022"credentials to the given _id_, but only if you have root permissions and a "
14023"process with the specified PID exists, otherwise the socket credentials are "
14024"not modified and the problem is silently ignored."
14025msgstr ""
14026
14027#. type: Labeled list
14028#: ../misc-utils/logger.1.adoc:78
14029#, no-wrap
14030msgid "*--journald*[**=**__file__]"
14031msgstr ""
14032
14033#. type: Plain text
14034#: ../misc-utils/logger.1.adoc:80
14035msgid ""
14036"Write a systemd journal entry. The entry is read from the given _file_, when "
14037"specified, otherwise from standard input. Each line must begin with a field "
14038"that is accepted by journald; see *systemd.journal-fields*(7) for "
14039"details. The use of a MESSAGE_ID field is generally a good idea, as it makes "
14040"finding entries easy. Examples:"
14041msgstr ""
14042
14043#. type: delimited block _
14044#: ../misc-utils/logger.1.adoc:88
14045#, no-wrap
14046msgid ""
14047" logger --journald <<end\n"
14048" MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309\n"
14049" MESSAGE=The dogs bark, but the caravan goes on.\n"
14050" DOGS=bark\n"
14051" CARAVAN=goes on\n"
14052" end\n"
14053msgstr ""
14054
14055#. type: delimited block _
14056#: ../misc-utils/logger.1.adoc:90
14057#, no-wrap
14058msgid " logger --journald=entry.txt\n"
14059msgstr ""
14060
14061#. type: Plain text
14062#: ../misc-utils/logger.1.adoc:92
14063msgid ""
14064"Notice that *--journald* will ignore values of other options, such as "
14065"priority. If priority is needed it must be within input, and use PRIORITY "
14066"field. The simple execution of *journalctl*(1) will display MESSAGE "
14067"field. Use *journalctl --output json-pretty* to see rest of the fields."
14068msgstr ""
14069
14070#. type: Plain text
14071#: ../misc-utils/logger.1.adoc:94
14072msgid ""
14073"To include newlines in MESSAGE, specify MESSAGE several times. This is "
14074"handled as a special case, other fields will be stored as an array in the "
14075"journal if they appear multiple times."
14076msgstr ""
14077
14078#. type: Labeled list
14079#: ../misc-utils/logger.1.adoc:95
14080#, no-wrap
14081msgid "*--msgid* _msgid_"
14082msgstr ""
14083
14084#. type: Plain text
14085#: ../misc-utils/logger.1.adoc:97
14086msgid ""
14087"Sets the link:https://tools.ietf.org/html/rfc5424[RFC 5424] MSGID "
14088"field. Note that the space character is not permitted inside of "
14089"_msgid_. This option is only used if *--rfc5424* is specified as well; "
14090"otherwise, it is silently ignored."
14091msgstr ""
14092
14093#. type: Labeled list
14094#: ../misc-utils/logger.1.adoc:98
14095#, no-wrap
14096msgid "*-n*, *--server* _server_"
14097msgstr ""
14098
14099#. type: Plain text
14100#: ../misc-utils/logger.1.adoc:100
14101msgid ""
14102"Write to the specified remote syslog _server_ instead of to the system log "
14103"socket. Unless *--udp* or *--tcp* is specified, *logger* will first try to "
14104"use UDP, but if this fails a TCP connection is attempted."
14105msgstr ""
14106
14107#. type: Labeled list
14108#: ../misc-utils/logger.1.adoc:101
14109#, no-wrap
14110msgid "*--no-act*"
14111msgstr ""
14112
14113#. type: Plain text
14114#: ../misc-utils/logger.1.adoc:103
14115msgid ""
14116"Causes everything to be done except for writing the log message to the "
14117"system log, and removing the connection or the journal. This option can be "
14118"used together with *--stderr* for testing purposes."
14119msgstr ""
14120
14121#. type: Labeled list
14122#: ../misc-utils/logger.1.adoc:104
14123#, no-wrap
14124msgid "*--octet-count*"
14125msgstr ""
14126
14127#. type: Plain text
14128#: ../misc-utils/logger.1.adoc:106
14129msgid ""
14130"Use the link:https://tools.ietf.org/html/rfc6587[RFC 6587] octet counting "
14131"framing method for sending messages. When this option is not used, the "
14132"default is no framing on UDP, and RFC6587 non-transparent framing (also "
14133"known as octet stuffing) on TCP."
14134msgstr ""
14135
14136#. type: Labeled list
14137#: ../misc-utils/logger.1.adoc:107
14138#, no-wrap
14139msgid "*-P*, *--port* _port_"
14140msgstr ""
14141
14142#. type: Plain text
14143#: ../misc-utils/logger.1.adoc:109
14144msgid ""
14145"Use the specified _port_. When this option is not specified, the port "
14146"defaults to syslog for udp and to syslog-conn for tcp connections."
14147msgstr ""
14148
14149#. type: Labeled list
14150#: ../misc-utils/logger.1.adoc:110 ../sys-utils/swapon.8.adoc:65
14151#, no-wrap
14152msgid "*-p*, *--priority* _priority_"
14153msgstr ""
14154
14155#. type: Plain text
14156#: ../misc-utils/logger.1.adoc:112
14157msgid ""
14158"Enter the message into the log with the specified _priority_. The priority "
14159"may be specified numerically or as a _facility_._level_ pair. For example, "
14160"*-p local3.info* logs the message as informational in the local3 "
14161"facility. The default is *user.notice*."
14162msgstr ""
14163
14164#. type: Labeled list
14165#: ../misc-utils/logger.1.adoc:113
14166#, no-wrap
14167msgid "*--prio-prefix*"
14168msgstr ""
14169
14170#. type: Plain text
14171#: ../misc-utils/logger.1.adoc:115
14172msgid ""
14173"Look for a syslog prefix on every line read from standard input. This prefix "
14174"is a decimal number within angle brackets that encodes both the facility and "
14175"the level. The number is constructed by multiplying the facility by 8 and "
14176"then adding the level. For example, *local0.info*, meaning facility=16 and "
14177"level=6, becomes *<134>*."
14178msgstr ""
14179
14180#. type: Plain text
14181#: ../misc-utils/logger.1.adoc:117
14182msgid ""
14183"If the prefix contains no facility, the facility defaults to what is "
14184"specified by the *-p* option. Similarly, if no prefix is provided, the line "
14185"is logged using the _priority_ given with *-p*."
14186msgstr ""
14187
14188#. type: Plain text
14189#: ../misc-utils/logger.1.adoc:119
14190msgid "This option doesn't affect a command-line message."
14191msgstr ""
14192
14193#. type: Labeled list
14194#: ../misc-utils/logger.1.adoc:120
14195#, no-wrap
14196msgid "*--rfc3164*"
14197msgstr ""
14198
14199#. type: Plain text
14200#: ../misc-utils/logger.1.adoc:122
14201msgid ""
14202"Use the link:https://tools.ietf.org/html/rfc3164[RFC 3164] BSD syslog "
14203"protocol to submit messages to a remote server."
14204msgstr ""
14205
14206#. type: Labeled list
14207#: ../misc-utils/logger.1.adoc:123
14208#, no-wrap
14209msgid "*--rfc5424*[**=**__without__]"
14210msgstr ""
14211
14212#. type: Plain text
14213#: ../misc-utils/logger.1.adoc:125
14214msgid ""
14215"Use the link:https://tools.ietf.org/html/rfc5424[RFC 5424] syslog protocol "
14216"to submit messages to a remote server. The optional _without_ argument can "
14217"be a comma-separated list of the following values: *notq*, *notime*, "
14218"*nohost*."
14219msgstr ""
14220
14221#. type: Plain text
14222#: ../misc-utils/logger.1.adoc:127
14223msgid ""
14224"The *notq* value suppresses the time-quality structured data from the "
14225"submitted message. The time-quality information shows whether the local "
14226"clock was synchronized plus the maximum number of microseconds the timestamp "
14227"might be off. The time quality is also automatically suppressed when "
14228"*--sd-id timeQuality* is specified."
14229msgstr ""
14230
14231#. type: Plain text
14232#: ../misc-utils/logger.1.adoc:129
14233msgid ""
14234"The *notime* value (which implies *notq*) suppresses the complete sender "
14235"timestamp that is in ISO-8601 format, including microseconds and timezone."
14236msgstr ""
14237
14238#. type: Plain text
14239#: ../misc-utils/logger.1.adoc:131
14240msgid ""
14241"The *nohost* value suppresses *gethostname*(2) information from the message "
14242"header."
14243msgstr ""
14244
14245#. type: Plain text
14246#: ../misc-utils/logger.1.adoc:133
14247msgid "The RFC 5424 protocol has been the default for *logger* since version 2.26."
14248msgstr ""
14249
14250#. type: Labeled list
14251#: ../misc-utils/logger.1.adoc:134
14252#, no-wrap
14253msgid "*-s*, *--stderr*"
14254msgstr ""
14255
14256#. type: Plain text
14257#: ../misc-utils/logger.1.adoc:136
14258msgid "Output the message to standard error as well as to the system log."
14259msgstr ""
14260
14261#. type: Labeled list
14262#: ../misc-utils/logger.1.adoc:137
14263#, no-wrap
14264msgid "*--sd-id* _name_[**@**__digits__]"
14265msgstr ""
14266
14267#. type: Plain text
14268#: ../misc-utils/logger.1.adoc:139
14269msgid ""
14270"Specifies a structured data element ID for an RFC 5424 message header. The "
14271"option has to be used before *--sd-param* to introduce a new element. The "
14272"number of structured data elements is unlimited. The ID (_name_ plus "
14273"possibly **@**__digits__) is case-sensitive and uniquely identifies the type "
14274"and purpose of the element. The same ID must not exist more than once in a "
14275"message. The **@**__digits__ part is required for user-defined "
14276"non-standardized IDs."
14277msgstr ""
14278
14279#. type: Plain text
14280#: ../misc-utils/logger.1.adoc:141
14281#, no-wrap
14282msgid ""
14283"*logger* currently generates the *timeQuality* standardized element "
14284"only. RFC 5424 also describes the elements *origin* (with parameters ip, "
14285"enterpriseId, software and swVersion) and *meta* (with parameters "
14286"sequenceId, sysUpTime and language). These element IDs may be specified "
14287"without the **@**__digits__ suffix.\n"
14288msgstr ""
14289
14290#. type: Labeled list
14291#: ../misc-utils/logger.1.adoc:142
14292#, no-wrap
14293msgid "*--sd-param* _name_=_value_"
14294msgstr ""
14295
14296#. type: Plain text
14297#: ../misc-utils/logger.1.adoc:144
14298msgid ""
14299"Specifies a structured data element parameter, a name and value pair. The "
14300"option has to be used after *--sd-id* and may be specified more than once "
14301"for the same element. Note that the quotation marks around _value_ are "
14302"required and must be escaped on the command line. +"
14303msgstr ""
14304
14305#. type: delimited block .
14306#: ../misc-utils/logger.1.adoc:151
14307#, no-wrap
14308msgid ""
14309" logger --rfc5424 --sd-id zoo@123 \\\n"
14310" --sd-param tiger=\"hungry\" \\\n"
14311" --sd-param zebra=\"running\" \\\n"
14312" --sd-id manager@123 \n"
14313" --sd-param onMeeting=\"yes\" \n"
14314" \"this is message\"\n"
14315msgstr ""
14316
14317#. type: Plain text
14318#: ../misc-utils/logger.1.adoc:154
14319msgid ""
14320"produces: + *<13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality "
14321"tzKnown=\"1\" isSynced=\"1\" syncAccuracy=\"218616\"][zoo@123 "
14322"tiger=\"hungry\" zebra=\"running\"][manager@123 onMeeting=\"yes\"] this is "
14323"message*"
14324msgstr ""
14325
14326#. type: Plain text
14327#: ../misc-utils/logger.1.adoc:157
14328msgid ""
14329"Sets the maximum permitted message size to _size_. The default is 1KiB "
14330"characters, which is the limit traditionally used and specified in RFC "
14331"3164. With RFC 5424, this limit has become flexible. A good assumption is "
14332"that RFC 5424 receivers can at least process 4KiB messages."
14333msgstr ""
14334
14335#. type: Plain text
14336#: ../misc-utils/logger.1.adoc:159
14337msgid ""
14338"Most receivers accept messages larger than 1KiB over any type of syslog "
14339"protocol. As such, the *--size* option affects logger in all cases (not only "
14340"when *--rfc5424* was used)."
14341msgstr ""
14342
14343#. type: Plain text
14344#: ../misc-utils/logger.1.adoc:161
14345msgid ""
14346"Note: the message-size limit limits the overall message size, including the "
14347"syslog header. Header sizes vary depending on the selected options and the "
14348"hostname length. As a rule of thumb, headers are usually not longer than 50 "
14349"to 80 characters. When selecting a maximum message size, it is important to "
14350"ensure that the receiver supports the max size as well, otherwise messages "
14351"may become truncated. Again, as a rule of thumb two to four KiB message size "
14352"should generally be OK, whereas anything larger should be verified to work."
14353msgstr ""
14354
14355#. type: Labeled list
14356#: ../misc-utils/logger.1.adoc:162
14357#, no-wrap
14358msgid "*--socket-errors*[**=**__mode__]"
14359msgstr ""
14360
14361#. type: Plain text
14362#: ../misc-utils/logger.1.adoc:164
14363msgid ""
14364"Print errors about Unix socket connections. The _mode_ can be a value of "
14365"*off*, *on*, or *auto*. When the mode is auto logger will detect if the init "
14366"process is systemd, and if so assumption is made _/dev/log_ can be used "
14367"early at boot. Other init systems lack of _/dev/log_ will not cause errors "
14368"that is identical with messaging using *openlog*(3) system call. The "
14369"*logger*(1) before version 2.26 used openlog, and hence was unable to "
14370"detected loss of messages sent to Unix sockets."
14371msgstr ""
14372
14373#. type: Plain text
14374#: ../misc-utils/logger.1.adoc:166
14375msgid ""
14376"The default mode is *auto*. When errors are not enabled lost messages are "
14377"not communicated and will result to successful exit status of *logger*(1) "
14378"invocation."
14379msgstr ""
14380
14381#. type: Labeled list
14382#: ../misc-utils/logger.1.adoc:167
14383#, no-wrap
14384msgid "*-T*, *--tcp*"
14385msgstr ""
14386
14387#. type: Plain text
14388#: ../misc-utils/logger.1.adoc:169
14389msgid ""
14390"Use stream (TCP) only. By default the connection is tried to the "
14391"_syslog-conn_ port defined in _/etc/services_, which is often _601_."
14392msgstr ""
14393
14394#. type: Labeled list
14395#: ../misc-utils/logger.1.adoc:172
14396#, no-wrap
14397msgid "*-t*, *--tag* _tag_"
14398msgstr ""
14399
14400#. type: Plain text
14401#: ../misc-utils/logger.1.adoc:174
14402msgid ""
14403"Mark every line to be logged with the specified _tag_. The default tag is "
14404"the name of the user logged in on the terminal (or a user name based on "
14405"effective user ID)."
14406msgstr ""
14407
14408#. type: Labeled list
14409#: ../misc-utils/logger.1.adoc:175
14410#, no-wrap
14411msgid "*-u*, *--socket* _socket_"
14412msgstr ""
14413
14414#. type: Plain text
14415#: ../misc-utils/logger.1.adoc:177
14416msgid "Write to the specified _socket_ instead of to the system log socket."
14417msgstr ""
14418
14419#. type: Labeled list
14420#: ../misc-utils/logger.1.adoc:178
14421#, no-wrap
14422msgid "*--*"
14423msgstr ""
14424
14425#. type: Plain text
14426#: ../misc-utils/logger.1.adoc:180
14427msgid "End the argument list. This allows the _message_ to start with a hyphen (-)."
14428msgstr ""
14429
14430#. type: Plain text
14431#: ../misc-utils/logger.1.adoc:190
14432msgid "The *logger* utility exits 0 on success, and >0 if an error occurs."
14433msgstr ""
14434
14435#. type: Title ==
14436#: ../misc-utils/logger.1.adoc:191
14437#, no-wrap
14438msgid "FACILITIES AND LEVELS"
14439msgstr ""
14440
14441#. type: Plain text
14442#: ../misc-utils/logger.1.adoc:194
14443msgid "Valid facility names are:"
14444msgstr ""
14445
14446#. type: Plain text
14447#: ../misc-utils/logger.1.adoc:198
14448#, no-wrap
14449msgid ""
14450"*auth* +\n"
14451"*authpriv* for security information of a sensitive nature +\n"
14452"*cron* +\n"
14453msgstr ""
14454
14455#. type: Plain text
14456#: ../misc-utils/logger.1.adoc:202
14457#, no-wrap
14458msgid ""
14459"*daemon* +\n"
14460"*ftp* +\n"
14461"*kern* cannot be generated from userspace process, automatically converted "
14462"to *user* +\n"
14463msgstr ""
14464
14465#. type: Plain text
14466#: ../misc-utils/logger.1.adoc:213
14467#, no-wrap
14468msgid ""
14469"*lpr* +\n"
14470"*mail* + \n"
14471"*news* +\n"
14472"*syslog* +\n"
14473"*user* +\n"
14474"*uucp* +\n"
14475"*local0* +\n"
14476" to +\n"
14477"*local7* + \n"
14478"*security* deprecated synonym for *auth*\n"
14479msgstr ""
14480
14481#. type: Plain text
14482#: ../misc-utils/logger.1.adoc:215
14483msgid "Valid level names are:"
14484msgstr ""
14485
14486#. type: Plain text
14487#: ../misc-utils/logger.1.adoc:227
14488#, no-wrap
14489msgid ""
14490"*emerg* +\n"
14491"*alert* +\n"
14492"*crit* +\n"
14493"*err* +\n"
14494"*warning* +\n"
14495"*notice* +\n"
14496"*info* +\n"
14497"*debug* +\n"
14498"*panic* deprecated synonym for *emerg* +\n"
14499"*error* deprecated synonym for *err* +\n"
14500"*warn* deprecated synonym for *warning* +\n"
14501msgstr ""
14502
14503#. type: Plain text
14504#: ../misc-utils/logger.1.adoc:229
14505msgid ""
14506"For the priority order and intended purposes of these facilities and levels, "
14507"see *syslog*(3)."
14508msgstr ""
14509
14510#. type: Plain text
14511#: ../misc-utils/logger.1.adoc:233
14512msgid ""
14513"The *logger* command is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
14514"compatible."
14515msgstr ""
14516
14517#. type: Plain text
14518#: ../misc-utils/logger.1.adoc:237
14519#, no-wrap
14520msgid ""
14521"*logger System rebooted* *logger -p local0.notice -t HOSTIDM -f /dev/idmc* "
14522"*logger -n loghost.example.com System rebooted*\n"
14523msgstr ""
14524
14525#. type: Plain text
14526#: ../misc-utils/logger.1.adoc:241
14527msgid ""
14528"The *logger* command was originally written by University of California in "
14529"1983-1993 and later rewritten by mailto:kzak@redhat.com[Karel Zak], "
14530"mailto:rgerhards@adiscon.com[Rainer Gerhards], and "
14531"mailto:kerolasa@iki.fi[Sami Kerola]."
14532msgstr ""
14533
14534#. type: Plain text
14535#: ../misc-utils/logger.1.adoc:247
14536#, no-wrap
14537msgid ""
14538"*journalctl*(1),\n"
14539"*syslog*(3),\n"
14540"*systemd.journal-fields*(7)\n"
14541msgstr ""
14542
14543#. Copyright (c) 1990, 1993
14544#. The Regents of the University of California. All rights reserved.
14545#
14546#. Redistribution and use in source and binary forms, with or without
14547#. modification, are permitted provided that the following conditions
14548#. are met:
14549#. 1. Redistributions of source code must retain the above copyright
14550#. notice, this list of conditions and the following disclaimer.
14551#. 2. Redistributions in binary form must reproduce the above copyright
14552#. notice, this list of conditions and the following disclaimer in the
14553#. documentation and/or other materials provided with the distribution.
14554#. 3. All advertising materials mentioning features or use of this software
14555#. must display the following acknowledgement:
14556#. This product includes software developed by the University of
14557#. California, Berkeley and its contributors.
14558#. 4. Neither the name of the University nor the names of its contributors
14559#. may be used to endorse or promote products derived from this software
14560#. without specific prior written permission.
14561#
14562#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
14563#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14564#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
14565#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
14566#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
14567#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
14568#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
14569#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
14570#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
14571#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
14572#. SUCH DAMAGE.
14573#
14574#. @(#)look.1 8.1 (Berkeley) 6/14/93
14575#. type: Title =
14576#: ../misc-utils/look.1.adoc:36
14577#, no-wrap
14578msgid "look(1)"
14579msgstr ""
14580
14581#. type: Plain text
14582#: ../misc-utils/look.1.adoc:46
14583msgid "look - display lines beginning with a given string"
14584msgstr ""
14585
14586#. type: Plain text
14587#: ../misc-utils/look.1.adoc:50
14588#, no-wrap
14589msgid "*look* [options] _string_ [_file_]\n"
14590msgstr ""
14591
14592#. type: Plain text
14593#: ../misc-utils/look.1.adoc:54
14594msgid ""
14595"The *look* utility displays any lines in _file_ which contain _string_. As "
14596"*look* performs a binary search, the lines in _file_ must be sorted (where "
14597"*sort*(1) was given the same options *-d* and/or *-f* that *look* is invoked "
14598"with)."
14599msgstr ""
14600
14601#. type: Plain text
14602#: ../misc-utils/look.1.adoc:56
14603msgid ""
14604"If _file_ is not specified, the file _/usr/share/dict/words_ is used, only "
14605"alphanumeric characters are compared and the case of alphabetic characters "
14606"is ignored."
14607msgstr ""
14608
14609#. type: Plain text
14610#: ../misc-utils/look.1.adoc:61
14611msgid "Use the alternative dictionary file."
14612msgstr ""
14613
14614#. type: Labeled list
14615#: ../misc-utils/look.1.adoc:62
14616#, no-wrap
14617msgid "*-d*, *--alphanum*"
14618msgstr ""
14619
14620#. type: Plain text
14621#: ../misc-utils/look.1.adoc:64
14622msgid ""
14623"Use normal dictionary character set and order, i.e., only blanks and "
14624"alphanumeric characters are compared. This is on by default if no file is "
14625"specified."
14626msgstr ""
14627
14628#. type: Plain text
14629#: ../misc-utils/look.1.adoc:66
14630msgid ""
14631"Note that blanks have been added to dictionary character set for "
14632"compatibility with *sort -d* command since version 2.28."
14633msgstr ""
14634
14635#. type: Labeled list
14636#: ../misc-utils/look.1.adoc:67
14637#, no-wrap
14638msgid "*-f*, *--ignore-case*"
14639msgstr ""
14640
14641#. type: Plain text
14642#: ../misc-utils/look.1.adoc:69
14643msgid ""
14644"Ignore the case of alphabetic characters. This is on by default if no file "
14645"is specified."
14646msgstr ""
14647
14648#. type: Labeled list
14649#: ../misc-utils/look.1.adoc:70
14650#, no-wrap
14651msgid "*-t*, *--terminate* _character_"
14652msgstr ""
14653
14654#. type: Plain text
14655#: ../misc-utils/look.1.adoc:72
14656msgid ""
14657"Specify a string termination character, i.e., only the characters in "
14658"_string_ up to and including the first occurrence of _character_ are "
14659"compared."
14660msgstr ""
14661
14662#. type: Plain text
14663#: ../misc-utils/look.1.adoc:80
14664msgid ""
14665"The *look* utility exits 0 if one or more lines were found and displayed, 1 "
14666"if no lines were found, and >1 if an error occurred."
14667msgstr ""
14668
14669#. type: Labeled list
14670#: ../misc-utils/look.1.adoc:83
14671#, no-wrap
14672msgid "*WORDLIST*"
14673msgstr ""
14674
14675#. type: Plain text
14676#: ../misc-utils/look.1.adoc:85
14677msgid ""
14678"Path to a dictionary file. The environment variable has greater priority "
14679"than the dictionary path defined in FILES segment."
14680msgstr ""
14681
14682#. type: Labeled list
14683#: ../misc-utils/look.1.adoc:88
14684#, no-wrap
14685msgid "_/usr/share/dict/words_"
14686msgstr ""
14687
14688#. type: Plain text
14689#: ../misc-utils/look.1.adoc:90
14690msgid "the dictionary"
14691msgstr ""
14692
14693#. type: Labeled list
14694#: ../misc-utils/look.1.adoc:91
14695#, no-wrap
14696msgid "_/usr/share/dict/web2_"
14697msgstr ""
14698
14699#. type: Plain text
14700#: ../misc-utils/look.1.adoc:93
14701msgid "the alternative dictionary"
14702msgstr ""
14703
14704#. type: Plain text
14705#: ../misc-utils/look.1.adoc:97
14706msgid "The *look* utility appeared in Version 7 AT&T Unix."
14707msgstr ""
14708
14709#. type: delimited block .
14710#: ../misc-utils/look.1.adoc:103
14711#, no-wrap
14712msgid ""
14713"sort -d /etc/passwd -o /tmp/look.dict\n"
14714"look -t: root:foobar /tmp/look.dict\n"
14715msgstr ""
14716
14717#. type: Plain text
14718#: ../misc-utils/look.1.adoc:109
14719#, no-wrap
14720msgid ""
14721"*grep*(1),\n"
14722"*sort*(1)\n"
14723msgstr ""
14724
14725#. type: Title =
14726#: ../misc-utils/lsblk.8.adoc:2
14727#, no-wrap
14728msgid "lsblk(8)"
14729msgstr ""
14730
14731#. type: Plain text
14732#: ../misc-utils/lsblk.8.adoc:12
14733msgid "lsblk - list block devices"
14734msgstr ""
14735
14736#. type: Plain text
14737#: ../misc-utils/lsblk.8.adoc:16
14738#, no-wrap
14739msgid "*lsblk* [options] [_device_...]\n"
14740msgstr ""
14741
14742#. type: Plain text
14743#: ../misc-utils/lsblk.8.adoc:20
14744#, no-wrap
14745msgid ""
14746"*lsblk* lists information about all available or the specified block "
14747"devices. The *lsblk* command reads the *sysfs* filesystem and *udev db* to "
14748"gather information. If the udev db is not available or *lsblk* is compiled "
14749"without udev support, then it tries to read LABELs, UUIDs and filesystem "
14750"types from the block device. In this case root permissions are necessary.\n"
14751msgstr ""
14752
14753#. type: Plain text
14754#: ../misc-utils/lsblk.8.adoc:22
14755msgid ""
14756"The command prints all block devices (except RAM disks) in a tree-like "
14757"format by default. Use *lsblk --help* to get a list of all available "
14758"columns."
14759msgstr ""
14760
14761#. type: Plain text
14762#: ../misc-utils/lsblk.8.adoc:24
14763msgid ""
14764"The default output, as well as the default output from options like *--fs* "
14765"and *--topology*, is subject to change. So whenever possible, you should "
14766"avoid using default outputs in your scripts. Always explicitly define "
14767"expected columns by using *--output* _columns-list_ and *--list* in "
14768"environments where a stable output is required."
14769msgstr ""
14770
14771#. type: Plain text
14772#: ../misc-utils/lsblk.8.adoc:26
14773msgid ""
14774"Note that *lsblk* might be executed in time when *udev* does not have all "
14775"information about recently added or modified devices yet. In this case it is "
14776"recommended to use *udevadm settle* before *lsblk* to synchronize with udev."
14777msgstr ""
14778
14779#. type: Plain text
14780#: ../misc-utils/lsblk.8.adoc:28
14781msgid ""
14782"The relationship between block devices and filesystems is not always "
14783"one-to-one. The filesystem may use more block devices, or the same "
14784"filesystem may be accessible by more paths. This is the reason why *lsblk* "
14785"provides MOUNTPOINT and MOUNTPOINTS (pl.) columns. The column MOUNTPOINT "
14786"displays only one mount point (usually the last mounted instance of the "
14787"filesystem), and the column MOUNTPOINTS displays by multi-line cell all "
14788"mount points associated with the device."
14789msgstr ""
14790
14791#. type: Plain text
14792#: ../misc-utils/lsblk.8.adoc:33
14793msgid "Also list empty devices and RAM disk devices."
14794msgstr ""
14795
14796#. type: Labeled list
14797#: ../misc-utils/lsblk.8.adoc:37
14798#, no-wrap
14799msgid "*-D*, *--discard*"
14800msgstr ""
14801
14802#. type: Plain text
14803#: ../misc-utils/lsblk.8.adoc:39
14804msgid ""
14805"Print information about the discarding capabilities (TRIM, UNMAP) for each "
14806"device."
14807msgstr ""
14808
14809#. type: Labeled list
14810#: ../misc-utils/lsblk.8.adoc:40
14811#, no-wrap
14812msgid "*-d*, *--nodeps*"
14813msgstr ""
14814
14815#. type: Plain text
14816#: ../misc-utils/lsblk.8.adoc:42
14817msgid ""
14818"Do not print holder devices or slaves. For example, *lsblk --nodeps "
14819"/dev/sda* prints information about the sda device only."
14820msgstr ""
14821
14822#. type: Labeled list
14823#: ../misc-utils/lsblk.8.adoc:43
14824#, no-wrap
14825msgid "*-E*, *--dedup* _column_"
14826msgstr ""
14827
14828#. type: Plain text
14829#: ../misc-utils/lsblk.8.adoc:45
14830msgid ""
14831"Use _column_ as a de-duplication key to de-duplicate output tree. If the key "
14832"is not available for the device, or the device is a partition and parental "
14833"whole-disk device provides the same key than the device is always printed."
14834msgstr ""
14835
14836#. type: Plain text
14837#: ../misc-utils/lsblk.8.adoc:47
14838msgid ""
14839"The usual use case is to de-duplicate output on system multi-path devices, "
14840"for example by *-E WWN*."
14841msgstr ""
14842
14843#. type: Labeled list
14844#: ../misc-utils/lsblk.8.adoc:48
14845#, no-wrap
14846msgid "-e*, *--exclude* _list_"
14847msgstr ""
14848
14849#. type: Plain text
14850#: ../misc-utils/lsblk.8.adoc:50
14851msgid ""
14852"Exclude the devices specified by the comma-separated _list_ of major device "
14853"numbers. Note that RAM disks (major=1) are excluded by default if *--all* is "
14854"not specified. The filter is applied to the top-level devices only. This may "
14855"be confusing for *--list* output format where hierarchy of the devices is "
14856"not obvious."
14857msgstr ""
14858
14859#. type: Labeled list
14860#: ../misc-utils/lsblk.8.adoc:51
14861#, no-wrap
14862msgid "*-f*, *--fs*"
14863msgstr ""
14864
14865#. type: Plain text
14866#: ../misc-utils/lsblk.8.adoc:53
14867msgid ""
14868"Output info about filesystems. This option is equivalent to *-o "
14869"NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS*. The authoritative "
14870"information about filesystems and raids is provided by the *blkid*(8) "
14871"command."
14872msgstr ""
14873
14874#. type: Labeled list
14875#: ../misc-utils/lsblk.8.adoc:57
14876#, no-wrap
14877msgid "*-I*, *--include* _list_"
14878msgstr ""
14879
14880#. type: Plain text
14881#: ../misc-utils/lsblk.8.adoc:59
14882msgid ""
14883"Include devices specified by the comma-separated _list_ of major device "
14884"numbers. The filter is applied to the top-level devices only. This may be "
14885"confusing for *--list* output format where hierarchy of the devices is not "
14886"obvious."
14887msgstr ""
14888
14889#. type: Labeled list
14890#: ../misc-utils/lsblk.8.adoc:60
14891#, no-wrap
14892msgid "*-i*, *--ascii*"
14893msgstr ""
14894
14895#. type: Plain text
14896#: ../misc-utils/lsblk.8.adoc:62
14897msgid "Use ASCII characters for tree formatting."
14898msgstr ""
14899
14900#. type: Plain text
14901#: ../misc-utils/lsblk.8.adoc:65
14902msgid ""
14903"Use JSON output format. It's strongly recommended to use *--output* and also "
14904"*--tree* if necessary."
14905msgstr ""
14906
14907#. type: Plain text
14908#: ../misc-utils/lsblk.8.adoc:68
14909msgid ""
14910"Produce output in the form of a list. The output does not provide "
14911"information about relationships between devices and since version 2.34 every "
14912"device is printed only once if *--pairs* or *--raw* not specified (the "
14913"parsable outputs are maintained in backwardly compatible way)."
14914msgstr ""
14915
14916#. type: Labeled list
14917#: ../misc-utils/lsblk.8.adoc:69
14918#, no-wrap
14919msgid "*-M*, *--merge*"
14920msgstr ""
14921
14922#. type: Plain text
14923#: ../misc-utils/lsblk.8.adoc:71
14924msgid ""
14925"Group parents of sub-trees to provide more readable output for RAIDs and "
14926"Multi-path devices. The tree-like output is required."
14927msgstr ""
14928
14929#. type: Labeled list
14930#: ../misc-utils/lsblk.8.adoc:72
14931#, no-wrap
14932msgid "*-m*, *--perms*"
14933msgstr ""
14934
14935#. type: Plain text
14936#: ../misc-utils/lsblk.8.adoc:74
14937msgid ""
14938"Output info about device owner, group and mode. This option is equivalent to "
14939"*-o NAME,SIZE,OWNER,GROUP,MODE*."
14940msgstr ""
14941
14942#. type: Plain text
14943#: ../misc-utils/lsblk.8.adoc:80
14944msgid ""
14945"Specify which output columns to print. Use *--help* to get a list of all "
14946"supported columns. The columns may affect tree-like output. The default is "
14947"to use tree for the column 'NAME' (see also *--tree*)."
14948msgstr ""
14949
14950#. type: Plain text
14951#: ../misc-utils/lsblk.8.adoc:82
14952msgid ""
14953"The default list of columns may be extended if _list_ is specified in the "
14954"format _+list_ (e.g., *lsblk -o +UUID*)."
14955msgstr ""
14956
14957#. type: Labeled list
14958#: ../misc-utils/lsblk.8.adoc:83
14959#, no-wrap
14960msgid "*-O*, *--output-all*"
14961msgstr ""
14962
14963#. type: Plain text
14964#: ../misc-utils/lsblk.8.adoc:88
14965msgid ""
14966"Produce output in the form of key=\"value\" pairs. The output lines are "
14967"still ordered by dependencies. All potentially unsafe value characters are "
14968"hex-escaped (\\x<code>). The key (variable name) will be modified to contain "
14969"only characters allowed for a shell variable identifiers, for example, "
14970"MIN_IO and FSUSE_PCT instead of MIN-IO and FSUSE%."
14971msgstr ""
14972
14973#. type: Labeled list
14974#: ../misc-utils/lsblk.8.adoc:89
14975#, no-wrap
14976msgid "*-p*, *--paths*"
14977msgstr ""
14978
14979#. type: Plain text
14980#: ../misc-utils/lsblk.8.adoc:91
14981msgid "Print full device paths."
14982msgstr ""
14983
14984#. type: Plain text
14985#: ../misc-utils/lsblk.8.adoc:94
14986msgid ""
14987"Produce output in raw format. The output lines are still ordered by "
14988"dependencies. All potentially unsafe characters are hex-escaped (\\x<code>) "
14989"in the NAME, KNAME, LABEL, PARTLABEL and MOUNTPOINT columns."
14990msgstr ""
14991
14992#. type: Labeled list
14993#: ../misc-utils/lsblk.8.adoc:95
14994#, no-wrap
14995msgid "*-S*, *--scsi*"
14996msgstr ""
14997
14998#. type: Plain text
14999#: ../misc-utils/lsblk.8.adoc:97
15000msgid ""
15001"Output info about SCSI devices only. All partitions, slaves and holder "
15002"devices are ignored."
15003msgstr ""
15004
15005#. type: Labeled list
15006#: ../misc-utils/lsblk.8.adoc:98
15007#, no-wrap
15008msgid "*-s*, *--inverse*"
15009msgstr ""
15010
15011#. type: Plain text
15012#: ../misc-utils/lsblk.8.adoc:100
15013msgid ""
15014"Print dependencies in inverse order. If the *--list* output is requested "
15015"then the lines are still ordered by dependencies."
15016msgstr ""
15017
15018#. type: Labeled list
15019#: ../misc-utils/lsblk.8.adoc:101
15020#, no-wrap
15021msgid "*-T*, *--tree*[**=**__column__]"
15022msgstr ""
15023
15024#. type: Plain text
15025#: ../misc-utils/lsblk.8.adoc:103
15026msgid ""
15027"Force tree-like output format. If _column_ is specified, then a tree is "
15028"printed in the column. The default is NAME column."
15029msgstr ""
15030
15031#. type: Labeled list
15032#: ../misc-utils/lsblk.8.adoc:104
15033#, no-wrap
15034msgid "*-t*, *--topology*"
15035msgstr ""
15036
15037#. type: Plain text
15038#: ../misc-utils/lsblk.8.adoc:106
15039msgid "Output info about block-device topology. This option is equivalent to"
15040msgstr ""
15041
15042#. type: Plain text
15043#: ../misc-utils/lsblk.8.adoc:108
15044msgid "NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME*."
15045msgstr ""
15046
15047#. type: Labeled list
15048#: ../misc-utils/lsblk.8.adoc:112
15049#, no-wrap
15050msgid "*-w*, *--width* _number_"
15051msgstr ""
15052
15053#. type: Plain text
15054#: ../misc-utils/lsblk.8.adoc:114
15055msgid ""
15056"Specifies output width as a number of characters. The default is the number "
15057"of the terminal columns, and if not executed on a terminal, then output "
15058"width is not restricted at all by default. This option also forces *lsblk* "
15059"to assume that terminal control characters and unsafe characters are not "
15060"allowed. The expected use-case is for example when *lsblk* is used by the "
15061"*watch*(1) command."
15062msgstr ""
15063
15064#. type: Labeled list
15065#: ../misc-utils/lsblk.8.adoc:115
15066#, no-wrap
15067msgid "*-x*, *--sort* _column_"
15068msgstr ""
15069
15070#. type: Plain text
15071#: ../misc-utils/lsblk.8.adoc:117
15072msgid ""
15073"Sort output lines by _column_. This option enables *--list* output format by "
15074"default. It is possible to use the option *--tree* to force tree-like output "
15075"and than the tree branches are sorted by the _column_."
15076msgstr ""
15077
15078#. type: Labeled list
15079#: ../misc-utils/lsblk.8.adoc:118
15080#, no-wrap
15081msgid "*-z*, *--zoned*"
15082msgstr ""
15083
15084#. type: Plain text
15085#: ../misc-utils/lsblk.8.adoc:120
15086msgid "Print the zone model for each device."
15087msgstr ""
15088
15089#. type: Labeled list
15090#: ../misc-utils/lsblk.8.adoc:121
15091#, no-wrap
15092msgid "*--sysroot* _directory_"
15093msgstr ""
15094
15095#. type: Plain text
15096#: ../misc-utils/lsblk.8.adoc:123
15097msgid ""
15098"Gather data for a Linux instance other than the instance from which the "
15099"*lsblk* command is issued. The specified directory is the system root of the "
15100"Linux instance to be inspected. The real device nodes in the target "
15101"directory can be replaced by text files with udev attributes."
15102msgstr ""
15103
15104#. type: Labeled list
15105#: ../misc-utils/lsblk.8.adoc:132 ../sys-utils/fstrim.8.adoc:74
15106#, no-wrap
15107msgid "32"
15108msgstr ""
15109
15110#. type: Plain text
15111#: ../misc-utils/lsblk.8.adoc:134
15112msgid "none of specified devices found"
15113msgstr ""
15114
15115#. type: Labeled list
15116#: ../misc-utils/lsblk.8.adoc:135 ../sys-utils/fstrim.8.adoc:76
15117#, no-wrap
15118msgid "64"
15119msgstr ""
15120
15121#. type: Plain text
15122#: ../misc-utils/lsblk.8.adoc:137
15123msgid "some specified devices found, some not found"
15124msgstr ""
15125
15126#. type: Labeled list
15127#: ../misc-utils/lsblk.8.adoc:140
15128#, no-wrap
15129msgid "LSBLK_DEBUG=all"
15130msgstr ""
15131
15132#. type: Plain text
15133#: ../misc-utils/lsblk.8.adoc:142
15134msgid "enables *lsblk* debug output."
15135msgstr ""
15136
15137#. type: Plain text
15138#: ../misc-utils/lsblk.8.adoc:145 ../sys-utils/swapon.8.adoc:131
15139msgid "enables *libblkid* debug output."
15140msgstr ""
15141
15142#. type: Plain text
15143#: ../misc-utils/lsblk.8.adoc:148 ../sys-utils/swapon.8.adoc:128
15144msgid "enables *libmount* debug output."
15145msgstr ""
15146
15147#. type: Plain text
15148#: ../misc-utils/lsblk.8.adoc:151
15149msgid "enables *libsmartcols* debug output."
15150msgstr ""
15151
15152#. type: Plain text
15153#: ../misc-utils/lsblk.8.adoc:158
15154msgid ""
15155"For partitions, some information (e.g., queue attributes) is inherited from "
15156"the parent device."
15157msgstr ""
15158
15159#. type: Plain text
15160#: ../misc-utils/lsblk.8.adoc:160
15161msgid ""
15162"The *lsblk* command needs to be able to look up each block device by "
15163"major:minor numbers, which is done by using _/sys/dev/block_. This sysfs "
15164"block directory appeared in kernel 2.6.27 (October 2008). In case of "
15165"problems with a new enough kernel, check that CONFIG_SYSFS was enabled at "
15166"the time of the kernel build."
15167msgstr ""
15168
15169#. type: Plain text
15170#: ../misc-utils/lsblk.8.adoc:165
15171msgid "mailto:mbroz@redhat.com[Milan Broz], mailto:kzak@redhat.com[Karel Zak]"
15172msgstr ""
15173
15174#. type: Plain text
15175#: ../misc-utils/lsblk.8.adoc:171
15176#, no-wrap
15177msgid ""
15178"*ls*(1),\n"
15179"*blkid*(8),\n"
15180"*findmnt*(8)\n"
15181msgstr ""
15182
15183#. Man page for the lslocks command.
15184#. Copyright 2012 Davidlohr Bueso <dave@gnu.org>
15185#. May be distributed under the GNU General Public License
15186#. Copyright 1994 Salvatore Valente (svalente@mit.edu)
15187#. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
15188#. May be distributed under the GNU General Public License
15189#. type: Title =
15190#: ../misc-utils/lslocks.8.adoc:12
15191#, no-wrap
15192msgid "lslocks(8)"
15193msgstr ""
15194
15195#. type: Plain text
15196#: ../misc-utils/lslocks.8.adoc:23
15197msgid "lslocks - list local system locks"
15198msgstr ""
15199
15200#. type: Plain text
15201#: ../misc-utils/lslocks.8.adoc:27
15202#, no-wrap
15203msgid "*lslocks* [options]\n"
15204msgstr ""
15205
15206#. type: Plain text
15207#: ../misc-utils/lslocks.8.adoc:31
15208#, no-wrap
15209msgid ""
15210"*lslocks* lists information about all the currently held file locks in a "
15211"Linux system.\n"
15212msgstr ""
15213
15214#. type: Plain text
15215#: ../misc-utils/lslocks.8.adoc:33
15216msgid ""
15217"Note that lslocks also lists OFD (Open File Description) locks, these locks "
15218"are not associated with any process (PID is -1). OFD locks are associated "
15219"with the open file description on which they are acquired. This lock type is "
15220"available since Linux 3.15, see *fcntl*(2) for more details."
15221msgstr ""
15222
15223#. type: Labeled list
15224#: ../misc-utils/lslocks.8.adoc:39
15225#, no-wrap
15226msgid "*-i*, *--noinaccessible*"
15227msgstr ""
15228
15229#. type: Plain text
15230#: ../misc-utils/lslocks.8.adoc:41
15231msgid "Ignore lock files which are inaccessible for the current user."
15232msgstr ""
15233
15234#. TRANSLATORS: Keep {plus} untranslated.
15235#. type: Plain text
15236#: ../misc-utils/lslocks.8.adoc:53
15237msgid ""
15238"The default list of columns may be extended if _list_ is specified in the "
15239"format _{plus}list_ (e.g., *lslocks -o {plus}BLOCKER*)."
15240msgstr ""
15241
15242#. type: Labeled list
15243#: ../misc-utils/lslocks.8.adoc:57 ../sys-utils/choom.1.adoc:25
15244#, no-wrap
15245msgid "*-p*, *--pid* _pid_"
15246msgstr ""
15247
15248#. type: Plain text
15249#: ../misc-utils/lslocks.8.adoc:59
15250msgid "Display only the locks held by the process with this _pid_."
15251msgstr ""
15252
15253#. type: Plain text
15254#: ../misc-utils/lslocks.8.adoc:62 ../misc-utils/uuidparse.1.adoc:61
15255#: ../sys-utils/lsns.8.adoc:56 ../sys-utils/prlimit.1.adoc:57
15256#: ../sys-utils/rfkill.8.adoc:41 ../sys-utils/wdctl.8.adoc:47
15257msgid "Use the raw output format."
15258msgstr ""
15259
15260#. type: Plain text
15261#: ../misc-utils/lslocks.8.adoc:65 ../sys-utils/lsns.8.adoc:62
15262msgid "Do not truncate text in columns."
15263msgstr ""
15264
15265#. type: Labeled list
15266#: ../misc-utils/lslocks.8.adoc:74
15267#, no-wrap
15268msgid "COMMAND"
15269msgstr ""
15270
15271#. type: Plain text
15272#: ../misc-utils/lslocks.8.adoc:76
15273msgid "The command name of the process holding the lock."
15274msgstr ""
15275
15276#. type: Labeled list
15277#: ../misc-utils/lslocks.8.adoc:77
15278#, no-wrap
15279msgid "PID"
15280msgstr ""
15281
15282#. type: Plain text
15283#: ../misc-utils/lslocks.8.adoc:79
15284msgid "The process ID of the process which holds the lock or -1 for OFDLCK."
15285msgstr ""
15286
15287#. type: Labeled list
15288#: ../misc-utils/lslocks.8.adoc:80
15289#, no-wrap
15290msgid "TYPE"
15291msgstr ""
15292
15293#. type: Plain text
15294#: ../misc-utils/lslocks.8.adoc:82
15295msgid ""
15296"The type of lock; can be FLOCK (created with *flock*(2)), POSIX (created "
15297"with *fcntl*(2) and *lockf*(3)) or OFDLCK (created with *fcntl*(2))."
15298msgstr ""
15299
15300#. type: Labeled list
15301#: ../misc-utils/lslocks.8.adoc:83
15302#, no-wrap
15303msgid "SIZE"
15304msgstr ""
15305
15306#. type: Plain text
15307#: ../misc-utils/lslocks.8.adoc:85
15308msgid "Size of the locked file."
15309msgstr ""
15310
15311#. type: Labeled list
15312#: ../misc-utils/lslocks.8.adoc:86
15313#, no-wrap
15314msgid "MODE"
15315msgstr ""
15316
15317#. type: Plain text
15318#: ../misc-utils/lslocks.8.adoc:88
15319msgid ""
15320"The lock's access permissions (read, write). If the process is blocked and "
15321"waiting for the lock, then the mode is postfixed with an '*' (asterisk)."
15322msgstr ""
15323
15324#. type: Labeled list
15325#: ../misc-utils/lslocks.8.adoc:89
15326#, no-wrap
15327msgid "M"
15328msgstr ""
15329
15330#. type: Plain text
15331#: ../misc-utils/lslocks.8.adoc:91
15332msgid ""
15333"Whether the lock is mandatory; 0 means no (meaning the lock is only "
15334"advisory), 1 means yes. (See *fcntl*(2).)"
15335msgstr ""
15336
15337#. type: Labeled list
15338#: ../misc-utils/lslocks.8.adoc:92
15339#, no-wrap
15340msgid "START"
15341msgstr ""
15342
15343#. type: Plain text
15344#: ../misc-utils/lslocks.8.adoc:94
15345msgid "Relative byte offset of the lock."
15346msgstr ""
15347
15348#. type: Labeled list
15349#: ../misc-utils/lslocks.8.adoc:95
15350#, no-wrap
15351msgid "END"
15352msgstr ""
15353
15354#. type: Plain text
15355#: ../misc-utils/lslocks.8.adoc:97
15356msgid "Ending offset of the lock."
15357msgstr ""
15358
15359#. type: Labeled list
15360#: ../misc-utils/lslocks.8.adoc:98
15361#, no-wrap
15362msgid "PATH"
15363msgstr ""
15364
15365#. type: Plain text
15366#: ../misc-utils/lslocks.8.adoc:100
15367msgid ""
15368"Full path of the lock. If none is found, or there are no permissions to read "
15369"the path, it will fall back to the device's mountpoint and \"...\" is "
15370"appended to the path. The path might be truncated; use *--notruncate* to get "
15371"the full path."
15372msgstr ""
15373
15374#. type: Labeled list
15375#: ../misc-utils/lslocks.8.adoc:101
15376#, no-wrap
15377msgid "BLOCKER"
15378msgstr ""
15379
15380#. type: Plain text
15381#: ../misc-utils/lslocks.8.adoc:103
15382msgid "The PID of the process which blocks the lock."
15383msgstr ""
15384
15385#. type: Plain text
15386#: ../misc-utils/lslocks.8.adoc:107
15387msgid ""
15388"The *lslocks* command is meant to replace the *lslk*(8) command, originally "
15389"written by mailto:abe@purdue.edu[Victor A. Abell] and unmaintained since "
15390"2001."
15391msgstr ""
15392
15393#. type: Plain text
15394#: ../misc-utils/lslocks.8.adoc:111
15395msgid "mailto:dave@gnu.org[Davidlohr Bueso]"
15396msgstr ""
15397
15398#. type: Plain text
15399#: ../misc-utils/lslocks.8.adoc:117
15400#, no-wrap
15401msgid ""
15402"*flock*(1),\n"
15403"*fcntl*(2),\n"
15404"*lockf*(3)\n"
15405msgstr ""
15406
15407#. mcookie.1 --
15408#. Public Domain 1995 Rickard E. Faith (faith@cs.unc.edu)
15409#. type: Title =
15410#: ../misc-utils/mcookie.1.adoc:4
15411#, no-wrap
15412msgid "mcookie(1)"
15413msgstr ""
15414
15415#. type: Plain text
15416#: ../misc-utils/mcookie.1.adoc:14
15417msgid "mcookie - generate magic cookies for xauth"
15418msgstr ""
15419
15420#. type: Plain text
15421#: ../misc-utils/mcookie.1.adoc:18
15422#, no-wrap
15423msgid "*mcookie* [options]\n"
15424msgstr ""
15425
15426#. type: Plain text
15427#: ../misc-utils/mcookie.1.adoc:22
15428#, no-wrap
15429msgid ""
15430"*mcookie* generates a 128-bit random hexadecimal number for use with the X "
15431"authority system. Typical usage:\n"
15432msgstr ""
15433
15434#. type: delimited block _
15435#: ../misc-utils/mcookie.1.adoc:25
15436#, no-wrap
15437msgid "*xauth add :0 . `mcookie`*\n"
15438msgstr ""
15439
15440#. type: Plain text
15441#: ../misc-utils/mcookie.1.adoc:28
15442msgid ""
15443"The \"random\" number generated is actually the MD5 message digest of random "
15444"information coming from one of the sources *getrandom*(2) system call, "
15445"_/dev/urandom_, _/dev/random_, or the _libc pseudo-random functions_, in "
15446"this preference order. See also the option *--file*."
15447msgstr ""
15448
15449#. type: Plain text
15450#: ../misc-utils/mcookie.1.adoc:33
15451msgid ""
15452"Use this _file_ as an additional source of randomness (for example "
15453"_/dev/urandom_). When _file_ is '-', characters are read from standard "
15454"input."
15455msgstr ""
15456
15457#. type: Labeled list
15458#: ../misc-utils/mcookie.1.adoc:34
15459#, no-wrap
15460msgid "*-m*, *--max-size* _number_"
15461msgstr ""
15462
15463#. type: Plain text
15464#: ../misc-utils/mcookie.1.adoc:36
15465msgid ""
15466"Read from _file_ only this _number_ of bytes. This option is meant to be "
15467"used when reading additional randomness from a file or device."
15468msgstr ""
15469
15470#. type: Plain text
15471#: ../misc-utils/mcookie.1.adoc:38
15472msgid ""
15473"The _number_ argument may be followed by the multiplicative suffixes "
15474"KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "
15475"\"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
15476"suffixes KB=1000, MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB."
15477msgstr ""
15478
15479#. type: Plain text
15480#: ../misc-utils/mcookie.1.adoc:41
15481msgid ""
15482"Inform where randomness originated, with amount of entropy read from each "
15483"source."
15484msgstr ""
15485
15486#. type: Plain text
15487#: ../misc-utils/mcookie.1.adoc:51
15488msgid "_/dev/urandom_"
15489msgstr ""
15490
15491#. type: Plain text
15492#: ../misc-utils/mcookie.1.adoc:53
15493msgid "_/dev/random_"
15494msgstr ""
15495
15496#. type: Plain text
15497#: ../misc-utils/mcookie.1.adoc:57
15498msgid "It is assumed that none of the randomness sources will block."
15499msgstr ""
15500
15501#. type: Plain text
15502#: ../misc-utils/mcookie.1.adoc:64
15503#, no-wrap
15504msgid ""
15505"*md5sum*(1),\n"
15506"*X*(7),\n"
15507"*xauth*(1),\n"
15508"*rand*(3)\n"
15509msgstr ""
15510
15511#. type: Title =
15512#: ../misc-utils/namei.1.adoc:2
15513#, no-wrap
15514msgid "namei(1)"
15515msgstr ""
15516
15517#. type: Plain text
15518#: ../misc-utils/namei.1.adoc:12
15519msgid "namei - follow a pathname until a terminal point is found"
15520msgstr ""
15521
15522#. type: Plain text
15523#: ../misc-utils/namei.1.adoc:16
15524#, no-wrap
15525msgid "*namei* [options] _pathname_...\n"
15526msgstr ""
15527
15528#. type: Plain text
15529#: ../misc-utils/namei.1.adoc:20
15530#, no-wrap
15531msgid ""
15532"*namei* interprets its arguments as pathnames to any type of Unix file "
15533"(symlinks, files, directories, and so forth). *namei* then follows each "
15534"pathname until an endpoint is found (a file, a directory, a device node, "
15535"etc). If it finds a symbolic link, it shows the link, and starts following "
15536"it, indenting the output to show the context.\n"
15537msgstr ""
15538
15539#. type: Plain text
15540#: ../misc-utils/namei.1.adoc:22
15541msgid ""
15542"This program is useful for finding \"too many levels of symbolic links\" "
15543"problems."
15544msgstr ""
15545
15546#. type: Plain text
15547#: ../misc-utils/namei.1.adoc:24
15548msgid ""
15549"For each line of output, *namei* uses the following characters to identify "
15550"the file type found:"
15551msgstr ""
15552
15553#. type: delimited block .
15554#: ../misc-utils/namei.1.adoc:35
15555#, no-wrap
15556msgid ""
15557" f: = the pathname currently being resolved\n"
15558" d = directory\n"
15559" l = symbolic link (both the link and its contents are output)\n"
15560" s = socket\n"
15561" b = block device\n"
15562" c = character device\n"
15563" p = FIFO (named pipe)\n"
15564" - = regular file\n"
15565" ? = an error of some kind\n"
15566msgstr ""
15567
15568#. type: Plain text
15569#: ../misc-utils/namei.1.adoc:38
15570#, no-wrap
15571msgid ""
15572"*namei* prints an informative message when the maximum number of symbolic "
15573"links this system can have has been exceeded.\n"
15574msgstr ""
15575
15576#. type: Labeled list
15577#: ../misc-utils/namei.1.adoc:41
15578#, no-wrap
15579msgid "*-l*, *--long*"
15580msgstr ""
15581
15582#. type: Plain text
15583#: ../misc-utils/namei.1.adoc:43
15584msgid "Use the long listing format (same as *-m -o -v*)."
15585msgstr ""
15586
15587#. type: Labeled list
15588#: ../misc-utils/namei.1.adoc:44
15589#, no-wrap
15590msgid "*-m*, *--modes*"
15591msgstr ""
15592
15593#. type: Plain text
15594#: ../misc-utils/namei.1.adoc:46
15595msgid ""
15596"Show the mode bits of each file type in the style of *ls*(1), for example "
15597"'rwxr-xr-x'."
15598msgstr ""
15599
15600#. type: Labeled list
15601#: ../misc-utils/namei.1.adoc:47
15602#, no-wrap
15603msgid "*-n*, *--nosymlinks*"
15604msgstr ""
15605
15606#. type: Plain text
15607#: ../misc-utils/namei.1.adoc:49
15608msgid "Don't follow symlinks."
15609msgstr ""
15610
15611#. type: Labeled list
15612#: ../misc-utils/namei.1.adoc:50
15613#, no-wrap
15614msgid "*-o*, *--owners*"
15615msgstr ""
15616
15617#. type: Plain text
15618#: ../misc-utils/namei.1.adoc:52
15619msgid "Show owner and group name of each file."
15620msgstr ""
15621
15622#. type: Plain text
15623#: ../misc-utils/namei.1.adoc:55
15624msgid "Vertically align the modes and owners."
15625msgstr ""
15626
15627#. type: Labeled list
15628#: ../misc-utils/namei.1.adoc:56
15629#, no-wrap
15630msgid "*-x*, *--mountpoints*"
15631msgstr ""
15632
15633#. type: Plain text
15634#: ../misc-utils/namei.1.adoc:58
15635msgid "Show mountpoint directories with a 'D' rather than a 'd'."
15636msgstr ""
15637
15638#. type: Plain text
15639#: ../misc-utils/namei.1.adoc:68
15640msgid "To be discovered."
15641msgstr ""
15642
15643#. type: Plain text
15644#: ../misc-utils/namei.1.adoc:72
15645msgid ""
15646"The original *namei* program was written by "
15647"mailto:rogers@amadeus.wr.tek.com[Roger Southwick]."
15648msgstr ""
15649
15650#. type: Plain text
15651#: ../misc-utils/namei.1.adoc:74
15652msgid "The program was rewritten by Karel Zak mailto:kzak@redhat.com[Karel Zak]."
15653msgstr ""
15654
15655#. type: Plain text
15656#: ../misc-utils/namei.1.adoc:80
15657#, no-wrap
15658msgid ""
15659"*ls*(1),\n"
15660"*stat*(1),\n"
15661"*symlink*(7)\n"
15662msgstr ""
15663
15664#. Written by Andries E. Brouwer (aeb@cwi.nl)
15665#. Placed in the public domain
15666#. type: Title =
15667#: ../misc-utils/rename.1.adoc:4
15668#, no-wrap
15669msgid "rename(1)"
15670msgstr ""
15671
15672#. type: Plain text
15673#: ../misc-utils/rename.1.adoc:14
15674msgid "rename - rename files"
15675msgstr ""
15676
15677#. type: Plain text
15678#: ../misc-utils/rename.1.adoc:18
15679#, no-wrap
15680msgid "*rename* [options] _expression replacement file_...\n"
15681msgstr ""
15682
15683#. type: Plain text
15684#: ../misc-utils/rename.1.adoc:22
15685#, no-wrap
15686msgid ""
15687"*rename* will rename the specified files by replacing the first occurrence "
15688"of _expression_ in their name by _replacement_.\n"
15689msgstr ""
15690
15691#. type: Labeled list
15692#: ../misc-utils/rename.1.adoc:25
15693#, no-wrap
15694msgid "*-s*, *--symlink*"
15695msgstr ""
15696
15697#. type: Plain text
15698#: ../misc-utils/rename.1.adoc:27
15699msgid "Do not rename a symlink but its target."
15700msgstr ""
15701
15702#. type: Plain text
15703#: ../misc-utils/rename.1.adoc:30
15704msgid "Show which files were renamed, if any."
15705msgstr ""
15706
15707#. type: Plain text
15708#: ../misc-utils/rename.1.adoc:33
15709msgid "Do not make any changes; add *--verbose* to see what would be made."
15710msgstr ""
15711
15712#. type: Labeled list
15713#: ../misc-utils/rename.1.adoc:34
15714#, no-wrap
15715msgid "*-o*, *--no-overwrite*"
15716msgstr ""
15717
15718#. type: Plain text
15719#: ../misc-utils/rename.1.adoc:36
15720msgid ""
15721"Do not overwrite existing files. When *--symlink* is active, do not "
15722"overwrite symlinks pointing to existing targets."
15723msgstr ""
15724
15725#. type: Labeled list
15726#: ../misc-utils/rename.1.adoc:37
15727#, no-wrap
15728msgid "*-i*, *--interactive*"
15729msgstr ""
15730
15731#. type: Plain text
15732#: ../misc-utils/rename.1.adoc:39
15733msgid "Ask before overwriting existing files."
15734msgstr ""
15735
15736#. type: Plain text
15737#: ../misc-utils/rename.1.adoc:49
15738msgid ""
15739"The renaming has no safeguards by default or without any one of the options "
15740"*--no-overwrite*, *--interactive* or *--no-act*. If the user has permission "
15741"to rewrite file names, the command will perform the action without any "
15742"questions. For example, the result can be quite drastic when the command is "
15743"run as root in the _/lib_ directory. Always make a backup before running the "
15744"command, unless you truly know what you are doing."
15745msgstr ""
15746
15747#. type: Title ==
15748#: ../misc-utils/rename.1.adoc:50
15749#, no-wrap
15750msgid "INTERACTIVE MODE"
15751msgstr ""
15752
15753#. type: Plain text
15754#: ../misc-utils/rename.1.adoc:53
15755msgid ""
15756"As most standard utilities rename can be used with a terminal device (tty in "
15757"short) in canonical mode, where the line is buffered by the tty and you "
15758"press ENTER to validate the user input. If you put your tty in cbreak mode "
15759"however, rename requires only a single key press to answer the prompt. To "
15760"set cbreak mode, run for example:"
15761msgstr ""
15762
15763#. type: delimited block .
15764#: ../misc-utils/rename.1.adoc:56
15765#, no-wrap
15766msgid ""
15767"sh -c 'stty -icanon min 1; \"$0\" \"$@\"; stty icanon' rename -i from to "
15768"files\n"
15769msgstr ""
15770
15771#. type: Plain text
15772#: ../misc-utils/rename.1.adoc:62
15773msgid "all requested rename operations were successful"
15774msgstr ""
15775
15776#. type: Plain text
15777#: ../misc-utils/rename.1.adoc:65
15778msgid "all rename operations failed"
15779msgstr ""
15780
15781#. type: Plain text
15782#: ../misc-utils/rename.1.adoc:68
15783msgid "some rename operations failed"
15784msgstr ""
15785
15786#. type: Plain text
15787#: ../misc-utils/rename.1.adoc:71
15788msgid "nothing was renamed"
15789msgstr ""
15790
15791#. type: Plain text
15792#: ../misc-utils/rename.1.adoc:74
15793msgid "unanticipated error occurred"
15794msgstr ""
15795
15796#. type: Plain text
15797#: ../misc-utils/rename.1.adoc:78
15798msgid "Given the files _foo1_, ..., _foo9_, _foo10_, ..., _foo278_, the commands"
15799msgstr ""
15800
15801#. type: delimited block .
15802#: ../misc-utils/rename.1.adoc:82
15803#, no-wrap
15804msgid ""
15805"rename foo foo00 foo?\n"
15806"rename foo foo0 foo??\n"
15807msgstr ""
15808
15809#. type: Plain text
15810#: ../misc-utils/rename.1.adoc:85
15811msgid "will turn them into _foo001_, ..., _foo009_, _foo010_, ..., _foo278_. And"
15812msgstr ""
15813
15814#. type: delimited block .
15815#: ../misc-utils/rename.1.adoc:88
15816#, no-wrap
15817msgid "rename .htm .html *.htm\n"
15818msgstr ""
15819
15820#. type: Plain text
15821#: ../misc-utils/rename.1.adoc:91
15822msgid ""
15823"will fix the extension of your html files. Provide an empty string for "
15824"shortening:"
15825msgstr ""
15826
15827#. type: delimited block .
15828#: ../misc-utils/rename.1.adoc:94
15829#, no-wrap
15830msgid "rename '_with_long_name' '' file_with_long_name.*\n"
15831msgstr ""
15832
15833#. type: Plain text
15834#: ../misc-utils/rename.1.adoc:97
15835msgid "will remove the substring in the filenames."
15836msgstr ""
15837
15838#. type: Plain text
15839#: ../misc-utils/rename.1.adoc:101
15840#, no-wrap
15841msgid "*mv*(1)\n"
15842msgstr ""
15843
15844#. Copyright 2007 by Theodore Ts'o. All Rights Reserved.
15845#. This file may be copied under the terms of the GNU Public License.
15846#. type: Title =
15847#: ../misc-utils/uuidd.8.adoc:6
15848#, no-wrap
15849msgid "uuidd(8)"
15850msgstr ""
15851
15852#. type: Plain text
15853#: ../misc-utils/uuidd.8.adoc:16
15854msgid "uuidd - UUID generation daemon"
15855msgstr ""
15856
15857#. type: Plain text
15858#: ../misc-utils/uuidd.8.adoc:20
15859#, no-wrap
15860msgid "*uuidd* [options]\n"
15861msgstr ""
15862
15863#. type: Plain text
15864#: ../misc-utils/uuidd.8.adoc:24
15865msgid ""
15866"The *uuidd* daemon is used by the UUID library to generate universally "
15867"unique identifiers (UUIDs), especially time-based UUIDs, in a secure and "
15868"guaranteed-unique fashion, even in the face of large numbers of threads "
15869"running on different CPUs trying to grab UUIDs."
15870msgstr ""
15871
15872#. type: Labeled list
15873#: ../misc-utils/uuidd.8.adoc:27 ../sys-utils/ldattach.8.adoc:88
15874#, no-wrap
15875msgid "*-d*, *--debug*"
15876msgstr ""
15877
15878#. type: Plain text
15879#: ../misc-utils/uuidd.8.adoc:29
15880msgid "Run uuidd in debugging mode. This prevents uuidd from running as a daemon."
15881msgstr ""
15882
15883#. type: Labeled list
b81d5971 15884#: ../misc-utils/uuidd.8.adoc:30 ../sys-utils/flock.1.adoc:62
36e96905
MB
15885#: ../sys-utils/nsenter.1.adoc:121
15886#, no-wrap
15887msgid "*-F*, *--no-fork*"
15888msgstr ""
15889
15890#. type: Plain text
15891#: ../misc-utils/uuidd.8.adoc:32
15892msgid "Do not daemonize using a double-fork."
15893msgstr ""
15894
15895#. type: Labeled list
15896#: ../misc-utils/uuidd.8.adoc:33
15897#, no-wrap
15898msgid "*-k*, *--kill*"
15899msgstr ""
15900
15901#. type: Plain text
15902#: ../misc-utils/uuidd.8.adoc:35
15903msgid "If currently a uuidd daemon is running, kill it."
15904msgstr ""
15905
15906#. type: Labeled list
15907#: ../misc-utils/uuidd.8.adoc:36
15908#, no-wrap
15909msgid "*-n*, *--uuids* _number_"
15910msgstr ""
15911
15912#. type: Plain text
15913#: ../misc-utils/uuidd.8.adoc:38
15914msgid ""
15915"When issuing a test request to a running *uuidd*, request a bulk response of "
15916"_number_ UUIDs."
15917msgstr ""
15918
15919#. type: Labeled list
15920#: ../misc-utils/uuidd.8.adoc:39
15921#, no-wrap
15922msgid "*-P*, *--no-pid*"
15923msgstr ""
15924
15925#. type: Plain text
15926#: ../misc-utils/uuidd.8.adoc:41
15927msgid "Do not create a pid file."
15928msgstr ""
15929
15930#. type: Labeled list
15931#: ../misc-utils/uuidd.8.adoc:42
15932#, no-wrap
15933msgid "*-p*, *--pid* _path_"
15934msgstr ""
15935
15936#. TRANSLATORS: Don't translate _{runstatedir}_.
15937#. type: Plain text
15938#: ../misc-utils/uuidd.8.adoc:45
15939msgid ""
15940"Specify the pathname where the pid file should be written. By default, the "
15941"pid file is written to _{runstatedir}/uuidd/uuidd.pid_."
15942msgstr ""
15943
15944#. type: Plain text
15945#: ../misc-utils/uuidd.8.adoc:48
15946msgid "Suppress some failure messages."
15947msgstr ""
15948
15949#. type: Labeled list
15950#: ../misc-utils/uuidd.8.adoc:49 ../misc-utils/uuidgen.1.adoc:31
15951#, no-wrap
15952msgid "*-r*, *--random*"
15953msgstr ""
15954
15955#. type: Plain text
15956#: ../misc-utils/uuidd.8.adoc:51
15957msgid ""
15958"Test uuidd by trying to connect to a running uuidd daemon and request it to "
15959"return a random-based UUID."
15960msgstr ""
15961
15962#. type: Labeled list
15963#: ../misc-utils/uuidd.8.adoc:52
15964#, no-wrap
15965msgid "*-S*, *--socket-activation*"
15966msgstr ""
15967
15968#. type: Plain text
15969#: ../misc-utils/uuidd.8.adoc:54
15970msgid ""
15971"Do not create a socket but instead expect it to be provided by the calling "
15972"process. This implies *--no-fork* and *--no-pid*. This option is intended to "
15973"be used only with *systemd*(1). It needs to be enabled with a configure "
15974"option."
15975msgstr ""
15976
15977#. type: Labeled list
15978#: ../misc-utils/uuidd.8.adoc:55
15979#, no-wrap
15980msgid "*-s*, *--socket* _path_"
15981msgstr ""
15982
15983#. TRANSLATORS: Don't translate _{runstatedir}_.
15984#. type: Plain text
15985#: ../misc-utils/uuidd.8.adoc:58
15986msgid ""
15987"Make uuidd use this pathname for the unix-domain socket. By default, the "
15988"pathname used is _{runstatedir}/uuidd/request_. This option is primarily for "
15989"debugging purposes, since the pathname is hard-coded in the *libuuid* "
15990"library."
15991msgstr ""
15992
15993#. type: Labeled list
15994#: ../misc-utils/uuidd.8.adoc:59
15995#, no-wrap
15996msgid "*-T*, *--timeout* _number_"
15997msgstr ""
15998
15999#. type: Plain text
16000#: ../misc-utils/uuidd.8.adoc:61
16001msgid "Make *uuidd* exit after _number_ seconds of inactivity."
16002msgstr ""
16003
16004#. type: Labeled list
16005#: ../misc-utils/uuidd.8.adoc:62 ../misc-utils/uuidgen.1.adoc:34
16006#: ../sys-utils/ipcs.1.adoc:63 ../sys-utils/lsipc.1.adoc:78
16007#, no-wrap
16008msgid "*-t*, *--time*"
16009msgstr ""
16010
16011#. type: Plain text
16012#: ../misc-utils/uuidd.8.adoc:64
16013msgid ""
16014"Test *uuidd* by trying to connect to a running uuidd daemon and request it "
16015"to return a time-based UUID."
16016msgstr ""
16017
16018#. type: Plain text
16019#: ../misc-utils/uuidd.8.adoc:67
16020msgid "Output version information and exit."
16021msgstr ""
16022
16023#. type: Plain text
16024#: ../misc-utils/uuidd.8.adoc:70
16025msgid "Display help screen and exit."
16026msgstr ""
16027
16028#. type: Plain text
16029#: ../misc-utils/uuidd.8.adoc:74
16030msgid "Start up a daemon, print 42 random keys, and then stop the daemon:"
16031msgstr ""
16032
16033#. type: delimited block .
16034#: ../misc-utils/uuidd.8.adoc:79
16035#, no-wrap
16036msgid ""
16037"uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket\n"
16038"uuidd -d -r -n 42 -s /tmp/uuidd.socket\n"
16039"uuidd -d -k -s /tmp/uuidd.socket\n"
16040msgstr ""
16041
16042#. type: Plain text
16043#: ../misc-utils/uuidd.8.adoc:84
16044msgid "The *uuidd* daemon was written by mailto:tytso@mit.edu[Theodore Ts'o]."
16045msgstr ""
16046
16047#. type: Plain text
16048#: ../misc-utils/uuidd.8.adoc:89
16049#, no-wrap
16050msgid ""
16051"*uuid*(3),\n"
16052"*uuidgen*(1)\n"
16053msgstr ""
16054
16055#. Copyright 1999 Andreas Dilger (adilger@enel.ucalgary.ca)
16056#. This file may be copied under the terms of the GNU Public License.
16057#. type: Title =
16058#: ../misc-utils/uuidgen.1.adoc:6
16059#, no-wrap
16060msgid "uuidgen(1)"
16061msgstr ""
16062
16063#. type: Plain text
16064#: ../misc-utils/uuidgen.1.adoc:16
16065msgid "uuidgen - create a new UUID value"
16066msgstr ""
16067
16068#. type: Plain text
16069#: ../misc-utils/uuidgen.1.adoc:20
16070#, no-wrap
16071msgid "*uuidgen* [options]\n"
16072msgstr ""
16073
16074#. type: Plain text
16075#: ../misc-utils/uuidgen.1.adoc:24
16076msgid ""
16077"The *uuidgen* program creates (and prints) a new universally unique "
16078"identifier (UUID) using the *libuuid*(3) library. The new UUID can "
16079"reasonably be considered unique among all UUIDs created on the local system, "
16080"and among UUIDs created on other systems in the past and in the future."
16081msgstr ""
16082
16083#. type: Plain text
16084#: ../misc-utils/uuidgen.1.adoc:26
16085msgid ""
16086"There are three types of UUIDs which *uuidgen* can generate: time-based "
16087"UUIDs, random-based UUIDs, and hash-based UUIDs. By default *uuidgen* will "
16088"generate a random-based UUID if a high-quality random number generator is "
16089"present. Otherwise, it will choose a time-based UUID. It is possible to "
16090"force the generation of one of these first two UUID types by using the "
16091"*--random* or *--time* options."
16092msgstr ""
16093
16094#. type: Plain text
16095#: ../misc-utils/uuidgen.1.adoc:28
16096msgid ""
16097"The third type of UUID is generated with the *--md5* or *--sha1* options, "
16098"followed by *--namespace* _namespace_ and *--name* _name_. The _namespace_ "
16099"may either be a well-known UUID, or else an alias to one of the well-known "
16100"UUIDs defined in RFC 4122, that is *@dns*, *@url*, *@oid*, or *@x500*. The "
16101"_name_ is an arbitrary string value. The generated UUID is the digest of the "
16102"concatenation of the namespace UUID and the name value, hashed with the MD5 "
16103"or SHA1 algorithms. It is, therefore, a predictable value which may be "
16104"useful when UUIDs are being used as handles or nonces for more complex "
16105"values or values which shouldn't be disclosed directly. See the RFC for more "
16106"information."
16107msgstr ""
16108
16109#. type: Plain text
16110#: ../misc-utils/uuidgen.1.adoc:33
16111msgid ""
16112"Generate a random-based UUID. This method creates a UUID consisting mostly "
16113"of random bits. It requires that the operating system has a high quality "
16114"random number generator, such as _/dev/random_."
16115msgstr ""
16116
16117#. type: Plain text
16118#: ../misc-utils/uuidgen.1.adoc:36
16119msgid ""
16120"Generate a time-based UUID. This method creates a UUID based on the system "
16121"clock plus the system's ethernet hardware address, if present."
16122msgstr ""
16123
16124#. type: Labeled list
16125#: ../misc-utils/uuidgen.1.adoc:43
16126#, no-wrap
16127msgid "*-m*, *--md5*"
16128msgstr ""
16129
16130#. type: Plain text
16131#: ../misc-utils/uuidgen.1.adoc:45
16132msgid "Use MD5 as the hash algorithm."
16133msgstr ""
16134
16135#. type: Labeled list
16136#: ../misc-utils/uuidgen.1.adoc:46
16137#, no-wrap
16138msgid "*-s*, *--sha1*"
16139msgstr ""
16140
16141#. type: Plain text
16142#: ../misc-utils/uuidgen.1.adoc:48
16143msgid "Use SHA1 as the hash algorithm."
16144msgstr ""
16145
16146#. type: Labeled list
16147#: ../misc-utils/uuidgen.1.adoc:49
16148#, no-wrap
16149msgid "*-n*, *--namespace* _namespace_"
16150msgstr ""
16151
16152#. type: Plain text
16153#: ../misc-utils/uuidgen.1.adoc:51
16154msgid ""
16155"Generate the hash with the _namespace_ prefix. The _namespace_ is UUID, or "
16156"'@ns' where \"ns\" is well-known predefined UUID addressed by namespace name "
16157"(see above)."
16158msgstr ""
16159
16160#. type: Labeled list
16161#: ../misc-utils/uuidgen.1.adoc:52
16162#, no-wrap
16163msgid "*-N*, *--name* _name_"
16164msgstr ""
16165
16166#. type: Plain text
16167#: ../misc-utils/uuidgen.1.adoc:54
16168msgid "Generate the hash of the _name_."
16169msgstr ""
16170
16171#. type: Labeled list
16172#: ../misc-utils/uuidgen.1.adoc:55 ../sys-utils/lscpu.1.adoc:134
16173#, no-wrap
16174msgid "*-x*, *--hex*"
16175msgstr ""
16176
16177#. type: Plain text
16178#: ../misc-utils/uuidgen.1.adoc:57
16179msgid "Interpret name _name_ as a hexadecimal string."
16180msgstr ""
16181
16182#. type: Plain text
16183#: ../misc-utils/uuidgen.1.adoc:61
16184msgid "OSF DCE 1.1"
16185msgstr ""
16186
16187#. type: Plain text
16188#: ../misc-utils/uuidgen.1.adoc:65
16189msgid "uuidgen --sha1 --namespace @dns --name \"www.example.com\""
16190msgstr ""
16191
16192#. type: Plain text
16193#: ../misc-utils/uuidgen.1.adoc:69
16194#, no-wrap
16195msgid "*uuidgen* was written by Andreas Dilger for *libuuid*(3).\n"
16196msgstr ""
16197
16198#. type: Plain text
16199#: ../misc-utils/uuidgen.1.adoc:74
16200#, no-wrap
16201msgid ""
16202"*libuuid*(3),\n"
16203"link:https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
16204msgstr ""
16205
16206#. Copyright (c) 2017 Sami Kerola
16207#. The 3-Clause BSD License
16208#. type: Title =
16209#: ../misc-utils/uuidparse.1.adoc:4
16210#, no-wrap
16211msgid "uuidparse(1)"
16212msgstr ""
16213
16214#. type: Plain text
16215#: ../misc-utils/uuidparse.1.adoc:14
16216msgid "uuidparse - a utility to parse unique identifiers"
16217msgstr ""
16218
16219#. type: Plain text
16220#: ../misc-utils/uuidparse.1.adoc:18
16221#, no-wrap
16222msgid "*uuidparse* [options] _uuid_\n"
16223msgstr ""
16224
16225#. type: Plain text
16226#: ../misc-utils/uuidparse.1.adoc:22
16227msgid ""
16228"This command will parse unique identifier inputs from either command line "
16229"arguments or standard input. The inputs are white-space separated."
16230msgstr ""
16231
16232#. type: Title ===
16233#: ../misc-utils/uuidparse.1.adoc:25
16234#, no-wrap
16235msgid "Variants"
16236msgstr ""
16237
16238#. type: Table
16239#: ../misc-utils/uuidparse.1.adoc:33
16240#, no-wrap
16241msgid ""
16242"|NCS |Network Computing System identifier. These were the original UUIDs.\n"
16243"|DCE |The Open Software Foundation's (OSF) Distributed Computing Environment "
16244"UUIDs.\n"
16245"|Microsoft |Microsoft Windows platform globally unique identifier (GUID).\n"
16246"|other |Unknown variant. Usually invalid input data.\n"
16247msgstr ""
16248
16249#. type: Title ===
16250#: ../misc-utils/uuidparse.1.adoc:35
16251#, no-wrap
16252msgid "Types"
16253msgstr ""
16254
16255#. type: Table
16256#: ../misc-utils/uuidparse.1.adoc:46
16257#, no-wrap
16258msgid ""
16259"|nil |Special type for zero in type file.\n"
16260"|time-based |The DCE time based.\n"
16261"|DCE |The DCE time and MAC Address.\n"
16262"|name-based |RFC 4122 md5sum hash.\n"
16263"|random |RFC 4122 random.\n"
16264"|sha1-based |RFC 4122 sha-1 hash.\n"
16265"|unknown |Unknown type. Usually invalid input data.\n"
16266msgstr ""
16267
16268#. type: Labeled list
16269#: ../misc-utils/uuidparse.1.adoc:56 ../sys-utils/rfkill.8.adoc:33
16270#, no-wrap
16271msgid "*-o*, *--output*"
16272msgstr ""
16273
16274#. type: Plain text
16275#: ../misc-utils/uuidparse.1.adoc:71
16276msgid "mailto:kerolasa@iki.fi[Sami Kerola]"
16277msgstr ""
16278
16279#. type: Plain text
16280#: ../misc-utils/uuidparse.1.adoc:77
16281#, no-wrap
16282msgid ""
16283"*uuidgen*(1),\n"
16284"*libuuid*(3),\n"
16285"https://tools.ietf.org/html/rfc4122[RFC 4122]\n"
16286msgstr ""
16287
16288#. Copyright (c) 1980, 1990 The Regents of the University of California.
16289#. All rights reserved.
16290#
16291#. Redistribution and use in source and binary forms, with or without
16292#. modification, are permitted provided that the following conditions
16293#. are met:
16294#. 1. Redistributions of source code must retain the above copyright
16295#. notice, this list of conditions and the following disclaimer.
16296#. 2. Redistributions in binary form must reproduce the above copyright
16297#. notice, this list of conditions and the following disclaimer in the
16298#. documentation and/or other materials provided with the distribution.
16299#. 3. All advertising materials mentioning features or use of this software
16300#. must display the following acknowledgement:
16301#. This product includes software developed by the University of
16302#. California, Berkeley and its contributors.
16303#. 4. Neither the name of the University nor the names of its contributors
16304#. may be used to endorse or promote products derived from this software
16305#. without specific prior written permission.
16306#
16307#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
16308#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16309#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16310#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
16311#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
16312#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
16313#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
16314#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
16315#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
16316#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
16317#. SUCH DAMAGE.
16318#
16319#. @(#)whereis.1 from UCB 4.2
16320#. type: Title =
16321#: ../misc-utils/whereis.1.adoc:36
16322#, no-wrap
16323msgid "whereis(1)"
16324msgstr ""
16325
16326#. type: Plain text
16327#: ../misc-utils/whereis.1.adoc:46
16328msgid "whereis - locate the binary, source, and manual page files for a command"
16329msgstr ""
16330
16331#. type: Plain text
16332#: ../misc-utils/whereis.1.adoc:50
16333#, no-wrap
16334msgid "*whereis* [options] [*-BMS* _directory_... *-f*] _name_...\n"
16335msgstr ""
16336
16337#. type: Plain text
16338#: ../misc-utils/whereis.1.adoc:54
16339#, no-wrap
16340msgid ""
16341"*whereis* locates the binary, source and manual files for the specified "
16342"command names. The supplied names are first stripped of leading pathname "
16343"components. Prefixes of *s.* resulting from use of source code control are "
16344"also dealt with. *whereis* then attempts to locate the desired program in "
16345"the standard Linux places, and in the places specified by *$PATH* and "
16346"*$MANPATH*.\n"
16347msgstr ""
16348
16349#. type: Plain text
16350#: ../misc-utils/whereis.1.adoc:56
16351msgid ""
16352"The search restrictions (options *-b*, *-m* and *-s*) are cumulative and "
16353"apply to the subsequent _name_ patterns on the command line. Any new search "
16354"restriction resets the search mask. For example,"
16355msgstr ""
16356
16357#. type: delimited block _
16358#: ../misc-utils/whereis.1.adoc:59
16359#, no-wrap
16360msgid "*whereis -bm ls tr -m gcc*\n"
16361msgstr ""
16362
16363#. type: Plain text
16364#: ../misc-utils/whereis.1.adoc:62
16365msgid ""
16366"searches for \"ls\" and \"tr\" binaries and man pages, and for \"gcc\" man "
16367"pages only."
16368msgstr ""
16369
16370#. type: Plain text
16371#: ../misc-utils/whereis.1.adoc:64
16372msgid ""
16373"The options *-B*, *-M* and *-S* reset search paths for the subsequent _name_ "
16374"patterns. For example,"
16375msgstr ""
16376
16377#. type: delimited block _
16378#: ../misc-utils/whereis.1.adoc:67
16379#, no-wrap
16380msgid "*whereis -m ls -M /usr/share/man/man1 -f cal*\n"
16381msgstr ""
16382
16383#. type: Plain text
16384#: ../misc-utils/whereis.1.adoc:70
16385msgid ""
16386"searches for \"*ls*\" man pages in all default paths, but for \"cal\" in the "
16387"_/usr/share/man/man1_ directory only."
16388msgstr ""
16389
16390#. type: Labeled list
16391#: ../misc-utils/whereis.1.adoc:73
16392#, no-wrap
16393msgid "*-b*"
16394msgstr ""
16395
16396#. type: Plain text
16397#: ../misc-utils/whereis.1.adoc:75
16398msgid "Search for binaries."
16399msgstr ""
16400
16401#. type: Labeled list
16402#: ../misc-utils/whereis.1.adoc:76 ../schedutils/uclampset.1.adoc:64
16403#, no-wrap
16404msgid "*-m*"
16405msgstr ""
16406
16407#. type: Plain text
16408#: ../misc-utils/whereis.1.adoc:78
16409msgid "Search for manuals."
16410msgstr ""
16411
16412#. type: Plain text
16413#: ../misc-utils/whereis.1.adoc:81
16414msgid "Search for sources."
16415msgstr ""
16416
16417#. type: Labeled list
16418#: ../misc-utils/whereis.1.adoc:82
16419#, no-wrap
16420msgid "*-u*"
16421msgstr ""
16422
16423#. type: Plain text
16424#: ../misc-utils/whereis.1.adoc:84
16425msgid ""
16426"Only show the command names that have unusual entries. A command is said to "
16427"be unusual if it does not have just one entry of each explicitly requested "
16428"type. Thus '*whereis -m -u **' asks for those files in the current directory "
16429"which have no documentation file, or more than one."
16430msgstr ""
16431
16432#. type: Labeled list
16433#: ../misc-utils/whereis.1.adoc:85
16434#, no-wrap
16435msgid "*-B* _list_"
16436msgstr ""
16437
16438#. type: Plain text
16439#: ../misc-utils/whereis.1.adoc:87
16440msgid ""
16441"Limit the places where *whereis* searches for binaries, by a "
16442"whitespace-separated list of directories."
16443msgstr ""
16444
16445#. type: Labeled list
16446#: ../misc-utils/whereis.1.adoc:88
16447#, no-wrap
16448msgid "*-M* _list_"
16449msgstr ""
16450
16451#. type: Plain text
16452#: ../misc-utils/whereis.1.adoc:90
16453msgid ""
16454"Limit the places where *whereis* searches for manuals and documentation in "
16455"Info format, by a whitespace-separated list of directories."
16456msgstr ""
16457
16458#. type: Labeled list
16459#: ../misc-utils/whereis.1.adoc:91
16460#, no-wrap
16461msgid "*-S* _list_"
16462msgstr ""
16463
16464#. type: Plain text
16465#: ../misc-utils/whereis.1.adoc:93
16466msgid ""
16467"Limit the places where *whereis* searches for sources, by a "
16468"whitespace-separated list of directories."
16469msgstr ""
16470
16471#. type: Plain text
16472#: ../misc-utils/whereis.1.adoc:96
16473msgid ""
16474"Terminates the directory list and signals the start of filenames. It _must_ "
16475"be used when any of the *-B*, *-M*, or *-S* options is used."
16476msgstr ""
16477
16478#. type: Plain text
16479#: ../misc-utils/whereis.1.adoc:99
16480msgid ""
16481"Output the list of effective lookup paths that *whereis* is using. When none "
16482"of *-B*, *-M*, or *-S* is specified, the option will output the hard-coded "
16483"paths that the command was able to find on the system."
16484msgstr ""
16485
16486#. type: Title ==
16487#: ../misc-utils/whereis.1.adoc:106
16488#, no-wrap
16489msgid "FILE SEARCH PATHS"
16490msgstr ""
16491
16492#. type: Plain text
16493#: ../misc-utils/whereis.1.adoc:109
16494msgid ""
16495"By default *whereis* tries to find files from hard-coded paths, which are "
16496"defined with glob patterns. The command attempts to use the contents of "
16497"*$PATH* and *$MANPATH* environment variables as default search path. The "
16498"easiest way to know what paths are in use is to add the *-l* listing "
16499"option. Effects of the *-B*, *-M*, and *-S* are displayed with *-l*."
16500msgstr ""
16501
16502#. type: Labeled list
16503#: ../misc-utils/whereis.1.adoc:112
16504#, no-wrap
16505msgid "WHEREIS_DEBUG=all"
16506msgstr ""
16507
16508#. type: Plain text
16509#: ../misc-utils/whereis.1.adoc:118
16510msgid ""
16511"To find all files in _/usr/bin_ which are not documented in _/usr/man/man1_ "
16512"or have no source in _/usr/src_:"
16513msgstr ""
16514
16515#. type: Plain text
16516#: ../misc-utils/whereis.1.adoc:120
16517#, no-wrap
16518msgid "*cd /usr/bin* *whereis -u -ms -M /usr/man/man1 -S /usr/src -f **\n"
16519msgstr ""
16520
16521#. Copyright 2009 by Karel Zak. All Rights Reserved.
16522#. This file may be copied under the terms of the GNU Public License.
16523#. type: Title =
16524#: ../misc-utils/wipefs.8.adoc:4
16525#, no-wrap
16526msgid "wipefs(8)"
16527msgstr ""
16528
16529#. type: Plain text
16530#: ../misc-utils/wipefs.8.adoc:14
16531msgid "wipefs - wipe a signature from a device"
16532msgstr ""
16533
16534#. type: Plain text
16535#: ../misc-utils/wipefs.8.adoc:18
16536#, no-wrap
16537msgid "*wipefs* [options] _device_...\n"
16538msgstr ""
16539
16540#. type: Plain text
16541#: ../misc-utils/wipefs.8.adoc:20
16542#, no-wrap
16543msgid "*wipefs* [*--backup*] *-o* _offset device_...\n"
16544msgstr ""
16545
16546#. type: Plain text
16547#: ../misc-utils/wipefs.8.adoc:22
16548#, no-wrap
16549msgid "*wipefs* [*--backup*] *-a* _device_...\n"
16550msgstr ""
16551
16552#. type: Plain text
16553#: ../misc-utils/wipefs.8.adoc:27
16554#, no-wrap
16555msgid ""
16556"*wipefs* can erase filesystem, raid or partition-table signatures (magic "
16557"strings) from the specified _device_ to make the signatures invisible for "
16558"libblkid. *wipefs* does not erase the filesystem itself nor any other data "
16559"from the device.\n"
16560msgstr ""
16561
16562#. type: Plain text
16563#: ../misc-utils/wipefs.8.adoc:29
16564msgid ""
16565"When used without any options, *wipefs* lists all visible filesystems and "
16566"the offsets of their basic signatures. The default output is subject to "
16567"change. So whenever possible, you should avoid using default outputs in your "
16568"scripts. Always explicitly define expected columns by using *--output* "
16569"_columns-list_ in environments where a stable output is required."
16570msgstr ""
16571
16572#. type: Plain text
16573#: ../misc-utils/wipefs.8.adoc:31
16574#, no-wrap
16575msgid ""
16576"*wipefs* calls the BLKRRPART ioctl when it has erased a partition-table "
16577"signature to inform the kernel about the change. The ioctl is called as the "
16578"last step and when all specified signatures from all specified devices are "
16579"already erased. This feature can be used to wipe content on partitions "
16580"devices as well as partition table on a disk device, for example by *wipefs "
16581"-a /dev/sdc1 /dev/sdc2 /dev/sdc*.\n"
16582msgstr ""
16583
16584#. type: Plain text
16585#: ../misc-utils/wipefs.8.adoc:33
16586msgid ""
16587"Note that some filesystems and some partition tables store more magic "
16588"strings on the device (e.g., FAT, ZFS, GPT). The *wipefs* command (since "
16589"v2.31) lists all the offset where a magic strings have been detected."
16590msgstr ""
16591
16592#. type: Plain text
16593#: ../misc-utils/wipefs.8.adoc:35
16594msgid ""
16595"When option *-a* is used, all magic strings that are visible for "
16596"*libblkid*(3) are erased. In this case the *wipefs* scans the device again "
16597"after each modification (erase) until no magic string is found."
16598msgstr ""
16599
16600#. type: Plain text
16601#: ../misc-utils/wipefs.8.adoc:37
16602msgid ""
16603"Note that by default *wipefs* does not erase nested partition tables on "
16604"non-whole disk devices. For this the option *--force* is required."
16605msgstr ""
16606
16607#. type: Plain text
16608#: ../misc-utils/wipefs.8.adoc:42
16609msgid ""
16610"Erase all available signatures. The set of erased signatures can be "
16611"restricted with the *-t* option."
16612msgstr ""
16613
16614#. type: Plain text
16615#: ../misc-utils/wipefs.8.adoc:45
16616msgid ""
16617"Create a signature backup to the file "
16618"_$HOME/wipefs-<devname>-<offset>.bak_. For more details see the *EXAMPLE* "
16619"section."
16620msgstr ""
16621
16622#. type: Plain text
16623#: ../misc-utils/wipefs.8.adoc:48
16624msgid ""
16625"Force erasure, even if the filesystem is mounted. This is required in order "
16626"to erase a partition-table signature on a block device."
16627msgstr ""
16628
16629#. type: Labeled list
16630#: ../misc-utils/wipefs.8.adoc:58
16631#, no-wrap
16632msgid "*-i*, *--noheadings*"
16633msgstr ""
16634
16635#. type: Labeled list
16636#: ../misc-utils/wipefs.8.adoc:61
16637#, no-wrap
16638msgid "*-O*, *--output* _list_"
16639msgstr ""
16640
16641#. type: Plain text
16642#: ../misc-utils/wipefs.8.adoc:66
16643msgid "Causes everything to be done except for the *write*(2) call."
16644msgstr ""
16645
16646#. type: Labeled list
16647#: ../misc-utils/wipefs.8.adoc:67 ../sys-utils/blkdiscard.8.adoc:34
16648#: ../sys-utils/fallocate.1.adoc:56 ../sys-utils/losetup.8.adoc:74
16649#, no-wrap
16650msgid "*-o*, *--offset* _offset_"
16651msgstr ""
16652
16653#. type: Plain text
16654#: ../misc-utils/wipefs.8.adoc:69
16655msgid ""
16656"Specify the location (in bytes) of the signature which should be erased from "
16657"the device. The _offset_ number may include a \"0x\" prefix; then the number "
16658"will be interpreted as a hex value. It is possible to specify multiple *-o* "
16659"options."
16660msgstr ""
16661
16662#. type: Plain text
16663#: ../misc-utils/wipefs.8.adoc:71
16664msgid ""
16665"The _offset_ argument may be followed by the multiplicative suffixes KiB "
16666"(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
16667"(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
16668"the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
16669"and YB."
16670msgstr ""
16671
16672#. type: Labeled list
16673#: ../misc-utils/wipefs.8.adoc:72
16674#, no-wrap
16675msgid "*-p*, *--parsable*"
16676msgstr ""
16677
16678#. type: Plain text
16679#: ../misc-utils/wipefs.8.adoc:74
16680msgid ""
16681"Print out in parsable instead of printable format. Encode all potentially "
16682"unsafe characters of a string to the corresponding hex value prefixed by "
16683"'\\x'."
16684msgstr ""
16685
16686#. type: Plain text
16687#: ../misc-utils/wipefs.8.adoc:77
16688msgid "Suppress any messages after a successful signature wipe."
16689msgstr ""
16690
16691#. type: Plain text
16692#: ../misc-utils/wipefs.8.adoc:80
16693msgid ""
16694"Limit the set of printed or erased signatures. More than one type may be "
16695"specified in a comma-separated list. The list or individual types can be "
16696"prefixed with 'no' to specify the types on which no action should be "
16697"taken. For more details see *mount*(8)."
16698msgstr ""
16699
16700#. type: Plain text
16701#: ../misc-utils/wipefs.8.adoc:88
16702msgid "enables *libblkid*(3) debug output."
16703msgstr ""
16704
16705#. type: Labeled list
16706#: ../misc-utils/wipefs.8.adoc:94
16707#, no-wrap
16708msgid "*wipefs /dev/sda**"
16709msgstr ""
16710
16711#. type: Plain text
16712#: ../misc-utils/wipefs.8.adoc:96
16713msgid "Prints information about sda and all partitions on sda."
16714msgstr ""
16715
16716#. type: Labeled list
16717#: ../misc-utils/wipefs.8.adoc:97
16718#, no-wrap
16719msgid "*wipefs --all --backup /dev/sdb*"
16720msgstr ""
16721
16722#. type: Plain text
16723#: ../misc-utils/wipefs.8.adoc:99
16724msgid ""
16725"Erases all signatures from the device _/dev/sdb_ and creates a signature "
16726"backup file _~/wipefs-sdb-<offset>.bak_ for each signature."
16727msgstr ""
16728
16729#. type: Labeled list
16730#: ../misc-utils/wipefs.8.adoc:100
16731#, no-wrap
16732msgid ""
16733"*dd if=~/wipefs-sdb-0x00000438.bak of=/dev/sdb seek=$((0x00000438)) bs=1 "
16734"conv=notrunc*"
16735msgstr ""
16736
16737#. type: Plain text
16738#: ../misc-utils/wipefs.8.adoc:102
16739msgid ""
16740"Restores an ext2 signature from the backup file "
16741"_~/wipefs-sdb-0x00000438.bak_."
16742msgstr ""
16743
16744#. type: Plain text
16745#: ../misc-utils/wipefs.8.adoc:111
16746#, no-wrap
16747msgid ""
16748"*blkid*(8),\n"
16749"*findfs*(8)\n"
16750msgstr ""
16751
16752#. chrt(1) manpage
16753#
16754#. Copyright (C) 2004 Robert Love
16755#. Copyright (C) 2015 Karel Zak <kzak@redhat.com>
16756#
16757#. This is free documentation; you can redistribute it and/or
16758#. modify it under the terms of the GNU General Public License,
16759#. version 2, as published by the Free Software Foundation.
16760#
16761#. The GNU General Public License's references to "object code"
16762#. and "executables" are to be interpreted as the output of any
16763#. document formatting or typesetting system, including
16764#. intermediate and printed output.
16765#
16766#. This manual is distributed in the hope that it will be useful,
16767#. but WITHOUT ANY WARRANTY; without even the implied warranty of
16768#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16769#. GNU General Public License for more details.
16770#
16771#. You should have received a copy of the GNU General Public License along
16772#. with this program; if not, write to the Free Software Foundation, Inc.,
16773#. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
16774#. type: Title =
16775#: ../schedutils/chrt.1.adoc:26
16776#, no-wrap
16777msgid "chrt(1)"
16778msgstr ""
16779
16780#. type: Plain text
16781#: ../schedutils/chrt.1.adoc:37
16782msgid "chrt - manipulate the real-time attributes of a process"
16783msgstr ""
16784
16785#. type: Plain text
16786#: ../schedutils/chrt.1.adoc:41
16787#, no-wrap
16788msgid "*chrt* [options] _priority command argument_ ...\n"
16789msgstr ""
16790
16791#. type: Plain text
16792#: ../schedutils/chrt.1.adoc:43
16793#, no-wrap
16794msgid "*chrt* [options] *-p* [_priority_] _PID_\n"
16795msgstr ""
16796
16797#. type: Plain text
16798#: ../schedutils/chrt.1.adoc:47
16799#, no-wrap
16800msgid ""
16801"*chrt* sets or retrieves the real-time scheduling attributes of an existing "
16802"_PID_, or runs _command_ with the given attributes.\n"
16803msgstr ""
16804
16805#. type: Title ==
16806#: ../schedutils/chrt.1.adoc:48
16807#, no-wrap
16808msgid "POLICIES"
16809msgstr ""
16810
16811#. type: Labeled list
16812#: ../schedutils/chrt.1.adoc:50
16813#, no-wrap
16814msgid "*-o*, *--other*"
16815msgstr ""
16816
16817#. type: Plain text
16818#: ../schedutils/chrt.1.adoc:52
16819msgid ""
16820"Set scheduling policy to *SCHED_OTHER* (time-sharing scheduling). This is "
16821"the default Linux scheduling policy."
16822msgstr ""
16823
16824#. type: Labeled list
16825#: ../schedutils/chrt.1.adoc:53
16826#, no-wrap
16827msgid "*-f*, *--fifo*"
16828msgstr ""
16829
16830#. type: Plain text
16831#: ../schedutils/chrt.1.adoc:55
16832msgid "Set scheduling policy to *SCHED_FIFO* (first in-first out)."
16833msgstr ""
16834
16835#. type: Labeled list
16836#: ../schedutils/chrt.1.adoc:56
16837#, no-wrap
16838msgid "*-r*, *--rr*"
16839msgstr ""
16840
16841#. type: Plain text
16842#: ../schedutils/chrt.1.adoc:58
16843msgid ""
16844"Set scheduling policy to *SCHED_RR* (round-robin scheduling). When no policy "
16845"is defined, the *SCHED_RR* is used as the default."
16846msgstr ""
16847
16848#. type: Labeled list
16849#: ../schedutils/chrt.1.adoc:59
16850#, no-wrap
16851msgid "*-b*, *--batch*"
16852msgstr ""
16853
16854#. type: Plain text
16855#: ../schedutils/chrt.1.adoc:61
16856msgid ""
16857"Set scheduling policy to *SCHED_BATCH* (scheduling batch "
16858"processes). Linux-specific, supported since 2.6.16. The priority argument "
16859"has to be set to zero."
16860msgstr ""
16861
16862#. type: Labeled list
16863#: ../schedutils/chrt.1.adoc:62
16864#, no-wrap
16865msgid "*-i*, *--idle*"
16866msgstr ""
16867
16868#. type: Plain text
16869#: ../schedutils/chrt.1.adoc:64
16870msgid ""
16871"Set scheduling policy to *SCHED_IDLE* (scheduling very low priority "
16872"jobs). Linux-specific, supported since 2.6.23. The priority argument has to "
16873"be set to zero."
16874msgstr ""
16875
16876#. type: Labeled list
16877#: ../schedutils/chrt.1.adoc:65
16878#, no-wrap
16879msgid "*-d*, *--deadline*"
16880msgstr ""
16881
16882#. type: Plain text
16883#: ../schedutils/chrt.1.adoc:67
16884msgid ""
16885"Set scheduling policy to *SCHED_DEADLINE* (sporadic task model deadline "
16886"scheduling). Linux-specific, supported since 3.14. The priority argument has "
16887"to be set to zero. See also *--sched-runtime*, *--sched-deadline* and "
16888"*--sched-period*. The relation between the options required by the kernel is "
16889"runtime <= deadline <= period. *chrt* copies _period_ to _deadline_ if "
16890"*--sched-deadline* is not specified and _deadline_ to _runtime_ if "
16891"*--sched-runtime* is not specified. It means that at least *--sched-period* "
16892"has to be specified. See *sched*(7) for more details."
16893msgstr ""
16894
16895#. type: Title ==
16896#: ../schedutils/chrt.1.adoc:68
16897#, no-wrap
16898msgid "SCHEDULING OPTIONS"
16899msgstr ""
16900
16901#. type: Labeled list
16902#: ../schedutils/chrt.1.adoc:70
16903#, no-wrap
16904msgid "*-T*, *--sched-runtime* _nanoseconds_"
16905msgstr ""
16906
16907#. type: Plain text
16908#: ../schedutils/chrt.1.adoc:72
16909msgid "Specifies runtime parameter for *SCHED_DEADLINE* policy (Linux-specific)."
16910msgstr ""
16911
16912#. type: Labeled list
16913#: ../schedutils/chrt.1.adoc:73
16914#, no-wrap
16915msgid "*-P*, *--sched-period* _nanoseconds_"
16916msgstr ""
16917
16918#. type: Plain text
16919#: ../schedutils/chrt.1.adoc:75
16920msgid "Specifies period parameter for *SCHED_DEADLINE* policy (Linux-specific)."
16921msgstr ""
16922
16923#. type: Labeled list
16924#: ../schedutils/chrt.1.adoc:76
16925#, no-wrap
16926msgid "*-D*, *--sched-deadline* _nanoseconds_"
16927msgstr ""
16928
16929#. type: Plain text
16930#: ../schedutils/chrt.1.adoc:78
16931msgid "Specifies deadline parameter for *SCHED_DEADLINE* policy (Linux-specific)."
16932msgstr ""
16933
16934#. type: Labeled list
16935#: ../schedutils/chrt.1.adoc:79 ../schedutils/uclampset.1.adoc:79
16936#, no-wrap
16937msgid "*-R*, *--reset-on-fork*"
16938msgstr ""
16939
16940#. type: Plain text
16941#: ../schedutils/chrt.1.adoc:81
16942msgid ""
16943"Use *SCHED_RESET_ON_FORK* or *SCHED_FLAG_RESET_ON_FORK* "
16944"flag. Linux-specific, supported since 2.6.31."
16945msgstr ""
16946
16947#. type: Plain text
16948#: ../schedutils/chrt.1.adoc:83
16949msgid ""
16950"Each thread has a _reset-on-fork_ scheduling flag. When this flag is set, "
16951"children created by *fork*(2) do not inherit privileged scheduling "
16952"policies. After the _reset-on-fork_ flag has been enabled, it can be reset "
16953"only if the thread has the *CAP_SYS_NICE* capability. This flag is disabled "
16954"in child processes created by *fork*(2)."
16955msgstr ""
16956
16957#. type: Plain text
16958#: ../schedutils/chrt.1.adoc:85
16959msgid ""
16960"More precisely, if the _reset-on-fork_ flag is set, the following rules "
16961"apply for subsequently created children:"
16962msgstr ""
16963
16964#. type: Plain text
16965#: ../schedutils/chrt.1.adoc:87
16966msgid ""
16967"If the calling thread has a scheduling policy of *SCHED_FIFO* or *SCHED_RR*, "
16968"the policy is reset to *SCHED_OTHER* in child processes."
16969msgstr ""
16970
16971#. type: Plain text
16972#: ../schedutils/chrt.1.adoc:89
16973msgid ""
16974"If the calling process has a negative nice value, the nice value is reset to "
16975"zero in child processes."
16976msgstr ""
16977
16978#. type: Labeled list
16979#: ../schedutils/chrt.1.adoc:92 ../schedutils/taskset.1.adoc:71
16980#: ../schedutils/uclampset.1.adoc:70
16981#, no-wrap
16982msgid "*-a*, *--all-tasks*"
16983msgstr ""
16984
16985#. type: Plain text
16986#: ../schedutils/chrt.1.adoc:94
16987msgid ""
16988"Set or retrieve the scheduling attributes of all the tasks (threads) for a "
16989"given PID."
16990msgstr ""
16991
16992#. type: Labeled list
16993#: ../schedutils/chrt.1.adoc:95
16994#, no-wrap
16995msgid "*-m*, *--max*"
16996msgstr ""
16997
16998#. type: Plain text
16999#: ../schedutils/chrt.1.adoc:97
17000msgid "Show minimum and maximum valid priorities, then exit."
17001msgstr ""
17002
17003#. type: Plain text
17004#: ../schedutils/chrt.1.adoc:100 ../schedutils/taskset.1.adoc:79
17005#: ../schedutils/uclampset.1.adoc:75
17006msgid "Operate on an existing PID and do not launch a new task."
17007msgstr ""
17008
17009#. type: Plain text
17010#: ../schedutils/chrt.1.adoc:103 ../schedutils/uclampset.1.adoc:84
17011msgid "Show status information."
17012msgstr ""
17013
17014#. type: Title ==
17015#: ../schedutils/chrt.1.adoc:110 ../schedutils/taskset.1.adoc:86
17016#: ../schedutils/uclampset.1.adoc:91
17017#, no-wrap
17018msgid "USAGE"
17019msgstr ""
17020
17021#. TRANSLATORS: Keep {colon} untranslated.
17022#. type: Labeled list
17023#: ../schedutils/chrt.1.adoc:113 ../schedutils/uclampset.1.adoc:94
17024#, no-wrap
17025msgid "The default behavior is to run a new command{colon}"
17026msgstr ""
17027
17028#. type: Plain text
17029#: ../schedutils/chrt.1.adoc:116
17030#, no-wrap
17031msgid "*chrt* _priority_ _command_ [_arguments_]\n"
17032msgstr ""
17033
17034#. TRANSLATORS: Keep {colon} untranslated
17035#. type: Labeled list
17036#: ../schedutils/chrt.1.adoc:118
17037#, no-wrap
17038msgid "You can also retrieve the real-time attributes of an existing task{colon}"
17039msgstr ""
17040
17041#. type: Plain text
17042#: ../schedutils/chrt.1.adoc:121
17043#, no-wrap
17044msgid "*chrt -p* _PID_\n"
17045msgstr ""
17046
17047#. TRANSLATORS: Keep {colon} untranslated.
17048#. type: Labeled list
17049#: ../schedutils/chrt.1.adoc:123 ../schedutils/uclampset.1.adoc:102
17050#, no-wrap
17051msgid "Or set them{colon}"
17052msgstr ""
17053
17054#. type: Plain text
17055#: ../schedutils/chrt.1.adoc:126
17056#, no-wrap
17057msgid "*chrt -r -p* _priority PID_\n"
17058msgstr ""
17059
17060#. type: Title ==
17061#: ../schedutils/chrt.1.adoc:127 ../schedutils/taskset.1.adoc:100
17062#: ../schedutils/uclampset.1.adoc:109
17063#, no-wrap
17064msgid "PERMISSIONS"
17065msgstr ""
17066
17067#. type: Plain text
17068#: ../schedutils/chrt.1.adoc:130 ../schedutils/uclampset.1.adoc:112
17069msgid ""
17070"A user must possess *CAP_SYS_NICE* to change the scheduling attributes of a "
17071"process. Any user can retrieve the scheduling information."
17072msgstr ""
17073
17074#. type: Plain text
17075#: ../schedutils/chrt.1.adoc:134
17076msgid ""
17077"Only *SCHED_FIFO*, *SCHED_OTHER* and *SCHED_RR* are part of POSIX 1003.1b "
17078"Process Scheduling. The other scheduling attributes may be ignored on some "
17079"systems."
17080msgstr ""
17081
17082#. type: Plain text
17083#: ../schedutils/chrt.1.adoc:136
17084msgid "Linux' default scheduling policy is *SCHED_OTHER*."
17085msgstr ""
17086
17087#. type: Plain text
17088#: ../schedutils/chrt.1.adoc:141
17089msgid "mailto:rml@tech9.net[Robert Love], mailto:kzak@redhat.com[Karel Zak]"
17090msgstr ""
17091
17092#. type: Plain text
17093#: ../schedutils/chrt.1.adoc:148 ../schedutils/uclampset.1.adoc:135
17094#, no-wrap
17095msgid ""
17096"*nice*(1),\n"
17097"*renice*(1),\n"
17098"*taskset*(1),\n"
17099"*sched*(7)\n"
17100msgstr ""
17101
17102#. type: Plain text
17103#: ../schedutils/chrt.1.adoc:150
17104msgid ""
17105"See *sched_setscheduler*(2) for a description of the Linux scheduling "
17106"scheme."
17107msgstr ""
17108
17109#. type: Title =
17110#: ../schedutils/ionice.1.adoc:2
17111#, no-wrap
17112msgid "ionice(1)"
17113msgstr ""
17114
17115#. type: Plain text
17116#: ../schedutils/ionice.1.adoc:13
17117msgid "ionice - set or get process I/O scheduling class and priority"
17118msgstr ""
17119
17120#. type: Plain text
17121#: ../schedutils/ionice.1.adoc:17
17122#, no-wrap
17123msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-p* _PID_\n"
17124msgstr ""
17125
17126#. type: Plain text
17127#: ../schedutils/ionice.1.adoc:19
17128#, no-wrap
17129msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-P* _PGID_\n"
17130msgstr ""
17131
17132#. type: Plain text
17133#: ../schedutils/ionice.1.adoc:21
17134#, no-wrap
17135msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] *-u* _UID_\n"
17136msgstr ""
17137
17138#. type: Plain text
17139#: ../schedutils/ionice.1.adoc:23
17140#, no-wrap
17141msgid "*ionice* [*-c* _class_] [*-n* _level_] [*-t*] _command_ [argument] ...\n"
17142msgstr ""
17143
17144#. type: Plain text
17145#: ../schedutils/ionice.1.adoc:27
17146msgid ""
17147"This program sets or gets the I/O scheduling class and priority for a "
17148"program. If no arguments or just *-p* is given, *ionice* will query the "
17149"current I/O scheduling class and priority for that process."
17150msgstr ""
17151
17152#. type: Plain text
17153#: ../schedutils/ionice.1.adoc:29
17154msgid ""
17155"When _command_ is given, *ionice* will run this command with the given "
17156"arguments. If no _class_ is specified, then _command_ will be executed with "
17157"the \"best-effort\" scheduling class. The default priority level is 4."
17158msgstr ""
17159
17160#. type: Plain text
17161#: ../schedutils/ionice.1.adoc:31
17162msgid "As of this writing, a process can be in one of three scheduling classes:"
17163msgstr ""
17164
17165#. type: Labeled list
17166#: ../schedutils/ionice.1.adoc:32
17167#, no-wrap
17168msgid "*Idle*"
17169msgstr ""
17170
17171#. type: Plain text
17172#: ../schedutils/ionice.1.adoc:34
17173msgid ""
17174"A program running with idle I/O priority will only get disk time when no "
17175"other program has asked for disk I/O for a defined grace period. The impact "
17176"of an idle I/O process on normal system activity should be zero. This "
17177"scheduling class does not take a priority argument. Presently, this "
17178"scheduling class is permitted for an ordinary user (since kernel 2.6.25)."
17179msgstr ""
17180
17181#. type: Labeled list
17182#: ../schedutils/ionice.1.adoc:35
17183#, no-wrap
17184msgid "*Best-effort*"
17185msgstr ""
17186
17187#. type: Plain text
17188#: ../schedutils/ionice.1.adoc:37
17189msgid ""
17190"This is the effective scheduling class for any process that has not asked "
17191"for a specific I/O priority. This class takes a priority argument from "
17192"_0-7_, with a lower number being higher priority. Programs running at the "
17193"same best-effort priority are served in a round-robin fashion."
17194msgstr ""
17195
17196#. TRANSLATORS: Keep {plus} untranslated.
17197#. type: Plain text
17198#: ../schedutils/ionice.1.adoc:40
17199msgid ""
17200"Note that before kernel 2.6.26 a process that has not asked for an I/O "
17201"priority formally uses \"*none*\" as scheduling class, but the I/O scheduler "
17202"will treat such processes as if it were in the best-effort class. The "
17203"priority within the best-effort class will be dynamically derived from the "
17204"CPU nice level of the process: io_priority = (cpu_nice {plus} 20) / 5."
17205msgstr ""
17206
17207#. type: Plain text
17208#: ../schedutils/ionice.1.adoc:42
17209msgid ""
17210"For kernels after 2.6.26 with the CFQ I/O scheduler, a process that has not "
17211"asked for an I/O priority inherits its CPU scheduling class. The I/O "
17212"priority is derived from the CPU nice level of the process (same as before "
17213"kernel 2.6.26)."
17214msgstr ""
17215
17216#. type: Labeled list
17217#: ../schedutils/ionice.1.adoc:43
17218#, no-wrap
17219msgid "*Realtime*"
17220msgstr ""
17221
17222#. type: Plain text
17223#: ../schedutils/ionice.1.adoc:45
17224msgid ""
17225"The RT scheduling class is given first access to the disk, regardless of "
17226"what else is going on in the system. Thus the RT class needs to be used with "
17227"some care, as it can starve other processes. As with the best-effort class, "
17228"8 priority levels are defined denoting how big a time slice a given process "
17229"will receive on each scheduling window. This scheduling class is not "
17230"permitted for an ordinary (i.e., non-root) user."
17231msgstr ""
17232
17233#. type: Labeled list
17234#: ../schedutils/ionice.1.adoc:48
17235#, no-wrap
17236msgid "*-c*, *--class* _class_"
17237msgstr ""
17238
17239#. type: Plain text
17240#: ../schedutils/ionice.1.adoc:50
17241msgid ""
17242"Specify the name or number of the scheduling class to use; `0` for none, `1` "
17243"for realtime, `2` for best-effort, `3` for idle."
17244msgstr ""
17245
17246#. type: Labeled list
17247#: ../schedutils/ionice.1.adoc:51
17248#, no-wrap
17249msgid "*-n*, *--classdata* _level_"
17250msgstr ""
17251
17252#. type: Plain text
17253#: ../schedutils/ionice.1.adoc:53
17254msgid ""
17255"Specify the scheduling class data. This only has an effect if the class "
17256"accepts an argument. For realtime and best-effort, _0-7_ are valid data "
17257"(priority levels), and `0` represents the highest priority level."
17258msgstr ""
17259
17260#. type: Labeled list
17261#: ../schedutils/ionice.1.adoc:54
17262#, no-wrap
17263msgid "*-p*, *--pid* _PID_..."
17264msgstr ""
17265
17266#. type: Plain text
17267#: ../schedutils/ionice.1.adoc:56
17268msgid ""
17269"Specify the process IDs of running processes for which to get or set the "
17270"scheduling parameters."
17271msgstr ""
17272
17273#. type: Labeled list
17274#: ../schedutils/ionice.1.adoc:57
17275#, no-wrap
17276msgid "*-P*, *--pgid* _PGID_..."
17277msgstr ""
17278
17279#. type: Plain text
17280#: ../schedutils/ionice.1.adoc:59
17281msgid ""
17282"Specify the process group IDs of running processes for which to get or set "
17283"the scheduling parameters."
17284msgstr ""
17285
17286#. type: Labeled list
17287#: ../schedutils/ionice.1.adoc:60
17288#, no-wrap
17289msgid "*-t*, *--ignore*"
17290msgstr ""
17291
17292#. type: Plain text
17293#: ../schedutils/ionice.1.adoc:62
17294msgid ""
17295"Ignore failure to set the requested priority. If _command_ was specified, "
17296"run it even in case it was not possible to set the desired scheduling "
17297"priority, which can happen due to insufficient privileges or an old kernel "
17298"version."
17299msgstr ""
17300
17301#. type: Labeled list
17302#: ../schedutils/ionice.1.adoc:66
17303#, no-wrap
17304msgid "*-u*, *--uid* _UID_..."
17305msgstr ""
17306
17307#. type: Plain text
17308#: ../schedutils/ionice.1.adoc:68
17309msgid ""
17310"Specify the user IDs of running processes for which to get or set the "
17311"scheduling parameters."
17312msgstr ""
17313
17314#. type: Plain text
17315#: ../schedutils/ionice.1.adoc:75
17316msgid ""
17317"Linux supports I/O scheduling priorities and classes since 2.6.13 with the "
17318"CFQ I/O scheduler."
17319msgstr ""
17320
17321#. type: Plain text
17322#: ../schedutils/ionice.1.adoc:79
17323msgid "# *ionice* -c 3 -p 89"
17324msgstr ""
17325
17326#. type: Plain text
17327#: ../schedutils/ionice.1.adoc:81
17328msgid "Sets process with PID 89 as an idle I/O process."
17329msgstr ""
17330
17331#. type: Plain text
17332#: ../schedutils/ionice.1.adoc:83
17333msgid "# *ionice* -c 2 -n 0 bash"
17334msgstr ""
17335
17336#. type: Plain text
17337#: ../schedutils/ionice.1.adoc:85
17338msgid "Runs 'bash' as a best-effort program with highest priority."
17339msgstr ""
17340
17341#. type: Plain text
17342#: ../schedutils/ionice.1.adoc:87
17343msgid "# *ionice* -p 89 91"
17344msgstr ""
17345
17346#. type: Plain text
17347#: ../schedutils/ionice.1.adoc:89
17348msgid "Prints the class and priority of the processes with PID 89 and 91."
17349msgstr ""
17350
17351#. type: Plain text
17352#: ../schedutils/ionice.1.adoc:94
17353msgid "mailto:jens@axboe.dk[Jens Axboe], mailto:kzak@redhat.com[Karel Zak]"
17354msgstr ""
17355
17356#. type: Plain text
17357#: ../schedutils/ionice.1.adoc:98
17358#, no-wrap
17359msgid "*ioprio_set*(2)\n"
17360msgstr ""
17361
17362#. taskset(1) manpage
17363#. Copyright (C) 2004 Robert Love
17364#
17365#. This is free documentation; you can redistribute it and/or
17366#. modify it under the terms of the GNU General Public License,
17367#. version 2, as published by the Free Software Foundation.
17368#
17369#. The GNU General Public License's references to "object code"
17370#. and "executables" are to be interpreted as the output of any
17371#. document formatting or typesetting system, including
17372#. intermediate and printed output.
17373#
17374#. This manual is distributed in the hope that it will be useful,
17375#. but WITHOUT ANY WARRANTY; without even the implied warranty of
17376#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17377#. GNU General Public License for more details.
17378#
17379#. You should have received a copy of the GNU General Public License along
17380#. with this program; if not, write to the Free Software Foundation, Inc.,
17381#. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
17382#. type: Title =
17383#: ../schedutils/taskset.1.adoc:24
17384#, no-wrap
17385msgid "taskset(1)"
17386msgstr ""
17387
17388#. type: Plain text
17389#: ../schedutils/taskset.1.adoc:36
17390msgid "taskset - set or retrieve a process's CPU affinity"
17391msgstr ""
17392
17393#. type: Plain text
17394#: ../schedutils/taskset.1.adoc:40
17395#, no-wrap
17396msgid "*taskset* [options] _mask command_ [_argument_...]\n"
17397msgstr ""
17398
17399#. type: Plain text
17400#: ../schedutils/taskset.1.adoc:42
17401#, no-wrap
17402msgid "*taskset* [options] *-p* [_mask_] _pid_\n"
17403msgstr ""
17404
17405#. type: Plain text
17406#: ../schedutils/taskset.1.adoc:46
17407msgid ""
17408"The *taskset* command is used to set or retrieve the CPU affinity of a "
17409"running process given its _pid_, or to launch a new _command_ with a given "
17410"CPU affinity. CPU affinity is a scheduler property that \"bonds\" a process "
17411"to a given set of CPUs on the system. The Linux scheduler will honor the "
17412"given CPU affinity and the process will not run on any other CPUs. Note that "
17413"the Linux scheduler also supports natural CPU affinity: the scheduler "
17414"attempts to keep processes on the same CPU as long as practical for "
17415"performance reasons. Therefore, forcing a specific CPU affinity is useful "
17416"only in certain applications."
17417msgstr ""
17418
17419#. type: Plain text
17420#: ../schedutils/taskset.1.adoc:48
17421msgid ""
17422"The CPU affinity is represented as a bitmask, with the lowest order bit "
17423"corresponding to the first logical CPU and the highest order bit "
17424"corresponding to the last logical CPU. Not all CPUs may exist on a given "
17425"system but a mask may specify more CPUs than are present. A retrieved mask "
17426"will reflect only the bits that correspond to CPUs physically on the "
17427"system. If an invalid mask is given (i.e., one that corresponds to no valid "
17428"CPUs on the current system) an error is returned. The masks may be specified "
17429"in hexadecimal (with or without a leading \"0x\"), or as a CPU list with the "
17430"*--cpu-list* option. For example,"
17431msgstr ""
17432
17433#. type: Labeled list
17434#: ../schedutils/taskset.1.adoc:49
17435#, no-wrap
17436msgid "*0x00000001*"
17437msgstr ""
17438
17439#. type: Plain text
17440#: ../schedutils/taskset.1.adoc:51
17441msgid "is processor #0,"
17442msgstr ""
17443
17444#. type: Labeled list
17445#: ../schedutils/taskset.1.adoc:52
17446#, no-wrap
17447msgid "*0x00000003*"
17448msgstr ""
17449
17450#. type: Plain text
17451#: ../schedutils/taskset.1.adoc:54
17452msgid "is processors #0 and #1,"
17453msgstr ""
17454
17455#. type: Labeled list
17456#: ../schedutils/taskset.1.adoc:55
17457#, no-wrap
17458msgid "*0xFFFFFFFF*"
17459msgstr ""
17460
17461#. type: Plain text
17462#: ../schedutils/taskset.1.adoc:57
17463msgid "is processors #0 through #31,"
17464msgstr ""
17465
17466#. type: Plain text
17467#: ../schedutils/taskset.1.adoc:60
17468msgid "is processors #1, #4, and #5,"
17469msgstr ""
17470
17471#. type: Labeled list
17472#: ../schedutils/taskset.1.adoc:61
17473#, no-wrap
17474msgid "*--cpu-list 0-2,6*"
17475msgstr ""
17476
17477#. type: Plain text
17478#: ../schedutils/taskset.1.adoc:63
17479msgid "is processors #0, #1, #2, and #6."
17480msgstr ""
17481
17482#. type: Labeled list
17483#: ../schedutils/taskset.1.adoc:64
17484#, no-wrap
17485msgid "*--cpu-list 0-10:2*"
17486msgstr ""
17487
17488#. type: Plain text
17489#: ../schedutils/taskset.1.adoc:66
17490msgid ""
17491"is processors #0, #2, #4, #6, #8 and #10. The suffix \":N\" specifies stride "
17492"in the range, for example 0-10:3 is interpreted as 0,3,6,9 list."
17493msgstr ""
17494
17495#. type: Plain text
17496#: ../schedutils/taskset.1.adoc:68
17497msgid ""
17498"When *taskset* returns, it is guaranteed that the given program has been "
17499"scheduled to a legal CPU."
17500msgstr ""
17501
17502#. type: Plain text
17503#: ../schedutils/taskset.1.adoc:73
17504msgid "Set or retrieve the CPU affinity of all the tasks (threads) for a given PID."
17505msgstr ""
17506
17507#. type: Labeled list
17508#: ../schedutils/taskset.1.adoc:74
17509#, no-wrap
17510msgid "*-c*, *--cpu-list*"
17511msgstr ""
17512
17513#. type: Plain text
17514#: ../schedutils/taskset.1.adoc:76
17515msgid ""
17516"Interpret _mask_ as numerical list of processors instead of a "
17517"bitmask. Numbers are separated by commas and may include ranges. For "
17518"example: *0,5,8-11*."
17519msgstr ""
17520
17521#. TRANSLATORS: Keep {colon} untranslated.
17522#. type: Labeled list
17523#: ../schedutils/taskset.1.adoc:89
17524#, no-wrap
17525msgid ""
17526"The default behavior is to run a new command with a given affinity "
17527"mask{colon}"
17528msgstr ""
17529
17530#. type: Plain text
17531#: ../schedutils/taskset.1.adoc:91
17532#, no-wrap
17533msgid "*taskset* _mask_ _command_ [_arguments_]\n"
17534msgstr ""
17535
17536#. TRANSLATORS: Keep {colon} untranslated.
17537#. type: Labeled list
17538#: ../schedutils/taskset.1.adoc:93
17539#, no-wrap
17540msgid "You can also retrieve the CPU affinity of an existing task{colon}"
17541msgstr ""
17542
17543#. type: Plain text
17544#: ../schedutils/taskset.1.adoc:95
17545#, no-wrap
17546msgid "*taskset -p* _pid_\n"
17547msgstr ""
17548
17549#. TRANSLATORS: Keep {colon} untranslated.
17550#. type: Labeled list
17551#: ../schedutils/taskset.1.adoc:97
17552#, no-wrap
17553msgid "Or set it{colon}"
17554msgstr ""
17555
17556#. type: Plain text
17557#: ../schedutils/taskset.1.adoc:99
17558#, no-wrap
17559msgid "*taskset -p* _mask pid_\n"
17560msgstr ""
17561
17562#. type: Plain text
17563#: ../schedutils/taskset.1.adoc:103
17564msgid ""
17565"A user can change the CPU affinity of a process belonging to the same "
17566"user. A user must possess *CAP_SYS_NICE* to change the CPU affinity of a "
17567"process belonging to another user. A user can retrieve the affinity mask of "
17568"any process."
17569msgstr ""
17570
17571#. type: Plain text
17572#: ../schedutils/taskset.1.adoc:107
17573msgid "Written by Robert M. Love."
17574msgstr ""
17575
17576#. type: Title ==
17577#: ../schedutils/taskset.1.adoc:108 ../sys-utils/chcpu.8.adoc:76
b81d5971 17578#: ../sys-utils/flock.1.adoc:124 ../sys-utils/rtcwake.8.adoc:130
5db1d29a 17579#: ../term-utils/scriptlive.1.adoc:70 ../term-utils/scriptreplay.1.adoc:87
36e96905
MB
17580#, no-wrap
17581msgid "COPYRIGHT"
17582msgstr ""
17583
17584#. TRANSLATORS: Keep {copyright} untranslated.
17585#. type: Plain text
17586#: ../schedutils/taskset.1.adoc:112
17587msgid ""
17588"Copyright {copyright} 2004 Robert M. Love. This is free software; see the "
17589"source for copying conditions. There is NO warranty; not even for "
17590"MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
17591msgstr ""
17592
17593#. type: Plain text
17594#: ../schedutils/taskset.1.adoc:120
17595#, no-wrap
17596msgid ""
17597"*chrt*(1),\n"
17598"*nice*(1),\n"
17599"*renice*(1),\n"
17600"*sched_getaffinity*(2),\n"
17601"*sched_setaffinity*(2)\n"
17602msgstr ""
17603
17604#. type: Plain text
17605#: ../schedutils/taskset.1.adoc:122
17606msgid "See *sched*(7) for a description of the Linux scheduling scheme."
17607msgstr ""
17608
17609#. uclampset(1) manpage
17610#
17611#. Copyright (C) 2020-2021 Qais Yousef <qais.yousef@arm.com>
17612#. Copyright (C) 2020-2021 Arm Ltd
17613#
17614#. This is free documentation; you can redistribute it and/or
17615#. modify it under the terms of the GNU General Public License,
17616#. version 2, as published by the Free Software Foundation.
17617#
17618#. The GNU General Public License's references to "object code"
17619#. and "executables" are to be interpreted as the output of any
17620#. document formatting or typesetting system, including
17621#. intermediate and printed output.
17622#
17623#. This manual is distributed in the hope that it will be useful,
17624#. but WITHOUT ANY WARRANTY; without even the implied warranty of
17625#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17626#. GNU General Public License for more details.
17627#
17628#. You should have received a copy of the GNU General Public License along
17629#. with this program; if not, write to the Free Software Foundation, Inc.,
17630#. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
17631#. type: Title =
17632#: ../schedutils/uclampset.1.adoc:26
17633#, no-wrap
17634msgid "uclampset(1)"
17635msgstr ""
17636
17637#. type: Plain text
17638#: ../schedutils/uclampset.1.adoc:37
17639msgid ""
17640"uclampset - manipulate the utilization clamping attributes of the system or "
17641"a process"
17642msgstr ""
17643
17644#. type: Plain text
17645#: ../schedutils/uclampset.1.adoc:41
17646#, no-wrap
17647msgid ""
17648"*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max] _command "
17649"argument_\n"
17650msgstr ""
17651
17652#. type: Plain text
17653#: ../schedutils/uclampset.1.adoc:43
17654#, no-wrap
17655msgid "*uclampset* [options] [*-m* _uclamp_min_] [*-M* _uclamp_max_] *-p* _PID_\n"
17656msgstr ""
17657
17658#. type: Plain text
17659#: ../schedutils/uclampset.1.adoc:47
17660#, no-wrap
17661msgid ""
17662"*uclampset* sets or retrieves the utilization clamping attributes of an "
17663"existing _PID_, or runs _command_ with the given attributes.\n"
17664msgstr ""
17665
17666#. type: Plain text
17667#: ../schedutils/uclampset.1.adoc:49
17668msgid ""
17669"Utilization clamping is a new feature added in v5.3. It gives a hint to the "
17670"scheduler about the allowed range of utilization the task should be "
17671"operating at."
17672msgstr ""
17673
17674#. type: Plain text
17675#: ../schedutils/uclampset.1.adoc:51
17676msgid ""
17677"The utilization of the task affects frequency selection and task "
17678"placement. Only schedutil cpufreq governor understands handling util clamp "
17679"hints at the time of writing. Consult your kernel docs for further info "
17680"about other cpufreq governors support."
17681msgstr ""
17682
17683#. type: Plain text
17684#: ../schedutils/uclampset.1.adoc:53
17685msgid ""
17686"If you're running on asymmetric heterogeneous system like Arm's "
17687"big.LITTLE. Utilization clamping can help bias task placement. If the task "
17688"is boosted such that _util_min_ value is higher than the little cores' "
17689"capacity, then the scheduler will do its best to place it on a big core."
17690msgstr ""
17691
17692#. type: Plain text
17693#: ../schedutils/uclampset.1.adoc:55
17694msgid ""
17695"Similarly, if _util_max_ is smaller than or equal the capacity of the little "
17696"cores, then the scheduler can still choose to place it there even if the "
17697"actual utilization of the task is at max."
17698msgstr ""
17699
17700#. type: Plain text
17701#: ../schedutils/uclampset.1.adoc:57
17702msgid ""
17703"Setting a task's _uclamp_min_ to a none zero value will effectively boost "
17704"the task as when it runs it'll always start from this utilization value."
17705msgstr ""
17706
17707#. type: Plain text
17708#: ../schedutils/uclampset.1.adoc:59
17709msgid ""
17710"By setting a task's _uclamp_max_ below 1024, this will effectively cap the "
17711"task as when it runs it'll never be able to go above this utilization value."
17712msgstr ""
17713
17714#. type: Plain text
17715#: ../schedutils/uclampset.1.adoc:61
17716msgid ""
17717"The full utilization range is: [0:1024]. The special value -1 is used to "
17718"reset to system's default."
17719msgstr ""
17720
17721#. type: Plain text
17722#: ../schedutils/uclampset.1.adoc:66
17723msgid "Set _util_min_ value."
17724msgstr ""
17725
17726#. type: Plain text
17727#: ../schedutils/uclampset.1.adoc:69
17728msgid "Set _util_max_ value."
17729msgstr ""
17730
17731#. type: Plain text
17732#: ../schedutils/uclampset.1.adoc:72
17733msgid ""
17734"Set or retrieve the utilization clamping attributes of all the tasks "
17735"(threads) for a given PID."
17736msgstr ""
17737
17738#. type: Labeled list
17739#: ../schedutils/uclampset.1.adoc:76
17740#, no-wrap
17741msgid "*-s*, *--system*"
17742msgstr ""
17743
17744#. type: Plain text
17745#: ../schedutils/uclampset.1.adoc:78
17746msgid "Set or retrieve the system-wide utilization clamping attributes."
17747msgstr ""
17748
17749#. type: Plain text
17750#: ../schedutils/uclampset.1.adoc:81
17751msgid "Set *SCHED_FLAG_RESET_ON_FORK* flag."
17752msgstr ""
17753
17754#. type: Plain text
17755#: ../schedutils/uclampset.1.adoc:96
17756#, no-wrap
17757msgid "*uclampset* _[-m uclamp_min]_ _[-M uclamp_max]_ _command_ [_arguments_]\n"
17758msgstr ""
17759
17760#. TRANSLATORS: Keep {colon} untranslated.
17761#. type: Labeled list
17762#: ../schedutils/uclampset.1.adoc:98
17763#, no-wrap
17764msgid ""
17765"You can also retrieve the utilization clamping attributes of an existing "
17766"task{colon}"
17767msgstr ""
17768
17769#. type: Plain text
17770#: ../schedutils/uclampset.1.adoc:100
17771#, no-wrap
17772msgid "*uclampset -p* _PID_\n"
17773msgstr ""
17774
17775#. type: Plain text
17776#: ../schedutils/uclampset.1.adoc:104
17777#, no-wrap
17778msgid "*uclampset -p* _PID_ _[-m uclamp_min]_ _[-M uclamp_max]_\n"
17779msgstr ""
17780
17781#. TRANSLATORS: Keep {colon} untranslated.
17782#. type: Labeled list
17783#: ../schedutils/uclampset.1.adoc:106
17784#, no-wrap
17785msgid "Or control the system-wide attributes{colon}"
17786msgstr ""
17787
17788#. type: Plain text
17789#: ../schedutils/uclampset.1.adoc:108
17790#, no-wrap
17791msgid "*uclampset -s* _[-m uclamp_min]_ _[-M uclamp_max]_\n"
17792msgstr ""
17793
17794#. type: Plain text
17795#: ../schedutils/uclampset.1.adoc:116
17796msgid ""
17797"The system wide utilization clamp attributes are there to control the "
17798"_allowed_ range the tasks can use. By default both _uclamp_min_ and "
17799"_uclamp_max_ are set to 1024. This means users can set the utilization clamp "
17800"values for their task across the full range [0:1024]."
17801msgstr ""
17802
17803#. TRANSLATORS: Keep {colon} untranslated.
17804#. type: Labeled list
17805#: ../schedutils/uclampset.1.adoc:118
17806#, no-wrap
17807msgid "For example{colon}"
17808msgstr ""
17809
17810#. type: Plain text
17811#: ../schedutils/uclampset.1.adoc:120
17812#, no-wrap
17813msgid "*uclampset -s* `-m 512` `-M 700`\n"
17814msgstr ""
17815
17816#. type: Plain text
17817#: ../schedutils/uclampset.1.adoc:122
17818msgid ""
17819"will prevent any task from being boosted higher than 512. And all tasks in "
17820"the systems are capped to a utilization of 700. Effectively rendering the "
17821"maximum performance of the system to 700."
17822msgstr ""
17823
17824#. type: Plain text
17825#: ../schedutils/uclampset.1.adoc:124
17826msgid "Consult your kernel docs for the exact expected behavior on that kernel."
17827msgstr ""
17828
17829#. type: Plain text
17830#: ../schedutils/uclampset.1.adoc:128
17831msgid "mailto:qais.yousef@arm.com[Qais Yousef]"
17832msgstr ""
17833
17834#. type: Plain text
17835#: ../schedutils/uclampset.1.adoc:137
17836msgid ""
17837"See *sched_setscheduler*(2) and *sched_setattr*(2) for a description of the "
17838"Linux scheduling scheme."
17839msgstr ""
17840
17841#. type: Title =
17842#: ../sys-utils/adjtime_config.5.adoc:2
17843#, no-wrap
17844msgid "adjtime_config(5)"
17845msgstr ""
17846
17847#. type: Plain text
17848#: ../sys-utils/adjtime_config.5.adoc:12
17849msgid "adjtime_config - information about hardware clock setting and drift factor"
17850msgstr ""
17851
17852#. type: Plain text
17853#: ../sys-utils/adjtime_config.5.adoc:16 ../sys-utils/adjtime_config.5.adoc:53
17854msgid "_/etc/adjtime_"
17855msgstr ""
17856
17857#. type: Plain text
17858#: ../sys-utils/adjtime_config.5.adoc:20
17859msgid ""
17860"The file _/etc/adjtime_ contains descriptive information about the hardware "
17861"mode clock setting and clock drift factor. The file is read and write by "
17862"*hwclock*(8); and read by programs like rtcwake to get RTC time mode."
17863msgstr ""
17864
17865#. type: Plain text
17866#: ../sys-utils/adjtime_config.5.adoc:22
17867msgid ""
17868"The file is usually located in _/etc_, but tools like *hwclock*(8) or "
17869"*rtcwake*(8) can use alternative location by command line options if write "
17870"access to _/etc_ is unwanted. The default clock mode is \"UTC\" if the file "
17871"is missing."
17872msgstr ""
17873
17874#. type: Plain text
17875#: ../sys-utils/adjtime_config.5.adoc:24
17876msgid ""
17877"The Hardware Clock is usually not very accurate. However, much of its "
17878"inaccuracy is completely predictable - it gains or loses the same amount of "
17879"time every day. This is called systematic drift. The util *hwclock*(8) keeps "
17880"the file _/etc/adjtime_, that keeps some historical information. For more "
17881"details see \"*The Adjust Function*\" and \"*The Adjtime File*\" sections "
17882"from *hwclock*(8) man page."
17883msgstr ""
17884
17885#. type: Plain text
17886#: ../sys-utils/adjtime_config.5.adoc:26
17887msgid "The format of the adjtime file is, in ASCII."
17888msgstr ""
17889
17890#. type: Title ===
17891#: ../sys-utils/adjtime_config.5.adoc:27
17892#, no-wrap
17893msgid "First line"
17894msgstr ""
17895
17896#. type: Plain text
17897#: ../sys-utils/adjtime_config.5.adoc:30
17898msgid "Three numbers, separated by blanks:"
17899msgstr ""
17900
17901#. type: Labeled list
17902#: ../sys-utils/adjtime_config.5.adoc:31
17903#, no-wrap
17904msgid "*drift factor*"
17905msgstr ""
17906
17907#. type: Plain text
17908#: ../sys-utils/adjtime_config.5.adoc:33
17909msgid "the systematic drift rate in seconds per day (floating point decimal)"
17910msgstr ""
17911
17912#. type: Labeled list
17913#: ../sys-utils/adjtime_config.5.adoc:34
17914#, no-wrap
17915msgid "*last adjust time*"
17916msgstr ""
17917
17918#. type: Plain text
17919#: ../sys-utils/adjtime_config.5.adoc:36
17920msgid ""
17921"the resulting number of seconds since 1969 UTC of most recent adjustment or "
17922"calibration (decimal integer)"
17923msgstr ""
17924
17925#. type: Labeled list
17926#: ../sys-utils/adjtime_config.5.adoc:37
17927#, no-wrap
17928msgid "*adjustment status*"
17929msgstr ""
17930
17931#. type: Plain text
17932#: ../sys-utils/adjtime_config.5.adoc:39
17933msgid "zero (for compatibility with *clock*(8)) as a floating point decimal"
17934msgstr ""
17935
17936#. type: Title ===
17937#: ../sys-utils/adjtime_config.5.adoc:40
17938#, no-wrap
17939msgid "Second line"
17940msgstr ""
17941
17942#. type: Labeled list
17943#: ../sys-utils/adjtime_config.5.adoc:42
17944#, no-wrap
17945msgid "*last calibration time*"
17946msgstr ""
17947
17948#. type: Plain text
17949#: ../sys-utils/adjtime_config.5.adoc:44
17950msgid ""
17951"The resulting number of seconds since 1969 UTC of most recent "
17952"calibration. Zero if there has been no calibration yet or it is known that "
17953"any previous calibration is moot (for example, because the Hardware Clock "
17954"has been found, since that calibration, not to contain a valid time). This "
17955"is a decimal integer."
17956msgstr ""
17957
17958#. type: Title ===
17959#: ../sys-utils/adjtime_config.5.adoc:45
17960#, no-wrap
17961msgid "Third line"
17962msgstr ""
17963
17964#. type: Labeled list
17965#: ../sys-utils/adjtime_config.5.adoc:47
17966#, no-wrap
17967msgid "*clock mode*"
17968msgstr ""
17969
17970#. type: Plain text
17971#: ../sys-utils/adjtime_config.5.adoc:49
17972msgid ""
17973"Supported values are *UTC* or *LOCAL*. Tells whether the Hardware Clock is "
17974"set to Coordinated Universal Time or local time. You can always override "
17975"this value with options on the *hwclock*(8) command line."
17976msgstr ""
17977
17978#. type: Plain text
17979#: ../sys-utils/adjtime_config.5.adoc:58
17980#, no-wrap
17981msgid ""
17982"*hwclock*(8),\n"
17983"*rtcwake*(8)\n"
17984msgstr ""
17985
17986#. type: Title =
17987#: ../sys-utils/blkdiscard.8.adoc:2
17988#, no-wrap
17989msgid "blkdiscard(8)"
17990msgstr ""
17991
17992#. type: Plain text
17993#: ../sys-utils/blkdiscard.8.adoc:12
17994msgid "blkdiscard - discard sectors on a device"
17995msgstr ""
17996
17997#. type: Plain text
17998#: ../sys-utils/blkdiscard.8.adoc:16
17999#, no-wrap
18000msgid "*blkdiscard* [options] [*-o* _offset_] [*-l* _length_] _device_\n"
18001msgstr ""
18002
18003#. type: Plain text
18004#: ../sys-utils/blkdiscard.8.adoc:20
18005#, no-wrap
18006msgid ""
18007"*blkdiscard* is used to discard device sectors. This is useful for "
18008"solid-state drivers (SSDs) and thinly-provisioned storage. Unlike "
18009"*fstrim*(8), this command is used directly on the block device.\n"
18010msgstr ""
18011
18012#. type: Plain text
18013#: ../sys-utils/blkdiscard.8.adoc:22
18014msgid ""
18015"By default, *blkdiscard* will discard all blocks on the device. Options may "
18016"be used to modify this behavior based on range or size, as explained below."
18017msgstr ""
18018
18019#. type: Plain text
18020#: ../sys-utils/blkdiscard.8.adoc:24 ../sys-utils/blkzone.8.adoc:22
18021msgid "The _device_ argument is the pathname of the block device."
18022msgstr ""
18023
18024#. type: Plain text
18025#: ../sys-utils/blkdiscard.8.adoc:26
18026#, no-wrap
18027msgid "*WARNING: All data in the discarded region on the device will be lost!*\n"
18028msgstr ""
18029
18030#. type: Plain text
18031#: ../sys-utils/blkdiscard.8.adoc:30
18032msgid ""
18033"The _offset_ and _length_ arguments may be followed by the multiplicative "
18034"suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
18035"ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
18036"\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
18037"PB, EB, ZB and YB."
18038msgstr ""
18039
18040#. type: Plain text
18041#: ../sys-utils/blkdiscard.8.adoc:33
18042msgid ""
18043"Disable all checking. Since v2.36 the block device is open in exclusive mode "
18044"(O_EXCL) by default to avoid collision with mounted filesystem or another "
18045"kernel subsystem. The *--force* option disables the exclusive access mode."
18046msgstr ""
18047
18048#. type: Plain text
18049#: ../sys-utils/blkdiscard.8.adoc:36
18050msgid ""
18051"Byte offset into the device from which to start discarding. The provided "
18052"value must be aligned to the device sector size. The default value is zero."
18053msgstr ""
18054
18055#. type: Labeled list
18056#: ../sys-utils/blkdiscard.8.adoc:37 ../sys-utils/fallocate.1.adoc:50
18057#, no-wrap
18058msgid "*-l*, *--length* _length_"
18059msgstr ""
18060
18061#. type: Plain text
18062#: ../sys-utils/blkdiscard.8.adoc:39
18063msgid ""
18064"The number of bytes to discard (counting from the starting point). The "
18065"provided value must be aligned to the device sector size. If the specified "
18066"value extends past the end of the device, *blkdiscard* will stop at the "
18067"device size boundary. The default value extends to the end of the device."
18068msgstr ""
18069
18070#. type: Labeled list
18071#: ../sys-utils/blkdiscard.8.adoc:40
18072#, no-wrap
18073msgid "*-p*, *--step* _length_"
18074msgstr ""
18075
18076#. type: Plain text
18077#: ../sys-utils/blkdiscard.8.adoc:42
18078msgid ""
18079"The number of bytes to discard within one iteration. The default is to "
18080"discard all by one ioctl call."
18081msgstr ""
18082
18083#. type: Labeled list
18084#: ../sys-utils/blkdiscard.8.adoc:43
18085#, no-wrap
18086msgid "*-s*, *--secure*"
18087msgstr ""
18088
18089#. type: Plain text
18090#: ../sys-utils/blkdiscard.8.adoc:45
18091msgid ""
18092"Perform a secure discard. A secure discard is the same as a regular discard "
18093"except that all copies of the discarded blocks that were possibly created by "
18094"garbage collection must also be erased. This requires support from the "
18095"device."
18096msgstr ""
18097
18098#. type: Labeled list
18099#: ../sys-utils/blkdiscard.8.adoc:46
18100#, no-wrap
18101msgid "*-z*, *--zeroout*"
18102msgstr ""
18103
18104#. type: Plain text
18105#: ../sys-utils/blkdiscard.8.adoc:48
18106msgid "Zero-fill rather than discard."
18107msgstr ""
18108
18109#. type: Plain text
18110#: ../sys-utils/blkdiscard.8.adoc:51
18111msgid ""
18112"Display the aligned values of _offset_ and _length_. If the *--step* option "
18113"is specified, it prints the discard progress every second."
18114msgstr ""
18115
18116#. type: Plain text
18117#: ../sys-utils/blkdiscard.8.adoc:61
18118msgid "mailto:lczerner@redhat.com[Lukas Czerner]"
18119msgstr ""
18120
18121#. type: Plain text
18122#: ../sys-utils/blkdiscard.8.adoc:65
18123#, no-wrap
18124msgid "*fstrim*(8)\n"
18125msgstr ""
18126
18127#. type: Title =
18128#: ../sys-utils/blkzone.8.adoc:2
18129#, no-wrap
18130msgid "blkzone(8)"
18131msgstr ""
18132
18133#. type: Plain text
18134#: ../sys-utils/blkzone.8.adoc:12
18135msgid "blkzone - run zone command on a device"
18136msgstr ""
18137
18138#. type: Plain text
18139#: ../sys-utils/blkzone.8.adoc:16
18140#, no-wrap
18141msgid "*blkzone* _command_ [options] _device_\n"
18142msgstr ""
18143
18144#. type: Plain text
18145#: ../sys-utils/blkzone.8.adoc:20
18146#, no-wrap
18147msgid ""
18148"*blkzone* is used to run zone command on device that support the Zoned Block "
18149"Commands (ZBC) or Zoned-device ATA Commands (ZAC). The zones to operate on "
18150"can be specified using the offset, count and length options.\n"
18151msgstr ""
18152
18153#. type: Title ===
18154#: ../sys-utils/blkzone.8.adoc:25
18155#, no-wrap
18156msgid "report"
18157msgstr ""
18158
18159#. type: Plain text
18160#: ../sys-utils/blkzone.8.adoc:28
18161msgid "The command *blkzone report* is used to report device zone information."
18162msgstr ""
18163
18164#. type: Plain text
18165#: ../sys-utils/blkzone.8.adoc:30
18166msgid ""
18167"By default, the command will report all zones from the start of the block "
18168"device. Options may be used to modify this behavior, changing the starting "
18169"zone or the size of the report, as explained below."
18170msgstr ""
18171
18172#. type: Plain text
18173#: ../sys-utils/blkzone.8.adoc:32
18174msgid "Report output:"
18175msgstr ""
18176
18177#. type: Table
18178#: ../sys-utils/blkzone.8.adoc:42
18179#, no-wrap
18180msgid ""
18181"|start |Zone start sector\n"
18182"|len |Zone length in number of sectors\n"
18183"|cap |Zone capacity in number of sectors\n"
18184"|wptr |Zone write pointer position\n"
18185"|reset |Reset write pointer recommended\n"
18186"|non-seq |Non-sequential write resources active\n"
18187"|cond |Zone condition\n"
18188"|type |Zone type\n"
18189msgstr ""
18190
18191#. type: Plain text
18192#: ../sys-utils/blkzone.8.adoc:45
18193msgid "Zone conditions:"
18194msgstr ""
18195
18196#. type: Table
18197#: ../sys-utils/blkzone.8.adoc:56
18198#, no-wrap
18199msgid ""
18200"|cl |Closed\n"
18201"|nw |Not write pointer\n"
18202"|em |Empty\n"
18203"|fu |Full\n"
18204"|oe |Explicitly opened\n"
18205"|oi |Implicitly opened\n"
18206"|ol |Offline\n"
18207"|ro |Read only\n"
18208"|x? |Reserved conditions (should not be reported)\n"
18209msgstr ""
18210
18211#. type: Title ===
18212#: ../sys-utils/blkzone.8.adoc:58
18213#, no-wrap
18214msgid "capacity"
18215msgstr ""
18216
18217#. type: Plain text
18218#: ../sys-utils/blkzone.8.adoc:61
18219msgid ""
18220"The command *blkzone capacity* is used to report device capacity "
18221"information."
18222msgstr ""
18223
18224#. type: Plain text
18225#: ../sys-utils/blkzone.8.adoc:63
18226msgid ""
18227"By default, the command will report the sum, in number of sectors, of all "
18228"zone capacities on the device. Options may be used to modify this behavior, "
18229"changing the starting zone or the size of the report, as explained below."
18230msgstr ""
18231
18232#. type: Title ===
18233#: ../sys-utils/blkzone.8.adoc:64
18234#, no-wrap
18235msgid "reset"
18236msgstr ""
18237
18238#. type: Plain text
18239#: ../sys-utils/blkzone.8.adoc:67
18240msgid ""
18241"The command *blkzone reset* is used to reset one or more zones. Unlike "
18242"*sg_reset_wp*(8), this command operates from the block layer and can reset a "
18243"range of zones."
18244msgstr ""
18245
18246#. type: Title ===
18247#: ../sys-utils/blkzone.8.adoc:68
18248#, no-wrap
18249msgid "open"
18250msgstr ""
18251
18252#. type: Plain text
18253#: ../sys-utils/blkzone.8.adoc:71
18254msgid ""
18255"The command *blkzone open* is used to explicitly open one or more "
18256"zones. Unlike *sg_zone*(8), open action, this command operates from the "
18257"block layer and can open a range of zones."
18258msgstr ""
18259
18260#. type: Title ===
18261#: ../sys-utils/blkzone.8.adoc:72
18262#, no-wrap
18263msgid "close"
18264msgstr ""
18265
18266#. type: Plain text
18267#: ../sys-utils/blkzone.8.adoc:75
18268msgid ""
18269"The command *blkzone close* is used to close one or more zones. Unlike "
18270"*sg_zone*(8), close action, this command operates from the block layer and "
18271"can close a range of zones."
18272msgstr ""
18273
18274#. type: Title ===
18275#: ../sys-utils/blkzone.8.adoc:76
18276#, no-wrap
18277msgid "finish"
18278msgstr ""
18279
18280#. type: Plain text
18281#: ../sys-utils/blkzone.8.adoc:79
18282msgid ""
18283"The command *blkzone finish* is used to finish (transition to full "
18284"condition) one or more zones. Unlike *sg_zone*(8), finish action, this "
18285"command operates from the block layer and can finish a range of zones."
18286msgstr ""
18287
18288#. type: Plain text
18289#: ../sys-utils/blkzone.8.adoc:81
18290msgid ""
18291"By default, the reset, open, close and finish commands will operate from the "
18292"zone at device sector 0 and operate on all zones. Options may be used to "
18293"modify this behavior as explained below."
18294msgstr ""
18295
18296#. type: Plain text
18297#: ../sys-utils/blkzone.8.adoc:85
18298msgid ""
18299"The _offset_ and _length_ option arguments may be followed by the "
18300"multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
18301"TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
18302"meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
18303"for GB, TB, PB, EB, ZB and YB. Additionally, the 0x prefix can be used to "
18304"specify _offset_ and _length_ in hex."
18305msgstr ""
18306
18307#. type: Labeled list
18308#: ../sys-utils/blkzone.8.adoc:86
18309#, no-wrap
18310msgid "*-o*, *--offset* _sector_"
18311msgstr ""
18312
18313#. type: Plain text
18314#: ../sys-utils/blkzone.8.adoc:88
18315msgid ""
18316"The starting zone specified as a sector offset. The provided offset in "
18317"sector units (512 bytes) should match the start of a zone. The default value "
18318"is zero."
18319msgstr ""
18320
18321#. type: Labeled list
18322#: ../sys-utils/blkzone.8.adoc:89
18323#, no-wrap
18324msgid "*-l*, *--length* _sectors_"
18325msgstr ""
18326
18327#. type: Plain text
18328#: ../sys-utils/blkzone.8.adoc:91
18329msgid ""
18330"The maximum number of sectors the command should operate on. The default "
18331"value is the number of sectors remaining after _offset_. This option cannot "
18332"be used together with the option *--count*."
18333msgstr ""
18334
18335#. type: Labeled list
18336#: ../sys-utils/blkzone.8.adoc:92
18337#, no-wrap
18338msgid "*-c*, *--count* _count_"
18339msgstr ""
18340
18341#. type: Plain text
18342#: ../sys-utils/blkzone.8.adoc:94
18343msgid ""
18344"The maximum number of zones the command should operate on. The default value "
18345"is the number of zones starting from _offset_. This option cannot be used "
18346"together with the option *--length*."
18347msgstr ""
18348
18349#. type: Plain text
18350#: ../sys-utils/blkzone.8.adoc:97
18351msgid "Enforce commands to change zone status on block devices used by the system."
18352msgstr ""
18353
18354#. type: Plain text
18355#: ../sys-utils/blkzone.8.adoc:100
18356msgid ""
18357"Display the number of zones returned in the report or the range of sectors "
18358"reset."
18359msgstr ""
18360
18361#. type: Plain text
18362#: ../sys-utils/blkzone.8.adoc:111
18363msgid "mailto:shaun@tancheff.com[Shaun Tancheff], mailto:kzak@redhat.com[Karel Zak]"
18364msgstr ""
18365
18366#. type: Plain text
18367#: ../sys-utils/blkzone.8.adoc:115
18368#, no-wrap
18369msgid "*sg_rep_zones*(8)\n"
18370msgstr ""
18371
18372#. type: Title =
18373#: ../sys-utils/chcpu.8.adoc:2
18374#, no-wrap
18375msgid "chcpu(8)"
18376msgstr ""
18377
18378#. type: Plain text
18379#: ../sys-utils/chcpu.8.adoc:12
18380msgid "chcpu - configure CPUs"
18381msgstr ""
18382
18383#. type: Plain text
18384#: ../sys-utils/chcpu.8.adoc:16
18385#, no-wrap
18386msgid "*chcpu* *-c*|*-d*|*-e*|*-g* _cpu-list_\n"
18387msgstr ""
18388
18389#. type: Plain text
18390#: ../sys-utils/chcpu.8.adoc:18
18391#, no-wrap
18392msgid "*chcpu* *-p* _mode_\n"
18393msgstr ""
18394
18395#. type: Plain text
18396#: ../sys-utils/chcpu.8.adoc:20
18397#, no-wrap
18398msgid "*chcpu* *-r*|*-h*|*-V*\n"
18399msgstr ""
18400
18401#. type: Plain text
18402#: ../sys-utils/chcpu.8.adoc:24
18403#, no-wrap
18404msgid ""
18405"*chcpu* can modify the state of CPUs. It can enable or disable CPUs, scan "
18406"for new CPUs, change the CPU dispatching _mode_ of the underlying "
18407"hypervisor, and request CPUs from the hypervisor (configure) or return CPUs "
18408"to the hypervisor (deconfigure).\n"
18409msgstr ""
18410
18411#. type: Plain text
18412#: ../sys-utils/chcpu.8.adoc:26
18413msgid ""
18414"Some options have a _cpu-list_ argument. Use this argument to specify a "
18415"comma-separated list of CPUs. The list can contain individual CPU addresses "
18416"or ranges of addresses. For example, *0,5,7,9-11* makes the command "
18417"applicable to the CPUs with the addresses 0, 5, 7, 9, 10, and 11."
18418msgstr ""
18419
18420#. type: Labeled list
18421#: ../sys-utils/chcpu.8.adoc:29
18422#, no-wrap
18423msgid "*-c*, *--configure* _cpu-list_"
18424msgstr ""
18425
18426#. type: Plain text
18427#: ../sys-utils/chcpu.8.adoc:31
18428msgid ""
18429"Configure the specified CPUs. Configuring a CPU means that the hypervisor "
18430"takes a CPU from the CPU pool and assigns it to the virtual hardware on "
18431"which your kernel runs."
18432msgstr ""
18433
18434#. type: Labeled list
18435#: ../sys-utils/chcpu.8.adoc:32
18436#, no-wrap
18437msgid "*-d*, *--disable* _cpu-list_"
18438msgstr ""
18439
18440#. type: Plain text
18441#: ../sys-utils/chcpu.8.adoc:34
18442msgid ""
18443"Disable the specified CPUs. Disabling a CPU means that the kernel sets it "
18444"offline."
18445msgstr ""
18446
18447#. type: Labeled list
18448#: ../sys-utils/chcpu.8.adoc:35
18449#, no-wrap
18450msgid "*-e*, *--enable* _cpu-list_"
18451msgstr ""
18452
18453#. type: Plain text
18454#: ../sys-utils/chcpu.8.adoc:37
18455msgid ""
18456"Enable the specified CPUs. Enabling a CPU means that the kernel sets it "
18457"online. A CPU must be configured, see *-c*, before it can be enabled."
18458msgstr ""
18459
18460#. type: Labeled list
18461#: ../sys-utils/chcpu.8.adoc:38
18462#, no-wrap
18463msgid "*-g*, *--deconfigure* _cpu-list_"
18464msgstr ""
18465
18466#. type: Plain text
18467#: ../sys-utils/chcpu.8.adoc:40
18468msgid ""
18469"Deconfigure the specified CPUs. Deconfiguring a CPU means that the "
18470"hypervisor removes the CPU from the virtual hardware on which the Linux "
18471"instance runs and returns it to the CPU pool. A CPU must be offline, see "
18472"*-d*, before it can be deconfigured."
18473msgstr ""
18474
18475#. type: Labeled list
18476#: ../sys-utils/chcpu.8.adoc:41
18477#, no-wrap
18478msgid "*-p*, *--dispatch* _mode_"
18479msgstr ""
18480
18481#. type: Plain text
18482#: ../sys-utils/chcpu.8.adoc:43
18483msgid ""
18484"Set the CPU dispatching _mode_ (polarization). This option has an effect "
18485"only if your hardware architecture and hypervisor support CPU "
18486"polarization. Available _modes_ are:"
18487msgstr ""
18488
18489#. type: Labeled list
18490#: ../sys-utils/chcpu.8.adoc:44 ../sys-utils/lscpu.1.adoc:71
18491#, no-wrap
18492msgid "*horizontal*"
18493msgstr ""
18494
18495#. type: Plain text
18496#: ../sys-utils/chcpu.8.adoc:46 ../sys-utils/lscpu.1.adoc:73
18497msgid "The workload is spread across all available CPUs."
18498msgstr ""
18499
18500#. type: Labeled list
18501#: ../sys-utils/chcpu.8.adoc:47 ../sys-utils/lscpu.1.adoc:73
18502#, no-wrap
18503msgid "*vertical*"
18504msgstr ""
18505
18506#. type: Plain text
18507#: ../sys-utils/chcpu.8.adoc:49 ../sys-utils/lscpu.1.adoc:75
18508msgid "The workload is concentrated on few CPUs."
18509msgstr ""
18510
18511#. type: Labeled list
18512#: ../sys-utils/chcpu.8.adoc:50
18513#, no-wrap
18514msgid "*-r*, *--rescan*"
18515msgstr ""
18516
18517#. type: Plain text
18518#: ../sys-utils/chcpu.8.adoc:52
18519msgid ""
18520"Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the "
18521"new CPUs. Use this option on systems that do not automatically detect newly "
18522"attached CPUs."
18523msgstr ""
18524
18525#. type: Plain text
18526#: ../sys-utils/chcpu.8.adoc:62
18527#, no-wrap
18528msgid "*chcpu* has the following exit status values:\n"
18529msgstr ""
18530
18531#. type: Plain text
18532#: ../sys-utils/chcpu.8.adoc:71 ../sys-utils/chmem.8.adoc:70
18533msgid "partial success"
18534msgstr ""
18535
18536#. type: Plain text
18537#: ../sys-utils/chcpu.8.adoc:75
18538msgid "mailto:heiko.carstens@de.ibm.com[Heiko Carstens]"
18539msgstr ""
18540
18541#. type: Plain text
18542#: ../sys-utils/chcpu.8.adoc:79
18543msgid "Copyright IBM Corp. 2011"
18544msgstr ""
18545
18546#. type: Plain text
18547#: ../sys-utils/chcpu.8.adoc:83
18548#, no-wrap
18549msgid "*lscpu*(1)\n"
18550msgstr ""
18551
18552#. type: Title =
18553#: ../sys-utils/chmem.8.adoc:2
18554#, no-wrap
18555msgid "chmem(8)"
18556msgstr ""
18557
18558#. type: Plain text
18559#: ../sys-utils/chmem.8.adoc:12
18560msgid "chmem - configure memory"
18561msgstr ""
18562
18563#. type: Plain text
18564#: ../sys-utils/chmem.8.adoc:16
18565#, no-wrap
18566msgid ""
18567"*chmem* [*-h] [*-V*] [*-v*] [*-e*|*-d*] [_SIZE_|_RANGE_ *-b* _BLOCKRANGE_] "
18568"[*-z* _ZONE_]\n"
18569msgstr ""
18570
18571#. type: Plain text
18572#: ../sys-utils/chmem.8.adoc:20
18573msgid ""
18574"The chmem command sets a particular size or range of memory online or "
18575"offline."
18576msgstr ""
18577
18578#. type: Plain text
18579#: ../sys-utils/chmem.8.adoc:22
18580msgid ""
18581"Specify _SIZE_ as <size>[m|M|g|G]. With m or M, <size> specifies the memory "
18582"size in MiB (1024 x 1024 bytes). With g or G, <size> specifies the memory "
18583"size in GiB (1024 x 1024 x 1024 bytes). The default unit is MiB."
18584msgstr ""
18585
18586#. type: Plain text
18587#: ../sys-utils/chmem.8.adoc:24
18588msgid ""
18589"Specify _RANGE_ in the form 0x<start>-0x<end> as shown in the output of the "
18590"*lsmem*(1) command. <start> is the hexadecimal address of the first byte and "
18591"<end> is the hexadecimal address of the last byte in the memory range."
18592msgstr ""
18593
18594#. type: Plain text
18595#: ../sys-utils/chmem.8.adoc:26
18596msgid ""
18597"Specify _BLOCKRANGE_ in the form <first>-<last> or <block> as shown in the "
18598"output of the *lsmem*(1) command. <first> is the number of the first memory "
18599"block and <last> is the number of the last memory block in the memory "
18600"range. Alternatively a single block can be specified. _BLOCKRANGE_ requires "
18601"the *--blocks* option."
18602msgstr ""
18603
18604#. type: Plain text
18605#: ../sys-utils/chmem.8.adoc:28
18606msgid ""
18607"Specify _ZONE_ as the name of a memory zone, as shown in the output of the "
18608"*lsmem -o +ZONES* command. The output shows one or more valid memory zones "
18609"for each memory range. If multiple zones are shown, then the memory range "
18610"currently belongs to the first zone. By default, *chmem* will set memory "
18611"online to the zone Movable, if this is among the valid zones. This default "
18612"can be changed by specifying the *--zone* option with another valid "
18613"zone. For memory ballooning, it is recommended to select the zone Movable "
18614"for memory online and offline, if possible. Memory in this zone is much more "
18615"likely to be able to be offlined again, but it cannot be used for arbitrary "
18616"kernel allocations, only for migratable pages (e.g., anonymous and page "
18617"cache pages). Use the *--help* option to see all available zones."
18618msgstr ""
18619
18620#. type: Plain text
18621#: ../sys-utils/chmem.8.adoc:30
18622msgid ""
18623"_SIZE_ and _RANGE_ must be aligned to the Linux memory block size, as shown "
18624"in the output of the *lsmem*(1) command."
18625msgstr ""
18626
18627#. type: Plain text
18628#: ../sys-utils/chmem.8.adoc:32
18629msgid ""
18630"Setting memory online can fail for various reasons. On virtualized systems "
18631"it can fail if the hypervisor does not have enough memory left, for example "
18632"because memory was overcommitted. Setting memory offline can fail if Linux "
18633"cannot free the memory. If only part of the requested memory can be set "
18634"online or offline, a message tells you how much memory was set online or "
18635"offline instead of the requested amount."
18636msgstr ""
18637
18638#. type: Plain text
18639#: ../sys-utils/chmem.8.adoc:34
18640msgid ""
18641"When setting memory online *chmem* starts with the lowest memory block "
18642"numbers. When setting memory offline *chmem* starts with the highest memory "
18643"block numbers."
18644msgstr ""
18645
18646#. type: Labeled list
18647#: ../sys-utils/chmem.8.adoc:37
18648#, no-wrap
18649msgid "*-b*, *--blocks*"
18650msgstr ""
18651
18652#. type: Plain text
18653#: ../sys-utils/chmem.8.adoc:39
18654msgid ""
18655"Use a _BLOCKRANGE_ parameter instead of _RANGE_ or _SIZE_ for the *--enable* "
18656"and *--disable* options."
18657msgstr ""
18658
18659#. type: Labeled list
18660#: ../sys-utils/chmem.8.adoc:40
18661#, no-wrap
18662msgid "*-d*, *--disable*"
18663msgstr ""
18664
18665#. type: Plain text
18666#: ../sys-utils/chmem.8.adoc:42
18667msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory offline."
18668msgstr ""
18669
18670#. type: Labeled list
18671#: ../sys-utils/chmem.8.adoc:43
18672#, no-wrap
18673msgid "*-e*, *--enable*"
18674msgstr ""
18675
18676#. type: Plain text
18677#: ../sys-utils/chmem.8.adoc:45
18678msgid "Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online."
18679msgstr ""
18680
18681#. type: Labeled list
18682#: ../sys-utils/chmem.8.adoc:46
18683#, no-wrap
18684msgid "*-z*, *--zone*"
18685msgstr ""
18686
18687#. type: Plain text
18688#: ../sys-utils/chmem.8.adoc:48
18689msgid ""
18690"Select the memory _ZONE_ where to set the specified _RANGE_, _SIZE_, or "
18691"_BLOCKRANGE_ of memory online or offline. By default, memory will be set "
18692"online to the zone Movable, if possible."
18693msgstr ""
18694
18695#. type: Plain text
18696#: ../sys-utils/chmem.8.adoc:51
18697msgid "Print a short help text, then exit."
18698msgstr ""
18699
18700#. type: Plain text
18701#: ../sys-utils/chmem.8.adoc:54
18702msgid ""
18703"Verbose mode. Causes *chmem* to print debugging messages about it's "
18704"progress."
18705msgstr ""
18706
18707#. type: Plain text
18708#: ../sys-utils/chmem.8.adoc:57
18709msgid "Print the version number, then exit."
18710msgstr ""
18711
18712#. type: Plain text
18713#: ../sys-utils/chmem.8.adoc:61
18714#, no-wrap
18715msgid "*chmem* has the following exit status values:\n"
18716msgstr ""
18717
18718#. type: Labeled list
18719#: ../sys-utils/chmem.8.adoc:73
18720#, no-wrap
18721msgid "*chmem --enable 1024*"
18722msgstr ""
18723
18724#. type: Plain text
18725#: ../sys-utils/chmem.8.adoc:75
18726msgid "This command requests 1024 MiB of memory to be set online."
18727msgstr ""
18728
18729#. type: Labeled list
18730#: ../sys-utils/chmem.8.adoc:76
18731#, no-wrap
18732msgid "*chmem -e 2g*"
18733msgstr ""
18734
18735#. type: Plain text
18736#: ../sys-utils/chmem.8.adoc:78
18737msgid "This command requests 2 GiB of memory to be set online."
18738msgstr ""
18739
18740#. type: Labeled list
18741#: ../sys-utils/chmem.8.adoc:79
18742#, no-wrap
18743msgid "*chmem --disable 0x00000000e4000000-0x00000000f3ffffff*"
18744msgstr ""
18745
18746#. type: Plain text
18747#: ../sys-utils/chmem.8.adoc:81
18748msgid ""
18749"This command requests the memory range starting with 0x00000000e4000000 and "
18750"ending with 0x00000000f3ffffff to be set offline."
18751msgstr ""
18752
18753#. type: Labeled list
18754#: ../sys-utils/chmem.8.adoc:82
18755#, no-wrap
18756msgid "*chmem -b -d 10*"
18757msgstr ""
18758
18759#. type: Plain text
18760#: ../sys-utils/chmem.8.adoc:84
18761msgid "This command requests the memory block number 10 to be set offline."
18762msgstr ""
18763
18764#. type: Plain text
18765#: ../sys-utils/chmem.8.adoc:88
18766#, no-wrap
18767msgid "*lsmem*(1)\n"
18768msgstr ""
18769
18770#. type: Title =
18771#: ../sys-utils/choom.1.adoc:2
18772#, no-wrap
18773msgid "choom(1)"
18774msgstr ""
18775
18776#. type: Plain text
18777#: ../sys-utils/choom.1.adoc:12
18778msgid "choom - display and adjust OOM-killer score."
18779msgstr ""
18780
18781#. type: Plain text
18782#: ../sys-utils/choom.1.adoc:14
18783#, no-wrap
18784msgid "*choom* *-p* _PID_\n"
18785msgstr ""
18786
18787#. type: Plain text
18788#: ../sys-utils/choom.1.adoc:16
18789#, no-wrap
18790msgid "*choom* *-p* _PID_ *-n* _number_\n"
18791msgstr ""
18792
18793#. type: Plain text
18794#: ../sys-utils/choom.1.adoc:18
18795#, no-wrap
18796msgid "*choom* *-n* _number_ [--] _command_ [_argument_ ...]\n"
18797msgstr ""
18798
18799#. type: Plain text
18800#: ../sys-utils/choom.1.adoc:22
18801msgid "The *choom* command displays and adjusts Out-Of-Memory killer score setting."
18802msgstr ""
18803
18804#. type: Plain text
18805#: ../sys-utils/choom.1.adoc:27
18806msgid "Specifies process ID."
18807msgstr ""
18808
18809#. type: Labeled list
18810#: ../sys-utils/choom.1.adoc:28
18811#, no-wrap
18812msgid "*-n*, *--adjust* _value_"
18813msgstr ""
18814
18815#. type: Plain text
18816#: ../sys-utils/choom.1.adoc:30
18817msgid "Specify the adjust score value."
18818msgstr ""
18819
18820#. type: Plain text
18821#: ../sys-utils/choom.1.adoc:40
18822msgid ""
18823"Linux kernel uses the badness heuristic to select which process gets killed "
18824"in out of memory conditions."
18825msgstr ""
18826
18827#. type: Plain text
18828#: ../sys-utils/choom.1.adoc:42
18829msgid ""
18830"The badness heuristic assigns a value to each candidate task ranging from 0 "
18831"(never kill) to 1000 (always kill) to determine which process is "
18832"targeted. The units are roughly a proportion along that range of allowed "
18833"memory the process may allocate from based on an estimation of its current "
18834"memory and swap use. For example, if a task is using all allowed memory, its "
18835"badness score will be 1000. If it is using half of its allowed memory, its "
18836"score will be 500."
18837msgstr ""
18838
18839#. type: Plain text
18840#: ../sys-utils/choom.1.adoc:44
18841msgid ""
18842"There is an additional factor included in the badness score: the current "
18843"memory and swap usage is discounted by 3% for root processes."
18844msgstr ""
18845
18846#. type: Plain text
18847#: ../sys-utils/choom.1.adoc:46
18848msgid ""
18849"The amount of \"allowed\" memory depends on the context in which the oom "
18850"killer was called. If it is due to the memory assigned to the allocating "
18851"task's cpuset being exhausted, the allowed memory represents the set of mems "
18852"assigned to that cpuset. If it is due to a mempolicy's node(s) being "
18853"exhausted, the allowed memory represents the set of mempolicy nodes. If it "
18854"is due to a memory limit (or swap limit) being reached, the allowed memory "
18855"is that configured limit. Finally, if it is due to the entire system being "
18856"out of memory, the allowed memory represents all allocatable resources."
18857msgstr ""
18858
18859#. type: Plain text
18860#: ../sys-utils/choom.1.adoc:48
18861msgid ""
18862"The adjust score value is added to the badness score before it is used to "
18863"determine which task to kill. Acceptable values range from -1000 to "
18864"+1000. This allows userspace to polarize the preference for oom killing "
18865"either by always preferring a certain task or completely disabling it. The "
18866"lowest possible value, -1000, is equivalent to disabling oom killing "
18867"entirely for that task since it will always report a badness score of 0."
18868msgstr ""
18869
18870#. type: Plain text
18871#: ../sys-utils/choom.1.adoc:50
18872msgid ""
18873"Setting an adjust score value of +500, for example, is roughly equivalent to "
18874"allowing the remainder of tasks sharing the same system, cpuset, mempolicy, "
18875"or memory controller resources to use at least 50% more memory. A value of "
18876"-500, on the other hand, would be roughly equivalent to discounting 50% of "
18877"the task's allowed memory from being considered as scoring against the task."
18878msgstr ""
18879
18880#. type: Plain text
18881#: ../sys-utils/choom.1.adoc:58
18882#, no-wrap
18883msgid "*proc*(5)\n"
18884msgstr ""
18885
18886#. Copyright 1992, 1993 Rickard E. Faith (faith@cs.unc.edu)
18887#. May be distributed under the GNU General Public License
18888#. type: Title =
18889#: ../sys-utils/ctrlaltdel.8.adoc:6
18890#, no-wrap
18891msgid "ctrlaltdel(8)"
18892msgstr ""
18893
18894#. type: Plain text
18895#: ../sys-utils/ctrlaltdel.8.adoc:16
18896msgid "ctrlaltdel - set the function of the Ctrl-Alt-Del combination"
18897msgstr ""
18898
18899#. type: Plain text
18900#: ../sys-utils/ctrlaltdel.8.adoc:20
18901#, no-wrap
18902msgid "*ctrlaltdel* *hard*|*soft*\n"
18903msgstr ""
18904
18905#. type: Plain text
18906#: ../sys-utils/ctrlaltdel.8.adoc:24
18907msgid ""
18908"Based on examination of the _linux/kernel/reboot.c_ code, it is clear that "
18909"there are two supported functions that the <Ctrl-Alt-Del> sequence can "
18910"perform."
18911msgstr ""
18912
18913#. type: Labeled list
18914#: ../sys-utils/ctrlaltdel.8.adoc:25
18915#, no-wrap
18916msgid "*hard*"
18917msgstr ""
18918
18919#. type: Plain text
18920#: ../sys-utils/ctrlaltdel.8.adoc:27
18921msgid ""
18922"Immediately reboot the computer without calling *sync*(2) and without any "
18923"other preparation. This is the default."
18924msgstr ""
18925
18926#. type: Labeled list
18927#: ../sys-utils/ctrlaltdel.8.adoc:28
18928#, no-wrap
18929msgid "*soft*"
18930msgstr ""
18931
18932#. type: Plain text
18933#: ../sys-utils/ctrlaltdel.8.adoc:30
18934msgid ""
18935"Make the kernel send the *SIGINT* (interrupt) signal to the *init* process "
18936"(this is always the process with PID 1). If this option is used, the "
18937"*init*(8) program must support this feature. Since there are now several "
18938"*init*(8) programs in the Linux community, please consult the documentation "
18939"for the version that you are currently using."
18940msgstr ""
18941
18942#. type: Plain text
18943#: ../sys-utils/ctrlaltdel.8.adoc:32
18944msgid ""
18945"When the command is run without any argument, it will display the current "
18946"setting."
18947msgstr ""
18948
18949#. type: Plain text
18950#: ../sys-utils/ctrlaltdel.8.adoc:34
18951msgid "The function of *ctrlaltdel* is usually set in the _/etc/rc.local_ file."
18952msgstr ""
18953
18954#. type: Plain text
18955#: ../sys-utils/ctrlaltdel.8.adoc:46
18956msgid "_/etc/rc.local_"
18957msgstr ""
18958
18959#. type: Plain text
18960#: ../sys-utils/ctrlaltdel.8.adoc:50
18961msgid "mailto:poe@daimi.aau.dk[Peter Orbaek]"
18962msgstr ""
18963
18964#. type: Plain text
18965#: ../sys-utils/ctrlaltdel.8.adoc:55
18966#, no-wrap
18967msgid ""
18968"*init*(8),\n"
18969"*systemd*(1)\n"
18970msgstr ""
18971
18972#. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
18973#. May be distributed under the GNU General Public License
18974#. type: Title =
18975#: ../sys-utils/dmesg.1.adoc:6
18976#, no-wrap
18977msgid "dmesg(1)"
18978msgstr ""
18979
18980#. type: Plain text
18981#: ../sys-utils/dmesg.1.adoc:16
18982msgid "dmesg - print or control the kernel ring buffer"
18983msgstr ""
18984
18985#. type: Plain text
18986#: ../sys-utils/dmesg.1.adoc:20
18987#, no-wrap
18988msgid "*dmesg* [options]\n"
18989msgstr ""
18990
18991#. type: Plain text
18992#: ../sys-utils/dmesg.1.adoc:22
18993#, no-wrap
18994msgid "*dmesg* *--clear*\n"
18995msgstr ""
18996
18997#. type: Plain text
18998#: ../sys-utils/dmesg.1.adoc:24
18999#, no-wrap
19000msgid "*dmesg* *--read-clear* [options]\n"
19001msgstr ""
19002
19003#. type: Plain text
19004#: ../sys-utils/dmesg.1.adoc:26
19005#, no-wrap
19006msgid "*dmesg* *--console-level* _level_\n"
19007msgstr ""
19008
19009#. type: Plain text
19010#: ../sys-utils/dmesg.1.adoc:28
19011#, no-wrap
19012msgid "*dmesg* *--console-on*\n"
19013msgstr ""
19014
19015#. type: Plain text
19016#: ../sys-utils/dmesg.1.adoc:30
19017#, no-wrap
19018msgid "*dmesg* *--console-off*\n"
19019msgstr ""
19020
19021#. type: Plain text
19022#: ../sys-utils/dmesg.1.adoc:34
19023#, no-wrap
19024msgid "*dmesg* is used to examine or control the kernel ring buffer.\n"
19025msgstr ""
19026
19027#. type: Plain text
19028#: ../sys-utils/dmesg.1.adoc:36
19029msgid "The default action is to display all messages from the kernel ring buffer."
19030msgstr ""
19031
19032#. type: Plain text
19033#: ../sys-utils/dmesg.1.adoc:40
19034msgid ""
19035"The *--clear*, *--read-clear*, *--console-on*, *--console-off*, and "
19036"*--console-level* options are mutually exclusive."
19037msgstr ""
19038
19039#. type: Labeled list
19040#: ../sys-utils/dmesg.1.adoc:41
19041#, no-wrap
19042msgid "*-C*, *--clear*"
19043msgstr ""
19044
19045#. type: Plain text
19046#: ../sys-utils/dmesg.1.adoc:43
19047msgid "Clear the ring buffer."
19048msgstr ""
19049
19050#. type: Labeled list
19051#: ../sys-utils/dmesg.1.adoc:44
19052#, no-wrap
19053msgid "*-c*, *--read-clear*"
19054msgstr ""
19055
19056#. type: Plain text
19057#: ../sys-utils/dmesg.1.adoc:46
19058msgid "Clear the ring buffer after first printing its contents."
19059msgstr ""
19060
19061#. type: Labeled list
19062#: ../sys-utils/dmesg.1.adoc:47
19063#, no-wrap
19064msgid "*-D*, *--console-off*"
19065msgstr ""
19066
19067#. type: Plain text
19068#: ../sys-utils/dmesg.1.adoc:49
19069msgid "Disable the printing of messages to the console."
19070msgstr ""
19071
19072#. type: Labeled list
19073#: ../sys-utils/dmesg.1.adoc:50
19074#, no-wrap
19075msgid "*-d*, *--show-delta*"
19076msgstr ""
19077
19078#. type: Plain text
19079#: ../sys-utils/dmesg.1.adoc:52
19080msgid ""
19081"Display the timestamp and the time delta spent between messages. If used "
19082"together with *--notime* then only the time delta without the timestamp is "
19083"printed."
19084msgstr ""
19085
19086#. type: Labeled list
19087#: ../sys-utils/dmesg.1.adoc:53
19088#, no-wrap
19089msgid "*-E*, *--console-on*"
19090msgstr ""
19091
19092#. type: Plain text
19093#: ../sys-utils/dmesg.1.adoc:55
19094msgid "Enable printing messages to the console."
19095msgstr ""
19096
19097#. type: Labeled list
19098#: ../sys-utils/dmesg.1.adoc:56
19099#, no-wrap
19100msgid "*-e*, *--reltime*"
19101msgstr ""
19102
19103#. type: Plain text
19104#: ../sys-utils/dmesg.1.adoc:58
19105msgid ""
19106"Display the local time and the delta in human-readable format. Be aware that "
19107"conversion to the local time could be inaccurate (see *-T* for more "
19108"details)."
19109msgstr ""
19110
19111#. type: Labeled list
19112#: ../sys-utils/dmesg.1.adoc:59
19113#, no-wrap
19114msgid "*-F*, *--file* _file_"
19115msgstr ""
19116
19117#. type: Plain text
19118#: ../sys-utils/dmesg.1.adoc:61
19119msgid ""
19120"Read the syslog messages from the given _file_. Note that *-F* does not "
19121"support messages in kmsg format. The old syslog format is supported only."
19122msgstr ""
19123
19124#. type: Labeled list
19125#: ../sys-utils/dmesg.1.adoc:62
19126#, no-wrap
19127msgid "*-f*, *--facility* _list_"
19128msgstr ""
19129
19130#. type: Plain text
19131#: ../sys-utils/dmesg.1.adoc:64
19132msgid ""
19133"Restrict output to the given (comma-separated) _list_ of facilities. For "
19134"example:"
19135msgstr ""
19136
19137#. type: Plain text
19138#: ../sys-utils/dmesg.1.adoc:66
19139#, no-wrap
19140msgid "*dmesg --facility=daemon*\n"
19141msgstr ""
19142
19143#. type: Plain text
19144#: ../sys-utils/dmesg.1.adoc:68
19145msgid ""
19146"will print messages from system daemons only. For all supported facilities "
19147"see the *--help* output."
19148msgstr ""
19149
19150#. type: Labeled list
19151#: ../sys-utils/dmesg.1.adoc:69
19152#, no-wrap
19153msgid "*-H*, *--human*"
19154msgstr ""
19155
19156#. type: Plain text
19157#: ../sys-utils/dmesg.1.adoc:71
19158msgid ""
19159"Enable human-readable output. See also *--color*, *--reltime* and "
19160"*--nopager*."
19161msgstr ""
19162
19163#. type: Plain text
19164#: ../sys-utils/dmesg.1.adoc:74
19165msgid "Print kernel messages."
19166msgstr ""
19167
19168#. type: Plain text
19169#: ../sys-utils/dmesg.1.adoc:77
19170msgid ""
19171"Colorize the output. The optional argument _when_ can be *auto*, *never* or "
19172"*always*. If the _when_ argument is omitted, it defaults to *auto*. The "
19173"colors can be disabled; for the current built-in default see the *--help* "
19174"output. See also the *COLORS* section below."
19175msgstr ""
19176
19177#. type: Labeled list
19178#: ../sys-utils/dmesg.1.adoc:78
19179#, no-wrap
19180msgid "*-l*, *--level* _list_"
19181msgstr ""
19182
19183#. type: Plain text
19184#: ../sys-utils/dmesg.1.adoc:80
19185msgid ""
19186"Restrict output to the given (comma-separated) _list_ of levels. For "
19187"example:"
19188msgstr ""
19189
19190#. type: Plain text
19191#: ../sys-utils/dmesg.1.adoc:82
19192#, no-wrap
19193msgid "*dmesg --level=err,warn*\n"
19194msgstr ""
19195
19196#. type: Plain text
19197#: ../sys-utils/dmesg.1.adoc:84
19198msgid ""
19199"will print error and warning messages only. For all supported levels see the "
19200"*--help* output."
19201msgstr ""
19202
19203#. type: Labeled list
19204#: ../sys-utils/dmesg.1.adoc:85
19205#, no-wrap
19206msgid "*-n*, *--console-level* _level_"
19207msgstr ""
19208
19209#. type: Plain text
19210#: ../sys-utils/dmesg.1.adoc:87
19211msgid ""
19212"Set the _level_ at which printing of messages is done to the console. The "
19213"_level_ is a level number or abbreviation of the level name. For all "
19214"supported levels see the *--help* output."
19215msgstr ""
19216
19217#. type: Plain text
19218#: ../sys-utils/dmesg.1.adoc:89
19219msgid ""
19220"For example, *-n 1* or *-n emerg* prevents all messages, except emergency "
19221"(panic) messages, from appearing on the console. All levels of messages are "
19222"still written to _/proc/kmsg_, so *syslogd*(8) can still be used to control "
19223"exactly where kernel messages appear. When the *-n* option is used, *dmesg* "
19224"will _not_ print or clear the kernel ring buffer."
19225msgstr ""
19226
19227#. type: Labeled list
19228#: ../sys-utils/dmesg.1.adoc:90
19229#, no-wrap
19230msgid "*--noescape*"
19231msgstr ""
19232
19233#. type: Plain text
19234#: ../sys-utils/dmesg.1.adoc:92
19235msgid ""
19236"The unprintable and potentially unsafe characters (e.g., broken multi-byte "
19237"sequences, terminal controlling chars, etc.) are escaped in format \\x<hex> "
19238"for security reason by default. This option disables this feature at "
19239"all. It's usable for example for debugging purpose together with *--raw*. Be "
19240"careful and don't use it by default."
19241msgstr ""
19242
19243#. type: Labeled list
19244#: ../sys-utils/dmesg.1.adoc:93
19245#, no-wrap
19246msgid "*-P*, *--nopager*"
19247msgstr ""
19248
19249#. type: Plain text
19250#: ../sys-utils/dmesg.1.adoc:95
19251msgid ""
19252"Do not pipe output into a pager. A pager is enabled by default for *--human* "
19253"output."
19254msgstr ""
19255
19256#. type: Labeled list
19257#: ../sys-utils/dmesg.1.adoc:96
19258#, no-wrap
19259msgid "*-p*, *--force-prefix*"
19260msgstr ""
19261
19262#. type: Plain text
19263#: ../sys-utils/dmesg.1.adoc:98
19264msgid ""
19265"Add facility, level or timestamp information to each line of a multi-line "
19266"message."
19267msgstr ""
19268
19269#. type: Plain text
19270#: ../sys-utils/dmesg.1.adoc:101
19271msgid ""
19272"Print the raw message buffer, i.e., do not strip the log-level prefixes, but "
19273"all unprintable characters are still escaped (see also *--noescape*)."
19274msgstr ""
19275
19276#. type: Plain text
19277#: ../sys-utils/dmesg.1.adoc:103
19278msgid ""
19279"Note that the real raw format depends on the method how *dmesg* reads kernel "
19280"messages. The _/dev/kmsg_ device uses a different format than "
19281"*syslog*(2). For backward compatibility, *dmesg* returns data always in the "
19282"*syslog*(2) format. It is possible to read the real raw data from "
19283"_/dev/kmsg_ by, for example, the command 'dd if=/dev/kmsg iflag=nonblock'."
19284msgstr ""
19285
19286#. type: Labeled list
19287#: ../sys-utils/dmesg.1.adoc:104
19288#, no-wrap
19289msgid "*-S*, *--syslog*"
19290msgstr ""
19291
19292#. type: Plain text
19293#: ../sys-utils/dmesg.1.adoc:106
19294msgid ""
19295"Force *dmesg* to use the *syslog*(2) kernel interface to read kernel "
19296"messages. The default is to use _/dev/kmsg_ rather than *syslog*(2) since "
19297"kernel 3.5.0."
19298msgstr ""
19299
19300#. type: Labeled list
19301#: ../sys-utils/dmesg.1.adoc:107
19302#, no-wrap
19303msgid "*-s*, *--buffer-size* _size_"
19304msgstr ""
19305
19306#. type: Plain text
19307#: ../sys-utils/dmesg.1.adoc:109
19308msgid ""
19309"Use a buffer of _size_ to query the kernel ring buffer. This is 16392 by "
19310"default. (The default kernel syslog buffer size was 4096 at first, 8192 "
19311"since 1.3.54, 16384 since 2.1.113.) If you have set the kernel buffer to be "
19312"larger than the default, then this option can be used to view the entire "
19313"buffer."
19314msgstr ""
19315
19316#. type: Labeled list
19317#: ../sys-utils/dmesg.1.adoc:110
19318#, no-wrap
19319msgid "*-T*, *--ctime*"
19320msgstr ""
19321
19322#. type: Plain text
19323#: ../sys-utils/dmesg.1.adoc:112
19324msgid "Print human-readable timestamps."
19325msgstr ""
19326
19327#. type: Plain text
19328#: ../sys-utils/dmesg.1.adoc:114
19329#, no-wrap
19330msgid ""
19331"*Be aware that the timestamp could be inaccurate!* The *time* source used "
19332"for the logs is *not updated after* system *SUSPEND*/*RESUME*. Timestamps "
19333"are adjusted according to current delta between boottime and monotonic "
19334"clocks, this works only for messages printed after last resume.\n"
19335msgstr ""
19336
19337#. type: Labeled list
19338#: ../sys-utils/dmesg.1.adoc:115
19339#, no-wrap
19340msgid "*--since* _time_"
19341msgstr ""
19342
19343#. type: Plain text
19344#: ../sys-utils/dmesg.1.adoc:117
19345msgid ""
19346"Display record since the specified time. The time is possible to specify in "
19347"absolute way as well as by relative notation (e.g. '1 hour ago'). Be aware "
19348"that the timestamp could be inaccurate and see *--ctime* for more details."
19349msgstr ""
19350
19351#. type: Labeled list
19352#: ../sys-utils/dmesg.1.adoc:118
19353#, no-wrap
19354msgid "*--until* _time_"
19355msgstr ""
19356
19357#. type: Plain text
19358#: ../sys-utils/dmesg.1.adoc:120
19359msgid ""
19360"Display record until the specified time. The time is possible to specify in "
19361"absolute way as well as by relative notation (e.g. '1 hour ago'). Be aware "
19362"that the timestamp could be inaccurate and see *--ctime* for more details."
19363msgstr ""
19364
19365#. type: Labeled list
19366#: ../sys-utils/dmesg.1.adoc:121
19367#, no-wrap
19368msgid "*-t*, *--notime*"
19369msgstr ""
19370
19371#. type: Plain text
19372#: ../sys-utils/dmesg.1.adoc:123
19373msgid "Do not print kernel's timestamps."
19374msgstr ""
19375
19376#. type: Plain text
19377#: ../sys-utils/dmesg.1.adoc:126
19378msgid ""
19379"Print timestamps using the given _format_, which can be *ctime*, *reltime*, "
19380"*delta* or *iso*. The first three formats are aliases of the "
19381"time-format-specific options. The *iso* format is a *dmesg* implementation "
19382"of the ISO-8601 timestamp format. The purpose of this format is to make the "
19383"comparing of timestamps between two systems, and any other parsing, "
19384"easy. The definition of the *iso* timestamp is: "
19385"YYYY-MM-DD<T>HH:MM:SS,<microseconds><-+><timezone offset from UTC>."
19386msgstr ""
19387
19388#. type: Plain text
19389#: ../sys-utils/dmesg.1.adoc:128
19390msgid ""
19391"The *iso* format has the same issue as *ctime*: the time may be inaccurate "
19392"when a system is suspended and resumed."
19393msgstr ""
19394
19395#. type: Labeled list
19396#: ../sys-utils/dmesg.1.adoc:129
19397#, no-wrap
19398msgid "*-u*, *--userspace*"
19399msgstr ""
19400
19401#. type: Plain text
19402#: ../sys-utils/dmesg.1.adoc:131
19403msgid "Print userspace messages."
19404msgstr ""
19405
19406#. type: Labeled list
19407#: ../sys-utils/dmesg.1.adoc:132
19408#, no-wrap
19409msgid "*-w*, *--follow*"
19410msgstr ""
19411
19412#. type: Plain text
19413#: ../sys-utils/dmesg.1.adoc:134
19414msgid ""
19415"Wait for new messages. This feature is supported only on systems with a "
19416"readable _/dev/kmsg_ (since kernel 3.5.0)."
19417msgstr ""
19418
19419#. type: Labeled list
19420#: ../sys-utils/dmesg.1.adoc:135
19421#, no-wrap
19422msgid "*-W*, *--follow-new*"
19423msgstr ""
19424
19425#. type: Plain text
19426#: ../sys-utils/dmesg.1.adoc:137
19427msgid "Wait and print only new messages."
19428msgstr ""
19429
19430#. type: Labeled list
19431#: ../sys-utils/dmesg.1.adoc:138
19432#, no-wrap
19433msgid "*-x*, *--decode*"
19434msgstr ""
19435
19436#. type: Plain text
19437#: ../sys-utils/dmesg.1.adoc:140
19438msgid "Decode facility and level (priority) numbers to human-readable prefixes."
19439msgstr ""
19440
19441#. type: Plain text
19442#: ../sys-utils/dmesg.1.adoc:150
19443msgid ""
19444"Implicit coloring can be disabled by an empty file "
19445"_/etc/terminal-colors.d/dmesg.disable_. See *terminal-colors.d*(5) for more "
19446"details about colorization configuration."
19447msgstr ""
19448
19449#. type: Plain text
19450#: ../sys-utils/dmesg.1.adoc:152
19451msgid "The logical color names supported by *dmesg* are:"
19452msgstr ""
19453
19454#. type: Labeled list
19455#: ../sys-utils/dmesg.1.adoc:153
19456#, no-wrap
19457msgid "*subsys*"
19458msgstr ""
19459
19460#. type: Plain text
19461#: ../sys-utils/dmesg.1.adoc:155
19462msgid "The message sub-system prefix (e.g., \"ACPI:\")."
19463msgstr ""
19464
19465#. type: Labeled list
19466#: ../sys-utils/dmesg.1.adoc:156
19467#, no-wrap
19468msgid "*time*"
19469msgstr ""
19470
19471#. type: Plain text
19472#: ../sys-utils/dmesg.1.adoc:158
19473msgid "The message timestamp."
19474msgstr ""
19475
19476#. type: Labeled list
19477#: ../sys-utils/dmesg.1.adoc:159
19478#, no-wrap
19479msgid "*timebreak*"
19480msgstr ""
19481
19482#. type: Plain text
19483#: ../sys-utils/dmesg.1.adoc:161
19484msgid ""
19485"The message timestamp in short ctime format in *--reltime* or *--human* "
19486"output."
19487msgstr ""
19488
19489#. type: Labeled list
19490#: ../sys-utils/dmesg.1.adoc:162
19491#, no-wrap
19492msgid "*alert*"
19493msgstr ""
19494
19495#. type: Plain text
19496#: ../sys-utils/dmesg.1.adoc:164
19497msgid "The text of the message with the alert log priority."
19498msgstr ""
19499
19500#. type: Labeled list
19501#: ../sys-utils/dmesg.1.adoc:165
19502#, no-wrap
19503msgid "*crit*"
19504msgstr ""
19505
19506#. type: Plain text
19507#: ../sys-utils/dmesg.1.adoc:167
19508msgid "The text of the message with the critical log priority."
19509msgstr ""
19510
19511#. type: Labeled list
19512#: ../sys-utils/dmesg.1.adoc:168
19513#, no-wrap
19514msgid "*err*"
19515msgstr ""
19516
19517#. type: Plain text
19518#: ../sys-utils/dmesg.1.adoc:170
19519msgid "The text of the message with the error log priority."
19520msgstr ""
19521
19522#. type: Plain text
19523#: ../sys-utils/dmesg.1.adoc:173
19524msgid "The text of the message with the warning log priority."
19525msgstr ""
19526
19527#. type: Labeled list
19528#: ../sys-utils/dmesg.1.adoc:174
19529#, no-wrap
19530msgid "*segfault*"
19531msgstr ""
19532
19533#. type: Plain text
19534#: ../sys-utils/dmesg.1.adoc:176
19535msgid "The text of the message that inform about segmentation fault."
19536msgstr ""
19537
19538#. type: Plain text
19539#: ../sys-utils/dmesg.1.adoc:180
19540#, no-wrap
19541msgid ""
19542"*dmesg* can fail reporting permission denied error. This is usually caused "
19543"by *dmesg_restrict* kernel setting, please see *syslog*(2) for more "
19544"details.\n"
19545msgstr ""
19546
19547#. type: Plain text
19548#: ../sys-utils/dmesg.1.adoc:186
19549#, no-wrap
19550msgid ""
19551"*dmesg* was originally written by mailto:tytso@athena.mit.edu[Theodore "
19552"Ts'o].\n"
19553msgstr ""
19554
19555#. type: Plain text
19556#: ../sys-utils/dmesg.1.adoc:191
19557#, no-wrap
19558msgid ""
19559"*terminal-colors.d*(5),\n"
19560"*syslogd*(8)\n"
19561msgstr ""
19562
19563#. Copyright (C) 1994-2005 Jeff Tranter (tranter@pobox.com)
19564#. Copyright (C) 2012 Karel Zak <kzak@redhat.com>.
19565#
19566#. It may be distributed under the GNU Public License, version 2, or
19567#. any higher version. See section COPYING of the GNU Public license
19568#. for conditions under which this file may be redistributed.
19569#. type: Title =
19570#: ../sys-utils/eject.1.adoc:10
19571#, no-wrap
19572msgid "eject(1)"
19573msgstr ""
19574
19575#. type: Plain text
19576#: ../sys-utils/eject.1.adoc:20
19577msgid "eject - eject removable media"
19578msgstr ""
19579
19580#. type: Plain text
19581#: ../sys-utils/eject.1.adoc:22
19582#, no-wrap
19583msgid "*eject* [options] _device_|_mountpoint_\n"
19584msgstr ""
19585
19586#. type: Plain text
19587#: ../sys-utils/eject.1.adoc:26
19588#, no-wrap
19589msgid ""
19590"*eject* allows removable media (typically a CD-ROM, floppy disk, tape, JAZ, "
19591"ZIP or USB disk) to be ejected under software control. The command can also "
19592"control some multi-disc CD-ROM changers, the auto-eject feature supported by "
19593"some devices, and close the disc tray of some CD-ROM drives.\n"
19594msgstr ""
19595
19596#. type: Plain text
19597#: ../sys-utils/eject.1.adoc:28
19598msgid ""
19599"The device corresponding to _device_ or _mountpoint_ is ejected. If no name "
19600"is specified, the default name */dev/cdrom* is used. The device may be "
19601"addressed by device name (e.g., 'sda'), device path (e.g., '/dev/sda'), "
19602"UUID=__uuid__ or LABEL=__label__ tags."
19603msgstr ""
19604
19605#. type: Plain text
19606#: ../sys-utils/eject.1.adoc:30
19607msgid ""
19608"There are four different methods of ejecting, depending on whether the "
19609"device is a CD-ROM, SCSI device, removable floppy, or tape. By default "
19610"*eject* tries all four methods in order until it succeeds."
19611msgstr ""
19612
19613#. type: Plain text
19614#: ../sys-utils/eject.1.adoc:32
19615msgid "If a device partition is specified, the whole-disk device is used."
19616msgstr ""
19617
19618#. type: Plain text
19619#: ../sys-utils/eject.1.adoc:34
19620msgid ""
19621"If the device or a device partition is currently mounted, it is unmounted "
19622"before ejecting. The eject is processed on exclusive open block device file "
19623"descriptor if *--no-unmount* or *--force* are not specified."
19624msgstr ""
19625
19626#. type: Labeled list
19627#: ../sys-utils/eject.1.adoc:37
19628#, no-wrap
19629msgid "*-a*, **--auto on**|*off*"
19630msgstr ""
19631
19632#. type: Plain text
19633#: ../sys-utils/eject.1.adoc:39
19634msgid ""
19635"This option controls the auto-eject mode, supported by some devices. When "
19636"enabled, the drive automatically ejects when the device is closed."
19637msgstr ""
19638
19639#. type: Labeled list
19640#: ../sys-utils/eject.1.adoc:40
19641#, no-wrap
19642msgid "*-c*, *--changerslot* _slot_"
19643msgstr ""
19644
19645#. type: Plain text
19646#: ../sys-utils/eject.1.adoc:42
19647msgid ""
19648"With this option a CD slot can be selected from an ATAPI/IDE CD-ROM "
19649"changer. The CD-ROM drive cannot be in use (mounted data CD or playing a "
19650"music CD) for a change request to work. Please also note that the first slot "
19651"of the changer is referred to as 0, not 1."
19652msgstr ""
19653
19654#. type: Labeled list
19655#: ../sys-utils/eject.1.adoc:43
19656#, no-wrap
19657msgid "*-d*, *--default*"
19658msgstr ""
19659
19660#. type: Plain text
19661#: ../sys-utils/eject.1.adoc:45
19662msgid "List the default device name."
19663msgstr ""
19664
19665#. type: Labeled list
19666#: ../sys-utils/eject.1.adoc:46
19667#, no-wrap
19668msgid "*-F*, *--force*"
19669msgstr ""
19670
19671#. type: Plain text
19672#: ../sys-utils/eject.1.adoc:48
19673msgid ""
19674"Force eject, don't check device type, don't open device with exclusive "
19675"lock. The successful result may be false positive on non hot-pluggable "
19676"devices."
19677msgstr ""
19678
19679#. type: Labeled list
19680#: ../sys-utils/eject.1.adoc:49
19681#, no-wrap
19682msgid "*-f*, *--floppy*"
19683msgstr ""
19684
19685#. type: Plain text
19686#: ../sys-utils/eject.1.adoc:51
19687msgid ""
19688"This option specifies that the drive should be ejected using a removable "
19689"floppy disk eject command."
19690msgstr ""
19691
19692#. type: Labeled list
19693#: ../sys-utils/eject.1.adoc:55
19694#, no-wrap
19695msgid "*-i*, **--manualeject on**|*off*"
19696msgstr ""
19697
19698#. type: Plain text
19699#: ../sys-utils/eject.1.adoc:57
19700msgid ""
19701"This option controls locking of the hardware eject button. When enabled, the "
19702"drive will not be ejected when the button is pressed. This is useful when "
19703"you are carrying a laptop in a bag or case and don't want it to eject if the "
19704"button is inadvertently pressed."
19705msgstr ""
19706
19707#. type: Labeled list
19708#: ../sys-utils/eject.1.adoc:58
19709#, no-wrap
19710msgid "*-M*, *--no-partitions-unmount*"
19711msgstr ""
19712
19713#. type: Plain text
19714#: ../sys-utils/eject.1.adoc:60
19715msgid ""
19716"The option tells eject to not try to unmount other partitions on partitioned "
19717"devices. If another partition is still mounted, the program will not attempt "
19718"to eject the media. It will attempt to unmount only the device or mountpoint "
19719"given on the command line."
19720msgstr ""
19721
19722#. type: Labeled list
19723#: ../sys-utils/eject.1.adoc:61
19724#, no-wrap
19725msgid "*-m*, *--no-unmount*"
19726msgstr ""
19727
19728#. type: Plain text
19729#: ../sys-utils/eject.1.adoc:63
19730msgid ""
19731"The option tells eject to not try to unmount at all. If this option is not "
19732"specified than *eject* opens the device with *O_EXCL* flag to be sure that "
19733"the device is not used (since v2.35)."
19734msgstr ""
19735
19736#. type: Labeled list
19737#: ../sys-utils/eject.1.adoc:64
19738#, no-wrap
19739msgid "*-n*, *--noop*"
19740msgstr ""
19741
19742#. type: Plain text
19743#: ../sys-utils/eject.1.adoc:66
19744msgid ""
19745"With this option the selected device is displayed but no action is "
19746"performed."
19747msgstr ""
19748
19749#. type: Labeled list
19750#: ../sys-utils/eject.1.adoc:67
19751#, no-wrap
19752msgid "*-p*, *--proc*"
19753msgstr ""
19754
19755#. type: Plain text
19756#: ../sys-utils/eject.1.adoc:69
19757msgid ""
19758"This option allows you to use _/proc/mounts_ instead _/etc/mtab_. It also "
19759"passes the *-n* option to *umount*(8)."
19760msgstr ""
19761
19762#. type: Labeled list
19763#: ../sys-utils/eject.1.adoc:70
19764#, no-wrap
19765msgid "*-q*, *--tape*"
19766msgstr ""
19767
19768#. type: Plain text
19769#: ../sys-utils/eject.1.adoc:72
19770msgid ""
19771"This option specifies that the drive should be ejected using a tape drive "
19772"offline command."
19773msgstr ""
19774
19775#. type: Labeled list
19776#: ../sys-utils/eject.1.adoc:73
19777#, no-wrap
19778msgid "*-r*, *--cdrom*"
19779msgstr ""
19780
19781#. type: Plain text
19782#: ../sys-utils/eject.1.adoc:75
19783msgid ""
19784"This option specifies that the drive should be ejected using a CDROM eject "
19785"command."
19786msgstr ""
19787
19788#. type: Labeled list
19789#: ../sys-utils/eject.1.adoc:76
19790#, no-wrap
19791msgid "*-s*, *--scsi*"
19792msgstr ""
19793
19794#. type: Plain text
19795#: ../sys-utils/eject.1.adoc:78
19796msgid "This option specifies that the drive should be ejected using SCSI commands."
19797msgstr ""
19798
19799#. type: Labeled list
19800#: ../sys-utils/eject.1.adoc:79
19801#, no-wrap
19802msgid "*-T*, *--traytoggle*"
19803msgstr ""
19804
19805#. type: Plain text
19806#: ../sys-utils/eject.1.adoc:81
19807msgid ""
19808"With this option the drive is given a CD-ROM tray close command if it's "
19809"opened, and a CD-ROM tray eject command if it's closed. Not all devices "
19810"support this command, because it uses the above CD-ROM tray close command."
19811msgstr ""
19812
19813#. type: Labeled list
19814#: ../sys-utils/eject.1.adoc:82
19815#, no-wrap
19816msgid "*-t*, *--trayclose*"
19817msgstr ""
19818
19819#. type: Plain text
19820#: ../sys-utils/eject.1.adoc:84
19821msgid ""
19822"With this option the drive is given a CD-ROM tray close command. Not all "
19823"devices support this command."
19824msgstr ""
19825
19826#. type: Plain text
19827#: ../sys-utils/eject.1.adoc:90
19828msgid ""
19829"Run in verbose mode; more information is displayed about what the command is "
19830"doing."
19831msgstr ""
19832
19833#. type: Labeled list
19834#: ../sys-utils/eject.1.adoc:91
19835#, no-wrap
19836msgid "*-X*, *--listspeed*"
19837msgstr ""
19838
19839#. type: Plain text
19840#: ../sys-utils/eject.1.adoc:93
19841msgid ""
19842"With this option the CD-ROM drive will be probed to detect the available "
19843"speeds. The output is a list of speeds which can be used as an argument of "
19844"the *-x* option. This only works with Linux 2.6.13 or higher, on previous "
19845"versions solely the maximum speed will be reported. Also note that some "
19846"drives may not correctly report the speed and therefore this option does not "
19847"work with them."
19848msgstr ""
19849
19850#. type: Labeled list
19851#: ../sys-utils/eject.1.adoc:94
19852#, no-wrap
19853msgid "*-x*, *--cdspeed* _speed_"
19854msgstr ""
19855
19856#. type: Plain text
19857#: ../sys-utils/eject.1.adoc:96
19858msgid ""
19859"With this option the drive is given a CD-ROM select speed command. The "
19860"_speed_ argument is a number indicating the desired speed (e.g., 8 for 8X "
19861"speed), or 0 for maximum data rate. Not all devices support this command and "
19862"you can only specify speeds that the drive is capable of. Every time the "
19863"media is changed this option is cleared. This option can be used alone, or "
19864"with the *-t* and *-c* options."
19865msgstr ""
19866
19867#. type: Plain text
19868#: ../sys-utils/eject.1.adoc:104
19869#, no-wrap
19870msgid ""
19871"*eject* only works with devices that support one or more of the four methods "
19872"of ejecting. This includes most CD-ROM drives (IDE, SCSI, and proprietary), "
19873"some SCSI tape drives, JAZ drives, ZIP drives (parallel port, SCSI, and IDE "
19874"versions), and LS120 removable floppies. Users have also reported success "
19875"with floppy drives on Sun SPARC and Apple Macintosh systems. If *eject* does "
19876"not work, it is most likely a limitation of the kernel driver for the device "
19877"and not the *eject* program itself.\n"
19878msgstr ""
19879
19880#. type: Plain text
19881#: ../sys-utils/eject.1.adoc:106
19882msgid ""
19883"The *-r*, *-s*, *-f*, and *-q* options allow controlling which methods are "
19884"used to eject. More than one method can be specified. If none of these "
19885"options are specified, it tries all four (this works fine in most cases)."
19886msgstr ""
19887
19888#. type: Plain text
19889#: ../sys-utils/eject.1.adoc:108
19890#, no-wrap
19891msgid ""
19892"*eject* may not always be able to determine if the device is mounted (e.g., "
19893"if it has several names). If the device name is a symbolic link, *eject* "
19894"will follow the link and use the device that it points to.\n"
19895msgstr ""
19896
19897#. type: Plain text
19898#: ../sys-utils/eject.1.adoc:110
19899msgid ""
19900"If *eject* determines that the device can have multiple partitions, it will "
19901"attempt to unmount all mounted partitions of the device before ejecting (see "
19902"also *--no-partitions-unmount*). If an unmount fails, the program will not "
19903"attempt to eject the media."
19904msgstr ""
19905
19906#. type: Plain text
19907#: ../sys-utils/eject.1.adoc:112
19908msgid ""
19909"You can eject an audio CD. Some CD-ROM drives will refuse to open the tray "
19910"if the drive is empty. Some devices do not support the tray close command."
19911msgstr ""
19912
19913#. type: Plain text
19914#: ../sys-utils/eject.1.adoc:114
19915msgid ""
19916"If the auto-eject feature is enabled, then the drive will always be ejected "
19917"after running this command. Not all Linux kernel CD-ROM drivers support the "
19918"auto-eject mode. There is no way to find out the state of the auto-eject "
19919"mode."
19920msgstr ""
19921
19922#. type: Plain text
19923#: ../sys-utils/eject.1.adoc:116
19924msgid ""
19925"You need appropriate privileges to access the device files. Running as root "
19926"is required to eject some devices (e.g., SCSI devices)."
19927msgstr ""
19928
19929#. type: Plain text
19930#: ../sys-utils/eject.1.adoc:120
19931msgid ""
19932"mailto:tranter@pobox.com[Jeff Tranter] - original author, "
19933"mailto:kzak@redhat.com[Karel Zak] and mailto:mluscon@redhat.com[Michal "
19934"Luscon] - util-linux version."
19935msgstr ""
19936
19937#. type: Plain text
19938#: ../sys-utils/eject.1.adoc:127
19939#, no-wrap
19940msgid ""
19941"*findmnt*(8),\n"
19942"*lsblk*(8),\n"
19943"*mount*(8),\n"
19944"*umount*(8)\n"
19945msgstr ""
19946
19947#. type: Title =
19948#: ../sys-utils/fallocate.1.adoc:2
19949#, no-wrap
19950msgid "fallocate(1)"
19951msgstr ""
19952
19953#. type: Plain text
19954#: ../sys-utils/fallocate.1.adoc:12
19955msgid "fallocate - preallocate or deallocate space to a file"
19956msgstr ""
19957
19958#. type: Plain text
19959#: ../sys-utils/fallocate.1.adoc:16
19960#, no-wrap
19961msgid ""
19962"*fallocate* [*-c*|*-p*|*-z*] [*-o* _offset_] *-l* _length_ [*-n*] "
19963"_filename_\n"
19964msgstr ""
19965
19966#. type: Plain text
19967#: ../sys-utils/fallocate.1.adoc:18
19968#, no-wrap
19969msgid "*fallocate* *-d* [*-o* _offset_] [*-l* _length_] _filename_\n"
19970msgstr ""
19971
19972#. type: Plain text
19973#: ../sys-utils/fallocate.1.adoc:20
19974#, no-wrap
19975msgid "*fallocate* *-x* [*-o* _offset_] *-l* _length filename_\n"
19976msgstr ""
19977
19978#. type: Plain text
19979#: ../sys-utils/fallocate.1.adoc:24
19980#, no-wrap
19981msgid ""
19982"*fallocate* is used to manipulate the allocated disk space for a file, "
19983"either to deallocate or preallocate it. For filesystems which support the "
19984"fallocate system call, preallocation is done quickly by allocating blocks "
19985"and marking them as uninitialized, requiring no IO to the data blocks. This "
19986"is much faster than creating a file by filling it with zeroes.\n"
19987msgstr ""
19988
19989#. type: Plain text
19990#: ../sys-utils/fallocate.1.adoc:26
19991msgid "The exit status returned by *fallocate* is 0 on success and 1 on failure."
19992msgstr ""
19993
19994#. type: Plain text
19995#: ../sys-utils/fallocate.1.adoc:30
19996msgid ""
19997"The _length_ and _offset_ arguments may be followed by the multiplicative "
19998"suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
19999"ZiB, and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
20000"\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
20001"PB, EB, ZB, and YB."
20002msgstr ""
20003
20004#. type: Plain text
20005#: ../sys-utils/fallocate.1.adoc:32
20006msgid ""
20007"The options *--collapse-range*, *--dig-holes*, *--punch-hole*, and "
20008"*--zero-range* are mutually exclusive."
20009msgstr ""
20010
20011#. type: Labeled list
20012#: ../sys-utils/fallocate.1.adoc:33
20013#, no-wrap
20014msgid "*-c*, *--collapse-range*"
20015msgstr ""
20016
20017#. type: Plain text
20018#: ../sys-utils/fallocate.1.adoc:35
20019msgid ""
20020"Removes a byte range from a file, without leaving a hole. The byte range to "
20021"be collapsed starts at _offset_ and continues for _length_ bytes. At the "
20022"completion of the operation, the contents of the file starting at the "
20023"location __offset__+_length_ will be appended at the location _offset_, and "
20024"the file will be _length_ bytes smaller. The option *--keep-size* may not be "
20025"specified for the collapse-range operation."
20026msgstr ""
20027
20028#. type: Plain text
20029#: ../sys-utils/fallocate.1.adoc:37
20030msgid "Available since Linux 3.15 for ext4 (only for extent-based files) and XFS."
20031msgstr ""
20032
20033#. type: Plain text
20034#: ../sys-utils/fallocate.1.adoc:39
20035msgid ""
20036"A filesystem may place limitations on the granularity of the operation, in "
20037"order to ensure efficient implementation. Typically, offset and len must be "
20038"a multiple of the filesystem logical block size, which varies according to "
20039"the filesystem type and configuration. If a filesystem has such a "
20040"requirement, the operation will fail with the error EINVAL if this "
20041"requirement is violated."
20042msgstr ""
20043
20044#. type: Labeled list
20045#: ../sys-utils/fallocate.1.adoc:40
20046#, no-wrap
20047msgid "*-d*, *--dig-holes*"
20048msgstr ""
20049
20050#. type: Plain text
20051#: ../sys-utils/fallocate.1.adoc:42
20052msgid ""
20053"Detect and dig holes. This makes the file sparse in-place, without using "
20054"extra disk space. The minimum size of the hole depends on filesystem I/O "
20055"block size (usually 4096 bytes). Also, when using this option, *--keep-size* "
20056"is implied. If no range is specified by *--offset* and *--length*, then the "
20057"entire file is analyzed for holes."
20058msgstr ""
20059
20060#. type: Plain text
20061#: ../sys-utils/fallocate.1.adoc:44
20062msgid ""
20063"You can think of this option as doing a \"*cp --sparse*\" and then renaming "
20064"the destination file to the original, without the need for extra disk space."
20065msgstr ""
20066
20067#. type: Plain text
20068#: ../sys-utils/fallocate.1.adoc:46
20069msgid "See *--punch-hole* for a list of supported filesystems."
20070msgstr ""
20071
20072#. type: Labeled list
20073#: ../sys-utils/fallocate.1.adoc:47
20074#, no-wrap
20075msgid "*-i*, *--insert-range*"
20076msgstr ""
20077
20078#. type: Plain text
20079#: ../sys-utils/fallocate.1.adoc:49
20080msgid "Insert a hole of _length_ bytes from _offset_, shifting existing data."
20081msgstr ""
20082
20083#. type: Plain text
20084#: ../sys-utils/fallocate.1.adoc:52
20085msgid "Specifies the length of the range, in bytes."
20086msgstr ""
20087
20088#. type: Labeled list
20089#: ../sys-utils/fallocate.1.adoc:53
20090#, no-wrap
20091msgid "*-n*, *--keep-size*"
20092msgstr ""
20093
20094#. type: Plain text
20095#: ../sys-utils/fallocate.1.adoc:55
20096msgid ""
20097"Do not modify the apparent length of the file. This may effectively allocate "
20098"blocks past EOF, which can be removed with a truncate."
20099msgstr ""
20100
20101#. type: Plain text
20102#: ../sys-utils/fallocate.1.adoc:58
20103msgid "Specifies the beginning offset of the range, in bytes."
20104msgstr ""
20105
20106#. type: Labeled list
20107#: ../sys-utils/fallocate.1.adoc:59
20108#, no-wrap
20109msgid "*-p*, *--punch-hole*"
20110msgstr ""
20111
20112#. type: Plain text
20113#: ../sys-utils/fallocate.1.adoc:61
20114msgid ""
20115"Deallocates space (i.e., creates a hole) in the byte range starting at "
20116"_offset_ and continuing for _length_ bytes. Within the specified range, "
20117"partial filesystem blocks are zeroed, and whole filesystem blocks are "
20118"removed from the file. After a successful call, subsequent reads from this "
20119"range will return zeroes. This option may not be specified at the same time "
20120"as the *--zero-range* option. Also, when using this option, *--keep-size* is "
20121"implied."
20122msgstr ""
20123
20124#. type: Plain text
20125#: ../sys-utils/fallocate.1.adoc:63
20126msgid ""
20127"Supported for XFS (since Linux 2.6.38), ext4 (since Linux 3.0), Btrfs (since "
20128"Linux 3.7), tmpfs (since Linux 3.5) and gfs2 (since Linux 4.16)."
20129msgstr ""
20130
20131#. type: Plain text
20132#: ../sys-utils/fallocate.1.adoc:66
20133msgid "Enable verbose mode."
20134msgstr ""
20135
20136#. type: Labeled list
20137#: ../sys-utils/fallocate.1.adoc:67
20138#, no-wrap
20139msgid "*-x*, *--posix*"
20140msgstr ""
20141
20142#. type: Plain text
20143#: ../sys-utils/fallocate.1.adoc:69
20144msgid ""
20145"Enable POSIX operation mode. In that mode allocation operation always "
20146"completes, but it may take longer time when fast allocation is not supported "
20147"by the underlying filesystem."
20148msgstr ""
20149
20150#. type: Labeled list
20151#: ../sys-utils/fallocate.1.adoc:70
20152#, no-wrap
20153msgid "*-z*, *--zero-range*"
20154msgstr ""
20155
20156#. type: Plain text
20157#: ../sys-utils/fallocate.1.adoc:72
20158msgid ""
20159"Zeroes space in the byte range starting at _offset_ and continuing for "
20160"_length_ bytes. Within the specified range, blocks are preallocated for the "
20161"regions that span the holes in the file. After a successful call, subsequent "
20162"reads from this range will return zeroes."
20163msgstr ""
20164
20165#. type: Plain text
20166#: ../sys-utils/fallocate.1.adoc:74
20167msgid ""
20168"Zeroing is done within the filesystem preferably by converting the range "
20169"into unwritten extents. This approach means that the specified range will "
20170"not be physically zeroed out on the device (except for partial blocks at the "
20171"either end of the range), and I/O is (otherwise) required only to update "
20172"metadata."
20173msgstr ""
20174
20175#. type: Plain text
20176#: ../sys-utils/fallocate.1.adoc:76
20177msgid "Option *--keep-size* can be specified to prevent file length modification."
20178msgstr ""
20179
20180#. type: Plain text
20181#: ../sys-utils/fallocate.1.adoc:78
20182msgid "Available since Linux 3.14 for ext4 (only for extent-based files) and XFS."
20183msgstr ""
20184
20185#. type: Plain text
20186#: ../sys-utils/fallocate.1.adoc:89
20187msgid "mailto:sandeen@redhat.com[Eric Sandeen], mailto:kzak@redhat.com[Karel Zak]"
20188msgstr ""
20189
20190#. type: Plain text
20191#: ../sys-utils/fallocate.1.adoc:95
20192#, no-wrap
20193msgid ""
20194"*truncate*(1),\n"
20195"*fallocate*(2),\n"
20196"*posix_fallocate*(3)\n"
20197msgstr ""
20198
20199#. Copyright 2003-2006 H. Peter Anvin - All Rights Reserved
20200#
20201#. Permission is hereby granted, free of charge, to any person
20202#. obtaining a copy of this software and associated documentation
20203#. files (the "Software"), to deal in the Software without
20204#. restriction, including without limitation the rights to use,
20205#. copy, modify, merge, publish, distribute, sublicense, and/or
20206#. sell copies of the Software, and to permit persons to whom
20207#. the Software is furnished to do so, subject to the following
20208#. conditions:
20209#
20210#. The above copyright notice and this permission notice shall
20211#. be included in all copies or substantial portions of the Software.
20212#
20213#. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
20214#. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
20215#. OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20216#. NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
20217#. HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
20218#. WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20219#. FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20220#. OTHER DEALINGS IN THE SOFTWARE.
20221#. type: Title =
20222#: ../sys-utils/flock.1.adoc:26
20223#, no-wrap
20224msgid "flock(1)"
20225msgstr ""
20226
20227#. type: Plain text
b81d5971 20228#: ../sys-utils/flock.1.adoc:37
36e96905
MB
20229msgid "flock - manage locks from shell scripts"
20230msgstr ""
20231
20232#. type: Plain text
b81d5971 20233#: ../sys-utils/flock.1.adoc:41
36e96905
MB
20234#, no-wrap
20235msgid "*flock* [options] _file_|_directory_ _command_ [_arguments_]\n"
20236msgstr ""
20237
20238#. type: Plain text
b81d5971 20239#: ../sys-utils/flock.1.adoc:43
36e96905
MB
20240#, no-wrap
20241msgid "*flock* [options] _file_|_directory_ *-c* _command_\n"
20242msgstr ""
20243
20244#. type: Plain text
b81d5971 20245#: ../sys-utils/flock.1.adoc:45
36e96905
MB
20246#, no-wrap
20247msgid "*flock* [options] _number_\n"
20248msgstr ""
20249
20250#. type: Plain text
b81d5971 20251#: ../sys-utils/flock.1.adoc:49
36e96905
MB
20252msgid ""
20253"This utility manages *flock*(2) locks from within shell scripts or from the "
20254"command line."
20255msgstr ""
20256
20257#. type: Plain text
b81d5971 20258#: ../sys-utils/flock.1.adoc:51
36e96905
MB
20259msgid ""
20260"The first and second of the above forms wrap the lock around the execution "
20261"of a _command_, in a manner similar to *su*(1) or *newgrp*(1). They lock a "
20262"specified _file_ or _directory_, which is created (assuming appropriate "
20263"permissions) if it does not already exist. By default, if the lock cannot be "
20264"immediately acquired, *flock* waits until the lock is available."
20265msgstr ""
20266
20267#. type: Plain text
b81d5971 20268#: ../sys-utils/flock.1.adoc:53
36e96905
MB
20269msgid ""
20270"The third form uses an open file by its file descriptor _number_. See the "
20271"examples below for how that can be used."
20272msgstr ""
20273
20274#. type: Labeled list
b81d5971 20275#: ../sys-utils/flock.1.adoc:56 ../term-utils/script.1.adoc:69
36e96905
MB
20276#, no-wrap
20277msgid "*-c*, *--command* _command_"
20278msgstr ""
20279
20280#. type: Plain text
b81d5971 20281#: ../sys-utils/flock.1.adoc:58
36e96905
MB
20282msgid "Pass a single _command_, without arguments, to the shell with *-c*."
20283msgstr ""
20284
20285#. type: Labeled list
b81d5971 20286#: ../sys-utils/flock.1.adoc:59
36e96905
MB
20287#, no-wrap
20288msgid "*-E*, *--conflict-exit-code* _number_"
20289msgstr ""
20290
20291#. type: Plain text
b81d5971 20292#: ../sys-utils/flock.1.adoc:61
36e96905
MB
20293msgid ""
20294"The exit status used when the *-n* option is in use, and the conflicting "
20295"lock exists, or the *-w* option is in use, and the timeout is reached. The "
20296"default value is *1*. The _number_ has to be in the range of 0 to 255."
20297msgstr ""
20298
20299#. type: Plain text
b81d5971 20300#: ../sys-utils/flock.1.adoc:64
36e96905
MB
20301msgid ""
20302"Do not fork before executing _command_. Upon execution the flock process is "
20303"replaced by _command_ which continues to hold the lock. This option is "
20304"incompatible with *--close* as there would otherwise be nothing left to hold "
20305"the lock."
20306msgstr ""
20307
20308#. type: Labeled list
b81d5971 20309#: ../sys-utils/flock.1.adoc:65
36e96905
MB
20310#, no-wrap
20311msgid "*-e*, *-x*, *--exclusive*"
20312msgstr ""
20313
20314#. type: Plain text
b81d5971 20315#: ../sys-utils/flock.1.adoc:67
36e96905
MB
20316msgid ""
20317"Obtain an exclusive lock, sometimes called a write lock. This is the "
20318"default."
20319msgstr ""
20320
20321#. type: Labeled list
b81d5971 20322#: ../sys-utils/flock.1.adoc:68
36e96905
MB
20323#, no-wrap
20324msgid "*-n*, *--nb*, *--nonblock*"
20325msgstr ""
20326
20327#. type: Plain text
b81d5971 20328#: ../sys-utils/flock.1.adoc:70
36e96905
MB
20329msgid ""
20330"Fail rather than wait if the lock cannot be immediately acquired. See the "
20331"*-E* option for the exit status used."
20332msgstr ""
20333
20334#. type: Labeled list
b81d5971 20335#: ../sys-utils/flock.1.adoc:71
36e96905
MB
20336#, no-wrap
20337msgid "*-o*, *--close*"
20338msgstr ""
20339
20340#. type: Plain text
b81d5971 20341#: ../sys-utils/flock.1.adoc:73
36e96905
MB
20342msgid ""
20343"Close the file descriptor on which the lock is held before executing "
20344"_command_. This is useful if _command_ spawns a child process which should "
20345"not be holding the lock."
20346msgstr ""
20347
20348#. type: Labeled list
b81d5971 20349#: ../sys-utils/flock.1.adoc:74
36e96905
MB
20350#, no-wrap
20351msgid "*-s*, *--shared*"
20352msgstr ""
20353
20354#. type: Plain text
b81d5971 20355#: ../sys-utils/flock.1.adoc:76
36e96905
MB
20356msgid "Obtain a shared lock, sometimes called a read lock."
20357msgstr ""
20358
20359#. type: Labeled list
b81d5971 20360#: ../sys-utils/flock.1.adoc:77
36e96905
MB
20361#, no-wrap
20362msgid "*-u*, *--unlock*"
20363msgstr ""
20364
20365#. type: Plain text
b81d5971 20366#: ../sys-utils/flock.1.adoc:79
36e96905
MB
20367msgid ""
20368"Drop a lock. This is usually not required, since a lock is automatically "
20369"dropped when the file is closed. However, it may be required in special "
20370"cases, for example if the enclosed command group may have forked a "
20371"background process which should not be holding the lock."
20372msgstr ""
20373
20374#. type: Labeled list
b81d5971 20375#: ../sys-utils/flock.1.adoc:80
36e96905
MB
20376#, no-wrap
20377msgid "*-w*, *--wait*, *--timeout* _seconds_"
20378msgstr ""
20379
20380#. type: Plain text
b81d5971 20381#: ../sys-utils/flock.1.adoc:82
36e96905
MB
20382msgid ""
20383"Fail if the lock cannot be acquired within _seconds_. Decimal fractional "
20384"values are allowed. See the *-E* option for the exit status used. The zero "
20385"number of _seconds_ is interpreted as *--nonblock*."
20386msgstr ""
20387
20388#. type: Plain text
b81d5971 20389#: ../sys-utils/flock.1.adoc:85
36e96905
MB
20390msgid ""
20391"Report how long it took to acquire the lock, or why the lock could not be "
20392"obtained."
20393msgstr ""
20394
20395#. type: Plain text
b81d5971 20396#: ../sys-utils/flock.1.adoc:95
36e96905
MB
20397msgid ""
20398"The command uses <sysexits.h> exit status values for everything, except when "
20399"using either of the options *-n* or *-w* which report a failure to acquire "
20400"the lock with an exit status given by the *-E* option, or 1 by default. The "
20401"exit status given by *-E* has to be in the range of 0 to 255."
20402msgstr ""
20403
20404#. type: Plain text
b81d5971 20405#: ../sys-utils/flock.1.adoc:97
36e96905
MB
20406msgid ""
20407"When using the _command_ variant, and executing the child worked, then the "
20408"exit status is that of the child command."
20409msgstr ""
20410
20411#. type: Plain text
b81d5971 20412#: ../sys-utils/flock.1.adoc:101
36e96905
MB
20413msgid "Note that \"shell> \" in examples is a command line prompt."
20414msgstr ""
20415
20416#. type: Labeled list
b81d5971 20417#: ../sys-utils/flock.1.adoc:102
36e96905
MB
20418#, no-wrap
20419msgid "shell1> flock /tmp -c cat; shell2> flock -w .007 /tmp -c echo; /bin/echo $?"
20420msgstr ""
20421
20422#. type: Plain text
b81d5971 20423#: ../sys-utils/flock.1.adoc:104
36e96905
MB
20424msgid "Set exclusive lock to directory /tmp and the second command will fail."
20425msgstr ""
20426
20427#. type: Labeled list
b81d5971 20428#: ../sys-utils/flock.1.adoc:105
36e96905
MB
20429#, no-wrap
20430msgid ""
20431"shell1> flock -s /tmp -c cat; shell2> flock -s -w .007 /tmp -c echo; "
20432"/bin/echo $?"
20433msgstr ""
20434
20435#. type: Plain text
b81d5971 20436#: ../sys-utils/flock.1.adoc:107
36e96905
MB
20437msgid ""
20438"Set shared lock to directory /tmp and the second command will not "
20439"fail. Notice that attempting to get exclusive lock with second command would "
20440"fail."
20441msgstr ""
20442
20443#. type: Labeled list
b81d5971 20444#: ../sys-utils/flock.1.adoc:108
36e96905
MB
20445#, no-wrap
20446msgid "shell> flock -x local-lock-file echo 'a b c'"
20447msgstr ""
20448
20449#. type: Plain text
b81d5971 20450#: ../sys-utils/flock.1.adoc:110
36e96905
MB
20451msgid ""
20452"Grab the exclusive lock \"local-lock-file\" before running echo with 'a b "
20453"c'."
20454msgstr ""
20455
20456#. type: Labeled list
b81d5971 20457#: ../sys-utils/flock.1.adoc:111
36e96905
MB
20458#, no-wrap
20459msgid ""
20460"(; flock -n 9 || exit 1; # ... commands executed under lock ...; ) "
20461"9>/var/lock/mylockfile"
20462msgstr ""
20463
20464#. type: Plain text
b81d5971 20465#: ../sys-utils/flock.1.adoc:113
36e96905
MB
20466msgid ""
20467"The form is convenient inside shell scripts. The mode used to open the file "
20468"doesn't matter to *flock*; using _>_ or _>>_ allows the lockfile to be "
20469"created if it does not already exist, however, write permission is "
20470"required. Using _<_ requires that the file already exists but only read "
20471"permission is required."
20472msgstr ""
20473
20474#. type: Labeled list
b81d5971 20475#: ../sys-utils/flock.1.adoc:114
36e96905
MB
20476#, no-wrap
20477msgid "[ $\\{FLOCKER} != $0 ] && exec env FLOCKER=\"$0 flock -en $0 $0 $@ || :"
20478msgstr ""
20479
20480#. type: Plain text
b81d5971 20481#: ../sys-utils/flock.1.adoc:116
36e96905
MB
20482msgid ""
20483"This is useful boilerplate code for shell scripts. Put it at the top of the "
20484"shell script you want to lock and it'll automatically lock itself on the "
20485"first run. If the env var *$FLOCKER* is not set to the shell script that is "
20486"being run, then execute *flock* and grab an exclusive non-blocking lock "
20487"(using the script itself as the lock file) before re-execing itself with the "
20488"right arguments. It also sets the FLOCKER env var to the right value so it "
20489"doesn't run again."
20490msgstr ""
20491
20492#. type: Labeled list
b81d5971 20493#: ../sys-utils/flock.1.adoc:117
36e96905
MB
20494#, no-wrap
20495msgid "shell> exec 4<>/var/lock/mylockfile; shell> flock -n 4"
20496msgstr ""
20497
20498#. type: Plain text
b81d5971 20499#: ../sys-utils/flock.1.adoc:119
36e96905
MB
20500msgid ""
20501"This form is convenient for locking a file without spawning a "
20502"subprocess. The shell opens the lock file for reading and writing as file "
20503"descriptor 4, then flock is used to lock the descriptor."
20504msgstr ""
20505
20506#. type: Plain text
b81d5971 20507#: ../sys-utils/flock.1.adoc:123
36e96905
MB
20508msgid "mailto:hpa@zytor.com[H. Peter Anvin]"
20509msgstr ""
20510
b81d5971 20511#. TRANSLATORS: Keep {copyright} untranslated.
36e96905 20512#. type: Plain text
b81d5971 20513#: ../sys-utils/flock.1.adoc:128
36e96905 20514msgid ""
b81d5971
MB
20515"Copyright {copyright} 2003-2006 H. Peter Anvin. This is free software; see "
20516"the source for copying conditions. There is NO warranty; not even for "
20517"MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
36e96905
MB
20518msgstr ""
20519
20520#. type: Plain text
b81d5971 20521#: ../sys-utils/flock.1.adoc:132
36e96905
MB
20522#, no-wrap
20523msgid "*flock*(2)\n"
20524msgstr ""
20525
20526#. type: Title =
20527#: ../sys-utils/fsfreeze.8.adoc:2
20528#, no-wrap
20529msgid "fsfreeze(8)"
20530msgstr ""
20531
20532#. type: Plain text
20533#: ../sys-utils/fsfreeze.8.adoc:12
20534msgid "fsfreeze - suspend access to a filesystem (Ext3/4, ReiserFS, JFS, XFS)"
20535msgstr ""
20536
20537#. type: Plain text
20538#: ../sys-utils/fsfreeze.8.adoc:16
20539#, no-wrap
20540msgid "*fsfreeze* *--freeze*|*--unfreeze* _mountpoint_\n"
20541msgstr ""
20542
20543#. type: Plain text
20544#: ../sys-utils/fsfreeze.8.adoc:20
20545#, no-wrap
20546msgid "*fsfreeze* suspends or resumes access to a filesystem.\n"
20547msgstr ""
20548
20549#. type: Plain text
20550#: ../sys-utils/fsfreeze.8.adoc:22
20551#, no-wrap
20552msgid ""
20553"*fsfreeze* halts any new access to the filesystem and creates a stable image "
20554"on disk. *fsfreeze* is intended to be used with hardware RAID devices that "
20555"support the creation of snapshots.\n"
20556msgstr ""
20557
20558#. type: Plain text
20559#: ../sys-utils/fsfreeze.8.adoc:24
20560#, no-wrap
20561msgid ""
20562"*fsfreeze* is unnecessary for *device-mapper* devices. The device-mapper "
20563"(and LVM) automatically freezes a filesystem on the device when a snapshot "
20564"creation is requested. For more details see the *dmsetup*(8) man page.\n"
20565msgstr ""
20566
20567#. type: Plain text
20568#: ../sys-utils/fsfreeze.8.adoc:26
20569msgid ""
20570"The _mountpoint_ argument is the pathname of the directory where the "
20571"filesystem is mounted. The filesystem must be mounted to be frozen (see "
20572"*mount*(8))."
20573msgstr ""
20574
20575#. type: Plain text
20576#: ../sys-utils/fsfreeze.8.adoc:28
20577msgid ""
20578"Note that access-time updates are also suspended if the filesystem is "
20579"mounted with the traditional atime behavior (mount option *strictatime*, for "
20580"more details see *mount*(8))."
20581msgstr ""
20582
20583#. type: Labeled list
20584#: ../sys-utils/fsfreeze.8.adoc:31
20585#, no-wrap
20586msgid "*-f*, *--freeze*"
20587msgstr ""
20588
20589#. type: Plain text
20590#: ../sys-utils/fsfreeze.8.adoc:33
20591msgid ""
20592"This option requests the specified a filesystem to be frozen from new "
20593"modifications. When this is selected, all ongoing transactions in the "
20594"filesystem are allowed to complete, new write system calls are halted, other "
20595"calls which modify the filesystem are halted, and all dirty data, metadata, "
20596"and log information are written to disk. Any process attempting to write to "
20597"the frozen filesystem will block waiting for the filesystem to be unfrozen."
20598msgstr ""
20599
20600#. type: Plain text
20601#: ../sys-utils/fsfreeze.8.adoc:35
20602msgid ""
20603"Note that even after freezing, the on-disk filesystem can contain "
20604"information on files that are still in the process of unlinking. These files "
20605"will not be unlinked until the filesystem is unfrozen or a clean mount of "
20606"the snapshot is complete."
20607msgstr ""
20608
20609#. type: Labeled list
20610#: ../sys-utils/fsfreeze.8.adoc:36
20611#, no-wrap
20612msgid "*-u*, *--unfreeze*"
20613msgstr ""
20614
20615#. type: Plain text
20616#: ../sys-utils/fsfreeze.8.adoc:38
20617msgid ""
20618"This option is used to un-freeze the filesystem and allow operations to "
20619"continue. Any filesystem modifications that were blocked by the freeze are "
20620"unblocked and allowed to complete."
20621msgstr ""
20622
20623#. type: Title ==
20624#: ../sys-utils/fsfreeze.8.adoc:45
20625#, no-wrap
20626msgid "FILESYSTEM SUPPORT"
20627msgstr ""
20628
20629#. type: Plain text
20630#: ../sys-utils/fsfreeze.8.adoc:48
20631msgid ""
20632"This command will work only if filesystem supports has support for "
20633"freezing. List of these filesystems include (2016-12-18) *btrfs*, "
20634"*ext2/3/4*, *f2fs*, *jfs*, *nilfs2*, *reiserfs*, and *xfs*. Previous list "
20635"may be incomplete, as more filesystems get support. If in doubt easiest way "
20636"to know if a filesystem has support is create a small loopback mount and "
20637"test freezing it."
20638msgstr ""
20639
20640#. type: Plain text
20641#: ../sys-utils/fsfreeze.8.adoc:52
20642msgid "This man page is based on *xfs_freeze*(8)."
20643msgstr ""
20644
20645#. type: Plain text
20646#: ../sys-utils/fsfreeze.8.adoc:56
20647msgid "Written by Hajime Taira."
20648msgstr ""
20649
20650#. type: Plain text
20651#: ../sys-utils/fsfreeze.8.adoc:60 ../sys-utils/mountpoint.1.adoc:72
20652#, no-wrap
20653msgid "*mount*(8)\n"
20654msgstr ""
20655
20656#. Copyright (c) 1980, 1989, 1991 The Regents of the University of California.
20657#. All rights reserved.
20658#
20659#. Redistribution and use in source and binary forms, with or without
20660#. modification, are permitted provided that the following conditions
20661#. are met:
20662#. 1. Redistributions of source code must retain the above copyright
20663#. notice, this list of conditions and the following disclaimer.
20664#. 2. Redistributions in binary form must reproduce the above copyright
20665#. notice, this list of conditions and the following disclaimer in the
20666#. documentation and/or other materials provided with the distribution.
20667#. 3. All advertising materials mentioning features or use of this software
20668#. must display the following acknowledgement:
20669#. This product includes software developed by the University of
20670#. California, Berkeley and its contributors.
20671#. 4. Neither the name of the University nor the names of its contributors
20672#. may be used to endorse or promote products derived from this software
20673#. without specific prior written permission.
20674#
20675#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20676#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20677#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20678#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20679#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20680#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20681#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20682#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20683#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
20684#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
20685#. SUCH DAMAGE.
20686#
20687#. @(#)fstab.5 6.5 (Berkeley) 5/10/91
20688#. type: Title =
20689#: ../sys-utils/fstab.5.adoc:36
20690#, no-wrap
20691msgid "fstab(5)"
20692msgstr ""
20693
20694#. type: Plain text
20695#: ../sys-utils/fstab.5.adoc:46
20696msgid "fstab - static information about the filesystems"
20697msgstr ""
20698
20699#. type: Plain text
20700#: ../sys-utils/fstab.5.adoc:54
20701msgid ""
20702"The file *fstab* contains descriptive information about the filesystems the "
20703"system can mount. *fstab* is only read by programs, and not written; it is "
20704"the duty of the system administrator to properly create and maintain this "
20705"file. The order of records in *fstab* is important because fsck8, mount8, "
20706"and umount8 sequentially iterate through *fstab* doing their thing."
20707msgstr ""
20708
20709#. type: Plain text
20710#: ../sys-utils/fstab.5.adoc:56
20711msgid ""
20712"Each filesystem is described on a separate line. Fields on each line are "
20713"separated by tabs or spaces. Lines starting with '#' are comments. Blank "
20714"lines are ignored."
20715msgstr ""
20716
20717#. type: Plain text
20718#: ../sys-utils/fstab.5.adoc:58
20719msgid "The following is a typical example of an *fstab* entry:"
20720msgstr ""
20721
20722#. type: delimited block .
20723#: ../sys-utils/fstab.5.adoc:61
20724#, no-wrap
20725msgid "LABEL=t-home2 /home ext4 defaults,auto_da_alloc 0 2\n"
20726msgstr ""
20727
20728#. type: Title ===
20729#: ../sys-utils/fstab.5.adoc:63
20730#, no-wrap
20731msgid "The first field (_fs_spec_)."
20732msgstr ""
20733
20734#. type: Plain text
20735#: ../sys-utils/fstab.5.adoc:66
20736msgid ""
20737"This field describes the block special device, remote filesystem or "
20738"filesystem image for loop device to be mounted or swap file or swap "
20739"partition to be enabled."
20740msgstr ""
20741
20742#. type: Plain text
20743#: ../sys-utils/fstab.5.adoc:68
20744msgid ""
20745"For ordinary mounts, it will hold (a link to) a block special device node "
20746"(as created by *mknod*(2)) for the device to be mounted, like _/dev/cdrom_ "
20747"or _/dev/sdb7_. For NFS mounts, this field is _<host>:<dir>_, e.g., "
20748"_knuth.aeb.nl:/_. For filesystems with no storage, any string can be used, "
20749"and will show up in *df*(1) output, for example. Typical usage is _proc_ for "
20750"*procfs*; _mem_, _none_, or _tmpfs_ for *tmpfs*. Other special filesystems, "
20751"like *udev* and *sysfs*, are typically not listed in *fstab*."
20752msgstr ""
20753
20754#. type: Plain text
20755#: ../sys-utils/fstab.5.adoc:70
20756msgid ""
20757"LABEL=<label> or UUID=<uuid> may be given instead of a device name. This is "
20758"the recommended method, as device names are often a coincidence of hardware "
20759"detection order, and can change when other disks are added or removed. For "
5db1d29a 20760"example, 'LABEL=Boot' or 'UUID=3e6be9de-8139-11d1-9106-a43f08d823a6'. (Use a "
36e96905
MB
20761"filesystem-specific tool like *e2label*(8), *xfs_admin*(8), or *fatlabel*(8) "
20762"to set LABELs on filesystems)."
20763msgstr ""
20764
20765#. type: Plain text
20766#: ../sys-utils/fstab.5.adoc:72
20767msgid ""
20768"It's also possible to use *PARTUUID=* and *PARTLABEL=*. These partitions "
20769"identifiers are supported for example for GUID Partition Table (GPT)."
20770msgstr ""
20771
20772#. type: Plain text
20773#: ../sys-utils/fstab.5.adoc:74
20774msgid ""
20775"See *mount*(8), *blkid*(8) or *lsblk*(8) for more details about device "
20776"identifiers."
20777msgstr ""
20778
20779#. type: Plain text
20780#: ../sys-utils/fstab.5.adoc:76
20781msgid ""
20782"Note that *mount*(8) uses UUIDs as strings. The string representation of the "
20783"UUID should be based on lower case characters. But when specifying the "
20784"volume ID of FAT or NTFS file systems upper case characters are used (e.g "
20785"UUID=\"A40D-85E7\" or UUID=\"61DB7756DB7779B3\")."
20786msgstr ""
20787
20788#. type: Title ===
20789#: ../sys-utils/fstab.5.adoc:77
20790#, no-wrap
20791msgid "The second field (_fs_file_)."
20792msgstr ""
20793
20794#. type: Plain text
20795#: ../sys-utils/fstab.5.adoc:80
20796msgid ""
20797"This field describes the mount point (target) for the filesystem. For swap "
20798"partitions, this field should be specified as `none'. If the name of the "
20799"mount point contains spaces or tabs these can be escaped as `\\040' and "
20800"'\\011' respectively."
20801msgstr ""
20802
20803#. type: Title ===
20804#: ../sys-utils/fstab.5.adoc:81
20805#, no-wrap
20806msgid "The third field (_fs_vfstype_)."
20807msgstr ""
20808
20809#. type: Plain text
20810#: ../sys-utils/fstab.5.adoc:84
20811msgid ""
20812"This field describes the type of the filesystem. Linux supports many "
20813"filesystem types: ext4, xfs, btrfs, f2fs, vfat, ntfs, hfsplus, tmpfs, sysfs, "
20814"proc, iso9660, udf, squashfs, nfs, cifs, and many more. For more details, "
20815"see mount8."
20816msgstr ""
20817
20818#. type: Plain text
20819#: ../sys-utils/fstab.5.adoc:86
20820msgid ""
20821"An entry _swap_ denotes a file or partition to be used for swapping, "
20822"cf. *swapon*(8). An entry _none_ is useful for bind or move mounts."
20823msgstr ""
20824
20825#. type: Plain text
20826#: ../sys-utils/fstab.5.adoc:88
20827msgid "More than one type may be specified in a comma-separated list."
20828msgstr ""
20829
20830#. type: Plain text
20831#: ../sys-utils/fstab.5.adoc:90
20832#, no-wrap
20833msgid ""
20834"*mount*(8) and *umount*(8) support filesystem _subtypes_. The subtype is "
20835"defined by '.subtype' suffix. For example 'fuse.sshfs'. It's recommended to "
20836"use subtype notation rather than add any prefix to the first fstab field "
20837"(for example 'sshfs#example.com' is deprecated).\n"
20838msgstr ""
20839
20840#. type: Title ===
20841#: ../sys-utils/fstab.5.adoc:91
20842#, no-wrap
20843msgid "The fourth field (_fs_mntops_)."
20844msgstr ""
20845
20846#. type: Plain text
20847#: ../sys-utils/fstab.5.adoc:94
20848msgid "This field describes the mount options associated with the filesystem."
20849msgstr ""
20850
20851#. type: Plain text
20852#: ../sys-utils/fstab.5.adoc:96
20853msgid ""
20854"It is formatted as a comma-separated list of options. It contains at least "
20855"the type of mount (*ro* or *rw*), plus any additional options appropriate to "
20856"the filesystem type (including performance-tuning options). For details, see "
20857"*mount*(8) or *swapon*(8)."
20858msgstr ""
20859
20860#. type: Plain text
20861#: ../sys-utils/fstab.5.adoc:98
20862msgid "Basic filesystem-independent options are:"
20863msgstr ""
20864
20865#. type: Labeled list
20866#: ../sys-utils/fstab.5.adoc:99 ../sys-utils/mount.8.adoc:491
20867#, no-wrap
20868msgid "*defaults*"
20869msgstr ""
20870
20871#. type: Plain text
20872#: ../sys-utils/fstab.5.adoc:101
20873msgid "use default options: rw, suid, dev, exec, auto, nouser, and async."
20874msgstr ""
20875
20876#. type: Labeled list
20877#: ../sys-utils/fstab.5.adoc:101 ../sys-utils/mount.8.adoc:465
20878#, no-wrap
20879msgid "*noauto*"
20880msgstr ""
20881
20882#. type: Plain text
20883#: ../sys-utils/fstab.5.adoc:103
20884msgid "do not mount when *mount -a* is given (e.g., at boot time)"
20885msgstr ""
20886
20887#. type: Labeled list
20888#: ../sys-utils/fstab.5.adoc:103 ../sys-utils/mount.8.adoc:612
20889#, no-wrap
20890msgid "*user*"
20891msgstr ""
20892
20893#. type: Plain text
20894#: ../sys-utils/fstab.5.adoc:105
20895msgid "allow a user to mount"
20896msgstr ""
20897
20898#. type: Labeled list
20899#: ../sys-utils/fstab.5.adoc:105 ../sys-utils/mount.8.adoc:579
20900#, no-wrap
20901msgid "*owner*"
20902msgstr ""
20903
20904#. type: Plain text
20905#: ../sys-utils/fstab.5.adoc:107
20906msgid "allow device owner to mount"
20907msgstr ""
20908
20909#. type: Labeled list
20910#: ../sys-utils/fstab.5.adoc:107
20911#, no-wrap
20912msgid "*comment*"
20913msgstr ""
20914
20915#. type: Plain text
20916#: ../sys-utils/fstab.5.adoc:109
20917msgid "or *x-<name>* for use by fstab-maintaining programs"
20918msgstr ""
20919
20920#. type: Labeled list
20921#: ../sys-utils/fstab.5.adoc:109 ../sys-utils/mount.8.adoc:535
20922#, no-wrap
20923msgid "*nofail*"
20924msgstr ""
20925
20926#. type: Plain text
20927#: ../sys-utils/fstab.5.adoc:111
20928msgid "do not report errors for this device if it does not exist."
20929msgstr ""
20930
20931#. type: Title ===
20932#: ../sys-utils/fstab.5.adoc:112
20933#, no-wrap
20934msgid "The fifth field (_fs_freq_)."
20935msgstr ""
20936
20937#. type: Plain text
20938#: ../sys-utils/fstab.5.adoc:115
20939msgid ""
20940"This field is used by *dump*(8) to determine which filesystems need to be "
20941"dumped. Defaults to zero (don't dump) if not present."
20942msgstr ""
20943
20944#. type: Title ===
20945#: ../sys-utils/fstab.5.adoc:116
20946#, no-wrap
20947msgid "The sixth field (_fs_passno_)."
20948msgstr ""
20949
20950#. type: Plain text
20951#: ../sys-utils/fstab.5.adoc:119
20952msgid ""
20953"This field is used by *fsck*(8) to determine the order in which filesystem "
20954"checks are done at boot time. The root filesystem should be specified with a "
20955"_fs_passno_ of 1. Other filesystems should have a _fs_passno_ of "
20956"2. Filesystems within a drive will be checked sequentially, but filesystems "
20957"on different drives will be checked at the same time to utilize parallelism "
20958"available in the hardware. Defaults to zero (don't check the filesystem) if "
20959"not present."
20960msgstr ""
20961
20962#. type: Plain text
20963#: ../sys-utils/fstab.5.adoc:124
20964msgid "_/etc/fstab_, _<fstab.h>_"
20965msgstr ""
20966
20967#. type: Plain text
20968#: ../sys-utils/fstab.5.adoc:128
20969msgid ""
20970"The proper way to read records from *fstab* is to use the routines "
20971"*getmntent*(3) or *libmount*."
20972msgstr ""
20973
20974#. type: Plain text
20975#: ../sys-utils/fstab.5.adoc:130
20976msgid ""
20977"The keyword *ignore* as a filesystem type (3rd field) is no longer supported "
20978"by the pure libmount based mount utility (since util-linux v2.22)."
20979msgstr ""
20980
20981#. type: Plain text
20982#: ../sys-utils/fstab.5.adoc:134
20983msgid "The ancestor of this *fstab* file format appeared in 4.0BSD."
20984msgstr ""
20985
20986#. type: Plain text
20987#: ../sys-utils/fstab.5.adoc:142
20988#, no-wrap
20989msgid ""
20990"*getmntent*(3),\n"
20991"*fs*(5),\n"
20992"*findmnt*(8),\n"
20993"*mount*(8),\n"
20994"*swapon*(8)\n"
20995msgstr ""
20996
20997#. type: Title =
20998#: ../sys-utils/fstrim.8.adoc:2
20999#, no-wrap
21000msgid "fstrim(8)"
21001msgstr ""
21002
21003#. type: Plain text
21004#: ../sys-utils/fstrim.8.adoc:12
21005msgid "fstrim - discard unused blocks on a mounted filesystem"
21006msgstr ""
21007
21008#. type: Plain text
21009#: ../sys-utils/fstrim.8.adoc:16
21010#, no-wrap
21011msgid ""
21012"*fstrim* [*-Aa*] [*-o* _offset_] [*-l* _length_] [*-m* _minimum-size_] [*-v* "
21013"_mountpoint_]\n"
21014msgstr ""
21015
21016#. type: Plain text
21017#: ../sys-utils/fstrim.8.adoc:20
21018#, no-wrap
21019msgid ""
21020"*fstrim* is used on a mounted filesystem to discard (or \"trim\") blocks "
21021"which are not in use by the filesystem. This is useful for solid-state "
21022"drives (SSDs) and thinly-provisioned storage.\n"
21023msgstr ""
21024
21025#. type: Plain text
21026#: ../sys-utils/fstrim.8.adoc:22
21027msgid ""
21028"By default, *fstrim* will discard all unused blocks in the "
21029"filesystem. Options may be used to modify this behavior based on range or "
21030"size, as explained below."
21031msgstr ""
21032
21033#. type: Plain text
21034#: ../sys-utils/fstrim.8.adoc:24
21035msgid ""
21036"The _mountpoint_ argument is the pathname of the directory where the "
21037"filesystem is mounted."
21038msgstr ""
21039
21040#. type: Plain text
21041#: ../sys-utils/fstrim.8.adoc:26
21042msgid ""
21043"Running *fstrim* frequently, or even using *mount -o discard*, might "
21044"negatively affect the lifetime of poor-quality SSD devices. For most desktop "
21045"and server systems a sufficient trimming frequency is once a week. Note that "
21046"not all devices support a queued trim, so each trim command incurs a "
21047"performance penalty on whatever else might be trying to use the disk at the "
21048"time."
21049msgstr ""
21050
21051#. type: Plain text
21052#: ../sys-utils/fstrim.8.adoc:30
21053msgid ""
21054"The _offset_, _length_, and _minimum-size_ arguments may be followed by the "
21055"multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
21056"TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
21057"meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
21058"for GB, TB, PB, EB, ZB and YB."
21059msgstr ""
21060
21061#. type: Labeled list
21062#: ../sys-utils/fstrim.8.adoc:31
21063#, no-wrap
21064msgid "*-A, --fstab*"
21065msgstr ""
21066
21067#. type: Plain text
21068#: ../sys-utils/fstrim.8.adoc:33
21069msgid ""
21070"Trim all mounted filesystems mentioned in _/etc/fstab_ on devices that "
21071"support the discard operation. The root filesystem is determined from kernel "
21072"command line if missing in the file. The other supplied options, like "
21073"*--offset*, *--length* and *--minimum*, are applied to all these "
21074"devices. Errors from filesystems that do not support the discard operation, "
21075"read-only devices and read-only filesystems are silently ignored."
21076msgstr ""
21077
21078#. type: Labeled list
21079#: ../sys-utils/fstrim.8.adoc:34
21080#, no-wrap
21081msgid "*-a, --all*"
21082msgstr ""
21083
21084#. type: Plain text
21085#: ../sys-utils/fstrim.8.adoc:36
21086msgid ""
21087"Trim all mounted filesystems on devices that support the discard "
21088"operation. The other supplied options, like *--offset*, *--length* and "
21089"*--minimum*, are applied to all these devices. Errors from filesystems that "
21090"do not support the discard operation, read-only devices and read-only "
21091"filesystems are silently ignored."
21092msgstr ""
21093
21094#. type: Labeled list
21095#: ../sys-utils/fstrim.8.adoc:37
21096#, no-wrap
21097msgid "*-n, --dry-run*"
21098msgstr ""
21099
21100#. type: Plain text
21101#: ../sys-utils/fstrim.8.adoc:39
21102msgid "This option does everything apart from actually call *FITRIM* ioctl."
21103msgstr ""
21104
21105#. type: Labeled list
21106#: ../sys-utils/fstrim.8.adoc:40
21107#, no-wrap
21108msgid "*-o, --offset* _offset_"
21109msgstr ""
21110
21111#. type: Plain text
21112#: ../sys-utils/fstrim.8.adoc:42
21113msgid ""
21114"Byte offset in the filesystem from which to begin searching for free blocks "
21115"to discard. The default value is zero, starting at the beginning of the "
21116"filesystem."
21117msgstr ""
21118
21119#. type: Labeled list
21120#: ../sys-utils/fstrim.8.adoc:43
21121#, no-wrap
21122msgid "*-l, --length* _length_"
21123msgstr ""
21124
21125#. type: Plain text
21126#: ../sys-utils/fstrim.8.adoc:45
21127msgid ""
21128"The number of bytes (after the starting point) to search for free blocks to "
21129"discard. If the specified value extends past the end of the filesystem, "
21130"*fstrim* will stop at the filesystem size boundary. The default value "
21131"extends to the end of the filesystem."
21132msgstr ""
21133
21134#. type: Labeled list
21135#: ../sys-utils/fstrim.8.adoc:46
21136#, no-wrap
21137msgid "*-I, --listed-in* _list_"
21138msgstr ""
21139
21140#. type: Plain text
21141#: ../sys-utils/fstrim.8.adoc:48
21142msgid ""
21143"Specifies a colon-separated list of files in fstab or kernel mountinfo "
21144"format. All missing or empty files are silently ignored. The evaluation of "
21145"the _list_ stops after first non-empty file. For example:"
21146msgstr ""
21147
21148#. type: Plain text
21149#: ../sys-utils/fstrim.8.adoc:50
21150#, no-wrap
21151msgid "*--listed-in /etc/fstab:/proc/self/mountinfo*.\n"
21152msgstr ""
21153
21154#. type: Labeled list
21155#: ../sys-utils/fstrim.8.adoc:51
21156#, no-wrap
21157msgid "*-m, --minimum* _minimum-size_"
21158msgstr ""
21159
21160#. type: Plain text
21161#: ../sys-utils/fstrim.8.adoc:53
21162msgid ""
21163"Minimum contiguous free range to discard, in bytes. (This value is "
21164"internally rounded up to a multiple of the filesystem block size.) Free "
21165"ranges smaller than this will be ignored and fstrim will adjust the minimum "
21166"if it's smaller than the device's minimum, and report that "
21167"(fstrim_range.minlen) back to userspace. By increasing this value, the "
21168"fstrim operation will complete more quickly for filesystems with badly "
21169"fragmented freespace, although not all blocks will be discarded. The default "
21170"value is zero, discarding every free block."
21171msgstr ""
21172
21173#. type: Labeled list
21174#: ../sys-utils/fstrim.8.adoc:54
21175#, no-wrap
21176msgid "*-v, --verbose*"
21177msgstr ""
21178
21179#. type: Plain text
21180#: ../sys-utils/fstrim.8.adoc:56
21181msgid ""
21182"Verbose execution. With this option *fstrim* will output the number of bytes "
21183"passed from the filesystem down the block stack to the device for potential "
21184"discard. This number is a maximum discard amount from the storage device's "
21185"perspective, because _FITRIM_ ioctl called repeated will keep sending the "
21186"same sectors for discard repeatedly."
21187msgstr ""
21188
21189#. type: Plain text
21190#: ../sys-utils/fstrim.8.adoc:58
21191#, no-wrap
21192msgid ""
21193"*fstrim* will report the same potential discard bytes each time, but only "
21194"sectors which had been written to between the discards would actually be "
21195"discarded by the storage device. Further, the kernel block layer reserves "
21196"the right to adjust the discard ranges to fit raid stripe geometry, non-trim "
21197"capable devices in a LVM setup, etc. These reductions would not be reflected "
21198"in fstrim_range.len (the *--length* option).\n"
21199msgstr ""
21200
21201#. type: Labeled list
21202#: ../sys-utils/fstrim.8.adoc:59
21203#, no-wrap
21204msgid "*--quiet-unsupported*"
21205msgstr ""
21206
21207#. type: Plain text
21208#: ../sys-utils/fstrim.8.adoc:61
21209msgid ""
21210"Suppress error messages if trim operation (ioctl) is unsupported. This "
21211"option is meant to be used in systemd service file or in cron scripts to "
21212"hide warnings that are result of known problems, such as NTFS driver "
21213"reporting _Bad file descriptor_ when device is mounted read-only, or lack of "
21214"file system support for ioctl FITRIM call."
21215msgstr ""
21216
21217#. type: Plain text
21218#: ../sys-utils/fstrim.8.adoc:78
21219msgid "some filesystem discards have succeeded, some failed"
21220msgstr ""
21221
21222#. type: Plain text
21223#: ../sys-utils/fstrim.8.adoc:80
21224msgid ""
21225"The command *fstrim --all* returns 0 (all succeeded), 32 (all failed) or 64 "
21226"(some failed, some succeeded)."
21227msgstr ""
21228
21229#. type: Plain text
21230#: ../sys-utils/fstrim.8.adoc:84
21231msgid "mailto:lczerner@redhat.com[Lukas Czerner], mailto:kzak@redhat.com[Karel Zak]"
21232msgstr ""
21233
21234#. type: Plain text
21235#: ../sys-utils/fstrim.8.adoc:89
21236#, no-wrap
21237msgid ""
21238"*blkdiscard*(8),\n"
21239"*mount*(8)\n"
21240msgstr ""
21241
21242#. hwclock.8 -- man page for util-linux' hwclock
21243#
21244#. 2015-01-07 J William Piggott
21245#. Authored new section: DATE-TIME CONFIGURATION.
21246#. Subsections: Keeping Time..., LOCAL vs UTC, POSIX vs 'RIGHT'.
21247#. type: Title =
21248#: ../sys-utils/hwclock.8.adoc:9
21249#, no-wrap
21250msgid "hwclock(8)"
21251msgstr ""
21252
21253#. type: Plain text
9b7051d5 21254#: ../sys-utils/hwclock.8.adoc:20
36e96905
MB
21255msgid "hwclock - time clocks utility"
21256msgstr ""
21257
21258#. type: Plain text
9b7051d5 21259#: ../sys-utils/hwclock.8.adoc:24
36e96905
MB
21260#, no-wrap
21261msgid "*hwclock* [_function_] [_option_...]\n"
21262msgstr ""
21263
21264#. type: Plain text
9b7051d5 21265#: ../sys-utils/hwclock.8.adoc:28
36e96905
MB
21266#, no-wrap
21267msgid ""
21268"*hwclock* is an administration tool for the time clocks. It can: display the "
21269"Hardware Clock time; set the Hardware Clock to a specified time; set the "
21270"Hardware Clock from the System Clock; set the System Clock from the Hardware "
21271"Clock; compensate for Hardware Clock drift; correct the System Clock "
21272"timescale; set the kernel's timezone, NTP timescale, and epoch (Alpha only); "
21273"and predict future Hardware Clock values based on its drift rate.\n"
21274msgstr ""
21275
21276#. type: Plain text
9b7051d5 21277#: ../sys-utils/hwclock.8.adoc:30
36e96905
MB
21278msgid ""
21279"Since v2.26 important changes were made to the *--hctosys* function and the "
21280"*--directisa* option, and a new option *--update-drift* was added. See their "
21281"respective descriptions below."
21282msgstr ""
21283
21284#. type: Title ==
9b7051d5 21285#: ../sys-utils/hwclock.8.adoc:31
36e96905
MB
21286#, no-wrap
21287msgid "FUNCTIONS"
21288msgstr ""
21289
21290#. type: Plain text
9b7051d5 21291#: ../sys-utils/hwclock.8.adoc:34
36e96905
MB
21292msgid ""
21293"The following functions are mutually exclusive, only one can be given at a "
21294"time. If none is given, the default is *--show*."
21295msgstr ""
21296
21297#. type: Labeled list
9b7051d5 21298#: ../sys-utils/hwclock.8.adoc:35
36e96905
MB
21299#, no-wrap
21300msgid "*-a, --adjust*"
21301msgstr ""
21302
21303#. type: Plain text
9b7051d5 21304#: ../sys-utils/hwclock.8.adoc:37
36e96905
MB
21305msgid ""
21306"Add or subtract time from the Hardware Clock to account for systematic drift "
21307"since the last time the clock was set or adjusted. See the discussion below, "
21308"under *The Adjust Function*."
21309msgstr ""
21310
21311#. type: Labeled list
9b7051d5 21312#: ../sys-utils/hwclock.8.adoc:38
36e96905
MB
21313#, no-wrap
21314msgid "*--getepoch*; *--setepoch*"
21315msgstr ""
21316
21317#. type: Plain text
9b7051d5 21318#: ../sys-utils/hwclock.8.adoc:40
36e96905
MB
21319msgid ""
21320"These functions are for Alpha machines only, and are only available through "
21321"the Linux kernel RTC driver."
21322msgstr ""
21323
21324#. type: Plain text
9b7051d5 21325#: ../sys-utils/hwclock.8.adoc:42
36e96905
MB
21326msgid ""
21327"They are used to read and set the kernel's Hardware Clock epoch value. Epoch "
21328"is the number of years into AD to which a zero year value in the Hardware "
21329"Clock refers. For example, if the machine's BIOS sets the year counter in "
21330"the Hardware Clock to contain the number of full years since 1952, then the "
21331"kernel's Hardware Clock epoch value must be 1952."
21332msgstr ""
21333
21334#. type: Plain text
9b7051d5 21335#: ../sys-utils/hwclock.8.adoc:44
36e96905 21336msgid ""
b81d5971
MB
21337"The *--setepoch* function requires using the *--epoch* option to specify the "
21338"year. For example:"
36e96905
MB
21339msgstr ""
21340
21341#. type: Plain text
9b7051d5 21342#: ../sys-utils/hwclock.8.adoc:46
36e96905
MB
21343#, no-wrap
21344msgid "**hwclock --setepoch --epoch=1952**\n"
21345msgstr ""
21346
21347#. type: Plain text
9b7051d5 21348#: ../sys-utils/hwclock.8.adoc:48
36e96905
MB
21349msgid ""
21350"The RTC driver attempts to guess the correct epoch value, so setting it may "
21351"not be required."
21352msgstr ""
21353
21354#. type: Plain text
9b7051d5 21355#: ../sys-utils/hwclock.8.adoc:50
36e96905 21356msgid ""
7a29fa6f
MB
21357"This epoch value is used whenever *hwclock* reads or sets the Hardware Clock "
21358"on an Alpha machine. For ISA machines the kernel uses the fixed Hardware "
21359"Clock epoch of 1900."
36e96905
MB
21360msgstr ""
21361
21362#. type: Labeled list
9b7051d5 21363#: ../sys-utils/hwclock.8.adoc:51
36e96905
MB
21364#, no-wrap
21365msgid "*--predict*"
21366msgstr ""
21367
21368#. type: Plain text
9b7051d5 21369#: ../sys-utils/hwclock.8.adoc:53
36e96905
MB
21370msgid ""
21371"Predict what the Hardware Clock will read in the future based upon the time "
21372"given by the *--date* option and the information in _{ADJTIME_PATH}_. This "
21373"is useful, for example, to account for drift when setting a Hardware Clock "
b81d5971 21374"wakeup (aka alarm). See *rtcwake*(8)."
36e96905
MB
21375msgstr ""
21376
21377#. type: Plain text
9b7051d5 21378#: ../sys-utils/hwclock.8.adoc:55
36e96905
MB
21379msgid ""
21380"Do not use this function if the Hardware Clock is being modified by anything "
9b7051d5
MB
21381"other than the current operating system's *hwclock* command, such as '11 "
21382"minute mode' or from dual-booting another OS."
36e96905
MB
21383msgstr ""
21384
21385#. type: Labeled list
9b7051d5 21386#: ../sys-utils/hwclock.8.adoc:56
36e96905
MB
21387#, no-wrap
21388msgid "*-r*, *--show*; *--get*"
21389msgstr ""
21390
21391#. type: Plain text
9b7051d5 21392#: ../sys-utils/hwclock.8.adoc:58
36e96905
MB
21393msgid ""
21394"Read the Hardware Clock and print its time to standard output in the *ISO "
21395"8601* format. The time shown is always in local time, even if you keep your "
b81d5971 21396"Hardware Clock in UTC. See the *--localtime* option."
36e96905
MB
21397msgstr ""
21398
21399#. type: Plain text
9b7051d5 21400#: ../sys-utils/hwclock.8.adoc:60
36e96905
MB
21401msgid ""
21402"Showing the Hardware Clock time is the default when no function is "
21403"specified."
21404msgstr ""
21405
21406#. type: Plain text
9b7051d5 21407#: ../sys-utils/hwclock.8.adoc:62
36e96905
MB
21408msgid ""
21409"The *--get* function also applies drift correction to the time read, based "
21410"upon the information in _{ADJTIME_PATH}_. Do not use this function if the "
21411"Hardware Clock is being modified by anything other than the current "
9b7051d5 21412"operating system's *hwclock* command, such as '11 minute mode' or from "
36e96905
MB
21413"dual-booting another OS."
21414msgstr ""
21415
21416#. type: Labeled list
9b7051d5 21417#: ../sys-utils/hwclock.8.adoc:63
36e96905
MB
21418#, no-wrap
21419msgid "*-s*, *--hctosys*"
21420msgstr ""
21421
21422#. type: Plain text
9b7051d5 21423#: ../sys-utils/hwclock.8.adoc:65
36e96905
MB
21424msgid ""
21425"Set the System Clock from the Hardware Clock. The time read from the "
21426"Hardware Clock is compensated to account for systematic drift before using "
21427"it to set the System Clock. See the discussion below, under *The Adjust "
21428"Function*."
21429msgstr ""
21430
21431#. type: Plain text
9b7051d5 21432#: ../sys-utils/hwclock.8.adoc:67
36e96905
MB
21433msgid ""
21434"The System Clock must be kept in the UTC timescale for date-time "
21435"applications to work correctly in conjunction with the timezone configured "
21436"for the system. If the Hardware Clock is kept in local time then the time "
21437"read from it must be shifted to the UTC timescale before using it to set the "
b81d5971
MB
21438"System Clock. The *--hctosys* function does this based upon the information "
21439"in the _{ADJTIME_PATH}_ file or the command line arguments *--localtime* and "
21440"*--utc*. Note: no daylight saving adjustment is made. See the discussion "
21441"below, under *LOCAL vs UTC*."
36e96905
MB
21442msgstr ""
21443
21444#. type: Plain text
9b7051d5 21445#: ../sys-utils/hwclock.8.adoc:69
36e96905 21446msgid ""
b81d5971
MB
21447"The kernel also keeps a timezone value, the *--hctosys* function sets it to "
21448"the timezone configured for the system. The system timezone is configured by "
21449"the TZ environment variable or the _/etc/localtime_ file, as *tzset*(3) "
21450"would interpret them. The obsolete _tz_dsttime_ field of the kernel's "
21451"timezone value is set to zero. (For details on what this field used to mean, "
21452"see *settimeofday*(2).)"
36e96905
MB
21453msgstr ""
21454
21455#. type: Plain text
9b7051d5 21456#: ../sys-utils/hwclock.8.adoc:71
36e96905 21457msgid ""
b81d5971 21458"When used in a startup script, making the *--hctosys* function the first "
9b7051d5
MB
21459"caller of *settimeofday*(2) from boot, it will set the NTP '11 minute mode' "
21460"timescale via the _persistent_clock_is_local_ kernel variable. If the "
21461"Hardware Clock's timescale configuration is changed then a reboot is "
21462"required to inform the kernel. See the discussion below, under *Automatic "
21463"Hardware Clock Synchronization by the Kernel*."
36e96905
MB
21464msgstr ""
21465
21466#. type: Plain text
9b7051d5 21467#: ../sys-utils/hwclock.8.adoc:73
36e96905
MB
21468msgid ""
21469"This is a good function to use in one of the system startup scripts before "
21470"the file systems are mounted read/write."
21471msgstr ""
21472
21473#. type: Plain text
9b7051d5 21474#: ../sys-utils/hwclock.8.adoc:75
36e96905
MB
21475msgid ""
21476"This function should never be used on a running system. Jumping system time "
21477"will cause problems, such as corrupted filesystem timestamps. Also, if "
9b7051d5
MB
21478"something has changed the Hardware Clock, like NTP's '11 minute mode', then "
21479"*--hctosys* will set the time incorrectly by including drift compensation."
36e96905
MB
21480msgstr ""
21481
21482#. type: Plain text
9b7051d5 21483#: ../sys-utils/hwclock.8.adoc:77
36e96905
MB
21484msgid ""
21485"Drift compensation can be inhibited by setting the drift factor in "
21486"_{ADJTIME_PATH}_ to zero. This setting will be persistent as long as the "
7a29fa6f
MB
21487"*--update-drift* option is not used with *--systohc* at shutdown (or "
21488"anywhere else). Another way to inhibit this is by using the *--noadjfile* "
9b7051d5 21489"option when calling the *--hctosys* function. A third method is to delete "
36e96905
MB
21490"the _{ADJTIME_PATH}_ file. *Hwclock* will then default to using the UTC "
21491"timescale for the Hardware Clock. If the Hardware Clock is ticking local "
21492"time it will need to be defined in the file. This can be done by calling "
21493"*hwclock --localtime --adjust*; when the file is not present this command "
21494"will not actually adjust the Clock, but it will create the file with local "
21495"time configured, and a drift factor of zero."
21496msgstr ""
21497
21498#. type: Plain text
9b7051d5 21499#: ../sys-utils/hwclock.8.adoc:79
36e96905
MB
21500msgid ""
21501"A condition under which inhibiting *hwclock*'s drift correction may be "
21502"desired is when dual-booting multiple operating systems. If while this "
21503"instance of Linux is stopped, another OS changes the Hardware Clock's value, "
21504"then when this instance is started again the drift correction applied will "
21505"be incorrect."
21506msgstr ""
21507
21508#. type: Plain text
9b7051d5 21509#: ../sys-utils/hwclock.8.adoc:81
36e96905
MB
21510msgid ""
21511"For *hwclock*'s drift correction to work properly it is imperative that "
21512"nothing changes the Hardware Clock while its Linux instance is not running."
21513msgstr ""
21514
21515#. type: Labeled list
9b7051d5 21516#: ../sys-utils/hwclock.8.adoc:82
36e96905
MB
21517#, no-wrap
21518msgid "*--set*"
21519msgstr ""
21520
21521#. type: Plain text
9b7051d5 21522#: ../sys-utils/hwclock.8.adoc:84
36e96905
MB
21523msgid ""
21524"Set the Hardware Clock to the time given by the *--date* option, and update "
7a29fa6f
MB
21525"the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also "
21526"(re)calculate the drift factor. Try it without the option if *--set* "
21527"fails. See *--update-drift* below."
36e96905
MB
21528msgstr ""
21529
21530#. type: Labeled list
9b7051d5 21531#: ../sys-utils/hwclock.8.adoc:85
36e96905
MB
21532#, no-wrap
21533msgid "*--systz*"
21534msgstr ""
21535
21536#. type: Plain text
9b7051d5 21537#: ../sys-utils/hwclock.8.adoc:87
36e96905 21538msgid ""
7a29fa6f 21539"This is an alternate to the *--hctosys* function that does not read the "
36e96905
MB
21540"Hardware Clock nor set the System Clock; consequently there is not any drift "
21541"correction. It is intended to be used in a startup script on systems with "
21542"kernels above version 2.6 where you know the System Clock has been set from "
21543"the Hardware Clock by the kernel during boot."
21544msgstr ""
21545
21546#. type: Plain text
9b7051d5 21547#: ../sys-utils/hwclock.8.adoc:89
36e96905 21548msgid ""
7a29fa6f 21549"It does the following things that are detailed above in the *--hctosys* "
36e96905
MB
21550"function:"
21551msgstr ""
21552
21553#. type: Plain text
9b7051d5 21554#: ../sys-utils/hwclock.8.adoc:91
36e96905
MB
21555msgid ""
21556"Corrects the System Clock timescale to UTC as needed. Only instead of "
21557"accomplishing this by setting the System Clock, *hwclock* simply informs the "
21558"kernel and it handles the change."
21559msgstr ""
21560
21561#. type: Plain text
9b7051d5
MB
21562#: ../sys-utils/hwclock.8.adoc:92
21563msgid "Sets the kernel's NTP '11 minute mode' timescale."
36e96905
MB
21564msgstr ""
21565
21566#. type: Plain text
9b7051d5 21567#: ../sys-utils/hwclock.8.adoc:93
36e96905
MB
21568msgid "Sets the kernel's timezone."
21569msgstr ""
21570
21571#. type: Plain text
9b7051d5 21572#: ../sys-utils/hwclock.8.adoc:95
36e96905 21573msgid ""
7a29fa6f 21574"The first two are only available on the first call of *settimeofday*(2) "
36e96905
MB
21575"after boot. Consequently this option only makes sense when used in a startup "
21576"script. If the Hardware Clocks timescale configuration is changed then a "
21577"reboot would be required to inform the kernel."
21578msgstr ""
21579
21580#. type: Labeled list
9b7051d5 21581#: ../sys-utils/hwclock.8.adoc:96
36e96905
MB
21582#, no-wrap
21583msgid "*-w*, *--systohc*"
21584msgstr ""
21585
21586#. type: Plain text
9b7051d5 21587#: ../sys-utils/hwclock.8.adoc:98
36e96905
MB
21588msgid ""
21589"Set the Hardware Clock from the System Clock, and update the timestamps in "
7a29fa6f 21590"_{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the "
b81d5971 21591"drift factor. Try it without the option if *--systohc* fails. See "
7a29fa6f 21592"*--update-drift* below."
36e96905
MB
21593msgstr ""
21594
21595#. type: Labeled list
9b7051d5 21596#: ../sys-utils/hwclock.8.adoc:107
36e96905
MB
21597#, no-wrap
21598msgid "**--adjfile=**__filename__"
21599msgstr ""
21600
21601#. type: Plain text
9b7051d5 21602#: ../sys-utils/hwclock.8.adoc:109
36e96905
MB
21603msgid "Override the default _{ADJTIME_PATH}_ file path."
21604msgstr ""
21605
21606#. type: Labeled list
9b7051d5 21607#: ../sys-utils/hwclock.8.adoc:110
36e96905 21608#, no-wrap
7a29fa6f 21609msgid "**--date=**__date_string__"
36e96905
MB
21610msgstr ""
21611
21612#. type: Plain text
9b7051d5 21613#: ../sys-utils/hwclock.8.adoc:112
36e96905 21614msgid ""
7a29fa6f 21615"This option must be used with the *--set* or *--predict* functions, "
36e96905
MB
21616"otherwise it is ignored."
21617msgstr ""
21618
21619#. type: Plain text
9b7051d5 21620#: ../sys-utils/hwclock.8.adoc:114
36e96905 21621#, no-wrap
9b7051d5 21622msgid "*hwclock --set --date='16:45'*\n"
36e96905
MB
21623msgstr ""
21624
21625#. type: Plain text
9b7051d5 21626#: ../sys-utils/hwclock.8.adoc:116
36e96905 21627#, no-wrap
7a29fa6f 21628msgid "*hwclock --predict --date='2525-08-14 07:11:05'*\n"
36e96905
MB
21629msgstr ""
21630
21631#. type: Plain text
9b7051d5 21632#: ../sys-utils/hwclock.8.adoc:118
36e96905
MB
21633msgid ""
21634"The argument must be in local time, even if you keep your Hardware Clock in "
7a29fa6f 21635"UTC. See the *--localtime* option. Therefore, the argument should not "
36e96905 21636"include any timezone information. It also should not be a relative time like "
7a29fa6f 21637"\"+5 minutes\", because *hwclock*'s precision depends upon correlation "
36e96905
MB
21638"between the argument's value and when the enter key is pressed. Fractional "
21639"seconds are silently dropped. This option is capable of understanding many "
21640"time and date formats, but the previous parameters should be observed."
21641msgstr ""
21642
21643#. type: Labeled list
9b7051d5 21644#: ../sys-utils/hwclock.8.adoc:119
36e96905 21645#, no-wrap
7a29fa6f 21646msgid "**--delay=**__seconds__"
36e96905
MB
21647msgstr ""
21648
21649#. type: Plain text
9b7051d5 21650#: ../sys-utils/hwclock.8.adoc:121
36e96905
MB
21651msgid ""
21652"This option can be used to overwrite the internally used delay when setting "
21653"the clock time. The default is 0.5 (500ms) for rtc_cmos, for another RTC "
21654"types the delay is 0. If RTC type is impossible to determine (from sysfs) "
21655"then it defaults also to 0.5 to be backwardly compatible."
21656msgstr ""
21657
21658#. type: Plain text
9b7051d5 21659#: ../sys-utils/hwclock.8.adoc:123
36e96905
MB
21660msgid ""
21661"The 500ms default is based on commonly used MC146818A-compatible (x86) "
21662"hardware clock. This Hardware Clock can only be set to any integer time plus "
21663"one half second. The integer time is required because there is no interface "
21664"to set or get a fractional second. The additional half second delay is "
21665"because the Hardware Clock updates to the following second precisely 500 ms "
21666"after setting the new time. Unfortunately, this behavior is hardware "
21667"specific and in same cases another delay is required."
21668msgstr ""
21669
21670#. type: Labeled list
9b7051d5 21671#: ../sys-utils/hwclock.8.adoc:124
36e96905
MB
21672#, no-wrap
21673msgid "*-D*, *--debug*"
21674msgstr ""
21675
21676#. type: Plain text
9b7051d5 21677#: ../sys-utils/hwclock.8.adoc:126
36e96905 21678msgid ""
7a29fa6f 21679"Use *--verbose*. The *--debug* option has been deprecated and may be "
36e96905
MB
21680"repurposed or removed in a future release."
21681msgstr ""
21682
21683#. type: Labeled list
9b7051d5 21684#: ../sys-utils/hwclock.8.adoc:127
36e96905
MB
21685#, no-wrap
21686msgid "*--directisa*"
21687msgstr ""
21688
21689#. type: Plain text
9b7051d5 21690#: ../sys-utils/hwclock.8.adoc:129
36e96905
MB
21691msgid ""
21692"This option is meaningful for ISA compatible machines in the x86 and x86_64 "
7a29fa6f
MB
21693"family. For other machines, it has no effect. This option tells *hwclock* to "
21694"use explicit I/O instructions to access the Hardware Clock. Without this "
21695"option, *hwclock* will use the rtc device file, which it assumes to be "
36e96905
MB
21696"driven by the Linux RTC device driver. As of v2.26 it will no longer "
21697"automatically use directisa when the rtc driver is unavailable; this was "
21698"causing an unsafe condition that could allow two processes to access the "
21699"Hardware Clock at the same time. Direct hardware access from userspace "
21700"should only be used for testing, troubleshooting, and as a last resort when "
21701"all other methods fail. See the *--rtc* option."
21702msgstr ""
21703
21704#. type: Labeled list
9b7051d5 21705#: ../sys-utils/hwclock.8.adoc:130
36e96905
MB
21706#, no-wrap
21707msgid "**--epoch=**__year__"
21708msgstr ""
21709
21710#. type: Plain text
9b7051d5 21711#: ../sys-utils/hwclock.8.adoc:132
36e96905 21712msgid ""
7a29fa6f 21713"This option is required when using the *--setepoch* function. The minimum "
36e96905
MB
21714"_year_ value is 1900. The maximum is system dependent (*ULONG_MAX - 1*)."
21715msgstr ""
21716
21717#. type: Labeled list
9b7051d5 21718#: ../sys-utils/hwclock.8.adoc:133
36e96905
MB
21719#, no-wrap
21720msgid "*-f*, **--rtc=**__filename__"
21721msgstr ""
21722
21723#. type: Plain text
9b7051d5 21724#: ../sys-utils/hwclock.8.adoc:135
36e96905 21725msgid ""
7a29fa6f
MB
21726"Override *hwclock*'s default rtc device file name. Otherwise it will use the "
21727"first one found in this order: _/dev/rtc0_, _/dev/rtc_, _/dev/misc/rtc_. For "
21728"*IA-64:* _/dev/efirtc_ _/dev/misc/efirtc_"
36e96905
MB
21729msgstr ""
21730
21731#. type: Labeled list
9b7051d5 21732#: ../sys-utils/hwclock.8.adoc:136
36e96905
MB
21733#, no-wrap
21734msgid "*-l*, *--localtime*; *-u*, *--utc*"
21735msgstr ""
21736
21737#. type: Plain text
9b7051d5 21738#: ../sys-utils/hwclock.8.adoc:138
36e96905
MB
21739msgid "Indicate which timescale the Hardware Clock is set to."
21740msgstr ""
21741
21742#. type: Plain text
9b7051d5 21743#: ../sys-utils/hwclock.8.adoc:140
36e96905
MB
21744msgid ""
21745"The Hardware Clock may be configured to use either the UTC or the local "
21746"timescale, but nothing in the clock itself says which alternative is being "
7a29fa6f
MB
21747"used. The *--localtime* or *--utc* options give this information to the "
21748"*hwclock* command. If you specify the wrong one (or specify neither and take "
21749"a wrong default), both setting and reading the Hardware Clock will be "
36e96905
MB
21750"incorrect."
21751msgstr ""
21752
21753#. type: Plain text
9b7051d5 21754#: ../sys-utils/hwclock.8.adoc:142
36e96905 21755msgid ""
7a29fa6f
MB
21756"If you specify neither *--utc* nor *--localtime* then the one last given "
21757"with a set function (*--set*, *--systohc*, or *--adjust*), as recorded in "
21758"_{ADJTIME_PATH}_, will be used. If the adjtime file doesn't exist, the "
36e96905
MB
21759"default is UTC."
21760msgstr ""
21761
21762#. type: Plain text
9b7051d5 21763#: ../sys-utils/hwclock.8.adoc:144
36e96905
MB
21764msgid ""
21765"Note: daylight saving time changes may be inconsistent when the Hardware "
21766"Clock is kept in local time. See the discussion below, under *LOCAL vs UTC*."
21767msgstr ""
21768
21769#. type: Labeled list
9b7051d5 21770#: ../sys-utils/hwclock.8.adoc:145
36e96905
MB
21771#, no-wrap
21772msgid "*--noadjfile*"
21773msgstr ""
21774
21775#. type: Plain text
9b7051d5 21776#: ../sys-utils/hwclock.8.adoc:147
36e96905 21777msgid ""
7a29fa6f
MB
21778"Disable the facilities provided by _{ADJTIME_PATH}_. *hwclock* will not read "
21779"nor write to that file with this option. Either *--utc* or *--localtime* "
21780"must be specified when using this option."
36e96905
MB
21781msgstr ""
21782
21783#. type: Labeled list
9b7051d5 21784#: ../sys-utils/hwclock.8.adoc:148
36e96905
MB
21785#, no-wrap
21786msgid "*--test*"
21787msgstr ""
21788
21789#. type: Plain text
9b7051d5 21790#: ../sys-utils/hwclock.8.adoc:150
36e96905
MB
21791msgid ""
21792"Do not actually change anything on the system, that is, the Clocks or "
7a29fa6f 21793"_{ADJTIME_PATH}_ (*--verbose* is implicit with this option)."
36e96905
MB
21794msgstr ""
21795
21796#. type: Labeled list
9b7051d5 21797#: ../sys-utils/hwclock.8.adoc:151
36e96905
MB
21798#, no-wrap
21799msgid "*--update-drift*"
21800msgstr ""
21801
21802#. type: Plain text
9b7051d5 21803#: ../sys-utils/hwclock.8.adoc:153
36e96905
MB
21804msgid ""
21805"Update the Hardware Clock's drift factor in _{ADJTIME_PATH}_. It can only be "
7a29fa6f 21806"used with *--set* or *--systohc*."
36e96905
MB
21807msgstr ""
21808
21809#. type: Plain text
9b7051d5 21810#: ../sys-utils/hwclock.8.adoc:155
36e96905
MB
21811msgid ""
21812"A minimum four hour period between settings is required. This is to avoid "
21813"invalid calculations. The longer the period, the more precise the resulting "
21814"drift factor will be."
21815msgstr ""
21816
21817#. type: Plain text
9b7051d5 21818#: ../sys-utils/hwclock.8.adoc:157
36e96905
MB
21819msgid ""
21820"This option was added in v2.26, because it is typical for systems to call "
7a29fa6f 21821"*hwclock --systohc* at shutdown; with the old behavior this would "
36e96905
MB
21822"automatically (re)calculate the drift factor which caused several problems:"
21823msgstr ""
21824
21825#. type: Plain text
9b7051d5 21826#: ../sys-utils/hwclock.8.adoc:159
36e96905 21827msgid ""
9b7051d5 21828"When using NTP with an '11 minute mode' kernel the drift factor would be "
36e96905
MB
21829"clobbered to near zero."
21830msgstr ""
21831
21832#. type: Plain text
9b7051d5 21833#: ../sys-utils/hwclock.8.adoc:160
36e96905
MB
21834msgid ""
21835"It would not allow the use of 'cold' drift correction. With most "
21836"configurations using 'cold' drift will yield favorable results. Cold, means "
21837"when the machine is turned off which can have a significant impact on the "
21838"drift factor."
21839msgstr ""
21840
21841#. type: Plain text
9b7051d5 21842#: ../sys-utils/hwclock.8.adoc:161
36e96905
MB
21843msgid ""
21844"(Re)calculating drift factor on every shutdown delivers suboptimal "
21845"results. For example, if ephemeral conditions cause the machine to be "
21846"abnormally hot the drift factor calculation would be out of range."
21847msgstr ""
21848
21849#. type: Plain text
9b7051d5 21850#: ../sys-utils/hwclock.8.adoc:162
36e96905
MB
21851msgid ""
21852"Significantly increased system shutdown times (as of v2.31 when not using "
7a29fa6f 21853"*--update-drift* the RTC is not read)."
36e96905
MB
21854msgstr ""
21855
21856#. type: Plain text
9b7051d5 21857#: ../sys-utils/hwclock.8.adoc:164
36e96905 21858msgid ""
7a29fa6f 21859"Having *hwclock* calculate the drift factor is a good starting point, but "
36e96905
MB
21860"for optimal results it will likely need to be adjusted by directly editing "
21861"the _{ADJTIME_PATH}_ file. For most configurations once a machine's optimal "
21862"drift factor is crafted it should not need to be changed. Therefore, the old "
21863"behavior to automatically (re)calculate drift was changed and now requires "
21864"this option to be used. See the discussion below, under *The Adjust "
21865"Function*."
21866msgstr ""
21867
21868#. type: Plain text
9b7051d5 21869#: ../sys-utils/hwclock.8.adoc:166
36e96905
MB
21870msgid ""
21871"This option requires reading the Hardware Clock before setting it. If it "
21872"cannot be read, then this option will cause the set functions to fail. This "
21873"can happen, for example, if the Hardware Clock is corrupted by a power "
21874"failure. In that case, the clock must first be set without this "
21875"option. Despite it not working, the resulting drift correction factor would "
21876"be invalid anyway."
21877msgstr ""
21878
21879#. type: Plain text
9b7051d5 21880#: ../sys-utils/hwclock.8.adoc:169
7a29fa6f 21881msgid "Display more details about what *hwclock* is doing internally."
36e96905
MB
21882msgstr ""
21883
21884#. type: Title ===
9b7051d5 21885#: ../sys-utils/hwclock.8.adoc:172
36e96905
MB
21886#, no-wrap
21887msgid "Clocks in a Linux System"
21888msgstr ""
21889
21890#. type: Plain text
9b7051d5 21891#: ../sys-utils/hwclock.8.adoc:175
36e96905
MB
21892msgid "There are two types of date-time clocks:"
21893msgstr ""
21894
21895#. type: Plain text
9b7051d5 21896#: ../sys-utils/hwclock.8.adoc:177
36e96905
MB
21897#, no-wrap
21898msgid ""
21899"*The Hardware Clock:* This clock is an independent hardware device, with its "
21900"own power domain (battery, capacitor, etc), that operates when the machine "
21901"is powered off, or even unplugged.\n"
21902msgstr ""
21903
21904#. type: Plain text
9b7051d5 21905#: ../sys-utils/hwclock.8.adoc:179
36e96905
MB
21906msgid ""
21907"On an ISA compatible system, this clock is specified as part of the ISA "
21908"standard. A control program can read or set this clock only to a whole "
21909"second, but it can also detect the edges of the 1 second clock ticks, so the "
21910"clock actually has virtually infinite precision."
21911msgstr ""
21912
21913#. type: Plain text
9b7051d5 21914#: ../sys-utils/hwclock.8.adoc:181
36e96905
MB
21915msgid ""
21916"This clock is commonly called the hardware clock, the real time clock, the "
21917"RTC, the BIOS clock, and the CMOS clock. Hardware Clock, in its capitalized "
7a29fa6f
MB
21918"form, was coined for use by *hwclock*. The Linux kernel also refers to it as "
21919"the persistent clock."
36e96905
MB
21920msgstr ""
21921
21922#. type: Plain text
9b7051d5 21923#: ../sys-utils/hwclock.8.adoc:183
36e96905
MB
21924msgid ""
21925"Some non-ISA systems have a few real time clocks with only one of them "
21926"having its own power domain. A very low power external I2C or SPI clock chip "
21927"might be used with a backup battery as the hardware clock to initialize a "
21928"more functional integrated real-time clock which is used for most other "
21929"purposes."
21930msgstr ""
21931
21932#. type: Plain text
9b7051d5 21933#: ../sys-utils/hwclock.8.adoc:185
36e96905
MB
21934#, no-wrap
21935msgid ""
21936"*The System Clock:* This clock is part of the Linux kernel and is driven by "
21937"a timer interrupt. (On an ISA machine, the timer interrupt is part of the "
21938"ISA standard.) It has meaning only while Linux is running on the "
21939"machine. The System Time is the number of seconds since 00:00:00 January 1, "
21940"1970 UTC (or more succinctly, the number of seconds since 1969 UTC). The "
21941"System Time is not an integer, though. It has virtually infinite "
21942"precision.\n"
21943msgstr ""
21944
21945#. type: Plain text
9b7051d5 21946#: ../sys-utils/hwclock.8.adoc:187
36e96905
MB
21947msgid ""
21948"The System Time is the time that matters. The Hardware Clock's basic purpose "
21949"is to keep time when Linux is not running so that the System Clock can be "
21950"initialized from it at boot. Note that in DOS, for which ISA was designed, "
21951"the Hardware Clock is the only real time clock."
21952msgstr ""
21953
21954#. type: Plain text
9b7051d5 21955#: ../sys-utils/hwclock.8.adoc:189
36e96905
MB
21956msgid ""
21957"It is important that the System Time not have any discontinuities such as "
7a29fa6f
MB
21958"would happen if you used the *date*(1) program to set it while the system is "
21959"running. You can, however, do whatever you want to the Hardware Clock while "
21960"the system is running, and the next time Linux starts up, it will do so with "
21961"the adjusted time from the Hardware Clock. Note: currently this is not "
21962"possible on most systems because *hwclock --systohc* is called at shutdown."
36e96905
MB
21963msgstr ""
21964
21965#. type: Plain text
9b7051d5 21966#: ../sys-utils/hwclock.8.adoc:191
36e96905
MB
21967msgid ""
21968"The Linux kernel's timezone is set by *hwclock*. But don't be misled -- "
21969"almost nobody cares what timezone the kernel thinks it is in. Instead, "
21970"programs that care about the timezone (perhaps because they want to display "
21971"a local time for you) almost always use a more traditional method of "
5db1d29a 21972"determining the timezone: They use the *TZ* environment variable or the "
9b7051d5
MB
21973"_/etc/localtime_ file, as explained in the man page for *tzset*(3). However, "
21974"some programs and fringe parts of the Linux kernel such as filesystems use "
21975"the kernel's timezone value. An example is the vfat filesystem. If the "
21976"kernel timezone value is wrong, the vfat filesystem will report and set the "
21977"wrong timestamps on files. Another example is the kernel's NTP '11 minute "
21978"mode'. If the kernel's timezone value and/or the _persistent_clock_is_local_ "
21979"variable are wrong, then the Hardware Clock will be set incorrectly by '11 "
21980"minute mode'. See the discussion below, under *Automatic Hardware Clock "
21981"Synchronization by the Kernel*."
36e96905
MB
21982msgstr ""
21983
21984#. type: Plain text
9b7051d5 21985#: ../sys-utils/hwclock.8.adoc:193
36e96905
MB
21986#, no-wrap
21987msgid ""
7a29fa6f
MB
21988"*hwclock* sets the kernel's timezone to the value indicated by *TZ* or "
21989"_/etc/localtime_ with the *--hctosys* or *--systz* functions.\n"
36e96905
MB
21990msgstr ""
21991
21992#. type: Plain text
9b7051d5 21993#: ../sys-utils/hwclock.8.adoc:195
36e96905
MB
21994msgid ""
21995"The kernel's timezone value actually consists of two parts: 1) a field "
21996"tz_minuteswest indicating how many minutes local time (not adjusted for DST) "
21997"lags behind UTC, and 2) a field tz_dsttime indicating the type of Daylight "
21998"Savings Time (DST) convention that is in effect in the locality at the "
21999"present time. This second field is not used under Linux and is always "
7a29fa6f 22000"zero. See also *settimeofday*(2)."
36e96905
MB
22001msgstr ""
22002
22003#. type: Title ===
9b7051d5 22004#: ../sys-utils/hwclock.8.adoc:196
36e96905
MB
22005#, no-wrap
22006msgid "Hardware Clock Access Methods"
22007msgstr ""
22008
22009#. type: Plain text
9b7051d5 22010#: ../sys-utils/hwclock.8.adoc:199
36e96905
MB
22011#, no-wrap
22012msgid ""
7a29fa6f
MB
22013"*hwclock* uses many different ways to get and set Hardware Clock values. The "
22014"most normal way is to do I/O to the rtc device special file, which is "
22015"presumed to be driven by the rtc device driver. Also, Linux systems using "
22016"the rtc framework with udev, are capable of supporting multiple Hardware "
22017"Clocks. This may bring about the need to override the default rtc device by "
22018"specifying one with the *--rtc* option.\n"
36e96905
MB
22019msgstr ""
22020
22021#. type: Plain text
9b7051d5 22022#: ../sys-utils/hwclock.8.adoc:201
36e96905
MB
22023msgid ""
22024"However, this method is not always available as older systems do not have an "
22025"rtc driver. On these systems, the method of accessing the Hardware Clock "
22026"depends on the system hardware."
22027msgstr ""
22028
22029#. type: Plain text
9b7051d5 22030#: ../sys-utils/hwclock.8.adoc:203
36e96905 22031msgid ""
b81d5971 22032"On an ISA compatible system, *hwclock* can directly access the \"CMOS "
36e96905
MB
22033"memory\" registers that constitute the clock, by doing I/O to Ports 0x70 and "
22034"0x71. It does this with actual I/O instructions and consequently can only do "
22035"it if running with superuser effective userid. This method may be used by "
7a29fa6f 22036"specifying the *--directisa* option."
36e96905
MB
22037msgstr ""
22038
22039#. type: Plain text
9b7051d5 22040#: ../sys-utils/hwclock.8.adoc:205
36e96905
MB
22041msgid ""
22042"This is a really poor method of accessing the clock, for all the reasons "
22043"that userspace programs are generally not supposed to do direct I/O and "
7a29fa6f
MB
22044"disable interrupts. *hwclock* provides it for testing, troubleshooting, and "
22045"because it may be the only method available on ISA systems which do not have "
22046"a working rtc device driver."
36e96905
MB
22047msgstr ""
22048
22049#. type: Title ===
9b7051d5 22050#: ../sys-utils/hwclock.8.adoc:206
36e96905
MB
22051#, no-wrap
22052msgid "The Adjust Function"
22053msgstr ""
22054
22055#. type: Plain text
9b7051d5 22056#: ../sys-utils/hwclock.8.adoc:209
36e96905
MB
22057msgid ""
22058"The Hardware Clock is usually not very accurate. However, much of its "
22059"inaccuracy is completely predictable - it gains or loses the same amount of "
7a29fa6f 22060"time every day. This is called systematic drift. *hwclock*'s *--adjust* "
36e96905
MB
22061"function lets you apply systematic drift corrections to the Hardware Clock."
22062msgstr ""
22063
22064#. type: Plain text
9b7051d5 22065#: ../sys-utils/hwclock.8.adoc:211
36e96905 22066msgid ""
7a29fa6f 22067"It works like this: *hwclock* keeps a file, _{ADJTIME_PATH}_, that keeps "
36e96905
MB
22068"some historical information. This is called the adjtime file."
22069msgstr ""
22070
22071#. type: Plain text
9b7051d5 22072#: ../sys-utils/hwclock.8.adoc:213
36e96905 22073msgid ""
7a29fa6f
MB
22074"Suppose you start with no adjtime file. You issue a *hwclock --set* command "
22075"to set the Hardware Clock to the true current time. *hwclock* creates the "
22076"adjtime file and records in it the current time as the last time the clock "
22077"was calibrated. Five days later, the clock has gained 10 seconds, so you "
22078"issue a *hwclock --set --update-drift* command to set it back 10 "
22079"seconds. *hwclock* updates the adjtime file to show the current time as the "
22080"last time the clock was calibrated, and records 2 seconds per day as the "
22081"systematic drift rate. 24 hours go by, and then you issue a *hwclock "
22082"--adjust* command. *hwclock* consults the adjtime file and sees that the "
36e96905
MB
22083"clock gains 2 seconds per day when left alone and that it has been left "
22084"alone for exactly one day. So it subtracts 2 seconds from the Hardware "
22085"Clock. It then records the current time as the last time the clock was "
7a29fa6f
MB
22086"adjusted. Another 24 hours go by and you issue another *hwclock "
22087"--adjust*. *hwclock* does the same thing: subtracts 2 seconds and updates "
36e96905
MB
22088"the adjtime file with the current time as the last time the clock was "
22089"adjusted."
22090msgstr ""
22091
22092#. type: Plain text
9b7051d5 22093#: ../sys-utils/hwclock.8.adoc:215
36e96905 22094msgid ""
7a29fa6f
MB
22095"When you use the *--update-drift* option with *--set* or *--systohc*, the "
22096"systematic drift rate is (re)calculated by comparing the fully drift "
36e96905
MB
22097"corrected current Hardware Clock time with the new set time, from that it "
22098"derives the 24 hour drift rate based on the last calibrated timestamp from "
22099"the adjtime file. This updated drift factor is then saved in "
22100"_{ADJTIME_PATH}_."
22101msgstr ""
22102
22103#. type: Plain text
9b7051d5 22104#: ../sys-utils/hwclock.8.adoc:217
36e96905
MB
22105msgid ""
22106"A small amount of error creeps in when the Hardware Clock is set, so "
7a29fa6f 22107"*--adjust* refrains from making any adjustment that is less than 1 "
36e96905 22108"second. Later on, when you request an adjustment again, the accumulated "
7a29fa6f 22109"drift will be more than 1 second and *--adjust* will make the adjustment "
36e96905
MB
22110"including any fractional amount."
22111msgstr ""
22112
22113#. type: Plain text
9b7051d5 22114#: ../sys-utils/hwclock.8.adoc:219
36e96905
MB
22115#, no-wrap
22116msgid ""
7a29fa6f
MB
22117"*hwclock --hctosys* also uses the adjtime file data to compensate the value "
22118"read from the Hardware Clock before using it to set the System Clock. It "
22119"does not share the 1 second limitation of *--adjust*, and will correct "
22120"sub-second drift values immediately. It does not change the Hardware Clock "
22121"time nor the adjtime file. This may eliminate the need to use *--adjust*, "
22122"unless something else on the system needs the Hardware Clock to be "
22123"compensated.\n"
36e96905
MB
22124msgstr ""
22125
22126#. type: Title ===
9b7051d5 22127#: ../sys-utils/hwclock.8.adoc:220
36e96905
MB
22128#, no-wrap
22129msgid "The Adjtime File"
22130msgstr ""
22131
22132#. type: Plain text
9b7051d5 22133#: ../sys-utils/hwclock.8.adoc:223
36e96905
MB
22134msgid ""
22135"While named for its historical purpose of controlling adjustments only, it "
22136"actually contains other information used by *hwclock* from one invocation to "
22137"the next."
22138msgstr ""
22139
22140#. type: Plain text
9b7051d5 22141#: ../sys-utils/hwclock.8.adoc:225
36e96905
MB
22142msgid "The format of the adjtime file is, in ASCII:"
22143msgstr ""
22144
22145#. type: Plain text
9b7051d5 22146#: ../sys-utils/hwclock.8.adoc:227
36e96905
MB
22147msgid ""
22148"Line 1: Three numbers, separated by blanks: 1) the systematic drift rate in "
22149"seconds per day, floating point decimal; 2) the resulting number of seconds "
22150"since 1969 UTC of most recent adjustment or calibration, decimal integer; 3) "
7a29fa6f 22151"zero (for compatibility with *clock*(8)) as a floating point decimal."
36e96905
MB
22152msgstr ""
22153
22154#. type: Plain text
9b7051d5 22155#: ../sys-utils/hwclock.8.adoc:229
36e96905
MB
22156msgid ""
22157"Line 2: One number: the resulting number of seconds since 1969 UTC of most "
22158"recent calibration. Zero if there has been no calibration yet or it is known "
22159"that any previous calibration is moot (for example, because the Hardware "
22160"Clock has been found, since that calibration, not to contain a valid "
22161"time). This is a decimal integer."
22162msgstr ""
22163
22164#. type: Plain text
9b7051d5 22165#: ../sys-utils/hwclock.8.adoc:231
36e96905
MB
22166msgid ""
22167"Line 3: \"UTC\" or \"LOCAL\". Tells whether the Hardware Clock is set to "
22168"Coordinated Universal Time or local time. You can always override this value "
7a29fa6f 22169"with options on the *hwclock* command line."
36e96905
MB
22170msgstr ""
22171
22172#. type: Plain text
9b7051d5 22173#: ../sys-utils/hwclock.8.adoc:233
36e96905 22174msgid ""
7a29fa6f
MB
22175"You can use an adjtime file that was previously used with the *clock*(8) "
22176"program with *hwclock*."
36e96905
MB
22177msgstr ""
22178
22179#. type: Title ===
9b7051d5 22180#: ../sys-utils/hwclock.8.adoc:234
36e96905
MB
22181#, no-wrap
22182msgid "Automatic Hardware Clock Synchronization by the Kernel"
22183msgstr ""
22184
22185#. type: Plain text
9b7051d5 22186#: ../sys-utils/hwclock.8.adoc:237
36e96905
MB
22187msgid ""
22188"You should be aware of another way that the Hardware Clock is kept "
22189"synchronized in some systems. The Linux kernel has a mode wherein it copies "
22190"the System Time to the Hardware Clock every 11 minutes. This mode is a "
22191"compile time option, so not all kernels will have this capability. This is a "
22192"good mode to use when you are using something sophisticated like NTP to keep "
22193"your System Clock synchronized. (NTP is a way to keep your System Time "
22194"synchronized either to a time server somewhere on the network or to a radio "
22195"clock hooked up to your system. See RFC 1305.)"
22196msgstr ""
22197
22198#. type: Plain text
9b7051d5 22199#: ../sys-utils/hwclock.8.adoc:239
36e96905 22200msgid ""
9b7051d5
MB
22201"If the kernel is compiled with the '11 minute mode' option it will be active "
22202"when the kernel's clock discipline is in a synchronized state. When in this "
5db1d29a 22203"state, bit 6 (the bit that is set in the mask 0x0040) of the kernel's "
9b7051d5
MB
22204"_time_status_ variable is unset. This value is output as the 'status' line "
22205"of the *adjtimex --print* or *ntptime* commands."
36e96905
MB
22206msgstr ""
22207
22208#. type: Plain text
9b7051d5 22209#: ../sys-utils/hwclock.8.adoc:241
36e96905
MB
22210msgid ""
22211"It takes an outside influence, like the NTP daemon to put the kernel's clock "
9b7051d5
MB
22212"discipline into a synchronized state, and therefore turn on '11 minute "
22213"mode'. It can be turned off by running anything that sets the System Clock "
7a29fa6f 22214"the old fashioned way, including *hwclock --hctosys*. However, if the NTP "
9b7051d5
MB
22215"daemon is still running, it will turn '11 minute mode' back on again the "
22216"next time it synchronizes the System Clock."
36e96905
MB
22217msgstr ""
22218
22219#. type: Plain text
9b7051d5 22220#: ../sys-utils/hwclock.8.adoc:243
36e96905 22221msgid ""
9b7051d5
MB
22222"If your system runs with '11 minute mode' on, it may need to use either "
22223"*--hctosys* or *--systz* in a startup script, especially if the Hardware "
36e96905
MB
22224"Clock is configured to use the local timescale. Unless the kernel is "
22225"informed of what timescale the Hardware Clock is using, it may clobber it "
22226"with the wrong one. The kernel uses UTC by default."
22227msgstr ""
22228
22229#. type: Plain text
9b7051d5 22230#: ../sys-utils/hwclock.8.adoc:245
36e96905
MB
22231msgid ""
22232"The first userspace command to set the System Clock informs the kernel what "
22233"timescale the Hardware Clock is using. This happens via the "
5db1d29a
MB
22234"_persistent_clock_is_local_ kernel variable. If *--hctosys* or *--systz* is "
22235"the first, it will set this variable according to the adjtime file or the "
7a29fa6f
MB
22236"appropriate command-line argument. Note that when using this capability and "
22237"the Hardware Clock timescale configuration is changed, then a reboot is "
22238"required to notify the kernel."
36e96905
MB
22239msgstr ""
22240
22241#. type: Plain text
9b7051d5 22242#: ../sys-utils/hwclock.8.adoc:247
36e96905 22243#, no-wrap
9b7051d5 22244msgid "*hwclock --adjust* should not be used with NTP '11 minute mode'.\n"
36e96905
MB
22245msgstr ""
22246
22247#. type: Title ===
9b7051d5 22248#: ../sys-utils/hwclock.8.adoc:248
36e96905
MB
22249#, no-wrap
22250msgid "ISA Hardware Clock Century value"
22251msgstr ""
22252
22253#. type: Plain text
9b7051d5 22254#: ../sys-utils/hwclock.8.adoc:251
36e96905
MB
22255msgid ""
22256"There is some sort of standard that defines CMOS memory Byte 50 on an ISA "
7a29fa6f
MB
22257"machine as an indicator of what century it is. *hwclock* does not use or set "
22258"that byte because there are some machines that don't define the byte that "
22259"way, and it really isn't necessary anyway, since the year-of-century does a "
22260"good job of implying which century it is."
36e96905
MB
22261msgstr ""
22262
22263#. type: Plain text
9b7051d5 22264#: ../sys-utils/hwclock.8.adoc:253
36e96905 22265msgid ""
7a29fa6f 22266"If you have a bona fide use for a CMOS century byte, contact the *hwclock* "
36e96905
MB
22267"maintainer; an option may be appropriate."
22268msgstr ""
22269
22270#. type: Plain text
9b7051d5 22271#: ../sys-utils/hwclock.8.adoc:255
36e96905
MB
22272msgid ""
22273"Note that this section is only relevant when you are using the \"direct "
22274"ISA\" method of accessing the Hardware Clock. ACPI provides a standard way "
22275"to access century values, when they are supported by the hardware."
22276msgstr ""
22277
22278#. type: Title ==
9b7051d5 22279#: ../sys-utils/hwclock.8.adoc:256
36e96905
MB
22280#, no-wrap
22281msgid "DATE-TIME CONFIGURATION"
22282msgstr ""
22283
22284#. type: Title ===
9b7051d5 22285#: ../sys-utils/hwclock.8.adoc:258
36e96905
MB
22286#, no-wrap
22287msgid "Keeping Time without External Synchronization"
22288msgstr ""
22289
22290#. type: Plain text
9b7051d5 22291#: ../sys-utils/hwclock.8.adoc:261
36e96905
MB
22292msgid "This discussion is based on the following conditions:"
22293msgstr ""
22294
22295#. type: Plain text
9b7051d5 22296#: ../sys-utils/hwclock.8.adoc:263
36e96905
MB
22297msgid ""
22298"Nothing is running that alters the date-time clocks, such as NTP daemon or a "
22299"cron job.\""
22300msgstr ""
22301
22302#. type: Plain text
9b7051d5 22303#: ../sys-utils/hwclock.8.adoc:264
36e96905
MB
22304msgid ""
22305"The system timezone is configured for the correct local time. See below, "
22306"under *POSIX vs 'RIGHT'*."
22307msgstr ""
22308
22309#. type: Plain text
9b7051d5 22310#: ../sys-utils/hwclock.8.adoc:265
36e96905 22311msgid ""
7a29fa6f
MB
22312"Early during startup the following are called, in this order: *adjtimex "
22313"--tick* _value_ *--frequency* _value_ *hwclock --hctosys*"
36e96905
MB
22314msgstr ""
22315
22316#. type: Plain text
9b7051d5 22317#: ../sys-utils/hwclock.8.adoc:266
7a29fa6f 22318msgid "During shutdown the following is called: *hwclock --systohc*"
36e96905
MB
22319msgstr ""
22320
22321#. type: Plain text
9b7051d5 22322#: ../sys-utils/hwclock.8.adoc:268
36e96905
MB
22323msgid "Systems without *adjtimex* may use *ntptime*."
22324msgstr ""
22325
22326#. type: Plain text
9b7051d5 22327#: ../sys-utils/hwclock.8.adoc:270
36e96905
MB
22328msgid ""
22329"Whether maintaining precision time with NTP daemon or not, it makes sense to "
22330"configure the system to keep reasonably good date-time on its own."
22331msgstr ""
22332
22333#. type: Plain text
9b7051d5 22334#: ../sys-utils/hwclock.8.adoc:272
36e96905
MB
22335msgid ""
22336"The first step in making that happen is having a clear understanding of the "
22337"big picture. There are two completely separate hardware devices running at "
22338"their own speed and drifting away from the 'correct' time at their own "
22339"rates. The methods and software for drift correction are different for each "
22340"of them. However, most systems are configured to exchange values between "
22341"these two clocks at startup and shutdown. Now the individual device's time "
22342"keeping errors are transferred back and forth between each other. Attempt to "
22343"configure drift correction for only one of them, and the other's drift will "
22344"be overlaid upon it."
22345msgstr ""
22346
22347#. type: Plain text
9b7051d5 22348#: ../sys-utils/hwclock.8.adoc:274
36e96905
MB
22349msgid ""
22350"This problem can be avoided when configuring drift correction for the System "
22351"Clock by simply not shutting down the machine. This, plus the fact that all "
7a29fa6f
MB
22352"of *hwclock*'s precision (including calculating drift factors) depends upon "
22353"the System Clock's rate being correct, means that configuration of the "
36e96905
MB
22354"System Clock should be done first."
22355msgstr ""
22356
22357#. type: Plain text
9b7051d5 22358#: ../sys-utils/hwclock.8.adoc:276
36e96905 22359msgid ""
7a29fa6f
MB
22360"The System Clock drift is corrected with the *adjtimex*(8) command's "
22361"*--tick* and *--frequency* options. These two work together: tick is the "
36e96905 22362"coarse adjustment and frequency is the fine adjustment. (For systems that do "
7a29fa6f 22363"not have an *adjtimex* package, *ntptime -f* _ppm_ may be used instead.)"
36e96905
MB
22364msgstr ""
22365
22366#. type: Plain text
9b7051d5 22367#: ../sys-utils/hwclock.8.adoc:278
36e96905
MB
22368msgid ""
22369"Some Linux distributions attempt to automatically calculate the System Clock "
7a29fa6f 22370"drift with *adjtimex*'s compare operation. Trying to correct one drifting "
36e96905
MB
22371"clock by using another drifting clock as a reference is akin to a dog trying "
22372"to catch its own tail. Success may happen eventually, but great effort and "
22373"frustration will likely precede it. This automation may yield an improvement "
22374"over no configuration, but expecting optimum results would be in error. A "
7a29fa6f 22375"better choice for manual configuration would be *adjtimex*'s *--log* "
36e96905
MB
22376"options."
22377msgstr ""
22378
22379#. type: Plain text
9b7051d5 22380#: ../sys-utils/hwclock.8.adoc:280
36e96905 22381msgid ""
7a29fa6f
MB
22382"It may be more effective to simply track the System Clock drift with *sntp*, "
22383"or *date -Ins* and a precision timepiece, and then calculate the correction "
22384"manually."
36e96905
MB
22385msgstr ""
22386
22387#. type: Plain text
9b7051d5 22388#: ../sys-utils/hwclock.8.adoc:282
36e96905
MB
22389msgid ""
22390"After setting the tick and frequency values, continue to test and refine the "
5db1d29a 22391"adjustments until the System Clock keeps good time. See *adjtimex*(2) for "
36e96905
MB
22392"more information and the example demonstrating manual drift calculations."
22393msgstr ""
22394
22395#. type: Plain text
9b7051d5 22396#: ../sys-utils/hwclock.8.adoc:284
36e96905
MB
22397msgid "Once the System Clock is ticking smoothly, move on to the Hardware Clock."
22398msgstr ""
22399
22400#. type: Plain text
9b7051d5 22401#: ../sys-utils/hwclock.8.adoc:286
36e96905
MB
22402msgid ""
22403"As a rule, cold drift will work best for most use cases. This should be true "
22404"even for 24/7 machines whose normal downtime consists of a reboot. In that "
22405"case the drift factor value makes little difference. But on the rare "
22406"occasion that the machine is shut down for an extended period, then cold "
22407"drift should yield better results."
22408msgstr ""
22409
22410#. type: Plain text
9b7051d5 22411#: ../sys-utils/hwclock.8.adoc:288
36e96905
MB
22412#, no-wrap
22413msgid "*Steps to calculate cold drift:*\n"
22414msgstr ""
22415
22416#. type: Plain text
9b7051d5 22417#: ../sys-utils/hwclock.8.adoc:291
36e96905
MB
22418#, no-wrap
22419msgid "*Ensure that NTP daemon will not be launched at startup.*\n"
22420msgstr ""
22421
22422#. type: Plain text
9b7051d5 22423#: ../sys-utils/hwclock.8.adoc:294
36e96905
MB
22424msgid "The _System Clock_ time must be correct at shutdown!"
22425msgstr ""
22426
22427#. type: Labeled list
9b7051d5 22428#: ../sys-utils/hwclock.8.adoc:295
36e96905
MB
22429#, no-wrap
22430msgid "3"
22431msgstr ""
22432
22433#. type: Plain text
9b7051d5 22434#: ../sys-utils/hwclock.8.adoc:297
36e96905
MB
22435msgid "Shut down the system."
22436msgstr ""
22437
22438#. type: Labeled list
9b7051d5 22439#: ../sys-utils/hwclock.8.adoc:298
36e96905
MB
22440#, no-wrap
22441msgid "4"
22442msgstr ""
22443
22444#. type: Plain text
9b7051d5 22445#: ../sys-utils/hwclock.8.adoc:300
36e96905
MB
22446msgid "Let an extended period pass without changing the Hardware Clock."
22447msgstr ""
22448
22449#. type: Labeled list
9b7051d5 22450#: ../sys-utils/hwclock.8.adoc:301
36e96905
MB
22451#, no-wrap
22452msgid "5"
22453msgstr ""
22454
22455#. type: Plain text
9b7051d5 22456#: ../sys-utils/hwclock.8.adoc:303
36e96905
MB
22457msgid "Start the system."
22458msgstr ""
22459
22460#. type: Labeled list
9b7051d5 22461#: ../sys-utils/hwclock.8.adoc:304
36e96905
MB
22462#, no-wrap
22463msgid "6"
22464msgstr ""
22465
22466#. type: Plain text
9b7051d5 22467#: ../sys-utils/hwclock.8.adoc:306
36e96905
MB
22468msgid ""
22469"Immediately use *hwclock* to set the correct time, adding the "
7a29fa6f 22470"*--update-drift* option."
36e96905
MB
22471msgstr ""
22472
22473#. type: Plain text
9b7051d5 22474#: ../sys-utils/hwclock.8.adoc:308
36e96905 22475msgid ""
7a29fa6f 22476"Note: if step 6 uses *--systohc*, then the System Clock must be set "
36e96905
MB
22477"correctly (step 6a) just before doing so."
22478msgstr ""
22479
22480#. type: Plain text
9b7051d5 22481#: ../sys-utils/hwclock.8.adoc:310
36e96905
MB
22482msgid ""
22483"Having *hwclock* calculate the drift factor is a good starting point, but "
22484"for optimal results it will likely need to be adjusted by directly editing "
22485"the _{ADJTIME_PATH}_ file. Continue to test and refine the drift factor "
22486"until the Hardware Clock is corrected properly at startup. To check this, "
22487"first make sure that the System Time is correct before shutdown and then use "
7a29fa6f 22488"*sntp*, or *date -Ins* and a precision timepiece, immediately after startup."
36e96905
MB
22489msgstr ""
22490
22491#. type: Title ===
9b7051d5 22492#: ../sys-utils/hwclock.8.adoc:311
36e96905
MB
22493#, no-wrap
22494msgid "LOCAL vs UTC"
22495msgstr ""
22496
22497#. type: Plain text
9b7051d5 22498#: ../sys-utils/hwclock.8.adoc:314
36e96905
MB
22499msgid ""
22500"Keeping the Hardware Clock in a local timescale causes inconsistent daylight "
22501"saving time results:"
22502msgstr ""
22503
22504#. type: Plain text
9b7051d5 22505#: ../sys-utils/hwclock.8.adoc:316
36e96905
MB
22506msgid ""
22507"If Linux is running during a daylight saving time change, the time written "
22508"to the Hardware Clock will be adjusted for the change."
22509msgstr ""
22510
22511#. type: Plain text
9b7051d5 22512#: ../sys-utils/hwclock.8.adoc:317
36e96905
MB
22513msgid ""
22514"If Linux is NOT running during a daylight saving time change, the time read "
22515"from the Hardware Clock will NOT be adjusted for the change."
22516msgstr ""
22517
22518#. type: Plain text
9b7051d5 22519#: ../sys-utils/hwclock.8.adoc:319
36e96905
MB
22520msgid ""
22521"The Hardware Clock on an ISA compatible system keeps only a date and time, "
22522"it has no concept of timezone nor daylight saving. Therefore, when *hwclock* "
22523"is told that it is in local time, it assumes it is in the 'correct' local "
22524"time and makes no adjustments to the time read from it."
22525msgstr ""
22526
22527#. type: Plain text
9b7051d5 22528#: ../sys-utils/hwclock.8.adoc:321
36e96905
MB
22529msgid ""
22530"Linux handles daylight saving time changes transparently only when the "
22531"Hardware Clock is kept in the UTC timescale. Doing so is made easy for "
7a29fa6f
MB
22532"system administrators as *hwclock* uses local time for its output and as the "
22533"argument to the *--date* option."
36e96905
MB
22534msgstr ""
22535
22536#. type: Plain text
9b7051d5 22537#: ../sys-utils/hwclock.8.adoc:323
36e96905
MB
22538msgid ""
22539"POSIX systems, like Linux, are designed to have the System Clock operate in "
22540"the UTC timescale. The Hardware Clock's purpose is to initialize the System "
22541"Clock, so also keeping it in UTC makes sense."
22542msgstr ""
22543
22544#. type: Plain text
9b7051d5 22545#: ../sys-utils/hwclock.8.adoc:325
36e96905
MB
22546msgid ""
22547"Linux does, however, attempt to accommodate the Hardware Clock being in the "
22548"local timescale. This is primarily for dual-booting with older versions of "
22549"MS Windows. From Windows 7 on, the RealTimeIsUniversal registry key is "
22550"supposed to be working properly so that its Hardware Clock can be kept in "
22551"UTC."
22552msgstr ""
22553
22554#. type: Title ===
9b7051d5 22555#: ../sys-utils/hwclock.8.adoc:326
36e96905
MB
22556#, no-wrap
22557msgid "POSIX vs 'RIGHT'"
22558msgstr ""
22559
22560#. type: Plain text
9b7051d5 22561#: ../sys-utils/hwclock.8.adoc:329
36e96905
MB
22562msgid ""
22563"A discussion on date-time configuration would be incomplete without "
22564"addressing timezones, this is mostly well covered by *tzset*(3). One area "
22565"that seems to have no documentation is the 'right' directory of the Time "
22566"Zone Database, sometimes called tz or zoneinfo."
22567msgstr ""
22568
9b7051d5 22569#. TRANSLATORS: Keep {plus} untranslated.
36e96905 22570#. type: Plain text
9b7051d5 22571#: ../sys-utils/hwclock.8.adoc:332
36e96905
MB
22572msgid ""
22573"There are two separate databases in the zoneinfo system, posix and "
22574"'right'. 'Right' (now named zoneinfo-leaps) includes leap seconds and posix "
5db1d29a 22575"does not. To use the 'right' database the System Clock must be set to (UTC "
b81d5971 22576"{plus} leap seconds), which is equivalent to (TAI - 10). This allows "
36e96905
MB
22577"calculating the exact number of seconds between two dates that cross a leap "
22578"second epoch. The System Clock is then converted to the correct civil time, "
22579"including UTC, by using the 'right' timezone files which subtract the leap "
22580"seconds. Note: this configuration is considered experimental and is known to "
22581"have issues."
22582msgstr ""
22583
22584#. type: Plain text
9b7051d5 22585#: ../sys-utils/hwclock.8.adoc:334
36e96905
MB
22586msgid ""
22587"To configure a system to use a particular database all of the files located "
7a29fa6f
MB
22588"in its directory must be copied to the root of _/usr/share/zoneinfo_. Files "
22589"are never used directly from the posix or 'right' subdirectories, e.g., "
5db1d29a 22590"TZ='_right/Europe/Dublin_'. This habit was becoming so common that the "
7a29fa6f
MB
22591"upstream zoneinfo project restructured the system's file tree by moving the "
22592"posix and 'right' subdirectories out of the zoneinfo directory and into "
22593"sibling directories:"
36e96905
MB
22594msgstr ""
22595
22596#. type: Plain text
9b7051d5 22597#: ../sys-utils/hwclock.8.adoc:336
36e96905
MB
22598msgid ""
22599"_/usr/share/zoneinfo_, _/usr/share/zoneinfo-posix_, "
22600"_/usr/share/zoneinfo-leaps_"
22601msgstr ""
22602
22603#. type: Plain text
9b7051d5 22604#: ../sys-utils/hwclock.8.adoc:338
36e96905
MB
22605msgid ""
22606"Unfortunately, some Linux distributions are changing it back to the old tree "
22607"structure in their packages. So the problem of system administrators "
22608"reaching into the 'right' subdirectory persists. This causes the system "
22609"timezone to be configured to include leap seconds while the zoneinfo "
22610"database is still configured to exclude them. Then when an application such "
22611"as a World Clock needs the South_Pole timezone file; or an email MTA, or "
22612"*hwclock* needs the UTC timezone file; they fetch it from the root of "
7a29fa6f
MB
22613"_/usr/share/zoneinfo_ , because that is what they are supposed to do. Those "
22614"files exclude leap seconds, but the System Clock now includes them, causing "
22615"an incorrect time conversion."
36e96905
MB
22616msgstr ""
22617
22618#. type: Plain text
9b7051d5 22619#: ../sys-utils/hwclock.8.adoc:340
36e96905
MB
22620msgid ""
22621"Attempting to mix and match files from these separate databases will not "
22622"work, because they each require the System Clock to use a different "
22623"timescale. The zoneinfo database must be configured to use either posix or "
22624"'right', as described above, or by assigning a database path to the _TZDIR_ "
22625"environment variable."
22626msgstr ""
22627
22628#. type: Plain text
9b7051d5 22629#: ../sys-utils/hwclock.8.adoc:344
36e96905
MB
22630msgid "One of the following exit values will be returned:"
22631msgstr ""
22632
22633#. type: Labeled list
9b7051d5 22634#: ../sys-utils/hwclock.8.adoc:345
36e96905
MB
22635#, no-wrap
22636msgid "*EXIT_SUCCESS* ('0' on POSIX systems)"
22637msgstr ""
22638
22639#. type: Plain text
9b7051d5 22640#: ../sys-utils/hwclock.8.adoc:347
36e96905
MB
22641msgid "Successful program execution."
22642msgstr ""
22643
22644#. type: Labeled list
9b7051d5 22645#: ../sys-utils/hwclock.8.adoc:348
36e96905
MB
22646#, no-wrap
22647msgid "*EXIT_FAILURE* ('1' on POSIX systems)"
22648msgstr ""
22649
22650#. type: Plain text
9b7051d5 22651#: ../sys-utils/hwclock.8.adoc:350
36e96905
MB
22652msgid "The operation failed or the command syntax was not valid."
22653msgstr ""
22654
22655#. type: Labeled list
9b7051d5 22656#: ../sys-utils/hwclock.8.adoc:353
36e96905
MB
22657#, no-wrap
22658msgid "*TZ*"
22659msgstr ""
22660
22661#. type: Plain text
9b7051d5 22662#: ../sys-utils/hwclock.8.adoc:355
36e96905
MB
22663msgid ""
22664"If this variable is set its value takes precedence over the system "
22665"configured timezone."
22666msgstr ""
22667
22668#. type: Labeled list
9b7051d5 22669#: ../sys-utils/hwclock.8.adoc:356
36e96905
MB
22670#, no-wrap
22671msgid "*TZDIR*"
22672msgstr ""
22673
22674#. type: Plain text
9b7051d5 22675#: ../sys-utils/hwclock.8.adoc:358
36e96905
MB
22676msgid ""
22677"If this variable is set its value takes precedence over the system "
22678"configured timezone database directory path."
22679msgstr ""
22680
22681#. type: Plain text
9b7051d5 22682#: ../sys-utils/hwclock.8.adoc:361 ../sys-utils/rtcwake.8.adoc:121
36e96905
MB
22683#, no-wrap
22684msgid "_{ADJTIME_PATH}_"
22685msgstr ""
22686
22687#. type: Plain text
9b7051d5 22688#: ../sys-utils/hwclock.8.adoc:363
36e96905
MB
22689msgid "The configuration and state file for hwclock."
22690msgstr ""
22691
22692#. type: Labeled list
9b7051d5 22693#: ../sys-utils/hwclock.8.adoc:364
36e96905
MB
22694#, no-wrap
22695msgid "_/etc/localtime_"
22696msgstr ""
22697
22698#. type: Plain text
9b7051d5 22699#: ../sys-utils/hwclock.8.adoc:366
36e96905
MB
22700msgid "The system timezone file."
22701msgstr ""
22702
22703#. type: Labeled list
9b7051d5 22704#: ../sys-utils/hwclock.8.adoc:367
36e96905
MB
22705#, no-wrap
22706msgid "_/usr/share/zoneinfo/_"
22707msgstr ""
22708
22709#. type: Plain text
9b7051d5 22710#: ../sys-utils/hwclock.8.adoc:369
36e96905
MB
22711msgid "The system timezone database directory."
22712msgstr ""
22713
22714#. type: Plain text
9b7051d5 22715#: ../sys-utils/hwclock.8.adoc:371
36e96905
MB
22716msgid ""
22717"Device files *hwclock* may try for Hardware Clock access: _/dev/rtc0_ "
22718"_/dev/rtc_ _/dev/misc/rtc_ _/dev/efirtc_ _/dev/misc/efirtc_"
22719msgstr ""
22720
22721#. type: Plain text
9b7051d5 22722#: ../sys-utils/hwclock.8.adoc:380
36e96905
MB
22723#, no-wrap
22724msgid ""
22725"*date*(1),\n"
22726"*adjtimex*(8),\n"
22727"*gettimeofday*(2),\n"
22728"*settimeofday*(2),\n"
22729"*crontab*(1p),\n"
22730"*tzset*(3)\n"
22731msgstr ""
22732
22733#. type: Plain text
9b7051d5 22734#: ../sys-utils/hwclock.8.adoc:384
36e96905
MB
22735msgid ""
22736"Written by mailto:bryanh@giraffe-data.com[Bryan Henderson], September 1996, "
7a29fa6f
MB
22737"based on work done on the *clock*(8) program by Charles Hedrick, Rob Hooft, "
22738"and Harald Koenig. See the source code for complete history and credits."
36e96905
MB
22739msgstr ""
22740
22741#. Copyright 2008 Hayden A. James (hayden.james@gmail.com)
22742#. May be distributed under the GNU General Public License
22743#. type: Title =
22744#: ../sys-utils/ipcmk.1.adoc:6
22745#, no-wrap
22746msgid "ipcmk(1)"
22747msgstr ""
22748
22749#. type: Plain text
22750#: ../sys-utils/ipcmk.1.adoc:16
22751msgid "ipcmk - make various IPC resources"
22752msgstr ""
22753
22754#. type: Plain text
22755#: ../sys-utils/ipcmk.1.adoc:20
22756#, no-wrap
22757msgid "*ipcmk* [options]\n"
22758msgstr ""
22759
22760#. type: Plain text
22761#: ../sys-utils/ipcmk.1.adoc:24
22762#, no-wrap
22763msgid ""
22764"*ipcmk* allows you to create System V inter-process communication (IPC) "
22765"objects: shared memory segments, message queues, and semaphore arrays.\n"
22766msgstr ""
22767
22768#. type: Plain text
22769#: ../sys-utils/ipcmk.1.adoc:28
22770msgid "Resources can be specified with these options:"
22771msgstr ""
22772
22773#. type: Labeled list
22774#: ../sys-utils/ipcmk.1.adoc:29
22775#, no-wrap
22776msgid "*-M*, *--shmem* _size_"
22777msgstr ""
22778
22779#. type: Plain text
22780#: ../sys-utils/ipcmk.1.adoc:31
22781msgid ""
22782"Create a shared memory segment of _size_ bytes. The _size_ argument may be "
22783"followed by the multiplicative suffixes KiB (=1024), MiB (=1024*1024), and "
22784"so on for GiB, etc. (the \"iB\" is optional, e.g., \"K\" has the same "
22785"meaning as \"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on "
22786"for GB, etc."
22787msgstr ""
22788
22789#. type: Labeled list
22790#: ../sys-utils/ipcmk.1.adoc:32
22791#, no-wrap
22792msgid "*-Q*, *--queue*"
22793msgstr ""
22794
22795#. type: Plain text
22796#: ../sys-utils/ipcmk.1.adoc:34
22797msgid "Create a message queue."
22798msgstr ""
22799
22800#. type: Labeled list
22801#: ../sys-utils/ipcmk.1.adoc:35
22802#, no-wrap
22803msgid "*-S*, *--semaphore* _number_"
22804msgstr ""
22805
22806#. type: Plain text
22807#: ../sys-utils/ipcmk.1.adoc:37
22808msgid "Create a semaphore array with _number_ of elements."
22809msgstr ""
22810
22811#. type: Plain text
22812#: ../sys-utils/ipcmk.1.adoc:39
22813msgid "Other options are:"
22814msgstr ""
22815
22816#. type: Labeled list
22817#: ../sys-utils/ipcmk.1.adoc:40
22818#, no-wrap
22819msgid "*-p*, *--mode* _mode_"
22820msgstr ""
22821
22822#. type: Plain text
22823#: ../sys-utils/ipcmk.1.adoc:42
22824msgid "Access permissions for the resource. Default is 0644."
22825msgstr ""
22826
22827#. type: Plain text
22828#: ../sys-utils/ipcmk.1.adoc:52
22829msgid "mailto:hayden.james@gmail.com[Hayden A. James]"
22830msgstr ""
22831
22832#. type: Plain text
22833#: ../sys-utils/ipcmk.1.adoc:58
22834#, no-wrap
22835msgid ""
22836"*ipcrm*(1),\n"
22837"*ipcs*(1),\n"
22838"*sysvipc*(7)\n"
22839msgstr ""
22840
22841#. Copyright 2002 Andre C. Mazzone (linuxdev@karagee.com)
22842#. May be distributed under the GNU General Public License
22843#. type: Title =
22844#: ../sys-utils/ipcrm.1.adoc:6
22845#, no-wrap
22846msgid "ipcrm(1)"
22847msgstr ""
22848
22849#. type: Plain text
22850#: ../sys-utils/ipcrm.1.adoc:17
22851msgid "ipcrm - remove certain IPC resources"
22852msgstr ""
22853
22854#. type: Plain text
22855#: ../sys-utils/ipcrm.1.adoc:21
22856#, no-wrap
22857msgid "*ipcrm* [options]\n"
22858msgstr ""
22859
22860#. type: Plain text
22861#: ../sys-utils/ipcrm.1.adoc:23
22862#, no-wrap
22863msgid "*ipcrm* [*shm*|*msg*|*sem*] _ID_ ...\n"
22864msgstr ""
22865
22866#. type: Plain text
22867#: ../sys-utils/ipcrm.1.adoc:27
22868#, no-wrap
22869msgid ""
22870"*ipcrm* removes System V inter-process communication (IPC) objects and "
22871"associated data structures from the system. In order to delete such objects, "
22872"you must be superuser, or the creator or owner of the object.\n"
22873msgstr ""
22874
22875#. type: Plain text
22876#: ../sys-utils/ipcrm.1.adoc:29
22877msgid ""
22878"System V IPC objects are of three types: shared memory, message queues, and "
22879"semaphores. Deletion of a message queue or semaphore object is immediate "
22880"(regardless of whether any process still holds an IPC identifier for the "
22881"object). A shared memory object is only removed after all currently attached "
22882"processes have detached (*shmdt*(2)) the object from their virtual address "
22883"space."
22884msgstr ""
22885
22886#. type: Plain text
22887#: ../sys-utils/ipcrm.1.adoc:31
22888msgid ""
22889"Two syntax styles are supported. The old Linux historical syntax specifies a "
22890"three-letter keyword indicating which class of object is to be deleted, "
22891"followed by one or more IPC identifiers for objects of this type."
22892msgstr ""
22893
22894#. type: Plain text
22895#: ../sys-utils/ipcrm.1.adoc:33
22896msgid ""
22897"The SUS-compliant syntax allows the specification of zero or more objects of "
22898"all three types in a single command line, with objects specified either by "
22899"key or by identifier (see below). Both keys and identifiers may be specified "
22900"in decimal, hexadecimal (specified with an initial '0x' or '0X'), or octal "
22901"(specified with an initial '0')."
22902msgstr ""
22903
22904#. type: Plain text
22905#: ../sys-utils/ipcrm.1.adoc:35
22906msgid ""
22907"The details of the removes are described in *shmctl*(2), *msgctl*(2), and "
22908"*semctl*(2). The identifiers and keys can be found by using *ipcs*(1)."
22909msgstr ""
22910
22911#. type: Labeled list
22912#: ../sys-utils/ipcrm.1.adoc:38
22913#, no-wrap
22914msgid "*-a*, *--all* [*shm*] [*msg*] [*sem*]"
22915msgstr ""
22916
22917#. type: Plain text
22918#: ../sys-utils/ipcrm.1.adoc:40
22919msgid ""
22920"Remove all resources. When an option argument is provided, the removal is "
22921"performed only for the specified resource types."
22922msgstr ""
22923
22924#. type: Plain text
22925#: ../sys-utils/ipcrm.1.adoc:42
22926msgid ""
22927"_Warning!_ Do not use *-a* if you are unsure how the software using the "
22928"resources might react to missing objects. Some programs create these "
22929"resources at startup and may not have any code to deal with an unexpected "
22930"disappearance."
22931msgstr ""
22932
22933#. type: Labeled list
22934#: ../sys-utils/ipcrm.1.adoc:43
22935#, no-wrap
22936msgid "*-M*, *--shmem-key* _shmkey_"
22937msgstr ""
22938
22939#. type: Plain text
22940#: ../sys-utils/ipcrm.1.adoc:45
22941msgid ""
22942"Remove the shared memory segment created with _shmkey_ after the last detach "
22943"is performed."
22944msgstr ""
22945
22946#. type: Labeled list
22947#: ../sys-utils/ipcrm.1.adoc:46
22948#, no-wrap
22949msgid "*-m*, *--shmem-id* _shmid_"
22950msgstr ""
22951
22952#. type: Plain text
22953#: ../sys-utils/ipcrm.1.adoc:48
22954msgid ""
22955"Remove the shared memory segment identified by _shmid_ after the last detach "
22956"is performed."
22957msgstr ""
22958
22959#. type: Labeled list
22960#: ../sys-utils/ipcrm.1.adoc:49
22961#, no-wrap
22962msgid "*-Q*, *--queue-key* _msgkey_"
22963msgstr ""
22964
22965#. type: Plain text
22966#: ../sys-utils/ipcrm.1.adoc:51
22967msgid "Remove the message queue created with _msgkey_."
22968msgstr ""
22969
22970#. type: Labeled list
22971#: ../sys-utils/ipcrm.1.adoc:52
22972#, no-wrap
22973msgid "*-q*, *--queue-id* _msgid_"
22974msgstr ""
22975
22976#. type: Plain text
22977#: ../sys-utils/ipcrm.1.adoc:54
22978msgid "Remove the message queue identified by _msgid_."
22979msgstr ""
22980
22981#. type: Labeled list
22982#: ../sys-utils/ipcrm.1.adoc:55
22983#, no-wrap
22984msgid "*-S*, *--semaphore-key* _semkey_"
22985msgstr ""
22986
22987#. type: Plain text
22988#: ../sys-utils/ipcrm.1.adoc:57
22989msgid "Remove the semaphore created with _semkey_."
22990msgstr ""
22991
22992#. type: Labeled list
22993#: ../sys-utils/ipcrm.1.adoc:58
22994#, no-wrap
22995msgid "*-s*, *--semaphore-id* _semid_"
22996msgstr ""
22997
22998#. type: Plain text
22999#: ../sys-utils/ipcrm.1.adoc:60
23000msgid "Remove the semaphore identified by _semid_."
23001msgstr ""
23002
23003#. TRANSLATORS: Keep {asterisk} untranslated; it expands to "*nix".
23004#. type: Plain text
23005#: ../sys-utils/ipcrm.1.adoc:71
23006msgid ""
23007"In its first Linux implementation, *ipcrm* used the deprecated syntax shown "
23008"in the second line of the *SYNOPSIS*. Functionality present in other "
23009"{asterisk}nix implementations of *ipcrm* has since been added, namely the "
23010"ability to delete resources by key (not just identifier), and to respect the "
23011"same command-line syntax. For backward compatibility the previous syntax is "
23012"still supported."
23013msgstr ""
23014
23015#. type: Plain text
23016#: ../sys-utils/ipcrm.1.adoc:85
23017#, no-wrap
23018msgid ""
23019"*ipcmk*(1),\n"
23020"*ipcs*(1),\n"
23021"*msgctl*(2),\n"
23022"*msgget*(2),\n"
23023"*semctl*(2),\n"
23024"*semget*(2),\n"
23025"*shmctl*(2),\n"
23026"*shmdt*(2),\n"
23027"*shmget*(2),\n"
23028"*ftok*(3),\n"
23029"*sysvipc*(7)\n"
23030msgstr ""
23031
23032#. Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
23033#. May be distributed under the GNU General Public License
23034#. type: Title =
23035#: ../sys-utils/ipcs.1.adoc:6
23036#, no-wrap
23037msgid "ipcs(1)"
23038msgstr ""
23039
23040#. type: Plain text
23041#: ../sys-utils/ipcs.1.adoc:16
23042msgid "ipcs - show information on IPC facilities"
23043msgstr ""
23044
23045#. type: Plain text
23046#: ../sys-utils/ipcs.1.adoc:20
23047#, no-wrap
23048msgid "*ipcs* [options]\n"
23049msgstr ""
23050
23051#. type: Plain text
23052#: ../sys-utils/ipcs.1.adoc:24
23053#, no-wrap
23054msgid ""
23055"*ipcs* shows information on System V inter-process communication "
23056"facilities. By default it shows information about all three resources: "
23057"shared memory segments, message queues, and semaphore arrays.\n"
23058msgstr ""
23059
23060#. type: Labeled list
23061#: ../sys-utils/ipcs.1.adoc:27 ../sys-utils/lsipc.1.adoc:23
23062#, no-wrap
23063msgid "*-i*, *--id* _id_"
23064msgstr ""
23065
23066#. type: Plain text
23067#: ../sys-utils/ipcs.1.adoc:29
23068msgid ""
23069"Show full details on just the one resource element identified by _id_. This "
23070"option needs to be combined with one of the three resource options: *-m*, "
23071"*-q* or *-s*."
23072msgstr ""
23073
23074#. type: Title ===
23075#: ../sys-utils/ipcs.1.adoc:36 ../sys-utils/lsipc.1.adoc:35
23076#, no-wrap
23077msgid "Resource options"
23078msgstr ""
23079
23080#. type: Labeled list
23081#: ../sys-utils/ipcs.1.adoc:38 ../sys-utils/lsipc.1.adoc:37
23082#, no-wrap
23083msgid "*-m*, *--shmems*"
23084msgstr ""
23085
23086#. type: Plain text
23087#: ../sys-utils/ipcs.1.adoc:40 ../sys-utils/lsipc.1.adoc:39
23088msgid "Write information about active shared memory segments."
23089msgstr ""
23090
23091#. type: Labeled list
23092#: ../sys-utils/ipcs.1.adoc:41 ../sys-utils/lsipc.1.adoc:40
23093#, no-wrap
23094msgid "*-q*, *--queues*"
23095msgstr ""
23096
23097#. type: Plain text
23098#: ../sys-utils/ipcs.1.adoc:43 ../sys-utils/lsipc.1.adoc:42
23099msgid "Write information about active message queues."
23100msgstr ""
23101
23102#. type: Labeled list
23103#: ../sys-utils/ipcs.1.adoc:44 ../sys-utils/lsipc.1.adoc:43
23104#, no-wrap
23105msgid "*-s*, *--semaphores*"
23106msgstr ""
23107
23108#. type: Plain text
23109#: ../sys-utils/ipcs.1.adoc:46 ../sys-utils/lsipc.1.adoc:45
23110msgid "Write information about active semaphore sets."
23111msgstr ""
23112
23113#. type: Plain text
23114#: ../sys-utils/ipcs.1.adoc:49
23115msgid "Write information about all three resources (default)."
23116msgstr ""
23117
23118#. type: Title ===
23119#: ../sys-utils/ipcs.1.adoc:50
23120#, no-wrap
23121msgid "Output formats"
23122msgstr ""
23123
23124#. type: Plain text
23125#: ../sys-utils/ipcs.1.adoc:53
23126msgid "Of these options only one takes effect: the last one specified."
23127msgstr ""
23128
23129#. type: Labeled list
23130#: ../sys-utils/ipcs.1.adoc:54 ../sys-utils/lsipc.1.adoc:48
23131#, no-wrap
23132msgid "*-c*, *--creator*"
23133msgstr ""
23134
23135#. type: Plain text
23136#: ../sys-utils/ipcs.1.adoc:56 ../sys-utils/lsipc.1.adoc:50
23137msgid "Show creator and owner."
23138msgstr ""
23139
23140#. type: Labeled list
23141#: ../sys-utils/ipcs.1.adoc:57
23142#, no-wrap
23143msgid "*-l*, *--limits*"
23144msgstr ""
23145
23146#. type: Plain text
23147#: ../sys-utils/ipcs.1.adoc:59
23148msgid "Show resource limits."
23149msgstr ""
23150
23151#. type: Plain text
23152#: ../sys-utils/ipcs.1.adoc:62
23153msgid "Show PIDs of creator and last operator."
23154msgstr ""
23155
23156#. type: Plain text
23157#: ../sys-utils/ipcs.1.adoc:65 ../sys-utils/lsipc.1.adoc:80
23158msgid ""
23159"Write time information. The time of the last control operation that changed "
23160"the access permissions for all facilities, the time of the last *msgsnd*(2) "
23161"and *msgrcv*(2) operations on message queues, the time of the last "
23162"*shmat*(2) and *shmdt*(2) operations on shared memory, and the time of the "
23163"last *semop*(2) operation on semaphores."
23164msgstr ""
23165
23166#. type: Labeled list
23167#: ../sys-utils/ipcs.1.adoc:66
23168#, no-wrap
23169msgid "*-u*, *--summary*"
23170msgstr ""
23171
23172#. type: Plain text
23173#: ../sys-utils/ipcs.1.adoc:68
23174msgid "Show status summary."
23175msgstr ""
23176
23177#. type: Title ===
23178#: ../sys-utils/ipcs.1.adoc:69
23179#, no-wrap
23180msgid "Representation"
23181msgstr ""
23182
23183#. type: Plain text
23184#: ../sys-utils/ipcs.1.adoc:72
23185msgid "These affect only the *-l* (*--limits*) option."
23186msgstr ""
23187
23188#. type: Plain text
23189#: ../sys-utils/ipcs.1.adoc:75
23190msgid "Print sizes in bytes."
23191msgstr ""
23192
23193#. type: Labeled list
23194#: ../sys-utils/ipcs.1.adoc:76
23195#, no-wrap
23196msgid "*--human*"
23197msgstr ""
23198
23199#. type: Plain text
23200#: ../sys-utils/ipcs.1.adoc:78
23201msgid "Print sizes in human-readable format."
23202msgstr ""
23203
23204#. type: Plain text
23205#: ../sys-utils/ipcs.1.adoc:82
23206msgid ""
23207"The Linux *ipcs* utility is not fully compatible to the POSIX *ipcs* "
23208"utility. The Linux version does not support the POSIX *-a*, *-b* and *-o* "
23209"options, but does support the *-l* and *-u* options not defined by POSIX. A "
23210"portable application shall not use the *-a*, *-b*, *-o*, *-l*, and *-u* "
23211"options."
23212msgstr ""
23213
23214#. type: Plain text
23215#: ../sys-utils/ipcs.1.adoc:86
23216msgid ""
23217"The current implementation of *ipcs* obtains information about available IPC "
23218"resources by parsing the files in _/proc/sysvipc_. Before util-linux version "
23219"v2.23, an alternate mechanism was used: the *IPC_STAT* command of "
23220"*msgctl*(2), *semctl*(2), and *shmctl*(2). This mechanism is also used in "
23221"later util-linux versions in the case where _/proc_ is unavailable. A "
23222"limitation of the *IPC_STAT* mechanism is that it can only be used to "
23223"retrieve information about IPC resources for which the user has read "
23224"permission."
23225msgstr ""
23226
23227#. type: Plain text
23228#: ../sys-utils/ipcs.1.adoc:90
23229msgid "mailto:balasub@cis.ohio-state.edu[Krishna Balasubramanian]"
23230msgstr ""
23231
23232#. type: Plain text
23233#: ../sys-utils/ipcs.1.adoc:103 ../sys-utils/lsipc.1.adoc:119
23234#, no-wrap
23235msgid ""
23236"*ipcmk*(1),\n"
23237"*ipcrm*(1),\n"
23238"*msgrcv*(2),\n"
23239"*msgsnd*(2),\n"
23240"*semget*(2),\n"
23241"*semop*(2),\n"
23242"*shmat*(2),\n"
23243"*shmdt*(2),\n"
23244"*shmget*(2),\n"
23245"*sysvipc*(7)\n"
23246msgstr ""
23247
23248#. type: Title =
23249#: ../sys-utils/irqtop.1.adoc:2
23250#, no-wrap
23251msgid "irqtop(1)"
23252msgstr ""
23253
23254#. type: Plain text
23255#: ../sys-utils/irqtop.1.adoc:12
23256msgid "irqtop - utility to display kernel interrupt information"
23257msgstr ""
23258
23259#. type: Plain text
23260#: ../sys-utils/irqtop.1.adoc:16
23261#, no-wrap
23262msgid "*irqtop* [options]\n"
23263msgstr ""
23264
23265#. type: Plain text
23266#: ../sys-utils/irqtop.1.adoc:20
23267msgid "Display kernel interrupt counter information in *top*(1) style view."
23268msgstr ""
23269
23270#. type: Plain text
23271#: ../sys-utils/irqtop.1.adoc:22 ../sys-utils/lsirq.1.adoc:22
23272msgid ""
23273"The default output is subject to change. So whenever possible, you should "
23274"avoid using default outputs in your scripts. Always explicitly define "
23275"expected columns by using *--output*."
23276msgstr ""
23277
23278#. type: Plain text
23279#: ../sys-utils/irqtop.1.adoc:27 ../sys-utils/lsirq.1.adoc:30
23280msgid ""
23281"Specify which output columns to print. Use *--help* to get a list of all "
23282"supported columns. The default list of columns may be extended if list is "
23283"specified in the format _+list_."
23284msgstr ""
23285
23286#. type: Labeled list
23287#: ../sys-utils/irqtop.1.adoc:28
23288#, no-wrap
23289msgid "*-d*, *--delay* _seconds_"
23290msgstr ""
23291
23292#. type: Plain text
23293#: ../sys-utils/irqtop.1.adoc:30
23294msgid "Update interrupt output every _seconds_ intervals."
23295msgstr ""
23296
23297#. type: Labeled list
23298#: ../sys-utils/irqtop.1.adoc:31 ../sys-utils/lsirq.1.adoc:31
23299#, no-wrap
23300msgid "*-s*, *--sort* _column_"
23301msgstr ""
23302
23303#. type: Plain text
23304#: ../sys-utils/irqtop.1.adoc:33
23305msgid ""
23306"Specify sort criteria by column name. See *--help* output to get column "
23307"names. The sort criteria may be changes in interactive mode."
23308msgstr ""
23309
23310#. type: Labeled list
23311#: ../sys-utils/irqtop.1.adoc:34 ../sys-utils/lsirq.1.adoc:40
23312#, no-wrap
23313msgid "*-S*, *--softirq*"
23314msgstr ""
23315
23316#. type: Plain text
23317#: ../sys-utils/irqtop.1.adoc:36 ../sys-utils/lsirq.1.adoc:42
23318msgid "Show softirqs information."
23319msgstr ""
23320
23321#. type: Title ==
23322#: ../sys-utils/irqtop.1.adoc:43
23323#, no-wrap
23324msgid "INTERACTIVE MODE KEY COMMANDS"
23325msgstr ""
23326
23327#. type: Labeled list
23328#: ../sys-utils/irqtop.1.adoc:45
23329#, no-wrap
23330msgid "*i*"
23331msgstr ""
23332
23333#. type: Plain text
23334#: ../sys-utils/irqtop.1.adoc:47
23335msgid "sort by short irq name or number field"
23336msgstr ""
23337
23338#. type: Plain text
23339#: ../sys-utils/irqtop.1.adoc:50
23340msgid "sort by total count of interrupts (the default)"
23341msgstr ""
23342
23343#. type: Plain text
23344#: ../sys-utils/irqtop.1.adoc:53
23345msgid "sort by delta count of interrupts"
23346msgstr ""
23347
23348#. type: Plain text
23349#: ../sys-utils/irqtop.1.adoc:56
23350msgid "sort by long descriptive name field"
23351msgstr ""
23352
23353#. type: Labeled list
23354#: ../sys-utils/irqtop.1.adoc:57
23355#, no-wrap
23356msgid "*q Q*"
23357msgstr ""
23358
23359#. type: Plain text
23360#: ../sys-utils/irqtop.1.adoc:59
23361msgid "stop updates and exit program"
23362msgstr ""
23363
23364#. type: Plain text
23365#: ../sys-utils/irqtop.1.adoc:65 ../sys-utils/lsirq.1.adoc:54
23366msgid ""
23367"mailto:pizhenwei@bytedance.com[Zhenwei Pi], mailto:kerolasa@iki.fi[Sami "
23368"Kerola], mailto:kzak@redhat.com[Karel Zak]"
23369msgstr ""
23370
23371#. Copyright 2008 Tilman Schmidt (tilman@imap.cc)
23372#. May be distributed under the GNU General Public License version 2 or later
23373#. type: Title =
23374#: ../sys-utils/ldattach.8.adoc:6
23375#, no-wrap
23376msgid "ldattach(8)"
23377msgstr ""
23378
23379#. type: Plain text
23380#: ../sys-utils/ldattach.8.adoc:16
23381msgid "ldattach - attach a line discipline to a serial line"
23382msgstr ""
23383
23384#. type: Plain text
23385#: ../sys-utils/ldattach.8.adoc:20
23386#, no-wrap
23387msgid "*ldattach* [*-1278denoVh*] [*-i* _iflag_] [*-s* _speed_] _ldisc device_\n"
23388msgstr ""
23389
23390#. type: Plain text
23391#: ../sys-utils/ldattach.8.adoc:24
23392msgid ""
23393"The *ldattach* daemon opens the specified _device_ file (which should refer "
23394"to a serial device) and attaches the line discipline _ldisc_ to it for "
23395"processing of the sent and/or received data. It then goes into the "
23396"background keeping the device open so that the line discipline stays loaded."
23397msgstr ""
23398
23399#. type: Plain text
23400#: ../sys-utils/ldattach.8.adoc:26
23401msgid "The line discipline _ldisc_ may be specified either by name or by number."
23402msgstr ""
23403
23404#. type: Plain text
23405#: ../sys-utils/ldattach.8.adoc:28
23406msgid "In order to detach the line discipline, *kill*(1) the *ldattach* process."
23407msgstr ""
23408
23409#. type: Plain text
23410#: ../sys-utils/ldattach.8.adoc:30
23411msgid "With no arguments, *ldattach* prints usage information."
23412msgstr ""
23413
23414#. type: Title ==
23415#: ../sys-utils/ldattach.8.adoc:31
23416#, no-wrap
23417msgid "LINE DISCIPLINES"
23418msgstr ""
23419
23420#. type: Plain text
23421#: ../sys-utils/ldattach.8.adoc:34
23422msgid ""
23423"Depending on the kernel release, the following line disciplines are "
23424"supported:"
23425msgstr ""
23426
23427#. type: Labeled list
23428#: ../sys-utils/ldattach.8.adoc:35
23429#, no-wrap
23430msgid "*TTY*(*0*)"
23431msgstr ""
23432
23433#. type: Plain text
23434#: ../sys-utils/ldattach.8.adoc:37
23435msgid ""
23436"The default line discipline, providing transparent operation (raw mode) as "
23437"well as the habitual terminal line editing capabilities (cooked mode)."
23438msgstr ""
23439
23440#. type: Labeled list
23441#: ../sys-utils/ldattach.8.adoc:38
23442#, no-wrap
23443msgid "*SLIP*(*1*)"
23444msgstr ""
23445
23446#. type: Plain text
23447#: ../sys-utils/ldattach.8.adoc:40
23448msgid ""
23449"Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets "
23450"over serial lines."
23451msgstr ""
23452
23453#. type: Labeled list
23454#: ../sys-utils/ldattach.8.adoc:41
23455#, no-wrap
23456msgid "*MOUSE*(*2*)"
23457msgstr ""
23458
23459#. type: Plain text
23460#: ../sys-utils/ldattach.8.adoc:43
23461msgid "Device driver for RS232 connected pointing devices (serial mice)."
23462msgstr ""
23463
23464#. type: Labeled list
23465#: ../sys-utils/ldattach.8.adoc:44
23466#, no-wrap
23467msgid "*PPP*(*3*)"
23468msgstr ""
23469
23470#. type: Plain text
23471#: ../sys-utils/ldattach.8.adoc:46
23472msgid ""
23473"Point to Point Protocol (PPP) processor for transmitting network packets "
23474"over serial lines."
23475msgstr ""
23476
23477#. type: Labeled list
23478#: ../sys-utils/ldattach.8.adoc:47
23479#, no-wrap
23480msgid "*STRIP*(*4*); *AX25*(*5*); *X25*(*6*)"
23481msgstr ""
23482
23483#. type: Plain text
23484#: ../sys-utils/ldattach.8.adoc:49
23485msgid "Line driver for transmitting X.25 packets over asynchronous serial lines."
23486msgstr ""
23487
23488#. type: Labeled list
23489#: ../sys-utils/ldattach.8.adoc:50
23490#, no-wrap
23491msgid "*6PACK*(*7*); *R3964*(*9*)"
23492msgstr ""
23493
23494#. type: Plain text
23495#: ../sys-utils/ldattach.8.adoc:52
23496msgid "Driver for Simatic R3964 module."
23497msgstr ""
23498
23499#. type: Labeled list
23500#: ../sys-utils/ldattach.8.adoc:53
23501#, no-wrap
23502msgid "*IRDA*(*11*)"
23503msgstr ""
23504
23505#. type: Plain text
23506#: ../sys-utils/ldattach.8.adoc:55
23507msgid ""
23508"Linux IrDa (infrared data transmission) driver - see "
23509"http://irda.sourceforge.net/"
23510msgstr ""
23511
23512#. type: Labeled list
23513#: ../sys-utils/ldattach.8.adoc:56
23514#, no-wrap
23515msgid "*HDLC*(*13*)"
23516msgstr ""
23517
23518#. type: Plain text
23519#: ../sys-utils/ldattach.8.adoc:58
23520msgid "Synchronous HDLC driver."
23521msgstr ""
23522
23523#. type: Labeled list
23524#: ../sys-utils/ldattach.8.adoc:59
23525#, no-wrap
23526msgid "*SYNC_PPP*(*14*)"
23527msgstr ""
23528
23529#. type: Plain text
23530#: ../sys-utils/ldattach.8.adoc:61
23531msgid "Synchronous PPP driver."
23532msgstr ""
23533
23534#. type: Labeled list
23535#: ../sys-utils/ldattach.8.adoc:62
23536#, no-wrap
23537msgid "*HCI*(*15*)"
23538msgstr ""
23539
23540#. type: Plain text
23541#: ../sys-utils/ldattach.8.adoc:64
23542msgid "Bluetooth HCI UART driver."
23543msgstr ""
23544
23545#. type: Labeled list
23546#: ../sys-utils/ldattach.8.adoc:65
23547#, no-wrap
23548msgid "*GIGASET_M101*(*16*)"
23549msgstr ""
23550
23551#. type: Plain text
23552#: ../sys-utils/ldattach.8.adoc:67
23553msgid "Driver for Siemens Gigaset M101 serial DECT adapter."
23554msgstr ""
23555
23556#. type: Labeled list
23557#: ../sys-utils/ldattach.8.adoc:68
23558#, no-wrap
23559msgid "*PPS*(*18*)"
23560msgstr ""
23561
23562#. type: Plain text
23563#: ../sys-utils/ldattach.8.adoc:70
23564msgid "Driver for serial line Pulse Per Second (PPS) source."
23565msgstr ""
23566
23567#. type: Labeled list
23568#: ../sys-utils/ldattach.8.adoc:71
23569#, no-wrap
23570msgid "*GSM0710*(*21*)"
23571msgstr ""
23572
23573#. type: Plain text
23574#: ../sys-utils/ldattach.8.adoc:73
23575msgid "Driver for GSM 07.10 multiplexing protocol modem (CMUX)."
23576msgstr ""
23577
23578#. type: Labeled list
23579#: ../sys-utils/ldattach.8.adoc:76
23580#, no-wrap
23581msgid "*-1*, *--onestopbit*"
23582msgstr ""
23583
23584#. type: Plain text
23585#: ../sys-utils/ldattach.8.adoc:78
23586msgid "Set the number of stop bits of the serial line to one."
23587msgstr ""
23588
23589#. type: Labeled list
23590#: ../sys-utils/ldattach.8.adoc:79
23591#, no-wrap
23592msgid "*-2*, *--twostopbits*"
23593msgstr ""
23594
23595#. type: Plain text
23596#: ../sys-utils/ldattach.8.adoc:81
23597msgid "Set the number of stop bits of the serial line to two."
23598msgstr ""
23599
23600#. type: Labeled list
23601#: ../sys-utils/ldattach.8.adoc:82
23602#, no-wrap
23603msgid "*-7*, *--sevenbits*"
23604msgstr ""
23605
23606#. type: Plain text
23607#: ../sys-utils/ldattach.8.adoc:84
23608msgid "Set the character size of the serial line to 7 bits."
23609msgstr ""
23610
23611#. type: Labeled list
23612#: ../sys-utils/ldattach.8.adoc:85
23613#, no-wrap
23614msgid "*-8*, *--eightbits*"
23615msgstr ""
23616
23617#. type: Plain text
23618#: ../sys-utils/ldattach.8.adoc:87
23619msgid "Set the character size of the serial line to 8 bits."
23620msgstr ""
23621
23622#. type: Plain text
23623#: ../sys-utils/ldattach.8.adoc:90
23624msgid ""
23625"Keep *ldattach* in the foreground so that it can be interrupted or debugged, "
23626"and to print verbose messages about its progress to standard error output."
23627msgstr ""
23628
23629#. type: Labeled list
23630#: ../sys-utils/ldattach.8.adoc:91
23631#, no-wrap
23632msgid "*-e*, *--evenparity*"
23633msgstr ""
23634
23635#. type: Plain text
23636#: ../sys-utils/ldattach.8.adoc:93
23637msgid "Set the parity of the serial line to even."
23638msgstr ""
23639
23640#. type: Labeled list
23641#: ../sys-utils/ldattach.8.adoc:94
23642#, no-wrap
23643msgid "*-i*, *--iflag* [*-*]_value_..."
23644msgstr ""
23645
23646#. type: Plain text
23647#: ../sys-utils/ldattach.8.adoc:96
23648msgid ""
23649"Set the specified bits in the c_iflag word of the serial line. The given "
23650"_value_ may be a number or a symbolic name. If _value_ is prefixed by a "
23651"minus sign, the specified bits are cleared instead. Several comma-separated "
23652"values may be given in order to set and clear multiple bits."
23653msgstr ""
23654
23655#. type: Labeled list
23656#: ../sys-utils/ldattach.8.adoc:97
23657#, no-wrap
23658msgid "*-n*, *--noparity*"
23659msgstr ""
23660
23661#. type: Plain text
23662#: ../sys-utils/ldattach.8.adoc:99
23663msgid "Set the parity of the serial line to none."
23664msgstr ""
23665
23666#. type: Labeled list
23667#: ../sys-utils/ldattach.8.adoc:100
23668#, no-wrap
23669msgid "*-o*, *--oddparity*"
23670msgstr ""
23671
23672#. type: Plain text
23673#: ../sys-utils/ldattach.8.adoc:102
23674msgid "Set the parity of the serial line to odd."
23675msgstr ""
23676
23677#. type: Labeled list
23678#: ../sys-utils/ldattach.8.adoc:103
23679#, no-wrap
23680msgid "*-s*, *--speed* _value_"
23681msgstr ""
23682
23683#. type: Plain text
23684#: ../sys-utils/ldattach.8.adoc:105
23685msgid "Set the speed (the baud rate) of the serial line to the specified _value_."
23686msgstr ""
23687
23688#. type: Labeled list
23689#: ../sys-utils/ldattach.8.adoc:106
23690#, no-wrap
23691msgid "*-c*, *--intro-command* _string_"
23692msgstr ""
23693
23694#. type: Plain text
23695#: ../sys-utils/ldattach.8.adoc:108
23696msgid ""
23697"Define an intro command that is sent through the serial line before the "
23698"invocation of ldattach. E.g. in conjunction with line discipline GSM0710, "
23699"the command 'AT+CMUX=0\\r' is commonly suitable to switch the modem into the "
23700"CMUX mode."
23701msgstr ""
23702
23703#. type: Labeled list
23704#: ../sys-utils/ldattach.8.adoc:109
23705#, no-wrap
23706msgid "*-p*, *--pause* _value_"
23707msgstr ""
23708
23709#. type: Plain text
23710#: ../sys-utils/ldattach.8.adoc:111
23711msgid ""
23712"Sleep for _value_ seconds before the invocation of ldattach. Default is one "
23713"second."
23714msgstr ""
23715
23716#. type: Plain text
23717#: ../sys-utils/ldattach.8.adoc:121
23718msgid "mailto:tilman@imap.cc[Tilman Schmidt]"
23719msgstr ""
23720
23721#. type: Plain text
23722#: ../sys-utils/ldattach.8.adoc:126
23723#, no-wrap
23724msgid ""
23725"*inputattach*(1),\n"
23726"*ttys*(4)\n"
23727msgstr ""
23728
23729#. type: Title =
23730#: ../sys-utils/losetup.8.adoc:2
23731#, no-wrap
23732msgid "losetup(8)"
23733msgstr ""
23734
23735#. type: Plain text
23736#: ../sys-utils/losetup.8.adoc:12
23737msgid "losetup - set up and control loop devices"
23738msgstr ""
23739
23740#. type: Plain text
23741#: ../sys-utils/losetup.8.adoc:16
23742msgid "Get info:"
23743msgstr ""
23744
23745#. type: Plain text
23746#: ../sys-utils/losetup.8.adoc:18
23747#, no-wrap
23748msgid "*losetup* [_loopdev_]\n"
23749msgstr ""
23750
23751#. type: Plain text
23752#: ../sys-utils/losetup.8.adoc:20
23753#, no-wrap
23754msgid "*losetup* *-l* [*-a*]\n"
23755msgstr ""
23756
23757#. type: Plain text
23758#: ../sys-utils/losetup.8.adoc:22
23759#, no-wrap
23760msgid "*losetup* *-j* _file_ [*-o* _offset_]\n"
23761msgstr ""
23762
23763#. type: Plain text
23764#: ../sys-utils/losetup.8.adoc:24
23765msgid "Detach a loop device:"
23766msgstr ""
23767
23768#. type: Plain text
23769#: ../sys-utils/losetup.8.adoc:26
23770#, no-wrap
23771msgid "*losetup* *-d* _loopdev_ ...\n"
23772msgstr ""
23773
23774#. type: Plain text
23775#: ../sys-utils/losetup.8.adoc:28
23776msgid "Detach all associated loop devices:"
23777msgstr ""
23778
23779#. type: Plain text
23780#: ../sys-utils/losetup.8.adoc:30
23781#, no-wrap
23782msgid "*losetup* *-D*\n"
23783msgstr ""
23784
23785#. type: Plain text
23786#: ../sys-utils/losetup.8.adoc:32
23787msgid "Set up a loop device:"
23788msgstr ""
23789
23790#. type: Plain text
23791#: ../sys-utils/losetup.8.adoc:34
23792#, no-wrap
23793msgid ""
23794"*losetup* [*-o* _offset_] [*--sizelimit* _size_] [*--sector-size* _size_] "
23795"[*-Pr*] [*--show*] *-f* _loopdev file_\n"
23796msgstr ""
23797
23798#. type: Plain text
23799#: ../sys-utils/losetup.8.adoc:36
23800msgid "Resize a loop device:"
23801msgstr ""
23802
23803#. type: Plain text
23804#: ../sys-utils/losetup.8.adoc:38
23805#, no-wrap
23806msgid "*losetup* *-c* _loopdev_\n"
23807msgstr ""
23808
23809#. type: Plain text
23810#: ../sys-utils/losetup.8.adoc:42
23811#, no-wrap
23812msgid ""
23813"*losetup* is used to associate loop devices with regular files or block "
23814"devices, to detach loop devices, and to query the status of a loop "
23815"device. If only the _loopdev_ argument is given, the status of the "
23816"corresponding loop device is shown. If no option is given, all loop devices "
23817"are shown.\n"
23818msgstr ""
23819
23820#. type: Plain text
23821#: ../sys-utils/losetup.8.adoc:44
23822msgid ""
23823"Note that the old output format (i.e., *losetup -a*) with comma-delimited "
23824"strings is deprecated in favour of the *--list* output format."
23825msgstr ""
23826
23827#. type: Plain text
23828#: ../sys-utils/losetup.8.adoc:46
23829msgid ""
23830"It's possible to create more independent loop devices for the same backing "
23831"file. *This setup may be dangerous, can cause data loss, corruption and "
23832"overwrites.* Use *--nooverlap* with *--find* during setup to avoid this "
23833"problem."
23834msgstr ""
23835
23836#. type: Plain text
23837#: ../sys-utils/losetup.8.adoc:48
23838msgid ""
23839"The loop device setup is not an atomic operation when used with *--find*, "
23840"and *losetup* does not protect this operation by any lock. The number of "
23841"attempts is internally restricted to a maximum of 16. It is recommended to "
23842"use for example flock1 to avoid a collision in heavily parallel use cases."
23843msgstr ""
23844
23845#. type: Plain text
23846#: ../sys-utils/losetup.8.adoc:52
23847msgid ""
23848"The _size_ and _offset_ arguments may be followed by the multiplicative "
23849"suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
23850"ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
23851"\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
23852"PB, EB, ZB and YB."
23853msgstr ""
23854
23855#. type: Plain text
23856#: ../sys-utils/losetup.8.adoc:55
23857msgid ""
23858"Show the status of all loop devices. Note that not all information is "
23859"accessible for non-root users. See also *--list*. The old output format (as "
23860"printed without *--list)* is deprecated."
23861msgstr ""
23862
23863#. type: Labeled list
23864#: ../sys-utils/losetup.8.adoc:56
23865#, no-wrap
23866msgid "*-d*, *--detach* _loopdev_..."
23867msgstr ""
23868
23869#. type: Plain text
23870#: ../sys-utils/losetup.8.adoc:58
23871msgid ""
23872"Detach the file or device associated with the specified loop device(s). Note "
23873"that since Linux v3.7 kernel uses \"lazy device destruction\". The detach "
23874"operation does not return *EBUSY* error anymore if device is actively used "
23875"by system, but it is marked by autoclear flag and destroyed later."
23876msgstr ""
23877
23878#. type: Labeled list
23879#: ../sys-utils/losetup.8.adoc:59
23880#, no-wrap
23881msgid "*-D*, *--detach-all*"
23882msgstr ""
23883
23884#. type: Plain text
23885#: ../sys-utils/losetup.8.adoc:61
23886msgid "Detach all associated loop devices."
23887msgstr ""
23888
23889#. type: Labeled list
23890#: ../sys-utils/losetup.8.adoc:62
23891#, no-wrap
23892msgid "*-f*, *--find* [_file_]"
23893msgstr ""
23894
23895#. type: Plain text
23896#: ../sys-utils/losetup.8.adoc:64
23897msgid ""
23898"Find the first unused loop device. If a _file_ argument is present, use the "
23899"found device as loop device. Otherwise, just print its name."
23900msgstr ""
23901
23902#. type: Labeled list
23903#: ../sys-utils/losetup.8.adoc:65
23904#, no-wrap
23905msgid "*--show*"
23906msgstr ""
23907
23908#. type: Plain text
23909#: ../sys-utils/losetup.8.adoc:67
23910msgid ""
23911"Display the name of the assigned loop device if the *-f* option and a _file_ "
23912"argument are present."
23913msgstr ""
23914
23915#. type: Labeled list
23916#: ../sys-utils/losetup.8.adoc:68
23917#, no-wrap
23918msgid "*-L*, *--nooverlap*"
23919msgstr ""
23920
23921#. type: Plain text
23922#: ../sys-utils/losetup.8.adoc:70
23923msgid ""
23924"Check for conflicts between loop devices to avoid situation when the same "
23925"backing file is shared between more loop devices. If the file is already "
23926"used by another device then re-use the device rather than a new one. The "
23927"option makes sense only with *--find*."
23928msgstr ""
23929
23930#. type: Labeled list
23931#: ../sys-utils/losetup.8.adoc:71
23932#, no-wrap
23933msgid "*-j*, *--associated* _file_ [*-o* _offset_]"
23934msgstr ""
23935
23936#. type: Plain text
23937#: ../sys-utils/losetup.8.adoc:73
23938msgid "Show the status of all loop devices associated with the given _file_."
23939msgstr ""
23940
23941#. type: Plain text
23942#: ../sys-utils/losetup.8.adoc:76
23943msgid ""
23944"The data start is moved _offset_ bytes into the specified file or "
23945"device. The _offset_ may be followed by the multiplicative suffixes; see "
23946"above."
23947msgstr ""
23948
23949#. type: Labeled list
23950#: ../sys-utils/losetup.8.adoc:77
23951#, no-wrap
23952msgid "*--sizelimit* _size_"
23953msgstr ""
23954
23955#. type: Plain text
23956#: ../sys-utils/losetup.8.adoc:79
23957msgid ""
23958"The data end is set to no more than _size_ bytes after the data start. The "
23959"_size_ may be followed by the multiplicative suffixes; see above."
23960msgstr ""
23961
23962#. type: Labeled list
23963#: ../sys-utils/losetup.8.adoc:80
23964#, no-wrap
23965msgid "*-b*, *--sector-size* _size_"
23966msgstr ""
23967
23968#. type: Plain text
23969#: ../sys-utils/losetup.8.adoc:82
23970msgid ""
23971"Set the logical sector size of the loop device in bytes (since Linux "
23972"4.14). The option may be used when create a new loop device as well as "
23973"stand-alone command to modify sector size of the already existing loop "
23974"device."
23975msgstr ""
23976
23977#. type: Labeled list
23978#: ../sys-utils/losetup.8.adoc:83
23979#, no-wrap
23980msgid "*-c*, *--set-capacity* _loopdev_"
23981msgstr ""
23982
23983#. type: Plain text
23984#: ../sys-utils/losetup.8.adoc:85
23985msgid ""
23986"Force the loop driver to reread the size of the file associated with the "
23987"specified loop device."
23988msgstr ""
23989
23990#. type: Labeled list
23991#: ../sys-utils/losetup.8.adoc:86
23992#, no-wrap
23993msgid "*-P*, *--partscan*"
23994msgstr ""
23995
23996#. type: Plain text
23997#: ../sys-utils/losetup.8.adoc:88
23998msgid ""
23999"Force the kernel to scan the partition table on a newly created loop "
24000"device. Note that the partition table parsing depends on sector sizes. The "
24001"default is sector size is 512 bytes, otherwise you need to use the option "
24002"*--sector-size* together with *--partscan*."
24003msgstr ""
24004
24005#. type: Plain text
24006#: ../sys-utils/losetup.8.adoc:91
24007msgid "Set up a read-only loop device."
24008msgstr ""
24009
24010#. type: Labeled list
24011#: ../sys-utils/losetup.8.adoc:92
24012#, no-wrap
24013msgid "*--direct-io*[**=on**|*off*]"
24014msgstr ""
24015
24016#. type: Plain text
24017#: ../sys-utils/losetup.8.adoc:94
24018msgid ""
24019"Enable or disable direct I/O for the backing file. The optional argument can "
24020"be either *on* or *off*. If the argument is omitted, it defaults to *off*."
24021msgstr ""
24022
24023#. type: Plain text
24024#: ../sys-utils/losetup.8.adoc:100
24025msgid ""
24026"If a loop device or the *-a* option is specified, print the default columns "
24027"for either the specified loop device or all loop devices; the default is to "
24028"print info about all devices. See also *--output*, *--noheadings*, *--raw*, "
24029"and *--json*."
24030msgstr ""
24031
24032#. type: Labeled list
24033#: ../sys-utils/losetup.8.adoc:101
24034#, no-wrap
24035msgid "*-O*, *--output* _column_[,_column_]..."
24036msgstr ""
24037
24038#. type: Plain text
24039#: ../sys-utils/losetup.8.adoc:103
24040msgid ""
24041"Specify the columns that are to be printed for the *--list* output. Use "
24042"*--help* to get a list of all supported columns."
24043msgstr ""
24044
24045#. type: Plain text
24046#: ../sys-utils/losetup.8.adoc:109
24047msgid "Don't print headings for *--list* output format."
24048msgstr ""
24049
24050#. type: Labeled list
24051#: ../sys-utils/losetup.8.adoc:110 ../sys-utils/prlimit.1.adoc:55
24052#: ../sys-utils/swapon.8.adoc:80 ../sys-utils/zramctl.8.adoc:56
24053#, no-wrap
24054msgid "*--raw*"
24055msgstr ""
24056
24057#. type: Plain text
24058#: ../sys-utils/losetup.8.adoc:112
24059msgid "Use the raw *--list* output format."
24060msgstr ""
24061
24062#. type: Plain text
24063#: ../sys-utils/losetup.8.adoc:115
24064msgid "Use JSON format for *--list* output."
24065msgstr ""
24066
24067#. type: Title ==
24068#: ../sys-utils/losetup.8.adoc:122
24069#, no-wrap
24070msgid "ENCRYPTION"
24071msgstr ""
24072
24073#. type: Plain text
24074#: ../sys-utils/losetup.8.adoc:125
24075#, no-wrap
24076msgid ""
24077"*Cryptoloop is no longer supported in favor of dm-crypt.* For more details "
24078"see *cryptsetup*(8).\n"
24079msgstr ""
24080
24081#. type: Plain text
24082#: ../sys-utils/losetup.8.adoc:129
24083#, no-wrap
24084msgid ""
24085"*losetup* returns 0 on success, nonzero on failure. When *losetup* displays "
24086"the status of a loop device, it returns 1 if the device is not configured "
24087"and 2 if an error occurred which prevented determining the status of the "
24088"device.\n"
24089msgstr ""
24090
24091#. type: Plain text
24092#: ../sys-utils/losetup.8.adoc:133
24093msgid ""
24094"Since version 2.37 *losetup* uses *LOOP_CONFIGURE* ioctl to setup a new loop "
24095"device by one ioctl call. The old versions use *LOOP_SET_FD* and "
24096"*LOOP_SET_STATUS64* ioctls to do the same."
24097msgstr ""
24098
24099#. type: Labeled list
24100#: ../sys-utils/losetup.8.adoc:136 ../sys-utils/mount.8.adoc:1409
24101#, no-wrap
24102msgid "LOOPDEV_DEBUG=all"
24103msgstr ""
24104
24105#. type: Labeled list
24106#: ../sys-utils/losetup.8.adoc:141
24107#, no-wrap
24108msgid "_/dev/loop[0..N]_"
24109msgstr ""
24110
24111#. type: Plain text
24112#: ../sys-utils/losetup.8.adoc:143
24113msgid "loop block devices"
24114msgstr ""
24115
24116#. type: Labeled list
24117#: ../sys-utils/losetup.8.adoc:144
24118#, no-wrap
24119msgid "_/dev/loop-control_"
24120msgstr ""
24121
24122#. type: Plain text
24123#: ../sys-utils/losetup.8.adoc:146
24124msgid "loop control device"
24125msgstr ""
24126
24127#. type: Plain text
24128#: ../sys-utils/losetup.8.adoc:150
24129msgid "The following commands can be used as an example of using the loop device."
24130msgstr ""
24131
24132#. type: Plain text
24133#: ../sys-utils/losetup.8.adoc:159
24134#, no-wrap
24135msgid ""
24136" # dd if=/dev/zero of=~/file.img bs=1024k count=10\n"
24137" # losetup --find --show ~/file.img\n"
24138" /dev/loop0\n"
24139" # mkfs -t ext2 /dev/loop0\n"
24140" # mount /dev/loop0 /mnt\n"
24141" ...\n"
24142" # umount /dev/loop0\n"
24143" # losetup --detach /dev/loop0\n"
24144msgstr ""
24145
24146#. type: Plain text
24147#: ../sys-utils/losetup.8.adoc:163
24148msgid ""
24149"mailto:kzak@redhat.com[Karel Zak], based on the original version from "
24150"mailto:tytso@athena.mit.edu[Theodore Ts'o]."
24151msgstr ""
24152
24153#. type: Title =
24154#: ../sys-utils/lscpu.1.adoc:2
24155#, no-wrap
24156msgid "lscpu(1)"
24157msgstr ""
24158
24159#. type: Plain text
24160#: ../sys-utils/lscpu.1.adoc:12
24161msgid "lscpu - display information about the CPU architecture"
24162msgstr ""
24163
24164#. type: Plain text
24165#: ../sys-utils/lscpu.1.adoc:16
24166#, no-wrap
24167msgid "*lscpu* [options]\n"
24168msgstr ""
24169
24170#. type: Plain text
24171#: ../sys-utils/lscpu.1.adoc:20
24172#, no-wrap
24173msgid ""
24174"*lscpu* gathers CPU architecture information from _sysfs_, _/proc/cpuinfo_ "
24175"and any applicable architecture-specific libraries (e.g. *librtas* on "
24176"Powerpc). The command output can be optimized for parsing or for easy "
24177"readability by humans. The information includes, for example, the number of "
24178"CPUs, threads, cores, sockets, and Non-Uniform Memory Access (NUMA) "
24179"nodes. There is also information about the CPU caches and cache sharing, "
24180"family, model, bogoMIPS, byte order, and stepping.\n"
24181msgstr ""
24182
24183#. type: Plain text
24184#: ../sys-utils/lscpu.1.adoc:22
24185msgid ""
24186"The default output formatting on terminal is subject to change and maybe "
24187"optimized for better readability. The output for non-terminals (e.g., pipes) "
24188"is never affected by this optimization and it is always in \"Field: "
24189"data\\n\" format. Use for example \"*lscpu | less*\" to see the default "
24190"output without optimizations."
24191msgstr ""
24192
24193#. type: Plain text
24194#: ../sys-utils/lscpu.1.adoc:24
24195msgid ""
24196"In virtualized environments, the CPU architecture information displayed "
24197"reflects the configuration of the guest operating system which is typically "
24198"different from the physical (host) system. On architectures that support "
24199"retrieving physical topology information, *lscpu* also displays the number "
24200"of physical sockets, chips, cores in the host system."
24201msgstr ""
24202
24203#. type: Plain text
24204#: ../sys-utils/lscpu.1.adoc:26
24205msgid ""
24206"Options that result in an output table have a _list_ argument. Use this "
24207"argument to customize the command output. Specify a comma-separated list of "
24208"column labels to limit the output table to only the specified columns, "
24209"arranged in the specified order. See *COLUMNS* for a list of valid column "
24210"labels. The column labels are not case sensitive."
24211msgstr ""
24212
24213#. type: Plain text
24214#: ../sys-utils/lscpu.1.adoc:28
24215msgid ""
24216"Not all columns are supported on all architectures. If an unsupported column "
24217"is specified, *lscpu* prints the column but does not provide any data for "
24218"it."
24219msgstr ""
24220
24221#. type: Plain text
24222#: ../sys-utils/lscpu.1.adoc:30
24223msgid ""
24224"The cache sizes are reported as summary from all CPUs. The versions before "
24225"v2.34 reported per-core sizes, but this output was confusing due to "
24226"complicated CPUs topology and the way how caches are shared between "
24227"CPUs. For more details about caches see *--cache*. Since version v2.37 "
24228"*lscpu* follows cache IDs as provided by Linux kernel and it does not always "
24229"start from zero."
24230msgstr ""
24231
24232#. type: Title ===
24233#: ../sys-utils/lscpu.1.adoc:31
24234#, no-wrap
24235msgid "COLUMNS"
24236msgstr ""
24237
24238#. type: Plain text
24239#: ../sys-utils/lscpu.1.adoc:34
24240msgid ""
24241"Note that topology elements (core, socket, etc.) use a sequential unique ID "
24242"starting from zero, but CPU logical numbers follow the kernel where there is "
24243"no guarantee of sequential numbering."
24244msgstr ""
24245
24246#. type: Labeled list
24247#: ../sys-utils/lscpu.1.adoc:35
24248#, no-wrap
24249msgid "*CPU*"
24250msgstr ""
24251
24252#. type: Plain text
24253#: ../sys-utils/lscpu.1.adoc:37
24254msgid "The logical CPU number of a CPU as used by the Linux kernel."
24255msgstr ""
24256
24257#. type: Labeled list
24258#: ../sys-utils/lscpu.1.adoc:38
24259#, no-wrap
24260msgid "*CORE*"
24261msgstr ""
24262
24263#. type: Plain text
24264#: ../sys-utils/lscpu.1.adoc:40
24265msgid "The logical core number. A core can contain several CPUs."
24266msgstr ""
24267
24268#. type: Labeled list
24269#: ../sys-utils/lscpu.1.adoc:41
24270#, no-wrap
24271msgid "*SOCKET*"
24272msgstr ""
24273
24274#. type: Plain text
24275#: ../sys-utils/lscpu.1.adoc:43
24276msgid "The logical socket number. A socket can contain several cores."
24277msgstr ""
24278
24279#. type: Labeled list
24280#: ../sys-utils/lscpu.1.adoc:44
24281#, no-wrap
24282msgid "*CLUSTER*"
24283msgstr ""
24284
24285#. type: Plain text
24286#: ../sys-utils/lscpu.1.adoc:46
24287msgid "The logical cluster number. A cluster can contain several cores."
24288msgstr ""
24289
24290#. type: Labeled list
24291#: ../sys-utils/lscpu.1.adoc:47
24292#, no-wrap
24293msgid "*BOOK*"
24294msgstr ""
24295
24296#. type: Plain text
24297#: ../sys-utils/lscpu.1.adoc:49
24298msgid "The logical book number. A book can contain several sockets."
24299msgstr ""
24300
24301#. type: Labeled list
24302#: ../sys-utils/lscpu.1.adoc:50
24303#, no-wrap
24304msgid "*DRAWER*"
24305msgstr ""
24306
24307#. type: Plain text
24308#: ../sys-utils/lscpu.1.adoc:52
24309msgid "The logical drawer number. A drawer can contain several books."
24310msgstr ""
24311
24312#. type: Labeled list
24313#: ../sys-utils/lscpu.1.adoc:53
24314#, no-wrap
24315msgid "*NODE*"
24316msgstr ""
24317
24318#. type: Plain text
24319#: ../sys-utils/lscpu.1.adoc:55
24320msgid "The logical NUMA node number. A node can contain several drawers."
24321msgstr ""
24322
24323#. type: Labeled list
24324#: ../sys-utils/lscpu.1.adoc:56
24325#, no-wrap
24326msgid "*CACHE*"
24327msgstr ""
24328
24329#. type: Plain text
24330#: ../sys-utils/lscpu.1.adoc:58
24331msgid "Information about how caches are shared between CPUs."
24332msgstr ""
24333
24334#. type: Labeled list
24335#: ../sys-utils/lscpu.1.adoc:59
24336#, no-wrap
24337msgid "*ADDRESS*"
24338msgstr ""
24339
24340#. type: Plain text
24341#: ../sys-utils/lscpu.1.adoc:61
24342msgid "The physical address of a CPU."
24343msgstr ""
24344
24345#. type: Labeled list
24346#: ../sys-utils/lscpu.1.adoc:62
24347#, no-wrap
24348msgid "*ONLINE*"
24349msgstr ""
24350
24351#. type: Plain text
24352#: ../sys-utils/lscpu.1.adoc:64
24353msgid ""
24354"Indicator that shows whether the Linux instance currently makes use of the "
24355"CPU."
24356msgstr ""
24357
24358#. type: Labeled list
24359#: ../sys-utils/lscpu.1.adoc:65
24360#, no-wrap
24361msgid "*CONFIGURED*"
24362msgstr ""
24363
24364#. type: Plain text
24365#: ../sys-utils/lscpu.1.adoc:67
24366msgid ""
24367"Indicator that shows if the hypervisor has allocated the CPU to the virtual "
24368"hardware on which the Linux instance runs. CPUs that are configured can be "
24369"set online by the Linux instance. This column contains data only if your "
24370"hardware system and hypervisor support dynamic CPU resource allocation."
24371msgstr ""
24372
24373#. type: Labeled list
24374#: ../sys-utils/lscpu.1.adoc:68
24375#, no-wrap
24376msgid "*POLARIZATION*"
24377msgstr ""
24378
24379#. type: Plain text
24380#: ../sys-utils/lscpu.1.adoc:70
24381msgid ""
24382"This column contains data for Linux instances that run on virtual hardware "
24383"with a hypervisor that can switch the CPU dispatching mode "
24384"(polarization). The polarization can be:"
24385msgstr ""
24386
24387#. type: Plain text
24388#: ../sys-utils/lscpu.1.adoc:77
24389msgid ""
24390"For vertical polarization, the column also shows the degree of "
24391"concentration, high, medium, or low. This column contains data only if your "
24392"hardware system and hypervisor support CPU polarization."
24393msgstr ""
24394
24395#. type: Labeled list
24396#: ../sys-utils/lscpu.1.adoc:78
24397#, no-wrap
24398msgid "*MAXMHZ*"
24399msgstr ""
24400
24401#. type: Plain text
24402#: ../sys-utils/lscpu.1.adoc:80
24403msgid ""
24404"Maximum megahertz value for the CPU. Useful when *lscpu* is used as hardware "
24405"inventory information gathering tool. Notice that the megahertz value is "
24406"dynamic, and driven by CPU governor depending on current resource need."
24407msgstr ""
24408
24409#. type: Labeled list
24410#: ../sys-utils/lscpu.1.adoc:81
24411#, no-wrap
24412msgid "*MINMHZ*"
24413msgstr ""
24414
24415#. type: Plain text
24416#: ../sys-utils/lscpu.1.adoc:83
24417msgid "Minimum megahertz value for the CPU."
24418msgstr ""
24419
24420#. type: Plain text
24421#: ../sys-utils/lscpu.1.adoc:88
24422msgid ""
24423"Include lines for online and offline CPUs in the output (default for "
24424"*-e*). This option may only be specified together with option *-e* or *-p*."
24425msgstr ""
24426
24427#. type: Labeled list
24428#: ../sys-utils/lscpu.1.adoc:89
24429#, no-wrap
24430msgid "*-B*, *--bytes*"
24431msgstr ""
24432
24433#. type: Plain text
24434#: ../sys-utils/lscpu.1.adoc:91
24435msgid "Print the sizes in bytes rather than in a human-readable format."
24436msgstr ""
24437
24438#. type: Labeled list
24439#: ../sys-utils/lscpu.1.adoc:92
24440#, no-wrap
24441msgid "*-b*, *--online*"
24442msgstr ""
24443
24444#. type: Plain text
24445#: ../sys-utils/lscpu.1.adoc:94
24446msgid ""
24447"Limit the output to online CPUs (default for *-p*). This option may only be "
24448"specified together with option *-e* or *-p*."
24449msgstr ""
24450
24451#. type: Labeled list
24452#: ../sys-utils/lscpu.1.adoc:95
24453#, no-wrap
24454msgid "*-C*, *--caches*[=_list_]"
24455msgstr ""
24456
24457#. type: Plain text
24458#: ../sys-utils/lscpu.1.adoc:97
24459msgid ""
24460"Display details about CPU caches. For details about available information "
24461"see *--help* output."
24462msgstr ""
24463
24464#. type: Plain text
24465#: ../sys-utils/lscpu.1.adoc:99 ../sys-utils/lscpu.1.adoc:111
24466msgid ""
24467"If the _list_ argument is omitted, all columns for which data is available "
24468"are included in the command output."
24469msgstr ""
24470
24471#. type: Plain text
24472#: ../sys-utils/lscpu.1.adoc:101
24473msgid ""
24474"When specifying the _list_ argument, the string of option, equal sign (=), "
24475"and _list_ must not contain any blanks or other whitespace. Examples: "
24476"'*-C=NAME,ONE-SIZE*' or '*--caches=NAME,ONE-SIZE*'."
24477msgstr ""
24478
24479#. type: Plain text
24480#: ../sys-utils/lscpu.1.adoc:103
24481msgid ""
24482"The default list of columns may be extended if list is specified in the "
24483"format +list (e.g., lscpu -C=+ALLOC-POLICY)."
24484msgstr ""
24485
24486#. type: Labeled list
24487#: ../sys-utils/lscpu.1.adoc:104
24488#, no-wrap
24489msgid "*-c*, *--offline*"
24490msgstr ""
24491
24492#. type: Plain text
24493#: ../sys-utils/lscpu.1.adoc:106
24494msgid ""
24495"Limit the output to offline CPUs. This option may only be specified together "
24496"with option *-e* or *-p*."
24497msgstr ""
24498
24499#. type: Labeled list
24500#: ../sys-utils/lscpu.1.adoc:107
24501#, no-wrap
24502msgid "*-e*, *--extended*[=_list_]"
24503msgstr ""
24504
24505#. type: Plain text
24506#: ../sys-utils/lscpu.1.adoc:109
24507msgid "Display the CPU information in human-readable format."
24508msgstr ""
24509
24510#. type: Plain text
24511#: ../sys-utils/lscpu.1.adoc:113
24512msgid ""
24513"When specifying the _list_ argument, the string of option, equal sign (=), "
24514"and _list_ must not contain any blanks or other whitespace. Examples: "
24515"'*-e=cpu,node*' or '*--extended=cpu,node*'."
24516msgstr ""
24517
24518#. type: Plain text
24519#: ../sys-utils/lscpu.1.adoc:115
24520msgid ""
24521"The default list of columns may be extended if list is specified in the "
24522"format +list (e.g., lscpu -e=+MHZ)."
24523msgstr ""
24524
24525#. type: Plain text
24526#: ../sys-utils/lscpu.1.adoc:121
24527msgid ""
24528"Use JSON output format for the default summary or extended output (see "
24529"*--extended*)."
24530msgstr ""
24531
24532#. type: Labeled list
24533#: ../sys-utils/lscpu.1.adoc:122
24534#, no-wrap
24535msgid "*-p*, *--parse*[=_list_]"
24536msgstr ""
24537
24538#. type: Plain text
24539#: ../sys-utils/lscpu.1.adoc:124
24540msgid "Optimize the command output for easy parsing."
24541msgstr ""
24542
24543#. type: Plain text
24544#: ../sys-utils/lscpu.1.adoc:126
24545msgid ""
24546"If the _list_ argument is omitted, the command output is compatible with "
24547"earlier versions of *lscpu*. In this compatible format, two commas are used "
24548"to separate CPU cache columns. If no CPU caches are identified the cache "
24549"column is omitted. If the _list_ argument is used, cache columns are "
24550"separated with a colon (:)."
24551msgstr ""
24552
24553#. type: Plain text
24554#: ../sys-utils/lscpu.1.adoc:128
24555msgid ""
24556"When specifying the _list_ argument, the string of option, equal sign (=), "
24557"and _list_ must not contain any blanks or other whitespace. Examples: "
24558"'*-p=cpu,node*' or '*--parse=cpu,node*'."
24559msgstr ""
24560
24561#. type: Plain text
24562#: ../sys-utils/lscpu.1.adoc:130
24563msgid ""
24564"The default list of columns may be extended if list is specified in the "
24565"format +list (e.g., lscpu -p=+MHZ)."
24566msgstr ""
24567
24568#. type: Labeled list
24569#: ../sys-utils/lscpu.1.adoc:131 ../sys-utils/lsmem.1.adoc:63
24570#, no-wrap
24571msgid "*-s*, *--sysroot* _directory_"
24572msgstr ""
24573
24574#. type: Plain text
24575#: ../sys-utils/lscpu.1.adoc:133
24576msgid ""
24577"Gather CPU data for a Linux instance other than the instance from which the "
24578"*lscpu* command is issued. The specified _directory_ is the system root of "
24579"the Linux instance to be inspected."
24580msgstr ""
24581
24582#. type: Plain text
24583#: ../sys-utils/lscpu.1.adoc:136
24584msgid ""
24585"Use hexadecimal masks for CPU sets (for example \"ff\"). The default is to "
24586"print the sets in list format (for example 0,1). Note that before version "
24587"2.30 the mask has been printed with 0x prefix."
24588msgstr ""
24589
24590#. type: Labeled list
24591#: ../sys-utils/lscpu.1.adoc:137
24592#, no-wrap
24593msgid "*-y*, *--physical*"
24594msgstr ""
24595
24596#. type: Plain text
24597#: ../sys-utils/lscpu.1.adoc:139
24598msgid ""
24599"Display physical IDs for all columns with topology elements (core, socket, "
24600"etc.). Other than logical IDs, which are assigned by *lscpu*, physical IDs "
24601"are platform-specific values that are provided by the kernel. Physical IDs "
24602"are not necessarily unique and they might not be arranged sequentially. If "
24603"the kernel could not retrieve a physical ID for an element *lscpu* prints "
24604"the dash (-) character."
24605msgstr ""
24606
24607#. type: Plain text
24608#: ../sys-utils/lscpu.1.adoc:141
24609msgid "The CPU logical numbers are not affected by this option."
24610msgstr ""
24611
24612#. type: Plain text
24613#: ../sys-utils/lscpu.1.adoc:147
24614msgid ""
24615"Output all available columns. This option must be combined with either "
24616"*--extended*, *--parse* or *--caches*."
24617msgstr ""
24618
24619#. type: Plain text
24620#: ../sys-utils/lscpu.1.adoc:151
24621msgid ""
24622"The basic overview of CPU family, model, etc. is always based on the first "
24623"CPU only."
24624msgstr ""
24625
24626#. type: Plain text
24627#: ../sys-utils/lscpu.1.adoc:153
24628msgid "Sometimes in Xen Dom0 the kernel reports wrong data."
24629msgstr ""
24630
24631#. type: Plain text
24632#: ../sys-utils/lscpu.1.adoc:155
24633msgid "On virtual hardware the number of cores per socket, etc. can be wrong."
24634msgstr ""
24635
24636#. type: Plain text
24637#: ../sys-utils/lscpu.1.adoc:161
24638msgid ""
24639"mailto:qcai@redhat.com[Cai Qian], mailto:kzak@redhat.com[Karel Zak], "
24640"mailto:heiko.carstens@de.ibm.com[Heiko Carstens]"
24641msgstr ""
24642
24643#. type: Plain text
24644#: ../sys-utils/lscpu.1.adoc:165
24645#, no-wrap
24646msgid "*chcpu*(8)\n"
24647msgstr ""
24648
24649#. type: Title =
24650#: ../sys-utils/lsipc.1.adoc:2
24651#, no-wrap
24652msgid "lsipc(1)"
24653msgstr ""
24654
24655#. type: Plain text
24656#: ../sys-utils/lsipc.1.adoc:12
24657msgid "lsipc - show information on IPC facilities currently employed in the system"
24658msgstr ""
24659
24660#. type: Plain text
24661#: ../sys-utils/lsipc.1.adoc:16
24662#, no-wrap
24663msgid "*lsipc* [options]\n"
24664msgstr ""
24665
24666#. type: Plain text
24667#: ../sys-utils/lsipc.1.adoc:20
24668#, no-wrap
24669msgid ""
24670"*lsipc* shows information on the System V inter-process communication "
24671"facilities for which the calling process has read access.\n"
24672msgstr ""
24673
24674#. type: Plain text
24675#: ../sys-utils/lsipc.1.adoc:25
24676msgid ""
24677"Show full details on just the one resource element identified by _id_. This "
24678"option needs to be combined with one of the three resource options: *-m*, "
24679"*-q* or *-s*. It is possible to override the default output format for this "
24680"option with the *--list*, *--raw*, *--json* or *--export* option."
24681msgstr ""
24682
24683#. type: Labeled list
24684#: ../sys-utils/lsipc.1.adoc:26
24685#, no-wrap
24686msgid "*-g*, *--global*"
24687msgstr ""
24688
24689#. type: Plain text
24690#: ../sys-utils/lsipc.1.adoc:28
24691msgid ""
24692"Show system-wide usage and limits of IPC resources. This option may be "
24693"combined with one of the three resource options: *-m*, *-q* or *-s*. The "
24694"default is to show information about all resources."
24695msgstr ""
24696
24697#. type: Title ===
24698#: ../sys-utils/lsipc.1.adoc:46
24699#, no-wrap
24700msgid "Output formatting"
24701msgstr ""
24702
24703#. type: Plain text
24704#: ../sys-utils/lsipc.1.adoc:53
24705msgid ""
24706"Produce output in the form of key=\"value\" pairs. All potentially unsafe "
24707"value characters are hex-escaped (\\x<code>). The key (variable name) will "
24708"be modified to contain only characters allowed for a shell variable "
24709"identifiers, for example, USE_PCT instead of USE%."
24710msgstr ""
24711
24712#. type: Plain text
24713#: ../sys-utils/lsipc.1.adoc:56
24714msgid "Use the JSON output format."
24715msgstr ""
24716
24717#. type: Plain text
24718#: ../sys-utils/lsipc.1.adoc:59
24719msgid "Use the list output format. This is the default, except when *--id* is used."
24720msgstr ""
24721
24722#. type: Plain text
24723#: ../sys-utils/lsipc.1.adoc:74
24724msgid "Print size in bytes rather than in human readable format."
24725msgstr ""
24726
24727#. type: Labeled list
24728#: ../sys-utils/lsipc.1.adoc:84
24729#, no-wrap
24730msgid "*-P*, *--numeric-perms*"
24731msgstr ""
24732
24733#. type: Plain text
24734#: ../sys-utils/lsipc.1.adoc:86
24735msgid "Print numeric permissions in PERMS column."
24736msgstr ""
24737
24738#. type: Plain text
24739#: ../sys-utils/lsipc.1.adoc:97
24740msgid "if a serious error occurs."
24741msgstr ""
24742
24743#. type: Plain text
24744#: ../sys-utils/lsipc.1.adoc:101
24745msgid "The *lsipc* utility is inspired by the *ipcs*(1) utility."
24746msgstr ""
24747
24748#. type: Title =
24749#: ../sys-utils/lsirq.1.adoc:2
24750#, no-wrap
24751msgid "lsirq(1)"
24752msgstr ""
24753
24754#. type: Plain text
24755#: ../sys-utils/lsirq.1.adoc:12
24756msgid "lsirq - utility to display kernel interrupt information"
24757msgstr ""
24758
24759#. type: Plain text
24760#: ../sys-utils/lsirq.1.adoc:16
24761#, no-wrap
24762msgid "*lsirq* [options]\n"
24763msgstr ""
24764
24765#. type: Plain text
24766#: ../sys-utils/lsirq.1.adoc:20
24767msgid "Display kernel interrupt counter information."
24768msgstr ""
24769
24770#. type: Plain text
24771#: ../sys-utils/lsirq.1.adoc:27
24772msgid "Don't print headings."
24773msgstr ""
24774
24775#. type: Plain text
24776#: ../sys-utils/lsirq.1.adoc:33
24777msgid ""
24778"Specify sort criteria by column name. See *--help* output to get column "
24779"names."
24780msgstr ""
24781
24782#. type: Plain text
24783#: ../sys-utils/lsirq.1.adoc:39
24784msgid ""
24785"Produce output in the form of key=\"value\" pairs. All potentially unsafe "
24786"characters are hex-escaped (\\x<code>)."
24787msgstr ""
24788
24789#. type: Title =
24790#: ../sys-utils/lsmem.1.adoc:2
24791#, no-wrap
24792msgid "lsmem(1)"
24793msgstr ""
24794
24795#. type: Plain text
24796#: ../sys-utils/lsmem.1.adoc:12
24797msgid "lsmem - list the ranges of available memory with their online status"
24798msgstr ""
24799
24800#. type: Plain text
24801#: ../sys-utils/lsmem.1.adoc:16
24802#, no-wrap
24803msgid "*lsmem* [options]\n"
24804msgstr ""
24805
24806#. type: Plain text
24807#: ../sys-utils/lsmem.1.adoc:20
24808msgid ""
24809"The *lsmem* command lists the ranges of available memory with their online "
24810"status. The listed memory blocks correspond to the memory block "
24811"representation in sysfs. The command also shows the memory block size and "
24812"the amount of memory in online and offline state."
24813msgstr ""
24814
24815#. type: Plain text
24816#: ../sys-utils/lsmem.1.adoc:22
24817msgid ""
24818"The default output compatible with original implementation from s390-tools, "
24819"but it's strongly recommended to avoid using default outputs in your "
24820"scripts. Always explicitly define expected columns by using the *--output* "
24821"option together with a columns list in environments where a stable output is "
24822"required."
24823msgstr ""
24824
24825#. type: Plain text
24826#: ../sys-utils/lsmem.1.adoc:24
24827msgid ""
24828"The *lsmem* command lists a new memory range always when the current memory "
24829"block distinguish from the previous block by some output column. This "
24830"default behavior is possible to override by the *--split* option (e.g., "
24831"*lsmem --split=ZONES*). The special word \"none\" may be used to ignore all "
24832"differences between memory blocks and to create as large as possible "
24833"continuous ranges. The opposite semantic is *--all* to list individual "
24834"memory blocks."
24835msgstr ""
24836
24837#. type: Plain text
24838#: ../sys-utils/lsmem.1.adoc:26
24839msgid ""
24840"Note that some output columns may provide inaccurate information if a split "
24841"policy forces *lsmem* to ignore differences in some attributes. For example "
24842"if you merge removable and non-removable memory blocks to the one range than "
24843"all the range will be marked as non-removable on *lsmem* output."
24844msgstr ""
24845
24846#. type: Plain text
24847#: ../sys-utils/lsmem.1.adoc:28
24848msgid ""
24849"Not all columns are supported on all systems. If an unsupported column is "
24850"specified, *lsmem* prints the column but does not provide any data for it."
24851msgstr ""
24852
24853#. type: Plain text
24854#: ../sys-utils/lsmem.1.adoc:30
24855msgid "Use the *--help* option to see the columns description."
24856msgstr ""
24857
24858#. type: Plain text
24859#: ../sys-utils/lsmem.1.adoc:35
24860msgid ""
24861"List each individual memory block, instead of combining memory blocks with "
24862"similar attributes."
24863msgstr ""
24864
24865#. type: Plain text
24866#: ../sys-utils/lsmem.1.adoc:50
24867msgid ""
24868"Specify which output columns to print. Use *--help* to get a list of all "
24869"supported columns. The default list of columns may be extended if _list_ is "
24870"specified in the format **+**__list__ (e.g., *lsmem -o +NODE*)."
24871msgstr ""
24872
24873#. type: Plain text
24874#: ../sys-utils/lsmem.1.adoc:56
24875msgid ""
24876"Produce output in the form of key=\"value\" pairs. All potentially unsafe "
24877"value characters are hex-escaped (\\x<code>)."
24878msgstr ""
24879
24880#. type: Labeled list
24881#: ../sys-utils/lsmem.1.adoc:60
24882#, no-wrap
24883msgid "*-S*, *--split* _list_"
24884msgstr ""
24885
24886#. type: Plain text
24887#: ../sys-utils/lsmem.1.adoc:62
24888msgid ""
24889"Specify which columns (attributes) use to split memory blocks to ranges. The "
24890"supported columns are STATE, REMOVABLE, NODE and ZONES, or \"none\". The "
24891"other columns are silently ignored. For more details see DESCRIPTION above."
24892msgstr ""
24893
24894#. type: Plain text
24895#: ../sys-utils/lsmem.1.adoc:65
24896msgid ""
24897"Gather memory data for a Linux instance other than the instance from which "
24898"the *lsmem* command is issued. The specified _directory_ is the system root "
24899"of the Linux instance to be inspected."
24900msgstr ""
24901
24902#. type: Labeled list
24903#: ../sys-utils/lsmem.1.adoc:69
24904#, no-wrap
24905msgid "*--summary*[=_when_]"
24906msgstr ""
24907
24908#. type: Plain text
24909#: ../sys-utils/lsmem.1.adoc:71
24910msgid ""
24911"This option controls summary lines output. The optional argument _when_ can "
24912"be *never*, *always* or *only*. If the _when_ argument is omitted, it "
24913"defaults to *\"only\"*. The summary output is suppressed for *--raw*, "
24914"*--pairs* and *--json*."
24915msgstr ""
24916
24917#. type: Plain text
24918#: ../sys-utils/lsmem.1.adoc:75
24919#, no-wrap
24920msgid ""
24921"*lsmem* was originally written by Gerald Schaefer for s390-tools in "
24922"Perl. The C version for util-linux was written by Clemens von Mann, Heiko "
24923"Carstens and Karel Zak.\n"
24924msgstr ""
24925
24926#. type: Plain text
24927#: ../sys-utils/lsmem.1.adoc:79
24928#, no-wrap
24929msgid "*chmem*(8)\n"
24930msgstr ""
24931
24932#. Man page for the lsns command.
24933#. Copyright 2015 Karel Zak <kzak@redhat.com>
24934#. May be distributed under the GNU General Public License
24935#. type: Title =
24936#: ../sys-utils/lsns.8.adoc:7
24937#, no-wrap
24938msgid "lsns(8)"
24939msgstr ""
24940
24941#. type: Plain text
24942#: ../sys-utils/lsns.8.adoc:17
24943msgid "lsns - list namespaces"
24944msgstr ""
24945
24946#. type: Plain text
24947#: ../sys-utils/lsns.8.adoc:21
24948#, no-wrap
24949msgid "*lsns* [options] _namespace_\n"
24950msgstr ""
24951
24952#. type: Plain text
24953#: ../sys-utils/lsns.8.adoc:25
24954#, no-wrap
24955msgid ""
24956"*lsns* lists information about all the currently accessible namespaces or "
24957"about the given _namespace_. The _namespace_ identifier is an inode "
24958"number.\n"
24959msgstr ""
24960
24961#. type: Plain text
24962#: ../sys-utils/lsns.8.adoc:27 ../sys-utils/rfkill.8.adoc:24
24963msgid ""
24964"The default output is subject to change. So whenever possible, you should "
24965"avoid using default outputs in your scripts. Always explicitly define "
24966"expected columns by using the *--output* option together with a columns list "
24967"in environments where a stable output is required."
24968msgstr ""
24969
24970#. type: Plain text
24971#: ../sys-utils/lsns.8.adoc:29
24972msgid ""
24973"The *NSFS* column, printed when *net* is specified for the *--type* option, "
24974"is special; it uses multi-line cells. Use the option *--nowrap* to switch to "
24975"\",\"-separated single-line representation."
24976msgstr ""
24977
24978#. type: Plain text
24979#: ../sys-utils/lsns.8.adoc:31
24980msgid ""
24981"Note that *lsns* reads information directly from the _/proc_ filesystem and "
24982"for non-root users it may return incomplete information. The current _/proc_ "
24983"filesystem may be unshared and affected by a PID namespace (see *unshare "
24984"--mount-proc* for more details). *lsns* is not able to see persistent "
24985"namespaces without processes where the namespace instance is held by a bind "
24986"mount to /proc/_pid_/ns/_type_."
24987msgstr ""
24988
24989#. type: Plain text
24990#: ../sys-utils/lsns.8.adoc:39
24991msgid "Use list output format."
24992msgstr ""
24993
24994#. type: Plain text
24995#: ../sys-utils/lsns.8.adoc:47
24996msgid ""
24997"The default list of columns may be extended if _list_ is specified in the "
24998"format **+**__list__ (e.g., *lsns -o +PATH*)."
24999msgstr ""
25000
25001#. type: Labeled list
25002#: ../sys-utils/lsns.8.adoc:51
25003#, no-wrap
25004msgid "*-p*, *--task* _PID_"
25005msgstr ""
25006
25007#. type: Plain text
25008#: ../sys-utils/lsns.8.adoc:53
25009msgid "Display only the namespaces held by the process with this _PID_."
25010msgstr ""
25011
25012#. type: Plain text
25013#: ../sys-utils/lsns.8.adoc:59
25014msgid ""
25015"Display the specified _type_ of namespaces only. The supported types are "
25016"*mnt*, *net*, *ipc*, *user*, *pid*, *uts*, *cgroup* and *time*. This option "
25017"may be given more than once."
25018msgstr ""
25019
25020#. type: Labeled list
25021#: ../sys-utils/lsns.8.adoc:63
25022#, no-wrap
25023msgid "*-W*, *--nowrap*"
25024msgstr ""
25025
25026#. type: Plain text
25027#: ../sys-utils/lsns.8.adoc:65
25028msgid "Do not use multi-line text in columns."
25029msgstr ""
25030
25031#. type: Plain text
25032#: ../sys-utils/lsns.8.adoc:82
25033#, no-wrap
25034msgid ""
25035"*nsenter*(1),\n"
25036"*unshare*(1),\n"
25037"*clone*(2),\n"
25038"*namespaces*(7)\n"
25039msgstr ""
25040
25041#. Copyright (c) 1996-2004 Andries Brouwer
25042#. Copyright (C) 2006-2012 Karel Zak <kzak@redhat.com>
25043#
25044#. This page is somewhat derived from a page that was
25045#. (c) 1980, 1989, 1991 The Regents of the University of California
25046#. and had been heavily modified by Rik Faith and myself.
25047#. (Probably no BSD text remains.)
25048#. Fragments of text were written by Werner Almesberger, Remy Card,
25049#. Stephen Tweedie and Eric Youngdale.
25050#
25051#. This is free documentation; you can redistribute it and/or
25052#. modify it under the terms of the GNU General Public License as
25053#. published by the Free Software Foundation; either version 2 of
25054#. the License, or (at your option) any later version.
25055#
25056#. The GNU General Public License's references to "object code"
25057#. and "executables" are to be interpreted as the output of any
25058#. document formatting or typesetting system, including
25059#. intermediate and printed output.
25060#
25061#. This manual is distributed in the hope that it will be useful,
25062#. but WITHOUT ANY WARRANTY; without even the implied warranty of
25063#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25064#. GNU General Public License for more details.
25065#
25066#. You should have received a copy of the GNU General Public License along
25067#. with this program; if not, write to the Free Software Foundation, Inc.,
25068#. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
25069#. type: Title =
25070#: ../sys-utils/mount.8.adoc:32
25071#, no-wrap
25072msgid "mount(8)"
25073msgstr ""
25074
25075#. type: Plain text
25076#: ../sys-utils/mount.8.adoc:43
25077msgid "mount - mount a filesystem"
25078msgstr ""
25079
25080#. type: Plain text
25081#: ../sys-utils/mount.8.adoc:47
25082#, no-wrap
25083msgid "*mount* [*-h*|*-V*]\n"
25084msgstr ""
25085
25086#. type: Plain text
25087#: ../sys-utils/mount.8.adoc:49
25088#, no-wrap
25089msgid "*mount* [*-l*] [*-t* _fstype_]\n"
25090msgstr ""
25091
25092#. type: Plain text
25093#: ../sys-utils/mount.8.adoc:51
25094#, no-wrap
25095msgid "*mount* *-a* [*-fFnrsvw*] [*-t* _fstype_] [*-O* _optlist_]\n"
25096msgstr ""
25097
25098#. type: Plain text
25099#: ../sys-utils/mount.8.adoc:53
25100#, no-wrap
25101msgid "*mount* [*-fnrsvw*] [*-o* _options_] _device_|_mountpoint_\n"
25102msgstr ""
25103
25104#. type: Plain text
25105#: ../sys-utils/mount.8.adoc:55
25106#, no-wrap
25107msgid "*mount* [*-fnrsvw*] [*-t* _fstype_] [*-o* _options_] _device mountpoint_\n"
25108msgstr ""
25109
25110#. type: Plain text
25111#: ../sys-utils/mount.8.adoc:57
25112#, no-wrap
25113msgid "*mount* *--bind*|*--rbind*|*--move* _olddir newdir_\n"
25114msgstr ""
25115
25116#. type: Plain text
25117#: ../sys-utils/mount.8.adoc:59
25118#, no-wrap
25119msgid ""
25120"*mount* "
25121"*--make*-[*shared*|*slave*|*private*|*unbindable*|*rshared*|*rslave*|*rprivate*|*runbindable*] "
25122"_mountpoint_\n"
25123msgstr ""
25124
25125#. type: Plain text
25126#: ../sys-utils/mount.8.adoc:63
25127msgid ""
25128"All files accessible in a Unix system are arranged in one big tree, the file "
25129"hierarchy, rooted at _/_. These files can be spread out over several "
25130"devices. The *mount* command serves to attach the filesystem found on some "
25131"device to the big file tree. Conversely, the umount8 command will detach it "
25132"again. The filesystem is used to control how data is stored on the device or "
25133"provided in a virtual way by network or other services."
25134msgstr ""
25135
25136#. type: Plain text
25137#: ../sys-utils/mount.8.adoc:65
25138msgid "The standard form of the *mount* command is:"
25139msgstr ""
25140
25141#. type: delimited block _
25142#: ../sys-utils/mount.8.adoc:68
25143#, no-wrap
25144msgid "*mount -t* _type device dir_\n"
25145msgstr ""
25146
25147#. type: Plain text
25148#: ../sys-utils/mount.8.adoc:71
25149msgid ""
25150"This tells the kernel to attach the filesystem found on _device_ (which is "
25151"of type _type_) at the directory _dir_. The option *-t* _type_ is "
25152"optional. The *mount* command is usually able to detect a filesystem. The "
25153"root permissions are necessary to mount a filesystem by default. See section "
25154"\"Non-superuser mounts\" below for more details. The previous contents (if "
25155"any) and owner and mode of _dir_ become invisible, and as long as this "
25156"filesystem remains mounted, the pathname _dir_ refers to the root of the "
25157"filesystem on _device_."
25158msgstr ""
25159
25160#. type: Plain text
25161#: ../sys-utils/mount.8.adoc:73
25162msgid "If only the directory or the device is given, for example:"
25163msgstr ""
25164
25165#. type: delimited block _
25166#: ../sys-utils/mount.8.adoc:76
25167#, no-wrap
25168msgid "*mount /dir*\n"
25169msgstr ""
25170
25171#. type: Plain text
25172#: ../sys-utils/mount.8.adoc:79
25173msgid ""
25174"then *mount* looks for a mountpoint (and if not found then for a device) in "
25175"the _/etc/fstab_ file. It's possible to use the *--target* or *--source* "
25176"options to avoid ambiguous interpretation of the given argument. For "
25177"example:"
25178msgstr ""
25179
25180#. type: delimited block _
25181#: ../sys-utils/mount.8.adoc:82
25182#, no-wrap
25183msgid "*mount --target /mountpoint*\n"
25184msgstr ""
25185
25186#. type: Plain text
25187#: ../sys-utils/mount.8.adoc:85
25188msgid ""
25189"The same filesystem may be mounted more than once, and in some cases (e.g., "
25190"network filesystems) the same filesystem may be mounted on the same "
25191"mountpoint multiple times. The *mount* command does not implement any policy "
25192"to control this behavior. All behavior is controlled by the kernel and it is "
25193"usually specific to the filesystem driver. The exception is *--all*, in this "
25194"case already mounted filesystems are ignored (see *--all* below for more "
25195"details)."
25196msgstr ""
25197
25198#. type: Title ===
25199#: ../sys-utils/mount.8.adoc:86
25200#, no-wrap
25201msgid "Listing the mounts"
25202msgstr ""
25203
25204#. type: Plain text
25205#: ../sys-utils/mount.8.adoc:89
25206msgid "The listing mode is maintained for backward compatibility only."
25207msgstr ""
25208
25209#. type: Plain text
25210#: ../sys-utils/mount.8.adoc:91
25211msgid ""
25212"For more robust and customizable output use *findmnt*(8), *especially in "
25213"your scripts*. Note that control characters in the mountpoint name are "
25214"replaced with '?'."
25215msgstr ""
25216
25217#. type: Plain text
25218#: ../sys-utils/mount.8.adoc:93
25219msgid "The following command lists all mounted filesystems (of type _type_):"
25220msgstr ""
25221
25222#. type: delimited block _
25223#: ../sys-utils/mount.8.adoc:96
25224#, no-wrap
25225msgid "*mount* [*-l*] [*-t* _type_]\n"
25226msgstr ""
25227
25228#. type: Plain text
25229#: ../sys-utils/mount.8.adoc:99
25230msgid "The option *-l* adds labels to this listing. See below."
25231msgstr ""
25232
25233#. type: Title ===
25234#: ../sys-utils/mount.8.adoc:100
25235#, no-wrap
25236msgid "Indicating the device and filesystem"
25237msgstr ""
25238
25239#. type: Plain text
25240#: ../sys-utils/mount.8.adoc:103
25241msgid ""
25242"Most devices are indicated by a filename (of a block special device), like "
25243"_/dev/sda1_, but there are other possibilities. For example, in the case of "
25244"an NFS mount, _device_ may look like _knuth.cwi.nl:/dir_."
25245msgstr ""
25246
25247#. type: Plain text
25248#: ../sys-utils/mount.8.adoc:105
25249msgid ""
25250"The device names of disk partitions are unstable; hardware reconfiguration, "
25251"and adding or removing a device can cause changes in names. This is the "
25252"reason why it's strongly recommended to use filesystem or partition "
25253"identifiers like UUID or LABEL. Currently supported identifiers (tags):"
25254msgstr ""
25255
25256#. type: Labeled list
25257#: ../sys-utils/mount.8.adoc:106
25258#, no-wrap
25259msgid "LABEL=__label__"
25260msgstr ""
25261
25262#. type: Plain text
25263#: ../sys-utils/mount.8.adoc:108
25264msgid "Human readable filesystem identifier. See also *-L*."
25265msgstr ""
25266
25267#. type: Labeled list
25268#: ../sys-utils/mount.8.adoc:109
25269#, no-wrap
25270msgid "UUID=__uuid__"
25271msgstr ""
25272
25273#. type: Plain text
25274#: ../sys-utils/mount.8.adoc:111
25275msgid ""
25276"Filesystem universally unique identifier. The format of the UUID is usually "
25277"a series of hex digits separated by hyphens. See also *-U*."
25278msgstr ""
25279
25280#. type: Plain text
25281#: ../sys-utils/mount.8.adoc:113
25282msgid ""
25283"Note that *mount* uses UUIDs as strings. The UUIDs from the command line or "
25284"from *fstab*(5) are not converted to internal binary representation. The "
25285"string representation of the UUID should be based on lower case characters."
25286msgstr ""
25287
25288#. type: Labeled list
25289#: ../sys-utils/mount.8.adoc:114
25290#, no-wrap
25291msgid "PARTLABEL=__label__"
25292msgstr ""
25293
25294#. type: Plain text
25295#: ../sys-utils/mount.8.adoc:116
25296msgid ""
25297"Human readable partition identifier. This identifier is independent on "
25298"filesystem and does not change by mkfs or mkswap operations It's supported "
25299"for example for GUID Partition Tables (GPT)."
25300msgstr ""
25301
25302#. type: Labeled list
25303#: ../sys-utils/mount.8.adoc:117
25304#, no-wrap
25305msgid "PARTUUID=__uuid__"
25306msgstr ""
25307
25308#. type: Plain text
25309#: ../sys-utils/mount.8.adoc:119
25310msgid ""
25311"Partition universally unique identifier. This identifier is independent on "
25312"filesystem and does not change by mkfs or mkswap operations It's supported "
25313"for example for GUID Partition Tables (GPT)."
25314msgstr ""
25315
25316#. type: Labeled list
25317#: ../sys-utils/mount.8.adoc:120
25318#, no-wrap
25319msgid "ID=__id__"
25320msgstr ""
25321
25322#. type: Plain text
25323#: ../sys-utils/mount.8.adoc:122
25324msgid ""
25325"Hardware block device ID as generated by udevd. This identifier is usually "
25326"based on WWN (unique storage identifier) and assigned by the hardware "
25327"manufacturer. See *ls /dev/disk/by-id* for more details, this directory and "
25328"running udevd is required. This identifier is not recommended for generic "
25329"use as the identifier is not strictly defined and it depends on udev, udev "
25330"rules and hardware."
25331msgstr ""
25332
25333#. type: Plain text
25334#: ../sys-utils/mount.8.adoc:124
25335msgid ""
25336"The command *lsblk --fs* provides an overview of filesystems, LABELs and "
25337"UUIDs on available block devices. The command *blkid -p <device>* provides "
25338"details about a filesystem on the specified device."
25339msgstr ""
25340
25341#. type: Plain text
25342#: ../sys-utils/mount.8.adoc:126
25343msgid ""
25344"Don't forget that there is no guarantee that UUIDs and labels are really "
25345"unique, especially if you move, share or copy the device. Use *lsblk -o "
25346"+UUID,PARTUUID* to verify that the UUIDs are really unique in your system."
25347msgstr ""
25348
25349#. type: Plain text
25350#: ../sys-utils/mount.8.adoc:128
25351msgid ""
25352"The recommended setup is to use tags (e.g. *UUID*=_uuid_) rather than "
25353"_/dev/disk/by-{label,uuid,id,partuuid,partlabel}_ udev symlinks in the "
25354"_/etc/fstab_ file. Tags are more readable, robust and portable. The "
25355"*mount*(8) command internally uses udev symlinks, so the use of symlinks in "
25356"_/etc/fstab_ has no advantage over tags. For more details see *libblkid*(3)."
25357msgstr ""
25358
25359#. type: Plain text
25360#: ../sys-utils/mount.8.adoc:130
25361msgid ""
25362"The _proc_ filesystem is not associated with a special device, and when "
25363"mounting it, an arbitrary keyword - for example, __proc__ - can be used "
25364"instead of a device specification. (The customary choice _none_ is less "
25365"fortunate: the error message 'none already mounted' from *mount* can be "
25366"confusing.)"
25367msgstr ""
25368
25369#. type: Title ===
25370#: ../sys-utils/mount.8.adoc:131
25371#, no-wrap
25372msgid "The files /etc/fstab, /etc/mtab and /proc/mounts"
25373msgstr ""
25374
25375#. type: Plain text
25376#: ../sys-utils/mount.8.adoc:134
25377msgid ""
25378"The file _/etc/fstab_ (see *fstab*(5)), may contain lines describing what "
25379"devices are usually mounted where, using which options. The default location "
25380"of the *fstab*(5) file can be overridden with the *--fstab* _path_ "
25381"command-line option (see below for more details)."
25382msgstr ""
25383
25384#. type: Plain text
25385#: ../sys-utils/mount.8.adoc:136
25386msgid "The command"
25387msgstr ""
25388
25389#. type: delimited block _
25390#: ../sys-utils/mount.8.adoc:139
25391#, no-wrap
25392msgid "*mount -a* [*-t* _type_] [*-O* _optlist_]\n"
25393msgstr ""
25394
25395#. type: Plain text
25396#: ../sys-utils/mount.8.adoc:142
25397msgid ""
25398"(usually given in a bootscript) causes all filesystems mentioned in _fstab_ "
25399"(of the proper type and/or having or not having the proper options) to be "
25400"mounted as indicated, except for those whose line contains the *noauto* "
25401"keyword. Adding the *-F* option will make *mount* fork, so that the "
25402"filesystems are mounted in parallel."
25403msgstr ""
25404
25405#. type: Plain text
25406#: ../sys-utils/mount.8.adoc:144
25407msgid ""
25408"When mounting a filesystem mentioned in _fstab_ or _mtab_, it suffices to "
25409"specify on the command line only the device, or only the mount point."
25410msgstr ""
25411
25412#. type: Plain text
25413#: ../sys-utils/mount.8.adoc:146
25414msgid ""
25415"The programs *mount* and *umount*(8) traditionally maintained a list of "
25416"currently mounted filesystems in the file _/etc/mtab_. The support for "
25417"regular classic _/etc/mtab_ is completely disabled at compile time by "
25418"default, because on current Linux systems it is better to make _/etc/mtab_ a "
25419"symlink to _/proc/mounts_ instead. The regular _mtab_ file maintained in "
25420"userspace cannot reliably work with namespaces, containers and other "
25421"advanced Linux features. If the regular _mtab_ support is enabled, then it's "
25422"possible to use the file as well as the symlink."
25423msgstr ""
25424
25425#. type: Plain text
25426#: ../sys-utils/mount.8.adoc:148
25427msgid ""
25428"If no arguments are given to *mount*, the list of mounted filesystems is "
25429"printed."
25430msgstr ""
25431
25432#. type: Plain text
25433#: ../sys-utils/mount.8.adoc:150
25434msgid ""
25435"If you want to override mount options from _/etc/fstab_, you have to use the "
25436"*-o* option:"
25437msgstr ""
25438
25439#. type: delimited block _
25440#: ../sys-utils/mount.8.adoc:153
25441#, no-wrap
25442msgid "*mount* __device__****|__dir__ *-o* _options_\n"
25443msgstr ""
25444
25445#. type: Plain text
25446#: ../sys-utils/mount.8.adoc:156
25447msgid ""
25448"and then the mount options from the command line will be appended to the "
25449"list of options from _/etc/fstab_. This default behaviour can be changed "
25450"using the *--options-mode* command-line option. The usual behavior is that "
25451"the last option wins if there are conflicting ones."
25452msgstr ""
25453
25454#. type: Plain text
25455#: ../sys-utils/mount.8.adoc:158
25456msgid ""
25457"The *mount* program does not read the _/etc/fstab_ file if both _device_ (or "
25458"LABEL, UUID, ID, PARTUUID or PARTLABEL) and _dir_ are specified. For "
25459"example, to mount device *foo* at */dir*:"
25460msgstr ""
25461
25462#. type: delimited block _
25463#: ../sys-utils/mount.8.adoc:161
25464#, no-wrap
25465msgid "*mount /dev/foo /dir*\n"
25466msgstr ""
25467
25468#. type: Plain text
25469#: ../sys-utils/mount.8.adoc:164
25470msgid ""
25471"This default behaviour can be changed by using the *--options-source-force* "
25472"command-line option to always read configuration from _fstab_. For non-root "
25473"users *mount* always reads the _fstab_ configuration."
25474msgstr ""
25475
25476#. type: Title ===
25477#: ../sys-utils/mount.8.adoc:165
25478#, no-wrap
25479msgid "Non-superuser mounts"
25480msgstr ""
25481
25482#. type: Plain text
25483#: ../sys-utils/mount.8.adoc:168
25484msgid ""
25485"Normally, only the superuser can mount filesystems. However, when _fstab_ "
25486"contains the *user* option on a line, anybody can mount the corresponding "
25487"filesystem."
25488msgstr ""
25489
25490#. type: Plain text
25491#: ../sys-utils/mount.8.adoc:170
25492msgid "Thus, given a line"
25493msgstr ""
25494
25495#. type: delimited block _
25496#: ../sys-utils/mount.8.adoc:173
25497#, no-wrap
25498msgid "*/dev/cdrom /cd iso9660 ro,user,noauto,unhide*\n"
25499msgstr ""
25500
25501#. type: Plain text
25502#: ../sys-utils/mount.8.adoc:176
25503msgid ""
25504"any user can mount the iso9660 filesystem found on an inserted CDROM using "
25505"the command:"
25506msgstr ""
25507
25508#. type: delimited block _
25509#: ../sys-utils/mount.8.adoc:179
25510#, no-wrap
25511msgid "*mount /cd*\n"
25512msgstr ""
25513
25514#. type: Plain text
25515#: ../sys-utils/mount.8.adoc:182
25516msgid ""
25517"Note that *mount* is very strict about non-root users and all paths "
25518"specified on command line are verified before _fstab_ is parsed or a helper "
25519"program is executed. It's strongly recommended to use a valid mountpoint to "
25520"specify filesystem, otherwise *mount* may fail. For example it's a bad idea "
25521"to use NFS or CIFS source on command line."
25522msgstr ""
25523
25524#. type: Plain text
25525#: ../sys-utils/mount.8.adoc:184
25526msgid ""
25527"Since util-linux 2.35, *mount* does not exit when user permissions are "
25528"inadequate according to libmount's internal security rules. Instead, it "
25529"drops suid permissions and continues as regular non-root user. This behavior "
25530"supports use-cases where root permissions are not necessary (e.g., fuse "
25531"filesystems, user namespaces, etc)."
25532msgstr ""
25533
25534#. type: Plain text
25535#: ../sys-utils/mount.8.adoc:186
25536msgid ""
25537"For more details, see *fstab*(5). Only the user that mounted a filesystem "
25538"can unmount it again. If any user should be able to unmount it, then use "
25539"*users* instead of *user* in the _fstab_ line. The *owner* option is similar "
25540"to the *user* option, with the restriction that the user must be the owner "
25541"of the special file. This may be useful e.g. for _/dev/fd_ if a login script "
25542"makes the console user owner of this device. The *group* option is similar, "
25543"with the restriction that the user must be a member of the group of the "
25544"special file."
25545msgstr ""
25546
25547#. type: Title ===
25548#: ../sys-utils/mount.8.adoc:187
25549#, no-wrap
25550msgid "Bind mount operation"
25551msgstr ""
25552
25553#. type: Plain text
25554#: ../sys-utils/mount.8.adoc:190
25555msgid "Remount part of the file hierarchy somewhere else. The call is:"
25556msgstr ""
25557
25558#. type: delimited block _
25559#: ../sys-utils/mount.8.adoc:193
25560#, no-wrap
25561msgid "*mount --bind* _olddir newdir_\n"
25562msgstr ""
25563
25564#. type: Plain text
25565#: ../sys-utils/mount.8.adoc:196
25566msgid "or by using this _fstab_ entry:"
25567msgstr ""
25568
25569#. type: delimited block _
25570#: ../sys-utils/mount.8.adoc:199
25571#, no-wrap
25572msgid "**/**__olddir__ **/**__newdir__ *none bind*\n"
25573msgstr ""
25574
25575#. type: Plain text
25576#: ../sys-utils/mount.8.adoc:202
25577msgid "After this call the same contents are accessible in two places."
25578msgstr ""
25579
25580#. type: Plain text
25581#: ../sys-utils/mount.8.adoc:204
25582msgid ""
25583"It is important to understand that \"bind\" does not create any second-class "
25584"or special node in the kernel VFS. The \"bind\" is just another operation to "
25585"attach a filesystem. There is nowhere stored information that the filesystem "
25586"has been attached by a \"bind\" operation. The _olddir_ and _newdir_ are "
25587"independent and the _olddir_ may be unmounted."
25588msgstr ""
25589
25590#. type: Plain text
25591#: ../sys-utils/mount.8.adoc:206
25592msgid ""
25593"One can also remount a single file (on a single file). It's also possible to "
25594"use a bind mount to create a mountpoint from a regular directory, for "
25595"example:"
25596msgstr ""
25597
25598#. type: delimited block _
25599#: ../sys-utils/mount.8.adoc:209
25600#, no-wrap
25601msgid "*mount --bind foo foo*\n"
25602msgstr ""
25603
25604#. type: Plain text
25605#: ../sys-utils/mount.8.adoc:212
25606msgid ""
25607"The bind mount call attaches only (part of) a single filesystem, not "
25608"possible submounts. The entire file hierarchy including submounts can be "
25609"attached a second place by using:"
25610msgstr ""
25611
25612#. type: delimited block _
25613#: ../sys-utils/mount.8.adoc:215
25614#, no-wrap
25615msgid "*mount --rbind* _olddir newdir_\n"
25616msgstr ""
25617
25618#. type: Plain text
25619#: ../sys-utils/mount.8.adoc:218
25620msgid ""
25621"Note that the filesystem mount options maintained by the kernel will remain "
25622"the same as those on the original mount point. The userspace mount options "
25623"(e.g., _netdev) will not be copied by *mount* and it's necessary to "
25624"explicitly specify the options on the *mount* command line."
25625msgstr ""
25626
25627#. type: Plain text
25628#: ../sys-utils/mount.8.adoc:220
25629msgid ""
25630"Since util-linux 2.27 *mount* permits changing the mount options by passing "
25631"the relevant options along with *--bind*. For example:"
25632msgstr ""
25633
25634#. type: delimited block _
25635#: ../sys-utils/mount.8.adoc:223
25636#, no-wrap
25637msgid "*mount -o bind,ro foo foo*\n"
25638msgstr ""
25639
25640#. type: Plain text
25641#: ../sys-utils/mount.8.adoc:226
25642msgid ""
25643"This feature is not supported by the Linux kernel; it is implemented in "
25644"userspace by an additional *mount*(2) remounting system call. This solution "
25645"is not atomic."
25646msgstr ""
25647
25648#. type: Plain text
25649#: ../sys-utils/mount.8.adoc:228
25650msgid ""
25651"The alternative (classic) way to create a read-only bind mount is to use the "
25652"remount operation, for example:"
25653msgstr ""
25654
25655#. type: delimited block _
25656#: ../sys-utils/mount.8.adoc:231
25657#, no-wrap
25658msgid "*mount --bind* _olddir newdir_ *mount -o remount,bind,ro* _olddir newdir_\n"
25659msgstr ""
25660
25661#. type: Plain text
25662#: ../sys-utils/mount.8.adoc:234
25663msgid ""
25664"Note that a read-only bind will create a read-only mountpoint (VFS entry), "
25665"but the original filesystem superblock will still be writable, meaning that "
25666"the _olddir_ will be writable, but the _newdir_ will be read-only."
25667msgstr ""
25668
25669#. type: Plain text
25670#: ../sys-utils/mount.8.adoc:236
25671msgid ""
25672"It's also possible to change nosuid, nodev, noexec, noatime, nodiratime and "
25673"relatime VFS entry flags via a \"remount,bind\" operation. The other flags "
25674"(for example filesystem-specific flags) are silently ignored. It's "
25675"impossible to change mount options recursively (for example with *-o "
25676"rbind,ro*)."
25677msgstr ""
25678
25679#. type: Plain text
25680#: ../sys-utils/mount.8.adoc:238
25681msgid ""
25682"Since util-linux 2.31, *mount* ignores the *bind* flag from _/etc/fstab_ on "
25683"a *remount* operation (if \"-o remount\" is specified on command line). This "
25684"is necessary to fully control mount options on remount by command line. In "
25685"previous versions the bind flag has been always applied and it was "
25686"impossible to re-define mount options without interaction with the bind "
25687"semantic. This *mount* behavior does not affect situations when "
25688"\"remount,bind\" is specified in the _/etc/fstab_ file."
25689msgstr ""
25690
25691#. type: Title ===
25692#: ../sys-utils/mount.8.adoc:239
25693#, no-wrap
25694msgid "The move operation"
25695msgstr ""
25696
25697#. type: Plain text
25698#: ../sys-utils/mount.8.adoc:242
25699msgid "Move a *mounted tree* to another place (atomically). The call is:"
25700msgstr ""
25701
25702#. type: delimited block _
25703#: ../sys-utils/mount.8.adoc:245
25704#, no-wrap
25705msgid "*mount --move* _olddir newdir_\n"
25706msgstr ""
25707
25708#. type: Plain text
25709#: ../sys-utils/mount.8.adoc:248
25710msgid ""
25711"This will cause the contents which previously appeared under _olddir_ to now "
25712"be accessible under _newdir_. The physical location of the files is not "
25713"changed. Note that _olddir_ has to be a mountpoint."
25714msgstr ""
25715
25716#. type: Plain text
25717#: ../sys-utils/mount.8.adoc:250
25718msgid ""
25719"Note also that moving a mount residing under a shared mount is invalid and "
25720"unsupported. Use *findmnt -o TARGET,PROPAGATION* to see the current "
25721"propagation flags."
25722msgstr ""
25723
25724#. type: Title ===
25725#: ../sys-utils/mount.8.adoc:251
25726#, no-wrap
25727msgid "Shared subtree operations"
25728msgstr ""
25729
25730#. type: Plain text
25731#: ../sys-utils/mount.8.adoc:254
25732msgid ""
25733"Since Linux 2.6.15 it is possible to mark a mount and its submounts as "
25734"shared, private, slave or unbindable. A shared mount provides the ability to "
25735"create mirrors of that mount such that mounts and unmounts within any of the "
25736"mirrors propagate to the other mirror. A slave mount receives propagation "
25737"from its master, but not vice versa. A private mount carries no propagation "
25738"abilities. An unbindable mount is a private mount which cannot be cloned "
25739"through a bind operation. The detailed semantics are documented in "
25740"_Documentation/filesystems/sharedsubtree.txt_ file in the kernel source "
25741"tree; see also *mount_namespaces*(7)."
25742msgstr ""
25743
25744#. type: Plain text
25745#: ../sys-utils/mount.8.adoc:256
25746msgid "Supported operations are:"
25747msgstr ""
25748
25749#. type: delimited block .
25750#: ../sys-utils/mount.8.adoc:262
25751#, no-wrap
25752msgid ""
25753"mount --make-shared mountpoint\n"
25754"mount --make-slave mountpoint\n"
25755"mount --make-private mountpoint\n"
25756"mount --make-unbindable mountpoint\n"
25757msgstr ""
25758
25759#. type: Plain text
25760#: ../sys-utils/mount.8.adoc:265
25761msgid ""
25762"The following commands allow one to recursively change the type of all the "
25763"mounts under a given mountpoint."
25764msgstr ""
25765
25766#. type: delimited block .
25767#: ../sys-utils/mount.8.adoc:271
25768#, no-wrap
25769msgid ""
25770"mount --make-rshared mountpoint\n"
25771"mount --make-rslave mountpoint\n"
25772"mount --make-rprivate mountpoint\n"
25773"mount --make-runbindable mountpoint\n"
25774msgstr ""
25775
25776#. type: Plain text
25777#: ../sys-utils/mount.8.adoc:274
25778#, no-wrap
25779msgid ""
25780"*mount*(8) *does not read* *fstab*(5) when a *--make-** operation is "
25781"requested. All necessary information has to be specified on the command "
25782"line.\n"
25783msgstr ""
25784
25785#. type: Plain text
25786#: ../sys-utils/mount.8.adoc:276
25787msgid ""
25788"Note that the Linux kernel does not allow changing multiple propagation "
25789"flags with a single *mount*(2) system call, and the flags cannot be mixed "
25790"with other mount options and operations."
25791msgstr ""
25792
25793#. type: Plain text
25794#: ../sys-utils/mount.8.adoc:278
25795msgid ""
25796"Since util-linux 2.23 the *mount* command can be used to do more propagation "
25797"(topology) changes by one *mount*(8) call and do it also together with other "
25798"mount operations. This feature is EXPERIMENTAL. The propagation flags are "
25799"applied by additional *mount*(2) system calls when the preceding mount "
25800"operations were successful. Note that this use case is not atomic. It is "
25801"possible to specify the propagation flags in *fstab*(5) as mount options "
25802"(*private*, *slave*, *shared*, *unbindable*, *rprivate*, *rslave*, "
25803"*rshared*, *runbindable*)."
25804msgstr ""
25805
25806#. type: Plain text
25807#: ../sys-utils/mount.8.adoc:280
25808msgid "For example:"
25809msgstr ""
25810
25811#. type: delimited block .
25812#: ../sys-utils/mount.8.adoc:283
25813#, no-wrap
25814msgid "mount --make-private --make-unbindable /dev/sda1 /foo\n"
25815msgstr ""
25816
25817#. type: Plain text
25818#: ../sys-utils/mount.8.adoc:286
25819msgid "is the same as:"
25820msgstr ""
25821
25822#. type: delimited block .
25823#: ../sys-utils/mount.8.adoc:291
25824#, no-wrap
25825msgid ""
25826"mount /dev/sda1 /foo\n"
25827"mount --make-private /foo\n"
25828"mount --make-unbindable /foo\n"
25829msgstr ""
25830
25831#. type: Title ==
25832#: ../sys-utils/mount.8.adoc:293
25833#, no-wrap
25834msgid "COMMAND-LINE OPTIONS"
25835msgstr ""
25836
25837#. type: Plain text
25838#: ../sys-utils/mount.8.adoc:296
25839msgid ""
25840"The full set of mount options used by an invocation of *mount* is determined "
25841"by first extracting the mount options for the filesystem from the _fstab_ "
25842"table, then applying any options specified by the *-o* argument, and finally "
25843"applying a *-r* or *-w* option, when present."
25844msgstr ""
25845
25846#. type: Plain text
25847#: ../sys-utils/mount.8.adoc:298
25848msgid ""
25849"The *mount* command does not pass all command-line options to the "
25850"**/sbin/mount.**__suffix__ mount helpers. The interface between *mount* and "
25851"the mount helpers is described below in the section *EXTERNAL HELPERS*."
25852msgstr ""
25853
25854#. type: Plain text
25855#: ../sys-utils/mount.8.adoc:300
25856msgid "Command-line options available for the *mount* command are:"
25857msgstr ""
25858
25859#. type: Plain text
25860#: ../sys-utils/mount.8.adoc:303
25861msgid ""
25862"Mount all filesystems (of the given types) mentioned in _fstab_ (except for "
25863"those whose line contains the *noauto* keyword). The filesystems are mounted "
25864"following their order in _fstab_. The *mount* command compares filesystem "
25865"source, target (and fs root for bind mount or btrfs) to detect already "
25866"mounted filesystems. The kernel table with already mounted filesystems is "
25867"cached during *mount --all*. This means that all duplicated _fstab_ entries "
25868"will be mounted."
25869msgstr ""
25870
25871#. type: Plain text
25872#: ../sys-utils/mount.8.adoc:305
25873msgid ""
25874"The option *--all* is possible to use for remount operation too. In this "
25875"case all filters (*-t* and *-O*) are applied to the table of already mounted "
25876"filesystems."
25877msgstr ""
25878
25879#. type: Plain text
25880#: ../sys-utils/mount.8.adoc:307
25881msgid ""
25882"Since version 2.35 is possible to use the command line option *-o* to alter "
25883"mount options from _fstab_ (see also *--options-mode*)."
25884msgstr ""
25885
25886#. type: Plain text
25887#: ../sys-utils/mount.8.adoc:309
25888msgid ""
25889"Note that it is a bad practice to use *mount -a* for _fstab_ checking. The "
25890"recommended solution is *findmnt --verify*."
25891msgstr ""
25892
25893#. type: Labeled list
25894#: ../sys-utils/mount.8.adoc:310
25895#, no-wrap
25896msgid "*-B*, *--bind*"
25897msgstr ""
25898
25899#. type: Plain text
25900#: ../sys-utils/mount.8.adoc:312
25901msgid ""
25902"Remount a subtree somewhere else (so that its contents are available in both "
25903"places). See above, under *Bind mounts*."
25904msgstr ""
25905
25906#. type: Labeled list
25907#: ../sys-utils/mount.8.adoc:313 ../sys-utils/umount.8.adoc:60
25908#, no-wrap
25909msgid "*-c*, *--no-canonicalize*"
25910msgstr ""
25911
25912#. type: Plain text
25913#: ../sys-utils/mount.8.adoc:315
25914msgid ""
25915"Don't canonicalize paths. The *mount* command canonicalizes all paths (from "
25916"the command line or _fstab_) by default. This option can be used together "
25917"with the *-f* flag for already canonicalized absolute paths. The option is "
25918"designed for mount helpers which call *mount -i*. It is strongly recommended "
25919"to not use this command-line option for normal mount operations."
25920msgstr ""
25921
25922#. type: Plain text
25923#: ../sys-utils/mount.8.adoc:317
25924msgid ""
25925"Note that *mount* does not pass this option to the **/sbin/mount.**__type__ "
25926"helpers."
25927msgstr ""
25928
25929#. type: Labeled list
25930#: ../sys-utils/mount.8.adoc:318
25931#, no-wrap
25932msgid "*-F*, *--fork*"
25933msgstr ""
25934
25935#. type: Plain text
25936#: ../sys-utils/mount.8.adoc:320
25937msgid ""
25938"(Used in conjunction with *-a*.) Fork off a new incarnation of *mount* for "
25939"each device. This will do the mounts on different devices or different NFS "
25940"servers in parallel. This has the advantage that it is faster; also NFS "
25941"timeouts proceed in parallel. A disadvantage is that the order of the mount "
25942"operations is undefined. Thus, you cannot use this option if you want to "
25943"mount both _/usr_ and _/usr/spool_."
25944msgstr ""
25945
25946#. type: Labeled list
25947#: ../sys-utils/mount.8.adoc:321
25948#, no-wrap
25949msgid "*-f, --fake*"
25950msgstr ""
25951
25952#. type: Plain text
25953#: ../sys-utils/mount.8.adoc:323
25954msgid ""
25955"Causes everything to be done except for the actual system call; if it's not "
25956"obvious, this \"fakes\" mounting the filesystem. This option is useful in "
25957"conjunction with the *-v* flag to determine what the *mount* command is "
25958"trying to do. It can also be used to add entries for devices that were "
25959"mounted earlier with the *-n* option. The *-f* option checks for an existing "
25960"record in _/etc/mtab_ and fails when the record already exists (with a "
25961"regular non-fake mount, this check is done by the kernel)."
25962msgstr ""
25963
25964#. type: Labeled list
25965#: ../sys-utils/mount.8.adoc:324
25966#, no-wrap
25967msgid "*-i, --internal-only*"
25968msgstr ""
25969
25970#. type: Plain text
25971#: ../sys-utils/mount.8.adoc:326
25972msgid "Don't call the **/sbin/mount.**__filesystem__ helper even if it exists."
25973msgstr ""
25974
25975#. type: Plain text
25976#: ../sys-utils/mount.8.adoc:329
25977msgid "Mount the partition that has the specified _label_."
25978msgstr ""
25979
25980#. type: Labeled list
25981#: ../sys-utils/mount.8.adoc:330
25982#, no-wrap
25983msgid "*-l*, *--show-labels*"
25984msgstr ""
25985
25986#. type: Plain text
25987#: ../sys-utils/mount.8.adoc:332
25988msgid ""
25989"Add the labels in the mount output. *mount* must have permission to read the "
25990"disk device (e.g. be set-user-ID root) for this to work. One can set such a "
25991"label for ext2, ext3 or ext4 using the *e2label*(8) utility, or for XFS "
25992"using *xfs_admin*(8), or for reiserfs using *reiserfstune*(8)."
25993msgstr ""
25994
25995#. type: Labeled list
25996#: ../sys-utils/mount.8.adoc:333
25997#, no-wrap
25998msgid "*-M*, *--move*"
25999msgstr ""
26000
26001#. type: Plain text
26002#: ../sys-utils/mount.8.adoc:335
26003msgid ""
26004"Move a subtree to some other place. See above, the subsection *The move "
26005"operation*."
26006msgstr ""
26007
26008#. type: Labeled list
26009#: ../sys-utils/mount.8.adoc:336 ../sys-utils/umount.8.adoc:93
26010#, no-wrap
26011msgid "*-n*, *--no-mtab*"
26012msgstr ""
26013
26014#. type: Plain text
26015#: ../sys-utils/mount.8.adoc:338
26016msgid ""
26017"Mount without writing in _/etc/mtab_. This is necessary for example when "
26018"_/etc_ is on a read-only filesystem."
26019msgstr ""
26020
26021#. type: Labeled list
26022#: ../sys-utils/mount.8.adoc:339 ../sys-utils/umount.8.adoc:86
26023#, no-wrap
26024msgid "*-N*, *--namespace* _ns_"
26025msgstr ""
26026
26027#. type: Plain text
26028#: ../sys-utils/mount.8.adoc:341
26029msgid ""
26030"Perform the mount operation in the mount namespace specified by _ns_. _ns_ "
26031"is either PID of process running in that namespace or special file "
26032"representing that namespace."
26033msgstr ""
26034
26035#. type: Plain text
26036#: ../sys-utils/mount.8.adoc:343
26037#, no-wrap
26038msgid ""
26039"*mount* switches to the mount namespace when it reads _/etc/fstab_, writes "
26040"_/etc/mtab: (or writes to _/run/mount_) and calls the *mount*(2) system "
26041"call, otherwise it runs in the original mount namespace. This means that the "
26042"target namespace does not have to contain any libraries or other "
26043"requirements necessary to execute the *mount*(2) call.\n"
26044msgstr ""
26045
26046#. type: Plain text
26047#: ../sys-utils/mount.8.adoc:345 ../sys-utils/umount.8.adoc:92
26048msgid "See *mount_namespaces*(7) for more information."
26049msgstr ""
26050
26051#. type: Labeled list
26052#: ../sys-utils/mount.8.adoc:346
26053#, no-wrap
26054msgid "*-O*, *--test-opts* _opts_"
26055msgstr ""
26056
26057#. type: Plain text
26058#: ../sys-utils/mount.8.adoc:348
26059msgid ""
26060"Limit the set of filesystems to which the *-a* option applies. In this "
26061"regard it is like the *-t* option except that *-O* is useless without "
26062"*-a*. For example, the command"
26063msgstr ""
26064
26065#. type: Plain text
26066#: ../sys-utils/mount.8.adoc:350
26067#, no-wrap
26068msgid "*mount -a -O no_netdev*\n"
26069msgstr ""
26070
26071#. type: Plain text
26072#: ../sys-utils/mount.8.adoc:352
26073msgid ""
26074"mounts all filesystems except those which have the option _netdev_ specified "
26075"in the options field in the _/etc/fstab_ file."
26076msgstr ""
26077
26078#. type: Plain text
26079#: ../sys-utils/mount.8.adoc:354
26080msgid ""
26081"It is different from *-t* in that each option is matched exactly; a leading "
26082"*no* at the beginning of one option does not negate the rest."
26083msgstr ""
26084
26085#. type: Plain text
26086#: ../sys-utils/mount.8.adoc:356
26087msgid "The *-t* and *-O* options are cumulative in effect; that is, the command"
26088msgstr ""
26089
26090#. type: Plain text
26091#: ../sys-utils/mount.8.adoc:358
26092#, no-wrap
26093msgid "*mount -a -t ext2 -O _netdev*\n"
26094msgstr ""
26095
26096#. type: Plain text
26097#: ../sys-utils/mount.8.adoc:360
26098msgid ""
26099"mounts all ext2 filesystems with the _netdev option, not all filesystems "
26100"that are either ext2 or have the _netdev option specified."
26101msgstr ""
26102
26103#. type: Labeled list
26104#: ../sys-utils/mount.8.adoc:361 ../sys-utils/swapon.8.adoc:58
26105#, no-wrap
26106msgid "*-o*, *--options* _opts_"
26107msgstr ""
26108
26109#. type: Plain text
26110#: ../sys-utils/mount.8.adoc:363
26111msgid ""
26112"Use the specified mount options. The _opts_ argument is a comma-separated "
26113"list. For example:"
26114msgstr ""
26115
26116#. type: Plain text
26117#: ../sys-utils/mount.8.adoc:365
26118#, no-wrap
26119msgid "*mount LABEL=mydisk -o noatime,nodev,nosuid*\n"
26120msgstr ""
26121
26122#. type: Plain text
26123#: ../sys-utils/mount.8.adoc:367
26124msgid ""
26125"For more details, see the *FILESYSTEM-INDEPENDENT MOUNT OPTIONS* and "
26126"*FILESYSTEM-SPECIFIC MOUNT OPTIONS* sections."
26127msgstr ""
26128
26129#. type: Labeled list
26130#: ../sys-utils/mount.8.adoc:368
26131#, no-wrap
26132msgid "*--options-mode* _mode_"
26133msgstr ""
26134
26135#. type: Plain text
26136#: ../sys-utils/mount.8.adoc:370
26137msgid ""
26138"Controls how to combine options from _fstab_/_mtab_ with options from the "
26139"command line. _mode_ can be one of *ignore*, *append*, *prepend* or "
26140"*replace*. For example, *append* means that options from _fstab_ are "
26141"appended to options from the command line. The default value is *prepend* -- "
26142"it means command line options are evaluated after _fstab_ options. Note that "
26143"the last option wins if there are conflicting ones."
26144msgstr ""
26145
26146#. type: Labeled list
26147#: ../sys-utils/mount.8.adoc:371
26148#, no-wrap
26149msgid "*--options-source* _source_"
26150msgstr ""
26151
26152#. type: Plain text
26153#: ../sys-utils/mount.8.adoc:373
26154msgid ""
26155"Source of default options. _source_ is a comma-separated list of *fstab*, "
26156"*mtab* and *disable*. *disable* disables *fstab* and *mtab* and disables "
26157"*--options-source-force*. The default value is *fstab,mtab*."
26158msgstr ""
26159
26160#. type: Labeled list
26161#: ../sys-utils/mount.8.adoc:374
26162#, no-wrap
26163msgid "*--options-source-force*"
26164msgstr ""
26165
26166#. type: Plain text
26167#: ../sys-utils/mount.8.adoc:376
26168msgid ""
26169"Use options from _fstab_/_mtab_ even if both _device_ and _dir_ are "
26170"specified."
26171msgstr ""
26172
26173#. type: Labeled list
26174#: ../sys-utils/mount.8.adoc:377
26175#, no-wrap
26176msgid "*-R*, *--rbind*"
26177msgstr ""
26178
26179#. type: Plain text
26180#: ../sys-utils/mount.8.adoc:379
26181msgid ""
26182"Remount a subtree and all possible submounts somewhere else (so that its "
26183"contents are available in both places). See above, the subsection *Bind "
26184"mounts*."
26185msgstr ""
26186
26187#. type: Plain text
26188#: ../sys-utils/mount.8.adoc:382
26189msgid "Mount the filesystem read-only. A synonym is *-o ro*."
26190msgstr ""
26191
26192#. type: Plain text
26193#: ../sys-utils/mount.8.adoc:384
26194msgid ""
26195"Note that, depending on the filesystem type, state and kernel behavior, the "
26196"system may still write to the device. For example, ext3 and ext4 will replay "
26197"the journal if the filesystem is dirty. To prevent this kind of write "
26198"access, you may want to mount an ext3 or ext4 filesystem with the "
26199"*ro,noload* mount options or set the block device itself to read-only mode, "
26200"see the *blockdev*(8) command."
26201msgstr ""
26202
26203#. type: Plain text
26204#: ../sys-utils/mount.8.adoc:387
26205msgid ""
26206"Tolerate sloppy mount options rather than failing. This will ignore mount "
26207"options not supported by a filesystem type. Not all filesystems support this "
26208"option. Currently it's supported by the *mount.nfs* mount helper only."
26209msgstr ""
26210
26211#. type: Labeled list
26212#: ../sys-utils/mount.8.adoc:388
26213#, no-wrap
26214msgid "*--source* _device_"
26215msgstr ""
26216
26217#. type: Plain text
26218#: ../sys-utils/mount.8.adoc:390
26219msgid ""
26220"If only one argument for the *mount* command is given, then the argument "
26221"might be interpreted as the target (mountpoint) or source (device). This "
26222"option allows you to explicitly define that the argument is the mount "
26223"source."
26224msgstr ""
26225
26226#. type: Labeled list
26227#: ../sys-utils/mount.8.adoc:391
26228#, no-wrap
26229msgid "*--target* _directory_"
26230msgstr ""
26231
26232#. type: Plain text
26233#: ../sys-utils/mount.8.adoc:393
26234msgid ""
26235"If only one argument for the mount command is given, then the argument might "
26236"be interpreted as the target (mountpoint) or source (device). This option "
26237"allows you to explicitly define that the argument is the mount target."
26238msgstr ""
26239
26240#. type: Labeled list
26241#: ../sys-utils/mount.8.adoc:394
26242#, no-wrap
26243msgid "*--target-prefix* _directory_"
26244msgstr ""
26245
26246#. type: Plain text
26247#: ../sys-utils/mount.8.adoc:396
26248msgid ""
26249"Prepend the specified directory to all mount targets. This option can be "
26250"used to follow _fstab_, but mount operations are done in another place, for "
26251"example:"
26252msgstr ""
26253
26254#. type: Plain text
26255#: ../sys-utils/mount.8.adoc:398
26256#, no-wrap
26257msgid "*mount --all --target-prefix /chroot -o X-mount.mkdir*\n"
26258msgstr ""
26259
26260#. type: Plain text
26261#: ../sys-utils/mount.8.adoc:400
26262msgid ""
26263"mounts all from system _fstab_ to _/chroot_, all missing mountpoint are "
26264"created (due to X-mount.mkdir). See also *--fstab* to use an alternative "
26265"_fstab_."
26266msgstr ""
26267
26268#. type: Labeled list
26269#: ../sys-utils/mount.8.adoc:401
26270#, no-wrap
26271msgid "*-T*, *--fstab* _path_"
26272msgstr ""
26273
26274#. type: Plain text
26275#: ../sys-utils/mount.8.adoc:403
26276msgid ""
26277"Specifies an alternative _fstab_ file. If _path_ is a directory, then the "
26278"files in the directory are sorted by *strverscmp*(3); files that start with "
26279"\".\" or without an _.fstab_ extension are ignored. The option can be "
26280"specified more than once. This option is mostly designed for initramfs or "
26281"chroot scripts where additional configuration is specified beyond standard "
26282"system configuration."
26283msgstr ""
26284
26285#. type: Plain text
26286#: ../sys-utils/mount.8.adoc:405
26287msgid ""
26288"Note that *mount* does not pass the option *--fstab* to the "
26289"**/sbin/mount.**__type__ helpers, meaning that the alternative _fstab_ files "
26290"will be invisible for the helpers. This is no problem for normal mounts, but "
26291"user (non-root) mounts always require _fstab_ to verify the user's rights."
26292msgstr ""
26293
26294#. type: Labeled list
26295#: ../sys-utils/mount.8.adoc:406
26296#, no-wrap
26297msgid "*-t*, *--types* _fstype_"
26298msgstr ""
26299
26300#. type: Plain text
26301#: ../sys-utils/mount.8.adoc:408
26302msgid ""
26303"The argument following the *-t* is used to indicate the filesystem type. The "
26304"filesystem types which are currently supported depend on the running "
26305"kernel. See _/proc/filesystems_ and _/lib/modules/$(uname -r)/kernel/fs_ for "
26306"a complete list of the filesystems. The most common are ext2, ext3, ext4, "
26307"xfs, btrfs, vfat, sysfs, proc, nfs and cifs."
26308msgstr ""
26309
26310#. type: Plain text
26311#: ../sys-utils/mount.8.adoc:410
26312msgid ""
26313"The programs *mount* and *umount*(8) support filesystem subtypes. The "
26314"subtype is defined by a '.subtype' suffix. For example 'fuse.sshfs'. It's "
26315"recommended to use subtype notation rather than add any prefix to the mount "
26316"source (for example 'sshfs#example.com' is deprecated)."
26317msgstr ""
26318
26319#. TRANSLATORS: Keep {asterisk} untranslated.
26320#. type: Plain text
26321#: ../sys-utils/mount.8.adoc:413
26322msgid ""
26323"If no *-t* option is given, or if the *auto* type is specified, *mount* will "
26324"try to guess the desired type. *mount* uses the *libblkid*(3) library for "
26325"guessing the filesystem type; if that does not turn up anything that looks "
26326"familiar, *mount* will try to read the file _/etc/filesystems_, or, if that "
26327"does not exist, _/proc/filesystems_. All of the filesystem types listed "
26328"there will be tried, except for those that are labeled \"nodev\" "
26329"(e.g. _devpts_, _proc_ and _nfs_). If _/etc/filesystems_ ends in a line with "
26330"a single {asterisk}, mount will read _/proc/filesystems_ afterwards. While "
26331"trying, all filesystem types will be mounted with the mount option *silent*."
26332msgstr ""
26333
26334#. type: Plain text
26335#: ../sys-utils/mount.8.adoc:415
26336msgid ""
26337"The *auto* type may be useful for user-mounted floppies. Creating a file "
26338"_/etc/filesystems_ can be useful to change the probe order (e.g., to try "
26339"vfat before msdos or ext3 before ext2) or if you use a kernel module "
26340"autoloader."
26341msgstr ""
26342
26343#. type: Plain text
26344#: ../sys-utils/mount.8.adoc:417
26345msgid ""
26346"More than one type may be specified in a comma-separated list, for the *-t* "
26347"option as well as in an _/etc/fstab_ entry. The list of filesystem types for "
26348"the *-t* option can be prefixed with *no* to specify the filesystem types on "
26349"which no action should be taken. The prefix *no* has no effect when "
26350"specified in an _/etc/fstab_ entry."
26351msgstr ""
26352
26353#. type: Plain text
26354#: ../sys-utils/mount.8.adoc:419
26355msgid ""
26356"The prefix *no* can be meaningful with the *-a* option. For example, the "
26357"command"
26358msgstr ""
26359
26360#. type: Plain text
26361#: ../sys-utils/mount.8.adoc:421
26362#, no-wrap
26363msgid "*mount -a -t nomsdos,smbfs*\n"
26364msgstr ""
26365
26366#. type: Plain text
26367#: ../sys-utils/mount.8.adoc:423
26368msgid "mounts all filesystems except those of type _msdos_ and _smbfs_."
26369msgstr ""
26370
26371#. type: Plain text
26372#: ../sys-utils/mount.8.adoc:425
26373msgid ""
26374"For most types all the *mount* program has to do is issue a simple "
26375"*mount*(2) system call, and no detailed knowledge of the filesystem type is "
26376"required. For a few types however (like nfs, nfs4, cifs, smbfs, ncpfs) an ad "
26377"hoc code is necessary. The nfs, nfs4, cifs, smbfs, and ncpfs filesystems "
26378"have a separate mount program. In order to make it possible to treat all "
26379"types in a uniform way, *mount* will execute the program "
26380"**/sbin/mount.**__type__ (if that exists) when called with type "
26381"_type_. Since different versions of the *smbmount* program have different "
26382"calling conventions, */sbin/mount.smbfs* may have to be a shell script that "
26383"sets up the desired call."
26384msgstr ""
26385
26386#. type: Plain text
26387#: ../sys-utils/mount.8.adoc:428
26388msgid "Mount the partition that has the specified _uuid_."
26389msgstr ""
26390
26391#. type: Labeled list
26392#: ../sys-utils/mount.8.adoc:432
26393#, no-wrap
26394msgid "*-w*, *--rw*, *--read-write*"
26395msgstr ""
26396
26397#. type: Plain text
26398#: ../sys-utils/mount.8.adoc:434
26399msgid ""
26400"Mount the filesystem read/write. Read-write is the kernel default and the "
26401"*mount* default is to try read-only if the previous mount syscall with "
26402"read-write flags on write-protected devices of filesystems failed."
26403msgstr ""
26404
26405#. type: Plain text
26406#: ../sys-utils/mount.8.adoc:436
26407msgid "A synonym is *-o rw*."
26408msgstr ""
26409
26410#. type: Plain text
26411#: ../sys-utils/mount.8.adoc:438
26412msgid ""
26413"Note that specifying *-w* on the command line forces *mount* to never try "
26414"read-only mount on write-protected devices or already mounted read-only "
26415"filesystems."
26416msgstr ""
26417
26418#. type: Title ==
26419#: ../sys-utils/mount.8.adoc:445
26420#, no-wrap
26421msgid "FILESYSTEM-INDEPENDENT MOUNT OPTIONS"
26422msgstr ""
26423
26424#. type: Plain text
26425#: ../sys-utils/mount.8.adoc:448
26426msgid ""
26427"Some of these options are only useful when they appear in the _/etc/fstab_ "
26428"file."
26429msgstr ""
26430
26431#. type: Plain text
26432#: ../sys-utils/mount.8.adoc:450
26433msgid ""
26434"Some of these options could be enabled or disabled by default in the system "
26435"kernel. To check the current setting see the options in _/proc/mounts_. Note "
26436"that filesystems also have per-filesystem specific default mount options "
26437"(see for example *tune2fs -l* output for ext_N_ filesystems)."
26438msgstr ""
26439
26440#. type: Plain text
26441#: ../sys-utils/mount.8.adoc:452
26442msgid ""
26443"The following options apply to any filesystem that is being mounted (but not "
26444"every filesystem actually honors them - e.g., the *sync* option today has an "
26445"effect only for ext2, ext3, ext4, fat, vfat, ufs and xfs):"
26446msgstr ""
26447
26448#. type: Labeled list
26449#: ../sys-utils/mount.8.adoc:453
26450#, no-wrap
26451msgid "*async*"
26452msgstr ""
26453
26454#. type: Plain text
26455#: ../sys-utils/mount.8.adoc:455
26456msgid ""
26457"All I/O to the filesystem should be done asynchronously. (See also the "
26458"*sync* option.)"
26459msgstr ""
26460
26461#. type: Labeled list
26462#: ../sys-utils/mount.8.adoc:456
26463#, no-wrap
26464msgid "*atime*"
26465msgstr ""
26466
26467#. type: Plain text
26468#: ../sys-utils/mount.8.adoc:458
26469msgid ""
26470"Do not use the *noatime* feature, so the inode access time is controlled by "
5db1d29a 26471"kernel defaults. See also the descriptions of the *relatime* and "
36e96905
MB
26472"*strictatime* mount options."
26473msgstr ""
26474
26475#. type: Labeled list
26476#: ../sys-utils/mount.8.adoc:459
26477#, no-wrap
26478msgid "*noatime*"
26479msgstr ""
26480
26481#. type: Plain text
26482#: ../sys-utils/mount.8.adoc:461
26483msgid ""
26484"Do not update inode access times on this filesystem (e.g. for faster access "
26485"on the news spool to speed up news servers). This works for all inode types "
5db1d29a 26486"(directories too), so it implies *nodiratime*."
36e96905
MB
26487msgstr ""
26488
26489#. type: Labeled list
26490#: ../sys-utils/mount.8.adoc:462
26491#, no-wrap
26492msgid "*auto*"
26493msgstr ""
26494
26495#. type: Plain text
26496#: ../sys-utils/mount.8.adoc:464
26497msgid "Can be mounted with the *-a* option."
26498msgstr ""
26499
26500#. type: Plain text
26501#: ../sys-utils/mount.8.adoc:467
26502msgid ""
26503"Can only be mounted explicitly (i.e., the *-a* option will not cause the "
26504"filesystem to be mounted)."
26505msgstr ""
26506
26507#. type: Labeled list
26508#: ../sys-utils/mount.8.adoc:468
26509#, no-wrap
26510msgid ""
26511"**context=**__context__, **fscontext=**__context__, "
b81d5971 26512"**defcontext=**__context__, and **rootcontext=**__context__"
36e96905
MB
26513msgstr ""
26514
26515#. type: Plain text
26516#: ../sys-utils/mount.8.adoc:470
26517msgid ""
26518"The *context=* option is useful when mounting filesystems that do not "
26519"support extended attributes, such as a floppy or hard disk formatted with "
26520"VFAT, or systems that are not normally running under SELinux, such as an "
26521"ext3 or ext4 formatted disk from a non-SELinux workstation. You can also use "
26522"*context=* on filesystems you do not trust, such as a floppy. It also helps "
26523"in compatibility with xattr-supporting filesystems on earlier 2.4.<x> kernel "
26524"versions. Even where xattrs are supported, you can save time not having to "
26525"label every file by assigning the entire disk one security context."
26526msgstr ""
26527
26528#. type: Plain text
26529#: ../sys-utils/mount.8.adoc:472
26530msgid ""
26531"A commonly used option for removable media is "
b81d5971 26532"*context=\"system_u:object_r:removable_t*."
36e96905
MB
26533msgstr ""
26534
26535#. type: Plain text
26536#: ../sys-utils/mount.8.adoc:474
26537msgid ""
26538"Two other options are *fscontext=* and *defcontext=*, both of which are "
26539"mutually exclusive of the *context=* option. This means you can use "
26540"fscontext and defcontext with each other, but neither can be used with "
26541"context."
26542msgstr ""
26543
26544#. type: Plain text
26545#: ../sys-utils/mount.8.adoc:476
26546msgid ""
26547"The *fscontext=* option works for all filesystems, regardless of their xattr "
26548"support. The fscontext option sets the overarching filesystem label to a "
26549"specific security context. This filesystem label is separate from the "
26550"individual labels on the files. It represents the entire filesystem for "
26551"certain kinds of permission checks, such as during mount or file "
26552"creation. Individual file labels are still obtained from the xattrs on the "
26553"files themselves. The context option actually sets the aggregate context "
26554"that fscontext provides, in addition to supplying the same label for "
26555"individual files."
26556msgstr ""
26557
26558#. type: Plain text
26559#: ../sys-utils/mount.8.adoc:478
26560msgid ""
26561"You can set the default security context for unlabeled files using "
26562"*defcontext=* option. This overrides the value set for unlabeled files in "
26563"the policy and requires a filesystem that supports xattr labeling."
26564msgstr ""
26565
26566#. type: Plain text
26567#: ../sys-utils/mount.8.adoc:480
26568msgid ""
26569"The *rootcontext=* option allows you to explicitly label the root inode of a "
26570"FS being mounted before that FS or inode becomes visible to userspace. This "
26571"was found to be useful for things like stateless Linux."
26572msgstr ""
26573
26574#. type: Plain text
26575#: ../sys-utils/mount.8.adoc:482
26576msgid ""
26577"Note that the kernel rejects any remount request that includes the context "
26578"option, *even* when unchanged from the current context."
26579msgstr ""
26580
26581#. type: Plain text
26582#: ../sys-utils/mount.8.adoc:484
26583#, no-wrap
26584msgid ""
26585"*Warning: the* _context_ *value might contain commas*, in which case the "
26586"value has to be properly quoted, otherwise *mount* will interpret the comma "
26587"as a separator between mount options. Don't forget that the shell strips off "
26588"quotes and thus *double quoting is required*. For example:\n"
26589msgstr ""
26590
26591#. type: delimited block _
26592#: ../sys-utils/mount.8.adoc:487
26593msgid ""
26594"mount -t tmpfs none /mnt -o \\ "
26595"'context=\"system_u:object_r:tmp_t:s0:c127,c456\",noexec'"
26596msgstr ""
26597
26598#. type: Plain text
26599#: ../sys-utils/mount.8.adoc:490
26600msgid "For more details, see *selinux*(8)."
26601msgstr ""
26602
26603#. type: Plain text
26604#: ../sys-utils/mount.8.adoc:493
26605msgid ""
26606"Use the default options: *rw*, *suid*, *dev*, *exec*, *auto*, *nouser*, and "
26607"*async*."
26608msgstr ""
26609
26610#. type: Plain text
26611#: ../sys-utils/mount.8.adoc:495
26612msgid ""
26613"Note that the real set of all default mount options depends on the kernel "
26614"and filesystem type. See the beginning of this section for more details."
26615msgstr ""
26616
26617#. type: Labeled list
26618#: ../sys-utils/mount.8.adoc:496
26619#, no-wrap
26620msgid "*dev*"
26621msgstr ""
26622
26623#. type: Plain text
26624#: ../sys-utils/mount.8.adoc:498
26625msgid "Interpret character or block special devices on the filesystem."
26626msgstr ""
26627
26628#. type: Labeled list
26629#: ../sys-utils/mount.8.adoc:499
26630#, no-wrap
26631msgid "*nodev*"
26632msgstr ""
26633
26634#. type: Plain text
26635#: ../sys-utils/mount.8.adoc:501
26636msgid "Do not interpret character or block special devices on the filesystem."
26637msgstr ""
26638
26639#. type: Labeled list
26640#: ../sys-utils/mount.8.adoc:502
26641#, no-wrap
26642msgid "*diratime*"
26643msgstr ""
26644
26645#. type: Plain text
26646#: ../sys-utils/mount.8.adoc:504
26647msgid ""
26648"Update directory inode access times on this filesystem. This is the "
26649"default. (This option is ignored when *noatime* is set.)"
26650msgstr ""
26651
26652#. type: Labeled list
26653#: ../sys-utils/mount.8.adoc:505
26654#, no-wrap
26655msgid "*nodiratime*"
26656msgstr ""
26657
26658#. type: Plain text
26659#: ../sys-utils/mount.8.adoc:507
26660msgid ""
26661"Do not update directory inode access times on this filesystem. (This option "
26662"is implied when *noatime* is set.)"
26663msgstr ""
26664
26665#. type: Labeled list
26666#: ../sys-utils/mount.8.adoc:508
26667#, no-wrap
26668msgid "*dirsync*"
26669msgstr ""
26670
26671#. type: Plain text
26672#: ../sys-utils/mount.8.adoc:510
26673msgid ""
26674"All directory updates within the filesystem should be done "
26675"synchronously. This affects the following system calls: *creat*(2), "
26676"*link*(2), *unlink*(2), *symlink*(2), *mkdir*(2), *rmdir*(2), *mknod*(2) and "
26677"*rename*(2)."
26678msgstr ""
26679
26680#. type: Labeled list
26681#: ../sys-utils/mount.8.adoc:511
26682#, no-wrap
26683msgid "*exec*"
26684msgstr ""
26685
26686#. type: Plain text
26687#: ../sys-utils/mount.8.adoc:513
26688msgid "Permit execution of binaries."
26689msgstr ""
26690
26691#. type: Labeled list
26692#: ../sys-utils/mount.8.adoc:514
26693#, no-wrap
26694msgid "*noexec*"
26695msgstr ""
26696
26697#. type: Plain text
26698#: ../sys-utils/mount.8.adoc:516
26699msgid "Do not permit direct execution of any binaries on the mounted filesystem."
26700msgstr ""
26701
26702#. type: Labeled list
26703#: ../sys-utils/mount.8.adoc:517
26704#, no-wrap
26705msgid "*group*"
26706msgstr ""
26707
26708#. type: Plain text
26709#: ../sys-utils/mount.8.adoc:519
26710msgid ""
26711"Allow an ordinary user to mount the filesystem if one of that user's groups "
26712"matches the group of the device. This option implies the options *nosuid* "
26713"and *nodev* (unless overridden by subsequent options, as in the option line "
26714"*group,dev,suid*)."
26715msgstr ""
26716
26717#. type: Labeled list
26718#: ../sys-utils/mount.8.adoc:520
26719#, no-wrap
26720msgid "*iversion*"
26721msgstr ""
26722
26723#. type: Plain text
26724#: ../sys-utils/mount.8.adoc:522
26725msgid "Every time the inode is modified, the i_version field will be incremented."
26726msgstr ""
26727
26728#. type: Labeled list
26729#: ../sys-utils/mount.8.adoc:523
26730#, no-wrap
26731msgid "*noiversion*"
26732msgstr ""
26733
26734#. type: Plain text
26735#: ../sys-utils/mount.8.adoc:525
26736msgid "Do not increment the i_version inode field."
26737msgstr ""
26738
26739#. type: Labeled list
26740#: ../sys-utils/mount.8.adoc:526
26741#, no-wrap
26742msgid "*mand*"
26743msgstr ""
26744
26745#. type: Plain text
26746#: ../sys-utils/mount.8.adoc:528
26747msgid "Allow mandatory locks on this filesystem. See *fcntl*(2)."
26748msgstr ""
26749
26750#. type: Labeled list
26751#: ../sys-utils/mount.8.adoc:529
26752#, no-wrap
26753msgid "*nomand*"
26754msgstr ""
26755
26756#. type: Plain text
26757#: ../sys-utils/mount.8.adoc:531
26758msgid "Do not allow mandatory locks on this filesystem."
26759msgstr ""
26760
26761#. type: Labeled list
26762#: ../sys-utils/mount.8.adoc:532
26763#, no-wrap
26764msgid "*_netdev*"
26765msgstr ""
26766
26767#. type: Plain text
26768#: ../sys-utils/mount.8.adoc:534
26769msgid ""
26770"The filesystem resides on a device that requires network access (used to "
26771"prevent the system from attempting to mount these filesystems until the "
26772"network has been enabled on the system)."
26773msgstr ""
26774
26775#. type: Plain text
26776#: ../sys-utils/mount.8.adoc:537
26777msgid "Do not report errors for this device if it does not exist."
26778msgstr ""
26779
26780#. type: Labeled list
26781#: ../sys-utils/mount.8.adoc:538
26782#, no-wrap
26783msgid "*relatime*"
26784msgstr ""
26785
26786#. type: Plain text
26787#: ../sys-utils/mount.8.adoc:540
26788msgid ""
26789"Update inode access times relative to modify or change time. Access time is "
26790"only updated if the previous access time was earlier than the current modify "
5db1d29a 26791"or change time. (Similar to *noatime*, but it doesn't break *mutt*(1) or "
36e96905
MB
26792"other applications that need to know if a file has been read since the last "
26793"time it was modified.)"
26794msgstr ""
26795
26796#. type: Plain text
26797#: ../sys-utils/mount.8.adoc:542
26798msgid ""
26799"Since Linux 2.6.30, the kernel defaults to the behavior provided by this "
b81d5971 26800"option (unless *noatime* was specified), and the *strictatime* option is "
36e96905
MB
26801"required to obtain traditional semantics. In addition, since Linux 2.6.30, "
26802"the file's last access time is always updated if it is more than 1 day old."
26803msgstr ""
26804
26805#. type: Labeled list
26806#: ../sys-utils/mount.8.adoc:543
26807#, no-wrap
26808msgid "*norelatime*"
26809msgstr ""
26810
26811#. type: Plain text
26812#: ../sys-utils/mount.8.adoc:545
26813msgid "Do not use the *relatime* feature. See also the *strictatime* mount option."
26814msgstr ""
26815
26816#. type: Labeled list
26817#: ../sys-utils/mount.8.adoc:546
26818#, no-wrap
26819msgid "*strictatime*"
26820msgstr ""
26821
26822#. type: Plain text
26823#: ../sys-utils/mount.8.adoc:548
26824msgid ""
26825"Allows to explicitly request full atime updates. This makes it possible for "
b81d5971
MB
26826"the kernel to default to *relatime* or *noatime* but still allow userspace "
26827"to override it. For more details about the default system mount options see "
26828"_/proc/mounts_."
36e96905
MB
26829msgstr ""
26830
26831#. type: Labeled list
26832#: ../sys-utils/mount.8.adoc:549
26833#, no-wrap
26834msgid "*nostrictatime*"
26835msgstr ""
26836
26837#. type: Plain text
26838#: ../sys-utils/mount.8.adoc:551
26839msgid "Use the kernel's default behavior for inode access time updates."
26840msgstr ""
26841
26842#. type: Labeled list
26843#: ../sys-utils/mount.8.adoc:552
26844#, no-wrap
26845msgid "*lazytime*"
26846msgstr ""
26847
26848#. type: Plain text
26849#: ../sys-utils/mount.8.adoc:554
26850msgid ""
26851"Only update times (atime, mtime, ctime) on the in-memory version of the file "
26852"inode."
26853msgstr ""
26854
26855#. type: Plain text
26856#: ../sys-utils/mount.8.adoc:556
26857msgid ""
26858"This mount option significantly reduces writes to the inode table for "
26859"workloads that perform frequent random writes to preallocated files."
26860msgstr ""
26861
26862#. type: Plain text
26863#: ../sys-utils/mount.8.adoc:558
26864msgid "The on-disk timestamps are updated only when:"
26865msgstr ""
26866
26867#. type: Plain text
26868#: ../sys-utils/mount.8.adoc:560
26869msgid "the inode needs to be updated for some change unrelated to file timestamps"
26870msgstr ""
26871
26872#. type: Plain text
26873#: ../sys-utils/mount.8.adoc:561
26874msgid "the application employs *fsync*(2), *syncfs*(2), or *sync*(2)"
26875msgstr ""
26876
26877#. type: Plain text
26878#: ../sys-utils/mount.8.adoc:562
26879msgid "an undeleted inode is evicted from memory"
26880msgstr ""
26881
26882#. type: Plain text
26883#: ../sys-utils/mount.8.adoc:563
26884msgid "more than 24 hours have passed since the inode was written to disk."
26885msgstr ""
26886
26887#. type: Labeled list
26888#: ../sys-utils/mount.8.adoc:564
26889#, no-wrap
26890msgid "*nolazytime*"
26891msgstr ""
26892
26893#. type: Plain text
26894#: ../sys-utils/mount.8.adoc:566
26895msgid "Do not use the lazytime feature."
26896msgstr ""
26897
26898#. type: Labeled list
26899#: ../sys-utils/mount.8.adoc:567
26900#, no-wrap
26901msgid "*suid*"
26902msgstr ""
26903
26904#. type: Plain text
26905#: ../sys-utils/mount.8.adoc:569
26906msgid ""
26907"Honor set-user-ID and set-group-ID bits or file capabilities when executing "
26908"programs from this filesystem."
26909msgstr ""
26910
26911#. type: Labeled list
26912#: ../sys-utils/mount.8.adoc:570
26913#, no-wrap
26914msgid "*nosuid*"
26915msgstr ""
26916
26917#. type: Plain text
26918#: ../sys-utils/mount.8.adoc:572
26919msgid ""
26920"Do not honor set-user-ID and set-group-ID bits or file capabilities when "
26921"executing programs from this filesystem."
26922msgstr ""
26923
26924#. type: Labeled list
26925#: ../sys-utils/mount.8.adoc:573
26926#, no-wrap
26927msgid "*silent*"
26928msgstr ""
26929
26930#. type: Plain text
26931#: ../sys-utils/mount.8.adoc:575
26932msgid "Turn on the silent flag."
26933msgstr ""
26934
26935#. type: Labeled list
26936#: ../sys-utils/mount.8.adoc:576
26937#, no-wrap
26938msgid "*loud*"
26939msgstr ""
26940
26941#. type: Plain text
26942#: ../sys-utils/mount.8.adoc:578
26943msgid "Turn off the silent flag."
26944msgstr ""
26945
26946#. type: Plain text
26947#: ../sys-utils/mount.8.adoc:581
26948msgid ""
26949"Allow an ordinary user to mount the filesystem if that user is the owner of "
26950"the device. This option implies the options *nosuid* and *nodev* (unless "
26951"overridden by subsequent options, as in the option line *owner,dev,suid*)."
26952msgstr ""
26953
26954#. type: Labeled list
26955#: ../sys-utils/mount.8.adoc:582
26956#, no-wrap
26957msgid "*remount*"
26958msgstr ""
26959
26960#. type: Plain text
26961#: ../sys-utils/mount.8.adoc:584
26962msgid ""
26963"Attempt to remount an already-mounted filesystem. This is commonly used to "
26964"change the mount flags for a filesystem, especially to make a readonly "
26965"filesystem writable. It does not change device or mount point."
26966msgstr ""
26967
26968#. type: Plain text
26969#: ../sys-utils/mount.8.adoc:586
26970msgid ""
26971"The remount operation together with the *bind* flag has special "
26972"semantics. See above, the subsection *Bind mounts*."
26973msgstr ""
26974
26975#. type: Plain text
26976#: ../sys-utils/mount.8.adoc:588
26977msgid ""
26978"The remount functionality follows the standard way the *mount* command works "
26979"with options from _fstab_. This means that *mount* does not read _fstab_ (or "
26980"_mtab_) only when both _device_ and _dir_ are specified."
26981msgstr ""
26982
26983#. type: Plain text
26984#: ../sys-utils/mount.8.adoc:590
26985#, no-wrap
26986msgid "*mount -o remount,rw /dev/foo /dir*\n"
26987msgstr ""
26988
26989#. type: Plain text
26990#: ../sys-utils/mount.8.adoc:592
26991msgid ""
26992"After this call all old mount options are replaced and arbitrary stuff from "
26993"_fstab_ (or _mtab_) is ignored, except the loop= option which is internally "
26994"generated and maintained by the mount command."
26995msgstr ""
26996
26997#. type: Plain text
26998#: ../sys-utils/mount.8.adoc:594
26999#, no-wrap
27000msgid "*mount -o remount,rw /dir*\n"
27001msgstr ""
27002
27003#. type: Plain text
27004#: ../sys-utils/mount.8.adoc:596
27005msgid ""
27006"After this call, mount reads _fstab_ and merges these options with the "
27007"options from the command line (*-o*). If no mountpoint is found in _fstab_, "
27008"then a remount with unspecified source is allowed."
27009msgstr ""
27010
27011#. type: Plain text
27012#: ../sys-utils/mount.8.adoc:598
27013#, no-wrap
27014msgid ""
27015"*mount* allows the use of *--all* to remount all already mounted filesystems "
27016"which match a specified filter (*-O* and *-t*). For example:\n"
27017msgstr ""
27018
27019#. type: Plain text
27020#: ../sys-utils/mount.8.adoc:600
27021#, no-wrap
27022msgid "*mount --all -o remount,ro -t vfat*\n"
27023msgstr ""
27024
27025#. type: Plain text
27026#: ../sys-utils/mount.8.adoc:602
27027msgid ""
27028"remounts all already mounted vfat filesystems in read-only mode. Each of the "
27029"filesystems is remounted by *mount -o remount,ro /dir* semantic. This means "
27030"the *mount* command reads _fstab_ or _mtab_ and merges these options with "
27031"the options from the command line."
27032msgstr ""
27033
27034#. type: Labeled list
27035#: ../sys-utils/mount.8.adoc:603
27036#, no-wrap
27037msgid "*ro*"
27038msgstr ""
27039
27040#. type: Plain text
27041#: ../sys-utils/mount.8.adoc:605
27042msgid "Mount the filesystem read-only."
27043msgstr ""
27044
27045#. type: Labeled list
27046#: ../sys-utils/mount.8.adoc:606
27047#, no-wrap
27048msgid "*rw*"
27049msgstr ""
27050
27051#. type: Plain text
27052#: ../sys-utils/mount.8.adoc:608
27053msgid "Mount the filesystem read-write."
27054msgstr ""
27055
27056#. type: Labeled list
27057#: ../sys-utils/mount.8.adoc:609
27058#, no-wrap
27059msgid "*sync*"
27060msgstr ""
27061
27062#. type: Plain text
27063#: ../sys-utils/mount.8.adoc:611
27064msgid ""
27065"All I/O to the filesystem should be done synchronously. In the case of media "
27066"with a limited number of write cycles (e.g. some flash drives), *sync* may "
27067"cause life-cycle shortening."
27068msgstr ""
27069
27070#. type: Plain text
27071#: ../sys-utils/mount.8.adoc:614
27072msgid ""
27073"Allow an ordinary user to mount the filesystem. The name of the mounting "
27074"user is written to the _mtab_ file (or to the private libmount file in "
27075"_/run/mount_ on systems without a regular _mtab_) so that this same user can "
27076"unmount the filesystem again. This option implies the options *noexec*, "
27077"*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
27078"option line *user,exec,dev,suid*)."
27079msgstr ""
27080
27081#. type: Labeled list
27082#: ../sys-utils/mount.8.adoc:615
27083#, no-wrap
27084msgid "*nouser*"
27085msgstr ""
27086
27087#. type: Plain text
27088#: ../sys-utils/mount.8.adoc:617
27089msgid ""
27090"Forbid an ordinary user to mount the filesystem. This is the default; it "
27091"does not imply any other options."
27092msgstr ""
27093
27094#. type: Labeled list
27095#: ../sys-utils/mount.8.adoc:618
27096#, no-wrap
27097msgid "*users*"
27098msgstr ""
27099
27100#. type: Plain text
27101#: ../sys-utils/mount.8.adoc:620
27102msgid ""
27103"Allow any user to mount and to unmount the filesystem, even when some other "
27104"ordinary user mounted it. This option implies the options *noexec*, "
27105"*nosuid*, and *nodev* (unless overridden by subsequent options, as in the "
27106"option line *users,exec,dev,suid*)."
27107msgstr ""
27108
27109#. type: Labeled list
27110#: ../sys-utils/mount.8.adoc:621
27111#, no-wrap
27112msgid "*X-**"
27113msgstr ""
27114
27115#. type: Plain text
27116#: ../sys-utils/mount.8.adoc:623
27117msgid ""
27118"All options prefixed with \"X-\" are interpreted as comments or as userspace "
27119"application-specific options. These options are not stored in user space "
27120"(e.g., _mtab_ file), nor sent to the mount._type_ helpers nor to the "
27121"*mount*(2) system call. The suggested format is **X-**__appname__._option_."
27122msgstr ""
27123
27124#. type: Labeled list
27125#: ../sys-utils/mount.8.adoc:624
27126#, no-wrap
27127msgid "*x-**"
27128msgstr ""
27129
27130#. type: Plain text
27131#: ../sys-utils/mount.8.adoc:626
27132msgid ""
27133"The same as *X-** options, but stored permanently in user space. This means "
27134"the options are also available for *umount*(8) or other operations. Note "
27135"that maintaining mount options in user space is tricky, because it's "
27136"necessary use libmount-based tools and there is no guarantee that the "
27137"options will be always available (for example after a move mount operation "
27138"or in unshared namespace)."
27139msgstr ""
27140
27141#. type: Plain text
27142#: ../sys-utils/mount.8.adoc:628
27143msgid ""
27144"Note that before util-linux v2.30 the x-* options have not been maintained "
27145"by libmount and stored in user space (functionality was the same as for X-* "
27146"now), but due to the growing number of use-cases (in initrd, systemd etc.) "
27147"the functionality has been extended to keep existing _fstab_ configurations "
27148"usable without a change."
27149msgstr ""
27150
27151#. type: Labeled list
27152#: ../sys-utils/mount.8.adoc:629
27153#, no-wrap
27154msgid "*X-mount.mkdir*[=_mode_]"
27155msgstr ""
27156
27157#. type: Plain text
27158#: ../sys-utils/mount.8.adoc:631
27159msgid ""
27160"Allow to make a target directory (mountpoint) if it does not exit yet. The "
27161"optional argument _mode_ specifies the filesystem access mode used for "
27162"*mkdir*(2) in octal notation. The default mode is 0755. This functionality "
27163"is supported only for root users or when mount executed without suid "
27164"permissions. The option is also supported as x-mount.mkdir, this notation is "
27165"deprecated since v2.30."
27166msgstr ""
27167
27168#. type: Labeled list
27169#: ../sys-utils/mount.8.adoc:632
27170#, no-wrap
27171msgid "*nosymfollow*"
27172msgstr ""
27173
27174#. type: Plain text
27175#: ../sys-utils/mount.8.adoc:634
27176msgid ""
27177"Do not follow symlinks when resolving paths. Symlinks can still be created, "
27178"and *readlink*(1), *readlink*(2), *realpath*(1), and *realpath*(3) all still "
27179"work properly."
27180msgstr ""
27181
27182#. type: Title ==
27183#: ../sys-utils/mount.8.adoc:635
27184#, no-wrap
27185msgid "FILESYSTEM-SPECIFIC MOUNT OPTIONS"
27186msgstr ""
27187
27188#. type: Plain text
27189#: ../sys-utils/mount.8.adoc:638
27190msgid ""
27191"This section lists options that are specific to particular "
27192"filesystems. Where possible, you should first consult filesystem-specific "
27193"manual pages for details. Some of those pages are listed in the following "
27194"table."
27195msgstr ""
27196
27197#. type: Table
27198#: ../sys-utils/mount.8.adoc:649
27199#, no-wrap
27200msgid ""
27201"|*Filesystem(s)* |*Manual page*\n"
27202"|btrfs |*btrfs*(5)\n"
27203"|cifs |*mount.cifs*(8)\n"
27204"|ext2, ext3, ext4 |*ext4*(5)\n"
27205"|fuse |*fuse*(8)\n"
27206"|nfs |*nfs*(5)\n"
27207"|tmpfs |*tmpfs*(5)\n"
27208"|xfs |*xfs*(5)\n"
27209msgstr ""
27210
27211#. type: Plain text
27212#: ../sys-utils/mount.8.adoc:652
27213msgid ""
27214"Note that some of the pages listed above might be available only after you "
27215"install the respective userland tools."
27216msgstr ""
27217
27218#. type: Plain text
27219#: ../sys-utils/mount.8.adoc:654
27220msgid ""
27221"The following options apply only to certain filesystems. We sort them by "
27222"filesystem. All options follow the *-o* flag."
27223msgstr ""
27224
27225#. type: Plain text
27226#: ../sys-utils/mount.8.adoc:656
27227msgid ""
27228"What options are supported depends a bit on the running kernel. Further "
27229"information may be available in filesystem-specific files in the kernel "
27230"source subdirectory _Documentation/filesystems_."
27231msgstr ""
27232
27233#. type: Title ===
27234#: ../sys-utils/mount.8.adoc:657
27235#, no-wrap
27236msgid "Mount options for adfs"
27237msgstr ""
27238
27239#. type: Labeled list
27240#: ../sys-utils/mount.8.adoc:659 ../sys-utils/mount.8.adoc:667
27241#: ../sys-utils/mount.8.adoc:717 ../sys-utils/mount.8.adoc:748
27242#: ../sys-utils/mount.8.adoc:875 ../sys-utils/mount.8.adoc:907
27243#, no-wrap
27244msgid "**uid=**__value__ and **gid=**__value__"
27245msgstr ""
27246
27247#. type: Plain text
27248#: ../sys-utils/mount.8.adoc:661
27249msgid "Set the owner and group of the files in the filesystem (default: uid=gid=0)."
27250msgstr ""
27251
27252#. type: Labeled list
27253#: ../sys-utils/mount.8.adoc:662
27254#, no-wrap
27255msgid "**ownmask=**__value__ and **othmask=**__value__"
27256msgstr ""
27257
27258#. type: Plain text
27259#: ../sys-utils/mount.8.adoc:664
27260msgid ""
27261"Set the permission mask for ADFS 'owner' permissions and 'other' "
27262"permissions, respectively (default: 0700 and 0077, respectively). See also "
27263"_/usr/src/linux/Documentation/filesystems/adfs.rst_."
27264msgstr ""
27265
27266#. type: Title ===
27267#: ../sys-utils/mount.8.adoc:665
27268#, no-wrap
27269msgid "Mount options for affs"
27270msgstr ""
27271
27272#. type: Plain text
27273#: ../sys-utils/mount.8.adoc:669
27274msgid ""
27275"Set the owner and group of the root of the filesystem (default: uid=gid=0, "
27276"but with option *uid* or *gid* without specified value, the UID and GID of "
27277"the current process are taken)."
27278msgstr ""
27279
27280#. type: Labeled list
27281#: ../sys-utils/mount.8.adoc:670
27282#, no-wrap
27283msgid "**setuid=**__value__ and **setgid=**__value__"
27284msgstr ""
27285
27286#. type: Plain text
27287#: ../sys-utils/mount.8.adoc:672
27288msgid "Set the owner and group of all files."
27289msgstr ""
27290
27291#. type: Labeled list
27292#: ../sys-utils/mount.8.adoc:673 ../sys-utils/mount.8.adoc:710
27293#: ../sys-utils/mount.8.adoc:720 ../sys-utils/mount.8.adoc:913
27294#, no-wrap
27295msgid "**mode=**__value__"
27296msgstr ""
27297
27298#. type: Plain text
27299#: ../sys-utils/mount.8.adoc:675
27300msgid ""
27301"Set the mode of all files to _value_ & 0777 disregarding the original "
27302"permissions. Add search permission to directories that have read "
27303"permission. The value is given in octal."
27304msgstr ""
27305
27306#. type: Labeled list
27307#: ../sys-utils/mount.8.adoc:676
27308#, no-wrap
27309msgid "*protect*"
27310msgstr ""
27311
27312#. type: Plain text
27313#: ../sys-utils/mount.8.adoc:678
27314msgid "Do not allow any changes to the protection bits on the filesystem."
27315msgstr ""
27316
27317#. type: Labeled list
27318#: ../sys-utils/mount.8.adoc:679
27319#, no-wrap
27320msgid "*usemp*"
27321msgstr ""
27322
27323#. type: Plain text
27324#: ../sys-utils/mount.8.adoc:681
27325msgid ""
27326"Set UID and GID of the root of the filesystem to the UID and GID of the "
27327"mount point upon the first sync or umount, and then clear this "
27328"option. Strange..."
27329msgstr ""
27330
27331#. type: Labeled list
27332#: ../sys-utils/mount.8.adoc:682
27333#, no-wrap
27334msgid "*verbose*"
27335msgstr ""
27336
27337#. type: Plain text
27338#: ../sys-utils/mount.8.adoc:684
27339msgid "Print an informational message for each successful mount."
27340msgstr ""
27341
27342#. type: Labeled list
27343#: ../sys-utils/mount.8.adoc:685
27344#, no-wrap
27345msgid "**prefix=**__string__"
27346msgstr ""
27347
27348#. type: Plain text
27349#: ../sys-utils/mount.8.adoc:687
27350msgid "Prefix used before volume name, when following a link."
27351msgstr ""
27352
27353#. type: Labeled list
27354#: ../sys-utils/mount.8.adoc:688
27355#, no-wrap
27356msgid "**volume=**__string__"
27357msgstr ""
27358
27359#. type: Plain text
27360#: ../sys-utils/mount.8.adoc:690
27361msgid ""
27362"Prefix (of length at most 30) used before '/' when following a symbolic "
27363"link."
27364msgstr ""
27365
27366#. type: Labeled list
27367#: ../sys-utils/mount.8.adoc:691
27368#, no-wrap
27369msgid "**reserved=**__value__"
27370msgstr ""
27371
27372#. type: Plain text
27373#: ../sys-utils/mount.8.adoc:693
27374msgid "(Default: 2.) Number of unused blocks at the start of the device."
27375msgstr ""
27376
27377#. type: Labeled list
27378#: ../sys-utils/mount.8.adoc:694
27379#, no-wrap
27380msgid "**root=**__value__"
27381msgstr ""
27382
27383#. type: Plain text
27384#: ../sys-utils/mount.8.adoc:696
27385msgid "Give explicitly the location of the root block."
27386msgstr ""
27387
27388#. type: Labeled list
27389#: ../sys-utils/mount.8.adoc:697
27390#, no-wrap
27391msgid "**bs=**__value__"
27392msgstr ""
27393
27394#. type: Plain text
27395#: ../sys-utils/mount.8.adoc:699
27396msgid "Give blocksize. Allowed values are 512, 1024, 2048, 4096."
27397msgstr ""
27398
27399#. type: Labeled list
27400#: ../sys-utils/mount.8.adoc:700
27401#, no-wrap
27402msgid "**grpquota**|**noquota**|**quota**|*usrquota*"
27403msgstr ""
27404
27405#. type: Plain text
27406#: ../sys-utils/mount.8.adoc:702
27407msgid ""
27408"These options are accepted but ignored. (However, quota utilities may react "
27409"to such strings in _/etc/fstab_.)"
27410msgstr ""
27411
27412#. type: Title ===
27413#: ../sys-utils/mount.8.adoc:703
27414#, no-wrap
27415msgid "Mount options for debugfs"
27416msgstr ""
27417
27418#. type: Plain text
27419#: ../sys-utils/mount.8.adoc:706
27420msgid ""
27421"The debugfs filesystem is a pseudo filesystem, traditionally mounted on "
27422"_/sys/kernel/debug_. As of kernel version 3.4, debugfs has the following "
27423"options:"
27424msgstr ""
27425
27426#. type: Labeled list
27427#: ../sys-utils/mount.8.adoc:707 ../sys-utils/mount.8.adoc:858
27428#, no-wrap
27429msgid "**uid=**__n__**, gid=**__n__"
27430msgstr ""
27431
27432#. type: Plain text
27433#: ../sys-utils/mount.8.adoc:709
27434msgid "Set the owner and group of the mountpoint."
27435msgstr ""
27436
27437#. type: Plain text
27438#: ../sys-utils/mount.8.adoc:712
27439msgid "Sets the mode of the mountpoint."
27440msgstr ""
27441
27442#. type: Title ===
27443#: ../sys-utils/mount.8.adoc:713
27444#, no-wrap
27445msgid "Mount options for devpts"
27446msgstr ""
27447
27448#. type: Plain text
27449#: ../sys-utils/mount.8.adoc:716
27450msgid ""
27451"The devpts filesystem is a pseudo filesystem, traditionally mounted on "
27452"_/dev/pts_. In order to acquire a pseudo terminal, a process opens "
27453"_/dev/ptmx_; the number of the pseudo terminal is then made available to the "
27454"process and the pseudo terminal slave can be accessed as "
27455"_/dev/pts/_<number>."
27456msgstr ""
27457
27458#. type: Plain text
27459#: ../sys-utils/mount.8.adoc:719
27460msgid ""
27461"This sets the owner or the group of newly created pseudo terminals to the "
27462"specified values. When nothing is specified, they will be set to the UID and "
27463"GID of the creating process. For example, if there is a tty group with GID "
27464"5, then *gid=5* will cause newly created pseudo terminals to belong to the "
27465"tty group."
27466msgstr ""
27467
27468#. type: Plain text
27469#: ../sys-utils/mount.8.adoc:722
27470msgid ""
27471"Set the mode of newly created pseudo terminals to the specified value. The "
27472"default is 0600. A value of *mode=620* and *gid=5* makes \"mesg y\" the "
27473"default on newly created pseudo terminals."
27474msgstr ""
27475
27476#. type: Labeled list
27477#: ../sys-utils/mount.8.adoc:723
27478#, no-wrap
27479msgid "*newinstance*"
27480msgstr ""
27481
27482#. type: Plain text
27483#: ../sys-utils/mount.8.adoc:725
27484msgid ""
27485"Create a private instance of the devpts filesystem, such that indices of "
27486"pseudo terminals allocated in this new instance are independent of indices "
27487"created in other instances of devpts."
27488msgstr ""
27489
27490#. type: Plain text
27491#: ../sys-utils/mount.8.adoc:727
27492msgid ""
27493"All mounts of devpts without this *newinstance* option share the same set of "
27494"pseudo terminal indices (i.e., legacy mode). Each mount of devpts with the "
27495"*newinstance* option has a private set of pseudo terminal indices."
27496msgstr ""
27497
27498#. type: Plain text
27499#: ../sys-utils/mount.8.adoc:729
27500msgid ""
27501"This option is mainly used to support containers in the Linux kernel. It is "
27502"implemented in Linux kernel versions starting with 2.6.29. Further, this "
27503"mount option is valid only if *CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled "
27504"in the kernel configuration."
27505msgstr ""
27506
27507#. type: Plain text
27508#: ../sys-utils/mount.8.adoc:731
27509msgid ""
27510"To use this option effectively, _/dev/ptmx_ must be a symbolic link to "
27511"_pts/ptmx_. See _Documentation/filesystems/devpts.txt_ in the Linux kernel "
27512"source tree for details."
27513msgstr ""
27514
27515#. type: Labeled list
27516#: ../sys-utils/mount.8.adoc:732
27517#, no-wrap
27518msgid "**ptmxmode=**__value__"
27519msgstr ""
27520
27521#. type: Plain text
27522#: ../sys-utils/mount.8.adoc:734
27523msgid "Set the mode for the new _ptmx_ device node in the devpts filesystem."
27524msgstr ""
27525
27526#. type: Plain text
27527#: ../sys-utils/mount.8.adoc:736
27528msgid ""
27529"With the support for multiple instances of devpts (see *newinstance* option "
27530"above), each instance has a private _ptmx_ node in the root of the devpts "
27531"filesystem (typically _/dev/pts/ptmx_)."
27532msgstr ""
27533
27534#. type: Plain text
27535#: ../sys-utils/mount.8.adoc:738
27536msgid ""
27537"For compatibility with older versions of the kernel, the default mode of the "
27538"new _ptmx_ node is 0000. **ptmxmode=**__value__ specifies a more useful mode "
27539"for the _ptmx_ node and is highly recommended when the *newinstance* option "
27540"is specified."
27541msgstr ""
27542
27543#. type: Plain text
27544#: ../sys-utils/mount.8.adoc:740
27545msgid ""
27546"This option is only implemented in Linux kernel versions starting with "
27547"2.6.29. Further, this option is valid only if "
27548"*CONFIG_DEVPTS_MULTIPLE_INSTANCES* is enabled in the kernel configuration."
27549msgstr ""
27550
27551#. type: Title ===
27552#: ../sys-utils/mount.8.adoc:741
27553#, no-wrap
27554msgid "Mount options for fat"
27555msgstr ""
27556
27557#. type: Plain text
27558#: ../sys-utils/mount.8.adoc:744
27559msgid ""
27560"(Note: _fat_ is not a separate filesystem, but a common part of the _msdos_, "
27561"_umsdos_ and _vfat_ filesystems.)"
27562msgstr ""
27563
27564#. type: Labeled list
27565#: ../sys-utils/mount.8.adoc:745
27566#, no-wrap
27567msgid "*blocksize=*{**512**|**1024**|*2048*}"
27568msgstr ""
27569
27570#. type: Plain text
27571#: ../sys-utils/mount.8.adoc:747
27572msgid "Set blocksize (default 512). This option is obsolete."
27573msgstr ""
27574
27575#. type: Plain text
27576#: ../sys-utils/mount.8.adoc:750 ../sys-utils/mount.8.adoc:860
27577#: ../sys-utils/mount.8.adoc:877
27578msgid ""
27579"Set the owner and group of all files. (Default: the UID and GID of the "
27580"current process.)"
27581msgstr ""
27582
27583#. type: Labeled list
27584#: ../sys-utils/mount.8.adoc:751 ../sys-utils/mount.8.adoc:878
27585#, no-wrap
27586msgid "**umask=**__value__"
27587msgstr ""
27588
27589#. type: Plain text
27590#: ../sys-utils/mount.8.adoc:753 ../sys-utils/mount.8.adoc:880
27591msgid ""
27592"Set the umask (the bitmask of the permissions that are *not* present). The "
27593"default is the umask of the current process. The value is given in octal."
27594msgstr ""
27595
27596#. type: Labeled list
27597#: ../sys-utils/mount.8.adoc:754
27598#, no-wrap
27599msgid "**dmask=**__value__"
27600msgstr ""
27601
27602#. type: Plain text
27603#: ../sys-utils/mount.8.adoc:756
27604msgid ""
27605"Set the umask applied to directories only. The default is the umask of the "
27606"current process. The value is given in octal."
27607msgstr ""
27608
27609#. type: Labeled list
27610#: ../sys-utils/mount.8.adoc:757
27611#, no-wrap
27612msgid "**fmask=**__value__"
27613msgstr ""
27614
27615#. type: Plain text
27616#: ../sys-utils/mount.8.adoc:759
27617msgid ""
27618"Set the umask applied to regular files only. The default is the umask of the "
27619"current process. The value is given in octal."
27620msgstr ""
27621
27622#. type: Labeled list
27623#: ../sys-utils/mount.8.adoc:760
27624#, no-wrap
27625msgid "**allow_utime=**__value__"
27626msgstr ""
27627
27628#. type: Plain text
27629#: ../sys-utils/mount.8.adoc:762
27630msgid "This option controls the permission check of mtime/atime."
27631msgstr ""
27632
27633#. type: Labeled list
27634#: ../sys-utils/mount.8.adoc:763
27635#, no-wrap
27636msgid "*20*"
27637msgstr ""
27638
27639#. type: Plain text
27640#: ../sys-utils/mount.8.adoc:765
27641msgid "If current process is in group of file's group ID, you can change timestamp."
27642msgstr ""
27643
27644#. type: Plain text
27645#: ../sys-utils/mount.8.adoc:768
27646msgid "Other users can change timestamp."
27647msgstr ""
27648
27649#. type: Plain text
27650#: ../sys-utils/mount.8.adoc:770
27651msgid ""
27652"The default is set from 'dmask' option. (If the directory is writable, "
27653"*utime*(2) is also allowed. I.e. ~dmask & 022)"
27654msgstr ""
27655
27656#. type: Plain text
27657#: ../sys-utils/mount.8.adoc:772
27658msgid ""
27659"Normally *utime*(2) checks that the current process is owner of the file, or "
27660"that it has the *CAP_FOWNER* capability. But FAT filesystems don't have "
27661"UID/GID on disk, so the normal check is too inflexible. With this option you "
27662"can relax it."
27663msgstr ""
27664
27665#. type: Labeled list
27666#: ../sys-utils/mount.8.adoc:773
27667#, no-wrap
27668msgid "**check=**__value__"
27669msgstr ""
27670
27671#. type: Plain text
27672#: ../sys-utils/mount.8.adoc:775
27673msgid "Three different levels of pickiness can be chosen:"
27674msgstr ""
27675
27676#. type: Labeled list
27677#: ../sys-utils/mount.8.adoc:776
27678#, no-wrap
27679msgid "*r*[*elaxed*]"
27680msgstr ""
27681
27682#. type: Plain text
27683#: ../sys-utils/mount.8.adoc:778
27684msgid ""
27685"Upper and lower case are accepted and equivalent, long name parts are "
27686"truncated (e.g. _verylongname.foobar_ becomes _verylong.foo_), leading and "
27687"embedded spaces are accepted in each name part (name and extension)."
27688msgstr ""
27689
27690#. type: Labeled list
27691#: ../sys-utils/mount.8.adoc:779
27692#, no-wrap
27693msgid "*n*[*ormal*]"
27694msgstr ""
27695
27696#. type: Plain text
27697#: ../sys-utils/mount.8.adoc:781
27698msgid ""
27699"Like \"relaxed\", but many special characters (*, ?, <, spaces, etc.) are "
27700"rejected. This is the default."
27701msgstr ""
27702
27703#. type: Labeled list
27704#: ../sys-utils/mount.8.adoc:782
27705#, no-wrap
27706msgid "*s*[*trict*]"
27707msgstr ""
27708
27709#. type: Plain text
27710#: ../sys-utils/mount.8.adoc:784
27711msgid ""
27712"Like \"normal\", but names that contain long parts or special characters "
27713"that are sometimes used on Linux but are not accepted by MS-DOS (+, =, etc.) "
27714"are rejected."
27715msgstr ""
27716
27717#. type: Labeled list
27718#: ../sys-utils/mount.8.adoc:785
27719#, no-wrap
27720msgid "**codepage=**__value__"
27721msgstr ""
27722
27723#. type: Plain text
27724#: ../sys-utils/mount.8.adoc:787
27725msgid ""
27726"Sets the codepage for converting to shortname characters on FAT and VFAT "
27727"filesystems. By default, codepage 437 is used."
27728msgstr ""
27729
27730#. type: Labeled list
27731#: ../sys-utils/mount.8.adoc:788 ../sys-utils/mount.8.adoc:884
27732#: ../sys-utils/mount.8.adoc:922
27733#, no-wrap
27734msgid "**conv=**__mode__"
27735msgstr ""
27736
27737#. type: Plain text
27738#: ../sys-utils/mount.8.adoc:790
27739msgid "This option is obsolete and may fail or be ignored."
27740msgstr ""
27741
27742#. type: Labeled list
27743#: ../sys-utils/mount.8.adoc:791
27744#, no-wrap
27745msgid "**cvf_format=**__module__"
27746msgstr ""
27747
27748#. type: Plain text
27749#: ../sys-utils/mount.8.adoc:793
27750msgid ""
27751"Forces the driver to use the CVF (Compressed Volume File) module "
27752"cvf__module_ instead of auto-detection. If the kernel supports kmod, the "
27753"cvf_format=xxx option also controls on-demand CVF module loading. This "
27754"option is obsolete."
27755msgstr ""
27756
27757#. type: Labeled list
27758#: ../sys-utils/mount.8.adoc:794
27759#, no-wrap
27760msgid "**cvf_option=**__option__"
27761msgstr ""
27762
27763#. type: Plain text
27764#: ../sys-utils/mount.8.adoc:796
27765msgid "Option passed to the CVF module. This option is obsolete."
27766msgstr ""
27767
27768#. type: Labeled list
27769#: ../sys-utils/mount.8.adoc:797
27770#, no-wrap
27771msgid "*debug*"
27772msgstr ""
27773
27774#. type: Plain text
27775#: ../sys-utils/mount.8.adoc:799
27776msgid ""
27777"Turn on the _debug_ flag. A version string and a list of filesystem "
27778"parameters will be printed (these data are also printed if the parameters "
27779"appear to be inconsistent)."
27780msgstr ""
27781
27782#. type: Labeled list
27783#: ../sys-utils/mount.8.adoc:800
27784#, no-wrap
27785msgid "*discard*"
27786msgstr ""
27787
27788#. type: Plain text
27789#: ../sys-utils/mount.8.adoc:802
27790msgid ""
27791"If set, causes discard/TRIM commands to be issued to the block device when "
27792"blocks are freed. This is useful for SSD devices and "
27793"sparse/thinly-provisioned LUNs."
27794msgstr ""
27795
27796#. type: Labeled list
27797#: ../sys-utils/mount.8.adoc:803
27798#, no-wrap
27799msgid "*dos1xfloppy*"
27800msgstr ""
27801
27802#. type: Plain text
27803#: ../sys-utils/mount.8.adoc:805
27804msgid ""
27805"If set, use a fallback default BIOS Parameter Block configuration, "
27806"determined by backing device size. These static parameters match defaults "
27807"assumed by DOS 1.x for 160 kiB, 180 kiB, 320 kiB, and 360 kiB floppies and "
27808"floppy images."
27809msgstr ""
27810
27811#. type: Labeled list
27812#: ../sys-utils/mount.8.adoc:806
27813#, no-wrap
27814msgid "*errors=*{**panic**|**continue**|*remount-ro*}"
27815msgstr ""
27816
27817#. type: Plain text
27818#: ../sys-utils/mount.8.adoc:808
27819msgid ""
27820"Specify FAT behavior on critical errors: panic, continue without doing "
27821"anything, or remount the partition in read-only mode (default behavior)."
27822msgstr ""
27823
27824#. type: Labeled list
27825#: ../sys-utils/mount.8.adoc:809
27826#, no-wrap
27827msgid "*fat=*{**12**|**16**|*32*}"
27828msgstr ""
27829
27830#. type: Plain text
27831#: ../sys-utils/mount.8.adoc:811
27832msgid ""
27833"Specify a 12, 16 or 32 bit fat. This overrides the automatic FAT type "
27834"detection routine. Use with caution!"
27835msgstr ""
27836
27837#. type: Labeled list
27838#: ../sys-utils/mount.8.adoc:812 ../sys-utils/mount.8.adoc:936
27839#, no-wrap
27840msgid "**iocharset=**__value__"
27841msgstr ""
27842
27843#. type: Plain text
27844#: ../sys-utils/mount.8.adoc:814
27845msgid ""
27846"Character set to use for converting between 8 bit characters and 16 bit "
27847"Unicode characters. The default is iso8859-1. Long filenames are stored on "
27848"disk in Unicode format."
27849msgstr ""
27850
27851#. type: Labeled list
27852#: ../sys-utils/mount.8.adoc:815
27853#, no-wrap
27854msgid "*nfs=*{**stale_rw**|*nostale_ro*}"
27855msgstr ""
27856
27857#. type: Plain text
27858#: ../sys-utils/mount.8.adoc:817
27859msgid "Enable this only if you want to export the FAT filesystem over NFS."
27860msgstr ""
27861
27862#. type: Plain text
27863#: ../sys-utils/mount.8.adoc:819
27864#, no-wrap
27865msgid ""
27866"*stale_rw*: This option maintains an index (cache) of directory inodes which "
27867"is used by the nfs-related code to improve look-ups. Full file operations "
27868"(read/write) over NFS are supported but with cache eviction at NFS server, "
27869"this could result in spurious *ESTALE* errors.\n"
27870msgstr ""
27871
27872#. type: Plain text
27873#: ../sys-utils/mount.8.adoc:821
27874#, no-wrap
27875msgid ""
27876"*nostale_ro*: This option bases the inode number and file handle on the "
27877"on-disk location of a file in the FAT directory entry. This ensures that "
27878"*ESTALE* will not be returned after a file is evicted from the inode "
27879"cache. However, it means that operations such as rename, create and unlink "
27880"could cause file handles that previously pointed at one file to point at a "
27881"different file, potentially causing data corruption. For this reason, this "
27882"option also mounts the filesystem readonly.\n"
27883msgstr ""
27884
27885#. type: Plain text
27886#: ../sys-utils/mount.8.adoc:823
27887msgid ""
27888"To maintain backward compatibility, *-o nfs* is also accepted, defaulting to "
27889"*stale_rw*."
27890msgstr ""
27891
27892#. type: Labeled list
27893#: ../sys-utils/mount.8.adoc:824
27894#, no-wrap
27895msgid "*tz=UTC*"
27896msgstr ""
27897
27898#. type: Plain text
27899#: ../sys-utils/mount.8.adoc:826
27900msgid ""
27901"This option disables the conversion of timestamps between local time (as "
27902"used by Windows on FAT) and UTC (which Linux uses internally). This is "
27903"particularly useful when mounting devices (like digital cameras) that are "
27904"set to UTC in order to avoid the pitfalls of local time."
27905msgstr ""
27906
27907#. type: Labeled list
27908#: ../sys-utils/mount.8.adoc:827
27909#, no-wrap
27910msgid "**time_offset=**__minutes__"
27911msgstr ""
27912
27913#. type: Plain text
27914#: ../sys-utils/mount.8.adoc:829
27915msgid ""
27916"Set offset for conversion of timestamps from local time used by FAT to "
27917"UTC. I.e., _minutes_ will be subtracted from each timestamp to convert it to "
27918"UTC used internally by Linux. This is useful when the time zone set in the "
27919"kernel via *settimeofday*(2) is not the time zone used by the "
27920"filesystem. Note that this option still does not provide correct time stamps "
27921"in all cases in presence of DST - time stamps in a different DST setting "
27922"will be off by one hour."
27923msgstr ""
27924
27925#. type: Labeled list
27926#: ../sys-utils/mount.8.adoc:830 ../sys-utils/mount.8.adoc:870
27927#, no-wrap
27928msgid "*quiet*"
27929msgstr ""
27930
27931#. type: Plain text
27932#: ../sys-utils/mount.8.adoc:832
27933msgid ""
27934"Turn on the _quiet_ flag. Attempts to chown or chmod files do not return "
27935"errors, although they fail. Use with caution!"
27936msgstr ""
27937
27938#. type: Labeled list
27939#: ../sys-utils/mount.8.adoc:833
27940#, no-wrap
27941msgid "*rodir*"
27942msgstr ""
27943
27944#. type: Plain text
27945#: ../sys-utils/mount.8.adoc:835
27946msgid ""
27947"FAT has the *ATTR_RO* (read-only) attribute. On Windows, the *ATTR_RO* of "
27948"the directory will just be ignored, and is used only by applications as a "
27949"flag (e.g. it's set for the customized folder)."
27950msgstr ""
27951
27952#. type: Plain text
27953#: ../sys-utils/mount.8.adoc:837
27954msgid ""
27955"If you want to use *ATTR_RO* as read-only flag even for the directory, set "
27956"this option."
27957msgstr ""
27958
27959#. type: Labeled list
27960#: ../sys-utils/mount.8.adoc:838
27961#, no-wrap
27962msgid "*showexec*"
27963msgstr ""
27964
27965#. type: Plain text
27966#: ../sys-utils/mount.8.adoc:840
27967msgid ""
27968"If set, the execute permission bits of the file will be allowed only if the "
27969"extension part of the name is .EXE, .COM, or .BAT. Not set by default."
27970msgstr ""
27971
27972#. type: Labeled list
27973#: ../sys-utils/mount.8.adoc:841
27974#, no-wrap
27975msgid "*sys_immutable*"
27976msgstr ""
27977
27978#. type: Plain text
27979#: ../sys-utils/mount.8.adoc:843
27980msgid ""
27981"If set, *ATTR_SYS* attribute on FAT is handled as *IMMUTABLE* flag on "
27982"Linux. Not set by default."
27983msgstr ""
27984
27985#. type: Labeled list
27986#: ../sys-utils/mount.8.adoc:844
27987#, no-wrap
27988msgid "*flush*"
27989msgstr ""
27990
27991#. type: Plain text
27992#: ../sys-utils/mount.8.adoc:846
27993msgid ""
27994"If set, the filesystem will try to flush to disk more early than normal. Not "
27995"set by default."
27996msgstr ""
27997
27998#. type: Labeled list
27999#: ../sys-utils/mount.8.adoc:847
28000#, no-wrap
28001msgid "*usefree*"
28002msgstr ""
28003
28004#. type: Plain text
28005#: ../sys-utils/mount.8.adoc:849
28006msgid ""
28007"Use the \"free clusters\" value stored on *FSINFO*. It'll be used to "
28008"determine number of free clusters without scanning disk. But it's not used "
28009"by default, because recent Windows don't update it correctly in some "
28010"case. If you are sure the \"free clusters\" on *FSINFO* is correct, by this "
28011"option you can avoid scanning disk."
28012msgstr ""
28013
28014#. type: Labeled list
28015#: ../sys-utils/mount.8.adoc:850
28016#, no-wrap
28017msgid "*dots*, *nodots*, *dotsOK=*[**yes**|*no*]"
28018msgstr ""
28019
28020#. type: Plain text
28021#: ../sys-utils/mount.8.adoc:852
28022msgid ""
28023"Various misguided attempts to force Unix or DOS conventions onto a FAT "
28024"filesystem."
28025msgstr ""
28026
28027#. type: Title ===
28028#: ../sys-utils/mount.8.adoc:853
28029#, no-wrap
28030msgid "Mount options for hfs"
28031msgstr ""
28032
28033#. type: Labeled list
28034#: ../sys-utils/mount.8.adoc:855
28035#, no-wrap
28036msgid "**creator=**__cccc__**, type=**__cccc__"
28037msgstr ""
28038
28039#. type: Plain text
28040#: ../sys-utils/mount.8.adoc:857
28041msgid ""
28042"Set the creator/type values as shown by the MacOS finder used for creating "
28043"new files. Default values: '????'."
28044msgstr ""
28045
28046#. type: Labeled list
28047#: ../sys-utils/mount.8.adoc:861
28048#, no-wrap
28049msgid "**dir_umask=**__n__**, file_umask=**__n__**, umask=**__n__"
28050msgstr ""
28051
28052#. type: Plain text
28053#: ../sys-utils/mount.8.adoc:863
28054msgid ""
28055"Set the umask used for all directories, all regular files, or all files and "
28056"directories. Defaults to the umask of the current process."
28057msgstr ""
28058
28059#. type: Labeled list
28060#: ../sys-utils/mount.8.adoc:864
28061#, no-wrap
28062msgid "**session=**__n__"
28063msgstr ""
28064
28065#. type: Plain text
28066#: ../sys-utils/mount.8.adoc:866
28067msgid ""
28068"Select the CDROM session to mount. Defaults to leaving that decision to the "
28069"CDROM driver. This option will fail with anything but a CDROM as underlying "
28070"device."
28071msgstr ""
28072
28073#. type: Labeled list
28074#: ../sys-utils/mount.8.adoc:867
28075#, no-wrap
28076msgid "**part=**__n__"
28077msgstr ""
28078
28079#. type: Plain text
28080#: ../sys-utils/mount.8.adoc:869
28081msgid ""
28082"Select partition number n from the device. Only makes sense for "
28083"CDROMs. Defaults to not parsing the partition table at all."
28084msgstr ""
28085
28086#. type: Plain text
28087#: ../sys-utils/mount.8.adoc:872
28088msgid "Don't complain about invalid mount options."
28089msgstr ""
28090
28091#. type: Title ===
28092#: ../sys-utils/mount.8.adoc:873
28093#, no-wrap
28094msgid "Mount options for hpfs"
28095msgstr ""
28096
28097#. type: Labeled list
28098#: ../sys-utils/mount.8.adoc:881
28099#, no-wrap
28100msgid "*case=*{**lower**|*asis*}"
28101msgstr ""
28102
28103#. type: Plain text
28104#: ../sys-utils/mount.8.adoc:883
28105msgid ""
28106"Convert all files names to lower case, or leave them. (Default: "
28107"*case=lower*.)"
28108msgstr ""
28109
28110#. type: Plain text
28111#: ../sys-utils/mount.8.adoc:886 ../sys-utils/mount.8.adoc:924
28112msgid "This option is obsolete and may fail or being ignored."
28113msgstr ""
28114
28115#. type: Labeled list
28116#: ../sys-utils/mount.8.adoc:887
28117#, no-wrap
28118msgid "*nocheck*"
28119msgstr ""
28120
28121#. type: Plain text
28122#: ../sys-utils/mount.8.adoc:889
28123msgid "Do not abort mounting when certain consistency checks fail."
28124msgstr ""
28125
28126#. type: Title ===
28127#: ../sys-utils/mount.8.adoc:890
28128#, no-wrap
28129msgid "Mount options for iso9660"
28130msgstr ""
28131
28132#. type: Plain text
28133#: ../sys-utils/mount.8.adoc:893
28134msgid ""
28135"ISO 9660 is a standard describing a filesystem structure to be used on "
28136"CD-ROMs. (This filesystem type is also seen on some DVDs. See also the _udf_ "
28137"filesystem.)"
28138msgstr ""
28139
28140#. type: Plain text
28141#: ../sys-utils/mount.8.adoc:895
28142msgid ""
28143"Normal _iso9660_ filenames appear in an 8.3 format (i.e., DOS-like "
28144"restrictions on filename length), and in addition all characters are in "
28145"upper case. Also there is no field for file ownership, protection, number of "
28146"links, provision for block/character devices, etc."
28147msgstr ""
28148
28149#. type: Plain text
28150#: ../sys-utils/mount.8.adoc:897
28151msgid ""
28152"Rock Ridge is an extension to iso9660 that provides all of these UNIX-like "
28153"features. Basically there are extensions to each directory record that "
28154"supply all of the additional information, and when Rock Ridge is in use, the "
28155"filesystem is indistinguishable from a normal UNIX filesystem (except that "
28156"it is read-only, of course)."
28157msgstr ""
28158
28159#. type: Labeled list
28160#: ../sys-utils/mount.8.adoc:898
28161#, no-wrap
28162msgid "*norock*"
28163msgstr ""
28164
28165#. type: Plain text
28166#: ../sys-utils/mount.8.adoc:900
28167msgid "Disable the use of Rock Ridge extensions, even if available. Cf. *map*."
28168msgstr ""
28169
28170#. type: Labeled list
28171#: ../sys-utils/mount.8.adoc:901
28172#, no-wrap
28173msgid "*nojoliet*"
28174msgstr ""
28175
28176#. type: Plain text
28177#: ../sys-utils/mount.8.adoc:903
28178msgid ""
28179"Disable the use of Microsoft Joliet extensions, even if "
28180"available. Cf. *map*."
28181msgstr ""
28182
28183#. type: Labeled list
28184#: ../sys-utils/mount.8.adoc:904
28185#, no-wrap
28186msgid "*check=*{*r*[*elaxed*]|*s*[*trict*]}"
28187msgstr ""
28188
28189#. type: Plain text
28190#: ../sys-utils/mount.8.adoc:906
28191msgid ""
28192"With *check=relaxed*, a filename is first converted to lower case before "
28193"doing the lookup. This is probably only meaningful together with *norock* "
28194"and *map=normal*. (Default: *check=strict*.)"
28195msgstr ""
28196
28197#. type: Plain text
28198#: ../sys-utils/mount.8.adoc:909
28199msgid ""
28200"Give all files in the filesystem the indicated user or group id, possibly "
28201"overriding the information found in the Rock Ridge extensions. (Default: "
28202"*uid=0,gid=0*.)"
28203msgstr ""
28204
28205#. type: Labeled list
28206#: ../sys-utils/mount.8.adoc:910
28207#, no-wrap
28208msgid "*map=*{*n*[*ormal*]|*o*[*ff*]|*a*[*corn*]}"
28209msgstr ""
28210
28211#. type: Plain text
28212#: ../sys-utils/mount.8.adoc:912
28213msgid ""
28214"For non-Rock Ridge volumes, normal name translation maps upper to lower case "
28215"ASCII, drops a trailing ';1', and converts ';' to '.'. With *map=off* no "
28216"name translation is done. See *norock*. (Default: *map=normal*.) *map=acorn* "
28217"is like *map=normal* but also apply Acorn extensions if present."
28218msgstr ""
28219
28220#. type: Plain text
28221#: ../sys-utils/mount.8.adoc:915
28222msgid ""
28223"For non-Rock Ridge volumes, give all files the indicated mode. (Default: "
28224"read and execute permission for everybody.) Octal mode values require a "
28225"leading 0."
28226msgstr ""
28227
28228#. type: Labeled list
28229#: ../sys-utils/mount.8.adoc:916 ../sys-utils/mount.8.adoc:1128
28230#, no-wrap
28231msgid "*unhide*"
28232msgstr ""
28233
28234#. type: Plain text
28235#: ../sys-utils/mount.8.adoc:918
28236msgid ""
28237"Also show hidden and associated files. (If the ordinary files and the "
28238"associated or hidden files have the same filenames, this may make the "
28239"ordinary files inaccessible.)"
28240msgstr ""
28241
28242#. type: Labeled list
28243#: ../sys-utils/mount.8.adoc:919
28244#, no-wrap
28245msgid "*block=*{**512**|**1024**|*2048*}"
28246msgstr ""
28247
28248#. type: Plain text
28249#: ../sys-utils/mount.8.adoc:921
28250msgid "Set the block size to the indicated value. (Default: *block=1024*.)"
28251msgstr ""
28252
28253#. type: Labeled list
28254#: ../sys-utils/mount.8.adoc:925
28255#, no-wrap
28256msgid "*cruft*"
28257msgstr ""
28258
28259#. type: Plain text
28260#: ../sys-utils/mount.8.adoc:927
28261msgid ""
28262"If the high byte of the file length contains other garbage, set this mount "
28263"option to ignore the high order bits of the file length. This implies that a "
9b7051d5 28264"file cannot be larger than 16 MB."
36e96905
MB
28265msgstr ""
28266
28267#. type: Labeled list
28268#: ../sys-utils/mount.8.adoc:928
28269#, no-wrap
28270msgid "**session=**__x__"
28271msgstr ""
28272
28273#. type: Plain text
28274#: ../sys-utils/mount.8.adoc:930
28275msgid "Select number of session on a multisession CD."
28276msgstr ""
28277
28278#. type: Labeled list
28279#: ../sys-utils/mount.8.adoc:931
28280#, no-wrap
28281msgid "**sbsector=**__xxx__"
28282msgstr ""
28283
28284#. type: Plain text
28285#: ../sys-utils/mount.8.adoc:933
28286msgid "Session begins from sector xxx."
28287msgstr ""
28288
28289#. type: Plain text
28290#: ../sys-utils/mount.8.adoc:935
28291msgid ""
28292"The following options are the same as for vfat and specifying them only "
28293"makes sense when using discs encoded using Microsoft's Joliet extensions."
28294msgstr ""
28295
28296#. type: Plain text
28297#: ../sys-utils/mount.8.adoc:938
28298msgid ""
28299"Character set to use for converting 16 bit Unicode characters on CD to 8 bit "
28300"characters. The default is iso8859-1."
28301msgstr ""
28302
28303#. type: Labeled list
28304#: ../sys-utils/mount.8.adoc:939 ../sys-utils/mount.8.adoc:978
28305#: ../sys-utils/mount.8.adoc:1152 ../sys-utils/mount.8.adoc:1250
28306#, no-wrap
28307msgid "*utf8*"
28308msgstr ""
28309
28310#. type: Plain text
28311#: ../sys-utils/mount.8.adoc:941
28312msgid "Convert 16 bit Unicode characters on CD to UTF-8."
28313msgstr ""
28314
28315#. type: Title ===
28316#: ../sys-utils/mount.8.adoc:942
28317#, no-wrap
28318msgid "Mount options for jfs"
28319msgstr ""
28320
28321#. type: Labeled list
28322#: ../sys-utils/mount.8.adoc:944 ../sys-utils/mount.8.adoc:972
28323#, no-wrap
28324msgid "**iocharset=**__name__"
28325msgstr ""
28326
28327#. type: Plain text
28328#: ../sys-utils/mount.8.adoc:946
28329msgid ""
28330"Character set to use for converting from Unicode to ASCII. The default is to "
28331"do no conversion. Use *iocharset=utf8* for UTF8 translations. This requires "
28332"*CONFIG_NLS_UTF8* to be set in the kernel _.config_ file."
28333msgstr ""
28334
28335#. type: Labeled list
28336#: ../sys-utils/mount.8.adoc:947
28337#, no-wrap
28338msgid "**resize=**__value__"
28339msgstr ""
28340
28341#. type: Plain text
28342#: ../sys-utils/mount.8.adoc:949
28343msgid ""
28344"Resize the volume to _value_ blocks. JFS only supports growing a volume, not "
28345"shrinking it. This option is only valid during a remount, when the volume is "
28346"mounted read-write. The *resize* keyword with no value will grow the volume "
28347"to the full size of the partition."
28348msgstr ""
28349
28350#. type: Labeled list
28351#: ../sys-utils/mount.8.adoc:950
28352#, no-wrap
28353msgid "*nointegrity*"
28354msgstr ""
28355
28356#. type: Plain text
28357#: ../sys-utils/mount.8.adoc:952
28358msgid ""
28359"Do not write to the journal. The primary use of this option is to allow for "
28360"higher performance when restoring a volume from backup media. The integrity "
28361"of the volume is not guaranteed if the system abnormally ends."
28362msgstr ""
28363
28364#. type: Labeled list
28365#: ../sys-utils/mount.8.adoc:953
28366#, no-wrap
28367msgid "*integrity*"
28368msgstr ""
28369
28370#. type: Plain text
28371#: ../sys-utils/mount.8.adoc:955
28372msgid ""
28373"Default. Commit metadata changes to the journal. Use this option to remount "
28374"a volume where the *nointegrity* option was previously specified in order to "
28375"restore normal behavior."
28376msgstr ""
28377
28378#. type: Labeled list
28379#: ../sys-utils/mount.8.adoc:956
28380#, no-wrap
28381msgid "*errors=*{**continue**|**remount-ro**|*panic*}"
28382msgstr ""
28383
28384#. type: Plain text
28385#: ../sys-utils/mount.8.adoc:958
28386msgid ""
28387"Define the behavior when an error is encountered. (Either ignore errors and "
28388"just mark the filesystem erroneous and continue, or remount the filesystem "
28389"read-only, or panic and halt the system.)"
28390msgstr ""
28391
28392#. type: Labeled list
28393#: ../sys-utils/mount.8.adoc:959
28394#, no-wrap
28395msgid "**noquota**|**quota**|**usrquota**|*grpquota*"
28396msgstr ""
28397
28398#. type: Plain text
28399#: ../sys-utils/mount.8.adoc:961
28400msgid "These options are accepted but ignored."
28401msgstr ""
28402
28403#. type: Title ===
28404#: ../sys-utils/mount.8.adoc:962
28405#, no-wrap
28406msgid "Mount options for msdos"
28407msgstr ""
28408
28409#. type: Plain text
28410#: ../sys-utils/mount.8.adoc:965
28411msgid ""
28412"See mount options for fat. If the _msdos_ filesystem detects an "
28413"inconsistency, it reports an error and sets the file system read-only. The "
28414"filesystem can be made writable again by remounting it."
28415msgstr ""
28416
28417#. type: Title ===
28418#: ../sys-utils/mount.8.adoc:966
28419#, no-wrap
28420msgid "Mount options for ncpfs"
28421msgstr ""
28422
28423#. type: Plain text
28424#: ../sys-utils/mount.8.adoc:969
28425msgid ""
28426"Just like _nfs_, the _ncpfs_ implementation expects a binary argument (a "
28427"_struct ncp_mount_data_) to the mount system call. This argument is "
28428"constructed by *ncpmount*(8) and the current version of *mount* (2.12) does "
28429"not know anything about ncpfs."
28430msgstr ""
28431
28432#. type: Title ===
28433#: ../sys-utils/mount.8.adoc:970
28434#, no-wrap
28435msgid "Mount options for ntfs"
28436msgstr ""
28437
28438#. type: Plain text
28439#: ../sys-utils/mount.8.adoc:974
28440msgid ""
28441"Character set to use when returning file names. Unlike VFAT, NTFS suppresses "
28442"names that contain nonconvertible characters. Deprecated."
28443msgstr ""
28444
28445#. type: Labeled list
28446#: ../sys-utils/mount.8.adoc:975
28447#, no-wrap
28448msgid "**nls=**__name__"
28449msgstr ""
28450
28451#. type: Plain text
28452#: ../sys-utils/mount.8.adoc:977
28453msgid "New name for the option earlier called _iocharset_."
28454msgstr ""
28455
28456#. type: Plain text
28457#: ../sys-utils/mount.8.adoc:980
28458msgid "Use UTF-8 for converting file names."
28459msgstr ""
28460
28461#. type: Labeled list
28462#: ../sys-utils/mount.8.adoc:981
28463#, no-wrap
28464msgid "*uni_xlate=*{**0**|**1**|*2*}"
28465msgstr ""
28466
28467#. type: Plain text
28468#: ../sys-utils/mount.8.adoc:983
28469msgid ""
28470"For 0 (or 'no' or 'false'), do not use escape sequences for unknown Unicode "
28471"characters. For 1 (or 'yes' or 'true') or 2, use vfat-style 4-byte escape "
28472"sequences starting with \":\". Here 2 gives a little-endian encoding and 1 a "
28473"byteswapped bigendian encoding."
28474msgstr ""
28475
28476#. type: Labeled list
28477#: ../sys-utils/mount.8.adoc:984
28478#, no-wrap
28479msgid "*posix=[0|1]*"
28480msgstr ""
28481
28482#. type: Plain text
28483#: ../sys-utils/mount.8.adoc:986
28484msgid ""
28485"If enabled (posix=1), the filesystem distinguishes between upper and lower "
28486"case. The 8.3 alias names are presented as hard links instead of being "
28487"suppressed. This option is obsolete."
28488msgstr ""
28489
28490#. type: Labeled list
28491#: ../sys-utils/mount.8.adoc:987
28492#, no-wrap
28493msgid "**uid=**__value__, **gid=**__value__ and **umask=**__value__"
28494msgstr ""
28495
28496#. type: Plain text
28497#: ../sys-utils/mount.8.adoc:989
28498msgid ""
28499"Set the file permission on the filesystem. The umask value is given in "
28500"octal. By default, the files are owned by root and not readable by somebody "
28501"else."
28502msgstr ""
28503
28504#. type: Title ===
28505#: ../sys-utils/mount.8.adoc:990
28506#, no-wrap
28507msgid "Mount options for overlay"
28508msgstr ""
28509
28510#. type: Plain text
28511#: ../sys-utils/mount.8.adoc:993
28512msgid ""
28513"Since Linux 3.18 the overlay pseudo filesystem implements a union mount for "
28514"other filesystems."
28515msgstr ""
28516
28517#. type: Plain text
28518#: ../sys-utils/mount.8.adoc:995
28519msgid ""
28520"An overlay filesystem combines two filesystems - an *upper* filesystem and a "
28521"*lower* filesystem. When a name exists in both filesystems, the object in "
28522"the upper filesystem is visible while the object in the lower filesystem is "
28523"either hidden or, in the case of directories, merged with the upper object."
28524msgstr ""
28525
28526#. type: Plain text
28527#: ../sys-utils/mount.8.adoc:997
28528msgid ""
28529"The lower filesystem can be any filesystem supported by Linux and does not "
28530"need to be writable. The lower filesystem can even be another overlayfs. The "
28531"upper filesystem will normally be writable and if it is it must support the "
28532"creation of trusted.* extended attributes, and must provide a valid d_type "
28533"in readdir responses, so NFS is not suitable."
28534msgstr ""
28535
28536#. type: Plain text
28537#: ../sys-utils/mount.8.adoc:999
28538msgid ""
28539"A read-only overlay of two read-only filesystems may use any filesystem "
28540"type. The options *lowerdir* and *upperdir* are combined into a merged "
28541"directory by using:"
28542msgstr ""
28543
28544#. type: delimited block .
28545#: ../sys-utils/mount.8.adoc:1004
28546#, no-wrap
28547msgid ""
28548"mount -t overlay overlay \\\n"
28549" -olowerdir=/lower,upperdir=/upper,workdir=/work /merged\n"
28550msgstr ""
28551
28552#. type: Labeled list
28553#: ../sys-utils/mount.8.adoc:1007
28554#, no-wrap
28555msgid "**lowerdir=**__directory__"
28556msgstr ""
28557
28558#. type: delimited block _
28559#: ../sys-utils/mount.8.adoc:1009
28560msgid "Any filesystem, does not need to be on a writable filesystem."
28561msgstr ""
28562
28563#. type: Labeled list
28564#: ../sys-utils/mount.8.adoc:1010
28565#, no-wrap
28566msgid "**upperdir=**__directory__"
28567msgstr ""
28568
28569#. type: delimited block _
28570#: ../sys-utils/mount.8.adoc:1012
28571msgid "The upperdir is normally on a writable filesystem."
28572msgstr ""
28573
28574#. type: Labeled list
28575#: ../sys-utils/mount.8.adoc:1013
28576#, no-wrap
28577msgid "**workdir=**__directory__"
28578msgstr ""
28579
28580#. type: delimited block _
28581#: ../sys-utils/mount.8.adoc:1015
28582msgid ""
28583"The workdir needs to be an empty directory on the same filesystem as "
28584"upperdir."
28585msgstr ""
28586
28587#. type: Title ===
28588#: ../sys-utils/mount.8.adoc:1016
28589#, no-wrap
28590msgid "Mount options for reiserfs"
28591msgstr ""
28592
28593#. type: delimited block _
28594#: ../sys-utils/mount.8.adoc:1019
28595msgid "Reiserfs is a journaling filesystem."
28596msgstr ""
28597
28598#. type: Labeled list
28599#: ../sys-utils/mount.8.adoc:1020
28600#, no-wrap
28601msgid "*conv*"
28602msgstr ""
28603
28604#. type: delimited block _
28605#: ../sys-utils/mount.8.adoc:1022
28606msgid ""
28607"Instructs version 3.6 reiserfs software to mount a version 3.5 filesystem, "
28608"using the 3.6 format for newly created objects. This filesystem will no "
28609"longer be compatible with reiserfs 3.5 tools."
28610msgstr ""
28611
28612#. type: Labeled list
28613#: ../sys-utils/mount.8.adoc:1023
28614#, no-wrap
28615msgid "*hash=*{**rupasov**|**tea**|**r5**|*detect*}"
28616msgstr ""
28617
28618#. type: delimited block _
28619#: ../sys-utils/mount.8.adoc:1025
28620msgid ""
28621"Choose which hash function reiserfs will use to find files within "
28622"directories."
28623msgstr ""
28624
28625#. type: Labeled list
28626#: ../sys-utils/mount.8.adoc:1026
28627#, no-wrap
28628msgid "*rupasov*"
28629msgstr ""
28630
28631#. type: delimited block _
28632#: ../sys-utils/mount.8.adoc:1028
28633msgid ""
28634"A hash invented by Yury Yu. Rupasov. It is fast and preserves locality, "
28635"mapping lexicographically close file names to close hash values. This option "
28636"should not be used, as it causes a high probability of hash collisions."
28637msgstr ""
28638
28639#. type: Labeled list
28640#: ../sys-utils/mount.8.adoc:1029
28641#, no-wrap
28642msgid "*tea*"
28643msgstr ""
28644
28645#. type: delimited block _
28646#: ../sys-utils/mount.8.adoc:1031
28647msgid ""
28648"A Davis-Meyer function implemented by Jeremy Fitzhardinge. It uses hash "
28649"permuting bits in the name. It gets high randomness and, therefore, low "
28650"probability of hash collisions at some CPU cost. This may be used if "
28651"*EHASHCOLLISION* errors are experienced with the r5 hash."
28652msgstr ""
28653
28654#. type: Labeled list
28655#: ../sys-utils/mount.8.adoc:1032
28656#, no-wrap
28657msgid "*r5*"
28658msgstr ""
28659
28660#. type: delimited block _
28661#: ../sys-utils/mount.8.adoc:1034
28662msgid ""
28663"A modified version of the rupasov hash. It is used by default and is the "
28664"best choice unless the filesystem has huge directories and unusual file-name "
28665"patterns."
28666msgstr ""
28667
28668#. type: Labeled list
28669#: ../sys-utils/mount.8.adoc:1035
28670#, no-wrap
28671msgid "*detect*"
28672msgstr ""
28673
28674#. type: delimited block _
28675#: ../sys-utils/mount.8.adoc:1037
28676msgid ""
28677"Instructs *mount* to detect which hash function is in use by examining the "
28678"filesystem being mounted, and to write this information into the reiserfs "
28679"superblock. This is only useful on the first mount of an old format "
28680"filesystem."
28681msgstr ""
28682
28683#. type: Labeled list
28684#: ../sys-utils/mount.8.adoc:1038
28685#, no-wrap
28686msgid "*hashed_relocation*"
28687msgstr ""
28688
28689#. type: delimited block _
28690#: ../sys-utils/mount.8.adoc:1040 ../sys-utils/mount.8.adoc:1043
28691msgid ""
28692"Tunes the block allocator. This may provide performance improvements in some "
28693"situations."
28694msgstr ""
28695
28696#. type: Labeled list
28697#: ../sys-utils/mount.8.adoc:1041
28698#, no-wrap
28699msgid "*no_unhashed_relocation*"
28700msgstr ""
28701
28702#. type: Labeled list
28703#: ../sys-utils/mount.8.adoc:1044
28704#, no-wrap
28705msgid "*noborder*"
28706msgstr ""
28707
28708#. type: delimited block _
28709#: ../sys-utils/mount.8.adoc:1046
28710msgid ""
28711"Disable the border allocator algorithm invented by Yury Yu. Rupasov. This "
28712"may provide performance improvements in some situations."
28713msgstr ""
28714
28715#. type: Labeled list
28716#: ../sys-utils/mount.8.adoc:1047
28717#, no-wrap
28718msgid "*nolog*"
28719msgstr ""
28720
28721#. type: delimited block _
28722#: ../sys-utils/mount.8.adoc:1049
28723msgid ""
28724"Disable journaling. This will provide slight performance improvements in "
28725"some situations at the cost of losing reiserfs's fast recovery from "
28726"crashes. Even with this option turned on, reiserfs still performs all "
28727"journaling operations, save for actual writes into its journaling "
28728"area. Implementation of _nolog_ is a work in progress."
28729msgstr ""
28730
28731#. type: Labeled list
28732#: ../sys-utils/mount.8.adoc:1050
28733#, no-wrap
28734msgid "*notail*"
28735msgstr ""
28736
28737#. type: delimited block _
28738#: ../sys-utils/mount.8.adoc:1052
28739msgid ""
28740"By default, reiserfs stores small files and 'file tails' directly into its "
28741"tree. This confuses some utilities such as *lilo*(8). This option is used to "
28742"disable packing of files into the tree."
28743msgstr ""
28744
28745#. type: Labeled list
28746#: ../sys-utils/mount.8.adoc:1053
28747#, no-wrap
28748msgid "*replayonly*"
28749msgstr ""
28750
28751#. type: delimited block _
28752#: ../sys-utils/mount.8.adoc:1055
28753msgid ""
28754"Replay the transactions which are in the journal, but do not actually mount "
28755"the filesystem. Mainly used by _reiserfsck_."
28756msgstr ""
28757
28758#. type: Labeled list
28759#: ../sys-utils/mount.8.adoc:1056
28760#, no-wrap
28761msgid "**resize=**__number__"
28762msgstr ""
28763
28764#. type: delimited block _
28765#: ../sys-utils/mount.8.adoc:1058
28766msgid ""
28767"A remount option which permits online expansion of reiserfs "
28768"partitions. Instructs reiserfs to assume that the device has _number_ "
28769"blocks. This option is designed for use with devices which are under logical "
28770"volume management (LVM). There is a special _resizer_ utility which can be "
28771"obtained from _ftp://ftp.namesys.com/pub/reiserfsprogs_."
28772msgstr ""
28773
28774#. type: Labeled list
28775#: ../sys-utils/mount.8.adoc:1059
28776#, no-wrap
28777msgid "*user_xattr*"
28778msgstr ""
28779
28780#. type: delimited block _
28781#: ../sys-utils/mount.8.adoc:1061
28782msgid "Enable Extended User Attributes. See the *attr*(1) manual page."
28783msgstr ""
28784
28785#. type: Labeled list
28786#: ../sys-utils/mount.8.adoc:1062
28787#, no-wrap
28788msgid "*acl*"
28789msgstr ""
28790
28791#. type: delimited block _
28792#: ../sys-utils/mount.8.adoc:1064
28793msgid "Enable POSIX Access Control Lists. See the *acl*(5) manual page."
28794msgstr ""
28795
28796#. type: Labeled list
28797#: ../sys-utils/mount.8.adoc:1065
28798#, no-wrap
28799msgid "*barrier=none* / *barrier=flush*"
28800msgstr ""
28801
28802#. type: delimited block _
28803#: ../sys-utils/mount.8.adoc:1067
28804msgid ""
28805"This disables / enables the use of write barriers in the journaling "
28806"code. *barrier=none* disables, *barrier=flush* enables (default). This also "
28807"requires an IO stack which can support barriers, and if reiserfs gets an "
28808"error on a barrier write, it will disable barriers again with a "
28809"warning. Write barriers enforce proper on-disk ordering of journal commits, "
28810"making volatile disk write caches safe to use, at some performance "
28811"penalty. If your disks are battery-backed in one way or another, disabling "
28812"barriers may safely improve performance."
28813msgstr ""
28814
28815#. type: Title ===
28816#: ../sys-utils/mount.8.adoc:1068
28817#, no-wrap
28818msgid "Mount options for ubifs"
28819msgstr ""
28820
28821#. type: delimited block _
28822#: ../sys-utils/mount.8.adoc:1071
28823msgid ""
28824"UBIFS is a flash filesystem which works on top of UBI volumes. Note that "
28825"*atime* is not supported and is always turned off."
28826msgstr ""
28827
28828#. type: delimited block _
28829#: ../sys-utils/mount.8.adoc:1073
28830msgid "The device name may be specified as"
28831msgstr ""
28832
28833#. type: Labeled list
28834#: ../sys-utils/mount.8.adoc:1075
28835#, no-wrap
28836msgid "*ubiX_Y*"
28837msgstr ""
28838
28839#. type: Plain text
28840#: ../sys-utils/mount.8.adoc:1077
28841msgid "UBI device number *X*, volume number *Y*"
28842msgstr ""
28843
28844#. type: Labeled list
28845#: ../sys-utils/mount.8.adoc:1077
28846#, no-wrap
28847msgid "*ubiY*"
28848msgstr ""
28849
28850#. type: Plain text
28851#: ../sys-utils/mount.8.adoc:1079
28852msgid "UBI device number *0*, volume number *Y*"
28853msgstr ""
28854
28855#. type: Labeled list
28856#: ../sys-utils/mount.8.adoc:1079
28857#, no-wrap
28858msgid "*ubiX:NAME*"
28859msgstr ""
28860
28861#. type: Plain text
28862#: ../sys-utils/mount.8.adoc:1081
28863msgid "UBI device number *X*, volume with name *NAME*"
28864msgstr ""
28865
28866#. type: Labeled list
28867#: ../sys-utils/mount.8.adoc:1081
28868#, no-wrap
28869msgid "*ubi:NAME*"
28870msgstr ""
28871
28872#. type: Plain text
28873#: ../sys-utils/mount.8.adoc:1083
28874msgid "UBI device number *0*, volume with name *NAME*"
28875msgstr ""
28876
28877#. type: delimited block _
28878#: ../sys-utils/mount.8.adoc:1086
28879msgid "Alternative *!* separator may be used instead of *:*."
28880msgstr ""
28881
28882#. type: delimited block _
28883#: ../sys-utils/mount.8.adoc:1088
28884msgid "The following mount options are available:"
28885msgstr ""
28886
28887#. type: Labeled list
28888#: ../sys-utils/mount.8.adoc:1089
28889#, no-wrap
28890msgid "*bulk_read*"
28891msgstr ""
28892
28893#. type: delimited block _
28894#: ../sys-utils/mount.8.adoc:1091
28895msgid ""
28896"Enable bulk-read. VFS read-ahead is disabled because it slows down the "
28897"filesystem. Bulk-Read is an internal optimization. Some flashes may read "
28898"faster if the data are read at one go, rather than at several read "
28899"requests. For example, OneNAND can do \"read-while-load\" if it reads more "
28900"than one NAND page."
28901msgstr ""
28902
28903#. type: Labeled list
28904#: ../sys-utils/mount.8.adoc:1092
28905#, no-wrap
28906msgid "*no_bulk_read*"
28907msgstr ""
28908
28909#. type: delimited block _
28910#: ../sys-utils/mount.8.adoc:1094
28911msgid "Do not bulk-read. This is the default."
28912msgstr ""
28913
28914#. type: Labeled list
28915#: ../sys-utils/mount.8.adoc:1095
28916#, no-wrap
28917msgid "*chk_data_crc*"
28918msgstr ""
28919
28920#. type: delimited block _
28921#: ../sys-utils/mount.8.adoc:1097
28922msgid "Check data CRC-32 checksums. This is the default."
28923msgstr ""
28924
28925#. type: Labeled list
28926#: ../sys-utils/mount.8.adoc:1098
28927#, no-wrap
28928msgid "*no_chk_data_crc*"
28929msgstr ""
28930
28931#. type: delimited block _
28932#: ../sys-utils/mount.8.adoc:1100
28933msgid ""
28934"Do not check data CRC-32 checksums. With this option, the filesystem does "
28935"not check CRC-32 checksum for data, but it does check it for the internal "
28936"indexing information. This option only affects reading, not writing. CRC-32 "
28937"is always calculated when writing the data."
28938msgstr ""
28939
28940#. type: Labeled list
28941#: ../sys-utils/mount.8.adoc:1101
28942#, no-wrap
28943msgid "*compr=*{**none**|**lzo**|*zlib*}"
28944msgstr ""
28945
28946#. type: delimited block _
28947#: ../sys-utils/mount.8.adoc:1103
28948msgid ""
28949"Select the default compressor which is used when new files are written. It "
28950"is still possible to read compressed files if mounted with the *none* "
28951"option."
28952msgstr ""
28953
28954#. type: Title ===
28955#: ../sys-utils/mount.8.adoc:1104
28956#, no-wrap
28957msgid "Mount options for udf"
28958msgstr ""
28959
28960#. type: delimited block _
28961#: ../sys-utils/mount.8.adoc:1107
28962msgid ""
28963"UDF is the \"Universal Disk Format\" filesystem defined by OSTA, the Optical "
28964"Storage Technology Association, and is often used for DVD-ROM, frequently in "
28965"the form of a hybrid UDF/ISO-9660 filesystem. It is, however, perfectly "
28966"usable by itself on disk drives, flash drives and other block devices. See "
28967"also _iso9660_."
28968msgstr ""
28969
28970#. type: Labeled list
28971#: ../sys-utils/mount.8.adoc:1108
28972#, no-wrap
28973msgid "*uid=*"
28974msgstr ""
28975
28976#. type: delimited block _
28977#: ../sys-utils/mount.8.adoc:1110
28978msgid ""
28979"Make all files in the filesystem belong to the given user. uid=forget can be "
28980"specified independently of (or usually in addition to) uid=<user> and "
28981"results in UDF not storing uids to the media. In fact the recorded uid is "
28982"the 32-bit overflow uid -1 as defined by the UDF standard. The value is "
28983"given as either <user> which is a valid user name or the corresponding "
28984"decimal user id, or the special string \"forget\"."
28985msgstr ""
28986
28987#. type: Labeled list
28988#: ../sys-utils/mount.8.adoc:1111
28989#, no-wrap
28990msgid "*gid=*"
28991msgstr ""
28992
28993#. type: delimited block _
28994#: ../sys-utils/mount.8.adoc:1113
28995msgid ""
28996"Make all files in the filesystem belong to the given group. gid=forget can "
28997"be specified independently of (or usually in addition to) gid=<group> and "
28998"results in UDF not storing gids to the media. In fact the recorded gid is "
28999"the 32-bit overflow gid -1 as defined by the UDF standard. The value is "
29000"given as either <group> which is a valid group name or the corresponding "
29001"decimal group id, or the special string \"forget\"."
29002msgstr ""
29003
29004#. type: Labeled list
29005#: ../sys-utils/mount.8.adoc:1114
29006#, no-wrap
29007msgid "*umask=*"
29008msgstr ""
29009
29010#. type: delimited block _
29011#: ../sys-utils/mount.8.adoc:1116
29012msgid ""
29013"Mask out the given permissions from all inodes read from the filesystem. The "
29014"value is given in octal."
29015msgstr ""
29016
29017#. type: Labeled list
29018#: ../sys-utils/mount.8.adoc:1117
29019#, no-wrap
29020msgid "*mode=*"
29021msgstr ""
29022
29023#. type: delimited block _
29024#: ../sys-utils/mount.8.adoc:1119
29025msgid ""
29026"If *mode=* is set the permissions of all non-directory inodes read from the "
29027"filesystem will be set to the given mode. The value is given in octal."
29028msgstr ""
29029
29030#. type: Labeled list
29031#: ../sys-utils/mount.8.adoc:1120
29032#, no-wrap
29033msgid "*dmode=*"
29034msgstr ""
29035
29036#. type: delimited block _
29037#: ../sys-utils/mount.8.adoc:1122
29038msgid ""
29039"If *dmode=* is set the permissions of all directory inodes read from the "
29040"filesystem will be set to the given dmode. The value is given in octal."
29041msgstr ""
29042
29043#. type: Labeled list
29044#: ../sys-utils/mount.8.adoc:1123
29045#, no-wrap
29046msgid "*bs=*"
29047msgstr ""
29048
29049#. type: delimited block _
29050#: ../sys-utils/mount.8.adoc:1125
29051msgid ""
29052"Set the block size. Default value prior to kernel version 2.6.30 was "
29053"2048. Since 2.6.30 and prior to 4.11 it was logical device block size with "
29054"fallback to 2048. Since 4.11 it is logical block size with fallback to any "
29055"valid block size between logical device block size and 4096."
29056msgstr ""
29057
29058#. type: delimited block _
29059#: ../sys-utils/mount.8.adoc:1127
29060msgid ""
29061"For other details see the *mkudffs*(8) 2.0+ manpage, sections "
29062"*COMPATIBILITY* and *BLOCK SIZE*."
29063msgstr ""
29064
29065#. type: delimited block _
29066#: ../sys-utils/mount.8.adoc:1130
29067msgid "Show otherwise hidden files."
29068msgstr ""
29069
29070#. type: Labeled list
29071#: ../sys-utils/mount.8.adoc:1131
29072#, no-wrap
29073msgid "*undelete*"
29074msgstr ""
29075
29076#. type: delimited block _
29077#: ../sys-utils/mount.8.adoc:1133
29078msgid "Show deleted files in lists."
29079msgstr ""
29080
29081#. type: Labeled list
29082#: ../sys-utils/mount.8.adoc:1134
29083#, no-wrap
29084msgid "*adinicb*"
29085msgstr ""
29086
29087#. type: delimited block _
29088#: ../sys-utils/mount.8.adoc:1136
29089msgid "Embed data in the inode. (default)"
29090msgstr ""
29091
29092#. type: Labeled list
29093#: ../sys-utils/mount.8.adoc:1137
29094#, no-wrap
29095msgid "*noadinicb*"
29096msgstr ""
29097
29098#. type: delimited block _
29099#: ../sys-utils/mount.8.adoc:1139
29100msgid "Don't embed data in the inode."
29101msgstr ""
29102
29103#. type: Labeled list
29104#: ../sys-utils/mount.8.adoc:1140
29105#, no-wrap
29106msgid "*shortad*"
29107msgstr ""
29108
29109#. type: delimited block _
29110#: ../sys-utils/mount.8.adoc:1142
29111msgid "Use short UDF address descriptors."
29112msgstr ""
29113
29114#. type: Labeled list
29115#: ../sys-utils/mount.8.adoc:1143
29116#, no-wrap
29117msgid "*longad*"
29118msgstr ""
29119
29120#. type: delimited block _
29121#: ../sys-utils/mount.8.adoc:1145
29122msgid "Use long UDF address descriptors. (default)"
29123msgstr ""
29124
29125#. type: Labeled list
29126#: ../sys-utils/mount.8.adoc:1146
29127#, no-wrap
29128msgid "*nostrict*"
29129msgstr ""
29130
29131#. type: delimited block _
29132#: ../sys-utils/mount.8.adoc:1148
29133msgid "Unset strict conformance."
29134msgstr ""
29135
29136#. type: Labeled list
29137#: ../sys-utils/mount.8.adoc:1149
29138#, no-wrap
29139msgid "*iocharset=*"
29140msgstr ""
29141
29142#. type: delimited block _
29143#: ../sys-utils/mount.8.adoc:1151
29144msgid ""
29145"Set the NLS character set. This requires kernel compiled with "
29146"*CONFIG_UDF_NLS* option."
29147msgstr ""
29148
29149#. type: delimited block _
29150#: ../sys-utils/mount.8.adoc:1154
29151msgid "Set the UTF-8 character set."
29152msgstr ""
29153
29154#. type: Title ===
29155#: ../sys-utils/mount.8.adoc:1155
29156#, no-wrap
29157msgid "Mount options for debugging and disaster recovery"
29158msgstr ""
29159
29160#. type: Labeled list
29161#: ../sys-utils/mount.8.adoc:1157
29162#, no-wrap
29163msgid "*novrs*"
29164msgstr ""
29165
29166#. type: delimited block _
29167#: ../sys-utils/mount.8.adoc:1159
29168msgid "Ignore the Volume Recognition Sequence and attempt to mount anyway."
29169msgstr ""
29170
29171#. type: Labeled list
29172#: ../sys-utils/mount.8.adoc:1160
29173#, no-wrap
29174msgid "*session=*"
29175msgstr ""
29176
29177#. type: delimited block _
29178#: ../sys-utils/mount.8.adoc:1162
29179msgid ""
29180"Select the session number for multi-session recorded optical "
29181"media. (default= last session)"
29182msgstr ""
29183
29184#. type: Labeled list
29185#: ../sys-utils/mount.8.adoc:1163
29186#, no-wrap
29187msgid "*anchor=*"
29188msgstr ""
29189
29190#. type: delimited block _
29191#: ../sys-utils/mount.8.adoc:1165
29192msgid "Override standard anchor location. (default= 256)"
29193msgstr ""
29194
29195#. type: Labeled list
29196#: ../sys-utils/mount.8.adoc:1166
29197#, no-wrap
29198msgid "*lastblock=*"
29199msgstr ""
29200
29201#. type: delimited block _
29202#: ../sys-utils/mount.8.adoc:1168
29203msgid "Set the last block of the filesystem."
29204msgstr ""
29205
29206#. type: Title ===
29207#: ../sys-utils/mount.8.adoc:1169
29208#, no-wrap
29209msgid ""
29210"Unused historical mount options that may be encountered and should be "
29211"removed"
29212msgstr ""
29213
29214#. type: Labeled list
29215#: ../sys-utils/mount.8.adoc:1171
29216#, no-wrap
29217msgid "*uid=ignore*"
29218msgstr ""
29219
29220#. type: delimited block _
29221#: ../sys-utils/mount.8.adoc:1173
29222msgid "Ignored, use uid=<user> instead."
29223msgstr ""
29224
29225#. type: Labeled list
29226#: ../sys-utils/mount.8.adoc:1174
29227#, no-wrap
29228msgid "*gid=ignore*"
29229msgstr ""
29230
29231#. type: delimited block _
29232#: ../sys-utils/mount.8.adoc:1176
29233msgid "Ignored, use gid=<group> instead."
29234msgstr ""
29235
29236#. type: Labeled list
29237#: ../sys-utils/mount.8.adoc:1177
29238#, no-wrap
29239msgid "*volume=*"
29240msgstr ""
29241
29242#. type: delimited block _
29243#: ../sys-utils/mount.8.adoc:1179 ../sys-utils/mount.8.adoc:1182
29244#: ../sys-utils/mount.8.adoc:1185 ../sys-utils/mount.8.adoc:1188
29245msgid "Unimplemented and ignored."
29246msgstr ""
29247
29248#. type: Labeled list
29249#: ../sys-utils/mount.8.adoc:1180
29250#, no-wrap
29251msgid "*partition=*"
29252msgstr ""
29253
29254#. type: Labeled list
29255#: ../sys-utils/mount.8.adoc:1183
29256#, no-wrap
29257msgid "*fileset=*"
29258msgstr ""
29259
29260#. type: Labeled list
29261#: ../sys-utils/mount.8.adoc:1186
29262#, no-wrap
29263msgid "*rootdir=*"
29264msgstr ""
29265
29266#. type: Title ===
29267#: ../sys-utils/mount.8.adoc:1189
29268#, no-wrap
29269msgid "Mount options for ufs"
29270msgstr ""
29271
29272#. type: Labeled list
29273#: ../sys-utils/mount.8.adoc:1191
29274#, no-wrap
29275msgid "**ufstype=**__value__"
29276msgstr ""
29277
29278#. type: delimited block _
29279#: ../sys-utils/mount.8.adoc:1193
29280msgid ""
29281"UFS is a filesystem widely used in different operating systems. The problem "
29282"are differences among implementations. Features of some implementations are "
29283"undocumented, so its hard to recognize the type of ufs automatically. That's "
29284"why the user must specify the type of ufs by mount option. Possible values "
29285"are:"
29286msgstr ""
29287
29288#. type: Labeled list
29289#: ../sys-utils/mount.8.adoc:1194
29290#, no-wrap
29291msgid "*old*"
29292msgstr ""
29293
29294#. type: delimited block _
29295#: ../sys-utils/mount.8.adoc:1196
29296msgid ""
29297"Old format of ufs, this is the default, read only. (Don't forget to give the "
29298"*-r* option.)"
29299msgstr ""
29300
29301#. type: Labeled list
29302#: ../sys-utils/mount.8.adoc:1197
29303#, no-wrap
29304msgid "*44bsd*"
29305msgstr ""
29306
29307#. type: delimited block _
29308#: ../sys-utils/mount.8.adoc:1199
29309msgid "For filesystems created by a BSD-like system (NetBSD, FreeBSD, OpenBSD)."
29310msgstr ""
29311
29312#. type: Labeled list
29313#: ../sys-utils/mount.8.adoc:1200
29314#, no-wrap
29315msgid "*ufs2*"
29316msgstr ""
29317
29318#. type: delimited block _
29319#: ../sys-utils/mount.8.adoc:1202
29320msgid "Used in FreeBSD 5.x supported as read-write."
29321msgstr ""
29322
29323#. type: Labeled list
29324#: ../sys-utils/mount.8.adoc:1203
29325#, no-wrap
29326msgid "*5xbsd*"
29327msgstr ""
29328
29329#. type: delimited block _
29330#: ../sys-utils/mount.8.adoc:1205
29331msgid "Synonym for ufs2."
29332msgstr ""
29333
29334#. type: Labeled list
29335#: ../sys-utils/mount.8.adoc:1206
29336#, no-wrap
29337msgid "*sun*"
29338msgstr ""
29339
29340#. type: delimited block _
29341#: ../sys-utils/mount.8.adoc:1208
29342msgid "For filesystems created by SunOS or Solaris on Sparc."
29343msgstr ""
29344
29345#. type: Labeled list
29346#: ../sys-utils/mount.8.adoc:1209
29347#, no-wrap
29348msgid "*sunx86*"
29349msgstr ""
29350
29351#. type: delimited block _
29352#: ../sys-utils/mount.8.adoc:1211
29353msgid "For filesystems created by Solaris on x86."
29354msgstr ""
29355
29356#. type: Labeled list
29357#: ../sys-utils/mount.8.adoc:1212
29358#, no-wrap
29359msgid "*hp*"
29360msgstr ""
29361
29362#. type: delimited block _
29363#: ../sys-utils/mount.8.adoc:1214
29364msgid "For filesystems created by HP-UX, read-only."
29365msgstr ""
29366
29367#. type: Labeled list
29368#: ../sys-utils/mount.8.adoc:1215
29369#, no-wrap
29370msgid "*nextstep*"
29371msgstr ""
29372
29373#. type: delimited block _
29374#: ../sys-utils/mount.8.adoc:1217
29375msgid "For filesystems created by NeXTStep (on NeXT station) (currently read only)."
29376msgstr ""
29377
29378#. type: Labeled list
29379#: ../sys-utils/mount.8.adoc:1218
29380#, no-wrap
29381msgid "*nextstep-cd*"
29382msgstr ""
29383
29384#. type: delimited block _
29385#: ../sys-utils/mount.8.adoc:1220
29386msgid "For NextStep CDROMs (block_size == 2048), read-only."
29387msgstr ""
29388
29389#. type: Labeled list
29390#: ../sys-utils/mount.8.adoc:1221
29391#, no-wrap
29392msgid "*openstep*"
29393msgstr ""
29394
29395#. type: delimited block _
29396#: ../sys-utils/mount.8.adoc:1223
29397msgid ""
29398"For filesystems created by OpenStep (currently read only). The same "
29399"filesystem type is also used by Mac OS X."
29400msgstr ""
29401
29402#. type: Labeled list
29403#: ../sys-utils/mount.8.adoc:1224
29404#, no-wrap
29405msgid "**onerror=**__value__"
29406msgstr ""
29407
29408#. type: delimited block _
29409#: ../sys-utils/mount.8.adoc:1226
29410msgid "Set behavior on error:"
29411msgstr ""
29412
29413#. type: Labeled list
29414#: ../sys-utils/mount.8.adoc:1227
29415#, no-wrap
29416msgid "*panic*"
29417msgstr ""
29418
29419#. type: delimited block _
29420#: ../sys-utils/mount.8.adoc:1229
29421msgid "If an error is encountered, cause a kernel panic."
29422msgstr ""
29423
29424#. type: Labeled list
29425#: ../sys-utils/mount.8.adoc:1230
29426#, no-wrap
29427msgid "[**lock**|**umount**|*repair*]"
29428msgstr ""
29429
29430#. type: delimited block _
29431#: ../sys-utils/mount.8.adoc:1232
29432msgid ""
29433"These mount options don't do anything at present; when an error is "
29434"encountered only a console message is printed."
29435msgstr ""
29436
29437#. type: Title ===
29438#: ../sys-utils/mount.8.adoc:1233
29439#, no-wrap
29440msgid "Mount options for umsdos"
29441msgstr ""
29442
29443#. type: delimited block _
29444#: ../sys-utils/mount.8.adoc:1236
29445msgid ""
29446"See mount options for msdos. The *dotsOK* option is explicitly killed by "
29447"_umsdos_."
29448msgstr ""
29449
29450#. type: Title ===
29451#: ../sys-utils/mount.8.adoc:1237
29452#, no-wrap
29453msgid "Mount options for vfat"
29454msgstr ""
29455
29456#. type: delimited block _
29457#: ../sys-utils/mount.8.adoc:1240
29458msgid ""
29459"First of all, the mount options for _fat_ are recognized. The *dotsOK* "
29460"option is explicitly killed by _vfat_. Furthermore, there are"
29461msgstr ""
29462
29463#. type: Labeled list
29464#: ../sys-utils/mount.8.adoc:1241
29465#, no-wrap
29466msgid "*uni_xlate*"
29467msgstr ""
29468
29469#. type: delimited block _
29470#: ../sys-utils/mount.8.adoc:1243
29471msgid ""
29472"Translate unhandled Unicode characters to special escaped sequences. This "
29473"lets you backup and restore filenames that are created with any Unicode "
29474"characters. Without this option, a '?' is used when no translation is "
29475"possible. The escape character is ':' because it is otherwise invalid on the "
29476"vfat filesystem. The escape sequence that gets used, where u is the Unicode "
29477"character, is: ':', (u & 0x3f), ((u>>6) & 0x3f), (u>>12)."
29478msgstr ""
29479
29480#. type: Labeled list
29481#: ../sys-utils/mount.8.adoc:1244
29482#, no-wrap
29483msgid "*posix*"
29484msgstr ""
29485
29486#. type: delimited block _
29487#: ../sys-utils/mount.8.adoc:1246
29488msgid ""
29489"Allow two files with names that only differ in case. This option is "
29490"obsolete."
29491msgstr ""
29492
29493#. type: Labeled list
29494#: ../sys-utils/mount.8.adoc:1247
29495#, no-wrap
29496msgid "*nonumtail*"
29497msgstr ""
29498
29499#. type: delimited block _
29500#: ../sys-utils/mount.8.adoc:1249
29501msgid ""
29502"First try to make a short name without sequence number, before trying "
29503"_name~num.ext_."
29504msgstr ""
29505
29506#. type: delimited block _
29507#: ../sys-utils/mount.8.adoc:1252
29508msgid ""
29509"UTF8 is the filesystem safe 8-bit encoding of Unicode that is used by the "
29510"console. It can be enabled for the filesystem with this option or disabled "
29511"with utf8=0, utf8=no or utf8=false. If _uni_xlate_ gets set, UTF8 gets "
29512"disabled."
29513msgstr ""
29514
29515#. type: Labeled list
29516#: ../sys-utils/mount.8.adoc:1253
29517#, no-wrap
29518msgid "**shortname=**__mode__"
29519msgstr ""
29520
29521#. type: delimited block _
29522#: ../sys-utils/mount.8.adoc:1255
29523msgid ""
29524"Defines the behavior for creation and display of filenames which fit into "
29525"8.3 characters. If a long name for a file exists, it will always be the "
29526"preferred one for display. There are four __mode__s:"
29527msgstr ""
29528
29529#. type: Labeled list
29530#: ../sys-utils/mount.8.adoc:1256
29531#, no-wrap
29532msgid "*lower*"
29533msgstr ""
29534
29535#. type: delimited block _
29536#: ../sys-utils/mount.8.adoc:1258
29537msgid ""
29538"Force the short name to lower case upon display; store a long name when the "
29539"short name is not all upper case."
29540msgstr ""
29541
29542#. type: Labeled list
29543#: ../sys-utils/mount.8.adoc:1259
29544#, no-wrap
29545msgid "*win95*"
29546msgstr ""
29547
29548#. type: delimited block _
29549#: ../sys-utils/mount.8.adoc:1261
29550msgid ""
29551"Force the short name to upper case upon display; store a long name when the "
29552"short name is not all upper case."
29553msgstr ""
29554
29555#. type: Labeled list
29556#: ../sys-utils/mount.8.adoc:1262
29557#, no-wrap
29558msgid "*winnt*"
29559msgstr ""
29560
29561#. type: delimited block _
29562#: ../sys-utils/mount.8.adoc:1264
29563msgid ""
29564"Display the short name as is; store a long name when the short name is not "
29565"all lower case or all upper case."
29566msgstr ""
29567
29568#. type: Labeled list
29569#: ../sys-utils/mount.8.adoc:1265
29570#, no-wrap
29571msgid "*mixed*"
29572msgstr ""
29573
29574#. type: delimited block _
29575#: ../sys-utils/mount.8.adoc:1267
29576msgid ""
29577"Display the short name as is; store a long name when the short name is not "
29578"all upper case. This mode is the default since Linux 2.6.32."
29579msgstr ""
29580
29581#. type: Title ===
29582#: ../sys-utils/mount.8.adoc:1268
29583#, no-wrap
29584msgid "Mount options for usbfs"
29585msgstr ""
29586
29587#. type: Labeled list
29588#: ../sys-utils/mount.8.adoc:1270
29589#, no-wrap
29590msgid "**devuid=**__uid__ and **devgid=**__gid__ and **devmode=**__mode__"
29591msgstr ""
29592
29593#. type: delimited block _
29594#: ../sys-utils/mount.8.adoc:1272
29595msgid ""
29596"Set the owner and group and mode of the device files in the usbfs filesystem "
29597"(default: uid=gid=0, mode=0644). The mode is given in octal."
29598msgstr ""
29599
29600#. type: Labeled list
29601#: ../sys-utils/mount.8.adoc:1273
29602#, no-wrap
29603msgid "**busuid=**__uid__ and **busgid=**__gid__ and **busmode=**__mode__"
29604msgstr ""
29605
29606#. type: delimited block _
29607#: ../sys-utils/mount.8.adoc:1275
29608msgid ""
29609"Set the owner and group and mode of the bus directories in the usbfs "
29610"filesystem (default: uid=gid=0, mode=0555). The mode is given in octal."
29611msgstr ""
29612
29613#. type: Labeled list
29614#: ../sys-utils/mount.8.adoc:1276
29615#, no-wrap
29616msgid "**listuid=**__uid__ and **listgid=**__gid__ and **listmode=**__mode__"
29617msgstr ""
29618
29619#. type: delimited block _
29620#: ../sys-utils/mount.8.adoc:1278
29621msgid ""
29622"Set the owner and group and mode of the file _devices_ (default: uid=gid=0, "
29623"mode=0444). The mode is given in octal."
29624msgstr ""
29625
29626#. type: Title ==
29627#: ../sys-utils/mount.8.adoc:1279
29628#, no-wrap
29629msgid "DM-VERITY SUPPORT (experimental)"
29630msgstr ""
29631
29632#. type: delimited block _
29633#: ../sys-utils/mount.8.adoc:1282
29634msgid ""
29635"The device-mapper verity target provides read-only transparent integrity "
29636"checking of block devices using kernel crypto API. The *mount* command can "
29637"open the dm-verity device and do the integrity verification before on the "
29638"device filesystem is mounted. Requires libcryptsetup with in libmount "
29639"(optionally via *dlopen*(3)). If libcryptsetup supports extracting the root "
29640"hash of an already mounted device, existing devices will be automatically "
29641"reused in case of a match. Mount options for dm-verity:"
29642msgstr ""
29643
29644#. type: Labeled list
29645#: ../sys-utils/mount.8.adoc:1283
29646#, no-wrap
29647msgid "**verity.hashdevice=**__path__"
29648msgstr ""
29649
29650#. type: delimited block _
29651#: ../sys-utils/mount.8.adoc:1285
29652msgid ""
29653"Path to the hash tree device associated with the source volume to pass to "
29654"dm-verity."
29655msgstr ""
29656
29657#. type: Labeled list
29658#: ../sys-utils/mount.8.adoc:1286
29659#, no-wrap
29660msgid "**verity.roothash=**__hex__"
29661msgstr ""
29662
29663#. type: delimited block _
29664#: ../sys-utils/mount.8.adoc:1288
29665msgid ""
29666"Hex-encoded hash of the root of _verity.hashdevice_. Mutually exclusive with "
29667"_verity.roothashfile._"
29668msgstr ""
29669
29670#. type: Labeled list
29671#: ../sys-utils/mount.8.adoc:1289
29672#, no-wrap
29673msgid "**verity.roothashfile=**__path__"
29674msgstr ""
29675
29676#. type: delimited block _
29677#: ../sys-utils/mount.8.adoc:1291
29678msgid ""
29679"Path to file containing the hex-encoded hash of the root of "
29680"_verity.hashdevice._ Mutually exclusive with _verity.roothash._"
29681msgstr ""
29682
29683#. type: Labeled list
29684#: ../sys-utils/mount.8.adoc:1292
29685#, no-wrap
29686msgid "**verity.hashoffset=**__offset__"
29687msgstr ""
29688
29689#. type: delimited block _
29690#: ../sys-utils/mount.8.adoc:1294
29691msgid ""
29692"If the hash tree device is embedded in the source volume, _offset_ (default: "
29693"0) is used by dm-verity to get to the tree."
29694msgstr ""
29695
29696#. type: Labeled list
29697#: ../sys-utils/mount.8.adoc:1295
29698#, no-wrap
29699msgid "**verity.fecdevice=**__path__"
29700msgstr ""
29701
29702#. type: delimited block _
29703#: ../sys-utils/mount.8.adoc:1297
29704msgid ""
29705"Path to the Forward Error Correction (FEC) device associated with the source "
29706"volume to pass to dm-verity. Optional. Requires kernel built with "
29707"*CONFIG_DM_VERITY_FEC*."
29708msgstr ""
29709
29710#. type: Labeled list
29711#: ../sys-utils/mount.8.adoc:1298
29712#, no-wrap
29713msgid "**verity.fecoffset=**__offset__"
29714msgstr ""
29715
29716#. type: delimited block _
29717#: ../sys-utils/mount.8.adoc:1300
29718msgid ""
29719"If the FEC device is embedded in the source volume, _offset_ (default: 0) is "
29720"used by dm-verity to get to the FEC area. Optional."
29721msgstr ""
29722
29723#. type: Labeled list
29724#: ../sys-utils/mount.8.adoc:1301
29725#, no-wrap
29726msgid "**verity.fecroots=**__value__"
29727msgstr ""
29728
29729#. type: delimited block _
29730#: ../sys-utils/mount.8.adoc:1303
29731msgid "Parity bytes for FEC (default: 2). Optional."
29732msgstr ""
29733
29734#. type: Labeled list
29735#: ../sys-utils/mount.8.adoc:1304
29736#, no-wrap
29737msgid "**verity.roothashsig=**__path__"
29738msgstr ""
29739
29740#. type: delimited block _
29741#: ../sys-utils/mount.8.adoc:1306
29742msgid ""
29743"Path to *pkcs7*(1ssl) signature of root hash hex string. Requires "
29744"crypt_activate_by_signed_key() from cryptsetup and kernel built with "
29745"*CONFIG_DM_VERITY_VERIFY_ROOTHASH_SIG*. For device reuse, signatures have to "
29746"be either used by all mounts of a device or by none. Optional."
29747msgstr ""
29748
29749#. type: delimited block _
29750#: ../sys-utils/mount.8.adoc:1308
29751msgid "Supported since util-linux v2.35."
29752msgstr ""
29753
29754#. type: delimited block _
29755#: ../sys-utils/mount.8.adoc:1310
29756msgid "For example commands:"
29757msgstr ""
29758
29759#. type: delimited block .
29760#: ../sys-utils/mount.8.adoc:1319
29761#, no-wrap
29762msgid ""
29763"mksquashfs /etc /tmp/etc.squashfs\n"
29764"dd if=/dev/zero of=/tmp/etc.hash bs=1M count=10\n"
29765"veritysetup format /tmp/etc.squashfs /tmp/etc.hash\n"
29766"openssl smime -sign -in <hash> -nocerts -inkey private.key \\\n"
29767"-signer private.crt -noattr -binary -outform der -out /tmp/etc.p7\n"
29768"mount -o verity.hashdevice=/tmp/etc.hash,verity.roothash=<hash>,\\\n"
29769"verity.roothashsig=/tmp/etc.p7 /tmp/etc.squashfs /mnt\n"
29770msgstr ""
29771
29772#. type: Plain text
29773#: ../sys-utils/mount.8.adoc:1322
29774msgid ""
29775"create squashfs image from _/etc_ directory, verity hash device and mount "
29776"verified filesystem image to _/mnt_. The kernel will verify that the root "
29777"hash is signed by a key from the kernel keyring if roothashsig is used."
29778msgstr ""
29779
29780#. type: Title ==
29781#: ../sys-utils/mount.8.adoc:1323
29782#, no-wrap
29783msgid "LOOP-DEVICE SUPPORT"
29784msgstr ""
29785
29786#. type: Plain text
29787#: ../sys-utils/mount.8.adoc:1326
29788msgid ""
29789"One further possible type is a mount via the loop device. For example, the "
29790"command"
29791msgstr ""
29792
29793#. type: delimited block _
29794#: ../sys-utils/mount.8.adoc:1329
29795#, no-wrap
29796msgid "*mount /tmp/disk.img /mnt -t vfat -o loop=/dev/loop3*\n"
29797msgstr ""
29798
29799#. type: Plain text
29800#: ../sys-utils/mount.8.adoc:1332
29801msgid ""
29802"will set up the loop device _/dev/loop3_ to correspond to the file "
29803"_/tmp/disk.img_, and then mount this device on _/mnt_."
29804msgstr ""
29805
29806#. type: Plain text
29807#: ../sys-utils/mount.8.adoc:1334
29808msgid ""
29809"If no explicit loop device is mentioned (but just an option '**-o loop**' is "
29810"given), then *mount* will try to find some unused loop device and use that, "
29811"for example"
29812msgstr ""
29813
29814#. type: delimited block _
29815#: ../sys-utils/mount.8.adoc:1337
29816#, no-wrap
29817msgid "*mount /tmp/disk.img /mnt -o loop*\n"
29818msgstr ""
29819
29820#. type: Plain text
29821#: ../sys-utils/mount.8.adoc:1340
29822msgid ""
29823"The *mount* command *automatically* creates a loop device from a regular "
29824"file if a filesystem type is not specified or the filesystem is known for "
29825"libblkid, for example:"
29826msgstr ""
29827
29828#. type: delimited block _
29829#: ../sys-utils/mount.8.adoc:1343
29830#, no-wrap
29831msgid "*mount /tmp/disk.img /mnt*\n"
29832msgstr ""
29833
29834#. type: delimited block _
29835#: ../sys-utils/mount.8.adoc:1345
29836#, no-wrap
29837msgid "*mount -t ext4 /tmp/disk.img /mnt*\n"
29838msgstr ""
29839
29840#. type: Plain text
29841#: ../sys-utils/mount.8.adoc:1348
29842msgid ""
29843"This type of mount knows about three options, namely *loop*, *offset* and "
5db1d29a
MB
29844"*sizelimit*, that are really options to *losetup*(8). (These options can be "
29845"used in addition to those specific to the filesystem type.)"
36e96905
MB
29846msgstr ""
29847
29848#. type: Plain text
29849#: ../sys-utils/mount.8.adoc:1350
29850msgid ""
29851"Since Linux 2.6.25 auto-destruction of loop devices is supported, meaning "
29852"that any loop device allocated by *mount* will be freed by *umount* "
29853"independently of _/etc/mtab_."
29854msgstr ""
29855
29856#. type: Plain text
29857#: ../sys-utils/mount.8.adoc:1352
29858msgid "You can also free a loop device by hand, using *losetup -d* or *umount -d*."
29859msgstr ""
29860
29861#. type: Plain text
29862#: ../sys-utils/mount.8.adoc:1354
29863msgid ""
29864"Since util-linux v2.29, *mount* re-uses the loop device rather than "
29865"initializing a new device if the same backing file is already used for some "
29866"loop device with the same offset and sizelimit. This is necessary to avoid a "
29867"filesystem corruption."
29868msgstr ""
29869
29870#. type: Plain text
29871#: ../sys-utils/mount.8.adoc:1358
29872#, no-wrap
29873msgid "*mount* has the following exit status values (the bits can be ORed):\n"
29874msgstr ""
29875
29876#. type: Plain text
29877#: ../sys-utils/mount.8.adoc:1364
29878msgid "incorrect invocation or permissions"
29879msgstr ""
29880
29881#. type: Plain text
29882#: ../sys-utils/mount.8.adoc:1367
29883msgid "system error (out of memory, cannot fork, no more loop devices)"
29884msgstr ""
29885
29886#. type: Plain text
29887#: ../sys-utils/mount.8.adoc:1370
29888msgid "internal *mount* bug"
29889msgstr ""
29890
29891#. type: Plain text
29892#: ../sys-utils/mount.8.adoc:1373
29893msgid "user interrupt"
29894msgstr ""
29895
29896#. type: Plain text
29897#: ../sys-utils/mount.8.adoc:1376
29898msgid "problems writing or locking _/etc/mtab_"
29899msgstr ""
29900
29901#. type: Plain text
29902#: ../sys-utils/mount.8.adoc:1379
29903msgid "mount failure"
29904msgstr ""
29905
29906#. type: Plain text
29907#: ../sys-utils/mount.8.adoc:1382
29908msgid "some mount succeeded"
29909msgstr ""
29910
29911#. type: Plain text
29912#: ../sys-utils/mount.8.adoc:1384
29913msgid ""
29914"The command *mount -a* returns 0 (all succeeded), 32 (all failed), or 64 "
29915"(some failed, some succeeded)."
29916msgstr ""
29917
29918#. type: Title ==
29919#: ../sys-utils/mount.8.adoc:1385 ../sys-utils/umount.8.adoc:134
29920#, no-wrap
29921msgid "EXTERNAL HELPERS"
29922msgstr ""
29923
29924#. type: Plain text
29925#: ../sys-utils/mount.8.adoc:1388
29926msgid "The syntax of external mount helpers is:"
29927msgstr ""
29928
29929#. type: Plain text
29930#: ../sys-utils/mount.8.adoc:1390
29931#, no-wrap
29932msgid ""
29933"**/sbin/mount.**__suffix__ _spec dir_ [*-sfnv*] [*-N* _namespace_] [*-o* "
29934"_options_] [*-t* __type__**.**_subtype_]\n"
29935msgstr ""
29936
29937#. type: Plain text
29938#: ../sys-utils/mount.8.adoc:1392
29939msgid ""
29940"where the _suffix_ is the filesystem type and the *-sfnvoN* options have the "
29941"same meaning as the normal mount options. The *-t* option is used for "
29942"filesystems with subtypes support (for example */sbin/mount.fuse -t "
29943"fuse.sshfs*)."
29944msgstr ""
29945
29946#. type: Plain text
29947#: ../sys-utils/mount.8.adoc:1394
29948msgid ""
29949"The command *mount* does not pass the mount options *unbindable*, "
29950"*runbindable*, *private*, *rprivate*, *slave*, *rslave*, *shared*, "
29951"*rshared*, *auto*, *noauto*, *comment*, *x-**, *loop*, *offset* and "
29952"*sizelimit* to the mount.<suffix> helpers. All other options are used in a "
29953"comma-separated list as an argument to the *-o* option."
29954msgstr ""
29955
29956#. type: Plain text
29957#: ../sys-utils/mount.8.adoc:1399
29958msgid "overrides the default location of the _fstab_ file (ignored for suid)"
29959msgstr ""
29960
29961#. type: Plain text
29962#: ../sys-utils/mount.8.adoc:1402
29963msgid "overrides the default location of the _mtab_ file (ignored for suid)"
29964msgstr ""
29965
29966#. type: Plain text
29967#: ../sys-utils/mount.8.adoc:1408
29968msgid "enables libblkid debug output"
29969msgstr ""
29970
29971#. type: Plain text
29972#: ../sys-utils/mount.8.adoc:1411
29973msgid "enables loop device setup debug output"
29974msgstr ""
29975
29976#. type: Plain text
29977#: ../sys-utils/mount.8.adoc:1415
29978msgid ""
29979"See also \"*The files /etc/fstab, /etc/mtab and /proc/mounts*\" section "
29980"above."
29981msgstr ""
29982
29983#. type: Plain text
29984#: ../sys-utils/mount.8.adoc:1418
29985msgid "filesystem table"
29986msgstr ""
29987
29988#. type: Labeled list
29989#: ../sys-utils/mount.8.adoc:1419
29990#, no-wrap
29991msgid "_/run/mount_"
29992msgstr ""
29993
29994#. type: Plain text
29995#: ../sys-utils/mount.8.adoc:1421
29996msgid "libmount private runtime directory"
29997msgstr ""
29998
29999#. type: Labeled list
30000#: ../sys-utils/mount.8.adoc:1422 ../sys-utils/umount.8.adoc:167
30001#, no-wrap
30002msgid "_/etc/mtab_"
30003msgstr ""
30004
30005#. type: Plain text
30006#: ../sys-utils/mount.8.adoc:1424
30007msgid "table of mounted filesystems or symlink to _/proc/mounts_"
30008msgstr ""
30009
30010#. type: Labeled list
30011#: ../sys-utils/mount.8.adoc:1425
30012#, no-wrap
30013msgid "_/etc/mtab~_"
30014msgstr ""
30015
30016#. type: Plain text
30017#: ../sys-utils/mount.8.adoc:1427
30018msgid "lock file (unused on systems with _mtab_ symlink)"
30019msgstr ""
30020
30021#. type: Labeled list
30022#: ../sys-utils/mount.8.adoc:1428
30023#, no-wrap
30024msgid "_/etc/mtab.tmp_"
30025msgstr ""
30026
30027#. type: Plain text
30028#: ../sys-utils/mount.8.adoc:1430
30029msgid "temporary file (unused on systems with _mtab_ symlink)"
30030msgstr ""
30031
30032#. type: Labeled list
30033#: ../sys-utils/mount.8.adoc:1431
30034#, no-wrap
30035msgid "_/etc/filesystems_"
30036msgstr ""
30037
30038#. type: Plain text
30039#: ../sys-utils/mount.8.adoc:1433
30040msgid "a list of filesystem types to try"
30041msgstr ""
30042
30043#. type: Plain text
30044#: ../sys-utils/mount.8.adoc:1437
30045msgid "A *mount* command existed in Version 5 AT&T UNIX."
30046msgstr ""
30047
30048#. type: Plain text
30049#: ../sys-utils/mount.8.adoc:1441
30050msgid "It is possible for a corrupted filesystem to cause a crash."
30051msgstr ""
30052
30053#. type: Plain text
30054#: ../sys-utils/mount.8.adoc:1443
30055msgid ""
30056"Some Linux filesystems don't support *-o sync* and *-o dirsync* (the ext2, "
30057"ext3, ext4, fat and vfat filesystems _do_ support synchronous updates (a la "
30058"BSD) when mounted with the *sync* option)."
30059msgstr ""
30060
30061#. type: Plain text
30062#: ../sys-utils/mount.8.adoc:1445
30063msgid ""
30064"The *-o remount* may not be able to change mount parameters (all "
30065"_ext2fs_-specific parameters, except *sb*, are changeable with a remount, "
30066"for example, but you can't change *gid* or *umask* for the _fatfs_)."
30067msgstr ""
30068
30069#. type: Plain text
30070#: ../sys-utils/mount.8.adoc:1447
30071msgid ""
30072"It is possible that the files _/etc/mtab_ and _/proc/mounts_ don't match on "
30073"systems with a regular _mtab_ file. The first file is based only on the "
30074"*mount* command options, but the content of the second file also depends on "
30075"the kernel and others settings (e.g. on a remote NFS server -- in certain "
30076"cases the *mount* command may report unreliable information about an NFS "
30077"mount point and the _/proc/mount_ file usually contains more reliable "
30078"information.) This is another reason to replace the _mtab_ file with a "
30079"symlink to the _/proc/mounts_ file."
30080msgstr ""
30081
30082#. type: Plain text
30083#: ../sys-utils/mount.8.adoc:1449
30084msgid ""
30085"Checking files on NFS filesystems referenced by file descriptors (i.e. the "
30086"*fcntl* and *ioctl* families of functions) may lead to inconsistent results "
30087"due to the lack of a consistency check in the kernel even if the *noac* "
30088"mount option is used."
30089msgstr ""
30090
30091#. type: Plain text
30092#: ../sys-utils/mount.8.adoc:1451
30093msgid ""
30094"The *loop* option with the *offset* or *sizelimit* options used may fail "
30095"when using older kernels if the *mount* command can't confirm that the size "
30096"of the block device has been configured as requested. This situation can be "
30097"worked around by using the *losetup*(8) command manually before calling "
30098"*mount* with the configured loop device."
30099msgstr ""
30100
30101#. type: Plain text
30102#: ../sys-utils/mount.8.adoc:1477
30103#, no-wrap
30104msgid ""
30105"*mount*(2),\n"
30106"*umount*(2),\n"
30107"*filesystems*(5),\n"
30108"*fstab*(5),\n"
30109"*nfs*(5),\n"
30110"*xfs*(5),\n"
30111"*mount_namespaces*(7),\n"
30112"*xattr*(7),\n"
30113"*e2label*(8),\n"
30114"*findmnt*(8),\n"
30115"*losetup*(8),\n"
30116"*lsblk*(8),\n"
30117"*mke2fs*(8),\n"
30118"*mountd*(8),\n"
30119"*nfsd*(8),\n"
30120"*swapon*(8),\n"
30121"*tune2fs*(8),\n"
30122"*umount*(8),\n"
30123"*xfs_admin*(8)\n"
30124msgstr ""
30125
30126#. type: Title =
30127#: ../sys-utils/mountpoint.1.adoc:2
30128#, no-wrap
30129msgid "mountpoint(1)"
30130msgstr ""
30131
30132#. type: Plain text
30133#: ../sys-utils/mountpoint.1.adoc:12
30134msgid "mountpoint - see if a directory or file is a mountpoint"
30135msgstr ""
30136
30137#. type: Plain text
30138#: ../sys-utils/mountpoint.1.adoc:16
30139#, no-wrap
30140msgid "*mountpoint* [*-d*|*-q*] _directory_|_file_\n"
30141msgstr ""
30142
30143#. type: Plain text
30144#: ../sys-utils/mountpoint.1.adoc:18
30145#, no-wrap
30146msgid "*mountpoint* *-x* _device_\n"
30147msgstr ""
30148
30149#. type: Plain text
30150#: ../sys-utils/mountpoint.1.adoc:22
30151#, no-wrap
30152msgid ""
30153"*mountpoint* checks whether the given _directory_ or _file_ is mentioned in "
30154"the _/proc/self/mountinfo_ file.\n"
30155msgstr ""
30156
30157#. type: Labeled list
30158#: ../sys-utils/mountpoint.1.adoc:25
30159#, no-wrap
30160msgid "*-d*, *--fs-devno*"
30161msgstr ""
30162
30163#. type: Plain text
30164#: ../sys-utils/mountpoint.1.adoc:27
30165msgid ""
30166"Show the major/minor numbers of the device that is mounted on the given "
30167"directory."
30168msgstr ""
30169
30170#. type: Plain text
30171#: ../sys-utils/mountpoint.1.adoc:30
30172msgid "Be quiet - don't print anything."
30173msgstr ""
30174
30175#. type: Labeled list
30176#: ../sys-utils/mountpoint.1.adoc:31
30177#, no-wrap
30178msgid "*--nofollow*"
30179msgstr ""
30180
30181#. type: Plain text
30182#: ../sys-utils/mountpoint.1.adoc:33
30183msgid "Do not follow symbolic link if it the last element of the _directory_ path."
30184msgstr ""
30185
30186#. type: Labeled list
30187#: ../sys-utils/mountpoint.1.adoc:34
30188#, no-wrap
30189msgid "*-x*, *--devno*"
30190msgstr ""
30191
30192#. type: Plain text
30193#: ../sys-utils/mountpoint.1.adoc:36
30194msgid "Show the major/minor numbers of the given blockdevice on standard output."
30195msgstr ""
30196
30197#. type: Plain text
30198#: ../sys-utils/mountpoint.1.adoc:46
30199#, no-wrap
30200msgid "*mountpoint* has the following exit status values:\n"
30201msgstr ""
30202
30203#. type: Plain text
30204#: ../sys-utils/mountpoint.1.adoc:49
30205msgid ""
30206"success; the directory is a mountpoint, or device is block device on "
30207"*--devno*"
30208msgstr ""
30209
30210#. type: Plain text
30211#: ../sys-utils/mountpoint.1.adoc:52
30212msgid "failure; incorrect invocation, permissions or system error"
30213msgstr ""
30214
30215#. type: Plain text
30216#: ../sys-utils/mountpoint.1.adoc:55
30217msgid ""
30218"failure; the directory is not a mountpoint, or device is not a block device "
30219"on *--devno*"
30220msgstr ""
30221
30222#. type: Plain text
30223#: ../sys-utils/mountpoint.1.adoc:64
30224msgid ""
30225"The util-linux *mountpoint* implementation was written from scratch for "
30226"libmount. The original version for sysvinit suite was written by Miquel van "
30227"Smoorenburg."
30228msgstr ""
30229
30230#. type: Title =
30231#: ../sys-utils/nsenter.1.adoc:2
30232#, no-wrap
30233msgid "nsenter(1)"
30234msgstr ""
30235
30236#. type: Plain text
30237#: ../sys-utils/nsenter.1.adoc:12
30238msgid "nsenter - run program in different namespaces"
30239msgstr ""
30240
30241#. type: Plain text
30242#: ../sys-utils/nsenter.1.adoc:16
30243#, no-wrap
30244msgid "*nsenter* [options] [_program_ [_arguments_]]\n"
30245msgstr ""
30246
30247#. type: Plain text
30248#: ../sys-utils/nsenter.1.adoc:20
30249msgid ""
30250"The *nsenter* command executes _program_ in the namespace(s) that are "
30251"specified in the command-line options (described below). If _program_ is not "
30252"given, then \"$\\{SHELL}\" is run (default: _/bin/sh_)."
30253msgstr ""
30254
30255#. type: Plain text
30256#: ../sys-utils/nsenter.1.adoc:22
30257msgid "Enterable namespaces are:"
30258msgstr ""
30259
30260#. type: Labeled list
30261#: ../sys-utils/nsenter.1.adoc:23 ../sys-utils/unshare.1.adoc:27
30262#, no-wrap
30263msgid "*mount namespace*"
30264msgstr ""
30265
30266#. type: Plain text
30267#: ../sys-utils/nsenter.1.adoc:25
30268msgid ""
30269"Mounting and unmounting filesystems will not affect the rest of the system, "
30270"except for filesystems which are explicitly marked as shared (with *mount "
30271"--make-shared*; see _/proc/self/mountinfo_ for the *shared* flag). For "
30272"further details, see *mount_namespaces*(7) and the discussion of the "
30273"*CLONE_NEWNS* flag in *clone*(2)."
30274msgstr ""
30275
30276#. type: Labeled list
30277#: ../sys-utils/nsenter.1.adoc:26 ../sys-utils/unshare.1.adoc:32
30278#, no-wrap
30279msgid "*UTS namespace*"
30280msgstr ""
30281
30282#. type: Plain text
30283#: ../sys-utils/nsenter.1.adoc:28 ../sys-utils/unshare.1.adoc:34
30284msgid ""
30285"Setting hostname or domainname will not affect the rest of the system. For "
30286"further details, see *uts_namespaces*(7)."
30287msgstr ""
30288
30289#. type: Labeled list
30290#: ../sys-utils/nsenter.1.adoc:29 ../sys-utils/unshare.1.adoc:35
30291#, no-wrap
30292msgid "*IPC namespace*"
30293msgstr ""
30294
30295#. type: Plain text
5db1d29a 30296#: ../sys-utils/nsenter.1.adoc:31 ../sys-utils/unshare.1.adoc:37
36e96905
MB
30297msgid ""
30298"The process will have an independent namespace for POSIX message queues as "
30299"well as System V message queues, semaphore sets and shared memory "
30300"segments. For further details, see *ipc_namespaces*(7)."
30301msgstr ""
30302
30303#. type: Labeled list
30304#: ../sys-utils/nsenter.1.adoc:32 ../sys-utils/unshare.1.adoc:38
30305#, no-wrap
30306msgid "*network namespace*"
30307msgstr ""
30308
30309#. type: Plain text
30310#: ../sys-utils/nsenter.1.adoc:34 ../sys-utils/unshare.1.adoc:40
30311msgid ""
30312"The process will have independent IPv4 and IPv6 stacks, IP routing tables, "
30313"firewall rules, the _/proc/net_ and _/sys/class/net_ directory trees, "
30314"sockets, etc. For further details, see *network_namespaces*(7)."
30315msgstr ""
30316
30317#. type: Labeled list
30318#: ../sys-utils/nsenter.1.adoc:35 ../sys-utils/unshare.1.adoc:41
30319#, no-wrap
30320msgid "*PID namespace*"
30321msgstr ""
30322
30323#. type: Plain text
30324#: ../sys-utils/nsenter.1.adoc:37
30325msgid ""
30326"Children will have a set of PID to process mappings separate from the "
30327"*nsenter* process. *nsenter* will fork by default if changing the PID "
30328"namespace, so that the new program and its children share the same PID "
30329"namespace and are visible to each other. If *--no-fork* is used, the new "
30330"program will be exec'ed without forking. For further details, see "
30331"*pid_namespaces*(7)."
30332msgstr ""
30333
30334#. type: Labeled list
30335#: ../sys-utils/nsenter.1.adoc:38 ../sys-utils/unshare.1.adoc:47
30336#, no-wrap
30337msgid "*user namespace*"
30338msgstr ""
30339
30340#. type: Plain text
30341#: ../sys-utils/nsenter.1.adoc:40 ../sys-utils/unshare.1.adoc:49
30342msgid ""
30343"The process will have a distinct set of UIDs, GIDs and capabilities. For "
30344"further details, see *user_namespaces*(7)."
30345msgstr ""
30346
30347#. type: Labeled list
30348#: ../sys-utils/nsenter.1.adoc:41 ../sys-utils/unshare.1.adoc:44
30349#, no-wrap
30350msgid "*cgroup namespace*"
30351msgstr ""
30352
30353#. type: Plain text
30354#: ../sys-utils/nsenter.1.adoc:43 ../sys-utils/unshare.1.adoc:46
30355msgid ""
30356"The process will have a virtualized view of _/proc/self/cgroup_, and new "
30357"cgroup mounts will be rooted at the namespace cgroup root. For further "
30358"details, see *cgroup_namespaces*(7)."
30359msgstr ""
30360
30361#. type: Labeled list
30362#: ../sys-utils/nsenter.1.adoc:44 ../sys-utils/unshare.1.adoc:50
30363#, no-wrap
30364msgid "*time namespace*"
30365msgstr ""
30366
30367#. type: Plain text
30368#: ../sys-utils/nsenter.1.adoc:46 ../sys-utils/unshare.1.adoc:52
30369msgid ""
30370"The process can have a distinct view of *CLOCK_MONOTONIC* and/or "
30371"*CLOCK_BOOTTIME* which can be changed using _/proc/self/timens_offsets_. For "
30372"further details, see *time_namespaces*(7)."
30373msgstr ""
30374
30375#. TRANSLATORS: Keep {asterisk} untranslated.
30376#. type: Plain text
30377#: ../sys-utils/nsenter.1.adoc:51
30378msgid ""
30379"Various of the options below that relate to namespaces take an optional "
30380"_file_ argument. This should be one of the _/proc/[pid]/ns/{asterisk}_ files "
30381"described in *namespaces*(7), or the pathname of a bind mount that was "
30382"created on one of those files."
30383msgstr ""
30384
30385#. type: Plain text
30386#: ../sys-utils/nsenter.1.adoc:55
30387msgid ""
30388"Enter all namespaces of the target process by the default "
30389"_/proc/[pid]/ns/{asterisk}_ namespace paths. The default paths to the target "
30390"process namespaces may be overwritten by namespace specific options (e.g., "
30391"*--all --mount*=[_path_])."
30392msgstr ""
30393
30394#. type: Plain text
30395#: ../sys-utils/nsenter.1.adoc:57
30396msgid ""
30397"The user namespace will be ignored if the same as the caller's current user "
30398"namespace. It prevents a caller that has dropped capabilities from regaining "
30399"those capabilities via a call to setns(). See *setns*(2) for more details."
30400msgstr ""
30401
30402#. type: Labeled list
30403#: ../sys-utils/nsenter.1.adoc:58
30404#, no-wrap
30405msgid "*-t*, *--target* _PID_"
30406msgstr ""
30407
30408#. type: Plain text
30409#: ../sys-utils/nsenter.1.adoc:60
30410msgid ""
30411"Specify a target process to get contexts from. The paths to the contexts "
30412"specified by _pid_ are:"
30413msgstr ""
30414
982aa62b
MB
30415#. type: Labeled list
30416#: ../sys-utils/nsenter.1.adoc:61
30417#, no-wrap
30418msgid "_/proc/pid/ns/mnt_"
30419msgstr ""
30420
30421#. type: Plain text
30422#: ../sys-utils/nsenter.1.adoc:63
30423msgid "the mount namespace"
30424msgstr ""
30425
30426#. type: Labeled list
30427#: ../sys-utils/nsenter.1.adoc:63
30428#, no-wrap
30429msgid "_/proc/pid/ns/uts_"
30430msgstr ""
30431
30432#. type: Plain text
30433#: ../sys-utils/nsenter.1.adoc:65
30434msgid "the UTS namespace"
30435msgstr ""
30436
30437#. type: Labeled list
30438#: ../sys-utils/nsenter.1.adoc:65
30439#, no-wrap
30440msgid "_/proc/pid/ns/ipc_"
30441msgstr ""
30442
30443#. type: Plain text
30444#: ../sys-utils/nsenter.1.adoc:67
30445msgid "the IPC namespace"
30446msgstr ""
30447
30448#. type: Labeled list
30449#: ../sys-utils/nsenter.1.adoc:67
30450#, no-wrap
30451msgid "_/proc/pid/ns/net_"
30452msgstr ""
30453
30454#. type: Plain text
30455#: ../sys-utils/nsenter.1.adoc:69
30456msgid "the network namespace"
30457msgstr ""
30458
30459#. type: Labeled list
30460#: ../sys-utils/nsenter.1.adoc:69
30461#, no-wrap
30462msgid "_/proc/pid/ns/pid_"
30463msgstr ""
30464
30465#. type: Plain text
30466#: ../sys-utils/nsenter.1.adoc:71
30467msgid "the PID namespace"
30468msgstr ""
30469
30470#. type: Labeled list
30471#: ../sys-utils/nsenter.1.adoc:71
30472#, no-wrap
30473msgid "_/proc/pid/ns/user_"
30474msgstr ""
30475
30476#. type: Plain text
30477#: ../sys-utils/nsenter.1.adoc:73
30478msgid "the user namespace"
30479msgstr ""
30480
30481#. type: Labeled list
30482#: ../sys-utils/nsenter.1.adoc:73
30483#, no-wrap
30484msgid "_/proc/pid/ns/cgroup_"
30485msgstr ""
30486
30487#. type: Plain text
30488#: ../sys-utils/nsenter.1.adoc:75
30489msgid "the cgroup namespace"
30490msgstr ""
30491
30492#. type: Labeled list
30493#: ../sys-utils/nsenter.1.adoc:75
30494#, no-wrap
30495msgid "_/proc/pid/ns/time_"
30496msgstr ""
30497
30498#. type: Plain text
30499#: ../sys-utils/nsenter.1.adoc:77
30500msgid "the time namespace"
30501msgstr ""
30502
30503#. type: Labeled list
30504#: ../sys-utils/nsenter.1.adoc:77
30505#, no-wrap
30506msgid "_/proc/pid/root_"
30507msgstr ""
30508
30509#. type: Plain text
30510#: ../sys-utils/nsenter.1.adoc:79
30511msgid "the root directory"
30512msgstr ""
30513
30514#. type: Labeled list
30515#: ../sys-utils/nsenter.1.adoc:79
30516#, no-wrap
30517msgid "_/proc/pid/cwd_"
30518msgstr ""
30519
36e96905
MB
30520#. type: Plain text
30521#: ../sys-utils/nsenter.1.adoc:81
982aa62b 30522msgid "the working directory respectively"
36e96905
MB
30523msgstr ""
30524
30525#. type: Labeled list
30526#: ../sys-utils/nsenter.1.adoc:82
30527#, no-wrap
30528msgid "*-m*, *--mount*[=_file_]"
30529msgstr ""
30530
30531#. type: Plain text
30532#: ../sys-utils/nsenter.1.adoc:84
30533msgid ""
30534"Enter the mount namespace. If no file is specified, enter the mount "
30535"namespace of the target process. If _file_ is specified, enter the mount "
30536"namespace specified by _file_."
30537msgstr ""
30538
30539#. type: Labeled list
30540#: ../sys-utils/nsenter.1.adoc:85
30541#, no-wrap
30542msgid "*-u*, *--uts*[=_file_]"
30543msgstr ""
30544
30545#. type: Plain text
30546#: ../sys-utils/nsenter.1.adoc:87
30547msgid ""
30548"Enter the UTS namespace. If no file is specified, enter the UTS namespace of "
30549"the target process. If _file_ is specified, enter the UTS namespace "
30550"specified by _file_."
30551msgstr ""
30552
30553#. type: Labeled list
30554#: ../sys-utils/nsenter.1.adoc:88
30555#, no-wrap
30556msgid "*-i*, *--ipc*[=_file_]"
30557msgstr ""
30558
30559#. type: Plain text
30560#: ../sys-utils/nsenter.1.adoc:90
30561msgid ""
30562"Enter the IPC namespace. If no file is specified, enter the IPC namespace of "
30563"the target process. If _file_ is specified, enter the IPC namespace "
30564"specified by _file_."
30565msgstr ""
30566
30567#. type: Labeled list
30568#: ../sys-utils/nsenter.1.adoc:91
30569#, no-wrap
30570msgid "*-n*, *--net*[=_file_]"
30571msgstr ""
30572
30573#. type: Plain text
30574#: ../sys-utils/nsenter.1.adoc:93
30575msgid ""
30576"Enter the network namespace. If no file is specified, enter the network "
30577"namespace of the target process. If _file_ is specified, enter the network "
30578"namespace specified by _file_."
30579msgstr ""
30580
30581#. type: Labeled list
30582#: ../sys-utils/nsenter.1.adoc:94
30583#, no-wrap
30584msgid "*-p*, *--pid*[=_file_]"
30585msgstr ""
30586
30587#. type: Plain text
30588#: ../sys-utils/nsenter.1.adoc:96
30589msgid ""
30590"Enter the PID namespace. If no file is specified, enter the PID namespace of "
30591"the target process. If _file_ is specified, enter the PID namespace "
30592"specified by _file_."
30593msgstr ""
30594
30595#. type: Labeled list
30596#: ../sys-utils/nsenter.1.adoc:97
30597#, no-wrap
30598msgid "*-U*, *--user*[=_file_]"
30599msgstr ""
30600
30601#. type: Plain text
30602#: ../sys-utils/nsenter.1.adoc:99
30603msgid ""
30604"Enter the user namespace. If no file is specified, enter the user namespace "
30605"of the target process. If _file_ is specified, enter the user namespace "
30606"specified by _file_. See also the *--setuid* and *--setgid* options."
30607msgstr ""
30608
30609#. type: Labeled list
30610#: ../sys-utils/nsenter.1.adoc:100
30611#, no-wrap
30612msgid "*-C*, *--cgroup*[=_file_]"
30613msgstr ""
30614
30615#. type: Plain text
30616#: ../sys-utils/nsenter.1.adoc:102
30617msgid ""
30618"Enter the cgroup namespace. If no file is specified, enter the cgroup "
30619"namespace of the target process. If _file_ is specified, enter the cgroup "
30620"namespace specified by _file_."
30621msgstr ""
30622
30623#. type: Labeled list
30624#: ../sys-utils/nsenter.1.adoc:103
30625#, no-wrap
30626msgid "*-T*, *--time*[=_file_]"
30627msgstr ""
30628
30629#. type: Plain text
30630#: ../sys-utils/nsenter.1.adoc:105
30631msgid ""
30632"Enter the time namespace. If no file is specified, enter the time namespace "
30633"of the target process. If _file_ is specified, enter the time namespace "
30634"specified by _file_."
30635msgstr ""
30636
30637#. type: Labeled list
30638#: ../sys-utils/nsenter.1.adoc:106 ../sys-utils/unshare.1.adoc:122
30639#, no-wrap
30640msgid "*-G*, *--setgid* _gid_"
30641msgstr ""
30642
30643#. type: Plain text
30644#: ../sys-utils/nsenter.1.adoc:108
30645msgid ""
30646"Set the group ID which will be used in the entered namespace and drop "
30647"supplementary groups. *nsenter* always sets GID for user namespaces, the "
30648"default is 0."
30649msgstr ""
30650
30651#. type: Labeled list
30652#: ../sys-utils/nsenter.1.adoc:109 ../sys-utils/unshare.1.adoc:119
30653#, no-wrap
30654msgid "*-S*, *--setuid* _uid_"
30655msgstr ""
30656
30657#. type: Plain text
30658#: ../sys-utils/nsenter.1.adoc:111
30659msgid ""
30660"Set the user ID which will be used in the entered namespace. *nsenter* "
30661"always sets UID for user namespaces, the default is 0."
30662msgstr ""
30663
30664#. type: Labeled list
30665#: ../sys-utils/nsenter.1.adoc:112
30666#, no-wrap
30667msgid "*--preserve-credentials*"
30668msgstr ""
30669
30670#. type: Plain text
30671#: ../sys-utils/nsenter.1.adoc:114
30672msgid ""
30673"Don't modify UID and GID when enter user namespace. The default is to drops "
30674"supplementary groups and sets GID and UID to 0."
30675msgstr ""
30676
30677#. type: Labeled list
30678#: ../sys-utils/nsenter.1.adoc:115
30679#, no-wrap
30680msgid "*-r*, *--root*[=_directory_]"
30681msgstr ""
30682
30683#. type: Plain text
30684#: ../sys-utils/nsenter.1.adoc:117
30685msgid ""
30686"Set the root directory. If no directory is specified, set the root directory "
30687"to the root directory of the target process. If directory is specified, set "
30688"the root directory to the specified directory."
30689msgstr ""
30690
30691#. type: Labeled list
30692#: ../sys-utils/nsenter.1.adoc:118
30693#, no-wrap
30694msgid "*-w*, *--wd*[=_directory_]"
30695msgstr ""
30696
30697#. type: Plain text
30698#: ../sys-utils/nsenter.1.adoc:120
30699msgid ""
30700"Set the working directory. If no directory is specified, set the working "
30701"directory to the working directory of the target process. If directory is "
30702"specified, set the working directory to the specified directory."
30703msgstr ""
30704
30705#. type: Plain text
30706#: ../sys-utils/nsenter.1.adoc:123
30707msgid ""
30708"Do not fork before exec'ing the specified program. By default, when entering "
30709"a PID namespace, *nsenter* calls *fork* before calling *exec* so that any "
30710"children will also be in the newly entered PID namespace."
30711msgstr ""
30712
30713#. type: Labeled list
30714#: ../sys-utils/nsenter.1.adoc:124
30715#, no-wrap
30716msgid "*-Z*, *--follow-context*"
30717msgstr ""
30718
30719#. type: Plain text
30720#: ../sys-utils/nsenter.1.adoc:126
30721msgid ""
30722"Set the SELinux security context used for executing a new process according "
30723"to already running process specified by *--target* PID. (The util-linux has "
30724"to be compiled with SELinux support otherwise the option is unavailable.)"
30725msgstr ""
30726
30727#. type: Plain text
30728#: ../sys-utils/nsenter.1.adoc:137
30729msgid ""
30730"mailto:biederm@xmission.com[Eric Biederman], mailto:kzak@redhat.com[Karel "
30731"Zak]"
30732msgstr ""
30733
30734#. type: Plain text
30735#: ../sys-utils/nsenter.1.adoc:143
30736#, no-wrap
30737msgid ""
30738"*clone*(2),\n"
30739"*setns*(2),\n"
30740"*namespaces*(7)\n"
30741msgstr ""
30742
30743#. type: Title =
30744#: ../sys-utils/pivot_root.8.adoc:2
30745#, no-wrap
30746msgid "pivot_root(8)"
30747msgstr ""
30748
30749#. type: Plain text
30750#: ../sys-utils/pivot_root.8.adoc:12
30751msgid "pivot_root - change the root filesystem"
30752msgstr ""
30753
30754#. type: Plain text
30755#: ../sys-utils/pivot_root.8.adoc:16
30756#, no-wrap
30757msgid "*pivot_root* _new_root_ _put_old_\n"
30758msgstr ""
30759
30760#. type: Plain text
30761#: ../sys-utils/pivot_root.8.adoc:20
30762#, no-wrap
30763msgid ""
30764"*pivot_root* moves the root file system of the current process to the "
30765"directory _put_old_ and makes _new_root_ the new root file system. Since "
30766"*pivot_root*(8) simply calls *pivot_root*(2), we refer to the man page of "
30767"the latter for further details.\n"
30768msgstr ""
30769
30770#. type: Plain text
30771#: ../sys-utils/pivot_root.8.adoc:22
30772msgid ""
30773"Note that, depending on the implementation of *pivot_root*, root and current "
30774"working directory of the caller may or may not change. The following is a "
30775"sequence for invoking *pivot_root* that works in either case, assuming that "
30776"*pivot_root* and *chroot* are in the current *PATH*:"
30777msgstr ""
30778
3a213557
MB
30779#. type: delimited block .
30780#: ../sys-utils/pivot_root.8.adoc:27
30781#, no-wrap
30782msgid ""
30783"cd new_root\n"
30784"pivot_root . put_old\n"
30785"exec chroot . command\n"
36e96905
MB
30786msgstr ""
30787
30788#. type: Plain text
3a213557 30789#: ../sys-utils/pivot_root.8.adoc:30
36e96905
MB
30790msgid ""
30791"Note that *chroot* must be available under the old root and under the new "
30792"root, because *pivot_root* may or may not have implicitly changed the root "
30793"directory of the shell."
30794msgstr ""
30795
30796#. type: Plain text
3a213557 30797#: ../sys-utils/pivot_root.8.adoc:32
36e96905
MB
30798msgid ""
30799"Note that *exec chroot* changes the running executable, which is necessary "
30800"if the old root directory should be unmounted afterwards. Also note that "
30801"standard input, output, and error may still point to a device on the old "
30802"root file system, keeping it busy. They can easily be changed when invoking "
30803"*chroot* (see below; note the absence of leading slashes to make it work "
30804"whether *pivot_root* has changed the shell's root or not)."
30805msgstr ""
30806
30807#. type: Plain text
3a213557 30808#: ../sys-utils/pivot_root.8.adoc:44
36e96905
MB
30809msgid "Change the root file system to _/dev/hda1_ from an interactive shell:"
30810msgstr ""
30811
30812#. type: delimited block .
3a213557 30813#: ../sys-utils/pivot_root.8.adoc:51
36e96905
MB
30814#, no-wrap
30815msgid ""
30816"mount /dev/hda1 /new-root\n"
30817"cd /new-root\n"
30818"pivot_root . old-root\n"
30819"exec chroot . sh <dev/console >dev/console 2>&1\n"
30820"umount /old-root\n"
30821msgstr ""
30822
30823#. type: Plain text
3a213557 30824#: ../sys-utils/pivot_root.8.adoc:54
36e96905
MB
30825msgid ""
30826"Mount the new root file system over NFS from 10.0.0.1:/my_root and run "
30827"*init*:"
30828msgstr ""
30829
30830#. type: delimited block .
3a213557 30831#: ../sys-utils/pivot_root.8.adoc:65
36e96905
MB
30832#, no-wrap
30833msgid ""
30834"ifconfig lo 127.0.0.1 up # for portmap\n"
30835"# configure Ethernet or such\n"
30836"portmap # for lockd (implicitly started by mount)\n"
30837"mount -o ro 10.0.0.1:/my_root /mnt\n"
30838"killall portmap # portmap keeps old root busy\n"
30839"cd /mnt\n"
30840"pivot_root . old_root\n"
30841"exec chroot . sh -c 'umount /old_root; exec /sbin/init' \\\n"
30842" <dev/console >dev/console 2>&1\n"
30843msgstr ""
30844
30845#. type: Plain text
3a213557 30846#: ../sys-utils/pivot_root.8.adoc:74
36e96905
MB
30847#, no-wrap
30848msgid ""
30849"*chroot*(1),\n"
30850"*pivot_root*(2),\n"
30851"*mount*(8),\n"
30852"*switch_root*(8),\n"
30853"*umount*(8)\n"
30854msgstr ""
30855
30856#. prlimit.1 --
30857#. Copyright 2011 Davidlohr Bueso <dave@gnu.org>
30858#. May be distributed under the GNU General Public License
30859#. type: Title =
30860#: ../sys-utils/prlimit.1.adoc:7
30861#, no-wrap
30862msgid "prlimit(1)"
30863msgstr ""
30864
30865#. type: Plain text
30866#: ../sys-utils/prlimit.1.adoc:18
30867msgid "prlimit - get and set process resource limits"
30868msgstr ""
30869
30870#. type: Plain text
30871#: ../sys-utils/prlimit.1.adoc:22
30872#, no-wrap
30873msgid "*prlimit* [options] [*--resource*=_limits_]] [*--pid* _PID_]\n"
30874msgstr ""
30875
30876#. type: Plain text
30877#: ../sys-utils/prlimit.1.adoc:24
30878#, no-wrap
30879msgid "*prlimit* [options] [*--resource*=_limits_]] _command_ [_argument_...]\n"
30880msgstr ""
30881
30882#. type: Plain text
30883#: ../sys-utils/prlimit.1.adoc:28
30884msgid ""
30885"Given a process ID and one or more resources, *prlimit* tries to retrieve "
30886"and/or modify the limits."
30887msgstr ""
30888
30889#. type: Plain text
30890#: ../sys-utils/prlimit.1.adoc:30
30891msgid ""
30892"When _command_ is given, *prlimit* will run this command with the given "
30893"arguments."
30894msgstr ""
30895
30896#. type: Plain text
30897#: ../sys-utils/prlimit.1.adoc:32
30898msgid ""
30899"The _limits_ parameter is composed of a soft and a hard value, separated by "
30900"a colon (:), in order to modify the existing values. If no _limits_ are "
30901"given, *prlimit* will display the current values. If one of the values is "
30902"not given, then the existing one will be used. To specify the unlimited or "
30903"infinity limit (*RLIM_INFINITY*), the -1 or 'unlimited' string can be "
30904"passed."
30905msgstr ""
30906
30907#. type: Plain text
30908#: ../sys-utils/prlimit.1.adoc:34
30909msgid ""
30910"Because of the nature of limits, the soft limit must be lower or equal to "
30911"the high limit (also called the ceiling). To see all available resource "
30912"limits, refer to the RESOURCE OPTIONS section."
30913msgstr ""
30914
30915#. TRANSLATORS: Keep {colon} untranslated.
30916#. type: Plain text
30917#: ../sys-utils/prlimit.1.adoc:37
30918msgid "_soft_{colon}_hard_ Specify both limits."
30919msgstr ""
30920
30921#. type: Plain text
30922#: ../sys-utils/prlimit.1.adoc:38
30923msgid "_soft_{colon} Specify only the soft limit."
30924msgstr ""
30925
30926#. type: Plain text
30927#: ../sys-utils/prlimit.1.adoc:39
30928msgid "{colon}__hard__ Specify only the hard limit."
30929msgstr ""
30930
30931#. type: Plain text
30932#: ../sys-utils/prlimit.1.adoc:40
30933msgid "_value_ Specify both limits to the same value."
30934msgstr ""
30935
30936#. type: Title ==
30937#: ../sys-utils/prlimit.1.adoc:41
30938#, no-wrap
30939msgid "GENERAL OPTIONS"
30940msgstr ""
30941
30942#. type: Labeled list
30943#: ../sys-utils/prlimit.1.adoc:43 ../sys-utils/switch_root.8.adoc:27
30944#: ../text-utils/column.1.adoc:138
30945#, no-wrap
30946msgid "*-h, --help*"
30947msgstr ""
30948
30949#. type: Labeled list
30950#: ../sys-utils/prlimit.1.adoc:49
30951#, no-wrap
30952msgid "*-o, --output* _list_"
30953msgstr ""
30954
30955#. type: Plain text
30956#: ../sys-utils/prlimit.1.adoc:51
30957msgid ""
30958"Define the output columns to use. If no output arrangement is specified, "
30959"then a default set is used. Use *--help* to get a list of all supported "
30960"columns."
30961msgstr ""
30962
30963#. type: Labeled list
30964#: ../sys-utils/prlimit.1.adoc:52
30965#, no-wrap
30966msgid "*-p, --pid*"
30967msgstr ""
30968
30969#. type: Plain text
30970#: ../sys-utils/prlimit.1.adoc:54
30971msgid "Specify the process id; if none is given, the running process will be used."
30972msgstr ""
30973
30974#. type: Labeled list
30975#: ../sys-utils/prlimit.1.adoc:61 ../sys-utils/switch_root.8.adoc:30
30976#, no-wrap
30977msgid "*-V, --version*"
30978msgstr ""
30979
30980#. type: Title ==
30981#: ../sys-utils/prlimit.1.adoc:64
30982#, no-wrap
30983msgid "RESOURCE OPTIONS"
30984msgstr ""
30985
30986#. type: Labeled list
30987#: ../sys-utils/prlimit.1.adoc:66
30988#, no-wrap
30989msgid "*-c, --core*[=_limits_]"
30990msgstr ""
30991
30992#. type: Plain text
30993#: ../sys-utils/prlimit.1.adoc:68
30994msgid "Maximum size of a core file."
30995msgstr ""
30996
30997#. type: Labeled list
30998#: ../sys-utils/prlimit.1.adoc:69
30999#, no-wrap
31000msgid "*-d, --data*[=_limits_]"
31001msgstr ""
31002
31003#. type: Plain text
31004#: ../sys-utils/prlimit.1.adoc:71
31005msgid "Maximum data size."
31006msgstr ""
31007
31008#. type: Labeled list
31009#: ../sys-utils/prlimit.1.adoc:72
31010#, no-wrap
31011msgid "*-e, --nice*[=_limits_]"
31012msgstr ""
31013
31014#. type: Plain text
31015#: ../sys-utils/prlimit.1.adoc:74
31016msgid "Maximum nice priority allowed to raise."
31017msgstr ""
31018
31019#. type: Labeled list
31020#: ../sys-utils/prlimit.1.adoc:75
31021#, no-wrap
31022msgid "*-f, --fsize*[=_limits_]"
31023msgstr ""
31024
31025#. type: Plain text
31026#: ../sys-utils/prlimit.1.adoc:77
31027msgid "Maximum file size."
31028msgstr ""
31029
31030#. type: Labeled list
31031#: ../sys-utils/prlimit.1.adoc:78
31032#, no-wrap
31033msgid "*-i, --sigpending*[=_limits_]"
31034msgstr ""
31035
31036#. type: Plain text
31037#: ../sys-utils/prlimit.1.adoc:80
31038msgid "Maximum number of pending signals."
31039msgstr ""
31040
31041#. type: Labeled list
31042#: ../sys-utils/prlimit.1.adoc:81
31043#, no-wrap
31044msgid "*-l, --memlock*[=_limits_]"
31045msgstr ""
31046
31047#. type: Plain text
31048#: ../sys-utils/prlimit.1.adoc:83
31049msgid "Maximum locked-in-memory address space."
31050msgstr ""
31051
31052#. type: Labeled list
31053#: ../sys-utils/prlimit.1.adoc:84
31054#, no-wrap
31055msgid "*-m, --rss*[=_limits_]"
31056msgstr ""
31057
31058#. type: Plain text
31059#: ../sys-utils/prlimit.1.adoc:86
31060msgid "Maximum Resident Set Size (RSS)."
31061msgstr ""
31062
31063#. type: Labeled list
31064#: ../sys-utils/prlimit.1.adoc:87
31065#, no-wrap
31066msgid "*-n, --nofile*[=_limits_]"
31067msgstr ""
31068
31069#. type: Plain text
31070#: ../sys-utils/prlimit.1.adoc:89
31071msgid "Maximum number of open files."
31072msgstr ""
31073
31074#. type: Labeled list
31075#: ../sys-utils/prlimit.1.adoc:90
31076#, no-wrap
31077msgid "*-q, --msgqueue*[=_limits_]"
31078msgstr ""
31079
31080#. type: Plain text
31081#: ../sys-utils/prlimit.1.adoc:92
31082msgid "Maximum number of bytes in POSIX message queues."
31083msgstr ""
31084
31085#. type: Labeled list
31086#: ../sys-utils/prlimit.1.adoc:93
31087#, no-wrap
31088msgid "*-r, --rtprio*[=_limits_]"
31089msgstr ""
31090
31091#. type: Plain text
31092#: ../sys-utils/prlimit.1.adoc:95
31093msgid "Maximum real-time priority."
31094msgstr ""
31095
31096#. type: Labeled list
31097#: ../sys-utils/prlimit.1.adoc:96
31098#, no-wrap
31099msgid "*-s, --stack*[=_limits_]"
31100msgstr ""
31101
31102#. type: Plain text
31103#: ../sys-utils/prlimit.1.adoc:98
31104msgid "Maximum size of the stack."
31105msgstr ""
31106
31107#. type: Labeled list
31108#: ../sys-utils/prlimit.1.adoc:99
31109#, no-wrap
31110msgid "*-t, --cpu*[=_limits_]"
31111msgstr ""
31112
31113#. type: Plain text
31114#: ../sys-utils/prlimit.1.adoc:101
31115msgid "CPU time, in seconds."
31116msgstr ""
31117
31118#. type: Labeled list
31119#: ../sys-utils/prlimit.1.adoc:102
31120#, no-wrap
31121msgid "*-u, --nproc*[=_limits_]"
31122msgstr ""
31123
31124#. type: Plain text
31125#: ../sys-utils/prlimit.1.adoc:104
31126msgid "Maximum number of processes."
31127msgstr ""
31128
31129#. type: Labeled list
31130#: ../sys-utils/prlimit.1.adoc:105
31131#, no-wrap
31132msgid "*-v, --as*[=_limits_]"
31133msgstr ""
31134
31135#. type: Plain text
31136#: ../sys-utils/prlimit.1.adoc:107
31137msgid "Address space limit."
31138msgstr ""
31139
31140#. type: Labeled list
31141#: ../sys-utils/prlimit.1.adoc:108
31142#, no-wrap
31143msgid "*-x, --locks*[=_limits_]"
31144msgstr ""
31145
31146#. type: Plain text
31147#: ../sys-utils/prlimit.1.adoc:110
31148msgid "Maximum number of file locks held."
31149msgstr ""
31150
31151#. type: Labeled list
31152#: ../sys-utils/prlimit.1.adoc:111
31153#, no-wrap
31154msgid "*-y, --rttime*[=_limits_]"
31155msgstr ""
31156
31157#. type: Plain text
31158#: ../sys-utils/prlimit.1.adoc:113
31159msgid "Timeout for real-time tasks."
31160msgstr ""
31161
31162#. type: Plain text
31163#: ../sys-utils/prlimit.1.adoc:117
31164msgid ""
31165"The *prlimit* system call is supported since Linux 2.6.36, older kernels "
31166"will break this program."
31167msgstr ""
31168
31169#. type: Labeled list
31170#: ../sys-utils/prlimit.1.adoc:120
31171#, no-wrap
31172msgid "*prlimit --pid 13134*"
31173msgstr ""
31174
31175#. type: Plain text
31176#: ../sys-utils/prlimit.1.adoc:122
31177msgid "Display limit values for all current resources."
31178msgstr ""
31179
31180#. type: Labeled list
31181#: ../sys-utils/prlimit.1.adoc:123
31182#, no-wrap
31183msgid "*prlimit --pid 13134 --rss --nofile=1024:4095*"
31184msgstr ""
31185
31186#. type: Plain text
31187#: ../sys-utils/prlimit.1.adoc:125
31188msgid ""
31189"Display the limits of the RSS, and set the soft and hard limits for the "
31190"number of open files to 1024 and 4095, respectively."
31191msgstr ""
31192
31193#. type: Labeled list
31194#: ../sys-utils/prlimit.1.adoc:126
31195#, no-wrap
31196msgid "*prlimit --pid 13134 --nproc=512:*"
31197msgstr ""
31198
31199#. type: Plain text
31200#: ../sys-utils/prlimit.1.adoc:128
31201msgid "Modify only the soft limit for the number of processes."
31202msgstr ""
31203
31204#. type: Labeled list
31205#: ../sys-utils/prlimit.1.adoc:129
31206#, no-wrap
31207msgid "*prlimit --pid $$ --nproc=unlimited*"
31208msgstr ""
31209
31210#. type: Plain text
31211#: ../sys-utils/prlimit.1.adoc:131
31212msgid ""
31213"Set for the current process both the soft and ceiling values for the number "
31214"of processes to unlimited."
31215msgstr ""
31216
31217#. type: Labeled list
31218#: ../sys-utils/prlimit.1.adoc:132
31219#, no-wrap
31220msgid "*prlimit --cpu=10 sort -u hugefile*"
31221msgstr ""
31222
31223#. type: Plain text
31224#: ../sys-utils/prlimit.1.adoc:134
31225msgid "Set both the soft and hard CPU time limit to ten seconds and run 'sort'."
31226msgstr ""
31227
31228#. type: Plain text
31229#: ../sys-utils/prlimit.1.adoc:138
31230msgid "mailto:dave@gnu.org[Davidlohr Bueso] - In memory of Dennis M. Ritchie."
31231msgstr ""
31232
31233#. type: Plain text
31234#: ../sys-utils/prlimit.1.adoc:143
31235#, no-wrap
31236msgid ""
31237"*ulimit*(1p),\n"
31238"*prlimit*(2)\n"
31239msgstr ""
31240
31241#. type: Title =
31242#: ../sys-utils/readprofile.8.adoc:2
31243#, no-wrap
31244msgid "readprofile(8)"
31245msgstr ""
31246
31247#. type: Plain text
31248#: ../sys-utils/readprofile.8.adoc:12
31249msgid "readprofile - read kernel profiling information"
31250msgstr ""
31251
31252#. type: Plain text
31253#: ../sys-utils/readprofile.8.adoc:16
31254#, no-wrap
31255msgid "*readprofile* [options]\n"
31256msgstr ""
31257
31258#. type: Title ==
31259#: ../sys-utils/readprofile.8.adoc:17
31260#, no-wrap
31261msgid "VERSION"
31262msgstr ""
31263
31264#. type: Plain text
31265#: ../sys-utils/readprofile.8.adoc:20
31266msgid "This manpage documents version 2.0 of the program."
31267msgstr ""
31268
31269#. type: Plain text
31270#: ../sys-utils/readprofile.8.adoc:24
31271msgid ""
31272"The *readprofile* command uses the _/proc/profile_ information to print "
31273"ascii data on standard output. The output is organized in three columns: the "
31274"first is the number of clock ticks, the second is the name of the C function "
31275"in the kernel where those many ticks occurred, and the third is the "
31276"normalized `load' of the procedure, calculated as a ratio between the number "
31277"of ticks and the length of the procedure. The output is filled with blanks "
31278"to ease readability."
31279msgstr ""
31280
31281#. type: Plain text
31282#: ../sys-utils/readprofile.8.adoc:29
31283msgid ""
31284"Print all symbols in the mapfile. By default the procedures with reported "
31285"ticks are not printed."
31286msgstr ""
31287
31288#. type: Labeled list
31289#: ../sys-utils/readprofile.8.adoc:30
31290#, no-wrap
31291msgid "*-b*, *--histbin*"
31292msgstr ""
31293
31294#. type: Plain text
31295#: ../sys-utils/readprofile.8.adoc:32
31296msgid "Print individual histogram-bin counts."
31297msgstr ""
31298
31299#. type: Plain text
31300#: ../sys-utils/readprofile.8.adoc:35
31301msgid ""
31302"Info. This makes *readprofile* only print the profiling step used by the "
31303"kernel. The profiling step is the resolution of the profiling buffer, and is "
31304"chosen during kernel configuration (through *make config*), or in the "
31305"kernel's command line. If the *-t* (terse) switch is used together with *-i* "
31306"only the decimal number is printed."
31307msgstr ""
31308
31309#. type: Labeled list
31310#: ../sys-utils/readprofile.8.adoc:36
31311#, no-wrap
31312msgid "*-m*, *--mapfile* _mapfile_"
31313msgstr ""
31314
31315#. type: Plain text
31316#: ../sys-utils/readprofile.8.adoc:38
31317msgid ""
31318"Specify a mapfile, which by default is _/usr/src/linux/System.map_. You "
31319"should specify the map file on cmdline if your current kernel isn't the last "
31320"one you compiled, or if you keep System.map elsewhere. If the name of the "
31321"map file ends with _.gz_ it is decompressed on the fly."
31322msgstr ""
31323
31324#. type: Labeled list
31325#: ../sys-utils/readprofile.8.adoc:39
31326#, no-wrap
31327msgid "*-M*, *--multiplier* _multiplier_"
31328msgstr ""
31329
31330#. type: Plain text
31331#: ../sys-utils/readprofile.8.adoc:41
31332msgid ""
31333"On some architectures it is possible to alter the frequency at which the "
31334"kernel delivers profiling interrupts to each CPU. This option allows you to "
31335"set the frequency, as a multiplier of the system clock frequency, HZ. Linux "
31336"2.6.16 dropped multiplier support for most systems. This option also resets "
31337"the profiling buffer, and requires superuser privileges."
31338msgstr ""
31339
31340#. type: Labeled list
31341#: ../sys-utils/readprofile.8.adoc:42
31342#, no-wrap
31343msgid "*-p*, *--profile* _pro-file_"
31344msgstr ""
31345
31346#. type: Plain text
31347#: ../sys-utils/readprofile.8.adoc:44
31348msgid ""
31349"Specify a different profiling buffer, which by default is "
31350"_/proc/profile_. Using a different pro-file is useful if you want to "
31351"`freeze' the kernel profiling at some time and read it later. The "
31352"_/proc/profile_ file can be copied using *cat*(1) or *cp*(1). There is no "
31353"more support for compressed profile buffers, like in *readprofile-1.1*, "
31354"because the program needs to know the size of the buffer in advance."
31355msgstr ""
31356
31357#. type: Labeled list
31358#: ../sys-utils/readprofile.8.adoc:45 ../sys-utils/tunelp.8.adoc:53
31359#: ../sys-utils/zramctl.8.adoc:59
31360#, no-wrap
31361msgid "*-r*, *--reset*"
31362msgstr ""
31363
31364#. type: Plain text
31365#: ../sys-utils/readprofile.8.adoc:47
31366msgid ""
31367"Reset the profiling buffer. This can only be invoked by root, because "
31368"_/proc/profile_ is readable by everybody but writable only by the "
31369"superuser. However, you can make *readprofile* set-user-ID 0, in order to "
31370"reset the buffer without gaining privileges."
31371msgstr ""
31372
31373#. type: Labeled list
31374#: ../sys-utils/readprofile.8.adoc:48
31375#, no-wrap
31376msgid "*-s, --counters*"
31377msgstr ""
31378
31379#. type: Plain text
31380#: ../sys-utils/readprofile.8.adoc:50
31381msgid "Print individual counters within functions."
31382msgstr ""
31383
31384#. type: Plain text
31385#: ../sys-utils/readprofile.8.adoc:53
31386msgid ""
31387"Verbose. The output is organized in four columns and filled with blanks. The "
31388"first column is the RAM address of a kernel function, the second is the name "
31389"of the function, the third is the number of clock ticks and the last is the "
31390"normalized load."
31391msgstr ""
31392
31393#. type: Labeled list
31394#: ../sys-utils/readprofile.8.adoc:62
31395#, no-wrap
31396msgid "_/proc/profile_"
31397msgstr ""
31398
31399#. type: Plain text
31400#: ../sys-utils/readprofile.8.adoc:64
31401msgid "A binary snapshot of the profiling buffer."
31402msgstr ""
31403
31404#. type: Labeled list
31405#: ../sys-utils/readprofile.8.adoc:65
31406#, no-wrap
31407msgid "_/usr/src/linux/System.map_"
31408msgstr ""
31409
31410#. type: Plain text
31411#: ../sys-utils/readprofile.8.adoc:67
31412msgid "The symbol table for the kernel."
31413msgstr ""
31414
31415#. type: Labeled list
31416#: ../sys-utils/readprofile.8.adoc:68
31417#, no-wrap
31418msgid "_/usr/src/linux/*_"
31419msgstr ""
31420
31421#. type: Plain text
31422#: ../sys-utils/readprofile.8.adoc:70
31423msgid "The program being profiled :-)"
31424msgstr ""
31425
31426#. type: Plain text
31427#: ../sys-utils/readprofile.8.adoc:74
31428#, no-wrap
31429msgid ""
31430"*readprofile* only works with a 1.3.x or newer kernel, because "
31431"_/proc/profile_ changed in the step from 1.2 to 1.3.\n"
31432msgstr ""
31433
31434#. type: Plain text
31435#: ../sys-utils/readprofile.8.adoc:76
31436msgid ""
31437"This program only works with ELF kernels. The change for a.out kernels is "
31438"trivial, and left as an exercise to the a.out user."
31439msgstr ""
31440
31441#. type: Plain text
31442#: ../sys-utils/readprofile.8.adoc:78
31443msgid ""
31444"To enable profiling, the kernel must be rebooted, because no profiling "
31445"module is available, and it wouldn't be easy to build. To enable profiling, "
31446"you can specify *profile*=_2_ (or another number) on the kernel "
31447"commandline. The number you specify is the two-exponent used as profiling "
31448"step."
31449msgstr ""
31450
31451#. type: Plain text
31452#: ../sys-utils/readprofile.8.adoc:80
31453msgid ""
31454"Profiling is disabled when interrupts are inhibited. This means that many "
31455"profiling ticks happen when interrupts are re-enabled. Watch out for "
31456"misleading information."
31457msgstr ""
31458
31459#. type: Plain text
31460#: ../sys-utils/readprofile.8.adoc:84
31461msgid "Browse the profiling buffer ordering by clock ticks:"
31462msgstr ""
31463
31464#. type: delimited block .
31465#: ../sys-utils/readprofile.8.adoc:87
31466#, no-wrap
31467msgid " readprofile | sort -nr | less\n"
31468msgstr ""
31469
31470#. type: Plain text
31471#: ../sys-utils/readprofile.8.adoc:90
31472msgid "Print the 20 most loaded procedures:"
31473msgstr ""
31474
31475#. type: delimited block .
31476#: ../sys-utils/readprofile.8.adoc:93
31477#, no-wrap
31478msgid " readprofile | sort -nr +2 | head -20\n"
31479msgstr ""
31480
31481#. type: Plain text
31482#: ../sys-utils/readprofile.8.adoc:96
31483msgid "Print only filesystem profile:"
31484msgstr ""
31485
31486#. type: delimited block .
31487#: ../sys-utils/readprofile.8.adoc:99
31488#, no-wrap
31489msgid " readprofile | grep _ext2\n"
31490msgstr ""
31491
31492#. type: Plain text
31493#: ../sys-utils/readprofile.8.adoc:102
31494msgid "Look at all the kernel information, with ram addresses:"
31495msgstr ""
31496
31497#. type: delimited block .
31498#: ../sys-utils/readprofile.8.adoc:105
31499#, no-wrap
31500msgid " readprofile -av | less\n"
31501msgstr ""
31502
31503#. type: Plain text
31504#: ../sys-utils/readprofile.8.adoc:108
31505msgid "Browse a 'frozen' profile buffer for a non current kernel:"
31506msgstr ""
31507
31508#. type: delimited block .
31509#: ../sys-utils/readprofile.8.adoc:111
31510#, no-wrap
31511msgid " readprofile -p ~/profile.freeze -m /zImage.map.gz\n"
31512msgstr ""
31513
31514#. type: Plain text
31515#: ../sys-utils/readprofile.8.adoc:114
31516msgid "Request profiling at 2kHz per CPU, and reset the profiling buffer:"
31517msgstr ""
31518
31519#. type: delimited block .
31520#: ../sys-utils/readprofile.8.adoc:117
31521#, no-wrap
31522msgid " sudo readprofile -M 20\n"
31523msgstr ""
31524
31525#. Copyright (c) 1983, 1991, 1993
31526#. The Regents of the University of California. All rights reserved.
31527#
31528#. Redistribution and use in source and binary forms, with or without
31529#. modification, are permitted provided that the following conditions
31530#. are met:
31531#. 1. Redistributions of source code must retain the above copyright
31532#. notice, this list of conditions and the following disclaimer.
31533#. 2. Redistributions in binary form must reproduce the above copyright
31534#. notice, this list of conditions and the following disclaimer in the
31535#. documentation and/or other materials provided with the distribution.
31536#. 3. All advertising materials mentioning features or use of this software
31537#. must display the following acknowledgement:
31538#. This product includes software developed by the University of
31539#. California, Berkeley and its contributors.
31540#. 4. Neither the name of the University nor the names of its contributors
31541#. may be used to endorse or promote products derived from this software
31542#. without specific prior written permission.
31543#
31544#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
31545#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
31546#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31547#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
31548#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31549#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31550#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31551#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31552#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31553#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31554#. SUCH DAMAGE.
31555#
31556#. @(#)renice.8 8.1 (Berkeley) 6/9/93
31557#. type: Title =
31558#: ../sys-utils/renice.1.adoc:36
31559#, no-wrap
31560msgid "renice(1)"
31561msgstr ""
31562
31563#. type: Plain text
31564#: ../sys-utils/renice.1.adoc:46
31565msgid "renice - alter priority of running processes"
31566msgstr ""
31567
31568#. type: Plain text
31569#: ../sys-utils/renice.1.adoc:50
31570#, no-wrap
31571msgid "*renice* [*-n*] _priority_ [*-g*|*-p*|*-u*] _identifier_...\n"
31572msgstr ""
31573
31574#. type: Plain text
31575#: ../sys-utils/renice.1.adoc:54
31576#, no-wrap
31577msgid ""
31578"*renice* alters the scheduling priority of one or more running "
31579"processes. The first argument is the _priority_ value to be used. The other "
31580"arguments are interpreted as process IDs (by default), process group IDs, "
31581"user IDs, or user names. *renice*'ing a process group causes all processes "
31582"in the process group to have their scheduling priority altered. *renice*'ing "
31583"a user causes all processes owned by the user to have their scheduling "
31584"priority altered.\n"
31585msgstr ""
31586
31587#. type: Labeled list
31588#: ../sys-utils/renice.1.adoc:57
31589#, no-wrap
31590msgid "*-n*, *--priority* _priority_"
31591msgstr ""
31592
31593#. type: Plain text
31594#: ../sys-utils/renice.1.adoc:59
31595msgid ""
31596"Specify the scheduling _priority_ to be used for the process, process group, "
31597"or user. Use of the option *-n* or *--priority* is optional, but when used "
31598"it must be the first argument."
31599msgstr ""
31600
31601#. type: Labeled list
31602#: ../sys-utils/renice.1.adoc:60
31603#, no-wrap
31604msgid "*-g*, *--pgrp*"
31605msgstr ""
31606
31607#. type: Plain text
31608#: ../sys-utils/renice.1.adoc:62
31609msgid "Interpret the succeeding arguments as process group IDs."
31610msgstr ""
31611
31612#. type: Plain text
31613#: ../sys-utils/renice.1.adoc:65
31614msgid "Interpret the succeeding arguments as process IDs (the default)."
31615msgstr ""
31616
31617#. type: Labeled list
31618#: ../sys-utils/renice.1.adoc:66
31619#, no-wrap
31620msgid "*-u*, *--user*"
31621msgstr ""
31622
31623#. type: Plain text
31624#: ../sys-utils/renice.1.adoc:68
31625msgid "Interpret the succeeding arguments as usernames or UIDs."
31626msgstr ""
31627
31628#. type: Labeled list
31629#: ../sys-utils/renice.1.adoc:77
31630#, no-wrap
31631msgid "_/etc/passwd_"
31632msgstr ""
31633
31634#. type: Plain text
31635#: ../sys-utils/renice.1.adoc:79
31636msgid "to map user names to user IDs"
31637msgstr ""
31638
31639#. type: Plain text
31640#: ../sys-utils/renice.1.adoc:83
31641msgid ""
31642"Users other than the superuser may only alter the priority of processes they "
31643"own. Furthermore, an unprivileged user can only _increase_ the \"nice "
31644"value\" (i.e., choose a lower priority) and such changes are irreversible "
31645"unless (since Linux 2.6.12) the user has a suitable \"nice\" resource limit "
31646"(see *ulimit*(1p) and *getrlimit*(2))."
31647msgstr ""
31648
31649#. type: Plain text
31650#: ../sys-utils/renice.1.adoc:85
31651msgid ""
31652"The superuser may alter the priority of any process and set the priority to "
31653"any value in the range -20 to 19. Useful priorities are: 19 (the affected "
31654"processes will run only when nothing else in the system wants to), 0 (the "
31655"\"base\" scheduling priority), anything negative (to make things go very "
31656"fast)."
31657msgstr ""
31658
31659#. type: Plain text
31660#: ../sys-utils/renice.1.adoc:89
31661msgid "The *renice* command appeared in 4.0BSD."
31662msgstr ""
31663
31664#. type: Plain text
31665#: ../sys-utils/renice.1.adoc:93
31666msgid ""
31667"The following command would change the priority of the processes with PIDs "
31668"987 and 32, plus all processes owned by the users daemon and root:"
31669msgstr ""
31670
31671#. type: Plain text
31672#: ../sys-utils/renice.1.adoc:95
31673#, no-wrap
31674msgid "*renice +1 987 -u daemon root -p 32*\n"
31675msgstr ""
31676
31677#. type: Plain text
31678#: ../sys-utils/renice.1.adoc:104
31679#, no-wrap
31680msgid ""
31681"*nice*(1),\n"
31682"*chrt*(1),\n"
31683"*getpriority*(2),\n"
31684"*setpriority*(2),\n"
31685"*credentials*(7),\n"
31686"*sched*(7)\n"
31687msgstr ""
31688
31689#. type: Title =
31690#: ../sys-utils/rfkill.8.adoc:2
31691#, no-wrap
31692msgid "rfkill(8)"
31693msgstr ""
31694
31695#. type: Plain text
31696#: ../sys-utils/rfkill.8.adoc:12
31697msgid "rfkill - tool for enabling and disabling wireless devices"
31698msgstr ""
31699
31700#. type: Plain text
31701#: ../sys-utils/rfkill.8.adoc:16
31702#, no-wrap
31703msgid "*rfkill* [options] [_command_] [_ID_|_type_ ...]\n"
31704msgstr ""
31705
31706#. type: Plain text
31707#: ../sys-utils/rfkill.8.adoc:20
31708#, no-wrap
31709msgid "*rfkill* lists, enabling and disabling wireless devices.\n"
31710msgstr ""
31711
31712#. type: Plain text
31713#: ../sys-utils/rfkill.8.adoc:22
31714msgid ""
31715"The command \"list\" output format is deprecated and maintained for backward "
31716"compatibility only. The new output format is the default when no command is "
31717"specified or when the option *--output* is used."
31718msgstr ""
31719
31720#. type: Plain text
31721#: ../sys-utils/rfkill.8.adoc:35
31722msgid ""
31723"Specify which output columns to print. Use *--help* to get a list of "
31724"available columns."
31725msgstr ""
31726
31727#. type: Labeled list
31728#: ../sys-utils/rfkill.8.adoc:50
31729#, no-wrap
31730msgid "*help*"
31731msgstr ""
31732
31733#. type: Labeled list
31734#: ../sys-utils/rfkill.8.adoc:53
31735#, no-wrap
31736msgid "*event*"
31737msgstr ""
31738
31739#. type: Plain text
31740#: ../sys-utils/rfkill.8.adoc:55
31741msgid "Listen for rfkill events and display them on stdout."
31742msgstr ""
31743
31744#. type: Labeled list
31745#: ../sys-utils/rfkill.8.adoc:56
31746#, no-wrap
31747msgid "*list* [__id__|_type_ ...]"
31748msgstr ""
31749
31750#. type: Plain text
31751#: ../sys-utils/rfkill.8.adoc:58
31752msgid ""
31753"List the current state of all available devices. The command output format "
31754"is deprecated, see the section DESCRIPTION. It is a good idea to check with "
31755"*list* command _id_ or _type_ scope is appropriate before setting *block* or "
31756"*unblock*. Special _all_ type string will match everything. Use of multiple "
31757"_ID_ or _type_ arguments is supported."
31758msgstr ""
31759
31760#. type: Labeled list
31761#: ../sys-utils/rfkill.8.adoc:59
31762#, no-wrap
31763msgid "**block id**|*type* [...]"
31764msgstr ""
31765
31766#. type: Plain text
31767#: ../sys-utils/rfkill.8.adoc:61
31768msgid "Disable the corresponding device."
31769msgstr ""
31770
31771#. type: Labeled list
31772#: ../sys-utils/rfkill.8.adoc:62
31773#, no-wrap
31774msgid "**unblock id**|*type* [...]"
31775msgstr ""
31776
31777#. type: Plain text
31778#: ../sys-utils/rfkill.8.adoc:64
31779msgid ""
31780"Enable the corresponding device. If the device is hard-blocked, for example "
31781"via a hardware switch, it will remain unavailable though it is now "
31782"soft-unblocked."
31783msgstr ""
31784
31785#. type: Labeled list
31786#: ../sys-utils/rfkill.8.adoc:65
31787#, no-wrap
31788msgid "**toggle id**|*type* [...]"
31789msgstr ""
31790
31791#. type: Plain text
31792#: ../sys-utils/rfkill.8.adoc:67
5db1d29a 31793msgid "Enable or disable the corresponding device."
36e96905
MB
31794msgstr ""
31795
31796#. type: delimited block .
31797#: ../sys-utils/rfkill.8.adoc:74
31798#, no-wrap
31799msgid ""
31800" rfkill --output ID,TYPE\n"
31801" rfkill block all\n"
31802" rfkill unblock wlan\n"
31803" rfkill block bluetooth uwb wimax wwan gps fm nfc\n"
31804msgstr ""
31805
31806#. type: Plain text
31807#: ../sys-utils/rfkill.8.adoc:79
31808#, no-wrap
31809msgid ""
31810"*rfkill* was originally written by mailto:johannes@sipsolutions.net[Johannes "
31811"Berg] and mailto:marcel@holtmann.org[Marcel Holtmann]. The code has been "
31812"later modified by mailto:kerolasa@iki.fi[Sami Kerola] and "
31813"mailto:kzak@redhat.com[Karel Zak] for the util-linux project.\n"
31814msgstr ""
31815
31816#. type: Plain text
31817#: ../sys-utils/rfkill.8.adoc:81
31818msgid ""
31819"This manual page was written by "
31820"mailto:linux@youmustbejoking.demon.co.uk[Darren Salt] for the Debian project "
31821"(and may be used by others)."
31822msgstr ""
31823
31824#. type: Plain text
31825#: ../sys-utils/rfkill.8.adoc:87
31826#, no-wrap
31827msgid ""
31828"*powertop*(8),\n"
31829"*systemd-rfkill*(8),\n"
31830"https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/driver-api/rfkill.rst[Linux "
31831"kernel documentation]\n"
31832msgstr ""
31833
31834#. type: Title =
31835#: ../sys-utils/rtcwake.8.adoc:2
31836#, no-wrap
31837msgid "rtcwake(8)"
31838msgstr ""
31839
31840#. type: Plain text
31841#: ../sys-utils/rtcwake.8.adoc:12
31842msgid "rtcwake - enter a system sleep state until specified wakeup time"
31843msgstr ""
31844
31845#. type: Plain text
31846#: ../sys-utils/rtcwake.8.adoc:16
31847#, no-wrap
31848msgid ""
31849"*rtcwake* [options] [*-d* _device_] [*-m* _standby_mode_] {*-s* "
31850"_seconds_|*-t* _time_t_}\n"
31851msgstr ""
31852
31853#. type: Plain text
31854#: ../sys-utils/rtcwake.8.adoc:20
31855msgid ""
31856"This program is used to enter a system sleep state and to automatically wake "
31857"from it at a specified time."
31858msgstr ""
31859
31860#. type: Plain text
31861#: ../sys-utils/rtcwake.8.adoc:22
31862msgid ""
31863"This uses cross-platform Linux interfaces to enter a system sleep state, and "
31864"leave it no later than a specified time. It uses any RTC framework driver "
31865"that supports standard driver model wakeup flags."
31866msgstr ""
31867
31868#. type: Plain text
31869#: ../sys-utils/rtcwake.8.adoc:24
31870msgid ""
31871"This is normally used like the old *apmsleep* utility, to wake from a "
31872"suspend state like ACPI S1 (standby) or S3 (suspend-to-RAM). Most platforms "
31873"can implement those without analogues of BIOS, APM, or ACPI."
31874msgstr ""
31875
31876#. type: Plain text
31877#: ../sys-utils/rtcwake.8.adoc:26
31878msgid ""
31879"On some systems, this can also be used like *nvram-wakeup*, waking from "
31880"states like ACPI S4 (suspend to disk). Not all systems have persistent media "
31881"that are appropriate for such suspend modes."
31882msgstr ""
31883
31884#. type: Plain text
31885#: ../sys-utils/rtcwake.8.adoc:28
31886msgid ""
31887"Note that alarm functionality depends on hardware; not every RTC is able to "
31888"setup an alarm up to 24 hours in the future."
31889msgstr ""
31890
31891#. type: Plain text
31892#: ../sys-utils/rtcwake.8.adoc:30
31893msgid ""
31894"The suspend setup may be interrupted by active hardware; for example "
31895"wireless USB input devices that continue to send events for some fraction of "
31896"a second after the return key is pressed. *rtcwake* tries to avoid this "
31897"problem and it waits to terminal to settle down before entering a system "
31898"sleep."
31899msgstr ""
31900
31901#. type: Labeled list
31902#: ../sys-utils/rtcwake.8.adoc:33
31903#, no-wrap
31904msgid "*-A*, *--adjfile* _file_"
31905msgstr ""
31906
31907#. type: Plain text
31908#: ../sys-utils/rtcwake.8.adoc:35
31909msgid "Specify an alternative path to the adjust file."
31910msgstr ""
31911
31912#. type: Plain text
31913#: ../sys-utils/rtcwake.8.adoc:38
31914msgid ""
31915"Read the clock mode (whether the hardware clock is set to UTC or local time) "
31916"from the _adjtime_ file, where *hwclock*(8) stores that information. This is "
31917"the default."
31918msgstr ""
31919
31920#. type: Labeled list
31921#: ../sys-utils/rtcwake.8.adoc:39
31922#, no-wrap
31923msgid "*--date* _timestamp_"
31924msgstr ""
31925
31926#. type: Plain text
31927#: ../sys-utils/rtcwake.8.adoc:41
31928msgid ""
31929"Set the wakeup time to the value of the timestamp. Format of the timestamp "
31930"can be any of the following:"
31931msgstr ""
31932
31933#. type: Table
31934#: ../sys-utils/rtcwake.8.adoc:52
31935#, no-wrap
31936msgid ""
31937"|YYYYMMDDhhmmss |\n"
31938"|YYYY-MM-DD hh:mm:ss |\n"
31939"|YYYY-MM-DD hh:mm |(seconds will be set to 00)\n"
31940"|YYYY-MM-DD |(time will be set to 00:00:00)\n"
31941"|hh:mm:ss |(date will be set to today)\n"
31942"|hh:mm |(date will be set to today, seconds to 00)\n"
31943"|tomorrow |(time is set to 00:00:00)\n"
31944"|+5min |\n"
31945msgstr ""
31946
31947#. type: Labeled list
31948#: ../sys-utils/rtcwake.8.adoc:54
31949#, no-wrap
31950msgid "*-d*, *--device* _device_"
31951msgstr ""
31952
31953#. type: Plain text
31954#: ../sys-utils/rtcwake.8.adoc:56
31955msgid ""
31956"Use the specified _device_ instead of *rtc0* as realtime clock. This option "
31957"is only relevant if your system has more than one RTC. You may specify "
31958"*rtc1*, *rtc2*, ... here."
31959msgstr ""
31960
31961#. type: Labeled list
31962#: ../sys-utils/rtcwake.8.adoc:57
31963#, no-wrap
31964msgid "*-l*, *--local*"
31965msgstr ""
31966
31967#. type: Plain text
31968#: ../sys-utils/rtcwake.8.adoc:59
31969msgid ""
31970"Assume that the hardware clock is set to local time, regardless of the "
31971"contents of the _adjtime_ file."
31972msgstr ""
31973
31974#. type: Labeled list
31975#: ../sys-utils/rtcwake.8.adoc:60
31976#, no-wrap
31977msgid "*--list-modes*"
31978msgstr ""
31979
31980#. type: Plain text
31981#: ../sys-utils/rtcwake.8.adoc:62
31982msgid "List available *--mode* option arguments."
31983msgstr ""
31984
31985#. type: Labeled list
31986#: ../sys-utils/rtcwake.8.adoc:63
31987#, no-wrap
31988msgid "*-m*, *--mode* _mode_"
31989msgstr ""
31990
31991#. type: Plain text
31992#: ../sys-utils/rtcwake.8.adoc:65
31993msgid "Go into the given standby state. Valid values for _mode_ are:"
31994msgstr ""
31995
31996#. type: Labeled list
31997#: ../sys-utils/rtcwake.8.adoc:66
31998#, no-wrap
31999msgid "*standby*"
32000msgstr ""
32001
32002#. type: Plain text
32003#: ../sys-utils/rtcwake.8.adoc:68
32004msgid ""
32005"ACPI state S1. This state offers minimal, though real, power savings, while "
32006"providing a very low-latency transition back to a working system. This is "
32007"the default mode."
32008msgstr ""
32009
32010#. type: Labeled list
32011#: ../sys-utils/rtcwake.8.adoc:69
32012#, no-wrap
32013msgid "*freeze*"
32014msgstr ""
32015
32016#. type: Plain text
32017#: ../sys-utils/rtcwake.8.adoc:71
32018msgid ""
32019"The processes are frozen, all the devices are suspended and all the "
32020"processors idled. This state is a general state that does not need any "
32021"platform-specific support, but it saves less power than Suspend-to-RAM, "
32022"because the system is still in a running state. (Available since Linux 3.9.)"
32023msgstr ""
32024
32025#. type: Labeled list
32026#: ../sys-utils/rtcwake.8.adoc:72
32027#, no-wrap
32028msgid "*mem*"
32029msgstr ""
32030
32031#. type: Plain text
32032#: ../sys-utils/rtcwake.8.adoc:74
32033msgid ""
32034"ACPI state S3 (Suspend-to-RAM). This state offers significant power savings "
32035"as everything in the system is put into a low-power state, except for "
32036"memory, which is placed in self-refresh mode to retain its contents."
32037msgstr ""
32038
32039#. type: Labeled list
32040#: ../sys-utils/rtcwake.8.adoc:75
32041#, no-wrap
32042msgid "*disk*"
32043msgstr ""
32044
32045#. type: Plain text
32046#: ../sys-utils/rtcwake.8.adoc:77
32047msgid ""
32048"ACPI state S4 (Suspend-to-disk). This state offers the greatest power "
32049"savings, and can be used even in the absence of low-level platform support "
32050"for power management. This state operates similarly to Suspend-to-RAM, but "
32051"includes a final step of writing memory contents to disk."
32052msgstr ""
32053
32054#. type: Labeled list
32055#: ../sys-utils/rtcwake.8.adoc:78 ../term-utils/setterm.1.adoc:124
32056#, no-wrap
32057msgid "*off*"
32058msgstr ""
32059
32060#. type: Plain text
32061#: ../sys-utils/rtcwake.8.adoc:80
32062msgid ""
32063"ACPI state S5 (Poweroff). This is done by calling '/sbin/shutdown'. Not "
32064"officially supported by ACPI, but it usually works."
32065msgstr ""
32066
32067#. type: Labeled list
32068#: ../sys-utils/rtcwake.8.adoc:81
32069#, no-wrap
32070msgid "*no*"
32071msgstr ""
32072
32073#. type: Plain text
32074#: ../sys-utils/rtcwake.8.adoc:83
32075msgid "Don't suspend, only set the RTC wakeup time."
32076msgstr ""
32077
32078#. type: Labeled list
32079#: ../sys-utils/rtcwake.8.adoc:84
32080#, no-wrap
32081msgid "*on*"
32082msgstr ""
32083
32084#. type: Plain text
32085#: ../sys-utils/rtcwake.8.adoc:86
32086msgid ""
32087"Don't suspend, but read the RTC device until an alarm time appears. This "
32088"mode is useful for debugging."
32089msgstr ""
32090
32091#. type: Plain text
32092#: ../sys-utils/rtcwake.8.adoc:89
32093msgid "Disable a previously set alarm."
32094msgstr ""
32095
32096#. type: Labeled list
32097#: ../sys-utils/rtcwake.8.adoc:90
32098#, no-wrap
32099msgid "*show*"
32100msgstr ""
32101
32102#. type: Plain text
32103#: ../sys-utils/rtcwake.8.adoc:92
32104msgid ""
32105"Print alarm information in format: \"alarm: off|on <time>\". The time is in "
32106"ctime() output format, e.g., \"alarm: on Tue Nov 16 04:48:45 2010\"."
32107msgstr ""
32108
32109#. type: Plain text
32110#: ../sys-utils/rtcwake.8.adoc:95
32111msgid ""
32112"This option does everything apart from actually setting up the alarm, "
32113"suspending the system, or waiting for the alarm."
32114msgstr ""
32115
32116#. type: Labeled list
32117#: ../sys-utils/rtcwake.8.adoc:96
32118#, no-wrap
32119msgid "*-s*, *--seconds* _seconds_"
32120msgstr ""
32121
32122#. type: Plain text
32123#: ../sys-utils/rtcwake.8.adoc:98
32124msgid "Set the wakeup time to _seconds_ in the future from now."
32125msgstr ""
32126
32127#. type: Labeled list
32128#: ../sys-utils/rtcwake.8.adoc:99
32129#, no-wrap
32130msgid "*-t*, *--time* _time_t_"
32131msgstr ""
32132
32133#. type: Plain text
32134#: ../sys-utils/rtcwake.8.adoc:101
32135msgid ""
32136"Set the wakeup time to the absolute time _time_t_. _time_t_ is the time in "
32137"seconds since 1970-01-01, 00:00 UTC. Use the *date*(1) tool to convert "
32138"between human-readable time and _time_t_."
32139msgstr ""
32140
32141#. type: Labeled list
32142#: ../sys-utils/rtcwake.8.adoc:102
32143#, no-wrap
32144msgid "*-u*, *--utc*"
32145msgstr ""
32146
32147#. type: Plain text
32148#: ../sys-utils/rtcwake.8.adoc:104
32149msgid ""
32150"Assume that the hardware clock is set to UTC (Universal Time Coordinated), "
32151"regardless of the contents of the _adjtime_ file."
32152msgstr ""
32153
32154#. type: Plain text
32155#: ../sys-utils/rtcwake.8.adoc:117
32156msgid ""
32157"Some PC systems can't currently exit sleep states such as *mem* using only "
32158"the kernel code accessed by this driver. They need help from userspace code "
32159"to make the framebuffer work again."
32160msgstr ""
32161
32162#. type: Plain text
32163#: ../sys-utils/rtcwake.8.adoc:125
32164msgid ""
32165"The program was posted several times on LKML and other lists before "
32166"appearing in kernel commit message for Linux 2.6 in the GIT commit "
32167"87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d."
32168msgstr ""
32169
32170#. type: Plain text
32171#: ../sys-utils/rtcwake.8.adoc:129
32172msgid ""
32173"The program was written by mailto:dbrownell@users.sourceforge.net[David "
32174"Brownell] and improved by mailto:bwalle@suse.de[Bernhard Walle]."
32175msgstr ""
32176
32177#. type: Plain text
32178#: ../sys-utils/rtcwake.8.adoc:133
32179msgid ""
32180"This is free software. You may redistribute copies of it under the terms of "
32181"the link:http://www.gnu.org/licenses/gpl.html[GNU General Public "
32182"License]. There is NO WARRANTY, to the extent permitted by law."
32183msgstr ""
32184
32185#. type: Plain text
32186#: ../sys-utils/rtcwake.8.adoc:138
32187#, no-wrap
32188msgid ""
32189"*hwclock*(8),\n"
32190"*date*(1)\n"
32191msgstr ""
32192
32193#. type: Title =
32194#: ../sys-utils/setarch.8.adoc:2
32195#, no-wrap
32196msgid "setarch(8)"
32197msgstr ""
32198
32199#. type: Plain text
32200#: ../sys-utils/setarch.8.adoc:12
32201msgid ""
32202"setarch - change reported architecture in new program environment and/or set "
32203"personality flags"
32204msgstr ""
32205
32206#. type: Plain text
32207#: ../sys-utils/setarch.8.adoc:16
32208#, no-wrap
32209msgid "*setarch* [_arch_] [options] (_program_ [_argument_...]]\n"
32210msgstr ""
32211
32212#. type: Plain text
32213#: ../sys-utils/setarch.8.adoc:18
32214#, no-wrap
32215msgid "*setarch* *--list*|*-h*|*-V*\n"
32216msgstr ""
32217
32218#. type: Plain text
32219#: ../sys-utils/setarch.8.adoc:20
32220#, no-wrap
32221msgid "*arch* [options] [_program_ [_argument_...]]\n"
32222msgstr ""
32223
32224#. type: Plain text
32225#: ../sys-utils/setarch.8.adoc:24
32226#, no-wrap
32227msgid "*setarch* modifies execution domains and process personality flags.\n"
32228msgstr ""
32229
32230#. type: Plain text
32231#: ../sys-utils/setarch.8.adoc:26
32232msgid ""
32233"The execution domains currently only affects the output of *uname -m*. For "
32234"example, on an AMD64 system, running *setarch i386* _program_ will cause "
32235"_program_ to see i686 instead of _x86_64_ as the machine type. It can also "
32236"be used to set various personality options. The default _program_ is "
32237"*/bin/sh*."
32238msgstr ""
32239
32240#. type: Plain text
32241#: ../sys-utils/setarch.8.adoc:28
32242msgid ""
32243"Since version 2.33 the _arch_ command line argument is optional and "
32244"*setarch* may be used to change personality flags (ADDR_LIMIT_*, "
32245"SHORT_INODE, etc) without modification of the execution domain."
32246msgstr ""
32247
32248#. type: Labeled list
32249#: ../sys-utils/setarch.8.adoc:31
32250#, no-wrap
32251msgid "*--list*"
32252msgstr ""
32253
32254#. type: Plain text
32255#: ../sys-utils/setarch.8.adoc:33
32256msgid ""
32257"List the architectures that *setarch* knows about. Whether *setarch* can "
32258"actually set each of these architectures depends on the running kernel."
32259msgstr ""
32260
32261#. type: Labeled list
32262#: ../sys-utils/setarch.8.adoc:34
32263#, no-wrap
32264msgid "*--uname-2.6*"
32265msgstr ""
32266
32267#. type: Plain text
32268#: ../sys-utils/setarch.8.adoc:36
32269msgid ""
32270"Causes the _program_ to see a kernel version number beginning with "
32271"2.6. Turns on *UNAME26*."
32272msgstr ""
32273
32274#. type: Labeled list
32275#: ../sys-utils/setarch.8.adoc:40
32276#, no-wrap
32277msgid "*-3*, *--3gb*"
32278msgstr ""
32279
32280#. type: Plain text
32281#: ../sys-utils/setarch.8.adoc:42
32282msgid ""
32283"Specifies _program_ should use a maximum of 3GB of address space. Supported "
32284"on x86. Turns on *ADDR_LIMIT_3GB*."
32285msgstr ""
32286
32287#. type: Labeled list
32288#: ../sys-utils/setarch.8.adoc:43
32289#, no-wrap
32290msgid "*--4gb*"
32291msgstr ""
32292
32293#. type: Plain text
32294#: ../sys-utils/setarch.8.adoc:45
32295msgid ""
32296"This option has no effect. It is retained for backward compatibility only, "
32297"and may be removed in future releases."
32298msgstr ""
32299
32300#. type: Labeled list
32301#: ../sys-utils/setarch.8.adoc:46
32302#, no-wrap
32303msgid "*-B*, *--32bit*"
32304msgstr ""
32305
32306#. type: Plain text
32307#: ../sys-utils/setarch.8.adoc:48
32308msgid ""
32309"Limit the address space to 32 bits to emulate hardware. Supported on ARM and "
32310"Alpha. Turns on *ADDR_LIMIT_32BIT*."
32311msgstr ""
32312
32313#. type: Labeled list
32314#: ../sys-utils/setarch.8.adoc:49
32315#, no-wrap
32316msgid "*-F*, *--fdpic-funcptrs*"
32317msgstr ""
32318
32319#. type: Plain text
32320#: ../sys-utils/setarch.8.adoc:51
32321msgid ""
32322"Treat user-space function pointers to signal handlers as pointers to address "
32323"descriptors. This option has no effect on architectures that do not support "
32324"*FDPIC* ELF binaries. In kernel v4.14 support is limited to ARM, Blackfin, "
32325"Fujitsu FR-V, and SuperH CPU architectures."
32326msgstr ""
32327
32328#. type: Labeled list
32329#: ../sys-utils/setarch.8.adoc:52
32330#, no-wrap
32331msgid "*-I*, *--short-inode*"
32332msgstr ""
32333
32334#. type: Plain text
32335#: ../sys-utils/setarch.8.adoc:54
32336msgid "Obsolete bug emulation flag. Turns on *SHORT_INODE*."
32337msgstr ""
32338
32339#. type: Labeled list
32340#: ../sys-utils/setarch.8.adoc:55
32341#, no-wrap
32342msgid "*-L*, *--addr-compat-layout*"
32343msgstr ""
32344
32345#. type: Plain text
32346#: ../sys-utils/setarch.8.adoc:57
32347msgid ""
32348"Provide legacy virtual address space layout. Use when the _program_ binary "
32349"does not have *PT_GNU_STACK* ELF header. Turns on *ADDR_COMPAT_LAYOUT*."
32350msgstr ""
32351
32352#. type: Labeled list
32353#: ../sys-utils/setarch.8.adoc:58
32354#, no-wrap
32355msgid "*-R*, *--addr-no-randomize*"
32356msgstr ""
32357
32358#. type: Plain text
32359#: ../sys-utils/setarch.8.adoc:60
32360msgid ""
32361"Disables randomization of the virtual address space. Turns on "
32362"*ADDR_NO_RANDOMIZE*."
32363msgstr ""
32364
32365#. type: Labeled list
32366#: ../sys-utils/setarch.8.adoc:61
32367#, no-wrap
32368msgid "*-S*, *--whole-seconds*"
32369msgstr ""
32370
32371#. type: Plain text
32372#: ../sys-utils/setarch.8.adoc:63
32373msgid "Obsolete bug emulation flag. Turns on *WHOLE_SECONDS*."
32374msgstr ""
32375
32376#. type: Labeled list
32377#: ../sys-utils/setarch.8.adoc:64
32378#, no-wrap
32379msgid "*-T*, *--sticky-timeouts*"
32380msgstr ""
32381
32382#. type: Plain text
32383#: ../sys-utils/setarch.8.adoc:66
32384msgid ""
32385"This makes *select*(2), *pselect*(2), and *ppoll*(2) system calls preserve "
32386"the timeout value instead of modifying it to reflect the amount of time not "
32387"slept when interrupted by a signal handler. Use when _program_ depends on "
32388"this behavior. For more details see the timeout description in *select*(2) "
32389"manual page. Turns on *STICKY_TIMEOUTS*."
32390msgstr ""
32391
32392#. type: Labeled list
32393#: ../sys-utils/setarch.8.adoc:67
32394#, no-wrap
32395msgid "*-X*, *--read-implies-exec*"
32396msgstr ""
32397
32398#. type: Plain text
32399#: ../sys-utils/setarch.8.adoc:69
32400msgid ""
32401"If this is set then *mmap*(3p) *PROT_READ* will also add the *PROT_EXEC* bit "
32402"- as expected by legacy x86 binaries. Notice that the ELF loader will "
32403"automatically set this bit when it encounters a legacy binary. Turns on "
32404"*READ_IMPLIES_EXEC*."
32405msgstr ""
32406
32407#. type: Labeled list
32408#: ../sys-utils/setarch.8.adoc:70
32409#, no-wrap
32410msgid "*-Z*, *--mmap-page-zero*"
32411msgstr ""
32412
32413#. type: Plain text
32414#: ../sys-utils/setarch.8.adoc:72
32415msgid ""
32416"SVr4 bug emulation that will set *mmap*(3p) page zero as read-only. Use when "
32417"_program_ depends on this behavior, and the source code is not available to "
32418"be fixed. Turns on *MMAP_PAGE_ZERO*."
32419msgstr ""
32420
32421#. type: delimited block .
32422#: ../sys-utils/setarch.8.adoc:86
32423#, no-wrap
32424msgid ""
32425"setarch --addr-no-randomize mytestprog\n"
32426"setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm\n"
32427"setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm\n"
32428"setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm\n"
32429msgstr ""
32430
32431#. type: Plain text
32432#: ../sys-utils/setarch.8.adoc:93
32433msgid ""
32434"mailto:sopwith@redhat.com[Elliot Lee], mailto:jnovy@redhat.com[Jindrich "
32435"Novy], mailto:kzak@redhat.com[Karel Zak]"
32436msgstr ""
32437
32438#. type: Plain text
32439#: ../sys-utils/setarch.8.adoc:98
32440#, no-wrap
32441msgid ""
32442"*personality*(2),\n"
32443"*select*(2)\n"
32444msgstr ""
32445
32446#. type: Title =
32447#: ../sys-utils/setpriv.1.adoc:2
32448#, no-wrap
32449msgid "setpriv(1)"
32450msgstr ""
32451
32452#. type: Plain text
32453#: ../sys-utils/setpriv.1.adoc:12
32454msgid "setpriv - run a program with different Linux privilege settings"
32455msgstr ""
32456
32457#. type: Plain text
32458#: ../sys-utils/setpriv.1.adoc:16
32459#, no-wrap
32460msgid "*setpriv* [options] _program_ [_arguments_]\n"
32461msgstr ""
32462
32463#. type: Plain text
32464#: ../sys-utils/setpriv.1.adoc:20
32465msgid ""
32466"Sets or queries various Linux privilege settings that are inherited across "
32467"*execve*(2)."
32468msgstr ""
32469
32470#. type: Plain text
32471#: ../sys-utils/setpriv.1.adoc:22
32472msgid ""
32473"In comparison to *su*(1) and *runuser*(1), *setpriv* neither uses PAM, nor "
32474"does it prompt for a password. It is a simple, non-set-user-ID wrapper "
32475"around *execve*(2), and can be used to drop privileges in the same way as "
32476"*setuidgid*(8) from *daemontools*, *chpst*(8) from *runit*, or similar tools "
32477"shipped by other service managers."
32478msgstr ""
32479
32480#. type: Labeled list
32481#: ../sys-utils/setpriv.1.adoc:25
32482#, no-wrap
32483msgid "*--clear-groups*"
32484msgstr ""
32485
32486#. type: Plain text
32487#: ../sys-utils/setpriv.1.adoc:27
32488msgid "Clear supplementary groups."
32489msgstr ""
32490
32491#. type: Labeled list
32492#: ../sys-utils/setpriv.1.adoc:28
32493#, no-wrap
32494msgid "*-d*, *--dump*"
32495msgstr ""
32496
32497#. type: Plain text
32498#: ../sys-utils/setpriv.1.adoc:30
32499msgid ""
32500"Dump the current privilege state. This option can be specified more than "
32501"once to show extra, mostly useless, information. Incompatible with all other "
32502"options."
32503msgstr ""
32504
32505#. type: Labeled list
32506#: ../sys-utils/setpriv.1.adoc:31
32507#, no-wrap
32508msgid "*--groups* _group_..."
32509msgstr ""
32510
32511#. type: Plain text
32512#: ../sys-utils/setpriv.1.adoc:33
32513msgid ""
32514"Set supplementary groups. The argument is a comma-separated list of GIDs or "
32515"names."
32516msgstr ""
32517
32518#. type: Labeled list
32519#: ../sys-utils/setpriv.1.adoc:34
32520#, no-wrap
32521msgid "*--inh-caps* (*+*|*-*)_cap_..."
32522msgstr ""
32523
32524#. type: Labeled list
32525#: ../sys-utils/setpriv.1.adoc:35
32526#, no-wrap
32527msgid "*--ambient-caps* (*+*|*-*)_cap_..."
32528msgstr ""
32529
32530#. type: Labeled list
32531#: ../sys-utils/setpriv.1.adoc:36
32532#, no-wrap
32533msgid "*--bounding-set* (*+*|*-*)_cap_..."
32534msgstr ""
32535
32536#. type: Plain text
32537#: ../sys-utils/setpriv.1.adoc:38
32538msgid ""
32539"Set the inheritable capabilities, ambient capabilities or the capability "
32540"bounding set. See *capabilities*(7). The argument is a comma-separated list "
32541"of **+**__cap__ and **-**__cap__ entries, which add or remove an entry "
32542"respectively. _cap_ can either be a human-readable name as seen in "
32543"*capabilities*(7) without the _cap__ prefix or of the format *cap_N*, where "
32544"_N_ is the internal capability index used by Linux. *+all* and *-all* can be "
32545"used to add or remove all caps."
32546msgstr ""
32547
32548#. type: Plain text
32549#: ../sys-utils/setpriv.1.adoc:40
32550msgid ""
32551"The set of capabilities starts out as the current inheritable set for "
32552"*--inh-caps*, the current ambient set for *--ambient-caps* and the current "
32553"bounding set for *--bounding-set*."
32554msgstr ""
32555
32556#. type: Plain text
32557#: ../sys-utils/setpriv.1.adoc:42
32558msgid ""
32559"Note the following restrictions (detailed in *capabilities*(7)) regarding "
32560"modifications to these capability sets:"
32561msgstr ""
32562
32563#. type: Plain text
32564#: ../sys-utils/setpriv.1.adoc:44
32565msgid ""
32566"A capability can be added to the inheritable set only if it is currently "
32567"present in the bounding set."
32568msgstr ""
32569
32570#. type: Plain text
32571#: ../sys-utils/setpriv.1.adoc:45
32572msgid ""
32573"A capability can be added to the ambient set only if it is currently present "
32574"in both the permitted and inheritable sets."
32575msgstr ""
32576
32577#. type: Plain text
32578#: ../sys-utils/setpriv.1.adoc:46
32579msgid ""
32580"Notwithstanding the syntax offered by *setpriv*, the kernel does not permit "
32581"capabilities to be added to the bounding set."
32582msgstr ""
32583
32584#. type: Plain text
32585#: ../sys-utils/setpriv.1.adoc:48
32586msgid ""
32587"If you drop a capability from the bounding set without also dropping it from "
32588"the inheritable set, you are likely to become confused. Do not do that."
32589msgstr ""
32590
32591#. type: Labeled list
32592#: ../sys-utils/setpriv.1.adoc:49
32593#, no-wrap
32594msgid "*--keep-groups*"
32595msgstr ""
32596
32597#. type: Plain text
32598#: ../sys-utils/setpriv.1.adoc:51
32599msgid ""
32600"Preserve supplementary groups. Only useful in conjunction with *--rgid*, "
32601"*--egid*, or *--regid*."
32602msgstr ""
32603
32604#. type: Labeled list
32605#: ../sys-utils/setpriv.1.adoc:52
32606#, no-wrap
32607msgid "*--init-groups*"
32608msgstr ""
32609
32610#. type: Plain text
32611#: ../sys-utils/setpriv.1.adoc:54
32612msgid ""
32613"Initialize supplementary groups using initgroups3. Only useful in "
32614"conjunction with *--ruid* or *--reuid*."
32615msgstr ""
32616
32617#. type: Labeled list
32618#: ../sys-utils/setpriv.1.adoc:55
32619#, no-wrap
32620msgid "*--list-caps*"
32621msgstr ""
32622
32623#. type: Plain text
32624#: ../sys-utils/setpriv.1.adoc:57
32625msgid "List all known capabilities. This option must be specified alone."
32626msgstr ""
32627
32628#. type: Labeled list
32629#: ../sys-utils/setpriv.1.adoc:58
32630#, no-wrap
32631msgid "*--no-new-privs*"
32632msgstr ""
32633
32634#. type: Plain text
32635#: ../sys-utils/setpriv.1.adoc:60
32636msgid ""
32637"Set the _no_new_privs_ bit. With this bit set, *execve*(2) will not grant "
32638"new privileges. For example, the set-user-ID and set-group-ID bits as well "
32639"as file capabilities will be disabled. (Executing binaries with these bits "
32640"set will still work, but they will not gain privileges. Certain LSMs, "
32641"especially AppArmor, may result in failures to execute certain programs.) "
32642"This bit is inherited by child processes and cannot be unset. See *prctl*(2) "
32643"and _Documentation/prctl/no_new_privs.txt_ in the Linux kernel source."
32644msgstr ""
32645
32646#. type: Plain text
32647#: ../sys-utils/setpriv.1.adoc:62
32648msgid "The _no_new_privs_ bit is supported since Linux 3.5."
32649msgstr ""
32650
32651#. type: Labeled list
32652#: ../sys-utils/setpriv.1.adoc:63
32653#, no-wrap
32654msgid "*--rgid* _gid_, *--egid* _gid_, *--regid* _gid_"
32655msgstr ""
32656
32657#. type: Plain text
32658#: ../sys-utils/setpriv.1.adoc:65
32659msgid ""
32660"Set the real, effective, or both GIDs. The _gid_ argument can be given as a "
32661"textual group name."
32662msgstr ""
32663
32664#. type: Plain text
32665#: ../sys-utils/setpriv.1.adoc:67
32666msgid ""
32667"For safety, you must specify one of *--clear-groups*, *--groups*, "
32668"*--keep-groups*, or *--init-groups* if you set any primary _gid_."
32669msgstr ""
32670
32671#. type: Labeled list
32672#: ../sys-utils/setpriv.1.adoc:68
32673#, no-wrap
32674msgid "*--ruid* _uid_, *--euid* _uid_, *--reuid* _uid_"
32675msgstr ""
32676
32677#. type: Plain text
32678#: ../sys-utils/setpriv.1.adoc:70
32679msgid ""
32680"Set the real, effective, or both UIDs. The _uid_ argument can be given as a "
32681"textual login name."
32682msgstr ""
32683
32684#. type: Plain text
32685#: ../sys-utils/setpriv.1.adoc:72
32686msgid ""
32687"Setting a _uid_ or _gid_ does not change capabilities, although the exec "
32688"call at the end might change capabilities. This means that, if you are root, "
32689"you probably want to do something like:"
32690msgstr ""
32691
32692#. type: Plain text
32693#: ../sys-utils/setpriv.1.adoc:74
32694#, no-wrap
32695msgid "*setpriv --reuid=1000 --regid=1000 --inh-caps=-all*\n"
32696msgstr ""
32697
32698#. type: Labeled list
32699#: ../sys-utils/setpriv.1.adoc:75
32700#, no-wrap
32701msgid "*--securebits* (**+**|*-*)__securebit__..."
32702msgstr ""
32703
32704#. type: Plain text
32705#: ../sys-utils/setpriv.1.adoc:77
32706msgid ""
32707"Set or clear securebits. The argument is a comma-separated list. The valid "
32708"securebits are _noroot_, _noroot_locked_, _no_setuid_fixup_, "
32709"_no_setuid_fixup_locked_, and _keep_caps_locked_. _keep_caps_ is cleared by "
32710"*execve*(2) and is therefore not allowed."
32711msgstr ""
32712
32713#. type: Labeled list
32714#: ../sys-utils/setpriv.1.adoc:78
32715#, no-wrap
32716msgid "**--pdeathsig keep**|**clear**|*<signal>*"
32717msgstr ""
32718
32719#. type: Plain text
32720#: ../sys-utils/setpriv.1.adoc:80
32721msgid ""
32722"Keep, clear or set the parent death signal. Some LSMs, most notably SELinux "
32723"and AppArmor, clear the signal when the process' credentials change. Using "
32724"*--pdeathsig keep* will restore the parent death signal after changing "
32725"credentials to remedy that situation."
32726msgstr ""
32727
32728#. type: Labeled list
32729#: ../sys-utils/setpriv.1.adoc:81
32730#, no-wrap
32731msgid "*--selinux-label* _label_"
32732msgstr ""
32733
32734#. type: Plain text
32735#: ../sys-utils/setpriv.1.adoc:83
32736msgid ""
32737"Request a particular SELinux transition (using a transition on exec, not "
32738"dyntrans). This will fail and cause *setpriv* to abort if SELinux is not in "
32739"use, and the transition may be ignored or cause *execve*(2) to fail at "
32740"SELinux's whim. (In particular, this is unlikely to work in conjunction with "
32741"_no_new_privs_.) This is similar to *runcon*(1)."
32742msgstr ""
32743
32744#. type: Labeled list
32745#: ../sys-utils/setpriv.1.adoc:84
32746#, no-wrap
32747msgid "*--apparmor-profile* _profile_"
32748msgstr ""
32749
32750#. type: Plain text
32751#: ../sys-utils/setpriv.1.adoc:86
32752msgid ""
32753"Request a particular AppArmor profile (using a transition on exec). This "
32754"will fail and cause *setpriv* to abort if AppArmor is not in use, and the "
32755"transition may be ignored or cause *execve*(2) to fail at AppArmor's whim."
32756msgstr ""
32757
32758#. type: Labeled list
32759#: ../sys-utils/setpriv.1.adoc:87
32760#, no-wrap
32761msgid "*--reset-env*"
32762msgstr ""
32763
32764#. type: Plain text
32765#: ../sys-utils/setpriv.1.adoc:89
32766msgid ""
32767"Clears all the environment variables except *TERM*; initializes the "
32768"environment variables *HOME*, *SHELL*, *USER*, *LOGNAME* according to the "
32769"user's passwd entry; sets *PATH* to _/usr/local/bin:/bin:/usr/bin_ for a "
32770"regular user and to "
32771"_/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin_ for root."
32772msgstr ""
32773
32774#. type: Plain text
32775#: ../sys-utils/setpriv.1.adoc:91
32776msgid ""
32777"The environment variable *PATH* may be different on systems where _/bin_ and "
32778"_/sbin_ are merged into _/usr_. The environment variable *SHELL* defaults to "
32779"*/bin/sh* if none is given in the user's passwd entry."
32780msgstr ""
32781
32782#. type: Plain text
32783#: ../sys-utils/setpriv.1.adoc:101
32784msgid ""
32785"If applying any specified option fails, _program_ will not be run and "
32786"*setpriv* will return with exit status 127."
32787msgstr ""
32788
32789#. type: Plain text
32790#: ../sys-utils/setpriv.1.adoc:103
32791msgid ""
32792"Be careful with this tool -- it may have unexpected security "
32793"consequences. For example, setting _no_new_privs_ and then execing a program "
32794"that is SELinux-confined (as this tool would do) may prevent the SELinux "
32795"restrictions from taking effect."
32796msgstr ""
32797
32798#. type: Plain text
32799#: ../sys-utils/setpriv.1.adoc:107
32800msgid ""
32801"If you're looking for behavior similar to *su*(1)/*runuser*(1), or *sudo*(8) "
32802"(without the *-g* option), try something like:"
32803msgstr ""
32804
32805#. type: Plain text
32806#: ../sys-utils/setpriv.1.adoc:109
32807#, no-wrap
32808msgid "*setpriv --reuid=1000 --regid=1000 --init-groups*\n"
32809msgstr ""
32810
32811#. type: Plain text
32812#: ../sys-utils/setpriv.1.adoc:111
32813msgid "If you want to mimic daemontools' *setuid*(8), try:"
32814msgstr ""
32815
32816#. type: Plain text
32817#: ../sys-utils/setpriv.1.adoc:113
32818#, no-wrap
32819msgid "*setpriv --reuid=1000 --regid=1000 --clear-groups*\n"
32820msgstr ""
32821
32822#. type: Plain text
32823#: ../sys-utils/setpriv.1.adoc:117
32824msgid "mailto:luto@amacapital.net[Andy Lutomirski]"
32825msgstr ""
32826
32827#. type: Plain text
32828#: ../sys-utils/setpriv.1.adoc:124
32829#, no-wrap
32830msgid ""
32831"*runuser*(1),\n"
32832"*su*(1),\n"
32833"*prctl*(2),\n"
32834"*capabilities*(7)\n"
32835msgstr ""
32836
32837#. Rick Sladkey <jrs@world.std.com>
32838#. In the public domain.
32839#. type: Title =
32840#: ../sys-utils/setsid.1.adoc:4
32841#, no-wrap
32842msgid "setsid(1)"
32843msgstr ""
32844
32845#. type: Plain text
32846#: ../sys-utils/setsid.1.adoc:14
32847msgid "setsid - run a program in a new session"
32848msgstr ""
32849
32850#. type: Plain text
32851#: ../sys-utils/setsid.1.adoc:18
32852#, no-wrap
32853msgid "*setsid* [options] _program_ [_arguments_]\n"
32854msgstr ""
32855
32856#. type: Plain text
32857#: ../sys-utils/setsid.1.adoc:22
32858#, no-wrap
32859msgid ""
32860"*setsid* runs a program in a new session. The command calls *fork*(2) if "
32861"already a process group leader. Otherwise, it executes a program in the "
32862"current process. This default behavior is possible to override by the "
32863"*--fork* option.\n"
32864msgstr ""
32865
32866#. type: Labeled list
32867#: ../sys-utils/setsid.1.adoc:25
32868#, no-wrap
32869msgid "*-c*, *--ctty*"
32870msgstr ""
32871
32872#. type: Plain text
32873#: ../sys-utils/setsid.1.adoc:27
32874msgid "Set the controlling terminal to the current one."
32875msgstr ""
32876
32877#. type: Labeled list
32878#: ../sys-utils/setsid.1.adoc:28 ../sys-utils/unshare.1.adoc:81
32879#, no-wrap
32880msgid "*-f*, *--fork*"
32881msgstr ""
32882
32883#. type: Plain text
32884#: ../sys-utils/setsid.1.adoc:30
32885msgid "Always create a new process."
32886msgstr ""
32887
32888#. type: Labeled list
32889#: ../sys-utils/setsid.1.adoc:31
32890#, no-wrap
32891msgid "*-w*, *--wait*"
32892msgstr ""
32893
32894#. type: Plain text
32895#: ../sys-utils/setsid.1.adoc:33
32896msgid ""
32897"Wait for the execution of the program to end, and return the exit status of "
32898"this program as the exit status of *setsid*."
32899msgstr ""
32900
32901#. type: Plain text
32902#: ../sys-utils/setsid.1.adoc:43
32903msgid "mailto:jrs@world.std.com[Rick Sladkey]"
32904msgstr ""
32905
32906#. type: Plain text
32907#: ../sys-utils/setsid.1.adoc:47
32908#, no-wrap
32909msgid "*setsid*(2)\n"
32910msgstr ""
32911
32912#. type: Title =
32913#: ../sys-utils/swapon.8.adoc:2
32914#, no-wrap
32915msgid "swapon(8)"
32916msgstr ""
32917
32918#. type: Plain text
32919#: ../sys-utils/swapon.8.adoc:12
32920msgid "swapon, swapoff - enable/disable devices and files for paging and swapping"
32921msgstr ""
32922
32923#. type: Plain text
32924#: ../sys-utils/swapon.8.adoc:16
32925#, no-wrap
32926msgid "*swapon* [options] [_specialfile_...]\n"
32927msgstr ""
32928
32929#. type: Plain text
32930#: ../sys-utils/swapon.8.adoc:18
32931#, no-wrap
32932msgid "*swapoff* [*-va*] [_specialfile_...]\n"
32933msgstr ""
32934
32935#. type: Plain text
32936#: ../sys-utils/swapon.8.adoc:22
32937#, no-wrap
32938msgid ""
32939"*swapon* is used to specify devices on which paging and swapping are to take "
32940"place.\n"
32941msgstr ""
32942
32943#. type: Plain text
32944#: ../sys-utils/swapon.8.adoc:24
32945msgid ""
32946"The device or file used is given by the _specialfile_ parameter. It may be "
32947"of the form *-L* _label_ or *-U* _uuid_ to indicate a device by label or "
32948"uuid."
32949msgstr ""
32950
32951#. type: Plain text
32952#: ../sys-utils/swapon.8.adoc:26
32953msgid ""
32954"Calls to *swapon* normally occur in the system boot scripts making all swap "
32955"devices available, so that the paging and swapping activity is interleaved "
32956"across several devices and files."
32957msgstr ""
32958
32959#. type: Plain text
32960#: ../sys-utils/swapon.8.adoc:28
32961#, no-wrap
32962msgid ""
32963"*swapoff* disables swapping on the specified devices and files. When the "
32964"*-a* flag is given, swapping is disabled on all known swap devices and files "
32965"(as found in _/proc/swaps_ or _/etc/fstab_).\n"
32966msgstr ""
32967
32968#. type: Plain text
32969#: ../sys-utils/swapon.8.adoc:33
32970msgid ""
32971"All devices marked as \"swap\" in _/etc/fstab_ are made available, except "
32972"for those with the \"noauto\" option. Devices that are already being used as "
32973"swap are silently skipped."
32974msgstr ""
32975
32976#. type: Labeled list
32977#: ../sys-utils/swapon.8.adoc:34
32978#, no-wrap
32979msgid "*-d*, *--discard*[**=**__policy__]"
32980msgstr ""
32981
32982#. type: Plain text
32983#: ../sys-utils/swapon.8.adoc:36
32984msgid ""
32985"Enable swap discards, if the swap backing device supports the discard or "
32986"trim operation. This may improve performance on some Solid State Devices, "
32987"but often it does not. The option allows one to select between two available "
32988"swap discard policies:"
32989msgstr ""
32990
32991#. type: Labeled list
32992#: ../sys-utils/swapon.8.adoc:37
32993#, no-wrap
32994msgid "*--discard=once*"
32995msgstr ""
32996
32997#. type: Plain text
32998#: ../sys-utils/swapon.8.adoc:39
32999msgid ""
33000"to perform a single-time discard operation for the whole swap area at "
33001"swapon; or"
33002msgstr ""
33003
33004#. type: Labeled list
33005#: ../sys-utils/swapon.8.adoc:40
33006#, no-wrap
33007msgid "*--discard=pages*"
33008msgstr ""
33009
33010#. type: Plain text
33011#: ../sys-utils/swapon.8.adoc:42
33012msgid ""
33013"to asynchronously discard freed swap pages before they are available for "
33014"reuse."
33015msgstr ""
33016
33017#. type: Plain text
33018#: ../sys-utils/swapon.8.adoc:45
33019msgid ""
33020"If no policy is selected, the default behavior is to enable both discard "
33021"types. The _/etc/fstab_ mount options *discard*, *discard=once*, or "
33022"*discard=pages* may also be used to enable discard flags."
33023msgstr ""
33024
33025#. type: Labeled list
33026#: ../sys-utils/swapon.8.adoc:46
33027#, no-wrap
33028msgid "*-e*, *--ifexists*"
33029msgstr ""
33030
33031#. type: Plain text
33032#: ../sys-utils/swapon.8.adoc:48
33033msgid ""
33034"Silently skip devices that do not exist. The _/etc/fstab_ mount option "
33035"*nofail* may also be used to skip non-existing device."
33036msgstr ""
33037
33038#. type: Labeled list
33039#: ../sys-utils/swapon.8.adoc:49
33040#, no-wrap
33041msgid "*-f*, *--fixpgsz*"
33042msgstr ""
33043
33044#. type: Plain text
33045#: ../sys-utils/swapon.8.adoc:51
33046msgid ""
33047"Reinitialize (exec mkswap) the swap space if its page size does not match "
33048"that of the current running kernel. *mkswap*(8) initializes the whole device "
33049"and does not check for bad blocks."
33050msgstr ""
33051
33052#. type: Labeled list
33053#: ../sys-utils/swapon.8.adoc:55
33054#, no-wrap
33055msgid "*-L* _label_"
33056msgstr ""
33057
33058#. type: Plain text
33059#: ../sys-utils/swapon.8.adoc:57
33060msgid ""
33061"Use the partition that has the specified _label_. (For this, access to "
33062"_/proc/partitions_ is needed.)"
33063msgstr ""
33064
33065#. type: Plain text
33066#: ../sys-utils/swapon.8.adoc:60
33067msgid ""
33068"Specify swap options by an fstab-compatible comma-separated string. For "
33069"example:"
33070msgstr ""
33071
33072#. type: Plain text
33073#: ../sys-utils/swapon.8.adoc:62
33074#, no-wrap
33075msgid "*swapon -o pri=1,discard=pages,nofail /dev/sda2*\n"
33076msgstr ""
33077
33078#. type: Plain text
33079#: ../sys-utils/swapon.8.adoc:64
33080msgid ""
33081"The _opts_ string is evaluated last and overrides all other command line "
33082"options."
33083msgstr ""
33084
33085#. type: Plain text
33086#: ../sys-utils/swapon.8.adoc:67
33087msgid ""
33088"Specify the priority of the swap device. _priority_ is a value between -1 "
33089"and 32767. Higher numbers indicate higher priority. See *swapon*(2) for a "
33090"full description of swap priorities. Add **pri=**__value__ to the option "
33091"field of _/etc/fstab_ for use with *swapon -a*. When no priority is defined, "
33092"it defaults to -1."
33093msgstr ""
33094
33095#. type: Labeled list
33096#: ../sys-utils/swapon.8.adoc:68
33097#, no-wrap
33098msgid "*-s*, *--summary*"
33099msgstr ""
33100
33101#. type: Plain text
33102#: ../sys-utils/swapon.8.adoc:70
33103msgid ""
33104"Display swap usage summary by device. Equivalent to *cat /proc/swaps*. This "
33105"output format is DEPRECATED in favour of *--show* that provides better "
33106"control on output data."
33107msgstr ""
33108
33109#. type: Labeled list
33110#: ../sys-utils/swapon.8.adoc:71
33111#, no-wrap
33112msgid "*--show*[**=**__column__...]"
33113msgstr ""
33114
33115#. type: Plain text
33116#: ../sys-utils/swapon.8.adoc:73
33117msgid ""
33118"Display a definable table of swap areas. See the *--help* output for a list "
33119"of available columns."
33120msgstr ""
33121
33122#. type: Plain text
33123#: ../sys-utils/swapon.8.adoc:79
33124msgid "Do not print headings when displaying *--show* output."
33125msgstr ""
33126
33127#. type: Plain text
33128#: ../sys-utils/swapon.8.adoc:82
33129msgid "Display *--show* output without aligning table columns."
33130msgstr ""
33131
33132#. type: Labeled list
33133#: ../sys-utils/swapon.8.adoc:83
33134#, no-wrap
33135msgid "*--bytes*"
33136msgstr ""
33137
33138#. type: Plain text
33139#: ../sys-utils/swapon.8.adoc:85
33140msgid ""
33141"Display swap size in bytes in *--show* output instead of in user-friendly "
33142"units."
33143msgstr ""
33144
33145#. type: Labeled list
33146#: ../sys-utils/swapon.8.adoc:86
33147#, no-wrap
33148msgid "*-U* _uuid_"
33149msgstr ""
33150
33151#. type: Plain text
33152#: ../sys-utils/swapon.8.adoc:88
33153msgid "Use the partition that has the specified _uuid_."
33154msgstr ""
33155
33156#. type: Plain text
33157#: ../sys-utils/swapon.8.adoc:98
33158#, no-wrap
33159msgid "*swapoff* has the following exit status values since v2.36:\n"
33160msgstr ""
33161
33162#. type: Plain text
33163#: ../sys-utils/swapon.8.adoc:104
33164msgid "system has insufficient memory to stop swapping (OOM)"
33165msgstr ""
33166
33167#. type: Plain text
33168#: ../sys-utils/swapon.8.adoc:107
33169msgid "swapoff syscall failed for another reason"
33170msgstr ""
33171
33172#. type: Plain text
33173#: ../sys-utils/swapon.8.adoc:110
33174msgid "non-swapoff syscall system error (out of memory, ...)"
33175msgstr ""
33176
33177#. type: Plain text
33178#: ../sys-utils/swapon.8.adoc:113
33179msgid "usage or syntax error"
33180msgstr ""
33181
33182#. type: Plain text
33183#: ../sys-utils/swapon.8.adoc:116
33184msgid "all swapoff failed on *--all*"
33185msgstr ""
33186
33187#. type: Plain text
33188#: ../sys-utils/swapon.8.adoc:119
33189msgid "some swapoff succeeded on *--all*"
33190msgstr ""
33191
33192#. type: Plain text
33193#: ../sys-utils/swapon.8.adoc:121
33194msgid ""
33195"The command *swapoff --all* returns 0 (all succeeded), 32 (all failed), or "
33196"64 (some failed, some succeeded)."
33197msgstr ""
33198
33199#. type: Plain text
33200#: ../sys-utils/swapon.8.adoc:123
33201msgid ""
33202"The old versions before v2.36 has no documented exit status, 0 means success "
33203"in all versions."
33204msgstr ""
33205
33206#. type: Labeled list
33207#: ../sys-utils/swapon.8.adoc:134
33208#, no-wrap
33209msgid "_/dev/sd??_"
33210msgstr ""
33211
33212#. type: Plain text
33213#: ../sys-utils/swapon.8.adoc:136
33214msgid "standard paging devices"
33215msgstr ""
33216
33217#. type: Plain text
33218#: ../sys-utils/swapon.8.adoc:139
33219msgid "ascii filesystem description table"
33220msgstr ""
33221
33222#. type: Title ===
33223#: ../sys-utils/swapon.8.adoc:142
33224#, no-wrap
33225msgid "Files with holes"
33226msgstr ""
33227
33228#. type: Plain text
33229#: ../sys-utils/swapon.8.adoc:145
33230msgid ""
33231"The swap file implementation in the kernel expects to be able to write to "
33232"the file directly, without the assistance of the filesystem. This is a "
33233"problem on files with holes or on copy-on-write files on filesystems like "
33234"Btrfs."
33235msgstr ""
33236
33237#. type: Plain text
33238#: ../sys-utils/swapon.8.adoc:147
33239msgid ""
33240"Commands like *cp*(1) or *truncate*(1) create files with holes. These files "
33241"will be rejected by *swapon*."
33242msgstr ""
33243
33244#. type: Plain text
33245#: ../sys-utils/swapon.8.adoc:149
33246msgid ""
33247"Preallocated files created by *fallocate*(1) may be interpreted as files "
33248"with holes too depending of the filesystem. Preallocated swap files are "
33249"supported on XFS since Linux 4.18."
33250msgstr ""
33251
33252#. type: Plain text
33253#: ../sys-utils/swapon.8.adoc:151
33254msgid ""
33255"The most portable solution to create a swap file is to use *dd*(1) and "
33256"_/dev/zero_."
33257msgstr ""
33258
33259#. type: Title ===
33260#: ../sys-utils/swapon.8.adoc:152
33261#, no-wrap
33262msgid "Btrfs"
33263msgstr ""
33264
33265#. type: Plain text
33266#: ../sys-utils/swapon.8.adoc:155
33267msgid ""
33268"Swap files on Btrfs are supported since Linux 5.0 on files with nocow "
33269"attribute. See the *btrfs*(5) manual page for more details."
33270msgstr ""
33271
33272#. type: Title ===
33273#: ../sys-utils/swapon.8.adoc:156
33274#, no-wrap
33275msgid "NFS"
33276msgstr ""
33277
33278#. type: Plain text
33279#: ../sys-utils/swapon.8.adoc:159
33280msgid "Swap over *NFS* may not work."
33281msgstr ""
33282
33283#. type: Title ===
33284#: ../sys-utils/swapon.8.adoc:160
33285#, no-wrap
33286msgid "Suspend"
33287msgstr ""
33288
33289#. type: Plain text
33290#: ../sys-utils/swapon.8.adoc:163
33291#, no-wrap
33292msgid ""
33293"*swapon* automatically detects and rewrites a swap space signature with old "
33294"software suspend data (e.g., S1SUSPEND, S2SUSPEND, ...). The problem is that "
33295"if we don't do it, then we get data corruption the next time an attempt at "
33296"unsuspending is made.\n"
33297msgstr ""
33298
33299#. type: Plain text
33300#: ../sys-utils/swapon.8.adoc:167
33301msgid "The *swapon* command appeared in 4.0BSD."
33302msgstr ""
33303
33304#. type: Plain text
33305#: ../sys-utils/swapon.8.adoc:178
33306#, no-wrap
33307msgid ""
33308"*swapoff*(2),\n"
33309"*swapon*(2),\n"
33310"*fstab*(5),\n"
33311"*init*(8),\n"
33312"*fallocate*(1),\n"
33313"*mkswap*(8),\n"
33314"*mount*(8),\n"
33315"*rc*(8)\n"
33316msgstr ""
33317
33318#. type: Title =
33319#: ../sys-utils/switch_root.8.adoc:2
33320#, no-wrap
33321msgid "switch_root(8)"
33322msgstr ""
33323
33324#. type: Plain text
33325#: ../sys-utils/switch_root.8.adoc:12
33326msgid "switch_root - switch to another filesystem as the root of the mount tree"
33327msgstr ""
33328
33329#. type: Plain text
33330#: ../sys-utils/switch_root.8.adoc:16
33331#, no-wrap
33332msgid "*switch_root* [*-hV*]\n"
33333msgstr ""
33334
33335#. type: Plain text
33336#: ../sys-utils/switch_root.8.adoc:18
33337#, no-wrap
33338msgid "*switch_root* _newroot init_ [_arg_...]\n"
33339msgstr ""
33340
33341#. type: Plain text
33342#: ../sys-utils/switch_root.8.adoc:22
33343#, no-wrap
33344msgid ""
33345"*switch_root* moves already mounted _/proc_, _/dev_, _/sys_ and _/run_ to "
33346"_newroot_ and makes _newroot_ the new root filesystem and starts _init_ "
33347"process.\n"
33348msgstr ""
33349
33350#. type: Plain text
33351#: ../sys-utils/switch_root.8.adoc:24
33352#, no-wrap
33353msgid ""
33354"*WARNING: switch_root removes recursively all files and directories on the "
33355"current root filesystem.*\n"
33356msgstr ""
33357
33358#. type: Plain text
33359#: ../sys-utils/switch_root.8.adoc:36
33360#, no-wrap
33361msgid "*switch_root* returns 0 on success and 1 on failure.\n"
33362msgstr ""
33363
33364#. type: Plain text
33365#: ../sys-utils/switch_root.8.adoc:40
33366#, no-wrap
33367msgid ""
33368"*switch_root* will fail to function if _newroot_ is not the root of a "
33369"mount. If you want to switch root into a directory that does not meet this "
33370"requirement then you can first use a bind-mounting trick to turn any "
33371"directory into a mount point:\n"
33372msgstr ""
33373
33374#. type: delimited block .
33375#: ../sys-utils/switch_root.8.adoc:43
33376#, no-wrap
33377msgid "mount --bind $DIR $DIR\n"
33378msgstr ""
33379
33380#. type: Plain text
33381#: ../sys-utils/switch_root.8.adoc:50
33382msgid ""
33383"mailto:pjones@redhat.com[Peter Jones], mailto:katzj@redhat.com[Jeremy Katz], "
33384"mailto:kzak@redhat.com[Karel Zak]"
33385msgstr ""
33386
33387#. type: Plain text
33388#: ../sys-utils/switch_root.8.adoc:57
33389#, no-wrap
33390msgid ""
33391"*chroot*(2),\n"
33392"*init*(8),\n"
33393"*mkinitrd*(8),\n"
33394"*mount*(8)\n"
33395msgstr ""
33396
33397#. type: Title =
33398#: ../sys-utils/tunelp.8.adoc:2
33399#, no-wrap
33400msgid "tunelp(8)"
33401msgstr ""
33402
33403#. type: Plain text
33404#: ../sys-utils/tunelp.8.adoc:12
33405msgid "tunelp - set various parameters for the lp device"
33406msgstr ""
33407
33408#. type: Plain text
33409#: ../sys-utils/tunelp.8.adoc:16
33410#, no-wrap
33411msgid "*tunelp* [options] _device_\n"
33412msgstr ""
33413
33414#. type: Plain text
33415#: ../sys-utils/tunelp.8.adoc:20
33416#, no-wrap
33417msgid ""
33418"*tunelp* sets several parameters for the /dev/lp__?__ devices, for better "
33419"performance (or for any performance at all, if your printer won't work "
33420"without it...) Without parameters, it tells whether the device is using "
33421"interrupts, and if so, which one. With parameters, it sets the device "
33422"characteristics accordingly.\n"
33423msgstr ""
33424
33425#. type: Labeled list
33426#: ../sys-utils/tunelp.8.adoc:23
33427#, no-wrap
33428msgid "*-i*, *--irq* _argument_"
33429msgstr ""
33430
33431#. type: Plain text
33432#: ../sys-utils/tunelp.8.adoc:25
33433msgid ""
33434"specifies the IRQ to use for the parallel port in question. If this is set "
33435"to something non-zero, *-t* and *-c* have no effect. If your port does not "
33436"use interrupts, this option will make printing stop. The command *tunelp -i "
33437"0* restores non-interrupt driven (polling) action, and your printer should "
33438"work again. If your parallel port does support interrupts, interrupt-driven "
33439"printing should be somewhat faster and efficient, and will probably be "
33440"desirable."
33441msgstr ""
33442
33443#. type: Plain text
33444#: ../sys-utils/tunelp.8.adoc:27
33445#, no-wrap
33446msgid ""
33447"*NOTE*: This option will have no effect with kernel 2.1.131 or later since "
33448"the irq is handled by the parport driver. You can change the parport irq for "
33449"example via _/proc/parport/*/irq_. Read "
33450"_/usr/src/linux/Documentation/admin-guide/parport.rst_ for more details on "
33451"parport.\n"
33452msgstr ""
33453
33454#. type: Labeled list
33455#: ../sys-utils/tunelp.8.adoc:28
33456#, no-wrap
33457msgid "*-t*, *--time* _milliseconds_"
33458msgstr ""
33459
33460#. type: Plain text
33461#: ../sys-utils/tunelp.8.adoc:30
33462msgid ""
33463"is the amount of time in jiffies that the driver waits if the printer "
33464"doesn't take a character for the number of tries dictated by the *-c* "
33465"parameter. 10 is the default value. If you want fastest possible printing, "
33466"and don't care about system load, you may set this to 0. If you don't care "
33467"how fast your printer goes, or are printing text on a slow printer with a "
33468"buffer, then 500 (5 seconds) should be fine, and will give you very low "
33469"system load. This value generally should be lower for printing graphics than "
33470"text, by a factor of approximately 10, for best performance."
33471msgstr ""
33472
33473#. type: Labeled list
33474#: ../sys-utils/tunelp.8.adoc:31
33475#, no-wrap
33476msgid "*-c*, *--chars* _characters_"
33477msgstr ""
33478
33479#. type: Plain text
33480#: ../sys-utils/tunelp.8.adoc:33
33481msgid ""
33482"is the number of times to try to output a character to the printer before "
33483"sleeping for *-t* _TIME_. It is the number of times around a loop that tries "
33484"to send a character to the printer. 120 appears to be a good value for most "
33485"printers in polling mode. 1000 is the default, because there are some "
33486"printers that become jerky otherwise, but you _must_ set this to '1' to "
33487"handle the maximal CPU efficiency if you are using interrupts. If you have a "
33488"very fast printer, a value of 10 might make more sense even if in polling "
33489"mode. If you have a _really_ old printer, you can increase this further."
33490msgstr ""
33491
33492#. type: Plain text
33493#: ../sys-utils/tunelp.8.adoc:35
33494msgid "Setting *-t* _TIME_ to 0 is equivalent to setting *-c* _CHARS_ to infinity."
33495msgstr ""
33496
33497#. type: Labeled list
33498#: ../sys-utils/tunelp.8.adoc:36
33499#, no-wrap
33500msgid "*-w*, *--wait* _milliseconds_"
33501msgstr ""
33502
33503#. type: Plain text
33504#: ../sys-utils/tunelp.8.adoc:38
33505msgid ""
33506"is the number of usec we wait while playing with the strobe signal. While "
33507"most printers appear to be able to deal with an extremely short strobe, some "
33508"printers demand a longer one. Increasing this from the default 1 may make it "
33509"possible to print with those printers. This may also make it possible to use "
33510"longer cables. It's also possible to decrease this value to 0 if your "
33511"printer is fast enough or your machine is slow enough."
33512msgstr ""
33513
33514#. type: Labeled list
33515#: ../sys-utils/tunelp.8.adoc:39
33516#, no-wrap
33517msgid "*-a*, *--abort* _<on|off>_"
33518msgstr ""
33519
33520#. type: Plain text
33521#: ../sys-utils/tunelp.8.adoc:41
33522msgid ""
33523"This is whether to abort on printer error - the default is not to. If you "
33524"are sitting at your computer, you probably want to be able to see an error "
33525"and fix it, and have the printer go on printing. On the other hand, if you "
33526"aren't, you might rather that your printer spooler find out that the printer "
33527"isn't ready, quit trying, and send you mail about it. The choice is yours."
33528msgstr ""
33529
33530#. type: Labeled list
33531#: ../sys-utils/tunelp.8.adoc:42
33532#, no-wrap
33533msgid "*-o*, *--check-status* _<on|off>_"
33534msgstr ""
33535
33536#. type: Plain text
33537#: ../sys-utils/tunelp.8.adoc:44
33538msgid ""
33539"This option is much like *-a*. It makes any *open*(2) of this device check "
33540"to see that the device is on-line and not reporting any out of paper or "
33541"other errors. This is the correct setting for most versions of *lpd*."
33542msgstr ""
33543
33544#. type: Labeled list
33545#: ../sys-utils/tunelp.8.adoc:45
33546#, no-wrap
33547msgid "*-C*, *--careful* _<on|off>_"
33548msgstr ""
33549
33550#. type: Plain text
33551#: ../sys-utils/tunelp.8.adoc:47
33552msgid ""
33553"This option adds extra (\"careful\") error checking. When this option is on, "
33554"the printer driver will ensure that the printer is on-line and not reporting "
33555"any out of paper or other errors before sending data. This is particularly "
33556"useful for printers that normally appear to accept data when turned off."
33557msgstr ""
33558
33559#. type: Plain text
33560#: ../sys-utils/tunelp.8.adoc:49
33561#, no-wrap
33562msgid ""
33563"*NOTE*: This option is obsolete because it's the default in 2.1.131 kernel "
33564"or later.\n"
33565msgstr ""
33566
33567#. type: Labeled list
33568#: ../sys-utils/tunelp.8.adoc:50
33569#, no-wrap
33570msgid "*-s*, *--status*"
33571msgstr ""
33572
33573#. type: Plain text
33574#: ../sys-utils/tunelp.8.adoc:52
33575msgid ""
33576"This option returns the current printer status, both as a decimal number "
33577"from 0..255, and as a list of active flags. When this option is specified, "
33578"*-q* off, turning off the display of the current IRQ, is implied."
33579msgstr ""
33580
33581#. type: Plain text
33582#: ../sys-utils/tunelp.8.adoc:55
33583msgid ""
33584"This option resets the port. It requires a Linux kernel version of 1.1.80 or "
33585"later."
33586msgstr ""
33587
33588#. type: Labeled list
33589#: ../sys-utils/tunelp.8.adoc:56
33590#, no-wrap
33591msgid "*-q*, *--print-irq* _<on|off>_"
33592msgstr ""
33593
33594#. type: Plain text
33595#: ../sys-utils/tunelp.8.adoc:58
33596msgid "This option sets printing the display of the current IRQ setting."
33597msgstr ""
33598
33599#. type: Plain text
33600#: ../sys-utils/tunelp.8.adoc:63
33601msgid "_/dev/lp?_, _/proc/parport/*/*_"
33602msgstr ""
33603
33604#. type: Plain text
33605#: ../sys-utils/tunelp.8.adoc:67
33606#, no-wrap
33607msgid ""
33608"*-o*, *-C*, and *-s* all require a Linux kernel version of 1.1.76 or "
33609"later.\n"
33610msgstr ""
33611
33612#. type: Plain text
33613#: ../sys-utils/tunelp.8.adoc:69
33614#, no-wrap
33615msgid "*-C* requires a Linux version prior to 2.1.131.\n"
33616msgstr ""
33617
33618#. Copyright (c) 1996 Andries Brouwer
33619#. This page is somewhat derived from a page that was
33620#. (c) 1980, 1989, 1991 The Regents of the University of California
33621#. and had been heavily modified by Rik Faith and myself.
33622#
33623#. This is free documentation; you can redistribute it and/or
33624#. modify it under the terms of the GNU General Public License as
33625#. published by the Free Software Foundation; either version 2 of
33626#. the License, or (at your option) any later version.
33627#
33628#. The GNU General Public License's references to "object code"
33629#. and "executables" are to be interpreted as the output of any
33630#. document formatting or typesetting system, including
33631#. intermediate and printed output.
33632#
33633#. This manual is distributed in the hope that it will be useful,
33634#. but WITHOUT ANY WARRANTY; without even the implied warranty of
33635#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
33636#. GNU General Public License for more details.
33637#
33638#. You should have received a copy of the GNU General Public License along
33639#. with this program; if not, write to the Free Software Foundation, Inc.,
33640#. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
33641#. type: Title =
33642#: ../sys-utils/umount.8.adoc:27
33643#, no-wrap
33644msgid "umount(8)"
33645msgstr ""
33646
33647#. type: Plain text
33648#: ../sys-utils/umount.8.adoc:37
33649msgid "umount - unmount filesystems"
33650msgstr ""
33651
33652#. type: Plain text
33653#: ../sys-utils/umount.8.adoc:41
33654#, no-wrap
33655msgid "*umount* *-a* [*-dflnrv*] [*-t* _fstype_] [*-O* _option_...]\n"
33656msgstr ""
33657
33658#. type: Plain text
33659#: ../sys-utils/umount.8.adoc:43
33660#, no-wrap
33661msgid "*umount* [*-dflnrv*] {_directory_|_device_}\n"
33662msgstr ""
33663
33664#. type: Plain text
33665#: ../sys-utils/umount.8.adoc:45
33666#, no-wrap
33667msgid "*umount* *-h*|*-V*\n"
33668msgstr ""
33669
33670#. type: Plain text
33671#: ../sys-utils/umount.8.adoc:49
33672msgid ""
33673"The *umount* command detaches the mentioned filesystem(s) from the file "
33674"hierarchy. A filesystem is specified by giving the directory where it has "
33675"been mounted. Giving the special device on which the filesystem lives may "
33676"also work, but is obsolete, mainly because it will fail in case this device "
33677"was mounted on more than one directory."
33678msgstr ""
33679
33680#. type: Plain text
33681#: ../sys-utils/umount.8.adoc:51
33682msgid ""
33683"Note that a filesystem cannot be unmounted when it is 'busy' - for example, "
33684"when there are open files on it, or when some process has its working "
33685"directory there, or when a swap file on it is in use. The offending process "
33686"could even be *umount* itself - it opens libc, and libc in its turn may open "
33687"for example locale files. A lazy unmount avoids this problem, but it may "
33688"introduce other issues. See *--lazy* description below."
33689msgstr ""
33690
33691#. type: Plain text
33692#: ../sys-utils/umount.8.adoc:56
33693msgid ""
33694"All of the filesystems described in _/proc/self/mountinfo_ (or in deprecated "
33695"_/etc/mtab_) are unmounted, except the proc, devfs, devpts, sysfs, "
33696"rpc_pipefs and nfsd filesystems. This list of the filesystems may be "
33697"replaced by *--types* umount option."
33698msgstr ""
33699
33700#. type: Labeled list
33701#: ../sys-utils/umount.8.adoc:57
33702#, no-wrap
33703msgid "*-A*, *--all-targets*"
33704msgstr ""
33705
33706#. type: Plain text
33707#: ../sys-utils/umount.8.adoc:59
33708msgid ""
33709"Unmount all mountpoints in the current mount namespace for the specified "
33710"filesystem. The filesystem can be specified by one of the mountpoints or the "
33711"device name (or UUID, etc.). When this option is used together with "
33712"*--recursive*, then all nested mounts within the filesystem are recursively "
33713"unmounted. This option is only supported on systems where _/etc/mtab_ is a "
33714"symlink to _/proc/mounts_."
33715msgstr ""
33716
33717#. type: Plain text
33718#: ../sys-utils/umount.8.adoc:62
33719msgid ""
33720"Do not canonicalize paths. The paths canonicalization is based on *stat*(2) "
33721"and *readlink*(2) system calls. These system calls may hang in some cases "
33722"(for example on NFS if server is not available). The option has to be used "
33723"with canonical path to the mount point."
33724msgstr ""
33725
33726#. type: Plain text
33727#: ../sys-utils/umount.8.adoc:64
33728msgid "This option is silently ignored by *umount* for non-root users."
33729msgstr ""
33730
33731#. type: Plain text
33732#: ../sys-utils/umount.8.adoc:66
33733msgid ""
33734"For more details about this option see the *mount*(8) man page. Note that "
33735"*umount* does not pass this option to the **/sbin/umount.**__type__ helpers."
33736msgstr ""
33737
33738#. type: Labeled list
33739#: ../sys-utils/umount.8.adoc:67
33740#, no-wrap
33741msgid "*-d*, *--detach-loop*"
33742msgstr ""
33743
33744#. type: Plain text
33745#: ../sys-utils/umount.8.adoc:69
33746msgid ""
33747"When the unmounted device was a loop device, also free this loop "
33748"device. This option is unnecessary for devices initialized by *mount*(8), in "
33749"this case \"autoclear\" functionality is enabled by default."
33750msgstr ""
33751
33752#. type: Labeled list
33753#: ../sys-utils/umount.8.adoc:70
33754#, no-wrap
33755msgid "*--fake*"
33756msgstr ""
33757
33758#. type: Plain text
33759#: ../sys-utils/umount.8.adoc:72
33760msgid ""
33761"Causes everything to be done except for the actual system call or umount "
33762"helper execution; this 'fakes' unmounting the filesystem. It can be used to "
33763"remove entries from the deprecated _/etc/mtab_ that were unmounted earlier "
33764"with the *-n* option."
33765msgstr ""
33766
33767#. type: Plain text
33768#: ../sys-utils/umount.8.adoc:75
33769msgid "Force an unmount (in case of an unreachable NFS system)."
33770msgstr ""
33771
33772#. type: Plain text
33773#: ../sys-utils/umount.8.adoc:77
33774msgid ""
33775"Note that this option does not guarantee that umount command does not "
33776"hang. It's strongly recommended to use absolute paths without symlinks to "
33777"avoid unwanted readlink and stat system calls on unreachable NFS in "
33778"*umount*."
33779msgstr ""
33780
33781#. type: Labeled list
33782#: ../sys-utils/umount.8.adoc:78
33783#, no-wrap
33784msgid "*-i*, *--internal-only*"
33785msgstr ""
33786
33787#. type: Plain text
33788#: ../sys-utils/umount.8.adoc:80
33789msgid ""
33790"Do not call the **/sbin/umount.**__filesystem__ helper even if it exists. By "
33791"default such a helper program is called if it exists."
33792msgstr ""
33793
33794#. type: Labeled list
33795#: ../sys-utils/umount.8.adoc:81
33796#, no-wrap
33797msgid "*-l*, *--lazy*"
33798msgstr ""
33799
33800#. type: Plain text
33801#: ../sys-utils/umount.8.adoc:83
33802msgid ""
33803"Lazy unmount. Detach the filesystem from the file hierarchy now, and clean "
33804"up all references to this filesystem as soon as it is not busy anymore."
33805msgstr ""
33806
33807#. type: Plain text
33808#: ../sys-utils/umount.8.adoc:85
33809msgid ""
33810"A system reboot would be expected in near future if you're going to use this "
33811"option for network filesystem or local filesystem with submounts. The "
33812"recommended use-case for *umount -l* is to prevent hangs on shutdown due to "
33813"an unreachable network share where a normal umount will hang due to a downed "
33814"server or a network partition. Remounts of the share will not be possible."
33815msgstr ""
33816
33817#. type: Plain text
33818#: ../sys-utils/umount.8.adoc:88
33819msgid ""
33820"Perform umount in the mount namespace specified by _ns_. _ns_ is either PID "
33821"of process running in that namespace or special file representing that "
33822"namespace."
33823msgstr ""
33824
33825#. type: Plain text
33826#: ../sys-utils/umount.8.adoc:90
33827#, no-wrap
33828msgid ""
33829"*umount* switches to the namespace when it reads _/etc/fstab_, writes "
33830"_/etc/mtab_ (or writes to _/run/mount_) and calls *umount*(2) system call, "
33831"otherwise it runs in the original namespace. It means that the target mount "
33832"namespace does not have to contain any libraries or other requirements "
33833"necessary to execute *umount*(2) command.\n"
33834msgstr ""
33835
33836#. type: Plain text
33837#: ../sys-utils/umount.8.adoc:95
33838msgid "Unmount without writing in _/etc/mtab_."
33839msgstr ""
33840
33841#. type: Labeled list
33842#: ../sys-utils/umount.8.adoc:96
33843#, no-wrap
33844msgid "*-O*, *--test-opts* _option_..."
33845msgstr ""
33846
33847#. type: Plain text
33848#: ../sys-utils/umount.8.adoc:98
33849msgid ""
33850"Unmount only the filesystems that have the specified option set in "
33851"_/etc/fstab_. More than one option may be specified in a comma-separated "
33852"list. Each option can be prefixed with *no* to indicate that no action "
33853"should be taken for this option."
33854msgstr ""
33855
33856#. type: Plain text
33857#: ../sys-utils/umount.8.adoc:101
33858msgid "Suppress \"not mounted\" error messages."
33859msgstr ""
33860
33861#. type: Labeled list
33862#: ../sys-utils/umount.8.adoc:102
33863#, no-wrap
33864msgid "*-R*, *--recursive*"
33865msgstr ""
33866
33867#. type: Plain text
33868#: ../sys-utils/umount.8.adoc:104
33869msgid ""
33870"Recursively unmount each specified directory. Recursion for each directory "
33871"will stop if any unmount operation in the chain fails for any reason. The "
33872"relationship between mountpoints is determined by _/proc/self/mountinfo_ "
33873"entries. The filesystem must be specified by mountpoint path; a recursive "
33874"unmount by device name (or UUID) is unsupported. Since version 2.37 it "
33875"umounts also all over-mounted filesystems (more filesystems on the same "
33876"mountpoint)."
33877msgstr ""
33878
33879#. type: Plain text
33880#: ../sys-utils/umount.8.adoc:107
33881msgid "When an unmount fails, try to remount the filesystem read-only."
33882msgstr ""
33883
33884#. type: Labeled list
33885#: ../sys-utils/umount.8.adoc:108
33886#, no-wrap
33887msgid "*-t*, *--types* _type_..."
33888msgstr ""
33889
33890#. type: Plain text
33891#: ../sys-utils/umount.8.adoc:110
33892msgid ""
33893"Indicate that the actions should only be taken on filesystems of the "
33894"specified _type_. More than one type may be specified in a comma-separated "
33895"list. The list of filesystem types can be prefixed with *no* to indicate "
33896"that no action should be taken for all of the mentioned types. Note that "
33897"*umount* reads information about mounted filesystems from kernel "
33898"(_/proc/mounts_) and filesystem names may be different than filesystem names "
33899"used in the _/etc/fstab_ (e.g., \"nfs4\" vs. \"nfs\")."
33900msgstr ""
33901
33902#. type: Title ==
33903#: ../sys-utils/umount.8.adoc:120
33904#, no-wrap
33905msgid "NON-SUPERUSER UMOUNTS"
33906msgstr ""
33907
33908#. type: Plain text
33909#: ../sys-utils/umount.8.adoc:123
33910msgid ""
33911"Normally, only the superuser can umount filesystems. However, when _fstab_ "
33912"contains the *user* option on a line, anybody can umount the corresponding "
33913"filesystem. For more details see *mount*(8) man page."
33914msgstr ""
33915
33916#. type: Plain text
33917#: ../sys-utils/umount.8.adoc:125
33918msgid ""
33919"Since version 2.34 the *umount* command can be used to perform umount "
33920"operation also for fuse filesystems if kernel mount table contains user's "
33921"ID. In this case fstab *user=* mount option is not required."
33922msgstr ""
33923
33924#. type: Plain text
33925#: ../sys-utils/umount.8.adoc:127
33926msgid ""
33927"Since version 2.35 *umount* command does not exit when user permissions are "
33928"inadequate by internal libmount security rules. It drops suid permissions "
33929"and continue as regular non-root user. This can be used to support use-cases "
33930"where root permissions are not necessary (e.g., fuse filesystems, user "
33931"namespaces, etc)."
33932msgstr ""
33933
33934#. type: Title ==
33935#: ../sys-utils/umount.8.adoc:128
33936#, no-wrap
33937msgid "LOOP DEVICE"
33938msgstr ""
33939
33940#. type: Plain text
33941#: ../sys-utils/umount.8.adoc:131
33942msgid ""
33943"The *umount* command will automatically detach loop device previously "
33944"initialized by *mount*(8) command independently of _/etc/mtab_."
33945msgstr ""
33946
33947#. type: Plain text
33948#: ../sys-utils/umount.8.adoc:133
33949msgid ""
33950"In this case the device is initialized with \"autoclear\" flag (see "
33951"*losetup*(8) output for more details), otherwise it's necessary to use the "
33952"option *--detach-loop* or call *losetup -d <device>*. The autoclear feature "
33953"is supported since Linux 2.6.25."
33954msgstr ""
33955
33956#. type: Plain text
33957#: ../sys-utils/umount.8.adoc:137
33958msgid "The syntax of external unmount helpers is:"
33959msgstr ""
33960
33961#. type: delimited block _
33962#: ../sys-utils/umount.8.adoc:140
33963#, no-wrap
33964msgid ""
33965"**umount.**__suffix__ {__directory__|_device_} [*-flnrv*] [*-N* _namespace_] "
33966"[*-t* _type_._subtype_]\n"
33967msgstr ""
33968
33969#. type: Plain text
33970#: ../sys-utils/umount.8.adoc:143
33971msgid ""
33972"where _suffix_ is the filesystem type (or the value from a *uhelper=* or "
33973"*helper=* marker in the mtab file). The *-t* option can be used for "
33974"filesystems that have subtype support. For example:"
33975msgstr ""
33976
33977#. type: delimited block _
33978#: ../sys-utils/umount.8.adoc:146
33979#, no-wrap
33980msgid "*umount.fuse -t fuse.sshfs*\n"
33981msgstr ""
33982
33983#. type: Plain text
33984#: ../sys-utils/umount.8.adoc:149
33985msgid ""
33986"A **uhelper=**__something__ marker (unprivileged helper) can appear in the "
33987"_/etc/mtab_ file when ordinary users need to be able to unmount a mountpoint "
33988"that is not defined in _/etc/fstab_ (for example for a device that was "
33989"mounted by *udisks*(1))."
33990msgstr ""
33991
33992#. type: Plain text
33993#: ../sys-utils/umount.8.adoc:151
33994msgid ""
33995"A **helper=**__type__ marker in the mtab file will redirect all unmount "
33996"requests to the **/sbin/umount.**__type__ helper independently of UID."
33997msgstr ""
33998
33999#. type: Plain text
34000#: ../sys-utils/umount.8.adoc:153
34001msgid ""
34002"Note that _/etc/mtab_ is currently deprecated and *helper=* and other "
34003"userspace mount options are maintained by libmount."
34004msgstr ""
34005
34006#. type: Plain text
34007#: ../sys-utils/umount.8.adoc:158
34008msgid "overrides the default location of the fstab file (ignored for suid)"
34009msgstr ""
34010
34011#. type: Plain text
34012#: ../sys-utils/umount.8.adoc:161
34013msgid "overrides the default location of the mtab file (ignored for suid)"
34014msgstr ""
34015
34016#. type: Plain text
34017#: ../sys-utils/umount.8.adoc:164
34018msgid "enables *libmount* debug output"
34019msgstr ""
34020
34021#. type: Plain text
34022#: ../sys-utils/umount.8.adoc:169
34023msgid ""
34024"table of mounted filesystems (deprecated and usually replaced by symlink to "
34025"_/proc/mounts_)"
34026msgstr ""
34027
34028#. type: Plain text
34029#: ../sys-utils/umount.8.adoc:172
34030msgid "table of known filesystems"
34031msgstr ""
34032
34033#. type: Labeled list
34034#: ../sys-utils/umount.8.adoc:173
34035#, no-wrap
34036msgid "_/proc/self/mountinfo_"
34037msgstr ""
34038
34039#. type: Plain text
34040#: ../sys-utils/umount.8.adoc:175
34041msgid "table of mounted filesystems generated by kernel."
34042msgstr ""
34043
34044#. type: Plain text
34045#: ../sys-utils/umount.8.adoc:179
34046msgid "A *umount* command appeared in Version 6 AT&T UNIX."
34047msgstr ""
34048
34049#. type: Plain text
34050#: ../sys-utils/umount.8.adoc:186
34051#, no-wrap
34052msgid ""
34053"*umount*(2),\n"
34054"*losetup*(8),\n"
34055"*mount_namespaces*(7),\n"
34056"*mount*(8)\n"
34057msgstr ""
34058
34059#. type: Title =
34060#: ../sys-utils/unshare.1.adoc:2
34061#, no-wrap
34062msgid "unshare(1)"
34063msgstr ""
34064
34065#. type: Plain text
34066#: ../sys-utils/unshare.1.adoc:12
34067msgid "unshare - run program in new namespaces"
34068msgstr ""
34069
34070#. type: Plain text
34071#: ../sys-utils/unshare.1.adoc:16
34072#, no-wrap
34073msgid "*unshare* [options] [_program_ [_arguments_]\n"
34074msgstr ""
34075
34076#. type: Plain text
34077#: ../sys-utils/unshare.1.adoc:20
34078msgid ""
34079"The *unshare* command creates new namespaces (as specified by the "
34080"command-line options described below) and then executes the specified "
34081"_program_. If _program_ is not given, then \"${SHELL}\" is run (default: "
34082"_/bin/sh_)."
34083msgstr ""
34084
34085#. type: Plain text
34086#: ../sys-utils/unshare.1.adoc:22
34087msgid ""
34088"By default, a new namespace persists only as long as it has member "
34089"processes. A new namespace can be made persistent even when it has no member "
34090"processes by bind mounting /proc/_pid_/ns/_type_ files to a filesystem "
34091"path. A namespace that has been made persistent in this way can subsequently "
5db1d29a
MB
34092"be entered with *nsenter*(1) even after the _program_ terminates (except PID "
34093"namespaces where a permanently running init process is required). Once a "
34094"persistent namespace is no longer needed, it can be unpersisted by using "
36e96905
MB
34095"*umount*(8) to remove the bind mount. See the EXAMPLES section for more "
34096"details."
34097msgstr ""
34098
34099#. type: Plain text
34100#: ../sys-utils/unshare.1.adoc:24
34101#, no-wrap
34102msgid ""
34103"*unshare* since util-linux version 2.36 uses "
34104"_/proc/[pid]/ns/pid_for_children_ and _/proc/[pid]/ns/time_for_children_ "
34105"files for persistent PID and TIME namespaces. This change requires Linux "
34106"kernel 4.17 or newer.\n"
34107msgstr ""
34108
34109#. type: Plain text
34110#: ../sys-utils/unshare.1.adoc:26
34111msgid "The following types of namespaces can be created with *unshare*:"
34112msgstr ""
34113
34114#. type: Plain text
34115#: ../sys-utils/unshare.1.adoc:29
34116msgid ""
34117"Mounting and unmounting filesystems will not affect the rest of the system, "
34118"except for filesystems which are explicitly marked as shared (with *mount "
34119"--make-shared*; see _/proc/self/mountinfo_ or *findmnt -o+PROPAGATION* for "
34120"the *shared* flags). For further details, see *mount_namespaces*(7)."
34121msgstr ""
34122
34123#. type: Plain text
34124#: ../sys-utils/unshare.1.adoc:31
34125#, no-wrap
34126msgid ""
34127"*unshare* since util-linux version 2.27 automatically sets propagation to "
34128"*private* in a new mount namespace to make sure that the new namespace is "
34129"really unshared. It's possible to disable this feature with option "
34130"*--propagation unchanged*. Note that *private* is the kernel default.\n"
34131msgstr ""
34132
36e96905
MB
34133#. type: Plain text
34134#: ../sys-utils/unshare.1.adoc:43
34135msgid ""
34136"Children will have a distinct set of PID-to-process mappings from their "
34137"parent. For further details, see *pid_namespaces*(7)."
34138msgstr ""
34139
34140#. type: Labeled list
34141#: ../sys-utils/unshare.1.adoc:55
34142#, no-wrap
34143msgid "*-i*, *--ipc*[**=**__file__]"
34144msgstr ""
34145
34146#. type: Plain text
34147#: ../sys-utils/unshare.1.adoc:57
34148msgid ""
34149"Unshare the IPC namespace. If _file_ is specified, then a persistent "
34150"namespace is created by a bind mount."
34151msgstr ""
34152
34153#. type: Labeled list
34154#: ../sys-utils/unshare.1.adoc:58
34155#, no-wrap
34156msgid "*-m*, *--mount*[**=**__file__]"
34157msgstr ""
34158
34159#. type: Plain text
34160#: ../sys-utils/unshare.1.adoc:60
34161msgid ""
34162"Unshare the mount namespace. If _file_ is specified, then a persistent "
34163"namespace is created by a bind mount. Note that _file_ must be located on a "
34164"mount whose propagation type is not *shared* (or an error results). Use the "
34165"command *findmnt -o+PROPAGATION* when not sure about the current "
34166"setting. See also the examples below."
34167msgstr ""
34168
34169#. type: Labeled list
34170#: ../sys-utils/unshare.1.adoc:61
34171#, no-wrap
34172msgid "*-n*, *--net*[**=**__file__]"
34173msgstr ""
34174
34175#. type: Plain text
34176#: ../sys-utils/unshare.1.adoc:63
34177msgid ""
34178"Unshare the network namespace. If _file_ is specified, then a persistent "
34179"namespace is created by a bind mount."
34180msgstr ""
34181
34182#. type: Labeled list
34183#: ../sys-utils/unshare.1.adoc:64
34184#, no-wrap
34185msgid "*-p*, *--pid*[**=**__file__]"
34186msgstr ""
34187
34188#. type: Plain text
34189#: ../sys-utils/unshare.1.adoc:66
34190msgid ""
34191"Unshare the PID namespace. If _file_ is specified, then a persistent "
34192"namespace is created by a bind mount. (Creation of a persistent PID "
34193"namespace will fail if the *--fork* option is not also specified.)"
34194msgstr ""
34195
34196#. type: Plain text
34197#: ../sys-utils/unshare.1.adoc:68
34198msgid "See also the *--fork* and *--mount-proc* options."
34199msgstr ""
34200
34201#. type: Labeled list
34202#: ../sys-utils/unshare.1.adoc:69
34203#, no-wrap
34204msgid "*-u*, *--uts*[**=**__file__]"
34205msgstr ""
34206
34207#. type: Plain text
34208#: ../sys-utils/unshare.1.adoc:71
34209msgid ""
34210"Unshare the UTS namespace. If _file_ is specified, then a persistent "
34211"namespace is created by a bind mount."
34212msgstr ""
34213
34214#. type: Labeled list
34215#: ../sys-utils/unshare.1.adoc:72
34216#, no-wrap
34217msgid "*-U*, *--user*[**=**__file__]"
34218msgstr ""
34219
34220#. type: Plain text
34221#: ../sys-utils/unshare.1.adoc:74
34222msgid ""
34223"Unshare the user namespace. If _file_ is specified, then a persistent "
34224"namespace is created by a bind mount."
34225msgstr ""
34226
34227#. type: Labeled list
34228#: ../sys-utils/unshare.1.adoc:75
34229#, no-wrap
34230msgid "*-C*, *--cgroup*[**=**__file__]"
34231msgstr ""
34232
34233#. type: Plain text
34234#: ../sys-utils/unshare.1.adoc:77
34235msgid ""
34236"Unshare the cgroup namespace. If _file_ is specified, then persistent "
34237"namespace is created by bind mount."
34238msgstr ""
34239
34240#. type: Labeled list
34241#: ../sys-utils/unshare.1.adoc:78
34242#, no-wrap
34243msgid "*-T*, *--time*[**=**__file__]"
34244msgstr ""
34245
34246#. type: Plain text
34247#: ../sys-utils/unshare.1.adoc:80
34248msgid ""
34249"Unshare the time namespace. If _file_ is specified, then a persistent "
34250"namespace is created by a bind mount. The *--monotonic* and *--boottime* "
34251"options can be used to specify the corresponding offset in the time "
34252"namespace."
34253msgstr ""
34254
34255#. type: Plain text
34256#: ../sys-utils/unshare.1.adoc:83
34257msgid ""
34258"Fork the specified _program_ as a child process of *unshare* rather than "
34259"running it directly. This is useful when creating a new PID namespace. Note "
34260"that when *unshare* is waiting for the child process, then it ignores "
34261"*SIGINT* and *SIGTERM* and does not forward any signals to the child. It is "
34262"necessary to send signals to the child process."
34263msgstr ""
34264
34265#. type: Labeled list
34266#: ../sys-utils/unshare.1.adoc:84
34267#, no-wrap
34268msgid "*--keep-caps*"
34269msgstr ""
34270
34271#. type: Plain text
34272#: ../sys-utils/unshare.1.adoc:86
34273msgid ""
34274"When the *--user* option is given, ensure that capabilities granted in the "
34275"user namespace are preserved in the child process."
34276msgstr ""
34277
34278#. type: Labeled list
34279#: ../sys-utils/unshare.1.adoc:87
34280#, no-wrap
34281msgid "*--kill-child*[**=**__signame__]"
34282msgstr ""
34283
34284#. type: Plain text
34285#: ../sys-utils/unshare.1.adoc:89
34286msgid ""
34287"When *unshare* terminates, have _signame_ be sent to the forked child "
34288"process. Combined with *--pid* this allows for an easy and reliable killing "
34289"of the entire process tree below *unshare*. If not given, _signame_ defaults "
34290"to *SIGKILL*. This option implies *--fork*."
34291msgstr ""
34292
34293#. type: Labeled list
34294#: ../sys-utils/unshare.1.adoc:90
34295#, no-wrap
34296msgid "*--mount-proc*[**=**__mountpoint__]"
34297msgstr ""
34298
34299#. type: Plain text
34300#: ../sys-utils/unshare.1.adoc:92
34301msgid ""
34302"Just before running the program, mount the proc filesystem at _mountpoint_ "
34303"(default is _/proc_). This is useful when creating a new PID namespace. It "
34304"also implies creating a new mount namespace since the _/proc_ mount would "
34305"otherwise mess up existing programs on the system. The new proc filesystem "
34306"is explicitly mounted as private (with *MS_PRIVATE*|*MS_REC*)."
34307msgstr ""
34308
34309#. type: Labeled list
34310#: ../sys-utils/unshare.1.adoc:93
34311#, no-wrap
34312msgid "**--map-user=**__uid|name__"
34313msgstr ""
34314
34315#. type: Plain text
34316#: ../sys-utils/unshare.1.adoc:95
34317msgid ""
34318"Run the program only after the current effective user ID has been mapped to "
34319"_uid_. If this option is specified multiple times, the last occurrence takes "
34320"precedence. This option implies *--user*."
34321msgstr ""
34322
34323#. type: Labeled list
34324#: ../sys-utils/unshare.1.adoc:96
34325#, no-wrap
34326msgid "**--map-group=**__gid|name__"
34327msgstr ""
34328
34329#. type: Plain text
34330#: ../sys-utils/unshare.1.adoc:98
34331msgid ""
34332"Run the program only after the current effective group ID has been mapped to "
34333"_gid_. If this option is specified multiple times, the last occurrence takes "
34334"precedence. This option implies *--setgroups=deny* and *--user*."
34335msgstr ""
34336
34337#. type: Labeled list
34338#: ../sys-utils/unshare.1.adoc:99
34339#, no-wrap
34340msgid "*-r*, *--map-root-user*"
34341msgstr ""
34342
34343#. type: Plain text
34344#: ../sys-utils/unshare.1.adoc:101
34345msgid ""
34346"Run the program only after the current effective user and group IDs have "
34347"been mapped to the superuser UID and GID in the newly created user "
34348"namespace. This makes it possible to conveniently gain capabilities needed "
34349"to manage various aspects of the newly created namespaces (such as "
34350"configuring interfaces in the network namespace or mounting filesystems in "
34351"the mount namespace) even when run unprivileged. As a mere convenience "
34352"feature, it does not support more sophisticated use cases, such as mapping "
34353"multiple ranges of UIDs and GIDs. This option implies *--setgroups=deny* and "
34354"*--user*. This option is equivalent to *--map-user=0 --map-group=0*."
34355msgstr ""
34356
34357#. type: Labeled list
34358#: ../sys-utils/unshare.1.adoc:102
34359#, no-wrap
34360msgid "*-c*, *--map-current-user*"
34361msgstr ""
34362
34363#. type: Plain text
34364#: ../sys-utils/unshare.1.adoc:104
34365msgid ""
34366"Run the program only after the current effective user and group IDs have "
34367"been mapped to the same UID and GID in the newly created user "
34368"namespace. This option implies *--setgroups=deny* and *--user*. This option "
34369"is equivalent to *--map-user=$(id -ru) --map-group=$(id -rg)*."
34370msgstr ""
34371
34372#. type: Labeled list
34373#: ../sys-utils/unshare.1.adoc:105
34374#, no-wrap
34375msgid "**--propagation private**|**shared**|**slave**|*unchanged*"
34376msgstr ""
34377
34378#. type: Plain text
34379#: ../sys-utils/unshare.1.adoc:107
34380msgid ""
34381"Recursively set the mount propagation flag in the new mount namespace. The "
34382"default is to set the propagation to _private_. It is possible to disable "
34383"this feature with the argument *unchanged*. The option is silently ignored "
34384"when the mount namespace (*--mount*) is not requested."
34385msgstr ""
34386
34387#. type: Labeled list
34388#: ../sys-utils/unshare.1.adoc:108
34389#, no-wrap
34390msgid "**--setgroups allow**|*deny*"
34391msgstr ""
34392
34393#. type: Plain text
34394#: ../sys-utils/unshare.1.adoc:110
34395msgid "Allow or deny the *setgroups*(2) system call in a user namespace."
34396msgstr ""
34397
34398#. type: Plain text
34399#: ../sys-utils/unshare.1.adoc:112
34400msgid ""
34401"To be able to call *setgroups*(2), the calling process must at least have "
34402"*CAP_SETGID*. But since Linux 3.19 a further restriction applies: the kernel "
5db1d29a 34403"gives permission to call *setgroups*(2) only after the GID map "
36e96905 34404"(**/proc/**__pid__*/gid_map*) has been set. The GID map is writable by root "
5db1d29a
MB
34405"when *setgroups*(2) is enabled (i.e., *allow*, the default), and the GID map "
34406"becomes writable by unprivileged processes when *setgroups*(2) is "
36e96905
MB
34407"permanently disabled (with *deny*)."
34408msgstr ""
34409
34410#. type: Labeled list
34411#: ../sys-utils/unshare.1.adoc:113
34412#, no-wrap
34413msgid "*-R*, **--root=**__dir__"
34414msgstr ""
34415
34416#. type: Plain text
34417#: ../sys-utils/unshare.1.adoc:115
34418msgid "run the command with root directory set to _dir_."
34419msgstr ""
34420
34421#. type: Labeled list
34422#: ../sys-utils/unshare.1.adoc:116
34423#, no-wrap
34424msgid "*-w*, **--wd=**__dir__"
34425msgstr ""
34426
34427#. type: Plain text
34428#: ../sys-utils/unshare.1.adoc:118
34429msgid "change working directory to _dir_."
34430msgstr ""
34431
34432#. type: Plain text
34433#: ../sys-utils/unshare.1.adoc:121
34434msgid "Set the user ID which will be used in the entered namespace."
34435msgstr ""
34436
34437#. type: Plain text
34438#: ../sys-utils/unshare.1.adoc:124
34439msgid ""
34440"Set the group ID which will be used in the entered namespace and drop "
34441"supplementary groups."
34442msgstr ""
34443
34444#. type: Labeled list
34445#: ../sys-utils/unshare.1.adoc:125
34446#, no-wrap
34447msgid "*--monotonic* _offset_"
34448msgstr ""
34449
34450#. type: Plain text
34451#: ../sys-utils/unshare.1.adoc:127
34452msgid ""
34453"Set the offset of *CLOCK_MONOTONIC* which will be used in the entered time "
34454"namespace. This option requires unsharing a time namespace with *--time*."
34455msgstr ""
34456
34457#. type: Labeled list
34458#: ../sys-utils/unshare.1.adoc:128
34459#, no-wrap
34460msgid "*--boottime* _offset_"
34461msgstr ""
34462
34463#. type: Plain text
34464#: ../sys-utils/unshare.1.adoc:130
34465msgid ""
34466"Set the offset of *CLOCK_BOOTTIME* which will be used in the entered time "
34467"namespace. This option requires unsharing a time namespace with *--time*."
34468msgstr ""
34469
34470#. type: Plain text
34471#: ../sys-utils/unshare.1.adoc:140
34472msgid ""
34473"The proc and sysfs filesystems mounting as root in a user namespace have to "
34474"be restricted so that a less privileged user can not get more access to "
34475"sensitive files that a more privileged user made unavailable. In short the "
34476"rule for proc and sysfs is as close to a bind mount as possible."
34477msgstr ""
34478
34479#. type: Plain text
34480#: ../sys-utils/unshare.1.adoc:144
34481msgid ""
34482"The following command creates a PID namespace, using *--fork* to ensure that "
34483"the executed command is performed in a child process that (being the first "
34484"process in the namespace) has PID 1. The *--mount-proc* option ensures that "
34485"a new mount namespace is also simultaneously created and that a new "
34486"*proc*(5) filesystem is mounted that contains information corresponding to "
34487"the new PID namespace. When the *readlink* command terminates, the new "
34488"namespaces are automatically torn down."
34489msgstr ""
34490
34491#. type: delimited block .
34492#: ../sys-utils/unshare.1.adoc:148
34493#, no-wrap
34494msgid ""
34495"# unshare --fork --pid --mount-proc readlink /proc/self\n"
34496"1\n"
34497msgstr ""
34498
34499#. type: Plain text
34500#: ../sys-utils/unshare.1.adoc:151
34501msgid ""
34502"As an unprivileged user, create a new user namespace where the user's "
34503"credentials are mapped to the root IDs inside the namespace:"
34504msgstr ""
34505
34506#. type: delimited block .
34507#: ../sys-utils/unshare.1.adoc:161
34508#, no-wrap
34509msgid ""
34510"$ id -u; id -g\n"
34511"1000\n"
34512"1000\n"
34513"$ unshare --user --map-root-user \\\n"
34514" sh -c ''whoami; cat /proc/self/uid_map /proc/self/gid_map''\n"
34515"root\n"
34516" 0 1000 1\n"
34517" 0 1000 1\n"
34518msgstr ""
34519
34520#. type: Plain text
34521#: ../sys-utils/unshare.1.adoc:164
34522msgid ""
34523"The first of the following commands creates a new persistent UTS namespace "
34524"and modifies the hostname as seen in that namespace. The namespace is then "
34525"entered with *nsenter*(1) in order to display the modified hostname; this "
34526"step demonstrates that the UTS namespace continues to exist even though the "
34527"namespace had no member processes after the *unshare* command "
34528"terminated. The namespace is then destroyed by removing the bind mount."
34529msgstr ""
34530
34531#. type: delimited block .
34532#: ../sys-utils/unshare.1.adoc:171
34533#, no-wrap
34534msgid ""
34535"# touch /root/uts-ns\n"
34536"# unshare --uts=/root/uts-ns hostname FOO\n"
34537"# nsenter --uts=/root/uts-ns hostname\n"
34538"FOO\n"
34539"# umount /root/uts-ns\n"
34540msgstr ""
34541
34542#. type: Plain text
34543#: ../sys-utils/unshare.1.adoc:174
34544msgid ""
34545"The following commands establish a persistent mount namespace referenced by "
34546"the bind mount _/root/namespaces/mnt_. In order to ensure that the creation "
34547"of that bind mount succeeds, the parent directory (_/root/namespaces_) is "
34548"made a bind mount whose propagation type is not *shared*."
34549msgstr ""
34550
34551#. type: delimited block .
34552#: ../sys-utils/unshare.1.adoc:180
34553#, no-wrap
34554msgid ""
34555"# mount --bind /root/namespaces /root/namespaces\n"
34556"# mount --make-private /root/namespaces\n"
34557"# touch /root/namespaces/mnt\n"
34558"# unshare --mount=/root/namespaces/mnt\n"
34559msgstr ""
34560
34561#. type: Plain text
34562#: ../sys-utils/unshare.1.adoc:183
34563msgid ""
34564"The following commands demonstrate the use of the *--kill-child* option when "
34565"creating a PID namespace, in order to ensure that when *unshare* is killed, "
34566"all of the processes within the PID namespace are killed."
34567msgstr ""
34568
34569#. type: delimited block .
34570#: ../sys-utils/unshare.1.adoc:186
34571#, no-wrap
34572msgid "# set +m # Don't print job status messages\n"
34573msgstr ""
34574
34575#. type: delimited block .
34576#: ../sys-utils/unshare.1.adoc:189
34577#, no-wrap
34578msgid "# unshare --pid --fork --mount-proc --kill-child -- \\\n"
34579msgstr ""
34580
34581#. type: delimited block .
34582#: ../sys-utils/unshare.1.adoc:197
34583#, no-wrap
34584msgid ""
34585" bash --norc -c ''(sleep 555 &) && (ps a &) && sleep 999'' &\n"
34586"[1] 53456\n"
34587"# PID TTY STAT TIME COMMAND\n"
34588" 1 pts/3 S+ 0:00 sleep 999\n"
34589" 3 pts/3 S+ 0:00 sleep 555\n"
34590" 5 pts/3 R+ 0:00 ps a\n"
34591msgstr ""
34592
34593#. type: delimited block .
34594#: ../sys-utils/unshare.1.adoc:202
34595#, no-wrap
34596msgid ""
34597"# ps h -o 'comm' $! # Show that background job is unshare(1)\n"
34598"unshare\n"
34599"# kill $! # Kill unshare(1)\n"
34600"# pidof sleep\n"
34601msgstr ""
34602
34603#. type: Plain text
34604#: ../sys-utils/unshare.1.adoc:205
34605msgid ""
34606"The *pidof*(1) command prints no output, because the *sleep* processes have "
34607"been killed. More precisely, when the *sleep* process that has PID 1 in the "
34608"namespace (i.e., the namespace's init process) was killed, this caused all "
34609"other processes in the namespace to be killed. By contrast, a similar series "
34610"of commands where the *--kill-child* option is not used shows that when "
34611"*unshare* terminates, the processes in the PID namespace are not killed:"
34612msgstr ""
34613
34614#. type: delimited block .
34615#: ../sys-utils/unshare.1.adoc:208
34616#, no-wrap
34617msgid "# unshare --pid --fork --mount-proc -- \\\n"
34618msgstr ""
34619
34620#. type: delimited block .
34621#: ../sys-utils/unshare.1.adoc:216
34622#, no-wrap
34623msgid ""
34624" bash --norc -c ''(sleep 555 &) && (ps a &) && sleep 999'' &\n"
34625"[1] 53479\n"
34626"# PID TTY STAT TIME COMMAND\n"
34627" 1 pts/3 S+ 0:00 sleep 999\n"
34628" 3 pts/3 S+ 0:00 sleep 555\n"
34629" 5 pts/3 R+ 0:00 ps a\n"
34630msgstr ""
34631
34632#. type: delimited block .
34633#: ../sys-utils/unshare.1.adoc:220
34634#, no-wrap
34635msgid ""
34636"# kill $!\n"
34637"# pidof sleep\n"
34638"53482 53480\n"
34639msgstr ""
34640
34641#. type: Plain text
34642#: ../sys-utils/unshare.1.adoc:223
34643msgid ""
34644"The following example demonstrates the creation of a time namespace where "
34645"the boottime clock is set to a point several years in the past:"
34646msgstr ""
34647
34648#. type: delimited block .
34649#: ../sys-utils/unshare.1.adoc:229
34650#, no-wrap
34651msgid ""
34652"# uptime -p # Show uptime in initial time namespace\n"
34653"up 21 hours, 30 minutes\n"
34654"# unshare --time --fork --boottime 300000000 uptime -p\n"
34655"up 9 years, 28 weeks, 1 day, 2 hours, 50 minutes\n"
34656msgstr ""
34657
34658#. type: Plain text
34659#: ../sys-utils/unshare.1.adoc:235
34660msgid ""
34661"mailto:dottedmag@dottedmag.net[Mikhail Gusarov], "
34662"mailto:kzak@redhat.com[Karel Zak]"
34663msgstr ""
34664
34665#. type: Plain text
34666#: ../sys-utils/unshare.1.adoc:242
34667#, no-wrap
34668msgid ""
34669"*clone*(2),\n"
34670"*unshare*(2),\n"
34671"*namespaces*(7),\n"
34672"*mount*(8)\n"
34673msgstr ""
34674
34675#. type: Title =
34676#: ../sys-utils/wdctl.8.adoc:2
34677#, no-wrap
34678msgid "wdctl(8)"
34679msgstr ""
34680
34681#. type: Plain text
34682#: ../sys-utils/wdctl.8.adoc:12
34683msgid "wdctl - show hardware watchdog status"
34684msgstr ""
34685
34686#. type: Plain text
34687#: ../sys-utils/wdctl.8.adoc:16
34688#, no-wrap
34689msgid "*wdctl* [options] [_device_...]\n"
34690msgstr ""
34691
34692#. type: Plain text
34693#: ../sys-utils/wdctl.8.adoc:20
34694msgid ""
34695"Show hardware watchdog status. The default device is _/dev/watchdog_. If "
34696"more than one device is specified then the output is separated by one blank "
34697"line."
34698msgstr ""
34699
34700#. type: Plain text
34701#: ../sys-utils/wdctl.8.adoc:22
34702msgid ""
34703"If the device is already used or user has no permissions to read from the "
34704"device, then *wdctl* reads data from sysfs. In this case information about "
34705"supported features (flags) might be missing."
34706msgstr ""
34707
34708#. type: Plain text
34709#: ../sys-utils/wdctl.8.adoc:24
34710msgid "Note that the number of supported watchdog features is hardware specific."
34711msgstr ""
34712
34713#. type: Labeled list
34714#: ../sys-utils/wdctl.8.adoc:27
34715#, no-wrap
34716msgid "*-f*, *--flags* _list_"
34717msgstr ""
34718
34719#. type: Plain text
34720#: ../sys-utils/wdctl.8.adoc:29
34721msgid "Print only the specified flags."
34722msgstr ""
34723
34724#. type: Labeled list
34725#: ../sys-utils/wdctl.8.adoc:30
34726#, no-wrap
34727msgid "*-F*, *--noflags*"
34728msgstr ""
34729
34730#. type: Plain text
34731#: ../sys-utils/wdctl.8.adoc:32
34732msgid "Do not print information about flags."
34733msgstr ""
34734
34735#. type: Labeled list
34736#: ../sys-utils/wdctl.8.adoc:33
34737#, no-wrap
34738msgid "*-I*, *--noident*"
34739msgstr ""
34740
34741#. type: Plain text
34742#: ../sys-utils/wdctl.8.adoc:35
34743msgid "Do not print watchdog identity information."
34744msgstr ""
34745
34746#. type: Plain text
34747#: ../sys-utils/wdctl.8.adoc:38
34748msgid "Do not print a header line for flags table."
34749msgstr ""
34750
34751#. type: Plain text
34752#: ../sys-utils/wdctl.8.adoc:41
34753msgid ""
34754"Define the output columns to use in table of watchdog flags. If no output "
34755"arrangement is specified, then a default set is used. Use *--help* to get "
34756"list of all supported columns."
34757msgstr ""
34758
34759#. type: Labeled list
34760#: ../sys-utils/wdctl.8.adoc:42
34761#, no-wrap
34762msgid "*-O*, *--oneline*"
34763msgstr ""
34764
34765#. type: Plain text
34766#: ../sys-utils/wdctl.8.adoc:44
34767msgid "Print all wanted information on one line in key=\"value\" output format."
34768msgstr ""
34769
34770#. type: Labeled list
34771#: ../sys-utils/wdctl.8.adoc:48
34772#, no-wrap
34773msgid "*-s*, *-settimeout* _seconds_"
34774msgstr ""
34775
34776#. type: Plain text
34777#: ../sys-utils/wdctl.8.adoc:50
34778msgid "Set the watchdog timeout in seconds."
34779msgstr ""
34780
34781#. type: Labeled list
34782#: ../sys-utils/wdctl.8.adoc:51
34783#, no-wrap
34784msgid "*-T*, *--notimeouts*"
34785msgstr ""
34786
34787#. type: Plain text
34788#: ../sys-utils/wdctl.8.adoc:53
34789msgid "Do not print watchdog timeouts."
34790msgstr ""
34791
34792#. type: Labeled list
34793#: ../sys-utils/wdctl.8.adoc:54
34794#, no-wrap
34795msgid "*-x*, *--flags-only*"
34796msgstr ""
34797
34798#. type: Plain text
34799#: ../sys-utils/wdctl.8.adoc:56
34800msgid "Same as *-I -T*."
34801msgstr ""
34802
34803#. type: Plain text
34804#: ../sys-utils/wdctl.8.adoc:67
34805msgid ""
34806"mailto:kzak@redhat.com[Karel Zak], mailto:lennart@poettering.net[Lennart "
34807"Poettering]"
34808msgstr ""
34809
34810#. type: Title =
34811#: ../sys-utils/zramctl.8.adoc:2
34812#, no-wrap
34813msgid "zramctl(8)"
34814msgstr ""
34815
34816#. type: Plain text
34817#: ../sys-utils/zramctl.8.adoc:12
34818msgid "zramctl - set up and control zram devices"
34819msgstr ""
34820
34821#. type: Labeled list
34822#: ../sys-utils/zramctl.8.adoc:15
34823#, no-wrap
34824msgid "Get info: "
34825msgstr ""
34826
34827#. type: Plain text
34828#: ../sys-utils/zramctl.8.adoc:18
34829#, no-wrap
34830msgid "*zramctl* [options]\n"
34831msgstr ""
34832
34833#. type: Labeled list
34834#: ../sys-utils/zramctl.8.adoc:19
34835#, no-wrap
34836msgid "Reset zram: "
34837msgstr ""
34838
34839#. type: Plain text
34840#: ../sys-utils/zramctl.8.adoc:22
34841#, no-wrap
34842msgid "*zramctl* *-r* _zramdev_...\n"
34843msgstr ""
34844
34845#. type: Labeled list
34846#: ../sys-utils/zramctl.8.adoc:23
34847#, no-wrap
34848msgid "Print name of first unused zram device: "
34849msgstr ""
34850
34851#. type: Plain text
34852#: ../sys-utils/zramctl.8.adoc:26
34853#, no-wrap
34854msgid "*zramctl* *-f*\n"
34855msgstr ""
34856
34857#. type: Labeled list
34858#: ../sys-utils/zramctl.8.adoc:27
34859#, no-wrap
34860msgid "Set up a zram device: "
34861msgstr ""
34862
34863#. type: Plain text
34864#: ../sys-utils/zramctl.8.adoc:30
34865#, no-wrap
34866msgid ""
34867"*zramctl* [*-f* | _zramdev_] [*-s* _size_] [*-t* _number_] [*-a* "
34868"_algorithm_]\n"
34869msgstr ""
34870
34871#. type: Plain text
34872#: ../sys-utils/zramctl.8.adoc:34
34873#, no-wrap
34874msgid ""
34875"*zramctl* is used to quickly set up zram device parameters, to reset zram "
34876"devices, and to query the status of used zram devices.\n"
34877msgstr ""
34878
34879#. type: Plain text
34880#: ../sys-utils/zramctl.8.adoc:36
34881msgid "If no option is given, all non-zero size zram devices are shown."
34882msgstr ""
34883
34884#. type: Plain text
34885#: ../sys-utils/zramctl.8.adoc:38
34886msgid ""
34887"Note that _zramdev_ node specified on command line has to already exist. The "
34888"command *zramctl* creates a new _/dev/zram<N>_ nodes only when *--find* "
34889"option specified. It's possible (and common) that after system boot "
34890"_/dev/zram<N>_ nodes are not created yet."
34891msgstr ""
34892
34893#. type: Labeled list
34894#: ../sys-utils/zramctl.8.adoc:41
34895#, no-wrap
34896msgid "*-a*, **--algorithm lzo**|**lz4**|**lz4hc**|**deflate**|*842*"
34897msgstr ""
34898
34899#. type: Plain text
34900#: ../sys-utils/zramctl.8.adoc:43
34901msgid ""
34902"Set the compression algorithm to be used for compressing data in the zram "
34903"device."
34904msgstr ""
34905
34906#. type: Labeled list
34907#: ../sys-utils/zramctl.8.adoc:44
34908#, no-wrap
34909msgid "*-f*, *--find*"
34910msgstr ""
34911
34912#. type: Plain text
34913#: ../sys-utils/zramctl.8.adoc:46
34914msgid ""
34915"Find the first unused zram device. If a *--size* argument is present, then "
34916"initialize the device."
34917msgstr ""
34918
34919#. type: Plain text
34920#: ../sys-utils/zramctl.8.adoc:52
34921msgid ""
34922"Define the status output columns to be used. If no output arrangement is "
34923"specified, then a default set is used. Use *--help* to get a list of all "
34924"supported columns."
34925msgstr ""
34926
34927#. type: Plain text
34928#: ../sys-utils/zramctl.8.adoc:58
34929msgid "Use the raw format for status output."
34930msgstr ""
34931
34932#. type: Plain text
34933#: ../sys-utils/zramctl.8.adoc:61
34934msgid ""
34935"Reset the options of the specified zram device(s). Zram device settings can "
34936"be changed only after a reset."
34937msgstr ""
34938
34939#. type: Labeled list
34940#: ../sys-utils/zramctl.8.adoc:62
34941#, no-wrap
34942msgid "*-s*, *--size* _size_"
34943msgstr ""
34944
34945#. type: Plain text
34946#: ../sys-utils/zramctl.8.adoc:64
34947msgid ""
34948"Create a zram device of the specified _size_. Zram devices are aligned to "
34949"memory pages; when the requested _size_ is not a multiple of the page size, "
34950"it will be rounded up to the next multiple. When not otherwise specified, "
34951"the unit of the _size_ parameter is bytes."
34952msgstr ""
34953
34954#. type: Plain text
34955#: ../sys-utils/zramctl.8.adoc:66
34956msgid ""
34957"The _size_ argument may be followed by the multiplicative suffixes KiB "
34958"(=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
34959"(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\") or the "
34960"suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and "
34961"YB."
34962msgstr ""
34963
34964#. type: Labeled list
34965#: ../sys-utils/zramctl.8.adoc:67
34966#, no-wrap
34967msgid "*-t*, *--streams* _number_"
34968msgstr ""
34969
34970#. type: Plain text
34971#: ../sys-utils/zramctl.8.adoc:69
34972msgid ""
34973"Set the maximum number of compression streams that can be used for the "
34974"device. The default is one stream."
34975msgstr ""
34976
34977#. type: Plain text
34978#: ../sys-utils/zramctl.8.adoc:79
34979#, no-wrap
34980msgid "*zramctl* returns 0 on success, nonzero on failure.\n"
34981msgstr ""
34982
34983#. type: Labeled list
34984#: ../sys-utils/zramctl.8.adoc:82
34985#, no-wrap
34986msgid "_/dev/zram[0..N]_"
34987msgstr ""
34988
34989#. type: Plain text
34990#: ../sys-utils/zramctl.8.adoc:84
34991msgid "zram block devices"
34992msgstr ""
34993
34994#. type: Plain text
34995#: ../sys-utils/zramctl.8.adoc:88
34996msgid ""
34997"The following commands set up a zram device with a size of one gigabyte and "
34998"use it as swap device."
34999msgstr ""
35000
35001#. type: delimited block .
35002#: ../sys-utils/zramctl.8.adoc:97
35003#, no-wrap
35004msgid ""
35005" # zramctl --find --size 1024M\n"
35006" /dev/zram0\n"
35007" # mkswap /dev/zram0\n"
35008" # swapon /dev/zram0\n"
35009" ...\n"
35010" # swapoff /dev/zram0\n"
35011" # zramctl --reset /dev/zram0\n"
35012msgstr ""
35013
35014#. type: Plain text
35015#: ../sys-utils/zramctl.8.adoc:103
35016msgid ""
35017"mailto:nefelim4ag@gmail.com[Timofey Titovets], mailto:kzak@redhat.com[Karel "
35018"Zak]"
35019msgstr ""
35020
35021#. type: Plain text
35022#: ../sys-utils/zramctl.8.adoc:107
35023msgid ""
35024"link:http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/Documentation/admin-guide/blockdev/zram.rst[Linux "
35025"kernel documentation]"
35026msgstr ""
35027
35028#. type: Title =
35029#: ../term-utils/agetty.8.adoc:2
35030#, no-wrap
35031msgid "agetty(8)"
35032msgstr ""
35033
35034#. type: Plain text
35035#: ../term-utils/agetty.8.adoc:12
35036msgid "agetty - alternative Linux getty"
35037msgstr ""
35038
35039#. type: Plain text
35040#: ../term-utils/agetty.8.adoc:16
35041#, no-wrap
35042msgid "*agetty* [options] _port_ [_baud_rate_...] [_term_]\n"
35043msgstr ""
35044
35045#. type: Plain text
35046#: ../term-utils/agetty.8.adoc:20
35047#, no-wrap
35048msgid ""
35049"*agetty* opens a tty port, prompts for a login name and invokes the "
35050"/bin/login command. It is normally invoked by *init*(8).\n"
35051msgstr ""
35052
35053#. type: Plain text
35054#: ../term-utils/agetty.8.adoc:22
35055#, no-wrap
35056msgid ""
35057"*agetty* has several _non-standard_ features that are useful for hardwired "
35058"and for dial-in lines:\n"
35059msgstr ""
35060
35061#. type: Plain text
35062#: ../term-utils/agetty.8.adoc:24
35063msgid ""
35064"Adapts the tty settings to parity bits and to erase, kill, end-of-line and "
35065"uppercase characters when it reads a login name. The program can handle "
35066"7-bit characters with even, odd, none or space parity, and 8-bit characters "
35067"with no parity. The following special characters are recognized: Control-U "
35068"(kill); DEL and backspace (erase); carriage return and line feed (end of "
35069"line). See also the *--erase-chars* and *--kill-chars* options."
35070msgstr ""
35071
35072#. type: Plain text
35073#: ../term-utils/agetty.8.adoc:25
35074msgid ""
35075"Optionally deduces the baud rate from the CONNECT messages produced by "
35076"Hayes(tm)-compatible modems."
35077msgstr ""
35078
35079#. type: Plain text
35080#: ../term-utils/agetty.8.adoc:26
35081msgid ""
35082"Optionally does not hang up when it is given an already opened line (useful "
35083"for call-back applications)."
35084msgstr ""
35085
35086#. type: Plain text
35087#: ../term-utils/agetty.8.adoc:27
35088msgid "Optionally does not display the contents of the _/etc/issue_ file."
35089msgstr ""
35090
35091#. type: Plain text
35092#: ../term-utils/agetty.8.adoc:28
35093msgid ""
35094"Optionally displays an alternative issue files or directories instead of "
35095"_/etc/issue_ or _/etc/issue.d_."
35096msgstr ""
35097
35098#. type: Plain text
35099#: ../term-utils/agetty.8.adoc:29
35100msgid "Optionally does not ask for a login name."
35101msgstr ""
35102
35103#. type: Plain text
35104#: ../term-utils/agetty.8.adoc:30
35105msgid "Optionally invokes a non-standard login program instead of _/bin/login_."
35106msgstr ""
35107
35108#. type: Plain text
35109#: ../term-utils/agetty.8.adoc:31
35110msgid "Optionally turns on hardware flow control."
35111msgstr ""
35112
35113#. type: Plain text
35114#: ../term-utils/agetty.8.adoc:32
35115msgid "Optionally forces the line to be local with no need for carrier detect."
35116msgstr ""
35117
35118#. type: Plain text
35119#: ../term-utils/agetty.8.adoc:34
35120msgid ""
35121"This program does not use the _/etc/gettydefs_ (System V) or _/etc/gettytab_ "
35122"(SunOS 4) files."
35123msgstr ""
35124
35125#. type: Labeled list
35126#: ../term-utils/agetty.8.adoc:37
35127#, no-wrap
35128msgid "_port_"
35129msgstr ""
35130
35131#. type: Plain text
35132#: ../term-utils/agetty.8.adoc:39
35133msgid ""
35134"A path name relative to the _/dev_ directory. If a \"-\" is specified, "
35135"*agetty* assumes that its standard input is already connected to a tty port "
35136"and that a connection to a remote user has already been established."
35137msgstr ""
35138
35139#. type: Plain text
35140#: ../term-utils/agetty.8.adoc:41
35141msgid "Under System V, a \"-\" _port_ argument should be preceded by a \"--\"."
35142msgstr ""
35143
35144#. type: Labeled list
35145#: ../term-utils/agetty.8.adoc:42
35146#, no-wrap
35147msgid "_baud_rate_,..."
35148msgstr ""
35149
35150#. type: Plain text
35151#: ../term-utils/agetty.8.adoc:44
35152msgid ""
35153"A comma-separated list of one or more baud rates. Each time *agetty* "
35154"receives a BREAK character it advances through the list, which is treated as "
35155"if it were circular."
35156msgstr ""
35157
35158#. type: Plain text
35159#: ../term-utils/agetty.8.adoc:46
35160msgid ""
35161"Baud rates should be specified in descending order, so that the null "
35162"character (Ctrl-@) can also be used for baud-rate switching."
35163msgstr ""
35164
35165#. type: Plain text
35166#: ../term-utils/agetty.8.adoc:48
35167msgid "This argument is optional and unnecessary for *virtual terminals*."
35168msgstr ""
35169
35170#. type: Plain text
35171#: ../term-utils/agetty.8.adoc:50
35172msgid ""
35173"The default for *serial terminals* is keep the current baud rate (see "
35174"*--keep-baud*) and if unsuccessful then default to '9600'."
35175msgstr ""
35176
35177#. type: Labeled list
35178#: ../term-utils/agetty.8.adoc:51
35179#, no-wrap
35180msgid "_term_"
35181msgstr ""
35182
35183#. type: Plain text
35184#: ../term-utils/agetty.8.adoc:53
35185msgid ""
35186"The value to be used for the *TERM* environment variable. This overrides "
35187"whatever *init*(1) may have set, and is inherited by login and the shell."
35188msgstr ""
35189
35190#. type: Plain text
35191#: ../term-utils/agetty.8.adoc:55
35192msgid ""
35193"The default is 'vt100', or 'linux' for Linux on a virtual terminal, or "
35194"'hurd' for GNU Hurd on a virtual terminal."
35195msgstr ""
35196
35197#. type: Labeled list
35198#: ../term-utils/agetty.8.adoc:58
35199#, no-wrap
35200msgid "*-8*, *--8bits*"
35201msgstr ""
35202
35203#. type: Plain text
35204#: ../term-utils/agetty.8.adoc:60
35205msgid "Assume that the tty is 8-bit clean, hence disable parity detection."
35206msgstr ""
35207
35208#. type: Labeled list
35209#: ../term-utils/agetty.8.adoc:61
35210#, no-wrap
35211msgid "*-a*, *--autologin* _username_"
35212msgstr ""
35213
35214#. type: Plain text
35215#: ../term-utils/agetty.8.adoc:63
35216msgid ""
35217"Automatically log in the specified user without asking for a username or "
35218"password. Using this option causes an *-f* _username_ option and argument to "
35219"be added to the */bin/login* command line. See *--login-options*, which can "
35220"be used to modify this option's behavior."
35221msgstr ""
35222
35223#. type: Plain text
35224#: ../term-utils/agetty.8.adoc:65
35225msgid ""
35226"Note that *--autologin* may affect the way in which *getty* initializes the "
35227"serial line, because on auto-login *agetty* does not read from the line and "
35228"it has no opportunity optimize the line setting."
35229msgstr ""
35230
35231#. type: Labeled list
35232#: ../term-utils/agetty.8.adoc:66
35233#, no-wrap
35234msgid "*-c*, *--noreset*"
35235msgstr ""
35236
35237#. type: Plain text
35238#: ../term-utils/agetty.8.adoc:68
35239msgid ""
35240"Do not reset terminal cflags (control modes). See *termios*(3) for more "
35241"details."
35242msgstr ""
35243
35244#. type: Labeled list
35245#: ../term-utils/agetty.8.adoc:69
35246#, no-wrap
35247msgid "*-E*, *--remote*"
35248msgstr ""
35249
35250#. type: Plain text
35251#: ../term-utils/agetty.8.adoc:71
35252msgid ""
35253"Typically the *login*(1) command is given a remote hostname when called by "
35254"something such as *telnetd*(8). This option allows *agetty* to pass what it "
35255"is using for a hostname to *login*(1) for use in *utmp*(5). See *--host*, "
35256"*login*(1), and *utmp*(5)."
35257msgstr ""
35258
35259#. type: Plain text
35260#: ../term-utils/agetty.8.adoc:73
35261msgid ""
35262"If the *--host* _fakehost_ option is given, then an *-h* _fakehost_ option "
35263"and argument are added to the _/bin/login_ command line."
35264msgstr ""
35265
35266#. type: Plain text
35267#: ../term-utils/agetty.8.adoc:75
35268msgid ""
35269"If the *--nohostname* option is given, then an *-H* option is added to the "
35270"*/bin/login* command line."
35271msgstr ""
35272
35273#. type: Plain text
35274#: ../term-utils/agetty.8.adoc:77
35275msgid "See *--login-options*."
35276msgstr ""
35277
35278#. type: Labeled list
35279#: ../term-utils/agetty.8.adoc:78
35280#, no-wrap
35281msgid "*-f*, *--issue-file* _path_"
35282msgstr ""
35283
35284#. type: Plain text
35285#: ../term-utils/agetty.8.adoc:80
35286msgid ""
35287"Specifies a \":\" delimited list of files and directories to be displayed "
35288"instead of _/etc/issue_ (or other). All specified files and directories are "
35289"displayed, missing or empty files are silently ignored. If the specified "
35290"path is a directory then display all files with .issue file extension in "
35291"version-sort order from the directory. This allows custom messages to be "
35292"displayed on different terminals. The *--noissue* option will override this "
35293"option."
35294msgstr ""
35295
35296#. type: Labeled list
35297#: ../term-utils/agetty.8.adoc:81
35298#, no-wrap
35299msgid "*--show-issue*"
35300msgstr ""
35301
35302#. type: Plain text
35303#: ../term-utils/agetty.8.adoc:83
35304msgid ""
35305"Display the current issue file (or other) on the current terminal and "
35306"exit. Use this option to review the current setting, it is not designed for "
35307"any other purpose. Note that output may use some default or incomplete "
35308"information as proper output depends on terminal and agetty command line."
35309msgstr ""
35310
35311#. type: Labeled list
35312#: ../term-utils/agetty.8.adoc:84
35313#, no-wrap
35314msgid "*-h, --flow-control*"
35315msgstr ""
35316
35317#. type: Plain text
35318#: ../term-utils/agetty.8.adoc:86
35319msgid ""
35320"Enable hardware (RTS/CTS) flow control. It is left up to the application to "
35321"disable software (XON/XOFF) flow protocol where appropriate."
35322msgstr ""
35323
35324#. type: Labeled list
35325#: ../term-utils/agetty.8.adoc:87
35326#, no-wrap
35327msgid "*-H*, *--host* _fakehost_"
35328msgstr ""
35329
35330#. type: Plain text
35331#: ../term-utils/agetty.8.adoc:89
35332msgid ""
35333"Write the specified _fakehost_ into the utmp file. Normally, no login host "
35334"is given, since *agetty* is used for local hardwired connections and "
35335"consoles. However, this option can be useful for identifying terminal "
35336"concentrators and the like."
35337msgstr ""
35338
35339#. type: Labeled list
35340#: ../term-utils/agetty.8.adoc:90
35341#, no-wrap
35342msgid "*-i*, *--noissue*"
35343msgstr ""
35344
35345#. type: Plain text
35346#: ../term-utils/agetty.8.adoc:92
35347msgid ""
35348"Do not display the contents of _/etc/issue_ (or other) before writing the "
35349"login prompt. Terminals or communications hardware may become confused when "
35350"receiving lots of text at the wrong baud rate; dial-up scripts may fail if "
35351"the login prompt is preceded by too much text."
35352msgstr ""
35353
35354#. type: Labeled list
35355#: ../term-utils/agetty.8.adoc:93
35356#, no-wrap
35357msgid "*-I*, *--init-string* _initstring_"
35358msgstr ""
35359
35360#. type: Plain text
35361#: ../term-utils/agetty.8.adoc:95
35362msgid ""
35363"Set an initial string to be sent to the tty or modem before sending anything "
35364"else. This may be used to initialize a modem. Non-printable characters may "
35365"be sent by writing their octal code preceded by a backslash (\\). For "
35366"example, to send a linefeed character (ASCII 10, octal 012), write \\12."
35367msgstr ""
35368
35369#. type: Labeled list
35370#: ../term-utils/agetty.8.adoc:96
35371#, no-wrap
35372msgid "*-J*, *--noclear*"
35373msgstr ""
35374
35375#. type: Plain text
35376#: ../term-utils/agetty.8.adoc:98
35377msgid ""
35378"Do not clear the screen before prompting for the login name. By default the "
35379"screen is cleared."
35380msgstr ""
35381
35382#. type: Labeled list
35383#: ../term-utils/agetty.8.adoc:99
35384#, no-wrap
35385msgid "*-l*, *--login-program* _login_program_"
35386msgstr ""
35387
35388#. type: Plain text
35389#: ../term-utils/agetty.8.adoc:101
35390msgid ""
35391"Invoke the specified _login_program_ instead of /bin/login. This allows the "
35392"use of a non-standard login program. Such a program could, for example, ask "
35393"for a dial-up password or use a different password file. See "
35394"*--login-options*."
35395msgstr ""
35396
35397#. type: Labeled list
35398#: ../term-utils/agetty.8.adoc:102
35399#, no-wrap
35400msgid "*-L*, *--local-line*[=__mode__]"
35401msgstr ""
35402
35403#. type: Plain text
35404#: ../term-utils/agetty.8.adoc:104
35405msgid ""
35406"Control the CLOCAL line flag. The optional _mode_ argument is 'auto', "
35407"'always' or 'never'. If the _mode_ argument is omitted, then the default is "
35408"'always'. If the *--local-line* option is not given at all, then the default "
35409"is 'auto'."
35410msgstr ""
35411
35412#. type: Labeled list
35413#: ../term-utils/agetty.8.adoc:105
35414#, no-wrap
35415msgid "_always_"
35416msgstr ""
35417
35418#. type: Plain text
35419#: ../term-utils/agetty.8.adoc:107
35420msgid ""
35421"Forces the line to be a local line with no need for carrier detect. This can "
35422"be useful when you have a locally attached terminal where the serial line "
35423"does not set the carrier-detect signal."
35424msgstr ""
35425
35426#. type: Labeled list
35427#: ../term-utils/agetty.8.adoc:107
35428#, no-wrap
35429msgid "_never_"
35430msgstr ""
35431
35432#. type: Plain text
35433#: ../term-utils/agetty.8.adoc:109
35434msgid ""
35435"Explicitly clears the CLOCAL flag from the line setting and the "
35436"carrier-detect signal is expected on the line."
35437msgstr ""
35438
35439#. type: Labeled list
35440#: ../term-utils/agetty.8.adoc:109
35441#, no-wrap
35442msgid "_auto_"
35443msgstr ""
35444
35445#. type: Plain text
35446#: ../term-utils/agetty.8.adoc:111
35447msgid ""
35448"The *agetty* default. Does not modify the CLOCAL setting and follows the "
35449"setting enabled by the kernel."
35450msgstr ""
35451
35452#. type: Labeled list
35453#: ../term-utils/agetty.8.adoc:112
35454#, no-wrap
35455msgid "*-m*, *--extract-baud*"
35456msgstr ""
35457
35458#. type: Plain text
35459#: ../term-utils/agetty.8.adoc:114
35460msgid ""
35461"Try to extract the baud rate from the CONNECT status message produced by "
35462"Hayes(tm)-compatible modems. These status messages are of the form: "
35463"\"<junk><speed><junk>\". *agetty* assumes that the modem emits its status "
35464"message at the same speed as specified with (the first) _baud_rate_ value on "
35465"the command line."
35466msgstr ""
35467
35468#. type: Plain text
35469#: ../term-utils/agetty.8.adoc:116
35470msgid ""
35471"Since the *--extract-baud* feature may fail on heavily-loaded systems, you "
35472"still should enable BREAK processing by enumerating all expected baud rates "
35473"on the command line."
35474msgstr ""
35475
35476#. type: Labeled list
35477#: ../term-utils/agetty.8.adoc:117
35478#, no-wrap
35479msgid "*--list-speeds*"
35480msgstr ""
35481
35482#. type: Plain text
35483#: ../term-utils/agetty.8.adoc:119
35484msgid "Display supported baud rates. These are determined at compilation time."
35485msgstr ""
35486
35487#. type: Labeled list
35488#: ../term-utils/agetty.8.adoc:120
35489#, no-wrap
35490msgid "*-n*, *--skip-login*"
35491msgstr ""
35492
35493#. type: Plain text
35494#: ../term-utils/agetty.8.adoc:122
35495msgid ""
35496"Do not prompt the user for a login name. This can be used in connection with "
35497"the *--login-program* option to invoke a non-standard login process such as "
35498"a BBS system. Note that with the *--skip-login* option, *agetty* gets no "
35499"input from the user who logs in and therefore will not be able to figure out "
35500"parity, character size, and newline processing of the connection. It "
35501"defaults to space parity, 7 bit characters, and ASCII CR (13) end-of-line "
35502"character. Beware that the program that *agetty* starts (usually /bin/login) "
35503"is run as root."
35504msgstr ""
35505
35506#. type: Labeled list
35507#: ../term-utils/agetty.8.adoc:123
35508#, no-wrap
35509msgid "*-N*, *--nonewline*"
35510msgstr ""
35511
35512#. type: Plain text
35513#: ../term-utils/agetty.8.adoc:125
35514msgid "Do not print a newline before writing out _/etc/issue_."
35515msgstr ""
35516
35517#. type: Labeled list
35518#: ../term-utils/agetty.8.adoc:126
35519#, no-wrap
35520msgid "*-o*, *--login-options* _login_options_"
35521msgstr ""
35522
35523#. type: Plain text
35524#: ../term-utils/agetty.8.adoc:128
35525msgid ""
35526"Options and arguments that are passed to *login*(1). Where \\u is replaced "
35527"by the login name. For example:"
35528msgstr ""
35529
35530#. type: Plain text
35531#: ../term-utils/agetty.8.adoc:130
35532#, no-wrap
35533msgid "*--login-options '-h darkstar -- \\u'*\n"
35534msgstr ""
35535
35536#. type: Plain text
35537#: ../term-utils/agetty.8.adoc:132
35538msgid "See *--autologin*, *--login-program* and *--remote*."
35539msgstr ""
35540
35541#. type: Plain text
35542#: ../term-utils/agetty.8.adoc:134
35543msgid "Please read the SECURITY NOTICE below before using this option."
35544msgstr ""
35545
35546#. type: Labeled list
35547#: ../term-utils/agetty.8.adoc:135
35548#, no-wrap
35549msgid "*-p*, *--login-pause*"
35550msgstr ""
35551
35552#. type: Plain text
35553#: ../term-utils/agetty.8.adoc:137
35554msgid ""
35555"Wait for any key before dropping to the login prompt. Can be combined with "
35556"*--autologin* to save memory by lazily spawning shells."
35557msgstr ""
35558
35559#. type: Labeled list
35560#: ../term-utils/agetty.8.adoc:138
35561#, no-wrap
35562msgid "*-r*, *--chroot* _directory_"
35563msgstr ""
35564
35565#. type: Plain text
35566#: ../term-utils/agetty.8.adoc:140
35567msgid "Change root to the specified directory."
35568msgstr ""
35569
35570#. type: Labeled list
35571#: ../term-utils/agetty.8.adoc:141
35572#, no-wrap
35573msgid "*-R*, *--hangup*"
35574msgstr ""
35575
35576#. type: Plain text
35577#: ../term-utils/agetty.8.adoc:143
35578msgid "Call *vhangup*(2) to do a virtual hangup of the specified terminal."
35579msgstr ""
35580
35581#. type: Labeled list
35582#: ../term-utils/agetty.8.adoc:144
35583#, no-wrap
35584msgid "*-s*, *--keep-baud*"
35585msgstr ""
35586
35587#. type: Plain text
35588#: ../term-utils/agetty.8.adoc:146
35589msgid ""
35590"Try to keep the existing baud rate. The baud rates from the command line are "
35591"used when *agetty* receives a BREAK character. If another baud rates "
35592"specified then the original baud rate is also saved to the end of the wanted "
35593"baud rates list. This can be used to return to the original baud rate after "
35594"unexpected BREAKs."
35595msgstr ""
35596
35597#. type: Labeled list
35598#: ../term-utils/agetty.8.adoc:147 ../term-utils/wall.1.adoc:65
35599#, no-wrap
35600msgid "*-t*, *--timeout* _timeout_"
35601msgstr ""
35602
35603#. type: Plain text
35604#: ../term-utils/agetty.8.adoc:149
35605msgid ""
35606"Terminate if no user name could be read within _timeout_ seconds. Use of "
35607"this option with hardwired terminal lines is not recommended."
35608msgstr ""
35609
35610#. type: Labeled list
35611#: ../term-utils/agetty.8.adoc:150
35612#, no-wrap
35613msgid "*-U*, *--detect-case*"
35614msgstr ""
35615
35616#. type: Plain text
35617#: ../term-utils/agetty.8.adoc:152
35618msgid ""
35619"Turn on support for detecting an uppercase-only terminal. This setting will "
35620"detect a login name containing only capitals as indicating an uppercase-only "
35621"terminal and turn on some upper-to-lower case conversions. Note that this "
35622"has no support for any Unicode characters."
35623msgstr ""
35624
35625#. type: Labeled list
35626#: ../term-utils/agetty.8.adoc:153
35627#, no-wrap
35628msgid "*-w*, *--wait-cr*"
35629msgstr ""
35630
35631#. type: Plain text
35632#: ../term-utils/agetty.8.adoc:155
35633msgid ""
35634"Wait for the user or the modem to send a carriage-return or a linefeed "
35635"character before sending the _/etc/issue_ file (or others) and the login "
35636"prompt. This is useful with the *--init-string* option."
35637msgstr ""
35638
35639#. type: Labeled list
35640#: ../term-utils/agetty.8.adoc:156
35641#, no-wrap
35642msgid "*--nohints*"
35643msgstr ""
35644
35645#. type: Plain text
35646#: ../term-utils/agetty.8.adoc:158
35647msgid "Do not print hints about Num, Caps and Scroll Locks."
35648msgstr ""
35649
35650#. type: Labeled list
35651#: ../term-utils/agetty.8.adoc:159
35652#, no-wrap
35653msgid "*--nohostname*"
35654msgstr ""
35655
35656#. type: Plain text
35657#: ../term-utils/agetty.8.adoc:161
35658msgid ""
35659"By default the hostname will be printed. With this option enabled, no "
35660"hostname at all will be shown."
35661msgstr ""
35662
35663#. type: Labeled list
35664#: ../term-utils/agetty.8.adoc:162
35665#, no-wrap
35666msgid "*--long-hostname*"
35667msgstr ""
35668
35669#. type: Plain text
35670#: ../term-utils/agetty.8.adoc:164
35671msgid ""
35672"By default the hostname is only printed until the first dot. With this "
35673"option enabled, the fully qualified hostname by *gethostname*(3P) or (if not "
35674"found) by *getaddrinfo*(3) is shown."
35675msgstr ""
35676
35677#. type: Labeled list
35678#: ../term-utils/agetty.8.adoc:165
35679#, no-wrap
35680msgid "*--erase-chars* _string_"
35681msgstr ""
35682
35683#. type: Plain text
35684#: ../term-utils/agetty.8.adoc:167
35685msgid ""
35686"This option specifies additional characters that should be interpreted as a "
35687"backspace (\"ignore the previous character\") when the user types the login "
5db1d29a
MB
35688"name. The default additional 'erase' has been '#', but since util-linux 2.23 "
35689"no additional erase characters are enabled by default."
36e96905
MB
35690msgstr ""
35691
35692#. type: Labeled list
35693#: ../term-utils/agetty.8.adoc:168
35694#, no-wrap
35695msgid "*--kill-chars* _string_"
35696msgstr ""
35697
35698#. type: Plain text
35699#: ../term-utils/agetty.8.adoc:170
35700msgid ""
35701"This option specifies additional characters that should be interpreted as a "
35702"kill (\"ignore all previous characters\") when the user types the login "
5db1d29a
MB
35703"name. The default additional 'kill' has been '@', but since util-linux 2.23 "
35704"no additional kill characters are enabled by default."
36e96905
MB
35705msgstr ""
35706
35707#. type: Labeled list
35708#: ../term-utils/agetty.8.adoc:171
35709#, no-wrap
35710msgid "*--chdir* _directory_"
35711msgstr ""
35712
35713#. type: Plain text
35714#: ../term-utils/agetty.8.adoc:173
35715msgid "Change directory before the login."
35716msgstr ""
35717
35718#. type: Labeled list
35719#: ../term-utils/agetty.8.adoc:174
35720#, no-wrap
35721msgid "*--delay* _number_"
35722msgstr ""
35723
35724#. type: Plain text
35725#: ../term-utils/agetty.8.adoc:176
35726msgid "Sleep seconds before open tty."
35727msgstr ""
35728
35729#. type: Labeled list
35730#: ../term-utils/agetty.8.adoc:177
35731#, no-wrap
35732msgid "*--nice* _number_"
35733msgstr ""
35734
35735#. type: Plain text
35736#: ../term-utils/agetty.8.adoc:179
35737msgid "Run login with this priority."
35738msgstr ""
35739
35740#. type: Labeled list
35741#: ../term-utils/agetty.8.adoc:180
35742#, no-wrap
35743msgid "*--reload*"
35744msgstr ""
35745
35746#. type: Plain text
35747#: ../term-utils/agetty.8.adoc:182
35748msgid ""
35749"Ask all running agetty instances to reload and update their displayed "
35750"prompts, if the user has not yet commenced logging in. After doing so the "
35751"command will exit. This feature might be unsupported on systems without "
35752"Linux *inotify*(7)."
35753msgstr ""
35754
35755#. type: Plain text
35756#: ../term-utils/agetty.8.adoc:192
35757msgid ""
35758"This section shows examples for the process field of an entry in the "
35759"_/etc/inittab_ file. You'll have to prepend appropriate values for the other "
35760"fields. See *inittab*(5) for more details."
35761msgstr ""
35762
35763#. type: Plain text
35764#: ../term-utils/agetty.8.adoc:194
35765msgid "For a hardwired line or a console tty:"
35766msgstr ""
35767
35768#. type: delimited block _
35769#: ../term-utils/agetty.8.adoc:197
35770#, no-wrap
35771msgid "*/sbin/agetty 9600 ttyS1*\n"
35772msgstr ""
35773
35774#. type: Plain text
35775#: ../term-utils/agetty.8.adoc:200
35776msgid ""
35777"For a directly connected terminal without proper carrier-detect wiring (try "
35778"this if your terminal just sleeps instead of giving you a password: prompt):"
35779msgstr ""
35780
35781#. type: delimited block _
35782#: ../term-utils/agetty.8.adoc:203
35783#, no-wrap
35784msgid "*/sbin/agetty --local-line 9600 ttyS1 vt100*\n"
35785msgstr ""
35786
35787#. type: Plain text
35788#: ../term-utils/agetty.8.adoc:206
35789msgid "For an old-style dial-in line with a 9600/2400/1200 baud modem:"
35790msgstr ""
35791
35792#. type: delimited block _
35793#: ../term-utils/agetty.8.adoc:209
35794#, no-wrap
35795msgid "*/sbin/agetty --extract-baud --timeout 60 ttyS1 9600,2400,1200*\n"
35796msgstr ""
35797
35798#. type: Plain text
35799#: ../term-utils/agetty.8.adoc:212
35800msgid ""
35801"For a Hayes modem with a fixed 115200 bps interface to the machine (the "
35802"example init string turns off modem echo and result codes, makes "
35803"modem/computer DCD track modem/modem DCD, makes a DTR drop cause a "
35804"disconnection, and turns on auto-answer after 1 ring):"
35805msgstr ""
35806
35807#. type: delimited block _
35808#: ../term-utils/agetty.8.adoc:215
35809#, no-wrap
35810msgid ""
35811"*/sbin/agetty --wait-cr --init-string 'ATE0Q1&D2&C1S0=1\\015' 115200 "
35812"ttyS1*\n"
35813msgstr ""
35814
35815#. type: Title ==
35816#: ../term-utils/agetty.8.adoc:217
35817#, no-wrap
35818msgid "SECURITY NOTICE"
35819msgstr ""
35820
35821#. type: Plain text
35822#: ../term-utils/agetty.8.adoc:220
35823msgid ""
35824"If you use the *--login-program* and *--login-options* options, be aware "
35825"that a malicious user may try to enter lognames with embedded options, which "
35826"then get passed to the used login program. Agetty does check for a leading "
35827"\"-\" and makes sure the logname gets passed as one parameter (so embedded "
35828"spaces will not create yet another parameter), but depending on how the "
35829"login binary parses the command line that might not be sufficient. Check "
35830"that the used login program cannot be abused this way."
35831msgstr ""
35832
35833#. type: Plain text
35834#: ../term-utils/agetty.8.adoc:222
35835msgid ""
35836"Some programs use \"--\" to indicate that the rest of the command line "
35837"should not be interpreted as options. Use this feature if available by "
35838"passing \"--\" before the username gets passed by \\u."
35839msgstr ""
35840
35841#. type: Title ==
35842#: ../term-utils/agetty.8.adoc:223
35843#, no-wrap
35844msgid "ISSUE FILES"
35845msgstr ""
35846
35847#. type: Plain text
35848#: ../term-utils/agetty.8.adoc:226
35849msgid ""
35850"The default issue file is _/etc/issue_. If the file exists, then *agetty* "
35851"also checks for _/etc/issue.d_ directory. The directory is optional "
35852"extension to the default issue file and content of the directory is printed "
35853"after _/etc/issue_ content. If the _/etc/issue_ does not exist, then the "
35854"directory is ignored. All files *with .issue extension* from the directory "
35855"are printed in version-sort order. The directory can be used to maintain "
35856"3rd-party messages independently on the primary system _/etc/issue_ file."
35857msgstr ""
35858
35859#. type: Plain text
35860#: ../term-utils/agetty.8.adoc:228
35861msgid ""
35862"Since version 2.35 additional locations for issue file and directory are "
35863"supported. If the default _/etc/issue_ does not exist, then *agetty* checks "
35864"for _/run/issue_ and _/run/issue.d_, thereafter for _/usr/lib/issue_ and "
35865"_/usr/lib/issue.d_. The directory _/etc_ is expected for host specific "
35866"configuration, _/run_ is expected for generated stuff and _/usr/lib_ for "
35867"static distribution maintained configuration."
35868msgstr ""
35869
35870#. type: Plain text
35871#: ../term-utils/agetty.8.adoc:230
35872msgid ""
35873"The default path maybe overridden by *--issue-file* option. In this case "
35874"specified path has to be file or directory and all the default issue file "
35875"and directory locations are ignored."
35876msgstr ""
35877
35878#. type: Plain text
35879#: ../term-utils/agetty.8.adoc:232
35880msgid "The issue file feature can be completely disabled by *--noissue* option."
35881msgstr ""
35882
35883#. type: Plain text
35884#: ../term-utils/agetty.8.adoc:234
35885msgid ""
35886"It is possible to review the current issue file by *agetty --show-issue* on "
35887"the current terminal."
35888msgstr ""
35889
35890#. type: Plain text
35891#: ../term-utils/agetty.8.adoc:236
35892msgid ""
35893"The issue files may contain certain escape codes to display the system name, "
35894"date, time et cetera. All escape codes consist of a backslash (\\) "
35895"immediately followed by one of the characters listed below."
35896msgstr ""
35897
35898#. type: Labeled list
35899#: ../term-utils/agetty.8.adoc:237
35900#, no-wrap
35901msgid "4 or 4{_interface_}"
35902msgstr ""
35903
35904#. type: Plain text
35905#: ../term-utils/agetty.8.adoc:239
35906msgid ""
35907"Insert the IPv4 address of the specified network interface (for example: "
35908"\\4\\{eth0}). If the _interface_ argument is not specified, then select the "
35909"first fully configured (UP, non-LOCALBACK, RUNNING) interface. If not any "
35910"configured interface is found, fall back to the IP address of the machine's "
35911"hostname."
35912msgstr ""
35913
35914#. type: Labeled list
35915#: ../term-utils/agetty.8.adoc:240
35916#, no-wrap
35917msgid "6 or 6{_interface_}"
35918msgstr ""
35919
35920#. type: Plain text
35921#: ../term-utils/agetty.8.adoc:242
35922msgid "The same as \\4 but for IPv6."
35923msgstr ""
35924
35925#. type: Labeled list
35926#: ../term-utils/agetty.8.adoc:243
35927#, no-wrap
35928msgid "b"
35929msgstr ""
35930
35931#. type: Plain text
35932#: ../term-utils/agetty.8.adoc:245
35933msgid "Insert the baudrate of the current line."
35934msgstr ""
35935
35936#. type: Labeled list
35937#: ../term-utils/agetty.8.adoc:246
35938#, no-wrap
35939msgid "d"
35940msgstr ""
35941
35942#. type: Plain text
35943#: ../term-utils/agetty.8.adoc:248
35944msgid "Insert the current date."
35945msgstr ""
35946
35947#. type: Labeled list
35948#: ../term-utils/agetty.8.adoc:249
35949#, no-wrap
35950msgid "e or e{_name_}"
35951msgstr ""
35952
35953#. type: Plain text
35954#: ../term-utils/agetty.8.adoc:251
35955msgid ""
35956"Translate the human-readable _name_ to an escape sequence and insert it (for "
35957"example: \\e{red}Alert text.\\e{reset}). If the _name_ argument is not "
35958"specified, then insert \\033. The currently supported names are: black, "
35959"blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, "
35960"lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, "
35961"magenta, red, reset, reverse, yellow and white. All unknown names are "
35962"silently ignored."
35963msgstr ""
35964
35965#. type: Labeled list
35966#: ../term-utils/agetty.8.adoc:252
35967#, no-wrap
35968msgid "s"
35969msgstr ""
35970
35971#. type: Plain text
35972#: ../term-utils/agetty.8.adoc:254
35973msgid ""
35974"Insert the system name (the name of the operating system). Same as 'uname "
35975"-s'. See also the \\S escape code."
35976msgstr ""
35977
35978#. type: Labeled list
35979#: ../term-utils/agetty.8.adoc:255
35980#, no-wrap
35981msgid "S or S{VARIABLE}"
35982msgstr ""
35983
35984#. type: Plain text
35985#: ../term-utils/agetty.8.adoc:257
35986msgid ""
35987"Insert the VARIABLE data from _/etc/os-release_. If this file does not exist "
35988"then fall back to _/usr/lib/os-release_. If the VARIABLE argument is not "
35989"specified, then use PRETTY_NAME from the file or the system name (see "
35990"\\s). This escape code can be used to keep _/etc/issue_ distribution and "
35991"release independent. Note that \\S{ANSI_COLOR} is converted to the real "
35992"terminal escape sequence."
35993msgstr ""
35994
35995#. type: Labeled list
35996#: ../term-utils/agetty.8.adoc:258
35997#, no-wrap
35998msgid "l"
35999msgstr ""
36000
36001#. type: Plain text
36002#: ../term-utils/agetty.8.adoc:260
36003msgid "Insert the name of the current tty line."
36004msgstr ""
36005
36006#. type: Labeled list
36007#: ../term-utils/agetty.8.adoc:261
36008#, no-wrap
36009msgid "m"
36010msgstr ""
36011
36012#. type: Plain text
36013#: ../term-utils/agetty.8.adoc:263
36014msgid "Insert the architecture identifier of the machine. Same as *uname -m*."
36015msgstr ""
36016
36017#. type: Labeled list
36018#: ../term-utils/agetty.8.adoc:264
36019#, no-wrap
36020msgid "n"
36021msgstr ""
36022
36023#. type: Plain text
36024#: ../term-utils/agetty.8.adoc:266
36025msgid ""
36026"Insert the nodename of the machine, also known as the hostname. Same as "
36027"*uname -n*."
36028msgstr ""
36029
36030#. type: Labeled list
36031#: ../term-utils/agetty.8.adoc:267
36032#, no-wrap
36033msgid "o"
36034msgstr ""
36035
36036#. type: Plain text
36037#: ../term-utils/agetty.8.adoc:269
36038msgid "Insert the NIS domainname of the machine. Same as *hostname -d*."
36039msgstr ""
36040
36041#. type: Labeled list
36042#: ../term-utils/agetty.8.adoc:270
36043#, no-wrap
36044msgid "O"
36045msgstr ""
36046
36047#. type: Plain text
36048#: ../term-utils/agetty.8.adoc:272
36049msgid "Insert the DNS domainname of the machine."
36050msgstr ""
36051
36052#. type: Labeled list
36053#: ../term-utils/agetty.8.adoc:273
36054#, no-wrap
36055msgid "r"
36056msgstr ""
36057
36058#. type: Plain text
36059#: ../term-utils/agetty.8.adoc:275
36060msgid "Insert the release number of the OS. Same as *uname -r*."
36061msgstr ""
36062
36063#. type: Labeled list
36064#: ../term-utils/agetty.8.adoc:276
36065#, no-wrap
36066msgid "t"
36067msgstr ""
36068
36069#. type: Plain text
36070#: ../term-utils/agetty.8.adoc:278
36071msgid "Insert the current time."
36072msgstr ""
36073
36074#. type: Labeled list
36075#: ../term-utils/agetty.8.adoc:279
36076#, no-wrap
36077msgid "u"
36078msgstr ""
36079
36080#. type: Plain text
36081#: ../term-utils/agetty.8.adoc:281
36082msgid "Insert the number of current users logged in."
36083msgstr ""
36084
36085#. type: Labeled list
36086#: ../term-utils/agetty.8.adoc:282
36087#, no-wrap
36088msgid "U"
36089msgstr ""
36090
36091#. type: Plain text
36092#: ../term-utils/agetty.8.adoc:284
36093msgid ""
36094"Insert the string \"1 user\" or \"<n> users\" where <n> is the number of "
36095"current users logged in."
36096msgstr ""
36097
36098#. type: Labeled list
36099#: ../term-utils/agetty.8.adoc:285
36100#, no-wrap
36101msgid "v"
36102msgstr ""
36103
36104#. type: Plain text
36105#: ../term-utils/agetty.8.adoc:287
36106msgid "Insert the version of the OS, that is, the build-date and such."
36107msgstr ""
36108
36109#. type: Plain text
36110#: ../term-utils/agetty.8.adoc:289
36111msgid "An example. On my system, the following _/etc/issue_ file:"
36112msgstr ""
36113
36114#. type: delimited block .
36115#: ../term-utils/agetty.8.adoc:292
36116#, no-wrap
36117msgid "This is \\n.\\o (\\s \\m \\r) \\t\n"
36118msgstr ""
36119
36120#. type: Plain text
36121#: ../term-utils/agetty.8.adoc:295
36122msgid "displays as:"
36123msgstr ""
36124
36125#. type: delimited block .
36126#: ../term-utils/agetty.8.adoc:298
36127#, no-wrap
36128msgid "This is thingol.orcan.dk (Linux i386 1.1.9) 18:29:30\n"
36129msgstr ""
36130
36131#. type: Labeled list
36132#: ../term-utils/agetty.8.adoc:302
36133#, no-wrap
36134msgid "_/var/run/utmp_"
36135msgstr ""
36136
36137#. type: Plain text
36138#: ../term-utils/agetty.8.adoc:304
36139msgid "the system status file."
36140msgstr ""
36141
36142#. type: Labeled list
36143#: ../term-utils/agetty.8.adoc:305
36144#, no-wrap
36145msgid "_/etc/issue_"
36146msgstr ""
36147
36148#. type: Plain text
36149#: ../term-utils/agetty.8.adoc:307
36150msgid "printed before the login prompt."
36151msgstr ""
36152
36153#. type: Labeled list
36154#: ../term-utils/agetty.8.adoc:308
36155#, no-wrap
36156msgid "_/etc/os-release /usr/lib/os-release_"
36157msgstr ""
36158
36159#. type: Plain text
36160#: ../term-utils/agetty.8.adoc:310
36161msgid "operating system identification data."
36162msgstr ""
36163
36164#. type: Labeled list
36165#: ../term-utils/agetty.8.adoc:311
36166#, no-wrap
36167msgid "_/dev/console_"
36168msgstr ""
36169
36170#. type: Plain text
36171#: ../term-utils/agetty.8.adoc:313
36172msgid "problem reports (if *syslog*(3) is not used)."
36173msgstr ""
36174
36175#. type: Labeled list
36176#: ../term-utils/agetty.8.adoc:314
36177#, no-wrap
36178msgid "_/etc/inittab_"
36179msgstr ""
36180
36181#. type: Plain text
36182#: ../term-utils/agetty.8.adoc:316
36183#, no-wrap
36184msgid "*init*(8) configuration file for SysV-style init daemon.\n"
36185msgstr ""
36186
36187#. type: Plain text
36188#: ../term-utils/agetty.8.adoc:320
36189msgid ""
36190"The baud-rate detection feature (the *--extract-baud* option) requires that "
36191"*agetty* be scheduled soon enough after completion of a dial-in call (within "
36192"30 ms with modems that talk at 2400 baud). For robustness, always use the "
36193"*--extract-baud* option in combination with a multiple baud rate "
36194"command-line argument, so that BREAK processing is enabled."
36195msgstr ""
36196
36197#. type: Plain text
36198#: ../term-utils/agetty.8.adoc:322
36199msgid ""
36200"The text in the _/etc/issue_ file (or other) and the login prompt are always "
36201"output with 7-bit characters and space parity."
36202msgstr ""
36203
36204#. type: Plain text
36205#: ../term-utils/agetty.8.adoc:324
36206msgid ""
36207"The baud-rate detection feature (the *--extract-baud* option) requires that "
36208"the modem emits its status message _after_ raising the DCD line."
36209msgstr ""
36210
36211#. type: Plain text
36212#: ../term-utils/agetty.8.adoc:328
36213msgid ""
36214"Depending on how the program was configured, all diagnostics are written to "
36215"the console device or reported via the *syslog*(3) facility. Error messages "
36216"are produced if the _port_ argument does not specify a terminal device; if "
36217"there is no utmp entry for the current process (System V only); and so on."
36218msgstr ""
36219
36220#. type: Plain text
36221#: ../term-utils/agetty.8.adoc:333
36222msgid "mailto:werner@suse.de[Werner Fink], mailto:kzak@redhat.com[Karel Zak]"
36223msgstr ""
36224
36225#. type: Plain text
36226#: ../term-utils/agetty.8.adoc:335
36227msgid ""
36228"The original *agetty* for serial terminals was written by "
36229"mailto:wietse@wzv.win.tue.nl[W.Z. Venema] and ported to Linux by "
36230"mailto:poe@daimi.aau.dk[Peter Orbaek]."
36231msgstr ""
36232
36233#. Copyright (c) 1987, 1990, 1993
36234#. The Regents of the University of California. All rights reserved.
36235#
36236#. Redistribution and use in source and binary forms, with or without
36237#. modification, are permitted provided that the following conditions
36238#. are met:
36239#. 1. Redistributions of source code must retain the above copyright
36240#. notice, this list of conditions and the following disclaimer.
36241#. 2. Redistributions in binary form must reproduce the above copyright
36242#. notice, this list of conditions and the following disclaimer in the
36243#. documentation and/or other materials provided with the distribution.
36244#. 3. All advertising materials mentioning features or use of this software
36245#. must display the following acknowledgement:
36246#. This product includes software developed by the University of
36247#. California, Berkeley and its contributors.
36248#. 4. Neither the name of the University nor the names of its contributors
36249#. may be used to endorse or promote products derived from this software
36250#. without specific prior written permission.
36251#
36252#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
36253#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
36254#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
36255#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
36256#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36257#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
36258#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36259#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36260#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
36261#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36262#. SUCH DAMAGE.
36263#
36264#. @(#)mesg.1 8.1 (Berkeley) 6/6/93
36265#. type: Title =
36266#: ../term-utils/mesg.1.adoc:36
36267#, no-wrap
36268msgid "mesg(1)"
36269msgstr ""
36270
36271#. type: Plain text
36272#: ../term-utils/mesg.1.adoc:46
36273msgid "mesg - display (or do not display) messages from other users"
36274msgstr ""
36275
36276#. type: Plain text
36277#: ../term-utils/mesg.1.adoc:50
36278#, no-wrap
36279msgid "*mesg* [_option_] [*n*|*y*]\n"
36280msgstr ""
36281
36282#. type: Plain text
36283#: ../term-utils/mesg.1.adoc:54
36284msgid ""
36285"The *mesg* utility is invoked by a user to control write access others have "
36286"to the terminal device associated with standard error output. If write "
36287"access is allowed, then programs such as *talk*(1) and *write*(1) may "
36288"display messages on the terminal."
36289msgstr ""
36290
36291#. type: Plain text
36292#: ../term-utils/mesg.1.adoc:56
36293msgid ""
36294"Traditionally, write access is allowed by default. However, as users become "
36295"more conscious of various security risks, there is a trend to remove write "
36296"access by default, at least for the primary login shell. To make sure your "
36297"ttys are set the way you want them to be set, *mesg* should be executed in "
36298"your login scripts."
36299msgstr ""
36300
36301#. type: Plain text
36302#: ../term-utils/mesg.1.adoc:58
36303msgid ""
36304"The *mesg* utility silently exits with error status 2 if not executed on "
36305"terminal. In this case execute *mesg* is pointless. The command line option "
36306"*--verbose* forces mesg to print a warning in this situation. This behaviour "
36307"has been introduced in version 2.33."
36308msgstr ""
36309
36310#. type: Plain text
36311#: ../term-utils/mesg.1.adoc:63
36312msgid "Disallow messages."
36313msgstr ""
36314
36315#. type: Labeled list
36316#: ../term-utils/mesg.1.adoc:64
36317#, no-wrap
36318msgid "*y*"
36319msgstr ""
36320
36321#. type: Plain text
36322#: ../term-utils/mesg.1.adoc:66
36323msgid "Allow messages to be displayed."
36324msgstr ""
36325
36326#. type: Plain text
36327#: ../term-utils/mesg.1.adoc:68
36328msgid ""
36329"If no arguments are given, *mesg* shows the current message status on "
36330"standard error output."
36331msgstr ""
36332
36333#. type: Plain text
36334#: ../term-utils/mesg.1.adoc:83
36335msgid "The *mesg* utility exits with one of the following values:"
36336msgstr ""
36337
36338#. type: Plain text
36339#: ../term-utils/mesg.1.adoc:86
36340msgid "Messages are allowed."
36341msgstr ""
36342
36343#. type: Plain text
36344#: ../term-utils/mesg.1.adoc:88
36345msgid "Messages are not allowed."
36346msgstr ""
36347
36348#. type: Labeled list
36349#: ../term-utils/mesg.1.adoc:88
36350#, no-wrap
36351msgid "*>1*"
36352msgstr ""
36353
36354#. type: Plain text
36355#: ../term-utils/mesg.1.adoc:90
36356msgid "An error has occurred."
36357msgstr ""
36358
36359#. type: Plain text
36360#: ../term-utils/mesg.1.adoc:94
36361msgid "_/dev/[pt]ty[pq]?_"
36362msgstr ""
36363
36364#. type: Plain text
36365#: ../term-utils/mesg.1.adoc:98
36366msgid "A *mesg* command appeared in Version 6 AT&T UNIX."
36367msgstr ""
36368
36369#. type: Plain text
36370#: ../term-utils/mesg.1.adoc:106
36371#, no-wrap
36372msgid ""
36373"*login*(1),\n"
36374"*talk*(1),\n"
36375"*write*(1),\n"
36376"*wall*(1),\n"
36377"*xterm*(1)\n"
36378msgstr ""
36379
36380#. Copyright (c) 1980, 1990 Regents of the University of California.
36381#. All rights reserved.
36382#
36383#. Redistribution and use in source and binary forms, with or without
36384#. modification, are permitted provided that the following conditions
36385#. are met:
36386#. 1. Redistributions of source code must retain the above copyright
36387#. notice, this list of conditions and the following disclaimer.
36388#. 2. Redistributions in binary form must reproduce the above copyright
36389#. notice, this list of conditions and the following disclaimer in the
36390#. documentation and/or other materials provided with the distribution.
36391#. 3. All advertising materials mentioning features or use of this software
36392#. must display the following acknowledgement:
36393#. This product includes software developed by the University of
36394#. California, Berkeley and its contributors.
36395#. 4. Neither the name of the University nor the names of its contributors
36396#. may be used to endorse or promote products derived from this software
36397#. without specific prior written permission.
36398#
36399#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
36400#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
36401#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
36402#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
36403#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36404#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
36405#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36406#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36407#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
36408#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36409#. SUCH DAMAGE.
36410#
36411#. @(#)script.1 6.5 (Berkeley) 7/27/91
36412#. type: Title =
36413#: ../term-utils/script.1.adoc:36
36414#, no-wrap
36415msgid "script(1)"
36416msgstr ""
36417
36418#. type: Plain text
36419#: ../term-utils/script.1.adoc:47
36420msgid "script - make typescript of terminal session"
36421msgstr ""
36422
36423#. type: Plain text
36424#: ../term-utils/script.1.adoc:51
36425#, no-wrap
36426msgid "*script* [options] [_file_]\n"
36427msgstr ""
36428
36429#. type: Plain text
36430#: ../term-utils/script.1.adoc:55
36431#, no-wrap
36432msgid ""
36433"*script* makes a typescript of everything on your terminal session. The "
36434"terminal data are stored in raw form to the log file and information about "
36435"timing to another (optional) structured log file. The timing log file is "
36436"necessary to replay the session later by *scriptreplay*(1) and to store "
36437"additional information about the session.\n"
36438msgstr ""
36439
36440#. type: Plain text
36441#: ../term-utils/script.1.adoc:57
36442msgid ""
36443"Since version 2.35, *script* supports multiple streams and allows the "
36444"logging of input and output to separate files or all the one file. This "
36445"version also supports new timing file which records additional "
36446"information. The command *scriptreplay --summary* then provides all the "
36447"information."
36448msgstr ""
36449
36450#. type: Plain text
36451#: ../term-utils/script.1.adoc:59
36452msgid ""
36453"If the argument _file_ or option *--log-out* _file_ is given, *script* saves "
36454"the dialogue in this _file_. If no filename is given, the dialogue is saved "
36455"in the file _typescript_."
36456msgstr ""
36457
36458#. type: Plain text
36459#: ../term-utils/script.1.adoc:61
36460msgid ""
36461"Note that logging input using *--log-in* or *--log-io* may record "
36462"security-sensitive information as the log file contains all terminal session "
36463"input (e.g., passwords) independently of the terminal echo flag setting."
36464msgstr ""
36465
36466#. type: Plain text
36467#: ../term-utils/script.1.adoc:65
36468msgid ""
36469"Below, the _size_ argument may be followed by the multiplicative suffixes "
36470"KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB "
36471"(the \"iB\" is optional, e.g., \"K\" has the same meaning as \"KiB\"), or "
36472"the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB "
36473"and YB."
36474msgstr ""
36475
36476#. type: Plain text
36477#: ../term-utils/script.1.adoc:68
36478msgid ""
36479"Append the output to _file_ or to _typescript_, retaining the prior "
36480"contents."
36481msgstr ""
36482
36483#. type: Plain text
36484#: ../term-utils/script.1.adoc:71
36485msgid ""
36486"Run the _command_ rather than an interactive shell. This makes it easy for a "
36487"script to capture the output of a program that behaves differently when its "
36488"stdout is not a tty."
36489msgstr ""
36490
36491#. type: Labeled list
36492#: ../term-utils/script.1.adoc:72
36493#, no-wrap
36494msgid "*-E*, *--echo* _when_"
36495msgstr ""
36496
36497#. type: Plain text
36498#: ../term-utils/script.1.adoc:74
36499msgid ""
36500"This option controls the *ECHO* flag for the slave end of the session's "
36501"pseudoterminal. The supported modes are _always_, _never_, or _auto_."
36502msgstr ""
36503
36504#. type: Plain text
36505#: ../term-utils/script.1.adoc:76
36506msgid ""
36507"The default is _auto_ -- in this case, *ECHO* enabled for the pseudoterminal "
36508"slave; if the current standard input is a terminal, *ECHO* is disabled for "
36509"it to prevent double echo; if the current standard input is not a terminal "
36510"(for example pipe: *echo date | script*) then keeping *ECHO* enabled for the "
36511"pseudoterminal slave enables the standard input data to be viewed on screen "
36512"while being recorded to session log simultaneously."
36513msgstr ""
36514
36515#. type: Plain text
36516#: ../term-utils/script.1.adoc:78
36517msgid ""
36518"Note that 'never' mode affects content of the session output log, because "
36519"users input is not repeated on output."
36520msgstr ""
36521
36522#. type: Labeled list
36523#: ../term-utils/script.1.adoc:79
36524#, no-wrap
36525msgid "*-e*, *--return*"
36526msgstr ""
36527
36528#. TRANSLATORS: Keep {plus} untranslated.
36529#. type: Plain text
36530#: ../term-utils/script.1.adoc:82
36531msgid ""
36532"Return the exit status of the child process. Uses the same format as bash "
36533"termination on signal termination (i.e., exit status is 128 {plus} the "
36534"signal number). The exit status of the child process is always stored in the "
36535"type script file too."
36536msgstr ""
36537
36538#. type: Labeled list
36539#: ../term-utils/script.1.adoc:83
36540#, no-wrap
36541msgid "*-f*, *--flush*"
36542msgstr ""
36543
36544#. type: Plain text
36545#: ../term-utils/script.1.adoc:85
36546msgid ""
36547"Flush output after each write. This is nice for telecooperation: one person "
36548"does *mkfifo foo; script -f foo*, and another can supervise in real-time "
36549"what is being done using *cat foo*. Note that flush has an impact on "
36550"performance; it's possible to use *SIGUSR1* to flush logs on demand."
36551msgstr ""
36552
36553#. type: Labeled list
36554#: ../term-utils/script.1.adoc:86
36555#, no-wrap
36556msgid "*--force*"
36557msgstr ""
36558
36559#. type: Plain text
36560#: ../term-utils/script.1.adoc:88
36561msgid ""
36562"Allow the default output file _typescript_ to be a hard or symbolic "
36563"link. The command will follow a symbolic link."
36564msgstr ""
36565
36566#. type: Labeled list
5db1d29a 36567#: ../term-utils/script.1.adoc:89 ../term-utils/scriptlive.1.adoc:33
36e96905
MB
36568#: ../term-utils/scriptreplay.1.adoc:38
36569#, no-wrap
36570msgid "*-B*, *--log-io* _file_"
36571msgstr ""
36572
36573#. type: Plain text
36574#: ../term-utils/script.1.adoc:91
36575msgid ""
36576"Log input and output to the same _file_. Note, this option makes sense only "
36577"if *--log-timing* is also specified, otherwise it's impossible to separate "
36578"output and input streams from the log _file_."
36579msgstr ""
36580
36581#. type: Labeled list
5db1d29a 36582#: ../term-utils/script.1.adoc:92 ../term-utils/scriptlive.1.adoc:30
36e96905
MB
36583#: ../term-utils/scriptreplay.1.adoc:32
36584#, no-wrap
36585msgid "*-I*, *--log-in* _file_"
36586msgstr ""
36587
36588#. type: Plain text
36589#: ../term-utils/script.1.adoc:94
36590msgid ""
36591"Log input to the _file_. The log output is disabled if only *--log-in* "
36592"specified."
36593msgstr ""
36594
36595#. type: Plain text
36596#: ../term-utils/script.1.adoc:96
36597msgid ""
36598"Use this logging functionality carefully as it logs all input, including "
36599"input when terminal has disabled echo flag (for example, password inputs)."
36600msgstr ""
36601
36602#. type: Labeled list
36603#: ../term-utils/script.1.adoc:97 ../term-utils/scriptreplay.1.adoc:35
36604#, no-wrap
36605msgid "*-O*, *--log-out* _file_"
36606msgstr ""
36607
36608#. type: Plain text
36609#: ../term-utils/script.1.adoc:99
36610msgid ""
36611"Log output to the _file_. The default is to log output to the file with name "
36612"_typescript_ if the option *--log-out* or *--log-in* is not given. The log "
36613"output is disabled if only *--log-in* specified."
36614msgstr ""
36615
36616#. type: Labeled list
5db1d29a 36617#: ../term-utils/script.1.adoc:100 ../term-utils/scriptlive.1.adoc:39
36e96905
MB
36618#: ../term-utils/scriptreplay.1.adoc:44
36619#, no-wrap
36620msgid "*-T*, *--log-timing* _file_"
36621msgstr ""
36622
36623#. type: Plain text
36624#: ../term-utils/script.1.adoc:102
36625msgid ""
36626"Log timing information to the _file_. Two timing file formats are supported "
36627"now. The classic format is used when only one stream (input or output) "
36628"logging is enabled. The multi-stream format is used on *--log-io* or when "
36629"*--log-in* and *--log-out* are used together. See also *--logging-format*."
36630msgstr ""
36631
36632#. type: Labeled list
36633#: ../term-utils/script.1.adoc:103
36634#, no-wrap
36635msgid "*-m*, *--logging-format* _format_"
36636msgstr ""
36637
36638#. type: Plain text
36639#: ../term-utils/script.1.adoc:105
36640msgid ""
36641"Force use of _advanced_ or _classic_ format. The default is the classic "
36642"format to log only output and the advanced format when input as well as "
36643"output logging is requested."
36644msgstr ""
36645
36646#. type: Labeled list
36647#: ../term-utils/script.1.adoc:107
36648#, no-wrap
36649msgid "*Classic format*:"
36650msgstr ""
36651
36652#. type: Plain text
36653#: ../term-utils/script.1.adoc:109
36654msgid ""
36655"The log contains two fields, separated by a space. The first field indicates "
36656"how much time elapsed since the previous output. The second field indicates "
36657"how many characters were output this time."
36658msgstr ""
36659
36660#. type: Labeled list
36661#: ../term-utils/script.1.adoc:110
36662#, no-wrap
36663msgid "*Advanced (multi-stream) format*:"
36664msgstr ""
36665
36666#. type: Plain text
36667#: ../term-utils/script.1.adoc:112
36668msgid ""
36669"The first field is an entry type identifier ('I'nput, 'O'utput, 'H'eader, "
36670"'S'ignal). The socond field is how much time elapsed since the previous "
36671"entry, and the rest of the entry is type-specific data."
36672msgstr ""
36673
36674#. type: Labeled list
36675#: ../term-utils/script.1.adoc:113
36676#, no-wrap
36677msgid "*-o*, *--output-limit* _size_"
36678msgstr ""
36679
36680#. type: Plain text
36681#: ../term-utils/script.1.adoc:115
36682msgid ""
36683"Limit the size of the typescript and timing files to _size_ and stop the "
36684"child process after this size is exceeded. The calculated file size does not "
36685"include the start and done messages that the *script* command prepends and "
36686"appends to the child process output. Due to buffering, the resulting output "
36687"file might be larger than the specified value."
36688msgstr ""
36689
36690#. type: Plain text
36691#: ../term-utils/script.1.adoc:118
36692msgid "Be quiet (do not write start and done messages to standard output)."
36693msgstr ""
36694
36695#. type: Labeled list
36696#: ../term-utils/script.1.adoc:119
36697#, no-wrap
36698msgid "*-t*[_file_], *--timing*[=_file_]"
36699msgstr ""
36700
36701#. type: Plain text
36702#: ../term-utils/script.1.adoc:121
36703msgid ""
36704"Output timing data to standard error, or to _file_ when given. This option "
36705"is deprecated in favour of *--log-timing* where the _file_ argument is not "
36706"optional."
36707msgstr ""
36708
36709#. type: Plain text
36710#: ../term-utils/script.1.adoc:131
36711msgid "Upon receiving *SIGUSR1*, *script* immediately flushes the output files."
36712msgstr ""
36713
36714#. type: Plain text
36715#: ../term-utils/script.1.adoc:135
36716msgid "The following environment variable is utilized by *script*:"
36717msgstr ""
36718
36719#. type: Labeled list
36720#: ../term-utils/script.1.adoc:136 ../text-utils/more.1.adoc:172
36721#: ../text-utils/pg.1.adoc:134
36722#, no-wrap
36723msgid "*SHELL*"
36724msgstr ""
36725
36726#. type: Plain text
36727#: ../term-utils/script.1.adoc:138
36728msgid ""
36729"If the variable *SHELL* exists, the shell forked by *script* will be that "
36730"shell. If *SHELL* is not set, the Bourne shell is assumed. (Most shells set "
36731"this variable automatically)."
36732msgstr ""
36733
36734#. type: Plain text
36735#: ../term-utils/script.1.adoc:142
36736msgid ""
36737"The script ends when the forked shell exits (a _control-D_ for the Bourne "
36738"shell (*sh*(1p)), and _exit_, _logout_ or _control-d_ (if _ignoreeof_ is not "
36739"set) for the C-shell, *csh*(1))."
36740msgstr ""
36741
36742#. type: Plain text
36743#: ../term-utils/script.1.adoc:144
36744msgid ""
36745"Certain interactive commands, such as *vi*(1), create garbage in the "
36746"typescript file. *script* works best with commands that do not manipulate "
36747"the screen, the results are meant to emulate a hardcopy terminal."
36748msgstr ""
36749
36750#. type: Plain text
36751#: ../term-utils/script.1.adoc:146
36752msgid ""
36753"It is not recommended to run *script* in non-interactive shells. The inner "
36754"shell of *script* is always interactive, and this could lead to unexpected "
36755"results. If you use *script* in the shell initialization file, you have to "
5db1d29a 36756"avoid entering an infinite loop. You can use for example the *.profile* "
36e96905
MB
36757"file, which is read by login shells only:"
36758msgstr ""
36759
36760#. type: delimited block .
36761#: ../term-utils/script.1.adoc:152
36762#, no-wrap
36763msgid ""
36764"if test -t 0 ; then\n"
36765" script\n"
36766" exit\n"
36767"fi\n"
36768msgstr ""
36769
36770#. type: Plain text
36771#: ../term-utils/script.1.adoc:155
36772msgid ""
36773"You should also avoid use of *script* in command pipes, as *script* can read "
36774"more input than you would expect."
36775msgstr ""
36776
36777#. type: Plain text
36778#: ../term-utils/script.1.adoc:159
36779msgid "The *script* command appeared in 3.0BSD."
36780msgstr ""
36781
36782#. type: Plain text
36783#: ../term-utils/script.1.adoc:163
36784#, no-wrap
36785msgid ""
36786"*script* places _everything_ in the log file, including linefeeds and "
36787"backspaces. This is not what the naive user expects.\n"
36788msgstr ""
36789
36790#. type: Plain text
36791#: ../term-utils/script.1.adoc:165
36792#, no-wrap
36793msgid ""
36794"*script* is primarily designed for interactive terminal sessions. When stdin "
36795"is not a terminal (for example: *echo foo | script*), then the session can "
36796"hang, because the interactive shell within the script session misses EOF and "
36797"*script* has no clue when to close the session. See the *NOTES* section for "
36798"more information.\n"
36799msgstr ""
36800
36801#. type: Plain text
36802#: ../term-utils/script.1.adoc:171
36803#, no-wrap
36804msgid ""
36805"*csh*(1) (for the _history_ mechanism),\n"
36806"*scriptreplay*(1),\n"
36807"*scriptlive*(1)\n"
36808msgstr ""
36809
36810#. type: Title =
36811#: ../term-utils/scriptlive.1.adoc:2
36812#, no-wrap
36813msgid "scriptlive(1)"
36814msgstr ""
36815
36816#. type: Plain text
5db1d29a 36817#: ../term-utils/scriptlive.1.adoc:13
36e96905
MB
36818msgid "scriptlive - re-run session typescripts, using timing information"
36819msgstr ""
36820
36821#. type: Plain text
5db1d29a 36822#: ../term-utils/scriptlive.1.adoc:17
36e96905
MB
36823#, no-wrap
36824msgid "*scriptlive* [options] [*-t*] _timingfile_ [*-I*|*-B*] _typescript_\n"
36825msgstr ""
36826
36827#. type: Plain text
5db1d29a 36828#: ../term-utils/scriptlive.1.adoc:21
36e96905
MB
36829msgid ""
36830"This program re-runs a typescript, using stdin typescript and timing "
36831"information to ensure that input happens in the same rhythm as it originally "
36832"appeared when the script was recorded."
36833msgstr ""
36834
36835#. type: Plain text
5db1d29a 36836#: ../term-utils/scriptlive.1.adoc:23
36e96905
MB
36837msgid ""
36838"The *session is executed* in a newly created pseudoterminal with the user's "
36839"$SHELL (or defaults to _/bin/bash_)."
36840msgstr ""
36841
36842#. type: Plain text
5db1d29a 36843#: ../term-utils/scriptlive.1.adoc:25
36e96905
MB
36844#, no-wrap
36845msgid ""
36846"*Be careful!* Do not forget that the typescript may contains arbitrary "
36847"commands. It is recommended to use *\"scriptreplay --stream in --log-in "
36848"typescript\"* (or with *--log-io* instead of *--log-in* to verify the "
36849"typescript before it is executed by *scriptlive*.\n"
36850msgstr ""
36851
36852#. type: Plain text
5db1d29a 36853#: ../term-utils/scriptlive.1.adoc:27
36e96905
MB
36854msgid ""
36855"The timing information is what script1 outputs to file specified by "
36856"*--log-timing*. The typescript has to contain stdin information and it is "
36857"what script1 outputs to file specified by *--log-in* or *--log-io*."
36858msgstr ""
36859
36860#. type: Plain text
5db1d29a 36861#: ../term-utils/scriptlive.1.adoc:32 ../term-utils/scriptreplay.1.adoc:34
36e96905
MB
36862msgid "File containing *script*'s terminal input."
36863msgstr ""
36864
36865#. type: Plain text
5db1d29a 36866#: ../term-utils/scriptlive.1.adoc:35 ../term-utils/scriptreplay.1.adoc:40
36e96905
MB
36867msgid "File containing *script*'s terminal output and input."
36868msgstr ""
36869
36870#. type: Labeled list
5db1d29a 36871#: ../term-utils/scriptlive.1.adoc:36 ../term-utils/scriptreplay.1.adoc:41
36e96905
MB
36872#, no-wrap
36873msgid "*-t*, *--timing* _file_"
36874msgstr ""
36875
36876#. type: Plain text
5db1d29a 36877#: ../term-utils/scriptlive.1.adoc:38 ../term-utils/scriptreplay.1.adoc:43
36e96905
MB
36878msgid ""
36879"File containing *script*'s timing output. This option overrides old-style "
36880"arguments."
36881msgstr ""
36882
36883#. type: Plain text
5db1d29a 36884#: ../term-utils/scriptlive.1.adoc:41
36e96905
MB
36885msgid ""
36886"Aliased to *-t*, maintained for compatibility with *script*(1) command-line "
36887"options."
36888msgstr ""
36889
36890#. type: Plain text
5db1d29a 36891#: ../term-utils/scriptlive.1.adoc:44 ../term-utils/scriptreplay.1.adoc:55
36e96905
MB
36892msgid ""
36893"Speed up the replay displaying this _number_ of times. The argument is a "
36894"floating-point number. It's called divisor because it divides the timings by "
36895"this factor. This option overrides old-style arguments."
36896msgstr ""
36897
36898#. type: Labeled list
5db1d29a 36899#: ../term-utils/scriptlive.1.adoc:45 ../term-utils/scriptreplay.1.adoc:56
36e96905
MB
36900#, no-wrap
36901msgid "*-m*, *--maxdelay* _number_"
36902msgstr ""
36903
36904#. type: Plain text
5db1d29a 36905#: ../term-utils/scriptlive.1.adoc:47 ../term-utils/scriptreplay.1.adoc:58
36e96905
MB
36906msgid ""
36907"Set the maximum delay between updates to _number_ of seconds. The argument "
36908"is a floating-point number. This can be used to avoid long pauses in the "
36909"typescript replay."
36910msgstr ""
36911
36912#. type: delimited block .
5db1d29a 36913#: ../term-utils/scriptlive.1.adoc:64
36e96905
MB
36914#, no-wrap
36915msgid ""
36916"% script --log-timing file.tm --log-in script.in\n"
36917"Script started, file is script.out\n"
36918"% date\n"
36919"<etc, etc>\n"
36920"% exit\n"
36921"Script done, file is script.out\n"
36922"% scriptlive --log-timing file.tm --log-in script.in\n"
36923msgstr ""
36924
5db1d29a 36925#. TRANSLATORS: Keep {copyright} untranslated.
36e96905 36926#. type: Plain text
5db1d29a
MB
36927#: ../term-utils/scriptlive.1.adoc:74
36928msgid "Copyright {copyright} 2019 Karel Zak"
36e96905
MB
36929msgstr ""
36930
36931#. type: Plain text
5db1d29a 36932#: ../term-utils/scriptlive.1.adoc:76 ../term-utils/scriptreplay.1.adoc:96
36e96905
MB
36933msgid ""
36934"This is free software; see the source for copying conditions. There is NO "
36935"warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
36936msgstr ""
36937
36938#. type: Plain text
5db1d29a 36939#: ../term-utils/scriptlive.1.adoc:78 ../term-utils/scriptreplay.1.adoc:98
36e96905
MB
36940msgid "Released under the GNU General Public License version 2 or later."
36941msgstr ""
36942
36943#. type: Plain text
5db1d29a 36944#: ../term-utils/scriptlive.1.adoc:83
36e96905
MB
36945#, no-wrap
36946msgid ""
36947"*script*(1),\n"
36948"*scriptreplay*(1)\n"
36949msgstr ""
36950
36951#. type: Title =
36952#: ../term-utils/scriptreplay.1.adoc:2
36953#, no-wrap
36954msgid "scriptreplay(1)"
36955msgstr ""
36956
36957#. type: Plain text
36958#: ../term-utils/scriptreplay.1.adoc:13
36959msgid "scriptreplay - play back typescripts, using timing information"
36960msgstr ""
36961
36962#. type: Plain text
36963#: ../term-utils/scriptreplay.1.adoc:17
36964#, no-wrap
36965msgid "*scriptreplay* [options] [*-t*] _timingfile_ [_typescript_ [_divisor_]\n"
36966msgstr ""
36967
36968#. type: Plain text
36969#: ../term-utils/scriptreplay.1.adoc:21
36970msgid ""
36971"This program replays a typescript, using timing information to ensure that "
36972"output happens in the same rhythm as it originally appeared when the script "
36973"was recorded."
36974msgstr ""
36975
36976#. type: Plain text
36977#: ../term-utils/scriptreplay.1.adoc:23
36978msgid ""
36979"The replay simply displays the information again; the programs that were run "
36980"when the typescript was being recorded are *not run again*. Since the same "
36981"information is simply being displayed, *scriptreplay* is only guaranteed to "
36982"work properly if run on the same type of terminal the typescript was "
36983"recorded on. Otherwise, any escape characters in the typescript may be "
36984"interpreted differently by the terminal to which *scriptreplay* is sending "
36985"its output."
36986msgstr ""
36987
36988#. type: Plain text
36989#: ../term-utils/scriptreplay.1.adoc:25
36990msgid ""
36991"The timing information is what *script*(1) outputs to file specified by "
36992"*--log-timing*."
36993msgstr ""
36994
36995#. type: Plain text
36996#: ../term-utils/scriptreplay.1.adoc:27
36997msgid ""
36998"By default, the typescript to display is assumed to be named _typescript_, "
36999"but other filenames may be specified, as the second parameter or with option "
37000"*--log-out*."
37001msgstr ""
37002
37003#. type: Plain text
37004#: ../term-utils/scriptreplay.1.adoc:29
37005msgid ""
37006"If the third parameter or *--divisor* is specified, it is used as a speed-up "
37007"multiplier. For example, a speed-up of 2 makes *scriptreplay* go twice as "
37008"fast, and a speed-up of 0.1 makes it go ten times slower than the original "
37009"session."
37010msgstr ""
37011
37012#. type: Plain text
37013#: ../term-utils/scriptreplay.1.adoc:37
37014msgid "File containing *script*'s terminal output."
37015msgstr ""
37016
37017#. type: Plain text
37018#: ../term-utils/scriptreplay.1.adoc:46
37019msgid ""
37020"This is an alias for *-t*, maintained for compatibility with *script*(1) "
37021"command-line options."
37022msgstr ""
37023
37024#. type: Labeled list
37025#: ../term-utils/scriptreplay.1.adoc:47
37026#, no-wrap
37027msgid "*-s*, *--typescript* _file_"
37028msgstr ""
37029
37030#. type: Plain text
37031#: ../term-utils/scriptreplay.1.adoc:49
37032msgid ""
37033"File containing *script*'s terminal output. Deprecated alias to "
37034"*--log-out*. This option overrides old-style arguments."
37035msgstr ""
37036
37037#. type: Labeled list
37038#: ../term-utils/scriptreplay.1.adoc:50
37039#, no-wrap
37040msgid "*-c*, *--cr-mode* _mode_"
37041msgstr ""
37042
37043#. type: Plain text
37044#: ../term-utils/scriptreplay.1.adoc:52
37045msgid ""
37046"Specifies how to use the CR (0x0D, carriage return) character from log "
37047"files. The default mode is _auto_, in this case CR is replaced with line "
37048"break for stdin log, because otherwise *scriptreplay* would overwrite the "
37049"same line. The other modes are _never_ and _always_."
37050msgstr ""
37051
37052#. type: Labeled list
37053#: ../term-utils/scriptreplay.1.adoc:59
37054#, no-wrap
37055msgid "*--summary*"
37056msgstr ""
37057
37058#. type: Plain text
37059#: ../term-utils/scriptreplay.1.adoc:61
37060msgid ""
37061"Display details about the session recorded in the specified timing file and "
37062"exit. The session has to be recorded using _advanced_ format (see "
37063"*script*(1)) option *--logging-format* for more details)."
37064msgstr ""
37065
37066#. type: Labeled list
37067#: ../term-utils/scriptreplay.1.adoc:62
37068#, no-wrap
37069msgid "*-x*, *--stream* _type_"
37070msgstr ""
37071
37072#. type: Plain text
37073#: ../term-utils/scriptreplay.1.adoc:64
37074msgid ""
37075"Forces *scriptreplay* to print only the specified stream. The supported "
37076"stream types are _in_, _out_, _signal_, or _info_. This option is "
37077"recommended for multi-stream logs (e.g., *--log-io*) in order to print only "
37078"specified data."
37079msgstr ""
37080
37081#. type: delimited block .
37082#: ../term-utils/scriptreplay.1.adoc:81
37083#, no-wrap
37084msgid ""
37085"% script --log-timing file.tm --log-out script.out\n"
37086"Script started, file is script.out\n"
37087"% ls\n"
37088"<etc, etc>\n"
37089"% exit\n"
37090"Script done, file is script.out\n"
37091"% scriptreplay --log-timing file.tm --log-out script.out\n"
37092msgstr ""
37093
37094#. type: Plain text
37095#: ../term-utils/scriptreplay.1.adoc:86
37096msgid ""
37097"The original *scriptreplay* program was written by "
37098"mailto:joey@kitenet.net[Joey Hess]. The program was re-written in C by "
37099"mailto:jay@gnu.org[James Youngman] and mailto:kzak@redhat.com[Karel Zak]"
37100msgstr ""
37101
37102#. TRANSLATORS: Keep {copyright} untranslated.
37103#. type: Plain text
37104#: ../term-utils/scriptreplay.1.adoc:91
37105msgid "Copyright {copyright} 2008 James Youngman"
37106msgstr ""
37107
37108#. TRANSLATORS: Keep {copyright} untranslated.
37109#. type: Plain text
37110#: ../term-utils/scriptreplay.1.adoc:94
37111msgid "Copyright {copyright} 2008-2019 Karel Zak"
37112msgstr ""
37113
37114#. type: Plain text
37115#: ../term-utils/scriptreplay.1.adoc:103
37116#, no-wrap
37117msgid ""
37118"*script*(1),\n"
37119"*scriptlive*(1)\n"
37120msgstr ""
37121
37122#. Copyright 1990 Gordon Irlam (gordoni@cs.ua.oz.au)
37123#. Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
37124#. Copyright 2000 Colin Watson (cjw44@cam.ac.uk)
37125#. Do not restrict distribution.
37126#. May be distributed under the GNU General Public License
37127#. type: Title =
37128#: ../term-utils/setterm.1.adoc:9
37129#, no-wrap
37130msgid "setterm(1)"
37131msgstr ""
37132
37133#. type: Plain text
37134#: ../term-utils/setterm.1.adoc:19
37135msgid "setterm - set terminal attributes"
37136msgstr ""
37137
37138#. type: Plain text
37139#: ../term-utils/setterm.1.adoc:23
37140#, no-wrap
37141msgid "*setterm* [options]\n"
37142msgstr ""
37143
37144#. type: Plain text
37145#: ../term-utils/setterm.1.adoc:27
37146#, no-wrap
37147msgid ""
37148"*setterm* writes to standard output a character string that will invoke the "
37149"specified terminal capabilities. Where possible _terminfo_ is consulted to "
37150"find the string to use. Some options however (marked \"virtual consoles "
37151"only\" below) do not correspond to a *terminfo*(5) capability. In this case, "
37152"if the terminal type is \"con\" or \"linux\" the string that invokes the "
37153"specified capabilities on the PC Minix virtual console driver is "
37154"output. Options that are not implemented by the terminal are ignored.\n"
37155msgstr ""
37156
37157#. type: Plain text
37158#: ../term-utils/setterm.1.adoc:31
37159msgid "For boolean options (*on* or *off*), the default is *on*."
37160msgstr ""
37161
37162#. type: Plain text
37163#: ../term-utils/setterm.1.adoc:33
37164msgid ""
37165"Below, an _8-color_ can be *black*, *red*, *green*, *yellow*, *blue*, "
37166"*magenta*, *cyan*, or *white*."
37167msgstr ""
37168
37169#. type: Plain text
37170#: ../term-utils/setterm.1.adoc:35
37171msgid ""
37172"A _16-color_ can be an _8-color_, or *grey*, or *bright* followed by *red*, "
37173"*green*, *yellow*, *blue*, *magenta*, *cyan*, or *white*."
37174msgstr ""
37175
37176#. type: Plain text
37177#: ../term-utils/setterm.1.adoc:37
37178msgid ""
37179"The various color options may be set independently, at least on virtual "
37180"consoles, though the results of setting multiple modes (for example, "
37181"*--underline* and *--half-bright*) are hardware-dependent."
37182msgstr ""
37183
37184#. type: Plain text
37185#: ../term-utils/setterm.1.adoc:39
37186msgid ""
37187"The optional arguments require '=' (equals sign) and not space between the "
37188"option and the argument. For example --option=argument."
37189msgstr ""
37190
37191#. type: Labeled list
37192#: ../term-utils/setterm.1.adoc:40
37193#, no-wrap
37194msgid "*--appcursorkeys* on|off"
37195msgstr ""
37196
37197#. type: Plain text
37198#: ../term-utils/setterm.1.adoc:42
37199msgid ""
37200"Sets Cursor Key Application Mode on or off. When on, ESC O A, ESC O B, "
37201"etc. will be sent for the cursor keys instead of ESC [ A, ESC [ B, etc. See "
37202"the _vi and Cursor-Keys_ section of the _Text-Terminal-HOWTO_ for how this "
37203"can cause problems for *vi* users. Virtual consoles only."
37204msgstr ""
37205
37206#. type: Labeled list
37207#: ../term-utils/setterm.1.adoc:43
37208#, no-wrap
37209msgid "*--append* _console_number_"
37210msgstr ""
37211
37212#. type: Plain text
37213#: ../term-utils/setterm.1.adoc:45
37214msgid ""
37215"Like *--dump*, but appends to the snapshot file instead of overwriting "
37216"it. Only works if no *--dump* options are given."
37217msgstr ""
37218
37219#. type: Labeled list
37220#: ../term-utils/setterm.1.adoc:46
37221#, no-wrap
37222msgid "*--background* __8-color__|default"
37223msgstr ""
37224
37225#. type: Plain text
37226#: ../term-utils/setterm.1.adoc:48
37227msgid "Sets the background text color."
37228msgstr ""
37229
37230#. type: Labeled list
37231#: ../term-utils/setterm.1.adoc:49
37232#, no-wrap
37233msgid "*--blank*[=0-60|force|poke]"
37234msgstr ""
37235
37236#. type: Plain text
37237#: ../term-utils/setterm.1.adoc:51
37238msgid ""
37239"Sets the interval of inactivity, in minutes, after which the screen will be "
37240"automatically blanked (using APM if available). Without an argument, it gets "
37241"the blank status (returns which vt was blanked, or zero for an unblanked "
37242"vt). Virtual consoles only."
37243msgstr ""
37244
37245#. type: Plain text
37246#: ../term-utils/setterm.1.adoc:53
37247msgid "The *force* argument keeps the screen blank even if a key is pressed."
37248msgstr ""
37249
37250#. type: Plain text
37251#: ../term-utils/setterm.1.adoc:55
37252msgid "The *poke* argument unblanks the screen."
37253msgstr ""
37254
37255#. type: Labeled list
37256#: ../term-utils/setterm.1.adoc:56
37257#, no-wrap
37258msgid "*--bfreq*[=_number_]"
37259msgstr ""
37260
37261#. type: Plain text
37262#: ../term-utils/setterm.1.adoc:58
37263msgid ""
37264"Sets the bell frequency in Hertz. Without an argument, it defaults to "
37265"*0*. Virtual consoles only."
37266msgstr ""
37267
37268#. type: Labeled list
37269#: ../term-utils/setterm.1.adoc:59
37270#, no-wrap
37271msgid "*--blength*[=0-2000]"
37272msgstr ""
37273
37274#. type: Plain text
37275#: ../term-utils/setterm.1.adoc:61
37276msgid ""
37277"Sets the bell duration in milliseconds. Without an argument, it defaults to "
37278"*0*. Virtual consoles only."
37279msgstr ""
37280
37281#. type: Labeled list
37282#: ../term-utils/setterm.1.adoc:62
37283#, no-wrap
37284msgid "*--blink* on|off"
37285msgstr ""
37286
37287#. type: Plain text
37288#: ../term-utils/setterm.1.adoc:64
37289msgid ""
37290"Turns blink mode on or off. Except on a virtual console, *--blink off* turns "
37291"off all attributes (bold, half-brightness, blink, reverse)."
37292msgstr ""
37293
37294#. type: Labeled list
37295#: ../term-utils/setterm.1.adoc:65
37296#, no-wrap
37297msgid "*--bold* on|off"
37298msgstr ""
37299
37300#. type: Plain text
37301#: ../term-utils/setterm.1.adoc:67
37302msgid ""
37303"urns bold (extra bright) mode on or off. Except on a virtual console, "
37304"*--bold off* turns off all attributes (bold, half-brightness, blink, "
37305"reverse)."
37306msgstr ""
37307
37308#. type: Labeled list
37309#: ../term-utils/setterm.1.adoc:68
37310#, no-wrap
37311msgid "*--clear*[=all|rest]"
37312msgstr ""
37313
37314#. type: Plain text
37315#: ../term-utils/setterm.1.adoc:70
37316msgid ""
37317"Without an argument or with the argument *all*, the entire screen is cleared "
37318"and the cursor is set to the home position, just like *clear*(1) does. With "
37319"the argument *rest*, the screen is cleared from the current cursor position "
37320"to the end."
37321msgstr ""
37322
37323#. type: Labeled list
37324#: ../term-utils/setterm.1.adoc:71
37325#, no-wrap
37326msgid "*--clrtabs*[=_tab1 tab2 tab3_ ...]"
37327msgstr ""
37328
37329#. type: Plain text
37330#: ../term-utils/setterm.1.adoc:73
37331msgid ""
37332"Clears tab stops from the given horizontal cursor positions, in the range "
37333"*1-160*. Without arguments, it clears all tab stops. Virtual consoles only."
37334msgstr ""
37335
37336#. type: Labeled list
37337#: ../term-utils/setterm.1.adoc:74
37338#, no-wrap
37339msgid "*--cursor* on|off"
37340msgstr ""
37341
37342#. type: Plain text
37343#: ../term-utils/setterm.1.adoc:76
37344msgid "Turns the terminal's cursor on or off."
37345msgstr ""
37346
37347#. type: Labeled list
37348#: ../term-utils/setterm.1.adoc:77
37349#, no-wrap
37350msgid "*--default*"
37351msgstr ""
37352
37353#. type: Plain text
37354#: ../term-utils/setterm.1.adoc:79
37355msgid "Sets the terminal's rendering options to the default values."
37356msgstr ""
37357
37358#. type: Labeled list
37359#: ../term-utils/setterm.1.adoc:80
37360#, no-wrap
37361msgid "*--dump*[=_console_number_]"
37362msgstr ""
37363
37364#. type: Plain text
37365#: ../term-utils/setterm.1.adoc:82
37366msgid ""
37367"Writes a snapshot of the virtual console with the given number to the file "
37368"specified with the *--file* option, overwriting its contents; the default is "
37369"_screen.dump_. Without an argument, it dumps the current virtual "
37370"console. This overrides *--append*."
37371msgstr ""
37372
37373#. type: Labeled list
37374#: ../term-utils/setterm.1.adoc:83
37375#, no-wrap
37376msgid "*--file* _filename_"
37377msgstr ""
37378
37379#. type: Plain text
37380#: ../term-utils/setterm.1.adoc:85
37381msgid ""
37382"Sets the snapshot file name for any *--dump* or *--append* options on the "
37383"same command line. If this option is not present, the default is "
37384"_screen.dump_ in the current directory. A path name that exceeds the system "
37385"maximum will be truncated, see *PATH_MAX* from _linux/limits.h_ for the "
37386"value."
37387msgstr ""
37388
37389#. type: Labeled list
37390#: ../term-utils/setterm.1.adoc:86
37391#, no-wrap
37392msgid "*--foreground* __8-color__|default"
37393msgstr ""
37394
37395#. type: Plain text
37396#: ../term-utils/setterm.1.adoc:88
37397msgid "Sets the foreground text color."
37398msgstr ""
37399
37400#. type: Labeled list
37401#: ../term-utils/setterm.1.adoc:89
37402#, no-wrap
37403msgid "*--half-bright* on|off"
37404msgstr ""
37405
37406#. type: Plain text
37407#: ../term-utils/setterm.1.adoc:91
37408msgid ""
37409"Turns dim (half-brightness) mode on or off. Except on a virtual console, "
37410"*--half-bright off* turns off all attributes (bold, half-brightness, blink, "
37411"reverse)."
37412msgstr ""
37413
37414#. type: Labeled list
37415#: ../term-utils/setterm.1.adoc:92
37416#, no-wrap
37417msgid "*--hbcolor* [bright] _16-color_"
37418msgstr ""
37419
37420#. type: Plain text
37421#: ../term-utils/setterm.1.adoc:94
37422msgid "Sets the color for half-bright characters."
37423msgstr ""
37424
37425#. type: Labeled list
37426#: ../term-utils/setterm.1.adoc:95
37427#, no-wrap
37428msgid "*--initialize*"
37429msgstr ""
37430
37431#. type: Plain text
37432#: ../term-utils/setterm.1.adoc:97
37433msgid ""
37434"Displays the terminal initialization string, which typically sets the "
37435"terminal's rendering options, and other attributes to the default values."
37436msgstr ""
37437
37438#. type: Labeled list
37439#: ../term-utils/setterm.1.adoc:98
37440#, no-wrap
37441msgid "*--inversescreen* on|off"
37442msgstr ""
37443
37444#. type: Plain text
37445#: ../term-utils/setterm.1.adoc:100
37446msgid "Swaps foreground and background colors for the whole screen."
37447msgstr ""
37448
37449#. type: Labeled list
37450#: ../term-utils/setterm.1.adoc:101
37451#, no-wrap
37452msgid "*--linewrap* on|off"
37453msgstr ""
37454
37455#. type: Plain text
37456#: ../term-utils/setterm.1.adoc:103
37457msgid "Makes the terminal continue on a new line when a line is full."
37458msgstr ""
37459
37460#. type: Labeled list
37461#: ../term-utils/setterm.1.adoc:104
37462#, no-wrap
37463msgid "*--msg* on|off"
37464msgstr ""
37465
37466#. type: Plain text
37467#: ../term-utils/setterm.1.adoc:106
37468msgid ""
37469"Enables or disables the sending of kernel *printk*() messages to the "
37470"console. Virtual consoles only."
37471msgstr ""
37472
37473#. type: Labeled list
37474#: ../term-utils/setterm.1.adoc:107
37475#, no-wrap
37476msgid "*--msglevel* 0-8"
37477msgstr ""
37478
37479#. type: Plain text
37480#: ../term-utils/setterm.1.adoc:109
37481msgid ""
37482"Sets the console logging level for kernel *printk()* messages. All messages "
37483"strictly more important than this will be printed, so a logging level of *0* "
37484"has the same effect as *--msg on* and a logging level of *8* will print all "
37485"kernel messages. *klogd*(8) may be a more convenient interface to the "
37486"logging of kernel messages."
37487msgstr ""
37488
37489#. type: Plain text
37490#: ../term-utils/setterm.1.adoc:111
37491msgid "Virtual consoles only."
37492msgstr ""
37493
37494#. type: Labeled list
37495#: ../term-utils/setterm.1.adoc:112
37496#, no-wrap
37497msgid "*--powerdown*[=0-60]"
37498msgstr ""
37499
37500#. type: Plain text
37501#: ../term-utils/setterm.1.adoc:114
37502msgid ""
37503"Sets the VESA powerdown interval in minutes. Without an argument, it "
37504"defaults to *0* (disable powerdown). If the console is blanked or the "
37505"monitor is in suspend mode, then the monitor will go into vsync suspend mode "
37506"or powerdown mode respectively after this period of time has elapsed."
37507msgstr ""
37508
37509#. type: Labeled list
37510#: ../term-utils/setterm.1.adoc:115
37511#, no-wrap
37512msgid "*--powersave* _mode_"
37513msgstr ""
37514
37515#. type: Plain text
37516#: ../term-utils/setterm.1.adoc:117
37517msgid "Valid values for _mode_ are:"
37518msgstr ""
37519
37520#. type: Labeled list
37521#: ../term-utils/setterm.1.adoc:118
37522#, no-wrap
37523msgid "*vsync|on*"
37524msgstr ""
37525
37526#. type: Plain text
37527#: ../term-utils/setterm.1.adoc:120
37528msgid "Puts the monitor into VESA vsync suspend mode."
37529msgstr ""
37530
37531#. type: Labeled list
37532#: ../term-utils/setterm.1.adoc:120
37533#, no-wrap
37534msgid "*hsync*"
37535msgstr ""
37536
37537#. type: Plain text
37538#: ../term-utils/setterm.1.adoc:122
37539msgid "Puts the monitor into VESA hsync suspend mode."
37540msgstr ""
37541
37542#. type: Labeled list
37543#: ../term-utils/setterm.1.adoc:122
37544#, no-wrap
37545msgid "*powerdown*"
37546msgstr ""
37547
37548#. type: Plain text
37549#: ../term-utils/setterm.1.adoc:124
37550msgid "Puts the monitor into VESA powerdown mode."
37551msgstr ""
37552
37553#. type: Plain text
37554#: ../term-utils/setterm.1.adoc:126
37555msgid "Turns monitor VESA powersaving features."
37556msgstr ""
37557
37558#. type: Labeled list
37559#: ../term-utils/setterm.1.adoc:127
37560#, no-wrap
37561msgid "*--regtabs*[=1-160]"
37562msgstr ""
37563
37564#. type: Plain text
37565#: ../term-utils/setterm.1.adoc:129
37566msgid ""
37567"Clears all tab stops, then sets a regular tab stop pattern, with one tab "
37568"every specified number of positions. Without an argument, it defaults to "
37569"*8*. Virtual consoles only."
37570msgstr ""
37571
37572#. type: Labeled list
37573#: ../term-utils/setterm.1.adoc:130
37574#, no-wrap
37575msgid "*--repeat* on|off"
37576msgstr ""
37577
37578#. type: Plain text
37579#: ../term-utils/setterm.1.adoc:132
37580msgid "Turns keyboard repeat on or off. Virtual consoles only."
37581msgstr ""
37582
37583#. type: Labeled list
37584#: ../term-utils/setterm.1.adoc:133
37585#, no-wrap
37586msgid "*--reset*"
37587msgstr ""
37588
37589#. type: Plain text
37590#: ../term-utils/setterm.1.adoc:135
37591msgid ""
37592"Displays the terminal reset string, which typically resets the terminal to "
37593"its power-on state."
37594msgstr ""
37595
37596#. type: Labeled list
37597#: ../term-utils/setterm.1.adoc:136
37598#, no-wrap
37599msgid "*--resize*"
37600msgstr ""
37601
37602#. type: Plain text
37603#: ../term-utils/setterm.1.adoc:138
37604msgid ""
37605"Reset terminal size by assessing maximum row and column. This is useful when "
37606"actual geometry and kernel terminal driver are not in sync. Most notable use "
37607"case is with serial consoles, that do not use *ioctl*(3p) but just byte "
37608"streams and breaks."
37609msgstr ""
37610
37611#. type: Labeled list
37612#: ../term-utils/setterm.1.adoc:139
37613#, no-wrap
37614msgid "*--reverse* on|off"
37615msgstr ""
37616
37617#. type: Plain text
37618#: ../term-utils/setterm.1.adoc:141
37619msgid ""
37620"Turns reverse video mode on or off. Except on a virtual console, *--reverse "
37621"off* turns off all attributes (bold, half-brightness, blink, reverse)."
37622msgstr ""
37623
37624#. type: Labeled list
37625#: ../term-utils/setterm.1.adoc:142
37626#, no-wrap
37627msgid "*--store*"
37628msgstr ""
37629
37630#. type: Plain text
37631#: ../term-utils/setterm.1.adoc:144
37632msgid ""
37633"Stores the terminal's current rendering options (foreground and background "
37634"colors) as the values to be used at reset-to-default. Virtual consoles only."
37635msgstr ""
37636
37637#. type: Labeled list
37638#: ../term-utils/setterm.1.adoc:145
37639#, no-wrap
37640msgid "*--tabs*[=_tab1 tab2 tab3_ ...]"
37641msgstr ""
37642
37643#. type: Plain text
37644#: ../term-utils/setterm.1.adoc:147
37645msgid ""
37646"Sets tab stops at the given horizontal cursor positions, in the range "
37647"*1-160*. Without arguments, it shows the current tab stop settings."
37648msgstr ""
37649
37650#. type: Labeled list
37651#: ../term-utils/setterm.1.adoc:148
37652#, no-wrap
37653msgid "*--term* _terminal_name_"
37654msgstr ""
37655
37656#. type: Plain text
37657#: ../term-utils/setterm.1.adoc:150
37658msgid "Overrides the *TERM* environment variable."
37659msgstr ""
37660
37661#. type: Labeled list
37662#: ../term-utils/setterm.1.adoc:151
37663#, no-wrap
37664msgid "*--ulcolor* [bright] _16-color_"
37665msgstr ""
37666
37667#. type: Plain text
37668#: ../term-utils/setterm.1.adoc:153
37669msgid "Sets the color for underlined characters. Virtual consoles only."
37670msgstr ""
37671
37672#. type: Labeled list
37673#: ../term-utils/setterm.1.adoc:154
37674#, no-wrap
37675msgid "*--underline* on|off"
37676msgstr ""
37677
37678#. type: Plain text
37679#: ../term-utils/setterm.1.adoc:156
37680msgid "Turns underline mode on or off."
37681msgstr ""
37682
37683#. type: Plain text
37684#: ../term-utils/setterm.1.adoc:159
37685msgid "Displays version information and exits."
37686msgstr ""
37687
37688#. type: Plain text
37689#: ../term-utils/setterm.1.adoc:162
37690msgid "Displays a help text and exits."
37691msgstr ""
37692
37693#. type: Plain text
37694#: ../term-utils/setterm.1.adoc:166
37695msgid ""
37696"Since version 2.25 *setterm* has support for long options with two hyphens, "
37697"for example *--help*, beside the historical long options with a single "
37698"hyphen, for example *-help*. In scripts it is better to use the "
37699"backward-compatible single hyphen rather than the double hyphen. Currently "
37700"there are no plans nor good reasons to discontinue single-hyphen "
37701"compatibility."
37702msgstr ""
37703
37704#. type: Plain text
37705#: ../term-utils/setterm.1.adoc:170
37706msgid "Differences between the Minix and Linux versions are not documented."
37707msgstr ""
37708
37709#. type: Plain text
37710#: ../term-utils/setterm.1.adoc:177
37711#, no-wrap
37712msgid ""
37713"*stty*(1),\n"
37714"*tput*(1),\n"
37715"*tty*(4),\n"
37716"*terminfo*(5)\n"
37717msgstr ""
37718
37719#. Copyright (c) 1989, 1990 The Regents of the University of California.
37720#. All rights reserved.
37721#
37722#. Redistribution and use in source and binary forms, with or without
37723#. modification, are permitted provided that the following conditions
37724#. are met:
37725#. 1. Redistributions of source code must retain the above copyright
37726#. notice, this list of conditions and the following disclaimer.
37727#. 2. Redistributions in binary form must reproduce the above copyright
37728#. notice, this list of conditions and the following disclaimer in the
37729#. documentation and/or other materials provided with the distribution.
37730#. 3. All advertising materials mentioning features or use of this software
37731#. must display the following acknowledgement:
37732#. This product includes software developed by the University of
37733#. California, Berkeley and its contributors.
37734#. 4. Neither the name of the University nor the names of its contributors
37735#. may be used to endorse or promote products derived from this software
37736#. without specific prior written permission.
37737#
37738#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
37739#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37740#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
37741#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
37742#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37743#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37744#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
37745#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
37746#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37747#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37748#. SUCH DAMAGE.
37749#
37750#. @(#)wall.1 6.5 (Berkeley) 4/23/91
37751#
37752#. type: Title =
37753#: ../term-utils/wall.1.adoc:37
37754#, no-wrap
37755msgid "wall(1)"
37756msgstr ""
37757
37758#. type: Plain text
37759#: ../term-utils/wall.1.adoc:47
37760msgid "wall - write a message to all users"
37761msgstr ""
37762
37763#. type: Plain text
37764#: ../term-utils/wall.1.adoc:51
37765#, no-wrap
37766msgid "*wall* [*-n*] [*-t* _timeout_] [*-g* _group_] [_message_ | _file_]\n"
37767msgstr ""
37768
37769#. type: Plain text
37770#: ../term-utils/wall.1.adoc:55
37771#, no-wrap
37772msgid ""
37773"*wall* displays a _message_, or the contents of a _file_, or otherwise its "
37774"standard input, on the terminals of all currently logged in users. The "
37775"command will wrap lines that are longer than 79 characters. Short lines are "
37776"whitespace padded to have 79 characters. The command will always put a "
37777"carriage return and new line at the end of each line.\n"
37778msgstr ""
37779
37780#. type: Plain text
37781#: ../term-utils/wall.1.adoc:57
37782msgid ""
37783"Only the superuser can write on the terminals of users who have chosen to "
37784"deny messages or are using a program which automatically denies messages."
37785msgstr ""
37786
37787#. type: Plain text
37788#: ../term-utils/wall.1.adoc:59
37789msgid ""
37790"Reading from a _file_ is refused when the invoker is not superuser and the "
37791"program is set-user-ID or set-group-ID."
37792msgstr ""
37793
37794#. type: Labeled list
37795#: ../term-utils/wall.1.adoc:62
37796#, no-wrap
37797msgid "*-n*, *--nobanner*"
37798msgstr ""
37799
37800#. type: Plain text
37801#: ../term-utils/wall.1.adoc:64
37802msgid "Suppress the banner."
37803msgstr ""
37804
37805#. type: Plain text
37806#: ../term-utils/wall.1.adoc:67
37807msgid ""
37808"Abandon the write attempt to the terminals after _timeout_ seconds. This "
37809"_timeout_ must be a positive integer. The default value is 300 seconds, "
37810"which is a legacy from the time when people ran terminals over modem lines."
37811msgstr ""
37812
37813#. type: Labeled list
37814#: ../term-utils/wall.1.adoc:68
37815#, no-wrap
37816msgid "*-g*, *--group* _group_"
37817msgstr ""
37818
37819#. type: Plain text
37820#: ../term-utils/wall.1.adoc:70
37821msgid ""
37822"Limit printing message to members of group defined as a _group_ "
37823"argument. The argument can be group name or GID."
37824msgstr ""
37825
37826#. type: Plain text
37827#: ../term-utils/wall.1.adoc:80
37828msgid ""
37829"Some sessions, such as *wdm*(1x), that have in the beginning of *utmp*(5) "
37830"ut_type data a ':' character will not get the message from *wall*. This is "
37831"done to avoid write errors."
37832msgstr ""
37833
37834#. type: Plain text
37835#: ../term-utils/wall.1.adoc:84
37836msgid "A *wall* command appeared in Version 7 AT&T UNIX."
37837msgstr ""
37838
37839#. type: Plain text
37840#: ../term-utils/wall.1.adoc:91
37841#, no-wrap
37842msgid ""
37843"*mesg*(1),\n"
37844"*talk*(1),\n"
37845"*write*(1),\n"
37846"*shutdown*(8)\n"
37847msgstr ""
37848
37849#. Copyright (c) 1989, 1993
37850#. The Regents of the University of California. All rights reserved.
37851#
37852#. This code is derived from software contributed to Berkeley by
37853#. Jef Poskanzer and Craig Leres of the Lawrence Berkeley Laboratory.
37854#
37855#. Redistribution and use in source and binary forms, with or without
37856#. modification, are permitted provided that the following conditions
37857#. are met:
37858#. 1. Redistributions of source code must retain the above copyright
37859#. notice, this list of conditions and the following disclaimer.
37860#. 2. Redistributions in binary form must reproduce the above copyright
37861#. notice, this list of conditions and the following disclaimer in the
37862#. documentation and/or other materials provided with the distribution.
37863#. 3. All advertising materials mentioning features or use of this software
37864#. must display the following acknowledgement:
37865#. This product includes software developed by the University of
37866#. California, Berkeley and its contributors.
37867#. 4. Neither the name of the University nor the names of its contributors
37868#. may be used to endorse or promote products derived from this software
37869#. without specific prior written permission.
37870#
37871#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
37872#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37873#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
37874#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
37875#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37876#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37877#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
37878#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
37879#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37880#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37881#. SUCH DAMAGE.
37882#
37883#. @(#)write.1 8.1 (Berkeley) 6/6/93
37884#. type: Title =
37885#: ../term-utils/write.1.adoc:39
37886#, no-wrap
37887msgid "write(1)"
37888msgstr ""
37889
37890#. type: Plain text
37891#: ../term-utils/write.1.adoc:49
37892msgid "write - send a message to another user"
37893msgstr ""
37894
37895#. type: Plain text
37896#: ../term-utils/write.1.adoc:51
37897#, no-wrap
37898msgid "*write* _user_ [_ttyname_]\n"
37899msgstr ""
37900
37901#. type: Plain text
37902#: ../term-utils/write.1.adoc:55
37903#, no-wrap
37904msgid ""
37905"*write* allows you to communicate with other users, by copying lines from "
37906"your terminal to theirs.\n"
37907msgstr ""
37908
37909#. type: Plain text
37910#: ../term-utils/write.1.adoc:57
37911msgid ""
37912"When you run the *write* command, the user you are writing to gets a message "
37913"of the form:"
37914msgstr ""
37915
37916#. type: delimited block .
37917#: ../term-utils/write.1.adoc:60
37918#, no-wrap
37919msgid "Message from yourname@yourhost on yourtty at hh:mm ...\n"
37920msgstr ""
37921
37922#. type: Plain text
37923#: ../term-utils/write.1.adoc:63
37924msgid ""
37925"Any further lines you enter will be copied to the specified user's "
37926"terminal. If the other user wants to reply, they must run *write* as well."
37927msgstr ""
37928
37929#. type: Plain text
37930#: ../term-utils/write.1.adoc:65
37931msgid ""
37932"When you are done, type an end-of-file or interrupt character. The other "
37933"user will see the message *EOF* indicating that the conversation is over."
37934msgstr ""
37935
37936#. type: Plain text
37937#: ../term-utils/write.1.adoc:67
37938msgid ""
37939"You can prevent people (other than the superuser) from writing to you with "
37940"the *mesg*(1) command. Some commands, for example *nroff*(1) and *pr*(1), "
37941"may automatically disallow writing, so that the output they produce isn't "
37942"overwritten."
37943msgstr ""
37944
37945#. type: Plain text
37946#: ../term-utils/write.1.adoc:69
37947msgid ""
37948"If the user you want to write to is logged in on more than one terminal, you "
37949"can specify which terminal to write to by giving the terminal name as the "
37950"second operand to the *write* command. Alternatively, you can let *write* "
37951"select one of the terminals - it will pick the one with the shortest idle "
37952"time. This is so that if the user is logged in at work and also dialed up "
37953"from home, the message will go to the right place."
37954msgstr ""
37955
37956#. type: Plain text
37957#: ../term-utils/write.1.adoc:71
37958msgid ""
37959"The traditional protocol for writing to someone is that the string _-o_, "
37960"either at the end of a line or on a line by itself, means that it's the "
37961"other person's turn to talk. The string _oo_ means that the person believes "
37962"the conversation to be over."
37963msgstr ""
37964
37965#. type: Plain text
37966#: ../term-utils/write.1.adoc:83
37967msgid "A *write* command appeared in Version 6 AT&T UNIX."
37968msgstr ""
37969
37970#. type: Plain text
37971#: ../term-utils/write.1.adoc:89
37972#, no-wrap
37973msgid ""
37974"*mesg*(1),\n"
37975"*talk*(1),\n"
37976"*who*(1)\n"
37977msgstr ""
37978
37979#. Copyright (c) 1990 The Regents of the University of California.
37980#. All rights reserved.
37981#
37982#. This code is derived from software contributed to Berkeley by
37983#. Michael Rendell.
37984#
37985#. Redistribution and use in source and binary forms, with or without
37986#. modification, are permitted provided that the following conditions
37987#. are met:
37988#. 1. Redistributions of source code must retain the above copyright
37989#. notice, this list of conditions and the following disclaimer.
37990#. 2. Redistributions in binary form must reproduce the above copyright
37991#. notice, this list of conditions and the following disclaimer in the
37992#. documentation and/or other materials provided with the distribution.
37993#. 3. All advertising materials mentioning features or use of this software
37994#. must display the following acknowledgement:
37995#. This product includes software developed by the University of
37996#. California, Berkeley and its contributors.
37997#. 4. Neither the name of the University nor the names of its contributors
37998#. may be used to endorse or promote products derived from this software
37999#. without specific prior written permission.
38000#
38001#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
38002#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
38003#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
38004#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
38005#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38006#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38007#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38008#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
38009#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
38010#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38011#. SUCH DAMAGE.
38012#
38013#. @(#)col.1 6.8 (Berkeley) 6/17/91
38014#. type: Title =
38015#: ../text-utils/col.1.adoc:39
38016#, no-wrap
38017msgid "col(1)"
38018msgstr ""
38019
38020#. type: Plain text
38021#: ../text-utils/col.1.adoc:49
38022msgid "col - filter reverse line feeds from input"
38023msgstr ""
38024
38025#. type: Plain text
38026#: ../text-utils/col.1.adoc:53
38027#, no-wrap
38028msgid "*col* _options_\n"
38029msgstr ""
38030
38031#. type: Plain text
38032#: ../text-utils/col.1.adoc:57
38033#, no-wrap
38034msgid ""
38035"*col* filters out reverse (and half-reverse) line feeds so the output is in "
38036"the correct order, with only forward and half-forward line feeds. It also "
38037"replaces any whitespace characters with tabs where possible. This can be "
38038"useful in processing the output of *nroff*(1) and *tbl*(1).\n"
38039msgstr ""
38040
38041#. type: Plain text
38042#: ../text-utils/col.1.adoc:59
38043#, no-wrap
38044msgid "*col* reads from standard input and writes to standard output.\n"
38045msgstr ""
38046
38047#. type: Labeled list
38048#: ../text-utils/col.1.adoc:62
38049#, no-wrap
38050msgid "*-b*, *--no-backspaces*"
38051msgstr ""
38052
38053#. type: Plain text
38054#: ../text-utils/col.1.adoc:64
38055msgid ""
38056"Do not output any backspaces, printing only the last character written to "
38057"each column position."
38058msgstr ""
38059
38060#. type: Labeled list
38061#: ../text-utils/col.1.adoc:65
38062#, no-wrap
38063msgid "*-f*, *--fine*"
38064msgstr ""
38065
38066#. type: Plain text
38067#: ../text-utils/col.1.adoc:67
38068msgid ""
38069"Permit half-forward line feeds. Normally characters destined for a half-line "
38070"boundary are printed on the following line."
38071msgstr ""
38072
38073#. type: Labeled list
38074#: ../text-utils/col.1.adoc:68
38075#, no-wrap
38076msgid "*-h*, *--tabs*"
38077msgstr ""
38078
38079#. type: Plain text
38080#: ../text-utils/col.1.adoc:70
38081msgid "Output tabs instead of multiple spaces."
38082msgstr ""
38083
38084#. type: Labeled list
38085#: ../text-utils/col.1.adoc:71
38086#, no-wrap
38087msgid "*-l*, *--lines* _number_"
38088msgstr ""
38089
38090#. type: Plain text
38091#: ../text-utils/col.1.adoc:73
38092msgid ""
38093"Buffer at least _number_ lines in memory. By default, 128 lines are "
38094"buffered."
38095msgstr ""
38096
38097#. type: Labeled list
38098#: ../text-utils/col.1.adoc:74
38099#, no-wrap
38100msgid "*-p*, *--pass*"
38101msgstr ""
38102
38103#. type: Plain text
38104#: ../text-utils/col.1.adoc:76
38105msgid ""
38106"Force unknown control sequences to be passed through unchanged. Normally "
38107"*col* will filter out any control sequences other than those recognized and "
38108"interpreted by itself, which are listed below."
38109msgstr ""
38110
38111#. type: Labeled list
38112#: ../text-utils/col.1.adoc:77
38113#, no-wrap
38114msgid "*-x*, *--spaces*"
38115msgstr ""
38116
38117#. type: Plain text
38118#: ../text-utils/col.1.adoc:79
38119msgid "Output multiple spaces instead of tabs."
38120msgstr ""
38121
38122#. type: Labeled list
38123#: ../text-utils/col.1.adoc:83
38124#, no-wrap
38125msgid "*-H*, *--help*"
38126msgstr ""
38127
38128#. type: Plain text
38129#: ../text-utils/col.1.adoc:89
38130msgid ""
38131"The *col* utility conforms to the Single UNIX Specification, Version 2. The "
38132"*-l* option is an extension to the standard."
38133msgstr ""
38134
38135#. type: Plain text
38136#: ../text-utils/col.1.adoc:93
38137msgid ""
38138"The control sequences for carriage motion that *col* understands and their "
38139"decimal values are listed in the following table:"
38140msgstr ""
38141
38142#. type: Labeled list
38143#: ../text-utils/col.1.adoc:94
38144#, no-wrap
38145msgid "*ESC-7*"
38146msgstr ""
38147
38148#. type: Plain text
38149#: ../text-utils/col.1.adoc:96
38150msgid "reverse line feed (escape then 7)"
38151msgstr ""
38152
38153#. type: Labeled list
38154#: ../text-utils/col.1.adoc:96
38155#, no-wrap
38156msgid "*ESC-8*"
38157msgstr ""
38158
38159#. type: Plain text
38160#: ../text-utils/col.1.adoc:98
38161msgid "half reverse line feed (escape then 8)"
38162msgstr ""
38163
38164#. type: Labeled list
38165#: ../text-utils/col.1.adoc:98
38166#, no-wrap
38167msgid "*ESC-9*"
38168msgstr ""
38169
38170#. type: Plain text
38171#: ../text-utils/col.1.adoc:100
38172msgid "half forward line feed (escape then 9)"
38173msgstr ""
38174
38175#. type: Labeled list
38176#: ../text-utils/col.1.adoc:100
38177#, no-wrap
38178msgid "*backspace*"
38179msgstr ""
38180
38181#. type: Plain text
38182#: ../text-utils/col.1.adoc:102
38183msgid "moves back one column (8); ignored in the first column"
38184msgstr ""
38185
38186#. type: Labeled list
38187#: ../text-utils/col.1.adoc:102
38188#, no-wrap
38189msgid "*newline*"
38190msgstr ""
38191
38192#. type: Plain text
38193#: ../text-utils/col.1.adoc:104
38194msgid "forward line feed (10); also does carriage return"
38195msgstr ""
38196
38197#. type: Labeled list
38198#: ../text-utils/col.1.adoc:104
38199#, no-wrap
38200msgid "*carriage return*"
38201msgstr ""
38202
38203#. type: Plain text
38204#: ../text-utils/col.1.adoc:106
38205msgid "(13)"
38206msgstr ""
38207
38208#. type: Labeled list
38209#: ../text-utils/col.1.adoc:106
38210#, no-wrap
38211msgid "*shift in*"
38212msgstr ""
38213
38214#. type: Plain text
38215#: ../text-utils/col.1.adoc:108
38216msgid "shift to normal character set (15)"
38217msgstr ""
38218
38219#. type: Labeled list
38220#: ../text-utils/col.1.adoc:108
38221#, no-wrap
38222msgid "*shift out*"
38223msgstr ""
38224
38225#. type: Plain text
38226#: ../text-utils/col.1.adoc:110
38227msgid "shift to alternate character set (14)"
38228msgstr ""
38229
38230#. type: Labeled list
38231#: ../text-utils/col.1.adoc:110
38232#, no-wrap
38233msgid "*space*"
38234msgstr ""
38235
38236#. type: Plain text
38237#: ../text-utils/col.1.adoc:112
38238msgid "moves forward one column (32)"
38239msgstr ""
38240
38241#. type: Labeled list
38242#: ../text-utils/col.1.adoc:112
38243#, no-wrap
38244msgid "*tab*"
38245msgstr ""
38246
38247#. type: Plain text
38248#: ../text-utils/col.1.adoc:114
38249msgid "moves forward to next tab stop (9)"
38250msgstr ""
38251
38252#. type: Labeled list
38253#: ../text-utils/col.1.adoc:114
38254#, no-wrap
38255msgid "*vertical tab*"
38256msgstr ""
38257
38258#. type: Plain text
38259#: ../text-utils/col.1.adoc:116
38260msgid "reverse line feed (11)"
38261msgstr ""
38262
38263#. type: Plain text
38264#: ../text-utils/col.1.adoc:118
38265msgid "All unrecognized control characters and escape sequences are discarded."
38266msgstr ""
38267
38268#. type: Plain text
38269#: ../text-utils/col.1.adoc:120
38270#, no-wrap
38271msgid ""
38272"*col* keeps track of the character set as characters are read and makes sure "
38273"the character set is correct when they are output.\n"
38274msgstr ""
38275
38276#. type: Plain text
38277#: ../text-utils/col.1.adoc:122
38278msgid ""
38279"If the input attempts to back up to the last flushed line, *col* will "
38280"display a warning message."
38281msgstr ""
38282
38283#. type: Plain text
38284#: ../text-utils/col.1.adoc:126
38285msgid "A *col* command appeared in Version 6 AT&T UNIX."
38286msgstr ""
38287
38288#. type: Plain text
38289#: ../text-utils/col.1.adoc:132
38290#, no-wrap
38291msgid ""
38292"*expand*(1),\n"
38293"*nroff*(1),\n"
38294"*tbl*(1)\n"
38295msgstr ""
38296
38297#. Copyright (c) 1980, 1990, 1993
38298#. The Regents of the University of California. All rights reserved.
38299#
38300#. Redistribution and use in source and binary forms, with or without
38301#. modification, are permitted provided that the following conditions
38302#. are met:
38303#. 1. Redistributions of source code must retain the above copyright
38304#. notice, this list of conditions and the following disclaimer.
38305#. 2. Redistributions in binary form must reproduce the above copyright
38306#. notice, this list of conditions and the following disclaimer in the
38307#. documentation and/or other materials provided with the distribution.
38308#. 3. All advertising materials mentioning features or use of this software
38309#. must display the following acknowledgement:
38310#. This product includes software developed by the University of
38311#. California, Berkeley and its contributors.
38312#. 4. Neither the name of the University nor the names of its contributors
38313#. may be used to endorse or promote products derived from this software
38314#. without specific prior written permission.
38315#
38316#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
38317#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
38318#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
38319#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
38320#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38321#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38322#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38323#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
38324#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
38325#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38326#. SUCH DAMAGE.
38327#
38328#. @(#)colcrt.1 8.1 (Berkeley) 6/30/93
38329#. type: Title =
38330#: ../text-utils/colcrt.1.adoc:36
38331#, no-wrap
38332msgid "colcrt(1)"
38333msgstr ""
38334
38335#. type: Plain text
38336#: ../text-utils/colcrt.1.adoc:47
38337msgid "colcrt - filter nroff output for CRT previewing"
38338msgstr ""
38339
38340#. type: Plain text
38341#: ../text-utils/colcrt.1.adoc:51
38342#, no-wrap
38343msgid "*colcrt* [options] [_file_ ...]\n"
38344msgstr ""
38345
38346#. type: Plain text
38347#: ../text-utils/colcrt.1.adoc:55
38348#, no-wrap
38349msgid ""
38350"*colcrt* provides virtual half-line and reverse line feed sequences for "
38351"terminals without such capability, and on which overstriking is "
38352"destructive. Half-line characters and underlining (changed to dashing `-') "
38353"are placed on new lines in between the normal output lines.\n"
38354msgstr ""
38355
38356#. type: Labeled list
38357#: ../text-utils/colcrt.1.adoc:58
38358#, no-wrap
38359msgid "*-*, *--no-underlining*"
38360msgstr ""
38361
38362#. type: Plain text
38363#: ../text-utils/colcrt.1.adoc:60
38364msgid ""
38365"Suppress all underlining. This option is especially useful for previewing "
38366"_allboxed_ tables from *tbl*(1)."
38367msgstr ""
38368
38369#. type: Labeled list
38370#: ../text-utils/colcrt.1.adoc:61
38371#, no-wrap
38372msgid "*-2*, *--half-lines*"
38373msgstr ""
38374
38375#. type: Plain text
38376#: ../text-utils/colcrt.1.adoc:63
38377msgid ""
38378"Causes all half-lines to be printed, effectively double spacing the "
38379"output. Normally, a minimal space output format is used which will suppress "
38380"empty lines. The program never suppresses two consecutive empty lines, "
38381"however. The *-2* option is useful for sending output to the line printer "
38382"when the output contains superscripts and subscripts which would otherwise "
38383"be invisible."
38384msgstr ""
38385
38386#. type: Plain text
38387#: ../text-utils/colcrt.1.adoc:73
38388msgid "The *colcrt* command appeared in 3.0BSD."
38389msgstr ""
38390
38391#. type: Plain text
38392#: ../text-utils/colcrt.1.adoc:77
38393msgid ""
38394"Should fold underlines onto blanks even with the *'-'* option so that a true "
38395"underline character would show."
38396msgstr ""
38397
38398#. type: Plain text
38399#: ../text-utils/colcrt.1.adoc:79
38400msgid "Can't back up more than 102 lines."
38401msgstr ""
38402
38403#. TRANSLATORS: Keep {plus} untranslated.
38404#. type: Plain text
38405#: ../text-utils/colcrt.1.adoc:82
38406msgid ""
38407"General overstriking is lost; as a special case '|' overstruck with '-' or "
38408"underline becomes '{plus}'."
38409msgstr ""
38410
38411#. type: Plain text
38412#: ../text-utils/colcrt.1.adoc:84
38413msgid "Lines are trimmed to 132 characters."
38414msgstr ""
38415
38416#. type: Plain text
38417#: ../text-utils/colcrt.1.adoc:86
38418msgid ""
38419"Some provision should be made for processing superscripts and subscripts in "
38420"documents which are already double-spaced."
38421msgstr ""
38422
38423#. type: Plain text
38424#: ../text-utils/colcrt.1.adoc:90
38425msgid "A typical use of *colcrt* would be:"
38426msgstr ""
38427
38428#. type: delimited block _
38429#: ../text-utils/colcrt.1.adoc:93
38430#, no-wrap
38431msgid "*tbl exum2.n | nroff -ms | colcrt - | more*\n"
38432msgstr ""
38433
38434#. type: Plain text
38435#: ../text-utils/colcrt.1.adoc:103
38436#, no-wrap
38437msgid ""
38438"*col*(1),\n"
38439"*more*(1),\n"
38440"*nroff*(1),\n"
38441"*troff*(1),\n"
38442"*ul*(1)\n"
38443msgstr ""
38444
38445#. Copyright (c) 1980, 1990 The Regents of the University of California.
38446#. All rights reserved.
38447#
38448#. Redistribution and use in source and binary forms, with or without
38449#. modification, are permitted provided that the following conditions
38450#. are met:
38451#. 1. Redistributions of source code must retain the above copyright
38452#. notice, this list of conditions and the following disclaimer.
38453#. 2. Redistributions in binary form must reproduce the above copyright
38454#. notice, this list of conditions and the following disclaimer in the
38455#. documentation and/or other materials provided with the distribution.
38456#. 3. All advertising materials mentioning features or use of this software
38457#. must display the following acknowledgement:
38458#. This product includes software developed by the University of
38459#. California, Berkeley and its contributors.
38460#. 4. Neither the name of the University nor the names of its contributors
38461#. may be used to endorse or promote products derived from this software
38462#. without specific prior written permission.
38463#
38464#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
38465#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
38466#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
38467#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
38468#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38469#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38470#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38471#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
38472#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
38473#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38474#. SUCH DAMAGE.
38475#
38476#. @(#)colrm.1 6.6 (Berkeley) 3/14/91
38477#. type: Title =
38478#: ../text-utils/colrm.1.adoc:36
38479#, no-wrap
38480msgid "colrm(1)"
38481msgstr ""
38482
38483#. type: Plain text
38484#: ../text-utils/colrm.1.adoc:46
38485msgid "colrm - remove columns from a file"
38486msgstr ""
38487
38488#. type: Plain text
38489#: ../text-utils/colrm.1.adoc:50
38490#, no-wrap
38491msgid "*colrm* _[first [last]]_\n"
38492msgstr ""
38493
38494#. type: Plain text
38495#: ../text-utils/colrm.1.adoc:54
38496#, no-wrap
38497msgid ""
38498"*colrm* removes selected columns from a file. Input is taken from standard "
38499"input. Output is sent to standard output.\n"
38500msgstr ""
38501
38502#. type: Plain text
38503#: ../text-utils/colrm.1.adoc:56
38504msgid ""
38505"If called with one parameter the columns of each line will be removed "
38506"starting with the specified _first_ column. If called with two parameters "
38507"the columns from the _first_ column to the _last_ column will be removed."
38508msgstr ""
38509
38510#. type: Plain text
38511#: ../text-utils/colrm.1.adoc:58
38512msgid "Column numbering starts with column 1."
38513msgstr ""
38514
38515#. type: Plain text
38516#: ../text-utils/colrm.1.adoc:70
38517msgid "The *colrm* command appeared in 3.0BSD."
38518msgstr ""
38519
38520#. type: Plain text
38521#: ../text-utils/colrm.1.adoc:77
38522#, no-wrap
38523msgid ""
38524"*awk*(1p),\n"
38525"*column*(1),\n"
38526"*expand*(1),\n"
38527"*paste*(1)\n"
38528msgstr ""
38529
38530#. Copyright (c) 1989, 1990, 1993
38531#. The Regents of the University of California. All rights reserved.
38532#
38533#. Redistribution and use in source and binary forms, with or without
38534#. modification, are permitted provided that the following conditions
38535#. are met:
38536#. 1. Redistributions of source code must retain the above copyright
38537#. notice, this list of conditions and the following disclaimer.
38538#. 2. Redistributions in binary form must reproduce the above copyright
38539#. notice, this list of conditions and the following disclaimer in the
38540#. documentation and/or other materials provided with the distribution.
38541#. 3. All advertising materials mentioning features or use of this software
38542#. must display the following acknowledgement:
38543#. This product includes software developed by the University of
38544#. California, Berkeley and its contributors.
38545#. 4. Neither the name of the University nor the names of its contributors
38546#. may be used to endorse or promote products derived from this software
38547#. without specific prior written permission.
38548#
38549#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
38550#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
38551#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
38552#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
38553#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38554#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38555#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38556#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
38557#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
38558#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38559#. SUCH DAMAGE.
38560#
38561#. @(#)column.1 8.1 (Berkeley) 6/6/93
38562#. type: Title =
38563#: ../text-utils/column.1.adoc:36
38564#, no-wrap
38565msgid "column(1)"
38566msgstr ""
38567
38568#. type: Plain text
38569#: ../text-utils/column.1.adoc:46
38570msgid "column - columnate lists"
38571msgstr ""
38572
38573#. type: Plain text
38574#: ../text-utils/column.1.adoc:50
38575#, no-wrap
38576msgid "*column* [options] [_file_ ...]\n"
38577msgstr ""
38578
38579#. type: Plain text
38580#: ../text-utils/column.1.adoc:54
38581msgid ""
38582"The *column* utility formats its input into multiple columns. The util "
38583"support three modes:"
38584msgstr ""
38585
38586#. type: Labeled list
38587#: ../text-utils/column.1.adoc:55
38588#, no-wrap
38589msgid "*columns are filled before rows*"
38590msgstr ""
38591
38592#. type: Plain text
38593#: ../text-utils/column.1.adoc:57
38594msgid "This is the default mode (required by backward compatibility)."
38595msgstr ""
38596
38597#. type: Labeled list
38598#: ../text-utils/column.1.adoc:58
38599#, no-wrap
38600msgid "*rows are filled before columns*"
38601msgstr ""
38602
38603#. type: Plain text
38604#: ../text-utils/column.1.adoc:60
38605msgid "This mode is enabled by option *-x, --fillrows*"
38606msgstr ""
38607
38608#. type: Labeled list
38609#: ../text-utils/column.1.adoc:61
38610#, no-wrap
38611msgid "*table*"
38612msgstr ""
38613
38614#. type: Plain text
38615#: ../text-utils/column.1.adoc:63
38616msgid ""
38617"Determine the number of columns the input contains and create a table. This "
38618"mode is enabled by option *-t, --table* and columns formatting is possible "
38619"to modify by *--table-** options. Use this mode if not sure."
38620msgstr ""
38621
38622#. type: Plain text
38623#: ../text-utils/column.1.adoc:65
38624msgid ""
38625"Input is taken from _file_, or otherwise from standard input. Empty lines "
38626"are ignored and all invalid multibyte sequences are encoded by x<hex> "
38627"convention."
38628msgstr ""
38629
38630#. type: Plain text
38631#: ../text-utils/column.1.adoc:69
38632msgid ""
38633"The argument _columns_ for *--table-** options is a comma separated list of "
38634"the column names as defined by *--table-columns* or it's column number in "
38635"order as specified by input. It's possible to mix names and numbers."
38636msgstr ""
38637
38638#. type: Labeled list
38639#: ../text-utils/column.1.adoc:70
38640#, no-wrap
38641msgid "*-J, --json*"
38642msgstr ""
38643
38644#. type: Plain text
38645#: ../text-utils/column.1.adoc:72
38646msgid ""
38647"Use JSON output format to print the table, the option *--table-columns* is "
38648"required and the option *--table-name* is recommended."
38649msgstr ""
38650
38651#. type: Labeled list
38652#: ../text-utils/column.1.adoc:73
38653#, no-wrap
38654msgid "*-c, --output-width* _width_"
38655msgstr ""
38656
38657#. type: Plain text
38658#: ../text-utils/column.1.adoc:75
38659msgid ""
38660"Output is formatted to a width specified as number of characters. The "
38661"original name of this option is *--columns*; this name is deprecated since "
38662"v2.30. Note that input longer than _width_ is not truncated by default."
38663msgstr ""
38664
38665#. type: Labeled list
38666#: ../text-utils/column.1.adoc:76
38667#, no-wrap
38668msgid "*-d, --table-noheadings*"
38669msgstr ""
38670
38671#. type: Plain text
38672#: ../text-utils/column.1.adoc:78
38673msgid ""
38674"Do not print header. This option allows the use of logical column names on "
38675"the command line, but keeps the header hidden when printing the table."
38676msgstr ""
38677
38678#. type: Labeled list
38679#: ../text-utils/column.1.adoc:79
38680#, no-wrap
38681msgid "*-o, --output-separator* _string_"
38682msgstr ""
38683
38684#. type: Plain text
38685#: ../text-utils/column.1.adoc:81
38686msgid "Specify the columns delimiter for table output (default is two spaces)."
38687msgstr ""
38688
38689#. type: Labeled list
38690#: ../text-utils/column.1.adoc:82
38691#, no-wrap
38692msgid "*-s, --separator* _separators_"
38693msgstr ""
38694
38695#. type: Plain text
38696#: ../text-utils/column.1.adoc:84
38697msgid "Specify the possible input item delimiters (default is whitespace)."
38698msgstr ""
38699
38700#. type: Labeled list
38701#: ../text-utils/column.1.adoc:85
38702#, no-wrap
38703msgid "*-t, --table*"
38704msgstr ""
38705
38706#. type: Plain text
38707#: ../text-utils/column.1.adoc:87
38708msgid ""
38709"Determine the number of columns the input contains and create a "
38710"table. Columns are delimited with whitespace, by default, or with the "
38711"characters supplied using the *--output-separator* option. Table output is "
38712"useful for pretty-printing."
38713msgstr ""
38714
38715#. type: Labeled list
38716#: ../text-utils/column.1.adoc:88
38717#, no-wrap
38718msgid "*-N, --table-columns* _names_"
38719msgstr ""
38720
38721#. type: Plain text
38722#: ../text-utils/column.1.adoc:90
38723msgid ""
38724"Specify the columns names by comma separated list of names. The names are "
38725"used for the table header or to address column in option arguments."
38726msgstr ""
38727
38728#. type: Labeled list
38729#: ../text-utils/column.1.adoc:91
38730#, no-wrap
38731msgid "*-l, --table-columns-limit* _number_"
38732msgstr ""
38733
38734#. type: Plain text
38735#: ../text-utils/column.1.adoc:93
38736msgid ""
38737"Specify maximal number of the input columns. The last column will contain "
38738"all remaining line data if the limit is smaller than the number of the "
38739"columns in the input data."
38740msgstr ""
38741
38742#. type: Labeled list
38743#: ../text-utils/column.1.adoc:94
38744#, no-wrap
38745msgid "*-R, --table-right* _columns_"
38746msgstr ""
38747
38748#. type: Plain text
38749#: ../text-utils/column.1.adoc:96
38750msgid "Right align text in the specified columns."
38751msgstr ""
38752
38753#. type: Labeled list
38754#: ../text-utils/column.1.adoc:97
38755#, no-wrap
38756msgid "*-T, --table-truncate* _columns_"
38757msgstr ""
38758
38759#. type: Plain text
38760#: ../text-utils/column.1.adoc:99
38761msgid ""
38762"Specify columns where text can be truncated when necessary, otherwise very "
38763"long table entries may be printed on multiple lines."
38764msgstr ""
38765
38766#. type: Labeled list
38767#: ../text-utils/column.1.adoc:100
38768#, no-wrap
38769msgid "*-E, --table-noextreme* _columns_"
38770msgstr ""
38771
38772#. type: Plain text
38773#: ../text-utils/column.1.adoc:102
38774msgid ""
38775"Specify columns where is possible to ignore unusually long (longer than "
38776"average) cells when calculate column width. The option has impact to the "
38777"width calculation and table formatting, but the printed text is not "
38778"affected."
38779msgstr ""
38780
38781#. type: Plain text
38782#: ../text-utils/column.1.adoc:104
38783msgid "The option is used for the last visible column by default."
38784msgstr ""
38785
38786#. type: Labeled list
38787#: ../text-utils/column.1.adoc:105
38788#, no-wrap
38789msgid "*-e, --table-header-repeat*"
38790msgstr ""
38791
38792#. type: Plain text
38793#: ../text-utils/column.1.adoc:107
38794msgid "Print header line for each page."
38795msgstr ""
38796
38797#. type: Labeled list
38798#: ../text-utils/column.1.adoc:108
38799#, no-wrap
38800msgid "*-W, --table-wrap* _columns_"
38801msgstr ""
38802
38803#. type: Plain text
38804#: ../text-utils/column.1.adoc:110
38805msgid ""
38806"Specify columns where is possible to use multi-line cell for long text when "
38807"necessary."
38808msgstr ""
38809
38810#. type: Labeled list
38811#: ../text-utils/column.1.adoc:111
38812#, no-wrap
38813msgid "*-H, --table-hide* _columns_"
38814msgstr ""
38815
38816#. type: Plain text
38817#: ../text-utils/column.1.adoc:113
38818msgid ""
38819"Don't print specified columns. The special placeholder '-' may be used to "
38820"hide all unnamed columns (see *--table-columns*)."
38821msgstr ""
38822
38823#. type: Labeled list
38824#: ../text-utils/column.1.adoc:114
38825#, no-wrap
38826msgid "*-O, --table-order* _columns_"
38827msgstr ""
38828
38829#. type: Plain text
38830#: ../text-utils/column.1.adoc:116
38831msgid "Specify columns order on output."
38832msgstr ""
38833
38834#. type: Labeled list
38835#: ../text-utils/column.1.adoc:117
38836#, no-wrap
38837msgid "*-n, --table-name* _name_"
38838msgstr ""
38839
38840#. type: Plain text
38841#: ../text-utils/column.1.adoc:119
38842msgid "Specify the table name used for JSON output. The default is \"table\"."
38843msgstr ""
38844
38845#. type: Labeled list
38846#: ../text-utils/column.1.adoc:120
38847#, no-wrap
38848msgid "*-L, --keep-empty-lines*"
38849msgstr ""
38850
38851#. type: Plain text
38852#: ../text-utils/column.1.adoc:122
38853msgid ""
38854"Preserve whitespace-only lines in the input. The default is ignore empty "
5db1d29a 38855"lines at all. This option's original name was *--table-empty-lines* but is "
36e96905
MB
38856"now deprecated because it gives the false impression that the option only "
38857"applies to table mode."
38858msgstr ""
38859
38860#. type: Labeled list
38861#: ../text-utils/column.1.adoc:123
38862#, no-wrap
38863msgid "*-r, --tree* _column_"
38864msgstr ""
38865
38866#. type: Plain text
38867#: ../text-utils/column.1.adoc:125
38868msgid ""
38869"Specify column to use tree-like output. Note that the circular dependencies "
38870"and other anomalies in child and parent relation are silently ignored."
38871msgstr ""
38872
38873#. type: Labeled list
38874#: ../text-utils/column.1.adoc:126
38875#, no-wrap
38876msgid "*-i, --tree-id* _column_"
38877msgstr ""
38878
38879#. type: Plain text
38880#: ../text-utils/column.1.adoc:128
38881msgid "Specify column with line ID to create child-parent relation."
38882msgstr ""
38883
38884#. type: Labeled list
38885#: ../text-utils/column.1.adoc:129
38886#, no-wrap
38887msgid "*-p, --tree-parent* _column_"
38888msgstr ""
38889
38890#. type: Plain text
38891#: ../text-utils/column.1.adoc:131
38892msgid "Specify column with parent ID to create child-parent relation."
38893msgstr ""
38894
38895#. type: Labeled list
38896#: ../text-utils/column.1.adoc:132
38897#, no-wrap
38898msgid "*-x, --fillrows*"
38899msgstr ""
38900
38901#. type: Plain text
38902#: ../text-utils/column.1.adoc:134
38903msgid "Fill rows before filling columns."
38904msgstr ""
38905
38906#. type: Plain text
38907#: ../text-utils/column.1.adoc:144
38908msgid ""
38909"The environment variable *COLUMNS* is used to determine the size of the "
38910"screen if no other information is available."
38911msgstr ""
38912
38913#. type: Plain text
38914#: ../text-utils/column.1.adoc:148
38915msgid "The column command appeared in 4.3BSD-Reno."
38916msgstr ""
38917
38918#. type: Plain text
38919#: ../text-utils/column.1.adoc:152
38920msgid "Version 2.23 changed the *-s* option to be non-greedy, for example:"
38921msgstr ""
38922
38923#. type: delimited block .
38924#: ../text-utils/column.1.adoc:155
38925#, no-wrap
38926msgid "printf \"a:b:c\\n1::3\\n\" | column -t -s ':'\n"
38927msgstr ""
38928
38929#. type: Plain text
38930#: ../text-utils/column.1.adoc:158
38931msgid "Old output:"
38932msgstr ""
38933
38934#. type: delimited block .
38935#: ../text-utils/column.1.adoc:162
38936#, no-wrap
38937msgid ""
38938"a b c\n"
38939"1 3\n"
38940msgstr ""
38941
38942#. type: Plain text
38943#: ../text-utils/column.1.adoc:165
38944msgid "New output (since util-linux 2.23):"
38945msgstr ""
38946
38947#. type: delimited block .
38948#: ../text-utils/column.1.adoc:169
38949#, no-wrap
38950msgid ""
38951"a b c\n"
38952"1 3\n"
38953msgstr ""
38954
38955#. type: Plain text
38956#: ../text-utils/column.1.adoc:172
38957msgid ""
38958"Historical versions of this tool indicated that \"rows are filled before "
38959"columns\" by default, and that the *-x* option reverses this. This wording "
38960"did not reflect the actual behavior, and it has since been corrected (see "
38961"above). Other implementations of *column* may continue to use the older "
38962"documentation, but the behavior should be identical in any case."
38963msgstr ""
38964
38965#. type: Plain text
38966#: ../text-utils/column.1.adoc:176
38967msgid "Print fstab with header line and align number to the right:"
38968msgstr ""
38969
38970#. type: delimited block .
38971#: ../text-utils/column.1.adoc:179
38972#, no-wrap
38973msgid ""
38974"sed 's/#.*//' /etc/fstab | column --table --table-columns "
38975"SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ --table-right PASS,FREQ\n"
38976msgstr ""
38977
38978#. type: Plain text
38979#: ../text-utils/column.1.adoc:182
38980msgid "Print fstab and hide unnamed columns:"
38981msgstr ""
38982
38983#. type: delimited block .
38984#: ../text-utils/column.1.adoc:185
38985#, no-wrap
38986msgid ""
38987"sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE "
38988"--table-hide -\n"
38989msgstr ""
38990
38991#. type: Plain text
38992#: ../text-utils/column.1.adoc:188
38993msgid "Print a tree:"
38994msgstr ""
38995
38996#. type: delimited block .
38997#: ../text-utils/column.1.adoc:196
38998#, no-wrap
38999msgid ""
39000"echo -e '1 0 A\\n2 1 AA\\n3 1 AB\\n4 2 AAA\\n5 2 AAB' | column --tree-id 1 "
39001"--tree-parent 2 --tree 3\n"
39002"1 0 A\n"
39003"2 1 |-AA\n"
39004"4 2 | |-AAA\n"
39005"5 2 | `-AAB\n"
39006"3 1 `-AB\n"
39007msgstr ""
39008
39009#. type: Plain text
39010#: ../text-utils/column.1.adoc:204
39011#, no-wrap
39012msgid ""
39013"*colrm*(1),\n"
39014"*ls*(1),\n"
39015"*paste*(1),\n"
39016"*sort*(1)\n"
39017msgstr ""
39018
39019#. Copyright (c) 1989, 1990, 1993
39020#. The Regents of the University of California. All rights reserved.
39021#
39022#. Redistribution and use in source and binary forms, with or without
39023#. modification, are permitted provided that the following conditions
39024#. are met:
39025#. 1. Redistributions of source code must retain the above copyright
39026#. notice, this list of conditions and the following disclaimer.
39027#. 2. Redistributions in binary form must reproduce the above copyright
39028#. notice, this list of conditions and the following disclaimer in the
39029#. documentation and/or other materials provided with the distribution.
39030#. 3. All advertising materials mentioning features or use of this software
39031#. must display the following acknowledgement:
39032#. This product includes software developed by the University of
39033#. California, Berkeley and its contributors.
39034#. 4. Neither the name of the University nor the names of its contributors
39035#. may be used to endorse or promote products derived from this software
39036#. without specific prior written permission.
39037#
39038#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
39039#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
39040#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
39041#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
39042#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
39043#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
39044#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39045#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
39046#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
39047#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
39048#. SUCH DAMAGE.
39049#
39050#. @(#)hexdump.1 8.2 (Berkeley) 4/18/94
39051#. type: Title =
39052#: ../text-utils/hexdump.1.adoc:36
39053#, no-wrap
39054msgid "hexdump(1)"
39055msgstr ""
39056
39057#. type: Plain text
39058#: ../text-utils/hexdump.1.adoc:48
39059msgid "hexdump - display file contents in hexadecimal, decimal, octal, or ascii"
39060msgstr ""
39061
39062#. type: Plain text
39063#: ../text-utils/hexdump.1.adoc:50
39064#, no-wrap
39065msgid "*hexdump* _options file_ ...\n"
39066msgstr ""
39067
39068#. type: Plain text
39069#: ../text-utils/hexdump.1.adoc:54
39070msgid ""
39071"The *hexdump* utility is a filter which displays the specified files, or "
39072"standard input if no files are specified, in a user-specified format."
39073msgstr ""
39074
39075#. type: Plain text
39076#: ../text-utils/hexdump.1.adoc:58
39077msgid ""
39078"Below, the _length_ and _offset_ arguments may be followed by the "
39079"multiplicative suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, "
39080"TiB, PiB, EiB, ZiB and YiB (the \"iB\" is optional, e.g., \"K\" has the same "
39081"meaning as \"KiB\"), or the suffixes KB (=1000), MB (=1000*1000), and so on "
39082"for GB, TB, PB, EB, ZB and YB."
39083msgstr ""
39084
39085#. type: Labeled list
39086#: ../text-utils/hexdump.1.adoc:59
39087#, no-wrap
39088msgid "*-b*, *--one-byte-octal*"
39089msgstr ""
39090
39091#. type: Plain text
39092#: ../text-utils/hexdump.1.adoc:61
39093msgid ""
39094"_One-byte octal display_. Display the input offset in hexadecimal, followed "
39095"by sixteen space-separated, three-column, zero-filled bytes of input data, "
39096"in octal, per line."
39097msgstr ""
39098
39099#. type: Labeled list
39100#: ../text-utils/hexdump.1.adoc:62
39101#, no-wrap
39102msgid "*-c*, *--one-byte-char*"
39103msgstr ""
39104
39105#. type: Plain text
39106#: ../text-utils/hexdump.1.adoc:64
39107msgid ""
39108"_One-byte character display_. Display the input offset in hexadecimal, "
39109"followed by sixteen space-separated, three-column, space-filled characters "
39110"of input data per line."
39111msgstr ""
39112
39113#. type: Labeled list
39114#: ../text-utils/hexdump.1.adoc:65
39115#, no-wrap
39116msgid "*-C*, *--canonical*"
39117msgstr ""
39118
39119#. TRANSLATORS: Keep {plus} and {underscore} untranslated.
39120#. type: Plain text
39121#: ../text-utils/hexdump.1.adoc:68
39122msgid ""
39123"_Canonical hex{plus}ASCII display_. Display the input offset in hexadecimal, "
39124"followed by sixteen space-separated, two-column, hexadecimal bytes, followed "
39125"by the same sixteen bytes in *%{underscore}p* format enclosed in '*|*' "
39126"characters. Invoking the program as *hd* implies this option."
39127msgstr ""
39128
39129#. type: Labeled list
39130#: ../text-utils/hexdump.1.adoc:69
39131#, no-wrap
39132msgid "*-d*, *--two-bytes-decimal*"
39133msgstr ""
39134
39135#. type: Plain text
39136#: ../text-utils/hexdump.1.adoc:71
39137msgid ""
39138"_Two-byte decimal display_. Display the input offset in hexadecimal, "
39139"followed by eight space-separated, five-column, zero-filled, two-byte units "
39140"of input data, in unsigned decimal, per line."
39141msgstr ""
39142
39143#. type: Labeled list
39144#: ../text-utils/hexdump.1.adoc:72
39145#, no-wrap
39146msgid "*-e*, *--format* _format_string_"
39147msgstr ""
39148
39149#. type: Plain text
39150#: ../text-utils/hexdump.1.adoc:74
39151msgid "Specify a format string to be used for displaying data."
39152msgstr ""
39153
39154#. type: Labeled list
39155#: ../text-utils/hexdump.1.adoc:75
39156#, no-wrap
39157msgid "*-f*, *--format-file* _file_"
39158msgstr ""
39159
39160#. type: Plain text
39161#: ../text-utils/hexdump.1.adoc:77
39162msgid ""
39163"Specify a file that contains one or more newline-separated format "
39164"strings. Empty lines and lines whose first non-blank character is a hash "
39165"mark (#) are ignored."
39166msgstr ""
39167
39168#. type: Plain text
39169#: ../text-utils/hexdump.1.adoc:80
39170msgid ""
39171"Accept color units for the output. The optional argument _when_ can be "
39172"*auto*, *never* or *always*. If the _when_ argument is omitted, it defaults "
39173"to *auto*. The colors can be disabled; for the current built-in default see "
39174"the *--help* output. See also the *Colors* subsection and the *COLORS* "
39175"section below."
39176msgstr ""
39177
39178#. type: Labeled list
39179#: ../text-utils/hexdump.1.adoc:81
39180#, no-wrap
39181msgid "*-n*, *--length* _length_"
39182msgstr ""
39183
39184#. type: Plain text
39185#: ../text-utils/hexdump.1.adoc:83
39186msgid "Interpret only _length_ bytes of input."
39187msgstr ""
39188
39189#. type: Labeled list
39190#: ../text-utils/hexdump.1.adoc:84
39191#, no-wrap
39192msgid "*-o*, *--two-bytes-octal*"
39193msgstr ""
39194
39195#. type: Plain text
39196#: ../text-utils/hexdump.1.adoc:86
39197msgid ""
39198"_Two-byte octal display_. Display the input offset in hexadecimal, followed "
39199"by eight space-separated, six-column, zero-filled, two-byte quantities of "
39200"input data, in octal, per line."
39201msgstr ""
39202
39203#. type: Labeled list
39204#: ../text-utils/hexdump.1.adoc:87
39205#, no-wrap
39206msgid "*-s*, *--skip* _offset_"
39207msgstr ""
39208
39209#. type: Plain text
39210#: ../text-utils/hexdump.1.adoc:89
39211msgid "Skip _offset_ bytes from the beginning of the input."
39212msgstr ""
39213
39214#. type: Labeled list
39215#: ../text-utils/hexdump.1.adoc:90
39216#, no-wrap
39217msgid "*-v*, *--no-squeezing*"
39218msgstr ""
39219
39220#. type: Plain text
39221#: ../text-utils/hexdump.1.adoc:92
39222msgid ""
39223"The *-v* option causes *hexdump* to display all input data. Without the *-v* "
39224"option, any number of groups of output lines which would be identical to the "
39225"immediately preceding group of output lines (except for the input offsets), "
39226"are replaced with a line comprised of a single asterisk."
39227msgstr ""
39228
39229#. type: Labeled list
39230#: ../text-utils/hexdump.1.adoc:93
39231#, no-wrap
39232msgid "*-x*, *--two-bytes-hex*"
39233msgstr ""
39234
39235#. type: Plain text
39236#: ../text-utils/hexdump.1.adoc:95
39237msgid ""
39238"_Two-byte hexadecimal display_. Display the input offset in hexadecimal, "
39239"followed by eight space-separated, four-column, zero-filled, two-byte "
39240"quantities of input data, in hexadecimal, per line."
39241msgstr ""
39242
39243#. type: Plain text
39244#: ../text-utils/hexdump.1.adoc:103
39245msgid ""
39246"For each input file, *hexdump* sequentially copies the input to standard "
39247"output, transforming the data according to the format strings specified by "
39248"the *-e* and *-f* options, in the order that they were specified."
39249msgstr ""
39250
39251#. type: Title ==
39252#: ../text-utils/hexdump.1.adoc:104
39253#, no-wrap
39254msgid "FORMATS"
39255msgstr ""
39256
39257#. type: Plain text
39258#: ../text-utils/hexdump.1.adoc:107
39259msgid ""
39260"A format string contains any number of format units, separated by "
39261"whitespace. A format unit contains up to three items: an iteration count, a "
39262"byte count, and a format."
39263msgstr ""
39264
39265#. type: Plain text
39266#: ../text-utils/hexdump.1.adoc:109
39267msgid ""
39268"The iteration count is an optional positive integer, which defaults to "
39269"one. Each format is applied iteration count times."
39270msgstr ""
39271
39272#. type: Plain text
39273#: ../text-utils/hexdump.1.adoc:111
39274msgid ""
39275"The byte count is an optional positive integer. If specified it defines the "
39276"number of bytes to be interpreted by each iteration of the format."
39277msgstr ""
39278
39279#. type: Plain text
39280#: ../text-utils/hexdump.1.adoc:113
39281msgid ""
39282"If an iteration count and/or a byte count is specified, a single slash must "
39283"be placed after the iteration count and/or before the byte count to "
39284"disambiguate them. Any whitespace before or after the slash is ignored."
39285msgstr ""
39286
39287#. type: Plain text
39288#: ../text-utils/hexdump.1.adoc:115
39289msgid ""
39290"The format is required and must be surrounded by double quote (\" \") "
39291"marks. It is interpreted as a fprintf-style format string (see *fprintf*(3), "
39292"with the following exceptions:"
39293msgstr ""
39294
39295#. type: Labeled list
39296#: ../text-utils/hexdump.1.adoc:116
39297#, no-wrap
39298msgid "1."
39299msgstr ""
39300
39301#. type: Plain text
39302#: ../text-utils/hexdump.1.adoc:118
39303msgid "An asterisk (*) may not be used as a field width or precision."
39304msgstr ""
39305
39306#. type: Labeled list
39307#: ../text-utils/hexdump.1.adoc:119
39308#, no-wrap
39309msgid "2."
39310msgstr ""
39311
39312#. type: Plain text
39313#: ../text-utils/hexdump.1.adoc:121
39314msgid ""
39315"A byte count or field precision _is_ required for each *s* conversion "
39316"character (unlike the fprintf3 default which prints the entire string if the "
39317"precision is unspecified)."
39318msgstr ""
39319
39320#. type: Labeled list
39321#: ../text-utils/hexdump.1.adoc:122
39322#, no-wrap
39323msgid "3."
39324msgstr ""
39325
39326#. type: Plain text
39327#: ../text-utils/hexdump.1.adoc:124
39328msgid "The conversion characters *h*, *l*, *n*, *p*, and *q* are not supported."
39329msgstr ""
39330
39331#. type: Labeled list
39332#: ../text-utils/hexdump.1.adoc:125
39333#, no-wrap
39334msgid "4."
39335msgstr ""
39336
39337#. type: Plain text
39338#: ../text-utils/hexdump.1.adoc:127
39339msgid ""
39340"The single character escape sequences described in the C standard are "
39341"supported:"
39342msgstr ""
39343
39344#. type: Table
39345#: ../text-utils/hexdump.1.adoc:138
39346#, no-wrap
39347msgid ""
39348"|NULL |\\0\n"
39349"|<alert character> |\\a\n"
39350"|<backspace> |\\b\n"
39351"|<form-feed> |\\f\n"
39352"|<newline> |\\n\n"
39353"|<carriage return> |\\r\n"
39354"|<tab> |\\t\n"
39355"|<vertical tab> |\\v\n"
39356msgstr ""
39357
39358#. type: Title ===
39359#: ../text-utils/hexdump.1.adoc:141
39360#, no-wrap
39361msgid "Conversion strings"
39362msgstr ""
39363
39364#. type: delimited block _
39365#: ../text-utils/hexdump.1.adoc:144
39366msgid ""
39367"The *hexdump* utility also supports the following additional conversion "
39368"strings."
39369msgstr ""
39370
39371#. type: Labeled list
39372#: ../text-utils/hexdump.1.adoc:145
39373#, no-wrap
39374msgid "*_a[dox]*"
39375msgstr ""
39376
39377#. type: delimited block _
39378#: ../text-utils/hexdump.1.adoc:147
39379msgid ""
39380"Display the input offset, cumulative across input files, of the next byte to "
39381"be displayed. The appended characters *d*, *o*, and *x* specify the display "
39382"base as decimal, octal or hexadecimal respectively."
39383msgstr ""
39384
39385#. type: Labeled list
39386#: ../text-utils/hexdump.1.adoc:148
39387#, no-wrap
39388msgid "*_A[dox]*"
39389msgstr ""
39390
39391#. type: delimited block _
39392#: ../text-utils/hexdump.1.adoc:150
39393msgid ""
39394"Identical to the *_a* conversion string except that it is only performed "
39395"once, when all of the input data has been processed."
39396msgstr ""
39397
39398#. type: Labeled list
39399#: ../text-utils/hexdump.1.adoc:151
39400#, no-wrap
39401msgid "*_c*"
39402msgstr ""
39403
39404#. type: delimited block _
39405#: ../text-utils/hexdump.1.adoc:153
39406msgid ""
39407"Output characters in the default character set. Non-printing characters are "
39408"displayed in three-character, zero-padded octal, except for those "
39409"representable by standard escape notation (see above), which are displayed "
39410"as two-character strings."
39411msgstr ""
39412
39413#. type: Labeled list
39414#: ../text-utils/hexdump.1.adoc:154
39415#, no-wrap
39416msgid "*_p*"
39417msgstr ""
39418
39419#. type: delimited block _
39420#: ../text-utils/hexdump.1.adoc:156
39421msgid ""
39422"Output characters in the default character set. Non-printing characters are "
39423"displayed as a single '*.*'."
39424msgstr ""
39425
39426#. type: Labeled list
39427#: ../text-utils/hexdump.1.adoc:157
39428#, no-wrap
39429msgid "*_u*"
39430msgstr ""
39431
39432#. type: delimited block _
39433#: ../text-utils/hexdump.1.adoc:159
39434msgid ""
39435"Output US ASCII characters, with the exception that control characters are "
39436"displayed using the following, lower-case, names. Characters greater than "
39437"0xff, hexadecimal, are displayed as hexadecimal strings."
39438msgstr ""
39439
39440#. type: Table
39441#: ../text-utils/hexdump.1.adoc:168
39442#, no-wrap
39443msgid ""
39444"|000 nul |001 soh |002 stx |003 etx |004 eot |005 enq\n"
39445"|006 ack |007 bel |008 bs |009 ht |00A lf |00B vt\n"
39446"|00C ff |00D cr |00E so |00F si |010 dle |011 dc1\n"
39447"|012 dc2 |013 dc3 |014 dc4 |015 nak |016 syn |017 etb\n"
39448"|018 can |019 em |01A sub |01B esc |01C fs |01D gs\n"
39449"|01E rs |01F us |0FF del | | |\n"
39450msgstr ""
39451
39452#. type: Title ===
39453#: ../text-utils/hexdump.1.adoc:171
39454#, no-wrap
39455msgid "Colors"
39456msgstr ""
39457
39458#. type: delimited block _
39459#: ../text-utils/hexdump.1.adoc:174
39460msgid ""
39461"When put at the end of a format specifier, hexdump highlights the respective "
39462"string with the color specified. Conditions, if present, are evaluated prior "
39463"to highlighting."
39464msgstr ""
39465
39466#. type: delimited block _
39467#: ../text-utils/hexdump.1.adoc:176
39468#, no-wrap
39469msgid "*_L[color_unit_1,color_unit_2,...,color_unit_n]*\n"
39470msgstr ""
39471
39472#. type: delimited block _
39473#: ../text-utils/hexdump.1.adoc:178
39474msgid "The full syntax of a color unit is as follows:"
39475msgstr ""
39476
39477#. type: delimited block _
39478#: ../text-utils/hexdump.1.adoc:180
39479#, no-wrap
39480msgid "*[!]COLOR[:VALUE][@OFFSET_START[-END]]*\n"
39481msgstr ""
39482
39483#. type: Labeled list
39484#: ../text-utils/hexdump.1.adoc:181
39485#, no-wrap
39486msgid "*!*"
39487msgstr ""
39488
39489#. type: delimited block _
39490#: ../text-utils/hexdump.1.adoc:183
39491msgid ""
39492"Negate the condition. Please note that it only makes sense to negate a unit "
39493"if both a value/string and an offset are specified. In that case the "
39494"respective output string will be highlighted if and only if the value/string "
39495"does not match the one at the offset."
39496msgstr ""
39497
39498#. type: Labeled list
39499#: ../text-utils/hexdump.1.adoc:184
39500#, no-wrap
39501msgid "*COLOR*"
39502msgstr ""
39503
39504#. type: delimited block _
39505#: ../text-utils/hexdump.1.adoc:186
39506msgid "One of the 8 basic shell colors."
39507msgstr ""
39508
39509#. type: Labeled list
39510#: ../text-utils/hexdump.1.adoc:187
39511#, no-wrap
39512msgid "*VALUE*"
39513msgstr ""
39514
39515#. type: delimited block _
39516#: ../text-utils/hexdump.1.adoc:189
39517msgid ""
39518"A value to be matched specified in hexadecimal, or octal base, or as a "
39519"string. Please note that the usual C escape sequences are not interpreted by "
39520"hexdump inside the color_units."
39521msgstr ""
39522
39523#. type: Labeled list
39524#: ../text-utils/hexdump.1.adoc:190
39525#, no-wrap
39526msgid "*OFFSET*"
39527msgstr ""
39528
39529#. type: delimited block _
39530#: ../text-utils/hexdump.1.adoc:192
39531msgid ""
39532"An offset or an offset range at which to check for a match. Please note that "
39533"lone OFFSET_START uses the same value as END offset."
39534msgstr ""
39535
39536#. type: Title ===
39537#: ../text-utils/hexdump.1.adoc:193
39538#, no-wrap
39539msgid "Counters"
39540msgstr ""
39541
39542#. type: delimited block _
39543#: ../text-utils/hexdump.1.adoc:196
39544msgid ""
39545"The default and supported byte counts for the conversion characters are as "
39546"follows:"
39547msgstr ""
39548
39549#. type: Labeled list
39550#: ../text-utils/hexdump.1.adoc:197
39551#, no-wrap
39552msgid "*%_c*, *%_p*, *%_u*, *%c*"
39553msgstr ""
39554
39555#. type: delimited block _
39556#: ../text-utils/hexdump.1.adoc:199
39557msgid "One byte counts only."
39558msgstr ""
39559
39560#. type: Labeled list
39561#: ../text-utils/hexdump.1.adoc:200
39562#, no-wrap
39563msgid "*%d*, *%i*, *%o*, *%u*, *%X*, *%x*"
39564msgstr ""
39565
39566#. type: delimited block _
39567#: ../text-utils/hexdump.1.adoc:202
39568msgid "Four byte default, one, two and four byte counts supported."
39569msgstr ""
39570
39571#. type: Labeled list
39572#: ../text-utils/hexdump.1.adoc:203
39573#, no-wrap
39574msgid "*%E*, *%e*, *%f*, *%G*, *%g*"
39575msgstr ""
39576
39577#. type: delimited block _
39578#: ../text-utils/hexdump.1.adoc:205
39579msgid "Eight byte default, four byte counts supported."
39580msgstr ""
39581
39582#. type: delimited block _
39583#: ../text-utils/hexdump.1.adoc:207
39584msgid ""
39585"The amount of data interpreted by each format string is the sum of the data "
39586"required by each format unit, which is the iteration count times the byte "
39587"count, or the iteration count times the number of bytes required by the "
39588"format if the byte count is not specified."
39589msgstr ""
39590
39591#. type: delimited block _
39592#: ../text-utils/hexdump.1.adoc:209
39593msgid ""
39594"The input is manipulated in _blocks_, where a block is defined as the "
39595"largest amount of data specified by any format string. Format strings "
39596"interpreting less than an input block's worth of data, whose last format "
39597"unit both interprets some number of bytes and does not have a specified "
39598"iteration count, have the iteration count incremented until the entire input "
39599"block has been processed or there is not enough data remaining in the block "
39600"to satisfy the format string."
39601msgstr ""
39602
39603#. type: delimited block _
39604#: ../text-utils/hexdump.1.adoc:211
39605msgid ""
39606"If, either as a result of user specification or *hexdump* modifying the "
39607"iteration count as described above, an iteration count is greater than one, "
39608"no trailing whitespace characters are output during the last iteration."
39609msgstr ""
39610
39611#. type: delimited block _
39612#: ../text-utils/hexdump.1.adoc:213
39613msgid ""
39614"It is an error to specify a byte count as well as multiple conversion "
39615"characters or strings unless all but one of the conversion characters or "
39616"strings is *_a* or *_A*."
39617msgstr ""
39618
39619#. type: delimited block _
39620#: ../text-utils/hexdump.1.adoc:215
39621msgid ""
39622"If, as a result of the specification of the *-n* option or end-of-file being "
39623"reached, input data only partially satisfies a format string, the input "
39624"block is zero-padded sufficiently to display all available data (i.e., any "
39625"format units overlapping the end of data will display some number of the "
39626"zero bytes)."
39627msgstr ""
39628
39629#. TRANSLATORS: Keep {plus} untranslated.
39630#. type: delimited block _
39631#: ../text-utils/hexdump.1.adoc:218
39632msgid ""
39633"Further output by such format strings is replaced by an equivalent number of "
39634"spaces. An equivalent number of spaces is defined as the number of spaces "
39635"output by an *s* conversion character with the same field width and "
39636"precision as the original conversion character or conversion string but with "
39637"any '*{plus}*', ' ', '*#*' conversion flag characters removed, and "
39638"referencing a NULL string."
39639msgstr ""
39640
39641#. type: delimited block _
39642#: ../text-utils/hexdump.1.adoc:220
39643msgid ""
39644"If no format strings are specified, the default display is very similar to "
39645"the *-x* output format (the *-x* option causes more space to be used between "
39646"format units than in the default output)."
39647msgstr ""
39648
39649#. type: delimited block _
39650#: ../text-utils/hexdump.1.adoc:224
39651#, no-wrap
39652msgid "*hexdump* exits 0 on success and > 0 if an error occurred.\n"
39653msgstr ""
39654
39655#. type: delimited block _
39656#: ../text-utils/hexdump.1.adoc:228
39657msgid ""
39658"The *hexdump* utility is expected to be IEEE Std 1003.2 (\"POSIX.2\") "
39659"compatible."
39660msgstr ""
39661
39662#. type: delimited block _
39663#: ../text-utils/hexdump.1.adoc:232
39664msgid "Display the input in perusal format:"
39665msgstr ""
39666
39667#. type: delimited block .
39668#: ../text-utils/hexdump.1.adoc:237
39669#, no-wrap
39670msgid ""
39671" \"%06.6_ao \" 12/1 \"%3_u \"\n"
39672" \"\\t\" \"%_p \"\n"
39673" \"\\n\"\n"
39674msgstr ""
39675
39676#. type: Plain text
39677#: ../text-utils/hexdump.1.adoc:240
39678msgid "Implement the *-x* option:"
39679msgstr ""
39680
39681#. type: delimited block .
39682#: ../text-utils/hexdump.1.adoc:244
39683#, no-wrap
39684msgid ""
39685" \"%07.7_Ax\\n\"\n"
39686" \"%07.7_ax \" 8/2 \"%04x \" \"\\n\"\n"
39687msgstr ""
39688
39689#. type: Plain text
39690#: ../text-utils/hexdump.1.adoc:247
39691msgid ""
39692"MBR Boot Signature example: Highlight the addresses cyan and the bytes at "
39693"offsets 510 and 511 green if their value is 0xAA55, red otherwise."
39694msgstr ""
39695
39696#. type: delimited block .
39697#: ../text-utils/hexdump.1.adoc:251
39698#, no-wrap
39699msgid ""
39700" \"%07.7_Ax_L[cyan]\\n\"\n"
39701" \"%07.7_ax_L[cyan] \" 8/2 \" "
39702"%04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] \" \"\\n\"\n"
39703msgstr ""
39704
39705#. type: Plain text
39706#: ../text-utils/hexdump.1.adoc:256
39707msgid ""
39708"Implicit coloring can be disabled by an empty file "
39709"_/etc/terminal-colors.d/hexdump.disable_."
39710msgstr ""
39711
39712#. This page is in the public domain
39713#. type: Title =
39714#: ../text-utils/line.1.adoc:3
39715#, no-wrap
39716msgid "line(1)"
39717msgstr ""
39718
39719#. type: Plain text
39720#: ../text-utils/line.1.adoc:13
39721msgid "line - read one line"
39722msgstr ""
39723
39724#. type: Plain text
39725#: ../text-utils/line.1.adoc:17
39726#, no-wrap
39727msgid "*line*\n"
39728msgstr ""
39729
39730#. type: Plain text
39731#: ../text-utils/line.1.adoc:21
39732msgid ""
39733"The utility *line* copies one line (up to a newline) from standard input to "
39734"standard output. It always prints at least a newline and returns an exit "
39735"status of 1 on EOF or read error."
39736msgstr ""
39737
39738#. type: Plain text
39739#: ../text-utils/line.1.adoc:25
39740#, no-wrap
39741msgid "*read*(1p)\n"
39742msgstr ""
39743
39744#. Copyright (c) 1988, 1990 The Regents of the University of California.
39745#. Copyright (c) 1988 Mark Nudleman
39746#. All rights reserved.
39747#
39748#. Redistribution and use in source and binary forms, with or without
39749#. modification, are permitted provided that the following conditions
39750#. are met:
39751#. 1. Redistributions of source code must retain the above copyright
39752#. notice, this list of conditions and the following disclaimer.
39753#. 2. Redistributions in binary form must reproduce the above copyright
39754#. notice, this list of conditions and the following disclaimer in the
39755#. documentation and/or other materials provided with the distribution.
39756#. 3. All advertising materials mentioning features or use of this software
39757#. must display the following acknowledgement:
39758#. This product includes software developed by the University of
39759#. California, Berkeley and its contributors.
39760#. 4. Neither the name of the University nor the names of its contributors
39761#. may be used to endorse or promote products derived from this software
39762#. without specific prior written permission.
39763#
39764#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
39765#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
39766#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
39767#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
39768#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
39769#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
39770#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39771#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
39772#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
39773#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
39774#. SUCH DAMAGE.
39775#
39776#. @(#)more.1 5.15 (Berkeley) 7/29/91
39777#
39778#. Copyright (c) 1992 Rik Faith (faith@cs.unc.edu)
39779#. type: Title =
39780#: ../text-utils/more.1.adoc:39
39781#, no-wrap
39782msgid "more(1)"
39783msgstr ""
39784
39785#. type: Plain text
39786#: ../text-utils/more.1.adoc:49
39787msgid "more - file perusal filter for crt viewing"
39788msgstr ""
39789
39790#. type: Plain text
39791#: ../text-utils/more.1.adoc:53
39792#, no-wrap
39793msgid "*more* [options] _file_ ...\n"
39794msgstr ""
39795
39796#. type: Plain text
39797#: ../text-utils/more.1.adoc:57
39798#, no-wrap
39799msgid ""
39800"*more* is a filter for paging through text one screenful at a time. This "
39801"version is especially primitive. Users should realize that *less*(1) "
39802"provides *more*(1) emulation plus extensive enhancements.\n"
39803msgstr ""
39804
39805#. type: Plain text
39806#: ../text-utils/more.1.adoc:61
39807msgid ""
39808"Options are also taken from the environment variable *MORE* (make sure to "
39809"precede them with a dash (*-*)) but command-line options will override "
39810"those."
39811msgstr ""
39812
39813#. type: Labeled list
39814#: ../text-utils/more.1.adoc:62
39815#, no-wrap
39816msgid "*-d*, *--silent*"
39817msgstr ""
39818
39819#. type: Plain text
39820#: ../text-utils/more.1.adoc:64
39821msgid ""
39822"Prompt with \"[Press space to continue, 'q' to quit.]\", and display "
39823"\"[Press 'h' for instructions.]\" instead of ringing the bell when an "
39824"illegal key is pressed."
39825msgstr ""
39826
39827#. type: Labeled list
39828#: ../text-utils/more.1.adoc:65
39829#, no-wrap
39830msgid "*-l*, *--logical*"
39831msgstr ""
39832
39833#. type: Plain text
39834#: ../text-utils/more.1.adoc:67
39835msgid "Do not pause after any line containing a *^L* (form feed)."
39836msgstr ""
39837
39838#. type: Labeled list
39839#: ../text-utils/more.1.adoc:68
39840#, no-wrap
39841msgid "*-f*, *--no-pause*"
39842msgstr ""
39843
39844#. type: Plain text
39845#: ../text-utils/more.1.adoc:70
39846msgid ""
39847"Count logical lines, rather than screen lines (i.e., long lines are not "
39848"folded)."
39849msgstr ""
39850
39851#. type: Labeled list
39852#: ../text-utils/more.1.adoc:71
39853#, no-wrap
39854msgid "*-p*, *--print-over*"
39855msgstr ""
39856
39857#. type: Plain text
39858#: ../text-utils/more.1.adoc:73
39859msgid ""
39860"Do not scroll. Instead, clear the whole screen and then display the "
39861"text. Notice that this option is switched on automatically if the executable "
39862"is named *page*."
39863msgstr ""
39864
39865#. type: Labeled list
39866#: ../text-utils/more.1.adoc:74
39867#, no-wrap
39868msgid "*-c*, *--clean-print*"
39869msgstr ""
39870
39871#. type: Plain text
39872#: ../text-utils/more.1.adoc:76
39873msgid ""
39874"Do not scroll. Instead, paint each screen from the top, clearing the "
39875"remainder of each line as it is displayed."
39876msgstr ""
39877
39878#. type: Labeled list
39879#: ../text-utils/more.1.adoc:77
39880#, no-wrap
39881msgid "*-s*, *--squeeze*"
39882msgstr ""
39883
39884#. type: Plain text
39885#: ../text-utils/more.1.adoc:79
39886msgid "Squeeze multiple blank lines into one."
39887msgstr ""
39888
39889#. type: Labeled list
39890#: ../text-utils/more.1.adoc:80
39891#, no-wrap
39892msgid "*-u*, *--plain*"
39893msgstr ""
39894
39895#. type: Plain text
39896#: ../text-utils/more.1.adoc:82
39897msgid ""
39898"Suppress underlining. This option is silently ignored as backwards "
39899"compatibility."
39900msgstr ""
39901
39902#. type: Labeled list
39903#: ../text-utils/more.1.adoc:83
39904#, no-wrap
39905msgid "*-n*, *--lines* _number_"
39906msgstr ""
39907
39908#. type: Plain text
39909#: ../text-utils/more.1.adoc:85
39910msgid ""
39911"Specify the _number_ of lines per screenful. The _number_ argument is a "
39912"positive decimal integer. The *--lines* option shall override any values "
39913"obtained from any other source, such as number of lines reported by "
39914"terminal."
39915msgstr ""
39916
39917#. type: Labeled list
39918#: ../text-utils/more.1.adoc:86 ../text-utils/pg.1.adoc:36
39919#, no-wrap
39920msgid "**-**__number__"
39921msgstr ""
39922
39923#. type: Plain text
39924#: ../text-utils/more.1.adoc:88
39925msgid "A numeric option means the same as *--lines* option argument."
39926msgstr ""
39927
39928#. type: Labeled list
39929#: ../text-utils/more.1.adoc:89 ../text-utils/pg.1.adoc:30
39930#, no-wrap
39931msgid "**+**__number__"
39932msgstr ""
39933
39934#. type: Plain text
39935#: ../text-utils/more.1.adoc:91
39936msgid "Start displaying each file at line _number_."
39937msgstr ""
39938
39939#. type: Labeled list
39940#: ../text-utils/more.1.adoc:92
39941#, no-wrap
39942msgid "**+**/__string__"
39943msgstr ""
39944
39945#. type: Plain text
39946#: ../text-utils/more.1.adoc:94
39947msgid "The _string_ to be searched in each file before starting to display it."
39948msgstr ""
39949
39950#. type: Plain text
39951#: ../text-utils/more.1.adoc:104
39952msgid ""
39953"Interactive commands for *more* are based on *vi*(1). Some commands may be "
39954"preceded by a decimal number, called k in the descriptions below. In the "
39955"following descriptions, *^X* means *control-X*."
39956msgstr ""
39957
39958#. type: Labeled list
39959#: ../text-utils/more.1.adoc:105
39960#, no-wrap
39961msgid "*h* or *?*"
39962msgstr ""
39963
39964#. type: Plain text
39965#: ../text-utils/more.1.adoc:107
39966msgid ""
39967"Help; display a summary of these commands. If you forget all other commands, "
39968"remember this one."
39969msgstr ""
39970
39971#. type: Labeled list
39972#: ../text-utils/more.1.adoc:108
39973#, no-wrap
39974msgid "*SPACE*"
39975msgstr ""
39976
39977#. type: Plain text
39978#: ../text-utils/more.1.adoc:110
39979msgid "Display next k lines of text. Defaults to current screen size."
39980msgstr ""
39981
39982#. type: Labeled list
39983#: ../text-utils/more.1.adoc:111
39984#, no-wrap
39985msgid "*z*"
39986msgstr ""
39987
39988#. type: Plain text
39989#: ../text-utils/more.1.adoc:113
39990msgid ""
39991"Display next k lines of text. Defaults to current screen size. Argument "
39992"becomes new default."
39993msgstr ""
39994
39995#. type: Labeled list
39996#: ../text-utils/more.1.adoc:114
39997#, no-wrap
39998msgid "*RETURN*"
39999msgstr ""
40000
40001#. type: Plain text
40002#: ../text-utils/more.1.adoc:116
40003msgid "Display next k lines of text. Defaults to 1. Argument becomes new default."
40004msgstr ""
40005
40006#. type: Labeled list
40007#: ../text-utils/more.1.adoc:117
40008#, no-wrap
40009msgid "*d* or *^D*"
40010msgstr ""
40011
40012#. type: Plain text
40013#: ../text-utils/more.1.adoc:119
40014msgid ""
40015"Scroll k lines. Default is current scroll size, initially 11. Argument "
40016"becomes new default."
40017msgstr ""
40018
40019#. type: Labeled list
40020#: ../text-utils/more.1.adoc:120
40021#, no-wrap
40022msgid "*q* or *Q* or *INTERRUPT*"
40023msgstr ""
40024
40025#. type: Plain text
40026#: ../text-utils/more.1.adoc:122
40027msgid "Exit."
40028msgstr ""
40029
40030#. type: Plain text
40031#: ../text-utils/more.1.adoc:125
40032msgid "Skip forward k lines of text. Defaults to 1."
40033msgstr ""
40034
40035#. type: Labeled list
40036#: ../text-utils/more.1.adoc:126
40037#, no-wrap
40038msgid "*f*"
40039msgstr ""
40040
40041#. type: Plain text
40042#: ../text-utils/more.1.adoc:128
40043msgid "Skip forward k screenfuls of text. Defaults to 1."
40044msgstr ""
40045
40046#. type: Labeled list
40047#: ../text-utils/more.1.adoc:129
40048#, no-wrap
40049msgid "*b* or *^B*"
40050msgstr ""
40051
40052#. type: Plain text
40053#: ../text-utils/more.1.adoc:131
40054msgid ""
40055"Skip backwards k screenfuls of text. Defaults to 1. Only works with files, "
40056"not pipes."
40057msgstr ""
40058
40059#. type: Labeled list
40060#: ../text-utils/more.1.adoc:132
40061#, no-wrap
40062msgid "*'*"
40063msgstr ""
40064
40065#. type: Plain text
40066#: ../text-utils/more.1.adoc:134
40067msgid "Go to the place where the last search started."
40068msgstr ""
40069
40070#. type: Labeled list
40071#: ../text-utils/more.1.adoc:135
40072#, no-wrap
40073msgid "*=*"
40074msgstr ""
40075
40076#. type: Plain text
40077#: ../text-utils/more.1.adoc:137
40078msgid "Display current line number."
40079msgstr ""
40080
40081#. type: Labeled list
40082#: ../text-utils/more.1.adoc:138
40083#, no-wrap
40084msgid "*/pattern*"
40085msgstr ""
40086
40087#. type: Plain text
40088#: ../text-utils/more.1.adoc:140
40089msgid "Search for kth occurrence of regular expression. Defaults to 1."
40090msgstr ""
40091
40092#. type: Plain text
40093#: ../text-utils/more.1.adoc:143
40094msgid "Search for kth occurrence of last regular expression. Defaults to 1."
40095msgstr ""
40096
40097#. type: Labeled list
40098#: ../text-utils/more.1.adoc:144
40099#, no-wrap
40100msgid "*!command* or *:!command*"
40101msgstr ""
40102
40103#. type: Plain text
40104#: ../text-utils/more.1.adoc:146
40105msgid "Execute _command_ in a subshell."
40106msgstr ""
40107
40108#. type: Labeled list
40109#: ../text-utils/more.1.adoc:147
40110#, no-wrap
40111msgid "*v*"
40112msgstr ""
40113
40114#. type: Plain text
40115#: ../text-utils/more.1.adoc:149
40116msgid ""
40117"Start up an editor at current line. The editor is taken from the environment "
40118"variable *VISUAL* if defined, or *EDITOR* if *VISUAL* is not defined, or "
40119"defaults to *vi*(1) if neither *VISUAL* nor *EDITOR* is defined."
40120msgstr ""
40121
40122#. type: Labeled list
40123#: ../text-utils/more.1.adoc:150
40124#, no-wrap
40125msgid "*^L*"
40126msgstr ""
40127
40128#. type: Plain text
40129#: ../text-utils/more.1.adoc:152
40130msgid "Redraw screen."
40131msgstr ""
40132
40133#. type: Labeled list
40134#: ../text-utils/more.1.adoc:153
40135#, no-wrap
40136msgid "*:n*"
40137msgstr ""
40138
40139#. type: Plain text
40140#: ../text-utils/more.1.adoc:155
40141msgid "Go to kth next file. Defaults to 1."
40142msgstr ""
40143
40144#. type: Labeled list
40145#: ../text-utils/more.1.adoc:156
40146#, no-wrap
40147msgid "*:p*"
40148msgstr ""
40149
40150#. type: Plain text
40151#: ../text-utils/more.1.adoc:158
40152msgid "Go to kth previous file. Defaults to 1."
40153msgstr ""
40154
40155#. type: Labeled list
40156#: ../text-utils/more.1.adoc:159
40157#, no-wrap
40158msgid "*:f*"
40159msgstr ""
40160
40161#. type: Plain text
40162#: ../text-utils/more.1.adoc:161
40163msgid "Display current file name and line number."
40164msgstr ""
40165
40166#. type: Labeled list
40167#: ../text-utils/more.1.adoc:162
40168#, no-wrap
40169msgid "*.*"
40170msgstr ""
40171
40172#. type: Plain text
40173#: ../text-utils/more.1.adoc:164
40174msgid "Repeat previous command."
40175msgstr ""
40176
40177#. type: Plain text
40178#: ../text-utils/more.1.adoc:168
40179msgid ""
40180"The *more* command respects the following environment variables, if they "
40181"exist:"
40182msgstr ""
40183
40184#. type: Labeled list
40185#: ../text-utils/more.1.adoc:169
40186#, no-wrap
40187msgid "*MORE*"
40188msgstr ""
40189
40190#. type: Plain text
40191#: ../text-utils/more.1.adoc:171
40192msgid "This variable may be set with favored options to *more*."
40193msgstr ""
40194
40195#. type: Plain text
40196#: ../text-utils/more.1.adoc:174
40197msgid "Current shell in use (normally set by the shell at login time)."
40198msgstr ""
40199
40200#. type: Labeled list
40201#: ../text-utils/more.1.adoc:175 ../text-utils/pg.1.adoc:137
40202#: ../text-utils/ul.1.adoc:73
40203#, no-wrap
40204msgid "*TERM*"
40205msgstr ""
40206
40207#. type: Plain text
40208#: ../text-utils/more.1.adoc:177
40209msgid ""
40210"The terminal type used by *more* to get the terminal characteristics "
40211"necessary to manipulate the screen."
40212msgstr ""
40213
40214#. type: Labeled list
40215#: ../text-utils/more.1.adoc:178
40216#, no-wrap
40217msgid "*VISUAL*"
40218msgstr ""
40219
40220#. type: Plain text
40221#: ../text-utils/more.1.adoc:180
40222msgid "The editor the user prefers. Invoked when command key _v_ is pressed."
40223msgstr ""
40224
40225#. type: Plain text
40226#: ../text-utils/more.1.adoc:183
40227msgid "The editor of choice when *VISUAL* is not specified."
40228msgstr ""
40229
40230#. type: Plain text
40231#: ../text-utils/more.1.adoc:187
40232msgid ""
40233"The *more* command appeared in 3.0BSD. This man page documents *more* "
40234"version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux "
40235"community. Documentation was produced using several other versions of the "
40236"man page, and extensive inspection of the source code."
40237msgstr ""
40238
40239#. type: Plain text
40240#: ../text-utils/more.1.adoc:191
40241msgid "Eric Shienbrood, UC Berkeley."
40242msgstr ""
40243
40244#. type: Plain text
40245#: ../text-utils/more.1.adoc:193
40246msgid "Modified by Geoff Peck, UCB to add underlining, single spacing."
40247msgstr ""
40248
40249#. type: Plain text
40250#: ../text-utils/more.1.adoc:195
40251msgid "Modified by John Foderaro, UCB to add -c and MORE environment variable."
40252msgstr ""
40253
40254#. type: Plain text
40255#: ../text-utils/more.1.adoc:200
40256#, no-wrap
40257msgid ""
40258"*less*(1),\n"
40259"*vi*(1)\n"
40260msgstr ""
40261
40262#. Copyright 2001 Gunnar Ritter
40263#. type: Title =
40264#: ../text-utils/pg.1.adoc:3
40265#, no-wrap
40266msgid "pg(1)"
40267msgstr ""
40268
40269#. type: Plain text
40270#: ../text-utils/pg.1.adoc:13
40271msgid "pg - browse pagewise through text files"
40272msgstr ""
40273
40274#. type: Plain text
40275#: ../text-utils/pg.1.adoc:17
40276#, no-wrap
40277msgid "*pg* *-*_amount_ *-p* _prompt_ *-cefnrs* +line +/pattern/ file_ ...\n"
40278msgstr ""
40279
40280#. type: Plain text
40281#: ../text-utils/pg.1.adoc:21
40282#, no-wrap
40283msgid ""
40284"*pg* displays a text file on a CRT one screenful at once. After each page, a "
40285"prompt is displayed. The user may then either press the newline key to view "
40286"the next page or one of the keys described below.\n"
40287msgstr ""
40288
40289#. type: Plain text
40290#: ../text-utils/pg.1.adoc:23
40291msgid ""
40292"If no filename is given on the command line, *pg* reads from standard "
40293"input. If standard output is not a terminal, *pg* acts like *cat*(1) but "
40294"precedes each file with its name if there is more than one."
40295msgstr ""
40296
40297#. type: Plain text
40298#: ../text-utils/pg.1.adoc:25
40299msgid ""
40300"If input comes from a pipe, *pg* stores the data in a buffer file while "
40301"reading, to make navigation possible."
40302msgstr ""
40303
40304#. type: Plain text
40305#: ../text-utils/pg.1.adoc:29
40306#, no-wrap
40307msgid "*pg* accepts the following options:\n"
40308msgstr ""
40309
40310#. type: Plain text
40311#: ../text-utils/pg.1.adoc:32
40312msgid "Start at the given line number."
40313msgstr ""
40314
40315#. type: Labeled list
40316#: ../text-utils/pg.1.adoc:33
40317#, no-wrap
40318msgid "**+/**__pattern__*/*"
40319msgstr ""
40320
40321#. type: Plain text
40322#: ../text-utils/pg.1.adoc:35
40323msgid "Start at the line containing the Basic Regular Expression _pattern_ given."
40324msgstr ""
40325
40326#. type: Plain text
40327#: ../text-utils/pg.1.adoc:38
40328msgid ""
40329"The number of lines per page. By default, this is the number of CRT lines "
40330"minus one."
40331msgstr ""
40332
40333#. type: Plain text
40334#: ../text-utils/pg.1.adoc:41
40335msgid ""
40336"Clear the screen before a page is displayed, if the terminfo entry for the "
40337"terminal provides this capability."
40338msgstr ""
40339
40340#. type: Labeled list
40341#: ../text-utils/pg.1.adoc:42
40342#, no-wrap
40343msgid "*-e*"
40344msgstr ""
40345
40346#. type: Plain text
40347#: ../text-utils/pg.1.adoc:44
40348msgid "Do not pause and display _(EOF)_ at the end of a file."
40349msgstr ""
40350
40351#. type: Plain text
40352#: ../text-utils/pg.1.adoc:47
40353msgid "Do not split long lines."
40354msgstr ""
40355
40356#. type: Labeled list
40357#: ../text-utils/pg.1.adoc:48
40358#, no-wrap
40359msgid "*-n*"
40360msgstr ""
40361
40362#. type: Plain text
40363#: ../text-utils/pg.1.adoc:50
40364msgid "Without this option, commands must be terminated by a newline character."
40365msgstr ""
40366
40367#. type: Plain text
40368#: ../text-utils/pg.1.adoc:52
40369msgid "With this option, *pg* advances once a command letter is entered."
40370msgstr ""
40371
40372#. type: Labeled list
40373#: ../text-utils/pg.1.adoc:53
40374#, no-wrap
40375msgid "*-p* _string_"
40376msgstr ""
40377
40378#. type: Plain text
40379#: ../text-utils/pg.1.adoc:55
40380msgid ""
40381"Instead of the normal prompt _:_, _string_ is displayed. If _string_ "
40382"contains *%d*, its first occurrence is replaced by the number of the current "
40383"page."
40384msgstr ""
40385
40386#. type: Labeled list
40387#: ../text-utils/pg.1.adoc:56
40388#, no-wrap
40389msgid "*-r*"
40390msgstr ""
40391
40392#. type: Plain text
40393#: ../text-utils/pg.1.adoc:58
40394msgid "Disallow the shell escape."
40395msgstr ""
40396
40397#. type: Plain text
40398#: ../text-utils/pg.1.adoc:61
40399msgid ""
40400"Print messages in _standout_ mode, if the terminfo entry for the terminal "
40401"provides this capability."
40402msgstr ""
40403
40404#. type: Plain text
40405#: ../text-utils/pg.1.adoc:71
40406msgid ""
40407"The following commands may be entered at the prompt. Commands preceded by "
40408"_i_ in this document accept a number as argument, positive or negative. If "
40409"this argument starts with *+* or *-*, it is interpreted relative to the "
40410"current position in the input file, otherwise relative to the beginning."
40411msgstr ""
40412
40413#. type: Labeled list
40414#: ../text-utils/pg.1.adoc:72
40415#, no-wrap
40416msgid "__i__**<Enter>**"
40417msgstr ""
40418
40419#. type: Plain text
40420#: ../text-utils/pg.1.adoc:74
40421msgid "Display the next or the indicated page."
40422msgstr ""
40423
40424#. type: Labeled list
40425#: ../text-utils/pg.1.adoc:75
40426#, no-wrap
40427msgid "__i__**d** or *^D*"
40428msgstr ""
40429
40430#. type: Plain text
40431#: ../text-utils/pg.1.adoc:77
40432msgid ""
40433"Display the next halfpage. If _i_ is given, it is always interpreted "
40434"relative to the current position."
40435msgstr ""
40436
40437#. type: Labeled list
40438#: ../text-utils/pg.1.adoc:78
40439#, no-wrap
40440msgid "__i__**l**"
40441msgstr ""
40442
40443#. type: Plain text
40444#: ../text-utils/pg.1.adoc:80
40445msgid "Display the next or the indicated line."
40446msgstr ""
40447
40448#. type: Labeled list
40449#: ../text-utils/pg.1.adoc:81
40450#, no-wrap
40451msgid "__i__**f**"
40452msgstr ""
40453
40454#. type: Plain text
40455#: ../text-utils/pg.1.adoc:83
40456msgid ""
40457"Skip a page forward. _i_ must be a positive number and is always interpreted "
40458"relative to the current position."
40459msgstr ""
40460
40461#. type: Labeled list
40462#: ../text-utils/pg.1.adoc:84
40463#, no-wrap
40464msgid "__i__**w** or __i__**z**"
40465msgstr ""
40466
40467#. type: Plain text
40468#: ../text-utils/pg.1.adoc:86
40469msgid "As *<Enter>* except that _i_ becomes the new page size."
40470msgstr ""
40471
40472#. type: Labeled list
40473#: ../text-utils/pg.1.adoc:87
40474#, no-wrap
40475msgid "*.* or *^L*"
40476msgstr ""
40477
40478#. type: Plain text
40479#: ../text-utils/pg.1.adoc:89
40480msgid "Redraw the screen."
40481msgstr ""
40482
40483#. type: Labeled list
40484#: ../text-utils/pg.1.adoc:90
40485#, no-wrap
40486msgid "*$*"
40487msgstr ""
40488
40489#. type: Plain text
40490#: ../text-utils/pg.1.adoc:92
40491msgid "Advance to the last line of the input file."
40492msgstr ""
40493
40494#. type: Labeled list
40495#: ../text-utils/pg.1.adoc:93
40496#, no-wrap
40497msgid "__i__**/**__pattern__**/**"
40498msgstr ""
40499
40500#. type: Plain text
40501#: ../text-utils/pg.1.adoc:95
40502msgid ""
40503"Search forward until the first or the _i_-th occurrence of the Basic Regular "
40504"Expression _pattern_ is found. The search starts after the current page and "
40505"stops at the end of the file. No wrap-around is performed. _i_ must be a "
40506"positive number."
40507msgstr ""
40508
40509#. type: Labeled list
40510#: ../text-utils/pg.1.adoc:96
40511#, no-wrap
40512msgid "__i__**?**__pattern__**?** or __i__**^**__pattern__**^**"
40513msgstr ""
40514
40515#. type: Plain text
40516#: ../text-utils/pg.1.adoc:98
40517msgid ""
40518"Search backward until the first or the _i_-th occurrence of the Basic "
40519"Regular Expression _pattern_ is found. The search starts before the current "
40520"page and stops at the beginning of the file. No wrap-around is "
40521"performed. _i_ must be a positive number."
40522msgstr ""
40523
40524#. type: Plain text
40525#: ../text-utils/pg.1.adoc:100
40526msgid ""
40527"The search commands accept an added letter. If *t* is given, the line "
40528"containing the pattern is displayed at the top of the screen, which is the "
40529"default. *m* selects the middle and *b* the bottom of the screen. The "
40530"selected position is used in following searches, too."
40531msgstr ""
40532
40533#. type: Labeled list
40534#: ../text-utils/pg.1.adoc:101
40535#, no-wrap
40536msgid "__i__**n**"
40537msgstr ""
40538
40539#. type: Plain text
40540#: ../text-utils/pg.1.adoc:103
40541msgid "Advance to the next file or _i_ files forward."
40542msgstr ""
40543
40544#. type: Labeled list
40545#: ../text-utils/pg.1.adoc:104
40546#, no-wrap
40547msgid "__i__**p**"
40548msgstr ""
40549
40550#. type: Plain text
40551#: ../text-utils/pg.1.adoc:106
40552msgid "Reread the previous file or _i_ files backward."
40553msgstr ""
40554
40555#. type: Labeled list
40556#: ../text-utils/pg.1.adoc:107
40557#, no-wrap
40558msgid "*s* _filename_"
40559msgstr ""
40560
40561#. type: Plain text
40562#: ../text-utils/pg.1.adoc:109
40563msgid "Save the current file to the given _filename_."
40564msgstr ""
40565
40566#. type: Plain text
40567#: ../text-utils/pg.1.adoc:112
40568msgid "Display a command summary."
40569msgstr ""
40570
40571#. type: Labeled list
40572#: ../text-utils/pg.1.adoc:113
40573#, no-wrap
40574msgid "**!**__command__"
40575msgstr ""
40576
40577#. type: Plain text
40578#: ../text-utils/pg.1.adoc:115
40579msgid "Execute _command_ using the shell."
40580msgstr ""
40581
40582#. type: Labeled list
40583#: ../text-utils/pg.1.adoc:116
40584#, no-wrap
40585msgid "*q* or *Q*"
40586msgstr ""
40587
40588#. type: Plain text
40589#: ../text-utils/pg.1.adoc:118
40590msgid "Quit."
40591msgstr ""
40592
40593#. type: Plain text
40594#: ../text-utils/pg.1.adoc:120
40595msgid ""
40596"If the user presses the interrupt or quit key while *pg* reads from the "
40597"input file or writes on the terminal, *pg* will immediately display the "
40598"prompt. In all other situations these keys will terminate *pg*."
40599msgstr ""
40600
40601#. type: Plain text
40602#: ../text-utils/pg.1.adoc:124
40603msgid "The following environment variables affect the behavior of *pg*:"
40604msgstr ""
40605
40606#. type: Labeled list
40607#: ../text-utils/pg.1.adoc:125
40608#, no-wrap
40609msgid "*COLUMNS*"
40610msgstr ""
40611
40612#. type: Plain text
40613#: ../text-utils/pg.1.adoc:127
40614msgid "Overrides the system-supplied number of columns if set."
40615msgstr ""
40616
40617#. type: Labeled list
40618#: ../text-utils/pg.1.adoc:128
40619#, no-wrap
40620msgid "*LANG*, *LC_ALL*, *LC_COLLATE*, *LC_CTYPE*, *LC_MESSAGES*"
40621msgstr ""
40622
40623#. type: Plain text
40624#: ../text-utils/pg.1.adoc:130
40625msgid "See *locale*(7)."
40626msgstr ""
40627
40628#. type: Labeled list
40629#: ../text-utils/pg.1.adoc:131
40630#, no-wrap
40631msgid "*LINES*"
40632msgstr ""
40633
40634#. type: Plain text
40635#: ../text-utils/pg.1.adoc:133
40636msgid "Overrides the system-supplied number of lines if set."
40637msgstr ""
40638
40639#. type: Plain text
40640#: ../text-utils/pg.1.adoc:136
40641msgid "Used by the *!* command."
40642msgstr ""
40643
40644#. type: Plain text
40645#: ../text-utils/pg.1.adoc:139
40646msgid "Determines the terminal type."
40647msgstr ""
40648
40649#. type: Plain text
40650#: ../text-utils/pg.1.adoc:143
40651#, no-wrap
40652msgid "*pg* expects the terminal tabulators to be set every eight positions.\n"
40653msgstr ""
40654
40655#. type: Plain text
40656#: ../text-utils/pg.1.adoc:145
40657msgid "Files that include NUL characters cannot be displayed by *pg*."
40658msgstr ""
40659
40660#. type: Plain text
40661#: ../text-utils/pg.1.adoc:155
40662#, no-wrap
40663msgid ""
40664"*cat*(1),\n"
40665"*more*(1),\n"
40666"*sh*(1p),\n"
40667"*terminfo*(5),\n"
40668"*locale*(7),\n"
40669"*regex*(7),\n"
40670"*term*(7)\n"
40671msgstr ""
40672
40673#. Copyright (c) 1985, 1992 The Regents of the University of California.
40674#. All rights reserved.
40675#
40676#. Redistribution and use in source and binary forms, with or without
40677#. modification, are permitted provided that the following conditions
40678#. are met:
40679#. 1. Redistributions of source code must retain the above copyright
40680#. notice, this list of conditions and the following disclaimer.
40681#. 2. Redistributions in binary form must reproduce the above copyright
40682#. notice, this list of conditions and the following disclaimer in the
40683#. documentation and/or other materials provided with the distribution.
40684#. 3. All advertising materials mentioning features or use of this software
40685#. must display the following acknowledgement:
40686#. This product includes software developed by the University of
40687#. California, Berkeley and its contributors.
40688#. 4. Neither the name of the University nor the names of its contributors
40689#. may be used to endorse or promote products derived from this software
40690#. without specific prior written permission.
40691#
40692#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
40693#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40694#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
40695#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
40696#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
40697#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
40698#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40699#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
40700#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
40701#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40702#. SUCH DAMAGE.
40703#
40704#. @(#)rev.1 6.3 (Berkeley) 3/21/92
40705#. type: Title =
40706#: ../text-utils/rev.1.adoc:36
40707#, no-wrap
40708msgid "rev(1)"
40709msgstr ""
40710
40711#. type: Plain text
40712#: ../text-utils/rev.1.adoc:46
40713msgid "rev - reverse lines characterwise"
40714msgstr ""
40715
40716#. type: Plain text
40717#: ../text-utils/rev.1.adoc:50
40718#, no-wrap
40719msgid "*rev* [option] [_file_...]\n"
40720msgstr ""
40721
40722#. type: Plain text
40723#: ../text-utils/rev.1.adoc:54
40724msgid ""
40725"The *rev* utility copies the specified files to standard output, reversing "
40726"the order of characters in every line. If no files are specified, standard "
40727"input is read."
40728msgstr ""
40729
40730#. type: Plain text
40731#: ../text-utils/rev.1.adoc:56
40732msgid ""
40733"This utility is a line-oriented tool and it uses in-memory allocated buffer "
40734"for a whole wide-char line. If the input file is huge and without line "
40735"breaks than allocate the memory for the file may be unsuccessful."
40736msgstr ""
40737
40738#. type: Plain text
40739#: ../text-utils/rev.1.adoc:68
40740#, no-wrap
40741msgid "*tac*(1)\n"
40742msgstr ""
40743
40744#. Copyright (c) 1980, 1991, 1993
40745#. The Regents of the University of California. All rights reserved.
40746#
40747#. Redistribution and use in source and binary forms, with or without
40748#. modification, are permitted provided that the following conditions
40749#. are met:
40750#. 1. Redistributions of source code must retain the above copyright
40751#. notice, this list of conditions and the following disclaimer.
40752#. 2. Redistributions in binary form must reproduce the above copyright
40753#. notice, this list of conditions and the following disclaimer in the
40754#. documentation and/or other materials provided with the distribution.
40755#. 3. All advertising materials mentioning features or use of this software
40756#. must display the following acknowledgement:
40757#. This product includes software developed by the University of
40758#. California, Berkeley and its contributors.
40759#. 4. Neither the name of the University nor the names of its contributors
40760#. may be used to endorse or promote products derived from this software
40761#. without specific prior written permission.
40762#
40763#. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
40764#. ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40765#. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
40766#. ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
40767#. FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
40768#. DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
40769#. OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40770#. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
40771#. LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
40772#. OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40773#. SUCH DAMAGE.
40774#
40775#. @(#)ul.1 8.1 (Berkeley) 6/6/93
40776#. type: Title =
40777#: ../text-utils/ul.1.adoc:36
40778#, no-wrap
40779msgid "ul(1)"
40780msgstr ""
40781
40782#. type: Plain text
40783#: ../text-utils/ul.1.adoc:46
40784msgid "ul - do underlining"
40785msgstr ""
40786
40787#. type: Plain text
40788#: ../text-utils/ul.1.adoc:50
40789#, no-wrap
40790msgid "*ul* [options] [_file_...]\n"
40791msgstr ""
40792
40793#. type: Plain text
40794#: ../text-utils/ul.1.adoc:54
40795#, no-wrap
40796msgid ""
40797"*ul* reads the named files (or standard input if none are given) and "
40798"translates occurrences of underscores to the sequence which indicates "
40799"underlining for the terminal in use, as specified by the environment "
40800"variable *TERM*. The _terminfo_ database is read to determine the "
40801"appropriate sequences for underlining. If the terminal is incapable of "
40802"underlining but is capable of a standout mode, then that is used instead. If "
40803"the terminal can overstrike, or handles underlining automatically, *ul* "
40804"degenerates to *cat*(1). If the terminal cannot underline, underlining is "
40805"ignored.\n"
40806msgstr ""
40807
40808#. type: Labeled list
40809#: ../text-utils/ul.1.adoc:57
40810#, no-wrap
40811msgid "*-i*, *--indicated*"
40812msgstr ""
40813
40814#. type: Plain text
40815#: ../text-utils/ul.1.adoc:59
40816msgid ""
40817"Underlining is indicated by a separate line containing appropriate dashes "
40818"`-'; this is useful when you want to look at the underlining which is "
40819"present in an *nroff* output stream on a crt-terminal."
40820msgstr ""
40821
40822#. type: Labeled list
40823#: ../text-utils/ul.1.adoc:60
40824#, no-wrap
40825msgid "*-t*, *-T*, *--terminal* _terminal_"
40826msgstr ""
40827
40828#. type: Plain text
40829#: ../text-utils/ul.1.adoc:62
40830msgid "Override the environment variable *TERM* with the specified _terminal_ type."
40831msgstr ""
40832
40833#. type: Plain text
40834#: ../text-utils/ul.1.adoc:72
40835msgid "The following environment variable is used:"
40836msgstr ""
40837
40838#. type: Plain text
40839#: ../text-utils/ul.1.adoc:75
40840msgid ""
40841"The *TERM* variable is used to relate a tty device with its device "
40842"capability description (see *terminfo*(5)). *TERM* is set at login time, "
40843"either by the default terminal type specified in _/etc/ttys_ or as set "
40844"during the login process by the user in their _login_ file (see "
40845"*setenv*(3))."
40846msgstr ""
40847
40848#. type: Plain text
40849#: ../text-utils/ul.1.adoc:79
40850msgid "The *ul* command appeared in 3.0BSD."
40851msgstr ""
40852
40853#. type: Plain text
40854#: ../text-utils/ul.1.adoc:83
40855#, no-wrap
40856msgid ""
40857"*nroff* usually outputs a series of backspaces and underlines intermixed "
40858"with the text to indicate underlining. No attempt is made to optimize the "
40859"backward motion.\n"
40860msgstr ""
40861
40862#. type: Plain text
40863#: ../text-utils/ul.1.adoc:92
40864#, no-wrap
40865msgid ""
40866"*colcrt*(1), \n"
40867"*login*(1),\n"
40868"*man*(1),\n"
40869"*nroff*(1),\n"
40870"*setenv*(3),\n"
40871"*terminfo*(5)\n"
40872msgstr ""