home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / fileutil.lha / fileutils-3.3 / cat / ls.1 < prev    next >
Encoding:
Text File  |  1992-08-28  |  8.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LS(1L)            MISC. REFERENCE MANUAL PAGES             LS(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      ls, dir, vdir - list contents of directories
  10.  
  11. SYNOPSIS
  12.      ls [-abcdgiklmnpqrstuxABCFLNQRSUX1] [-w cols] [-T cols]  [-I
  13.      pattern] [--all] [--escape] [--directory] [--inode] [--kilo-
  14.      bytes]      [--numeric-uid-gid]       [--hide-control-chars]
  15.      [--reverse]    [--size]    [--width=cols]   [--tabsize=cols]
  16.      [--almost-all] [--ignore-backups] [--classify] [--file-type]
  17.      [--ignore=pattern]   [--dereference]  [--literal]  [--quote-
  18.      name]   [--recursive]    [--sort={none,time,size,extension}]
  19.      [--format={long,verbose,commas,across,vertical,single-
  20.      column}] [--time={atime,access,use,ctime,status}] [path...]
  21.  
  22. DESCRIPTION
  23.      This manual page documents the GNU version of ls.   dir  and
  24.      vdir  are  versions of ls with different default output for-
  25.      mats.  These programs list  each  given  file  or  directory
  26.      path.   Directory  contents  are sorted alphabetically.  For
  27.      ls, files are by default listed in  columns,  sorted  verti-
  28.      cally,  if the standard output is a terminal; otherwise they
  29.      are listed one per line.  For  dir,  files  are  by  default
  30.      listed  in  columns, sorted vertically.  For vdir, files are
  31.      by default listed in long format.
  32.  
  33.   OPTIONS
  34.      -_a, --_a_l_l
  35.           List all files in directories, including all files that
  36.           start with `.'.
  37.  
  38.      -_b, --_e_s_c_a_p_e
  39.           Quote nongraphic characters in file names using  alpha-
  40.           betic  and octal backslash sequences like those used in
  41.           C.
  42.  
  43.      -_c, --_t_i_m_e=_c_t_i_m_e, --_t_i_m_e=_s_t_a_t_u_s
  44.           Sort directory contents according to the files'  status
  45.           change  time  instead of the modification time.  If the
  46.           long listing format is being  used,  print  the  status
  47.           change time instead of the modification time.
  48.  
  49.      -_d, --_d_i_r_e_c_t_o_r_y
  50.           List directories like other files, rather than  listing
  51.           their contents.
  52.  
  53.      -_g   Ignored; for Unix compatibility.
  54.  
  55.      -_i, --_i_n_o_d_e
  56.           Print the index number of each file to the left of  the
  57.           file name.
  58.  
  59.      -_k, --_k_i_l_o_b_y_t_e_s
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LS(1L)            MISC. REFERENCE MANUAL PAGES             LS(1L)
  71.  
  72.  
  73.  
  74.           If file sizes are being listed,  print  them  in  kilo-
  75.           bytes.    This   overrides   the  environment  variable
  76.           POSIXLY_CORRECT.
  77.  
  78.      -_l, --_f_o_r_m_a_t=_l_o_n_g, --_f_o_r_m_a_t=_v_e_r_b_o_s_e
  79.           In addition to the name of each file,  print  the  file
  80.           type,  permissions,  number  of hard links, owner name,
  81.           group name, size in bytes, and timestamp (the modifica-
  82.           tion  time unless other times are selected).  For files
  83.           with a time that is more than 6 months old or more than
  84.           1 hour into the future, the timestamp contains the year
  85.           instead of the time of day.
  86.  
  87.      -_m, --_f_o_r_m_a_t=_c_o_m_m_a_s
  88.           List files horizontally, with as many as  will  fit  on
  89.           each line, separated by commas.
  90.  
  91.      -_n, --_n_u_m_e_r_i_c-_u_i_d-_g_i_d
  92.           List the numeric UID and GID instead of the names.
  93.  
  94.      -_p   Append a character to each  file  name  indicating  the
  95.           file type.
  96.  
  97.      -_q, --_h_i_d_e-_c_o_n_t_r_o_l-_c_h_a_r_s
  98.           Print question marks instead of  nongraphic  characters
  99.           in file names.
  100.  
  101.      -_r, --_r_e_v_e_r_s_e
  102.           Sort directory contents in reverse order.
  103.  
  104.      -_s, --_s_i_z_e
  105.           Print the size of each file in 1K blocks to the left of
  106.           the   file   name.    If   the   environment   variable
  107.           POSIXLY_CORRECT  is  set,  512-byte  blocks  are   used
  108.           instead.
  109.  
  110.      -_t, --_s_o_r_t=_t_i_m_e
  111.           Sort directory contents by timestamp instead of  alpha-
  112.           betically, with the newest files listed first.
  113.  
  114.      -_u, --_t_i_m_e=_a_t_i_m_e, --_t_i_m_e=_a_c_c_e_s_s, --_t_i_m_e=_u_s_e
  115.           Sort directory contents according to  the  files'  last
  116.           access  time  instead of the modification time.  If the
  117.           long listing format  is  being  used,  print  the  last
  118.           access time instead of the modification time.
  119.  
  120.      -_x, --_f_o_r_m_a_t=_a_c_r_o_s_s, --_f_o_r_m_a_t=_h_o_r_i_z_o_n_t_a_l
  121.           List the files in columns, sorted horizontally.
  122.  
  123.      -_A, --_a_l_m_o_s_t-_a_l_l
  124.           List all files in directories except for `.' and `..'.
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LS(1L)            MISC. REFERENCE MANUAL PAGES             LS(1L)
  137.  
  138.  
  139.  
  140.      -_B, --_i_g_n_o_r_e-_b_a_c_k_u_p_s
  141.           Do not list files that end with `~',  unless  they  are
  142.           given on the command line.
  143.  
  144.      -_C, --_f_o_r_m_a_t=_v_e_r_t_i_c_a_l
  145.           List files in columns, sorted vertically.
  146.  
  147.      -_F, --_c_l_a_s_s_i_f_y
  148.           Append a character to each  file  name  indicating  the
  149.           file  type.   For  regular  files  that are executable,
  150.           append a `*'.  The file type  indicators  are  `/'  for
  151.           directories, `@' for symbolic links, `|' for FIFOs, `='
  152.           for sockets, and nothing for regular files.
  153.  
  154.      -_L, --_d_e_r_e_f_e_r_e_n_c_e
  155.           List the files linked to by symbolic links  instead  of
  156.           listing the contents of the links.
  157.  
  158.      -_N, --_l_i_t_e_r_a_l
  159.           Do not quote file names.
  160.  
  161.      -_Q, --_q_u_o_t_e-_n_a_m_e
  162.           Enclose file names in  double  quotes  and  quote  non-
  163.           graphic characters as in C.
  164.  
  165.      -_R, --_r_e_c_u_r_s_i_v_e
  166.           List the contents of all directories recursively.
  167.  
  168.      -_S, --_s_o_r_t=_s_i_z_e
  169.           Sort directory contents by file size instead of alapha-
  170.           betically, with the largest files listed first.
  171.  
  172.      -_U, --_s_o_r_t=_n_o_n_e
  173.           Do not sort directory contents; list them  in  whatever
  174.           order  they are stored on the disk.  This option is not
  175.           called -_f because the Unix ls -_f option also enables -_a
  176.           and disables -_l, -_s, and -_t.  It seems useless and ugly
  177.           to group those unrelated things together in one option.
  178.           Since  this  option doesn't do that, it has a different
  179.           name.
  180.  
  181.      -_X, --_s_o_r_t=_e_x_t_e_n_s_i_o_n
  182.           Sort directory contents alphabetically by  file  exten-
  183.           sion  (characters  after  the  last `.'); files with no
  184.           extension are sorted first.
  185.  
  186.      -_1, --_f_o_r_m_a_t=_s_i_n_g_l_e-_c_o_l_u_m_n
  187.           List one file per line.
  188.  
  189.      -_w, --_w_i_d_t_h _c_o_l_s
  190.           Assume the screen is _c_o_l_s columns wide.  The default is
  191.           taken  from  the terminal driver if possible; otherwise
  192.  
  193.  
  194.  
  195. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LS(1L)            MISC. REFERENCE MANUAL PAGES             LS(1L)
  203.  
  204.  
  205.  
  206.           the environment variable COLUMNS is used if it is  set;
  207.           otherwise the default is 80.
  208.  
  209.      -_T, --_t_a_b_s_i_z_e _c_o_l_s
  210.           Assume that each tabstop is  _c_o_l_s  columns  wide.   The
  211.           default is 8.
  212.  
  213.      -_I, --_i_g_n_o_r_e _p_a_t_t_e_r_n
  214.           Do not list files whose names match the  shell  pattern
  215.           _p_a_t_t_e_r_n  unless they are given on the command line.  As
  216.           in the shell, an initial `.' in  a  filename  does  not
  217.           match a wildcard at the start of _p_a_t_t_e_r_n.
  218.  
  219. BUGS
  220.      On BSD systems, the -_s option reports sizes  that  are  half
  221.      the correct values for files that are NFS-mounted from HP-UX
  222.      systems.  On HP-UX systems, it reports sizes that are  twice
  223.      the  correct  values for files that are NFS-mounted from BSD
  224.      systems.  This is due to a flaw in HP-UX;  it  also  affects
  225.      the HP-UX ls program.
  226.  
  227.      The long-named options can be introduced with `+' as well as
  228.      `--',  for compatibility with previous releases.  Eventually
  229.      support for `+' will be removed, because it is  incompatible
  230.      with the POSIX.2 standard.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.1           Last change:                          4
  262.  
  263.  
  264.  
  265.