← Back to branch summary

~ubuntu-branches/ubuntu/trusty/abs-guide/trusty-proposed

« back to all changes in this revision

Viewing changes to HTML/command-line-options.html

  • Committer: Package Import Robot
  • Author(s): Sandro Tosi
  • Date: 2012-06-03 10:57:27 UTC
  • mfrom: (1.2.6)
  • Revision ID: package-import@ubuntu.com-20120603105727-rm7frl4feikr2swm
Tags: 6.5-1
* New upstream release
* debian/watch
  - updated
* debian/abs-guide.lintian-overrides
  - updated for new upstream code
* debian/control
  - bump Standards-Version to 3.9.3 (no changes needed)

Show diffs side-by-side

added added

removed removed

Lines of Context:
HTML/command-line-options.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Command-Line Options</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 
9
"><LINK
 
10
REL="HOME"
 
11
TITLE="Advanced Bash-Scripting Guide"
 
12
HREF="index.html"><LINK
 
13
REL="PREVIOUS"
 
14
TITLE="A Detailed Introduction to I/O and I/O Redirection"
 
15
HREF="ioredirintro.html"><LINK
 
16
REL="NEXT"
 
17
TITLE="Bash Command-Line Options"
 
18
HREF="bash-options.html"><META
 
19
HTTP-EQUIV="Content-Style-Type"
 
20
CONTENT="text/css"><LINK
 
21
REL="stylesheet"
 
22
HREF="common/kde-common.css"
 
23
TYPE="text/css"><META
 
24
HTTP-EQUIV="Content-Type"
 
25
CONTENT="text/html; charset=iso-8859-1"><META
 
26
HTTP-EQUIV="Content-Language"
 
27
CONTENT="en"><LINK
 
28
REL="stylesheet"
 
29
HREF="common/kde-localised.css"
 
30
TYPE="text/css"
 
31
TITLE="KDE-English"><LINK
 
32
REL="stylesheet"
 
33
HREF="common/kde-default.css"
 
34
TYPE="text/css"
 
35
TITLE="KDE-Default"></HEAD
 
36
><BODY
 
37
CLASS="APPENDIX"
 
38
BGCOLOR="#FFFFFF"
 
39
TEXT="#000000"
 
40
LINK="#AA0000"
 
41
VLINK="#AA0055"
 
42
ALINK="#AA0000"
 
43
STYLE="font-family: sans-serif;"
 
44
><DIV
 
45
CLASS="NAVHEADER"
 
46
><TABLE
 
47
SUMMARY="Header navigation table"
 
48
WIDTH="100%"
 
49
BORDER="0"
 
50
CELLPADDING="0"
 
51
CELLSPACING="0"
 
52
><TR
 
53
><TH
 
54
COLSPAN="3"
 
55
ALIGN="center"
 
56
>Advanced Bash-Scripting Guide: An in-depth exploration of the art of shell scripting</TH
 
57
></TR
 
58
><TR
 
59
><TD
 
60
WIDTH="10%"
 
61
ALIGN="left"
 
62
VALIGN="bottom"
 
63
><A
 
64
HREF="ioredirintro.html"
 
65
ACCESSKEY="P"
 
66
>Prev</A
 
67
></TD
 
68
><TD
 
69
WIDTH="80%"
 
70
ALIGN="center"
 
71
VALIGN="bottom"
 
72
></TD
 
73
><TD
 
74
WIDTH="10%"
 
75
ALIGN="right"
 
76
VALIGN="bottom"
 
77
><A
 
78
HREF="bash-options.html"
 
79
ACCESSKEY="N"
 
80
>Next</A
 
81
></TD
 
82
></TR
 
83
></TABLE
 
84
><HR
 
85
ALIGN="LEFT"
 
86
WIDTH="100%"></DIV
 
87
><DIV
 
88
CLASS="APPENDIX"
 
89
><H1
 
90
><A
 
91
NAME="COMMAND-LINE-OPTIONS"
 
92
></A
 
93
>Appendix F. Command-Line Options</H1
 
94
><P
 
95
>Many executables, whether binaries or script files, accept
 
96
       options to modify their run-time behavior. For example: from
 
97
       the command-line, typing <B
 
98
CLASS="COMMAND"
 
99
>command -o</B
 
100
>
 
101
       would invoke <SPAN
 
102
CLASS="emphasis"
 
103
><I
 
104
CLASS="EMPHASIS"
 
105
>command</I
 
106
></SPAN
 
107
>, with option
 
108
       <TT
 
109
CLASS="OPTION"
 
110
>o</TT
 
111
>.</P
 
112
><DIV
 
113
CLASS="SECT1"
 
114
><H1
 
115
CLASS="SECT1"
 
116
><A
 
117
NAME="STANDARD-OPTIONS"
 
118
></A
 
119
>F.1. Standard Command-Line Options</H1
 
120
><P
 
121
>Over time, there has evolved a loose standard for the
 
122
        meanings of command-line option flags. The GNU utilities conform
 
123
        more closely to this <SPAN
 
124
CLASS="QUOTE"
 
125
>"standard"</SPAN
 
126
> than older UNIX
 
127
        utilities.</P
 
128
><P
 
129
>Traditionally, UNIX command-line options consist of a dash,
 
130
        followed by one or more lowercase letters. The GNU utilities
 
131
        added a double-dash, followed by a complete word or compound
 
132
        word.</P
 
133
><P
 
134
>The two most widely-accepted options are:</P
 
135
><UL
 
136
><LI
 
137
><P
 
138
><TT
 
139
CLASS="OPTION"
 
140
>-h</TT
 
141
></P
 
142
><P
 
143
><TT
 
144
CLASS="OPTION"
 
145
>--help</TT
 
146
></P
 
147
><P
 
148
><I
 
149
CLASS="FIRSTTERM"
 
150
>Help</I
 
151
>: Give usage message and exit.</P
 
152
></LI
 
153
><LI
 
154
><P
 
155
><TT
 
156
CLASS="OPTION"
 
157
>-v</TT
 
158
></P
 
159
><P
 
160
><TT
 
161
CLASS="OPTION"
 
162
>--version</TT
 
163
></P
 
164
><P
 
165
><I
 
166
CLASS="FIRSTTERM"
 
167
>Version</I
 
168
>: Show program version and exit.</P
 
169
></LI
 
170
></UL
 
171
><P
 
172
>Other common options are:</P
 
173
><UL
 
174
><LI
 
175
><P
 
176
><TT
 
177
CLASS="OPTION"
 
178
>-a</TT
 
179
></P
 
180
><P
 
181
><TT
 
182
CLASS="OPTION"
 
183
>--all</TT
 
184
></P
 
185
><P
 
186
><I
 
187
CLASS="FIRSTTERM"
 
188
>All</I
 
189
>: show <SPAN
 
190
CLASS="emphasis"
 
191
><I
 
192
CLASS="EMPHASIS"
 
193
>all</I
 
194
></SPAN
 
195
>
 
196
        information or operate on <SPAN
 
197
CLASS="emphasis"
 
198
><I
 
199
CLASS="EMPHASIS"
 
200
>all</I
 
201
></SPAN
 
202
> arguments.</P
 
203
></LI
 
204
><LI
 
205
><P
 
206
><TT
 
207
CLASS="OPTION"
 
208
>-l</TT
 
209
></P
 
210
><P
 
211
><TT
 
212
CLASS="OPTION"
 
213
>--list</TT
 
214
></P
 
215
><P
 
216
><I
 
217
CLASS="FIRSTTERM"
 
218
>List</I
 
219
>: list files or arguments without
 
220
        taking other action.</P
 
221
></LI
 
222
><LI
 
223
><P
 
224
><TT
 
225
CLASS="OPTION"
 
226
>-o</TT
 
227
></P
 
228
><P
 
229
><I
 
230
CLASS="FIRSTTERM"
 
231
>Output</I
 
232
> filename</P
 
233
></LI
 
234
><LI
 
235
><P
 
236
><TT
 
237
CLASS="OPTION"
 
238
>-q</TT
 
239
></P
 
240
><P
 
241
><TT
 
242
CLASS="OPTION"
 
243
>--quiet</TT
 
244
></P
 
245
><P
 
246
><I
 
247
CLASS="FIRSTTERM"
 
248
>Quiet</I
 
249
>: suppress
 
250
      <TT
 
251
CLASS="FILENAME"
 
252
>stdout</TT
 
253
>.</P
 
254
></LI
 
255
><LI
 
256
><P
 
257
><TT
 
258
CLASS="OPTION"
 
259
>-r</TT
 
260
></P
 
261
><P
 
262
><TT
 
263
CLASS="OPTION"
 
264
>-R</TT
 
265
></P
 
266
><P
 
267
><TT
 
268
CLASS="OPTION"
 
269
>--recursive</TT
 
270
></P
 
271
><P
 
272
><I
 
273
CLASS="FIRSTTERM"
 
274
>Recursive</I
 
275
>: Operate recursively (down
 
276
        directory tree).</P
 
277
></LI
 
278
><LI
 
279
><P
 
280
><TT
 
281
CLASS="OPTION"
 
282
>-v</TT
 
283
></P
 
284
><P
 
285
><TT
 
286
CLASS="OPTION"
 
287
>--verbose</TT
 
288
></P
 
289
><P
 
290
><I
 
291
CLASS="FIRSTTERM"
 
292
>Verbose</I
 
293
>: output additional information to
 
294
        <TT
 
295
CLASS="FILENAME"
 
296
>stdout</TT
 
297
> or <TT
 
298
CLASS="FILENAME"
 
299
>stderr</TT
 
300
>.</P
 
301
></LI
 
302
><LI
 
303
><P
 
304
><TT
 
305
CLASS="OPTION"
 
306
>-z</TT
 
307
></P
 
308
><P
 
309
><TT
 
310
CLASS="OPTION"
 
311
>--compress</TT
 
312
></P
 
313
><P
 
314
><I
 
315
CLASS="FIRSTTERM"
 
316
>Compress</I
 
317
>: apply compression (usually
 
318
        <A
 
319
HREF="filearchiv.html#GZIPREF"
 
320
>gzip</A
 
321
>).</P
 
322
></LI
 
323
></UL
 
324
><P
 
325
>However:</P
 
326
><UL
 
327
><LI
 
328
><P
 
329
>In <B
 
330
CLASS="COMMAND"
 
331
>tar</B
 
332
> and <B
 
333
CLASS="COMMAND"
 
334
>gawk</B
 
335
>:</P
 
336
><P
 
337
><TT
 
338
CLASS="OPTION"
 
339
>-f</TT
 
340
></P
 
341
><P
 
342
><TT
 
343
CLASS="OPTION"
 
344
>--file</TT
 
345
></P
 
346
><P
 
347
><I
 
348
CLASS="FIRSTTERM"
 
349
>File</I
 
350
>: filename follows.</P
 
351
></LI
 
352
><LI
 
353
><P
 
354
>In <B
 
355
CLASS="COMMAND"
 
356
>cp</B
 
357
>, <B
 
358
CLASS="COMMAND"
 
359
>mv</B
 
360
>,
 
361
        <B
 
362
CLASS="COMMAND"
 
363
>rm</B
 
364
>:</P
 
365
><P
 
366
><TT
 
367
CLASS="OPTION"
 
368
>-f</TT
 
369
></P
 
370
><P
 
371
><TT
 
372
CLASS="OPTION"
 
373
>--force</TT
 
374
></P
 
375
><P
 
376
><I
 
377
CLASS="FIRSTTERM"
 
378
>Force</I
 
379
>: force overwrite of target file(s).</P
 
380
></LI
 
381
></UL
 
382
><DIV
 
383
CLASS="CAUTION"
 
384
><TABLE
 
385
CLASS="CAUTION"
 
386
WIDTH="100%"
 
387
BORDER="0"
 
388
><TR
 
389
><TD
 
390
WIDTH="25"
 
391
ALIGN="CENTER"
 
392
VALIGN="TOP"
 
393
><IMG
 
394
SRC="common/caution.png"
 
395
HSPACE="5"
 
396
ALT="Caution"></TD
 
397
><TD
 
398
ALIGN="LEFT"
 
399
VALIGN="TOP"
 
400
><P
 
401
>Many UNIX and Linux utilities deviate from this
 
402
      <SPAN
 
403
CLASS="QUOTE"
 
404
>"standard,"</SPAN
 
405
> so it is dangerous to
 
406
      <SPAN
 
407
CLASS="emphasis"
 
408
><I
 
409
CLASS="EMPHASIS"
 
410
>assume</I
 
411
></SPAN
 
412
> that a given option will behave in a
 
413
      standard way. Always check the man page for the command in question
 
414
      when in doubt.</P
 
415
></TD
 
416
></TR
 
417
></TABLE
 
418
></DIV
 
419
><P
 
420
>A complete table of recommended options for the GNU utilities
 
421
        is available at <A
 
422
HREF="http://www.gnu.org/prep/standards/"
 
423
TARGET="_top"
 
424
>the GNU standards page</A
 
425
>.</P
 
426
></DIV
 
427
></DIV
 
428
><DIV
 
429
CLASS="NAVFOOTER"
 
430
><HR
 
431
ALIGN="LEFT"
 
432
WIDTH="100%"><TABLE
 
433
SUMMARY="Footer navigation table"
 
434
WIDTH="100%"
 
435
BORDER="0"
 
436
CELLPADDING="0"
 
437
CELLSPACING="0"
 
438
><TR
 
439
><TD
 
440
WIDTH="33%"
 
441
ALIGN="left"
 
442
VALIGN="top"
 
443
><A
 
444
HREF="ioredirintro.html"
 
445
ACCESSKEY="P"
 
446
>Prev</A
 
447
></TD
 
448
><TD
 
449
WIDTH="34%"
 
450
ALIGN="center"
 
451
VALIGN="top"
 
452
><A
 
453
HREF="index.html"
 
454
ACCESSKEY="H"
 
455
>Home</A
 
456
></TD
 
457
><TD
 
458
WIDTH="33%"
 
459
ALIGN="right"
 
460
VALIGN="top"
 
461
><A
 
462
HREF="bash-options.html"
 
463
ACCESSKEY="N"
 
464
>Next</A
 
465
></TD
 
466
></TR
 
467
><TR
 
468
><TD
 
469
WIDTH="33%"
 
470
ALIGN="left"
 
471
VALIGN="top"
 
472
>A Detailed Introduction to I/O and I/O Redirection</TD
 
473
><TD
 
474
WIDTH="34%"
 
475
ALIGN="center"
 
476
VALIGN="top"
 
477
>&nbsp;</TD
 
478
><TD
 
479
WIDTH="33%"
 
480
ALIGN="right"
 
481
VALIGN="top"
 
482
>Bash Command-Line Options</TD
 
483
></TR
 
484
></TABLE
 
485
></DIV
 
486
></BODY
 
487
></HTML
 
488
>
 
 
b'\\ No newline at end of file'