]>
Commit | Line | Data |
---|---|---|
3c350007 JB |
1 | --- coreutils-6.10/doc/coreutils.texi.orig 2008-01-11 14:47:21.000000000 +0100 |
2 | +++ coreutils-6.10/doc/coreutils.texi 2008-03-02 02:00:24.656756959 +0100 | |
05fadba2 | 3 | @@ -20,114 +20,100 @@ |
fbb5b105 JB |
4 | @syncodeindex pg cp |
5 | @syncodeindex vr cp | |
6 | ||
7 | -@dircategory Basics | |
8 | +@dircategory Core utilities: | |
9 | @direntry | |
10 | -* Coreutils: (coreutils). Core GNU (file, text, shell) utilities. | |
11 | -* Common options: (coreutils)Common options. Common options. | |
12 | -* File permissions: (coreutils)File permissions. Access modes. | |
a839fc2f | 13 | -* Date input formats: (coreutils)Date input formats. |
fbb5b105 | 14 | -@end direntry |
a839fc2f | 15 | - |
c2be74f0 JB |
16 | -@c FIXME: the following need documentation |
17 | -@c * [: (coreutils)[ invocation. File/string tests. | |
18 | -@c * pinky: (coreutils)pinky invocation. FIXME. | |
19 | -@c * uptime: (coreutils)uptime invocation. FIXME. | |
05fadba2 AM |
20 | -@c * mktemp: (coreutils)mktemp invocation. FIXME. |
21 | -@c * chcon: (coreutils)chcon invocation. FIXME. | |
c2be74f0 | 22 | - |
fbb5b105 JB |
23 | -@dircategory Individual utilities |
24 | -@direntry | |
3c350007 | 25 | -* arch: (coreutils)arch invocation. Print machine hardware name. |
c2be74f0 | 26 | -* base64: (coreutils)base64 invocation. Base64 encode/decode data. |
a839fc2f JB |
27 | -* basename: (coreutils)basename invocation. Strip directory and suffix. |
28 | -* cat: (coreutils)cat invocation. Concatenate and write files. | |
29 | -* chgrp: (coreutils)chgrp invocation. Change file groups. | |
30 | -* chmod: (coreutils)chmod invocation. Change file permissions. | |
31 | -* chown: (coreutils)chown invocation. Change file owners/groups. | |
32 | -* chroot: (coreutils)chroot invocation. Specify the root directory. | |
fbb5b105 | 33 | -* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. |
a839fc2f JB |
34 | -* comm: (coreutils)comm invocation. Compare sorted files by line. |
35 | -* cp: (coreutils)cp invocation. Copy files. | |
36 | -* csplit: (coreutils)csplit invocation. Split by context. | |
37 | -* cut: (coreutils)cut invocation. Print selected parts of lines. | |
38 | -* date: (coreutils)date invocation. Print/set system date and time. | |
39 | -* dd: (coreutils)dd invocation. Copy and convert a file. | |
c2be74f0 | 40 | -* df: (coreutils)df invocation. Report file system disk usage. |
a839fc2f JB |
41 | -* dir: (coreutils)dir invocation. List directories briefly. |
42 | -* dircolors: (coreutils)dircolors invocation. Color setup for ls. | |
43 | -* dirname: (coreutils)dirname invocation. Strip non-directory suffix. | |
44 | -* du: (coreutils)du invocation. Report on disk usage. | |
45 | -* echo: (coreutils)echo invocation. Print a line of text. | |
46 | -* env: (coreutils)env invocation. Modify the environment. | |
47 | -* expand: (coreutils)expand invocation. Convert tabs to spaces. | |
48 | -* expr: (coreutils)expr invocation. Evaluate expressions. | |
49 | -* factor: (coreutils)factor invocation. Print prime factors | |
50 | -* false: (coreutils)false invocation. Do nothing, unsuccessfully. | |
51 | -* fmt: (coreutils)fmt invocation. Reformat paragraph text. | |
52 | -* fold: (coreutils)fold invocation. Wrap long input lines. | |
53 | -* groups: (coreutils)groups invocation. Print group names a user is in. | |
54 | -* head: (coreutils)head invocation. Output the first part of files. | |
55 | -* hostid: (coreutils)hostid invocation. Print numeric host identifier. | |
56 | -* hostname: (coreutils)hostname invocation. Print or set system name. | |
c2be74f0 | 57 | -* id: (coreutils)id invocation. Print user identity. |
a839fc2f JB |
58 | -* install: (coreutils)install invocation. Copy and change attributes. |
59 | -* join: (coreutils)join invocation. Join lines on a common field. | |
60 | -* kill: (coreutils)kill invocation. Send a signal to processes. | |
61 | -* link: (coreutils)link invocation. Make hard links between files. | |
62 | -* ln: (coreutils)ln invocation. Make links between files. | |
63 | -* logname: (coreutils)logname invocation. Print current login name. | |
64 | -* ls: (coreutils)ls invocation. List directory contents. | |
c2be74f0 | 65 | -* md5sum: (coreutils)md5sum invocation. Print or check MD5 digests. |
a839fc2f JB |
66 | -* mkdir: (coreutils)mkdir invocation. Create directories. |
67 | -* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes). | |
68 | -* mknod: (coreutils)mknod invocation. Create special files. | |
69 | -* mv: (coreutils)mv invocation. Rename files. | |
c2be74f0 | 70 | -* nice: (coreutils)nice invocation. Modify niceness. |
a839fc2f JB |
71 | -* nl: (coreutils)nl invocation. Number lines and write files. |
72 | -* nohup: (coreutils)nohup invocation. Immunize to hangups. | |
73 | -* od: (coreutils)od invocation. Dump files in octal, etc. | |
74 | -* paste: (coreutils)paste invocation. Merge lines of files. | |
75 | -* pathchk: (coreutils)pathchk invocation. Check file name portability. | |
76 | -* pr: (coreutils)pr invocation. Paginate or columnate files. | |
77 | -* printenv: (coreutils)printenv invocation. Print environment variables. | |
78 | -* printf: (coreutils)printf invocation. Format and print data. | |
79 | -* ptx: (coreutils)ptx invocation. Produce permuted indexes. | |
80 | -* pwd: (coreutils)pwd invocation. Print working directory. | |
fbb5b105 | 81 | -* readlink: (coreutils)readlink invocation. Print referent of a symlink. |
a839fc2f JB |
82 | -* rm: (coreutils)rm invocation. Remove files. |
83 | -* rmdir: (coreutils)rmdir invocation. Remove empty directories. | |
84 | -* seq: (coreutils)seq invocation. Print numeric sequences | |
c2be74f0 JB |
85 | -* sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests. |
86 | -* sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests. | |
a839fc2f | 87 | -* shred: (coreutils)shred invocation. Remove files more securely. |
c2be74f0 | 88 | -* shuf: (coreutils)shuf invocation. Shuffling text files. |
a839fc2f JB |
89 | -* sleep: (coreutils)sleep invocation. Delay for a specified time. |
90 | -* sort: (coreutils)sort invocation. Sort text files. | |
91 | -* split: (coreutils)split invocation. Split into fixed-size pieces. | |
fbb5b105 | 92 | -* stat: (coreutils)stat invocation. Report file(system) status. |
a839fc2f | 93 | -* stty: (coreutils)stty invocation. Print/change terminal settings. |
c2be74f0 | 94 | -* su: (coreutils)su invocation. Modify user and group ID. |
a839fc2f JB |
95 | -* sum: (coreutils)sum invocation. Print traditional checksum. |
96 | -* sync: (coreutils)sync invocation. Synchronize memory and disk. | |
97 | -* tac: (coreutils)tac invocation. Reverse files. | |
98 | -* tail: (coreutils)tail invocation. Output the last part of files. | |
99 | -* tee: (coreutils)tee invocation. Redirect to multiple files. | |
100 | -* test: (coreutils)test invocation. File/string tests. | |
101 | -* touch: (coreutils)touch invocation. Change file timestamps. | |
102 | -* tr: (coreutils)tr invocation. Translate characters. | |
103 | -* true: (coreutils)true invocation. Do nothing, successfully. | |
104 | -* tsort: (coreutils)tsort invocation. Topological sort. | |
105 | -* tty: (coreutils)tty invocation. Print terminal name. | |
106 | -* uname: (coreutils)uname invocation. Print system information. | |
107 | -* unexpand: (coreutils)unexpand invocation. Convert spaces to tabs. | |
a839fc2f | 108 | -* uniq: (coreutils)uniq invocation. Uniquify files. |
fbb5b105 | 109 | -* unlink: (coreutils)unlink invocation. Removal via unlink(2). |
a839fc2f JB |
110 | -* users: (coreutils)users invocation. Print current user names. |
111 | -* vdir: (coreutils)vdir invocation. List directories verbosely. | |
876a8767 | 112 | -* wc: (coreutils)wc invocation. Line, word, and byte counts. |
a839fc2f | 113 | -* who: (coreutils)who invocation. Print who is logged in. |
c2be74f0 | 114 | -* whoami: (coreutils)whoami invocation. Print effective user ID. |
a839fc2f | 115 | -* yes: (coreutils)yes invocation. Print a string indefinitely. |
05fadba2 AM |
116 | +* Coreutils: (coreutils). Core GNU (file, text, shell) utilities. |
117 | +* arch: (coreutils)arch invocation. Print machine hardware name. | |
118 | +* base64: (coreutils)base64 invocation. Base64 encode/decode data. | |
119 | +* basename: (coreutils)basename invocation. Strip directory and suffix. | |
120 | +* cat: (coreutils)cat invocation. Concatenate and write files. | |
121 | +* chgrp: (coreutils)chgrp invocation. Change file groups. | |
122 | +* chmod: (coreutils)chmod invocation. Change file permissions. | |
123 | +* chown: (coreutils)chown invocation. Change file owners/groups. | |
124 | +* chroot: (coreutils)chroot invocation. Specify the root directory. | |
125 | +* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. | |
126 | +* comm: (coreutils)comm invocation. Compare sorted files by line. | |
127 | +* cp: (coreutils)cp invocation. Copy files. | |
128 | +* csplit: (coreutils)csplit invocation. Split by context. | |
129 | +* cut: (coreutils)cut invocation. Print selected parts of lines. | |
130 | +* date: (coreutils)date invocation. Print/set system date and time. | |
131 | +* dd: (coreutils)dd invocation. Copy and convert a file. | |
132 | +* df: (coreutils)df invocation. Report file system disk usage. | |
133 | +* dir: (coreutils)dir invocation. List directories briefly. | |
134 | +* dircolors: (coreutils)dircolors invocation. Color setup for ls. | |
135 | +* dirname: (coreutils)dirname invocation. Strip non-directory suffix. | |
136 | +* du: (coreutils)du invocation. Report on disk usage. | |
137 | +* echo: (coreutils)echo invocation. Print a line of text. | |
138 | +* env: (coreutils)env invocation. Modify the environment. | |
139 | +* expand: (coreutils)expand invocation. Convert tabs to spaces. | |
140 | +* expr: (coreutils)expr invocation. Evaluate expressions. | |
141 | +* factor: (coreutils)factor invocation. Print prime factors | |
142 | +* false: (coreutils)false invocation. Do nothing, unsuccessfully. | |
143 | +* fmt: (coreutils)fmt invocation. Reformat paragraph text. | |
144 | +* fold: (coreutils)fold invocation. Wrap long input lines. | |
145 | +* groups: (coreutils)groups invocation. Print group names a user is in. | |
146 | +* head: (coreutils)head invocation. Output the first part of files. | |
147 | +* hostid: (coreutils)hostid invocation. Print numeric host identifier. | |
148 | +* hostname: (coreutils)hostname invocation. Print or set system name. | |
149 | +* id: (coreutils)id invocation. Print user identity. | |
150 | +* install: (coreutils)install invocation. Copy and change attributes. | |
151 | +* join: (coreutils)join invocation. Join lines on a common field. | |
152 | +* kill: (coreutils)kill invocation. Send a signal to processes. | |
153 | +* link: (coreutils)link invocation. Make hard links between files. | |
154 | +* ln: (coreutils)ln invocation. Make links between files. | |
155 | +* logname: (coreutils)logname invocation. Print current login name. | |
156 | +* ls: (coreutils)ls invocation. List directory contents. | |
157 | +* md5sum: (coreutils)md5sum invocation. Print or check MD5 digests. | |
158 | +* mkdir: (coreutils)mkdir invocation. Create directories. | |
159 | +* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes). | |
160 | +* mknod: (coreutils)mknod invocation. Create special files. | |
161 | +* mv: (coreutils)mv invocation. Rename files. | |
162 | +* nice: (coreutils)nice invocation. Modify niceness. | |
163 | +* nl: (coreutils)nl invocation. Number lines and write files. | |
164 | +* nohup: (coreutils)nohup invocation. Immunize to hangups. | |
165 | +* od: (coreutils)od invocation. Dump files in octal, etc. | |
166 | +* paste: (coreutils)paste invocation. Merge lines of files. | |
167 | +* pathchk: (coreutils)pathchk invocation. Check file name portability. | |
168 | +* pr: (coreutils)pr invocation. Paginate or columnate files. | |
169 | +* printenv: (coreutils)printenv invocation. Print environment variables. | |
170 | +* printf: (coreutils)printf invocation. Format and print data. | |
171 | +* ptx: (coreutils)ptx invocation. Produce permuted indexes. | |
172 | +* pwd: (coreutils)pwd invocation. Print working directory. | |
173 | +* readlink: (coreutils)readlink invocation. Print referent of a symlink. | |
174 | +* rm: (coreutils)rm invocation. Remove files. | |
175 | +* rmdir: (coreutils)rmdir invocation. Remove empty directories. | |
176 | +* seq: (coreutils)seq invocation. Print numeric sequences | |
177 | +* sha1sum: (coreutils)sha1sum invocation. Print or check SHA-1 digests. | |
178 | +* sha2: (coreutils)sha2 utilities. Print or check SHA-2 digests. | |
179 | +* shred: (coreutils)shred invocation. Remove files more securely. | |
180 | +* shuf: (coreutils)shuf invocation. Shuffling text files. | |
181 | +* sleep: (coreutils)sleep invocation. Delay for a specified time. | |
182 | +* sort: (coreutils)sort invocation. Sort text files. | |
183 | +* split: (coreutils)split invocation. Split into fixed-size pieces. | |
184 | +* stat: (coreutils)stat invocation. Report file(system) status. | |
185 | +* stty: (coreutils)stty invocation. Print/change terminal settings. | |
186 | +* su: (coreutils)su invocation. Modify user and group ID. | |
187 | +* sum: (coreutils)sum invocation. Print traditional checksum. | |
188 | +* sync: (coreutils)sync invocation. Synchronize memory and disk. | |
189 | +* tac: (coreutils)tac invocation. Reverse files. | |
190 | +* tail: (coreutils)tail invocation. Output the last part of files. | |
191 | +* tee: (coreutils)tee invocation. Redirect to multiple files. | |
192 | +* test: (coreutils)test invocation. File/string tests. | |
193 | +* touch: (coreutils)touch invocation. Change file timestamps. | |
194 | +* tr: (coreutils)tr invocation. Translate characters. | |
195 | +* true: (coreutils)true invocation. Do nothing, successfully. | |
196 | +* tsort: (coreutils)tsort invocation. Topological sort. | |
197 | +* tty: (coreutils)tty invocation. Print terminal name. | |
198 | +* uname: (coreutils)uname invocation. Print system information. | |
199 | +* unexpand: (coreutils)unexpand invocation. Convert spaces to tabs. | |
200 | +* uniq: (coreutils)uniq invocation. Uniquify files. | |
201 | +* unlink: (coreutils)unlink invocation. Removal via unlink(2). | |
202 | +* users: (coreutils)users invocation. Print current user names. | |
203 | +* vdir: (coreutils)vdir invocation. List directories verbosely. | |
204 | +* wc: (coreutils)wc invocation. Line, word, and byte counts. | |
205 | +* who: (coreutils)who invocation. Print who is logged in. | |
206 | +* whoami: (coreutils)whoami invocation. Print effective user ID. | |
207 | +* yes: (coreutils)yes invocation. Print a string indefinitely. | |
fbb5b105 JB |
208 | @end direntry |
209 | ||
210 | @copying | |
c2be74f0 | 211 | @@ -189,9 +175,8 @@ |
a839fc2f JB |
212 | * File name manipulation:: dirname basename pathchk |
213 | * Working context:: pwd stty printenv tty | |
c2be74f0 JB |
214 | * User information:: id logname whoami groups users who |
215 | -* System context:: date uname hostname hostid | |
216 | +* System context:: date uname hostid | |
a839fc2f JB |
217 | * Modified command invocation:: chroot env nice nohup su |
218 | -* Process control:: kill | |
219 | * Delaying:: sleep | |
220 | * Numeric operations:: factor seq | |
221 | * File permissions:: Access modes. | |
3c350007 | 222 | @@ -218,42 +203,42 @@ |
a839fc2f JB |
223 | |
224 | Output of entire files | |
225 | ||
226 | -* cat invocation:: Concatenate and write files. | |
227 | -* tac invocation:: Concatenate and write files in reverse. | |
228 | -* nl invocation:: Number lines and write files. | |
229 | -* od invocation:: Write files in octal or other formats. | |
c2be74f0 | 230 | -* base64 invocation:: Transform data into printable data. |
a839fc2f JB |
231 | +* cat:: Concatenate and write files. |
232 | +* tac:: Concatenate and write files in reverse. | |
233 | +* nl:: Number lines and write files. | |
234 | +* od:: Write files in octal or other formats. | |
c2be74f0 | 235 | +* base64:: Transform data into printable data. |
a839fc2f JB |
236 | |
237 | Formatting file contents | |
238 | ||
239 | -* fmt invocation:: Reformat paragraph text. | |
240 | -* pr invocation:: Paginate or columnate files for printing. | |
241 | -* fold invocation:: Wrap input lines to fit in specified width. | |
242 | +* fmt:: Reformat paragraph text. | |
243 | +* pr:: Paginate or columnate files for printing. | |
244 | +* fold:: Wrap input lines to fit in specified width. | |
245 | ||
246 | Output of parts of files | |
247 | ||
248 | -* head invocation:: Output the first part of files. | |
249 | -* tail invocation:: Output the last part of files. | |
250 | -* split invocation:: Split a file into fixed-size pieces. | |
251 | -* csplit invocation:: Split a file into context-determined pieces. | |
252 | +* head:: Output the first part of files. | |
253 | +* tail:: Output the last part of files. | |
254 | +* split:: Split a file into fixed-size pieces. | |
255 | +* csplit:: Split a file into context-determined pieces. | |
256 | ||
257 | Summarizing files | |
258 | ||
876a8767 | 259 | -* wc invocation:: Print newline, word, and byte counts. |
a839fc2f JB |
260 | -* sum invocation:: Print checksum and block counts. |
261 | -* cksum invocation:: Print CRC checksum and byte counts. | |
c2be74f0 JB |
262 | -* md5sum invocation:: Print or check MD5 digests. |
263 | -* sha1sum invocation:: Print or check SHA-1 digests. | |
264 | -* sha2 utilities:: Print or check SHA-2 digests. | |
876a8767 | 265 | +* wc:: Print newline, word, and byte counts. |
a839fc2f JB |
266 | +* sum:: Print checksum and block counts. |
267 | +* cksum:: Print CRC checksum and byte counts. | |
c2be74f0 JB |
268 | +* md5sum:: Print or check MD5 digests. |
269 | +* sha1sum:: Print or check SHA-1 digests. | |
270 | +* sha2:: Print or check SHA-2 digests. | |
a839fc2f JB |
271 | |
272 | Operating on sorted files | |
273 | ||
274 | -* sort invocation:: Sort text files. | |
c2be74f0 | 275 | -* shuf invocation:: Shuffle text files. |
a839fc2f JB |
276 | -* uniq invocation:: Uniquify files. |
277 | -* comm invocation:: Compare two sorted files line by line. | |
278 | -* ptx invocation:: Produce a permuted index of file contents. | |
279 | -* tsort invocation:: Topological sort. | |
280 | +* sort:: Sort text files. | |
c2be74f0 | 281 | +* shuf:: Shuffle text files. |
a839fc2f JB |
282 | +* uniq:: Uniquify files. |
283 | +* comm:: Compare two sorted files line by line. | |
284 | +* ptx:: Produce a permuted index of file contents. | |
285 | +* tsort:: Topological sort. | |
286 | ||
287 | @command{ptx}: Produce permuted indexes | |
288 | ||
3c350007 | 289 | @@ -265,15 +250,15 @@ |
a839fc2f JB |
290 | |
291 | Operating on fields within a line | |
292 | ||
293 | -* cut invocation:: Print selected parts of lines. | |
294 | -* paste invocation:: Merge lines of files. | |
295 | -* join invocation:: Join lines on a common field. | |
296 | +* cut:: Print selected parts of lines. | |
297 | +* paste:: Merge lines of files. | |
298 | +* join:: Join lines on a common field. | |
299 | ||
300 | Operating on characters | |
301 | ||
302 | -* tr invocation:: Translate, squeeze, and/or delete characters. | |
303 | -* expand invocation:: Convert tabs to spaces. | |
304 | -* unexpand invocation:: Convert spaces to tabs. | |
305 | +* tr:: Translate, squeeze, and/or delete characters. | |
306 | +* expand:: Convert tabs to spaces. | |
307 | +* unexpand:: Convert spaces to tabs. | |
308 | ||
309 | @command{tr}: Translate, squeeze, and/or delete characters | |
310 | ||
3c350007 | 311 | @@ -283,10 +268,10 @@ |
a839fc2f JB |
312 | |
313 | Directory listing | |
314 | ||
315 | -* ls invocation:: List directory contents | |
316 | -* dir invocation:: Briefly list directory contents | |
317 | -* vdir invocation:: Verbosely list directory contents | |
318 | -* dircolors invocation:: Color setup for @command{ls} | |
319 | +* ls:: List directory contents | |
320 | +* dir:: Briefly list directory contents | |
321 | +* vdir:: Verbosely list directory contents | |
322 | +* dircolors:: Color setup for @command{ls} | |
323 | ||
324 | @command{ls}: List directory contents | |
325 | ||
3c350007 | 326 | @@ -299,50 +284,50 @@ |
a839fc2f JB |
327 | |
328 | Basic operations | |
329 | ||
330 | -* cp invocation:: Copy files and directories | |
331 | -* dd invocation:: Convert and copy a file | |
332 | -* install invocation:: Copy files and set attributes | |
333 | -* mv invocation:: Move (rename) files | |
334 | -* rm invocation:: Remove files or directories | |
335 | -* shred invocation:: Remove files more securely | |
336 | +* cp:: Copy files and directories | |
337 | +* dd:: Convert and copy a file | |
338 | +* install:: Copy files and set attributes | |
339 | +* mv:: Move (rename) files | |
340 | +* rm:: Remove files or directories | |
341 | +* shred:: Remove files more securely | |
342 | ||
343 | Special file types | |
344 | ||
345 | -* link invocation:: Make a hard link via the link syscall | |
346 | -* ln invocation:: Make links between files | |
347 | -* mkdir invocation:: Make directories | |
348 | -* mkfifo invocation:: Make FIFOs (named pipes) | |
349 | -* mknod invocation:: Make block or character special files | |
fbb5b105 | 350 | -* readlink invocation:: Print the referent of a symbolic link |
a839fc2f JB |
351 | -* rmdir invocation:: Remove empty directories |
352 | -* unlink invocation:: Remove files via unlink syscall | |
353 | +* link:: Make a hard link via the link syscall | |
354 | +* ln:: Make links between files | |
355 | +* mkdir:: Make directories | |
356 | +* mkfifo:: Make FIFOs (named pipes) | |
357 | +* mknod:: Make block or character special files | |
fbb5b105 | 358 | +* readlink:: Print the referent of a symbolic link |
a839fc2f JB |
359 | +* rmdir:: Remove empty directories |
360 | +* unlink:: Remove files via unlink syscall | |
361 | ||
362 | Changing file attributes | |
363 | ||
364 | -* chown invocation:: Change file owner and group | |
365 | -* chgrp invocation:: Change group ownership | |
366 | -* chmod invocation:: Change access permissions | |
367 | -* touch invocation:: Change file timestamps | |
368 | +* chown:: Change file owner and group | |
369 | +* chgrp:: Change group ownership | |
370 | +* chmod:: Change access permissions | |
371 | +* touch:: Change file timestamps | |
372 | ||
373 | Disk usage | |
374 | ||
c2be74f0 | 375 | -* df invocation:: Report file system disk space usage |
a839fc2f | 376 | -* du invocation:: Estimate file space usage |
c2be74f0 | 377 | -* stat invocation:: Report file or file system status |
a839fc2f | 378 | -* sync invocation:: Synchronize data on disk with memory |
c2be74f0 | 379 | +* df:: Report file system disk space usage |
a839fc2f | 380 | +* du:: Estimate file space usage |
c2be74f0 | 381 | +* stat:: Report file or file system status |
a839fc2f JB |
382 | +* sync:: Synchronize data on disk with memory |
383 | ||
384 | Printing text | |
385 | ||
386 | -* echo invocation:: Print a line of text | |
387 | -* printf invocation:: Format and print data | |
388 | -* yes invocation:: Print a string until interrupted | |
389 | +* echo:: Print a line of text | |
390 | +* printf:: Format and print data | |
391 | +* yes:: Print a string until interrupted | |
392 | ||
393 | Conditions | |
394 | ||
395 | -* false invocation:: Do nothing, unsuccessfully | |
396 | -* true invocation:: Do nothing, successfully | |
397 | -* test invocation:: Check file types and compare values | |
398 | -* expr invocation:: Evaluate expressions | |
fbb5b105 JB |
399 | +* false:: Do nothing, unsuccessfully |
400 | +* true:: Do nothing, successfully | |
401 | +* test:: Check file types and compare values | |
402 | +* expr:: Evaluate expressions | |
a839fc2f JB |
403 | |
404 | @command{test}: Check file types and compare values | |
405 | ||
3c350007 | 406 | @@ -361,20 +346,20 @@ |
a839fc2f JB |
407 | |
408 | Redirection | |
409 | ||
3c350007 JB |
410 | -* tee invocation:: Redirect output to multiple files or processes |
411 | +* tee:: Redirect output to multiple files or processes | |
a839fc2f JB |
412 | |
413 | File name manipulation | |
414 | ||
415 | -* basename invocation:: Strip directory and suffix from a file name | |
416 | -* dirname invocation:: Strip non-directory suffix from a file name | |
417 | -* pathchk invocation:: Check file name portability | |
418 | +* basename:: Strip directory and suffix from a file name | |
419 | +* dirname:: Strip non-directory suffix from a file name | |
420 | +* pathchk:: Check file name portability | |
421 | ||
422 | Working context | |
423 | ||
424 | -* pwd invocation:: Print working directory | |
425 | -* stty invocation:: Print or change terminal characteristics | |
426 | -* printenv invocation:: Print all or some environment variables | |
427 | -* tty invocation:: Print file name of terminal on standard input | |
428 | +* pwd:: Print working directory | |
429 | +* stty:: Print or change terminal characteristics | |
430 | +* printenv:: Print all or some environment variables | |
431 | +* tty:: Print file name of terminal on standard input | |
432 | ||
433 | @command{stty}: Print or change terminal characteristics | |
434 | ||
3c350007 | 435 | @@ -388,20 +373,19 @@ |
a839fc2f JB |
436 | |
437 | User information | |
438 | ||
c2be74f0 | 439 | -* id invocation:: Print user identity |
a839fc2f | 440 | -* logname invocation:: Print current login name |
c2be74f0 | 441 | -* whoami invocation:: Print effective user ID |
a839fc2f JB |
442 | -* groups invocation:: Print group names a user is in |
443 | -* users invocation:: Print login names of users currently logged in | |
444 | -* who invocation:: Print who is currently logged in | |
c2be74f0 | 445 | +* id:: Print user identity |
a839fc2f | 446 | +* logname:: Print current login name |
c2be74f0 | 447 | +* whoami:: Print effective user ID |
fc53c102 | 448 | +* groups:: Print group names a user is in |
a839fc2f JB |
449 | +* users:: Print login names of users currently logged in |
450 | +* who:: Print who is currently logged in | |
451 | ||
452 | System context | |
453 | ||
3c350007 | 454 | -* arch invocation:: Print machine hardware name |
a839fc2f JB |
455 | -* date invocation:: Print or set system date and time |
456 | -* uname invocation:: Print system information | |
457 | -* hostname invocation:: Print or set system name | |
458 | -* hostid invocation:: Print numeric host identifier. | |
3c350007 | 459 | +* arch:: Print machine hardware name |
a839fc2f JB |
460 | +* date:: Print or set system date and time |
461 | +* uname:: Print system information | |
3c350007 | 462 | +* hostid:: Print numeric host identifier |
a839fc2f JB |
463 | |
464 | @command{date}: Print or set system date and time | |
465 | ||
3c350007 | 466 | @@ -416,24 +400,20 @@ |
a839fc2f JB |
467 | |
468 | Modified command invocation | |
469 | ||
470 | -* chroot invocation:: Run a command with a different root directory | |
471 | -* env invocation:: Run a command in a modified environment | |
c2be74f0 | 472 | -* nice invocation:: Run a command with modified niceness |
a839fc2f | 473 | -* nohup invocation:: Run a command immune to hangups |
c2be74f0 | 474 | -* su invocation:: Run a command with substitute user and group ID |
a839fc2f JB |
475 | - |
476 | -Process control | |
477 | - | |
478 | -* kill invocation:: Sending a signal to processes. | |
479 | +* chroot:: Run a command with a different root directory | |
480 | +* env:: Run a command in a modified environment | |
c2be74f0 | 481 | +* nice:: Run a command with modified niceness |
a839fc2f | 482 | +* nohup:: Run a command immune to hangups |
c2be74f0 | 483 | +* su:: Run a command with substitute user and group ID |
a839fc2f JB |
484 | |
485 | Delaying | |
486 | ||
487 | -* sleep invocation:: Delay for a specified time | |
488 | +* sleep:: Delay for a specified time | |
489 | ||
490 | Numeric operations | |
491 | ||
492 | -* factor invocation:: Print prime factors | |
493 | -* seq invocation:: Print numeric sequences | |
494 | +* factor:: Print prime factors | |
495 | +* seq:: Print numeric sequences | |
496 | ||
497 | File permissions | |
498 | ||
3c350007 | 499 | @@ -1276,14 +1256,14 @@ |
a839fc2f JB |
500 | in some way. |
501 | ||
502 | @menu | |
503 | -* cat invocation:: Concatenate and write files. | |
504 | -* tac invocation:: Concatenate and write files in reverse. | |
505 | -* nl invocation:: Number lines and write files. | |
506 | -* od invocation:: Write files in octal or other formats. | |
c2be74f0 | 507 | -* base64 invocation:: Transform data into printable data. |
a839fc2f JB |
508 | +* cat:: Concatenate and write files. |
509 | +* tac:: Concatenate and write files in reverse. | |
510 | +* nl:: Number lines and write files. | |
511 | +* od:: Write files in octal or other formats. | |
c2be74f0 | 512 | +* base64:: Transform data into printable data. |
a839fc2f JB |
513 | @end menu |
514 | ||
515 | -@node cat invocation | |
516 | +@node cat | |
517 | @section @command{cat}: Concatenate and write files | |
518 | ||
519 | @pindex cat | |
3c350007 | 520 | @@ -1382,7 +1362,7 @@ |
c2be74f0 | 521 | @end smallexample |
a839fc2f JB |
522 | |
523 | ||
524 | -@node tac invocation | |
525 | +@node tac | |
526 | @section @command{tac}: Concatenate and write files in reverse | |
527 | ||
528 | @pindex tac | |
3c350007 | 529 | @@ -1431,7 +1411,7 @@ |
876a8767 | 530 | @exitstatus |
a839fc2f JB |
531 | |
532 | ||
533 | -@node nl invocation | |
534 | +@node nl | |
535 | @section @command{nl}: Number lines and write files | |
536 | ||
537 | @pindex nl | |
3c350007 | 538 | @@ -1594,7 +1574,7 @@ |
876a8767 | 539 | @exitstatus |
a839fc2f JB |
540 | |
541 | ||
542 | -@node od invocation | |
543 | +@node od | |
544 | @section @command{od}: Write files in octal or other formats | |
545 | ||
546 | @pindex od | |
3c350007 | 547 | @@ -1850,7 +1830,7 @@ |
c2be74f0 JB |
548 | |
549 | @exitstatus | |
550 | ||
551 | -@node base64 invocation | |
552 | +@node base64 | |
553 | @section @command{base64}: Transform data into printable data. | |
554 | ||
555 | @pindex base64 | |
3c350007 | 556 | @@ -1917,13 +1897,13 @@ |
a839fc2f JB |
557 | These commands reformat the contents of files. |
558 | ||
559 | @menu | |
560 | -* fmt invocation:: Reformat paragraph text. | |
561 | -* pr invocation:: Paginate or columnate files for printing. | |
562 | -* fold invocation:: Wrap input lines to fit in specified width. | |
563 | +* fmt:: Reformat paragraph text. | |
564 | +* pr:: Paginate or columnate files for printing. | |
565 | +* fold:: Wrap input lines to fit in specified width. | |
566 | @end menu | |
567 | ||
568 | ||
569 | -@node fmt invocation | |
570 | +@node fmt | |
571 | @section @command{fmt}: Reformat paragraph text | |
572 | ||
573 | @pindex fmt | |
3c350007 | 574 | @@ -2022,7 +2002,7 @@ |
876a8767 | 575 | @exitstatus |
a839fc2f JB |
576 | |
577 | ||
578 | -@node pr invocation | |
579 | +@node pr | |
580 | @section @command{pr}: Paginate or columnate files for printing | |
581 | ||
582 | @pindex pr | |
3c350007 | 583 | @@ -2162,7 +2142,7 @@ |
a839fc2f JB |
584 | @cindex time formats |
585 | @cindex formatting times | |
586 | Format header dates using @var{format}, using the same conventions as | |
c2be74f0 JB |
587 | -for the command @samp{date +@var{format}}; @xref{date invocation}. |
588 | +for the command @samp{date +@var{format}}; @xref{date}. | |
a839fc2f JB |
589 | Except for directives, which start with |
590 | @samp{%}, characters in @var{format} are printed unchanged. You can use | |
591 | this option to specify an arbitrary string in place of the header date, | |
3c350007 | 592 | @@ -2389,7 +2369,7 @@ |
876a8767 | 593 | @exitstatus |
a839fc2f JB |
594 | |
595 | ||
596 | -@node fold invocation | |
597 | +@node fold | |
598 | @section @command{fold}: Wrap input lines to fit in specified width | |
599 | ||
600 | @pindex fold | |
3c350007 | 601 | @@ -2456,13 +2436,13 @@ |
a839fc2f JB |
602 | These commands output pieces of the input. |
603 | ||
604 | @menu | |
605 | -* head invocation:: Output the first part of files. | |
606 | -* tail invocation:: Output the last part of files. | |
607 | -* split invocation:: Split a file into fixed-size pieces. | |
608 | -* csplit invocation:: Split a file into context-determined pieces. | |
609 | +* head:: Output the first part of files. | |
610 | +* tail:: Output the last part of files. | |
611 | +* split:: Split a file into fixed-size pieces. | |
612 | +* csplit:: Split a file into context-determined pieces. | |
613 | @end menu | |
614 | ||
615 | -@node head invocation | |
616 | +@node head | |
617 | @section @command{head}: Output the first part of files | |
618 | ||
619 | @pindex head | |
3c350007 | 620 | @@ -2543,7 +2523,7 @@ |
876a8767 JB |
621 | @exitstatus |
622 | ||
a839fc2f JB |
623 | |
624 | -@node tail invocation | |
625 | +@node tail | |
626 | @section @command{tail}: Output the last part of files | |
627 | ||
628 | @pindex tail | |
3c350007 | 629 | @@ -2758,7 +2738,7 @@ |
876a8767 JB |
630 | @exitstatus |
631 | ||
a839fc2f JB |
632 | |
633 | -@node split invocation | |
634 | +@node split | |
635 | @section @command{split}: Split a file into fixed-size pieces | |
636 | ||
637 | @pindex split | |
3c350007 | 638 | @@ -2845,7 +2825,7 @@ |
876a8767 | 639 | @exitstatus |
a839fc2f JB |
640 | |
641 | ||
642 | -@node csplit invocation | |
643 | +@node csplit | |
644 | @section @command{csplit}: Split a file into context-determined pieces | |
645 | ||
646 | @pindex csplit | |
3c350007 | 647 | @@ -2985,16 +2965,16 @@ |
a839fc2f JB |
648 | contents of files. |
649 | ||
650 | @menu | |
876a8767 | 651 | -* wc invocation:: Print newline, word, and byte counts. |
a839fc2f JB |
652 | -* sum invocation:: Print checksum and block counts. |
653 | -* cksum invocation:: Print CRC checksum and byte counts. | |
c2be74f0 JB |
654 | -* md5sum invocation:: Print or check MD5 digests. |
655 | -* sha1sum invocation:: Print or check SHA-1 digests. | |
656 | -* sha2 utilities:: Print or check SHA-2 digests. | |
876a8767 | 657 | +* wc:: Print newline, word, and byte counts. |
a839fc2f JB |
658 | +* sum:: Print checksum and block counts. |
659 | +* cksum:: Print CRC checksum and byte counts. | |
c2be74f0 JB |
660 | +* md5sum:: Print or check MD5 digests. |
661 | +* sha1sum:: Print or check SHA-1 digests. | |
662 | +* sha2:: Print or check SHA-2 digests. | |
a839fc2f JB |
663 | @end menu |
664 | ||
665 | ||
666 | -@node wc invocation | |
667 | +@node wc | |
876a8767 | 668 | @section @command{wc}: Print newline, word, and byte counts |
a839fc2f JB |
669 | |
670 | @pindex wc | |
3c350007 | 671 | @@ -3101,7 +3081,7 @@ |
876a8767 | 672 | @exitstatus |
a839fc2f JB |
673 | |
674 | ||
675 | -@node sum invocation | |
676 | +@node sum | |
677 | @section @command{sum}: Print checksum and block counts | |
678 | ||
679 | @pindex sum | |
3c350007 | 680 | @@ -3152,7 +3132,7 @@ |
876a8767 | 681 | @exitstatus |
a839fc2f JB |
682 | |
683 | ||
684 | -@node cksum invocation | |
685 | +@node cksum | |
686 | @section @command{cksum}: Print CRC checksum and byte counts | |
687 | ||
688 | @pindex cksum | |
3c350007 | 689 | @@ -3186,7 +3166,7 @@ |
876a8767 | 690 | @exitstatus |
a839fc2f JB |
691 | |
692 | ||
693 | -@node md5sum invocation | |
694 | +@node md5sum | |
c2be74f0 | 695 | @section @command{md5sum}: Print or check MD5 digests |
a839fc2f JB |
696 | |
697 | @pindex md5sum | |
3c350007 | 698 | @@ -3208,8 +3188,8 @@ |
c2be74f0 JB |
699 | considered infeasible at the moment, it is known how to produce |
700 | different files with identical MD5 (a ``collision''), something which | |
701 | can be a security issue in certain contexts. For more secure hashes, | |
702 | -consider using SHA-1 or SHA-2. @xref{sha1sum invocation}, and | |
703 | -@ref{sha2 utilities}. | |
704 | +consider using SHA-1 or SHA-2. @xref{sha1sum}, and | |
705 | +@ref{sha2}. | |
706 | ||
707 | If a @var{file} is specified as @samp{-} or if no files are given | |
708 | @command{md5sum} computes the checksum for the standard input. | |
3c350007 | 709 | @@ -3307,7 +3287,7 @@ |
c2be74f0 JB |
710 | @exitstatus |
711 | ||
712 | ||
713 | -@node sha1sum invocation | |
714 | +@node sha1sum | |
715 | @section @command{sha1sum}: Print or check SHA-1 digests | |
716 | ||
717 | @pindex sha1sum | |
3c350007 | 718 | @@ -3319,17 +3299,17 @@ |
c2be74f0 JB |
719 | |
720 | @command{sha1sum} computes a 160-bit checksum for each specified | |
721 | @var{file}. The usage and options of this command are precisely the | |
722 | -same as for @command{md5sum}. @xref{md5sum invocation}. | |
723 | +same as for @command{md5sum}. @xref{md5sum}. | |
724 | ||
725 | Note: The SHA-1 digest is more secure than MD5, and no collisions of | |
726 | it are known (different files having the same fingerprint). However, | |
727 | it is known that they can be produced with considerable, but not | |
728 | unreasonable, resources. For this reason, it is generally considered | |
729 | that SHA-1 should be gradually phased out in favor of the more secure | |
730 | -SHA-2 hash algorithms. @xref{sha2 utilities}. | |
731 | +SHA-2 hash algorithms. @xref{sha2}. | |
732 | ||
733 | ||
734 | -@node sha2 utilities | |
735 | +@node sha2 | |
736 | @section sha2 utilities: Print or check SHA-2 digests | |
737 | ||
738 | @pindex sha224sum | |
3c350007 | 739 | @@ -3359,7 +3339,7 @@ |
c2be74f0 JB |
740 | various lengths (respectively 224, 256, 384 and 512 bits), |
741 | collectively known as the SHA-2 hashes. The usage and options of | |
742 | these commands are precisely the same as for @command{md5sum}. | |
743 | -@xref{md5sum invocation}. | |
744 | +@xref{md5sum}. | |
745 | ||
746 | Note: The SHA384 and SHA512 digests are considerably slower to | |
747 | compute, especially on 32-bit computers, than SHA224 or SHA256. | |
3c350007 | 748 | @@ -3374,17 +3354,17 @@ |
a839fc2f JB |
749 | These commands work with (or produce) sorted files. |
750 | ||
751 | @menu | |
752 | -* sort invocation:: Sort text files. | |
c2be74f0 | 753 | -* shuf invocation:: Shuffle text files. |
a839fc2f JB |
754 | -* uniq invocation:: Uniquify files. |
755 | -* comm invocation:: Compare two sorted files line by line. | |
756 | -* ptx invocation:: Produce a permuted index of file contents. | |
757 | -* tsort invocation:: Topological sort. | |
758 | +* sort:: Sort text files. | |
c2be74f0 | 759 | +* shuf:: Shuffle text files. |
a839fc2f JB |
760 | +* uniq:: Uniquify files. |
761 | +* comm:: Compare two sorted files line by line. | |
762 | +* ptx:: Produce a permuted index of file contents. | |
763 | +* tsort:: Topological sort. | |
764 | * tsort background:: Where tsort came from. | |
765 | @end menu | |
766 | ||
767 | ||
768 | -@node sort invocation | |
769 | +@node sort | |
770 | @section @command{sort}: Sort text files | |
771 | ||
772 | @pindex sort | |
3c350007 | 773 | @@ -3629,7 +3609,7 @@ |
c2be74f0 JB |
774 | Sort by hashing the input keys and then sorting the hash values. |
775 | Choose the hash function at random, ensuring that it is free of | |
776 | collisions so that differing keys have differing hash values. This is | |
777 | -like a random permutation of the inputs (@pxref{shuf invocation}), | |
778 | +like a random permutation of the inputs (@pxref{shuf}), | |
779 | except that keys with the same value sort together. | |
780 | ||
781 | If multiple random sort fields are specified, the same random hash | |
3c350007 | 782 | @@ -3792,7 +3772,7 @@ |
c2be74f0 JB |
783 | this equivalence does not extend to arbitrary @command{sort} options. |
784 | For example, @code{sort -n -u} inspects only the value of the initial | |
785 | numeric string when checking for uniqueness, whereas @code{sort -n | | |
786 | -uniq} inspects the entire line. @xref{uniq invocation}. | |
787 | +uniq} inspects the entire line. @xref{uniq}. | |
788 | ||
789 | @item -z | |
790 | @itemx --zero-terminated | |
3c350007 | 791 | @@ -3985,7 +3965,7 @@ |
a839fc2f JB |
792 | @end itemize |
793 | ||
794 | ||
c2be74f0 JB |
795 | -@node shuf invocation |
796 | +@node shuf | |
797 | @section @command{shuf}: Shuffling text | |
798 | ||
799 | @pindex shuf | |
3c350007 | 800 | @@ -4126,7 +4106,7 @@ |
c2be74f0 JB |
801 | @exitstatus |
802 | ||
803 | ||
a839fc2f JB |
804 | -@node uniq invocation |
805 | +@node uniq | |
806 | @section @command{uniq}: Uniquify files | |
807 | ||
808 | @pindex uniq | |
3c350007 | 809 | @@ -4148,7 +4128,7 @@ |
c2be74f0 JB |
810 | The input need not be sorted, but repeated input lines are detected |
811 | only if they are adjacent. If you want to discard non-adjacent | |
812 | duplicate lines, perhaps you want to use @code{sort -u}. | |
813 | -@xref{sort invocation}. | |
814 | +@xref{sort}. | |
815 | ||
816 | @vindex LC_COLLATE | |
817 | Comparisons use the character collating sequence specified by the | |
3c350007 | 818 | @@ -4286,7 +4266,7 @@ |
876a8767 | 819 | @exitstatus |
a839fc2f JB |
820 | |
821 | ||
822 | -@node comm invocation | |
823 | +@node comm | |
824 | @section @command{comm}: Compare two sorted files line by line | |
825 | ||
826 | @pindex comm | |
3c350007 | 827 | @@ -4329,7 +4309,7 @@ |
a839fc2f JB |
828 | If there is an error it exits with nonzero status. |
829 | ||
830 | ||
831 | -@node tsort invocation | |
832 | +@node tsort | |
833 | @section @command{tsort}: Topological sort | |
834 | ||
835 | @pindex tsort | |
3c350007 | 836 | @@ -4483,7 +4463,7 @@ |
876a8767 JB |
837 | @exitstatus |
838 | ||
a839fc2f JB |
839 | |
840 | -@node ptx invocation | |
841 | +@node ptx | |
842 | @section @command{ptx}: Produce permuted indexes | |
843 | ||
844 | @pindex ptx | |
3c350007 | 845 | @@ -4942,13 +4922,13 @@ |
a839fc2f JB |
846 | @chapter Operating on fields within a line |
847 | ||
848 | @menu | |
849 | -* cut invocation:: Print selected parts of lines. | |
850 | -* paste invocation:: Merge lines of files. | |
851 | -* join invocation:: Join lines on a common field. | |
852 | +* cut:: Print selected parts of lines. | |
853 | +* paste:: Merge lines of files. | |
854 | +* join:: Join lines on a common field. | |
855 | @end menu | |
856 | ||
857 | ||
858 | -@node cut invocation | |
859 | +@node cut | |
860 | @section @command{cut}: Print selected parts of lines | |
861 | ||
862 | @pindex cut | |
3c350007 | 863 | @@ -5047,7 +5027,7 @@ |
876a8767 | 864 | @exitstatus |
a839fc2f JB |
865 | |
866 | ||
867 | -@node paste invocation | |
868 | +@node paste | |
869 | @section @command{paste}: Merge lines of files | |
870 | ||
871 | @pindex paste | |
3c350007 | 872 | @@ -5117,7 +5097,7 @@ |
876a8767 | 873 | @exitstatus |
a839fc2f JB |
874 | |
875 | ||
876 | -@node join invocation | |
877 | +@node join | |
878 | @section @command{join}: Join lines on a common field | |
879 | ||
880 | @pindex join | |
3c350007 | 881 | @@ -5260,13 +5240,13 @@ |
a839fc2f JB |
882 | This commands operate on individual characters. |
883 | ||
884 | @menu | |
885 | -* tr invocation:: Translate, squeeze, and/or delete characters. | |
886 | -* expand invocation:: Convert tabs to spaces. | |
887 | -* unexpand invocation:: Convert spaces to tabs. | |
888 | +* tr:: Translate, squeeze, and/or delete characters. | |
889 | +* expand:: Convert tabs to spaces. | |
890 | +* unexpand:: Convert spaces to tabs. | |
891 | @end menu | |
892 | ||
893 | ||
894 | -@node tr invocation | |
895 | +@node tr | |
896 | @section @command{tr}: Translate, squeeze, and/or delete characters | |
897 | ||
898 | @pindex tr | |
3c350007 | 899 | @@ -5644,7 +5624,7 @@ |
c2be74f0 | 900 | @end itemize |
a839fc2f JB |
901 | |
902 | ||
903 | -@node expand invocation | |
904 | +@node expand | |
905 | @section @command{expand}: Convert tabs to spaces | |
906 | ||
907 | @pindex expand | |
3c350007 | 908 | @@ -5697,7 +5677,7 @@ |
876a8767 | 909 | @exitstatus |
a839fc2f JB |
910 | |
911 | ||
912 | -@node unexpand invocation | |
913 | +@node unexpand | |
914 | @section @command{unexpand}: Convert spaces to tabs | |
915 | ||
916 | @pindex unexpand | |
3c350007 | 917 | @@ -5758,14 +5738,14 @@ |
a839fc2f JB |
918 | and @command{vdir}, which list information about files. |
919 | ||
920 | @menu | |
921 | -* ls invocation:: List directory contents. | |
922 | -* dir invocation:: Briefly ls. | |
923 | -* vdir invocation:: Verbosely ls. | |
924 | -* dircolors invocation:: Color setup for ls, etc. | |
925 | +* ls:: List directory contents. | |
926 | +* dir:: Briefly ls. | |
927 | +* vdir:: Verbosely ls. | |
928 | +* dircolors:: Color setup for ls, etc. | |
929 | @end menu | |
930 | ||
931 | ||
932 | -@node ls invocation | |
933 | +@node ls | |
934 | @section @command{ls}: List directory contents | |
935 | ||
936 | @pindex ls | |
3c350007 | 937 | @@ -6570,7 +6550,7 @@ |
a839fc2f JB |
938 | @item +@var{format} |
939 | @vindex LC_TIME | |
940 | List timestamps using @var{format}, where @var{format} is interpreted | |
941 | -like the format argument of @command{date} (@pxref{date invocation}). | |
942 | +like the format argument of @command{date} (@pxref{date}). | |
fbb5b105 | 943 | For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes |
a839fc2f JB |
944 | @command{ls} to list timestamps like @samp{2002-03-30 23:45:56}. As |
945 | with @command{date}, @var{format}'s interpretation is affected by the | |
3c350007 | 946 | @@ -6762,7 +6742,7 @@ |
a839fc2f JB |
947 | @end table |
948 | ||
949 | ||
950 | -@node dir invocation | |
951 | +@node dir | |
952 | @section @command{dir}: Briefly list directory contents | |
953 | ||
954 | @pindex dir | |
3c350007 | 955 | @@ -6772,10 +6752,10 @@ |
a839fc2f JB |
956 | -b}; that is, by default files are listed in columns, sorted vertically, |
957 | and special characters are represented by backslash escape sequences. | |
958 | ||
959 | -@xref{ls invocation, @command{ls}}. | |
960 | +@xref{ls, @command{ls}}. | |
961 | ||
962 | ||
963 | -@node vdir invocation | |
964 | +@node vdir | |
965 | @section @command{vdir}: Verbosely list directory contents | |
966 | ||
967 | @pindex vdir | |
3c350007 | 968 | @@ -6785,7 +6765,7 @@ |
a839fc2f JB |
969 | -b}; that is, by default files are listed in long format and special |
970 | characters are represented by backslash escape sequences. | |
971 | ||
972 | -@node dircolors invocation | |
973 | +@node dircolors | |
fbb5b105 | 974 | @section @command{dircolors}: Color setup for @command{ls} |
a839fc2f JB |
975 | |
976 | @pindex dircolors | |
3c350007 | 977 | @@ -6863,16 +6843,16 @@ |
a839fc2f JB |
978 | copying, moving (renaming), and deleting (removing). |
979 | ||
980 | @menu | |
981 | -* cp invocation:: Copy files. | |
982 | -* dd invocation:: Convert and copy a file. | |
983 | -* install invocation:: Copy files and set attributes. | |
984 | -* mv invocation:: Move (rename) files. | |
985 | -* rm invocation:: Remove files or directories. | |
986 | -* shred invocation:: Remove files more securely. | |
987 | +* cp:: Copy files. | |
988 | +* dd:: Convert and copy a file. | |
989 | +* install:: Copy files and set attributes. | |
990 | +* mv:: Move (rename) files. | |
991 | +* rm:: Remove files or directories. | |
992 | +* shred:: Remove files more securely. | |
993 | @end menu | |
994 | ||
995 | ||
996 | -@node cp invocation | |
997 | +@node cp | |
998 | @section @command{cp}: Copy files and directories | |
999 | ||
1000 | @pindex cp | |
3c350007 | 1001 | @@ -7251,7 +7231,7 @@ |
876a8767 | 1002 | @exitstatus |
a839fc2f JB |
1003 | |
1004 | ||
1005 | -@node dd invocation | |
1006 | +@node dd | |
1007 | @section @command{dd}: Convert and copy a file | |
1008 | ||
1009 | @pindex dd | |
3c350007 | 1010 | @@ -7580,7 +7560,7 @@ |
876a8767 | 1011 | @exitstatus |
a839fc2f JB |
1012 | |
1013 | ||
1014 | -@node install invocation | |
1015 | +@node install | |
1016 | @section @command{install}: Copy files and set attributes | |
1017 | ||
1018 | @pindex install | |
3c350007 | 1019 | @@ -7726,7 +7706,7 @@ |
876a8767 | 1020 | @exitstatus |
a839fc2f JB |
1021 | |
1022 | ||
1023 | -@node mv invocation | |
1024 | +@node mv | |
1025 | @section @command{mv}: Move (rename) files | |
1026 | ||
1027 | @pindex mv | |
3c350007 | 1028 | @@ -7847,7 +7827,7 @@ |
876a8767 | 1029 | @exitstatus |
a839fc2f JB |
1030 | |
1031 | ||
1032 | -@node rm invocation | |
1033 | +@node rm | |
1034 | @section @command{rm}: Remove files or directories | |
1035 | ||
1036 | @pindex rm | |
3c350007 | 1037 | @@ -8001,7 +7981,7 @@ |
876a8767 | 1038 | @exitstatus |
a839fc2f JB |
1039 | |
1040 | ||
1041 | -@node shred invocation | |
1042 | +@node shred | |
1043 | @section @command{shred}: Remove files more securely | |
1044 | ||
1045 | @pindex shred | |
3c350007 | 1046 | @@ -8011,7 +7991,7 @@ |
a839fc2f JB |
1047 | @command{shred} overwrites devices or files, to help prevent even |
1048 | very expensive hardware from recovering the data. | |
1049 | ||
1050 | -Ordinarily when you remove a file (@pxref{rm invocation}), the data is | |
1051 | +Ordinarily when you remove a file (@pxref{rm}), the data is | |
1052 | not actually destroyed. Only the index listing where the file is | |
1053 | stored is destroyed, and the storage is made available for reuse. | |
1054 | There are undelete utilities that will attempt to reconstruct the index | |
3c350007 | 1055 | @@ -8243,18 +8223,18 @@ |
a839fc2f JB |
1056 | (FIFOs), symbolic links, sockets, and so-called @dfn{special files}. |
1057 | ||
1058 | @menu | |
1059 | -* link invocation:: Make a hard link via the link syscall | |
1060 | -* ln invocation:: Make links between files. | |
1061 | -* mkdir invocation:: Make directories. | |
1062 | -* mkfifo invocation:: Make FIFOs (named pipes). | |
1063 | -* mknod invocation:: Make block or character special files. | |
fbb5b105 | 1064 | -* readlink invocation:: Print the referent of a symbolic link. |
a839fc2f JB |
1065 | -* rmdir invocation:: Remove empty directories. |
1066 | -* unlink invocation:: Remove files via the unlink syscall | |
3c350007 | 1067 | +* link:: Make a hard link via the link syscall. |
a839fc2f JB |
1068 | +* ln:: Make links between files. |
1069 | +* mkdir:: Make directories. | |
1070 | +* mkfifo:: Make FIFOs (named pipes). | |
1071 | +* mknod:: Make block or character special files. | |
fbb5b105 | 1072 | +* readlink:: Print the referent of a symbolic link. |
a839fc2f | 1073 | +* rmdir:: Remove empty directories. |
fbb5b105 | 1074 | +* unlink:: Remove files via the unlink syscall. |
a839fc2f JB |
1075 | @end menu |
1076 | ||
1077 | ||
1078 | -@node link invocation | |
1079 | +@node link | |
1080 | @section @command{link}: Make a hard link via the link syscall | |
1081 | ||
1082 | @pindex link | |
3c350007 | 1083 | @@ -8267,7 +8247,7 @@ |
c2be74f0 JB |
1084 | @code{link} function. @xref{Hard Links, , , libc, |
1085 | The GNU C Library Reference Manual}. | |
1086 | It avoids the bells and whistles of the more commonly-used | |
1087 | -@command{ln} command (@pxref{ln invocation}). | |
1088 | +@command{ln} command (@pxref{ln}). | |
1089 | Synopsis: | |
1090 | ||
1091 | @example | |
3c350007 | 1092 | @@ -8288,7 +8268,7 @@ |
876a8767 JB |
1093 | @exitstatus |
1094 | ||
a839fc2f JB |
1095 | |
1096 | -@node ln invocation | |
1097 | +@node ln | |
1098 | @section @command{ln}: Make links between files | |
1099 | ||
1100 | @pindex ln | |
3c350007 | 1101 | @@ -8460,7 +8440,7 @@ |
c2be74f0 | 1102 | @end smallexample |
a839fc2f JB |
1103 | |
1104 | ||
1105 | -@node mkdir invocation | |
1106 | +@node mkdir | |
1107 | @section @command{mkdir}: Make directories | |
1108 | ||
1109 | @pindex mkdir | |
3c350007 | 1110 | @@ -8530,7 +8510,7 @@ |
876a8767 | 1111 | @exitstatus |
a839fc2f JB |
1112 | |
1113 | ||
1114 | -@node mkfifo invocation | |
1115 | +@node mkfifo | |
1116 | @section @command{mkfifo}: Make FIFOs (named pipes) | |
1117 | ||
1118 | @pindex mkfifo | |
3c350007 | 1119 | @@ -8569,7 +8549,7 @@ |
876a8767 | 1120 | @exitstatus |
a839fc2f JB |
1121 | |
1122 | ||
1123 | -@node mknod invocation | |
1124 | +@node mknod | |
1125 | @section @command{mknod}: Make block or character special files | |
1126 | ||
1127 | @pindex mknod | |
3c350007 | 1128 | @@ -8641,7 +8621,7 @@ |
876a8767 | 1129 | @exitstatus |
a839fc2f JB |
1130 | |
1131 | ||
fbb5b105 JB |
1132 | -@node readlink invocation |
1133 | +@node readlink | |
1134 | @section @command{readlink}: Print the referent of a symbolic link | |
1135 | ||
1136 | @pindex readlink | |
3c350007 | 1137 | @@ -8728,7 +8708,7 @@ |
876a8767 | 1138 | @exitstatus |
fbb5b105 JB |
1139 | |
1140 | ||
a839fc2f JB |
1141 | -@node rmdir invocation |
1142 | +@node rmdir | |
1143 | @section @command{rmdir}: Remove empty directories | |
1144 | ||
1145 | @pindex rmdir | |
3c350007 | 1146 | @@ -8776,12 +8756,12 @@ |
a839fc2f JB |
1147 | |
1148 | @end table | |
1149 | ||
1150 | -@xref{rm invocation}, for how to remove non-empty directories (recursively). | |
1151 | +@xref{rm}, for how to remove non-empty directories (recursively). | |
1152 | ||
876a8767 JB |
1153 | @exitstatus |
1154 | ||
1155 | ||
a839fc2f JB |
1156 | -@node unlink invocation |
1157 | +@node unlink | |
1158 | @section @command{unlink}: Remove files via the unlink syscall | |
1159 | ||
1160 | @pindex unlink | |
3c350007 | 1161 | @@ -8792,7 +8772,7 @@ |
c2be74f0 JB |
1162 | @code{unlink} function. @xref{Deleting Files, , , libc, |
1163 | The GNU C Library Reference Manual}. Synopsis: | |
1164 | It avoids the bells and whistles of the more commonly-used | |
1165 | -@command{rm} command (@pxref{rm invocation}). | |
1166 | +@command{rm} command (@pxref{rm}). | |
1167 | ||
1168 | @example | |
1169 | unlink @var{filename} | |
3c350007 | 1170 | @@ -8826,14 +8806,14 @@ |
a839fc2f JB |
1171 | These commands change file attributes. |
1172 | ||
1173 | @menu | |
1174 | -* chgrp invocation:: Change file groups. | |
1175 | -* chmod invocation:: Change access permissions. | |
1176 | -* chown invocation:: Change file owners and groups. | |
1177 | -* touch invocation:: Change file timestamps. | |
1178 | +* chgrp:: Change file groups. | |
1179 | +* chmod:: Change access permissions. | |
1180 | +* chown:: Change file owners and groups. | |
1181 | +* touch:: Change file timestamps. | |
1182 | @end menu | |
1183 | ||
1184 | ||
1185 | -@node chown invocation | |
1186 | +@node chown | |
1187 | @section @command{chown}: Change file owner and group | |
1188 | ||
1189 | @pindex chown | |
3c350007 | 1190 | @@ -9050,7 +9030,7 @@ |
c2be74f0 | 1191 | @end smallexample |
a839fc2f JB |
1192 | |
1193 | ||
1194 | -@node chgrp invocation | |
1195 | +@node chgrp | |
1196 | @section @command{chgrp}: Change group ownership | |
1197 | ||
1198 | @pindex chgrp | |
3c350007 | 1199 | @@ -9172,7 +9152,7 @@ |
c2be74f0 | 1200 | @end smallexample |
a839fc2f JB |
1201 | |
1202 | ||
1203 | -@node chmod invocation | |
1204 | +@node chmod | |
1205 | @section @command{chmod}: Change access permissions | |
1206 | ||
1207 | @pindex chmod | |
3c350007 | 1208 | @@ -9271,7 +9251,7 @@ |
876a8767 | 1209 | @exitstatus |
a839fc2f JB |
1210 | |
1211 | ||
1212 | -@node touch invocation | |
1213 | +@node touch | |
1214 | @section @command{touch}: Change file timestamps | |
1215 | ||
1216 | @pindex touch | |
3c350007 | 1217 | @@ -9421,14 +9401,14 @@ |
c2be74f0 | 1218 | file status information, and write buffers to disk. |
a839fc2f JB |
1219 | |
1220 | @menu | |
c2be74f0 | 1221 | -* df invocation:: Report file system disk space usage. |
a839fc2f | 1222 | -* du invocation:: Estimate file space usage. |
c2be74f0 | 1223 | -* stat invocation:: Report file or file system status. |
a839fc2f | 1224 | -* sync invocation:: Synchronize memory and disk. |
c2be74f0 | 1225 | +* df:: Report file system disk space usage. |
a839fc2f | 1226 | +* du:: Estimate file space usage. |
c2be74f0 | 1227 | +* stat:: Report file or file system status. |
a839fc2f JB |
1228 | +* sync:: Synchronize memory and disk. |
1229 | @end menu | |
1230 | ||
1231 | ||
1232 | -@node df invocation | |
1233 | +@node df | |
c2be74f0 | 1234 | @section @command{df}: Report file system disk space usage |
a839fc2f JB |
1235 | |
1236 | @pindex df | |
3c350007 | 1237 | @@ -9633,7 +9613,7 @@ |
c2be74f0 | 1238 | @samp{ext3} or @samp{reiserfs}. |
a839fc2f JB |
1239 | |
1240 | ||
1241 | -@node du invocation | |
1242 | +@node du | |
1243 | @section @command{du}: Estimate file space usage | |
1244 | ||
1245 | @pindex du | |
3c350007 | 1246 | @@ -9842,7 +9822,7 @@ |
c2be74f0 JB |
1247 | @item +@var{format} |
1248 | @vindex LC_TIME | |
1249 | List timestamps using @var{format}, where @var{format} is interpreted | |
1250 | -like the format argument of @command{date} (@pxref{date invocation}). | |
1251 | +like the format argument of @command{date} (@pxref{date}). | |
1252 | For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes | |
1253 | @command{du} to list timestamps like @samp{2002-03-30 23:45:56}. As | |
1254 | with @command{date}, @var{format}'s interpretation is affected by the | |
3c350007 | 1255 | @@ -9910,7 +9890,7 @@ |
876a8767 | 1256 | @exitstatus |
a839fc2f JB |
1257 | |
1258 | ||
1259 | -@node stat invocation | |
1260 | +@node stat | |
c2be74f0 | 1261 | @section @command{stat}: Report file or file system status |
a839fc2f JB |
1262 | |
1263 | @pindex stat | |
3c350007 | 1264 | @@ -10044,7 +10024,7 @@ |
876a8767 | 1265 | @exitstatus |
a839fc2f JB |
1266 | |
1267 | ||
1268 | -@node sync invocation | |
1269 | +@node sync | |
1270 | @section @command{sync}: Synchronize data on disk with memory | |
1271 | ||
1272 | @pindex sync | |
3c350007 | 1273 | @@ -10080,13 +10060,13 @@ |
a839fc2f JB |
1274 | This section describes commands that display text strings. |
1275 | ||
1276 | @menu | |
1277 | -* echo invocation:: Print a line of text. | |
1278 | -* printf invocation:: Format and print data. | |
1279 | -* yes invocation:: Print a string until interrupted. | |
1280 | +* echo:: Print a line of text. | |
1281 | +* printf:: Format and print data. | |
1282 | +* yes:: Print a string until interrupted. | |
1283 | @end menu | |
1284 | ||
1285 | ||
1286 | -@node echo invocation | |
1287 | +@node echo | |
1288 | @section @command{echo}: Print a line of text | |
1289 | ||
1290 | @pindex echo | |
3c350007 | 1291 | @@ -10169,12 +10149,12 @@ |
c2be74f0 JB |
1292 | @var{string} contains a backslash or if the first argument is |
1293 | @option{-n}. Portable programs can use the @command{printf} command | |
1294 | if they need to omit trailing newlines or output control characters or | |
1295 | -backslashes. @xref{printf invocation}. | |
1296 | +backslashes. @xref{printf}. | |
1297 | ||
876a8767 | 1298 | @exitstatus |
a839fc2f JB |
1299 | |
1300 | ||
1301 | -@node printf invocation | |
1302 | +@node printf | |
1303 | @section @command{printf}: Format and print data | |
1304 | ||
1305 | @pindex printf | |
3c350007 | 1306 | @@ -10317,7 +10297,7 @@ |
876a8767 | 1307 | @exitstatus |
a839fc2f JB |
1308 | |
1309 | ||
1310 | -@node yes invocation | |
1311 | +@node yes | |
1312 | @section @command{yes}: Print a string until interrupted | |
1313 | ||
1314 | @pindex yes | |
3c350007 | 1315 | @@ -10348,14 +10328,14 @@ |
a839fc2f JB |
1316 | pipeline. |
1317 | ||
1318 | @menu | |
1319 | -* false invocation:: Do nothing, unsuccessfully. | |
1320 | -* true invocation:: Do nothing, successfully. | |
1321 | -* test invocation:: Check file types and compare values. | |
1322 | -* expr invocation:: Evaluate expressions. | |
1323 | +* false:: Do nothing, unsuccessfully. | |
1324 | +* true:: Do nothing, successfully. | |
1325 | +* test:: Check file types and compare values. | |
1326 | +* expr:: Evaluate expressions. | |
1327 | @end menu | |
1328 | ||
1329 | ||
1330 | -@node false invocation | |
1331 | +@node false | |
1332 | @section @command{false}: Do nothing, unsuccessfully | |
1333 | ||
1334 | @pindex false | |
3c350007 | 1335 | @@ -10385,7 +10365,7 @@ |
c2be74f0 | 1336 | non-@acronym{GNU} hosts. |
a839fc2f JB |
1337 | |
1338 | ||
1339 | -@node true invocation | |
1340 | +@node true | |
1341 | @section @command{true}: Do nothing, successfully | |
1342 | ||
1343 | @pindex true | |
3c350007 | 1344 | @@ -10421,7 +10401,7 @@ |
a839fc2f JB |
1345 | more secure and faster than a shell script implementation, and may safely |
1346 | be used as a dummy shell for the purpose of disabling accounts. | |
1347 | ||
1348 | -@node test invocation | |
1349 | +@node test | |
1350 | @section @command{test}: Check file types and compare values | |
1351 | ||
1352 | @pindex test | |
3c350007 | 1353 | @@ -10752,7 +10732,7 @@ |
a839fc2f JB |
1354 | @end table |
1355 | ||
1356 | ||
1357 | -@node expr invocation | |
1358 | +@node expr | |
1359 | @section @command{expr}: Evaluate expressions | |
1360 | ||
1361 | @pindex expr | |
3c350007 | 1362 | @@ -11025,11 +11005,11 @@ |
a839fc2f JB |
1363 | it's described here. |
1364 | ||
1365 | @menu | |
3c350007 JB |
1366 | -* tee invocation:: Redirect output to multiple files or processes. |
1367 | +* tee:: Redirect output to multiple files or processes. | |
a839fc2f JB |
1368 | @end menu |
1369 | ||
1370 | ||
1371 | -@node tee invocation | |
1372 | +@node tee | |
3c350007 | 1373 | @section @command{tee}: Redirect output to multiple files or processes |
a839fc2f JB |
1374 | |
1375 | @pindex tee | |
3c350007 | 1376 | @@ -11190,13 +11170,13 @@ |
a839fc2f JB |
1377 | This section describes commands that manipulate file names. |
1378 | ||
1379 | @menu | |
1380 | -* basename invocation:: Strip directory and suffix from a file name. | |
1381 | -* dirname invocation:: Strip non-directory suffix from a file name. | |
1382 | -* pathchk invocation:: Check file name portability. | |
1383 | +* basename:: Strip directory and suffix from a file name. | |
1384 | +* dirname:: Strip non-directory suffix from a file name. | |
1385 | +* pathchk:: Check file name portability. | |
1386 | @end menu | |
1387 | ||
1388 | ||
1389 | -@node basename invocation | |
1390 | +@node basename | |
fbb5b105 | 1391 | @section @command{basename}: Strip directory and suffix from a file name |
a839fc2f JB |
1392 | |
1393 | @pindex basename | |
3c350007 | 1394 | @@ -11250,7 +11230,7 @@ |
c2be74f0 | 1395 | @end smallexample |
a839fc2f JB |
1396 | |
1397 | ||
1398 | -@node dirname invocation | |
1399 | +@node dirname | |
1400 | @section @command{dirname}: Strip non-directory suffix from a file name | |
1401 | ||
1402 | @pindex dirname | |
3c350007 | 1403 | @@ -11291,7 +11271,7 @@ |
c2be74f0 | 1404 | @end smallexample |
a839fc2f JB |
1405 | |
1406 | ||
1407 | -@node pathchk invocation | |
1408 | +@node pathchk | |
1409 | @section @command{pathchk}: Check file name portability | |
1410 | ||
1411 | @pindex pathchk | |
3c350007 | 1412 | @@ -11379,14 +11359,14 @@ |
a839fc2f JB |
1413 | so forth. See also the user-related commands in the next section. |
1414 | ||
1415 | @menu | |
1416 | -* pwd invocation:: Print working directory. | |
1417 | -* stty invocation:: Print or change terminal characteristics. | |
1418 | -* printenv invocation:: Print environment variables. | |
1419 | -* tty invocation:: Print file name of terminal on standard input. | |
1420 | +* pwd:: Print working directory. | |
1421 | +* stty:: Print or change terminal characteristics. | |
1422 | +* printenv:: Print environment variables. | |
1423 | +* tty:: Print file name of terminal on standard input. | |
1424 | @end menu | |
1425 | ||
1426 | ||
1427 | -@node pwd invocation | |
1428 | +@node pwd | |
1429 | @section @command{pwd}: Print working directory | |
1430 | ||
1431 | @pindex pwd | |
3c350007 | 1432 | @@ -11411,7 +11391,7 @@ |
876a8767 | 1433 | @exitstatus |
a839fc2f JB |
1434 | |
1435 | ||
1436 | -@node stty invocation | |
1437 | +@node stty | |
1438 | @section @command{stty}: Print or change terminal characteristics | |
1439 | ||
1440 | @pindex stty | |
3c350007 | 1441 | @@ -12070,7 +12050,7 @@ |
a839fc2f JB |
1442 | @end table |
1443 | ||
1444 | ||
1445 | -@node printenv invocation | |
1446 | +@node printenv | |
1447 | @section @command{printenv}: Print all or some environment variables | |
1448 | ||
1449 | @pindex printenv | |
3c350007 | 1450 | @@ -12100,7 +12080,7 @@ |
a839fc2f JB |
1451 | @end display |
1452 | ||
1453 | ||
1454 | -@node tty invocation | |
1455 | +@node tty | |
1456 | @section @command{tty}: Print file name of terminal on standard input | |
1457 | ||
1458 | @pindex tty | |
3c350007 | 1459 | @@ -12150,16 +12130,16 @@ |
a839fc2f JB |
1460 | logins, groups, and so forth. |
1461 | ||
1462 | @menu | |
c2be74f0 | 1463 | -* id invocation:: Print user identity. |
a839fc2f | 1464 | -* logname invocation:: Print current login name. |
c2be74f0 | 1465 | -* whoami invocation:: Print effective user ID. |
a839fc2f JB |
1466 | -* groups invocation:: Print group names a user is in. |
1467 | -* users invocation:: Print login names of users currently logged in. | |
1468 | -* who invocation:: Print who is currently logged in. | |
c2be74f0 | 1469 | +* id:: Print user identity. |
a839fc2f | 1470 | +* logname:: Print current login name. |
c2be74f0 | 1471 | +* whoami:: Print effective user ID. |
fc53c102 | 1472 | +* groups:: Print group names a user is in. |
a839fc2f JB |
1473 | +* users:: Print login names of users currently logged in. |
1474 | +* who:: Print who is currently logged in. | |
1475 | @end menu | |
1476 | ||
1477 | ||
1478 | -@node id invocation | |
1479 | +@node id | |
c2be74f0 | 1480 | @section @command{id}: Print user identity |
a839fc2f JB |
1481 | |
1482 | @pindex id | |
3c350007 | 1483 | @@ -12222,7 +12202,7 @@ |
876a8767 | 1484 | @exitstatus |
a839fc2f JB |
1485 | |
1486 | ||
1487 | -@node logname invocation | |
1488 | +@node logname | |
1489 | @section @command{logname}: Print current login name | |
1490 | ||
1491 | @pindex logname | |
3c350007 | 1492 | @@ -12243,7 +12223,7 @@ |
876a8767 | 1493 | @exitstatus |
a839fc2f JB |
1494 | |
1495 | ||
1496 | -@node whoami invocation | |
1497 | +@node whoami | |
c2be74f0 | 1498 | @section @command{whoami}: Print effective user ID |
a839fc2f JB |
1499 | |
1500 | @pindex whoami | |
3c350007 | 1501 | @@ -12259,7 +12239,7 @@ |
876a8767 | 1502 | @exitstatus |
a839fc2f JB |
1503 | |
1504 | ||
1505 | -@node groups invocation | |
fc53c102 JB |
1506 | +@node groups |
1507 | @section @command{groups}: Print group names a user is in | |
1508 | ||
1509 | @pindex groups | |
3c350007 | 1510 | @@ -12284,7 +12264,7 @@ |
876a8767 | 1511 | @exitstatus |
fc53c102 JB |
1512 | |
1513 | ||
a839fc2f JB |
1514 | -@node users invocation |
1515 | +@node users | |
1516 | @section @command{users}: Print login names of users currently logged in | |
1517 | ||
1518 | @pindex users | |
3c350007 | 1519 | @@ -12315,7 +12295,7 @@ |
876a8767 | 1520 | @exitstatus |
a839fc2f JB |
1521 | |
1522 | ||
1523 | -@node who invocation | |
1524 | +@node who | |
1525 | @section @command{who}: Print who is currently logged in | |
1526 | ||
1527 | @pindex who | |
3c350007 | 1528 | @@ -12462,15 +12442,14 @@ |
a839fc2f JB |
1529 | information. |
1530 | ||
1531 | @menu | |
3c350007 | 1532 | -* arch invocation:: Print machine hardware name. |
a839fc2f JB |
1533 | -* date invocation:: Print or set system date and time. |
1534 | -* uname invocation:: Print system information. | |
1535 | -* hostname invocation:: Print or set system name. | |
1536 | -* hostid invocation:: Print numeric host identifier. | |
3c350007 | 1537 | +* arch:: Print machine hardware name. |
a839fc2f JB |
1538 | +* date:: Print or set system date and time. |
1539 | +* uname:: Print system information. | |
1540 | +* hostid:: Print numeric host identifier. | |
1541 | @end menu | |
1542 | ||
1543 | ||
1544 | -@node date invocation | |
1545 | +@node date | |
1546 | @section @command{date}: Print or set system date and time | |
1547 | ||
1548 | @pindex date | |
3c350007 | 1549 | @@ -13098,7 +13077,7 @@ |
a839fc2f JB |
1550 | @end itemize |
1551 | ||
1552 | ||
3c350007 JB |
1553 | -@node arch invocation |
1554 | +@node arch | |
1555 | @section @command{arch}: Print machine hardware name | |
1556 | ||
1557 | @pindex arch | |
1558 | @@ -13118,7 +13097,7 @@ | |
1559 | @exitstatus | |
1560 | ||
1561 | ||
a839fc2f JB |
1562 | -@node uname invocation |
1563 | +@node uname | |
1564 | @section @command{uname}: Print system information | |
1565 | ||
1566 | @pindex uname | |
3c350007 | 1567 | @@ -13247,31 +13226,7 @@ |
876a8767 | 1568 | @exitstatus |
a839fc2f | 1569 | |
a839fc2f JB |
1570 | |
1571 | -@node hostname invocation | |
1572 | -@section @command{hostname}: Print or set system name | |
1573 | - | |
1574 | -@pindex hostname | |
1575 | -@cindex setting the hostname | |
1576 | -@cindex printing the hostname | |
1577 | -@cindex system name, printing | |
1578 | -@cindex appropriate privileges | |
1579 | - | |
1580 | -With no arguments, @command{hostname} prints the name of the current host | |
1581 | -system. With one argument, it sets the current host name to the | |
1582 | -specified string. You must have appropriate privileges to set the host | |
c2be74f0 | 1583 | -name. Synopsis: |
a839fc2f JB |
1584 | - |
1585 | -@example | |
1586 | -hostname [@var{name}] | |
1587 | -@end example | |
1588 | - | |
1589 | -The only options are @option{--help} and @option{--version}. @xref{Common | |
1590 | -options}. | |
1591 | - | |
876a8767 JB |
1592 | -@exitstatus |
1593 | - | |
a839fc2f JB |
1594 | - |
1595 | -@node hostid invocation | |
1596 | +@node hostid | |
1597 | @section @command{hostid}: Print numeric host identifier. | |
1598 | ||
1599 | @pindex hostid | |
3c350007 | 1600 | @@ -13308,15 +13263,15 @@ |
a839fc2f JB |
1601 | user, etc. |
1602 | ||
1603 | @menu | |
1604 | -* chroot invocation:: Modify the root directory. | |
1605 | -* env invocation:: Modify environment variables. | |
c2be74f0 | 1606 | -* nice invocation:: Modify niceness. |
a839fc2f | 1607 | -* nohup invocation:: Immunize to hangups. |
c2be74f0 | 1608 | -* su invocation:: Modify user and group ID. |
a839fc2f JB |
1609 | +* chroot:: Modify the root directory. |
1610 | +* env:: Modify environment variables. | |
c2be74f0 | 1611 | +* nice:: Modify niceness. |
a839fc2f | 1612 | +* nohup:: Immunize to hangups. |
c2be74f0 | 1613 | +* su:: Modify user and group ID. |
a839fc2f JB |
1614 | @end menu |
1615 | ||
1616 | ||
1617 | -@node chroot invocation | |
1618 | +@node chroot | |
1619 | @section @command{chroot}: Run a command with a different root directory | |
1620 | ||
1621 | @pindex chroot | |
3c350007 | 1622 | @@ -13387,7 +13342,7 @@ |
876a8767 | 1623 | @end display |
a839fc2f JB |
1624 | |
1625 | ||
1626 | -@node env invocation | |
1627 | +@node env | |
1628 | @section @command{env}: Run a command in a modified environment | |
1629 | ||
1630 | @pindex env | |
3c350007 | 1631 | @@ -13465,7 +13420,7 @@ |
876a8767 | 1632 | @end display |
a839fc2f JB |
1633 | |
1634 | ||
1635 | -@node nice invocation | |
1636 | +@node nice | |
c2be74f0 | 1637 | @section @command{nice}: Run a command with modified niceness |
a839fc2f JB |
1638 | |
1639 | @pindex nice | |
3c350007 | 1640 | @@ -13590,7 +13545,7 @@ |
876a8767 | 1641 | @end example |
a839fc2f JB |
1642 | |
1643 | ||
1644 | -@node nohup invocation | |
1645 | +@node nohup | |
1646 | @section @command{nohup}: Run a command immune to hangups | |
1647 | ||
1648 | @pindex nohup | |
3c350007 | 1649 | @@ -13659,7 +13614,7 @@ |
a839fc2f JB |
1650 | @end display |
1651 | ||
1652 | ||
1653 | -@node su invocation | |
1654 | +@node su | |
c2be74f0 | 1655 | @section @command{su}: Run a command with substitute user and group ID |
a839fc2f JB |
1656 | |
1657 | @pindex su | |
3c350007 | 1658 | @@ -13816,167 +13771,6 @@ |
fbb5b105 | 1659 | might find this idea strange at first. |
a839fc2f JB |
1660 | |
1661 | ||
1662 | -@node Process control | |
1663 | -@chapter Process control | |
1664 | - | |
1665 | -@cindex processes, commands for controlling | |
1666 | -@cindex commands for controlling processes | |
1667 | - | |
1668 | -@menu | |
1669 | -* kill invocation:: Sending a signal to processes. | |
1670 | -@end menu | |
1671 | - | |
1672 | - | |
1673 | -@node kill invocation | |
1674 | -@section @command{kill}: Send a signal to processes | |
1675 | - | |
1676 | -@pindex kill | |
1677 | -@cindex send a signal to processes | |
1678 | - | |
1679 | -The @command{kill} command sends a signal to processes, causing them | |
1680 | -to terminate or otherwise act upon receiving the signal in some way. | |
1681 | -Alternatively, it lists information about signals. Synopses: | |
1682 | - | |
1683 | -@example | |
1684 | -kill [-s @var{signal} | --signal @var{signal} | -@var{signal}] @var{pid}@dots{} | |
1685 | -kill [-l | --list | -t | --table] [@var{signal}]@dots{} | |
1686 | -@end example | |
1687 | - | |
1688 | -The first form of the @command{kill} command sends a signal to all | |
1689 | -@var{pid} arguments. The default signal to send if none is specified | |
1690 | -is @samp{TERM}. The special signal number @samp{0} does not denote a | |
1691 | -valid signal, but can be used to test whether the @var{pid} arguments | |
1692 | -specify processes to which a signal could be sent. | |
1693 | - | |
1694 | -If @var{pid} is positive, the signal is sent to the process with the | |
c2be74f0 | 1695 | -process ID @var{pid}. If @var{pid} is zero, the signal is sent to all |
a839fc2f | 1696 | -processes in the process group of the current process. If @var{pid} |
c2be74f0 JB |
1697 | -is @minus{}1, the signal is sent to all processes for which the user has |
1698 | -permission to send a signal. If @var{pid} is less than @minus{}1, the signal | |
a839fc2f JB |
1699 | -is sent to all processes in the process group that equals the absolute |
1700 | -value of @var{pid}. | |
1701 | - | |
1702 | -If @var{pid} is not positive, a system-dependent set of system | |
1703 | -processes is excluded from the list of processes to which the signal | |
1704 | -is sent. | |
1705 | - | |
c2be74f0 JB |
1706 | -If a negative @var{PID} argument is desired as the first one, it |
1707 | -should be preceded by @option{--}. However, as a common extension to | |
1708 | -@acronym{POSIX}, @option{--} is not required with @samp{kill | |
1709 | --@var{signal} -@var{pid}}. The following commands are equivalent: | |
a839fc2f JB |
1710 | - |
1711 | -@example | |
1712 | -kill -15 -1 | |
1713 | -kill -TERM -1 | |
c2be74f0 | 1714 | -kill -s TERM -- -1 |
a839fc2f JB |
1715 | -kill -- -1 |
1716 | -@end example | |
1717 | - | |
1718 | -The first form of the @command{kill} command succeeds if every @var{pid} | |
1719 | -argument specifies at least one process that the signal was sent to. | |
1720 | - | |
1721 | -The second form of the @command{kill} command lists signal information. | |
1722 | -Either the @option{-l} or @option{--list} option, or the @option{-t} | |
1723 | -or @option{--table} option must be specified. Without any | |
1724 | -@var{signal} argument, all supported signals are listed. The output | |
1725 | -of @option{-l} or @option{--list} is a list of the signal names, one | |
1726 | -per line; if @var{signal} is already a name, the signal number is | |
1727 | -printed instead. The output of @option{-t} or @option{--table} is a | |
1728 | -table of signal numbers, names, and descriptions. This form of the | |
1729 | -@command{kill} command succeeds if all @var{signal} arguments are valid | |
1730 | -and if there is no output error. | |
1731 | - | |
1732 | -The @command{kill} command also supports the @option{--help} and | |
1733 | -@option{--version} options. @xref{Common options}. | |
1734 | - | |
1735 | -A @var{signal} may be a signal name like @samp{HUP}, or a signal | |
1736 | -number like @samp{1}, or an exit status of a process terminated by the | |
1737 | -signal. A signal name can be given in canonical form or prefixed by | |
1738 | -@samp{SIG}. The case of the letters is ignored, except for the | |
1739 | -@option{-@var{signal}} option which must use upper case to avoid | |
1740 | -ambiguity with lower case option letters. The following signal names | |
1741 | -and numbers are supported on all @acronym{POSIX} compliant systems: | |
1742 | - | |
1743 | -@table @samp | |
1744 | -@item HUP | |
1745 | -1. Hangup. | |
1746 | -@item INT | |
1747 | -2. Terminal interrupt. | |
1748 | -@item QUIT | |
1749 | -3. Terminal quit. | |
1750 | -@item ABRT | |
1751 | -6. Process abort. | |
1752 | -@item KILL | |
1753 | -9. Kill (cannot be caught or ignored). | |
1754 | -@item ALRM | |
1755 | -14. Alarm Clock. | |
1756 | -@item TERM | |
1757 | -15. Termination. | |
1758 | -@end table | |
1759 | - | |
1760 | -@noindent | |
1761 | -Other supported signal names have system-dependent corresponding | |
1762 | -numbers. All systems conforming to @acronym{POSIX} 1003.1-2001 also | |
1763 | -support the following signals: | |
1764 | - | |
1765 | -@table @samp | |
1766 | -@item BUS | |
1767 | -Access to an undefined portion of a memory object. | |
1768 | -@item CHLD | |
1769 | -Child process terminated, stopped, or continued. | |
1770 | -@item CONT | |
1771 | -Continue executing, if stopped. | |
1772 | -@item FPE | |
1773 | -Erroneous arithmetic operation. | |
1774 | -@item ILL | |
1775 | -Illegal Instruction. | |
1776 | -@item PIPE | |
1777 | -Write on a pipe with no one to read it. | |
1778 | -@item SEGV | |
1779 | -Invalid memory reference. | |
1780 | -@item STOP | |
1781 | -Stop executing (cannot be caught or ignored). | |
1782 | -@item TSTP | |
1783 | -Terminal stop. | |
1784 | -@item TTIN | |
1785 | -Background process attempting read. | |
1786 | -@item TTOU | |
1787 | -Background process attempting write. | |
1788 | -@item URG | |
1789 | -High bandwidth data is available at a socket. | |
1790 | -@item USR1 | |
1791 | -User-defined signal 1. | |
1792 | -@item USR2 | |
1793 | -User-defined signal 2. | |
1794 | -@end table | |
1795 | - | |
1796 | -@noindent | |
1797 | -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XSI} extension | |
1798 | -also support the following signals: | |
1799 | - | |
1800 | -@table @samp | |
1801 | -@item POLL | |
1802 | -Pollable event. | |
1803 | -@item PROF | |
1804 | -Profiling timer expired. | |
1805 | -@item SYS | |
1806 | -Bad system call. | |
1807 | -@item TRAP | |
1808 | -Trace/breakpoint trap. | |
1809 | -@item VTALRM | |
1810 | -Virtual timer expired. | |
1811 | -@item XCPU | |
1812 | -CPU time limit exceeded. | |
1813 | -@item XFSZ | |
1814 | -File size limit exceeded. | |
1815 | -@end table | |
1816 | - | |
1817 | -@noindent | |
1818 | -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XRT} extension | |
1819 | -also support at least eight real-time signals called @samp{RTMIN}, | |
1820 | -@samp{RTMIN+1}, @dots{}, @samp{RTMAX-1}, @samp{RTMAX}. | |
1821 | - | |
1822 | - | |
1823 | @node Delaying | |
1824 | @chapter Delaying | |
1825 | ||
3c350007 | 1826 | @@ -13986,11 +13780,11 @@ |
fbb5b105 | 1827 | @c Perhaps @command{wait} or other commands should be described here also? |
a839fc2f JB |
1828 | |
1829 | @menu | |
1830 | -* sleep invocation:: Delay for a specified time. | |
1831 | +* sleep:: Delay for a specified time. | |
1832 | @end menu | |
1833 | ||
1834 | ||
1835 | -@node sleep invocation | |
1836 | +@node sleep | |
1837 | @section @command{sleep}: Delay for a specified time | |
1838 | ||
1839 | @pindex sleep | |
3c350007 | 1840 | @@ -14038,12 +13832,12 @@ |
a839fc2f JB |
1841 | These programs do numerically-related operations. |
1842 | ||
1843 | @menu | |
1844 | -* factor invocation:: Show factors of numbers. | |
1845 | -* seq invocation:: Print sequences of numbers. | |
1846 | +* factor:: Show factors of numbers. | |
1847 | +* seq:: Print sequences of numbers. | |
1848 | @end menu | |
1849 | ||
1850 | ||
1851 | -@node factor invocation | |
1852 | +@node factor | |
1853 | @section @command{factor}: Print prime factors | |
1854 | ||
1855 | @pindex factor | |
3c350007 | 1856 | @@ -14092,7 +13886,7 @@ |
876a8767 JB |
1857 | @exitstatus |
1858 | ||
a839fc2f JB |
1859 | |
1860 | -@node seq invocation | |
1861 | +@node seq | |
1862 | @section @command{seq}: Print numeric sequences | |
1863 | ||
1864 | @pindex seq |