source: BOOK/final-system/common/util-linux-ng.xml@ 37df206

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 37df206 was 42af63a, checked in by Chris Staub <chris@…>, 17 years ago

Added back command to move logger to /bin

  • Property mode set to 100644
File size: 22.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-util-linux-ng" role="wrap">
9 <?dbhtml filename="util-linux-ng.html"?>
10
11 <title>Util-linux-ng-&util-linux-ng-version;</title>
12
13 <indexterm zone="ch-system-util-linux-ng">
14 <primary sortas="a-Util-linux-ng">Util-linux-ng</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Util-linux-ng package contains miscellaneous utility programs.
21 Among them are utilities for handling file systems, consoles, partitions,
22 and messages.</para>
23
24
25 </sect2>
26
27 <sect2 id="fhs-util-linux-ng" role="installation">
28 <title>FHS compliance notes</title>
29
30 <para>The FHS recommends using the <filename
31 class="directory">/var/lib/hwclock</filename> directory instead of the
32 usual <filename class="directory">/etc</filename> directory as the
33 location for the <filename>adjtime</filename> file. To make the
34 <command>hwclock</command> program FHS-compliant, run the following:</para>
35
36<screen><userinput>sed -i 's@etc/adjtime@var/lib/hwclock/adjtime@g' \
37 hwclock/hwclock.c
38mkdir -pv /var/lib/hwclock</userinput></screen>
39
40 </sect2>
41
42 <sect2 role="installation">
43 <title>Installation of Util-linux-ng</title>
44
45 <para os="a">Prepare Util-linux-ng for compilation:</para>
46
47<screen os="b"><userinput>./configure --enable-partx --disable-wall --enable-write</userinput></screen>
48
49 <para os="c">Compile the package:</para>
50
51<screen os="d"><userinput>make</userinput></screen>
52
53 <para os="e">This package does not come with a test suite.</para>
54
55 <para os="g">Install the package:</para>
56
57<screen os="h"><userinput>make install</userinput></screen>
58
59 <para os="i">Move the <command>logger</command> binary to
60 <filename class="directory">/bin</filename> as it is needed by the
61 CLFS-Bootscripts package:</para>
62
63<screen os="j"><userinput>mv -v /usr/bin/logger /bin</userinput></screen>
64
65 </sect2>
66
67 <sect2 id="contents-util-linux-ng" role="content">
68 <title>Contents of Util-linux-ng</title>
69
70 <segmentedlist>
71 <segtitle>Installed programs</segtitle>
72
73 <seglistitem>
74 <seg>agetty, blockdev, cal, cfdisk, chkdupexe, col, colcrt,
75 colrm, column, ctrlaltdel, cytune, ddate, dmesg, fdformat,
76 fdisk, flock, fsck.cramfs, fsck.minix, getopt, hexdump, hwclock, ipcrm,
77 ipcs, isosize, line, logger, look, losetup, mcookie, mkfs, mkfs.bfs,
78 mkfs.cramfs, mkfs.minix, mkswap, more, mount, namei, pg, pivot_root,
79 readprofile, rename, renice, rev, script, setsid, setterm, sfdisk,
80 swapoff (link to swapon), swapon, tailf, tunelp, ul, umount, whereis, and write</seg>
81 </seglistitem>
82 </segmentedlist>
83
84 <variablelist>
85 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
86 <?dbfo list-presentation="list"?>
87 <?dbhtml list-presentation="table"?>
88
89 <varlistentry id="agetty">
90 <term><command>agetty</command></term>
91 <listitem>
92 <para>Opens a tty port, prompts for a login name,
93 and then invokes the <command>login</command> program</para>
94 <indexterm zone="ch-system-util-linux-ng agetty">
95 <primary sortas="b-agetty">agetty</primary>
96 </indexterm>
97 </listitem>
98 </varlistentry>
99
100 <varlistentry id="blockdev">
101 <term><command>blockdev</command></term>
102 <listitem>
103 <para>Allows users to call block device ioctls from the command
104 line</para>
105 <indexterm zone="ch-system-util-linux-ng blockdev">
106 <primary sortas="b-blockdev">blockdev</primary>
107 </indexterm>
108 </listitem>
109 </varlistentry>
110
111 <varlistentry id="cal">
112 <term><command>cal</command></term>
113 <listitem>
114 <para>Displays a simple calendar</para>
115 <indexterm zone="ch-system-util-linux-ng cal">
116 <primary sortas="b-cal">cal</primary>
117 </indexterm>
118 </listitem>
119 </varlistentry>
120
121 <varlistentry id="cfdisk">
122 <term><command>cfdisk</command></term>
123 <listitem>
124 <para>Manipulates the partition table of the given device</para>
125 <indexterm zone="ch-system-util-linux-ng cfdisk">
126 <primary sortas="b-cfdisk">cfdisk</primary>
127 </indexterm>
128 </listitem>
129 </varlistentry>
130
131 <varlistentry id="chkdupexe">
132 <term><command>chkdupexe</command></term>
133 <listitem>
134 <para>Finds duplicate executables</para>
135 <indexterm zone="ch-system-util-linux-ng chkdupexe">
136 <primary sortas="b-chkdupexe">chkdupexe</primary>
137 </indexterm>
138 </listitem>
139 </varlistentry>
140
141 <varlistentry id="col">
142 <term><command>col</command></term>
143 <listitem>
144 <para>Filters out reverse line feeds</para>
145 <indexterm zone="ch-system-util-linux-ng col">
146 <primary sortas="b-col">col</primary>
147 </indexterm>
148 </listitem>
149 </varlistentry>
150
151 <varlistentry id="colcrt">
152 <term><command>colcrt</command></term>
153 <listitem>
154 <para>Filters <command>nroff</command> output for terminals
155 that lack some capabilities, such as overstriking and half-lines</para>
156 <indexterm zone="ch-system-util-linux-ng colcrt">
157 <primary sortas="b-colcrt">colcrt</primary>
158 </indexterm>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry id="colrm">
163 <term><command>colrm</command></term>
164 <listitem>
165 <para>Filters out the given columns</para>
166 <indexterm zone="ch-system-util-linux-ng colrm">
167 <primary sortas="b-colrm">colrm</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="column">
173 <term><command>column</command></term>
174 <listitem>
175 <para>Formats a given file into multiple columns</para>
176 <indexterm zone="ch-system-util-linux-ng column">
177 <primary sortas="b-column">column</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="ctrlaltdel">
183 <term><command>ctrlaltdel</command></term>
184 <listitem>
185 <para>Sets the function of the Ctrl+Alt+Del key combination to a
186 hard or a soft reset</para>
187 <indexterm zone="ch-system-util-linux-ng ctrlaltdel">
188 <primary sortas="b-ctrlaltdel">ctrlaltdel</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="cytune">
194 <term><command>cytune</command></term>
195 <listitem>
196 <para>Tunes the parameters of the serial line drivers for
197 Cyclades cards</para>
198 <indexterm zone="ch-system-util-linux-ng cytune">
199 <primary sortas="b-cytune">cytune</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="ddate">
205 <term><command>ddate</command></term>
206 <listitem>
207 <para>Gives the Discordian date or converts the given Gregorian date
208 to a Discordian one</para>
209 <indexterm zone="ch-system-util-linux-ng ddate">
210 <primary sortas="b-ddate">ddate</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="dmesg">
216 <term><command>dmesg</command></term>
217 <listitem>
218 <para>Dumps the kernel boot messages</para>
219 <indexterm zone="ch-system-util-linux-ng dmesg">
220 <primary sortas="b-dmesg">dmesg</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="fdformat">
226 <term><command>fdformat</command></term>
227 <listitem>
228 <para>Low-level formats a floppy disk</para>
229 <indexterm zone="ch-system-util-linux-ng fdformat">
230 <primary sortas="b-fdformat">fdformat</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="fdisk">
236 <term><command>fdisk</command></term>
237 <listitem>
238 <para>Manipulates the partition table of the given device</para>
239 <indexterm zone="ch-system-util-linux-ng fdisk">
240 <primary sortas="b-fdisk">fdisk</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="flock">
246 <term><command>flock</command></term>
247 <listitem>
248 <para>Acquires a file lock and then executes a command with the lock
249 held</para>
250 <indexterm zone="ch-system-util-linux-ng flock">
251 <primary sortas="b-flock">flock</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="fsck.cramfs">
257 <term><command>fsck.cramfs</command></term>
258 <listitem>
259 <para>Performs a consistency check on the Cramfs file system on the
260 given device</para>
261 <indexterm zone="ch-system-util-linux-ng fsck.cramfs">
262 <primary sortas="b-fsck.cramfs">fsck.cramfs</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="fsck.minix">
268 <term><command>fsck.minix</command></term>
269 <listitem>
270 <para>Performs a consistency check on the Minix file system on the
271 given device</para>
272 <indexterm zone="ch-system-util-linux-ng fsck.minix">
273 <primary sortas="b-fsck.minix">fsck.minix</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="getopt">
279 <term><command>getopt</command></term>
280 <listitem>
281 <para>Parses options in the given command line</para>
282 <indexterm zone="ch-system-util-linux-ng getopt">
283 <primary sortas="b-getopt">getopt</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="hexdump">
289 <term><command>hexdump</command></term>
290 <listitem>
291 <para>Dumps the given file in hexadecimal or in another given
292 format</para>
293 <indexterm zone="ch-system-util-linux-ng hexdump">
294 <primary sortas="b-hexdump">hexdump</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="hwclock">
300 <term><command>hwclock</command></term>
301 <listitem>
302 <para>Reads or sets the system's hardware clock, also called
303 the Real-Time Clock (RTC) or Basic Input-Output System (BIOS)
304 clock</para>
305 <indexterm zone="ch-system-util-linux-ng hwclock">
306 <primary sortas="b-hwclock">hwclock</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="ipcrm">
312 <term><command>ipcrm</command></term>
313 <listitem>
314 <para>Removes the given Inter-Process Communication (IPC) resource</para>
315 <indexterm zone="ch-system-util-linux-ng ipcrm">
316 <primary sortas="b-ipcrm">ipcrm</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="ipcs">
322 <term><command>ipcs</command></term>
323 <listitem>
324 <para>Provides IPC status information</para>
325 <indexterm zone="ch-system-util-linux-ng ipcs">
326 <primary sortas="b-ipcs">ipcs</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="isosize">
332 <term><command>isosize</command></term>
333 <listitem>
334 <para>Reports the size of an iso9660 file system</para>
335 <indexterm zone="ch-system-util-linux-ng isosize">
336 <primary sortas="b-isosize">isosize</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="line">
342 <term><command>line</command></term>
343 <listitem>
344 <para>Copies a single line</para>
345 <indexterm zone="ch-system-util-linux-ng line">
346 <primary sortas="b-line">line</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="logger">
352 <term><command>logger</command></term>
353 <listitem>
354 <para>Enters the given message into the system log</para>
355 <indexterm zone="ch-system-util-linux-ng logger">
356 <primary sortas="b-logger">logger</primary>
357 </indexterm>
358 </listitem>
359 </varlistentry>
360
361 <varlistentry id="look">
362 <term><command>look</command></term>
363 <listitem>
364 <para>Displays lines that begin with the given string</para>
365 <indexterm zone="ch-system-util-linux-ng look">
366 <primary sortas="b-look">look</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="losetup">
372 <term><command>losetup</command></term>
373 <listitem>
374 <para>Sets up and controls loop devices</para>
375 <indexterm zone="ch-system-util-linux-ng losetup">
376 <primary sortas="b-losetup">losetup</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="mcookie">
382 <term><command>mcookie</command></term>
383 <listitem>
384 <para>Generates magic cookies (128-bit random hexadecimal numbers) for
385 <command>xauth</command></para>
386 <indexterm zone="ch-system-util-linux-ng mcookie">
387 <primary sortas="b-mcookie">mcookie</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="mkfs">
393 <term><command>mkfs</command></term>
394 <listitem>
395 <para>Builds a file system on a device (usually a hard disk
396 partition)</para>
397 <indexterm zone="ch-system-util-linux-ng mkfs">
398 <primary sortas="b-mkfs">mkfs</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="mkfs.bfs">
404 <term><command>mkfs.bfs</command></term>
405 <listitem>
406 <para>Creates a Santa Cruz Operations (SCO) bfs file system</para>
407 <indexterm zone="ch-system-util-linux-ng mkfs.bfs">
408 <primary sortas="b-mkfs.bfs">mkfs.bfs</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 <varlistentry id="mkfs.cramfs">
414 <term><command>mkfs.cramfs</command></term>
415 <listitem>
416 <para>Creates a cramfs file system</para>
417 <indexterm zone="ch-system-util-linux-ng mkfs.cramfs">
418 <primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="mkfs.minix">
424 <term><command>mkfs.minix</command></term>
425 <listitem>
426 <para>Creates a Minix file system</para>
427 <indexterm zone="ch-system-util-linux-ng mkfs.minix">
428 <primary sortas="b-mkfs.minix">mkfs.minix</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="mkswap">
434 <term><command>mkswap</command></term>
435 <listitem>
436 <para>Initializes the given device or file to be used as a swap
437 area</para>
438 <indexterm zone="ch-system-util-linux-ng mkswap">
439 <primary sortas="b-mkswap">mkswap</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443
444 <varlistentry id="more">
445 <term><command>more</command></term>
446 <listitem>
447 <para>A filter for paging through text one screen at a time</para>
448 <indexterm zone="ch-system-util-linux-ng more">
449 <primary sortas="b-more">more</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453
454 <varlistentry id="mount">
455 <term><command>mount</command></term>
456 <listitem>
457 <para>Attaches the file system on the given device to a specified
458 directory in the file-system tree</para>
459 <indexterm zone="ch-system-util-linux-ng mount">
460 <primary sortas="b-mount">mount</primary>
461 </indexterm>
462 </listitem>
463 </varlistentry>
464
465 <varlistentry id="namei">
466 <term><command>namei</command></term>
467 <listitem>
468 <para>Shows the symbolic links in the given pathnames</para>
469 <indexterm zone="ch-system-util-linux-ng namei">
470 <primary sortas="b-namei">namei</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474
475 <varlistentry id="pg">
476 <term><command>pg</command></term>
477 <listitem>
478 <para>Displays a text file one screen full at a time</para>
479 <indexterm zone="ch-system-util-linux-ng pg">
480 <primary sortas="b-pg">pg</primary>
481 </indexterm>
482 </listitem>
483 </varlistentry>
484
485 <varlistentry id="pivot_root">
486 <term><command>pivot_root</command></term>
487 <listitem>
488 <para>Makes the given file system the new root file system of the
489 current process</para>
490 <indexterm zone="ch-system-util-linux-ng pivot_root">
491 <primary sortas="b-pivot_root">pivot_root</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="readprofile">
497 <term><command>readprofile</command></term>
498 <listitem>
499 <para>Reads kernel profiling information</para>
500 <indexterm zone="ch-system-util-linux-ng readprofile">
501 <primary sortas="b-readprofile">readprofile</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505
506 <varlistentry id="rename">
507 <term><command>rename</command></term>
508 <listitem>
509 <para>Renames the given files, replacing a given string with
510 another</para>
511 <indexterm zone="ch-system-util-linux-ng rename">
512 <primary sortas="b-rename">rename</primary>
513 </indexterm>
514 </listitem>
515 </varlistentry>
516
517 <varlistentry id="renice">
518 <term><command>renice</command></term>
519 <listitem>
520 <para>Alters the priority of running processes</para>
521 <indexterm zone="ch-system-util-linux-ng renice">
522 <primary sortas="b-renice">renice</primary>
523 </indexterm>
524 </listitem>
525 </varlistentry>
526
527 <varlistentry id="rev">
528 <term><command>rev</command></term>
529 <listitem>
530 <para>Reverses the lines of a given file</para>
531 <indexterm zone="ch-system-util-linux-ng rev">
532 <primary sortas="b-rev">rev</primary>
533 </indexterm>
534 </listitem>
535 </varlistentry>
536
537 <varlistentry id="script">
538 <term><command>script</command></term>
539 <listitem>
540 <para>Makes a typescript of a terminal session</para>
541 <indexterm zone="ch-system-util-linux-ng script">
542 <primary sortas="b-script">script</primary>
543 </indexterm>
544 </listitem>
545 </varlistentry>
546
547 <varlistentry id="setsid">
548 <term><command>setsid</command></term>
549 <listitem>
550 <para>Runs the given program in a new session</para>
551 <indexterm zone="ch-system-util-linux-ng setsid">
552 <primary sortas="b-setsid">setsid</primary>
553 </indexterm>
554 </listitem>
555 </varlistentry>
556
557 <varlistentry id="setterm">
558 <term><command>setterm</command></term>
559 <listitem>
560 <para>Sets terminal attributes</para>
561 <indexterm zone="ch-system-util-linux-ng setterm">
562 <primary sortas="b-setterm">setterm</primary>
563 </indexterm>
564 </listitem>
565 </varlistentry>
566
567 <varlistentry id="sfdisk">
568 <term><command>sfdisk</command></term>
569 <listitem>
570 <para>A disk partition table manipulator</para>
571 <indexterm zone="ch-system-util-linux-ng sfdisk">
572 <primary sortas="b-sfdisk">sfdisk</primary>
573 </indexterm>
574 </listitem>
575 </varlistentry>
576
577 <varlistentry id="swapoff">
578 <term><command>swapoff</command></term>
579 <listitem>
580 <para>Disables devices and files for paging and swapping</para>
581 <indexterm zone="ch-system-util-linux-ng swapoff">
582 <primary sortas="b-swapoff">swapoff</primary>
583 </indexterm>
584 </listitem>
585 </varlistentry>
586
587 <varlistentry id="swapon">
588 <term><command>swapon</command></term>
589 <listitem>
590 <para>Enables devices and files for paging and swapping and
591 lists the devices and files currently in use</para>
592 <indexterm zone="ch-system-util-linux-ng swapon">
593 <primary sortas="b-swapon">swapon</primary>
594 </indexterm>
595 </listitem>
596 </varlistentry>
597
598 <varlistentry id="tailf">
599 <term><command>tailf</command></term>
600 <listitem>
601 <para>Tracks the growth of a log file. Displays the last 10 lines
602 of a log file, then continues displaying any new entries in the
603 log file as they are created</para>
604 <indexterm zone="ch-system-util-linux-ng tailf">
605 <primary sortas="b-tailf">tailf</primary>
606 </indexterm>
607 </listitem>
608 </varlistentry>
609
610 <varlistentry id="tunelp">
611 <term><command>tunelp</command></term>
612 <listitem>
613 <para>Tunes the parameters of the line printer</para>
614 <indexterm zone="ch-system-util-linux-ng tunelp">
615 <primary sortas="b-tunelp">tunelp</primary>
616 </indexterm>
617 </listitem>
618 </varlistentry>
619
620 <varlistentry id="ul">
621 <term><command>ul</command></term>
622 <listitem>
623 <para>A filter for translating underscores into escape sequences
624 indicating underlining for the terminal in use</para>
625 <indexterm zone="ch-system-util-linux-ng ul">
626 <primary sortas="b-ul">ul</primary>
627 </indexterm>
628 </listitem>
629 </varlistentry>
630
631 <varlistentry id="umount">
632 <term><command>umount</command></term>
633 <listitem>
634 <para>Disconnects a file system from the system's file tree</para>
635 <indexterm zone="ch-system-util-linux-ng umount">
636 <primary sortas="b-umount">umount</primary>
637 </indexterm>
638 </listitem>
639 </varlistentry>
640
641 <varlistentry id="whereis">
642 <term><command>whereis</command></term>
643 <listitem>
644 <para>Reports the location of the binary, source, and man page
645 for the given command</para>
646 <indexterm zone="ch-system-util-linux-ng whereis">
647 <primary sortas="b-whereis">whereis</primary>
648 </indexterm>
649 </listitem>
650 </varlistentry>
651
652 <varlistentry id="write">
653 <term><command>write</command></term>
654 <listitem>
655 <para>Sends a message to the given user <emphasis>if</emphasis> that
656 user has not disabled receipt of such messages</para>
657 <indexterm zone="ch-system-util-linux-ng write">
658 <primary sortas="b-write">write</primary>
659 </indexterm>
660 </listitem>
661 </varlistentry>
662
663 </variablelist>
664
665 </sect2>
666
667</sect1>
Note: See TracBrowser for help on using the repository browser.