home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / info / fileutils.info (.txt) < prev    next >
GNU Info File  |  1994-12-22  |  101KB  |  1,999 lines

  1. This is Info file fileutils.info, produced by Makeinfo-1.55 from the
  2. input file fileutils.texi.
  3. START-INFO-DIR-ENTRY
  4. * File utilities: (fileutils).  GNU file utilities.
  5. * chgrp: (fileutils)chgrp invocation.            Change file groups.
  6. * chown: (fileutils)chown invocation.            Change file owners/groups.
  7. * chmod: (fileutils)chmod invocation.            Change file permissions.
  8. * cp: (fileutils)cp invocation.                    Copy files.
  9. * dd: (fileutils)dd invocation.                    Copy and convert a file.
  10. * df: (fileutils)df invocation.                    Report filesystem disk usage.
  11. * dir: (fileutils)dir invocation.        List directories briefly.
  12. * du: (fileutils)du invocation.                    Report on disk usage.
  13. * install: (fileutils)install invocation.    Copy and change attributes.
  14. * ln: (fileutils)ln invocation.                    Make links between files.
  15. * ls: (fileutils)ls invocation.            List directory contents.
  16. * mkdir: (fileutils)mkdir invocation.            Create directories.
  17. * mkfifo: (fileutils)mkfifo invocation.            Create FIFOs: (named pipes).
  18. * mknod: (fileutils)mknod invocation.            Create special files.
  19. * mv: (fileutils)mv invocation.                    Rename files.
  20. * rm: (fileutils)rm invocation.                    Remove files.
  21. * rmdir: (fileutils)rmdir invocation.            Remove empty directories.
  22. * sync: (fileutils)sync invocation.            Synchronize memory and disk.
  23. * touch: (fileutils)touch invocation.            Change file timestamps.
  24. * vdir: (fileutils)vdir invocation.        List directories verbosely.
  25. END-INFO-DIR-ENTRY
  26.    This file documents the GNU set of file utilities.
  27.    Copyright (C) 1994 Free Software Foundation, Inc.
  28.    Permission is granted to make and distribute verbatim copies of this
  29. manual provided the copyright notice and this permission notice are
  30. preserved on all copies.
  31.    Permission is granted to copy and distribute modified versions of
  32. this manual under the conditions for verbatim copying, provided that
  33. the entire resulting derived work is distributed under the terms of a
  34. permission notice identical to this one.
  35.    Permission is granted to copy and distribute translations of this
  36. manual into another language, under the above conditions for modified
  37. versions, except that this permission notice may be stated in a
  38. translation approved by the Foundation.
  39. File: fileutils.info,  Node: Top,  Next: Introduction,  Prev: (DIR),  Up: (DIR)
  40. GNU file utilities
  41. ******************
  42.    This manual minimally documents version GNU fileutils 3.12 of the
  43. GNU file utilities.
  44. * Menu:
  45. * Introduction::        Caveats, overview, and authors.
  46. * Common options::              Common options.
  47. * File permissions::        Access modes.
  48. * Directory listing::           ls dir vdir d v
  49. * Basic operations::            cp dd install mv rm
  50. * Special file types::          ln mkdir rmdir mkfifo mknod
  51. * Changing file attributes::    chgrp chmod chown touch
  52. * Disk usage::                  df du sync
  53. * Index::                       General index.
  54. File: fileutils.info,  Node: Introduction,  Next: Common options,  Prev: Top,  Up: Top
  55. Introduction
  56. ************
  57.    This manual is incomplete: No attempt is made to explain basic file
  58. concepts in a way suitable for novices.  Thus, if you are interested,
  59. please get involved in improving this manual.  The entire GNU community
  60. will benefit.
  61.    The GNU file utilities are mostly compatible with the POSIX.2
  62. standard.
  63.    Please report bugs to `bug-gnu-utils@prep.ai.mit.edu'.  Remember to
  64. include the version number, machine architecture, input files, and any
  65. other information needed to reproduce the bug.  *Note Bugs: (gcc)Bugs.
  66.    This manual is based on the Unix man pages in the distribution, which
  67. were originally written by David MacKenzie and updated by Jim Meyering.
  68. Franc,ois Pinard did the initial conversion to Texinfo format.  Karl
  69. Berry did the indexing, some reorganization, and editing of the results.
  70. Richard Stallman contributed his usual invaluable insights to the
  71. overall process.
  72. File: fileutils.info,  Node: Common options,  Next: File permissions,  Prev: Introduction,  Up: Top
  73. Common options
  74. **************
  75.    Certain options are available in all these programs.  Rather than
  76. writing identical descriptions for each of the programs, they are
  77. described here.  (In fact, every GNU program accepts (or should accept)
  78. these options.)
  79. `--help'
  80.      Print a usage message listing all available options, then exit
  81.      successfully.
  82. `--version'
  83.      Print the version number, then exit successfully.
  84. * Menu:
  85. * Backup options::              -b -S -V, in some programs.
  86. File: fileutils.info,  Node: Backup options,  Up: Common options
  87. Backup options
  88. ==============
  89.    Some GNU programs (at least `cp', `mv', and `ln') optionally make
  90. backups of files before writing new versions.  These options control
  91. the details of these backups.  The options are also briefly mentioned
  92. in the descriptions of the particular programs.
  93. `--backup'
  94.      Make backups of files that are about to be overwritten or removed.
  95.      Without this option, the original versions are destroyed.
  96. `-S SUFFIX'
  97. `--suffix=SUFFIX'
  98.      Append SUFFIX to each backup file made with `-b'.  If this option
  99.      is not specified, the value of the `SIMPLE_BACKUP_SUFFIX'
  100.      environment variable is used.  And if `SIMPLE_BACKUP_SUFFIX' is not
  101.      set, the default is `~', just as in Emacs.
  102. `-V METHOD'
  103. `--version-control=METHOD'
  104.      Use METHOD to determine the type of backups made with `-b'.  If
  105.      this option is not specified, the value of the `VERSION_CONTROL'
  106.      environment variable is used.  And if `VERSION_CONTROL' is not set,
  107.      the default backup type is `existing'.
  108.      This option corresponds to the Emacs variable `version-control';
  109.      the same values for METHOD are accepted as in Emacs.  This options
  110.      also more descriptive name.  The valid METHODs (unique
  111.      abbreviations are accepted):
  112.     `t'
  113.     `numbered'
  114.           Always make numbered backups.
  115.     `nil'
  116.     `existing'
  117.           Make numbered backups of files that already have them, simple
  118.           backups of the others.
  119.     `never'
  120.     `simple'
  121.           Always make simple backups.
  122. File: fileutils.info,  Node: File permissions,  Next: Directory listing,  Prev: Common options,  Up: Top
  123. File permissions
  124. ****************
  125.    Each file has a set of "permissions" that control the kinds of
  126. access that users have to that file.  The permissions for a file are
  127. also called its "access mode".  They can be represented either in
  128. symbolic form or as an octal number.
  129. * Menu:
  130. * Mode Structure::              Structure of file permissions.
  131. * Symbolic Modes::              Mnemonic permissions representation.
  132. * Numeric Modes::               Permissions as octal numbers.
  133. File: fileutils.info,  Node: Mode Structure,  Next: Symbolic Modes,  Up: File permissions
  134. Structure of File Permissions
  135. =============================
  136.    There are three kinds of permissions that a user can have for a file:
  137.   1. permission to read the file.  For directories, this means
  138.      permission to list the contents of the directory.
  139.   2. permission to write to (change) the file.  For directories, this
  140.      means permission to create and remove files in the directory.
  141.   3. permission to execute the file (run it as a program).  For
  142.      directories, this means permission to access files in the
  143.      directory.
  144.    There are three categories of users who may have different
  145. permissions to perform any of the above operations on a file:
  146.   1. the file's owner;
  147.   2. other users who are in the file's group;
  148.   3. everyone else.
  149.    Files are given an owner and group when they are created.  Usually
  150. the owner is the current user and the group is the group of the
  151. directory the file is in, but this varies with the operating system, the
  152. filesystem the file is created on, and the way the file is created.  You
  153. can change the owner and group of a file by using the `chown' and
  154. `chgrp' commands.
  155.    In addition to the three sets of three permissions listed above, a
  156. file's permissions have three special components, which affect only
  157. executable files (programs) and, on some systems, directories:
  158.   1. set the process's effective user ID to that of the file upon
  159.      execution (called the "setuid bit").  No effect on directories.
  160.   2. set the process's effective group ID to that of the file upon
  161.      execution (called the "setgid bit").  For directories on some
  162.      systems, put files created in the directory into the same group as
  163.      the directory, no matter what group the user who creates them is
  164.      in.
  165.   3. save the program's text image on the swap device so it will load
  166.      more quickly when run (called the "sticky bit").  For directories
  167.      on some systems, prevent users from removing files that they do
  168.      not own in the directory; this is called making the directory
  169.      "append-only".
  170. File: fileutils.info,  Node: Symbolic Modes,  Next: Numeric Modes,  Prev: Mode Structure,  Up: File permissions
  171. Symbolic Modes
  172. ==============
  173.    "Symbolic modes" represent changes to files' permissions as
  174. operations on single-character symbols.  They allow you to modify either
  175. all or selected parts of files' permissions, optionally based on their
  176. previous values, and perhaps on the current `umask' as well (*note
  177. Umask and Protection::.).
  178.    The format of symbolic modes is:
  179.      [ugoa...][[+-=][rwxXstugo...]...][,...]
  180.    The following sections describe the operators and other details of
  181. symbolic modes.
  182. * Menu:
  183. * Setting Permissions::          Basic operations on permissions.
  184. * Copying Permissions::          Copying existing permissions.
  185. * Changing Special Permissions:: Special permissions.
  186. * Conditional Executability::    Conditionally affecting executability.
  187. * Multiple Changes::             Making multiple changes.
  188. * Umask and Protection::              The effect of the umask.
  189. File: fileutils.info,  Node: Setting Permissions,  Next: Copying Permissions,  Up: Symbolic Modes
  190. Setting Permissions
  191. -------------------
  192.    The basic symbolic operations on a file's permissions are adding,
  193. removing, and setting the permission that certain users have to read,
  194. write, and execute the file.  These operations have the following
  195. format:
  196.      USERS OPERATION PERMISSIONS
  197. The spaces between the three parts above are shown for readability only;
  198. symbolic modes can not contain spaces.
  199.    The USERS part tells which users' access to the file is changed.  It
  200. consists of one or more of the following letters (or it can be empty;
  201. *note Umask and Protection::., for a description of what happens then).
  202. When more than one of these letters is given, the order that they are
  203. in does not matter.
  204.      the user who owns the file;
  205.      other users who are in the file's group;
  206.      all other users;
  207.      all users; the same as `ugo'.
  208.    The OPERATION part tells how to change the affected users' access to
  209. the file, and is one of the following symbols:
  210.      to add the PERMISSIONS to whatever permissions the USERS already
  211.      have for the file;
  212.      to remove the PERMISSIONS from whatever permissions the USERS
  213.      already have for the file;
  214.      to make the PERMISSIONS the only permissions that the USERS have
  215.      for the file.
  216.    The PERMISSIONS part tells what kind of access to the file should be
  217. changed; it is zero or more of the following letters.  As with the
  218. USERS part, the order does not matter when more than one letter is
  219. given.  Omitting the PERMISSIONS part is useful only with the `='
  220. operation, where it gives the specified USERS no access at all to the
  221. file.
  222.      the permission the USERS have to read the file;
  223.      the permission the USERS have to write to the file;
  224.      the permission the USERS have to execute the file.
  225.    For example, to give everyone permission to read and write a file,
  226. but not to execute it, use:
  227.      a=rw
  228.    To remove write permission for from all users other than the file's
  229. owner, use:
  230.      go-w
  231. The above command does not affect the access that the owner of the file
  232. has to it, nor does it affect whether other users can read or execute
  233. the file.
  234.    To give everyone except a file's owner no permission to do anything
  235. with that file, use the mode below.  Other users could still remove the
  236. file, if they have write permission on the directory it is in.
  237.      go=
  238. Another way to specify the same thing is:
  239.      og-rxw
  240. File: fileutils.info,  Node: Copying Permissions,  Next: Changing Special Permissions,  Prev: Setting Permissions,  Up: Symbolic Modes
  241. Copying Existing Permissions
  242. ----------------------------
  243.    You can base part of a file's permissions on part of its existing
  244. permissions.  To do this, instead of using `r', `w', or `x' after the
  245. operator, you use the letter `u', `g', or `o'.  For example, the mode
  246.      o+g
  247. adds the permissions for users who are in a file's group to the
  248. permissions that other users have for the file.  Thus, if the file
  249. started out as mode 664 (`rw-rw-r--'), the above mode would change it
  250. to mode 666 (`rw-rw-rw-').  If the file had started out as mode 741
  251. (`rwxr----x'), the above mode would change it to mode 745
  252. (`rwxr--r-x').  The `-' and `=' operations work analogously.
  253. File: fileutils.info,  Node: Changing Special Permissions,  Next: Conditional Executability,  Prev: Copying Permissions,  Up: Symbolic Modes
  254. Changing Special Permissions
  255. ----------------------------
  256.    In addition to changing a file's read, write, and execute
  257. permissions, you can change its special permissions.  *Note Mode
  258. Structure::, for a summary of these permissions.
  259.    To change a file's permission to set the user ID on execution, use
  260. `u' in the USERS part of the symbolic mode and `s' in the PERMISSIONS
  261. part.
  262.    To change a file's permission to set the group ID on execution, use
  263. `g' in the USERS part of the symbolic mode and `s' in the PERMISSIONS
  264. part.
  265.    To change a file's permission to stay permanently on the swap device,
  266. use `o' in the USERS part of the symbolic mode and `t' in the
  267. PERMISSIONS part.
  268.    For example, to add set user ID permission to a program, you can use
  269. the mode:
  270.      u+s
  271.    To remove both set user ID and set group ID permission from it, you
  272. can use the mode:
  273.      ug-s
  274.    To cause a program to be saved on the swap device, you can use the
  275. mode:
  276.      o+t
  277.    Remember that the special permissions only affect files that are
  278. executable, plus, on some systems, directories (on which they have
  279. different meanings; *note Mode Structure::.).  Using `a' in the USERS
  280. part of a symbolic mode does not cause the special permissions to be
  281. affected; thus,
  282.      a+s
  283. has *no effect*.  You must use `u', `g', and `o' explicitly to affect
  284. the special permissions.  Also, the combinations `u+t', `g+t', and
  285. `o+s' have no effect.
  286.    The `=' operator is not very useful with special permissions; for
  287. example, the mode:
  288.      o=t
  289. does cause the file to be saved on the swap device, but it also removes
  290. all read, write, and execute permissions that users not in the file's
  291. group might have had for it.
  292. File: fileutils.info,  Node: Conditional Executability,  Next: Multiple Changes,  Prev: Changing Special Permissions,  Up: Symbolic Modes
  293. Conditional Executability
  294. -------------------------
  295.    There is one more special type of symbolic permission: if you use
  296. `X' instead of `x', execute permission is affected only if the file
  297. already had execute permission or is a directory.  It affects
  298. directories' execute permission even if they did not initially have any
  299. execute permissions set.
  300.    For example, this mode:
  301.      a+X
  302. gives all users permission to execute files (or search directories) if
  303. anyone could before.
  304. File: fileutils.info,  Node: Multiple Changes,  Next: Umask and Protection,  Prev: Conditional Executability,  Up: Symbolic Modes
  305. Making Multiple Changes
  306. -----------------------
  307.    The format of symbolic modes is actually more complex than described
  308. above (*note Setting Permissions::.).  It provides two ways to make
  309. multiple changes to files' permissions.
  310.    The first way is to specify multiple OPERATION and PERMISSIONS parts
  311. after a USERS part in the symbolic mode.
  312.    For example, the mode:
  313.      og+rX-w
  314. gives users other than the owner of the file read permission and, if it
  315. is a directory or if someone already had execute permission to it,
  316. gives them execute permission; and it also denies them write permission
  317. to it file.  It does not affect the permission that the owner of the
  318. file has for it.  The above mode is equivalent to the two modes:
  319.      og+rX
  320.      og-w
  321.    The second way to make multiple changes is to specify more than one
  322. simple symbolic mode, separated by commas.  For example, the mode:
  323.      a+r,go-w
  324. gives everyone permission to read the file and removes write permission
  325. on it for all users except its owner.  Another example:
  326.      u=rwx,g=rx,o=
  327. sets all of the non-special permissions for the file explicitly.  (It
  328. gives users who are not in the file's group no permission at all for
  329.    The two methods can be combined.  The mode:
  330.      a+r,g+x-w
  331. gives all users permission to read the file, and gives users who are in
  332. the file's group permission to execute it, as well, but not permission
  333. to write to it.  The above mode could be written in several different
  334. ways; another is:
  335.      u+r,g+rx,o+r,g-w
  336. File: fileutils.info,  Node: Umask and Protection,  Prev: Multiple Changes,  Up: Symbolic Modes
  337. The Umask and Protection
  338. ------------------------
  339.    If the USERS part of a symbolic mode is omitted, it defaults to `a'
  340. (affect all users), except that any permissions that are *set* in the
  341. system variable `umask' are *not affected*.  The value of `umask' can
  342. be set using the `umask' command.  Its default value varies from system
  343. to system.
  344.    Omitting the USERS part of a symbolic mode is generally not useful
  345. with operations other than `+'.  It is useful with `+' because it
  346. allows you to use `umask' as an easily customizable protection against
  347. giving away more permission to files than you intended to.
  348.    As an example, if `umask' has the value 2, which removes write
  349. permission for users who are not in the file's group, then the mode:
  350.      +w
  351. adds permission to write to the file to its owner and to other users who
  352. are in the file's group, but *not* to other users.  In contrast, the
  353. mode:
  354.      a+w
  355. ignores `umask', and *does* give write permission for the file to all
  356. users.
  357. File: fileutils.info,  Node: Numeric Modes,  Prev: Symbolic Modes,  Up: File permissions
  358. Numeric Modes
  359. =============
  360.    File permissions are stored internally as 16 bit integers.  As an
  361. alternative to giving a symbolic mode, you can give an octal (base 8)
  362. number that corresponds to the internal representation of the new mode.
  363. This number is always interpreted in octal; you do not have to add a
  364. leading 0, as you do in C.  Mode 0055 is the same as mode 55.
  365.    A numeric mode is usually shorter than the corresponding symbolic
  366. mode, but it is limited in that it can not take into account a file's
  367. previous permissions; it can only set them absolutely.
  368.    The permissions granted to the user, to other users in the file's
  369. group, and to other users not in the file's group are each stored as
  370. three bits, which are represented as one octal digit.  The three special
  371. permissions are also each stored as one bit, and they are as a group
  372. represented as another octal digit.  Here is how the bits are arranged
  373. in the 16 bit integer, starting with the lowest valued bit:
  374.      Value in  Corresponding
  375.      Mode      Permission
  376.      
  377.                Other users not in the file's group:
  378.         1      Execute
  379.         2      Write
  380.         4      Read
  381.      
  382.                Other users in the file's group:
  383.        10      Execute
  384.        20      Write
  385.        40      Read
  386.      
  387.                The file's owner:
  388.       100      Execute
  389.       200      Write
  390.       400      Read
  391.      
  392.                Special permissions:
  393.      1000      Save text image on swap device
  394.      2000      Set group ID on execution
  395.      4000      Set user ID on execution
  396.    For example, numeric mode 4755 corresponds to symbolic mode
  397. `u=rwxs,go=rx', and numeric mode 664 corresponds to symbolic mode
  398. `ug=rw,o=r'.  Numeric mode 0 corresponds to symbolic mode `ugo='.
  399. File: fileutils.info,  Node: Directory listing,  Next: Basic operations,  Prev: File permissions,  Up: Top
  400. Directory listing
  401. *****************
  402.    This chapter describes the `ls' command and its variants `dir' and
  403. `vdir', which list information about files.
  404. * Menu:
  405. * ls invocation::               List directory contents.
  406. * dir invocation::              Briefly ls.
  407. * vdir invocation::             Verbosely ls.
  408. File: fileutils.info,  Node: ls invocation,  Next: dir invocation,  Up: Directory listing
  409. `ls': List directory contents
  410. =============================
  411.    The `ls' program lists information about files (of any type,
  412. including directories).  Options and file arguments can be intermixed
  413. arbitrarily, as usual.
  414.    For non-option command-line arguments that are directories, by
  415. default `ls' lists the contents of directories, not recursively, and
  416. omitting files with names beginning with `.'.  For other non-option
  417. arguments, by default `ls' lists just the filename.  If no non-option
  418. arguments are specified, `ls' lists the contents of the current
  419. directory.
  420.    By default, the output is sorted alphabetically.  If standard output
  421. is a terminal, the output is in columns (sorted vertically); otherwise,
  422. they are listed one per line.
  423.    Because `ls' is such a fundamental program, it has accumulated many
  424. options over the years.  They are described in the subsections below;
  425. within each section, options are listed alphabetically (ignoring case).
  426. The division of options into the subsections is not absolute, since some
  427. options affect more than one aspect of `ls''s operation.
  428.    Also, the `-g' option is accepted but ignored, for compatibility
  429. with Unix.  Also see *Note Common options::.
  430. * Menu:
  431. * Which files are listed::
  432. * What information is listed::
  433. * Sorting the output::
  434. * General output formatting::
  435. * Formatting the filenames::
  436. File: fileutils.info,  Node: Which files are listed,  Next: What information is listed,  Up: ls invocation
  437. Which files are listed
  438. ----------------------
  439.    These options determine which files `ls' lists information for.  By
  440. default, any files and the contents of any directories on the command
  441. line are shown.
  442. `--all'
  443.      List all files in directories, including files that start with `.'.
  444. `--almost-all'
  445.      List all files in directories except for `.' and `..'.
  446. `--ignore-backups'
  447.      Do not list files that end with `~', unless they are given on the
  448.      command line.
  449. `--directory'
  450.      List just the names of directories, as with other types of files,
  451.      rather than listing their contents.
  452. `--ignore'
  453.      Do not list files whose names match the shell pattern (not regular
  454.      expression) PATTERN unless they are given on the command line.  As
  455.      in the shell, an initial `.' in a filename does not match a
  456.      wildcard at the start of PATTERN.
  457. `--dereference'
  458.      List the files linked to by symbolic links instead of listing the
  459.      contents of the links.
  460. `--recursive'
  461.      List the contents of all directories recursively.
  462. File: fileutils.info,  Node: What information is listed,  Next: Sorting the output,  Prev: Which files are listed,  Up: ls invocation
  463. What information is listed
  464. --------------------------
  465.    These options affect the information that `ls' displays.  By
  466. default, only filenames are shown.
  467. `--dired'
  468.      With the long listing (`-l') format, print an additional line after
  469.      the main output:
  470.           //DIRED// BEG1 END1 BEG2 END2 ...
  471.      The BEGN and ENDN are unsigned integers which record the byte
  472.      position of the beginning and end of each filename in the output.
  473.      This makes it easy for Emacs to find the names, even when they
  474.      contain unusual characters such as space or newline, without fancy
  475.      searching.
  476.      If directories are being listed recursively (`-R'), output a
  477.      similar line after each subdirectory:
  478.           //SUBDIRED// BEG1 END1 ...
  479. `--no-group'
  480.      Inhibit display of group information in a long format directory
  481.      listing.  (This is the default in some non-GNU versions of `ls',
  482.      so we provide this option for compatibility.)
  483. `--inode'
  484.      Print the inode number (also called the file serial number and
  485.      index number) of each file to the left of the filename.  (This
  486.      number uniquely identifies each file within a particular
  487.      filesystem.)
  488. `--format=long'
  489. `--format=verbose'
  490.      In addition to the name of each file, print the file type,
  491.      permissions, number of hard links, owner name, group name, size in
  492.      bytes, and timestamp (by default, the modification time).  For
  493.      files with a time more than 6 months old or more than 1 hour into
  494.      the future, the timestamp contains the year instead of the time of
  495.      day.
  496.      For each directory that is listed, preface the files with a line
  497.      `total BLOCKS', where BLOCKS is the total disk space used by all
  498.      files in that directory.  By default, 1024-byte blocks are used;
  499.      if the environment variable `POSIXLY_CORRECT' is set, 512-byte
  500.      blocks are used (unless the `-k' option is given).  The BLOCKS
  501.      computed counts each hard link separately; this is arguably a bug.
  502.      This output format is the default for the GNU `v' and `vdir'
  503.      programs.
  504. `--size'
  505.      Print the size of each file in 1024-byte blocks to the left of the
  506.      filename.  If the environment variable `POSIXLY_CORRECT' is set,
  507.      512-byte blocks are used instead, unless the `-k' option is given
  508.      (*note General output formatting::.).
  509.      For files that are NFS-mounted from an HP-UX system to a BSD
  510.      system, this option reports sizes that are half the correct
  511.      values.  On HP-UX systems, it reports sizes that are twice the
  512.      correct values for files that are NFS-mounted from BSD systems.
  513.      This is due to a flaw in HP-UX; it also affects the HP-UX `ls'
  514.      program.
  515. File: fileutils.info,  Node: Sorting the output,  Next: General output formatting,  Prev: What information is listed,  Up: ls invocation
  516. Sorting the output
  517. ------------------
  518.    These options change the order in which `ls' sorts the information
  519. it outputs.  By default, sorting is done by character code (e.g., ASCII
  520. order).
  521. `--time=ctime'
  522. `--time=status'
  523.      Sort according to the status change time (the `ctime' in the
  524.      inode).  If the long listing format (`-l') is being used, print the
  525.      status change time instead of the modification time.
  526.      Primarily, like `-U'--do not sort; list the files in whatever
  527.      order they are stored in the directory.  But also enable `-a' (list
  528.      all files) and disable `-l' and `-s' (if they were specified
  529.      before the `-f').
  530. `--reverse'
  531.      Reverse whatever the sorting method is--e.g., list files in reverse
  532.      alphabetical order, youngest first, smallest first, or whatever.
  533. `--sort=size'
  534.      Sort by file size, largest first.
  535. `--sort=time'
  536.      Sort by modification time (the `mtime' in the inode), newest first.
  537. `--time=atime'
  538. `--time=access'
  539. `--time=use'
  540.      Sort by access time (the `atime' in the inode).  If the long
  541.      listing format is being used, print the last access time.
  542. `--sort=none'
  543.      Do not sort; list the files in whatever order they are stored in
  544.      the directory.  (Do not do any of the other unrelated things that
  545.      `-f' does.)  This is especially useful when listing very large
  546.      directories, since not doing any sorting can be noticeably faster.
  547. `--sort=extension'
  548.      Sort directory contents alphabetically by file extension
  549.      (characters after the last `.'); files with no extension are
  550.      sorted first.
  551. File: fileutils.info,  Node: General output formatting,  Next: Formatting the filenames,  Prev: Sorting the output,  Up: ls invocation
  552. General output formatting
  553. -------------------------
  554.    These options affect the appearance of the overall output.
  555. `--format=single-column'
  556.      List one file per line.  This is the default for `ls' when standard
  557.      output is not a terminal.
  558. `--format=vertical'
  559.      List files in columns, sorted vertically.  This is the default for
  560.      `ls' if standard output is a terminal.  It is always the default
  561.      for the `dir' and `d' programs.
  562. `--classify'
  563.      Append a character to each filename indicating the file type.
  564.      Also, for regular files that are executable, append `*'.  The file
  565.      type indicators are `/' for directories, `@' for symbolic links,
  566.      `|' for FIFOs, `=' for sockets, and nothing for regular files.
  567. `--full-time'
  568.      List times in full, rather than using the standard abbreviation
  569.      heuristics.  The format is the same as `date''s default; it's not
  570.      possible to change this, but you can extract out the date string
  571.      with `cut' and then pass the result to `date -d'.  *Note `date'
  572.      invocation: (sh-utils)date invocation.
  573.      This is most useful because the time output includes the seconds.
  574.      (Unix filesystems store file timestamps only to the nearest
  575.      second, so this option shows all the information there is.)  For
  576.      example, this can help when you have a Makefile that is not
  577.      regenerating files properly.
  578. `--kilobytes'
  579.      If file sizes are being listed, print them in kilobytes.  This
  580.      overrides the environment variable `POSIXLY_CORRECT'.
  581. `--format=commas'
  582.      List files horizontally, with as many as will fit on each line,
  583.      separated by `, ' (a comma and a space).
  584. `--numeric-uid-gid'
  585.      List the numeric UID and GID instead of the names.
  586.      Append a character to each filename indicating the file type. This
  587.      is like `-F', except that executables are not marked.
  588. `--format=across'
  589. `--format=horizontal'
  590.      List the files in columns, sorted horizontally.
  591. `--tabsize=COLS'
  592.      Assume that each tabstop is COLS columns wide.  The default is 8.
  593.      `ls' uses tabs where possible in the output, for efficiency.
  594. `--width=COLS'
  595.      Assume the screen is COLS columns wide.  The default is taken from
  596.      the terminal settings if possible; otherwise the environment
  597.      variable `COLUMNS' is used if it is set; otherwise the default is
  598.      80.
  599. File: fileutils.info,  Node: Formatting the filenames,  Prev: General output formatting,  Up: ls invocation
  600. Formatting the filenames
  601. ------------------------
  602.    These options change how filenames themselves are printed.
  603. `--escape'
  604.      Quote nongraphic characters in filenames using alphabetic and octal
  605.      backslash sequences like those used in C.
  606. `--literal'
  607.      Do not quote filenames.
  608. `--hide-control-chars'
  609.      Print question marks instead of nongraphic characters in filenames.
  610.      This is the default.
  611. `--quote-name'
  612.      Enclose filenames in double quotes and quote nongraphic characters
  613.      as in C.
  614. File: fileutils.info,  Node: dir invocation,  Next: vdir invocation,  Prev: ls invocation,  Up: Directory listing
  615. `dir': Briefly list directory contents
  616. ======================================
  617.    The `dir' program (also installed as `d') is equivalent to `ls -C';
  618. that is, files are by default always listed in columns, sorted
  619. vertically.
  620.    *Note `ls': ls invocation.
  621. File: fileutils.info,  Node: vdir invocation,  Prev: dir invocation,  Up: Directory listing
  622. `vdir': Verbosely list directory contents
  623. =========================================
  624.    The `vdir' program (also installed `v')is equivalent to `ls -l';
  625. that is, files are by default listed in long format.
  626. File: fileutils.info,  Node: Basic operations,  Next: Special file types,  Prev: Directory listing,  Up: Top
  627. Basic operations
  628. ****************
  629.    This chapter describes the commands for basic file manipulation:
  630. copying, moving (renaming), and deleting (removing).
  631. * Menu:
  632. * cp invocation::               Copy files.
  633. * dd invocation::               Convert and copy a file.
  634. * install invocation::          Copy files and set attributes.
  635. * mv invocation::               Move (rename) files.
  636. * rm invocation::               Remove files or directories.
  637. File: fileutils.info,  Node: cp invocation,  Next: dd invocation,  Up: Basic operations
  638. `cp': Copy files and directories
  639. ================================
  640.    `cp' copies files (or, optionally, directories).  The copy is
  641. completely independent of the original.  You can either copy one file to
  642. another, or copy arbitrarily many files to a destination directory.
  643. Synopsis:
  644.      cp [OPTION]... SOURCE DEST
  645.      cp [OPTION]... SOURCE... DIRECTORY
  646.    If the last argument names an existing directory, `cp' copies each
  647. SOURCE file into that directory (retaining the same name).  Otherwise,
  648. if only two files are given, it copies the first onto the second.  It
  649. is an error if the last argument is not a directory and more than two
  650. non-option arguments are given.
  651.    If the source file contains holes, `cp' copies them and other blocks
  652. of zero bytes as holes.  Otherwise, files are written just as they are
  653. read.  (A "hole" is a sequence of zero bytes that does not occupy any
  654. physical disk blocks; the `read' system call reads these as zeroes.)
  655.    By default, `cp' does not copy directories.  It also refuses to copy
  656. a file onto itself.
  657.    The program accepts the following options.  Also see *Note Common
  658. options::.
  659. `--archive'
  660.      Preserve as much as possible of the structure and attributes of the
  661.      original files in the copy.  Equivalent to `-dpR'.
  662. `--backup'
  663.      Make backups of files that are about to be overwritten or removed.
  664.      *Note Backup options::.
  665. `--no-dereference'
  666.      Copy symbolic links as symbolic links rather than copying the
  667.      files that they point to, and preserve hard links between source
  668.      files in the copies.
  669. `--force'
  670.      Remove existing destination files.
  671. `--interactive'
  672.      Prompt whether to overwrite existing regular destination files.
  673. `--link'
  674.      Make hard links instead of copies of non-directories.
  675. `--preserve'
  676.      Preserve the original files' owner, group, permissions, and
  677.      timestamps.
  678. `--parents'
  679.      Form the name of each destination file by appending to the target
  680.      directory a slash and the specified name of the source file.  The
  681.      last argument given to `cp' must be the name of an existing
  682.      directory.  For example, the command:
  683.           cp --parents a/b/c existing_dir
  684.      copies the file `a/b/c' to `existing_dir/a/b/c', creating any
  685.      missing intermediate directories.
  686.      Copy directories recursively, copying any non-directories and
  687.      non-symbolic links (that is, FIFOs and special files) as if they
  688.      were regular files.  This means trying to read the data in each
  689.      source file and writing it to the destination.  Thus, with this
  690.      option, `cp' may well hang indefinitely reading a FIFO, unless
  691.      something else happens to be writing it.
  692. `--recursive'
  693.      Copy directories recursively, preserving non-directories (see `-r'
  694.      just above).
  695. `--symbolic-link'
  696.      Make symbolic links instead of copies of non-directories.  All
  697.      source filenames must be absolute (starting with `/') unless the
  698.      destination files are in the current directory.  This option merely
  699.      results in an error message on systems that do not support
  700.      symbolic links.
  701. `-S SUFFIX'
  702. `--suffix=SUFFIX'
  703.      Append SUFFIX to each backup file made with `-b'.  *Note Backup
  704.      options::.
  705. `--update'
  706.      Do not copy a nondirectory that has an existing destination with
  707.      the same or newer modification time.
  708. `--verbose'
  709.      Print the name of each file before copying it.
  710. `-V METHOD'
  711. `--version-control=METHOD'
  712.      Change the type of backups made with `-b'.  The METHOD argument
  713.      can be `numbered' (or `t'), `existing' (or `nil'), or `never' (or
  714.      `simple').  *Note Backup options::.
  715. `--one-file-system'
  716.      Skip subdirectories that are on different filesystems from the one
  717.      that the copy started on.
  718. File: fileutils.info,  Node: dd invocation,  Next: install invocation,  Prev: cp invocation,  Up: Basic operations
  719. `dd': Convert and copy a file
  720. =============================
  721.    `dd' copies a file (from standard input to standard output, by
  722. default) with a changeable I/O blocksize, while optionally performing
  723. conversions on it.  Synopsis:
  724.      dd [OPTION]...
  725.    The program accepts the following options.  Also see *Note Common
  726. options::.
  727.    The numeric-valued options below (BYTES and BLOCKS) can be followed
  728. by a multiplier: `b'=512, `c'=1, `k'=1024, `w'=2, `xM'=M.
  729. `if=FILE'
  730.      Read from FILE instead of standard input.
  731. `of=FILE'
  732.      Write to FILE instead of standard output.  Unless `conv=notrunc'
  733.      is given, `dd' truncates FILE to zero bytes (or the size specified
  734.      with `seek=').
  735. `ibs=BYTES'
  736.      Read BYTES bytes at a time.
  737. `obs=BYTES'
  738.      Write BYTES bytes at a time.
  739. `bs=BYTES'
  740.      Both read and write BYTES bytes at a time.  This overrides `ibs'
  741.      and `obs'.
  742. `cbs=BYTES'
  743.      Convert BYTES bytes at a time.
  744. `skip=BLOCKS'
  745.      Skip BLOCKS `ibs'-byte blocks in the input file before copying.
  746. `seek=BLOCKS'
  747.      Skip BLOCKS `obs'-byte blocks in the output file before copying.
  748. `count=BLOCKS'
  749.      Copy BLOCKS `obs'-byte blocks from the input file, instead of
  750.      everything until the end of the file.
  751. `conv=CONVERSION[,CONVERSION]...'
  752.      Convert the file as specified by the CONVERSION argument(s).  (No
  753.      spaces around any comma(s).)
  754.      Conversions:
  755.     `ascii'
  756.           Convert EBCDIC to ASCII.
  757.     `ebcdic'
  758.           Convert ASCII to EBCDIC.
  759.     `ibm'
  760.           Convert ASCII to alternate EBCDIC.
  761.     `block'
  762.           For each line in the input, output `cbs' bytes, replacing the
  763.           input newline with a space and padding with spaces as
  764.           necessary.
  765.     `unblock'
  766.           Replace trailing spaces in each `cbs'-sized input block with a
  767.           newline.
  768.     `lcase'
  769.           Change uppercase letters to lowercase.
  770.     `ucase'
  771.           Change lowercase letters to uppercase.
  772.     `swab'
  773.           Swap every pair of input bytes.  GNU `dd', unlike others,
  774.           works when an odd number of bytes are read--the last byte is
  775.           simply copied (since there is nothing to swap it with).
  776.     `noerror'
  777.           Continue after read errors.
  778.     `notrunc'
  779.           Do not truncate the output file.
  780.     `sync'
  781.           Pad every input block to size of `ibs' with trailing zero
  782.           bytes.
  783. File: fileutils.info,  Node: install invocation,  Next: mv invocation,  Prev: dd invocation,  Up: Basic operations
  784. `install': Copy files and set attributes
  785. ========================================
  786.    `install' copies files while setting their permission modes and, if
  787. possible, their owner and group.  Synopses:
  788.      install [OPTION]... SOURCE DEST
  789.      install [OPTION]... SOURCE... DIRECTORY
  790.      install -d [OPTION]... DIRECTORY...
  791.    In the first of these, the SOURCE file is copied to the DEST target
  792. file.  In the second, each of the SOURCE files are copied to the
  793. destination DIRECTORY.  In the last, each DIRECTORY (and any missing
  794. parent directories) is created.
  795.    `install' is similar to `cp', but allows you to control the
  796. attributes of destination files.  It is typically used in Makefiles to
  797. copy programs into their destination directories.  It refuses to copy
  798. files onto themselves.
  799.    The program accepts the following options.  Also see *Note Common
  800. options::.
  801.      Ignored; for compatibility with old Unix versions of `install'.
  802. `--directory'
  803.      Create each given directory and any missing parent directories,
  804.      setting the owner, group and mode as given on the command line or
  805.      to the defaults.  It also gives any parent directories it creates
  806.      those attributes.  (This is different from the SunOS 4.x
  807.      `install', which gives directories that it creates the default
  808.      attributes.)
  809. `-g GROUP'
  810. `--group=GROUP'
  811.      Set the group ownership of installed files or directories to
  812.      GROUP. The default is the process's current group.  GROUP may be
  813.      either a group name or a numeric group id.
  814. `-m MODE'
  815. `--mode=MODE'
  816.      Set the permissions for the installed file or directory to MODE,
  817.      which can be either an octal number, or a symbolic mode as in
  818.      `chmod', with 0 as the point of departure (*note File
  819.      permissions::.).  The default mode is 0755--read, write, and
  820.      execute for the owner, and read and execute for group and other.
  821. `-o OWNER'
  822. `--owner=OWNER'
  823.      If `install' has appropriate privileges (is run as root), set the
  824.      ownership of installed files or directories to OWNER. The default
  825.      is `root'.  OWNER may be either a user name or a numeric user ID.
  826. `--strip'
  827.      Strip the symbol tables from installed binary executables.
  828. File: fileutils.info,  Node: mv invocation,  Next: rm invocation,  Prev: install invocation,  Up: Basic operations
  829. `mv': Move (rename) files
  830. =========================
  831.    `mv' moves or renames files (or directories).  Synopsis:
  832.      mv [OPTION]... SOURCE DEST
  833.      mv [OPTION]... SOURCE... DIRECTORY
  834.    If the last argument names an existing directory, `mv' moves each
  835. other given file into a file with the same name in that directory.
  836. Otherwise, if only two files are given, it renames the first as the
  837. second.  It is an error if the last argument is not a directory and
  838. more than two files are given.
  839.    `mv' can move only regular files across filesystems.
  840.    If a destination file exists but is normally unwritable, standard
  841. input is a terminal, and the `-f' or `--force' option is not given,
  842. `mv' prompts the user for whether to replace the file.  (You might own
  843. the file, or have write permission on its directory.)  If the response
  844. does not begin with `y' or `Y', the file is skipped.
  845.    The program accepts the following options.  Also see *Note Common
  846. options::.
  847. `--backup'
  848.      Make backups of files that are about to be overwritten or removed.
  849.      *Note Backup options::.
  850. `--force'
  851.      Remove existing destination files and never prompt the user.
  852. `--interactive'
  853.      Prompt whether to overwrite each existing destination file,
  854.      regardless of its permissions.  If the response does not begin
  855.      with `y' or `Y', the file is skipped.
  856. `--update'
  857.      Do not move a nondirectory that has an existing destination with
  858.      the same or newer modification time.
  859. `--verbose'
  860.      Print the name of each file before moving it.
  861. `-S SUFFIX'
  862. `--suffix=SUFFIX'
  863.      Append SUFFIX to each backup file made with `-b'.  *Note Backup
  864.      options::.
  865. `-V METHOD'
  866. `--version-control=METHOD'
  867.      Change the type of backups made with `-b'.  The METHOD argument
  868.      can be `numbered' (or `t'), `existing' (or `nil'), or `never' (or
  869.      `simple').  *Note Backup options::.
  870. File: fileutils.info,  Node: rm invocation,  Prev: mv invocation,  Up: Basic operations
  871. `rm': Remove files or directories
  872. =================================
  873.    `rm' removes each given FILE.  By default, it does not remove
  874. directories.  Synopsis:
  875.      rm [OPTION]... [FILE]...
  876.    If a file is unwritable, standard input is a terminal, and the `-f'
  877. or `--force' option is not given, or the `-i' or `--interactive' option
  878. *is* given, `rm' prompts the user for whether to remove the file.  If
  879. the response does not begin with `y' or `Y', the file is skipped.
  880.    The program accepts the following options.  Also see *Note Common
  881. options::.
  882. `--directory'
  883.      Remove directories with `unlink' instead of `rmdir', and don't
  884.      require a directory to be empty before trying to unlink it.  Only
  885.      works if you have appropriate privileges.  Because unlinking a
  886.      directory causes any files in the deleted directory to become
  887.      unreferenced, it is wise to `fsck' the filesystem after doing this.
  888. `--force'
  889.      Ignore nonexistent files and never prompt the user.
  890. `--interactive'
  891.      Prompt whether to remove each file.  If the response does not begin
  892.      with `y' or `Y', the file is skipped.
  893. `--recursive'
  894.      Remove the contents of directories recursively.
  895. `--verbose'
  896.      Print the name of each file before removing it.
  897.    One common question is how to remove files whose names being with a
  898. `-'.  GNU `rm', like every program that uses the `getopt' function to
  899. parse its arguments, lets you use the `--' option to indicate that all
  900. following arguments are non-options.  To remove a file called `-f' in
  901. the current directory, you could type either:
  902.      rm -- -f
  903.      rm ./-f
  904.    The Unix `rm' program's use of a single `-' for this purpose
  905. predates the development of the getopt standard syntax.
  906. File: fileutils.info,  Node: Special file types,  Next: Changing file attributes,  Prev: Basic operations,  Up: Top
  907. Special file types
  908. ******************
  909.    This chapter describes commands which create special types of files
  910. (and `rmdir', which removes directories, one special file type).
  911.    Although Unix-like operating systems have markedly fewer special file
  912. types than others, not *everything* can be treated only as the
  913. undifferentiated byte stream of "normal files".  For example, when a
  914. file is created or removed, the system must record this information,
  915. which it does in a "directory"--a special type of file.  Although you
  916. can read directories as normal files, if you're curious, in order for
  917. the system to do its job it must impose a structure, a certain order,
  918. on the bytes of the file.  Thus it is a "special" type of file.
  919.    Besides directories, other special file types include named pipes
  920. (FIFOs), symbolic links, sockets, and so-called "special files".
  921. * Menu:
  922. * ln invocation::               Make links between files.
  923. * mkdir invocation::            Make directories.
  924. * mkfifo invocation::           Make FIFOs (named pipes).
  925. * mknod invocation::            Make block or character special files.
  926. * rmdir invocation::            Remove empty directories.
  927. File: fileutils.info,  Node: ln invocation,  Next: mkdir invocation,  Up: Special file types
  928. `ln': Make links between files
  929. ==============================
  930.    `ln' makes links between files.  By default, it makes hard links;
  931. with the `-s' option, it makes symbolic (or "soft") links.  Synopses:
  932.      ln [OPTION]... SOURCE [DEST]
  933.      ln [OPTION]... SOURCE... DIRECTORY
  934.    If the last argument names an existing directory, `ln' links each
  935. SOURCE file into a file with the same name in that directory.  (But see
  936. the description of the `--no-dereference' option below.) If only one
  937. file is given, it links that file into the current directory.
  938. Otherwise, if only two files are given, it links the first onto the
  939. second.  It is an error if the last argument is not a directory and more
  940. than two files are given.  By default, it does not remove existing
  941. files.
  942.    A "hard link" is another name for an existing file; the link and the
  943. original are indistinguishable.  (Technically speaking, they share the
  944. same inode, and the inode contains all the information about a
  945. file--indeed, it is not incorrect to say that the inode *is* the file.)
  946. On all existing implementations, you cannot make a hard links to
  947. directories, and hard links cannot cross filesystem boundaries.  (These
  948. restrictions are not mandated by POSIX, however.)
  949.    "Symbolic links" ("symlinks" for short), on the other hand, are a
  950. special file type (which not all kernels support; in particular, system
  951. V release 3 (and older) systems lack symlinks) in which the link file
  952. actually refers to a different file, by name.  When most operations
  953. (opening, reading, writing, and so on) are passed the symbolic link
  954. file, the kernel automatically "dereferences" the link and operates on
  955. the target of the link.  But some operations (e.g., removing) work on
  956. the link file itself, rather than on its target.  *Note Symbolic Links:
  957. (library)Symbolic Links.
  958.    The program accepts the following options.  Also see *Note Common
  959. options::.
  960. `--backup'
  961.      Make backups of files that are about to be overwritten or removed.
  962.      *Note Backup options::.
  963. `--directory'
  964.      Allow the super-user to make hard links to directories.
  965. `--force'
  966.      Remove existing destination files.
  967. `--interactive'
  968.      Prompt whether to remove existing destination files.
  969. `--no-dereference'
  970.      When used with `--force' and an explicit destination that is a
  971.      symlink to a directory, remove (or move it with `--backup') that
  972.      symlink before making any link.
  973.      When the destination is an actual directory (not a symlink to one),
  974.      there is no ambiguity.  The link is created in that directory.
  975.      But when the specified destination is a symlink to a directory,
  976.      there are two ways to treat the user's request.  `ln' can treat
  977.      the destination just as it would a normal directory and create the
  978.      link in it.  On the other hand, the destination can be viewed as a
  979.      non-directory--as the symlink itself.  In that case, `ln' must
  980.      delete or backup that symlink before creating the new link.  The
  981.      default is to treat a destination that is a symlink to a directory
  982.      just like a directory.
  983. `--symbolic'
  984.      Make symbolic links instead of hard links.  This option merely
  985.      produces an error message on systems that do not support symbolic
  986.      links.
  987. `--verbose'
  988.      Print the name of each file before linking it.
  989. `-S SUFFIX'
  990. `--suffix=SUFFIX'
  991.      Append SUFFIX to each backup file made with `-b'.  *Note Backup
  992.      options::.
  993. `-V METHOD'
  994. `--version-control=METHOD'
  995.      Change the type of backups made with `-b'.  The METHOD argument
  996.      can be `numbered' (or `t'), `existing' (or `nil'), or `never' (or
  997.      `simple').  *Note Backup options::.
  998. File: fileutils.info,  Node: mkdir invocation,  Next: mkfifo invocation,  Prev: ln invocation,  Up: Special file types
  999. `mkdir': Make directories
  1000. =========================
  1001.    `mkdir' creates directories with the specified names.  Synopsis:
  1002.      mkdir [OPTION]... NAME...
  1003.    It is not an error if a NAME is already a directory; `mkdir' simply
  1004. proceeds.  But if a NAME is an existing file and is anything but a
  1005. directory, `mkdir' complains.
  1006.    The program accepts the following options.  Also see *Note Common
  1007. options::.
  1008. `-m MODE'
  1009. `--mode=MODE'
  1010.      Set the mode of created directories to MODE, which is symbolic as
  1011.      in `chmod' and uses 0777 (read, write and execute allowed for
  1012.      everyone) minus the bits set in the umask for the point of the
  1013.      departure.  *Note File permissions::.
  1014. `--parents'
  1015.      Make any missing parent directories for each argument.  The mode
  1016.      for parent directories is set to the umask modified by `u+wx'.
  1017.      Ignore arguments corresponding to existing directories.
  1018. File: fileutils.info,  Node: mkfifo invocation,  Next: mknod invocation,  Prev: mkdir invocation,  Up: Special file types
  1019. `mkfifo': Make FIFOs (named pipes)
  1020. ==================================
  1021.    `mkfifo' creates FIFOs (also called "named pipes") with the
  1022. specified names.  Synopsis:
  1023.      mkfifo [OPTION] NAME...
  1024.    A "FIFO" is a special file type that permits independent processes
  1025. to communicate.  One process opens the FIFO file for writing, and
  1026. another for reading, after which data can flow as with the usual
  1027. anonymous pipe in shells or elsewhere.
  1028.    The program accepts the following option.  Also see *Note Common
  1029. options::.
  1030. `-m MODE'
  1031. `--mode=MODE'
  1032.      Set the mode of created FIFOs to MODE, which is symbolic as in
  1033.      `chmod' and uses 0666 (read and write allowed for everyone) minus
  1034.      the bits set in the umask for the point of departure.  *Note File
  1035.      permissions::.
  1036. File: fileutils.info,  Node: mknod invocation,  Next: rmdir invocation,  Prev: mkfifo invocation,  Up: Special file types
  1037. `mknod': Make block or character special files
  1038. ==============================================
  1039.    `mknod' creates a FIFO, character special file, or block special
  1040. file with the specified name.  Synopsis:
  1041.      mknod [OPTION]... NAME TYPE [MAJOR MINOR]
  1042.    Unlike the phrase "special file type" above, the term "special file"
  1043. has a technical meaning on Unix: something that can generate or receive
  1044. data.  Usually this corresponds to a physical piece of hardware, e.g.,
  1045. a printer or a disk.  (These files are typically created at
  1046. system-configuration time.)  The `mknod' command is what creates files
  1047. of this type.  Such devices can be read either a character at a time or
  1048. a "block" (many characters) at a time, hence we say there are "block
  1049. special" files and "character special" files.
  1050.    The arguments after NAME specify the type of file to make:
  1051.      for a FIFO
  1052.      for a block (buffered) special file
  1053.      for a character (buffered) special file
  1054.      for a character (unbuffered) special file
  1055.    When making a block or character special file, the major and minor
  1056. device numbers must be given after the file type.
  1057.    The program accepts the following option.  Also see *Note Common
  1058. options::.
  1059. `-m MODE'
  1060. `--mode=MODE'
  1061.      Set the mode of created files to MODE, which is symbolic as in
  1062.      `chmod' and uses 0666 minus the bits set in the umask as the point
  1063.      of departure.  *Note File permissions::.
  1064. File: fileutils.info,  Node: rmdir invocation,  Prev: mknod invocation,  Up: Special file types
  1065. `rmdir': Remove empty directories
  1066. =================================
  1067.    `rmdir' removes empty directories.  Synopsis:
  1068.      rmdir [OPTION]... DIRECTORY...
  1069.    If any DIRECTORY argument does not refer to an existing empty
  1070. directory, it is an error.
  1071.    The program accepts the following option.  Also see *Note Common
  1072. options::.
  1073. `--parents'
  1074.      Remove any parent directories that become empty after an argument
  1075.      DIRECTORY is removed.
  1076.    *Note rm invocation::, for how to remove non-empty directories
  1077. (recursively).
  1078. File: fileutils.info,  Node: Changing file attributes,  Next: Disk usage,  Prev: Special file types,  Up: Top
  1079. Changing file attributes
  1080. ************************
  1081.    Files are not merely contents, a name, and a file type (*note
  1082. Special file types::.).  They also have an owner (a userid), a group (a
  1083. group id), permissions (what the owner can do with the file, what
  1084. people in the group can do, and what everyone else can do), various
  1085. timestamps, and other information.  Collectively, we call all this a
  1086. file's "attributes".
  1087.    These commands change file attributes.
  1088. * Menu:
  1089. * chown invocation::            Change file owners and groups.
  1090. * chgrp invocation::            Change file groups.
  1091. * chmod invocation::            Change access permissions.
  1092. * touch invocation::            Change file timestamps.
  1093. File: fileutils.info,  Node: chown invocation,  Next: chgrp invocation,  Up: Changing file attributes
  1094. `chown': Change file owner and group
  1095. ====================================
  1096.    `chown' changes the user and/or group ownership of each given file.
  1097. Synopsis:
  1098.      chown [OPTION]... NEW-OWNER FILE...
  1099.    The first non-option argument, NEW-OWNER, specifies the new owner
  1100. and/or group, as follows (with no embedded white space):
  1101.      [OWNER] [ [:.] [GROUP] ]
  1102.    Specifically:
  1103. OWNER
  1104.      If only an OWNER (a user name or numeric user id) is given, that
  1105.      user is made the owner of each given file, and the files' group is
  1106.      not changed.
  1107. OWNER`.'GROUP
  1108. OWNER`:'GROUP
  1109.      If the OWNER is followed by a colon or dot and a GROUP (a group
  1110.      name or numeric group id), with no spaces between them, the group
  1111.      ownership of the files is changed as well (to GROUP).
  1112. OWNER`.'
  1113. OWNER`:'
  1114.      If a colon or dot but no group name follows OWNER, that user is
  1115.      made the owner of the files and the group of the files is changed
  1116.      to OWNER's login group.
  1117. `.'GROUP
  1118. `:'GROUP
  1119.      If the colon or dot and following GROUP are given, but the owner
  1120.      is omitted, only the group of the files is changed; in this case,
  1121.      `chown' performs the same function as `chgrp'.
  1122.    The program accepts the following options.  Also see *Note Common
  1123. options::.
  1124. `--changes'
  1125.      Verbosely describe the action for each FILE whose ownership
  1126.      actually changes.
  1127. `--silent'
  1128. `--quiet'
  1129.      Do not print error messages about files whose ownership cannot be
  1130.      changed.
  1131. `--verbose'
  1132.      Verbosely describe the action (or non-action) taken for every FILE.
  1133. `--recursive'
  1134.      Recursively change ownership of directories and their contents.
  1135. File: fileutils.info,  Node: chgrp invocation,  Next: chmod invocation,  Prev: chown invocation,  Up: Changing file attributes
  1136. `chgrp': Change group ownership
  1137. ===============================
  1138.    `chgrp' changes the group ownership of each given FILE to GROUP,
  1139. which can be either a group name or a numeric group id.  Synopsis:
  1140.      chgrp [OPTION]... GROUP FILE...
  1141.    The program accepts the following options.  Also see *Note Common
  1142. options::.
  1143. `--changes'
  1144.      Verbosely describe the action for each FILE whose group actually
  1145.      changes.
  1146. `--silent'
  1147. `--quiet'
  1148.      Do not print error messages about files whose group cannot be
  1149.      changed.
  1150. `--verbose'
  1151.      Verbosely describe the action or non-action taken for every FILE.
  1152. `--recursive'
  1153.      Recursively change the group ownership of directories and their
  1154.      contents.
  1155. File: fileutils.info,  Node: chmod invocation,  Next: touch invocation,  Prev: chgrp invocation,  Up: Changing file attributes
  1156. `chmod': Change access permissions
  1157. ==================================
  1158.    `chmod' changes the access permissions of the named files.  Synopsis:
  1159.      chmod [OPTION]... MODE FILE...
  1160.    `chmod' never changes the permissions of symbolic links, since the
  1161. `chmod' system call cannot change their permissions.  This is not a
  1162. problem since the permissions of symbolic links are never used.
  1163. However, for each symbolic link listed on the command line, `chmod'
  1164. changes the permissions of the pointed-to file.  In contrast, `chmod'
  1165. ignores symbolic links encountered during recursive directory
  1166. traversals.
  1167.    The first non-option argument, MODE, specifies the new permissions.
  1168. See the section below for details.
  1169.    The program accepts the following options.  Also see *Note Common
  1170. options::.
  1171. `--changes'
  1172.      Verbosely describe the action for each FILE whose permissions
  1173.      actually changes.
  1174. `--silent'
  1175. `--quiet'
  1176.      Do not print error messages about files whose permissions cannot be
  1177.      changed.
  1178. `--verbose'
  1179.      Verbosely describe the action or non-action taken for every FILE.
  1180. `--recursive'
  1181.      Recursively change permissions of directories and their contents.
  1182. File: fileutils.info,  Node: touch invocation,  Prev: chmod invocation,  Up: Changing file attributes
  1183. `touch': Change file timestamps
  1184. ===============================
  1185.    `touch' changes the access and/or modification times of the
  1186. specified files.  Synopsis:
  1187.      touch [OPTION]... FILE...
  1188.    If the first FILE would be a valid argument to the `-t' option and
  1189. no timestamp is given with any of the `-d', `-r', or `-t' options and
  1190. the `--' argument is not given, that argument is interpreted as the
  1191. time for the other files instead of as a filename.
  1192.    Any FILE that does not exist is created empty.
  1193.    If changing both the access and modification times to the current
  1194. time, `touch' can change the timestamps for files that the user running
  1195. it does not own but has write permission for.  Otherwise, the user must
  1196. own the files.
  1197.    The program accepts the following options.  Also see *Note Common
  1198. options::.
  1199. `--time=atime'
  1200. `--time=access'
  1201. `--time=use'
  1202.      Change the access time only.
  1203. `--no-create'
  1204.      Do not create files that do not exist.
  1205. `--date=time'
  1206.      Use TIME instead of the current time.  It can contain month names,
  1207.      timezones, `am' and `pm', etc.  *Note `date' invocation:
  1208.      (sh-utils)date invocation.
  1209.      Ignored; for compatibility with BSD versions of `touch'.
  1210. `--time=mtime'
  1211. `--time=modify'
  1212.      Change the modification time only.
  1213. `-r REFERENCE-FILE'
  1214. `--file=REFERENCE-FILE'
  1215.      Use the times of REFERENCE-FILE instead of the current time.
  1216. `-t MMDDhhmm[[CC]YY][.ss]'
  1217.      Use the argument (months, days, hours, minutes, optional century
  1218.      and years, optional seconds) instead of the current time.
  1219. File: fileutils.info,  Node: Disk usage,  Next: Index,  Prev: Changing file attributes,  Up: Top
  1220. Disk usage
  1221. **********
  1222.    No disk can hold an infinite amount of data.  These commands report
  1223. on how much disk storage is in use or available.  (This has nothing
  1224. much to do with how much *main memory*, i.e., RAM, a program is using
  1225. when it runs; for that, you want `ps' or `pstat' or `swap' or some such
  1226. command.)
  1227. * Menu:
  1228. * df invocation::               Report filesystem disk space usage.
  1229. * du invocation::               Estimate file space usage.
  1230. * sync invocation::        Synchronize memory and disk.
  1231. File: fileutils.info,  Node: df invocation,  Next: du invocation,  Up: Disk usage
  1232. `df': Report filesystem disk space usage
  1233. ========================================
  1234.    `df' reports the amount of disk space used and available on
  1235. filesystems.  Synopsis:
  1236.      df [OPTION]... [FILE]...
  1237.    With no arguments, `df' reports the space used and available on all
  1238. currently mounted filesystems (of all types).  Otherwise, `df' reports
  1239. on the filesystem containing each argument FILE.
  1240.    Disk space is shown in 1024-byte blocks by default, unless the
  1241. environment variable `POSIXLY_CORRECT' is set, in which case 512-byte
  1242. blocks are used (unless the `-k' option is given).
  1243.    If an argument FILE is a disk device file containing a mounted
  1244. filesystem, `df' shows the space available on that filesystem rather
  1245. than on the filesystem containing the device node (i.e., the root
  1246. filesystem).  GNU `df' does not attempt to determine the disk usage on
  1247. unmounted filesystems, because on most kinds of systems doing so
  1248. requires extremely nonportable intimate knowledge of filesystem
  1249. structures.
  1250.    The program accepts the following options.  Also see *Note Common
  1251. options::.
  1252. `--all'
  1253.      Include in the listing filesystems that have 0 blocks, which are
  1254.      omitted by default.  Such filesystems are typically special-purpose
  1255.      pseudo-filesystems, such as automounter entries.  Filesystems of
  1256.      type "ignore" or "auto", supported by some operating systems, are
  1257.      only included in the listing if this option is specified.
  1258. `--inodes'
  1259.      List inode usage information instead of block usage.  An inode
  1260.      (short for index node) is contains information about a file such
  1261.      as its owner, permissions, timestamps, and location on the disk.
  1262. `--kilobytes'
  1263.      Print sizes in 1024-byte blocks.  This overrides the environment
  1264.      variable `POSIXLY_CORRECT'.
  1265. `--no-sync'
  1266.      Do not invoke the `sync' system call before getting any usage data.
  1267.      This may make `df' run significantly faster on systems with many
  1268.      disks, but on some systems the results may be slightly out of date.
  1269. `--portability'
  1270.      Use the POSIX output format.  This is like the default format
  1271.      except that the information about each filesystem is always
  1272.      printed on exactly one line; a mount device is never put on a line
  1273.      by itself.  This means that if the mount device name is more than
  1274.      20 characters long (e.g., for some network mounts), the columns
  1275.      are misaligned.
  1276. `--sync'
  1277.      Invoke the `sync' system call before getting any usage data.  On
  1278.      some systems, doing this yields more up to date results, but in
  1279.      general this option makes `df' much slower, especially when there
  1280.      are many or very busy filesystems.
  1281. `-t FSTYPE'
  1282. `--type=FSTYPE'
  1283.      Limit the listing to filesystems of type FSTYPE.  Multiple
  1284.      filesystem types can be specified by giving multiple `-t' options.
  1285.      By default, nothing is omitted.
  1286. `--print-type'
  1287.      Print each filesystem's type.  The types printed here are the same
  1288.      ones you can include or exclude with `-t' and `-x'.  The particular
  1289.      types printed are whatever is supported by the system.  Here are
  1290.      some of the common names (this list is certainly not exhaustive):
  1291.     `nfs'
  1292.           An NFS filesystem, i.e., one mounted over a network from
  1293.           another machine.  This is the one type name which seems to be
  1294.           used uniformly by all systems.
  1295.     `4.2, ufs, efs...'
  1296.           A filesystem on a locally-mounted hard disk.  (The system
  1297.           might even support more than one type here; Linux does.)
  1298.     `hsfs, cdfs'
  1299.           A filesystem on a CD-ROM drive.  HP-UX uses `cdfs', most other
  1300.           systems use `hsfs' (`hs' for `High Sierra').
  1301.     `pcfs'
  1302.           An MS-DOS filesystem, usually on a diskette.
  1303. `-x FSTYPE'
  1304. `--exclude-type=FSTYPE'
  1305.      Limit the listing to filesystems not of type FSTYPE.  Multiple
  1306.      filesystem types can be eliminated by giving multiple `-x'
  1307.      options.  By default, no filesystem types are omitted.
  1308.      Ignored; for compatibility with System V versions of `df'.
  1309. File: fileutils.info,  Node: du invocation,  Next: sync invocation,  Prev: df invocation,  Up: Disk usage
  1310. `du': Estimate file space usage
  1311. ===============================
  1312.    `du' reports the amount of disk space used by the specified files
  1313. and for each subdirectory (of directory arguments).  Synopsis:
  1314.      du [OPTION]... [FILE]...
  1315.    With no arguments, `du' reports the disk space for the current
  1316. directory.  The output is in 1024-byte units by default, unless the
  1317. environment variable `POSIXLY_CORRECT' is set, in which case 512-byte
  1318. blocks are used (unless `-k' is specified).
  1319.    The program accepts the following options.  Also see *Note Common
  1320. options::.
  1321. `--all'
  1322.      Show counts for all files, not just directories.
  1323. `--bytes'
  1324.      Print sizes in bytes, instead of kilobytes.
  1325. `--total'
  1326.      Print a grand total of all arguments after all arguments have been
  1327.      processed.  This can be used to find out the total disk usage of a
  1328.      given set of files or directories.
  1329. `--dereference-args'
  1330.      Dereference symbolic links that are command line arguments.  Does
  1331.      not affect other symbolic links.  This is helpful for finding out
  1332.      the disk usage of directories, such as `/usr/tmp', which are often
  1333.      symbolic links.
  1334. `--kilobytes'
  1335.      Print sizes in kilobytes.  This overrides the environment variable
  1336.      `POSIXLY_CORRECT'.
  1337. `--count-links'
  1338.      Count the size of all files, even if they have appeared already
  1339.      (as a hard link).
  1340. `--dereference'
  1341.      Dereference symbolic links (show the disk space used by the file
  1342.      or directory that the link points to instead of the space used by
  1343.      the link).
  1344. `--summarize'
  1345.      Display only a total for each argument.
  1346. `--separate-dirs'
  1347.      Report the size of each directory separately, not including the
  1348.      sizes of subdirectories.
  1349. `--one-file-system'
  1350.      Skip directories that are on different filesystems from the one
  1351.      that the argument being processed is on.
  1352.    On BSD systems, `du' reports sizes that are half the correct values
  1353. for files that are NFS-mounted from HP-UX systems.  On HP-UX systems,
  1354. it reports sizes that are twice the correct values for files that are
  1355. NFS-mounted from BSD systems.  This is due to a flaw in HP-UX; it also
  1356. affects the HP-UX `du' program.
  1357. File: fileutils.info,  Node: sync invocation,  Prev: du invocation,  Up: Disk usage
  1358. `sync': Synchronize data on disk with memory
  1359. ============================================
  1360.    `sync' writes any data buffered in memory out to disk.  This can
  1361. include (but is not limited to) modified superblocks, modified inodes,
  1362. and delayed reads and writes.  This must be implemented by the kernel;
  1363. The `sync' program does nothing but exercise the `sync' system call.
  1364.    The kernel keeps data in memory to avoid doing (relatively slow) disk
  1365. reads and writes.  This improves performance, but if the computer
  1366. crashes, data may be lost or the filesystem corrupted as a result.
  1367. `sync' ensures everything in memory is written to disk.
  1368.    Any arguments are ignored, except for a lone `--help' or `--version'
  1369. (*note Common options::.).
  1370. File: fileutils.info,  Node: Index,  Prev: Disk usage,  Up: Top
  1371. Index
  1372. *****
  1373. * Menu:
  1374. * - and Unix rm:                        rm invocation.
  1375. * -all:                                 df invocation.
  1376. * -all:                                 du invocation.
  1377. * -all:                                 Which files are listed.
  1378. * -almost-all:                          Which files are listed.
  1379. * -archive:                             cp invocation.
  1380. * -backup:                              mv invocation.
  1381. * -backup:                              Backup options.
  1382. * -backup:                              cp invocation.
  1383. * -backup:                              ln invocation.
  1384. * -bytes:                               du invocation.
  1385. * -changes:                             chgrp invocation.
  1386. * -changes:                             chown invocation.
  1387. * -changes:                             chmod invocation.
  1388. * -classify:                            General output formatting.
  1389. * -count-links:                         du invocation.
  1390. * -date:                                touch invocation.
  1391. * -dereference:                         du invocation.
  1392. * -dereference:                         Which files are listed.
  1393. * -dereference-args:                    du invocation.
  1394. * -directory:                           ln invocation.
  1395. * -directory:                           install invocation.
  1396. * -directory:                           rm invocation.
  1397. * -directory:                           Which files are listed.
  1398. * -dired:                               What information is listed.
  1399. * -escape:                              Formatting the filenames.
  1400. * -exclude-type:                        df invocation.
  1401. * -file:                                touch invocation.
  1402. * -force:                               rm invocation.
  1403. * -force:                               ln invocation.
  1404. * -force:                               mv invocation.
  1405. * -force:                               cp invocation.
  1406. * -format:                              What information is listed.
  1407. * -format:                              General output formatting.
  1408. * -format:                              General output formatting.
  1409. * -format:                              General output formatting.
  1410. * -format:                              General output formatting.
  1411. * -full-time:                           General output formatting.
  1412. * -group:                               install invocation.
  1413. * -help:                                Common options.
  1414. * -hide-control-chars:                  Formatting the filenames.
  1415. * -ignore-backups:                      Which files are listed.
  1416. * -ignore=PATTERN:                      Which files are listed.
  1417. * -inode:                               What information is listed.
  1418. * -inodes:                              df invocation.
  1419. * -interactive:                         ln invocation.
  1420. * -interactive:                         rm invocation.
  1421. * -interactive:                         mv invocation.
  1422. * -interactive:                         cp invocation.
  1423. * -kilobytes:                           du invocation.
  1424. * -kilobytes:                           General output formatting.
  1425. * -kilobytes:                           df invocation.
  1426. * -link:                                cp invocation.
  1427. * -literal:                             Formatting the filenames.
  1428. * -mode:                                install invocation.
  1429. * -mode:                                mknod invocation.
  1430. * -mode:                                mkfifo invocation.
  1431. * -mode:                                mkdir invocation.
  1432. * -no-create:                           touch invocation.
  1433. * -no-dereference:                      ln invocation.
  1434. * -no-dereference:                      cp invocation.
  1435. * -no-group:                            What information is listed.
  1436. * -no-sync:                             df invocation.
  1437. * -numeric-uid-gid:                     General output formatting.
  1438. * -one-file-system:                     cp invocation.
  1439. * -one-file-system:                     du invocation.
  1440. * -owner:                               install invocation.
  1441. * -parents:                             mkdir invocation.
  1442. * -parents:                             cp invocation.
  1443. * -parents:                             rmdir invocation.
  1444. * -portability:                         df invocation.
  1445. * -preserve:                            cp invocation.
  1446. * -print-type:                          df invocation.
  1447. * -quiet:                               chmod invocation.
  1448. * -quiet:                               chgrp invocation.
  1449. * -quiet:                               chown invocation.
  1450. * -quote-name:                          Formatting the filenames.
  1451. * -recursive:                           Which files are listed.
  1452. * -recursive:                           chmod invocation.
  1453. * -recursive:                           rm invocation.
  1454. * -recursive:                           chown invocation.
  1455. * -recursive:                           cp invocation.
  1456. * -recursive:                           chgrp invocation.
  1457. * -reverse:                             Sorting the output.
  1458. * -separate-dirs:                       du invocation.
  1459. * -silent:                              chgrp invocation.
  1460. * -silent:                              chmod invocation.
  1461. * -silent:                              chown invocation.
  1462. * -size:                                What information is listed.
  1463. * -sort:                                Sorting the output.
  1464. * -sort:                                Sorting the output.
  1465. * -sort:                                Sorting the output.
  1466. * -sort:                                Sorting the output.
  1467. * -strip:                               install invocation.
  1468. * -suffix:                              cp invocation.
  1469. * -suffix:                              ln invocation.
  1470. * -suffix:                              Backup options.
  1471. * -suffix:                              mv invocation.
  1472. * -summarize:                           du invocation.
  1473. * -symbolic:                            ln invocation.
  1474. * -symbolic-link:                       cp invocation.
  1475. * -sync:                                df invocation.
  1476. * -tabsize:                             General output formatting.
  1477. * -time:                                touch invocation.
  1478. * -time:                                Sorting the output.
  1479. * -time:                                Sorting the output.
  1480. * -time:                                touch invocation.
  1481. * -total:                               du invocation.
  1482. * -type:                                df invocation.
  1483. * -update:                              cp invocation.
  1484. * -update:                              mv invocation.
  1485. * -verbose:                             ln invocation.
  1486. * -verbose:                             chmod invocation.
  1487. * -verbose:                             mv invocation.
  1488. * -verbose:                             cp invocation.
  1489. * -verbose:                             rm invocation.
  1490. * -verbose:                             chown invocation.
  1491. * -verbose:                             chgrp invocation.
  1492. * -version:                             Common options.
  1493. * -version-control:                     cp invocation.
  1494. * -version-control:                     ln invocation.
  1495. * -version-control:                     mv invocation.
  1496. * -version-control:                     Backup options.
  1497. * -width:                               General output formatting.
  1498. * -1:                                   General output formatting.
  1499. * -A:                                   Which files are listed.
  1500. * -a:                                   touch invocation.
  1501. * -a:                                   du invocation.
  1502. * -a:                                   Which files are listed.
  1503. * -a:                                   df invocation.
  1504. * -a:                                   cp invocation.
  1505. * -b:                                   cp invocation.
  1506. * -b:                                   Formatting the filenames.
  1507. * -B:                                   Which files are listed.
  1508. * -b:                                   Backup options.
  1509. * -b:                                   mv invocation.
  1510. * -b:                                   ln invocation.
  1511. * -b:                                   du invocation.
  1512. * -c:                                   du invocation.
  1513. * -C:                                   General output formatting.
  1514. * -c:                                   chgrp invocation.
  1515. * -c:                                   Sorting the output.
  1516. * -c:                                   install invocation.
  1517. * -c:                                   touch invocation.
  1518. * -c:                                   chown invocation.
  1519. * -c:                                   chmod invocation.
  1520. * -d:                                   rm invocation.
  1521. * -d:                                   Which files are listed.
  1522. * -d:                                   ln invocation.
  1523. * -d:                                   touch invocation.
  1524. * -D:                                   What information is listed.
  1525. * -d:                                   cp invocation.
  1526. * -d:                                   install invocation.
  1527. * -D:                                   du invocation.
  1528. * -f:                                   Sorting the output.
  1529. * -f:                                   chown invocation.
  1530. * -f:                                   cp invocation.
  1531. * -f:                                   chgrp invocation.
  1532. * -f:                                   mv invocation.
  1533. * -f:                                   rm invocation.
  1534. * -F:                                   General output formatting.
  1535. * -f:                                   chmod invocation.
  1536. * -f:                                   ln invocation.
  1537. * -F:                                   ln invocation.
  1538. * -g:                                   ls invocation.
  1539. * -g:                                   install invocation.
  1540. * -G:                                   What information is listed.
  1541. * -i:                                   What information is listed.
  1542. * -i:                                   ln invocation.
  1543. * -I:                                   Which files are listed.
  1544. * -i:                                   df invocation.
  1545. * -i:                                   cp invocation.
  1546. * -i:                                   rm invocation.
  1547. * -i:                                   mv invocation.
  1548. * -k:                                   df invocation.
  1549. * -k:                                   General output formatting.
  1550. * -k:                                   du invocation.
  1551. * -L:                                   du invocation.
  1552. * -l:                                   du invocation.
  1553. * -l:                                   cp invocation.
  1554. * -l:                                   What information is listed.
  1555. * -L:                                   Which files are listed.
  1556. * -m:                                   mknod invocation.
  1557. * -m:                                   install invocation.
  1558. * -m:                                   General output formatting.
  1559. * -m:                                   mkdir invocation.
  1560. * -m:                                   mkfifo invocation.
  1561. * -m:                                   touch invocation.
  1562. * -n:                                   General output formatting.
  1563. * -n:                                   ln invocation.
  1564. * -N:                                   Formatting the filenames.
  1565. * -o:                                   install invocation.
  1566. * -p:                                   rmdir invocation.
  1567. * -p:                                   mkdir invocation.
  1568. * -P:                                   cp invocation.
  1569. * -P:                                   df invocation.
  1570. * -p:                                   cp invocation.
  1571. * -q:                                   Formatting the filenames.
  1572. * -Q:                                   Formatting the filenames.
  1573. * -R:                                   chown invocation.
  1574. * -R:                                   chgrp invocation.
  1575. * -r:                                   touch invocation.
  1576. * -r:                                   Sorting the output.
  1577. * -r:                                   rm invocation.
  1578. * -R:                                   Which files are listed.
  1579. * -R:                                   rm invocation.
  1580. * -R:                                   chmod invocation.
  1581. * -R:                                   cp invocation.
  1582. * -s:                                   cp invocation.
  1583. * -S:                                   Sorting the output.
  1584. * -S:                                   mv invocation.
  1585. * -S:                                   du invocation.
  1586. * -S:                                   Backup options.
  1587. * -S:                                   ln invocation.
  1588. * -s:                                   What information is listed.
  1589. * -s:                                   ln invocation.
  1590. * -s:                                   install invocation.
  1591. * -S:                                   cp invocation.
  1592. * -s:                                   du invocation.
  1593. * -T:                                   General output formatting.
  1594. * -t:                                   Sorting the output.
  1595. * -t:                                   df invocation.
  1596. * -T:                                   df invocation.
  1597. * -u:                                   cp invocation.
  1598. * -u:                                   mv invocation.
  1599. * -u:                                   Sorting the output.
  1600. * -U:                                   Sorting the output.
  1601. * -v:                                   ln invocation.
  1602. * -v:                                   rm invocation.
  1603. * -v:                                   mv invocation.
  1604. * -v:                                   chmod invocation.
  1605. * -V:                                   cp invocation.
  1606. * -V:                                   ln invocation.
  1607. * -v:                                   cp invocation.
  1608. * -v:                                   chgrp invocation.
  1609. * -V:                                   mv invocation.
  1610. * -V:                                   Backup options.
  1611. * -v:                                   chown invocation.
  1612. * -w:                                   General output formatting.
  1613. * -x:                                   du invocation.
  1614. * -x:                                   cp invocation.
  1615. * -x:                                   General output formatting.
  1616. * -x:                                   df invocation.
  1617. * -X:                                   Sorting the output.
  1618. * 4.2 filesystem type:                  df invocation.
  1619. * -, removing files beginning with:     rm invocation.
  1620. * access time, changing:                touch invocation.
  1621. * access permissions, changing:         chmod invocation.
  1622. * access time, sorting files by:        Sorting the output.
  1623. * across, listing files:                General output formatting.
  1624. * adding permissions:                   Setting Permissions.
  1625. * alternate ebcdic, converting to:      dd invocation.
  1626. * append-only directories:              Mode Structure.
  1627. * appropriate privileges:               install invocation.
  1628. * ascii, converting to:                 dd invocation.
  1629. * atime, changing:                      touch invocation.
  1630. * atime, sorting files by:              Sorting the output.
  1631. * attributes, file:                     Changing file attributes.
  1632. * automounter filesystems:              df invocation.
  1633. * b for block special file:             mknod invocation.
  1634. * backslash sequences for filenames:    Formatting the filenames.
  1635. * backup files, ignoring:               Which files are listed.
  1636. * backup files, type made:              Backup options.
  1637. * backup options:                       Backup options.
  1638. * backup suffix:                        Backup options.
  1639. * backups, making:                      cp invocation.
  1640. * backups, making:                      mv invocation.
  1641. * backups, making:                      Backup options.
  1642. * backups, making:                      ln invocation.
  1643. * block (space-padding):                dd invocation.
  1644. * block size:                           dd invocation.
  1645. * block size of conversion:             dd invocation.
  1646. * block size of input:                  dd invocation.
  1647. * block size of output:                 dd invocation.
  1648. * block special files:                  mknod invocation.
  1649. * block special files, creating:        mknod invocation.
  1650. * bs:                                   dd invocation.
  1651. * buffered character file:              mknod invocation.
  1652. * bugs, reporting:                      Introduction.
  1653. * byte-swapping:                        dd invocation.
  1654. * c for character special file:         mknod invocation.
  1655. * cbs:                                  dd invocation.
  1656. * CD-ROM filesystem type:               df invocation.
  1657. * cdfs filesystem type:                 df invocation.
  1658. * changed files, verbosely describing:  chgrp invocation.
  1659. * changed owners, verbosely describing: chown invocation.
  1660. * changing access permissions:          chmod invocation.
  1661. * changing file attributes:             Changing file attributes.
  1662. * changing file ownership:              chown invocation.
  1663. * changing file timestamps:             touch invocation.
  1664. * changing group ownership:             chown invocation.
  1665. * changing group ownership:             chgrp invocation.
  1666. * changing special permissions:         Changing Special Permissions.
  1667. * character special files:              mknod invocation.
  1668. * character special files, creating:    mknod invocation.
  1669. * chgrp:                                chgrp invocation.
  1670. * chmod:                                chmod invocation.
  1671. * chown:                                chown invocation.
  1672. * COLUMNS:                              General output formatting.
  1673. * commas, outputting between files:     General output formatting.
  1674. * common options:                       Common options.
  1675. * conditional executability:            Conditional Executability.
  1676. * conv:                                 dd invocation.
  1677. * converstion block size:               dd invocation.
  1678. * converting while copying a file:      dd invocation.
  1679. * copying directories recursively:      cp invocation.
  1680. * copying existing permissions:         Copying Permissions.
  1681. * copying files and directories:        cp invocation.
  1682. * copying files and setting attributes: install invocation.
  1683. * count:                                dd invocation.
  1684. * cp:                                   cp invocation.
  1685. * crashes and corruption:               sync invocation.
  1686. * creating directories:                 mkdir invocation.
  1687. * creating FIFOs (named pipes):         mkfifo invocation.
  1688. * creating links (hard or soft):        ln invocation.
  1689. * ctime, sorting by:                    Sorting the output.
  1690. * dd:                                   dd invocation.
  1691. * dereferencing symbolic links:         ln invocation.
  1692. * device file, disk:                    df invocation.
  1693. * df:                                   df invocation.
  1694. * dir:                                  dir invocation.
  1695. * directories, copying:                 cp invocation.
  1696. * directories, copying recursively:     cp invocation.
  1697. * directories, creating:                mkdir invocation.
  1698. * directories, creating with given attributes: install invocation.
  1699. * directories, removing (recursively):  rm invocation.
  1700. * directories, removing empty:          rmdir invocation.
  1701. * directories, removing with unlink:    rm invocation.
  1702. * directory listing:                    ls invocation.
  1703. * directory listing, brief:             dir invocation.
  1704. * directory listing, recursive:         Which files are listed.
  1705. * directory listing, verbose:           vdir invocation.
  1706. * dired Emacs mode support:             What information is listed.
  1707. * disk device file:                     df invocation.
  1708. * disk usage:                           Disk usage.
  1709. * disk usage by filesystem:             df invocation.
  1710. * disk usage for files:                 du invocation.
  1711. * diskette filesystem:                  df invocation.
  1712. * DOS filesystem:                       df invocation.
  1713. * du:                                   du invocation.
  1714. * ebcdic, converting to:                dd invocation.
  1715. * efs filesystem type:                  df invocation.
  1716. * empty files, creating:                touch invocation.
  1717. * error messages, omitting:             chmod invocation.
  1718. * error messages, omitting:             chgrp invocation.
  1719. * error messages, omitting:             chown invocation.
  1720. * executables and file type, marking:   General output formatting.
  1721. * execute permission:                   Mode Structure.
  1722. * execute permission, symbolic:         Setting Permissions.
  1723. * existing backup method:               Backup options.
  1724. * extension, sorting files by:          Sorting the output.
  1725. * FIFOs, creating:                      mkfifo invocation.
  1726. * file attributes, changing:            Changing file attributes.
  1727. * file information, preserving:         cp invocation.
  1728. * file ownership, changing:             chown invocation.
  1729. * file permissions:                     File permissions.
  1730. * file permissions, numeric:            Numeric Modes.
  1731. * file space usage:                     du invocation.
  1732. * file timestamps, changing:            touch invocation.
  1733. * file type and executables, marking:   General output formatting.
  1734. * file type, marking:                   General output formatting.
  1735. * file types:                           Special file types.
  1736. * file types, special:                  Special file types.
  1737. * file utilities:                       Top.
  1738. * files beginning with -, removing:     rm invocation.
  1739. * files, copying:                       cp invocation.
  1740. * filesystem disk usage:                df invocation.
  1741. * filesystem space, retrieving current data more slowly: df invocation.
  1742. * filesystem space, retrieving old data more quickly: df invocation.
  1743. * filesystem types, limiting output to certain: df invocation.
  1744. * filesystem types, printing:           df invocation.
  1745. * filesystems and hard links:           ln invocation.
  1746. * filesystems, omitting copying to different: cp invocation.
  1747. * fsck:                                 rm invocation.
  1748. * giving away permissions:              Umask and Protection.
  1749. * grand total of disk space:            du invocation.
  1750. * group owner, default:                 Mode Structure.
  1751. * group ownership of installed files, setting: install invocation.
  1752. * group ownership, changing:            chgrp invocation.
  1753. * group ownerships, changing:           chown invocation.
  1754. * group, permissions for:               Setting Permissions.
  1755. * hard links to directories:            ln invocation.
  1756. * hard links, creating:                 ln invocation.
  1757. * hard links, preserving:               cp invocation.
  1758. * help, online:                         Common options.
  1759. * High Sierra filesystem:               df invocation.
  1760. * history:                              Introduction.
  1761. * holes, copying:                       cp invocation.
  1762. * horizontal, listing files:            General output formatting.
  1763. * hsfs filesystem type:                 df invocation.
  1764. * ibs:                                  dd invocation.
  1765. * if:                                   dd invocation.
  1766. * ignore filesystems:                   df invocation.
  1767. * inode number, printing:               What information is listed.
  1768. * inode usage:                          df invocation.
  1769. * inodes, written buffered:             sync invocation.
  1770. * input block size:                     dd invocation.
  1771. * install:                              install invocation.
  1772. * introduction:                         Introduction.
  1773. * lcase, converting to:                 dd invocation.
  1774. * leading directories, creating missing: install invocation.
  1775. * links, creating:                      ln invocation.
  1776. * Linux filesystem types:               df invocation.
  1777. * ln:                                   ln invocation.
  1778. * local filesystem types:               df invocation.
  1779. * long ls format:                       What information is listed.
  1780. * ls:                                   ls invocation.
  1781. * Makefiles, installing programs in:    install invocation.
  1782. * manipulating files:                   Basic operations.
  1783. * mkdir:                                mkdir invocation.
  1784. * mkfifo:                               mkfifo invocation.
  1785. * mknod:                                mknod invocation.
  1786. * modes and umask:                      Umask and Protection.
  1787. * modes of created directories, setting: mkdir invocation.
  1788. * modes of created FIFOs, setting:      mkfifo invocation.
  1789. * modification time, sorting files by:  Sorting the output.
  1790. * modify time, changing:                touch invocation.
  1791. * MS-DOS filesystem:                    df invocation.
  1792. * mtime, changing:                      touch invocation.
  1793. * multiple changes to permissions:      Multiple Changes.
  1794. * multipliers after numbers:            dd invocation.
  1795. * mv:                                   mv invocation.
  1796. * named pipes, creating:                mkfifo invocation.
  1797. * newer files, copying only:            cp invocation.
  1798. * newer files, moving only:             mv invocation.
  1799. * NFS filesystem type:                  df invocation.
  1800. * NFS mounts from BSD to HP-UX:         What information is listed.
  1801. * NFS mounts from BSD to HP-UX:         du invocation.
  1802. * noerror:                              dd invocation.
  1803. * non-directories, copying as special files: cp invocation.
  1804. * none, sorting option for ls:          Sorting the output.
  1805. * notrunc:                              dd invocation.
  1806. * numbered backup method:               Backup options.
  1807. * numeric modes:                        Numeric Modes.
  1808. * numeric uid and gid:                  General output formatting.
  1809. * obs:                                  dd invocation.
  1810. * octal numbers for file modes:         Numeric Modes.
  1811. * of:                                   dd invocation.
  1812. * one filesystem, restricting du to:    du invocation.
  1813. * one-line output format:               df invocation.
  1814. * other permissions:                    Setting Permissions.
  1815. * output block size:                    dd invocation.
  1816. * output format, portable:              df invocation.
  1817. * owner of file, permissions for:       Setting Permissions.
  1818. * owner, default:                       Mode Structure.
  1819. * ownership of installed files, setting: install invocation.
  1820. * p for FIFO file:                      mknod invocation.
  1821. * parent directories and cp:            cp invocation.
  1822. * parent directories, creating:         mkdir invocation.
  1823. * parent directories, creating missing: install invocation.
  1824. * parent directories, removing:         rmdir invocation.
  1825. * PC filesystem:                        df invocation.
  1826. * pcfs:                                 df invocation.
  1827. * permissions of files:                 File permissions.
  1828. * permissions of installed files, setting: install invocation.
  1829. * permissions, changing access:         chmod invocation.
  1830. * permissions, copying existing:        Copying Permissions.
  1831. * permissions, for changing file timestamps: touch invocation.
  1832. * portable output format:               df invocation.
  1833. * POSIX output format:                  df invocation.
  1834. * POSIX.2:                              Introduction.
  1835. * POSIXLY_CORRECT:                      df invocation.
  1836. * POSIXLY_CORRECT, overridden by df -k: df invocation.
  1837. * POSIXLY_CORRECT, overridden by du -k: du invocation.
  1838. * POSIXLY_CORRECT, overridden by ls -k: General output formatting.
  1839. * POSIXLY_CORRECT, overrides ls -s:     What information is listed.
  1840. * prompting, and ln:                    ln invocation.
  1841. * prompting, and mv:                    mv invocation.
  1842. * prompting, and rm:                    rm invocation.
  1843. * prompts, forcing:                     mv invocation.
  1844. * prompts, omitting:                    mv invocation.
  1845. * read system call, and holes:          cp invocation.
  1846. * read errors, ignoring:                dd invocation.
  1847. * read permission:                      Mode Structure.
  1848. * read permission, symbolic:            Setting Permissions.
  1849. * recursive directory listing:          Which files are listed.
  1850. * recursively changing access permissions: chmod invocation.
  1851. * recursively changing file ownership:  chown invocation.
  1852. * recursively changing group ownership: chgrp invocation.
  1853. * recursively copying directories:      cp invocation.
  1854. * removing empty directories:           rmdir invocation.
  1855. * removing files or directories:        rm invocation.
  1856. * removing permissions:                 Setting Permissions.
  1857. * reverse sorting:                      Sorting the output.
  1858. * rm:                                   rm invocation.
  1859. * rmdir:                                rmdir invocation.
  1860. * root as default owner:                install invocation.
  1861. * seek:                                 dd invocation.
  1862. * setgid:                               Mode Structure.
  1863. * setting permissions:                  Setting Permissions.
  1864. * setuid:                               Mode Structure.
  1865. * simple backup method:                 Backup options.
  1866. * SIMPLE_BACKUP_SUFFIX:                 Backup options.
  1867. * single-column output of files:        General output formatting.
  1868. * size of files, reporting:             What information is listed.
  1869. * size of files, sorting files by:      Sorting the output.
  1870. * skip:                                 dd invocation.
  1871. * sorting ls output:                    Sorting the output.
  1872. * special file types:                   Special file types.
  1873. * special file types:                   Special file types.
  1874. * special files:                        mknod invocation.
  1875. * status time, sorting by:              Sorting the output.
  1876. * sticky:                               Mode Structure.
  1877. * stripping symbol table information:   install invocation.
  1878. * subtracting permissions:              Setting Permissions.
  1879. * superblock, writing:                  sync invocation.
  1880. * swab (byte-swapping):                 dd invocation.
  1881. * swap space, saving text image in:     Mode Structure.
  1882. * symbol table information, stripping:  install invocation.
  1883. * symbolic (soft) links, creating:      ln invocation.
  1884. * symbolic links, copying:              cp invocation.
  1885. * symbolic links, copying with:         cp invocation.
  1886. * symbolic links, dereferencing:        Which files are listed.
  1887. * symbolic links, permissions of:       chmod invocation.
  1888. * symbolic modes:                       Symbolic Modes.
  1889. * sync:                                 sync invocation.
  1890. * sync (padding with nulls):            dd invocation.
  1891. * synchronize disk and memory:          sync invocation.
  1892. * text image, saving in swap space:     Mode Structure.
  1893. * time:                                 touch invocation.
  1894. * timestamps, changing file:            touch invocation.
  1895. * touch:                                touch invocation.
  1896. * truncating output file, avoiding:     dd invocation.
  1897. * u for unbuffered character special file: mknod invocation.
  1898. * ucase, converting to:                 dd invocation.
  1899. * ufs filesystem type:                  df invocation.
  1900. * umask and modes:                      Umask and Protection.
  1901. * unblock:                              dd invocation.
  1902. * unbuffered character special file:    mknod invocation.
  1903. * unlink:                               rm invocation.
  1904. * use time, changing:                   touch invocation.
  1905. * use time, sorting files by:           Sorting the output.
  1906. * utilities for file handling:          Top.
  1907. * vdir:                                 vdir invocation.
  1908. * verbose ls format:                    What information is listed.
  1909. * version number, finding:              Common options.
  1910. * version-control Emacs variable:       Backup options.
  1911. * VERSION_CONTROL:                      Backup options.
  1912. * vertical sorted files in columns:     General output formatting.
  1913. * write permission:                     Mode Structure.
  1914. * write permission, symbolic:           Setting Permissions.
  1915. Tag Table:
  1916. Node: Top
  1917. Node: Introduction
  1918. Node: Common options
  1919. Node: Backup options
  1920. Node: File permissions
  1921. Node: Mode Structure
  1922. Node: Symbolic Modes
  1923. Node: Setting Permissions
  1924. Node: Copying Permissions
  1925. 12440
  1926. Node: Changing Special Permissions
  1927. 13246
  1928. Node: Conditional Executability
  1929. 15087
  1930. Node: Multiple Changes
  1931. 15709
  1932. Node: Umask and Protection
  1933. 17362
  1934. Node: Numeric Modes
  1935. 18456
  1936. Node: Directory listing
  1937. 20291
  1938. Node: ls invocation
  1939. 20710
  1940. Node: Which files are listed
  1941. 22154
  1942. Node: What information is listed
  1943. 23345
  1944. Node: Sorting the output
  1945. 26198
  1946. Node: General output formatting
  1947. 27962
  1948. Node: Formatting the filenames
  1949. 30499
  1950. Node: dir invocation
  1951. 31143
  1952. Node: vdir invocation
  1953. 31517
  1954. Node: Basic operations
  1955. 31819
  1956. Node: cp invocation
  1957. 32376
  1958. Node: dd invocation
  1959. 36278
  1960. Node: install invocation
  1961. 38760
  1962. Node: mv invocation
  1963. 41092
  1964. Node: rm invocation
  1965. 43105
  1966. Node: Special file types
  1967. 44958
  1968. Node: ln invocation
  1969. 46242
  1970. Node: mkdir invocation
  1971. 50016
  1972. Node: mkfifo invocation
  1973. 51033
  1974. Node: mknod invocation
  1975. 51927
  1976. Node: rmdir invocation
  1977. 53483
  1978. Node: Changing file attributes
  1979. 54109
  1980. Node: chown invocation
  1981. 54918
  1982. Node: chgrp invocation
  1983. 56672
  1984. Node: chmod invocation
  1985. 57525
  1986. Node: touch invocation
  1987. 58842
  1988. Node: Disk usage
  1989. 60508
  1990. Node: df invocation
  1991. 61110
  1992. Node: du invocation
  1993. 65228
  1994. Node: sync invocation
  1995. 67544
  1996. Node: Index
  1997. 68365
  1998. End Tag Table
  1999.