home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / fileutils-3.9-bin.lha / man / cat1 / ls.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  9.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LS(1L)                                                     LS(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        ls, dir, vdir - list contents of directories
  9.  
  10. SSYYNNOOPPSSIISS
  11.        llss  [-abcdfgiklmnpqrstuxABCFGLNQRSUX1] [-w cols] [-T cols]
  12.        [-I pattern] [--all]  [--escape]  [--directory]  [--inode]
  13.        [--kilobytes]  [--numeric-uid-gid]  [--no-group]  [--hide-
  14.        control-chars] [--reverse] [--size] [--width=cols] [--tab-
  15.        size=cols]  [--almost-all] [--ignore-backups] [--classify]
  16.        [--file-type] [--full-time] [--ignore=pattern] [--derefer-
  17.        ence]     [--literal]     [--quote-name]     [--recursive]
  18.        [--sort={none,time,size,extension}]                [--for-
  19.        mat={long,verbose,commas,across,vertical,single-column}]
  20.        [--time={atime,access,use,ctime,status}] [--help]  [--ver-
  21.        sion] [path...]
  22.  
  23. DDEESSCCRRIIPPTTIIOONN
  24.        This manual page documents the GNU version of llss.  ddiirr and
  25.        vvddiirr are versions of llss with different default output for-
  26.        mats.   These  programs  list each given file or directory
  27.        path.  Directory contents are sorted alphabetically.   For
  28.        llss,  files are by default listed in columns, sorted verti-
  29.        cally, if the standard output  is  a  terminal;  otherwise
  30.        they  are  listed  one  per  line.   For ddiirr, files are by
  31.        default listed in columns, sorted vertically.   For  vvddiirr,
  32.        files are by default listed in long format.
  33.  
  34.    OOPPTTIIOONNSS
  35.        _-_a_, _-_-_a_l_l
  36.               List  all files in directories, including all files
  37.               that start with `.'.
  38.  
  39.        _-_b_, _-_-_e_s_c_a_p_e
  40.               Quote nongraphic characters  in  file  names  using
  41.               alphabetic and octal backslash sequences like those
  42.               used in C.
  43.  
  44.        _-_c_, _-_-_t_i_m_e_=_c_t_i_m_e_, _-_-_t_i_m_e_=_s_t_a_t_u_s
  45.               Sort directory contents  according  to  the  files'
  46.               status  change  time  instead  of  the modification
  47.               time.  If the long listing format  is  being  used,
  48.               print the status change time instead of the modifi-
  49.               cation time.
  50.  
  51.        _-_d_, _-_-_d_i_r_e_c_t_o_r_y
  52.               List directories  like  other  files,  rather  than
  53.               listing their contents.
  54.  
  55.        _-_f     Do  not sort directory contents; list them in what-
  56.               ever order they are stored on the disk.   The  same
  57.               as enabling _-_a and _-_U and disabling _-_l_, _-_s_, and _-_t_.
  58.  
  59.        _-_-_f_u_l_l_-_t_i_m_e
  60.               List times in full, rather than using the  standard
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LS(1L)                                                     LS(1L)
  71.  
  72.  
  73.               abbreviation heuristics.
  74.  
  75.        _-_g     Ignored; for Unix compatibility.
  76.  
  77.        _-_i_, _-_-_i_n_o_d_e
  78.               Print  the index number of each file to the left of
  79.               the file name.
  80.  
  81.        _-_k_, _-_-_k_i_l_o_b_y_t_e_s
  82.               If file sizes are being listed, print them in kilo-
  83.               bytes.   This  overrides  the  environment variable
  84.               POSIXLY_CORRECT.
  85.  
  86.        _-_l_, _-_-_f_o_r_m_a_t_=_l_o_n_g_, _-_-_f_o_r_m_a_t_=_v_e_r_b_o_s_e
  87.               In addition to the name of  each  file,  print  the
  88.               file type, permissions, number of hard links, owner
  89.               name, group name, size in bytes, and timestamp (the
  90.               modification time unless other times are selected).
  91.               For files with a time that is more  than  6  months
  92.               old or more than 1 hour into the future, the times-
  93.               tamp contains the year instead of the time of  day.
  94.  
  95.        _-_m_, _-_-_f_o_r_m_a_t_=_c_o_m_m_a_s
  96.               List  files  horizontally, with as many as will fit
  97.               on each line, separated by commas.
  98.  
  99.        _-_n_, _-_-_n_u_m_e_r_i_c_-_u_i_d_-_g_i_d
  100.               List the numeric UID and GID instead of the  names.
  101.  
  102.        _-_p     Append a character to each file name indicating the
  103.               file type.
  104.  
  105.        _-_q_, _-_-_h_i_d_e_-_c_o_n_t_r_o_l_-_c_h_a_r_s
  106.               Print question marks instead of nongraphic  charac-
  107.               ters in file names.
  108.  
  109.        _-_r_, _-_-_r_e_v_e_r_s_e
  110.               Sort directory contents in reverse order.
  111.  
  112.        _-_s_, _-_-_s_i_z_e
  113.               Print  the  size  of  each file in 1K blocks to the
  114.               left of the file name.  If the environment variable
  115.               POSIXLY_CORRECT  is  set,  512-byte blocks are used
  116.               instead.
  117.  
  118.        _-_t_, _-_-_s_o_r_t_=_t_i_m_e
  119.               Sort directory contents  by  timestamp  instead  of
  120.               alphabetically, with the newest files listed first.
  121.  
  122.        _-_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
  123.               Sort directory contents  according  to  the  files'
  124.               last  access time instead of the modification time.
  125.               If the long listing format is being used, print the
  126.               last  access time instead of the modification time.
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LS(1L)                                                     LS(1L)
  137.  
  138.  
  139.        _-_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
  140.               List the files in columns, sorted horizontally.
  141.  
  142.        _-_A_, _-_-_a_l_m_o_s_t_-_a_l_l
  143.               List all files in directories, except for  `.'  and
  144.               `..'.
  145.  
  146.        _-_B_, _-_-_i_g_n_o_r_e_-_b_a_c_k_u_p_s
  147.               Do  not  list  files that end with `~', unless they
  148.               are given on the command line.
  149.  
  150.        _-_C_, _-_-_f_o_r_m_a_t_=_v_e_r_t_i_c_a_l
  151.               List files in columns, sorted vertically.
  152.  
  153.        _-_F_, _-_-_c_l_a_s_s_i_f_y
  154.               Append a character to each file name indicating the
  155.               file  type.  For regular files that are executable,
  156.               append a `*'.  The file type indicators are `/' for
  157.               directories, `@' for symbolic links, `|' for FIFOs,
  158.               `=' for sockets, and nothing for regular files.
  159.  
  160.        _-_G_, _-_-_n_o_-_g_r_o_u_p
  161.               Inhibit display of group information in a long for-
  162.               mat directory listing.
  163.  
  164.        _-_L_, _-_-_d_e_r_e_f_e_r_e_n_c_e
  165.               List  the files linked to by symbolic links instead
  166.               of listing the contents of the links.
  167.  
  168.        _-_N_, _-_-_l_i_t_e_r_a_l
  169.               Do not quote file names.
  170.  
  171.        _-_Q_, _-_-_q_u_o_t_e_-_n_a_m_e
  172.               Enclose file names in double quotes and quote  non-
  173.               graphic characters as in C.
  174.  
  175.        _-_R_, _-_-_r_e_c_u_r_s_i_v_e
  176.               List the contents of all directories recursively.
  177.  
  178.        _-_S_, _-_-_s_o_r_t_=_s_i_z_e
  179.               Sort  directory  contents  by  file size instead of
  180.               alphabetically,  with  the  largest  files   listed
  181.               first.
  182.  
  183.        _-_U_, _-_-_s_o_r_t_=_n_o_n_e
  184.               Do  not sort directory contents; list them in what-
  185.               ever order they  are  stored  on  the  disk.   This
  186.               option  is  not  called  _-_f  because the Unix llss _-_f
  187.               option also enables _-_a and disables _-_l, _-_s, and _-_t.
  188.               It  seems useless and ugly to group those unrelated
  189.               things together in one option.  Since  this  option
  190.               doesn't do that, it has a different name.
  191.  
  192.  
  193.  
  194.  
  195.  
  196. FSF                     GNU File Utilities                      3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LS(1L)                                                     LS(1L)
  203.  
  204.  
  205.        _-_X_, _-_-_s_o_r_t_=_e_x_t_e_n_s_i_o_n
  206.               Sort  directory  contents  alphabetically  by  file
  207.               extension (characters after the  last  `.');  files
  208.               with no extension are sorted first.
  209.  
  210.        _-_1_, _-_-_f_o_r_m_a_t_=_s_i_n_g_l_e_-_c_o_l_u_m_n
  211.               List one file per line.
  212.  
  213.        _-_w_, _-_-_w_i_d_t_h _c_o_l_s
  214.               Assume  the  screen  is  _c_o_l_s  columns  wide.   The
  215.               default is taken from the terminal driver if possi-
  216.               ble;  otherwise the environment variable CCOOLLUUMMNNSS is
  217.               used if it is set; otherwise the default is 80.
  218.  
  219.        _-_T_, _-_-_t_a_b_s_i_z_e _c_o_l_s
  220.               Assume that each tabstop is _c_o_l_s columns wide.  The
  221.               default is 8.
  222.  
  223.        _-_I_, _-_-_i_g_n_o_r_e _p_a_t_t_e_r_n
  224.               Do  not list files whose names match the shell pat-
  225.               tern _p_a_t_t_e_r_n unless they are given on  the  command
  226.               line.   As  in the shell, an initial `.' in a file-
  227.               name does not match a wildcard at the start of _p_a_t_-
  228.               _t_e_r_n_.
  229.  
  230.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  231.               tus.
  232.  
  233.        _-_-_v_e_r_s_i_o_n
  234.               Print version information on  standard  error  then
  235.               exit.
  236.  
  237. BBUUGGSS
  238.        On  BSD systems, the _-_s option reports sizes that are half
  239.        the correct values for files that are NFS-mounted from HP-
  240.        UX  systems.   On HP-UX systems, it reports sizes that are
  241.        twice the correct values for files  that  are  NFS-mounted
  242.        from BSD systems.  This is due to a flaw in HP-UX; it also
  243.        affects the HP-UX llss program.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. FSF                     GNU File Utilities                      4
  263.  
  264.  
  265.