aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEric Andersen <andersen@codepoet.org>2000-07-06 16:58:45 +0000
committerEric Andersen <andersen@codepoet.org>2000-07-06 16:58:45 +0000
commit6f5e281479193fb2cf76a18017f3df9d9f1b8941 (patch)
tree13c58801f35038fe40d6e363fbd1161c6d210d22 /docs
parentb2731b11ef49c9ebbc8aa12e8f9a88bb909cbd71 (diff)
downloadbusybox-w32-6f5e281479193fb2cf76a18017f3df9d9f1b8941.tar.gz
busybox-w32-6f5e281479193fb2cf76a18017f3df9d9f1b8941.tar.bz2
busybox-w32-6f5e281479193fb2cf76a18017f3df9d9f1b8941.zip
DocBook documentation update from Matt Kraai <kraai@alumni.carnegiemellon.edu>
-Erik
Diffstat (limited to 'docs')
-rw-r--r--docs/busybox.sgml956
1 files changed, 394 insertions, 562 deletions
diff --git a/docs/busybox.sgml b/docs/busybox.sgml
index 49b82c37d..01c407a17 100644
--- a/docs/busybox.sgml
+++ b/docs/busybox.sgml
@@ -57,7 +57,6 @@
57 </para> 57 </para>
58 </chapter> 58 </chapter>
59 59
60
61 <chapter id="Syntax"> 60 <chapter id="Syntax">
62 <title>How to use BusyBox</title> 61 <title>How to use BusyBox</title>
63 <sect1 id="How to use BusyBox"> 62 <sect1 id="How to use BusyBox">
@@ -76,7 +75,6 @@
76 </para> 75 </para>
77 </sect1> 76 </sect1>
78 77
79
80 <sect1 id="Invoking BusyBox"> 78 <sect1 id="Invoking BusyBox">
81 <para> 79 <para>
82 When you create a link to BusyBox for the function you wish to use, when 80 When you create a link to BusyBox for the function you wish to use, when
@@ -147,12 +145,11 @@
147 </para> 145 </para>
148 </sect1> 146 </sect1>
149 147
150
151 <sect1 id="ar"> 148 <sect1 id="ar">
152 <title>ar</title> 149 <title>ar</title>
153 150
154 <para> 151 <para>
155 Usage: ar [optxvV] archive [filenames] 152 Usage: ar [OPTION] archive [FILENAME]...
156 </para> 153 </para>
157 154
158 <para> 155 <para>
@@ -165,18 +162,15 @@
165 162
166 <para> 163 <para>
167 <screen> 164 <screen>
168 o preserve original dates 165 o Preserve original dates
169 p extract to stdout 166 p Extract to stdout
170 t list 167 t List
171 x extract 168 x Extract
172 v verbosely list files processed 169 v Verbosely list files processed
173 </screen> 170 </screen>
174 </para> 171 </para>
175 </sect1> 172 </sect1>
176 173
177
178
179
180 <sect1 id="basename"> 174 <sect1 id="basename">
181 <title>basename</title> 175 <title>basename</title>
182 <para> 176 <para>
@@ -184,7 +178,7 @@
184 </para> 178 </para>
185 179
186 <para> 180 <para>
187 Strips directory path and suffixes from FILE. If specified, also removes 181 Strip directory path and suffixes from FILE. If specified, also removes
188 any trailing SUFFIX. 182 any trailing SUFFIX.
189 </para> 183 </para>
190 184
@@ -204,16 +198,15 @@
204 </para> 198 </para>
205 </sect1> 199 </sect1>
206 200
207
208 <sect1 id="cat"> 201 <sect1 id="cat">
209 <title>cat</title> 202 <title>cat</title>
210 203
211 <para> 204 <para>
212 Usage: cat [FILE ...] 205 Usage: cat [FILE]...
213 </para> 206 </para>
214 207
215 <para> 208 <para>
216 Concatenates <literal>FILE(s)</literal> and prints them to the standard 209 Concatenate <literal>FILE(s)</literal> and prints them to the standard
217 output. 210 output.
218 </para> 211 </para>
219 212
@@ -227,157 +220,150 @@
227 110716.72 17.67 220 110716.72 17.67
228 </screen> 221 </screen>
229 </para> 222 </para>
230
231 </sect1> 223 </sect1>
232 224
233
234
235 <sect1 id="chgrp"> 225 <sect1 id="chgrp">
236 <title>chgrp</title> 226 <title>chgrp</title>
237 227
238 <para> 228 <para>
239 Usage: chgrp [OPTION]... GROUP FILE... 229 Usage: chgrp [OPTION]... GROUP FILE...
240 </para> 230 </para>
241 231
242 <para> 232 <para>
243 Change the group membership of each FILE to GROUP. 233 Change the group membership of each FILE to GROUP.
244 </para> 234 </para>
245 235
246 <para> 236 <para>
247 Options: 237 Options:
248 </para> 238 </para>
249 239
250 <para> 240 <para>
251 <screen> 241 <screen>
252 -R change files and directories recursively 242 -R Change files and directories recursively
253 </screen> 243 </screen>
254 </para> 244 </para>
255 245
256 <para> 246 <para>
257 Example: 247 Example:
258 </para> 248 </para>
259 249
260 <para> 250 <para>
261 <screen> 251 <screen>
262 $ ls -l /tmp/foo 252 $ ls -l /tmp/foo
263 -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo 253 -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo
264 $ chgrp root /tmp/foo 254 $ chgrp root /tmp/foo
265 $ ls -l /tmp/foo 255 $ ls -l /tmp/foo
266 -r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo 256 -r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo
267 </screen> 257 </screen>
268 </para> 258 </para>
269 </sect1> 259 </sect1>
270 260
271
272
273 <sect1 id="chmod"> 261 <sect1 id="chmod">
274 <title>chmod</title> 262 <title>chmod</title>
275 263
276 <para> 264 <para>
277 Usage: chmod [<emphasis>-R</emphasis>] MODE[,MODE]... FILE... 265 Usage: chmod [<emphasis>-R</emphasis>] MODE[,MODE]... FILE...
278 </para> 266 </para>
279 267
280 <para> 268 <para>
281 Changes file access permissions for the specified 269 Change file access permissions for the specified
282 <literal>FILE(s)</literal> (or directories). Each MODE is defined by 270 <literal>FILE(s)</literal> (or directories). Each MODE is defined by
283 combining the letters for WHO has access to the file, an OPERATOR for 271 combining the letters for WHO has access to the file, an OPERATOR for
284 selecting how the permissions should be changed, and a PERMISSION for 272 selecting how the permissions should be changed, and a PERMISSION for
285 <literal>FILE(s)</literal> (or directories). 273 <literal>FILE(s)</literal> (or directories).
286 </para> 274 </para>
287 275
288 <para> 276 <para>
289 WHO may be chosen from 277 WHO may be chosen from
290 </para> 278 </para>
291 279
292 <para> 280 <para>
293 <screen> 281 <screen>
294 u User who owns the file 282 u User who owns the file
295 g Users in the file's Group 283 g Users in the file's Group
296 o Other users not in the file's group 284 o Other users not in the file's group
297 a All users 285 a All users
298 </screen> 286 </screen>
299 </para> 287 </para>
300 288
301 <para> 289 <para>
302 OPERATOR may be chosen from 290 OPERATOR may be chosen from
303 </para> 291 </para>
304 292
305 <para> 293 <para>
306 <screen> 294 <screen>
307 + Add a permission 295 + Add a permission
308 - Remove a permission 296 - Remove a permission
309 = Assign a permission 297 = Assign a permission
310 </screen> 298 </screen>
311 </para> 299 </para>
312 300
313 <para> 301 <para>
314 PERMISSION may be chosen from 302 PERMISSION may be chosen from
315 </para> 303 </para>
316 304
317 <para> 305 <para>
318 <screen> 306 <screen>
319 r Read 307 r Read
320 w Write 308 w Write
321 x Execute (or access for directories) 309 x Execute (or access for directories)
322 s Set user (or group) ID bit 310 s Set user (or group) ID bit
323 t Sticky bit (for directories prevents removing files by non-owners) 311 t Sticky bit (for directories prevents removing files by non-owners)
324 </screen> 312 </screen>
325 </para> 313 </para>
326 314
327 <para> 315 <para>
328 Alternately, permissions can be set numerically where the first three 316 Alternately, permissions can be set numerically where the first three
329 numbers are calculated by adding the octal values, such as 317 numbers are calculated by adding the octal values, such as
330 </para> 318 </para>
331 319
332 <para> 320 <para>
333 <screen> 321 <screen>
334 4 Read 322 4 Read
335 2 Write 323 2 Write
336 1 Execute 324 1 Execute
337 </screen> 325 </screen>
338 </para> 326 </para>
339 327
340 <para> 328 <para>
341 An optional fourth digit can also be used to specify 329 An optional fourth digit can also be used to specify
342 </para> 330 </para>
343 331
344 <para> 332 <para>
345 <screen> 333 <screen>
346 4 Set user ID 334 4 Set user ID
347 2 Set group ID 335 2 Set group ID
348 1 Sticky bit 336 1 Sticky bit
349 </screen> 337 </screen>
350 </para> 338 </para>
351 339
352 <para> 340 <para>
353 Options: 341 Options:
354 </para> 342 </para>
355 343
356 <para> 344 <para>
357 <screen> 345 <screen>
358 -R Change files and directories recursively. 346 -R Change files and directories recursively.
359 </screen> 347 </screen>
360 </para> 348 </para>
361 349
362 <para> 350 <para>
363 Example: 351 Example:
364 </para> 352 </para>
365 353
366 <para> 354 <para>
367 <screen> 355 <screen>
368 $ ls -l /tmp/foo 356 $ ls -l /tmp/foo
369 -rw-rw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo 357 -rw-rw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo
370 $ chmod u+x /tmp/foo 358 $ chmod u+x /tmp/foo
371 $ ls -l /tmp/foo 359 $ ls -l /tmp/foo
372 -rwxrw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo* 360 -rwxrw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo*
373 $ chmod 444 /tmp/foo 361 $ chmod 444 /tmp/foo
374 $ ls -l /tmp/foo 362 $ ls -l /tmp/foo
375 -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo 363 -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo
376 </screen> 364 </screen>
377 </para> 365 </para>
378 </sect1> 366 </sect1>
379
380
381 367
382 <sect1 id="chown"> 368 <sect1 id="chown">
383 <title>chown</title> 369 <title>chown</title>
@@ -386,7 +372,7 @@
386 </para> 372 </para>
387 373
388 <para> 374 <para>
389 Changes the owner and/or group of each FILE to OWNER and/or GROUP. 375 Change the owner and/or group of each FILE to OWNER and/or GROUP.
390 </para> 376 </para>
391 377
392 <para> 378 <para>
@@ -395,7 +381,7 @@
395 381
396 <para> 382 <para>
397 <screen> 383 <screen>
398 -R Changes files and directories recursively 384 -R Change files and directories recursively
399 </screen> 385 </screen>
400 </para> 386 </para>
401 387
@@ -417,8 +403,6 @@
417 </para> 403 </para>
418 </sect1> 404 </sect1>
419 405
420
421
422 <sect1 id="chroot"> 406 <sect1 id="chroot">
423 <title>chroot</title> 407 <title>chroot</title>
424 <para> 408 <para>
@@ -445,7 +429,6 @@
445 </para> 429 </para>
446 </sect1> 430 </sect1>
447 431
448
449 <sect1 id="chvt"> 432 <sect1 id="chvt">
450 <title>chvt</title> 433 <title>chvt</title>
451 <para> 434 <para>
@@ -453,13 +436,10 @@
453 </para> 436 </para>
454 437
455 <para> 438 <para>
456 Changes the foreground virtual terminal to /dev/ttyN 439 Change the foreground virtual terminal to /dev/ttyN
457 </para> 440 </para>
458 </sect1> 441 </sect1>
459 442
460
461
462
463 <sect1 id="clear"> 443 <sect1 id="clear">
464 <title>clear</title> 444 <title>clear</title>
465 445
@@ -468,11 +448,10 @@
468 </para> 448 </para>
469 449
470 <para> 450 <para>
471 Clears the screen. 451 Clear the screen.
472 </para> 452 </para>
473 </sect1> 453 </sect1>
474 454
475
476 <sect1 id="cp"> 455 <sect1 id="cp">
477 <title>cp</title> 456 <title>cp</title>
478 457
@@ -487,7 +466,7 @@
487 </para> 466 </para>
488 467
489 <para> 468 <para>
490 Copies SOURCE to DEST, or multiple <literal>SOURCE(s)</literal> to 469 Copy SOURCE to DEST, or multiple <literal>SOURCE(s)</literal> to
491 DIRECTORY. 470 DIRECTORY.
492 </para> 471 </para>
493 472
@@ -498,14 +477,13 @@
498 <para> 477 <para>
499 <screen> 478 <screen>
500 -a Same as -dpR 479 -a Same as -dpR
501 -d Preserves links 480 -d Preserve links
502 -p Preserves file attributes if possible 481 -p Preserve file attributes if possible
503 -R Copies directories recursively 482 -R Copy directories recursively
504 </screen> 483 </screen>
505 </para> 484 </para>
506 </sect1> 485 </sect1>
507 486
508
509 <sect1 id="cut"> 487 <sect1 id="cut">
510 <title>cut</title> 488 <title>cut</title>
511 489
@@ -514,7 +492,7 @@
514 </para> 492 </para>
515 493
516 <para> 494 <para>
517 Prints selected fields from each input FILE to standard output. 495 Print selected fields from each input FILE to standard output.
518 </para> 496 </para>
519 497
520 <para> 498 <para>
@@ -546,8 +524,6 @@
546 </para> 524 </para>
547 </sect1> 525 </sect1>
548 526
549
550
551 <sect1 id="date"> 527 <sect1 id="date">
552 <title>date</title> 528 <title>date</title>
553 529
@@ -562,7 +538,7 @@
562 </para> 538 </para>
563 539
564 <para> 540 <para>
565 Displays the current time in the given FORMAT, or sets the system date. 541 Display the current time in the given FORMAT, or set the system date.
566 </para> 542 </para>
567 543
568 <para> 544 <para>
@@ -571,9 +547,9 @@
571 547
572 <para> 548 <para>
573 <screen> 549 <screen>
574 -R Outputs RFC-822 compliant date string 550 -R Output RFC-822 compliant date string
575 -s Sets time described by STRING 551 -s Set time described by STRING
576 -u Prints or sets Coordinated Universal Time 552 -u Print or set Coordinated Universal Time
577 </screen> 553 </screen>
578 </para> 554 </para>
579 555
@@ -589,464 +565,320 @@
589 </para> 565 </para>
590 </sect1> 566 </sect1>
591 567
568 <sect1 id="dc">
569 <title>dc</title>
592 570
571 <para>
572 Usage: dc [EXPRESSION]
573 </para>
593 574
594<!-- This is where I have stopped formatting stuff --> 575 <para>
595 576 This is a Tiny RPN calculator that understands the
596 577 following operations: +, -, /, *, and, or, not, eor. If
597</listitem></varlistentry> 578 no arguments are given, dc will process input from
598<varlistentry><term><emphasis>dc 579 stdin.
599 580 </para>
600</emphasis></term>
601<listitem><para></para>
602
603<para>
604Usage: dc expression ...
605
606
607</para>
608
609<para>
610This is a Tiny RPN calculator that understands the following operations: +,
611-, /, *, and, or, not, eor. If no arguments are given, dc will process
612input from STDIN.
613
614
615</para>
616
617<para>
618The behaviour of BusyBox/dc deviates (just a little ;-) from GNU/dc, but
619this will be remedied in the future.
620
621
622</para>
623
624<para>
625Example:
626
627
628</para>
629
630<para>
631<screen>
632 $ dc 2 2 +
633 4
634 $ dc 8 8 \* 2 2 + /
635 16
636 $ dc 0 1 and
637 0
638 $ dc 0 1 or
639 1
640 $ echo 72 9 div 8 mul | dc
641 64
642</screen>
643
644
645</para>
646
647<para>
648-------------------------------
649
650
651</para>
652
653</listitem></varlistentry>
654<varlistentry><term><emphasis>dd
655
656</emphasis></term>
657<listitem><para></para>
658
659<para>
660Usage: dd [if=name] [of=name] [bs=n] [count=n] [skip=n] [seek=n]
661
662
663</para>
664
665<para>
666Copy a file, converting and formatting according to options
667
668
669</para>
670
671<para>
672<screen>
673 if=FILE read from FILE instead of stdin
674 of=FILE write to FILE instead of stdout
675 bs=n read and write n bytes at a time
676 count=n copy only n input blocks
677 skip=n skip n input blocks
678 seek=n skip n output blocks
679</screen>
680
681
682</para>
683
684<para>
685Numbers may be suffixed by w (x2), k (x1024), b (x512), or M (x1024^2)
686
687
688</para>
689
690<para>
691Example:
692
693
694</para>
695
696<para>
697<screen>
698 $ dd if=/dev/zero of=/dev/ram1 bs=1M count=4
699 4+0 records in
700 4+0 records out
701</screen>
702
703
704</para>
705
706<para>
707-------------------------------
708
709</para>
710
711</listitem></varlistentry>
712<varlistentry><term><emphasis>deallocvt
713
714</emphasis></term>
715<listitem><para></para>
716
717<para>
718Usage: deallocvt N
719
720
721</para>
722
723<para>
724Deallocates unused virtual terminal /dev/ttyN
725
726
727</para>
728
729<para>
730-------------------------------
731
732
733
734</para>
735
736</listitem></varlistentry>
737<varlistentry><term><emphasis>df
738
739</emphasis></term>
740<listitem><para></para>
741
742<para>
743Usage: df [filesystem ...]
744
745
746</para>
747
748<para>
749Prints the filesystem space used and space available.
750
751
752</para>
753
754<para>
755Example:
756
757
758</para>
759
760<para>
761<screen>
762 $ df
763 Filesystem 1k-blocks Used Available Use% Mounted on
764 /dev/sda3 8690864 8553540 137324 98% /
765 /dev/sda1 64216 36364 27852 57% /boot
766 $ df /dev/sda3
767 Filesystem 1k-blocks Used Available Use% Mounted on
768 /dev/sda3 8690864 8553540 137324 98% /
769</screen>
770
771
772</para>
773
774<para>
775-------------------------------
776
777
778</para>
779
780</listitem></varlistentry>
781<varlistentry><term><emphasis>dirname
782
783</emphasis></term>
784<listitem><para></para>
785
786<para>
787Usage: dirname NAME
788
789
790</para>
791
792<para>
793Strip non-directory suffix from file name
794
795
796</para>
797
798<para>
799Example:
800
801
802</para>
803
804<para>
805<screen>
806 $ dirname /tmp/foo
807 /tmp
808 $ dirname /tmp/foo/
809 /tmp
810</screen>
811
812
813</para>
814
815<para>
816-------------------------------
817
818
819</para>
820
821</listitem></varlistentry>
822<varlistentry><term><emphasis>dmesg
823
824</emphasis></term>
825<listitem><para></para>
826
827<para>
828Usage: dmesg [<emphasis>-c</emphasis>] [<emphasis>-n</emphasis> level] [<emphasis>-s</emphasis> bufsize]
829
830
831</para>
832
833<para>
834Print or controls the kernel ring buffer.
835
836
837</para>
838
839<para>
840-------------------------------
841
842
843</para>
844
845</listitem></varlistentry>
846<varlistentry><term><emphasis>du
847
848</emphasis></term>
849<listitem><para></para>
850
851<para>
852Usage: du [OPTION]... [FILE]...
853
854
855</para>
856
857<para>
858Summarize disk space used for each FILE and/or directory. Disk space is
859printed in units of 1k (i.e. 1024 bytes).
860
861
862</para>
863
864<para>
865Options:
866
867
868</para>
869
870<para>
871<screen>
872 -l count sizes many times if hard linked
873 -s display only a total for each argument
874</screen>
875
876
877</para>
878
879<para>
880Example:
881
882
883</para>
884
885<para>
886<screen>
887 $ ./BusyBox du
888 16 ./CVS
889 12 ./kernel-patches/CVS
890 80 ./kernel-patches
891 12 ./tests/CVS
892 36 ./tests
893 12 ./scripts/CVS
894 16 ./scripts
895 12 ./docs/CVS
896 104 ./docs
897 2417 .
898</screen>
899
900
901</para>
902
903<para>
904-------------------------------
905
906
907</para>
908
909</listitem></varlistentry>
910<varlistentry><term><emphasis>dutmp
911 581
912</emphasis></term> 582 <para>
913<listitem><para></para> 583 The behaviour of BusyBox/dc deviates (just a little ;-)
584 from GNU/dc, but this will be remedied in the future.
585 </para>
914 586
915<para> 587 <para>
916Usage: dutmp [FILE] 588 Example:
589 </para>
917 590
591 <para>
592 <screen>
593 $ dc 2 2 +
594 4
595 $ dc 8 8 \* 2 2 + /
596 16
597 $ dc 0 1 and
598 0
599 $ dc 0 1 or
600 1
601 $ echo 72 9 div 8 mul | dc
602 64
603 </screen>
604 </para>
605 </sect1>
918 606
919</para> 607 <sect1 id="dd">
608 <title>dd</title>
920 609
921<para> 610 <para>
922Dump utmp file format (pipe delimited) from FILE or stdin to stdout. 611 Usage: dd [OPTION]...
612 </para>
923 613
614 <para>
615 Copy a file, converting and formatting according to
616 options.
617 </para>
924 618
925</para> 619 <para>
620 Options:
621 </para>
926 622
927<para> 623 <para>
928Example: 624 <screen>
625 if=FILE Read from FILE instead of stdin
626 of=FILE Write to FILE instead of stdout
627 bs=N Read and write N bytes at a time
628 count=N Copy only N input blocks
629 skip=N Skip N input blocks
630 seek=N Skip N output blocks
631 </screen>
632 </para>
929 633
634 <para>
635 Numbers may be suffixed by w (x2), k (x1024), b (x512),
636 or M (x1024^2).
637 </para>
930 638
931</para> 639 <para>
640 Example:
641 </para>
932 642
933<para> 643 <para>
934<screen> 644 <screen>
935 $ dutmp /var/run/utmp 645 $ dd if=/dev/zero of=/dev/ram1 bs=1M count=4
936 8|7||si|||0|0|0|955637625|760097|0 646 4+0 records in
937 2|0|~|~~|reboot||0|0|0|955637625|782235|0 647 4+0 records out
938 1|20020|~|~~|runlevel||0|0|0|955637625|800089|0 648 </screen>
939 8|125||l4|||0|0|0|955637629|998367|0 649 </para>
940 6|245|tty1|1|LOGIN||0|0|0|955637630|998974|0 650 </sect1>
941 6|246|tty2|2|LOGIN||0|0|0|955637630|999498|0
942 7|336|pts/0|vt00andersen|andersen|:0.0|0|0|0|955637763|0|0
943</screen>
944 651
652 <sect1 id="deallocvt">
653 <title>deallocvt</title>
945 654
946</para> 655 <para>
947 656 Usage: deallocvt N
948<para> 657 </para>
949-------------------------------
950 658
659 <para>
660 Deallocate unused virtual terminal /dev/ttyN.
661 </para>
662 </sect1>
951 663
952</para> 664 <sect1 id="df">
665 <title>df</title>
953 666
954</listitem></varlistentry> 667 <para>
955<varlistentry><term><emphasis>echo 668 Usage: df [FILE]...
669 </para>
956 670
957</emphasis></term> 671 <para>
958<listitem><para></para> 672 Print the filesystem space used and space available.
673 </para>
959 674
960<para> 675 <para>
961Usage: echo [-neE] [ARG ...] 676 Example:
677 </para>
962 678
679 <para>
680 <screen>
681 $ df
682 Filesystem 1k-blocks Used Available Use% Mounted on
683 /dev/sda3 8690864 8553540 137324 98% /
684 /dev/sda1 64216 36364 27852 57% /boot
685 $ df /dev/sda3
686 Filesystem 1k-blocks Used Available Use% Mounted on
687 /dev/sda3 8690864 8553540 137324 98% /
688 </screen>
689 </para>
690 </sect1>
691
692 <sect1 id="dirname">
693 <title>dirname</title>
963 694
964</para> 695 <para>
696 Usage: dirname NAME
697 </para>
965 698
966<para> 699 <para>
967Prints the specified ARGs to stdout 700 Strip non-directory suffix from NAME.
701 </para>
968 702
703 <para>
704 Example:
705 </para>
969 706
970</para> 707 <para>
708 <screen>
709 $ dirname /tmp/foo
710 /tmp
711 $ dirname /tmp/foo/
712 /tmp
713 </screen>
714 </para>
715 </sect1>
971 716
972<para> 717 <sect1 id="dmesg">
973Options: 718 <title>dmesg</title>
974 719
720 <para>
721 Usage: dmesg [OPTION]...
722 </para>
975 723
976</para> 724 <para>
725 Print or control the kernel ring buffer.
726 </para>
977 727
978<para> 728 <para>
979<screen> 729 Options:
980 -n suppress trailing newline 730 </para>
981 -e interpret backslash-escaped characters (i.e. \t=tab etc)
982 -E disable interpretation of backslash-escaped characters
983</screen>
984 731
732 <para>
733 <screen>
734 -c Clear the ring buffer after printing
735 -n LEVEL Set the console logging level to LEVEL
736 -s BUFSIZE Query ring buffer using a buffer of BUFSIZE
737 </screen>
738 </para>
739 </sect1>
985 740
986</para> 741 <sect1 id="du">
742 <title>du</title>
987 743
988<para> 744 <para>
989Example: 745 Usage: du [OPTION]... [FILE]...
746 </para>
990 747
748 <para>
749 Summarize the disk space used for each FILE or current
750 directory. Disk space printed in units of 1k (i.e.
751 1024 bytes).
752 </para>
991 753
992</para> 754 <para>
755 Options:
756 </para>
993 757
994<para> 758 <para>
995<screen> 759 <screen>
996 $ echo "Erik is cool" 760 -l Count sizes many times if hard linked
997 Erik is cool 761 -s Display only a total for each argument
998 $ echo -e "Erik\nis\ncool" 762 </screen>
999 Erik 763 </para>
1000 is
1001 cool
1002 $ echo "Erik\nis\ncool"
1003 Erik\nis\ncool
1004</screen>
1005 764
765 <para>
766 Example:
767 </para>
1006 768
1007</para> 769 <para>
770 <screen>
771 $ du
772 16 ./CVS
773 12 ./kernel-patches/CVS
774 80 ./kernel-patches
775 12 ./tests/CVS
776 36 ./tests
777 12 ./scripts/CVS
778 16 ./scripts
779 12 ./docs/CVS
780 104 ./docs
781 2417 .
782 </screen>
783 </para>
784 </sect1>
1008 785
1009<para> 786 <sect1 id="dutmp">
1010------------------------------- 787 <title>dutmp</title>
1011 788
789 <para>
790 Usage: dutmp [FILE]
791 </para>
1012 792
1013</para> 793 <para>
794 Dump utmp file format (pipe delimited) from FILE or
795 stdin to stdout.
796 </para>
1014 797
1015</listitem></varlistentry> 798 <para>
1016<varlistentry><term><emphasis>false 799 Example:
800 </para>
1017 801
1018</emphasis></term> 802 <para>
1019<listitem><para></para> 803 <screen>
804 $ dutmp /var/run/utmp
805 8|7||si|||0|0|0|955637625|760097|0
806 2|0|~|~~|reboot||0|0|0|955637625|782235|0
807 1|20020|~|~~|runlevel||0|0|0|955637625|800089|0
808 8|125||l4|||0|0|0|955637629|998367|0
809 6|245|tty1|1|LOGIN||0|0|0|955637630|998974|0
810 6|246|tty2|2|LOGIN||0|0|0|955637630|999498|0
811 7|336|pts/0|vt00andersen|andersen|:0.0|0|0|0|955637763|0|0
812 </screen>
813 </para>
814 </sect1>
1020 815
1021<para> 816 <sect1 id="echo">
1022Returns an exit code of FALSE (1) 817 <title>echo</title>
1023 818
819 <para>
820 Usage: echo [OPTION]... [ARG]...
821 </para>
1024 822
1025</para> 823 <para>
824 Print ARGs to stdout.
825 </para>
1026 826
1027<para> 827 <para>
1028Example: 828 Options:
829 </para>
1029 830
831 <para>
832 <screen>
833 -n Suppress trailing newline
834 -e Enable interpretation of escaped characters
835 -E Disable interpretation of escaped characters
836 </screen>
837 </para>
1030 838
1031</para> 839 <para>
840 Example:
841 </para>
1032 842
1033<para> 843 <para>
1034<screen> 844 <screen>
1035 $ false 845 $ echo "Erik is cool"
1036 $ echo $? 846 Erik is cool
1037 1 847 $ echo -e "Erik\nis\ncool"
1038</screen> 848 Erik
849 is
850 cool
851 $ echo "Erik\nis\ncool"
852 Erik\nis\ncool
853 </screen>
854 </para>
855 </sect1>
1039 856
857 <sect1 id="false">
858 <title>false</title>
1040 859
1041</para> 860 <para>
861 Usage: false
862 </para>
1042 863
1043<para> 864 <para>
1044------------------------------- 865 Returns an exit code of FALSE (1).
866 </para>
1045 867
868 <para>
869 Example:
870 </para>
1046 871
1047</para> 872 <para>
873 <screen>
874 $ false
875 $ echo $?
876 1
877 </screen>
878 </para>
879 </sect1>
1048 880
1049</listitem></varlistentry> 881<!-- This is where I have stopped formatting stuff -->
1050<varlistentry><term><emphasis>fbset 882<varlistentry><term><emphasis>fbset
1051 883
1052</emphasis></term> 884</emphasis></term>
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-03-24 11:28:58 +0000